@carbon/react 1.110.0 → 1.111.0-rc.0

package/es/components/Dialog/Dialog.js

@@ -5,10 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { noopFn } from "../../internal/noopFn.js";
 import { usePrefix } from "../../internal/usePrefix.js";
 import { Text } from "../Text/Text.js";
 import { useId } from "../../internal/useId.js";
+import { noopFn } from "../../internal/noopFn.js";
 import { deprecate } from "../../prop-types/deprecate.js";
 import { IconButton } from "../IconButton/index.js";
 import Button_default from "../Button/index.js";
@@ -16,8 +16,8 @@ import ButtonSet_default from "../ButtonSet/index.js";
 import { useResizeObserver } from "../../internal/useResizeObserver.js";
 import { Layer } from "../Layer/index.js";
 import InlineLoading from "../InlineLoading/InlineLoading.js";
-import React, { createContext, useContext, useEffect, useRef, useState } from "react";
 import classNames from "classnames";
+import React, { createContext, useContext, useEffect, useRef, useState } from "react";
 import PropTypes from "prop-types";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Close } from "@carbon/icons-react";
@@ -104,18 +104,59 @@ const Dialog = React.forwardRef(({ children, className, focusAfterCloseRef, moda
 });
 Dialog.displayName = "Dialog";
 Dialog.propTypes = {
+	/**
+	* Provide children to be rendered inside of the Dialog
+	*/
 	children: PropTypes.node,
+	/**
+	* Specify an optional className to be applied to the modal root node
+	*/
 	className: PropTypes.string,
+	/**
+	* Provide a ref to return focus to once the dialog is closed.
+	*/
 	focusAfterCloseRef: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({ current: PropTypes.any })]),
+	/**
+	* Modal specifies whether the Dialog is modal or non-modal. This cannot be
+	* changed while open=true
+	*/
 	modal: PropTypes.bool,
+	/**
+	* Specify a handler for closing Dialog.
+	* The handler should care of closing Dialog, e.g. changing `open` prop.
+	*/
 	onRequestClose: PropTypes.func,
+	/**
+	* open initial state
+	*/
 	open: PropTypes.bool,
+	/**
+	* Specify the role of the dialog for accessibility
+	*/
 	role: PropTypes.oneOf(["dialog", "alertdialog"]),
+	/**
+	* Specify a label for screen readers
+	*/
 	"aria-label": PropTypes.string,
+	/**
+	* Specify the ID of an element that labels this dialog
+	*/
 	"aria-labelledby": PropTypes.string,
+	/**
+	* Specify the ID of an element that describes this dialog
+	*/
 	"aria-describedby": PropTypes.string,
+	/**
+	* Specify a label for screen readers
+	*/
 	ariaLabel: deprecate(PropTypes.string, "This prop syntax has been deprecated. Please use the new `aria-label`"),
+	/**
+	* Specify the ID of an element that labels this dialog
+	*/
 	ariaLabelledBy: deprecate(PropTypes.string, "This prop syntax has been deprecated. Please use the new `aria-labelledby`"),
+	/**
+	* Specify the ID of an element that describes this dialog
+	*/
 	ariaDescribedBy: deprecate(PropTypes.string, "This prop syntax has been deprecated. Please use the new `aria-describedby`")
 };
 const DialogHeader = React.forwardRef(({ children, ...rest }, ref) => {
@@ -127,7 +168,11 @@ const DialogHeader = React.forwardRef(({ children, ...rest }, ref) => {
 	});
 });
 DialogHeader.displayName = "DialogHeader";
-DialogHeader.propTypes = { children: PropTypes.node };
+DialogHeader.propTypes = { 
+/**
+* Provide the contents to be rendered inside of this component
+*/
+children: PropTypes.node };
 const DialogControls = React.forwardRef(({ children, ...rest }, ref) => {
 	return /* @__PURE__ */ jsx("div", {
 		className: `${usePrefix()}--dialog__header-controls`,
@@ -137,7 +182,11 @@ const DialogControls = React.forwardRef(({ children, ...rest }, ref) => {
 	});
 });
 DialogControls.displayName = "DialogControls";
-DialogControls.propTypes = { children: PropTypes.node };
+DialogControls.propTypes = { 
+/**
+* Provide children to be rendered inside of this component
+*/
+children: PropTypes.node };
 const DialogCloseButton = React.forwardRef(({ onClick, ...rest }, ref) => {
 	const prefix = usePrefix();
 	return /* @__PURE__ */ jsx(IconButton, {
@@ -159,7 +208,11 @@ const DialogCloseButton = React.forwardRef(({ onClick, ...rest }, ref) => {
 	});
 });
 DialogCloseButton.displayName = "DialogCloseButton";
-DialogCloseButton.propTypes = { onClick: PropTypes.func };
+DialogCloseButton.propTypes = { 
+/**
+* Specify a click handler applied to the IconButton
+*/
+onClick: PropTypes.func };
 const DialogTitle = React.forwardRef(({ children, className, id, ...rest }, ref) => {
 	const prefix = usePrefix();
 	const { dialogId, setTitleId } = useContext(DialogContext);
@@ -180,8 +233,17 @@ const DialogTitle = React.forwardRef(({ children, className, id, ...rest }, ref)
 });
 DialogTitle.displayName = "DialogTitle";
 DialogTitle.propTypes = {
+	/**
+	* Provide the contents to be rendered inside of this component
+	*/
 	children: PropTypes.node,
+	/**
+	* Specify an optional className to be applied to the title node
+	*/
 	className: PropTypes.string,
+	/**
+	* Specify an optional id for the title element
+	*/
 	id: PropTypes.string
 };
 const DialogSubtitle = React.forwardRef(({ children, className, id, ...rest }, ref) => {
@@ -204,8 +266,17 @@ const DialogSubtitle = React.forwardRef(({ children, className, id, ...rest }, r
 });
 DialogSubtitle.displayName = "DialogSubtitle";
 DialogSubtitle.propTypes = {
+	/**
+	* Provide the contents to be rendered inside of this component
+	*/
 	children: PropTypes.node,
+	/**
+	* Specify an optional className to be applied to the subtitle node
+	*/
 	className: PropTypes.string,
+	/**
+	* Specify an optional id for the subtitle element
+	*/
 	id: PropTypes.string
 };
 const DialogBody = React.forwardRef(({ children, className, hasScrollingContent, ...rest }, ref) => {
@@ -244,8 +315,17 @@ const DialogBody = React.forwardRef(({ children, className, hasScrollingContent,
 });
 DialogBody.displayName = "DialogBody";
 DialogBody.propTypes = {
+	/**
+	* Provide the contents to be rendered inside of this component
+	*/
 	children: PropTypes.node,
+	/**
+	* Specify an optional className to be applied to the body node
+	*/
 	className: PropTypes.string,
+	/**
+	* Specify whether the content has overflow that should be scrollable
+	*/
 	hasScrollingContent: PropTypes.bool
 };
 const DialogFooter = React.forwardRef(({ children, className, onRequestClose = noopFn, onSecondarySubmit, onRequestSubmit = noopFn, primaryButtonText = "Save", primaryButtonDisabled = false, secondaryButtonText = "Cancel", secondaryButtons, loadingStatus = "inactive", loadingDescription, loadingIconDescription, onLoadingSuccess = noopFn, danger = false, dangerDescription = "", ...rest }, ref) => {
@@ -312,14 +392,41 @@ const DialogFooter = React.forwardRef(({ children, className, onRequestClose = n
 });
 DialogFooter.displayName = "DialogFooter";
 DialogFooter.propTypes = {
+	/**
+	* Provide the contents to be rendered inside of this component
+	*/
 	children: PropTypes.node,
+	/**
+	* Specify an optional className to be applied to the footer node
+	*/
 	className: PropTypes.string,
+	/**
+	* Specify a handler for closing dialog.
+	*/
 	onRequestClose: PropTypes.func,
+	/**
+	* Specify a handler for the secondary button.
+	*/
 	onSecondarySubmit: PropTypes.func,
+	/**
+	* Specify a handler for submitting dialog.
+	*/
 	onRequestSubmit: PropTypes.func,
+	/**
+	* Specify the text for the primary button
+	*/
 	primaryButtonText: PropTypes.node,
+	/**
+	* Specify whether the Button should be disabled, or not
+	*/
 	primaryButtonDisabled: PropTypes.bool,
+	/**
+	* Specify the text for the secondary button
+	*/
 	secondaryButtonText: PropTypes.node,
+	/**
+	* Specify an array of config objects for secondary buttons
+	*/
 	secondaryButtons: (props, propName, componentName) => {
 		if (props.secondaryButtons) {
 			if (!Array.isArray(props.secondaryButtons) || props.secondaryButtons.length !== 2) return /* @__PURE__ */ new Error(`${propName} needs to be an array of two button config objects`);
@@ -333,16 +440,36 @@ DialogFooter.propTypes = {
 		}
 		return null;
 	},
+	/**
+	* Specify whether the Dialog is for dangerous actions
+	*/
 	danger: PropTypes.bool,
+	/**
+	* Specify the message read by screen readers for the danger primary button.
+	* Defaults to an empty string; provide localized text to opt in.
+	*/
 	dangerDescription: PropTypes.string,
+	/**
+	* Specify loading status
+	*/
 	loadingStatus: PropTypes.oneOf([
 		"inactive",
 		"active",
 		"finished",
 		"error"
 	]),
+	/**
+	* Specify the description for the loading text
+	*/
 	loadingDescription: PropTypes.string,
+	/**
+	* Specify the description for the loading icon
+	*/
 	loadingIconDescription: PropTypes.string,
+	/**
+	* Provide an optional handler to be invoked when loading is
+	* successful
+	*/
 	onLoadingSuccess: PropTypes.func
 };
 //#endregion

package/es/components/Dropdown/Dropdown.Skeleton.js

@@ -7,8 +7,8 @@
 
 import { usePrefix } from "../../internal/usePrefix.js";
 import { ListBoxSizePropType } from "../ListBox/ListBoxPropTypes.js";
-import "react";
 import classNames from "classnames";
+import "react";
 import PropTypes from "prop-types";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/Dropdown/Dropdown.Skeleton.tsx
@@ -27,8 +27,17 @@ const DropdownSkeleton = ({ className, size, hideLabel, ...rest }) => {
 	});
 };
 DropdownSkeleton.propTypes = {
+	/**
+	* Specify an optional className to add.
+	*/
 	className: PropTypes.string,
+	/**
+	* Specify whether the label should be hidden, or not
+	*/
 	hideLabel: PropTypes.bool,
+	/**
+	* Specify the size of the ListBox.
+	*/
 	size: ListBoxSizePropType
 };
 //#endregion

package/es/components/Dropdown/Dropdown.js

@@ -16,8 +16,8 @@ import { ListBoxSizePropType, ListBoxTypePropType } from "../ListBox/ListBoxProp
 import { FormContext } from "../FluidForm/FormContext.js";
 import ListBox from "../ListBox/index.js";
 import { mergeRefs } from "../../tools/mergeRefs.js";
-import React, { cloneElement, isValidElement, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import classNames from "classnames";
+import React, { cloneElement, isValidElement, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import PropTypes from "prop-types";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Checkmark, WarningAltFilled, WarningFilled } from "@carbon/icons-react";
@@ -313,43 +313,152 @@ const Dropdown = React.forwardRef(({ autoAlign = false, className: containerClas
 });
 Dropdown.displayName = "Dropdown";
 Dropdown.propTypes = {
+	/**
+	* 'aria-label' of the ListBox component.
+	* Specify a label to be read by screen readers on the container node
+	*/
 	["aria-label"]: PropTypes.string,
+	/**
+	* Deprecated, please use `aria-label` instead.
+	* Specify a label to be read by screen readers on the container note.
+	*/
 	ariaLabel: deprecate(PropTypes.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: PropTypes.bool,
+	/**
+	* Provide a custom className to be applied on the cds--dropdown node
+	*/
 	className: PropTypes.string,
+	/**
+	* **Experimental**: Provide a `decorator` component to be rendered inside the `Dropdown` component
+	*/
 	decorator: PropTypes.node,
+	/**
+	* Specify the direction of the dropdown. Can be either top or bottom.
+	*/
 	direction: PropTypes.oneOf(["top", "bottom"]),
+	/**
+	* Disable the control
+	*/
 	disabled: PropTypes.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: PropTypes.object,
+	/**
+	* Provide helper text that is used alongside the control label for
+	* additional help
+	*/
 	helperText: PropTypes.node,
+	/**
+	* Specify whether the title text should be hidden or not
+	*/
 	hideLabel: PropTypes.bool,
+	/**
+	* Specify a custom `id`
+	*/
 	id: PropTypes.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: PropTypes.oneOfType([
 		PropTypes.object,
 		PropTypes.string,
 		PropTypes.number
 	]),
+	/**
+	* Specify if the currently selected value is invalid.
+	*/
 	invalid: PropTypes.bool,
+	/**
+	* Message which is displayed if the value is invalid.
+	*/
 	invalidText: PropTypes.node,
+	/**
+	* Renders an item as a custom React node instead of a string.
+	*/
 	itemToElement: PropTypes.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: PropTypes.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: PropTypes.array.isRequired,
+	/**
+	* Generic `label` that will be used as the textual representation of what
+	* this field is for
+	*/
 	label: PropTypes.node.isRequired,
+	/**
+	* `true` to use the light version.
+	*/
 	light: deprecate(PropTypes.bool, "The `light` prop for `Dropdown` 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 what kind of internal state changes are occurring.
+	*/
 	onChange: PropTypes.func,
+	/**
+	* Whether or not the Dropdown is readonly
+	*/
 	readOnly: PropTypes.bool,
+	/**
+	* An optional callback to render the currently selected item as a react element instead of only
+	* as a string.
+	*/
 	renderSelectedItem: PropTypes.func,
+	/**
+	* In the case you want to control the dropdown selection entirely.
+	*/
 	selectedItem: PropTypes.oneOfType([
 		PropTypes.object,
 		PropTypes.string,
 		PropTypes.number
 	]),
+	/**
+	* Specify the size of the ListBox. Currently supports either `xs`, `sm`, `md` or `lg` as an option.
+	*/
 	size: ListBoxSizePropType,
+	/**
+	* **Experimental**: Provide a `Slug` component to be rendered inside the `Dropdown` component
+	*/
 	slug: deprecate(PropTypes.node, "The `slug` prop for `Dropdown` has been deprecated in favor of the new `decorator` prop. It will be removed in the next major release."),
+	/**
+	* Provide the title text that will be read by a screen reader when
+	* visiting this control
+	*/
 	titleText: PropTypes.node.isRequired,
+	/**
+	* Translates component strings using your i18n tool.
+	*/
 	translateWithId: PropTypes.func,
+	/**
+	* The dropdown type, `default` or `inline`
+	*/
 	type: ListBoxTypePropType,
+	/**
+	* Specify whether the control is currently in warning state
+	*/
 	warn: PropTypes.bool,
+	/**
+	* Provide the text that is displayed when the control is in warning state
+	*/
 	warnText: PropTypes.node
 };
 //#endregion

package/es/components/ExpandableSearch/ExpandableSearch.js

@@ -12,8 +12,8 @@ import { composeEventHandlers } from "../../tools/events.js";
 import { mergeRefs } from "../../tools/mergeRefs.js";
 import { isSearchValuePresent } from "../Search/utils.js";
 import Search_default from "../Search/index.js";
-import { forwardRef, useEffect, useRef, useState } from "react";
 import classNames from "classnames";
+import { forwardRef, useEffect, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/ExpandableSearch/ExpandableSearch.tsx
 /**

package/es/components/FeatureFlags/index.js

@@ -66,6 +66,9 @@ const FeatureFlags$1 = ({ children, flags = {}, enableV12TileDefaultIcons = fals
 };
 FeatureFlags$1.propTypes = {
 	children: PropTypes.node,
+	/**
+	* Provide the feature flags to enabled or disabled in the current Rea,ct tree
+	*/
 	flags: deprecate(PropTypes.objectOf(PropTypes.bool), "The `flags` prop for `FeatureFlag` has been deprecated. Please run the `featureflag-deprecate-flags-prop` codemod to migrate to individual boolean props.npx @carbon/upgrade migrate featureflag-deprecate-flags-prop --write"),
 	enableV12TileDefaultIcons: PropTypes.bool,
 	enableV12TileRadioIcons: PropTypes.bool,

package/es/components/FileUploader/FileUploader.Skeleton.js

@@ -8,8 +8,8 @@
 import { usePrefix } from "../../internal/usePrefix.js";
 import SkeletonText_default from "../SkeletonText/index.js";
 import ButtonSkeleton from "../Button/Button.Skeleton.js";
-import "react";
 import classNames from "classnames";
+import "react";
 import PropTypes from "prop-types";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/FileUploader/FileUploader.Skeleton.tsx
@@ -37,6 +37,10 @@ function FileUploaderSkeleton({ className, ...rest }) {
 		]
 	});
 }
-FileUploaderSkeleton.propTypes = { className: PropTypes.string };
+FileUploaderSkeleton.propTypes = { 
+/**
+* Specify an optional className to add.
+*/
+className: PropTypes.string };
 //#endregion
 export { FileUploaderSkeleton as default };

package/es/components/FileUploader/FileUploader.js

@@ -14,8 +14,8 @@ import { useFeatureFlag } from "../FeatureFlags/index.js";
 import { ButtonKinds } from "../Button/Button.js";
 import Filename from "./Filename.js";
 import FileUploaderButton from "./FileUploaderButton.js";
-import React, { forwardRef, useCallback, useImperativeHandle, useState } from "react";
 import classNames from "classnames";
+import React, { forwardRef, useCallback, useImperativeHandle, useState } from "react";
 import PropTypes from "prop-types";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/FileUploader/FileUploader.tsx
@@ -254,26 +254,83 @@ const FileUploader = forwardRef(({ accept, buttonKind, buttonLabel, className, d
 });
 FileUploader.displayName = "FileUploader";
 FileUploader.propTypes = {
+	/**
+	* Specify the types of files that this input should be able to receive
+	*/
 	accept: PropTypes.arrayOf(PropTypes.string),
+	/**
+	* Specify the type of the `<FileUploaderButton>`
+	*/
 	buttonKind: PropTypes.oneOf(ButtonKinds),
+	/**
+	* Provide the label text to be read by screen readers when interacting with
+	* the `<FileUploaderButton>`
+	*/
 	buttonLabel: PropTypes.string,
+	/**
+	* Provide a custom className to be applied to the container node
+	*/
 	className: PropTypes.string,
+	/**
+	* Specify whether file input is disabled
+	*/
 	disabled: PropTypes.bool,
+	/**
+	* Specify the status of the File Upload
+	*/
 	filenameStatus: PropTypes.oneOf([
 		"edit",
 		"complete",
 		"uploading"
 	]).isRequired,
+	/**
+	* Provide a description for the complete/close icon that can be read by screen readers
+	*/
 	iconDescription: PropTypes.string,
+	/**
+	* Specify the description text of this `<FileUploader>`
+	*/
 	labelDescription: PropTypes.string,
+	/**
+	* Specify the title text of this `<FileUploader>`
+	*/
 	labelTitle: PropTypes.string,
+	/**
+	* Maximum file size allowed in bytes. Files larger than this will be marked invalid
+	*/
 	maxFileSize: PropTypes.number,
+	/**
+	* Specify if the component should accept multiple files to upload
+	*/
 	multiple: PropTypes.bool,
+	/**
+	* Provide a name for the underlying `<input>` node
+	*/
 	name: PropTypes.string,
+	/**
+	* Event handler that is called after files are added to the uploader
+	* The event handler signature looks like `onAddFiles(evt, { addedFiles })`
+	*/
 	onAddFiles: PropTypes.func,
+	/**
+	* Provide an optional `onChange` hook that is called each time the input is
+	* changed
+	*/
 	onChange: PropTypes.func,
+	/**
+	* Provide an optional `onClick` hook that is called each time the
+	* FileUploader is clicked
+	*/
 	onClick: PropTypes.func,
+	/**
+	* Provide an optional `onDelete` hook that is called when an uploaded item
+	* is removed
+	*/
 	onDelete: PropTypes.func,
+	/**
+	* Specify the size of the FileUploaderButton, from a list of available
+	* sizes.
+	*/
 	size: PropTypes.oneOf([
 		"sm",
 		"small",

package/es/components/FileUploader/FileUploaderButton.js

@@ -5,15 +5,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { noopFn } from "../../internal/noopFn.js";
 import { usePrefix } from "../../internal/usePrefix.js";
 import { Enter, Space } from "../../internal/keyboard/keys.js";
 import { matches } from "../../internal/keyboard/match.js";
 import { useId } from "../../internal/useId.js";
+import { noopFn } from "../../internal/noopFn.js";
 import { deprecate } from "../../prop-types/deprecate.js";
 import { ButtonKinds } from "../Button/Button.js";
-import { useEffect, useRef, useState } from "react";
 import classNames from "classnames";
+import { useEffect, useRef, useState } from "react";
 import PropTypes from "prop-types";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/FileUploader/FileUploaderButton.tsx
@@ -96,23 +96,70 @@ function FileUploaderButton({ accept, buttonKind = "primary", className, disable
 	] });
 }
 FileUploaderButton.propTypes = {
+	/**
+	* Specify the types of files that this input should be able to receive
+	*/
 	accept: PropTypes.arrayOf(PropTypes.string),
+	/**
+	* Specify the type of underlying button
+	*/
 	buttonKind: PropTypes.oneOf(ButtonKinds),
+	/**
+	* Provide a custom className to be applied to the container node
+	*/
 	className: PropTypes.string,
+	/**
+	* Specify whether you want to disable any updates to the FileUploaderButton
+	* label
+	*/
 	disableLabelChanges: PropTypes.bool,
+	/**
+	* Specify whether file input is disabled
+	*/
 	disabled: PropTypes.bool,
+	/**
+	* Provide a unique id for the underlying `<input>` node
+	*/
 	id: PropTypes.string,
+	/**
+	* Provide the label text to be read by screen readers when interacting with
+	* this control
+	*/
 	labelText: PropTypes.node,
+	/**
+	* Specify if the component should accept multiple files to upload
+	*/
 	multiple: PropTypes.bool,
+	/**
+	* Provide a name for the underlying `<input>` node
+	*/
 	name: PropTypes.string,
+	/**
+	* Provide an optional `onChange` hook that is called each time the `<input>`
+	* value changes
+	*/
 	onChange: PropTypes.func,
+	/**
+	* Provide an optional `onClick` hook that is called each time the button is
+	* clicked
+	*/
 	onClick: PropTypes.func,
+	/**
+	* Provide an accessibility role for the `<FileUploaderButton>`
+	*/
 	role: PropTypes.string,
+	/**
+	* Specify the size of the FileUploaderButton, from a list of available
+	* sizes.
+	*/
 	size: PropTypes.oneOf([
 		"sm",
 		"md",
 		"lg"
 	]),
+	/**
+	* Provide a custom tabIndex value for the `<FileUploaderButton>`
+	*/
 	tabIndex: deprecate(PropTypes.number, "The `tabIndex` prop for `FileUploaderButton` has been deprecated since it now renders a button element by default.")
 };
 //#endregion