image-barcode-identifier 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,124 @@
-# Temporary Holding Version
+# image-barcode-identifier
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Reads barcodes from photos in the browser (or Node): you give it an image, it gives you the value.
+
+It is built for difficult labels - blur, skew, perspective, uneven light, long thin Code 128 - and is tested against
+photos of real labels. Everything ZXing reads works (Code 128/39/93, EAN/UPC, ITF, QR, DataMatrix, PDF417, Aztec, ...) plus a
+tolerant, checksum-validated Code 128 decoder, barcode localisation, perspective rectification, tiles and a rotation sweep.
+
+Nothing leaves the device. No server, no CDN: the ZXing WASM is embedded in the package.
+
+## Install
+
+```bash
+npm install image-barcode-identifier
+```
+
+## Use
+
+```ts
+import { readBarcode } from 'image-barcode-identifier';
+
+const value = await readBarcode(photo); // photo: File | Blob | ImageBitmap | <img> | <canvas> | ImageData | bytes
+// "BCMSY03E38AA4FD00AA41", or null when there is no barcode
+```
+
+Details (format, which stage found it, corner positions) and several barcodes per image:
+
+```ts
+import { readBarcodes } from 'image-barcode-identifier';
+
+const results = await readBarcodes(photo, { all: true, timeoutMs: 8000 });
+// [{ text, format, strategy, position }]  - [] when nothing was found
+```
+
+### Keep the UI responsive: use a Web Worker
+
+Decoding is CPU heavy (a fraction of a second to a few seconds on a phone). On the main thread it freezes the
+page, so in a UI run it in a worker. Two small steps:
+
+```ts
+// barcode.worker.ts  (a file in your app)
+import 'image-barcode-identifier/worker';
+```
+
+```ts
+import { createWorkerReader } from 'image-barcode-identifier/client';
+
+const reader = createWorkerReader(new Worker(new URL('./barcode.worker.ts', import.meta.url), { type: 'module' }));
+void reader.warmup(); // optional: load the engine in the background before the first photo
+
+const value = await reader.readBarcode(photo, { timeoutMs: 8000 });
+```
+
+`reader.terminate()` stops the worker and frees its memory (the engine uses a lot of it).
+
+### Vite
+
+Add this to `vite.config.ts`, otherwise `npm run dev` discovers the packages when you first read a barcode and reloads
+the whole page (production builds are not affected):
+
+```ts
+export default defineConfig({
+  worker: { format: 'es' },
+  optimizeDeps: {
+    include: [
+      'image-barcode-identifier',
+      'image-barcode-identifier/client',
+      'image-barcode-identifier/worker',
+      '@techstark/opencv-js',
+      'zxing-wasm/reader',
+    ],
+  },
+});
+```
+
+If you set `build.rollupOptions.output.manualChunks`, keep `@techstark/opencv-js` out of your eager vendor chunk.
+It is ~13 MB (about 4 MB gzipped) and is only downloaded when the first image is read.
+
+### Webpack / other bundlers
+
+Anything that supports `new Worker(new URL('./x.js', import.meta.url))` and dynamic `import()` works (webpack 5,
+Parcel, Rollup + plugins).
+
+## Options
+
+| option      | default | meaning                                                                                      |
+| ----------- | ------- | -------------------------------------------------------------------------------------------- |
+| `all`       | false   | find every barcode instead of stopping at the first                                          |
+| `thorough`  | false   | run the rotation sweep even when something was found                                         |
+| `timeoutMs` | none    | stop searching and return what was found so far (checked between attempts). Set one for a UI |
+| `maxEdge`   | 4096    | downscale so the longest edge is at most this. Normal phone photos are left untouched        |
+
+## Node
+
+Node has no image decoder, so pass raw RGBA pixels (from `sharp`, `pngjs`, `jpeg-js`, ...):
+
+```ts
+import { readBarcode } from 'image-barcode-identifier';
+const value = await readBarcode({ data: rgba, width, height });
+```
+
+## Notes
+
+- Results for a given image can depend on its resolution. Prefer sending the full-resolution photo to downscaling it.
+- A checksum-valid Code 128 read of a very blurry label can still be wrong; the reader keeps the lowest-error candidate
+  across several row bands, strips and widths, which fixed every misread seen so far. Validate values against your own
+  format (for example a fixed prefix and length) if a wrong read would be costly.
+- `zxing-wasm` and `@techstark/opencv-js` are pinned to exact versions on purpose: the embedded WASM binary must match
+  the JS that loads it.
+
+## Develop
+
+```bash
+npm install
+npm test         # reference barcode images + two real label photos, in Node
+npm run build    # embeds the wasm, compiles to dist/
+```
+
+## Publish
+
+```bash
+npm login
+npm publish      # prepublishOnly runs the typecheck, build and tests first
+```

package/dist/client.d.ts

@@ -0,0 +1,13 @@
+import type { BarcodeResult, ImageInput, ReadOptions } from './types.js';
+export type { BarcodeResult, ImageInput, Point, RawImage, ReadOptions } from './types.js';
+export interface WorkerReader {
+    /** Resolves with [] when nothing was found; rejects when decoding itself failed. */
+    readBarcodes(image: ImageInput, options?: ReadOptions): Promise<BarcodeResult[]>;
+    /** The value of the first barcode found, or `null`. */
+    readBarcode(image: ImageInput, options?: ReadOptions): Promise<string | null>;
+    /** Start loading OpenCV + ZXing in the worker so the first read is fast. */
+    warmup(): Promise<void>;
+    /** Terminate the worker (frees its memory) and reject everything in flight. */
+    terminate(): void;
+}
+export declare function createWorkerReader(worker: Worker): WorkerReader;

package/dist/client.js

@@ -0,0 +1,56 @@
+export function createWorkerReader(worker) {
+    let nextId = 1;
+    const pending = new Map();
+    worker.onmessage = ({ data }) => {
+        const entry = pending.get(data.id);
+        if (!entry)
+            return;
+        pending.delete(data.id);
+        if (data.type === 'error')
+            entry.reject(new Error(data.message));
+        else
+            entry.resolve(data);
+    };
+    worker.onerror = (event) => {
+        const error = new Error(event.message || 'Barcode worker failed to load');
+        for (const entry of pending.values())
+            entry.reject(error);
+        pending.clear();
+    };
+    const send = (request, transfer = []) => new Promise((resolve, reject) => {
+        pending.set(request.id, { resolve, reject });
+        worker.postMessage(request, transfer);
+    });
+    // Canvases and <img> elements can't be posted to a worker; bitmaps can, and are transferred (no copy).
+    const postable = async (image) => {
+        const isElement = (typeof HTMLImageElement !== 'undefined' && image instanceof HTMLImageElement) ||
+            (typeof HTMLCanvasElement !== 'undefined' && image instanceof HTMLCanvasElement) ||
+            (typeof OffscreenCanvas !== 'undefined' && image instanceof OffscreenCanvas);
+        const value = isElement ? await createImageBitmap(image) : image;
+        const transfer = typeof ImageBitmap !== 'undefined' && value instanceof ImageBitmap ? [value] : [];
+        return { image: value, transfer };
+    };
+    const readBarcodes = async (image, options) => {
+        const { image: value, transfer } = await postable(image);
+        const res = await send({ id: nextId++, type: 'read', image: value, options }, transfer);
+        return res.type === 'read' ? res.results : [];
+    };
+    return {
+        readBarcodes,
+        async readBarcode(image, options) {
+            const [first] = await readBarcodes(image, { ...options, all: false });
+            return first ? first.text : null;
+        },
+        async warmup() {
+            await send({ id: nextId++, type: 'warmup' });
+        },
+        terminate() {
+            worker.terminate();
+            const error = new Error('Barcode worker terminated');
+            for (const entry of pending.values())
+                entry.reject(error);
+            pending.clear();
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/code128.d.ts

@@ -0,0 +1,30 @@
+import type { Gray } from './ops.js';
+/** A decode with at most this mean error is trusted without checking the remaining row bands. */
+export declare const CONFIDENT_ERROR = 0.04;
+/**
+ * A checksum-valid decode with a larger mean error is rejected outright: correct reads of very blurry photos
+ * measured up to about 0.10, while misreads of a wrong region or heavy blur measured 0.125 and more. Returning
+ * nothing is better than returning a wrong barcode value.
+ */
+export declare const MAX_ERROR = 0.11;
+export interface Decoded {
+    text: string;
+    /** Mean per-module squared error (lower is better). */
+    error: number;
+}
+/**
+ * Decode a Code 128 barcode from a 1D intensity profile (dark bars on light ground, left-to-right).
+ * Returns the best checksum-valid decode or null.
+ */
+export declare function decodeProfile(profile: Float64Array): Decoded | null;
+/**
+ * strip: grayscale image of an upright barcode (bars vertical), with quiet zones. Tries several row bands and
+ * both reading directions.
+ *
+ * The checksum alone is a weak check (about 1 in 103 random misreads passes it) and different row bands of the
+ * same strip can disagree: on real photos a band over a smudge or the caption can produce a checksum-valid but
+ * wrong text. The match error tells them apart (correct decodes measured 0.03-0.05, wrong ones 0.07-0.09), so
+ * the lowest-error decode over all bands wins. Bands are only skipped once a decode is confident
+ * (error <= CONFIDENT_ERROR).
+ */
+export declare function decodeRectified(strip: Gray): Decoded | null;

package/dist/code128.js

@@ -0,0 +1,338 @@
+const CODE128_PATTERNS = [
+    '11011001100', '11001101100', '11001100110', '10010011000', '10010001100', '10001001100',
+    '10011001000', '10011000100', '10001100100', '11001001000', '11001000100', '11000100100',
+    '10110011100', '10011011100', '10011001110', '10111001100', '10011101100', '10011100110',
+    '11001110010', '11001011100', '11001001110', '11011100100', '11001110100', '11101101110',
+    '11101001100', '11100101100', '11100100110', '11101100100', '11100110100', '11100110010',
+    '11011011000', '11011000110', '11000110110', '10100011000', '10001011000', '10001000110',
+    '10110001000', '10001101000', '10001100010', '11010001000', '11000101000', '11000100010',
+    '10110111000', '10110001110', '10001101110', '10111011000', '10111000110', '10001110110',
+    '11101110110', '11010001110', '11000101110', '11011101000', '11011100010', '11011101110',
+    '11101011000', '11101000110', '11100010110', '11101101000', '11101100010', '11100011010',
+    '11101111010', '11001000010', '11110001010', '10100110000', '10100001100', '10010110000',
+    '10010000110', '10000101100', '10000100110', '10110010000', '10110000100', '10011010000',
+    '10011000010', '10000110100', '10000110010', '11000010010', '11001010000', '11110111010',
+    '11000010100', '10001111010', '10100111100', '10010111100', '10010011110', '10111100100',
+    '10011110100', '10011110010', '11110100100', '11110010100', '11110010010', '11011011110',
+    '11011110110', '11110110110', '10101111000', '10100011110', '10001011110', '10111101000',
+    '10111100010', '11110101000', '11110100010', '10111011110', '10111101110', '11101011110',
+    '11110101110', '11010000100', '11010010000', '11010011100',
+];
+const STOP_PATTERN = '1100011101011'; // 13 modules incl. final termination bar
+const P = new Float64Array(CODE128_PATTERNS.length * 11); // (106, 11) flattened
+CODE128_PATTERNS.forEach((p, v) => {
+    for (let i = 0; i < 11; i++)
+        P[v * 11 + i] = p.charCodeAt(i) - 48;
+});
+const STOP = Float64Array.from(STOP_PATTERN, (c) => c.charCodeAt(0) - 48);
+const N_PATTERNS = CODE128_PATTERNS.length;
+const START_A = 103;
+const START_B = 104;
+const START_C = 105;
+/** A decode with at most this mean error is trusted without checking the remaining row bands. */
+export const CONFIDENT_ERROR = 0.04;
+/**
+ * A checksum-valid decode with a larger mean error is rejected outright: correct reads of very blurry photos
+ * measured up to about 0.10, while misreads of a wrong region or heavy blur measured 0.125 and more. Returning
+ * nothing is better than returning a wrong barcode value.
+ */
+export const MAX_ERROR = 0.11;
+/** values: start, data... (without checksum). */
+function translate(values) {
+    let mode = values[0] === START_A ? 'A' : values[0] === START_B ? 'B' : 'C';
+    let out = '';
+    let shiftOnce = false;
+    for (let k = 1; k < values.length; k++) {
+        const v = values[k];
+        let cur = mode;
+        if (shiftOnce) {
+            cur = mode === 'A' ? 'B' : 'A';
+            shiftOnce = false;
+        }
+        if (cur === 'C') {
+            if (v < 100)
+                out += String(v).padStart(2, '0');
+            else if (v === 100)
+                mode = 'B';
+            else if (v === 101)
+                mode = 'A';
+            continue;
+        }
+        if (v < 96) {
+            if (cur === 'A')
+                out += String.fromCharCode(v < 64 ? 32 + v : v - 64);
+            else
+                out += String.fromCharCode(32 + v);
+        }
+        else if (v === 98)
+            shiftOnce = true;
+        else if (v === 99)
+            mode = 'C';
+        else if (v === 100 && cur === 'A')
+            mode = 'B';
+        else if (v === 101 && cur === 'B')
+            mode = 'A';
+        // FNC1-4 are ignored
+    }
+    return out;
+}
+function sampler(darkness) {
+    const n = darkness.length;
+    const cum = new Float64Array(n + 1);
+    for (let i = 0; i < n; i++)
+        cum[i + 1] = cum[i] + darkness[i];
+    const interp = (x) => {
+        const i = Math.floor(x);
+        return i >= n ? cum[n] : cum[i] + (x - i) * darkness[i];
+    };
+    return (a, b) => {
+        a = Math.min(Math.max(a, 0), n);
+        b = Math.min(Math.max(b, 0), n);
+        return (interp(b) - interp(a)) / Math.max(b - a, 1e-6);
+    };
+}
+function linspace(a, b, n) {
+    return Array.from({ length: n }, (_, i) => a + ((b - a) * i) / (n - 1));
+}
+/** Decode `nChars` symbol characters (start..checksum) followed by the stop pattern. */
+function tryDecode(avg, start, m, nChars) {
+    const shifts = linspace(-0.45 * m, 0.45 * m, 10);
+    const samples = new Float64Array(11);
+    let pos = start;
+    const values = [];
+    let totalErr = 0;
+    for (let c = 0; c < nChars; c++) {
+        let bestErr = Infinity;
+        let bestS = 0;
+        let bestV = 0;
+        for (let s = 0; s < shifts.length; s++) {
+            for (let i = 0; i < 11; i++) {
+                const center = pos + shifts[s] + (i + 0.5) * m;
+                samples[i] = avg(center - 0.3 * m, center + 0.3 * m);
+            }
+            for (let v = 0; v < N_PATTERNS; v++) {
+                let err = 0;
+                for (let i = 0; i < 11; i++) {
+                    const d = samples[i] - P[v * 11 + i];
+                    err += d * d;
+                }
+                if (err < bestErr) {
+                    bestErr = err;
+                    bestS = s;
+                    bestV = v;
+                }
+            }
+        }
+        const e = bestErr / 11;
+        if (e > 0.2)
+            return null;
+        if (c === 0 && bestV !== START_A && bestV !== START_B && bestV !== START_C)
+            return null;
+        totalErr += e;
+        values.push(bestV);
+        pos += shifts[bestS] + 11 * m;
+    }
+    // stop pattern
+    let stopErr = Infinity;
+    const stopSamples = new Float64Array(13);
+    for (const shift of shifts) {
+        for (let i = 0; i < 13; i++) {
+            const center = pos + shift + (i + 0.5) * m;
+            stopSamples[i] = avg(center - 0.3 * m, center + 0.3 * m);
+        }
+        let err = 0;
+        for (let i = 0; i < 13; i++) {
+            const d = stopSamples[i] - STOP[i];
+            err += d * d;
+        }
+        if (err < stopErr)
+            stopErr = err;
+    }
+    if (stopErr / 13 > 0.2)
+        return null;
+    // checksum
+    const data = values.slice(0, -1);
+    const check = values[values.length - 1];
+    let sum = data[0];
+    for (let i = 1; i < data.length; i++)
+        sum += i * data[i];
+    if (sum % 103 !== check)
+        return null;
+    const text = translate(data);
+    if (!text)
+        return null;
+    return { text, error: totalErr / nChars };
+}
+/** Cheap prefilter: does the first 11 modules look like a Start A/B/C pattern? */
+function startCharOk(avg, start, m) {
+    const shifts = linspace(-0.45 * m, 0.45 * m, 7);
+    const samples = new Float64Array(11);
+    for (const shift of shifts) {
+        for (let i = 0; i < 11; i++) {
+            const center = start + shift + (i + 0.5) * m;
+            samples[i] = avg(center - 0.3 * m, center + 0.3 * m);
+        }
+        for (let v = START_A; v <= START_C; v++) {
+            let err = 0;
+            for (let i = 0; i < 11; i++) {
+                const d = samples[i] - P[v * 11 + i];
+                err += d * d;
+            }
+            if (err / 11 < 0.25)
+                return true;
+        }
+    }
+    return false;
+}
+function percentile(values, q) {
+    const sorted = Float64Array.from(values).sort();
+    const idx = (q / 100) * (sorted.length - 1);
+    const lo = Math.floor(idx);
+    const hi = Math.min(lo + 1, sorted.length - 1);
+    return sorted[lo] + (sorted[hi] - sorted[lo]) * (idx - lo);
+}
+/** Sliding max/min over a window of width k (odd), window truncated at the borders. */
+function slidingExtreme(row, k, pickMax) {
+    const n = row.length;
+    const r = k >> 1;
+    const out = new Float64Array(n);
+    for (let i = 0; i < n; i++) {
+        let best = row[i];
+        for (let j = Math.max(0, i - r); j <= Math.min(n - 1, i + r); j++) {
+            if (pickMax ? row[j] > best : row[j] < best)
+                best = row[j];
+        }
+        out[i] = best;
+    }
+    return out;
+}
+/** Normalised box blur with BORDER_REFLECT_101 (like cv2.blur on a single row). */
+function boxBlur(row, k) {
+    const n = row.length;
+    const r = k >> 1;
+    const reflect = (i) => {
+        if (n === 1)
+            return 0;
+        while (i < 0 || i >= n)
+            i = i < 0 ? -i : 2 * (n - 1) - i;
+        return i;
+    };
+    const out = new Float64Array(n);
+    let acc = 0;
+    for (let j = -r; j <= r; j++)
+        acc += row[reflect(j)];
+    out[0] = acc / k;
+    for (let i = 1; i < n; i++) {
+        acc += row[reflect(i + r)] - row[reflect(i - 1 - r)];
+        out[i] = acc / k;
+    }
+    return out;
+}
+const clip01 = (x) => (x < 0 ? 0 : x > 1 ? 1 : x);
+/** 0..1 darkness: one with global normalisation, one with local (uneven lighting). */
+function* darknessMaps(p) {
+    const n = p.length;
+    const lo = percentile(p, 2);
+    const hi = percentile(p, 98);
+    if (hi - lo >= 25) {
+        const out = new Float64Array(n);
+        for (let i = 0; i < n; i++)
+            out[i] = clip01((hi - p[i]) / (hi - lo));
+        yield out;
+    }
+    const k = Math.max(31, Math.floor(n / 6) | 1);
+    const mx = boxBlur(slidingExtreme(p, k, true), k);
+    const mn = boxBlur(slidingExtreme(p, k, false), k);
+    const out = new Float64Array(n);
+    for (let i = 0; i < n; i++)
+        out[i] = clip01((mx[i] - p[i]) / Math.max(mx[i] - mn[i], 25));
+    yield out;
+}
+function decodeDark(dark) {
+    let count = 0;
+    let first = -1;
+    let last = -1;
+    for (let i = 0; i < dark.length; i++) {
+        if (dark[i] > 0.5) {
+            count++;
+            if (first < 0)
+                first = i;
+            last = i;
+        }
+    }
+    if (count < 50)
+        return null;
+    const start = first;
+    const width = last + 1 - first;
+    const avg = sampler(dark);
+    let best = null;
+    for (let nChars = 3; nChars < 80; nChars++) {
+        // start + data + checksum
+        const m = width / (11 * nChars + 13);
+        if (m < 1.2)
+            break;
+        if (!startCharOk(avg, start, m))
+            continue;
+        for (const dm of [1.0, 0.99, 1.01, 0.98, 1.02]) {
+            for (const ds of [0.0, -0.3 * m, 0.3 * m]) {
+                const res = tryDecode(avg, start + ds, m * dm, nChars);
+                if (res && (best === null || res.error < best.error))
+                    best = res;
+            }
+        }
+        if (best)
+            return best;
+    }
+    return best;
+}
+/**
+ * Decode a Code 128 barcode from a 1D intensity profile (dark bars on light ground, left-to-right).
+ * Returns the best checksum-valid decode or null.
+ */
+export function decodeProfile(profile) {
+    for (const dark of darknessMaps(profile)) {
+        const res = decodeDark(dark);
+        if (res)
+            return res;
+    }
+    return null;
+}
+/**
+ * strip: grayscale image of an upright barcode (bars vertical), with quiet zones. Tries several row bands and
+ * both reading directions.
+ *
+ * The checksum alone is a weak check (about 1 in 103 random misreads passes it) and different row bands of the
+ * same strip can disagree: on real photos a band over a smudge or the caption can produce a checksum-valid but
+ * wrong text. The match error tells them apart (correct decodes measured 0.03-0.05, wrong ones 0.07-0.09), so
+ * the lowest-error decode over all bands wins. Bands are only skipped once a decode is confident
+ * (error <= CONFIDENT_ERROR).
+ */
+export function decodeRectified(strip) {
+    const { width: w, height: h, data } = strip;
+    const bands = [[0.2, 0.8], [0.1, 0.4], [0.3, 0.6], [0.5, 0.9], [0.0, 1.0]];
+    let best = null;
+    for (const [a, b] of bands) {
+        const r0 = Math.trunc(h * a);
+        const r1 = Math.max(Math.trunc(h * b), r0 + 1);
+        const profile = new Float64Array(w);
+        for (let y = r0; y < r1; y++) {
+            const row = y * w;
+            for (let x = 0; x < w; x++)
+                profile[x] += data[row + x];
+        }
+        for (let x = 0; x < w; x++)
+            profile[x] /= r1 - r0;
+        const reversed = Float64Array.from(profile).reverse();
+        const inverted = profile.map((v) => 255 - v);
+        const invertedReversed = reversed.map((v) => 255 - v);
+        for (const prof of [profile, reversed, inverted, invertedReversed]) {
+            const res = decodeProfile(prof);
+            if (res && (best === null || res.error < best.error))
+                best = res;
+        }
+        if (best && best.error <= CONFIDENT_ERROR)
+            break;
+    }
+    return best;
+}
+//# sourceMappingURL=code128.js.map

package/dist/code128.js.map

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

package/dist/cv.d.ts

@@ -0,0 +1,8 @@
+export declare function setOpencvLoader(loader: (() => Promise<unknown>) | undefined): void;
+/** The loaded OpenCV.js module. Only valid after `loadCv()` resolved. */
+export declare function getCv(): any;
+/**
+ * Loads OpenCV.js once. The module is ~13 MB of JS with the WASM inlined, so it is imported lazily and only
+ * when the first image is processed.
+ */
+export declare function loadCv(): Promise<void>;

package/dist/cv.js

@@ -0,0 +1,38 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+let cvInstance;
+let cvPromise;
+let opencvLoader;
+export function setOpencvLoader(loader) {
+    opencvLoader = loader;
+}
+/** The loaded OpenCV.js module. Only valid after `loadCv()` resolved. */
+export function getCv() {
+    if (!cvInstance)
+        throw new Error('OpenCV is not loaded yet; await loadCv() first');
+    return cvInstance;
+}
+/**
+ * Loads OpenCV.js once. The module is ~13 MB of JS with the WASM inlined, so it is imported lazily and only
+ * when the first image is processed.
+ */
+export function loadCv() {
+    if (!cvPromise) {
+        cvPromise = (async () => {
+            const mod = await (opencvLoader ? opencvLoader() : import('@techstark/opencv-js'));
+            let cv = mod && mod.default ? mod.default : mod;
+            // Depending on the build, the export is a Promise, an already initialised module, or a module that
+            // signals readiness through a callback. Never return `cv` from this async function: the Emscripten
+            // module is a thenable and would be awaited recursively.
+            if (cv instanceof Promise)
+                cv = await cv;
+            else if (!cv.Mat)
+                await new Promise((resolve) => { cv.onRuntimeInitialized = () => resolve(); });
+            cvInstance = cv;
+        })();
+        cvPromise.catch(() => {
+            cvPromise = undefined; // a failed load (offline, blocked chunk) must not be cached
+        });
+    }
+    return cvPromise;
+}
+//# sourceMappingURL=cv.js.map

package/dist/cv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cv.js","sourceRoot":"","sources":["../src/cv.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,IAAI,UAAe,CAAC;AACpB,IAAI,SAAoC,CAAC;AACzC,IAAI,YAAkD,CAAC;AAEvD,MAAM,UAAU,eAAe,CAAC,MAA4C;IAC1E,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACnF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,MAAM,GAAG,GAAQ,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACxF,IAAI,EAAE,GAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACrD,mGAAmG;YACnG,mGAAmG;YACnG,yDAAyD;YACzD,IAAI,EAAE,YAAY,OAAO;gBAAE,EAAE,GAAG,MAAM,EAAE,CAAC;iBACpC,IAAI,CAAC,EAAE,CAAC,GAAG;gBAAE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,oBAAoB,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACvG,UAAU,GAAG,EAAE,CAAC;QAClB,CAAC,CAAC,EAAE,CAAC;QACL,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE;YACnB,SAAS,GAAG,SAAS,CAAC,CAAC,4DAA4D;QACrF,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}