hardhat 3.0.0-next.2 → 3.0.0-next.20

package/dist/src/internal/builtin-plugins/coverage/coverage-manager.js

@@ -0,0 +1,364 @@
+import path from "node:path";
+import { assertHardhatInvariant } from "@nomicfoundation/hardhat-errors";
+import { ensureDir, getAllFilesMatching, readJsonFile, remove, writeJsonFile, writeUtf8File, } from "@nomicfoundation/hardhat-utils/fs";
+import debug from "debug";
+const log = debug("hardhat:core:coverage:coverage-manager");
+const MAX_COLUMN_WIDTH = 80;
+export class CoverageManagerImplementation {
+    // NOTE: These are exposed for testing only
+    metadata = [];
+    data = [];
+    #coveragePath;
+    #reportEnabled = true;
+    constructor(coveragePath) {
+        this.#coveragePath = coveragePath;
+    }
+    async #getDataPath(id) {
+        const dataPath = path.join(this.#coveragePath, "data", id);
+        await ensureDir(dataPath);
+        return dataPath;
+    }
+    async addData(data) {
+        this.data.push(...data);
+        log("Added data", JSON.stringify(data, null, 2));
+    }
+    async addMetadata(metadata) {
+        // NOTE: The received metadata might contain duplicates. We deduplicate it
+        // when we generate the report.
+        this.metadata.push(...metadata);
+        log("Added metadata", JSON.stringify(metadata, null, 2));
+    }
+    async clearData(id) {
+        const dataPath = await this.#getDataPath(id);
+        await remove(dataPath);
+        this.data = [];
+        log("Cleared data from disk and memory");
+    }
+    async saveData(id) {
+        const dataPath = await this.#getDataPath(id);
+        const filePath = path.join(dataPath, `${crypto.randomUUID()}.json`);
+        const data = this.data;
+        await writeJsonFile(filePath, data);
+        log("Saved data");
+    }
+    async report(...ids) {
+        if (!this.#reportEnabled) {
+            return;
+        }
+        await this.loadData(...ids);
+        const report = this.getReport();
+        const lcovReport = this.formatLcovReport(report);
+        const markdownReport = this.formatMarkdownReport(report);
+        const lcovReportPath = path.join(this.#coveragePath, "lcov.info");
+        await writeUtf8File(lcovReportPath, lcovReport);
+        log(`Saved lcov report to ${lcovReportPath}`);
+        console.log(markdownReport);
+        log("Printed markdown report");
+    }
+    enableReport() {
+        this.#reportEnabled = true;
+    }
+    disableReport() {
+        this.#reportEnabled = false;
+    }
+    // NOTE: This is exposed for testing only
+    async loadData(...ids) {
+        this.data = [];
+        for (const id of ids) {
+            const dataPath = await this.#getDataPath(id);
+            const filePaths = await getAllFilesMatching(dataPath);
+            const data = [];
+            for (const filePath of filePaths) {
+                const partialData = await readJsonFile(filePath);
+                data.push(...partialData);
+            }
+            this.data.push(...data);
+        }
+    }
+    // NOTE: This is exposed for testing only
+    getReport() {
+        const report = {};
+        const relativePaths = this.metadata.map(({ relativePath }) => relativePath);
+        const allStatements = this.metadata;
+        // NOTE: We preserve only the last statement per tag in the statementsByTag map.
+        const statementsByTag = new Map();
+        for (const statement of allStatements) {
+            statementsByTag.set(statement.tag, statement);
+        }
+        const allExecutedTags = this.data;
+        const allExecutedStatementsByRelativePath = new Map();
+        for (const tag of allExecutedTags) {
+            // NOTE: We should not encounter an executed tag we don't have metadata for.
+            const statement = statementsByTag.get(tag);
+            assertHardhatInvariant(statement !== undefined, "Expected a statement");
+            const relativePath = statement.relativePath;
+            const allExecutedStatements = allExecutedStatementsByRelativePath.get(relativePath) ?? [];
+            allExecutedStatements.push(statement);
+            allExecutedStatementsByRelativePath.set(relativePath, allExecutedStatements);
+        }
+        const uniqueExecutedTags = new Set(allExecutedTags);
+        const uniqueUnexecutedTags = Array.from(statementsByTag.keys()).filter((tag) => !uniqueExecutedTags.has(tag));
+        const uniqueUnexecutedStatementsByRelativePath = new Map();
+        for (const tag of uniqueUnexecutedTags) {
+            // NOTE: We cannot encounter an executed tag we don't have metadata for.
+            const statement = statementsByTag.get(tag);
+            assertHardhatInvariant(statement !== undefined, "Expected a statement");
+            const relativePath = statement.relativePath;
+            const unexecutedStatements = uniqueUnexecutedStatementsByRelativePath.get(relativePath) ?? [];
+            unexecutedStatements.push(statement);
+            uniqueUnexecutedStatementsByRelativePath.set(relativePath, unexecutedStatements);
+        }
+        for (const relativePath of relativePaths) {
+            const allExecutedStatements = allExecutedStatementsByRelativePath.get(relativePath) ?? [];
+            const uniqueUnexecutedStatements = uniqueUnexecutedStatementsByRelativePath.get(relativePath) ?? [];
+            const tagExecutionCounts = new Map();
+            for (const statement of allExecutedStatements) {
+                const tagExecutionCount = tagExecutionCounts.get(statement.tag) ?? 0;
+                tagExecutionCounts.set(statement.tag, tagExecutionCount + 1);
+            }
+            const lineExecutionCounts = new Map();
+            const branchExecutionCounts = new Map();
+            for (const [tag, executionCount] of tagExecutionCounts) {
+                const statement = statementsByTag.get(tag);
+                assertHardhatInvariant(statement !== undefined, "Expected a statement");
+                for (let line = statement.startLine; line <= statement.endLine; line++) {
+                    const lineExecutionCount = lineExecutionCounts.get(line) ?? 0;
+                    lineExecutionCounts.set(line, lineExecutionCount + executionCount);
+                    const branchExecutionCount = branchExecutionCounts.get([line, tag]) ?? 0;
+                    branchExecutionCounts.set([line, tag], branchExecutionCount + executionCount);
+                }
+            }
+            const executedTagsCount = tagExecutionCounts.size;
+            const executedLinesCount = lineExecutionCounts.size;
+            const executedBranchesCount = branchExecutionCounts.size;
+            const partiallyExecutedLines = new Set();
+            const unexecutedLines = new Set();
+            for (const statement of uniqueUnexecutedStatements) {
+                if (!tagExecutionCounts.has(statement.tag)) {
+                    tagExecutionCounts.set(statement.tag, 0);
+                }
+                for (let line = statement.startLine; line <= statement.endLine; line++) {
+                    if (!lineExecutionCounts.has(line)) {
+                        lineExecutionCounts.set(line, 0);
+                        unexecutedLines.add(line);
+                    }
+                    else {
+                        partiallyExecutedLines.add(line);
+                    }
+                    if (!branchExecutionCounts.has([line, statement.tag])) {
+                        branchExecutionCounts.set([line, statement.tag], 0);
+                    }
+                }
+            }
+            report[relativePath] = {
+                tagExecutionCounts,
+                lineExecutionCounts,
+                branchExecutionCounts,
+                executedTagsCount,
+                executedLinesCount,
+                executedBranchesCount,
+                partiallyExecutedLines,
+                unexecutedLines,
+            };
+        }
+        return report;
+    }
+    // NOTE: This is exposed for testing only
+    formatLcovReport(report) {
+        // NOTE: Format follows the guidelines set out in:
+        // https://github.com/linux-test-project/lcov/blob/df03ba434eee724bfc2b27716f794d0122951404/man/geninfo.1#L1409
+        let lcov = "";
+        // A tracefile is made up of several human-readable lines of text, divided
+        // into sections.
+        // If available, a tracefile begins with the testname which is stored in the
+        // following format:
+        // TN:<test name>
+        lcov += "TN:\n";
+        // For each source file referenced in the .gcda file, there is a section
+        // containing filename and coverage data:
+        // SF:<path to the source file>
+        for (const [relativePath, { branchExecutionCounts, executedBranchesCount, lineExecutionCounts, executedLinesCount, },] of Object.entries(report)) {
+            lcov += `SF:${relativePath}\n`;
+            // NOTE: We report statement coverage as branches to get partial line coverage
+            // data in tools parsing the lcov files. This is because the lcov format
+            // does not support statement coverage.
+            // WARN: This feature is highly experimental and should not be relied upon.
+            // Branch coverage information is stored one line per branch:
+            // BRDA:<line_number>,[<exception>]<block>,<branch>,<taken>
+            // Branch coverage summaries are stored in two lines:
+            // BRF:<number of branches found>
+            // BRH:<number of branches hit>
+            for (const [[line, tag], executionCount] of branchExecutionCounts) {
+                lcov += `BRDA:${line},0,${tag},${executionCount === 0 ? "-" : executionCount}\n`;
+            }
+            lcov += `BRH:${executedBranchesCount}\n`;
+            lcov += `BRF:${branchExecutionCounts.size}\n`;
+            // Then there is a list of execution counts for each instrumented line
+            // (i.e. a line which resulted in executable code):
+            // DA:<line number>,<execution count>[,<checksum>]
+            // At the end of a section, there is a summary about how many lines
+            // were found and how many were actually instrumented:
+            // LH:<number of lines with a non\-zero execution count>
+            // LF:<number of instrumented lines>
+            for (const [line, executionCount] of lineExecutionCounts) {
+                lcov += `DA:${line},${executionCount}\n`;
+            }
+            lcov += `LH:${executedLinesCount}\n`;
+            lcov += `LF:${lineExecutionCounts.size}\n`;
+            // Each sections ends with:
+            // end_of_record
+            lcov += "end_of_record\n";
+        }
+        return lcov;
+    }
+    // NOTE: This is exposed for testing only
+    formatRelativePath(relativePath) {
+        if (relativePath.length <= MAX_COLUMN_WIDTH) {
+            return relativePath;
+        }
+        const prefix = "…";
+        const pathParts = relativePath.split(path.sep);
+        const parts = [pathParts[pathParts.length - 1]];
+        let partsLength = parts[0].length;
+        for (let i = pathParts.length - 2; i >= 0; i--) {
+            const part = pathParts[i];
+            if (partsLength +
+                part.length +
+                prefix.length +
+                (parts.length + 1) * path.sep.length <=
+                MAX_COLUMN_WIDTH) {
+                parts.push(part);
+                partsLength += part.length;
+            }
+            else {
+                break;
+            }
+        }
+        parts.push(prefix);
+        return parts.reverse().join(path.sep);
+    }
+    // NOTE: This is exposed for testing only
+    formatCoverage(coverage) {
+        return coverage.toFixed(2).toString();
+    }
+    // NOTE: This is exposed for testing only
+    formatLines(lines) {
+        if (lines.size === 0) {
+            return "-";
+        }
+        const sortedLines = Array.from(lines).toSorted((a, b) => a - b);
+        const intervals = [];
+        let intervalsLength = 0;
+        let startLine = sortedLines[0];
+        let endLine = sortedLines[0];
+        for (let i = 1; i <= sortedLines.length; i++) {
+            if (i < sortedLines.length && sortedLines[i] === endLine + 1) {
+                endLine = sortedLines[i];
+            }
+            else {
+                let interval;
+                if (startLine === endLine) {
+                    interval = startLine.toString();
+                }
+                else {
+                    interval = `${startLine}-${endLine}`;
+                }
+                intervals.push(interval);
+                intervalsLength += interval.length;
+                if (i < sortedLines.length) {
+                    startLine = sortedLines[i];
+                    endLine = sortedLines[i];
+                }
+            }
+        }
+        const sep = ", ";
+        const suffixSep = ",";
+        const suffix = "…";
+        if (intervalsLength + (intervals.length - 1) * sep.length <=
+            MAX_COLUMN_WIDTH) {
+            return intervals.join(sep);
+        }
+        while (intervalsLength +
+            (intervals.length - 1) * sep.length +
+            suffix.length +
+            suffixSep.length >
+            MAX_COLUMN_WIDTH) {
+            const interval = intervals.pop();
+            if (interval !== undefined) {
+                intervalsLength -= interval.length;
+            }
+            else {
+                break;
+            }
+        }
+        return [intervals.join(sep), suffix].join(suffixSep);
+    }
+    // NOTE: This is exposed for testing only
+    formatMarkdownReport(report) {
+        let totalExecutedLines = 0;
+        let totalExecutableLines = 0;
+        let totalExecutedStatements = 0;
+        let totalExecutableStatements = 0;
+        const headerRow = [
+            "File Path 📦",
+            "Line % 📈",
+            "Statement % 📈",
+            "Uncovered Lines 🔍",
+            "Partially Covered Lines 🔍",
+        ];
+        const rows = Object.entries(report).map(([relativePath, { tagExecutionCounts, lineExecutionCounts, executedTagsCount, executedLinesCount, unexecutedLines, partiallyExecutedLines, },]) => {
+            const lineCoverage = lineExecutionCounts.size === 0
+                ? 0
+                : (executedLinesCount * 100.0) / lineExecutionCounts.size;
+            const statementCoverage = tagExecutionCounts.size === 0
+                ? 0
+                : (executedTagsCount * 100.0) / tagExecutionCounts.size;
+            totalExecutedLines += executedLinesCount;
+            totalExecutableLines += lineExecutionCounts.size;
+            totalExecutedStatements += executedTagsCount;
+            totalExecutableStatements += tagExecutionCounts.size;
+            const row = [
+                this.formatRelativePath(relativePath),
+                this.formatCoverage(lineCoverage),
+                this.formatCoverage(statementCoverage),
+                this.formatLines(unexecutedLines),
+                this.formatLines(partiallyExecutedLines),
+            ];
+            return row;
+        });
+        const totalLineCoverage = totalExecutableLines === 0
+            ? 0
+            : (totalExecutedLines * 100.0) / totalExecutableLines;
+        const totalStatementCoverage = totalExecutableStatements === 0
+            ? 0
+            : (totalExecutedStatements * 100.0) / totalExecutableStatements;
+        const footerRow = [
+            "Total",
+            this.formatCoverage(totalLineCoverage),
+            this.formatCoverage(totalStatementCoverage),
+            "",
+            "",
+        ];
+        const widths = headerRow.map((header) => header.length);
+        for (const row of rows) {
+            for (let i = 0; i < row.length; i++) {
+                widths[i] = Math.max(widths[i], row[i].length);
+            }
+        }
+        for (let i = 0; i < footerRow.length; i++) {
+            widths[i] = Math.max(widths[i], footerRow[i].length);
+        }
+        const dividerRow = widths.map((width) => "-".repeat(width));
+        rows.unshift(dividerRow);
+        rows.unshift(headerRow);
+        rows.push(dividerRow);
+        rows.push(footerRow);
+        rows.forEach((row) => {
+            for (let i = 0; i < row.length; i++) {
+                row[i] = row[i].padEnd(widths[i]);
+            }
+        });
+        return rows.map((row) => `| ${row.join(" | ")} |`).join("\n");
+    }
+}
+//# sourceMappingURL=coverage-manager.js.map

package/dist/src/internal/builtin-plugins/coverage/coverage-manager.js.map

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

package/dist/src/internal/builtin-plugins/coverage/exports.d.ts

@@ -0,0 +1,2 @@
+export { markTestRunStart, markTestRunDone, markTestWorkerDone, } from "./helpers.js";
+//# sourceMappingURL=exports.d.ts.map

package/dist/src/internal/builtin-plugins/coverage/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/coverage/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/src/internal/builtin-plugins/coverage/exports.js

@@ -0,0 +1,2 @@
+export { markTestRunStart, markTestRunDone, markTestWorkerDone, } from "./helpers.js";
+//# sourceMappingURL=exports.js.map

package/dist/src/internal/builtin-plugins/coverage/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/coverage/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/src/internal/builtin-plugins/coverage/helpers.d.ts

@@ -0,0 +1,12 @@
+export declare function getCoveragePath(rootPath: string): string;
+/**
+ * NOTE: The following helpers interact with the global HRE instance only;
+ * This is OK because:
+ * - They are intended for the internal use only. They are exposed via the
+ *   internal public API only.
+ * - We know the HRE has been initialized by the time they are used.
+ */
+export declare function markTestRunStart(id: string): Promise<void>;
+export declare function markTestWorkerDone(id: string): Promise<void>;
+export declare function markTestRunDone(id: string): Promise<void>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/src/internal/builtin-plugins/coverage/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/coverage/helpers.ts"],"names":[],"mappings":"AAMA,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AAEH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/D"}

package/dist/src/internal/builtin-plugins/coverage/helpers.js

@@ -0,0 +1,35 @@
+import path from "node:path";
+import { assertHardhatInvariant } from "@nomicfoundation/hardhat-errors";
+import { HardhatRuntimeEnvironmentImplementation } from "../../core/hre.js";
+export function getCoveragePath(rootPath) {
+    return path.join(rootPath, "coverage");
+}
+/**
+ * NOTE: The following helpers interact with the global HRE instance only;
+ * This is OK because:
+ * - They are intended for the internal use only. They are exposed via the
+ *   internal public API only.
+ * - We know the HRE has been initialized by the time they are used.
+ */
+export async function markTestRunStart(id) {
+    const { default: hre } = await import("../../../index.js");
+    if (hre.globalOptions.coverage === true) {
+        assertHardhatInvariant(hre instanceof HardhatRuntimeEnvironmentImplementation, "Expected HRE to be an instance of HardhatRuntimeEnvironmentImplementation");
+        await hre._coverage.clearData(id);
+    }
+}
+export async function markTestWorkerDone(id) {
+    const { default: hre } = await import("../../../index.js");
+    if (hre.globalOptions.coverage === true) {
+        assertHardhatInvariant(hre instanceof HardhatRuntimeEnvironmentImplementation, "Expected HRE to be an instance of HardhatRuntimeEnvironmentImplementation");
+        await hre._coverage.saveData(id);
+    }
+}
+export async function markTestRunDone(id) {
+    const { default: hre } = await import("../../../index.js");
+    if (hre.globalOptions.coverage === true) {
+        assertHardhatInvariant(hre instanceof HardhatRuntimeEnvironmentImplementation, "Expected HRE to be an instance of HardhatRuntimeEnvironmentImplementation");
+        await hre._coverage.report(id);
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/src/internal/builtin-plugins/coverage/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/coverage/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EAAE,uCAAuC,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AAEH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAU;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC3D,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACxC,sBAAsB,CACpB,GAAG,YAAY,uCAAuC,EACtD,2EAA2E,CAC5E,CAAC;QACF,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAU;IACjD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC3D,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACxC,sBAAsB,CACpB,GAAG,YAAY,uCAAuC,EACtD,2EAA2E,CAC5E,CAAC;QACF,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU;IAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC3D,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACxC,sBAAsB,CACpB,GAAG,YAAY,uCAAuC,EACtD,2EAA2E,CAC5E,CAAC;QACF,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/clean.d.ts

@@ -0,0 +1,4 @@
+import type { CleanHooks } from "../../../../types/hooks.js";
+declare const _default: () => Promise<Partial<CleanHooks>>;
+export default _default;
+//# sourceMappingURL=clean.d.ts.map

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/hook-handlers/clean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;8BAMpC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAArD,wBAKG"}

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/clean.js

@@ -0,0 +1,9 @@
+import { remove } from "@nomicfoundation/hardhat-utils/fs";
+import { getCoveragePath } from "../helpers.js";
+export default async () => ({
+    onClean: async (context) => {
+        const coveragePath = getCoveragePath(context.config.paths.root);
+        await remove(coveragePath);
+    },
+});
+//# sourceMappingURL=clean.js.map

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/hook-handlers/clean.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAe,KAAK,IAAkC,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACzB,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC,CAAC"}

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/hre.d.ts

@@ -0,0 +1,4 @@
+import type { HardhatRuntimeEnvironmentHooks } from "../../../../types/hooks.js";
+declare const _default: () => Promise<Partial<HardhatRuntimeEnvironmentHooks>>;
+export default _default;
+//# sourceMappingURL=hre.d.ts.map

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/hre.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hre.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/hook-handlers/hre.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;8BAQxD,OAAO,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;AAAzE,wBAyBG"}

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/hre.js

@@ -0,0 +1,24 @@
+import { assertHardhatInvariant } from "@nomicfoundation/hardhat-errors";
+import { HardhatRuntimeEnvironmentImplementation } from "../../../core/hre.js";
+import { CoverageManagerImplementation } from "../coverage-manager.js";
+import { getCoveragePath } from "../helpers.js";
+export default async () => ({
+    created: async (context, hre) => {
+        if (context.globalOptions.coverage) {
+            const coveragePath = getCoveragePath(hre.config.paths.root);
+            const coverageManager = new CoverageManagerImplementation(coveragePath);
+            assertHardhatInvariant(hre instanceof HardhatRuntimeEnvironmentImplementation, "Expected HRE to be an instance of HardhatRuntimeEnvironmentImplementation");
+            hre._coverage = coverageManager;
+            // NOTE: We register this hook dynamically because we use the information about
+            // the existence of onCoverageData hook handlers to determine whether coverage
+            // is enabled or not.
+            hre.hooks.registerHandlers("network", {
+                onCoverageData: async (_context, coverageData) => {
+                    await coverageManager.addData(coverageData);
+                    return;
+                },
+            });
+        }
+    },
+});
+//# sourceMappingURL=hre.js.map

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/hre.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hre.js","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/hook-handlers/hre.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EAAE,uCAAuC,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAe,KAAK,IAAsD,EAAE,CAAC,CAAC;IAC5E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;QAC9B,IAAI,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,eAAe,GAAG,IAAI,6BAA6B,CAAC,YAAY,CAAC,CAAC;YAExE,sBAAsB,CACpB,GAAG,YAAY,uCAAuC,EACtD,2EAA2E,CAC5E,CAAC;YAEF,GAAG,CAAC,SAAS,GAAG,eAAe,CAAC;YAEhC,+EAA+E;YAC/E,8EAA8E;YAC9E,qBAAqB;YACrB,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE;gBACpC,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;oBAC/C,MAAM,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBAE5C,OAAO;gBACT,CAAC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/solidity.d.ts

@@ -0,0 +1,4 @@
+import type { SolidityHooks } from "../../../../types/hooks.js";
+declare const _default: () => Promise<Partial<SolidityHooks>>;
+export default _default;
+//# sourceMappingURL=solidity.d.ts.map

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/solidity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidity.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/hook-handlers/solidity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;8BAqBvC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AAAxD,wBAkHG"}

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/solidity.js

@@ -0,0 +1,89 @@
+import path from "node:path";
+import { addStatementCoverageInstrumentation } from "@ignored/edr-optimism";
+import { assertHardhatInvariant, HardhatError, } from "@nomicfoundation/hardhat-errors";
+import { ensureError } from "@nomicfoundation/hardhat-utils/error";
+import { readUtf8File } from "@nomicfoundation/hardhat-utils/fs";
+import debug from "debug";
+import { CoverageManagerImplementation } from "../coverage-manager.js";
+const log = debug("hardhat:core:coverage:hook-handlers:solidity");
+const COVERAGE_LIBRARY_PATH = "__hardhat_coverage_library_a3e9cfe2-41b4-4a1f-ad9e-ac62dd82979e.sol";
+export default async () => ({
+    preprocessProjectFileBeforeBuilding: async (context, sourceName, fsPath, fileContent, solcVersion, next) => {
+        // NOTE: We do not want to instrument the test project files as we don't
+        // want to report coverage for them.
+        const isTestSource = fsPath.startsWith(context.config.paths.tests.solidity) ||
+            fsPath.endsWith(".t.sol");
+        if (context.globalOptions.coverage && !isTestSource) {
+            try {
+                const { source, metadata } = addStatementCoverageInstrumentation(fileContent, sourceName, solcVersion, COVERAGE_LIBRARY_PATH);
+                // TODO: Remove this once EDR starts returning line information as part
+                // of the metadata.
+                let lineNumber = 1;
+                const lineNumbers = [];
+                for (const character of fileContent) {
+                    lineNumbers.push(lineNumber);
+                    if (character === "\n") {
+                        lineNumber++;
+                    }
+                }
+                const coverageMetadata = [];
+                for (const m of metadata) {
+                    switch (m.kind) {
+                        case "statement":
+                            const relativePath = path.relative(context.config.paths.root, fsPath);
+                            const tag = Buffer.from(m.tag).toString("hex");
+                            const startLine = lineNumbers[m.startUtf16];
+                            const endLine = lineNumbers[m.endUtf16 - 1];
+                            coverageMetadata.push({
+                                relativePath,
+                                tag,
+                                startLine,
+                                endLine,
+                            });
+                            break;
+                        default:
+                            // NOTE: We don't support other kinds of metadata yet; however,
+                            // we don't want to start throwing errors if/when EDR adds support
+                            // for new kinds of coverage metadata.
+                            log("Unsupported coverage metadata kind", m.kind);
+                            break;
+                    }
+                }
+                assertHardhatInvariant("_coverage" in context &&
+                    context._coverage instanceof CoverageManagerImplementation, "Expected _coverage to be defined in the HookContext, as it's should be defined in the HRE");
+                await context._coverage.addMetadata(coverageMetadata);
+                return await next(context, sourceName, fsPath, source, solcVersion);
+            }
+            catch (e) {
+                ensureError(e);
+                // NOTE: These could be raised if the source content we pass to EDR
+                // cannot be parsed with a version of the parser we provided, for example.
+                throw new HardhatError(HardhatError.ERRORS.CORE.COVERAGE.SOURCE_NOT_INSTRUMENTED, {
+                    sourceName,
+                }, e);
+            }
+        }
+        else {
+            return next(context, sourceName, fsPath, fileContent, solcVersion);
+        }
+    },
+    preprocessSolcInputBeforeBuilding: async (context, solcInput, next) => {
+        if (context.globalOptions.coverage) {
+            // NOTE: We check for a source name clash here. It could happen if the user
+            // wanted to compile a source with our highly unlikely name by chance or
+            // if we accidentally tried to preprocess the same solc input twice.
+            if (solcInput.sources[COVERAGE_LIBRARY_PATH] !== undefined) {
+                throw new HardhatError(HardhatError.ERRORS.CORE.COVERAGE.IMPORT_PATH_ALREADY_DEFINED, {
+                    importPath: COVERAGE_LIBRARY_PATH,
+                });
+            }
+            // NOTE: We add the coverage.sol straight into sources here. The alternative
+            // would be to do it during the resolution phase. However, we decided this
+            // is a simpler solution, at least for now.
+            const content = await readUtf8File(path.join(import.meta.dirname, "../../../../../../coverage.sol"));
+            solcInput.sources[COVERAGE_LIBRARY_PATH] = { content };
+        }
+        return next(context, solcInput);
+    },
+});
+//# sourceMappingURL=solidity.js.map

package/dist/src/internal/builtin-plugins/coverage/hook-handlers/solidity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidity.js","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/hook-handlers/solidity.ts"],"names":[],"mappings":"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"}