@wordpress/components 35.0.0 → 35.0.1

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

@@ -0,0 +1,55 @@
+export declare const NavigationUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const MenuUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const MenuBackButtonUI: import("@emotion/styled").StyledComponent<((import("../../button/types").ButtonProps & import("../../button/types").DeprecatedButtonProps) & import("react").RefAttributes<any>) & {
+    theme?: import("@emotion/react").Theme;
+}, {}, {}>;
+export declare const MenuTitleUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const MenuTitleSearchControlWrapper: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const MenuTitleActionsUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {}>;
+export declare const GroupTitleUI: import("@emotion/styled").StyledComponent<Omit<import("../../text/types").Props, "color" | "isBlock" | "weight"> & {
+    level?: import("../../heading/types").HeadingSize;
+    isBlock?: import("../../text/types").Props['isBlock'];
+    color?: import("../../text/types").Props['color'];
+    weight?: import("../../text/types").Props['weight'];
+} & import("react").RefAttributes<any> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, "ref">, "adjustLineHeightForInnerControls" | "align" | "as" | "children" | "color" | "display" | "ellipsis" | "ellipsizeMode" | "highlightCaseSensitive" | "highlightEscape" | "highlightSanitize" | "highlightWords" | "isBlock" | "isDestructive" | "letterSpacing" | "level" | "limit" | "lineHeight" | "numberOfLines" | "optimizeReadabilityFor" | "size" | "truncate" | "upperCase" | "variant" | "weight" | keyof import("react").RefAttributes<any>> & {
+    as?: keyof import("react").JSX.IntrinsicElements | undefined;
+} & {
+    theme?: import("@emotion/react").Theme;
+}, {}, {}>;
+export declare const ItemBaseUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, {}>;
+export declare const ItemUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const ItemIconUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {}>;
+export declare const ItemBadgeUI: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {}>;
+export declare const ItemTitleUI: import("@emotion/styled").StyledComponent<import("../../text/types").Props & import("react").RefAttributes<any> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref">, "as" | keyof import("../../text/types").Props | keyof import("react").RefAttributes<any>> & {
+    as?: keyof import("react").JSX.IntrinsicElements | undefined;
+} & {
+    theme?: import("@emotion/react").Theme;
+}, {}, {}>;
+//# sourceMappingURL=navigation-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-styles.d.ts","sourceRoot":"","sources":["../../../src/navigation/styles/navigation-styles.tsx"],"names":[],"mappings":"AAoBA,eAAO,MAAM,YAAY;;;yGAKxB,CAAC;AAEF,eAAO,MAAM,MAAM;;;yGAiBlB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;UAiB5B,CAAC;AAEF,eAAO,MAAM,WAAW;;;yGAGvB,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;yGAGzC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;2GAoB9B,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;UAaxB,CAAC;AAEF,eAAO,MAAM,UAAU;;;yGAqCtB,CAAC;AAEF,eAAO,MAAM,MAAM;;;yGAYlB,CAAC;AAEF,eAAO,MAAM,UAAU;;;2GAGtB,CAAC;AAEF,eAAO,MAAM,WAAW;;;2GAmBvB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;UAKvB,CAAC"}

package/build-types/navigation/test/index.d.ts

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

package/build-types/navigation/test/index.d.ts.map

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

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

@@ -0,0 +1,266 @@
+/**
+ * Internal dependencies
+ */
+import type { ButtonProps } from '../button/types';
+type IfDiscriminantDefinedBothRequired<TDiscriminant, TOther> = {
+    [K in keyof (TDiscriminant & TOther)]: NonNullable<(TDiscriminant & TOther)[K]>;
+} | ({
+    [K in keyof TDiscriminant]?: never;
+} & {
+    [K in keyof TOther]?: TOther[K];
+});
+export type NavigationProps = {
+    /**
+     * The active item slug.
+     */
+    activeItem?: string;
+    /**
+     * The active menu slug.
+     *
+     * @default 'root'
+     */
+    activeMenu?: string;
+    /**
+     * The children components.
+     */
+    children?: React.ReactNode;
+    /**
+     * Optional classname for the component.
+     */
+    className?: string;
+    /**
+     * Callback used to sync the active menu between the external state
+     * and the Navigation's internal state.
+     */
+    onActivateMenu?: (activeMenuSlug: string) => void;
+};
+type _NavigationMenuSearchProps = IfDiscriminantDefinedBothRequired<{
+    /**
+     * When the `hasSearch` prop is `true`, this callback handles the search
+     * input's `onChange` event, making it controlled from the outside.
+     * When using this prop, the `search` prop should be also set.
+     */
+    onSearch: (searchString: string) => void;
+}, {
+    /**
+     * When the `hasSearch` is `true` and the `onSearch` prop is provided, this
+     * prop controls the value of the search input.
+     * Required when the `onSearch` prop is provided.
+     */
+    search: string;
+}>;
+export type NavigationMenuProps = _NavigationMenuSearchProps & {
+    /**
+     * The back button label used in nested menus.
+     * If not provided, the label will be inferred from the parent menu's title.
+     * If the parent menu's title is not available then it will default to "Back".
+     *
+     * @default parentMenuTitle ?? 'Back'
+     */
+    backButtonLabel?: string;
+    /**
+     * A callback to handle clicking on the back button.
+     * If this prop is provided then the back button will be shown.
+     */
+    onBackButtonClick?: React.MouseEventHandler<HTMLElement>;
+    /**
+     * The children components.
+     */
+    children?: React.ReactNode;
+    /**
+     * Optional classname for the component.
+     */
+    className?: string;
+    /**
+     * When `true`, enables the search feature on the menu title.
+     */
+    hasSearch?: boolean;
+    /**
+     * Indicates whether the menu is empty or not. Used together with the
+     * `hideIfTargetMenuEmpty` prop of `NavigationItem`.
+     */
+    isEmpty?: boolean;
+    /**
+     * Indicates whether the search is debouncing or not. In case of `true`, the
+     * "No results found." text is omitted. Used to prevent showing the
+     * "No results found." text between debounced searches.
+     */
+    isSearchDebouncing?: boolean;
+    /**
+     * The unique identifier of the menu.
+     * The root menu can omit this prop, and it will default to "root".
+     * All other menus need to specify it.
+     *
+     * @default 'root'
+     */
+    menu?: string;
+    /**
+     * The parent menu slug; used by nested menus to indicate their parent menu.
+     */
+    parentMenu?: string;
+    /**
+     * The menu title. It's also the field used by the menu search function.
+     */
+    title?: string;
+    /**
+     * Use this prop to render additional actions in the menu title.
+     */
+    titleAction?: React.ReactNode;
+};
+export type NavigationGroupProps = {
+    /**
+     * Optional classname for the component.
+     */
+    className?: string;
+    /**
+     * The group title.
+     */
+    title?: string;
+    /**
+     * The children components.
+     */
+    children: React.ReactNode;
+};
+type _NavigationItemButtonProps = (ButtonProps & {
+    /**
+     * If set to `true` the menu item will only act as a text-only item,
+     * rather than a `<button />` or `<a />` element.
+     */
+    isText?: false;
+}) | {
+    /**
+     * If set to `true` the menu item will only act as a text-only item,
+     * rather than a `<button />` or `<a />` element.
+     */
+    isText: true;
+};
+export type NavigationItemBaseProps = {
+    /**
+     * The item badge content.
+     */
+    badge?: string | number;
+    /**
+     * The children components. When not specified, the item will render the
+     * default item UI.
+     */
+    children?: React.ReactNode;
+    /**
+     * Optional classname for the component.
+     */
+    className?: string;
+    /**
+     * If provided, causes the component to render an `<a />` element
+     * instead of a `<button />` element.
+     */
+    href?: string;
+    /**
+     * If no `children` are passed, this prop allows to specify a custom icon for
+     * the menu item.
+     */
+    icon?: React.JSX.Element;
+    /**
+     * The unique identifier of the item.
+     */
+    item?: string;
+    /**
+     * The child menu slug. If provided, clicking on the item will navigate
+     * to the target menu.
+     */
+    navigateToMenu?: string;
+    /**
+     * Indicates whether this item should be hidden if the menu specified in
+     * `navigateToMenu` is marked as empty in the `isEmpty` prop.
+     * Used together with the `isEmpty` prop of `NavigationMenu`.
+     */
+    hideIfTargetMenuEmpty?: boolean;
+    /**
+     * A callback to handle clicking on a menu item.
+     *
+     * @default noop
+     */
+    onClick?: React.MouseEventHandler;
+    /**
+     * The item title.
+     */
+    title?: string;
+};
+export type NavigationItemProps = _NavigationItemButtonProps & NavigationItemBaseProps;
+export type NavigationItemBaseContentProps = Pick<NavigationItemProps, 'badge' | 'title'>;
+export type NavigationBackButtonProps = {
+    /**
+     * The text displayed for the button
+     */
+    backButtonLabel?: string;
+    /**
+     * Optional classname for the component.
+     */
+    className?: string;
+    /**
+     * If provided, causes the component to render an `<a />` element
+     * instead of a `<button />` element.
+     */
+    href?: string;
+    /**
+     * Callback function called when the button is clicked.
+     */
+    onClick?: React.MouseEventHandler;
+    /**
+     * Id of the parent menu
+     */
+    parentMenu?: string;
+};
+export type NavigationMenuTitleSearchProps = Pick<NavigationMenuProps, 'onSearch' | 'search' | 'title'> & {
+    debouncedSpeak: (message: string, ariaLive?: 'off' | 'polite' | 'assertive') => void;
+    onCloseSearch: () => void;
+};
+export type NavigationMenuTitleProps = Pick<NavigationMenuProps, 'hasSearch' | 'onSearch' | 'search' | 'title' | 'titleAction'>;
+export type NavigationSearchNoResultsFoundProps = Pick<NavigationMenuProps, 'search'>;
+export type Item = Omit<NavigationItemBaseProps, 'children'> & {
+    /**
+     * The group id
+     */
+    group?: string;
+    /**
+     * The menu id
+     */
+    menu?: string;
+    /**
+     * True is the item is currently visible (ie. the item is part
+     * of the active menu, and — if there is a search query — its title
+     * matches the search query).
+     */
+    _isVisible: boolean;
+};
+export type Menu = Omit<NavigationMenuProps, 'children'> & {
+    menu: string;
+};
+export type NavigationGroupContext = {
+    /**
+     * The unique id of the group
+     */
+    group?: string;
+};
+export type NavigationMenuContext = {
+    menu?: string;
+    search?: string;
+};
+export type NavigationContext = {
+    activeItem?: string;
+    activeMenu: string;
+    setActiveMenu: (parentMenu: string, animationDirection?: 'left' | 'right') => void;
+    navigationTree: {
+        items: Record<string, Item>;
+        getItem: (itemId: string) => Item | undefined;
+        addItem: (itemId: string, itemProps: Item) => void;
+        removeItem: (itemId: string) => void;
+        menus: Record<string, Menu>;
+        getMenu: (menuId: string) => Menu | undefined;
+        addMenu: (menuId: string, menuProps: Menu) => void;
+        removeMenu: (menuId: string) => void;
+        childMenu: Record<string, string[]>;
+        traverseMenu: (startMenu: string, callback: (menuObject: Menu) => boolean | undefined) => void;
+        isMenuEmpty: (menuId: string) => boolean;
+    };
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/navigation/types.ts"],"names":[],"mappings":"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"}

package/build-types/navigation/use-create-navigation-tree.d.ts

@@ -0,0 +1,15 @@
+import type { Item, Menu } from './types';
+export declare const useCreateNavigationTree: () => {
+    items: Record<string, Omit<Item, "children">>;
+    getItem: (key: string) => Omit<Item, "children">;
+    addItem: (key: string, value: Item) => void;
+    removeItem: (key: string) => void;
+    menus: Record<string, Omit<Menu, "children">>;
+    getMenu: (key: string) => Omit<Menu, "children">;
+    addMenu: (key: string, value: Menu) => void;
+    removeMenu: (key: string) => void;
+    childMenu: Record<string, string[]>;
+    traverseMenu: (startMenu: string, callback: (menuObject: Menu) => boolean | undefined) => void;
+    isMenuEmpty: (menuToCheck: string) => boolean;
+};
+//# sourceMappingURL=use-create-navigation-tree.d.ts.map

package/build-types/navigation/use-create-navigation-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-create-navigation-tree.d.ts","sourceRoot":"","sources":["../../src/navigation/use-create-navigation-tree.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAqB,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE7D,eAAO,MAAM,uBAAuB;;;;;;;mBAyElB,MAAM,SAAS,IAAI;;;;+BAvBD,MAAM;CA+CzC,CAAC"}

package/build-types/navigation/use-navigation-tree-nodes.d.ts

@@ -0,0 +1,10 @@
+export declare function useNavigationTreeNodes<TNode extends {
+    children?: React.ReactNode;
+    [key: string]: unknown;
+}>(): {
+    nodes: Record<string, Omit<TNode, "children">>;
+    getNode: (key: string) => Omit<TNode, "children">;
+    addNode: (key: string, value: TNode) => void;
+    removeNode: (key: string) => void;
+};
+//# sourceMappingURL=use-navigation-tree-nodes.d.ts.map

package/build-types/navigation/use-navigation-tree-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-navigation-tree-nodes.d.ts","sourceRoot":"","sources":["../../src/navigation/use-navigation-tree-nodes.tsx"],"names":[],"mappings":"AAKA,wBAAgB,sBAAsB,CACrC,KAAK,SAAS;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,CAAE,GAAG,EAAE,MAAM,GAAI,OAAO,CAAA;CAAE;;mBAM/C,MAAM;mBAEN,MAAM,SAAS,KAAK;;EAgB3C"}

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

@@ -0,0 +1,3 @@
+export declare const normalizeInput: (input: string) => string;
+export declare const normalizedSearch: (title: string, search: string) => boolean;
+//# sourceMappingURL=utils.d.ts.map

package/build-types/navigation/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/navigation/utils.tsx"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,UAAY,MAAM,WACa,CAAC;AAE3D,eAAO,MAAM,gBAAgB,UAAY,MAAM,UAAU,MAAM,YACI,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/unit-control/utils.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA6NjD;;GAEG;AACH,eAAO,MAAM,aAAa,qBAA4B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,SAAS,qBAOrB,CAAC;AAEF,eAAO,MAAM,YAAY,mBAAc,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,iBAAiB,EAAE,GAChC,CAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAE,CAM5C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACvB,KAAK,CAAC,EAAE,iBAAiB,EAAE,GACzB,KAAK,IAAI,iBAAiB,EAAE,CAK9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAC1B,YAAY,GAAE,iBAAiB,EAAkB,GAC/C,CAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAE,CAyB5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC5C,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,YAAY,CAAC,EAAE,iBAAiB,EAAE,EAClC,gBAAgB,CAAC,EAAE,MAAM,EACzB,YAAY,CAAC,EAAE,MAAM,GACnB,CAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAE,CAmB5C;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAE,IAAI,EAAE,MAAM,GAAI,MAAM,GAAG,SAAS,CAG5E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,iBAAiB,EAAE,MAAM,EAAE,YAAK,EAChC,cAAc,EAAE,iBAAiB,EAAE,GACjC,iBAAiB,EAAE,CASrB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,8CAIxB;IACF,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,CAAC;CACzC,KAAI,iBAAiB,EAgBrB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,iBAAiB,EAAkB,GACxC,iBAAiB,EAAE,CAkBrB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/unit-control/utils.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA2MjD;;GAEG;AACH,eAAO,MAAM,aAAa,qBAA4B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,SAAS,qBAOrB,CAAC;AAEF,eAAO,MAAM,YAAY,mBAAc,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,iBAAiB,EAAE,GAChC,CAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAE,CAM5C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACvB,KAAK,CAAC,EAAE,iBAAiB,EAAE,GACzB,KAAK,IAAI,iBAAiB,EAAE,CAK9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAC1B,YAAY,GAAE,iBAAiB,EAAkB,GAC/C,CAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAE,CAyB5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC5C,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,YAAY,CAAC,EAAE,iBAAiB,EAAE,EAClC,gBAAgB,CAAC,EAAE,MAAM,EACzB,YAAY,CAAC,EAAE,MAAM,GACnB,CAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAE,CAmB5C;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAE,IAAI,EAAE,MAAM,GAAI,MAAM,GAAG,SAAS,CAG5E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,iBAAiB,EAAE,MAAM,EAAE,YAAK,EAChC,cAAc,EAAE,iBAAiB,EAAE,GACjC,iBAAiB,EAAE,CASrB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,8CAIxB;IACF,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,CAAC;CACzC,KAAI,iBAAiB,EAgBrB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,iBAAiB,EAAkB,GACxC,iBAAiB,EAAE,CAkBrB"}

package/build-types/validated-form-controls/components/combobox-control.d.ts

@@ -2,7 +2,7 @@ import type { ValidatedControlProps } from './types';
 export declare const ValidatedComboboxControl: import("react").ForwardRefExoticComponent<Omit<Pick<import("../../base-control/types").BaseControlProps, "__nextHasNoMarginBottom" | "className" | "help" | "hideLabelFromVision" | "label"> & {
     __experimentalRenderItem?: (args: {
         item: import("../../combobox-control/types").ComboboxControlOption;
-    }) => React.ReactNode;
+    }) => import("react").ReactNode;
     __next36pxDefaultSize?: boolean;
     __next40pxDefaultSize?: boolean;
     allowReset?: boolean;
@@ -10,7 +10,7 @@ export declare const ValidatedComboboxControl: import("react").ForwardRefExoticC
     messages?: {
         selected: string;
     };
-    onChange?: (value: import("../../combobox-control/types").ComboboxControlProps['value']) => void;
+    onChange?: (value: string | null | undefined) => void;
     onFilterValueChange?: (value: string) => void;
     options: import("../../combobox-control/types").ComboboxControlOption[];
     value?: string | null;

package/build-types/visually-hidden/test/index.d.ts

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

package/build-types/visually-hidden/test/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/components",
-	"version": "35.0.0",
+	"version": "35.0.1",
 	"description": "UI components for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -43,7 +43,6 @@
 		"./package.json": "./package.json",
 		"./build-style/": "./build-style/"
 	},
-	"react-native": "src/index",
 	"wpScript": true,
 	"types": "build-types",
 	"sideEffects": [
@@ -51,49 +50,48 @@
 		"src/**/*.scss"
 	],
 	"dependencies": {
-		"@ariakit/react": "^0.4.22",
+		"@ariakit/react": "^0.4.21",
 		"@date-fns/utc": "^2.1.1",
 		"@emotion/cache": "^11.14.0",
 		"@emotion/css": "^11.13.5",
-		"@emotion/native": "^11.11.0",
 		"@emotion/react": "^11.14.0",
 		"@emotion/serialize": "^1.3.3",
 		"@emotion/styled": "^11.14.1",
 		"@emotion/utils": "^1.4.2",
-		"@floating-ui/react-dom": "2.0.8",
-		"@types/gradient-parser": "1.1.0",
-		"@types/highlight-words-core": "1.2.1",
+		"@floating-ui/react-dom": "^2.0.8",
+		"@types/gradient-parser": "^1.1.0",
+		"@types/highlight-words-core": "^1.2.1",
 		"@types/react": "^18.3.27",
 		"@use-gesture/react": "^10.3.1",
-		"@wordpress/a11y": "^4.48.0",
-		"@wordpress/base-styles": "^9.1.0",
-		"@wordpress/compose": "^8.1.0",
-		"@wordpress/date": "^5.48.0",
-		"@wordpress/deprecated": "^4.48.0",
-		"@wordpress/dom": "^4.48.0",
-		"@wordpress/element": "^8.0.0",
-		"@wordpress/escape-html": "^3.48.0",
-		"@wordpress/hooks": "^4.48.0",
-		"@wordpress/html-entities": "^4.48.0",
-		"@wordpress/i18n": "^6.21.0",
-		"@wordpress/icons": "^13.3.0",
-		"@wordpress/is-shallow-equal": "^5.48.0",
-		"@wordpress/keycodes": "^4.48.0",
-		"@wordpress/primitives": "^4.48.0",
-		"@wordpress/private-apis": "^1.48.0",
-		"@wordpress/rich-text": "^7.48.0",
-		"@wordpress/style-runtime": "^0.4.0",
-		"@wordpress/ui": "^0.15.0",
-		"@wordpress/warning": "^3.48.0",
+		"@wordpress/a11y": "^4.48.1",
+		"@wordpress/base-styles": "^10.0.1",
+		"@wordpress/compose": "^8.1.1",
+		"@wordpress/date": "^5.48.1",
+		"@wordpress/deprecated": "^4.48.1",
+		"@wordpress/dom": "^4.48.1",
+		"@wordpress/element": "^8.0.1",
+		"@wordpress/escape-html": "^3.48.1",
+		"@wordpress/hooks": "^4.48.1",
+		"@wordpress/html-entities": "^4.48.1",
+		"@wordpress/i18n": "^6.21.1",
+		"@wordpress/icons": "^14.0.1",
+		"@wordpress/is-shallow-equal": "^5.48.1",
+		"@wordpress/keycodes": "^4.48.1",
+		"@wordpress/primitives": "^4.48.1",
+		"@wordpress/private-apis": "^1.48.1",
+		"@wordpress/rich-text": "^7.48.1",
+		"@wordpress/style-runtime": "^0.4.1",
+		"@wordpress/ui": "^0.15.1",
+		"@wordpress/warning": "^3.48.1",
 		"change-case": "^4.1.2",
 		"clsx": "^2.1.1",
-		"colord": "^2.7.0",
+		"colord": "^2.9.3",
 		"csstype": "^3.2.3",
 		"date-fns": "^4.1.0",
-		"deepmerge": "^4.3.0",
+		"deepmerge": "^4.3.1",
 		"fast-deep-equal": "^3.1.3",
 		"framer-motion": "^11.15.0",
-		"gradient-parser": "1.1.1",
+		"gradient-parser": "^1.1.1",
 		"highlight-words-core": "^1.2.2",
 		"is-plain-object": "^5.0.0",
 		"memize": "^2.1.0",
@@ -108,9 +106,13 @@
 		"@ariakit/test": "^0.4.13",
 		"@storybook/addon-docs": "^10.2.8",
 		"@storybook/react-vite": "^10.2.8",
+		"@testing-library/dom": "^10.4.1",
 		"@testing-library/jest-dom": "^6.9.1",
+		"@testing-library/react": "^16.3.2",
+		"@testing-library/user-event": "^14.6.1",
 		"@types/jest": "^29.5.14",
-		"@wordpress/jest-console": "^8.48.0",
+		"@types/react-dom": "^18.3.1",
+		"@wordpress/jest-console": "^8.48.1",
 		"snapshot-diff": "^0.10.0",
 		"storybook": "^10.2.8",
 		"timezone-mock": "^1.3.6"
@@ -122,5 +124,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "e7856693aeb4e2522d13608cd32c994e4a97cb9c"
+	"gitHead": "99df7432c5c7cb83ba41146fd1f57f3c19004305"
 }

package/src/card/card/README.md

@@ -85,9 +85,9 @@ This component provides a collection of sub-component that can be used to compos
 
 -   [`<CardBody />`](/packages/components/src/card/card-body/README.md)
 -   [`<CardDivider />`](/packages/components/src/card/card-divider/README.md)
--   [`<CardFooter />`](/packages/components/src/card/card-footer/README.md))
--   [`<CardHeader />`](/packages/components/src/card/card-header/README.md))
--   [`<CardMedia />`](/packages/components/src/card/card-media/README.md))
+-   [`<CardFooter />`](/packages/components/src/card/card-footer/README.md)
+-   [`<CardHeader />`](/packages/components/src/card/card-header/README.md)
+-   [`<CardMedia />`](/packages/components/src/card/card-media/README.md)
 
 ### Sub-Components Example
 
@@ -165,7 +165,7 @@ const Example = () => (
 );
 ```
 
-These sub-components are designed to be flexible. The Context props can be overridden by the sub-component(s) as required. In the following example, the last `<CardBody />` will render it's specified size:
+These sub-components are designed to be flexible. The Context props can be overridden by the sub-component(s) as required. In the following example, the last `<CardBody />` will render its specified size:
 
 ```jsx
 import { Card, CardBody } from '@wordpress/components';

package/src/checkbox-control/README.md

@@ -45,7 +45,7 @@ If only a few child checkboxes are checked, the parent checkbox becomes a mixed
 
 ### Usage
 
-Render an is author checkbox:
+Render an author checkbox:
 
 ```jsx
 import { useState } from 'react';

package/src/clipboard-button/README.md

@@ -51,15 +51,15 @@ The text that will be copied to the clipboard.
 
 The function that will be called when the text is copied.
 
--- Type: `() => void`
--- Required: yes
+- Type: `() => void`
+- Required: yes
 
 ### onFinishCopy
 
 The function that will be called when the text is copied and the copy animation is finished.
 
--- Type: `() => void`
--- Required: no
+- Type: `() => void`
+- Required: no
 
 ### Inherited props
 

package/src/color-palette/index.tsx

@@ -276,6 +276,11 @@ function UnforwardedColorPalette(
 		ariaLabelledby
 	);
 
+	// If disableCustomColors is true and colors.length is 0, return null to avoid rendering an empty palette wrapper.
+	if ( disableCustomColors && colors.length === 0 && ! actions ) {
+		return null;
+	}
+
 	return (
 		<VStack spacing={ 3 } ref={ forwardedRef } { ...additionalProps }>
 			{ ! disableCustomColors && (

package/src/color-palette/test/index.tsx

@@ -151,6 +151,20 @@ describe( 'ColorPalette', () => {
 		).not.toBeInTheDocument();
 	} );
 
+	it( 'should render nothing when custom colors are disabled, there are no colors, and it is not clearable', () => {
+		const onChange = jest.fn();
+		const { container } = render(
+			<ColorPalette
+				colors={ [] }
+				disableCustomColors
+				clearable={ false }
+				onChange={ onChange }
+			/>
+		);
+
+		expect( container ).toBeEmptyDOMElement();
+	} );
+
 	it( 'should render dropdown and its content', async () => {
 		const user = userEvent.setup();
 		const onChange = jest.fn();
@@ -217,6 +231,22 @@ describe( 'ColorPalette', () => {
 		).toBeInTheDocument();
 	} );
 
+	it( 'should still show the clear button when colors is empty and custom colors are disabled', () => {
+		const onChange = jest.fn();
+
+		render(
+			<ColorPalette
+				colors={ [] }
+				disableCustomColors
+				onChange={ onChange }
+			/>
+		);
+
+		expect(
+			screen.getByRole( 'button', { name: 'Clear' } )
+		).toBeInTheDocument();
+	} );
+
 	it( 'should display the selected color name and value', async () => {
 		const user = userEvent.setup();