@microblink/blinkid-ux-manager 7.6.3 → 7.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microblink/blinkid-ux-manager",
-  "version": "7.6.3",
+  "version": "7.7.0",
   "author": "Microblink",
   "type": "module",
   "main": "./dist/blinkid-ux-manager.js",
@@ -11,17 +11,17 @@
     "types"
   ],
   "dependencies": {
-    "@microblink/blinkid-core": "^7.6.3",
-    "@microblink/camera-manager": "^7.2.7",
+    "@microblink/blinkid-core": "^7.7.0",
+    "@microblink/camera-manager": "^7.3.0",
     "type-fest": "^4.35.0"
   },
   "access": "public",
   "registry": "https://registry.npmjs.org/",
   "types": "./types/index.rollup.d.ts",
-  "homepage": "https://github.com/BlinkID/blinkid-web",
+  "homepage": "https://github.com/microblink/web-sdks",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BlinkID/blinkid-web.git"
+    "url": "git+https://github.com/microblink/web-sdks.git"
   },
   "exports": {
     ".": {

package/types/core/BlinkIdProcessingError.d.ts

@@ -1,11 +1,11 @@
 /**
- * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
 /**
  * BlinkID processing error. These errors are usually unrecoverable and require
  * the user to retry the scanning process.
  */
-export type BlinkIdProcessingError = "timeout" | "unsupported_document" | "unknown";
+export type BlinkIdProcessingError = "timeout" | "unsupported_document" | "result_retrieval_failed" | "unknown";
 /**
  * BlinkID Init errors are not something that should be handled by the end user
  * therefore we don't need to display them in the UI. Camera permission errors

package/types/core/BlinkIdProcessingError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlinkIdProcessingError.d.ts","sourceRoot":"","sources":["../../src/core/BlinkIdProcessingError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAE9B,SAAS,GACT,sBAAsB,GAGtB,SAAS,CAAC;AAEd;;;;GAIG"}
+{"version":3,"file":"BlinkIdProcessingError.d.ts","sourceRoot":"","sources":["../../src/core/BlinkIdProcessingError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAE9B,SAAS,GACT,sBAAsB,GAGtB,yBAAyB,GAGzB,SAAS,CAAC;AAEd;;;;GAIG"}

package/types/core/BlinkIdUxManager.d.ts

@@ -1,13 +1,15 @@
 /**
- * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
-import { BlinkIdScanningResult, BlinkIdSessionSettings, DocumentClassInfo, ProcessResultWithBuffer, RemoteScanningSession } from "@microblink/blinkid-core";
+import { AnalyticService } from "@microblink/analytics/AnalyticService";
+import { DeviceInfo, type BlinkIdScanningResult, type BlinkIdSessionSettings, type DocumentClassInfo, type ProcessResultWithBuffer, type RemoteScanningSession } from "@microblink/blinkid-core";
 import type { CameraManager } from "@microblink/camera-manager";
 import { FeedbackStabilizer } from "@microblink/feedback-stabilizer";
+import { HapticFeedbackManager } from "@microblink/ux-common/hapticFeedback";
+import { BlinkIdUiState, BlinkIdUiStateKey, BlinkIdUiStateMap } from "./blinkid-ui-state";
 import { BlinkIdProcessingError } from "./BlinkIdProcessingError";
+import { BlinkIdUxManagerOptions } from "./createBlinkIdUxManager";
 import { DocumentClassFilter } from "./DocumentClassFilter";
-import { HapticFeedbackManager } from "./HapticFeedback";
-import { BlinkIdUiState, BlinkIdUiStateKey, blinkIdUiStateMap } from "./blinkid-ui-state";
 /**
  * The BlinkIdUxManager class. This is the main class that manages the UX of
  * the BlinkID SDK. It is responsible for handling the UI state, the timeout,
@@ -16,48 +18,60 @@ import { BlinkIdUiState, BlinkIdUiStateKey, blinkIdUiStateMap } from "./blinkid-
 export declare class BlinkIdUxManager {
     #private;
     /** The camera manager. */
-    cameraManager: CameraManager;
+    readonly cameraManager: CameraManager;
     /** The scanning session. */
-    scanningSession: RemoteScanningSession;
-    /** Whether the demo overlay should be shown. */
-    showDemoOverlay: boolean;
-    /** Whether the production overlay should be shown. */
-    showProductionOverlay: boolean;
-    /** The current UI state. */
-    uiState: BlinkIdUiState;
-    /** The raw UI state key. */
-    rawUiStateKey: BlinkIdUiStateKey;
-    /** The feedback stabilizer. */
-    feedbackStabilizer: FeedbackStabilizer<typeof blinkIdUiStateMap>;
-    /** The session settings. */
-    sessionSettings: BlinkIdSessionSettings;
+    readonly scanningSession: RemoteScanningSession;
+    /**
+     * The current UI state. Updated internally by the RAF update loop.
+     * Read externally once at UI mount to seed the initial Solid signal value;
+     * subsequent updates are delivered via {@link addOnUiStateChangedCallback}.
+     */
+    get uiState(): BlinkIdUiState;
+    /**
+     * The feedback stabilizer. Public to allow UI components to read scores,
+     * event queues, and call restartCurrentStateTimer() for help-tooltip resets.
+     */
+    readonly feedbackStabilizer: FeedbackStabilizer<BlinkIdUiStateMap>;
+    /** The session settings. Populated asynchronously from the scanning session. */
+    readonly sessionSettings: BlinkIdSessionSettings;
+    /** Whether the demo overlay should be shown. Populated asynchronously from the scanning session. */
+    readonly showDemoOverlay: boolean;
+    /** Whether the production overlay should be shown. Populated asynchronously from the scanning session. */
+    readonly showProductionOverlay: boolean;
+    /** The device info. */
+    readonly deviceInfo: DeviceInfo;
     /**
      * The constructor for the BlinkIdUxManager class.
      *
      * @param cameraManager - The camera manager.
      * @param scanningSession - The scanning session.
+     * @param options - Optional manager configuration.
      */
-    constructor(cameraManager: CameraManager, scanningSession: RemoteScanningSession);
-    /**
-     * Indicates whether the UI should display the demo overlay. Controlled by the
-     * license property.
-     */
-    getShowDemoOverlay(): boolean;
+    constructor(cameraManager: CameraManager, scanningSession: RemoteScanningSession, options: BlinkIdUxManagerOptions | undefined, sessionSettings: BlinkIdSessionSettings, showDemoOverlay: boolean, showProductionOverlay: boolean, deviceInfo: DeviceInfo);
+    /** The currently applied UI state key. */
+    get uiStateKey(): BlinkIdUiStateKey;
+    /** Latest mapped candidate key before stabilization. */
+    get mappedUiStateKey(): BlinkIdUiStateKey;
     /**
-     * Indicates whether the UI should display the production overlay. Controlled by
-     * the license property.
+     * @deprecated Use `mappedUiStateKey` (internal/debug) or `uiStateKey` (displayed state).
      */
-    getShowProductionOverlay(): boolean;
+    get rawUiStateKey(): BlinkIdUiStateKey;
+    startUiUpdateLoop(): void;
+    stopUiUpdateLoop(): void;
     /**
      * Returns the timeout duration in ms. Null if timeout won't be triggered ever.
      */
     getTimeoutDuration(): number | null;
     /**
      * Returns the time in ms before the help tooltip is shown. Null if tooltip won't be auto shown.
+     *
+     * @deprecated This option will be removed in a future release. Use `helpTooltipShowDelay` in `FeedbackUiOptions` instead.
      */
     getHelpTooltipShowDelay(): number | null;
     /**
      * Returns the time in ms before the help tooltip is hidden. Null if tooltip won't be auto hidden.
+     *
+     * @deprecated This option will be removed in a future release. Use `helpTooltipHideDelay` in `FeedbackUiOptions` instead.
      */
     getHelpTooltipHideDelay(): number | null;
     /**
@@ -84,6 +98,12 @@ export declare class BlinkIdUxManager {
      * @returns true if haptic feedback is supported
      */
     isHapticFeedbackSupported(): boolean;
+    /**
+     * Gets the analytics service for tracking UX events.
+     *
+     * @returns The UX analytics service
+     */
+    get analytics(): AnalyticService;
     /**
      * Adds a callback function to be executed when the UI state changes.
      *
@@ -205,6 +225,8 @@ export declare class BlinkIdUxManager {
      * shown. If null, tooltip won't be auto shown.
      * @throws {Error} Throws an error if duration is less than or equal to 0 when
      * not null.
+     *
+     * @deprecated This option will be removed in a future release. Use `helpTooltipShowDelay` in `FeedbackUiOptions` instead.
      */
     setHelpTooltipShowDelay(duration: number | null): void;
     /**
@@ -215,25 +237,31 @@ export declare class BlinkIdUxManager {
      * hidden. If null, tooltip won't be auto hidden.
      * @throws {Error} Throws an error if duration is less than or equal to 0 when
      * not null.
+     *
+     * @deprecated This option will be removed in a future release. Use `helpTooltipHideDelay` in `FeedbackUiOptions` instead.
      */
     setHelpTooltipHideDelay(duration: number | null): void;
+    /**
+     * Returns the initial UI state key used when resetting UX state.
+     */
+    getInitialUiStateKey(): BlinkIdUiStateKey;
+    /**
+     * Overrides the initial UI state key.
+     *
+     * @param uiStateKey - The UI state key to use as manager initial state.
+     * @param applyImmediately - If true, immediately applies and emits this state.
+     */
+    setInitialUiStateKey(uiStateKey: BlinkIdUiStateKey, applyImmediately?: boolean): void;
     /**
      * Clears the scanning session timeout.
      */
-    clearScanTimeout: () => void;
+    clearScanTimeout(): void;
     /**
      * Gets the result from the scanning session.
      *
-     * @param deleteSession - Whether to delete the session after getting the result. Note that
-     * it is not possible to get the result a second time after the document has been fully captured,
-     * so in this case we should delete the scanning session since it is no longer needed.
      * @returns The result.
      */
-    getSessionResult(deleteSession?: boolean): Promise<BlinkIdScanningResult>;
-    /**
-     * Safely deletes the scanning session.
-     */
-    safelyDeleteScanningSession(): Promise<void>;
+    getSessionResult(): Promise<BlinkIdScanningResult>;
     /**
      * Resets the scanning session.
      *
@@ -248,5 +276,13 @@ export declare class BlinkIdUxManager {
      * Does not reset the camera manager or the scanning session.
      */
     reset(): void;
+    /**
+     * Fully tears down the BlinkIdUxManager. Stops frame processing, cancels the
+     * scan timeout, removes all subscriptions and the RAF loop, and clears all
+     * registered callbacks. Should be called when the manager is no longer needed.
+     *
+     * Does not stop the camera stream or delete the scanning session.
+     */
+    destroy(): void;
 }
 //# sourceMappingURL=BlinkIdUxManager.d.ts.map

package/types/core/BlinkIdUxManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlinkIdUxManager.d.ts","sourceRoot":"","sources":["../../src/core/BlinkIdUxManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BlinkIdUxManager.d.ts","sourceRoot":"","sources":["../../src/core/BlinkIdUxManager.ts"],"names":[],"mappings":"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"}

package/types/core/BlinkIdUxManager.integration.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=BlinkIdUxManager.integration.test.d.ts.map

package/types/core/BlinkIdUxManager.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlinkIdUxManager.integration.test.d.ts","sourceRoot":"","sources":["../../src/core/BlinkIdUxManager.integration.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/types/core/BlinkIdUxManager.test.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
 export {};
 //# sourceMappingURL=BlinkIdUxManager.test.d.ts.map

package/types/core/DocumentClassFilter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
 import { DocumentClassInfo } from "@microblink/blinkid-core";
 /**

package/types/core/__testdata/blankProcessResult.d.ts

@@ -1,6 +1,6 @@
 /**
- * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
-import { BlinkIdProcessResult } from "@microblink/blinkid-core";
-export declare const blankProcessResult: BlinkIdProcessResult;
+import { ProcessResultWithBuffer } from "@microblink/blinkid-core";
+export declare const blankProcessResult: ProcessResultWithBuffer;
 //# sourceMappingURL=blankProcessResult.d.ts.map

package/types/core/__testdata/blankProcessResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blankProcessResult.d.ts","sourceRoot":"","sources":["../../../src/core/__testdata/blankProcessResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,eAAO,MAAM,kBAAkB,EAAE,oBAsChC,CAAC"}
+{"version":3,"file":"blankProcessResult.d.ts","sourceRoot":"","sources":["../../../src/core/__testdata/blankProcessResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,eAAO,MAAM,kBAAkB,EAAE,uBA0ChC,CAAC"}

package/types/core/__testdata/blinkidTestFixtures.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+import type { BlinkIdScanningResult, BlinkIdSessionSettings, ProcessResultWithBuffer, ScanningSettings } from "@microblink/blinkid-core";
+import { type PartialDeep } from "type-fest";
+export declare const defaultScanningSettings: ScanningSettings;
+export declare const getMergedSettings: (overrides?: PartialDeep<ScanningSettings>) => ScanningSettings;
+export declare const createSessionSettings: (settingsOverrides?: PartialDeep<ScanningSettings>) => BlinkIdSessionSettings;
+export declare const createScanningResult: (overrides?: Partial<BlinkIdScanningResult>) => BlinkIdScanningResult;
+/**
+ * Utility function to create a BlinkIdProcessResult with specified overrides.
+ *
+ * Important defaults to take note of:
+ * - `documentDetectionStatus` is set to "failed"
+ * - `processingStatus` is set to "detection-failed"
+ * - `scanningStatus` is set to "scanning-side-in-progress"
+ * - `scanningSide` is set to "first"
+ */
+export declare const createProcessResult: (overrides?: PartialDeep<ProcessResultWithBuffer>) => ProcessResultWithBuffer;
+//# sourceMappingURL=blinkidTestFixtures.d.ts.map

package/types/core/__testdata/blinkidTestFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blinkidTestFixtures.d.ts","sourceRoot":"","sources":["../../../src/core/__testdata/blinkidTestFixtures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,eAAO,MAAM,uBAAuB,EAAE,gBACG,CAAC;AAE1C,eAAO,MAAM,iBAAiB,GAC5B,YAAW,WAAW,CAAC,gBAAgB,CAAM,KAC5C,gBAEF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,oBAAmB,WAAW,CAAC,gBAAgB,CAAM,KACpD,sBAKF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,YAAW,OAAO,CAAC,qBAAqB,CAAM,KAC7C,qBAIF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAW,WAAW,CAAC,uBAAuB,CAAM,KACnD,uBAEF,CAAC"}

package/types/core/blinkid-ui-state.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
 import { InputImageAnalysisResult, ResultCompleteness, ScanningSettings } from "@microblink/blinkid-core";
 import { UiState } from "@microblink/feedback-stabilizer";
@@ -7,10 +7,103 @@ import { UiState } from "@microblink/feedback-stabilizer";
  * The type of reticle to display.
  */
 export type BlinkIdReticleType = "searching" | "processing" | "error" | "done" | "flip" | "move_top" | "move_left" | "move_right";
+/**
+ * Intro state keys for BlinkID UI.
+ *
+ * @remarks
+ * These states display introductory screens that guide users to scan the correct
+ * side or page of their document. Most intro states are automatically reached
+ * during the scanning flow, but `INTRO_DATA_PAGE` requires manual initialization.
+ *
+ * **Default behavior:**
+ * The UX manager defaults to `INTRO_FRONT_PAGE`, assuming users will scan
+ * non-passport documents (ID cards, driver's licenses, etc.).
+ *
+ * **Automatically reachable states:**
+ * After capturing a page, the flow automatically transitions through appropriate
+ * intro states:
+ * - `INTRO_BACK_PAGE` - After flipping an ID card (`FLIP_CARD`)
+ * - `INTRO_TOP_PAGE` - After moving to passport top page (`MOVE_TOP`)
+ * - `INTRO_LEFT_PAGE` - After moving to passport left page (`MOVE_LEFT`)
+ * - `INTRO_RIGHT_PAGE` - After moving to passport right page (`MOVE_RIGHT`)
+ * - `INTRO_LAST_PAGE` - After moving to passport barcode page (`MOVE_LAST_PAGE`)
+ *
+ * **Manual initialization required:**
+ * - `INTRO_DATA_PAGE` - Only reachable by overriding the UX manager initial
+ *   state. Use this when restricting scanning to passport documents only,
+ *   as the SDK assumes non-passport documents by default.
+ *
+ * @example
+ * ```typescript
+ * // Limit scanning to passport documents only
+ * const uxManager = new BlinkIdUxManager(cameraManager, session);
+ * uxManager.setInitialUiStateKey("INTRO_DATA_PAGE", true);
+ * ```
+ *
+ * @see {@link BlinkIdUiIntroStateKey} for the union type of these keys
+ * @see {@link getChainedUiStateKey} for the automatic state transition logic
+ */
+export declare const blinkIdUiIntroStateKeys: readonly ["INTRO_FRONT_PAGE", "INTRO_BACK_PAGE", "INTRO_DATA_PAGE", "INTRO_TOP_PAGE", "INTRO_LEFT_PAGE", "INTRO_RIGHT_PAGE", "INTRO_LAST_PAGE"];
+/**
+ * Union type of all intro state keys.
+ *
+ * @see {@link blinkIdUiIntroStateKeys} for detailed documentation on each state
+ */
+export type BlinkIdUiIntroStateKey = (typeof blinkIdUiIntroStateKeys)[number];
+/**
+ * Page transition state keys for BlinkID UI.
+ *
+ * @remarks
+ * These states display transition animations and instructions between scanning
+ * different document pages or sides. They are automatically triggered after
+ * successfully capturing a page (`PAGE_CAPTURED`) and cannot be manually set.
+ *
+ * Each transition state corresponds to a specific document type and guides the
+ * user to position the document for the next scan:
+ * - `FLIP_CARD` - Instructs user to flip ID card to scan the back side
+ * - `MOVE_LAST_PAGE` - Instructs user to move to passport's last page (barcode)
+ * - `MOVE_TOP` - Instructs user to rotate passport to top orientation (0°)
+ * - `MOVE_RIGHT` - Instructs user to rotate passport 90° clockwise
+ * - `MOVE_LEFT` - Instructs user to rotate passport 90° counter-clockwise
+ *
+ * **Automatic flow:**
+ * After a transition animation completes, the UI automatically advances to the
+ * corresponding intro state to begin scanning the next page:
+ * - `FLIP_CARD` → `INTRO_BACK_PAGE`
+ * - `MOVE_LAST_PAGE` → `INTRO_LAST_PAGE`
+ * - `MOVE_TOP` → `INTRO_TOP_PAGE`
+ * - `MOVE_RIGHT` → `INTRO_RIGHT_PAGE`
+ * - `MOVE_LEFT` → `INTRO_LEFT_PAGE`
+ *
+ * @see {@link BlinkIdPageTransitionKey} for the union type of these keys
+ * @see {@link getChainedUiStateKey} for the automatic state transition logic
+ * @see {@link blinkIdUiIntroStateKeys} for the intro states that follow transitions
+ */
+export declare const blinkIdPageTransitionKeys: readonly ["FLIP_CARD", "MOVE_TOP", "MOVE_LEFT", "MOVE_RIGHT", "MOVE_LAST_PAGE"];
+/**
+ * Union type of all page transition state keys.
+ *
+ * @see {@link blinkIdPageTransitionKeys} for detailed documentation on each state
+ */
+export type BlinkIdPageTransitionKey = (typeof blinkIdPageTransitionKeys)[number];
+/**
+ * The error states for BlinkID. Mappable from `ProcessResult`.
+ */
+export declare const blinkIdUiErrorStateKeys: readonly ["FRONT_PAGE_NOT_IN_FRAME", "BACK_PAGE_NOT_IN_FRAME", "DATA_PAGE_NOT_IN_FRAME", "TOP_PAGE_NOT_IN_FRAME", "LEFT_PAGE_NOT_IN_FRAME", "RIGHT_PAGE_NOT_IN_FRAME", "LAST_PAGE_NOT_IN_FRAME", "BARCODE_NOT_IN_FRAME", "DOCUMENT_FRAMING_CAMERA_TOO_FAR", "DOCUMENT_FRAMING_CAMERA_TOO_CLOSE", "DOCUMENT_FRAMING_CAMERA_ANGLE_TOO_STEEP", "DOCUMENT_TOO_CLOSE_TO_FRAME_EDGE", "BLUR_DETECTED", "GLARE_DETECTED", "TOO_DARK", "TOO_BRIGHT", "OCCLUDED", "FACE_PHOTO_OCCLUDED", "WRONG_SIDE", "WRONG_TOP_PAGE", "WRONG_LEFT_PAGE", "WRONG_RIGHT_PAGE", "WRONG_LAST_PAGE", "UNSUPPORTED_DOCUMENT"];
+export type BlinkIdUiErrorStateKey = (typeof blinkIdUiErrorStateKeys)[number];
+/**
+ * These keys represent successful steps in the BlinkID scanning process.
+ */
+export declare const blinkIdUiStepSuccessKeys: readonly ["PAGE_CAPTURED", "DOCUMENT_CAPTURED"];
+export type BlinkIdUiStepSuccessKey = (typeof blinkIdUiStepSuccessKeys)[number];
+/**
+ * These keys are directly mappable from a `ProcessResult`
+ */
+export type BlinkIdUiMappableKey = BlinkIdUiErrorStateKey | BlinkIdUiStepSuccessKey | "PROCESSING_BARCODE";
 /**
  * The key of the UI state.
  */
-export type BlinkIdUiStateKey = "FLIP_CARD" | "DOCUMENT_CAPTURED" | "SENSING_FRONT" | "SENSING_BACK" | "SENSING_DATA_PAGE" | "SENSING_TOP_PAGE" | "SENSING_LEFT_PAGE" | "SENSING_RIGHT_PAGE" | "SENSING_LAST_PAGE" | "MOVE_TOP" | "MOVE_LEFT" | "MOVE_RIGHT" | "MOVE_LAST_PAGE" | "DOCUMENT_FRAMING_CAMERA_TOO_FAR" | "DOCUMENT_FRAMING_CAMERA_TOO_CLOSE" | "DOCUMENT_FRAMING_CAMERA_ANGLE_TOO_STEEP" | "DOCUMENT_TOO_CLOSE_TO_FRAME_EDGE" | "BLUR_DETECTED" | "GLARE_DETECTED" | "TOO_DARK" | "TOO_BRIGHT" | "OCCLUDED" | "FACE_PHOTO_OCCLUDED" | "UNSUPPORTED_DOCUMENT" | "SCAN_BARCODE" | "WRONG_TOP_PAGE" | "WRONG_LEFT_PAGE" | "WRONG_RIGHT_PAGE" | "WRONG_LAST_PAGE" | "WRONG_SIDE";
+export type BlinkIdUiStateKey = BlinkIdUiIntroStateKey | BlinkIdPageTransitionKey | BlinkIdUiMappableKey;
 /**
  * Extended UI state for BlinkID.
  *
@@ -32,12 +125,6 @@ export type BlinkIdUiState = BlinkIdUiStateMap[keyof BlinkIdUiStateMap];
  * The UI state map of BlinkID.
  */
 export declare const blinkIdUiStateMap: BlinkIdUiStateMap;
-/**
- * The states that are captured when the first side is captured.
- */
-export declare const firstSideCapturedUiStateKeys: BlinkIdUiStateKey[];
-/** The error UI state keys. */
-export declare const errorUiStateKeys: BlinkIdUiStateKey[];
 /**
  * The partial process result.
  */
@@ -61,5 +148,5 @@ export type PartialProcessResult = {
  * selection.
  * @returns The UI state key representing what should be shown to the user.
  */
-export declare function getUiStateKey(frameProcessResult: PartialProcessResult, settings?: Partial<ScanningSettings>): BlinkIdUiStateKey;
+export declare function getUiStateKey(frameProcessResult: PartialProcessResult, settings?: Partial<ScanningSettings>): BlinkIdUiMappableKey | undefined;
 //# sourceMappingURL=blinkid-ui-state.d.ts.map

package/types/core/blinkid-ui-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blinkid-ui-state.d.ts","sourceRoot":"","sources":["../../src/core/blinkid-ui-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAG1D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,YAAY,GACZ,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,WAAW,GACX,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,mBAAmB,GACnB,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,UAAU,GACV,WAAW,GACX,YAAY,GACZ,gBAAgB,GAChB,iCAAiC,GACjC,mCAAmC,GACnC,yCAAyC,GACzC,kCAAkC,GAClC,eAAe,GACf,gBAAgB,GAChB,UAAU,GACV,YAAY,GACZ,UAAU,GACV,qBAAqB,GACrB,sBAAsB,GACtB,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;KAC7B,CAAC,IAAI,iBAAiB,GAAG,OAAO,GAAG;QAClC,+BAA+B;QAC/B,GAAG,EAAE,CAAC,CAAC;QACP,+BAA+B;QAC/B,WAAW,EAAE,kBAAkB,CAAC;KACjC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,iBAAiB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBAgKtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBAAiB,EAQlD,CAAC;AAEX,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAIpB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,uCAAuC;IACvC,wBAAwB,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC5D,+BAA+B;IAC/B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjD,CAAC;AAyBF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,oBAAoB,EACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,qBAmYrC"}
+{"version":3,"file":"blinkid-ui-state.d.ts","sourceRoot":"","sources":["../../src/core/blinkid-ui-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAS1D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,YAAY,GACZ,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,WAAW,GACX,YAAY,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,uBAAuB,iJAQ1B,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,yBAAyB,iFAM5B,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,uBAAuB,mkBA6B1B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,wBAAwB,iDAG3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,sBAAsB,GAEtB,uBAAuB,GAEvB,oBAAoB,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAEzB,sBAAsB,GAEtB,wBAAwB,GAExB,oBAAoB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;KAC7B,CAAC,IAAI,iBAAiB,GAAG,OAAO,GAAG;QAClC,+BAA+B;QAC/B,GAAG,EAAE,CAAC,CAAC;QACP,+BAA+B;QAC/B,WAAW,EAAE,kBAAkB,CAAC;KACjC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,iBAAiB,CAAC,CAAC;AAOxE;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBA8NtB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,uCAAuC;IACvC,wBAAwB,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC5D,+BAA+B;IAC/B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,oBAAoB,EACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,oCA2WrC"}

package/types/core/blinkid-ui-state.test.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
 export {};
 //# sourceMappingURL=blinkid-ui-state.test.d.ts.map

package/types/core/createBlinkIdUxManager.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+import { type RemoteScanningSession } from "@microblink/blinkid-core";
+import { CameraManager } from "@microblink/camera-manager";
+import { BlinkIdUxManager } from "./BlinkIdUxManager";
+import { BlinkIdUiStateKey } from "./blinkid-ui-state";
+export type BlinkIdUxManagerOptions = {
+    /**
+     * Initial UI state key used by the manager/stabilizer reset flow.
+     * Defaults to `INTRO_FRONT_PAGE`.
+     */
+    initialUiStateKey?: BlinkIdUiStateKey;
+};
+/**
+ * Creates a BlinkIdUxManager.
+ *
+ * @param cameraManager - The camera manager.
+ * @param scanningSession - The scanning session.
+ * @returns The BlinkIdUxManager instance.
+ */
+export declare const createBlinkIdUxManager: (cameraManager: CameraManager, scanningSession: RemoteScanningSession, options?: BlinkIdUxManagerOptions) => Promise<BlinkIdUxManager>;
+//# sourceMappingURL=createBlinkIdUxManager.d.ts.map

package/types/core/createBlinkIdUxManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBlinkIdUxManager.d.ts","sourceRoot":"","sources":["../../src/core/createBlinkIdUxManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,eAAe,aAAa,EAC5B,iBAAiB,qBAAqB,EACtC,UAAS,uBAA4B,KACpC,OAAO,CAAC,gBAAgB,CAkB1B,CAAC"}

package/types/core/getChainedUiStateKey.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+import { DocumentRotation } from "@microblink/blinkid-core";
+import { BlinkIdUiStateKey } from "./blinkid-ui-state";
+import { DocumentPagination } from "./ui-state-utils";
+export type ChainedUiStateProps = {
+    previousUiStateKey: BlinkIdUiStateKey;
+    paginationType: DocumentPagination;
+    rotation?: DocumentRotation;
+};
+/**
+ * Handles chaining of UI states based on the current state, pagination type, and rotation.
+ * @param chainedUiStateProps The properties including current UI state key, pagination type, and optional rotation.
+ * @returns The next chained UI state key, or undefined if there is no chained state.
+ */
+export declare function getChainedUiStateKey(chainedUiStateProps: ChainedUiStateProps): BlinkIdUiStateKey | undefined;
+//# sourceMappingURL=getChainedUiStateKey.d.ts.map

package/types/core/getChainedUiStateKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getChainedUiStateKey.d.ts","sourceRoot":"","sources":["../../src/core/getChainedUiStateKey.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,cAAc,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AAEH,wBAAgB,oBAAoB,CAClC,mBAAmB,EAAE,mBAAmB,GACvC,iBAAiB,GAAG,SAAS,CAkG/B"}

package/types/core/getChainedUiStateKey.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=getChainedUiStateKey.test.d.ts.map

package/types/core/getChainedUiStateKey.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getChainedUiStateKey.test.d.ts","sourceRoot":"","sources":["../../src/core/getChainedUiStateKey.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/types/core/test-helpers.integration.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+import type { BlinkIdScanningResult, BlinkIdSessionSettings, RemoteScanningSession, ScanningSettings } from "@microblink/blinkid-core";
+import type { CameraManager } from "@microblink/camera-manager";
+import { type FakeScanningSession, FakeCameraManager } from "@microblink/test-utils";
+import type { BlinkIdUxManager } from "./BlinkIdUxManager";
+import { createProcessResult } from "./__testdata/blinkidTestFixtures";
+import { type BlinkIdUxManagerOptions } from "./createBlinkIdUxManager";
+export type CameraInputState = {
+    selectedCamera?: {
+        name: string;
+        facingMode?: "front" | "back";
+    };
+    videoResolution?: {
+        width: number;
+        height: number;
+    };
+    extractionArea?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+};
+export type BlinkIdCameraHarness = {
+    cameraManager: CameraManager;
+    fakeCameraManager: FakeCameraManager;
+    emitPlaybackState: (playbackState: "idle" | "playback" | "capturing") => void;
+    emitFrame: (imageData: ImageData) => Promise<ArrayBufferLike | void>;
+    emitCameraState: (nextState: Partial<CameraInputState>) => void;
+    setIsActive: (value: boolean) => void;
+    stopFrameCapture: FakeCameraManager["stopFrameCapture"];
+    startFrameCapture: FakeCameraManager["startFrameCapture"];
+    startCameraStream: FakeCameraManager["startCameraStream"];
+};
+export declare const createBlinkIdCameraHarness: (fakeCameraOptions?: ConstructorParameters<typeof FakeCameraManager>[0]) => BlinkIdCameraHarness;
+export type BlinkIdSessionMock = FakeScanningSession<ReturnType<typeof createProcessResult>, BlinkIdSessionSettings, BlinkIdScanningResult>;
+export type BlinkIdUnitSessionMock = FakeScanningSession<ReturnType<typeof createProcessResult>, {
+    scanningSettings: Partial<ScanningSettings>;
+}, unknown>;
+export type CreateBlinkIdIntegrationContextOptions = {
+    sessionSettings?: BlinkIdSessionSettings;
+    showDemoOverlay?: boolean;
+    showProductionOverlay?: boolean;
+    fakeCameraOptions?: ConstructorParameters<typeof FakeCameraManager>[0];
+    sessionOverrides?: Partial<BlinkIdSessionMock>;
+};
+export type BlinkIdIntegrationContext = {
+    manager: BlinkIdUxManager;
+    fakeCameraManager: FakeCameraManager;
+    scanningSession: BlinkIdSessionMock;
+};
+type CreateBlinkIdSessionMockOptions = {
+    sessionSettings?: BlinkIdSessionSettings;
+    showDemoOverlay?: boolean;
+    showProductionOverlay?: boolean;
+    sessionOverrides?: Partial<BlinkIdSessionMock>;
+};
+export declare const createBlinkIdSessionMock: (options?: CreateBlinkIdSessionMockOptions) => BlinkIdSessionMock;
+export declare const createBlinkIdUnitSessionMock: (overrideSettings?: Partial<ScanningSettings>) => BlinkIdUnitSessionMock;
+export declare const createBlinkIdManager: (cameraManager: CameraManager, scanningSession: BlinkIdSessionMock | RemoteScanningSession, options?: BlinkIdUxManagerOptions) => Promise<BlinkIdUxManager>;
+export declare const createBlinkIdIntegrationContext: (options?: CreateBlinkIdIntegrationContextOptions) => Promise<BlinkIdIntegrationContext>;
+export {};
+//# sourceMappingURL=test-helpers.integration.d.ts.map

package/types/core/test-helpers.integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.integration.d.ts","sourceRoot":"","sources":["../../src/core/test-helpers.integration.ts"],"names":[],"mappings":"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"}