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

package/dist/dom/resample.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Reducing a picture by area averaging, in plain arithmetic.
+ *
+ * A logo is stored at no more than 1024 pixels a side, and the reduction has
+ * to be the same in every browser so the same file gives the same design, so
+ * it is done here rather than by a canvas, whose smoothing differs between
+ * engines and is a single bilinear tap in some of them. Every output pixel is
+ * the average of the source area it covers, each source pixel weighted by how
+ * much of it falls inside, which is the reduction a box filter of exactly the
+ * right width gives.
+ *
+ * Colour is averaged premultiplied by alpha, so a transparent pixel's colour,
+ * which nobody sees, does not bleed a dark fringe into the edge of a logo.
+ */
+import type { RgbaImage } from '../core/image.js';
+/** The size `width` by `height` comes to with neither side over `maxSide`, never enlarged. */
+export declare function fitWithin(width: number, height: number, maxSide: number): [number, number];
+/** `image` reduced to `width` by `height` by area averaging. Neither may be larger than the source. */
+export declare function areaAverage(image: RgbaImage, width: number, height: number): RgbaImage;
+//# sourceMappingURL=resample.d.ts.map

package/dist/dom/resample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resample.d.ts","sourceRoot":"","sources":["../../src/dom/resample.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAK1F;AAuBD,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAoEtF"}

package/dist/dom/resample.js

@@ -0,0 +1,107 @@
+/**
+ * Reducing a picture by area averaging, in plain arithmetic.
+ *
+ * A logo is stored at no more than 1024 pixels a side, and the reduction has
+ * to be the same in every browser so the same file gives the same design, so
+ * it is done here rather than by a canvas, whose smoothing differs between
+ * engines and is a single bilinear tap in some of them. Every output pixel is
+ * the average of the source area it covers, each source pixel weighted by how
+ * much of it falls inside, which is the reduction a box filter of exactly the
+ * right width gives.
+ *
+ * Colour is averaged premultiplied by alpha, so a transparent pixel's colour,
+ * which nobody sees, does not bleed a dark fringe into the edge of a logo.
+ */
+/** The size `width` by `height` comes to with neither side over `maxSide`, never enlarged. */
+export function fitWithin(width, height, maxSide) {
+    const longest = Math.max(width, height);
+    if (longest <= maxSide)
+        return [width, height];
+    const scale = maxSide / longest;
+    return [Math.max(1, Math.round(width * scale)), Math.max(1, Math.round(height * scale))];
+}
+/** For each output index, the source indices it covers and how much of each. */
+function spans(source, target) {
+    const ratio = source / target;
+    const out = [];
+    for (let i = 0; i < target; i += 1) {
+        const from = i * ratio;
+        const to = (i + 1) * ratio;
+        const start = Math.floor(from);
+        const end = Math.min(source, Math.ceil(to));
+        const weights = new Float64Array(end - start);
+        for (let s = start; s < end; s += 1) {
+            weights[s - start] = (Math.min(to, s + 1) - Math.max(from, s)) / ratio;
+        }
+        out.push({ start, weights });
+    }
+    return out;
+}
+/** `image` reduced to `width` by `height` by area averaging. Neither may be larger than the source. */
+export function areaAverage(image, width, height) {
+    if (!Number.isInteger(width) ||
+        !Number.isInteger(height) ||
+        width < 1 ||
+        height < 1 ||
+        width > image.width ||
+        height > image.height) {
+        throw new TypeError('areaAverage: the target is a whole number of pixels, 1 to the source size.');
+    }
+    if (width === image.width && height === image.height)
+        return image;
+    const { data } = image;
+    // Premultiplied, horizontal pass first: source rows, target columns.
+    const across = spans(image.width, width);
+    const middle = new Float64Array(width * image.height * 4);
+    for (let y = 0; y < image.height; y += 1) {
+        for (let x = 0; x < width; x += 1) {
+            const { start, weights } = across[x];
+            let r = 0;
+            let g = 0;
+            let b = 0;
+            let a = 0;
+            for (let k = 0; k < weights.length; k += 1) {
+                const at = (y * image.width + start + k) * 4;
+                const w = weights[k];
+                const alpha = data[at + 3] * w;
+                r += data[at] * alpha;
+                g += data[at + 1] * alpha;
+                b += data[at + 2] * alpha;
+                a += alpha;
+            }
+            const to = (y * width + x) * 4;
+            middle[to] = r;
+            middle[to + 1] = g;
+            middle[to + 2] = b;
+            middle[to + 3] = a;
+        }
+    }
+    const down = spans(image.height, height);
+    const out = new Uint8ClampedArray(width * height * 4);
+    for (let y = 0; y < height; y += 1) {
+        const { start, weights } = down[y];
+        for (let x = 0; x < width; x += 1) {
+            let r = 0;
+            let g = 0;
+            let b = 0;
+            let a = 0;
+            for (let k = 0; k < weights.length; k += 1) {
+                const at = ((start + k) * width + x) * 4;
+                const w = weights[k];
+                r += middle[at] * w;
+                g += middle[at + 1] * w;
+                b += middle[at + 2] * w;
+                a += middle[at + 3] * w;
+            }
+            const to = (y * width + x) * 4;
+            if (a > 0) {
+                out[to] = Math.round(r / a);
+                out[to + 1] = Math.round(g / a);
+                out[to + 2] = Math.round(b / a);
+            }
+            out[to + 3] = Math.round(a);
+        }
+    }
+    return { width, height, data: out };
+}
+//# sourceMappingURL=resample.js.map

package/dist/dom/resample.js.map

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

package/dist/dom/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The slices of the browser the adapters use, written as interfaces so a
+ * test can hand in a fake with no more than these members.
+ *
+ * Every adapter takes its browser objects as an injected dependency bag and
+ * falls back to the real globals only when a member is missing, and only at
+ * the moment it is called. Nothing here reads a global at import, which is
+ * what lets hex-web render the studio on a server, and lets this whole layer
+ * be exercised in Node with hand-written fakes (the pattern
+ * google-auth-secret-retriever's src/dom set).
+ */
+import type { RgbaImage } from '../core/image.js';
+/** The part of a canvas this code uses. */
+export interface CanvasLike {
+    width: number;
+    height: number;
+    getContext(type: '2d', options?: {
+        readonly willReadFrequently?: boolean;
+    }): CanvasContextLike | null;
+}
+/** The part of a 2D context this code uses. */
+export interface CanvasContextLike {
+    drawImage(source: never, x: number, y: number, width?: number, height?: number): void;
+    getImageData(x: number, y: number, width: number, height: number): RgbaImage;
+    putImageData?(data: never, x: number, y: number): void;
+    /**
+     * Set on every context these adapters draw through. Optional so a fake
+     * need not carry them. A real browser's default is 'low', which in Chrome
+     * is one bilinear tap a pixel whatever the ratio, and aliases a module
+     * grid when a photograph is reduced.
+     */
+    imageSmoothingEnabled?: boolean;
+    imageSmoothingQuality?: 'low' | 'medium' | 'high';
+}
+/** Anything with a size that `drawImage` takes: a bitmap, an image element, a canvas. */
+export interface ImageLike {
+    readonly width: number;
+    readonly height: number;
+    close?(): void;
+}
+export interface ImageDecodeDeps {
+    readonly createImageBitmap?: (source: Blob, options?: {
+        readonly imageOrientation?: 'from-image' | 'none' | 'flipY';
+    }) => Promise<ImageLike>;
+    readonly createCanvas?: (width: number, height: number) => CanvasLike;
+    /** For a browser with no createImageBitmap: an image element loaded from the blob. */
+    readonly loadImageElement?: (blob: Blob) => Promise<ImageLike>;
+}
+/** What `imageFromVideo` reads a frame from. */
+export interface VideoFrameSource {
+    readonly videoWidth: number;
+    readonly videoHeight: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dom/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CACT,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,GACjD,iBAAiB,GAAG,IAAI,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IACjC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtF,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7E,YAAY,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,qBAAqB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAClD;AAED,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAC5B,MAAM,EAAE,IAAI,EACZ,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,KACrE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC;IACtE,sFAAsF;IACtF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/D;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B"}

package/dist/dom/types.js

@@ -0,0 +1,13 @@
+/**
+ * The slices of the browser the adapters use, written as interfaces so a
+ * test can hand in a fake with no more than these members.
+ *
+ * Every adapter takes its browser objects as an injected dependency bag and
+ * falls back to the real globals only when a member is missing, and only at
+ * the moment it is called. Nothing here reads a global at import, which is
+ * what lets hex-web render the studio on a server, and lets this whole layer
+ * be exercised in Node with hand-written fakes (the pattern
+ * google-auth-secret-retriever's src/dom set).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/dom/types.js.map

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

package/dist/encode/bitstream.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The data codewords for a symbol: header, segments, terminator, padding.
+ *
+ * ISO/IEC 18004 7.4.9 and 7.4.10. The terminator is the profile's run of
+ * zeros, cut short when the symbol is nearly full (and left out when it is
+ * full), then zero bits to the next codeword boundary, then the pad codewords
+ * 11101100 and 00010001 alternately. Micro QR M1 and M3 end on a 4-bit data
+ * codeword, which takes 0000 as its pad; it travels in the high nibble of the
+ * last byte, the convention `SymbologyEntry.build` documents.
+ */
+import type { BitstreamProfile, Segment, SegmentHeader } from '../segment/types.js';
+import type { BlockLayout } from '../symbology/types.js';
+export declare function dataCodewords(segments: readonly Segment[], header: SegmentHeader | undefined, profile: BitstreamProfile, blocks: BlockLayout): Uint8Array;
+//# sourceMappingURL=bitstream.d.ts.map

package/dist/encode/bitstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitstream.d.ts","sourceRoot":"","sources":["../../src/encode/bitstream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,WAAW,GACjB,UAAU,CAaZ"}

package/dist/encode/bitstream.js

@@ -0,0 +1,31 @@
+/**
+ * The data codewords for a symbol: header, segments, terminator, padding.
+ *
+ * ISO/IEC 18004 7.4.9 and 7.4.10. The terminator is the profile's run of
+ * zeros, cut short when the symbol is nearly full (and left out when it is
+ * full), then zero bits to the next codeword boundary, then the pad codewords
+ * 11101100 and 00010001 alternately. Micro QR M1 and M3 end on a 4-bit data
+ * codeword, which takes 0000 as its pad; it travels in the high nibble of the
+ * last byte, the convention `SymbologyEntry.build` documents.
+ */
+import { BitBuffer } from '../core/bits.js';
+import { writeSegments } from '../segment/write.js';
+const PAD = [0xec, 0x11];
+export function dataCodewords(segments, header, profile, blocks) {
+    const out = new BitBuffer();
+    writeSegments(segments, profile, out, header);
+    const capacity = blocks.dataBits;
+    if (out.length > capacity) {
+        throw new RangeError(`${out.length} bits do not fit a symbol that holds ${capacity}`);
+    }
+    out.append(0, Math.min(profile.terminatorBits, capacity - out.length));
+    while (out.length % 8 !== 0 && out.length < capacity)
+        out.append(0, 1);
+    for (let i = 0; capacity - out.length >= 8; i += 1)
+        out.append(PAD[i % 2], 8);
+    // Only a 4-bit final codeword is left over here, and its pad is 0000.
+    if (out.length < capacity)
+        out.append(0, capacity - out.length);
+    return out.toBytes();
+}
+//# sourceMappingURL=bitstream.js.map

package/dist/encode/bitstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitstream.js","sourceRoot":"","sources":["../../src/encode/bitstream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;AAElC,MAAM,UAAU,aAAa,CAC5B,QAA4B,EAC5B,MAAiC,EACjC,OAAyB,EACzB,MAAmB;IAEnB,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;IAC5B,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,wCAAwC,QAAQ,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ;QAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAW,EAAE,CAAC,CAAC,CAAC;IACxF,sEAAsE;IACtE,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ;QAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;AACtB,CAAC"}

package/dist/encode/encode.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Content in, one symbol out: the smallest version that holds it, at the
+ * level asked for, with the mask chosen or forced.
+ *
+ * Segmentation depends on the version only through the character count
+ * widths, so content is segmented once per profile (three times for all of
+ * QR) and each version is a comparison of bits against capacity. The version
+ * is the smallest that fits by the symbology's own order (for QR, the version
+ * number; for rMQR, the preference the caller gave).
+ *
+ * Kanji, under the default 'when-smaller', has to earn its place: the content
+ * is fitted once without it and once with it, and kanji is used only when it
+ * gets the content into a smaller symbol. Fewer bits in the same symbol is no
+ * reason to take on the readers that mishandle kanji mode.
+ */
+import type { Registry } from '../core/registry.js';
+import type { BuiltSymbol, SymbologyEntry } from '../symbology/types.js';
+import type { EncodeOptions } from './plan.js';
+/** Throws TooMuchDataError when nothing allowed fits. */
+export declare function encode(input: string | Uint8Array, options?: EncodeOptions, symbologies?: Registry<SymbologyEntry>): BuiltSymbol;
+//# sourceMappingURL=encode.d.ts.map

package/dist/encode/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/encode/encode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAQ,MAAM,WAAW,CAAC;AAqCrD,yDAAyD;AACzD,wBAAgB,MAAM,CACrB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,OAAO,GAAE,aAAkB,EAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,GACpC,WAAW,CA2Bb"}

package/dist/encode/encode.js

@@ -0,0 +1,65 @@
+/**
+ * Content in, one symbol out: the smallest version that holds it, at the
+ * level asked for, with the mask chosen or forced.
+ *
+ * Segmentation depends on the version only through the character count
+ * widths, so content is segmented once per profile (three times for all of
+ * QR) and each version is a comparison of bits against capacity. The version
+ * is the smallest that fits by the symbology's own order (for QR, the version
+ * number; for rMQR, the preference the caller gave).
+ *
+ * Kanji, under the default 'when-smaller', has to earn its place: the content
+ * is fitted once without it and once with it, and kanji is used only when it
+ * gets the content into a smaller symbol. Fewer bits in the same symbol is no
+ * reason to take on the readers that mishandle kanji mode.
+ */
+import { TooMuchDataError } from '../core/errors.js';
+import { headerBitLength, segmentsBitLength } from '../segment/write.js';
+import { buildSymbol, inputKind, resolvePlan, segmenter } from './plan.js';
+/** The first version, in the plan's order, whose segments fit; or what stopped every one. */
+function firstFit(plan, segments, kanji, header) {
+    let error;
+    for (let rank = 0; rank < plan.versions.length; rank += 1) {
+        const version = plan.versions[rank];
+        const profile = plan.entry.profile(version);
+        const found = segments(profile, kanji);
+        if (!Array.isArray(found)) {
+            error ??= found;
+            continue;
+        }
+        const bits = headerBitLength(header, profile) + segmentsBitLength(found, profile);
+        if (bits <= plan.entry.blocks(version, plan.ecLevel).dataBits)
+            return { version, rank, segments: found };
+    }
+    const profile = plan.entry.profile(plan.largest);
+    const found = segments(profile, kanji);
+    const bits = Array.isArray(found)
+        ? headerBitLength(header, profile) + segmentsBitLength(found, profile)
+        : undefined;
+    return { bits, error };
+}
+/** Throws TooMuchDataError when nothing allowed fits. */
+export function encode(input, options = {}, symbologies) {
+    inputKind(input);
+    const plan = resolvePlan(options, symbologies, { structuredAppend: false });
+    const segments = segmenter(input, plan);
+    const header = plan.fnc1 === undefined ? {} : { fnc1: plan.fnc1 };
+    const kanjiPolicy = typeof input === 'string' ? plan.policy.kanji : 'never';
+    const plain = kanjiPolicy === 'always' ? undefined : firstFit(plan, segments, 'never', header);
+    const kanji = kanjiPolicy === 'never' ? undefined : firstFit(plan, segments, 'always', header);
+    const fits = [kanji, plain].filter((fit) => fit !== undefined && 'rank' in fit);
+    // With both on the table ('when-smaller'), kanji is listed first and wins
+    // only by being strictly smaller.
+    fits.sort((a, b) => a.rank - b.rank);
+    const best = fits.length === 2 && fits[0]?.rank === fits[1]?.rank ? fits[1] : fits[0];
+    if (best !== undefined)
+        return buildSymbol(plan, best.version, best.segments, header);
+    // Nothing fits. Say how far off the largest allowed symbol is, using
+    // whichever segmentation came closer.
+    const failed = [plain, kanji].filter((fit) => fit !== undefined);
+    const needed = failed.map((fit) => fit.bits).filter((bits) => bits !== undefined);
+    if (needed.length === 0)
+        throw failed[0]?.error;
+    throw new TooMuchDataError(Math.min(...needed), plan.entry.blocks(plan.largest, plan.ecLevel).dataBits);
+}
+//# sourceMappingURL=encode.js.map

package/dist/encode/encode.js.map

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

package/dist/encode/index.d.ts

@@ -0,0 +1,5 @@
+export { encode } from './encode.js';
+export { encodeStructuredAppend } from './structured-append.js';
+export type { EncodeOptions } from './plan.js';
+export { dataCodewords } from './bitstream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/encode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/encode/index.js

@@ -0,0 +1,4 @@
+export { encode } from './encode.js';
+export { encodeStructuredAppend } from './structured-append.js';
+export { dataCodewords } from './bitstream.js';
+//# sourceMappingURL=index.js.map

package/dist/encode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/encode/plan.d.ts

@@ -0,0 +1,61 @@
+/**
+ * What `encode` and `encodeStructuredAppend` share: reading the options,
+ * listing the versions a caller allows, segmenting per version, and building
+ * a symbol once the version and segments are settled.
+ *
+ * Options are checked here, all of them, before any work. A wrong option is a
+ * caller's bug (a version string that is not one, a mask past 7) and throws
+ * TypeError; content that does not fit is a person's situation and throws
+ * TooMuchDataError with the numbers they need.
+ */
+import { QrStudioError } from '../core/errors.js';
+import type { Registry } from '../core/registry.js';
+import type { BitstreamProfile, EcLevel, Segment, SegmentHeader, SegmentationPolicy } from '../segment/types.js';
+import type { BuiltSymbol, SymbologyEntry } from '../symbology/types.js';
+export interface EncodeOptions {
+    /** Default 'qr'. */
+    readonly symbology?: string;
+    /** Default 'M'. */
+    readonly ecLevel?: EcLevel;
+    /** Raise the level as far as it goes without needing a larger symbol. Default false. */
+    readonly boostEc?: boolean;
+    readonly minVersion?: string;
+    readonly maxVersion?: string;
+    readonly mask?: number | 'auto';
+    readonly segmentation?: Partial<SegmentationPolicy>;
+    readonly fnc1?: 'gs1' | {
+        applicationIndicator: number;
+    };
+    /** rMQR only: prefer the shortest height that fits, or the shortest width. Default 'area'. */
+    readonly rmqrPreference?: 'area' | 'height' | 'width';
+}
+export interface Plan {
+    readonly entry: SymbologyEntry;
+    readonly ecLevel: EcLevel;
+    /** Allowed versions that offer the level, smallest first by the preference. */
+    readonly versions: readonly string[];
+    /** The largest allowed version, for reporting what did not fit. */
+    readonly largest: string;
+    readonly policy: SegmentationPolicy;
+    readonly fnc1: SegmentHeader['fnc1'];
+    readonly mask: number | 'auto';
+    readonly boostEc: boolean;
+}
+export declare function resolvePlan(options: EncodeOptions, symbologies: Registry<SymbologyEntry> | undefined, needs: {
+    readonly structuredAppend: boolean;
+}): Plan;
+/** True for the one segmentation failure that means "not at this version" rather than "never". */
+export declare function cannotCarry(error: unknown): error is QrStudioError;
+/**
+ * Segments for the input under one profile, cached per profile and kanji
+ * choice: QR has three profiles for forty versions, so most of the work is
+ * shared. A version whose modes cannot carry the content gets the error
+ * instead of segments.
+ */
+export declare function segmenter(input: string | Uint8Array, plan: Plan): (profile: BitstreamProfile, kanji: 'never' | 'always') => Segment[] | QrStudioError;
+/** The strongest level at or above the plan's that still holds `bits` at this version, when boosting. */
+export declare function boostedLevel(plan: Plan, version: string, bits: number): EcLevel;
+/** Pad, add check codewords, place, mask: the symbol for settled segments. */
+export declare function buildSymbol(plan: Plan, version: string, segments: readonly Segment[], header: SegmentHeader): BuiltSymbol;
+export declare function inputKind(input: unknown): asserts input is string | Uint8Array;
+//# sourceMappingURL=plan.d.ts.map

package/dist/encode/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/encode/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EACX,gBAAgB,EAChB,OAAO,EACP,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGzE,MAAM,WAAW,aAAa;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG;QAAE,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACtD;AAED,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAcD,wBAAgB,WAAW,CAC1B,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,SAAS,EACjD,KAAK,EAAE;IAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,GAC3C,IAAI,CA0FN;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACxB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,IAAI,EAAE,IAAI,GACR,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,KAAK,OAAO,EAAE,GAAG,aAAa,CAwBrF;AAED,yGAAyG;AACzG,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU/E;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAC1B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,MAAM,EAAE,aAAa,GACnB,WAAW,CAMb;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,UAAU,CAI9E"}

package/dist/encode/plan.js

@@ -0,0 +1,177 @@
+/**
+ * What `encode` and `encodeStructuredAppend` share: reading the options,
+ * listing the versions a caller allows, segmenting per version, and building
+ * a symbol once the version and segments are settled.
+ *
+ * Options are checked here, all of them, before any work. A wrong option is a
+ * caller's bug (a version string that is not one, a mask past 7) and throws
+ * TypeError; content that does not fit is a person's situation and throws
+ * TooMuchDataError with the numbers they need.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { DEFAULT_SEGMENTATION, segmentBytes, segmentText } from '../segment/segment-text.js';
+import { headerBitLength, segmentsBitLength, validApplicationIndicator } from '../segment/write.js';
+import { createSymbologyRegistry } from '../symbology/registry.js';
+import { dataCodewords } from './bitstream.js';
+const LEVELS = ['L', 'M', 'Q', 'H'];
+function unsupportedFeature(feature) {
+    return new QrStudioError('encode/unsupported-feature', feature === 'fnc1'
+        ? 'This kind of code cannot carry GS1 data. Choose a QR code.'
+        : 'This kind of code cannot be split across several codes. Choose a QR code.', { feature });
+}
+export function resolvePlan(options, symbologies, needs) {
+    if (typeof options !== 'object' || options === null)
+        throw new TypeError('encode options are an object');
+    const registry = symbologies ?? createSymbologyRegistry();
+    const entry = registry.require(options.symbology ?? 'qr');
+    const ecLevel = options.ecLevel ?? 'M';
+    if (!LEVELS.includes(ecLevel))
+        throw new TypeError("ecLevel is 'L', 'M', 'Q' or 'H'");
+    if (options.boostEc !== undefined && typeof options.boostEc !== 'boolean') {
+        throw new TypeError('boostEc is true or false');
+    }
+    const preference = options.rmqrPreference ?? 'area';
+    if (!['area', 'height', 'width'].includes(preference)) {
+        throw new TypeError("rmqrPreference is 'area', 'height' or 'width'");
+    }
+    const { versions } = entry;
+    const first = options.minVersion === undefined ? 0 : versions.indexOf(options.minVersion);
+    const last = options.maxVersion === undefined ? versions.length - 1 : versions.indexOf(options.maxVersion);
+    if (first < 0 || last < 0)
+        throw new TypeError(`that is not a version of ${entry.id}`);
+    if (first > last)
+        throw new TypeError('minVersion is larger than maxVersion');
+    const range = versions.slice(first, last + 1).filter((v) => entry.ecLevels(v).includes(ecLevel));
+    if (range.length === 0) {
+        throw new TypeError('no allowed version offers that error correction level');
+    }
+    const mask = options.mask ?? 'auto';
+    if (mask !== 'auto' && !range.every((v) => entry.masks(v).includes(mask))) {
+        throw new TypeError(`that mask is not one ${entry.id} has at every allowed version`);
+    }
+    const policy = { ...DEFAULT_SEGMENTATION, ...options.segmentation };
+    // encode hands segmentText only 'never' or 'always' and decides
+    // 'when-smaller' itself, so the policy is checked here, not there.
+    if (!['never', 'when-smaller', 'always'].includes(policy.kanji)) {
+        throw new TypeError("segmentation.kanji is 'never', 'when-smaller' or 'always'");
+    }
+    if (!['auto', 'never', 'utf-8'].includes(policy.eci)) {
+        throw new TypeError("segmentation.eci is 'auto', 'never' or 'utf-8'");
+    }
+    const { fnc1 } = options;
+    if (fnc1 !== undefined && fnc1 !== 'gs1') {
+        if (typeof fnc1 !== 'object' ||
+            fnc1 === null ||
+            !validApplicationIndicator(fnc1.applicationIndicator)) {
+            throw new TypeError("fnc1 is 'gs1' or { applicationIndicator } with 00 to 99 or a letter plus 100");
+        }
+    }
+    let usable = range;
+    if (fnc1 !== undefined) {
+        usable = usable.filter((v) => entry.profile(v).fnc1);
+        if (usable.length === 0)
+            throw unsupportedFeature('fnc1');
+    }
+    if (needs.structuredAppend) {
+        usable = usable.filter((v) => entry.profile(v).structuredAppend);
+        if (usable.length === 0)
+            throw unsupportedFeature('structured-append');
+    }
+    // Smallest first by the preference. For square symbols the three orders
+    // agree; rMQR is where they differ. The sort is stable, so equal keys keep
+    // the symbology's own order.
+    const key = (v) => {
+        const { width, height } = entry.size(v);
+        return preference === 'height'
+            ? [height, width]
+            : preference === 'width'
+                ? [width, height]
+                : [width * height];
+    };
+    const ordered = [...usable].sort((a, b) => {
+        const ka = key(a);
+        const kb = key(b);
+        for (let i = 0; i < ka.length; i += 1) {
+            if (ka[i] !== kb[i])
+                return ka[i] - kb[i];
+        }
+        return 0;
+    });
+    return Object.freeze({
+        entry,
+        ecLevel,
+        versions: Object.freeze(ordered),
+        largest: usable[usable.length - 1],
+        policy,
+        fnc1,
+        mask,
+        boostEc: options.boostEc === true,
+    });
+}
+/** True for the one segmentation failure that means "not at this version" rather than "never". */
+export function cannotCarry(error) {
+    return (error instanceof QrStudioError &&
+        error.code === 'encode/unsupported-content' &&
+        error.params.reason === 'mode');
+}
+/**
+ * Segments for the input under one profile, cached per profile and kanji
+ * choice: QR has three profiles for forty versions, so most of the work is
+ * shared. A version whose modes cannot carry the content gets the error
+ * instead of segments.
+ */
+export function segmenter(input, plan) {
+    const cache = new Map();
+    const fnc1 = plan.fnc1 !== undefined;
+    return (profile, kanji) => {
+        let byKanji = cache.get(profile);
+        if (byKanji === undefined) {
+            byKanji = new Map();
+            cache.set(profile, byKanji);
+        }
+        let found = byKanji.get(kanji);
+        if (found === undefined) {
+            try {
+                found =
+                    typeof input === 'string'
+                        ? segmentText(input, profile, { kanji, eci: plan.policy.eci }, { fnc1 })
+                        : segmentBytes(input, profile, { fnc1 });
+            }
+            catch (error) {
+                if (!cannotCarry(error))
+                    throw error;
+                found = error;
+            }
+            byKanji.set(kanji, found);
+        }
+        return found;
+    };
+}
+/** The strongest level at or above the plan's that still holds `bits` at this version, when boosting. */
+export function boostedLevel(plan, version, bits) {
+    if (!plan.boostEc)
+        return plan.ecLevel;
+    const levels = plan.entry.ecLevels(version);
+    let level = plan.ecLevel;
+    for (let i = levels.indexOf(level) + 1; i < levels.length; i += 1) {
+        const stronger = levels[i];
+        if (bits > plan.entry.blocks(version, stronger).dataBits)
+            break;
+        level = stronger;
+    }
+    return level;
+}
+/** Pad, add check codewords, place, mask: the symbol for settled segments. */
+export function buildSymbol(plan, version, segments, header) {
+    const profile = plan.entry.profile(version);
+    const bits = headerBitLength(header, profile) + segmentsBitLength(segments, profile);
+    const level = boostedLevel(plan, version, bits);
+    const data = dataCodewords(segments, header, profile, plan.entry.blocks(version, level));
+    return plan.entry.build(data, version, level, plan.mask);
+}
+export function inputKind(input) {
+    if (typeof input !== 'string' && !(input instanceof Uint8Array)) {
+        throw new TypeError('encode takes a string or a Uint8Array');
+    }
+}
+//# sourceMappingURL=plan.js.map