@gueshbzh-perso/scanner 0.5.1 → 0.6.0

package/README.md

@@ -1,7 +1,7 @@
 # @gueshbzh-perso/scanner
 
 Fast QR code & barcode scanning for the web. Rust/WebAssembly decoder, WebGL2
-frame pipeline, decoding in a Web Worker, camera management and a ready-made
+frame pipeline, parallel decoding in Web Workers, camera management and a ready-made
 overlay. No license key, no network calls: everything runs on the device.
 
 ⚠️ Work in progress: the API may still change before 1.0.
@@ -52,7 +52,8 @@ await reader.destroy();  // removes the preview, frees the engine
 | `overlay` | all on | `showRegion`, `showDetections`, `showTorchButton`, `showCameraSwitch`, `color`, or `false`. |
 | `feedback` | beep + vibrate | `{ beep, vibrate }` or `false`. |
 | `processing` | `{ maxDimension: 1024, backend: 'auto' }` | Decoder image size; `'webgl'`, `'canvas'` or `'auto'`. |
-| `worker` | `true` | Decode in a Web Worker; falls back to the main thread if unavailable. |
+| `worker` | `true` | Decode in Web Workers; falls back to the main thread if unavailable. |
+| `workers` | cores − 1 (1–3) | Number of decoding workers: frames are decoded in parallel. |
 | `wasmUrl`, `workerUrl` | auto | Override asset URLs (CDN, custom bundler setup). |
 
 ### Reader API
@@ -63,7 +64,7 @@ await reader.destroy();  // removes the preview, frees the engine
 - `setRegionOfInterest(region)`
 - `setTorch(on)`, `torchAvailable`, `setZoom(zoom)`, `switchCamera(deviceId?)`, `BarcodeReader.listCameras()`
 - `clearCooldown(text)` — allow a code to be reported again immediately
-- `stats` — `{ fps, decodeMs, grabMs, frameWidth, frameHeight, backend, worker, simd }`
+- `stats` — `{ fps, decodeMs, grabMs, frameWidth, frameHeight, backend, worker, workers, simd }`
 - `video` — the underlying `<video>` element
 
 Detection points are in video pixels (`video.videoWidth` space).
@@ -102,20 +103,24 @@ to your public folder and pass `workerUrl` / `wasmUrl` explicitly.
 camera ─▶ <video> ─▶ WebGL2: crop to ROI · RGB→luma · box-filter downscale · pack 4 px/texel
                          │  async readback (pixel-pack buffer + fence) — width×height bytes
                          ▼
-                Web Worker ─▶ WASM memory (no extra copy) ─▶ Rust engine
-                                                             │ fast pass every frame
-                                                             │ + 1 fallback per frame (CPU-time share)
-                                                             │   (try-harder, inverted, CLAHE, Sauvola)
-                                                             │ 1D quiet-zone check · multi-frame confirmation · de-dup
-                         ◀────────────── new codes + live detections
+   session (main thread) ─ plan ─▶ pool of Web Workers (parallel) ─▶ WASM memory ─▶ Rust decoder
+   strategy scheduling                                             │ fast pass every frame
+   multi-frame confirmation                                        │ + 1 fallback per frame (CPU-time share)
+   de-dup                                                          │   (try-harder, inverted, CLAHE, Sauvola, Linear)
+                         ◀────────── report (codes, timing) ───────┘ 1D quiet-zone check
+                 new codes + live detections
 overlay (ROI mask, highlights, torch / camera buttons) · beep · vibration
 ```
 
-- One frame in flight at a time: when the decoder is busy, frames are skipped
-  instead of queued, so latency never builds up.
+- The grab of the next frame overlaps the decoding of the previous ones, and
+  frames are decoded by several workers at once. When every worker is busy,
+  frames are skipped instead of queued, so latency never builds up.
+- The scan state lives in one place (main thread), so multi-frame
+  confirmation and de-duplication work across workers.
 - The SIMD build of the engine is picked automatically when the browser supports it.
 - If WebGL2 is missing or the context is lost, the pipeline switches to Canvas 2D.
 - If the engine crashes, the worker is restarted transparently.
+- The engine is downloaded and compiled once, then shared by every worker.
 
 ## Browser support
 

package/dist/core.d.ts

@@ -1,9 +1,17 @@
-import type { ScanResult, WasmScanConfig, PixelFormat } from './wasm/scanner_wasm.js';
+import type { FramePlan, FrameReport, PixelFormat, ScanResult, WasmScanConfig } from './wasm/scanner_wasm.js';
 import type { Detection, EngineOptions } from './types.js';
+export type { FramePlan, FrameReport };
 /** Feature-detects WebAssembly SIMD (same probe as `wasm-feature-detect`). */
 export declare function simdSupported(): boolean;
 /** Default location of the engine binary, next to this module. */
 export declare function defaultWasmUrl(simd?: boolean): URL;
+/**
+ * Compile the engine once. The compiled module can be posted to any number
+ * of workers, which then only instantiate it (no second download or compile).
+ */
+export declare function compileWasm(url: string | URL): Promise<WebAssembly.Module>;
+/** Instantiate the engine in this realm (once). Returns the engine version. */
+export declare function loadWasm(source: string | URL | WebAssembly.Module): Promise<string>;
 /** Keep only the engine options (drops URLs and other non-cloneable values). */
 export declare function pickEngineOptions(o: EngineOptions): EngineOptions;
 export declare function toWasmConfig(o: EngineOptions, extra?: Partial<WasmScanConfig>): WasmScanConfig;
@@ -15,17 +23,29 @@ export interface FrameOutcome {
     live: Detection[];
     decodeMs: number;
 }
-export declare class EngineCore {
-    readonly version: string;
+/** The scan session of a camera stream (state only, cheap calls). */
+export declare class SessionCore {
     private session;
-    private scanners;
-    private constructor();
-    static create(wasmUrl?: string | URL): Promise<EngineCore>;
     configure(options: EngineOptions): void;
+    /** Strategy plan of the next frame, for a `DecoderCore` configured the same way. */
+    plan(): FramePlan;
+    /** Record a decoded frame; returns the new codes and the live ones. */
+    commit(report: FrameReport): FrameOutcome;
+    /** Decode on this thread (inline engine): plan, decode and commit at once. */
     process(pixels: Uint8Array, width: number, height: number, format: PixelFormat): FrameOutcome;
-    scan(pixels: Uint8Array, width: number, height: number, format: PixelFormat, options: EngineOptions): Detection[];
     reset(): void;
     clearCooldown(text: string): void;
     destroy(): void;
+    private active;
+}
+/** Frame decoding (stateless) and still-image scanning: the expensive part. */
+export declare class DecoderCore {
+    private decoder;
+    private scanners;
+    configure(options: EngineOptions): void;
+    decode(pixels: Uint8Array, width: number, height: number, format: PixelFormat, plan: FramePlan): FrameReport;
+    /** One-shot scan of a still image, running every strategy. */
+    scan(pixels: Uint8Array, width: number, height: number, format: PixelFormat, options: EngineOptions): Detection[];
+    destroy(): void;
 }
 //# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,OAAO,CAWvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,UAAkB,GAAG,GAAG,CAI1D;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,aAAa,CAGjE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CASlG;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAIpD;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,UAAU;IAID,QAAQ,CAAC,OAAO,EAAE,MAAM;IAH5C,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAkC;IAElD,OAAO;WAEM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAMhE,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAOvC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY;IAY7F,IAAI,CACF,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,GACrB,SAAS,EAAE;IAiBd,KAAK,IAAI,IAAI;IAIb,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AAEvC,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,OAAO,CAWvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,UAAkB,GAAG,GAAG,CAI1D;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAQhF;AAID,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnF;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,aAAa,CAGjE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CASlG;AAYD,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAIpD;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qEAAqE;AACrE,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAgC;IAE/C,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKvC,oFAAoF;IACpF,IAAI,IAAI,SAAS;IAIjB,uEAAuE;IACvE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY;IAOzC,8EAA8E;IAC9E,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY;IAW7F,KAAK,IAAI,IAAI;IAIb,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,MAAM;CAIf;AAED,+EAA+E;AAC/E,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAkC;IAElD,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKvC,MAAM,CACJ,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,GACd,WAAW;IAOd,8DAA8D;IAC9D,IAAI,CACF,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,GACrB,SAAS,EAAE;IAiBd,OAAO,IAAI,IAAI;CAMhB"}

package/dist/core.js

@@ -1,6 +1,12 @@
-// Engine core: owns the WebAssembly module and the scan session.
-// Runs either inside the Web Worker (default) or on the main thread (fallback).
-import init, { WasmScanner, WasmScanSession, version } from './wasm/scanner_wasm.js';
+// Engine core: owns the WebAssembly module and its objects.
+//
+// Two roles, so that frames can be decoded on several threads while a single
+// session keeps the state (strategy scheduling, multi-frame confirmation,
+// de-duplication):
+// - `SessionCore`: the session. Cheap calls (`plan`, `commit`), main thread.
+// - `DecoderCore`: the expensive decoding, one per Web Worker.
+// The inline engine (no Worker support) uses both on the main thread.
+import init, { WasmFrameDecoder, WasmScanner, WasmScanSession, version } from './wasm/scanner_wasm.js';
 /** Feature-detects WebAssembly SIMD (same probe as `wasm-feature-detect`). */
 export function simdSupported() {
     try {
@@ -19,6 +25,26 @@ export function defaultWasmUrl(simd = simdSupported()) {
         ? new URL('./wasm/scanner_wasm_simd_bg.wasm', import.meta.url)
         : new URL('./wasm/scanner_wasm_bg.wasm', import.meta.url);
 }
+/**
+ * Compile the engine once. The compiled module can be posted to any number
+ * of workers, which then only instantiate it (no second download or compile).
+ */
+export async function compileWasm(url) {
+    const response = fetch(url);
+    try {
+        return await WebAssembly.compileStreaming(response);
+    }
+    catch {
+        // Servers that do not send `application/wasm` reject streaming compilation.
+        return WebAssembly.compile(await (await response).arrayBuffer());
+    }
+}
+let initPromise = null;
+/** Instantiate the engine in this realm (once). Returns the engine version. */
+export function loadWasm(source) {
+    initPromise ?? (initPromise = init({ module_or_path: source }).then(() => version()));
+    return initPromise;
+}
 /** Keep only the engine options (drops URLs and other non-cloneable values). */
 export function pickEngineOptions(o) {
     const { formats, preprocessing, tryInvert, maxResults, duplicateIntervalMs, linearConfirmations } = o;
@@ -39,42 +65,86 @@ export function toWasmConfig(o, extra = {}) {
         cfg.linearConfirmations = o.linearConfirmations;
     return cfg;
 }
+/**
+ * Configuration of camera sessions and their decoders: they must be equal,
+ * since a plan refers to the decoder's list of fallback strategies.
+ */
+function streamConfig(o) {
+    // Back-pressure is handled by the SDK (frames are skipped, never queued),
+    // so the engine's own frame-skipping throttle would only drop useful frames.
+    return toWasmConfig(o, { adaptiveThrottle: false });
+}
 export function toDetection(r) {
     const d = { text: r.text, format: r.format, points: r.points, timestamp: r.timestampMs };
     if (r.rawBytes)
         d.rawBytes = r.rawBytes;
     return d;
 }
-let initPromise = null;
-export class EngineCore {
-    constructor(version) {
-        this.version = version;
+/** The scan session of a camera stream (state only, cheap calls). */
+export class SessionCore {
+    constructor() {
         this.session = null;
-        this.scanners = new Map();
-    }
-    static async create(wasmUrl) {
-        initPromise ?? (initPromise = init({ module_or_path: wasmUrl ?? defaultWasmUrl() }));
-        await initPromise;
-        return new EngineCore(version());
     }
     configure(options) {
         this.session?.free();
-        // Back-pressure is handled by the SDK (one frame in flight), so the
-        // engine's own frame-skipping throttle would only drop useful frames.
-        this.session = new WasmScanSession(toWasmConfig(options, { adaptiveThrottle: false }));
+        this.session = new WasmScanSession(streamConfig(options));
     }
+    /** Strategy plan of the next frame, for a `DecoderCore` configured the same way. */
+    plan() {
+        return this.active().plan();
+    }
+    /** Record a decoded frame; returns the new codes and the live ones. */
+    commit(report) {
+        const session = this.active();
+        const fresh = session.commit(report);
+        const results = fresh ? fresh.map(toDetection) : null;
+        return { results, live: results ?? session.lastDetections.map(toDetection), decodeMs: report.elapsedMs };
+    }
+    /** Decode on this thread (inline engine): plan, decode and commit at once. */
     process(pixels, width, height, format) {
-        const session = this.session;
-        if (!session)
-            throw new Error('Engine not configured');
+        const session = this.active();
         // Write straight into WASM memory: avoids one more copy of the frame.
         session.frameBuffer(pixels.length).set(pixels);
         const t0 = performance.now();
-        const results = session.processFrameBuffer(width, height, format);
+        const fresh = session.processFrameBuffer(width, height, format);
         const decodeMs = performance.now() - t0;
-        const fresh = results ? results.map(toDetection) : null;
-        return { results: fresh, live: fresh ?? session.lastDetections.map(toDetection), decodeMs };
+        const results = fresh ? fresh.map(toDetection) : null;
+        return { results, live: results ?? session.lastDetections.map(toDetection), decodeMs };
+    }
+    reset() {
+        this.session?.reset();
     }
+    clearCooldown(text) {
+        this.session?.clearCooldown(text);
+    }
+    destroy() {
+        this.session?.free();
+        this.session = null;
+    }
+    active() {
+        if (!this.session)
+            throw new Error('Engine not configured');
+        return this.session;
+    }
+}
+/** Frame decoding (stateless) and still-image scanning: the expensive part. */
+export class DecoderCore {
+    constructor() {
+        this.decoder = null;
+        this.scanners = new Map();
+    }
+    configure(options) {
+        this.decoder?.free();
+        this.decoder = new WasmFrameDecoder(streamConfig(options));
+    }
+    decode(pixels, width, height, format, plan) {
+        const decoder = this.decoder;
+        if (!decoder)
+            throw new Error('Engine not configured');
+        decoder.frameBuffer(pixels.length).set(pixels);
+        return decoder.decodeFrameBuffer(width, height, format, plan);
+    }
+    /** One-shot scan of a still image, running every strategy. */
     scan(pixels, width, height, format, options) {
         const config = toWasmConfig(options);
         const key = JSON.stringify(config);
@@ -91,15 +161,9 @@ export class EngineCore {
         scanner.frameBuffer(pixels.length).set(pixels);
         return scanner.scanFrameBuffer(width, height, format).map(toDetection);
     }
-    reset() {
-        this.session?.reset();
-    }
-    clearCooldown(text) {
-        this.session?.clearCooldown(text);
-    }
     destroy() {
-        this.session?.free();
-        this.session = null;
+        this.decoder?.free();
+        this.decoder = null;
         for (const s of this.scanners.values())
             s.free();
         this.scanners.clear();

package/dist/core.js.map

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

package/dist/engine.d.ts

@@ -11,6 +11,8 @@ export interface Engine {
     readonly inWorker: boolean;
     readonly simd: boolean;
     readonly version: string;
+    /** Frames that can be decoded at the same time (number of workers). */
+    readonly concurrency: number;
     configure(options: EngineOptions): Promise<void>;
     /** Decode a camera frame. `buffer` is transferred and returned in the reply. */
     processFrame(buffer: ArrayBuffer, width: number, height: number, format: PixelFormat): Promise<FrameReply>;
@@ -20,8 +22,15 @@ export interface Engine {
     clearCooldown(text: string): Promise<void>;
     destroy(): void;
 }
-/** Load the engine, in a Web Worker when possible. */
+/**
+ * Default pool size: one worker per core, minus one for the main thread
+ * (camera, GPU, UI), capped at 3. Beyond 3 the frame rate is limited by the
+ * frame grab (~55 ms on a Galaxy A14, so ~18 fps) and more workers only cost
+ * memory (one WebAssembly instance each).
+ */
+export declare function defaultWorkerCount(): number;
+/** Load the engine: a pool of Web Workers when possible, else the main thread. */
 export declare function createEngine(options?: AssetOptions): Promise<Engine>;
-/** Engine shared by `scanImage` calls. */
+/** Engine shared by `scanImage` calls (one worker is enough for still images). */
 export declare function sharedEngine(options?: AssetOptions): Promise<Engine>;
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,gFAAgF;IAChF,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3G,8DAA8D;IAC9D,SAAS,CACP,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,IAAI,IAAI,CAAC;CACjB;AA4KD,sDAAsD;AACtD,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB9E;AAID,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,gFAAgF;IAChF,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3G,8DAA8D;IAC9D,SAAS,CACP,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AA+OD,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B9E;AAID,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE"}

package/dist/engine.js

@@ -1,12 +1,32 @@
-// Decoding engine facade: same API whether decoding runs in a Web Worker or inline.
-import { EngineCore, defaultWasmUrl, simdSupported } from './core.js';
-class WorkerEngine {
-    constructor(spawn, wasmUrl, simd) {
+// Decoding engine facade: same API whether decoding runs in Web Workers or inline.
+//
+// With workers, frames are decoded **in parallel** by a pool of stateless
+// decoders (one WebAssembly instance per worker), while the scan session
+// (strategy scheduling, multi-frame confirmation, de-duplication) runs on the
+// main thread: its calls take microseconds, and a single instance of the
+// state is what keeps confirmations and de-duplication correct across
+// workers. Decoding is CPU-bound and single-threaded per frame, so on phones
+// with many slow cores (Galaxy A14: decode ~125 ms) the pool multiplies the
+// frame rate.
+import { DecoderCore, SessionCore, compileWasm, defaultWasmUrl, loadWasm, simdSupported } from './core.js';
+/**
+ * Default pool size: one worker per core, minus one for the main thread
+ * (camera, GPU, UI), capped at 3. Beyond 3 the frame rate is limited by the
+ * frame grab (~55 ms on a Galaxy A14, so ~18 fps) and more workers only cost
+ * memory (one WebAssembly instance each).
+ */
+export function defaultWorkerCount() {
+    const cores = typeof navigator !== 'undefined' ? navigator.hardwareConcurrency || 2 : 2;
+    return Math.min(3, Math.max(1, cores - 1));
+}
+/** One decoding worker, restarted if the engine crashes. */
+class DecoderWorker {
+    constructor(spawn, module) {
         this.spawn = spawn;
-        this.wasmUrl = wasmUrl;
-        this.simd = simd;
-        this.inWorker = true;
+        this.module = module;
         this.version = '';
+        /** Requests sent and not answered yet. */
+        this.busy = 0;
         this.nextId = 1;
         this.pending = new Map();
         this.dead = null;
@@ -45,15 +65,21 @@ class WorkerEngine {
     }
     /** Send a request; on a fatal engine crash, restart the worker before throwing. */
     async ok(req, transfer) {
-        if (this.restarting)
-            await this.restarting;
-        const res = await this.call(req, transfer);
-        if (!res.ok) {
-            if (res.fatal)
-                await this.restart();
-            throw Object.assign(new Error(res.error), { buffer: res.buffer });
+        this.busy++;
+        try {
+            if (this.restarting)
+                await this.restarting;
+            const res = await this.call(req, transfer);
+            if (!res.ok) {
+                if (res.fatal)
+                    await this.restart();
+                throw Object.assign(new Error(res.error), { buffer: res.buffer });
+            }
+            return res;
+        }
+        finally {
+            this.busy--;
         }
-        return res;
     }
     restart() {
         this.restarting ?? (this.restarting = (async () => {
@@ -62,12 +88,12 @@ class WorkerEngine {
             this.attach(this.spawn());
             await this.init();
             if (this.options)
-                await this.ok({ type: 'configure', options: this.options });
+                await this.call({ type: 'configure', options: this.options });
         })().finally(() => (this.restarting = null)));
         return this.restarting;
     }
     async init() {
-        const res = await this.call({ type: 'init', wasmUrl: this.wasmUrl });
+        const res = await this.call({ type: 'init', module: this.module });
         if (!res.ok)
             throw new Error(res.error);
         this.version = res.version ?? '';
@@ -76,82 +102,148 @@ class WorkerEngine {
         this.options = options;
         await this.ok({ type: 'configure', options });
     }
+    destroy() {
+        this.fail(new Error('Engine destroyed'));
+        this.worker.terminate();
+    }
+}
+/** A pool of decoding workers serving one scan session on the main thread. */
+class WorkerPoolEngine {
+    constructor(workers, simd) {
+        this.workers = workers;
+        this.simd = simd;
+        this.inWorker = true;
+        this.session = new SessionCore();
+        this.configured = false;
+        /** Bumped by `configure`: reports planned with an older configuration are dropped. */
+        this.generation = 0;
+        this.version = workers[0]?.version ?? '';
+    }
+    get concurrency() {
+        return this.workers.length;
+    }
+    async configure(options) {
+        // Session and decoders must share the configuration: a plan is an index
+        // in the decoder's list of fallback strategies.
+        this.generation++;
+        this.session.configure(options);
+        this.configured = true;
+        await Promise.all(this.workers.map((w) => w.configure(options)));
+    }
     async processFrame(buffer, width, height, format) {
-        const res = await this.ok({ type: 'frame', buffer, width, height, format }, [buffer]);
-        return {
-            results: (res.ok && res.results) || null,
-            live: (res.ok && res.live) || [],
-            decodeMs: (res.ok && res.decodeMs) || 0,
-            buffer: res.buffer ?? new ArrayBuffer(width * height),
-        };
+        if (!this.configured)
+            throw new Error('Engine not configured');
+        const generation = this.generation;
+        const plan = this.session.plan();
+        let res;
+        try {
+            res = await this.idleWorker().ok({ type: 'decode', buffer, width, height, format, plan }, [buffer]);
+        }
+        catch (err) {
+            // Every plan must be committed, or the scheduler keeps counting it as in flight.
+            this.session.commit(emptyReport(plan));
+            throw err;
+        }
+        const returned = res.buffer ?? new ArrayBuffer(width * height);
+        if (generation !== this.generation || !res.report) {
+            return { results: null, live: [], decodeMs: 0, buffer: returned };
+        }
+        return { ...this.session.commit(res.report), buffer: returned };
     }
     async scanImage(buffer, width, height, format, options) {
-        const res = await this.ok({ type: 'scan', buffer, width, height, format, options }, [buffer]);
-        return (res.ok && res.results) || [];
+        const res = await this.idleWorker().ok({ type: 'scan', buffer, width, height, format, options }, [
+            buffer,
+        ]);
+        return res.results ?? [];
     }
     async reset() {
-        await this.ok({ type: 'reset' });
+        this.session.reset();
     }
     async clearCooldown(text) {
-        await this.ok({ type: 'clearCooldown', text });
+        this.session.clearCooldown(text);
     }
     destroy() {
-        this.fail(new Error('Engine destroyed'));
-        this.worker.terminate();
+        for (const w of this.workers)
+            w.destroy();
+        this.session.destroy();
+    }
+    /** The worker with the fewest requests in progress. */
+    idleWorker() {
+        let best = this.workers[0];
+        if (!best)
+            throw new Error('Engine destroyed');
+        for (const w of this.workers)
+            if (w.busy < best.busy)
+                best = w;
+        return best;
     }
 }
+function emptyReport(plan) {
+    return { plan, results: [], fallbackRan: false, fallbackRead: false, elapsedMs: 0 };
+}
+/** Everything on the main thread (no Worker support). */
 class InlineEngine {
-    constructor(core, simd) {
-        this.core = core;
+    constructor(version, simd) {
+        this.version = version;
         this.simd = simd;
         this.inWorker = false;
-        this.version = core.version;
+        this.concurrency = 1;
+        this.session = new SessionCore();
+        this.decoder = new DecoderCore();
     }
     async configure(options) {
-        this.core.configure(options);
+        this.session.configure(options);
     }
     async processFrame(buffer, width, height, format) {
-        return { ...this.core.process(new Uint8Array(buffer), width, height, format), buffer };
+        return { ...this.session.process(new Uint8Array(buffer), width, height, format), buffer };
     }
     async scanImage(buffer, width, height, format, options) {
-        return this.core.scan(new Uint8Array(buffer), width, height, format, options);
+        return this.decoder.scan(new Uint8Array(buffer), width, height, format, options);
     }
     async reset() {
-        this.core.reset();
+        this.session.reset();
     }
     async clearCooldown(text) {
-        this.core.clearCooldown(text);
+        this.session.clearCooldown(text);
     }
     destroy() {
-        this.core.destroy();
+        this.session.destroy();
+        this.decoder.destroy();
     }
 }
-/** Load the engine, in a Web Worker when possible. */
+/** Load the engine: a pool of Web Workers when possible, else the main thread. */
 export async function createEngine(options = {}) {
     const simd = simdSupported();
     const wasmUrl = new URL(String(options.wasmUrl ?? defaultWasmUrl(simd)), location.href).href;
+    // Compiled once here: the main thread needs the engine for the session,
+    // and the workers instantiate the same module without compiling it again.
+    const module = await compileWasm(wasmUrl);
+    const version = await loadWasm(module);
     if (options.worker !== false && typeof Worker !== 'undefined') {
         const workerUrl = options.workerUrl;
         const spawn = () => workerUrl
             ? new Worker(workerUrl, { type: 'module' })
             : new Worker(new URL('./worker.js', import.meta.url), { type: 'module' });
-        let engine = null;
+        const count = Math.max(1, Math.floor(options.workers ?? defaultWorkerCount()));
+        const workers = [];
         try {
-            engine = new WorkerEngine(spawn, wasmUrl, simd);
-            await engine.init();
-            return engine;
+            for (let i = 0; i < count; i++)
+                workers.push(new DecoderWorker(spawn, module));
+            await Promise.all(workers.map((w) => w.init()));
+            return new WorkerPoolEngine(workers, simd);
         }
         catch (err) {
-            engine?.destroy();
+            for (const w of workers)
+                w.destroy();
             console.warn('[scanner] Web Worker unavailable, decoding on the main thread:', err);
         }
     }
-    return new InlineEngine(await EngineCore.create(wasmUrl), simd);
+    return new InlineEngine(version, simd);
 }
 let shared = null;
-/** Engine shared by `scanImage` calls. */
+/** Engine shared by `scanImage` calls (one worker is enough for still images). */
 export function sharedEngine(options) {
-    shared ?? (shared = createEngine(options).catch((err) => {
+    shared ?? (shared = createEngine({ ...options, workers: 1 }).catch((err) => {
         shared = null;
         throw err;
     }));