@userflow-tech/react-native 0.1.1 → 0.3.0

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"CloseButton.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/CloseButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oIAAoI;AACpI,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,CAapF"}
+{"version":3,"file":"CloseButton.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/CloseButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,GAAwB,EACxB,KAA0B,GAC3B,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,CAavC"}

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

@@ -11,7 +11,7 @@ export interface ModalSurfaceProps {
 }
 /**
  * Modal chrome: full-screen backdrop + centered themed card with TreeDoc body.
- * Also used as a temporary fallback for BUBBLE/HIDDEN until dedicated surfaces.
+ * Also used as a temporary fallback for BUBBLE until a dedicated surface.
  *
  * Touch model: backdrop is a full-screen Pressable; the centering wrapper is
  * `box-none` so taps outside the card hit the backdrop, while the card itself

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

@@ -1 +1 @@
-{"version":3,"file":"ModalSurface.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/ModalSurface.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;AAI/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAkBxD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,OAAO,EACP,WAAW,EACX,KAAK,EACL,eAAe,GAChB,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAqIxC"}
+{"version":3,"file":"ModalSurface.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/ModalSurface.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;AAI/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAkBxD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,OAAO,EACP,WAAW,EACX,KAAK,EACL,eAAe,GAChB,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CA+IxC"}

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

@@ -8,10 +8,21 @@ export interface TooltipSurfaceProps {
     currentStep: FlowStepFragment;
     theme: ThemeFragment;
     lookupAttribute: LookupAttribute;
+    /**
+     * Bumped on preview restart and every goToStep, including a ForceGoToStep
+     * back to the current step, so targeting re-bootstraps when session/step
+     * identity is unchanged.
+     */
+    resetNonce?: number;
 }
+/**
+ * One-frame delay before the first resolve after a step/reset so dialog
+ * teardown cannot arm the missing-target timer with a 0-size measure.
+ */
+export declare const FIRST_RESOLVE_DELAY_MS = 16;
 /**
  * Anchored tooltip chrome: measure manual / fiber anchor, place with web flip/shift,
  * optional cutout backdrop, missing-target report + theme fallbacks.
  */
-export declare function TooltipSurface({ engine, session, currentStep, theme, lookupAttribute, }: TooltipSurfaceProps): React.ReactElement | null;
+export declare function TooltipSurface({ engine, session, currentStep, theme, lookupAttribute, resetNonce, }: TooltipSurfaceProps): React.ReactElement | null;
 //# sourceMappingURL=TooltipSurface.d.ts.map

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;AAsB/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA4BxD,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;CAClC;AAkCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,WAAW,EACX,KAAK,EACL,eAAe,GAChB,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA2lBjD"}
+{"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/cardTransition.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import { Animated } from 'react-native';
+/** Outgoing card leaves fast; the incoming one gets web's `opacity 250ms` feel. */
+export declare const CARD_EXIT_MS = 120;
+export declare const CARD_ENTER_MS = 200;
+export type CardTransitionPhase = 'entering' | 'exiting';
+export declare const CardTransitionProvider: React.Provider<CardTransitionPhase | null>;
+/**
+ * Phase of the surrounding step transition, or `null` outside one.
+ *
+ * Surfaces use this to hold side effects while they fade out: an exiting card is
+ * still mounted for `CARD_EXIT_MS`, and anything it measures or arms in that
+ * window belongs to a step the user has already left.
+ */
+export declare function useCardTransitionPhase(): CardTransitionPhase | null;
+/**
+ * Fade for a surface's card chrome, so step swaps move the card alone and leave
+ * the backdrop and cutout steady (same as web, where `FlowChrome` animates the
+ * bubble alone).
+ *
+ * Each card owns its value and starts the fade from its own mount rather than
+ * sharing one animation across the swap. Cards can appear well after the step
+ * changes — `TooltipSurface` renders nothing until its anchor measures — and a
+ * shared animation would already have finished by then, leaving the card at the
+ * stale JS value of 0 forever, since native-driven animations never write back
+ * to JS.
+ *
+ * Returns `null` outside a flow transition (unit tests), leaving opacity alone.
+ */
+export declare function useCardOpacity(): Animated.Value | null;
+//# sourceMappingURL=cardTransition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cardTransition.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/cardTransition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,mFAAmF;AACnF,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,CAAC;AAIzD,eAAO,MAAM,sBAAsB,4CAAiC,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAEnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAAC,KAAK,GAAG,IAAI,CA4BtD"}

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

@@ -0,0 +1,44 @@
+import type { ThemeFragment } from '@userflow-tech/protocol';
+export type HighlightType = 'OUTSIDE' | 'INSIDE';
+/**
+ * Mobile highlight corner radius when the target's own radius is unknown.
+ * Web copies `getComputedStyle(target).borderRadius`; RN measure cannot.
+ * 8 matches typical controls and the mobile tooltip mockup.
+ */
+export declare const HIGHLIGHT_CORNER_RADIUS = 8;
+/** Crisp focus-ring stroke — the mockup's inner blue line. */
+export declare const HIGHLIGHT_STROKE_WIDTH = 2;
+/** Web theme default (`themes.backdrop_highlight_radius`) — halo thickness. */
+export declare const HIGHLIGHT_RADIUS_DEFAULT = 4;
+/** Web theme default (`themes.backdrop_highlight_spread`) — placement gap only. */
+export declare const HIGHLIGHT_SPREAD_DEFAULT = 0;
+/** Cap the painted halo so it stays a wash, not a second solid stroke. */
+export declare const HIGHLIGHT_HALO_ALPHA_MAX = 0.32;
+export interface HighlightChrome {
+    /** Opaque stroke color (mockup's crisp ring). */
+    color: string;
+    /** Same color at the painted halo alpha. */
+    glowColor: string;
+    opacity: number;
+    /** Halo thickness — web `backdropHighlightRadius`. */
+    radius: number;
+    /** Placement gap only — web `backdropHighlightSpread`. Not stroke width. */
+    spread: number;
+    strokeWidth: number;
+    type: HighlightType;
+    borderRadius: number;
+}
+/**
+ * Web tooltip-backdrop highlight as a mobile focus ring: thin brand stroke +
+ * a single soft halo. Web's default white highlight is treated as unset so it
+ * does not paint a thick white frame on the dimmed cutout.
+ */
+export declare function resolveHighlightChrome(theme: ThemeFragment, backdropPadding?: number): HighlightChrome;
+export declare function isHighlightVisible(chrome: HighlightChrome): boolean;
+/**
+ * Extra pixels an OUTSIDE ring extends past the hole: theme spread plus the
+ * painted stroke and halo. Used so the tooltip notch aims at the outer edge
+ * of the focus ring, not the cutout.
+ */
+export declare function outsideHighlightOutset(chrome: HighlightChrome): number;
+//# sourceMappingURL=resolveHighlightChrome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveHighlightChrome.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/resolveHighlightChrome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AA0CD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,eAAe,GAAE,MAAU,GAC1B,eAAe,CAwBjB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAGtE"}

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

@@ -15,7 +15,7 @@ export declare function resolveModalCenterPadding(insets: {
     bottom: number;
     left: number;
     right: number;
-}): {
+}, previewBannerHeight?: number, previewBottomInset?: number): {
     paddingTop: number;
     paddingBottom: number;
     paddingLeft: number;

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

@@ -1 +1 @@
-{"version":3,"file":"resolveModalLayout.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/resolveModalLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAiB/C;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,GAAG;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAOA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAMnB"}
+{"version":3,"file":"resolveModalLayout.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/resolveModalLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAiB/C;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE;IACN,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,EACD,mBAAmB,SAAI,EACvB,kBAAkB,SAAI,GACrB;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAWA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAMnB"}

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

@@ -1,7 +1,6 @@
 import type { ThemeFragment } from '@userflow-tech/protocol';
 import type { ViewStyle } from 'react-native';
 import type { JustifyContent } from '../content/types';
-import { resolveModalCenterPadding } from './resolveModalLayout';
 /** Screen margin for anchored tooltips (mobile design spec: 24px). */
 export declare const TOOLTIP_VIEWPORT_PADDING = 24;
 /**
@@ -11,12 +10,6 @@ export declare const TOOLTIP_VIEWPORT_PADDING = 24;
 export declare function resolveTooltipCardMaxWidth(theme: ThemeFragment, stepWidth: number | null | undefined, windowWidth: number): number;
 /** Mobile spec: nearly full-width card with screen margins on narrow viewports. */
 export declare function resolveTooltipCardLayout(cardMaxWidth: number, windowWidth: number): Pick<ViewStyle, 'maxWidth' | 'width'>;
-export declare function resolveTooltipCenterPadding(insets: {
-    top: number;
-    bottom: number;
-    left: number;
-    right: number;
-}): ReturnType<typeof resolveModalCenterPadding>;
 /**
  * Web `--userflow-buttons-bubble-justify-content` (bubble + tooltip): default is end.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"resolveTooltipLayout.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/resolveTooltipLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAGL,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,KAAyB,CAAC;AAiB/D;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,CAKvC;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAK/E"}
+{"version":3,"file":"resolveTooltipLayout.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/resolveTooltipLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,KAAyB,CAAC;AAiB/D;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,CAKvC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAK/E"}

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

@@ -1,3 +1,4 @@
+import type { Context } from 'react';
 export interface EdgeInsets {
     top: number;
     right: number;
@@ -6,6 +7,11 @@ export interface EdgeInsets {
 }
 /** Safe-area insets with a zero fallback when the optional peer is missing. */
 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,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"}

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

@@ -0,0 +1,15 @@
+/**
+ * Whether flow surfaces (modals, tooltips) intercept taps on the host app
+ * underneath. Default-on; integrators can restore the legacy pass-through
+ * tooltip backdrop via {@link setSurfaceInteractionBlocking}.
+ */
+/**
+ * When true (default), tooltip cutout bands and crossfade exit block host taps.
+ * Surfaces read this flag at render time — toggling mid-flow applies on the next
+ * re-render of the active surface tree (same as {@link setScrollPadding}).
+ */
+export declare function setSurfaceInteractionBlocking(enabled: boolean | null | undefined): void;
+export declare function getSurfaceInteractionBlocking(): boolean;
+/** Test helper — reset to default (blocking enabled). */
+export declare function resetSurfaceInteractionConfig(): void;
+//# sourceMappingURL=surfaceInteractionConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceInteractionConfig.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/surfaceInteractionConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEvF;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,yDAAyD;AACzD,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

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

@@ -0,0 +1,38 @@
+import * as React from 'react';
+import { type EdgeInsets } from './safeArea';
+export type SurfaceLayoutPadding = {
+    paddingTop: number;
+    paddingBottom: number;
+    paddingLeft: number;
+    paddingRight: number;
+};
+/** Independent writers so preview and picker chrome cannot clobber each other. */
+export type AuthoringChromeInsetSlot = 'preview' | 'picker';
+/**
+ * Holds measured authoring chrome heights so modal/tooltip layout can clear
+ * them. The overlay stays full-screen; only card padding grows.
+ *
+ * Preview and picker report into separate slots on each edge. The picker slot
+ * wins while it is non-zero (the preview bar is suppressed for that stretch).
+ */
+export declare function SurfaceLayoutInsetsProvider({ children, }: {
+    children: React.ReactNode;
+}): React.ReactElement;
+/**
+ * Report an authoring top bar's laid-out height (0 when that bar is hidden).
+ * Defaults to the preview slot; the picker must pass `'picker'`.
+ */
+export declare function useReportPreviewBannerHeight(slot?: AuthoringChromeInsetSlot): (height: number) => void;
+/**
+ * Report an authoring bottom sheet's laid-out height (0 when that sheet is hidden).
+ * Defaults to the preview slot; the picker must pass `'picker'`.
+ */
+export declare function useReportAuthoringBottomHeight(slot?: AuthoringChromeInsetSlot): (height: number) => void;
+/**
+ * Padding that keeps flow cards inside the screen: safe area, 24px margin,
+ * and authoring chrome when it is mounted.
+ */
+export declare function useSurfaceLayoutInsets(): SurfaceLayoutPadding;
+/** @internal */
+export declare function paddingAsEdgeInsets(padding: SurfaceLayoutPadding): EdgeInsets;
+//# sourceMappingURL=surfaceLayoutInsets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceLayoutInsets.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/surfaceLayoutInsets.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,KAAK,UAAU,EAA6B,MAAM,YAAY,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,QAAQ,CAAC;AA2B5D;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,GAAG,KAAK,CAAC,YAAY,CA+BrB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,wBAAoC,GACzC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAQ1B;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,GAAE,wBAAoC,GACzC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAQ1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,CAI7D;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAO7E"}

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

@@ -1,13 +1,15 @@
 import type { ThemeFragment } from '@userflow-tech/protocol';
 import type { ViewStyle } from 'react-native';
 export type BubbleChromeKind = 'modal' | 'tooltip';
+/** Mobile modal/tooltip inset — tighter than web `modalPadding` (default 40). */
+export declare const BUBBLE_CONTENT_PADDING = 24;
 export interface BubbleChrome {
     backgroundColor: string;
     borderRadius: number;
     borderWidth: number;
     borderColor: string;
     notchSize: number;
-    /** Inner content padding (modal: theme `modalPadding` or 32; tooltip/bubble 24). */
+    /** Inner content padding ({@link BUBBLE_CONTENT_PADDING}). */
     contentPadding: number;
     /**
      * Outer shell — shadow + overflow. Tooltips keep overflow visible so the