hex-audit 0.4.0

package/dist/parsers/lcov.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Parse lcov coverage data from `forge coverage --report lcov`.
+ */
+export interface LcovRecord {
+    sourceFile: string;
+    linesFound: number;
+    linesHit: number;
+    branchesFound: number;
+    branchesHit: number;
+    uncoveredLines: number[];
+}
+export interface LcovReport {
+    records: LcovRecord[];
+    totalLinesFound: number;
+    totalLinesHit: number;
+    totalBranchesFound: number;
+    totalBranchesHit: number;
+}
+/**
+ * Parse lcov format text into structured coverage data.
+ */
+export declare function parseLcov(lcovText: string): LcovReport;
+/**
+ * Calculate coverage percentage.
+ */
+export declare function coveragePct(hit: number, found: number): number;
+//# sourceMappingURL=lcov.d.ts.map

package/dist/parsers/lcov.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcov.d.ts","sourceRoot":"","sources":["../../src/parsers/lcov.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAmDtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/parsers/lcov.js

@@ -0,0 +1,68 @@
+/**
+ * Parse lcov coverage data from `forge coverage --report lcov`.
+ */
+/**
+ * Parse lcov format text into structured coverage data.
+ */
+export function parseLcov(lcovText) {
+    const records = [];
+    let current = null;
+    const lines = lcovText.split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('SF:')) {
+            current = {
+                sourceFile: trimmed.slice(3),
+                linesFound: 0,
+                linesHit: 0,
+                branchesFound: 0,
+                branchesHit: 0,
+                uncoveredLines: [],
+            };
+        }
+        else if (trimmed.startsWith('DA:') && current) {
+            const parts = trimmed.slice(3).split(',');
+            const lineNum = parseInt(parts[0], 10);
+            const hitCount = parseInt(parts[1], 10);
+            if (hitCount === 0) {
+                current.uncoveredLines.push(lineNum);
+            }
+        }
+        else if (trimmed.startsWith('LF:') && current) {
+            current.linesFound = parseInt(trimmed.slice(3), 10);
+        }
+        else if (trimmed.startsWith('LH:') && current) {
+            current.linesHit = parseInt(trimmed.slice(3), 10);
+        }
+        else if (trimmed.startsWith('BRF:') && current) {
+            current.branchesFound = parseInt(trimmed.slice(4), 10);
+        }
+        else if (trimmed.startsWith('BRH:') && current) {
+            current.branchesHit = parseInt(trimmed.slice(4), 10);
+        }
+        else if (trimmed === 'end_of_record' && current) {
+            records.push(current);
+            current = null;
+        }
+    }
+    const totalLinesFound = records.reduce((s, r) => s + r.linesFound, 0);
+    const totalLinesHit = records.reduce((s, r) => s + r.linesHit, 0);
+    const totalBranchesFound = records.reduce((s, r) => s + r.branchesFound, 0);
+    const totalBranchesHit = records.reduce((s, r) => s + r.branchesHit, 0);
+    return {
+        records,
+        totalLinesFound,
+        totalLinesHit,
+        totalBranchesFound,
+        totalBranchesHit,
+    };
+}
+/**
+ * Calculate coverage percentage.
+ */
+export function coveragePct(hit, found) {
+    if (found === 0)
+        return 100;
+    return Math.round((hit / found) * 1000) / 10;
+}
+//# sourceMappingURL=lcov.js.map

package/dist/parsers/lcov.js.map

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

package/dist/parsers/slither.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Parse Slither JSON outputs for various printers and detectors.
+ */
+export interface SlitherFunctionSummary {
+    contract: string;
+    function: string;
+    visibility: string;
+    modifiers: string[];
+    readVars: string[];
+    writeVars: string[];
+    internalCalls: string[];
+    externalCalls: string[];
+}
+export interface SlitherDetectorResult {
+    check: string;
+    impact: string;
+    confidence: string;
+    description: string;
+    elements: SlitherElement[];
+}
+export interface SlitherElement {
+    type: string;
+    name: string;
+    source_mapping: {
+        filename_relative: string;
+        lines: number[];
+        starting_column: number;
+        ending_column: number;
+    };
+    type_specific_fields?: Record<string, unknown>;
+}
+export interface SlitherDataDependency {
+    contract: string;
+    variable: string;
+    dependencies: string[];
+}
+/**
+ * Parse Slither's function-summary printer output.
+ */
+export declare function parseFunctionSummary(json: unknown): SlitherFunctionSummary[];
+/**
+ * Parse Slither detector results.
+ */
+export declare function parseDetectors(json: unknown): SlitherDetectorResult[];
+/**
+ * Parse Slither data-dependency printer output.
+ */
+export declare function parseDataDependency(json: unknown): SlitherDataDependency[];
+/**
+ * Parse Slither call-graph printer output into caller→callee edges.
+ */
+export declare function parseCallGraph(json: unknown): Array<{
+    caller: {
+        contract: string;
+        function: string;
+    };
+    callee: {
+        contract: string;
+        function: string;
+    };
+    isExternal: boolean;
+}>;
+//# sourceMappingURL=slither.d.ts.map

package/dist/parsers/slither.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slither.d.ts","sourceRoot":"","sources":["../../src/parsers/slither.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,sBAAsB,EAAE,CAuC5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,EAAE,CAmBrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,EAAE,CA4B1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACnD,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC,CAsCD"}

package/dist/parsers/slither.js

@@ -0,0 +1,160 @@
+/**
+ * Parse Slither JSON outputs for various printers and detectors.
+ */
+/**
+ * Parse Slither's function-summary printer output.
+ */
+export function parseFunctionSummary(json) {
+    const results = [];
+    if (!json || typeof json !== 'object')
+        return results;
+    const data = json;
+    const printers = data.results?.printers;
+    if (!Array.isArray(printers))
+        return results;
+    for (const printer of printers) {
+        const p = printer;
+        if (p.printer !== 'function-summary')
+            continue;
+        const elements = p.elements;
+        if (!Array.isArray(elements))
+            continue;
+        for (const elem of elements) {
+            const e = elem;
+            const rows = e.rows;
+            if (!Array.isArray(rows))
+                continue;
+            for (const row of rows) {
+                const r = row;
+                results.push({
+                    contract: String(r.contract ?? ''),
+                    function: String(r.function ?? ''),
+                    visibility: String(r.visibility ?? ''),
+                    modifiers: parseStringList(r.modifiers),
+                    readVars: parseStringList(r.read),
+                    writeVars: parseStringList(r.write),
+                    internalCalls: parseStringList(r.internal_calls),
+                    externalCalls: parseStringList(r.external_calls),
+                });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Parse Slither detector results.
+ */
+export function parseDetectors(json) {
+    if (!json || typeof json !== 'object')
+        return [];
+    const data = json;
+    const results = data.results;
+    const detectors = results?.detectors;
+    if (!Array.isArray(detectors))
+        return [];
+    return detectors.map((d) => {
+        const det = d;
+        return {
+            check: String(det.check ?? ''),
+            impact: String(det.impact ?? ''),
+            confidence: String(det.confidence ?? ''),
+            description: String(det.description ?? ''),
+            elements: parseElements(det.elements),
+        };
+    });
+}
+/**
+ * Parse Slither data-dependency printer output.
+ */
+export function parseDataDependency(json) {
+    const results = [];
+    if (!json || typeof json !== 'object')
+        return results;
+    const data = json;
+    const printers = data.results?.printers;
+    if (!Array.isArray(printers))
+        return results;
+    for (const printer of printers) {
+        const p = printer;
+        if (p.printer !== 'data-dependency')
+            continue;
+        const elements = p.elements;
+        if (!Array.isArray(elements))
+            continue;
+        for (const elem of elements) {
+            const e = elem;
+            results.push({
+                contract: String(e.contract ?? ''),
+                variable: String(e.variable ?? ''),
+                dependencies: parseStringList(e.dependencies),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Parse Slither call-graph printer output into caller→callee edges.
+ */
+export function parseCallGraph(json) {
+    const edges = [];
+    if (!json || typeof json !== 'object')
+        return edges;
+    const data = json;
+    const printers = data.results?.printers;
+    if (!Array.isArray(printers))
+        return edges;
+    for (const printer of printers) {
+        const p = printer;
+        if (p.printer !== 'call-graph')
+            continue;
+        const elements = p.elements;
+        if (!Array.isArray(elements))
+            continue;
+        for (const elem of elements) {
+            const e = elem;
+            edges.push({
+                caller: {
+                    contract: String(e.caller?.contract ?? ''),
+                    function: String(e.caller?.function ?? ''),
+                },
+                callee: {
+                    contract: String(e.callee?.contract ?? ''),
+                    function: String(e.callee?.function ?? ''),
+                },
+                isExternal: Boolean(e.is_external),
+            });
+        }
+    }
+    return edges;
+}
+function parseElements(elements) {
+    if (!Array.isArray(elements))
+        return [];
+    return elements.map((e) => {
+        const el = e;
+        const sm = (el.source_mapping ?? {});
+        return {
+            type: String(el.type ?? ''),
+            name: String(el.name ?? ''),
+            source_mapping: {
+                filename_relative: String(sm.filename_relative ?? ''),
+                lines: Array.isArray(sm.lines) ? sm.lines : [],
+                starting_column: Number(sm.starting_column ?? 0),
+                ending_column: Number(sm.ending_column ?? 0),
+            },
+            type_specific_fields: el.type_specific_fields,
+        };
+    });
+}
+function parseStringList(val) {
+    if (typeof val === 'string') {
+        return val
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    if (Array.isArray(val))
+        return val.map(String);
+    return [];
+}
+//# sourceMappingURL=slither.js.map

package/dist/parsers/slither.js.map

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

package/dist/parsers/solc.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Parse solc compiler outputs: AST JSON and storage layout.
+ */
+export interface StorageLayoutEntry {
+    contract: string;
+    label: string;
+    type: string;
+    slot: number;
+    offset: number;
+    numberOfBytes: number;
+}
+export interface StorageLayout {
+    entries: StorageLayoutEntry[];
+}
+/**
+ * Parse solc --storage-layout output.
+ */
+export declare function parseStorageLayout(json: unknown, contractName: string): StorageLayout;
+//# sourceMappingURL=solc.d.ts.map

package/dist/parsers/solc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solc.d.ts","sourceRoot":"","sources":["../../src/parsers/solc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,CAwCrF"}

package/dist/parsers/solc.js

@@ -0,0 +1,43 @@
+/**
+ * Parse solc compiler outputs: AST JSON and storage layout.
+ */
+/**
+ * Parse solc --storage-layout output.
+ */
+export function parseStorageLayout(json, contractName) {
+    const entries = [];
+    if (!json || typeof json !== 'object')
+        return { entries };
+    const data = json;
+    // solc outputs nested under contracts
+    const contracts = data.contracts;
+    if (!contracts)
+        return { entries };
+    for (const [, fileContracts] of Object.entries(contracts)) {
+        for (const [name, contractData] of Object.entries(fileContracts)) {
+            if (contractName && name !== contractName)
+                continue;
+            const cd = contractData;
+            const layout = cd.storageLayout;
+            if (!layout)
+                continue;
+            const storage = layout.storage;
+            if (!Array.isArray(storage))
+                continue;
+            for (const item of storage) {
+                const s = item;
+                entries.push({
+                    contract: name,
+                    label: String(s.label ?? ''),
+                    type: String(s.type ?? ''),
+                    slot: Number(s.slot ?? 0),
+                    offset: Number(s.offset ?? 0),
+                    numberOfBytes: Number((layout.types?.[String(s.type)]
+                        ?.numberOfBytes) ?? 0),
+                });
+            }
+        }
+    }
+    return { entries };
+}
+//# sourceMappingURL=solc.js.map

package/dist/parsers/solc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solc.js","sourceRoot":"","sources":["../../src/parsers/solc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa,EAAE,YAAoB;IACpE,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAE1D,MAAM,IAAI,GAAG,IAA+B,CAAC;IAE7C,sCAAsC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAgE,CAAC;IACxF,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YACjE,IAAI,YAAY,IAAI,IAAI,KAAK,YAAY;gBAAE,SAAS;YAEpD,MAAM,EAAE,GAAG,YAAuC,CAAC;YACnD,MAAM,MAAM,GAAG,EAAE,CAAC,aAAwC,CAAC;YAC3D,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAoB,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,SAAS;YAEtC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,IAA+B,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC5B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;oBAC1B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;oBACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;oBAC7B,aAAa,EAAE,MAAM,CACnB,CAAE,MAAM,CAAC,KAAiD,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;wBAC1E,EAAE,aAAa,CAAC,IAAI,CAAC,CACxB;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/parsers/solidity-parser.d.ts

@@ -0,0 +1,77 @@
+import type { Comment } from '@solidity-parser/parser/src/ast-types.js';
+export interface ParsedContract {
+    name: string;
+    type: 'contract' | 'interface' | 'library' | 'abstract';
+    lineStart: number;
+    lineEnd: number;
+    baseContracts: string[];
+    functions: ParsedFunction[];
+    modifiers: ParsedModifier[];
+    events: string[];
+    errors: string[];
+    stateVariables: ParsedStateVariable[];
+    structs: string[];
+    enums: string[];
+}
+export interface ParsedFunction {
+    name: string;
+    visibility: 'external' | 'public' | 'internal' | 'private' | 'default';
+    stateMutability: string | null;
+    modifiers: string[];
+    lineStart: number;
+    lineEnd: number;
+    isConstructor: boolean;
+    isFallback: boolean;
+    isReceive: boolean;
+}
+export interface ParsedModifier {
+    name: string;
+    lineStart: number;
+    lineEnd: number;
+}
+export interface ParsedStateVariable {
+    name: string;
+    typeName: string;
+    visibility: 'public' | 'internal' | 'private';
+    mutability: 'mutable' | 'constant' | 'immutable';
+    lineStart: number;
+    lineEnd: number;
+    initialValue: string | null;
+}
+export interface ParsedImport {
+    path: string;
+    symbols: string[];
+    lineStart: number;
+}
+export interface ParseResult {
+    contracts: ParsedContract[];
+    imports: ParsedImport[];
+    pragmas: string[];
+    comments: Comment[];
+}
+/**
+ * Parse a Solidity source file into a structured result.
+ */
+export declare function parseSolidity(source: string, filePath?: string): ParseResult;
+export declare function parseSolidityCached(source: string, filePath: string): ParseResult;
+export interface ASTExternalCall {
+    contract: string;
+    function: string;
+    target: string;
+    method: string;
+    file: string;
+    lineStart: number;
+    lineEnd: number;
+    snippet: string;
+    callType: 'member_access' | 'low_level';
+}
+/**
+ * Extract external calls from parsed Solidity AST by walking all function bodies.
+ * Identifies MemberAccess + FunctionCall on external contracts and low-level calls.
+ */
+export declare function extractExternalCalls(source: string, filePath: string): ASTExternalCall[];
+/**
+ * Extract the Solidity version from pragma statements.
+ */
+export declare function extractSolidityVersion(pragmas: string[]): string | null;
+//# sourceMappingURL=solidity-parser.d.ts.map

package/dist/parsers/solidity-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidity-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/solidity-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,0CAA0C,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACvE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9C,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CA8B5E;AASD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAMjF;AAiKD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,GAAG,WAAW,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,eAAe,EAAE,CAiCnB;AAwKD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAMvE"}