@microblink/camera-manager 7.0.0-next.9 → 7.0.1

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@microblink/camera-manager",
-  "version": "7.0.0-next.9",
+  "version": "7.0.1",
   "author": "Microblink",
   "type": "module",
   "main": "./dist/camera-manager.js",
   "module": "./dist/camera-manager.js",
-  "description": "",
+  "description": "Manages cameras and stream, provides both a headless component and a UI component",
   "files": [
     "dist",
     "types"
   ],
   "peerDependencies": {
-    "@ark-ui/solid": "^4.10.1",
-    "solid-js": "^1.9.4",
+    "@ark-ui/solid": "^5.5.0",
+    "solid-js": "^1.9.5",
     "solid-zustand": "^1.8.1",
     "zustand": "^4.5.5"
   },
@@ -22,10 +22,10 @@
   "access": "public",
   "registry": "https://registry.npmjs.org/",
   "types": "./types/index.rollup.d.ts",
-  "homepage": "https://github.com/BlinkID/blinkid-next-web",
+  "homepage": "https://github.com/BlinkID/blinkid-web",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BlinkID/blinkid-next-web.git"
+    "url": "git+https://github.com/BlinkID/blinkid-web.git"
   },
   "exports": {
     ".": {

package/types/core/Camera.d.ts

@@ -1,8 +1,33 @@
 /**
  * Copyright (c) 2025 Microblink Ltd. All rights reserved.
  */
-import { VideoResolution } from "./CameraManager";
 export type FacingMode = "front" | "back" | undefined;
+/**
+ * Available video resolutions for the camera stream.
+ */
+export declare const videoResolutions: {
+    readonly "720p": {
+        readonly width: 1280;
+        readonly height: 720;
+    };
+    readonly "1080p": {
+        readonly width: 1920;
+        readonly height: 1080;
+    };
+    readonly "4k": {
+        readonly width: 3840;
+        readonly height: 2160;
+    };
+};
+export type Resolution = {
+    width: number;
+    height: number;
+};
+export type VideoResolutionName = keyof typeof videoResolutions;
+export declare function returnLongerSide(resolution: Resolution): number;
+export declare function getNormalizedResolution(resolution: Resolution): Resolution;
+export declare function matchClosestResolution(resolution: Resolution): VideoResolutionName;
+export declare function findResolutionKey(videoTrackResolution: Resolution): VideoResolutionName;
 /**
  * Represents a camera device and its active stream.
  */
@@ -24,11 +49,24 @@ export declare class Camera {
     torchSupported: boolean;
     torchEnabled: boolean;
     singleShotSupported: boolean;
+    maxSupportedResolution?: VideoResolutionName;
+    /**
+     * Reference to the original instance before it was proxied.
+     */
     original: this;
     notify: (reason?: unknown) => void;
     notifyStateChange?: (camera: Camera, reason?: unknown) => void;
     constructor(deviceInfo: InputDeviceInfo);
-    startStream(resolution: VideoResolution): Promise<MediaStream>;
+    startStream(resolution: VideoResolutionName): Promise<MediaStream>;
+    /**
+     * Acquires a camera stream with the specified resolution.
+     * If acquisition fails, it tries a lower resolution as fallback.
+     */
+    private acquireStreamWithFallback;
+    /**
+     * Populates the camera instance with capabilities from the stream.
+     */
+    private populateCapabilities;
     toggleTorch(): Promise<boolean>;
     stopStream(): void;
     getVideoTrack(): MediaStreamTrack | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../src/core/Camera.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtD;;GAEG;AACH,qBAAa,MAAM;;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACrE,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,UAAS;IACvB,YAAY,UAAS;IACrB,mBAAmB,UAAS;IAE5B,QAAQ,OAAQ;IAEhB,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;gBAanD,UAAU,EAAE,eAAe;IAmDjC,WAAW,CAAC,UAAU,EAAE,eAAe;IAsEvC,WAAW;IA+BjB,UAAU;IAUV,aAAa;CAQd"}
+{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../src/core/Camera.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAIkB,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAEhE,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAiB1E;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,GACrB,mBAAmB,CASrB;AAED,wBAAgB,iBAAiB,CAC/B,oBAAoB,EAAE,UAAU,GAC/B,mBAAmB,CA0BrB;AAED;;GAEG;AACH,qBAAa,MAAM;;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACrE,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,UAAS;IACvB,YAAY,UAAS;IACrB,mBAAmB,UAAS;IAC5B,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAE7C;;OAEG;IACH,QAAQ,OAAQ;IAEhB,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;gBAanD,UAAU,EAAE,eAAe;IAmDjC,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BxE;;;OAGG;YACW,yBAAyB;IAoCvC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+DtB,WAAW;IA+BjB,UAAU;IAUV,aAAa;CAQd"}

package/types/core/CameraManager.d.ts

@@ -1,44 +1,48 @@
 /**
  * Copyright (c) 2025 Microblink Ltd. All rights reserved.
  */
-import { Camera, FacingMode } from "./Camera";
+import { Camera, FacingMode, VideoResolutionName } from "./Camera";
 import { cameraManagerStore as store } from "./cameraManagerStore";
-export type FrameCaptureCallback = (frame: ImageData) => void | Promise<void>;
-/**
- * Available video resolutions for the camera stream.
- */
-export declare const videoResolutions: {
-    HD: {
-        width: number;
-        height: number;
-    };
-    FHD: {
-        width: number;
-        height: number;
-    };
-    UHD: {
-        width: number;
-        height: number;
-    };
-};
-export type VideoResolution = keyof typeof videoResolutions;
+import { Promisable } from "type-fest";
+import { ExtractionArea, VideoFrameProcessorInitOptions } from "./VideoFrameProcessor";
+export type FrameCaptureCallback = (frame: ImageData) => Promisable<ArrayBufferLike | void>;
+type CameraGetter = (cameras: Camera[]) => Camera | undefined;
 export type CameraPreference = {
-    preferredCamera: Camera;
-    preferredFacing?: never;
+    preferredCamera: Camera | undefined;
+    preferredFacing?: undefined;
+} | {
+    preferredCamera: CameraGetter | undefined;
+    preferredFacing?: undefined;
 } | {
     preferredFacing: FacingMode;
-    preferredCamera?: never;
+    preferredCamera?: undefined;
 } | {
-    preferredCamera?: never;
-    preferredFacing?: never;
+    preferredCamera?: undefined;
+    preferredFacing?: undefined;
 };
+export type StartCameraStreamOptions = {
+    autoplay?: boolean;
+} & CameraPreference;
+export type CameraManagerOptions = {
+    /** If true, the camera stream will be mirrored horizontally when started. */
+    mirrorFrontCameras: boolean;
+};
+export declare const defaultCameraManagerOptions: CameraManagerOptions;
 export declare class CameraManager {
     #private;
+    get userInitiatedAbort(): boolean;
+    set userInitiatedAbort(value: boolean);
+    /**
+     * Sets the area of the video frame that will be extracted.
+     * @param extractionArea The area of the video frame that will be extracted.
+     */
+    setExtractionArea(extractionArea: ExtractionArea): void;
+    constructor(options?: Partial<CameraManagerOptions>, videoFrameProcessorOptions?: VideoFrameProcessorInitOptions);
     /**
      * Sets the resolution of the camera stream
      */
-    setResolution: (resolution: VideoResolution) => Promise<void>;
-    get resolution(): "HD" | "FHD" | "UHD";
+    setResolution: (resolution: VideoResolutionName) => Promise<void>;
+    get resolution(): "720p" | "1080p" | "4k";
     /**
      * True if there is a video playing or capturing
      * TODO: see if we can simplify this, by observing the video playback state
@@ -49,9 +53,9 @@ export declare class CameraManager {
      * Returns the cameras that are available to the user, filtered by the facing mode.
      * If no facing mode is set, all cameras are returned.
      */
-    getCameras(): Camera[];
+    getCameraDevices(): Promise<Camera[]>;
     /**
-     * Single-time setup for a video element
+     * Initializes the CameraManager with a video element.
      */
     initVideoElement(videoElement: HTMLVideoElement): void;
     /**
@@ -62,9 +66,11 @@ export declare class CameraManager {
      * @returns a cleanup function to remove the callback
      */
     addFrameCaptureCallback(frameCaptureCallback: FrameCaptureCallback): () => boolean;
-    deinitVideoElement(): void;
+    releaseVideoElement(): void;
     /**
      * Select a camera device from available ones.
+     *
+     * TODO: might become a private method in the future as an implementation detail of `startStream`
      */
     selectCamera(camera: Camera): Promise<void>;
     /**
@@ -78,17 +84,14 @@ export declare class CameraManager {
      */
     startPlayback(): Promise<void>;
     /**
-     * Starts playback and frame capturing.
+     * Starts capturing frames from the video element.
      */
-    startFrameCapture(): Promise<void>;
+    startFrameCapture: () => Promise<void>;
     /**
      * Starts a best-effort camera stream. Will pick a camera automatically if
      * none is selected.
-     * TODO: Rename method
      */
-    startCameraStream({ autoplay, preferredCamera, preferredFacing, }?: {
-        autoplay?: boolean;
-    } & CameraPreference): Promise<void>;
+    startCameraStream(params?: StartCameraStreamOptions): Promise<void>;
     /**
      * Pauses capturing frames without pausing playback.
      */
@@ -103,9 +106,8 @@ export declare class CameraManager {
     pausePlayback(): void;
     /**
      * If true, the video and captured frames will be mirrored horizontally.
-     * TODO: apply when needed
      */
-    setMirrorX(mirrorX: boolean): void;
+    setCameraMirrorX(mirrorX: boolean): void;
     /**
      * Allows the user to subscribe to state changes inside the Camera Manager.
      * Implemented using Zustand. For usage information, see
@@ -119,6 +121,7 @@ export declare class CameraManager {
     /**
      * Resets the CameraManager and stop all streams
      */
-    destroy(): void;
+    reset(): void;
 }
+export {};
 //# sourceMappingURL=CameraManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../src/core/CameraManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAO9C,OAAO,EAGL,kBAAkB,IAAI,KAAK,EAC5B,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAI5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GACxB;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACpD;IAAE,eAAe,EAAE,UAAU,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACxD;IAAE,eAAe,CAAC,EAAE,KAAK,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEzD,qBAAa,aAAa;;IAiBxB;;OAEG;IACH,aAAa,eAAsB,eAAe,mBAUhD;IAEF,IAAI,UAAU,yBAEb;IAED;;;OAGG;IACH,IAAI,QAAQ,YAEX;IAED,eAAe,CAAC,YAAY,EAAE,UAAU,EAAE;IAM1C;;;OAGG;IACH,UAAU;IAsBV;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,gBAAgB;IAyE/C;;;;;;OAMG;IACH,uBAAuB,CAAC,oBAAoB,EAAE,oBAAoB;IAKlE,kBAAkB;IAQlB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM;IA0DjC;;OAEG;IACG,oBAAoB;IAgE1B;;;;OAIG;IACG,aAAa;IAuCnB;;OAEG;IACG,iBAAiB;IAqCvB;;;;OAIG;IACG,iBAAiB,CAAC,EACtB,QAAe,EACf,eAAe,EACf,eAAe,GAChB,GAAE;QACD,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GAAG,gBAAqB;IA8EzB;;OAEG;IACH,gBAAgB;IAMhB;;OAEG;IACH,UAAU;IAcV;;OAEG;IACH,aAAa;IAmDb;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO;IAQ3B;;;;OAIG;IACH,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,CAAmB;IAEpD;;OAEG;IACH,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,CAAkB;IAEjD;;OAEG;IACH,OAAO;CAKR"}
+{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../src/core/CameraManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAQnE,OAAO,EAGL,kBAAkB,IAAI,KAAK,EAC5B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EACL,cAAc,EAGd,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,oBAAoB,GAAG,CACjC,KAAK,EAAE,SAAS,KACb,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAExC,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GACxB;IAEE,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,GACD;IAEE,eAAe,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1C,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,GACD;IAEE,eAAe,EAAE,UAAU,CAAC;IAC5B,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,GACD;IAEE,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,gBAAgB,CAAC;AAErB,MAAM,MAAM,oBAAoB,GAAG;IACjC,6EAA6E;IAC7E,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAEhC,CAAC;AAEX,qBAAa,aAAa;;IAmBxB,IAAI,kBAAkB,IAIQ,OAAO,CAFpC;IAED,IAAI,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAEpC;IAED;;;OAGG;IACH,iBAAiB,CAAC,cAAc,EAAE,cAAc;gBAW9C,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM,EAC3C,0BAA0B,CAAC,EAAE,8BAA8B;IAa7D;;OAEG;IACH,aAAa,GAAU,YAAY,mBAAmB,mBAUpD;IAEF,IAAI,UAAU,4BAEb;IAED;;;OAGG;IACH,IAAI,QAAQ,YAEX;IAED,eAAe,CAAC,YAAY,EAAE,UAAU,EAAE;IAM1C;;;OAGG;IACG,gBAAgB;IAsHtB;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,gBAAgB;IAY/C;;;;;;OAMG;IACH,uBAAuB,CAAC,oBAAoB,EAAE,oBAAoB;IAKlE,mBAAmB;IAQnB;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM;IA0DjC;;OAEG;IACG,oBAAoB;IAuE1B;;;;OAIG;IACG,aAAa;IAqFnB;;OAEG;IACH,iBAAiB,sBAUf;IA4GF;;;OAGG;IACG,iBAAiB,CAAC,MAAM,GAAE,wBAA6B;IAqB7D;;OAEG;IACH,gBAAgB;IAMhB;;OAEG;IACH,UAAU;IAYV;;OAEG;IACH,aAAa;IAmIb;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO;IAyBjC;;;;OAIG;IACH,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,CAAmB;IAEpD;;OAEG;IACH,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,CAAkB;IAEjD;;OAEG;IACH,KAAK;CAMN"}

package/types/core/VideoFrameProcessor.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ */
+export type CanvasRenderingMode = "2d" | "webgl2";
+export type ImageSource = HTMLVideoElement | HTMLCanvasElement | ImageBitmap;
+export type VideoFrameProcessorInitOptions = {
+    canvasRenderingMode?: CanvasRenderingMode;
+    fallbackWebGlTo2d?: boolean;
+};
+/**
+ * Check if an ArrayBuffer is detached
+ * @param buffer - ArrayBuffer to check
+ * @returns true if the buffer is detached, false otherwise
+ */
+export declare function isBufferDetached(buffer: ArrayBuffer): boolean;
+export type ExtractionArea = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * VideoFrameProcessor captures frames from video or image sources using either 2D or WebGL2 rendering
+ */
+export declare class VideoFrameProcessor {
+    #private;
+    constructor(options?: VideoFrameProcessorInitOptions);
+    /**
+     * Returns ownership of an ArrayBuffer to the processor for reuse
+     * This should only be called with ArrayBuffers that were originally from this processor
+     * Typically used after transferring the buffer to/from a worker
+     */
+    reattachArrayBuffer(arrayBuffer: ArrayBufferLike): void;
+    /**
+     * Used to check if the processor owns the buffer
+     */
+    isBufferDetached(): boolean;
+    /**
+     * Extracts image data from a source element
+     */
+    getImageData(source: ImageSource, area?: ExtractionArea): ImageData;
+    /**
+     * Used to get the current ImageData object with the current buffer. Useful
+     * when you need to get the same `ImageData` object multiple times after the
+     * original `ImageData` buffer has been detached
+     * @returns ImageData object with the current buffer
+     */
+    getCurrentImageData(): ImageData;
+    /**
+     * Clean up resources
+     */
+    dispose(): void;
+}
+/**
+ * Converts a view to a buffer, since both match the type signature of
+ * `ArrayBufferLike`.
+ * @param buffer - The buffer or view to convert
+ * @returns The actual underlying buffer
+ */
+export declare const getBuffer: (buffer: ArrayBufferLike) => ArrayBufferLike;
+//# sourceMappingURL=VideoFrameProcessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameProcessor.d.ts","sourceRoot":"","sources":["../../src/core/VideoFrameProcessor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAE7E,MAAM,MAAM,8BAA8B,GAAG;IAC3C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAe7D;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,qBAAa,mBAAmB;;gBAYlB,OAAO,GAAE,8BAAmC;IAyFxD;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAoBvD;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAO3B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS;IAMnE;;;;;OAKG;IACH,mBAAmB,IAAI,SAAS;IA0HhC;;OAEG;IACH,OAAO,IAAI,IAAI;CAehB;AACD;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,GAAI,QAAQ,eAAe,oBAOhD,CAAC"}

package/types/core/cameraManagerStore.d.ts

@@ -2,6 +2,7 @@
  * Copyright (c) 2025 Microblink Ltd. All rights reserved.
  */
 import { Camera, FacingMode } from "./Camera";
+import { CameraError } from "./cameraUtils";
 export type PlaybackState = "idle" | "playback" | "capturing";
 export type CameraManagerStore = {
     /**
@@ -40,7 +41,7 @@ export type CameraManagerStore = {
     /**
      * If the Camera manager has encountered an error, this will be set to the error.
      */
-    errorState?: Error;
+    errorState?: Error | CameraError;
 };
 /**
  * ⚠️ DANGER AHEAD ⚠️

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

@@ -1 +1 @@
-{"version":3,"file":"cameraManagerStore.d.ts","sourceRoot":"","sources":["../../src/core/cameraManagerStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAE5B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,aAAa,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,CAAC;AAeF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;CAG9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,YAOnC,CAAC"}
+{"version":3,"file":"cameraManagerStore.d.ts","sourceRoot":"","sources":["../../src/core/cameraManagerStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAE5B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,aAAa,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;CAClC,CAAC;AAeF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;CAG9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,YAOnC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"cameraNames.d.ts","sourceRoot":"","sources":["../../src/core/cameraNames.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,gWAuEF,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,mBAAmB,sUAmEH,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,uBAAuB,8vBA8CP,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,+BAA+B,krCAsCf,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,eAAe,WAAY,MAAM,YAAY,MAAM,EAAE,YAEjE,CAAC;AAEF,eAAO,MAAM,gBAAgB,WAAY,MAAM,YACF,CAAC;AAE9C,eAAO,MAAM,iBAAiB,WAAY,MAAM,YACF,CAAC"}
+{"version":3,"file":"cameraNames.d.ts","sourceRoot":"","sources":["../../src/core/cameraNames.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,gWAuEF,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,mBAAmB,sUAmEH,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,uBAAuB,8vBA8CP,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,+BAA+B,krCAsCf,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,EAAE,YAEjE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,YACF,CAAC;AAE9C,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,YACF,CAAC"}

package/types/core/cameraUtils.d.ts

@@ -1,20 +1,26 @@
 /**
  * Copyright (c) 2025 Microblink Ltd. All rights reserved.
  */
-import { Camera, FacingMode } from "./Camera";
-import { VideoResolution } from "./CameraManager";
+import { Camera, FacingMode, VideoResolutionName } from "./Camera";
+type CameraErrorCode = "PERMISSION_DENIED" | (string & {});
+export declare class CameraError extends Error {
+    code: CameraErrorCode;
+    constructor(message: string, code: CameraErrorCode, cause?: Error);
+}
 /**
  * Trigger camera permission dialog.
  */
 export declare const askForCameraPermission: () => Promise<void>;
 /**
- * Returns available camera (`videoinput`) devices on the user's device.
+ * Returns available camera devices on the user's device.
+ * @returns An array of {@linkcode InputDeviceInfo} objects representing the available camera devices.
  */
-export declare const getCameraDevices: () => Promise<InputDeviceInfo[]>;
+export declare const obtainVideoInputDevices: () => Promise<InputDeviceInfo[]>;
 export declare const closeStreamTracks: (stream: MediaStream) => void;
-export declare const createConstraints: (resolution: VideoResolution, facing?: FacingMode, id?: Camera["deviceInfo"]["deviceId"]) => MediaStreamConstraints;
+export declare const createConstraints: (resolution: VideoResolutionName, facing?: FacingMode, id?: Camera["deviceInfo"]["deviceId"]) => MediaStreamConstraints;
 /**
- * The thing from tldraw
+ * Finds the ideal camera based on the provided constraints.
+ *
  * @param cameras Available {@linkcode Camera}s on the device
  * @param resolution Ideal resolution for the camera stream, will fall back to the closest available resolution.
  * @param requestedFacing Ideal facing mode for the camera stream. If not provided, will default to back camera.
@@ -22,10 +28,11 @@ export declare const createConstraints: (resolution: VideoResolution, facing?: F
  *
  * @returns A {@linkcode Camera} instance that matches the provided constraints, with an active stream.
  */
-export declare const findIdealCamera: (cameras: Camera[], resolution?: VideoResolution, requestedFacing?: FacingMode) => Promise<Camera>;
+export declare const findIdealCamera: (cameras: Camera[], resolution?: VideoResolutionName, requestedFacing?: FacingMode) => Promise<Camera>;
 /**
  * Creates an array of {@linkcode Camera} instances with stream from native
  * `deviceInfo` objects.
  */
 export declare function createCameras(cameras: InputDeviceInfo[]): Camera[];
+export {};
 //# sourceMappingURL=cameraUtils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cameraUtils.d.ts","sourceRoot":"","sources":["../../src/core/cameraUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAoB,MAAM,iBAAiB,CAAC;AAIpE;;GAEG;AACH,eAAO,MAAM,sBAAsB,qBAalC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,kCAkB5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,WAAW,SAKpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,eAChB,eAAe,WAClB,UAAU,OACd,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,2BActC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,YACjB,MAAM,EAAE,eACL,eAAe,oBACV,UAAU,KAC1B,OAAO,CAAC,MAAM,CA8HhB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,YAWvD"}
+{"version":3,"file":"cameraUtils.d.ts","sourceRoot":"","sources":["../../src/core/cameraUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EACL,MAAM,EACN,UAAU,EACV,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAMlB,KAAK,eAAe,GAAG,mBAAmB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE3D,qBAAa,WAAY,SAAQ,KAAK;IACpC,IAAI,EAAE,eAAe,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK;CAKlE;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,qBAkBlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,kCAkBnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,WAAW,SAKpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,mBAAmB,EAC/B,SAAS,UAAU,EACnB,KAAK,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,2BAuBtC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EAAE,EACjB,aAAY,mBAA0B,EACtC,kBAAiB,UAAmB,KACnC,OAAO,CAAC,MAAM,CAsIhB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,YAWvD"}

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAEvC;AAED,eAAO,MAAM,OAAO,WAAY,OAAO,KAAG,KASzC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,QAY9D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAEvC;AAED,eAAO,MAAM,OAAO,GAAI,QAAQ,OAAO,KAAG,KASzC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,QAY9D"}

package/types/index.d.ts

@@ -5,6 +5,7 @@ import "rvfc-polyfill";
 export * from "./core/cameraManagerStore";
 export * from "./core/Camera";
 export * from "./core/CameraManager";
+export * from "./core/VideoFrameProcessor";
 export * from "./ui/createCameraManagerUi";
 export { cameraUiRefStore } from "./ui/zustandRefStore";
 export type { CameraUiRefs } from "./ui/zustandRefStore";

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,CAAC;AAEvB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AAErC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EACV,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,QAAA,MAAM,UAAU,eAAW,CAAC;AAE5B,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,kBAAkB,EAAE,OAAO,UAAU,CAAC;CAC3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,CAAC;AAEvB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EACV,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,QAAA,MAAM,UAAU,eAAW,CAAC;AAE5B,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,kBAAkB,EAAE,OAAO,UAAU,CAAC;CAC3C"}