@sythos/js_barcode_universal 1.5.6 → 1.5.8

package/src/ts/aztec/high-level.d.ts

@@ -0,0 +1,89 @@
+/*!
+ * 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.
+ */
+/**
+ * Aztec high-level stream writer.
+ *
+ * The output is deliberately a `BitWriter`, rather than a byte array: Aztec's
+ * text controls and binary-shift lengths are not byte aligned.  This module is
+ * also the boundary where JavaScript strings become UTF-8.  Passing a byte
+ * view bypasses that conversion and preserves every octet unchanged.
+ *
+ * The initial state mandated by the symbology is UPPER.  The greedy text pass
+ * uses UPPER, LOWER, DIGIT and PUNCT tables, selecting the shortest available
+ * latch at each byte.  Bytes without a text-table representation are emitted
+ * through the standard B/S (binary shift) escape.  B/S is available from
+ * UPPER and makes this a complete, lossless representation of UTF-8 payloads.
+ *
+ * @module aztec/high-level
+ */
+import { BitWriter } from '../core/bit-buffer.js';
+/** Aztec high-level table identifiers, exposed for decoder/API symmetry. */
+export declare const HIGH_LEVEL_MODE: Readonly<{
+    UPPER: 0;
+    LOWER: 1;
+    DIGIT: 2;
+    MIXED: 3;
+    PUNCT: 4;
+}>;
+/** Maximum number of bytes represented by one B/S escape. */
+export declare const MAX_BINARY_SHIFT = 2078;
+/**
+ * Convert accepted public input to its encoded octets.
+ *
+ * @param {string|ArrayBuffer|ArrayBufferView} value
+ * @param {'utf-8'} [charset]
+ * @returns {Uint8Array}
+ */
+export declare function aztecBytes(value: string | ArrayBuffer | ArrayBufferView, charset?: 'utf-8'): Uint8Array;
+/**
+ * Write an Aztec binary-shift segment while in UPPER mode.
+ *
+ * B/S is `11111`; its five-bit length directly covers 1..31 bytes.  A zero
+ * length selects the extended eleven-bit form, whose stored value is n - 31.
+ * Splitting at 2078 keeps each control representable and makes arbitrarily
+ * long byte input well-defined.
+ *
+ * @param {BitWriter} writer
+ * @param {Uint8Array} bytes
+ * @param {number} start
+ * @param {number} length
+ */
+export declare function writeBinaryShift(writer: BitWriter, bytes: Uint8Array, start: number, length: number): void;
+/**
+ * Build a valid Aztec high-level bitstream.
+ *
+ * @param {string|ArrayBuffer|ArrayBufferView} value
+ * @param {{charset?: 'utf-8'}} [options]
+ * @returns {BitWriter}
+ */
+export declare function encodeHighLevel(value: string | ArrayBuffer | ArrayBufferView, options?: {
+    charset?: 'utf-8';
+}): BitWriter;

package/src/ts/aztec/index.d.ts

@@ -0,0 +1,35 @@
+/*!
+ * 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.
+ */
+/** Aztec Code entry points. @module aztec */
+export { encodeAztec } from './encoder.js';
+export { decodeAztec } from './decoder.js';
+export { detectAztec, detectAndDecodeAztec } from './detector.js';
+export { AZTEC_COMPACT_LAYERS, AZTEC_FULL_LAYERS, AZTEC_LAYERS, AZTEC_DEFAULT_ECC_PERCENT, AZTEC_RS_GENERATOR_BASE, aztecLayer, aztecSymbolSize, validateAztecTables, } from './tables.js';

package/src/ts/aztec/tables.d.ts

@@ -0,0 +1,144 @@
+/*!
+ * 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.
+ */
+/** Reed-Solomon generator base defined for Aztec parameter and data fields. */
+export declare const AZTEC_RS_GENERATOR_BASE = 1;
+/** Minimum recommended error correction: 23 percent plus three codewords. */
+export declare const AZTEC_DEFAULT_ECC_PERCENT = 23;
+export declare const AZTEC_MIN_ECC_WORDS = 3;
+/** Word size selected solely by the number of layers. */
+export declare function wordSizeForLayers(layers: any): 6 | 8 | 10 | 12;
+/** Return the field used by Aztec codewords of `wordSize` bits. */
+export declare function fieldForWordSize(wordSize: any): import("../core/galois-field.js").GaloisField;
+/** Return the data field selected for a symbol with `layers` layers. */
+export declare function fieldForLayers(layers: any): import("../core/galois-field.js").GaloisField;
+/** Matrix side length, including Full-mode reference grid lines. */
+export declare function aztecSymbolSize(layers: any, compact?: boolean): number;
+/** Compact Aztec layers 1 through 4, in encoding preference order. */
+export declare const AZTEC_COMPACT_LAYERS: readonly Readonly<{
+    compact: any;
+    layers: any;
+    wordSize: 6 | 8 | 10 | 12;
+    totalBits: number;
+    usableBits: number;
+    totalCodewords: number;
+    maxDataCodewords: number;
+    baseMatrixSize: number;
+    symbolSize: number;
+    modeMessageDataWords: 2 | 4;
+    modeMessageWords: 7 | 10;
+    modeMessageBits: 28 | 40;
+    rsGeneratorBase: 1;
+}>[];
+/** Full Aztec layers 1 through 32, in ascending layer order. */
+export declare const AZTEC_FULL_LAYERS: readonly Readonly<{
+    compact: any;
+    layers: any;
+    wordSize: 6 | 8 | 10 | 12;
+    totalBits: number;
+    usableBits: number;
+    totalCodewords: number;
+    maxDataCodewords: number;
+    baseMatrixSize: number;
+    symbolSize: number;
+    modeMessageDataWords: 2 | 4;
+    modeMessageWords: 7 | 10;
+    modeMessageBits: 28 | 40;
+    rsGeneratorBase: 1;
+}>[];
+/** All allowed symbols. Compact entries precede Full entries for automatic selection. */
+export declare const AZTEC_LAYERS: readonly Readonly<{
+    compact: any;
+    layers: any;
+    wordSize: 6 | 8 | 10 | 12;
+    totalBits: number;
+    usableBits: number;
+    totalCodewords: number;
+    maxDataCodewords: number;
+    baseMatrixSize: number;
+    symbolSize: number;
+    modeMessageDataWords: 2 | 4;
+    modeMessageWords: 7 | 10;
+    modeMessageBits: 28 | 40;
+    rsGeneratorBase: 1;
+}>[];
+/** Return one immutable layer record. */
+export declare function aztecLayer(layers: any, compact?: boolean): Readonly<{
+    compact: any;
+    layers: any;
+    wordSize: 6 | 8 | 10 | 12;
+    totalBits: number;
+    usableBits: number;
+    totalCodewords: number;
+    maxDataCodewords: number;
+    baseMatrixSize: number;
+    symbolSize: number;
+    modeMessageDataWords: 2 | 4;
+    modeMessageWords: 7 | 10;
+    modeMessageBits: 28 | 40;
+    rsGeneratorBase: 1;
+}>;
+/**
+ * Calculate the minimum parity count for a data word count.
+ *
+ * The percentage is rounded up because a fractional codeword cannot be
+ * emitted. The mandatory three words protect short payloads, where a bare
+ * percentage would otherwise round to zero.
+ */
+export declare function eccCodewordsFor(dataCodewords: any, eccPercent?: number): number;
+/**
+ * Choose the first symbol which holds an already stuffed payload.
+ *
+ * `dataBits` must be a multiple of the candidate word size; callers which
+ * start from high-level bits must stuff separately per candidate word size.
+ */
+export declare function selectAztecLayer(dataBits: any, { eccPercent, layers, compact, }?: {
+    compact?: null | undefined;
+    eccPercent?: number | undefined;
+    layers?: null | undefined;
+}): Readonly<{
+    compact: any;
+    layers: any;
+    wordSize: 6 | 8 | 10 | 12;
+    totalBits: number;
+    usableBits: number;
+    totalCodewords: number;
+    maxDataCodewords: number;
+    baseMatrixSize: number;
+    symbolSize: number;
+    modeMessageDataWords: 2 | 4;
+    modeMessageWords: 7 | 10;
+    modeMessageBits: 28 | 40;
+    rsGeneratorBase: 1;
+    dataCodewords: number;
+    eccCodewords: number;
+}>;
+/** Check static identities so table corruption fails explicitly in tests. */
+export declare function validateAztecTables(): string[];

package/src/ts/aztecrune/decoder.d.ts

@@ -0,0 +1,56 @@
+/*!
+ * 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.
+ */
+/** @param {import('../core/bit-matrix.js').BitMatrix} matrix @param {boolean} inverted */
+declare function structureMatches(matrix: import('../core/bit-matrix.js').BitMatrix, inverted: boolean): boolean;
+/** @param {import('../core/bit-matrix.js').BitMatrix} matrix @param {boolean} inverted */
+declare function readCodewords(matrix: import('../core/bit-matrix.js').BitMatrix, inverted: boolean): number[];
+/**
+ * Decode a square Aztec Rune matrix.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {{inverted?: boolean|'auto', rotation?: number|'auto'}} [options]
+ * @returns {{format:'aztecrune',value:number,text:string,bytes:Uint8Array,dimension:number,inverted:boolean,rotation:number,corrections:number}}
+ * @throws {FormatError} For non-Rune geometry, structure or uncorrectable data.
+ */
+export declare function decodeAztecRune(matrix: import('../core/bit-matrix.js').BitMatrix, options?: {
+    inverted?: boolean | 'auto';
+    rotation?: number | 'auto';
+}): {
+    format: 'aztecrune';
+    value: number;
+    text: string;
+    bytes: Uint8Array;
+    dimension: number;
+    inverted: boolean;
+    rotation: number;
+    corrections: number;
+};
+export { readCodewords, structureMatches };

package/src/ts/aztecrune/detector.d.ts

@@ -0,0 +1,53 @@
+/*!
+ * 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.
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+export type Point = {
+    x: number;
+    y: number;
+};
+/**
+ * Detect the most prominent Aztec Rune in a binarized image.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage
+ * @returns {{corners:Point[],dimension:11,moduleSize:number,matrix:BitMatrix,result:object}|null}
+ */
+export declare function detectAztecRune(binaryImage: import('../core/bit-matrix.js').BitMatrix): {
+    corners: Point[];
+    dimension: 11;
+    moduleSize: number;
+    matrix: BitMatrix;
+    result: object;
+} | null;
+/** Detect and decode one Aztec Rune, or return `null` when none is verified. */
+export declare function detectAndDecodeAztecRune(binaryImage: any): {
+    corners: Point[];
+    moduleSize: number;
+} | null;

package/src/ts/aztecrune/encoder.d.ts

@@ -0,0 +1,51 @@
+/*!
+ * 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.
+ */
+/** @param {unknown} value @returns {number} */
+export declare function normalizeAztecRuneValue(value: unknown): number;
+/** @param {number} value @returns {number[]} */
+declare function codewordsForValue(value: number): number[];
+/**
+ * Encode one byte as an Aztec Rune.
+ *
+ * @param {number|string|ArrayBuffer|ArrayBufferView} value
+ * @param {{inverted?: boolean}} [options]
+ * @returns {import('../core/bit-matrix.js').BitMatrix & {
+ *   format: 'aztecrune', value: number, inverted: boolean
+ * }}
+ */
+export declare function encodeAztecRune(value: number | string | ArrayBuffer | ArrayBufferView, options?: {
+    inverted?: boolean;
+}): import('../core/bit-matrix.js').BitMatrix & {
+    format: 'aztecrune';
+    value: number;
+    inverted: boolean;
+};
+export { codewordsForValue };

package/src/ts/aztecrune/index.d.ts

@@ -0,0 +1,35 @@
+/*!
+ * 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.
+ */
+/** Aztec Rune entry points. @module aztecrune */
+export { encodeAztecRune, normalizeAztecRuneValue } from './encoder.js';
+export { decodeAztecRune } from './decoder.js';
+export { detectAztecRune, detectAndDecodeAztecRune } from './detector.js';
+export { AZTEC_RUNE_SIZE, AZTEC_RUNE_DATA_BITS, AZTEC_RUNE_WORD_SIZE, AZTEC_RUNE_DATA_CODEWORDS, AZTEC_RUNE_ECC_CODEWORDS, AZTEC_RUNE_TOTAL_CODEWORDS, AZTEC_RUNE_MASK, AZTEC_RUNE_DATA_POSITIONS, aztecRuneStructuralValue, buildAztecRuneStructure, aztecRuneField, validateAztecRuneTables, } from './tables.js';

package/src/ts/aztecrune/tables.d.ts

@@ -0,0 +1,75 @@
+/*!
+ * 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.
+ */
+/**
+ * Aztec Rune geometry.
+ *
+ * Aztec Rune is the 11x11, one-byte member of the Aztec family. Two 4-bit
+ * data words and five 4-bit Reed-Solomon check words are XORed with the fixed
+ * Aztec Rune mask and written clockwise on the outer data ring. The finder and
+ * corner orientation marks are independent of the value.
+ *
+ * The constants below are derived from the public Aztec Code specification and
+ * are kept separate from the general Aztec implementation so a normal Aztec
+ * decoder can never accidentally treat an 11x11 Rune as a regular symbol.
+ *
+ * @module aztecrune/tables
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+export declare const AZTEC_RUNE_SIZE = 11;
+export declare const AZTEC_RUNE_DATA_BITS = 8;
+export declare const AZTEC_RUNE_WORD_SIZE = 4;
+export declare const AZTEC_RUNE_DATA_CODEWORDS = 2;
+export declare const AZTEC_RUNE_ECC_CODEWORDS = 5;
+export declare const AZTEC_RUNE_TOTAL_CODEWORDS: number;
+export declare const AZTEC_RUNE_MASK = 10;
+/**
+ * Data-module coordinates in wire order: clockwise, starting at the top.
+ * Every side contributes seven modules, for 28 bits in total.
+ */
+export declare const AZTEC_RUNE_DATA_POSITIONS: readonly (readonly number[])[];
+/** @param {number} x @param {number} y @returns {boolean} */
+export declare function isAztecRuneDataPosition(x: number, y: number): boolean;
+/**
+ * Return the value of a structural module. Data positions return `null`.
+ * The bull's-eye has five square rings including its one-module centre; its
+ * even-radius rings are dark. The four corner groups are the orientation marks
+ * described by the Aztec Rune specification.
+ *
+ * @param {number} x @param {number} y
+ * @returns {boolean|null}
+ */
+export declare function aztecRuneStructuralValue(x: number, y: number): boolean | null;
+/** Build only the fixed finder/orientation structure. */
+export declare function buildAztecRuneStructure(): BitMatrix;
+/** Return the field used by Rune data/check words. */
+export declare function aztecRuneField(): import("../core/galois-field.js").GaloisField;
+/** Validate the fixed Rune contract and coordinate layout. */
+export declare function validateAztecRuneTables(): string[];

package/src/ts/bundle/sythos-barcode.d.ts

@@ -0,0 +1,31 @@
+/*!
+ * 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 * from '../index.js';

package/src/ts/bundle/sythos-barcode.esm.d.ts

@@ -0,0 +1,31 @@
+/*!
+ * 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 * from '../index.js';

package/src/ts/compactpdf417/decoder.d.ts

@@ -0,0 +1,64 @@
+/*!
+ * 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.
+ */
+/**
+ * Decode a compact/truncated PDF417 module matrix.
+ *
+ * The high-level payload uses the normal PDF417 Text/Byte/Numeric compaction
+ * rules. This function only changes the physical row parser: no right row
+ * indicator is expected and the final module of each row must be dark.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {object} [options]
+ * @param {number} [options.rowHeight]
+ */
+export declare function decodeCompactPDF417(matrix: import('../core/bit-matrix.js').BitMatrix, options?: {
+    rowHeight?: number;
+}): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    segments: {
+        mode: string;
+        text: string;
+        bytes: Uint8Array<ArrayBuffer>;
+        eci: number;
+        latch: any;
+        codewordStart: number;
+        codewordEnd: number;
+    }[];
+    format: string;
+    compact: boolean;
+    codewords: number[];
+    rows: number;
+    columns: number;
+    eccLevel: number;
+    rowHeight: any;
+    corrections: number;
+};