create-fhevm-example 1.2.3 → 1.3.1

package/README.md

@@ -1,8 +1,19 @@
-# create-fhevm-example
+<p align="center">
+  <strong>Create FHEVM example projects with a single command</strong>
+</p>
 
-Create FHEVM example projects with a single command.
+<p align="center">
+  <a href="https://docs.zama.org/protocol"><img src="https://img.shields.io/badge/docs-fhevm-blue" alt="FHEVM Docs"></a>
+  <a href="https://github.com/NecipAkgz/fhevm-example-factory/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-BSD--3--Clause--Clear-green" alt="License"></a>
+  <a href="#"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="Node"></a>
+</p>
 
-## Quick Start
+---
+
+
+## 🚀 Quick Start
+
+Launch the interactive CLI to create your project:
 
 ```bash
 npx create-fhevm-example
@@ -10,9 +21,29 @@ npx create-fhevm-example
 
 ![🎬 CLI Demo](https://i.ibb.co/d4YWwh7V/package.gif)
 
-This launches an interactive CLI that guides you through creating a project.
+---
+
+## 🔧 Add to Existing Hardhat Project
 
-## Direct Mode
+Already have a Hardhat project? Inject FHEVM capabilities without starting from scratch:
+
+```bash
+npx create-fhevm-example --add
+npx create-fhevm-example --add --target ./my-existing-project
+```
+
+This will:
+- ✅ Detect your Hardhat project
+- ✅ Add FHEVM dependencies to `package.json`
+- ✅ Update `hardhat.config.ts` with FHEVM plugin
+- ✅ Add an example contract and test of your choice
+- ✅ Handle file conflicts intelligently (skip/overwrite/rename)
+
+---
+
+## ⚡ Quick Commands
+
+Skip the prompts and create projects directly:
 
 ```bash
 # Create single example
@@ -25,183 +56,78 @@ npx create-fhevm-example --category basic
 npx create-fhevm-example --add
 npx create-fhevm-example --add --target ./my-existing-project
 
-# With options
-npx create-fhevm-example --example fhe-counter --output ./my-project --install
+# With auto-install and testing
+npx create-fhevm-example --example fhe-counter --output ./my-project --install --test
 ```
 
-## CLI Options
+---
+
+## 📋 CLI Options
 
 | Option | Description |
-|--------|-------------|
+| :--- | :--- |
 | `--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 |
+| `--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 |
 
-## Available Examples
+---
+
+## 📦 Available Examples
 
-**Basic**: `fhe-counter`, `encrypt-single-value`, `encrypt-multiple-values`, `user-decrypt-single-value`, `user-decrypt-multiple-values`, `public-decrypt-single-value`, `public-decrypt-multiple-values`
+**Basic Encryption** (3): `fhe-counter`, `encrypt-single-value`, `encrypt-multiple-values`
 
-**FHE Operations**: `fhe-add`, `fhe-if-then-else`, `fhe-arithmetic`, `fhe-comparison`
+**Decryption** (4): `user-decrypt-single-value`, `user-decrypt-multiple-values`, `public-decrypt-single-value`, `public-decrypt-multiple-values`
 
-**Concepts**: `fhe-access-control`, `fhe-input-proof`, `fhe-handles`, `fhe-anti-patterns`
+**FHE Operations** (4): `fhe-add`, `fhe-if-then-else`, `fhe-arithmetic`, `fhe-comparison`
 
-**Gaming**: `rock-paper-scissors`, `encrypted-lottery`, `encrypted-poker`
+**Concepts** (4): `fhe-access-control`, `fhe-input-proof`, `fhe-handles`, `fhe-anti-patterns`
 
-**OpenZeppelin**: `erc7984`, `erc7984-erc20-wrapper`, `swap-erc7984-to-erc20`, `swap-erc7984-to-erc7984`, `vesting-wallet`
+**Gaming** (3): `rock-paper-scissors`, `encrypted-lottery`, `encrypted-poker`
 
-**Advanced**: `blind-auction`, `hidden-voting`, `private-payroll`, `encrypted-escrow`, `private-kyc`
+**OpenZeppelin** (5): `erc7984`, `erc7984-erc20-wrapper`, `swap-erc7984-to-erc20`, `swap-erc7984-to-erc7984`, `vesting-wallet`
 
-## Available Categories
+**Advanced** (5): `blind-auction`, `hidden-voting`, `private-payroll`, `encrypted-escrow`, `private-kyc`
 
-| Category | Description |
-|----------|-------------|
-| `basic` | Basic encryption and counter examples (1 contract) |
-| `basicencryption` | Single and multiple value encryption (2 contracts) |
-| `basicdecryption` | Public and user decryption examples (4 contracts) |
-| `basicfheoperations` | FHE arithmetic and comparison (4 contracts) |
-| `concepts` | Access control, proofs, handles, anti-patterns (4 contracts) |
-| `gaming` | Rock-paper-scissors, lottery, poker (3 contracts) |
-| `openzeppelin` | ERC7984, wrappers, swaps, vesting (5 contracts) |
-| `advanced` | Blind auction, voting, payroll, escrow, KYC (5 contracts) |
+---
 
-## What Gets Created
+## ✅ What Gets Created
 
-### New Projects (--example / --category)
+### New Projects (`--example` / `--category`)
 
 - ✅ Hardhat configuration for FHEVM
-- ✅ Smart contracts and test files
+- ✅ Smart contracts and comprehensive tests
 - ✅ Deployment scripts
 - ✅ All dependencies configured
 
-### Existing Projects (--add)
+### Existing Projects (`--add`)
 
 - ✅ FHEVM dependencies added to `package.json`
 - ✅ FHEVM plugin imported in `hardhat.config.ts`
 - ✅ Example contract and test of your choice
-- ✅ Intelligent file conflict handling (skip/overwrite/rename)
+- ✅ Intelligent conflict handling (skip/overwrite/rename)
 
-## Requirements
+---
+
+## 💻 Requirements
 
 - Node.js >= 20
 - Git
 
 ---
 
-## Developer Only
-
->This section is for contributors and maintainers of the package.
+## 🔗 Learn More
 
-### File Structure
-
-The package follows a modular structure similar to the main project's `scripts/` directory:
-
-```
-src/
-├── index.ts      # Main entry point + CLI modes (~320 lines)
-├── builders.ts   # createSingleExample, createCategoryProject (~250 lines)
-├── ui.ts         # Interactive prompts + install/test commands (~180 lines)
-├── utils.ts      # Utilities + constants + validation + logging (~350 lines)
-├── config.ts     # Auto-generated examples & categories (~440 lines)
-└── add-mode.ts   # Add FHEVM to existing projects (~370 lines)
-```
-
-**Key Components:**
-- `index.ts` - Main CLI entry point, handles interactive and direct modes
-- `builders.ts` - Project creation logic (single example, category project)
-- `ui.ts` - User interface (prompts + commands, replaces old prompts.ts + commands.ts)
-- `utils.ts` - File operations, constants, validation, logging utilities
-- `config.ts` - Auto-generated configuration from monorepo contracts
-- `add-mode.ts` - Add FHEVM to existing Hardhat projects
-
-**Design Principles:**
-- **Modular**: Each file has a single responsibility
-- **Aligned**: Mirrors main project's `scripts/` structure
-- **Maintainable**: Easy to understand and update
-- **Type-safe**: Full TypeScript coverage
-- **Consistent**: Standardized logging, error handling, validation
-
-### Configuration
-
-The CLI uses a configuration file that defines all available examples and categories. This file is **auto-generated** by scanning the monorepo's contracts directory.
-
-**Generated File**: `src/config.ts` (do not edit manually)
-
-To customize the repository URL or branch:
-
-```typescript
-// In src/config.ts
-export const REPO_URL = "https://github.com/YourUsername/your-repo";
-export const REPO_BRANCH = "main";
-```
-
-### Adding New Examples
-
-To add a new example to the CLI:
-
-1. **Create contract with `@notice` tag** in the main repository:
-   ```solidity
-   /**
-    * @notice Your example description - auto-discovered!
-    */
-   contract YourExample { }
-   ```
-
-2. **Update package config** (from monorepo):
-   ```bash
-   cd packages/create-fhevm-example
-   npm run update:config  # Scans ../../contracts, generates src/config.ts
-   ```
-
-3. **Publish**:
-   ```bash
-   npm version patch  # Increments version
-   npm publish        # Auto-runs: update:config → build → publish
-   ```
-
-   The `prepublishOnly` hook automatically:
-   - Updates config by scanning monorepo contracts (if available)
-   - Builds TypeScript to `dist/`
-   - Publishes to NPM
-
-### Local Development
-
-```bash
-# Clone and setup
-git clone https://github.com/NecipAkgz/fhevm-example-factory.git
-cd fhevm-example-factory/packages/create-fhevm-example
-npm install
-
-# Build
-npm run build
-
-# Test locally
-npm link
-create-fhevm-example --help
-
-# Unlink when done
-npm unlink -g create-fhevm-example
-```
-
-### Scripts
-
-- `npm run build` - Compile TypeScript to `dist/`
-- `npm run dev` - Watch mode for development
-- `npm run update:config` - Regenerate config from monorepo contracts
-- `npm run prepublishOnly` - Auto-runs before publish (update:config + build)
+- 📖 [FHEVM Documentation](https://docs.zama.org/protocol)
+- 💻 [Source Repository](https://github.com/NecipAkgz/fhevm-example-factory)
+- 🌐 [Zama](https://www.zama.ai/)
 
 ---
 
-## Learn More
-
-- [FHEVM Documentation](https://docs.zama.org/protocol)
-- [Example Repository](https://github.com/NecipAkgz/fhevm-example-factory)
-- [Zama](https://www.zama.ai/)
-
-## License
+## 📄 License
 
 BSD-3-Clause-Clear

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

@@ -0,0 +1,11 @@
+/**
+ * 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
+ */
+export declare function runAddMode(targetDir?: string): Promise<void>;
+//# sourceMappingURL=add-mode.d.ts.map

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

@@ -0,0 +1 @@
+{"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/{add-mode.js → scripts/add-mode.js}

@@ -1,19 +1,64 @@
-import * as p from "@clack/prompts";
-import pc from "picocolors";
-import * as fs from "fs";
-import * as path from "path";
-import { EXAMPLES } from "./config.js";
-import { downloadFileFromGitHub, getContractName } from "./utils.js";
+"use strict";
+/**
+ * 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;
+    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.runAddMode = runAddMode;
+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 DETECTION
 // =============================================================================
 /**
  * Detects if the target directory is a valid Hardhat project
  */
-export function detectHardhatProject(targetDir) {
+function detectHardhatProject(targetDir) {
     const packageJsonPath = path.join(targetDir, "package.json");
     const hardhatConfigTs = path.join(targetDir, "hardhat.config.ts");
-    const hardhatConfigJs = path.join(targetDir, "hardhat.config.js");
+    const hardhatConfigJs = path.join(targetDir, "hardhat.config");
     if (!fs.existsSync(packageJsonPath)) {
         return false;
     }
@@ -33,20 +78,16 @@ export function detectHardhatProject(targetDir) {
 /**
  * Updates package.json with FHEVM dependencies
  */
-export function updatePackageJson(targetDir) {
+function updatePackageJson(targetDir) {
     const packageJsonPath = path.join(targetDir, "package.json");
     const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
-    // Add dependencies
     packageJson.dependencies = {
         ...packageJson.dependencies,
-        "encrypted-types": "^0.0.4",
-        "@fhevm/solidity": "^0.9.1",
+        ...utils_1.FHEVM_DEPENDENCIES.dependencies,
     };
-    // Add devDependencies
     packageJson.devDependencies = {
         ...packageJson.devDependencies,
-        "@fhevm/hardhat-plugin": "^0.3.0-1",
-        "@zama-fhe/relayer-sdk": "^0.3.0-5",
+        ...utils_1.FHEVM_DEPENDENCIES.devDependencies,
     };
     fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
 }
@@ -56,9 +97,9 @@ export function updatePackageJson(targetDir) {
 /**
  * Updates hardhat.config.ts/js with FHEVM plugin import
  */
-export function updateHardhatConfig(targetDir) {
+function updateHardhatConfig(targetDir) {
     const configPathTs = path.join(targetDir, "hardhat.config.ts");
-    const configPathJs = path.join(targetDir, "hardhat.config.js");
+    const configPathJs = path.join(targetDir, "hardhat.config");
     const actualPath = fs.existsSync(configPathTs)
         ? configPathTs
         : fs.existsSync(configPathJs)
@@ -68,13 +109,10 @@ export function updateHardhatConfig(targetDir) {
         throw new Error("hardhat.config.ts or hardhat.config.js not found");
     }
     let content = fs.readFileSync(actualPath, "utf-8");
-    // Check if already has FHEVM plugin
     if (content.includes("@fhevm/hardhat-plugin")) {
-        return; // Already configured
+        return;
     }
-    // Add import at the top (after other imports)
     const importStatement = 'import "@fhevm/hardhat-plugin";\n';
-    // Find the last import statement
     const lines = content.split("\n");
     let lastImportIndex = -1;
     for (let i = 0; i < lines.length; i++) {
@@ -87,7 +125,6 @@ export function updateHardhatConfig(targetDir) {
         lines.splice(lastImportIndex + 1, 0, importStatement);
     }
     else {
-        // No imports found, add at the beginning
         lines.unshift(importStatement);
     }
     content = lines.join("\n");
@@ -99,12 +136,12 @@ export function updateHardhatConfig(targetDir) {
 /**
  * Adds example contract and test files to the project
  */
-export async function addExampleFiles(exampleName, targetDir) {
-    const example = EXAMPLES[exampleName];
+async function addExampleFiles(exampleName, targetDir) {
+    const example = config_1.EXAMPLES[exampleName];
     if (!example) {
         throw new Error(`Unknown example: ${exampleName}`);
     }
-    const contractName = getContractName(example.contract);
+    const contractName = (0, utils_1.getContractName)(example.contract);
     if (!contractName) {
         throw new Error("Could not extract contract name");
     }
@@ -130,21 +167,20 @@ export async function addExampleFiles(exampleName, targetDir) {
         }
         else if (action === "rename") {
             contractDest = path.join(targetDir, "contracts", `${contractName}_fhevm.sol`);
-            await downloadFileFromGitHub(example.contract, contractDest);
+            await (0, utils_1.downloadFileFromGitHub)(example.contract, contractDest);
             p.log.success(`Added: ${contractName}_fhevm.sol`);
         }
         else {
-            await downloadFileFromGitHub(example.contract, contractDest);
+            await (0, utils_1.downloadFileFromGitHub)(example.contract, contractDest);
             p.log.success(`Overwritten: ${contractName}.sol`);
         }
     }
     else {
-        // Ensure contracts directory exists
         const contractsDir = path.join(targetDir, "contracts");
         if (!fs.existsSync(contractsDir)) {
             fs.mkdirSync(contractsDir, { recursive: true });
         }
-        await downloadFileFromGitHub(example.contract, contractDest);
+        await (0, utils_1.downloadFileFromGitHub)(example.contract, contractDest);
         p.log.success(`Added: ${contractName}.sol`);
     }
     // Handle test file
@@ -165,29 +201,27 @@ export async function addExampleFiles(exampleName, targetDir) {
             p.log.info(`Skipped: ${testFileName}`);
         }
         else {
-            await downloadFileFromGitHub(example.test, testDest);
+            await (0, utils_1.downloadFileFromGitHub)(example.test, testDest);
             p.log.success(`Overwritten: ${testFileName}`);
         }
     }
     else {
-        // Ensure test directory exists
         const testDir = path.join(targetDir, "test");
         if (!fs.existsSync(testDir)) {
             fs.mkdirSync(testDir, { recursive: true });
         }
-        await downloadFileFromGitHub(example.test, testDest);
+        await (0, utils_1.downloadFileFromGitHub)(example.test, testDest);
         p.log.success(`Added: ${testFileName}`);
     }
     // Handle contract dependencies
     if (example.dependencies) {
         p.log.message("");
-        p.log.message(pc.bold("Downloading contract dependencies..."));
+        p.log.message(picocolors_1.default.bold("Downloading contract dependencies..."));
         for (const depPath of example.dependencies) {
             const relativePath = depPath.replace(/^contracts\//, "");
             const depDestPath = path.join(targetDir, "contracts", relativePath);
             const depDestDir = path.dirname(depDestPath);
             const depName = path.basename(depPath);
-            // Create directory if needed
             if (!fs.existsSync(depDestDir)) {
                 fs.mkdirSync(depDestDir, { recursive: true });
             }
@@ -195,7 +229,7 @@ export async function addExampleFiles(exampleName, targetDir) {
                 p.log.info(`Skipped (exists): ${depName}`);
             }
             else {
-                await downloadFileFromGitHub(depPath, depDestPath);
+                await (0, utils_1.downloadFileFromGitHub)(depPath, depDestPath);
                 p.log.success(`Added: ${depName}`);
             }
         }
@@ -203,7 +237,7 @@ export async function addExampleFiles(exampleName, targetDir) {
     // Handle npm dependencies
     if (example.npmDependencies) {
         p.log.message("");
-        p.log.message(pc.bold("Adding npm dependencies to package.json..."));
+        p.log.message(picocolors_1.default.bold("Adding npm dependencies to package.json..."));
         const packageJsonPath = path.join(targetDir, "package.json");
         const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
         if (!packageJson.dependencies) {
@@ -231,26 +265,23 @@ export async function addExampleFiles(exampleName, targetDir) {
 /**
  * Main function to add FHEVM capabilities to an existing Hardhat project
  */
-export async function runAddMode(targetDir) {
+async function runAddMode(targetDir) {
     console.clear();
-    p.intro(pc.bgCyan(pc.black(" ⚡ FHEVM Example Factory - Add Mode ")));
-    // Determine target directory
+    p.intro(picocolors_1.default.bgCyan(picocolors_1.default.black(" ⚡ FHEVM Example Factory - Add Mode ")));
     const projectDir = targetDir || process.cwd();
     const absoluteDir = path.resolve(projectDir);
-    // Step 1: Detect Hardhat project
     const s = p.spinner();
     s.start("Detecting Hardhat project...");
     if (!detectHardhatProject(absoluteDir)) {
-        s.stop(pc.red("✗ Not a valid Hardhat project"));
+        s.stop(picocolors_1.default.red("✗ Not a valid Hardhat project"));
         p.log.error("This directory does not contain a valid Hardhat project.");
-        p.log.message(pc.dim("Make sure package.json and hardhat.config.ts/js exist and hardhat is installed."));
+        p.log.message(picocolors_1.default.dim("Make sure package.json and hardhat.config.ts/js exist and hardhat is installed."));
         process.exit(1);
     }
-    s.stop(pc.green("✓ Valid Hardhat project detected"));
-    // Step 2: Select example
+    s.stop(picocolors_1.default.green("✓ Valid Hardhat project detected"));
     const exampleName = await p.select({
         message: "Which FHEVM example would you like to add?",
-        options: Object.entries(EXAMPLES).map(([key, config]) => ({
+        options: Object.entries(config_1.EXAMPLES).map(([key, config]) => ({
             value: key,
             label: config.title,
             hint: config.category,
@@ -261,29 +292,26 @@ export async function runAddMode(targetDir) {
         process.exit(0);
     }
     p.log.message("");
-    // Step 3: Update package.json
     s.start("Updating package.json with FHEVM dependencies...");
     try {
         updatePackageJson(absoluteDir);
-        s.stop(pc.green("✓ package.json updated"));
+        s.stop(picocolors_1.default.green("✓ package.json updated"));
     }
     catch (error) {
-        s.stop(pc.red("✗ Failed to update package.json"));
+        s.stop(picocolors_1.default.red("✗ Failed to update package.json"));
         throw error;
     }
-    // Step 4: Update hardhat.config
     s.start("Updating hardhat.config with FHEVM plugin...");
     try {
         updateHardhatConfig(absoluteDir);
-        s.stop(pc.green("✓ hardhat.config updated"));
+        s.stop(picocolors_1.default.green("✓ hardhat.config updated"));
     }
     catch (error) {
-        s.stop(pc.red("✗ Failed to update hardhat.config"));
+        s.stop(picocolors_1.default.red("✗ Failed to update hardhat.config"));
         throw error;
     }
-    // Step 5: Add example files
     p.log.message("");
-    p.log.message(pc.bold("Adding example files..."));
+    p.log.message(picocolors_1.default.bold("Adding example files..."));
     try {
         await addExampleFiles(exampleName, absoluteDir);
     }
@@ -291,11 +319,9 @@ export async function runAddMode(targetDir) {
         p.log.error("Failed to add example files");
         throw error;
     }
-    // Success!
     p.log.message("");
-    p.log.success(pc.green("✨ FHEVM capabilities added successfully!"));
+    p.log.success(picocolors_1.default.green("✨ FHEVM capabilities added successfully!"));
     p.log.message("");
-    p.note(`${pc.dim("$")} npm install\n${pc.dim("$")} npm run compile\n${pc.dim("$")} npm run test`, "🚀 Next Steps");
-    p.outro(pc.green("✅ Setup complete. Happy encrypting!"));
+    p.note(`${picocolors_1.default.dim("$")} npm install\n${picocolors_1.default.dim("$")} npm run compile\n${picocolors_1.default.dim("$")} npm run test`, "🚀 Next Steps");
+    p.outro(picocolors_1.default.green("✅ Setup complete. Happy encrypting!"));
 }
-//# sourceMappingURL=add-mode.js.map

package/dist/scripts/builders.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Project Builders - Core logic for scaffolding FHEVM projects.
+ *
+ * Handles the creation of single example projects, category-based
+ * project bundles, and specialized test environments.
+ */
+/**
+ * Creates a single example project from the template
+ */
+export declare function createSingleExample(exampleName: string, outputDir: string, tempRepoPath: string): Promise<void>;
+/**
+ * Creates a category project with multiple examples
+ */
+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

@@ -0,0 +1 @@
+{"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"}