@userflow-tech/react-native 0.1.0 → 0.2.0

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

@@ -7,11 +7,15 @@
  * (background/foreground + idle) to the connection, hosts the flow session
  * engine + provider overlay for Phase 3 rendering, and tracks screen changes.
  */
-import type { UserflowAttributes, UserflowConfig, UserflowEventAttributes, UserflowGroupOptions, UserflowIdentifyOptions, UserflowInitOptions, UserflowTrackOptions } from '@userflow-tech/core';
+import type { PublicAttributes, UserflowAttributes, UserflowConfig, UserflowEventAttributes, UserflowGroupOptions, UserflowIdentifyOptions, UserflowInitOptions, UserflowTrackOptions, UserflowUpdateGroupOptions } from '@userflow-tech/core';
 import './anchors/autoAnchor';
 import { type CustomScrollIntoView, type ScrollPadding } from './anchors/scrollConfig';
+import { type DeviceContext } from './deviceContext';
+import { type HostAppVersion } from './hostAppVersion';
 import { type FlowNavigateHandler } from './navigation/openFlowNavigateUrl';
 export { SDK_VERSION } from './version';
+export type { DeviceContext, DeviceOs, DeviceType, SdkPlatform } from './deviceContext';
+export type { HostAppVersion, HostAppVersionSource } from './hostAppVersion';
 export { UserflowProvider, useUserflow } from './runtime/UserflowProvider';
 export type { UserflowProviderProps, UserflowContextValue } from './runtime/UserflowProvider';
 export { useFlowSessionState } from './runtime/useFlowSessionState';
@@ -37,8 +41,15 @@ export type UserflowInitConfig = UserflowInitOptions & {
      * Defaults to `https://e.userflow.com`.
      */
     pairingEndpoint?: string;
+    /**
+     * Override auto-detected native store version. When omitted, the SDK reads
+     * the host app's marketing version at init (Expo modules or native constants).
+     */
+    appVersion?: string;
+    /** Optional build number paired with {@link appVersion}. */
+    appBuild?: string;
 };
-export type { UserflowAttributes, UserflowConfig, UserflowEventAttributes, UserflowGroupOptions, UserflowIdentifyOptions, UserflowInitOptions, UserflowTrackOptions, } from '@userflow-tech/core';
+export type { PublicAttributeChange, PublicAttributes, UserflowAttributes, UserflowConfig, UserflowEventAttributes, UserflowGroupOptions, UserflowIdentifyOptions, UserflowInitOptions, UserflowTrackOptions, UserflowUpdateGroupOptions, } from '@userflow-tech/core';
 /**
  * Public SDK entry point. Delegates to the platform-agnostic engine in
  * `@userflow-tech/core` and manages the app-lifecycle subscription.
@@ -72,12 +83,33 @@ export declare const Userflow: {
     didHandleURL(url: string): Promise<boolean>;
     /** Associate the current user with a group and upsert group/membership attributes. */
     group(groupId: string | number, attributes?: UserflowAttributes, options?: UserflowGroupOptions): Promise<void>;
+    /**
+     * Upsert attributes for the current user without re-identifying.
+     * Requires a prior {@link identify}. Flow button "Set user attribute" actions
+     * use this path.
+     */
+    updateUser(attributes?: PublicAttributes): Promise<void>;
+    /**
+     * Upsert attributes for the current group / membership without re-grouping.
+     * Requires a prior {@link group}.
+     */
+    updateGroup(attributes?: PublicAttributes, options?: UserflowUpdateGroupOptions): Promise<void>;
     /** Record a custom analytics event for the current user (and group, unless `userOnly`). */
     track(name: string, attributes?: UserflowEventAttributes, options?: UserflowTrackOptions): Promise<void>;
     /** The currently identified user id, or `null` before identify. */
     getUserId(): string | null;
     /** A copy of the attributes recorded for the current user. */
     getAttributes(): UserflowAttributes;
+    /**
+     * Host app marketing version cached during {@link init}, or `null` before init
+     * or when auto-detection and any init override are unavailable.
+     */
+    getHostAppVersion(): HostAppVersion | null;
+    /**
+     * Platform metadata cached during {@link init} (`sdk`, `deviceOs`, `deviceType`),
+     * or `null` before init.
+     */
+    getDeviceContext(): DeviceContext | null;
     /** The flow session engine (created lazily; attach runs after identify). */
     getFlowSessionEngine(): import("@userflow-tech/core").FlowSessionEngine;
     /** Clears the current user identity and disconnects from Userflow. */
@@ -108,5 +140,24 @@ export declare const Userflow: {
      * default fiber / registry path (mirrors web `userflow.setCustomScrollIntoView`).
      */
     setCustomScrollIntoView(fn: CustomScrollIntoView | null | undefined): void;
+    /**
+     * When true (default), tooltip cutout bands and step-transition exit block
+     * taps on the host app underneath. Pass `false` to restore legacy pass-through
+     * tooltip backdrop behavior (dim bands only; `tooltipTargetBlocked` hole seal
+     * is unchanged). Modals always block. Takes effect on the next surface re-render.
+     */
+    setSurfaceInteractionBlocking(enabled: boolean | null | undefined): void;
+    /**
+     * Log the host app's native marketing version (store version), not
+     * {@link SDK_VERSION}, and the platform OS (`ios` / `android` / …).
+     * Prefers `expo-application` / `expo-constants` when present; otherwise reads
+     * `NativeModules.RNDeviceInfo` from the bundled device-info native module.
+     */
+    logHostAppVersion(): void;
+    /**
+     * Log cached user-attribute values (`sdk`, `device_os`, `device_type`).
+     * Requires {@link init}; before init, logs that init is required.
+     */
+    logDeviceContext(): void;
 };
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -43,6 +43,11 @@ export interface LifecycleControllerDeps {
     ensureAlive: () => void;
     /** True while any mid-flow session (live or draft/preview) is on screen. */
     hasActiveSession: () => boolean;
+    /**
+     * Re-fire the current screen view after a real background (away past grace).
+     * Not called for Control Center / biometric blurs inside the grace window.
+     */
+    onScreenResume?: () => void;
     scheduler?: LifecycleScheduler;
     now?: () => number;
     /** Override for tests; defaults to {@link SUSPEND_GRACE_MS}. */
@@ -63,6 +68,7 @@ export declare class LifecycleController {
     private readonly clearLocalSession;
     private readonly ensureAlive;
     private readonly hasActiveSession;
+    private readonly onScreenResume;
     private readonly scheduler;
     private readonly now;
     private readonly suspendGraceMs;

package/lib/typescript/commonjs/src/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,cAAc,CAAC;AAE5E,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AAEnD,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,QAAgB,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC;IACzD,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,cAAc,CAAC;IAC1C,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAYD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4D;IAE9F,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,iFAAiF;IACjF,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,uBAAuB;IAazC,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACH,cAAc,IAAI,IAAI;IAOtB,yBAAyB;IACzB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAalD,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAoCpB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,cAAc;CAMvB"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,cAAc,CAAC;AAE5E,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AAEnD,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,QAAgB,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC;IACzD,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,cAAc,CAAC;IAC1C,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAYD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4D;IAE9F,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,iFAAiF;IACjF,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,uBAAuB;IAczC,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACH,cAAc,IAAI,IAAI;IAOtB,yBAAyB;IACzB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAalD,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,cAAc;CAMvB"}

package/lib/typescript/commonjs/src/navigation/WithUserflowReactNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WithUserflowReactNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/navigation/WithUserflowReactNavigation.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,KAAK,6BAA6B,GAAG;IACnC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;CAC7D;AAkBD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,GACT,EAAE,gCAAgC,GAAG,KAAK,CAAC,YAAY,CAmCvD"}
+{"version":3,"file":"WithUserflowReactNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/navigation/WithUserflowReactNavigation.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,KAAK,6BAA6B,GAAG;IACnC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;CAC7D;AAkBD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,GACT,EAAE,gCAAgC,GAAG,KAAK,CAAC,YAAY,CAkDvD"}

package/lib/typescript/commonjs/src/navigation/isOverlayPresentation.d.ts

@@ -0,0 +1,14 @@
+/** True when the focused route is a modal / sheet overlay, not a screen navigation. */
+export declare function isOverlayPresentation(presentation: unknown): boolean;
+/**
+ * Reads `presentation` from a React Navigation container ref.
+ * Accepts either a `NavigationContainerRef` or a `NavigationContainerRefWithCurrent`
+ * (`ref.current` is checked when the wrapper itself has no `getCurrentOptions`).
+ */
+export declare function readNavigationPresentation(ref: unknown): string | undefined;
+/**
+ * Subscribes to React Navigation container `state` events.
+ * Accepts a `NavigationContainerRef` or `NavigationContainerRefWithCurrent`.
+ */
+export declare function subscribeNavigationState(ref: unknown, listener: () => void): (() => void) | undefined;
+//# sourceMappingURL=isOverlayPresentation.d.ts.map

package/lib/typescript/commonjs/src/navigation/isOverlayPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isOverlayPresentation.d.ts","sourceRoot":"","sources":["../../../../../src/navigation/isOverlayPresentation.ts"],"names":[],"mappings":"AAWA,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAEpE;AAiBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAO3E;AAkBD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,IAAI,GACnB,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAO1B"}

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

@@ -50,6 +50,7 @@ export declare class PairingController {
     private deferredPairingToken;
     /** Diagnostics already emitted for the current init attempt. */
     private readonly loggedOnce;
+    private relayUnsub;
     constructor(options: PairingControllerOptions);
     getEngine(): PairingEngine | null;
     /** Whether deep-link / AppState listeners have been started. */
@@ -96,9 +97,15 @@ export declare class PairingController {
     /** Explicit entry with a raw pairing JWT (tests / advanced hosts). */
     enterPreview(pairingToken: string): Promise<void>;
     exitPreview(): Promise<void>;
+    /**
+     * Replay the last previewed flow from step 1. No-ops when nothing has been
+     * delivered yet (restart control is hidden in that case).
+     */
+    restartPreview(): Promise<boolean>;
     /** Flush queued startFlowWithToken after identify. */
     notifyIdentified(): void;
     private ensureEngine;
+    private unbindRelay;
     private emit;
 }
 //# sourceMappingURL=PairingController.d.ts.map

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

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

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

@@ -3,9 +3,14 @@ import * as React from 'react';
 export interface PreviewModeBannerProps {
     state: PairingEngineState;
     onExit: () => void;
+    onRestart?: () => void;
+    /** True while a chrome confirm dialog is open, so the provider can trap host a11y. */
+    onConfirmingChange?: (open: boolean) => void;
+    /** Hide the preview bar while the element picker is using the same top slot. */
+    suppressed?: boolean | undefined;
 }
 /**
  * Overlay chrome for Builder pairing preview mode.
  */
-export declare function PreviewModeBanner({ state, onExit, }: PreviewModeBannerProps): React.ReactElement | null;
+export declare function PreviewModeBanner({ state, onExit, onRestart, onConfirmingChange, suppressed, }: PreviewModeBannerProps): React.ReactElement | null;
 //# sourceMappingURL=PreviewModeBanner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PreviewModeBanner.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/PreviewModeBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,MAAM,GACP,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAgEpD"}
+{"version":3,"file":"PreviewModeBanner.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/PreviewModeBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,MAAM,EACN,SAAS,EACT,kBAAkB,EAClB,UAAkB,GACnB,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAmOpD"}

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

@@ -30,6 +30,11 @@ export declare function pairingLinkInitFailedMessage(reason: string): string;
  * already paired, backend unreachable). Never fatal to the host app.
  */
 export declare function pairingConnectFailedMessage(reason: string): string;
+/**
+ * Engine-reported pairing failure (`lastError`). The preview top bar no longer
+ * has a second line for this, so it must reach Metro under the `[Userflow]` prefix.
+ */
+export declare function pairingPreviewErrorMessage(reason: string): string;
 /** A pairing link arrived without the `pairing_token` query parameter. */
 export declare function pairingMissingTokenMessage(url: string): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAY1D,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED,4DAA4D;AAC5D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,uBAAuB,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,CASR;AAED,6EAA6E;AAC7E,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,iFAAiF;AACjF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7D"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAY1D,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED,4DAA4D;AAC5D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,uBAAuB,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,CASR;AAED,6EAA6E;AAC7E,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,iFAAiF;AACjF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7D"}

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

@@ -0,0 +1,11 @@
+import type { PairingRelayEvent } from '@userflow-tech/protocol';
+export interface ElementPickerRelayEngine {
+    onRelay: (handler: (event: PairingRelayEvent, payload: unknown) => void) => () => void;
+    sendRelay: (event: PairingRelayEvent, payload: unknown) => Promise<unknown>;
+}
+/**
+ * Bridge pairing-channel `selectElement*` events onto {@link elementPickerController}.
+ * UI-free: the overlay (and QA harness) own the actual picking.
+ */
+export declare function bindElementPickerRelay(engine: ElementPickerRelayEngine): () => void;
+//# sourceMappingURL=elementPickerRelay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elementPickerRelay.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/elementPickerRelay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAOjE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACvF,SAAS,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAiCD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAmDnF"}

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

@@ -0,0 +1,16 @@
+import type { PairingEngineState } from '@userflow-tech/core';
+import type { ChromeTopBarTone } from '../authoring/chrome/ChromeTopBar';
+export type PreviewChrome = {
+    visible: false;
+} | {
+    visible: true;
+    tone: ChromeTopBarTone;
+    label: string;
+    numberOfLines: number;
+};
+/**
+ * Maps pairing-engine state onto the preview top-bar chrome.
+ * Pure: no React, so the nine-case table can be asserted without a renderer.
+ */
+export declare function resolvePreviewChrome(state: PairingEngineState): PreviewChrome;
+//# sourceMappingURL=resolvePreviewChrome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePreviewChrome.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/resolvePreviewChrome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,MAAM,MAAM,aAAa,GACrB;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAuBpF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAuB7E"}

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

@@ -13,4 +13,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;;;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;AA0CD,2EAA2E;AAC3E,wBAAgB,6BAA6B,IAAI,iBAAiB,CAajE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CA2B3D;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;AAkB9D,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,kBAAkB,CAyBpD"}

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/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;AAO/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,CAoC1F"}

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

@@ -14,14 +14,16 @@ 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).
  *
  * **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`.

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,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmB/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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,GACnB,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CA2E5C;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD"}

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/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;AAM3E,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAgB1E;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"}

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/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,19 +1,35 @@
 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_path: string;
+} | {
+    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;
+/** 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
@@ -22,7 +38,9 @@ export declare function disableScreenTracking(): void;
  * - Expo Router: `{ path: "/settings/billing" }` → wire `screenPath`
  * - 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

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

@@ -1 +1 @@
-{"version":3,"file":"screenTracker.d.ts","sourceRoot":"","sources":["../../../../src/screenTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAY5E;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE/E;AAOD,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,CAgBnF;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}
+{"version":3,"file":"screenTracker.d.ts","sourceRoot":"","sources":["../../../../src/screenTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAE5E,MAAM,MAAM,yBAAyB,GAAG;IACtC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,oBAAoB,GAC7B;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE/E;AAQD,kFAAkF;AAClF,wBAAgB,wBAAwB,IAAI,oBAAoB,GAAG,IAAI,CAEtE;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,OAAO,CAAC,EAAE,yBAAyB,GAClC,IAAI,CAgBN;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,IAAI,IAAI,CAKjD"}

package/lib/typescript/commonjs/src/surfaces/CardFade.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+import { Animated } from 'react-native';
+export type CardFadeProps = React.ComponentProps<typeof Animated.View>;
+/**
+ * Card chrome root that fades itself through step transitions.
+ *
+ * This has to wrap the card view itself, not sit higher up in a surface: the
+ * fade starts from this component's mount, and a tooltip's surface renders long
+ * before its card does.
+ */
+export declare function CardFade({ style, ...rest }: CardFadeProps): React.ReactElement;
+//# sourceMappingURL=CardFade.d.ts.map

package/lib/typescript/commonjs/src/surfaces/CardFade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardFade.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/CardFade.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIxC,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAG9E"}

package/lib/typescript/commonjs/src/surfaces/CloseButton.d.ts

@@ -1,8 +1,14 @@
 import * as React from 'react';
+export declare const CLOSE_BUTTON_SIZE = 24;
+export declare const CLOSE_BUTTON_INSET = 8;
 export interface CloseButtonProps {
     onPress: () => void;
     color: string;
+    /** Distance from the top of the positioned parent. Default {@link CLOSE_BUTTON_INSET}. */
+    top?: number;
+    /** Distance from the trailing edge. Default {@link CLOSE_BUTTON_INSET}. */
+    right?: number;
 }
-/** Web close control: 24×24 hit target, 8px from the top-trailing corner. Pass muted color from {@link resolveCloseButtonColor}. */
-export declare function CloseButton({ onPress, color }: CloseButtonProps): React.ReactElement;
+/** Web close control: 24×24 hit target. Pass muted color from {@link resolveCloseButtonColor}. */
+export declare function CloseButton({ onPress, color, top, right, }: CloseButtonProps): React.ReactElement;
 //# sourceMappingURL=CloseButton.d.ts.map