@microblink/blinkid-ux-manager 7.8.0 → 8000.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microblink/blinkid-ux-manager",
-  "version": "7.8.0",
+  "version": "8000.0.0",
   "author": "Microblink",
   "type": "module",
   "main": "./dist/blinkid-ux-manager.js",
@@ -11,7 +11,7 @@
     "types"
   ],
   "dependencies": {
-    "@microblink/blinkid-core": "^7.8.0",
+    "@microblink/blinkid-core": "^8000.0.0",
     "@microblink/camera-manager": "^7.3.2",
     "type-fest": "^4.35.0"
   },

package/types/core/BlinkIdTimeoutConfiguration.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+export type BlinkIdTimeoutConfiguration = {
+    /**
+     * Maximum allowed inactivity window in milliseconds. The inactivity timer is
+     * reset whenever the stabilized BlinkID UI state changes. Set to `null` to
+     * disable the inactivity timeout.
+     */
+    inactivityTimeoutMs: number | null;
+    /**
+     * Maximum allowed capture duration for a single BlinkID scan step in
+     * milliseconds. Set to `null` to disable the scan-step timeout.
+     */
+    scanStepTimeoutMs: number | null;
+    /**
+     * Active-capture delay before resolving a barcode step once BlinkID reports a
+     * barcode whose parsing is not supported. Set to `null` to disable automatic
+     * resolution for partially supported barcodes.
+     */
+    partiallySupportedBarcodeResolveTimeoutMs: number | null;
+};
+/**
+ * The default BlinkID timeout configuration.
+ */
+export declare const defaultBlinkIdTimeoutConfiguration: BlinkIdTimeoutConfiguration;
+/**
+ * Normalizes the BlinkID timeout configuration.
+ */
+export declare const normalizeBlinkIdTimeoutConfiguration: (timeoutConfiguration?: Partial<BlinkIdTimeoutConfiguration>) => BlinkIdTimeoutConfiguration;
+//# sourceMappingURL=BlinkIdTimeoutConfiguration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlinkIdTimeoutConfiguration.d.ts","sourceRoot":"","sources":["../../src/core/BlinkIdTimeoutConfiguration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,yCAAyC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,2BAIhD,CAAC;AAkBF;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAC/C,uBAAsB,OAAO,CAAC,2BAA2B,CAAM,KAC9D,2BAoBF,CAAC"}

package/types/core/BlinkIdUxManager.d.ts

@@ -1,14 +1,63 @@
 /**
  * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
-import { AnalyticService, DeviceInfo, type BlinkIdScanningResult, type BlinkIdSessionSettings, type DocumentClassInfo, type ProcessResultWithBuffer, type RemoteScanningSession } from "@microblink/blinkid-core";
+import { AnalyticService, DeviceInfo, type BlinkIdProcessResult, type BlinkIdScanningResult, type BlinkIdSessionSettings, type DocumentClassInfo, 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 type { BlinkIdTimeoutConfiguration } from "./BlinkIdTimeoutConfiguration";
+import type { BlinkIdUxManagerOptions } from "./createBlinkIdUxManager";
+import { type BlinkIdExtractionMode } from "./extractionMode";
+export type BlinkIdProgressTimerStatus = "disabled" | "idle" | "running" | "paused";
+/**
+ * Callback invoked after BlinkID processes a camera frame.
+ *
+ * @param frameResult - Process result for the current frame. This contains the
+ * input image analysis and result completeness data that the UX manager uses to
+ * map feedback state; it does not include the final scanning result.
+ * @param advanceToNextStep - Advances the scanning session to the next required
+ * step. Use this for custom flows that decide, from the frame result, that the
+ * current side or step is complete before the default UX flow advances. For
+ * example, call this once `frameResult` contains all data your integration
+ * needs, even if the default flow would keep waiting for an optional barcode
+ * step that is hard to capture on a poor camera.
+ * @param triggerStepTimeout - Immediately triggers the scan-step timeout path
+ * for the active step. Use this when custom validation decides that the current
+ * step should fail or stop waiting for more frames.
+ * @param getLastFrame - Returns the raw `ArrayBuffer` for the frame that
+ * produced `frameResult`. The buffer is intended for diagnostics or custom
+ * tooling that needs the exact last processed frame.
+ */
+export type BlinkIdFrameProcessCallback = (frameResult: BlinkIdProcessResult, advanceToNextStep: () => Promise<void>, triggerStepTimeout: () => void, getLastFrame: () => ArrayBuffer) => void;
+export type BlinkIdProgressTimerState = {
+    /** Configured timeout duration in milliseconds. */
+    configuredMs: number | null;
+    /** Remaining timeout duration in milliseconds. */
+    remainingMs: number | null;
+    /** Whether this timer is idle, actively counting down, or paused. */
+    status: BlinkIdProgressTimerStatus;
+};
+export type BlinkIdProgress = {
+    /** Currently stabilized BlinkID UI state key. */
+    uiStateKey: BlinkIdUiStateKey;
+    /** Remaining state for the inactivity timeout. */
+    inactivity: BlinkIdProgressTimerState;
+    /** Remaining state for the scan-step timeout. */
+    perSide: BlinkIdProgressTimerState;
+    /** Remaining state for partially supported barcode auto-resolution. */
+    partiallySupportedBarcodeResolve: BlinkIdProgressTimerState;
+    /** Whether BlinkID is currently timing an active scan step. */
+    isTimingActiveScanStep: boolean;
+    /** Current camera playback state that controls timer pause/resume. */
+    playbackState: "idle" | "playback" | "capturing";
+    /** Latest raw mapped BlinkID UI key. */
+    mappedUiStateKey: BlinkIdUiStateKey;
+    /** Stabilized UI state key that last reset the inactivity timeout. */
+    inactivityResetUiStateKey?: BlinkIdUiStateKey;
+};
 /**
  * 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,
@@ -51,28 +100,14 @@ export declare class BlinkIdUxManager {
     get uiStateKey(): BlinkIdUiStateKey;
     /** Latest mapped candidate key before stabilization. */
     get mappedUiStateKey(): BlinkIdUiStateKey;
-    /**
-     * @deprecated Use `mappedUiStateKey` (internal/debug) or `uiStateKey` (displayed state).
-     */
-    get rawUiStateKey(): BlinkIdUiStateKey;
+    /** Session-settings-derived extraction mode used by feedback and dialogs. */
+    get extractionMode(): BlinkIdExtractionMode;
     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.
+     * Returns the active BlinkID timeout configuration.
      */
-    getHelpTooltipHideDelay(): number | null;
+    getTimeoutConfiguration(): BlinkIdTimeoutConfiguration;
     /**
      * Gets the haptic feedback manager instance.
      *
@@ -155,20 +190,24 @@ export declare class BlinkIdUxManager {
     /**
      * Registers a callback function to be called when a frame is processed.
      *
-     * @param callback - A function that will be called with the frame analysis
-     * result.
+     * @param callback - A function that receives the processed frame result and
+     * controls for custom step advancement, step timeout triggering, and access to
+     * the last processed frame buffer.
      * @returns A cleanup function that, when called, will remove the registered
      * callback.
      *
      * @example
-     * const cleanup = manager.addOnFrameProcessCallback((frameResult) => {
+     * const cleanup = manager.addOnFrameProcessCallback((frameResult, advanceToNextStep) => {
      *   console.log('Frame processed:', frameResult);
+     *   if (shouldAdvance(frameResult)) {
+     *     void advanceToNextStep();
+     *   }
      * });
      *
      * // Later, to remove the callback:
      * cleanup();
      */
-    addOnFrameProcessCallback(callback: (frameResult: ProcessResultWithBuffer) => void): () => void;
+    addOnFrameProcessCallback(callback: BlinkIdFrameProcessCallback): () => void;
     /**
      * Registers a callback function to be called when an error occurs during
      * processing.
@@ -186,6 +225,23 @@ export declare class BlinkIdUxManager {
      * cleanup();
      */
     addOnErrorCallback(callback: (errorState: BlinkIdProcessingError) => void): () => void;
+    /**
+     * Registers a callback function to receive BlinkID progress snapshots.
+     *
+     * @param callback - A function that will be called with progress data from
+     * the internal 30 FPS RAF loop.
+     * @returns A cleanup function that, when called, will remove the registered
+     * callback.
+     *
+     * @example
+     * const cleanup = manager.addOnProgressCallback((progress) => {
+     *   console.log('BlinkID progress:', progress);
+     * });
+     *
+     * // Later, to remove the callback:
+     * cleanup();
+     */
+    addOnProgressCallback(callback: (progress: BlinkIdProgress) => void): () => void;
     /**
      * Registers a callback function to be called when a document is filtered.
      *
@@ -204,42 +260,12 @@ export declare class BlinkIdUxManager {
      */
     addOnDocumentFilteredCallback(callback: (documentClassInfo: DocumentClassInfo) => void): () => void;
     /**
-     * Sets the duration after which the scanning session will timeout. The
-     * timeout can occur in various scenarios and may be restarted by different
-     * scanning events.
-     *
-     * @param duration The timeout duration in milliseconds. If null, timeout won't
-     * be triggered ever.
-     * @param setHelpTooltipShowDelay If true, also sets the help tooltip show
-     * delay to half of the provided duration. If timeout duration is null, help
-     * tooltip show delay will be set to null. Defaults to true.
-     * @throws {Error} Throws an error if duration is less than or equal to 0 when not null.
-     */
-    setTimeoutDuration(duration: number | null, setHelpTooltipShowDelay?: boolean): void;
-    /**
-     * Sets the duration in milliseconds before the help tooltip is shown.
-     * A value of null means the help tooltip will not be auto shown.
-     *
-     * @param duration The duration in milliseconds before the help tooltip is
-     * 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;
-    /**
-     * Sets the duration in milliseconds before the help tooltip is hidden.
-     * A value of null means the help tooltip will not be auto hidden.
-     *
-     * @param duration The duration in milliseconds before the help tooltip is
-     * 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.
+     * Updates the BlinkID timeout configuration.
      *
-     * @deprecated This option will be removed in a future release. Use `helpTooltipHideDelay` in `FeedbackUiOptions` instead.
+     * Updating the configuration resets timeout tracking for the current scan
+     * step so the new durations take effect immediately.
      */
-    setHelpTooltipHideDelay(duration: number | null): void;
+    setTimeoutConfiguration(timeoutConfiguration: Partial<BlinkIdTimeoutConfiguration>): void;
     handleCameraManagerError: (error: Error) => void;
     /**
      * Returns the initial UI state key used when resetting UX state.

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.session-status.test.d.ts

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

package/types/core/BlinkIdUxManager.session-status.test.d.ts.map

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

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

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

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

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

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

@@ -1,11 +1,8 @@
 /**
  * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
-import type { BlinkIdScanningResult, BlinkIdSessionSettings, ProcessResultWithBuffer, ScanningSettings } from "@microblink/blinkid-core";
+import type { BlinkIdScanningResult, ProcessResultWithBuffer } 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.

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

@@ -1 +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"}
+{"version":3,"file":"blinkidTestFixtures.d.ts","sourceRoot":"","sources":["../../../src/core/__testdata/blinkidTestFixtures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C,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,7 +1,7 @@
 /**
  * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
-import { InputImageAnalysisResult, ResultCompleteness, ScanningSettings } from "@microblink/blinkid-core";
+import { InputImageAnalysisResult, ScanningSettings, ScanningStatus } from "@microblink/blinkid-core";
 import { UiState } from "@microblink/feedback-stabilizer";
 /**
  * The type of reticle to display.
@@ -126,14 +126,9 @@ export type BlinkIdUiState = BlinkIdUiStateMap[keyof BlinkIdUiStateMap];
  */
 export declare const blinkIdUiStateMap: BlinkIdUiStateMap;
 /**
- * The partial process result.
+ * Maps a session-level scanning status to a UI state key
  */
-export type PartialProcessResult = {
-    /** The input image analysis result. */
-    inputImageAnalysisResult: Partial<InputImageAnalysisResult>;
-    /** The result completeness. */
-    resultCompleteness: Partial<ResultCompleteness>;
-};
+export declare function getUiStateKeyFromScanningStatus(scanningStatus: ScanningStatus): BlinkIdUiMappableKey | undefined;
 /**
  * Determines the appropriate UI state key based on the current frame processing
  * result and scanning settings.
@@ -148,5 +143,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>): BlinkIdUiMappableKey | undefined;
+export declare function getUiStateKey(scanningStatus: ScanningStatus, inputImageAnalysisResult: InputImageAnalysisResult, scanningSettings: 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,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"}
+{"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,gBAAgB,EAChB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAQ1D;;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,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,cAAc,GAC7B,oBAAoB,GAAG,SAAS,CAMlC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,cAAc,EAC9B,wBAAwB,EAAE,wBAAwB,EAClD,gBAAgB,EAAE,gBAAgB,oCA+RnC"}

package/types/core/createBlinkIdUxManager.d.ts

@@ -5,12 +5,20 @@ import { type RemoteScanningSession } from "@microblink/blinkid-core";
 import { CameraManager } from "@microblink/camera-manager";
 import { BlinkIdUxManager } from "./BlinkIdUxManager";
 import { BlinkIdUiStateKey } from "./blinkid-ui-state";
+import type { BlinkIdTimeoutConfiguration } from "./BlinkIdTimeoutConfiguration";
+/**
+ * Options for the BlinkIdUxManager.
+ */
 export type BlinkIdUxManagerOptions = {
     /**
      * Initial UI state key used by the manager/stabilizer reset flow.
      * Defaults to `INTRO_FRONT_PAGE`.
      */
     initialUiStateKey?: BlinkIdUiStateKey;
+    /**
+     * Configures BlinkID scanning timeout behavior.
+     */
+    timeoutConfiguration?: Partial<BlinkIdTimeoutConfiguration>;
 };
 /**
  * Creates a BlinkIdUxManager.

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

@@ -1 +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,CAiD1B,CAAC"}
+{"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,EACL,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC7D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,eAAe,aAAa,EAC5B,iBAAiB,qBAAqB,EACtC,UAAS,uBAA4B,KACpC,OAAO,CAAC,gBAAgB,CA8D1B,CAAC"}

package/types/core/extractionMode.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+import type { BlinkIdSessionSettings, ScanningSettings } from "@microblink/blinkid-core";
+/**
+ * UI-facing classification of how a BlinkID session extracts data.
+ *
+ * The UX manager uses this mode to choose feedback copy, help/onboarding locale
+ * groups, and extraction-specific modal illustrations.
+ *
+ * - `full-document` - Standard document flow for document capture, MRZ, VIZ, or
+ *   mixed multi-side extraction.
+ * - `document-with-barcode` - Single-side document capture flow that requires
+ *   the barcode side to be scanned.
+ * - `barcode-only` - Barcode extraction flow with no document capture, MRZ, or
+ *   VIZ extraction.
+ */
+export type BlinkIdExtractionMode = "full-document" | "document-with-barcode" | "barcode-only";
+/**
+ * Minimal subset of session settings required to derive a UX extraction mode.
+ *
+ * The helper accepts partial settings because mode derivation only depends on
+ * module presence and whether the session is explicitly configured for a
+ * single-side scan.
+ */
+export type BlinkIdExtractionModeInput = Partial<Pick<BlinkIdSessionSettings, "scanningMode">> & {
+    scanningSettings?: Partial<Pick<ScanningSettings, "documentCaptureModule" | "barcodeModule" | "mrzModule" | "vizModule">> | null;
+};
+/**
+ * Derives the UX extraction mode from BlinkID session settings.
+ *
+ * Barcode-focused modes are intentionally narrow: document-with-barcode requires
+ * a mandatory barcode, while MRZ and VIZ keep the UI in the full-document flow
+ * because they rely on document-capture guidance and may need front-side
+ * document context.
+ *
+ * @returns The matching extraction mode, or `full-document` when settings are
+ * missing or do not match a barcode-focused flow.
+ */
+export declare function getBlinkIdExtractionMode(sessionSettings: BlinkIdExtractionModeInput): BlinkIdExtractionMode;
+//# sourceMappingURL=extractionMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractionMode.d.ts","sourceRoot":"","sources":["../../src/core/extractionMode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,uBAAuB,GACvB,cAAc,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,IAAI,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAC7C,GAAG;IACF,gBAAgB,CAAC,EAAE,OAAO,CACxB,IAAI,CACF,gBAAgB,EAChB,uBAAuB,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,CACtE,CACF,GAAG,IAAI,CAAC;CACV,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,0BAA0B,GAC1C,qBAAqB,CA2BvB"}

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

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

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

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

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

@@ -1,7 +1,7 @@
 /**
  * Copyright (c) 2026 Microblink Ltd. All rights reserved.
  */
-import type { BlinkIdScanningResult, BlinkIdSessionSettings, ScanningSettings } from "@microblink/blinkid-core";
+import type { BlinkIdScanningResult, BlinkIdSessionSettings, BlinkIdSessionSettingsInput, PartialScanningSettingsInput, ScanningSettings } from "@microblink/blinkid-core";
 import type { CameraManager } from "@microblink/camera-manager";
 import { type CreateFakeCameraManagerOptions, type FakeCameraHarness, type FakeScanningSession } from "@microblink/test-utils";
 import type { BlinkIdUxManager } from "./BlinkIdUxManager";
@@ -13,13 +13,13 @@ export type BlinkIdUnitSessionMock = FakeScanningSession<ReturnType<typeof creat
     scanningSettings: Partial<ScanningSettings>;
 }, unknown>;
 export type CreateBlinkIdIntegrationContextOptions = {
-    sessionSettings?: BlinkIdSessionSettings;
+    sessionSettings?: BlinkIdSessionSettingsInput;
     showDemoOverlay?: boolean;
     showProductionOverlay?: boolean;
     fakeCameraOptions?: CreateFakeCameraManagerOptions;
     sessionOverrides?: Partial<BlinkIdSessionMock>;
 };
-export declare const createBlinkIdUnitSessionMock: (overrideSettings?: Partial<ScanningSettings>) => BlinkIdUnitSessionMock;
+export declare const createBlinkIdUnitSessionMock: (overrideSettings?: PartialScanningSettingsInput) => BlinkIdUnitSessionMock;
 export declare const createBlinkIdIntegrationContext: (options?: CreateBlinkIdIntegrationContextOptions) => Promise<{
     manager: BlinkIdUxManager;
     fakeCameraManager: BlinkIdCameraHarness["fakeCameraManager"];

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

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.integration.d.ts","sourceRoot":"","sources":["../../src/core/test-helpers.integration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAGL,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EAEpB,MAAM,kCAAkC,CAAC;AAG1C,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,GACrC,oBAAoB,8BAA8B,KACjD,oBACwD,CAAC;AAE5D,KAAK,kBAAkB,GAAG,mBAAmB,CAC3C,UAAU,CAAC,OAAO,mBAAmB,CAAC,EACtC,sBAAsB,EACtB,qBAAqB,CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CACtD,UAAU,CAAC,OAAO,mBAAmB,CAAC,EACtC;IAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAE,EAC/C,OAAO,CACR,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,mBAAmB,OAAO,CAAC,gBAAgB,CAAC,KAC3C,sBASC,CAAC;AAEL,eAAO,MAAM,+BAA+B,GAC1C,UAAS,sCAA2C,KACnD,OAAO,CAAC;IACT,OAAO,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAC7D,eAAe,EAAE,kBAAkB,CAAC;CACrC,CAsBA,CAAC"}
+{"version":3,"file":"test-helpers.integration.d.ts","sourceRoot":"","sources":["../../src/core/test-helpers.integration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAGL,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGvE,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,GACrC,oBAAoB,8BAA8B,KACjD,oBACwD,CAAC;AAE5D,KAAK,kBAAkB,GAAG,mBAAmB,CAC3C,UAAU,CAAC,OAAO,mBAAmB,CAAC,EACtC,sBAAsB,EACtB,qBAAqB,CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CACtD,UAAU,CAAC,OAAO,mBAAmB,CAAC,EACtC;IAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAE,EAC/C,OAAO,CACR,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,mBAAmB,4BAA4B,KAC9C,sBAUC,CAAC;AAEL,eAAO,MAAM,+BAA+B,GAC1C,UAAS,sCAA2C,KACnD,OAAO,CAAC;IACT,OAAO,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAC7D,eAAe,EAAE,kBAAkB,CAAC;CACrC,CAuBA,CAAC"}

package/types/core/test-utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026 Microblink Ltd. All rights reserved.
+ */
+import { Country, DocumentClassInfo, DocumentType, Region } from "@microblink/blinkid-core";
+export declare const createDocumentClassInfo: ({ type, country, region, countryName, isoNumericCountryCode, isoAlpha2CountryCode, isoAlpha3CountryCode, }: {
+    type?: DocumentType | undefined;
+    country?: Country | undefined;
+    region?: Region | undefined;
+    countryName?: string;
+    isoNumericCountryCode?: string;
+    isoAlpha2CountryCode?: string;
+    isoAlpha3CountryCode?: string;
+}) => DocumentClassInfo;
+//# sourceMappingURL=test-utils.d.ts.map

package/types/core/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/core/test-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,MAAM,EACP,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,uBAAuB,GAAI,4GAQrC;IACD,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,KAAG,iBAUH,CAAC"}

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

@@ -37,7 +37,8 @@ export declare function isPassportWithBarcode(docClass: DocumentClassInfo | unde
  * @param docClass - The document class info.
  * @returns True if the document is a passport without a barcode on the last page (not USA or India), false otherwise.
  */
-export declare function isPassportWithoutBarcode(docClass: DocumentClassInfo | undefined): boolean; /**
+export declare function isPassportWithoutBarcode(docClass: DocumentClassInfo | undefined): boolean;
+/**
  * Utility type for document pagination types.
  */
 export type DocumentPagination = "passport-no-barcode" | "passport-with-barcode" | "other";

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

@@ -1 +1 @@
-{"version":3,"file":"ui-state-utils.d.ts","sourceRoot":"","sources":["../../src/core/ui-state-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,oBAAoB,qBAE3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAKT;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,oBAAoB,uDAEtE;AAED;;;;;GAKG;AAEH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,WAEjE;AACD;;;;;GAKG;AAEH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,WAK5E;AACD;;;;;GAKG;AAEH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,WAOxC,CAAC;;GAEC;AAEH,MAAM,MAAM,kBAAkB,GAC1B,qBAAqB,GACrB,uBAAuB,GACvB,OAAO,CAAC;AACZ;;;;;GAKG;AAEH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GACtC,kBAAkB,CAQpB"}
+{"version":3,"file":"ui-state-utils.d.ts","sourceRoot":"","sources":["../../src/core/ui-state-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,oBAAoB,qBAE3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAKT;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,oBAAoB,uDAEtE;AAED;;;;;GAKG;AAEH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,WAEjE;AACD;;;;;GAKG;AAEH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,WAK5E;AACD;;;;;GAKG;AAEH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,WAOxC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,qBAAqB,GACrB,uBAAuB,GACvB,OAAO,CAAC;AACZ;;;;;GAKG;AAEH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GACtC,kBAAkB,CAQpB"}

package/types/index.d.ts

@@ -11,11 +11,12 @@ export type * from "@microblink/feedback-stabilizer";
 export type * from "@microblink/ux-common/hapticFeedback";
 export * from "./core/blinkid-ui-state";
 export type { BlinkIdProcessingError } from "./core/BlinkIdProcessingError";
-export type { BlinkIdUxManager } from "./core/BlinkIdUxManager";
+export type { BlinkIdTimeoutConfiguration } from "./core/BlinkIdTimeoutConfiguration";
+export type { BlinkIdFrameProcessCallback, BlinkIdProgress, BlinkIdProgressTimerState, BlinkIdProgressTimerStatus, BlinkIdUxManager, } from "./core/BlinkIdUxManager";
 export * from "./core/createBlinkIdUxManager";
 export type { DocumentClassFilter } from "./core/DocumentClassFilter";
 export * from "./ui/createBlinkIdFeedbackUi";
-export type { LocaleRecord, LocalizationStrings, } from "./ui/LocalizationContext";
+export type { LocaleRecord, LocalizationStrings, PartialLocalizationStrings, } from "./ui/LocalizationContext";
 /**
  * The global interface.
  *

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,sCAAsC,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,cAAc,+BAA+B,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,cAAc,8BAA8B,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,QAAA,MAAM,UAAU,eAAW,CAAC;AAE5B;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,sBAAsB,EAAE,OAAO,UAAU,CAAC;CAC/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AAEH,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,sCAAsC,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,YAAY,EACV,2BAA2B,EAC3B,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,cAAc,8BAA8B,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,QAAA,MAAM,UAAU,eAAW,CAAC;AAE5B;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,sBAAsB,EAAE,OAAO,UAAU,CAAC;CAC/C"}