@sythos/js_barcode_universal 1.5.6 → 1.5.8

package/src/ts/micropdf417/detector.d.ts

@@ -0,0 +1,95 @@
+/*!
+ * 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.
+ */
+/**
+ * Axis-aligned MicroPDF417 raster detection.
+ *
+ * A MicroPDF417 symbol has a fixed module width for each column count and a
+ * dark leading and trailing module in every row.  Consequently the bounding
+ * rectangle of dark pixels identifies the complete symbol even when a light
+ * quiet zone surrounds it.  Its width determines the integer raster scale;
+ * the existing direct-module decoder then verifies every row-address pattern
+ * and selects the exact variant.  This is intentionally narrower than the
+ * PDF417 photo detector: it handles clean binarized rasters only, not skew or
+ * projective camera images.
+ *
+ * @module micropdf417/detector
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+import { decodeMicroPDF417 } from './decoder.js';
+export type Point = {
+    x: number;
+    y: number;
+};
+/**
+ * Detect and decode one clean, binarized MicroPDF417 raster.
+ *
+ * Integer upscaling and quiet zones are accepted. The image is retried at all
+ * quarter-turns, but arbitrary angles and perspective require caller-side
+ * rectification before this function is used. `rotation` reports the clockwise
+ * orientation of the supplied input relative to a normally oriented symbol;
+ * it is not the inverse correction applied internally while searching.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage Set bit = dark.
+ * @param {object} [options] Passed to {@link decodeMicroPDF417}.
+ * @returns {(ReturnType<typeof decodeMicroPDF417> & {matrix: BitMatrix, corners: Point[], moduleSize: number, rotation: number}) | null}
+ */
+export declare function detectMicroPDF417(binaryImage: import('../core/bit-matrix.js').BitMatrix, options?: object): (ReturnType<typeof decodeMicroPDF417> & {
+    matrix: BitMatrix;
+    corners: Point[];
+    moduleSize: number;
+    rotation: number;
+}) | null;
+/** Alias kept symmetric with the other 2D readers. */
+export declare function detectAndDecodeMicroPDF417(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: any;
+    columns: any;
+    variant: any;
+    eccCodewords: any;
+    rowHeight: number;
+    corrections: number;
+} & {
+    matrix: BitMatrix;
+    corners: Point[];
+    moduleSize: number;
+    rotation: number;
+}) | null;

package/src/ts/micropdf417/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.
+ */
+/** MicroPDF417 encoder. @module micropdf417/encoder */
+import { BitMatrix } from '../core/bit-matrix.js';
+/** Encode a value as one of the 34 fixed MicroPDF417 variants. */
+export declare function encodeMicroPDF417(value: any, options?: {}): BitMatrix;

package/src/ts/micropdf417/error-correction.d.ts

@@ -0,0 +1,38 @@
+/*!
+ * 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.
+ */
+/** Return the fixed number of parity codewords for a MicroPDF417 variant. */
+export declare function microPdf417EccLength(entry: any): any;
+/** Build the MicroPDF417 generator polynomial for a variant's fixed ECC length. */
+export declare function microPdf417Generator(entry: any): number[];
+/** Compute systematic MicroPDF417 parity codewords. `data` must already include padding. */
+export declare function microPdf417ErrorCorrection(data: any, entry: any): number[];
+/** Correct a complete MicroPDF417 codeword stream, optionally marking erasures. */
+export declare function microPdf417CorrectErrors(codewords: any, entry: any, erasures?: any[]): number;

package/src/ts/micropdf417/index.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.
+ */
+export { MICROPDF417_VARIANTS, microPdf417NextRap, microPdf417VariantByNumber, microPdf417VariantForCapacity, microPdf417RapSequence, microPdf417RowAddress, validateMicroPdf417Tables, } from './tables.js';
+export { microPdf417EccLength, microPdf417Generator, microPdf417ErrorCorrection, microPdf417CorrectErrors, } from './error-correction.js';
+export { compactMicroPDF417 } from './compaction.js';
+export { encodeMicroPDF417 } from './encoder.js';
+export { decodeMicroPDF417 } from './decoder.js';
+export { detectMicroPDF417, detectAndDecodeMicroPDF417 } from './detector.js';

package/src/ts/micropdf417/tables.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.
+ */
+/** All 34 predefined MicroPDF417 symbol variants, in format-table order. */
+export declare const MICROPDF417_VARIANTS: readonly Readonly<{
+    id: any;
+    columns: any;
+    rows: any;
+    totalCodewords: number;
+    dataCodewords: number;
+    eccCodewords: any;
+    rapStart: any;
+    rapRotation: any;
+}>[];
+/** @param {number} value @param {number} offset @returns {number} */
+export declare function microPdf417NextRap(value: number, offset?: number): number;
+/** @param {number} id @returns {Readonly<typeof MICROPDF417_VARIANTS[number]>} */
+export declare function microPdf417VariantByNumber(id: number): Readonly<typeof MICROPDF417_VARIANTS[number]>;
+/**
+ * Return the smallest data-region candidate that fits `codewords`.
+ * Ties are resolved by width, then height, so selection is deterministic.
+ */
+export declare function microPdf417VariantForCapacity(codewords: any): Readonly<{
+    id: any;
+    columns: any;
+    rows: any;
+    totalCodewords: number;
+    dataCodewords: number;
+    eccCodewords: any;
+    rapStart: any;
+    rapRotation: any;
+}>;
+/** Return the six bar/space run widths for a numbered side or center RAP. */
+export declare function microPdf417RapSequence(number: any, kind?: string): string;
+/**
+ * Resolve all row-address data for a zero-based row within a variant.
+ * @returns {{left: number, center: number|null, right: number, cluster: 0|3|6}}
+ */
+export declare function microPdf417RowAddress(entry: any, row: any): {
+    left: number;
+    center: number | null;
+    right: number;
+    cluster: 0 | 3 | 6;
+};
+/** Return any table-invariant failures; an empty result means the table is coherent. */
+export declare function validateMicroPdf417Tables(): string[];

package/src/ts/microqr/decoder.d.ts

@@ -0,0 +1,49 @@
+/*!
+ * 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.
+ */
+/**
+ * Micro QR decoder for an already sampled M1-M4 module matrix.
+ *
+ * @module microqr/decoder
+ */
+import { ChecksumError, FormatError } from '../core/errors.js';
+/** Decode a sampled Micro QR Code symbol without its quiet zone. */
+export declare function decodeMicroQR(matrix: any): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    mode: string;
+    version: any;
+    ecc: any;
+    mask: number;
+    corrections: number;
+    formatCorrections: number;
+    mirrored: any;
+};
+export { ChecksumError, FormatError };

package/src/ts/microqr/detector.d.ts

@@ -0,0 +1,96 @@
+/*!
+ * 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.
+ */
+/**
+ * Micro QR detection in binarized rasters.
+ *
+ * A Micro QR symbol has one 7x7 finder in its top-left corner. That alone is
+ * not enough to distinguish it from one corner of a normal QR Code, so every
+ * candidate is also required to have the Micro QR timing arms and a format
+ * word which the decoder accepts. The decoder is deliberately the final
+ * geometric arbiter; BCH and Reed--Solomon verification make accidental
+ * acceptance of ordinary square artwork very unlikely.
+ *
+ * Finder geometry supplies two local axes. Timing arms refine their lengths,
+ * while a small fourth-corner search lets projective sampling absorb mild
+ * perspective despite the format having no remote alignment pattern.
+ *
+ * @module microqr/detector
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+export type Point = {
+    x: number;
+    y: number;
+};
+export type Detection = {
+    /**
+     * Outer corners in reading order.
+     */
+    corners: Point[];
+    /**
+     * Side length in modules.
+     */
+    dimension: number;
+    version: 'M1' | 'M2' | 'M3' | 'M4';
+    /**
+     * Estimated pixels per module at the finder.
+     */
+    moduleSize: number;
+    /**
+     * Clockwise orientation of the source raster.
+     */
+    rotation: number;
+    /**
+     * Whether the detected symbol used inverted polarity.
+     */
+    inverted: boolean;
+    /**
+     * Rectified, normally polarised module matrix.
+     */
+    matrix: BitMatrix;
+};
+/**
+ * Find Micro QR symbols in a binarized raster.
+ *
+ * The search accepts arbitrary in-plane angles, including all quarter-turns.
+ * Non-integer scale is supported through centre sampling. Mild projective
+ * distortion is handled by searching the unconstrained fourth corner.
+ *
+ * @param {BitMatrix} binaryImage Set bit = dark.
+ * @returns {Detection[]} Best candidate first; empty when no symbol is found.
+ */
+export declare function detectMicroQR(binaryImage: BitMatrix): Detection[];
+/**
+ * Detect and decode all Micro QR symbols in a binarized raster.
+ *
+ * @param {BitMatrix} binaryImage
+ * @returns {Array<object>}
+ */
+export declare function detectAndDecodeMicroQR(binaryImage: BitMatrix): Array<object>;

package/src/ts/microqr/encoder.d.ts

@@ -0,0 +1,33 @@
+/*!
+ * 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 const MICROQR_ALPHANUMERIC = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:";
+export declare function encodeMicroQR(text: any, options?: {}): BitMatrix | undefined;

package/src/{microqr/index.js → ts/microqr/index.d.ts}

@@ -28,9 +28,7 @@
  *
  * Original work. No code from any other barcode implementation.
  */
-
 /** Micro QR Code M1-M4 public module surface. @module microqr */
-
 export { encodeMicroQR } from './encoder.js';
 export { decodeMicroQR } from './decoder.js';
 export { detectMicroQR, detectAndDecodeMicroQR } from './detector.js';

package/src/ts/microqr/tables.d.ts

@@ -0,0 +1,107 @@
+/*!
+ * 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.
+ */
+/** Numeric version identifiers used by the encoder selection loop. */
+export declare const MICROQR_VERSIONS: readonly number[];
+export declare const MICROQR_VERSION_NAMES: readonly string[];
+export declare const MICROQR_ECC_LEVELS: readonly string[];
+export declare const MICROQR_FORMAT_MASK = 17477;
+export declare const MICROQR_FORMAT_GENERATOR = 1335;
+/** The eight legal Micro QR version/error-correction combinations. */
+export declare const MICROQR_SYMBOLS: readonly Readonly<{
+    version: any;
+    ecc: any;
+    symbolNumber: any;
+    size: number;
+    totalCodewords: any;
+    dataCodewords: any;
+    dataBits: any;
+    eccCodewords: any;
+    blockCount: 1;
+    shortDataCodewordBits: number;
+    remainderBits: 0;
+}>[];
+/** @param {string|number} version @returns {number} */
+export declare function microQrVersionSize(version: string | number): number;
+/** Resolve the format symbol number for a legal version/ECC pair. */
+export declare function microQrSymbolNumber(version: any, ecc: any): any;
+/** Resolve the immutable single-block layout for a legal version/ECC pair. */
+export declare function microQrBlockLayout(version: any, ecc: any): Readonly<{
+    version: any;
+    ecc: any;
+    symbolNumber: any;
+    size: number;
+    totalCodewords: any;
+    dataCodewords: any;
+    dataBits: any;
+    eccCodewords: any;
+    blockCount: 1;
+    shortDataCodewordBits: number;
+    remainderBits: 0;
+}>;
+/** @returns {number} Usable message bits, including mode/count overhead. */
+export declare function microQrDataCapacityBits(version: any, ecc: any): number;
+/**
+ * Encode the five format data bits with BCH(15,5), then apply the Micro QR
+ * format mask. `symbolNumber` occupies the high three data bits and `mask`
+ * the low two.
+ */
+export declare function microQrFormatInfo(symbolNumber: any, mask: any, maybeMask: any): number;
+/** Decode/correct a 15-bit format word. Returns null beyond three errors. */
+export declare function microQrDecodeFormatInfo(bits: any): {
+    version: any;
+    ecc: any;
+    symbolNumber: any;
+    mask: number;
+    correctedBits: number;
+    bits: number;
+} | null;
+/**
+ * Format modules in bit-number order, least significant bit first. Bits 0..7
+ * run down column 8; bits 8..14 continue right-to-left along row 8.
+ * Position (8,8) is shared by the two arms and appears once.
+ */
+export declare function microQrFormatInfoPositions(sizeOrVersion: any): number[][];
+/**
+ * Fixed dark function modules before format information is written. Light
+ * separator and light timing modules remain unset; use
+ * {@link microQrReservedModules} to distinguish them from payload modules.
+ */
+export declare function microQrFunctionModules(version: any): any;
+/** Shared immutable-in-use map of finder, separator, timing and format modules. */
+export declare function microQrReservedModules(version: any): any;
+/** Number of modules carrying data or error-correction bits. */
+export declare function microQrFreeModuleCount(version: any): number;
+/** Payload module coordinates as interleaved x,y pairs, MSB-first stream order. */
+export declare function microQrDataModuleOrder(version: any): any;
+/** The four Micro QR data-mask predicates. */
+export declare function microQrMaskBit(mask: any, x: any, y: any): boolean;
+/** Return all internal table/geometry invariant failures. */
+export declare function validateMicroQrTables(): string[];