@userflow-tech/react-native 0.4.5 → 0.6.0

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

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { LayoutChangeEvent } from 'react-native';
+export type PushBannerLayoutEdge = 'top' | 'bottom';
+export declare function PushBannerLayoutProvider({ children, onActiveEdgeChange, }: {
+    children: React.ReactNode;
+    onActiveEdgeChange: (edge: PushBannerLayoutEdge | null) => void;
+}): React.ReactElement;
+/** @internal */
+export declare function usePushBannerLayoutRegistration(edge: PushBannerLayoutEdge | null | undefined, sessionId: string | undefined): void;
+/**
+ * Clears the host top/bottom safe-area override only after push-layout chrome
+ * has laid out, so a session without visible chrome cannot leave a white strip.
+ *
+ * Remembers which edge laid out instead of resetting a flag in an effect: on
+ * Fabric the chrome's first onLayout can run before the mount's passive effects
+ * flush, and a reset there would discard it until the banner happened to
+ * re-layout, leaving already-mounted host screens on the old inset.
+ *
+ * @internal
+ */
+export declare function usePushBannerHostInsetRegistration(edge: PushBannerLayoutEdge | null | undefined, sessionId: string, enabled: boolean): (event: LayoutChangeEvent) => void;
+//# sourceMappingURL=pushBannerLayoutContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pushBannerLayoutContext.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/pushBannerLayoutContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,CAAC;AA8BpD,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,kBAAkB,GACnB,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,kBAAkB,EAAE,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC;CACjE,GAAG,KAAK,CAAC,YAAY,CA+BrB;AAED,gBAAgB;AAChB,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EAC7C,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,IAAI,CAYN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAoBpC"}

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

@@ -7,6 +7,12 @@ export type HandleScreenChangeOptions = {
     /** Re-run the reporter even when the location matches the last report. */
     force?: boolean;
 };
+/**
+ * The screen id stored on an AUTO envelope (`path` for Expo Router, `screen`
+ * otherwise). Missing or blank locations are `'unknown'`, the same sentinel
+ * the element picker writes when it has not seen a screen yet.
+ */
+export declare function screenIdFromLocation(location: ClientLocationUpdate | null | undefined): string;
 /** Event attributes for `screen_viewed`, or `null` when the location has no identity. */
 export declare function screenViewedAttributes(location: ClientLocationUpdate): {
     screen_name: string;

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;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"}
+{"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;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAI9F;AAED,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/surfaces/BannerBar.d.ts

@@ -3,6 +3,8 @@ import { EndFlowReasonInput, type BannerSessionFragment } from '@userflow-tech/p
 import * as React from 'react';
 export interface BannerBarProps {
     session: BannerSessionFragment;
+    pushLayoutEdge?: 'top' | 'bottom' | null;
+    overlaySafeEdge?: 'top' | 'bottom' | null;
     onActions: (actions: FlowActionFragment[]) => void;
     onDismiss: (endReason: EndFlowReasonInput) => void;
 }
@@ -10,5 +12,5 @@ export interface BannerBarProps {
  * 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;
+export declare function BannerBar({ session, pushLayoutEdge, overlaySafeEdge, onActions, onDismiss, }: BannerBarProps): React.ReactElement | null;
 //# sourceMappingURL=BannerBar.d.ts.map

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

@@ -1 +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"}
+{"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;AAyB/B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC1C,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,cAAqB,EACrB,eAAsB,EACtB,SAAS,EACT,SAAS,GACV,EAAE,cAAc,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA8H5C"}

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

@@ -2,14 +2,15 @@ import type { BannerSessionFragment, EndFlowReasonInput, FlowActionFragment } fr
 import * as React from 'react';
 export interface BannerSurfaceProps {
     session: BannerSessionFragment;
+    /** When set, the banner pushes host layout and fills the safe-area inset on this edge. */
+    pushLayoutEdge?: 'top' | 'bottom' | null;
+    /** Overlay host edge — paints safe-area padding without pushing layout. */
+    overlaySafeEdge?: 'top' | 'bottom' | null;
     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;
+/** Native banner bar, or a WebView when `customBannerEnabled` is set on the banner. */
+export declare function BannerSurface({ session, pushLayoutEdge, overlaySafeEdge, 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

@@ -1 +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,CA+ChD;AAED,gBAAgB;AAChB,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}
+{"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,0FAA0F;IAC1F,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IACzC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC1C,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,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,cAAqB,EACrB,eAAsB,EACtB,SAAS,EACT,SAAS,GACV,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAgGhD;AAED,gBAAgB;AAChB,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

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

@@ -1 +1 @@
-{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/ProgressBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAIpD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAc,EACd,cAAkB,GACnB,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA8D9C"}
+{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/ProgressBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAIpD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAc,EACd,cAAkB,GACnB,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA8D9C"}

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

@@ -1,5 +1,5 @@
 import type { FlowSessionEngine } from '@userflow-tech/core';
-import type { FlowSessionFragment, FlowStepFragment, ThemeFragment } from '@userflow-tech/protocol';
+import { type FlowSessionFragment, type FlowStepFragment, type ThemeFragment } from '@userflow-tech/protocol';
 import * as React from 'react';
 import type { LookupAttribute } from '../content/types';
 export interface TooltipSurfaceProps {

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;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"}
+{"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,EAGL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgC/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA8CxD,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;AAID;;;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,CAk5BjD"}

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

@@ -3,6 +3,16 @@ 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';
+/** Fixed horizontal chrome inside the embed width (padding, close/spacer slots, inner margins). */
+export declare function bannerHorizontalChromeWidth(): number;
+/** Outer bar cap — max embed width only (max content width limits the inner row on web). */
+export declare function resolveBannerFrameMaxWidth(banner: BannerFragment): number | null;
+export declare function bannerHasMaxContentWidth(banner: BannerFragment): boolean;
+/**
+ * Cap for the native inner row and WebView HTML `.userflowjs-banner-inner` only.
+ * Returns null when max content width is unset. May be 0 when embed width is narrower than chrome.
+ */
+export declare function resolveBannerInnerMaxWidth(banner: BannerFragment): number | null;
 /** 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. */
@@ -11,5 +21,12 @@ export declare function resolveBannerBarBorderRadius(banner: BannerFragment): nu
 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'];
+/**
+ * Push-layout chrome: safe-area pad + bar background on the same node as the
+ * fade so an animated banner does not leave a visible status-bar strip at opacity 0.
+ */
+export declare function bannerPushLayoutChrome(edge: 'top' | 'bottom', insets: EdgeInsets, backgroundColor: string): ViewStyle;
+/** Painted bar (`userflow-banner`) — fill the frame so max embed width clips chrome, not just margins. */
+export declare function bannerBarRootStyle(banner: BannerFragment): ViewStyle;
 export declare function bannerInnerStyle(banner: BannerFragment): ViewStyle;
 //# sourceMappingURL=bannerBarLayout.d.ts.map

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

@@ -1 +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"}
+{"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;AAU9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMhF,mGAAmG;AACnG,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAEhF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAExE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAUhF;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAkBlE;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;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,KAAK,GAAG,QAAQ,EACtB,MAAM,EAAE,UAAU,EAClB,eAAe,EAAE,MAAM,GACtB,SAAS,CAMX;AAKD,0GAA0G;AAC1G,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAQpE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAmBlE"}

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

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

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

@@ -1 +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"}
+{"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;AAmC/B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC1C,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,cAAqB,EACrB,eAAsB,EACtB,SAAS,EACT,SAAS,GACV,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAsUnD"}

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

@@ -1,13 +1,4 @@
-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;
+import type { BannerFragment } from '@userflow-tech/protocol';
+/** Use the WebView banner renderer when the builder enabled custom banners. */
+export declare function bannerNeedsWebView(banner: BannerFragment): boolean;
 //# sourceMappingURL=bannerNeedsWebView.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"bannerNeedsWebView.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerNeedsWebView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAElE"}

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

@@ -1 +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"}
+{"version":3,"file":"bannerThemeStyles.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerThemeStyles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA0C7D,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/bannerWebViewHeight.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Height the native WebView should use for a custom banner.
+ *
+ * Custom CSS often sizes the card with `min-height` and takes the copy and
+ * buttons out of flow (`position: absolute`). The WebView is created shorter
+ * than that card, so a root that only looks as tall as the viewport because of
+ * `min-height` must not be replaced with the close button's box.
+ *
+ * When the root really is stretching to fill a taller viewport (`height: 100%`),
+ * fall back to in-flow content, and never below `min-height`.
+ */
+export declare function resolveBannerWebViewHeight(rectHeight: number, scrollHeight: number, viewportHeight: number, minHeight: number, contentHeight: number): number;
+//# sourceMappingURL=bannerWebViewHeight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bannerWebViewHeight.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/bannerWebViewHeight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CAcR"}

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

@@ -1 +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"}
+{"version":3,"file":"buildCustomBannerHtml.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/bannerWebView/buildCustomBannerHtml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAQrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAsLxD,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,CAiDR;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/hostAccessibilityTrap.d.ts

@@ -0,0 +1,14 @@
+import type { FlowStepFragment } from '@userflow-tech/protocol';
+/**
+ * Whether a step hides host app content from the accessibility tree.
+ *
+ * Modals always do. A tooltip does only when `tooltipTargetBlocked` seals its
+ * target too — otherwise the target is the control the step asks the user to
+ * press, so a screen reader has to be able to reach it.
+ *
+ * `UserflowOverlay` traps the host with this, and tooltip cards gate
+ * `accessibilityViewIsModal` on it: on iOS that flag alone drops the host app,
+ * target included, out of VoiceOver's reach.
+ */
+export declare function stepTrapsHostAccessibility(step: Pick<FlowStepFragment, 'appearance' | 'tooltipTargetBlocked'>): boolean;
+//# sourceMappingURL=hostAccessibilityTrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostAccessibilityTrap.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/hostAccessibilityTrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,sBAAsB,CAAC,GAClE,OAAO,CAST"}

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

@@ -1,5 +1,8 @@
 import type { ThemeFragment } from '@userflow-tech/protocol';
-/** Default banner chrome when theme banner tokens are unset (matches product / web debugger palette). */
+/**
+ * Last-resort banner chrome when neither banner nor brand tokens are set on the
+ * wire (web `applyThemeDefaults` falls back to brand first).
+ */
 export declare const DEFAULT_BANNER_BACKGROUND_COLOR = "#0A1A24";
 export declare const DEFAULT_BANNER_FOREGROUND_COLOR = "#FFFFFF";
 export declare function resolveBannerBackgroundColor(theme: ThemeFragment): string;

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

@@ -1 +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"}
+{"version":3,"file":"resolveBannerTheme.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/resolveBannerTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,YAAY,CAAC;AACzD,eAAO,MAAM,+BAA+B,YAAY,CAAC;AAOzD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAMzE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAMzE"}

package/lib/typescript/module/src/surfaces/tooltip/TooltipBubble.d.ts

@@ -15,6 +15,12 @@ export interface TooltipBubbleProps {
      * target. Defaults to true so isolated chrome tests keep the diamond.
      */
     showNotch?: boolean;
+    /**
+     * iOS: confine VoiceOver to this card. VoiceOver then skips the host app,
+     * including the target, so set it only while the host is hidden from
+     * accessibility anyway. Defaults to false.
+     */
+    accessibilityViewIsModal?: boolean;
 }
 /**
  * Tooltip chrome shell: diamond notch + card fill sharing one shadow family.
@@ -34,5 +40,5 @@ export interface TooltipBubbleProps {
  * iOS gets `shadow*` on the notch (`elevation` is inert there); Android gets
  * `elevation`, which is the only shadow it honors on a rotated view.
  */
-export declare function TooltipBubble({ chrome, notchPosition, style, onLayout, children, maxHeight, showNotch: showNotchProp, }: TooltipBubbleProps): React.ReactElement;
+export declare function TooltipBubble({ chrome, notchPosition, style, onLayout, children, maxHeight, showNotch: showNotchProp, accessibilityViewIsModal, }: TooltipBubbleProps): React.ReactElement;
 //# sourceMappingURL=TooltipBubble.d.ts.map

package/lib/typescript/module/src/surfaces/tooltip/TooltipBubble.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TooltipBubble.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/TooltipBubble.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,aAAa,EACb,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EAAE,aAAoB,GAChC,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAgIzC"}
+{"version":3,"file":"TooltipBubble.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/TooltipBubble.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,aAAa,EACb,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EAAE,aAAoB,EAC/B,wBAAgC,GACjC,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAgIzC"}

package/lib/typescript/module/src/surfaces/tooltip/targetSearchSchedule.d.ts

@@ -0,0 +1,60 @@
+/**
+ * When TooltipSurface looks for its target.
+ *
+ * - Anchored: a steady poll, so a covered or remounted host is noticed quickly.
+ *   Each search is a cache hit for the resolved host.
+ * - Missing: exponential backoff. A miss walks the tree and scores registered
+ *   hosts, so a target on another screen must not cost a full search every
+ *   second for as long as the flow stays open.
+ * - Registry churn (list rows mounting while the user scrolls) pulls the next
+ *   missing search forward, never closer than {@link MISSING_TRIGGER_GAP_MS}
+ *   to the previous one.
+ * - A screen change or a return to the foreground starts the backoff over.
+ * - Nothing runs while paused (app not active).
+ */
+/** Poll while the target is anchored. */
+export declare const ANCHORED_POLL_MS = 250;
+/** First retry after a miss; doubles per consecutive miss. */
+export declare const MISSING_BACKOFF_BASE_MS = 250;
+/** Ceiling for the missing-target backoff. */
+export declare const MISSING_BACKOFF_MAX_MS = 4000;
+/** Closest a registry change can pull a missing search to the previous one. */
+export declare const MISSING_TRIGGER_GAP_MS = 500;
+export type TargetSearchMode = 'anchored' | 'missing';
+export interface TargetSearchClock {
+    now(): number;
+    setTimeout(handler: () => void, ms: number): ReturnType<typeof setTimeout>;
+    clearTimeout(handle: ReturnType<typeof setTimeout>): void;
+}
+/** Delay before the next search after `misses` consecutive missing searches. */
+export declare function missingBackoffDelay(misses: number): number;
+export declare class TargetSearchSchedule {
+    private readonly search;
+    private readonly clock;
+    private mode;
+    /** Searches run since the target was last anchored (or the backoff restarted). */
+    private misses;
+    private lastRunAt;
+    private handle;
+    private dueAt;
+    private paused;
+    private disposed;
+    constructor(search: () => void, clock?: TargetSearchClock);
+    /** Search now and schedule the next one. No-op while paused. */
+    runNow(): void;
+    /** The target was found or lost. Starts the matching cadence from now. */
+    setMode(mode: TargetSearchMode): void;
+    /** Something the target may depend on changed (a registry mount / unmount). */
+    trigger(): void;
+    /** Restart the backoff and search now (screen change, foreground). */
+    rearm(): void;
+    /** Stop searching until {@link resume}. */
+    pause(): void;
+    /** Leave the paused state and search right away. */
+    resume(): void;
+    dispose(): void;
+    private nextDelay;
+    private scheduleIn;
+    private cancel;
+}
+//# sourceMappingURL=targetSearchSchedule.d.ts.map

package/lib/typescript/module/src/surfaces/tooltip/targetSearchSchedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targetSearchSchedule.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/targetSearchSchedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,MAAM,CAAC;IACd,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC3E,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;CAC3D;AAQD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,qBAAa,oBAAoB;IAW7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAXxB,OAAO,CAAC,IAAI,CAA+B;IAC3C,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;gBAGN,MAAM,EAAE,MAAM,IAAI,EAClB,KAAK,GAAE,iBAAgC;IAG1D,gEAAgE;IAChE,MAAM,IAAI,IAAI;IAcd,0EAA0E;IAC1E,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAQrC,+EAA+E;IAC/E,OAAO,IAAI,IAAI;IAQf,sEAAsE;IACtE,KAAK,IAAI,IAAI;IAMb,2CAA2C;IAC3C,KAAK,IAAI,IAAI;IAMb,oDAAoD;IACpD,MAAM,IAAI,IAAI;IAMd,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,MAAM;CAOf"}

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.4.5";
+export declare const SDK_VERSION = "0.6.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@userflow-tech/react-native",
-  "version": "0.4.5",
+  "version": "0.6.0",
   "description": "Userflow SDK for React Native — onboarding flows, tooltips, and modals.",
   "license": "SEE LICENSE IN LICENSE",
   "main": "./lib/commonjs/index.js",