@intactfile/engines 0.2.0 → 0.3.0

package/dist/office-legacy/rebuild.js

@@ -0,0 +1,234 @@
+/**
+ * Pure-TS canonical CFBF (v3, 512-byte sectors) writer. Given a flat set of
+ * recovered streams it emits a fresh, structurally-valid compound file:
+ * header + FAT + DIFAT(inline) + directory + MiniFAT + mini stream + big
+ * streams. Deterministic output. No wasm.
+ *
+ * v1 limit: ≤ 109 FAT sectors (~7 MB of addressable sectors), which covers
+ * legacy Office files comfortably; larger inputs are reported without a rebuild.
+ */
+import { CFBF_MAGIC, DIR_ENTRY, ENDOFCHAIN, FATSECT, FREESECT, MINI_CUTOFF, MINI_SECTOR, NOSTREAM, } from "./format.js";
+const SS = 512; // sector size (v3)
+const PER_FAT = SS / 4; // 128 entries per FAT sector
+const PER_DIR = SS / DIR_ENTRY; // 4 entries per directory sector
+const wU16 = (b, o, v) => { b[o] = v & 0xff; b[o + 1] = (v >>> 8) & 0xff; };
+const wU32 = (b, o, v) => {
+    b[o] = v & 0xff;
+    b[o + 1] = (v >>> 8) & 0xff;
+    b[o + 2] = (v >>> 16) & 0xff;
+    b[o + 3] = (v >>> 24) & 0xff;
+};
+/** CFBF sibling collation: shorter names first, then by uppercased UTF-16. */
+function compareNames(a, b) {
+    if (a.length !== b.length)
+        return a.length - b.length;
+    const ua = a.toUpperCase();
+    const ub = b.toUpperCase();
+    return ua < ub ? -1 : ua > ub ? 1 : 0;
+}
+/** True if a rebuild would need more than the 109 inline DIFAT slots. */
+export function rebuildExceedsLimit(streams) {
+    let dataSectors = 0;
+    let miniBytes = 0;
+    for (const s of streams) {
+        if (s.bytes.length === 0)
+            continue;
+        if (s.bytes.length < MINI_CUTOFF)
+            miniBytes += Math.ceil(s.bytes.length / MINI_SECTOR) * MINI_SECTOR;
+        else
+            dataSectors += Math.ceil(s.bytes.length / SS);
+    }
+    const S = Math.ceil(miniBytes / SS);
+    const M = Math.ceil(Math.ceil(miniBytes / MINI_SECTOR) * 4 / SS);
+    const D = Math.ceil((1 + streams.length) * DIR_ENTRY / SS);
+    const base = D + M + S + dataSectors;
+    let F = 1;
+    for (let i = 0; i < 8; i++) {
+        const n = base + F;
+        const f2 = Math.max(1, Math.ceil(n / PER_FAT));
+        if (f2 === F)
+            break;
+        F = f2;
+    }
+    return F > 109;
+}
+export function writeCfbf(streams) {
+    // 1. Mini stream: pack small streams (< 4096 B), each padded to 64 B.
+    const small = streams.filter((s) => s.bytes.length > 0 && s.bytes.length < MINI_CUTOFF);
+    const big = streams.filter((s) => s.bytes.length >= MINI_CUTOFF);
+    const empty = streams.filter((s) => s.bytes.length === 0);
+    const miniStartOf = new Map();
+    let miniSectors = 0;
+    for (const s of small) {
+        miniStartOf.set(s, miniSectors);
+        miniSectors += Math.ceil(s.bytes.length / MINI_SECTOR);
+    }
+    const miniStreamLen = miniSectors * MINI_SECTOR;
+    const miniStream = new Uint8Array(miniStreamLen);
+    for (const s of small) {
+        miniStream.set(s.bytes, miniStartOf.get(s) * MINI_SECTOR);
+    }
+    // 2. Sector counts.
+    const D = Math.max(1, Math.ceil((1 + streams.length) * DIR_ENTRY / SS));
+    const miniFatEntries = miniSectors;
+    const M = Math.ceil((miniFatEntries * 4) / SS);
+    const S = Math.ceil(miniStreamLen / SS);
+    const bigRun = new Map();
+    let bigTotal = 0;
+    for (const s of big)
+        bigTotal += Math.ceil(s.bytes.length / SS);
+    const dataSectors = D + M + S + bigTotal;
+    let F = 1;
+    for (let i = 0; i < 16; i++) {
+        const n = dataSectors + F;
+        const f2 = Math.max(1, Math.ceil(n / PER_FAT));
+        if (f2 === F)
+            break;
+        F = f2;
+    }
+    const total = dataSectors + F;
+    // 3. Sector index assignment.
+    const dirStart = 0;
+    const miniFatStart = D;
+    const miniStreamStart = D + M;
+    let cursor = D + M + S;
+    for (const s of big) {
+        const sectors = Math.ceil(s.bytes.length / SS);
+        bigRun.set(s, { start: cursor, sectors });
+        cursor += sectors;
+    }
+    const fatStart = dataSectors;
+    // 4. FAT.
+    const fat = new Uint32Array(total).fill(FREESECT);
+    const chainRange = (a, count) => {
+        for (let i = 0; i < count; i++)
+            fat[a + i] = i === count - 1 ? ENDOFCHAIN : a + i + 1;
+    };
+    if (D > 0)
+        chainRange(dirStart, D);
+    if (M > 0)
+        chainRange(miniFatStart, M);
+    if (S > 0)
+        chainRange(miniStreamStart, S);
+    for (const s of big) {
+        const r = bigRun.get(s);
+        chainRange(r.start, r.sectors);
+    }
+    for (let i = fatStart; i < total; i++)
+        fat[i] = FATSECT;
+    // 5. MiniFAT (chain each small stream's mini-sectors).
+    const miniFat = new Uint32Array(M * PER_FAT).fill(FREESECT);
+    for (const s of small) {
+        const start = miniStartOf.get(s);
+        const n = Math.ceil(s.bytes.length / MINI_SECTOR);
+        for (let i = 0; i < n; i++)
+            miniFat[start + i] = i === n - 1 ? ENDOFCHAIN : start + i + 1;
+    }
+    // 6. Directory entries (Root + one per stream, siblings in a balanced BST).
+    const sorted = [...streams].sort((a, z) => compareNames(a.name, z.name));
+    const idOf = new Map();
+    sorted.forEach((s, i) => idOf.set(s, i + 1)); // 0 = Root
+    const left = new Array(streams.length + 1).fill(NOSTREAM);
+    const right = new Array(streams.length + 1).fill(NOSTREAM);
+    const buildTree = (lo, hi) => {
+        if (lo > hi)
+            return NOSTREAM;
+        const mid = (lo + hi) >> 1;
+        const id = mid + 1;
+        left[id] = buildTree(lo, mid - 1);
+        right[id] = buildTree(mid + 1, hi);
+        return id;
+    };
+    const rootChild = buildTree(0, sorted.length - 1);
+    const dir = new Uint8Array(D * SS);
+    // fill unused slots as free entries
+    for (let i = 0; i < D * PER_DIR; i++) {
+        const o = i * DIR_ENTRY;
+        wU32(dir, o + 68, NOSTREAM);
+        wU32(dir, o + 72, NOSTREAM);
+        wU32(dir, o + 76, NOSTREAM);
+    }
+    const writeEntry = (id, name, type, startSector, size, child) => {
+        const o = id * DIR_ENTRY;
+        const nm = name.length > 31 ? name.slice(0, 31) : name;
+        for (let i = 0; i < nm.length; i++)
+            wU16(dir, o + i * 2, nm.charCodeAt(i));
+        const nameLen = (nm.length + 1) * 2; // incl. NUL terminator
+        wU16(dir, o + 64, nameLen);
+        dir[o + 66] = type;
+        dir[o + 67] = 1; // black
+        wU32(dir, o + 68, left[id] ?? NOSTREAM);
+        wU32(dir, o + 72, right[id] ?? NOSTREAM);
+        wU32(dir, o + 76, child);
+        wU32(dir, o + 116, startSector);
+        wU32(dir, o + 120, size >>> 0);
+        wU32(dir, o + 124, Math.floor(size / 0x1_0000_0000));
+    };
+    // Root Entry
+    writeEntry(0, "Root Entry", 5, S > 0 ? miniStreamStart : ENDOFCHAIN, miniStreamLen, rootChild);
+    left[0] = NOSTREAM;
+    right[0] = NOSTREAM;
+    wU32(dir, 68, NOSTREAM);
+    wU32(dir, 72, NOSTREAM);
+    wU32(dir, 76, rootChild);
+    for (const s of streams) {
+        const id = idOf.get(s);
+        let start;
+        if (s.bytes.length === 0)
+            start = ENDOFCHAIN;
+        else if (s.bytes.length < MINI_CUTOFF)
+            start = miniStartOf.get(s);
+        else
+            start = bigRun.get(s).start;
+        writeEntry(id, s.name, 2, start, s.bytes.length, NOSTREAM);
+    }
+    void empty;
+    // 7. Assemble the file.
+    const file = new Uint8Array(SS + total * SS);
+    // header
+    file.set(CFBF_MAGIC, 0);
+    wU16(file, 24, 0x3e); // minor version
+    wU16(file, 26, 3); // major version (v3)
+    wU16(file, 28, 0xfffe); // byte order
+    wU16(file, 30, 9); // sector shift
+    wU16(file, 32, 6); // mini sector shift
+    wU32(file, 40, 0); // # dir sectors (0 for v3)
+    wU32(file, 44, F); // # FAT sectors
+    wU32(file, 48, dirStart); // first dir sector
+    wU32(file, 56, MINI_CUTOFF); // mini stream cutoff
+    wU32(file, 60, M > 0 ? miniFatStart : ENDOFCHAIN); // first MiniFAT sector
+    wU32(file, 64, M); // # MiniFAT sectors
+    wU32(file, 68, ENDOFCHAIN); // first DIFAT sector (≤109 FAT sectors → none)
+    wU32(file, 72, 0); // # DIFAT sectors
+    for (let i = 0; i < 109; i++)
+        wU32(file, 76 + i * 4, i < F ? fatStart + i : FREESECT);
+    const put = (sect, bytes) => { file.set(bytes, (sect + 1) * SS); };
+    put(dirStart, dir);
+    // MiniFAT
+    if (M > 0) {
+        const mf = new Uint8Array(M * SS);
+        for (let i = 0; i < miniFat.length; i++)
+            wU32(mf, i * 4, miniFat[i]);
+        put(miniFatStart, mf);
+    }
+    // mini stream
+    if (S > 0) {
+        const ms = new Uint8Array(S * SS);
+        ms.set(miniStream, 0);
+        put(miniStreamStart, ms);
+    }
+    // big streams
+    for (const s of big) {
+        const r = bigRun.get(s);
+        const buf = new Uint8Array(r.sectors * SS);
+        buf.set(s.bytes, 0);
+        put(r.start, buf);
+    }
+    // FAT sectors
+    const fatBuf = new Uint8Array(F * SS).fill(0xff); // FREESECT padding
+    for (let i = 0; i < fat.length; i++)
+        wU32(fatBuf, i * 4, fat[i]);
+    put(fatStart, fatBuf);
+    return file;
+}
+//# sourceMappingURL=rebuild.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * Legacy Office (CFBF/OLE2) repair: header normalization → FAT/DIFAT build →
+ * directory walk (with a pointer-free linear-scan fallback) → stream extraction
+ * (FAT + MiniFAT chains, with a contiguity fallback) → pure-TS rebuild of a
+ * canonical v3 compound file. No wasm.
+ *
+ * Honesty rule (docs/03): we rebuild the CONTAINER and recover its streams. If
+ * the damage is inside a stream's document content (BIFF/FIB), the file may
+ * still not fully open — the caveats say so. `outcome` is never "success" when a
+ * stream came back partial.
+ */
+import type { ByteSource } from "../byte-source.js";
+import { type OfficeDamageClass } from "./diagnose.js";
+export type OfficeRepairOutcome = "success" | "partial" | "failed";
+export type OfficeRepairStrategy = "tree-walk" | "linear-scan" | "contiguity-fallback" | null;
+export interface RecoveredStream {
+    name: string;
+    size: number;
+    bytesRecovered: number;
+    complete: boolean;
+    viaLinearScan: boolean;
+}
+export interface OfficeRepairReport {
+    outcome: OfficeRepairOutcome;
+    damageClass: OfficeDamageClass;
+    container: "doc" | "xls" | "ppt" | "msg" | "ole" | null;
+    strategy: OfficeRepairStrategy;
+    streams: RecoveredStream[];
+    caveats: string[];
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+}
+export interface OfficeRepairResult {
+    file?: Uint8Array;
+    report: OfficeRepairReport;
+}
+export declare function repairOfficeBytes(input: Uint8Array): OfficeRepairResult;
+export declare function repairOffice(src: ByteSource): Promise<OfficeRepairResult>;
+//# sourceMappingURL=repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/office-legacy/repair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAoB5E,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACnE,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,aAAa,GAAG,qBAAqB,GAAG,IAAI,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IACxD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAYD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAqJvE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE/E"}

package/dist/office-legacy/repair.js

@@ -0,0 +1,161 @@
+import { readAll } from "../bytes-util.js";
+import { diagnoseOfficeBytes } from "./diagnose.js";
+import { MAXREGSECT, buildFat, buildMiniFat, classifyContainer, findMagic, hasMagicAt, linearScanEntries, parseHeader, readBigStream, readDifat, readDirectory, readMiniStream, sectOffset, } from "./format.js";
+import { rebuildExceedsLimit, writeCfbf } from "./rebuild.js";
+const CONTAINER_CAVEAT = "Container repaired; recovered streams do not guarantee the document opens — content inside a stream may still be damaged.";
+/** Read `size` bytes sequentially from a start sector, ignoring the FAT chain. */
+function contiguousRead(work, header, start, size) {
+    if (start > MAXREGSECT)
+        return new Uint8Array(0);
+    const off = sectOffset(start, header.sectorSize);
+    return work.subarray(off, Math.min(off + size, work.length));
+}
+export function repairOfficeBytes(input) {
+    const diag = diagnoseOfficeBytes(input);
+    const notes = [...diag.notes];
+    const caveats = [];
+    const fail = () => ({
+        report: {
+            outcome: "failed",
+            damageClass: diag.damageClass,
+            container: diag.container,
+            strategy: null,
+            streams: [],
+            caveats,
+            notes,
+            bytesIn: input.length,
+            bytesOut: 0,
+        },
+    });
+    if (diag.damageClass === "not-cfbf") {
+        notes.push("input is not a compound file; nothing to repair");
+        return fail();
+    }
+    if (diag.damageClass === "encrypted") {
+        notes.push("the file is encrypted; recovery requires the password and is declined");
+        return fail();
+    }
+    // Strip a garbage prefix so the header sits at offset 0.
+    let work = input;
+    if (!hasMagicAt(input, 0)) {
+        const at = findMagic(input, 64 * 1024);
+        if (at > 0) {
+            work = input.slice(at);
+            notes.push(`stripped ${at} garbage byte(s) before the CFBF signature`);
+        }
+    }
+    const header = parseHeader(work);
+    if (!header)
+        return fail();
+    const fatSectors = readDifat(work, header);
+    const fat = fatSectors.length ? buildFat(work, header, fatSectors) : new Uint32Array(0);
+    // Directory: chain walk, else pointer-free linear scan.
+    let entries = fat.length ? readDirectory(work, header, fat) : [];
+    let strategy = "tree-walk";
+    const streamsOf = (e) => e.filter((x) => x.type === 2 && x.name && x.name !== "Root Entry");
+    let root = entries.find((e) => e.type === 5);
+    if (!root || streamsOf(entries).length === 0) {
+        const scanned = linearScanEntries(work, header);
+        if (streamsOf(scanned).length > streamsOf(entries).length) {
+            entries = scanned;
+            strategy = "linear-scan";
+            root = scanned.find((e) => e.type === 5) ?? root;
+        }
+    }
+    const streamEntries = streamsOf(entries);
+    if (streamEntries.length === 0) {
+        notes.push("no streams could be recovered from the directory or a linear scan");
+        return fail();
+    }
+    // Mini stream (from Root) + MiniFAT for small streams.
+    let miniStream = new Uint8Array(0);
+    let miniFat = new Uint32Array(0);
+    if (root && root.size > 0 && fat.length) {
+        miniStream = readBigStream(work, header, fat, root.startSector, root.size).bytes;
+        miniFat = buildMiniFat(work, header, fat);
+    }
+    const recovered = [];
+    const out = [];
+    let anyPartial = false;
+    let usedContiguity = false;
+    for (const e of streamEntries) {
+        let bytes;
+        let complete;
+        if (e.size === 0) {
+            bytes = new Uint8Array(0);
+            complete = true;
+        }
+        else if (e.size < header.miniCutoff) {
+            const r = readMiniStream(miniStream, miniFat, e.startSector, e.size);
+            bytes = r.bytes;
+            complete = r.complete;
+        }
+        else {
+            const r = fat.length
+                ? readBigStream(work, header, fat, e.startSector, e.size)
+                : { bytes: new Uint8Array(0), complete: false, brokenChain: true };
+            bytes = r.bytes;
+            complete = r.complete;
+            if (!complete) {
+                // contiguity fallback: assume the stream was laid out sequentially.
+                const cont = contiguousRead(work, header, e.startSector, e.size);
+                if (cont.length > bytes.length) {
+                    bytes = cont;
+                    complete = cont.length >= e.size;
+                    usedContiguity = true;
+                }
+            }
+        }
+        if (!complete)
+            anyPartial = true;
+        recovered.push({
+            name: e.name,
+            size: e.size,
+            bytesRecovered: bytes.length,
+            complete,
+            viaLinearScan: strategy === "linear-scan",
+        });
+        out.push({ name: e.name, bytes });
+    }
+    // Rebuild a canonical container from the recovered streams.
+    let file;
+    if (rebuildExceedsLimit(out)) {
+        notes.push("recovered data exceeds the v1 rebuild limit (109 FAT sectors); streams recovered but not repackaged");
+    }
+    else {
+        file = writeCfbf(out);
+    }
+    const container = classifyContainer(streamEntries.map((e) => e.name));
+    let outcome;
+    if (!file)
+        outcome = "partial";
+    else if (anyPartial)
+        outcome = "partial";
+    else
+        outcome = "success";
+    caveats.push(CONTAINER_CAVEAT);
+    if (diag.damageClass === "truncated")
+        caveats.push("The file was cut short; data beyond the cut is physically gone.");
+    if (usedContiguity) {
+        strategy = "contiguity-fallback";
+        caveats.push("Some stream data was reassembled by assuming original on-disk order; verify against a known-good copy.");
+    }
+    return {
+        file,
+        report: {
+            outcome,
+            damageClass: diag.damageClass,
+            container,
+            strategy,
+            streams: recovered,
+            caveats,
+            notes,
+            bytesIn: input.length,
+            bytesOut: file?.length ?? 0,
+        },
+    };
+}
+export async function repairOffice(src) {
+    return repairOfficeBytes(await readAll(src));
+}
+//# sourceMappingURL=repair.js.map

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

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

package/dist/psd/diagnose.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PSD/PSB structural diagnosis via pure own parsing — no wasm, no pixel decode
+ * in this chain, so it is safe in the browser-facing root export.
+ *
+ * It validates the signature (incl. garbage prefix), the 26-byte header, then
+ * the four length-prefixed sections by BOUNDARY MATH only (never decoding the
+ * composite). Honesty rule: name the on-disk problem; never claim the layer
+ * stack is recoverable — a repaired PSD is the flattened composite.
+ */
+import type { ByteSource } from "../byte-source.js";
+import type { Confidence } from "../types.js";
+import { type PsdSafetyCaps } from "./format.js";
+export type PsdDamageClass = "none" | "signature-damage" | "header-damage" | "bad-section-length" | "truncated" | "composite-corruption" | "layers-damaged" | "thumbnail-only" | "garbage-prefix" | "not-psd" | "unknown";
+export interface PsdDiagnosis {
+    damageClass: PsdDamageClass;
+    confidence: Confidence;
+    notes: string[];
+    /** Offset of a valid 8BPS signature (0 normally, >0 = garbage prefix, null = none). */
+    signatureOffset: number | null;
+    version: 1 | 2 | null;
+    width: number | null;
+    height: number | null;
+    channels: number | null;
+    depth: number | null;
+    colorMode: number | null;
+    /** Compression flag of the image-data (composite) section, when readable. */
+    compression: number | null;
+    hasThumbnail: boolean;
+    prefixBytes: number;
+}
+export declare function diagnosePsdBytes(b: Uint8Array, caps?: PsdSafetyCaps): PsdDiagnosis;
+export declare function diagnosePsd(src: ByteSource, caps?: PsdSafetyCaps): Promise<PsdDiagnosis>;
+//# sourceMappingURL=diagnose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/psd/diagnose.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAGL,KAAK,aAAa,EAWnB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,WAAW,GACX,sBAAsB,GACtB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,cAAc,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uFAAuF;IACvF,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACtB,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,6EAA6E;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,GAAE,aAAgC,GAAG,YAAY,CAuKpG;AAaD,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,GAAE,aAAgC,GAAG,OAAO,CAAC,YAAY,CAAC,CAEhH"}