@smileid/usesmileid 12.0.0-beta01

package/dist/presentation/screen/helpers/capture_screen_helpers.js

@@ -0,0 +1,133 @@
+import { UseSmileIDOverlayState } from "../../state/use_smile_id_overlay_state";
+/**
+ * Pure-logic feedback helpers. Feedback travels as a stable `si_*` key
+ * so the coaching animation and copy resolution key off one value.
+ */
+/**
+ * Feedback key for a selfie overlay state with explicit guidance.
+ * Lifecycle states return `null` (copy resolved by `mapCaptureUiState`).
+ */
+export function selfieFeedbackKeyFor(state) {
+    switch (state) {
+        case UseSmileIDOverlayState.TOO_CLOSE:
+            return "si_capture_too_close";
+        case UseSmileIDOverlayState.TOO_FAR:
+            return "si_capture_too_far";
+        case UseSmileIDOverlayState.FACE_NOT_CENTERED:
+            return "si_capture_center_face";
+        case UseSmileIDOverlayState.MULTIPLE_FACES:
+            return "si_capture_multiple_faces";
+        case UseSmileIDOverlayState.LOW_LIGHT:
+            return "si_capture_low_light";
+        case UseSmileIDOverlayState.BRIGHT_LIGHT:
+            return "si_capture_bright_light";
+        case UseSmileIDOverlayState.WRONG_ORIENTATION:
+            return "si_capture_rotate_device";
+        case UseSmileIDOverlayState.NOT_SMILING:
+            return "si_capture_smile";
+        case UseSmileIDOverlayState.MOVE_LEFT:
+            return "si_capture_move_left";
+        case UseSmileIDOverlayState.MOVE_RIGHT:
+            return "si_capture_move_right";
+        case UseSmileIDOverlayState.MOVE_UP:
+            return "si_capture_move_higher";
+        case UseSmileIDOverlayState.MOVE_DOWN:
+            return "si_capture_move_lower";
+        default:
+            return null;
+    }
+}
+/** Document counterpart of {@link selfieFeedbackKeyFor}. */
+export function documentFeedbackKeyFor(state) {
+    switch (state) {
+        case UseSmileIDOverlayState.DOCUMENT_TOO_CLOSE:
+            return "si_document_too_close";
+        case UseSmileIDOverlayState.DOCUMENT_TOO_FAR:
+            return "si_document_too_far";
+        case UseSmileIDOverlayState.DOCUMENT_NOT_CENTERED:
+            return "si_document_center";
+        case UseSmileIDOverlayState.DOCUMENT_HOLD_STILL:
+            return "si_document_hold_still";
+        default:
+            return null;
+    }
+}
+/**
+ * Feedback-key → localized-copy table; unmapped keys fall back to the
+ * initial instruction so the guidance never blanks.
+ */
+const FEEDBACK_COPY = {
+    si_capture_initial_instruction: (loc) => loc.siCaptureInitialInstruction,
+    si_start_capture_instruction: (loc) => loc.siStartCaptureInstruction,
+    si_capture_too_close: (loc) => loc.siCaptureTooClose,
+    si_capture_too_far: (loc) => loc.siCaptureTooFar,
+    si_capture_center_face: (loc) => loc.siCaptureCenterFace,
+    si_capture_multiple_faces: (loc) => loc.siCaptureMultipleFaces,
+    si_capture_low_light: (loc) => loc.siCaptureLowLight,
+    si_capture_bright_light: (loc) => loc.siCaptureBrightLight,
+    si_capture_rotate_device: (loc) => loc.siCaptureRotateDevice,
+    si_capture_smile: (loc) => loc.siCaptureSmile,
+    si_capture_move_left: (loc) => loc.siCaptureMoveLeft,
+    si_capture_move_right: (loc) => loc.siCaptureMoveRight,
+    si_capture_move_higher: (loc) => loc.siCaptureMoveHigher,
+    si_capture_move_lower: (loc) => loc.siCaptureMoveLower,
+    si_capture_ready: (loc) => loc.siCaptureReady,
+    si_capture_hold_steady: (loc) => loc.siCaptureHoldSteady,
+    si_capture_timeout: (loc) => loc.siCaptureTimeout,
+    si_capturing: (loc) => loc.siCapturing,
+    si_selfie_capture_complete: (loc) => loc.siSelfieCaptureComplete,
+    si_selfie_capture_timeout: (loc) => loc.siSelfieCaptureTimeout,
+    si_selfie_capture_unsatisfied: (loc) => loc.siSelfieCaptureUnsatisfied,
+    si_ess_capture_initial_instruction: (loc) => loc.siEssCaptureInitialInstruction,
+    si_ess_hold_still: (loc) => loc.siEssHoldStill,
+    si_ess_look_left: (loc) => loc.siEssLookLeft,
+    si_ess_look_right: (loc) => loc.siEssLookRight,
+    si_ess_look_up: (loc) => loc.siEssLookUp,
+    si_document_initial_instruction: (loc) => loc.siDocumentInitialInstruction,
+    si_document_ready: (loc) => loc.siDocumentReady,
+    si_document_capturing: (loc) => loc.siDocumentCapturing,
+    si_document_capture_complete: (loc) => loc.siDocumentCaptureComplete,
+    si_document_capture_unsatisfied: (loc) => loc.siDocumentCaptureUnsatisfied,
+    si_document_capture_timeout: (loc) => loc.siDocumentCaptureTimeout,
+    si_document_too_close: (loc) => loc.siDocumentTooClose,
+    si_document_too_far: (loc) => loc.siDocumentTooFar,
+    si_document_center: (loc) => loc.siDocumentCenter,
+    si_document_hold_still: (loc) => loc.siDocumentHoldStill,
+    si_document_gallery_image_too_small: (loc) => loc.siDocumentGalleryImageTooSmall,
+    si_document_gallery_image_failed: (loc) => loc.siDocumentGalleryImageFailed,
+};
+/** Resolve a stable feedback key to the active locale's copy. */
+export function resolveFeedbackCopy(key, loc) {
+    const resolve = FEEDBACK_COPY[key];
+    return resolve ? resolve(loc) : loc.siCaptureInitialInstruction;
+}
+/**
+ * Overlay-state-only copy resolution for callers without a scan state;
+ * `mapCaptureUiState` is the richer path that also handles Enhanced
+ * Smart Selfie copy.
+ */
+export function resolveCaptureFeedback(state, loc) {
+    const feedbackKey = selfieFeedbackKeyFor(state);
+    if (feedbackKey)
+        return resolveFeedbackCopy(feedbackKey, loc);
+    switch (state) {
+        case UseSmileIDOverlayState.HEAD_TURN:
+            return loc.siCaptureHoldSteady;
+        case UseSmileIDOverlayState.FACE_DETECTED:
+        case UseSmileIDOverlayState.READY:
+            return loc.siCaptureReady;
+        case UseSmileIDOverlayState.CAPTURING:
+            return loc.siCapturing;
+        default:
+            return loc.siCaptureInitialInstruction;
+    }
+}
+/**
+ * Whether the start-capture button is enabled. "Start" begins the
+ * analyzer pipeline (not a snapshot), so it's enabled exactly during
+ * the pre-flight `INSTRUCTION` state — before the pipeline has started.
+ */
+export function isStartCaptureEnabled(state) {
+    return state === UseSmileIDOverlayState.INSTRUCTION;
+}
+//# sourceMappingURL=capture_screen_helpers.js.map

package/dist/presentation/screen/helpers/capture_screen_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture_screen_helpers.js","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/capture_screen_helpers.ts"],"names":[],"mappings":"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"}

package/dist/presentation/screen/helpers/capture_ui_state.d.ts

@@ -0,0 +1,54 @@
+import type { ScanHeadTurnDirection, ScanState } from "@smileid/usesmileid_bridge";
+import { CaptureType } from "../../../core/models/ml_config";
+import { UseSmileIDOverlayState } from "../../state/use_smile_id_overlay_state";
+import type { SiKey } from "../../../l10n/strings_en";
+/** Immutable per-frame UI snapshot derived from the native `ScanState`. */
+export type UseSmileIDCaptureUiState = {
+    readonly overlayState: UseSmileIDOverlayState;
+    /** Stable si_* key behind the guidance copy and the coaching-animation lookup. */
+    readonly feedbackKey: SiKey;
+    /** 0..1 oval fill; always 0 under Enhanced Smart Selfie. */
+    readonly captureProgress: number;
+    /** Active ESS head-turn direction, null outside a turn. */
+    readonly animationDirection: ScanHeadTurnDirection | null;
+    /**
+     * `true` while the head pose holds the current ESS direction — drives
+     * the grey→green direction arrow. Always `false` outside a head turn.
+     */
+    readonly poseMatched: boolean;
+};
+/**
+ * The oval never fills under Enhanced Smart Selfie — idempotent,
+ * applied once at the mapping's exit.
+ */
+export declare function withEnhancedLivenessPolicy(state: UseSmileIDCaptureUiState, enableEnhancedLiveness: boolean): UseSmileIDCaptureUiState;
+/**
+ * Terminal snapshot for a completed selfie scan — single source for
+ * the `finished` mapping and any post-scan fallback.
+ */
+export declare function scannedUiState(enableEnhancedLiveness: boolean): UseSmileIDCaptureUiState;
+/** Terminal snapshot for a completed document scan. */
+export declare function scannedDocumentUiState(): UseSmileIDCaptureUiState;
+/**
+ * Snapshot shown before the first analyzed frame. The overlay stays
+ * IDLE — eagerly mapping the initial scan state is the no-green-flash
+ * regression — while the guidance primes with the flow's initial
+ * instruction.
+ */
+export declare function preCaptureUiState(captureType: CaptureType, enableEnhancedLiveness: boolean): UseSmileIDCaptureUiState;
+/**
+ * True when the native analyzer restarted evaluation: leaving
+ * `unsatisfied`, or `timeout`/`finished` returning to `initial`.
+ */
+export declare function isSessionBoundary(previous: ScanState, next: ScanState): boolean;
+/** Dispatch on capture type — see {@link mapSelfieUiState} / {@link mapDocumentUiState}. */
+export declare function mapCaptureUiState(scanState: ScanState, captureType: CaptureType, enableEnhancedLiveness: boolean): UseSmileIDCaptureUiState;
+/**
+ * Selfie scan-state → UI-state mapping. Enhanced Smart Selfie switches
+ * the copy (initial → head-turn primer; active capture → "Hold
+ * still…") and zeroes the fill.
+ */
+export declare function mapSelfieUiState(scanState: ScanState, enableEnhancedLiveness: boolean): UseSmileIDCaptureUiState;
+/** Document scan-state → UI-state mapping. */
+export declare function mapDocumentUiState(scanState: ScanState): UseSmileIDCaptureUiState;
+//# sourceMappingURL=capture_ui_state.d.ts.map

package/dist/presentation/screen/helpers/capture_ui_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture_ui_state.d.ts","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/capture_ui_state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,SAAS,EACV,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAOtD,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC1D;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,CAAC;AA2CF;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,EAC/B,sBAAsB,EAAE,OAAO,GAC9B,wBAAwB,CAI1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,sBAAsB,EAAE,OAAO,GAC9B,wBAAwB,CAK1B;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,IAAI,wBAAwB,CAMjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,sBAAsB,EAAE,OAAO,GAC9B,wBAAwB,CAQ1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,SAAS,GACd,OAAO,CAQT;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,EACxB,sBAAsB,EAAE,OAAO,GAC9B,wBAAwB,CAI1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,sBAAsB,EAAE,OAAO,GAC9B,wBAAwB,CAK1B;AA6ED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,GACnB,wBAAwB,CAmD1B"}

package/dist/presentation/screen/helpers/capture_ui_state.js

@@ -0,0 +1,179 @@
+import { ScanStateType } from "@smileid/usesmileid_bridge";
+import { CaptureType } from "../../../core/models/ml_config";
+import { UseSmileIDOverlayState } from "../../state/use_smile_id_overlay_state";
+import { mapScanStateToOverlayState } from "./scan_state_to_overlay_state";
+import { documentFeedbackKeyFor, selfieFeedbackKeyFor, } from "./capture_screen_helpers";
+function uiState(overlayState, feedbackKey, captureProgress) {
+    return {
+        overlayState,
+        feedbackKey,
+        captureProgress,
+        animationDirection: null,
+        poseMatched: false,
+    };
+}
+/**
+ * Blocking conditions to surface mid-turn — the user cannot hold the pose
+ * while any holds, so each must show and hide the arrow until it clears.
+ * Order is the precedence orientation > light > position; the native side
+ * sends one feedback code per frame, already dwelled (3 consecutive
+ * frames), so no consumer-side debounce. Smile / motion-blur stay out — a
+ * turning head always moves and they don't block the pose.
+ */
+const ESS_HEAD_TURN_COACHING_KEYS = [
+    "si_capture_rotate_device",
+    "si_capture_low_light",
+    "si_capture_bright_light",
+    "si_capture_too_far",
+    "si_capture_too_close",
+    "si_capture_center_face",
+];
+/** The mid-turn coaching key, or `null` when the turn prompt should show. */
+function essHeadTurnCoachingKey(feedback) {
+    if (feedback === undefined)
+        return null;
+    // Match against the typed set so the result narrows to SiKey without a cast.
+    for (const key of ESS_HEAD_TURN_COACHING_KEYS) {
+        if (key === feedback)
+            return key;
+    }
+    return null;
+}
+/**
+ * The oval never fills under Enhanced Smart Selfie — idempotent,
+ * applied once at the mapping's exit.
+ */
+export function withEnhancedLivenessPolicy(state, enableEnhancedLiveness) {
+    return enableEnhancedLiveness && state.captureProgress !== 0
+        ? { ...state, captureProgress: 0 }
+        : state;
+}
+/**
+ * Terminal snapshot for a completed selfie scan — single source for
+ * the `finished` mapping and any post-scan fallback.
+ */
+export function scannedUiState(enableEnhancedLiveness) {
+    return withEnhancedLivenessPolicy(uiState(UseSmileIDOverlayState.PROCESSING, "si_selfie_capture_complete", 1), enableEnhancedLiveness);
+}
+/** Terminal snapshot for a completed document scan. */
+export function scannedDocumentUiState() {
+    return uiState(UseSmileIDOverlayState.PROCESSING, "si_document_capture_complete", 1);
+}
+/**
+ * Snapshot shown before the first analyzed frame. The overlay stays
+ * IDLE — eagerly mapping the initial scan state is the no-green-flash
+ * regression — while the guidance primes with the flow's initial
+ * instruction.
+ */
+export function preCaptureUiState(captureType, enableEnhancedLiveness) {
+    // Selfie flows (including ESS) show the press-Start copy here; the
+    // ESS primer belongs to the scanning Initial state.
+    const feedbackKey = captureType === CaptureType.selfie
+        ? "si_start_capture_instruction"
+        : "si_document_initial_instruction";
+    return uiState(UseSmileIDOverlayState.IDLE, feedbackKey, 0);
+}
+/**
+ * True when the native analyzer restarted evaluation: leaving
+ * `unsatisfied`, or `timeout`/`finished` returning to `initial`.
+ */
+export function isSessionBoundary(previous, next) {
+    if (previous.type === next.type)
+        return false;
+    if (previous.type === ScanStateType.Unsatisfied)
+        return true;
+    return ((previous.type === ScanStateType.Timeout ||
+        previous.type === ScanStateType.Finished) &&
+        next.type === ScanStateType.Initial);
+}
+/** Dispatch on capture type — see {@link mapSelfieUiState} / {@link mapDocumentUiState}. */
+export function mapCaptureUiState(scanState, captureType, enableEnhancedLiveness) {
+    return captureType === CaptureType.selfie
+        ? mapSelfieUiState(scanState, enableEnhancedLiveness)
+        : mapDocumentUiState(scanState);
+}
+/**
+ * Selfie scan-state → UI-state mapping. Enhanced Smart Selfie switches
+ * the copy (initial → head-turn primer; active capture → "Hold
+ * still…") and zeroes the fill.
+ */
+export function mapSelfieUiState(scanState, enableEnhancedLiveness) {
+    return withEnhancedLivenessPolicy(selfieUiState(scanState, enableEnhancedLiveness), enableEnhancedLiveness);
+}
+function selfieUiState(scanState, enableEnhancedLiveness) {
+    switch (scanState.type) {
+        case ScanStateType.Initial:
+            return uiState(UseSmileIDOverlayState.INSTRUCTION, enableEnhancedLiveness
+                ? "si_ess_capture_initial_instruction"
+                : "si_capture_initial_instruction", 0);
+        case ScanStateType.Found: {
+            const overlayState = mapScanStateToOverlayState(scanState, CaptureType.selfie);
+            const feedbackKey = selfieFeedbackKeyFor(overlayState) ??
+                (enableEnhancedLiveness ? "si_ess_hold_still" : "si_capturing");
+            return uiState(overlayState, feedbackKey, scanState.captureProgress ?? 0);
+        }
+        case ScanStateType.Satisfied:
+            // Progress forced to 1 so the ring completes even when the last
+            // interim frame undershot; transient before `finished`.
+            return uiState(UseSmileIDOverlayState.CAPTURING, enableEnhancedLiveness ? "si_ess_hold_still" : "si_capturing", 1);
+        case ScanStateType.Unsatisfied:
+            // Unsatisfied collapses onto one requirements-not-met copy —
+            // the per-check `reason` only feeds telemetry, not guidance.
+            return uiState(UseSmileIDOverlayState.FACE_DETECTED, "si_selfie_capture_unsatisfied", 0);
+        case ScanStateType.Finished:
+            return scannedUiState(enableEnhancedLiveness);
+        case ScanStateType.Timeout:
+            return uiState(UseSmileIDOverlayState.IDLE, "si_capture_timeout", 0);
+        case ScanStateType.HeadTurn: {
+            const direction = scanState.currentDirection ?? null;
+            const turnPrompt = direction === "left"
+                ? "si_ess_look_left"
+                : direction === "right"
+                    ? "si_ess_look_right"
+                    : direction === "up"
+                        ? "si_ess_look_up"
+                        : "si_capture_hold_steady";
+            // A blocking condition owns the copy and hides the arrow — showing
+            // "turn left" over "move closer" would mislead — and pauses pose-match
+            // latching. No coaching key ⇒ the turn prompt + arrow show.
+            const coachingKey = essHeadTurnCoachingKey(scanState.feedback);
+            return {
+                overlayState: UseSmileIDOverlayState.HEAD_TURN,
+                feedbackKey: coachingKey ?? turnPrompt,
+                captureProgress: 0,
+                animationDirection: coachingKey !== null ? null : direction,
+                poseMatched: coachingKey !== null ? false : (scanState.poseMatched ?? false),
+            };
+        }
+    }
+}
+/** Document scan-state → UI-state mapping. */
+export function mapDocumentUiState(scanState) {
+    switch (scanState.type) {
+        case ScanStateType.Initial:
+        // No head-turn phase for documents; a degenerate headTurn maps to
+        // the pre-capture instruction.
+        case ScanStateType.HeadTurn:
+            return uiState(UseSmileIDOverlayState.INSTRUCTION, "si_document_initial_instruction", 0);
+        case ScanStateType.Found: {
+            const overlayState = mapScanStateToOverlayState(scanState, CaptureType.document);
+            const feedbackKey = documentFeedbackKeyFor(overlayState);
+            // No validator warning ⇒ frames are being collected — show the
+            // in-capture copy, not the pre-capture "position your document".
+            return feedbackKey === null
+                ? uiState(UseSmileIDOverlayState.CAPTURING, "si_document_capturing", scanState.captureProgress ?? 0)
+                : uiState(overlayState, feedbackKey, scanState.captureProgress ?? 0);
+        }
+        // Documents collapse satisfied/finished onto the same terminal
+        // snapshot: the still is captured and the screen is moving on.
+        case ScanStateType.Satisfied:
+            return scannedDocumentUiState();
+        case ScanStateType.Unsatisfied:
+            return uiState(UseSmileIDOverlayState.IDLE, "si_document_capture_unsatisfied", 0);
+        case ScanStateType.Finished:
+            return scannedDocumentUiState();
+        case ScanStateType.Timeout:
+            return uiState(UseSmileIDOverlayState.IDLE, "si_document_capture_timeout", 0);
+    }
+}
+//# sourceMappingURL=capture_ui_state.js.map

package/dist/presentation/screen/helpers/capture_ui_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture_ui_state.js","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/capture_ui_state.ts"],"names":[],"mappings":"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"}

package/dist/presentation/screen/helpers/consent_screen_helpers.d.ts

@@ -0,0 +1,39 @@
+import type { UseSmileIDLocalizations } from "../../../l10n/use_smile_id_localizations";
+/**
+ * Pure-logic helpers for `UseSmileIDConsentScreen`. Extracted so prop
+ * resolution + the subtitle's `{allow}/{smile_id}/{partner}` token
+ * substitution can be unit-tested without an RN renderer.
+ */
+export type ConsentRowKey = "contact" | "personal" | "biometric" | "device";
+export type ConsentRowSpec = {
+    readonly key: ConsentRowKey;
+    readonly label: string;
+};
+/**
+ * Build the four canonical "this may include processing" rows from
+ * the localizations object: Contact → Personal → Biometric → Device.
+ */
+export declare function buildConsentRows(loc: Pick<UseSmileIDLocalizations, "siConsentContact" | "siConsentPersonal" | "siConsentBiometric" | "siConsentDevice">): readonly ConsentRowSpec[];
+/**
+ * Compose the consent subtitle by substituting the `{allow}`,
+ * `{smile_id}`, and `{partner}` tokens. The Allow / Smile ID values
+ * come from localization (so translations remain coherent); the
+ * partner name is partner-supplied.
+ *
+ * Substitution is done locally because `siConsentSubtitle` is a
+ * non-parameterised getter.
+ */
+export declare function composeConsentSubtitle(partnerName: string, loc: Pick<UseSmileIDLocalizations, "siConsentSubtitle" | "siConsentSubtitleSmileId" | "siConsentAllow">): string;
+export type SubtitlePart = {
+    readonly text: string;
+    readonly bold: boolean;
+};
+/**
+ * Same as [composeConsentSubtitle] but returns the substring chunks
+ * separately, marking each token replacement with `bold: true`. The
+ * screen renders the array as a flow of plain + bold `<Text>` nodes
+ * so partners see the canonical emphasis on `{allow}`, `{smile_id}`,
+ * and `{partner}` without inline styling logic at the call site.
+ */
+export declare function composeConsentSubtitleParts(partnerName: string, loc: Pick<UseSmileIDLocalizations, "siConsentSubtitle" | "siConsentSubtitleSmileId" | "siConsentAllow">): readonly SubtitlePart[];
+//# sourceMappingURL=consent_screen_helpers.d.ts.map

package/dist/presentation/screen/helpers/consent_screen_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent_screen_helpers.d.ts","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/consent_screen_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAExF;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,IAAI,CACP,uBAAuB,EACrB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,iBAAiB,CACpB,GACA,SAAS,cAAc,EAAE,CAO3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,IAAI,CACP,uBAAuB,EACvB,mBAAmB,GAAG,0BAA0B,GAAG,gBAAgB,CACpE,GACA,MAAM,CAQR;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,IAAI,CACP,uBAAuB,EACvB,mBAAmB,GAAG,0BAA0B,GAAG,gBAAgB,CACpE,GACA,SAAS,YAAY,EAAE,CA6BzB"}

package/dist/presentation/screen/helpers/consent_screen_helpers.js

@@ -0,0 +1,68 @@
+/**
+ * Build the four canonical "this may include processing" rows from
+ * the localizations object: Contact → Personal → Biometric → Device.
+ */
+export function buildConsentRows(loc) {
+    return [
+        { key: "contact", label: loc.siConsentContact },
+        { key: "personal", label: loc.siConsentPersonal },
+        { key: "biometric", label: loc.siConsentBiometric },
+        { key: "device", label: loc.siConsentDevice },
+    ];
+}
+/**
+ * Compose the consent subtitle by substituting the `{allow}`,
+ * `{smile_id}`, and `{partner}` tokens. The Allow / Smile ID values
+ * come from localization (so translations remain coherent); the
+ * partner name is partner-supplied.
+ *
+ * Substitution is done locally because `siConsentSubtitle` is a
+ * non-parameterised getter.
+ */
+export function composeConsentSubtitle(partnerName, loc) {
+    return loc.siConsentSubtitle
+        .split("{allow}")
+        .join(loc.siConsentAllow)
+        .split("{smile_id}")
+        .join(loc.siConsentSubtitleSmileId)
+        .split("{partner}")
+        .join(partnerName);
+}
+/**
+ * Same as [composeConsentSubtitle] but returns the substring chunks
+ * separately, marking each token replacement with `bold: true`. The
+ * screen renders the array as a flow of plain + bold `<Text>` nodes
+ * so partners see the canonical emphasis on `{allow}`, `{smile_id}`,
+ * and `{partner}` without inline styling logic at the call site.
+ */
+export function composeConsentSubtitleParts(partnerName, loc) {
+    const tokens = [
+        { token: "{allow}", value: loc.siConsentAllow },
+        { token: "{smile_id}", value: loc.siConsentSubtitleSmileId },
+        { token: "{partner}", value: partnerName },
+    ];
+    // Walk the template once, splitting at the next-occurring token and
+    // emitting plain / bold parts in order. Tokens that don't appear in
+    // the template (e.g. a future translation that drops one) are
+    // silently skipped — same fallback the upstream
+    // `composeConsentSubtitle` provides.
+    let remaining = loc.siConsentSubtitle;
+    const out = [];
+    while (remaining.length > 0) {
+        const next = tokens
+            .map((t) => ({ ...t, index: remaining.indexOf(t.token) }))
+            .filter((t) => t.index >= 0)
+            .sort((a, b) => a.index - b.index)[0];
+        if (!next) {
+            out.push({ text: remaining, bold: false });
+            break;
+        }
+        if (next.index > 0) {
+            out.push({ text: remaining.slice(0, next.index), bold: false });
+        }
+        out.push({ text: next.value, bold: true });
+        remaining = remaining.slice(next.index + next.token.length);
+    }
+    return out;
+}
+//# sourceMappingURL=consent_screen_helpers.js.map

package/dist/presentation/screen/helpers/consent_screen_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent_screen_helpers.js","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/consent_screen_helpers.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAMC;IAED,OAAO;QACL,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,gBAAgB,EAAE;QAC/C,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,iBAAiB,EAAE;QACjD,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,kBAAkB,EAAE;QACnD,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,eAAe,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,GAGC;IAED,OAAO,GAAG,CAAC,iBAAiB;SACzB,KAAK,CAAC,SAAS,CAAC;SAChB,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;SACxB,KAAK,CAAC,YAAY,CAAC;SACnB,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC;SAClC,KAAK,CAAC,WAAW,CAAC;SAClB,IAAI,CAAC,WAAW,CAAC,CAAC;AACvB,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAmB,EACnB,GAGC;IAED,MAAM,MAAM,GAAoD;QAC9D,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE;QAC/C,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,CAAC,wBAAwB,EAAE;QAC5D,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;KAC3C,CAAC;IACF,oEAAoE;IACpE,oEAAoE;IACpE,8DAA8D;IAC9D,gDAAgD;IAChD,qCAAqC;IACrC,IAAI,SAAS,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACtC,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;aACzD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;aAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3C,MAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/presentation/screen/helpers/ess_turn_haptics.d.ts

@@ -0,0 +1,27 @@
+import type { ScanState } from "@smileid/usesmileid_bridge";
+/** Which haptic a completed Enhanced Smart Selfie head turn warrants. */
+export type EssTurnHaptic = "intermediate" | "final";
+/**
+ * Decide which haptic (if any) an Enhanced Smart Selfie head-turn
+ * transition warrants. Fires once per completed turn:
+ *
+ * - `"intermediate"` — one head-turn direction completes and the next
+ *   begins (the requested direction advances).
+ * - `"final"` — the last turn completes and the flow leaves the head-turn
+ *   phase toward capture (`found` / `satisfied` / `finished`).
+ *
+ * Returns `null` for every other transition — crucially including the
+ * reset paths (`headTurn → initial` / `headTurn → timeout`): a reset is
+ * never a completion. `previous` must be the immediately-preceding raw
+ * scan state so the same completion is reported exactly once.
+ */
+export declare function essTurnHaptic(previous: ScanState, next: ScanState): EssTurnHaptic | null;
+/**
+ * Fire the haptic for a completed head turn — a light impact between
+ * turns, a success notification on the final turn. Best-effort UX
+ * feedback: a device without a taptic engine simply no-ops, and a failure
+ * here must never surface as a capture error, so the promise is
+ * intentionally swallowed.
+ */
+export declare function triggerEssTurnHaptic(kind: EssTurnHaptic): void;
+//# sourceMappingURL=ess_turn_haptics.d.ts.map

package/dist/presentation/screen/helpers/ess_turn_haptics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ess_turn_haptics.d.ts","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/ess_turn_haptics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,SAAS,GACd,aAAa,GAAG,IAAI,CAyBtB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAQ9D"}

package/dist/presentation/screen/helpers/ess_turn_haptics.js

@@ -0,0 +1,53 @@
+import * as Haptics from "expo-haptics";
+import { ScanStateType } from "@smileid/usesmileid_bridge";
+/**
+ * Decide which haptic (if any) an Enhanced Smart Selfie head-turn
+ * transition warrants. Fires once per completed turn:
+ *
+ * - `"intermediate"` — one head-turn direction completes and the next
+ *   begins (the requested direction advances).
+ * - `"final"` — the last turn completes and the flow leaves the head-turn
+ *   phase toward capture (`found` / `satisfied` / `finished`).
+ *
+ * Returns `null` for every other transition — crucially including the
+ * reset paths (`headTurn → initial` / `headTurn → timeout`): a reset is
+ * never a completion. `previous` must be the immediately-preceding raw
+ * scan state so the same completion is reported exactly once.
+ */
+export function essTurnHaptic(previous, next) {
+    // Only a transition out of an active, directed head turn can complete one.
+    if (previous.type !== ScanStateType.HeadTurn)
+        return null;
+    if (previous.currentDirection === undefined)
+        return null;
+    // The requested direction advanced — the previous turn completed.
+    if (next.type === ScanStateType.HeadTurn &&
+        next.currentDirection !== undefined &&
+        next.currentDirection !== previous.currentDirection) {
+        return "intermediate";
+    }
+    // Leaving the head-turn phase toward capture is the final turn's
+    // completion; `initial` / `timeout` are resets, not completions.
+    if (next.type === ScanStateType.Found ||
+        next.type === ScanStateType.Satisfied ||
+        next.type === ScanStateType.Finished) {
+        return "final";
+    }
+    return null;
+}
+/**
+ * Fire the haptic for a completed head turn — a light impact between
+ * turns, a success notification on the final turn. Best-effort UX
+ * feedback: a device without a taptic engine simply no-ops, and a failure
+ * here must never surface as a capture error, so the promise is
+ * intentionally swallowed.
+ */
+export function triggerEssTurnHaptic(kind) {
+    const run = kind === "final"
+        ? Haptics.notificationAsync(Haptics.NotificationFeedbackType.Success)
+        : Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Light);
+    void run.catch(() => {
+        // Haptics are non-essential; ignore taptic-engine / permission failures.
+    });
+}
+//# sourceMappingURL=ess_turn_haptics.js.map

package/dist/presentation/screen/helpers/ess_turn_haptics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ess_turn_haptics.js","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/ess_turn_haptics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK3D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAmB,EACnB,IAAe;IAEf,2EAA2E;IAC3E,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEzD,kEAAkE;IAClE,IACE,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,QAAQ;QACpC,IAAI,CAAC,gBAAgB,KAAK,SAAS;QACnC,IAAI,CAAC,gBAAgB,KAAK,QAAQ,CAAC,gBAAgB,EACnD,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,iEAAiE;IACjE,iEAAiE;IACjE,IACE,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,KAAK;QACjC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,SAAS;QACrC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,QAAQ,EACpC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAmB;IACtD,MAAM,GAAG,GACP,IAAI,KAAK,OAAO;QACd,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC;QACrE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC7D,KAAK,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;QAClB,yEAAyE;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/presentation/screen/helpers/feedback_debouncer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Distinct-value trailing debouncer for the capture guidance feed.
+ * The analyzer re-publishes feedback every analyzed frame (~10 Hz),
+ * faster than the window — a naive trailing debounce that reschedules
+ * on every call would never fire. Re-publishing the pending/emitted
+ * value is a no-op (the in-flight window keeps counting); only an
+ * actual change restarts it. `isImmediate` values bypass the window.
+ */
+export declare class UseSmileIDFeedbackDebouncer<T> {
+    private readonly emit;
+    private readonly delayMs;
+    private readonly isImmediate;
+    private timer;
+    private hasEmitted;
+    private emittedValue;
+    private pendingValue;
+    constructor(options: {
+        readonly emit: (value: T) => void;
+        readonly delayMs: number;
+        readonly isImmediate?: (value: T) => boolean;
+        /** Value the consumer already displays — publishing it again is a no-op. */
+        readonly initialValue?: T;
+    });
+    publish(value: T): void;
+    /**
+     * Forget all state so the next publish goes through even when it
+     * repeats the last emitted value (session reset).
+     */
+    reset(): void;
+    /** Emit `value` synchronously and mark it settled (post-reset re-seed). */
+    seed(value: T): void;
+    /** Cancel any in-flight window without emitting. Call on unmount. */
+    dispose(): void;
+    private settle;
+    private cancelTimer;
+}
+//# sourceMappingURL=feedback_debouncer.d.ts.map

package/dist/presentation/screen/helpers/feedback_debouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback_debouncer.d.ts","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/feedback_debouncer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,2BAA2B,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IAEpD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAgB;gBAExB,OAAO,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;QAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;QAC7C,4EAA4E;QAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;KAC3B;IAUD,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAmBvB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAOb,2EAA2E;IAC3E,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAKpB,qEAAqE;IACrE,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,WAAW;CAMpB"}