@oxyhq/bloom 0.54.1 → 0.56.0

package/lib/typescript/module/provider/scroll-provider.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Native/default binding for the scroll-restoration provider used by
+ * {@link BloomProvider}.
+ *
+ * `@oxyhq/bloom/scroll` is web-forked, so its `browser` export condition hands
+ * web consumers the real implementation while native gets the no-op. A compiled
+ * `lib/module/provider/index.js` cannot benefit from that condition (it imports
+ * a relative path, not the package subpath), so the platform choice is made
+ * here by FILENAME instead: Metro picks `scroll-provider.web.ts` on web, and
+ * every web bundler that resolves `.web.js` picks the compiled sibling. Same
+ * mechanism the toast engine uses for `ToastHost.native.tsx`.
+ */
+export { ScrollRestorationProvider } from '../scroll';
+//# sourceMappingURL=scroll-provider.d.ts.map

package/lib/typescript/module/provider/scroll-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-provider.d.ts","sourceRoot":"","sources":["../../../../src/provider/scroll-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC"}

package/lib/typescript/module/provider/scroll-provider.web.d.ts

@@ -0,0 +1,3 @@
+/** Web binding for {@link BloomProvider}'s scroll-restoration provider — see `./scroll-provider.ts`. */
+export { ScrollRestorationProvider } from '../scroll/index.web';
+//# sourceMappingURL=scroll-provider.web.d.ts.map

package/lib/typescript/module/provider/scroll-provider.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-provider.web.d.ts","sourceRoot":"","sources":["../../../../src/provider/scroll-provider.web.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/typescript/module/toast/ToastRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToastRow.d.ts","sourceRoot":"","sources":["../../../../src/toast/ToastRow.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA4B/B,OAAO,KAAK,EAEV,aAAa,EAEb,QAAQ,EACR,WAAW,EACZ,MAAM,SAAS,CAAC;AAwDjB,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAHR,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI;kCAiVzC,CAAC"}
+{"version":3,"file":"ToastRow.d.ts","sourceRoot":"","sources":["../../../../src/toast/ToastRow.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA6B/B,OAAO,KAAK,EAEV,aAAa,EAEb,QAAQ,EACR,WAAW,EACZ,MAAM,SAAS,CAAC;AAwDjB,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAHR,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI;kCAuWzC,CAAC"}

package/lib/typescript/module/toast/ToastSwipeHandler.d.ts

@@ -14,6 +14,10 @@
  * covers `toast.custom` JSX and `unstyled` rows too, which never reach that
  * card. Every distance the gesture measures is a fraction of the capped
  * `rowWidth`, not of the window — see the constant.
+ *
+ * W13 — being THE row box also makes it the hover target: `useStackHover`'s
+ * handlers go here so a pointer over ANY row counts as a pointer over the stack.
+ * The handlers are empty on native.
  */
 import * as React from 'react';
 import { type ViewStyle } from 'react-native';

package/lib/typescript/module/toast/ToastSwipeHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToastSwipeHandler.d.ts","sourceRoot":"","sources":["../../../../src/toast/ToastSwipeHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAetB,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAWzD,KAAK,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG;IAC5D,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CACtC,KAAK,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CAuJhD,CAAC"}
+{"version":3,"file":"ToastSwipeHandler.d.ts","sourceRoot":"","sources":["../../../../src/toast/ToastSwipeHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAetB,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAYzD,KAAK,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG;IAC5D,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CACtC,KAAK,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CA8JhD,CAAC"}

package/lib/typescript/module/toast/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/toast/constants.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,mBAAmB,QAAqB,CAAC;AAEtD,qGAAqG;AACrG,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB,EAAE,mBAAmB,CAAC;IAC7C,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;CA8B3B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/toast/constants.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,mBAAmB,QAAqB,CAAC;AAEtD,qGAAqG;AACrG,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB,EAAE,mBAAmB,CAAC;IAC7C,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;CA+C3B,CAAC"}

package/lib/typescript/module/toast/toast-store.d.ts

@@ -20,10 +20,25 @@ declare class ToastStore {
     private pendingPromises;
     private collapseCooldown;
     private collapseCooldownTimeout;
+    private expansionHold;
     subscribe: (callback: Subscriber) => () => void;
     /** Stable while nothing has changed — safe as a `useSyncExternalStore` snapshot. */
     getSnapshot: () => ToastStoreState;
     setConfig: (config: ToastStoreConfig) => void;
+    /**
+     * Something outside the store can HOLD an expanded stack open — on web, a pointer
+     * resting on it. Registered by the platform trigger (`use-stack-hover`) so this
+     * module stays pure JS with no DOM and no platform branch; native registers
+     * nothing and the predicate stays `null`.
+     *
+     * It is asked at DECISION time rather than tracked as state on purpose: a row can
+     * stop being under the pointer with no event at all — rows unmount under the
+     * cursor and move under a stationary one, and neither fires `pointerleave` —
+     * so any cached boolean goes stale. Nothing renders from this, so it is
+     * deliberately not part of the snapshot.
+     */
+    setExpansionHold: (hold: (() => boolean) | null) => void;
+    private isHeldOpen;
     private notify;
     private cloneIndex;
     private resolveDuration;

package/lib/typescript/module/toast/toast-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-store.d.ts","sourceRoot":"","sources":["../../../../src/toast/toast-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,KAAK,UAAU,GAAG,MAAM,IAAI,CAAC;AAK7B,cAAM,UAAU;IACd,OAAO,CAAC,KAAK,CAQX;IAEF,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,kBAAkB,CAA8C;IACxE,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,uBAAuB,CAA8C;IAE7E,SAAS,GAAI,UAAU,UAAU,gBAK/B;IAEF,oFAAoF;IACpF,WAAW,QAAO,eAAe,CAE/B;IAEF,SAAS,GAAI,QAAQ,gBAAgB,UAEnC;IAEF,OAAO,CAAC,MAAM,CAEZ;IAEF,OAAO,CAAC,UAAU,CAEhB;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF,OAAO,CAAC,iBAAiB,CAQvB;IAEF,UAAU,GAAI,IAAI,MAAM,GAAG,MAAM,UAE/B;IAEF,WAAW,GAAI,IAAI,MAAM,GAAG,MAAM,UAEhC;IAEF,cAAc,aAEZ;IAEF,eAAe,aAEb;IAEF,OAAO,CAAC,aAAa,CAwCnB;IAEF,QAAQ,GACN,SAAS,IAAI,CACX,UAAU,EACV,IAAI,GAAG,gBAAgB,GAAG,OAAO,GAAG,iBAAiB,CACtD,GAAG;QACF,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACtB,KACA,MAAM,GAAG,MAAM,CAkHhB;IAEF,wCAAwC;IACxC,YAAY,GACV,IAAI,MAAM,GAAG,MAAM,GAAG,SAAS,EAC/B,SAAS,WAAW,GAAG,aAAa,KACnC,MAAM,GAAG,MAAM,GAAG,SAAS,CAsE5B;IAEF,4EAA4E;IAC5E,OAAO,CAAC,mBAAmB,CAazB;IAEF,WAAW,GAAI,IAAI,MAAM,GAAG,MAAM,UAahC;IAEF,WAAW,GACT,IAAI,MAAM,GAAG,MAAM,KAClB,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,SAAS,CAE7C;IAEF,cAAc,GAAI,IAAI,MAAM,GAAG,MAAM,EAAE,QAAQ,MAAM,UAWnD;IAEF,MAAM,aAOJ;IAEF,QAAQ,aAiBN;IAEF,YAAY,aAUV;CACH;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}
+{"version":3,"file":"toast-store.d.ts","sourceRoot":"","sources":["../../../../src/toast/toast-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,KAAK,UAAU,GAAG,MAAM,IAAI,CAAC;AAK7B,cAAM,UAAU;IACd,OAAO,CAAC,KAAK,CAQX;IAEF,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,kBAAkB,CAA8C;IACxE,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,uBAAuB,CAA8C;IAC7E,OAAO,CAAC,aAAa,CAAgC;IAErD,SAAS,GAAI,UAAU,UAAU,gBAK/B;IAEF,oFAAoF;IACpF,WAAW,QAAO,eAAe,CAE/B;IAEF,SAAS,GAAI,QAAQ,gBAAgB,UAEnC;IAEF;;;;;;;;;;;OAWG;IACH,gBAAgB,GAAI,MAAM,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,UAE9C;IAEF,OAAO,CAAC,UAAU,CAAkD;IAEpE,OAAO,CAAC,MAAM,CAEZ;IAEF,OAAO,CAAC,UAAU,CAEhB;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF,OAAO,CAAC,iBAAiB,CAQvB;IAEF,UAAU,GAAI,IAAI,MAAM,GAAG,MAAM,UAE/B;IAEF,WAAW,GAAI,IAAI,MAAM,GAAG,MAAM,UAEhC;IAEF,cAAc,aAEZ;IAEF,eAAe,aAEb;IAEF,OAAO,CAAC,aAAa,CAwCnB;IAEF,QAAQ,GACN,SAAS,IAAI,CACX,UAAU,EACV,IAAI,GAAG,gBAAgB,GAAG,OAAO,GAAG,iBAAiB,CACtD,GAAG;QACF,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACtB,KACA,MAAM,GAAG,MAAM,CAkHhB;IAEF,wCAAwC;IACxC,YAAY,GACV,IAAI,MAAM,GAAG,MAAM,GAAG,SAAS,EAC/B,SAAS,WAAW,GAAG,aAAa,KACnC,MAAM,GAAG,MAAM,GAAG,SAAS,CAyF5B;IAEF,4EAA4E;IAC5E,OAAO,CAAC,mBAAmB,CAazB;IAEF,WAAW,GAAI,IAAI,MAAM,GAAG,MAAM,UAahC;IAEF,WAAW,GACT,IAAI,MAAM,GAAG,MAAM,KAClB,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,SAAS,CAE7C;IAEF,cAAc,GAAI,IAAI,MAAM,GAAG,MAAM,EAAE,QAAQ,MAAM,UAWnD;IAEF,MAAM,aAOJ;IAEF,QAAQ,aAiBN;IAEF,YAAY,aAUV;CACH;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/lib/typescript/module/toast/use-stack-hover.d.ts

@@ -0,0 +1,55 @@
+/**
+ * How long a leave waits for a neighbouring row to claim the pointer. One frame is
+ * enough for the same-tick leave/enter pair a row crossing produces; this is a
+ * little more so a slow frame cannot flash the stack shut. Exported so the suite
+ * asserts against the real value rather than a copy of it.
+ */
+export declare const HOVER_LEAVE_GRACE = 80;
+type HoverEvent = {
+    nativeEvent: {
+        pointerType?: string;
+    };
+};
+/**
+ * Whether the pointer is over the stack RIGHT NOW.
+ *
+ * Two sources, and both are load-bearing:
+ *
+ *  - the `hovered` latch answers "a mouse entered and has not left", which is the
+ *    only thing available where there is no DOM (jest runs on `testEnvironment:
+ *    'node'`), and is a cheap early-out.
+ *  - the live `:hover` query answers "a row is under the pointer", which the latch
+ *    CANNOT: a row can stop being hovered with no event whatsoever. Measured — a row
+ *    culled by `visibleToasts` under a stationary cursor fires no `pointerleave`,
+ *    `pointerout` or `mouseleave` at all, and the restack then slides the remaining
+ *    rows out from under the pointer. A latch alone therefore sticks TRUE, which
+ *    would disable the press toggle for the rest of the session and suppress every
+ *    later auto-collapse.
+ *
+ * Requiring both means a stale latch is corrected by the DOM and a stray DOM match
+ * (a pen, a touch) is rejected by the latch.
+ *
+ * COVERAGE, stated plainly: jest cannot see the DOM half at all
+ * (`testEnvironment: 'node'`), and a browser cannot isolate it either — its two
+ * consequences are a press toggle standing down (unreachable with a mouse, which
+ * always hovers what it presses) and a suppressed auto-collapse (which the deferred
+ * leave below independently corrects the moment any boundary event fires). Both
+ * halves are kept because each is measurably more accurate than the other alone, not
+ * because a test proves the composite.
+ *
+ * `ToastRow` asks so a press does not TOGGLE what hover already opened, and
+ * `toastStore` asks before auto-collapsing a stack down to its last row. The press
+ * still runs the toast's own `onPress`; only the expansion toggle steps aside.
+ */
+export declare function isStackHovered(): boolean;
+export type StackHoverProps = {
+    onPointerEnter: (event: HoverEvent) => void;
+    onPointerLeave: (event: HoverEvent) => void;
+};
+export declare function useStackHover({ enableStacking, }: {
+    enableStacking: boolean;
+}): StackHoverProps;
+/** Test-only reset: the module state outlives a render tree, so a suite must clear it. */
+export declare function resetStackHoverForTests(): void;
+export {};
+//# sourceMappingURL=use-stack-hover.d.ts.map

package/lib/typescript/module/toast/use-stack-hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stack-hover.d.ts","sourceRoot":"","sources":["../../../../src/toast/use-stack-hover.ts"],"names":[],"mappings":"AAwCA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAKpC,KAAK,UAAU,GAAG;IAAE,WAAW,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAc5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAwBD,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,wBAAgB,aAAa,CAAC,EAC5B,cAAc,GACf,EAAE;IACD,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,eAAe,CA4ClB;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/lib/typescript/module/toast/use-stack-hover.native.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Bloom-original — NATIVE. Metro resolves this over `use-stack-hover.ts` on iOS and
+ * Android, the same filename split `ToastHost.native.tsx` uses.
+ *
+ * Native keeps PRESS as the only way to expand a stack, so this hands back no
+ * handlers at all. Two reasons it is a fork rather than a runtime `Platform` check:
+ * the web file's module-level hover state and its `setTimeout` have no business
+ * existing in a native bundle, and `onPointerEnter`/`onPointerLeave` DO fire on
+ * native for touch (RN's pointer events unify touch and mouse), which would make
+ * every tap expand-then-collapse while the press toggle fired as well.
+ *
+ * Keep the shape identical to the web file — `ToastSwipeHandler` spreads whatever
+ * this returns onto the row box, and `ToastRow` calls `isStackHovered()`
+ * unconditionally.
+ */
+export type StackHoverProps = Record<string, never>;
+/** Parity with the web file's export; nothing here waits for anything. */
+export declare const HOVER_LEAVE_GRACE = 0;
+/** Nothing hovers on a touch screen. */
+export declare function isStackHovered(): boolean;
+export declare function useStackHover(_options: {
+    enableStacking: boolean;
+}): StackHoverProps;
+/** Parity with the web file so the shared suite can call it on either platform. */
+export declare function resetStackHoverForTests(): void;
+//# sourceMappingURL=use-stack-hover.native.d.ts.map

package/lib/typescript/module/toast/use-stack-hover.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stack-hover.native.d.ts","sourceRoot":"","sources":["../../../../src/toast/use-stack-hover.native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEpD,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,wCAAwC;AACxC,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAKD,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,GAAG,eAAe,CAEpF;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,IAAI,IAAI,CAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "0.54.1",
+  "version": "0.56.0",
   "description": "Bloom UI — Oxy ecosystem component library for React Native + Expo + Web",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -28,6 +28,17 @@
         "default": "./lib/commonjs/index.js"
       }
     },
+    "./provider": {
+      "react-native": "./src/provider/index.tsx",
+      "import": {
+        "types": "./lib/typescript/module/provider/index.d.ts",
+        "default": "./lib/module/provider/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/provider/index.d.ts",
+        "default": "./lib/commonjs/provider/index.js"
+      }
+    },
     "./surfaces": {
       "react-native": "./src/surfaces/index.ts",
       "browser": {

package/src/__tests__/BloomProvider.web.test.tsx

@@ -0,0 +1,114 @@
+/**
+ * @jest-environment jsdom
+ */
+
+// `BloomProvider` exists so an app mounts ONE Bloom root instead of five, and
+// the concrete bug that motivated it is web-only: `useScrollRestoration()`
+// THROWS outside `ScrollRestorationProvider`, so anything scrollable that an
+// app renders beside — rather than under — that provider crashes the screen.
+//
+// These tests therefore assert the WEB binding: `provider/scroll-provider` is
+// mapped to the web implementation the same way a web bundler resolves the
+// `.web` sibling (jest has no platform-extension resolution of its own, so
+// without this mapping the suite would silently exercise the native no-op and
+// pass no matter what).
+
+import { createElement, type ReactNode } from 'react';
+import { act } from 'react';
+import { createRoot, type Root } from 'react-dom/client';
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT =
+  true;
+
+// Only the two navigation hooks `scroll/index.web` consumes; `virtual` keeps
+// the real (native-heavy) expo-router off the resolver.
+jest.mock(
+  'expo-router',
+  () => {
+    const react = jest.requireActual<typeof import('react')>('react');
+    return {
+      useFocusEffect: (effect: () => undefined | (() => void)) => {
+        react.useEffect(effect, [effect]);
+      },
+      useRoute: () => ({ key: 'route-test', name: 'Test', params: {} }),
+    };
+  },
+  { virtual: true },
+);
+
+// What a web bundler does with `provider/scroll-provider.web.ts`.
+jest.mock('../provider/scroll-provider', () => ({
+  ScrollRestorationProvider:
+    jest.requireActual<typeof import('../scroll/index.web')>('../scroll/index.web')
+      .ScrollRestorationProvider,
+}));
+
+// Imported AFTER the mocks are registered.
+import { BloomProvider } from '../provider';
+import { useImageResolver } from '../image-resolver';
+import { useScrollRestoration } from '../scroll/index.web';
+
+/**
+ * Stands in for any Bloom-consuming scrollable an app renders under the root —
+ * a feed, a right-rail replies list, an overlay.
+ */
+function Scrollable({ onResolve }: { onResolve?: (url: string | undefined) => void }): ReactNode {
+  useScrollRestoration('window');
+  const resolver = useImageResolver();
+  onResolve?.(resolver?.('file-id', 'avatar'));
+  return null;
+}
+
+function render(node: ReactNode): { root: Root; container: HTMLElement } {
+  const container = document.createElement('div');
+  document.body.appendChild(container);
+  const root = createRoot(container);
+  act(() => {
+    root.render(node);
+  });
+  return { root, container };
+}
+
+function unmount({ root, container }: { root: Root; container: HTMLElement }): void {
+  act(() => {
+    root.unmount();
+  });
+  container.remove();
+}
+
+describe('BloomProvider (web)', () => {
+  it('provides scroll restoration to everything below it', () => {
+    let resolved: string | undefined;
+    let mounted: { root: Root; container: HTMLElement } | undefined;
+
+    expect(() => {
+      mounted = render(
+        createElement(BloomProvider, {
+          fonts: false,
+          imageResolver: (id: string, variant?: string) => `${id}:${variant}`,
+          children: createElement(Scrollable, { onResolve: (url) => { resolved = url; } }),
+        }),
+      );
+    }).not.toThrow();
+
+    // The image resolver reaches the same subtree — one root, every context.
+    expect(resolved).toBe('file-id:avatar');
+
+    if (mounted) unmount(mounted);
+  });
+
+  // Vacuity guard: proves the assertion above is actually load-bearing. If the
+  // provider ever stops mounting the WEB scroll provider (a bad platform
+  // binding, a dropped nesting level) this control case is what makes the test
+  // above meaningful — remove the provider and the very same child throws.
+  it('is what keeps the hook from throwing — the same child crashes without it', () => {
+    const consoleError = jest.spyOn(console, 'error').mockImplementation(() => undefined);
+    try {
+      expect(() => render(createElement(Scrollable, {}))).toThrow(
+        /useScrollRestoration must be used within a <ScrollRestorationProvider>/,
+      );
+    } finally {
+      consoleError.mockRestore();
+    }
+  });
+});