@sekyro/web 0.1.0-rc.7 → 0.1.0-rc.8

package/dist/internal/index.d.cts

@@ -1,134 +1,30 @@
-import { p as DeviceClass, i as CaptureState, b as CaptureArtifacts, c as CaptureErrorKind } from '../capture-session-v3-UQU_WjO2.cjs';
+import { aR as DocCatalogEntry, aS as LiveMrzTuning, aT as TextLockTuning, aU as OcrEngineClient, aV as DocAssistReport, aW as ReadyInfo, aX as LoadFailure, aY as OcrEngineOptions, aZ as SubmitRuntime, Z as LivenessCaptureOptions, Y as LivenessCaptureHandle, aD as VerificationStep, aB as VerificationResult, as as StepSnapshot, U as LivePhotoGateUpdate, a_ as HostedClientLike } from '../create-verification-DoFpgzok.cjs';
+export { a$ as ANALYSIS_LONG_EDGE, b0 as ASPECT_BANDS, b1 as AttestationError, b2 as BLUR_REFUSE_SHARPNESS_MAX, b3 as BlurStatus, b4 as CAPTURE_CANDIDATE_SPACING_MS, b5 as CAPTURE_EXTRA_CANDIDATES, b6 as CLIP_MIME_ALLOWLIST, b7 as CaptureEngine, b8 as CaptureSessionDoc, b9 as CaptureSessionDocEvents, ba as CaptureSessionDocOptions, bb as DOC_ANALYSIS_DEFAULTS, bc as DOC_CADENCE_HZ, bd as DOC_CAMERA_TUNING_DEFAULTS, be as DOC_CATALOG, bf as DOC_DETECT_WIDTH, bg as DOC_FEEDBACK_STATES, bh as DOC_GATE_V1_DEFAULTS, bi as DOC_SHUTTER_DEFAULTS, bj as DeviceReadHint, bk as DocArtifacts, bl as DocAssist, bm as DocAssistEngine, bn as DocAssistTick, bo as DocCameraTuning, bp as DocCaptureReport, bq as DocCaptureVia, br as DocChecksPayload, bs as DocEngineLike, bt as DocFeedbackAggregator, bu as DocFeedbackKey, bv as DocFeedbackState, bw as DocFormat, bx as DocFrameAnalysis, by as DocFrameMeasures, bz as DocGateQuality, bA as DocGateThresholds, bB as DocGateTick, bC as DocGateTickInput, bD as DocGateV1, bE as DocQuad, bF as DocQuadPoint, bG as DocShutterReason, bH as DocShutterTuning, bI as DocSide, bJ as DocumentCaptureController, bK as DocumentCaptureInternals, bL as EMPTY_GUIDE_METRICS, bM as EncodedDocument, bN as FLIP_FILL_MIN, bO as FLIP_GAP_MS, bP as FLIP_TIMEOUT_MS, bQ as FocusCaps, bR as FramingStatus, bS as GUIDE_LOCK_DEFAULTS, bT as GlareStatus, bU as GrabbedFrame, bV as GuideBlocker, bW as GuideLock, bX as GuideLockTick, bY as GuideLockTuning, bZ as GuideMetrics, b_ as GuideRect, b$ as INFERENCE_RETRY_ATTEMPTS, c0 as INFERENCE_RETRY_DEFAULT_S, R as ISSUER_CODES, c1 as LANDMARKER_MODEL, c2 as LENS_STORAGE_KEY, c3 as LENS_TRY_MAX, c4 as LIVE_MRZ_DEFAULTS, c5 as LIVE_PHOTO_IDLE_MS, c6 as LIVE_PHOTO_MAX_HZ, c7 as LandmarkedFace, c8 as LandmarkerLike, c9 as LensKind, ca as LensSource, cb as LightingStatus, cc as LiveMrzCapture, cd as LiveMrzState, ce as LivePhotoGate, cf as LivePhotoKit, cg as LivePhotoKitInternals, ch as LivePhotoKitOptions, ci as LivePhotoStill, cj as LivenessCaptureInternalHandle, ck as LivenessCaptureInternals, cl as LivenessFlowDeps, cm as LivenessFlowOutcome, cn as MANUAL_SHUTTER_MS, co as MR_DOC_CATALOG, cp as NO_REPORT_MS, cq as OpenDocCameraDeps, cr as PORTRAIT_JPEG_QUALITY, cs as PRELOAD_BLAZE_INIT_TIMEOUT_MS, ct as PRELOAD_BUDGET_MS, cu as PROCESSING_POLL_DELAY_MS, cv as PROCESSING_POLL_MAX, cw as PortraitCaptureController, cx as PortraitCaptureInternals, cy as REGISTRY_RETRY_DELAY_MS, cz as ReticleType, cA as SAME_FACE_MAX_DROPS, cB as ScanEvent, cC as ScanLayout, cD as ScanNotice, cE as ScanPhase, cF as ScanReport, cG as ScanSide, cH as ScanState, cI as SubmitExecutor, cJ as TEXT_LOCK_DEFAULTS, cK as TRANSPORT_REPLAY_ATTEMPTS, cL as TRANSPORT_REPLAY_DELAY_MS, cM as VerificationInternals, cN as analyzeDocFrame, cO as analyzeGuide, cP as aspectBand, cQ as aspectFits, cR as buildDeviceReadHint, cS as coverPointToVideo, cT as createDocumentCaptureInternal, cU as createFaceLandmarker, cV as createLivePhotoKit, cW as createLivenessCaptureInternal, cX as createPortraitCaptureInternal, cY as createVerificationInternal, cZ as docZoomFor, c_ as encodeDocumentImage, c$ as facesOf, d0 as feedbackVoteOf, d1 as focusOk, d2 as guideQuad, d3 as guideRegionInFrame, d4 as initialScanState, d5 as lensKindOf, d6 as mapEngineState, d7 as mapErrorKind, d8 as mapGuidanceHint, d9 as nextScanState, da as observePortraitFrame, db as openDocCamera, dc as passportBandOf, dd as portraitMatchStep, de as preloadedDetectorFactory, df as quadAreaFrac, dg as quadBounds, dh as quadIou, di as quadTiltRatio, dj as randomUuid, dk as rankBackCameras, dl as readStoredLens, dm as resetLivenessAssetsForTests, dn as resolveDocCameraTuning, dp as resolveDocShutterTuning, dq as resolveGuideLockTuning, dr as runLivenessFlow, ds as runSubmission, dt as scannerFormatFor, du as setPreloadLoaderForTests, dv as settledHint, dw as singleShotFocusAt, dx as specularFraction, dy as supportsFocusMode, dz as warmDocDetector, dA as writeStoredLens } from '../create-verification-DoFpgzok.cjs';
 export { C as CENTERED_FACTOR, a as CIRCLE_RADIUS_FACTOR, I as IN_CIRCLE_FACTOR, d as detectIsMobile } from '../capture-constraints-BujkZcfb.cjs';
-import { p as VerificationResult } from '../create-verification-C2JhOO6Y.cjs';
-export { A as AttestationError, x as CLIP_MIME_ALLOWLIST, y as CaptureEngine, H as HostedClientLike, I as INFERENCE_RETRY_ATTEMPTS, z as INFERENCE_RETRY_DEFAULT_S, B as LivenessCaptureInternalHandle, E as LivenessCaptureInternals, F as LivenessFlowDeps, J as LivenessFlowOutcome, K as PRELOAD_BLAZE_INIT_TIMEOUT_MS, M as PRELOAD_BUDGET_MS, N as PROCESSING_POLL_DELAY_MS, O as PROCESSING_POLL_MAX, Q as REGISTRY_RETRY_DELAY_MS, T as SubmitExecutor, U as SubmitRuntime, W as TRANSPORT_REPLAY_ATTEMPTS, X as TRANSPORT_REPLAY_DELAY_MS, Y as VerificationInternals, Z as createLivenessCaptureInternal, _ as createVerificationInternal, $ as mapEngineState, a0 as mapErrorKind, a1 as mapGuidanceHint, a2 as preloadedDetectorFactory, a3 as randomUuid, a4 as resetLivenessAssetsForTests, a5 as runLivenessFlow, a6 as runSubmission, a7 as setPreloadLoaderForTests } from '../create-verification-C2JhOO6Y.cjs';
-import { C as CheckReason, f as HostedSessionView, g as HostedStepView, q as SessionView, b as CheckType } from '../hosted-client-kBeq-mnJ.cjs';
-import '../detect-worker-CKXHlXx9.cjs';
+import { w as HostedSessionView, P as IdentityMethod, b as CheckType, a6 as SessionView, C as CheckReason, x as HostedStepView } from '../icao-gate-D8qm1O2t.cjs';
+export { a7 as BackgroundStats, a8 as Box, a9 as CLIPPED_LUMA, aa as FaceGeometry, ab as FaceLighting, H as HeadPose, ac as ICAO_CANVAS, ad as ICAO_FALLBACK, ae as ICAO_GATE_CRITERIA, af as ICAO_SHARP_REF, I as IcaoCaptureTuning, B as IcaoCoachKey, J as IcaoCriterionState, ag as IcaoFrameObservation, ah as IcaoGate, K as IcaoGateCriterion, ai as IcaoGateOptions, L as IcaoGateSummary, M as IcaoGateUpdate, aj as IcaoJudgedCriterion, ak as IcaoMeasures, al as IcaoPixelStats, am as IcaoProfile, an as LumaPlane, ao as Point, ap as RegionStats, aq as ResolvedIcaoTuning, ar as backgroundStats, as as createIcaoGate, at as eyeLineRoll, au as eyeOpenness, av as eyeSpecular, aw as faceGeometry, ax as faceLighting, ay as faceSharpness, az as icaoPixelStats, aA as icaoWindow, aB as judgeIcao, aC as lumaPlane, aD as percentile, aE as portraitCropRegion, aF as poseFromMatrix, aG as regionStats, aH as resolveIcaoTuning, aI as scoreFrame, aJ as windowOverflow } from '../icao-gate-D8qm1O2t.cjs';
+import '../detect-worker-DclNxkZT.cjs';
+import '../capture-session-v3-Dvob-uH2.cjs';
 
-/** Physical geometry the scanner frames (ISO/IEC 7810 / ICAO 9303). */
-type DocFormat = "ID-1" | "ID-3";
-type DocSide = "recto" | "verso" | "single";
-interface DocCatalogEntry {
-    /** kyc-docs-v2 `document_type`, verbatim. */
-    docType: "carte_identite" | "passport";
-    format: DocFormat;
-    /** Capture sequence the hosted doc step walks, in order. */
-    sides: readonly DocSide[];
-    /** MRZ geometry: td1 = 3×30 (ID-1 verso), td3 = 2×44 (passport data page). */
-    mrz: "none" | "td1" | "td3";
-    /** Which side carries the holder photo (drives portrait expectations). */
-    portraitSide: DocSide;
-    /** Physical width/height ratio of the framed page. */
-    aspectRatio: number;
-    /** Where the subject identifier (NNI) is parsed from, when the doc carries one. */
-    identifierSource?: "mrz";
-}
-/**
- * Plausibility aspect bands per format (Task 34 gate input): ID-1 cards are
- * 85.6×53.98mm → 1.586; an ID-3 passport DATA PAGE frames at ≈125×88mm → 1.42
- * (wider tolerance — page curl and hinge shadow skew the detected quad).
- */
-declare const ASPECT_BANDS: Record<DocFormat, {
-    center: number;
-    tolerance: number;
-}>;
-/** Aspect band for a format — helper the DocGateV1 plausibility check calls. */
-declare function aspectBand(format: DocFormat): {
-    center: number;
-    tolerance: number;
-};
-/** The MR docTypes facet (findings §4). Order = the hosted picker's display order. */
-declare const MR_DOC_CATALOG: readonly DocCatalogEntry[];
-
-/** Detect-frame width the session downscales to (findings §1: 25ms median).
- *  Lives HERE (not detector-scanic.ts) so the session can import it without
- *  statically pulling the scanic chunk into host bundles. */
-declare const DOC_DETECT_WIDTH = 480;
-interface DocQuadPoint {
-    x: number;
-    y: number;
-}
-/** Detected document quad, image-space pixels (scanic CornerPoints shape). */
-interface DocQuad {
-    topLeft: DocQuadPoint;
-    topRight: DocQuadPoint;
-    bottomRight: DocQuadPoint;
-    bottomLeft: DocQuadPoint;
-}
-interface DocGateThresholds {
-    /** Quad area / frame area below which the doc is too far. */
-    MIN_AREA_FRAC: number;
-    /** A corner this close to (or past) a frame edge counts as clipped. */
-    EDGE_CLIP_MARGIN_PX: number;
-    /** Consecutive stable plausible+quality ticks required to fire. */
-    STABLE_TICKS: number;
-    /** Quad-bbox IoU with the previous tick at/above which the streak holds. */
-    IOU_STABLE_MIN: number;
-    /** Integrator slopes, per second — mirrors FaceGateV3's gentle drain. */
-    RISE_PER_S: number;
-    FALL_PER_S: number;
-    /** Quality guidance trigger levels (same semantics as the face gate). */
-    GUIDE_EXPOSURE: number;
-    GUIDE_SHARPNESS: number;
-    /** ID-3 (MRZ-band mode): band width / frame width floor. */
-    ID3_BAND_MIN_WIDTH_FRAC: number;
-    /** ID-3 (MRZ-band mode): band aspect (w/h) sanity bounds. */
-    ID3_BAND_ASPECT_MIN: number;
-    ID3_BAND_ASPECT_MAX: number;
-}
-/** Frozen defaults (plan Task 34 — do not retune without a golden update). */
-declare const DOC_GATE_V1_DEFAULTS: Readonly<DocGateThresholds>;
-interface DocGateQuality {
-    /** frame-quality.sharpness on the quad crop. */
-    sharpness: number;
-    /** frame-quality.exposure on the quad crop. */
-    exposure: number;
-    /** Mean crop luma — picks more_light vs too_bright. */
-    meanLuma: number;
-}
-interface DocGateTickInput {
-    timestampMs: number;
-    quad: DocQuad | null;
-    quality: DocGateQuality;
-    frameWidth: number;
-    frameHeight: number;
-}
-/** Per-tick output — the scanner chrome contract. */
-interface DocGateTick {
-    at: number;
-    quad: DocQuad | null;
-    /** Geometry passed: present × big enough × in frame × right shape. */
-    plausible: boolean;
-    /** Integrated progress 0..1 (the overlay ring). */
-    p: number;
-    /** dcv1.* message key (host translates; never prose). */
-    guidanceKey: string;
-    /** Fire signal: plausible × quality × STABLE_TICKS consecutive high-IoU ticks. */
-    ready: boolean;
-    /** Current stability streak length (diagnostics/telemetry). */
-    stableTicks: number;
-}
-/** Shoelace area of the quad as a fraction of the frame area. */
-declare function quadAreaFrac(quad: DocQuad, frameWidth: number, frameHeight: number): number;
-/** IoU of the two quads' axis-aligned bounding boxes (stability metric). */
-declare function quadIou(a: DocQuad, b: DocQuad): number;
-/** Axis-aligned bounds (width/height) of a quad — the ID-3 band-mode geometry. */
-declare function quadBounds(quad: DocQuad): {
-    width: number;
-    height: number;
-};
-declare class DocGateV1 {
-    private readonly t;
-    private readonly format;
-    private p;
-    private lastTickAt;
-    private lastQuad;
-    private streak;
-    constructor(format: DocFormat, overrides?: Partial<DocGateThresholds>);
-    reset(): void;
-    tick(input: DocGateTickInput): DocGateTick;
-    private edgeClipped;
+type DocumentTypeId = DocCatalogEntry["docType"];
+/** Same shape as the hosted view's `acceptedDocuments`. */
+interface AcceptedDocumentsLike {
+    default: "*" | readonly DocumentTypeId[];
+    byIssuer?: Readonly<Record<string, readonly DocumentTypeId[]>>;
 }
+/** Picker order. */
+declare const DOCUMENT_TYPE_ORDER: readonly DocumentTypeId[];
+/** Types accepted for documents of `issuer` (ISO alpha-2), in picker order. */
+declare function acceptedTypesFor(accepted: AcceptedDocumentsLike, issuer: string): DocumentTypeId[];
+/** Issuers with at least one accepted type, sorted by code (the UI re-sorts by name). */
+declare function acceptedIssuers(accepted: AcceptedDocumentsLike, codes?: readonly string[]): string[];
+/** `acceptedDocuments`, or — from a server that predates it — MR with the legacy list. */
+declare function resolveAcceptedDocuments(view: {
+    acceptedDocuments?: AcceptedDocumentsLike | undefined;
+    acceptedDocumentTypes?: readonly DocumentTypeId[] | undefined;
+}): AcceptedDocumentsLike;
+/** 🇲🇷-style flag from an alpha-2 code (regional indicator symbols). */
+declare function flagOf(iso2: string): string;
 
 interface MrzBand {
     x: number;
@@ -162,195 +58,258 @@ declare const MRZ_BAND_DEFAULTS: Readonly<MrzBandThresholds>;
  */
 declare function detectMrzBand(frame: ImageData, overrides?: Partial<MrzBandThresholds>): MrzBand | null;
 
-type FramingStatus = "no_document" | "too_far" | "too_close" | "edge_clipped" | "wrong_shape" | "tilted" | "ok";
-type LightingStatus = "too_dark" | "too_bright" | "ok";
-type BlurStatus = "blurry" | "ok";
-type GlareStatus = "glare" | "ok";
-/** The per-frame analysis vector (every axis judged independently). */
-interface DocFrameAnalysis {
-    framing: FramingStatus;
-    lighting: LightingStatus;
-    blur: BlurStatus;
-    glare: GlareStatus;
-    /** All-clear: every axis ok — the gate's integrator/stability input. */
-    acceptable: boolean;
-}
-interface DocFrameMeasures {
-    /** frame-quality sharpness on the doc-region crop (0..1). */
-    sharpness: number;
-    /** frame-quality exposure on the doc-region crop (0..1). */
-    exposure: number;
-    /** Mean crop luma (0..255) — picks too_dark vs too_bright. */
-    meanLuma: number;
-    /** Fraction of crop pixels at/above the specular ceiling (0..1). */
-    specularFraction: number;
+type CapabilityFailure = "simd" | "worker" | "bitmap" | "memory";
+type Capability = {
+    ok: true;
+} | {
+    ok: false;
+    reason: CapabilityFailure;
+};
+type Probe = {
+    WebAssembly?: {
+        validate?: (b: BufferSource) => boolean;
+    };
+    Worker?: unknown;
+    createImageBitmap?: unknown;
+    navigator?: {
+        deviceMemory?: number;
+        connection?: {
+            saveData?: boolean;
+            effectiveType?: string;
+        };
+    };
+};
+declare function probeCapabilities(t: {
+    minDeviceMemoryGb: number;
+}, g?: Probe): Capability;
+
+/** This build's engine (packages/sekyro-ocr-wasm wasm-engine.lock.json `engine`). */
+declare const WEB_OCR_ENGINE = "sekyro-ocr-1";
+interface WebOcrPlan {
+    /** Create the engine for this session (some OCR path is live). */
+    enabled: boolean;
+    liveMrz: (LiveMrzTuning & {
+        hint: boolean;
+        stillConfirm: boolean;
+    }) | null;
+    textLock: TextLockTuning | null;
+    /** The A/B arm per block (`null`: the block is absent or disabled — no report). */
+    liveMrzArm: "live" | "control" | null;
+    frontLockArm: "live" | "control" | null;
+    load: {
+        detectorLimit: number;
+        loadTimeoutMs: number;
+        maxDownloadMs: number;
+        minDeviceMemoryGb: number;
+    };
+    reportSampleRate: number;
 }
-/** Analysis thresholds beyond the gate's — frozen defaults (round 4). */
-declare const DOC_ANALYSIS_DEFAULTS: Readonly<{
-    /** Doc area fraction above which the camera is too close (capture would crop). */
-    MAX_AREA_FRAC: 0.92;
-    /** Opposite-side length ratio beyond which the view is too oblique. */
-    TILT_MAX_SIDE_RATIO: 1.3;
-    /** Specular-pixel fraction at/above which the frame reads as glare. */
-    GLARE_MAX_SPECULAR_FRAC: 0.025;
-}>;
-/** Fraction of crop pixels with luma ≥ 252 — cheap specular-highlight measure. */
-declare function specularFraction(crop: ImageData): number;
-/** Opposite-side length ratio of the quad (1 = fronto-parallel). */
-declare function quadTiltRatio(quad: DocQuad): number;
+/** `capture.document` → the plan. `mode: "off"` (the embedded option) turns every OCR path off. */
+declare function resolveWebOcrPlan(document: unknown, o?: {
+    mode?: "auto" | "off";
+    engine?: string;
+}): WebOcrPlan;
+type WebOcrStart = {
+    ok: true;
+    engine: OcrEngineClient;
+} | {
+    ok: false;
+    reason: "unsupported" | "off";
+};
 /**
- * Judge one frame. `detectionMode` mirrors the gate: ID-1 quads carry
- * area/aspect/tilt semantics; ID-3 MRZ bands carry width-fraction semantics
- * (band rects are axis-aligned, so tilt/aspect checks are band-specific).
+ * Create the engine when the plan, the device (SIMD, workers, bitmaps, memory) and the network allow; else the reason
+ * (`off`: nothing enabled for this session; `unsupported`: the device or a slow / Save-Data connection).
  */
-declare function analyzeDocFrame(input: {
-    format: DocFormat;
-    quad: DocQuad | null;
-    frameWidth: number;
-    frameHeight: number;
-    measures: DocFrameMeasures;
-    thresholds?: Partial<DocGateThresholds>;
-}): DocFrameAnalysis;
-
-/** Feedback vocabulary (dcv2.* message keys on the hosted side). */
-type DocFeedbackKey = "sensing" | "too_far" | "too_close" | "edge_clipped" | "wrong_shape" | "tilted" | "too_dark" | "too_bright" | "blurry" | "glare" | "hold_still" | "processing" | "side_captured" | "captured";
-/** Reticle rendering mode per feedback state (the stage maps to visuals). */
-type ReticleType = "searching" | "coaching" | "locking" | "processing" | "flip" | "done";
-interface DocFeedbackState {
-    key: DocFeedbackKey;
-    reticle: ReticleType;
-    /** The state holds the UI at least this long (ms) before a switch. */
-    minDurationMs: number;
+declare function startWebOcr(plan: WebOcrPlan, o: Pick<OcrEngineOptions, "baseUrl" | "salt" | "workerUrl" | "createWorker" | "page"> & {
+    probe?: typeof probeCapabilities;
+    slow?: () => boolean;
+}): WebOcrStart;
+type BrowserFamily = "chrome" | "safari" | "samsung" | "firefox" | "other";
+/** A fixed browser family (spec §10): from UA brands / tokens, never the UA string itself. */
+declare function browserFamily(ua?: string): BrowserFamily;
+/** The `live_mrz` wire report (identity-backend capture-report.schema.ts LiveMrzReportSchema). Enums and integers only. */
+interface LiveMrzWireReport {
+    kind: "live_mrz";
+    platform: "web";
+    engine: string;
+    arm: "live" | "control";
+    capture: "recto" | "verso" | "single";
+    outcome: "valid" | "locked" | "timeout" | "slow" | "unsupported" | "download" | "integrity" | "error" | "off";
+    reads: number;
+    format?: "TD1" | "TD2" | "TD3";
+    framesToValid?: number;
+    msToValid?: number;
+    framesToLock?: number;
+    msToLock?: number;
+    msToCapture?: number;
+    warmupMs?: number;
+    readP50Ms?: number;
+    readP90Ms?: number;
+    downloadMs?: number;
+    cached?: boolean;
+    stillConfirmed?: boolean;
+    typeMismatch?: boolean;
+    deviceClass?: "fast" | "mid" | "slow";
+    browser: BrowserFamily;
 }
-declare const DOC_FEEDBACK_STATES: Readonly<Record<DocFeedbackKey, DocFeedbackState>>;
-/** Frame analysis → the feedback vote it casts (worst axis speaks). */
-declare function feedbackVoteOf(analysis: DocFrameAnalysis): DocFeedbackKey;
-/** Sliding vote window + exponential decay + per-state minimum hold. */
-declare class DocFeedbackAggregator {
-    private readonly windowMs;
-    /** Per-second decay factor — recent frames outvote stale ones. */
-    private readonly decayPerSecond;
-    private votes;
-    private current;
-    private currentSinceMs;
-    constructor(windowMs?: number, 
-    /** Per-second decay factor — recent frames outvote stale ones. */
-    decayPerSecond?: number);
-    reset(): void;
-    /** Force a terminal/choreography state (capture fired, side flip, upload). */
-    force(key: Extract<DocFeedbackKey, "processing" | "side_captured" | "captured">, nowMs: number): DocFeedbackState;
-    /** Cast this frame's vote and return the (possibly held) winning state. */
-    tick(vote: DocFeedbackKey, nowMs: number): DocFeedbackState;
-}
-
 /**
- * Pre-fetch + cache the scanic chunk (call when the scan surface MOUNTS, before
- * the camera is even granted) so the first detect tick pays no chunk-fetch
- * latency. Fire-and-forget; failures fall back to the lazy path.
+ * One face's report: from the assist's report when it ran, else the engine's load outcome (`unsupported`, `download`,
+ * `integrity`, `error`/`timeout` → error) or `off` (the control arm). `arm` = the block's arm for this face.
  */
-declare function warmDocDetector(): void;
-/** Doc detect cadence per device class — scanic @480px is ~3–8× a face tick,
- *  so the doc loop paces slower than the face profiles (findings §1: 2–5 Hz). */
-declare const DOC_CADENCE_HZ: Readonly<Record<DeviceClass, number>>;
-interface DocChecksPayload {
-    engine: "docv1";
-    /** Gate integrator 0..1 — the overlay ring. */
-    p: number;
-    plausible: boolean;
-    stableTicks: number;
-    quad: DocQuad | null;
-    /** Detect-frame size the quad coordinates live in (overlay scaling). */
-    frameWidth: number;
-    frameHeight: number;
-    /** Capture-v2 per-frame status vector (framing/lighting/blur/glare). */
-    analysis: DocFrameAnalysis;
-}
-/** Artifacts: `keyframe` = the full-res still of the framed side (JPEG). */
-type DocArtifacts = CaptureArtifacts & {
-    side?: DocSide;
-};
-interface CaptureSessionDocEvents {
-    statechange: {
-        state: CaptureState;
-    };
-    checks: DocChecksPayload;
-    /** dcv1.* message KEY — hosts translate; never prose. Deduped. */
-    guidance: {
-        key: string;
-    };
-    /** Capture-v2 AGGREGATED feedback (time-decay voted, min-duration held) —
-     *  the stage's message + reticle channel. Deduped on state key. */
-    feedback: DocFeedbackState;
-    artifacts: DocArtifacts;
-    error: {
-        kind: CaptureErrorKind;
-        retryable: boolean;
+declare function liveMrzWireReport(i: {
+    arm: "live" | "control";
+    capture: "recto" | "verso" | "single";
+    assist?: DocAssistReport | null;
+    load?: ReadyInfo | LoadFailure | "off" | null;
+    msToCapture?: number;
+    stillConfirmed?: boolean;
+    typeMismatch?: boolean;
+    browser?: BrowserFamily;
+    engine?: string;
+}): LiveMrzWireReport;
+/** A valid live read whose format contradicts the picked document (spec D5 state 4): TD3 on a card, TD1/TD2 on a passport. */
+declare function formatMismatch(format: "TD1" | "TD2" | "TD3" | undefined, picked: "passport" | "card"): boolean;
+
+declare const OCR_ASSET_SET: {
+    readonly fp12: "08390000c48a";
+    readonly engine: "sekyro-ocr-1";
+    readonly precision: "fp32";
+    readonly files: {
+        readonly "sekyro-ocr.wasm": {
+            readonly bytes: 3550608;
+            readonly sha256: "c15968a6de3d2225e2fdbf36d71a9214c2910419056c6878444fd2d0567bb748";
+            readonly tier: "live";
+            readonly contentType: "application/wasm";
+        };
+        readonly "sekyro-ocr.mjs": {
+            readonly bytes: 4270;
+            readonly sha256: "209a78d96ca53344996a0c2300aed4ff8a5c69e142713216975a2840eec08cac";
+            readonly tier: "bundled";
+            readonly contentType: "text/javascript";
+        };
+        readonly "det.param": {
+            readonly bytes: 24252;
+            readonly sha256: "c39ba0b1195e8ad37cfc5bdd7acedcfc1d9cb901e7b8eb1c9c4f6e5a66c04eb3";
+            readonly tier: "live";
+            readonly contentType: "text/plain";
+        };
+        readonly "det.bin": {
+            readonly bytes: 4685856;
+            readonly sha256: "652bafe366565109a1a5766caf482bc46f01481f8044d3a785bd9a1be67c63bb";
+            readonly tier: "live";
+            readonly contentType: "application/octet-stream";
+        };
+        readonly "mrz-rec.param": {
+            readonly bytes: 3510;
+            readonly sha256: "bc69b1b9683e35f6605b21001fadeb81468063459c00c0fc83c67c139f23df01";
+            readonly tier: "live";
+            readonly contentType: "text/plain";
+        };
+        readonly "mrz-rec.bin": {
+            readonly bytes: 494196;
+            readonly sha256: "de93a2aa2f08670cc7dedd17ba378d2f5d7cf6ae409054a9eac863a02c2febae";
+            readonly tier: "live";
+            readonly contentType: "application/octet-stream";
+        };
+        readonly "mrz_dict.txt": {
+            readonly bytes: 73;
+            readonly sha256: "b19858a4de2ccbbbdd4b53982188ea2c7664013183bbd1ae9d20ab52c661f97f";
+            readonly tier: "live";
+            readonly contentType: "text/plain";
+        };
+        readonly "latin-rec.param": {
+            readonly bytes: 19602;
+            readonly sha256: "2ae30dfdc7ee482c6cbbc0419c16ee125e880e9eaf69053d61953694bb0fcf4c";
+            readonly tier: "lazy";
+            readonly contentType: "text/plain";
+        };
+        readonly "latin-rec.bin": {
+            readonly bytes: 10750388;
+            readonly sha256: "f91ebdcf4d6b58c58a87704160e59d07ae56bc2d5021eae09d095c5a20bf7525";
+            readonly tier: "lazy";
+            readonly contentType: "application/octet-stream";
+        };
+        readonly "ppocr_keys_v1.txt": {
+            readonly bytes: 26249;
+            readonly sha256: "28b2362ad4ab2dc38769aa72feb535e3a9ddb3fd2a7585a05920e6393b1dc7f7";
+            readonly tier: "lazy";
+            readonly contentType: "text/plain";
+        };
+        readonly "arabic-rec.param": {
+            readonly bytes: 9858;
+            readonly sha256: "4e5cc85667dfaaa0c67d3f308400645a578c08bd43f952cab6c55b7bce143ea9";
+            readonly tier: "lazy";
+            readonly contentType: "text/plain";
+        };
+        readonly "arabic-rec.bin": {
+            readonly bytes: 8853572;
+            readonly sha256: "5acc3265a1738dc31316258383830d5dbdfa5e8ebc2e710f9001f832ecfbffb0";
+            readonly tier: "lazy";
+            readonly contentType: "application/octet-stream";
+        };
+        readonly "arabic_dict.txt": {
+            readonly bytes: 405;
+            readonly sha256: "637c27c88512c22089bef927b34ada08f748dc132ac70facd68d8202384c2726";
+            readonly tier: "lazy";
+            readonly contentType: "text/plain";
+        };
     };
-}
-interface CaptureSessionDocOptions {
-    /** Host-owned <video playsInline muted>. */
-    video: HTMLVideoElement;
-    format?: DocFormat;
-    /** Side label stamped on the artifacts event (recto→verso sequencing). */
-    side?: DocSide;
-    thresholds?: Partial<DocGateThresholds>;
-    deviceClass?: DeviceClass;
-    /** (navigator.mediaDevices.getUserMedia — environment camera) */
-    getUserMedia?: (constraints: MediaStreamConstraints) => Promise<MediaStream>;
-    /** (vendored scanic detectQuad) */
-    detect?: (image: ImageData) => Promise<DocQuad | null>;
-    /** (canvas downscale of the live video to the 480px detect frame) */
-    grabDetectFrame?: (video: HTMLVideoElement, targetWidth: number) => ImageData | null;
-    /** (full-res canvas still → JPEG blob + preview; quad passed for telemetry) */
-    captureStill?: (video: HTMLVideoElement, quad: DocQuad, detectSize: {
-        width: number;
-        height: number;
-    }) => Promise<{
-        blob: Blob;
-        previewDataUrl: string;
-    }>;
-    /** (performance.now) */
-    now?: () => number;
-    /** (setTimeout/clearTimeout) — the cadence pacer. */
-    setTimer?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
-    clearTimer?: (id: ReturnType<typeof setTimeout>) => void;
-}
-type Handler<K extends keyof CaptureSessionDocEvents> = (payload: CaptureSessionDocEvents[K]) => void;
-declare class CaptureSessionDoc {
-    private readonly opts;
-    private readonly gate;
-    private readonly cadenceMs;
-    private readonly handlers;
-    private stream;
-    private timer;
-    private state;
-    private lastGuidance;
-    private attempt;
-    private capturing;
-    private readonly feedback;
-    private lastFeedbackKey;
-    constructor(opts: CaptureSessionDocOptions);
-    on<K extends keyof CaptureSessionDocEvents>(event: K, handler: Handler<K>): () => void;
-    private emit;
-    start(): Promise<void>;
-    /** Restart the gate for another side / a retake (same stream). */
-    rearm(side?: DocSide): void;
-    destroy(): void;
-    private setState;
-    private scheduleTick;
-    private tick;
+};
+
+/** `processing` re-reads (1+2+4+8+15 = 30 s, spec §6.5), then `stalled`. */
+declare const PROCESSING_BACKOFF_MS: readonly number[];
+/** Hosted parity: a resend is offered 30 s after the last send. */
+declare const OTP_RESEND_COOLDOWN_MS = 30000;
+type Executor = (client: HostedClientLike, idempotencyKey: string) => Promise<SessionView>;
+interface RunnerDeps {
+    runtime: SubmitRuntime;
+    currentView(): HostedSessionView | null;
+    ensureView(): Promise<HostedSessionView>;
+    refreshView(): Promise<HostedSessionView>;
+    ensureConsent(): Promise<void>;
+    selectMethod(method: IdentityMethod): Promise<void>;
+    liveness(options: LivenessCaptureOptions): LivenessCaptureHandle;
+    /** A liveness submission chain is in flight (do not flip the UI mid-upload). */
+    chainBusy(): boolean;
+    destroyed(): boolean;
+    sleep(ms: number): Promise<void>;
+    isMobile(): boolean;
+    now(): number;
+    emitStep(step: VerificationStep): void;
+    emitResult(result: VerificationResult): void;
     /**
-     * BEST-FRAME capture window (capture-v2): the first ready tick captures a
-     * candidate immediately, then up to CAPTURE_EXTRA_CANDIDATES more stills are
-     * taken at CAPTURE_CANDIDATE_SPACING_MS while the user holds — each scored
-     * by the live detect-tick sharpness at its capture moment — and the SHARPEST
-     * wins. Beats first-acceptable-frame capture without decoding stills.
+     * The promoted face_match probe key of the last liveness submission (profile
+     * v2 §4.4 wrong-number re-entry): after the re-entered NNI passes, the
+     * `pending` face_match is resubmitted with it — no new capture. `null` when
+     * no liveness was submitted from this page (e.g. after a reload).
      */
-    private fire;
+    keptFaceKey?(): string | null;
+    /** Task 4: binds the document step (selectDocument + capture). */
+    bindDocument?(snapshot: Extract<StepSnapshot, {
+        kind: "document";
+    }>, republish: () => void): VerificationStep;
+    /** SDK spec §4.9: binds the ICAO portrait step (capture + portrait_icao / face_match submissions). */
+    bindPortrait?(snapshot: Extract<StepSnapshot, {
+        kind: "portrait";
+    }>, republish: () => void): VerificationStep;
+    /** Commit a view an action answered (flow model 2026-10-23); absent → re-read the view. */
+    setView?(view: HostedSessionView): void;
+    /** Step 3 one capture: the ICAO coaching of the running live-photo capture. */
+    onLivePhoto?(handler: (gate: LivePhotoGateUpdate) => void): () => void;
 }
-/** Best-frame window: 2 extra candidates, 260ms apart, ≥8% sharper to replace. */
-declare const CAPTURE_EXTRA_CANDIDATES = 2;
-declare const CAPTURE_CANDIDATE_SPACING_MS = 260;
+interface StepRunner {
+    run(): Promise<VerificationStep>;
+    current(): VerificationStep | null;
+    /** Called by the verification on every view update. */
+    onView(view: HostedSessionView): void;
+    /** Called when the liveness chain becomes idle. */
+    onChainIdle(): void;
+    /** Re-derive from the current view and publish even if unchanged (local overlay changed). */
+    republish(): void;
+    /** Submit one step input (exposed for the document binding, Task 4). */
+    submit(checkType: CheckType, executor: Executor, onAccepted?: () => void): Promise<void>;
+}
+declare function createStepRunner(deps: RunnerDeps): StepRunner;
 
 /**
  * Reasons the backend parks at `input_required` while attempts remain
@@ -431,4 +390,82 @@ interface ExecuteTurnstileOptions {
  */
 declare function executeTurnstile(siteKey: string, opts?: ExecuteTurnstileOptions): Promise<string>;
 
-export { ASPECT_BANDS, type BlurStatus, CAPTURE_CANDIDATE_SPACING_MS, CAPTURE_EXTRA_CANDIDATES, CaptureSessionDoc, type CaptureSessionDocEvents, type CaptureSessionDocOptions, DOC_ANALYSIS_DEFAULTS, DOC_CADENCE_HZ, DOC_DETECT_WIDTH, DOC_FEEDBACK_STATES, DOC_GATE_V1_DEFAULTS, type DocArtifacts, type DocCatalogEntry, type DocChecksPayload, DocFeedbackAggregator, type DocFeedbackKey, type DocFeedbackState, type DocFormat, type DocFrameAnalysis, type DocFrameMeasures, type DocGateQuality, type DocGateThresholds, type DocGateTick, type DocGateTickInput, DocGateV1, type DocQuad, type DocQuadPoint, type DocSide, type ExecuteTurnstileOptions, type FramingStatus, type GlareStatus, type LightingStatus, MRZ_BAND_DEFAULTS, MR_DOC_CATALOG, type MrzBand, type MrzBandThresholds, RETRYABLE_REASONS, type ReticleType, TURNSTILE_EXECUTE_TIMEOUT_MS, TURNSTILE_SCRIPT_SRC, type TurnstileApi, type TurnstileRenderParams, analyzeDocFrame, aspectBand, detectMrzBand, executeTurnstile, feedbackVoteOf, frontierStep, isExecutable, isTerminalView, loadTurnstile, mapSessionResult, mergeSessionView, quadAreaFrac, quadBounds, quadIou, quadTiltRatio, resetTurnstileForTests, specularFraction, stepOf, warmDocDetector };
+/**
+ * Face of a decoded still: an MRZ band means the verso. With `cardOnly` (the still is the card itself) the band must
+ * sit in its lower half, where a card's MRZ is: the line of print across a recto's top (the issuing state) is not one.
+ */
+declare function classifyCardSideWith(detect: typeof detectMrzBand, still: ImageData, cardOnly?: boolean): "recto" | "verso";
+/** {@link classifyCardSideWith} with the MRZ-band detector loaded on demand. */
+declare function classifyCardSide(still: ImageData, cardOnly?: boolean): Promise<"recto" | "verso">;
+/** Downscale a captured JPEG to a 480 px-wide ImageData for the classifier. */
+declare function stillToImageData(blob: Blob, width?: number): Promise<ImageData | null>;
+
+/** Long side the measure runs at (Mattel: about what the recognizer sees of a card). */
+declare const SHARPNESS_LONG_EDGE = 1000;
+/** Inverse-edge-width sharpness of an RGBA image; `-1` for an unusable one (< 16 px). */
+declare function photoSharpness(image: {
+    data: ArrayLike<number>;
+    width: number;
+    height: number;
+}): number;
+/** A rectangle of the full-resolution still, in its pixels. */
+interface StillRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Padding around the card's bounding box, as a fraction of its size per side. */
+declare const REGION_PAD = 0.06;
+/**
+ * The card region of the still (Mattel measures the guide region, not the
+ * whole photo): the bounding box of the last gate quad — in detect-frame
+ * coordinates — scaled to the still, padded by {@link REGION_PAD} and clamped.
+ * `null` when there is no usable quad (then the whole still is measured).
+ */
+declare function stillRegionOf(quad: {
+    topLeft: {
+        x: number;
+        y: number;
+    };
+    topRight: {
+        x: number;
+        y: number;
+    };
+    bottomRight: {
+        x: number;
+        y: number;
+    };
+    bottomLeft: {
+        x: number;
+        y: number;
+    };
+} | null, frame: {
+    width: number;
+    height: number;
+}, still: {
+    width: number;
+    height: number;
+}, pad?: number): StillRegion | null;
+type RawImage = {
+    data: ArrayLike<number>;
+    width: number;
+    height: number;
+};
+/** Crop `region` out of an RGBA image (pure; the canvas path does the same with drawImage). */
+declare function cropImage(image: RawImage, region: StillRegion): {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+};
+/** Area-average downscale so the long side is at most `longEdge` (pure; mirrors cv INTER_AREA). */
+declare function resizeLongEdge(image: RawImage, longEdge?: number): RawImage;
+/** The blur-gate measure of a still: its card region (or the whole still), scaled to ≤ 1000 px. */
+declare function measureRegionSharpness(image: RawImage, region: StillRegion | null): number;
+/**
+ * Browser path of {@link measureRegionSharpness} on an already decoded still:
+ * one drawImage crops and scales the region; the canvas is released after.
+ */
+declare function measureBitmapSharpness(bitmap: ImageBitmap, region: StillRegion | null): number;
+
+export { type AcceptedDocumentsLike, type BrowserFamily, DOCUMENT_TYPE_ORDER, DocAssistReport, DocCatalogEntry, type DocumentTypeId, type ExecuteTurnstileOptions, HostedClientLike, LiveMrzTuning, type LiveMrzWireReport, LoadFailure, MRZ_BAND_DEFAULTS, type MrzBand, type MrzBandThresholds, OCR_ASSET_SET, OTP_RESEND_COOLDOWN_MS, OcrEngineClient, PROCESSING_BACKOFF_MS, REGION_PAD, RETRYABLE_REASONS, ReadyInfo, type RunnerDeps, SHARPNESS_LONG_EDGE, type StepRunner, type StillRegion, SubmitRuntime, TURNSTILE_EXECUTE_TIMEOUT_MS, TURNSTILE_SCRIPT_SRC, TextLockTuning, type TurnstileApi, type TurnstileRenderParams, WEB_OCR_ENGINE, type WebOcrPlan, type WebOcrStart, acceptedIssuers, acceptedTypesFor, browserFamily, classifyCardSide, classifyCardSideWith, createStepRunner, cropImage, detectMrzBand, executeTurnstile, flagOf, formatMismatch, frontierStep, isExecutable, isTerminalView, liveMrzWireReport, loadTurnstile, mapSessionResult, measureBitmapSharpness, measureRegionSharpness, mergeSessionView, photoSharpness, resetTurnstileForTests, resizeLongEdge, resolveAcceptedDocuments, resolveWebOcrPlan, startWebOcr, stepOf, stillRegionOf, stillToImageData };