@mikashboks/capture-intelligence-core 0.1.24 → 0.2.0

package/dist/cjs/capture-guidance.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Capture guidance — the shared semantic layer tying a guidance reason code
+ * to its traffic-light state, directional action, and presented copy.
+ *
+ * This is the cross-client home of the vocabulary first shipped in the web
+ * SDK's `capture-guidance-signal.ts`. The web SDK's local table must stay
+ * byte-identical to the `'self'` persona here (pinned by a parity test in
+ * `sdks/web-ui-sdk`); React Native clients (agent-kyc-app) consume this
+ * module directly with the `'agent'` persona.
+ *
+ * Persona rule: `'self'` is the end customer holding their own phone
+ * (kyc-mobile). `'agent'` is a trained field operator capturing on behalf of
+ * a customer — same semantics, third-person copy, faster damping.
+ */
+import type { OverlayVariant } from './types.js';
+import type { DocumentPlacementReason } from './document-placement.js';
+export type CaptureGuidanceState = 'looking' | 'adjust' | 'ready';
+/**
+ * Every non-'none' value MUST have a matching directional glyph in each
+ * client (web Overlay arrow CSS / RN GuidanceArrow component). Condition-only
+ * situations (blur/dark/glare) present as state 'adjust' with action 'none'.
+ */
+export type CaptureGuidanceAction = 'none' | 'closer' | 'back' | 'left' | 'right' | 'up' | 'down' | 'center';
+export type CaptureGuidancePersona = 'self' | 'agent';
+export type CaptureGuidanceReasonCode = 'searching' | 'camera_preparing' | 'hold_still' | 'almost_ready' | 'document_found' | 'auto_safe' | 'review_safe' | 'manual_ready' | 'taking_photo' | 'too_small' | 'too_large_or_cutoff' | 'off_center' | 'nudge_left' | 'nudge_right' | 'nudge_up' | 'nudge_down' | 'too_dark' | 'glare' | 'blurry' | 'flatten_document' | 'mrz_band_closer' | 'mrz_band_lines' | 'readable_text_closer' | 'back_text_closer' | 'passport_code_lines_bottom' | 'keep_passport_page_in_frame' | 'keep_document_in_frame' | 'show_page_and_code' | 'burst_abort' | 'selfie_searching' | 'selfie_multiple_faces' | 'selfie_too_dark' | 'selfie_too_bright' | 'selfie_cropped' | 'selfie_too_small' | 'selfie_too_large' | 'selfie_off_center' | 'selfie_blurry' | 'selfie_hold_still' | 'selfie_ready' | 'unclassified';
+export type ResolvedCaptureGuidanceReasonCode = Exclude<CaptureGuidanceReasonCode, 'unclassified'>;
+export declare const MANUAL_CAPTURE_READY_FEEDBACK = "Tap button to take photo";
+export declare const GOOD_HOLD_STILL_FEEDBACK = "Good. Hold still";
+export declare const TAKING_PHOTO_META = "Hold still\u2026";
+export declare const INITIAL_DOCUMENT_FEEDBACK = "Put your document inside the box";
+export declare const AUTO_CAPTURE_BURST_ABORT_FEEDBACK = "No clear photo yet. Hold still.";
+export declare function getDocumentSubjectLabel(overlayVariant: OverlayVariant): string;
+export declare function getTiltAwayFromLightGuidance(overlayVariant: OverlayVariant): string;
+export declare function getMoveToMiddleFeedback(overlayVariant: OverlayVariant): string;
+export interface CaptureGuidanceSignalEntry {
+    reasonCode: ResolvedCaptureGuidanceReasonCode;
+    /** Pre-isReady state; isReady=true always promotes to 'ready'. */
+    state: CaptureGuidanceState;
+    action: CaptureGuidanceAction;
+    text: (overlayVariant: OverlayVariant, persona?: CaptureGuidancePersona) => string;
+}
+export interface PresentedCaptureGuidanceSignal {
+    text: string;
+    state: CaptureGuidanceState;
+    action: CaptureGuidanceAction;
+    reasonCode: CaptureGuidanceReasonCode;
+}
+export declare const CAPTURE_GUIDANCE_SIGNAL_TABLE: Record<ResolvedCaptureGuidanceReasonCode, CaptureGuidanceSignalEntry>;
+export declare function resolveCaptureGuidanceSignal(reasonCode: ResolvedCaptureGuidanceReasonCode, isReady: boolean, overlayVariant?: OverlayVariant, persona?: CaptureGuidancePersona): PresentedCaptureGuidanceSignal;
+/**
+ * Map a document placement failure to its guidance reason code. `ok` maps to
+ * the hold-still family because a passing placement frame is, by definition,
+ * waiting on stability/sharpness rather than a correction.
+ */
+export declare const DOCUMENT_PLACEMENT_GUIDANCE_REASON: Record<DocumentPlacementReason, ResolvedCaptureGuidanceReasonCode>;
+export declare function mapSelfieIssueToGuidanceReason(issueKey: string): ResolvedCaptureGuidanceReasonCode | null;
+/**
+ * Presentation damping for live guidance. Dwell times are wall-clock floors a
+ * presented signal holds before a replacement renders; confirm frames are the
+ * consecutive analysis frames a NEW corrective signal must persist before it
+ * is allowed on screen at all. Frame counts assume each client's own analysis
+ * cadence (web ~15fps video loop; RN ~1.5-2fps snapshot loop), which is why
+ * the agent profile uses smaller frame counts, not just smaller dwells.
+ */
+export interface CaptureGuidanceDampingProfile {
+    /** Normal corrective guidance (dark / blur / glare / placement). */
+    correctiveMinDwellMs: number;
+    correctiveConfirmFrames: number;
+    /** Distance reversals (closer<->back) flip-flop easily; damp harder. */
+    distanceReversalMinDwellMs: number;
+    distanceReversalConfirmFrames: number;
+    /** Once a ready state has been shown, corrections may swap faster. */
+    postReadyMinDwellMs: number;
+    postReadyConfirmFrames: number;
+    /** Urgent signals (glare/dark/blur) keep the screen at least this long. */
+    urgentMinDisplayMs: number;
+    /** Consecutive glare frames required before glare guidance latches. */
+    glareConfirmFrames: number;
+}
+export declare const CAPTURE_GUIDANCE_DAMPING_PROFILES: Record<CaptureGuidancePersona, CaptureGuidanceDampingProfile>;
+export type CaptureSignalKind = 'ready' | 'review' | 'fail';
+/**
+ * Vibration patterns per signal kind. Invariant (test-locked): ready stays
+ * the strongest pattern — it is the one signal that must cut through when the
+ * user's eyes are on the document, not the screen.
+ */
+export declare const CAPTURE_SIGNAL_VIBRATION_PATTERNS: Record<CaptureSignalKind, number | number[]>;
+/** Cooldown for the ready haptic+chime pair; boundary thrash never spams. */
+export declare const READY_SIGNAL_COOLDOWN_MS = 2500;
+/** How long the stored frame is held on screen as capture confirmation. */
+export declare const CAPTURE_CONFIRMATION_HOLD_MS = 750;
+/** Two-note ready chime (web parity: 660→880 Hz, 100ms apart). */
+export declare const READY_CHIME_NOTES: ReadonlyArray<{
+    frequencyHz: number;
+    startOffsetMs: number;
+    durationMs: number;
+}>;
+export declare const READY_CHIME_GAIN = 0.12;
+/**
+ * After the selfie manual-fallback timer expires onto a hard-block reason,
+ * the shutter holds through ONE bounded extension of this length, then
+ * unlocks permanently. Mirrors web selfie-detection semantics.
+ */
+export declare const SELFIE_MANUAL_FALLBACK_HARD_BLOCK_EXTENSION_MS = 8000;
+//# sourceMappingURL=capture-guidance.d.ts.map

package/dist/cjs/capture-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-guidance.d.ts","sourceRoot":"","sources":["../../src/capture-guidance.ts"],"names":[],"mappings":"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"}

package/dist/cjs/capture-guidance.js

@@ -0,0 +1,386 @@
+"use strict";
+/**
+ * Capture guidance — the shared semantic layer tying a guidance reason code
+ * to its traffic-light state, directional action, and presented copy.
+ *
+ * This is the cross-client home of the vocabulary first shipped in the web
+ * SDK's `capture-guidance-signal.ts`. The web SDK's local table must stay
+ * byte-identical to the `'self'` persona here (pinned by a parity test in
+ * `sdks/web-ui-sdk`); React Native clients (agent-kyc-app) consume this
+ * module directly with the `'agent'` persona.
+ *
+ * Persona rule: `'self'` is the end customer holding their own phone
+ * (kyc-mobile). `'agent'` is a trained field operator capturing on behalf of
+ * a customer — same semantics, third-person copy, faster damping.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SELFIE_MANUAL_FALLBACK_HARD_BLOCK_EXTENSION_MS = exports.READY_CHIME_GAIN = exports.READY_CHIME_NOTES = exports.CAPTURE_CONFIRMATION_HOLD_MS = exports.READY_SIGNAL_COOLDOWN_MS = exports.CAPTURE_SIGNAL_VIBRATION_PATTERNS = exports.CAPTURE_GUIDANCE_DAMPING_PROFILES = exports.DOCUMENT_PLACEMENT_GUIDANCE_REASON = exports.CAPTURE_GUIDANCE_SIGNAL_TABLE = exports.AUTO_CAPTURE_BURST_ABORT_FEEDBACK = exports.INITIAL_DOCUMENT_FEEDBACK = exports.TAKING_PHOTO_META = exports.GOOD_HOLD_STILL_FEEDBACK = exports.MANUAL_CAPTURE_READY_FEEDBACK = void 0;
+exports.getDocumentSubjectLabel = getDocumentSubjectLabel;
+exports.getTiltAwayFromLightGuidance = getTiltAwayFromLightGuidance;
+exports.getMoveToMiddleFeedback = getMoveToMiddleFeedback;
+exports.resolveCaptureGuidanceSignal = resolveCaptureGuidanceSignal;
+exports.mapSelfieIssueToGuidanceReason = mapSelfieIssueToGuidanceReason;
+/* -- Canonical copy constants (self persona = web kyc-mobile verbatim) ----- */
+exports.MANUAL_CAPTURE_READY_FEEDBACK = 'Tap button to take photo';
+exports.GOOD_HOLD_STILL_FEEDBACK = 'Good. Hold still';
+// Shown while an armed capture decision is pending and during the burst.
+// Deliberately NOT "Taking photo now": the armed capture can still abort, and
+// announcing a photo that may never exist proved trust-destroying in
+// production replays. The stored photo is confirmed by the freeze-flash at
+// actual capture time instead.
+exports.TAKING_PHOTO_META = 'Hold still…';
+exports.INITIAL_DOCUMENT_FEEDBACK = 'Put your document inside the box';
+exports.AUTO_CAPTURE_BURST_ABORT_FEEDBACK = 'No clear photo yet. Hold still.';
+function getDocumentSubjectLabel(overlayVariant) {
+    if (overlayVariant === 'passport')
+        return 'passport photo page';
+    return 'document';
+}
+function getTiltAwayFromLightGuidance(overlayVariant) {
+    return `Tilt ${getDocumentSubjectLabel(overlayVariant)} away from light`;
+}
+function getMoveToMiddleFeedback(overlayVariant) {
+    if (overlayVariant === 'passport')
+        return 'Move passport photo page to the middle';
+    return 'Move document to the middle';
+}
+const selfOnly = (text) => (_overlayVariant, _persona = 'self') => text;
+const byPersona = (self, agent) => (_overlayVariant, persona = 'self') => persona === 'agent' ? agent : self;
+exports.CAPTURE_GUIDANCE_SIGNAL_TABLE = {
+    searching: {
+        reasonCode: 'searching',
+        state: 'looking',
+        action: 'none',
+        text: byPersona(exports.INITIAL_DOCUMENT_FEEDBACK, 'Put the document inside the box'),
+    },
+    camera_preparing: {
+        reasonCode: 'camera_preparing',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Preparing camera...'),
+    },
+    hold_still: {
+        reasonCode: 'hold_still',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly(exports.GOOD_HOLD_STILL_FEEDBACK),
+    },
+    almost_ready: {
+        reasonCode: 'almost_ready',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly(exports.GOOD_HOLD_STILL_FEEDBACK),
+    },
+    document_found: {
+        reasonCode: 'document_found',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly(exports.GOOD_HOLD_STILL_FEEDBACK),
+    },
+    auto_safe: {
+        reasonCode: 'auto_safe',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly(exports.GOOD_HOLD_STILL_FEEDBACK),
+    },
+    review_safe: {
+        reasonCode: 'review_safe',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly(exports.GOOD_HOLD_STILL_FEEDBACK),
+    },
+    manual_ready: {
+        reasonCode: 'manual_ready',
+        state: 'ready',
+        action: 'none',
+        text: selfOnly(exports.MANUAL_CAPTURE_READY_FEEDBACK),
+    },
+    taking_photo: {
+        reasonCode: 'taking_photo',
+        state: 'ready',
+        action: 'none',
+        text: selfOnly(exports.TAKING_PHOTO_META),
+    },
+    too_small: {
+        reasonCode: 'too_small',
+        state: 'adjust',
+        action: 'closer',
+        text: selfOnly('Bring phone closer'),
+    },
+    too_large_or_cutoff: {
+        reasonCode: 'too_large_or_cutoff',
+        state: 'adjust',
+        action: 'back',
+        text: selfOnly('Move phone back. Show all 4 corners'),
+    },
+    off_center: {
+        reasonCode: 'off_center',
+        state: 'adjust',
+        action: 'center',
+        text: (overlayVariant) => getMoveToMiddleFeedback(overlayVariant),
+    },
+    nudge_left: {
+        reasonCode: 'nudge_left',
+        state: 'adjust',
+        action: 'left',
+        text: selfOnly('Move left'),
+    },
+    nudge_right: {
+        reasonCode: 'nudge_right',
+        state: 'adjust',
+        action: 'right',
+        text: selfOnly('Move right'),
+    },
+    nudge_up: {
+        reasonCode: 'nudge_up',
+        state: 'adjust',
+        action: 'up',
+        text: selfOnly('Move up'),
+    },
+    nudge_down: {
+        reasonCode: 'nudge_down',
+        state: 'adjust',
+        action: 'down',
+        text: selfOnly('Move down'),
+    },
+    too_dark: {
+        reasonCode: 'too_dark',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Find better light'),
+    },
+    glare: {
+        reasonCode: 'glare',
+        state: 'adjust',
+        action: 'none',
+        text: (overlayVariant) => getTiltAwayFromLightGuidance(overlayVariant),
+    },
+    blurry: {
+        reasonCode: 'blurry',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Hold still. Photo is blurry'),
+    },
+    flatten_document: {
+        reasonCode: 'flatten_document',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Tilt to flatten the document'),
+    },
+    mrz_band_closer: {
+        reasonCode: 'mrz_band_closer',
+        state: 'adjust',
+        action: 'closer',
+        text: selfOnly('Bring phone closer so the passport code is clear'),
+    },
+    mrz_band_lines: {
+        reasonCode: 'mrz_band_lines',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Show the two passport code lines'),
+    },
+    readable_text_closer: {
+        reasonCode: 'readable_text_closer',
+        state: 'adjust',
+        action: 'closer',
+        text: selfOnly('Bring phone closer so the text is clear'),
+    },
+    back_text_closer: {
+        reasonCode: 'back_text_closer',
+        state: 'adjust',
+        action: 'closer',
+        text: selfOnly('Bring phone closer so the code is clear'),
+    },
+    passport_code_lines_bottom: {
+        reasonCode: 'passport_code_lines_bottom',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Show the two code lines at the bottom'),
+    },
+    keep_passport_page_in_frame: {
+        reasonCode: 'keep_passport_page_in_frame',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Keep the passport photo page in frame'),
+    },
+    keep_document_in_frame: {
+        reasonCode: 'keep_document_in_frame',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Keep the document in frame'),
+    },
+    show_page_and_code: {
+        reasonCode: 'show_page_and_code',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Show the passport photo page and code'),
+    },
+    burst_abort: {
+        reasonCode: 'burst_abort',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly(exports.AUTO_CAPTURE_BURST_ABORT_FEEDBACK),
+    },
+    selfie_searching: {
+        reasonCode: 'selfie_searching',
+        state: 'looking',
+        action: 'none',
+        text: byPersona('Show your face in the oval', "Put the customer's face in the oval"),
+    },
+    selfie_multiple_faces: {
+        reasonCode: 'selfie_multiple_faces',
+        state: 'adjust',
+        action: 'none',
+        text: byPersona('Only one face in the photo', 'One face only'),
+    },
+    selfie_too_dark: {
+        reasonCode: 'selfie_too_dark',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Find more light'),
+    },
+    selfie_too_bright: {
+        reasonCode: 'selfie_too_bright',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Move away from bright light'),
+    },
+    selfie_cropped: {
+        reasonCode: 'selfie_cropped',
+        state: 'adjust',
+        action: 'back',
+        text: byPersona('Move phone back', 'Keep the full face inside the oval'),
+    },
+    selfie_too_small: {
+        reasonCode: 'selfie_too_small',
+        state: 'adjust',
+        action: 'closer',
+        text: byPersona('Move phone closer', 'Move closer. Fill the oval.'),
+    },
+    selfie_too_large: {
+        reasonCode: 'selfie_too_large',
+        state: 'adjust',
+        action: 'back',
+        text: byPersona('Move phone back', 'Move back a little'),
+    },
+    selfie_off_center: {
+        reasonCode: 'selfie_off_center',
+        state: 'adjust',
+        action: 'center',
+        text: byPersona('Center your face', 'Center the face in the oval'),
+    },
+    selfie_blurry: {
+        reasonCode: 'selfie_blurry',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Hold steady — too blurry'),
+    },
+    selfie_hold_still: {
+        reasonCode: 'selfie_hold_still',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly('Hold still…'),
+    },
+    selfie_ready: {
+        reasonCode: 'selfie_ready',
+        state: 'ready',
+        action: 'none',
+        text: byPersona('Ready — tap to take selfie', 'Ready — tap to capture'),
+    },
+};
+/* -- Resolution ------------------------------------------------------------ */
+function resolveCaptureGuidanceSignal(reasonCode, isReady, overlayVariant = 'card', persona = 'self') {
+    const entry = exports.CAPTURE_GUIDANCE_SIGNAL_TABLE[reasonCode];
+    return {
+        text: entry.text(overlayVariant, persona),
+        state: isReady ? 'ready' : entry.state,
+        action: entry.action,
+        reasonCode: entry.reasonCode,
+    };
+}
+/* -- Producer-side reason mapping ------------------------------------------ */
+/**
+ * Map a document placement failure to its guidance reason code. `ok` maps to
+ * the hold-still family because a passing placement frame is, by definition,
+ * waiting on stability/sharpness rather than a correction.
+ */
+exports.DOCUMENT_PLACEMENT_GUIDANCE_REASON = {
+    too_small: 'too_small',
+    too_large: 'too_large_or_cutoff',
+    off_center: 'off_center',
+    edge_tight: 'too_large_or_cutoff',
+    ok: 'hold_still',
+};
+/**
+ * Map live/static selfie assessment issue keys to guidance reason codes.
+ * Tolerant of both dialects in use today (web selfie-detection assessment
+ * reasons and the RN MLKit face-detection issue keys).
+ */
+const SELFIE_ISSUE_GUIDANCE_REASON = {
+    no_face: 'selfie_searching',
+    multiple_faces: 'selfie_multiple_faces',
+    face_too_dark: 'selfie_too_dark',
+    face_too_bright: 'selfie_too_bright',
+    face_cropped: 'selfie_cropped',
+    face_cut_off: 'selfie_cropped',
+    face_too_small: 'selfie_too_small',
+    face_too_large: 'selfie_too_large',
+    face_off_center: 'selfie_off_center',
+    face_blurry: 'selfie_blurry',
+    face_ready: 'selfie_hold_still',
+};
+function mapSelfieIssueToGuidanceReason(issueKey) {
+    return SELFIE_ISSUE_GUIDANCE_REASON[issueKey] ?? null;
+}
+exports.CAPTURE_GUIDANCE_DAMPING_PROFILES = {
+    // Web kyc-mobile values, verbatim (auto-capture.ts dwell tiers).
+    self: {
+        correctiveMinDwellMs: 3000,
+        correctiveConfirmFrames: 6,
+        distanceReversalMinDwellMs: 4500,
+        distanceReversalConfirmFrames: 10,
+        postReadyMinDwellMs: 1500,
+        postReadyConfirmFrames: 3,
+        urgentMinDisplayMs: 1500,
+        glareConfirmFrames: 3,
+    },
+    // Trained repeat operators tolerate faster swaps; cadence is also ~10x
+    // slower (snapshot loop), so frame counts shrink with it.
+    agent: {
+        correctiveMinDwellMs: 1500,
+        correctiveConfirmFrames: 2,
+        distanceReversalMinDwellMs: 2500,
+        distanceReversalConfirmFrames: 3,
+        postReadyMinDwellMs: 750,
+        postReadyConfirmFrames: 1,
+        urgentMinDisplayMs: 1000,
+        glareConfirmFrames: 2,
+    },
+};
+/**
+ * Vibration patterns per signal kind. Invariant (test-locked): ready stays
+ * the strongest pattern — it is the one signal that must cut through when the
+ * user's eyes are on the document, not the screen.
+ */
+exports.CAPTURE_SIGNAL_VIBRATION_PATTERNS = {
+    ready: [40, 60, 90],
+    review: 50,
+    fail: [30, 50, 30],
+};
+/** Cooldown for the ready haptic+chime pair; boundary thrash never spams. */
+exports.READY_SIGNAL_COOLDOWN_MS = 2500;
+/** How long the stored frame is held on screen as capture confirmation. */
+exports.CAPTURE_CONFIRMATION_HOLD_MS = 750;
+/** Two-note ready chime (web parity: 660→880 Hz, 100ms apart). */
+exports.READY_CHIME_NOTES = [
+    { frequencyHz: 660, startOffsetMs: 0, durationMs: 120 },
+    { frequencyHz: 880, startOffsetMs: 100, durationMs: 160 },
+];
+exports.READY_CHIME_GAIN = 0.12;
+/**
+ * After the selfie manual-fallback timer expires onto a hard-block reason,
+ * the shutter holds through ONE bounded extension of this length, then
+ * unlocks permanently. Mirrors web selfie-detection semantics.
+ */
+exports.SELFIE_MANUAL_FALLBACK_HARD_BLOCK_EXTENSION_MS = 8000;
+//# sourceMappingURL=capture-guidance.js.map

package/dist/cjs/capture-guidance.js.map

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

package/dist/cjs/index.d.ts

@@ -34,6 +34,9 @@ export type { MrzDocumentFormat, MrzCheckDigitField, MrzCheckDigitResult, MrzVal
 export { getMrzCharacterValue, computeMrzCheckDigit, normalizeMrzLines, parseMrzText, validateMrzCheckDigits, } from './mrz-check-digits.js';
 export type { DocumentMrzPolicy, DocumentMrzPolicyInput, MrzExpectation, MrzPlacement, } from './mrz-policy.js';
 export { resolveDocumentMrzPolicy } from './mrz-policy.js';
+export type { CaptureGuidanceState, CaptureGuidanceAction, CaptureGuidancePersona, CaptureGuidanceReasonCode, ResolvedCaptureGuidanceReasonCode, CaptureGuidanceSignalEntry, PresentedCaptureGuidanceSignal, CaptureGuidanceDampingProfile, CaptureSignalKind, } from './capture-guidance.js';
+export { CAPTURE_GUIDANCE_SIGNAL_TABLE, resolveCaptureGuidanceSignal, DOCUMENT_PLACEMENT_GUIDANCE_REASON, mapSelfieIssueToGuidanceReason, CAPTURE_GUIDANCE_DAMPING_PROFILES, CAPTURE_SIGNAL_VIBRATION_PATTERNS, READY_SIGNAL_COOLDOWN_MS, CAPTURE_CONFIRMATION_HOLD_MS, READY_CHIME_NOTES, READY_CHIME_GAIN, SELFIE_MANUAL_FALLBACK_HARD_BLOCK_EXTENSION_MS, MANUAL_CAPTURE_READY_FEEDBACK, GOOD_HOLD_STILL_FEEDBACK, TAKING_PHOTO_META, INITIAL_DOCUMENT_FEEDBACK, AUTO_CAPTURE_BURST_ABORT_FEEDBACK, getDocumentSubjectLabel, getTiltAwayFromLightGuidance, getMoveToMiddleFeedback, } from './capture-guidance.js';
+export { CAPTURE_INTELLIGENCE_CORE_VERSION } from './version.js';
 export type { QualityFailureState, DocumentQualityInput, DocumentQualityResult, SelfieQualityInput, } from './quality-checks.js';
 export { getQualityBucket, getSubmitAnywayThreshold, createQualityFailureState, countFailedReview, shouldShowSubmitAnyway, hasHardBlockingQualityFailure, isRetryEscapableDocumentCornerFailure, getReviewModeFromDocumentType, runDocumentQualityChecks, runSelfieQualityChecks, checkFaceInImage, isFaceCentered, evaluateDocumentFailure, evaluateSelfieFailure, evaluateReviewFailure, getNextButtonDisabledReason, getOverrideButtonText, getOverrideBannerMessage, } from './quality-checks.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -10,8 +10,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeImageMetadata = exports.checkDocumentLikelihood = exports.getDocumentReviewProfile = exports.getDocumentCaptureGeometryProfile = exports.getPreviousFlowStepId = exports.getNextFlowStepId = exports.resolveIssuingCountry = exports.normalizeIssuingCountry = exports.getIssuingCountryMetadata = exports.validateKycMobileWorkflowConfigContract = exports.KYC_MOBILE_VALID_SUBMISSION_COMPLETION_MODES = exports.KYC_MOBILE_VALID_GPS_POLICIES = exports.KYC_MOBILE_VALID_CAPTURE_MODES = exports.KYC_MOBILE_VALID_ADDRESS_FIELD_MODES = exports.KYC_MOBILE_VALID_ADDRESS_METHODS = exports.KYC_MOBILE_SIERRA_LEONE_STEP_ORDER = exports.KYC_MOBILE_REQUIRED_TERMINAL_STEP_IDS = exports.KYC_MOBILE_KNOWN_STEP_IDS = exports.KYC_MOBILE_ADDRESS_STEP_IDS = exports.isAddressStepComplete = exports.hasStructuredAddress = exports.hasAddressProofCoordinates = exports.getEffectiveAddressMethod = exports.getAddressMethodStartBehavior = exports.getRecommendedAddressMethod = exports.sanitizeAllowedAddressMethods = exports.isAddressMethod = exports.ADDRESS_METHOD_ORDER = exports.PICO_ANALYSIS_H = exports.PICO_ANALYSIS_W = exports.ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD = exports.SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD = exports.DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD = exports.DOC_GALLERY_FAILURE_THRESHOLD = exports.CAPTURE_DOCUMENT_EDGE_READY_MULTIPLIER = exports.CAPTURE_DOCUMENT_AREA_MIN = exports.CAPTURE_DOCUMENT_MANUAL_FALLBACK_SECS = exports.CAPTURE_DOCUMENT_SHARPNESS_MIN = exports.CAM_DOC_CENTER_OFFSET_MAX = exports.CAM_EDGE_COVERAGE_THRESHOLD = exports.CAM_EDGE_PIXEL_THRESHOLD = exports.CAM_FRAME_DIFF_THRESHOLD = exports.CAM_STABLE_FRAMES_NEEDED = exports.CAM_EDGE_THRESHOLD = exports.CAM_BLUR_THRESHOLD = exports.CAM_BRIGHTNESS_MAX = exports.CAM_BRIGHTNESS_MIN = exports.CAM_ANALYSIS_H = exports.CAM_ANALYSIS_W = exports.CamState = void 0;
-exports.runSelfieQualityChecks = exports.runDocumentQualityChecks = exports.getReviewModeFromDocumentType = exports.isRetryEscapableDocumentCornerFailure = exports.hasHardBlockingQualityFailure = exports.shouldShowSubmitAnyway = exports.countFailedReview = exports.createQualityFailureState = exports.getSubmitAnywayThreshold = exports.getQualityBucket = exports.resolveDocumentMrzPolicy = exports.validateMrzCheckDigits = exports.parseMrzText = exports.normalizeMrzLines = exports.computeMrzCheckDigit = exports.getMrzCharacterValue = exports.MRZ_DENSITY_SCORE_SATURATION = exports.MRZ_SEARCH_TOP_FRAC = exports.MRZ_MAX_BAND_ASPECT = exports.MRZ_MIN_BAND_ASPECT = exports.MRZ_MIN_BAND_WIDTH_FRAC = exports.MRZ_MAX_BAND_HEIGHT = exports.MRZ_MIN_BAND_HEIGHT = exports.MRZ_ROW_DENSITY_RATIO_THRESHOLD = exports.MRZ_HORIZONTAL_GRADIENT_THRESHOLD = exports.detectPassportMrzBand = exports.looksLikeDocument = exports.analyzeFrame = exports.computeFrameDiff = exports.detectDocumentRect = exports.computeEdgeEnergy = exports.computeLaplacianVarianceFloat = exports.computeLaplacianVariance = exports.computeBrightness = exports.rgbaToGreyInPlace = exports.detectDocumentCropFromGrey = exports.computeEdgeEnergyProfile = exports.rgbaToGreyscalePico = exports.rgbaToGreyscale = exports.evaluateDocumentPlacement = exports.CAPTURE_READY_SAFE_INSET_MIN = exports.CAPTURE_READY_CENTER_MAX_BY_SHAPE = exports.CAPTURE_READY_AREA_MAX_BY_SHAPE = exports.RELAXED_CAPTURE_READY_AREA_MIN_BY_SHAPE = exports.CAPTURE_READY_AREA_MIN_BY_SHAPE = exports.getDocumentCaptureFrameAspectRatio = exports.buildCaptureNormalizationPlan = exports.getRotationToExpectedOrientation = exports.mapPreviewRectToImageCrop = exports.mapPreviewRectToImageCropWithDiagnostics = void 0;
-exports.getOverrideBannerMessage = exports.getOverrideButtonText = exports.getNextButtonDisabledReason = exports.evaluateReviewFailure = exports.evaluateSelfieFailure = exports.evaluateDocumentFailure = exports.isFaceCentered = exports.checkFaceInImage = void 0;
+exports.READY_CHIME_GAIN = exports.READY_CHIME_NOTES = exports.CAPTURE_CONFIRMATION_HOLD_MS = exports.READY_SIGNAL_COOLDOWN_MS = exports.CAPTURE_SIGNAL_VIBRATION_PATTERNS = exports.CAPTURE_GUIDANCE_DAMPING_PROFILES = exports.mapSelfieIssueToGuidanceReason = exports.DOCUMENT_PLACEMENT_GUIDANCE_REASON = exports.resolveCaptureGuidanceSignal = exports.CAPTURE_GUIDANCE_SIGNAL_TABLE = exports.resolveDocumentMrzPolicy = exports.validateMrzCheckDigits = exports.parseMrzText = exports.normalizeMrzLines = exports.computeMrzCheckDigit = exports.getMrzCharacterValue = exports.MRZ_DENSITY_SCORE_SATURATION = exports.MRZ_SEARCH_TOP_FRAC = exports.MRZ_MAX_BAND_ASPECT = exports.MRZ_MIN_BAND_ASPECT = exports.MRZ_MIN_BAND_WIDTH_FRAC = exports.MRZ_MAX_BAND_HEIGHT = exports.MRZ_MIN_BAND_HEIGHT = exports.MRZ_ROW_DENSITY_RATIO_THRESHOLD = exports.MRZ_HORIZONTAL_GRADIENT_THRESHOLD = exports.detectPassportMrzBand = exports.looksLikeDocument = exports.analyzeFrame = exports.computeFrameDiff = exports.detectDocumentRect = exports.computeEdgeEnergy = exports.computeLaplacianVarianceFloat = exports.computeLaplacianVariance = exports.computeBrightness = exports.rgbaToGreyInPlace = exports.detectDocumentCropFromGrey = exports.computeEdgeEnergyProfile = exports.rgbaToGreyscalePico = exports.rgbaToGreyscale = exports.evaluateDocumentPlacement = exports.CAPTURE_READY_SAFE_INSET_MIN = exports.CAPTURE_READY_CENTER_MAX_BY_SHAPE = exports.CAPTURE_READY_AREA_MAX_BY_SHAPE = exports.RELAXED_CAPTURE_READY_AREA_MIN_BY_SHAPE = exports.CAPTURE_READY_AREA_MIN_BY_SHAPE = exports.getDocumentCaptureFrameAspectRatio = exports.buildCaptureNormalizationPlan = exports.getRotationToExpectedOrientation = exports.mapPreviewRectToImageCrop = exports.mapPreviewRectToImageCropWithDiagnostics = void 0;
+exports.getOverrideBannerMessage = exports.getOverrideButtonText = exports.getNextButtonDisabledReason = exports.evaluateReviewFailure = exports.evaluateSelfieFailure = exports.evaluateDocumentFailure = exports.isFaceCentered = exports.checkFaceInImage = exports.runSelfieQualityChecks = exports.runDocumentQualityChecks = exports.getReviewModeFromDocumentType = exports.isRetryEscapableDocumentCornerFailure = exports.hasHardBlockingQualityFailure = exports.shouldShowSubmitAnyway = exports.countFailedReview = exports.createQualityFailureState = exports.getSubmitAnywayThreshold = exports.getQualityBucket = exports.CAPTURE_INTELLIGENCE_CORE_VERSION = exports.getMoveToMiddleFeedback = exports.getTiltAwayFromLightGuidance = exports.getDocumentSubjectLabel = exports.AUTO_CAPTURE_BURST_ABORT_FEEDBACK = exports.INITIAL_DOCUMENT_FEEDBACK = exports.TAKING_PHOTO_META = exports.GOOD_HOLD_STILL_FEEDBACK = exports.MANUAL_CAPTURE_READY_FEEDBACK = exports.SELFIE_MANUAL_FALLBACK_HARD_BLOCK_EXTENSION_MS = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "CamState", { enumerable: true, get: function () { return types_js_1.CamState; } });
 Object.defineProperty(exports, "CAM_ANALYSIS_W", { enumerable: true, get: function () { return types_js_1.CAM_ANALYSIS_W; } });
@@ -117,6 +117,29 @@ Object.defineProperty(exports, "parseMrzText", { enumerable: true, get: function
 Object.defineProperty(exports, "validateMrzCheckDigits", { enumerable: true, get: function () { return mrz_check_digits_js_1.validateMrzCheckDigits; } });
 var mrz_policy_js_1 = require("./mrz-policy.js");
 Object.defineProperty(exports, "resolveDocumentMrzPolicy", { enumerable: true, get: function () { return mrz_policy_js_1.resolveDocumentMrzPolicy; } });
+var capture_guidance_js_1 = require("./capture-guidance.js");
+Object.defineProperty(exports, "CAPTURE_GUIDANCE_SIGNAL_TABLE", { enumerable: true, get: function () { return capture_guidance_js_1.CAPTURE_GUIDANCE_SIGNAL_TABLE; } });
+Object.defineProperty(exports, "resolveCaptureGuidanceSignal", { enumerable: true, get: function () { return capture_guidance_js_1.resolveCaptureGuidanceSignal; } });
+Object.defineProperty(exports, "DOCUMENT_PLACEMENT_GUIDANCE_REASON", { enumerable: true, get: function () { return capture_guidance_js_1.DOCUMENT_PLACEMENT_GUIDANCE_REASON; } });
+Object.defineProperty(exports, "mapSelfieIssueToGuidanceReason", { enumerable: true, get: function () { return capture_guidance_js_1.mapSelfieIssueToGuidanceReason; } });
+Object.defineProperty(exports, "CAPTURE_GUIDANCE_DAMPING_PROFILES", { enumerable: true, get: function () { return capture_guidance_js_1.CAPTURE_GUIDANCE_DAMPING_PROFILES; } });
+Object.defineProperty(exports, "CAPTURE_SIGNAL_VIBRATION_PATTERNS", { enumerable: true, get: function () { return capture_guidance_js_1.CAPTURE_SIGNAL_VIBRATION_PATTERNS; } });
+Object.defineProperty(exports, "READY_SIGNAL_COOLDOWN_MS", { enumerable: true, get: function () { return capture_guidance_js_1.READY_SIGNAL_COOLDOWN_MS; } });
+Object.defineProperty(exports, "CAPTURE_CONFIRMATION_HOLD_MS", { enumerable: true, get: function () { return capture_guidance_js_1.CAPTURE_CONFIRMATION_HOLD_MS; } });
+Object.defineProperty(exports, "READY_CHIME_NOTES", { enumerable: true, get: function () { return capture_guidance_js_1.READY_CHIME_NOTES; } });
+Object.defineProperty(exports, "READY_CHIME_GAIN", { enumerable: true, get: function () { return capture_guidance_js_1.READY_CHIME_GAIN; } });
+Object.defineProperty(exports, "SELFIE_MANUAL_FALLBACK_HARD_BLOCK_EXTENSION_MS", { enumerable: true, get: function () { return capture_guidance_js_1.SELFIE_MANUAL_FALLBACK_HARD_BLOCK_EXTENSION_MS; } });
+Object.defineProperty(exports, "MANUAL_CAPTURE_READY_FEEDBACK", { enumerable: true, get: function () { return capture_guidance_js_1.MANUAL_CAPTURE_READY_FEEDBACK; } });
+Object.defineProperty(exports, "GOOD_HOLD_STILL_FEEDBACK", { enumerable: true, get: function () { return capture_guidance_js_1.GOOD_HOLD_STILL_FEEDBACK; } });
+Object.defineProperty(exports, "TAKING_PHOTO_META", { enumerable: true, get: function () { return capture_guidance_js_1.TAKING_PHOTO_META; } });
+Object.defineProperty(exports, "INITIAL_DOCUMENT_FEEDBACK", { enumerable: true, get: function () { return capture_guidance_js_1.INITIAL_DOCUMENT_FEEDBACK; } });
+Object.defineProperty(exports, "AUTO_CAPTURE_BURST_ABORT_FEEDBACK", { enumerable: true, get: function () { return capture_guidance_js_1.AUTO_CAPTURE_BURST_ABORT_FEEDBACK; } });
+Object.defineProperty(exports, "getDocumentSubjectLabel", { enumerable: true, get: function () { return capture_guidance_js_1.getDocumentSubjectLabel; } });
+Object.defineProperty(exports, "getTiltAwayFromLightGuidance", { enumerable: true, get: function () { return capture_guidance_js_1.getTiltAwayFromLightGuidance; } });
+Object.defineProperty(exports, "getMoveToMiddleFeedback", { enumerable: true, get: function () { return capture_guidance_js_1.getMoveToMiddleFeedback; } });
+/* -- Version beacon -------------------------------------------------------- */
+var version_js_1 = require("./version.js");
+Object.defineProperty(exports, "CAPTURE_INTELLIGENCE_CORE_VERSION", { enumerable: true, get: function () { return version_js_1.CAPTURE_INTELLIGENCE_CORE_VERSION; } });
 var quality_checks_js_1 = require("./quality-checks.js");
 Object.defineProperty(exports, "getQualityBucket", { enumerable: true, get: function () { return quality_checks_js_1.getQualityBucket; } });
 Object.defineProperty(exports, "getSubmitAnywayThreshold", { enumerable: true, get: function () { return quality_checks_js_1.getSubmitAnywayThreshold; } });

package/dist/cjs/index.js.map

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

package/dist/cjs/quality-checks.d.ts

@@ -192,10 +192,13 @@ export declare function evaluateReviewFailure(checks: QualityCheckResults, optio
 export declare function getNextButtonDisabledReason(checks: QualityCheckResults, isSelfieOrOptions: boolean | ReviewDecisionOptions, isAddressProof?: boolean): string;
 /**
  * Get the override button text for the submit-anyway flow.
+ *
+ * The 'agent' persona strings are the agent-kyc-app's shipped copy, owned
+ * here so client and core cannot drift.
  */
-export declare function getOverrideButtonText(stepSig: string): string;
+export declare function getOverrideButtonText(stepSig: string, persona?: 'self' | 'agent'): string;
 /**
  * Get the override banner message based on failure count and bucket.
  */
-export declare function getOverrideBannerMessage(stepSig: string, failCount: number, reviewMode?: ReviewMode): string;
+export declare function getOverrideBannerMessage(stepSig: string, failCount: number, reviewMode?: ReviewMode, persona?: 'self' | 'agent'): string;
 //# sourceMappingURL=quality-checks.d.ts.map