create-fhevm-example 1.3.0 → 1.3.2

package/dist/scripts/index.js

@@ -133,10 +133,19 @@ async function getProjectConfig() {
         p.cancel("Operation cancelled.");
         return null;
     }
+    const shouldInstall = await p.confirm({
+        message: "Install dependencies and run tests?",
+        initialValue: false,
+    });
+    if (p.isCancel(shouldInstall)) {
+        p.cancel("Operation cancelled.");
+        return null;
+    }
     return {
         mode: mode,
         name,
         outputDir: outputDir,
+        shouldInstall: shouldInstall,
     };
 }
 /** Scaffolds project and shows completion message */
@@ -165,17 +174,27 @@ async function scaffoldProject(config) {
         p.log.success(`📁 Created: ${picocolors_1.default.cyan(relativePath)}`);
         if (config.mode === "single") {
             const exampleConfig = config_1.EXAMPLES[config.name];
-            p.log.info(`📝 Example: ${picocolors_1.default.yellow(exampleConfig?.title || config.name)}`);
+            if (exampleConfig) {
+                p.log.info(`📝 Example: ${picocolors_1.default.yellow(exampleConfig.title)}`);
+            }
         }
         else {
             const categoryConfig = config_1.CATEGORIES[config.name];
-            p.log.info(`📦 Category: ${picocolors_1.default.yellow(categoryConfig?.name || config.name)}`);
-            p.log.info(`📄 Contracts: ${picocolors_1.default.green(String(categoryConfig?.contracts.length || 0))}`);
+            if (categoryConfig) {
+                p.log.info(`📦 Category: ${picocolors_1.default.yellow(categoryConfig.name)}`);
+                p.log.info(`📄 Contracts: ${picocolors_1.default.green(String(categoryConfig.contracts.length))}`);
+            }
+        }
+        if (config.shouldInstall) {
+            p.log.message("");
+            await (0, ui_1.runInstallAndTest)(resolvedOutput);
+        }
+        else {
+            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");
         }
-        await (0, ui_1.askInstallAndTest)(resolvedOutput, relativePath);
     }
     catch (error) {
-        s.stop("Failed to create project");
+        s.stop(picocolors_1.default.red("Failed to create project"));
         p.log.error(error instanceof Error ? error.message : String(error));
         process.exit(1);
     }
@@ -195,54 +214,6 @@ async function runInteractiveMode() {
         return;
     await scaffoldProject(config);
 }
-// =============================================================================
-// QUICK MODE (CLI Arguments)
-// =============================================================================
-function showHelp() {
-    console.log(`
-${picocolors_1.default.bgCyan(picocolors_1.default.black(picocolors_1.default.bold(" 🔐 create-fhevm-example ")))}
-${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
-
-${picocolors_1.default.cyan(picocolors_1.default.bold("📋 USAGE"))}
-
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")}                  ${picocolors_1.default.dim("→")} Interactive mode ${picocolors_1.default.yellow("(recommended)")}
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("<name>")}  ${picocolors_1.default.dim("→")} Create single example
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--category")} ${picocolors_1.default.yellow("<name>")} ${picocolors_1.default.dim("→")} Create category project
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--add")}               ${picocolors_1.default.dim("→")} Add to existing project
-
-${picocolors_1.default.cyan(picocolors_1.default.bold("⚙️  OPTIONS"))}
-
-  ${picocolors_1.default.green("--example")} ${picocolors_1.default.dim("<name>")}      Create a single example project
-  ${picocolors_1.default.green("--category")} ${picocolors_1.default.dim("<name>")}     Create a category project
-  ${picocolors_1.default.green("--add")}                 Add FHEVM to existing Hardhat project
-  ${picocolors_1.default.green("--target")} ${picocolors_1.default.dim("<dir>")}        Target directory for --add mode
-  ${picocolors_1.default.green("--output")} ${picocolors_1.default.dim("<dir>")}        Output directory
-  ${picocolors_1.default.green("--install")}             Auto-install dependencies
-  ${picocolors_1.default.green("--test")}                Auto-run tests (requires --install)
-  ${picocolors_1.default.green("--help")}${picocolors_1.default.dim(", -h")}            Show this help message
-
-${picocolors_1.default.cyan(picocolors_1.default.bold("⚡ EXAMPLES"))}
-
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("fhe-counter")}
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--category")} ${picocolors_1.default.yellow("basic")} ${picocolors_1.default.green("--output")} ${picocolors_1.default.blue("./my-project")}
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--add")}
-  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white("npx create-fhevm-example")} ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("fhe-counter")} ${picocolors_1.default.green("--install")} ${picocolors_1.default.green("--test")}
-
-${picocolors_1.default.cyan(picocolors_1.default.bold("📦 AVAILABLE EXAMPLES"))}
-
-  ${picocolors_1.default.dim(Object.keys(config_1.EXAMPLES).slice(0, 10).join(", "))}
-  ${picocolors_1.default.dim("...")} and ${picocolors_1.default.yellow(String(Object.keys(config_1.EXAMPLES).length - 10))} more
-
-${picocolors_1.default.cyan(picocolors_1.default.bold("📁 AVAILABLE CATEGORIES"))}
-
-  ${Object.keys(config_1.CATEGORIES)
-        .map((c) => picocolors_1.default.yellow(c))
-        .join(", ")}
-
-${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
-${picocolors_1.default.dim("📚 Documentation:")} ${picocolors_1.default.blue("https://github.com/NecipAkgz/fhevm-example-factory")}
-`);
-}
 function parseArgs(args) {
     const parsed = {};
     for (let i = 0; i < args.length; i++) {
@@ -313,25 +284,30 @@ async function runDirectMode(args) {
     }
     const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "fhevm-"));
     try {
-        utils_1.log.info(`Creating ${mode}: ${name}`);
+        utils_1.log.info(`\n🚀 Creating ${mode}: ${picocolors_1.default.yellow(name)}`);
+        utils_1.log.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
         utils_1.log.dim("Downloading template...");
         const tempRepoPath = await (0, utils_1.cloneTemplate)(tempDir);
         utils_1.log.dim("Initializing submodules...");
         await (0, utils_1.initSubmodule)(tempRepoPath);
-        utils_1.log.dim("Creating project...");
+        utils_1.log.dim("Building project...");
         if (mode === "example") {
             await (0, builders_1.createSingleExample)(name, resolved, tempRepoPath);
         }
         else {
             await (0, builders_1.createCategoryProject)(name, resolved, tempRepoPath);
         }
-        utils_1.log.success(`✓ Created: ${output}`);
+        utils_1.log.success(`\n✨ Successfully created: ${picocolors_1.default.cyan(output)}`);
         if (shouldInstall) {
-            utils_1.log.dim("\nInstalling dependencies...");
+            utils_1.log.dim("Installing dependencies and running tests...");
             await (0, ui_1.runInstallAndTest)(resolved);
         }
         else {
-            utils_1.log.dim(`\nNext: cd ${output} && npm install && npm run compile && npm run test`);
+            utils_1.log.message(picocolors_1.default.dim("\nNext steps:"));
+            utils_1.log.message(`  ${picocolors_1.default.cyan("cd")} ${output}`);
+            utils_1.log.message(`  ${picocolors_1.default.cyan("npm install")}`);
+            utils_1.log.message(`  ${picocolors_1.default.cyan("npm run compile")}`);
+            utils_1.log.message(`  ${picocolors_1.default.cyan("npm run test")}`);
         }
     }
     catch (error) {
@@ -344,6 +320,77 @@ async function runDirectMode(args) {
     }
 }
 // =============================================================================
+// QUICK MODE (CLI Arguments)
+// =============================================================================
+function showHelp() {
+    const isDev = process.env.LOCAL_DEV === "1";
+    if (isDev) {
+        // Developer help - show npm run scripts
+        console.log(`
+${picocolors_1.default.bgCyan(picocolors_1.default.black(picocolors_1.default.bold(" 🔐 FHEVM Example Factory - Developer Mode ")))}
+${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("📋 CREATE COMMANDS"))}
+
+  ${picocolors_1.default.green("npm run create")}              Interactive mode ${picocolors_1.default.yellow("(recommended)")}
+  ${picocolors_1.default.green("npm run create:example")} ${picocolors_1.default.dim("<name>")}  Create single example
+  ${picocolors_1.default.green("npm run create:category")} ${picocolors_1.default.dim("<name>")} Create category project
+  ${picocolors_1.default.green("npm run create:docs")}         Generate documentation
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("🛠️  MAINTENANCE"))}
+
+  ${picocolors_1.default.green("npm run test:all")}            Test multiple examples
+  ${picocolors_1.default.green("npm run generate:config")}     Update contract registry
+  ${picocolors_1.default.green("npm run doctor")}              System health check
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("❓ HELP"))}
+
+  ${picocolors_1.default.green("npm run help:create")}         This help
+  ${picocolors_1.default.green("npm run help:docs")}           Docs generator help
+  ${picocolors_1.default.green("npm run help:test")}           Test runner help
+
+${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+`);
+    }
+    else {
+        // End-user help - show npx commands
+        console.log(`
+${picocolors_1.default.bgCyan(picocolors_1.default.black(picocolors_1.default.bold(" 🔐 create-fhevm-example ")))}
+${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("📋 USAGE"))}
+
+  ${picocolors_1.default.dim("$")} npx create-fhevm-example                    ${picocolors_1.default.dim("→")} Interactive ${picocolors_1.default.yellow("(recommended)")}
+  ${picocolors_1.default.dim("$")} npx create-fhevm-example ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("<name>")}   ${picocolors_1.default.dim("→")} Single example
+  ${picocolors_1.default.dim("$")} npx create-fhevm-example ${picocolors_1.default.green("--category")} ${picocolors_1.default.yellow("<name>")}  ${picocolors_1.default.dim("→")} Category project
+  ${picocolors_1.default.dim("$")} npx create-fhevm-example ${picocolors_1.default.green("--add")}                ${picocolors_1.default.dim("→")} Add to existing project
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("⚙️  OPTIONS"))}
+
+  ${picocolors_1.default.green("--example")} ${picocolors_1.default.dim("<name>")}     Single example project
+  ${picocolors_1.default.green("--category")} ${picocolors_1.default.dim("<name>")}    Category project
+  ${picocolors_1.default.green("--add")}                Add FHEVM to existing Hardhat project
+  ${picocolors_1.default.green("--output")} ${picocolors_1.default.dim("<dir>")}       Output directory
+  ${picocolors_1.default.green("--install")}            Auto-install dependencies
+  ${picocolors_1.default.green("--help")}               Show this help
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("⚡ EXAMPLES"))}
+
+  ${picocolors_1.default.dim("$")} npx create-fhevm-example --example fhe-counter
+  ${picocolors_1.default.dim("$")} npx create-fhevm-example --category basic --output ./my-project
+  ${picocolors_1.default.dim("$")} npx create-fhevm-example --add
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("📦 AVAILABLE"))}
+
+  Examples: ${picocolors_1.default.dim(Object.keys(config_1.EXAMPLES).slice(0, 5).join(", "))} ${picocolors_1.default.dim("...")} (${Object.keys(config_1.EXAMPLES).length} total)
+  Categories: ${Object.keys(config_1.CATEGORIES).map((c) => picocolors_1.default.yellow(c)).join(", ")}
+
+${picocolors_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+${picocolors_1.default.dim("📚 Docs:")} ${picocolors_1.default.blue("https://github.com/NecipAkgz/fhevm-example-factory")}
+`);
+    }
+}
+// =============================================================================
 // MAIN ENTRY POINT
 // =============================================================================
 async function main() {

package/dist/scripts/maintenance.d.ts

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 /**
- * FHEVM Example Factory - Maintenance Tools
+ * Maintenance Tools - Utilities for project maintenance and testing.
  *
- * Test multiple examples efficiently in a single project.
+ * Includes the test-all runner which allows for efficient testing
+ * of multiple examples in a temporary workspace.
  *
  * Usage:
- *   npm run test:all                    # Interactive selection
- *   npm run test:all fhe-counter,fhe-add # Direct CLI
+ *   npm run test:all                      # Interactive selection
+ *   npm run test:all fhe-counter,fhe-add  # Direct CLI
  */
 export declare function testAllExamples(cliExamples?: string[]): Promise<void>;
 //# sourceMappingURL=maintenance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../scripts/maintenance.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AA0SH,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC3E"}
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../scripts/maintenance.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AAwNH,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC3E"}

package/dist/scripts/maintenance.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * FHEVM Example Factory - Maintenance Tools
+ * Maintenance Tools - Utilities for project maintenance and testing.
  *
- * Test multiple examples efficiently in a single project.
+ * Includes the test-all runner which allows for efficient testing
+ * of multiple examples in a temporary workspace.
  *
  * Usage:
- *   npm run test:all                    # Interactive selection
- *   npm run test:all fhe-counter,fhe-add # Direct CLI
+ *   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;
@@ -53,57 +54,7 @@ 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);
-    }
-}
+const builders_1 = require("./builders");
 // =============================================================================
 // Example Selection
 // =============================================================================
@@ -266,7 +217,7 @@ async function testAllExamples(cliExamples) {
     try {
         const s = p.spinner();
         s.start("Setting up test project...");
-        await createTestProject(examplesToTest, tempDir);
+        await (0, builders_1.createLocalTestProject)(examplesToTest, tempDir);
         s.stop(picocolors_1.default.green("✓ Project ready"));
         summary = await runTestPipeline(tempDir, examplesToTest.length);
     }

package/dist/scripts/ui.d.ts

@@ -1,7 +1,8 @@
 /**
- * User Interface - Prompts & Commands
+ * User Interface - CLI Prompts and Interaction Logic.
  *
- * Interactive prompts and command execution for CLI.
+ * Provides centralized components for user input, selection menus,
+ * and standard command execution feedback for the CLI.
  */
 /**
  * Counts how many examples exist in each category
@@ -23,12 +24,4 @@ export declare function promptSelectCategoryProject(): Promise<string | symbol>;
  * Runs npm install, compile, and test in the project directory
  */
 export declare function runInstallAndTest(projectPath: string): Promise<void>;
-/**
- * Shows quick start commands for the created project
- */
-export declare function showQuickStart(relativePath: string): void;
-/**
- * Asks user if they want to install and test
- */
-export declare function askInstallAndTest(resolvedOutput: string, relativePath: string): Promise<void>;
 //# sourceMappingURL=ui.d.ts.map

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

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

package/dist/scripts/ui.js

@@ -1,8 +1,9 @@
 "use strict";
 /**
- * User Interface - Prompts & Commands
+ * User Interface - CLI Prompts and Interaction Logic.
  *
- * Interactive prompts and command execution for CLI.
+ * Provides centralized components for user input, selection menus,
+ * and standard command execution feedback for the CLI.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -46,8 +47,6 @@ 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");
@@ -169,29 +168,3 @@ async function runInstallAndTest(projectPath) {
     }
     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

@@ -1,5 +1,8 @@
 /**
- * Utility functions for FHEVM Example Factory CLI
+ * Shared Utilities - Helper functions for the FHEVM Example Factory.
+ *
+ * Contains common logic for file system operations, string formatting,
+ * error handling, and terminal logging used throughout the project.
  */
 export type ProjectMode = "single" | "category";
 export declare const CATEGORY_ICON = "\uD83D\uDCC1";
@@ -45,30 +48,22 @@ export declare const log: {
 export declare function handleError(error: unknown, exitCode?: number): never;
 /** Resolves root directory of the project */
 export declare function getRootDir(): string;
+/** Resolves template directory path */
 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 getContractName(contractPathOrContent: string): string | null;
 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;
@@ -76,4 +71,16 @@ export declare function runCommandWithStatus(cmd: string, args: string[], cwd: s
 }>;
 export declare function extractTestResults(output: string): string | null;
 export declare function extractErrorMessage(output: 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>;
 //# sourceMappingURL=utils.d.ts.map

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

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