@intactfile/engines 0.1.0

package/dist/zip/format.js

@@ -0,0 +1,129 @@
+export const SIG_LFH = 0x04034b50; // PK\x03\x04
+export const SIG_CDH = 0x02014b50; // PK\x01\x02
+export const SIG_EOCD = 0x06054b50; // PK\x05\x06
+export const SIG_DD = 0x08074b50; // PK\x07\x08
+export const SIG_EOCD64 = 0x06064b50; // PK\x06\x06
+export const SIG_EOCD64_LOC = 0x07064b50; // PK\x06\x07
+export const LFH_FIXED_SIZE = 30;
+export const CDH_FIXED_SIZE = 46;
+export const EOCD_FIXED_SIZE = 22;
+export const MAX_COMMENT = 0xffff;
+export const FLAG_ENCRYPTED = 0x0001;
+export const FLAG_DATA_DESCRIPTOR = 0x0008;
+export const FLAG_UTF8 = 0x0800;
+export const METHOD_STORE = 0;
+export const METHOD_DEFLATE = 8;
+export const U32_MAX = 0xffffffff;
+export const U16_MAX = 0xffff;
+export function readU16(b, o) {
+    return b[o] | (b[o + 1] << 8);
+}
+export function readU32(b, o) {
+    return (b[o] | (b[o + 1] << 8) | (b[o + 2] << 16) | (b[o + 3] << 24)) >>> 0;
+}
+export function readU64(b, o) {
+    // Safe up to 2^53-1; ZIP offsets beyond that are not supported.
+    const lo = readU32(b, o);
+    const hi = readU32(b, o + 4);
+    return hi * 0x1_0000_0000 + lo;
+}
+/** Parse the 30 fixed bytes of a local file header (signature already verified or not required). */
+export function parseLocalHeader(b, o = 0) {
+    if (b.length - o < LFH_FIXED_SIZE)
+        return null;
+    return {
+        versionNeeded: readU16(b, o + 4),
+        flags: readU16(b, o + 6),
+        method: readU16(b, o + 8),
+        dosTime: readU16(b, o + 10),
+        dosDate: readU16(b, o + 12),
+        crc32: readU32(b, o + 14),
+        compressedSize: readU32(b, o + 18),
+        uncompressedSize: readU32(b, o + 22),
+        nameLength: readU16(b, o + 26),
+        extraLength: readU16(b, o + 28),
+    };
+}
+const KNOWN_METHODS = new Set([0, 1, 6, 8, 9, 12, 14, 93, 94, 95, 96, 97, 98, 99]);
+/** Cheap plausibility check to reject false-positive PK\x03\x04 matches inside compressed data. */
+export function localHeaderLooksSane(h) {
+    if (h.nameLength === 0 || h.nameLength > 4096)
+        return false;
+    if (h.versionNeeded > 0xff)
+        return false;
+    if (!KNOWN_METHODS.has(h.method))
+        return false;
+    return true;
+}
+/**
+ * Parse a zip64 extended-information extra field (id 0x0001) out of an LFH/CDH
+ * extra blob. Which 8-byte fields are present depends on which 32-bit header
+ * fields are 0xFFFFFFFF, in spec order: usize, csize, offset.
+ */
+export function parseZip64Extra(extra, needs) {
+    let o = 0;
+    while (o + 4 <= extra.length) {
+        const id = readU16(extra, o);
+        const size = readU16(extra, o + 2);
+        const body = extra.subarray(o + 4, Math.min(o + 4 + size, extra.length));
+        if (id === 0x0001) {
+            const result = { malformed: false };
+            let p = 0;
+            const take = () => {
+                if (p + 8 > body.length) {
+                    result.malformed = true;
+                    return undefined;
+                }
+                const v = readU64(body, p);
+                p += 8;
+                return v;
+            };
+            if (needs.uncompressedSize)
+                result.uncompressedSize = take();
+            if (needs.compressedSize)
+                result.compressedSize = take();
+            if (needs.localHeaderOffset)
+                result.localHeaderOffset = take();
+            if (o + 4 + size > extra.length)
+                result.malformed = true;
+            return result;
+        }
+        o += 4 + size;
+    }
+    return null;
+}
+export function parseEocd(b, o, absoluteOffset) {
+    if (b.length - o < EOCD_FIXED_SIZE)
+        return null;
+    if (readU32(b, o) !== SIG_EOCD)
+        return null;
+    return {
+        offset: absoluteOffset,
+        diskNumber: readU16(b, o + 4),
+        cdStartDisk: readU16(b, o + 6),
+        entriesOnDisk: readU16(b, o + 8),
+        totalEntries: readU16(b, o + 10),
+        cdSize: readU32(b, o + 12),
+        cdOffset: readU32(b, o + 16),
+        commentLength: readU16(b, o + 20),
+    };
+}
+/** DOS timestamp for entries whose original date is unrecoverable. */
+export const FALLBACK_DOS_DATE = ((2026 - 1980) << 9) | (1 << 5) | 1;
+export const FALLBACK_DOS_TIME = 0;
+/**
+ * The size actually occupied on disk can legitimately exceed the 32-bit size
+ * declared in the header when a writer (notably OneDrive/old Windows zips
+ * > 4 GiB) stored `size mod 2^32` without zip64 fields. The fix is
+ * deterministic: accept the actual size iff the difference is an exact
+ * multiple of 2^32.
+ */
+export function reconcileDeclaredSize(declared, actual) {
+    if (actual === declared)
+        return { size: actual, wrapAroundFixed: false };
+    const diff = actual - declared;
+    if (diff > 0 && diff % 0x1_0000_0000 === 0)
+        return { size: actual, wrapAroundFixed: true };
+    return null;
+}
+//# sourceMappingURL=format.js.map

package/dist/zip/format.js.map

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

package/dist/zip/repair.d.ts

@@ -0,0 +1,32 @@
+import type { ByteSource } from '../byte-source.js';
+import { type DamageClass } from './diagnose.js';
+import { type EntryStatus } from './salvage.js';
+export interface RepairEntryReport {
+    name: string;
+    headerOffset: number;
+    method: number;
+    status: EntryStatus;
+    included: boolean;
+    compressedSize: number | undefined;
+    uncompressedSize: number | undefined;
+    crc32: number | undefined;
+    notes: string[];
+}
+export interface RepairReport {
+    damageClass: DamageClass;
+    entriesFound: number;
+    entriesIncluded: number;
+    entriesSkipped: number;
+    entries: RepairEntryReport[];
+    notes: string[];
+}
+/**
+ * Rebuild a valid ZIP from every salvageable entry found by the forward scan.
+ * Central directory and EOCD are synthesized from scratch; corrupt entries are
+ * skipped but reported.
+ */
+export declare function repairZip(src: ByteSource): Promise<{
+    zip: Uint8Array;
+    report: RepairReport;
+}>;
+//# sourceMappingURL=repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/zip/repair.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,CA4EnG"}

package/dist/zip/repair.js

@@ -0,0 +1,82 @@
+import { deflateSync, inflateSync } from 'fflate';
+import { FLAG_ENCRYPTED, FLAG_UTF8, METHOD_DEFLATE } from './format.js';
+import { analyzeZip } from './diagnose.js';
+import { validateEntry } from './salvage.js';
+import { buildZip } from './writer.js';
+/**
+ * Rebuild a valid ZIP from every salvageable entry found by the forward scan.
+ * Central directory and EOCD are synthesized from scratch; corrupt entries are
+ * skipped but reported.
+ */
+export async function repairZip(src) {
+    const { scan, damageClass, notes } = await analyzeZip(src);
+    const out = [];
+    const entryReports = [];
+    for (const entry of scan.entries) {
+        const v = await validateEntry(src, entry);
+        let included = false;
+        if (v.status === 'ok' && v.storedData && v.crc32 !== undefined) {
+            let data = v.storedData;
+            const method = entry.method;
+            if (!v.exactStream && method === METHOD_DEFLATE) {
+                // The exact end of the original stream is unknown; re-compress the
+                // verified decoded bytes so the rebuilt entry is exact.
+                data = deflateSync(inflateSync(v.storedData));
+                v.notes.push('recompressed (original stream end was uncertain)');
+            }
+            out.push({
+                nameBytes: entry.nameBytes,
+                flags: entry.flags & FLAG_UTF8,
+                method,
+                dosTime: entry.dosTime,
+                dosDate: entry.dosDate,
+                crc32: v.crc32,
+                uncompressedSize: v.uncompressedSize ?? 0,
+                data,
+            });
+            included = true;
+        }
+        else if ((v.status === 'encrypted' || v.status === 'unsupported-method') &&
+            v.storedData &&
+            v.crc32 !== undefined &&
+            v.uncompressedSize !== undefined) {
+            // Carried over verbatim: unverifiable here, but usable by tools that
+            // support the method / know the password.
+            out.push({
+                nameBytes: entry.nameBytes,
+                flags: entry.flags & (FLAG_UTF8 | FLAG_ENCRYPTED),
+                method: entry.method,
+                dosTime: entry.dosTime,
+                dosDate: entry.dosDate,
+                crc32: v.crc32,
+                uncompressedSize: v.uncompressedSize,
+                data: v.storedData,
+            });
+            included = true;
+        }
+        entryReports.push({
+            name: entry.name,
+            headerOffset: entry.headerOffset,
+            method: entry.method,
+            status: v.status,
+            included,
+            compressedSize: v.storedData ? v.storedData.length : entry.complete ? entry.compressedSize : undefined,
+            uncompressedSize: v.uncompressedSize,
+            crc32: v.crc32,
+            notes: [...entry.notes, ...v.notes],
+        });
+    }
+    const included = entryReports.filter((r) => r.included).length;
+    return {
+        zip: buildZip(out),
+        report: {
+            damageClass,
+            entriesFound: scan.entries.length,
+            entriesIncluded: included,
+            entriesSkipped: scan.entries.length - included,
+            entries: entryReports,
+            notes,
+        },
+    };
+}
+//# sourceMappingURL=repair.js.map

package/dist/zip/repair.js.map

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

package/dist/zip/salvage.d.ts

@@ -0,0 +1,23 @@
+import type { ByteSource } from '../byte-source.js';
+import type { ScannedEntry } from './scan.js';
+export type EntryStatus = 'ok' | 'corrupt-data' | 'encrypted' | 'unsupported-method';
+export interface ValidatedEntry {
+    entry: ScannedEntry;
+    status: EntryStatus;
+    /** Compressed bytes exactly as they should be stored in a rebuilt zip (null when not salvageable). */
+    storedData: Uint8Array | null;
+    /** For `ok`: verified or recomputed CRC of the uncompressed data. For pass-through: declared CRC. */
+    crc32: number | undefined;
+    uncompressedSize: number | undefined;
+    /** True when integrity was proven by a CRC match (vs merely recomputed). */
+    crcVerified: boolean;
+    /** True when storedData is known to be the exact stream (no trailing junk possible). */
+    exactStream: boolean;
+    notes: string[];
+}
+/**
+ * Attempt to decode and integrity-check one scanned entry. Never throws:
+ * corruption is a classification, not an error.
+ */
+export declare function validateEntry(src: ByteSource, entry: ScannedEntry): Promise<ValidatedEntry>;
+//# sourceMappingURL=salvage.d.ts.map

package/dist/zip/salvage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"salvage.d.ts","sourceRoot":"","sources":["../../src/zip/salvage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,cAAc,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,sGAAsG;IACtG,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,qGAAqG;IACrG,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAC;IACrB,wFAAwF;IACxF,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAKD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA2IjG"}

package/dist/zip/salvage.js

@@ -0,0 +1,140 @@
+import { inflateSync } from 'fflate';
+import { crc32 } from '../crc32.js';
+import { FLAG_ENCRYPTED, METHOD_DEFLATE, METHOD_STORE } from './format.js';
+/** Decompression guard: refuse to inflate when the declared output exceeds this. */
+const MAX_INFLATE = 2 * 1024 * 1024 * 1024;
+/**
+ * Attempt to decode and integrity-check one scanned entry. Never throws:
+ * corruption is a classification, not an error.
+ */
+export async function validateEntry(src, entry) {
+    const notes = [];
+    const base = {
+        entry,
+        storedData: null,
+        crc32: entry.crc32,
+        uncompressedSize: entry.uncompressedSize,
+        crcVerified: false,
+        exactStream: false,
+        notes,
+    };
+    const raw = entry.compressedSize > 0 ? await src.read(entry.dataStart, entry.compressedSize) : new Uint8Array(0);
+    if (raw.length < entry.compressedSize) {
+        notes.push('compressed data missing from source');
+        return { ...base, status: 'corrupt-data' };
+    }
+    if (entry.flags & FLAG_ENCRYPTED) {
+        notes.push('entry is encrypted; carried over without verification');
+        return { ...base, storedData: entry.complete ? raw : null, status: 'encrypted' };
+    }
+    if (entry.method === METHOD_STORE) {
+        // Try the header-declared size first when the scan distrusted it: junk
+        // may trail a truthful size (e.g. a zeroed central directory).
+        if (entry.crc32 !== undefined &&
+            entry.altCompressedSize !== undefined &&
+            entry.altCompressedSize <= raw.length) {
+            const alt = raw.subarray(0, entry.altCompressedSize);
+            if (crc32(alt) === entry.crc32) {
+                notes.push('declared size verified against data');
+                return {
+                    ...base,
+                    storedData: alt,
+                    status: 'ok',
+                    uncompressedSize: alt.length,
+                    crcVerified: true,
+                    exactStream: true,
+                };
+            }
+        }
+        const computed = crc32(raw);
+        if (entry.crc32 !== undefined && computed !== entry.crc32) {
+            notes.push(`stored data CRC mismatch (expected ${entry.crc32.toString(16)}, got ${computed.toString(16)})`);
+            return { ...base, status: 'corrupt-data' };
+        }
+        if (entry.crc32 === undefined) {
+            if (!entry.complete && !entry.dataEndUncertain) {
+                notes.push('stored data incomplete and integrity unverifiable');
+                return { ...base, status: 'corrupt-data' };
+            }
+            notes.push('CRC not declared; recomputed from data');
+        }
+        return {
+            ...base,
+            storedData: raw,
+            status: 'ok',
+            crc32: computed,
+            uncompressedSize: raw.length,
+            crcVerified: entry.crc32 !== undefined,
+            exactStream: true,
+        };
+    }
+    if (entry.method !== METHOD_DEFLATE) {
+        notes.push(`compression method ${entry.method} not supported by this engine`);
+        return {
+            ...base,
+            storedData: entry.complete && entry.crc32 !== undefined ? raw : null,
+            status: 'unsupported-method',
+        };
+    }
+    if (entry.uncompressedSize !== undefined && entry.uncompressedSize > MAX_INFLATE) {
+        notes.push('declared uncompressed size exceeds safety cap; not decoded');
+        return { ...base, status: 'unsupported-method' };
+    }
+    if (entry.crc32 !== undefined &&
+        entry.altCompressedSize !== undefined &&
+        entry.altCompressedSize <= raw.length) {
+        const alt = raw.subarray(0, entry.altCompressedSize);
+        try {
+            const decoded = inflateSync(alt);
+            if (crc32(decoded) === entry.crc32) {
+                notes.push('declared size verified against data');
+                return {
+                    ...base,
+                    storedData: alt,
+                    status: 'ok',
+                    uncompressedSize: decoded.length,
+                    crcVerified: true,
+                    exactStream: true,
+                };
+            }
+        }
+        catch {
+            // fall through to the scanned size
+        }
+    }
+    let decoded;
+    try {
+        decoded = inflateSync(raw);
+    }
+    catch {
+        notes.push(entry.complete ? 'deflate stream is corrupt' : 'deflate stream incomplete (truncated)');
+        return { ...base, status: 'corrupt-data' };
+    }
+    const computed = crc32(decoded);
+    if (entry.crc32 !== undefined) {
+        if (computed !== entry.crc32) {
+            notes.push(`CRC mismatch after inflate (expected ${entry.crc32.toString(16)}, got ${computed.toString(16)})`);
+            return { ...base, status: 'corrupt-data' };
+        }
+    }
+    else if (!entry.complete && !entry.dataEndUncertain) {
+        notes.push('data incomplete and no CRC to verify against');
+        return { ...base, status: 'corrupt-data' };
+    }
+    else {
+        notes.push('CRC not recoverable from source; recomputed from decoded data');
+    }
+    if (entry.uncompressedSize !== undefined && decoded.length !== entry.uncompressedSize) {
+        notes.push(`decoded size ${decoded.length} differs from declared ${entry.uncompressedSize}`);
+    }
+    return {
+        ...base,
+        storedData: raw,
+        status: 'ok',
+        crc32: computed,
+        uncompressedSize: decoded.length,
+        crcVerified: entry.crc32 !== undefined,
+        exactStream: entry.endValidated,
+    };
+}
+//# sourceMappingURL=salvage.js.map

package/dist/zip/salvage.js.map

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

package/dist/zip/scan.d.ts

@@ -0,0 +1,64 @@
+import type { ByteSource } from '../byte-source.js';
+import { type Eocd } from './format.js';
+export interface ScannedEntry {
+    headerOffset: number;
+    dataStart: number;
+    method: number;
+    flags: number;
+    nameBytes: Uint8Array;
+    name: string;
+    dosTime: number;
+    dosDate: number;
+    /** Undefined when the header is zeroed (data-descriptor entry) and no descriptor was recovered. */
+    crc32: number | undefined;
+    /** Resolved compressed size; for incomplete entries, the bytes actually available. */
+    compressedSize: number;
+    uncompressedSize: number | undefined;
+    hasDescriptor: boolean;
+    descriptorLength: number;
+    usedZip64: boolean;
+    /** Compressed data fully present in the source. */
+    complete: boolean;
+    /** Size came from a structure scan, not from a trusted header field. */
+    sizeFromScan: boolean;
+    /** The exact end of the compressed stream is unknown (junk may trail it). */
+    dataEndUncertain: boolean;
+    /** Data end proven by a structural boundary or a validated data descriptor. */
+    endValidated: boolean;
+    /** Header-declared size kept as an alternative candidate when the scan distrusted it. */
+    altCompressedSize?: number;
+    /** OneDrive-style mod-2^32 size wraparound was detected and fixed. */
+    wrapAroundFixed: boolean;
+    notes: string[];
+}
+export interface ScanResult {
+    entries: ScannedEntry[];
+    /** Offset of the first local header — non-zero means a garbage prefix. */
+    prefixOffset: number;
+    firstCdhOffset: number | undefined;
+    /** The source ends in the middle of an entry (header or data cut off). */
+    truncatedTail: boolean;
+    /** Number of resyncs over unparseable regions between entries. */
+    gaps: number;
+    notes: string[];
+}
+export interface EocdResult {
+    eocd: Eocd;
+    /** Overrides from the zip64 EOCD, when present and readable. */
+    zip64?: {
+        cdOffset: number;
+        cdSize: number;
+        totalEntries: number;
+    };
+    notes: string[];
+}
+/** Find the next plausible structural record (validated LFH, CDH, or EOCD) at or after `from`. */
+export declare function nextStructuralBoundary(src: ByteSource, from: number): Promise<{
+    offset: number;
+    sig: number;
+} | null>;
+/** Forward streaming scan for local file entries; tolerates garbage prefixes, lying headers, and truncation. */
+export declare function scanLocalEntries(src: ByteSource): Promise<ScanResult>;
+/** Locate the EOCD record by scanning the file tail; resolves zip64 overrides when present. */
+export declare function findEocd(src: ByteSource): Promise<EocdResult | null>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/zip/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/zip/scan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAsBL,KAAK,IAAI,EACV,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,UAAU,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,sFAAsF;IACtF,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,YAAY,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAC;IACtB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,0EAA0E;IAC1E,aAAa,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,gEAAgE;IAChE,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAkCD,kGAAkG;AAClG,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAajD;AAsED,gHAAgH;AAChH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAuN3E;AAED,+FAA+F;AAC/F,wBAAsB,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoD1E"}