@scanly/core 2.0.0

package/dist/qr/region-detection.js

@@ -0,0 +1,129 @@
+const PADDING_RATIOS = {
+    tight: 0.05,
+    medium: 0.12,
+    expanded: 0.22,
+};
+/** Clamp a rectangle to image bounds. */
+export function clampRect(rect, width, height) {
+    const x = Math.max(0, Math.min(width - 1, Math.floor(rect.x)));
+    const y = Math.max(0, Math.min(height - 1, Math.floor(rect.y)));
+    const maxW = width - x;
+    const maxH = height - y;
+    const w = Math.max(1, Math.min(maxW, Math.floor(rect.width)));
+    const h = Math.max(1, Math.min(maxH, Math.floor(rect.height)));
+    return { x, y, width: w, height: h };
+}
+/** Expand a rect by relative padding, then clamp to bounds (edge-safe). */
+export function applyCropPadding(rect, imageWidth, imageHeight, padding) {
+    const ratio = PADDING_RATIOS[padding];
+    const padX = Math.round(rect.width * ratio);
+    const padY = Math.round(rect.height * ratio);
+    return clampRect({
+        x: rect.x - padX,
+        y: rect.y - padY,
+        width: rect.width + padX * 2,
+        height: rect.height + padY * 2,
+    }, imageWidth, imageHeight);
+}
+/** Intersection-over-union of two rects. */
+export function iou(a, b) {
+    const x1 = Math.max(a.x, b.x);
+    const y1 = Math.max(a.y, b.y);
+    const x2 = Math.min(a.x + a.width, b.x + b.width);
+    const y2 = Math.min(a.y + a.height, b.y + b.height);
+    const iw = Math.max(0, x2 - x1);
+    const ih = Math.max(0, y2 - y1);
+    const inter = iw * ih;
+    if (inter <= 0)
+        return 0;
+    const union = a.width * a.height + b.width * b.height - inter;
+    return union <= 0 ? 0 : inter / union;
+}
+/** Non-maximum suppression for scored regions. */
+export function nonMaximumSuppression(regions, iouThreshold = 0.45, maxKeep = 5) {
+    const sorted = [...regions].sort((a, b) => b.score - a.score);
+    const kept = [];
+    for (const candidate of sorted) {
+        if (kept.length >= maxKeep)
+            break;
+        const overlaps = kept.some((k) => iou(k, candidate) >= iouThreshold);
+        if (!overlaps)
+            kept.push(candidate);
+    }
+    return kept.map((r, index) => ({ ...r, index }));
+}
+/**
+ * Edge-density grid scan returning top-N candidate regions on the preview image.
+ * Coordinates are in preview pixel space.
+ */
+export function detectCandidateRegions(image, options) {
+    const { data, width, height } = image;
+    const gridSize = options?.gridSize ?? 20;
+    const windowCells = options?.windowCells ?? 5;
+    const maxRaw = options?.maxRaw ?? 24;
+    const cellW = Math.max(1, Math.floor(width / gridSize));
+    const cellH = Math.max(1, Math.floor(height / gridSize));
+    const raw = [];
+    for (let gy = 0; gy <= gridSize - windowCells; gy++) {
+        options?.budget?.throwIfExceeded("region-scoring");
+        for (let gx = 0; gx <= gridSize - windowCells; gx++) {
+            let density = 0;
+            for (let dy = 0; dy < windowCells; dy++) {
+                for (let dx = 0; dx < windowCells; dx++) {
+                    const cx = (gx + dx) * cellW;
+                    const cy = (gy + dy) * cellH;
+                    const px = Math.min(Math.floor(cx + cellW / 2), width - 1);
+                    const py = Math.min(Math.floor(cy + cellH / 2), height - 1);
+                    const idx = (py * width + px) * 4;
+                    const gray = (data[idx] + data[idx + 1] + data[idx + 2]) / 3;
+                    if (px < width - 1) {
+                        const rIdx = (py * width + px + 1) * 4;
+                        const right = (data[rIdx] + data[rIdx + 1] + data[rIdx + 2]) / 3;
+                        density += Math.abs(gray - right);
+                    }
+                    if (py < height - 1) {
+                        const dIdx = ((py + 1) * width + px) * 4;
+                        const down = (data[dIdx] + data[dIdx + 1] + data[dIdx + 2]) / 3;
+                        density += Math.abs(gray - down);
+                    }
+                }
+            }
+            if (density > 800) {
+                raw.push({
+                    x: gx * cellW,
+                    y: gy * cellH,
+                    width: windowCells * cellW,
+                    height: windowCells * cellH,
+                    score: density,
+                    index: -1,
+                });
+            }
+        }
+    }
+    raw.sort((a, b) => b.score - a.score);
+    return nonMaximumSuppression(raw.slice(0, maxRaw), 0.45, options?.maxRaw ? Math.min(8, options.maxRaw) : 5);
+}
+/** Scale a preview-space rect to original image coordinates. */
+export function scaleRectToOriginal(rect, previewScale) {
+    const inv = 1 / previewScale;
+    return {
+        x: Math.floor(rect.x * inv),
+        y: Math.floor(rect.y * inv),
+        width: Math.floor(rect.width * inv),
+        height: Math.floor(rect.height * inv),
+    };
+}
+/** Crop a region from a pixel buffer. */
+export function cropBuffer(src, rect, budget) {
+    const r = clampRect(rect, src.width, src.height);
+    const out = new Uint8ClampedArray(r.width * r.height * 4);
+    for (let y = 0; y < r.height; y++) {
+        if ((y & 31) === 0)
+            budget?.throwIfExceeded("candidate-crop");
+        const srcStart = ((r.y + y) * src.width + r.x) * 4;
+        const dstStart = y * r.width * 4;
+        out.set(src.data.subarray(srcStart, srcStart + r.width * 4), dstStart);
+    }
+    return { data: out, width: r.width, height: r.height };
+}
+//# sourceMappingURL=region-detection.js.map

package/dist/qr/region-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-detection.js","sourceRoot":"","sources":["../../src/qr/region-detection.ts"],"names":[],"mappings":"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"}

package/dist/qr/result-normalizer.d.ts

@@ -0,0 +1,9 @@
+import type { DecodedCode } from "./types.js";
+export type ResultDeduplicationPolicy = "payload" | "payload-format" | "payload-format-spatial" | "tracked-instance";
+/** Deduplicate semantic results while preserving geometry-proven physical instances. */
+export declare function dedupeResults(results: DecodedCode[], policy?: ResultDeduplicationPolicy): DecodedCode[];
+/** True if string looks like http(s) URL. */
+export declare function looksLikeUrl(s: string): boolean;
+/** Normalize whitespace-only payloads to empty failure candidates. */
+export declare function normalizePayload(payload: string): string;
+//# sourceMappingURL=result-normalizer.d.ts.map

package/dist/qr/result-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-normalizer.d.ts","sourceRoot":"","sources":["../../src/qr/result-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,gBAAgB,GAAG,wBAAwB,GAAG,kBAAkB,CAAC;AAsBrH,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,GAAE,yBAAoD,GAAG,WAAW,EAAE,CAmBjI;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/qr/result-normalizer.js

@@ -0,0 +1,70 @@
+import { iou } from "./region-detection.js";
+function bounds(result) {
+    if (!result.cornerPoints?.length)
+        return null;
+    const xs = result.cornerPoints.map((point) => point.x);
+    const ys = result.cornerPoints.map((point) => point.y);
+    const x = Math.min(...xs);
+    const y = Math.min(...ys);
+    return { x, y, width: Math.max(1, Math.max(...xs) - x), height: Math.max(1, Math.max(...ys) - y) };
+}
+function samePhysicalInstance(left, right) {
+    const a = bounds(left);
+    const b = bounds(right);
+    if (!a || !b)
+        return true;
+    const overlap = iou(a, b);
+    if (overlap >= 0.55)
+        return true;
+    const ax = a.x + a.width / 2;
+    const ay = a.y + a.height / 2;
+    const bx = b.x + b.width / 2;
+    const by = b.y + b.height / 2;
+    const areaRatio = Math.min(a.width * a.height, b.width * b.height) / Math.max(a.width * a.height, b.width * b.height);
+    const distance = Math.hypot(ax - bx, ay - by);
+    return overlap >= 0.25 && areaRatio >= 0.5 && distance <= Math.min(Math.hypot(a.width, a.height), Math.hypot(b.width, b.height)) * 0.35;
+}
+/** Deduplicate semantic results while preserving geometry-proven physical instances. */
+export function dedupeResults(results, policy = "payload-format-spatial") {
+    if (policy === "tracked-instance")
+        throw new Error("tracked-instance requires a temporal tracking operator.");
+    const out = [];
+    for (const r of results) {
+        const duplicate = out.some((prior) => {
+            if (prior.payload !== r.payload)
+                return false;
+            if (policy !== "payload" && (prior.format ?? "qr_code") !== (r.format ?? "qr_code"))
+                return false;
+            return policy === "payload-format-spatial" ? samePhysicalInstance(prior, r) : true;
+        });
+        if (duplicate)
+            continue;
+        out.push(r);
+    }
+    return out.sort((a, b) => {
+        const ab = bounds(a);
+        const bb = bounds(b);
+        if (ab && bb)
+            return (ab.y - bb.y) || (ab.x - bb.x) || (a.attemptIndex - b.attemptIndex);
+        if (ab)
+            return -1;
+        if (bb)
+            return 1;
+        return a.attemptIndex - b.attemptIndex;
+    });
+}
+/** True if string looks like http(s) URL. */
+export function looksLikeUrl(s) {
+    try {
+        const u = new URL(s);
+        return u.protocol === "http:" || u.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/** Normalize whitespace-only payloads to empty failure candidates. */
+export function normalizePayload(payload) {
+    return payload.replace(/\u0000/g, "").trimEnd();
+}
+//# sourceMappingURL=result-normalizer.js.map

package/dist/qr/result-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-normalizer.js","sourceRoot":"","sources":["../../src/qr/result-normalizer.ts"],"names":[],"mappings":"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"}

package/dist/qr/rotate.d.ts

@@ -0,0 +1,5 @@
+import type { PixelBuffer, RotationDegrees } from "./types.js";
+import type { ExecutionBudget } from "../runtime/execution-budget.js";
+/** Rotate RGBA buffer by 0/90/180/270 degrees clockwise. */
+export declare function rotateBuffer(src: PixelBuffer, degrees: RotationDegrees, budget?: ExecutionBudget): PixelBuffer;
+//# sourceMappingURL=rotate.d.ts.map

package/dist/qr/rotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotate.d.ts","sourceRoot":"","sources":["../../src/qr/rotate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,CAgD9G"}

package/dist/qr/rotate.js

@@ -0,0 +1,51 @@
+/** Rotate RGBA buffer by 0/90/180/270 degrees clockwise. */
+export function rotateBuffer(src, degrees, budget) {
+    if (degrees === 0) {
+        return { data: new Uint8ClampedArray(src.data), width: src.width, height: src.height };
+    }
+    const { width: w, height: h, data } = src;
+    if (degrees === 180) {
+        const out = new Uint8ClampedArray(data.length);
+        for (let y = 0; y < h; y++) {
+            if ((y & 31) === 0)
+                budget?.throwIfExceeded("rotate-180");
+            for (let x = 0; x < w; x++) {
+                const si = (y * w + x) * 4;
+                const di = ((h - 1 - y) * w + (w - 1 - x)) * 4;
+                out[di] = data[si];
+                out[di + 1] = data[si + 1];
+                out[di + 2] = data[si + 2];
+                out[di + 3] = data[si + 3];
+            }
+        }
+        return { data: out, width: w, height: h };
+    }
+    const outW = h;
+    const outH = w;
+    const out = new Uint8ClampedArray(outW * outH * 4);
+    for (let y = 0; y < h; y++) {
+        if ((y & 31) === 0)
+            budget?.throwIfExceeded("rotate");
+        for (let x = 0; x < w; x++) {
+            const si = (y * w + x) * 4;
+            let dx;
+            let dy;
+            if (degrees === 90) {
+                dx = h - 1 - y;
+                dy = x;
+            }
+            else {
+                // 270
+                dx = y;
+                dy = w - 1 - x;
+            }
+            const di = (dy * outW + dx) * 4;
+            out[di] = data[si];
+            out[di + 1] = data[si + 1];
+            out[di + 2] = data[si + 2];
+            out[di + 3] = data[si + 3];
+        }
+    }
+    return { data: out, width: outW, height: outH };
+}
+//# sourceMappingURL=rotate.js.map

package/dist/qr/rotate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotate.js","sourceRoot":"","sources":["../../src/qr/rotate.ts"],"names":[],"mappings":"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"}

package/dist/qr/types.d.ts

@@ -0,0 +1,186 @@
+import type { BarcodeFormat } from "@scanly/scenario-schema";
+import type { EngineOutcome } from "../contracts/engine.js";
+import type { ExecutionBudget } from "../runtime/execution-budget.js";
+import type { FrameMemoryBudget } from "../runtime/memory-budget.js";
+import type { EngineDiagnostic } from "../contracts/result.js";
+/** Shared pixel buffer compatible with browser ImageData and Node raw buffers. */
+export interface PixelBuffer {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+}
+export type NonEmptyArray<T> = [T, ...T[]];
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ScoredRegion extends Rect {
+    score: number;
+    index: number;
+}
+export type PreprocessMethod = "original" | "grayscale" | "contrast" | "gamma" | "invert" | "threshold-115" | "threshold-140" | "threshold-165" | "otsu" | "sharpen";
+/** Engine ids are plugin-defined and intentionally not a closed union. */
+export type DecoderName = string;
+export type ScaleLabel = "original" | "downscaled" | "upscaled" | "full";
+export type CropPadding = "tight" | "medium" | "expanded";
+export type RotationDegrees = 0 | 90 | 180 | 270;
+export type DecodeErrorReason = "invalid_file" | "invalid_image" | "invalid_configuration" | "unsupported_image" | "no_qr_found" | "timeout" | "cancelled" | "worker_error" | "worker_initialization_failure" | "empty_image" | "image_too_large" | "camera_permission_denied" | "camera_not_found" | "camera_busy" | "camera_constraint_failed" | "camera_track_ended" | "camera_capability_unsupported" | "camera_recovery_failed" | "browser_background_suspended" | "no_camera" | "unsupported_format" | "engine_initialization_failure" | "engine_execution_failure";
+export interface DecodeAttempt {
+    candidateIndex: number;
+    candidateScore: number;
+    cropPadding: CropPadding | "full";
+    preprocessing: PreprocessMethod;
+    scale: ScaleLabel;
+    scaleFactor: number;
+    rotation: RotationDegrees;
+    decoder: DecoderName;
+    elapsedMs: number;
+    success: boolean;
+}
+export interface DecodedCode {
+    payload: string;
+    format?: BarcodeFormat;
+    /** Decoder-provided bytes; absent when the selected decoder cannot expose them. */
+    rawBytes?: Uint8Array;
+    decoder: DecoderName;
+    engineVersion?: string;
+    engineMetadata?: import("../contracts/engine.js").EngineExecutionMetadata;
+    cornerPoints?: Array<{
+        x: number;
+        y: number;
+    }>;
+    symbologyIdentifier?: string;
+    isGs1?: boolean;
+    metadata?: Record<string, unknown>;
+    preprocessing: PreprocessMethod;
+    candidateIndex: number;
+    scale: ScaleLabel;
+    rotation: RotationDegrees;
+    /** Engine-provided symbol orientation normalized to the original frame. */
+    symbolOrientation?: number;
+    cropPadding: CropPadding | "full";
+    attemptIndex: number;
+    /** Internal wall-clock offset used to report time to first result. */
+    foundAtMs?: number;
+}
+export interface DecodeSuccess {
+    ok: true;
+    results: NonEmptyArray<DecodedCode>;
+    /** Primary result — first unique successful decode. */
+    primary: DecodedCode;
+    attempts: DecodeAttempt[];
+    attemptCount: number;
+    elapsedMs: number;
+    timeToFirstResultMs?: number;
+    cancelled: boolean;
+    engineDiagnostics?: EngineDiagnostic[];
+    phaseTiming?: PhaseTiming;
+}
+export interface DecodeFailure {
+    ok: false;
+    reason: DecodeErrorReason;
+    message: string;
+    attempts: DecodeAttempt[];
+    attemptCount: number;
+    elapsedMs: number;
+    cancelled: boolean;
+    engineDiagnostics?: EngineDiagnostic[];
+    phaseTiming?: PhaseTiming;
+}
+export type DecodeOutcome = DecodeSuccess | DecodeFailure;
+export interface DecoderConfig {
+    /** Plugin ids, in deterministic aggregation order. */
+    order: DecoderName[];
+    execution: "sequential" | "parallel";
+    failurePolicy?: "success-wins" | "required-engine-fails" | "any-engine-fails";
+}
+export interface PhaseTiming {
+    frameNormalizationMs?: number;
+    roiMs?: number;
+    localizationMs?: number;
+    candidateGenerationMs: number;
+    candidateDeduplicationMs?: number;
+    preprocessMs: number;
+    rotationMs: number;
+    validationMs?: number;
+    semanticParsingMs?: number;
+    workerTransferMs?: number;
+    workerSetupMs?: number;
+    cancellationLatencyMs?: number;
+    engineMs?: Record<string, number>;
+}
+export interface DecodeProgress {
+    attemptCount: number;
+}
+export interface PipelineConfig {
+    /** Explicit public formats passed to every engine attempt. Defaults to QR-only. */
+    formats: BarcodeFormat[];
+    maxCandidates: number;
+    maxAttempts: number;
+    timeoutMs: number;
+    maxPixels: number;
+    previewSize: number;
+    findMultiple: boolean;
+    maxMultipleResults: number;
+    resultDeduplication: "payload" | "payload-format" | "payload-format-spatial" | "tracked-instance";
+    scales: number[];
+    paddings: CropPadding[];
+    rotations: RotationDegrees[];
+    /** Ordered preprocess methods tried per candidate/scale/rotation combo (subset). */
+    preprocessOrder: PreprocessMethod[];
+    decoders: DecoderConfig;
+    /** When native fallbacks enter the graph. Fast uses final; richer profiles use after-cheap. */
+    fallbackTiming?: "after-cheap" | "final";
+    /** Benchmark: all payloads that must appear for a full pass. */
+    requiredPayloads?: string[];
+    /** Benchmark: stop once this many unique payloads are found. */
+    expectedResultCount?: number;
+    /** Stop after this many consecutive candidates without a new payload (multiple mode). */
+    stallCandidateLimit?: number;
+    multiCodeStallPolicy?: MultiCodeStallPolicy;
+    /** After this many failed attempts with no decode, skip heavy phases. */
+    failFastAfterAttempts?: number;
+    enableLocalization?: boolean;
+    enableFullImageFallback?: boolean;
+    enableSplitImageFallback?: boolean;
+    enableGridImageFallback?: boolean;
+    /** Bounded per-frame retained preprocessing cache; never global. */
+    maxIntermediateAllocations?: number;
+    maxIntermediateBytes?: number;
+}
+export interface DecodePipelineOptions {
+    signal?: AbortSignal;
+    config?: Partial<PipelineConfig>;
+    onStage?: (stage: string) => void;
+    onProgress?: (progress: DecodeProgress) => void;
+    /** If true, run on main thread (Node/tests). Browser upload uses Worker. */
+    forceMainThread?: boolean;
+    /** Required dependency-inverted engine boundary. */
+    engineExecutor?: PipelineEngineExecutor;
+    /** Internal graph path: candidates generated by upstream operators. */
+    candidates?: import("./candidate-generation.js").CandidateImage[];
+    /** Shared Router deadline/cancellation context. */
+    executionBudget?: ExecutionBudget;
+    /** Shared logical retained-buffer accounting for this frame. */
+    memoryBudget?: FrameMemoryBudget;
+}
+export interface MultiCodeStallPolicy {
+    maximumAttemptsWithoutNewResult: number;
+    minimumCandidateCoverageBeforeStop: number;
+    requireAllPrimaryCandidatesVisited: boolean;
+}
+export interface PipelineEngineExecutor {
+    readonly engineIds: readonly string[];
+    readonly versions?: Readonly<Record<string, string>>;
+    decode(engineId: string, image: PixelBuffer, options: {
+        formats: readonly BarcodeFormat[];
+        signal?: AbortSignal;
+        findMultiple: boolean;
+        inversion?: "unknown" | "original" | "inverted";
+    }): Promise<EngineOutcome>;
+}
+export declare const DEFAULT_PIPELINE_CONFIG: PipelineConfig;
+export declare function validatePipelineConfig(config: PipelineConfig): string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/qr/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/qr/types.ts"],"names":[],"mappings":"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"}

package/dist/qr/types.js

@@ -0,0 +1,67 @@
+export const DEFAULT_PIPELINE_CONFIG = {
+    formats: ["qr_code"],
+    maxCandidates: 5,
+    maxAttempts: 96,
+    timeoutMs: 12_000,
+    maxPixels: 4_000_000,
+    previewSize: 400,
+    findMultiple: true,
+    maxMultipleResults: 8,
+    resultDeduplication: "payload-format-spatial",
+    scales: [1, 0.7, 1.35],
+    paddings: ["medium", "expanded", "tight"],
+    rotations: [0, 90, 180, 270],
+    preprocessOrder: [
+        "original",
+        "contrast",
+        "invert",
+        "otsu",
+        "threshold-140",
+        "gamma",
+        "sharpen",
+        "threshold-115",
+        "threshold-165",
+    ],
+    decoders: { order: [], execution: "sequential", failurePolicy: "success-wins" },
+    fallbackTiming: "final",
+    stallCandidateLimit: 12,
+    failFastAfterAttempts: 48,
+    enableLocalization: true,
+    enableFullImageFallback: true,
+    enableSplitImageFallback: true,
+    enableGridImageFallback: true,
+    maxIntermediateAllocations: 24,
+    maxIntermediateBytes: 64 * 1024 * 1024,
+};
+export function validatePipelineConfig(config) {
+    const issues = [];
+    if (!Array.isArray(config.formats) || config.formats.length === 0)
+        issues.push("formats must contain at least one public barcode format.");
+    for (const key of ["maxCandidates", "maxAttempts", "timeoutMs", "maxPixels", "previewSize", "maxMultipleResults", "maxIntermediateAllocations", "maxIntermediateBytes"]) {
+        const value = config[key];
+        if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < 1)
+            issues.push(`${key} must be a positive integer.`);
+    }
+    if (config.scales.length === 0 || config.scales.some((scale) => !Number.isFinite(scale) || scale <= 0 || scale > 4))
+        issues.push("scales must contain finite values greater than 0 and at most 4.");
+    if (config.paddings.length === 0)
+        issues.push("paddings must not be empty.");
+    if (config.rotations.length === 0)
+        issues.push("rotations must not be empty.");
+    if (config.preprocessOrder.length === 0)
+        issues.push("preprocessOrder must not be empty.");
+    if (!Array.isArray(config.decoders.order) || config.decoders.order.length === 0)
+        issues.push("decoders.order must contain at least one registered engine id.");
+    if (config.decoders.execution !== "sequential" && config.decoders.execution !== "parallel")
+        issues.push("decoders.execution must be sequential or parallel.");
+    if (config.multiCodeStallPolicy) {
+        if (!Number.isInteger(config.multiCodeStallPolicy.maximumAttemptsWithoutNewResult) || config.multiCodeStallPolicy.maximumAttemptsWithoutNewResult < 1)
+            issues.push("multiCodeStallPolicy.maximumAttemptsWithoutNewResult must be a positive integer.");
+        if (!Number.isFinite(config.multiCodeStallPolicy.minimumCandidateCoverageBeforeStop) || config.multiCodeStallPolicy.minimumCandidateCoverageBeforeStop < 0 || config.multiCodeStallPolicy.minimumCandidateCoverageBeforeStop > 1)
+            issues.push("multiCodeStallPolicy.minimumCandidateCoverageBeforeStop must be between 0 and 1.");
+        if (typeof config.multiCodeStallPolicy.requireAllPrimaryCandidatesVisited !== "boolean")
+            issues.push("multiCodeStallPolicy.requireAllPrimaryCandidatesVisited must be boolean.");
+    }
+    return issues;
+}
+//# sourceMappingURL=types.js.map

package/dist/qr/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/qr/types.ts"],"names":[],"mappings":"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"}

package/dist/qr/zxing-decoder.d.ts

@@ -0,0 +1,8 @@
+import type { PixelBuffer } from "./types.js";
+export interface ZXingDecodeResult {
+    payload: string;
+    rawBytes?: Uint8Array;
+}
+/** Decode QR from RGBA pixel buffer using ZXing library (works in Node and browser). */
+export declare function decodeWithZXing(buffer: PixelBuffer): ZXingDecodeResult | null;
+//# sourceMappingURL=zxing-decoder.d.ts.map

package/dist/qr/zxing-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zxing-decoder.d.ts","sourceRoot":"","sources":["../../src/qr/zxing-decoder.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AASD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI,CAoB7E"}

package/dist/qr/zxing-decoder.js

@@ -0,0 +1,33 @@
+import { BinaryBitmap, HybridBinarizer, RGBLuminanceSource, DecodeHintType, BarcodeFormat, QRCodeReader, } from "@zxing/library";
+let reader = null;
+function getReader() {
+    if (!reader)
+        reader = new QRCodeReader();
+    return reader;
+}
+/** Decode QR from RGBA pixel buffer using ZXing library (works in Node and browser). */
+export function decodeWithZXing(buffer) {
+    if (buffer.width < 1 || buffer.height < 1)
+        return null;
+    try {
+        const luminance = new Uint8ClampedArray(buffer.width * buffer.height);
+        for (let i = 0, j = 0; i < buffer.data.length; i += 4, j++) {
+            luminance[j] = (buffer.data[i] * 0.299 + buffer.data[i + 1] * 0.587 + buffer.data[i + 2] * 0.114) | 0;
+        }
+        const source = new RGBLuminanceSource(luminance, buffer.width, buffer.height);
+        const bitmap = new BinaryBitmap(new HybridBinarizer(source));
+        const hints = new Map();
+        hints.set(DecodeHintType.POSSIBLE_FORMATS, [BarcodeFormat.QR_CODE]);
+        hints.set(DecodeHintType.TRY_HARDER, true);
+        const result = getReader().decode(bitmap, hints);
+        const text = result?.getText();
+        if (!text)
+            return null;
+        const rawBytes = result.getRawBytes();
+        return { payload: text, ...(rawBytes?.byteLength ? { rawBytes } : {}) };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=zxing-decoder.js.map

package/dist/qr/zxing-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zxing-decoder.js","sourceRoot":"","sources":["../../src/qr/zxing-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AAQxB,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC,SAAS,SAAS;IAChB,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IACzC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3D,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxG,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}