@baas-id/react 0.2.2 → 0.2.9

package/dist/types/react/capture/index.d.ts

@@ -1,5 +1,5 @@
-export { uploadCapture, finalizeSession, probeDocument, uploadCaptureSignal, finalizeSessionSignal, probeDocumentSignal, errorCode, isAbort, rejectionOf, authenticityOf, type RpidClientConfig, type MrzProbe, type CaptureUpload, type Rejection, type DocumentAuthenticity, } from "./api";
-export { openCamera, stopStream, cameraConstraints, type CameraProfile } from "./camera";
+export { uploadCapture, finalizeSession, probeDocument, uploadCaptureSignal, finalizeSessionSignal, probeDocumentSignal, errorCode, isAbort, rejectionOf, authenticityOf, apiHeaders, langHeaders, withLanguage, type RpidClientConfig, type MrzProbe, type CaptureUpload, type Rejection, type DocumentAuthenticity, } from "./api";
+export { openCamera, parkCamera, stopStream, cameraConstraints, type CameraProfile } from "./camera";
 export { analyzeFrame, moireProbe, grabFrame, canvasToJpeg, thumbnailOf, readPixels, haptic, type Quality, type ProbeRegion, } from "./frames";
 export { demoDocumentFrame, demoFaceFrame } from "./demo";
 export { createCaptureRun, frameLoop, nextFrame, type CaptureRun, type TickResult } from "./run";

package/dist/types/react/document/cornerOrder.d.ts

@@ -0,0 +1,29 @@
+import type { Quad } from "../vision/corners";
+export declare function signedArea(q: Quad): number;
+export declare const rotateQuad: (q: Quad, k: number) => Quad;
+export declare function canonicalQuad(q: Quad): {
+    quad: Quad;
+    reflected: boolean;
+};
+export declare function alignToPrevious(q: Quad, prev: Quad | null): Quad;
+export declare function modelRotation(model: Quad, ordered: Quad): number | null;
+export declare function geometricRotation(ordered: Quad): number;
+export declare class OrientationVote {
+    private readonly n;
+    private readonly share;
+    private readonly min;
+    private xs;
+    private k;
+    constructor(n?: number, share?: number, min?: number);
+    push(k: number | null): number | null;
+    get value(): number | null;
+    shift(by: number): void;
+    reset(): void;
+}
+export declare class CornerOrder {
+    private prev;
+    readonly orient: OrientationVote;
+    read(raw: Quad, fromModel: boolean): Quad;
+    rotationFor(stable: Quad): number;
+    reset(): void;
+}

package/dist/types/react/document/gate.d.ts

@@ -12,7 +12,7 @@ export declare const MIN_CARD_AREA = 0.14;
 export declare const CARD_AR_MIN = 1.25;
 export declare const CARD_AR_MAX = 2.05;
 export declare const TILT_HOLD_MAX = 35;
-export declare const LOW_CONTRAST_GRACE_MS = 3000;
+export declare const LOW_CONTRAST_GRACE_MS = 2000;
 export declare const MANUAL_SHUTTER_MS = 10000;
 export declare const DAMAGED_RETRY_LIMIT = 1;
 export declare const TERMINAL_DOC_REASONS: readonly string[];
@@ -64,6 +64,10 @@ export declare const GUIDE: {
         key: "wrong_side_back";
         tone: "warn";
     };
+    turn_over: {
+        key: "turn_over";
+        tone: "info";
+    };
     blurred: {
         key: "blurred";
         tone: "warn";

package/dist/types/react/document/stats.d.ts

@@ -0,0 +1,20 @@
+export declare const GATES: readonly ["found", "side", "fill", "shape", "sharp", "glare", "light", "still"];
+export type Gate = (typeof GATES)[number];
+export declare function gateOf(issue: string): Gate;
+export declare class CaptureStats {
+    private readonly t0;
+    private w;
+    private all;
+    private lastOutline;
+    private hold;
+    private coach;
+    private mode;
+    constructor(t0: number);
+    frame(found: boolean, confidence: number, veto?: "geometry" | "edges" | "content"): void;
+    outline(mode: "edges" | "box" | null): void;
+    tick(gate: Gate | null, pFront: number | null, motion: number | null, stillOk: boolean | null, hold: number, coach: string): void;
+    searching(coach: string): void;
+    flush(now: number): Record<string, number | string | number[]>;
+    summary(now: number, outcome: "capture" | "closed", ttc: number | null): Record<string, number | string | number[] | null>;
+}
+export declare const statsDue: (openMs: number, sinceLastMs: number) => boolean;

package/dist/types/react/document/steady.d.ts

@@ -0,0 +1,89 @@
+import type { Quad } from "../vision/corners";
+export declare const PRESENCE_ON = 4;
+export declare const PRESENCE_OFF = 7;
+export declare class Presence {
+    private readonly onN;
+    private readonly offM;
+    private on;
+    private hits;
+    private misses;
+    constructor(onN?: number, offM?: number);
+    read(found: boolean): boolean;
+    get value(): boolean;
+    reset(): void;
+}
+export declare class SideVote {
+    private readonly n;
+    private xs;
+    constructor(n?: number);
+    push(pFront: number): number;
+    get value(): number;
+    reset(): void;
+}
+export declare const HOLD_MAX_DROP = 0.15;
+export declare class HoldMeter {
+    private readonly holdMs;
+    private readonly drainPerS;
+    private readonly maxDrop;
+    private pct;
+    private last;
+    constructor(holdMs: number, drainPerS?: number, maxDrop?: number);
+    good(now: number): number;
+    bad(now: number): number;
+    get value(): number;
+    reset(): void;
+}
+export declare const STILL_FRAC = 0.018;
+export declare const STILL_FRAC_MAX = 0.03;
+export declare const STILL_RELAX_MS = 1500;
+export declare const STILL_WINDOW_MS = 500;
+export declare const STILL_WINDOW_FAST_MS = 350;
+export declare const STILL_FAST_CONF = 0.9;
+export declare class Stillness {
+    private readonly windowMs;
+    private readonly frac;
+    private h;
+    constructor(windowMs?: number, frac?: number);
+    push(q: Quad, t: number): void;
+    spread(now: number, windowMs?: number): number | null;
+    still(now: number, opts?: {
+        windowMs?: number;
+        frac?: number;
+    }): boolean;
+    reset(): void;
+}
+export declare const stillFrac: (fullForMs: number, relaxed?: boolean) => number;
+export interface Coach<K> {
+    key: K;
+    changed: boolean;
+}
+export declare class CoachGate<K extends string> {
+    private readonly minGapMs;
+    private readonly settleMs;
+    private shown;
+    private pending;
+    private pendingSince;
+    private lastChange;
+    constructor(minGapMs?: number, settleMs?: number);
+    propose(key: K, now: number): Coach<K>;
+    force(key: K, now: number): Coach<K>;
+    get value(): K | null;
+    reset(): void;
+}
+export declare class OneEuro {
+    private readonly minCutoff;
+    private readonly beta;
+    private readonly dCutoff;
+    private x;
+    private dx;
+    private t;
+    constructor(minCutoff?: number, beta?: number, dCutoff?: number);
+    private static a;
+    filter(v: number, t: number): number;
+    reset(): void;
+}
+export declare class CornerFilter {
+    private f;
+    filter(q: Quad, t: number): Quad;
+    reset(): void;
+}

package/dist/types/react/document/upright.d.ts

@@ -0,0 +1,5 @@
+import type { FaceDetection } from "../vision/face";
+export type Turn = 0 | 90 | 180 | 270;
+export declare function rotateCanvas(src: HTMLCanvasElement, deg: Turn): HTMLCanvasElement;
+export declare function uprightFace(f: FaceDetection): boolean;
+export declare function portraitTurn(crop: HTMLCanvasElement, faces: (c: HTMLCanvasElement) => Promise<FaceDetection[]>): Promise<Turn | null>;

package/dist/types/react/document/useDocumentCapture.d.ts

@@ -19,6 +19,7 @@ export interface Snapshot {
 }
 export declare const LOCK_MS = 520;
 export declare const REVIEW_MS = 2600;
+export declare const FLIP_MANUAL_MS = 15000;
 export declare function cutUpload(full: HTMLCanvasElement, b: Box): HTMLCanvasElement;
 export interface UploadCandidate {
     canvas: HTMLCanvasElement;
@@ -72,6 +73,7 @@ export declare function useDocumentCapture(props: DocumentCaptureProps): {
     retriesLeft: number | null;
     final: boolean;
     manualReady: boolean;
+    manualOnly: boolean;
     shutter: () => void | undefined;
     review: ReviewView | null;
     snapshot: Snapshot | null;

package/dist/types/react/face/FaceGuide.d.ts

@@ -1,16 +1,14 @@
 import type { GuideKey, Strings } from "../i18n";
 import { type Ellipse } from "./faceView";
-import type { PointsMotion } from "../document/track";
 import { type ScanState } from "./scanState";
 export type FaceGuideState = "neutral" | "aligned" | "capturing" | "done" | "warn";
 export type FaceCue = "turn_left" | "turn_right" | "move_closer" | null;
-export declare function FaceGuide({ src, oval, motion, state, scan, fills, progress, cue, guide, errorKey, t, }: {
+export declare function FaceGuide({ src, oval, state, scan, fills, progress, cue, guide, errorKey, t, }: {
     src: {
         w: number;
         h: number;
     };
     oval: Ellipse;
-    motion: PointsMotion;
     state: FaceGuideState;
     scan: ScanState;
     fills: number[];

package/dist/types/react/face/scanState.d.ts

@@ -10,7 +10,6 @@ export declare function scanStateOf(s: {
     guide: GuideKey | string;
 }): ScanState;
 export declare const isLocked: (s: ScanState) => s is "challenge" | "done" | "aligned" | "verifying";
-export declare function meshLevel(s: ScanState): number;
 export declare function segmentFills(s: {
     step: number;
     total: number;

package/dist/types/react/flows/FlowResult.d.ts

@@ -1,13 +1,14 @@
-import { type Locale, type StringOverrides, type Strings } from "../i18n";
+import { type Formality, type Locale, type StringOverrides, type Strings } from "../i18n";
 import type { VerificationResult } from "./types";
 export declare function FlowResult({ result, t }: {
     result: VerificationResult;
     t: Strings;
 }): import("react").JSX.Element;
-export declare function IdentifyOutcome({ reason, locale, overrides, onRestart, t, }: {
+export declare function IdentifyOutcome({ reason, locale, overrides, formality, onRestart, t, }: {
     reason: string;
     locale?: Locale;
     overrides?: StringOverrides;
+    formality?: Formality;
     onRestart: () => void;
     t: Strings;
 }): import("react").JSX.Element;

package/dist/types/react/flows/FlowShell.d.ts

@@ -1,9 +1,10 @@
 import { type ReactNode } from "react";
-import { type Locale, type StringOverrides, type Strings } from "../i18n";
+import { type Formality, type Locale, type StringOverrides, type Strings } from "../i18n";
 import { type CaptureId, type FailureCause, type FailureText, type RetakeNotice, type Side, type Step, type Thumbs } from "./state";
 import type { Purpose } from "./types";
 import { type Appearance } from "../theme/appearance";
-export declare function FlowShell({ step, purpose, title, t, children, privacy, appearance, forceAppearance, screen, manageFocus, }: {
+import { type ColorScheme } from "../theme/scheme";
+export declare function FlowShell({ step, purpose, title, t, children, privacy, appearance, forceAppearance, screen, manageFocus, colorScheme, }: {
     step: Step;
     purpose: Purpose;
     title: string;
@@ -14,6 +15,7 @@ export declare function FlowShell({ step, purpose, title, t, children, privacy,
     forceAppearance?: boolean;
     screen?: string;
     manageFocus?: boolean;
+    colorScheme?: ColorScheme;
 }): import("react").JSX.Element;
 export declare function StepRail({ step, t, plan, retakes, }: {
     step: Step;
@@ -35,7 +37,8 @@ export declare function Preparing({ label, note }: {
     label: string;
     note?: string;
 }): import("react").JSX.Element;
-export declare function Failure({ reason, verdict, cause, text, locale, overrides, onRestart, t, takeFocus, }: {
+export declare function Failure({ reason, verdict, cause, text, locale, overrides, formality, onRestart, t, takeFocus, }: {
+    formality?: Formality;
     reason: string;
     verdict?: "REJECTED" | "NEEDS_REVIEW";
     cause?: FailureCause;

package/dist/types/react/flows/types.d.ts

@@ -1,4 +1,5 @@
-import type { Locale, StringOverrides } from "../i18n";
+import type { ColorScheme } from "../theme/scheme";
+import type { Formality, Locale, StringOverrides } from "../i18n";
 import type { DocumentAuthenticity } from "../capture";
 import type { SelfieQualityFloors } from "../face/qualityGate";
 import type { Appearance } from "../theme/appearance";
@@ -93,6 +94,7 @@ export interface SessionFlow {
     document?: boolean;
     documentSides?: "front_back" | "front";
     locale?: Locale;
+    formality?: Formality;
     appearance?: Appearance;
     instructions?: TenantInstructions;
     messages?: TenantMessages;
@@ -240,6 +242,8 @@ export interface VerificationFlowProps {
     source?: "camera" | "demo";
     locale?: Locale;
     strings?: StringOverrides;
+    formality?: Formality;
+    colorScheme?: ColorScheme;
     challengeMs?: number;
     debug?: boolean;
     onVerified: (result: VerificationResult) => void | Promise<void>;

package/dist/types/react/flows/useFlowSession.d.ts

@@ -2,10 +2,11 @@ import { type RpidClientConfig } from "../capture";
 import { type FlowState, type Side } from "./state";
 import type { SideRetake } from "../DocumentCapture";
 import type { ConsentChoice, Purpose, VerificationFlowProps, VerificationResult } from "./types";
-export declare function useFlowSession({ purpose, apiUrl, openSession, locale, strings: overrides, onVerified, onFailed, onEvent, source, consentChoice, diagnostics, }: VerificationFlowProps & {
+export declare function useFlowSession({ purpose, apiUrl, openSession, locale, strings: overrides, formality: formalityProp, onVerified, onFailed, onEvent, source, consentChoice, diagnostics, }: VerificationFlowProps & {
     purpose: Purpose;
     consentChoice?: ConsentChoice | null;
 }): {
+    formality: import("../i18n").Formality;
     state: FlowState;
     t: import("../i18n").Strings;
     locale: import("../i18n").Locale;

package/dist/types/react/handoff/ContinueFlow.d.ts

@@ -1,5 +1,6 @@
-import { type Locale, type StringOverrides, type Strings } from "../i18n";
+import { type Formality, type Locale, type StringOverrides, type Strings } from "../i18n";
 import type { RpidFlowEvent } from "../flows/types";
+import type { ColorScheme } from "../theme/scheme";
 export declare function readHandoffCode(search?: string, pathname?: string, hash?: string): string | null;
 export interface ContinueFlowProps {
     apiUrl: string;
@@ -7,6 +8,8 @@ export interface ContinueFlowProps {
     modelsUrl?: string;
     locale?: Locale;
     strings?: StringOverrides;
+    formality?: Formality;
+    colorScheme?: ColorScheme;
     privacyNote?: string | null;
     source?: "camera" | "demo";
     debug?: boolean;
@@ -16,7 +19,7 @@ export interface ContinueFlowProps {
         reason: string | null;
     }) => void;
 }
-export declare function ContinueFlow({ apiUrl, code, modelsUrl, locale: hostLocale, strings, privacyNote, source, debug, onEvent, onDone, }: ContinueFlowProps): import("react").JSX.Element;
+export declare function ContinueFlow({ apiUrl, code, modelsUrl, locale: hostLocale, strings, formality, colorScheme, privacyNote, source, debug, onEvent, onDone, }: ContinueFlowProps): import("react").JSX.Element;
 export declare function ContinueConfirmView({ t, tenant, codeHint, onContinue }: {
     t: Strings;
     tenant: string;

package/dist/types/react/handoff/ContinueOnPhone.d.ts

@@ -4,6 +4,7 @@ import type { RpidClientConfig } from "../capture";
 import type { ApiSessionBody, Purpose, RpidFlowEvent, RpidSession, VerificationResult } from "../flows/types";
 import { type Locale, type StringOverrides } from "../i18n";
 import type { Appearance } from "../theme/appearance";
+import type { ColorScheme } from "../theme/scheme";
 export type HandoffMode = "auto" | "suggest";
 export interface HandoffCopy {
     title?: string;
@@ -43,6 +44,11 @@ export interface HandoffViewProps {
     onContinueHere?: () => void;
 }
 export declare function HandoffView({ t, mode, copy, link, leftMs, expired, failed, phase, device, copied, linkId, onCopy, onNewCode, onContinueHere, }: HandoffViewProps): import("react").JSX.Element;
+export declare function CodeChip({ t, code, instruction }: {
+    t: Strings;
+    code: string;
+    instruction: string;
+}): import("react").JSX.Element;
 export interface ContinueOnPhoneProps {
     apiUrl: string;
     session: RpidSession | ApiSessionBody;
@@ -56,5 +62,6 @@ export interface ContinueOnPhoneProps {
     onError?: (code: string) => void;
     onEvent?: (e: RpidFlowEvent) => void;
     appearance?: Appearance | null;
+    colorScheme?: ColorScheme;
 }
 export declare function ContinueOnPhone(props: ContinueOnPhoneProps): import("react").JSX.Element;

package/dist/types/react/handoff/api.d.ts

@@ -1,4 +1,4 @@
-import type { RpidClientConfig } from "../capture";
+import { type RpidClientConfig } from "../capture/api";
 import type { ClientEvent } from "../telemetry/bus";
 import type { DeviceSnapshot } from "../telemetry/device";
 type Json = Record<string, unknown>;
@@ -31,10 +31,15 @@ export interface HandoffPeek {
     expiresInS: number;
     purpose: string;
     locale?: string;
+    formality?: "formal" | "informal";
     appearance?: unknown;
 }
-export declare function peekHandoff(apiUrl: string, code: string, signal?: AbortSignal): Promise<HandoffPeek>;
-export declare function claimHandoff(apiUrl: string, code: string, device?: string, signal?: AbortSignal): Promise<Json>;
+export interface CallLanguage {
+    locale?: string;
+    formality?: "formal" | "informal";
+}
+export declare function peekHandoff(apiUrl: string, code: string, signal?: AbortSignal, lang?: CallLanguage): Promise<HandoffPeek>;
+export declare function claimHandoff(apiUrl: string, code: string, device?: string, signal?: AbortSignal, lang?: CallLanguage): Promise<Json>;
 export declare function reportProgress(cfg: RpidClientConfig, step: "front" | "back" | "face"): Promise<void>;
 export declare function postDevice(cfg: RpidClientConfig, snapshot: DeviceSnapshot): Promise<void>;
 export declare function postClientEvents(cfg: RpidClientConfig, events: ClientEvent[], beacon?: boolean): void;

package/dist/types/react/i18n/es-419-formal.d.ts

@@ -0,0 +1,3 @@
+import type { ReasonEntry, Strings } from "./types";
+export declare const ES_FORMAL: Strings;
+export declare const ES_FORMAL_UNKNOWN: ReasonEntry;

package/dist/types/react/i18n/index.d.ts

@@ -1,10 +1,12 @@
-import type { Locale, ReasonEntry, StringOverrides, Strings } from "./types";
-export type { TeleRecipe, Locale, ClientReason, ServerReason, Reason, Recovery, ReasonEntry, GuideKey, EngineStage, DistanceHint, Strings, StringOverrides, } from "./types";
+import type { Formality, Locale, ReasonEntry, StringOverrides, Strings } from "./types";
+export type { TeleRecipe, Locale, ClientReason, ServerReason, Reason, Recovery, ReasonEntry, GuideKey, EngineStage, DistanceHint, Strings, StringOverrides, Formality, } from "./types";
+export { ES_FORMAL } from "./es-419-formal";
 export declare const DEFAULT_LOCALE: Locale;
-export declare function getStrings(locale?: Locale, overrides?: StringOverrides): Strings;
-export declare function reasonEntry(code: string | null | undefined, locale?: Locale, overrides?: StringOverrides): ReasonEntry;
+export declare function getStrings(locale?: Locale, overrides?: StringOverrides, formality?: Formality): Strings;
+export declare function reasonEntry(code: string | null | undefined, locale?: Locale, overrides?: StringOverrides, formality?: Formality): ReasonEntry;
 export declare function attemptsText(t: Strings, retriesLeft: number | null | undefined): string | null;
 export declare function faceRetryText(t: Strings, retriesLeft: number): string;
 export declare const LOCALES: readonly Locale[];
+export declare function formalityOverrides(locale: Locale, formality?: Formality | null): StringOverrides | undefined;
 export declare function browserLocale(languages?: readonly string[]): Locale | undefined;
 export declare function resolveLocale(host?: Locale | null, tenant?: Locale | "auto" | null, languages?: readonly string[]): Locale;

package/dist/types/react/i18n/types.d.ts

@@ -2,13 +2,14 @@ export type Locale = "en" | "es-419";
 export type ClientReason = "CAMERA_UNAVAILABLE" | "ENGINE_UNAVAILABLE" | "UPLOAD_FAILED" | "SESSION_OPEN_FAILED" | "MOVEMENT_TIMEOUT" | "RECENTER_TIMEOUT" | "MOIRE_SUSPECTED" | "SPOOF_SUSPECTED" | "MOVEMENT_DISCONTINUOUS" | "PATTERN_SUSPECTED" | "LOW_QUALITY" | "DOC_DAMAGED_REPEATED";
 export type ServerReason = "DOC_QUALITY_LOW" | "DOC_SIDE_MISMATCH" | "PORTRAIT_NOT_FOUND" | "FACE_MISMATCH" | "TEMPLATE_STALE" | "FACE_NOT_FOUND" | "FACE_MISSING" | "DOCUMENT_MISSING" | "PAD_REJECTED" | "NOT_ENROLLED" | "ALREADY_ENROLLED" | "SESSION_EXPIRED" | "SESSION_FINALIZED" | "SESSION_NOT_FOUND" | "WRONG_PURPOSE" | "CAPTURE_TOKEN_INVALID" | "CAPTURE_TOKEN_EXPIRED" | "CAPTURE_TOKEN_SESSION_MISMATCH" | "CREDENTIALS_REQUIRED" | "INVALID_API_KEY" | "RPID_UNREACHABLE" | "RETRIES_EXHAUSTED" | "FACE_RETRY" | "AI_ASSESSMENT" | "DOC_SCREEN_REPLAY" | "DOC_PAPER_COPY" | "DOC_TAMPERED" | "DOC_DAMAGED" | "DOC_SIDES_INCONSISTENT" | "DOC_FIELDS_CHANGED" | "DUPLICATE_SUSPECT" | "MATCH_FOUND" | "NO_MATCH" | "AMBIGUOUS_MATCH" | "DOC_BACK_MISMATCH" | "DOC_BACK_UNREADABLE" | "REPLAY_SUSPECTED" | "INJECTION_SUSPECTED" | "CHALLENGE_UNVERIFIED" | "PAD_SUSPECTED" | "HANDOFF_CODE_INVALID" | "HANDOFF_CODE_EXPIRED" | "HANDOFF_CODE_USED" | "HANDOFF_REVOKED" | "HANDOFF_ACTIVE" | "HANDOFF_DISABLED" | "HANDOFF_ALREADY_CLAIMED" | "HANDOFF_RATE_LIMITED" | "CAPTURE_TOKEN_REVOKED";
 export type Reason = ClientReason | ServerReason;
+export type Formality = "informal" | "formal";
 export type Recovery = "retry" | "restart" | "support";
 export interface ReasonEntry {
     message: string;
     recovery: Recovery;
     title?: string;
 }
-export type GuideKey = "no_face" | "no_card" | "too_dark" | "too_bright" | "hold_still" | "move_closer" | "move_back" | "recenter" | "perfect" | "ready" | "find_light" | "look_straight" | "loading" | "too_far" | "bad_framing" | "screen_suspected" | "paper_suspected" | "tilt_less" | "low_contrast" | "wrong_side_front" | "wrong_side_back" | "blurred" | "glare" | "steady" | "uploading" | "mrz_reading" | "mrz_unreadable" | "mrz_verified" | "closer_more" | "done_short" | "abrupt" | "a_bit_more" | "nod_start" | "nod_return" | "turn_left" | "turn_right" | "turn_wrong_left" | "turn_wrong_right" | "turn_slower" | "turn_lost" | "turn_return_center" | "turn_done" | "turn_hold_steady" | "turn_going_well" | "turn_almost" | "turn_complete" | "recenter_front" | "recenter_center" | "try_other_movement";
+export type GuideKey = "no_face" | "no_card" | "too_dark" | "too_bright" | "hold_still" | "move_closer" | "move_back" | "recenter" | "perfect" | "ready" | "find_light" | "look_straight" | "loading" | "too_far" | "bad_framing" | "screen_suspected" | "paper_suspected" | "tilt_less" | "low_contrast" | "wrong_side_front" | "wrong_side_back" | "turn_over" | "blurred" | "glare" | "steady" | "uploading" | "mrz_reading" | "mrz_unreadable" | "mrz_verified" | "closer_more" | "done_short" | "abrupt" | "a_bit_more" | "nod_start" | "nod_return" | "turn_left" | "turn_right" | "turn_wrong_left" | "turn_wrong_right" | "turn_slower" | "turn_lost" | "turn_return_center" | "turn_done" | "turn_hold_steady" | "turn_going_well" | "turn_almost" | "turn_complete" | "recenter_front" | "recenter_center" | "try_other_movement";
 export type EngineStage = "starting" | "downloading" | "warming" | "downloading_face" | "ready";
 export type DistanceHint = "too_far" | "bit_far" | "ideal" | "bit_close" | "too_close";
 export interface Strings {
@@ -104,6 +105,7 @@ export interface Strings {
         reviewNone: string;
         verify: string;
         confirmed: string;
+        shutterManualNote: string;
         confirmTitle: string;
         confirmTitleFront: string;
         confirmTitleBack: string;
@@ -201,6 +203,9 @@ export interface Strings {
         doneTitle: string;
         doneBody: string;
         linkErrorTitle: string;
+        codeLabel: string;
+        codeConfirmDesktop: string;
+        codeConfirmPhone: string;
     };
     flow: {
         stepFront: string;

package/dist/types/react/preview/FlowPreview.d.ts

@@ -1,8 +1,9 @@
-import { type Locale } from "../i18n";
+import { type Formality, type Locale } from "../i18n";
 import { type TenantInstructions } from "../flows/experience";
 import { type CaptureId } from "../flows/state";
 import type { Purpose } from "../flows/types";
 import { type Appearance } from "../theme/appearance";
+import type { ColorScheme } from "../theme/scheme";
 export type PreviewScreen = "intro" | "capture" | "success" | "error" | "handoff" | "continue" | "continueDone";
 export interface PreviewHandoff {
     mode?: "auto" | "suggest";
@@ -21,7 +22,9 @@ export interface FlowPreviewProps {
     challenge?: PreviewChallenge;
     purpose?: Purpose;
     locale: Locale;
+    formality?: Formality;
     appearance?: Appearance | null;
+    colorScheme?: ColorScheme;
     instructions?: TenantInstructions | null;
     messages?: unknown;
     errorCode?: string;

package/dist/types/react/telemetry/bus.d.ts

@@ -1,4 +1,4 @@
-export type ClientEventType = "camera_permission" | "camera_error" | "camera_not_found" | "camera_started" | "model_load_start" | "model_load_done" | "model_load_failed" | "model_load_timeout" | "engine_unavailable" | "visibility" | "step_shown" | "retry" | "abandoned" | "flow_failed" | "handoff_shown" | "continue_here" | "capture_review_shown" | "capture_confirmed" | "capture_retaken";
+export type ClientEventType = "camera_permission" | "camera_error" | "camera_not_found" | "camera_started" | "model_load_start" | "model_load_done" | "model_load_failed" | "model_load_timeout" | "engine_unavailable" | "visibility" | "step_shown" | "retry" | "abandoned" | "flow_failed" | "handoff_shown" | "continue_here" | "capture_review_shown" | "capture_confirmed" | "capture_retaken" | "detector_stats" | "detector_summary";
 export interface ClientEvent {
     type: ClientEventType;
     t?: number;

package/dist/types/react/theme/appearance.d.ts

@@ -1,4 +1,5 @@
 import type { CSSProperties } from "react";
+import { type ColorScheme } from "./scheme";
 export type ColorKey = "primary" | "positive" | "caution" | "danger" | "surface" | "text" | "overlay";
 export type SafeFont = "inherit" | "system" | "humanist" | "geometric" | "grotesque" | "rounded" | "serif";
 export interface Appearance {
@@ -12,11 +13,12 @@ export interface Appearance {
         mesh?: string;
     };
     lowLightFill?: boolean;
+    colorScheme?: ColorScheme;
 }
 export declare const FONT_STACKS: Record<SafeFont, string>;
 export declare const SDK_DEFAULTS: Record<string, string>;
-export declare function appearanceGroups(a: Appearance | null | undefined): Array<Record<string, string>>;
+export declare function appearanceGroups(a: Appearance | null | undefined, scheme?: "light" | "dark"): Array<Record<string, string>>;
 export declare function hostSet(name: string, computed: string | null | undefined): boolean;
-export declare function appearanceStyle(a: Appearance | null | undefined, read?: (name: string) => string | null | undefined, force?: boolean): CSSProperties;
+export declare function appearanceStyle(a: Appearance | null | undefined, read?: (name: string) => string | null | undefined, force?: boolean, scheme?: "light" | "dark"): CSSProperties;
 export declare function safeLogoUrl(a: Appearance | null | undefined): string | null;
 export declare function normalizeAppearance(raw: unknown): Appearance | undefined;

package/dist/types/react/theme/scheme.d.ts

@@ -0,0 +1,23 @@
+import type { Appearance } from "./appearance";
+export type ColorScheme = "light" | "dark" | "auto";
+export declare const DARK: {
+    readonly surface: "#0F1A21";
+    readonly ink: "#EEF3F5";
+    readonly muted: "#A9B8C0";
+};
+export declare const DARK_TEXT_MIN = 6;
+export declare function mixHex(a: string, b: string, t: number): string;
+export declare function liftOn(color: string, ground?: string, min?: number): string;
+export declare function darkPalette(a?: Appearance | null): {
+    surface: "#0F1A21";
+    ink: "#EEF3F5";
+    muted: "#A9B8C0";
+    accent: string;
+    positive: string;
+    caution: string;
+    negative: string;
+};
+export declare function darkGroups(a?: Appearance | null): Array<Record<string, string>>;
+export declare const DARK_DERIVED: Record<string, string>;
+export declare function useColorScheme(pref: ColorScheme | undefined): "light" | "dark";
+export declare const isColorScheme: (v: unknown) => v is ColorScheme;

package/dist/types/react/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.2";
+export declare const SDK_VERSION = "0.2.9";

package/dist/types/react/vision/cardEvidence.d.ts

@@ -0,0 +1,29 @@
+import type { Quad } from "./corners";
+export interface Rgba {
+    data: ArrayLike<number>;
+    width: number;
+    height: number;
+}
+export interface Evidence {
+    sides: [number, number, number, number];
+    sidesOk: number;
+    detail: number;
+    isotropy: number;
+    vivid: number;
+    ok: boolean;
+    reason: "geometry" | "edges" | "content" | null;
+}
+export declare const SIDE_MIN = 0.4;
+export declare const SIDES_NEEDED = 3;
+export declare const AREA_MAX = 0.95;
+export declare const DETAIL_MIN = 0.035;
+export declare const ISOTROPY_MIN = 0.18;
+export declare const VIVID_MAX = 0.45;
+export declare function geometryOk(q: Quad, W: number, H: number): boolean;
+export declare function sideEvidence(gray: Float32Array, W: number, H: number, q: Quad): [number, number, number, number];
+export declare function contentEvidence(px: Rgba, q: Quad): {
+    detail: number;
+    isotropy: number;
+    vivid: number;
+};
+export declare function cardEvidence(px: Rgba, q: Quad, qFrame: Quad, frameW: number, frameH: number): Evidence;

package/dist/types/react/vision/modelsCdn.d.ts

@@ -1,4 +1,4 @@
-export declare const MODELS_VERSION = "v-94761a7cf143";
+export declare const MODELS_VERSION = "v-68335fb410d8";
 export declare const MODELS_CDN = "https://baaslatam.com/sdk-models";
-export declare const DEFAULT_MODELS_URL = "https://baaslatam.com/sdk-models/v-94761a7cf143";
+export declare const DEFAULT_MODELS_URL = "https://baaslatam.com/sdk-models/v-68335fb410d8";
 export declare const modelsUrlOf: (url?: string | null) => string;

package/dist/types/react/vision/types.d.ts

@@ -13,6 +13,7 @@ export interface CardDetection {
     };
     weak?: boolean;
     corners?: FrameCorners;
+    veto?: "geometry" | "edges" | "content";
 }
 export interface SideResult {
     isFront: boolean;
@@ -53,6 +54,7 @@ export interface FaceEngine {
         rx: number;
         ry: number;
     }): Promise<FaceSignals>;
+    faces?(source: HTMLCanvasElement): Promise<import("./face").FaceDetection[]>;
 }
 export interface EngineProgress {
     fraction: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baas-id/react",
-  "version": "0.2.2",
+  "version": "0.2.9",
   "description": "BaaS identity verification for React: guided ID and face capture with on-device quality gating, server-side verdicts, phone handoff. Requires a BaaS account.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "BaaS, S.A.",
@@ -10,13 +10,9 @@
       "email": "support@reporting-pal.com"
     }
   ],
-  "homepage": "https://baaslatam.com/desarrolladores",
-  "repository": {
-    "type": "git",
-    "url": "https://baaslatam.com/desarrolladores"
-  },
+  "homepage": "https://baaslatam.com/developers",
   "bugs": {
-    "url": "https://baaslatam.com/desarrolladores",
+    "url": "https://github.com/baas-id/react/issues",
     "email": "support@reporting-pal.com"
   },
   "keywords": [
@@ -100,5 +96,9 @@
   "publishConfig": {
     "access": "public",
     "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/baas-id/react.git"
   }
 }