create-fhevm-example 1.3.1 → 1.4.0

package/dist/scripts/{add-mode.js → commands/add-mode.js}

@@ -47,8 +47,8 @@ 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");
+const config_1 = require("../shared/config");
+const utils_1 = require("../shared/utils");
 // =============================================================================
 // PROJECT DETECTION
 // =============================================================================
@@ -136,88 +136,54 @@ function updateHardhatConfig(targetDir) {
 /**
  * Adds example contract and test files to the project
  */
-async function addExampleFiles(exampleName, targetDir) {
+function addExampleFiles(exampleName, targetDir) {
     const example = config_1.EXAMPLES[exampleName];
     if (!example) {
         throw new Error(`Unknown example: ${exampleName}`);
     }
+    const rootDir = (0, utils_1.getRootDir)();
     const contractName = (0, utils_1.getContractName)(example.contract);
     if (!contractName) {
         throw new Error("Could not extract contract name");
     }
+    const contractSource = path.join(rootDir, example.contract);
+    const testSource = path.join(rootDir, example.test);
     // Handle contract file
     let contractDest = path.join(targetDir, "contracts", `${contractName}.sol`);
+    const contractsDir = path.join(targetDir, "contracts");
+    if (!fs.existsSync(contractsDir)) {
+        fs.mkdirSync(contractsDir, { recursive: true });
+    }
     if (fs.existsSync(contractDest)) {
-        const action = await p.select({
-            message: `${contractName}.sol already exists. What do you want to do?`,
-            options: [
-                { value: "skip", label: "Skip contract" },
-                { value: "overwrite", label: "Overwrite existing file" },
-                {
-                    value: "rename",
-                    label: `Rename to ${contractName}_fhevm.sol`,
-                },
-            ],
-        });
-        if (p.isCancel(action)) {
-            throw new Error("Operation cancelled");
-        }
-        if (action === "skip") {
-            p.log.info(`Skipped: ${contractName}.sol`);
-        }
-        else if (action === "rename") {
-            contractDest = path.join(targetDir, "contracts", `${contractName}_fhevm.sol`);
-            await (0, utils_1.downloadFileFromGitHub)(example.contract, contractDest);
-            p.log.success(`Added: ${contractName}_fhevm.sol`);
-        }
-        else {
-            await (0, utils_1.downloadFileFromGitHub)(example.contract, contractDest);
-            p.log.success(`Overwritten: ${contractName}.sol`);
-        }
+        // File exists - will be handled by caller with prompts
+        fs.copyFileSync(contractSource, contractDest);
+        p.log.success(`Overwritten: ${contractName}.sol`);
     }
     else {
-        const contractsDir = path.join(targetDir, "contracts");
-        if (!fs.existsSync(contractsDir)) {
-            fs.mkdirSync(contractsDir, { recursive: true });
-        }
-        await (0, utils_1.downloadFileFromGitHub)(example.contract, contractDest);
+        fs.copyFileSync(contractSource, contractDest);
         p.log.success(`Added: ${contractName}.sol`);
     }
     // Handle test file
     const testFileName = path.basename(example.test);
-    let testDest = path.join(targetDir, "test", testFileName);
+    const testDest = path.join(targetDir, "test", testFileName);
+    const testDir = path.join(targetDir, "test");
+    if (!fs.existsSync(testDir)) {
+        fs.mkdirSync(testDir, { recursive: true });
+    }
     if (fs.existsSync(testDest)) {
-        const action = await p.select({
-            message: `${testFileName} already exists. What do you want to do?`,
-            options: [
-                { value: "skip", label: "Skip test" },
-                { value: "overwrite", label: "Overwrite existing file" },
-            ],
-        });
-        if (p.isCancel(action)) {
-            throw new Error("Operation cancelled");
-        }
-        if (action === "skip") {
-            p.log.info(`Skipped: ${testFileName}`);
-        }
-        else {
-            await (0, utils_1.downloadFileFromGitHub)(example.test, testDest);
-            p.log.success(`Overwritten: ${testFileName}`);
-        }
+        fs.copyFileSync(testSource, testDest);
+        p.log.success(`Overwritten: ${testFileName}`);
     }
     else {
-        const testDir = path.join(targetDir, "test");
-        if (!fs.existsSync(testDir)) {
-            fs.mkdirSync(testDir, { recursive: true });
-        }
-        await (0, utils_1.downloadFileFromGitHub)(example.test, testDest);
+        fs.copyFileSync(testSource, testDest);
         p.log.success(`Added: ${testFileName}`);
     }
     // Handle contract dependencies
     if (example.dependencies) {
         p.log.message("");
-        p.log.message(picocolors_1.default.bold("Downloading contract dependencies..."));
+        p.log.message(picocolors_1.default.bold("Copying contract dependencies..."));
         for (const depPath of example.dependencies) {
+            const depSource = path.join(rootDir, depPath);
             const relativePath = depPath.replace(/^contracts\//, "");
             const depDestPath = path.join(targetDir, "contracts", relativePath);
             const depDestDir = path.dirname(depDestPath);
@@ -228,8 +194,8 @@ async function addExampleFiles(exampleName, targetDir) {
             if (fs.existsSync(depDestPath)) {
                 p.log.info(`Skipped (exists): ${depName}`);
             }
-            else {
-                await (0, utils_1.downloadFileFromGitHub)(depPath, depDestPath);
+            else if (fs.existsSync(depSource)) {
+                fs.copyFileSync(depSource, depDestPath);
                 p.log.success(`Added: ${depName}`);
             }
         }
@@ -313,7 +279,7 @@ async function runAddMode(targetDir) {
     p.log.message("");
     p.log.message(picocolors_1.default.bold("Adding example files..."));
     try {
-        await addExampleFiles(exampleName, absoluteDir);
+        addExampleFiles(exampleName, absoluteDir);
     }
     catch (error) {
         p.log.error("Failed to add example files");

package/dist/scripts/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../scripts/commands/doctor.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/scripts/{doctor.js → commands/doctor.js}

@@ -50,8 +50,8 @@ const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const p = __importStar(require("@clack/prompts"));
 const picocolors_1 = __importDefault(require("picocolors"));
-const utils_1 = require("./utils");
-const config_1 = require("./config");
+const utils_1 = require("../shared/utils");
+const config_1 = require("../shared/config");
 const ROOT_DIR = (0, utils_1.getRootDir)();
 // =============================================================================
 // Checks

package/dist/scripts/commands/generate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-config.d.ts","sourceRoot":"","sources":["../../../scripts/commands/generate-config.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/scripts/{generate-config.js → commands/generate-config.js}

@@ -45,12 +45,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const utils_1 = require("./utils");
+const utils_1 = require("../shared/utils");
 const picocolors_1 = __importDefault(require("picocolors"));
-const ROOT_DIR = path.resolve(__dirname, "..");
+const ROOT_DIR = path.resolve(__dirname, "../..");
 const CONTRACTS_DIR = path.join(ROOT_DIR, "contracts");
 const TEST_DIR = path.join(ROOT_DIR, "test");
-const OUTPUT_FILE = path.join(ROOT_DIR, "scripts/config.ts");
+const OUTPUT_FILE = path.join(ROOT_DIR, "scripts/shared/config.ts");
 // =============================================================================
 // Contract Analysis
 // =============================================================================
@@ -234,13 +234,6 @@ export interface CategoryConfig {
   contracts: Array<{ sol: string; test?: string }>;
 }
 
-// =============================================================================
-// GitHub Repository Configuration
-// =============================================================================
-
-export const REPO_URL = "https://github.com/NecipAkgz/fhevm-example-factory";
-export const REPO_BRANCH = "main";
-
 // =============================================================================
 // Example Configurations
 // =============================================================================

package/dist/scripts/commands/generate-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-docs.d.ts","sourceRoot":"","sources":["../../../scripts/commands/generate-docs.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAkEH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiE3D;AAMD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhE"}

package/dist/scripts/{generate-docs.js → commands/generate-docs.js}

@@ -49,8 +49,9 @@ 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");
+const config_1 = require("../shared/config");
+const utils_1 = require("../shared/utils");
+const generators_1 = require("../shared/generators");
 // =============================================================================
 // Documentation Generator
 // =============================================================================
@@ -70,7 +71,7 @@ async function generateDocumentation(exampleName) {
         const testContent = fs.readFileSync(testPath, "utf-8");
         const contractName = (0, utils_1.getContractName)(example.contract) || "Contract";
         const testFileName = path.basename(example.test);
-        const markdown = (0, utils_1.generateGitBookMarkdown)(example.description, contractContent, testContent, contractName, testFileName);
+        const markdown = (0, generators_1.generateGitBookMarkdown)(example.description, contractContent, testContent, contractName, testFileName);
         const outputPath = example.docsOutput
             ? path.join(rootDir, example.docsOutput)
             : path.join(rootDir, "docs", `${(0, config_1.getDocsFileName)(name)}.md`);

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

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

package/dist/scripts/{maintenance.js → commands/maintenance.js}

@@ -52,9 +52,10 @@ 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");
-const builders_1 = require("./builders");
+const config_1 = require("../shared/config");
+const utils_1 = require("../shared/utils");
+const generators_1 = require("../shared/generators");
+const builders_1 = require("../shared/builders");
 // =============================================================================
 // Example Selection
 // =============================================================================
@@ -98,19 +99,19 @@ async function runTestPipeline(tempDir, exampleCount) {
     };
     const s1 = p.spinner();
     s1.start("Installing dependencies...");
-    const installResult = await (0, utils_1.runCommandWithStatus)("npm", ["install"], tempDir);
+    const installResult = await (0, generators_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));
+        p.log.error((0, generators_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);
+    const compileResult = await (0, generators_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));
+        p.log.error((0, generators_1.extractErrorMessage)(compileResult.output));
         return summary;
     }
     s2.stop(picocolors_1.default.green("✓ Contracts compiled"));
@@ -135,10 +136,10 @@ async function runTestPipeline(tempDir, exampleCount) {
         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 result = await (0, generators_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 testResults = (0, generators_1.extractTestResults)(result.output);
             const resultInfo = testResults
                 ? picocolors_1.default.dim(`(${testResults.replace(" ✓", "")})`)
                 : "";
@@ -149,7 +150,7 @@ async function runTestPipeline(tempDir, exampleCount) {
             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);
+            const errorMsg = (0, generators_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))}`);

package/dist/scripts/index.js

@@ -50,13 +50,12 @@ const p = __importStar(require("@clack/prompts"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const config_1 = require("./config");
-const utils_1 = require("./utils");
-const builders_1 = require("./builders");
-const ui_1 = require("./ui");
-const add_mode_1 = require("./add-mode");
-const generate_docs_1 = require("./generate-docs");
+const config_1 = require("./shared/config");
+const utils_1 = require("./shared/utils");
+const builders_1 = require("./shared/builders");
+const ui_1 = require("./shared/ui");
+const add_mode_1 = require("./commands/add-mode");
+const generate_docs_1 = require("./commands/generate-docs");
 /** Prompts user to select mode and returns project configuration */
 async function getProjectConfig() {
     // Build options - docs only available in local dev mode
@@ -155,19 +154,14 @@ async function scaffoldProject(config) {
         p.log.error(`Directory already exists: ${resolvedOutput}`);
         process.exit(1);
     }
-    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "fhevm-"));
     const s = p.spinner();
     try {
-        s.start("Downloading template...");
-        const tempRepoPath = await (0, utils_1.cloneTemplate)(tempDir);
-        s.message("Initializing submodules...");
-        await (0, utils_1.initSubmodule)(tempRepoPath);
-        s.message("Scaffolding your confidential project...");
+        s.start("Scaffolding your confidential project...");
         if (config.mode === "single") {
-            await (0, builders_1.createSingleExample)(config.name, resolvedOutput, tempRepoPath);
+            (0, builders_1.createSingleExample)(config.name, resolvedOutput);
         }
         else {
-            await (0, builders_1.createCategoryProject)(config.name, resolvedOutput, tempRepoPath);
+            (0, builders_1.createCategoryProject)(config.name, resolvedOutput);
         }
         s.stop("🎉 Project scaffolded successfully!");
         const relativePath = path.relative(process.cwd(), resolvedOutput);
@@ -198,11 +192,6 @@ async function scaffoldProject(config) {
         p.log.error(error instanceof Error ? error.message : String(error));
         process.exit(1);
     }
-    finally {
-        if (fs.existsSync(tempDir)) {
-            fs.rmSync(tempDir, { recursive: true, force: true });
-        }
-    }
     p.outro(picocolors_1.default.green("✅ Setup complete. Happy encrypting!"));
 }
 /** Main interactive mode entry point */
@@ -282,20 +271,15 @@ async function runDirectMode(args) {
     catch (error) {
         (0, utils_1.handleError)(error);
     }
-    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "fhevm-"));
     try {
         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("Building project...");
         if (mode === "example") {
-            await (0, builders_1.createSingleExample)(name, resolved, tempRepoPath);
+            (0, builders_1.createSingleExample)(name, resolved);
         }
         else {
-            await (0, builders_1.createCategoryProject)(name, resolved, tempRepoPath);
+            (0, builders_1.createCategoryProject)(name, resolved);
         }
         utils_1.log.success(`\n✨ Successfully created: ${picocolors_1.default.cyan(output)}`);
         if (shouldInstall) {
@@ -313,59 +297,79 @@ async function runDirectMode(args) {
     catch (error) {
         (0, utils_1.handleError)(error);
     }
-    finally {
-        if (fs.existsSync(tempDir)) {
-            fs.rmSync(tempDir, { recursive: true, force: true });
-        }
-    }
 }
 // =============================================================================
 // QUICK MODE (CLI Arguments)
 // =============================================================================
 function showHelp() {
-    console.log(`
+    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("$")} ${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.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>")}      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.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("$")} ${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("$")} 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.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"))}
 
-${picocolors_1.default.cyan(picocolors_1.default.bold("📁 AVAILABLE CATEGORIES"))}
-
-  ${Object.keys(config_1.CATEGORIES)
-        .map((c) => picocolors_1.default.yellow(c))
-        .join(", ")}
+  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("📚 Documentation:")} ${picocolors_1.default.blue("https://github.com/NecipAkgz/fhevm-example-factory")}
+${picocolors_1.default.dim("📚 Docs:")} ${picocolors_1.default.blue("https://github.com/NecipAkgz/fhevm-example-factory")}
 `);
+    }
 }
 // =============================================================================
 // MAIN ENTRY POINT

package/dist/scripts/{builders.d.ts → shared/builders.d.ts}

@@ -7,11 +7,11 @@
 /**
  * Creates a single example project from the template
  */
-export declare function createSingleExample(exampleName: string, outputDir: string, tempRepoPath: string): Promise<void>;
+export declare function createSingleExample(exampleName: string, outputDir: string): void;
 /**
  * Creates a category project with multiple examples
  */
-export declare function createCategoryProject(categoryName: string, outputDir: string, tempRepoPath: string): Promise<void>;
+export declare function createCategoryProject(categoryName: string, outputDir: string): void;
 /**
  * Creates a temporary test project using LOCAL files (used by maintenance.ts)
  */

package/dist/scripts/shared/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../scripts/shared/builders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6DH;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CAkDN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,IAAI,CAwEN;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EAAE,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuEf"}