@cdx-ui/primitives 0.0.1-beta.159 → 0.0.1-beta.160

package/lib/typescript/menu/types.d.ts

@@ -0,0 +1,104 @@
+import type { ReactNode } from 'react';
+import type { PressableProps, ViewProps } from 'react-native';
+import type { OverlayPlacement } from '../overlay';
+import type { InteractionState } from '../types';
+export interface IMenuOverlayRootProps extends ViewProps {
+    isOpen?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    /** Preferred popup placement relative to the trigger. */
+    placement?: OverlayPlacement;
+    /** Distance between the trigger and popup in pixels. */
+    offset?: number;
+    /** Cross-axis adjustment from the aligned popup position in pixels. */
+    crossOffset?: number;
+    children?: ReactNode;
+}
+export interface IMenuTriggerProps extends PressableProps {
+    asChild?: boolean;
+    children?: ReactNode;
+}
+export interface IMenuPopupProps extends ViewProps {
+    children?: ReactNode;
+}
+export interface IMenuProps extends ViewProps {
+    /** When true, children are wrapped in a scroll container (styled layer applies max-height). */
+    scrollable?: boolean;
+    /** Called when Escape is pressed on web keyboard navigation. */
+    onEscape?: () => void;
+    /**
+     * Visual-only surface without `role="menu"` or menu keyboard navigation.
+     * Use when embedding inside another collection (e.g. `Select.Content` listbox).
+     */
+    asSurface?: boolean;
+    children?: ReactNode;
+}
+export interface IMenuItemProps extends PressableProps {
+    disabled?: boolean;
+    /** Whether activation closes an overlay Menu. Defaults to true for overlay items. */
+    closeOnSelect?: boolean;
+    /** @internal */
+    itemRole?: 'menuitem' | 'menuitemcheckbox' | 'menuitemradio';
+    /** @internal */
+    isChecked?: boolean;
+    /**
+     * @internal
+     */
+    isHovered?: boolean;
+    /**
+     * @internal
+     */
+    isActive?: boolean;
+    /**
+     * @internal
+     */
+    isFocused?: boolean;
+    /**
+     * @internal
+     */
+    isFocusVisible?: boolean;
+    /**
+     * @internal
+     */
+    isDisabled?: boolean;
+}
+export interface MenuItemInteractionState extends InteractionState {
+    highlighted: boolean;
+    checked: boolean;
+}
+export interface IMenuCheckboxItemProps extends Omit<IMenuItemProps, 'children' | 'isChecked' | 'itemRole'> {
+    children?: ReactNode;
+    isChecked?: boolean;
+    defaultIsChecked?: boolean;
+    onChange?: (isChecked: boolean) => void;
+}
+export interface IMenuRadioGroupProps extends ViewProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+}
+export interface IMenuRadioItemProps extends Omit<IMenuItemProps, 'children' | 'isChecked' | 'itemRole'> {
+    children?: ReactNode;
+    value: string;
+}
+export interface RegisteredMenuItem {
+    disabled: boolean;
+    node: {
+        focus?: () => void;
+    } | null;
+}
+export type MenuCloseReason = 'escape' | 'outside' | 'programmatic' | 'select' | 'tab' | 'trigger';
+export interface MenuContextValue {
+    menuId: string;
+    registerItem: (itemId: string, entry: RegisteredMenuItem) => void;
+    unregisterItem: (itemId: string) => void;
+    getItems: () => [string, RegisteredMenuItem][];
+    focusedItemId: string | undefined;
+    setFocusedItemId: (itemId: string | undefined) => void;
+    onEscape?: () => void;
+    /** When true, item activation dismisses the overlay menu. */
+    closeOnSelect?: boolean;
+    dismissOverlay?: (reason?: MenuCloseReason) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/menu/types.d.ts.map

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

package/lib/typescript/menu/useMenuNavigation.d.ts

@@ -0,0 +1,16 @@
+import type { RegisteredMenuItem } from './types';
+export interface UseMenuNavigationOptions {
+    getItems: () => [string, RegisteredMenuItem][];
+    focusedItemId: string | undefined;
+    setFocusedItemId: (itemId: string | undefined) => void;
+    onEscape?: () => void;
+    onTab?: () => void;
+}
+export declare function useMenuNavigation({ getItems, focusedItemId, setFocusedItemId, onEscape, onTab, }: UseMenuNavigationOptions): {
+    handleKeyDown: (e: {
+        key: string;
+        preventDefault: () => void;
+        stopPropagation?: () => void;
+    }) => void;
+};
+//# sourceMappingURL=useMenuNavigation.d.ts.map

package/lib/typescript/menu/useMenuNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMenuNavigation.d.ts","sourceRoot":"","sources":["../../../src/menu/useMenuNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,CAAC;IAC/C,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,KAAK,GACN,EAAE,wBAAwB;uBAoBnB;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,IAAI,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;EA8DhF"}

package/lib/typescript/menu/useMenuOverlayLifecycle.d.ts

@@ -0,0 +1,15 @@
+import type { MenuOverlayContextValue } from './overlayContext';
+import type { RegisteredMenuItem } from './types';
+export interface UseMenuOverlayOpenFocusOptions {
+    overlay: MenuOverlayContextValue | null;
+    getItems: () => [string, RegisteredMenuItem][];
+    setFocusedItemId: (itemId: string | undefined) => void;
+}
+/**
+ * On open, keyboard-opened menus focus the first or last enabled item;
+ * pointer-opened menus focus the menu container so the first item is not
+ * highlighted until hover or arrow keys.
+ */
+export declare function useMenuOverlayOpenFocus({ overlay, getItems, setFocusedItemId, }: UseMenuOverlayOpenFocusOptions): void;
+export declare function useMenuOverlayCloseFocus(overlay: MenuOverlayContextValue): void;
+//# sourceMappingURL=useMenuOverlayLifecycle.d.ts.map

package/lib/typescript/menu/useMenuOverlayLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMenuOverlayLifecycle.d.ts","sourceRoot":"","sources":["../../../src/menu/useMenuOverlayLifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,CAAC;IAC/C,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACxD;AAWD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,OAAO,EACP,QAAQ,EACR,gBAAgB,GACjB,EAAE,8BAA8B,QAyBhC;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,QAoBxE"}

package/lib/typescript/menu/useMenuTrigger.d.ts

@@ -0,0 +1,35 @@
+import { type ForwardedRef, type RefCallback } from 'react';
+import { type GestureResponderEvent, type PressableProps } from 'react-native';
+import type { InteractionState } from '../types';
+export interface UseMenuTriggerOptions {
+    asChild?: boolean;
+    onPress?: PressableProps['onPress'];
+    onHoverIn?: PressableProps['onHoverIn'];
+    onHoverOut?: PressableProps['onHoverOut'];
+    onFocus?: (...args: unknown[]) => unknown;
+    onBlur?: (...args: unknown[]) => unknown;
+    onKeyDown?: (e: KeyboardEvent) => void;
+}
+export interface MenuTriggerAriaProps {
+    role: 'button';
+    id: string;
+    'aria-haspopup': 'menu';
+    'aria-expanded': boolean;
+    'aria-controls': string;
+    disabled: boolean;
+}
+export interface UseMenuTriggerReturn {
+    ariaProps: MenuTriggerAriaProps;
+    interactionState: Pick<InteractionState, 'hover' | 'focus' | 'disabled'>;
+    mergedRef: RefCallback<unknown>;
+    handlers: {
+        onPress: (e: GestureResponderEvent) => void;
+        onHoverIn: NonNullable<PressableProps['onHoverIn']>;
+        onHoverOut: NonNullable<PressableProps['onHoverOut']>;
+        onFocus: (...args: unknown[]) => unknown;
+        onBlur: (...args: unknown[]) => unknown;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+}
+export declare function useMenuTrigger(forwardedRef: ForwardedRef<unknown>, options: UseMenuTriggerOptions): UseMenuTriggerReturn;
+//# sourceMappingURL=useMenuTrigger.d.ts.map

package/lib/typescript/menu/useMenuTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMenuTrigger.d.ts","sourceRoot":"","sources":["../../../src/menu/useMenuTrigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAC1F,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAI/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,oBAAoB,CAAC;IAChC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;IACzE,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE;QACR,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;QAC5C,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;QACpD,UAAU,EAAE,WAAW,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;QACzC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;QACxC,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;KACvC,CAAC;CACH;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,EACnC,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAoHtB"}

package/lib/typescript/overlay/OverlayContainer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayContainer.d.ts","sourceRoot":"","sources":["../../../src/overlay/OverlayContainer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAML,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAI/E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,QAAQ,EACR,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE,QAAQ,CAAC,qBAAqB,CAAC,2CA2BjC"}
+{"version":3,"file":"OverlayContainer.d.ts","sourceRoot":"","sources":["../../../src/overlay/OverlayContainer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAML,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAI/E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,QAAQ,EACR,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE,QAAQ,CAAC,qBAAqB,CAAC,2CA6BjC"}

package/lib/typescript/overlay/OverlayStack.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+export type OverlayStackLayer = 'nonmodal' | 'modal' | 'notification';
+export type OverlayStackCapability = 'escape' | 'outside' | 'back';
+export interface OverlayStackMetadata {
+    /**
+     * Semantic layer used by hosts for visual and accessibility policy.
+     * Dismissal ownership follows activation order so a child opened from a modal
+     * handles Escape or outside interaction before its parent.
+     * @default 'nonmodal'
+     */
+    layer?: OverlayStackLayer;
+    /**
+     * Optional logical overlay identifier.
+     */
+    id?: string;
+    /**
+     * Optional parent overlay identifier for nested overlay diagnostics.
+     */
+    parentId?: string;
+    /**
+     * Optional group identifier for registrations owned by one logical overlay.
+     */
+    groupId?: string;
+}
+export interface OverlayStackRegistrationOptions extends OverlayStackMetadata {
+    active: boolean;
+    capabilities?: readonly OverlayStackCapability[];
+}
+export interface OverlayStackRegistrationResult {
+    id: string;
+    isTopmost: (capability: OverlayStackCapability) => boolean;
+}
+/**
+ * Scopes overlay ordering and dismissal coordination to a provider subtree.
+ * Hooks retain their standalone behavior when no provider is present.
+ */
+export declare function OverlayStackProvider({ children }: Readonly<{
+    children: React.ReactNode;
+}>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Registers one active overlay and reports whether it is topmost for a specific
+ * dismissal capability. Capabilities are resolved independently so a
+ * notification without dismissal capabilities never blocks a modal.
+ */
+export declare function useOverlayStackRegistration({ active, capabilities, layer, id, parentId, groupId, }: OverlayStackRegistrationOptions): OverlayStackRegistrationResult;
+//# sourceMappingURL=OverlayStack.d.ts.map

package/lib/typescript/overlay/OverlayStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayStack.d.ts","sourceRoot":"","sources":["../../../src/overlay/OverlayStack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,+BAAgC,SAAQ,oBAAoB;IAC3E,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,OAAO,CAAC;CAC5D;AAyED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC,2CAIzF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,YAAiB,EACjB,KAAkB,EAClB,EAAE,EACF,QAAQ,EACR,OAAO,GACR,EAAE,+BAA+B,GAAG,8BAA8B,CA+DlE"}

package/lib/typescript/overlay/constants.d.ts

@@ -3,4 +3,9 @@
  * so Dialog / AlertDialog stack on top when opened from a bottom sheet.
  */
 export declare const MODAL_OVERLAY_Z_INDEX = 10000;
+/**
+ * Notification overlay z-index — above modal surfaces while remaining
+ * nonmodal and pointer-transparent outside the notification content.
+ */
+export declare const NOTIFICATION_OVERLAY_Z_INDEX = 11000;
 //# sourceMappingURL=constants.d.ts.map

package/lib/typescript/overlay/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/overlay/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAQ,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/overlay/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAQ,CAAC"}

package/lib/typescript/overlay/getAnchoredOverlayPosition.d.ts

@@ -0,0 +1,45 @@
+import type { ViewStyle } from 'react-native';
+import type { AnchorLayout } from './useAnchorPosition';
+import type { EdgeInsets } from './useOverlayPosition';
+export declare const OVERLAY_PLACEMENTS: readonly ["auto", "auto-start", "auto-end", "top", "top-start", "top-end", "right", "right-start", "right-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end"];
+export type OverlayPlacement = (typeof OVERLAY_PLACEMENTS)[number];
+export type OverlaySide = 'top' | 'right' | 'bottom' | 'left';
+export type OverlayAlign = 'start' | 'center' | 'end';
+export type OverlayCollisionBehavior = 'none' | 'flip' | 'flip-shift';
+export type OverlayWidthPolicy = 'content' | 'anchor';
+export interface FloatingLayout {
+    width: number;
+    height: number;
+}
+export interface ResolvedOverlayPlacement {
+    side: OverlaySide;
+    align: OverlayAlign;
+}
+export interface AnchoredOverlayPositionOptions {
+    placement?: OverlayPlacement;
+    offset?: number;
+    crossOffset?: number;
+    collisionBehavior?: OverlayCollisionBehavior;
+    collisionPadding?: number | Partial<EdgeInsets>;
+    insets?: Partial<EdgeInsets>;
+    width?: OverlayWidthPolicy;
+    isRTL?: boolean;
+    arrowBoundaryOffset?: number;
+}
+export interface AnchoredOverlayPosition {
+    style: ViewStyle;
+    resolvedPlacement: ResolvedOverlayPlacement;
+    placement: Exclude<OverlayPlacement, 'auto' | 'auto-start' | 'auto-end'>;
+    availableWidth: number;
+    availableHeight: number;
+    arrow: {
+        x?: number;
+        y?: number;
+    };
+    transformOrigin: string;
+}
+export declare function getAnchoredOverlayPosition(anchor: AnchorLayout, floatingLayout: FloatingLayout, viewport: {
+    width: number;
+    height: number;
+}, options?: AnchoredOverlayPositionOptions): AnchoredOverlayPosition;
+//# sourceMappingURL=getAnchoredOverlayPosition.d.ts.map

package/lib/typescript/overlay/getAnchoredOverlayPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAnchoredOverlayPosition.d.ts","sourceRoot":"","sources":["../../../src/overlay/getAnchoredOverlayPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,kBAAkB,2LAgBrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AACtD,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,SAAS,CAAC;IACjB,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,SAAS,EAAE,OAAO,CAAC,gBAAgB,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAgJD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3C,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAsHzB"}

package/lib/typescript/overlay/index.d.ts

@@ -1,8 +1,11 @@
-export { MODAL_OVERLAY_Z_INDEX } from './constants';
+export { MODAL_OVERLAY_Z_INDEX, NOTIFICATION_OVERLAY_Z_INDEX } from './constants';
 export { OverlayContainer } from './OverlayContainer';
 export type { OverlayContainerProps } from './OverlayContainer';
+export { OverlayStackProvider, useOverlayStackRegistration, type OverlayStackCapability, type OverlayStackLayer, type OverlayStackMetadata, type OverlayStackRegistrationOptions, type OverlayStackRegistrationResult, } from './OverlayStack';
 export { useAnchorPosition, type AnchorLayout } from './useAnchorPosition';
 export { useDismissOverlay } from './useDismissOverlay';
 export { useEscapeKey } from './useEscapeKey';
-export { useOverlayPosition, type OverlayPosition, OverlayInsetsProvider, type EdgeInsets, } from './useOverlayPosition';
+export { getAnchoredOverlayPosition, OVERLAY_PLACEMENTS, type AnchoredOverlayPosition, type AnchoredOverlayPositionOptions, type FloatingLayout, type OverlayAlign, type OverlayCollisionBehavior, type OverlayPlacement, type OverlaySide, type OverlayWidthPolicy, type ResolvedOverlayPlacement, } from './getAnchoredOverlayPosition';
+export { useAnchoredOverlay, type UseAnchoredOverlayOptions, type UseAnchoredOverlayResult, } from './useAnchoredOverlay';
+export { useOverlayPosition, type OverlayPosition, type UseOverlayPositionOptions, OverlayInsetsProvider, type EdgeInsets, } from './useOverlayPosition';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/overlay/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/overlay/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/overlay/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,GACpC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC"}

package/lib/typescript/overlay/useAnchoredOverlay.d.ts

@@ -0,0 +1,15 @@
+import { type LayoutChangeEvent, type ViewStyle } from 'react-native';
+import { type AnchoredOverlayPosition, type AnchoredOverlayPositionOptions } from './getAnchoredOverlayPosition';
+import { type UseAnchorPositionOptions } from './useAnchorPosition';
+export interface UseAnchoredOverlayOptions extends AnchoredOverlayPositionOptions, UseAnchorPositionOptions {
+}
+export interface UseAnchoredOverlayResult {
+    floatingRef: React.RefObject<any>;
+    onFloatingLayout: (event: LayoutChangeEvent) => void;
+    style: ViewStyle;
+    position: AnchoredOverlayPosition | null;
+    ready: boolean;
+    update: () => void;
+}
+export declare function useAnchoredOverlay(anchorRef: React.RefObject<any>, open: boolean, options?: UseAnchoredOverlayOptions): UseAnchoredOverlayResult;
+//# sourceMappingURL=useAnchoredOverlay.d.ts.map

package/lib/typescript/overlay/useAnchoredOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnchoredOverlay.d.ts","sourceRoot":"","sources":["../../../src/overlay/useAnchoredOverlay.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EAEpC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGvF,MAAM,WAAW,yBACf,SAAQ,8BAA8B,EAAE,wBAAwB;CAAG;AAErE,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAClC,gBAAgB,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACrD,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAsBD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAC/B,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CAmG1B"}

package/lib/typescript/overlay/useDismissOverlay.d.ts

@@ -1,7 +1,8 @@
 import type { RefObject } from 'react';
+import { type OverlayStackMetadata } from './OverlayStack';
 /**
  * No-op on native — overlay dismissal is handled by backdrop press
  * or the system back gesture / hardware button via Modal.
  */
-export declare function useDismissOverlay(_open: boolean, _contentRef: RefObject<any>, _excludeRefs: RefObject<any>[], _onDismiss: () => void): void;
+export declare function useDismissOverlay(open: boolean, _contentRef: RefObject<any>, _excludeRefs: RefObject<any>[], _onDismiss: () => void, options?: OverlayStackMetadata): void;
 //# sourceMappingURL=useDismissOverlay.d.ts.map

package/lib/typescript/overlay/useDismissOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDismissOverlay.d.ts","sourceRoot":"","sources":["../../../src/overlay/useDismissOverlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,EAC3B,YAAY,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAC9B,UAAU,EAAE,MAAM,IAAI,QACpB"}
+{"version":3,"file":"useDismissOverlay.d.ts","sourceRoot":"","sources":["../../../src/overlay/useDismissOverlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAExF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,EAC3B,YAAY,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAC9B,UAAU,EAAE,MAAM,IAAI,EACtB,OAAO,GAAE,oBAAyB,QAOnC"}

package/lib/typescript/overlay/useDismissOverlay.web.d.ts

@@ -1,8 +1,9 @@
 import type { RefObject } from 'react';
+import { type OverlayStackMetadata } from './OverlayStack';
 /**
  * Dismisses an overlay when the user clicks/presses outside of it or when
  * focus moves to an element outside the overlay via keyboard.
  * Events targeting `contentRef` or any of `excludeRefs` are ignored.
  */
-export declare function useDismissOverlay(open: boolean, contentRef: RefObject<any>, excludeRefs: RefObject<any>[], onDismiss: () => void): void;
+export declare function useDismissOverlay(open: boolean, contentRef: RefObject<any>, excludeRefs: RefObject<any>[], onDismiss: () => void, options?: OverlayStackMetadata): void;
 //# sourceMappingURL=useDismissOverlay.web.d.ts.map

package/lib/typescript/overlay/useDismissOverlay.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDismissOverlay.web.d.ts","sourceRoot":"","sources":["../../../src/overlay/useDismissOverlay.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAWvC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,EAC1B,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAC7B,SAAS,EAAE,MAAM,IAAI,QAsCtB"}
+{"version":3,"file":"useDismissOverlay.web.d.ts","sourceRoot":"","sources":["../../../src/overlay/useDismissOverlay.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAUxF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,EAC1B,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAC7B,SAAS,EAAE,MAAM,IAAI,EACrB,OAAO,GAAE,oBAAyB,QA2CnC"}

package/lib/typescript/overlay/useEscapeKey.d.ts

@@ -1,6 +1,7 @@
+import { type OverlayStackMetadata } from './OverlayStack';
 /**
  * No-op on native — Escape key dismissal is not applicable.
  * Native uses the system back gesture / hardware button via Modal.
  */
-export declare function useEscapeKey(_open: boolean, _onEscape: () => void): void;
+export declare function useEscapeKey(open: boolean, _onEscape: () => void, options?: OverlayStackMetadata): void;
 //# sourceMappingURL=useEscapeKey.d.ts.map

package/lib/typescript/overlay/useEscapeKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEscapeKey.d.ts","sourceRoot":"","sources":["../../../src/overlay/useEscapeKey.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,QAAI"}
+{"version":3,"file":"useEscapeKey.d.ts","sourceRoot":"","sources":["../../../src/overlay/useEscapeKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAExF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,IAAI,EACrB,OAAO,GAAE,oBAAyB,QAOnC"}

package/lib/typescript/overlay/useEscapeKey.web.d.ts

@@ -1,6 +1,7 @@
+import { type OverlayStackMetadata } from './OverlayStack';
 /**
  * Closes an overlay when the user presses the Escape key.
  * Web-only — native platforms use Modal's `onRequestClose` for back/dismiss.
  */
-export declare function useEscapeKey(open: boolean, onEscape: () => void): void;
+export declare function useEscapeKey(open: boolean, onEscape: () => void, options?: OverlayStackMetadata): void;
 //# sourceMappingURL=useEscapeKey.web.d.ts.map

package/lib/typescript/overlay/useEscapeKey.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEscapeKey.web.d.ts","sourceRoot":"","sources":["../../../src/overlay/useEscapeKey.web.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,QAoB/D"}
+{"version":3,"file":"useEscapeKey.web.d.ts","sourceRoot":"","sources":["../../../src/overlay/useEscapeKey.web.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAExF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,GAAE,oBAAyB,QA0BnC"}

package/lib/typescript/overlay/useOverlayPosition.d.ts

@@ -33,6 +33,10 @@ export interface OverlayPosition {
     maxHeight: number;
     placement: 'top' | 'bottom';
 }
+export interface UseOverlayPositionOptions {
+    /** When true (default), overlay width matches the anchor (e.g. Select). When false, width follows content (e.g. Menu). */
+    matchAnchorWidth?: boolean;
+}
 /**
  * Computes viewport-aware overlay positioning relative to an anchor element.
  * Automatically flips placement from bottom to top when insufficient space
@@ -41,5 +45,5 @@ export interface OverlayPosition {
  *
  * Respects safe-area insets provided via `OverlayInsetsProvider`.
  */
-export declare function useOverlayPosition(anchorLayout: AnchorLayout | null): OverlayPosition | null;
+export declare function useOverlayPosition(anchorLayout: AnchorLayout | null, options?: UseOverlayPositionOptions): OverlayPosition | null;
 //# sourceMappingURL=useOverlayPosition.d.ts.map

package/lib/typescript/overlay/useOverlayPosition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOverlayPosition.d.ts","sourceRoot":"","sources":["../../../src/overlay/useOverlayPosition.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,qCAA4C,CAAC;AAC9E,eAAO,MAAM,qBAAqB,sCAAgC,CAAC;AAWnE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAuC5F"}
+{"version":3,"file":"useOverlayPosition.d.ts","sourceRoot":"","sources":["../../../src/overlay/useOverlayPosition.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,qCAA4C,CAAC;AAC9E,eAAO,MAAM,qBAAqB,sCAAgC,CAAC;AAWnE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,0HAA0H;IAC1H,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,OAAO,CAAC,EAAE,yBAAyB,GAClC,eAAe,GAAG,IAAI,CA0DxB"}

package/lib/typescript/portal/portal.d.ts

@@ -1,5 +1,8 @@
 import * as React from 'react';
 import { type View, type ViewStyle } from 'react-native';
+export declare function PortalProvider({ children }: Readonly<{
+    children: React.ReactNode;
+}>): import("react/jsx-runtime").JSX.Element;
 export declare function PortalHost({ name }: {
     name?: string;
 }): import("react/jsx-runtime").JSX.Element | null;

package/lib/typescript/portal/portal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../src/portal/portal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AA8GnE,wBAAgB,UAAU,CAAC,EAAE,IAA0B,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,kDA0B3E;AAID,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,QAA8B,EAC9B,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,QASA;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB;;;;;EAiBjC"}
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../src/portal/portal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAwHnE,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC,2CAMnF;AAID,wBAAgB,UAAU,CAAC,EAAE,IAA0B,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,kDAyC3E;AAID,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,QAA8B,EAC9B,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,QAcA;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB;;;;;EAiBjC"}

package/lib/typescript/select/SelectContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectContent.d.ts","sourceRoot":"","sources":["../../../src/select/SelectContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6D,MAAM,OAAO,CAAC;AAClF,OAAO,EAAwB,IAAI,EAAE,MAAM,cAAc,CAAC;AAY1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,iFA+FzB,CAAC"}
+{"version":3,"file":"SelectContent.d.ts","sourceRoot":"","sources":["../../../src/select/SelectContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6D,MAAM,OAAO,CAAC;AAClF,OAAO,EAAY,IAAI,EAAE,MAAM,cAAc,CAAC;AAO9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,iFAgHzB,CAAC"}

package/lib/typescript/select/useListboxNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useListboxNavigation.d.ts","sourceRoot":"","sources":["../../../src/select/useListboxNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,SAAS,GACV,EAAE,2BAA2B;uBAUtB,GAAG;;EAuDV"}
+{"version":3,"file":"useListboxNavigation.d.ts","sourceRoot":"","sources":["../../../src/select/useListboxNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,SAAS,GACV,EAAE,2BAA2B;uBAUtB,GAAG;;EA0DV"}

package/lib/typescript/tooltip/TooltipContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TooltipContent.d.ts","sourceRoot":"","sources":["../../../src/tooltip/TooltipContent.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAwB,IAAI,EAAuB,MAAM,cAAc,CAAC;AAS/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;CAAG;AAEpE,eAAO,MAAM,cAAc,sGA+F1B,CAAC"}
+{"version":3,"file":"TooltipContent.d.ts","sourceRoot":"","sources":["../../../src/tooltip/TooltipContent.tsx"],"names":[],"mappings":"AACA,OAAO,EAAwB,IAAI,EAAE,MAAM,cAAc,CAAC;AAS1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;CAAG;AAEpE,eAAO,MAAM,cAAc,sGAoG1B,CAAC"}

package/lib/typescript/tooltip/getTooltipPosition.d.ts

@@ -1,14 +1,12 @@
 import { type ViewStyle } from 'react-native';
 import type { AnchorLayout } from '../overlay/useAnchorPosition';
-export declare const TOOLTIP_PLACEMENTS: readonly ["auto", "auto-start", "auto-end", "top", "top-start", "top-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end", "right", "right-start", "right-end"];
-export type TooltipPlacement = (typeof TOOLTIP_PLACEMENTS)[number];
+import { type OverlayAlign, type OverlayPlacement, type OverlaySide, type ResolvedOverlayPlacement } from '../overlay/getAnchoredOverlayPosition';
+export declare const TOOLTIP_PLACEMENTS: readonly ["auto", "auto-start", "auto-end", "top", "top-start", "top-end", "right", "right-start", "right-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end"];
+export type TooltipPlacement = OverlayPlacement;
 export type TooltipTriggerMode = 'hover' | 'focus' | 'click';
-export type TooltipSide = 'top' | 'bottom' | 'left' | 'right';
-export type TooltipAlign = 'start' | 'center' | 'end';
-export interface ResolvedTooltipPlacement {
-    readonly side: TooltipSide;
-    readonly align: TooltipAlign;
-}
+export type TooltipSide = OverlaySide;
+export type TooltipAlign = OverlayAlign;
+export type ResolvedTooltipPlacement = Readonly<ResolvedOverlayPlacement>;
 export declare const TOOLTIP_Z_INDEX = 9999;
 export declare function getTooltipAnchorStyle(anchor: AnchorLayout, placement: TooltipPlacement, offset: number, viewport: {
     width: number;

package/lib/typescript/tooltip/getTooltipPosition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getTooltipPosition.d.ts","sourceRoot":"","sources":["../../../src/tooltip/getTooltipPosition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,eAAO,MAAM,kBAAkB,2LAgBrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,eAAO,MAAM,eAAe,OAAO,CAAC;AAwDpC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,CAsD1D"}
+{"version":3,"file":"getTooltipPosition.d.ts","sourceRoot":"","sources":["../../../src/tooltip/getTooltipPosition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAE/C,eAAO,MAAM,kBAAkB,2LAAqB,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAChD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AACtC,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC;AACxC,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,eAAe,OAAO,CAAC;AAqCpC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,CAkB1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/primitives",
-  "version": "0.0.1-beta.159",
+  "version": "0.0.1-beta.160",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -67,8 +67,8 @@
     "@react-stately/checkbox": "3.7.4",
     "@react-stately/radio": "3.12.0",
     "@react-stately/toggle": "3.9.4",
-    "@cdx-ui/formatters": "0.0.1-beta.159",
-    "@cdx-ui/utils": "0.0.1-beta.159"
+    "@cdx-ui/formatters": "0.0.1-beta.160",
+    "@cdx-ui/utils": "0.0.1-beta.160"
   },
   "devDependencies": {
     "@types/react": "19.1.17",

package/src/dialog/DialogContent.tsx

@@ -2,7 +2,7 @@ import { forwardRef, useCallback, useEffect, type ComponentRef } from 'react';
 import { BackHandler, Platform, View, type ViewProps } from 'react-native';
 import { FocusScope } from '@react-native-aria/focus';
 import { Slot } from '../slot';
-import { useEscapeKey } from '../overlay';
+import { useEscapeKey, useOverlayStackRegistration } from '../overlay';
 import { dataAttributes, mergeDataAttributes } from '../utils/dataAttributes';
 import { useDialog } from './context';
 import type { IDialogContentProps } from './types';
@@ -27,21 +27,33 @@ export const DialogContent = forwardRef<ComponentRef<typeof View>, DialogContent
       onOpenChange(false);
     }, [onOpenChange]);
 
-    useEscapeKey(open && closeOnEscKey, handleClose);
+    useEscapeKey(open && closeOnEscKey, handleClose, {
+      id: nativeID,
+      groupId: nativeID,
+      layer: 'modal',
+    });
+    const { isTopmost } = useOverlayStackRegistration({
+      active: open && Platform.OS !== 'web',
+      capabilities: ['back'],
+      id: nativeID,
+      groupId: nativeID,
+      layer: 'modal',
+    });
 
     useEffect(() => {
       // BackHandler is native-only; react-native-web warns on every subscription.
       if (!open || Platform.OS === 'web') return;
 
       const backHandler = BackHandler.addEventListener('hardwareBackPress', () => {
-        onOpenChange(false);
+        if (!isTopmost('back')) return false;
+        handleClose();
         return true;
       });
 
       return () => {
         backHandler.remove();
       };
-    }, [open, onOpenChange]);
+    }, [handleClose, isTopmost, open]);
 
     if (!forceMount && !open) {
       return null;

package/src/dialog/DialogPopup.tsx

@@ -47,7 +47,11 @@ export const DialogPopup = forwardRef<ComponentRef<typeof View>, DialogPopupProp
       onOpenChange(false);
     }, [onOpenChange]);
 
-    useEscapeKey(open && closeOnEscKey, handleClose);
+    useEscapeKey(open && closeOnEscKey, handleClose, {
+      id: nativeID,
+      groupId: nativeID,
+      layer: 'modal',
+    });
 
     if (!(open || forceMount)) {
       return null;