@sythos/js_barcode_universal 1.5.2 → 1.5.3

package/README.md

@@ -118,8 +118,8 @@ The `unpkg` and `jsdelivr` fields point at the IIFE bundle, so a CDN needs no in
 
 ```html
 <script src="https://unpkg.com/@sythos/js_barcode_universal"></script>
-<script src="https://unpkg.com/@sythos/js_barcode_universal@1.5.2"></script>
-<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.2"></script>
+<script src="https://unpkg.com/@sythos/js_barcode_universal@1.5.3"></script>
+<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.3"></script>
 ```
 
 Pin the version for anything you ship; the unpinned form resolves to `latest` and will move under
@@ -502,6 +502,8 @@ and go faster), `tryHarder` (retry inverted, default `true`), `binarizer`
 (`'global' | 'hybrid' | 'auto'`). A `Result` carries at least `text` and `format`; QR results also
 carry `bytes`, `version` and `ecc`.
 
+For larger clean QR Code and PDF417 rasters, `auto` and `hybrid` retain their primary local-threshold pass and retry once with the global threshold only when that pass finds no result. An explicit `binarizer: 'global'` request remains single-pass.
+
 ```js
 listFormats() → { id, label, canWrite, canRead, kind }[]
 ```

package/bundle/sythos-barcode.esm.js

@@ -1,5 +1,5 @@
 /*!
- * Sythos Barcode Suite v1.5.2
+ * Sythos Barcode Suite v1.5.3
  *
  * MIT License
  *
@@ -16760,12 +16760,43 @@ function decode(image, options = {}) {
 
   // De-duplicate: the same symbol is often read on several scan rows.
   const seen = new Set();
-  return results.filter((r) => {
+  const unique = results.filter((r) => {
     const key = `${r.format}:${r.text}`;
     if (seen.has(key)) return false;
     seen.add(key);
     return true;
   });
+
+  // On large clean rasters, hybrid thresholding can erase otherwise uniform
+  // QR/PDF417 modules. Keep auto/hybrid as the primary strategy, then make one
+  // focused global retry only when the complete primary pass found nothing.
+  // This deliberately leaves an explicit global request single-pass.
+  const retryFormats = formats
+    ? formats.filter((format) => {
+      const id = String(format).toLowerCase();
+      return id === 'qr' || id === 'qrcode'
+        || id === 'pdf417' || id === 'pdf-417'
+        || id === 'compactpdf417' || id === 'compact-pdf417' || id === 'compact-pdf-417';
+    })
+    : ['qr', 'pdf417', 'compactpdf417'];
+  const shouldRetryGlobal = unique.length === 0
+    && (binarizer === 'auto' || binarizer === 'hybrid')
+    && retryFormats.length > 0;
+
+  if (!shouldRetryGlobal) return unique;
+
+  const fallback = decode(image, {
+    ...options,
+    formats: retryFormats,
+    binarizer: 'global',
+  });
+  const fallbackSeen = new Set();
+  return [...unique, ...fallback].filter((r) => {
+    const key = `${r.format}:${r.text}`;
+    if (fallbackSeen.has(key)) return false;
+    fallbackSeen.add(key);
+    return true;
+  });
 }
 
 /**
@@ -16782,7 +16813,7 @@ function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-const VERSION = '1.5.2';
+const VERSION = '1.5.3';
 
 __exports.listFormats = listFormats;
 __exports.encode = encode;

package/bundle/sythos-barcode.js

@@ -1,5 +1,5 @@
 /*!
- * Sythos Barcode Suite v1.5.2
+ * Sythos Barcode Suite v1.5.3
  *
  * MIT License
  *
@@ -16761,12 +16761,43 @@ function decode(image, options = {}) {
 
   // De-duplicate: the same symbol is often read on several scan rows.
   const seen = new Set();
-  return results.filter((r) => {
+  const unique = results.filter((r) => {
     const key = `${r.format}:${r.text}`;
     if (seen.has(key)) return false;
     seen.add(key);
     return true;
   });
+
+  // On large clean rasters, hybrid thresholding can erase otherwise uniform
+  // QR/PDF417 modules. Keep auto/hybrid as the primary strategy, then make one
+  // focused global retry only when the complete primary pass found nothing.
+  // This deliberately leaves an explicit global request single-pass.
+  const retryFormats = formats
+    ? formats.filter((format) => {
+      const id = String(format).toLowerCase();
+      return id === 'qr' || id === 'qrcode'
+        || id === 'pdf417' || id === 'pdf-417'
+        || id === 'compactpdf417' || id === 'compact-pdf417' || id === 'compact-pdf-417';
+    })
+    : ['qr', 'pdf417', 'compactpdf417'];
+  const shouldRetryGlobal = unique.length === 0
+    && (binarizer === 'auto' || binarizer === 'hybrid')
+    && retryFormats.length > 0;
+
+  if (!shouldRetryGlobal) return unique;
+
+  const fallback = decode(image, {
+    ...options,
+    formats: retryFormats,
+    binarizer: 'global',
+  });
+  const fallbackSeen = new Set();
+  return [...unique, ...fallback].filter((r) => {
+    const key = `${r.format}:${r.text}`;
+    if (fallbackSeen.has(key)) return false;
+    fallbackSeen.add(key);
+    return true;
+  });
 }
 
 /**
@@ -16783,7 +16814,7 @@ function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-const VERSION = '1.5.2';
+const VERSION = '1.5.3';
 
 __exports.listFormats = listFormats;
 __exports.encode = encode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sythos/js_barcode_universal",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "Read and write barcodes in JavaScript with zero runtime dependencies. QR Code, Micro QR, rMQR, FrameQR Code, Aztec Code and Rune, PDF417 variants, GS1 DataBar Omnidirectional/Truncated, EAN supplements and one-dimensional formats.",
   "author": {
     "name": "Sythos",

package/src/index.js

@@ -535,12 +535,43 @@ export function decode(image, options = {}) {
 
   // De-duplicate: the same symbol is often read on several scan rows.
   const seen = new Set();
-  return results.filter((r) => {
+  const unique = results.filter((r) => {
     const key = `${r.format}:${r.text}`;
     if (seen.has(key)) return false;
     seen.add(key);
     return true;
   });
+
+  // On large clean rasters, hybrid thresholding can erase otherwise uniform
+  // QR/PDF417 modules. Keep auto/hybrid as the primary strategy, then make one
+  // focused global retry only when the complete primary pass found nothing.
+  // This deliberately leaves an explicit global request single-pass.
+  const retryFormats = formats
+    ? formats.filter((format) => {
+      const id = String(format).toLowerCase();
+      return id === 'qr' || id === 'qrcode'
+        || id === 'pdf417' || id === 'pdf-417'
+        || id === 'compactpdf417' || id === 'compact-pdf417' || id === 'compact-pdf-417';
+    })
+    : ['qr', 'pdf417', 'compactpdf417'];
+  const shouldRetryGlobal = unique.length === 0
+    && (binarizer === 'auto' || binarizer === 'hybrid')
+    && retryFormats.length > 0;
+
+  if (!shouldRetryGlobal) return unique;
+
+  const fallback = decode(image, {
+    ...options,
+    formats: retryFormats,
+    binarizer: 'global',
+  });
+  const fallbackSeen = new Set();
+  return [...unique, ...fallback].filter((r) => {
+    const key = `${r.format}:${r.text}`;
+    if (fallbackSeen.has(key)) return false;
+    fallbackSeen.add(key);
+    return true;
+  });
 }
 
 /**
@@ -557,4 +588,4 @@ export function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-export const VERSION = '1.5.2';
+export const VERSION = '1.5.3';