@sythos/js_barcode_universal 1.5.6 → 1.5.7

package/typings/oned/writers.d.ts

@@ -0,0 +1,218 @@
+/*!
+ * 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.
+ */
+/**
+ * Linear barcode writers.
+ *
+ * Every writer returns a `BitMatrix` one module tall. Height is a rendering
+ * decision, not an encoding one — a linear symbol carries no information
+ * vertically, which is exactly why it survives a laser line that crosses it
+ * anywhere. The renderers stretch it via the `barHeight` option.
+ *
+ * @module oned/writers
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+/**
+ * Modulo-10 check digit for the EAN/UPC family.
+ *
+ * Weights alternate 3 and 1, with the digit immediately left of the check
+ * position weighted 3. Anchoring from the right rather than the left makes one
+ * routine correct for EAN-8, EAN-13 and UPC-A alike, despite their different
+ * payload lengths.
+ *
+ * @param {string} payload Digits, excluding the check digit.
+ * @returns {number}
+ */
+export declare function ean13CheckDigit(payload: string): number;
+/**
+ * EAN-13. Accepts 12 digits (check digit appended) or 13 (verified).
+ *
+ * @param {string} value
+ * @returns {BitMatrix}
+ */
+export declare function encodeEAN13(value: string): BitMatrix;
+/**
+ * EAN-8. Accepts 7 digits (check digit appended) or 8 (verified).
+ *
+ * @param {string} value
+ * @returns {BitMatrix}
+ */
+export declare function encodeEAN8(value: string): BitMatrix;
+/**
+ * ISBN, as its printed EAN-13 ("Bookland") symbol.
+ *
+ * ISBN is not a separate symbology — an ISBN barcode *is* an EAN-13 carrying a
+ * 978 or 979 prefix. What ISBN adds is its own numbering rules, and those are
+ * worth enforcing here: an ISBN-10 uses a modulo-**11** check digit, in which
+ * the value ten is written `X`. That is a different calculation from the
+ * modulo-10 check the EAN symbol will carry. Passing an ISBN-10 straight
+ * through would produce a perfectly scannable symbol encoding the wrong
+ * number, so the two checks are kept distinct and the digit is recomputed.
+ *
+ * Accepts ISBN-10 or ISBN-13, with or without hyphens and spaces.
+ *
+ * @param {string} value
+ * @returns {BitMatrix}
+ */
+export declare function encodeISBN(value: string): BitMatrix;
+/**
+ * UPC-A. Structurally an EAN-13 whose first digit is zero.
+ *
+ * @param {string} value 11 or 12 digits.
+ * @returns {BitMatrix}
+ */
+export declare function encodeUPCA(value: string): BitMatrix;
+/**
+ * Expand a UPC-E body to the 11 digits preceding the check digit.
+ *
+ * @param {number} system Number system, 0 or 1.
+ * @param {string} body 6 digits.
+ * @returns {string} 11 digits.
+ */
+export declare function upceToUpcaBody(system: number, body: string): string;
+/**
+ * UPC-E, the zero-suppressed form of UPC-A.
+ *
+ * @param {string} value 6 digits (system 0 assumed), 7 (system + body), or 8 (with check).
+ * @returns {BitMatrix}
+ */
+export declare function encodeUPCE(value: string): BitMatrix;
+/**
+ * Code 39.
+ *
+ * @param {string} value
+ * @param {object} [options]
+ * @param {boolean} [options.checkDigit] Append the modulo-43 check character.
+ * @param {boolean} [options.fullAscii] Escape characters outside the native set.
+ * @param {number} [options.wideRatio] Wide-to-narrow ratio, 2 or 3.
+ * @returns {BitMatrix}
+ */
+export declare function encodeCode39(value: string, options?: {
+    checkDigit?: boolean;
+    fullAscii?: boolean;
+    wideRatio?: number;
+}): BitMatrix;
+/**
+ * Code 93, always with its two mandatory check characters.
+ *
+ * @param {string} value
+ * @returns {BitMatrix}
+ */
+export declare function encodeCode93(value: string): BitMatrix;
+/**
+ * Code 128, with automatic code-set selection.
+ *
+ * The heuristic: switch into set C when enough consecutive digits are present
+ * to repay the switch symbol — four at the start or end of the payload, six in
+ * the middle, since C packs two digits per symbol. An encoder that never
+ * switches produces a valid but needlessly wide symbol.
+ *
+ * @param {string} value
+ * @param {object} [options]
+ * @param {boolean} [options.gs1] Emit a leading FNC1, making this GS1-128.
+ * @returns {BitMatrix}
+ */
+export declare function encodeCode128(value: string, options?: {
+    gs1?: boolean;
+}): BitMatrix;
+/**
+ * Interleaved 2 of 5.
+ *
+ * Digits are encoded in pairs: the first supplies the bars, the second the
+ * spaces between them. That interleaving is where the density comes from, and
+ * why the payload length must be even.
+ *
+ * @param {string} value
+ * @param {object} [options]
+ * @param {boolean} [options.checkDigit] Append a modulo-10 check digit.
+ * @param {number} [options.wideRatio]
+ * @returns {BitMatrix}
+ */
+export declare function encodeITF(value: string, options?: {
+    checkDigit?: boolean;
+    wideRatio?: number;
+}): BitMatrix;
+/**
+ * ITF-14, the shipping-container form: exactly 14 digits.
+ *
+ * @param {string} value 13 or 14 digits.
+ * @returns {BitMatrix}
+ */
+export declare function encodeITF14(value: string): BitMatrix;
+/**
+ * Codabar.
+ *
+ * @param {string} value Optionally already wrapped in start/stop characters A-D.
+ * @param {object} [options]
+ * @param {string} [options.start] One of A, B, C, D.
+ * @param {string} [options.stop]
+ * @param {number} [options.wideRatio]
+ * @returns {BitMatrix}
+ */
+export declare function encodeCodabar(value: string, options?: {
+    start?: string;
+    stop?: string;
+    wideRatio?: number;
+}): BitMatrix;
+/**
+ * Code 11, digits and hyphen.
+ *
+ * @param {string} value
+ * @param {object} [options]
+ * @param {boolean} [options.checkDigit] Append check character C, plus K when long.
+ * @param {number} [options.wideRatio]
+ * @returns {BitMatrix}
+ */
+export declare function encodeCode11(value: string, options?: {
+    checkDigit?: boolean;
+    wideRatio?: number;
+}): BitMatrix;
+/**
+ * MSI Plessey.
+ *
+ * @param {string} value Digits.
+ * @param {object} [options]
+ * @param {boolean} [options.checkDigit] Append the Luhn modulo-10 check digit.
+ * @returns {BitMatrix}
+ */
+export declare function encodeMSI(value: string, options?: {
+    checkDigit?: boolean;
+}): BitMatrix;
+/**
+ * Pharmacode, one-track.
+ *
+ * Unusual among linear symbologies: it encodes an integer directly in a
+ * bijective base-2 representation rather than digit by digit, and carries no
+ * check digit at all — its only redundancy is the narrow legal value range.
+ *
+ * @param {number | string} value 3 to 131070.
+ * @returns {BitMatrix}
+ */
+export declare function encodePharmacode(value: number | string): BitMatrix;

package/typings/pdf417/compaction.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.
+ */
+/** Compact a value using the PDF417 Text Compaction alphabet. */
+export declare function compactPdf417Text(value: any): any[];
+/** Compact bytes using latch 924 for exact six-byte blocks and 901 otherwise. */
+export declare function compactPdf417Bytes(value: any): number[];
+/** Compact decimal digits using latch 902 and groups of at most 44 digits. */
+export declare function compactPdf417Numeric(value: any): number[];
+/** Compact a single value, selecting text, numeric or byte mode. */
+export declare function compactPdf417(value: any, options?: {}): any[];
+/**
+ * Decode PDF417 compaction while preserving raw Byte Compaction and byte-shift
+ * payloads. Text and Numeric Compaction do not manufacture bytes: their text
+ * is available on each segment, while `bytes` contains only octets carried by
+ * modes that encode octets explicitly.
+ */
+export declare function decodePdf417CompactionDetailed(codewords: any): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    segments: {
+        mode: string;
+        text: string;
+        bytes: Uint8Array<ArrayBuffer>;
+        eci: number;
+        latch: any;
+        codewordStart: number;
+        codewordEnd: number;
+    }[];
+};
+/** Decode PDF417 Text, Byte, Numeric and UTF-8 ECI compaction segments in source order. */
+export declare function decodePdf417Compaction(codewords: any): string;

package/typings/pdf417/decoder.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 function decodePDF417(matrix: any, options?: {}): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    segments: {
+        mode: string;
+        text: string;
+        bytes: Uint8Array<ArrayBuffer>;
+        eci: number;
+        latch: any;
+        codewordStart: number;
+        codewordEnd: number;
+    }[];
+    codewords: number[];
+    rows: number;
+    columns: number;
+    eccLevel: number;
+    corrections: number;
+};

package/typings/pdf417/detector.d.ts

@@ -0,0 +1,73 @@
+/*!
+ * 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 declare function detectPDF417(binaryImage: any, options?: {}): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    segments: {
+        mode: string;
+        text: string;
+        bytes: Uint8Array<ArrayBuffer>;
+        eci: number;
+        latch: any;
+        codewordStart: number;
+        codewordEnd: number;
+    }[];
+    codewords: number[];
+    rows: number;
+    columns: number;
+    eccLevel: number;
+    corrections: number;
+    matrix: BitMatrix;
+    rotation: number;
+    corners: any;
+} | null;
+export declare function detectAndDecodePDF417(binaryImage: any, options?: {}): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    segments: {
+        mode: string;
+        text: string;
+        bytes: Uint8Array<ArrayBuffer>;
+        eci: number;
+        latch: any;
+        codewordStart: number;
+        codewordEnd: number;
+    }[];
+    codewords: number[];
+    rows: number;
+    columns: number;
+    eccLevel: number;
+    corrections: number;
+    matrix: BitMatrix;
+    rotation: number;
+    corners: any;
+} | null;

package/typings/pdf417/encoder.d.ts

@@ -0,0 +1,32 @@
+/*!
+ * 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 declare function encodePDF417(value: any, options?: {}): BitMatrix;

package/typings/pdf417/error-correction.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.
+ */
+export declare function pdf417EccLength(level: any): number;
+export declare function pdf417ErrorCorrection(data: any, level: any): number[];
+/** Correct PDF417 codewords, optionally marking unreadable codewords as erasures. */
+export declare function pdf417CorrectErrors(codewords: any, level: any, erasures?: any[]): number;

package/typings/pdf417/index.d.ts

@@ -0,0 +1,10 @@
+/*!
+ * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
+ * SPDX-License-Identifier: MIT
+ */
+export { compactPdf417, compactPdf417Text, compactPdf417Bytes, compactPdf417Numeric, decodePdf417Compaction, decodePdf417CompactionDetailed } from './compaction.js';
+export { encodePDF417 } from './encoder.js';
+export { decodePDF417 } from './decoder.js';
+export { detectPDF417, detectAndDecodePDF417 } from './detector.js';
+export { pdf417EccLength, pdf417ErrorCorrection, pdf417CorrectErrors } from './error-correction.js';
+export { PDF417_PATTERN_TABLE, PDF417_CLUSTER_NUMBERS, pdf417PatternForCodeword, pdf417CodewordForPattern } from './tables.js';

package/typings/pdf417/tables.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.
+ */
+/** PDF417 symbol-character pattern table. @module pdf417/tables */
+export declare const PDF417_CLUSTER_NUMBERS: readonly number[];
+export declare const PDF417_CODEWORDS_PER_CLUSTER = 929;
+/** Return the cluster discriminator for an eight-element bar/space sequence. */
+export declare function pdf417ClusterForWidths(widths: any): number;
+/** Pattern table indexed by cluster index (0, 1, 2) and codeword value. */
+export declare const PDF417_PATTERN_TABLE: readonly (readonly number[])[];
+/**
+ * Return the 17-bit bar/space pattern for a codeword in a row cluster.
+ * @param {number} codeword
+ * @param {number} cluster Cluster number 0, 3 or 6.
+ * @returns {number}
+ */
+export declare function pdf417PatternForCodeword(codeword: number, cluster: number): number;
+/**
+ * Decode an exact 17-bit symbol-character pattern to its codeword and cluster.
+ * @param {number} pattern
+ * @returns {{codeword: number, cluster: number} | null}
+ */
+export declare function pdf417CodewordForPattern(pattern: number): {
+    codeword: number;
+    cluster: number;
+} | null;

package/typings/qr/decoder.d.ts

@@ -0,0 +1,79 @@
+/*!
+ * 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 { ChecksumError } from '../core/errors.js';
+export type DecodeResult = {
+    /**
+     * Decoded payload.
+     */
+    text: string;
+    /**
+     * Raw bytes of the byte-mode segments; empty when
+     * the payload used no byte segments.
+     */
+    bytes: Uint8Array;
+    /**
+     * 1-40.
+     */
+    version: number;
+    /**
+     * 'L' | 'M' | 'Q' | 'H'.
+     */
+    ecc: string;
+    /**
+     * 0-7.
+     */
+    mask: number;
+    /**
+     * Symbols repaired by Reed-Solomon.
+     */
+    corrections: number;
+};
+/**
+ * @typedef {object} DecodeResult
+ * @property {string} text Decoded payload.
+ * @property {Uint8Array} bytes Raw bytes of the byte-mode segments; empty when
+ *   the payload used no byte segments.
+ * @property {number} version 1-40.
+ * @property {string} ecc 'L' | 'M' | 'Q' | 'H'.
+ * @property {number} mask 0-7.
+ * @property {number} corrections Symbols repaired by Reed-Solomon.
+ */
+/**
+ * Decode a sampled QR Code symbol.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix Square, exactly the
+ *   symbol, no quiet zone. Set bit = dark module.
+ * @returns {DecodeResult}
+ * @throws {FormatError} If the geometry or content is malformed.
+ * @throws {ChecksumError} If error correction cannot repair the symbol.
+ */
+export declare function decodeQR(matrix: import('../core/bit-matrix.js').BitMatrix): DecodeResult;
+export { ChecksumError };