@wordpress/components 28.8.6 → 28.10.0

package/build-types/navigator/types.d.ts

@@ -77,7 +77,7 @@ export type NavigatorContext = Navigator & {
     removeScreen: (screen: Screen) => void;
     match?: string;
 };
-export type NavigatorProviderProps = {
+export type NavigatorProps = {
     /**
      * The initial active path.
      */
@@ -90,6 +90,24 @@ export type NavigatorProviderProps = {
 export type NavigatorScreenProps = {
     /**
      * The screen's path, matched against the current path stored in the navigator.
+     *
+     * `Navigator` assumes that screens are organized hierarchically according
+     * to their `path`, which should follow a URL-like scheme where each path
+     * segment starts with and is separated by the `/` character.
+     *
+     * `Navigator` will treat "back" navigations as going to the parent screen —
+     * it is, therefore, the responsibility of the consumer of the component to
+     * create the correct screen hierarchy.
+     *
+     * For example:
+     *  - `/` is the root of all paths. There should always be a screen with
+     *    `path="/"`;
+     *  - `/parent/child` is a child of `/parent`;
+     *  - `/parent/child/grand-child` is a child of `/parent/child`;
+     *  - `/parent/:param` is a child of `/parent` as well;
+     *  - if the current screen has a `path="/parent/child/grand-child"`, when
+     *    going "back" `Navigator` will try to recursively navigate the path
+     *    hierarchy until a matching screen (or the root `/`) is found.
      */
     path: string;
     /**

package/build-types/navigator/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/navigator/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAE,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAE,eAAe,EAAE,QAAQ,CAAE,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IACjD;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAGF,MAAM,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;OAEG;IACH,IAAI,EAAE,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAM,IAAI,CAAC;IAC1D;;;OAGG;IACH,MAAM,EAAE,CAAE,OAAO,CAAC,EAAE,uBAAuB,KAAM,IAAI,CAAC;IACtD;;;;OAIG;IACH,UAAU,EAAE,CAAE,OAAO,CAAC,EAAE,uBAAuB,KAAM,IAAI,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG;IAC1C,SAAS,EAAE,CAAE,MAAM,EAAE,MAAM,KAAM,IAAI,CAAC;IACtC,YAAY,EAAE,CAAE,MAAM,EAAE,MAAM,KAAM,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAE3D,MAAM,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAEpE,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG;IAC7D;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/navigator/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAE,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAE,eAAe,EAAE,QAAQ,CAAE,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IACjD;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAGF,MAAM,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;OAEG;IACH,IAAI,EAAE,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAM,IAAI,CAAC;IAC1D;;;OAGG;IACH,MAAM,EAAE,CAAE,OAAO,CAAC,EAAE,uBAAuB,KAAM,IAAI,CAAC;IACtD;;;;OAIG;IACH,UAAU,EAAE,CAAE,OAAO,CAAC,EAAE,uBAAuB,KAAM,IAAI,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG;IAC1C,SAAS,EAAE,CAAE,MAAM,EAAE,MAAM,KAAM,IAAI,CAAC;IACtC,YAAY,EAAE,CAAE,MAAM,EAAE,MAAM,KAAM,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAE3D,MAAM,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAEpE,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG;IAC7D;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb,CAAC"}

package/build-types/navigator/use-navigator.d.ts

@@ -1,6 +1,9 @@
 import type { Navigator } from './types';
 /**
- * Retrieves a `navigator` instance.
+ * Retrieves a `navigator` instance. This hook provides advanced functionality,
+ * such as imperatively navigating to a new location (with options like
+ * navigating back or skipping focus restoration) and accessing the current
+ * location and path parameters.
  */
 export declare function useNavigator(): Navigator;
 //# sourceMappingURL=use-navigator.d.ts.map

package/build-types/navigator/use-navigator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-navigator.d.ts","sourceRoot":"","sources":["../../src/navigator/use-navigator.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAWxC"}
+{"version":3,"file":"use-navigator.d.ts","sourceRoot":"","sources":["../../src/navigator/use-navigator.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAWxC"}

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

@@ -6,7 +6,7 @@ export declare const Root: import("@emotion/styled").StyledComponent<{
 } & RootProps, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const Wrapper: import("@emotion/styled").StyledComponent<{
     theme?: import("@emotion/react").Theme;
-    as?: React.ElementType;
+    as?: import("react").ElementType;
 } & Pick<import("../../base-control/types").BaseControlProps, "__nextHasNoMarginBottom"> & {
     color?: import("react").CSSProperties["color"];
     marks?: import("../types").RangeMarks;

package/build-types/range-control/styles/range-control-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"range-control-styles.d.ts","sourceRoot":"","sources":["../../../src/range-control/styles/range-control-styles.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACX,cAAc,EAEd,UAAU,EACV,YAAY,EACZ,UAAU,EAEV,iBAAiB,EACjB,MAAM,UAAU,CAAC;AAalB,KAAK,SAAS,GAAG,IAAI,CAAE,iBAAiB,EAAE,uBAAuB,CAAE,CAAC;AACpE,eAAO,MAAM,IAAI;;SATK,MAAO,WAAW;qHAqBvC,CAAC;AAYF,eAAO,MAAM,OAAO;;eAjCS,WAAW;;;;yGA0CvC,CAAC;AAEF,eAAO,MAAM,iBAAiB;;eA5CD,WAAW;2GAiDvC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;eAnDA,WAAW;2GAwDvC,CAAC;AAYF,eAAO,MAAM,IAAI;;eApEY,WAAW;;;;;aAmBnC,CAAC;;;;;2GA8DL,CAAC;AAYF,eAAO,MAAM,KAAK;;eA7FW,WAAW;wHAwGvC,CAAC;AAEF,eAAO,MAAM,YAAY;;eA1GI,WAAW;2GAgHvC,CAAC;AAcF,eAAO,MAAM,IAAI;;eA9HY,WAAW;4HAsIvC,CAAC;AAQF,eAAO,MAAM,SAAS;;eA9IO,WAAW;4HA4JvC,CAAC;AAWF,eAAO,MAAM,YAAY;;eAvKI,WAAW;wHA2LvC,CAAC;AAoBF,eAAO,MAAM,KAAK;;eA/MW,WAAW;wHA2NvC,CAAC;AAEF,eAAO,MAAM,UAAU;;eA7NM,WAAW;kHA0OvC,CAAC;AAsBF,eAAO,MAAM,OAAO;;eAhQS,WAAW;0HAyRvC,CAAC;AAIF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;UAUvB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;eAzSF,WAAW;2GAoTvC,CAAC"}
+{"version":3,"file":"range-control-styles.d.ts","sourceRoot":"","sources":["../../../src/range-control/styles/range-control-styles.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACX,cAAc,EAEd,UAAU,EACV,YAAY,EACZ,UAAU,EAEV,iBAAiB,EACjB,MAAM,UAAU,CAAC;AAalB,KAAK,SAAS,GAAG,IAAI,CAAE,iBAAiB,EAAE,uBAAuB,CAAE,CAAC;AACpE,eAAO,MAAM,IAAI;;SATK,MAAO,WAAW;qHAqBvC,CAAC;AAYF,eAAO,MAAM,OAAO;;;;;;yGAYnB,CAAC;AAEF,eAAO,MAAM,iBAAiB;;eA/CD,WAAW;2GAoDvC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;eAtDA,WAAW;2GA2DvC,CAAC;AAYF,eAAO,MAAM,IAAI;;eAvEY,WAAW;;;;;aAmBnC,CAAC;;;;;2GAiEL,CAAC;AAYF,eAAO,MAAM,KAAK;;eAhGW,WAAW;wHA2GvC,CAAC;AAEF,eAAO,MAAM,YAAY;;eA7GI,WAAW;2GAmHvC,CAAC;AAcF,eAAO,MAAM,IAAI;;eAjIY,WAAW;4HAyIvC,CAAC;AAQF,eAAO,MAAM,SAAS;;eAjJO,WAAW;4HA+JvC,CAAC;AAWF,eAAO,MAAM,YAAY;;eA1KI,WAAW;wHA8LvC,CAAC;AAoBF,eAAO,MAAM,KAAK;;eAlNW,WAAW;wHA8NvC,CAAC;AAEF,eAAO,MAAM,UAAU;;eAhOM,WAAW;kHA6OvC,CAAC;AAiCF,eAAO,MAAM,OAAO;;eA9QS,WAAW;0HAkSvC,CAAC;AAIF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;UAUvB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;eAlTF,WAAW;2GA6TvC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search-control/index.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,SAAS,CAAC;AA2GnE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,aAAa,4KAAyC,CAAC;AAEpE,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search-control/index.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,SAAS,CAAC;AAiHnE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,aAAa,4KAAyC,CAAC;AAEpE,eAAe,aAAa,CAAC"}

package/build-types/search-control/stories/index.story.d.ts

@@ -9,12 +9,4 @@ import SearchControl from '..';
 declare const meta: Meta<typeof SearchControl>;
 export default meta;
 export declare const Default: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, Omit<import("../../context").WordPressComponentProps<import("../types").SearchControlProps, "input", false>, "disabled"> & import("react").RefAttributes<HTMLInputElement>>;
-/**
- * When an `onClose` callback is provided, the search control will render a close button
- * that will trigger the given callback.
- *
- * Use this if you want the button to trigger your own logic to close the search field entirely,
- * rather than just clearing the input value.
- */
-export declare const WithOnClose: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, Omit<import("../../context").WordPressComponentProps<import("../types").SearchControlProps, "input", false>, "disabled"> & import("react").RefAttributes<HTMLInputElement>>;
 //# sourceMappingURL=index.story.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/search-control/stories/index.story.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,kBAAkB,CAAC;AAOtD;;GAEG;AACH,OAAO,aAAa,MAAM,IAAI,CAAC;AAE/B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,aAAa,CAWrC,CAAC;AACF,eAAe,IAAI,CAAC;AAoBpB,eAAO,MAAM,OAAO,mQAAsB,CAAC;AAM3C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,mQAAsB,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/search-control/stories/index.story.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,kBAAkB,CAAC;AAOtD;;GAEG;AACH,OAAO,aAAa,MAAM,IAAI,CAAC;AAE/B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,aAAa,CAWrC,CAAC;AACF,eAAe,IAAI,CAAC;AAoBpB,eAAO,MAAM,OAAO,mQAAsB,CAAC"}

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

@@ -39,6 +39,9 @@ export type SearchControlProps = Pick<InputControlProps, 'help' | 'value'> & {
      *
      * Use this if you want the button to trigger your own logic to close the search field entirely,
      * rather than just clearing the input value.
+     *
+     * @deprecated
+     * @ignore
      */
     onClose?: () => void;
     /** @ignore */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search-control/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAE,GAAG;IAC9E;;;OAGG;IACH,qBAAqB,CAAC,EAAE,iBAAiB,CAAE,uBAAuB,CAAE,CAAC;IACrE;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,iBAAiB,CAAE,qBAAqB,CAAE,CAAC;IACjE;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,CAAE,KAAK,EAAE,MAAM,KAAM,IAAI,CAAC;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAE,QAAQ,CAAE,CAAC;IACvC,cAAc;IACd,WAAW,CAAC,EAAE,iBAAiB,CAAE,aAAa,CAAE,CAAC;IACjD,cAAc;IACd,SAAS,CAAC,EAAE,iBAAiB,CAAE,WAAW,CAAE,CAAC;IAC7C;;;;OAIG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAE,aAAa,CAAE,CAAC;IACjD;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CACjC,kBAAkB,EAClB,OAAO,GAAG,UAAU,GAAG,SAAS,CAChC,GAAG;IACH,SAAS,EAAE,KAAK,CAAC,SAAS,CAAE,gBAAgB,CAAE,CAAC;CAC/C,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search-control/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAE,GAAG;IAC9E;;;OAGG;IACH,qBAAqB,CAAC,EAAE,iBAAiB,CAAE,uBAAuB,CAAE,CAAC;IACrE;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,iBAAiB,CAAE,qBAAqB,CAAE,CAAC;IACjE;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,CAAE,KAAK,EAAE,MAAM,KAAM,IAAI,CAAC;IACpC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAE,QAAQ,CAAE,CAAC;IACvC,cAAc;IACd,WAAW,CAAC,EAAE,iBAAiB,CAAE,aAAa,CAAE,CAAC;IACjD,cAAc;IACd,SAAS,CAAC,EAAE,iBAAiB,CAAE,WAAW,CAAE,CAAC;IAC7C;;;;OAIG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAE,aAAa,CAAE,CAAC;IACjD;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CACjC,kBAAkB,EAClB,OAAO,GAAG,UAAU,GAAG,SAAS,CAChC,GAAG;IACH,SAAS,EAAE,KAAK,CAAC,SAAS,CAAE,gBAAgB,CAAE,CAAC;CAC/C,CAAC"}

package/build-types/select-control/stories/index.story.d.ts

@@ -21,6 +21,13 @@ export declare const WithLabelAndHelpText: import("@storybook/types").AnnotatedS
 export declare const WithCustomChildren: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, import("../../context").WordPressComponentProps<import("../types").SelectControlProps<string>, "select", false> & {
     ref?: React.Ref<HTMLSelectElement>;
 }>;
+/**
+ * By default, the prefix is aligned with the edge of the input border, with no padding.
+ * If you want to apply standard padding in accordance with the size variant, wrap the element in the `<InputControlPrefixWrapper>` component.
+ */
+export declare const WithPrefix: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, import("../../context").WordPressComponentProps<import("../types").SelectControlProps<string>, "select", false> & {
+    ref?: React.Ref<HTMLSelectElement>;
+}>;
 export declare const Minimal: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, import("../../context").WordPressComponentProps<import("../types").SelectControlProps<string>, "select", false> & {
     ref?: React.Ref<HTMLSelectElement>;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/select-control/stories/index.story.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,kBAAkB,CAAC;AAOtD;;GAEG;AACH,OAAO,aAAa,MAAM,KAAK,CAAC;AAEhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,aAAa,CAerC,CAAC;AACF,eAAe,IAAI,CAAC;AAgCpB,eAAO,MAAM,OAAO;UAgDu1D,MAAO,GAAG;EAhD7zD,CAAC;AAWzD,eAAO,MAAM,oBAAoB;gBAqCi1D,GAAG;EArChzD,CAAC;AAOtE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;gBA0Bm1D,GAAG;EA1BlzD,CAAC;AAqBpE,eAAO,MAAM,OAAO;gBAK81D,GAAG;EAL7zD,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/select-control/stories/index.story.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,kBAAkB,CAAC;AAOtD;;GAEG;AACH,OAAO,aAAa,MAAM,KAAK,CAAC;AAGhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,aAAa,CAerC,CAAC;AACF,eAAe,IAAI,CAAC;AAgCpB,eAAO,MAAM,OAAO;UA4DozC,MAAO,GAAG;EA5D1xC,CAAC;AAYzD,eAAO,MAAM,oBAAoB;gBAgD8yC,GAAG;EAhD7wC,CAAC;AAMtE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;gBAsCgzC,GAAG;EAtC/wC,CAAC;AAsBpE;;;GAGG;AACH,eAAO,MAAM,UAAU;gBAYwzC,GAAG;EAZvxC,CAAC;AAM5D,eAAO,MAAM,OAAO;gBAM2zC,GAAG;EAN1xC,CAAC"}

package/build-types/tabs/stories/index.story.d.ts

@@ -1,7 +1,7 @@
 /**
  * External dependencies
  */
-import type { Meta } from '@storybook/react';
+import type { Meta, StoryFn } from '@storybook/react';
 /**
  * Internal dependencies
  */
@@ -9,6 +9,7 @@ import Tabs from '..';
 declare const meta: Meta<typeof Tabs>;
 export default meta;
 export declare const Default: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, import("../types").TabsProps>;
+export declare const SizeAndOverflowPlayground: StoryFn<typeof Tabs>;
 export declare const Vertical: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, import("../types").TabsProps>;
 export declare const DisabledTab: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, import("../types").TabsProps>;
 export declare const WithTabIconsAndTooltips: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, import("../types").TabsProps>;

package/build-types/tabs/stories/index.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/tabs/stories/index.story.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,kBAAkB,CAAC;AAQtD;;GAEG;AACH,OAAO,IAAI,MAAM,IAAI,CAAC;AAOtB,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,IAAI,CAiB5B,CAAC;AACF,eAAe,IAAI,CAAC;AA+BpB,eAAO,MAAM,OAAO,qHAAsB,CAAC;AAc3C,eAAO,MAAM,QAAQ,qHAA8B,CAAC;AAwBpD,eAAO,MAAM,WAAW,qHAAiC,CAAC;AA0C1D,eAAO,MAAM,uBAAuB,qHAEnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,qHAAsB,CAAC;AA0CpD,eAAO,MAAM,aAAa,qHAAmC,CAAC;AA0D9D,eAAO,MAAM,oBAAoB,qHAAiC,CAAC;AA6DnE,eAAO,MAAM,cAAc,qHAAoC,CAAC;AAqChE,eAAO,MAAM,kBAAkB,qHAAwC,CAAC;AAgCxE,eAAO,MAAM,cAAc,qHAAoC,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/tabs/stories/index.story.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQtD;;GAEG;AACH,OAAO,IAAI,MAAM,IAAI,CAAC;AAOtB,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,IAAI,CAiB5B,CAAC;AACF,eAAe,IAAI,CAAC;AA+BpB,eAAO,MAAM,OAAO,qHAAsB,CAAC;AAE3C,eAAO,MAAM,yBAAyB,EAAE,OAAO,CAAE,OAAO,IAAI,CAqG3D,CAAC;AAiBF,eAAO,MAAM,QAAQ,qHAA8B,CAAC;AAwBpD,eAAO,MAAM,WAAW,qHAAiC,CAAC;AA0C1D,eAAO,MAAM,uBAAuB,qHAEnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,qHAAsB,CAAC;AA0CpD,eAAO,MAAM,aAAa,qHAAmC,CAAC;AA0D9D,eAAO,MAAM,oBAAoB,qHAAiC,CAAC;AA6DnE,eAAO,MAAM,cAAc,qHAAoC,CAAC;AAqChE,eAAO,MAAM,kBAAkB,qHAAwC,CAAC;AAgCxE,eAAO,MAAM,cAAc,qHAAoC,CAAC"}

package/build-types/tabs/styles.d.ts

@@ -10,6 +10,13 @@ export declare const Tab: import("@emotion/styled").StyledComponent<Ariakit.TabO
 } & {
     theme?: import("@emotion/react").Theme;
 }, {}, {}>;
+export declare const TabChildren: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {}>;
+export declare const TabChevron: import("@emotion/styled").StyledComponent<import("../icon").Props & {
+    theme?: import("@emotion/react").Theme;
+}, {}, {}>;
 export declare const TabPanel: import("@emotion/styled").StyledComponent<Ariakit.TabPanelOptions<"div"> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
     ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
 }, keyof Ariakit.TabPanelOptions<T>> & {

package/build-types/tabs/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/tabs/styles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAQ1C,eAAO,MAAM,cAAc;;SAaL,MAAO,WACvB;yGA2DL,CAAC;AAEF,eAAO,MAAM,GAAG;;;;;;UAuEf,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;UAapB,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/tabs/styles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAS1C,eAAO,MAAM,cAAc;;SAcrB,MAAO,WAAW;yGAyHvB,CAAC;AAEF,eAAO,MAAM,GAAG;;;;;;UAkFf,CAAC;AAEF,eAAO,MAAM,WAAW;;eA/MX,WAAW;2GAiNvB,CAAC;AAEF,eAAO,MAAM,UAAU;;UAuBtB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;UAapB,CAAC"}

package/build-types/tabs/tab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tab.d.ts","sourceRoot":"","sources":["../../src/tabs/tab.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,eAAO,MAAM,GAAG,8JAuBb,CAAC"}
+{"version":3,"file":"tab.d.ts","sourceRoot":"","sources":["../../src/tabs/tab.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,eAAO,MAAM,GAAG,8JAwBb,CAAC"}

package/build-types/tabs/tablist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tablist.d.ts","sourceRoot":"","sources":["../../src/tabs/tablist.tsx"],"names":[],"mappings":"AAYA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAQ5C,eAAO,MAAM,OAAO,mPAwEjB,CAAC"}
+{"version":3,"file":"tablist.d.ts","sourceRoot":"","sources":["../../src/tabs/tablist.tsx"],"names":[],"mappings":"AAaA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA2C5C,eAAO,MAAM,OAAO,mPAqEjB,CAAC"}

package/build-types/tabs/use-track-overflow.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tracks if an element contains overflow and on which end by tracking the
+ * first and last child elements with an `IntersectionObserver` in relation
+ * to the parent element.
+ *
+ * Note that the returned value will only indicate whether the first or last
+ * element is currently "going out of bounds" but not whether it happens on
+ * the X or Y axis.
+ */
+export declare function useTrackOverflow(parent: HTMLElement | undefined | null, children: {
+    first: HTMLElement | undefined | null;
+    last: HTMLElement | undefined | null;
+}): {
+    first: boolean;
+    last: boolean;
+};
+//# sourceMappingURL=use-track-overflow.d.ts.map

package/build-types/tabs/use-track-overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-track-overflow.d.ts","sourceRoot":"","sources":["../../src/tabs/use-track-overflow.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,EACtC,QAAQ,EAAE;IACT,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC;CACrC;;;EAqDD"}

package/build-types/toggle-group-control/toggle-group-control/as-button-group.d.ts

@@ -1,3 +1,3 @@
-import type { ToggleGroupControlMainControlProps } from '../types';
-export declare const ToggleGroupControlAsButtonGroup: import("react").ForwardRefExoticComponent<ToggleGroupControlMainControlProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "size" | "label" | "children" | "onChange" | "value" | "as" | "isAdaptiveWidth"> & import("react").RefAttributes<HTMLDivElement>>;
+import type { ToggleGroupControlContextProps } from '../types';
+export declare const ToggleGroupControlAsButtonGroup: import("react").ForwardRefExoticComponent<Pick<import("../types").ToggleGroupControlProps, "size" | "label" | "children" | "onChange" | "value" | "isAdaptiveWidth"> & Pick<ToggleGroupControlContextProps, "setSelectedElement"> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "size" | "label" | "children" | "onChange" | "value" | "as" | "isAdaptiveWidth" | "setSelectedElement"> & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=as-button-group.d.ts.map

package/build-types/toggle-group-control/toggle-group-control/as-button-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"as-button-group.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/as-button-group.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACX,kCAAkC,EAElC,MAAM,UAAU,CAAC;AAiElB,eAAO,MAAM,+BAA+B,uUAE3C,CAAC"}
+{"version":3,"file":"as-button-group.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/as-button-group.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEX,8BAA8B,EAC9B,MAAM,UAAU,CAAC;AAyElB,eAAO,MAAM,+BAA+B,mfAE3C,CAAC"}

package/build-types/toggle-group-control/toggle-group-control/as-radio-group.d.ts

@@ -1,3 +1,3 @@
-import type { ToggleGroupControlMainControlProps } from '../types';
-export declare const ToggleGroupControlAsRadioGroup: import("react").ForwardRefExoticComponent<ToggleGroupControlMainControlProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "size" | "label" | "children" | "onChange" | "value" | "as" | "isAdaptiveWidth"> & import("react").RefAttributes<HTMLDivElement>>;
+import type { ToggleGroupControlContextProps } from '../types';
+export declare const ToggleGroupControlAsRadioGroup: import("react").ForwardRefExoticComponent<Pick<import("../types").ToggleGroupControlProps, "size" | "label" | "children" | "onChange" | "value" | "isAdaptiveWidth"> & Pick<ToggleGroupControlContextProps, "setSelectedElement"> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "size" | "label" | "children" | "onChange" | "value" | "as" | "isAdaptiveWidth" | "setSelectedElement"> & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=as-radio-group.d.ts.map

package/build-types/toggle-group-control/toggle-group-control/as-radio-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"as-radio-group.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/as-radio-group.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACX,kCAAkC,EAElC,MAAM,UAAU,CAAC;AAgFlB,eAAO,MAAM,8BAA8B,uUAE1C,CAAC"}
+{"version":3,"file":"as-radio-group.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/as-radio-group.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAEX,8BAA8B,EAC9B,MAAM,UAAU,CAAC;AAkGlB,eAAO,MAAM,8BAA8B,mfAE1C,CAAC"}

package/build-types/toggle-group-control/toggle-group-control/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/component.tsx"],"names":[],"mappings":"AAiGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;8CAG9B,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/component.tsx"],"names":[],"mappings":"AA8GA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;8CAG9B,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/build-types/toggle-group-control/toggle-group-control/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/styles.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,eAAO,MAAM,kBAAkB,uCAI5B,IAAI,CAAE,uBAAuB,EAAE,SAAS,GAAG,gBAAgB,CAAE,GAAG;IAClE,IAAI,EAAE,WAAW,CAAE,uBAAuB,CAAE,MAAM,CAAE,CAAE,CAAC;CACvD,8CAUA,CAAC;AAyBF,eAAO,MAAM,sBAAsB,SAC5B,WAAW,CAAE,uBAAuB,CAAE,MAAM,CAAE,CAAE,8CActD,CAAC;AAEF,eAAO,MAAM,KAAK,2CAGjB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;SAvDF,MACzB,WAAW;yGAyDd,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control/styles.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,eAAO,MAAM,kBAAkB,uCAI5B,IAAI,CAAE,uBAAuB,EAAE,SAAS,GAAG,gBAAgB,CAAE,GAAG;IAClE,IAAI,EAAE,WAAW,CAAE,uBAAuB,CAAE,MAAM,CAAE,CAAE,CAAC;CACvD,8CAmDA,CAAC;AAyBF,eAAO,MAAM,sBAAsB,SAC5B,WAAW,CAAE,uBAAuB,CAAE,MAAM,CAAE,CAAE,8CActD,CAAC;AAEF,eAAO,MAAM,KAAK,2CAGjB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;SAhGF,MACzB,WAAW;yGAkGd,CAAC"}

package/build-types/toggle-group-control/toggle-group-control-option-base/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control-option-base/component.tsx"],"names":[],"mappings":"AAaA;;GAEG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EACX,iCAAiC,EAEjC,MAAM,UAAU,CAAC;AA+JlB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,qCAAqC,2RAG1C,CAAC;AAEF,eAAe,qCAAqC,CAAC"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control-option-base/component.tsx"],"names":[],"mappings":"AAYA;;GAEG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EACX,iCAAiC,EAEjC,MAAM,UAAU,CAAC;AAmJlB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,qCAAqC,2RAG1C,CAAC;AAEF,eAAe,qCAAqC,CAAC"}

package/build-types/toggle-group-control/toggle-group-control-option-base/styles.d.ts

@@ -11,5 +11,4 @@ export declare const ButtonContentView: import("@emotion/styled").StyledComponen
     theme?: import("@emotion/react").Theme;
     as?: React.ElementType;
 }, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
-export declare const backdropView: import("@emotion/utils").SerializedStyles;
 //# sourceMappingURL=styles.d.ts.map

package/build-types/toggle-group-control/toggle-group-control-option-base/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control-option-base/styles.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACX,uBAAuB,EACvB,iCAAiC,EACjC,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,SAAS;;SAgBnB,MAAO,WAAW;yGAXpB,CAAC;AAEF,eAAO,MAAM,UAAU,2CAEtB,CAAC;AAEF,eAAO,MAAM,UAAU,iDAKpB,IAAI,CAAE,uBAAuB,EAAE,gBAAgB,GAAG,MAAM,CAAE,GAC5D,IAAI,CAAE,iCAAiC,EAAE,QAAQ,CAAE,GAAG;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,8CA4CD,CAAC;AAqBF,eAAO,MAAM,iBAAiB;;eApEpB,WAAW;yGAwEpB,CAAC;AAmBF,eAAO,MAAM,YAAY,2CASxB,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/toggle-group-control/toggle-group-control-option-base/styles.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACX,uBAAuB,EACvB,iCAAiC,EACjC,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,SAAS;;SAgBnB,MAAO,WAAW;yGAXpB,CAAC;AAEF,eAAO,MAAM,UAAU,2CAEtB,CAAC;AAEF,eAAO,MAAM,UAAU,iDAKpB,IAAI,CAAE,uBAAuB,EAAE,gBAAgB,GAAG,MAAM,CAAE,GAC5D,IAAI,CAAE,iCAAiC,EAAE,QAAQ,CAAE,GAAG;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,8CA4CD,CAAC;AAqBF,eAAO,MAAM,iBAAiB;;eApEpB,WAAW;yGAwEpB,CAAC"}

package/build-types/toggle-group-control/types.d.ts

@@ -122,6 +122,7 @@ export type ToggleGroupControlContextProps = {
     size: ToggleGroupControlProps['size'];
     value: ToggleGroupControlProps['value'];
     setValue: (newValue: string | number | undefined) => void;
+    setSelectedElement: (element: HTMLElement | undefined) => void;
 };
-export type ToggleGroupControlMainControlProps = Pick<ToggleGroupControlProps, 'children' | 'isAdaptiveWidth' | 'label' | 'size' | 'onChange' | 'value'>;
+export type ToggleGroupControlMainControlProps = Pick<ToggleGroupControlProps, 'children' | 'isAdaptiveWidth' | 'label' | 'size' | 'onChange' | 'value'> & Pick<ToggleGroupControlContextProps, 'setSelectedElement'>;
 //# sourceMappingURL=types.d.ts.map

package/build-types/toggle-group-control/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/toggle-group-control/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,iCAAiC,GAAG;IAC/C,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CACnD,iCAAiC,EACjC,OAAO,CACP,GAAG;IACH;;;OAGG;IACH,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC/C,iCAAiC,EACjC,OAAO,GAAG,aAAa,CACvB,GAAG;IACH;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAE,UAAU,CAAE,CAAC;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACzC,gBAAgB,EAChB,MAAM,GAAG,yBAAyB,CAClC,GAAG;IACH;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAM,IAAI,CAAC;IAC1D;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,kBAAkB,CAAC;IACtC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC5C,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,uBAAuB,CAAE,SAAS,CAAE,CAAC;IAC9C,IAAI,EAAE,uBAAuB,CAAE,MAAM,CAAE,CAAC;IACxC,KAAK,EAAE,uBAAuB,CAAE,OAAO,CAAE,CAAC;IAC1C,QAAQ,EAAE,CAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAM,IAAI,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,IAAI,CACpD,uBAAuB,EACvB,UAAU,GAAG,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CACxE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/toggle-group-control/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,iCAAiC,GAAG;IAC/C,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CACnD,iCAAiC,EACjC,OAAO,CACP,GAAG;IACH;;;OAGG;IACH,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC/C,iCAAiC,EACjC,OAAO,GAAG,aAAa,CACvB,GAAG;IACH;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAE,UAAU,CAAE,CAAC;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACzC,gBAAgB,EAChB,MAAM,GAAG,yBAAyB,CAClC,GAAG;IACH;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAM,IAAI,CAAC;IAC1D;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,kBAAkB,CAAC;IACtC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC5C,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,uBAAuB,CAAE,SAAS,CAAE,CAAC;IAC9C,IAAI,EAAE,uBAAuB,CAAE,MAAM,CAAE,CAAC;IACxC,KAAK,EAAE,uBAAuB,CAAE,OAAO,CAAE,CAAC;IAC1C,QAAQ,EAAE,CAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAM,IAAI,CAAC;IAC5D,kBAAkB,EAAE,CAAE,OAAO,EAAE,WAAW,GAAG,SAAS,KAAM,IAAI,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,IAAI,CACpD,uBAAuB,EACvB,UAAU,GAAG,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CACxE,GACA,IAAI,CAAE,8BAA8B,EAAE,oBAAoB,CAAE,CAAC"}

package/build-types/utils/element-rect.d.ts

@@ -2,6 +2,10 @@
  * The position and dimensions of an element, relative to its offset parent.
  */
 export type ElementOffsetRect = {
+    /**
+     * The element the rect belongs to.
+     */
+    element: HTMLElement | undefined;
     /**
      * The distance from the top edge of the offset parent to the top edge of
      * the element.
@@ -35,6 +39,7 @@ export type ElementOffsetRect = {
  * An `ElementOffsetRect` object with all values set to zero.
  */
 export declare const NULL_ELEMENT_OFFSET_RECT: {
+    element: undefined;
     top: number;
     right: number;
     bottom: number;
@@ -60,6 +65,9 @@ export declare function getElementOffsetRect(element: HTMLElement): ElementOffse
  * Tracks the position and dimensions of an element, relative to its offset
  * parent. The element can be changed dynamically.
  *
+ * When no element is provided (`null` or `undefined`), the hook will return
+ * a "null" rect, in which all values are `0` and `element` is `undefined`.
+ *
  * **Note:** sometimes, the measurement will fail (see `getElementOffsetRect`'s
  * documentation for more details). When that happens, this hook will attempt
  * to measure again after a frame, and if that fails, it will poll every 100

package/build-types/utils/element-rect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-rect.d.ts","sourceRoot":"","sources":["../../src/utils/element-rect.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;CAOR,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,WAAW,GAClB,iBAAiB,GAAG,SAAS,CAmC/B;AAID;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACxC,aAAa,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,qBAoC7C"}
+{"version":3,"file":"element-rect.d.ts","sourceRoot":"","sources":["../../src/utils/element-rect.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;OAEG;IACH,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;CAQR,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,WAAW,GAClB,iBAAiB,GAAG,SAAS,CA8C/B;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACxC,aAAa,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,qBAsC7C"}

package/build-types/utils/hooks/use-animated-offset-rect.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Internal dependencies
+ */
+import type { ElementOffsetRect } from '../element-rect';
+/**
+ * A utility used to animate something in a container component based on the "offset
+ * rect" (position relative to the container and size) of a subelement. For example,
+ * this is useful to render an indicator for the selected option of a component, and
+ * to animate it when the selected option changes.
+ *
+ * Takes in a container element and the up-to-date "offset rect" of the target
+ * subelement, obtained with `useTrackElementOffsetRect`. Then it does the following:
+ *
+ * - Adds CSS variables with rect information to the container, so that the indicator
+ *   can be rendered and animated with them. These are kept up-to-date, enabling CSS
+ *   transitions on change.
+ * - Sets an attribute (`data-subelement-animated` by default) when the tracked
+ *   element changes, so that the target (e.g. the indicator) can be animated to its
+ *   new size and position.
+ * - Removes the attribute when the animation is done.
+ *
+ * The need for the attribute is due to the fact that the rect might update in
+ * situations other than when the tracked element changes, e.g. the tracked element
+ * might be resized. In such cases, there is no need to animate the indicator, and
+ * the change in size or position of the indicator needs to be reflected immediately.
+ */
+export declare function useAnimatedOffsetRect(
+/**
+ * The container element.
+ */
+container: HTMLElement | undefined, 
+/**
+ * The rect of the tracked element.
+ */
+rect: ElementOffsetRect, { prefix, dataAttribute, transitionEndFilter, }?: {
+    /**
+     * The prefix used for the CSS variables, e.g. if `prefix` is `selected`, the
+     * CSS variables will be `--selected-top`, `--selected-left`, etc.
+     * @default 'subelement'
+     */
+    prefix?: string;
+    /**
+     * The name of the data attribute used to indicate that the animation is in
+     * progress. The `data-` prefix is added automatically.
+     *
+     * For example, if `dataAttribute` is `indicator-animated`, the attribute will
+     * be `data-indicator-animated`.
+     * @default `${ prefix }-animated`
+     */
+    dataAttribute?: string;
+    /**
+     * A function that is called with the transition event and returns a boolean
+     * indicating whether the animation should be stopped. The default is a function
+     * that always returns `true`.
+     *
+     * For example, if the animated element is the `::before` pseudo-element, the
+     * function can be written as `( event ) => event.pseudoElement === '::before'`.
+     * @default () => true
+     */
+    transitionEndFilter?: (event: TransitionEvent) => boolean;
+}): void;
+//# sourceMappingURL=use-animated-offset-rect.d.ts.map

package/build-types/utils/hooks/use-animated-offset-rect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-animated-offset-rect.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/use-animated-offset-rect.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB;AACpC;;GAEG;AACH,SAAS,EAAE,WAAW,GAAG,SAAS;AAClC;;GAEG;AACH,IAAI,EAAE,iBAAiB,EACvB,EACC,MAAqB,EACrB,aAAsC,EACtC,mBAAgC,GAChC,GAAE;IACF;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,CAAE,KAAK,EAAE,eAAe,KAAM,OAAO,CAAC;CACvD,QA+BN"}

package/build-types/utils/hooks/use-on-value-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-value-update.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/use-on-value-update.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAE,CAAC,IAAK;IACrC,aAAa,EAAE,CAAC,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAE,CAAC;AAClC;;GAEG;AACH,KAAK,EAAE,CAAC;AACR;;GAEG;AACH,QAAQ,EAAE,CAAE,OAAO,EAAE,kBAAkB,CAAE,CAAC,CAAE,KAAM,IAAI,QAYtD"}
+{"version":3,"file":"use-on-value-update.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/use-on-value-update.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAE,CAAC,IAAK;IACrC,aAAa,EAAE,CAAC,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAE,CAAC;AAClC;;GAEG;AACH,KAAK,EAAE,CAAC;AACR;;GAEG;AACH,QAAQ,EAAE,CAAE,OAAO,EAAE,kBAAkB,CAAE,CAAC,CAAE,KAAM,IAAI,QAYtD"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/components",
-	"version": "28.8.6",
+	"version": "28.10.0",
 	"description": "UI components for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -32,7 +32,7 @@
 	"types": "build-types",
 	"dependencies": {
 		"@ariakit/react": "^0.4.10",
-		"@babel/runtime": "^7.16.0",
+		"@babel/runtime": "7.25.7",
 		"@emotion/cache": "^11.7.1",
 		"@emotion/css": "^11.7.1",
 		"@emotion/react": "^11.7.1",
@@ -43,23 +43,23 @@
 		"@types/gradient-parser": "0.1.3",
 		"@types/highlight-words-core": "1.2.1",
 		"@use-gesture/react": "^10.3.1",
-		"@wordpress/a11y": "^4.8.2",
-		"@wordpress/compose": "^7.8.3",
-		"@wordpress/date": "^5.8.2",
-		"@wordpress/deprecated": "^4.8.2",
-		"@wordpress/dom": "^4.8.2",
-		"@wordpress/element": "^6.8.1",
-		"@wordpress/escape-html": "^3.8.1",
-		"@wordpress/hooks": "^4.8.2",
-		"@wordpress/html-entities": "^4.8.1",
-		"@wordpress/i18n": "^5.8.2",
-		"@wordpress/icons": "^10.8.2",
-		"@wordpress/is-shallow-equal": "^5.8.1",
-		"@wordpress/keycodes": "^4.8.2",
-		"@wordpress/primitives": "^4.8.1",
-		"@wordpress/private-apis": "^1.8.1",
-		"@wordpress/rich-text": "^7.8.3",
-		"@wordpress/warning": "^3.8.1",
+		"@wordpress/a11y": "^4.10.0",
+		"@wordpress/compose": "^7.10.0",
+		"@wordpress/date": "^5.10.0",
+		"@wordpress/deprecated": "^4.10.0",
+		"@wordpress/dom": "^4.10.0",
+		"@wordpress/element": "^6.10.0",
+		"@wordpress/escape-html": "^3.10.0",
+		"@wordpress/hooks": "^4.10.0",
+		"@wordpress/html-entities": "^4.10.0",
+		"@wordpress/i18n": "^5.10.0",
+		"@wordpress/icons": "^10.10.0",
+		"@wordpress/is-shallow-equal": "^5.10.0",
+		"@wordpress/keycodes": "^4.10.0",
+		"@wordpress/primitives": "^4.10.0",
+		"@wordpress/private-apis": "^1.10.0",
+		"@wordpress/rich-text": "^7.10.0",
+		"@wordpress/warning": "^3.10.0",
 		"change-case": "^4.1.2",
 		"clsx": "^2.1.1",
 		"colord": "^2.7.0",
@@ -84,5 +84,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "b7af02f8431034ee19cdc33dd105d21705823eed"
+	"gitHead": "ab34a7ac935fd1478eac63b596242d83270897ee"
 }

package/schemas/docs-manifest.json

@@ -0,0 +1,38 @@
+{
+	"title": "JSON schema for @wordpress/components README manifests",
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"type": "object",
+	"properties": {
+		"displayName": {
+			"type": "string",
+			"description": "The `displayName` of the component, as determined in code. Used to identify the component in the specified source file."
+		},
+		"filePath": {
+			"type": "string",
+			"description": "The file path where the component is located."
+		},
+		"subcomponents": {
+			"type": "array",
+			"description": "List of subcomponents related to the component.",
+			"items": {
+				"type": "object",
+				"properties": {
+					"displayName": {
+						"type": "string",
+						"description": "The `displayName` of the subcomponent, as determined in code. Used to identify the component in the specified source file."
+					},
+					"preferredDisplayName": {
+						"type": "string",
+						"description": "The display name to use in the README, if it is different from the `displayName` as determined in code."
+					},
+					"filePath": {
+						"type": "string",
+						"description": "The file path where the subcomponent is located."
+					}
+				},
+				"required": [ "displayName", "filePath" ]
+			}
+		}
+	},
+	"required": [ "displayName", "filePath" ]
+}