@sythos/js_barcode_universal 1.3.1 → 1.5.0

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.
@@ -97,6 +98,11 @@
     Sythos Barcode Suite &mdash; 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

@@ -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 |
+| GS1 DataBar Omnidirectional / Truncated | [`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,75 @@
+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.
+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
+  - 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,75 @@
+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.
+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
+  - 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/gs1-databar.license

@@ -0,0 +1,84 @@
+GS1 DataBar Omnidirectional / Truncated — format provenance and usability
+==========================================================================
+
+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]
+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 plus physical Omnidirectional and
+Truncated pattern readers and writers; other physical variants remain
+outside the package scope.
+
+
+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 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
+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.
+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
+  - 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.5.0",
+  "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.