@wordpress/ui 0.12.1-next.v.202604201441.0 → 0.13.0

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

@@ -1,6 +1,8 @@
 import { Popup } from './popup';
+import { Portal } from './portal';
+import { Positioner } from './positioner';
 import { Trigger } from './trigger';
 import { Root } from './root';
 import { Provider } from './provider';
-export { Provider, Root, Trigger, Popup };
+export { Provider, Root, Trigger, Popup, Portal, Positioner };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,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,uGA+CR,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;AAU1C,QAAA,MAAM,KAAK,uGAiCR,CAAC;AAEJ,OAAO,EAAE,KAAK,EAAE,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Root element that portals `Tooltip` floating content. Pass to
+ * `Tooltip.Popup`'s `portal` prop. When `portal` is omitted, `Tooltip.Popup`
+ * uses this component with default props.
+ */
+declare const Portal: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").TooltipPortalProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export { Portal };
+//# sourceMappingURL=portal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/tooltip/portal.tsx"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,QAAA,MAAM,MAAM,kNAIX,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Positions the floating tooltip content relative to the trigger. Pass to
+ * `Tooltip.Popup`'s `positioner` prop to customize `side`, `align`,
+ * `sideOffset`, collision behavior, etc. When `positioner` is omitted,
+ * `Tooltip.Popup` uses this component with default props.
+ */
+declare const Positioner: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").TooltipPositionerProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export { Positioner };
+//# sourceMappingURL=positioner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"positioner.d.ts","sourceRoot":"","sources":["../../src/tooltip/positioner.tsx"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,QAAA,MAAM,UAAU,sNAoBf,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,4 +1,4 @@
 import type { ProviderProps } from './types';
-declare function Provider({ children, ...props }: ProviderProps): import("react").JSX.Element;
+declare function Provider({ ...props }: ProviderProps): import("react").JSX.Element;
 export { Provider };
 //# sourceMappingURL=provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/tooltip/provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,iBAAS,QAAQ,CAAE,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BAEvD;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/tooltip/provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,iBAAS,QAAQ,CAAE,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BAE7C;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

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

@@ -10,10 +10,36 @@ export declare const Default: StoryObj<typeof Tooltip.Root>;
  */
 export declare const Disabled: StoryObj<typeof Tooltip.Root>;
 /**
- * Use the `side` prop to control where the tooltip appears relative to the
- * trigger element.
+ * Customize where the tooltip appears relative to the trigger by passing a
+ * `<Tooltip.Positioner />` element to `Tooltip.Popup`'s `positioner` prop.
+ * `Tooltip.Positioner` accepts `side`, `align`, `sideOffset`, and collision
+ * settings; when `positioner` is omitted, the tooltip uses the defaults
+ * (`side="top"`, `align="center"`, `sideOffset={ 4 }`).
  */
 export declare const Positioning: StoryObj<typeof Tooltip.Root>;
+/**
+ * Beyond `side`, `Tooltip.Positioner` accepts the rest of the positioner
+ * surface — `align`, `alignOffset`, `sideOffset`, collision settings, and
+ * more — for fine-grained placement.
+ */
+export declare const WithCustomPositioner: StoryObj<typeof Tooltip.Root>;
+/**
+ * Popovers in Gutenberg are managed with explicit z-index values, which can
+ * create situations where a tooltip renders below another popover when you
+ * want it above.
+ *
+ * The `--wp-ui-tooltip-z-index` CSS variable controls the z-index of the
+ * tooltip's positioner. Override it either:
+ *
+ * - **Globally**, by setting the variable on `:root` or `body` (raises every
+ *   tooltip in the page), or
+ * - **Per instance**, by passing a `Tooltip.Portal` with a `style` (or
+ *   `className`) to `Tooltip.Popup`'s `portal` prop. The variable cascades
+ *   from the portal wrapper to everything rendered inside it.
+ *
+ * This story demonstrates the per-instance approach.
+ */
+export declare const WithCustomZIndex: StoryObj<typeof Tooltip.Root>;
 /**
  * Use `Tooltip.Provider` to control the delay before tooltips appear.
  * This is useful when you have multiple tooltips and want them to share

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;AAG5D,OAAO,KAAK,OAAO,MAAM,KAAK,CAAC;AAE/B,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"}
+{"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;AAG5D,OAAO,KAAK,OAAO,MAAM,KAAK,CAAC;AAE/B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,OAAO,CAAC,IAAI,CAiBpC,CAAC;eACa,IAAI;AAEnB,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;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CA6CtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CAmB/D,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAE,OAAO,OAAO,CAAC,IAAI,CAkB3D,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.map

@@ -1 +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;AAa5D,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"}
+{"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;AAa5D,QAAA,MAAM,IAAI,EAAE,IAWX,CAAC;eACa,IAAI;AAEnB,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/trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/tooltip/trigger.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,QAAA,MAAM,OAAO,4GAQZ,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/tooltip/trigger.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,QAAA,MAAM,OAAO,4GAIZ,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

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

@@ -1,22 +1,35 @@
-import type { ReactNode } from 'react';
-import type { Tooltip } from '@base-ui/react/tooltip';
+import type { ComponentPropsWithoutRef, ReactElement, ReactNode } from 'react';
+import type { Tooltip as _Tooltip } from '@base-ui/react/tooltip';
 import type { ComponentProps } from '../utils/types';
-export type RootProps = Pick<Tooltip.Root.Props, 'disabled' | 'children'>;
-export type ProviderProps = Pick<Tooltip.Provider.Props, 'delay' | 'children'>;
+export type PortalProps = ComponentPropsWithoutRef<typeof _Tooltip.Portal>;
+export type PositionerProps = ComponentPropsWithoutRef<typeof _Tooltip.Positioner>;
+export type RootProps = Pick<_Tooltip.Root.Props, 'disabled' | 'children'>;
+export type ProviderProps = Pick<_Tooltip.Provider.Props, 'delay' | 'children'>;
 export interface TriggerProps extends ComponentProps<'button'> {
     /**
      * The content to be rendered inside the component.
      */
     children?: ReactNode;
 }
-export interface PopupProps extends ComponentProps<'div'>, Pick<Tooltip.Positioner.Props, 'align' | 'side' | 'sideOffset'> {
+export interface PopupProps extends ComponentProps<'div'> {
     /**
      * The content to be rendered inside the component.
      */
     children?: ReactNode;
     /**
-     * A parent element to render the portal into.
+     * Optional portal element, typically `<Tooltip.Portal />` with custom
+     * `container`. When omitted, `Tooltip.Popup` uses `Tooltip.Portal` with
+     * default props. Do not pass `children` on the portal element; they would
+     * be ignored.
      */
-    container?: Tooltip.Portal.Props['container'];
+    portal?: ReactElement<Omit<PortalProps, 'children'>>;
+    /**
+     * Optional positioner element, typically `<Tooltip.Positioner />` with
+     * custom positioning props (`side`, `align`, `sideOffset`, collision
+     * settings, etc.). When omitted, `Tooltip.Popup` uses `Tooltip.Positioner`
+     * with default props. Do not pass `children` on the positioner element;
+     * they would be ignored.
+     */
+    positioner?: ReactElement<Omit<PositionerProps, 'children'>>;
 }
 //# 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;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAE,WAAW,CAAE,CAAC;CAChD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tooltip/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG,wBAAwB,CAAE,OAAO,QAAQ,CAAC,MAAM,CAAE,CAAC;AAE7E,MAAM,MAAM,eAAe,GAAG,wBAAwB,CACrD,OAAO,QAAQ,CAAC,UAAU,CAC1B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,IAAI,CAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAE,CAAC;AAE7E,MAAM,MAAM,aAAa,GAAG,IAAI,CAC/B,QAAQ,CAAC,QAAQ,CAAC,KAAK,EACvB,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,UAAW,SAAQ,cAAc,CAAE,KAAK,CAAE;IAC1D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAE,IAAI,CAAE,WAAW,EAAE,UAAU,CAAE,CAAE,CAAC;IAEzD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,YAAY,CAAE,IAAI,CAAE,eAAe,EAAE,UAAU,CAAE,CAAE,CAAC;CACjE"}

package/build-types/utils/create-overlay-modal-context.d.ts

@@ -0,0 +1,14 @@
+type OverlayModalProviderProps<Modal> = {
+    modal: Modal;
+    children: React.ReactNode;
+};
+/**
+ * Creates a modal context pair (`Provider` + `useModal`) for overlay
+ * primitives like Dialog and Drawer.
+ */
+export declare function createOverlayModalContext<Modal>(initialValue: Modal): {
+    Provider: ({ modal, children, }: OverlayModalProviderProps<Modal>) => import("react").JSX.Element;
+    useModal: () => Modal;
+};
+export {};
+//# sourceMappingURL=create-overlay-modal-context.d.ts.map

package/build-types/utils/create-overlay-modal-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-overlay-modal-context.d.ts","sourceRoot":"","sources":["../../src/utils/create-overlay-modal-context.tsx"],"names":[],"mappings":"AAEA,KAAK,yBAAyB,CAAE,KAAK,IAAK;IACzC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAE,KAAK,EAAI,YAAY,EAAE,KAAK;IAmBrE,QAAQ,yBAbN,yBAAyB,CAAE,KAAK,CAAE;IAcpC,QAAQ;EAET"}

package/build-types/utils/create-overlay-title-validation.d.ts

@@ -0,0 +1,15 @@
+type OverlayValidationContextType = {
+    registerTitle: (element: HTMLElement | null) => () => void;
+};
+type OverlayValidationProviderProps = {
+    children: React.ReactNode;
+};
+/**
+ * Creates development-only title validation helpers for overlay primitives.
+ */
+export declare function createOverlayTitleValidation(componentName: string): {
+    ValidationProvider: ({ children, }: OverlayValidationProviderProps) => import("react").JSX.Element;
+    useValidationContext: () => OverlayValidationContextType | null;
+};
+export {};
+//# sourceMappingURL=create-overlay-title-validation.d.ts.map

package/build-types/utils/create-overlay-title-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-overlay-title-validation.d.ts","sourceRoot":"","sources":["../../src/utils/create-overlay-title-validation.tsx"],"names":[],"mappings":"AAgBA,KAAK,4BAA4B,GAAG;IACnC,aAAa,EAAE,CAAE,OAAO,EAAE,WAAW,GAAG,IAAI,KAAM,MAAM,IAAI,CAAC;CAC7D,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,4BAA4B,CAAE,aAAa,EAAE,MAAM;wCAoB/D,8BAA8B;;EAoEjC"}

package/build-types/utils/render-slot-with-children.d.ts

@@ -0,0 +1,24 @@
+import type { ReactElement, ReactNode } from 'react';
+/**
+ * Fills an optional "slot" element prop with content by cloning it and
+ * injecting the given `children`. When `slot` is undefined, the provided
+ * `defaultSlot` is used in its place.
+ *
+ * Shared by overlay `Popup` components for their slot-shaped customization
+ * props (e.g. `portal`, `positioner`), so the merge behavior — defaults,
+ * children injection — stays consistent across all of them.
+ *
+ * Callers should type the slot prop as `ReactElement<Omit<Props, 'children'>>`:
+ * any subtree passed on the slot element is overwritten by `children`.
+ *
+ * @param slot        Optional element from the slot prop (e.g. `<Tooltip.Portal … />`
+ *                    or `<Tooltip.Positioner … />`). When omitted, `defaultSlot`
+ *                    is used. Injected `children` replace any subtree the caller
+ *                    may have passed on the slot element.
+ * @param defaultSlot Unpopulated default element used when `slot` is omitted
+ *                    (e.g. `<Tooltip.Portal />`).
+ * @param children    Content to inject as the slot's children (backdrop,
+ *                    positioner, popup subtree, etc.).
+ */
+export declare function renderSlotWithChildren(slot: ReactElement | undefined, defaultSlot: ReactElement, children: ReactNode): ReactElement;
+//# sourceMappingURL=render-slot-with-children.d.ts.map

package/build-types/utils/render-slot-with-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-slot-with-children.d.ts","sourceRoot":"","sources":["../../src/utils/render-slot-with-children.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,WAAW,EAAE,YAAY,EACzB,QAAQ,EAAE,SAAS,GACjB,YAAY,CAEd"}

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

@@ -7,27 +7,28 @@ import type { Popover as _Popover } from '@base-ui/react/popover';
 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.
+ * marked with any of the given data attributes (e.g. a close icon, a
+ * library-managed scroll container), 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.
+ *    *not* carry any of `deprioritizedAttributes`. Falls back to Base
+ *    UI's default when every tabbable element is deprioritized.
  *
  * 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.
+ * @param props.initialFocus            The consumer-provided `initialFocus` value.
+ * @param props.deprioritizedAttributes The data attributes whose elements should be deprioritized.
  */
-export declare function useDeprioritizedInitialFocus({ initialFocus, deprioritizedAttribute, }: {
+export declare function useDeprioritizedInitialFocus({ initialFocus, deprioritizedAttributes }: {
     initialFocus: InitialFocus;
-    deprioritizedAttribute: string;
+    deprioritizedAttributes: 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>;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,4BAA4B,CAAE,EAC7C,YAAY,EACZ,uBAAuB,EACvB,EAAE;IACF,YAAY,EAAE,YAAY,CAAC;IAC3B,uBAAuB,EAAE,MAAM,EAAE,CAAC;CAClC;;;EAsCA"}

package/build-types/utils/use-overlay-scroll-state-attributes.d.ts

@@ -0,0 +1,85 @@
+import type { UIEvent, UIEventHandler } from 'react';
+export declare const SCROLL_CONTAINER_ATTR = "data-wp-ui-overlay-scroll-container";
+/**
+ * Keeps `data-wp-ui-overlay-scrolled-from-top` and
+ * `data-wp-ui-overlay-scrolled-from-bottom` attributes in sync with a
+ * scrollable overlay element's scroll position, and marks the element with
+ * `data-wp-ui-overlay-scroll-container` so shared CSS (see
+ * `overlay-chrome.module.css`) can target it without coupling to a specific
+ * class name. Descendant selectors (e.g. sticky header/footer chrome) read
+ * these attributes to toggle their separator border without forcing a React
+ * re-render on every scroll frame.
+ *
+ * When the element overflows, a `tabindex="0"` is also installed so keyboard
+ * users can focus the region and arrow-scroll it (WCAG 2.1.1). The tabindex
+ * is removed again as soon as the element no longer overflows — a stray tab
+ * stop on a non-scrolling region is an anti-pattern. An internal flag
+ * attribute (`data-wp-ui-overlay-scroll-tabbable`) marks tabindex values
+ * the hook installed, so a consumer-supplied `tabindex` is never
+ * overwritten.
+ *
+ * Tabindex contract:
+ * - **Pre-install opt-out**: a `tabindex` set on the element before the
+ *   first overflow is detected is left alone forever. The flag is never
+ *   installed, so the hook never owns the attribute. (This means
+ *   `tabIndex={ -1 }` on `Dialog.Content` / `Drawer.Content` reliably
+ *   suppresses the auto tab stop.)
+ * - **Takeover after install**: if the consumer overrides the hook's
+ *   `"0"` with a *different* value after the fact, the flag is dropped
+ *   on the next tick (`reconcileTabbableFlag`) and the consumer's value
+ *   is preserved through subsequent overflow / non-overflow transitions
+ *   and through cleanup.
+ * - **Indistinguishable case**: a consumer who passes `tabIndex={ 0 }`
+ *   explicitly while the hook also has `"0"` installed cannot be
+ *   detected — the DOM attribute is identical to the hook-managed
+ *   value, so the hook will still strip it on the next non-overflow
+ *   tick. This is rarely intentional (the consumer's `0` matches the
+ *   hook's behavior anyway), but consumers needing a guaranteed
+ *   sticky `0` should avoid relying on it across overflow flips.
+ *
+ * Overflow detection is block-axis-only. Overlay popups are expected to
+ * constrain content width (`overlay-chrome.module.css` clips `.content`
+ * with `overflow-inline: hidden`); horizontal scrolling is intentionally
+ * not supported, so this hook doesn't toggle tabindex on inline-axis
+ * overflow and the scroll-state attributes don't track it.
+ *
+ * Returns a callback `ref` that the caller must attach to the scroll
+ * container, and an `onScroll` handler to wire up to the same element. A
+ * callback ref (not a `RefObject`) is used because overlay libraries like
+ * Base UI mount the popup DOM lazily when the overlay opens, so the
+ * attributes must be initialized the moment the node is attached, not when
+ * the host component first renders. `useState` also absorbs repeated
+ * attachments of the same node (Strict Mode remount, stable refs) without
+ * re-running the effect.
+ *
+ * Change detection combines a `ResizeObserver` scoped to the container
+ * and its direct children (to catch flex-layout growth) with a
+ * `MutationObserver` on direct-child additions/removals only (to keep
+ * the resize-observer set in sync as direct children come and go).
+ *
+ * Deeper subtree mutations are intentionally not observed: in practice,
+ * any descendant whose growth changes the scroll size also propagates a
+ * resize up the layout tree, so the existing `ResizeObserver` on direct
+ * children catches it. Watching the full subtree would fan out the
+ * mutation callback over every text-node insertion in content-heavy
+ * overlays (rich-text editors, virtualized lists), which isn't worth
+ * the cost of the rare deep-mutation-without-resize case. Revisit
+ * (and consider rAF-coalescing the callback) if a real consumer hits
+ * an attribute-staleness regression.
+ *
+ * Once CSS scroll-state container queries are supported across target
+ * browsers, both the data attributes and this hook can be replaced with
+ * `@container scroll-state(scrollable: top)` / `(scrollable: bottom)`.
+ * See: https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Conditional_rules/Container_scroll-state_queries
+ *
+ * @param onScroll Optional `onScroll` from the parent; invoked after the
+ *                 overlay scroll-state attributes are updated, so by the
+ *                 time this handler runs, `data-wp-ui-overlay-scrolled-*`
+ *                 on `event.currentTarget` already reflect the post-scroll
+ *                 state.
+ */
+export declare function useOverlayScrollStateAttributes<T extends HTMLElement = HTMLElement>(onScroll?: UIEventHandler<T> | undefined): {
+    ref: (el: T | null) => void;
+    onScroll: (event: UIEvent<T>) => void;
+};
+//# sourceMappingURL=use-overlay-scroll-state-attributes.d.ts.map

package/build-types/utils/use-overlay-scroll-state-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-overlay-scroll-state-attributes.d.ts","sourceRoot":"","sources":["../../src/utils/use-overlay-scroll-state-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGrD,eAAO,MAAM,qBAAqB,wCAAwC,CAAC;AA8G3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,wBAAgB,+BAA+B,CAC9C,CAAC,SAAS,WAAW,GAAG,WAAW,EACjC,QAAQ,CAAC,EAAE,cAAc,CAAE,CAAC,CAAE,GAAG,SAAS;cAGb,CAAC,GAAG,IAAI;sBAmE7B,OAAO,CAAE,CAAC,CAAE;EAQtB"}

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;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"}
+{"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,CAUtC,CAAC;eACa,IAAI;AAEnB,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

@@ -9,12 +9,10 @@ import type { VisuallyHiddenProps } from './types';
  * ## 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:
+ * pattern, keep `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>).
@@ -22,20 +20,6 @@ import type { VisuallyHiddenProps } from './types';
  *   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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,gHAiB1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/ui",
-	"version": "0.12.1-next.v.202604201441.0+dab6d8c07",
+	"version": "0.13.0",
 	"description": "Themeable React UI components for the WordPress Design System.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -43,16 +43,17 @@
 	"types": "build-types",
 	"sideEffects": false,
 	"dependencies": {
-		"@base-ui/react": "^1.4.0",
-		"@wordpress/a11y": "^4.44.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/compose": "^7.44.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/element": "^6.44.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/i18n": "^6.17.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/icons": "^12.2.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/keycodes": "^4.44.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/primitives": "^4.44.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/private-apis": "^1.44.1-next.v.202604201441.0+dab6d8c07",
-		"@wordpress/theme": "^0.11.1-next.v.202604201441.0+dab6d8c07",
+		"@base-ui/react": "^1.4.1",
+		"@wordpress/a11y": "^4.46.0",
+		"@wordpress/compose": "^7.46.0",
+		"@wordpress/element": "^6.46.0",
+		"@wordpress/i18n": "^6.19.0",
+		"@wordpress/icons": "^13.1.0",
+		"@wordpress/keycodes": "^4.46.0",
+		"@wordpress/primitives": "^4.46.0",
+		"@wordpress/private-apis": "^1.46.0",
+		"@wordpress/style-runtime": "^0.2.0",
+		"@wordpress/theme": "^0.13.0",
 		"clsx": "^2.1.1",
 		"tabbable": "^6.4.0"
 	},
@@ -61,7 +62,7 @@
 		"@storybook/react-vite": "^10.2.8",
 		"@testing-library/jest-dom": "^6.9.1",
 		"@types/jest": "^29.5.14",
-		"@types/node": "^20.17.10",
+		"@types/node": "^20.19.39",
 		"storybook": "^10.2.8"
 	},
 	"peerDependencies": {
@@ -71,5 +72,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "c788005ba4ee2a34851c1217c51602656aa7c3a6"
+	"gitHead": "51264e33b95fadff9a06b68141e674ce9cde9675"
 }

package/src/alert-dialog/index.ts

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