@diamondslab/diamonds-hardhat-foundry 1.0.1 → 1.0.2

package/dist/framework/HelperGenerator.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelperGenerator = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+/**
+ * HelperGenerator - Generates Solidity helper files for testing
+ */
+class HelperGenerator {
+    hre;
+    constructor(hre) {
+        this.hre = hre;
+    }
+    /**
+     * Scaffold project with initial test structure
+     */
+    async scaffoldProject(outputDir) {
+        const helpersDir = outputDir || this.hre.diamondsFoundry.helpersDir;
+        const basePath = (0, path_1.join)(this.hre.config.paths.root, helpersDir);
+        logger_1.Logger.section("Scaffolding Forge Test Structure");
+        // Create directories
+        logger_1.Logger.step("Creating directories...");
+        (0, fs_1.mkdirSync)(basePath, { recursive: true });
+        (0, fs_1.mkdirSync)((0, path_1.join)(basePath, "../unit"), { recursive: true });
+        (0, fs_1.mkdirSync)((0, path_1.join)(basePath, "../integration"), { recursive: true });
+        (0, fs_1.mkdirSync)((0, path_1.join)(basePath, "../fuzz"), { recursive: true });
+        logger_1.Logger.success(`Test structure created at ${basePath}`);
+    }
+    /**
+     * Generate DiamondDeployment.sol from deployment record
+     */
+    async generateDeploymentHelpers(diamondName, networkName, chainId, deploymentData) {
+        logger_1.Logger.section("Generating Diamond Deployment Helper");
+        const helpersDir = this.hre.diamondsFoundry.helpersDir;
+        const outputPath = (0, path_1.join)(this.hre.config.paths.root, helpersDir, "DiamondDeployment.sol");
+        const content = this.generateLibrarySource(diamondName, networkName, chainId, deploymentData);
+        // Ensure directory exists
+        (0, fs_1.mkdirSync)((0, path_1.join)(this.hre.config.paths.root, helpersDir), {
+            recursive: true,
+        });
+        // Write file
+        (0, fs_1.writeFileSync)(outputPath, content, "utf8");
+        logger_1.Logger.success(`Generated: ${outputPath}`);
+        return outputPath;
+    }
+    /**
+     * Generate example test files
+     */
+    async generateExampleTests() {
+        const generated = [];
+        const examples = this.hre.diamondsFoundry.exampleTests;
+        if (!this.hre.diamondsFoundry.generateExamples) {
+            logger_1.Logger.info("Example generation disabled in config");
+            return generated;
+        }
+        logger_1.Logger.section("Generating Example Tests");
+        const basePath = (0, path_1.join)(this.hre.config.paths.root, "test", "foundry");
+        const templatesPath = (0, path_1.join)(__dirname, "../templates");
+        for (const type of examples) {
+            let templateFile = "";
+            let outputPath = "";
+            switch (type) {
+                case "unit":
+                    templateFile = (0, path_1.join)(templatesPath, "ExampleUnitTest.t.sol.template");
+                    outputPath = (0, path_1.join)(basePath, "unit", "ExampleUnit.t.sol");
+                    break;
+                case "integration":
+                    templateFile = (0, path_1.join)(templatesPath, "ExampleIntegrationTest.t.sol.template");
+                    outputPath = (0, path_1.join)(basePath, "integration", "ExampleIntegration.t.sol");
+                    break;
+                case "fuzz":
+                    templateFile = (0, path_1.join)(templatesPath, "ExampleFuzzTest.t.sol.template");
+                    outputPath = (0, path_1.join)(basePath, "fuzz", "ExampleFuzz.t.sol");
+                    break;
+                default:
+                    logger_1.Logger.warn(`Unknown example type: ${type}`);
+                    continue;
+            }
+            try {
+                // Check if template exists
+                if (!(0, fs_1.existsSync)(templateFile)) {
+                    logger_1.Logger.warn(`Template not found: ${templateFile}`);
+                    continue;
+                }
+                // Read template content
+                const templateContent = (0, fs_1.readFileSync)(templateFile, "utf8");
+                // Ensure output directory exists
+                (0, fs_1.mkdirSync)((0, path_1.join)(basePath, type), { recursive: true });
+                // Check if file already exists
+                if ((0, fs_1.existsSync)(outputPath)) {
+                    logger_1.Logger.info(`Skipping ${type} example (already exists): ${outputPath}`);
+                    continue;
+                }
+                // Write example test file
+                (0, fs_1.writeFileSync)(outputPath, templateContent, "utf8");
+                logger_1.Logger.success(`Generated ${type} example: ${outputPath}`);
+                generated.push(outputPath);
+            }
+            catch (error) {
+                logger_1.Logger.error(`Failed to generate ${type} example: ${error.message}`);
+            }
+        }
+        if (generated.length === 0) {
+            logger_1.Logger.info("No new example tests generated (may already exist)");
+        }
+        return generated;
+    }
+    /**
+     * Generate Solidity library source from deployment data
+     * @private
+     */
+    generateLibrarySource(diamondName, networkName, chainId, deploymentData) {
+        const timestamp = new Date().toISOString();
+        const networkInfo = `${networkName}-${chainId}`;
+        const deploymentFileName = `${diamondName.toLowerCase()}-${networkInfo}.json`;
+        const deploymentFilePath = `diamonds/${diamondName}/deployments/${deploymentFileName}`;
+        let source = "";
+        // SPDX and pragma
+        source += "// SPDX-License-Identifier: MIT\n";
+        source += "pragma solidity ^0.8.19;\n\n";
+        // Header comments
+        source += "/**\n";
+        source += ` * @title DiamondDeployment\n`;
+        source += ` * @notice Auto-generated deployment data for ${diamondName}\n`;
+        source += ` * @dev This library provides constants and helper functions for accessing\n`;
+        source += ` *      deployment data in Forge tests. It is auto-generated from the deployment\n`;
+        source += ` *      record and should not be edited manually.\n`;
+        source += ` *\n`;
+        source += ` * Generated from: ${deploymentFilePath}\n`;
+        source += ` * Generated at: ${timestamp}\n`;
+        source += ` *\n`;
+        source += ` * To regenerate this file:\n`;
+        source += ` *   npx hardhat diamonds-forge:generate-helpers --diamond ${diamondName}\n`;
+        source += ` *\n`;
+        source += ` * ⚠️  DO NOT EDIT MANUALLY - Changes will be overwritten on next generation\n`;
+        source += " */\n";
+        source += "library DiamondDeployment {\n";
+        // Diamond address
+        source += `    /// @notice Address of the deployed ${diamondName} contract\n`;
+        source += `    /// @dev This is the main Diamond proxy address\n`;
+        source += `    address constant DIAMOND_ADDRESS = ${deploymentData.DiamondAddress};\n\n`;
+        // Facet addresses
+        source += "    // ========================================\n";
+        source += "    // Facet Addresses\n";
+        source += "    // ========================================\n\n";
+        const facets = deploymentData.DeployedFacets ?? {};
+        for (const [facetName, facetData] of Object.entries(facets)) {
+            const constantName = facetName
+                .replace(/Facet$/, "")
+                .replace(/([A-Z])/g, "_$1")
+                .toUpperCase()
+                .replace(/^_/, "") + "_FACET";
+            source += `    /// @notice Address of ${facetName} implementation\n`;
+            source += `    address constant ${constantName} = ${facetData.address};\n`;
+        }
+        source += "\n";
+        // Helper functions
+        source += "    // ========================================\n";
+        source += "    // Helper Functions\n";
+        source += "    // ========================================\n\n";
+        source += "    /**\n";
+        source += "     * @notice Get the Diamond contract address\n";
+        source += "     * @return The address of the deployed Diamond proxy\n";
+        source += "     */\n";
+        source += "    function getDiamondAddress() internal pure returns (address) {\n";
+        source += "        return DIAMOND_ADDRESS;\n";
+        source += "    }\n\n";
+        source += "    /**\n";
+        source += "     * @notice Get facet implementation address by name\n";
+        source += "     * @param facetName The name of the facet\n";
+        source += "     * @return The address of the facet implementation\n";
+        source += "     */\n";
+        source += "    function getFacetAddress(string memory facetName) internal pure returns (address) {\n";
+        let firstFacet = true;
+        for (const [facetName, facetData] of Object.entries(facets)) {
+            const constantName = facetName
+                .replace(/Facet$/, "")
+                .replace(/([A-Z])/g, "_$1")
+                .toUpperCase()
+                .replace(/^_/, "") + "_FACET";
+            const condition = firstFacet ? "if" : "else if";
+            source += `        ${condition} (keccak256(bytes(facetName)) == keccak256(bytes("${facetName}"))) {\n`;
+            source += `            return ${constantName};\n`;
+            source += "        }\n";
+            firstFacet = false;
+        }
+        source += "        return address(0);\n";
+        source += "    }\n";
+        source += "}\n";
+        return source;
+    }
+}
+exports.HelperGenerator = HelperGenerator;
+//# sourceMappingURL=HelperGenerator.js.map

package/dist/framework/HelperGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelperGenerator.js","sourceRoot":"","sources":["../../src/framework/HelperGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["import { DeployedDiamondData } from \"@diamondslab/diamonds\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { join } from \"path\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * HelperGenerator - Generates Solidity helper files for testing\n */\nexport class HelperGenerator {\n  constructor(private hre: HardhatRuntimeEnvironment) {}\n\n  /**\n   * Scaffold project with initial test structure\n   */\n  async scaffoldProject(outputDir?: string): Promise<void> {\n    const helpersDir = outputDir || this.hre.diamondsFoundry.helpersDir;\n    const basePath = join(this.hre.config.paths.root, helpersDir);\n\n    Logger.section(\"Scaffolding Forge Test Structure\");\n    \n    // Create directories\n    Logger.step(\"Creating directories...\");\n    mkdirSync(basePath, { recursive: true });\n    mkdirSync(join(basePath, \"../unit\"), { recursive: true });\n    mkdirSync(join(basePath, \"../integration\"), { recursive: true });\n    mkdirSync(join(basePath, \"../fuzz\"), { recursive: true });\n\n    Logger.success(`Test structure created at ${basePath}`);\n  }\n\n  /**\n   * Generate DiamondDeployment.sol from deployment record\n   */\n  async generateDeploymentHelpers(\n    diamondName: string,\n    networkName: string,\n    chainId: number,\n    deploymentData: DeployedDiamondData\n  ): Promise<string> {\n    Logger.section(\"Generating Diamond Deployment Helper\");\n\n    const helpersDir = this.hre.diamondsFoundry.helpersDir;\n    const outputPath = join(\n      this.hre.config.paths.root,\n      helpersDir,\n      \"DiamondDeployment.sol\"\n    );\n\n    const content = this.generateLibrarySource(\n      diamondName,\n      networkName,\n      chainId,\n      deploymentData\n    );\n\n    // Ensure directory exists\n    mkdirSync(join(this.hre.config.paths.root, helpersDir), {\n      recursive: true,\n    });\n\n    // Write file\n    writeFileSync(outputPath, content, \"utf8\");\n\n    Logger.success(`Generated: ${outputPath}`);\n    return outputPath;\n  }\n\n  /**\n   * Generate example test files\n   */\n  async generateExampleTests(): Promise<string[]> {\n    const generated: string[] = [];\n    const examples = this.hre.diamondsFoundry.exampleTests;\n\n    if (!this.hre.diamondsFoundry.generateExamples) {\n      Logger.info(\"Example generation disabled in config\");\n      return generated;\n    }\n\n    Logger.section(\"Generating Example Tests\");\n\n    const basePath = join(this.hre.config.paths.root, \"test\", \"foundry\");\n    const templatesPath = join(__dirname, \"../templates\");\n\n    for (const type of examples) {\n      let templateFile = \"\";\n      let outputPath = \"\";\n\n      switch (type) {\n        case \"unit\":\n          templateFile = join(templatesPath, \"ExampleUnitTest.t.sol.template\");\n          outputPath = join(basePath, \"unit\", \"ExampleUnit.t.sol\");\n          break;\n        case \"integration\":\n          templateFile = join(templatesPath, \"ExampleIntegrationTest.t.sol.template\");\n          outputPath = join(basePath, \"integration\", \"ExampleIntegration.t.sol\");\n          break;\n        case \"fuzz\":\n          templateFile = join(templatesPath, \"ExampleFuzzTest.t.sol.template\");\n          outputPath = join(basePath, \"fuzz\", \"ExampleFuzz.t.sol\");\n          break;\n        default:\n          Logger.warn(`Unknown example type: ${type}`);\n          continue;\n      }\n\n      try {\n        // Check if template exists\n        if (!existsSync(templateFile)) {\n          Logger.warn(`Template not found: ${templateFile}`);\n          continue;\n        }\n\n        // Read template content\n        const templateContent = readFileSync(templateFile, \"utf8\");\n\n        // Ensure output directory exists\n        mkdirSync(join(basePath, type), { recursive: true });\n\n        // Check if file already exists\n        if (existsSync(outputPath)) {\n          Logger.info(`Skipping ${type} example (already exists): ${outputPath}`);\n          continue;\n        }\n\n        // Write example test file\n        writeFileSync(outputPath, templateContent, \"utf8\");\n        Logger.success(`Generated ${type} example: ${outputPath}`);\n        generated.push(outputPath);\n      } catch (error: any) {\n        Logger.error(`Failed to generate ${type} example: ${error.message}`);\n      }\n    }\n\n    if (generated.length === 0) {\n      Logger.info(\"No new example tests generated (may already exist)\");\n    }\n\n    return generated;\n  }\n\n  /**\n   * Generate Solidity library source from deployment data\n   * @private\n   */\n  private generateLibrarySource(\n    diamondName: string,\n    networkName: string,\n    chainId: number,\n    deploymentData: DeployedDiamondData\n  ): string {\n    const timestamp = new Date().toISOString();\n    const networkInfo = `${networkName}-${chainId}`;\n    const deploymentFileName = `${diamondName.toLowerCase()}-${networkInfo}.json`;\n    const deploymentFilePath = `diamonds/${diamondName}/deployments/${deploymentFileName}`;\n\n    let source = \"\";\n\n    // SPDX and pragma\n    source += \"// SPDX-License-Identifier: MIT\\n\";\n    source += \"pragma solidity ^0.8.19;\\n\\n\";\n\n    // Header comments\n    source += \"/**\\n\";\n    source += ` * @title DiamondDeployment\\n`;\n    source += ` * @notice Auto-generated deployment data for ${diamondName}\\n`;\n    source += ` * @dev This library provides constants and helper functions for accessing\\n`;\n    source += ` *      deployment data in Forge tests. It is auto-generated from the deployment\\n`;\n    source += ` *      record and should not be edited manually.\\n`;\n    source += ` *\\n`;\n    source += ` * Generated from: ${deploymentFilePath}\\n`;\n    source += ` * Generated at: ${timestamp}\\n`;\n    source += ` *\\n`;\n    source += ` * To regenerate this file:\\n`;\n    source += ` *   npx hardhat diamonds-forge:generate-helpers --diamond ${diamondName}\\n`;\n    source += ` *\\n`;\n    source += ` * ⚠️  DO NOT EDIT MANUALLY - Changes will be overwritten on next generation\\n`;\n    source += \" */\\n\";\n    source += \"library DiamondDeployment {\\n\";\n\n    // Diamond address\n    source += `    /// @notice Address of the deployed ${diamondName} contract\\n`;\n    source += `    /// @dev This is the main Diamond proxy address\\n`;\n    source += `    address constant DIAMOND_ADDRESS = ${deploymentData.DiamondAddress};\\n\\n`;\n\n    // Facet addresses\n    source += \"    // ========================================\\n\";\n    source += \"    // Facet Addresses\\n\";\n    source += \"    // ========================================\\n\\n\";\n\n    const facets = deploymentData.DeployedFacets ?? {};\n    for (const [facetName, facetData] of Object.entries(facets)) {\n      const constantName = facetName\n        .replace(/Facet$/, \"\")\n        .replace(/([A-Z])/g, \"_$1\")\n        .toUpperCase()\n        .replace(/^_/, \"\") + \"_FACET\";\n\n      source += `    /// @notice Address of ${facetName} implementation\\n`;\n      source += `    address constant ${constantName} = ${facetData.address};\\n`;\n    }\n    source += \"\\n\";\n\n    // Helper functions\n    source += \"    // ========================================\\n\";\n    source += \"    // Helper Functions\\n\";\n    source += \"    // ========================================\\n\\n\";\n\n    source += \"    /**\\n\";\n    source += \"     * @notice Get the Diamond contract address\\n\";\n    source += \"     * @return The address of the deployed Diamond proxy\\n\";\n    source += \"     */\\n\";\n    source += \"    function getDiamondAddress() internal pure returns (address) {\\n\";\n    source += \"        return DIAMOND_ADDRESS;\\n\";\n    source += \"    }\\n\\n\";\n\n    source += \"    /**\\n\";\n    source += \"     * @notice Get facet implementation address by name\\n\";\n    source += \"     * @param facetName The name of the facet\\n\";\n    source += \"     * @return The address of the facet implementation\\n\";\n    source += \"     */\\n\";\n    source += \"    function getFacetAddress(string memory facetName) internal pure returns (address) {\\n\";\n\n    let firstFacet = true;\n    for (const [facetName, facetData] of Object.entries(facets)) {\n      const constantName = facetName\n        .replace(/Facet$/, \"\")\n        .replace(/([A-Z])/g, \"_$1\")\n        .toUpperCase()\n        .replace(/^_/, \"\") + \"_FACET\";\n\n      const condition = firstFacet ? \"if\" : \"else if\";\n      source += `        ${condition} (keccak256(bytes(facetName)) == keccak256(bytes(\"${facetName}\"))) {\\n`;\n      source += `            return ${constantName};\\n`;\n      source += \"        }\\n\";\n      firstFacet = false;\n    }\n    source += \"        return address(0);\\n\";\n    source += \"    }\\n\";\n\n    source += \"}\\n\";\n\n    return source;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import "./tasks/deploy";
+import "./tasks/generate-helpers";
+import "./tasks/init";
+import "./tasks/test";
+import "./types/hardhat";
+export { DeploymentManager } from "./framework/DeploymentManager";
+export { ForgeFuzzingFramework } from "./framework/ForgeFuzzingFramework";
+export { HelperGenerator } from "./framework/HelperGenerator";
+export * from "./types/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,CAAC;AACxB,OAAO,0BAA0B,CAAC;AAClC,OAAO,cAAc,CAAC;AACtB,OAAO,cAAc,CAAC;AACtB,OAAO,iBAAiB,CAAC;AAmBzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,cAAc,gBAAgB,CAAC"}

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { extendConfig, extendEnvironment, internalTask, task } from \"hardhat/config\";\nimport \"./tasks/deploy\";\nimport \"./tasks/generate-helpers\";\nimport \"./tasks/init\";\nimport \"./tasks/test\";\nimport \"./types/hardhat\";\n\nimport { existsSync, writeFileSync } from \"fs\";\nimport {\n  TASK_COMPILE_GET_REMAPPINGS,\n  TASK_COMPILE_TRANSFORM_IMPORT_NAME,\n} from \"hardhat/builtin-tasks/task-names\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport path from \"path\";\nimport picocolors from \"picocolors\";\nimport {\n  getForgeConfig,\n  getRemappings,\n  HardhatFoundryError,\n  installDependency,\n} from \"./foundry\";\nimport { validateConfig } from \"./utils/validation\";\n\n// Export framework classes for programmatic use\nexport { DeploymentManager } from \"./framework/DeploymentManager\";\nexport { ForgeFuzzingFramework } from \"./framework/ForgeFuzzingFramework\";\nexport { HelperGenerator } from \"./framework/HelperGenerator\";\n\n// Export types\nexport * from \"./types/config\";\n\nconst TASK_INIT_FOUNDRY = \"init-foundry\";\n\nlet pluginActivated = false;\n\n// Extend config with diamondsFoundry settings\nextendConfig((config, userConfig) => {\n  // Validate and set diamondsFoundry config\n  config.diamondsFoundry = validateConfig(userConfig.diamondsFoundry);\n\n  // Check foundry.toml presence. Don't warn when running foundry initialization task\n  if (!existsSync(path.join(config.paths.root, \"foundry.toml\"))) {\n    if (!process.argv.includes(TASK_INIT_FOUNDRY)) {\n      console.log(\n        picocolors.yellow(\n          `Warning: You are using the diamonds-hardhat-foundry plugin but there isn't a foundry.toml file in your project. Run 'npx hardhat ${TASK_INIT_FOUNDRY}' to create one.`\n        )\n      );\n    }\n    return;\n  }\n\n  // Load foundry config\n  const foundryConfig = getForgeConfig();\n\n  // Ensure required keys exist\n  if (\n    foundryConfig?.src === undefined ||\n    foundryConfig?.cache_path === undefined\n  ) {\n    throw new HardhatFoundryError(\n      \"Couldn't find `src` or `cache_path` config keys after running `forge config --json`\"\n    );\n  }\n\n  // Ensure foundry src path doesn't mismatch user-configured path\n  const userSourcesPath = userConfig.paths?.sources;\n  const foundrySourcesPath = foundryConfig.src;\n\n  if (\n    userSourcesPath !== undefined &&\n    path.resolve(userSourcesPath) !== path.resolve(foundrySourcesPath)\n  ) {\n    throw new HardhatFoundryError(\n      `User-configured sources path (${userSourcesPath}) doesn't match path configured in foundry (${foundrySourcesPath})`\n    );\n  }\n\n  // Set sources path\n  config.paths.sources = path.resolve(config.paths.root, foundrySourcesPath);\n\n  // Change hardhat's cache path if it clashes with foundry's\n  const foundryCachePath = path.resolve(\n    config.paths.root,\n    foundryConfig.cache_path\n  );\n  if (config.paths.cache === foundryCachePath) {\n    config.paths.cache = \"cache_hardhat\";\n  }\n\n  pluginActivated = true;\n});\n\n// Extend environment to add diamondsFoundry config to HRE\nextendEnvironment((hre: HardhatRuntimeEnvironment) => {\n  hre.diamondsFoundry = hre.config.diamondsFoundry;\n});\n\n// This task is in place to detect old hardhat-core versions\ninternalTask(TASK_COMPILE_TRANSFORM_IMPORT_NAME).setAction(\n  async (\n    {\n      importName,\n      deprecationCheck,\n    }: { importName: string; deprecationCheck: boolean },\n    _hre\n  ): Promise<string> => {\n    // When the deprecationCheck param is passed, it means a new enough hardhat-core is being used\n    if (deprecationCheck) {\n      return importName;\n    }\n    throw new HardhatFoundryError(\n      \"This version of diamonds-hardhat-foundry depends on hardhat version >= 2.17.2\"\n    );\n  }\n);\n\ninternalTask(TASK_COMPILE_GET_REMAPPINGS).setAction(\n  async (): Promise<Record<string, string>> => {\n    if (!pluginActivated) {\n      return {};\n    }\n\n    return getRemappings();\n  }\n);\n\ntask(\n  TASK_INIT_FOUNDRY,\n  \"Initialize foundry setup in current hardhat project\",\n  async (_, hre: HardhatRuntimeEnvironment) => {\n    const foundryConfigPath = path.resolve(\n      hre.config.paths.root,\n      \"foundry.toml\"\n    );\n\n    if (existsSync(foundryConfigPath)) {\n      console.warn(\n        picocolors.yellow(`File foundry.toml already exists. Aborting.`)\n      );\n      process.exit(1);\n    }\n\n    console.log(`Creating foundry.toml file...`);\n\n    writeFileSync(\n      foundryConfigPath,\n      [\n        `[profile.default]`,\n        `src = '${path.relative(\n          hre.config.paths.root,\n          hre.config.paths.sources\n        )}'`,\n        `out = 'out'`,\n        `libs = ['node_modules', 'lib']`,\n        `test = '${path.relative(\n          hre.config.paths.root,\n          hre.config.paths.tests\n        )}'`,\n        `cache_path  = 'cache_forge'`,\n      ].join(\"\\n\")\n    );\n\n    await installDependency(\"foundry-rs/forge-std\");\n  }\n);\n"]}

package/dist/tasks/deploy.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deploy.d.ts.map

package/dist/tasks/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/tasks/deploy.ts"],"names":[],"mappings":""}

package/dist/tasks/deploy.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("hardhat/config");
+const DeploymentManager_1 = require("../framework/DeploymentManager");
+const logger_1 = require("../utils/logger");
+const validation_1 = require("../utils/validation");
+/**
+ * Task: diamonds-forge:deploy
+ *
+ * Deploys a Diamond contract for Forge testing.
+ * - Validates Foundry installation
+ * - Deploys Diamond using LocalDiamondDeployer
+ * - Saves deployment record
+ * - Optionally reuses existing deployment
+ *
+ * Use Hardhat's built-in --network flag to specify the network
+ */
+(0, config_1.task)("diamonds-forge:deploy", "Deploy Diamond contract for Forge testing")
+    .addOptionalParam("diamondName", "Name of the Diamond to deploy", "ExampleDiamond", config_1.types.string)
+    .addFlag("reuse", "Reuse existing deployment if available")
+    .addFlag("force", "Force redeployment even if deployment exists")
+    .setAction(async (taskArgs, hre) => {
+    logger_1.Logger.section("Deploying Diamond for Forge Testing");
+    // Use Hardhat's built-in network name from HRE
+    const networkName = hre.network.name;
+    const diamondName = taskArgs.diamondName;
+    const reuse = taskArgs.reuse;
+    const force = taskArgs.force;
+    // Validate flags
+    if (reuse && force) {
+        logger_1.Logger.error("Cannot use both --reuse and --force flags");
+        throw new Error("Conflicting flags: --reuse and --force");
+    }
+    logger_1.Logger.info(`Diamond: ${diamondName}`);
+    logger_1.Logger.info(`Network: ${networkName}`);
+    logger_1.Logger.info(`Mode: ${force ? "force deploy" : reuse ? "reuse if exists" : "deploy new"}`);
+    // Step 1: Validate Foundry (optional for deployment, but recommended)
+    logger_1.Logger.step("Checking Foundry installation...");
+    const foundryInstalled = (0, validation_1.validateFoundryInstallation)();
+    if (!foundryInstalled) {
+        logger_1.Logger.warn("Foundry is not installed");
+        logger_1.Logger.warn("You'll need it to run tests later");
+    }
+    else {
+        logger_1.Logger.success("Foundry is installed");
+    }
+    // Step 2: Deploy or reuse Diamond
+    logger_1.Logger.step("Deploying Diamond contract...");
+    const deploymentManager = new DeploymentManager_1.DeploymentManager(hre);
+    try {
+        let diamond;
+        if (reuse) {
+            // Try to reuse, deploy if not exists
+            diamond = await deploymentManager.ensureDeployment(diamondName, networkName, false);
+        }
+        else {
+            // Deploy (force if flag is set)
+            diamond = await deploymentManager.deploy(diamondName, networkName, force);
+        }
+        // Step 3: Display deployment info
+        const deploymentData = diamond.getDeployedDiamondData();
+        logger_1.Logger.section("Deployment Summary");
+        logger_1.Logger.success(`Diamond Address: ${deploymentData.DiamondAddress}`);
+        logger_1.Logger.info(`Deployer Address: ${deploymentData.DeployerAddress}`);
+        const facetCount = Object.keys(deploymentData.DeployedFacets || {}).length;
+        logger_1.Logger.info(`Facets Deployed: ${facetCount}`);
+        if (facetCount > 0) {
+            logger_1.Logger.info("\nDeployed Facets:");
+            for (const [name, facet] of Object.entries(deploymentData.DeployedFacets || {})) {
+                logger_1.Logger.info(`  - ${name}: ${facet.address}`);
+            }
+        }
+        logger_1.Logger.section("Next Steps");
+        logger_1.Logger.info("Generate helpers: npx hardhat diamonds-forge:generate-helpers");
+        logger_1.Logger.info("Run tests: npx hardhat diamonds-forge:test");
+    }
+    catch (error) {
+        logger_1.Logger.error(`Deployment failed: ${error.message}`);
+        throw error;
+    }
+});
+//# sourceMappingURL=deploy.js.map

package/dist/tasks/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/tasks/deploy.ts"],"names":[],"mappings":"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","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { DeploymentManager } from \"../framework/DeploymentManager\";\nimport { Logger } from \"../utils/logger\";\nimport { validateFoundryInstallation } from \"../utils/validation\";\n\n/**\n * Task: diamonds-forge:deploy\n * \n * Deploys a Diamond contract for Forge testing.\n * - Validates Foundry installation\n * - Deploys Diamond using LocalDiamondDeployer\n * - Saves deployment record\n * - Optionally reuses existing deployment\n * \n * Use Hardhat's built-in --network flag to specify the network\n */\ntask(\"diamonds-forge:deploy\", \"Deploy Diamond contract for Forge testing\")\n  .addOptionalParam(\n    \"diamondName\",\n    \"Name of the Diamond to deploy\",\n    \"ExampleDiamond\",\n    types.string\n  )\n  .addFlag(\"reuse\", \"Reuse existing deployment if available\")\n  .addFlag(\"force\", \"Force redeployment even if deployment exists\")\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Deploying Diamond for Forge Testing\");\n\n    // Use Hardhat's built-in network name from HRE\n    const networkName = hre.network.name;\n    const diamondName = taskArgs.diamondName;\n    const reuse = taskArgs.reuse;\n    const force = taskArgs.force;\n\n    // Validate flags\n    if (reuse && force) {\n      Logger.error(\"Cannot use both --reuse and --force flags\");\n      throw new Error(\"Conflicting flags: --reuse and --force\");\n    }\n\n    Logger.info(`Diamond: ${diamondName}`);\n    Logger.info(`Network: ${networkName}`);\n    Logger.info(`Mode: ${force ? \"force deploy\" : reuse ? \"reuse if exists\" : \"deploy new\"}`);\n\n    // Step 1: Validate Foundry (optional for deployment, but recommended)\n    Logger.step(\"Checking Foundry installation...\");\n    const foundryInstalled = validateFoundryInstallation();\n    \n    if (!foundryInstalled) {\n      Logger.warn(\"Foundry is not installed\");\n      Logger.warn(\"You'll need it to run tests later\");\n    } else {\n      Logger.success(\"Foundry is installed\");\n    }\n\n    // Step 2: Deploy or reuse Diamond\n    Logger.step(\"Deploying Diamond contract...\");\n    const deploymentManager = new DeploymentManager(hre);\n\n    try {\n      let diamond;\n      \n      if (reuse) {\n        // Try to reuse, deploy if not exists\n        diamond = await deploymentManager.ensureDeployment(\n          diamondName,\n          networkName,\n          false\n        );\n      } else {\n        // Deploy (force if flag is set)\n        diamond = await deploymentManager.deploy(\n          diamondName,\n          networkName,\n          force\n        );\n      }\n\n      // Step 3: Display deployment info\n      const deploymentData = diamond.getDeployedDiamondData();\n      \n      Logger.section(\"Deployment Summary\");\n      Logger.success(`Diamond Address: ${deploymentData.DiamondAddress}`);\n      Logger.info(`Deployer Address: ${deploymentData.DeployerAddress}`);\n      \n      const facetCount = Object.keys(deploymentData.DeployedFacets || {}).length;\n      Logger.info(`Facets Deployed: ${facetCount}`);\n      \n      if (facetCount > 0) {\n        Logger.info(\"\\nDeployed Facets:\");\n        for (const [name, facet] of Object.entries(deploymentData.DeployedFacets || {})) {\n          Logger.info(`  - ${name}: ${facet.address}`);\n        }\n      }\n\n      Logger.section(\"Next Steps\");\n      Logger.info(\"Generate helpers: npx hardhat diamonds-forge:generate-helpers\");\n      Logger.info(\"Run tests: npx hardhat diamonds-forge:test\");\n\n    } catch (error: any) {\n      Logger.error(`Deployment failed: ${error.message}`);\n      throw error;\n    }\n  });\n\n\n"]}

package/dist/tasks/generate-helpers.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate-helpers.d.ts.map

package/dist/tasks/generate-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-helpers.d.ts","sourceRoot":"","sources":["../../src/tasks/generate-helpers.ts"],"names":[],"mappings":""}

package/dist/tasks/generate-helpers.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("hardhat/config");
+const DeploymentManager_1 = require("../framework/DeploymentManager");
+const HelperGenerator_1 = require("../framework/HelperGenerator");
+const logger_1 = require("../utils/logger");
+/**
+ * Task: diamonds-forge:generate-helpers
+ *
+ * Generates Solidity helper files from Diamond deployment data.
+ * - Reads deployment record
+ * - Generates DiamondDeployment.sol library
+ * - Creates constants for addresses and facets
+ *
+ * Use Hardhat's built-in --network flag to specify the network
+ */
+(0, config_1.task)("diamonds-forge:generate-helpers", "Generate Solidity helpers from Diamond deployment")
+    .addOptionalParam("diamondName", "Name of the deployed Diamond", "ExampleDiamond", config_1.types.string)
+    .addOptionalParam("outputDir", "Directory for generated helper files", undefined, config_1.types.string)
+    .setAction(async (taskArgs, hre) => {
+    logger_1.Logger.section("Generating Diamond Deployment Helpers");
+    const diamondName = taskArgs.diamondName;
+    // Use Hardhat's built-in network name from HRE
+    const networkName = hre.network.name;
+    const outputDir = taskArgs.outputDir || hre.diamondsFoundry.helpersDir;
+    logger_1.Logger.info(`Diamond: ${diamondName}`);
+    logger_1.Logger.info(`Network: ${networkName}`);
+    logger_1.Logger.info(`Output: ${outputDir}`);
+    // Step 1: Get deployment
+    logger_1.Logger.step("Loading deployment data...");
+    const deploymentManager = new DeploymentManager_1.DeploymentManager(hre);
+    try {
+        const diamond = await deploymentManager.getDeployment(diamondName, networkName);
+        if (!diamond) {
+            logger_1.Logger.error("No deployment found");
+            logger_1.Logger.info(`Deploy first: npx hardhat diamonds-forge:deploy --diamond-name ${diamondName} --network ${networkName}`);
+            throw new Error("Deployment not found");
+        }
+        logger_1.Logger.success("Deployment loaded");
+        // Step 2: Get network info for chainId
+        const provider = hre.ethers.provider;
+        const network = await provider.getNetwork();
+        const chainId = Number(network.chainId);
+        // Step 3: Generate helpers
+        logger_1.Logger.step("Generating Solidity helpers...");
+        const generator = new HelperGenerator_1.HelperGenerator(hre);
+        const deploymentData = diamond.getDeployedDiamondData();
+        const helperPath = await generator.generateDeploymentHelpers(diamondName, networkName, chainId, deploymentData);
+        // Step 4: Summary
+        logger_1.Logger.section("Helper Generation Complete");
+        logger_1.Logger.success(`Generated: ${helperPath}`);
+        const facetCount = Object.keys(deploymentData.DeployedFacets || {}).length;
+        logger_1.Logger.info(`Diamond Address: ${deploymentData.DiamondAddress}`);
+        logger_1.Logger.info(`Facets Included: ${facetCount}`);
+        logger_1.Logger.section("Next Steps");
+        logger_1.Logger.info("Import in your test files:");
+        logger_1.Logger.info(`  import "../../helpers/DiamondDeployment.sol";`);
+        logger_1.Logger.info("\nRun tests:");
+        logger_1.Logger.info(`  npx hardhat diamonds-forge:test`);
+    }
+    catch (error) {
+        logger_1.Logger.error(`Helper generation failed: ${error.message}`);
+        throw error;
+    }
+});
+//# sourceMappingURL=generate-helpers.js.map

package/dist/tasks/generate-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-helpers.js","sourceRoot":"","sources":["../../src/tasks/generate-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { DeploymentManager } from \"../framework/DeploymentManager\";\nimport { HelperGenerator } from \"../framework/HelperGenerator\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * Task: diamonds-forge:generate-helpers\n * \n * Generates Solidity helper files from Diamond deployment data.\n * - Reads deployment record\n * - Generates DiamondDeployment.sol library\n * - Creates constants for addresses and facets\n * \n * Use Hardhat's built-in --network flag to specify the network\n */\ntask(\"diamonds-forge:generate-helpers\", \"Generate Solidity helpers from Diamond deployment\")\n  .addOptionalParam(\n    \"diamondName\",\n    \"Name of the deployed Diamond\",\n    \"ExampleDiamond\",\n    types.string\n  )\n  .addOptionalParam(\n    \"outputDir\",\n    \"Directory for generated helper files\",\n    undefined,\n    types.string\n  )\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Generating Diamond Deployment Helpers\");\n\n    const diamondName = taskArgs.diamondName;\n    // Use Hardhat's built-in network name from HRE\n    const networkName = hre.network.name;\n    const outputDir = taskArgs.outputDir || hre.diamondsFoundry.helpersDir;\n\n    Logger.info(`Diamond: ${diamondName}`);\n    Logger.info(`Network: ${networkName}`);\n    Logger.info(`Output: ${outputDir}`);\n\n    // Step 1: Get deployment\n    Logger.step(\"Loading deployment data...\");\n    const deploymentManager = new DeploymentManager(hre);\n    \n    try {\n      const diamond = await deploymentManager.getDeployment(\n        diamondName,\n        networkName\n      );\n\n      if (!diamond) {\n        Logger.error(\"No deployment found\");\n        Logger.info(`Deploy first: npx hardhat diamonds-forge:deploy --diamond-name ${diamondName} --network ${networkName}`);\n        throw new Error(\"Deployment not found\");\n      }\n\n      Logger.success(\"Deployment loaded\");\n\n      // Step 2: Get network info for chainId\n      const provider = hre.ethers.provider;\n      const network = await provider.getNetwork();\n      const chainId = Number(network.chainId);\n\n      // Step 3: Generate helpers\n      Logger.step(\"Generating Solidity helpers...\");\n      const generator = new HelperGenerator(hre);\n      \n      const deploymentData = diamond.getDeployedDiamondData();\n      \n      const helperPath = await generator.generateDeploymentHelpers(\n        diamondName,\n        networkName,\n        chainId,\n        deploymentData\n      );\n\n      // Step 4: Summary\n      Logger.section(\"Helper Generation Complete\");\n      Logger.success(`Generated: ${helperPath}`);\n      \n      const facetCount = Object.keys(deploymentData.DeployedFacets || {}).length;\n      Logger.info(`Diamond Address: ${deploymentData.DiamondAddress}`);\n      Logger.info(`Facets Included: ${facetCount}`);\n\n      Logger.section(\"Next Steps\");\n      Logger.info(\"Import in your test files:\");\n      Logger.info(`  import \"../../helpers/DiamondDeployment.sol\";`);\n      Logger.info(\"\\nRun tests:\");\n      Logger.info(`  npx hardhat diamonds-forge:test`);\n\n    } catch (error: any) {\n      Logger.error(`Helper generation failed: ${error.message}`);\n      throw error;\n    }\n  });\n\n\n"]}

package/dist/tasks/init.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/tasks/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/tasks/init.ts"],"names":[],"mappings":""}

package/dist/tasks/init.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("hardhat/config");
+const HelperGenerator_1 = require("../framework/HelperGenerator");
+const logger_1 = require("../utils/logger");
+const validation_1 = require("../utils/validation");
+/**
+ * Task: diamonds-forge:init
+ *
+ * Initializes the project for Forge testing with Diamond contracts.
+ * - Validates configuration
+ * - Checks Foundry installation
+ * - Scaffolds test directory structure
+ * - Optionally generates example tests
+ */
+(0, config_1.task)("diamonds-forge:init", "Initialize Forge testing structure for Diamond contracts")
+    .addOptionalParam("helpersDir", "Directory for generated helper files", undefined, config_1.types.string)
+    .addFlag("examples", "Generate example test files")
+    .addFlag("force", "Overwrite existing files")
+    .setAction(async (taskArgs, hre) => {
+    logger_1.Logger.section("Initializing Diamonds-Forge Testing");
+    // Step 1: Validate configuration
+    logger_1.Logger.step("Validating configuration...");
+    const config = (0, validation_1.validateConfig)(hre.diamondsFoundry);
+    // Override with task args if provided
+    const helpersDir = taskArgs.helpersDir || config.helpersDir;
+    const generateExamples = taskArgs.examples || config.generateExamples;
+    logger_1.Logger.info(`Helpers directory: ${helpersDir}`);
+    logger_1.Logger.info(`Generate examples: ${generateExamples}`);
+    // Step 2: Check Foundry installation
+    logger_1.Logger.step("Checking Foundry installation...");
+    const foundryInstalled = (0, validation_1.validateFoundryInstallation)();
+    if (!foundryInstalled) {
+        logger_1.Logger.warn("Foundry is not installed or not in PATH");
+        logger_1.Logger.warn("Install from: https://book.getfoundry.sh/getting-started/installation");
+        logger_1.Logger.warn("Continuing anyway...");
+    }
+    else {
+        logger_1.Logger.success("Foundry is installed");
+    }
+    // Step 3: Scaffold project structure
+    logger_1.Logger.step("Creating test directory structure...");
+    const generator = new HelperGenerator_1.HelperGenerator(hre);
+    try {
+        await generator.scaffoldProject(helpersDir);
+        logger_1.Logger.success("Directory structure created");
+    }
+    catch (error) {
+        logger_1.Logger.error(`Failed to scaffold project: ${error.message}`);
+        throw error;
+    }
+    // Step 4: Generate example tests if requested
+    if (generateExamples) {
+        logger_1.Logger.step("Generating example test files...");
+        try {
+            const examplePaths = await generator.generateExampleTests();
+            if (examplePaths.length > 0) {
+                logger_1.Logger.success(`Generated ${examplePaths.length} example test(s)`);
+                examplePaths.forEach((path) => logger_1.Logger.info(`  - ${path}`));
+            }
+            else {
+                logger_1.Logger.info("No example tests generated (implementation pending)");
+            }
+        }
+        catch (error) {
+            logger_1.Logger.error(`Failed to generate examples: ${error.message}`);
+            throw error;
+        }
+    }
+    // Step 5: Summary
+    logger_1.Logger.section("Initialization Complete");
+    logger_1.Logger.success("Your project is ready for Forge testing!");
+    logger_1.Logger.info("\nNext steps:");
+    logger_1.Logger.info("  1. Deploy your Diamond: npx hardhat diamonds-forge:deploy");
+    logger_1.Logger.info("  2. Generate helpers: npx hardhat diamonds-forge:generate-helpers");
+    logger_1.Logger.info("  3. Run tests: npx hardhat diamonds-forge:test");
+});
+//# sourceMappingURL=init.js.map

package/dist/tasks/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/tasks/init.ts"],"names":[],"mappings":"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","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { HelperGenerator } from \"../framework/HelperGenerator\";\nimport { Logger } from \"../utils/logger\";\nimport { validateConfig, validateFoundryInstallation } from \"../utils/validation\";\n\n/**\n * Task: diamonds-forge:init\n * \n * Initializes the project for Forge testing with Diamond contracts.\n * - Validates configuration\n * - Checks Foundry installation\n * - Scaffolds test directory structure\n * - Optionally generates example tests\n */\ntask(\"diamonds-forge:init\", \"Initialize Forge testing structure for Diamond contracts\")\n  .addOptionalParam(\n    \"helpersDir\",\n    \"Directory for generated helper files\",\n    undefined,\n    types.string\n  )\n  .addFlag(\"examples\", \"Generate example test files\")\n  .addFlag(\"force\", \"Overwrite existing files\")\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Initializing Diamonds-Forge Testing\");\n\n    // Step 1: Validate configuration\n    Logger.step(\"Validating configuration...\");\n    const config = validateConfig(hre.diamondsFoundry);\n    \n    // Override with task args if provided\n    const helpersDir = taskArgs.helpersDir || config.helpersDir;\n    const generateExamples = taskArgs.examples || config.generateExamples;\n\n    Logger.info(`Helpers directory: ${helpersDir}`);\n    Logger.info(`Generate examples: ${generateExamples}`);\n\n    // Step 2: Check Foundry installation\n    Logger.step(\"Checking Foundry installation...\");\n    const foundryInstalled = validateFoundryInstallation();\n    \n    if (!foundryInstalled) {\n      Logger.warn(\"Foundry is not installed or not in PATH\");\n      Logger.warn(\"Install from: https://book.getfoundry.sh/getting-started/installation\");\n      Logger.warn(\"Continuing anyway...\");\n    } else {\n      Logger.success(\"Foundry is installed\");\n    }\n\n    // Step 3: Scaffold project structure\n    Logger.step(\"Creating test directory structure...\");\n    const generator = new HelperGenerator(hre);\n    \n    try {\n      await generator.scaffoldProject(helpersDir);\n      Logger.success(\"Directory structure created\");\n    } catch (error: any) {\n      Logger.error(`Failed to scaffold project: ${error.message}`);\n      throw error;\n    }\n\n    // Step 4: Generate example tests if requested\n    if (generateExamples) {\n      Logger.step(\"Generating example test files...\");\n      try {\n        const examplePaths = await generator.generateExampleTests();\n        \n        if (examplePaths.length > 0) {\n          Logger.success(`Generated ${examplePaths.length} example test(s)`);\n          examplePaths.forEach((path) => Logger.info(`  - ${path}`));\n        } else {\n          Logger.info(\"No example tests generated (implementation pending)\");\n        }\n      } catch (error: any) {\n        Logger.error(`Failed to generate examples: ${error.message}`);\n        throw error;\n      }\n    }\n\n    // Step 5: Summary\n    Logger.section(\"Initialization Complete\");\n    Logger.success(\"Your project is ready for Forge testing!\");\n    Logger.info(\"\\nNext steps:\");\n    Logger.info(\"  1. Deploy your Diamond: npx hardhat diamonds-forge:deploy\");\n    Logger.info(\"  2. Generate helpers: npx hardhat diamonds-forge:generate-helpers\");\n    Logger.info(\"  3. Run tests: npx hardhat diamonds-forge:test\");\n  });\n\n\n"]}

package/dist/tasks/test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/tasks/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/tasks/test.ts"],"names":[],"mappings":""}