@userflow-tech/react-native 0.1.0 → 0.2.0

package/lib/typescript/module/src/deviceContext.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Resolve mobile platform metadata for Userflow user attributes.
+ *
+ * Cached once during {@link Userflow.init} and merged into identify attributes
+ * (same lifecycle as {@link hostAppVersion.ts}).
+ */
+export type SdkPlatform = 'react_native';
+export type DeviceOs = 'ios' | 'android';
+export type DeviceType = 'phone' | 'tablet';
+export interface DeviceContext {
+    sdk: SdkPlatform;
+    deviceOs?: DeviceOs;
+    deviceType?: DeviceType;
+}
+/** Android `smallestScreenWidthDp` tablet threshold (sw600dp). */
+export declare const ANDROID_TABLET_SMALLEST_WIDTH_DP = 600;
+export declare const SDK_USER_ATTRIBUTE = "sdk";
+export declare const DEVICE_OS_USER_ATTRIBUTE = "device_os";
+export declare const DEVICE_TYPE_USER_ATTRIBUTE = "device_type";
+interface PlatformShape {
+    OS?: string;
+    isPad?: boolean;
+}
+interface ScreenShape {
+    width: number;
+    height: number;
+}
+/** Visible for tests: map `Platform.OS` to a supported device OS value. */
+export declare function resolveDeviceOs(platformOs: string | undefined): DeviceOs | undefined;
+/** Visible for tests: smallest screen width. `Dimensions` values are already dp. */
+export declare function smallestScreenWidthDp(screen: ScreenShape): number;
+/** Visible for tests: classify phone vs tablet for the current platform. */
+export declare function resolveDeviceTypeFromSources(sources: {
+    platform?: PlatformShape;
+    screen?: ScreenShape;
+}): DeviceType | undefined;
+/** Visible for tests: build the cached device context from RN platform APIs. */
+export declare function resolveDeviceContextFromSources(sources: {
+    platform?: PlatformShape;
+    screen?: ScreenShape;
+}): DeviceContext;
+export declare function resolveDeviceContext(): DeviceContext;
+/**
+ * Resolve and cache device metadata during {@link Userflow.init}.
+ * Re-running init replaces the cache.
+ */
+export declare function cacheDeviceContextAtInit(): DeviceContext;
+/** Returns the context cached at init, or `null` before init. */
+export declare function getCachedDeviceContext(): DeviceContext | null;
+/** Returns cached device fields for UpsertUser, or `{}` before init. */
+export declare function deviceContextUserAttributes(): Record<string, string>;
+/** Optional user-attribute keys added by {@link mergeDeviceContextUserAttributes}. */
+export type DeviceContextUserAttributeMap = Partial<{
+    [SDK_USER_ATTRIBUTE]: SdkPlatform;
+    [DEVICE_OS_USER_ATTRIBUTE]: DeviceOs;
+    [DEVICE_TYPE_USER_ATTRIBUTE]: DeviceType;
+}>;
+/** Merges cached device attrs into identify attributes; caller values win on key conflicts. */
+export declare function mergeDeviceContextUserAttributes<T extends Record<string, unknown>>(attributes?: T): (T & DeviceContextUserAttributeMap) | undefined;
+export declare function formatDeviceContextLog(resolved: DeviceContext | null): string;
+/** Log cached user-attribute values. Requires {@link cacheDeviceContextAtInit}. */
+export declare function logDeviceContext(): void;
+/** @internal Resets init cache between tests. */
+export declare function resetCachedDeviceContextForTests(): void;
+export {};
+//# sourceMappingURL=deviceContext.d.ts.map

package/lib/typescript/module/src/deviceContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceContext.d.ts","sourceRoot":"","sources":["../../../../src/deviceContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC;AACzC,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AACzC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,kEAAkE;AAClE,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,wBAAwB,cAAc,CAAC;AACpD,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AAExD,UAAU,aAAa;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAIpF;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEjE;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,UAAU,GAAG,SAAS,CAWzB;AAED,gFAAgF;AAChF,wBAAgB,+BAA+B,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,aAAa,CAQhB;AAwBD,wBAAgB,oBAAoB,IAAI,aAAa,CAEpD;AAKD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,aAAa,CAGxD;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,IAAI,aAAa,GAAG,IAAI,CAE7D;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQpE;AAED,sFAAsF;AACtF,MAAM,MAAM,6BAA6B,GAAG,OAAO,CAAC;IAClD,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC;IAClC,CAAC,wBAAwB,CAAC,EAAE,QAAQ,CAAC;IACrC,CAAC,0BAA0B,CAAC,EAAE,UAAU,CAAC;CAC1C,CAAC,CAAC;AAEH,+FAA+F;AAC/F,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChF,UAAU,CAAC,EAAE,CAAC,GACb,CAAC,CAAC,GAAG,6BAA6B,CAAC,GAAG,SAAS,CAMjD;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAO7E;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,iDAAiD;AACjD,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/lib/typescript/module/src/expo-router/useUserflowExpoRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUserflowExpoRouter.d.ts","sourceRoot":"","sources":["../../../../../src/expo-router/useUserflowExpoRouter.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAkB5C"}
+{"version":3,"file":"useUserflowExpoRouter.d.ts","sourceRoot":"","sources":["../../../../../src/expo-router/useUserflowExpoRouter.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAwD5C"}

package/lib/typescript/module/src/hostAppVersion.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Read the host app's native marketing version (store version), not the
+ * SDK package version. React Native does not expose the store version on
+ * `Platform`; Expo hosts may use optional expo modules; bare RN reads
+ * `NativeModules.RNDeviceInfo` constants from the bundled device-info native
+ * module (after autolink + rebuild). The OS name is `Platform.OS`.
+ *
+ * Do not `require('react-native-device-info')` — that package throws at import
+ * when the native module is missing, and Metro/Hermes may surface it as uncaught
+ * even inside try/catch.
+ */
+export type HostAppVersionSource = 'expo-application' | 'expo-constants' | 'react-native-device-info' | 'init-override';
+export interface HostAppVersion {
+    version: string;
+    build?: string;
+    source: HostAppVersionSource;
+}
+export interface RNDeviceInfoConstants {
+    appVersion?: string;
+    buildNumber?: string;
+}
+/** Visible for tests: map an `expo-application` module shape to a version. */
+export declare function readExpoApplication(mod: unknown): HostAppVersion | null;
+/** Visible for tests: map an `expo-constants` module shape to a version. */
+export declare function readExpoConstants(mod: unknown): HostAppVersion | null;
+/** Visible for tests: map linked RNDeviceInfo native constants to a version. */
+export declare function readDeviceInfoFromNativeModule(module: RNDeviceInfoConstants | null | undefined): HostAppVersion | null;
+/** Visible for tests: first non-null reader wins (Expo modules, then RNDeviceInfo). */
+export declare function resolveHostAppVersionFromSources(sources: {
+    expoApplication?: unknown;
+    expoConstants?: unknown;
+    deviceInfoNative?: RNDeviceInfoConstants | null;
+}): HostAppVersion | null;
+export declare function resolveHostAppVersion(): HostAppVersion | null;
+export interface HostAppVersionInitOptions {
+    /** When set, overrides auto-detection for the lifetime of this init. */
+    appVersion?: string;
+    appBuild?: string;
+}
+/** Visible for tests: resolve version for init, honoring an optional client override. */
+export declare function resolveHostAppVersionForInit(options?: HostAppVersionInitOptions): HostAppVersion | null;
+/**
+ * Resolve and cache the host app version during {@link Userflow.init}.
+ * Re-running init replaces the cache.
+ */
+export declare function cacheHostAppVersionAtInit(options?: HostAppVersionInitOptions): HostAppVersion | null;
+/** Returns the version cached at init, or `null` before init or when unavailable. */
+export declare function getCachedHostAppVersion(): HostAppVersion | null;
+/** User attribute keys for the host app's native store version. */
+export declare const HOST_APP_VERSION_USER_ATTRIBUTE = "app_version";
+export declare const HOST_APP_BUILD_USER_ATTRIBUTE = "app_build";
+/** Returns cached host version fields for UpsertUser, or `{}` when unavailable. */
+export declare function hostAppVersionUserAttributes(): Record<string, string>;
+/** Optional user-attribute keys added by {@link mergeHostAppVersionUserAttributes}. */
+export type HostAppVersionUserAttributeMap = Partial<{
+    [HOST_APP_VERSION_USER_ATTRIBUTE]: string;
+    [HOST_APP_BUILD_USER_ATTRIBUTE]: string;
+}>;
+/** Merges cached host version attrs into identify attributes; caller values win on key conflicts. */
+export declare function mergeHostAppVersionUserAttributes<T extends Record<string, unknown>>(attributes?: T): (T & HostAppVersionUserAttributeMap) | undefined;
+/** @internal Resets init cache between tests. */
+export declare function resetCachedHostAppVersionForTests(): void;
+export declare function formatHostAppVersionLog(resolved: HostAppVersion | null, os: string): {
+    level: 'log' | 'warn';
+    message: string;
+};
+/** Log the host app's native version and platform OS to the console. */
+export declare function logHostAppVersion(): void;
+//# sourceMappingURL=hostAppVersion.d.ts.map

package/lib/typescript/module/src/hostAppVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostAppVersion.d.ts","sourceRoot":"","sources":["../../../../src/hostAppVersion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,gBAAgB,GAChB,0BAA0B,GAC1B,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+CD,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAOvE;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAYrE;AAED,gFAAgF;AAChF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,GAC/C,cAAc,GAAG,IAAI,CAUvB;AAED,uFAAuF;AACvF,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACjD,GAAG,cAAc,GAAG,IAAI,CAMxB;AAED,wBAAgB,qBAAqB,IAAI,cAAc,GAAG,IAAI,CAM7D;AAED,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yFAAyF;AACzF,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,yBAA8B,GACtC,cAAc,GAAG,IAAI,CAWvB;AAKD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,yBAA8B,GACtC,cAAc,GAAG,IAAI,CAGvB;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,IAAI,cAAc,GAAG,IAAI,CAE/D;AAED,mEAAmE;AACnE,eAAO,MAAM,+BAA+B,gBAAgB,CAAC;AAC7D,eAAO,MAAM,6BAA6B,cAAc,CAAC;AAEzD,mFAAmF;AACnF,wBAAgB,4BAA4B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOrE;AAED,uFAAuF;AACvF,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAAC;IACnD,CAAC,+BAA+B,CAAC,EAAE,MAAM,CAAC;IAC1C,CAAC,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACzC,CAAC,CAAC;AAEH,qGAAqG;AACrG,wBAAgB,iCAAiC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjF,UAAU,CAAC,EAAE,CAAC,GACb,CAAC,CAAC,GAAG,8BAA8B,CAAC,GAAG,SAAS,CAMlD;AAED,iDAAiD;AACjD,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAaD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,EAAE,EAAE,MAAM,GACT;IACD,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,IAAI,IAAI,CAWxC"}

package/lib/typescript/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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":"AAAA,OAAO,EAEL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAY,KAAK,cAAc,EAAqB,MAAM,cAAc,CAAC;AAKhF,OAAO,EASL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,MAAM,MAAM,yBAAyB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAY5E,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE;QACd,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACxC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,GAAG;YAAE,MAAM,IAAI,IAAI,CAAA;SAAE,CAAC;KAC9F,CAAC;IACF,cAAc,CAAC,EAAE;QACf,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG;YAAE,MAAM,IAAI,IAAI,CAAA;SAAE,CAAC;KAChG,CAAC;IACF,uDAAuD;IACvD,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyD;IACvF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0D;IACzF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,0EAA0E;IAC1E,OAAO,CAAC,oBAAoB,CAAuB;IACnD,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,UAAU,CAA6B;gBAEnC,OAAO,EAAE,wBAAwB;IAU7C,SAAS,IAAI,aAAa,GAAG,IAAI;IAIjC,gEAAgE;IAChE,UAAU,IAAI,OAAO;IAIrB,QAAQ,IAAI,kBAAkB;IAmB9B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkBpB,aAAa,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI;IAO9D;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAWd,cAAc;IAmC5B,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkC9C;;;OAGG;IACH,iBAAiB,IAAI,IAAI;IAUzB;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxC;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAUtC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAMhB,sEAAsE;IAChE,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IASlC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC,sDAAsD;IACtD,gBAAgB,IAAI,IAAI;IAIxB,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,IAAI;CASb"}

package/lib/typescript/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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"}