@intactfile/engines 0.2.0 → 0.3.0

package/dist/office-legacy/diagnose.js

@@ -0,0 +1,111 @@
+import { readAll } from "../bytes-util.js";
+import { MAXREGSECT, buildFat, classifyContainer, findMagic, hasMagicAt, linearScanEntries, magicScore, parseHeader, readDifat, readDirectory, sectOffset, u16, } from "./format.js";
+const SCAN_WINDOW = 64 * 1024;
+const isEncrypted = (names) => names.some((n) => n === "EncryptedPackage" || n === "EncryptionInfo" || /encrypt/i.test(n));
+export function diagnoseOfficeBytes(input) {
+    const notes = [];
+    const base = {
+        notes,
+        majorVersion: null,
+        sectorSize: null,
+        container: null,
+        streamsFound: 0,
+        prefixBytes: 0,
+    };
+    const done = (damageClass, confidence) => ({
+        damageClass,
+        confidence,
+        ...base,
+    });
+    if (input.length < 512) {
+        notes.push(`file is only ${input.length} bytes: too small to be a compound file`);
+        return done("not-cfbf", "high");
+    }
+    // Locate the header.
+    let work = input;
+    let headerDamaged = false;
+    if (!hasMagicAt(input, 0)) {
+        const score = magicScore(input, 0);
+        const at = findMagic(input, SCAN_WINDOW);
+        if (at > 0) {
+            base.prefixBytes = at;
+            work = input.subarray(at);
+            headerDamaged = true;
+            notes.push(`CFBF magic found at offset ${at} (garbage prefix)`);
+        }
+        else if (score >= 5) {
+            headerDamaged = true;
+            notes.push("CFBF signature is partially damaged but recognizable");
+        }
+        else {
+            notes.push("no CFBF signature (D0 CF 11 E0 …) found");
+            return done("not-cfbf", input.length > SCAN_WINDOW ? "medium" : "high");
+        }
+    }
+    const header = parseHeader(work);
+    if (!header) {
+        notes.push("compound-file header is unreadable");
+        return done("header-damage", "medium");
+    }
+    base.majorVersion = header.major;
+    base.sectorSize = header.sectorSize;
+    // Raw-header field sanity (before normalization): a garbled sector shift /
+    // byte order / mini shift that we can deterministically fix.
+    const rawShift = u16(work, 30);
+    const rawByteOrder = u16(work, 28);
+    const rawMiniShift = u16(work, 32);
+    if (rawByteOrder !== 0xfffe || (rawShift !== 9 && rawShift !== 12) || rawMiniShift !== 6) {
+        headerDamaged = true;
+    }
+    const fatSectors = readDifat(work, header);
+    const fat = fatSectors.length ? buildFat(work, header, fatSectors) : null;
+    // Directory via the chain; fall back to a linear scan.
+    let entries = fat ? readDirectory(work, header, fat) : [];
+    let usedScan = false;
+    const streamEntries = (e) => e.filter((x) => (x.type === 1 || x.type === 2) && x.name);
+    if (!entries.some((e) => e.type === 5) || streamEntries(entries).length === 0) {
+        const scanned = linearScanEntries(work, header);
+        if (streamEntries(scanned).length > streamEntries(entries).length) {
+            entries = scanned;
+            usedScan = true;
+        }
+    }
+    const names = streamEntries(entries).map((e) => e.name);
+    base.streamsFound = names.length;
+    base.container = classifyContainer(names);
+    if (isEncrypted(names)) {
+        notes.push("legacy Office encryption detected (EncryptedPackage/EncryptionInfo): recovery needs the password");
+        return done("encrypted", "high");
+    }
+    // Truncation: a real (non-sentinel) directory or FAT sector points past EOF.
+    const dirOff = sectOffset(header.firstDirSector, header.sectorSize);
+    const dirPastEof = header.firstDirSector <= MAXREGSECT && dirOff + header.sectorSize > work.length;
+    const fatPastEof = fatSectors.some((s) => sectOffset(s, header.sectorSize) + header.sectorSize > work.length);
+    if (dirPastEof || fatPastEof) {
+        notes.push("declared FAT/directory sectors extend past end-of-file: the file was cut short");
+        notes.push("data beyond the cut is physically gone; recovery is partial");
+        return done("truncated", "high");
+    }
+    if (!fat || fatSectors.length === 0) {
+        notes.push("FAT/DIFAT is unreadable: sector chains cannot be followed");
+        return done("fat-damage", "high");
+    }
+    if (usedScan) {
+        notes.push("the directory chain/tree is broken; streams are only reachable by a linear scan");
+        return done("directory-damage", "high");
+    }
+    if (headerDamaged) {
+        notes.push("header fields are damaged but the body is intact: deterministically fixable");
+        return done("header-damage", "high");
+    }
+    if (base.streamsFound === 0) {
+        notes.push("no streams could be located");
+        return done("directory-damage", "medium");
+    }
+    notes.push(`compound file OK: ${base.streamsFound} stream(s), container ${base.container}`);
+    return done("none", "high");
+}
+export async function diagnoseOffice(src) {
+    return diagnoseOfficeBytes(await readAll(src));
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/office-legacy/diagnose.js.map

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

package/dist/office-legacy/format.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Pure CFBF / OLE2 (Compound File Binary Format) primitives: header parse,
+ * FAT/DIFAT/MiniFAT walk, 128-byte directory entries, sector→offset math, and
+ * a pointer-free linear directory scan for salvage. No wasm, no compression —
+ * CFBF stores stream bytes raw, so this is all integer/offset arithmetic.
+ *
+ * Backs legacy binary Office: .doc/.xls/.ppt (97–2003), plus .msg/.msi. Repair
+ * scope is the CONTAINER + stream salvage — never the document content inside a
+ * stream. Reference: [MS-CFB]. All fields little-endian.
+ */
+export declare const CFBF_MAGIC: Uint8Array<ArrayBuffer>;
+export declare const MAXREGSECT = 4294967290;
+export declare const DIFSECT = 4294967292;
+export declare const FATSECT = 4294967293;
+export declare const ENDOFCHAIN = 4294967294;
+export declare const FREESECT = 4294967295;
+export declare const NOSTREAM = 4294967295;
+export declare const MINI_CUTOFF = 4096;
+export declare const MINI_SECTOR = 64;
+export declare const DIR_ENTRY = 128;
+export declare const u16: (b: Uint8Array, o: number) => number;
+export declare const u32: (b: Uint8Array, o: number) => number;
+/** 64-bit little-endian as a JS number (v3 uses only the low 32 bits). */
+export declare const u64: (b: Uint8Array, o: number) => number;
+export interface CfbfHeader {
+    major: number;
+    sectorSize: number;
+    miniCutoff: number;
+    numFatSectors: number;
+    firstDirSector: number;
+    firstMiniFatSector: number;
+    numMiniFatSectors: number;
+    firstDifatSector: number;
+    numDifatSectors: number;
+}
+export declare function hasMagicAt(b: Uint8Array, off: number): boolean;
+/** How many of the 8 magic bytes match at `off` (partial-magic heuristic). */
+export declare function magicScore(b: Uint8Array, off: number): number;
+/** First offset of an exact CFBF magic within `window`, or -1. */
+export declare function findMagic(b: Uint8Array, window: number): number;
+/** Parse the 512-byte header. Returns null if the sector shift is implausible. */
+export declare function parseHeader(b: Uint8Array): CfbfHeader | null;
+/** SECT number → absolute file offset. Sector 0 begins one sector past the header. */
+export declare const sectOffset: (sect: number, sectorSize: number) => number;
+/** Collect the FAT-sector numbers from the header DIFAT + any chained DIFAT sectors. */
+export declare function readDifat(b: Uint8Array, header: CfbfHeader): number[];
+/** Build the FAT array from its sectors. Out-of-range sectors read as FREESECT. */
+export declare function buildFat(b: Uint8Array, header: CfbfHeader, fatSectors: number[]): Uint32Array;
+/** Follow a FAT/MiniFAT chain from `start`, with cycle + bound guards. */
+export declare function readChain(fat: Uint32Array, start: number, maxLen: number): number[];
+export interface StreamRead {
+    bytes: Uint8Array;
+    complete: boolean;
+    brokenChain: boolean;
+}
+/** Read a normal (FAT-chained) stream of `size` bytes from `start`. */
+export declare function readBigStream(b: Uint8Array, header: CfbfHeader, fat: Uint32Array, start: number, size: number): StreamRead;
+/** Build the MiniFAT array by reading its sector chain from the FAT. */
+export declare function buildMiniFat(b: Uint8Array, header: CfbfHeader, fat: Uint32Array): Uint32Array;
+/** Read a small (MiniFAT-chained) stream from the mini stream. */
+export declare function readMiniStream(miniStream: Uint8Array, miniFat: Uint32Array, start: number, size: number): StreamRead;
+export interface DirEntry {
+    id: number;
+    name: string;
+    type: number;
+    color: number;
+    left: number;
+    right: number;
+    child: number;
+    startSector: number;
+    size: number;
+    /** byte offset of the raw 128-byte record (for the linear scanner). */
+    recordOffset: number;
+}
+/** Parse one 128-byte directory entry at absolute offset `off`. */
+export declare function parseDirEntry(b: Uint8Array, off: number, id: number): DirEntry | null;
+/** Read the directory entries by following the directory-sector chain. */
+export declare function readDirectory(b: Uint8Array, header: CfbfHeader, fat: Uint32Array): DirEntry[];
+/** True when a 128-byte record looks like a real directory entry. */
+export declare function looksLikeEntry(b: Uint8Array, off: number): boolean;
+/**
+ * Pointer-free salvage: scan the whole file at 128-byte alignment for records
+ * that look like directory entries. Recovers streams when the tree/chain is
+ * destroyed (the CFBF analog of the ZIP local-header scan).
+ */
+export declare function linearScanEntries(b: Uint8Array, header: CfbfHeader): DirEntry[];
+/** Detect the Office document type from the recovered stream names. */
+export declare function classifyContainer(names: string[]): "doc" | "xls" | "ppt" | "msg" | "ole";
+//# sourceMappingURL=format.d.ts.map

package/dist/office-legacy/format.d.ts.map

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

package/dist/office-legacy/format.js

@@ -0,0 +1,281 @@
+/**
+ * Pure CFBF / OLE2 (Compound File Binary Format) primitives: header parse,
+ * FAT/DIFAT/MiniFAT walk, 128-byte directory entries, sector→offset math, and
+ * a pointer-free linear directory scan for salvage. No wasm, no compression —
+ * CFBF stores stream bytes raw, so this is all integer/offset arithmetic.
+ *
+ * Backs legacy binary Office: .doc/.xls/.ppt (97–2003), plus .msg/.msi. Repair
+ * scope is the CONTAINER + stream salvage — never the document content inside a
+ * stream. Reference: [MS-CFB]. All fields little-endian.
+ */
+export const CFBF_MAGIC = Uint8Array.of(0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1);
+export const MAXREGSECT = 0xfffffffa;
+export const DIFSECT = 0xfffffffc;
+export const FATSECT = 0xfffffffd;
+export const ENDOFCHAIN = 0xfffffffe;
+export const FREESECT = 0xffffffff;
+export const NOSTREAM = 0xffffffff;
+export const MINI_CUTOFF = 4096;
+export const MINI_SECTOR = 64;
+export const DIR_ENTRY = 128;
+export const u16 = (b, o) => (b[o] | (b[o + 1] << 8)) >>> 0;
+export const u32 = (b, o) => ((b[o] | (b[o + 1] << 8) | (b[o + 2] << 16) | (b[o + 3] << 24)) >>> 0);
+/** 64-bit little-endian as a JS number (v3 uses only the low 32 bits). */
+export const u64 = (b, o) => u32(b, o) + u32(b, o + 4) * 0x1_0000_0000;
+export function hasMagicAt(b, off) {
+    for (let i = 0; i < 8; i++)
+        if (b[off + i] !== CFBF_MAGIC[i])
+            return false;
+    return true;
+}
+/** How many of the 8 magic bytes match at `off` (partial-magic heuristic). */
+export function magicScore(b, off) {
+    let n = 0;
+    for (let i = 0; i < 8; i++)
+        if (b[off + i] === CFBF_MAGIC[i])
+            n++;
+    return n;
+}
+/** First offset of an exact CFBF magic within `window`, or -1. */
+export function findMagic(b, window) {
+    const limit = Math.min(b.length - 8, window);
+    for (let i = 0; i <= limit; i++)
+        if (b[i] === 0xd0 && hasMagicAt(b, i))
+            return i;
+    return -1;
+}
+/** Parse the 512-byte header. Returns null if the sector shift is implausible. */
+export function parseHeader(b) {
+    if (b.length < 512)
+        return null;
+    const major = u16(b, 26);
+    const sectorShift = u16(b, 30);
+    // Normalize: sector shift is derivable from the major version if garbled.
+    const shift = sectorShift === 9 || sectorShift === 12 ? sectorShift : major === 4 ? 12 : 9;
+    const sectorSize = 1 << shift;
+    return {
+        major: major === 3 || major === 4 ? major : sectorSize === 4096 ? 4 : 3,
+        sectorSize,
+        miniCutoff: u32(b, 56) || MINI_CUTOFF,
+        numFatSectors: u32(b, 44),
+        firstDirSector: u32(b, 48),
+        firstMiniFatSector: u32(b, 60),
+        numMiniFatSectors: u32(b, 64),
+        firstDifatSector: u32(b, 68),
+        numDifatSectors: u32(b, 72),
+    };
+}
+/** SECT number → absolute file offset. Sector 0 begins one sector past the header. */
+export const sectOffset = (sect, sectorSize) => (sect + 1) * sectorSize;
+/** Collect the FAT-sector numbers from the header DIFAT + any chained DIFAT sectors. */
+export function readDifat(b, header) {
+    const { sectorSize } = header;
+    const fatSectors = [];
+    for (let i = 0; i < 109; i++) {
+        const s = u32(b, 76 + i * 4);
+        if (s <= MAXREGSECT)
+            fatSectors.push(s);
+    }
+    // chained DIFAT sectors: 127 FAT-sector numbers + a "next DIFAT" link each
+    let difat = header.firstDifatSector;
+    const seen = new Set();
+    const perSector = sectorSize / 4;
+    while (difat <= MAXREGSECT && !seen.has(difat)) {
+        seen.add(difat);
+        const base = sectOffset(difat, sectorSize);
+        if (base + sectorSize > b.length)
+            break;
+        for (let i = 0; i < perSector - 1; i++) {
+            const s = u32(b, base + i * 4);
+            if (s <= MAXREGSECT)
+                fatSectors.push(s);
+        }
+        difat = u32(b, base + (perSector - 1) * 4);
+    }
+    return fatSectors;
+}
+/** Build the FAT array from its sectors. Out-of-range sectors read as FREESECT. */
+export function buildFat(b, header, fatSectors) {
+    const { sectorSize } = header;
+    const perSector = sectorSize / 4;
+    const fat = new Uint32Array(fatSectors.length * perSector).fill(FREESECT);
+    let w = 0;
+    for (const s of fatSectors) {
+        const base = sectOffset(s, sectorSize);
+        for (let i = 0; i < perSector; i++) {
+            fat[w++] = base + i * 4 + 4 <= b.length ? u32(b, base + i * 4) : FREESECT;
+        }
+    }
+    return fat;
+}
+/** Follow a FAT/MiniFAT chain from `start`, with cycle + bound guards. */
+export function readChain(fat, start, maxLen) {
+    const out = [];
+    const seen = new Set();
+    let s = start;
+    while (s <= MAXREGSECT && s < fat.length && !seen.has(s) && out.length <= maxLen) {
+        out.push(s);
+        seen.add(s);
+        s = fat[s];
+    }
+    return out;
+}
+/** Read a normal (FAT-chained) stream of `size` bytes from `start`. */
+export function readBigStream(b, header, fat, start, size) {
+    const { sectorSize } = header;
+    const need = Math.ceil(size / sectorSize);
+    const chain = readChain(fat, start, need + 4);
+    const out = new Uint8Array(size);
+    let written = 0;
+    let brokenChain = chain.length < need;
+    for (const s of chain) {
+        if (written >= size)
+            break;
+        const base = sectOffset(s, sectorSize);
+        const take = Math.min(sectorSize, size - written);
+        if (base + take > b.length) {
+            brokenChain = true;
+            break;
+        }
+        out.set(b.subarray(base, base + take), written);
+        written += take;
+    }
+    return { bytes: out.subarray(0, written), complete: written >= size, brokenChain };
+}
+/** Build the MiniFAT array by reading its sector chain from the FAT. */
+export function buildMiniFat(b, header, fat) {
+    const chain = readChain(fat, header.firstMiniFatSector, 1 << 20);
+    const perSector = header.sectorSize / 4;
+    const mf = new Uint32Array(chain.length * perSector).fill(FREESECT);
+    let w = 0;
+    for (const s of chain) {
+        const base = sectOffset(s, header.sectorSize);
+        for (let i = 0; i < perSector; i++) {
+            mf[w++] = base + i * 4 + 4 <= b.length ? u32(b, base + i * 4) : FREESECT;
+        }
+    }
+    return mf;
+}
+/** Read a small (MiniFAT-chained) stream from the mini stream. */
+export function readMiniStream(miniStream, miniFat, start, size) {
+    const need = Math.ceil(size / MINI_SECTOR);
+    const chain = readChain(miniFat, start, need + 4);
+    const out = new Uint8Array(size);
+    let written = 0;
+    let brokenChain = chain.length < need;
+    for (const s of chain) {
+        if (written >= size)
+            break;
+        const base = s * MINI_SECTOR;
+        const take = Math.min(MINI_SECTOR, size - written);
+        if (base + take > miniStream.length) {
+            brokenChain = true;
+            break;
+        }
+        out.set(miniStream.subarray(base, base + take), written);
+        written += take;
+    }
+    return { bytes: out.subarray(0, written), complete: written >= size, brokenChain };
+}
+function decodeName(b, off, nameLenBytes) {
+    if (nameLenBytes < 2 || nameLenBytes > 64)
+        return "";
+    let s = "";
+    for (let i = 0; i + 2 <= nameLenBytes; i += 2) {
+        const c = u16(b, off + i);
+        if (c === 0)
+            break;
+        s += String.fromCharCode(c);
+    }
+    return s;
+}
+/** Parse one 128-byte directory entry at absolute offset `off`. */
+export function parseDirEntry(b, off, id) {
+    if (off + DIR_ENTRY > b.length)
+        return null;
+    const type = b[off + 66];
+    const nameLen = u16(b, off + 64);
+    return {
+        id,
+        name: decodeName(b, off, nameLen),
+        type,
+        color: b[off + 67],
+        left: u32(b, off + 68),
+        right: u32(b, off + 72),
+        child: u32(b, off + 76),
+        startSector: u32(b, off + 116),
+        size: u64(b, off + 120),
+        recordOffset: off,
+    };
+}
+/** Read the directory entries by following the directory-sector chain. */
+export function readDirectory(b, header, fat) {
+    const { sectorSize } = header;
+    const perSector = sectorSize / DIR_ENTRY;
+    const chain = readChain(fat, header.firstDirSector, 1 << 20);
+    const entries = [];
+    let id = 0;
+    for (const s of chain) {
+        const base = sectOffset(s, sectorSize);
+        for (let i = 0; i < perSector; i++) {
+            const e = parseDirEntry(b, base + i * DIR_ENTRY, id++);
+            if (e)
+                entries.push(e);
+        }
+    }
+    return entries;
+}
+/** True when a 128-byte record looks like a real directory entry. */
+export function looksLikeEntry(b, off) {
+    const type = b[off + 66];
+    if (type !== 1 && type !== 2 && type !== 5)
+        return false;
+    const nameLen = u16(b, off + 64);
+    if (nameLen < 2 || nameLen > 64 || nameLen % 2 !== 0)
+        return false;
+    // name must be NUL-terminated UTF-16 within nameLen and start with a printable-ish unit
+    const first = u16(b, off);
+    if (first === 0 || first > 0xffff)
+        return false;
+    if (u16(b, off + nameLen - 2) !== 0)
+        return false;
+    return true;
+}
+/**
+ * Pointer-free salvage: scan the whole file at 128-byte alignment for records
+ * that look like directory entries. Recovers streams when the tree/chain is
+ * destroyed (the CFBF analog of the ZIP local-header scan).
+ */
+export function linearScanEntries(b, header) {
+    const out = [];
+    const start = header.sectorSize; // skip the header sector
+    let id = 0;
+    const seen = new Set();
+    for (let off = start; off + DIR_ENTRY <= b.length; off += DIR_ENTRY) {
+        if (!looksLikeEntry(b, off))
+            continue;
+        const e = parseDirEntry(b, off, id);
+        if (!e || !e.name)
+            continue;
+        const key = `${e.name}:${e.startSector}:${e.size}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        e.id = id++;
+        out.push(e);
+    }
+    return out;
+}
+/** Detect the Office document type from the recovered stream names. */
+export function classifyContainer(names) {
+    if (names.includes("WordDocument"))
+        return "doc";
+    if (names.includes("Workbook") || names.includes("Book"))
+        return "xls";
+    if (names.includes("PowerPoint Document"))
+        return "ppt";
+    if (names.some((n) => n === "__properties_version1.0" || /__recip_version/.test(n) || n === "__nameid_version1.0"))
+        return "msg";
+    return "ole";
+}
+//# sourceMappingURL=format.js.map

package/dist/office-legacy/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/office-legacy/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAC;AAClC,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;AACrC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAa,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAa,EAAE,CAAS,EAAU,EAAE,CACtD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAa,EAAE,CAAS,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC;AAcnG,MAAM,UAAU,UAAU,CAAC,CAAa,EAAE,GAAW;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC3E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,CAAa,EAAE,GAAW;IACnD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC;YAAE,CAAC,EAAE,CAAC;IAClE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,SAAS,CAAC,CAAa,EAAE,MAAc;IACrD,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;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACjF,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,CAAa;IACvC,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzB,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,0EAA0E;IAC1E,MAAM,KAAK,GAAG,WAAW,KAAK,CAAC,IAAI,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,MAAM,UAAU,GAAG,CAAC,IAAI,KAAK,CAAC;IAC9B,OAAO;QACL,KAAK,EAAE,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,UAAU;QACV,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,WAAW;QACrC,aAAa,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;QACzB,cAAc,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1B,kBAAkB,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;QAC9B,iBAAiB,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,gBAAgB,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5B,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,UAAkB,EAAU,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC;AAEhG,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,CAAa,EAAE,MAAkB;IACzD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,UAAU;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,2EAA2E;IAC3E,IAAI,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,SAAS,GAAG,UAAU,GAAG,CAAC,CAAC;IACjC,OAAO,KAAK,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,IAAI,GAAG,UAAU,GAAG,CAAC,CAAC,MAAM;YAAE,MAAM;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,UAAU;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,CAAa,EAAE,MAAkB,EAAE,UAAoB;IAC9E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC9B,MAAM,SAAS,GAAG,UAAU,GAAG,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1E,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,SAAS,CAAC,GAAgB,EAAE,KAAa,EAAE,MAAc;IACvE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,OAAO,CAAC,IAAI,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACjF,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAQD,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,MAAkB,EAAE,GAAgB,EAAE,KAAa,EAAE,IAAY;IAC5G,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,OAAO,IAAI,IAAI;YAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;QAClD,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YAAC,WAAW,GAAG,IAAI,CAAC;YAAC,MAAM;QAAC,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;AACrF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,CAAa,EAAE,MAAkB,EAAE,GAAgB;IAC9E,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpE,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,UAAsB,EAAE,OAAoB,EAAE,KAAa,EAAE,IAAY;IACtG,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,OAAO,IAAI,IAAI;YAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,CAAC,GAAG,WAAW,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;QACnD,IAAI,IAAI,GAAG,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;YAAC,WAAW,GAAG,IAAI,CAAC;YAAC,MAAM;QAAC,CAAC;QACnE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;AACrF,CAAC;AAgBD,SAAS,UAAU,CAAC,CAAa,EAAE,GAAW,EAAE,YAAoB;IAClE,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM;QACnB,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,GAAW,EAAE,EAAU;IAClE,IAAI,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,CAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACjC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC;QACjC,IAAI;QACJ,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAE;QACnB,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QACtB,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QACvB,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QACvB,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;QAC9B,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;QACvB,YAAY,EAAE,GAAG;KAClB,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,MAAkB,EAAE,GAAgB;IAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC9B,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,CAAa,EAAE,GAAW;IACvD,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,CAAE,CAAC;IAC1B,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,EAAE,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnE,wFAAwF;IACxF,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,GAAG,MAAM;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAa,EAAE,MAAkB;IACjE,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,yBAAyB;IAC1D,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,IAAI,GAAG,GAAG,KAAK,EAAE,GAAG,GAAG,SAAS,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,SAAS,EAAE,CAAC;QACpE,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC;YAAE,SAAS;QACtC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,SAAS;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,KAAK,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,yBAAyB,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,qBAAqB,CAAC;QAChH,OAAO,KAAK,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/office-legacy/index.d.ts

@@ -0,0 +1,9 @@
+export declare const repairOffice: (src: import("../byte-source.js").ByteSource) => Promise<import("./repair.js").OfficeRepairResult>;
+export { repairOfficeBytes } from "./repair.js";
+export type { OfficeRepairOutcome, OfficeRepairStrategy, OfficeRepairReport, OfficeRepairResult, RecoveredStream, } from "./repair.js";
+export { diagnoseOffice, diagnoseOfficeBytes } from "./diagnose.js";
+export type { OfficeDiagnosis, OfficeDamageClass } from "./diagnose.js";
+export { writeCfbf } from "./rebuild.js";
+export { CFBF_MAGIC, parseHeader, readDifat, buildFat, readDirectory, linearScanEntries, classifyContainer, } from "./format.js";
+export type { CfbfHeader, DirEntry } from "./format.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/office-legacy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/office-legacy/index.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,YAAY,oGAAsB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/office-legacy/index.js

@@ -0,0 +1,18 @@
+/**
+ * Legacy Office (CFBF / OLE2) engine subpath export
+ * (`@intactfile/engines/office-legacy`). Pure TypeScript, no wasm — CFBF stores
+ * streams raw, so parsing and the canonical rebuild are plain byte arithmetic.
+ *
+ * Scope: container + stream salvage for .doc/.xls/.ppt (97–2003) and .msg. It
+ * recovers the streams and rebuilds a valid compound file; it does NOT repair
+ * the document content (BIFF/FIB) inside a stream. diagnoseOffice is pure and
+ * promoted to the root barrel; repairOffice stays here and is gated.
+ */
+import { gate } from "../license.js";
+import { repairOffice as _repairOffice } from "./repair.js";
+export const repairOffice = gate(_repairOffice);
+export { repairOfficeBytes } from "./repair.js";
+export { diagnoseOffice, diagnoseOfficeBytes } from "./diagnose.js";
+export { writeCfbf } from "./rebuild.js";
+export { CFBF_MAGIC, parseHeader, readDifat, buildFat, readDirectory, linearScanEntries, classifyContainer, } from "./format.js";
+//# sourceMappingURL=index.js.map

package/dist/office-legacy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/office-legacy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/office-legacy/rebuild.d.ts

@@ -0,0 +1,8 @@
+export interface OutStream {
+    name: string;
+    bytes: Uint8Array;
+}
+/** True if a rebuild would need more than the 109 inline DIFAT slots. */
+export declare function rebuildExceedsLimit(streams: OutStream[]): boolean;
+export declare function writeCfbf(streams: OutStream[]): Uint8Array;
+//# sourceMappingURL=rebuild.d.ts.map

package/dist/office-legacy/rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild.d.ts","sourceRoot":"","sources":["../../src/office-legacy/rebuild.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;CACnB;AAeD,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAejE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,CAmK1D"}