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

package/dist/dom/library/indexeddb.js

@@ -0,0 +1,365 @@
+/**
+ * The website's library: saved designs and brand kits in IndexedDB, once the
+ * person has switched the library on, and nowhere at all before then.
+ *
+ * This is the one file in the package allowed near browser storage
+ * (eslint.config.js, LIBRARY_FILE), and the one store it may use is
+ * IndexedDB. The offline app never reaches it: a page opened from `file://`
+ * has no origin worth trusting with storage, so the offline library is a file
+ * the person saves instead (src/dom/file-library.ts, which also holds the
+ * rules every record follows).
+ *
+ * "Nothing is stored until you ask" is meant mechanically:
+ *
+ * - Importing this module does nothing, and neither does creating a store.
+ *   The factory is passed in by the caller (`globalThis.indexedDB`), so even
+ *   the global is read only when the caller's code decides to read it.
+ * - `probe` asks `indexedDB.databases()` whether the library exists, which
+ *   reads the list of databases without opening one. A browser without it
+ *   (Firefox before 126) gets 'unknown', and the view offers "Open my
+ *   library": the click is the consent, and it is the first moment anything
+ *   is opened.
+ * - Every other operation opens the database only if it already exists. An
+ *   open that finds it gone (deleted from another tab between the check and
+ *   the open) aborts its own upgrade, which is what stops IndexedDB from
+ *   creating an empty one in its place. Only `enable` creates.
+ * - `disable` closes the connection and deletes the whole database. Nothing
+ *   anywhere records that the library was on, in localStorage or elsewhere:
+ *   such a flag would itself be something left behind before anybody agreed
+ *   to anything. The database existing is the flag, so deleting it leaves
+ *   nothing.
+ *
+ * Every failure is a Result. A full disk is 'library/quota'; a browser that
+ * will not store anything (a private window in some engines, a sandboxed
+ * frame, a delete held up by another tab) is 'library/unavailable'; a record
+ * that cannot be used is 'library/corrupt' and is left out of a listing
+ * rather than thrown. Platform errors are mapped by name and never carried
+ * along: an IndexedDB error message can quote the value it failed to store.
+ */
+import { QrStudioError } from '../../core/errors.js';
+import { err, ok } from '../../core/result.js';
+import { corruptError, libraryRecords, missingError, recordKey, skippedIssue, stamp, } from '../file-library.js';
+export const LIBRARY_DATABASE = 'qr-code-studio-library';
+/**
+ * The schema version. Version 1 has two object stores, `designs` and `kits`,
+ * each with keys the store gives out itself. A later version adds a step to
+ * `upgrade` for the versions before it, and never changes what one did.
+ */
+export const LIBRARY_DATABASE_VERSION = 1;
+const DESIGNS = 'designs';
+const KITS = 'kits';
+function unavailable(reason) {
+    return reason === 'blocked'
+        ? new QrStudioError('library/unavailable', 'The library is open in another tab. Close that tab and the library will be deleted.', { reason })
+        : new QrStudioError('library/unavailable', 'The library is not available in this browser, so designs and brand kits cannot be saved here.');
+}
+function notEnabled() {
+    return new QrStudioError('library/not-enabled', 'The library is switched off. Switch it on to save designs and brand kits in this browser.');
+}
+/**
+ * What a platform error amounts to, by its name alone. The error itself is
+ * dropped rather than kept as a cause: a DataCloneError's message, for one,
+ * quotes the value it could not store.
+ */
+function storageError(cause) {
+    const name = typeof cause === 'object' && cause !== null && 'name' in cause ? String(cause.name) : '';
+    // QuotaExceededError everywhere today; Firefox before version 58 had its own name.
+    if (name === 'QuotaExceededError' || name === 'NS_ERROR_DOM_QUOTA_REACHED') {
+        return new QrStudioError('library/quota', 'This browser has no more room for saved designs and brand kits. Remove some and try again.');
+    }
+    return unavailable();
+}
+/** The id a key the store gave out is known by. */
+function idOf(key) {
+    return String(key);
+}
+function idArgument(id, who) {
+    if (typeof id !== 'string')
+        throw new TypeError(`${who}: id is a string.`);
+    return id;
+}
+/** Make the stores a version needs, from the version the database was at. */
+function upgrade(db, from) {
+    if (from < 1) {
+        db.createObjectStore(DESIGNS, { autoIncrement: true });
+        db.createObjectStore(KITS, { autoIncrement: true });
+    }
+}
+/**
+ * The website's library, over the IndexedDB factory the caller passes:
+ * `createIndexedDbLibrary({ indexedDB: globalThis.indexedDB, registries })`.
+ * Creating it reads nothing and opens nothing.
+ */
+export function createIndexedDbLibrary(deps) {
+    if (typeof deps !== 'object' || deps === null) {
+        throw new TypeError('createIndexedDbLibrary: deps is { indexedDB, registries }.');
+    }
+    const records = libraryRecords(deps);
+    const factory = deps.indexedDB ?? null;
+    const now = deps.now ?? Date.now;
+    /** The connection, open or opening. Cleared when it fails, closes or is asked to go. */
+    let connection = null;
+    let open = null;
+    /**
+     * Drop the connection this store holds. Each connection ends once, by
+     * whichever comes first of a versionchange, the browser closing it or
+     * `disable`, and only while it is the one held, so there is never a newer
+     * one here for this to drop by mistake.
+     */
+    function forget() {
+        open = null;
+        connection = null;
+    }
+    /**
+     * Whether the library's database exists, from the list of databases, which
+     * opens nothing. Null when the browser cannot say.
+     */
+    async function exists(source) {
+        if (typeof source.databases !== 'function')
+            return null;
+        try {
+            const all = await source.databases();
+            return all.some((info) => info.name === LIBRARY_DATABASE);
+        }
+        catch {
+            return null;
+        }
+    }
+    function openDatabase(source, create) {
+        return new Promise((resolve) => {
+            let request;
+            try {
+                request = source.open(LIBRARY_DATABASE, LIBRARY_DATABASE_VERSION);
+            }
+            catch (thrown) {
+                resolve(err(storageError(thrown)));
+                return;
+            }
+            let declined = false;
+            request.onupgradeneeded = (event) => {
+                // Version 0 is a database IndexedDB has just made because nothing
+                // was there. Unless the person asked for one, abort the upgrade,
+                // which removes it again, and say the library is off.
+                if (event.oldVersion === 0 && !create) {
+                    declined = true;
+                    request.transaction.abort();
+                    return;
+                }
+                upgrade(request.result, event.oldVersion);
+            };
+            request.onsuccess = () => {
+                const db = request.result;
+                // Another tab switching the library off, or a newer build upgrading
+                // it, asks this connection to get out of the way. It does, at once,
+                // so the delete or the upgrade is never held up by this tab.
+                db.onversionchange = () => {
+                    db.close();
+                    forget();
+                };
+                // The browser closing it underneath (the person cleared site data).
+                db.onclose = () => forget();
+                open = db;
+                resolve(ok(db));
+            };
+            request.onerror = (event) => {
+                event.preventDefault();
+                resolve(err(declined ? notEnabled() : storageError(request.error)));
+            };
+        });
+    }
+    function connect(source, create) {
+        connection ??= openDatabase(source, create).then((opened) => {
+            if (!opened.ok)
+                connection = null;
+            return opened;
+        });
+        return connection;
+    }
+    /** The open database, for an operation that must not create one. */
+    async function existing() {
+        if (factory === null)
+            return err(unavailable());
+        if (connection !== null)
+            return connection;
+        if ((await exists(factory)) !== true)
+            return err(notEnabled());
+        return connect(factory, false);
+    }
+    /**
+     * Run one transaction. `work` makes its requests and returns how to read
+     * the answer, which is read once the transaction has committed, so a write
+     * is reported only when it is on disk and a failed commit (a full disk,
+     * which browsers report at commit) is reported as a failure.
+     */
+    async function transact(stores, mode, work) {
+        const db = await existing();
+        if (!db.ok)
+            return db;
+        return new Promise((resolve) => {
+            try {
+                const tx = db.value.transaction([...stores], mode);
+                const read = work(tx);
+                tx.oncomplete = () => resolve(ok(read()));
+                tx.onabort = () => resolve(err(storageError(tx.error)));
+            }
+            catch (thrown) {
+                // Refused as it was asked: a connection that closed in the meantime,
+                // or a value that cannot be stored. Each piece of work makes its one
+                // write last, so a transaction left behind by a throw holds nothing
+                // and commits nothing.
+                resolve(err(storageError(thrown)));
+            }
+        });
+    }
+    function everything(tx, collection, skipped) {
+        const out = [];
+        const cursor = tx.objectStore(collection.store).openCursor();
+        cursor.onsuccess = () => {
+            const at = cursor.result;
+            if (at === null)
+                return;
+            const id = idOf(at.key);
+            const checked = collection.check(at.value);
+            if (checked.problem !== null) {
+                skipped.push(skippedIssue(collection.store, id, checked.problem));
+            }
+            else
+                out.push(collection.summary(id, checked.entry));
+            at.continue();
+        };
+        return out;
+    }
+    function listOf(collection) {
+        return transact([collection.store], 'readonly', (tx) => {
+            const out = everything(tx, collection, []);
+            return () => Object.freeze(out);
+        });
+    }
+    async function saveTo(collection, entry) {
+        if (!entry.ok)
+            return entry;
+        const value = entry.value;
+        return transact([collection.store], 'readwrite', (tx) => {
+            const request = tx.objectStore(collection.store).add(value);
+            return () => collection.summary(idOf(request.result), value);
+        });
+    }
+    async function loadFrom(collection, id) {
+        const key = recordKey(id);
+        const read = await transact([collection.store], 'readonly', (tx) => {
+            const request = key === null ? null : tx.objectStore(collection.store).get(key);
+            return () => {
+                const value = request?.result;
+                if (value === undefined)
+                    return err(missingError());
+                const checked = collection.check(value);
+                return checked.problem !== null
+                    ? err(corruptError())
+                    : ok(collection.item(id, checked.entry));
+            };
+        });
+        return read.ok ? read.value : read;
+    }
+    function removeFrom(collection, id) {
+        const key = recordKey(id);
+        return transact([collection.store], 'readwrite', (tx) => {
+            // An id no store gave out names nothing, so there is nothing to remove.
+            if (key !== null)
+                tx.objectStore(collection.store).delete(key);
+            return () => null;
+        });
+    }
+    return Object.freeze({
+        async probe() {
+            if (factory === null) {
+                return ok(Object.freeze({ available: false, enabled: false, state: 'unavailable' }));
+            }
+            const found = open !== null ? true : await exists(factory);
+            const state = found === null ? 'unknown' : found ? 'on' : 'off';
+            return ok(Object.freeze({ available: true, enabled: found === true, state }));
+        },
+        async enable() {
+            if (factory === null)
+                return err(unavailable());
+            const before = connection === null ? null : await connection;
+            if (before?.ok === true)
+                return ok(null);
+            const opened = await connect(factory, true);
+            return opened.ok ? ok(null) : opened;
+        },
+        async disable() {
+            if (factory === null)
+                return err(unavailable());
+            // Closed first so this tab never blocks its own delete. Any other
+            // connection, in this tab or another, closes itself on the versionchange
+            // the delete sends.
+            const current = connection;
+            if (current !== null) {
+                const opened = await current;
+                if (opened.ok) {
+                    opened.value.close();
+                    forget();
+                }
+            }
+            return new Promise((resolve) => {
+                let request;
+                try {
+                    request = factory.deleteDatabase(LIBRARY_DATABASE);
+                }
+                catch (thrown) {
+                    resolve(err(storageError(thrown)));
+                    return;
+                }
+                request.onsuccess = () => resolve(ok(null));
+                request.onerror = (event) => {
+                    event.preventDefault();
+                    resolve(err(storageError(request.error)));
+                };
+                // Another tab holds a connection and did not let go. The delete
+                // stays queued and finishes when that tab closes; the person is
+                // told now rather than left waiting.
+                request.onblocked = () => resolve(err(unavailable('blocked')));
+            });
+        },
+        list() {
+            return listOf(records.designs);
+        },
+        contents() {
+            return transact([DESIGNS, KITS], 'readonly', (tx) => {
+                // Two cursors in one transaction take turns, so each keeps its own
+                // list of what it left out and the two are joined in a fixed order.
+                const skippedDesigns = [];
+                const skippedKits = [];
+                const designs = everything(tx, records.designs, skippedDesigns);
+                const kits = everything(tx, records.kits, skippedKits);
+                return () => Object.freeze({
+                    designs: Object.freeze(designs),
+                    kits: Object.freeze(kits),
+                    skipped: Object.freeze([...skippedDesigns, ...skippedKits]),
+                });
+            });
+        },
+        async save(item) {
+            return saveTo(records.designs, records.designIn(item, stamp(now)));
+        },
+        async load(id) {
+            return loadFrom(records.designs, idArgument(id, 'load'));
+        },
+        async remove(id) {
+            return removeFrom(records.designs, idArgument(id, 'remove'));
+        },
+        listKits() {
+            return listOf(records.kits);
+        },
+        async saveKit(item) {
+            return saveTo(records.kits, records.kitIn(item, stamp(now)));
+        },
+        async loadKit(id) {
+            return loadFrom(records.kits, idArgument(id, 'loadKit'));
+        },
+        async removeKit(id) {
+            return removeFrom(records.kits, idArgument(id, 'removeKit'));
+        },
+    });
+}
+//# sourceMappingURL=indexeddb.js.map

package/dist/dom/library/indexeddb.js.map

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

package/dist/dom/logo.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A person's picture, made into a logo a design can hold.
+ *
+ * Whatever comes in (a JPEG photograph, a PNG with transparency, a WebP), what
+ * goes into the design is a PNG this package encoded, at most 1024 pixels a
+ * side and 512 KiB, so any build of the studio in any browser decodes the
+ * same pixels from it. The reduction to that size is this package's own area
+ * averaging, not the canvas's, so the same file gives the same design
+ * everywhere.
+ *
+ * SVG files are refused for now: drawing one means running it through the
+ * browser, which draws it at whatever size it likes and lets it carry script,
+ * and a design never passes a person's SVG through to an export. A later
+ * milestone reads SVG paths itself.
+ *
+ * A refusal is an Issue, as everything a view shows beside a control is.
+ */
+import type { Issue } from '../core/issue.js';
+import type { RgbaImage } from '../core/image.js';
+import type { Result } from '../core/result.js';
+import type { DesignAsset } from '../studio/index.js';
+import type { ImageDecodeDeps } from './types.js';
+/** The issue an SVG logo gets. */
+export declare const SVG_LOGO_LATER = "design.issue.svg-logo-later";
+/** The note when a picture was made smaller to fit. */
+export declare const LOGO_DOWNSCALED = "dom.issue.logo-downscaled";
+export interface LogoImport {
+    readonly asset: DesignAsset;
+    /** The pixels the asset's PNG decodes to. */
+    readonly image: RgbaImage;
+    readonly issues: readonly Issue[];
+}
+export declare function importLogo(blob: Blob, options?: {
+    readonly deps?: ImageDecodeDeps;
+}): Promise<Result<LogoImport, Issue>>;
+//# sourceMappingURL=logo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../src/dom/logo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,kCAAkC;AAClC,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,uDAAuD;AACvD,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAW3D,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CAClC;AA2BD,wBAAsB,UAAU,CAC/B,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;CAAO,GAC/C,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAmCpC"}

package/dist/dom/logo.js

@@ -0,0 +1,99 @@
+/**
+ * A person's picture, made into a logo a design can hold.
+ *
+ * Whatever comes in (a JPEG photograph, a PNG with transparency, a WebP), what
+ * goes into the design is a PNG this package encoded, at most 1024 pixels a
+ * side and 512 KiB, so any build of the studio in any browser decodes the
+ * same pixels from it. The reduction to that size is this package's own area
+ * averaging, not the canvas's, so the same file gives the same design
+ * everywhere.
+ *
+ * SVG files are refused for now: drawing one means running it through the
+ * browser, which draws it at whatever size it likes and lets it carry script,
+ * and a design never passes a person's SVG through to an export. A later
+ * milestone reads SVG paths itself.
+ *
+ * A refusal is an Issue, as everything a view shows beside a control is.
+ */
+import { issue } from '../core/issue.js';
+import { err, ok } from '../core/result.js';
+import { base64 } from '../render/base64.js';
+import { encodePng } from '../render/png.js';
+import { errorKey } from '../studio/keys.js';
+import { LOGO_MAX_BYTES, LOGO_MAX_SIDE } from '../studio/logo.js';
+import { imageFromBlob } from './image.js';
+import { areaAverage, fitWithin } from './resample.js';
+/** The issue an SVG logo gets. */
+export const SVG_LOGO_LATER = 'design.issue.svg-logo-later';
+/** The note when a picture was made smaller to fit. */
+export const LOGO_DOWNSCALED = 'dom.issue.logo-downscaled';
+/**
+ * How large a picture is read before this package's own reduction: four
+ * times the logo's area, so the canvas does at most the coarse steps and the
+ * last one, which decides the pixels, is the area average.
+ */
+const READ_PIXELS = 4 * LOGO_MAX_SIDE * LOGO_MAX_SIDE;
+/** The smallest a logo is made to fit the byte limit. */
+const MIN_SIDE = 16;
+/** True when the first bytes look like markup rather than a picture: an SVG with no type on it. */
+function looksLikeMarkup(bytes) {
+    let at = 0;
+    // A UTF-8 byte order mark, then white space.
+    if (bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf)
+        at = 3;
+    while (at < bytes.length &&
+        (bytes[at] === 0x20 || bytes[at] === 0x09 || bytes[at] === 0x0a || bytes[at] === 0x0d)) {
+        at += 1;
+    }
+    return bytes[at] === 0x3c;
+}
+async function isSvg(blob) {
+    if (blob.type === 'image/svg+xml')
+        return true;
+    const name = blob.name;
+    if (typeof name === 'string' && /\.svgz?$/i.test(name))
+        return true;
+    try {
+        return looksLikeMarkup(new Uint8Array(await blob.slice(0, 64).arrayBuffer()));
+    }
+    catch {
+        return false;
+    }
+}
+export async function importLogo(blob, options = {}) {
+    if (await isSvg(blob))
+        return err(issue(SVG_LOGO_LATER, ['logo'], 'error'));
+    const read = await imageFromBlob(blob, {
+        maxPixels: READ_PIXELS,
+        ...(options.deps === undefined ? {} : { deps: options.deps }),
+    });
+    if (!read.ok)
+        return err(issue(errorKey(read.error), ['logo'], 'error', read.error.params));
+    const source = read.value;
+    let [width, height] = fitWithin(source.width, source.height, LOGO_MAX_SIDE);
+    let image = areaAverage(source, width, height);
+    let png = encodePng(image, { level: 9 });
+    // A photograph at 1024 pixels can be more than the design allows. A PNG's
+    // size goes about with its area, so the next try is the side that should
+    // fit with a little to spare, rather than a walk down in small steps that
+    // would encode a megapixel picture over and over. Each try starts from the
+    // source, so nothing is averaged twice.
+    while (png.length > LOGO_MAX_BYTES && Math.max(width, height) > MIN_SIDE) {
+        const longest = Math.max(width, height);
+        const scale = Math.sqrt(LOGO_MAX_BYTES / png.length) * 0.95;
+        const side = Math.max(MIN_SIDE, Math.min(longest - 1, Math.floor(longest * scale)));
+        [width, height] = fitWithin(width, height, side);
+        image = areaAverage(source, width, height);
+        png = encodePng(image, { level: 9 });
+    }
+    const issues = [];
+    if (width !== source.width || height !== source.height) {
+        issues.push(issue(LOGO_DOWNSCALED, ['logo'], 'info', { width, height }));
+    }
+    return ok(Object.freeze({
+        asset: Object.freeze({ png: base64(png), width, height }),
+        image,
+        issues: Object.freeze(issues),
+    }));
+}
+//# sourceMappingURL=logo.js.map

package/dist/dom/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../../src/dom/logo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGvD,kCAAkC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAC5D,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,GAAG,aAAa,GAAG,aAAa,CAAC;AACtD,yDAAyD;AACzD,MAAM,QAAQ,GAAG,EAAE,CAAC;AASpB,mGAAmG;AACnG,SAAS,eAAe,CAAC,KAAiB;IACzC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,6CAA6C;IAC7C,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,EAAE,GAAG,CAAC,CAAC;IACxE,OACC,EAAE,GAAG,KAAK,CAAC,MAAM;QACjB,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EACrF,CAAC;QACF,EAAE,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,IAAU;IAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,IAAI,GAAI,IAA2C,CAAC,IAAI,CAAC;IAC/D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,CAAC;QACJ,OAAO,eAAe,CAAC,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,IAAU,EACV,UAA+C,EAAE;IAEjD,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;QACtC,SAAS,EAAE,WAAW;QACtB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;KAC7D,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5E,IAAI,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACzC,0EAA0E;IAC1E,yEAAyE;IACzE,0EAA0E;IAC1E,2EAA2E;IAC3E,wCAAwC;IACxC,OAAO,GAAG,CAAC,MAAM,GAAG,cAAc,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,MAAM,CAAC,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,CACR,MAAM,CAAC,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACzD,KAAK;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;KAC7B,CAAC,CACF,CAAC;AACH,CAAC"}

package/dist/dom/orientation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+import type { RgbaImage } from '../core/image.js';
+export interface JpegFacts {
+    /** 1 to 8; 1 is as stored. */
+    readonly orientation: number;
+    /** The frame header's size, as stored, before any rotation. */
+    readonly width: number;
+    readonly height: number;
+}
+/** How much of a file the Exif segment and the frame header are looked for in. */
+export declare const ORIENTATION_BYTES = 65536;
+/** The orientation and stored size of a JPEG, or null when the bytes are not one this reads. */
+export declare function jpegFacts(bytes: Uint8Array): JpegFacts | null;
+/** True for the orientations that are a quarter turn, which swap width and height. */
+export declare function swapsSides(orientation: number): boolean;
+/** `image` turned and flipped the way Exif `orientation` says it should be shown. */
+export declare function applyOrientation(image: RgbaImage, orientation: number): RgbaImage;
+//# sourceMappingURL=orientation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../../src/dom/orientation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,SAAS;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAwCvC,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAuC7D;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CA0CjF"}