@wordpress/components 19.7.0-next.e230fbab09.0 → 19.8.1

package/build-types/unit-control/index.d.ts

@@ -1,8 +1,11 @@
-/// <reference types="react" />
+/**
+ * External dependencies
+ */
+import type { FocusEventHandler } from 'react';
 import type { UnitControlOnChangeCallback } from './types';
 import type { StateReducer } from '../input-control/reducer/state';
 /**
- * `UnitControl` allows the user to set a value as well as a unit (e.g. `px`).
+ * `UnitControl` allows the user to set a numeric quantity as well as a unit (e.g. `px`).
  *
  *
  * @example
@@ -17,7 +20,7 @@ import type { StateReducer } from '../input-control/reducer/state';
  * };
  * ```
  */
-declare const ForwardedUnitControl: import("react").ForwardRefExoticComponent<Pick<import("./types").UnitSelectControlProps & {
+export declare const UnitControl: import("react").ForwardRefExoticComponent<Pick<Omit<import("./types").UnitSelectControlProps, "unit"> & Pick<import("../input-control/types").InputControlProps, "hideLabelFromVision"> & {
     __unstableStateReducer?: StateReducer | undefined;
     __unstableInputWidth?: import("csstype").Property.Width<string | number> | undefined;
     disableUnits?: boolean | undefined;
@@ -25,10 +28,14 @@ declare const ForwardedUnitControl: import("react").ForwardRefExoticComponent<Pi
     isResetValueOnUnitChange?: boolean | undefined;
     label?: string | undefined;
     onUnitChange?: UnitControlOnChangeCallback | undefined;
+    unit?: string | undefined;
     value?: string | number | undefined;
+    isShiftStepEnabled?: boolean | undefined;
+    shiftStep?: number | undefined;
+    onBlur?: FocusEventHandler<HTMLInputElement | HTMLSelectElement> | undefined;
 } & Omit<Pick<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "key" | keyof import("react").InputHTMLAttributes<HTMLInputElement>> & {
     ref?: ((instance: HTMLInputElement | null) => void) | import("react").RefObject<HTMLInputElement> | null | undefined;
-}, "children" | "value" | "label" | "as" | "__unstableInputWidth" | "isPressEnterToChange" | "__unstableStateReducer" | "disableUnits" | keyof import("./types").UnitSelectControlProps | "isResetValueOnUnitChange" | "onUnitChange">, "type" | "value" | "form" | "label" | "slot" | "style" | "title" | "pattern" | "className" | "color" | "height" | "id" | "lang" | "max" | "min" | "name" | "width" | "role" | "tabIndex" | "crossOrigin" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "css" | "key" | "list" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "placeholder" | "spellCheck" | "translate" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "alt" | "src" | "autoFocus" | "disabled" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "autoComplete" | "accept" | "capture" | "checked" | "enterKeyHint" | "maxLength" | "minLength" | "multiple" | "readOnly" | "required" | "step" | "__unstableInputWidth" | "isPressEnterToChange" | "__unstableStateReducer" | "disableUnits" | keyof import("./types").UnitSelectControlProps | "isResetValueOnUnitChange" | "onUnitChange"> & import("react").RefAttributes<any>>;
+}, "children" | "value" | "label" | "as" | "onBlur" | "onChange" | "size" | "hideLabelFromVision" | "__unstableInputWidth" | "isPressEnterToChange" | "__unstableStateReducer" | "unit" | "isUnitSelectTabbable" | "units" | "disableUnits" | "isShiftStepEnabled" | "shiftStep" | "isResetValueOnUnitChange" | "onUnitChange">, "type" | "value" | "form" | "label" | "slot" | "style" | "title" | "pattern" | "className" | "color" | "height" | "id" | "lang" | "max" | "min" | "name" | "width" | "role" | "tabIndex" | "crossOrigin" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "css" | "key" | "list" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "placeholder" | "spellCheck" | "translate" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "alt" | "src" | "autoFocus" | "disabled" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "autoComplete" | "accept" | "capture" | "checked" | "enterKeyHint" | "maxLength" | "minLength" | "multiple" | "readOnly" | "required" | "size" | "step" | "hideLabelFromVision" | "__unstableInputWidth" | "isPressEnterToChange" | "__unstableStateReducer" | "unit" | "isUnitSelectTabbable" | "units" | "disableUnits" | "isShiftStepEnabled" | "shiftStep" | "isResetValueOnUnitChange" | "onUnitChange"> & import("react").RefAttributes<any>>;
 export { parseQuantityAndUnitFromRawValue, useCustomUnits } from './utils';
-export default ForwardedUnitControl;
+export default UnitControl;
 //# sourceMappingURL=index.d.ts.map

package/build-types/unit-control/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/unit-control/index.tsx"],"names":[],"mappings":";AAmCA,OAAO,KAAK,EAAoB,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AA2NnE;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;;mzKAA4B,CAAC;AAEvD,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC3E,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/unit-control/index.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EACX,iBAAiB,EAMjB,MAAM,OAAO,CAAC;AAyBf,OAAO,KAAK,EAAoB,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AA6PnE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;09KAAuC,CAAC;AAEhE,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC3E,eAAe,WAAW,CAAC"}

package/build-types/unit-control/stories/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * External dependencies
+ */
+import type { ComponentMeta, ComponentStory } from '@storybook/react';
+/**
+ * Internal dependencies
+ */
+import { UnitControl } from '../';
+declare const meta: ComponentMeta<typeof UnitControl>;
+export default meta;
+export declare const Default: ComponentStory<typeof UnitControl>;
+/**
+ * If the `isPressEnterToChange` prop is set to `true`, the `onChange` callback
+ * will not fire while a new value is typed in the input field (you can verify this
+ * behavior by inspecting the console's output).
+ */
+export declare const PressEnterToChange: ComponentStory<typeof UnitControl>;
+/**
+ * Most of `NumberControl`'s props can be passed to `UnitControl`, and they will
+ * affect its numeric input field.
+ */
+export declare const TweakingTheNumberInput: ComponentStory<typeof UnitControl>;
+/**
+ * When only one unit is available, the unit selection dropdown becomes static text.
+ */
+export declare const WithSingleUnit: ComponentStory<typeof UnitControl>;
+/**
+ * It is possible to pass a custom list of units. Every time the unit changes,
+ * if the `isResetValueOnUnitChange` is set to `true`, the input's quantity is
+ * reset to the new unit's default value.
+ */
+export declare const WithCustomUnits: ComponentStory<typeof UnitControl>;
+//# sourceMappingURL=index.d.ts.map

package/build-types/unit-control/stories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unit-control/stories/index.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOtE;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAGlC,QAAA,MAAM,IAAI,EAAE,aAAa,CAAE,OAAO,WAAW,CA8B5C,CAAC;AACF,eAAe,IAAI,CAAC;AAsBpB,eAAO,MAAM,OAAO,EAAE,cAAc,CACnC,OAAO,WAAW,CACW,CAAC;AAK/B;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAC9C,OAAO,WAAW,CACW,CAAC;AAU/B;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAAc,CAClD,OAAO,WAAW,CACW,CAAC;AAS/B;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAC1C,OAAO,WAAW,CACW,CAAC;AAM/B;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAE,OAAO,WAAW,CAkB/D,CAAC"}

package/build-types/unit-control/styles/unit-control-styles.d.ts

@@ -13,7 +13,7 @@ export declare const Root: import("@emotion/styled").StyledComponent<{
 }, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const ValueInput: import("@emotion/styled").StyledComponent<Pick<{
     [x: string]: any;
-    __unstableStateReducer?: ((state: any) => any) | undefined;
+    __unstableStateReducer: any;
     className: any;
     dragDirection?: string | undefined;
     hideHTMLArrows?: boolean | undefined;

package/build-types/unit-control/types.d.ts

@@ -1,12 +1,12 @@
 /**
  * External dependencies
  */
-import type { CSSProperties, SyntheticEvent } from 'react';
+import type { CSSProperties, FocusEventHandler, SyntheticEvent } from 'react';
 /**
  * Internal dependencies
  */
 import type { StateReducer } from '../input-control/reducer/state';
-import type { InputChangeCallback, Size as InputSize } from '../input-control/types';
+import type { InputChangeCallback, InputControlProps, Size as InputSize } from '../input-control/types';
 export declare type SelectSize = InputSize;
 export declare type WPUnitControlUnit = {
     /**
@@ -42,8 +42,6 @@ export declare type UnitSelectControlProps = {
     isUnitSelectTabbable?: boolean;
     /**
      * A callback function invoked when the value is changed.
-     *
-     * @default noop
      */
     onChange?: UnitControlOnChangeCallback;
     /**
@@ -63,7 +61,7 @@ export declare type UnitSelectControlProps = {
      */
     units?: WPUnitControlUnit[];
 };
-export declare type UnitControlProps = UnitSelectControlProps & {
+export declare type UnitControlProps = Omit<UnitSelectControlProps, 'unit'> & Pick<InputControlProps, 'hideLabelFromVision'> & {
     __unstableStateReducer?: StateReducer;
     __unstableInputWidth?: CSSProperties['width'];
     /**
@@ -92,14 +90,37 @@ export declare type UnitControlProps = UnitSelectControlProps & {
     label?: string;
     /**
      * Callback when the `unit` changes.
-     *
-     * @default noop
      */
     onUnitChange?: UnitControlOnChangeCallback;
+    /**
+     * Current unit. _Note: this prop is deprecated. Instead, provide a unit with a value through the `value` prop._
+     *
+     * @deprecated
+     */
+    unit?: string;
     /**
      * Current value. If passed as a string, the current unit will be inferred from this value.
      * For example, a `value` of "50%" will set the current unit to `%`.
      */
     value?: string | number;
+    /**
+     * If true, pressing `UP` or `DOWN` along with the `SHIFT` key will increment
+     * the value by the `shiftStep` value.
+     *
+     * @default true
+     */
+    isShiftStepEnabled?: boolean;
+    /**
+     * Amount to increment by when the `SHIFT` key is held down. This shift value
+     * is a multiplier to the `step` value. For example, if the `step` value is `5`,
+     * and `shiftStep` is `10`, each jump would increment/decrement by `50`.
+     *
+     * @default 10
+     */
+    shiftStep?: number;
+    /**
+     * Callback when either the quantity or the unit inputs lose focus.
+     */
+    onBlur?: FocusEventHandler<HTMLInputElement | HTMLSelectElement>;
 };
 //# sourceMappingURL=types.d.ts.map

package/build-types/unit-control/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/unit-control/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE3D;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EACX,mBAAmB,EACnB,IAAI,IAAI,SAAS,EACjB,MAAM,wBAAwB,CAAC;AAEhC,oBAAY,UAAU,GAAG,SAAS,CAAC;AAEnC,oBAAY,iBAAiB,GAAG;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,oBAAY,2BAA2B,GAAG,mBAAmB,CAC5D,cAAc,CAAE,iBAAiB,GAAG,gBAAgB,CAAE,EACtD;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAC5B,CAAC;AAEF,oBAAY,sBAAsB,GAAG;IACpC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAGF,oBAAY,gBAAgB,GAAG,sBAAsB,GAAG;IACvD,sBAAsB,CAAC,EAAE,YAAY,CAAC;IACtC,oBAAoB,CAAC,EAAE,aAAa,CAAE,OAAO,CAAE,CAAC;IAChD;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,2BAA2B,CAAC;IAC3C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/unit-control/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE9E;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EACX,mBAAmB,EACnB,iBAAiB,EACjB,IAAI,IAAI,SAAS,EACjB,MAAM,wBAAwB,CAAC;AAEhC,oBAAY,UAAU,GAAG,SAAS,CAAC;AAEnC,oBAAY,iBAAiB,GAAG;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,oBAAY,2BAA2B,GAAG,mBAAmB,CAC5D,cAAc,CAAE,iBAAiB,GAAG,gBAAgB,CAAE,EACtD;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAC5B,CAAC;AAEF,oBAAY,sBAAsB,GAAG;IACpC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAGF,oBAAY,gBAAgB,GAAG,IAAI,CAAE,sBAAsB,EAAE,MAAM,CAAE,GACpE,IAAI,CAAE,iBAAiB,EAAE,qBAAqB,CAAE,GAAG;IAClD,sBAAsB,CAAC,EAAE,YAAY,CAAC;IACtC,oBAAoB,CAAC,EAAE,aAAa,CAAE,OAAO,CAAE,CAAC;IAChD;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,YAAY,CAAC,EAAE,2BAA2B,CAAC;IAC3C;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAE,gBAAgB,GAAG,iBAAiB,CAAE,CAAC;CACnE,CAAC"}

package/build-types/unit-control/unit-select-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unit-select-control.d.ts","sourceRoot":"","sources":["../../src/unit-control/unit-select-control.tsx"],"names":[],"mappings":";AAOA;;GAEG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAE,EAC1C,SAAS,EACT,oBAAoB,EAAE,UAAiB,EACvC,QAAe,EACf,IAAgB,EAChB,IAAW,EACX,KAAiB,EACjB,GAAG,KAAK,EACR,EAAE,uBAAuB,CAAE,sBAAsB,EAAE,QAAQ,EAAE,KAAK,CAAE,eAqCpE"}
+{"version":3,"file":"unit-select-control.d.ts","sourceRoot":"","sources":["../../src/unit-control/unit-select-control.tsx"],"names":[],"mappings":";AAMA;;GAEG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAE,EAC1C,SAAS,EACT,oBAAoB,EAAE,UAAiB,EACvC,QAAQ,EACR,IAAgB,EAChB,IAAW,EACX,KAAiB,EACjB,GAAG,KAAK,EACR,EAAE,uBAAuB,CAAE,sBAAsB,EAAE,QAAQ,EAAE,KAAK,CAAE,eAqCpE"}

package/build-types/utils/colors-values.d.ts

@@ -141,8 +141,11 @@ export namespace UI {
     import textLight = BASE.black;
     export { textLight };
 }
-export namespace COLORS {
-    const darkGray_1: {
+export const COLORS: {
+    black: string;
+    white: string;
+} & {
+    darkGray: {
         900: string;
         800: string;
         700: string;
@@ -158,14 +161,42 @@ export namespace COLORS {
         primary: string;
         heading: string;
     };
-    export { darkGray_1 as darkGray };
-    export { DARK_OPACITY as darkOpacity };
-    export { DARK_OPACITY_LIGHT as darkOpacityLight };
-    import mediumGray_1 = G2.mediumGray;
-    export { mediumGray_1 as mediumGray };
-    import gray_1 = G2.gray;
-    export { gray_1 as gray };
-    const lightGray_1: {
+    darkOpacity: {
+        900: string;
+        800: string;
+        700: string;
+        600: string;
+        500: string;
+        400: string;
+        300: string;
+        200: string;
+        100: string;
+        backgroundFill: string;
+    };
+    darkOpacityLight: {
+        900: string;
+        800: string;
+        700: string;
+        600: string;
+        500: string;
+        400: string;
+        300: string;
+        200: string;
+        100: string;
+    };
+    mediumGray: {
+        text: string;
+    };
+    gray: {
+        900: string;
+        700: string;
+        600: string;
+        400: string;
+        300: string;
+        200: string;
+        100: string;
+    };
+    lightGray: {
         900: string;
         800: string;
         700: string;
@@ -181,9 +212,19 @@ export namespace COLORS {
         secondary: string;
         tertiary: string;
     };
-    export { lightGray_1 as lightGray };
-    export { LIGHT_OPACITY_LIGHT as lightGrayLight };
-    const blue_1: {
+    lightGrayLight: {
+        900: string;
+        800: string;
+        700: string;
+        600: string;
+        500: string;
+        400: string;
+        300: string;
+        200: string;
+        100: string;
+        backgroundFill: string;
+    };
+    blue: {
         wordpress: {
             700: string;
         };
@@ -209,10 +250,29 @@ export namespace COLORS {
             focusDark: string;
         };
     };
-    export { blue_1 as blue };
-    export { ALERT as alert };
-    export { ADMIN as admin };
-    export { UI as ui };
-}
+    alert: {
+        yellow: string;
+        red: string;
+        green: string;
+    };
+    admin: {
+        theme: string;
+        themeDark10: string;
+    };
+    ui: {
+        theme: string;
+        background: string;
+        backgroundDisabled: string;
+        border: string;
+        borderHover: string;
+        borderFocus: string;
+        borderDisabled: string;
+        borderLight: string;
+        label: string;
+        textDisabled: string;
+        textDark: string;
+        textLight: string;
+    };
+};
 export default COLORS;
 //# sourceMappingURL=colors-values.d.ts.map

package/build-types/utils/colors-values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colors-values.d.ts","sourceRoot":"","sources":["../../src/utils/colors-values.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA;;;;;;;;;;;;EAYE;AAEF;;;;;;;;;;;EAWE;AAEF;;;;;;;;;;EAUE;AAEF;;;;;;;;;;;EAWE;AAEF;;;;;;;;;;;EAWE"}
+{"version":3,"file":"colors-values.d.ts","sourceRoot":"","sources":["../../src/utils/colors-values.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA;;;;;;;;;;;;EAYE;AAEF;;;;;;;;;;;EAWE;AAEF;;;;;;;;;;EAUE;AAEF;;;;;;;;;;;EAWE;AAEF;;;;;;;;;;;EAWE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYI"}

package/build-types/utils/config-values.d.ts

@@ -1,73 +1,73 @@
-declare namespace _default {
-    export const colorDivider: string;
-    export const colorScrollbarThumb: string;
-    export const colorScrollbarThumbHover: string;
-    export const colorScrollbarTrack: string;
-    export const elevationIntensity: number;
-    export const radiusBlockUi: string;
-    export const borderWidth: string;
-    export const borderWidthFocus: string;
-    export const borderWidthTab: string;
-    export const spinnerSize: number;
-    export const fontSize: string;
-    export const fontSizeH1: string;
-    export const fontSizeH2: string;
-    export const fontSizeH3: string;
-    export const fontSizeH4: string;
-    export const fontSizeH5: string;
-    export const fontSizeH6: string;
-    export const fontSizeInputMobile: string;
-    export const fontSizeMobile: string;
-    export const fontSizeSmall: string;
-    export const fontSizeXSmall: string;
-    export const fontLineHeightBase: string;
-    export const fontWeight: string;
-    export const fontWeightHeading: string;
-    export const gridBase: string;
-    export const cardBorderRadius: string;
-    export const cardPaddingXSmall: string;
-    export const cardPaddingSmall: string;
-    export const cardPaddingMedium: string;
-    export const cardPaddingLarge: string;
-    export const surfaceBackgroundColor: string;
-    export const surfaceBackgroundSubtleColor: string;
-    export const surfaceBackgroundTintColor: string;
-    export const surfaceBorderColor: string;
-    export const surfaceBorderBoldColor: string;
-    export const surfaceBorderSubtleColor: string;
-    export const surfaceBackgroundTertiaryColor: string;
-    export const surfaceColor: string;
-    export const transitionDuration: string;
-    export const transitionDurationFast: string;
-    export const transitionDurationFaster: string;
-    export const transitionDurationFastest: string;
-    export const transitionTimingFunction: string;
-    export const transitionTimingFunctionControl: string;
-    import toggleGroupControlBackgroundColor = controlBackgroundColor;
-    export { toggleGroupControlBackgroundColor };
-    export const toggleGroupControlBorderColor: string;
-    import toggleGroupControlButtonColorActive = controlBackgroundColor;
-    export { toggleGroupControlButtonColorActive };
-    export const controlSurfaceColor: string;
-    export const controlTextActiveColor: string;
-    export { CONTROL_PADDING_X as controlPaddingX };
-    export const controlPaddingXLarge: string;
-    export const controlPaddingXSmall: string;
-    export const controlBackgroundColor: string;
-    export const controlBorderRadius: string;
-    export const controlBorderColor: string;
-    export const controlBoxShadow: string;
-    export const controlBorderColorHover: string;
-    export const controlBoxShadowFocus: string;
-    export const controlDestructiveBorderColor: string;
-    export { CONTROL_HEIGHT as controlHeight };
-    export const controlHeightXSmall: string;
-    export const controlHeightSmall: string;
-    export const controlHeightLarge: string;
-    export const controlHeightXLarge: string;
-}
+declare var _default: {
+    controlSurfaceColor: string;
+    controlTextActiveColor: string;
+    controlPaddingX: string;
+    controlPaddingXLarge: string;
+    controlPaddingXSmall: string;
+    controlBackgroundColor: string;
+    controlBorderRadius: string;
+    controlBorderColor: string;
+    controlBoxShadow: string;
+    controlBorderColorHover: string;
+    controlBoxShadowFocus: string;
+    controlDestructiveBorderColor: string;
+    controlHeight: string;
+    controlHeightXSmall: string;
+    controlHeightSmall: string;
+    controlHeightLarge: string;
+    controlHeightXLarge: string;
+} & {
+    toggleGroupControlBackgroundColor: string;
+    toggleGroupControlBorderColor: string;
+    toggleGroupControlBackdropBackgroundColor: string;
+    toggleGroupControlBackdropBorderColor: string;
+    toggleGroupControlBackdropBoxShadow: string;
+    toggleGroupControlButtonColorActive: string;
+} & {
+    colorDivider: string;
+    colorScrollbarThumb: string;
+    colorScrollbarThumbHover: string;
+    colorScrollbarTrack: string;
+    elevationIntensity: number;
+    radiusBlockUi: string;
+    borderWidth: string;
+    borderWidthFocus: string;
+    borderWidthTab: string;
+    spinnerSize: number;
+    fontSize: string;
+    fontSizeH1: string;
+    fontSizeH2: string;
+    fontSizeH3: string;
+    fontSizeH4: string;
+    fontSizeH5: string;
+    fontSizeH6: string;
+    fontSizeInputMobile: string;
+    fontSizeMobile: string;
+    fontSizeSmall: string;
+    fontSizeXSmall: string;
+    fontLineHeightBase: string;
+    fontWeight: string;
+    fontWeightHeading: string;
+    gridBase: string;
+    cardBorderRadius: string;
+    cardPaddingXSmall: string;
+    cardPaddingSmall: string;
+    cardPaddingMedium: string;
+    cardPaddingLarge: string;
+    surfaceBackgroundColor: string;
+    surfaceBackgroundSubtleColor: string;
+    surfaceBackgroundTintColor: string;
+    surfaceBorderColor: string;
+    surfaceBorderBoldColor: string;
+    surfaceBorderSubtleColor: string;
+    surfaceBackgroundTertiaryColor: string;
+    surfaceColor: string;
+    transitionDuration: string;
+    transitionDurationFast: string;
+    transitionDurationFaster: string;
+    transitionDurationFastest: string;
+    transitionTimingFunction: string;
+    transitionTimingFunctionControl: string;
+};
 export default _default;
-declare namespace CONTROL_PROPS { }
-declare const CONTROL_PADDING_X: "12px";
-declare const CONTROL_HEIGHT: "36px";
 //# sourceMappingURL=config-values.d.ts.map

package/build-types/utils/config-values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-values.d.ts","sourceRoot":"","sources":["../../src/utils/config-values.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,wCAAiC;AADjC,qCAA8B"}
+{"version":3,"file":"config-values.d.ts","sourceRoot":"","sources":["../../src/utils/config-values.js"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/components",
-	"version": "19.7.0-next.e230fbab09.0",
+	"version": "19.8.1",
 	"description": "UI components for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -37,21 +37,21 @@
 		"@emotion/styled": "^11.6.0",
 		"@emotion/utils": "1.0.0",
 		"@use-gesture/react": "^10.2.6",
-		"@wordpress/a11y": "^3.4.0-next.e230fbab09.0",
-		"@wordpress/compose": "^5.2.0-next.e230fbab09.0",
-		"@wordpress/date": "^4.4.0-next.e230fbab09.0",
-		"@wordpress/deprecated": "^3.4.0-next.e230fbab09.0",
-		"@wordpress/dom": "^3.4.0-next.e230fbab09.0",
-		"@wordpress/element": "^4.3.0-next.e230fbab09.0",
-		"@wordpress/escape-html": "^2.4.0-next.e230fbab09.0",
-		"@wordpress/hooks": "^3.4.0-next.e230fbab09.0",
-		"@wordpress/i18n": "^4.4.0-next.e230fbab09.0",
-		"@wordpress/icons": "^7.1.0-next.e230fbab09.0",
-		"@wordpress/is-shallow-equal": "^4.4.0-next.e230fbab09.0",
-		"@wordpress/keycodes": "^3.4.0-next.e230fbab09.0",
-		"@wordpress/primitives": "^3.2.0-next.e230fbab09.0",
-		"@wordpress/rich-text": "^5.2.0-next.e230fbab09.0",
-		"@wordpress/warning": "^2.4.0-next.e230fbab09.0",
+		"@wordpress/a11y": "^3.6.1",
+		"@wordpress/compose": "^5.4.1",
+		"@wordpress/date": "^4.6.1",
+		"@wordpress/deprecated": "^3.6.1",
+		"@wordpress/dom": "^3.6.1",
+		"@wordpress/element": "^4.4.1",
+		"@wordpress/escape-html": "^2.6.1",
+		"@wordpress/hooks": "^3.6.1",
+		"@wordpress/i18n": "^4.6.1",
+		"@wordpress/icons": "^8.2.1",
+		"@wordpress/is-shallow-equal": "^4.6.1",
+		"@wordpress/keycodes": "^3.6.1",
+		"@wordpress/primitives": "^3.4.1",
+		"@wordpress/rich-text": "^5.4.1",
+		"@wordpress/warning": "^2.6.1",
 		"classnames": "^2.3.1",
 		"colord": "^2.7.0",
 		"dom-scroll-into-view": "^1.2.1",
@@ -76,5 +76,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "308df03e6a96ded732f9c4e32471b1b4f8dea54a"
+	"gitHead": "446565ecaa40370173c18926535e975ec5652b71"
 }

package/src/animate/README.md

@@ -5,7 +5,7 @@ Simple interface to introduce animations to components.
 ## Usage
 
 ```jsx
-import { Animate } from '@wordpress/components';
+import { Animate, Notice } from '@wordpress/components';
 
 const MyAnimatedNotice = () => (
 	<Animate type="slide-in" options={ { origin: 'top' } }>

package/src/base-control/README.md

@@ -1,16 +1,17 @@
 # BaseControl
 
-BaseControl component is used to generate labels and help text for components handling user inputs.
+`BaseControl` is a component used to generate labels and help text for components handling user inputs.
 
 ## Usage
 
-Render a BaseControl for a textarea input:
+Render a `BaseControl` for a textarea input:
 
 ```jsx
 import { BaseControl } from '@wordpress/components';
 
+// The `id` prop is necessary to accessibly associate the label with the textarea
 const MyBaseControl = () => (
-	<BaseControl id="textarea-1" label="Text" help="Enter some text">
+	<BaseControl id="textarea-1" label="Text" help="Enter some text" __nextHasNoMarginBottom={ true }>
 		<textarea id="textarea-1" />
 	</BaseControl>
 );
@@ -22,10 +23,10 @@ The component accepts the following props:
 
 ### id
 
-The id of the element to which labels and help text are being generated. That element should be passed as a child.
+The HTML `id` of the element (passed in as a child to `BaseControl`) to which labels and help text are being generated. This is necessary to accessibly associate the label with that element.
 
 -   Type: `String`
--   Required: Yes
+-   Required: No
 
 ### label
 
@@ -50,8 +51,7 @@ If this property is added, a help text will be generated using help property as
 
 ### className
 
-The class that will be added with "components-base-control" to the classes of the wrapper div.
-If no className is passed only components-base-control is used.
+Any other classes to add to the wrapper div.
 
 -   Type: `String`
 -   Required: No
@@ -63,10 +63,19 @@ The content to be displayed within the BaseControl.
 -   Type: `Element`
 -   Required: Yes
 
+### __nextHasNoMarginBottom
+
+Start opting into the new margin-free styles that will become the default in a future version.
+
+-   Type: `Boolean`
+-   Required: No
+-   Default: `false`
+
 ## BaseControl.VisualLabel
 
-`BaseControl.VisualLabel` component is used to render a purely visual label inside a `BaseControl` component.
-It should only be used in cases where the children being rendered inside BaseControl are already properly labeled, e.g., a button, but we want an additional visual label for that section equivalent to the labels BaseControl would otherwise use if the label prop was passed.
+`BaseControl.VisualLabel` is used to render a purely visual label inside a `BaseControl` component.
+
+It should only be used in cases where the children being rendered inside BaseControl are already accessibly labeled, e.g., a button, but we want an additional visual label for that section equivalent to the labels `BaseControl` would otherwise use if the `label` prop was passed.
 
 ## Usage
 
@@ -74,7 +83,7 @@ It should only be used in cases where the children being rendered inside BaseCon
 import { BaseControl } from '@wordpress/components';
 
 const MyBaseControl = () => (
-	<BaseControl help="Pressing the Select an author button will open a modal that allows an advanced mechanism for author selection">
+	<BaseControl help="This button is already accessibly labeled.">
 		<BaseControl.VisualLabel>Author</BaseControl.VisualLabel>
 		<Button>Select an author</Button>
 	</BaseControl>
@@ -85,8 +94,7 @@ const MyBaseControl = () => (
 
 #### className
 
-The class that will be added with `components-base-control__label` to the classes of the wrapper div.
-If no className is passed only `components-base-control__label` is used.
+Any other classes to add to the wrapper div.
 
 -   Type: `String`
 -   Required: No