@sythos/js_barcode_universal 0.1.0

package/licenses/qr-code.license

@@ -0,0 +1,75 @@
+QR Code — format provenance and usability
+==========================================================================
+
+This file records where the QR Code 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]
+have not been independently confirmed by the author.
+
+
+ORIGIN
+--------------------------------------------------------------------------
+
+Devised by DENSO WAVE INCORPORATED (Japan) in 1994, for tracking parts in
+vehicle manufacturing.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 18004 — QR Code bar code symbology specification.
+Published by ISO/IEC. The specification TEXT is copyrighted by its
+publisher and is paywalled; it is not reproduced here.
+
+Specification TEXT is copyrighted by its publisher. The SYMBOLOGY it
+describes is not — an encoding scheme is a system, not a work of
+authorship. This project implements the symbology; it does not reproduce,
+redistribute or excerpt any specification document.
+
+
+PATENT STATUS
+--------------------------------------------------------------------------
+
+DENSO WAVE holds patents relating to QR Code and has publicly stated that
+it does not exercise those rights for the standardised symbology, which is
+what made QR Code ubiquitous. [TO VERIFY]
+
+
+TRADEMARK
+--------------------------------------------------------------------------
+
+"QR Code" is a REGISTERED TRADEMARK of DENSO WAVE INCORPORATED. This is
+the most important entry in this file: the mark does not restrict
+implementing the symbology, but it does constrain how a product is NAMED
+and BRANDED. Describing software as "reads QR Code" is descriptive use;
+naming a product "QR Code Studio" is not.
+
+A trademark does not restrict implementing a symbology. It restricts
+branding — how a product names and presents itself.
+
+
+IMPLEMENTATION BASIS IN THIS PROJECT
+--------------------------------------------------------------------------
+
+QR Code 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.
+
+
+CONCLUSION
+--------------------------------------------------------------------------
+
+On the basis of the references below, QR Code is understood to be freely
+implementable and redistributable, and this project's implementation of it
+is distributed under the MIT License with no additional restriction.
+
+References relied upon:
+  - ISO/IEC 18004, ISO/IEC
+  - DENSO WAVE's published position on its QR Code patent rights [TO VERIFY]
+  - QR Code trademark registration, DENSO WAVE INCORPORATED [TO VERIFY]
+
+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-a.license

@@ -0,0 +1,72 @@
+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 marked [TO VERIFY]
+have not been independently confirmed by the author.
+
+
+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 [TO VERIFY] and no
+individual is named here. Administered today by GS1.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 15420 — EAN/UPC bar code symbology specification.
+GS1 General Specifications, GS1 AISBL — freely published; redistribution
+terms are GS1's own [TO VERIFY]
+
+Specification TEXT is copyrighted by its publisher. The SYMBOLOGY it
+describes is not — an encoding scheme is a system, not a work of
+authorship. This project implements the symbology; it does not reproduce,
+redistribute or excerpt any specification document.
+
+
+PATENT STATUS
+--------------------------------------------------------------------------
+
+The originating patents date from the early 1970s and are understood to
+have expired long ago. [TO VERIFY]
+
+
+TRADEMARK
+--------------------------------------------------------------------------
+
+"GS1" and its symbology names are trademarks of GS1 AISBL.
+
+A trademark does not restrict implementing a symbology. It restricts
+branding — how a product names and presents itself.
+
+
+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.
+
+
+CONCLUSION
+--------------------------------------------------------------------------
+
+On the basis of the references below, UPC-A is understood to be freely
+implementable and redistributable, and this project's implementation of it
+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 [TO VERIFY]
+
+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

@@ -0,0 +1,69 @@
+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 marked [TO VERIFY]
+have not been independently confirmed by the author.
+
+
+ORIGIN
+--------------------------------------------------------------------------
+
+The zero-suppressed form of UPC-A, encoding six digits in place of twelve
+for small packages. Part of the same GS1-administered family.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 15420 — EAN/UPC bar code symbology specification.
+GS1 General Specifications, GS1 AISBL — freely published; redistribution
+terms are GS1's own [TO VERIFY]
+
+Specification TEXT is copyrighted by its publisher. The SYMBOLOGY it
+describes is not — an encoding scheme is a system, not a work of
+authorship. This project implements the symbology; it does not reproduce,
+redistribute or excerpt any specification document.
+
+
+PATENT STATUS
+--------------------------------------------------------------------------
+
+Shares the patent history of UPC-A; understood expired. [TO VERIFY]
+
+
+TRADEMARK
+--------------------------------------------------------------------------
+
+"GS1" and its symbology names are trademarks of GS1 AISBL.
+
+A trademark does not restrict implementing a symbology. It restricts
+branding — how a product names and presents itself.
+
+
+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.
+
+
+CONCLUSION
+--------------------------------------------------------------------------
+
+On the basis of the references below, UPC-E is understood to be freely
+implementable and redistributable, and this project's implementation of it
+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 [TO VERIFY]
+
+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

@@ -0,0 +1,89 @@
+{
+  "name": "@sythos/js_barcode_universal",
+  "version": "0.1.0",
+  "description": "Read and write barcodes in JavaScript. 100% original code, zero runtime dependencies. 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",
+    "./qr": "./src/qr/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",
+    "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/core/bit-buffer.js

@@ -0,0 +1,174 @@
+/*!
+ * 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-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+
+/**
+ * Bit-level writing and reading, MSB-first.
+ *
+ * Every 2D symbology serialises its payload as a bitstream that does not
+ * respect byte boundaries — QR alone mixes 4-bit mode indicators, 10-bit
+ * character-count fields and 11-bit alphanumeric pairs. These two classes are
+ * the write and read halves of that.
+ *
+ * @module core/bit-buffer
+ */
+
+import { FormatError } from './errors.js';
+
+/** Growable MSB-first bit writer. */
+export class BitWriter {
+  constructor() {
+    /** @type {number[]} Packed bytes; the last one may be partially filled. */
+    this.bytes = [];
+    this.bitLength = 0;
+  }
+
+  /** @returns {number} Bits written so far. */
+  get length() {
+    return this.bitLength;
+  }
+
+  /**
+   * Append the low `count` bits of `value`, most significant first.
+   *
+   * @param {number} value
+   * @param {number} count
+   */
+  put(value, count) {
+    for (let i = count - 1; i >= 0; i--) {
+      this.putBit(((value >>> i) & 1) === 1);
+    }
+  }
+
+  /** @param {boolean} bit */
+  putBit(bit) {
+    const idx = this.bitLength >>> 3;
+    if (this.bytes.length <= idx) this.bytes.push(0);
+    if (bit) this.bytes[idx] |= 0x80 >>> (this.bitLength & 7);
+    this.bitLength++;
+  }
+
+  /** @param {ArrayLike<number>} data */
+  putBytes(data) {
+    for (let i = 0; i < data.length; i++) this.put(data[i], 8);
+  }
+
+  /** Pad with zero bits until the length is a multiple of 8. */
+  padToByte() {
+    while (this.bitLength & 7) this.putBit(false);
+  }
+
+  /**
+   * @returns {Uint8Array} Byte view; trailing bits of the final byte are zero.
+   */
+  toBytes() {
+    return Uint8Array.from(this.bytes);
+  }
+
+  /** @returns {string} Debug view, e.g. "0100 0011 0101". */
+  toString() {
+    let s = '';
+    for (let i = 0; i < this.bitLength; i++) {
+      if (i && i % 4 === 0) s += ' ';
+      s += (this.bytes[i >>> 3] >>> (7 - (i & 7))) & 1;
+    }
+    return s;
+  }
+}
+
+/** MSB-first bit reader over a byte array. */
+export class BitReader {
+  /** @param {ArrayLike<number>} bytes */
+  constructor(bytes) {
+    this.bytes = bytes;
+    this.byteOffset = 0;
+    this.bitOffset = 0;
+  }
+
+  /** @returns {number} Bits not yet consumed. */
+  available() {
+    return 8 * (this.bytes.length - this.byteOffset) - this.bitOffset;
+  }
+
+  /**
+   * Read `count` bits (1..32) as an unsigned integer, most significant first.
+   *
+   * @param {number} count
+   * @returns {number}
+   * @throws {FormatError} If the stream is exhausted.
+   */
+  read(count) {
+    if (count < 1 || count > 32) {
+      throw new FormatError(`BitReader: cannot read ${count} bits`);
+    }
+    if (count > this.available()) {
+      throw new FormatError(
+        `BitReader: needed ${count} bits, ${this.available()} remain`
+      );
+    }
+
+    let result = 0;
+    let remaining = count;
+
+    // Finish the partially consumed byte first, then take whole bytes.
+    if (this.bitOffset > 0) {
+      const inCurrent = 8 - this.bitOffset;
+      const take = Math.min(remaining, inCurrent);
+      const shift = inCurrent - take;
+      const mask = (0xff >> this.bitOffset) & ~((1 << shift) - 1);
+      result = (this.bytes[this.byteOffset] & mask) >> shift;
+      remaining -= take;
+      this.bitOffset += take;
+      if (this.bitOffset === 8) {
+        this.bitOffset = 0;
+        this.byteOffset++;
+      }
+    }
+
+    while (remaining >= 8) {
+      result = (result << 8) | (this.bytes[this.byteOffset] & 0xff);
+      this.byteOffset++;
+      remaining -= 8;
+    }
+
+    if (remaining > 0) {
+      const shift = 8 - remaining;
+      const mask = ~((1 << shift) - 1) & 0xff;
+      result = (result << remaining) | ((this.bytes[this.byteOffset] & mask) >> shift);
+      this.bitOffset += remaining;
+    }
+
+    return result >>> 0;
+  }
+
+  /** @returns {boolean} */
+  readBit() {
+    return this.read(1) === 1;
+  }
+}