@mikashboks/capture-intelligence-core 0.2.0 → 0.2.2

package/dist/cjs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+EAA+E;AAElE,QAAA,QAAQ,GAAG;IACtB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;CACC,CAAC;AAsJX,+EAA+E;AAElE,QAAA,cAAc,GAAG,GAAG,CAAC;AACrB,QAAA,cAAc,GAAG,GAAG,CAAC;AACrB,QAAA,kBAAkB,GAAG,EAAE,CAAC;AACxB,QAAA,kBAAkB,GAAG,GAAG,CAAC;AACzB,QAAA,kBAAkB,GAAG,EAAE,CAAC;AACxB,QAAA,kBAAkB,GAAG,CAAC,CAAC;AACvB,QAAA,wBAAwB,GAAG,CAAC,CAAC,CAAC,kBAAkB;AAChD,QAAA,wBAAwB,GAAG,EAAE,CAAC;AAC9B,QAAA,wBAAwB,GAAG,EAAE,CAAC;AAC9B,QAAA,2BAA2B,GAAG,IAAI,CAAC;AACnC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AAE9C,+EAA+E;AAElE,QAAA,8BAA8B,GAAG,EAAE,CAAC;AACpC,QAAA,qCAAqC,GAAG,CAAC,CAAC;AAC1C,QAAA,yBAAyB,GAAG,GAAG,CAAC;AAChC,QAAA,sCAAsC,GAAG,IAAI,CAAC;AAE3D,+EAA+E;AAElE,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAClC,QAAA,mCAAmC,GAAG,CAAC,CAAC;AACxC,QAAA,sCAAsC,GAAG,CAAC,CAAC;AAC3C,QAAA,uCAAuC,GAAG,CAAC,CAAC;AAEzD,+EAA+E;AAElE,QAAA,eAAe,GAAG,GAAG,CAAC;AACtB,QAAA,eAAe,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+EAA+E;AAElE,QAAA,QAAQ,GAAG;IACtB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;CACC,CAAC;AA6JX,+EAA+E;AAElE,QAAA,cAAc,GAAG,GAAG,CAAC;AACrB,QAAA,cAAc,GAAG,GAAG,CAAC;AACrB,QAAA,kBAAkB,GAAG,EAAE,CAAC;AACxB,QAAA,kBAAkB,GAAG,GAAG,CAAC;AACzB,QAAA,kBAAkB,GAAG,EAAE,CAAC;AACxB,QAAA,kBAAkB,GAAG,CAAC,CAAC;AACvB,QAAA,wBAAwB,GAAG,CAAC,CAAC,CAAC,kBAAkB;AAChD,QAAA,wBAAwB,GAAG,EAAE,CAAC;AAC9B,QAAA,wBAAwB,GAAG,EAAE,CAAC;AAC9B,QAAA,2BAA2B,GAAG,IAAI,CAAC;AACnC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AAC9C;;;;;;;;GAQG;AACU,QAAA,4BAA4B,GAAG,EAAE,CAAC;AAClC,QAAA,mCAAmC,GAAG,EAAE,CAAC;AAEtD,+EAA+E;AAElE,QAAA,8BAA8B,GAAG,EAAE,CAAC;AACpC,QAAA,qCAAqC,GAAG,CAAC,CAAC;AAC1C,QAAA,yBAAyB,GAAG,GAAG,CAAC;AAChC,QAAA,sCAAsC,GAAG,IAAI,CAAC;AAE3D,+EAA+E;AAElE,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAClC,QAAA,mCAAmC,GAAG,CAAC,CAAC;AACxC,QAAA,sCAAsC,GAAG,CAAC,CAAC;AAC3C,QAAA,uCAAuC,GAAG,CAAC,CAAC;AAEzD,+EAA+E;AAElE,QAAA,eAAe,GAAG,GAAG,CAAC;AACtB,QAAA,eAAe,GAAG,GAAG,CAAC"}

package/dist/cjs/version.d.ts

@@ -3,5 +3,5 @@
  * version.json). Must match package.json — test-locked in
  * test/capture-guidance.test.mjs. Bump both together.
  */
-export declare const CAPTURE_INTELLIGENCE_CORE_VERSION = "0.2.0";
+export declare const CAPTURE_INTELLIGENCE_CORE_VERSION = "0.2.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/cjs/version.js

@@ -6,5 +6,5 @@ exports.CAPTURE_INTELLIGENCE_CORE_VERSION = void 0;
  * version.json). Must match package.json — test-locked in
  * test/capture-guidance.test.mjs. Bump both together.
  */
-exports.CAPTURE_INTELLIGENCE_CORE_VERSION = '0.2.0';
+exports.CAPTURE_INTELLIGENCE_CORE_VERSION = '0.2.2';
 //# sourceMappingURL=version.js.map

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

@@ -22,13 +22,14 @@ export type CaptureGuidanceState = 'looking' | 'adjust' | 'ready';
  */
 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 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' | 'wrong_side' | '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 const WRONG_SIDE_TURN_OVER_FEEDBACK = "This looks like the back of the card. Turn it over.";
 export declare function getDocumentSubjectLabel(overlayVariant: OverlayVariant): string;
 export declare function getTiltAwayFromLightGuidance(overlayVariant: OverlayVariant): string;
 export declare function getMoveToMiddleFeedback(overlayVariant: OverlayVariant): string;

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

@@ -1 +1 @@
-{"version":3,"file":"capture-guidance.d.ts","sourceRoot":"","sources":["../../src/capture-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIvE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD,MAAM,MAAM,yBAAyB,GACjC,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,cAAc,GACd,cAAc,GACd,WAAW,GACX,qBAAqB,GACrB,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,UAAU,GACV,YAAY,GACZ,UAAU,GACV,OAAO,GACP,QAAQ,GACR,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,sBAAsB,GACtB,kBAAkB,GAClB,4BAA4B,GAC5B,6BAA6B,GAC7B,wBAAwB,GACxB,oBAAoB,GACpB,aAAa,GACb,kBAAkB,GAClB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,mBAAmB,GACnB,cAAc,GACd,cAAc,CAAC;AAEnB,MAAM,MAAM,iCAAiC,GAAG,OAAO,CAAC,yBAAyB,EAAE,cAAc,CAAC,CAAC;AAInG,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AACxE,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAM3D,eAAO,MAAM,iBAAiB,qBAAgB,CAAC;AAC/C,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAC5E,eAAO,MAAM,iCAAiC,oCAAoC,CAAC;AAEnF,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAG9E;AAED,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAEnF;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAG9E;AAID,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,iCAAiC,CAAC;IAC9C,kEAAkE;IAClE,KAAK,EAAE,oBAAoB,CAAC;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,MAAM,CAAC;CACpF;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,CAAC;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,yBAAyB,CAAC;CACvC;AAYD,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAChD,iCAAiC,EACjC,0BAA0B,CAkP3B,CAAC;AAIF,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,iCAAiC,EAC7C,OAAO,EAAE,OAAO,EAChB,cAAc,GAAE,cAAuB,EACvC,OAAO,GAAE,sBAA+B,GACvC,8BAA8B,CAQhC;AAID;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,EAAE,MAAM,CACrD,uBAAuB,EACvB,iCAAiC,CAOlC,CAAC;AAqBF,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,GACf,iCAAiC,GAAG,IAAI,CAE1C;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,wEAAwE;IACxE,0BAA0B,EAAE,MAAM,CAAC;IACnC,6BAA6B,EAAE,MAAM,CAAC;IACtC,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,iCAAiC,EAAE,MAAM,CACpD,sBAAsB,EACtB,6BAA6B,CAyB9B,CAAC;AAIF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,CAI1F,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,2EAA2E;AAC3E,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAGA,CAAC;AAEF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,8CAA8C,OAAO,CAAC"}
+{"version":3,"file":"capture-guidance.d.ts","sourceRoot":"","sources":["../../src/capture-guidance.ts"],"names":[],"mappings":"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"}

package/dist/esm/capture-guidance.js

@@ -23,6 +23,10 @@ export const GOOD_HOLD_STILL_FEEDBACK = 'Good. Hold still';
 export const TAKING_PHOTO_META = 'Hold still…';
 export const INITIAL_DOCUMENT_FEEDBACK = 'Put your document inside the box';
 export const AUTO_CAPTURE_BURST_ABORT_FEEDBACK = 'No clear photo yet. Hold still.';
+// Wrong-side negative evidence (I05): a confirmed MRZ band on a card FRONT
+// step can only be the back of the card. Persona-neutral by design — the
+// instruction is about the card, not the holder.
+export const WRONG_SIDE_TURN_OVER_FEEDBACK = 'This looks like the back of the card. Turn it over.';
 export function getDocumentSubjectLabel(overlayVariant) {
     if (overlayVariant === 'passport')
         return 'passport photo page';
@@ -109,7 +113,7 @@ export const CAPTURE_GUIDANCE_SIGNAL_TABLE = {
         reasonCode: 'off_center',
         state: 'adjust',
         action: 'center',
-        text: (overlayVariant) => getMoveToMiddleFeedback(overlayVariant),
+        text: overlayVariant => getMoveToMiddleFeedback(overlayVariant),
     },
     nudge_left: {
         reasonCode: 'nudge_left',
@@ -145,7 +149,7 @@ export const CAPTURE_GUIDANCE_SIGNAL_TABLE = {
         reasonCode: 'glare',
         state: 'adjust',
         action: 'none',
-        text: (overlayVariant) => getTiltAwayFromLightGuidance(overlayVariant),
+        text: overlayVariant => getTiltAwayFromLightGuidance(overlayVariant),
     },
     blurry: {
         reasonCode: 'blurry',
@@ -159,6 +163,14 @@ export const CAPTURE_GUIDANCE_SIGNAL_TABLE = {
         action: 'none',
         text: selfOnly('Tilt to flatten the document'),
     },
+    // No directional glyph exists for "flip the card" — condition-style 'none'
+    // is deliberate so the urgent copy carries the whole instruction.
+    wrong_side: {
+        reasonCode: 'wrong_side',
+        state: 'adjust',
+        action: 'none',
+        text: selfOnly(WRONG_SIDE_TURN_OVER_FEEDBACK),
+    },
     mrz_band_closer: {
         reasonCode: 'mrz_band_closer',
         state: 'adjust',

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

@@ -1 +1 @@
-{"version":3,"file":"capture-guidance.js","sourceRoot":"","sources":["../../src/capture-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuEH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAC3D,yEAAyE;AACzE,8EAA8E;AAC9E,qEAAqE;AACrE,2EAA2E;AAC3E,+BAA+B;AAC/B,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAC5E,MAAM,CAAC,MAAM,iCAAiC,GAAG,iCAAiC,CAAC;AAEnF,MAAM,UAAU,uBAAuB,CAAC,cAA8B;IACpE,IAAI,cAAc,KAAK,UAAU;QAAE,OAAO,qBAAqB,CAAC;IAChE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,cAA8B;IACzE,OAAO,QAAQ,uBAAuB,CAAC,cAAc,CAAC,kBAAkB,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,cAA8B;IACpE,IAAI,cAAc,KAAK,UAAU;QAAE,OAAO,wCAAwC,CAAC;IACnF,OAAO,6BAA6B,CAAC;AACvC,CAAC;AAmBD,MAAM,QAAQ,GACZ,CAAC,IAAY,EAAE,EAAE,CACjB,CAAC,eAA+B,EAAE,WAAmC,MAAM,EAAE,EAAE,CAC7E,IAAI,CAAC;AAET,MAAM,SAAS,GACb,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE,CAChC,CAAC,eAA+B,EAAE,UAAkC,MAAM,EAAE,EAAE,CAC5E,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAEvC,MAAM,CAAC,MAAM,6BAA6B,GAGtC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,WAAW;QACvB,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,SAAS,CAAC,yBAAyB,EAAE,iCAAiC,CAAC;KAC9E;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,kBAAkB;QAC9B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,qBAAqB,CAAC;KACtC;IACD,UAAU,EAAE;QACV,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,wBAAwB,CAAC;KACzC;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,cAAc;QAC1B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,wBAAwB,CAAC;KACzC;IACD,cAAc,EAAE;QACd,UAAU,EAAE,gBAAgB;QAC5B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,wBAAwB,CAAC;KACzC;IACD,SAAS,EAAE;QACT,UAAU,EAAE,WAAW;QACvB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,wBAAwB,CAAC;KACzC;IACD,WAAW,EAAE;QACX,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,wBAAwB,CAAC;KACzC;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,cAAc;QAC1B,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,6BAA6B,CAAC;KAC9C;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,cAAc;QAC1B,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC;KAClC;IACD,SAAS,EAAE;QACT,UAAU,EAAE,WAAW;QACvB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,QAAQ,CAAC,oBAAoB,CAAC;KACrC;IACD,mBAAmB,EAAE;QACnB,UAAU,EAAE,qBAAqB;QACjC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,qCAAqC,CAAC;KACtD;IACD,UAAU,EAAE;QACV,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,uBAAuB,CAAC,cAAc,CAAC;KAClE;IACD,UAAU,EAAE;QACV,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC;KAC5B;IACD,WAAW,EAAE;QACX,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC;KAC7B;IACD,QAAQ,EAAE;QACR,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC;KAC1B;IACD,UAAU,EAAE;QACV,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC;KAC5B;IACD,QAAQ,EAAE;QACR,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,mBAAmB,CAAC;KACpC;IACD,KAAK,EAAE;QACL,UAAU,EAAE,OAAO;QACnB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,4BAA4B,CAAC,cAAc,CAAC;KACvE;IACD,MAAM,EAAE;QACN,UAAU,EAAE,QAAQ;QACpB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,6BAA6B,CAAC;KAC9C;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,kBAAkB;QAC9B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,8BAA8B,CAAC;KAC/C;IACD,eAAe,EAAE;QACf,UAAU,EAAE,iBAAiB;QAC7B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,QAAQ,CAAC,kDAAkD,CAAC;KACnE;IACD,cAAc,EAAE;QACd,UAAU,EAAE,gBAAgB;QAC5B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,kCAAkC,CAAC;KACnD;IACD,oBAAoB,EAAE;QACpB,UAAU,EAAE,sBAAsB;QAClC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,QAAQ,CAAC,yCAAyC,CAAC;KAC1D;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,kBAAkB;QAC9B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,QAAQ,CAAC,yCAAyC,CAAC;KAC1D;IACD,0BAA0B,EAAE;QAC1B,UAAU,EAAE,4BAA4B;QACxC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,uCAAuC,CAAC;KACxD;IACD,2BAA2B,EAAE;QAC3B,UAAU,EAAE,6BAA6B;QACzC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,uCAAuC,CAAC;KACxD;IACD,sBAAsB,EAAE;QACtB,UAAU,EAAE,wBAAwB;QACpC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,4BAA4B,CAAC;KAC7C;IACD,kBAAkB,EAAE;QAClB,UAAU,EAAE,oBAAoB;QAChC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,uCAAuC,CAAC;KACxD;IACD,WAAW,EAAE;QACX,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,iCAAiC,CAAC;KAClD;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,kBAAkB;QAC9B,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,SAAS,CAAC,4BAA4B,EAAE,qCAAqC,CAAC;KACrF;IACD,qBAAqB,EAAE;QACrB,UAAU,EAAE,uBAAuB;QACnC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,SAAS,CAAC,4BAA4B,EAAE,eAAe,CAAC;KAC/D;IACD,eAAe,EAAE;QACf,UAAU,EAAE,iBAAiB;QAC7B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC;KAClC;IACD,iBAAiB,EAAE;QACjB,UAAU,EAAE,mBAAmB;QAC/B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,6BAA6B,CAAC;KAC9C;IACD,cAAc,EAAE;QACd,UAAU,EAAE,gBAAgB;QAC5B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;KACzE;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,kBAAkB;QAC9B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,SAAS,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;KACpE;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,kBAAkB;QAC9B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;KACzD;IACD,iBAAiB,EAAE;QACjB,UAAU,EAAE,mBAAmB;QAC/B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,SAAS,CAAC,kBAAkB,EAAE,6BAA6B,CAAC;KACnE;IACD,aAAa,EAAE;QACb,UAAU,EAAE,eAAe;QAC3B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,0BAA0B,CAAC;KAC3C;IACD,iBAAiB,EAAE;QACjB,UAAU,EAAE,mBAAmB;QAC/B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC;KAC9B;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,cAAc;QAC1B,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,SAAS,CAAC,4BAA4B,EAAE,wBAAwB,CAAC;KACxE;CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,UAAU,4BAA4B,CAC1C,UAA6C,EAC7C,OAAgB,EAChB,iBAAiC,MAAM,EACvC,UAAkC,MAAM;IAExC,MAAM,KAAK,GAAG,6BAA6B,CAAC,UAAU,CAAC,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;QACzC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAG3C;IACF,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,qBAAqB;IAChC,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,qBAAqB;IACjC,EAAE,EAAE,YAAY;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,4BAA4B,GAAsD;IACtF,OAAO,EAAE,kBAAkB;IAC3B,cAAc,EAAE,uBAAuB;IACvC,aAAa,EAAE,iBAAiB;IAChC,eAAe,EAAE,mBAAmB;IACpC,YAAY,EAAE,gBAAgB;IAC9B,YAAY,EAAE,gBAAgB;IAC9B,cAAc,EAAE,kBAAkB;IAClC,cAAc,EAAE,kBAAkB;IAClC,eAAe,EAAE,mBAAmB;IACpC,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,mBAAmB;CAChC,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAC5C,QAAgB;IAEhB,OAAO,4BAA4B,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC;AA4BD,MAAM,CAAC,MAAM,iCAAiC,GAG1C;IACF,iEAAiE;IACjE,IAAI,EAAE;QACJ,oBAAoB,EAAE,IAAI;QAC1B,uBAAuB,EAAE,CAAC;QAC1B,0BAA0B,EAAE,IAAI;QAChC,6BAA6B,EAAE,EAAE;QACjC,mBAAmB,EAAE,IAAI;QACzB,sBAAsB,EAAE,CAAC;QACzB,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,CAAC;KACtB;IACD,uEAAuE;IACvE,0DAA0D;IAC1D,KAAK,EAAE;QACL,oBAAoB,EAAE,IAAI;QAC1B,uBAAuB,EAAE,CAAC;QAC1B,0BAA0B,EAAE,IAAI;QAChC,6BAA6B,EAAE,CAAC;QAChC,mBAAmB,EAAE,GAAG;QACxB,sBAAsB,EAAE,CAAC;QACzB,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,CAAC;KACtB;CACF,CAAC;AAMF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAiD;IAC7F,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IACnB,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;CACnB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAIzB;IACH,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE;IACvD,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;CAC1D,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,8CAA8C,GAAG,IAAI,CAAC"}
+{"version":3,"file":"capture-guidance.js","sourceRoot":"","sources":["../../src/capture-guidance.ts"],"names":[],"mappings":"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"}

package/dist/esm/capture-trust.d.ts

@@ -0,0 +1,142 @@
+export type CaptureTrustClient = 'web' | 'agent';
+export type CaptureTrustPhase = 'capture' | 'review';
+export type CaptureTrustCaptureSource = 'camera' | 'auto_capture' | 'manual' | 'gallery' | 'native_platform_scanner' | 'unknown';
+export type CaptureTrustDocumentSide = 'front' | 'back' | 'selfie' | null;
+export type CaptureTrustCropProvenance = 'same_candidate' | 'viewfinder_fallback' | 'unsafe_full_frame' | 'gallery' | 'review_auto_crop' | 'still_redetect' | 'native_platform_scanner' | 'viewfinder_candidate' | string;
+export type CaptureTrustReasonCode = 'missing_metrics' | 'too_dark' | 'too_bright' | 'too_blurry' | 'cutoff_high' | 'glare' | 'edge_tight' | 'unsafe_crop' | 'wrong_side' | 'not_document_like' | 'weak_back_text' | 'weak_readable_text' | 'review_safe' | 'manual_ready' | 'face_unconfirmed' | 'auto_safe' | 'review_trusted' | 'review_untrusted' | 'crop_trusted' | 'crop_original_only' | 'crop_rejected';
+export type CaptureTrustGate = 'hard_block' | 'soft_block' | 'review_candidate' | 'manual_ready' | 'auto_ready';
+export type CropTrustTier = 'none' | 'original_frame' | 'unsafe_full_frame' | 'live_candidate' | 'verified_crop' | 'review_auto_crop' | 'native_platform_crop' | 'gallery';
+export type DocumentFaceCorroborationTrustStatus = 'face_present' | 'no_face' | 'unavailable' | null;
+export interface CaptureTrustContextInput {
+    client?: CaptureTrustClient;
+    phase?: CaptureTrustPhase;
+    documentType?: string | null;
+    documentSide?: CaptureTrustDocumentSide;
+    captureSource?: CaptureTrustCaptureSource;
+}
+export interface CaptureTrustLiveInput {
+    accepted?: boolean | null;
+    acceptedReason?: string | null;
+    path?: string | null;
+    strategy?: string | null;
+    backend?: string | null;
+}
+export interface CaptureTrustClassifierInput {
+    confidence?: number | null;
+    rescue?: boolean | null;
+    strategyFloorMet?: boolean | null;
+    highConfidence?: boolean | null;
+    likely?: boolean | null;
+}
+export interface CaptureTrustMrzInput {
+    present?: boolean | null;
+    confirmed?: boolean | null;
+    validated?: boolean | null;
+    checkDigitsValid?: boolean | null;
+    wrongSide?: boolean | null;
+}
+export interface CaptureTrustGeometryInput {
+    reliableQuad?: boolean | null;
+    marginSafeReliableQuad?: boolean | null;
+    safeSobelBounds?: boolean | null;
+    unsafeSobelBounds?: boolean | null;
+    unreliableSobelOverfull?: boolean | null;
+    placementReady?: boolean | null;
+}
+export interface CaptureTrustReadableTextInput {
+    backTextTrusted?: boolean | null;
+    readableTextTrusted?: boolean | null;
+    weakBackText?: boolean | null;
+    weakReadableText?: boolean | null;
+}
+export interface CaptureTrustCropInput {
+    applied?: boolean | null;
+    provenance?: CaptureTrustCropProvenance | null;
+    unsafe?: boolean | null;
+    unsafeReason?: string | null;
+    clamped?: boolean | null;
+    cutOffRisk?: 'low' | 'medium' | 'high' | string | null;
+    aspectSafe?: boolean | null;
+    cornersOk?: boolean | null;
+    footprintTrusted?: boolean | null;
+    renderedContentOk?: boolean | null;
+    cropVerified?: boolean | null;
+    cropSelectable?: boolean | null;
+}
+export interface CaptureTrustCaptureInput {
+    hasMetrics?: boolean | null;
+    score?: number | null;
+    reviewScoreMin?: number | null;
+    autoScoreMin?: number | null;
+    manualReady?: boolean | null;
+    documentCandidate?: boolean | null;
+    documentLike?: boolean | null;
+    glareDetected?: boolean | null;
+    glareReviewSafe?: boolean | null;
+    tooDark?: boolean | null;
+    tooBright?: boolean | null;
+    tooBlurry?: boolean | null;
+    cutOffHigh?: boolean | null;
+    edgeTight?: boolean | null;
+    unsafeCrop?: boolean | null;
+    unreliableSobelOverfull?: boolean | null;
+    reviewSafe?: boolean | null;
+    autoSafe?: boolean | null;
+}
+export interface CaptureTrustReviewInput {
+    semanticEvidence?: boolean | null;
+    footprintTrusted?: boolean | null;
+    liveEvidenceTrusted?: boolean | null;
+    uncorroboratedGeometry?: boolean | null;
+    wouldPassAllChecks?: boolean | null;
+}
+export interface CaptureTrustPolicyInput {
+    cardFrontSemanticArming?: boolean | null;
+    uncorroboratedGeometryAcceptance?: boolean | null;
+    faceCorroborationStatus?: DocumentFaceCorroborationTrustStatus;
+    faceCorroborationGatedAcceptance?: boolean | null;
+}
+export interface CaptureTrustInput {
+    context?: CaptureTrustContextInput;
+    live?: CaptureTrustLiveInput | null;
+    classifier?: CaptureTrustClassifierInput | null;
+    mrz?: CaptureTrustMrzInput | null;
+    geometry?: CaptureTrustGeometryInput | null;
+    readableText?: CaptureTrustReadableTextInput | null;
+    crop?: CaptureTrustCropInput | null;
+    capture?: CaptureTrustCaptureInput | null;
+    review?: CaptureTrustReviewInput | null;
+    policy?: CaptureTrustPolicyInput | null;
+}
+export interface CaptureTrustDiagnostics {
+    liveAccepted: boolean;
+    liveAcceptedReason: string | null;
+    reliableQuad: boolean;
+    marginSafeReliableQuad: boolean;
+    classifierLikely: boolean;
+    classifierStrategyFloorMet: boolean;
+    classifierHighConfidence: boolean;
+    classifierRescue: boolean;
+    mrzConfirmed: boolean;
+    mrzValidated: boolean;
+    wrongSideMrz: boolean;
+    readableTextTrusted: boolean;
+    backTextTrusted: boolean;
+    semanticArmingCapped: boolean;
+    faceCorroborationCapped: boolean;
+    cropUnsafe: boolean;
+    cropPromotable: boolean;
+    reviewSemanticEvidence: boolean;
+    reviewFootprintTrusted: boolean;
+}
+export interface CaptureTrustDecision {
+    autoAllowed: boolean;
+    manualAllowed: boolean;
+    reviewAllowed: boolean;
+    cropTrustTier: CropTrustTier;
+    reasonCode: CaptureTrustReasonCode;
+    captureGate: CaptureTrustGate;
+    diagnostics: CaptureTrustDiagnostics;
+}
+export declare function decideCaptureTrust(input: CaptureTrustInput): CaptureTrustDecision;
+//# sourceMappingURL=capture-trust.d.ts.map

package/dist/esm/capture-trust.d.ts.map

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

package/dist/esm/capture-trust.js

@@ -0,0 +1,207 @@
+const isTrue = (value) => value === true;
+const hasFiniteScoreAtLeast = (score, floor) => typeof score === 'number' &&
+    Number.isFinite(score) &&
+    typeof floor === 'number' &&
+    Number.isFinite(floor) &&
+    score >= floor;
+function getCropTrustTier(crop) {
+    if (!crop)
+        return 'none';
+    const provenance = String(crop.provenance || '');
+    const unsafe = Boolean(crop.unsafe ||
+        crop.clamped ||
+        crop.unsafeReason ||
+        crop.cutOffRisk === 'high' ||
+        crop.aspectSafe === false ||
+        crop.cornersOk === false ||
+        crop.renderedContentOk === false);
+    if (provenance === 'gallery')
+        return 'gallery';
+    if (provenance === 'unsafe_full_frame')
+        return 'unsafe_full_frame';
+    if (unsafe)
+        return crop.applied ? 'original_frame' : 'unsafe_full_frame';
+    if (!crop.applied)
+        return 'original_frame';
+    const selectable = crop.cropSelectable !== false;
+    const verified = crop.cropVerified !== false;
+    const footprintTrusted = crop.footprintTrusted !== false;
+    const promotable = selectable && verified && footprintTrusted;
+    if (!promotable)
+        return 'original_frame';
+    if (provenance === 'native_platform_scanner')
+        return 'native_platform_crop';
+    if (provenance === 'still_redetect')
+        return 'verified_crop';
+    if (provenance === 'review_auto_crop')
+        return 'review_auto_crop';
+    if (provenance === 'same_candidate' || provenance === 'viewfinder_candidate') {
+        return 'live_candidate';
+    }
+    return 'verified_crop';
+}
+function getDiagnostics(input, cropTrustTier) {
+    const classifier = input.classifier;
+    const mrz = input.mrz;
+    const geometry = input.geometry;
+    const readableText = input.readableText;
+    const policy = input.policy;
+    const review = input.review;
+    const live = input.live;
+    const semanticArmingCapped = Boolean(policy?.cardFrontSemanticArming && policy.uncorroboratedGeometryAcceptance);
+    const faceCorroborationCapped = Boolean(policy?.faceCorroborationStatus === 'no_face' && policy.faceCorroborationGatedAcceptance);
+    return {
+        liveAccepted: isTrue(live?.accepted),
+        liveAcceptedReason: live?.acceptedReason ?? null,
+        reliableQuad: isTrue(geometry?.reliableQuad),
+        marginSafeReliableQuad: isTrue(geometry?.marginSafeReliableQuad),
+        classifierLikely: isTrue(classifier?.likely),
+        classifierStrategyFloorMet: isTrue(classifier?.strategyFloorMet),
+        classifierHighConfidence: isTrue(classifier?.highConfidence),
+        classifierRescue: isTrue(classifier?.rescue),
+        mrzConfirmed: isTrue(mrz?.confirmed),
+        mrzValidated: isTrue(mrz?.validated),
+        wrongSideMrz: isTrue(mrz?.wrongSide),
+        readableTextTrusted: isTrue(readableText?.readableTextTrusted),
+        backTextTrusted: isTrue(readableText?.backTextTrusted),
+        semanticArmingCapped,
+        faceCorroborationCapped,
+        cropUnsafe: cropTrustTier === 'unsafe_full_frame' ||
+            Boolean(input.crop?.unsafe || input.crop?.clamped || input.crop?.unsafeReason),
+        cropPromotable: cropTrustTier === 'live_candidate' ||
+            cropTrustTier === 'verified_crop' ||
+            cropTrustTier === 'review_auto_crop' ||
+            cropTrustTier === 'native_platform_crop',
+        reviewSemanticEvidence: isTrue(review?.semanticEvidence),
+        reviewFootprintTrusted: isTrue(review?.footprintTrusted),
+    };
+}
+function decideReviewTrust(input, diagnostics, cropTrustTier) {
+    const review = input.review;
+    const reviewAllowed = Boolean(review?.wouldPassAllChecks &&
+        (review.liveEvidenceTrusted ||
+            (review.semanticEvidence && review.footprintTrusted) ||
+            diagnostics.cropPromotable) &&
+        !review.uncorroboratedGeometry);
+    return {
+        autoAllowed: false,
+        manualAllowed: true,
+        reviewAllowed,
+        cropTrustTier,
+        reasonCode: reviewAllowed ? 'review_trusted' : 'review_untrusted',
+        captureGate: reviewAllowed ? 'review_candidate' : 'soft_block',
+        diagnostics,
+    };
+}
+export function decideCaptureTrust(input) {
+    const cropTrustTier = getCropTrustTier(input.crop);
+    const diagnostics = getDiagnostics(input, cropTrustTier);
+    if (input.context?.phase === 'review') {
+        return decideReviewTrust(input, diagnostics, cropTrustTier);
+    }
+    const capture = input.capture;
+    const readableText = input.readableText;
+    const hasMetrics = capture?.hasMetrics !== false;
+    const hardBlock = (reasonCode, gate = 'hard_block') => ({
+        autoAllowed: false,
+        manualAllowed: false,
+        reviewAllowed: false,
+        cropTrustTier,
+        reasonCode,
+        captureGate: gate,
+        diagnostics,
+    });
+    if (!hasMetrics)
+        return hardBlock('missing_metrics');
+    if (capture?.tooDark)
+        return hardBlock('too_dark');
+    if (capture?.tooBright)
+        return hardBlock('too_bright');
+    if (capture?.tooBlurry)
+        return hardBlock('too_blurry');
+    if (input.mrz?.wrongSide)
+        return hardBlock('wrong_side');
+    if (!capture?.documentCandidate) {
+        return hardBlock('not_document_like', 'soft_block');
+    }
+    if (capture?.glareDetected) {
+        const reviewAllowed = Boolean(capture.glareReviewSafe);
+        return {
+            autoAllowed: false,
+            manualAllowed: reviewAllowed,
+            reviewAllowed,
+            cropTrustTier,
+            reasonCode: 'glare',
+            captureGate: reviewAllowed ? 'review_candidate' : 'soft_block',
+            diagnostics,
+        };
+    }
+    if (capture?.cutOffHigh)
+        return hardBlock('cutoff_high');
+    if (capture?.edgeTight || capture?.unreliableSobelOverfull || capture?.unsafeCrop) {
+        return hardBlock(capture.edgeTight || capture.unreliableSobelOverfull ? 'edge_tight' : 'unsafe_crop', 'soft_block');
+    }
+    const weakBackText = isTrue(readableText?.weakBackText);
+    const weakReadableText = isTrue(readableText?.weakReadableText);
+    const reviewAllowed = capture?.reviewSafe ??
+        (hasFiniteScoreAtLeast(capture?.score, capture?.reviewScoreMin) &&
+            !capture?.edgeTight &&
+            !capture?.unreliableSobelOverfull &&
+            !capture?.unsafeCrop);
+    const baseAutoAllowed = capture?.autoSafe ??
+        Boolean(reviewAllowed && hasFiniteScoreAtLeast(capture?.score, capture?.autoScoreMin));
+    if (baseAutoAllowed && (diagnostics.semanticArmingCapped || diagnostics.faceCorroborationCapped)) {
+        return {
+            autoAllowed: false,
+            manualAllowed: true,
+            reviewAllowed: true,
+            cropTrustTier,
+            reasonCode: diagnostics.semanticArmingCapped ? 'manual_ready' : 'face_unconfirmed',
+            captureGate: 'manual_ready',
+            diagnostics,
+        };
+    }
+    if (baseAutoAllowed) {
+        return {
+            autoAllowed: true,
+            manualAllowed: true,
+            reviewAllowed: true,
+            cropTrustTier,
+            reasonCode: 'auto_safe',
+            captureGate: 'auto_ready',
+            diagnostics,
+        };
+    }
+    if (reviewAllowed) {
+        const reasonCode = weakBackText
+            ? 'weak_back_text'
+            : weakReadableText
+                ? 'weak_readable_text'
+                : capture?.manualReady
+                    ? 'manual_ready'
+                    : 'review_safe';
+        return {
+            autoAllowed: false,
+            manualAllowed: Boolean(capture?.manualReady),
+            reviewAllowed: true,
+            cropTrustTier,
+            reasonCode,
+            captureGate: capture?.manualReady ? 'manual_ready' : 'review_candidate',
+            diagnostics,
+        };
+    }
+    return {
+        autoAllowed: false,
+        manualAllowed: false,
+        reviewAllowed: false,
+        cropTrustTier,
+        reasonCode: weakBackText
+            ? 'weak_back_text'
+            : weakReadableText
+                ? 'weak_readable_text'
+                : 'not_document_like',
+        captureGate: 'soft_block',
+        diagnostics,
+    };
+}
+//# sourceMappingURL=capture-trust.js.map

package/dist/esm/capture-trust.js.map

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

package/dist/esm/index.d.ts

@@ -8,7 +8,7 @@
  * objects, numeric values). Zero browser dependencies.
  */
 export type { CamStateValue, FrameMetrics, CaptureAreaRange, CaptureGeometryProfile, DocumentReviewProfile, DocumentLikelihoodResult, CropRect, DocumentCropResult, OverlayRegion, OverlayVariant, QualityCheckResults, FaceBoundingBox, DetectedFace, MetadataReviewIssue, MetadataReviewResult, ReviewOrientation, ReviewMode, QualityBucket, ReviewDecisionOptions, } from './types.js';
-export { CamState, CAM_ANALYSIS_W, CAM_ANALYSIS_H, CAM_BRIGHTNESS_MIN, CAM_BRIGHTNESS_MAX, CAM_BLUR_THRESHOLD, CAM_EDGE_THRESHOLD, CAM_STABLE_FRAMES_NEEDED, CAM_FRAME_DIFF_THRESHOLD, CAM_EDGE_PIXEL_THRESHOLD, CAM_EDGE_COVERAGE_THRESHOLD, CAM_DOC_CENTER_OFFSET_MAX, CAPTURE_DOCUMENT_SHARPNESS_MIN, CAPTURE_DOCUMENT_MANUAL_FALLBACK_SECS, CAPTURE_DOCUMENT_AREA_MIN, CAPTURE_DOCUMENT_EDGE_READY_MULTIPLIER, DOC_GALLERY_FAILURE_THRESHOLD, DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD, SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD, ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD, PICO_ANALYSIS_W, PICO_ANALYSIS_H, } from './types.js';
+export { CamState, CAM_ANALYSIS_W, CAM_ANALYSIS_H, CAM_BRIGHTNESS_MIN, SCENE_DARK_SURROUND_LUMA_MAX, SCENE_DARK_REGION_DYNAMIC_RANGE_MAX, CAM_BRIGHTNESS_MAX, CAM_BLUR_THRESHOLD, CAM_EDGE_THRESHOLD, CAM_STABLE_FRAMES_NEEDED, CAM_FRAME_DIFF_THRESHOLD, CAM_EDGE_PIXEL_THRESHOLD, CAM_EDGE_COVERAGE_THRESHOLD, CAM_DOC_CENTER_OFFSET_MAX, CAPTURE_DOCUMENT_SHARPNESS_MIN, CAPTURE_DOCUMENT_MANUAL_FALLBACK_SECS, CAPTURE_DOCUMENT_AREA_MIN, CAPTURE_DOCUMENT_EDGE_READY_MULTIPLIER, DOC_GALLERY_FAILURE_THRESHOLD, DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD, SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD, ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD, PICO_ANALYSIS_W, PICO_ANALYSIS_H, } from './types.js';
 export type { AddressMethod, AddressProofMode, AddressCoordinatesLike, AddressStepState, AddressMethodStartBehavior, } from './address-proof.js';
 export { ADDRESS_METHOD_ORDER, isAddressMethod, sanitizeAllowedAddressMethods, getRecommendedAddressMethod, getAddressMethodStartBehavior, getEffectiveAddressMethod, hasAddressProofCoordinates, hasStructuredAddress, isAddressStepComplete, } from './address-proof.js';
 export type { KycMobileContractIssue, KycMobileContractIssueCode, KycMobileWorkflowConfigContract, } from './kyc-mobile-contract.js';
@@ -22,20 +22,24 @@ export type { MetadataReviewInput } from './metadata-review.js';
 export { analyzeImageMetadata } from './metadata-review.js';
 export type { CaptureImageSize, CapturePreviewRect, CaptureCropRect, CapturePreviewResizeMode, CaptureRotationDegrees, CaptureNormalizationUnsafeReason, CaptureClampedEdges, CaptureNormalizationDiagnostics, CaptureFrameMode, PreviewRectToImageCropInput, ExpectedOrientationInput, CaptureNormalizationPlanInput, CaptureResizePlan, CaptureNormalizationPlan, } from './capture-normalization.js';
 export { mapPreviewRectToImageCropWithDiagnostics, mapPreviewRectToImageCrop, getRotationToExpectedOrientation, buildCaptureNormalizationPlan, getDocumentCaptureFrameAspectRatio, } from './capture-normalization.js';
+export type { CaptureTrustClient, CaptureTrustPhase, CaptureTrustCaptureSource, CaptureTrustDocumentSide, CaptureTrustCropProvenance, CaptureTrustReasonCode, CaptureTrustGate, CropTrustTier, DocumentFaceCorroborationTrustStatus, CaptureTrustContextInput, CaptureTrustLiveInput, CaptureTrustClassifierInput, CaptureTrustMrzInput, CaptureTrustGeometryInput, CaptureTrustReadableTextInput, CaptureTrustCropInput, CaptureTrustCaptureInput, CaptureTrustReviewInput, CaptureTrustPolicyInput, CaptureTrustInput, CaptureTrustDiagnostics, CaptureTrustDecision, } from './capture-trust.js';
+export { decideCaptureTrust } from './capture-trust.js';
 export type { CapturePlacementShape, DocumentPlacementInput, DocumentPlacementDecision, DocumentPlacementReason, } from './document-placement.js';
 export { CAPTURE_READY_AREA_MIN_BY_SHAPE, RELAXED_CAPTURE_READY_AREA_MIN_BY_SHAPE, CAPTURE_READY_AREA_MAX_BY_SHAPE, CAPTURE_READY_CENTER_MAX_BY_SHAPE, CAPTURE_READY_SAFE_INSET_MIN, evaluateDocumentPlacement, } from './document-placement.js';
 export type { EdgeEnergyProfile } from './sobel.js';
 export { rgbaToGreyscale, rgbaToGreyscalePico, computeEdgeEnergyProfile, detectDocumentCropFromGrey, } from './sobel.js';
-export type { EdgeAnalysisResult } from './metrics.js';
-export { rgbaToGreyInPlace, computeBrightness, computeLaplacianVariance, computeLaplacianVarianceFloat, computeEdgeEnergy, detectDocumentRect, computeFrameDiff, analyzeFrame, looksLikeDocument, } from './metrics.js';
+export type { EdgeAnalysisResult, SceneLightProfile } from './metrics.js';
+export { rgbaToGreyInPlace, computeBrightness, computeSceneLightProfile, isSceneDark, computeLaplacianVariance, computeLaplacianVarianceFloat, computeEdgeEnergy, detectDocumentRect, computeFrameDiff, analyzeFrame, looksLikeDocument, } from './metrics.js';
 export type { MrzBandDetectionInput, MrzBandDetectionResult, MrzBandBoundingBox, } from './mrz-band-detector.js';
 export { detectPassportMrzBand, MRZ_HORIZONTAL_GRADIENT_THRESHOLD, MRZ_ROW_DENSITY_RATIO_THRESHOLD, MRZ_MIN_BAND_HEIGHT, MRZ_MAX_BAND_HEIGHT, MRZ_MIN_BAND_WIDTH_FRAC, MRZ_MIN_BAND_ASPECT, MRZ_MAX_BAND_ASPECT, MRZ_SEARCH_TOP_FRAC, MRZ_DENSITY_SCORE_SATURATION, } from './mrz-band-detector.js';
 export type { MrzDocumentFormat, MrzCheckDigitField, MrzCheckDigitResult, MrzValidationResult, MrzAutocorrection, MrzParsedFields, MrzParserDetail, MrzParseOptions, MrzParseResult, } from './mrz-check-digits.js';
 export { getMrzCharacterValue, computeMrzCheckDigit, normalizeMrzLines, parseMrzText, validateMrzCheckDigits, } from './mrz-check-digits.js';
+export type { MrzFormat, MrzRejectionReason, MrzFields, MrzCheckDigits, MrzParseAccepted, MrzParseRejected, MrzParseResult as Icao9303MrzParseResult, } from './mrz-parser.js';
+export { MRZ_TD3_LINE_LENGTH, MRZ_TD1_LINE_LENGTH, parseMrzLines } from './mrz-parser.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_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, WRONG_SIDE_TURN_OVER_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';

package/dist/esm/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/esm/index.js

@@ -7,7 +7,7 @@
  * All exports operate on raw data (Uint8Array pixel arrays, FrameMetrics
  * objects, numeric values). Zero browser dependencies.
  */
-export { CamState, CAM_ANALYSIS_W, CAM_ANALYSIS_H, CAM_BRIGHTNESS_MIN, CAM_BRIGHTNESS_MAX, CAM_BLUR_THRESHOLD, CAM_EDGE_THRESHOLD, CAM_STABLE_FRAMES_NEEDED, CAM_FRAME_DIFF_THRESHOLD, CAM_EDGE_PIXEL_THRESHOLD, CAM_EDGE_COVERAGE_THRESHOLD, CAM_DOC_CENTER_OFFSET_MAX, CAPTURE_DOCUMENT_SHARPNESS_MIN, CAPTURE_DOCUMENT_MANUAL_FALLBACK_SECS, CAPTURE_DOCUMENT_AREA_MIN, CAPTURE_DOCUMENT_EDGE_READY_MULTIPLIER, DOC_GALLERY_FAILURE_THRESHOLD, DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD, SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD, ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD, PICO_ANALYSIS_W, PICO_ANALYSIS_H, } from './types.js';
+export { CamState, CAM_ANALYSIS_W, CAM_ANALYSIS_H, CAM_BRIGHTNESS_MIN, SCENE_DARK_SURROUND_LUMA_MAX, SCENE_DARK_REGION_DYNAMIC_RANGE_MAX, CAM_BRIGHTNESS_MAX, CAM_BLUR_THRESHOLD, CAM_EDGE_THRESHOLD, CAM_STABLE_FRAMES_NEEDED, CAM_FRAME_DIFF_THRESHOLD, CAM_EDGE_PIXEL_THRESHOLD, CAM_EDGE_COVERAGE_THRESHOLD, CAM_DOC_CENTER_OFFSET_MAX, CAPTURE_DOCUMENT_SHARPNESS_MIN, CAPTURE_DOCUMENT_MANUAL_FALLBACK_SECS, CAPTURE_DOCUMENT_AREA_MIN, CAPTURE_DOCUMENT_EDGE_READY_MULTIPLIER, DOC_GALLERY_FAILURE_THRESHOLD, DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD, SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD, ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD, PICO_ANALYSIS_W, PICO_ANALYSIS_H, } from './types.js';
 export { ADDRESS_METHOD_ORDER, isAddressMethod, sanitizeAllowedAddressMethods, getRecommendedAddressMethod, getAddressMethodStartBehavior, getEffectiveAddressMethod, hasAddressProofCoordinates, hasStructuredAddress, isAddressStepComplete, } from './address-proof.js';
 export { KYC_MOBILE_ADDRESS_STEP_IDS, KYC_MOBILE_KNOWN_STEP_IDS, KYC_MOBILE_REQUIRED_TERMINAL_STEP_IDS, KYC_MOBILE_SIERRA_LEONE_STEP_ORDER, KYC_MOBILE_VALID_ADDRESS_METHODS, KYC_MOBILE_VALID_ADDRESS_FIELD_MODES, KYC_MOBILE_VALID_CAPTURE_MODES, KYC_MOBILE_VALID_GPS_POLICIES, KYC_MOBILE_VALID_SUBMISSION_COMPLETION_MODES, validateKycMobileWorkflowConfigContract, } from './kyc-mobile-contract.js';
 export { getIssuingCountryMetadata, normalizeIssuingCountry, resolveIssuingCountry, } from './issuing-country.js';
@@ -16,13 +16,15 @@ export { getNextFlowStepId, getPreviousFlowStepId } from './flow-routing.js';
 export { getDocumentCaptureGeometryProfile, getDocumentReviewProfile, checkDocumentLikelihood, } from './document-classifier.js';
 export { analyzeImageMetadata } from './metadata-review.js';
 export { mapPreviewRectToImageCropWithDiagnostics, mapPreviewRectToImageCrop, getRotationToExpectedOrientation, buildCaptureNormalizationPlan, getDocumentCaptureFrameAspectRatio, } from './capture-normalization.js';
+export { decideCaptureTrust } from './capture-trust.js';
 export { CAPTURE_READY_AREA_MIN_BY_SHAPE, RELAXED_CAPTURE_READY_AREA_MIN_BY_SHAPE, CAPTURE_READY_AREA_MAX_BY_SHAPE, CAPTURE_READY_CENTER_MAX_BY_SHAPE, CAPTURE_READY_SAFE_INSET_MIN, evaluateDocumentPlacement, } from './document-placement.js';
 export { rgbaToGreyscale, rgbaToGreyscalePico, computeEdgeEnergyProfile, detectDocumentCropFromGrey, } from './sobel.js';
-export { rgbaToGreyInPlace, computeBrightness, computeLaplacianVariance, computeLaplacianVarianceFloat, computeEdgeEnergy, detectDocumentRect, computeFrameDiff, analyzeFrame, looksLikeDocument, } from './metrics.js';
+export { rgbaToGreyInPlace, computeBrightness, computeSceneLightProfile, isSceneDark, computeLaplacianVariance, computeLaplacianVarianceFloat, computeEdgeEnergy, detectDocumentRect, computeFrameDiff, analyzeFrame, looksLikeDocument, } from './metrics.js';
 export { detectPassportMrzBand, MRZ_HORIZONTAL_GRADIENT_THRESHOLD, MRZ_ROW_DENSITY_RATIO_THRESHOLD, MRZ_MIN_BAND_HEIGHT, MRZ_MAX_BAND_HEIGHT, MRZ_MIN_BAND_WIDTH_FRAC, MRZ_MIN_BAND_ASPECT, MRZ_MAX_BAND_ASPECT, MRZ_SEARCH_TOP_FRAC, MRZ_DENSITY_SCORE_SATURATION, } from './mrz-band-detector.js';
 export { getMrzCharacterValue, computeMrzCheckDigit, normalizeMrzLines, parseMrzText, validateMrzCheckDigits, } from './mrz-check-digits.js';
+export { MRZ_TD3_LINE_LENGTH, MRZ_TD1_LINE_LENGTH, parseMrzLines } from './mrz-parser.js';
 export { resolveDocumentMrzPolicy } from './mrz-policy.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_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, WRONG_SIDE_TURN_OVER_FEEDBACK, getDocumentSubjectLabel, getTiltAwayFromLightGuidance, getMoveToMiddleFeedback, } from './capture-guidance.js';
 /* -- Version beacon -------------------------------------------------------- */
 export { CAPTURE_INTELLIGENCE_CORE_VERSION } from './version.js';
 export { getQualityBucket, getSubmitAnywayThreshold, createQualityFailureState, countFailedReview, shouldShowSubmitAnyway, hasHardBlockingQualityFailure, isRetryEscapableDocumentCornerFailure, getReviewModeFromDocumentType, runDocumentQualityChecks, runSelfieQualityChecks, checkFaceInImage, isFaceCentered, evaluateDocumentFailure, evaluateSelfieFailure, evaluateReviewFailure, getNextButtonDisabledReason, getOverrideButtonText, getOverrideBannerMessage, } from './quality-checks.js';