@sythos/js_barcode_universal 1.5.8 → 1.5.9

package/LICENSE

@@ -61,7 +61,7 @@ qualified attorney.
     --------------------------------  -----------  ---------------------------
     independent barcode               various      differential encode and
       implementations                              decode oracles
-    typescript (tsc)                  Apache-2.0   .d.ts generation from JSDoc
+    typescript (tsc)                  Apache-2.0   runtime compilation and public type checks
 
 THE PROJECT RULE, STATED PRECISELY:
 
@@ -75,9 +75,10 @@ and legal review where required. None of this is a legal conclusion about
 derivative works or license obligations.
 
 typescript (tsc) is not a barcode library and carries no symbology logic at
-all. It is an optional generator: it reads the JSDoc annotations already
-present in this project's own source and emits .d.ts declarations from them.
-There is no TypeScript source in this project.
+all. It is a development-only compiler and validator: it compiles this
+project's own TypeScript runtime source into JavaScript and checks its public
+declarations. TypeScript is not a runtime dependency and does not contribute
+barcode data or algorithms.
 
 No barcode library is a dependency of this package. None of the tools above is
 a runtime dependency, none ships in the published package, and running or not

package/NOTICE.md

@@ -2,7 +2,7 @@
 
 ## Origin of this code
 
-The JavaScript implementation and integration work in this repository is
+The TypeScript source and compiled JavaScript runtime integration work in this repository is
 original work by **Sythos (https://www.sythos.net)**. No third-party barcode
 source code is copied into or shipped by this package. Public or normative
 format values may be represented in original Sythos data structures, with
@@ -96,7 +96,7 @@ Records any constant table whose values were transcribed from a documented
 source rather than generated by `tools/`. Each entry names the source and the
 date of transcription.
 
-| PDF417 pattern ordering | AIM USS-PDF417 public reference ([reference copy](https://www.expresscorp.com/uploads/specifications/44/USS-PDF-417.pdf)), Appendix H / Table H1, transcribed for `src/js/pdf417/tables.js`; accessed 2026-08-11. The reference copy is attributed here; its copyright and redistribution terms remain under legal review. |
+| PDF417 pattern ordering | AIM USS-PDF417 public reference ([reference copy](https://www.expresscorp.com/uploads/specifications/44/USS-PDF-417.pdf)), Appendix H / Table H1, represented in the TypeScript source `src/ts/pdf417/tables.ts` and emitted to `src/js/pdf417/tables.js`; accessed 2026-08-11. The reference copy is attributed here; its copyright and redistribution terms remain under legal review. |
 | PDF417 black-box verification | ZXing Java 3.5.3 and bwip-js 4.5.1 were invoked as external black boxes on 2026-08-11 for bidirectional Text/Numeric/UTF-8 vectors. Their source and tables are not shipped. |
 | PDF417 device evidence | User-provided 6/6 continuous-camera attestations on Pixel 10/Android 17/Chrome and iPhone 17/Safari, including printed Brother MFC-L2710DW symbols, low light/flash, blur and motion; recorded as user evidence, not independently captured by this repository. |
 | MicroPDF417 technical and provenance review | [ISO/IEC 24728:2006](https://www.iso.org/standard/38838.html), [Wikipedia overview](https://en.wikipedia.org/wiki/MicroPDF417), [US 6,047,892 record](https://patents.google.com/patent/US6047892A/en) and its [direct PDF](https://patentimages.storage.googleapis.com/0a/79/f5/e8d374043414f3/US6047892.pdf) were consulted on 2026-08-11. ZXing-C++, Zint and bwip-js were consulted for implementation/review or black-box validation. No third-party source code is copied or shipped; normative/public values are represented in original Sythos data structures, with provenance and legal review pending. |

package/README.md

@@ -58,7 +58,7 @@ npm install @sythos/js_barcode_universal
 
 `yarn add @sythos/js_barcode_universal` and `pnpm add @sythos/js_barcode_universal` do the same thing. Nothing is installed
 alongside it — there are no runtime dependencies, no postinstall script and no native build. The
-package is plain ESM (`"type": "module"`) and asks for Node 18 or newer.
+package is plain ESM (`"type": "module"`) and asks for Node 24 or newer.
 
 ```js
 import { encode, decode, toSVG, toImageData } from '@sythos/js_barcode_universal';
@@ -112,8 +112,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.5.8"></script>
-<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.8"></script>
+<script src="https://unpkg.com/@sythos/js_barcode_universal@1.5.9"></script>
+<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.9"></script>
 ```
 
 Pin the version for anything you ship; the unpinned form resolves to `latest` and will move under
@@ -161,18 +161,22 @@ toPNG(ean, { scale: 3, barHeight: 80 }).then((bytes) => {
 
 ### 4. The source directly
 
-[`src/index.js`](src/index.js) is plain ESM with JSDoc types and no build step of its own. Import
-it and let your bundler tree-shake; the package is marked side-effect free. The source layout is
-deliberately explicit:
+[`src/index.js`](src/index.js) is the generated ESM facade emitted from the TypeScript source
+tree. The source layout is deliberately explicit:
 
-- `src/index.js` is the stable public facade.
-- `src/index.d.ts` is the public TypeScript declaration facade for the top-level entry point.
-- `src/js/` contains the zero-dependency JavaScript runtime modules, including format subpaths.
-- `src/ts/` contains the shipped machine-readable TypeScript declaration modules for the format
-  subpaths. These declarations describe the JavaScript runtime and do not add a runtime dependency.
+- `src/ts/` contains the TypeScript runtime sources and their adjacent machine-readable `.d.ts`
+  declarations, including `src/ts/index.ts` and `src/ts/index.d.ts`.
+- `src/js/` contains the compiled JavaScript runtime modules used by Node, browsers and the CDN
+  bundles.
+- `src/index.js` and `src/index.d.ts` are the stable package-root facades.
 
-The package subpath exports therefore pair runtime modules under `src/js/` with their declaration
-counterparts under `src/ts/`; direct source imports should continue to use the facade above.
+From the development workspace, `npm run build:ts` compiles `src/ts/` into `src/js/` and the
+root JavaScript facade; `npm run build` then regenerates both bundles. The published package
+keeps both source languages visible while retaining zero runtime dependencies.
+
+The package subpath exports therefore pair compiled runtime modules under `src/js/` with their
+TypeScript sources and declarations under `src/ts/`; direct source imports should continue to use
+the JavaScript facade above.
 
 ```js
 import { encode, decode, toImageData, listFormats } from './src/index.js';