@userflow-tech/react-native 0.1.1 → 0.3.0

package/lib/typescript/commonjs/src/pairing/tokenStorage.d.ts

@@ -1,11 +1,23 @@
 /**
- * Persist the pairing JWT for reconnect within the current app session.
- * Cleared on SDK init / exit preview / app restart (pairing exits on restart).
+ * Persist the pairing JWT so a relaunch can resume Builder pairing until the
+ * token expires or preview is exited. Resume requires `expo-secure-store`;
+ * the in-memory fallback does not survive a process restart.
  */
+import type { PairingPurpose } from '@userflow-tech/core';
+export declare const PAIRING_TOKEN_STORAGE_KEY = "userflow.pairingToken";
+export declare const PAIRING_PURPOSE_STORAGE_KEY = "userflow.pairingPurpose";
 export interface PairingTokenStore {
     get(): Promise<string | null>;
     set(token: string): Promise<void>;
+    /** Clears the token and its purpose. */
     clear(): Promise<void>;
+    /**
+     * Purpose of the link that wrote the token, so a resume keeps the same
+     * preview chrome. Optional so custom stores keep working; a store without
+     * it resumes with no purpose.
+     */
+    getPurpose?(): Promise<PairingPurpose | null>;
+    setPurpose?(purpose: PairingPurpose | null): Promise<void>;
 }
 /** In-memory store used when SecureStore is unavailable (and in tests). */
 export declare function createMemoryPairingTokenStore(): PairingTokenStore;
@@ -13,4 +25,6 @@ export declare function createMemoryPairingTokenStore(): PairingTokenStore;
  * Prefer expo-secure-store (Keychain / Keystore); fall back to memory.
  */
 export declare function createPairingTokenStore(): PairingTokenStore;
+/** @internal Resets module cache between tests. */
+export declare function resetPairingTokenStoreCacheForTests(): void;
 //# sourceMappingURL=tokenStorage.d.ts.map

package/lib/typescript/commonjs/src/pairing/tokenStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenStorage.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/tokenStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAkBD,2EAA2E;AAC3E,wBAAgB,6BAA6B,IAAI,iBAAiB,CAajE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CA2B3D"}
+{"version":3,"file":"tokenStorage.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/tokenStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AACjE,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,wCAAwC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AA0CD,2EAA2E;AAC3E,wBAAgB,6BAA6B,IAAI,iBAAiB,CAqBjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAyD3D;AAED,mDAAmD;AACnD,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D"}

package/lib/typescript/commonjs/src/pairing/usePairingState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePairingState.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/usePairingState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAgB9D,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,kBAAkB,CAyBpD"}
+{"version":3,"file":"usePairingState.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/usePairingState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAoB9D,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,kBAAkB,CAyBpD"}

package/lib/typescript/commonjs/src/pairing/usePreviewBarHold.d.ts

@@ -0,0 +1,19 @@
+import type { PairingEngineState } from '@userflow-tech/core';
+/**
+ * How long a new pairing session with no `purpose` on its link keeps the
+ * default preview bar hidden, so a `selectElement` that arrives after the join
+ * never flashes "Preview mode". Restarts once when the socket first reaches
+ * `connected` while the hold is still up: a slow connect still shows
+ * "Connecting…" after this delay, and a pick that starts shortly after the
+ * join stays inside the window.
+ */
+export declare const INITIAL_REVEAL_DELAY_MS = 2000;
+/**
+ * Whether the preview top bar should stay down.
+ *
+ * The decision is applied during render. Waiting for an effect would mount
+ * the bar for a frame and play its slide-in before the hold could hide it.
+ * The reveal timer stays in an effect.
+ */
+export declare function usePreviewBarHold(state: PairingEngineState, pickerActive: boolean): boolean;
+//# sourceMappingURL=usePreviewBarHold.d.ts.map

package/lib/typescript/commonjs/src/pairing/usePreviewBarHold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreviewBarHold.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/usePreviewBarHold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,qBAAqB,CAAC;AAK9E;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AA2F5C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAgD3F"}

package/lib/typescript/commonjs/src/runtime/BannerHost.d.ts

@@ -0,0 +1,16 @@
+import type { BannerSessionEngine } from '@userflow-tech/core';
+import * as React from 'react';
+/**
+ * Top or bottom banner bar. Element modes render in {@link EmbedBannerPlaceholder}.
+ *
+ * `overlay` floats over the host. `flow` sits in layout and pushes the app.
+ * The bar does not participate in the host accessibility trap.
+ */
+export declare function BannerHost({ engine, hidden, placement, edge: edgeFilter, }: {
+    engine: BannerSessionEngine;
+    hidden?: boolean;
+    placement?: 'overlay' | 'flow';
+    /** When set, render only the banner pinned to this edge. */
+    edge?: 'top' | 'bottom';
+}): React.ReactElement | null;
+//# sourceMappingURL=BannerHost.d.ts.map

package/lib/typescript/commonjs/src/runtime/BannerHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerHost.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/BannerHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,MAAM,EACN,SAAqB,EACrB,IAAI,EAAE,UAAU,GACjB,EAAE;IACD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CACzB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAsD5B"}

package/lib/typescript/commonjs/src/runtime/EmbedBannerPlaceholder.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+export interface EmbedBannerPlaceholderProps {
+    /**
+     * Matches the banner's manual embed selector. `#welcome-banner` and
+     * `welcome-banner` both match this id.
+     */
+    id: string;
+}
+/**
+ * Host slot for an element-mode banner (`ELEMENT_BEFORE`, `ELEMENT_AFTER`,
+ * `ELEMENT_FIRST`, `ELEMENT_LAST`). Mount it where the bar should appear.
+ * Until a matching banner is active the slot renders nothing, so it takes no
+ * space and is not visible. Top and bottom bars ignore this slot.
+ * `overlay: false` keeps the bar in layout; `overlay: true` paints it over
+ * the content below the slot.
+ */
+export declare function EmbedBannerPlaceholder({ id, }: EmbedBannerPlaceholderProps): React.ReactElement | null;
+//# sourceMappingURL=EmbedBannerPlaceholder.d.ts.map

package/lib/typescript/commonjs/src/runtime/EmbedBannerPlaceholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbedBannerPlaceholder.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/EmbedBannerPlaceholder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAc/B,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,EAAE,GACH,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkEzD"}

package/lib/typescript/commonjs/src/runtime/FlowRenderer.d.ts

@@ -2,12 +2,15 @@ import type { FlowSessionEngine } from '@userflow-tech/core';
 import * as React from 'react';
 export interface FlowRendererProps {
     engine: FlowSessionEngine;
+    /** Pairing preview restart counter; combined with stepShowNonce as resetNonce. */
+    previewRestartGeneration?: number;
 }
 /**
  * Renders the active flow step.
  *
- * TOOLTIP → {@link TooltipSurface}; everything else → {@link ModalSurface}
- * (BUBBLE/HIDDEN remain centered-card fallbacks until dedicated surfaces).
+ * TOOLTIP → {@link TooltipSurface}; HIDDEN → nothing (session and triggers
+ * stay active); everything else → {@link ModalSurface} (BUBBLE remains a
+ * centered-card fallback until a dedicated surface).
  */
-export declare function FlowRenderer({ engine }: FlowRendererProps): React.ReactElement | null;
+export declare function FlowRenderer({ engine, previewRestartGeneration, }: FlowRendererProps): React.ReactElement | null;
 //# sourceMappingURL=FlowRenderer.d.ts.map

package/lib/typescript/commonjs/src/runtime/FlowRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlowRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/FlowRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAmCrF"}
+{"version":3,"file":"FlowRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/FlowRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kFAAkF;IAClF,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAsBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,wBAA4B,GAC7B,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAyC/C"}

package/lib/typescript/commonjs/src/runtime/FlowSurfaceFade.d.ts

@@ -1,13 +1,26 @@
 import * as React from 'react';
-export interface FlowSurfaceFadeProps {
-    children: React.ReactNode;
-    /** Bumps when the active step changes so we fade in again. */
+export interface FlowSurfaceFadeProps<TStep> {
+    /** Bumps when the active step changes, driving the crossfade. */
     animationKey: string;
+    /** Render data for `animationKey`. */
+    step: TStep;
+    children: (step: TStep) => React.ReactNode;
 }
 /**
- * Short opacity fade for flow surface entry (FLOW_RENDERING_SPEC minimum).
- * Exit fades when the keyed surface unmounts via a brief hold are deferred —
- * step swaps remount with a fresh fade-in.
+ * Crossfades flow surfaces on step changes: the outgoing card fades out, then
+ * the incoming step mounts and fades in — no cut, no flash at full opacity.
+ * Cards animate themselves off the phase published here (see `useCardOpacity`),
+ * which keeps backdrops and cutouts steady across the swap.
+ *
+ * The outgoing step keeps rendering from `step` captured at the last swap, so
+ * the surface is not remounted mid-exit (a remount would re-resolve anchors and
+ * flash the tooltip's waiting state).
+ *
+ * A new flow remounts this component (`key={session.id}` in FlowRenderer) so
+ * the outgoing flow is not held across a START_FLOW replacement.
+ *
+ * Exit on flow end unmounts immediately: the surface is gone as soon as the
+ * session is cleared.
  */
-export declare function FlowSurfaceFade({ children, animationKey, }: FlowSurfaceFadeProps): React.ReactElement;
+export declare function FlowSurfaceFade<TStep>({ animationKey, step, children, }: FlowSurfaceFadeProps<TStep>): React.ReactElement;
 //# sourceMappingURL=FlowSurfaceFade.d.ts.map

package/lib/typescript/commonjs/src/runtime/FlowSurfaceFade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlowSurfaceFade.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/FlowSurfaceFade.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,GACb,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CA2B3C"}
+{"version":3,"file":"FlowSurfaceFade.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/FlowSurfaceFade.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,oBAAoB,CAAC,KAAK;IACzC,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,EACrC,YAAY,EACZ,IAAI,EACJ,QAAQ,GACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,YAAY,CAkClD"}

package/lib/typescript/commonjs/src/runtime/SdkErrorBoundary.d.ts

@@ -0,0 +1,34 @@
+import * as React from 'react';
+export interface SdkErrorBoundaryProps {
+    /** Label included in the isolated-error log (for example `overlay`). */
+    scope: string;
+    /**
+     * When this value changes after a caught error, the boundary retries its
+     * children — but only if that identity has not already failed. A reconnect
+     * that restores the same session/step stays blank. Does not remount children
+     * while they are healthy.
+     */
+    resetKey?: string;
+    /** Called after a render error is isolated (for example to clear an a11y trap). */
+    onError?: (error: Error) => void;
+    children: React.ReactNode;
+}
+interface SdkErrorBoundaryState {
+    hasError: boolean;
+    resetKey: string | undefined;
+    failedKeys: string[];
+}
+/**
+ * Contains React render/lifecycle errors in SDK UI so they cannot unmount the
+ * host app tree. Event handlers and async work are not covered — those use
+ * {@link isolateSync} / {@link isolateAsync}.
+ */
+export declare class SdkErrorBoundary extends React.Component<SdkErrorBoundaryProps, SdkErrorBoundaryState> {
+    state: SdkErrorBoundaryState;
+    static getDerivedStateFromError(): Partial<SdkErrorBoundaryState>;
+    static getDerivedStateFromProps(props: SdkErrorBoundaryProps, state: SdkErrorBoundaryState): Partial<SdkErrorBoundaryState> | null;
+    componentDidCatch(error: Error, info: React.ErrorInfo): void;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=SdkErrorBoundary.d.ts.map

package/lib/typescript/commonjs/src/runtime/SdkErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/SdkErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK,CAAC,SAAS,CACnD,qBAAqB,EACrB,qBAAqB,CACtB;IACU,KAAK,EAAE,qBAAqB,CAInC;IAEF,MAAM,CAAC,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIjE,MAAM,CAAC,wBAAwB,CAC7B,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAW/B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAY5D,MAAM,IAAI,KAAK,CAAC,SAAS;CAMnC"}

package/lib/typescript/commonjs/src/runtime/TargetPressBridge.d.ts

@@ -4,12 +4,16 @@ export interface TargetPressBridgeProps {
 }
 /**
  * Wraps app content so tooltip target taps can be observed without stealing
- * them from the underlying control (web parity: click listener, no preventDefault).
+ * them from the underlying control (web parity: click listener, no
+ * preventDefault).
  *
  * The Userflow overlay is a sibling above the app, so hole Pressables would
  * intercept presses. Instead we hit-test bubbled `onTouchStart` / `onTouchEnd`
  * against the rect registered by {@link TooltipSurface}.
  *
+ * Preview-chrome double taps are observed by `DoubleTapBridge` around the
+ * whole provider tree — this bridge never sees overlay touches.
+ *
  * Does not claim the gesture responder.
  */
 export declare function TargetPressBridge({ children }: TargetPressBridgeProps): React.ReactElement;

package/lib/typescript/commonjs/src/runtime/TargetPressBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TargetPressBridge.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/TargetPressBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,CAoC1F"}
+{"version":3,"file":"TargetPressBridge.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/TargetPressBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,CA0C1F"}

package/lib/typescript/commonjs/src/runtime/UserflowOverlay.d.ts

@@ -0,0 +1,15 @@
+import type { BannerSessionEngine, FlowSessionEngine } from '@userflow-tech/core';
+import * as React from 'react';
+export interface UserflowOverlayProps {
+    engine: FlowSessionEngine;
+    bannerEngine: BannerSessionEngine;
+    /** Keep the host a11y trap in the provider (outside this error boundary). */
+    onTrapChange: (trap: boolean) => void;
+}
+/**
+ * SDK overlay chrome: preview banner, active flow surface, element picker.
+ * Mounted inside {@link SdkErrorBoundary} so a render throw here cannot
+ * unmount host children of {@link UserflowProvider}.
+ */
+export declare function UserflowOverlay({ engine, bannerEngine, onTrapChange, }: UserflowOverlayProps): React.ReactElement;
+//# sourceMappingURL=UserflowOverlay.d.ts.map

package/lib/typescript/commonjs/src/runtime/UserflowOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserflowOverlay.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/UserflowOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,mBAAmB,CAAC;IAClC,6EAA6E;IAC7E,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,YAAY,EACZ,YAAY,GACb,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CAqF3C"}

package/lib/typescript/commonjs/src/runtime/UserflowProvider.d.ts

@@ -1,12 +1,14 @@
-import type { FlowSessionEngine } from '@userflow-tech/core';
+import type { BannerSessionEngine, FlowSessionEngine } from '@userflow-tech/core';
 import * as React from 'react';
 export interface UserflowContextValue {
     engine: FlowSessionEngine;
 }
 export interface UserflowProviderProps {
     children: React.ReactNode;
-    /** Override the module singleton engine (tests). */
+    /** Override the module singleton tour engine (tests). */
     engine?: FlowSessionEngine;
+    /** Override the module singleton banner engine (tests). */
+    bannerEngine?: BannerSessionEngine;
 }
 /**
  * Mount once at the application root, above the navigation container
@@ -14,19 +16,25 @@ export interface UserflowProviderProps {
  * calling {@link Userflow.init}.
  *
  * Children render normally. An absolute overlay sits above them with
- * `pointerEvents="box-none"` so taps pass through except where flow UI sits.
+ * `pointerEvents="box-none"` so taps pass through except where flow UI blocks
+ * them (modals always; tooltips when interaction blocking is enabled).
  * We deliberately do not use RN `<Modal>` — it is the wrong primitive for
  * non-modal tooltips (WS6).
  *
+ * Overlay render errors are contained by {@link SdkErrorBoundary}; host
+ * children are never inside that boundary. See
+ * `packages/react-native/docs/isolation.md`.
+ *
  * **Expo Router:** also mount `UserflowExpoRouterScreenTracker` from
- * `@userflow-tech/react-native/expo-router` under this provider so pathname changes
- * and path-like NAVIGATE actions are wired. The tracker is a separate entry so
- * apps without `expo-router` are not forced to install that peer.
+ * `@userflow-tech/react-native/expo-router` under this provider so pathname and
+ * navigation-state changes and path-like NAVIGATE actions are wired. The tracker
+ * is a separate entry so apps without `expo-router` are not forced to install
+ * that peer.
  *
  * **React Navigation:** wrap `NavigationContainer` with
  * {@link WithUserflowReactNavigation} from `@userflow-tech/react-native/navigation`.
  */
-export declare function UserflowProvider({ children, engine: engineProp, }: UserflowProviderProps): React.ReactElement;
+export declare function UserflowProvider({ children, engine: engineProp, bannerEngine: bannerEngineProp, }: UserflowProviderProps): React.ReactElement;
 /** Access the flow session engine from inside {@link UserflowProvider}. */
 export declare function useUserflow(): UserflowContextValue;
 //# sourceMappingURL=UserflowProvider.d.ts.map

package/lib/typescript/commonjs/src/runtime/UserflowProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserflowProvider.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/UserflowProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAc/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,GACnB,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAsB5C;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD"}
+{"version":3,"file":"UserflowProvider.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/UserflowProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAuB/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yDAAyD;IACzD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AA0CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,gBAAgB,GAC/B,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAoF5C;AAiBD,2EAA2E;AAC3E,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD"}

package/lib/typescript/commonjs/src/runtime/bannerEngine.d.ts

@@ -0,0 +1,12 @@
+import { BannerSessionEngine, type UserflowCore } from '@userflow-tech/core';
+/** Build (once) the module-level banner session engine over a {@link UserflowCore} transport. */
+export declare function getBannerSessionEngine(core: UserflowCore): BannerSessionEngine;
+/** Subscribe the engine to inbound server messages. Call after identify. */
+export declare function attachBannerSessionEngine(core: UserflowCore): BannerSessionEngine;
+/** Clear the banner session and detach. Call from {@link Userflow.reset}. */
+export declare function resetBannerSessionEngine(): void;
+/** Drop the local banner without detaching (preview exit, user switch). */
+export declare function clearBannerSessionEngineLocalSession(): void;
+/** Test helper: drop the singleton so the next get recreates it. */
+export declare function __resetBannerSessionEngineForTests(): void;
+//# sourceMappingURL=bannerEngine.d.ts.map

package/lib/typescript/commonjs/src/runtime/bannerEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerEngine.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/bannerEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAU7E,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAoB9E;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAIjF;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,2EAA2E;AAC3E,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED,oEAAoE;AACpE,wBAAgB,kCAAkC,IAAI,IAAI,CAGzD"}

package/lib/typescript/commonjs/src/runtime/bannerEngineContext.d.ts

@@ -0,0 +1,5 @@
+import type { BannerSessionEngine } from '@userflow-tech/core';
+import * as React from 'react';
+/** Banner engine for host slots. Null outside {@link UserflowProvider}. */
+export declare const BannerEngineContext: React.Context<BannerSessionEngine | null>;
+//# sourceMappingURL=bannerEngineContext.d.ts.map

package/lib/typescript/commonjs/src/runtime/bannerEngineContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerEngineContext.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/bannerEngineContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,2CAAwD,CAAC"}

package/lib/typescript/commonjs/src/runtime/bannerPlacement.d.ts

@@ -0,0 +1,12 @@
+import type { BannerEmbedMode, BannerFragment } from '@userflow-tech/protocol';
+/** Body-first is the top edge; body-last is the bottom. Element modes use a placeholder. */
+export declare function bannerEdge(mode: BannerEmbedMode | string): 'top' | 'bottom' | null;
+/**
+ * Id of the {@link EmbedBannerPlaceholder} an element-mode banner fills.
+ * Manual selectors use `#welcome-banner` or `welcome-banner`. Body modes
+ * return null so a top/bottom bar never occupies a host slot.
+ */
+export declare function embedBannerPlaceholderId(banner: BannerFragment): string | null;
+export declare function warnBannerOnce(key: string, message: string, warn?: (message: string) => void): void;
+export declare function resetBannerWarningsForTests(): void;
+//# sourceMappingURL=bannerPlacement.d.ts.map

package/lib/typescript/commonjs/src/runtime/bannerPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerPlacement.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/bannerPlacement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM/E,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAIlF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAG9E;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAmB,GAC7C,IAAI,CAIN;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/lib/typescript/commonjs/src/runtime/changedTouchPoints.d.ts

@@ -0,0 +1,10 @@
+import type { GestureResponderEvent, NativeTouchEvent } from 'react-native';
+/**
+ * Touches that just started/ended/cancelled for this event. Prefer
+ * `changedTouches` so multi-touch uses the finger(s) that actually changed —
+ * `touches[0]` may be an already-active finger. Each touch carries `identifier`
+ * so monitors can pair start/end per finger.
+ */
+export declare function changedTouchPoints(event: GestureResponderEvent): Array<Pick<NativeTouchEvent, 'identifier' | 'pageX' | 'pageY'>>;
+export declare function forEachChangedTouch(event: GestureResponderEvent, fn: (identifier: NativeTouchEvent['identifier'], pageX: number, pageY: number) => void): void;
+//# sourceMappingURL=changedTouchPoints.d.ts.map

package/lib/typescript/commonjs/src/runtime/changedTouchPoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changedTouchPoints.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/changedTouchPoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,GAC3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAcjE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,EAC5B,EAAE,EAAE,CAAC,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACrF,IAAI,CAIN"}

package/lib/typescript/commonjs/src/runtime/embedBannerRegistry.d.ts

@@ -0,0 +1,5 @@
+/** Record a mounted {@link EmbedBannerPlaceholder}. Returns the unregister function. */
+export declare function registerEmbedBannerPlaceholder(id: string): () => void;
+export declare function hasEmbedBannerPlaceholder(id: string): boolean;
+export declare function resetEmbedBannerPlaceholdersForTests(): void;
+//# sourceMappingURL=embedBannerRegistry.d.ts.map

package/lib/typescript/commonjs/src/runtime/embedBannerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedBannerRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/embedBannerRegistry.ts"],"names":[],"mappings":"AAIA,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,IAAI,CAcrE;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/lib/typescript/commonjs/src/runtime/flowEngine.d.ts

@@ -10,8 +10,32 @@ export declare function resetFlowSessionEngine(): void;
  * Used after a long background when mid-flow resume would be stale.
  */
 export declare function clearFlowSessionEngineLocalSession(): void;
-/** Whether any mid-flow session (live or draft/preview) is currently on screen. */
+/**
+ * Whether a mid-flow session is held (live, draft, or suppressed by Temporarily
+ * Hide). Foreground idle uses this so a hidden session keeps the socket that
+ * can deliver the attribute update which shows it again.
+ */
 export declare function hasActiveFlowSession(): boolean;
+/**
+ * End the current flow on the server if it is a Builder preview draft. The
+ * server restores every active draft on identify, so clearing it locally is
+ * not enough to keep it from returning on the next launch.
+ *
+ * A draft Temporarily Hide is suppressing is still ended. `getFlowSession()`
+ * hides it, but the server will send it again. When exit runs before identify
+ * has delivered the draft, the next draft session is ended when it arrives.
+ * {@link cancelPendingDraftEnd} drops that wait; a new preview must call it
+ * so the preview's own draft is not ended.
+ */
+export declare function endDraftFlowSession(): Promise<void>;
+/** Drop a pending end from {@link endDraftFlowSession}. A new preview calls this. */
+export declare function cancelPendingDraftEnd(): void;
+/**
+ * `userflow.endFlow()` from an Evaluate JavaScript page. Ends the current
+ * session only if one of the page's scripts came from it, so a stale page
+ * cannot end a flow that started later.
+ */
+export declare function endEvalJsFlowSession(sessionIds: ReadonlySet<string>): Promise<void>;
 /** Test helper: drop the singleton so the next get recreates it. */
 export declare function __resetFlowSessionEngineForTests(): void;
 //# sourceMappingURL=flowEngine.d.ts.map

package/lib/typescript/commonjs/src/runtime/flowEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowEngine.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/flowEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAM3E,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAc1E;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAI7E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,oEAAoE;AACpE,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD"}
+{"version":3,"file":"flowEngine.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/flowEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAa3E,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAsB1E;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAI7E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAkBD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AAED,oEAAoE;AACpE,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}

package/lib/typescript/commonjs/src/runtime/flowSessionViewState.d.ts

@@ -4,14 +4,23 @@ import type { FlowSessionFragment, FlowStepFragment } from '@userflow-tech/proto
 export interface FlowSessionViewState {
     session: FlowSessionFragment | null;
     currentStepId: string | null;
+    /**
+     * Bumped on every `goToStep`, including a ForceGoToStep back to the current
+     * step, so tooltip targeting can re-bootstrap when session/step identity
+     * would otherwise be unchanged (draft preview restart).
+     */
+    stepShowNonce: number;
 }
 export declare function initialFlowSessionViewState(session: FlowSessionFragment | null): FlowSessionViewState;
 /**
  * Reduces engine events into view state.
  *
- * Important: `goToStep` updates `currentStepId` without requiring a new
- * `sessionChange` — the engine mutates `session.currentStep` in place and
- * `ForceGoToStep` does not update it at all.
+ * `goToStep` updates `currentStepId` without a new `sessionChange`. A later
+ * same-session SetFlowSession must not snap back to `session.currentStep` —
+ * tracking a button event enqueues `check_sessions`, which can push a stale
+ * current step. Web `FlowApp` `updateSession` keeps the local step for the
+ * same session id (and only falls back if that step was deleted from the
+ * version).
  */
 export declare function reduceFlowSessionViewState(state: FlowSessionViewState, event: FlowSessionEngineEvent): FlowSessionViewState;
 export declare function resolveCurrentStep(session: FlowSessionFragment | null, currentStepId: string | null): FlowStepFragment | null;

package/lib/typescript/commonjs/src/runtime/flowSessionViewState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowSessionViewState.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/flowSessionViewState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAErF,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAClC,oBAAoB,CAKtB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,sBAAsB,GAC5B,oBAAoB,CAkBtB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,GAAG,IAAI,EACnC,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,gBAAgB,GAAG,IAAI,CAGzB"}
+{"version":3,"file":"flowSessionViewState.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/flowSessionViewState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAErF,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAClC,oBAAoB,CAMtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,sBAAsB,GAC5B,oBAAoB,CAqBtB;AA2BD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,GAAG,IAAI,EACnC,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,gBAAgB,GAAG,IAAI,CAGzB"}

package/lib/typescript/commonjs/src/runtime/isolateCall.d.ts

@@ -0,0 +1,20 @@
+/**
+ * True for missing `init` / `identify`, invalid event or attribute names — not
+ * for transport `UserflowAuthError`s. The flag is set at the throw site on
+ * `UserflowAuthError.isHostContract`; message text is not consulted.
+ * Matched by `error.name` plus the flag so mocked test doubles with the same
+ * name are treated like the real class.
+ */
+export declare function isHostContractError(error: unknown): boolean;
+export interface IsolateAsyncOptions {
+    /**
+     * When true (default), host-contract `UserflowAuthError`s are rethrown so the
+     * host sees integration misuse. Internal fire-and-forget paths pass false.
+     */
+    rethrowHostContract?: boolean;
+}
+/** Run synchronous SDK work; swallow and report anything except host-contract errors. */
+export declare function isolateSync<T>(scope: string, work: () => T): T | undefined;
+/** Run async SDK work; swallow and report anything except host-contract errors. */
+export declare function isolateAsync<T>(scope: string, work: () => Promise<T>, options?: IsolateAsyncOptions): Promise<T | undefined>;
+//# sourceMappingURL=isolateCall.d.ts.map

package/lib/typescript/commonjs/src/runtime/isolateCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolateCall.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/isolateCall.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK3D;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAU1E;AAED,mFAAmF;AACnF,wBAAsB,YAAY,CAAC,CAAC,EAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAUxB"}

package/lib/typescript/commonjs/src/runtime/reportSdkError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Internal reporter for SDK failures that must not reach the host app.
+ * Always logs (not `__DEV__`-only) so a swallowed error is still diagnosable.
+ *
+ * Uses `console.warn`, not `console.error`: React Native release builds forward
+ * `console.error` to the native exception manager (Crashlytics / Sentry), which
+ * would report an isolated tooltip failure as a host crash.
+ */
+export declare function reportSdkError(scope: string, error: unknown, extra?: unknown): void;
+//# sourceMappingURL=reportSdkError.d.ts.map

package/lib/typescript/commonjs/src/runtime/reportSdkError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSdkError.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/reportSdkError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAGnF"}

package/lib/typescript/commonjs/src/runtime/useBannerSession.d.ts

@@ -0,0 +1,5 @@
+import type { BannerSessionEngine } from '@userflow-tech/core';
+import type { BannerSessionFragment } from '@userflow-tech/protocol';
+/** Subscribe to the active banner. A throw while reading the session stays off the host tree. */
+export declare function useBannerSession(engine: BannerSessionEngine | null): BannerSessionFragment | null;
+//# sourceMappingURL=useBannerSession.d.ts.map

package/lib/typescript/commonjs/src/runtime/useBannerSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBannerSession.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/useBannerSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAKrE,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CA2BjG"}

package/lib/typescript/commonjs/src/runtime/useFlowSessionState.d.ts

@@ -4,6 +4,7 @@ export interface FlowSessionState {
     session: FlowSessionFragment | null;
     currentStepId: string | null;
     currentStep: FlowStepFragment | null;
+    stepShowNonce: number;
 }
 /** Subscribe to a {@link FlowSessionEngine} and derive React-friendly session/step state. */
 export declare function useFlowSessionState(engine: FlowSessionEngine): FlowSessionState;

package/lib/typescript/commonjs/src/runtime/useFlowSessionState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFlowSessionState.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/useFlowSessionState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AASrF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACtC;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAkB/E"}
+{"version":3,"file":"useFlowSessionState.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/useFlowSessionState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AASrF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAmB/E"}

package/lib/typescript/commonjs/src/screenTracker.d.ts

@@ -1,28 +1,50 @@
 import type { ClientLocationUpdate } from '@userflow-tech/protocol';
+/** Predefined mobile screen-view event (web analogue: `page_viewed`). */
+export declare const SCREEN_VIEWED_EVENT = "screen_viewed";
 /** Called when a new location is accepted (after enable + dedupe). */
 export type ScreenChangeReporter = (location: ClientLocationUpdate) => void;
+export type HandleScreenChangeOptions = {
+    /** Re-run the reporter even when the location matches the last report. */
+    force?: boolean;
+};
+/** Event attributes for `screen_viewed`, or `null` when the location has no identity. */
+export declare function screenViewedAttributes(location: ClientLocationUpdate): {
+    screen_name: string;
+} | null;
 /**
  * Registers the callback invoked when the active screen/path changes.
  * The React Native facade wires this to `UserflowCore.updateScreen`.
  */
 export declare function setScreenChangeReporter(next: ScreenChangeReporter | null): void;
+/**
+ * Observe accepted screen changes (Evaluate JavaScript context, and similar).
+ * Fires immediately with the latest known location when one exists.
+ * A throwing listener does not block the reporter or the other listeners.
+ */
+export declare function subscribeScreenLocation(listener: ScreenChangeReporter): () => void;
+/** Latest screen/path the SDK has recorded, or `null` before the first report. */
+export declare function getCurrentScreenLocation(): ClientLocationUpdate | null;
 /** Activates screen-change tracking after a successful {@link Userflow.init}. */
 export declare function enableScreenTracking(): void;
 /** Deactivates screen-change tracking and clears the last known screen. */
 export declare function disableScreenTracking(): void;
 /**
  * Records a navigation to `location` when tracking is enabled.
- * Duplicate consecutive locations are ignored. On change, notifies the reporter
- * so the SDK can push `UpdateClientContext` to the backend.
+ * Duplicate consecutive locations are ignored unless `{ force: true }` (used
+ * after overlay dismiss, AppState resume, and first identify). On change,
+ * notifies the reporter so the SDK can push `UpdateClientContext` and
+ * `screen_viewed`.
  *
  * Locations observed before {@link enableScreenTracking} are remembered and
  * flushed when tracking is enabled (so init-after-mount still picks up the
  * active route).
  *
- * - Expo Router: `{ path: "/settings/billing" }` → wire `screenPath`
+ * - Expo Router: `{ path: "/settings/billing" }` → wire `screenName`
  * - React Navigation / manual: `{ screen: "BillingSettings" }` → wire `screenName`
  */
-export declare function handleScreenChange(location: ClientLocationUpdate | undefined): void;
+export declare function handleScreenChange(location: ClientLocationUpdate | undefined, options?: HandleScreenChangeOptions): void;
+/** Re-report the current screen, bypassing consecutive dedupe (resume / identify). */
+export declare function reportCurrentScreen(): void;
 /** @internal Resets tracker state between tests. Does not clear the reporter. */
 export declare function resetScreenTrackerForTests(): void;
 //# sourceMappingURL=screenTracker.d.ts.map