@intactfile/engines 0.1.0

package/dist/png/format.d.ts

@@ -0,0 +1,133 @@
+/** The canonical 8-byte PNG signature (89 50 4E 47 0D 0A 1A 0A). */
+export declare const PNG_SIGNATURE: Uint8Array<ArrayBuffer>;
+export interface PngSafetyCaps {
+    maxWidth: number;
+    maxHeight: number;
+    /** Total pixels — the real bomb guard (width*height before allocation). */
+    maxPixels: number;
+    /** Hard ceiling on inflated bytes, independent of declared dimensions. */
+    maxInflatedBytes: number;
+}
+/**
+ * Conservative defaults. 100 MP covers any legitimate consumer photo while
+ * refusing the classic "tiny IDAT, gigantic IHDR" decompression bomb.
+ */
+export declare const DEFAULT_PNG_CAPS: PngSafetyCaps;
+export declare function readU32BE(bytes: Uint8Array, off: number): number;
+export declare function writeU32BE(bytes: Uint8Array, off: number, value: number): void;
+export declare function ascii4(bytes: Uint8Array, off: number): string;
+/** True when the 8 canonical signature bytes sit exactly at `off`. */
+export declare function hasSignatureAt(bytes: Uint8Array, off: number): boolean;
+/** True when bytes 1..3 at `off` spell "PNG" (recognizable even if mangled). */
+export declare function looksLikePngAt(bytes: Uint8Array, off: number): boolean;
+/** Offset of a pristine signature within the first `maxScan` bytes, or -1. */
+export declare function findSignature(bytes: Uint8Array, maxScan?: number): number;
+/**
+ * Reverse FTP/ASCII-mode "Unix→DOS" newline mangling: a CR was inserted before
+ * every LF, so removing every CR that immediately precedes an LF restores the
+ * original bytes exactly (the transform is injective, so this is lossless for
+ * any binary payload — including a PNG's IDAT).
+ */
+export declare function unmangleNewlines(bytes: Uint8Array): Uint8Array;
+/**
+ * Detect Unix→DOS newline mangling: the file does not begin with a valid
+ * signature, but un-mangling makes a valid signature appear at offset 0.
+ */
+export declare function looksNewlineMangled(bytes: Uint8Array): boolean;
+/** Samples per pixel for a PNG colour type, or null when unknown. */
+export declare function channelsForColorType(colorType: number): number | null;
+/** Whether a (bitDepth, colorType) pair is a spec-legal combination. */
+export declare function isValidColorConfig(bitDepth: number, colorType: number): boolean;
+/** Bytes per (unfiltered) scanline, excluding the leading filter byte. */
+export declare function bytesPerRow(width: number, channels: number, bitDepth: number): number;
+/** Inflated stride of one scanline: filter byte + row bytes. */
+export declare function scanlineStride(width: number, channels: number, bitDepth: number): number;
+export interface PngChunk {
+    /** Offset of the 4-byte length field. */
+    offset: number;
+    /** Declared data length. */
+    length: number;
+    type: string;
+    dataOffset: number;
+    /** Offset of the stored 4-byte CRC (== dataOffset + length). */
+    crcOffset: number;
+    /** Bytes of chunk data actually present (< length when truncated). */
+    availableData: number;
+    /** Declared data + CRC run past the end of the buffer. */
+    truncated: boolean;
+    crcStored: number | null;
+    crcComputed: number | null;
+    /** null when the chunk is truncated (CRC cannot be verified). */
+    crcOk: boolean | null;
+}
+export interface ChunkWalk {
+    chunks: PngChunk[];
+    /** Offset just past the last fully-parsed chunk. */
+    endOffset: number;
+    sawIend: boolean;
+    /** A chunk's declared length/CRC ran past EOF. */
+    truncated: boolean;
+}
+/**
+ * Walk PNG chunks in memory from `start` (which must be just after the 8-byte
+ * signature). Verifies each chunk's CRC over type+data. Stops at IEND, at the
+ * first structurally impossible length, or when the buffer runs out.
+ */
+export declare function walkChunksInMemory(bytes: Uint8Array, start: number): ChunkWalk;
+export interface IhdrFields {
+    width: number;
+    height: number;
+    bitDepth: number;
+    colorType: number;
+    compression: number;
+    filter: number;
+    interlace: number;
+}
+/** Parse the 13-byte IHDR data payload. Returns null if too short. */
+export declare function parseIhdr(data: Uint8Array): IhdrFields | null;
+/** Serialize IHDR fields back into a fresh 13-byte payload. */
+export declare function serializeIhdr(f: IhdrFields): Uint8Array;
+/** CRC over an IHDR chunk (type "IHDR" + 13-byte data), for CRC brute-force. */
+export declare function ihdrCrc(data: Uint8Array): number;
+export interface DimensionCandidate {
+    width: number;
+    height: number;
+}
+/**
+ * All (width, height) pairs consistent with a known inflated IDAT size, for a
+ * non-interlaced image with the given channels/bitDepth:
+ *   inflatedSize === height * (1 + ceil(width*channels*bitDepth/8))
+ */
+export declare function factorizeDimensions(inflatedSize: number, channels: number, bitDepth: number, caps?: PngSafetyCaps): DimensionCandidate[];
+export interface ReconstructedDimensions extends DimensionCandidate {
+    /** true = disambiguated against the stored IHDR CRC (certain). */
+    exact: boolean;
+    /** Number of factorization candidates considered. */
+    candidates: number;
+}
+/**
+ * Recover width/height for an IHDR whose dimension bytes are corrupt.
+ * Strategy: factor the (trusted) inflated IDAT size, then disambiguate against
+ * the stored IHDR CRC when available. Falls back to the most "photo-like"
+ * candidate (aspect ratio closest to 4:3) when the CRC cannot decide.
+ */
+export declare function reconstructDimensions(args: {
+    tail: {
+        bitDepth: number;
+        colorType: number;
+        compression: number;
+        filter: number;
+        interlace: number;
+    };
+    inflatedSize: number;
+    storedCrc: number | null;
+    caps?: PngSafetyCaps;
+}): ReconstructedDimensions | null;
+/**
+ * Reverse PNG filters over `rows` complete 8-bit scanlines taken from the head
+ * of an inflated IDAT stream. Returns the raw sample bytes (no filter bytes),
+ * ready to hand to fast-png's encoder. Only 8-bit depth is handled here; the
+ * caller must gate on bitDepth === 8.
+ */
+export declare function unfilterScanlines8(raw: Uint8Array, rows: number, width: number, channels: number): Uint8Array;
+//# sourceMappingURL=format.d.ts.map

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

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

package/dist/png/format.js

@@ -0,0 +1,350 @@
+/**
+ * Pure PNG byte primitives: signature handling, chunk walking, CRC, dimension
+ * reconstruction and scanline unfiltering. No wasm, no I/O — everything here
+ * operates on plain byte arrays so it is safe in the browser root export and
+ * trivially unit-testable.
+ *
+ * Reference: PNG spec (W3C, 2003) and the pngcheck chunk model.
+ */
+import { crc32 } from '../crc32.js';
+/** The canonical 8-byte PNG signature (89 50 4E 47 0D 0A 1A 0A). */
+export const PNG_SIGNATURE = Uint8Array.of(0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a);
+/** Bytes 1..3 of the signature spell "PNG" — the recognizable fingerprint. */
+const PNG_ASCII = Uint8Array.of(0x50, 0x4e, 0x47);
+/**
+ * Conservative defaults. 100 MP covers any legitimate consumer photo while
+ * refusing the classic "tiny IDAT, gigantic IHDR" decompression bomb.
+ */
+export const DEFAULT_PNG_CAPS = {
+    maxWidth: 100_000,
+    maxHeight: 100_000,
+    maxPixels: 100_000_000,
+    maxInflatedBytes: 512 * 1024 * 1024,
+};
+export function readU32BE(bytes, off) {
+    return (((bytes[off] << 24) | (bytes[off + 1] << 16) | (bytes[off + 2] << 8) | bytes[off + 3]) >>> 0);
+}
+export function writeU32BE(bytes, off, value) {
+    bytes[off] = (value >>> 24) & 0xff;
+    bytes[off + 1] = (value >>> 16) & 0xff;
+    bytes[off + 2] = (value >>> 8) & 0xff;
+    bytes[off + 3] = value & 0xff;
+}
+export function ascii4(bytes, off) {
+    return String.fromCharCode(bytes[off], bytes[off + 1], bytes[off + 2], bytes[off + 3]);
+}
+/** True when the 8 canonical signature bytes sit exactly at `off`. */
+export function hasSignatureAt(bytes, off) {
+    if (off + 8 > bytes.length)
+        return false;
+    for (let i = 0; i < 8; i += 1)
+        if (bytes[off + i] !== PNG_SIGNATURE[i])
+            return false;
+    return true;
+}
+/** True when bytes 1..3 at `off` spell "PNG" (recognizable even if mangled). */
+export function looksLikePngAt(bytes, off) {
+    return (bytes[off + 1] === PNG_ASCII[0] &&
+        bytes[off + 2] === PNG_ASCII[1] &&
+        bytes[off + 3] === PNG_ASCII[2]);
+}
+/** Offset of a pristine signature within the first `maxScan` bytes, or -1. */
+export function findSignature(bytes, maxScan = 64 * 1024) {
+    const limit = Math.min(bytes.length - 8, maxScan);
+    for (let i = 0; i <= limit; i += 1) {
+        if (bytes[i] === 0x89 && bytes[i + 1] === 0x50 && hasSignatureAt(bytes, i))
+            return i;
+    }
+    return -1;
+}
+/**
+ * Reverse FTP/ASCII-mode "Unix→DOS" newline mangling: a CR was inserted before
+ * every LF, so removing every CR that immediately precedes an LF restores the
+ * original bytes exactly (the transform is injective, so this is lossless for
+ * any binary payload — including a PNG's IDAT).
+ */
+export function unmangleNewlines(bytes) {
+    const out = new Uint8Array(bytes.length);
+    let n = 0;
+    for (let i = 0; i < bytes.length; i += 1) {
+        if (bytes[i] === 0x0d && bytes[i + 1] === 0x0a)
+            continue;
+        out[n++] = bytes[i];
+    }
+    return out.subarray(0, n);
+}
+/**
+ * Detect Unix→DOS newline mangling: the file does not begin with a valid
+ * signature, but un-mangling makes a valid signature appear at offset 0.
+ */
+export function looksNewlineMangled(bytes) {
+    if (bytes.length < 10)
+        return false;
+    if (hasSignatureAt(bytes, 0))
+        return false;
+    // Fast pre-check on the head: mangled signature starts 89 50 4E 47 0D 0D 0A.
+    const head = unmangleNewlines(bytes.subarray(0, 16));
+    return hasSignatureAt(head, 0);
+}
+/** Samples per pixel for a PNG colour type, or null when unknown. */
+export function channelsForColorType(colorType) {
+    switch (colorType) {
+        case 0:
+            return 1; // grayscale
+        case 2:
+            return 3; // truecolour
+        case 3:
+            return 1; // indexed (one palette index per pixel)
+        case 4:
+            return 2; // grayscale + alpha
+        case 6:
+            return 4; // truecolour + alpha
+        default:
+            return null;
+    }
+}
+const VALID_BIT_DEPTHS = new Set([1, 2, 4, 8, 16]);
+/** Whether a (bitDepth, colorType) pair is a spec-legal combination. */
+export function isValidColorConfig(bitDepth, colorType) {
+    if (!VALID_BIT_DEPTHS.has(bitDepth))
+        return false;
+    switch (colorType) {
+        case 0:
+            return true; // 1/2/4/8/16
+        case 3:
+            return bitDepth <= 8; // palette: 1/2/4/8
+        case 2:
+        case 4:
+        case 6:
+            return bitDepth === 8 || bitDepth === 16;
+        default:
+            return false;
+    }
+}
+/** Bytes per (unfiltered) scanline, excluding the leading filter byte. */
+export function bytesPerRow(width, channels, bitDepth) {
+    return Math.ceil((width * channels * bitDepth) / 8);
+}
+/** Inflated stride of one scanline: filter byte + row bytes. */
+export function scanlineStride(width, channels, bitDepth) {
+    return 1 + bytesPerRow(width, channels, bitDepth);
+}
+/**
+ * Walk PNG chunks in memory from `start` (which must be just after the 8-byte
+ * signature). Verifies each chunk's CRC over type+data. Stops at IEND, at the
+ * first structurally impossible length, or when the buffer runs out.
+ */
+export function walkChunksInMemory(bytes, start) {
+    const chunks = [];
+    let pos = start;
+    let sawIend = false;
+    let truncated = false;
+    while (pos + 8 <= bytes.length) {
+        const length = readU32BE(bytes, pos);
+        const type = ascii4(bytes, pos + 4);
+        const dataOffset = pos + 8;
+        const crcOffset = dataOffset + length;
+        const bytesLeft = bytes.length - dataOffset;
+        // A length that overflows the remaining file means the chunk (and file)
+        // is truncated, or the length field itself is corrupt. Either way we can
+        // record what is present but cannot verify the CRC.
+        if (crcOffset + 4 > bytes.length) {
+            chunks.push({
+                offset: pos,
+                length,
+                type,
+                dataOffset,
+                crcOffset,
+                availableData: Math.max(0, Math.min(length, bytesLeft)),
+                truncated: true,
+                crcStored: null,
+                crcComputed: null,
+                crcOk: null,
+            });
+            truncated = true;
+            break;
+        }
+        const crcStored = readU32BE(bytes, crcOffset);
+        const crcComputed = crc32(bytes.subarray(pos + 4, crcOffset));
+        chunks.push({
+            offset: pos,
+            length,
+            type,
+            dataOffset,
+            crcOffset,
+            availableData: length,
+            truncated: false,
+            crcStored,
+            crcComputed,
+            crcOk: crcStored === crcComputed,
+        });
+        pos = crcOffset + 4;
+        if (type === 'IEND') {
+            sawIend = true;
+            break;
+        }
+    }
+    // Leftover bytes too short to form another chunk header, with no IEND seen,
+    // mean the final chunk header itself was cut off.
+    if (!sawIend && pos < bytes.length)
+        truncated = true;
+    return { chunks, endOffset: pos, sawIend, truncated };
+}
+/** Parse the 13-byte IHDR data payload. Returns null if too short. */
+export function parseIhdr(data) {
+    if (data.length < 13)
+        return null;
+    return {
+        width: readU32BE(data, 0),
+        height: readU32BE(data, 4),
+        bitDepth: data[8],
+        colorType: data[9],
+        compression: data[10],
+        filter: data[11],
+        interlace: data[12],
+    };
+}
+/** Serialize IHDR fields back into a fresh 13-byte payload. */
+export function serializeIhdr(f) {
+    const data = new Uint8Array(13);
+    writeU32BE(data, 0, f.width);
+    writeU32BE(data, 4, f.height);
+    data[8] = f.bitDepth;
+    data[9] = f.colorType;
+    data[10] = f.compression;
+    data[11] = f.filter;
+    data[12] = f.interlace;
+    return data;
+}
+/** CRC over an IHDR chunk (type "IHDR" + 13-byte data), for CRC brute-force. */
+export function ihdrCrc(data) {
+    return crc32(data, crc32(Uint8Array.of(0x49, 0x48, 0x44, 0x52)));
+}
+/**
+ * All (width, height) pairs consistent with a known inflated IDAT size, for a
+ * non-interlaced image with the given channels/bitDepth:
+ *   inflatedSize === height * (1 + ceil(width*channels*bitDepth/8))
+ */
+export function factorizeDimensions(inflatedSize, channels, bitDepth, caps = DEFAULT_PNG_CAPS) {
+    const out = [];
+    if (inflatedSize <= 0)
+        return out;
+    const maxW = Math.min(caps.maxWidth, inflatedSize);
+    for (let width = 1; width <= maxW; width += 1) {
+        const stride = scanlineStride(width, channels, bitDepth);
+        if (inflatedSize % stride !== 0)
+            continue;
+        const height = inflatedSize / stride;
+        if (height >= 1 && height <= caps.maxHeight && width * height <= caps.maxPixels) {
+            out.push({ width, height });
+        }
+    }
+    return out;
+}
+/**
+ * Recover width/height for an IHDR whose dimension bytes are corrupt.
+ * Strategy: factor the (trusted) inflated IDAT size, then disambiguate against
+ * the stored IHDR CRC when available. Falls back to the most "photo-like"
+ * candidate (aspect ratio closest to 4:3) when the CRC cannot decide.
+ */
+export function reconstructDimensions(args) {
+    const { tail, inflatedSize, storedCrc } = args;
+    const caps = args.caps ?? DEFAULT_PNG_CAPS;
+    const channels = channelsForColorType(tail.colorType);
+    if (channels === null)
+        return null;
+    const candidates = factorizeDimensions(inflatedSize, channels, tail.bitDepth, caps);
+    if (candidates.length === 0)
+        return null;
+    if (storedCrc !== null) {
+        for (const c of candidates) {
+            const data = serializeIhdr({
+                width: c.width,
+                height: c.height,
+                bitDepth: tail.bitDepth,
+                colorType: tail.colorType,
+                compression: tail.compression,
+                filter: tail.filter,
+                interlace: tail.interlace,
+            });
+            if (ihdrCrc(data) === storedCrc) {
+                return { ...c, exact: true, candidates: candidates.length };
+            }
+        }
+    }
+    // No CRC match: pick the candidate whose aspect ratio is closest to 4:3.
+    const TARGET = 4 / 3;
+    let best = candidates[0];
+    let bestErr = Infinity;
+    for (const c of candidates) {
+        const err = Math.abs(c.width / c.height - TARGET);
+        if (err < bestErr) {
+            bestErr = err;
+            best = c;
+        }
+    }
+    return { ...best, exact: false, candidates: candidates.length };
+}
+// ---------------------------------------------------------------------------
+// Scanline unfiltering (8-bit depth, 1..4 channels, non-interlaced)
+// ---------------------------------------------------------------------------
+function paeth(a, b, c) {
+    const p = a + b - c;
+    const pa = Math.abs(p - a);
+    const pb = Math.abs(p - b);
+    const pc = Math.abs(p - c);
+    if (pa <= pb && pa <= pc)
+        return a;
+    if (pb <= pc)
+        return b;
+    return c;
+}
+/**
+ * Reverse PNG filters over `rows` complete 8-bit scanlines taken from the head
+ * of an inflated IDAT stream. Returns the raw sample bytes (no filter bytes),
+ * ready to hand to fast-png's encoder. Only 8-bit depth is handled here; the
+ * caller must gate on bitDepth === 8.
+ */
+export function unfilterScanlines8(raw, rows, width, channels) {
+    const bpp = channels; // bytes per pixel at 8-bit depth
+    const rowBytes = width * channels;
+    const stride = 1 + rowBytes;
+    const out = new Uint8Array(rows * rowBytes);
+    for (let y = 0; y < rows; y += 1) {
+        const filterType = raw[y * stride];
+        const inStart = y * stride + 1;
+        const outStart = y * rowBytes;
+        const prevStart = outStart - rowBytes;
+        for (let x = 0; x < rowBytes; x += 1) {
+            const rawByte = raw[inStart + x];
+            const a = x >= bpp ? out[outStart + x - bpp] : 0;
+            const b = y > 0 ? out[prevStart + x] : 0;
+            const c = y > 0 && x >= bpp ? out[prevStart + x - bpp] : 0;
+            let value;
+            switch (filterType) {
+                case 0:
+                    value = rawByte;
+                    break;
+                case 1:
+                    value = rawByte + a;
+                    break;
+                case 2:
+                    value = rawByte + b;
+                    break;
+                case 3:
+                    value = rawByte + ((a + b) >> 1);
+                    break;
+                case 4:
+                    value = rawByte + paeth(a, b, c);
+                    break;
+                default:
+                    // Unknown filter: pass the byte through rather than throwing, so a
+                    // corrupted filter byte does not sink an otherwise-salvageable row.
+                    value = rawByte;
+            }
+            out[outStart + x] = value & 0xff;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=format.js.map

package/dist/png/format.js.map

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

package/dist/png/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PNG engine subpath export (`@intactfile/engines/png`). Pure TypeScript —
+ * pako (MIT) + fast-png (MIT), no wasm — so it is browser-safe. Kept on its own
+ * key (not the root barrel) purely to avoid touching src/index.ts; the parent
+ * integration can promote diagnosePng to the root if desired since it is pure.
+ */
+export { diagnosePng } from './diagnose.js';
+export type { PngDiagnosis, PngDamageClass, PngChunkInfo } from './diagnose.js';
+export { repairPng } from './repair.js';
+export type { PngRepairReport, PngRepairOutcome, PngRepairOptions, PngRepairResult, } from './repair.js';
+export { PNG_SIGNATURE, DEFAULT_PNG_CAPS, walkChunksInMemory, factorizeDimensions, reconstructDimensions, channelsForColorType, isValidColorConfig, bytesPerRow, scanlineStride, unfilterScanlines8, unmangleNewlines, looksNewlineMangled, findSignature, hasSignatureAt, parseIhdr, serializeIhdr, ihdrCrc, } from './format.js';
+export type { PngChunk, ChunkWalk, IhdrFields, PngSafetyCaps, DimensionCandidate, ReconstructedDimensions, } from './format.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/png/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,SAAS,EACT,aAAa,EACb,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/png/index.js

@@ -0,0 +1,10 @@
+/**
+ * PNG engine subpath export (`@intactfile/engines/png`). Pure TypeScript —
+ * pako (MIT) + fast-png (MIT), no wasm — so it is browser-safe. Kept on its own
+ * key (not the root barrel) purely to avoid touching src/index.ts; the parent
+ * integration can promote diagnosePng to the root if desired since it is pure.
+ */
+export { diagnosePng } from './diagnose.js';
+export { repairPng } from './repair.js';
+export { PNG_SIGNATURE, DEFAULT_PNG_CAPS, walkChunksInMemory, factorizeDimensions, reconstructDimensions, channelsForColorType, isValidColorConfig, bytesPerRow, scanlineStride, unfilterScanlines8, unmangleNewlines, looksNewlineMangled, findSignature, hasSignatureAt, parseIhdr, serializeIhdr, ihdrCrc, } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/png/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/png/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,SAAS,EACT,aAAa,EACb,OAAO,GACR,MAAM,aAAa,CAAC"}

package/dist/png/repair.d.ts

@@ -0,0 +1,31 @@
+import type { ByteSource } from '../byte-source.js';
+import { type PngDamageClass } from './diagnose.js';
+import { type PngSafetyCaps } from './format.js';
+export type PngRepairOutcome = 'success' | 'partial' | 'failed';
+export interface PngRepairReport {
+    outcome: PngRepairOutcome;
+    damageClass: PngDamageClass;
+    /** Surgical actions performed, in order. */
+    actions: string[];
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+    /** Final geometry of the emitted PNG, when one was produced. */
+    width: number | null;
+    height: number | null;
+    /** Rows present in the output image. */
+    rowsRecovered: number | null;
+    /** Rows the original image should have had. */
+    rowsExpected: number | null;
+    /** The emitted PNG re-decodes cleanly with fast-png. */
+    verified: boolean;
+}
+export interface PngRepairOptions {
+    caps?: PngSafetyCaps;
+}
+export interface PngRepairResult {
+    image?: Uint8Array;
+    report: PngRepairReport;
+}
+export declare function repairPng(src: ByteSource, opts?: PngRepairOptions): Promise<PngRepairResult>;
+//# sourceMappingURL=repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/png/repair.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAIL,KAAK,aAAa,EAWnB,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,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wCAAwC;IACxC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;CACzB;AAyHD,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiOlG"}