@hexpro/qr-code-studio 0.0.0-stage → 0.1.1

package/dist/verify/preset.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Presets under the scan check: the smallest print size each one scans at,
+ * and the verifier the conformance gate plugs into `checkPreset`.
+ *
+ * A preset promises that a design works, so it is checked with three
+ * contents (a short link, a link with a path and a query, and a long one)
+ * because a design that suits a version 2 symbol can fail at version 7,
+ * where the same logo or shape meets more, smaller modules. "Scans at a
+ * size" means: nothing fails, the clean captures read, every axis holds up
+ * to its everyday level, and the print size check itself passes. Warnings
+ * about the design as such (light on dark, red ink) do not depend on the
+ * size and are left to the full report.
+ */
+import type { Preset, DesignRegistries } from '../design/types.js';
+import type { EcLevel } from '../segment/types.js';
+import type { RunOptions } from './job.js';
+import type { CaptureAxis, VerifyRegistries, VerifyReport } from './types.js';
+/** The contents every preset is calibrated and gated with: synthetic, as every test content is. */
+export declare const PRESET_CONTENT: Readonly<{
+    small: "https://example.com/";
+    medium: "https://example.com/menu/table-12?from=poster";
+    large: "https://example.com/events/2026/spring-market/stall-holders/register?ref=window-poster&lang=en-AU&utm_source=print";
+}>;
+export type ContentSize = keyof typeof PRESET_CONTENT;
+/**
+ * The margin added to the smallest size that passed, to make `minSizeMm`:
+ * a tenth of it, and at least two millimetres. Print shops trim and scale,
+ * and eight seeded captures are a sample of the photographs people take,
+ * not all of them.
+ */
+export declare function withMargin(passedMm: number): number;
+/** Whether a report counts as scanning at its size, in the sense above. */
+/**
+ * A shortfall a preset is known to have at every size: an axis that gives
+ * out before its everyday level, or the clean capture itself, measured and
+ * recorded (tests/verify/shortfalls.ts) so the gate holds the preset to
+ * everything else and notices the day it is no longer true.
+ */
+export type Shortfall = CaptureAxis | 'baseline';
+export declare function scansAtSize(report: VerifyReport, allowed?: readonly Shortfall[]): boolean;
+/** What a report falls short on at its everyday levels: the axes, and the clean capture. */
+export declare function shortfalls(report: VerifyReport): Shortfall[];
+export interface PresetRunOptions extends RunOptions {
+    /** Seeded captures per level, 1 to 8. */
+    readonly seeds?: number;
+    /** Seed for the job: the same for every size, so sizes differ only in size. */
+    readonly seed?: number;
+    /** Shortfalls each preset is known to have at every size, by preset id. */
+    readonly known?: Readonly<Record<string, readonly Shortfall[]>>;
+    /** The level to calibrate at; default the preset's own. */
+    readonly ecLevel?: EcLevel;
+}
+/**
+ * The options a preset's runs take: with a recorded distance shortfall, the
+ * distance axis is left out. Its refusal would otherwise feed the print size
+ * check (a design that seems to need ten pixels a module asks for a print
+ * large enough to hold ten comfortably), so the size would grow to cover the
+ * very shortfall the record exists to keep visible. Without the axis, the
+ * size check assumes what any reader needs.
+ */
+export declare function presetOptions(preset: Preset, options: PresetRunOptions): PresetRunOptions;
+/** The report for one preset, content and level at one size. */
+export declare function presetReport(preset: Preset, content: string, sizeMm: number, ecLevel: EcLevel, registries: VerifyRegistries, options?: PresetRunOptions): VerifyReport;
+export interface Calibration {
+    readonly id: string;
+    /** The level the sizes are for. A contract addition. */
+    readonly level: EcLevel;
+    /** The smallest size, in whole millimetres, at which each content scanned; null when none did up to the limit. */
+    readonly passedMm: Readonly<Record<ContentSize, number | null>>;
+    /** The largest of those plus the margin; null when any content never scanned. */
+    readonly minSizeMm: number | null;
+}
+/** The most the climb ever goes to, in millimetres. */
+export declare const CALIBRATION_LIMIT_MM = 120;
+/**
+ * The size past which a larger print changes nothing but the distances in
+ * millimetres: the phone no longer has to stay back to focus, so every
+ * capture is the same picture. A design still failing there fails at every
+ * size. `modulesAcross` is the code and its quiet zone, which the phone
+ * frames and the size measures.
+ */
+export declare function saturationMm(modulesAcross: number): number;
+/** The smallest whole millimetre size, of `modulesAcross` modules, a phone can resolve a module at, at all. */
+export declare function floorMm(modulesAcross: number): number;
+/**
+ * The smallest whole millimetre size at which `preset` scans with each
+ * content at its own level (or `options.ecLevel`), climbing 1 mm at a time from the smallest size a
+ * phone can resolve at all. A content that still fails one millimetre past
+ * the size where larger stops helping (see `saturationMm`) never passes, and
+ * nor does any larger content after it.
+ */
+export declare function calibratePreset(preset: Preset, registries: VerifyRegistries, options?: PresetRunOptions): Calibration;
+/** What the conformance gate collects: the same shape as its own `Violation`. */
+export interface PresetViolation {
+    readonly entry: string;
+    readonly rule: string;
+    readonly detail: string;
+}
+export interface PresetVerifierOptions extends PresetRunOptions {
+    /** Every level the preset allows, or only the level its design asks for. Default 'design'. */
+    readonly levels?: 'design' | 'all';
+}
+/**
+ * The strict scan check as `checkPreset`'s hook: every content at the
+ * preset's own level and size (or at every level it allows, each at its own
+ * size, `presetSizeMm`).
+ */
+export declare function presetVerifier(options?: PresetVerifierOptions): (preset: Preset, registries: DesignRegistries) => readonly PresetViolation[];
+/** What went wrong, for a developer reading a test failure. */
+export declare function describe(report: VerifyReport): string;
+//# sourceMappingURL=preset.d.ts.map

package/dist/verify/preset.d.ts.map

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

package/dist/verify/preset.js

@@ -0,0 +1,200 @@
+/**
+ * Presets under the scan check: the smallest print size each one scans at,
+ * and the verifier the conformance gate plugs into `checkPreset`.
+ *
+ * A preset promises that a design works, so it is checked with three
+ * contents (a short link, a link with a path and a query, and a long one)
+ * because a design that suits a version 2 symbol can fail at version 7,
+ * where the same logo or shape meets more, smaller modules. "Scans at a
+ * size" means: nothing fails, the clean captures read, every axis holds up
+ * to its everyday level, and the print size check itself passes. Warnings
+ * about the design as such (light on dark, red ink) do not depend on the
+ * size and are left to the full report.
+ */
+import { presetSizeMm } from '../design/preset-size.js';
+import { createSymbologyRegistry } from '../symbology/registry.js';
+import { CAMERA, minModuleMm, pxPerModuleAt } from './camera.js';
+import { LADDERS, framingPxPerModule } from './ladders.js';
+import { runPrepared } from './job.js';
+import { prepare } from './prepare.js';
+/** The contents every preset is calibrated and gated with: synthetic, as every test content is. */
+export const PRESET_CONTENT = Object.freeze({
+    small: 'https://example.com/',
+    medium: 'https://example.com/menu/table-12?from=poster',
+    large: 'https://example.com/events/2026/spring-market/stall-holders/register?ref=window-poster&lang=en-AU&utm_source=print',
+});
+/**
+ * The margin added to the smallest size that passed, to make `minSizeMm`:
+ * a tenth of it, and at least two millimetres. Print shops trim and scale,
+ * and eight seeded captures are a sample of the photographs people take,
+ * not all of them.
+ */
+export function withMargin(passedMm) {
+    return Math.ceil(passedMm + Math.max(2, passedMm * 0.1));
+}
+export function scansAtSize(report, allowed = []) {
+    if (report.checks.some((check) => check.status === 'fail'))
+        return false;
+    if (!report.baseline.passed && !allowed.includes('baseline'))
+        return false;
+    if (report.checks.some((check) => check.id === 'module-size' && check.status !== 'pass')) {
+        return false;
+    }
+    // Levels grow with severity on every axis (distance in millimetres from
+    // the camera), so failing at or before the typical level is <=.
+    return report.captures.every((capture) => allowed.includes(capture.axis) ||
+        capture.firstFailed === null ||
+        capture.firstFailed > capture.typical);
+}
+/** What a report falls short on at its everyday levels: the axes, and the clean capture. */
+export function shortfalls(report) {
+    const out = report.baseline.passed ? [] : ['baseline'];
+    for (const capture of report.captures) {
+        if (capture.firstFailed !== null && capture.firstFailed <= capture.typical)
+            out.push(capture.axis);
+    }
+    return out;
+}
+/**
+ * The options a preset's runs take: with a recorded distance shortfall, the
+ * distance axis is left out. Its refusal would otherwise feed the print size
+ * check (a design that seems to need ten pixels a module asks for a print
+ * large enough to hold ten comfortably), so the size would grow to cover the
+ * very shortfall the record exists to keep visible. Without the axis, the
+ * size check assumes what any reader needs.
+ */
+export function presetOptions(preset, options) {
+    if (!(options.known?.[preset.id] ?? []).includes('distance'))
+        return options;
+    const axes = (options.axes ?? LADDERS.map((ladder) => ladder.axis)).filter((axis) => axis !== 'distance');
+    return { ...options, axes };
+}
+/** The report for one preset, content and level at one size. */
+export function presetReport(preset, content, sizeMm, ecLevel, registries, options = {}) {
+    const design = { ...preset.design, symbol: { ...preset.design.symbol, ecLevel } };
+    const prepared = prepare({
+        content,
+        design,
+        conditions: { sizeMm, dpi: null, distanceMm: null },
+        seed: options.seed ?? 1,
+        requires: [],
+        captureSeeds: options.seeds ?? 8,
+    }, registries);
+    const run = runPrepared(prepared, presetOptions(preset, options));
+    for (;;) {
+        const step = run.next();
+        if (step.done === true)
+            return step.value;
+    }
+}
+/** The most the climb ever goes to, in millimetres. */
+export const CALIBRATION_LIMIT_MM = 120;
+/**
+ * The size past which a larger print changes nothing but the distances in
+ * millimetres: the phone no longer has to stay back to focus, so every
+ * capture is the same picture. A design still failing there fails at every
+ * size. `modulesAcross` is the code and its quiet zone, which the phone
+ * frames and the size measures.
+ */
+export function saturationMm(modulesAcross) {
+    const framing = framingPxPerModule(modulesAcross, null);
+    return Math.ceil((framing / pxPerModuleAt(1, CAMERA.minFocusMm)) * modulesAcross);
+}
+/** The smallest whole millimetre size, of `modulesAcross` modules, a phone can resolve a module at, at all. */
+export function floorMm(modulesAcross) {
+    return Math.max(5, Math.floor(minModuleMm() * modulesAcross));
+}
+/**
+ * The smallest whole millimetre size at which `preset` scans with each
+ * content at its own level (or `options.ecLevel`), climbing 1 mm at a time from the smallest size a
+ * phone can resolve at all. A content that still fails one millimetre past
+ * the size where larger stops helping (see `saturationMm`) never passes, and
+ * nor does any larger content after it.
+ */
+export function calibratePreset(preset, registries, options = {}) {
+    const level = options.ecLevel ?? preset.design.symbol.ecLevel ?? 'M';
+    const passed = { small: null, medium: null, large: null };
+    let from = 0;
+    for (const size of ['small', 'medium', 'large']) {
+        const probe = prepare({
+            content: PRESET_CONTENT[size],
+            design: { ...preset.design, symbol: { ...preset.design.symbol, ecLevel: level } },
+            conditions: { sizeMm: null, dpi: null, distanceMm: null },
+            seed: 1,
+            requires: [],
+        }, registries);
+        const across = probe.symbol.matrix.width + 2 * probe.quietZone;
+        const last = Math.min(CALIBRATION_LIMIT_MM, saturationMm(across) + 1);
+        const known = options.known?.[preset.id] ?? [];
+        for (let mm = Math.max(from, floorMm(across)); mm <= last; mm += 1) {
+            const report = presetReport(preset, PRESET_CONTENT[size], mm, level, registries, options);
+            if (scansAtSize(report, known)) {
+                passed[size] = mm;
+                from = mm;
+                break;
+            }
+        }
+        if (passed[size] === null)
+            break;
+    }
+    const values = Object.values(passed);
+    if (values.some((value) => value === null)) {
+        return { id: preset.id, level, passedMm: passed, minSizeMm: null };
+    }
+    // The reader is not monotonic in size below saturation (a capture at a
+    // few more pixels a module can read worse), so the size with its margin is
+    // confirmed with every content, and raised a millimetre at a time until it
+    // passes: the preset must pass at the size it records.
+    for (let mm = withMargin(Math.max(...values)); mm <= CALIBRATION_LIMIT_MM; mm += 1) {
+        const known = options.known?.[preset.id] ?? [];
+        const all = ['small', 'medium', 'large'].every((size) => scansAtSize(presetReport(preset, PRESET_CONTENT[size], mm, level, registries, options), known));
+        if (all)
+            return { id: preset.id, level, passedMm: passed, minSizeMm: mm };
+    }
+    return { id: preset.id, level, passedMm: passed, minSizeMm: null };
+}
+/**
+ * The strict scan check as `checkPreset`'s hook: every content at the
+ * preset's own level and size (or at every level it allows, each at its own
+ * size, `presetSizeMm`).
+ */
+export function presetVerifier(options = {}) {
+    return (preset, design) => {
+        const registries = { symbologies: createSymbologyRegistry(), design };
+        const levels = options.levels === 'all' ? preset.ecLevels : [preset.design.symbol.ecLevel ?? 'M'];
+        const out = [];
+        for (const level of levels) {
+            for (const size of ['small', 'medium', 'large']) {
+                const sizeMm = presetSizeMm(preset, level);
+                const report = presetReport(preset, PRESET_CONTENT[size], sizeMm, level, registries, options);
+                if (!scansAtSize(report, options.known?.[preset.id])) {
+                    out.push({
+                        entry: preset.id,
+                        rule: 'scan-check',
+                        detail: `${size} content at level ${level} does not scan at ${sizeMm} mm: ${describe(report)}`,
+                    });
+                }
+            }
+        }
+        return out;
+    };
+}
+/** What went wrong, for a developer reading a test failure. */
+export function describe(report) {
+    const parts = [];
+    if (!report.baseline.passed)
+        parts.push('the clean capture did not read');
+    for (const check of report.checks)
+        if (check.status === 'fail')
+            parts.push(`${check.messageKey} failed`);
+    const size = report.checks.find((check) => check.id === 'module-size');
+    if (size !== undefined && size.status === 'warn')
+        parts.push(`${size.messageKey} warned`);
+    for (const capture of report.captures) {
+        if (capture.firstFailed !== null && capture.firstFailed <= capture.typical) {
+            parts.push(`${capture.axis} failed at ${capture.firstFailed} (typical ${capture.typical})`);
+        }
+    }
+    return parts.length === 0 ? 'no reason recorded' : parts.join('; ');
+}
+//# sourceMappingURL=preset.js.map

package/dist/verify/preset.js.map

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

package/dist/verify/read.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Reading a capture the way the scan check counts it.
+ *
+ * The decode layer's strict profile does the reading, in the design's own
+ * polarity and for its own symbology only. A capture then passes only when
+ * it read to exactly the bytes the clean symbol holds, at the version it was
+ * made at, and with the reserve left unspent in every block: the strict
+ * profile's last rule, which the decode layer leaves to this one because it
+ * is a statement about how much damage a capture may cost rather than about
+ * reading.
+ */
+import type { RgbaImage } from '../core/image.js';
+import type { Prepared } from './prepare.js';
+export interface CaptureRead {
+    readonly read: boolean;
+    /** The least spare correction in any block, after the reserve; null when nothing read. */
+    readonly margin: number | null;
+}
+/** Spare corrections after the reserve, in the block with fewest. */
+export declare function blockMargin(errorsPerBlock: readonly number[], capacityPerBlock: readonly number[]): number;
+/** The strict reading of one capture, judged against the clean symbol. */
+export declare function strictRead(image: RgbaImage, prepared: Prepared): CaptureRead;
+//# sourceMappingURL=read.d.ts.map

package/dist/verify/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/verify/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAC1B,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GACjC,MAAM,CAQR;AAQD,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAyB5E"}

package/dist/verify/read.js

@@ -0,0 +1,55 @@
+/**
+ * Reading a capture the way the scan check counts it.
+ *
+ * The decode layer's strict profile does the reading, in the design's own
+ * polarity and for its own symbology only. A capture then passes only when
+ * it read to exactly the bytes the clean symbol holds, at the version it was
+ * made at, and with the reserve left unspent in every block: the strict
+ * profile's last rule, which the decode layer leaves to this one because it
+ * is a statement about how much damage a capture may cost rather than about
+ * reading.
+ */
+import { decodeImage } from '../decode/decoder.js';
+import { reserveFor } from './coverage.js';
+/** Spare corrections after the reserve, in the block with fewest. */
+export function blockMargin(errorsPerBlock, capacityPerBlock) {
+    let least = Number.POSITIVE_INFINITY;
+    for (let i = 0; i < capacityPerBlock.length; i += 1) {
+        const t = capacityPerBlock[i];
+        const spare = t - reserveFor(t) - errorsPerBlock[i];
+        if (spare < least)
+            least = spare;
+    }
+    return least === Number.POSITIVE_INFINITY ? 0 : least;
+}
+function sameBytes(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i += 1)
+        if (a[i] !== b[i])
+            return false;
+    return true;
+}
+/** The strict reading of one capture, judged against the clean symbol. */
+export function strictRead(image, prepared) {
+    const result = decodeImage(image, {
+        profile: 'strict-v1',
+        polarity: prepared.polarity,
+        symbologies: [prepared.entry.id],
+        maxSymbols: 1,
+    }, prepared.registries.symbologies);
+    const found = result.ok ? result.value[0] : undefined;
+    if (found === undefined)
+        return { read: false, margin: null };
+    const { read } = found;
+    const reference = prepared.reference;
+    if (read.version !== reference.version ||
+        !sameBytes(read.bitstream.bytes, reference.bitstream.bytes)) {
+        // Read, but to something else: as bad as not reading, and worse for the
+        // person holding the phone.
+        return { read: false, margin: null };
+    }
+    const margin = blockMargin(read.errorsPerBlock, read.capacityPerBlock);
+    return { read: margin >= 0, margin };
+}
+//# sourceMappingURL=read.js.map

package/dist/verify/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/verify/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAS3C,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAC1B,cAAiC,EACjC,gBAAmC;IAEnC,IAAI,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAW,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAI,cAAc,CAAC,CAAC,CAAY,CAAC;QAChE,IAAI,KAAK,GAAG,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,CAAa,EAAE,CAAa;IAC9C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACtE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,QAAkB;IAC9D,MAAM,MAAM,GAAG,WAAW,CACzB,KAAK,EACL;QACC,OAAO,EAAE,WAAW;QACpB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,UAAU,EAAE,CAAC;KACb,EACD,QAAQ,CAAC,UAAU,CAAC,WAAW,CAC/B,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC9D,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACvB,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACrC,IACC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO;QAClC,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,EAC1D,CAAC;QACF,wEAAwE;QACxE,4BAA4B;QAC5B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/verify/region.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A ring and a centre captured as the scan check captures a print.
+ *
+ * The design layer's finder conformance measures a pair on pictures drawn
+ * sharp at 6 and 8 pixels a module. A photograph is softer than that, and a
+ * styled finder that reads among square modules can fail among dots: the
+ * light round each dot changes what the reader's threshold makes of the
+ * finder and of the alignment patterns, which take the finder's style. So
+ * each pair is also put in a whole code, among one family's modules, and
+ * read from the scan check's own captures: a short and a long link at their
+ * own level, at 6, 8 and 10 pixels a module, clean and with ink spread (even
+ * seeds) or starved (odd seeds) by 0.05 of a module, each seed placed,
+ * turned and blurred as the clean capture is.
+ *
+ * Conformance takes this as a hook (`RegionCaptureReader`), as it takes the
+ * preset scan check, because captures belong to the layer above it.
+ */
+import type { DesignRegistries, EntryRef } from '../design/types.js';
+import type { ContentSize } from './preset.js';
+export interface RegionCaptureReaderOptions {
+    /** Seeds read at each density and condition, from 0. Default 8. */
+    readonly seeds?: number;
+    /** Pixels a module. Default 6, 8 and 10. */
+    readonly densities?: readonly number[];
+    /** Default a short and a long link. */
+    readonly contents?: readonly ContentSize[];
+}
+export interface RegionCaptureResult {
+    readonly captures: number;
+    /** One entry per condition that missed: content, pixels a module, condition and how many seeds. */
+    readonly missed: readonly string[];
+    readonly missedCount: number;
+}
+/** Reads a finder of `ring` round `centre` among modules of `module`, and says what it missed. */
+export type RegionCaptureReader = (module: EntryRef, ring: EntryRef, centre: EntryRef, registries: DesignRegistries) => RegionCaptureResult;
+export declare function regionCaptureReader(options?: RegionCaptureReaderOptions): RegionCaptureReader;
+//# sourceMappingURL=region.d.ts.map

package/dist/verify/region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../../src/verify/region.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAc,MAAM,oBAAoB,CAAC;AAKjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,0BAA0B;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,kGAAkG;AAClG,MAAM,MAAM,mBAAmB,GAAG,CACjC,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,gBAAgB,KACxB,mBAAmB,CAAC;AAKzB,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,mBAAmB,CAsDjG"}

package/dist/verify/region.js

@@ -0,0 +1,80 @@
+/**
+ * A ring and a centre captured as the scan check captures a print.
+ *
+ * The design layer's finder conformance measures a pair on pictures drawn
+ * sharp at 6 and 8 pixels a module. A photograph is softer than that, and a
+ * styled finder that reads among square modules can fail among dots: the
+ * light round each dot changes what the reader's threshold makes of the
+ * finder and of the alignment patterns, which take the finder's style. So
+ * each pair is also put in a whole code, among one family's modules, and
+ * read from the scan check's own captures: a short and a long link at their
+ * own level, at 6, 8 and 10 pixels a module, clean and with ink spread (even
+ * seeds) or starved (odd seeds) by 0.05 of a module, each seed placed,
+ * turned and blurred as the clean capture is.
+ *
+ * Conformance takes this as a hook (`RegionCaptureReader`), as it takes the
+ * preset scan check, because captures belong to the layer above it.
+ */
+import { defaultDesign } from '../design/document.js';
+import { createSymbologyRegistry } from '../symbology/registry.js';
+import { renderCapture } from './capture.js';
+import { masterResolution } from './job.js';
+import { prepare, renderMaster } from './prepare.js';
+import { PRESET_CONTENT } from './preset.js';
+import { strictRead } from './read.js';
+/** Ink moved this many modules each way: the ink axis's everyday level. */
+const INK = 0.05;
+export function regionCaptureReader(options = {}) {
+    const seeds = options.seeds ?? 8;
+    const densities = options.densities ?? [6, 8, 10];
+    const contents = options.contents ?? ['small', 'large'];
+    return (module, ring, centre, design) => {
+        const base = defaultDesign();
+        const subject = {
+            ...base,
+            modules: { ...base.modules, shape: module },
+            regions: { finder: { outer: ring, inner: centre } },
+        };
+        const registries = { symbologies: createSymbologyRegistry(), design };
+        const missed = [];
+        let captures = 0;
+        let missedCount = 0;
+        for (const content of contents) {
+            const prepared = prepare({
+                content: PRESET_CONTENT[content],
+                design: subject,
+                conditions: { sizeMm: null, dpi: null, distanceMm: null },
+                seed: 1,
+                requires: [],
+                captureSeeds: seeds,
+            }, registries);
+            const master = renderMaster(prepared, masterResolution(Math.max(...densities)));
+            const { width, height } = prepared.built.scene;
+            for (const pxPerModule of densities) {
+                for (const [axis, level] of [
+                    ['baseline', 0],
+                    ['ink', INK],
+                ]) {
+                    let bad = 0;
+                    for (let seed = 0; seed < seeds; seed += 1) {
+                        const { image } = renderCapture(master, width, height, 1, {
+                            axis,
+                            level,
+                            seed,
+                            pxPerModule,
+                        });
+                        captures += 1;
+                        if (!strictRead(image, prepared).read)
+                            bad += 1;
+                    }
+                    if (bad > 0) {
+                        missedCount += bad;
+                        missed.push(`${content} link at ${pxPerModule} px, ${axis}: ${bad} of ${seeds}`);
+                    }
+                }
+            }
+        }
+        return { captures, missed, missedCount };
+    };
+}
+//# sourceMappingURL=region.js.map

package/dist/verify/region.js.map

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

package/dist/verify/static.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The checks that need no camera: what the design itself guarantees or rules
+ * out, measured from its paints, its layout and one clean picture of it.
+ *
+ * The clean picture is the scene drawn at ten pixels a module, and every
+ * module is read at its centre the way the strict reader reads it: one
+ * sample, thresholded halfway between the darkest and lightest module. That
+ * gives ISO/IEC 15415's symbol contrast (SC, the range between them) and
+ * modulation (MOD, how far the least certain module sits from the threshold,
+ * as a share of half that range), and it says which modules under a logo
+ * really read wrong, for the logo budget.
+ */
+import type { Coverage } from './coverage.js';
+import type { Master, Prepared } from './prepare.js';
+import type { CheckId, CheckStatus, VerifyCheck } from './types.js';
+/** ISO/IEC 15415 grade floors for symbol contrast, A to D: below D is F. */
+export declare const SC_GRADES: readonly number[];
+/** ISO/IEC 15415 grade floors for modulation, A to D. */
+export declare const MOD_GRADES: readonly number[];
+/**
+ * Red light contrast below this warns: the floor of ISO grade C for symbol
+ * contrast, applied to red reflectance. Pure red on white has none at all; a
+ * dark red keeps plenty.
+ */
+export declare const RED_CONTRAST_WARN = 0.4;
+export declare function gradeLetter(value: number, floors: readonly number[]): string;
+export declare function makeCheck(id: CheckId, status: CheckStatus, measured: number, threshold: number, messageKey: string, params?: Readonly<Record<string, number | string>>, grade?: VerifyCheck['grade']): VerifyCheck;
+export interface Sampling {
+    /** One luma per module, row major over the symbol, read at its centre. */
+    readonly samples: Float32Array;
+    readonly rmin: number;
+    readonly rmax: number;
+    /** The global threshold, halfway between. */
+    readonly threshold: number;
+    /** 1 where a module reads as the other colour. */
+    readonly wrong: Uint8Array;
+    /** The least modulation over the modules the module shape draws and no logo covers, signed: below zero, one reads wrong. */
+    readonly mod: number;
+}
+/** Each module's centre in the clean picture, read the way the strict reader reads it. */
+export declare function sampleModules(prepared: Prepared, master: Master): Sampling;
+/**
+ * The clear margin round the symbol, in whole modules, on the ground side of
+ * the threshold by at least a quarter of the symbol contrast. Counted ring
+ * by ring outwards and stopped at the first ring with anything in it, or at
+ * the edge of the picture.
+ */
+export declare function measureQuietZone(prepared: Prepared, master: Master, sampling: Sampling): number;
+export interface StaticResult {
+    readonly checks: readonly VerifyCheck[];
+    readonly coverage: Coverage;
+    readonly sampling: Sampling;
+}
+/** Every check that needs no capture, except module size, which needs the distance captures. */
+export declare function staticChecks(prepared: Prepared, master: Master): StaticResult;
+//# sourceMappingURL=static.d.ts.map

package/dist/verify/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/verify/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK9C,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpE,4EAA4E;AAC5E,eAAO,MAAM,SAAS,mBAAuC,CAAC;AAC9D,yDAAyD;AACzD,eAAO,MAAM,UAAU,mBAAsC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAqBrC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAK5E;AAED,wBAAgB,SAAS,CACxB,EAAE,EAAE,OAAO,EACX,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAClD,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAC1B,WAAW,CAUb;AAOD,MAAM,WAAW,QAAQ;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,4HAA4H;IAC5H,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AAkBD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAiD1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAkC/F;AAiCD,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC5B;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CA4K7E"}