@userflow-tech/react-native 0.2.0 → 0.3.1

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -9,8 +9,6 @@ export type HandleScreenChangeOptions = {
 };
 /** 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;
 /**
@@ -18,6 +16,12 @@ export declare function screenViewedAttributes(location: ClientLocationUpdate):
  * The React Native facade wires this to `UserflowCore.updateScreen`.
  */
 export declare function setScreenChangeReporter(next: ScreenChangeReporter | null): void;
+/**
+ * Observe accepted screen changes (Evaluate JavaScript context, and similar).
+ * Fires immediately with the latest known location when one exists.
+ * A throwing listener does not block the reporter or the other listeners.
+ */
+export declare function subscribeScreenLocation(listener: ScreenChangeReporter): () => void;
 /** Latest screen/path the SDK has recorded, or `null` before the first report. */
 export declare function getCurrentScreenLocation(): ClientLocationUpdate | null;
 /** Activates screen-change tracking after a successful {@link Userflow.init}. */
@@ -35,7 +39,7 @@ export declare function disableScreenTracking(): void;
  * flushed when tracking is enabled (so init-after-mount still picks up the
  * active route).
  *
- * - Expo Router: `{ path: "/settings/billing" }` → wire `screenPath`
+ * - Expo Router: `{ path: "/settings/billing" }` → wire `screenName`
  * - React Navigation / manual: `{ screen: "BillingSettings" }` → wire `screenName`
  */
 export declare function handleScreenChange(location: ClientLocationUpdate | undefined, options?: HandleScreenChangeOptions): void;

package/lib/typescript/module/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,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"}
+{"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;AAeF,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,oBAAoB,GAC7B;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIhC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAalF;AAeD,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,CAMjD"}

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/BannerBar.d.ts

@@ -0,0 +1,14 @@
+import type { FlowActionFragment } from '@userflow-tech/protocol';
+import { EndFlowReasonInput, type BannerSessionFragment } from '@userflow-tech/protocol';
+import * as React from 'react';
+export interface BannerBarProps {
+    session: BannerSessionFragment;
+    onActions: (actions: FlowActionFragment[]) => void;
+    onDismiss: (endReason: EndFlowReasonInput) => void;
+}
+/**
+ * Banner chrome. An overlay parent floats this over the host. A flow parent
+ * keeps it in layout so the app is pushed instead of covered.
+ */
+export declare function BannerBar({ session, onActions, onDismiss, }: BannerBarProps): React.ReactElement | null;
+//# sourceMappingURL=BannerBar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BannerBar.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/BannerBar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAEL,kBAAkB,EAClB,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqB/B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;IACnD,SAAS,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE,cAAc,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAgG5C"}

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

@@ -0,0 +1,15 @@
+import type { BannerSessionFragment, EndFlowReasonInput, FlowActionFragment } from '@userflow-tech/protocol';
+import * as React from 'react';
+export interface BannerSurfaceProps {
+    session: BannerSessionFragment;
+    onActions: (actions: FlowActionFragment[]) => void | Promise<void>;
+    onDismiss: (endReason: EndFlowReasonInput) => void;
+}
+/**
+ * Native banner bar, or a WebView when a button runs Evaluate JavaScript or the
+ * theme has published custom CSS (same CDN stylesheet as userflow.js iframes).
+ */
+export declare function BannerSurface({ session, onActions, onDismiss, }: BannerSurfaceProps): React.ReactElement | null;
+/** @internal */
+export declare function resetBannerSurfaceWarningsForTests(): void;
+//# sourceMappingURL=BannerSurface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BannerSurface.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/BannerSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,SAAS,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACpD;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA6ChD;AAED,gBAAgB;AAChB,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

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

@@ -5,13 +5,14 @@ export interface MadeWithUserflowProps {
     /** Theme main foreground (`fontColor`) — matches web `--userflow-main-foreground-color`. */
     color: string;
     /**
-     * Bubble content inset (modal 24 / tooltip 24). Applied as horizontal + bottom
-     * padding so the legend aligns with the step body, matching the modal mockup.
+     * Bubble content inset (modal 24 / tooltip 24). Only used when `embedded`,
+     * to pull the legend back out to the card edge.
      */
     contentPadding: number;
     /**
-     * When true, horizontal inset comes from the parent ScrollView; only vertical
-     * spacing and bottom inset are applied here (modal body).
+     * When true, the footer sits inside a ScrollView whose start padding is
+     * `contentPadding` and owns the gap above itself (modal body). Otherwise the
+     * parent supplies {@link MADE_WITH_USERFLOW_GAP} and the footer spans the card.
      */
     embedded?: boolean;
 }
@@ -19,10 +20,13 @@ export interface MadeWithUserflowProps {
  * Web "Made with Userflow" attribution (FlowChrome). Shown when the company
  * has `flowBranding` enabled; opens the Userflow homepage with UTM params.
  *
- * Rendered as a card footer (not absolutely pinned to the card corner) so left
- * and bottom insets match the surface content padding.
+ * Sits in the card corner (Figma: 8pt from the start and bottom edges) rather
+ * than on the content inset. Rendered in flow instead of absolutely so a
+ * scaled-up label pushes the card taller instead of overlapping the body.
  */
 export declare function MadeWithUserflow({ company, color, contentPadding, embedded, }: MadeWithUserflowProps): React.ReactElement | null;
 /** Gap between step content/buttons and the branding footer (web spacer height). */
 export declare const MADE_WITH_USERFLOW_GAP = 16;
+/** Legend offset from the card's start and bottom edges. */
+export declare const MADE_WITH_USERFLOW_INSET = 8;
 //# sourceMappingURL=MadeWithUserflow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MadeWithUserflow.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/MadeWithUserflow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC;IACxD,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,KAAK,EACL,cAAc,EACd,QAAgB,GACjB,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA0CnD;AAED,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,KAAK,CAAC"}
+{"version":3,"file":"MadeWithUserflow.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/MadeWithUserflow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC;IACxD,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,KAAK,EACL,cAAc,EACd,QAAgB,GACjB,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAyCnD;AAED,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,IAAI,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"TooltipSurface.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/TooltipSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA4B/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA4CxD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAuCzC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,WAAW,EACX,KAAK,EACL,eAAe,EACf,UAAc,GACf,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA42BjD"}
+{"version":3,"file":"TooltipSurface.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/TooltipSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA6B/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA4CxD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAuCzC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,WAAW,EACX,KAAK,EACL,eAAe,EACf,UAAc,GACf,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA23BjD"}

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

@@ -0,0 +1,15 @@
+import type { BannerFragment } from '@userflow-tech/protocol';
+import { BannerContentLayout } from '@userflow-tech/protocol';
+import type { ViewStyle } from 'react-native';
+import type { EdgeInsets } from './safeArea';
+export { BANNER_CLOSE_SLOT_SIZE, BANNER_ROOT_PADDING } from './bannerBarTokens';
+/** Outer frame: max embed width and builder outer margin (web `userflowjs-banner-frame`). */
+export declare function bannerFrameStyle(banner: BannerFragment): ViewStyle;
+/** Corner radius on the painted bar when configured in the builder. */
+export declare function resolveBannerBarBorderRadius(banner: BannerFragment): number | undefined;
+/** Horizontal inset for overlay hosts — at least Figma inset, or safe area when larger. */
+export declare function bannerOverlayHostPadding(insets: EdgeInsets): ViewStyle;
+/** Flex justification for the inner row (web content-layout modifiers). */
+export declare function bannerInnerJustifyContent(layout: BannerContentLayout): ViewStyle['justifyContent'];
+export declare function bannerInnerStyle(banner: BannerFragment): ViewStyle;
+//# sourceMappingURL=bannerBarLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bannerBarLayout.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/bannerBarLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQ9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMhF,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAWlE;AAED,uEAAuE;AACvE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAGtE;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,SAAS,CAAC,gBAAgB,CAAC,CAU7B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAelE"}

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

@@ -0,0 +1,20 @@
+import type { ViewStyle } from 'react-native';
+/**
+ * End-user banner chrome from Figma `Userflow - React native`
+ * (`BojC6qdlFUytdD1bRsNLV8`, node `1551-1208` — SDK Embed Banner) and web
+ * `userflowjs-banner-*` in bubble-frame.styl. Layout numbers match web
+ * `$padding-*` at 1rem = 16px.
+ */
+export declare const BANNER_ROOT_PADDING = 8;
+export declare const BANNER_INNER_MARGIN_HORIZONTAL = 8;
+export declare const BANNER_INNER_COLUMN_GAP = 16;
+export declare const BANNER_INNER_ROW_GAP = 8;
+export declare const BANNER_BUTTON_GAP = 8;
+export declare const BANNER_BUTTON_PADDING_HORIZONTAL = 12;
+/** Web `--userflow-button-height` default (36). Close control is square at this size. */
+export declare const BANNER_CLOSE_SLOT_SIZE = 36;
+export declare const BANNER_CLOSE_BORDER_RADIUS = 4;
+/** Overlay embed: horizontal inset from screen edges (Figma; excludes builder outer margin). */
+export declare const BANNER_OVERLAY_SCREEN_INSET_HORIZONTAL = 16;
+export declare function bannerOverlayShadowStyle(edge: 'top' | 'bottom'): ViewStyle;
+//# sourceMappingURL=bannerBarTokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bannerBarTokens.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/bannerBarTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,gGAAgG;AAChG,eAAO,MAAM,sCAAsC,KAAK,CAAC;AAIzD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAS1E"}

package/lib/typescript/module/src/surfaces/bannerWebView/BannerWebViewBar.d.ts

@@ -0,0 +1,10 @@
+import type { FlowActionFragment } from '@userflow-tech/protocol';
+import { EndFlowReasonInput, type BannerSessionFragment } from '@userflow-tech/protocol';
+import * as React from 'react';
+export interface BannerWebViewBarProps {
+    session: BannerSessionFragment;
+    onActions: (actions: FlowActionFragment[]) => void | Promise<void>;
+    onDismiss: (endReason: EndFlowReasonInput) => void;
+}
+export declare function BannerWebViewBar({ session, onActions, onDismiss, }: BannerWebViewBarProps): React.ReactElement | null;
+//# sourceMappingURL=BannerWebViewBar.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/BannerWebViewBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerWebViewBar.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/BannerWebViewBar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAEL,kBAAkB,EAClB,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgC/B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,SAAS,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACpD;AAyBD,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA+OnD"}

package/lib/typescript/module/src/surfaces/bannerWebView/bannerAutoRunEvalJs.d.ts

@@ -0,0 +1,7 @@
+import type { BannerFragment } from '@userflow-tech/protocol';
+/**
+ * Evaluate JavaScript bodies from buttons whose **only** actions are EVAL_JS.
+ * Auto-run once when the WebView loads; click still runs the button action list.
+ */
+export declare function collectBannerAutoRunEvalCodes(banner: BannerFragment, lookupAttribute: (fqn: string) => string | null): string[];
+//# sourceMappingURL=bannerAutoRunEvalJs.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/bannerAutoRunEvalJs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerAutoRunEvalJs.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerAutoRunEvalJs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAW9D;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,cAAc,EACtB,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAC9C,MAAM,EAAE,CAwBV"}

package/lib/typescript/module/src/surfaces/bannerWebView/bannerAutoRunSession.d.ts

@@ -0,0 +1,6 @@
+export declare function shouldSkipBannerAutoRunEval(sessionId: string): boolean;
+export declare function markBannerAutoRunEvalComplete(sessionId: string): void;
+export declare function clearBannerAutoRunEvalSession(sessionId: string): void;
+/** @internal */
+export declare function resetBannerAutoRunSessionsForTests(): void;
+//# sourceMappingURL=bannerAutoRunSession.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/bannerAutoRunSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerAutoRunSession.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerAutoRunSession.ts"],"names":[],"mappings":"AAGA,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,gBAAgB;AAChB,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

package/lib/typescript/module/src/surfaces/bannerWebView/bannerNeedsWebView.d.ts

@@ -0,0 +1,13 @@
+import type { BannerFragment, ThemeFragment } from '@userflow-tech/protocol';
+/** POC / local testing when the builder flag is not on the wire yet. */
+export declare function setDebugForceWebViewBanner(enabled: boolean): void;
+/** @internal */
+export declare function resetDebugForceWebViewBannerForTests(): void;
+/**
+ * Use the WebView banner renderer when any button runs Evaluate JavaScript
+ * (needs the shared eval page), when the theme has published custom CSS
+ * (`.userflow-custom-container-*` / `.userflow-custom-button-*` via CDN),
+ * or when {@link setDebugForceWebViewBanner} is true.
+ */
+export declare function bannerNeedsWebView(banner: BannerFragment, theme?: ThemeFragment | null): boolean;
+//# sourceMappingURL=bannerNeedsWebView.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/bannerNeedsWebView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerNeedsWebView.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerNeedsWebView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAO7E,wEAAwE;AACxE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjE;AAED,gBAAgB;AAChB,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAQD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAQhG"}

package/lib/typescript/module/src/surfaces/bannerWebView/bannerThemeStyles.d.ts

@@ -0,0 +1,5 @@
+import type { ThemeFragment } from '@userflow-tech/protocol';
+/** Inline CSS custom properties for banner WebView (subset of web `getThemeRootStyles`). */
+export declare function bannerThemeInlineStyles(theme: ThemeFragment): Record<string, string>;
+export declare function bannerThemeStyleAttribute(theme: ThemeFragment): string;
+//# sourceMappingURL=bannerThemeStyles.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/bannerThemeStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerThemeStyles.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerThemeStyles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAyC7D,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyCpF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAKtE"}

package/lib/typescript/module/src/surfaces/bannerWebView/bannerWebFrameCss.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Banner + bubble-button subset of web `bubble-frame.styl` for custom-banner WebViews.
+ * Custom theme CSS targets the same class names as userflow.js.
+ */
+export declare const BANNER_WEB_FRAME_CSS = "\n.userflowjs-theme-root {\n  line-height: var(--userflow-line-height, 24px);\n  color: var(--userflow-main-foreground-color, inherit);\n  font-weight: var(--userflow-font-weight-normal, 400);\n}\n.userflowjs-theme-root, .userflowjs-theme-root button {\n  font-family: var(--userflow-font-family, system-ui, sans-serif);\n  font-size: var(--userflow-font-size, 16px);\n}\n.userflowjs-theme-root b, .userflowjs-theme-root strong {\n  font-weight: var(--userflow-font-weight-bold, 600);\n}\n.userflowjs-theme-root a {\n  color: var(--userflow-link-color, inherit);\n  text-decoration: underline;\n}\n.userflowjs-theme-root h1 {\n  font-size: var(--userflow-h1-font-size, 1.25em);\n  font-weight: var(--userflow-font-weight-bold, 600);\n  margin: 0 0 16px;\n}\n.userflowjs-theme-root h2 {\n  font-size: var(--userflow-h2-font-size, 1.125em);\n  font-weight: var(--userflow-font-weight-bold, 600);\n  margin: 0 0 16px;\n}\n.userflowjs-theme-root p {\n  margin: 0 0 16px;\n}\n.userflowjs-button-reset {\n  outline: 0;\n  border: 0;\n  padding: 0;\n  margin: 0;\n  background-color: transparent;\n  cursor: pointer;\n}\n.userflowjs-bubble-button-base {\n  display: inline-block;\n  padding: calc((var(--userflow-button-height, 32px) - var(--userflow-line-height, 24px)) / 2) var(--userflow-font-size, 16px);\n  text-align: center;\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  border-radius: 0.375em;\n  font-size: var(--userflow-font-size, 16px);\n  font-weight: var(--userflow-font-weight-bold, 600);\n  height: var(--userflow-button-height, 32px);\n  line-height: var(--userflow-line-height, 24px);\n  border: 0;\n  cursor: pointer;\n}\n.userflowjs-bubble-button {\n  display: inline-flex;\n  align-items: center;\n}\n.userflowjs-bubble-button--primary,\n.userflowjs-bubble-button--default,\n.userflowjs-bubble-button--banner-primary,\n.userflowjs-bubble-button--banner-secondary {\n  font-family: var(--userflow-font-family, system-ui, sans-serif);\n  border-radius: var(--userflow-button-border-radius, 0.375em);\n  min-width: var(--userflow-button-min-width, 0);\n  white-space: normal;\n  max-width: 100%;\n}\n.userflowjs-bubble-button--banner-primary {\n  background-color: var(--userflow-banner-foreground-color);\n  color: var(--userflow-banner-background-color);\n  padding-left: 12px;\n  padding-right: 12px;\n}\n.userflowjs-bubble-button--banner-secondary {\n  background-color: var(--userflow-banner-background-color);\n  color: var(--userflow-banner-foreground-color);\n  border: 1px solid var(--userflow-banner-foreground-color);\n  padding-left: 12px;\n  padding-right: 12px;\n}\n.userflowjs-banner-root {\n  position: relative;\n  background: var(--userflow-banner-background-color);\n  color: var(--userflow-banner-foreground-color);\n  padding: 8px;\n  display: flex;\n  justify-content: space-between;\n  align-items: center;\n  box-sizing: border-box;\n}\n.userflowjs-banner-root--content-layout-START .userflowjs-banner-inner {\n  justify-content: flex-start;\n}\n.userflowjs-banner-root--content-layout-CENTER .userflowjs-banner-inner {\n  justify-content: center;\n}\n.userflowjs-banner-root--content-layout-SPACE_BETWEEN .userflowjs-banner-inner {\n  justify-content: space-between;\n}\n.userflowjs-banner-inner {\n  flex: 1 1 auto;\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  column-gap: 16px;\n  row-gap: 8px;\n  margin: 0 8px;\n  min-width: 0;\n}\n.userflowjs-banner-content {\n  white-space: pre-wrap;\n  overflow-wrap: break-word;\n  flex-shrink: 1;\n  min-width: 0;\n}\n.userflowjs-banner-buttons {\n  display: flex;\n  gap: 8px;\n  flex-shrink: 0;\n}\n.userflowjs-banner-start-spacer {\n  flex: 1 1 0;\n  max-width: var(--userflow-button-height, 32px);\n  height: var(--userflow-button-height, 32px);\n}\n.userflowjs-banner-close {\n  flex-shrink: 0;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--userflow-button-height, 32px);\n  height: var(--userflow-button-height, 32px);\n  color: var(--userflow-banner-foreground-color);\n  background: transparent;\n  padding: 0;\n  border-radius: 4px;\n}\n.userflowjs-banner-close:hover {\n  background-color: var(--userflow-banner-hover-background-color, rgba(0,0,0,0.08));\n}\n";
+//# sourceMappingURL=bannerWebFrameCss.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/bannerWebFrameCss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerWebFrameCss.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerWebFrameCss.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,mpIA4IhC,CAAC"}

package/lib/typescript/module/src/surfaces/bannerWebView/buildCustomBannerHtml.d.ts

@@ -0,0 +1,9 @@
+import type { BannerSessionFragment } from '@userflow-tech/protocol';
+import type { EvalJsContext } from '../../evalJs/types';
+export interface BuildCustomBannerBodyOptions {
+    /** When true, omit eval-only auto-run (e.g. WebView remount while session is still active). */
+    skipAutoRunEval?: boolean;
+}
+export declare function buildCustomBannerBodyHtml(session: BannerSessionFragment, lookupAttribute: (fqn: string) => string | null, serverEndpoint: string, options?: BuildCustomBannerBodyOptions): string;
+export declare function buildCustomBannerHtml(context: EvalJsContext, session: BannerSessionFragment, lookupAttribute: (fqn: string) => string | null, serverEndpoint: string, options?: BuildCustomBannerBodyOptions): string;
+//# sourceMappingURL=buildCustomBannerHtml.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/buildCustomBannerHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCustomBannerHtml.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/buildCustomBannerHtml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA8GxD,MAAM,WAAW,4BAA4B;IAC3C,+FAA+F;IAC/F,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,EAC/C,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,4BAA4B,GACrC,MAAM,CAqCR;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,qBAAqB,EAC9B,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,EAC/C,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,4BAA4B,GACrC,MAAM,CAGR"}

package/lib/typescript/module/src/surfaces/bannerWebView/buttonClassName.d.ts

@@ -0,0 +1,3 @@
+/** Mirrors web `TreeDoc.buttonClassName`. */
+export declare function buttonClassName(appearance: string | null | undefined): string;
+//# sourceMappingURL=buttonClassName.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/buttonClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buttonClassName.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/buttonClassName.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAa7E"}

package/lib/typescript/module/src/surfaces/bannerWebView/resolveCdnHost.d.ts

@@ -0,0 +1,10 @@
+import type { ThemeFragment } from '@userflow-tech/protocol';
+/**
+ * Map the end-user websocket host to the theme stylesheet CDN host
+ * (same convention as web userflow.js).
+ */
+export declare function resolveCdnHost(serverEndpoint: string): string;
+export declare function themePublishedCssVersion(theme: ThemeFragment): string | null;
+export declare function themeHasPublishedCustomCss(theme: ThemeFragment): boolean;
+export declare function resolveCustomStylesheetUrl(serverEndpoint: string, theme: ThemeFragment): string | null;
+//# sourceMappingURL=resolveCdnHost.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/resolveCdnHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveCdnHost.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/resolveCdnHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAe7D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAO5E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAExE;AAED,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,aAAa,GACnB,MAAM,GAAG,IAAI,CAOf"}

package/lib/typescript/module/src/surfaces/bannerWebView/richContentDocToHtml.d.ts

@@ -0,0 +1,3 @@
+import type { LookupAttribute, RichContentDoc } from '../../content/types';
+export declare function richContentDocToHtml(content: string | RichContentDoc | null | undefined, lookupAttribute: LookupAttribute): string;
+//# sourceMappingURL=richContentDocToHtml.d.ts.map

package/lib/typescript/module/src/surfaces/bannerWebView/richContentDocToHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richContentDocToHtml.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/richContentDocToHtml.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EAEf,MAAM,qBAAqB,CAAC;AA+E7B,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,EACnD,eAAe,EAAE,eAAe,GAC/B,MAAM,CAIR"}

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

@@ -0,0 +1,7 @@
+import type { ThemeFragment } from '@userflow-tech/protocol';
+/** Default banner chrome when theme banner tokens are unset (matches product / web debugger palette). */
+export declare const DEFAULT_BANNER_BACKGROUND_COLOR = "#0A1A24";
+export declare const DEFAULT_BANNER_FOREGROUND_COLOR = "#FFFFFF";
+export declare function resolveBannerBackgroundColor(theme: ThemeFragment): string;
+export declare function resolveBannerForegroundColor(theme: ThemeFragment): string;
+//# sourceMappingURL=resolveBannerTheme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBannerTheme.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/resolveBannerTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,yGAAyG;AACzG,eAAO,MAAM,+BAA+B,YAAY,CAAC;AACzD,eAAO,MAAM,+BAA+B,YAAY,CAAC;AAOzD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEzE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEzE"}

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

@@ -1,11 +1,19 @@
+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.
+ * In-flow banners override this so host screens do not add the inset the banner already consumed.
+ */
+export declare function getSafeAreaInsetsContext(): Context<EdgeInsets | null> | null;
 /** @internal */
 export declare function resetSafeAreaInsetsCacheForTests(): void;
 //# sourceMappingURL=safeArea.d.ts.map

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,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAkCD,+EAA+E;AAC/E,wBAAgB,yBAAyB,IAAI,UAAU,CAEtD;AAED,gBAAgB;AAChB,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}
+{"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.2.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.2.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",
@@ -81,7 +93,8 @@
     "react": ">=18.2.0",
     "react-native": ">=0.74.0",
     "react-native-safe-area-context": ">=4.0.0",
-    "react-native-view-shot": ">=5.0.0"
+    "react-native-view-shot": ">=5.0.0",
+    "react-native-webview": ">=13.8.0"
   },
   "peerDependenciesMeta": {
     "@react-native-community/netinfo": {
@@ -122,8 +135,8 @@
     "react-native": "0.81.5",
     "react-native-builder-bob": "^0.30.0",
     "react-native-safe-area-context": "~5.6.0",
-    "react-native-screens": "~4.16.0",
     "react-native-view-shot": "^5.1.1",
+    "react-native-webview": "13.16.1",
     "react-test-renderer": "19.1.0",
     "rimraf": "^5.0.5",
     "typescript": "^5.4.0"

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/AutoAnchorRegistry.ts

@@ -247,6 +247,10 @@ export class AutoAnchorRegistry {
   ): void {
     const inst = this.instances.get(instanceId);
     if (!inst) return;
+    // Stamped hosts call this on every render; notifying for a no-op patch
+    // re-renders registry subscribers, which re-render the stamps.
+    const keys = Object.keys(patch) as (keyof typeof patch)[];
+    if (keys.every((key) => Object.is(inst[key], patch[key]))) return;
 
     const prevIds = {
       manualId: inst.manualId,
@@ -434,6 +438,23 @@ export class AutoAnchorRegistry {
     return byManual.length > 1 || byManual.some((i) => i.ambiguous);
   }
 
+  /**
+   * Whether `inst` still has a look-alike inside `include`.
+   *
+   * The stored {@link AutoAnchorInstance.ambiguous} flag is registry-wide, so a
+   * copy on a covered screen keeps it set. Visibility can only clear that, never
+   * add ambiguity: an instance the registry considers unique stays unique.
+   */
+  isAmbiguousAmong(inst: AutoAnchorInstance, include: (i: AutoAnchorInstance) => boolean): boolean {
+    if (!inst.ambiguous) return false;
+    const peers = (list: AutoAnchorInstance[]) => list.filter((i) => i === inst || include(i));
+    if (inst.manualId) return peers(this.getInstancesByManualId(inst.manualId)).length > 1;
+    return (
+      this.isTwinWithin(inst, peers(this.getInstancesByTemplatePath(inst.templatePath))) ||
+      this.isTwinWithin(inst, peers(this.getInstancesByRegistryKey(inst.registryKey)))
+    );
+  }
+
   /** Test helper — drop every instance and reset ids. */
   clear(): void {
     this.instances.clear();
@@ -494,6 +515,24 @@ export class AutoAnchorRegistry {
     }
   }
 
+  /**
+   * True when `inst` cannot be told apart from another instance in `list`.
+   * An unlabelled group only: no content of its own, or a content signature a
+   * peer shares.
+   */
+  private isTwinWithin(inst: AutoAnchorInstance, list: AutoAnchorInstance[]): boolean {
+    const unlabelled = list.length > 1 && list.every((i) => !i.manualId);
+    if (!unlabelled) return false;
+    const sig = contentSignature(inst);
+    if (!sig) return true;
+    let count = 0;
+    for (const peer of list) {
+      if (contentSignature(peer) === sig) count += 1;
+      if (count > 1) return true;
+    }
+    return false;
+  }
+
   /**
    * Instances sharing a template path are only twins while they look alike.
    * Four rows from one `field()` helper are indistinguishable at register time
@@ -503,19 +542,10 @@ export class AutoAnchorRegistry {
    */
   private recomputeAmbiguity(registryKey: string, templatePath: string, manualId?: string): void {
     const mark = (list: AutoAnchorInstance[]) => {
-      const unlabelled = list.length > 1 && list.every((i) => !i.manualId);
-      const shared = new Map<string, number>();
-      if (unlabelled) {
-        for (const i of list) {
-          const sig = contentSignature(i);
-          if (sig) shared.set(sig, (shared.get(sig) ?? 0) + 1);
-        }
-      }
       for (const i of list) {
-        const sig = unlabelled ? contentSignature(i) : undefined;
-        const twins = unlabelled && (!sig || (shared.get(sig) ?? 0) > 1);
         i.ambiguous =
-          twins || (i.manualId ? this.getInstancesByManualId(i.manualId).length > 1 : false);
+          this.isTwinWithin(i, list) ||
+          (i.manualId ? this.getInstancesByManualId(i.manualId).length > 1 : false);
       }
     };
     mark(this.getInstancesByRegistryKey(registryKey));