@carbon/react 1.110.0 → 1.111.0-rc.0

package/lib/components/Checkbox/Checkbox.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");
@@ -32,6 +32,10 @@ const CheckboxSkeleton = ({ className, ...rest }) => {
 		})
 	});
 };
-CheckboxSkeleton.propTypes = { className: prop_types.default.string };
+CheckboxSkeleton.propTypes = { 
+/**
+* Specify an optional className to add.
+*/
+className: prop_types.default.string };
 //#endregion
 exports.default = CheckboxSkeleton;

package/lib/components/Checkbox/Checkbox.js

@@ -6,19 +6,19 @@
  */
 
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
-const require_noopFn = require("../../internal/noopFn.js");
 const require_usePrefix = require("../../internal/usePrefix.js");
 const require_Text = require("../Text/Text.js");
 const require_useId = require("../../internal/useId.js");
+const require_noopFn = require("../../internal/noopFn.js");
 const require_deprecate = require("../../prop-types/deprecate.js");
 const require_utils = require("../../internal/utils.js");
 const require_hasHelperText = require("../../internal/hasHelperText.js");
 const require_useNormalizedInputProps = require("../../internal/useNormalizedInputProps.js");
 const require_index = require("../AILabel/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");
@@ -116,23 +116,80 @@ const Checkbox = react.default.forwardRef(({ className, decorator, helperText, i
 	});
 });
 Checkbox.propTypes = {
+	/**
+	* Specify whether the underlying input should be checked
+	*/
 	checked: prop_types.default.bool,
+	/**
+	* Specify an optional className to be applied to the <label> node
+	*/
 	className: prop_types.default.string,
+	/**
+	* **Experimental**: Provide a decorator component to be rendered inside the `Checkbox` component
+	*/
 	decorator: prop_types.default.node,
+	/**
+	* Specify whether the underlying input should be checked by default
+	*/
 	defaultChecked: prop_types.default.bool,
+	/**
+	* Specify whether the Checkbox should be disabled
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Provide text for the form group for additional help
+	*/
 	helperText: prop_types.default.node,
+	/**
+	* Specify whether the label should be hidden, or not
+	*/
 	hideLabel: prop_types.default.bool,
+	/**
+	* Provide an `id` to uniquely identify the Checkbox input
+	*/
 	id: prop_types.default.string.isRequired,
+	/**
+	* Specify whether the Checkbox is in an indeterminate state
+	*/
 	indeterminate: prop_types.default.bool,
+	/**
+	* Specify whether the Checkbox is currently invalid
+	*/
 	invalid: prop_types.default.bool,
+	/**
+	* Provide the text that is displayed when the Checkbox is in an invalid state
+	*/
 	invalidText: prop_types.default.node,
+	/**
+	* Provide a label to provide a description of the Checkbox input that you are
+	* exposing to the user
+	*/
 	labelText: prop_types.default.node.isRequired,
+	/**
+	* Provide an optional handler that is called when the internal state of
+	* Checkbox changes. This handler is called with event and state info.
+	* `(event, { checked, id }) => void`
+	*/
 	onChange: prop_types.default.func,
+	/**
+	* Specify whether the Checkbox is read-only
+	*/
 	readOnly: prop_types.default.bool,
+	/**
+	* **Experimental**: Provide a `Slug` component to be rendered inside the `Checkbox` component
+	*/
 	slug: require_deprecate.deprecate(prop_types.default.node, "The `slug` prop has been deprecated and will be removed in the next major version. Use the decorator prop instead."),
+	/**
+	* Specify a title for the <label> node for the Checkbox
+	*/
 	title: prop_types.default.string,
+	/**
+	* Specify whether the Checkbox is currently in warning state
+	*/
 	warn: prop_types.default.bool,
+	/**
+	* Provide the text that is displayed when the Checkbox is in warning state
+	*/
 	warnText: prop_types.default.node
 };
 Checkbox.displayName = "Checkbox";

package/lib/components/CheckboxGroup/CheckboxGroup.js

@@ -14,10 +14,10 @@ const require_hasHelperText = require("../../internal/hasHelperText.js");
 const require_useNormalizedInputProps = require("../../internal/useNormalizedInputProps.js");
 const require_index = require("../AILabel/index.js");
 const require_Checkbox = require("../Checkbox/Checkbox.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");
@@ -109,18 +109,58 @@ const CheckboxGroup = ({ children, className, decorator, helperText, invalid, in
 	});
 };
 CheckboxGroup.propTypes = {
+	/**
+	* Provide the children form elements to be rendered inside of the <fieldset>
+	*/
 	children: prop_types.default.node,
+	/**
+	* Provide a custom className to be applied to the containing <fieldset> node
+	*/
 	className: prop_types.default.string,
+	/**
+	* **Experimental**: Provide a decorator component to be rendered inside the `CheckboxGroup` component
+	*/
 	decorator: prop_types.default.node,
+	/**
+	* Provide text for the form group for additional help
+	*/
 	helperText: prop_types.default.node,
+	/**
+	* Specify whether the form group is currently invalid
+	*/
 	invalid: prop_types.default.bool,
+	/**
+	* Provide the text that is displayed when the form group is in an invalid state
+	*/
 	invalidText: prop_types.default.node,
+	/**
+	* Provide id for the fieldset <legend> which corresponds to the fieldset
+	* `aria-labelledby`
+	*/
 	legendId: prop_types.default.node,
+	/**
+	* Provide the text to be rendered inside of the fieldset <legend>
+	*/
 	legendText: prop_types.default.node.isRequired,
+	/**
+	* Provide the orientation for how the checkbox should be displayed
+	*/
 	orientation: prop_types.default.oneOf(["horizontal", "vertical"]),
+	/**
+	* Whether the CheckboxGroup should be read-only
+	*/
 	readOnly: prop_types.default.bool,
+	/**
+	* **Experimental**: Provide a `Slug` component to be rendered inside the `CheckboxGroup` component
+	*/
 	slug: require_deprecate.deprecate(prop_types.default.node, "The `slug` prop has been deprecated and will be removed in the next major version. Use the decorator prop instead."),
+	/**
+	* Specify whether the form group is currently in warning state
+	*/
 	warn: prop_types.default.bool,
+	/**
+	* Provide the text that is displayed when the form group is in warning state
+	*/
 	warnText: prop_types.default.node
 };
 //#endregion

package/lib/components/ClassPrefix/index.js

@@ -27,6 +27,9 @@ function ClassPrefix({ children, prefix }) {
 }
 ClassPrefix.propTypes = {
 	children: prop_types.default.node,
+	/**
+	* The value used to prefix the CSS selectors used by Carbon components
+	*/
 	prefix: prop_types.default.string.isRequired
 };
 //#endregion

package/lib/components/CodeSnippet/CodeSnippet.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");
@@ -51,7 +51,13 @@ function CodeSnippetSkeleton({ className: containerClassName, type = "single", .
 	});
 }
 CodeSnippetSkeleton.propTypes = {
+	/**
+	* Specify an optional className to be applied to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* The type of the code snippet, including single or multi
+	*/
 	type: prop_types.default.oneOf(["single", "multi"])
 };
 //#endregion

package/lib/components/CodeSnippet/CodeSnippet.js

@@ -15,10 +15,10 @@ const require_index = require("../Button/index.js");
 const require_useResizeObserver = require("../../internal/useResizeObserver.js");
 const require_index$1 = require("../Copy/index.js");
 const require_index$2 = require("../CopyButton/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");
@@ -164,6 +164,9 @@ function CodeSnippet({ align = "bottom", autoAlign = false, className, type = "s
 	});
 }
 CodeSnippet.propTypes = {
+	/**
+	* Specify how the trigger should align with the tooltip
+	*/
 	align: require_deprecateValuesWithin.deprecateValuesWithin(prop_types.default.oneOf([
 		"top",
 		"top-left",
@@ -199,30 +202,103 @@ CodeSnippet.propTypes = {
 		"right-start",
 		"right-end"
 	], require_mapPopoverAlign.mapPopoverAlign),
+	/**
+	* Specify a label to be read by screen readers on the containing textbox
+	* node
+	*/
 	["aria-label"]: prop_types.default.string,
+	/**
+	* Deprecated, please use `aria-label` instead.
+	* Specify a label to be read by screen readers on the containing textbox
+	* node
+	*/
 	ariaLabel: require_deprecate.deprecate(prop_types.default.string, "This prop syntax has been deprecated. Please use the new `aria-label`."),
+	/**
+	* **Experimental**: Will attempt to automatically align the tooltip. Requires
+	* React v17+
+	* @see https://github.com/carbon-design-system/carbon/issues/18714
+	*/
 	autoAlign: prop_types.default.bool,
+	/**
+	* Provide the content of your CodeSnippet as a node or string
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to be applied to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify the description for the Copy Button
+	*/
 	copyButtonDescription: prop_types.default.string,
+	/**
+	* Optional text to copy. If not specified, the `children` node's `innerText`
+	* will be used as the copy value.
+	*/
 	copyText: prop_types.default.string,
+	/**
+	* Specify whether or not the CodeSnippet should be disabled
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Specify the string displayed when the snippet is copied
+	*/
 	feedback: prop_types.default.string,
+	/**
+	* Specify the time it takes for the feedback message to timeout
+	*/
 	feedbackTimeout: prop_types.default.number,
+	/**
+	* Specify whether or not a copy button should be used/rendered.
+	*/
 	hideCopyButton: prop_types.default.bool,
+	/**
+	* Specify whether you are using the light variant of the Code Snippet,
+	* typically used for inline snippet to display an alternate color
+	*/
 	light: require_deprecate.deprecate(prop_types.default.bool, "The `light` prop for `CodeSnippet` has been deprecated in favor of the new `Layer` component. It will be removed in the next major release."),
+	/**
+	* Specify the maximum number of rows to be shown when in collapsed view
+	*/
 	maxCollapsedNumberOfRows: prop_types.default.number,
+	/**
+	* Specify the maximum number of rows to be shown when in expanded view
+	*/
 	maxExpandedNumberOfRows: prop_types.default.number,
+	/**
+	* Specify the minimum number of rows to be shown when in collapsed view
+	*/
 	minCollapsedNumberOfRows: prop_types.default.number,
+	/**
+	* Specify the minimum number of rows to be shown when in expanded view
+	*/
 	minExpandedNumberOfRows: prop_types.default.number,
+	/**
+	* An optional handler to listen to the `onClick` even fired by the Copy
+	* Button
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* Specify a string that is displayed when the Code Snippet has been
+	* interacted with to show more lines
+	*/
 	showLessText: prop_types.default.string,
+	/**
+	* Specify a string that is displayed when the Code Snippet text is more
+	* than 15 lines
+	*/
 	showMoreText: prop_types.default.string,
+	/**
+	* Provide the type of Code Snippet
+	*/
 	type: prop_types.default.oneOf([
 		"single",
 		"inline",
 		"multi"
 	]),
+	/**
+	* Specify whether or not to wrap the text.
+	*/
 	wrapText: prop_types.default.bool
 };
 //#endregion

package/lib/components/ComboBox/ComboBox.js

@@ -23,10 +23,10 @@ const require_index$2 = require("../ListBox/index.js");
 const require_ListBoxSelection = require("../ListBox/next/ListBoxSelection.js");
 const require_ListBoxTrigger = require("../ListBox/next/ListBoxTrigger.js");
 const require_mergeRefs = require("../../tools/mergeRefs.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");
@@ -619,47 +619,187 @@ const ComboBox = (0, react.forwardRef)((props, ref) => {
 });
 ComboBox.displayName = "ComboBox";
 ComboBox.propTypes = {
+	/**
+	* Specify whether or not the ComboBox should allow a value that is
+	* not in the list to be entered in the input
+	*/
 	allowCustomValue: prop_types.default.bool,
+	/**
+	* 'aria-label' of the ListBox component.
+	* 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.
+	* 'aria-label' of the ListBox component.
+	*/
 	ariaLabel: require_deprecate.deprecate(prop_types.default.string, "This prop syntax has been deprecated. Please use the new `aria-label`."),
+	/**
+	* **Experimental**: Will attempt to automatically align the floating
+	* element to avoid collisions with the viewport and being clipped by
+	* ancestor elements. Requires React v17+
+	* @see https://github.com/carbon-design-system/carbon/issues/18714
+	*/
 	autoAlign: prop_types.default.bool,
+	/**
+	* An optional className to add to the container node
+	*/
 	className: prop_types.default.string,
+	/**
+	* **Experimental**: Provide a decorator component to be rendered inside the `ComboBox` component
+	*/
 	decorator: prop_types.default.node,
+	/**
+	* Specify the direction of the combobox dropdown. Can be either top or bottom.
+	*/
 	direction: prop_types.default.oneOf(["top", "bottom"]),
+	/**
+	* Specify if the control should be disabled, or not
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Additional props passed to Downshift.
+	*
+	* **Use with caution:** anything you define here overrides the components'
+	* internal handling of that prop. Downshift APIs and internals are subject to
+	* change, and in some cases they can not be shimmed by Carbon to shield you
+	* from potentially breaking changes.
+	*/
 	downshiftProps: prop_types.default.object,
+	/**
+	* Provide a ref that will be mutated to contain an object of downshift
+	* action functions. These can be called to change the internal state of the
+	* downshift useCombobox hook.
+	*
+	* **Use with caution:** calling these actions modifies the internal state of
+	* downshift. It may conflict with or override the state management used within
+	* Combobox. Downshift APIs and internals are subject to change, and in some
+	* cases they can not be shimmed by Carbon to shield you from potentially breaking
+	* changes.
+	*/
 	downshiftActions: prop_types.default.exact({ current: prop_types.default.any }),
+	/**
+	* Provide helper text that is used alongside the control label for
+	* additional help
+	*/
 	helperText: prop_types.default.node,
+	/**
+	* Specify a custom `id` for the input
+	*/
 	id: prop_types.default.string.isRequired,
+	/**
+	* Allow users to pass in an arbitrary item or a string (in case their items are an array of strings)
+	* from their collection that are pre-selected
+	*/
 	initialSelectedItem: prop_types.default.oneOfType([
 		prop_types.default.object,
 		prop_types.default.string,
 		prop_types.default.number
 	]),
+	/**
+	* Specify if the currently selected value is invalid.
+	*/
 	invalid: prop_types.default.bool,
+	/**
+	* Message which is displayed if the value is invalid.
+	*/
 	invalidText: prop_types.default.node,
+	/**
+	* Renders an item as a custom React node instead of a string.
+	*/
 	itemToElement: prop_types.default.func,
+	/**
+	* Helper function passed to downshift that allows the library to render a
+	* given item to a string label. By default, it extracts the `label` field
+	* from a given item to serve as the item label in the list
+	*/
 	itemToString: prop_types.default.func,
+	/**
+	* We try to stay as generic as possible here to allow individuals to pass
+	* in a collection of whatever kind of data structure they prefer
+	*/
 	items: prop_types.default.array.isRequired,
+	/**
+	* should use "light theme" (white background)?
+	*/
 	light: require_deprecate.deprecate(prop_types.default.bool, "The `light` prop for `Combobox` has been deprecated in favor of the new `Layer` component. It will be removed in the next major release."),
+	/**
+	* `onChange` is a utility for this controlled component to communicate to a
+	* consuming component when a specific dropdown item is selected.
+	* `({ selectedItem }) => void`
+	* @param {{ selectedItem }}
+	*/
 	onChange: prop_types.default.func.isRequired,
+	/**
+	* Callback function to notify consumer when the text input changes.
+	* This provides support to change available items based on the text.
+	* `(inputText) => void`
+	* @param {string} inputText
+	*/
 	onInputChange: prop_types.default.func,
+	/**
+	* Callback function that fires when the combobox menu toggle is clicked
+	* `(evt) => void`
+	* @param {MouseEvent} event
+	*/
 	onToggleClick: prop_types.default.func,
+	/**
+	* Used to provide a placeholder text node before a user enters any input.
+	* This is only present if the control has no items selected
+	*/
 	placeholder: prop_types.default.string,
+	/**
+	* Is the ComboBox readonly?
+	*/
 	readOnly: prop_types.default.bool,
+	/**
+	* For full control of the selection
+	*/
 	selectedItem: prop_types.default.oneOfType([
 		prop_types.default.object,
 		prop_types.default.string,
 		prop_types.default.number
 	]),
+	/**
+	* Specify your own filtering logic by passing in a `shouldFilterItem`
+	* function that takes in the current input and an item and passes back
+	* whether or not the item should be filtered.
+	* this prop will be ignored if `typeahead` prop is enabled
+	*/
 	shouldFilterItem: prop_types.default.func,
+	/**
+	* Specify the size of the ListBox. Currently supports either `xs`, `sm`, `md` or `lg` as an option.
+	*/
 	size: require_ListBoxPropTypes.ListBoxSizePropType,
 	slug: require_deprecate.deprecate(prop_types.default.node, "The `slug` prop has been deprecated and will be removed in the next major version. Use the decorator prop instead."),
+	/**
+	* Provide text to be used in a `<label>` element that is tied to the
+	* combobox via ARIA attributes.
+	*/
 	titleText: prop_types.default.node,
+	/**
+	* Translates component strings using your i18n tool.
+	*/
 	translateWithId: prop_types.default.func,
+	/**
+	* **Experimental**: will enable autocomplete and typeahead for the input field
+	*/
 	typeahead: prop_types.default.bool,
+	/**
+	* Specify whether the control is currently in warning state
+	*/
 	warn: prop_types.default.bool,
+	/**
+	* Provide the text that is displayed when the control is in warning state
+	*/
 	warnText: prop_types.default.node,
+	/**
+	* Specify native input attributes to place on the `<input>`, like maxLength.
+	* These are passed to downshift's getInputProps() and will override the
+	* internal input props.
+	* https://github.com/downshift-js/downshift?tab=readme-ov-file#getinputprops
+	*/
 	inputProps: prop_types.default.object
 };
 //#endregion

package/lib/components/ComboButton/index.js

@@ -17,10 +17,10 @@ const require_index$2 = require("../Button/index.js");
 const require_mergeRefs = require("../../tools/mergeRefs.js");
 const require_Menu = require("../Menu/Menu.js");
 const require_useAttachedMenu = require("../../internal/useAttachedMenu.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");
@@ -126,10 +126,25 @@ const ComboButton = react.default.forwardRef(function ComboButton({ children, cl
 	});
 });
 ComboButton.propTypes = {
+	/**
+	* A collection of MenuItems to be rendered as additional actions for this ComboButton.
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Additional CSS class names.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the ComboButton should be disabled, or not.
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Provide the label to be rendered on the primary action button.
+	*/
 	label: prop_types.default.string.isRequired,
+	/**
+	* Experimental property. Specify how the menu should align with the button element
+	*/
 	menuAlignment: prop_types.default.oneOf([
 		"top",
 		"top-start",
@@ -138,13 +153,22 @@ ComboButton.propTypes = {
 		"bottom-start",
 		"bottom-end"
 	]),
+	/**
+	* Provide an optional function to be called when the primary action element is clicked.
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* Specify the size of the buttons and menu.
+	*/
 	size: prop_types.default.oneOf([
 		"xs",
 		"sm",
 		"md",
 		"lg"
 	]),
+	/**
+	* Specify how the trigger tooltip should be aligned.
+	*/
 	tooltipAlignment: require_deprecateValuesWithin.deprecateValuesWithin(prop_types.default.oneOf([
 		"top",
 		"top-left",
@@ -180,6 +204,9 @@ ComboButton.propTypes = {
 		"right-start",
 		"right-end"
 	], require_mapPopoverAlign.mapPopoverAlign),
+	/**
+	* Translates component strings using your i18n tool.
+	*/
 	translateWithId: prop_types.default.func
 };
 //#endregion