@sekyro/elements 0.0.0-stage → 0.1.0-rc.1

package/dist/index.d.cts

@@ -0,0 +1,1115 @@
+import { CapturedArtifacts } from '@sekyro/web';
+import { CaptureError } from '@sekyro/web';
+import { CaptureState } from '@sekyro/web';
+import { DocumentLiveMrzOptions } from '@sekyro/web';
+import { Verification } from '@sekyro/web';
+import { VerificationResult } from '@sekyro/web';
+import { VerificationStep } from '@sekyro/web';
+
+export declare const ATTRIBUTES: readonly [{
+    readonly name: "client-token";
+    readonly property: "clientToken";
+    readonly type: "string | null";
+    readonly description: "The session's client token, from `clientToken` of the session your server created. Ignored while `verification` is set.";
+}, {
+    readonly name: "api-origin";
+    readonly property: "apiOrigin";
+    readonly type: "string | null";
+    readonly description: "The Sekyro AI API origin. Leave it out: the SDK's default is the production API.";
+}, {
+    readonly name: "locale";
+    readonly property: "locale";
+    readonly type: "SekyroLocale | null";
+    readonly description: "The language of the flow: `ar`, `fr`, `en`, `es`, `pt` or `de`. Without it: the page's `<html lang>` when it is one of them, else `en`. Arabic runs right to left.";
+}, {
+    readonly name: "color-scheme";
+    readonly property: "colorScheme";
+    readonly type: "SekyroColorScheme | null";
+    readonly description: "`light` (the default), `dark`, or `system` to follow the device.";
+}, {
+    readonly name: "asset-base-url";
+    readonly property: "assetBaseUrl";
+    readonly type: "string | null";
+    readonly description: "Where your page serves the face detector assets (the `models-v3` files).";
+}, {
+    readonly name: "back-navigation";
+    readonly property: "backNavigation";
+    readonly type: "'history' | 'none' | null";
+    readonly description: "`history` lets the browser's back button go one screen back inside the flow. `none` (the default) never touches the page's history.";
+}, {
+    readonly name: "handoff-url";
+    readonly property: "handoffUrl";
+    readonly type: "string | null";
+    readonly description: "The link a desktop shows as a QR code when a camera step needs a phone (the session's `hostedUrl`). Without it, a notice asks the person to continue on their phone.";
+}, {
+    readonly name: "closable";
+    readonly property: "closable";
+    readonly type: "boolean";
+    readonly boolean: true;
+    readonly description: "Shows the header's close button and the result's back button. Both fire `sekyro-close`; take the person back to your page there.";
+}, {
+    readonly name: "voice";
+    readonly property: "voice";
+    readonly type: "'off' | null";
+    readonly unreflected: true;
+    readonly description: "`off` turns the spoken guidance off. The `voice` property, when set, wins and carries the voice options.";
+}];
+
+/** Server rendering imports this module without a DOM: the class then extends a stand-in and is never defined. */
+declare const BaseElement: typeof HTMLElement;
+
+/** A built-in tip (copy `capture.tips.<id>`, built-in icon). */
+export declare type BuiltInTipId = "light" | "uncover" | "eyeLevel" | "straight";
+
+export { CapturedArtifacts }
+
+export { CaptureError }
+
+export { CaptureState }
+
+/**
+ * Defines `<sekyro-verification>`. Idempotent: a second call, or a tag another copy of the package already defined,
+ * changes nothing. Returns whether the tag is defined after the call (false without a DOM).
+ */
+export declare function defineSekyroElements(): boolean;
+
+export { DocumentLiveMrzOptions }
+
+/** Every event is a `CustomEvent` that bubbles and crosses shadow roots (`composed`). */
+export declare const EVENTS: readonly [{
+    readonly name: "sekyro-ready";
+    readonly type: "SekyroReadyDetail";
+    readonly description: "The element created its `Verification` from `client-token` (detail: `{ verification }`).";
+}, {
+    readonly name: "sekyro-step";
+    readonly type: "VerificationStep";
+    readonly mirrors: "onStep";
+    readonly description: "The flow moved to a step.";
+}, {
+    readonly name: "sekyro-result";
+    readonly type: "VerificationResult";
+    readonly mirrors: "onResult";
+    readonly description: "A verdict for display. Read the decision that counts from your server.";
+}, {
+    readonly name: "sekyro-close";
+    readonly type: "SekyroCloseEvent";
+    readonly mirrors: "onClose";
+    readonly description: "The person closed the flow (`closable` only): `{ reason: 'finished', result }` or `{ reason: 'cancelled' }`.";
+}, {
+    readonly name: "sekyro-liveness-captured";
+    readonly type: "CapturedArtifacts";
+    readonly mirrors: "onLivenessCaptured";
+    readonly description: "The face capture finished, before its upload.";
+}, {
+    readonly name: "sekyro-liveness-state";
+    readonly type: "CaptureState";
+    readonly mirrors: "livenessProps.onStateChange";
+    readonly description: "The face capture's state changed.";
+}, {
+    readonly name: "sekyro-liveness-guidance";
+    readonly type: "StringKey";
+    readonly mirrors: "livenessProps.onGuidance";
+    readonly description: "The face capture shows a guidance line (its string key).";
+}, {
+    readonly name: "sekyro-liveness-error";
+    readonly type: "CaptureError";
+    readonly mirrors: "livenessProps.onError";
+    readonly description: "The face capture failed (camera denied or absent, for example). The flow shows its own screen.";
+}, {
+    readonly name: "sekyro-error";
+    readonly type: "SekyroElementErrorDetail";
+    readonly description: "The element could not create its `Verification` from its attributes (detail: `{ error }`).";
+}];
+
+/** Properties a string attribute cannot carry. */
+export declare const PROPERTIES: readonly [{
+    readonly name: "verification";
+    readonly type: "Verification | null";
+    readonly description: "A `Verification` you created with `createVerification` from `@sekyro/web`. Set, it wins over `client-token`, and your page destroys it. Read, it is the verification the element runs, set or created.";
+}, {
+    readonly name: "strings";
+    readonly type: "Partial<SekyroStrings> | undefined";
+    readonly description: "Copy overrides, keyed like the SDK's strings.";
+}, {
+    readonly name: "theme";
+    readonly type: "SekyroTheme | undefined";
+    readonly description: "A runtime theme. It wins over the session's branding.";
+}, {
+    readonly name: "livenessProps";
+    readonly type: "SekyroElementLivenessOptions | undefined";
+    readonly description: "Options of the face capture step: `autoStart`, `tips`, `tipsSummary`, `coach`, `notice`, `startDisabled`, `startLabel`.";
+}, {
+    readonly name: "documentLiveMrz";
+    readonly type: "DocumentLiveMrzOptions | undefined";
+    readonly description: "Live MRZ reading on the document step: `workerUrl`, `assetBaseUrl`, or `mode: 'off'`.";
+}, {
+    readonly name: "voice";
+    readonly type: "false | VoiceOptions | undefined";
+    readonly description: "Spoken guidance options, or `false` to turn it off.";
+}];
+
+/** What {@link SekyroVerificationProps.onClose} reports. */
+export declare interface SekyroCloseEvent {
+    /**
+     * `finished`: the person is done (the result's "Back to <partner>" button, or the close button on the result page);
+     * `cancelled`: they closed the flow before its result.
+     */
+    reason: "finished" | "cancelled";
+    /** The verdict shown on the result page (`finished` only). Display only: read the real outcome on your server. */
+    result?: VerificationResult;
+}
+
+/** `system` follows the device (prefers-color-scheme). */
+export declare type SekyroColorScheme = "light" | "dark" | "system";
+
+/** `detail` of `sekyro-error`. */
+export declare interface SekyroElementErrorDetail {
+    error: unknown;
+}
+
+/**
+ * Options of the face capture step (the `livenessProps` of `<SekyroVerification>` that are data). Its callbacks are
+ * the element's `sekyro-liveness-*` events.
+ */
+export declare interface SekyroElementLivenessOptions {
+    /** Start the camera without the intro's start button: `true`, or `"when-permitted"` once the camera is allowed. */
+    autoStart?: boolean | "when-permitted";
+    /** A notice above the start button. */
+    notice?: SekyroElementNotice;
+    /** Keep the start button disabled (your page shows why). */
+    startDisabled?: boolean;
+    /** The start button's label. */
+    startLabel?: string;
+    /** The intro's tips: `false` hides them; a list picks built-in tips or adds yours. */
+    tips?: false | ReadonlyArray<BuiltInTipId | SekyroElementTip>;
+    /** The spoken summary of the tips. */
+    tipsSummary?: string;
+    /** A coaching line under the camera, or `null` for none. */
+    coach?: string | null;
+}
+
+/** A notice above the face capture's start button (plain text). */
+export declare interface SekyroElementNotice {
+    /** `info` is a polite status; `warning` and `danger` are announced as alerts. */
+    tone: "info" | "warning" | "danger";
+    text: string;
+}
+
+/** A tip of your own on the face capture's intro (plain text). */
+export declare interface SekyroElementTip {
+    /** A stable id. */
+    id: string;
+    text: string;
+}
+
+/**
+ * The end-user locales (spec 2026-10-29 §9), every screen translated in each. ar/fr/en are built in; es/pt/de load
+ * lazily (`loadSekyroLocale`) as complete overlays over English.
+ */
+export declare type SekyroLocale = "ar" | "fr" | "en" | "es" | "pt" | "de";
+
+/** `detail` of `sekyro-ready`. */
+export declare interface SekyroReadyDetail {
+    verification: Verification;
+}
+
+export declare type SekyroStrings = Strings & StepStrings;
+
+/** Theme shape accepted by {@link SekyroThemeProvider}. Partial: unset tokens keep the defaults. */
+export declare interface SekyroTheme {
+    /** Color tokens to override. */
+    colors?: Partial<SekyroThemeColors>;
+    /** Corner radius of panels and buttons (CSS length). */
+    radius?: string;
+    /** Font stack for all component text. */
+    fontFamily?: string;
+}
+
+/** Color tokens. Every value is any valid CSS `<color>`. */
+declare interface SekyroThemeColors {
+    /** Primary action surface (buttons, filled ring ticks). */
+    brand: string;
+    /** Text on `brand`. */
+    brandFg: string;
+    /** Primary text; also the capture-stage scrim. */
+    fg: string;
+    /** Secondary text (hints, notes) — never essential instructions. */
+    fgMuted: string;
+    /** Page background behind the component. */
+    bg: string;
+    /** Card / panel surface the component sits on; also the text on the scrim. */
+    surface: string;
+    /** Focus ring. */
+    ring: string;
+    /**
+     * Error accents (notice border / tint).
+     *
+     * @deprecated Status colours are standard since 0.1.0-rc.13; this key is ignored in a theme you pass and will be
+     * removed in 1.0. {@link DEFAULT_THEME} still lists the Sekyro value.
+     */
+    danger: string;
+    /**
+     * Gate-locked ring + success accents.
+     *
+     * @deprecated Status colours are standard since 0.1.0-rc.13; this key is ignored in a theme you pass and will be
+     * removed in 1.0. {@link DEFAULT_THEME} still lists the Sekyro value.
+     */
+    success: string;
+    /**
+     * Draining-ring and retry-notice accents.
+     *
+     * @deprecated Status colours are standard since 0.1.0-rc.13; this key is ignored in a theme you pass and will be
+     * removed in 1.0. {@link DEFAULT_THEME} still lists the Sekyro value.
+     */
+    warning: string;
+}
+
+/** The attributes, as a template in Vue, Angular, Svelte or JSX writes them. */
+export declare interface SekyroVerificationAttributes {
+    "client-token"?: string;
+    "api-origin"?: string;
+    locale?: SekyroLocale;
+    "color-scheme"?: SekyroColorScheme;
+    "asset-base-url"?: string;
+    "back-navigation"?: "history" | "none";
+    "handoff-url"?: string;
+    closable?: boolean | "";
+    voice?: "off";
+    dir?: "ltr" | "rtl";
+}
+
+export declare class SekyroVerificationElement extends BaseElement {
+    #private;
+    static readonly observedAttributes: readonly string[];
+    constructor();
+    get clientToken(): string | null;
+    set clientToken(value: string | null);
+    get apiOrigin(): string | null;
+    set apiOrigin(value: string | null);
+    get locale(): SekyroLocale | null;
+    set locale(value: SekyroLocale | null);
+    get colorScheme(): SekyroColorScheme | null;
+    set colorScheme(value: SekyroColorScheme | null);
+    get assetBaseUrl(): string | null;
+    set assetBaseUrl(value: string | null);
+    get backNavigation(): "history" | "none" | null;
+    set backNavigation(value: "history" | "none" | null);
+    get handoffUrl(): string | null;
+    set handoffUrl(value: string | null);
+    get closable(): boolean;
+    set closable(value: boolean);
+    /** The verification the element runs: the one you set, else the one it created from `client-token`. */
+    get verification(): Verification | null;
+    set verification(value: Verification | null);
+    get strings(): Partial<SekyroStrings> | undefined;
+    set strings(value: Partial<SekyroStrings> | undefined);
+    get theme(): SekyroTheme | undefined;
+    set theme(value: SekyroTheme | undefined);
+    get livenessProps(): SekyroElementLivenessOptions | undefined;
+    set livenessProps(value: SekyroElementLivenessOptions | undefined);
+    get documentLiveMrz(): DocumentLiveMrzOptions | undefined;
+    set documentLiveMrz(value: DocumentLiveMrzOptions | undefined);
+    /** Spoken guidance options, or `false`. Unset, the `voice="off"` attribute turns it off. */
+    get voice(): false | VoiceOptions | undefined;
+    set voice(value: false | VoiceOptions | undefined);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(_name: string, previous: string | null, next: string | null): void;
+}
+
+/** What the element accepts as properties: what `<SekyroVerification>` takes, as plain data. */
+export declare interface SekyroVerificationElementProperties {
+    clientToken: string | null;
+    apiOrigin: string | null;
+    locale: SekyroLocale | null;
+    colorScheme: SekyroColorScheme | null;
+    assetBaseUrl: string | null;
+    backNavigation: "history" | "none" | null;
+    handoffUrl: string | null;
+    closable: boolean;
+    verification: Verification | null;
+    strings: Partial<SekyroStrings> | undefined;
+    theme: SekyroTheme | undefined;
+    livenessProps: SekyroElementLivenessOptions | undefined;
+    documentLiveMrz: DocumentLiveMrzOptions | undefined;
+    voice: false | VoiceOptions | undefined;
+}
+
+/** The `detail` of each event the element fires. */
+export declare interface SekyroVerificationEventMap {
+    "sekyro-ready": SekyroReadyDetail;
+    "sekyro-step": VerificationStep;
+    "sekyro-result": VerificationResult;
+    "sekyro-close": SekyroCloseEvent;
+    "sekyro-liveness-captured": CapturedArtifacts;
+    "sekyro-liveness-state": CaptureState;
+    "sekyro-liveness-guidance": StringKey;
+    "sekyro-liveness-error": CaptureError;
+    "sekyro-error": SekyroElementErrorDetail;
+}
+
+export declare type SekyroVerificationEventName = keyof SekyroVerificationEventMap;
+
+/** The events as `CustomEvent`s, for `addEventListener` typing. */
+export declare type SekyroVerificationEvents = {
+    [K in SekyroVerificationEventName]: CustomEvent<SekyroVerificationEventMap[K]>;
+};
+
+/** Light DOM children with a `slot` attribute, moved into the flow when it renders. */
+export declare const SLOTS: readonly [{
+    readonly name: "header";
+    readonly description: "Replaces the partner header.";
+}, {
+    readonly name: "header-end";
+    readonly description: "Sits at the inline end of the partner header, before the close button (a language menu).";
+}, {
+    readonly name: "footer";
+    readonly description: "Replaces the \"Verified by Sekyro AI\" link. An empty element hides it.";
+}];
+
+/** Copy of the `@sekyro/react/verification` steps (hosted catalog paths; the optional keys load with their step). */
+declare interface StepStrings {
+    "session.title": string;
+    "session.requestedBy": string;
+    "returning.requestedBy": string;
+    "consent.notice": string;
+    "consent.details": string;
+    "consent.terms.intro": string;
+    "consent.terms.data": string;
+    "consent.terms.processing": string;
+    "consent.terms.sharing": string;
+    "consent.terms.retention": string;
+    "capture.modeSwitch.toSelfPhoto": string;
+    "capture.modeSwitch.toAssistedLabelPhoto": string;
+    "capture.modeSwitch.toSelfLabelPhoto": string;
+    "reasons.camera_unavailable": string;
+    "otp.sendTitle": string;
+    "otp.sendDescription": string;
+    "otp.prefilledNotice": string;
+    "otp.phoneLabel": string;
+    "otp.phoneHelper": string;
+    "otp.phonePlaceholder": string;
+    "otp.send": string;
+    "otp.channelSms": string;
+    "otp.channelWhatsapp": string;
+    "otp.verifyTitle": string;
+    "otp.verifyDescription": string;
+    "otp.sentTo": string;
+    "otp.codeLabel": string;
+    "otp.codeHelper": string;
+    "otp.verify": string;
+    "otp.resend": string;
+    "otp.resendIn": string;
+    "otp.expiresIn": string;
+    "otp.expired": string;
+    "otp.reason_otp_mismatch": string;
+    "otp.reason_otp_expired": string;
+    "otp.reason_otp_send_failed": string;
+    "otp.chooseChannel": string;
+    "otp.sendBy": string;
+    "otp.resendBy": string;
+    "otp.sending": string;
+    "otp.reason_otp_channel_unavailable": string;
+    "otp.reason_otp_destination_not_allowed": string;
+    "otp.reason_otp_destination_unknown": string;
+    "otp.reason_otp_rate_limited": string;
+    "otp.reason_otp_daily_cap_reached": string;
+    "otp.reason_payment_method_required": string;
+    "otp.reason_spend_cap_reached": string;
+    "otp.reason_insufficient_balance": string;
+    "otp.phonePlaceholderGeneric": string;
+    "otp.countryLabel": string;
+    "otp.phoneLengthError": string;
+    "otp.or": string;
+    "otp.otherCountry": string;
+    "otp.reason_otp_number_invalid": string;
+    "otp.reason_otp_number_not_mobile": string;
+    "session.steps.population.title": string;
+    "session.steps.population.description": string;
+    "population.label": string;
+    "population.helper": string;
+    "population.placeholder": string;
+    "population.submit": string;
+    "population.invalid": string;
+    "population.reason_registry_unavailable": string;
+    "population.reason_nni_not_found": string;
+    "population.reason_nni_invalid": string;
+    "population.bound.description": string;
+    "population.bound.confirm": string;
+    "population.reason_nni_not_found_or_document": string;
+    "population.useDocument": string;
+    "population.fromDocument.title": string;
+    "population.fromDocument.description": string;
+    "population.fromDocument.continue": string;
+    "population.reason_id_number_invalid": string;
+    "population.reason_registry_record_not_found": string;
+    "population.reason_registry_record_not_found_or_document": string;
+    "session.steps.doc.titleRecto": string;
+    "session.steps.doc.titleVerso": string;
+    "session.steps.doc.description": string;
+    "doc.pickTitle": string;
+    "doc.pickDescription": string;
+    "doc.pickLabel": string;
+    "doc.startScan": string;
+    "doc.titlePassport": string;
+    "doc.reason_side_missing": string;
+    "doc.reason_unreadable": string;
+    "doc.process_failed": string;
+    "doc.uploading": string;
+    "doc.cameraBlocked": string;
+    "doc.cameraBlockedHint": string;
+    "doc.retryCamera": string;
+    "doc.holdUpright": string;
+    "doc.ageStepUp": string;
+    "reasons.underage_estimated": string;
+    "reasons.starter_credit_claimed": string;
+    "reasons.blocked_by_org": string;
+    "dcv2.sensing": string;
+    "dcv2.too_far": string;
+    "dcv2.too_close": string;
+    "dcv2.edge_clipped": string;
+    "dcv2.wrong_shape": string;
+    "dcv2.tilted": string;
+    "dcv2.too_dark": string;
+    "dcv2.too_bright": string;
+    "dcv2.blurry": string;
+    "dcv2.focus_far": string;
+    "dcv2.glare": string;
+    "dcv2.hold_still": string;
+    "dcv2.processing": string;
+    "dcv2.side_captured": string;
+    "dcv2.captured": string;
+    "session.processing.title": string;
+    "session.processing.description": string;
+    "handoff.title": string;
+    "handoff.lead.document": string;
+    "handoff.lead.portrait": string;
+    "capture.source.phone": string;
+    "session.processing.age_estimation.title": string;
+    "session.processing.age_estimation.description": string;
+    "session.result.review.title": string;
+    "session.result.review.description": string;
+    "session.result.rejected.title": string;
+    "session.result.rejected.description": string;
+    "session.result.expired.title": string;
+    "session.result.expired.description": string;
+    "session.result.detailsMismatch": string;
+    "session.result.deviceVelocity": string;
+    "session.result.verified.title": string;
+    "session.result.verified.description": string;
+    "session.result.inconclusive.title": string;
+    "session.result.inconclusive.description": string;
+    "session.result.unavailable.title": string;
+    "session.result.unavailable.description": string;
+    "session.result.policy.title": string;
+    "session.result.policy.description": string;
+    "session.result.cooldown.title": string;
+    "session.result.cooldown.description": string;
+    "session.result.deviceStop": string;
+    "result.referenceLabel": string;
+    "capture.retrySamePerson.message": string;
+    "capture.retryMatch.message": string;
+    "common.loading": string;
+    "common.refresh": string;
+    "common.noAttemptsLeft": string;
+    "session.steps.portrait.title": string;
+    "session.steps.portrait.description": string;
+    "portrait.coach.no_face": string;
+    "portrait.coach.multiple_faces": string;
+    "portrait.coach.center": string;
+    "portrait.coach.too_close": string;
+    "portrait.coach.pose": string;
+    "portrait.coach.eyes": string;
+    "portrait.coach.mouth": string;
+    "portrait.coach.glare": string;
+    "portrait.coach.lighting": string;
+    "portrait.coach.lighting_side": string;
+    "portrait.coach.background": string;
+    "portrait.coach.resolution": string;
+    "portrait.coach.hold_still": string;
+    "portrait.coach.hold": string;
+    "portrait.criteria.face": string;
+    "portrait.criteria.framing": string;
+    "portrait.criteria.pose": string;
+    "portrait.criteria.eyes": string;
+    "portrait.criteria.mouth": string;
+    "portrait.criteria.glare": string;
+    "portrait.criteria.lighting": string;
+    "portrait.criteria.background": string;
+    "portrait.criteria.resolution": string;
+    "portrait.criteria.sharpness": string;
+    "portrait.report.pose": string;
+    "portrait.report.eyes": string;
+    "portrait.report.mouth": string;
+    "portrait.report.occlusion": string;
+    "portrait.report.glare": string;
+    "portrait.report.lighting": string;
+    "portrait.report.background": string;
+    "portrait.report.resolution": string;
+    "portrait.checksLabel": string;
+    "portrait.met": string;
+    "portrait.notMet": string;
+    "portrait.starting": string;
+    "portrait.taken": string;
+    "portrait.uploading": string;
+    "portrait.checking": string;
+    "portrait.retryTitle": string;
+    "portrait.reportTitle": string;
+    "portrait.retake": string;
+    "portrait.uploadFailed": string;
+    "portrait.sendAgain": string;
+    "portrait.matching": string;
+    "portrait.reviewTitle": string;
+    "portrait.reviewDescription": string;
+    "portrait.cameraBlocked": string;
+    "portrait.cameraBlockedHint": string;
+    "portrait.retryCamera": string;
+    "reasons.icao_pose": string;
+    "reasons.icao_eyes": string;
+    "reasons.icao_mouth": string;
+    "reasons.icao_occlusion": string;
+    "reasons.icao_lighting": string;
+    "reasons.icao_background": string;
+    "reasons.icao_resolution": string;
+    "reasons.portrait_not_from_liveness": string;
+    "reasons.tester_document_mismatch": string;
+    "reasons.tester_phone_mismatch": string;
+    "method.national_eid": string;
+    "method.national_eidGeneric": string;
+    "consent.short": string;
+    "consent.termsLink": string;
+    "session.progressLabel": string;
+    "section.contact": string;
+    "section.identity": string;
+    "section.live_photo": string;
+    "section.screening": string;
+    "handoff.copied": string;
+    "needsApp.title": string;
+    "needsApp.description": string;
+    "needsApp.descriptionNoOrg": string;
+    "consent.termsTitle": string;
+    "leave.title": string;
+    "leave.body": string;
+    "leave.confirm": string;
+    "leave.stay": string;
+    "otp.changeNumber": string;
+    "otp.backToCode": string;
+    "otp.reason_otp_resend_limit": string;
+    "reasons.otp_resend_limit": string;
+    "common.back": string;
+    "capture.assisted.heading": string;
+    "returning.heading": string;
+    "capture.checkingTitle": string;
+    "method.heading": string;
+    "sandbox.otpHint": string;
+    "sandbox.skipCapture": string;
+    "app.sandboxBadge": string;
+    "population.recheck.title": string;
+    "population.recheck.description": string;
+    "otp.phoneInvalid": string;
+    "otp.codeInvalid": string;
+    "doc.countryTitle": string;
+    "doc.countryLabel": string;
+    "doc.countrySearch": string;
+    "doc.noCountryMatch": string;
+    "doc.type.carte_identite": string;
+    "doc.type.residence_permit": string;
+    "doc.type.passport": string;
+    "doc.showSide": string;
+    "doc.showPage": string;
+    "doc.flip": string;
+    "doc.sameFace": string;
+    "doc.reaskRecto": string;
+    "doc.reread": string;
+    "doc.photoTaken": string;
+    "doc.frontCaptured": string;
+    "doc.backCaptured": string;
+    "doc.pageCaptured": string;
+    "doc.progressFront": string;
+    "doc.progressBack": string;
+    "doc.progressPage": string;
+    "doc.shutter": string;
+    "doc.torchOn": string;
+    "doc.torchOff": string;
+    "result.platform_unsupported": string;
+    "unsupported.title": string;
+    "unsupported.description": string;
+    "shell.subtitle": string;
+    "shell.subtitleHuman": string;
+    "shell.verifiedBy": string;
+    "doc.sub.carte_identite": string;
+    "doc.sub.residence_permit": string;
+    "doc.sub.passport": string;
+    "native.close": string;
+    "native.face.introTitle": string;
+    "native.face.introLead": string;
+    "native.face.humanIntroTitle": string;
+    "native.face.humanIntroLead": string;
+    "native.doc.holdIt": string;
+    "native.doc.changeCountry": string;
+    "native.result.review": string;
+    "native.result.rejected": string;
+    "native.result.expired": string;
+    "native.result.copied": string;
+    "native.result.back": string;
+    "native.result.verified": string;
+    "native.result.inconclusive": string;
+    "native.result.unavailable": string;
+    "native.result.policy": string;
+    "emailOtp.reason_otp_daily_cap_reached"?: string;
+    "emailOtp.sendTitle"?: string;
+    "emailOtp.sendDescription"?: string;
+    "emailOtp.prefilledNotice"?: string;
+    "emailOtp.emailLabel"?: string;
+    "emailOtp.emailHelper"?: string;
+    "emailOtp.emailPlaceholder"?: string;
+    "emailOtp.emailInvalid"?: string;
+    "emailOtp.send"?: string;
+    "emailOtp.verifyTitle"?: string;
+    "emailOtp.verifyDescription"?: string;
+    "emailOtp.sentTo"?: string;
+    "emailOtp.codeLabel"?: string;
+    "emailOtp.codeHelper"?: string;
+    "emailOtp.verify"?: string;
+    "emailOtp.resend"?: string;
+    "emailOtp.resendIn"?: string;
+    "emailOtp.expiresIn"?: string;
+    "emailOtp.expired"?: string;
+    "emailOtp.reason_otp_mismatch"?: string;
+    "emailOtp.reason_otp_expired"?: string;
+    "emailOtp.reason_otp_send_failed"?: string;
+    "emailOtp.reason_otp_rate_limited"?: string;
+    "emailOtp.reason_email_invalid"?: string;
+    "emailOtp.reason_email_disposable"?: string;
+    "emailOtp.changeEmail"?: string;
+    "emailOtp.backToCode"?: string;
+    "emailOtp.reason_otp_resend_limit"?: string;
+    "eid.identifierTitle"?: string;
+    "eid.identifierTitleGeneric"?: string;
+    "eid.identifierDescription"?: string;
+    "eid.identifierDescriptionGeneric"?: string;
+    "eid.boundDescription"?: string;
+    "eid.boundDescriptionGeneric"?: string;
+    "eid.start"?: string;
+    "eid.codeTitle"?: string;
+    "eid.codeTitleGeneric"?: string;
+    "eid.codeHelp"?: string;
+    "eid.codeHelpGeneric"?: string;
+    "eid.codeLabel"?: string;
+    "eid.verify"?: string;
+    "eid.resend"?: string;
+    "eid.resendIn"?: string;
+    "eid.noResendsLeft"?: string;
+    "eid.expiresIn"?: string;
+    "eid.expired"?: string;
+    "eid.useCamera"?: string;
+    "reasons.eid_identifier_invalid"?: string;
+    "reasons.eid_code_invalid"?: string;
+    "reasons.eid_code_expired"?: string;
+    "reasons.eid_locked"?: string;
+    "reasons.eid_not_enrolled"?: string;
+    "reasons.eid_unavailable"?: string;
+    "reasons.eid_resend_too_soon"?: string;
+    "reasons.eid_resend_limit"?: string;
+    "eid.continueHint"?: string;
+    "eid.continueHintGeneric"?: string;
+    "eid.resendsRemaining.zero"?: string;
+    "eid.resendsRemaining.one"?: string;
+    "eid.resendsRemaining.two"?: string;
+    "eid.resendsRemaining.few"?: string;
+    "eid.resendsRemaining.many"?: string;
+    "eid.resendsRemaining.other"?: string;
+    "eid.codeAttemptsRemaining.zero"?: string;
+    "eid.codeAttemptsRemaining.one"?: string;
+    "eid.codeAttemptsRemaining.two"?: string;
+    "eid.codeAttemptsRemaining.few"?: string;
+    "eid.codeAttemptsRemaining.many"?: string;
+    "eid.codeAttemptsRemaining.other"?: string;
+    "dcv3.mrz.searching"?: string;
+    "dcv3.mrz.showMrzSide"?: string;
+    "dcv3.mrz.reading"?: string;
+    "dcv3.mrz.moveCloser"?: string;
+    "dcv3.mrz.turnSideways"?: string;
+    "dcv3.mrz.glare"?: string;
+    "dcv3.mrz.holdStill"?: string;
+    "dcv3.mrz.valid"?: string;
+    "dcv3.mrz.looksLikePassport"?: string;
+    "dcv3.mrz.looksLikeCard"?: string;
+    "portrait.source.title"?: string;
+    "portrait.source.description"?: string;
+    "portrait.source.camera"?: string;
+    "portrait.source.upload"?: string;
+    "portrait.source.uploadInstead"?: string;
+    "portrait.upload.title"?: string;
+    "portrait.upload.hint"?: string;
+    "portrait.upload.choose"?: string;
+    "portrait.upload.unsupported"?: string;
+    "portrait.upload.failed"?: string;
+    "portrait.review.title"?: string;
+    "portrait.review.description"?: string;
+    "portrait.review.original"?: string;
+    "portrait.review.fixed"?: string;
+    "portrait.review.fixesTitle"?: string;
+    "portrait.review.accept"?: string;
+    "portrait.review.retake"?: string;
+    "portrait.review.uploadAnother"?: string;
+    "portrait.fixes.crop"?: string;
+    "portrait.fixes.scale"?: string;
+    "portrait.fixes.straighten"?: string;
+    "portrait.fixes.background"?: string;
+    "portrait.fixes.exposure"?: string;
+    "portrait.fixes.white_balance"?: string;
+    "reasons.portrait_morph_suspected"?: string;
+    "reasons.portrait_reference_mismatch"?: string;
+    "reasons.portrait_declined_fix"?: string;
+    "doc.uploadInstead"?: string;
+    "doc.uploadTitle"?: string;
+    "doc.uploadHint"?: string;
+    "doc.uploadUnsupported"?: string;
+    "doc.uploadFailed"?: string;
+    "doc.source.title"?: string;
+    "doc.source.description"?: string;
+    "doc.source.camera"?: string;
+    "doc.source.upload"?: string;
+    "native.doc.introTitle"?: string;
+    "native.doc.introLead"?: string;
+    "native.doc.tip.flat"?: string;
+    "native.doc.tip.glare"?: string;
+    "native.doc.tip.frame"?: string;
+    "native.doc.openCamera"?: string;
+    "native.doc.changeDocument"?: string;
+    "native.scan.closer"?: string;
+    "native.scan.farther"?: string;
+    "native.scan.glare"?: string;
+    "native.scan.dark"?: string;
+    "native.scan.blurry"?: string;
+    "native.scan.holdStill"?: string;
+    "native.scan.reading"?: string;
+    "native.scan.putDown"?: string;
+    "native.scan.retry"?: string;
+    "consent.human.terms.intro"?: string;
+    "consent.human.terms.data"?: string;
+    "consent.human.terms.processing"?: string;
+    "consent.human.terms.sharing"?: string;
+    "consent.human.terms.retention"?: string;
+    "capture.noCamera.title"?: string;
+    "capture.noCamera.body"?: string;
+    "capture.noCamera.continue"?: string;
+    "capture.noCamera.deniedTitle"?: string;
+    "capture.noCamera.deniedBody"?: string;
+    "choice.title"?: string;
+    "choice.description"?: string;
+    "choice.switch"?: string;
+    "contact.title"?: string;
+    "contact.description"?: string;
+    "contact.phone"?: string;
+    "contact.email"?: string;
+    "contact.switch"?: string;
+    "summary.title"?: string;
+    "summary.description"?: string;
+    "summary.fullName"?: string;
+    "summary.birthDate"?: string;
+    "summary.nationality"?: string;
+    "summary.documentType"?: string;
+    "summary.documentNumber"?: string;
+    "summary.nni"?: string;
+    "summary.id_number"?: string;
+    "summary.expiryDate"?: string;
+    "summary.portraitAlt"?: string;
+    "summary.source.registry"?: string;
+    "summary.source.document"?: string;
+    "summary.source.chip"?: string;
+    "summary.name"?: string;
+    "summary.birthYear"?: string;
+    "summary.confirm"?: string;
+    "summary.retakeDocument"?: string;
+    "summary.retakeNationalNumber"?: string;
+    "summary.noRetake"?: string;
+    "capture.tipsIcao.title"?: string;
+    "capture.tipsIcao.glasses"?: string;
+    "capture.tipsIcao.headwear"?: string;
+    "capture.tipsIcao.expression"?: string;
+    "capture.tipsIcao.faceCamera"?: string;
+    "capture.tipsIcao.background"?: string;
+    "capture.tipsIcao.lighting"?: string;
+    "capture.tipsIcao.hair"?: string;
+    "capture.tipsIcao.summary"?: string;
+    "portrait.retakeOnly"?: string;
+    "portrait.keepCamera"?: string;
+    "handoff.description"?: string;
+    "handoff.qrAlt"?: string;
+    "handoff.copyLink"?: string;
+    "handoff.copyFailed"?: string;
+    "handoff.waiting"?: string;
+    "inApp.title"?: string;
+    "inApp.description"?: string;
+    "inApp.copyLink"?: string;
+    "inApp.copied"?: string;
+    "inApp.copyFailed"?: string;
+    "inApp.continueAnyway"?: string;
+    "inApp.openBrowser"?: string;
+    "testerGate.action"?: string;
+    "testerGate.title"?: string;
+    "testerGate.body"?: string;
+    "testerGate.start"?: string;
+    "testerGate.checking"?: string;
+    "testerGate.boundTitle"?: string;
+    "testerGate.boundBody"?: string;
+    "testerGate.missTitle"?: string;
+    "testerGate.missBody"?: string;
+    "testerGate.retry"?: string;
+    "testerGate.continueTest"?: string;
+    "testerGate.continue"?: string;
+    "testerGate.limitBody"?: string;
+    "testerGate.exhaustedBody"?: string;
+    "testerGate.closedBody"?: string;
+}
+
+/** Every string key the component renders. */
+export declare type StringKey = keyof Strings;
+
+/**
+ * Every string the component renders, keyed like the hosted message catalog
+ * (`capture.*`, `fcv2.err.*`, `fcv3.*`, `reasons.*`, `errors.*`, `common.*`).
+ * The built-in ar/fr/en dictionaries are complete; `strings` overrides are
+ * `Partial<Strings>`.
+ */
+declare interface Strings {
+    "capture.start": string;
+    "capture.recordAgain": string;
+    "capture.switchCamera": string;
+    "capture.preparing.title": string;
+    "capture.checking": string;
+    "capture.checkingHint": string;
+    "capture.securityNote": string;
+    "capture.cameraOff": string;
+    "capture.previewAlt": string;
+    "capture.retryCoaching.title": string;
+    "capture.retryCoaching.light": string;
+    "capture.retryCoaching.eyeLevel": string;
+    "capture.retryCoaching.head": string;
+    /**
+     * A retake whose reason is not about the face or the light (2026-11-08): this title, then the reason's own tips
+     * instead of the lighting coaching (`retryCoachingOf` in captured-panel.tsx).
+     */
+    "capture.retryTips.title": string;
+    /** `multiple_faces`: one person in the frame. */
+    "capture.retryOneFace.alone": string;
+    "capture.retryOneFace.screens": string;
+    /** `capture_back_camera` (self capture on the back camera): which camera is the front one. */
+    "capture.retryFrontCamera.screenSide": string;
+    /** `capture_front_camera` (assisted capture on the front camera): which camera is the back one, and where to hold it. */
+    "capture.retryBackCamera.backSide": string;
+    "capture.retryBackCamera.circle": string;
+    /** `capture_not_upright`: how to hold the phone, and for how long. */
+    "capture.retryUpright.vertical": string;
+    "capture.retryUpright.untilEnd": string;
+    /** `media_unreadable` / `clip_too_short`: let the recording finish and reach us. */
+    "capture.retryRecording.cameraOn": string;
+    "capture.retryRecording.stay": string;
+    "capture.retryRecording.network": string;
+    /** `device_integrity_failed`: what makes a device check fail, said plainly. */
+    "capture.retryDevice.screenRecording": string;
+    "capture.retryDevice.phone": string;
+    /**
+     * Remaining-attempts line per CLDR plural category (`Intl.PluralRules`),
+     * `{count}` = the locale-formatted number. `one`/`other` are required; the
+     * other categories fall back to `other` where the locale never selects them.
+     */
+    "capture.attemptsRemaining.one": string;
+    "capture.attemptsRemaining.other": string;
+    "capture.attemptsRemaining.zero"?: string;
+    "capture.attemptsRemaining.two"?: string;
+    "capture.attemptsRemaining.few"?: string;
+    "capture.attemptsRemaining.many"?: string;
+    "common.retry": string;
+    "fcv2.err.permission": string;
+    "fcv2.err.notfound": string;
+    "fcv2.err.inuse": string;
+    "fcv2.err.insecure": string;
+    "fcv2.err.unsupported": string;
+    "fcv2.err.generic": string;
+    "fcv3.no_face": string;
+    "fcv3.come_closer": string;
+    "fcv3.move_back": string;
+    "fcv3.center_face": string;
+    "fcv3.straighten": string;
+    "fcv3.more_light": string;
+    "fcv3.too_bright": string;
+    "fcv3.hold_still": string;
+    "fcv3.steady_camera": string;
+    /** The phone shows a landscape frame (hint `upright`): the gate waits until it is held upright. */
+    "fcv3.hold_upright": string;
+    /** A second person of meaningful size is in the frame (hint `one_face`): the gate waits until one face remains. */
+    "fcv3.one_face": string;
+    "reasons.no_face": string;
+    "reasons.media_unreadable": string;
+    "reasons.clip_too_short": string;
+    "reasons.spoof_detected": string;
+    "reasons.review_band": string;
+    "reasons.nni_not_found": string;
+    "reasons.nni_invalid": string;
+    "reasons.registry_unavailable": string;
+    "reasons.no_face_source": string;
+    "reasons.no_face_reference": string;
+    "reasons.low_quality_reference": string;
+    "reasons.below_threshold": string;
+    "reasons.side_missing": string;
+    "reasons.mrz_checksum_failed": string;
+    "reasons.unreadable": string;
+    "reasons.expired_document": string;
+    "reasons.authenticity_review": string;
+    "reasons.registry_mismatch": string;
+    "reasons.document_nni_mismatch": string;
+    "reasons.id_number_invalid": string;
+    "reasons.registry_record_not_found": string;
+    "reasons.document_id_number_mismatch": string;
+    "reasons.otp_mismatch": string;
+    "reasons.otp_expired": string;
+    "reasons.otp_send_failed": string;
+    "reasons.uncalibrated_capture_channel": string;
+    "reasons.capture_back_camera": string;
+    "reasons.capture_not_upright": string;
+    "reasons.capture_front_camera": string;
+    /** The service saw a second person in the liveness clip: a free retake. */
+    "reasons.multiple_faces": string;
+    "reasons.location_not_allowed": string;
+    "reasons.anonymizer_blocked": string;
+    "reasons.nationality_not_allowed": string;
+    "reasons.document_type_not_accepted": string;
+    "reasons.underage": string;
+    "reasons.age_unverifiable": string;
+    "reasons.nationality_unreadable": string;
+    "reasons.name_mismatch": string;
+    "reasons.birth_date_mismatch": string;
+    "reasons.nationality_mismatch": string;
+    "reasons.document_number_mismatch": string;
+    "reasons.liveness_inconclusive": string;
+    "reasons.match_inconclusive": string;
+    "hints.appearance": string;
+    "hints.motion": string;
+    "hints.lighting": string;
+    "hints.framing": string;
+    "reasons.subject_revoked": string;
+    "reasons.probe_not_from_liveness": string;
+    "reasons.document_authenticity": string;
+    "reasons.mobile_required": string;
+    "reasons.capture_tampered": string;
+    "reasons.device_velocity_exceeded": string;
+    /** `device_cooldown` without a usable `retryAfter`. */
+    "reasons.device_cooldown": string;
+    /** `device_cooldown`, `{time}` = a relative time ("in 5 minutes"). */
+    "cooldown.retryIn": string;
+    /** `device_cooldown`, `{time}` = a clock time (with the date when not today). */
+    "cooldown.retryAt": string;
+    /** The model service is busy and the SDK retries by itself. */
+    "capture.busy": string;
+    "errors.inference_unavailable": string;
+    "method.title": string;
+    "method.description": string;
+    /** Returning-user session (profile v2 step 5): the intro title + one line. */
+    "returning.title": string;
+    "returning.description": string;
+    "method.national_number": string;
+    "method.document_photo": string;
+    "errors.method_required": string;
+    "errors.attestation_invalid": string;
+    "errors.network_error": string;
+    "errors.session_expired": string;
+    "errors.nni_unbound": string;
+    "errors.id_number_unbound": string;
+    "capture.tips.title": string;
+    "capture.tips.light": string;
+    "capture.tips.uncover": string;
+    "capture.tips.eyeLevel": string;
+    "capture.tips.straight": string;
+    /** Spoken by the pre-capture "Listen" button (voice key `capture.tips.summary`); says what the built-in tips say. */
+    "capture.tips.summary": string;
+    "capture.tips.listen": string;
+    /** The Listen button's label while the summary plays. */
+    "capture.tips.stop": string;
+    "capture.permission.granted": string;
+    "capture.permission.prompt": string;
+    "capture.permission.denied": string;
+    "capture.permission.unknown": string;
+    "capture.cameraLabel": string;
+    "capture.facing.user": string;
+    "capture.facing.environment": string;
+    /** Assisted capture (an agent films the person): the pre-capture title and lead, and the line under the stage. */
+    "capture.assisted.title": string;
+    "capture.assisted.lead": string;
+    "capture.assisted.stage": string;
+    /** Capture mode `choice` (design 2026-11-04 §4.5): who films, asked once before the first camera step. */
+    "capture.modeSwitch.toAssisted": string;
+    "capture.modeSwitch.toSelf": string;
+    "capture.modeSwitch.toAssistedLabel": string;
+    "capture.modeSwitch.toSelfLabel": string;
+    "capture.modeSwitch.restarted": string;
+    "capture.voiceGuidance": string;
+    "capture.preparing.hint": string;
+    "capture.ready": string;
+    "fcv2.err.models": string;
+    "fcv2.err.backcamera": string;
+}
+
+export declare const TAG_NAME = "sekyro-verification";
+
+export { Verification }
+
+export { VerificationResult }
+
+export { VerificationStep }
+
+/**
+ * Clip URLs per locale and key — e.g. the map a backend hands the SDK in the
+ * session view. A new object identity is the change signal.
+ */
+declare type VoiceClipMap = {
+    readonly [L in SekyroLocale]?: {
+        readonly [K in VoiceKey]?: string | null | undefined;
+    } | undefined;
+};
+
+/** Resolve a voice clip URL; `null`/`undefined` = no clip (speech fallback applies). */
+declare type VoiceClipResolver = (key: VoiceKey, locale: SekyroLocale) => string | null | undefined;
+
+/** `voice.clips`: a resolver function or a `{ [locale]: { [voiceKey]: url } }` map. */
+declare type VoiceClipSource = VoiceClipResolver | VoiceClipMap;
+
+/**
+ * Keys that can be spoken: the engine's `fcv3.*` gate hints, plus
+ * `capture.tips.summary` — the pre-capture "Listen to the instructions" summary
+ * (played only on an explicit tap, never during capture).
+ */
+declare type VoiceKey = "fcv3.no_face" | "fcv3.come_closer" | "fcv3.move_back" | "fcv3.center_face" | "fcv3.straighten" | "fcv3.more_light" | "fcv3.too_bright" | "fcv3.hold_still" | "fcv3.steady_camera" | "fcv3.hold_upright" | "fcv3.one_face" | "capture.tips.summary";
+
+/** Voice-guidance options of `<LivenessCapture voice>`. */
+export declare interface VoiceOptions {
+    /** Initial state when the viewer has no stored preference. Default `true`. */
+    defaultEnabled?: boolean;
+    /**
+     * Clip source; replaces the default. Either a resolver `(key, locale) → url | null`
+     * or a map `{ [locale]: { [voiceKey]: url } }` (e.g. delivered by your backend;
+     * pass a new object to change it). A key without a URL — or a resolver that
+     * throws — means "no clip" (speech fallback applies).
+     *
+     * Default: in verification mode, the Sekyro AI clip set delivered with the
+     * session (`https://assets.sekyro.ai` — allow it in your CSP `media-src`);
+     * in capture-only mode, none (device voice only).
+     */
+    clips?: VoiceClipSource;
+    /** Locales where the device voice (speechSynthesis) may speak when no clip plays. Default `true` (all). */
+    speechFallback?: boolean | readonly SekyroLocale[];
+    /** localStorage key of the viewer's preference; `null` = do not persist. Default `"sekyro.voiceGuidance"`. */
+    storageKey?: string | null;
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "sekyro-verification": SekyroVerificationElement;
+    }
+    interface GlobalEventHandlersEventMap extends SekyroVerificationEvents {
+    }
+}
+
+export { }