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

package/dist/text/truetype.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Reading a TrueType font file, for fonts the website lets a person add.
+ *
+ * Only what drawing a caption needs is read: the table directory, `head`,
+ * `hhea`, `maxp`, `hmtx`, `loca`, `glyf`, `cmap` (formats 4 and 12), and
+ * kerning from GPOS or `kern`. Hinting, names, substitution and everything
+ * else are left alone, which also means nothing in them can trip the parser.
+ * A font with PostScript outlines (`OTTO`), a collection, or a WOFF wrapper is
+ * refused as a format this reader does not handle.
+ *
+ * The parser is strict and does its checking up front. Every table is
+ * bounded by the directory, every glyph is decoded once, the composite graph
+ * is walked with a depth and size limit, the character map and the kerning
+ * subtables are checked in full, and anything out of place throws
+ * `FontMalformedError` ('font/malformed'). The work is bounded by the size of
+ * the file, and a font that parses can draw every glyph it has without
+ * another check failing.
+ */
+import type { Glyphs } from './glyf.js';
+import type { Font } from './types.js';
+/** The largest file this reader will look at: a full CJK face is about a quarter of it. */
+export declare const MAX_FONT_BYTES: number;
+export interface ParseFontOptions {
+    /** The id it is registered under: kebab-case. */
+    readonly id: string;
+    /** What a font picker calls it. Defaults to 'text.font.registered'. */
+    readonly labelKey?: string;
+}
+/**
+ * Parse a TrueType font. Throws `FontMalformedError` for anything this reader
+ * cannot use; throws a TypeError for an argument of the wrong kind.
+ */
+export declare function parseTrueType(bytes: Uint8Array, options: ParseFontOptions): Font;
+/**
+ * The font, with the glyph records behind it.
+ *
+ * For the build script, which keeps composite glyphs as composites when it
+ * compiles the built-in family, and so needs them unresolved.
+ */
+export declare function parseTrueTypeTables(bytes: Uint8Array, options: ParseFontOptions): {
+    readonly font: Font;
+    readonly glyphs: Glyphs;
+};
+//# sourceMappingURL=truetype.d.ts.map

package/dist/text/truetype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truetype.d.ts","sourceRoot":"","sources":["../../src/text/truetype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,2FAA2F;AAC3F,eAAO,MAAM,cAAc,QAAmB,CAAC;AAI/C,MAAM,WAAW,gBAAgB;IAChC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AA0BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,gBAAgB,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA8DlD"}

package/dist/text/truetype.js

@@ -0,0 +1,127 @@
+/**
+ * Reading a TrueType font file, for fonts the website lets a person add.
+ *
+ * Only what drawing a caption needs is read: the table directory, `head`,
+ * `hhea`, `maxp`, `hmtx`, `loca`, `glyf`, `cmap` (formats 4 and 12), and
+ * kerning from GPOS or `kern`. Hinting, names, substitution and everything
+ * else are left alone, which also means nothing in them can trip the parser.
+ * A font with PostScript outlines (`OTTO`), a collection, or a WOFF wrapper is
+ * refused as a format this reader does not handle.
+ *
+ * The parser is strict and does its checking up front. Every table is
+ * bounded by the directory, every glyph is decoded once, the composite graph
+ * is walked with a depth and size limit, the character map and the kerning
+ * subtables are checked in full, and anything out of place throws
+ * `FontMalformedError` ('font/malformed'). The work is bounded by the size of
+ * the file, and a font that parses can draw every glyph it has without
+ * another check failing.
+ */
+import { malformed } from './errors.js';
+import { makeFont } from './font.js';
+import { parseCmap } from './cmap.js';
+import { parseGlyphs, resolveGlyph } from './glyf.js';
+import { parseKerning } from './kerning.js';
+import { Table } from './reader.js';
+/** The largest file this reader will look at: a full CJK face is about a quarter of it. */
+export const MAX_FONT_BYTES = 64 * 1024 * 1024;
+const KEBAB = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+function directory(bytes) {
+    const file = new Table(bytes, 0, bytes.length, 'file');
+    const version = file.u32(0);
+    // 0x00010000, or 'true' as some old Apple fonts write it.
+    if (version !== 0x00010000 && version !== 0x74727565)
+        malformed('file', 'unsupported');
+    const count = file.u16(4);
+    const tables = new Map();
+    for (let i = 0; i < count; i += 1) {
+        const at = 12 + i * 16;
+        const tag = file.tagAt(at);
+        const offset = file.u32(at + 8);
+        const length = file.u32(at + 12);
+        // Checksums are not checked: browsers do not, and fonts in the wild get
+        // them wrong without anything else being wrong.
+        const table = file.slice(offset, length);
+        if (!tables.has(tag))
+            tables.set(tag, new Table(bytes, table.start, length, tag));
+    }
+    return tables;
+}
+function required(tables, tag) {
+    return tables.get(tag) ?? malformed(tag, 'missing-table');
+}
+/**
+ * Parse a TrueType font. Throws `FontMalformedError` for anything this reader
+ * cannot use; throws a TypeError for an argument of the wrong kind.
+ */
+export function parseTrueType(bytes, options) {
+    return parseTrueTypeTables(bytes, options).font;
+}
+/**
+ * The font, with the glyph records behind it.
+ *
+ * For the build script, which keeps composite glyphs as composites when it
+ * compiles the built-in family, and so needs them unresolved.
+ */
+export function parseTrueTypeTables(bytes, options) {
+    if (!(bytes instanceof Uint8Array))
+        throw new TypeError('parseTrueType: bytes is a Uint8Array.');
+    if (typeof options !== 'object' || options === null || typeof options.id !== 'string') {
+        throw new TypeError('parseTrueType: options gives at least the id.');
+    }
+    if (!KEBAB.test(options.id))
+        throw new TypeError('parseTrueType: the id must be kebab-case.');
+    const labelKey = options.labelKey ?? 'text.font.registered';
+    if (typeof labelKey !== 'string')
+        throw new TypeError('parseTrueType: labelKey is a string.');
+    if (bytes.length > MAX_FONT_BYTES)
+        malformed('file', 'too-large');
+    const tables = directory(bytes);
+    const head = required(tables, 'head');
+    if (head.u16(0) !== 1 || head.u32(12) !== 0x5f0f3cf5)
+        malformed('head', 'unsupported');
+    const unitsPerEm = head.u16(18);
+    if (unitsPerEm < 16 || unitsPerEm > 16384)
+        malformed('head', 'out-of-range');
+    const locaFormat = head.i16(50);
+    if (locaFormat !== 0 && locaFormat !== 1)
+        malformed('head', 'out-of-range');
+    const maxp = required(tables, 'maxp');
+    const maxpVersion = maxp.u32(0);
+    if (maxpVersion !== 0x00005000 && maxpVersion !== 0x00010000)
+        malformed('maxp', 'unsupported');
+    const glyphCount = maxp.u16(4);
+    if (glyphCount === 0)
+        malformed('maxp', 'out-of-range');
+    const hhea = required(tables, 'hhea');
+    hhea.need(0, 36);
+    const ascender = hhea.i16(4);
+    const descender = hhea.i16(6);
+    const lineGap = hhea.i16(8);
+    const metrics = hhea.u16(34);
+    if (metrics === 0 || metrics > glyphCount)
+        malformed('hhea', 'out-of-range');
+    const hmtx = required(tables, 'hmtx');
+    hmtx.need(0, metrics * 4 + (glyphCount - metrics) * 2);
+    const advances = new Uint16Array(glyphCount);
+    for (let i = 0; i < glyphCount; i += 1) {
+        advances[i] = hmtx.u16(Math.min(i, metrics - 1) * 4);
+    }
+    const glyphs = parseGlyphs(required(tables, 'glyf'), required(tables, 'loca'), glyphCount, locaFormat === 1);
+    const glyphIndex = parseCmap(required(tables, 'cmap'), glyphCount);
+    const kerning = parseKerning(tables.get('GPOS') ?? null, tables.get('kern') ?? null);
+    const font = makeFont({
+        id: options.id,
+        labelKey,
+        unitsPerEm,
+        ascender,
+        descender,
+        lineGap,
+        glyphCount,
+        glyphIndex,
+        advance: (glyph) => advances[glyph],
+        kerning,
+        outline: (glyph) => resolveGlyph(glyphs, glyph),
+    });
+    return { font, glyphs };
+}
+//# sourceMappingURL=truetype.js.map

package/dist/text/truetype.js.map

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

package/dist/text/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The shapes the text layer hands out: a font, a glyph's outline, and a laid
+ * out caption.
+ *
+ * A caption in an export is never live text. It is drawn as filled paths, so
+ * a PDF or an SVG of a design looks the same on a machine that has never seen
+ * the font, the scan check sees exactly what is printed, and nothing in a
+ * file can be selected, searched or copied out of it.
+ */
+import type { MessageKey } from '../core/issue.js';
+import type { Registry } from '../core/registry.js';
+import type { Path } from '../geometry/path.js';
+/**
+ * One glyph's contours as the font stores them: TrueType quadratic points in
+ * font units, y up, composite glyphs already resolved into their components.
+ */
+export interface GlyphOutline {
+    /** x, y pairs. */
+    readonly points: Float64Array;
+    /** 1 where the point is on the curve, 0 where it is a quadratic control point. */
+    readonly onCurve: Uint8Array;
+    /** One past the last point of each contour, in order. */
+    readonly ends: readonly number[];
+}
+/**
+ * A font the layout can draw with.
+ *
+ * Glyphs are numbered as the font numbers them, and glyph 0 is the font's
+ * "missing" glyph, which this package never draws: a code point the font has
+ * no glyph for is reported, never substituted.
+ */
+export interface Font {
+    /** Kebab-case, unique within a registry. Travels in design files. */
+    readonly id: string;
+    /** What a font picker calls it. */
+    readonly labelKey: MessageKey;
+    /** Font units to the em. */
+    readonly unitsPerEm: number;
+    /** The line box above the baseline, in font units (positive). */
+    readonly ascender: number;
+    /** The line box below the baseline, in font units (negative or zero). */
+    readonly descender: number;
+    readonly lineGap: number;
+    readonly glyphCount: number;
+    /** The glyph for a code point, or 0 when the font has none. */
+    glyphIndex(codePoint: number): number;
+    /** How far the pen moves after the glyph, in font units. */
+    advance(glyph: number): number;
+    /** The adjustment to the pen between two glyphs, in font units, added after `left`'s advance. */
+    kerning(left: number, right: number): number;
+    outline(glyph: number): GlyphOutline;
+    /** The outline as a path in font units, y up, quadratic. The same object on every call. */
+    path(glyph: number): Path;
+}
+/** The built-in family and any font the website registers at runtime. */
+export type FontRegistry = Registry<Font>;
+export type TextAlign = 'start' | 'centre' | 'end';
+export interface TextBox {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface LayoutOptions {
+    /** Where `fontId` is looked up. Defaults to the built-in family. */
+    readonly fonts?: FontRegistry;
+    readonly fontId: string;
+    /** The em size in box units. */
+    readonly size: number;
+    readonly box: TextBox;
+    /** Horizontal alignment within the box. Default 'centre'. */
+    readonly align?: TextAlign;
+    /** Lines beyond this are left out and the result overflows. Default 1. */
+    readonly maxLines?: number;
+    /** Baseline to baseline, as a multiple of the size. Default 1.2. */
+    readonly lineHeight?: number;
+    /** Shrink the size until the text fits, down to `minSize`. Default false. */
+    readonly shrinkToFit?: boolean;
+    /** The floor for `shrinkToFit`. Default half of `size`. */
+    readonly minSize?: number;
+}
+export interface LayoutLine {
+    /** The line's text, as it was given (after NFC), without the spaces it was broken at. */
+    readonly text: string;
+    /** Where the line starts and ends in the normalised text, in UTF-16 code units. */
+    readonly start: number;
+    readonly end: number;
+    /** The pen position at the start of the line, in box units. */
+    readonly x: number;
+    /** The baseline, in box units. */
+    readonly baseline: number;
+    /** The advance width of the line, in box units. */
+    readonly width: number;
+}
+export interface LayoutResult {
+    /** One path a line, in box units, y down. */
+    readonly paths: readonly Path[];
+    readonly lines: readonly LayoutLine[];
+    /** Code points the font has no glyph for, each once, in the order they first appear. */
+    readonly missing: readonly number[];
+    /** True when the text does not fit the box at the size used, or was cut to `maxLines`. */
+    readonly overflow: boolean;
+    /** The size the text was laid out at, after any shrinking. */
+    readonly size: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/text/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,IAAI;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,4DAA4D;IAC5D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,iGAAiG;IACjG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IACrC,2FAA2F;IAC3F,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;AAE1C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB"}

package/dist/text/types.js

@@ -0,0 +1,11 @@
+/**
+ * The shapes the text layer hands out: a font, a glyph's outline, and a laid
+ * out caption.
+ *
+ * A caption in an export is never live text. It is drawn as filled paths, so
+ * a PDF or an SVG of a design looks the same on a machine that has never seen
+ * the font, the scan check sees exactly what is printed, and nothing in a
+ * file can be selected, searched or copied out of it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/text/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/text/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/verify/camera.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The phone camera the scan check assumes, and what it implies about
+ * distance.
+ *
+ * Every number here is a calibration target, not a measurement of one phone.
+ * The owner's scan session (printed test sheets read by the phones people
+ * carry, at measured distances) is what moves them, and each says what it
+ * stands for so that session knows what it is checking.
+ *
+ * The model: a phone in its scanning mode analyses a frame about 1920 pixels
+ * across from its main camera, whose horizontal field of view is about 65
+ * degrees. At a distance D the frame spans 2 D tan(32.5 deg) of the page, so
+ * a module m millimetres wide covers m * 1920 / (2 D tan(32.5 deg)) pixels.
+ * A reader needs at least four pixels a module, so the furthest the code
+ * scans from is m * 1920 / (4 * 2 * tan(32.5 deg)), about 377 module widths.
+ *
+ * And it cannot be held closer than its lens focuses, about 10 cm for the
+ * main camera of most phones, so a module is too small to scan at all when
+ * the phone would have to be closer than that to see it at the pixels a
+ * module the design needs.
+ */
+export declare const CAMERA: Readonly<{
+    /**
+     * Horizontal field of view of a phone's main camera, in degrees. 65 is
+     * near the middle of the 26 mm equivalent lenses phones ship (about 63 to
+     * 70 degrees across the long edge).
+     */
+    fieldOfViewDegrees: 65;
+    /** Pixels across the frame a scanner analyses: a 1080p stream, long edge. */
+    frameWidthPx: 1920;
+    /**
+     * Pixels a module a phone reader needs, at the least. ZXing and the
+     * platform readers sample one pixel per module once the grid is found;
+     * below about four the finder's 1:1:3:1:1 runs blur into each other and
+     * the grid is not found at all.
+     */
+    minPxPerModule: 4;
+    /** The closest a phone's main camera focuses, in millimetres. */
+    minFocusMm: 100;
+    /**
+     * Within this a person has to hold the phone uncomfortably close, in
+     * millimetres: the module size check warns, and printing larger is offered.
+     */
+    comfortMm: 150;
+}>;
+/** tan of half the field of view, from core's sine and cosine. */
+export declare function halfFieldTangent(): number;
+/** Pixels a module covers at `distanceMm`. */
+export declare function pxPerModuleAt(moduleMm: number, distanceMm: number): number;
+/** The distance at which a module covers `pxPerModule` pixels. */
+export declare function distanceFor(moduleMm: number, pxPerModule: number): number;
+/**
+ * The furthest the code scans from: where a module covers the pixels a
+ * reader needs, or more when the design needs more (a thin dot, say).
+ */
+export declare function maxDistanceMm(moduleMm: number, pxPerModule?: number): number;
+/** The smallest module a phone can resolve at its closest focus, for a design that needs `pxPerModule`. */
+export declare function minModuleMm(pxPerModule?: number): number;
+//# sourceMappingURL=camera.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../src/verify/camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,eAAO,MAAM,MAAM;IAClB;;;;OAIG;;IAEH,6EAA6E;;IAE7E;;;;;OAKG;;IAEH,iEAAiE;;IAEjE;;;OAGG;;EAEF,CAAC;AAIH,kEAAkE;AAClE,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAA8B,GACzC,MAAM,CAER;AAED,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,WAAW,GAAE,MAA8B,GAAG,MAAM,CAG/E"}

package/dist/verify/camera.js

@@ -0,0 +1,76 @@
+/**
+ * The phone camera the scan check assumes, and what it implies about
+ * distance.
+ *
+ * Every number here is a calibration target, not a measurement of one phone.
+ * The owner's scan session (printed test sheets read by the phones people
+ * carry, at measured distances) is what moves them, and each says what it
+ * stands for so that session knows what it is checking.
+ *
+ * The model: a phone in its scanning mode analyses a frame about 1920 pixels
+ * across from its main camera, whose horizontal field of view is about 65
+ * degrees. At a distance D the frame spans 2 D tan(32.5 deg) of the page, so
+ * a module m millimetres wide covers m * 1920 / (2 D tan(32.5 deg)) pixels.
+ * A reader needs at least four pixels a module, so the furthest the code
+ * scans from is m * 1920 / (4 * 2 * tan(32.5 deg)), about 377 module widths.
+ *
+ * And it cannot be held closer than its lens focuses, about 10 cm for the
+ * main camera of most phones, so a module is too small to scan at all when
+ * the phone would have to be closer than that to see it at the pixels a
+ * module the design needs.
+ */
+import { PI, cos, sin } from '../core/math.js';
+export const CAMERA = Object.freeze({
+    /**
+     * Horizontal field of view of a phone's main camera, in degrees. 65 is
+     * near the middle of the 26 mm equivalent lenses phones ship (about 63 to
+     * 70 degrees across the long edge).
+     */
+    fieldOfViewDegrees: 65,
+    /** Pixels across the frame a scanner analyses: a 1080p stream, long edge. */
+    frameWidthPx: 1920,
+    /**
+     * Pixels a module a phone reader needs, at the least. ZXing and the
+     * platform readers sample one pixel per module once the grid is found;
+     * below about four the finder's 1:1:3:1:1 runs blur into each other and
+     * the grid is not found at all.
+     */
+    minPxPerModule: 4,
+    /** The closest a phone's main camera focuses, in millimetres. */
+    minFocusMm: 100,
+    /**
+     * Within this a person has to hold the phone uncomfortably close, in
+     * millimetres: the module size check warns, and printing larger is offered.
+     */
+    comfortMm: 150,
+});
+let tangent;
+/** tan of half the field of view, from core's sine and cosine. */
+export function halfFieldTangent() {
+    if (tangent === undefined) {
+        const half = (CAMERA.fieldOfViewDegrees / 2) * (PI / 180);
+        tangent = sin(half) / cos(half);
+    }
+    return tangent;
+}
+/** Pixels a module covers at `distanceMm`. */
+export function pxPerModuleAt(moduleMm, distanceMm) {
+    return (moduleMm * CAMERA.frameWidthPx) / (2 * distanceMm * halfFieldTangent());
+}
+/** The distance at which a module covers `pxPerModule` pixels. */
+export function distanceFor(moduleMm, pxPerModule) {
+    return (moduleMm * CAMERA.frameWidthPx) / (pxPerModule * 2 * halfFieldTangent());
+}
+/**
+ * The furthest the code scans from: where a module covers the pixels a
+ * reader needs, or more when the design needs more (a thin dot, say).
+ */
+export function maxDistanceMm(moduleMm, pxPerModule = CAMERA.minPxPerModule) {
+    return distanceFor(moduleMm, Math.max(pxPerModule, CAMERA.minPxPerModule));
+}
+/** The smallest module a phone can resolve at its closest focus, for a design that needs `pxPerModule`. */
+export function minModuleMm(pxPerModule = CAMERA.minPxPerModule) {
+    const needed = Math.max(pxPerModule, CAMERA.minPxPerModule);
+    return (needed * 2 * CAMERA.minFocusMm * halfFieldTangent()) / CAMERA.frameWidthPx;
+}
+//# sourceMappingURL=camera.js.map

package/dist/verify/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../src/verify/camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,EAAE,EAAE;IACtB,6EAA6E;IAC7E,YAAY,EAAE,IAAI;IAClB;;;;;OAKG;IACH,cAAc,EAAE,CAAC;IACjB,iEAAiE;IACjE,UAAU,EAAE,GAAG;IACf;;;OAGG;IACH,SAAS,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,IAAI,OAA2B,CAAC;AAEhC,kEAAkE;AAClE,MAAM,UAAU,gBAAgB;IAC/B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,kBAAkB,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;QAC1D,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,UAAkB;IACjE,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,GAAG,gBAAgB,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,WAAmB;IAChE,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,GAAG,gBAAgB,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC5B,QAAgB,EAChB,cAAsB,MAAM,CAAC,cAAc;IAE3C,OAAO,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,WAAW,CAAC,cAAsB,MAAM,CAAC,cAAc;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,GAAG,gBAAgB,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;AACpF,CAAC"}

package/dist/verify/capture.d.ts

@@ -0,0 +1,40 @@
+/**
+ * One simulated photograph of a printed design.
+ *
+ * The order is the order things happen to a real code. First the print:
+ * ink spreads or starves, or fades. Then the camera's view: the artwork on a
+ * sheet of paper, turned a little in the frame (nobody holds a phone
+ * square), tilted when the axis is angle, at the pixels a module the
+ * distance gives, each pixel integrating the light over its own area. Then
+ * the lens and sensor: the lens's softness and any defocus, any motion, light
+ * that is dim or uneven, glare, and noise, rounded to bytes once at the end.
+ *
+ * Every random choice comes from a stream forked off the job's seed by axis
+ * and seed index and never by level, so the levels of one seed are the same
+ * photograph with more of one kind of damage, which is what makes a ladder
+ * mean something.
+ */
+import type { RgbaImage } from '../core/image.js';
+import type { Quad } from './homography.js';
+import type { Master } from './prepare.js';
+import type { CaptureAxis } from './types.js';
+export interface CaptureSpec {
+    readonly axis: CaptureAxis | 'baseline';
+    /** In the axis's unit; ignored for the baseline. */
+    readonly level: number;
+    /** 0 to 7. */
+    readonly seed: number;
+    /** Capture pixels a module. For distance, the level itself. */
+    readonly pxPerModule: number;
+}
+export interface CaptureFrame {
+    readonly image: RgbaImage;
+    /** Where the artwork's corners landed, clockwise from top left, in capture pixels. */
+    readonly quad: Quad;
+}
+/**
+ * The capture for one level of one axis and one seed. `sceneWidth` and
+ * `sceneHeight` are the artwork's size in modules.
+ */
+export declare function renderCapture(master: Master, sceneWidth: number, sceneHeight: number, jobSeed: number, spec: CaptureSpec): CaptureFrame;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/verify/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqBlD,OAAO,KAAK,EAAS,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAWnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;IACxC,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,cAAc;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AA4CD,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,GACf,YAAY,CAgEd"}

package/dist/verify/capture.js

@@ -0,0 +1,118 @@
+/**
+ * One simulated photograph of a printed design.
+ *
+ * The order is the order things happen to a real code. First the print:
+ * ink spreads or starves, or fades. Then the camera's view: the artwork on a
+ * sheet of paper, turned a little in the frame (nobody holds a phone
+ * square), tilted when the axis is angle, at the pixels a module the
+ * distance gives, each pixel integrating the light over its own area. Then
+ * the lens and sensor: the lens's softness and any defocus, any motion, light
+ * that is dim or uneven, glare, and noise, rounded to bytes once at the end.
+ *
+ * Every random choice comes from a stream forked off the job's seed by axis
+ * and seed index and never by level, so the levels of one seed are the same
+ * photograph with more of one kind of damage, which is what makes a ladder
+ * mean something.
+ */
+import { PI, cos, sin } from '../core/math.js';
+import { createPrng } from '../core/prng.js';
+import { addNoise, dim, fade, gaussianBlur, glare, lightFalloff, motionBlur, quantise, spreadInk, starveInk, tiltedQuad, toRgba, turnedQuad, warpInto, } from './degrade.js';
+import { BASELINE_LABEL, BASE_BLUR_PX, BASE_NOISE, GLARE_RADIUS, LADDERS, MAX_ROLL_DEGREES, PAPER_MODULES, TILT_CAMERA_DISTANCE, } from './ladders.js';
+const DEGREES = PI / 180;
+function labelOf(axis) {
+    if (axis === 'baseline')
+        return BASELINE_LABEL;
+    return LADDERS.find((ladder) => ladder.axis === axis).label;
+}
+function draws(jobSeed, spec) {
+    const stream = createPrng(jobSeed).fork(labelOf(spec.axis)).fork(spec.seed);
+    const geometry = stream.fork(1);
+    return {
+        roll: (geometry.next() * 2 - 1) * MAX_ROLL_DEGREES * DEGREES,
+        phaseX: geometry.next(),
+        phaseY: geometry.next(),
+        direction: geometry.next() * PI,
+        spotX: geometry.next(),
+        spotY: geometry.next(),
+        noise: stream.fork(2),
+    };
+}
+/** The print, after the axis's print damage. */
+function printed(master, spec) {
+    if (spec.axis === 'ink') {
+        const radius = spec.level * master.scaleX;
+        return spec.seed % 2 === 0 ? spreadInk(master.plane, radius) : starveInk(master.plane, radius);
+    }
+    if (spec.axis === 'contrast')
+        return fade(master.plane, spec.level);
+    return master.plane;
+}
+/**
+ * The capture for one level of one axis and one seed. `sceneWidth` and
+ * `sceneHeight` are the artwork's size in modules.
+ */
+export function renderCapture(master, sceneWidth, sceneHeight, jobSeed, spec) {
+    const d = draws(jobSeed, spec);
+    const ppm = spec.pxPerModule;
+    const width = sceneWidth * ppm;
+    const height = sceneHeight * ppm;
+    const margin = PAPER_MODULES * ppm;
+    // Where the artwork lands in the frame.
+    let corners;
+    if (spec.axis === 'angle') {
+        const tilted = tiltedQuad(width, height, spec.level * DEGREES, d.direction, TILT_CAMERA_DISTANCE);
+        corners = rotatePoints(tilted, d.roll);
+    }
+    else {
+        corners = [...turnedQuad(width, height, d.roll)];
+    }
+    const minX = Math.min(...corners.map((p) => p.x));
+    const minY = Math.min(...corners.map((p) => p.y));
+    const maxX = Math.max(...corners.map((p) => p.x));
+    const maxY = Math.max(...corners.map((p) => p.y));
+    const canvasWidth = Math.ceil(maxX - minX + 2 * margin + 1);
+    const canvasHeight = Math.ceil(maxY - minY + 2 * margin + 1);
+    const quad = corners.map((p) => ({
+        x: p.x - minX + margin + d.phaseX,
+        y: p.y - minY + margin + d.phaseY,
+    }));
+    const source = printed(master, spec);
+    const supersample = Math.min(6, Math.max(2, Math.ceil(master.scaleX / ppm)));
+    let frame = warpInto(source, quad, canvasWidth, canvasHeight, supersample);
+    // The lens, and any defocus.
+    const focus = spec.axis === 'focus' ? spec.level * ppm : 0;
+    frame = gaussianBlur(frame, Math.sqrt(BASE_BLUR_PX * BASE_BLUR_PX + focus * focus));
+    if (spec.axis === 'motion')
+        frame = motionBlur(frame, spec.level * ppm, d.direction);
+    if (spec.axis === 'light') {
+        // Less light reaches the sensor, unevenly; the sensor adds its noise and
+        // rounds to whole levels at that exposure, and then the phone's auto
+        // exposure lifts the picture back up, noise, rounding and all.
+        const near = 1 - 0.5 * spec.level;
+        const far = 1 - spec.level;
+        frame = lightFalloff(frame, near, far, d.direction * 2);
+        frame = quantise(addNoise(frame, BASE_NOISE, d.noise.fork(1)));
+        frame = dim(frame, 2 / (near + far));
+    }
+    if (spec.axis === 'glare') {
+        // Somewhere over the middle half of the artwork.
+        const cx = (quad[0].x + quad[1].x + quad[2].x + quad[3].x) / 4;
+        const cy = (quad[0].y + quad[1].y + quad[2].y + quad[3].y) / 4;
+        const radius = GLARE_RADIUS * Math.min(width, height);
+        frame = glare(frame, spec.level, {
+            cx: cx + (d.spotX - 0.5) * 0.5 * width,
+            cy: cy + (d.spotY - 0.5) * 0.5 * height,
+            rx: radius,
+            ry: radius * 0.75,
+        });
+    }
+    frame = addNoise(frame, spec.axis === 'noise' ? spec.level : BASE_NOISE, d.noise);
+    return { image: toRgba(frame), quad };
+}
+/** Points turned by `radians` about the origin. */
+function rotatePoints(points, radians) {
+    const c = cos(radians);
+    const s = sin(radians);
+    return points.map((p) => ({ x: p.x * c - p.y * s, y: p.x * s + p.y * c }));
+}
+//# sourceMappingURL=capture.js.map

package/dist/verify/capture.js.map

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