@sythos/js_barcode_universal 1.5.13 → 1.5.15

package/licenses/postal.license

@@ -0,0 +1,61 @@
+Postal 4-state family — format provenance and usability notes
+====================================================================
+
+This file records the engineering and provenance boundary for the postal
+formats implemented by Sythos Barcode Universal: USPS POSTNET, USPS PLANET,
+Royal Mail 4-State Customer Code (RM4SCC), KIX, Australia Post 4-State, Japan
+Post 4-State and USPS Intelligent Mail Barcode (IMb / OneCode).
+
+Implementation
+--------------
+
+The TypeScript implementation and generated JavaScript in this repository are
+original Sythos work and are distributed under the MIT License. The shared
+height-coded classifier, state profiles, checks, Reed–Solomon arithmetic,
+combinatorial IMb mapping and API dispatch are not copied from another barcode
+implementation. The npm package has no runtime dependencies.
+
+Public technical descriptions of the postal alphabets, bar heights, framing,
+checks and payload envelopes were used as engineering input. The implementation
+represents those public format rules in original Sythos data structures. This
+file does not reproduce a standards document or grant certification.
+
+Independent validation boundary
+-------------------------------
+
+BWIPP and bwip-js were invoked locally as independent black-box oracles. Their
+rendered output was compared with Sythos encode/decode results for all seven
+formats. They were used exclusively for verification and counter-checking; no
+source code, lookup table, generated asset or runtime dependency from those
+projects is copied into or shipped by this SDK. Agreement is engineering
+evidence, not an endorsement or a licence grant.
+
+Ownership and naming
+--------------------
+
+POSTNET, PLANET and IMb/OneCode are associated with the United States Postal
+Service. RM4SCC is associated with Royal Mail. KIX is associated with the Dutch
+postal system. Australia Post and Japan Post own or administer their respective
+postal specifications and marks. Names are used descriptively to identify the
+public symbology; this project is not endorsed, certified or operated by any of
+those organisations.
+
+Patent, copyright and trademark review
+--------------------------------------
+
+The code in this repository is MIT-licensed original Sythos work. Whether a
+particular jurisdiction, implementation, service mark, specification edition or
+postal-indicia programme imposes additional conditions is a separate legal
+question. Users shipping a commercial postal workflow should obtain their own
+professional review and any operator approval required for production mail.
+
+[TO VERIFY] Current patent-family status and any jurisdiction-specific claims
+for each postal symbology have not been independently searched in this project.
+
+[TO VERIFY] Current trademark, certification-mark and operator-indicia rules
+were not independently cleared here. Report a concrete notice, licence term or
+conflicting source through a GitHub issue so it can be reviewed and recorded.
+
+This engineering note intentionally keeps those questions visible instead of
+making a broad “patent-free” or “certified” claim. See `LICENSE`, `NOTICE.md`
+and `licenses/README.md` for the project-wide boundary.

package/licenses/pzn.license

@@ -0,0 +1,53 @@
+PZN-7 and PZN-8 — format provenance and usability
+=================================================
+
+This file records the engineering provenance and redistribution boundary for
+the PZN (Pharmazentralnummer) implementation shipped by Sythos Barcode
+Universal.
+
+It is an engineering inventory, not legal advice. Patent, copyright and
+trademark conclusions still need independent review for the jurisdiction and
+the intended product. Items marked [TO VERIFY] remain open questions.
+
+
+FORMAT AND IMPLEMENTATION BASIS
+-------------------------------
+
+PZN-7 and PZN-8 are German pharmaceutical identifiers carried here in a
+Code 39-shaped symbol. The writer accepts a six- or seven-digit body, computes
+the corresponding modulo-11 check digit (rejecting the reserved value ten),
+and emits the documented leading hyphen and check character. The reader first
+validates the complete Code 39 carrier and then validates the PZN check digit;
+it reports the detected PZN-7 or PZN-8 variant instead of guessing from a
+partial payload.
+
+The runtime is original Sythos TypeScript with generated JavaScript output and
+is distributed under the MIT License. The names PZN, Pharmazentralnummer and
+Code 39 are used descriptively and do not imply certification, sponsorship or
+endorsement by a registry owner or standards organisation.
+
+
+PATENT AND TRADEMARK REVIEW
+---------------------------
+
+Historical pharmaceutical-label patents, national patent families and current
+registrations for PZN or related marks have not been independently cleared
+here. [TO VERIFY] This project makes no unconditional patent-free,
+public-domain or trademark-clearance claim.
+
+
+INDEPENDENT VALIDATION BOUNDARY
+-------------------------------
+
+BWIPP/bwip-js was used only as a local, independent black-box oracle to compare
+rendered PZN-7 and PZN-8 symbols. Its source, tables and runtime are not copied
+into or shipped by this SDK, and it is not a runtime dependency. The comparison
+is an engineering check, not a legal opinion or a conformance certificate.
+
+
+CONCLUSION
+----------
+
+The original Sythos PZN implementation is MIT-licensed. If a rights holder or
+user identifies a conflicting notice about the available material, please open
+a GitHub issue with the reference so it can be reviewed and recorded.

package/licenses/telepen.license

@@ -0,0 +1,73 @@
+Telepen — format provenance and usability
+==========================================
+
+This file records the engineering provenance and redistribution boundary for
+the Telepen Alpha and Telepen Numeric implementation shipped by Sythos Barcode
+Universal.
+
+It is an ENGINEERING INVENTORY, NOT LEGAL ADVICE. Patent, copyright and
+trademark conclusions require independent review for the jurisdiction and use
+case involved. Items marked [TO VERIFY] have not been independently confirmed.
+
+
+ORIGIN AND SPECIFICATION
+------------------------
+
+Telepen is a linear symbology associated with SB Electronic Systems Ltd. The
+publicly described Alpha form carries seven-bit ASCII with an even parity bit;
+the Numeric form compacts digit pairs and uses the same start, check and stop
+grammar. No ISO/IEC standard text is reproduced or redistributed here.
+[LEGAL REVIEW]
+
+
+PATENT STATUS
+-------------
+
+Historical Telepen patent families and any jurisdiction-specific licensing
+declarations require a current patent search. This project makes no unconditional
+patent-free or public-domain claim. [TO VERIFY]
+
+
+TRADEMARK STATUS
+----------------
+
+The current ownership and registration status of the Telepen name have not
+been independently searched. The name is used descriptively to identify the
+symbology and does not imply certification, sponsorship or endorsement by SB
+Electronic Systems Ltd or any standards or mark owner. [TO VERIFY]
+
+
+IMPLEMENTATION BASIS IN THIS PROJECT
+------------------------------------
+
+Telepen is implemented as original Sythos TypeScript with generated JavaScript
+runtime files. The glyph mapping is generated algorithmically from the
+published seven-bit/parity and narrow/wide rules rather than copied as a
+third-party table. The writer enforces ASCII bounds, Numeric pair grammar,
+payload length, modulo-127 check value and complete start/stop structure. The
+reader uses scale-independent run matching, checksum validation and ambiguity
+rejection; Numeric decoding is explicit so digit-pair glyphs are never guessed
+as arbitrary ASCII control characters.
+
+Independent implementations and public technical material were used only for
+engineering review and black-box interoperability checks. In particular,
+ZXing-C++ and BWIPP/bwip-js were invoked as external tools; no third-party
+source code, lookup table or binary asset is copied into or shipped by this
+project, and neither tool is a runtime dependency.
+
+
+CONCLUSION
+----------
+
+The original Sythos Telepen implementation is distributed under the MIT
+License. This engineering note is not a conformance certificate, patent
+clearance or legal opinion. If a rights holder or user identifies a conflicting
+notice about the available materials, please open a GitHub issue with the
+relevant reference so it can be reviewed and recorded.
+
+References consulted:
+
+- [Telepen overview](https://barcode.ro/tutorials/barcodes/telepen.html)
+- [Telepen symbology notes](https://barcodeguide.seagullscientific.com/Content/Symbologies/Telepen.htm)
+- [BWIPP Telepen implementation](https://github.com/bwipp/postscriptbarcode)
+- Independent black-box validation recorded in `NOTICE.md`

package/llms.txt

@@ -8,13 +8,20 @@
 - Project: Sythos Barcode Universal
 - Publisher and original author: Sythos — https://www.sythos.net
 - npm package: `@sythos/js_barcode_universal`
-- Current repository release: `1.5.13`
+- Current repository release: `1.5.15`
 - License: MIT; copyright and attribution: Sythos
 - Runtime dependencies: none
 - Development tooling: TypeScript is a development-only dependency
 - Repository: https://github.com/Sythos/JS_Barcode_Universal
 - npm: https://www.npmjs.com/package/@sythos/js_barcode_universal
-- Documentation: https://github.com/Sythos/JS_Barcode_Universal#readme
+- Documentation: https://sythos.github.io/JS_Barcode_Universal/
+- Documentation source: https://github.com/Sythos/JS_Barcode_Universal/tree/main/docs
+- API reference: https://sythos.github.io/JS_Barcode_Universal/api/overview/
+- Format catalogue: https://sythos.github.io/JS_Barcode_Universal/formats/overview/
+- Recipes: https://sythos.github.io/JS_Barcode_Universal/examples/create-barcode/
+- FAQ: https://sythos.github.io/JS_Barcode_Universal/faq/
+- Troubleshooting: https://sythos.github.io/JS_Barcode_Universal/troubleshooting/
+- Compact project overview: https://github.com/Sythos/JS_Barcode_Universal#readme
 - Issue tracker: https://github.com/Sythos/JS_Barcode_Universal/issues
 
 ## What this SDK does
@@ -37,6 +44,9 @@ packages.
 
 The public `listFormats()` API reports writing and reading separately. A format
 marked `write-only` is intentionally not treated as a generic image reader.
+At the current checkout it reports 50 writable entries and 49 readable entries;
+Pharmacode is the sole intentionally write-only entry, while EAN-2 and EAN-5
+remain parent-bound supplements.
 
 ### 1D linear formats
 
@@ -49,11 +59,24 @@ marked `write-only` is intentionally not treated as a generic image reader.
 - Code 93 — write and read
 - ITF (Interleaved 2 of 5) — write and read
 - ITF-14 — write and read through the ITF family
+- Code 25 / Standard 2 of 5 — write and read as `standard2of5` or `code2of5`
+- Industrial 2 of 5 — write and read with the canonical Industrial frame
+- IATA 2 of 5 — write and read with the shorter IATA guard frame
 - Codabar — write and read
 - Code 11 — write and scanline/image read
 - MSI Plessey — write and read, with optional check-digit validation
+- Code 32 (Italian Pharmacode) — write and read with validated pharmaceutical check digit
+- PZN-7 and PZN-8 — write and read; the decoder exposes `pznVariant`
+- Telepen — write and read in full seven-bit ASCII mode; explicit Telepen Numeric
+  mode handles digit pairs and `X` suffix pairs
 - Pharmacode — write-only in the generic image pipeline
-- GS1 DataBar Omnidirectional and Truncated — write and read through the verified physical layer
+- GS1 DataBar Omnidirectional, Truncated, Limited, Stacked, Stacked Omnidirectional and Expanded — write and read through verified physical layers
+- USPS POSTNET and PLANET — write and read with operator-specific Mod-10 checks
+- Royal Mail 4-State Customer Code (RM4SCC) — write and read with a generated and verified check character
+- KIX — write and read with the Dutch four-state alphabet and no check character
+- Australia Post 4-State — write and read with FCC/DPID, GF(64) parity and explicit character or numeric customer data
+- Japan Post 4-State — write and read with grouped public payloads, padding and Mod-19 validation
+- USPS Intelligent Mail Barcode (IMb / OneCode) — write and read for 20-, 25-, 29- and 31-digit payloads with frame-check validation
 - EAN-2 and EAN-5 supplements — write and parent-bound read only; they require a validated EAN/UPC parent
 
 ### 2D matrix and stacked formats
@@ -68,10 +91,32 @@ marked `write-only` is intentionally not treated as a generic image reader.
 - Micro QR Code — write and read for the supported M1–M4 family; M1 is detection-only
 - rMQR Code — write and read for the supported standard rectangular geometries
 - Sythos Canvas QR profile — write and read as the non-certified `sythos-canvas-qr/1` profile
+- MaxiCode — write and read for fixed 30×33 symbols, Modes 2–5 and ISO-8859-1 Code Sets A–E
+- Codablock-F — write and read for stacked Code 128 rows with row and overall checks; clean integer-scale detection
+- Code 16K — write and read for compact stacked Code 128 A/B/C rows, optional GS1 modes, dual modulo-107 checks and clean integer-scale detection
+- DotCode — write and read for the bounded alternating-dot profile, four masks, GF(113) correction and clean integer-scale detection
+- Han Xin Code — write and read for compact alignment-free versions 1–3, numeric/text/byte modes, four masks, GF(256) correction and clean integer-scale detection
+- GS1 DataBar Composite — write and read for the bounded Sythos profile linking one validated DataBar host to a strict MicroPDF417-derived CC-A or CC-B component; complete ISO/IEC 24723 certification is not claimed
 
 The Sythos Canvas QR profile is not DENSO FrameQR® compatible and does not
 claim native DENSO interoperability.
 
+Code 25-family aliases (`standard2of5`, `code2of5`, `industrial2of5` and
+`iata2of5`) are explicit format selectors. Code 32 and PZN readers validate
+their complete carrier and check digit before returning a result; incomplete
+or ambiguous camera frames return nothing.
+
+Postal aliases (`usps-postnet`, `usps-planet`, `royalmail`, `royal-mail`,
+`australia-post`, `australiapost`, `japan-post`, `onecode` and `usps-onecode`)
+resolve to the canonical ids `postnet`, `planet`, `rm4scc`, `auspost`,
+`japanpost` and `imb`. Australia Post accepts `customerEncoding: 'character'`
+or `'numeric'` (and the compatibility alias `custinfoenc`). Postal camera
+reads require a measurable quiet zone and a complete validated symbol.
+Han Xin root dispatch accepts both `hanxin` and `han-xin`; its focused
+subpath is `@sythos/js_barcode_universal/hanxin`.
+GS1 Composite root dispatch accepts `gs1composite`, `gs1-composite` and
+`composite`; its focused subpath is `@sythos/js_barcode_universal/composite`.
+
 ## Main API
 
 The package root exports `encode`, `decode`, `decodeStrict`, `listFormats`,
@@ -90,6 +135,8 @@ subpaths are available for smaller imports, including:
 - `@sythos/js_barcode_universal/rmqr`
 - `@sythos/js_barcode_universal/frameqr`
 - `@sythos/js_barcode_universal/databar`
+- `@sythos/js_barcode_universal/hanxin`
+- `@sythos/js_barcode_universal/composite`
 - `@sythos/js_barcode_universal/render`
 
 Typical usage:
@@ -115,9 +162,7 @@ limitations are documented in `README.md` and `PLAN.md`.
 ## Deliberate scope boundaries
 
 - Data Matrix Rectangular Extension (DMRE) is not included.
-- GS1 DataBar Limited, Stacked, Stacked Omnidirectional and Expanded physical
-  layouts remain outside the current release.
-- MaxiCode is not implemented.
+- GS1 DataBar Expanded Stacked remains outside the current release; the linear Expanded variant is supported.
 - Micro QR ECI, FNC1/GS1 and Structured Append are outside the current API scope.
 - SQRC and Face Authentication SQRC are DENSO-licensed formats and are not
   included in this MIT SDK. A user must obtain the appropriate DENSO licence
@@ -140,6 +185,15 @@ the files under `licenses/`, including:
 
 - `licenses/pdf417.license`
 - `licenses/micropdf417.license`
+- `licenses/maxicode.license`
+- `licenses/gs1-databar.license`
+- `licenses/code25.license`
+- `licenses/code32.license`
+- `licenses/pzn.license`
+- `licenses/postal.license`
+- `licenses/dotcode.license`
+- `licenses/hanxin.license`
+- `licenses/gs1-composite.license`
 
 Those files are engineering inventories, not legal advice. Patent, copyright,
 trademark, standards and jurisdictional questions should receive independent
@@ -148,6 +202,8 @@ professional review where required.
 ## Canonical project files
 
 - Human documentation: `README.md`
+- Published documentation: https://sythos.github.io/JS_Barcode_Universal/
+- Documentation source tree: `docs/`
 - Roadmap and implementation boundaries: `PLAN.md`
 - MIT terms: `LICENSE`
 - Attribution and provenance: `NOTICE.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sythos/js_barcode_universal",
-  "version": "1.5.13",
+  "version": "1.5.15",
   "description": "Open-source MIT-licensed JavaScript/TypeScript barcode generator and barcode reader SDK with zero runtime dependencies for 1D and 2D barcodes in browsers, Web Workers and Node.js: QR, Data Matrix, Aztec, PDF417, GS1, EAN and more.",
   "author": {
     "name": "Sythos",
@@ -50,6 +50,30 @@
       "import": "./src/js/databar/index.js",
       "types": "./src/ts/databar/index.d.ts"
     },
+    "./maxicode": {
+      "import": "./src/js/maxicode/index.js",
+      "types": "./src/ts/maxicode/index.d.ts"
+    },
+    "./codablockf": {
+      "import": "./src/js/codablockf/index.js",
+      "types": "./src/ts/codablockf/index.d.ts"
+    },
+    "./code16k": {
+      "import": "./src/js/code16k/index.js",
+      "types": "./src/ts/code16k/index.d.ts"
+    },
+    "./dotcode": {
+      "import": "./src/js/dotcode/index.js",
+      "types": "./src/ts/dotcode/index.d.ts"
+    },
+    "./hanxin": {
+      "import": "./src/js/hanxin/index.js",
+      "types": "./src/ts/hanxin/index.d.ts"
+    },
+    "./composite": {
+      "import": "./src/js/composite/index.js",
+      "types": "./src/ts/composite/index.d.ts"
+    },
     "./aztec": {
       "import": "./src/js/aztec/index.js",
       "types": "./src/ts/aztec/index.d.ts"
@@ -171,8 +195,20 @@
     "code93",
     "itf",
     "itf14",
+    "code-25",
+    "code2of5",
+    "standard-2-of-5",
+    "industrial-2-of-5",
+    "iata-2-of-5",
     "codabar",
     "msi",
+    "code32",
+    "italian-pharmacode",
+    "pzn",
+    "pzn7",
+    "pzn8",
+    "telepen",
+    "telepen-numeric",
     "code11",
     "pharmacode",
     "scanner",
@@ -198,13 +234,21 @@
   "bugs": {
     "url": "https://github.com/Sythos/JS_Barcode_Universal/issues"
   },
-  "homepage": "https://github.com/Sythos/JS_Barcode_Universal#readme",
+  "homepage": "https://sythos.github.io/JS_Barcode_Universal/",
   "scripts": {
     "build:ts": "node tools/compile-typescript.mjs",
-    "types": "tsc -p tsconfig.json",
+    "lint": "eslint --max-warnings=0 src/index.js src/js tools .github/ci",
+    "test:docs": "node --test tools/exact-url.test.mjs",
+    "test:foundations": "node --test test/foundation.test.js",
+    "test:formats": "node --test test/maxicode.test.js test/databar-stacked.test.js test/databar-stacked-omnidirectional.test.js test/databar-limited.test.js test/databar-expanded.test.js test/telepen.test.js test/code25-code32.test.js test/postal.test.js test/codablockf.test.js test/code16k.test.js test/dotcode.test.js test/hanxin.test.js test/gs1-composite.test.js",
+    "test:fuzz": "node --test test/fuzz/property.test.js",
+    "types": "node node_modules/typescript/bin/tsc -p tsconfig.json",
     "types:api": "node tools/check-public-types.mjs"
   },
   "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "eslint": "10.9.1",
+    "fast-check": "4.9.0",
     "typescript": "7.0.2"
   }
 }

package/src/index.d.ts

@@ -45,6 +45,7 @@
  * @module @sythos/js_barcode_universal
  */
 import { BitMatrix } from './ts/core/bit-matrix.js';
+import type { GS1CompositeComponent, GS1CompositeInput } from './ts/composite/index.js';
 export { BitMatrix };
 export { BarcodeError, EncodeError, NotFoundError, FormatError, ChecksumError, } from './ts/core/errors.js';
 export { LuminanceSource } from './ts/image/luminance.js';
@@ -62,10 +63,46 @@ export * from './ts/aztecrune/index.js';
 export { encodePDF417, decodePDF417, detectPDF417, detectAndDecodePDF417 } from './ts/pdf417/index.js';
 export * from './ts/compactpdf417/index.js';
 export * from './ts/databar/index.js';
+export {
+    encodeMaxiCode,
+    decodeMaxiCode,
+    detectMaxiCode,
+    detectAndDecodeMaxiCode,
+} from './ts/maxicode/index.js';
+export {
+    encodeCodablockF,
+    decodeCodablockF,
+    detectCodablockF,
+    detectAndDecodeCodablockF,
+} from './ts/codablockf/index.js';
+export {
+    encodeCode16K,
+    decodeCode16K,
+    detectCode16K,
+    detectAndDecodeCode16K,
+} from './ts/code16k/index.js';
+export * from './ts/dotcode/index.js';
+export * from './ts/hanxin/index.js';
 export { encodeMicroPDF417, decodeMicroPDF417, detectMicroPDF417, detectAndDecodeMicroPDF417, } from './ts/micropdf417/index.js';
 export { encodeMicroQR, decodeMicroQR, detectMicroQR, detectAndDecodeMicroQR } from './ts/microqr/index.js';
 export { encodeRMQR, decodeRMQR, detectRMQR, detectAndDecodeRMQR } from './ts/rmqr/index.js';
 export { encodeFrameQR, decodeFrameQR, detectFrameQR, detectAndDecodeFrameQR, } from './ts/frameqr/index.js';
+export {
+    GS1_COMPOSITE_PROFILE,
+    GS1_COMPOSITE_HOSTS,
+    encodeGS1Composite,
+    decodeGS1Composite,
+    detectGS1Composite,
+    detectAndDecodeGS1Composite,
+} from './ts/composite/index.js';
+export type {
+    GS1CompositeHostFormat,
+    GS1CompositeComponent,
+    GS1Element,
+    GS1CompositeInput,
+    GS1CompositeOptions,
+    GS1CompositeResult,
+} from './ts/composite/index.js';
 export type FormatInfo = {
     id: string;
     label: string;
@@ -93,14 +130,21 @@ export declare function listFormats(): FormatInfo[];
  * output medium. Linear symbols come back one module tall; height is a
  * rendering decision, not an encoding one.
  *
- * @param {string | number} text
+ * @param {string | number | GS1CompositeInput} text
  * @param {object} [options]
  * @param {string} [options.format] Format id. Default 'qr'.
- * @param {'L'|'M'|'Q'|'H'} [options.ecc] QR error-correction level.
- * @param {number} [options.version] QR version, 1-40. Auto if omitted.
+ * @param {'L'|'M'|'Q'|'H'|'L1'|'L2'|'L3'|'L4'|1|2|3|4} [options.ecc] QR or Han Xin error-correction level.
+ * @param {number} [options.version] QR version 1-40 or Han Xin version 1-3. Auto if omitted.
  * @param {boolean} [options.checkDigit] Append a check digit, where optional.
+ * @param {'character'|'numeric'} [options.customerEncoding] Australia Post customer-data encoding.
+ * @param {'character'|'numeric'} [options.custinfoenc] Australia Post compatibility alias.
+ * @param {boolean} [options.pzn8] Select the eight-digit PZN profile.
+ * @param {'pzn7'|'pzn8'|'standard'|'industrial'|'iata'} [options.variant] PZN or Code 25 variant.
+ * @param {number} [options.wideRatio] Wide-bar ratio for Code 25 variants.
  * @param {boolean} [options.fullAscii] Code 39 extended encoding.
  * @param {boolean} [options.gs1] Emit a leading FNC1.
+ * @param {GS1CompositeComponent} [options.component] Bounded GS1 Composite component selection.
+ * @param {1|2|3} [options.separatorGap] Composite separator rows.
  * @param {number} [options.layers] Aztec layer count; automatic if omitted.
  * @param {boolean} [options.compact] Force an Aztec Compact or Full symbol.
  * @param {number} [options.eccPercent] Requested Aztec error-correction percentage.
@@ -111,6 +155,8 @@ export declare function listFormats(): FormatInfo[];
  * @param {'auto'|'text'|'byte'|'numeric'} [options.compaction] PDF417 compaction mode.
  * @param {number} [options.eci] MicroPDF417 byte-compaction ECI assignment (3 or 26).
  * @param {number} [options.aspectRatio] Preferred MicroPDF417 symbol aspect ratio.
+ * @param {0|1|2|3} [options.mask] Han Xin data mask.
+ * @param {2|3|4|5|'auto'|'numeric'|'text'|'byte'} [options.mode] MaxiCode mode or Han Xin payload mode.
  * @param {object} [options.canvas] FrameQR Code artwork reservation.
  * @param {'square'|'circle'|'diamond'} [options.canvas.shape] Canvas shape.
  * @param {number} [options.canvas.size] Odd canvas size in QR modules.
@@ -121,11 +167,18 @@ export declare function listFormats(): FormatInfo[];
  * @param {0|90|180|270} [options.canvas.angle] Canvas quarter-turn.
  * @returns {BitMatrix}
  */
-export declare function encode(text: string | number, options?: {
+export declare function encode(text: string | number | GS1CompositeInput, options?: {
     format?: string;
-    ecc?: 'L' | 'M' | 'Q' | 'H';
+    ecc?: 'L' | 'M' | 'Q' | 'H' | 'L1' | 'L2' | 'L3' | 'L4' | 1 | 2 | 3 | 4;
     version?: number;
     checkDigit?: boolean;
+    customerEncoding?: 'character' | 'numeric';
+    custinfoenc?: 'character' | 'numeric';
+    pzn8?: boolean;
+    variant?: 'pzn7' | 'pzn8' | 'standard' | 'industrial' | 'iata';
+    wideRatio?: number;
+    telepenMode?: 'ascii' | 'numeric';
+    numeric?: boolean;
     fullAscii?: boolean;
     gs1?: boolean;
     layers?: number;
@@ -138,6 +191,20 @@ export declare function encode(text: string | number, options?: {
     compaction?: 'auto' | 'text' | 'byte' | 'numeric';
     eci?: number;
     aspectRatio?: number;
+    mode?: 2 | 3 | 4 | 5 | 'auto' | 'numeric' | 'text' | 'byte';
+    mask?: 0 | 1 | 2 | 3;
+    primary?: {
+        postalCode: string;
+        countryCode: number;
+        serviceClass: number;
+    };
+    charset?: 'latin1';
+    linkage?: boolean;
+    moduleScale?: number;
+    scale?: number;
+    height?: number;
+    component?: GS1CompositeComponent;
+    separatorGap?: 1 | 2 | 3;
     canvas?: {
         shape?: 'square' | 'circle' | 'diamond';
         size?: number;
@@ -203,6 +270,10 @@ export type DecodeResult = {
      * PDF417 row height in modules.
      */
     rowHeight?: number;
+    /** Detected integer module scale for stacked formats. */
+    moduleSize?: number;
+    /** Whether stacked-format row and overall checks passed. */
+    checksum?: boolean;
     /**
      * MicroPDF417 predefined variant number.
      */
@@ -286,6 +357,32 @@ export type DecodeResult = {
      * GS1 DataBar linkage flag.
      */
     linkage?: boolean;
+    /** Whether an optional numeric check digit was validated. */
+    checkDigit?: boolean;
+    /** PZN variant identified by the decoder. */
+    pznVariant?: 'pzn7' | 'pzn8';
+    /** Whether the bounded GS1 Composite component is CC-A or CC-B. */
+    component?: 'cc-a' | 'cc-b';
+    /** Selected MicroPDF417-derived composite component variant. */
+    componentVariant?: number;
+    componentRows?: number;
+    componentColumns?: number;
+    componentRowHeight?: number;
+    separatorGap?: number;
+    linearFormat?: string;
+    linear?: Record<string, unknown>;
+    /** MaxiCode mode or Han Xin payload mode. */
+    mode?: 2 | 3 | 4 | 5 | 'numeric' | 'text' | 'byte';
+    /** Han Xin data mask. */
+    mask?: 0 | 1 | 2 | 3;
+    /** Han Xin module polarity. */
+    inverted?: boolean;
+    /** MaxiCode structured primary message for modes 2 and 3. */
+    primary?: {
+        postalCode: string;
+        countryCode: number;
+        serviceClass: number;
+    };
 };
 /**
  * @typedef {object} DecodeResult
@@ -318,6 +415,10 @@ export type DecodeResult = {
  * @property {string} [gs1ParseError] Semantic GS1 parsing error after a valid physical read.
  * @property {string} [gtin] GS1 DataBar GTIN-14 payload.
  * @property {boolean} [linkage] GS1 DataBar linkage flag.
+ * @property {boolean} [checkDigit] Whether an optional numeric check digit was validated.
+ * @property {'pzn7'|'pzn8'} [pznVariant] PZN variant identified by the decoder.
+ * @property {0|1|2|3} [mask] Han Xin data mask.
+ * @property {boolean} [inverted] Han Xin module polarity.
  */
 /**
  * Find and decode every barcode in an image.
@@ -334,6 +435,8 @@ export type DecodeResult = {
  * @param {'camera'} [options.profile] Opt-in strict camera profile for validated 1D reads.
  * @param {object} [options.frameqr] FrameQR Code detector options when
  *   the profile marker is not preserved through image rendering.
+ * @param {'character'|'numeric'} [options.customerEncoding] Australia Post customer-data encoding.
+ * @param {'character'|'numeric'} [options.custinfoenc] Australia Post compatibility alias.
  * @returns {DecodeResult[]}
  */
 export declare function decode(image: {
@@ -346,6 +449,8 @@ export declare function decode(image: {
     binarizer?: 'global' | 'hybrid' | 'auto';
     profile?: 'camera';
     frameqr?: object;
+    customerEncoding?: 'character' | 'numeric';
+    custinfoenc?: 'character' | 'numeric';
 }): DecodeResult[];
 /**
  * Decode, or throw if nothing is found.
@@ -360,4 +465,4 @@ export declare function decodeStrict(image: {
     height: number;
 }, options?: object): DecodeResult;
 /** Library version, matching package.json. */
-export declare const VERSION = "1.5.13";
+export declare const VERSION = "1.5.15";