@wordpress/components 23.3.5 → 23.5.0

package/build-types/tree-grid/roving-tab-index.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+/**
+ * Provider for adding roving tab index behaviors to tree grid structures.
+ *
+ * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/components/src/tree-grid/README.md
+ */
+export default function RovingTabIndex({ children, }: {
+    children: React.ReactNode;
+}): JSX.Element;
+//# sourceMappingURL=roving-tab-index.d.ts.map

package/build-types/tree-grid/roving-tab-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roving-tab-index.d.ts","sourceRoot":"","sources":["../../src/tree-grid/roving-tab-index.tsx"],"names":[],"mappings":";AAUA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAE,EACvC,QAAQ,GACR,EAAE;IACF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,eAiBA"}

package/build-types/tree-grid/row.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import type { TreeGridRowProps } from './types';
+/**
+ * `TreeGridRow` is used to create a tree hierarchy.
+ * It is not a visually styled component, but instead helps with adding
+ * keyboard navigation and roving tab index behaviors to tree grid structures.
+ *
+ * @see {@link https://www.w3.org/TR/wai-aria-practices/examples/treegrid/treegrid-1.html}
+ */
+export declare const TreeGridRow: import("react").ForwardRefExoticComponent<TreeGridRowProps & Omit<Pick<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement>, "key" | keyof import("react").HTMLAttributes<HTMLTableRowElement>>, "as" | keyof TreeGridRowProps> & import("react").RefAttributes<HTMLTableRowElement>>;
+export default TreeGridRow;
+//# sourceMappingURL=row.d.ts.map

package/build-types/tree-grid/row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.d.ts","sourceRoot":"","sources":["../../src/tree-grid/row.tsx"],"names":[],"mappings":";AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA4BhD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,8UAAuC,CAAC;AAEhE,eAAe,WAAW,CAAC"}

package/build-types/tree-grid/stories/index.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+/**
+ * External dependencies
+ */
+import type { ComponentMeta, ComponentStory } from '@storybook/react';
+/**
+ * Internal dependencies
+ */
+import TreeGrid from '..';
+declare const meta: ComponentMeta<typeof TreeGrid>;
+export default meta;
+export declare const Default: ComponentStory<import("react").ForwardRefExoticComponent<import("../types").TreeGridProps & Omit<Pick<import("react").DetailedHTMLProps<import("react").TableHTMLAttributes<HTMLTableElement>, HTMLTableElement>, "key" | keyof import("react").TableHTMLAttributes<HTMLTableElement>>, "as" | keyof import("../types").TreeGridProps> & import("react").RefAttributes<HTMLTableElement>>>;
+//# sourceMappingURL=index.d.ts.map

package/build-types/tree-grid/stories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tree-grid/stories/index.tsx"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOtE;;GAEG;AACH,OAAO,QAAuC,MAAM,IAAI,CAAC;AAIzD,QAAA,MAAM,IAAI,EAAE,aAAa,CAAE,OAAO,QAAQ,CAWzC,CAAC;AACF,eAAe,IAAI,CAAC;AA+GpB,eAAO,MAAM,OAAO,4XAAsB,CAAC"}

package/build-types/tree-grid/test/cell.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cell.d.ts.map

package/build-types/tree-grid/test/cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell.d.ts","sourceRoot":"","sources":["../../../src/tree-grid/test/cell.tsx"],"names":[],"mappings":""}

package/build-types/tree-grid/test/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build-types/tree-grid/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tree-grid/test/index.tsx"],"names":[],"mappings":""}

package/build-types/tree-grid/test/roving-tab-index-item.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=roving-tab-index-item.d.ts.map

package/build-types/tree-grid/test/roving-tab-index-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roving-tab-index-item.d.ts","sourceRoot":"","sources":["../../../src/tree-grid/test/roving-tab-index-item.tsx"],"names":[],"mappings":""}

package/build-types/tree-grid/test/roving-tab-index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=roving-tab-index.d.ts.map

package/build-types/tree-grid/test/roving-tab-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roving-tab-index.d.ts","sourceRoot":"","sources":["../../../src/tree-grid/test/roving-tab-index.tsx"],"names":[],"mappings":""}

package/build-types/tree-grid/test/row.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=row.d.ts.map

package/build-types/tree-grid/test/row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.d.ts","sourceRoot":"","sources":["../../../src/tree-grid/test/row.tsx"],"names":[],"mappings":""}

package/build-types/tree-grid/types.d.ts

@@ -0,0 +1,109 @@
+/// <reference types="react" />
+export declare type TreeGridRowProps = {
+    /**
+     * The children to be rendered in the row.
+     */
+    children: React.ReactNode;
+    /**
+     * An integer value designating the level in the hierarchical tree structure.
+     * Counting starts at 1. A value of `1` indicates the root level of the structure.
+     */
+    level: NonNullable<React.AriaAttributes['aria-level']>;
+    /**
+     * An integer value that represents the position in the set.
+     * A set is the count of elements at a specific level. Counting starts at 1.
+     */
+    positionInSet: NonNullable<React.AriaAttributes['aria-posinset']>;
+    /**
+     * An integer value that represents the total number of items in the set,
+     * at this specific level of the hierarchy.
+     */
+    setSize: NonNullable<React.AriaAttributes['aria-setsize']>;
+    /**
+     * An optional value that designates whether a row is expanded or collapsed.
+     * Currently this value only sets the correct aria-expanded property on a row,
+     * it has no other built-in behavior.
+     */
+    isExpanded?: boolean;
+};
+declare type RovingTabIndexItemPassThruProps = {
+    ref: React.ForwardedRef<any>;
+    tabIndex?: number;
+    onFocus: React.FocusEventHandler<any>;
+    [key: string]: any;
+};
+export declare type RovingTabIndexItemProps = {
+    /**
+     * A render function that receives the props necessary to make it participate in the
+     * roving tabindex. Any extra props will also be passed through to this function.
+     *
+     * Props passed as an argument to the render prop must be passed to the child
+     * focusable component/element within the cell. If a component is used, it must
+     * correctly handle the `onFocus`, `tabIndex`, and `ref` props, passing these to the
+     * element it renders. These props are used to handle the roving tabindex functionality
+     * of the tree grid.
+     *
+     * ```jsx
+     * <TreeGridCell>
+     * 	{ ( props ) => (
+     * 		<Button onClick={ doSomething } { ...props }>
+     * 			Do something
+     * 		</Button>
+     * 	) }
+     * </TreeGridCell>
+     * ```
+     */
+    children?: (props: RovingTabIndexItemPassThruProps) => JSX.Element;
+    /**
+     * If `children` is not a function, this component will be used instead.
+     */
+    as?: React.ComponentType<RovingTabIndexItemPassThruProps>;
+    [key: string]: any;
+};
+export declare type TreeGridCellProps = ({
+    /**
+     * Render `children` without wrapping it in a `TreeGridItem` component.
+     * This means that `children` will not participate in the roving tabindex.
+     *
+     * @default false
+     */
+    withoutGridItem?: false;
+} & NonNullable<Pick<RovingTabIndexItemProps, 'children'>>) | {
+    children: React.ReactNode;
+    withoutGridItem: true;
+};
+export declare type TreeGridProps = {
+    /**
+     * Label to use for the element with the `application` role.
+     */
+    applicationAriaLabel?: string;
+    /**
+     * The children to be rendered in the tree grid.
+     */
+    children: React.ReactNode;
+    /**
+     * Callback to fire when row is expanded.
+     *
+     * @default noop
+     */
+    onExpandRow?: (row: HTMLElement) => void;
+    /**
+     * Callback to fire when row is collapsed.
+     *
+     * @default noop
+     */
+    onCollapseRow?: (row: HTMLElement) => void;
+    /**
+     * Callback that fires when focus is shifted from one row to another via
+     * the Up and Down keys. Callback is also fired on Home and End keys which
+     * move focus from the beginning row to the end row.
+     *
+     * The callback is passed the event, the start row element that the focus was on
+     * originally, and the destination row element after the focus has moved.
+     *
+     * @default noop
+     */
+    onFocusRow?: (event: React.KeyboardEvent<HTMLTableElement>, startRow: HTMLElement, destinationRow: HTMLElement) => void;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/build-types/tree-grid/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tree-grid/types.ts"],"names":[],"mappings":";AAAA,oBAAY,gBAAgB,GAAG;IAC9B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,KAAK,EAAE,WAAW,CAAE,KAAK,CAAC,cAAc,CAAE,YAAY,CAAE,CAAE,CAAC;IAC3D;;;OAGG;IACH,aAAa,EAAE,WAAW,CAAE,KAAK,CAAC,cAAc,CAAE,eAAe,CAAE,CAAE,CAAC;IACtE;;;OAGG;IACH,OAAO,EAAE,WAAW,CAAE,KAAK,CAAC,cAAc,CAAE,cAAc,CAAE,CAAE,CAAC;IAC/D;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,aAAK,+BAA+B,GAAG;IACtC,GAAG,EAAE,KAAK,CAAC,YAAY,CAAE,GAAG,CAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAE,GAAG,CAAE,CAAC;IACxC,CAAE,GAAG,EAAE,MAAM,GAAI,GAAG,CAAC;CACrB,CAAC;AAEF,oBAAY,uBAAuB,GAAG;IACrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,EAAE,CAAE,KAAK,EAAE,+BAA+B,KAAM,GAAG,CAAC,OAAO,CAAC;IACrE;;OAEG;IACH,EAAE,CAAC,EAAE,KAAK,CAAC,aAAa,CAAE,+BAA+B,CAAE,CAAC;IAC5D,CAAE,GAAG,EAAE,MAAM,GAAI,GAAG,CAAC;CACrB,CAAC;AAEF,oBAAY,iBAAiB,GAC1B,CAAE;IACF;;;;;OAKG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;CACvB,GAAG,WAAW,CAAE,IAAI,CAAE,uBAAuB,EAAE,UAAU,CAAE,CAAE,CAAE,GAChE;IACA,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,eAAe,EAAE,IAAI,CAAC;CACrB,CAAC;AAEL,oBAAY,aAAa,GAAG;IAC3B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAE,GAAG,EAAE,WAAW,KAAM,IAAI,CAAC;IAC3C;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAE,GAAG,EAAE,WAAW,KAAM,IAAI,CAAC;IAC7C;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,CACZ,KAAK,EAAE,KAAK,CAAC,aAAa,CAAE,gBAAgB,CAAE,EAC9C,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,WAAW,KACvB,IAAI,CAAC;CACV,CAAC"}

package/build-types/ui/context/context-connect.d.ts

@@ -8,8 +8,8 @@ declare type AcceptsTwoArgs<F extends (...args: any) => any, ErrorMessage = neve
  * Forwards ref (React.ForwardRef) and "Connects" (or registers) a component
  * within the Context system under a specified namespace.
  *
- * @param  Component The component to register into the Context system.
- * @param  namespace The namespace to register the component under.
+ * @param Component The component to register into the Context system.
+ * @param namespace The namespace to register the component under.
  * @return The connected WordPressComponent
  */
 export declare function contextConnect<C extends (props: any, ref: ForwardedRef<any>) => JSX.Element | null>(Component: C & AcceptsTwoArgs<C, 'Warning: Your component function does not take a ref as the second argument. Did you mean to use `contextConnectWithoutRef`?'>, namespace: string): WordPressComponentFromProps<Parameters<C & AcceptsTwoArgs<C, "Warning: Your component function does not take a ref as the second argument. Did you mean to use `contextConnectWithoutRef`?">>[0], true>;
@@ -17,23 +17,23 @@ export declare function contextConnect<C extends (props: any, ref: ForwardedRef<
  * "Connects" (or registers) a component within the Context system under a specified namespace.
  * Does not forward a ref.
  *
- * @param  Component The component to register into the Context system.
- * @param  namespace The namespace to register the component under.
+ * @param Component The component to register into the Context system.
+ * @param namespace The namespace to register the component under.
  * @return The connected WordPressComponent
  */
 export declare function contextConnectWithoutRef<P>(Component: (props: P) => JSX.Element | null, namespace: string): WordPressComponentFromProps<P, false>;
 /**
  * Attempts to retrieve the connected namespace from a component.
  *
- * @param  Component The component to retrieve a namespace from.
+ * @param Component The component to retrieve a namespace from.
  * @return The connected namespaces.
  */
 export declare function getConnectNamespace(Component: ReactChild | undefined | {}): string[];
 /**
  * Checks to see if a component is connected within the Context system.
  *
- * @param  Component The component to retrieve a namespace from.
- * @param  match     The namespace to check.
+ * @param Component The component to retrieve a namespace from.
+ * @param match     The namespace to check.
  */
 export declare function hasConnectNamespace(Component: ReactNode, match: string[] | string): boolean;
 export {};

package/build-types/ui/context/context-system-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-system-provider.d.ts","sourceRoot":"","sources":["../../../src/ui/context/context-system-provider.js"],"names":[],"mappings":"AAuBA,6EAEE;AACK,4DAAkE;AA0EzE;cAdW,OAAO,OAAO,EAAE,SAAS;;MAExB,WAAW,GAYgD"}
+{"version":3,"file":"context-system-provider.d.ts","sourceRoot":"","sources":["../../../src/ui/context/context-system-provider.js"],"names":[],"mappings":"AAwBA,6EAEE;AACK,4DAAkE;AA4EzE;cAdW,OAAO,OAAO,EAAE,SAAS;;MAExB,WAAW,GAYgD"}

package/build-types/ui/context/get-styled-class-name-from-key.d.ts

@@ -2,7 +2,7 @@ import memoize from 'memize';
 /**
  * Generates the connected component CSS className based on the namespace.
  *
- * @param  namespace The name of the connected component.
+ * @param namespace The name of the connected component.
  * @return The generated CSS className.
  */
 declare function getStyledClassName(namespace: string): string;

package/build-types/ui/utils/get-valid-children.d.ts

@@ -5,7 +5,7 @@ import type { ReactNode, ReactChild, ReactFragment, ReactPortal } from 'react';
 /**
  * Gets a collection of available children elements from a React component's children prop.
  *
- * @param  children
+ * @param children
  *
  * @return An array of available children.
  */

package/build-types/ui/utils/space.d.ts

@@ -17,7 +17,7 @@ export declare type SpaceInput = number | string;
  * When given a unit value or one of the named CSS values like `auto`,
  * it will simply return the value back.
  *
- * @param  value A number, numeric string, or a unit value.
+ * @param value A number, numeric string, or a unit value.
  */
 export declare function space(value?: SpaceInput): string | undefined;
 //# sourceMappingURL=space.d.ts.map

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

@@ -27,7 +27,7 @@ export declare const UnitControl: import("react").ForwardRefExoticComponent<Omit
     value?: string | number | undefined;
     onBlur?: FocusEventHandler<HTMLInputElement | HTMLSelectElement> | undefined;
     onFocus?: FocusEventHandler<HTMLInputElement | HTMLSelectElement> | undefined;
-} & Omit<Pick<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "key" | keyof import("react").InputHTMLAttributes<HTMLInputElement>>, "defaultValue" | "onChange" | "value" | "name" | "color" | "height" | "translate" | "width" | "hidden" | "size" | "style" | "help" | "multiple" | "disabled" | "key" | "children" | "form" | "label" | "slot" | "title" | "pattern" | "as" | "defaultChecked" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "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" | "list" | "__next36pxDefaultSize" | "__unstableInputWidth" | "hideLabelFromVision" | "labelPosition" | "accept" | "alt" | "autoComplete" | "autoFocus" | "capture" | "checked" | "crossOrigin" | "enterKeyHint" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "max" | "maxLength" | "min" | "minLength" | "readOnly" | "required" | "src" | "step" | "dragDirection" | "dragThreshold" | "isDragEnabled" | "isPressEnterToChange" | "onValidate" | "__unstableStateReducer" | "disableUnits" | "hideHTMLArrows" | "isShiftStepEnabled" | "shiftStep" | "unit" | "isUnitSelectTabbable" | "units" | "isResetValueOnUnitChange" | "onUnitChange"> & import("react").RefAttributes<any>>;
+} & Omit<Pick<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "key" | keyof import("react").InputHTMLAttributes<HTMLInputElement>>, "defaultValue" | "onChange" | "value" | "name" | "color" | "height" | "translate" | "width" | "hidden" | "size" | "style" | "help" | "multiple" | "disabled" | "key" | "children" | "form" | "label" | "slot" | "title" | "pattern" | "as" | "defaultChecked" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "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" | "list" | "__next36pxDefaultSize" | "__unstableInputWidth" | "hideLabelFromVision" | "labelPosition" | "accept" | "alt" | "autoComplete" | "autoFocus" | "capture" | "checked" | "crossOrigin" | "enterKeyHint" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "max" | "maxLength" | "min" | "minLength" | "readOnly" | "required" | "src" | "step" | "dragDirection" | "dragThreshold" | "isDragEnabled" | "isPressEnterToChange" | "onValidate" | "__unstableStateReducer" | "hideHTMLArrows" | "isShiftStepEnabled" | "shiftStep" | "disableUnits" | "unit" | "isUnitSelectTabbable" | "units" | "isResetValueOnUnitChange" | "onUnitChange"> & import("react").RefAttributes<any>>;
 export { parseQuantityAndUnitFromRawValue, useCustomUnits } from './utils';
 export default UnitControl;
 //# sourceMappingURL=index.d.ts.map

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

@@ -18,9 +18,9 @@ export declare const DEFAULT_UNIT: WPUnitControlUnit;
  * Moving forward, ideally the value should be a string that contains both
  * the value and unit, example: '10px'
  *
- * @param  rawValue     The raw value as a string (may or may not contain the unit)
- * @param  fallbackUnit The unit used as a fallback, if not unit is detected in the `value`
- * @param  allowedUnits Units to derive from.
+ * @param rawValue     The raw value as a string (may or may not contain the unit)
+ * @param fallbackUnit The unit used as a fallback, if not unit is detected in the `value`
+ * @param allowedUnits Units to derive from.
  * @return The extracted quantity and unit. The quantity can be `undefined` in case the raw value
  * could not be parsed to a number correctly. The unit can be `undefined` in case the unit parse
  * from the raw value could not be matched against the list of allowed units.
@@ -29,7 +29,7 @@ export declare function getParsedQuantityAndUnit(rawValue?: string | number, fal
 /**
  * Checks if units are defined.
  *
- * @param  units List of units.
+ * @param units List of units.
  * @return Whether the list actually contains any units.
  */
 export declare function hasUnits(units?: WPUnitControlUnit[]): units is WPUnitControlUnit[];
@@ -37,8 +37,8 @@ export declare function hasUnits(units?: WPUnitControlUnit[]): units is WPUnitCo
  * Parses a quantity and unit from a raw string value, given a list of allowed
  * units and otherwise falling back to the default unit.
  *
- * @param  rawValue     The raw value as a string (may or may not contain the unit)
- * @param  allowedUnits Units to derive from.
+ * @param rawValue     The raw value as a string (may or may not contain the unit)
+ * @param allowedUnits Units to derive from.
  * @return The extracted quantity and unit. The quantity can be `undefined` in case the raw value
  * could not be parsed to a number correctly. The unit can be `undefined` in case the unit parsed
  * from the raw value could not be matched against the list of allowed units.
@@ -48,10 +48,10 @@ export declare function parseQuantityAndUnitFromRawValue(rawValue?: string | num
  * Parses quantity and unit from a raw value. Validates parsed value, using fallback
  * value if invalid.
  *
- * @param  rawValue         The next value.
- * @param  allowedUnits     Units to derive from.
- * @param  fallbackQuantity The fallback quantity, used in case it's not possible to parse a valid quantity from the raw value.
- * @param  fallbackUnit     The fallback unit, used in case it's not possible to parse a valid unit from the raw value.
+ * @param rawValue         The next value.
+ * @param allowedUnits     Units to derive from.
+ * @param fallbackQuantity The fallback quantity, used in case it's not possible to parse a valid quantity from the raw value.
+ * @param fallbackUnit     The fallback unit, used in case it's not possible to parse a valid unit from the raw value.
  * @return The extracted quantity and unit. The quantity can be `undefined` in case the raw value
  * could not be parsed to a number correctly, and the `fallbackQuantity` was also `undefined`. The
  * unit can be `undefined` only if the unit parsed from the raw value could not be matched against
@@ -63,15 +63,15 @@ export declare function getValidParsedQuantityAndUnit(rawValue: string | number,
  * Takes a unit value and finds the matching accessibility label for the
  * unit abbreviation.
  *
- * @param  unit Unit value (example: `px`)
+ * @param unit Unit value (example: `px`)
  * @return a11y label for the unit abbreviation
  */
 export declare function getAccessibleLabelForUnit(unit: string): string | undefined;
 /**
  * Filters available units based on values defined a list of allowed unit values.
  *
- * @param  allowedUnitValues Collection of allowed unit value strings.
- * @param  availableUnits    Collection of available unit objects.
+ * @param allowedUnitValues Collection of allowed unit value strings.
+ * @param availableUnits    Collection of available unit objects.
  * @return Filtered units.
  */
 export declare function filterUnitsWithSettings(allowedUnitValues: string[] | undefined, availableUnits: WPUnitControlUnit[]): WPUnitControlUnit[];
@@ -80,10 +80,10 @@ export declare function filterUnitsWithSettings(allowedUnitValues: string[] | un
  * TODO: ideally this hook shouldn't be needed
  * https://github.com/WordPress/gutenberg/pull/31822#discussion_r633280823
  *
- * @param  args                An object containing units, settingPath & defaultUnits.
- * @param  args.units          Collection of all potentially available units.
- * @param  args.availableUnits Collection of unit value strings for filtering available units.
- * @param  args.defaultValues  Collection of default values for defined units. Example: `{ px: 350, em: 15 }`.
+ * @param args                An object containing units, settingPath & defaultUnits.
+ * @param args.units          Collection of all potentially available units.
+ * @param args.availableUnits Collection of unit value strings for filtering available units.
+ * @param args.defaultValues  Collection of default values for defined units. Example: `{ px: 350, em: 15 }`.
  *
  * @return Filtered list of units, with their default values updated following the `defaultValues`
  * argument's property.
@@ -101,9 +101,9 @@ export declare const useCustomUnits: ({ units, availableUnits, defaultValues, }:
  * accurately displayed in the UI, even if the intention is to hide
  * the availability of that unit.
  *
- * @param  rawValue   Selected value to parse.
- * @param  legacyUnit Legacy unit value, if rawValue needs it appended.
- * @param  units      List of available units.
+ * @param rawValue   Selected value to parse.
+ * @param legacyUnit Legacy unit value, if rawValue needs it appended.
+ * @param units      List of available units.
  *
  * @return A collection of units containing the unit for the current value.
  */

package/build-types/utils/events.d.ts

@@ -3,8 +3,8 @@ declare type EventHandler<T extends Event> = (event: T) => void;
  * Merges two sets of event handlers together.
  *
  * @template TEvent
- * @param  handlers
- * @param  extraHandlers
+ * @param    handlers
+ * @param    extraHandlers
  */
 export declare function mergeEventHandlers<TEvent extends Event, TLeft extends Record<string, EventHandler<TEvent>>, TRight extends Record<string, EventHandler<TEvent>>>(handlers: TLeft, extraHandlers: TRight): TLeft & TRight;
 export {};

package/build-types/utils/hooks/use-controlled-state.d.ts

@@ -3,7 +3,7 @@ export type Options<T> = {
     /**
      * Initial value
      */
-    initial: T | undefined;
+    initial?: T | undefined;
     /**
      * Fallback value
      */

package/build-types/utils/hooks/use-controlled-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-controlled-state.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/use-controlled-state.js"],"names":[],"mappings":";;;;;aAac,CAAC,GAAG,SAAS;;;;cACb,CAAC,GAAG,EAAE;;AAapB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,kIAFuC,IAAI,EAmC1C"}
+{"version":3,"file":"use-controlled-state.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/use-controlled-state.js"],"names":[],"mappings":";;;;;;;;;cAcc,CAAC,GAAG,EAAE;;AAapB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,kIAFuC,IAAI,EAmC1C"}

package/build-types/utils/hooks/use-controlled-value.d.ts

@@ -7,10 +7,10 @@ declare type Props<T> = {
 /**
  * Simplified and improved implementation of useControlledState.
  *
- * @param  props
- * @param  props.defaultValue
- * @param  props.value
- * @param  props.onChange
+ * @param props
+ * @param props.defaultValue
+ * @param props.value
+ * @param props.onChange
  * @return The controlled value and the value setter.
  */
 export declare function useControlledValue<T>({ defaultValue, onChange, value: valueProp, }: Props<T>): readonly [T | undefined, import("react").Dispatch<import("react").SetStateAction<T | undefined>>];

package/build-types/utils/hooks/use-latest-ref.d.ts

@@ -8,7 +8,7 @@ import type { RefObject } from 'react';
  *
  * @see https://codesandbox.io/s/uselatestref-mlj3i?file=/src/App.tsx
  *
- * @param  value The value to reference
+ * @param value The value to reference
  * @return The prop reference.
  */
 export declare function useLatestRef<T>(value: T): RefObject<T>;

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

@@ -1,7 +1,7 @@
 /**
  * Parses a number and unit from a value.
  *
- * @param  toParse Value to parse
+ * @param toParse Value to parse
  *
  * @return  The extracted number and unit.
  */
@@ -9,8 +9,8 @@ export declare function parseCSSUnitValue(toParse: string): [number | undefined,
 /**
  * Combines a value and a unit into a unit value.
  *
- * @param  value
- * @param  unit
+ * @param value
+ * @param unit
  *
  * @return The unit value.
  */

package/build-types/v-stack/stories/e2e/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * External dependencies
+ */
+import type { ComponentStory, ComponentMeta } from '@storybook/react';
+import { VStack } from '../..';
+declare const meta: ComponentMeta<typeof VStack>;
+export default meta;
+export declare const Default: ComponentStory<typeof VStack>;
+//# sourceMappingURL=index.d.ts.map

package/build-types/v-stack/stories/e2e/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/v-stack/stories/e2e/index.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMtE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,QAAA,MAAM,IAAI,EAAE,aAAa,CAAE,OAAO,MAAM,CAGvC,CAAC;AACF,eAAe,IAAI,CAAC;AAiBpB,eAAO,MAAM,OAAO,EAAE,cAAc,CAAE,OAAO,MAAM,CAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/components",
-	"version": "23.3.5",
+	"version": "23.5.0",
 	"description": "UI components for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -38,33 +38,35 @@
 		"@emotion/utils": "^1.0.0",
 		"@floating-ui/react-dom": "1.0.0",
 		"@use-gesture/react": "^10.2.6",
-		"@wordpress/a11y": "^3.26.1",
-		"@wordpress/compose": "^6.3.3",
-		"@wordpress/date": "^4.26.2",
-		"@wordpress/deprecated": "^3.26.1",
-		"@wordpress/dom": "^3.26.1",
-		"@wordpress/element": "^5.3.2",
-		"@wordpress/escape-html": "^2.26.1",
-		"@wordpress/hooks": "^3.26.1",
-		"@wordpress/html-entities": "^3.26.1",
-		"@wordpress/i18n": "^4.26.1",
-		"@wordpress/icons": "^9.17.2",
-		"@wordpress/is-shallow-equal": "^4.26.1",
-		"@wordpress/keycodes": "^3.26.2",
-		"@wordpress/primitives": "^3.24.2",
-		"@wordpress/private-apis": "^0.8.1",
-		"@wordpress/rich-text": "^6.3.3",
-		"@wordpress/warning": "^2.26.1",
+		"@wordpress/a11y": "^3.28.0",
+		"@wordpress/compose": "^6.5.0",
+		"@wordpress/date": "^4.28.0",
+		"@wordpress/deprecated": "^3.28.0",
+		"@wordpress/dom": "^3.28.0",
+		"@wordpress/element": "^5.5.0",
+		"@wordpress/escape-html": "^2.28.0",
+		"@wordpress/hooks": "^3.28.0",
+		"@wordpress/html-entities": "^3.28.0",
+		"@wordpress/i18n": "^4.28.0",
+		"@wordpress/icons": "^9.19.0",
+		"@wordpress/is-shallow-equal": "^4.28.0",
+		"@wordpress/keycodes": "^3.28.0",
+		"@wordpress/primitives": "^3.26.0",
+		"@wordpress/private-apis": "^0.10.0",
+		"@wordpress/rich-text": "^6.5.0",
+		"@wordpress/warning": "^2.28.0",
 		"change-case": "^4.1.2",
 		"classnames": "^2.3.1",
 		"colord": "^2.7.0",
 		"date-fns": "^2.28.0",
+		"deepmerge": "^4.3.0",
 		"dom-scroll-into-view": "^1.2.1",
 		"downshift": "^6.0.15",
 		"fast-deep-equal": "^3.1.3",
 		"framer-motion": "^7.6.1",
 		"gradient-parser": "^0.1.5",
 		"highlight-words-core": "^1.2.2",
+		"is-plain-object": "^5.0.0",
 		"lodash": "^4.17.21",
 		"memize": "^1.1.0",
 		"path-to-regexp": "^6.2.1",
@@ -83,5 +85,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "35f10c183655e9196d4ea12b8fa499a8ecbb7b6a"
+	"gitHead": "d5e03a74b79e3ca84afda24375474a103a063ee4"
 }

package/src/alignment-matrix-control/utils.tsx

@@ -33,7 +33,7 @@ export const ALIGNMENTS = GRID.flat();
 /**
  * Parses and transforms an incoming value to better match the alignment values
  *
- * @param  value An alignment value to parse.
+ * @param value An alignment value to parse.
  *
  * @return The parsed value.
  */
@@ -46,8 +46,8 @@ export function transformValue( value: AlignmentMatrixControlValue ) {
 /**
  * Creates an item ID based on a prefix ID and an alignment value.
  *
- * @param  prefixId An ID to prefix.
- * @param  value    An alignment value.
+ * @param prefixId An ID to prefix.
+ * @param value    An alignment value.
  *
  * @return The item id.
  */
@@ -63,7 +63,7 @@ export function getItemId(
 /**
  * Retrieves the alignment index from a value.
  *
- * @param  alignment Value to check.
+ * @param alignment Value to check.
  *
  * @return The index of a matching alignment.
  */