@wordpress/ui 0.9.1-next.v.202603161435.0 → 0.11.0

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

@@ -0,0 +1,83 @@
+import type { ReactNode } from 'react';
+import type { Popover as _Popover } from '@base-ui/react/popover';
+import type { ComponentProps } from '../utils/types';
+export interface RootProps extends Pick<_Popover.Root.Props, 'open' | 'onOpenChange' | 'defaultOpen' | 'modal'> {
+    /**
+     * The popover sub-components (`Popover.Trigger`, `Popover.Popup`, etc.).
+     */
+    children?: ReactNode;
+}
+export interface TriggerProps extends ComponentProps<'button'>, Pick<_Popover.Trigger.Props, 'openOnHover' | 'delay' | 'closeDelay'> {
+    /**
+     * The content to be rendered inside the component.
+     */
+    children?: ReactNode;
+}
+/**
+ * `Popover.Popup` maps to two Base UI elements internally: the
+ * **Positioner** (outer, handles fixed positioning and z-index) and the
+ * **Popup** (inner, holds content and visual styles).
+ *
+ * `style` and `className` are forwarded to the **Positioner** so that
+ * z-index overrides (`--wp-ui-popover-z-index`) and Base UI CSS variables
+ * (`--available-height`, `--available-width`) work correctly. All other
+ * HTML attributes are forwarded to the inner **Popup** element.
+ */
+export interface PopupProps extends ComponentProps<'div'>, Pick<_Popover.Positioner.Props, 'align' | 'alignOffset' | 'anchor' | 'arrowPadding' | 'collisionAvoidance' | 'collisionBoundary' | 'collisionPadding' | 'side' | 'sideOffset' | 'sticky'>, Pick<_Popover.Popup.Props, 'initialFocus' | 'finalFocus'> {
+    /**
+     * Whether to render a backdrop overlay behind the popover.
+     *
+     * Typically used with `modal` to signal that interaction with the rest
+     * of the page is blocked. The backdrop is a semi-transparent dark overlay.
+     *
+     * @default false
+     */
+    backdrop?: boolean;
+    /**
+     * The content to be rendered inside the component.
+     */
+    children?: ReactNode;
+    /**
+     * A parent element to render the portal into.
+     *
+     * Useful for cross-document rendering, such as rendering a popover
+     * in a parent document when the trigger is inside an iframe.
+     */
+    container?: _Popover.Portal.Props['container'];
+    /**
+     * The visual style variant of the popup.
+     *
+     * - `'default'` — standard surface styling with background, padding,
+     *    border radius, and shadow.
+     * - `'unstyled'` — no visual treatment; useful as a blank positioning
+     *    container for fully custom content.
+     *
+     * @default 'default'
+     */
+    variant?: 'default' | 'unstyled';
+}
+export interface ArrowProps extends ComponentProps<'div'> {
+    /**
+     * Custom arrow visuals to render inside the positioned container.
+     */
+    children?: ReactNode;
+}
+export interface TitleProps extends ComponentProps<'h2'> {
+    /**
+     * The title content to be rendered.
+     */
+    children?: ReactNode;
+}
+export interface DescriptionProps extends ComponentProps<'p'> {
+    /**
+     * The description content to be rendered.
+     */
+    children?: ReactNode;
+}
+export interface CloseProps extends ComponentProps<'button'> {
+    /**
+     * The content to be rendered inside the component.
+     */
+    children?: ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/popover/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,SAChB,SAAQ,IAAI,CACX,QAAQ,CAAC,IAAI,CAAC,KAAK,EACnB,MAAM,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,CACjD;IACD;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,YAChB,SAAQ,cAAc,CAAE,QAAQ,CAAE,EACjC,IAAI,CAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,YAAY,CAAE;IACvE;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAChB,SAAQ,cAAc,CAAE,KAAK,CAAE,EAC9B,IAAI,CACH,QAAQ,CAAC,UAAU,CAAC,KAAK,EACvB,OAAO,GACP,aAAa,GACb,QAAQ,GACR,cAAc,GACd,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,MAAM,GACN,YAAY,GACZ,QAAQ,CACV,EACD,IAAI,CAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAAE;IAC5D;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAE,WAAW,CAAE,CAAC;IAEjD;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAE,KAAK,CAAE;IAC1D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAE,IAAI,CAAE;IACzD;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc,CAAE,GAAG,CAAE;IAC9D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAE,QAAQ,CAAE;IAC7D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB"}

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

@@ -0,0 +1,26 @@
+declare function useRegisterTabDev(): void;
+/**
+ * Hook that registers a Tab for count validation in development mode.
+ */
+export declare const useRegisterTab: typeof useRegisterTabDev;
+declare function useRegisterPanelDev(): void;
+/**
+ * Hook that registers a Panel for count validation in development mode.
+ */
+export declare const useRegisterPanel: typeof useRegisterPanelDev;
+/**
+ * Development-only provider that tracks the number of registered tabs and
+ * panels, and warns when the counts don't match.
+ */
+declare function TabsValidationProviderDev({ children, }: {
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Provider component that validates the number of tabs matches the number
+ * of panels in development mode.
+ *
+ * In production, this component is a no-op and just renders children.
+ */
+export declare const TabsValidationProvider: typeof TabsValidationProviderDev;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tabs/context.tsx"],"names":[],"mappings":"AAwBA,iBAAS,iBAAiB,SASzB;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc,0BAEN,CAAC;AAEtB,iBAAS,mBAAmB,SAS3B;AAMD;;GAEG;AACH,eAAO,MAAM,gBAAgB,4BAEN,CAAC;AAExB;;;GAGG;AACH,iBAAS,yBAAyB,CAAE,EACnC,QAAQ,GACR,EAAE;IACF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,+BAwEA;AAaD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,kCAEN,CAAC"}

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

@@ -4,8 +4,9 @@
  * `Tabs` is a collection of React components that combine to render
  * an [ARIA-compliant tabs pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/).
  */
-export declare const List: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsListProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "className" | "children" | "render"> & {
+export declare const List: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsListProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "style" | "className" | "children" | "render"> & {
     className?: string;
+    style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {
         ref?: import("react").Ref<any> | undefined;
     }) => React.ReactElement<unknown>) | React.ReactElement<Record<string, unknown>>;

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tabs/list.tsx"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;kDAiHhB,CAAC"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tabs/list.tsx"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;;kDAgHhB,CAAC"}

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

@@ -4,8 +4,9 @@
  * `Tabs` is a collection of React components that combine to render
  * an [ARIA-compliant tabs pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/).
  */
-export declare const Panel: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsPanelProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "className" | "children" | "render"> & {
+export declare const Panel: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsPanelProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "style" | "className" | "children" | "render"> & {
     className?: string;
+    style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {
         ref?: import("react").Ref<any> | undefined;
     }) => React.ReactElement<unknown>) | React.ReactElement<Record<string, unknown>>;

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

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/tabs/panel.tsx"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,eAAO,MAAM,KAAK;;;;;;;kDAUjB,CAAC"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/tabs/panel.tsx"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,eAAO,MAAM,KAAK;;;;;;;;kDAYjB,CAAC"}

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

@@ -4,8 +4,9 @@
  * `Tabs` is a collection of React components that combine to render
  * an [ARIA-compliant tabs pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/).
  */
-export declare const Root: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsRootProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "className" | "children" | "render"> & {
+export declare const Root: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsRootProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "style" | "className" | "children" | "render"> & {
     className?: string;
+    style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {
         ref?: import("react").Ref<any> | undefined;
     }) => React.ReactElement<unknown>) | React.ReactElement<Record<string, unknown>>;

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

@@ -1 +1 @@
-{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/tabs/root.tsx"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;kDAIhB,CAAC"}
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/tabs/root.tsx"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;kDAQhB,CAAC"}

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

@@ -4,8 +4,9 @@
  * `Tabs` is a collection of React components that combine to render
  * an [ARIA-compliant tabs pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/).
  */
-export declare const Tab: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsTabProps, "ref"> & import("react").RefAttributes<HTMLElement>, "ref">, "className" | "children" | "render"> & {
+export declare const Tab: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").TabsTabProps, "ref"> & import("react").RefAttributes<HTMLElement>, "ref">, "style" | "className" | "children" | "render"> & {
     className?: string;
+    style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {
         ref?: import("react").Ref<any> | undefined;
     }) => React.ReactElement<unknown>) | React.ReactElement<Record<string, unknown>>;

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

@@ -1 +1 @@
-{"version":3,"file":"tab.d.ts","sourceRoot":"","sources":["../../src/tabs/tab.tsx"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,eAAO,MAAM,GAAG;;;;;;;qDAcb,CAAC"}
+{"version":3,"file":"tab.d.ts","sourceRoot":"","sources":["../../src/tabs/tab.tsx"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,eAAO,MAAM,GAAG;;;;;;;;qDAgBb,CAAC"}

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

@@ -4,6 +4,10 @@ declare const meta: Meta<typeof Text>;
 export default meta;
 type Story = StoryObj<typeof Text>;
 export declare const Default: Story;
+/**
+ * Important: Setting the `variant` prop to a `heading` variant will not automatically render a heading element.
+ * Use the `render` prop to render a heading element with the appropriate level.
+ */
 export declare const AllVariants: Story;
 export declare const WithRenderProp: Story;
 //# sourceMappingURL=index.story.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/text/stories/index.story.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,IAAI,CAG5B,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,IAAI,CAAE,CAAC;AAErC,eAAO,MAAM,OAAO,EAAE,KAKrB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KA6BzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAe5B,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/text/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,IAAI,CAG5B,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,IAAI,CAAE,CAAC;AAErC,eAAO,MAAM,OAAO,EAAE,KAKrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,KA6BzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAe5B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/text/text.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;;GAGG;AACH,eAAO,MAAM,IAAI,uGAcd,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/text/text.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC;;;GAGG;AACH,eAAO,MAAM,IAAI,uGAoBd,CAAC"}

package/build-types/tooltip/popup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../src/tooltip/popup.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAQ1C,QAAA,MAAM,KAAK,uGA8CR,CAAC;AAEJ,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../src/tooltip/popup.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAQ1C,QAAA,MAAM,KAAK,uGA+CR,CAAC;AAEJ,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/build-types/tooltip/root.d.ts

@@ -1,4 +1,17 @@
 import type { RootProps } from './types';
+/**
+ * `Tooltip` is used to visually show the label of an icon button, or other such
+ * interactive controls that don't have a visual text label.
+ *
+ * Tooltip popups are visual-only and not exposed to assistive technologies.
+ * The trigger's accessible name (e.g. `aria-label`) is the source of truth
+ * for screen reader users. Tooltips are not available on touch devices,
+ * and thus should not be used for infotips, descriptions, or dynamic status
+ * messages.
+ *
+ * @see {@link https://wordpress.github.io/gutenberg/?path=/docs/design-system-components-tooltip-usage-guidelines--docs Usage Guidelines}
+ * @see {@link https://wordpress.github.io/gutenberg/?path=/docs/design-system-components-iconbutton--docs IconButton}
+ */
 declare function Root(props: RootProps): import("react").JSX.Element;
 export { Root };
 //# sourceMappingURL=root.d.ts.map

package/build-types/tooltip/root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/tooltip/root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,iBAAS,IAAI,CAAE,KAAK,EAAE,SAAS,+BAE9B;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/tooltip/root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,iBAAS,IAAI,CAAE,KAAK,EAAE,SAAS,+BAE9B;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/tooltip/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,OAAO,CAAC,IAAI,CAQpC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CASlD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CAMnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CA+BtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CAgBvD,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/tooltip/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAQ,OAAO,EAAE,MAAM,OAAO,CAAC;AAEtC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,OAAO,CAAC,IAAI,CAQpC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CASlD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CAMnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CA+BtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CAoBvD,CAAC"}

package/build-types/tooltip/stories/usage-guidelines.story.d.ts

@@ -0,0 +1,21 @@
+import type { Meta, StoryObj } from '@storybook/react-vite';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+/**
+ * Tooltips work best as visual labels for icon-only controls. Each trigger
+ * must have its own accessible name via `aria-label`.
+ */
+export declare const RecommendedUsage: Story;
+/**
+ * Popups that open when hovering an info icon should use `Popover` with
+ * `openOnHover` instead of a Tooltip. This ensures the content is accessible
+ * to touch and screen reader users.
+ */
+export declare const InfotipWithPopover: Story;
+/**
+ * `IconButton` has built-in tooltip support via the `label` prop,
+ * making it the easiest way to provide a tooltip for icon-only actions.
+ */
+export declare const IconButtonWithTooltip: Story;
+//# sourceMappingURL=usage-guidelines.story.d.ts.map

package/build-types/tooltip/stories/usage-guidelines.story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-guidelines.story.d.ts","sourceRoot":"","sources":["../../../src/tooltip/stories/usage-guidelines.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAS5D,QAAA,MAAM,IAAI,EAAE,IAMX,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC;AAEtB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KA2B9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,KA0ChC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAYnC,CAAC"}

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

@@ -14,5 +14,9 @@ export interface PopupProps extends ComponentProps<'div'>, Pick<Tooltip.Position
      * The content to be rendered inside the component.
      */
     children?: ReactNode;
+    /**
+     * A parent element to render the portal into.
+     */
+    container?: Tooltip.Portal.Props['container'];
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tooltip/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAE,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,IAAI,CAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,EACtB,OAAO,GAAG,UAAU,CACpB,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAE,QAAQ,CAAE;IAC/D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,UAChB,SAAQ,cAAc,CAAE,KAAK,CAAE,EAC9B,IAAI,CAAE,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAE;IAClE;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tooltip/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAE,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,IAAI,CAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,EACtB,OAAO,GAAG,UAAU,CACpB,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAE,QAAQ,CAAE;IAC/D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,UAChB,SAAQ,cAAc,CAAE,KAAK,CAAE,EAC9B,IAAI,CAAE,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAE;IAClE;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAE,WAAW,CAAE,CAAC;CAChD"}

package/build-types/utils/test/use-deprioritized-initial-focus.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-deprioritized-initial-focus.test.d.ts.map

package/build-types/utils/test/use-deprioritized-initial-focus.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-deprioritized-initial-focus.test.d.ts","sourceRoot":"","sources":["../../../src/utils/test/use-deprioritized-initial-focus.test.tsx"],"names":[],"mappings":""}

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

@@ -3,11 +3,15 @@ type HTMLAttributesWithRef<T extends ElementType = any> = HTMLAttributes<T> & {
     ref?: Ref<T> | undefined;
 };
 type ComponentRenderFn<Props> = (props: Props) => React.ReactElement<unknown>;
-export type ComponentProps<E extends ElementType> = Omit<ComponentPropsWithoutRef<E>, 'className' | 'children' | 'render'> & {
+export type ComponentProps<E extends ElementType> = Omit<ComponentPropsWithoutRef<E>, 'className' | 'children' | 'render' | 'style'> & {
     /**
-     * CSS class name to apply to the component.
+     * CSS class name to apply to the element.
      */
     className?: string;
+    /**
+     * CSS style to apply to the element.
+     */
+    style?: React.CSSProperties;
     /**
      * Replaces the component's default HTML element using a given React
      * element, or a function that returns a React element.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,GAAG,EACR,MAAM,OAAO,CAAC;AAEf,KAAK,qBAAqB,CAAE,CAAC,SAAS,WAAW,GAAG,GAAG,IACtD,cAAc,CAAE,CAAC,CAAE,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAE,CAAC,CAAE,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,KAAK,iBAAiB,CAAE,KAAK,IAAK,CACjC,KAAK,EAAE,KAAK,KACR,KAAK,CAAC,YAAY,CAAE,OAAO,CAAE,CAAC;AAEnC,MAAM,MAAM,cAAc,CAAE,CAAC,SAAS,WAAW,IAAK,IAAI,CACzD,wBAAwB,CAAE,CAAC,CAAE,EAC7B,WAAW,GAAG,UAAU,GAAG,QAAQ,CACnC,GAAG;IACH;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EACJ,iBAAiB,CAAE,qBAAqB,CAAE,GAC1C,KAAK,CAAC,YAAY,CAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,CAAE,CAAC;CACnD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,GAAG,EACR,MAAM,OAAO,CAAC;AAEf,KAAK,qBAAqB,CAAE,CAAC,SAAS,WAAW,GAAG,GAAG,IACtD,cAAc,CAAE,CAAC,CAAE,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAE,CAAC,CAAE,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,KAAK,iBAAiB,CAAE,KAAK,IAAK,CACjC,KAAK,EAAE,KAAK,KACR,KAAK,CAAC,YAAY,CAAE,OAAO,CAAE,CAAC;AAEnC,MAAM,MAAM,cAAc,CAAE,CAAC,SAAS,WAAW,IAAK,IAAI,CACzD,wBAAwB,CAAE,CAAC,CAAE,EAC7B,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAC7C,GAAG;IACH;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,EACJ,iBAAiB,CAAE,qBAAqB,CAAE,GAC1C,KAAK,CAAC,YAAY,CAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,CAAE,CAAC;CACnD,CAAC"}

package/build-types/utils/use-deprioritized-initial-focus.d.ts

@@ -0,0 +1,36 @@
+import type { Popover as _Popover } from '@base-ui/react/popover';
+/**
+ * The `initialFocus` type shared by Base UI overlay popups (Dialog, Popover,
+ * AlertDialog, etc.). We derive it from `Popover.Popup.Props` here, but it
+ * is identical across all overlay components.
+ */
+type InitialFocus = _Popover.Popup.Props['initialFocus'];
+/**
+ * Returns a resolved `initialFocus` value that deprioritizes elements
+ * marked with a given data attribute (e.g. a close icon), and an internal
+ * ref that must be merged onto the popup element.
+ *
+ * When `initialFocus` is `undefined` or `true` (the default behavior),
+ * the hook replaces it with a callback that:
+ * 1. On touch interactions — focuses the popup element itself (preventing
+ *    the virtual keyboard on Android), matching Base UI's default.
+ * 2. On other interactions — returns the first tabbable element that does
+ *    *not* carry `deprioritizedAttribute`. Falls back to Base UI's default
+ *    when the deprioritized element is the only tabbable element.
+ *
+ * All other `initialFocus` values (`false`, `RefObject`, callback) pass
+ * through unchanged.
+ *
+ * @param props
+ * @param props.initialFocus           The consumer-provided `initialFocus` value.
+ * @param props.deprioritizedAttribute The data attribute whose elements should be deprioritized.
+ */
+export declare function useDeprioritizedInitialFocus({ initialFocus, deprioritizedAttribute, }: {
+    initialFocus: InitialFocus;
+    deprioritizedAttribute: string;
+}): {
+    resolvedInitialFocus: boolean | import("react").RefObject<HTMLElement | null> | ((openType: import("@base-ui/utils/useEnhancedClickHandler").InteractionType) => void | boolean | HTMLElement | null) | undefined;
+    popupRef: import("react").RefObject<HTMLDivElement>;
+};
+export {};
+//# sourceMappingURL=use-deprioritized-initial-focus.d.ts.map

package/build-types/utils/use-deprioritized-initial-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-deprioritized-initial-focus.d.ts","sourceRoot":"","sources":["../../src/utils/use-deprioritized-initial-focus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAIlE;;;;GAIG;AACH,KAAK,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAE,cAAc,CAAE,CAAC;AAe3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAAE,EAC7C,YAAY,EACZ,sBAAsB,GACtB,EAAE;IACF,YAAY,EAAE,YAAY,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;CAC/B;;;EAiCA"}

package/build-types/visually-hidden/stories/index.story.d.ts

@@ -4,4 +4,11 @@ declare const meta: Meta<typeof VisuallyHidden>;
 export default meta;
 type Story = StoryObj<typeof VisuallyHidden>;
 export declare const Default: Story;
+/**
+ * Use the `render` prop to change the underlying HTML element.
+ * By default, `VisuallyHidden` renders a `<div>`. Here it renders
+ * a `<label>` instead, keeping the native label–input association
+ * while hiding the label text visually.
+ */
+export declare const WithCustomElement: Story;
 //# sourceMappingURL=index.story.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/visually-hidden/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAErC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,cAAc,CAGtC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,cAAc,CAAE,CAAC;AAE/C,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../src/visually-hidden/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAErC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,cAAc,CAGtC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,cAAc,CAAE,CAAC;AAE/C,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAgB/B,CAAC"}

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

@@ -2,6 +2,40 @@ import type { VisuallyHiddenProps } from './types';
 /**
  * Visually hides content while keeping it accessible to screen readers.
  * Useful when providing context that's only meaningful to assistive technology.
+ *
+ * Renders a `<div>` by default. Use the `render` prop to swap the
+ * underlying element while preserving the visually-hidden behavior.
+ *
+ * ## Composing with other components
+ *
+ * When composing with another component that uses the `render` prop
+ * pattern, there are two directions — and they produce different results.
+ *
+ * Most of the time you'll want `VisuallyHidden` as the **host** (outer
+ * component) and pass the other component via `render`. This keeps the
+ * other component's HTML element and semantics intact, while
+ * `VisuallyHidden` only adds its hiding styles:
+ *
+ * ```jsx
+ * // OtherComponent keeps its semantic element (e.g. <h2>).
+ * <VisuallyHidden render={ <OtherComponent /> }>
+ *   Accessible text
+ * </VisuallyHidden>
+ * ```
+ *
+ * The opposite direction is also possible, but be aware that it replaces
+ * the other component's element with VisuallyHidden's default `<div>`:
+ *
+ * ```jsx
+ * // OtherComponent's element becomes a <div>.
+ * <OtherComponent render={ <VisuallyHidden /> }>
+ *   Accessible text
+ * </OtherComponent>
+ * ```
+ *
+ * Choose based on what you need: if the other component's semantic
+ * element matters (e.g. `<label>`, `<legend>`, `<h2>`), keep
+ * `VisuallyHidden` as the host so the element is preserved.
  */
 export declare const VisuallyHidden: import("react").ForwardRefExoticComponent<VisuallyHiddenProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=visually-hidden.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"visually-hidden.d.ts","sourceRoot":"","sources":["../../src/visually-hidden/visually-hidden.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;;GAGG;AACH,eAAO,MAAM,cAAc,gHAa1B,CAAC"}
+{"version":3,"file":"visually-hidden.d.ts","sourceRoot":"","sources":["../../src/visually-hidden/visually-hidden.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,cAAc,gHAa1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/ui",
-	"version": "0.9.1-next.v.202603161435.0+ab4981c4f",
+	"version": "0.11.0",
 	"description": "Themeable React UI components for the WordPress Design System.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -43,25 +43,26 @@
 	"types": "build-types",
 	"sideEffects": false,
 	"dependencies": {
-		"@base-ui/react": "^1.2.0",
-		"@wordpress/a11y": "^4.41.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/compose": "^7.41.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/element": "^6.41.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/i18n": "^6.14.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/icons": "^12.0.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/keycodes": "^4.41.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/primitives": "^4.41.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/private-apis": "^1.41.1-next.v.202603161435.0+ab4981c4f",
-		"@wordpress/theme": "^0.8.1-next.v.202603161435.0+ab4981c4f",
-		"clsx": "^2.1.1"
+		"@base-ui/react": "^1.4.0",
+		"@wordpress/a11y": "^4.44.0",
+		"@wordpress/compose": "^7.44.0",
+		"@wordpress/element": "^6.44.0",
+		"@wordpress/i18n": "^6.17.0",
+		"@wordpress/icons": "^12.2.0",
+		"@wordpress/keycodes": "^4.44.0",
+		"@wordpress/primitives": "^4.44.0",
+		"@wordpress/private-apis": "^1.44.0",
+		"@wordpress/theme": "^0.11.0",
+		"clsx": "^2.1.1",
+		"tabbable": "^6.4.0"
 	},
 	"devDependencies": {
-		"@storybook/addon-docs": "^10.1.11",
-		"@storybook/react-vite": "^10.1.11",
+		"@storybook/addon-docs": "^10.2.8",
+		"@storybook/react-vite": "^10.2.8",
 		"@testing-library/jest-dom": "^6.9.1",
 		"@types/jest": "^29.5.14",
 		"@types/node": "^20.17.10",
-		"storybook": "^10.1.11"
+		"storybook": "^10.2.8"
 	},
 	"peerDependencies": {
 		"react": "^18.0.0",
@@ -70,5 +71,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "748f4e4564fcc0e6ae90200d90bb993a3cef5828"
+	"gitHead": "b862d8c84121a47bbeff882f6c87e61681ce2e0d"
 }

package/src/alert-dialog/context.tsx

@@ -0,0 +1,22 @@
+import { createContext } from '@wordpress/element';
+
+type Phase = 'idle' | 'pending' | 'closing';
+
+interface AlertDialogContextValue {
+	phase: Phase;
+	showSpinner: boolean;
+	errorMessage?: string;
+	confirm: () => Promise< void >;
+}
+
+const noop = async () => {};
+
+const AlertDialogContext = createContext< AlertDialogContextValue >( {
+	phase: 'idle',
+	showSpinner: false,
+	errorMessage: undefined,
+	confirm: noop,
+} );
+
+export { AlertDialogContext };
+export type { Phase };

package/src/alert-dialog/index.ts

@@ -0,0 +1,3 @@
+export { Root } from './root';
+export { Trigger } from './trigger';
+export { Popup } from './popup';