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

package/dist/batch/verify.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The scan check, run on a batch's rows.
+ *
+ * `scanCheckVerifier(registries)` is the `verifyRow` to pass for it: each
+ * row's content in the design it was drawn with, given to verify's
+ * `runVerifyJob` and driven one capture at a time inside the batch's own
+ * slices, so a check never holds the page for longer than one capture does. The report comes back as the row's verdict and its
+ * issues: a failing check as a warning in the check's own message key and
+ * params (verify's catalogue has the sentence), a check with a warning as an
+ * info issue, and a clean capture that did not read as a warning of its own,
+ * because that fails the verdict with no check to point at.
+ *
+ * A full check takes eight seeded captures at every level of every axis,
+ * which measured 5 to 16 seconds a code in Node on a laptop, depending on
+ * what else it was doing. A batch cannot afford that on every row, so the
+ * number of seeds follows the mode: 'all' checks every row with 2 seeds
+ * (4 to 5 seconds a row), enough to catch a design that fails outright, and
+ * 'sampled' checks a few rows with all 8, as the studio checks a single code,
+ * because those few stand in for the rest (`SEEDS_ALL`, `SEEDS_SAMPLED` in
+ * run.ts). `verifySeeds` on the output overrides both.
+ *
+ * It is not runBatch's default, because run.ts must not import verify: the
+ * studio's batch command reaches run.ts from the offline file, which leaves
+ * the scan check out until it is given one.
+ */
+import type { VerifyJob, VerifyProgress, VerifyRegistries, VerifyReport } from '../verify/types.js';
+import type { BatchVerifier, BatchVerifyRequest, BatchVerifyResult } from './types.js';
+/** The scan check's job for one row. */
+export declare function scanCheckJob(request: BatchVerifyRequest): VerifyJob;
+/** A report as a row's verdict and issues. */
+export declare function reportResult(report: VerifyReport): BatchVerifyResult;
+/**
+ * What runs a job: verify's `runVerifyJob`, or a stand-in with its shape.
+ * Structurally the studio's `VerifyGenerator` seam, which batch may not
+ * import, so the studio hands its own generator over as it is.
+ */
+export type ScanCheckGenerator<R extends VerifyRegistries = VerifyRegistries> = (job: VerifyJob, registries: R) => Generator<VerifyProgress, VerifyReport>;
+/**
+ * The scan check as a batch's `verifyRow`, over these registries. `generator`
+ * is what runs each job, `runVerifyJob` unless the caller has its own: the
+ * studio passes the one it was given, so batch rows are checked the way its
+ * single code is.
+ */
+export declare function scanCheckVerifier<R extends VerifyRegistries>(registries: R, generator?: ScanCheckGenerator<R>): BatchVerifier;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/batch/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEvF,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAenE;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,CAiBpE;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CAC/E,GAAG,EAAE,SAAS,EACd,UAAU,EAAE,CAAC,KACT,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,EAC3D,UAAU,EAAE,CAAC,EACb,SAAS,GAAE,kBAAkB,CAAC,CAAC,CAAgB,GAC7C,aAAa,CAKf"}

package/dist/batch/verify.js

@@ -0,0 +1,72 @@
+/**
+ * The scan check, run on a batch's rows.
+ *
+ * `scanCheckVerifier(registries)` is the `verifyRow` to pass for it: each
+ * row's content in the design it was drawn with, given to verify's
+ * `runVerifyJob` and driven one capture at a time inside the batch's own
+ * slices, so a check never holds the page for longer than one capture does. The report comes back as the row's verdict and its
+ * issues: a failing check as a warning in the check's own message key and
+ * params (verify's catalogue has the sentence), a check with a warning as an
+ * info issue, and a clean capture that did not read as a warning of its own,
+ * because that fails the verdict with no check to point at.
+ *
+ * A full check takes eight seeded captures at every level of every axis,
+ * which measured 5 to 16 seconds a code in Node on a laptop, depending on
+ * what else it was doing. A batch cannot afford that on every row, so the
+ * number of seeds follows the mode: 'all' checks every row with 2 seeds
+ * (4 to 5 seconds a row), enough to catch a design that fails outright, and
+ * 'sampled' checks a few rows with all 8, as the studio checks a single code,
+ * because those few stand in for the rest (`SEEDS_ALL`, `SEEDS_SAMPLED` in
+ * run.ts). `verifySeeds` on the output overrides both.
+ *
+ * It is not runBatch's default, because run.ts must not import verify: the
+ * studio's batch command reaches run.ts from the offline file, which leaves
+ * the scan check out until it is given one.
+ */
+import { issue } from '../core/issue.js';
+import { runVerifyJob } from '../verify/job.js';
+import { VERIFY_MESSAGE_KEYS } from '../verify/keys.js';
+import { designRequirements } from '../verify/prepare.js';
+/** The scan check's job for one row. */
+export function scanCheckJob(request) {
+    const { assets } = request;
+    return {
+        content: request.content,
+        design: request.design,
+        // The size is the symbol with its quiet zone, worked out from the scene
+        // as drawn, which is what verify measures modules against whatever the
+        // design's own size measures.
+        conditions: { sizeMm: request.sizeMm, dpi: request.dpi, distanceMm: null },
+        seed: request.seed,
+        requires: designRequirements(request.design),
+        ...(Object.keys(assets).length === 0 ? {} : { assets }),
+        captureSeeds: request.captureSeeds,
+        overlay: request.overlay,
+    };
+}
+/** A report as a row's verdict and issues. */
+export function reportResult(report) {
+    const issues = [];
+    if (!report.baseline.passed) {
+        issues.push(issue(VERIFY_MESSAGE_KEYS.baselineFailed, ['check', 'baseline'], 'warning'));
+    }
+    for (const check of report.checks) {
+        if (check.status === 'pass')
+            continue;
+        issues.push(issue(check.messageKey, ['check', check.id], check.status === 'fail' ? 'warning' : 'info', check.params));
+    }
+    return { verdict: report.verdict, issues };
+}
+/**
+ * The scan check as a batch's `verifyRow`, over these registries. `generator`
+ * is what runs each job, `runVerifyJob` unless the caller has its own: the
+ * studio passes the one it was given, so batch rows are checked the way its
+ * single code is.
+ */
+export function scanCheckVerifier(registries, generator = runVerifyJob) {
+    return function* check(request) {
+        const report = yield* generator(scanCheckJob(request), registries);
+        return reportResult(report);
+    };
+}
+//# sourceMappingURL=verify.js.map

package/dist/batch/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/batch/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI1D,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAAC,OAA2B;IACvD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,wEAAwE;QACxE,uEAAuE;QACvE,8BAA8B;QAC9B,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;QAC1E,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QACvD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;KACxB,CAAC;AACH,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,MAAoB;IAChD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1F,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QACtC,MAAM,CAAC,IAAI,CACV,KAAK,CACJ,KAAK,CAAC,UAAU,EAChB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,EACnB,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAC5C,KAAK,CAAC,MAAM,CACZ,CACD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAYD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAChC,UAAa,EACb,YAAmC,YAAY;IAE/C,OAAO,QAAQ,CAAC,CAAC,KAAK,CAAC,OAAO;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;QACnE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC;AACH,CAAC"}

package/dist/batch/zip.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A ZIP written one entry at a time, for a batch that cannot afford to hold
+ * every file uncompressed and then compress them all in one go.
+ *
+ * Core's `writeZip` takes the whole list and deflates it in a single call. A
+ * batch of two thousand dotted SVGs is a hundred megabytes of text, which is
+ * a hundred megabytes held at once and a minute of deflate in one slice that
+ * the page cannot draw during. This writer deflates each entry as it is added,
+ * during that row's slice, keeps only what goes in the file, and joins it all
+ * up at the end with nothing left to do but copy.
+ *
+ * The bytes are core's, exactly: the same headers in the same order, the same
+ * fixed date (1980-01-01 unless one is given), deflate at level 6 kept only
+ * when it is smaller, and the same refusals. `tests/batch/zip.test.ts` checks
+ * every archive it writes against `writeZip` over the same entries, byte for
+ * byte, so this is a different schedule for the same file and not a second
+ * format to keep in step by hand.
+ */
+export declare class ZipWriter {
+    private readonly entries;
+    private readonly names;
+    private readonly folders;
+    private readonly date;
+    private readonly encoder;
+    private offset;
+    /** The most the finished file can be, counted as core counts it before writing. */
+    private largest;
+    constructor(date?: {
+        year: number;
+        month: number;
+        day: number;
+    });
+    get count(): number;
+    /** Add an entry, deflating it now when asked and when that is smaller. */
+    add(name: string, bytes: Uint8Array, compress?: boolean): void;
+    /** The archive. The writer holds nothing useful afterwards. */
+    finish(): Uint8Array;
+}
+//# sourceMappingURL=zip.d.ts.map

package/dist/batch/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../src/batch/zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqEH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAAK;IACnB,mFAAmF;IACnF,OAAO,CAAC,OAAO,CAAc;gBAEjB,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAI/D,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,0EAA0E;IAC1E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,UAAQ,GAAG,IAAI;IAyC5D,+DAA+D;IAC/D,MAAM,IAAI,UAAU;CAgEpB"}

package/dist/batch/zip.js

@@ -0,0 +1,201 @@
+/**
+ * A ZIP written one entry at a time, for a batch that cannot afford to hold
+ * every file uncompressed and then compress them all in one go.
+ *
+ * Core's `writeZip` takes the whole list and deflates it in a single call. A
+ * batch of two thousand dotted SVGs is a hundred megabytes of text, which is
+ * a hundred megabytes held at once and a minute of deflate in one slice that
+ * the page cannot draw during. This writer deflates each entry as it is added,
+ * during that row's slice, keeps only what goes in the file, and joins it all
+ * up at the end with nothing left to do but copy.
+ *
+ * The bytes are core's, exactly: the same headers in the same order, the same
+ * fixed date (1980-01-01 unless one is given), deflate at level 6 kept only
+ * when it is smaller, and the same refusals. `tests/batch/zip.test.ts` checks
+ * every archive it writes against `writeZip` over the same entries, byte for
+ * byte, so this is a different schedule for the same file and not a second
+ * format to keep in step by hand.
+ */
+import { crc32 } from '../core/checksums.js';
+import { deflateRaw } from '../core/deflate.js';
+import { ArchiveTooLargeError } from '../core/errors.js';
+const LOCAL_HEADER = 30;
+const CENTRAL_HEADER = 46;
+const END_RECORD = 22;
+const UTF8_FLAG = 0x0800;
+const MAX_ENTRIES = 0xffff;
+const MAX_BYTES = 0xffffffff;
+/**
+ * Refuse a name core's writer would refuse. Batch names are cleaned before
+ * they get here, so each of these is a bug in this layer, not a person's
+ * file, and the message gives the entry's position only.
+ */
+function checkName(name, index) {
+    const where = `entry ${index}`;
+    if (name.length === 0)
+        throw new TypeError(`${where} has no name`);
+    if (name.includes('\\'))
+        throw new TypeError(`${where} has a backslash in its name`);
+    if (name.startsWith('/') || /^[A-Za-z]:/.test(name)) {
+        throw new TypeError(`${where} has an absolute path for a name`);
+    }
+    for (let i = 0; i < name.length; i += 1) {
+        const code = name.charCodeAt(i);
+        if (code < 0x20 || code === 0x7f)
+            throw new TypeError(`${where} has a control character in its name`);
+        if (code >= 0xd800 && code <= 0xdfff) {
+            const low = name.charCodeAt(i + 1);
+            if (code > 0xdbff || !(low >= 0xdc00 && low <= 0xdfff)) {
+                throw new TypeError(`${where} name is not valid Unicode`);
+            }
+            i += 1;
+        }
+    }
+    for (const segment of name.split('/')) {
+        if (segment === '' || segment === '.' || segment === '..') {
+            throw new TypeError(`${where} has an empty, '.' or '..' folder in its name`);
+        }
+    }
+}
+function dosDate(date) {
+    const { year, month, day } = date ?? { year: 1980, month: 1, day: 1 };
+    if (!Number.isInteger(year) || year < 1980 || year > 2107) {
+        throw new RangeError('a ZIP date is in the years 1980 to 2107');
+    }
+    if (!Number.isInteger(month) || month < 1 || month > 12) {
+        throw new RangeError('a ZIP date has a month from 1 to 12');
+    }
+    const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
+    if (!Number.isInteger(day) || day < 1 || day > days) {
+        throw new RangeError(`that month has days 1 to ${days}`);
+    }
+    return ((year - 1980) << 9) | (month << 5) | day;
+}
+export class ZipWriter {
+    entries = [];
+    names = new Set();
+    folders = new Set();
+    date;
+    encoder = new TextEncoder();
+    offset = 0;
+    /** The most the finished file can be, counted as core counts it before writing. */
+    largest = END_RECORD;
+    constructor(date) {
+        this.date = dosDate(date);
+    }
+    get count() {
+        return this.entries.length;
+    }
+    /** Add an entry, deflating it now when asked and when that is smaller. */
+    add(name, bytes, compress = false) {
+        const index = this.entries.length;
+        if (index >= MAX_ENTRIES)
+            throw new ArchiveTooLargeError(MAX_ENTRIES, 'entries');
+        checkName(name, index);
+        const folded = name.toLowerCase();
+        const parts = folded.split('/');
+        if (this.names.has(folded) || this.folders.has(folded)) {
+            throw new TypeError(`entry ${index} has the same name as an earlier entry or its folder`);
+        }
+        for (let i = 1; i < parts.length; i += 1) {
+            const folder = parts.slice(0, i).join('/');
+            if (this.names.has(folder)) {
+                throw new TypeError(`entry ${index} is inside a folder that is an earlier entry's name`);
+            }
+            this.folders.add(folder);
+        }
+        this.names.add(folded);
+        const encoded = this.encoder.encode(name);
+        if (encoded.length > 0xffff)
+            throw new TypeError(`entry ${index} has too long a name`);
+        this.largest += LOCAL_HEADER + CENTRAL_HEADER + 2 * encoded.length + bytes.length;
+        if (this.largest > MAX_BYTES)
+            throw new ArchiveTooLargeError(MAX_BYTES);
+        let data = bytes;
+        let deflated = false;
+        if (compress) {
+            const packed = deflateRaw(bytes, { level: 6 });
+            if (packed.length < bytes.length) {
+                data = packed;
+                deflated = true;
+            }
+        }
+        this.entries.push({
+            name: encoded,
+            data,
+            deflated,
+            crc: crc32(bytes),
+            size: bytes.length,
+            offset: this.offset,
+        });
+        this.offset += LOCAL_HEADER + encoded.length + data.length;
+    }
+    /** The archive. The writer holds nothing useful afterwards. */
+    finish() {
+        const directoryOffset = this.offset;
+        let directorySize = 0;
+        for (const item of this.entries)
+            directorySize += CENTRAL_HEADER + item.name.length;
+        const out = new Uint8Array(directoryOffset + directorySize + END_RECORD);
+        const view = new DataView(out.buffer);
+        let at = 0;
+        const u16 = (value) => {
+            view.setUint16(at, value, true);
+            at += 2;
+        };
+        const u32 = (value) => {
+            view.setUint32(at, value, true);
+            at += 4;
+        };
+        for (const item of this.entries) {
+            u32(0x04034b50);
+            u16(item.deflated ? 20 : 10);
+            u16(UTF8_FLAG);
+            u16(item.deflated ? 8 : 0);
+            u16(0);
+            u16(this.date);
+            u32(item.crc);
+            u32(item.data.length);
+            u32(item.size);
+            u16(item.name.length);
+            u16(0);
+            out.set(item.name, at);
+            at += item.name.length;
+            out.set(item.data, at);
+            at += item.data.length;
+        }
+        for (const item of this.entries) {
+            u32(0x02014b50);
+            u16(20);
+            u16(item.deflated ? 20 : 10);
+            u16(UTF8_FLAG);
+            u16(item.deflated ? 8 : 0);
+            u16(0);
+            u16(this.date);
+            u32(item.crc);
+            u32(item.data.length);
+            u32(item.size);
+            u16(item.name.length);
+            u16(0);
+            u16(0);
+            u16(0);
+            u16(0);
+            u32(0);
+            u32(item.offset);
+            out.set(item.name, at);
+            at += item.name.length;
+        }
+        u32(0x06054b50);
+        u16(0);
+        u16(0);
+        u16(this.entries.length);
+        u16(this.entries.length);
+        u32(directorySize);
+        u32(directoryOffset);
+        u16(0);
+        this.entries.length = 0;
+        return out;
+    }
+}
+//# sourceMappingURL=zip.js.map

package/dist/batch/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../src/batch/zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,SAAS,GAAG,UAAU,CAAC;AAW7B;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa;IAC7C,MAAM,KAAK,GAAG,SAAS,KAAK,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IACrF,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,KAAK,IAAI;YAC/B,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;QACrE,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACnC,IAAI,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;gBACxD,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,4BAA4B,CAAC,CAAC;YAC3D,CAAC;YACD,CAAC,IAAI,CAAC,CAAC;QACR,CAAC;IACF,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC3D,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,+CAA+C,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,OAAO,CAAC,IAA8D;IAC9E,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACtE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAC3D,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACzD,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAW,CAAC;IAC/F,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;QACrD,MAAM,IAAI,UAAU,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;AAClD,CAAC;AAED,MAAM,OAAO,SAAS;IACJ,OAAO,GAAc,EAAE,CAAC;IACxB,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1B,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5B,IAAI,CAAS;IACb,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IACrC,MAAM,GAAG,CAAC,CAAC;IACnB,mFAAmF;IAC3E,OAAO,GAAG,UAAU,CAAC;IAE7B,YAAY,IAAmD;QAC9D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,0EAA0E;IAC1E,GAAG,CAAC,IAAY,EAAE,KAAiB,EAAE,QAAQ,GAAG,KAAK;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAClC,IAAI,KAAK,IAAI,WAAW;YAAE,MAAM,IAAI,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACjF,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,sDAAsD,CAAC,CAAC;QAC3F,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,qDAAqD,CAAC,CAAC;YAC1F,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM;YAAE,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,sBAAsB,CAAC,CAAC;QACvF,IAAI,CAAC,OAAO,IAAI,YAAY,GAAG,cAAc,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAClF,IAAI,IAAI,CAAC,OAAO,GAAG,SAAS;YAAE,MAAM,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,GAAG,MAAM,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;YACjB,CAAC;QACF,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,OAAO;YACb,IAAI;YACJ,QAAQ;YACR,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC;YACjB,IAAI,EAAE,KAAK,CAAC,MAAM;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,IAAI,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5D,CAAC;IAED,+DAA+D;IAC/D,MAAM;QACL,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;QACpC,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO;YAAE,aAAa,IAAI,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACpF,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,KAAa,EAAQ,EAAE;YACnC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAChC,EAAE,IAAI,CAAC,CAAC;QACT,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,CAAC,KAAa,EAAQ,EAAE;YACnC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAChC,EAAE,IAAI,CAAC,CAAC;QACT,CAAC,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,GAAG,CAAC,UAAU,CAAC,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvB,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvB,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACxB,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,GAAG,CAAC,UAAU,CAAC,CAAC;YAChB,GAAG,CAAC,EAAE,CAAC,CAAC;YACR,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,CAAC,CAAC,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvB,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACxB,CAAC;QACD,GAAG,CAAC,UAAU,CAAC,CAAC;QAChB,GAAG,CAAC,CAAC,CAAC,CAAC;QACP,GAAG,CAAC,CAAC,CAAC,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,GAAG,CAAC,aAAa,CAAC,CAAC;QACnB,GAAG,CAAC,eAAe,CAAC,CAAC;QACrB,GAAG,CAAC,CAAC,CAAC,CAAC;QACP,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,OAAO,GAAG,CAAC;IACZ,CAAC;CACD"}

package/dist/conformance/finder.d.ts

@@ -0,0 +1,67 @@
+/**
+ * A ring and a centre put to the strict reader's own finder tests.
+ *
+ * The design layer judges a finder by a model of the strict reader (runs at
+ * 4 pixels a module with sub-pixel edges, see design/finder.ts), because it
+ * runs wherever a design is validated or drawn and the root of the package
+ * must not pull in the decoder. This file asks the decoder itself, so that
+ * conformance can hold the model and the catalogue to it:
+ *
+ * - `ringKind`, the strict profile's test of whether a reader that traces a
+ *   finder ring's sides can follow it, through the grid the pair was drawn
+ *   on. It must come out the same at every density and phase drawn here, and
+ *   be what the ring says it is (`RegionShape.ringKind`), because that
+ *   declaration is all the validator has to go on.
+ * - `strictFindsFinder`, the strict profile's finder search, which must find
+ *   the pair at every density and phase drawn here.
+ *
+ * The pair is drawn at 6 and 8 pixels a module, the densities the scan check
+ * reads most of its captures at, each at four sub-pixel phases, in 13
+ * modules of white: `ringKind` looks 5.6 modules out from the centre along
+ * the diagonals, so the box of 7 needs 3 to spare on each side.
+ *
+ * Only the 7 by 7 finder is asked. The decoder's search is for 1:1:3:1:1,
+ * and the other kinds (an alignment pattern, rMQR's sub-finder) are found by
+ * sampling where they are known to be, which the model already covers.
+ */
+import type { GreyImage } from '../decode/grey.js';
+import type { RegionShape, ResolvedParams, RingKind } from '../design/types.js';
+/** Pixels a module the pair is drawn at. */
+export declare const STRICT_DENSITIES: readonly number[];
+/** Sub-pixel offsets of the pair's box, in pixels. */
+export declare const STRICT_PHASES: readonly number[];
+export interface StrictFinderOptions {
+    readonly densities?: readonly number[];
+    readonly phases?: readonly number[];
+    /** Rolls in degrees about the centre; only an unrolled picture is measured for its ring. Default [0]. */
+    readonly rolls?: readonly number[];
+}
+export interface StrictFinderProblem {
+    /** `ring-kind`: the ring traces as something other than it says, or unsteadily. `strict-finder`: the strict search misses the pair. */
+    readonly rule: 'ring-kind' | 'strict-finder';
+    readonly detail: string;
+}
+export interface FinderPicture {
+    readonly grey: GreyImage;
+    /** The pair's centre in pixels, on both axes. */
+    readonly centre: number;
+    /** The box's top left corner in modules, on both axes. */
+    readonly offset: number;
+}
+/** A ring and a centre as the 7 by 7 finder, black on white, `phase` pixels off the grid and turned by `roll` degrees. */
+export declare function finderPicture(outer: RegionShape, outerParams: ResolvedParams, inner: RegionShape, innerParams: ResolvedParams, modulePixels: number, phase?: number, roll?: number): FinderPicture;
+/** What the strict profile makes of the ring in this picture, through the grid it was drawn on. */
+export declare function pictureRingKind(picture: FinderPicture, modulePixels: number): RingKind | null;
+/**
+ * The ring's kind as the strict profile measures it round this centre: the
+ * kind, `unsteady` when the densities and phases disagree, or null when it
+ * cannot be measured at all.
+ */
+export declare function measureRingKind(outer: RegionShape, outerParams: ResolvedParams, inner: RegionShape, innerParams: ResolvedParams, options?: StrictFinderOptions): RingKind | 'unsteady' | null;
+/**
+ * Everything the strict reader's own tests find wrong with a ring and a
+ * centre as a QR finder. Empty when the ring traces as it says it does and
+ * the strict search finds the pair at every density, phase and roll.
+ */
+export declare function strictFinderProblems(outer: RegionShape, outerParams: ResolvedParams, inner: RegionShape, innerParams: ResolvedParams, options?: StrictFinderOptions): StrictFinderProblem[];
+//# sourceMappingURL=finder.d.ts.map

package/dist/conformance/finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.d.ts","sourceRoot":"","sources":["../../src/conformance/finder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAKhF,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAA0B,CAAC;AACzE,sDAAsD;AACtD,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAwC,CAAC;AAOpF,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,yGAAyG;IACzG,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IACnC,uIAAuI;IACvI,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,0HAA0H;AAC1H,wBAAgB,aAAa,CAC5B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,cAAc,EAC3B,YAAY,EAAE,MAAM,EACpB,KAAK,SAAI,EACT,IAAI,SAAI,GACN,aAAa,CA0Bf;AAED,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAI7F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,cAAc,EAC3B,OAAO,GAAE,mBAAwB,GAC/B,QAAQ,GAAG,UAAU,GAAG,IAAI,CAW9B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,cAAc,EAC3B,OAAO,GAAE,mBAAwB,GAC/B,mBAAmB,EAAE,CA8BvB"}

package/dist/conformance/finder.js

@@ -0,0 +1,125 @@
+/**
+ * A ring and a centre put to the strict reader's own finder tests.
+ *
+ * The design layer judges a finder by a model of the strict reader (runs at
+ * 4 pixels a module with sub-pixel edges, see design/finder.ts), because it
+ * runs wherever a design is validated or drawn and the root of the package
+ * must not pull in the decoder. This file asks the decoder itself, so that
+ * conformance can hold the model and the catalogue to it:
+ *
+ * - `ringKind`, the strict profile's test of whether a reader that traces a
+ *   finder ring's sides can follow it, through the grid the pair was drawn
+ *   on. It must come out the same at every density and phase drawn here, and
+ *   be what the ring says it is (`RegionShape.ringKind`), because that
+ *   declaration is all the validator has to go on.
+ * - `strictFindsFinder`, the strict profile's finder search, which must find
+ *   the pair at every density and phase drawn here.
+ *
+ * The pair is drawn at 6 and 8 pixels a module, the densities the scan check
+ * reads most of its captures at, each at four sub-pixel phases, in 13
+ * modules of white: `ringKind` looks 5.6 modules out from the centre along
+ * the diagonals, so the box of 7 needs 3 to spare on each side.
+ *
+ * Only the 7 by 7 finder is asked. The decoder's search is for 1:1:3:1:1,
+ * and the other kinds (an alignment pattern, rMQR's sub-finder) are found by
+ * sampling where they are known to be, which the model already covers.
+ */
+import { toGrey } from '../decode/grey.js';
+import { ringKind, strictFindsFinder } from '../decode/strict.js';
+import { regionPath, ringKindOf } from '../design/finder.js';
+import { rotate } from '../geometry/matrix.js';
+import { PathBuilder } from '../geometry/path.js';
+import { rasterise } from '../render/raster.js';
+/** Pixels a module the pair is drawn at. */
+export const STRICT_DENSITIES = Object.freeze([6, 8]);
+/** Sub-pixel offsets of the pair's box, in pixels. */
+export const STRICT_PHASES = Object.freeze([0, 0.25, 0.5, 0.75]);
+/** Modules of white on each side of the 7 module box. */
+const MARGIN = 3;
+const SPAN = 7 + 2 * MARGIN;
+/** How a ring the strict reader cannot measure is named in a problem. */
+const UNMEASURED = 'nothing it can measure';
+/** A ring and a centre as the 7 by 7 finder, black on white, `phase` pixels off the grid and turned by `roll` degrees. */
+export function finderPicture(outer, outerParams, inner, innerParams, modulePixels, phase = 0, roll = 0) {
+    const offset = MARGIN + phase / modulePixels;
+    const both = new PathBuilder()
+        .append(regionPath(outer, 'concentric-7', outerParams, offset, offset))
+        .append(regionPath(inner, 'concentric-7', innerParams, offset, offset))
+        .build();
+    const centre = offset + 3.5;
+    const path = roll === 0
+        ? both
+        : new PathBuilder()
+            .transform(rotate(roll, centre, centre))
+            .append(both)
+            .build();
+    const image = rasterise({
+        width: SPAN,
+        height: SPAN,
+        background: { kind: 'solid', colour: { r: 255, g: 255, b: 255, a: 1 } },
+        layers: [
+            { kind: 'path', path, paint: { kind: 'solid', colour: { r: 0, g: 0, b: 0, a: 1 } } },
+        ],
+    }, { width: SPAN * modulePixels });
+    return { grey: toGrey(image), centre: centre * modulePixels, offset };
+}
+/** What the strict profile makes of the ring in this picture, through the grid it was drawn on. */
+export function pictureRingKind(picture, modulePixels) {
+    const m = modulePixels;
+    const at = picture.offset * m;
+    return ringKind(picture.grey, [m, 0, at, 0, m, at, 0, 0, 1], 3.5, 3.5);
+}
+/**
+ * The ring's kind as the strict profile measures it round this centre: the
+ * kind, `unsteady` when the densities and phases disagree, or null when it
+ * cannot be measured at all.
+ */
+export function measureRingKind(outer, outerParams, inner, innerParams, options = {}) {
+    const kinds = new Set();
+    for (const m of options.densities ?? STRICT_DENSITIES) {
+        for (const phase of options.phases ?? STRICT_PHASES) {
+            kinds.add(pictureRingKind(finderPicture(outer, outerParams, inner, innerParams, m, phase), m));
+        }
+    }
+    if (kinds.has(null))
+        return null;
+    return kinds.size === 1 ? [...kinds][0] : 'unsteady';
+}
+/**
+ * Everything the strict reader's own tests find wrong with a ring and a
+ * centre as a QR finder. Empty when the ring traces as it says it does and
+ * the strict search finds the pair at every density, phase and roll.
+ */
+export function strictFinderProblems(outer, outerParams, inner, innerParams, options = {}) {
+    const problems = [];
+    const kinds = new Set();
+    const missed = [];
+    for (const m of options.densities ?? STRICT_DENSITIES) {
+        for (const phase of options.phases ?? STRICT_PHASES) {
+            for (const roll of options.rolls ?? [0]) {
+                const picture = finderPicture(outer, outerParams, inner, innerParams, m, phase, roll);
+                if (roll === 0)
+                    kinds.add(pictureRingKind(picture, m) ?? UNMEASURED);
+                const centre = { x: picture.centre, y: picture.centre };
+                if (!strictFindsFinder(picture.grey, centre, m)) {
+                    missed.push(`${m} px phase ${phase}${roll === 0 ? '' : ` roll ${roll}`}`);
+                }
+            }
+        }
+    }
+    const said = ringKindOf(outer);
+    if (kinds.size > 0 && (kinds.size > 1 || !kinds.has(said))) {
+        problems.push({
+            rule: 'ring-kind',
+            detail: `the ring says it is ${said} and the strict reader traces it as ${[...kinds].sort().join(', ')}`,
+        });
+    }
+    if (missed.length > 0) {
+        problems.push({
+            rule: 'strict-finder',
+            detail: `the strict reader's finder search misses the pair at ${missed.join(', ')}`,
+        });
+    }
+    return problems;
+}
+//# sourceMappingURL=finder.js.map

package/dist/conformance/finder.js.map

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

package/dist/conformance/frame.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Conformance for frames.
+ *
+ * A frame decorates the space round the quiet zone and must never draw in
+ * it: the quiet zone is how a reader finds where the code stops, and ink in
+ * it is the commonest way a styled code fails. Each frame is laid out round
+ * the smallest and largest QR codes and round Micro QR and rMQR sizes, at its
+ * defaults and the ends of its ranges, and the quiet zone box is rasterised
+ * on its own: any coverage at all inside it is a violation. Its caption box
+ * must sit inside the artwork and outside the quiet zone, and a frame that
+ * takes a caption must reserve one.
+ */
+import type { FrameEntry } from '../design/types.js';
+import type { Violation } from './types.js';
+export interface FrameSize {
+    readonly width: number;
+    readonly height: number;
+    readonly quietZone: number;
+}
+/** QR versions 1 and 40, Micro QR M1, and the shortest and longest rMQR. */
+export declare const FRAME_SIZES: readonly FrameSize[];
+export interface FrameCheckOptions {
+    readonly sizes?: readonly FrameSize[];
+    readonly seed?: number;
+    readonly mixtures?: number;
+}
+export declare function checkFrame(frame: FrameEntry, options?: FrameCheckOptions): Violation[];
+//# sourceMappingURL=frame.d.ts.map

package/dist/conformance/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/conformance/frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,oBAAoB,CAAC;AAIlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,4EAA4E;AAC5E,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAM1C,CAAC;AAKH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AAoCD,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,SAAS,EAAE,CAkF1F"}