@sythos/js_barcode_universal 1.5.6 → 1.5.8

package/src/ts/render/index.d.ts

@@ -0,0 +1,110 @@
+/*!
+ * 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.
+ */
+/**
+ * Output backends.
+ *
+ * ## On GPU acceleration — read this before assuming what it does
+ *
+ * The WebGL2 and WebGPU backends accelerate **drawing** a barcode, not
+ * **computing** one. That distinction is worth stating plainly, because "GPU
+ * barcode generation" naturally sounds like the latter.
+ *
+ * Encoding is sequential integer work: Reed-Solomon polynomial division, mask
+ * penalty scoring, bit placement along a zig-zag path. Each step depends on the
+ * one before it, which is precisely the shape a GPU cannot exploit. A complete
+ * QR encode takes well under a millisecond on the CPU — less time than it takes
+ * to dispatch a compute shader and read the result back. Moving it to the GPU
+ * would make it slower, not faster, and no amount of engineering changes that.
+ *
+ * What the GPU genuinely helps with:
+ *
+ *   - **Drawing** large symbols, or many symbols per frame, straight into a
+ *     canvas without a CPU-side pixel buffer.
+ *   - **Reading**, where per-frame greyscale conversion and block statistics
+ *     over a 1080p or 4K camera image are the real bottleneck and are
+ *     embarrassingly parallel.
+ *
+ * So: encoding stays on the CPU because that is the correct engineering answer,
+ * not because of a missing feature.
+ *
+ * @module render
+ */
+export { toSVG, toSVGDataURI } from './svg.js';
+export { toImageData, toCanvas } from './image-data.js';
+export { toPNG, toPNGDataURI, deflateStored } from './png.js';
+export { isWebGL2Available, renderToCanvasWebGL } from './webgl.js';
+export { isWebGPUAvailable, renderToCanvasWebGPU } from './webgpu.js';
+export { normalizeOptions, parseColor } from './options.js';
+/**
+ * Draw into a canvas using the best backend available.
+ *
+ * Tries WebGL2, then the 2D context. The 2D path is always available, so this
+ * never fails on a browser that can run the library at all — including every
+ * version of Safari on iOS.
+ *
+ * WebGPU is not reachable from here, and cannot be: obtaining an adapter is
+ * asynchronous, so a synchronous function can never wait for one. Use
+ * `renderToCanvasAutoAsync` to include it. This one stays synchronous because
+ * it is the documented signature and callers rely on the returned backend name
+ * being available immediately.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {HTMLCanvasElement | OffscreenCanvas} canvas
+ * @param {import('./options.js').RenderOptions & {backend?: 'auto'|'webgl2'|'2d'}} [options]
+ * @returns {{backend: 'webgl2' | '2d' | 'none'}}
+ */
+export declare function renderToCanvasAuto(matrix: import('../core/bit-matrix.js').BitMatrix, canvas: HTMLCanvasElement | OffscreenCanvas, options?: import('./options.js').RenderOptions & {
+    backend?: 'auto' | 'webgl2' | '2d';
+}): {
+    backend: 'webgl2' | '2d' | 'none';
+};
+/**
+ * Draw into a canvas using the best backend available, including WebGPU.
+ *
+ * Tries WebGPU, then WebGL2, then the 2D context, and returns the name of the
+ * one that drew.
+ *
+ * Each backend is *probed* before the canvas is handed to it. That ordering is
+ * deliberate: a canvas can only ever have one kind of context, so committing it
+ * to WebGPU and failing afterwards would leave it unable to fall back to
+ * WebGL2 or 2D. The probes use throwaway objects of their own, so the caller's
+ * canvas is only touched by a backend that is already known to work.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {HTMLCanvasElement | OffscreenCanvas} canvas
+ * @param {import('./options.js').RenderOptions & {backend?: 'auto'|'webgpu'|'webgl2'|'2d'}} [options]
+ * @returns {Promise<{backend: 'webgpu' | 'webgl2' | '2d' | 'none'}>}
+ */
+export declare function renderToCanvasAutoAsync(matrix: import('../core/bit-matrix.js').BitMatrix, canvas: HTMLCanvasElement | OffscreenCanvas, options?: import('./options.js').RenderOptions & {
+    backend?: 'auto' | 'webgpu' | 'webgl2' | '2d';
+}): Promise<{
+    backend: 'webgpu' | 'webgl2' | '2d' | 'none';
+}>;

package/src/ts/render/options.d.ts

@@ -0,0 +1,98 @@
+/*!
+ * 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.
+ */
+/**
+ * Shared render options, normalised once so every backend agrees.
+ *
+ * @module render/options
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+export type RenderOptions = {
+    /**
+     * Pixels per module. Default 8.
+     */
+    scale?: number;
+    /**
+     * Quiet-zone modules on every side. Default 4.
+     */
+    margin?: number;
+    /**
+     * Colour of set modules. Default '#000000'.
+     */
+    dark?: string;
+    /**
+     * Colour of clear modules, or 'none' for transparent.
+     */
+    light?: string;
+    /**
+     * For 1D symbols: total bar height in pixels.
+     */
+    barHeight?: number;
+};
+/**
+ * @typedef {object} RenderOptions
+ * @property {number} [scale] Pixels per module. Default 8.
+ * @property {number} [margin] Quiet-zone modules on every side. Default 4.
+ * @property {string} [dark] Colour of set modules. Default '#000000'.
+ * @property {string} [light] Colour of clear modules, or 'none' for transparent.
+ * @property {number} [barHeight] For 1D symbols: total bar height in pixels.
+ */
+/**
+ * Expand and pad the matrix, and resolve every dimension.
+ *
+ * Linear symbols arrive one module tall. They are stretched to `barHeight`
+ * *before* the quiet zone is applied, so the margin ends up uniform on all
+ * four sides — padding first would leave a quiet zone one module tall against
+ * bars a hundred pixels tall, which no scanner would accept.
+ *
+ * @param {BitMatrix} matrix
+ * @param {RenderOptions} options
+ */
+export declare function normalizeOptions(matrix: BitMatrix, options?: RenderOptions): {
+    scale: number;
+    margin: number;
+    dark: string;
+    light: string;
+    is1D: boolean;
+    source: BitMatrix;
+    rowHeight: number;
+    pixelWidth: number;
+    pixelHeight: number;
+};
+/**
+ * Parse a CSS colour into RGBA bytes.
+ *
+ * Supports the forms a barcode actually needs: #rgb, #rgba, #rrggbb,
+ * #rrggbbaa, rgb(), rgba(), plus 'none' and 'transparent'.
+ *
+ * @param {string} colour
+ * @returns {[number, number, number, number]}
+ */
+export declare function parseColor(colour: string): [number, number, number, number];

package/src/ts/render/png.d.ts

@@ -0,0 +1,58 @@
+/*!
+ * 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.
+ */
+/**
+ * Wrap data in stored (type 00) deflate blocks with a zlib header.
+ *
+ * A stored block's length field is sixteen bits, so each block caps at 65535
+ * bytes and longer data must be split. BFINAL is set on the last block only —
+ * getting that wrong yields a stream that decodes correctly for any small
+ * image and truncates on the first large one.
+ *
+ * @param {Uint8Array} data
+ * @returns {Uint8Array}
+ */
+export declare function deflateStored(data: Uint8Array): Uint8Array;
+/**
+ * Render to a PNG file.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {import('./options.js').RenderOptions} [options]
+ * @returns {Promise<Uint8Array>}
+ */
+export declare function toPNG(matrix: import('../core/bit-matrix.js').BitMatrix, options?: import('./options.js').RenderOptions): Promise<Uint8Array>;
+/**
+ * Render to a data URI usable as an `<img>` src or a download href.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {import('./options.js').RenderOptions} [options]
+ * @returns {Promise<string>}
+ */
+export declare function toPNGDataURI(matrix: import('../core/bit-matrix.js').BitMatrix, options?: import('./options.js').RenderOptions): Promise<string>;

package/src/ts/render/svg.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.
+ */
+/**
+ * Render to an SVG document.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {import('./options.js').RenderOptions} [options]
+ * @returns {string}
+ */
+export declare function toSVG(matrix: import('../core/bit-matrix.js').BitMatrix, options?: import('./options.js').RenderOptions): string;
+/**
+ * Render to a data URI usable directly as an `<img>` src.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {import('./options.js').RenderOptions} [options]
+ * @returns {string}
+ */
+export declare function toSVGDataURI(matrix: import('../core/bit-matrix.js').BitMatrix, options?: import('./options.js').RenderOptions): string;

package/src/ts/render/webgl.d.ts

@@ -0,0 +1,45 @@
+/*!
+ * 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.
+ */
+/**
+ * Is WebGL2 usable here?
+ *
+ * @returns {boolean}
+ */
+export declare function isWebGL2Available(): boolean;
+/**
+ * Draw a matrix into a canvas with WebGL2.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {HTMLCanvasElement | OffscreenCanvas} canvas
+ * @param {import('./options.js').RenderOptions} [options]
+ * @returns {boolean} True if it drew; false means the caller should fall back.
+ */
+export declare function renderToCanvasWebGL(matrix: import('../core/bit-matrix.js').BitMatrix, canvas: HTMLCanvasElement | OffscreenCanvas, options?: import('./options.js').RenderOptions): boolean;

package/src/ts/render/webgpu.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.
+ */
+/**
+ * Is WebGPU usable here?
+ *
+ * Resolves false rather than throwing on every unsupported path, including
+ * Node, where there is no `navigator.gpu` at all.
+ *
+ * @returns {Promise<boolean>}
+ */
+export declare function isWebGPUAvailable(): Promise<boolean>;
+/**
+ * Draw a matrix into a canvas with WebGPU.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ * @param {HTMLCanvasElement | OffscreenCanvas} canvas
+ * @param {import('./options.js').RenderOptions} [options]
+ * @returns {Promise<boolean>} True if it drew; false means the caller should
+ *   fall back. Note that a canvas whose context has already been taken for
+ *   WebGPU cannot then be handed to WebGL2 or 2D, so callers should probe
+ *   availability before committing a canvas to this path.
+ */
+export declare function renderToCanvasWebGPU(matrix: import('../core/bit-matrix.js').BitMatrix, canvas: HTMLCanvasElement | OffscreenCanvas, options?: import('./options.js').RenderOptions): Promise<boolean>;

package/src/ts/rmqr/decoder.d.ts

@@ -0,0 +1,42 @@
+/*!
+ * 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';
+/** Decode an exact rMQR module matrix (without quiet zone). */
+export declare function decodeRMQR(matrix: any): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    version: number;
+    name: `R${number}x${number}`;
+    ecc: string;
+    mask: number;
+    corrections: number;
+};
+export { ChecksumError };

package/src/ts/rmqr/detector.d.ts

@@ -0,0 +1,81 @@
+/*!
+ * 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';
+/** Detect an axis-aligned, clean rMQR raster and return the exact module matrix. */
+export declare function detectRMQR(image: any, options?: {}): {
+    matrix: BitMatrix;
+    result: {
+        text: string;
+        bytes: Uint8Array<ArrayBuffer>;
+        version: number;
+        name: `R${number}x${number}`;
+        ecc: string;
+        mask: number;
+        corrections: number;
+    };
+    rotation: number;
+    corners: {
+        x: any;
+        y: any;
+        width: any;
+        height: any;
+    };
+    scale?: undefined;
+} | {
+    matrix: BitMatrix;
+    result: {
+        text: string;
+        bytes: Uint8Array<ArrayBuffer>;
+        version: number;
+        name: `R${number}x${number}`;
+        ecc: string;
+        mask: number;
+        corrections: number;
+    };
+    rotation: number;
+    scale: number;
+    corners: {
+        x: any;
+        y: any;
+        width: any;
+        height: any;
+    };
+};
+/** Detect and decode a raster in one call. */
+export declare function detectAndDecodeRMQR(image: any, options?: {}): {
+    text: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    version: number;
+    name: `R${number}x${number}`;
+    ecc: string;
+    mask: number;
+    corrections: number;
+};

package/src/ts/rmqr/encoder.d.ts

@@ -0,0 +1,45 @@
+/*!
+ * 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 ALPHANUMERIC_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:";
+declare const MODE: Readonly<{
+    TERMINATOR: 0;
+    NUMERIC: 1;
+    ALPHANUMERIC: 2;
+    BYTE: 3;
+    KANJI: 4;
+    FNC1: 5;
+    FNC1_SECOND: 6;
+    ECI: 7;
+}>;
+/** Encode text into a rMQR module matrix. */
+export declare function encodeRMQR(text: any, options?: {}): BitMatrix;
+export { MODE };

package/src/ts/rmqr/index.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 { encodeRMQR, ALPHANUMERIC_CHARS } from './encoder.js';
+export { decodeRMQR } from './decoder.js';
+export { detectRMQR, detectAndDecodeRMQR } from './detector.js';
+export { RMQR_SIZES, versionInfo, versionForSize, alignmentCoordinates, dataModuleOrder, functionModules, dataBitCapacity, formatBits, maskBit, validateTables, } from './tables.js';