@userflow-tech/react-native 0.1.1 → 0.2.0

package/lib/typescript/module/src/authoring/chrome/ChromeIcon.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import { type ImageStyle, type StyleProp } from 'react-native';
+export type ChromeIconName = 'arrow-left-from-bracket' | 'arrow-rotate-left' | 'xmark';
+export interface ChromeIconProps {
+    name: ChromeIconName;
+    tintColor: string;
+    size?: number;
+    style?: StyleProp<ImageStyle>;
+    testID?: string;
+}
+/** Monochrome PNG glyph tinted via `tintColor` (white source assets). */
+export declare function ChromeIcon({ name, tintColor, size, style, testID, }: ChromeIconProps): React.ReactElement;
+//# sourceMappingURL=ChromeIcon.d.ts.map

package/lib/typescript/module/src/authoring/chrome/ChromeIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeIcon.d.ts","sourceRoot":"","sources":["../../../../../../src/authoring/chrome/ChromeIcon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAS,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAMtE,MAAM,MAAM,cAAc,GAAG,yBAAyB,GAAG,mBAAmB,GAAG,OAAO,CAAC;AAQvF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,SAAS,EACT,IAAS,EACT,KAAK,EACL,MAAM,GACP,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAStC"}

package/lib/typescript/module/src/authoring/chrome/ChromeTooltip.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+export declare const CHROME_TOOLTIP_NOTCH_SIZE = 8;
+export declare const CHROME_TOOLTIP_DEFAULT_DURATION_MS = 5000;
+export interface ChromeTooltipProps {
+    children: string;
+    visible?: boolean;
+    /** Auto-dismiss delay. `0` keeps the bubble until the parent hides it. */
+    durationMs?: number;
+    onDismiss?: () => void;
+    testID?: string;
+}
+/**
+ * Onboarding bubble with an upward notch. Pointer-events none so it does not
+ * steal the double-tap that shows/hides authoring chrome.
+ */
+export declare function ChromeTooltip({ children, visible, durationMs, onDismiss, testID, }: ChromeTooltipProps): React.ReactElement | null;
+//# sourceMappingURL=ChromeTooltip.d.ts.map

package/lib/typescript/module/src/authoring/chrome/ChromeTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeTooltip.d.ts","sourceRoot":"","sources":["../../../../../../src/authoring/chrome/ChromeTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,OAAc,EACd,UAA+C,EAC/C,SAAS,EACT,MAAkC,GACnC,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAuChD"}

package/lib/typescript/module/src/authoring/chrome/ChromeTopBar.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+export type ChromeTopBarTone = 'default' | 'error';
+export interface ChromeTopBarProps {
+    label: string;
+    tone?: ChromeTopBarTone;
+    left?: React.ReactNode;
+    right?: React.ReactNode;
+    /** Laid-out height of the bar including safe-area padding. */
+    onMeasureHeight?: (height: number) => void;
+    /** Error-tone labels wrap on narrow devices. Default 1. */
+    numberOfLines?: number;
+    /** Hide the bar from VoiceOver/TalkBack while a dialog is open above it. */
+    accessibilityElementsHidden?: boolean | undefined;
+    importantForAccessibility?: 'auto' | 'yes' | 'no' | 'no-hide-descendants' | undefined;
+    testID?: string;
+}
+/**
+ * Full-bleed authoring top bar. Height comes from safe-area + content, not
+ * the 120pt Figma frame (that number already includes the status bar).
+ *
+ * Measured on the Pro Max reference: 4pt below the status bar, 16pt above
+ * the bottom edge of the bar.
+ */
+export declare function ChromeTopBar({ label, tone, left, right, onMeasureHeight, numberOfLines, accessibilityElementsHidden, importantForAccessibility, testID, }: ChromeTopBarProps): React.ReactElement;
+//# sourceMappingURL=ChromeTopBar.d.ts.map

package/lib/typescript/module/src/authoring/chrome/ChromeTopBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeTopBar.d.ts","sourceRoot":"","sources":["../../../../../../src/authoring/chrome/ChromeTopBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClD,yBAAyB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,qBAAqB,GAAG,SAAS,CAAC;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,IAAgB,EAChB,IAAI,EACJ,KAAK,EACL,eAAe,EACf,aAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,MAAkC,GACnC,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CA0CxC"}

package/lib/typescript/module/src/authoring/chrome/DoubleTapBridge.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export interface DoubleTapBridgeProps {
+    children: React.ReactNode;
+}
+/**
+ * Observes screen-wide touches for {@link doubleTapMonitor} without claiming
+ * the responder. Must wrap **both** host app content and authoring chrome —
+ * preview-bar taps never bubble through `TargetPressBridge`, which only
+ * wraps the app tree.
+ */
+export declare function DoubleTapBridge({ children }: DoubleTapBridgeProps): React.ReactElement;
+//# sourceMappingURL=DoubleTapBridge.d.ts.map

package/lib/typescript/module/src/authoring/chrome/DoubleTapBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DoubleTapBridge.d.ts","sourceRoot":"","sources":["../../../../../../src/authoring/chrome/DoubleTapBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CAoCtF"}

package/lib/typescript/module/src/authoring/chrome/doubleTapMonitor.d.ts

@@ -0,0 +1,26 @@
+import { type TouchIdentifier } from '../../anchors/targetPressMonitor';
+export interface DoubleTapSubscription {
+    onDoubleTap: () => void;
+}
+/**
+ * Screen-wide double-tap observer. Never claims the responder — the host app
+ * keeps scrolling and tapping. Used by preview-mode chrome, which has no
+ * capture layer of its own.
+ *
+ * Distinct from `targetPressMonitor`: that singleton is bound to a tooltip
+ * target rect and fires `onPress`, not a double-tap toggle.
+ */
+export declare class DoubleTapMonitor {
+    private subscription;
+    private touchStarts;
+    private lastTap;
+    set(subscription: DoubleTapSubscription | null): void;
+    handleTouchStart(identifier: TouchIdentifier, pageX: number, pageY: number): void;
+    handleTouchEnd(identifier: TouchIdentifier, pageX: number, pageY: number): void;
+    cancelTouch(identifier?: TouchIdentifier): void;
+    /** Test helper. */
+    resetForTests(): void;
+}
+/** Shared singleton used by PreviewModeBanner and DoubleTapBridge. */
+export declare const doubleTapMonitor: DoubleTapMonitor;
+//# sourceMappingURL=doubleTapMonitor.d.ts.map

package/lib/typescript/module/src/authoring/chrome/doubleTapMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubleTapMonitor.d.ts","sourceRoot":"","sources":["../../../../../../src/authoring/chrome/doubleTapMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,kCAAkC,CAAC;AAG1C,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,OAAO,CAA0B;IAEzC,GAAG,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI;IAQrD,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQjF,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAsB/E,WAAW,CAAC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI;IAQ/C,mBAAmB;IACnB,aAAa,IAAI,IAAI;CAKtB;AAED,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/lib/typescript/module/src/authoring/chrome/tokens.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Authoring-chrome tokens from the Userflow React Native Figma file
+ * (`BojC6qdlFUytdD1bRsNLV8`). These are independent of end-user flow
+ * `ThemeFragment` — pairing / picker UI is not themed by the server.
+ *
+ * Typography omits `fontFamily` so RN uses SF Pro / Roboto.
+ */
+export declare const chromeColors: {
+    readonly primaryText: "#132b39";
+    readonly invertedText: "#ffffff";
+    readonly blue500: "#1a57e6";
+    readonly overlay: "rgba(0, 0, 0, 0.2)";
+    /** Figma Colors/Effect/Focus Ring (`#2f69ee59`). */
+    readonly focusRing: "rgba(47, 105, 238, 0.35)";
+    readonly bgMiddle: "#f4f8fb";
+    readonly danger: "#57000e";
+    readonly white: "#ffffff";
+    /** Figma Shadow/Button. Opacity is applied in `chromeShadows`. */
+    readonly shadowButton: "rgb(54, 107, 214)";
+};
+/**
+ * `chromeColors.overlay` split for TooltipCutout's composite-once contract
+ * (`backdropColor` + `backdropOpacity` rather than a single rgba string).
+ */
+export declare const chromeOverlay: {
+    readonly color: "#000000";
+    readonly opacity: 0.2;
+};
+export declare const chromeSpace: {
+    readonly 0: 0;
+    readonly 8: 8;
+    readonly 12: 12;
+    readonly 16: 16;
+    readonly 20: 20;
+    readonly 24: 24;
+};
+export declare const chromeRadius: {
+    readonly md: 4;
+    readonly lg: 8;
+    readonly fullyRounded: 9999;
+};
+export declare const chromeText: {
+    readonly barTitle: {
+        readonly fontSize: 16;
+        readonly fontWeight: "600";
+        readonly lineHeight: 20;
+    };
+    readonly buttonLabel: {
+        readonly fontSize: 16;
+        readonly fontWeight: "600";
+        readonly lineHeight: 20;
+    };
+    /** Figma Labels/SM Bold — bottom-sheet helper copy (3869:521). */
+    readonly labelSmBold: {
+        readonly fontSize: 14;
+        readonly fontWeight: "600";
+        readonly lineHeight: 16;
+    };
+    readonly dialogTitle: {
+        readonly fontSize: 18;
+        readonly fontWeight: "500";
+        readonly lineHeight: 24;
+    };
+    readonly dialogBody: {
+        readonly fontSize: 16;
+        readonly fontWeight: "400";
+        readonly lineHeight: 24;
+    };
+    readonly tooltip: {
+        readonly fontSize: 14;
+        readonly fontWeight: "500";
+        readonly lineHeight: 16;
+    };
+};
+/**
+ * Figma drop shadows approximated as RN `shadow*` + Android `elevation`.
+ * There is no shared chrome shadow helper — TooltipBubble's elevation pairing
+ * is tooltip-specific and is not reused here.
+ */
+export declare const chromeShadows: {
+    /** Shadow/Button — primary pill. */
+    readonly button: {
+        readonly shadowColor: "rgb(54, 107, 214)";
+        readonly shadowOffset: {
+            readonly width: 0;
+            readonly height: 4;
+        };
+        readonly shadowOpacity: 0.5;
+        readonly shadowRadius: 8;
+        readonly elevation: 4;
+    };
+    /** Shadow/Button (Subtle) — secondary / icon pills. */
+    readonly buttonSubtle: {
+        readonly shadowColor: "rgb(54, 107, 214)";
+        readonly shadowOffset: {
+            readonly width: 0;
+            readonly height: 2;
+        };
+        readonly shadowOpacity: 0.5;
+        readonly shadowRadius: 4;
+        readonly elevation: 2;
+    };
+    /** Shadow/Card — full-bleed top/bottom bars. */
+    readonly card: {
+        readonly shadowColor: "#132b39";
+        readonly shadowOffset: {
+            readonly width: 0;
+            readonly height: 4;
+        };
+        readonly shadowOpacity: 0.1;
+        readonly shadowRadius: 12;
+        readonly elevation: 8;
+    };
+    /** Shadow/Default (Subtle) — onboarding tooltip. */
+    readonly tooltip: {
+        readonly shadowColor: "#132b39";
+        readonly shadowOffset: {
+            readonly width: 0;
+            readonly height: 4;
+        };
+        readonly shadowOpacity: 0.1;
+        readonly shadowRadius: 12;
+        readonly elevation: 4;
+    };
+    /**
+     * Dialog card. Carries the values ChromeDialog shipped with (shadowRadius 6 /
+     * elevation 6). Figma names this Shadow/Default (Subtle) — the same token as
+     * `tooltip` — but the radius-convention audit across chrome shadows is Phase 6.
+     */
+    readonly dialog: {
+        readonly shadowColor: "#132b39";
+        readonly shadowOffset: {
+            readonly width: 0;
+            readonly height: 4;
+        };
+        readonly shadowOpacity: 0.1;
+        readonly shadowRadius: 6;
+        readonly elevation: 6;
+    };
+};
+//# sourceMappingURL=tokens.d.ts.map

package/lib/typescript/module/src/authoring/chrome/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../../../src/authoring/chrome/tokens.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY;;;;;IAKvB,oDAAoD;;;;;IAKpD,kEAAkE;;CAE1D,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;CAA8C,CAAC;AAEzE,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;;;;IAGrB,kEAAkE;;;;;;;;;;;;;;;;;;;;;CAKtB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB,oCAAoC;;;;;;;;;;;IAQpC,uDAAuD;;;;;;;;;;;IAQvD,gDAAgD;;;;;;;;;;;IAQhD,oDAAoD;;;;;;;;;;;IAQpD;;;;OAIG;;;;;;;;;;;CAQyC,CAAC"}

package/lib/typescript/module/src/authoring/doubleTap.d.ts

@@ -0,0 +1,14 @@
+export declare const DOUBLE_TAP_WINDOW_MS = 300;
+export declare const DOUBLE_TAP_SLOP = 40;
+export interface TapSample {
+    pageX: number;
+    pageY: number;
+    timestamp: number;
+}
+/**
+ * True when `next` lands close enough in space and time to `prev` to count as
+ * the second half of a double tap. Inclusive on both the time window and slop
+ * so a tap at exactly the boundary still toggles chrome rather than selecting.
+ */
+export declare function isDoubleTap(prev: TapSample | null, next: TapSample, windowMs?: number, slop?: number): boolean;
+//# sourceMappingURL=doubleTap.d.ts.map

package/lib/typescript/module/src/authoring/doubleTap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubleTap.d.ts","sourceRoot":"","sources":["../../../../../src/authoring/doubleTap.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,GAAG,IAAI,EACtB,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,MAA6B,EACvC,IAAI,GAAE,MAAwB,GAC7B,OAAO,CAOT"}

package/lib/typescript/module/src/authoring/elementPickerController.d.ts

@@ -0,0 +1,59 @@
+import type { AutoAnchorInstance } from '../anchors/AutoAnchorRegistry';
+import type { HitRect } from './hitTest';
+export interface ElementPickerScreenshot {
+    dataUrl: string;
+    width: number;
+    height: number;
+    targetX1: number;
+    targetY1: number;
+    targetX2: number;
+    targetY2: number;
+}
+export interface ElementPickerResult {
+    instance: AutoAnchorInstance;
+    autoData: string;
+    text?: string | null;
+    rect: HitRect;
+    screenshot?: ElementPickerScreenshot;
+}
+export interface ElementPickerRequest {
+    /** Caller-supplied id (pairing `idempotency_key`). Minted when omitted. */
+    requestId?: string;
+    elementType?: string | null;
+    onResult: (result: ElementPickerResult) => void | Promise<void>;
+    onCancel?: () => void;
+}
+export interface ElementPickerState {
+    active: boolean;
+    requestId?: string;
+    elementType?: string | null;
+}
+export type ElementPickerListener = (state: ElementPickerState) => void;
+/**
+ * Module singleton for the in-app element picker. Pairing glue (and the QA
+ * harness) call {@link beginSelection}; {@link ElementPickerOverlay} reads
+ * state and commits/cancels.
+ */
+export declare class ElementPickerController {
+    private request;
+    private nextId;
+    private readonly listeners;
+    getState(): ElementPickerState;
+    subscribe(listener: ElementPickerListener): () => void;
+    beginSelection(request: ElementPickerRequest): void;
+    /**
+     * Deliver `result` to the active request. When `expectedId` is passed, a
+     * mismatch (stale Confirm after a newer `beginSelection`) is a no-op.
+     * Omitting `expectedId` is for synchronous tests/QA.
+     *
+     * If `onResult` returns a rejected promise (e.g. relay not connected), the
+     * request stays active so the overlay can retry. Ack timeouts should be
+     * swallowed by the caller of `onResult`, not thrown here.
+     */
+    commit(result: ElementPickerResult, expectedId?: string): Promise<boolean>;
+    cancel(): void;
+    resetForTests(): void;
+    private emit;
+}
+export declare const elementPickerController: ElementPickerController;
+//# sourceMappingURL=elementPickerController.d.ts.map

package/lib/typescript/module/src/authoring/elementPickerController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementPickerController.d.ts","sourceRoot":"","sources":["../../../../../src/authoring/elementPickerController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAQxE;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,QAAQ,IAAI,kBAAkB;IAS9B,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAQtD,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IASnD;;;;;;;;OAQG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAehF,MAAM,IAAI,IAAI;IAYd,aAAa,IAAI,IAAI;IAMrB,OAAO,CAAC,IAAI;CAUb;AAED,eAAO,MAAM,uBAAuB,yBAAgC,CAAC"}

package/lib/typescript/module/src/authoring/fingerprintFromInstance.d.ts

@@ -0,0 +1,26 @@
+import { type MobileAutoData, type MobileFingerprint } from '@userflow-tech/protocol';
+import { type AutoAnchorInstance } from '../anchors/AutoAnchorRegistry';
+import type { MatchMissReason } from '../anchors/semanticMatcher';
+/**
+ * Inverse of `scoreInstance` field-reads: snapshot a live registry instance
+ * into the fingerprint the scored matcher consumes at play time.
+ */
+export declare function fingerprintFromInstance(inst: AutoAnchorInstance): MobileFingerprint;
+/** Wrap a live instance in the `FlowSelector.autoData` envelope. */
+export declare function autoDataFromInstance(inst: AutoAnchorInstance): MobileAutoData;
+export declare function encodeInstanceAutoData(inst: AutoAnchorInstance): string;
+export type PickerFingerprintFailure = {
+    ok: false;
+    reason: MatchMissReason | 'wrong-instance';
+};
+export type PickerFingerprintSuccess = {
+    ok: true;
+    autoData: string;
+};
+export type PickerFingerprintValidation = PickerFingerprintSuccess | PickerFingerprintFailure;
+/**
+ * Encode `inst` and run the play-time matcher. Confirm may proceed only on a
+ * unique hit of this same instance.
+ */
+export declare function validatePickerFingerprint(inst: AutoAnchorInstance): PickerFingerprintValidation;
+//# sourceMappingURL=fingerprintFromInstance.d.ts.map

package/lib/typescript/module/src/authoring/fingerprintFromInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprintFromInstance.d.ts","sourceRoot":"","sources":["../../../../../src/authoring/fingerprintFromInstance.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAE5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAsClE;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CA+BnF;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CA8B7E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAEvE;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;AAE9F;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,GAAG,2BAA2B,CAU/F"}

package/lib/typescript/module/src/authoring/hitTest.d.ts

@@ -0,0 +1,31 @@
+import { type AutoAnchorInstance } from '../anchors/AutoAnchorRegistry';
+export interface HitRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface HitCandidate {
+    instance: AutoAnchorInstance;
+    rect: HitRect;
+    area: number;
+}
+export type MeasureInstance = (inst: AutoAnchorInstance) => Promise<HitRect | null>;
+export type InstanceFilter = (inst: AutoAnchorInstance) => boolean;
+/**
+ * Measure a live auto-anchor instance in window coordinates. Prefers the
+ * public instance's `measureInWindow`, then the fiber host path.
+ */
+export declare function measureInstanceRect(inst: AutoAnchorInstance): Promise<HitRect | null>;
+/**
+ * Hit-test window coordinates against visible auto-anchor instances.
+ * Returns containing candidates sorted by area ascending (smallest / deepest first).
+ */
+export declare function hitTestAt(x: number, y: number, opts?: {
+    instanceFilter?: InstanceFilter;
+    measure?: MeasureInstance;
+    instances?: AutoAnchorInstance[];
+}): Promise<HitCandidate[]>;
+/** Cycle to the next-larger containing candidate (wraps). */
+export declare function nextContainingIndex(candidates: HitCandidate[], currentIndex: number): number;
+//# sourceMappingURL=hitTest.d.ts.map

package/lib/typescript/module/src/authoring/hitTest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitTest.d.ts","sourceRoot":"","sources":["../../../../../src/authoring/hitTest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAM5F,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AACpF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC;AA0DnE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAcrF;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE;IACL,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAClC,GACA,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBzB;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG5F"}

package/lib/typescript/module/src/content/RichContentRenderer.d.ts

@@ -1,5 +1,6 @@
 import type { FlowActionFragment, FlowButtonFragment, ThemeFragment } from '@userflow-tech/protocol';
 import * as React from 'react';
+import type { TextStyle } from 'react-native';
 import type { JustifyContent, LookupAttribute, RichContentDoc } from './types';
 export interface RichContentRendererProps {
     content: string | RichContentDoc | null | undefined;
@@ -16,6 +17,10 @@ export interface RichContentRendererProps {
      * Web: modal → center, tooltip/bubble → end.
      */
     defaultButtonsAlign?: JustifyContent;
+    /** Override H1 weight (modal uses `normal`; tooltip keeps the default bold). */
+    heading1FontWeight?: TextStyle['fontWeight'];
+    /** Extra H1 styles (callers that need per-heading layout). */
+    heading1Style?: TextStyle;
 }
-export declare function RichContentRenderer({ content, buttons, theme, sessionData, lookupAttribute, onActions, defaultButtonsAlign, }: RichContentRendererProps): React.ReactElement;
+export declare function RichContentRenderer({ content, buttons, theme, sessionData, lookupAttribute, onActions, defaultButtonsAlign, heading1FontWeight, heading1Style, }: RichContentRendererProps): React.ReactElement;
 //# sourceMappingURL=RichContentRenderer.d.ts.map

package/lib/typescript/module/src/content/RichContentRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichContentRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/content/RichContentRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA4B/B,OAAO,KAAK,EASV,cAAc,EAGd,eAAe,EAKf,cAAc,EAKf,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC1D,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,cAAc,CAAC;CACtC;AAED,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,OAAO,EACP,KAAK,EACL,WAAW,EACX,eAAe,EACf,SAAS,EACT,mBAAmB,GACpB,EAAE,wBAAwB,GAAG,KAAK,CAAC,YAAY,CAoB/C"}
+{"version":3,"file":"RichContentRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/content/RichContentRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,cAAc,CAAC;AA2BzD,OAAO,KAAK,EASV,cAAc,EAGd,eAAe,EAKf,cAAc,EAKf,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC1D,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,cAAc,CAAC;IACrC,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAC7C,8DAA8D;IAC9D,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,OAAO,EACP,KAAK,EACL,WAAW,EACX,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,GACd,EAAE,wBAAwB,GAAG,KAAK,CAAC,YAAY,CAsB/C"}

package/lib/typescript/module/src/content/StepButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StepButton.d.ts","sourceRoot":"","sources":["../../../../../src/content/StepButton.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC1D,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,KAAK,EACL,WAAW,EACX,SAAS,GACV,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAkCtC"}
+{"version":3,"file":"StepButton.d.ts","sourceRoot":"","sources":["../../../../../src/content/StepButton.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC1D,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,KAAK,EACL,WAAW,EACX,SAAS,GACV,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAiCtC"}

package/lib/typescript/module/src/content/resolveStepButtonChrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveStepButtonChrome.d.ts","sourceRoot":"","sources":["../../../../../src/content/resolveStepButtonChrome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;CACrC;AAyBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,OAAO,GACjB,gBAAgB,CA0DlB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAY5E"}
+{"version":3,"file":"resolveStepButtonChrome.d.ts","sourceRoot":"","sources":["../../../../../src/content/resolveStepButtonChrome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;CACrC;AAyBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,OAAO,GACjB,gBAAgB,CAgElB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAY5E"}

package/lib/typescript/module/src/content/themeColor.d.ts

@@ -35,6 +35,11 @@ export declare function parseThemeRgb(color: string | null | undefined): Rgb | n
  * Falls back to neutral gray when the color cannot be parsed.
  */
 export declare function foregroundAlpha(color: string | null | undefined, alpha: number): string;
+/**
+ * Web's default `backdropHighlightColor` is `#ffffff`. An opaque white stroke
+ * on a dimmed backdrop reads as a thick frame, not the mobile focus ring.
+ */
+export declare function isNearWhite(color: string | null | undefined): boolean;
 /**
  * Extra margin below quote/code so that with {@link ROOT_CONTENT_GAP} the
  * visual spacing matches web `margin-bottom: $padding-16`.

package/lib/typescript/module/src/content/themeColor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themeColor.d.ts","sourceRoot":"","sources":["../../../../../src/content/themeColor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAK3C,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAOtD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAmC1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"themeColor.d.ts","sourceRoot":"","sources":["../../../../../src/content/themeColor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAK3C,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAOtD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAmC1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAIrE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAGxD"}

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

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

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

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

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

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

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

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

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

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