@userflow-tech/react-native 0.3.0 → 0.3.1

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

@@ -1,5 +1,7 @@
 /** Matches the web SDK's `userflow:anonymousId` localStorage key. */
 export declare const ANONYMOUS_ID_STORAGE_KEY = "userflow:anonymousId";
+export declare const ANONYMOUS_STORAGE_UNAVAILABLE = "Userflow.identifyAnonymous() is not supported when persistent storage is unavailable.";
+export declare const ANONYMOUS_STORAGE_NOT_LINKED: string;
 export declare function uuid(): string;
 export declare function getOrCreateAnonymousId(): Promise<string>;
 export declare function clearAnonymousId(): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"anonymousId.d.ts","sourceRoot":"","sources":["../../../../src/anonymousId.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,wBAAgB,IAAI,IAAI,MAAM,CAQ7B;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAc9D;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD"}
+{"version":3,"file":"anonymousId.d.ts","sourceRoot":"","sources":["../../../../src/anonymousId.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,eAAO,MAAM,6BAA6B,0FAC+C,CAAC;AAE1F,eAAO,MAAM,4BAA4B,QAEwD,CAAC;AAElG,wBAAgB,IAAI,IAAI,MAAM,CAQ7B;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAe9D;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQtD"}

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":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAqC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACxF,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,YAAY,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC3E,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzF,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,iCAAiC,EACjC,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD;;;OAGG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAkH7B;;;GAGG;AACH,eAAO,MAAM,QAAQ;IACnB,kFAAkF;iBACrE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmDzD;;;;OAIG;0BACmB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG/C,sEAAsE;mBACvD,OAAO,CAAC,IAAI,CAAC;IAG5B;;;OAGG;2BACoB,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAGpE,6DAA6D;qBAEnD,MAAM,eACD,kBAAkB,YACrB,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC;IAgBhB,mFAAmF;mCAEpE,kBAAkB,YACrB,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC;IAchB;;;;;OAKG;sBACe,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG3C,sFAAsF;mBAE3E,MAAM,GAAG,MAAM,eACX,kBAAkB,YACrB,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;OAIG;4BACqB,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;;OAGG;6BACsB,gBAAgB,YAAY,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/F;;;;;OAKG;gBAEK,MAAM,eACC,uBAAuB,YAC1B,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAMhB,mEAAmE;iBACtD,MAAM,GAAG,IAAI;IAG1B,8DAA8D;qBAC7C,kBAAkB;IAGnC;;;OAGG;yBACkB,cAAc,GAAG,IAAI;IAG1C;;;OAGG;wBACiB,aAAa,GAAG,IAAI;IAGxC,4EAA4E;;IAI5E,8EAA8E;;IAI9E,sEAAsE;aACvD,OAAO,CAAC,IAAI,CAAC;IAS5B,+FAA+F;gBACnF,IAAI;IAShB;;;;;OAKG;sBACe,IAAI;IAKtB;;;;;OAKG;6BACsB,MAAM,GAAG,SAAS,GAAG,IAAI;IAKlD;;;OAGG;8BACuB,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAGjE;;;OAGG;gCACyB,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAG1E;;;;;OAKG;2CACoC,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAGxE;;;;OAIG;6BACsB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAG1E;;;;;OAKG;yBACkB,IAAI;IAGzB;;;OAGG;wBACiB,IAAI;CAGzB,CAAC"}

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

@@ -0,0 +1,33 @@
+export declare const INSTALL_CHECK_HEADER = "[Userflow] Native setup is incomplete. Flows may not run until you fix the following, then rebuild the app (a Metro reload is not enough):";
+export declare const INSTALL_ASYNC_STORAGE_LINE = "- @react-native-async-storage/async-storage is not linked. Anonymous users and Builder pairing will not persist. Add it to the app package.json (npx expo install @react-native-async-storage/async-storage), run pod install on iOS, and rebuild.";
+export declare const INSTALL_VIEW_SHOT_LINE = "- react-native-view-shot is not linked, so Builder element selection gets no screenshot. Install react-native-view-shot@^5.0.0 and rebuild. On Expo SDK 54, pin ^5.0.0; an unpinned npx expo install resolves 4.0.3.";
+export declare const INSTALL_WEBVIEW_LINE = "- react-native-webview is not linked. Evaluate JavaScript and WebView banners will not run. Install it (npx expo install react-native-webview) and rebuild.";
+export declare const INSTALL_DEVICE_INFO_LINE = "- react-native-device-info is not linked, so app_version and app_build are not sent. npm install react-native-device-info, then rebuild.";
+export declare const INSTALL_CHECK_FOOTER = "See docs/troubleshooting.md.";
+export declare const EXPO_GO_WARNING = "[Userflow] This app is running in Expo Go, which cannot load the SDK native modules. Builder preview links will not open the app. Use a development build (npx expo run:ios / npx expo run:android).";
+export declare const INIT_OPTIONS_IGNORED_WARNING = "[Userflow] Userflow.init() already ran with different options. The new clientToken, serverEndpoint, and pairingEndpoint are ignored because init runs once per process. Userflow.reset() does not apply new credentials. Restart the app to change them.";
+/** Lines for missing native modules. Empty when the build looks complete. */
+export declare function collectInstallFindings(): string[];
+export declare function expoGoWarning(): string | null;
+export declare function formatInstallWarning(findings: readonly string[]): string;
+/**
+ * One development warning for missing native modules, plus a separate warning
+ * when the host is Expo Go. Release builds stay quiet.
+ */
+export declare function warnIfInstallIncomplete(): void;
+/** @internal */
+export declare function resetInstallCheckForTests(): void;
+export declare function warnIfInitOptionsIgnored(config: {
+    clientToken: string;
+    serverEndpoint?: string;
+    pairingEndpoint?: string;
+}): void;
+/** The in-flight `init` resolved, so later calls really are ignored. */
+export declare function commitInitOptions(): void;
+/**
+ * The in-flight `init` rejected. Core drops its cached promise and will run
+ * the next call, so a corrected token or endpoint must not warn.
+ * A rejection after a successful init does not forget that success.
+ */
+export declare function releaseFailedInitOptions(): void;
+//# sourceMappingURL=installCheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installCheck.d.ts","sourceRoot":"","sources":["../../../../src/installCheck.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,+IAC6G,CAAC;AAE/I,eAAO,MAAM,0BAA0B,uPAC+M,CAAC;AAEvP,eAAO,MAAM,sBAAsB,yNACqL,CAAC;AAEzN,eAAO,MAAM,oBAAoB,gKAC8H,CAAC;AAEhK,eAAO,MAAM,wBAAwB,6IACuG,CAAC;AAE7I,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAEnE,eAAO,MAAM,eAAe,yMAC4K,CAAC;AAEzM,eAAO,MAAM,4BAA4B,6PACmN,CAAC;AAyD7P,6EAA6E;AAC7E,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAWjD;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAI7C;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAExE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAe9C;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,IAAI,IAAI,CAIhD;AAwBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,IAAI,CAgBP;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}

package/lib/typescript/module/src/pairing/deviceId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deviceId.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/deviceId.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAIxE,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAsBlE;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
+{"version":3,"file":"deviceId.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/deviceId.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAIxE,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CA0BlE;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

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

@@ -9,7 +9,8 @@ export interface TargetPressBridgeProps {
  *
  * 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}.
+ * against the rect registered by {@link TooltipSurface}, and — while an
+ * element click condition is tracked — against the fiber under the finger.
  *
  * Preview-chrome double taps are observed by `DoubleTapBridge` around the
  * whole provider tree — this bridge never sees overlay touches.

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;AAQ/B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,CA0C1F"}
+{"version":3,"file":"TargetPressBridge.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/TargetPressBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,CAuD1F"}

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,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAuB/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yDAAyD;IACzD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AA0CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,gBAAgB,GAC/B,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAoF5C;AAiBD,2EAA2E;AAC3E,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD"}
+{"version":3,"file":"UserflowProvider.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/UserflowProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA2B/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yDAAyD;IACzD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AA0CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,gBAAgB,GAC/B,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAoF5C;AAoBD,2EAA2E;AAC3E,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD"}

package/lib/typescript/module/src/storage/asyncStorage.d.ts

@@ -0,0 +1,15 @@
+export interface AsyncStorageLike {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/** True when some AsyncStorage native binary is in this build. */
+export declare function isAsyncStorageLinked(): boolean;
+/**
+ * The AsyncStorage JS API, or `null` when the package or its native module is
+ * missing. Never requires the package until the native module is registered.
+ */
+export declare function getAsyncStorage(): AsyncStorageLike | null;
+/** @internal */
+export declare function resetAsyncStorageCacheForTests(): void;
+//# sourceMappingURL=asyncStorage.d.ts.map

package/lib/typescript/module/src/storage/asyncStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncStorage.d.ts","sourceRoot":"","sources":["../../../../../src/storage/asyncStorage.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AA6BD,kEAAkE;AAClE,wBAAgB,oBAAoB,IAAI,OAAO,CAI9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAyBzD;AAED,gBAAgB;AAChB,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/lib/typescript/module/src/surfaces/safeArea.d.ts

@@ -1,11 +1,13 @@
-import type { Context } from 'react';
+import { type Context } from 'react';
 export interface EdgeInsets {
     top: number;
     right: number;
     bottom: number;
     left: number;
 }
-/** Safe-area insets with a zero fallback when the optional peer is missing. */
+export declare const MISSING_SAFE_AREA_PROVIDER_WARNING: string;
+/** Value from the nearest provider, or `null` when the peer or provider is absent. */
+export declare function useParentSafeAreaInsets(): EdgeInsets | null;
 export declare function useUserflowSafeAreaInsets(): EdgeInsets;
 /**
  * `SafeAreaInsetsContext` from the optional peer, or `null` when it is not installed.

package/lib/typescript/module/src/surfaces/safeArea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safeArea.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/safeArea.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAmCD,+EAA+E;AAC/E,wBAAgB,yBAAyB,IAAI,UAAU,CAEtD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,IAAI,CAmB5E;AAED,gBAAgB;AAChB,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD"}
+{"version":3,"file":"safeArea.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/safeArea.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAUD,eAAO,MAAM,kCAAkC,QAGZ,CAAC;AAuEpC,sFAAsF;AACtF,wBAAgB,uBAAuB,IAAI,UAAU,GAAG,IAAI,CAE3D;AAED,wBAAgB,yBAAyB,IAAI,UAAU,CAMtD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,IAAI,CAE5E;AAED,gBAAgB;AAChB,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD"}

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

@@ -1,3 +1,3 @@
 /** Generated by scripts/write-version.mjs — do not edit. */
-export declare const SDK_VERSION = "0.3.0";
+export declare const SDK_VERSION = "0.3.1";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@userflow-tech/react-native",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Userflow SDK for React Native — onboarding flows, tooltips, and modals.",
   "license": "SEE LICENSE IN LICENSE",
   "main": "./lib/commonjs/index.js",
@@ -10,6 +10,10 @@
   "source": "src/index.ts",
   "exports": {
     ".": {
+      "types": {
+        "import": "./lib/typescript/module/src/index.d.ts",
+        "require": "./lib/typescript/commonjs/src/index.d.ts"
+      },
       "react-native": "./src/index.ts",
       "import": {
         "types": "./lib/typescript/module/src/index.d.ts",
@@ -21,6 +25,10 @@
       }
     },
     "./navigation": {
+      "types": {
+        "import": "./lib/typescript/module/src/navigation/index.d.ts",
+        "require": "./lib/typescript/commonjs/src/navigation/index.d.ts"
+      },
       "react-native": "./src/navigation/index.ts",
       "import": {
         "types": "./lib/typescript/module/src/navigation/index.d.ts",
@@ -32,6 +40,10 @@
       }
     },
     "./expo-router": {
+      "types": {
+        "import": "./lib/typescript/module/src/expo-router/index.d.ts",
+        "require": "./lib/typescript/commonjs/src/expo-router/index.d.ts"
+      },
       "react-native": "./src/expo-router/index.ts",
       "import": {
         "types": "./lib/typescript/module/src/expo-router/index.d.ts",

package/src/anchors/AnchorRegistry.ts

@@ -8,6 +8,11 @@ export interface AnchorHost {
    * Called when the measured rect is not fully visible (bounded retries per step).
    */
   scrollIntoView?: () => void;
+  /**
+   * Public instance this host was registered from, when known. Element click
+   * conditions use it to match a tap to this anchor.
+   */
+  node?: object | null;
 }
 
 type Listener = () => void;
@@ -52,6 +57,13 @@ export class AnchorRegistry {
     return last;
   }
 
+  /** Every host registered for `id`, in registration order. */
+  getAll(id: string): AnchorHost[] {
+    const set = this.anchors.get(id);
+    if (!set || set.size === 0) return [];
+    return [...set];
+  }
+
   /** True when more than one host is registered for the same id. */
   isAmbiguous(id: string): boolean {
     return (this.anchors.get(id)?.size ?? 0) > 1;

package/src/anchors/elementConditionEvaluator.ts

@@ -1,35 +1,43 @@
-import type { ConditionEvaluator } from '@userflow-tech/core';
-import type { FlowConditionFragment } from '@userflow-tech/protocol';
+import type {
+  ConditionEvaluator,
+  ConditionEvaluatorContext,
+  ConditionReport,
+} from '@userflow-tech/core';
+import { decodeMobileAutoData, type FlowConditionFragment } from '@userflow-tech/protocol';
 
 import { anchorChangeTicker } from './anchorChangeTicker';
-import { resolveAnchorHost } from './resolveAnchorHost';
-import { resolveAutoAnchorHost } from './resolveAutoAnchorHost';
+import { elementTapMonitor } from './elementTapMonitor';
+import { fiberIsUnder, tapPathDisabled } from './elementTargetMatch';
+import {
+  resolveElementTargets,
+  tapMayHitSelector,
+  type ElementTarget,
+} from './resolveElementTargets';
 import { resolveManualAnchorId } from './resolveManualAnchorId';
 
-/** ELEMENT states the mobile SDK can evaluate today. */
-const SUPPORTED_ELEMENT_STATES = new Set(['PRESENT', 'NOT_PRESENT']);
+/** How many hosts to measure before giving up on a crowded duplicate id. */
+const MAX_MEASURED_HOSTS = 8;
+
+/** Same bound tooltip measurement uses. A host that never calls back is unknown. */
+const MEASURE_TIMEOUT_MS = 400;
 
 /**
  * Evaluate ELEMENT client conditions against manual anchors, fiber-resolved
- * `testID` / `nativeID` / `accessibilityLabel` targets, and AUTO (codeless)
- * selectors.
+ * `userflowId` / `testID` / `nativeID` / `accessibilityLabel` targets, and AUTO
+ * (codeless) selectors.
  *
- * Supports PRESENT / NOT_PRESENT for MANUAL selectors (`css` → anchor id) and
- * AUTO selectors (`autoData` → {@link resolveAutoAnchorHost}). AUTO fails
- * closed: `unknown` / `ambiguous` stay `null` so a gated flow never starts
- * just because the auto-anchor registry is empty. Web-interaction states
- * (CLICK, DISABLED, …) still report unknown.
+ * PRESENT / NOT_PRESENT: any uniquely-or-not host on a visible navigator screen
+ * counts (web parity — duplicates are present). A measured 0×0 host counts as
+ * absent. AUTO `unknown` / `ambiguous` stay `null`.
  *
- * "Present" means a unique host on a **visible** navigator screen. MANUAL
- * goes through `resolveAnchorHost`; AUTO through `resolveAutoAnchorHost`.
- * Both skip screens covered by another navigator screen, so an id on a
- * pushed-under screen counts as absent. Pixel visibility (off-screen inside a
- * ScrollView, opacity 0, etc.) would need async `measureInWindow` and is out
- * of scope.
+ * CLICK / NOT_CLICK: latch from the first matching tap, including a tap on a
+ * descendant. The latch survives re-attach via `previousIsTrue` and is cleared
+ * when the server untracks. Disabled hosts are ignored. Until it latches, an
+ * AUTO selector that does not resolve reports `null`, like presence.
  *
- * Note: compares string literals rather than importing protocol enums so Jest
- * (which cannot resolve the ESM-only `@userflow-tech/protocol` package) stays
- * hermetic. Wire values match `FlowConditionElementState` / `FlowSelectorType`.
+ * Element states are compared as string literals rather than protocol enums so
+ * the wire values stay obvious next to the branches. They match
+ * `FlowConditionElementState`.
  */
 export function createElementConditionEvaluator(
   warn: (message: string) => void = (message) => {
@@ -47,75 +55,232 @@ export function createElementConditionEvaluator(
     warn(message);
   };
 
-  return (condition, report) => {
-    const evaluate = (): void => {
-      const result = evaluateElementCondition(condition, warnOnce);
-      report(result);
-    };
+  return (condition, report, context) => {
+    const elementState = condition.elementState as string | null;
+    if (elementState === 'PRESENT' || elementState === 'NOT_PRESENT') {
+      return trackPresence(condition, elementState, report, warnOnce);
+    }
+    if (elementState === 'CLICK' || elementState === 'NOT_CLICK') {
+      return trackClick(condition, elementState, report, context, warnOnce);
+    }
 
-    evaluate();
-    return anchorChangeTicker.subscribe(evaluate);
+    warnOnce(
+      condition.id,
+      `[Userflow] ELEMENT condition ${condition.id} uses unsupported elementState ` +
+        `"${elementState ?? 'null'}" (supported: PRESENT, NOT_PRESENT, CLICK, NOT_CLICK); ` +
+        'leaving unknown',
+    );
+    report(null);
+    return () => {};
   };
 }
 
-function evaluateElementCondition(
+function trackPresence(
   condition: FlowConditionFragment,
+  elementState: 'PRESENT' | 'NOT_PRESENT',
+  report: ConditionReport,
   warnOnce: (conditionId: string, message: string) => void,
-): boolean | null {
-  const elementState = condition.elementState as string | null;
-  if (elementState == null || !SUPPORTED_ELEMENT_STATES.has(elementState)) {
-    warnOnce(
-      condition.id,
-      `[Userflow] ELEMENT condition ${condition.id} uses unsupported elementState ` +
-        `"${elementState ?? 'null'}" (only PRESENT / NOT_PRESENT are supported); ` +
-        'leaving unknown',
+): () => void {
+  // A synchronous result supersedes any older measurement. Only one
+  // measurement runs at a time, and a change during it re-runs once it settles
+  // instead of discarding it, so steady anchor churn cannot hold the condition
+  // at unknown.
+  let generation = 0;
+  let reportedGeneration = 0;
+  let measuring = false;
+  let changedWhileMeasuring = false;
+  let disposed = false;
+
+  const evaluate = (): void => {
+    if (disposed) return;
+    const gen = ++generation;
+    const resolution = resolveElementTargets(condition.selector);
+
+    if (resolution.status === 'unknown') {
+      if (!resolution.silent) warnUnknown(condition, warnOnce);
+      reportedGeneration = gen;
+      report(null);
+      return;
+    }
+    if (resolution.status === 'absent') {
+      reportedGeneration = gen;
+      report(elementState === 'PRESENT' ? false : true);
+      return;
+    }
+    if (measuring) {
+      changedWhileMeasuring = true;
+      return;
+    }
+
+    measuring = true;
+    void measureVisibility(resolution.targets)
+      .catch((): HostVisibility => 'unknown')
+      .then((visibility) => {
+        measuring = false;
+        if (disposed) return;
+        if (gen > reportedGeneration) {
+          reportedGeneration = gen;
+          if (visibility === 'unknown') {
+            report(null);
+          } else {
+            const present = visibility === 'present';
+            report(elementState === 'PRESENT' ? present : !present);
+          }
+        }
+        if (changedWhileMeasuring) {
+          changedWhileMeasuring = false;
+          evaluate();
+        }
+      });
+  };
+
+  evaluate();
+  const unsubscribe = anchorChangeTicker.subscribe(evaluate);
+  return () => {
+    disposed = true;
+    unsubscribe();
+  };
+}
+
+function trackClick(
+  condition: FlowConditionFragment,
+  elementState: 'CLICK' | 'NOT_CLICK',
+  report: ConditionReport,
+  context: ConditionEvaluatorContext | undefined,
+  warnOnce: (conditionId: string, message: string) => void,
+): () => void {
+  if (!clickSelectorUsable(condition)) {
+    warnUnknown(condition, warnOnce);
+    report(null);
+    return () => {};
+  }
+
+  // CLICK starts false and latches true. NOT_CLICK starts true and latches false.
+  const valueWhenOccurred = elementState === 'CLICK';
+  if (context?.previousIsTrue === valueWhenOccurred) {
+    report(valueWhenOccurred);
+    return () => {};
+  }
+
+  let latched = false;
+  let stopWatchingResolution = (): void => {};
+  if ((condition.selector?.type as string | null) === 'AUTO') {
+    // An AUTO selector can stay unresolvable (empty auto-anchor registry, a
+    // tie between look-alikes), and then no tap can latch. Report unknown
+    // until it resolves, as presence does, rather than an unclicked value
+    // nothing could clear.
+    const reportUnclickedOnceResolvable = (): void => {
+      if (latched) return;
+      const resolution = resolveElementTargets(condition.selector);
+      if (resolution.status === 'unknown') {
+        if (!resolution.silent) warnUnknown(condition, warnOnce);
+        report(null);
+        return;
+      }
+      report(!valueWhenOccurred);
+    };
+    reportUnclickedOnceResolvable();
+    stopWatchingResolution = anchorChangeTicker.subscribe(reportUnclickedOnceResolvable);
+  } else {
+    report(!valueWhenOccurred);
+  }
+
+  const subscription = {
+    unsubscribe: (): void => {},
+  };
+  subscription.unsubscribe = elementTapMonitor.subscribe((tap) => {
+    if (latched) return;
+    if (!tapMayHitSelector(condition.selector, tap)) return;
+    const resolution = resolveElementTargets(condition.selector);
+    if (resolution.status !== 'found') return;
+
+    const matched = resolution.targets.find(
+      (target) => target.fiber != null && fiberIsUnder(tap.targetFiber, target.fiber),
     );
-    return null;
+    if (!matched?.fiber) return;
+    if (tapPathDisabled(tap.targetFiber, matched.fiber)) return;
+
+    latched = true;
+    report(valueWhenOccurred, { immediate: true });
+    subscription.unsubscribe();
+    stopWatchingResolution();
+  });
+
+  return () => {
+    subscription.unsubscribe();
+    stopWatchingResolution();
+  };
+}
+
+function clickSelectorUsable(condition: FlowConditionFragment): boolean {
+  const selector = condition.selector;
+  if (selector == null) return false;
+  if ((selector.type as string | null) === 'AUTO') {
+    // Without a fingerprint the selector can never resolve, so a definite
+    // NOT_CLICK true would start the flow on a target nobody can tap.
+    return decodeMobileAutoData(selector.autoData)?.fingerprint != null;
   }
+  return resolveManualAnchorId(selector.css) != null;
+}
 
+function warnUnknown(
+  condition: FlowConditionFragment,
+  warnOnce: (conditionId: string, message: string) => void,
+): void {
   const selector = condition.selector;
   if (selector == null) {
     warnOnce(
       condition.id,
       `[Userflow] ELEMENT condition ${condition.id} has no selector; leaving unknown`,
     );
-    return null;
+    return;
   }
-
   if ((selector.type as string | null) === 'AUTO') {
-    const resolution = resolveAutoAnchorHost(selector.autoData);
-    if (resolution.status === 'unknown') {
-      warnOnce(
-        condition.id,
-        `[Userflow] ELEMENT condition ${condition.id} uses an AUTO (codeless) selector ` +
-          'that could not be resolved; leaving unknown',
-      );
-      return null;
-    }
-    if (resolution.status === 'ambiguous') {
-      return null;
-    }
-    const present = resolution.status === 'found';
-    return elementState === 'PRESENT' ? present : !present;
-  }
-
-  const anchorId = resolveManualAnchorId(selector.css);
-  if (anchorId == null) {
     warnOnce(
       condition.id,
-      `[Userflow] ELEMENT condition ${condition.id} has no resolvable manual anchor id; ` +
-        'leaving unknown',
+      `[Userflow] ELEMENT condition ${condition.id} uses an AUTO (codeless) selector ` +
+        'that could not be resolved; leaving unknown',
     );
-    return null;
+    return;
   }
+  warnOnce(
+    condition.id,
+    `[Userflow] ELEMENT condition ${condition.id} has no resolvable manual anchor id; ` +
+      'leaving unknown',
+  );
+}
 
-  const resolution = resolveAnchorHost(anchorId);
-  // Ambiguous counts as not present for PRESENT (fail closed) and as "present"
-  // for NOT_PRESENT would be wrong — treat ambiguous as unknown so gated flows
-  // stay blocked rather than inventing a truth value.
-  if (resolution.status === 'ambiguous') {
-    return null;
+type HostVisibility = 'present' | 'absent' | 'unknown';
+
+/** Measures hosts in parallel so duplicates cost one timeout, not one each. */
+async function measureVisibility(targets: ElementTarget[]): Promise<HostVisibility> {
+  const slice = targets.slice(0, MAX_MEASURED_HOSTS);
+  const measured = await Promise.all(slice.map(measureHost));
+  if (measured.some((size) => size !== 'timeout' && size.width > 0 && size.height > 0)) {
+    return 'present';
   }
-  const present = resolution.status === 'found';
-  return elementState === 'PRESENT' ? present : !present;
+  if (measured.includes('timeout') || targets.length > slice.length) return 'unknown';
+  return 'absent';
+}
+
+function measureHost(
+  target: ElementTarget,
+): Promise<{ width: number; height: number } | 'timeout'> {
+  return new Promise((resolve) => {
+    let settled = false;
+    const finish = (value: { width: number; height: number } | 'timeout'): void => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(value);
+    };
+    const timer = setTimeout(() => finish('timeout'), MEASURE_TIMEOUT_MS);
+    try {
+      target.host.measureInWindow((_x, _y, width, height) => {
+        finish({ width, height });
+      });
+    } catch {
+      finish('timeout');
+    }
+  });
 }