@sythos/js_barcode_universal 1.2.5 → 1.4.1

package/licenses/upc-a.license

@@ -4,7 +4,7 @@ UPC-A — format provenance and usability
 This file records where the UPC-A 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 carrying a review label
+It is an ENGINEERING INVENTORY, NOT LEGAL ADVICE. Items marked [TO VERIFY]
 have not been independently confirmed by the author.
 
 
@@ -13,8 +13,8 @@ ORIGIN
 
 The Universal Product Code, adopted in the United States in 1973 and first
 scanned in retail in 1974. The symbol encoding is commonly credited to
-work at IBM, but the corporate and personal credit is [LEGAL REVIEW] and no
-individual is named here. Administered today by GS1.
+work at IBM, but the corporate and personal credit is [LEGAL REVIEW] and
+no individual is named here. Administered today by GS1.
 
 
 SPECIFICATION
@@ -22,7 +22,7 @@ SPECIFICATION
 
 ISO/IEC 15420 — EAN/UPC bar code symbology specification.
 GS1 General Specifications, GS1 AISBL — freely published; redistribution
-terms are GS1's own [LICENSE TERMS REVIEW REQUIRED]
+terms are GS1's own [LEGAL REVIEW]
 
 Specification TEXT is copyrighted by its publisher. The SYMBOLOGY it
 describes is not — an encoding scheme is a system, not a work of
@@ -34,7 +34,7 @@ PATENT STATUS
 --------------------------------------------------------------------------
 
 The originating patents date from the early 1970s and are understood to
-have expired long ago. [PATENT FAMILY REVIEW REQUIRED]
+have expired long ago. [LEGAL REVIEW]
 
 
 TRADEMARK
@@ -51,8 +51,10 @@ IMPLEMENTATION BASIS IN THIS PROJECT
 
 UPC-A is implemented here from published descriptions of the format,
 which are systems and facts rather than works of authorship. No source
-code and no constant table from any other barcode implementation was used,
-consulted or copied, under any licence.
+code or constant table from any other barcode implementation is copied or
+shipped. Public technical material and independent implementations may be
+consulted for engineering review or black-box verification; provenance is
+recorded in NOTICE.md.
 
 
 CONCLUSION
@@ -65,8 +67,8 @@ is distributed under the MIT License with no additional restriction.
 References relied upon:
   - ISO/IEC 15420, ISO/IEC
   - GS1 General Specifications, GS1 AISBL — freely published;
-    redistribution terms are GS1's own [LICENSE TERMS REVIEW REQUIRED]
+    redistribution terms are GS1's own [LEGAL REVIEW]
 
-This is an engineering assessment, not legal advice. Open review labels
-Open review labels identify claims that have not been independently confirmed by the author. If your
+This is an engineering assessment, not legal advice. Items marked
+[TO VERIFY] have not been independently confirmed by the author. If your
 use is commercially sensitive, obtain your own legal review.

package/licenses/upc-e.license

@@ -4,7 +4,7 @@ UPC-E — format provenance and usability
 This file records where the UPC-E 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 carrying a review label
+It is an ENGINEERING INVENTORY, NOT LEGAL ADVICE. Items marked [TO VERIFY]
 have not been independently confirmed by the author.
 
 
@@ -20,7 +20,7 @@ SPECIFICATION
 
 ISO/IEC 15420 — EAN/UPC bar code symbology specification.
 GS1 General Specifications, GS1 AISBL — freely published; redistribution
-terms are GS1's own [LICENSE TERMS REVIEW REQUIRED]
+terms are GS1's own [LEGAL REVIEW]
 
 Specification TEXT is copyrighted by its publisher. The SYMBOLOGY it
 describes is not — an encoding scheme is a system, not a work of
@@ -31,7 +31,7 @@ redistribute or excerpt any specification document.
 PATENT STATUS
 --------------------------------------------------------------------------
 
-Shares the patent history of UPC-A; understood expired. [PATENT FAMILY REVIEW REQUIRED]
+Shares the patent history of UPC-A; understood expired. [LEGAL REVIEW]
 
 
 TRADEMARK
@@ -48,8 +48,10 @@ IMPLEMENTATION BASIS IN THIS PROJECT
 
 UPC-E is implemented here from published descriptions of the format,
 which are systems and facts rather than works of authorship. No source
-code and no constant table from any other barcode implementation was used,
-consulted or copied, under any licence.
+code or constant table from any other barcode implementation is copied or
+shipped. Public technical material and independent implementations may be
+consulted for engineering review or black-box verification; provenance is
+recorded in NOTICE.md.
 
 
 CONCLUSION
@@ -62,8 +64,8 @@ is distributed under the MIT License with no additional restriction.
 References relied upon:
   - ISO/IEC 15420, ISO/IEC
   - GS1 General Specifications, GS1 AISBL — freely published;
-    redistribution terms are GS1's own [LICENSE TERMS REVIEW REQUIRED]
+    redistribution terms are GS1's own [LEGAL REVIEW]
 
-This is an engineering assessment, not legal advice. Open review labels
-Open review labels identify claims that have not been independently confirmed by the author. If your
+This is an engineering assessment, not legal advice. Items marked
+[TO VERIFY] have not been independently confirmed by the author. If your
 use is commercially sensitive, obtain your own legal review.

package/package.json

@@ -1,102 +1,123 @@
-{
-  "name": "@sythos/js_barcode_universal",
-  "version": "1.2.5",
-  "description": "Read and write barcodes in JavaScript with zero runtime dependencies. Aztec Code, Data Matrix ECC 200, MicroPDF417, PDF417, QR Code, EAN/UPC, ISBN, Code 128, Code 39, Code 93, ITF, Codabar, MSI, Code 11 and Pharmacode.",
-  "author": "Sythos",
-  "license": "MIT",
-  "type": "module",
-  "main": "./src/index.js",
-  "module": "./src/index.js",
-  "browser": "./bundle/sythos-barcode.js",
-  "unpkg": "./bundle/sythos-barcode.js",
-  "jsdelivr": "./bundle/sythos-barcode.js",
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    ".": "./src/index.js",
-    "./core": "./src/core/index.js",
-    "./image": "./src/image/index.js",
-    "./oned": "./src/oned/index.js",
+{
+  "name": "@sythos/js_barcode_universal",
+  "version": "1.4.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",
+    "url": "https://www.sythos.net"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.js",
+  "module": "./src/index.js",
+  "browser": "./bundle/sythos-barcode.js",
+  "unpkg": "./bundle/sythos-barcode.js",
+  "jsdelivr": "./bundle/sythos-barcode.js",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./src/index.js",
+    "./core": "./src/core/index.js",
+    "./image": "./src/image/index.js",
+    "./oned": "./src/oned/index.js",
     "./qr": "./src/qr/index.js",
     "./datamatrix": "./src/datamatrix/index.js",
+    "./databar": "./src/databar/index.js",
     "./aztec": "./src/aztec/index.js",
+    "./aztecrune": "./src/aztecrune/index.js",
     "./pdf417": "./src/pdf417/index.js",
+    "./compactpdf417": "./src/compactpdf417/index.js",
     "./micropdf417": "./src/micropdf417/index.js",
-    "./render": "./src/render/index.js",
-    "./render/svg": "./src/render/svg.js",
-    "./render/png": "./src/render/png.js",
-    "./render/image-data": "./src/render/image-data.js",
-    "./bundle": "./bundle/sythos-barcode.esm.js",
-    "./bundle/iife": "./bundle/sythos-barcode.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "src",
-    "bundle",
-    "examples",
-    "licenses",
-    "LICENSE",
-    "NOTICE.md",
-    "README.md"
-  ],
-  "keywords": [
-    "barcode",
+    "./microqr": "./src/microqr/index.js",
+    "./rmqr": "./src/rmqr/index.js",
+    "./frameqr": "./src/frameqr/index.js",
+    "./render": "./src/render/index.js",
+    "./render/svg": "./src/render/svg.js",
+    "./render/png": "./src/render/png.js",
+    "./render/image-data": "./src/render/image-data.js",
+    "./bundle": "./bundle/sythos-barcode.esm.js",
+    "./bundle/iife": "./bundle/sythos-barcode.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "bundle",
+    "examples",
+    "licenses",
+    "LICENSE",
+    "NOTICE.md",
+    "README.md",
+    "AI_USAGE.md"
+  ],
+  "keywords": [
+    "barcode",
     "datamatrix",
     "ecc200",
     "aztec",
+    "aztec-rune",
+    "compact-pdf417",
+    "gs1-databar",
+    "ean2",
+    "ean5",
     "aztec-code",
     "pdf417",
     "pdf-417",
     "micropdf417",
     "micro-pdf417",
+    "microqr",
+    "micro-qr",
+    "rmqr",
+    "rectangular-micro-qr",
+    "frameqr",
+    "canvas-qr",
     "sdk",
-    "barcode-generator",
-    "barcode-scanner",
-    "qrcode",
-    "qr",
-    "qr-code",
-    "ean",
-    "ean13",
-    "ean8",
-    "upc",
-    "upca",
-    "upce",
-    "isbn",
-    "code128",
-    "gs1-128",
-    "code39",
-    "code93",
-    "itf",
-    "itf14",
-    "codabar",
-    "msi",
-    "code11",
-    "pharmacode",
-    "scanner",
-    "decoder",
-    "encoder",
-    "generator",
-    "reader",
-    "writer",
-    "zero-dependencies",
-    "no-dependencies",
-    "browser",
-    "nodejs",
-    "esm"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Sythos/JS_Barcode_Universal.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Sythos/JS_Barcode_Universal/issues"
-  },
-  "homepage": "https://github.com/Sythos/JS_Barcode_Universal#readme",
-  "dependencies": {},
-  "devDependencies": {}
-}
+    "barcode-generator",
+    "barcode-scanner",
+    "qrcode",
+    "qr",
+    "qr-code",
+    "ean",
+    "ean13",
+    "ean8",
+    "upc",
+    "upca",
+    "upce",
+    "isbn",
+    "code128",
+    "gs1-128",
+    "code39",
+    "code93",
+    "itf",
+    "itf14",
+    "codabar",
+    "msi",
+    "code11",
+    "pharmacode",
+    "scanner",
+    "decoder",
+    "encoder",
+    "generator",
+    "reader",
+    "writer",
+    "zero-dependencies",
+    "no-dependencies",
+    "browser",
+    "nodejs",
+    "esm"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Sythos/JS_Barcode_Universal.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Sythos/JS_Barcode_Universal/issues"
+  },
+  "homepage": "https://github.com/Sythos/JS_Barcode_Universal#readme",
+  "dependencies": {},
+  "devDependencies": {}
+}

package/src/aztec/decoder.js

@@ -23,6 +23,7 @@
  * 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.

package/src/aztec/detector.js

@@ -23,6 +23,7 @@
  * 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.

package/src/aztec/encoder.js

@@ -23,6 +23,7 @@
  * 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.

package/src/aztec/high-level.js

@@ -23,6 +23,7 @@
  * 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.

package/src/aztec/index.js

@@ -23,6 +23,7 @@
  * 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.

package/src/aztec/tables.js

@@ -23,6 +23,7 @@
  * 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.

package/src/aztecrune/decoder.js

@@ -0,0 +1,156 @@
+/*!
+ * Sythos Barcode Suite
+ *
+ * MIT License
+ *
+ * Copyright (c) 2026 Sythos
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * 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.
+ */
+
+/**
+ * Aztec Rune decoder.
+ *
+ * The input is a square 11x11 module matrix. Structural modules are checked
+ * before the seven masked GF(16) codewords are Reed-Solomon corrected. The
+ * decoder tries the four in-plane quarter turns and both polarities, allowing
+ * it to consume an oriented sampled image while still rejecting ordinary
+ * Aztec/QR matrices.
+ *
+ * @module aztecrune/decoder
+ */
+
+import { FormatError } from '../core/errors.js';
+import { rsDecode } from '../core/reed-solomon.js';
+import {
+  AZTEC_RUNE_DATA_CODEWORDS,
+  AZTEC_RUNE_DATA_POSITIONS,
+  AZTEC_RUNE_ECC_CODEWORDS,
+  AZTEC_RUNE_MASK,
+  AZTEC_RUNE_SIZE,
+  aztecRuneField,
+  aztecRuneStructuralValue,
+} from './tables.js';
+
+/** @param {import('../core/bit-matrix.js').BitMatrix} source @param {number} turns */
+function rotateClockwise(source, turns) {
+  let current = source.clone();
+  for (let turn = 0; turn < turns; turn++) {
+    const out = new source.constructor(current.height, current.width);
+    for (let y = 0; y < current.height; y++) for (let x = 0; x < current.width; x++) {
+      if (current.get(x, y)) out.set(current.height - 1 - y, x);
+    }
+    current = out;
+  }
+  return current;
+}
+
+/** @param {import('../core/bit-matrix.js').BitMatrix} matrix */
+function invert(matrix) {
+  const out = matrix.clone();
+  for (let y = 0; y < out.height; y++) for (let x = 0; x < out.width; x++) out.flip(x, y);
+  return out;
+}
+
+/** @param {import('../core/bit-matrix.js').BitMatrix} matrix @param {boolean} inverted */
+function structureMatches(matrix, inverted) {
+  for (let y = 0; y < AZTEC_RUNE_SIZE; y++) for (let x = 0; x < AZTEC_RUNE_SIZE; x++) {
+    const expected = aztecRuneStructuralValue(x, y);
+    if (expected === null) continue;
+    if (matrix.get(x, y) !== (inverted ? !expected : expected)) return false;
+  }
+  return true;
+}
+
+/** @param {import('../core/bit-matrix.js').BitMatrix} matrix @param {boolean} inverted */
+function readCodewords(matrix, inverted) {
+  const words = new Array(2 + AZTEC_RUNE_ECC_CODEWORDS).fill(0);
+  for (let at = 0; at < AZTEC_RUNE_DATA_POSITIONS.length; at++) {
+    const [x, y] = AZTEC_RUNE_DATA_POSITIONS[at];
+    const bit = matrix.get(x, y) !== inverted;
+    words[at >>> 2] = (words[at >>> 2] << 1) | (bit ? 1 : 0);
+  }
+  return words.map((word) => word ^ AZTEC_RUNE_MASK);
+}
+
+/** @param {number} value @param {boolean} inverted @param {number} rotation @param {number} corrections */
+function result(value, inverted, rotation, corrections) {
+  return {
+    format: 'aztecrune',
+    value,
+    text: String(value).padStart(3, '0'),
+    bytes: Uint8Array.of(value),
+    dimension: AZTEC_RUNE_SIZE,
+    inverted,
+    rotation,
+    corrections,
+  };
+}
+
+/**
+ * Decode a square Aztec Rune matrix.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {{inverted?: boolean|'auto', rotation?: number|'auto'}} [options]
+ * @returns {{format:'aztecrune',value:number,text:string,bytes:Uint8Array,dimension:number,inverted:boolean,rotation:number,corrections:number}}
+ * @throws {FormatError} For non-Rune geometry, structure or uncorrectable data.
+ */
+export function decodeAztecRune(matrix, options = {}) {
+  if (!matrix || matrix.width !== AZTEC_RUNE_SIZE || matrix.height !== AZTEC_RUNE_SIZE) {
+    throw new FormatError(`Aztec Rune: expected an ${AZTEC_RUNE_SIZE}x${AZTEC_RUNE_SIZE} module matrix`);
+  }
+  const invertedModes = options.inverted === true ? [true] : options.inverted === false ? [false] : [false, true];
+  const rotations = Number.isInteger(options.rotation)
+    ? [((options.rotation % 360) + 360) % 360]
+    : [0, 90, 180, 270];
+
+  let checksumError = null;
+  for (const requestedRotation of rotations) {
+    if (requestedRotation % 90 !== 0) continue;
+    // To canonicalize an input rotated clockwise by k degrees, rotate it
+    // counter-clockwise by k. `turns` is the clockwise operation we apply.
+    const turns = (4 - requestedRotation / 90) % 4;
+    const canonicalRotation = requestedRotation;
+    const rotated = turns === 0 ? matrix.clone() : rotateClockwise(matrix, turns);
+    for (const inverted of invertedModes) {
+      const canonical = inverted ? invert(rotated) : rotated;
+      if (!structureMatches(canonical, false)) continue;
+      const words = readCodewords(canonical, false);
+      try {
+        const corrections = rsDecode(words, AZTEC_RUNE_ECC_CODEWORDS, aztecRuneField(), 1);
+        const value = (words[0] << 4) | words[1];
+        return result(value, inverted, canonicalRotation, corrections);
+      } catch (error) {
+        checksumError = error;
+      }
+    }
+  }
+
+  if (checksumError) {
+    throw new FormatError(`Aztec Rune: Reed-Solomon check failed: ${checksumError.message}`);
+  }
+  throw new FormatError('Aztec Rune: structural pattern or orientation is invalid');
+}
+
+export { readCodewords, structureMatches };