create-fhevm-example 1.3.0 → 1.3.2

package/README.md

@@ -1,5 +1,3 @@
-# create-fhevm-example
-
 <p align="center">
   <strong>Create FHEVM example projects with a single command</strong>
 </p>
@@ -66,14 +64,16 @@ npx create-fhevm-example --example fhe-counter --output ./my-project --install -
 
 ## 📋 CLI Options
 
-`--example <name>` - Create a single example project
-`--category <name>` - Create a category project
-`--add` - Add FHEVM to existing Hardhat project
-`--target <dir>` - Target directory for --add mode (default: current dir)
-`--output <dir>` - Output directory
-`--install` - Auto-install dependencies
-`--test` - Auto-run tests
-`--help` - Show help
+| Option | Description |
+| :--- | :--- |
+| `--example <name>` | Create a single example project |
+| `--category <name>` | Create a category project |
+| `--add` | Add FHEVM to an existing Hardhat project |
+| `--target <dir>` | Target directory for `--add` mode (default: current dir) |
+| `--output <dir>` | Output directory for new projects |
+| `--install` | Auto-install dependencies after scaffolding |
+| `--test` | Auto-run tests (requires `--install`) |
+| `--help`, `-h` | Show help information |
 
 ---
 

package/dist/scripts/add-mode.d.ts

@@ -1,5 +1,8 @@
 /**
- * Add Mode - Add FHEVM to existing Hardhat projects
+ * Add Mode - Feature for adding FHEVM to existing Hardhat projects.
+ *
+ * Logic for managing configuration updates, dependency installations,
+ * and scaffolding example contracts into established projects.
  */
 /**
  * Main function to add FHEVM capabilities to an existing Hardhat project

package/dist/scripts/add-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-mode.d.ts","sourceRoot":"","sources":["../../scripts/add-mode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkRH;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ElE"}
+{"version":3,"file":"add-mode.d.ts","sourceRoot":"","sources":["../../scripts/add-mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkRH;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ElE"}

package/dist/scripts/add-mode.js

@@ -1,6 +1,9 @@
 "use strict";
 /**
- * Add Mode - Add FHEVM to existing Hardhat projects
+ * Add Mode - Feature for adding FHEVM to existing Hardhat projects.
+ *
+ * Logic for managing configuration updates, dependency installations,
+ * and scaffolding example contracts into established projects.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;

package/dist/scripts/builders.d.ts

@@ -1,20 +1,19 @@
 /**
- * Project Builders
+ * Project Builders - Core logic for scaffolding FHEVM projects.
  *
- * Creates single example and category projects from templates.
+ * Handles the creation of single example projects, category-based
+ * project bundles, and specialized test environments.
  */
 /**
  * Creates a single example project from the template
- * @param exampleName - Name of the example to create
- * @param outputDir - Target directory for the project
- * @param tempRepoPath - Path to cloned template repository
  */
 export declare function createSingleExample(exampleName: string, outputDir: string, tempRepoPath: string): Promise<void>;
 /**
  * Creates a category project with multiple examples
- * @param categoryName - Name of the category to create
- * @param outputDir - Target directory for the project
- * @param tempRepoPath - Path to cloned template repository
  */
 export declare function createCategoryProject(categoryName: string, outputDir: string, tempRepoPath: string): Promise<void>;
+/**
+ * Creates a temporary test project using LOCAL files (used by maintenance.ts)
+ */
+export declare function createLocalTestProject(exampleNames: string[], outputDir: string): Promise<void>;
 //# sourceMappingURL=builders.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../scripts/builders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuDH;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAgDf;AAMD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Df"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../scripts/builders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0DH;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAiEf;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EAAE,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/scripts/builders.js

@@ -1,8 +1,9 @@
 "use strict";
 /**
- * Project Builders
+ * Project Builders - Core logic for scaffolding FHEVM projects.
  *
- * Creates single example and category projects from templates.
+ * Handles the creation of single example projects, category-based
+ * project bundles, and specialized test environments.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -40,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSingleExample = createSingleExample;
 exports.createCategoryProject = createCategoryProject;
+exports.createLocalTestProject = createLocalTestProject;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const config_1 = require("./config");
@@ -73,13 +75,10 @@ async function initGitRepo(outputDir) {
     }
 }
 // =============================================================================
-// Single Example Builder
+// Project Scaffolding
 // =============================================================================
 /**
  * Creates a single example project from the template
- * @param exampleName - Name of the example to create
- * @param outputDir - Target directory for the project
- * @param tempRepoPath - Path to cloned template repository
  */
 async function createSingleExample(exampleName, outputDir, tempRepoPath) {
     const example = config_1.EXAMPLES[exampleName];
@@ -91,31 +90,23 @@ async function createSingleExample(exampleName, outputDir, tempRepoPath) {
     if (!contractName) {
         throw new Error("Could not extract contract name");
     }
-    // Step 1: Copy template and clean up
+    // 1. Copy template and clean up
     (0, utils_1.copyDirectoryRecursive)(templateDir, outputDir);
     (0, utils_1.cleanupTemplate)(outputDir);
-    // Step 2: Download example contract
+    // 2. Download example contract and dependencies
     await (0, utils_1.downloadFileFromGitHub)(example.contract, path.join(outputDir, "contracts", `${contractName}.sol`));
-    // Download contract dependencies if specified
     if (example.dependencies) {
         await downloadDependencies(example.dependencies, outputDir);
     }
-    // Step 3: Download test file
+    // 3. Download test file
     await (0, utils_1.downloadFileFromGitHub)(example.test, path.join(outputDir, "test", path.basename(example.test)));
-    // Step 4: Update deploy script and package.json
+    // 4. Update deploy script and package.json
     fs.writeFileSync(path.join(outputDir, "deploy", "deploy.ts"), (0, utils_1.generateDeployScript)(contractName));
     (0, utils_1.updateProjectPackageJson)(outputDir, `fhevm-example-${exampleName}`, example.description, example.npmDependencies);
-    // Initialize git repository
     await initGitRepo(outputDir);
 }
-// =============================================================================
-// Category Project Builder
-// =============================================================================
 /**
  * Creates a category project with multiple examples
- * @param categoryName - Name of the category to create
- * @param outputDir - Target directory for the project
- * @param tempRepoPath - Path to cloned template repository
  */
 async function createCategoryProject(categoryName, outputDir, tempRepoPath) {
     const category = config_1.CATEGORIES[categoryName];
@@ -123,10 +114,10 @@ async function createCategoryProject(categoryName, outputDir, tempRepoPath) {
         throw new Error(`Unknown category: ${categoryName}`);
     }
     const templateDir = path.join(tempRepoPath, utils_1.TEMPLATE_DIR_NAME);
-    // Step 1: Copy template and clean up
+    // 1. Copy template and clean up
     (0, utils_1.copyDirectoryRecursive)(templateDir, outputDir);
     (0, utils_1.cleanupTemplate)(outputDir);
-    // Step 2: Download all contracts and tests
+    // 2. Download all contracts and tests
     for (const item of category.contracts) {
         const contractName = (0, utils_1.getContractName)(item.sol);
         if (contractName) {
@@ -136,11 +127,16 @@ async function createCategoryProject(categoryName, outputDir, tempRepoPath) {
             await (0, utils_1.downloadFileFromGitHub)(item.test, path.join(outputDir, "test", path.basename(item.test)));
         }
     }
-    // Collect dependencies from all examples in this category
+    // 3. Collect and download dependencies
     const allDependencies = new Set();
     const allNpmDependencies = {};
     for (const [exampleName, exampleConfig] of Object.entries(config_1.EXAMPLES)) {
-        if (exampleConfig.category === category.name.replace(" Examples", "")) {
+        // Check if example belongs to this category
+        const configCategoryLower = exampleConfig.category
+            .toLowerCase()
+            .replace(/\s+/g, "");
+        if (configCategoryLower === categoryName ||
+            exampleConfig.category === category.name.replace(" Examples", "")) {
             if (exampleConfig.dependencies) {
                 exampleConfig.dependencies.forEach((dep) => allDependencies.add(dep));
             }
@@ -149,12 +145,67 @@ async function createCategoryProject(categoryName, outputDir, tempRepoPath) {
             }
         }
     }
-    // Download all collected dependencies
     if (allDependencies.size > 0) {
         await downloadDependencies(Array.from(allDependencies), outputDir);
     }
-    // Step 3: Update package.json
+    // 4. Update package.json
     (0, utils_1.updateProjectPackageJson)(outputDir, `fhevm-examples-${categoryName}`, undefined, allNpmDependencies);
-    // Initialize git repository
     await initGitRepo(outputDir);
 }
+// =============================================================================
+// Specialized Builders
+// =============================================================================
+/**
+ * Creates a temporary test project using LOCAL files (used by maintenance.ts)
+ */
+async function createLocalTestProject(exampleNames, outputDir) {
+    const rootDir = (0, utils_1.getRootDir)();
+    const templateDir = (0, utils_1.getTemplateDir)();
+    // 1. Setup base project from local template
+    (0, utils_1.copyDirectoryRecursive)(templateDir, outputDir);
+    (0, utils_1.cleanupTemplate)(outputDir);
+    const allNpmDeps = {};
+    const allContractDeps = new Set();
+    // 2. Copy local example files
+    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);
+        }
+    }
+    // 3. Copy dependencies
+    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);
+        }
+    }
+    // 4. Finalize project
+    (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);
+    }
+}

package/dist/scripts/doctor.d.ts

@@ -1,3 +1,11 @@
 #!/usr/bin/env node
+/**
+ * FHEVM Doctor - Environment and project integrity validator
+ *
+ * Checks:
+ *   - Node.js version compatibility
+ *   - Git installation
+ *   - Config.ts path integrity (validates all example paths)
+ */
 export {};
 //# sourceMappingURL=doctor.d.ts.map

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

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

package/dist/scripts/doctor.js

@@ -1,5 +1,13 @@
 #!/usr/bin/env node
 "use strict";
+/**
+ * FHEVM Doctor - Environment and project integrity validator
+ *
+ * Checks:
+ *   - Node.js version compatibility
+ *   - Git installation
+ *   - Config.ts path integrity (validates all example paths)
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

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

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 /**
- * Auto-Discovery Config Generator
+ * Auto-Discovery Config Generator - Automatically updates project configuration.
  *
- * Scans contracts/ directory and generates config.ts automatically
- * Extracts metadata from @notice tags and folder structure.
+ * Scans the contracts/ directory and generates scripts/config.ts.
+ * Extracts metadata from @notice tags and infers category structure.
  */
 export {};
 //# sourceMappingURL=generate-config.d.ts.map

package/dist/scripts/generate-config.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * Auto-Discovery Config Generator
+ * Auto-Discovery Config Generator - Automatically updates project configuration.
  *
- * Scans contracts/ directory and generates config.ts automatically
- * Extracts metadata from @notice tags and folder structure.
+ * Scans the contracts/ directory and generates scripts/config.ts.
+ * Extracts metadata from @notice tags and infers category structure.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -39,10 +39,14 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const utils_1 = require("./utils");
+const picocolors_1 = __importDefault(require("picocolors"));
 const ROOT_DIR = path.resolve(__dirname, "..");
 const CONTRACTS_DIR = path.join(ROOT_DIR, "contracts");
 const TEST_DIR = path.join(ROOT_DIR, "test");
@@ -293,21 +297,25 @@ export function getDocsFileName(exampleName: string): string {
 // Main
 // =============================================================================
 function main() {
-    utils_1.log.info("🔍 Scanning contracts...\n");
+    utils_1.log.info(`🔍 Scanning examples in: ${picocolors_1.default.cyan("contracts/")}\n`);
     const contracts = scanContracts();
-    utils_1.log.success(`✅ Found ${contracts.length} contracts\n`);
+    if (contracts.length === 0) {
+        utils_1.log.error("❌ No valid contracts discovered. Check for @notice tags.");
+        process.exit(1);
+    }
+    utils_1.log.success(`✅ Found ${picocolors_1.default.bold(String(contracts.length))} contracts\n`);
     const categoryCount = {};
     for (const c of contracts) {
         categoryCount[c.category] = (categoryCount[c.category] || 0) + 1;
     }
-    utils_1.log.message("📊 By category:");
+    utils_1.log.message(picocolors_1.default.bold("📊 Discovery Summary:"));
     for (const [category, count] of Object.entries(categoryCount)) {
-        utils_1.log.message(`   ${category}: ${count}`);
+        utils_1.log.message(`   ${picocolors_1.default.dim("•")} ${picocolors_1.default.yellow(category.padEnd(25))} ${picocolors_1.default.cyan(String(count).padStart(2))} examples`);
     }
-    utils_1.log.message("\n📝 Generating config...");
+    utils_1.log.message(`\n📝 Generating: ${picocolors_1.default.cyan(path.relative(ROOT_DIR, OUTPUT_FILE))}...`);
     const configContent = generateConfigFile(contracts);
     fs.writeFileSync(OUTPUT_FILE, configContent);
-    utils_1.log.success(`✅ Config generated: ${path.relative(ROOT_DIR, OUTPUT_FILE)}`);
+    utils_1.log.success(`\n✨ Configuration updated successfully!`);
 }
 const isMainModule = process.argv[1]?.includes("generate-config");
 if (isMainModule) {

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

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 /**
- * Generate Documentation - GitBook Documentation Generator
+ * Documentation Generator - Creates GitBook-compatible markdown docs.
  *
- * Generates GitBook-compatible markdown documentation for FHEVM examples.
+ * Processes FHEVM examples to produce structured documentation,
+ * including contract descriptions and automated index updates.
  */
 export declare function handleInteractiveDocs(): Promise<void>;
 export declare function handleDirect(args: string[]): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"generate-docs.d.ts","sourceRoot":"","sources":["../../scripts/generate-docs.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAuEH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiE3D;AAMD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhE"}
+{"version":3,"file":"generate-docs.d.ts","sourceRoot":"","sources":["../../scripts/generate-docs.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAuEH,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

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * Generate Documentation - GitBook Documentation Generator
+ * Documentation Generator - Creates GitBook-compatible markdown docs.
  *
- * Generates GitBook-compatible markdown documentation for FHEVM examples.
+ * Processes FHEVM examples to produce structured documentation,
+ * including contract descriptions and automated index updates.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;

package/dist/scripts/help.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Help Menu - CLI Usage and Documentation.
+ */
+/**
+ * Displays the CLI help menu.
+ * Adapts content based on LOCAL_DEV environment variable.
+ */
+export declare function showHelp(): void;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../scripts/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAgF/B"}

package/dist/scripts/help.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Help Menu - CLI Usage and Documentation.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showHelp = showHelp;
+const picocolors_1 = __importDefault(require("picocolors"));
+const config_1 = require("./config");
+/**
+ * Displays the CLI help menu.
+ * Adapts content based on LOCAL_DEV environment variable.
+ */
+function showHelp() {
+    const isDev = process.env.LOCAL_DEV === "1";
+    const cmd = isDev ? "npm run" : "npx";
+    const createCmd = isDev ? "create" : "create-fhevm-example";
+    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(`${cmd} ${createCmd}`)}                  ${picocolors_1.default.dim("→")} Interactive mode ${picocolors_1.default.yellow("(recommended)")}
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white(`${cmd} ${createCmd}`)} ${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(`${cmd} ${createCmd}`)} ${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(`${cmd} ${createCmd}`)} ${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
+
+${isDev
+        ? `
+${picocolors_1.default.cyan(picocolors_1.default.bold("🛠️  DEVELOPER TOOLS"))}
+
+  ${picocolors_1.default.green("npm run create:docs")}      Generate documentation
+  ${picocolors_1.default.green("npm run generate:config")}  Update contract registry
+  ${picocolors_1.default.green("npm run doctor")}           Run system health check
+  ${picocolors_1.default.green("npm run test:all")}         Run bulk project tests
+`
+        : ""}
+
+${picocolors_1.default.cyan(picocolors_1.default.bold("⚡ EXAMPLES"))}
+
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white(`${cmd} ${createCmd}`)} ${picocolors_1.default.green("--example")} ${picocolors_1.default.yellow("fhe-counter")}
+  ${picocolors_1.default.dim("$")} ${picocolors_1.default.white(`${cmd} ${createCmd}`)} ${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(`${cmd} ${createCmd}`)} ${picocolors_1.default.green("--add")}
+
+${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")}
+`);
+}