@oxyhq/bloom 0.89.0 → 1.0.0

package/lib/typescript/module/floating/types.d.ts

@@ -0,0 +1,330 @@
+/**
+ * The shared internals of Bloom's ANCHORED families — `dropdown-menu`,
+ * `context-menu`, `menubar` and `popover`.
+ *
+ * Nothing here is public API: `floating/` has no barrel and no subpath export,
+ * for the same reason `overlay/dropdown-placement` and `dialog/SheetShell` have
+ * none. The four families import it directly.
+ *
+ * What it holds, and why each piece is here rather than copied four times:
+ *
+ *  - `TriggerSlot` — Radix's `asChild` composition, plus the anchor wrapper the
+ *    web forks measure.
+ *  - `FloatingPanel` — the WEB anchored surface: portal, overlay rank, dismiss
+ *    layer and placement, in one place.
+ *  - `use-sheet-open-bridge` — the NATIVE half, bridging a Radix-shaped
+ *    `open`/`onOpenChange` pair onto `Dialog`'s imperative control.
+ *  - `menu-rows` — the row vocabulary all THREE menu families render.
+ *  - `context` — the contexts those rows read.
+ */
+import type { GestureResponderEvent, StyleProp, TextStyle, View, ViewStyle } from 'react-native';
+import type { WebAriaProps } from '../styles/styled-primitives';
+/**
+ * What a family's ROOT publishes to its own trigger and surface: the open
+ * state, and the box the surface anchors to. Each of the four families owns its
+ * OWN context object built on this shape — one shared context would make a
+ * menu nested inside a popover drive the popover.
+ */
+export interface OverlayShellContextValue {
+    open: boolean;
+    setOpen: (next: boolean) => void;
+    /** The trigger wrapper. Measured by the web forks, unused on native. */
+    anchorRef: React.RefObject<View | null>;
+}
+/**
+ * Which side of its anchor a floating surface PREFERS, and therefore which axis
+ * it fits-flips-clamps on. It is a preference:
+ * `overlay/dropdown-placement` flips to the OPPOSITE side when the named one
+ * does not fit and clamps when neither does.
+ *
+ * `'left'`/`'right'` are the submenu axis: a sub-panel flies out beside its
+ * trigger row rather than under it.
+ */
+export type FloatingSide = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * How the surface lines up with its anchor on the CROSS axis — Radix/shadcn's
+ * `align`, mapped straight onto `resolveDropdownPlacement`'s own. Horizontal
+ * under a vertical `side`, vertical under a horizontal one.
+ */
+export type FloatingAlign = 'start' | 'center' | 'end';
+/** A viewport-relative anchor box. A right-click point is a zero-area anchor. */
+export interface FloatingAnchor {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/**
+ * The positioning props every anchored Bloom surface takes, spelled the way
+ * Radix/shadcn spells them so a call site ports across unchanged.
+ */
+export interface FloatingPositionProps {
+    /** Preferred side of the anchor. Defaults to `'bottom'`. */
+    side?: FloatingSide;
+    /** Horizontal alignment against the anchor. Defaults per component. */
+    align?: FloatingAlign;
+    /** Gap between the anchor and the surface, on the `side` axis. */
+    sideOffset?: number;
+    /** Shift along the `align` axis, applied before the viewport clamp. */
+    alignOffset?: number;
+}
+export interface FloatingPanelProps extends FloatingPositionProps {
+    /** Rendered only while true — `OverlayRoot` takes its stack rank on mount. */
+    open: boolean;
+    /**
+     * Viewport-relative box to anchor against, or `null` while it is still being
+     * measured (the panel renders nothing until it has one).
+     */
+    anchor: FloatingAnchor | null;
+    /** Dismiss on an outside press and on Escape. Defaults to `true`. */
+    dismissible?: boolean;
+    /**
+     * Whether the outside press is CAUGHT or merely observed. Defaults to `true`.
+     *
+     * A modal surface lays a full-screen `Backdrop` over the app: the press
+     * dismisses the surface and goes no further, which is what a dropdown menu, a
+     * context menu and a popover all want — the click that closes a menu should
+     * not also activate whatever was behind it.
+     *
+     * A NON-modal surface lays down nothing and listens for the press instead, so
+     * it dismisses AND the press reaches the app. `Menubar` needs this and it is
+     * the reason the option exists: with a backdrop in the way, clicking a sibling
+     * trigger while one menu is open only closed the first one, and switching
+     * menus took two clicks. Radix draws the same distinction under the same name.
+     */
+    modal?: boolean;
+    /** Called for a user-initiated dismissal (outside press or Escape). */
+    onDismiss: () => void;
+    /** Accessible name of the panel. */
+    label?: string;
+    /**
+     * ARIA role of the panel itself. `'menu'` for the three menu families,
+     * `'dialog'` for a popover.
+     */
+    role: 'menu' | 'dialog';
+    /** Floor for the panel width. A menu passes its anchor's width. */
+    minWidth?: number;
+    maxWidth?: number;
+    /**
+     * Utility classes APPENDED to the panel's own chrome (radius, border,
+     * background, inset, elevation) — never substituted for it. A surface that
+     * needs a different width or inset says so here.
+     */
+    className?: string;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+    children?: React.ReactNode;
+}
+/**
+ * The props a trigger hands to whatever it renders — either Bloom's own
+ * `Pressable`, or the caller's single child under `asChild`.
+ *
+ * `aria-expanded` is the one state prop here: React Native types exactly five
+ * boolean `aria-*` props (`busy`, `checked`, `disabled`, `expanded`,
+ * `selected`) and folds them back into `accessibilityState`, so it is the
+ * spelling that reaches BOTH platforms.
+ *
+ * `aria-haspopup` is here too, and it is a PROPERTY rather than a state: React
+ * Native types no such prop — there is no state for it to fold into
+ * `accessibilityState` — while react-native-web forwards it.
+ * `styles/styled-primitives.ts`'s `WebAriaProps` is what makes it spellable
+ * without a cast, and each family passes its OWN value from
+ * `floating/constants.ts`, because the five families open three different kinds
+ * of surface and one shared default would be a lie for two of them.
+ *
+ * BOTH of these reach an `asChild` child only if that child FORWARDS them.
+ * `cloneTrigger` sets them, and a component that destructures a known prop list
+ * drops what it does not name — measured, an `asChild` `<Button>` emitted
+ * `aria-label` (which `Button` named) and neither of these. Bloom's own `Button`
+ * now forwards both; an arbitrary caller element is the caller's to wire, which
+ * is inherent to `asChild` rather than something this type can fix.
+ */
+export interface TriggerHandleProps {
+    onPress: (event: GestureResponderEvent) => void;
+    onLongPress?: (event: GestureResponderEvent) => void;
+    disabled?: boolean;
+    accessibilityLabel?: string;
+    accessibilityRole?: 'button';
+    'aria-expanded'?: boolean;
+    /**
+     * What this trigger OPENS. Set by each family from its own constant in
+     * `floating/constants.ts`, never defaulted here — the five families open three
+     * different kinds of surface.
+     */
+    'aria-haspopup'?: WebAriaProps['aria-haspopup'];
+}
+/**
+ * The open-state contract every anchored ROOT takes, spelled the way
+ * Radix/shadcn spells it: uncontrolled by default, controlled the moment `open`
+ * is passed, and `onOpenChange` fires either way.
+ */
+export interface OverlayOpenProps {
+    /** Controlled open state. Omit for an uncontrolled surface. */
+    open?: boolean;
+    /** Initial open state when uncontrolled. Defaults to `false`. */
+    defaultOpen?: boolean;
+    /** Called whenever the surface opens or closes, from any cause. */
+    onOpenChange?: (open: boolean) => void;
+}
+/** Props shared by every trigger in the four families. */
+export interface OverlayTriggerProps {
+    children?: React.ReactNode;
+    /**
+     * Render the single element child AS the trigger, merging the open handler
+     * and a11y props into it (Radix's composition escape hatch). Without it the
+     * children render inside Bloom's own `Pressable`.
+     */
+    asChild?: boolean;
+    disabled?: boolean;
+    /** Accessible name. Ignored when the `asChild` child carries its own. */
+    label?: string;
+    /**
+     * Appended to whatever chrome the trigger draws of its own. A trigger that
+     * draws none (a dropdown's, a popover's) simply has nothing to append to, so
+     * the class lands alone.
+     */
+    className?: string;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+/** Props shared by the anchored surfaces of the three menus and the popover. */
+export interface OverlaySurfaceProps extends FloatingPositionProps {
+    children?: React.ReactNode;
+    /** Accessible name of the surface. */
+    label?: string;
+    /** Dismiss on outside press and Escape. Defaults to `true`. */
+    dismissible?: boolean;
+    minWidth?: number;
+    maxWidth?: number;
+    /** Appended to the surface's own chrome — see {@link FloatingPanelProps.className}. */
+    className?: string;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+export interface MenuRowProps {
+    /**
+     * Row content. A plain string is rendered as the row's own title — so it
+     * picks up the destructive and disabled colours — while element children are
+     * rendered verbatim, which is the shadcn composition (`<Icon /><Text>…`).
+     */
+    children?: React.ReactNode;
+    onPress?: () => void;
+    disabled?: boolean;
+    /** Leading slot (icon, avatar). A Bloom addition over shadcn's children-only row. */
+    leading?: React.ReactNode;
+    /** Trailing slot (shortcut, badge). */
+    trailing?: React.ReactNode;
+    /** Indent to line up with the rows that carry a checkbox or radio indicator. */
+    inset?: boolean;
+    /** `'destructive'` paints the row in the theme's negative colour. */
+    variant?: 'default' | 'destructive';
+    /**
+     * Keep the menu open after activation. Defaults to `false` — every menu row
+     * dismisses, which is what both shadcn and Bloom's previous menus did.
+     */
+    keepOpen?: boolean;
+    /**
+     * The row's accessible name.
+     *
+     * Only needed when `children` is not a plain string: a row composed as
+     * `<Icon /><Text>Profile</Text>` has no name a screen reader can announce,
+     * because the name is derived from a string child and there isn't one. A
+     * string child names itself and needs nothing here.
+     *
+     * This is where the upstream primitive's `textValue` lands. It is spelled
+     * `accessibilityLabel` because in Bloom that is all it does — `textValue`'s
+     * other job upstream is matching keystrokes for type-ahead, and Bloom has no
+     * type-ahead for it to feed.
+     */
+    accessibilityLabel?: string;
+    /**
+     * Utility classes APPENDED to the row's own — never substituted for them, so a
+     * single layout class cannot strip the chrome. Two utilities for one property
+     * are then resolved by Tailwind's own emission order, exactly as they are in
+     * any shadcn consumer; `style` remains the unambiguous override.
+     */
+    className?: string;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+export interface MenuCheckboxRowProps extends Omit<MenuRowProps, 'onPress' | 'variant' | 'leading' | 'inset'> {
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+}
+export interface MenuRadioGroupProps {
+    children?: React.ReactNode;
+    value?: string;
+    onValueChange: (value: string) => void;
+}
+export interface MenuRadioRowProps extends Omit<MenuRowProps, 'onPress' | 'variant' | 'leading' | 'inset'> {
+    value: string;
+}
+export interface MenuLabelProps {
+    children?: React.ReactNode;
+    inset?: boolean;
+    /** Appended to the label's own classes — see {@link MenuRowProps.className}. */
+    className?: string;
+    style?: StyleProp<TextStyle>;
+}
+export interface MenuShortcutProps {
+    children?: React.ReactNode;
+    /** Appended to the shortcut's own classes — see {@link MenuRowProps.className}. */
+    className?: string;
+    style?: StyleProp<TextStyle>;
+}
+export interface MenuGroupProps {
+    children?: React.ReactNode;
+    className?: string;
+    style?: StyleProp<ViewStyle>;
+}
+export type MenuSubProps = React.PropsWithChildren<OverlayOpenProps>;
+export interface MenuSubTriggerProps {
+    children?: React.ReactNode;
+    disabled?: boolean;
+    inset?: boolean;
+    leading?: React.ReactNode;
+    /** The row's accessible name, when `children` is not a plain string. */
+    accessibilityLabel?: string;
+    /** Appended to the row's own classes — see {@link MenuRowProps.className}. */
+    className?: string;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+export interface MenuSubContentProps {
+    children?: React.ReactNode;
+    /** Appended to the sub panel's own classes — see {@link MenuRowProps.className}. */
+    className?: string;
+    style?: StyleProp<ViewStyle>;
+}
+/**
+ * The sub-menu trio, the ONE part of the row vocabulary that presents
+ * differently per platform: an inline disclosure inside a native sheet
+ * (`menu-sub-inline`), a flyout panel beside the row on web
+ * (`menu-sub-flyout`).
+ *
+ * `createMenuRows` takes a factory of this shape rather than branching on
+ * `Platform.OS`, because the flyout imports the web-only `FloatingPanel` — a
+ * runtime branch would link `react-dom` into every native bundle.
+ */
+export interface MenuSubParts {
+    Sub: React.ComponentType<MenuSubProps>;
+    SubTrigger: React.ComponentType<MenuSubTriggerProps>;
+    SubContent: React.ComponentType<MenuSubContentProps>;
+}
+/** Builds one family's sub trio. The argument is the family prefix, for `displayName`. */
+export type MenuSubFactory = (prefix: string) => MenuSubParts;
+/**
+ * The row parts one call of `createMenuRows` produces. Each menu family binds
+ * one set and publishes it under its own prefix.
+ */
+export interface MenuRowParts extends MenuSubParts {
+    Item: React.ComponentType<MenuRowProps>;
+    CheckboxItem: React.ComponentType<MenuCheckboxRowProps>;
+    RadioGroup: React.ComponentType<MenuRadioGroupProps>;
+    RadioItem: React.ComponentType<MenuRadioRowProps>;
+    Label: React.ComponentType<MenuLabelProps>;
+    Separator: React.ComponentType<Record<string, never>>;
+    Shortcut: React.ComponentType<MenuShortcutProps>;
+    Group: React.ComponentType<MenuGroupProps>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/floating/types.d.ts.map

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

package/lib/typescript/module/floating/use-anchor-rect.d.ts

@@ -0,0 +1,9 @@
+import type { View } from 'react-native';
+import type { FloatingAnchor } from './types';
+/**
+ * The trigger's viewport box while `open`, re-measured on scroll and resize.
+ * `null` until it has been measured — callers render nothing until then rather
+ * than painting at the wrong place for one frame.
+ */
+export declare function useAnchorRect(ref: React.RefObject<View | null>, open: boolean): FloatingAnchor | null;
+//# sourceMappingURL=use-anchor-rect.d.ts.map

package/lib/typescript/module/floating/use-anchor-rect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-anchor-rect.d.ts","sourceRoot":"","sources":["../../../../src/floating/use-anchor-rect.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAe9C;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,EACjC,IAAI,EAAE,OAAO,GACZ,cAAc,GAAG,IAAI,CA4BvB"}

package/lib/typescript/module/floating/use-sheet-open-bridge.d.ts

@@ -0,0 +1,9 @@
+import type { DialogControlProps } from '../dialog/types';
+export interface SheetOpenBridge {
+    /** Hand to `SheetShell`'s `control`. */
+    control: DialogControlProps;
+    /** Hand to `SheetShell`'s `onClose`. */
+    onSheetClose: () => void;
+}
+export declare function useSheetOpenBridge(open: boolean, setOpen: (next: boolean) => void): SheetOpenBridge;
+//# sourceMappingURL=use-sheet-open-bridge.d.ts.map

package/lib/typescript/module/floating/use-sheet-open-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sheet-open-bridge.d.ts","sourceRoot":"","sources":["../../../../src/floating/use-sheet-open-bridge.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,wCAAwC;IACxC,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAC/B,eAAe,CA4BjB"}

package/lib/typescript/module/frosted-icon-button/FrostedIconButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrostedIconButton.d.ts","sourceRoot":"","sources":["../../../../src/frosted-icon-button/FrostedIconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAkB7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA2I7E,eAAO,MAAM,iBAAiB,oDAAmC,CAAC"}
+{"version":3,"file":"FrostedIconButton.d.ts","sourceRoot":"","sources":["../../../../src/frosted-icon-button/FrostedIconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AAuBjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAsM7E,eAAO,MAAM,iBAAiB,oDAAmC,CAAC"}

package/lib/typescript/module/frosted-icon-button/FrostedIconButton.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrostedIconButton.web.d.ts","sourceRoot":"","sources":["../../../../src/frosted-icon-button/FrostedIconButton.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAUf,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAqL7E,eAAO,MAAM,iBAAiB,oDAAsC,CAAC"}
+{"version":3,"file":"FrostedIconButton.web.d.ts","sourceRoot":"","sources":["../../../../src/frosted-icon-button/FrostedIconButton.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAYf,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA2L7E,eAAO,MAAM,iBAAiB,oDAAsC,CAAC"}

package/lib/typescript/module/glass/GlassSurface.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { GlassSurfaceProps } from './types';
+export declare const GlassSurface: React.NamedExoticComponent<GlassSurfaceProps>;
+//# sourceMappingURL=GlassSurface.d.ts.map

package/lib/typescript/module/glass/GlassSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlassSurface.d.ts","sourceRoot":"","sources":["../../../../src/glass/GlassSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAY7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAmJjD,eAAO,MAAM,YAAY,+CAA8B,CAAC"}

package/lib/typescript/module/glass/blur-target.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import { type View } from 'react-native';
+import type { GlassBlurTargetProviderProps, GlassBlurWindowProps } from './types';
+/**
+ * Wraps the app content so a portaled surface can blur it.
+ *
+ * Composed by `BloomProvider`, and exported for consumers that do not mount it
+ * (a Vite/SPA root, or a native app that is not on expo-router). Mounting it
+ * twice duplicates no surface — it renders a transparent container and nothing
+ * else — so unlike an outlet it is safe at any depth; the nearest one simply
+ * becomes the target for its subtree.
+ */
+export declare const GlassBlurTargetProvider: React.NamedExoticComponent<GlassBlurTargetProviderProps>;
+/**
+ * Declares that its children render in a SEPARATE native window from the app
+ * content — an RN `<Modal>`, and nothing else.
+ *
+ * Bloom renders this inside its own `<Modal>`s. It is the only thing that makes
+ * the root target visible to {@link useWindowedBlurTarget}, so putting it
+ * anywhere that is not a real window boundary re-arms the crash it exists to
+ * prevent.
+ */
+export declare const GlassBlurWindow: React.NamedExoticComponent<GlassBlurWindowProps>;
+/**
+ * The blur target for a surface, or `undefined` when there is none it may
+ * safely use — either because no provider is mounted, or because this surface
+ * shares a window with the content and would crash.
+ *
+ * `undefined` is a normal answer, not a failure: the caller paints its
+ * tint-only material, exactly as it did before any of this existed.
+ */
+export declare function useWindowedBlurTarget(): React.RefObject<View | null> | undefined;
+//# sourceMappingURL=blur-target.d.ts.map

package/lib/typescript/module/glass/blur-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blur-target.d.ts","sourceRoot":"","sources":["../../../../src/glass/blur-target.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqE,MAAM,OAAO,CAAC;AAC1F,OAAO,EAAwB,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA+ElF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,0DAmClC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,kDAE1B,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,SAAS,CAKhF"}

package/lib/typescript/module/glass/index.d.ts

@@ -0,0 +1,4 @@
+export { GlassSurface } from './GlassSurface';
+export { GlassBlurTargetProvider, GlassBlurWindow, useWindowedBlurTarget, } from './blur-target';
+export type { GlassSurfaceProps, GlassBlurTargetProviderProps, GlassBlurWindowProps, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/glass/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/glass/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/lib/typescript/module/glass/types.d.ts

@@ -0,0 +1,49 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export interface GlassBlurTargetProviderProps {
+    children?: ReactNode;
+    /**
+     * Style for the wrapping target view. Defaults to `flex: 1`, which is what an
+     * app root wants; pass your own only if this is wrapping something smaller.
+     */
+    style?: StyleProp<ViewStyle>;
+}
+export interface GlassBlurWindowProps {
+    children?: ReactNode;
+}
+export interface GlassSurfaceProps {
+    /**
+     * The OPAQUE brand fill the pane is tinted with — `theme.colors.primary`,
+     * `theme.colors.negative`, and so on. The material composes the translucent
+     * tint and the full-strength hairline from it.
+     *
+     * A resolved token rather than a tone NAME because the caller is the only one
+     * who knows which token its surface means: `Button`'s `destructive` is
+     * `colors.negative`, which is a different colour from `colors.error` in all 36
+     * preset x mode combinations.
+     */
+    fill: string;
+    /**
+     * Corner radius, matching the radius of the box this fills.
+     *
+     * Required rather than defaulted: the surface CLIPS its own layers, so a
+     * radius that disagrees with the parent's shows as a square blur peeking out
+     * of a rounded control — visible, and exactly the kind of thing a default
+     * hides until someone uses a different shape.
+     */
+    radius: number;
+    /**
+     * Whether to paint the sheen — the top-lit gradient that separates glass from
+     * flat tinted plastic.
+     *
+     * Present because the sheen is the one layer with a cost worth letting a
+     * caller decline: it is an SVG node per surface, and on a surface that is
+     * small or already busy it contributes little. It is ON by default because
+     * measuring it against a flat tint is what decided it was worth having.
+     */
+    sheen?: boolean;
+    /** Extra style for the clipped layer stack (rarely needed). */
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/glass/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/glass/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;OASG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/lib/typescript/module/grid/Grid.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { type ViewStyle } from 'react-native';
+export declare const Row: React.MemoExoticComponent<({ children, gap, style, }: {
+    children: React.ReactNode;
+    gap?: number;
+    style?: ViewStyle | ViewStyle[];
+}) => import("react/jsx-runtime").JSX.Element>;
+export declare const Col: React.MemoExoticComponent<({ children, width, style, }: {
+    children: React.ReactNode;
+    width?: number;
+    style?: ViewStyle | ViewStyle[];
+}) => import("react/jsx-runtime").JSX.Element>;
+//# sourceMappingURL=Grid.d.ts.map

package/lib/typescript/module/grid/Grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grid.d.ts","sourceRoot":"","sources":["../../../../src/grid/Grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAgCpD,eAAO,MAAM,GAAG,wDAvBb;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;CACjC,6CAmBoC,CAAC;AA6BtC,eAAO,MAAM,GAAG,0DAtBb;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;CACjC,6CAkBoC,CAAC"}

package/lib/typescript/module/grid/index.d.ts

@@ -1,13 +1,2 @@
-import React from 'react';
-import { type ViewStyle } from 'react-native';
-export declare const Row: React.MemoExoticComponent<({ children, gap, style, }: {
-    children: React.ReactNode;
-    gap?: number;
-    style?: ViewStyle | ViewStyle[];
-}) => import("react/jsx-runtime").JSX.Element>;
-export declare const Col: React.MemoExoticComponent<({ children, width, style, }: {
-    children: React.ReactNode;
-    width?: number;
-    style?: ViewStyle | ViewStyle[];
-}) => import("react/jsx-runtime").JSX.Element>;
+export { Row, Col, } from './Grid';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/grid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/grid/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAgCpD,eAAO,MAAM,GAAG,wDAvBb;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;CACjC,6CAmBoC,CAAC;AA6BtC,eAAO,MAAM,GAAG,0DAtBb;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;CACjC,6CAkBoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/grid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,GAAG,GACJ,MAAM,QAAQ,CAAC"}

package/lib/typescript/module/hooks/index.d.ts

@@ -1,11 +1,12 @@
-export { useInteractionState, useInteractionStates } from './useInteractionState';
-export { useDelayedLoading } from './useDelayedLoading';
-export { useThrottledValue } from './useThrottledValue';
-export { usePressAnimation } from './usePressAnimation';
-export { mergeRefs } from './mergeRefs';
-export { useHaptics, BloomHapticsProvider } from './useHaptics';
-export type { HapticStrength, BloomHapticsProviderProps } from './useHaptics';
-export { useGutters } from './useGutters';
-export type { Gutter, Gutters } from './useGutters';
-export { useImagePreload, preloadImage } from './useImagePreload';
+export { useInteractionState, useInteractionStates } from './use-interaction-state';
+export { useAccessibilityFocus, useRestoreAccessibilityFocus, } from './use-accessibility-focus';
+export { useDelayedLoading } from './use-delayed-loading';
+export { useThrottledValue } from './use-throttled-value';
+export { usePressAnimation } from './use-press-animation';
+export { mergeRefs } from './merge-refs';
+export { useHaptics, BloomHapticsProvider } from './use-haptics';
+export type { HapticStrength, BloomHapticsProviderProps } from './use-haptics';
+export { useGutters } from './use-gutters';
+export type { Gutter, Gutters } from './use-gutters';
+export { useImagePreload, preloadImage } from './use-image-preload';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/typescript/module/hooks/merge-refs.d.ts

@@ -0,0 +1,17 @@
+import type { Ref } from 'react';
+/**
+ * Merges multiple React refs into a single callback ref.
+ *
+ * The returned callback is annotated as `(instance: T | null) => void`
+ * rather than `React.RefCallback<T>`. `RefCallback<T>` permits a cleanup
+ * return (`() => VoidOrUndefinedOnly`), and `VoidOrUndefinedOnly` is built on
+ * a `unique symbol` that is distinct per copy of `@types/react`. When a
+ * consumer resolves two copies of the React types (e.g. Bloom's pinned
+ * `@types/react` and the app's own), TypeScript reports the cleanup branch as
+ * "two different types with this name exist, but they are unrelated" and the
+ * host element's `ref` overload fails to match. A plain `void` return carries
+ * no copy-specific identity, so the callback stays assignable to `Ref<T>` from
+ * any copy of the types.
+ */
+export declare function mergeRefs<T>(refs: Array<Ref<T> | null | undefined>): (instance: T | null) => void;
+//# sourceMappingURL=merge-refs.d.ts.map

package/lib/typescript/module/hooks/merge-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-refs.d.ts","sourceRoot":"","sources":["../../../../src/hooks/merge-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAa,MAAM,OAAO,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GACrC,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAU9B"}

package/lib/typescript/module/hooks/use-accessibility-focus.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Move screen-reader focus INTO a surface when it opens.
+ *
+ * Attach the returned ref to the surface's container. That container must NOT be
+ * `accessible`: collapsing it into one accessibility element would make its rows
+ * unreachable, and focus would land on the group rather than on the first row.
+ */
+export declare function useAccessibilityFocus<T>(open: boolean): React.RefObject<T | null>;
+/**
+ * Give screen-reader focus BACK to the trigger when its surface closes.
+ *
+ * Fires on the `true -> false` edge only. A surface that was never open must not
+ * steal the cursor on mount, which is what keying on `open` alone would do for
+ * every closed menu on the screen.
+ */
+export declare function useRestoreAccessibilityFocus(open: boolean, ref: React.RefObject<unknown>): void;
+//# sourceMappingURL=use-accessibility-focus.d.ts.map

package/lib/typescript/module/hooks/use-accessibility-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-accessibility-focus.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-accessibility-focus.ts"],"names":[],"mappings":"AA0DA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAajF;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAC5B,IAAI,CAeN"}

package/lib/typescript/module/hooks/use-accessible-name-warning.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Warn once per component when a control that renders no text of its own is
+ * mounted with no accessible name. `name` is whatever the caller passed, so an
+ * empty or whitespace-only string counts as missing — it produces an
+ * `aria-label=""`, which names nothing.
+ */
+export declare function useAccessibleNameWarning(component: string, name: string | undefined): void;
+/**
+ * Test-only reset. The latch is module state that outlives a render tree, so
+ * without this the first suite to mount an unnamed control would latch it and
+ * leave every later suite asserting against a guard that can no longer fire —
+ * passing whatever the implementation did.
+ */
+export declare function resetAccessibleNameWarningsForTests(): void;
+//# sourceMappingURL=use-accessible-name-warning.d.ts.map

package/lib/typescript/module/hooks/use-accessible-name-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-accessible-name-warning.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-accessible-name-warning.ts"],"names":[],"mappings":"AA0CA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAqB1F;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D"}