@sythos/js_barcode_universal 1.5.6 → 1.5.7

package/typings/frameqr/decoder.d.ts

@@ -0,0 +1,64 @@
+/*!
+ * 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.
+ */
+/** @param {unknown} profile @returns {boolean} */
+declare function isExpectedProfile(profile: unknown): boolean;
+/**
+ * Decode a FrameQR Code matrix.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} matrix
+ *   Square QR modules, normally returned by `encodeFrameQR` or a FrameQR
+ *   detector. The encoder's `frameqr` metadata is required by default.
+ * @param {object} [options]
+ * @param {object} [options.canvas] Explicit canvas metadata for a sampled
+ *   matrix when the source marker was not preserved.
+ * @param {string|object} [options.profile] Expected profile identifier.
+ * @param {boolean} [options.allowUnmarked=false] Explicit detector opt-in for
+ *   a matrix whose marker was lost during image sampling.
+ * @returns {import('../qr/decoder.js').DecodeResult & {
+ *   format: 'frameqr', profile: string, certified: false,
+ *   frame: object, canvas: object, canvasDamage: object
+ * }}
+ * @throws {FormatError} If the profile marker/canvas is invalid or the input
+ *   is an ordinary QR Code.
+ */
+export declare function decodeFrameQR(matrix: import('../core/bit-matrix.js').BitMatrix, options?: {
+    canvas?: object;
+    profile?: string | object;
+    allowUnmarked?: boolean;
+}): import('../qr/decoder.js').DecodeResult & {
+    format: 'frameqr';
+    profile: string;
+    certified: false;
+    frame: object;
+    canvas: object;
+    canvasDamage: object;
+};
+export { isExpectedProfile };

package/typings/frameqr/detector.d.ts

@@ -0,0 +1,96 @@
+/*!
+ * 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.
+ */
+import type { BitMatrix } from '../core/bit-matrix.js';
+export type Point = {
+    x: number;
+    y: number;
+};
+export type FrameQRDetection = {
+    /**
+     * Outer corners in reading order.
+     */
+    corners: Point[];
+    /**
+     * QR modules per side.
+     */
+    dimension: number;
+    /**
+     * QR Model 2 version.
+     */
+    version: number;
+    /**
+     * Estimated pixels per module.
+     */
+    moduleSize: number;
+    /**
+     * Clockwise in-plane orientation in degrees.
+     */
+    rotation: number;
+    /**
+     * Rectified profile matrix.
+     */
+    matrix: BitMatrix;
+    /**
+     * Normalized canvas specification.
+     */
+    canvas: object;
+    /**
+     * Profile identifier.
+     */
+    profile: string;
+    /**
+     * Always false for this implementation.
+     */
+    certified: false;
+};
+/**
+ * Detect FrameQR Code symbols in a binarized raster.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage Set bit = dark.
+ * @param {object} [options]
+ * @param {object} [options.canvas] Explicit canvas metadata for non-default
+ *   shapes/size. Without it, the profile's canonical centered square is used.
+ * @param {boolean} [options.voting=false] Use majority sampling per module.
+ * @returns {FrameQRDetection[]} Best candidate first; empty when no verified
+ *   profile signature is found.
+ */
+export declare function detectFrameQR(binaryImage: import('../core/bit-matrix.js').BitMatrix, options?: {
+    canvas?: object;
+    voting?: boolean;
+}): FrameQRDetection[];
+/**
+ * Detect and decode all verified Canvas QR symbols in one call.
+ *
+ * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage
+ * @param {object} [options]
+ * @returns {Array<object>}
+ */
+export declare function detectAndDecodeFrameQR(binaryImage: import('../core/bit-matrix.js').BitMatrix, options?: object): Array<object>;

package/typings/frameqr/encoder.d.ts

@@ -0,0 +1,73 @@
+/*!
+ * 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.
+ */
+export type FrameQrEncodeOptions = {
+    /**
+     * The profile always uses QR error correction H.
+     */
+    ecc?: 'H';
+    /**
+     * Force a QR version 1-40.
+     */
+    version?: number;
+    /**
+     * Force a QR mask 0-7.
+     */
+    mask?: number;
+    /**
+     * Byte mode interpretation.
+     */
+    charset?: 'auto' | 'utf-8' | 'iso-8859-1';
+    /**
+     * Allow QR kanji mode.
+     */
+    kanji?: boolean;
+    /**
+     * Profile artwork reservation.
+     */
+    canvas?: object;
+};
+/**
+ * Encode a QR Code with a conservative artwork canvas according to the
+ * non-certified FrameQR Code profile.
+ *
+ * The profile forces QR H error correction and rejects a canvas whenever its
+ * known codeword damage exceeds the per-block correction budget. When a
+ * version is not forced, the smallest QR version that holds both payload and
+ * safe canvas is selected. A decoder can reconstruct the reserved modules from
+ * the returned profile metadata.
+ *
+ * @param {string} text
+ * @param {FrameQrEncodeOptions} [options]
+ * @returns {import('../core/bit-matrix.js').BitMatrix}
+ * @throws {EncodeError} When the QR payload/options are invalid or the canvas
+ *   cannot safely fit the selected QR version.
+ */
+export declare function encodeFrameQR(text: string, options?: FrameQrEncodeOptions): import('../core/bit-matrix.js').BitMatrix;

package/typings/frameqr/index.d.ts

@@ -0,0 +1,34 @@
+/*!
+ * 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.
+ */
+export { encodeFrameQR } from './encoder.js';
+export { decodeFrameQR } from './decoder.js';
+export { detectFrameQR, detectAndDecodeFrameQR } from './detector.js';
+export { FRAMEQR_PROFILE, FRAMEQR_CANVAS_SHAPES, canvasModules, normalizeCanvasSpec, analyzeCanvasDamage, validateCanvasSpec, validateFrameQrTables, } from './tables.js';

package/typings/frameqr/tables.d.ts

@@ -0,0 +1,123 @@
+/*!
+ * 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.
+ */
+/** Public identity and compatibility boundary of the implementable profile. */
+export declare const FRAMEQR_PROFILE: Readonly<{
+    id: "sythos-canvas-qr/1";
+    name: "FrameQR Code";
+    certified: false;
+    densoFrameQrCompatible: false;
+    baseSymbology: "QR Code Model 2";
+    requiredEcc: "H";
+    standard: "ISO/IEC 18004 QR Code baseline";
+}>;
+/** Canvas shapes whose module membership is fully deterministic. */
+export declare const FRAMEQR_CANVAS_SHAPES: readonly string[];
+/**
+ * Canonicalise a canvas request.
+ *
+ * Coordinates and dimensions are module units. Odd dimensions make the centre
+ * unambiguous. Only quarter turns are accepted because arbitrary-angle raster
+ * membership would depend on renderer-specific sampling.
+ *
+ * @param {number} symbolSize QR module width/height (21..177).
+ * @param {object} [canvas]
+ * @returns {{shape:string,centerX:number,centerY:number,width:number,height:number,angle:number}}
+ */
+export declare function normalizeCanvasSpec(symbolSize: number, canvas?: object): {
+    shape: string;
+    centerX: number;
+    centerY: number;
+    width: number;
+    height: number;
+    angle: number;
+};
+/**
+ * Enumerate canvas modules, including any overlaps with QR function modules.
+ * A conforming encoder rejects such overlaps rather than damaging function
+ * patterns.
+ *
+ * @param {number} symbolSize
+ * @param {object} [canvas]
+ * @returns {Array<[number, number]>}
+ */
+export declare function canvasModules(symbolSize: number, canvas?: object): Array<[number, number]>;
+/**
+ * Calculate worst-case QR codeword damage caused by a canvas.
+ * A codeword is counted if any of its modules is touched. This is conservative:
+ * clearing an already-light module does no damage, but safety cannot depend on
+ * one payload or mask.
+ *
+ * @param {number} version QR version 1..40.
+ * @param {object} [canvas]
+ */
+export declare function analyzeCanvasDamage(version: number, canvas?: object): {
+    profile: "sythos-canvas-qr/1";
+    certified: boolean;
+    version: number;
+    symbolSize: number;
+    canvas: {
+        shape: string;
+        centerX: number;
+        centerY: number;
+        width: number;
+        height: number;
+        angle: number;
+    };
+    canvasModuleCount: number;
+    reservedOverlaps: [number, number][];
+    touchedCodewordCount: number;
+    touchedCodewordsByBlock: number[];
+    correctionBudgetPerBlock: number;
+    safe: boolean;
+};
+/** Validate a canvas and return the non-certifying structural analysis. */
+export declare function validateCanvasSpec(version: any, canvas?: {}): {
+    profile: "sythos-canvas-qr/1";
+    certified: boolean;
+    version: number;
+    symbolSize: number;
+    canvas: {
+        shape: string;
+        centerX: number;
+        centerY: number;
+        width: number;
+        height: number;
+        angle: number;
+    };
+    canvasModuleCount: number;
+    reservedOverlaps: [number, number][];
+    touchedCodewordCount: number;
+    touchedCodewordsByBlock: number[];
+    correctionBudgetPerBlock: number;
+    safe: boolean;
+};
+/** Self-check the fixed profile contract and representative QR geometries. */
+export declare function validateFrameQrTables(): string[];

package/typings/image/binarizer.d.ts

@@ -0,0 +1,85 @@
+/*!
+ * 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.
+ */
+/**
+ * Greyscale to black-and-white.
+ *
+ * This is the single biggest determinant of whether a reader works on real
+ * photographs. Decoding logic is exact and either right or wrong; binarization
+ * is a judgement call made a million times per image, and every downstream
+ * stage inherits its mistakes. A symbol lost here is lost permanently.
+ *
+ * Two strategies:
+ *
+ *   global  — one threshold for the whole image. Fast, and correct for clean
+ *             synthetic images: screenshots, generated PNGs, flat scans.
+ *   hybrid  — a threshold per 8x8 block, smoothed across neighbours. Handles
+ *             the uneven lighting that dominates camera input: shadows,
+ *             glare, vignetting, a page curving away from the lens.
+ *
+ * @module image/binarizer
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+/**
+ * One threshold for the entire image, chosen from the luminance histogram.
+ *
+ * Finds the two strongest peaks — ideally ink and paper — and cuts at the
+ * point of lowest population between them, weighted by distance so a narrow
+ * secondary peak does not drag the threshold onto a shoulder.
+ *
+ * @param {import('./luminance.js').LuminanceSource} source
+ * @returns {BitMatrix} Set bit = dark module.
+ */
+export declare function binarizeGlobal(source: import('./luminance.js').LuminanceSource): BitMatrix;
+/**
+ * Locally adaptive thresholding.
+ *
+ * Per 8x8 block: compute min, max and mean. A block with real contrast gets
+ * its own mean as the threshold. A block that is flat is ambiguous on its own
+ * — solid paper and solid ink look identical from the inside — so it inherits
+ * from its neighbourhood, which is what stops large quiet zones from being
+ * speckled into noise.
+ *
+ * Thresholds are then averaged over a 5x5 block window, so lighting gradients
+ * are followed smoothly instead of producing visible block seams that the
+ * detectors would read as edges.
+ *
+ * @param {import('./luminance.js').LuminanceSource} source
+ * @returns {BitMatrix}
+ */
+export declare function binarizeHybrid(source: import('./luminance.js').LuminanceSource): BitMatrix;
+/**
+ * Binarize with the named strategy.
+ *
+ * @param {import('./luminance.js').LuminanceSource} source
+ * @param {'global' | 'hybrid' | 'auto'} [strategy]
+ * @returns {BitMatrix}
+ */
+export declare function binarize(source: import('./luminance.js').LuminanceSource, strategy?: 'global' | 'hybrid' | 'auto'): BitMatrix;

package/typings/image/grid-sampler.d.ts

@@ -0,0 +1,82 @@
+/*!
+ * 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.
+ */
+/**
+ * Resample a distorted symbol in the image into an upright module grid.
+ *
+ * Given a transform that maps grid coordinates to image coordinates, this
+ * samples the centre of every module. Sampling centres rather than averaging
+ * whole cells is deliberate: module edges are where blur and bleed live, and
+ * including them turns a marginal symbol into an unreadable one.
+ *
+ * @module image/grid-sampler
+ */
+import { BitMatrix } from '../core/bit-matrix.js';
+import { PerspectiveTransform } from './perspective.js';
+/**
+ * Sample a `dimension` x `dimension` grid (or `width` x `height`).
+ *
+ * @param {BitMatrix} image Binarized source image.
+ * @param {number} width Modules across.
+ * @param {number} height Modules down.
+ * @param {PerspectiveTransform} transform Grid space -> image space.
+ * @returns {BitMatrix}
+ * @throws {NotFoundError} If the grid falls outside the image.
+ */
+export declare function sampleGrid(image: BitMatrix, width: number, height: number, transform: PerspectiveTransform): BitMatrix;
+/**
+ * Sample with a 3x3 majority vote per module.
+ *
+ * Slower, and worth it when a single-point sample lands on a speck of noise or
+ * a JPEG artefact. Readers fall back to this after a clean sample fails to
+ * decode, rather than paying for it on every attempt.
+ *
+ * @param {BitMatrix} image
+ * @param {number} width
+ * @param {number} height
+ * @param {PerspectiveTransform} transform
+ * @returns {BitMatrix}
+ */
+export declare function sampleGridVoting(image: BitMatrix, width: number, height: number, transform: PerspectiveTransform): BitMatrix;
+/**
+ * Build the transform for a symbol whose four corners are known, and sample it.
+ *
+ * Corners are in reading order: top-left, top-right, bottom-right, bottom-left.
+ *
+ * @param {BitMatrix} image
+ * @param {number} dimension Modules per side.
+ * @param {Array<{x: number, y: number}>} corners
+ * @param {boolean} [voting]
+ * @returns {BitMatrix}
+ */
+export declare function sampleQuad(image: BitMatrix, dimension: number, corners: Array<{
+    x: number;
+    y: number;
+}>, voting?: boolean): BitMatrix;

package/typings/image/index.d.ts

@@ -0,0 +1,39 @@
+/*!
+ * 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.
+ */
+/**
+ * Image pipeline, re-exported.
+ *
+ * @module image
+ */
+export { LuminanceSource } from './luminance.js';
+export { binarize, binarizeGlobal, binarizeHybrid } from './binarizer.js';
+export { PerspectiveTransform } from './perspective.js';
+export { sampleGrid, sampleGridVoting, sampleQuad } from './grid-sampler.js';