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

package/dist/segment/write.js

@@ -0,0 +1,226 @@
+/**
+ * Writing segments into a bitstream, and measuring them without writing.
+ *
+ * The order of a bitstream's headers follows ISO/IEC 18004 and the readers
+ * that check it: structured append first (8.3: "at the beginning of the bit
+ * stream"), then the ECI the first segment carries, then FNC1, then the
+ * segments, with a new ECI wherever a segment's differs from the one in force.
+ * zxing's encoder writes ECI before FNC1 in the same way, which is the
+ * combination most readers have actually seen.
+ *
+ * Everything here is a caller's bug when it is wrong (a count longer than its
+ * field, a digit segment holding a letter), never a person's content, so the
+ * checks throw TypeError and RangeError and say nothing about the data.
+ */
+import { eciDesignatorBits, eciDesignatorValue } from './eci.js';
+import { kanjiValue, validKanjiCode } from './kanji.js';
+import { alphanumericValue } from './alphanumeric.js';
+/** Bits a segment's characters take, without its header. */
+export function dataBitLength(mode, chars) {
+    switch (mode) {
+        case 'numeric':
+            return 10 * Math.floor(chars / 3) + [0, 4, 7][chars % 3];
+        case 'alphanumeric':
+            return 11 * Math.floor(chars / 2) + 6 * (chars % 2);
+        case 'byte':
+            return 8 * chars;
+        case 'kanji':
+            return 13 * chars;
+        default:
+            throw new TypeError('that is not a mode');
+    }
+}
+function indicator(profile, kind) {
+    const value = profile.modeIndicator(kind);
+    if (value === undefined) {
+        throw new TypeError(`this bitstream profile has no ${kind} indicator`);
+    }
+    return value;
+}
+/**
+ * The ECI designators `writeSegments` writes, in order, one for each segment
+ * whose ECI differs from the one in force.
+ */
+function eciChanges(segments) {
+    let active;
+    return segments.map((segment) => {
+        if (segment.eci === undefined || segment.eci === active)
+            return undefined;
+        active = segment.eci;
+        return segment.eci;
+    });
+}
+/**
+ * Bits the segments take, ECI designators included, header and terminator
+ * not: those are `headerBitLength` and the symbol's business.
+ */
+export function segmentsBitLength(segments, profile) {
+    let bits = 0;
+    const changes = eciChanges(segments);
+    segments.forEach((segment, i) => {
+        const eci = changes[i];
+        if (eci !== undefined)
+            bits += profile.modeIndicatorBits + eciDesignatorBits(eci);
+        bits +=
+            profile.modeIndicatorBits +
+                profile.charCountBits(segment.mode) +
+                dataBitLength(segment.mode, segment.chars);
+    });
+    return bits;
+}
+/** Bits the structured append and FNC1 headers take. */
+export function headerBitLength(header, profile) {
+    let bits = 0;
+    if (header?.structuredAppend !== undefined)
+        bits += profile.modeIndicatorBits + 16;
+    if (header?.fnc1 !== undefined) {
+        bits += profile.modeIndicatorBits + (header.fnc1 === 'gs1' ? 0 : 8);
+    }
+    return bits;
+}
+/**
+ * Whether an FNC1 application indicator is one ISO/IEC 18004 7.4.8.3 allows:
+ * a two-digit number 00 to 99, or a letter as its ASCII value plus 100.
+ */
+export function validApplicationIndicator(value) {
+    return (Number.isInteger(value) &&
+        ((value >= 0 && value <= 99) ||
+            (value >= 165 && value <= 190) ||
+            (value >= 197 && value <= 222)));
+}
+function checkHeader(header, profile) {
+    const append = header.structuredAppend;
+    if (append !== undefined) {
+        if (!profile.structuredAppend) {
+            throw new TypeError('this bitstream profile has no structured append');
+        }
+        const { index, total, parity } = append;
+        if (!Number.isInteger(total) || total < 1 || total > 16) {
+            throw new RangeError('a structured append set has 1 to 16 symbols');
+        }
+        if (!Number.isInteger(index) || index < 0 || index >= total) {
+            throw new RangeError('a structured append index is 0 to one less than the total');
+        }
+        if (!Number.isInteger(parity) || parity < 0 || parity > 255) {
+            throw new RangeError('a structured append parity is one byte');
+        }
+    }
+    const { fnc1 } = header;
+    if (fnc1 !== undefined) {
+        if (!profile.fnc1)
+            throw new TypeError('this bitstream profile has no FNC1');
+        if (fnc1 !== 'gs1' && !validApplicationIndicator(fnc1.applicationIndicator)) {
+            throw new RangeError('an FNC1 application indicator is 00 to 99, or a letter plus 100');
+        }
+    }
+}
+function checkSegment(segment, profile) {
+    const { mode, chars, data } = segment;
+    if (!profile.modes.includes(mode)) {
+        throw new TypeError(`this bitstream profile has no ${mode} mode`);
+    }
+    if (!Number.isInteger(chars) || chars < 0 || chars >= 1 << profile.charCountBits(mode)) {
+        throw new RangeError(`a ${mode} segment here holds 0 to ${(1 << profile.charCountBits(mode)) - 1} characters`);
+    }
+    const expected = mode === 'kanji' ? chars * 2 : chars;
+    if (data.length !== expected) {
+        throw new RangeError(`a ${mode} segment of ${chars} characters has ${expected} data bytes`);
+    }
+    const step = mode === 'kanji' ? 2 : 1;
+    for (let i = 0; i < data.length; i += step) {
+        const byte = data[i];
+        const valid = mode === 'numeric'
+            ? byte >= 0x30 && byte <= 0x39
+            : mode === 'alphanumeric'
+                ? alphanumericValue(byte) >= 0
+                : mode === 'kanji'
+                    ? validKanjiCode((byte << 8) | data[i + 1])
+                    : true;
+        if (!valid)
+            throw new RangeError(`a ${mode} segment holds a byte that mode cannot carry`);
+    }
+}
+function writeData(segment, out) {
+    const { data } = segment;
+    switch (segment.mode) {
+        case 'numeric': {
+            let i = 0;
+            for (; i + 3 <= data.length; i += 3) {
+                out.append((data[i] - 0x30) * 100 +
+                    (data[i + 1] - 0x30) * 10 +
+                    (data[i + 2] - 0x30), 10);
+            }
+            if (data.length - i === 2) {
+                out.append((data[i] - 0x30) * 10 + (data[i + 1] - 0x30), 7);
+            }
+            else if (data.length - i === 1) {
+                out.append(data[i] - 0x30, 4);
+            }
+            return;
+        }
+        case 'alphanumeric': {
+            let i = 0;
+            for (; i + 2 <= data.length; i += 2) {
+                out.append(alphanumericValue(data[i]) * 45 + alphanumericValue(data[i + 1]), 11);
+            }
+            if (i < data.length)
+                out.append(alphanumericValue(data[i]), 6);
+            return;
+        }
+        case 'byte':
+            for (let i = 0; i < data.length; i += 1)
+                out.append(data[i], 8);
+            return;
+        case 'kanji':
+            for (let i = 0; i < data.length; i += 2) {
+                const code = (data[i] << 8) | data[i + 1];
+                out.append(kanjiValue(code), 13);
+            }
+            return;
+    }
+}
+function writeEci(designator, profile, out) {
+    if (!profile.eci)
+        throw new TypeError('this bitstream profile has no ECI');
+    out.append(indicator(profile, 'eci'), profile.modeIndicatorBits);
+    out.append(eciDesignatorValue(designator), eciDesignatorBits(designator));
+}
+/**
+ * Append the header and the segments to `out`. The terminator and padding are
+ * left to the caller, which knows the symbol's capacity.
+ */
+export function writeSegments(segments, profile, out, header = {}) {
+    checkHeader(header, profile);
+    for (const segment of segments)
+        checkSegment(segment, profile);
+    const changes = eciChanges(segments);
+    const bits = profile.modeIndicatorBits;
+    const append = header.structuredAppend;
+    if (append !== undefined) {
+        out.append(indicator(profile, 'structured-append'), bits);
+        out.append(append.index, 4);
+        out.append(append.total - 1, 4);
+        out.append(append.parity, 8);
+    }
+    // The first segment's ECI goes before FNC1, as zxing writes it.
+    const first = changes[0];
+    if (first !== undefined)
+        writeEci(first, profile, out);
+    const { fnc1 } = header;
+    if (fnc1 === 'gs1') {
+        out.append(indicator(profile, 'fnc1-first'), bits);
+    }
+    else if (fnc1 !== undefined) {
+        out.append(indicator(profile, 'fnc1-second'), bits);
+        out.append(fnc1.applicationIndicator, 8);
+    }
+    segments.forEach((segment, i) => {
+        const eci = changes[i];
+        if (i > 0 && eci !== undefined)
+            writeEci(eci, profile, out);
+        out.append(indicator(profile, segment.mode), bits);
+        out.append(segment.chars, profile.charCountBits(segment.mode));
+        writeData(segment, out);
+    });
+}
+//# sourceMappingURL=write.js.map

package/dist/segment/write.js.map

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

package/dist/studio/assets.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A design's embedded pictures, decoded once.
+ *
+ * A design carries its logo as base64 PNG so it can be saved and opened
+ * anywhere, and the scene builder wants pixels. Decoding a 1024 pixel logo on
+ * every keystroke would be most of the cost of a preview, so each picture is
+ * decoded the first time it is drawn and kept, keyed by its own text: the
+ * same picture in two designs, or in a design and its undo step, is decoded
+ * once. The cache holds a few pictures, since a design holds at most four.
+ */
+import type { RgbaImage } from '../core/image.js';
+import type { QrDesignV1 } from '../design/types.js';
+export declare class AssetCache {
+    private readonly decoded;
+    /** The picture behind `png`, or null when it will not decode. */
+    image(png: string): RgbaImage | null;
+    /** The lookup buildScene takes, for one design. */
+    lookup(design: QrDesignV1): (id: string) => RgbaImage | undefined;
+    /** Every picture a design embeds, decoded, for a verify job a worker can rebuild from. */
+    all(design: QrDesignV1): Readonly<Record<string, RgbaImage>> | undefined;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/studio/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/studio/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,iEAAiE;IACjE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IA2BpC,mDAAmD;IACnD,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS;IAOjE,0FAA0F;IAC1F,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,SAAS;CAUxE"}

package/dist/studio/assets.js

@@ -0,0 +1,66 @@
+/**
+ * A design's embedded pictures, decoded once.
+ *
+ * A design carries its logo as base64 PNG so it can be saved and opened
+ * anywhere, and the scene builder wants pixels. Decoding a 1024 pixel logo on
+ * every keystroke would be most of the cost of a preview, so each picture is
+ * decoded the first time it is drawn and kept, keyed by its own text: the
+ * same picture in two designs, or in a design and its undo step, is decoded
+ * once. The cache holds a few pictures, since a design holds at most four.
+ */
+import { base64Decode } from '../design/base64.js';
+import { LIMITS } from '../design/document.js';
+import { decodePng } from '../render/png-decode.js';
+const KEEP = 8;
+export class AssetCache {
+    decoded = new Map();
+    /** The picture behind `png`, or null when it will not decode. */
+    image(png) {
+        if (this.decoded.has(png)) {
+            const found = this.decoded.get(png);
+            // Moved to the end, so the cache forgets the least recently drawn.
+            this.decoded.delete(png);
+            this.decoded.set(png, found);
+            return found;
+        }
+        let image = null;
+        const bytes = base64Decode(png);
+        if (bytes !== null) {
+            try {
+                image = decodePng(bytes, { maxPixels: LIMITS.assetSide * LIMITS.assetSide });
+            }
+            catch {
+                // The validator checked the signature and the size; a picture
+                // damaged past that is drawn as missing, and the scene says so.
+                image = null;
+            }
+        }
+        this.decoded.set(png, image);
+        while (this.decoded.size > KEEP) {
+            const oldest = this.decoded.keys().next().value;
+            this.decoded.delete(oldest);
+        }
+        return image;
+    }
+    /** The lookup buildScene takes, for one design. */
+    lookup(design) {
+        return (id) => {
+            const asset = design.assets?.[id];
+            return asset === undefined ? undefined : (this.image(asset.png) ?? undefined);
+        };
+    }
+    /** Every picture a design embeds, decoded, for a verify job a worker can rebuild from. */
+    all(design) {
+        const assets = design.assets;
+        if (assets === undefined)
+            return undefined;
+        const out = {};
+        for (const [id, asset] of Object.entries(assets)) {
+            const image = this.image(asset.png);
+            if (image !== null)
+                out[id] = image;
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=assets.js.map

package/dist/studio/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/studio/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,IAAI,GAAG,CAAC,CAAC;AAEf,MAAM,OAAO,UAAU;IACL,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE/D,iEAAiE;IACjE,KAAK,CAAC,GAAW;QAChB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAqB,CAAC;YACxD,mEAAmE;YACnE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7B,OAAO,KAAK,CAAC;QACd,CAAC;QACD,IAAI,KAAK,GAAqB,IAAI,CAAC;QACnC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC;gBACJ,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAC9E,CAAC;YAAC,MAAM,CAAC;gBACR,8DAA8D;gBAC9D,gEAAgE;gBAChE,KAAK,GAAG,IAAI,CAAC;YACd,CAAC;QACF,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC;YAC1D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,MAAM,CAAC,MAAkB;QACxB,OAAO,CAAC,EAAE,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YAClC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC;QAC/E,CAAC,CAAC;IACH,CAAC;IAED,0FAA0F;IAC1F,GAAG,CAAC,MAAkB;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,GAAG,GAA8B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,KAAK,KAAK,IAAI;gBAAE,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;QACrC,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;CACD"}

package/dist/studio/catalogue.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Everything a person can choose from, as a view lists it.
+ *
+ * Built from the registries, so a shape, frame, preset or content type a
+ * caller registers appears in both interfaces with no view code. The
+ * catalogue is rebuilt only when a registry's version moves, which keeps its
+ * identity stable for a memoised view, and each entry draws its thumbnail on
+ * the first call and keeps it: a gallery nobody opens costs nothing.
+ *
+ * Thumbnails are drawn from fixed samples (a small pattern for module shapes,
+ * a finder for rings and centres, a sample code for frames and presets), so
+ * the same registries give the same pictures. The sample code holds
+ * `https://example.com/`; presets are drawn again with the visitor's own code
+ * by `presetThumbnails`, once there is one.
+ */
+import type { DesignConstraints, FontRegistry } from '../design/types.js';
+import type { Registries } from '../registries.js';
+import type { BuiltSymbol } from '../symbology/types.js';
+import type { Catalogue, PresetThumbnails } from './types.js';
+/** The content of every sample code. Reserved for examples by RFC 2606. */
+export declare const SAMPLE_CONTENT = "https://example.com/";
+/** A key for the registries' versions together: the catalogue is rebuilt when it changes. */
+export declare function registryVersions(registries: Registries): string;
+/** The sample code the thumbnails that need a whole code are drawn on. */
+export declare function sampleSymbol(registries: Registries): BuiltSymbol;
+/** The catalogue for these registries as they stand. */
+export declare function buildCatalogue(registries: Registries, fonts?: FontRegistry): Catalogue;
+/**
+ * Preset pictures drawn with `symbol`, the visitor's own code. Each is drawn
+ * when first asked for and kept for as long as the code is the same; without
+ * a code of their own, the catalogue's sample pictures stand in.
+ */
+export declare function presetThumbnails(registries: Registries, catalogue: Catalogue, symbol: BuiltSymbol | null, constraints?: DesignConstraints, fonts?: FontRegistry): PresetThumbnails;
+//# sourceMappingURL=catalogue.d.ts.map

package/dist/studio/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../src/studio/catalogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,KAAK,EACX,iBAAiB,EAEjB,YAAY,EAMZ,MAAM,oBAAoB,CAAC;AAO5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EACX,SAAS,EAMT,gBAAgB,EAGhB,MAAM,YAAY,CAAC;AAEpB,2EAA2E;AAC3E,eAAO,MAAM,cAAc,yBAAyB,CAAC;AAkCrD,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAY/D;AAsJD,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAEhE;AAuCD,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAoJtF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,WAAW,CAAC,EAAE,iBAAiB,EAC/B,KAAK,CAAC,EAAE,YAAY,GAClB,gBAAgB,CA8BlB"}