@sythos/js_barcode_universal 1.5.7 → 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/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

@@ -1,16 +1,10 @@
 # Sythos Barcode Suite and SDK
 
-Read and write barcodes in JavaScript.
+Read and write barcodes in JavaScript and TypeScript.
 
-[![npm](https://img.shields.io/npm/v/@sythos/js_barcode_universal.svg)](https://www.npmjs.com/package/@sythos/js_barcode_universal)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Runtime dependencies: 0](https://img.shields.io/badge/runtime%20dependencies-0-brightgreen.svg)](package.json)
-[![ESM](https://img.shields.io/badge/ESM-supported-3178C6.svg?logo=javascript&logoColor=white)](https://nodejs.org/api/esm.html)
-[![Node](https://img.shields.io/node/v/%40sythos%2Fjs_barcode_universal.svg)](https://www.npmjs.com/package/@sythos/js_barcode_universal)
+[![npm](https://img.shields.io/npm/v/@sythos/js_barcode_universal.svg)](https://www.npmjs.com/package/@sythos/js_barcode_universal) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Runtime dependencies: 0](https://img.shields.io/badge/runtime%20dependencies-0-brightgreen.svg)](package.json) [![ESM](https://img.shields.io/badge/ESM-supported-3178C6.svg?logo=javascript&logoColor=white)](https://nodejs.org/api/esm.html) ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)
 
-[![npm downloads](https://img.shields.io/npm/dm/%40sythos%2Fjs_barcode_universal.svg?label=npm%20downloads)](https://www.npmjs.com/package/@sythos/js_barcode_universal)
-[![GitHub last commit](https://img.shields.io/github/last-commit/Sythos/JS_Barcode_Universal.svg)](https://github.com/Sythos/JS_Barcode_Universal/commits/main/)
-[![GitHub issues](https://img.shields.io/github/issues/Sythos/JS_Barcode_Universal.svg)](https://github.com/Sythos/JS_Barcode_Universal/issues)
+[![npm downloads](https://img.shields.io/npm/dm/%40sythos%2Fjs_barcode_universal.svg?label=npm%20downloads)](https://www.npmjs.com/package/@sythos/js_barcode_universal) [![GitHub last commit](https://img.shields.io/github/last-commit/Sythos/JS_Barcode_Universal.svg)](https://github.com/Sythos/JS_Barcode_Universal/commits/main/) [![GitHub issues](https://img.shields.io/github/issues/Sythos/JS_Barcode_Universal.svg)](https://github.com/Sythos/JS_Barcode_Universal/issues) [![Node](https://img.shields.io/node/v/%40sythos%2Fjs_barcode_universal.svg)](https://www.npmjs.com/package/@sythos/js_barcode_universal)
 
 Original Sythos implementation, zero runtime dependencies, MIT. It runs unmodified in Node, in browsers
 (including Safari on iOS) and in web workers. The core requires no canvas, no filesystem and no
@@ -64,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';
@@ -118,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.7"></script>
-<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.7"></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
@@ -167,8 +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.
+[`src/index.js`](src/index.js) is the generated ESM facade emitted from the TypeScript source
+tree. The source layout is deliberately explicit:
+
+- `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.
+
+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';
@@ -205,11 +213,14 @@ decode(frame, { formats, profile: 'camera', tryHarder: true })
 ```
 
 The profile requires a compatible quiet zone and the same complete 1D symbol on at least two
-scan samples. It retries only the two quarter-turn orientations needed for 1D symbols when the
-native orientation has no validated read. Code 11 and MSI require a verified check digit in this
-profile; other formats retain their own structural and checksum validation. A frame without a
-validated barcode still returns `[]`. No partial, structurally inconsistent or low-confidence value is
-emitted to the caller.
+scan samples. It evaluates the eight fixed in-plane orientations `0°`, `45°`, `90°`, `135°`,
+`180°`, `225°`, `270°` and `315°` when the native orientation has no validated read. The same
+orientation set is available to the supported 2D detector passes in the strict camera profile.
+Code 11 and MSI require a verified check digit in this profile; other formats retain their own
+structural and checksum validation. A frame without a validated barcode still returns `[]`. No
+partial, structurally inconsistent or low-confidence value is emitted to the caller. This is a
+finite in-plane retry policy, not a guarantee for arbitrary perspective, curved media, severe
+occlusion or multi-symbol scenes.
 
 Camera-profile 1D results add `confidence` (0–1), `bounds`, `rotation`, and
 `quality: { quietZone, checksum, rows, consistency }`. `bounds` is reported in the raster
@@ -300,9 +311,9 @@ console.log(result.text, result.gs1); // 0101234567890128 true
 
 Binary content is accepted as a `Uint8Array` with `encoding: 'base256'`. The current high-level
 decoder handles ASCII and Base256 codewords; C40, Text, X12 and EDIFACT input symbols are not yet
-decoded. The current detector accepts axis-aligned square or rectangular symbols; the normal
-`decode(image, { formats: ['datamatrix'] })` pipeline also retries quarter-turn rotations.
-Arbitrary-angle and perspective-skewed Data Matrix photographs are not yet guaranteed.
+decoded. The current detector accepts axis-aligned square or rectangular symbols; with
+`profile: 'camera'`, the decode pipeline evaluates the eight fixed in-plane orientations at 45°
+steps. Arbitrary perspective and perspective-skewed Data Matrix photographs are not yet guaranteed.
 
 ### Aztec Code
 
@@ -320,9 +331,9 @@ const result = decodeAztec(symbol);
 console.log(result.text); // Greetings My Lord Sythos  👋
 ```
 
-The image detector handles rotation, inverted polarity and quadrilateral sampling around the
-central bull’s-eye. Severe photographic perspective remains an interoperability and robustness
-gate rather than a guaranteed capability.
+The image detector handles the eight fixed camera-profile orientations, inverted polarity and
+quadrilateral sampling around the central bull’s-eye. Severe photographic perspective remains an
+interoperability and robustness gate rather than a guaranteed capability.
 
 ### PDF417 (writer, matrix decoder and camera reader)
 
@@ -330,8 +341,8 @@ gate rather than a guaranteed capability.
 (UTF-8), ECC levels 0–8, row-height inference and Reed–Solomon erasure correction. The direct
 matrix decoder is available from `@sythos/js_barcode_universal/pdf417`.
 
-The image helper handles clean module-aligned raster symbols, integer scale, right-angle
-rotations, automatic perspective estimation, mild blur/noise and an application-supplied
+The image helper handles clean module-aligned raster symbols, integer scale, fixed 45°-step
+camera orientations, automatic perspective estimation, mild blur/noise and an application-supplied
 quadrilateral. Results expose `bytes` and ordered `segments` for byte-preserving payloads. Real
 device validation covers Pixel 10/Chrome and iPhone 17/Safari with printed symbols and continuous
 camera capture. Extreme glare, severe occlusion, curved media and multi-symbol scenes remain
@@ -357,17 +368,18 @@ const symbol = encodeMicroPDF417('MICRO PDF417', { compaction: 'text' });
 console.log(decodeMicroPDF417(symbol).text);
 ```
 
-The detector accepts clean, integer-scaled raster symbols and quarter-turn rotations. Arbitrary
-perspective, severe photographic degradation and multi-symbol scenes are not yet claimed as
-robust capabilities.
+The detector accepts clean, integer-scaled raster symbols and the eight fixed camera-profile
+orientations. Arbitrary perspective, severe photographic degradation and multi-symbol scenes are
+not yet claimed as robust capabilities.
 
 ### Micro QR Code
 
 `microqr` implements the M1–M4 family with Numeric, Alphanumeric, ISO-8859-1 Byte and Kanji
 payloads, BCH format protection, the four Micro QR masks and Reed–Solomon correction. M1 is
 detection-only. ECI, FNC1/GS1 and Structured Append are intentionally outside the current API.
-The detector accepts clean scaled rasters, quarter-turns, inverted polarity and mild projective
-sampling, and rejects normal QR Model 2 symbols.
+The detector accepts clean scaled rasters, the eight fixed camera-profile orientations, inverted
+polarity and mild projective sampling, and rejects normal QR Model 2 symbols. Arbitrary perspective
+and curved-media robustness are not claimed.
 
 ```js
 import { encodeMicroQR, decodeMicroQR } from '@sythos/js_barcode_universal/microqr';
@@ -379,8 +391,9 @@ console.log(decodeMicroQR(symbol).text);
 ### rMQR Code
 
 `rmqr` implements all 32 standard rectangular geometries, M/H ECC, Numeric, Alphanumeric, Byte,
-Kanji and ECI payloads. The detector accepts clean integer-scaled rasters, quiet zones and
-quarter-turns; arbitrary photographic perspective and multi-symbol scenes are not claimed.
+Kanji and ECI payloads. The detector accepts clean integer-scaled rasters, quiet zones and the
+eight fixed camera-profile orientations; arbitrary photographic perspective and multi-symbol
+scenes are not claimed.
 
 ```js
 import { encodeRMQR, decodeRMQR } from '@sythos/js_barcode_universal/rmqr';
@@ -414,7 +427,7 @@ exports the QR symbol without embedding the remote artwork.
 ### Aztec Rune, Compact PDF417 and EAN supplements
 
 `aztecrune` implements the fixed 11×11 Rune values 0–255 with clean raster
-detection, inversion and quarter-turn handling. Its matrices were compared
+detection, inversion and the eight fixed camera-profile orientations. Its matrices were compared
 exhaustively with ZXing-C++ as an independent black-box runtime; no ZXing
 source or table is shipped.
 
@@ -602,8 +615,8 @@ Luminance conversion flattens the image to greyscale. Binarization turns that in
 either globally or with a hybrid local threshold that survives uneven lighting. Detection locates
 a symbol and its corners in that bit plane. Detectors that recover four perspective-aware corners
 (currently QR) sample the symbol back through a perspective transform. Data Matrix currently uses
-an axis-aligned bounding box plus quarter-turn retries. Error correction repairs what the camera
-lost. Only then is the payload decoded.
+an axis-aligned bounding box; the strict camera profile evaluates the eight fixed in-plane
+orientations before error correction repairs what the camera lost. Only then is the payload decoded.
 
 **Reed–Solomon is generic over the finite field.** The `GaloisField` class is constructed with a
 field order and a primitive polynomial rather than hard-coding GF(256), which is what lets one