@incodetech/web 2.1.0-rc.2 → 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

@@ -8,6 +8,26 @@ declare type CertificateIssuanceProps = IncodeModuleProps<CertificateIssuanceCon
     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.
@@ -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/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;
 };
 
@@ -402,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
@@ -412,6 +416,7 @@ export declare const IdExpired: FC<IdExpiredProps>;
 declare type IdExpiredProps = {
     manager: IdCaptureManager;
     attemptsRemaining: number;
+    isBackSide?: boolean;
 };
 
 export declare const IdFlipAnimation: FC<FlipAnimationProps>;
@@ -428,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.
@@ -441,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.
      *
@@ -847,6 +874,16 @@ declare type SpinnerProps = {
     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.
      *

package/dist/types/field-comparison.d.ts

@@ -6,6 +6,26 @@ export declare const FieldComparison: FC<FieldComparisonProps>;
 
 declare type FieldComparisonProps = IncodeModuleProps<FieldComparisonConfig, void, FieldComparisonManager>;
 
+/**
+ * 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.
      *