@sythos/js_barcode_universal 1.5.13 → 1.5.15

package/src/ts/index.d.ts

@@ -45,6 +45,7 @@
  * @module @sythos/js_barcode_universal
  */
 import { BitMatrix } from './core/bit-matrix.js';
+import type { GS1CompositeComponent, GS1CompositeInput } from './composite/index.js';
 export { BitMatrix };
 export { BarcodeError, EncodeError, NotFoundError, FormatError, ChecksumError, } from './core/errors.js';
 export { LuminanceSource } from './image/luminance.js';
@@ -66,6 +67,22 @@ export { encodeMicroPDF417, decodeMicroPDF417, detectMicroPDF417, detectAndDecod
 export { encodeMicroQR, decodeMicroQR, detectMicroQR, detectAndDecodeMicroQR } from './microqr/index.js';
 export { encodeRMQR, decodeRMQR, detectRMQR, detectAndDecodeRMQR } from './rmqr/index.js';
 export { encodeFrameQR, decodeFrameQR, detectFrameQR, detectAndDecodeFrameQR, } from './frameqr/index.js';
+export {
+  GS1_COMPOSITE_PROFILE,
+  GS1_COMPOSITE_HOSTS,
+  encodeGS1Composite,
+  decodeGS1Composite,
+  detectGS1Composite,
+  detectAndDecodeGS1Composite,
+} from './composite/index.js';
+export type {
+  GS1CompositeHostFormat,
+  GS1CompositeComponent,
+  GS1Element,
+  GS1CompositeInput,
+  GS1CompositeOptions,
+  GS1CompositeResult,
+} from './composite/index.js';
 export type FormatInfo = {
     id: string;
     label: string;
@@ -99,6 +116,9 @@ export declare function listFormats(): FormatInfo[];
  * @param {'L'|'M'|'Q'|'H'} [options.ecc] QR error-correction level.
  * @param {number} [options.version] QR version, 1-40. Auto if omitted.
  * @param {boolean} [options.checkDigit] Append a check digit, where optional.
+ * @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 {number} [options.layers] Aztec layer count; automatic if omitted.
@@ -121,11 +141,16 @@ 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';
     version?: number;
     checkDigit?: boolean;
+    pzn8?: boolean;
+    variant?: 'pzn7' | 'pzn8' | 'standard' | 'industrial' | 'iata';
+    wideRatio?: number;
+    telepenMode?: 'ascii' | 'numeric';
+    numeric?: boolean;
     fullAscii?: boolean;
     gs1?: boolean;
     layers?: number;
@@ -147,6 +172,9 @@ export declare function encode(text: string | number, options?: {
         centerY?: number;
         angle?: 0 | 90 | 180 | 270;
     };
+    component?: GS1CompositeComponent;
+    separatorGap?: 1 | 2 | 3;
+    moduleScale?: number;
 }): BitMatrix;
 export type DecodeResult = {
     text: string;
@@ -286,6 +314,20 @@ 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 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>;
 };
 /**
  * @typedef {object} DecodeResult
@@ -318,6 +360,8 @@ 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.
  */
 /**
  * Find and decode every barcode in an image.
@@ -360,4 +404,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";

package/src/ts/index.ts

@@ -50,8 +50,23 @@ import { BitMatrix } from './core/bit-matrix.js';
 import { EncodeError, NotFoundError } from './core/errors.js';
 import { LuminanceSource } from './image/luminance.js';
 import { binarize } from './image/binarizer.js';
-import { ONED_FORMATS } from './oned/index.js';
+import {
+  ONED_FORMATS,
+  encodeCode32,
+  encodePZN,
+  encodeStandard2of5,
+  encodeIndustrial2of5,
+  encodeIATA2of5,
+  encodePostnet,
+  encodePlanet,
+  encodeRM4SCC,
+  encodeKIX,
+  encodeAustraliaPost,
+  encodeJapanPost,
+  encodeIMB,
+} from './oned/index.js';
 import { decodeOneD } from './oned/reader.js';
+import { encodeTelepen, encodeTelepenNumeric } from './oned/telepen.js';
 import * as datamatrix from './datamatrix/index.js';
 import * as qr from './qr/index.js';
 import * as aztec from './aztec/index.js';
@@ -63,6 +78,12 @@ import * as frameqr from './frameqr/index.js';
 import * as aztecRune from './aztecrune/index.js';
 import * as compactPdf417 from './compactpdf417/index.js';
 import * as databar from './databar/index.js';
+import * as maxicode from './maxicode/index.js';
+import * as codablockf from './codablockf/index.js';
+import * as code16k from './code16k/index.js';
+import * as dotcode from './dotcode/index.js';
+import * as hanxin from './hanxin/index.js';
+import * as composite from './composite/index.js';
 
 export { BitMatrix };
 export {
@@ -84,9 +105,31 @@ export { encodeAztec, decodeAztec, detectAztec, detectAndDecodeAztec } from './a
 export * from './aztecrune/index.js';
 export { encodePDF417, decodePDF417, detectPDF417, detectAndDecodePDF417 } from './pdf417/index.js';
 export * from './compactpdf417/index.js';
-  // DataBar exports include both the verified GTIN/data layer and the
-  // Omnidirectional/Truncated physical image path.
+  // DataBar exports include the verified GTIN/data layer and the supported
+  // Omnidirectional/Truncated, Limited, Stacked and Stacked Omnidirectional paths.
 export * from './databar/index.js';
+export {
+  encodeMaxiCode,
+  decodeMaxiCode,
+  detectMaxiCode,
+  detectAndDecodeMaxiCode,
+} from './maxicode/index.js';
+export {
+  encodeCodablockF, decodeCodablockF, detectCodablockF, detectAndDecodeCodablockF,
+} from './codablockf/index.js';
+export {
+  encodeCode16K, decodeCode16K, detectCode16K, detectAndDecodeCode16K,
+} from './code16k/index.js';
+export * from './dotcode/index.js';
+export * from './hanxin/index.js';
+export {
+  GS1_COMPOSITE_PROFILE,
+  GS1_COMPOSITE_HOSTS,
+  encodeGS1Composite,
+  decodeGS1Composite,
+  detectGS1Composite,
+  detectAndDecodeGS1Composite,
+} from './composite/index.js';
 export {
   encodeMicroPDF417, decodeMicroPDF417, detectMicroPDF417, detectAndDecodeMicroPDF417,
 } from './micropdf417/index.js';
@@ -143,6 +186,26 @@ const compactPdf417CanEncode = typeof compactPdf417.encodeCompactPDF417 === 'fun
 const compactPdf417CanDecode = typeof compactPdf417.detectAndDecodeCompactPDF417 === 'function';
 const dataBarCanEncode = typeof databar.encodeDataBar14 === 'function';
 const dataBarCanDecode = typeof databar.decodeDataBar14Scanline === 'function';
+const dataBarStackedCanEncode = typeof databar.encodeDataBar14Stacked === 'function';
+const dataBarStackedCanDecode = typeof databar.detectAndDecodeDataBar14Stacked === 'function';
+const dataBarStackedOmniCanEncode = typeof databar.encodeDataBarStackedOmnidirectional === 'function';
+const dataBarStackedOmniCanDecode = typeof databar.detectAndDecodeDataBarStackedOmnidirectional === 'function';
+const dataBarLimitedCanEncode = typeof databar.encodeDataBarLimited === 'function';
+const dataBarLimitedCanDecode = typeof databar.detectAndDecodeDataBarLimited === 'function';
+const dataBarExpandedCanEncode = typeof databar.encodeDataBarExpanded === 'function';
+const dataBarExpandedCanDecode = typeof databar.detectAndDecodeDataBarExpanded === 'function';
+const maxicodeCanEncode = typeof maxicode.encodeMaxiCode === 'function';
+const maxicodeCanDecode = typeof maxicode.detectAndDecodeMaxiCode === 'function';
+const codablockfCanEncode = typeof codablockf.encodeCodablockF === 'function';
+const codablockfCanDecode = typeof codablockf.detectAndDecodeCodablockF === 'function';
+const code16kCanEncode = typeof code16k.encodeCode16K === 'function';
+const code16kCanDecode = typeof code16k.detectAndDecodeCode16K === 'function';
+const dotCodeCanEncode = typeof dotcode.encodeDotCode === 'function';
+const dotCodeCanDecode = typeof dotcode.detectAndDecodeDotCode === 'function';
+const hanXinCanEncode = typeof hanxin.encodeHanXin === 'function';
+const hanXinCanDecode = typeof hanxin.detectAndDecodeHanXin === 'function';
+const gs1CompositeCanEncode = typeof composite.encodeGS1Composite === 'function';
+const gs1CompositeCanDecode = typeof composite.detectAndDecodeGS1Composite === 'function';
 
 /**
  * Every format this build supports.
@@ -241,6 +304,76 @@ export function listFormats() {
     canRead: dataBarCanDecode,
     kind: /** @type {'1D'} */ ('1D'),
   });
+  formats.push({
+    id: 'gs1databar-stacked',
+    label: 'GS1 DataBar Stacked',
+    canWrite: dataBarStackedCanEncode,
+    canRead: dataBarStackedCanDecode,
+    kind: /** @type {'1D'} */ ('1D'),
+  });
+  formats.push({
+    id: 'gs1databar-stacked-omnidirectional',
+    label: 'GS1 DataBar Stacked Omnidirectional',
+    canWrite: dataBarStackedOmniCanEncode,
+    canRead: dataBarStackedOmniCanDecode,
+    kind: /** @type {'1D'} */ ('1D'),
+  });
+  formats.push({
+    id: 'gs1databar-limited',
+    label: 'GS1 DataBar Limited',
+    canWrite: dataBarLimitedCanEncode,
+    canRead: dataBarLimitedCanDecode,
+    kind: /** @type {'1D'} */ ('1D'),
+  });
+  formats.push({
+    id: 'gs1databar-expanded',
+    label: 'GS1 DataBar Expanded',
+    canWrite: dataBarExpandedCanEncode,
+    canRead: dataBarExpandedCanDecode,
+    kind: /** @type {'1D'} */ ('1D'),
+  });
+  formats.push({
+    id: 'maxicode',
+    label: 'MaxiCode',
+    canWrite: maxicodeCanEncode,
+    canRead: maxicodeCanDecode,
+    kind: /** @type {'2D'} */ ('2D'),
+  });
+  formats.push({
+    id: 'codablockf',
+    label: 'Codablock-F',
+    canWrite: codablockfCanEncode,
+    canRead: codablockfCanDecode,
+    kind: /** @type {'2D'} */ ('2D'),
+  });
+  formats.push({
+    id: 'code16k',
+    label: 'Code 16K',
+    canWrite: code16kCanEncode,
+    canRead: code16kCanDecode,
+    kind: /** @type {'2D'} */ ('2D'),
+  });
+  formats.push({
+    id: 'dotcode',
+    label: 'DotCode',
+    canWrite: dotCodeCanEncode,
+    canRead: dotCodeCanDecode,
+    kind: /** @type {'2D'} */ ('2D'),
+  });
+  formats.push({
+    id: 'hanxin',
+    label: 'Han Xin Code',
+    canWrite: hanXinCanEncode,
+    canRead: hanXinCanDecode,
+    kind: /** @type {'2D'} */ ('2D'),
+  });
+  formats.push({
+    id: 'gs1composite',
+    label: 'GS1 DataBar Composite (bounded profile)',
+    canWrite: gs1CompositeCanEncode,
+    canRead: gs1CompositeCanDecode,
+    kind: /** @type {'2D'} */ ('2D'),
+  });
 
   return formats;
 }
@@ -256,9 +389,11 @@ export function listFormats() {
  * @param {string | number} 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 {'ascii'|'numeric'} [options.telepenMode] Telepen encoding mode.
+ * @param {boolean} [options.numeric] Alias for Telepen Numeric mode.
  * @param {boolean} [options.fullAscii] Code 39 extended encoding.
  * @param {boolean} [options.gs1] Emit a leading FNC1.
  * @param {number} [options.layers] Aztec layer count; automatic if omitted.
@@ -271,6 +406,16 @@ export function listFormats() {
  * @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 {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 {2|3|4|5|'auto'|'numeric'|'text'|'byte'} [options.mode] MaxiCode mode or Han Xin payload mode.
+ * @param {{postalCode:string,countryCode:number,serviceClass:number}} [options.primary] MaxiCode structured primary data for modes 2 and 3.
+ * @param {'latin1'} [options.charset] MaxiCode character set declaration.
+ * @param {boolean} [options.linkage] GS1 DataBar composite linkage flag.
+ * @param {number} [options.moduleScale] Integer module scale for GS1 DataBar physical variants.
+ * @param {number} [options.height] Output height for a GS1 DataBar physical variant.
  * @param {object} [options.canvas] Sythos Canvas QR artwork reservation.
  * @param {'square'|'circle'|'diamond'} [options.canvas.shape] Canvas shape.
  * @param {number} [options.canvas.size] Odd canvas size in QR modules.
@@ -318,10 +463,94 @@ export function encode(text, options = {}) {
   if (format === 'gs1databar14' || format === 'gs1-databar14' || format === 'databar') {
     return databar.encodeDataBar14(value, options);
   }
+  if (format === 'gs1databar-stacked' || format === 'gs1-databar-stacked' || format === 'databar-stacked') {
+    return databar.encodeDataBar14Stacked(value, options);
+  }
+  if (format === 'gs1databar-stacked-omnidirectional'
+    || format === 'gs1-databar-stacked-omnidirectional'
+    || format === 'databar-stacked-omni') {
+    return databar.encodeDataBarStackedOmnidirectional(value, options);
+  }
+  if (format === 'gs1databar-limited' || format === 'gs1-databar-limited' || format === 'databar-limited') {
+    return databar.encodeDataBarLimited(value, options);
+  }
+  if (format === 'gs1databar-expanded' || format === 'gs1-databar-expanded' || format === 'databar-expanded') {
+    return databar.encodeDataBarExpanded(value, options);
+  }
+  if (format === 'maxicode' || format === 'maxi-code') {
+    return maxicode.encodeMaxiCode(value, options);
+  }
+  if (format === 'codablockf' || format === 'codablock-f' || format === 'codablock') {
+    return codablockf.encodeCodablockF(value, options);
+  }
+  if (format === 'code16k' || format === 'code-16k') {
+    return code16k.encodeCode16K(value, options);
+  }
+  if (format === 'dotcode' || format === 'dot-code') {
+    return dotcode.encodeDotCode(value, options);
+  }
+  if (format === 'hanxin' || format === 'han-xin') {
+    return hanxin.encodeHanXin(value, options);
+  }
+  if (format === 'gs1composite' || format === 'gs1-composite' || format === 'composite') {
+    return composite.encodeGS1Composite(value, options);
+  }
+  if (format === 'telepennumeric' || format === 'telepen-numeric') {
+    return encodeTelepenNumeric(value);
+  }
+  if (format === 'telepen' || format === 'telepen-alpha') {
+    return encodeTelepen(value, options);
+  }
+
+  if (format === 'code32' || format === 'italian-pharmacode') {
+    return encodeCode32(value);
+  }
+  if (format === 'pzn' || format === 'pzn7' || format === 'pzn8') {
+    return encodePZN(value, {
+      ...options,
+      pzn8: format === 'pzn8' || options.pzn8 === true || options.variant === 'pzn8',
+    });
+  }
+  if (format === 'code2of5' || format === 'standard2of5' || format === 'standard-2-of-5') {
+    return encodeStandard2of5(value, options);
+  }
+  if (format === 'industrial2of5' || format === 'industrial-2-of-5') {
+    return encodeIndustrial2of5(value, options);
+  }
+  if (format === 'iata2of5' || format === 'iata-2-of-5') {
+    return encodeIATA2of5(value, options);
+  }
+  if (format === 'postnet' || format === 'usps-postnet') {
+    return encodePostnet(value, options);
+  }
+  if (format === 'planet' || format === 'usps-planet') {
+    return encodePlanet(value, options);
+  }
+  if (format === 'rm4scc' || format === 'royalmail' || format === 'royal-mail') {
+    return encodeRM4SCC(value, options);
+  }
+  if (format === 'kix') {
+    return encodeKIX(value);
+  }
+  if (format === 'auspost' || format === 'australia-post' || format === 'australiapost') {
+    return encodeAustraliaPost(value, options);
+  }
+  if (format === 'japanpost' || format === 'japan-post') {
+    return encodeJapanPost(value);
+  }
+  if (format === 'imb' || format === 'onecode' || format === 'usps-onecode') {
+    return encodeIMB(value);
+  }
 
   const entry = ONED_FORMATS[format];
   if (!entry) {
-    const known = [...Object.keys(ONED_FORMATS), 'qr', 'datamatrix', 'aztec', 'aztecrune', 'pdf417', 'compactpdf417', 'micropdf417', 'microqr', 'rmqr', 'frameqr', 'gs1databar14'].join(', ');
+    const known = [...Object.keys(ONED_FORMATS), 'telepennumeric', 'telepen-numeric',
+      'code32', 'italian-pharmacode', 'pzn', 'pzn7', 'pzn8',
+      'code2of5', 'standard2of5', 'standard-2-of-5', 'industrial-2-of-5', 'iata-2-of-5',
+      'postnet', 'usps-postnet', 'planet', 'usps-planet', 'rm4scc', 'royalmail', 'royal-mail',
+      'kix', 'auspost', 'australia-post', 'australiapost', 'japanpost', 'japan-post',
+      'imb', 'onecode', 'usps-onecode',
+      'qr', 'datamatrix', 'aztec', 'aztecrune', 'pdf417', 'compactpdf417', 'micropdf417', 'microqr', 'rmqr', 'frameqr', 'gs1databar14', 'gs1databar-stacked', 'gs1databar-stacked-omnidirectional', 'gs1databar-limited', 'gs1databar-expanded', 'maxicode', 'codablockf', 'code16k', 'dotcode', 'hanxin', 'gs1composite', 'gs1-composite', 'composite'].join(', ');
     throw new EncodeError(`Unknown format "${format}". Known formats: ${known}`);
   }
   return entry.encode(value, options);
@@ -342,6 +571,8 @@ export function encode(text, options = {}) {
  * @property {number} [columns] PDF417 column count.
  * @property {number} [eccLevel] PDF417 error-correction level.
  * @property {number} [rowHeight] PDF417 row height in modules.
+ * @property {number} [moduleSize] Detected module scale for stacked formats.
+ * @property {boolean} [checksum] Whether the stacked format checks passed.
  * @property {number} [variant] MicroPDF417 predefined variant number.
  * @property {number} [eccCodewords] MicroPDF417 fixed error-correction codewords.
  * @property {string} [profile] Sythos Canvas QR profile identifier.
@@ -358,6 +589,10 @@ export function encode(text, options = {}) {
  * @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.
  */
 
 /**
@@ -390,10 +625,37 @@ export function decode(image, options = {}) {
   const wantMicroQR = !want || want.has('microqr') || want.has('micro-qr');
   const wantRMQR = !want || want.has('rmqr') || want.has('r-mqr') || want.has('rectangular-micro-qr');
   const wantFrameQR = !want || want.has('frameqr') || want.has('frame-qr') || want.has('canvas-qr');
-  const oneDAliases = new Set(['gs1databar14', 'databar', 'gs1-databar14']);
+  const wantMaxiCode = !want || want.has('maxicode') || want.has('maxi-code');
+  const wantCodablockF = !want || want.has('codablockf') || want.has('codablock-f') || want.has('codablock');
+  const wantCode16K = !want || want.has('code16k') || want.has('code-16k');
+  const wantDotCode = !want || want.has('dotcode') || want.has('dot-code');
+  const wantHanXin = !want || want.has('hanxin') || want.has('han-xin');
+  const wantGS1Composite = !want || want.has('gs1composite') || want.has('gs1-composite') || want.has('composite');
+  const wantDataBarStacked = !want || want.has('gs1databar-stacked') || want.has('gs1-databar-stacked') || want.has('databar-stacked');
+  const wantDataBarStackedOmni = !want || want.has('gs1databar-stacked-omnidirectional')
+    || want.has('gs1-databar-stacked-omnidirectional') || want.has('databar-stacked-omni');
+  const wantDataBarLimited = !want || want.has('gs1databar-limited')
+    || want.has('gs1-databar-limited') || want.has('databar-limited');
+  const wantDataBarExpanded = !want || want.has('gs1databar-expanded')
+    || want.has('gs1-databar-expanded') || want.has('databar-expanded');
+  const oneDAliases = new Set([
+    'gs1databar14', 'databar', 'gs1-databar14',
+    'gs1databar-stacked', 'gs1-databar-stacked', 'databar-stacked',
+    'gs1databar-stacked-omnidirectional', 'gs1-databar-stacked-omnidirectional', 'databar-stacked-omni',
+    'gs1databar-limited', 'gs1-databar-limited', 'databar-limited',
+    'gs1databar-expanded', 'gs1-databar-expanded', 'databar-expanded',
+    'telepen-alpha', 'telepennumeric', 'telepen-numeric',
+    'code32', 'italian-pharmacode', 'pzn7', 'pzn8',
+    'code2of5', 'standard2of5', 'standard-2-of-5',
+    'industrial-2-of-5', 'iata-2-of-5',
+    'usps-postnet', 'usps-planet', 'royalmail', 'royal-mail',
+    'australia-post', 'australiapost', 'japan-post', 'onecode', 'usps-onecode',
+  ]);
   const wantOneD = !want || [...want].some((f) => f in ONED_FORMATS || oneDAliases.has(f));
   const wantTwoD = wantQR || wantDataMatrix || wantAztec || wantAztecRune || wantPDF417
-    || wantCompactPDF417 || wantMicroPDF417 || wantMicroQR || wantRMQR || wantFrameQR;
+    || wantCompactPDF417 || wantMicroPDF417 || wantMicroQR || wantRMQR || wantFrameQR || wantMaxiCode
+    || wantCodablockF || wantCode16K || wantDotCode || wantHanXin || wantGS1Composite
+    || wantDataBarStacked || wantDataBarStackedOmni || wantDataBarLimited || wantDataBarExpanded;
 
   const source = LuminanceSource.fromImageData(image);
   const results = [];
@@ -529,6 +791,107 @@ export function decode(image, options = {}) {
         }
       }
 
+      if (wantMaxiCode && maxicodeCanDecode) {
+        try {
+          const found = maxicode.detectAndDecodeMaxiCode(candidateBits);
+          if (found) add(found, 'maxicode');
+        } catch {
+          /* no MaxiCode in this pass */
+        }
+      }
+
+      if (wantCodablockF && codablockfCanDecode) {
+        const codablockBits = binarizer === 'auto'
+          ? [candidateBits, binarize(candidateSource, 'global')]
+          : [candidateBits];
+        for (const thresholdBits of codablockBits) {
+          try {
+            const found = codablockf.detectAndDecodeCodablockF(thresholdBits);
+            if (found) { add(found, 'codablockf'); break; }
+          } catch {
+            /* no Codablock-F in this pass */
+          }
+        }
+      }
+
+      if (wantCode16K && code16kCanDecode) {
+        const code16KBits = binarizer === 'auto'
+          ? [candidateBits, binarize(candidateSource, 'global')]
+          : [candidateBits];
+        for (const thresholdBits of code16KBits) {
+          try {
+            const found = code16k.detectAndDecodeCode16K(thresholdBits);
+            if (found) { add(found, 'code16k'); break; }
+          } catch {
+            /* no Code 16K in this pass */
+          }
+        }
+      }
+
+      if (wantDotCode && dotCodeCanDecode) {
+        try {
+          const found = dotcode.detectAndDecodeDotCode(candidateBits);
+          for (const result of found) add(result, 'dotcode');
+        } catch {
+          /* no DotCode in this pass */
+        }
+      }
+
+      if (wantHanXin && hanXinCanDecode) {
+        try {
+          const found = hanxin.detectAndDecodeHanXin(candidateBits);
+          if (found) add(found, 'hanxin');
+        } catch {
+          /* no Han Xin code in this pass */
+        }
+      }
+
+      if (wantGS1Composite && gs1CompositeCanDecode) {
+        try {
+          const found = composite.detectAndDecodeGS1Composite(candidateBits);
+          if (found) add(found, 'gs1composite');
+        } catch {
+          /* no bounded GS1 Composite symbol in this pass */
+        }
+      }
+
+
+      if (wantDataBarStacked && dataBarStackedCanDecode) {
+        try {
+          const found = databar.detectAndDecodeDataBar14Stacked(candidateBits);
+          if (found) add(found, 'gs1databar-stacked');
+        } catch {
+          /* no GS1 DataBar Stacked in this pass */
+        }
+      }
+
+      if (wantDataBarStackedOmni && dataBarStackedOmniCanDecode) {
+        try {
+          const found = databar.detectAndDecodeDataBarStackedOmnidirectional(candidateBits);
+          if (found) add(found, 'gs1databar-stacked-omnidirectional');
+        } catch {
+          /* no GS1 DataBar Stacked Omnidirectional in this pass */
+        }
+      }
+
+      if (wantDataBarLimited && dataBarLimitedCanDecode) {
+        try {
+          const found = databar.detectAndDecodeDataBarLimited(candidateBits);
+          if (found) add(found, 'gs1databar-limited');
+        } catch {
+          /* no GS1 DataBar Limited in this pass */
+        }
+      }
+
+      if (wantDataBarExpanded && dataBarExpandedCanDecode) {
+        try {
+          const found = databar.detectAndDecodeDataBarExpanded(candidateBits);
+          if (found) add(found, 'gs1databar-expanded');
+        } catch {
+          /* no GS1 DataBar Expanded in this pass */
+        }
+      }
+
       return results.length > before;
     };
 
@@ -619,17 +982,21 @@ export function decode(image, options = {}) {
   });
 
   // On large clean rasters, hybrid thresholding can erase otherwise uniform
-  // QR/PDF417 modules. Keep auto/hybrid as the primary strategy, then make one
-  // focused global retry only when the complete primary pass found nothing.
+  // QR, PDF417 and MaxiCode modules. Keep auto/hybrid as the primary strategy,
+  // then make one focused global retry only when the complete primary pass
+  // found nothing.
   // This deliberately leaves an explicit global request single-pass.
   const retryFormats = formats
     ? formats.filter((format) => {
       const id = String(format).toLowerCase();
       return id === 'qr' || id === 'qrcode'
         || id === 'pdf417' || id === 'pdf-417'
-        || id === 'compactpdf417' || id === 'compact-pdf417' || id === 'compact-pdf-417';
+        || id === 'compactpdf417' || id === 'compact-pdf417' || id === 'compact-pdf-417'
+        || id === 'maxicode' || id === 'maxi-code'
+        || id === 'hanxin' || id === 'han-xin'
+        || id === 'gs1composite' || id === 'gs1-composite' || id === 'composite';
     })
-    : ['qr', 'pdf417', 'compactpdf417'];
+    : ['qr', 'pdf417', 'compactpdf417', 'maxicode', 'hanxin', 'gs1composite'];
   const shouldRetryGlobal = unique.length === 0
     && (binarizer === 'auto' || binarizer === 'hybrid')
     && retryFormats.length > 0;
@@ -787,4 +1154,4 @@ export function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-export const VERSION = '1.5.13';
+export const VERSION = '1.5.15';