tapirscan 1.2.0 → 1.2.1

package/README.md

@@ -1,10 +1,5 @@
 # Tapirscan for JavaScript and TypeScript
 
-This guide describes the 1.2.0 API revision. See [migration](../../docs/API_MIGRATION.md).
-Build/install this checkout using [the development guide](../../docs/DEVELOPMENT.md)
-to use these changes before publication; older registry packages use their own
-versioned API.
-
 Scan image pixels in a browser or Node with the same Rust/WASM core.
 [Try the live demo](https://tapirscan.netlify.app) · [Quick start](#quick-start) · [WASM loading](#wasm-loading) · [Functions](#functions) · [All options](#all-options) · [Results](#results)
 
@@ -29,7 +24,7 @@ const result = await scan(image);
 console.log(result.values); // e.g. ["4006381333931"]
 ```
 
-Defaults are Medium effort, EAN13, multiple results, and debug disabled.
+Defaults are Medium effort, retail formats, multiple results, and debug disabled.
 `result.barcodes` also gives each read's text, format, polygon and rectangle.
 The helper creates and disposes a scanner automatically. Browser apps need to
 serve its [WASM assets](#wasm-loading); Node loads the packaged files automatically.
@@ -141,7 +136,7 @@ call and does not change the default formats. Previously returned results surviv
 | Option           | Where               | Default                | Meaning                                                                                                                                                           |
 | ---------------- | ------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `mode`           | Creation            | `"medium"`             | `"low"`, `"medium"`, `"high"`, `"very-high"`.                                                                                                                     |
-| `formats`        | Creation / scan     | `["EAN13"]`            | A single identifier, `"retail"`, `"common1D"`, `"common"`, `"1D"`, `"2D"`, `"all"`, or a nonempty array. Per-call selections must be subsets of creation formats. |
+| `formats`        | Creation / scan     | `"retail"`             | A single identifier, `"retail"`, `"common1D"`, `"common"`, `"1D"`, `"2D"`, `"all"`, or a nonempty array. Per-call selections must be subsets of creation formats. |
 | `wasmBaseUrl`    | Creation            | Module-relative assets | Directory URL for packaged WASMs. Use this for normal browser hosting.                                                                                            |
 | `loadWasm`       | Creation            | Module-relative loader | `(url: URL) => Promise<ArrayBuffer>`. Uses HTTP fetch in browsers and filesystem reads for Node file URLs.                                                        |
 | `eanAddOnPolicy` | Creation / one-shot | `"Ignore"`             | `"Ignore"`, `"Read"`, `"Require"`; optional EAN/UPC supplement policy.                                                                                            |

package/dist/detail-runtime/host.mjs

@@ -252,6 +252,8 @@ export class IndependentScanner {
             coordinates[i * 8 + j * 2] = p[0];
             coordinates[i * 8 + j * 2 + 1] = p[1];
         }));
+        if (e.regions_retail)
+            status(e.regions_retail(id, policy.retailMask ?? 1, policy.retailMask ? 3 : 0));
         const mask = policy.retryMask ?? [4294967295, 4294967295];
         if (!Array.isArray(mask) || mask.length !== 2)
             throw new ScannerError("invalid_input", "Invalid retry mask");

package/dist/detail.d.ts

@@ -13,6 +13,8 @@ export declare class ReleaseDetailScanner {
     private disposed;
     private constructor();
     static create(primary: ArrayBuffer, low: ArrayBuffer, mode: Exclude<Mode, "low">): Promise<ReleaseDetailScanner>;
-    scanLocalized(image: Image, policy: Parameters<IndependentScanner["scanLocalized"]>[1], fit: number, full: boolean, coverage?: readonly Quad[]): DetailResult;
+    scanLocalized(image: Image, policy: Parameters<IndependentScanner["scanLocalized"]>[1] & {
+        retailMask?: number;
+    }, fit: number, full: boolean, coverage?: readonly Quad[]): DetailResult;
     dispose(): void;
 }

package/dist/detail.js

@@ -52,7 +52,7 @@ export class ReleaseDetailScanner {
     scanLocalized(image, policy, fit, full, coverage = []) {
         if (this.disposed)
             throw Error("Scanner is disposed");
-        const result = this.scanner.scanLocalized(packed(image), policy ?? {}, fit, full, coverage);
+        const result = this.scanner.scanLocalized(packed(image), policy, fit, full, coverage);
         const primaryCount = result.scan.barcodes.length;
         const barcodes = result.recovery.barcodes.map((b, i) => i < primaryCount ? b : { ...b, candidate_indices: [] });
         const localization = result.localization;

package/dist/index.js

@@ -125,10 +125,10 @@ function publicResult(raw, image, debug) {
     });
 }
 const modes = {
-    low: "low-complete-release-20260916.wasm",
-    medium: "medium-complete-release-20260916.wasm",
-    high: "high-complete-release-20260916.wasm",
-    "very-high": "very-high-complete-release-20260916.wasm",
+    low: "low-shared-retail-portable-20260919.wasm",
+    medium: "medium-shared-retail-portable-20260919.wasm",
+    high: "high-shared-retail-portable-20260919.wasm",
+    "very-high": "very-high-shared-retail-portable-20260919.wasm",
 };
 /** Mode selects a compiled implementation. Create another instance to switch. */
 export class Scanner {
@@ -136,7 +136,7 @@ export class Scanner {
     mode;
     configuredFormats;
     addOnPolicy;
-    constructor(host, mode, configuredFormats = ["EAN13"], addOnPolicy = "Ignore") {
+    constructor(host, mode, configuredFormats = resolveFormats(), addOnPolicy = "Ignore") {
         this.host = host;
         this.mode = mode;
         this.configuredFormats = configuredFormats;
@@ -176,11 +176,13 @@ export class Scanner {
         if (!base.pathname.endsWith("/"))
             base.pathname += "/";
         const load = options.loadWasm ?? loadDefault;
-        const needsPrimary = formats.some((f) => f === "EAN13" || f === "UPCA");
+        const sharedRetail = mode === "medium" && addonPolicy === "Ignore";
+        const needsPrimary = formats.some((f) => f === "EAN13" || f === "UPCA" || (sharedRetail && (f === "EAN8" || f === "UPCE")));
         const bytes = needsPrimary ? await load(new URL(modes[mode], base)) : undefined;
         const recovery = !needsPrimary || mode === "low" ? undefined : await load(new URL(modes.low, base));
         const multiformat = addonPolicy !== "Ignore" || formats.length !== 1 || formats[0] !== "EAN13";
-        const extra = addonPolicy !== "Ignore" || formats.some((f) => f !== "EAN13" && f !== "UPCA")
+        const extra = addonPolicy !== "Ignore" ||
+            formats.some((f) => f !== "EAN13" && f !== "UPCA" && (!sharedRetail || (f !== "EAN8" && f !== "UPCE")))
             ? await load(new URL("multiformat.wasm", base))
             : undefined;
         if (multiformat)

package/dist/multiformat/formats.js

@@ -53,7 +53,7 @@ export function resolveFormats(input) {
     if (input === "all")
         return [...linearFormats, ...matrixFormats];
     if (input === undefined)
-        return ["EAN13"];
+        return [...retailFormats];
     if (typeof input === "string" && Object.hasOwn(formatBits, input))
         return [input];
     if (!Array.isArray(input) || input.length === 0)

package/dist/multiformat/scanner.d.ts

@@ -36,7 +36,7 @@ export interface Frame {
     localizationMs: number;
     linearStrategy: "scanlines" | "medium-localized";
 }
-/** Frozen EAN13 Medium plus project-owned opt-in readers. No reference decoder. */
+/** Shared retail evidence over primary profiles, plus independent additional readers. */
 export declare class MediumMultiformatScanner {
     private medium?;
     private mode;

package/dist/multiformat/scanner.js

@@ -10,7 +10,7 @@ function scanGray(image) {
         ? image.data.subarray(0, image.width * image.height)
         : toGray(image);
 }
-/** Frozen EAN13 Medium plus project-owned opt-in readers. No reference decoder. */
+/** Shared retail evidence over primary profiles, plus independent additional readers. */
 export class MediumMultiformatScanner {
     medium;
     mode = "medium";
@@ -104,7 +104,12 @@ export class MediumMultiformatScanner {
         const barcodes = [], regions = [];
         let primary;
         let unfinished = false, mediumMs = 0, additionalMs = 0, preparationMs = 0, localizationMs = 0;
-        const extraFormats = formats.filter((f) => eanAddOnSymbol !== "Ignore" || (f !== "EAN13" && f !== "UPCA"));
+        const sharedRetail = this.mode === "medium" &&
+            eanAddOnSymbol === "Ignore" &&
+            formats.some((f) => f === "EAN8" || f === "UPCE");
+        const retailPolicy = { ...scanPolicy, ...(sharedRetail ? { retailMask: 15 } : {}) };
+        const extraFormats = formats.filter((f) => (!sharedRetail || (f !== "EAN8" && f !== "UPCE")) &&
+            (eanAddOnSymbol !== "Ignore" || (f !== "EAN13" && f !== "UPCA")));
         const conservative = medium instanceof ReleaseDetailScanner &&
             !localized &&
             eanAddOnSymbol === "Ignore" &&
@@ -131,12 +136,12 @@ export class MediumMultiformatScanner {
                     coverage.push(read.polygon);
             }
         }
-        if (formats.includes("EAN13") || formats.includes("UPCA")) {
+        if (sharedRetail || formats.includes("EAN13") || formats.includes("UPCA")) {
             if (!medium)
                 throw Error("EAN13 engine has not been initialized.");
             const begin = performance.now();
             const found = medium instanceof ReleaseDetailScanner
-                ? medium.scanLocalized(image, scanPolicy, fitLimits[this.mode], true, coverage)
+                ? medium.scanLocalized(image, retailPolicy, fitLimits[this.mode], true, coverage)
                 : medium.scanLocalized(image, scanPolicy, fitLimits[this.mode], true);
             primary = found;
             const localization = found.localization;
@@ -153,6 +158,22 @@ export class MediumMultiformatScanner {
                 else if (formats.includes("EAN13"))
                     barcodes.push({ format: "EAN13", text: b.text, polygon: b.polygon, support: b.support });
             }
+            if (sharedRetail) {
+                const evidence = found;
+                const shared = [...(evidence.scan.retail?.barcodes ?? [])];
+                unfinished ||= evidence.scan.retail?.unfinished ?? false;
+                for (const attempt of evidence.recovery?.attempts ?? []) {
+                    unfinished ||= attempt.frame.retail?.unfinished ?? false;
+                    for (const b of attempt.frame.retail?.barcodes ?? []) {
+                        const polygon = b.polygon.map(([x, y]) => [
+                            attempt.x + x / attempt.factor,
+                            attempt.y + y / attempt.factor,
+                        ]);
+                        shared.push({ ...b, polygon });
+                    }
+                }
+                barcodes.push(...shared.filter((b) => formats.includes(b.format)));
+            }
             const decoded = new Set(found.scan.barcodes.flatMap((b) => b.candidate_indices));
             localization.proposals.forEach((p, i) => {
                 if (!decoded.has(i))
@@ -168,13 +189,13 @@ export class MediumMultiformatScanner {
                     });
                 }
             }
-            unfinished =
+            unfinished ||=
                 found.scan.unfinished ||
                     Boolean(localization.workLimited) ||
                     (localization.omitted ?? 0) > 0;
             mediumMs = performance.now() - begin;
         }
-        if (localized && !formats.includes("EAN13") && !formats.includes("UPCA")) {
+        if (!sharedRetail && localized && !formats.includes("EAN13") && !formats.includes("UPCA")) {
             if (!medium)
                 throw Error("EAN13 localization engine has not been initialized.");
             const begin = performance.now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tapirscan",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "Orientation-aware barcode scanning with a Rust/WASM core and four effort modes",
   "exports": {
@@ -14,15 +14,15 @@
     "examples",
     "wasm/multiformat.json",
     "THIRD_PARTY_NOTICES.md",
-    "wasm/low-complete-release-20260916.wasm",
-    "wasm/medium-complete-release-20260916.wasm",
-    "wasm/high-complete-release-20260916.wasm",
-    "wasm/very-high-complete-release-20260916.wasm",
+    "wasm/low-shared-retail-portable-20260919.wasm",
+    "wasm/medium-shared-retail-portable-20260919.wasm",
+    "wasm/high-shared-retail-portable-20260919.wasm",
+    "wasm/very-high-shared-retail-portable-20260919.wasm",
     "wasm/multiformat.wasm"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "node --test test/scanner.mjs test/linear-duplicates.mjs && tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext test/api-types.ts",
+    "test": "node --test test/scanner.mjs test/linear-duplicates.mjs test/shared-retail.mjs && tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext test/api-types.ts",
     "prepack": "npm run build && node scripts/verify-package.mjs"
   },
   "devDependencies": {

package/wasm/multiformat.json

@@ -1,7 +1,7 @@
 {
-  "sha256": "06598e5fc13957c21e2c206de51990decb415d4e7037e8a42160d6108008df55",
+  "sha256": "fb020f1c9ca597c1c4dd8ae8d45a70eae78e425eb08ca9225f85d8efc8652b29",
   "sourceManifest": "provenance/import.json",
-  "sourceDigest": "bfbc48d3bba63fbbe16c8396d3cf4b5278095f2affd0bc4f15d380e1414a8111",
+  "sourceDigest": "e9b4ee4dacf9df2477b86dff44e2c74768c78f21d0e743158b09fff7386f6898",
   "rustToolchain": "1.91.1",
   "rustflags": "-C target-feature=+simd128 --remap-path-prefix=/home/runner/.rustup/toolchains/1.91.1-x86_64-unknown-linux-gnu/lib/rustlib/src/rust/library=/rustc/ed61e7d7e242494fb7057f2657300d9e77bb4fcb/library"
 }