@sythos/js_barcode_universal 1.4.1 → 1.5.1

package/NOTICE.md

@@ -106,6 +106,8 @@ date of transcription.
 | Aztec Rune and Compact PDF417 | ISO/IEC public technical descriptions and ZXing-C++ 3.1.1 were consulted on 2026-08-13. ZXing-C++ was used exclusively as an independent black-box validation tool; no source code or table is copied or shipped. Aztec Rune values were compared exhaustively; Compact PDF417 geometry and payload vectors were compared independently. |
 | EAN-2 and EAN-5 supplements | ISO/IEC 15420, GS1 public specifications and ZXing-C++ 3.1.1 were consulted on 2026-08-13. The add-on parity, guard and checksum routines are original Sythos code; ZXing-C++ was used only for independent add-on validation. |
 | GS1 DataBar Omnidirectional and Truncated | ISO/IEC 24724 and public GS1 material were consulted on 2026-08-13. The physical encoder/decoder uses original Sythos arithmetic and was compared bit-for-bit with Zint 2.16.0 and read bidirectionally with ZXing-C++ 3.1.1 as black boxes. No Zint or ZXing source code or table is copied or shipped. Limited, stacked and expanded physical variants remain outside this release. |
+| Code 11 and MSI Plessey image readers | Published format descriptions and the existing Sythos writer tables were used to implement the scanline readers on 2026-08-13. No third-party source code or table is copied or shipped; checksum and start/stop validation remain original Sythos code. |
+| GS1-128 semantic layer | The existing shared GS1 Application Identifier metadata and public GS1 descriptions were reused on 2026-08-13. FNC1 classification and parsing are original Sythos integration code; no third-party decoder is a runtime dependency. |
 
 ## Verification log
 

package/README.md

@@ -118,8 +118,8 @@ The `unpkg` and `jsdelivr` fields point at the IIFE bundle, so a CDN needs no in
 
 ```html
 <script src="https://unpkg.com/@sythos/js_barcode_universal"></script>
-<script src="https://unpkg.com/@sythos/js_barcode_universal@1.4.1"></script>
-<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.4.1"></script>
+<script src="https://unpkg.com/@sythos/js_barcode_universal@1.5.1"></script>
+<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.1"></script>
 ```
 
 Pin the version for anything you ship; the unpinned form resolves to `latest` and will move under
@@ -219,8 +219,8 @@ time.
 | ITF (Interleaved 2 of 5) | `itf` | 1D | ✅ | ✅ |
 | ITF-14 | `itf14` | 1D | ✅ | ✅ [^1] |
 | Codabar | `codabar` | 1D | ✅ | ✅ |
-| Code 11 | `code11` | 1D | ✅ | — |
-| MSI Plessey | `msi` | 1D | ✅ | — |
+| Code 11 | `code11` | 1D | ✅ | ✅ |
+| MSI Plessey | `msi` | 1D | ✅ | ✅ |
 | Pharmacode | `pharmacode` | 1D | ✅ | — |
 | QR Code | `qr` | 2D | ✅ | ✅ |
 | Data Matrix ECC 200 | `datamatrix` | 2D | ✅ | ✅ |
@@ -229,27 +229,40 @@ time.
 | MicroPDF417 | `micropdf417` | 2D | ✅ | ✅ |
 | Micro QR Code | `microqr` | 2D | ✅ | ✅ |
 | rMQR Code | `rmqr` | 2D | ✅ | ✅ |
-| FrameQR Code | `frameqr` | 2D | ✅ | ✅ |
+| Sythos Canvas QR profile — not DENSO FrameQR® compatible | `frameqr` | 2D | ✅ | ✅ |
 | Aztec Rune | `aztecrune` | 2D | ✅ | ✅ |
 | Compact PDF417 | `compactpdf417` | 2D | ✅ | ✅ |
-| GS1 DataBar Omnidirectional / Truncated | `gs1databar14` | 1D | ✅ | — |
-| EAN-2 supplement | `ean2` | 1D | ✅ | — |
-| EAN-5 supplement | `ean5` | 1D | ✅ | — |
-
-Twenty-eight listed formats are writable and twenty-two are readable. **Code 11, MSI Plessey,
-Pharmacode, EAN-2, EAN-5 and GS1 DataBar remain write-only in the generic image pipeline.** PDF417 exposes direct matrix decoding, automatic
+| GS1 DataBar Omnidirectional / Truncated | `gs1databar14` | 1D | ✅ | ✅ |
+| EAN-2 supplement | `ean2` | 1D | ✅ | ✅ [^2] |
+| EAN-5 supplement | `ean5` | 1D | ✅ | ✅ [^2] |
+
+Twenty-eight listed formats are writable and twenty-seven are readable (EAN-2 and EAN-5 are
+parent-bound supplements). **Pharmacode remains intentionally write-only in the generic image
+pipeline.** Code 11 and MSI Plessey use the scanline reader; GS1 DataBar uses the
+Omnidirectional/Truncated scanline layer over the verified GTIN decoder. PDF417 exposes direct matrix decoding, automatic
 camera localization and an assisted quadrilateral sampler through its subpath. Its detector is
 validated on degraded synthetic photographs and real Pixel 10/Chrome and iPhone 17/Safari camera
 tests; external black-box vectors from ZXing 3.5.3 and bwip-js also pass in both directions.
 Text and Numeric vectors are covered bidirectionally; binary byte-for-byte interop remains
 explicitly unclaimed until a dedicated external byte corpus is added.
 
-[^1]: `gs1128`, `itf14` and `isbn` are sub-variants that share a decoder with their base format, so
-they decode under that base id: a GS1-128 comes back as `code128`, an ITF-14 as `itf`, and an ISBN
-as `ean13`. The payload is intact either way — a GS1-128 *is* a Code 128 with a leading FNC1, an
-ITF-14 *is* an ITF fixed at fourteen digits, and an ISBN barcode *is* an EAN-13 with a 978/979
-prefix. Match on `result.format === 'code128'` rather than `'gs1128'`, or a
-condition on the sub-variant id will silently never fire.
+[^1]: `itf14` and `isbn` share a decoder with their base format, so an ITF-14 comes back as `itf`
+and an ISBN as `ean13`. GS1-128 is classified separately as `gs1128` when its leading FNC1 is
+present and exposes `gs1`, `symbologyIdentifier` and parsed `elements` metadata. The payload is
+intact either way — an ITF-14 is an ITF fixed at fourteen digits, and an ISBN barcode is an EAN-13
+with a 978/979 prefix.
+
+[^2]: EAN-2 and EAN-5 are recognized only when attached to a validated EAN-13, EAN-8, UPC-A or
+UPC-E parent; they are not independent generic retail-symbol readers.
+
+### Code 11 and MSI Plessey image reading
+
+The generic image pipeline now recognizes Code 11 and MSI Plessey through the existing
+scanline reader. Check-digit validation is opt-in with `decode(image, { checkDigit: true })`;
+without that option the physical grammar is still required, while the literal check character is
+preserved for MSI and reliably stripped for Code 11 when its C/K grammar is unambiguous. The
+reader keeps Pharmacode write-only because its unframed narrow/wide grammar is not safe for
+unrestricted image autodetection.
 
 ### Data Matrix ECC 200
 
@@ -357,9 +370,9 @@ const symbol = encodeRMQR('rMQR SAMPLE', { ecc: 'M' });
 console.log(decodeRMQR(symbol).text);
 ```
 
-### FrameQR Code
+### Sythos Canvas QR profile
 
-`frameqr` is an explicitly scoped, non-certified FrameQR Code profile: it reserves a bounded
+`frameqr` is an explicitly scoped, non-certified Sythos Canvas QR profile — not DENSO FrameQR® compatible. It reserves a bounded
 square, circle or diamond artwork canvas inside an ECC-H QR Model 2 symbol. It is **not** a native
 DENSO FrameQR encoder or decoder, and the package makes no DENSO interoperability claim. The
 profile can be read from clean rendered rasters and is exposed through the normal `encode`/`decode`
@@ -390,22 +403,22 @@ source or table is shipped.
 Numeric compaction. It has a clean raster detector and direct matrix decoder.
 
 EAN-2 and EAN-5 are writable supplements exposed by the `oned` subpath and by
-the generic `ean2` and `ean5` format IDs. They are intentionally not generic
-standalone camera-reader formats; use the composition helpers with an EAN/UPC
-base symbol.
+the generic `ean2` and `ean5` format IDs. The image reader recognizes them only
+when attached to a validated EAN/UPC parent; use the composition helpers with
+an EAN/UPC base symbol.
 
 ### GS1 DataBar
 
 The `databar` subpath exposes original GS1 GTIN/AI codecs plus physical
-Omnidirectional and Truncated writers and clean-matrix decoders. Four GTIN
+Omnidirectional and Truncated writers, scanline readers and clean-matrix decoders. Four GTIN
 vectors were compared bit-for-bit with Zint 2.16.0 as a black box. Limited,
 Stacked, Stacked Omnidirectional and Expanded physical layouts remain planned;
 their data-layer helpers do not imply complete scanner support.
 
 ### Not implemented
 
-GS1 DataBar physical support currently covers Omnidirectional and Truncated writing plus clean
-matrix decoding; Limited, Stacked and Expanded physical layouts remain planned. MaxiCode is
+GS1 DataBar physical support currently covers Omnidirectional and Truncated writing plus
+scanline and clean-matrix decoding; Limited, Stacked and Expanded physical layouts remain planned. MaxiCode is
 not implemented. Data Matrix ECC
 200 is implemented for its classic square and rectangular symbols;
 DMRE remains outside the current scope. See [`PLAN.md`](PLAN.md) for the remaining symbologies.
@@ -609,16 +622,16 @@ MIT © 2026 Sythos (https://www.sythos.net). Every source file carries the heade
 
 **The implementation is original Sythos work.** No third-party barcode source code is copied into
 or shipped by this package. The symbologies are implemented from published descriptions of the
-formats and from original Sythos data structures. MicroPDF417, Micro QR, rMQR and the FrameQR
-Code carry provenance and pending legal review in `NOTICE.md`. Independent
+formats and from original Sythos data structures. MicroPDF417, Micro QR, rMQR and the Sythos
+Canvas QR profile carry provenance and pending legal review in `NOTICE.md`. Independent
 implementations and public technical material may be consulted for engineering review or
 black-box verification; no third-party source code is copied or shipped. The distributed package has no runtime third-party
 dependencies. See [`NOTICE.md`](NOTICE.md) and the per-format files in [`licenses/`](licenses/).
 
 Public DENSO FrameQR material was consulted only to document the compatibility boundary. ZXing
 was used only as an independent black-box validation tool; no ZXing source code or tables are
-copied or shipped. The FrameQR Code profile does not claim native DENSO FrameQR
-interoperability or co-author attribution.
+copied or shipped. The Sythos Canvas QR profile is not DENSO FrameQR® compatible and does not
+claim native DENSO interoperability or co-author attribution.
 
 **Trademark is not licence.** QR Code® is a registered trademark of DENSO WAVE; Aztec Code,
 MaxiCode and GS1 DataBar are likewise marks of their owners. A trademark does not restrict