@sythos/js_barcode_universal 1.3.1 → 1.4.1

package/examples/create.html

@@ -7,6 +7,7 @@
 <!--
   Sythos Barcode Suite — example
   Copyright (c) 2026 Sythos
+  SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
   SPDX-License-Identifier: MIT
 
   Loads the IIFE bundle with a plain <script> tag, so this page works when
@@ -161,7 +162,7 @@
     </div>
 
     <div id="frameOpts" style="display:none">
-      <p class="hint">Sythos Canvas QR profile: this is not certified DENSO FrameQR interoperability.</p>
+      <p class="hint">FrameQR Code</p>
       <label for="frameCanvasShape">Canvas shape</label>
       <select id="frameCanvasShape">
         <option value="square" selected>Square</option>

package/examples/read.html

@@ -7,6 +7,7 @@
 <!--
   Sythos Barcode Suite — example
   Copyright (c) 2026 Sythos
+  SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
   SPDX-License-Identifier: MIT
 
   File input first, camera second — deliberately.

package/licenses/README.md

@@ -13,8 +13,10 @@ appendix carries the consolidated inventory these files expand on.
 | Aztec Code | [`aztec-code.license`](aztec-code.license) | 2 |
 | QR Code | [`qr-code.license`](qr-code.license) | 2 |
 | Data Matrix ECC 200 | [`data-matrix.license`](data-matrix.license) | 2 |
+| Aztec Rune | [`aztec-rune.license`](aztec-rune.license) | 2 |
 | PDF417 | [`pdf417.license`](pdf417.license) | 2 |
 | MicroPDF417 | [`micropdf417.license`](micropdf417.license) | 2 |
+| Compact PDF417 | [`compact-pdf417.license`](compact-pdf417.license) | 2 |
 | EAN-13 | [`ean-13.license`](ean-13.license) | 2 |
 | EAN-8 | [`ean-8.license`](ean-8.license) | 2 |
 | UPC-A | [`upc-a.license`](upc-a.license) | 2 |
@@ -30,9 +32,12 @@ appendix carries the consolidated inventory these files expand on.
 | Code 11 | [`code-11.license`](code-11.license) | 2 |
 | MSI Plessey | [`msi-plessey.license`](msi-plessey.license) | 2 |
 | Pharmacode | [`pharmacode.license`](pharmacode.license) | 2 |
+| EAN-2 supplement | [`ean-2.license`](ean-2.license) | 2 |
+| 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 |
-| Frame QR / Sythos Canvas QR profile | [`frameqr.license`](frameqr.license) | 2 |
+| FrameQR Code | [`frameqr.license`](frameqr.license) | 2 |
+| GS1 DataBar data-layer codecs | [`gs1-databar.license`](gs1-databar.license) | 2 |
 
 ## On the `[TO VERIFY]` markers
 

package/licenses/aztec-rune.license

@@ -0,0 +1,76 @@
+Aztec Rune — format provenance and usability
+==========================================================================
+
+This file records where the Aztec Rune 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
+--------------------------------------------------------------------------
+
+Aztec Rune is the fixed 11-module, eight-bit companion form of the Aztec
+Code family. This implementation is limited to the published Rune value
+range 0-255.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 24778:2024 — Aztec Code bar code symbology specification.
+ZXing-C++ was used only as an independent black-box runtime oracle; no
+source code or table is copied or shipped.
+
+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
+--------------------------------------------------------------------------
+
+Historical public-domain reports exist for Aztec symbologies, but no
+primary AIM waiver or complete patent-family review was located for Rune
+specifically. [LEGAL REVIEW]
+
+
+TRADEMARK
+--------------------------------------------------------------------------
+
+The current registration status and ownership of "Aztec Rune" have not
+been independently established. [LEGAL REVIEW] The name is used
+descriptively and does not imply endorsement.
+
+A trademark does not restrict implementing a symbology. It restricts
+branding — how a product names and presents itself.
+
+
+IMPLEMENTATION BASIS IN THIS PROJECT
+--------------------------------------------------------------------------
+
+Aztec Rune 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
+consulted for engineering review or black-box verification; provenance is
+recorded in NOTICE.md.
+
+
+CONCLUSION
+--------------------------------------------------------------------------
+
+This project's original Aztec Rune implementation is distributed under the
+MIT License. This inventory is not a legal opinion that every historical
+or current patent claim is exhausted. [LEGAL REVIEW]
+
+References relied upon:
+  - ISO/IEC 24778:2024, ISO/IEC
+  - ZXing-C++ black-box validation, https://github.com/zxing-cpp/zxing-cpp
+  - Aztec Rune patent and trademark scope [LEGAL REVIEW]
+
+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/compact-pdf417.license

@@ -0,0 +1,76 @@
+Compact PDF417 — format provenance and usability
+==========================================================================
+
+This file records where the Compact PDF417 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
+--------------------------------------------------------------------------
+
+Compact PDF417 is the truncated PDF417 geometry: the standard PDF417 data
+and error-correction family with the right row indicator omitted and a
+reduced stop pattern.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 15438:2015 — PDF417 bar code symbology specification.
+Independent runtimes were used only as black-box verification tools; no
+third-party source code or table is shipped.
+
+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
+--------------------------------------------------------------------------
+
+Compact PDF417 inherits the historical PDF417 patent landscape. US
+5,243,655 and US 5,304,786 and related families require a
+jurisdiction-by-jurisdiction review. [LEGAL REVIEW]
+
+
+TRADEMARK
+--------------------------------------------------------------------------
+
+The current registration status and ownership of "Compact PDF417" have not
+been independently established. [LEGAL REVIEW]
+
+A trademark does not restrict implementing a symbology. It restricts
+branding — how a product names and presents itself.
+
+
+IMPLEMENTATION BASIS IN THIS PROJECT
+--------------------------------------------------------------------------
+
+Compact PDF417 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
+consulted for engineering review or black-box verification; provenance is
+recorded in NOTICE.md.
+
+
+CONCLUSION
+--------------------------------------------------------------------------
+
+This project's original Compact PDF417 implementation is distributed under
+the MIT License. The engineering implementation is not a certification or
+legal clearance. [LEGAL REVIEW]
+
+References relied upon:
+  - ISO/IEC 15438:2015, ISO/IEC
+  - ZXing-C++ black-box validation, https://github.com/zxing-cpp/zxing-cpp
+  - US 5,243,655, USPTO patent record
+  - US 5,304,786, USPTO patent record
+
+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/ean-2.license

@@ -0,0 +1,74 @@
+EAN-2 supplement — format provenance and usability
+==========================================================================
+
+This file records where the EAN-2 supplement 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
+--------------------------------------------------------------------------
+
+EAN-2 is the two-digit EAN/UPC add-on symbol used as a supplement to a
+primary EAN or UPC symbol. This project exposes its parity and guard
+geometry as a writable add-on.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 15420 — EAN/UPC bar code symbology specification.
+GS1 General Specifications, GS1 AISBL — freely published; redistribution
+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
+authorship. This project implements the symbology; it does not reproduce,
+redistribute or excerpt any specification document.
+
+
+PATENT STATUS
+--------------------------------------------------------------------------
+
+The originating patents date from the 1970s-1980s and are understood to
+have expired long ago. [LEGAL REVIEW]
+
+
+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
+--------------------------------------------------------------------------
+
+EAN-2 supplement 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
+consulted for engineering review or black-box verification; provenance is
+recorded in NOTICE.md.
+
+
+CONCLUSION
+--------------------------------------------------------------------------
+
+The original add-on implementation is distributed under the MIT License.
+Generic camera read capability remains intentionally separate from the
+direct matrix helper.
+
+References relied upon:
+  - ISO/IEC 15420, ISO/IEC
+  - GS1 General Specifications, GS1 AISBL — freely published;
+    redistribution terms are GS1's own [LEGAL REVIEW]
+  - ZXing-C++ add-on black-box check, https://github.com/zxing-cpp/zxing-cpp
+
+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/ean-5.license

@@ -0,0 +1,74 @@
+EAN-5 supplement — format provenance and usability
+==========================================================================
+
+This file records where the EAN-5 supplement 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
+--------------------------------------------------------------------------
+
+EAN-5 is the five-digit EAN/UPC add-on symbol used as a supplement to a
+primary EAN or UPC symbol. This implementation covers the published 3/9
+checksum, parity and guard geometry.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 15420 — EAN/UPC bar code symbology specification.
+GS1 General Specifications, GS1 AISBL — freely published; redistribution
+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
+authorship. This project implements the symbology; it does not reproduce,
+redistribute or excerpt any specification document.
+
+
+PATENT STATUS
+--------------------------------------------------------------------------
+
+The originating patents date from the 1970s-1980s and are understood to
+have expired long ago. [LEGAL REVIEW]
+
+
+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
+--------------------------------------------------------------------------
+
+EAN-5 supplement 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
+consulted for engineering review or black-box verification; provenance is
+recorded in NOTICE.md.
+
+
+CONCLUSION
+--------------------------------------------------------------------------
+
+The original add-on implementation is distributed under the MIT License.
+Generic camera read capability remains intentionally separate from the
+direct matrix helper.
+
+References relied upon:
+  - ISO/IEC 15420, ISO/IEC
+  - GS1 General Specifications, GS1 AISBL — freely published;
+    redistribution terms are GS1's own [LEGAL REVIEW]
+  - ZXing-C++ add-on black-box check, https://github.com/zxing-cpp/zxing-cpp
+
+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/frameqr.license

@@ -1,7 +1,7 @@
-Frame QR / Sythos Canvas QR profile — format provenance and usability
+FrameQR Code — format provenance and usability
 ==========================================================================
 
-This file records where the Frame QR / Sythos Canvas QR profile symbology comes from, what governs
+This file records where the FrameQR 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]
@@ -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 Sythos Canvas QR
+reproduced here. This project implements the separate FrameQR Code
 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
 --------------------------------------------------------------------------
 
-Frame QR / Sythos Canvas QR profile is implemented here from published descriptions of the format,
+FrameQR Code 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 Sythos
-Canvas QR profile `sythos-canvas-qr/1`, not DENSO FrameQR. It reserves a
+The distributed implementation is the original, non-certified FrameQR Code
+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

@@ -0,0 +1,81 @@
+GS1 DataBar data-layer codecs — format provenance and usability
+==========================================================================
+
+This file records where the GS1 DataBar data-layer codecs 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
+--------------------------------------------------------------------------
+
+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.
+
+
+SPECIFICATION
+--------------------------------------------------------------------------
+
+ISO/IEC 24724 — GS1 DataBar bar code symbology specification.
+GS1 General Specifications, GS1 AISBL — freely published; redistribution
+terms are GS1's own [LEGAL REVIEW]
+GS1 public DataBar overview,
+https://www.gs1.org/standards/barcodes/databar
+
+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
+--------------------------------------------------------------------------
+
+GS1's intellectual-property policy and third-party patent declarations
+require a dedicated review for deployed implementations. No unconditional
+patent-free or public-domain claim is made. [LEGAL REVIEW]
+
+
+TRADEMARK
+--------------------------------------------------------------------------
+
+"GS1" and its symbology names are trademarks of GS1 AISBL. "GS1 DataBar"
+is used descriptively with attribution and does not imply endorsement or
+certification.
+
+A trademark does not restrict implementing a symbology. It restricts
+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,
+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
+consulted for engineering review or black-box verification; provenance is
+recorded in NOTICE.md.
+
+
+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]
+
+References relied upon:
+  - ISO/IEC 24724, ISO/IEC
+  - GS1 General Specifications, GS1 AISBL — freely published;
+    redistribution terms are GS1's own [LEGAL REVIEW]
+  - GS1 DataBar overview, https://www.gs1.org/standards/barcodes/databar
+  - GS1 IP policy, https://ref.gs1.org/gs1/ip-policy/
+
+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,8 +1,11 @@
 {
   "name": "@sythos/js_barcode_universal",
-  "version": "1.3.1",
-  "description": "Read and write barcodes in JavaScript with zero runtime dependencies. QR Code, Micro QR, rMQR, the non-certified Sythos Canvas QR profile, Aztec Code, Data Matrix ECC 200, MicroPDF417, PDF417 and one-dimensional formats.",
-  "author": "Sythos",
+  "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",
@@ -24,8 +27,11 @@
     "./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",
     "./microqr": "./src/microqr/index.js",
     "./rmqr": "./src/rmqr/index.js",
@@ -45,13 +51,19 @@
     "licenses",
     "LICENSE",
     "NOTICE.md",
-    "README.md"
+    "README.md",
+    "AI_USAGE.md"
   ],
   "keywords": [
     "barcode",
     "datamatrix",
     "ecc200",
     "aztec",
+    "aztec-rune",
+    "compact-pdf417",
+    "gs1-databar",
+    "ean2",
+    "ean5",
     "aztec-code",
     "pdf417",
     "pdf-417",

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.