@carbon/react 1.110.0 → 1.111.0-rc.0

package/lib/components/StructuredList/StructuredList.js

@@ -11,10 +11,10 @@ const require_Text = require("../Text/Text.js");
 const require_useId = require("../../internal/useId.js");
 const require_deprecate = require("../../prop-types/deprecate.js");
 const require_useOutsideClick = require("../../internal/useOutsideClick.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");
@@ -52,13 +52,38 @@ function StructuredListWrapper(props) {
 	});
 }
 StructuredListWrapper.propTypes = {
+	/**
+	* Specify a label to be read by screen readers on the container node
+	*/
 	["aria-label"]: prop_types.default.string,
+	/**
+	* Deprecated, please use `aria-label` instead.
+	* Specify a label to be read by screen readers on the container note.
+	*/
 	ariaLabel: require_deprecate.deprecate(prop_types.default.string, "This prop syntax has been deprecated. Please use the new `aria-label`."),
+	/**
+	* Provide the contents of your StructuredListWrapper
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be applied to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify if structured list is condensed, default is false
+	*/
 	isCondensed: prop_types.default.bool,
+	/**
+	* Specify if structured list is flush, not valid for selection variant, default is false
+	*/
 	isFlush: prop_types.default.bool,
+	/**
+	* Specify whether your StructuredListWrapper should have selections
+	*/
 	selection: prop_types.default.bool,
+	/**
+	* Specify which row will be selected initially
+	*/
 	selectedInitialRow: prop_types.default.string
 };
 function StructuredListHead(props) {
@@ -71,7 +96,13 @@ function StructuredListHead(props) {
 	});
 }
 StructuredListHead.propTypes = {
+	/**
+	* Provide the contents of your StructuredListHead
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be applied to the node
+	*/
 	className: prop_types.default.string
 };
 function StructuredListBody(props) {
@@ -84,9 +115,18 @@ function StructuredListBody(props) {
 	});
 }
 StructuredListBody.propTypes = {
+	/**
+	* Provide the contents of your StructuredListBody
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be applied to the container node
+	*/
 	className: prop_types.default.string,
 	head: prop_types.default.bool,
+	/**
+	* Provide a handler that is invoked on the key down event for the control
+	*/
 	onKeyDown: prop_types.default.func
 };
 const GridRowContext = react.default.createContext(null);
@@ -138,13 +178,37 @@ function StructuredListRow(props) {
 	});
 }
 StructuredListRow.propTypes = {
+	/**
+	* Provide the contents of your StructuredListRow
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be applied to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether your StructuredListRow should be used as a header row
+	*/
 	head: prop_types.default.bool,
+	/**
+	* Specify whether a `<label>` should be used
+	*/
 	label: require_deprecate.deprecate(prop_types.default.bool, `\nThe \`label\` prop is no longer needed and will be removed in the next major version of Carbon.`),
+	/**
+	* Provide a handler that is invoked on the click
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* Provide a handler that is invoked on the key down event for the control,
+	*/
 	onKeyDown: prop_types.default.func,
+	/**
+	* Mark if this row should be selectable
+	*/
 	selection: prop_types.default.bool,
+	/**
+	* Specify row id so that it can be used for initial selection
+	*/
 	id: prop_types.default.string
 };
 function StructuredListInput(props) {
@@ -172,12 +236,33 @@ function StructuredListInput(props) {
 	});
 }
 StructuredListInput.propTypes = {
+	/**
+	* Specify an optional className to be applied to the input
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the underlying input should be checked by default
+	*/
 	defaultChecked: require_deprecate.deprecate(prop_types.default.bool, `\nThe prop \`defaultChecked\` is no longer needed and will be removed in the next major version of Carbon.`),
+	/**
+	* Specify a custom `id` for the input
+	*/
 	id: prop_types.default.string,
+	/**
+	* Provide a `name` for the input
+	*/
 	name: prop_types.default.string,
+	/**
+	* Provide an optional hook that is called each time the input is updated
+	*/
 	onChange: prop_types.default.func,
+	/**
+	* Provide a `title` for the input
+	*/
 	title: prop_types.default.string,
+	/**
+	* Specify the value of the input
+	*/
 	value: require_deprecate.deprecate(prop_types.default.oneOfType([prop_types.default.string, prop_types.default.number]).isRequired, `\nThe prop \`value\` will be removed in the next major version of Carbon.`)
 };
 function StructuredListCell(props) {
@@ -203,9 +288,21 @@ function StructuredListCell(props) {
 	});
 }
 StructuredListCell.propTypes = {
+	/**
+	* Provide the contents of your StructuredListCell
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be applied to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether your StructuredListCell should be used as a header cell
+	*/
 	head: prop_types.default.bool,
+	/**
+	* Specify whether your StructuredListCell should have text wrapping
+	*/
 	noWrap: prop_types.default.bool
 };
 //#endregion

package/lib/components/Switch/IconSwitch.js

@@ -6,13 +6,13 @@
  */
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
-const require_noopFn = require("../../internal/noopFn.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
+const require_noopFn = require("../../internal/noopFn.js");
 const require_index = require("../IconButton/index.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");
@@ -81,6 +81,9 @@ const IconSwitch = (0, react.forwardRef)((props, ref) => {
 });
 IconSwitch.displayName = "IconSwitch";
 IconSwitch.propTypes = {
+	/**
+	* Specify how the trigger should align with the tooltip
+	*/
 	align: prop_types.default.oneOf([
 		"top",
 		"top-left",
@@ -91,21 +94,65 @@ IconSwitch.propTypes = {
 		"left",
 		"right"
 	]),
+	/**
+	* Children to be rendered inside of the `IconSwitch`.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be added to your `IconSwitch`.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Whether the `IconSwitch` should be disabled.
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Specify the duration in milliseconds to delay before displaying the tooltip
+	*/
 	enterDelayMs: prop_types.default.number,
+	/**
+	* The index of the `IconSwitch`.
+	*
+	* Reserved for usage in `ContentSwitcher`.
+	*/
 	index: prop_types.default.number,
+	/**
+	* Specify the duration in milliseconds to delay before hiding the tooltip
+	*/
 	leaveDelayMs: prop_types.default.number,
+	/**
+	* The name of the `IconSwitch`.
+	*/
 	name: prop_types.default.oneOfType([prop_types.default.string, prop_types.default.number]),
+	/**
+	* A handler that is invoked when a user clicks on the control.
+	*
+	* Reserved for usage in `ContentSwitcher`.
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* A handler that is invoked on the key down event for the control.
+	*
+	* Reserved for usage in `ContentSwitcher`.
+	*/
 	onKeyDown: prop_types.default.func,
+	/**
+	* Whether the `IconSwitch` is selected.
+	*
+	* Reserved for usage in `ContentSwitcher`.
+	*/
 	selected: prop_types.default.bool,
+	/**
+	* Specify the size of the underlying icon-only button.
+	*/
 	size: prop_types.default.oneOf([
 		"sm",
 		"md",
 		"lg"
 	]),
+	/**
+	* `Tooltip` text.
+	*/
 	text: prop_types.default.string
 };
 //#endregion

package/lib/components/Switch/Switch.js

@@ -6,12 +6,12 @@
  */
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
-const require_noopFn = require("../../internal/noopFn.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
-let react = require("react");
-react = require_runtime.__toESM(react);
+const require_noopFn = require("../../internal/noopFn.js");
 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");
@@ -65,14 +65,44 @@ const Switch = react.default.forwardRef((props, tabRef) => {
 });
 Switch.displayName = "Switch";
 Switch.propTypes = {
+	/**
+	* Provide child elements to be rendered inside of the Switch
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be added to your Switch
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether or not the Switch should be disabled
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* The index of your Switch in your ContentSwitcher that is used for event handlers.
+	* Reserved for usage in ContentSwitcher
+	*/
 	index: prop_types.default.number,
+	/**
+	* Provide the name of your Switch that is used for event handlers
+	*/
 	name: prop_types.default.oneOfType([prop_types.default.string, prop_types.default.number]),
+	/**
+	* A handler that is invoked when a user clicks on the control.
+	* Reserved for usage in ContentSwitcher
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* A handler that is invoked on the key down event for the control.
+	* Reserved for usage in ContentSwitcher
+	*/
 	onKeyDown: prop_types.default.func,
+	/**
+	* Whether your Switch is selected. Reserved for usage in ContentSwitcher
+	*/
 	selected: prop_types.default.bool,
+	/**
+	* Provide the contents of your Switch
+	*/
 	text: prop_types.default.string
 };
 //#endregion

package/lib/components/TabContent/TabContent.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,17 @@ function TabContent(props) {
 	});
 }
 TabContent.propTypes = {
+	/**
+	* Pass in content to render inside the TabContent
+	*/
 	children: prop_types.default.node,
+	/**
+	* Provide a className for the tab content container
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the TabContent is selected
+	*/
 	selected: prop_types.default.bool
 };
 //#endregion

package/lib/components/Tabs/Tabs.Skeleton.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");
@@ -49,7 +49,13 @@ function TabsSkeleton({ className, contained, ...rest }) {
 	});
 }
 TabsSkeleton.propTypes = {
+	/**
+	* Specify an optional className to add.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Provide the type of Tab
+	*/
 	contained: prop_types.default.bool
 };
 //#endregion

package/lib/components/Tabs/Tabs.js

@@ -22,10 +22,10 @@ const require_useControllableState = require("../../internal/useControllableStat
 const require_Grid = require("../Grid/Grid.js");
 const require_useMatchMedia = require("../../internal/useMatchMedia.js");
 const require_usePressable = require("./usePressable.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");
@@ -83,13 +83,36 @@ function Tabs({ children, defaultSelectedIndex = 0, onChange, selectedIndex: con
 	});
 }
 Tabs.propTypes = {
+	/**
+	* Provide child elements to be rendered inside the `Tabs`.
+	* These elements should render either `TabsList` or `TabsPanels`
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify which content tab should be initially selected when the component
+	* is first rendered
+	*/
 	defaultSelectedIndex: prop_types.default.number,
+	/**
+	* Whether the render Tab children should be dismissable.
+	*/
 	dismissable: prop_types.default.bool,
+	/**
+	* Provide an optional function which is called whenever the state of the
+	* `Tabs` changes
+	*/
 	onChange: prop_types.default.func,
+	/**
+	* If specifying the `onTabCloseRequest` prop, provide a callback function
+	* responsible for removing the tab when close button is pressed on one of the Tab elements
+	*/
 	onTabCloseRequest: (props) => {
 		if (props.dismissable && !props.onTabCloseRequest) return /* @__PURE__ */ new Error("dismissable property specified without also providing an onTabCloseRequest property.");
 	},
+	/**
+	* Control which content panel is currently selected. This puts the component
+	* in a controlled mode and should be used along with `onChange`
+	*/
 	selectedIndex: prop_types.default.number
 };
 function TabsVertical({ children, height, defaultSelectedIndex = 0, onChange, selectedIndex: controlledSelectedIndex, ...rest }) {
@@ -116,10 +139,29 @@ function TabsVertical({ children, height, defaultSelectedIndex = 0, onChange, se
 	});
 }
 TabsVertical.propTypes = {
+	/**
+	* Provide child elements to be rendered inside the `TabsVertical`.
+	* These elements should render either `TabsListVertical` or `TabsPanels`
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify which content tab should be initially selected when the component
+	* is first rendered
+	*/
 	defaultSelectedIndex: prop_types.default.number,
+	/**
+	* Option to set a height style only if using vertical variation
+	*/
 	height: prop_types.default.string,
+	/**
+	* Provide an optional function which is called whenever the state of the
+	* `Tabs` changes
+	*/
 	onChange: prop_types.default.func,
+	/**
+	* Control which content panel is currently selected. This puts the component
+	* in a controlled mode and should be used along with `onChange`
+	*/
 	selectedIndex: prop_types.default.number
 };
 /**
@@ -335,18 +377,66 @@ function TabList({ activation = "automatic", "aria-label": label, children, clas
 	});
 }
 TabList.propTypes = {
+	/**
+	* Specify whether the content tab should be activated automatically or
+	* manually
+	*/
 	activation: prop_types.default.oneOf(["automatic", "manual"]),
+	/**
+	* Provide an accessible label to be read when a user interacts with this
+	* component
+	*/
 	"aria-label": prop_types.default.string,
+	/**
+	* Provide child elements to be rendered inside `ContentTabs`.
+	* These elements should render a `ContentTab`
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be added to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether component is contained type
+	*/
 	contained: prop_types.default.bool,
+	/**
+	* Used for tabs within a grid, this makes it so tabs span the full container width and have the same width. Only available on contained tabs with <9 children
+	*/
 	fullWidth: prop_types.default.bool,
+	/**
+	* If using `IconTab`, specify the size of the icon being used.
+	*/
 	iconSize: prop_types.default.oneOf(["default", "lg"]),
+	/**
+	* Provide the props that describe the left overflow button
+	*/
 	leftOverflowButtonProps: prop_types.default.object,
+	/**
+	* Specify whether to use the light component variant
+	*/
 	light: require_deprecate.deprecate(prop_types.default.bool, "The `light` prop for `TabList` has been deprecated in favor of the new `Layer` component. It will be removed in the next major release."),
+	/**
+	* Provide the props that describe the right overflow button
+	*/
 	rightOverflowButtonProps: prop_types.default.object,
+	/**
+	* Optionally provide a delay (in milliseconds) passed to the lodash
+	* debounce of the onScroll handler. This will impact the responsiveness
+	* of scroll arrow buttons rendering when scrolling to the first or last tab.
+	*/
 	scrollDebounceWait: prop_types.default.number,
+	/**
+	* Choose whether to automatically scroll
+	* to newly selected tabs on component rerender
+	*/
 	scrollIntoView: prop_types.default.bool,
+	/**
+	* Specify the size of the tabs.
+	*
+	* Supports `sm` and `md` for line tabs.
+	* Supports `sm`, `md`, and `lg` for contained tabs.
+	*/
 	size: prop_types.default.oneOf([
 		"sm",
 		"md",
@@ -465,10 +555,28 @@ function TabListVertical({ activation = "automatic", "aria-label": label, childr
 	});
 }
 TabListVertical.propTypes = {
+	/**
+	* Specify whether the content tab should be activated automatically or
+	* manually
+	*/
 	activation: prop_types.default.oneOf(["automatic", "manual"]),
+	/**
+	* Provide an accessible label to be read when a user interacts with this
+	* component
+	*/
 	"aria-label": prop_types.default.string,
+	/**
+	* Provide child elements to be rendered inside `ContentTabs`.
+	* These elements should render a `ContentTab`
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be added to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify the size of the tabs.
+	*/
 	size: prop_types.default.oneOf([
 		"sm",
 		"md",
@@ -688,14 +796,44 @@ const Tab = (0, react.forwardRef)(({ as = "button", children, className: customC
 	}), DismissIcon] });
 });
 Tab.propTypes = {
+	/**
+	* Provide a custom element to render instead of the default button
+	*/
 	as: prop_types.default.oneOfType([prop_types.default.string, prop_types.default.elementType]),
+	/**
+	* Provide child elements to be rendered inside `Tab`.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be added to your Tab
+	*/
 	className: prop_types.default.string,
+	/**
+	* Whether your Tab is disabled.
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Provide a handler that is invoked when a user clicks on the control
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* Provide a handler that is invoked on the key down event for the control
+	*/
 	onKeyDown: prop_types.default.func,
+	/**
+	* An optional parameter to allow overriding the anchor rendering.
+	* Useful for using Tab along with react-router or other client
+	* side router libraries.
+	*/
 	renderButton: prop_types.default.func,
+	/**
+	* A component used to render an icon.
+	*/
 	renderIcon: prop_types.default.oneOfType([prop_types.default.func, prop_types.default.object]),
+	/**
+	* An optional label to render under the primary tab label.
+	* Only useful for contained tabs.
+	*/
 	secondaryLabel: prop_types.default.string
 };
 /**
@@ -726,12 +864,37 @@ const IconTab = react.default.forwardRef(({ badgeIndicator, children, className:
 	});
 });
 IconTab.propTypes = {
+	/**
+	* **Experimental**: Display an empty dot badge on the Tab.
+	*/
 	badgeIndicator: prop_types.default.bool,
+	/**
+	* Provide an icon to be rendered inside `IconTab` as the visual label for Tab.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be added to your Tab
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the tooltip for the icon should be open when it first renders
+	*/
 	defaultOpen: prop_types.default.bool,
+	/**
+	* Specify the duration in milliseconds to delay before displaying the tooltip for the icon.
+	*/
 	enterDelayMs: prop_types.default.number,
+	/**
+	* Provide the label to be rendered inside the Tooltip. The label will use
+	* `aria-labelledby` and will fully describe the child node that is provided.
+	* This means that if you have text in the child node it will not be
+	* announced to the screen reader. If using the badgeIndicator then provide a
+	* label with describing that there is a new notification.
+	*/
 	label: prop_types.default.node.isRequired,
+	/**
+	* Specify the duration in milliseconds to delay before hiding the tooltip
+	*/
 	leaveDelayMs: prop_types.default.number
 };
 const TabPanel = react.default.forwardRef(({ children, className: customClassName, ...rest }, forwardRef) => {
@@ -753,7 +916,13 @@ const TabPanel = react.default.forwardRef(({ children, className: customClassNam
 	});
 });
 TabPanel.propTypes = {
+	/**
+	* Provide child elements to be rendered inside `TabPanel`.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be added to TabPanel.
+	*/
 	className: prop_types.default.string
 };
 function TabPanels({ children }) {
@@ -786,7 +955,11 @@ function TabPanels({ children }) {
 		});
 	}) });
 }
-TabPanels.propTypes = { children: prop_types.default.node };
+TabPanels.propTypes = { 
+/**
+* Provide child elements to be rendered inside `TabPanels`.
+*/
+children: prop_types.default.node };
 //#endregion
 exports.IconTab = IconTab;
 exports.Tab = Tab;

package/lib/components/Tabs/usePressable.js

@@ -5,7 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-require("../../_virtual/_rolldown/runtime.js");
 let react = require("react");
 //#region src/components/Tabs/usePressable.ts
 /**