@intactfile/engines 0.1.0

package/dist/jpeg/format.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Pure JPEG marker-scan primitives — no wasm, no third-party deps, so this
+ * module is safe to pull into the browser-facing diagnosis path.
+ *
+ * A JPEG is a sequence of marker segments framed by 0xFF <marker> bytes.
+ * Standalone markers (SOI, EOI, RSTn, TEM) carry no payload; every other
+ * marker is followed by a big-endian 2-byte length that INCLUDES those two
+ * length bytes. After SOS the entropy-coded scan data runs raw until the next
+ * real marker (0xFF followed by a non-0x00, non-RSTn byte), typically EOI.
+ *
+ * Two views are offered: a strict sequential walk (order, overflow, structural
+ * corruption) and a robust presence scan (which markers exist *anywhere*, so a
+ * destroyed header whose SOS+scan survived is still recognisable — the case
+ * donor transplant exists for).
+ */
+export declare const M_SOI = 216;
+export declare const M_EOI = 217;
+export declare const M_TEM = 1;
+export declare const M_RST0 = 208;
+export declare const M_RST7 = 215;
+export declare const M_SOS = 218;
+export declare const M_DQT = 219;
+export declare const M_DHT = 196;
+export declare const M_DRI = 221;
+export declare const M_APP0 = 224;
+export declare const M_APP15 = 239;
+export declare const M_COM = 254;
+/** SOF markers are 0xC0..0xCF except 0xC4 (DHT), 0xC8 (JPG), 0xCC (DAC). */
+export declare function isSofMarker(m: number): boolean;
+export declare function isAppMarker(m: number): boolean;
+export declare function isStandaloneMarker(m: number): boolean;
+export declare function markerName(m: number): string;
+export declare function readU16BE(b: Uint8Array, off: number): number;
+/** Locate the first SOI (0xFFD8) within [0, window). Returns -1 if absent. */
+export declare function findSoi(bytes: Uint8Array, window?: number): number;
+export interface MarkerSegment {
+    marker: number;
+    name: string;
+    /** Offset of the 0xFF byte. */
+    offset: number;
+    /** Declared segment length (payload+2), or 0 for standalone markers. */
+    length: number;
+}
+export interface MarkerScan {
+    soiOffset: number;
+    segments: MarkerSegment[];
+    /** Offset of the SOS 0xFF byte, or -1. */
+    sosOffset: number;
+    /** First byte of entropy-coded scan data, or -1. */
+    scanStart: number;
+    /** One past the last scan byte (EOI offset or EOF), or -1. */
+    scanEnd: number;
+    /** Offset of the trailing EOI 0xFF byte, or -1. */
+    eoiOffset: number;
+    hasEoi: boolean;
+    /** A segment length ran past EOF (structural corruption or truncation). */
+    overflow: boolean;
+    /** Expected a 0xFF marker lead but found something else before SOS. */
+    badMarker: boolean;
+    /** Ran out of bytes while still walking the header (before SOS resolved). */
+    truncatedHeader: boolean;
+}
+/**
+ * Strict sequential walk from SOI. Stops at SOS (recording where the scan
+ * begins) or at the first structural problem. Never throws.
+ */
+export declare function scanMarkers(bytes: Uint8Array, soiOffset: number): MarkerScan;
+/** Find the trailing EOI (0xFFD9) scanning forward from `from`. */
+export declare function findEoiFrom(bytes: Uint8Array, from: number): number;
+export interface MarkerPresence {
+    hasDqt: boolean;
+    hasDht: boolean;
+    hasSof: boolean;
+    hasSos: boolean;
+    hasEoi: boolean;
+    /** Offset of the first SOS 0xFF byte, or -1. */
+    sosOffset: number;
+    /** Offset of the last EOI 0xFF byte, or -1. */
+    eoiOffset: number;
+    /** Offset of the first SOF 0xFF byte, or -1. */
+    sofOffset: number;
+}
+/**
+ * Robust presence scan: look for each key marker anywhere in [start, end),
+ * independent of sequence. Survives a zeroed/garbled header as long as the
+ * marker bytes themselves are intact — how we recognise "header destroyed but
+ * scan alive". Skips 0xFF00 byte-stuffing and 0xFFFF fill.
+ */
+export declare function scanMarkerPresence(bytes: Uint8Array, start: number, end?: number): MarkerPresence;
+/**
+ * Read the frame dimensions from a SOF segment at `sofOffset` (the 0xFF byte).
+ * SOF layout: FF Cx | len(2) | precision(1) | height(2) | width(2) | ...
+ * Returns null when the segment is not fully present.
+ */
+export declare function readSofDimensions(bytes: Uint8Array, sofOffset: number): {
+    width: number;
+    height: number;
+} | null;
+/**
+ * Shannon entropy (bits/byte, 0..8) over [start, end). A healthy JPEG scan is
+ * high (~7.3–8.0); a zeroed or overwritten scan collapses toward 0 — a cheap
+ * triage hint for "structure looks fine but the pixels were destroyed". For
+ * large ranges the data is strided to cap cost. Returns null for empty ranges.
+ */
+export declare function shannonEntropy(bytes: Uint8Array, start: number, end: number): number | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/jpeg/format.d.ts.map

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

package/dist/jpeg/format.js

@@ -0,0 +1,248 @@
+/**
+ * Pure JPEG marker-scan primitives — no wasm, no third-party deps, so this
+ * module is safe to pull into the browser-facing diagnosis path.
+ *
+ * A JPEG is a sequence of marker segments framed by 0xFF <marker> bytes.
+ * Standalone markers (SOI, EOI, RSTn, TEM) carry no payload; every other
+ * marker is followed by a big-endian 2-byte length that INCLUDES those two
+ * length bytes. After SOS the entropy-coded scan data runs raw until the next
+ * real marker (0xFF followed by a non-0x00, non-RSTn byte), typically EOI.
+ *
+ * Two views are offered: a strict sequential walk (order, overflow, structural
+ * corruption) and a robust presence scan (which markers exist *anywhere*, so a
+ * destroyed header whose SOS+scan survived is still recognisable — the case
+ * donor transplant exists for).
+ */
+// Standalone markers (no length field).
+export const M_SOI = 0xd8;
+export const M_EOI = 0xd9;
+export const M_TEM = 0x01;
+export const M_RST0 = 0xd0;
+export const M_RST7 = 0xd7;
+// Segment markers we care about.
+export const M_SOS = 0xda;
+export const M_DQT = 0xdb;
+export const M_DHT = 0xc4;
+export const M_DRI = 0xdd;
+export const M_APP0 = 0xe0;
+export const M_APP15 = 0xef;
+export const M_COM = 0xfe;
+/** SOF markers are 0xC0..0xCF except 0xC4 (DHT), 0xC8 (JPG), 0xCC (DAC). */
+export function isSofMarker(m) {
+    return m >= 0xc0 && m <= 0xcf && m !== 0xc4 && m !== 0xc8 && m !== 0xcc;
+}
+export function isAppMarker(m) {
+    return m >= M_APP0 && m <= M_APP15;
+}
+export function isStandaloneMarker(m) {
+    return m === M_SOI || m === M_EOI || m === M_TEM || (m >= M_RST0 && m <= M_RST7);
+}
+export function markerName(m) {
+    switch (m) {
+        case M_SOI:
+            return 'SOI';
+        case M_EOI:
+            return 'EOI';
+        case M_SOS:
+            return 'SOS';
+        case M_DQT:
+            return 'DQT';
+        case M_DHT:
+            return 'DHT';
+        case M_DRI:
+            return 'DRI';
+        case M_COM:
+            return 'COM';
+        case M_TEM:
+            return 'TEM';
+        default:
+            break;
+    }
+    if (isSofMarker(m))
+        return `SOF${m - 0xc0}`;
+    if (isAppMarker(m))
+        return `APP${m - M_APP0}`;
+    if (m >= M_RST0 && m <= M_RST7)
+        return `RST${m - M_RST0}`;
+    return `0x${m.toString(16).padStart(2, '0')}`;
+}
+export function readU16BE(b, off) {
+    return ((b[off] ?? 0) << 8) | (b[off + 1] ?? 0);
+}
+/** Locate the first SOI (0xFFD8) within [0, window). Returns -1 if absent. */
+export function findSoi(bytes, window = bytes.length) {
+    const limit = Math.min(bytes.length - 1, window);
+    for (let i = 0; i <= limit; i++) {
+        if (bytes[i] === 0xff && bytes[i + 1] === M_SOI)
+            return i;
+    }
+    return -1;
+}
+/**
+ * Strict sequential walk from SOI. Stops at SOS (recording where the scan
+ * begins) or at the first structural problem. Never throws.
+ */
+export function scanMarkers(bytes, soiOffset) {
+    const scan = {
+        soiOffset,
+        segments: [],
+        sosOffset: -1,
+        scanStart: -1,
+        scanEnd: -1,
+        eoiOffset: -1,
+        hasEoi: false,
+        overflow: false,
+        badMarker: false,
+        truncatedHeader: false,
+    };
+    const len = bytes.length;
+    let i = soiOffset + 2;
+    while (i < len) {
+        // 0xFF fill bytes are permitted before a marker.
+        while (i < len && bytes[i] === 0xff && bytes[i + 1] === 0xff)
+            i++;
+        if (i + 1 >= len) {
+            scan.truncatedHeader = true;
+            break;
+        }
+        if (bytes[i] !== 0xff) {
+            scan.badMarker = true;
+            break;
+        }
+        const m = bytes[i + 1];
+        if (m === M_EOI) {
+            scan.hasEoi = true;
+            scan.eoiOffset = i;
+            break;
+        }
+        if (isStandaloneMarker(m)) {
+            i += 2;
+            continue;
+        }
+        if (i + 3 >= len) {
+            scan.truncatedHeader = true;
+            break;
+        }
+        const segLen = readU16BE(bytes, i + 2);
+        scan.segments.push({ marker: m, name: markerName(m), offset: i, length: segLen });
+        if (m === M_SOS) {
+            scan.sosOffset = i;
+            scan.scanStart = i + 2 + segLen;
+            // Scan data ends at the trailing EOI, else EOF.
+            const eoi = findEoiFrom(bytes, scan.scanStart);
+            scan.eoiOffset = eoi;
+            scan.hasEoi = eoi !== -1;
+            scan.scanEnd = eoi === -1 ? len : eoi;
+            if (scan.scanStart > len)
+                scan.overflow = true;
+            break;
+        }
+        const segEnd = i + 2 + segLen;
+        if (segLen < 2 || segEnd > len) {
+            scan.overflow = true;
+            break;
+        }
+        i = segEnd;
+    }
+    return scan;
+}
+/** Find the trailing EOI (0xFFD9) scanning forward from `from`. */
+export function findEoiFrom(bytes, from) {
+    for (let i = Math.max(0, from); i + 1 < bytes.length; i++) {
+        if (bytes[i] === 0xff && bytes[i + 1] === M_EOI)
+            return i;
+    }
+    return -1;
+}
+/**
+ * Robust presence scan: look for each key marker anywhere in [start, end),
+ * independent of sequence. Survives a zeroed/garbled header as long as the
+ * marker bytes themselves are intact — how we recognise "header destroyed but
+ * scan alive". Skips 0xFF00 byte-stuffing and 0xFFFF fill.
+ */
+export function scanMarkerPresence(bytes, start, end = bytes.length) {
+    const p = {
+        hasDqt: false,
+        hasDht: false,
+        hasSof: false,
+        hasSos: false,
+        hasEoi: false,
+        sosOffset: -1,
+        eoiOffset: -1,
+        sofOffset: -1,
+    };
+    const limit = Math.min(end, bytes.length) - 1;
+    for (let i = Math.max(0, start); i <= limit; i++) {
+        if (bytes[i] !== 0xff)
+            continue;
+        const m = bytes[i + 1];
+        if (m === 0x00 || m === 0xff)
+            continue; // stuffing / fill
+        if (m === M_DQT)
+            p.hasDqt = true;
+        else if (m === M_DHT)
+            p.hasDht = true;
+        else if (isSofMarker(m)) {
+            p.hasSof = true;
+            if (p.sofOffset === -1)
+                p.sofOffset = i;
+        }
+        else if (m === M_SOS) {
+            p.hasSos = true;
+            if (p.sosOffset === -1)
+                p.sosOffset = i;
+        }
+        else if (m === M_EOI) {
+            p.hasEoi = true;
+            p.eoiOffset = i;
+        }
+    }
+    return p;
+}
+/**
+ * Read the frame dimensions from a SOF segment at `sofOffset` (the 0xFF byte).
+ * SOF layout: FF Cx | len(2) | precision(1) | height(2) | width(2) | ...
+ * Returns null when the segment is not fully present.
+ */
+export function readSofDimensions(bytes, sofOffset) {
+    if (sofOffset < 0 || sofOffset + 9 > bytes.length)
+        return null;
+    const height = readU16BE(bytes, sofOffset + 5);
+    const width = readU16BE(bytes, sofOffset + 7);
+    if (width === 0 || height === 0)
+        return null;
+    return { width, height };
+}
+/**
+ * Shannon entropy (bits/byte, 0..8) over [start, end). A healthy JPEG scan is
+ * high (~7.3–8.0); a zeroed or overwritten scan collapses toward 0 — a cheap
+ * triage hint for "structure looks fine but the pixels were destroyed". For
+ * large ranges the data is strided to cap cost. Returns null for empty ranges.
+ */
+export function shannonEntropy(bytes, start, end) {
+    const lo = Math.max(0, start);
+    const hi = Math.min(bytes.length, end);
+    const span = hi - lo;
+    if (span <= 0)
+        return null;
+    const stride = span > 65536 ? Math.ceil(span / 65536) : 1;
+    const hist = new Uint32Array(256);
+    let n = 0;
+    for (let i = lo; i < hi; i += stride) {
+        const b = bytes[i];
+        hist[b] = (hist[b] ?? 0) + 1;
+        n++;
+    }
+    if (n === 0)
+        return null;
+    let h = 0;
+    for (let v = 0; v < 256; v++) {
+        const c = hist[v];
+        if (c === 0)
+            continue;
+        const pr = c / n;
+        h -= pr * Math.log2(pr);
+    }
+    return h;
+}
+//# sourceMappingURL=format.js.map

package/dist/jpeg/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/jpeg/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,wCAAwC;AACxC,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;AAC3B,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;AAE3B,iCAAiC;AACjC,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC;AAC5B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAE1B,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,OAAO,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf;YACE,MAAM;IACV,CAAC;IACD,IAAI,WAAW,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IAC5C,IAAI,WAAW,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IAC9C,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IAC1D,OAAO,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAa,EAAE,GAAW;IAClD,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,OAAO,CAAC,KAAiB,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK;YAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AA+BD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,SAAiB;IAC9D,MAAM,IAAI,GAAe;QACvB,SAAS;QACT,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC;QACb,SAAS,EAAE,CAAC,CAAC;QACb,OAAO,EAAE,CAAC,CAAC;QACX,SAAS,EAAE,CAAC,CAAC;QACb,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,KAAK;KACvB,CAAC;IACF,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;IAEtB,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;QACf,iDAAiD;QACjD,OAAO,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;YAAE,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,MAAM;QACR,CAAC;QACD,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAExB,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;YACnB,MAAM;QACR,CAAC;QACD,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAElF,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YAChC,gDAAgD;YAChD,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;YACrB,IAAI,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtC,IAAI,IAAI,CAAC,SAAS,GAAG,GAAG;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC/C,MAAM;QACR,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QAC9B,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,MAAM;QACR,CAAC;QACD,CAAC,GAAG,MAAM,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,IAAY;IACzD,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK;YAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAgBD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB,EAAE,KAAa,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM;IACrF,MAAM,CAAC,GAAmB;QACxB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,CAAC,CAAC;QACb,SAAS,EAAE,CAAC,CAAC;QACb,SAAS,EAAE,CAAC,CAAC;KACd,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,SAAS;QAChC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACxB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS,CAAC,kBAAkB;QAC1D,IAAI,CAAC,KAAK,KAAK;YAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;aAC5B,IAAI,CAAC,KAAK,KAAK;YAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;aACjC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC;gBAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YACvB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC;gBAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YACvB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAiB,EAAE,SAAiB;IACpE,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,KAAa,EAAE,GAAW;IAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC;IACrB,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC,EAAE,CAAC;IACN,CAAC;IACD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QACtB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/jpeg/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JPEG engine subpath export (`@intactfile/engines/jpeg`). Kept out of the
+ * root export so browser bundles that never touch JPEGs never pull in the
+ * @jsquash codec wasm or exifr; even here, the codec wasm only loads on the
+ * first repairJpeg call. diagnoseJpeg is pure marker-scanning and safe to call
+ * eagerly.
+ */
+export { diagnoseJpeg, LOW_SCAN_ENTROPY, SOI_SCAN_WINDOW } from './diagnose.js';
+export type { JpegDiagnosis, JpegDamageClass } from './diagnose.js';
+export { repairJpeg, buildRepairCandidates, transplantHeader } from './repair.js';
+export type { JpegRepairResult, JpegRepairReport, JpegRepairOptions, JpegRepairOutcome, JpegRepairStrategy, JpegRepairAttempt, } from './repair.js';
+export { extractExifThumbnail, extractExifOrientation } from './exif.js';
+export { decodeJpeg, encodeJpeg, setJpegLoader, resetJpegHost, SALVAGE_ENCODE_OPTIONS, } from './mozjpeg-host.js';
+export type { DecodedImage, DecodeResult, JpegCodecLoader, JpegEncodeOptions } from './mozjpeg-host.js';
+export { createBrowserJpegLoader, DEFAULT_JPEG_BASE_URL } from './browser-loader.js';
+export { markerName, isSofMarker, isAppMarker, scanMarkers, scanMarkerPresence, findSoi, findEoiFrom, readSofDimensions, shannonEntropy, } from './format.js';
+export type { MarkerScan, MarkerSegment, MarkerPresence } from './format.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jpeg/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExG,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/jpeg/index.js

@@ -0,0 +1,14 @@
+/**
+ * JPEG engine subpath export (`@intactfile/engines/jpeg`). Kept out of the
+ * root export so browser bundles that never touch JPEGs never pull in the
+ * @jsquash codec wasm or exifr; even here, the codec wasm only loads on the
+ * first repairJpeg call. diagnoseJpeg is pure marker-scanning and safe to call
+ * eagerly.
+ */
+export { diagnoseJpeg, LOW_SCAN_ENTROPY, SOI_SCAN_WINDOW } from './diagnose.js';
+export { repairJpeg, buildRepairCandidates, transplantHeader } from './repair.js';
+export { extractExifThumbnail, extractExifOrientation } from './exif.js';
+export { decodeJpeg, encodeJpeg, setJpegLoader, resetJpegHost, SALVAGE_ENCODE_OPTIONS, } from './mozjpeg-host.js';
+export { createBrowserJpegLoader, DEFAULT_JPEG_BASE_URL } from './browser-loader.js';
+export { markerName, isSofMarker, isAppMarker, scanMarkers, scanMarkerPresence, findSoi, findEoiFrom, readSofDimensions, shannonEntropy, } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/jpeg/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jpeg/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhF,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUlF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/jpeg/mozjpeg-host.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Isolated host for the MozJPEG (libjpeg-turbo lineage) wasm codec shipped by
+ * @jsquash/jpeg 1.6.0 (Apache-2.0). Two wasm modules: the decoder
+ * (mozjpeg_dec.wasm, ~163 KB) and the encoder (mozjpeg_enc.wasm, ~246 KB).
+ * Everything that touches the codec lives here; nothing else in the package
+ * imports @jsquash/jpeg, and the wasm is only compiled on first use.
+ *
+ * Loading is injectable, same shape as pdf/qpdf-host.ts and video/libav-host.ts:
+ * the Node default loader reads the two .wasm files from node_modules and
+ * compiles them; a browser host calls setJpegLoader() with a loader that
+ * fetches+compiles them from a same-origin URL (see browser-loader.ts). This
+ * matters because @jsquash's default codec path uses fetch(import.meta.url)
+ * to locate the wasm, which does not work in Node.
+ *
+ * Why a warning-capturing decoder matters: libjpeg emits "Premature end of
+ * JPEG file" / "Corrupt JPEG data" to stderr but STILL returns the rows it
+ * managed to decode (the rest filled grey). Capturing that stderr is how we
+ * honestly tell a full decode from a partial salvage.
+ */
+import decodeWasmDefault from '@jsquash/jpeg/decode.js';
+import encodeWasmDefault from '@jsquash/jpeg/encode.js';
+import type { EncodeOptions } from '@jsquash/jpeg/meta.js';
+export interface DecodedImage {
+    data: Uint8Array;
+    width: number;
+    height: number;
+}
+export type DecodeResult = {
+    ok: true;
+    image: DecodedImage;
+    warnings: string[];
+} | {
+    ok: false;
+    warnings: string[];
+    error: string;
+};
+export interface JpegCodecLoader {
+    /** Resolve a compiled decoder module (mozjpeg_dec.wasm). */
+    decodeModule: () => Promise<WebAssembly.Module>;
+    /** Resolve a compiled encoder module (mozjpeg_enc.wasm). */
+    encodeModule: () => Promise<WebAssembly.Module>;
+}
+/** Inject how the codec wasm modules are obtained (browser hosts). */
+export declare function setJpegLoader(load: () => Promise<JpegCodecLoader>): void;
+/** Drop the cached codec init (tests, or after a wasm crash). */
+export declare function resetJpegHost(): void;
+/**
+ * Decode a JPEG, tolerating truncation/corruption. Returns a discriminated
+ * result rather than throwing: `ok:false` for a hard failure (no scan, missing
+ * SOS, unusable header), `ok:true` with `warnings` populated for a partial
+ * salvage (top rows recovered, remainder grey). Never throws for bad input.
+ */
+export declare function decodeJpeg(bytes: Uint8Array): Promise<DecodeResult>;
+export type JpegEncodeOptions = Partial<EncodeOptions>;
+/** Baseline, widely-compatible re-emission of a salvaged raster. */
+export declare const SALVAGE_ENCODE_OPTIONS: JpegEncodeOptions;
+/** Encode an RGBA raster to a valid baseline JPEG. */
+export declare function encodeJpeg(image: DecodedImage, options?: JpegEncodeOptions): Promise<Uint8Array>;
+export { decodeWasmDefault, encodeWasmDefault };
+//# sourceMappingURL=mozjpeg-host.d.ts.map

package/dist/jpeg/mozjpeg-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mozjpeg-host.d.ts","sourceRoot":"","sources":["../../src/jpeg/mozjpeg-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,iBAA4C,MAAM,yBAAyB,CAAC;AACnF,OAAO,iBAA4C,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQ3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,4DAA4D;IAC5D,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;CACjD;AAKD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAGxE;AAED,iEAAiE;AACjE,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAyDD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBnE;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAEvD,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,EAAE,iBAKpC,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAepG;AAGD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/jpeg/mozjpeg-host.js

@@ -0,0 +1,138 @@
+/**
+ * Isolated host for the MozJPEG (libjpeg-turbo lineage) wasm codec shipped by
+ * @jsquash/jpeg 1.6.0 (Apache-2.0). Two wasm modules: the decoder
+ * (mozjpeg_dec.wasm, ~163 KB) and the encoder (mozjpeg_enc.wasm, ~246 KB).
+ * Everything that touches the codec lives here; nothing else in the package
+ * imports @jsquash/jpeg, and the wasm is only compiled on first use.
+ *
+ * Loading is injectable, same shape as pdf/qpdf-host.ts and video/libav-host.ts:
+ * the Node default loader reads the two .wasm files from node_modules and
+ * compiles them; a browser host calls setJpegLoader() with a loader that
+ * fetches+compiles them from a same-origin URL (see browser-loader.ts). This
+ * matters because @jsquash's default codec path uses fetch(import.meta.url)
+ * to locate the wasm, which does not work in Node.
+ *
+ * Why a warning-capturing decoder matters: libjpeg emits "Premature end of
+ * JPEG file" / "Corrupt JPEG data" to stderr but STILL returns the rows it
+ * managed to decode (the rest filled grey). Capturing that stderr is how we
+ * honestly tell a full decode from a partial salvage.
+ */
+import decodeWasmDefault, { init as initDecodeRaw } from '@jsquash/jpeg/decode.js';
+import encodeWasmDefault, { init as initEncodeRaw } from '@jsquash/jpeg/encode.js';
+const initDecode = initDecodeRaw;
+const initEncode = initEncodeRaw;
+let loaderOverride = null;
+let initPromise = null;
+/** Inject how the codec wasm modules are obtained (browser hosts). */
+export function setJpegLoader(load) {
+    loaderOverride = load;
+    initPromise = null;
+}
+/** Drop the cached codec init (tests, or after a wasm crash). */
+export function resetJpegHost() {
+    initPromise = null;
+}
+// stderr is captured per-run via a mutable sink; runs are serialized so the
+// sink can never belong to two decodes at once.
+let activeErr = null;
+function errSink(line) {
+    activeErr?.push(typeof line === 'string' ? line : String(line));
+}
+async function defaultNodeLoader() {
+    const isNode = typeof process !== 'undefined' && !!process.versions?.node;
+    if (!isNode) {
+        throw new Error('jpeg host: no loader configured. In the browser, call setJpegLoader() with a loader that ' +
+            'fetches and compiles the @jsquash/jpeg dec/enc wasm from a same-origin URL before repairing JPEGs.');
+    }
+    const { createRequire } = await import('node:module');
+    const { readFile } = await import('node:fs/promises');
+    const require = createRequire(import.meta.url);
+    const decPath = require.resolve('@jsquash/jpeg/codec/dec/mozjpeg_dec.wasm');
+    const encPath = require.resolve('@jsquash/jpeg/codec/enc/mozjpeg_enc.wasm');
+    return {
+        decodeModule: async () => WebAssembly.compile(await readFile(decPath)),
+        encodeModule: async () => WebAssembly.compile(await readFile(encPath)),
+    };
+}
+async function ensureInit() {
+    initPromise ??= (async () => {
+        const loader = await (loaderOverride ?? defaultNodeLoader)();
+        const [decMod, encMod] = await Promise.all([loader.decodeModule(), loader.encodeModule()]);
+        // Route the decoder's stderr into our capture sink; silence stdout.
+        await initDecode(decMod, { printErr: errSink, print: () => { } });
+        await initEncode(encMod, { printErr: () => { }, print: () => { } });
+    })().catch((e) => {
+        initPromise = null;
+        throw e;
+    });
+    return initPromise;
+}
+let runChain = Promise.resolve();
+/** Serialize codec calls so the shared stderr sink is unambiguous. */
+function exclusive(fn) {
+    const run = runChain.then(fn);
+    runChain = run.catch(() => undefined);
+    return run;
+}
+/** Standalone ArrayBuffer copy of `bytes` (jSquash decode wants an ArrayBuffer). */
+function toArrayBuffer(bytes) {
+    const copy = new Uint8Array(bytes.length);
+    copy.set(bytes);
+    return copy.buffer;
+}
+/**
+ * Decode a JPEG, tolerating truncation/corruption. Returns a discriminated
+ * result rather than throwing: `ok:false` for a hard failure (no scan, missing
+ * SOS, unusable header), `ok:true` with `warnings` populated for a partial
+ * salvage (top rows recovered, remainder grey). Never throws for bad input.
+ */
+export function decodeJpeg(bytes) {
+    return exclusive(async () => {
+        await ensureInit();
+        const warnings = [];
+        activeErr = warnings;
+        try {
+            const img = await decodeWasmDefault(toArrayBuffer(bytes));
+            const data = new Uint8Array(img.data.length);
+            data.set(img.data);
+            return { ok: true, image: { data, width: img.width, height: img.height }, warnings };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                warnings,
+                error: e instanceof Error ? e.message : String(e),
+            };
+        }
+        finally {
+            activeErr = null;
+        }
+    });
+}
+/** Baseline, widely-compatible re-emission of a salvaged raster. */
+export const SALVAGE_ENCODE_OPTIONS = {
+    quality: 85,
+    baseline: true,
+    progressive: false,
+    optimize_coding: true,
+};
+/** Encode an RGBA raster to a valid baseline JPEG. */
+export function encodeJpeg(image, options = {}) {
+    return exclusive(async () => {
+        await ensureInit();
+        const imageData = {
+            data: new Uint8ClampedArray(image.data.buffer, image.data.byteOffset, image.data.byteLength),
+            width: image.width,
+            height: image.height,
+            colorSpace: 'srgb',
+        };
+        const buf = await encodeWasmDefault(imageData, {
+            ...SALVAGE_ENCODE_OPTIONS,
+            ...options,
+        });
+        return new Uint8Array(buf);
+    });
+}
+// Re-export for the default node path check and browser loader typing.
+export { decodeWasmDefault, encodeWasmDefault };
+//# sourceMappingURL=mozjpeg-host.js.map

package/dist/jpeg/mozjpeg-host.js.map

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