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

package/dist/dom/orientation.js

@@ -0,0 +1,152 @@
+/**
+ * Which way up a JPEG is meant to be shown, from its Exif data.
+ *
+ * A phone stores a photograph the way the sensor saw it and writes the
+ * rotation into the Exif Orientation tag (CIPA DC-008, tag 0x0112). Current
+ * browsers apply it when they decode (`imageOrientation: 'from-image'` is
+ * createImageBitmap's default), and some older ones do not. The ones that do
+ * not are found by the picture's size: a quarter turn swaps width and height,
+ * so a bitmap that comes back the size the JPEG's frame header gives, when
+ * the tag says a quarter turn, was not turned, and `applyOrientation` turns
+ * it. The flips and the half turn keep the size and cannot be told apart that
+ * way; every engine that decodes them ignoring the tag is past its support.
+ *
+ * Read only from the first 64 KiB, where the Exif segment has to be.
+ */
+/** How much of a file the Exif segment and the frame header are looked for in. */
+export const ORIENTATION_BYTES = 65536;
+function u16(bytes, at, little) {
+    const a = bytes[at];
+    const b = bytes[at + 1];
+    return little ? a | (b << 8) : (a << 8) | b;
+}
+function u32(bytes, at, little) {
+    return little
+        ? (u16(bytes, at, true) | (u16(bytes, at + 2, true) << 16)) >>> 0
+        : ((u16(bytes, at, false) << 16) | u16(bytes, at + 2, false)) >>> 0;
+}
+/** The Orientation tag in a TIFF block (the body of an Exif segment), or 1. */
+function tiffOrientation(bytes, start, end) {
+    if (end - start < 8)
+        return 1;
+    const order = u16(bytes, start, false);
+    if (order !== 0x4949 && order !== 0x4d4d)
+        return 1;
+    const little = order === 0x4949;
+    if (u16(bytes, start + 2, little) !== 42)
+        return 1;
+    const ifd = start + u32(bytes, start + 4, little);
+    if (ifd + 2 > end)
+        return 1;
+    const count = u16(bytes, ifd, little);
+    for (let i = 0; i < count; i += 1) {
+        const entry = ifd + 2 + i * 12;
+        if (entry + 12 > end)
+            return 1;
+        if (u16(bytes, entry, little) === 0x0112) {
+            const value = u16(bytes, entry + 8, little);
+            return value >= 1 && value <= 8 ? value : 1;
+        }
+    }
+    return 1;
+}
+/** A start-of-frame marker: C0 to CF, less DHT (C4), JPG (C8) and DAC (CC). */
+function isFrame(marker) {
+    return marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;
+}
+/** The orientation and stored size of a JPEG, or null when the bytes are not one this reads. */
+export function jpegFacts(bytes) {
+    if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8)
+        return null;
+    let orientation = 1;
+    let at = 2;
+    const end = Math.min(bytes.length, ORIENTATION_BYTES);
+    while (at + 4 <= end) {
+        if (bytes[at] !== 0xff)
+            return null;
+        const marker = bytes[at + 1];
+        // Fill bytes before a marker.
+        if (marker === 0xff) {
+            at += 1;
+            continue;
+        }
+        const length = u16(bytes, at + 2, false);
+        if (length < 2)
+            return null;
+        const body = at + 4;
+        if (marker === 0xe1 && body + 6 <= end) {
+            const exif = bytes[body] === 0x45 &&
+                bytes[body + 1] === 0x78 &&
+                bytes[body + 2] === 0x69 &&
+                bytes[body + 3] === 0x66 &&
+                bytes[body + 4] === 0 &&
+                bytes[body + 5] === 0;
+            if (exif)
+                orientation = tiffOrientation(bytes, body + 6, Math.min(end, at + 2 + length));
+        }
+        if (isFrame(marker)) {
+            if (body + 5 > end)
+                return null;
+            return {
+                orientation,
+                height: u16(bytes, body + 1, false),
+                width: u16(bytes, body + 3, false),
+            };
+        }
+        // Start of scan: the frame header comes before it in any valid file.
+        if (marker === 0xda)
+            return null;
+        at += 2 + length;
+    }
+    return null;
+}
+/** True for the orientations that are a quarter turn, which swap width and height. */
+export function swapsSides(orientation) {
+    return orientation >= 5 && orientation <= 8;
+}
+/** `image` turned and flipped the way Exif `orientation` says it should be shown. */
+export function applyOrientation(image, orientation) {
+    if (!Number.isInteger(orientation) || orientation < 2 || orientation > 8)
+        return image;
+    const { width: w, height: h, data } = image;
+    const swap = swapsSides(orientation);
+    const width = swap ? h : w;
+    const height = swap ? w : h;
+    const out = new Uint8ClampedArray(width * height * 4);
+    for (let y = 0; y < height; y += 1) {
+        for (let x = 0; x < width; x += 1) {
+            let sx;
+            let sy;
+            switch (orientation) {
+                case 2:
+                    [sx, sy] = [w - 1 - x, y];
+                    break;
+                case 3:
+                    [sx, sy] = [w - 1 - x, h - 1 - y];
+                    break;
+                case 4:
+                    [sx, sy] = [x, h - 1 - y];
+                    break;
+                case 5:
+                    [sx, sy] = [y, x];
+                    break;
+                case 6:
+                    [sx, sy] = [y, h - 1 - x];
+                    break;
+                case 7:
+                    [sx, sy] = [w - 1 - y, h - 1 - x];
+                    break;
+                default:
+                    [sx, sy] = [w - 1 - y, x];
+            }
+            const from = (sy * w + sx) * 4;
+            const to = (y * width + x) * 4;
+            out[to] = data[from];
+            out[to + 1] = data[from + 1];
+            out[to + 2] = data[from + 2];
+            out[to + 3] = data[from + 3];
+        }
+    }
+    return { width, height, data: out };
+}
+//# sourceMappingURL=orientation.js.map

package/dist/dom/orientation.js.map

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

package/dist/dom/output.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Handing a finished file to the person: a download, or the clipboard.
+ *
+ * There is no server, so there is nothing to download from. The file is
+ * built in the tab and handed to the browser through an object URL, the one
+ * way a page has of saying "save this" about bytes it made itself. Lifted from
+ * private-image-converter's src/dom/download.ts, with the browser objects
+ * injected so the mechanics are tested without one, and Results in place of
+ * throws.
+ */
+import type { Result } from '../core/result.js';
+/**
+ * How long the object URL stays open after the click. Revoking at once is
+ * wrong: the browser may not have read the blob when click() returns, and
+ * Safari cancels the save. A minute is far longer than a save needs.
+ */
+export declare const REVOKE_AFTER_MS = 60000;
+interface AnchorLike {
+    href: string;
+    download: string;
+    rel: string;
+    style: {
+        display: string;
+    };
+    click(): void;
+    remove(): void;
+}
+export interface DownloadDeps {
+    readonly document?: {
+        createElement(tag: 'a'): AnchorLike;
+        readonly body: {
+            appendChild(node: AnchorLike): unknown;
+        };
+    };
+    readonly url?: {
+        createObjectURL(blob: Blob): string;
+        revokeObjectURL(url: string): void;
+    };
+    readonly setTimeout?: (task: () => void, ms: number) => unknown;
+}
+export interface ClipboardDeps {
+    readonly clipboard?: {
+        write?(items: readonly unknown[]): Promise<void>;
+        writeText?(text: string): Promise<void>;
+    };
+    /** The ClipboardItem constructor. */
+    readonly ClipboardItem?: new (items: Record<string, Blob | Promise<Blob>>) => unknown;
+}
+export declare function downloadBlob(blob: Blob, filename: string, deps?: DownloadDeps): Result<null>;
+export declare function downloadBytes(bytes: Uint8Array, filename: string, mime: string, deps?: DownloadDeps): Result<null>;
+/**
+ * Put a PNG on the clipboard. PNG is the one image type every browser's
+ * clipboard is required to take (the Async Clipboard API's mandatory set).
+ */
+export declare function copyImageToClipboard(png: Uint8Array | Blob, deps?: ClipboardDeps): Promise<Result<null>>;
+export declare function copyText(text: string, deps?: ClipboardDeps): Promise<Result<null>>;
+export {};
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/dom/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACnB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAAC;QACpC,QAAQ,CAAC,IAAI,EAAE;YAAE,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAA;SAAE,CAAC;KAC1D,CAAC;IACF,QAAQ,CAAC,GAAG,CAAC,EAAE;QACd,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;QACpC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CAChE;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE;QACpB,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACxC,CAAC;IACF,qCAAqC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC;CACtF;AAQD,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,CA0BhG;AAED,wBAAgB,aAAa,CAC5B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,YAAiB,GACrB,MAAM,CAAC,IAAI,CAAC,CAEd;AAQD;;;GAGG;AACH,wBAAsB,oBAAoB,CACzC,GAAG,EAAE,UAAU,GAAG,IAAI,EACtB,IAAI,GAAE,aAAkB,GACtB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAiBvB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAS5F"}

package/dist/dom/output.js

@@ -0,0 +1,93 @@
+/**
+ * Handing a finished file to the person: a download, or the clipboard.
+ *
+ * There is no server, so there is nothing to download from. The file is
+ * built in the tab and handed to the browser through an object URL, the one
+ * way a page has of saying "save this" about bytes it made itself. Lifted from
+ * private-image-converter's src/dom/download.ts, with the browser objects
+ * injected so the mechanics are tested without one, and Results in place of
+ * throws.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { err, ok } from '../core/result.js';
+/**
+ * How long the object URL stays open after the click. Revoking at once is
+ * wrong: the browser may not have read the blob when click() returns, and
+ * Safari cancels the save. A minute is far longer than a save needs.
+ */
+export const REVOKE_AFTER_MS = 60_000;
+function unavailable(feature) {
+    return new QrStudioError('platform/unavailable', 'This browser cannot do that here.', {
+        feature,
+    });
+}
+export function downloadBlob(blob, filename, deps = {}) {
+    const doc = deps.document ??
+        (typeof document === 'undefined'
+            ? undefined
+            : document);
+    const urls = deps.url ??
+        (typeof URL !== 'undefined' && typeof URL.createObjectURL === 'function'
+            ? URL
+            : undefined);
+    if (doc === undefined || urls === undefined)
+        return err(unavailable('download'));
+    const later = deps.setTimeout ?? ((task, ms) => setTimeout(task, ms));
+    const url = urls.createObjectURL(blob);
+    const anchor = doc.createElement('a');
+    anchor.href = url;
+    anchor.download = filename;
+    anchor.rel = 'noopener';
+    // In the document rather than detached, because Firefox ignores a click
+    // on an element that is not in it.
+    anchor.style.display = 'none';
+    doc.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    later(() => urls.revokeObjectURL(url), REVOKE_AFTER_MS);
+    return ok(null);
+}
+export function downloadBytes(bytes, filename, mime, deps = {}) {
+    return downloadBlob(new Blob([bytes], { type: mime }), filename, deps);
+}
+function platformClipboard() {
+    return typeof navigator !== 'undefined'
+        ? navigator.clipboard
+        : undefined;
+}
+/**
+ * Put a PNG on the clipboard. PNG is the one image type every browser's
+ * clipboard is required to take (the Async Clipboard API's mandatory set).
+ */
+export async function copyImageToClipboard(png, deps = {}) {
+    const clipboard = deps.clipboard ?? platformClipboard();
+    const Item = deps.ClipboardItem ??
+        (typeof ClipboardItem === 'function'
+            ? ClipboardItem
+            : undefined);
+    if (clipboard?.write === undefined || Item === undefined)
+        return err(unavailable('clipboard'));
+    const blob = png instanceof Blob ? png : new Blob([png], { type: 'image/png' });
+    try {
+        await clipboard.write([new Item({ 'image/png': blob })]);
+        return ok(null);
+    }
+    catch {
+        // Refused: no user gesture, the document not focused, or a permission
+        // the person declined. All the same to them: it did not copy.
+        return err(unavailable('clipboard'));
+    }
+}
+export async function copyText(text, deps = {}) {
+    const clipboard = deps.clipboard ?? platformClipboard();
+    if (clipboard?.writeText === undefined)
+        return err(unavailable('clipboard'));
+    try {
+        await clipboard.writeText(text);
+        return ok(null);
+    }
+    catch {
+        return err(unavailable('clipboard'));
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/dom/output.js.map

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

package/dist/dom/print.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Printing a code at its physical size, through the browser's print dialog.
+ *
+ * The code goes into a hidden frame holding a one-page document whose print
+ * stylesheet sets the page to exactly the code's size with no margin, so a
+ * printer told "actual size" prints 25 mm as 25 mm. The SVG is the studio's
+ * own (render's `sceneToSvg`), never a person's, so it carries no script; the
+ * frame is sandboxed as well, with only what printing needs.
+ *
+ * The window is injected, as everything in this layer is, and nothing is
+ * touched until `printScene` is called.
+ */
+import type { Result } from '../core/result.js';
+/** How long the frame is kept if the browser never says printing finished. */
+export declare const PRINT_CLEANUP_MS = 60000;
+interface PrintFrame {
+    srcdoc: string;
+    style: {
+        cssText: string;
+    };
+    setAttribute(name: string, value: string): void;
+    addEventListener(type: 'load', listener: () => void): void;
+    readonly contentWindow: {
+        focus?(): void;
+        print(): void;
+        addEventListener?(type: 'afterprint', listener: () => void): void;
+    } | null;
+    remove(): void;
+}
+export interface PrintDeps {
+    readonly window: {
+        readonly document: {
+            createElement(tag: 'iframe'): PrintFrame;
+            readonly body: {
+                appendChild(node: PrintFrame): unknown;
+            };
+        };
+        setTimeout(task: () => void, ms: number): unknown;
+    };
+}
+/** The one-page document a code is printed from. */
+export declare function printDocument(svg: string, widthMm: number, heightMm: number): string;
+/**
+ * Open the print dialog for `svg` at `sizeMm`: the width, with the height from
+ * the SVG's own proportions, or both.
+ */
+export declare function printScene(svg: string, sizeMm: number | {
+    readonly widthMm: number;
+    readonly heightMm: number;
+}, deps: PrintDeps): Promise<Result<null>>;
+export {};
+//# sourceMappingURL=print.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../src/dom/print.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,UAAU,UAAU;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,aAAa,EAAE;QACvB,KAAK,CAAC,IAAI,IAAI,CAAC;QACf,KAAK,IAAI,IAAI,CAAC;QACd,gBAAgB,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;KAClE,GAAG,IAAI,CAAC;IACT,MAAM,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE;YAClB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,CAAC;YACzC,QAAQ,CAAC,IAAI,EAAE;gBAAE,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAA;aAAE,CAAC;SAC1D,CAAC;QACF,UAAU,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;KAClD,CAAC;CACF;AAeD,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EACxE,IAAI,EAAE,SAAS,GACb,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CA6DvB"}

package/dist/dom/print.js

@@ -0,0 +1,101 @@
+/**
+ * Printing a code at its physical size, through the browser's print dialog.
+ *
+ * The code goes into a hidden frame holding a one-page document whose print
+ * stylesheet sets the page to exactly the code's size with no margin, so a
+ * printer told "actual size" prints 25 mm as 25 mm. The SVG is the studio's
+ * own (render's `sceneToSvg`), never a person's, so it carries no script; the
+ * frame is sandboxed as well, with only what printing needs.
+ *
+ * The window is injected, as everything in this layer is, and nothing is
+ * touched until `printScene` is called.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { err, ok } from '../core/result.js';
+/** How long the frame is kept if the browser never says printing finished. */
+export const PRINT_CLEANUP_MS = 60_000;
+function mm(value) {
+    return `${Math.round(value * 1000) / 1000}mm`;
+}
+/** The SVG's own aspect, from its viewBox. */
+function aspect(svg) {
+    const match = /viewBox="0 0 ([0-9.]+) ([0-9.]+)"/.exec(svg);
+    if (match === null)
+        return null;
+    const width = Number(match[1]);
+    const height = Number(match[2]);
+    return width > 0 && height > 0 ? height / width : null;
+}
+/** The one-page document a code is printed from. */
+export function printDocument(svg, widthMm, heightMm) {
+    const size = `${mm(widthMm)} ${mm(heightMm)}`;
+    return [
+        '<!doctype html><html><head><meta charset="utf-8"><title>QR code</title><style>',
+        `@page{size:${size};margin:0}`,
+        'html,body{margin:0;padding:0;background:#fff}',
+        `body{width:${mm(widthMm)};height:${mm(heightMm)};overflow:hidden}`,
+        `svg{display:block;width:${mm(widthMm)};height:${mm(heightMm)}}`,
+        '</style></head><body>',
+        svg,
+        '</body></html>',
+    ].join('');
+}
+/**
+ * Open the print dialog for `svg` at `sizeMm`: the width, with the height from
+ * the SVG's own proportions, or both.
+ */
+export function printScene(svg, sizeMm, deps) {
+    if (typeof svg !== 'string' || !svg.startsWith('<svg') || /<script/i.test(svg)) {
+        throw new TypeError("printScene: svg is the studio's own SVG, from sceneToSvg.");
+    }
+    const widthMm = typeof sizeMm === 'number' ? sizeMm : sizeMm.widthMm;
+    const ratio = aspect(svg) ?? 1;
+    const heightMm = typeof sizeMm === 'number' ? sizeMm * ratio : sizeMm.heightMm;
+    if (!(widthMm > 0) ||
+        !(heightMm > 0) ||
+        !Number.isFinite(widthMm) ||
+        !Number.isFinite(heightMm)) {
+        throw new TypeError('printScene: the size is a number of millimetres greater than zero.');
+    }
+    const { document, setTimeout } = deps.window;
+    const frame = document.createElement('iframe');
+    frame.setAttribute('sandbox', 'allow-modals allow-same-origin');
+    frame.setAttribute('aria-hidden', 'true');
+    frame.style.cssText =
+        'position:fixed;right:0;bottom:0;width:0;height:0;border:0;visibility:hidden';
+    return new Promise((resolve) => {
+        let removed = false;
+        const remove = () => {
+            if (removed)
+                return;
+            removed = true;
+            frame.remove();
+        };
+        frame.addEventListener('load', () => {
+            const view = frame.contentWindow;
+            if (view === null) {
+                remove();
+                resolve(err(new QrStudioError('platform/unavailable', 'This browser cannot print from here.', {
+                    feature: 'print',
+                })));
+                return;
+            }
+            view.addEventListener?.('afterprint', remove);
+            setTimeout(remove, PRINT_CLEANUP_MS);
+            view.focus?.();
+            try {
+                view.print();
+                resolve(ok(null));
+            }
+            catch {
+                remove();
+                resolve(err(new QrStudioError('platform/unavailable', 'This browser cannot print from here.', {
+                    feature: 'print',
+                })));
+            }
+        });
+        frame.srcdoc = printDocument(svg, widthMm, heightMm);
+        document.body.appendChild(frame);
+    });
+}
+//# sourceMappingURL=print.js.map

package/dist/dom/print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../src/dom/print.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAG5C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAyBvC,SAAS,EAAE,CAAC,KAAa;IACxB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,8CAA8C;AAC9C,SAAS,MAAM,CAAC,GAAW;IAC1B,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,OAAe,EAAE,QAAgB;IAC3E,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9C,OAAO;QACN,gFAAgF;QAChF,cAAc,IAAI,YAAY;QAC9B,+CAA+C;QAC/C,cAAc,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB;QACnE,2BAA2B,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG;QAChE,uBAAuB;QACvB,GAAG;QACH,gBAAgB;KAChB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACzB,GAAW,EACX,MAAwE,EACxE,IAAe;IAEf,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC/E,IACC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QACf,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACzB,CAAC;QACF,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IAChE,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1C,KAAK,CAAC,KAAK,CAAC,OAAO;QAClB,6EAA6E,CAAC;IAC/E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,GAAS,EAAE;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC,CAAC;QACF,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;YACnC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC;YACjC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,EAAE,CAAC;gBACT,OAAO,CACN,GAAG,CACF,IAAI,aAAa,CAAC,sBAAsB,EAAE,sCAAsC,EAAE;oBACjF,OAAO,EAAE,OAAO;iBAChB,CAAC,CACF,CACD,CAAC;gBACF,OAAO;YACR,CAAC;YACD,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC9C,UAAU,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACf,IAAI,CAAC;gBACJ,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACR,MAAM,EAAE,CAAC;gBACT,OAAO,CACN,GAAG,CACF,IAAI,aAAa,CAAC,sBAAsB,EAAE,sCAAsC,EAAE;oBACjF,OAAO,EAAE,OAAO;iBAChB,CAAC,CACF,CACD,CAAC;YACH,CAAC;QACF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/dom/raster-encoder.d.ts

@@ -0,0 +1,43 @@
+/**
+ * JPEG and WebP, through the browser's own encoders.
+ *
+ * This package writes PNG itself and does not carry a JPEG or WebP encoder,
+ * so those two go through a canvas. The trap, lifted with the rest of this
+ * from private-image-converter (src/raster/canvas.ts and
+ * src/codecs/native/encode.ts): a canvas asked for a type it cannot write
+ * does not throw and does not return null, it returns a PNG. Safari has
+ * never written WebP and does exactly this, so a person would save
+ * `qr-code.webp` that is really a PNG. Every encode here checks the bytes that
+ * came back and refuses with 'render/format-unavailable' when they are not
+ * what was asked for.
+ */
+import type { RgbaImage } from '../core/image.js';
+import type { RasterEncoder } from '../studio/index.js';
+/** A canvas that can be filled with pixels and encoded. */
+export interface EncodingCanvas {
+    width: number;
+    height: number;
+    getContext(type: '2d'): {
+        putImageData(data: never, x: number, y: number): void;
+    } | null;
+    convertToBlob?(options: {
+        type: string;
+        quality?: number;
+    }): Promise<Blob>;
+    toBlob?(callback: (blob: Blob | null) => void, type: string, quality?: number): void;
+}
+export interface RasterEncoderDeps {
+    readonly createCanvas?: (width: number, height: number) => EncodingCanvas | null;
+    /** An ImageData from pixels. Default: the ImageData constructor. */
+    readonly createImageData?: (image: RgbaImage) => unknown;
+}
+/** Whether `bytes` begin the way a file of `format` does. */
+export declare function looksLike(bytes: Uint8Array, format: 'jpeg' | 'webp' | 'png'): boolean;
+/**
+ * The image composited onto white. JPEG has no alpha, and a canvas encoder
+ * composites onto black without saying so, which turns a transparent ground
+ * into a black square round the code.
+ */
+export declare function flattenOnWhite(image: RgbaImage): RgbaImage;
+export declare function canvasRasterEncoder(deps?: RasterEncoderDeps): RasterEncoder;
+//# sourceMappingURL=raster-encoder.d.ts.map

package/dist/dom/raster-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster-encoder.d.ts","sourceRoot":"","sources":["../../src/dom/raster-encoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG;QAAE,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACzF,aAAa,CAAC,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,CAAC;IACjF,oEAAoE;IACpE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;CACzD;AAID,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAYrF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAmB1D;AAiCD,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,iBAAsB,GAAG,aAAa,CA2B/E"}

package/dist/dom/raster-encoder.js

@@ -0,0 +1,102 @@
+/**
+ * JPEG and WebP, through the browser's own encoders.
+ *
+ * This package writes PNG itself and does not carry a JPEG or WebP encoder,
+ * so those two go through a canvas. The trap, lifted with the rest of this
+ * from private-image-converter (src/raster/canvas.ts and
+ * src/codecs/native/encode.ts): a canvas asked for a type it cannot write
+ * does not throw and does not return null, it returns a PNG. Safari has
+ * never written WebP and does exactly this, so a person would save
+ * `qr-code.webp` that is really a PNG. Every encode here checks the bytes that
+ * came back and refuses with 'render/format-unavailable' when they are not
+ * what was asked for.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { err, ok } from '../core/result.js';
+import { platformCanvas } from './image.js';
+const MIME = { jpeg: 'image/jpeg', webp: 'image/webp' };
+/** Whether `bytes` begin the way a file of `format` does. */
+export function looksLike(bytes, format) {
+    const starts = (signature, at = 0) => signature.every((byte, i) => bytes[at + i] === byte);
+    switch (format) {
+        case 'png':
+            return starts([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+        case 'jpeg':
+            return starts([0xff, 0xd8, 0xff]);
+        case 'webp':
+            // RIFF, a length, then WEBP.
+            return starts([0x52, 0x49, 0x46, 0x46]) && starts([0x57, 0x45, 0x42, 0x50], 8);
+    }
+}
+/**
+ * The image composited onto white. JPEG has no alpha, and a canvas encoder
+ * composites onto black without saying so, which turns a transparent ground
+ * into a black square round the code.
+ */
+export function flattenOnWhite(image) {
+    const { data } = image;
+    let opaque = true;
+    for (let i = 3; i < data.length; i += 4) {
+        if (data[i] !== 255) {
+            opaque = false;
+            break;
+        }
+    }
+    if (opaque)
+        return image;
+    const out = new Uint8ClampedArray(data.length);
+    for (let i = 0; i < data.length; i += 4) {
+        const a = data[i + 3] / 255;
+        out[i] = Math.round(data[i] * a + 255 * (1 - a));
+        out[i + 1] = Math.round(data[i + 1] * a + 255 * (1 - a));
+        out[i + 2] = Math.round(data[i + 2] * a + 255 * (1 - a));
+        out[i + 3] = 255;
+    }
+    return { width: image.width, height: image.height, data: out };
+}
+function refused(format, reason) {
+    return new QrStudioError('render/format-unavailable', 'This browser cannot save in that format. Choose PNG or SVG.', { format, reason });
+}
+function toBlob(canvas, type, quality) {
+    if (typeof canvas.convertToBlob === 'function') {
+        return canvas
+            .convertToBlob(quality === undefined ? { type } : { type, quality })
+            .catch(() => null);
+    }
+    if (typeof canvas.toBlob === 'function') {
+        const encode = canvas.toBlob.bind(canvas);
+        return new Promise((resolve) => encode((blob) => resolve(blob), type, quality));
+    }
+    return Promise.resolve(null);
+}
+/* v8 ignore start: the ImageData constructor exists only in a browser; tests pass createImageData. */
+function platformImageData(image) {
+    return new ImageData(image.data, image.width, image.height);
+}
+/* v8 ignore stop */
+export function canvasRasterEncoder(deps = {}) {
+    const create = deps.createCanvas ??
+        ((width, height) => platformCanvas(width, height));
+    const imageData = deps.createImageData ?? platformImageData;
+    return Object.freeze({
+        async encode(image, format, options = {}) {
+            const canvas = create(image.width, image.height);
+            const context = canvas?.getContext('2d') ?? null;
+            if (canvas === null || context === null)
+                return err(refused(format, 'canvas'));
+            canvas.width = image.width;
+            canvas.height = image.height;
+            const pixels = format === 'jpeg' ? flattenOnWhite(image) : image;
+            context.putImageData(imageData(pixels), 0, 0);
+            const blob = await toBlob(canvas, MIME[format], options.quality);
+            if (blob === null)
+                return err(refused(format, 'nothing'));
+            const bytes = new Uint8Array(await blob.arrayBuffer());
+            // The browser handed back something else, almost always a PNG.
+            if (!looksLike(bytes, format))
+                return err(refused(format, 'substituted'));
+            return ok(bytes);
+        },
+    });
+}
+//# sourceMappingURL=raster-encoder.js.map

package/dist/dom/raster-encoder.js.map

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