create-fhevm-example 1.2.2 → 1.3.0

package/dist/scripts/maintenance.js

@@ -0,0 +1,320 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * FHEVM Example Factory - Maintenance Tools
+ *
+ * Test multiple examples efficiently in a single project.
+ *
+ * Usage:
+ *   npm run test:all                    # Interactive selection
+ *   npm run test:all fhe-counter,fhe-add # Direct CLI
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testAllExamples = testAllExamples;
+const p = __importStar(require("@clack/prompts"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+// =============================================================================
+// Project Builder
+// =============================================================================
+async function createTestProject(exampleNames, outputDir) {
+    const rootDir = (0, utils_1.getRootDir)();
+    const templateDir = (0, utils_1.getTemplateDir)();
+    (0, utils_1.copyDirectoryRecursive)(templateDir, outputDir);
+    (0, utils_1.cleanupTemplate)(outputDir);
+    const allNpmDeps = {};
+    const allContractDeps = new Set();
+    for (const exampleName of exampleNames) {
+        const example = config_1.EXAMPLES[exampleName];
+        if (!example)
+            continue;
+        const contractPath = path.join(rootDir, example.contract);
+        const testPath = path.join(rootDir, example.test);
+        if (fs.existsSync(contractPath)) {
+            const contractName = (0, utils_1.getContractName)(example.contract);
+            if (contractName) {
+                fs.copyFileSync(contractPath, path.join(outputDir, "contracts", `${contractName}.sol`));
+            }
+        }
+        if (fs.existsSync(testPath)) {
+            fs.copyFileSync(testPath, path.join(outputDir, "test", path.basename(example.test)));
+        }
+        if (example.dependencies) {
+            example.dependencies.forEach((dep) => allContractDeps.add(dep));
+        }
+        if (example.npmDependencies) {
+            Object.assign(allNpmDeps, example.npmDependencies);
+        }
+    }
+    for (const depPath of allContractDeps) {
+        const depFullPath = path.join(rootDir, depPath);
+        if (fs.existsSync(depFullPath)) {
+            const relativePath = depPath.replace(/^contracts\//, "");
+            const depDestPath = path.join(outputDir, "contracts", relativePath);
+            const depDestDir = path.dirname(depDestPath);
+            if (!fs.existsSync(depDestDir)) {
+                fs.mkdirSync(depDestDir, { recursive: true });
+            }
+            fs.copyFileSync(depFullPath, depDestPath);
+        }
+    }
+    // Update package.json using shared utility
+    (0, utils_1.updateProjectPackageJson)(outputDir, "fhevm-test-project", `Testing ${exampleNames.length} examples`, Object.keys(allNpmDeps).length > 0 ? allNpmDeps : undefined);
+    const typesPath = path.join(outputDir, "test", "types.ts");
+    if (!fs.existsSync(typesPath)) {
+        fs.writeFileSync(typesPath, utils_1.TEST_TYPES_CONTENT);
+    }
+}
+// =============================================================================
+// Example Selection
+// =============================================================================
+async function getExamplesToTest(cliExamples) {
+    const allExamples = (0, config_1.getExampleNames)();
+    if (cliExamples && cliExamples.length > 0) {
+        const invalid = cliExamples.filter((e) => !allExamples.includes(e));
+        if (invalid.length > 0) {
+            p.log.error(`Unknown examples: ${invalid.join(", ")}`);
+            p.log.message(picocolors_1.default.dim(`Available: ${allExamples.join(", ")}`));
+            process.exit(1);
+        }
+        p.log.message(`Testing ${picocolors_1.default.bold(String(cliExamples.length))} examples...`);
+        return cliExamples;
+    }
+    const selected = await p.multiselect({
+        message: "Select examples to test (space to toggle, enter to confirm):",
+        options: allExamples.map((ex) => ({
+            value: ex,
+            label: ex,
+            hint: config_1.EXAMPLES[ex]?.category || "",
+        })),
+        required: true,
+    });
+    if (p.isCancel(selected)) {
+        p.cancel("Operation cancelled");
+        process.exit(0);
+    }
+    return selected;
+}
+// =============================================================================
+// Test Runner
+// =============================================================================
+async function runTestPipeline(tempDir, exampleCount) {
+    const summary = {
+        totalExamples: exampleCount,
+        passed: 0,
+        failed: 0,
+        compileSuccess: false,
+        failedTests: [],
+    };
+    const s1 = p.spinner();
+    s1.start("Installing dependencies...");
+    const installResult = await (0, utils_1.runCommandWithStatus)("npm", ["install"], tempDir);
+    if (!installResult.success) {
+        s1.stop(picocolors_1.default.red("✗ npm install failed"));
+        p.log.error((0, utils_1.extractErrorMessage)(installResult.output));
+        return summary;
+    }
+    s1.stop(picocolors_1.default.green("✓ Dependencies installed"));
+    const s2 = p.spinner();
+    s2.start("Compiling contracts...");
+    const compileResult = await (0, utils_1.runCommandWithStatus)("npm", ["run", "compile"], tempDir);
+    if (!compileResult.success) {
+        s2.stop(picocolors_1.default.red("✗ Compilation failed"));
+        p.log.error((0, utils_1.extractErrorMessage)(compileResult.output));
+        return summary;
+    }
+    s2.stop(picocolors_1.default.green("✓ Contracts compiled"));
+    summary.compileSuccess = true;
+    const testDir = path.join(tempDir, "test");
+    const testFiles = fs
+        .readdirSync(testDir)
+        .filter((f) => f.endsWith(".test.ts") || f.endsWith(".ts"))
+        .filter((f) => f !== "types.ts");
+    if (testFiles.length === 0) {
+        p.log.warning("No test files found");
+        return summary;
+    }
+    p.log.message("");
+    p.log.message(picocolors_1.default.bold(`🧪 Running ${testFiles.length} test files:`));
+    p.log.message("");
+    let passedTests = 0;
+    let failedTests = 0;
+    const startTime = Date.now();
+    for (let i = 0; i < testFiles.length; i++) {
+        const testFile = testFiles[i];
+        const progress = `[${i + 1}/${testFiles.length}]`;
+        process.stdout.write(`  ${picocolors_1.default.dim(progress)} ${testFile} `);
+        const testStart = Date.now();
+        const result = await (0, utils_1.runCommandWithStatus)("npx", ["hardhat", "test", `test/${testFile}`], tempDir);
+        const duration = ((Date.now() - testStart) / 1000).toFixed(1);
+        if (result.success) {
+            const testResults = (0, utils_1.extractTestResults)(result.output);
+            const resultInfo = testResults
+                ? picocolors_1.default.dim(`(${testResults.replace(" ✓", "")})`)
+                : "";
+            p.log.message(picocolors_1.default.green(`✓`) + ` ${picocolors_1.default.dim(duration + "s")} ${resultInfo}`);
+            passedTests++;
+        }
+        else {
+            p.log.message(picocolors_1.default.red(`✗`) + ` ${picocolors_1.default.dim(duration + "s")}`);
+            failedTests++;
+            summary.failedTests.push(testFile);
+            const errorMsg = (0, utils_1.extractErrorMessage)(result.output);
+            if (errorMsg) {
+                const shortError = errorMsg.split("\n")[0].slice(0, 80);
+                p.log.message(`    ${picocolors_1.default.red(picocolors_1.default.dim(shortError))}`);
+            }
+        }
+    }
+    const totalDuration = ((Date.now() - startTime) / 1000).toFixed(1);
+    p.log.message("");
+    p.log.message(picocolors_1.default.dim(`Completed in ${totalDuration}s`));
+    summary.passed = passedTests;
+    summary.failed = failedTests;
+    return summary;
+}
+function showSummary(summary) {
+    p.log.message("");
+    p.log.message(picocolors_1.default.bold("📊 Test Summary"));
+    p.log.message(picocolors_1.default.dim("─".repeat(50)));
+    p.log.message(`${picocolors_1.default.blue("📦 Examples:")} ${summary.totalExamples}`);
+    p.log.message(`${picocolors_1.default.blue("📁 Compile:")} ${summary.compileSuccess ? picocolors_1.default.green("✓ Success") : picocolors_1.default.red("✗ Failed")}`);
+    if (summary.compileSuccess) {
+        if (summary.failed === 0) {
+            p.log.message(`${picocolors_1.default.green("✓ Tests:")} All passed`);
+        }
+        else {
+            p.log.message(`${picocolors_1.default.green("✓ Passed:")} ${summary.passed}`);
+            p.log.message(`${picocolors_1.default.red("✗ Failed:")} ${summary.failed}`);
+            if (summary.failedTests.length > 0) {
+                p.log.message("");
+                p.log.message(picocolors_1.default.red(picocolors_1.default.bold("Failed tests:")));
+                for (const test of summary.failedTests.slice(0, 10)) {
+                    p.log.message(picocolors_1.default.red(`  ✗ ${test}`));
+                }
+                if (summary.failedTests.length > 10) {
+                    p.log.message(picocolors_1.default.dim(`  ... and ${summary.failedTests.length - 10} more`));
+                }
+            }
+        }
+    }
+    p.log.message(picocolors_1.default.dim("─".repeat(50)));
+    if (summary.compileSuccess && summary.failed === 0) {
+        p.outro(picocolors_1.default.green("✨ All tests passed!"));
+    }
+    else {
+        p.outro(picocolors_1.default.yellow("Some issues need attention"));
+    }
+}
+// =============================================================================
+// Main Command
+// =============================================================================
+async function testAllExamples(cliExamples) {
+    p.intro(picocolors_1.default.cyan("🧪 FHEVM Example Tester"));
+    const examplesToTest = await getExamplesToTest(cliExamples);
+    if (examplesToTest.length === 0) {
+        p.log.warning("No examples selected");
+        p.outro(picocolors_1.default.dim("Nothing to test"));
+        return;
+    }
+    p.log.message("");
+    p.log.message(`📦 Testing ${picocolors_1.default.bold(String(examplesToTest.length))} examples...`);
+    const tempDir = path.join((0, utils_1.getRootDir)(), ".test-temp");
+    if (fs.existsSync(tempDir)) {
+        fs.rmSync(tempDir, { recursive: true });
+    }
+    let summary;
+    try {
+        const s = p.spinner();
+        s.start("Setting up test project...");
+        await createTestProject(examplesToTest, tempDir);
+        s.stop(picocolors_1.default.green("✓ Project ready"));
+        summary = await runTestPipeline(tempDir, examplesToTest.length);
+    }
+    finally {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true });
+        }
+    }
+    showSummary(summary);
+}
+// =============================================================================
+// CLI Entry Point
+// =============================================================================
+function showHelp() {
+    utils_1.log.info("🔧 FHEVM Maintenance Tools");
+    utils_1.log.message("");
+    utils_1.log.message("Available commands:");
+    utils_1.log.message("");
+    utils_1.log.message("  test-all  Test examples");
+    utils_1.log.message("");
+    utils_1.log.message("Usage:");
+    utils_1.log.dim("  npm run test:all");
+    utils_1.log.dim("  npm run test:all fhe-counter,fhe-add");
+}
+async function main() {
+    const args = process.argv.slice(2);
+    // Check for help flag first
+    if (args.includes("--help") || args.includes("-h")) {
+        showHelp();
+        return;
+    }
+    const command = args[0];
+    switch (command) {
+        case "test-all": {
+            const exampleArg = args[1];
+            // Filter out help flags from example list
+            const examples = exampleArg && !exampleArg.startsWith("-")
+                ? exampleArg.split(",")
+                : undefined;
+            await testAllExamples(examples);
+            break;
+        }
+        default:
+            showHelp();
+    }
+}
+// Only run if this is the main module
+const isMainModule = process.argv[1]?.includes("maintenance");
+if (isMainModule) {
+    main().catch(console.error);
+}

package/dist/{ui.d.ts → scripts/ui.d.ts}

@@ -2,7 +2,6 @@
  * User Interface - Prompts & Commands
  *
  * Interactive prompts and command execution for CLI.
- * Combines functionality from prompts.ts and commands.ts
  */
 /**
  * Counts how many examples exist in each category

package/dist/scripts/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../scripts/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMjE;AAMD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAmBrE;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAe1B;AAED;;GAEG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAS5E;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/scripts/ui.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * User Interface - Prompts & Commands
+ *
+ * Interactive prompts and command execution for CLI.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countExamplesPerCategory = countExamplesPerCategory;
+exports.promptSelectCategory = promptSelectCategory;
+exports.promptSelectExampleFromCategory = promptSelectExampleFromCategory;
+exports.promptSelectCategoryProject = promptSelectCategoryProject;
+exports.runInstallAndTest = runInstallAndTest;
+exports.showQuickStart = showQuickStart;
+exports.askInstallAndTest = askInstallAndTest;
+const p = __importStar(require("@clack/prompts"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+// =============================================================================
+// Category Helpers
+// =============================================================================
+/**
+ * Counts how many examples exist in each category
+ */
+function countExamplesPerCategory() {
+    const counts = {};
+    for (const config of Object.values(config_1.EXAMPLES)) {
+        counts[config.category] = (counts[config.category] || 0) + 1;
+    }
+    return counts;
+}
+// =============================================================================
+// Selection Prompts
+// =============================================================================
+/**
+ * Prompts user to select a category
+ */
+async function promptSelectCategory() {
+    const categoryCounts = countExamplesPerCategory();
+    const allCategories = Object.keys(categoryCounts);
+    const orderedCategories = [
+        ...utils_1.CATEGORY_ORDER.filter((cat) => allCategories.includes(cat)),
+        ...allCategories.filter((cat) => !utils_1.CATEGORY_ORDER.includes(cat)).sort(),
+    ];
+    return p.select({
+        message: "Select a category:",
+        options: orderedCategories.map((category) => ({
+            value: category,
+            label: `${utils_1.CATEGORY_ICON} ${category}`,
+            hint: `${categoryCounts[category] || 0} example${categoryCounts[category] !== 1 ? "s" : ""}`,
+        })),
+    });
+}
+/**
+ * Prompts user to select an example from a specific category
+ */
+async function promptSelectExampleFromCategory(category) {
+    const categoryExamples = Object.entries(config_1.EXAMPLES)
+        .filter(([, config]) => config.category === category)
+        .map(([key, config]) => ({
+        value: key,
+        label: key,
+        hint: config.description.slice(0, utils_1.MAX_DESCRIPTION_LENGTH) +
+            (config.description.length > utils_1.MAX_DESCRIPTION_LENGTH ? "..." : ""),
+    }));
+    return p.select({
+        message: `Select an example from ${category}:`,
+        options: categoryExamples,
+    });
+}
+/**
+ * Prompts user to select a category project
+ */
+async function promptSelectCategoryProject() {
+    return p.select({
+        message: "Select a category:",
+        options: Object.entries(config_1.CATEGORIES).map(([key, config]) => ({
+            value: key,
+            label: `${utils_1.CATEGORY_ICON} ${config.name}`,
+            hint: `${config.contracts.length} contracts`,
+        })),
+    });
+}
+// =============================================================================
+// Install & Test Commands
+// =============================================================================
+/**
+ * Runs npm install, compile, and test in the project directory
+ */
+async function runInstallAndTest(projectPath) {
+    const steps = [
+        {
+            name: "Installing dependencies",
+            cmd: "npm",
+            args: ["install"],
+            showOutput: false,
+        },
+        {
+            name: "Compiling contracts",
+            cmd: "npm",
+            args: ["run", "compile"],
+            showOutput: false,
+        },
+        {
+            name: "Running tests",
+            cmd: "npm",
+            args: ["run", "test"],
+            showOutput: true,
+        },
+    ];
+    for (const step of steps) {
+        const s = p.spinner();
+        s.start(step.name + "...");
+        try {
+            const output = await (0, utils_1.runCommand)(step.cmd, step.args, projectPath);
+            if (step.showOutput) {
+                const testResults = (0, utils_1.extractTestResults)(output);
+                s.stop(testResults
+                    ? picocolors_1.default.green(`✓ ${step.name} - ${testResults}`)
+                    : picocolors_1.default.green(`✓ ${step.name} completed`));
+            }
+            else {
+                s.stop(picocolors_1.default.green(`✓ ${step.name} completed`));
+            }
+        }
+        catch (error) {
+            s.stop(picocolors_1.default.red(`✗ ${step.name} failed`));
+            if (error instanceof Error) {
+                p.log.error(error.message);
+            }
+            throw new Error(`${step.name} failed`);
+        }
+    }
+    p.log.success(picocolors_1.default.green("🔐 All encryption tests passed!"));
+}
+/**
+ * Shows quick start commands for the created project
+ */
+function showQuickStart(relativePath) {
+    p.note(`${picocolors_1.default.dim("$")} cd ${relativePath}\n${picocolors_1.default.dim("$")} npm install\n${picocolors_1.default.dim("$")} npm run compile\n${picocolors_1.default.dim("$")} npm run test`, "🚀 Quick Start");
+}
+/**
+ * Asks user if they want to install and test
+ */
+async function askInstallAndTest(resolvedOutput, relativePath) {
+    const shouldInstall = await p.confirm({
+        message: "Install dependencies and run tests?",
+        initialValue: false,
+    });
+    if (p.isCancel(shouldInstall)) {
+        showQuickStart(relativePath);
+        return;
+    }
+    if (shouldInstall) {
+        p.log.message("");
+        await runInstallAndTest(resolvedOutput);
+    }
+    else {
+        showQuickStart(relativePath);
+    }
+}

package/dist/scripts/utils.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Utility functions for FHEVM Example Factory CLI
+ */
+export type ProjectMode = "single" | "category";
+export declare const CATEGORY_ICON = "\uD83D\uDCC1";
+/** Template directory name within the cloned repo */
+export declare const TEMPLATE_DIR_NAME = "fhevm-hardhat-template";
+/** Maximum description length for UI display */
+export declare const MAX_DESCRIPTION_LENGTH = 80;
+/** Directories to exclude when copying template */
+export declare const EXCLUDE_DIRS: string[];
+/** FHEVM package versions for --add mode */
+export declare const FHEVM_DEPENDENCIES: {
+    dependencies: {
+        "encrypted-types": string;
+        "@fhevm/solidity": string;
+    };
+    devDependencies: {
+        "@fhevm/hardhat-plugin": string;
+        "@zama-fhe/relayer-sdk": string;
+    };
+};
+export declare const CATEGORY_ORDER: string[];
+export declare const TEST_TYPES_CONTENT = "import type { HardhatEthersSigner } from \"@nomicfoundation/hardhat-ethers/signers\";\n\n/**\n * Common signers interface used across test files\n */\nexport interface Signers {\n  owner: HardhatEthersSigner;\n  alice: HardhatEthersSigner;\n}\n";
+export declare const ERROR_MESSAGES: {
+    EXAMPLE_REQUIRED: string;
+    BOTH_SPECIFIED: string;
+    UNKNOWN_EXAMPLE: (name: string) => string;
+    UNKNOWN_CATEGORY: (name: string) => string;
+    DIR_EXISTS: (path: string) => string;
+    NOT_HARDHAT: string;
+    CONFIG_NOT_FOUND: string;
+    CONTRACT_NAME_FAILED: string;
+};
+export declare const log: {
+    success: (msg: string) => void;
+    error: (msg: string) => void;
+    info: (msg: string) => void;
+    dim: (msg: string) => void;
+    message: (msg: string) => void;
+};
+/**
+ * Standardized error handler for CLI - logs error and exits
+ */
+export declare function handleError(error: unknown, exitCode?: number): never;
+/** Resolves root directory of the project */
+export declare function getRootDir(): string;
+export declare function getTemplateDir(): string;
+/** Extracts contract name from file path or content */
+export declare function getContractName(contractPathOrContent: string): string | null;
+/** Copies directory recursively, excluding specified directories */
+export declare function copyDirectoryRecursive(source: string, destination: string, excludeDirs?: string[]): void;
+export declare function toKebabCase(str: string): string;
+export declare function contractNameToExampleName(contractName: string): string;
+export declare function contractNameToTitle(contractName: string): string;
+export declare function formatCategoryName(folderName: string): string;
+export declare function validateExample(name: string): void;
+export declare function validateCategory(name: string): void;
+export declare function validateDirectoryNotExists(dirPath: string): void;
+export declare function cleanupTemplate(outputDir: string): void;
+export declare function generateDeployScript(contractName: string): string;
+export declare function generateGitBookMarkdown(description: string, contractContent: string, testContent: string, contractName: string, testFileName: string): string;
+/** Downloads a file from GitHub repository */
+export declare function downloadFileFromGitHub(filePath: string, outputPath: string): Promise<void>;
+/** Clones the template repository to temp directory */
+export declare function cloneTemplate(tempDir: string): Promise<string>;
+/** Initializes git submodule for the template */
+export declare function initSubmodule(repoPath: string): Promise<void>;
+/** Updates package.json with project name, description, and npm dependencies */
+export declare function updateProjectPackageJson(outputDir: string, projectName: string, description?: string, npmDependencies?: Record<string, string>): void;
+/** Executes a command and returns output */
+export declare function runCommand(cmd: string, args: string[], cwd: string): Promise<string>;
+export declare function runCommandWithStatus(cmd: string, args: string[], cwd: string): Promise<{
+    success: boolean;
+    output: string;
+}>;
+export declare function extractTestResults(output: string): string | null;
+export declare function extractErrorMessage(output: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/scripts/utils.d.ts.map

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