@oxyhq/bloom 0.89.0 → 1.0.0

package/lib/typescript/commonjs/styles/interactive-web-css.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The filter every interactive rule carries: a control that is disabled by
+ * either spelling reacts to nothing. Exported so a family-specific `extraRules`
+ * can compose it instead of restating it and drifting.
+ */
+export declare const NOT_DISABLED = ":not(:disabled):not([aria-disabled=\"true\"])";
+export interface InteractiveWebCssOptions {
+    /**
+     * The CSS selector every rule is scoped to, written in full: `.bloom-btn` for
+     * a raw-DOM fork that renders its own class, `[data-bloom-chip]` for a
+     * react-native-web control that cannot.
+     *
+     * A full selector rather than a bare class name because the two kinds of
+     * caller cannot both use a class. A raw-DOM fork sets `className` on a real
+     * element and gets one; a react-native-web component's `className` is consumed
+     * by react-native-css and mapped into `style`, so no class ever reaches the
+     * DOM. An attribute is the hook that IS available to it, and the interactive
+     * rules are identical either way — only the thing they hang off differs.
+     */
+    selector: string;
+    /**
+     * Namespace for the per-instance custom properties the component sets inline.
+     * `bloom-btn` yields `--bloom-btn-ring` and `--bloom-btn-press-scale`.
+     */
+    varPrefix: string;
+    /**
+     * The family's own base declarations, appended after the shared reset — its
+     * layout (`flex-direction`, `gap`, `padding`), border, font and anything else
+     * that is not common to all three. A declaration here overrides the reset.
+     */
+    base: string;
+    /** Value of the base rule's `transition` shorthand. */
+    transition: string;
+    /** The hover rule. */
+    hover: {
+        /** Extra selector filter appended after {@link NOT_DISABLED}, e.g. `:not([data-active="true"])`. */
+        filter?: string;
+        /** Declarations the hover state sets. */
+        declarations: string;
+    };
+    /**
+     * Extra declarations for the `:active` rule, ALONGSIDE the press scale.
+     *
+     * Appended to the one existing `:active` rule rather than emitted as a second
+     * one, so the held state stays a single declaration block with a single
+     * specificity — two rules for one state is how a press ends up half-applied
+     * depending on which selector happens to win.
+     */
+    pressDeclarations?: string;
+    /** `outline-offset` for the focus ring, in px. */
+    outlineOffset: number;
+    /** Rules appended verbatim, for a family-specific modifier class. */
+    extraRules?: string;
+}
+/**
+ * Build the stylesheet for one raw-DOM control family.
+ *
+ * Pure — the caller adopts the result, which is what makes it testable without
+ * a DOM.
+ */
+export declare function interactiveWebCss({ selector, varPrefix, base, transition, hover, pressDeclarations, outlineOffset, extraRules, }: InteractiveWebCssOptions): string;
+/**
+ * Adopt a control family's stylesheet once, on mount.
+ *
+ * `adoptStyleSheet` is idempotent and keyed by id, so every instance of a family
+ * calling this results in one adopted sheet.
+ */
+export declare function useInteractiveWebCss(styleId: string, css: string): void;
+//# sourceMappingURL=interactive-web-css.d.ts.map

package/lib/typescript/commonjs/styles/interactive-web-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-web-css.d.ts","sourceRoot":"","sources":["../../../../src/styles/interactive-web-css.ts"],"names":[],"mappings":"AAqCA;;;;GAIG;AACH,eAAO,MAAM,YAAY,kDAAgD,CAAC;AAE1E,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,KAAK,EAAE;QACL,oGAAoG;QACpG,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,yCAAyC;QACzC,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,UAAU,EACV,KAAK,EACL,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,EAAE,wBAAwB,GAAG,MAAM,CAmCnC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIvE"}

package/lib/typescript/commonjs/styles/pointer.d.ts

@@ -0,0 +1,11 @@
+export declare const IS_WEB_TOUCH_DEVICE: boolean;
+/**
+ * Whether a press-scale affordance should run at all on this target. True on
+ * native always, and on web only with a coarse pointer.
+ *
+ * This is the POINTER half of the decision — the OS "reduce motion" setting is
+ * the other half and is read per-component (it is a subscription, not a
+ * constant). Both are applied together inside `usePressAnimation`.
+ */
+export declare const SUPPORTS_PRESS_SCALE: boolean;
+//# sourceMappingURL=pointer.d.ts.map

package/lib/typescript/commonjs/styles/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../../../src/styles/pointer.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,mBAAmB,SAIgB,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,SAA+C,CAAC"}

package/lib/typescript/commonjs/styles/styled-primitives.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The react-native primitives wired for `className`, built ONCE at module scope.
+ *
+ * `className` is not a prop react-native understands. Under NativeWind v5 a
+ * consumer's babel/css-interop rewrites the `style` prop of JSX elements it sees
+ * in the CONSUMER's own source — which is why passing `className` as a bare prop
+ * (`{...({ className } as Record<string, string>)}`, the cast this module
+ * replaces) appeared to work: it works only under NW5, only for a primitive
+ * Bloom did not wrap, and it drops silently the moment either changes. Nothing
+ * errors; the class simply never resolves to a style.
+ *
+ * `styled()` from Bloom's own `react-native-css` dependency makes the mapping
+ * explicit and independent of the consumer's interop. Same reasoning, and the
+ * same silent failure if skipped, as `button/Button.tsx` and `Typography`.
+ *
+ * Built at module scope, not per render: an element type constructed during
+ * render is a new type every time, so React unmounts and remounts the whole
+ * subtree on each render.
+ *
+ * A component that also needs an animated value wraps ITS OWN
+ * `Animated.createAnimatedComponent(...)` around one of these — the shared
+ * versions stay unanimated so an element type is not created twice for the same
+ * primitive. `button/Button.tsx` is the reference.
+ */
+import type { ComponentType, Ref } from 'react';
+import { Image, Text, View, type ImageProps, type PressableProps, type StyleProp, type TextProps, type ViewProps, type ViewStyle } from 'react-native';
+/**
+ * `styled()` derives its mapping type from a dot-path union over the wrapped
+ * component's ENTIRE prop type, and the one over `PressableProps` overflows the
+ * checker (`TS2590: union type that is too complex to represent`). Narrowing is
+ * also honest: the function form of `style` is deliberately excluded, since
+ * NativeWind's css-interop swallows it and Bloom never uses it.
+ */
+type StyledPressableBase = Omit<PressableProps, 'style'> & {
+    style?: StyleProp<ViewStyle>;
+};
+/**
+ * The ARIA PROPERTIES react-native-web forwards to the DOM and React Native does
+ * not type at all.
+ *
+ * React Native types exactly five boolean `aria-*` STATES plus the four
+ * `aria-value*`, and folds them back into `accessibilityState`
+ * (`ViewAccessibility.d.ts` calls them "alias for accessibilityState"). A
+ * PROPERTY like `aria-haspopup` has no state to fold into and no native
+ * counterpart, so it is absent from RN's types — while react-native-web lists it
+ * in `forwardedProps` and `createDOMProps` writes it straight onto the element.
+ *
+ * Declared here rather than cast at the call site for the reason
+ * `styles/web-view-style.ts` spells out for its own RN/RNW gap: `as` only
+ * requires the two types to be COMPARABLE, so a cast accepts a typo'd attribute
+ * name and ships it as a prop nothing reads. An annotation keeps the key checked.
+ *
+ * Native ignores it — an unrecognised prop never reaches a native view config —
+ * so this needs no `Platform.OS` branch.
+ */
+export interface WebAriaProps {
+    /**
+     * What kind of surface this control opens. `menu` is the only value Bloom
+     * currently needs; the union is the ARIA one, narrowed to what is spellable.
+     */
+    'aria-haspopup'?: 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+}
+/**
+ * `ref` is on the PUBLISHED type and deliberately not on the one handed to
+ * `styled()`: adding it to the argument widens that dot-path union past the
+ * checker's limit again, and the mapping only ever names `className`. The same
+ * goes for {@link WebAriaProps}.
+ */
+export type StyledPressableProps = StyledPressableBase & WebAriaProps & {
+    ref?: Ref<View>;
+};
+/**
+ * `styled()` is declared as returning `any`, so these annotations are the whole
+ * type contract — including `ref`, which under React 19 is an ordinary prop that
+ * `useCssElement` spreads onto the wrapped primitive. Leaving it out made a
+ * measured node (a flyout's scroll box, a select option) a compile error while
+ * the runtime forwarded it fine.
+ */
+export declare const StyledView: ComponentType<ViewProps & {
+    ref?: Ref<View>;
+}>;
+export declare const StyledText: ComponentType<TextProps & {
+    ref?: Ref<Text>;
+}>;
+export declare const StyledImage: ComponentType<ImageProps & {
+    ref?: Ref<Image>;
+}>;
+export declare const StyledPressable: ComponentType<StyledPressableProps>;
+export {};
+//# sourceMappingURL=styled-primitives.d.ts.map

package/lib/typescript/commonjs/styles/styled-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styled-primitives.d.ts","sourceRoot":"","sources":["../../../../src/styles/styled-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EACL,KAAK,EAEL,IAAI,EACJ,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAGtB;;;;;;GAMG;AACH,KAAK,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG;IACzD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CACnE;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GACpD,YAAY,GAAG;IACb,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;CACjB,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,SAAS,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;CAAE,CAEpE,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,SAAS,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;CAAE,CAEpE,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,UAAU,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;CAAE,CAEvE,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,oBAAoB,CAG/D,CAAC"}

package/lib/typescript/commonjs/styles/tokens.d.ts

@@ -1,6 +1,21 @@
 /**
- * Spacing tokens following t-shirt size convention.
- * Compatible with ALF token naming.
+ * The t-shirt-keyed VIEW of `design-tokens/scales.ts`.
+ *
+ * Bloom addresses one physical scale in two vocabularies: class names use the
+ * numeric keys (`p-space-12`, `rounded-radius-20`) and inline RN styles use the
+ * t-shirt keys (`space.md`, `borderRadius.xl`). Both are needed — a className is
+ * inert on web without the consumer's Tailwind pipeline, and `atoms` has to work
+ * without one — but only ONE of them may own the numbers, or they disagree. They
+ * did: `borderRadius.full` was 999 against `radius-max` 9999, `borderRadius` had
+ * no 28 and `RADIUS` had no 16, and each file's own comments claimed to match the
+ * other. `scales.ts` is the authority (the Tailwind preset, `theme.css` and
+ * `tokens.json` are generated from it); everything below reads it by reference,
+ * so a rung cannot exist in one spelling and not the other.
+ *
+ * `fontSize`, `lineHeight`, `animation` and `gradients` stay declared here: the
+ * authority's `TYPOGRAPHY` is a ROLE scale (`body`, `caption`, `headerBold`) with
+ * its own sizes, not a raw ramp, so folding them together would be a type
+ * redesign rather than a reconciliation.
  */
 export declare const space: {
     readonly _2xs: 2;
@@ -39,7 +54,8 @@ export declare const lineHeight: {
     readonly relaxed: 1.625;
 };
 /**
- * Border radius tokens.
+ * Border radius tokens — the t-shirt view of `RADIUS`. `full` is the pill rung
+ * (`radius-max`); see `scales.ts` for why it is 9999 rather than 999.
  */
 export declare const borderRadius: {
     readonly _2xs: 2;
@@ -49,7 +65,8 @@ export declare const borderRadius: {
     readonly lg: 16;
     readonly xl: 20;
     readonly _2xl: 24;
-    readonly full: 999;
+    readonly _3xl: 28;
+    readonly full: 9999;
 };
 /**
  * Gradient definitions for icon system.
@@ -79,6 +96,26 @@ export declare const animation: {
             readonly tension: 120;
         };
     };
+    /**
+     * How far a HELD control shrinks. One number for the whole library.
+     *
+     * It used to be five, chosen per family — 0.97 on `Button` and `Tabs`, 0.95 on
+     * `Chip`, 0.94 on `Fab` and `FrostedIconButton`, 0.90 on `Checkbox` and
+     * `Radio` — each justified locally by the size of the target, which is a real
+     * argument and still produced a library where the same gesture reads as five
+     * different amounts of feedback. At 0.90 a checkbox visibly SQUASHES; that is
+     * the effect the value moved away from, and it was ten times deeper than the
+     * one that prompted the change.
+     *
+     * 0.99 is a tactile hint you feel rather than watch — roughly 0.4px on a 40dp
+     * button and 0.16px on a 16px checkbox. The suppression rules that decide
+     * whether it runs at all live in `hooks/use-press-animation.ts`.
+     *
+     * Declared here rather than beside the hook because the raw-DOM web forks need
+     * it too, and this module imports no react-native — a fork that renders through
+     * react-dom must not pull the RN runtime in behind a constant.
+     */
+    readonly pressScale: 0.99;
 };
 /**
  * Gradient definitions for icon system.

package/lib/typescript/commonjs/styles/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/styles/tokens.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;CAWR,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAEX;;GAEG;AACH;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;CAYZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;yBAOb,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;;yBAOvB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;CAGtB,CAAC"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/styles/tokens.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;CAWR,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX;;GAEG;AACH;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;IAYpB;;;;;;;;;;;;;;;;;;OAkBG;;CAEK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;yBAOb,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;;yBAOvB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;CAGtB,CAAC"}

package/lib/typescript/commonjs/styles/web-view-style.d.ts

@@ -66,5 +66,16 @@ export interface WebCssStyle extends ViewStyle {
     scrollbarColor?: string;
     /** RN declares this on `TextStyle`, not `ViewStyle`. */
     userSelect?: 'auto' | 'none' | 'text' | 'contain' | 'all';
+    /**
+     * CSS custom properties, for a component whose self-injected sheet reads a
+     * per-instance value it cannot know statically — a resolved theme colour in a
+     * `:focus-visible` ring, say. `Chip` is the reference.
+     *
+     * A PATTERN index signature, not an open one: it admits `--bloom-chip-ring`
+     * and nothing else, so this stays an escape hatch for custom properties rather
+     * than a hole that would let any misspelled style key through and undo the
+     * excess-property checking this interface exists for.
+     */
+    [customProperty: `--${string}`]: string | undefined;
 }
 //# sourceMappingURL=web-view-style.d.ts.map

package/lib/typescript/commonjs/styles/web-view-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-view-style.d.ts","sourceRoot":"","sources":["../../../../src/styles/web-view-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,EAAc,SAAS,CAAC,UAAU,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;CAC3D"}
+{"version":3,"file":"web-view-style.d.ts","sourceRoot":"","sources":["../../../../src/styles/web-view-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,EAAc,SAAS,CAAC,UAAU,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;IAC1D;;;;;;;;;OASG;IACH,CAAC,cAAc,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;CACrD"}

package/lib/typescript/commonjs/styles/z-index.d.ts

@@ -41,22 +41,4 @@ export declare const Z_INDEX: {
      */
     readonly portalRoot: 999999;
 };
-export declare const zIndex: {
-    /** Default resting level. */
-    readonly base: 0;
-    /** One step above an immediate sibling — a badge over its avatar. */
-    readonly raised: 1;
-    /** A control floating over the content it belongs to. */
-    readonly floating: 10;
-    /** A dropdown's INLINE trigger wrapper, still in the app's document flow. */
-    readonly dropdown: 40;
-    /** A bottom sheet's drag handle, over the sheet's own body. */
-    readonly sheetHandle: 100;
-    /**
-     * The document-level portal container itself (`#bloom-portal-root`). Overlay
-     * surfaces render INSIDE it and order among themselves by open order — none
-     * of them may claim this value, which is what made the sheet unbeatable.
-     */
-    readonly portalRoot: 999999;
-};
 //# sourceMappingURL=z-index.d.ts.map

package/lib/typescript/commonjs/styles/z-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"z-index.d.ts","sourceRoot":"","sources":["../../../../src/styles/z-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,OAAO;IAClB,6BAA6B;;IAE7B,qEAAqE;;IAErE,yDAAyD;;IAEzD,6EAA6E;;IAE7E,+DAA+D;;IAE/D;;;;OAIG;;CAEK,CAAC;AAEX,eAAO,MAAM,MAAM;IAlBjB,6BAA6B;;IAE7B,qEAAqE;;IAErE,yDAAyD;;IAEzD,6EAA6E;;IAE7E,+DAA+D;;IAE/D;;;;OAIG;;CAIwB,CAAC"}
+{"version":3,"file":"z-index.d.ts","sourceRoot":"","sources":["../../../../src/styles/z-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,OAAO;IAClB,6BAA6B;;IAE7B,qEAAqE;;IAErE,yDAAyD;;IAEzD,6EAA6E;;IAE7E,+DAA+D;;IAE/D;;;;OAIG;;CAEK,CAAC"}

package/lib/typescript/commonjs/subtle-hover/SubtleHover.d.ts

@@ -1,21 +1,4 @@
-import { type StyleProp, type ViewStyle } from 'react-native';
-export interface SubtleHoverProps {
-    /**
-     * JS-driven visibility for a coordinated highlight — e.g. every post of one
-     * thread lighting up together. When omitted, the wash instead follows CSS
-     * `group-hover` on web with ZERO React state: the parent element must carry
-     * `className="group"`.
-     */
-    active?: boolean;
-    /** Extra style merged last — e.g. `borderRadius` to match the parent. */
-    style?: StyleProp<ViewStyle>;
-    /**
-     * Render on native too (default `false`). Hover is a web pointer affordance,
-     * so the CSS `group-hover` mode is web-only; native only shows the wash in the
-     * JS `active` mode, and only when this is set.
-     */
-    native?: boolean;
-}
+import type { SubtleHoverProps } from './types';
 /**
  * An absolutely-positioned, non-interactive contrast wash. Two modes:
  *

package/lib/typescript/commonjs/subtle-hover/SubtleHover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubtleHover.d.ts","sourceRoot":"","sources":["../../../../src/subtle-hover/SubtleHover.tsx"],"names":[],"mappings":"AACA,OAAO,EAA8B,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAe1F,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,gBAAgB,kDAoC9E;yBApCe,WAAW"}
+{"version":3,"file":"SubtleHover.d.ts","sourceRoot":"","sources":["../../../../src/subtle-hover/SubtleHover.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,gBAAgB,kDAiC9E;yBAjCe,WAAW"}

package/lib/typescript/commonjs/subtle-hover/index.d.ts

@@ -1,3 +1,3 @@
 export { SubtleHover } from './SubtleHover';
-export type { SubtleHoverProps } from './SubtleHover';
+export type { SubtleHoverProps } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/subtle-hover/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/subtle-hover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/subtle-hover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/commonjs/subtle-hover/types.d.ts

@@ -0,0 +1,19 @@
+import { type StyleProp, type ViewStyle } from 'react-native';
+export interface SubtleHoverProps {
+    /**
+     * JS-driven visibility for a coordinated highlight — e.g. every post of one
+     * thread lighting up together. When omitted, the wash instead follows CSS
+     * `group-hover` on web with ZERO React state: the parent element must carry
+     * `className="group"`.
+     */
+    active?: boolean;
+    /** Extra style merged last — e.g. `borderRadius` to match the parent. */
+    style?: StyleProp<ViewStyle>;
+    /**
+     * Render on native too (default `false`). Hover is a web pointer affordance,
+     * so the CSS `group-hover` mode is web-only; native only shows the wash in the
+     * JS `active` mode, and only when this is set.
+     */
+    native?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/subtle-hover/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/subtle-hover/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/lib/typescript/commonjs/surfaces/SurfaceHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SurfaceHost.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/SurfaceHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAKN,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAYnD,KAAK,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AAgCxD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe;;;;;;uBA8FhB;YAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;SAAE;;;EAcrE"}
+{"version":3,"file":"SurfaceHost.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/SurfaceHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAKN,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAYnD,KAAK,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AAsCxD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe;;;;;;uBAiGhB;YAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;SAAE;;;EAcrE"}

package/lib/typescript/commonjs/surfaces/api.d.ts

@@ -1,5 +1,5 @@
-import { dismissAll, dismissToRoot, present } from './surfaceStore';
-import { confirm, prompt } from './prompts';
+import { dismissAll, dismissToRoot, present } from './surface-store';
+import { alert, confirm, prompt } from './prompts';
 import type { PresentOptions, SurfaceRenderFn } from './types';
 /**
  * Dismiss the TOP surface, resolving its `present()` promise with `result`.
@@ -13,13 +13,19 @@ declare function dismiss(result?: unknown): void;
  */
 declare function dismissById(id: string, result?: unknown): void;
 /**
- * The shared imperative surface-stack API — a module singleton (mirrors
- * `alert()`'s shape) so any consumer, in the SDK or an app, presents into the
- * SAME coordinated Bloom stack from anywhere without threading a provider.
+ * The shared imperative surface-stack API — a module singleton, so any consumer,
+ * in the SDK or an app, presents into the SAME coordinated Bloom stack from
+ * anywhere without threading a provider.
  *
- * Exposed at the package root as `surfaces` (avoids a bare `present`/`confirm`
- * name clash with the existing `alert-dialog` `confirm`); the individual
- * functions are also named exports of `@oxyhq/bloom/surfaces` for direct import.
+ * It is the ONLY imperative overlay API in the package. `alert()` and
+ * `confirm()` used to be two further module-scope FIFO queues with hosts of
+ * their own (`dialog/alert-store` + `BloomDialogProvider`,
+ * `alert-dialog/confirm-store` + `AlertDialogHost`); both are gone and both now
+ * present here.
+ *
+ * Exposed at the package root as `surfaces`, and — for `alert`/`confirm` — as
+ * bare names too; every member is also a named export of
+ * `@oxyhq/bloom/surfaces` for direct import.
  */
 export declare const surfaces: {
     /** Present a new surface on top. Resolves with the dismissal result. */
@@ -32,10 +38,12 @@ export declare const surfaces: {
     readonly dismissToRoot: typeof dismissToRoot;
     /** Dismiss the entire stack (resolves pending awaiters with `undefined`). */
     readonly dismissAll: typeof dismissAll;
+    /** Present an alert surface (React Native's `Alert.alert` signature). */
+    readonly alert: typeof alert;
     /** Present a confirm surface; resolves `true`/`false`. */
     readonly confirm: typeof confirm;
     /** Present a prompt surface; resolves the string or `null`. */
     readonly prompt: typeof prompt;
 };
-export { confirm, dismiss, dismissAll, dismissById, dismissToRoot, present, prompt };
+export { alert, confirm, dismiss, dismissAll, dismissById, dismissToRoot, present, prompt };
 //# sourceMappingURL=api.d.ts.map

package/lib/typescript/commonjs/surfaces/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,aAAa,EAEb,OAAO,EAER,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/D;;;GAGG;AACH,iBAAS,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAEvC;AAED;;;;GAIG;AACH,iBAAS,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAEvD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ;IACnB,wEAAwE;uBAC9D,MAAM,oBAAoB,eAAe,SAAS,cAAc;IAE1E,+BAA+B;;IAE/B,wCAAwC;;IAExC,iDAAiD;;IAEjD,6EAA6E;;IAE7E,0DAA0D;;IAE1D,+DAA+D;;CAEvD,CAAC;AAEX,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,aAAa,EAEb,OAAO,EAER,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/D;;;GAGG;AACH,iBAAS,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAEvC;AAED;;;;GAIG;AACH,iBAAS,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAEvD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ;IACnB,wEAAwE;uBAC9D,MAAM,oBAAoB,eAAe,SAAS,cAAc;IAE1E,+BAA+B;;IAE/B,wCAAwC;;IAExC,iDAAiD;;IAEjD,6EAA6E;;IAE7E,yEAAyE;;IAEzE,0DAA0D;;IAE1D,+DAA+D;;CAEvD,CAAC;AAEX,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/lib/typescript/commonjs/surfaces/index.d.ts

@@ -19,7 +19,7 @@ declare const SurfaceHost: {
     displayName: string;
 };
 export { SurfaceHost, SurfaceProvider };
-export { surfaces, present, dismiss, dismissById, dismissToRoot, dismissAll, confirm, prompt, } from './api';
-export { useSurface } from './useSurface';
-export type { SurfacePresentation, PresentOptions, SurfaceControls, SurfaceRenderFn, SurfaceStatus, SurfaceEntry, SurfaceConfirmOptions, SurfacePromptOptions, } from './types';
+export { surfaces, present, dismiss, dismissById, dismissToRoot, dismissAll, alert, confirm, prompt, } from './api';
+export { useSurface } from './use-surface';
+export type { SurfacePresentation, PresentOptions, SurfaceControls, SurfaceRenderFn, SurfaceStatus, SurfaceEntry, AlertButton, AlertButtonStyle, SurfaceConfirmOptions, SurfacePromptOptions, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/surfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,QAAA,MAAQ,WAAW;;;GAAE,eAAe;;;;;CAA8B,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,EACX,aAAa,EACb,UAAU,EACV,OAAO,EACP,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,QAAA,MAAQ,WAAW;;;GAAE,eAAe;;;;;CAA8B,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,EACX,aAAa,EACb,UAAU,EACV,KAAK,EACL,OAAO,EACP,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/lib/typescript/commonjs/surfaces/index.web.d.ts

@@ -14,7 +14,7 @@ declare const SurfaceHost: {
     displayName: string;
 };
 export { SurfaceHost, SurfaceProvider };
-export { surfaces, present, dismiss, dismissById, dismissToRoot, dismissAll, confirm, prompt, } from './api';
-export { useSurface } from './useSurface';
-export type { SurfacePresentation, PresentOptions, SurfaceControls, SurfaceRenderFn, SurfaceStatus, SurfaceEntry, SurfaceConfirmOptions, SurfacePromptOptions, } from './types';
+export { surfaces, present, dismiss, dismissById, dismissToRoot, dismissAll, alert, confirm, prompt, } from './api';
+export { useSurface } from './use-surface';
+export type { SurfacePresentation, PresentOptions, SurfaceControls, SurfaceRenderFn, SurfaceStatus, SurfaceEntry, AlertButton, AlertButtonStyle, SurfaceConfirmOptions, SurfacePromptOptions, } from './types';
 //# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/commonjs/surfaces/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/index.web.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,QAAA,MAAQ,WAAW;;;GAAE,eAAe;;;;;CAA8B,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,EACX,aAAa,EACb,UAAU,EACV,OAAO,EACP,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/index.web.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,QAAA,MAAQ,WAAW;;;GAAE,eAAe;;;;;CAA8B,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,EACX,aAAa,EACb,UAAU,EACV,KAAK,EACL,OAAO,EACP,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/lib/typescript/commonjs/surfaces/prompts.d.ts

@@ -1,4 +1,20 @@
-import type { SurfaceConfirmOptions, SurfacePromptOptions } from './types';
+import type { AlertButton, SurfaceConfirmOptions, SurfacePromptOptions } from './types';
+/**
+ * Show a Bloom-styled alert. Mirrors React Native's
+ * `Alert.alert(title, message?, buttons?)` signature, so existing call sites
+ * migrate by changing the import only. With no buttons, a single `OK` is
+ * rendered.
+ *
+ * ```tsx
+ * import { alert } from '@oxyhq/bloom';
+ *
+ * alert('Sign out?', 'You will need to enter your password to sign in again.', [
+ *   { text: 'Cancel', style: 'cancel' },
+ *   { text: 'Sign out', style: 'destructive', onPress: doSignOut },
+ * ]);
+ * ```
+ */
+export declare function alert(title: string, message?: string, buttons?: AlertButton[]): void;
 /**
  * Present a confirm surface stacked on top of anything currently open. Resolves
  * `true` on confirm, `false` on cancel OR on backdrop/Escape/back dismissal.

package/lib/typescript/commonjs/surfaces/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/prompts.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAyIjB;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CASxE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS5E"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/prompts.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAmCjB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,EAAE,GACtB,IAAI,CAqBN;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BxE;AAsDD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW5E"}

package/lib/typescript/commonjs/surfaces/surface-store.d.ts

@@ -0,0 +1,51 @@
+import type { PresentOptions, SurfaceEntry, SurfaceRenderFn } from './types';
+/** Subscribe to stack changes. Returns an unsubscribe fn. */
+export declare function subscribe(listener: () => void): () => void;
+/** Current stack snapshot (stable ref while unchanged). Bottom→top. */
+export declare function getSnapshot(): readonly SurfaceEntry[];
+/**
+ * Present a new surface on TOP of the stack. Returns a promise that resolves
+ * with the value passed to `dismiss(result)` (or `undefined` when the surface is
+ * dismissed without a result / by a stack-wide clear).
+ */
+export declare function present<Result = unknown>(render: SurfaceRenderFn, opts?: PresentOptions): Promise<Result>;
+/**
+ * Request dismissal of a surface. RESOLVES THE PROMISE IMMEDIATELY (the exit
+ * animation that follows is cosmetic) and flips the entry to `'closing'` so the
+ * host runs its exit animation. Resolution is resolve-once via the `settled`
+ * guard — a second request (or the host's post-exit `onClose`) never re-resolves
+ * with a different value. Bumps the entry `generation` so a completion callback
+ * from a superseded cycle is inert.
+ */
+export declare function requestDismiss(id: string, result?: unknown): void;
+/**
+ * Splice a surface out of the stack once its exit animation has settled. Called
+ * by the host from the `Dialog`'s post-exit `onClose`. Idempotent and gated on
+ * `'closing'` status: a stale/duplicate call — or one for an entry that is not
+ * actually closing — is a no-op, which (together with unique entry ids) is the
+ * stale-callback hygiene `BottomSheetBase`'s generation guard provides for its
+ * reused instance.
+ */
+export declare function finalizeClose(id: string): void;
+/** Dismiss the TOP surface, resolving its promise with `result`. */
+export declare function dismissTop(result?: unknown): void;
+/**
+ * Dismiss every surface ABOVE the bottom-most one, keeping the root surface
+ * open. Pending awaiters of the dismissed surfaces resolve with `undefined` so
+ * they never hang. No-op with 0 or 1 surfaces.
+ */
+export declare function dismissToRoot(): void;
+/**
+ * Dismiss the ENTIRE stack. Every pending awaiter resolves with `undefined` so
+ * none hang.
+ */
+export declare function dismissAll(): void;
+/**
+ * Hard-reset the stack synchronously (no exit animation), resolving all pending
+ * awaiters with `undefined`. Used when the host provider unmounts so no
+ * `present()` promise is stranded.
+ */
+export declare function resetSurfaces(): void;
+/** Test-only: hard-reset without notifying (drops listeners' work). */
+export declare function __resetSurfacesForTests(): void;
+//# sourceMappingURL=surface-store.d.ts.map

package/lib/typescript/commonjs/surfaces/surface-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-store.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/surface-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EAChB,MAAM,SAAS,CAAC;AAoCjB,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK1D;AAED,uEAAuE;AACvE,wBAAgB,WAAW,IAAI,SAAS,YAAY,EAAE,CAErD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,GAAG,OAAO,EACtC,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAmBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAM9C;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAQpC;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}