@sythos/js_barcode_universal 1.5.6 → 1.5.8

package/src/ts/core/reed-solomon.d.ts

@@ -0,0 +1,65 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+/**
+ * Build the generator polynomial for `eccLen` parity symbols.
+ *
+ *   g(x) = product over i of (x - a^(base + i)),  i = 0 .. eccLen-1
+ *
+ * `base` is 0 for QR; 1 for Aztec, Data Matrix and PDF417.
+ *
+ * @param {number} eccLen
+ * @param {import('./galois-field.js').GaloisField} field
+ * @param {number} [base]
+ * @returns {number[]} Monic, degree-descending, length eccLen + 1.
+ */
+export declare function generatorPoly(eccLen: number, field: import('./galois-field.js').GaloisField, base?: number): number[];
+/**
+ * Compute `eccLen` parity symbols for `data`.
+ *
+ * @param {ArrayLike<number>} data
+ * @param {number} eccLen
+ * @param {import('./galois-field.js').GaloisField} field
+ * @param {number} [base]
+ * @returns {number[]} The parity symbols alone, length eccLen.
+ */
+export declare function rsEncode(data: ArrayLike<number>, eccLen: number, field: import('./galois-field.js').GaloisField, base?: number): number[];
+/**
+ * Correct errors in a received codeword, in place.
+ *
+ * @param {number[]} received Data followed by parity, degree-descending.
+ * @param {number} eccLen
+ * @param {import('./galois-field.js').GaloisField} field
+ * @param {number} [base]
+ * @param {number[]} [erasures] Known damaged indexes, counted from wire order.
+ * @returns {number} Number of symbols corrected.
+ * @throws {ChecksumError} If the damage exceeds the correction capacity.
+ */
+export declare function rsDecode(received: number[], eccLen: number, field: import('./galois-field.js').GaloisField, base?: number, erasures?: number[]): number;

package/src/ts/databar/codec.d.ts

@@ -0,0 +1,78 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+/** Calculate the GS1 modulo-10 check digit for a GTIN body. */
+export declare function gtinCheckDigit(body: any): string;
+/** Return a checked 14-digit GTIN, preserving only its standardized digits. */
+export declare function normalizeGTIN(value: any): string;
+/** Build a checked GTIN-14 from its thirteen-digit data body. */
+export declare function makeGTIN14(body: any): string;
+/**
+ * Compact a GTIN into the four values shared by Omnidirectional, Truncated,
+ * Stacked and Stacked Omnidirectional. The `physicalCharacters` sequence is
+ * left-to-right on a linear DataBar-14 row: 1, 2, 4, 3.
+ */
+export declare function encodeDataBar14GTIN(value: any, options?: {}): Readonly<{
+    gtin: string;
+    linkage: boolean;
+    symbolValue: bigint;
+    leftPair: bigint;
+    rightPair: bigint;
+    logicalCharacters: Readonly<{
+        outerLeft: number;
+        innerLeft: number;
+        outerRight: number;
+        innerRight: number;
+    }>;
+    physicalCharacters: readonly number[];
+}>;
+/** Reconstruct and validate a GTIN from the four DataBar-14 character values. */
+export declare function decodeDataBar14GTIN(values: any): Readonly<{
+    linkage: boolean;
+    gtin: string;
+    leftPair: bigint;
+    rightPair: bigint;
+}>;
+/** Compact a DataBar Limited-eligible GTIN into its two data character values. */
+export declare function encodeDataBarLimitedGTIN(value: any, options?: {}): Readonly<{
+    gtin: string;
+    linkage: boolean;
+    symbolValue: bigint;
+    left: number;
+    right: number;
+}>;
+/** Reconstruct and validate a GTIN from DataBar Limited data character values. */
+export declare function decodeDataBarLimitedGTIN(values: any): Readonly<{
+    linkage: boolean;
+    gtin: string;
+    symbolValue: bigint;
+}>;
+/** GS1 transmitted form for the GTIN-only DataBar variants. */
+export declare function dataBarGtinTransmission(value: any): string;

package/src/ts/databar/decoder.d.ts

@@ -0,0 +1,55 @@
+/*!
+ * 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.
+ */
+/** Decode a clean or integer-scaled 96-module DataBar-14 matrix. */
+export declare function decodeDataBar14(matrix: any): Readonly<{
+    format: "databar-omnidirectional";
+    text: string;
+    gtin: string;
+    linkage: boolean;
+    symbologyIdentifier: "]e0";
+}>;
+/**
+ * Decode GS1 DataBar-14 from one raster scanline. This is the image layer over
+ * the existing clean 96-module decoder; it recognizes both Omnidirectional
+ * and Truncated symbols because their horizontal pattern is identical.
+ *
+ * @param {Uint8Array} row
+ * @returns {{format:'gs1databar14', text:string, gtin:string, gs1:boolean, linkage:boolean, symbologyIdentifier:string, elements:Array}|null}
+ */
+export declare function decodeDataBar14Scanline(row: Uint8Array): {
+    format: 'gs1databar14';
+    text: string;
+    gtin: string;
+    gs1: boolean;
+    linkage: boolean;
+    symbologyIdentifier: string;
+    elements: any[];
+} | null;

package/src/ts/databar/encoder.d.ts

@@ -0,0 +1,34 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+/** GS1 DataBar Omnidirectional and Truncated encoder. @module databar/encoder */
+import { BitMatrix } from '../core/bit-matrix.js';
+/** Encode a checked GTIN as DataBar Omnidirectional or Truncated. */
+export declare function encodeDataBar14(value: any, options?: {}): BitMatrix;

package/src/ts/databar/gs1.d.ts

@@ -0,0 +1,48 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+export declare const GS1_SEPARATOR = "\u001D";
+export declare function gs1AIInfo(ai: any): {
+    ai: string;
+    length: number | boolean;
+    fixed: number | boolean;
+} | undefined;
+export declare function parseGS1ElementString(input: any): {
+    ai: any;
+    value: any;
+    fixed: number | boolean;
+}[];
+export declare function encodeGS1ElementString(input: any): string;
+export declare function decodeGS1ElementString(data: any): {
+    ai: any;
+    value: any;
+    fixed: number | boolean;
+}[];
+export declare function formatGS1Elements(elements: any): any;

package/src/ts/databar/index.d.ts

@@ -0,0 +1,37 @@
+/*!
+ * 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.
+ */
+/** Verified GS1 DataBar data-layer primitives. @module databar */
+export { dataBarGtinTransmission, decodeDataBar14GTIN, decodeDataBarLimitedGTIN, encodeDataBar14GTIN, encodeDataBarLimitedGTIN, gtinCheckDigit, makeGTIN14, normalizeGTIN, } from './codec.js';
+export { GS1_SEPARATOR, decodeGS1ElementString, encodeGS1ElementString, formatGS1Elements, gs1AIInfo, parseGS1ElementString, } from './gs1.js';
+export { DATABAR14_VARIANTS, DATABAR_LIMITED_VARIANT, dataBar14GroupFor, validateDataBarTables, } from './tables.js';
+export { encodeDataBar14 } from './encoder.js';
+export { decodeDataBar14, decodeDataBar14Scanline } from './decoder.js';
+export { DATABAR14_CHECKSUM_WEIGHTS, DATABAR14_FINDERS, dataBar14CharacterWidths, dataBar14ValueForWidths, dataBarWidths, } from './patterns.js';

package/src/ts/databar/patterns.d.ts

@@ -0,0 +1,46 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+/**
+ * Unrank one constrained positive composition.
+ *
+ * The rank is the GS1 DataBar symbol-character value inside its group. This
+ * implementation follows the combinatorial definition directly: it counts
+ * every remaining admissible suffix rather than storing third-party patterns.
+ */
+export declare function dataBarWidths(rank: any, modules: any, elements: any, maximumWidth: any, noNarrow: any): any[];
+/** Convert one DataBar-14 character value into its eight alternating widths. */
+export declare function dataBar14CharacterWidths(value: any, kind: any): any[];
+/** Recover a character value from its canonical eight-width representation. */
+export declare function dataBar14ValueForWidths(widths: any, kind: any): any;
+/** Nine finder patterns, expressed as normative five-element widths. */
+export declare const DATABAR14_FINDERS: readonly (readonly number[])[];
+/** Weight sequence generated as powers of three modulo 79. */
+export declare const DATABAR14_CHECKSUM_WEIGHTS: readonly number[];

package/src/ts/databar/tables.d.ts

@@ -0,0 +1,119 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+/** The four GTIN-only layouts sharing the DataBar-14 compaction rules. */
+export declare const DATABAR14_VARIANTS: Readonly<{
+    omnidirectional: Readonly<{
+        id: "omnidirectional";
+        rows: 1;
+        modules: 96;
+        checksumModulus: 79;
+        pointOfSale: true;
+    }>;
+    truncated: Readonly<{
+        id: "truncated";
+        rows: 1;
+        modules: 96;
+        checksumModulus: 79;
+        pointOfSale: false;
+    }>;
+    stacked: Readonly<{
+        id: "stacked";
+        rows: 2;
+        modules: 50;
+        checksumModulus: 79;
+        pointOfSale: false;
+    }>;
+    'stacked-omnidirectional': Readonly<{
+        id: "stacked-omnidirectional";
+        rows: 2;
+        modules: 50;
+        checksumModulus: 79;
+        pointOfSale: true;
+    }>;
+}>;
+/** GS1 DataBar Limited is a distinct two-character symbology. */
+export declare const DATABAR_LIMITED_VARIANT: Readonly<{
+    id: "limited";
+    rows: 1;
+    checksumModulus: 89;
+    pointOfSale: false;
+    permittedIndicatorDigits: readonly number[];
+}>;
+/** (16,4) outside character groups, ISO/IEC 24724:2011 Table 1. */
+export declare const DATABAR14_OUTSIDE_GROUPS: readonly Readonly<{
+    first: any;
+    last: any;
+    gsum: any;
+    oddModules: any;
+    evenModules: any;
+    oddWidest: any;
+    evenWidest: any;
+    oddTotal: any;
+    evenTotal: any;
+}>[];
+/** (15,4) inside character groups, ISO/IEC 24724:2011 Table 2. */
+export declare const DATABAR14_INSIDE_GROUPS: readonly Readonly<{
+    first: any;
+    last: any;
+    gsum: any;
+    oddModules: any;
+    evenModules: any;
+    oddWidest: any;
+    evenWidest: any;
+    oddTotal: any;
+    evenTotal: any;
+}>[];
+/** Number of values carried by an inside (15,4) character. */
+export declare const DATABAR14_INSIDE_RADIX = 1597;
+/** Number of values carried by one outside/inside character pair. */
+export declare const DATABAR14_PAIR_RADIX = 4537077;
+/** Stand-alone and composite DataBar-14 payload domain, including linkage. */
+export declare const DATABAR14_SYMBOL_LIMIT = 20000000000000n;
+/** GS1 DataBar Limited divides its 13 data digits into two character values. */
+export declare const DATABAR_LIMITED_PAIR_RADIX = 2013571;
+/** Offset that switches a DataBar Limited value from stand-alone to composite. */
+export declare const DATABAR_LIMITED_LINKAGE_OFFSET = 2015133531096n;
+/** DataBar Limited carries GTIN values whose first digit is zero or one. */
+export declare const DATABAR_LIMITED_DATA_LIMIT = 2000000000000n;
+/** Locate the value group that an outside or inside character belongs to. */
+export declare function dataBar14GroupFor(value: any, kind: any): Readonly<{
+    first: any;
+    last: any;
+    gsum: any;
+    oddModules: any;
+    evenModules: any;
+    oddWidest: any;
+    evenWidest: any;
+    oddTotal: any;
+    evenTotal: any;
+}>;
+/** Check the independently represented table identities. */
+export declare function validateDataBarTables(): string[];

package/src/ts/datamatrix/decoder.d.ts

@@ -0,0 +1,57 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+/**
+ * Data Matrix ECC 200 decoder for an already sampled symbol.
+ *
+ * The detector owns locating, perspective correction and orientation. This
+ * module starts with the complete, upright symbol including its finder borders.
+ * The table entry is deliberately read through a small normalizer so table data
+ * remains declarative: it needs total rows/columns, one data-region's rows and
+ * columns, data/ECC codeword counts, and either a block count or data block
+ * lengths. The standard 144x144 uneven data blocks are supported.
+ *
+ * @module datamatrix/decoder
+ */
+import { ChecksumError } from '../core/errors.js';
+export type DecodeResult = {
+    text: string;
+    bytes: Uint8Array;
+    correctedErrors: number;
+    symbol: object;
+};
+/**
+ * Decode an upright, sampled Data Matrix ECC 200 symbol.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix Full symbol, no quiet zone.
+ * @returns {{text: string, bytes: Uint8Array, correctedErrors: number, symbol: object}}
+ */
+export declare function decodeDataMatrix(matrix: import('../core/bit-matrix.js').BitMatrix): DecodeResult;
+export { ChecksumError };

package/src/ts/datamatrix/detector.d.ts

@@ -0,0 +1,59 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+export type Point = {
+    x: number;
+    y: number;
+};
+export type Detection = {
+    corners: Point[];
+    dimension: number;
+    width: number;
+    height: number;
+    moduleSize: number;
+    matrix: import('../core/bit-matrix.js').BitMatrix;
+};
+/**
+ * Find Data Matrix symbols in a binarized image.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage Set bit = dark.
+ * @returns {Detection | null} The strongest candidate, or null when absent.
+ */
+export declare function detectDataMatrix(binaryImage: import('../core/bit-matrix.js').BitMatrix): Detection | null;
+/**
+ * Detect and decode Data Matrix symbols.  Detection failure is normal for an
+ * image without a symbol, so candidates that cannot decode are skipped.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage
+ * @returns {(import("./decoder.js").DecodeResult & {corners: Point[]}) | null}
+ */
+export declare function detectAndDecodeDataMatrix(binaryImage: import('../core/bit-matrix.js').BitMatrix): (import("./decoder.js").DecodeResult & {
+    corners: Point[];
+}) | null;

package/src/ts/datamatrix/encoder.d.ts

@@ -0,0 +1,36 @@
+/*!
+ * 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-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+/** Data Matrix ECC 200 encoder: ASCII/Base256, RS interleaving and Annex F placement. */
+import { BitMatrix } from '../core/bit-matrix.js';
+/** Encode a string (ASCII mode) or byte payload (Base256) into Data Matrix ECC 200. */
+export declare function encodeDataMatrix(value: any, options?: {}): BitMatrix;
+/** Encode already compacted ASCII/Base256 codewords, primarily for conformance tests. */
+export declare function encodeDataMatrixCodewords(codewords: any, options?: {}): BitMatrix;