@incodetech/web 2.1.0-rc.1 → 2.1.0-rc.3

package/dist/types/ae-signature.d.ts

@@ -5,6 +5,26 @@ export declare const AeSignature: FC<AeSignatureModuleProps>;
 
 declare type AeSignatureModuleProps = IncodeModuleProps<AeSignatureConfig>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/antifraud.d.ts

@@ -6,6 +6,26 @@ export declare const Antifraud: FC<AntifraudProps>;
 
 declare type AntifraudProps = IncodeModuleProps<AntifraudConfig, void, AntifraudManager>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/authentication.d.ts

@@ -8,6 +8,26 @@ declare type AuthenticationProps = IncodeModuleProps<AuthenticationConfig & {
     authHint?: string;
 }, void, AuthenticationManager>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -21,8 +41,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/certificate-issuance.d.ts

@@ -0,0 +1,68 @@
+import { CertificateIssuanceConfig } from '@incodetech/core/certificate-issuance';
+import { CertificateIssuanceManager } from '@incodetech/core/certificate-issuance';
+import { FC } from 'preact/compat';
+
+export declare const CertificateIssuance: FC<CertificateIssuanceProps>;
+
+declare type CertificateIssuanceProps = IncodeModuleProps<CertificateIssuanceConfig> & {
+    manager?: CertificateIssuanceManager;
+};
+
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * Optional pre-built manager. When provided, the module does not create or manage the manager lifecycle.
+     */
+    manager?: TManager;
+    /**
+     * Callback invoked when the module completes successfully.
+     * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
+     */
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
+    /**
+     * Callback invoked when a fatal module error occurs.
+     *
+     * @param error - Human-readable error message.
+     * @param errorCode - Optional numeric code (e.g. HTTP status). Populated by
+     *   the workflow and flow modules on QR validation failures —
+     *   `4026` (`expiredUUID`), `4081` (`invalidQRuuid`) or `4083` (`onboardingUrlAlreadyUsed`).
+     * @param moduleErrorCode - Optional machine-readable error code (e.g. a
+     *   `FaceErrorCode` such as `NONEXISTENT_CUSTOMER`). Lets an orchestrator
+     *   branch on the specific terminal error without parsing the message string.
+     */
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
+};
+
+export { }
+
+declare global {
+    interface HTMLElementTagNameMap {
+        'incode-certificate-issuance': HTMLElement & IncodeModuleProps<CertificateIssuanceConfig>;
+    }
+}

package/dist/types/consent.d.ts

@@ -6,6 +6,26 @@ export declare const Consent: FC<ConsentProps>;
 
 declare type ConsentProps = IncodeModuleProps<ConsentConfig, void, ConsentManager>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/cross-document-data-match.d.ts

@@ -5,6 +5,26 @@ export declare const CrossDocumentDataMatch: FC<CrossDocumentDataMatchProps>;
 
 declare type CrossDocumentDataMatchProps = IncodeModuleProps<CrossDocumentDataMatchConfig>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/curp-validation.d.ts

@@ -6,6 +6,26 @@ export declare const CurpValidation: FC<CurpValidationProps>;
 
 declare type CurpValidationProps = IncodeModuleProps<CurpValidationConfig, void, CurpValidationManager>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/document-capture.d.ts

@@ -5,6 +5,26 @@ export declare const DocumentCapture: FC<DocumentCaptureProps>;
 
 declare type DocumentCaptureProps = IncodeModuleProps<DocumentCaptureConfig>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/ekyb.d.ts

@@ -5,6 +5,26 @@ export declare const EkybModule: FC<EkybModuleProps>;
 
 declare type EkybModuleProps = IncodeModuleProps<EkybConfig>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/ekyc.d.ts

@@ -5,6 +5,26 @@ export declare const EkycModule: FC<EkycModuleProps>;
 
 declare type EkycModuleProps = IncodeModuleProps<EkycConfig>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/electronic-signature.d.ts

@@ -8,6 +8,26 @@ export declare const ElectronicSignature: FC<ElectronicSignatureModuleProps>;
 
 declare type ElectronicSignatureModuleProps = IncodeModuleProps<ElectronicSignatureConfig>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -21,8 +41,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/email.d.ts

@@ -32,6 +32,26 @@ export declare const Email: FC<EmailProps>;
  */
 declare type EmailProps = IncodeModuleProps<EmailConfig, void, EmailManager>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -45,8 +65,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/extensibility.d.ts

@@ -60,7 +60,7 @@ declare type ButtonProps = Omit<HTMLAttributes<HTMLButtonElement>, 'class' | 'ty
     disabled?: boolean;
 };
 
-declare type ButtonSize = 'L' | 'M' | 'S';
+declare type ButtonSize = 'L' | 'M' | 'S' | 'inline';
 
 export declare const CalendarIcon: FC<CalendarIconProps>;
 
@@ -125,6 +125,7 @@ declare type CameraViewProps = {
     videoRef?: Ref<HTMLVideoElement>;
     onPlaying?: () => void;
     className?: string;
+    mirrored?: boolean;
     'data-testid'?: string;
 };
 
@@ -302,7 +303,6 @@ declare type DropdownComposedProps = {
     onBlur?: () => void;
     renderSelectedLabel?: (option: DropdownOption) => string;
     siblingElement?: ComponentChildren;
-    enterKeyHint?: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';
     class?: string;
     'aria-label'?: string;
     'data-testid'?: string;
@@ -403,6 +403,9 @@ declare type IdErrorProps = {
  * wires `idCaptureManager.retryCapture()` and forwards the
  * `attemptsRemaining` counter into the shared `<ExpiredId>` primitive.
  *
+ * `isBackSide` triggers the Figma `1-9-11-id-documenterror` subtitle
+ * ("Use a different ID from the accepted list") when the back side expired.
+ *
  * Workflow's verify-side node uses its own wrapper in the `id-verification`
  * module that passes only `onContinue` (no attempts concept), matching the
  * legacy SDK 1 `Workflow.tsx → ProcessId.jsx → ExpiredId` one-shot Continue
@@ -413,6 +416,7 @@ export declare const IdExpired: FC<IdExpiredProps>;
 declare type IdExpiredProps = {
     manager: IdCaptureManager;
     attemptsRemaining: number;
+    isBackSide?: boolean;
 };
 
 export declare const IdFlipAnimation: FC<FlipAnimationProps>;
@@ -429,6 +433,26 @@ declare type IncodeComponentProps = {
     children?: ComponentChildren;
 };
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 export declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -442,8 +466,10 @@ export declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknow
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *
@@ -841,12 +867,23 @@ declare type SpinnerProps = {
     title?: string;
     /** Subtitle text to display below the title */
     subtitle?: string;
+    ariaLabel?: string;
     /** Size of the spinner icon */
     size?: SpinnerSize;
     /** Whether to fill the SDK container */
     fullScreen?: boolean;
     /** Additional CSS class name */
     className?: string;
+    /**
+     * Render the spinner purely visually and hide it from assistive tech:
+     * no `role="status"`, no live region, no `aria-label`, no focus-on-mount,
+     * and `aria-hidden` on the container. The title/subtitle stay visible.
+     *
+     * Use when the spinner may sit behind a native OS surface (e.g. the camera
+     * permission prompt) where an announced/focusable status would leak — a
+     * screen reader must not be able to swipe into or hear it behind that prompt.
+     */
+    presentational?: boolean;
 };
 
 export declare type SpinnerSize = 'small' | 'medium' | 'large';

package/dist/types/face-match.d.ts

@@ -30,6 +30,26 @@ export declare const FaceMatch: FC<FaceMatchProps>;
  */
 declare type FaceMatchProps = IncodeModuleProps<FaceMatchConfig>;
 
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -43,8 +63,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Callback invoked when the module completes successfully.
      * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
      */
-    onFinish?: (result?: TResult) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *