@sythos/js_barcode_universal 1.5.13 → 1.5.15

package/src/ts/maxicode/tables.ts

@@ -0,0 +1,136 @@
+/*!
+ * Sythos Barcode Suite
+ *
+ * MIT License
+ *
+ * Copyright (c) 2026 Sythos
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+
+/**
+ * MaxiCode structural constants and the module sequence from ISO/IEC 16023
+ * Figure 5.  The sequence is transcribed from the published standard figure,
+ * not imported from another implementation.  Zero entries are the alternating
+ * row gaps, finder reservation and orientation markers; values 1..864 identify
+ * the six-bit data modules in wire order.
+ *
+ * @module maxicode/tables
+ */
+
+export const MAXICODE_WIDTH = 30;
+export const MAXICODE_HEIGHT = 33;
+export const MAXICODE_CODEWORDS = 144;
+export const MAXICODE_DATA_MODULES = 864;
+export const MAXICODE_FIELD_SIZE = 64;
+
+/** ISO 16023 Figure 5, laid out as 33 rows of 30 logical positions. */
+const MAXICODE_GRID_ROWS = [
+  [122, 121, 128, 127, 134, 133, 140, 139, 146, 145, 152, 151, 158, 157, 164, 163, 170, 169, 176, 175, 182, 181, 188, 187, 194, 193, 200, 199, 0, 0],
+  [124, 123, 130, 129, 136, 135, 142, 141, 148, 147, 154, 153, 160, 159, 166, 165, 172, 171, 178, 177, 184, 183, 190, 189, 196, 195, 202, 201, 817, 0],
+  [126, 125, 132, 131, 138, 137, 144, 143, 150, 149, 156, 155, 162, 161, 168, 167, 174, 173, 180, 179, 186, 185, 192, 191, 198, 197, 204, 203, 819, 818],
+  [284, 283, 278, 277, 272, 271, 266, 265, 260, 259, 254, 253, 248, 247, 242, 241, 236, 235, 230, 229, 224, 223, 218, 217, 212, 211, 206, 205, 820, 0],
+  [286, 285, 280, 279, 274, 273, 268, 267, 262, 261, 256, 255, 250, 249, 244, 243, 238, 237, 232, 231, 226, 225, 220, 219, 214, 213, 208, 207, 822, 821],
+  [288, 287, 282, 281, 276, 275, 270, 269, 264, 263, 258, 257, 252, 251, 246, 245, 240, 239, 234, 233, 228, 227, 222, 221, 216, 215, 210, 209, 823, 0],
+  [290, 289, 296, 295, 302, 301, 308, 307, 314, 313, 320, 319, 326, 325, 332, 331, 338, 337, 344, 343, 350, 349, 356, 355, 362, 361, 368, 367, 825, 824],
+  [292, 291, 298, 297, 304, 303, 310, 309, 316, 315, 322, 321, 328, 327, 334, 333, 340, 339, 346, 345, 352, 351, 358, 357, 364, 363, 370, 369, 826, 0],
+  [294, 293, 300, 299, 306, 305, 312, 311, 318, 317, 324, 323, 330, 329, 336, 335, 342, 341, 348, 347, 354, 353, 360, 359, 366, 365, 372, 371, 828, 827],
+  [410, 409, 404, 403, 398, 397, 392, 391, 80, 79, 0, 0, 14, 13, 38, 37, 3, 0, 45, 44, 110, 109, 386, 385, 380, 379, 374, 373, 829, 0],
+  [412, 411, 406, 405, 400, 399, 394, 393, 82, 81, 41, 0, 16, 15, 40, 39, 4, 0, 0, 46, 112, 111, 388, 387, 382, 381, 376, 375, 831, 830],
+  [414, 413, 408, 407, 402, 401, 396, 395, 84, 83, 42, 0, 0, 0, 0, 0, 6, 5, 48, 47, 114, 113, 390, 389, 384, 383, 378, 377, 832, 0],
+  [416, 415, 422, 421, 428, 427, 104, 103, 56, 55, 17, 0, 0, 0, 0, 0, 0, 0, 21, 20, 86, 85, 434, 433, 440, 439, 446, 445, 834, 833],
+  [418, 417, 424, 423, 430, 429, 106, 105, 58, 57, 0, 0, 0, 0, 0, 0, 0, 0, 23, 22, 88, 87, 436, 435, 442, 441, 448, 447, 835, 0],
+  [420, 419, 426, 425, 432, 431, 108, 107, 60, 59, 0, 0, 0, 0, 0, 0, 0, 0, 0, 24, 90, 89, 438, 437, 444, 443, 450, 449, 837, 836],
+  [482, 481, 476, 475, 470, 469, 49, 0, 31, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 54, 53, 464, 463, 458, 457, 452, 451, 838, 0],
+  [484, 483, 478, 477, 472, 471, 50, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 466, 465, 460, 459, 454, 453, 840, 839],
+  [486, 485, 480, 479, 474, 473, 52, 51, 32, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 43, 468, 467, 462, 461, 456, 455, 841, 0],
+  [488, 487, 494, 493, 500, 499, 98, 97, 62, 61, 0, 0, 0, 0, 0, 0, 0, 0, 0, 27, 92, 91, 506, 505, 512, 511, 518, 517, 843, 842],
+  [490, 489, 496, 495, 502, 501, 100, 99, 64, 63, 0, 0, 0, 0, 0, 0, 0, 0, 29, 28, 94, 93, 508, 507, 514, 513, 520, 519, 844, 0],
+  [492, 491, 498, 497, 504, 503, 102, 101, 66, 65, 18, 0, 0, 0, 0, 0, 0, 0, 19, 30, 96, 95, 510, 509, 516, 515, 522, 521, 846, 845],
+  [560, 559, 554, 553, 548, 547, 542, 541, 74, 73, 33, 0, 0, 0, 0, 0, 0, 11, 68, 67, 116, 115, 536, 535, 530, 529, 524, 523, 847, 0],
+  [562, 561, 556, 555, 550, 549, 544, 543, 76, 75, 0, 0, 8, 7, 36, 35, 12, 0, 70, 69, 118, 117, 538, 537, 532, 531, 526, 525, 849, 848],
+  [564, 563, 558, 557, 552, 551, 546, 545, 78, 77, 0, 34, 10, 9, 26, 25, 0, 0, 72, 71, 120, 119, 540, 539, 534, 533, 528, 527, 850, 0],
+  [566, 565, 572, 571, 578, 577, 584, 583, 590, 589, 596, 595, 602, 601, 608, 607, 614, 613, 620, 619, 626, 625, 632, 631, 638, 637, 644, 643, 852, 851],
+  [568, 567, 574, 573, 580, 579, 586, 585, 592, 591, 598, 597, 604, 603, 610, 609, 616, 615, 622, 621, 628, 627, 634, 633, 640, 639, 646, 645, 853, 0],
+  [570, 569, 576, 575, 582, 581, 588, 587, 594, 593, 600, 599, 606, 605, 612, 611, 618, 617, 624, 623, 630, 629, 636, 635, 642, 641, 648, 647, 855, 854],
+  [728, 727, 722, 721, 716, 715, 710, 709, 704, 703, 698, 697, 692, 691, 686, 685, 680, 679, 674, 673, 668, 667, 662, 661, 656, 655, 650, 649, 856, 0],
+  [730, 729, 724, 723, 718, 717, 712, 711, 706, 705, 700, 699, 694, 693, 688, 687, 682, 681, 676, 675, 670, 669, 664, 663, 658, 657, 652, 651, 858, 857],
+  [732, 731, 726, 725, 720, 719, 714, 713, 708, 707, 702, 701, 696, 695, 690, 689, 684, 683, 678, 677, 672, 671, 666, 665, 660, 659, 654, 653, 859, 0],
+  [734, 733, 740, 739, 746, 745, 752, 751, 758, 757, 764, 763, 770, 769, 776, 775, 782, 781, 788, 787, 794, 793, 800, 799, 806, 805, 812, 811, 861, 860],
+  [736, 735, 742, 741, 748, 747, 754, 753, 760, 759, 766, 765, 772, 771, 778, 777, 784, 783, 790, 789, 796, 795, 802, 801, 808, 807, 814, 813, 862, 0],
+  [738, 737, 744, 743, 750, 749, 756, 755, 762, 761, 768, 767, 774, 773, 780, 779, 786, 785, 792, 791, 798, 797, 804, 803, 810, 809, 816, 815, 864, 863],
+];
+
+/** Flattened standard module sequence. */
+export const MAXICODE_GRID = MAXICODE_GRID_ROWS.flat();
+
+/** Fixed orientation modules, expressed as [x, y] logical positions. */
+export const MAXICODE_ORIENTATION_DARK = Object.freeze([
+  [28, 0], [29, 0],
+  [10, 9], [11, 9], [11, 10],
+  [7, 15], [8, 16],
+  [20, 16], [20, 17],
+  [10, 22], [10, 23],
+  [17, 22], [17, 23],
+]);
+
+/**
+ * Return the fixed colour of a structural module, or null for a data module.
+ *
+ * MaxiCode's finder is drawn on a staggered hexagonal lattice.  The logical
+ * interchange grid keeps one cell per module, so the standard ring radii are
+ * evaluated at the centre of each staggered cell.  Using the structural zero
+ * entries from Figure 5 here is important: treating the entire circular area
+ * as finder cells would overwrite payload modules at the edge of the rings.
+ */
+export function maxicodeFinderValue(x: number, y: number): boolean | null {
+  if (MAXICODE_GRID[y * MAXICODE_WIDTH + x] !== 0) return null;
+
+  // Coordinates are scaled only to preserve the 30:33 staggered lattice
+  // proportions.  The constants are the normalized centres and radii of the
+  // three standard annuli; a scale factor cancels out of the classification.
+  const cellX = (y & 1) ? x + 34.5 / 35 : x + 16.5 / 35;
+  const cellY = y + 20 / 30;
+  const centreX = 507 / 35;
+  const centreY = 506 / 30;
+  const distance = Math.hypot((cellX - centreX) * 35, (cellY - centreY) * 30);
+  return (distance >= 20 && distance < 46) ||
+    (distance >= 73 && distance < 100) ||
+    (distance >= 126 && distance < 153);
+}
+
+/** Verify that the transcribed standard sequence is complete and one-to-one. */
+export function validateMaxiCodeTables(): string[] {
+  const errors: string[] = [];
+  if (MAXICODE_GRID.length !== MAXICODE_WIDTH * MAXICODE_HEIGHT) {
+    errors.push(`grid length ${MAXICODE_GRID.length} is not ${MAXICODE_WIDTH * MAXICODE_HEIGHT}`);
+  }
+  const values = MAXICODE_GRID.filter((value) => value > 0);
+  if (values.length !== MAXICODE_DATA_MODULES) errors.push(`grid has ${values.length} data modules`);
+  const seen = new Set(values);
+  if (seen.size !== values.length) errors.push('grid contains duplicate module sequence numbers');
+  for (let value = 1; value <= MAXICODE_DATA_MODULES; value++) {
+    if (!seen.has(value)) errors.push(`grid is missing module sequence ${value}`);
+  }
+  return errors;
+}

package/src/ts/oned/code25.d.ts

@@ -0,0 +1,42 @@
+/*!
+ * Sythos Barcode Suite
+ *
+ * MIT License
+ *
+ * Copyright (c) 2026 Sythos
+ * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+export type Code25Variant = 'standard' | 'industrial' | 'iata';
+export declare const CODE25_DIGIT_PATTERNS: readonly [
+    '1111313111', '3111111131', '1131111131', '3131111111', '1111311131',
+    '3111311111', '1131311111', '1111113131', '3111113111', '1131113111'
+];
+export declare const CODE25_VARIANTS: Readonly<Record<Code25Variant, {
+    readonly id: 'industrial2of5' | 'iata2of5';
+    readonly label: string;
+    readonly start: string;
+    readonly stop: string;
+}>>;
+export declare const CODE25_MAX_DIGITS: 500;
+export declare function code25CheckDigit(value: string): number;
+export declare function encodeCode25(value: string, options?: {
+    variant?: Code25Variant | string;
+    checkDigit?: boolean;
+    wideRatio?: number;
+}): BitMatrix;
+export declare function encodeStandard2of5(value: string, options?: {
+    checkDigit?: boolean;
+    wideRatio?: number;
+}): BitMatrix;
+export declare function encodeIndustrial2of5(value: string, options?: {
+    checkDigit?: boolean;
+    wideRatio?: number;
+}): BitMatrix;
+export declare function encodeIATA2of5(value: string, options?: {
+    checkDigit?: boolean;
+    wideRatio?: number;
+}): BitMatrix;

package/src/ts/oned/code25.ts

@@ -0,0 +1,170 @@
+/*!
+ * Sythos Barcode Suite
+ *
+ * MIT License
+ *
+ * Copyright (c) 2026 Sythos
+ * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+
+/**
+ * Code 25 family writers.
+ *
+ * Code 25 (also called Standard or Industrial 2 of 5) represents each digit
+ * with five alternating bar/space elements, exactly two of the bars being wide.
+ * IATA 2 of 5 uses the same digit grammar with a shorter start/stop frame.
+ * The width descriptions below are expressed as module counts rather than
+ * copied implementation tables and are checked by the focused test suite.
+ *
+ * @module oned/code25
+ */
+
+import { BitMatrix } from '../core/bit-matrix.js';
+import { EncodeError } from '../core/errors.js';
+
+/** Supported Code 25 framing profiles. */
+export type Code25Variant = 'standard' | 'industrial' | 'iata';
+
+/** The ten digit patterns, each with five bars and five spaces. */
+export const CODE25_DIGIT_PATTERNS = [
+  '1111313111', '3111111131', '1131111131', '3131111111',
+  '1111311131', '3111311111', '1131311111', '1111113131',
+  '3111113111', '1131113111',
+] as const;
+
+/** Start/stop run widths for the three public names. */
+export const CODE25_VARIANTS: Readonly<Record<Code25Variant, {
+  readonly id: 'industrial2of5' | 'iata2of5';
+  readonly label: string;
+  readonly start: string;
+  readonly stop: string;
+}>> = {
+  // Code 25 and Industrial 2 of 5 share the discrete two-wide-bar grammar
+  // and canonical industrial frame. `standard` is the friendly API alias.
+  standard: { id: 'industrial2of5', label: 'Standard 2 of 5 (Code 25)', start: '313111', stop: '31113' },
+  industrial: { id: 'industrial2of5', label: 'Industrial 2 of 5', start: '313111', stop: '31113' },
+  iata: { id: 'iata2of5', label: 'IATA 2 of 5', start: '1111', stop: '311' },
+};
+
+const MAX_CODE25_DIGITS = 500;
+
+function requireDigits(value: string, label: string): string {
+  const text = String(value);
+  if (!/^[0-9]+$/u.test(text)) {
+    throw new EncodeError(`${label}: payload must be digits only, got "${value}"`);
+  }
+  if (text.length === 0 || text.length > MAX_CODE25_DIGITS) {
+    throw new EncodeError(`${label}: payload length must be in 1..${MAX_CODE25_DIGITS}`);
+  }
+  return text;
+}
+
+/** Modulo-10 Code 25 check digit (alternating weights from the right). */
+export function code25CheckDigit(value: string): number {
+  let sum = 0;
+  for (let i = 0; i < value.length; i++) {
+    const fromRight = value.length - 1 - i;
+    sum += Number(value[i]) * (fromRight % 2 === 0 ? 3 : 1);
+  }
+  return (10 - (sum % 10)) % 10;
+}
+
+function expandWidths(widths: string, wideRatio: number): string {
+  let modules = '';
+  for (let i = 0; i < widths.length; i++) {
+    const width = Number(widths[i]);
+    const count = width > 1 ? wideRatio : 1;
+    modules += (i % 2 === 0 ? '1' : '0').repeat(count);
+  }
+  return modules;
+}
+
+function toMatrix(modules: string): BitMatrix {
+  const matrix = new BitMatrix(modules.length, 1);
+  for (let x = 0; x < modules.length; x++) {
+    if (modules[x] === '1') matrix.set(x, 0);
+  }
+  return matrix;
+}
+
+function resolveVariant(value: unknown): Code25Variant {
+  const variant = String(value ?? 'standard').toLowerCase();
+  if (variant === 'industrial' || variant === 'industrial2of5' || variant === 'industrial-2-of-5') return 'industrial';
+  if (variant === 'iata' || variant === 'iata2of5' || variant === 'iata-2-of-5') return 'iata';
+  if (variant === 'standard' || variant === 'code2of5' || variant === 'code-2-of-5' || variant === 'standard2of5' || variant === 'standard-2-of-5') return 'standard';
+  throw new EncodeError(`Code 25: unknown variant "${value}"`);
+}
+
+/**
+ * Encode one of the Code 25 family profiles.
+ *
+ * `checkDigit` is opt-in because the base symbologies do not require one. A
+ * camera-profile decoder will require and validate it before promoting a read.
+ *
+ * @param {string} value Numeric payload.
+ * @param {object} [options]
+ * @param {Code25Variant|string} [options.variant='standard'] Framing profile.
+ * @param {boolean} [options.checkDigit] Append a modulo-10 check digit.
+ * @param {number} [options.wideRatio=3] Number of modules in a wide bar.
+ * @returns {BitMatrix}
+ */
+export function encodeCode25(value: string, options: {
+  variant?: Code25Variant | string;
+  checkDigit?: boolean;
+  wideRatio?: number;
+} = {}): BitMatrix {
+  const variant = resolveVariant(options.variant);
+  const profile = CODE25_VARIANTS[variant];
+  const label = profile.label;
+  const ratio = options.wideRatio ?? 3;
+  if (!Number.isInteger(ratio) || ratio < 2 || ratio > 8) {
+    throw new EncodeError(`${label}: wideRatio must be an integer in 2..8`);
+  }
+  let digits = requireDigits(value, label);
+  if (options.checkDigit === true) digits += String(code25CheckDigit(digits));
+
+  let modules = expandWidths(profile.start, ratio);
+  for (const digit of digits) modules += expandWidths(CODE25_DIGIT_PATTERNS[Number(digit)], ratio);
+  modules += expandWidths(profile.stop, ratio);
+  return toMatrix(modules);
+}
+
+/** Encode Standard 2 of 5 (the canonical Code 25 frame). */
+export function encodeStandard2of5(value: string, options: Omit<Parameters<typeof encodeCode25>[1], 'variant'> = {}): BitMatrix {
+  return encodeCode25(value, { ...options, variant: 'standard' });
+}
+
+/** Encode Industrial 2 of 5. */
+export function encodeIndustrial2of5(value: string, options: Omit<Parameters<typeof encodeCode25>[1], 'variant'> = {}): BitMatrix {
+  return encodeCode25(value, { ...options, variant: 'industrial' });
+}
+
+/** Encode IATA 2 of 5. */
+export function encodeIATA2of5(value: string, options: Omit<Parameters<typeof encodeCode25>[1], 'variant'> = {}): BitMatrix {
+  return encodeCode25(value, { ...options, variant: 'iata' });
+}
+
+/** Internal limit used by the scanline reader and its safety checks. */
+export const CODE25_MAX_DIGITS = MAX_CODE25_DIGITS;

package/src/ts/oned/index.d.ts

@@ -33,9 +33,14 @@
  *
  * @module oned
  */
-export { encodeEAN13, encodeEAN8, encodeUPCA, encodeUPCE, encodeISBN, encodeCode39, encodeCode93, encodeCode128, encodeITF, encodeITF14, encodeCodabar, encodeCode11, encodeMSI, encodePharmacode, ean13CheckDigit, } from './writers.js';
+export { encodeEAN13, encodeEAN8, encodeUPCA, encodeUPCE, encodeISBN, encodeCode39, encodeCode93, encodeCode128, code128DataCodewords, encodeITF, encodeITF14, encodeCodabar, encodeCode11, encodeMSI, encodePharmacode, code32CheckDigit, encodeCode32, decodeCode32Payload, encodePZN, decodePZNPayload, ean13CheckDigit, } from './writers.js';
+export { CODE25_DIGIT_PATTERNS, CODE25_VARIANTS, CODE25_MAX_DIGITS, code25CheckDigit, encodeCode25, encodeStandard2of5, encodeIndustrial2of5, encodeIATA2of5, } from './code25.js';
+export type { Code25Variant } from './code25.js';
 export { EAN2_PARITY, EAN5_PARITY, EAN2_WIDTH, EAN5_WIDTH, EAN_ADDON_START, EAN_ADDON_SEPARATOR, ean2Parity, ean5Checksum, ean5CheckDigit, ean5Parity, encodeEAN2, encodeEAN5, encodeEANAddon, encodeEANAddOn, decodeEAN2, decodeEAN5, decodeEANAddon, decodeEANAddOn, composeEANAddon, encodeEAN13WithAddon, encodeEAN8WithAddon, encodeUPCAWithAddon, encodeUPCEWithAddon, } from './addons.js';
-export { decodeOneD, decodeOneDStrict, decodeCode11, decodeMSI, patternVariance, recordPattern, toNarrowWidePattern, } from './reader.js';
+export { decodeOneD, decodeOneDStrict, decodeCode32, decodePZN, decodeCode25, decodeStandard2of5, decodeIndustrial2of5, decodeIATA2of5, decodeCode11, decodeMSI, patternVariance, recordPattern, toNarrowWidePattern, } from './reader.js';
+export { TELEPEN_START_VALUE, TELEPEN_STOP_VALUE, TELEPEN_MAX_LENGTH, telepenPattern, encodeTelepen, encodeTelepenNumeric, decodeTelepen, decodeTelepenNumeric, } from './telepen.js';
+export { POSTAL_FORMATS, POSTAL_ALIASES, STATE_PROFILES, encodePostnet, encodePlanet, encodeRM4SCC, encodeKIX, encodeAustraliaPost, encodeJapanPost, encodeIMB, decodePostal, } from './postal.js';
+export type { PostalFormat, PostalOptions, PostalDecodeResult } from './postal.js';
 export { validateTables } from './patterns.js';
 /**
  * Writers by format id, for the top-level `encode()` dispatcher.

package/src/ts/oned/index.ts

@@ -37,11 +37,26 @@
 export {
   encodeEAN13, encodeEAN8, encodeUPCA, encodeUPCE, encodeISBN,
   encodeCode39, encodeCode93, encodeCode128,
+  code128DataCodewords,
   encodeITF, encodeITF14, encodeCodabar, encodeCode11,
-  encodeMSI, encodePharmacode,
+  encodeMSI, encodePharmacode, encodeCode32, encodePZN,
+  code32CheckDigit, decodeCode32Payload, decodePZNPayload,
   ean13CheckDigit,
 } from './writers.js';
 
+export {
+  CODE25_DIGIT_PATTERNS, CODE25_VARIANTS, CODE25_MAX_DIGITS,
+  code25CheckDigit, encodeCode25, encodeStandard2of5,
+  encodeIndustrial2of5, encodeIATA2of5,
+} from './code25.js';
+export type { Code25Variant } from './code25.js';
+
+export {
+  TELEPEN_START_VALUE, TELEPEN_STOP_VALUE, TELEPEN_MAX_LENGTH,
+  telepenPattern, encodeTelepen, encodeTelepenNumeric,
+  decodeTelepen, decodeTelepenNumeric,
+} from './telepen.js';
+
 export {
   EAN2_PARITY, EAN5_PARITY, EAN2_WIDTH, EAN5_WIDTH,
   EAN_ADDON_START, EAN_ADDON_SEPARATOR,
@@ -54,20 +69,35 @@ export {
 } from './addons.js';
 
 export {
-  decodeOneD, decodeOneDStrict,
+  decodeOneD, decodeOneDStrict, decodeCode32, decodePZN,
+  decodeCode25, decodeStandard2of5, decodeIndustrial2of5, decodeIATA2of5,
   decodeCode11, decodeMSI,
   patternVariance, recordPattern, toNarrowWidePattern,
 } from './reader.js';
 
+export {
+  POSTAL_FORMATS, POSTAL_ALIASES, STATE_PROFILES,
+  encodePostnet, encodePlanet, encodeRM4SCC, encodeKIX,
+  encodeAustraliaPost, encodeJapanPost, encodeIMB,
+  decodePostal,
+} from './postal.js';
+export type { PostalFormat, PostalOptions, PostalDecodeResult } from './postal.js';
+
 export { validateTables } from './patterns.js';
 
 import {
   encodeEAN13, encodeEAN8, encodeUPCA, encodeUPCE, encodeISBN,
   encodeCode39, encodeCode93, encodeCode128,
   encodeITF, encodeITF14, encodeCodabar, encodeCode11,
-  encodeMSI, encodePharmacode,
+  encodeMSI, encodePharmacode, encodeCode32, encodePZN,
 } from './writers.js';
 import { encodeEAN2, encodeEAN5 } from './addons.js';
+import { encodeTelepen } from './telepen.js';
+import { encodeIndustrial2of5, encodeIATA2of5 } from './code25.js';
+import {
+  encodePostnet, encodePlanet, encodeRM4SCC, encodeKIX,
+  encodeAustraliaPost, encodeJapanPost, encodeIMB,
+} from './postal.js';
 
 /**
  * Writers by format id, for the top-level `encode()` dispatcher.
@@ -95,12 +125,24 @@ export const ONED_FORMATS = {
   code93: { encode: encodeCode93, readable: true, label: 'Code 93' },
   itf: { encode: encodeITF, readable: true, label: 'ITF (Interleaved 2 of 5)' },
   itf14: { encode: encodeITF14, readable: true, label: 'ITF-14' },
+  industrial2of5: { encode: encodeIndustrial2of5, readable: true, label: 'Industrial 2 of 5' },
+  iata2of5: { encode: encodeIATA2of5, readable: true, label: 'IATA 2 of 5' },
   codabar: { encode: encodeCodabar, readable: true, label: 'Codabar' },
   code11: { encode: encodeCode11, readable: true, label: 'Code 11' },
   msi: { encode: encodeMSI, readable: true, label: 'MSI Plessey' },
+  code32: { encode: encodeCode32, readable: true, label: 'Code 32 (Italian Pharmacode)' },
+  pzn: { encode: encodePZN, readable: true, label: 'PZN (Pharmazentralnummer)' },
+  telepen: { encode: encodeTelepen, readable: true, label: 'Telepen' },
   pharmacode: { encode: encodePharmacode, readable: false, label: 'Pharmacode' },
   // Supplements are reported as readable capabilities, but the image reader
   // only accepts them when attached to a validated EAN/UPC parent symbol.
   ean2: { encode: encodeEAN2, readable: true, role: 'supplement', label: 'EAN-2 supplement' },
   ean5: { encode: encodeEAN5, readable: true, role: 'supplement', label: 'EAN-5 supplement' },
+  postnet: { encode: encodePostnet, readable: true, label: 'USPS POSTNET' },
+  planet: { encode: encodePlanet, readable: true, label: 'USPS PLANET' },
+  rm4scc: { encode: encodeRM4SCC, readable: true, label: 'Royal Mail 4-State (RM4SCC)' },
+  kix: { encode: encodeKIX, readable: true, label: 'KIX postal code' },
+  auspost: { encode: encodeAustraliaPost, readable: true, label: 'Australia Post 4-State' },
+  japanpost: { encode: encodeJapanPost, readable: true, label: 'Japan Post 4-State' },
+  imb: { encode: encodeIMB, readable: true, label: 'USPS Intelligent Mail (IMb)' },
 };

package/src/ts/oned/postal.d.ts

@@ -0,0 +1,44 @@
+/*
+ * Sythos Barcode Suite — MIT License — Copyright (c) 2026 Sythos
+ * Original work. No code from any other barcode implementation.
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+
+export type PostalFormat =
+  | 'postnet'
+  | 'planet'
+  | 'rm4scc'
+  | 'kix'
+  | 'auspost'
+  | 'japanpost'
+  | 'imb';
+
+export interface PostalOptions {
+  checkDigit?: boolean;
+  customerEncoding?: 'character' | 'numeric';
+  custinfoenc?: 'character' | 'numeric';
+  profile?: 'camera';
+}
+
+export interface PostalDecodeResult {
+  format: PostalFormat;
+  text: string;
+  checkDigit: boolean;
+}
+
+export declare const POSTAL_FORMATS: PostalFormat[];
+export declare const POSTAL_ALIASES: Readonly<Record<string, PostalFormat>>;
+export declare const STATE_PROFILES: readonly (readonly [number, number])[];
+
+export declare function encodePostnet(value: string, options?: PostalOptions): BitMatrix;
+export declare function encodePlanet(value: string, options?: PostalOptions): BitMatrix;
+export declare function encodeRM4SCC(value: string, options?: PostalOptions): BitMatrix;
+export declare function encodeKIX(value: string): BitMatrix;
+export declare function encodeAustraliaPost(value: string, options?: PostalOptions): BitMatrix;
+export declare function encodeJapanPost(value: string): BitMatrix;
+export declare function encodeIMB(value: string): BitMatrix;
+
+export declare function decodePostal(
+  image: BitMatrix,
+  options?: PostalOptions & { formats?: string[] },
+): PostalDecodeResult[];