@carbon/react 1.110.0 → 1.111.0-rc.0

package/lib/components/TreeView/TreeView.js

@@ -14,10 +14,10 @@ const require_index = require("../FeatureFlags/index.js");
 const require_useControllableState = require("../../internal/useControllableState.js");
 const require_TreeContext = require("./TreeContext.js");
 const require_TreeNode = require("./TreeNode.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -163,15 +163,47 @@ const TreeView = ({ active: prespecifiedActive, children, className, hideLabel =
 	})] });
 };
 TreeView.propTypes = {
+	/**
+	* Mark the active node in the tree, represented by its ID
+	*/
 	active: prop_types.default.oneOfType([prop_types.default.string, prop_types.default.number]),
+	/**
+	* Specify the children of the TreeView
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be applied to the TreeView
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether or not the label should be hidden
+	*/
 	hideLabel: prop_types.default.bool,
+	/**
+	* Provide the label text that will be read by a screen reader
+	*/
 	label: prop_types.default.string.isRequired,
+	/**
+	* **[Experimental]** Specify the selection mode of the tree.
+	* If `multiselect` is `false` then only one node can be selected at a time
+	*/
 	multiselect: prop_types.default.bool,
+	/**
+	* **[Experimental]** Callback function that is called when any node is activated.
+	* *This is only supported with the `enable-treeview-controllable` feature flag!*
+	*/
 	onActivate: prop_types.default.func,
+	/**
+	* Callback function that is called when any node is selected
+	*/
 	onSelect: prop_types.default.func,
+	/**
+	* Array representing all selected node IDs in the tree
+	*/
 	selected: prop_types.default.arrayOf(prop_types.default.oneOfType([prop_types.default.string, prop_types.default.number])),
+	/**
+	* Specify the size of the tree from a list of available sizes.
+	*/
 	size: prop_types.default.oneOf(["xs", "sm"])
 };
 TreeView.TreeNode = require_TreeNode.default;

package/lib/components/UIShell/Content.js

@@ -7,10 +7,10 @@
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 //#region src/components/UIShell/Content.ts
@@ -28,8 +28,17 @@ const Content = ({ className: customClassName, children, tagName = "main", ...re
 	}, children);
 };
 Content.propTypes = {
+	/**
+	* Provide children nodes to be rendered in the content container
+	*/
 	children: prop_types.default.node,
+	/**
+	* Optionally provide a custom class name that is applied to the container
+	*/
 	className: prop_types.default.string,
+	/**
+	* Optionally specify the tag of the content node. Defaults to `main`
+	*/
 	tagName: prop_types.default.string
 };
 //#endregion

package/lib/components/UIShell/Header.js

@@ -7,10 +7,10 @@
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -30,8 +30,17 @@ const Header = ({ className: customClassName, children, ...rest }) => {
 	});
 };
 Header.propTypes = {
+	/**
+	* Optionally provide aria-label
+	*/
 	"aria-label": prop_types.default.string,
+	/**
+	* Optionally provide aria-labelledby
+	*/
 	"aria-labelledby": prop_types.default.string,
+	/**
+	* Optionally provide a custom class name that is applied to the underlying header
+	*/
 	className: prop_types.default.string
 };
 //#endregion

package/lib/components/UIShell/HeaderContainer.js

@@ -36,7 +36,16 @@ function HeaderContainer({ render: Children, isSideNavExpanded = false, ...rest
 	});
 }
 HeaderContainer.propTypes = {
+	/**
+	* Optionally provide a custom class name that is applied to the underlying <header>
+	*/
 	isSideNavExpanded: prop_types.default.bool,
+	/**
+	* A function or a component that is invoked with `isSideNavExpanded` and `onClickSideNavExpand`.
+	* The function or component can then use those properties to within the components it
+	* returns, such as with the HeaderMenuButton and SideNav components. Additional props will also be passed
+	* into this component for convenience.
+	*/
 	render: prop_types.default.elementType.isRequired
 };
 //#endregion

package/lib/components/UIShell/HeaderGlobalAction.js

@@ -9,10 +9,10 @@ const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
 const require_index = require("../Button/index.js");
 const require_AriaPropTypes = require("../../prop-types/AriaPropTypes.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -61,17 +61,45 @@ const HeaderGlobalAction = react.default.forwardRef(({ "aria-label": ariaLabel,
 	});
 });
 HeaderGlobalAction.propTypes = {
+	/**
+	* Required props for the accessibility label of the button
+	*/
 	...require_AriaPropTypes.AriaLabelPropType,
+	/**
+	* Provide a custom icon for this global action
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Optionally provide a custom class name that is applied to the underlying
+	* button
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the action is currently active
+	*/
 	isActive: prop_types.default.bool,
+	/**
+	* Optionally provide an onClick handler that is called when the underlying
+	* button fires it's onclick event
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* Specify the alignment of the tooltip to the icon-only button.
+	* Can be one of: start, center, or end.
+	*/
 	tooltipAlignment: prop_types.default.oneOf([
 		"start",
 		"center",
 		"end"
 	]),
+	/**
+	* Enable drop shadow for tooltips for icon-only buttons.
+	*/
 	tooltipDropShadow: prop_types.default.bool,
+	/**
+	* Render the tooltip using the high-contrast theme
+	* Default is true
+	*/
 	tooltipHighContrast: prop_types.default.bool
 };
 HeaderGlobalAction.displayName = "HeaderGlobalAction";

package/lib/components/UIShell/HeaderMenu.js

@@ -15,10 +15,10 @@ const require_useMergedRefs = require("../../internal/useMergedRefs.js");
 const require_events = require("../../tools/events.js");
 const require_AriaPropTypes = require("../../prop-types/AriaPropTypes.js");
 const require_HeaderMenuItem = require("./HeaderMenuItem.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -142,16 +142,53 @@ const HeaderMenu = frFn((props, ref) => {
 });
 HeaderMenu.displayName = "HeaderMenu";
 HeaderMenu.propTypes = {
+	/**
+	* Required props for the accessibility label of the menu
+	*/
 	...require_AriaPropTypes.AriaLabelPropType,
+	/**
+	* Optionally provide a custom class to apply to the underlying `<li>` node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Provide a custom ref handler for the menu button
+	*/
 	focusRef: prop_types.default.func,
+	/**
+	* Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
+	*/
 	isActive: prop_types.default.bool,
+	/**
+	* Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
+	* @deprecated Please use `isActive` instead. This will be removed in the next major release.
+	*/
 	isCurrentPage: require_deprecate.deprecate(prop_types.default.bool, "The `isCurrentPage` prop for `HeaderMenu` has been deprecated. Please use `isActive` instead. This will be removed in the next major release."),
+	/**
+	* Provide a label for the link text
+	*/
 	menuLinkName: prop_types.default.string.isRequired,
+	/**
+	* Optionally provide an onBlur handler that is called when the underlying
+	* button fires it's onblur event
+	*/
 	onBlur: prop_types.default.func,
+	/**
+	* Optionally provide an onClick handler that is called when the underlying
+	* button fires it's onclick event
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* Optionally provide an onKeyDown handler that is called when the underlying
+	* button fires it's onkeydown event
+	*/
 	onKeyDown: prop_types.default.func,
+	/**
+	* Optional component to render instead of string
+	*/
 	renderMenuContent: prop_types.default.func,
+	/**
+	* Optionally provide a tabIndex for the underlying menu button
+	*/
 	tabIndex: prop_types.default.number
 };
 //#endregion

package/lib/components/UIShell/HeaderMenuButton.js

@@ -8,10 +8,10 @@
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
 const require_AriaPropTypes = require("../../prop-types/AriaPropTypes.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -46,10 +46,27 @@ function HeaderMenuButton({ "aria-label": ariaLabel, "aria-labelledby": ariaLabe
 	});
 }
 HeaderMenuButton.propTypes = {
+	/**
+	* Required props for accessibility label on the underlying menu button
+	*/
 	...require_AriaPropTypes.AriaLabelPropType,
+	/**
+	* Optionally provide a custom class name that is applied to the underlying
+	* button
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the menu button is "active".
+	*/
 	isActive: prop_types.default.bool,
+	/**
+	* Specify whether the menu button is collapsible.
+	*/
 	isCollapsible: prop_types.default.bool,
+	/**
+	* Optionally provide an onClick handler that is called when the underlying
+	* button fires it's onclick event
+	*/
 	onClick: prop_types.default.func
 };
 //#endregion

package/lib/components/UIShell/HeaderMenuItem.js

@@ -9,10 +9,10 @@ const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
 const require_deprecate = require("../../prop-types/deprecate.js");
 const require_Link = require("./Link.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -50,12 +50,37 @@ const HeaderMenuItem = (0, react.forwardRef)(function HeaderMenuItem({ className
 });
 HeaderMenuItem.displayName = "HeaderMenuItem";
 HeaderMenuItem.propTypes = {
+	/**
+	* Pass in a valid `element` to replace the underlying `<a>` tag with a
+	* custom `Link` element
+	*/
 	...require_Link.LinkPropTypes,
+	/**
+	* Pass in children that are either a string or can be read as a string by
+	* screen readers
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Optionally provide a custom class to apply to the underlying `<li>` node
+	*/
 	className: prop_types.default.string,
+	/**
+	* If `true` and `aria-current !== 'page'`, applies selected styles to the item and sets `aria-current="true"`.
+	*/
 	isActive: prop_types.default.bool,
+	/**
+	* Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
+	* @deprecated Please use `isActive` instead. This will be removed in the next major release.
+	*/
 	isCurrentPage: require_deprecate.deprecate(prop_types.default.bool, "The `isCurrentPage` prop for `HeaderMenuItem` has been deprecated. Please use `isActive` instead. This will be removed in the next major release."),
+	/**
+	* Optionally supply a role for the underlying `<li>` node. Useful for resetting
+	* `<ul>` semantics for menus.
+	*/
 	role: prop_types.default.string,
+	/**
+	* Specify the tab index of the Link
+	*/
 	tabIndex: prop_types.default.number
 };
 //#endregion

package/lib/components/UIShell/HeaderName.js

@@ -8,10 +8,10 @@
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
 const require_Link = require("./Link.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -35,10 +35,28 @@ function HeaderName({ children, className: customClassName, prefix = "IBM", ...r
 	});
 }
 HeaderName.propTypes = {
+	/**
+	* Pass in a valid `element` to replace the underlying `<a>` tag with a
+	* custom `Link` element
+	*/
 	...require_Link.LinkPropTypes,
+	/**
+	* Pass in children that are either a string or can be read as a string by
+	* screen readers
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Optionally provide a custom class to apply to the underlying `<li>` node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Provide an href for the name to link to
+	*/
 	href: prop_types.default.string,
+	/**
+	* Optionally specify a prefix to your header name. Useful for companies, for
+	* example: IBM [Product Name] versus solely [Product Name]
+	*/
 	prefix: prop_types.default.string
 };
 //#endregion

package/lib/components/UIShell/HeaderNavigation.js

@@ -8,10 +8,10 @@
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
 const require_AriaPropTypes = require("../../prop-types/AriaPropTypes.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -37,8 +37,18 @@ function HeaderNavigation({ "aria-label": ariaLabel, "aria-labelledby": ariaLabe
 	});
 }
 HeaderNavigation.propTypes = {
+	/**
+	* Required props for accessibility label on the underlying menu
+	*/
 	...require_AriaPropTypes.AriaLabelPropType,
+	/**
+	* Provide valid children of HeaderNavigation, for example `HeaderMenuItem`
+	* or `HeaderMenu`
+	*/
 	children: prop_types.default.node,
+	/**
+	* Optionally provide a custom class to apply to the underlying <nav> node
+	*/
 	className: prop_types.default.string
 };
 //#endregion

package/lib/components/UIShell/HeaderPanel.js

@@ -6,18 +6,18 @@
  */
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
-const require_noopFn = require("../../internal/noopFn.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
 const require_keys = require("../../internal/keyboard/keys.js");
 const require_match = require("../../internal/keyboard/match.js");
+const require_noopFn = require("../../internal/noopFn.js");
 const require_utils = require("../../internal/utils.js");
 const require_useMergedRefs = require("../../internal/useMergedRefs.js");
 const require_useEvent = require("../../internal/useEvent.js");
 const require_Switcher = require("./Switcher.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -75,11 +75,30 @@ const HeaderPanel = react.default.forwardRef(({ children, className: customClass
 	});
 });
 HeaderPanel.propTypes = {
+	/**
+	* Specify whether focus and blur listeners are added. They are by default.
+	*/
 	addFocusListeners: prop_types.default.bool,
+	/**
+	* The content that will render inside of the `HeaderPanel`
+	*/
 	children: prop_types.default.node,
+	/**
+	* Optionally provide a custom class to apply to the underlying `<li>` node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the panel is expanded
+	*/
 	expanded: prop_types.default.bool,
+	/**
+	* Provide the `href` to the id of the element on your package that could
+	* be target.
+	*/
 	href: prop_types.default.string,
+	/**
+	* An optional listener that is called a callback to collapse the HeaderPanel
+	*/
 	onHeaderPanelFocus: prop_types.default.func
 };
 HeaderPanel.displayName = "HeaderPanel";

package/lib/components/UIShell/HeaderSideNavItems.js

@@ -7,10 +7,10 @@
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -32,8 +32,19 @@ function HeaderSideNavItems({ className: customClassName, children, hasDivider =
 	});
 }
 HeaderSideNavItems.propTypes = {
+	/**
+	* The child nodes to be rendered
+	*/
 	children: prop_types.default.node,
+	/**
+	* Optionally provide a custom class name that is applied to the underlying
+	* button
+	*/
 	className: prop_types.default.string,
+	/**
+	* Optionally specify if container will have a bottom divider to differentiate
+	* between original sidenav items and header menu items. False by default.
+	*/
 	hasDivider: prop_types.default.bool
 };
 //#endregion

package/lib/components/UIShell/Link.js

@@ -33,8 +33,22 @@ const Link = (0, react.forwardRef)((props, ref) => {
 * `@reach/router`
 */
 const LinkPropTypes = {
+	/**
+	* Provide a custom element or component to render the top-level node for the
+	* component.
+	*/
 	as: prop_types.default.elementType,
+	/**
+	* The base element to use to build the link. Defaults to `a`, can also accept
+	* alternative tag names or custom components like `Link` from `react-router`.
+	* @deprecated Use `as` instead
+	*
+	*/
 	element: require_deprecate.deprecate(prop_types.default.elementType, "The `element` prop for `Link` has been deprecated. Please use `as` instead. This will be removed in the next major release."),
+	/**
+	* Property to indicate if the side nav container is open (or not). Use to
+	* keep local state and styling in step with the SideNav expansion state.
+	*/
 	isSideNavExpanded: prop_types.default.bool
 };
 Link.displayName = "Link";

package/lib/components/UIShell/SideNav.js

@@ -15,10 +15,10 @@ const require_useDelayedState = require("../../internal/useDelayedState.js");
 const require_useMatchMedia = require("../../internal/useMatchMedia.js");
 const require_AriaPropTypes = require("../../prop-types/AriaPropTypes.js");
 const require_SideNavContext = require("./SideNavContext.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -125,20 +125,73 @@ const SideNav = (0, react.forwardRef)((props, ref) => {
 });
 SideNav.displayName = "SideNav";
 SideNav.propTypes = {
+	/**
+	* Required props for accessibility label on the underlying menu
+	*/
 	...require_AriaPropTypes.AriaLabelPropType,
+	/**
+	* Specify whether focus and blur listeners are added. They are by default.
+	*/
 	addFocusListeners: prop_types.default.bool,
+	/**
+	* Specify whether mouse entry/exit listeners are added. They are by default.
+	*/
 	addMouseListeners: prop_types.default.bool,
+	/**
+	* Optionally provide a custom class to apply to the underlying `<li>` node
+	*/
 	className: prop_types.default.string,
+	/**
+	* If `true`, the SideNav will be open on initial render.
+	*/
 	defaultExpanded: prop_types.default.bool,
+	/**
+	* Specify the duration in milliseconds to delay before displaying the side navigation
+	*/
 	enterDelayMs: prop_types.default.number,
+	/**
+	* If `true`, the SideNav will be expanded, otherwise it will be collapsed.
+	* Using this prop causes SideNav to become a controlled component.
+	*/
 	expanded: prop_types.default.bool,
+	/**
+	* Provide the `href` to the id of the element on your package that is the
+	* main content.
+	*/
 	href: prop_types.default.string,
+	/**
+	* Optionally provide a custom class to apply to the underlying `<li>` node
+	*/
 	isChildOfHeader: prop_types.default.bool,
+	/**
+	* Specify if sideNav is standalone
+	*/
 	isFixedNav: prop_types.default.bool,
+	/**
+	* Specify if the sideNav will be persistent above the lg breakpoint
+	*/
 	isPersistent: prop_types.default.bool,
+	/**
+	* Optional prop to display the side nav rail.
+	*/
 	isRail: prop_types.default.bool,
+	/**
+	* An optional listener that is called when the SideNav overlay is clicked
+	*
+	* @param {object} event
+	*/
 	onOverlayClick: prop_types.default.func,
+	/**
+	* An optional listener that is called a callback to collapse the SideNav
+	*/
 	onSideNavBlur: prop_types.default.func,
+	/**
+	* An optional listener that is called when an event that would cause
+	* toggling the SideNav occurs.
+	*
+	* @param {object} event
+	* @param {boolean} value
+	*/
 	onToggle: prop_types.default.func
 };
 //#endregion

package/lib/components/UIShell/SideNavDetails.js

@@ -7,10 +7,10 @@
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
 let classnames = require("classnames");
 classnames = require_runtime.__toESM(classnames);
+let react = require("react");
+react = require_runtime.__toESM(react);
 let prop_types = require("prop-types");
 prop_types = require_runtime.__toESM(prop_types);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -34,8 +34,18 @@ const SideNavDetails = ({ children, className: customClassName, title, ...rest }
 	});
 };
 SideNavDetails.propTypes = {
+	/**
+	* Provide optional children to render in `SideNavDetails`. Useful for
+	* rendering the `SideNavSwitcher` component.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Optionally provide a custom class to apply to the underlying `<li>` node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Provide the text that will be rendered as the title in the component
+	*/
 	title: prop_types.default.string.isRequired
 };
 //#endregion