hardhat 3.1.3 → 3.1.4

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

@@ -0,0 +1,291 @@
+import chalk from "chalk";
+// Use constants for the Uint8Array to improve memory usage (1 byte vs 8 bytes per item)
+const STATUS_NOT_EXECUTED = 0; // equivalent to false
+const STATUS_EXECUTED = 1; // equivalent to true
+const STATUS_IGNORED = 2; // equivalent to null
+/**
+ * Processes the raw EDR coverage information for a file and returns the executed and
+ * non-executed statements and lines.
+ *
+ * @param fileContent The original file content being analyzed
+ * @param metadata Coverage metadata received from EDR for this file
+ * @param hitTags The coverage tags recorded as executed during the test run
+ * for this specific file.
+ *
+ * @returns An object containing:
+ * - statements: the executed and not-executed statements
+ * - lines: the executed and not-executed line numbers
+ */
+export function getProcessedCoverageInfo(fileContent, metadata, hitTags) {
+    const statementsByExecution = partitionStatementsByExecution(metadata, hitTags);
+    const { start, end } = getCoverageBounds(statementsByExecution, fileContent.length);
+    const characterCoverage = buildCharacterCoverage(fileContent, start, end, statementsByExecution.unexecuted);
+    // printStatementsForDebugging(fileContent, statementsByExecution);
+    // printCharacterCoverageForDebugging(fileContent, characterCoverage);
+    return {
+        lines: partitionLinesByExecution(fileContent, characterCoverage),
+    };
+}
+function partitionStatementsByExecution(metadata, hitTags) {
+    const executed = [];
+    const unexecuted = [];
+    for (const node of metadata) {
+        if (hitTags.has(node.tag)) {
+            executed.push(node);
+        }
+        else {
+            unexecuted.push(node);
+        }
+    }
+    return {
+        executed,
+        unexecuted,
+    };
+}
+// Determine the minimum and maximum character indexes that define the range
+// where coverage should be calculated, excluding parts that the tests never
+// reach. This removes irrelevant sections from coverage analysis, such as the
+// beginning or end of each Solidity file.
+// Example:
+// // SPDX-License-Identifier: MIT
+// pragma solidity ^0.8.0;
+function getCoverageBounds(statementsByExecution, fileLength) {
+    let start = fileLength;
+    let end = 0;
+    const { executed, unexecuted } = statementsByExecution;
+    for (const s of [...executed, ...unexecuted]) {
+        if (s.startUtf16 < start) {
+            start = s.startUtf16;
+        }
+        if (s.endUtf16 > end) {
+            end = s.endUtf16;
+        }
+    }
+    return { start, end };
+}
+// Return an array with the same length as the file content. Each position in
+// the array corresponds to a character in the file. The value at each position
+// indicates whether that character was executed during tests (STATUS_EXECUTED),
+// not executed (STATUS_NOT_EXECUTED), or not relevant for coverage
+// (STATUS_IGNORED). STATUS_IGNORED is used to indicate characters that are not
+// executed during test, such as those found at the start or end of every Solidity file.
+// Example:
+// // SPDX-License-Identifier: MIT
+// pragma solidity ^0.8.0;
+function buildCharacterCoverage(fileContent, start, end, unexecutedStatements) {
+    // Use Uint8Array instead of Array<null | boolean> for memory efficiency.
+    // We initialize with STATUS_IGNORED (equivalent to filling with null)
+    const characterCoverage = new Uint8Array(fileContent.length).fill(STATUS_IGNORED);
+    // Initially mark all characters that may be executed during the tests as
+    // STATUS_EXECUTED. They will be set to false later if they are not executed.
+    // The coverage statement received from EDR will provide this information.
+    // Setting everything to true first simplifies the logic for extracting
+    // coverage data. Starting with false and toggling only covered characters
+    // would make statement processing more complex.
+    for (let i = start; i < end; i++) {
+        if (charMustBeIgnored(fileContent[i])) {
+            continue;
+        }
+        characterCoverage[i] = STATUS_EXECUTED;
+    }
+    for (const statement of unexecutedStatements) {
+        for (let i = statement.startUtf16; i < statement.endUtf16; i++) {
+            if (characterCoverage[i] === STATUS_IGNORED) {
+                continue;
+            }
+            characterCoverage[i] = STATUS_NOT_EXECUTED;
+        }
+    }
+    markNonExecutablePatterns(fileContent, characterCoverage);
+    return characterCoverage;
+}
+// The following characters are not relevant for the code coverage, so they
+// must be ignored when marking characters as executed (true) or not executed (false)
+function charMustBeIgnored(char) {
+    const code = char.charCodeAt(0);
+    return (code === 32 || // Space
+        (code >= 9 && code <= 13) || // \t (9), \n (10), \v (11), \f (12), \r (13)
+        code === 123 || // {
+        code === 125 // }
+    );
+}
+// Mark different types of substrings as not relevant for code coverage (set them to STATUS_IGNORED).
+// For example, all "else" substrings or comments are not relevant for code coverage.
+function markNonExecutablePatterns(fileContent, characterCoverage) {
+    // Comments that start with //
+    markMatchingCharsWithIgnored(fileContent, characterCoverage, /\/\/.*?(?=\n|$)/g);
+    // Comments wrapped between /* and */
+    markMatchingCharsWithIgnored(fileContent, characterCoverage, /\/\*[\s\S]*?\*\//g);
+    // Lines containing `else`, since they do not represent executable code by themselves.
+    // Keep in mind that `else` is preceded by a closing brace and followed by an opening brace.
+    // This can span multiple lines.
+    markMatchingCharsWithIgnored(fileContent, characterCoverage, /\}\s*\belse\b\s*\{/g);
+    // Lines containing the function signature. This can span multiple lines
+    markMatchingCharsWithIgnored(fileContent, characterCoverage, /^\s*(function\s+[A-Za-z_$][A-Za-z0-9_$]*\s*\([\s\S]*?\)[^{]*?)(?=\s*\{)/gm);
+    // Lines containing the catch signature. This can span multiple lines.
+    markMatchingCharsWithIgnored(fileContent, characterCoverage, /\bcatch\b(?:\s+[A-Za-z_][A-Za-z0-9_]*)?\s*(?:\([\s\S]*?\))?(?=\s*\{)/g);
+}
+function markMatchingCharsWithIgnored(fileContent, characterCoverage, regex) {
+    for (const match of fileContent.matchAll(regex)) {
+        for (let i = match.index; i < match.index + match[0].length; i++) {
+            characterCoverage[i] = STATUS_IGNORED;
+        }
+    }
+}
+// Generate non overlapping coverage statements. Every character between the start
+// and end indexes is guaranteed to be either executed or not executed.
+// Unlike the statements received from EDR, which may include nested sub
+// statements, these are processed and have no sub statements or overlapping statements.
+// Example:
+// [
+//   { start: 12, end: 20, executed: true  },
+//   { start: 15, end: 17, executed: true }
+// ]
+// ->
+// [
+//   { start: 12, end: 20, executed: true  }
+// ]
+/* eslint-disable-next-line @typescript-eslint/no-unused-vars
+-- currently not used, but it will be used to create more detailed.
+It will be used to return statements from the function `getProcessedCoverageInfo` */
+function getProcessedExecutedStatements(characterCoverage) {
+    const executed = generateProcessedStatements(characterCoverage, STATUS_EXECUTED);
+    const unexecuted = generateProcessedStatements(characterCoverage, STATUS_NOT_EXECUTED);
+    return {
+        executed,
+        unexecuted,
+    };
+}
+// Based on the marked file, where each character is marked as either
+// executed (STATUS_EXECUTED) or not executed (STATUS_NOT_EXECUTED),
+// generate non-overlapping statements that indicate the start and
+// end indices, along with whether they were executed or not.
+function generateProcessedStatements(characterCoverage, targetStatus) {
+    const ranges = [];
+    const fileLength = characterCoverage.length;
+    let start = -1;
+    for (let i = 0; i < fileLength; i++) {
+        if (characterCoverage[i] === targetStatus) {
+            if (start === -1) {
+                start = i; // begin new range
+            }
+        }
+        else {
+            if (start !== -1) {
+                // Map back to boolean for the output object
+                ranges.push({
+                    startUtf16: start,
+                    endUtf16: i - 1,
+                    executed: targetStatus === STATUS_EXECUTED,
+                });
+                start = -1;
+            }
+        }
+    }
+    // close last range if file ends inside a run
+    if (start !== -1) {
+        ranges.push({
+            startUtf16: start,
+            endUtf16: fileLength - 1,
+            executed: targetStatus === STATUS_EXECUTED,
+        });
+    }
+    return ranges;
+}
+// Return the executed and non executed lines based on the marked file.
+// Some lines are excluded from the execution count, for example, comments.
+function partitionLinesByExecution(fileContent, characterCoverage) {
+    const executed = new Map();
+    const unexecuted = new Map();
+    let lineStart = 0;
+    let isLineIgnored = true;
+    let isLineExecutedOrIgnored = true;
+    let lineNumber = 1; // File lines start at 1
+    // Helper to process a line and push to correct map
+    const processLine = (endIndex) => {
+        // Only process if the line isn't entirely ignored
+        if (!isLineIgnored) {
+            const lineText = fileContent.slice(lineStart, endIndex);
+            if (isLineExecutedOrIgnored) {
+                executed.set(lineNumber, lineText);
+            }
+            else {
+                unexecuted.set(lineNumber, lineText);
+            }
+        }
+        // Reset state for the next line
+        lineStart = endIndex + 1;
+        isLineIgnored = true;
+        isLineExecutedOrIgnored = true;
+        lineNumber++;
+    };
+    for (let i = 0; i < fileContent.length; i++) {
+        const char = fileContent[i];
+        const status = characterCoverage[i];
+        if (status !== STATUS_IGNORED) {
+            isLineIgnored = false;
+        }
+        if (status === STATUS_NOT_EXECUTED) {
+            isLineExecutedOrIgnored = false;
+        }
+        if (char === "\n") {
+            processLine(i);
+        }
+    }
+    // Handle the final line if the file doesn't end in a newline
+    if (lineStart < fileContent.length) {
+        processLine(fileContent.length);
+    }
+    return { executed, unexecuted };
+}
+// Enable this function while debugging to display the coverage for a file.
+// The file will be printed with green characters when they are executed,
+// red characters when they are not executed,
+// and gray characters when they are irrelevant for code coverage.
+/* eslint-disable-next-line @typescript-eslint/no-unused-vars
+-- this function can be enabled for debugging purposes */
+function printStatementsForDebugging(fileContent, statementsByExecution) {
+    const relativePath = statementsByExecution.executed.length > 0
+        ? statementsByExecution.executed[0].relativePath
+        : statementsByExecution.unexecuted[0].relativePath;
+    console.debug("Statements for file: " + relativePath);
+    console.debug("Executed statements:");
+    let counter = 0;
+    for (const statement of statementsByExecution.executed) {
+        console.debug(counter++ + " ---");
+        for (let i = statement.startUtf16; i < statement.endUtf16; i++) {
+            process.stdout.write(chalk.gray(fileContent[i]));
+        }
+        console.debug();
+    }
+    console.debug();
+    console.debug("Unexecuted statements:");
+    counter = 0;
+    for (const statement of statementsByExecution.unexecuted) {
+        console.debug(counter++ + " ---");
+        for (let i = statement.startUtf16; i < statement.endUtf16; i++) {
+            process.stdout.write(chalk.gray(fileContent[i]));
+        }
+        console.debug();
+    }
+}
+// Enable this function while debugging to display the coverage for a file.
+// The file will be printed with green characters when they are executed,
+// red characters when they are not executed,
+// and gray characters when they are irrelevant for code coverage.
+/* eslint-disable-next-line @typescript-eslint/no-unused-vars
+-- this function can be enabled for debugging purposes */
+function printCharacterCoverageForDebugging(fileContent, characterCoverage) {
+    for (let i = 0; i < characterCoverage.length; i++) {
+        if (characterCoverage[i] === STATUS_IGNORED) {
+            process.stdout.write(chalk.gray(fileContent[i]));
+        }
+        else if (characterCoverage[i] === STATUS_EXECUTED) {
+            process.stdout.write(chalk.green(fileContent[i]));
+        }
+        else {
+            process.stdout.write(chalk.red(fileContent[i]));
+        }
+    }
+}
+//# sourceMappingURL=process-coverage.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { Report } from "../coverage-manager.js";
+export declare function generateHtmlReport(report: Report, htmlReportPath: string): Promise<void>;
+//# sourceMappingURL=html.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/reports/html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAYrD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/src/internal/builtin-plugins/coverage/reports/html.js

@@ -0,0 +1,37 @@
+import path from "node:path";
+import { mkdir } from "@nomicfoundation/hardhat-utils/fs";
+import { istanbulLibCoverage, istanbulLibReport, istanbulReports, } from "@nomicfoundation/hardhat-vendored/coverage";
+export async function generateHtmlReport(report, htmlReportPath) {
+    const baseDir = process.cwd();
+    const coverageMap = istanbulLibCoverage.createCoverageMap({});
+    await mkdir(htmlReportPath);
+    // Construct coverage data for each tested file,
+    // detailing whether each line was executed or not.
+    for (const [p, coverageInfo] of Object.entries(report)) {
+        const testedFilePath = path.join(baseDir, p);
+        const fc = {
+            path: testedFilePath,
+            statementMap: {},
+            fnMap: {}, // Cannot be derived from current report data
+            branchMap: {}, // Cannot be derived from current report data
+            s: {},
+            f: {}, // Cannot be derived from current report data
+            b: {},
+        };
+        for (const [line, count] of coverageInfo.lineExecutionCounts) {
+            fc.statementMap[line] = {
+                start: { line, column: 0 },
+                end: { line, column: 0 },
+            };
+            // TODO: currently EDR does not provide per-statement coverage counts
+            fc.s[line] = count > 0 ? 1 : 0; // mark as covered if hit at least once
+        }
+        coverageMap.addFileCoverage(fc);
+    }
+    const context = istanbulLibReport.createContext({
+        dir: htmlReportPath,
+        coverageMap,
+    });
+    istanbulReports.create("html", undefined).execute(context);
+}
+//# sourceMappingURL=html.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../../../../src/internal/builtin-plugins/coverage/reports/html.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,4CAA4C,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,cAAsB;IAEtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAE9D,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;IAE5B,gDAAgD;IAChD,mDAAmD;IACnD,KAAK,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAE7C,MAAM,EAAE,GAAqB;YAC3B,IAAI,EAAE,cAAc;YACpB,YAAY,EAAE,EAAE;YAChB,KAAK,EAAE,EAAE,EAAE,6CAA6C;YACxD,SAAS,EAAE,EAAE,EAAE,6CAA6C;YAC5D,CAAC,EAAE,EAAE;YACL,CAAC,EAAE,EAAE,EAAE,6CAA6C;YACpD,CAAC,EAAE,EAAE;SACN,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,mBAAmB,EAAE,CAAC;YAC7D,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG;gBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC1B,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;aACzB,CAAC;YAEF,qEAAqE;YACrE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,uCAAuC;QACzE,CAAC;QAED,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC;QAC9C,GAAG,EAAE,cAAc;QACnB,WAAW;KACZ,CAAC,CAAC;IAEH,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC"}

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

@@ -1,9 +1,14 @@
-export type Tag = string;
+type Tag = string;
 export interface Statement {
     relativePath: string;
     tag: Tag;
-    startLine: number;
-    endLine: number;
+    startUtf16: number;
+    endUtf16: number;
+}
+export interface ReportCoverageStatement {
+    startUtf16: number;
+    endUtf16: number;
+    executed: boolean;
 }
 export type CoverageMetadata = Statement[];
 export type CoverageData = Tag[];
@@ -16,4 +21,5 @@ export interface CoverageManager {
     enableReport(): void;
     disableReport(): void;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/coverage/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AACzB,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,MAAM,gBAAgB,GAAG,SAAS,EAAE,CAAC;AAC3C,MAAM,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC;AACjC,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,MAAM,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,YAAY,IAAI,IAAI,CAAC;IACrB,aAAa,IAAI,IAAI,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/coverage/types.ts"],"names":[],"mappings":"AAAA,KAAK,GAAG,GAAG,MAAM,CAAC;AAClB,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,GAAG,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AACD,MAAM,MAAM,gBAAgB,GAAG,SAAS,EAAE,CAAC;AAC3C,MAAM,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC;AACjC,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,MAAM,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,YAAY,IAAI,IAAI,CAAC;IACrB,aAAa,IAAI,IAAI,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "description": "Hardhat is an extensible developer tool that helps smart contract developers increase productivity by reliably bringing together the tools they want.",
   "homepage": "https://github.com/nomicfoundation/hardhat/tree/v-next/v-next/hardhat",
   "repository": {
@@ -74,6 +74,7 @@
     "@nomicfoundation/edr": "0.12.0-next.22",
     "@nomicfoundation/hardhat-errors": "^3.0.6",
     "@nomicfoundation/hardhat-utils": "^3.0.5",
+    "@nomicfoundation/hardhat-vendored": "^3.0.0",
     "@nomicfoundation/hardhat-zod-utils": "^3.0.1",
     "@nomicfoundation/solidity-analyzer": "^0.1.1",
     "@sentry/core": "^9.4.0",