@intactfile/engines 0.1.0 → 0.3.0

package/dist/psd/format.js

@@ -0,0 +1,238 @@
+/**
+ * Pure PSD/PSB byte primitives: header parse/serialize, the four length-prefixed
+ * sections, image-resource (8BIM) walking, the embedded thumbnail, and the
+ * composite codec (raw / RLE-PackBits / ZIP). No wasm, no I/O — everything here
+ * is plain byte arithmetic, safe in the browser root export and unit-testable.
+ *
+ * A "repaired PSD" here means the FLATTENED composite is recovered — never the
+ * layer stack. See docs/engineering/engine-psd.md. All fields are big-endian.
+ */
+/** "8BPS" */
+export const PSD_SIGNATURE = Uint8Array.of(0x38, 0x42, 0x50, 0x53);
+/** PSB tops out at 300000²; cap pixels/bytes well below a memory bomb. */
+export const DEFAULT_PSD_CAPS = {
+    maxWidth: 300_000,
+    maxHeight: 300_000,
+    maxPixels: 500_000_000,
+    maxCompositeBytes: 2 * 1024 * 1024 * 1024,
+};
+// ---- readers / writers -------------------------------------------------------
+export const u16be = (b, o) => ((b[o] << 8) | b[o + 1]) >>> 0;
+export const u32be = (b, o) => ((b[o] << 24) | (b[o + 1] << 16) | (b[o + 2] << 8) | b[o + 3]) >>> 0;
+/** 64-bit big-endian as a JS number (safe for our bounded offsets). */
+export const u64be = (b, o) => u32be(b, o) * 0x1_0000_0000 + u32be(b, o + 4);
+export function writeU16be(b, o, v) {
+    b[o] = (v >>> 8) & 0xff;
+    b[o + 1] = v & 0xff;
+}
+export function writeU32be(b, o, v) {
+    b[o] = (v >>> 24) & 0xff;
+    b[o + 1] = (v >>> 16) & 0xff;
+    b[o + 2] = (v >>> 8) & 0xff;
+    b[o + 3] = v & 0xff;
+}
+export function hasSignatureAt(b, off) {
+    return b[off] === 0x38 && b[off + 1] === 0x42 && b[off + 2] === 0x50 && b[off + 3] === 0x53;
+}
+/** The "8B" fingerprint is present but the full "8BPS" magic is not exact. */
+export function looksLikePsdAt(b, off) {
+    return b[off] === 0x38 && b[off + 1] === 0x42 && !hasSignatureAt(b, off);
+}
+/** First offset of a valid 8BPS signature within `window`, or -1. */
+export function findSignature(b, window) {
+    const limit = Math.min(b.length - 4, window);
+    for (let i = 0; i <= limit; i++) {
+        if (b[i] === 0x38 && hasSignatureAt(b, i))
+            return i;
+    }
+    return -1;
+}
+const VALID_DEPTHS = new Set([1, 8, 16, 32]);
+const VALID_MODES = new Set([0, 1, 2, 3, 4, 7, 8, 9]);
+/** Parse and validate the 26-byte header at `off`. Returns null if implausible. */
+export function parseHeader(b, off = 0) {
+    if (off + 26 > b.length)
+        return null;
+    if (!hasSignatureAt(b, off))
+        return null;
+    const version = u16be(b, off + 4);
+    if (version !== 1 && version !== 2)
+        return null;
+    const channels = u16be(b, off + 12);
+    const height = u32be(b, off + 14);
+    const width = u32be(b, off + 18);
+    const depth = u16be(b, off + 22);
+    const colorMode = u16be(b, off + 24);
+    if (channels < 1 || channels > 56)
+        return null;
+    if (!VALID_DEPTHS.has(depth))
+        return null;
+    if (!VALID_MODES.has(colorMode))
+        return null;
+    const maxDim = version === 2 ? 300_000 : 30_000;
+    if (width < 1 || height < 1 || width > maxDim || height > maxDim)
+        return null;
+    return { version: version, channels, height, width, depth, colorMode };
+}
+export function serializeHeader(h) {
+    const b = new Uint8Array(26);
+    b.set(PSD_SIGNATURE, 0);
+    writeU16be(b, 4, h.version);
+    // bytes 6..11 reserved zero (already zero)
+    writeU16be(b, 12, h.channels);
+    writeU32be(b, 14, h.height);
+    writeU32be(b, 18, h.width);
+    writeU16be(b, 22, h.depth);
+    writeU16be(b, 24, h.colorMode);
+    return b;
+}
+/** Bytes per scanline for one channel at this width/depth. */
+export const rowBytes = (width, depth) => Math.ceil((width * depth) / 8);
+/** Length of the color-mode data section forced by color mode (0 unless Indexed/Duotone). */
+export function expectedColorModeLen(actualLen, colorMode) {
+    // Indexed (2) = 768-byte palette; Duotone (8) carries opaque data we preserve as-is.
+    if (colorMode === 2)
+        return 768;
+    if (colorMode === 8)
+        return actualLen; // preserve whatever is declared
+    return 0;
+}
+/**
+ * Walk the section chain from offset 26, trusting declared lengths. Records
+ * sections that dangle past EOF (the truncation / bad-length signal). Never
+ * decodes pixels.
+ */
+export function mapSections(b, header) {
+    const dangling = [];
+    const span = (name, offset, lenBytes) => {
+        const length = lenBytes === 8 ? u64be(b, offset) : u32be(b, offset);
+        const dataOffset = offset + lenBytes;
+        const end = dataOffset + length;
+        if (end > b.length)
+            dangling.push(name);
+        return { offset, dataOffset, length, end };
+    };
+    const colorMode = span('colorMode', 26, 4);
+    const cmEnd = Math.min(colorMode.end, b.length);
+    const imageResources = span('imageResources', cmEnd, 4);
+    const irEnd = Math.min(imageResources.end, b.length);
+    const layerAndMask = span('layerAndMask', irEnd, header.version === 2 ? 8 : 4);
+    const lmEnd = Math.min(layerAndMask.end, b.length);
+    const imageDataOffset = lmEnd;
+    return { header, colorMode, imageResources, layerAndMask, imageDataOffset, danglingSections: dangling };
+}
+const even = (n) => (n & 1 ? n + 1 : n);
+/** Re-walk the self-delimiting 8BIM resource blocks; recompute the true length. */
+export function walkImageResources(b, start, declaredLen) {
+    const blocks = [];
+    const hardEnd = Math.min(start + declaredLen, b.length);
+    let p = start;
+    let thumbnail;
+    while (p + 8 <= b.length) {
+        // Stop if we've clearly left the section (no more 8BIM) — self-delimiting walk.
+        if (!(b[p] === 0x38 && b[p + 1] === 0x42 && b[p + 2] === 0x49 && b[p + 3] === 0x4d))
+            break; // "8BIM"
+        const id = u16be(b, p + 4);
+        // Pascal name follows the 2-byte ID: 1-byte length + bytes, whole field padded to even.
+        let q = p + 6;
+        const nameLen = b[q];
+        q += 1 + nameLen;
+        if ((1 + nameLen) & 1)
+            q += 1; // pad to even
+        if (q + 4 > b.length)
+            break;
+        const dataLength = u32be(b, q);
+        const dataOffset = q + 4;
+        const paddedData = even(dataLength);
+        const blockEnd = dataOffset + paddedData;
+        if (dataOffset + dataLength > b.length)
+            break; // dangling block
+        if ((id === 1036 || id === 1033) && !thumbnail) {
+            const t = findJpeg(b, dataOffset, dataOffset + dataLength);
+            if (t)
+                thumbnail = { ...t, resourceId: id };
+        }
+        blocks.push({ id, offset: p, dataOffset, dataLength, totalLength: blockEnd - p });
+        p = blockEnd;
+        if (p > hardEnd && blocks.length > 0)
+            break; // walked past the declared section
+    }
+    return { blocks, trueLength: p - start, thumbnail };
+}
+/** Largest complete FFD8..FFD9 JPEG within [from,to). */
+export function findJpeg(b, from, to) {
+    const hi = Math.min(to, b.length) - 1;
+    for (let i = from; i < hi; i++) {
+        if (b[i] === 0xff && b[i + 1] === 0xd8 && b[i + 2] === 0xff) {
+            for (let j = i + 2; j < hi; j++) {
+                if (b[j] === 0xff && b[j + 1] === 0xd9)
+                    return { offset: i, length: j + 2 - i };
+            }
+            return null;
+        }
+    }
+    return null;
+}
+// ---- PackBits (RLE) ----------------------------------------------------------
+/**
+ * Decode one PackBits scanline from b[pos..end) into up to `outLen` bytes.
+ * Returns the row and how many output bytes were produced (short if damaged).
+ */
+export function unpackBitsRow(b, pos, end, outLen) {
+    const row = new Uint8Array(outLen);
+    let o = 0;
+    let p = pos;
+    while (p < end && o < outLen) {
+        let n = b[p++];
+        if (n >= 128)
+            n -= 256;
+        if (n >= 0) {
+            const count = n + 1;
+            for (let i = 0; i < count && p < end && o < outLen; i++)
+                row[o++] = b[p++];
+        }
+        else if (n !== -128) {
+            const count = 1 - n;
+            if (p >= end)
+                break;
+            const val = b[p++];
+            for (let i = 0; i < count && o < outLen; i++)
+                row[o++] = val;
+        }
+    }
+    return { row, produced: o };
+}
+/** Encode one scanline with PackBits (Adobe/TIFF variant). */
+export function packBitsRow(row) {
+    const out = [];
+    const n = row.length;
+    let i = 0;
+    while (i < n) {
+        // count a run of equal bytes
+        let runEnd = i + 1;
+        while (runEnd < n && row[runEnd] === row[i] && runEnd - i < 128)
+            runEnd++;
+        const runLen = runEnd - i;
+        if (runLen >= 2) {
+            out.push(257 - runLen); // (1 - runLen) as unsigned byte
+            out.push(row[i]);
+            i = runEnd;
+        }
+        else {
+            // literal run until the next 2-byte repeat (or 128 max)
+            let litEnd = i + 1;
+            while (litEnd < n &&
+                litEnd - i < 128 &&
+                !(litEnd + 1 < n && row[litEnd] === row[litEnd + 1])) {
+                litEnd++;
+            }
+            const litLen = litEnd - i;
+            out.push(litLen - 1);
+            for (let k = i; k < litEnd; k++)
+                out.push(row[k]);
+            i = litEnd;
+        }
+    }
+    return Uint8Array.from(out);
+}
+//# sourceMappingURL=format.js.map

package/dist/psd/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/psd/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,aAAa;AACb,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAsBnE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI;CAC1C,CAAC;AAEF,iFAAiF;AAEjF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAa,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAa,EAAE,CAAS,EAAU,EAAE,CACxD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;AAC3E,uEAAuE;AACvE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAa,EAAE,CAAS,EAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AAEzG,MAAM,UAAU,UAAU,CAAC,CAAa,EAAE,CAAS,EAAE,CAAS;IAC5D,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IACxB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,CAAa,EAAE,CAAS,EAAE,CAAS;IAC5D,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACzB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC7B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAa,EAAE,GAAW;IACvD,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;AAC9F,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,CAAa,EAAE,GAAW;IACvD,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,MAAc;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEtD,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,CAAa,EAAE,GAAG,GAAG,CAAC;IAChD,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACrC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,MAAM,IAAI,MAAM,GAAG,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,OAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAY;IAC1C,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACxB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5B,2CAA2C;IAC3C,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9B,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5B,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAEjG,6FAA6F;AAC7F,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,SAAuB;IAC7E,qFAAqF;IACrF,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAChC,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,gCAAgC;IACvE,OAAO,CAAC,CAAC;AACX,CAAC;AAsBD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,CAAa,EAAE,MAAiB;IAC1D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,QAAe,EAAe,EAAE;QAC1E,MAAM,MAAM,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;QACrC,MAAM,GAAG,GAAG,UAAU,GAAG,MAAM,CAAC;QAChC,IAAI,GAAG,GAAG,CAAC,CAAC,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC7C,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,eAAe,GAAG,KAAK,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC;AAC1G,CAAC;AAoBD,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,CAAa,EAAE,KAAa,EAAE,WAAmB;IAClF,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,IAAI,SAAoC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACzB,gFAAgF;QAChF,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;YAAE,MAAM,CAAC,SAAS;QACrG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,wFAAwF;QACxF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACtB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QACjB,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;YAAE,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;QAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM;YAAE,MAAM;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;QACzC,IAAI,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC,MAAM;YAAE,MAAM,CAAC,iBAAiB;QAChE,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC;YAC3D,IAAI,CAAC;gBAAE,SAAS,GAAG,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC9C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC,GAAG,QAAQ,CAAC;QACb,IAAI,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,mCAAmC;IAClF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC;AACtD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,QAAQ,CAAC,CAAa,EAAE,IAAY,EAAE,EAAU;IAC9D,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;oBAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClF,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,GAAW,EAAE,GAAW,EAAE,MAAc;IACnF,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,GAAG,CAAC;IACZ,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG;YAAE,CAAC,IAAI,GAAG,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC;QAC9E,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,GAAG;gBAAE,MAAM;YACpB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC;YACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAC9B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,GAAe;IACzC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IACrB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACb,6BAA6B;QAC7B,IAAI,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,GAAG,GAAG;YAAE,MAAM,EAAE,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;QAC1B,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,gCAAgC;YACxD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC;YAClB,CAAC,GAAG,MAAM,CAAC;QACb,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,IAAI,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,OACE,MAAM,GAAG,CAAC;gBACV,MAAM,GAAG,CAAC,GAAG,GAAG;gBAChB,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EACpD,CAAC;gBACD,MAAM,EAAE,CAAC;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC;YACnD,CAAC,GAAG,MAAM,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/psd/index.d.ts

@@ -0,0 +1,8 @@
+export declare const repairPsd: (src: import("../byte-source.js").ByteSource, opts?: import("./repair.js").PsdRepairOptions | undefined) => Promise<import("./repair.js").PsdRepairResult>;
+export { repairPsdBytes } from "./repair.js";
+export type { PsdRepairOutcome, PsdRepairReport, PsdRepairOptions, PsdRepairResult, } from "./repair.js";
+export { diagnosePsd, diagnosePsdBytes } from "./diagnose.js";
+export type { PsdDiagnosis, PsdDamageClass } from "./diagnose.js";
+export { PSD_SIGNATURE, DEFAULT_PSD_CAPS, parseHeader, serializeHeader, mapSections, walkImageResources, rowBytes, } from "./format.js";
+export type { PsdHeader, PsdSafetyCaps, PsdCompression, PsdSections, ResourceWalk } from "./format.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/psd/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,SAAS,4JAAmB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/psd/index.js

@@ -0,0 +1,13 @@
+/**
+ * PSD/PSB engine subpath export (`@intactfile/engines/psd`). Pure TypeScript —
+ * pako (MIT) + fast-png (MIT), no wasm — so it is browser-safe. Recovers the
+ * FLATTENED composite (never the layer stack). diagnosePsd is pure and also
+ * promoted to the root barrel; repairPsd stays behind this subpath and is gated.
+ */
+import { gate } from "../license.js";
+import { repairPsd as _repairPsd } from "./repair.js";
+export const repairPsd = gate(_repairPsd);
+export { repairPsdBytes } from "./repair.js";
+export { diagnosePsd, diagnosePsdBytes } from "./diagnose.js";
+export { PSD_SIGNATURE, DEFAULT_PSD_CAPS, parseHeader, serializeHeader, mapSections, walkImageResources, rowBytes, } from "./format.js";
+//# sourceMappingURL=index.js.map

package/dist/psd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/psd/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/psd/repair.d.ts

@@ -0,0 +1,36 @@
+import type { ByteSource } from "../byte-source.js";
+import { type PsdDamageClass } from "./diagnose.js";
+import { type PsdSafetyCaps } from "./format.js";
+export type PsdRepairOutcome = "success" | "partial" | "failed";
+export interface PsdRepairReport {
+    outcome: PsdRepairOutcome;
+    damageClass: PsdDamageClass;
+    actions: string[];
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+    width: number | null;
+    height: number | null;
+    channels: number | null;
+    depth: number | null;
+    colorMode: number | null;
+    /** False whenever the input carried layers that were dropped when flattening. */
+    layersRecovered: boolean;
+    rowsRecovered: number | null;
+    rowsExpected: number | null;
+    previewSource: "composite-png" | "thumbnail-jpeg" | null;
+    /** What the returned primary bytes are (psd file, png preview, or jpeg thumbnail). */
+    output: "psd" | "png" | "jpeg" | null;
+    verified: boolean;
+}
+export interface PsdRepairOptions {
+    caps?: PsdSafetyCaps;
+}
+export interface PsdRepairResult {
+    psd?: Uint8Array;
+    preview?: Uint8Array;
+    report: PsdRepairReport;
+}
+export declare function repairPsdBytes(input: Uint8Array, opts?: PsdRepairOptions): PsdRepairResult;
+export declare function repairPsd(src: ByteSource, opts?: PsdRepairOptions): Promise<PsdRepairResult>;
+//# sourceMappingURL=repair.d.ts.map

package/dist/psd/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/psd/repair.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAGL,KAAK,aAAa,EAenB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACzD,sFAAsF;IACtF,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB;AA8RD,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,gBAAqB,GAAG,eAAe,CAiJ9F;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAEtG"}