@sythos/js_barcode_universal 1.4.1 → 1.5.1

package/examples/read.html

@@ -98,6 +98,11 @@
     Sythos Barcode Suite — 100% original JavaScript, zero dependencies, MIT.
     See also <a href="create.html">create.html</a>.
   </p>
+  <p class="sub">
+    Image reading includes Code 11, MSI Plessey, GS1-128, GS1 DataBar
+    Omnidirectional/Truncated and EAN-2/EAN-5 supplements attached to an EAN/UPC
+    parent. Pharmacode remains intentionally write-only for generic autodetection.
+  </p>
 </header>
 
 <div class="layout">

package/licenses/README.md

@@ -36,8 +36,8 @@ appendix carries the consolidated inventory these files expand on.
 | EAN-5 supplement | [`ean-5.license`](ean-5.license) | 2 |
 | Micro QR Code | [`micro-qr.license`](micro-qr.license) | 2 |
 | rMQR Code | [`rmqr.license`](rmqr.license) | 2 |
-| FrameQR Code | [`frameqr.license`](frameqr.license) | 2 |
-| GS1 DataBar data-layer codecs | [`gs1-databar.license`](gs1-databar.license) | 2 |
+| Frame QR / Sythos Canvas QR profile | [`frameqr.license`](frameqr.license) | 2 |
+| GS1 DataBar Omnidirectional / Truncated | [`gs1-databar.license`](gs1-databar.license) | 2 |
 
 ## On the `[TO VERIFY]` markers
 

package/licenses/ean-2.license

@@ -60,8 +60,9 @@ CONCLUSION
 --------------------------------------------------------------------------
 
 The original add-on implementation is distributed under the MIT License.
-Generic camera read capability remains intentionally separate from the
-direct matrix helper.
+Image reading is intentionally parent-bound: the generic reader accepts
+EAN-2 only when attached to a validated EAN/UPC symbol; it is not a
+standalone retail-symbol detector.
 
 References relied upon:
   - ISO/IEC 15420, ISO/IEC

package/licenses/ean-5.license

@@ -60,8 +60,9 @@ CONCLUSION
 --------------------------------------------------------------------------
 
 The original add-on implementation is distributed under the MIT License.
-Generic camera read capability remains intentionally separate from the
-direct matrix helper.
+Image reading is intentionally parent-bound: the generic reader accepts
+EAN-5 only when attached to a validated EAN/UPC symbol; it is not a
+standalone retail-symbol detector.
 
 References relied upon:
   - ISO/IEC 15420, ISO/IEC

package/licenses/frameqr.license

@@ -1,7 +1,7 @@
-FrameQR Code — format provenance and usability
+Frame QR / Sythos Canvas QR profile — format provenance and usability
 ==========================================================================
 
-This file records where the FrameQR Code symbology comes from, what governs
+This file records where the Frame QR / Sythos Canvas QR profile symbology comes from, what governs
 it, and the basis on which this project implements and redistributes it.
 
 It is an ENGINEERING INVENTORY, NOT LEGAL ADVICE. Items marked [TO VERIFY]
@@ -22,7 +22,7 @@ SPECIFICATION
 
 DENSO WAVE public FrameQR material, including the product overview
 and the public announcement. The proprietary format definition is not
-reproduced here. This project implements the separate FrameQR Code
+reproduced here. This project implements the separate Sythos Canvas QR
 profile on an ISO/IEC 18004 QR Model 2 baseline.
 
 Specification TEXT is copyrighted by its publisher. The SYMBOLOGY it
@@ -55,7 +55,7 @@ branding — how a product names and presents itself.
 IMPLEMENTATION BASIS IN THIS PROJECT
 --------------------------------------------------------------------------
 
-FrameQR Code is implemented here from published descriptions of the format,
+Frame QR / Sythos Canvas QR profile is implemented here from published descriptions of the format,
 which are systems and facts rather than works of authorship. No source
 code or constant table from any other barcode implementation is copied or
 shipped. Public technical material and independent implementations may be
@@ -66,8 +66,8 @@ recorded in NOTICE.md.
 CONCLUSION
 --------------------------------------------------------------------------
 
-The distributed implementation is the original, non-certified FrameQR Code
-profile `sythos-canvas-qr/1`, not DENSO FrameQR. It reserves a
+The distributed implementation is the original, non-certified Sythos
+Canvas QR profile `sythos-canvas-qr/1`, not DENSO FrameQR. It reserves a
 bounded artwork canvas inside a QR Model 2 ECC-H symbol and does not claim
 native FrameQR interoperability. Third-party software cited here was used
 exclusively as an independent verification and cross-checking tool; no

package/licenses/gs1-databar.license

@@ -1,7 +1,7 @@
-GS1 DataBar data-layer codecs — format provenance and usability
+GS1 DataBar Omnidirectional / Truncated — format provenance and usability
 ==========================================================================
 
-This file records where the GS1 DataBar data-layer codecs symbology comes from, what governs
+This file records where the GS1 DataBar Omnidirectional / Truncated symbology comes from, what governs
 it, and the basis on which this project implements and redistributes it.
 
 It is an ENGINEERING INVENTORY, NOT LEGAL ADVICE. Items marked [TO VERIFY]
@@ -13,8 +13,9 @@ ORIGIN
 
 GS1 DataBar is a family of seven GS1 linear symbologies defined by ISO/IEC
 24724 and GS1 specifications. This release contains original GTIN and GS1
-element-string data-layer codecs; physical bar-pattern support is limited
-to the variants explicitly listed by the package.
+element-string data-layer codecs plus physical Omnidirectional and
+Truncated pattern readers and writers; other physical variants remain
+outside the package scope.
 
 
 SPECIFICATION
@@ -54,7 +55,7 @@ branding — how a product names and presents itself.
 IMPLEMENTATION BASIS IN THIS PROJECT
 --------------------------------------------------------------------------
 
-GS1 DataBar data-layer codecs is implemented here from published descriptions of the format,
+GS1 DataBar Omnidirectional / Truncated is implemented here from published descriptions of the format,
 which are systems and facts rather than works of authorship. No source
 code or constant table from any other barcode implementation is copied or
 shipped. Public technical material and independent implementations may be
@@ -66,8 +67,10 @@ CONCLUSION
 --------------------------------------------------------------------------
 
 Only original Sythos DataBar code is distributed under the MIT License.
-Unsupported physical variants and conformance questions are intentionally
-not presented as completed capability. [LEGAL REVIEW]
+Omnidirectional and Truncated image support is exposed after
+checksum-validated black-box verification; Limited, Stacked and Expanded
+physical variants remain intentionally outside the completed capability.
+[LEGAL REVIEW]
 
 References relied upon:
   - ISO/IEC 24724, ISO/IEC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sythos/js_barcode_universal",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "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/databar/decoder.js

@@ -4,6 +4,7 @@
  * MIT License
  *
  * Copyright (c) 2026 Sythos
+ * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -23,7 +24,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.
@@ -32,6 +32,7 @@
 /** Clean-matrix decoder for GS1 DataBar Omnidirectional and Truncated. @module databar/decoder */
 
 import { ChecksumError, FormatError } from '../core/errors.js';
+import { BitMatrix } from '../core/bit-matrix.js';
 import { decodeDataBar14GTIN } from './codec.js';
 import {
   DATABAR14_CHECKSUM_WEIGHTS,
@@ -113,3 +114,103 @@ export function decodeDataBar14(matrix) {
     symbologyIdentifier: ']e0',
   });
 }
+
+/**
+ * Extract alternating runs from a binarized scanline.
+ * @param {Uint8Array} row
+ * @returns {{widths:number[], dark:boolean}[]}
+ */
+function scanlineRuns(row) {
+  if (!row || row.length < 96) return [];
+  const runs = [];
+  let dark = row[0] === 1;
+  let start = 0;
+  for (let x = 1; x < row.length; x++) {
+    const nextDark = row[x] === 1;
+    if (nextDark === dark) continue;
+    runs.push({ width: x - start, dark });
+    start = x;
+    dark = nextDark;
+  }
+  runs.push({ width: row.length - start, dark });
+  return runs;
+}
+
+/**
+ * Normalize a candidate's pixel runs to the 96 logical DataBar modules.
+ * Rounding is followed by a small conservation pass so mild non-integer
+ * scaling does not change the total symbol width.
+ * @param {number[]} raw
+ * @returns {number[]|null}
+ */
+function normalizeScanlineWidths(raw) {
+  const total = raw.reduce((sum, width) => sum + width, 0);
+  if (total <= 0) return null;
+  const scale = total / 96;
+  if (scale < 0.5) return null;
+  const widths = raw.map((width) => Math.max(1, Math.round(width / scale)));
+  let delta = 96 - widths.reduce((sum, width) => sum + width, 0);
+  while (delta !== 0) {
+    if (delta > 0) {
+      let index = 0;
+      for (let i = 1; i < widths.length; i++) if (raw[i] > raw[index]) index = i;
+      widths[index]++;
+      delta--;
+    } else {
+      let index = -1;
+      for (let i = 0; i < widths.length; i++) {
+        if (widths[i] <= 1) continue;
+        if (index < 0 || raw[i] / widths[i] > raw[index] / widths[index]) index = i;
+      }
+      if (index < 0) return null;
+      widths[index]--;
+      delta++;
+    }
+  }
+  if (widths[0] !== 1 || widths[widths.length - 1] !== 1) return null;
+  return widths;
+}
+
+/** Build a 96-module row from normalized alternating runs. */
+function matrixFromRuns(widths, darkFirst) {
+  const matrix = new BitMatrix(96, 1);
+  let x = 0;
+  let dark = darkFirst;
+  for (const width of widths) {
+    if (dark) for (let i = 0; i < width; i++) matrix.set(x + i, 0);
+    x += width;
+    dark = !dark;
+  }
+  return matrix;
+}
+
+/**
+ * Decode GS1 DataBar-14 from one raster scanline. This is the image layer over
+ * the existing clean 96-module decoder; it recognizes both Omnidirectional
+ * and Truncated symbols because their horizontal pattern is identical.
+ *
+ * @param {Uint8Array} row
+ * @returns {{format:'gs1databar14', text:string, gtin:string, gs1:boolean, linkage:boolean, symbologyIdentifier:string, elements:Array}|null}
+ */
+export function decodeDataBar14Scanline(row) {
+  const runs = scanlineRuns(row);
+  for (let start = 0; start + 46 <= runs.length; start++) {
+    if (runs[start].dark) continue;
+    const candidate = runs.slice(start, start + 46);
+    if (start + 46 < runs.length && runs[start + 46].dark) continue;
+    const widths = normalizeScanlineWidths(candidate.map((run) => run.width));
+    if (!widths) continue;
+    try {
+      const decoded = decodeDataBar14(matrixFromRuns(widths, false));
+      return {
+        ...decoded,
+        format: 'gs1databar14',
+        gs1: true,
+        elements: [{ ai: '01', value: decoded.gtin, fixed: true }],
+      };
+    } catch {
+      // Try the next light-run candidate in the scanline.
+    }
+  }
+  return null;
+}

package/src/databar/index.js

@@ -4,6 +4,7 @@
  * MIT License
  *
  * Copyright (c) 2026 Sythos
+ * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -23,7 +24,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.
@@ -59,7 +59,7 @@ export {
 } from './tables.js';
 
 export { encodeDataBar14 } from './encoder.js';
-export { decodeDataBar14 } from './decoder.js';
+export { decodeDataBar14, decodeDataBar14Scanline } from './decoder.js';
 export {
   DATABAR14_CHECKSUM_WEIGHTS,
   DATABAR14_FINDERS,

package/src/index.js

@@ -84,8 +84,8 @@ export { encodeAztec, decodeAztec, detectAztec, detectAndDecodeAztec } from './a
 export * from './aztecrune/index.js';
 export { encodePDF417, decodePDF417, detectPDF417, detectAndDecodePDF417 } from './pdf417/index.js';
 export * from './compactpdf417/index.js';
-// DataBar currently exposes verified GS1 data-layer codecs only; physical
-// symbol rendering and image detection remain deliberately out of scope.
+  // DataBar exports include both the verified GTIN/data layer and the
+  // Omnidirectional/Truncated physical image path.
 export * from './databar/index.js';
 export {
   encodeMicroPDF417, decodeMicroPDF417, detectMicroPDF417, detectAndDecodeMicroPDF417,
@@ -103,6 +103,7 @@ export {
  * @property {boolean} canWrite
  * @property {boolean} canRead
  * @property {'1D' | '2D'} kind
+ * @property {'supplement'} [role]
  */
 
 // Writing and reading a format are separate capabilities that can land at
@@ -141,6 +142,7 @@ const aztecRuneCanDecode = typeof aztecRune.detectAndDecodeAztecRune === 'functi
 const compactPdf417CanEncode = typeof compactPdf417.encodeCompactPDF417 === 'function';
 const compactPdf417CanDecode = typeof compactPdf417.detectAndDecodeCompactPDF417 === 'function';
 const dataBarCanEncode = typeof databar.encodeDataBar14 === 'function';
+const dataBarCanDecode = typeof databar.decodeDataBar14Scanline === 'function';
 
 /**
  * Every format this build supports.
@@ -159,6 +161,7 @@ export function listFormats() {
     canWrite: true,
     canRead: info.readable,
     kind: /** @type {'1D'} */ ('1D'),
+    ...(info.role ? { role: info.role } : {}),
   }));
 
   formats.push({
@@ -235,7 +238,7 @@ export function listFormats() {
     id: 'gs1databar14',
     label: 'GS1 DataBar Omnidirectional / Truncated',
     canWrite: dataBarCanEncode,
-    canRead: false,
+    canRead: dataBarCanDecode,
     kind: /** @type {'1D'} */ ('1D'),
   });
 
@@ -344,6 +347,13 @@ export function encode(text, options = {}) {
  * @property {string} [profile] FrameQR Code profile identifier.
  * @property {boolean} [certified] Whether the profile is certified by its originator.
  * @property {object} [canvas] Canvas reservation metadata for the FrameQR Code profile.
+ * @property {{format:'ean2'|'ean5', text:string, parity:string, checksum?:number}} [addon] Attached EAN/UPC supplement.
+ * @property {boolean} [gs1] Whether the physical symbol is classified as GS1.
+ * @property {string} [symbologyIdentifier] GS1 symbology identifier.
+ * @property {Array<{ai:string,value:string,fixed?:boolean}>} [elements] Parsed GS1 Application Identifier fields.
+ * @property {string} [gs1ParseError] Semantic GS1 parsing error after a valid physical read.
+ * @property {string} [gtin] GS1 DataBar GTIN-14 payload.
+ * @property {boolean} [linkage] GS1 DataBar linkage flag.
  */
 
 /**
@@ -375,7 +385,8 @@ export function decode(image, options = {}) {
   const wantMicroQR = !want || want.has('microqr') || want.has('micro-qr');
   const wantRMQR = !want || want.has('rmqr') || want.has('r-mqr') || want.has('rectangular-micro-qr');
   const wantFrameQR = !want || want.has('frameqr') || want.has('frame-qr') || want.has('canvas-qr');
-  const wantOneD = !want || [...want].some((f) => f in ONED_FORMATS);
+  const oneDAliases = new Set(['gs1databar14', 'databar', 'gs1-databar14']);
+  const wantOneD = !want || [...want].some((f) => f in ONED_FORMATS || oneDAliases.has(f));
 
   const source = LuminanceSource.fromImageData(image);
   const results = [];
@@ -499,9 +510,23 @@ export function decode(image, options = {}) {
     }
 
     if (wantOneD) {
-      const oneDFormats = want ? [...want].filter((f) => f in ONED_FORMATS) : null;
-      for (const found of decodeOneD(bits, { formats: oneDFormats, tryHarder })) {
-        results.push({ text: found.text, format: found.format });
+      const oneDFormats = want
+        ? [...want].filter((f) => f in ONED_FORMATS || oneDAliases.has(f))
+        : null;
+      for (const found of decodeOneD(bits, { ...options, formats: oneDFormats, tryHarder })) {
+        const { row, ...publicFound } = found;
+        void row;
+        if (publicFound.gs1) {
+          const semanticText = publicFound.format === 'gs1databar14'
+            ? `01${publicFound.gtin ?? publicFound.text}`
+            : publicFound.text;
+          try {
+            publicFound.elements = databar.decodeGS1ElementString(semanticText);
+          } catch (error) {
+            publicFound.gs1ParseError = error instanceof Error ? error.message : String(error);
+          }
+        }
+        results.push(publicFound);
       }
     }
 

package/src/oned/index.js

@@ -4,6 +4,7 @@
  * MIT License
  *
  * Copyright (c) 2026 Sythos
+ * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -23,7 +24,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.
@@ -56,6 +56,7 @@ export {
 
 export {
   decodeOneD, decodeOneDStrict,
+  decodeCode11, decodeMSI,
   patternVariance, recordPattern, toNarrowWidePattern,
 } from './reader.js';
 
@@ -77,7 +78,7 @@ import { encodeEAN2, encodeEAN5 } from './addons.js';
  * so the two lists legitimately differ and the API says so rather than
  * failing at runtime.
  *
- * @type {Record<string, {encode: Function, readable: boolean, label: string}>}
+ * @type {Record<string, {encode: Function, readable: boolean, label: string, role?: string}>}
  */
 export const ONED_FORMATS = {
   ean13: { encode: encodeEAN13, readable: true, label: 'EAN-13' },
@@ -96,12 +97,11 @@ export const ONED_FORMATS = {
   itf: { encode: encodeITF, readable: true, label: 'ITF (Interleaved 2 of 5)' },
   itf14: { encode: encodeITF14, readable: true, label: 'ITF-14' },
   codabar: { encode: encodeCodabar, readable: true, label: 'Codabar' },
-  code11: { encode: encodeCode11, readable: false, label: 'Code 11' },
-  msi: { encode: encodeMSI, readable: false, label: 'MSI Plessey' },
+  code11: { encode: encodeCode11, readable: true, label: 'Code 11' },
+  msi: { encode: encodeMSI, readable: true, label: 'MSI Plessey' },
   pharmacode: { encode: encodePharmacode, readable: false, label: 'Pharmacode' },
-  // Supplements are writable standalone matrices, but their reader is
-  // intentionally exposed through the EAN/UPC add-on helpers rather than the
-  // generic one-dimensional scan pipeline.
-  ean2: { encode: encodeEAN2, readable: false, label: 'EAN-2 supplement' },
-  ean5: { encode: encodeEAN5, readable: false, label: 'EAN-5 supplement' },
+  // Supplements are reported as readable capabilities, but the image reader
+  // only accepts them when attached to a validated EAN/UPC parent symbol.
+  ean2: { encode: encodeEAN2, readable: true, role: 'supplement', label: 'EAN-2 supplement' },
+  ean5: { encode: encodeEAN5, readable: true, role: 'supplement', label: 'EAN-5 supplement' },
 };