[Bug]: ContentSwitcher docs do not align with component usage

[adamalston]

Package

@carbon/react

Browser

No response

Package version

1.67.1

React version

No response

Description

size and selectedIndex are not required according to the docs: https://react.carbondesignsystem.com/?path=/docs/components-contentswitcher--overview.

They are also not listed as required in the propTypes:

carbon/packages/react/src/components/ContentSwitcher/ContentSwitcher.tsx

Lines 86 to 126 in 03170a8

	static propTypes = {
	/**
	* Pass in Switch components to be rendered in the ContentSwitcher
	*/
	children: PropTypes.node,
	/**
	* Specify an optional className to be added to the container node
	*/
	className: PropTypes.string,
	/**
	* `true` to use the light variant.
	*/
	light: deprecate(
	PropTypes.bool,
	'The `light` prop for `ContentSwitcher` is no longer needed and has ' +
	'been deprecated. It will be removed in the next major release.'
	),
	/**
	* Specify an `onChange` handler that is called whenever the ContentSwitcher
	* changes which item is selected
	*/
	onChange: PropTypes.func.isRequired,
	/**
	* Specify a selected index for the initially selected content
	*/
	selectedIndex: PropTypes.number,
	/**
	* Choose whether or not to automatically change selection on focus when left/right arrow pressed. Defaults to 'automatic'
	*/
	selectionMode: PropTypes.oneOf(['automatic', 'manual']),
	/**
	* Specify the size of the Content Switcher. Currently supports either `sm`, 'md' (default) or 'lg` as an option.
	*/
	size: PropTypes.oneOf(['sm', 'md', 'lg']),
	};

However, these props are required per the interface for the component:

carbon/packages/react/src/components/ContentSwitcher/ContentSwitcher.tsx

Lines 25 to 65 in 03170a8

	export interface ContentSwitcherProps
	extends Omit<HTMLAttributes<HTMLElement>, 'onChange'> {
	/**
	* Pass in Switch components to be rendered in the ContentSwitcher
	*/
	children?: ReactElement[];
	/**
	* Specify an optional className to be added to the container node
	*/
	className?: string;
	/**
	* `true` to use the light version.
	*
	* @deprecated The `light` prop for `ContentSwitcher` has
	* been deprecated in favor of the new `Layer` component. It will be removed in the next major release.
	*/
	light?: boolean;
	/**
	* Specify an `onChange` handler that is called whenever the ContentSwitcher
	* changes which item is selected
	*/
	onChange: (params: SwitchEventHandlersParams) => void;
	/**
	* Specify a selected index for the initially selected content
	*/
	selectedIndex: number;
	/**
	* Choose whether or not to automatically change selection on focus when left/right arrow pressed. Defaults to 'automatic'
	*/
	selectionMode?: 'automatic' | 'manual';
	/**
	* Specify the size of the Content Switcher. Currently supports either `sm`, 'md' (default) or 'lg` as an option.
	*/
	size: 'sm' | 'md' | 'lg';
	}

Lastly, the prop type for size states:

Specify the size of the Content Switcher. Currently supports either sm, 'md' (default) or 'lg` as an option.

A default option shouldn't be necessary on a required property.

Reproduction/example

https://stackblitz.com/edit/github-eslv6tn5?file=src%2FApp.tsx

Steps to reproduce

See the error in the reproduction.

Suggested Severity

Severity 3 = User can complete task, and/or has a workaround within the user experience of a given component.

Application/PAL

DataPower

Code of Conduct

• I agree to follow this project's Code of Conduct
• I checked the current issues for duplicate problems