feat: create-voltx CLI (#10)

* feat: add cli package for project scaffolding

* feat: add comprehensive CLI documentation and tests

ROADMAP.md

···
 
 ## Parking Lot
 
+### IIFE Build Support
+
+Provide an IIFE (Immediately Invoked Function Expression) build target for VoltX.js to support direct `<script>` tag usage without module systems.
+
+**Deliverables:**
+
+- IIFE build output (voltx.iife.js) alongside ESM build
+- Global `Volt` namespace for browser environments
+- CDN-friendly distribution (unpkg, jsdelivr)
+- Update build pipeline to generate IIFE bundle
+- Document usage: `<script src="voltx.iife.min.js"></script>`
+- Ensure plugins work with IIFE build
+- Add IIFE examples to documentation
+
 ### Evaluator & Binder Hardening
 
 All expression evaluation now flows through a cached `new Function` compiler guarded by a hardened scope proxy, with the binder slimmed into a directive registry so plugins self-register while tests verify the sandboxed error surfaces.

cli/README.md

···
+# create-voltx
+
+CLI for creating and managing VoltX.js applications.
+
+## Usage
+
+### Create a New Project
+
+```bash
+# Using pnpm (recommended)
+pnpm create voltx my-app
+
+# Using npm
+npm create voltx@latest my-app
+
+# Using npx
+npx create-voltx my-app
+```
+
+### Commands
+
+#### `init [project-name]`
+
+Create a new VoltX.js project with interactive template selection.
+
+```bash
+voltx init my-app
+```
+
+**Templates:**
+
+- **Minimal** - Basic VoltX.js app with counter
+- **With Router** - Multi-page app with routing
+- **With Plugins** - All plugins demo
+- **Styles Only** - Just HTML + CSS, no framework
+
+#### `dev`
+
+Start Vite development server.
+
+```bash
+voltx dev [--port 3000] [--open]
+```
+
+#### `build`
+
+Build project for production.
+
+```bash
+voltx build [--out dist]
+```
+
+#### `download`
+
+Download VoltX.js assets from CDN.
+
+```bash
+voltx download [--version latest] [--output .]
+```
+
+## Documentation
+
+See the [CLI Guide](https://stormlightlabs.github.io/volt/cli) for complete documentation.
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build CLI
+pnpm build
+
+# Run tests
+pnpm test
+
+# Type check
+pnpm typecheck
+```
+
+## License
+
+MIT

cli/package.json

···
+{
+  "name": "create-voltx",
+  "version": "0.1.0",
+  "description": "CLI for creating and managing VoltX.js applications",
+  "type": "module",
+  "author": "Owais Jamil",
+  "license": "MIT",
+  "repository": { "type": "git", "url": "https://github.com/stormlightlabs/volt.git", "directory": "cli" },
+  "bin": { "create-voltx": "./dist/index.js", "voltx": "./dist/index.js" },
+  "files": ["dist", "templates"],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": { ".": "./dist/index.js", "./package.json": "./package.json" },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": { "tsdown": "^0.15.6", "@vitest/coverage-v8": "^3.2.4" },
+  "dependencies": { "chalk": "^5.6.2", "commander": "^14.0.1", "@inquirer/prompts": "^8.0.1" },
+  "keywords": ["voltx", "reactive", "framework", "cli", "scaffold", "create"]
+}

cli/src/commands/build.ts

···
+import { echo } from "$utils/echo.js";
+import { spawn } from "node:child_process";
+
+/**
+ * Builds the VoltX.js project for production using Vite.
+ */
+export async function buildCommand(options: { outDir?: string } = {}): Promise<void> {
+  const outDir = options.outDir || "dist";
+
+  echo.title("\n⚡ Building VoltX.js project for production...\n");
+
+  try {
+    const { existsSync } = await import("node:fs");
+    if (!existsSync("index.html")) {
+      echo.warn("Warning: No index.html found in current directory");
+      echo.info("Are you in a VoltX.js project?\n");
+    }
+
+    const viteArgs = ["vite", "build", "--outDir", outDir];
+    const viteProcess = spawn("npx", viteArgs, { stdio: "inherit", shell: true });
+
+    viteProcess.on("error", (error) => {
+      echo.err("Failed to build project:", error);
+      process.exit(1);
+    });
+
+    viteProcess.on("exit", (code) => {
+      if (code === 0) {
+        echo.success(`\n✓ Build completed successfully!\n`);
+        echo.info(`Output directory: ${outDir}\n`);
+      } else if (code !== null) {
+        process.exit(code);
+      }
+    });
+  } catch (error) {
+    echo.err("Error building project:", error);
+    process.exit(1);
+  }
+}

cli/src/commands/dev.ts

···
+import { echo } from "$utils/echo.js";
+import { spawn } from "node:child_process";
+
+/**
+ * Starts a Vite development server for the current project.
+ */
+export async function devCommand(options: { port?: number; open?: boolean } = {}): Promise<void> {
+  const port = options.port || 3000;
+  const shouldOpen = options.open || false;
+
+  echo.title("\n⚡ Starting VoltX.js development server...\n");
+
+  try {
+    const { existsSync } = await import("node:fs");
+    if (!existsSync("index.html")) {
+      echo.warn("Warning: No index.html found in current directory");
+      echo.info("Are you in a VoltX.js project?\n");
+    }
+
+    const viteArgs = ["vite", "--port", port.toString(), "--host"];
+
+    if (shouldOpen) {
+      viteArgs.push("--open");
+    }
+
+    const viteProcess = spawn("npx", viteArgs, { stdio: "inherit", shell: true });
+
+    viteProcess.on("error", (error) => {
+      echo.err("Failed to start dev server:", error);
+      process.exit(1);
+    });
+
+    viteProcess.on("exit", (code) => {
+      if (code !== 0 && code !== null) {
+        process.exit(code);
+      }
+    });
+
+    process.on("SIGINT", () => {
+      viteProcess.kill("SIGINT");
+      process.exit(0);
+    });
+  } catch (error) {
+    echo.err("Error starting dev server:", error);
+    process.exit(1);
+  }
+}

cli/src/commands/download.ts

···
+import { downloadFile, getCDNUrls } from "$utils/download.js";
+import { echo } from "$utils/echo.js";
+import path from "node:path";
+
+/**
+ * Downloads VoltX.js assets (JS and/or CSS) from the CDN.
+ */
+export async function downloadCommand(
+  options: { version?: string; js?: boolean; css?: boolean; output?: string } = {},
+): Promise<void> {
+  const version = options.version || "latest";
+  const downloadJS = options.js !== false;
+  const downloadCSS = options.css !== false;
+  const outputDir = options.output || ".";
+
+  echo.title("\n⚡ Downloading VoltX.js assets...\n");
+
+  try {
+    const urls = getCDNUrls(version);
+
+    if (downloadJS) {
+      const jsPath = path.join(outputDir, "voltx.min.js");
+      echo.info(`Downloading voltx.min.js (${version})...`);
+      await downloadFile(urls.js, jsPath);
+      echo.ok(`✓ Downloaded: ${jsPath}`);
+    }
+
+    if (downloadCSS) {
+      const cssPath = path.join(outputDir, "voltx.min.css");
+      echo.info(`Downloading voltx.min.css (${version})...`);
+      await downloadFile(urls.css, cssPath);
+      echo.ok(`✓ Downloaded: ${cssPath}`);
+    }
+
+    echo.success("\n✓ Download completed successfully!\n");
+  } catch (error) {
+    echo.err("Failed to download assets:", error);
+    process.exit(1);
+  }
+}

cli/src/commands/init.ts

···
+import {
+  generateMinimalCSS,
+  generateMinimalHTML,
+  generateMinimalPackageJSON,
+  generateMinimalREADME,
+} from "$templates/minimal.js";
+import {
+  generateStylesCSS,
+  generateStylesHTML,
+  generateStylesPackageJSON,
+  generateStylesREADME,
+} from "$templates/styles.js";
+import {
+  generatePluginsCSS,
+  generatePluginsHTML,
+  generatePluginsPackageJSON,
+  generatePluginsREADME,
+} from "$templates/with-plugins.js";
+import {
+  generateRouterCSS,
+  generateRouterHTML,
+  generateRouterPackageJSON,
+  generateRouterREADME,
+} from "$templates/with-router.js";
+import { downloadFile, getCDNUrls } from "$utils/download.js";
+import { echo } from "$utils/echo.js";
+import { createFile, isEmptyOrMissing } from "$utils/files.js";
+import { input, select } from "@inquirer/prompts";
+import path from "node:path";
+
+type Template = "minimal" | "with-router" | "with-plugins" | "styles";
+
+/**
+ * Download VoltX.js assets to the project directory.
+ */
+async function downloadAssets(projectDir: string, template: Template): Promise<void> {
+  const urls = getCDNUrls();
+
+  echo.info("Downloading VoltX.js assets...");
+
+  const cssPath = path.join(projectDir, "voltx.min.css");
+  await downloadFile(urls.css, cssPath);
+  echo.ok(`  Downloaded: voltx.min.css`);
+
+  if (template !== "styles") {
+    const jsPath = path.join(projectDir, "voltx.min.js");
+    await downloadFile(urls.js, jsPath);
+    echo.ok(`  Downloaded: voltx.min.js`);
+  }
+}
+
+/**
+ * Generate project files based on the selected template.
+ */
+async function generateProjectFiles(projectDir: string, projectName: string, template: Template): Promise<void> {
+  echo.info("Generating project files...");
+
+  let htmlContent: string;
+  let cssContent: string;
+  let packageJsonContent: string;
+  let readmeContent: string;
+
+  switch (template) {
+    case "minimal":
+      htmlContent = generateMinimalHTML(projectName);
+      cssContent = generateMinimalCSS();
+      packageJsonContent = generateMinimalPackageJSON(projectName);
+      readmeContent = generateMinimalREADME(projectName);
+      break;
+
+    case "styles":
+      htmlContent = generateStylesHTML(projectName);
+      cssContent = generateStylesCSS();
+      packageJsonContent = generateStylesPackageJSON(projectName);
+      readmeContent = generateStylesREADME(projectName);
+      break;
+
+    case "with-router":
+      htmlContent = generateRouterHTML(projectName);
+      cssContent = generateRouterCSS();
+      packageJsonContent = generateRouterPackageJSON(projectName);
+      readmeContent = generateRouterREADME(projectName);
+      break;
+
+    case "with-plugins":
+      htmlContent = generatePluginsHTML(projectName);
+      cssContent = generatePluginsCSS();
+      packageJsonContent = generatePluginsPackageJSON(projectName);
+      readmeContent = generatePluginsREADME(projectName);
+      break;
+  }
+
+  await createFile(path.join(projectDir, "index.html"), htmlContent);
+  echo.ok(`  Created: index.html`);
+
+  await createFile(path.join(projectDir, "styles.css"), cssContent);
+  echo.ok(`  Created: styles.css`);
+
+  await createFile(path.join(projectDir, "package.json"), packageJsonContent);
+  echo.ok(`  Created: package.json`);
+
+  await createFile(path.join(projectDir, "README.md"), readmeContent);
+  echo.ok(`  Created: README.md`);
+}
+
+/**
+ * Init command implementation.
+ *
+ * Creates a new VoltX.js project with the selected template.
+ */
+export async function initCommand(projectName?: string): Promise<void> {
+  echo.title("\n⚡ Create VoltX.js App\n");
+
+  if (!projectName) {
+    projectName = await input({ message: "Project name:", default: "my-voltx-app" });
+
+    if (!projectName) {
+      echo.err("Project name is required");
+      process.exit(1);
+    }
+  }
+
+  const projectDir = path.resolve(process.cwd(), projectName);
+
+  if (!(await isEmptyOrMissing(projectDir))) {
+    echo.err(`Directory ${projectName} already exists and is not empty`);
+    process.exit(1);
+  }
+
+  const template = await select<Template>({
+    message: "Select a template:",
+    choices: [
+      { name: "Minimal", value: "minimal", description: "Basic VoltX.js app with counter" },
+      { name: "With Router", value: "with-router", description: "Multi-page app with routing" },
+      { name: "With Plugins", value: "with-plugins", description: "All plugins demo" },
+      { name: "Styles Only", value: "styles", description: "Just HTML + CSS, no framework" },
+    ],
+  });
+
+  try {
+    echo.text("");
+    await generateProjectFiles(projectDir, projectName, template);
+
+    echo.text("");
+    await downloadAssets(projectDir, template);
+
+    echo.success(`\n✓ Project created successfully!\n`);
+    echo.info(`Next steps:\n`);
+    echo.text(`  cd ${projectName}`);
+    echo.text(`  pnpm install`);
+    echo.text(`  pnpm dev\n`);
+  } catch (error) {
+    echo.err("Failed to create project:", error);
+    process.exit(1);
+  }
+}

cli/src/index.ts

···
+#!/usr/bin/env node
+/* eslint-disable unicorn/no-process-exit */
+import { buildCommand } from "$commands/build.js";
+import { devCommand } from "$commands/dev.js";
+import { downloadCommand } from "$commands/download.js";
+import { initCommand } from "$commands/init.js";
+import { echo } from "$utils/echo.js";
+import { Command } from "commander";
+
+const program = new Command();
+const isCreateMode = process.argv[1]?.includes("create-voltx");
+
+program.name(isCreateMode ? "create-voltx" : "voltx").description("CLI for creating and managing VoltX.js applications")
+  .version("0.1.0");
+
+program.command("init [project-name]").description("Create a new VoltX.js project").action(
+  async (projectName: string | undefined) => {
+    try {
+      await initCommand(projectName);
+    } catch (error) {
+      echo.err("Error creating project:", error);
+      process.exit(1);
+    }
+  },
+);
+
+program.command("dev").description("Start development server").option(
+  "-p, --port <port>",
+  "Port to run the dev server on",
+  "3000",
+).option("-o, --open", "Open browser automatically", false).action(
+  async (options: { port?: string; open?: boolean }) => {
+    try {
+      const port = options.port ? Number.parseInt(options.port, 10) : 3000;
+      await devCommand({ port, open: options.open });
+    } catch (error) {
+      echo.err("Error starting dev server:", error);
+      process.exit(1);
+    }
+  },
+);
+
+program.command("build").description("Build project for production").option("--out <dir>", "Output directory", "dist")
+  .action(async (options: { out?: string }) => {
+    try {
+      await buildCommand({ outDir: options.out });
+    } catch (error) {
+      echo.err("Error building project:", error);
+      process.exit(1);
+    }
+  });
+
+program.command("download").description("Download VoltX.js assets (JS and CSS)").option(
+  "--version <version>",
+  "VoltX.js version to download",
+  "latest",
+).option("--no-js", "Skip downloading JavaScript file").option("--no-css", "Skip downloading CSS file").option(
+  "-o, --output <dir>",
+  "Output directory",
+  ".",
+).action(async (options: { version?: string; js?: boolean; css?: boolean; output?: string }) => {
+  try {
+    await downloadCommand(options);
+  } catch (error) {
+    echo.err("Error downloading assets:", error);
+    process.exit(1);
+  }
+});
+
+if (isCreateMode && process.argv.length === 2) {
+  initCommand().catch((error) => {
+    echo.err("Error:", error);
+    process.exit(1);
+  });
+} else if (isCreateMode && process.argv.length === 3 && !process.argv[2]?.startsWith("-")) {
+  initCommand(process.argv[2]).catch((error) => {
+    echo.err("Error:", error);
+    process.exit(1);
+  });
+} else {
+  program.parse();
+}

cli/src/templates/minimal.ts

···
+/**
+ * Generate a minimal VoltX.js project with declarative mode.
+ */
+export function generateMinimalHTML(projectName: string): string {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${projectName}</title>
+  <link rel="stylesheet" href="voltx.min.css">
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body>
+  <div data-volt data-volt-state='{"count": 0, "message": "Hello VoltX!"}'>
+    <div class="container">
+      <h1 data-volt-text="message"></h1>
+
+      <div class="counter">
+        <button data-volt-on-click="count.set(count.get() - 1)">-</button>
+        <span data-volt-text="count"></span>
+        <button data-volt-on-click="count.set(count.get() + 1)">+</button>
+      </div>
+
+      <p class="hint">Edit this file to start building your app!</p>
+    </div>
+  </div>
+
+  <script type="module">
+    import { charge, registerPlugin, persistPlugin } from './voltx.min.js';
+
+    registerPlugin('persist', persistPlugin);
+    charge();
+  </script>
+</body>
+</html>
+`;
+}
+
+export function generateMinimalCSS(): string {
+  return `/* Custom styles for your VoltX.js app */
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, sans-serif;
+  background: #f5f5f5;
+  color: #333;
+}
+
+.container {
+  max-width: 600px;
+  margin: 4rem auto;
+  padding: 2rem;
+  background: white;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  text-align: center;
+}
+
+h1 {
+  margin: 0 0 2rem;
+  color: #2563eb;
+}
+
+.counter {
+  display: flex;
+  gap: 1rem;
+  justify-content: center;
+  align-items: center;
+  margin: 2rem 0;
+}
+
+.counter button {
+  width: 48px;
+  height: 48px;
+  font-size: 1.5rem;
+  border: 2px solid #2563eb;
+  background: white;
+  color: #2563eb;
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.counter button:hover {
+  background: #2563eb;
+  color: white;
+}
+
+.counter span {
+  font-size: 2rem;
+  font-weight: bold;
+  min-width: 60px;
+}
+
+.hint {
+  margin-top: 2rem;
+  color: #666;
+  font-size: 0.9rem;
+}
+`;
+}
+
+export function generateMinimalPackageJSON(projectName: string): string {
+  return JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      type: "module",
+      scripts: { dev: "voltx dev", build: "voltx build" },
+      devDependencies: { "create-voltx": "^0.1.0" },
+    },
+    null,
+    2,
+  );
+}
+
+export function generateMinimalREADME(projectName: string): string {
+  return `# ${projectName}
+
+A minimal VoltX.js application.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   pnpm install
+   \`\`\`
+
+2. Start the development server:
+   \`\`\`bash
+   pnpm dev
+   \`\`\`
+
+3. Open your browser to the URL shown in the terminal.
+
+## Project Structure
+
+- \`index.html\` - Main HTML file with declarative VoltX.js markup
+- \`styles.css\` - Custom styles
+- \`voltx.min.js\` - VoltX.js framework (ES module)
+- \`voltx.min.css\` - VoltX.js base styles
+
+## Learn More
+
+- [VoltX.js Documentation](https://stormlightlabs.github.io/volt)
+- [API Reference](https://stormlightlabs.github.io/volt/api)
+`;
+}

cli/src/templates/styles.ts

···
+/**
+ * Generate a styles-only project with VoltX.js CSS but no JavaScript framework.
+ */
+export function generateStylesHTML(projectName: string): string {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${projectName}</title>
+  <link rel="stylesheet" href="voltx.min.css">
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body>
+  <div class="container">
+    <h1>Welcome to ${projectName}</h1>
+
+    <div class="card">
+      <h2>VoltX.js CSS</h2>
+      <p>This project uses VoltX.js CSS utility classes without the reactive framework.</p>
+      <p>Style your HTML with utility classes and semantic CSS variables.</p>
+    </div>
+
+    <div class="button-group">
+      <button class="btn btn-primary">Primary</button>
+      <button class="btn btn-secondary">Secondary</button>
+      <button class="btn btn-danger">Danger</button>
+    </div>
+
+    <div class="grid">
+      <div class="card">
+        <h3>Card 1</h3>
+        <p>Build with semantic CSS.</p>
+      </div>
+      <div class="card">
+        <h3>Card 2</h3>
+        <p>No JavaScript required.</p>
+      </div>
+      <div class="card">
+        <h3>Card 3</h3>
+        <p>Just HTML and CSS.</p>
+      </div>
+    </div>
+  </div>
+</body>
+</html>
+`;
+}
+
+export function generateStylesCSS(): string {
+  return `/* Custom styles for your project */
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, sans-serif;
+  background: #f5f5f5;
+  color: #333;
+}
+
+.container {
+  max-width: 900px;
+  margin: 0 auto;
+  padding: 2rem;
+}
+
+h1 {
+  text-align: center;
+  margin-bottom: 3rem;
+  color: #2563eb;
+}
+
+.card {
+  background: white;
+  padding: 1.5rem;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  margin-bottom: 2rem;
+}
+
+.card h2,
+.card h3 {
+  margin-top: 0;
+  color: #1e40af;
+}
+
+.button-group {
+  display: flex;
+  gap: 1rem;
+  justify-content: center;
+  margin: 2rem 0;
+}
+
+.btn {
+  padding: 0.75rem 1.5rem;
+  border: none;
+  border-radius: 6px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.btn-primary {
+  background: #2563eb;
+  color: white;
+}
+
+.btn-primary:hover {
+  background: #1e40af;
+}
+
+.btn-secondary {
+  background: #64748b;
+  color: white;
+}
+
+.btn-secondary:hover {
+  background: #475569;
+}
+
+.btn-danger {
+  background: #dc2626;
+  color: white;
+}
+
+.btn-danger:hover {
+  background: #b91c1c;
+}
+
+.grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1.5rem;
+  margin-top: 2rem;
+}
+
+.grid .card {
+  margin-bottom: 0;
+}
+`;
+}
+
+export function generateStylesPackageJSON(projectName: string): string {
+  return JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      scripts: { dev: "voltx dev", build: "voltx build" },
+      devDependencies: { "create-voltx": "^0.1.0" },
+    },
+    null,
+    2,
+  );
+}
+
+export function generateStylesREADME(projectName: string): string {
+  return `# ${projectName}
+
+A styles-only project using VoltX.js CSS utilities.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   pnpm install
+   \`\`\`
+
+2. Start the development server:
+   \`\`\`bash
+   pnpm dev
+   \`\`\`
+
+3. Open your browser to the URL shown in the terminal.
+
+## What's Included
+
+This project uses VoltX.js CSS for styling without the reactive framework:
+
+- Utility classes for common patterns
+- CSS custom properties for theming
+- Semantic HTML with clean CSS
+
+## Adding VoltX.js Reactivity
+
+To add reactivity to this project later:
+
+\`\`\`bash
+# Add data-volt attributes to your HTML
+# Import and initialize VoltX.js in a script tag
+\`\`\`
+
+See the [VoltX.js Documentation](https://stormlightlabs.github.io/volt) for more information.
+`;
+}

cli/src/templates/with-plugins.ts

···
+/**
+ * Generate a VoltX.js project with all plugins pre-registered.
+ */
+export function generatePluginsHTML(projectName: string): string {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${projectName}</title>
+  <link rel="stylesheet" href="voltx.min.css">
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body>
+  <div data-volt data-volt-state='{"count": 0, "message": "Hello VoltX!"}'>
+    <div class="container">
+      <h1 data-volt-text="message"></h1>
+
+      <!-- Persist plugin demo -->
+      <div class="card">
+        <h2>Persist Plugin</h2>
+        <p>This counter persists to localStorage:</p>
+        <div class="counter">
+          <button data-volt-on-click="count.set(count.get() - 1)">-</button>
+          <span data-volt-text="count" data-volt-persist="count"></span>
+          <button data-volt-on-click="count.set(count.get() + 1)">+</button>
+        </div>
+        <p class="hint">Refresh the page - your count is saved!</p>
+      </div>
+
+      <!-- Scroll plugin demo -->
+      <div class="card">
+        <h2>Scroll Plugin</h2>
+        <p>Smooth scroll to sections:</p>
+        <button data-volt-scroll-to="#section-1">Scroll to Section 1</button>
+        <button data-volt-scroll-to="#section-2">Scroll to Section 2</button>
+      </div>
+
+      <!-- URL plugin demo -->
+      <div class="card">
+        <h2>URL Plugin</h2>
+        <p>State synced with URL params:</p>
+        <input type="text" data-volt-model="message" data-volt-url-param="msg">
+        <p class="hint">Your message is in the URL!</p>
+      </div>
+
+      <!-- Surge plugin demo -->
+      <div class="card">
+        <h2>Surge Plugin (Animations)</h2>
+        <button data-volt-on-click="$scope.toggle('showBox', !$scope.get('showBox'))">
+          Toggle Box
+        </button>
+        <div
+          data-volt-if="$scope.get('showBox')"
+          data-volt-surge="fade"
+          class="animated-box"
+        >
+          I fade in and out!
+        </div>
+      </div>
+
+      <div id="section-1" class="section">
+        <h3>Section 1</h3>
+        <p>This is a scrollable section.</p>
+      </div>
+
+      <div id="section-2" class="section">
+        <h3>Section 2</h3>
+        <p>Scroll here with smooth animations!</p>
+      </div>
+    </div>
+  </div>
+
+  <script type="module">
+    import {
+      charge,
+      registerPlugin,
+      persistPlugin,
+      scrollPlugin,
+      urlPlugin,
+      surgePlugin,
+      navigatePlugin
+    } from './voltx.min.js';
+
+    // Register all plugins
+    registerPlugin('persist', persistPlugin);
+    registerPlugin('scroll', scrollPlugin);
+    registerPlugin('url', urlPlugin);
+    registerPlugin('surge', surgePlugin);
+    registerPlugin('navigate', navigatePlugin);
+
+    charge();
+  </script>
+</body>
+</html>
+`;
+}
+
+export function generatePluginsCSS(): string {
+  return `/* Custom styles for your VoltX.js app */
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, sans-serif;
+  background: #f5f5f5;
+  color: #333;
+}
+
+.container {
+  max-width: 900px;
+  margin: 2rem auto;
+  padding: 2rem;
+}
+
+h1 {
+  text-align: center;
+  margin-bottom: 3rem;
+  color: #2563eb;
+}
+
+.card {
+  background: white;
+  padding: 2rem;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  margin-bottom: 2rem;
+}
+
+.card h2 {
+  margin-top: 0;
+  color: #1e40af;
+}
+
+.counter {
+  display: flex;
+  gap: 1rem;
+  justify-content: center;
+  align-items: center;
+  margin: 1.5rem 0;
+}
+
+.counter button {
+  width: 48px;
+  height: 48px;
+  font-size: 1.5rem;
+  border: 2px solid #2563eb;
+  background: white;
+  color: #2563eb;
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.counter button:hover {
+  background: #2563eb;
+  color: white;
+}
+
+.counter span {
+  font-size: 2rem;
+  font-weight: bold;
+  min-width: 60px;
+  text-align: center;
+}
+
+button:not(.counter button) {
+  padding: 0.75rem 1.5rem;
+  background: #2563eb;
+  color: white;
+  border: none;
+  border-radius: 6px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s;
+  margin-right: 0.5rem;
+}
+
+button:not(.counter button):hover {
+  background: #1e40af;
+}
+
+input[type="text"] {
+  width: 100%;
+  padding: 0.75rem;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  font-size: 1rem;
+  margin: 1rem 0;
+}
+
+input[type="text"]:focus {
+  outline: none;
+  border-color: #2563eb;
+}
+
+.hint {
+  color: #666;
+  font-size: 0.9rem;
+  margin-top: 1rem;
+}
+
+.animated-box {
+  margin-top: 1.5rem;
+  padding: 2rem;
+  background: #dbeafe;
+  border: 2px solid #2563eb;
+  border-radius: 8px;
+  text-align: center;
+  font-weight: 500;
+  color: #1e40af;
+}
+
+.section {
+  margin-top: 3rem;
+  padding: 3rem;
+  background: white;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  min-height: 300px;
+}
+
+.section h3 {
+  margin-top: 0;
+  color: #2563eb;
+}
+`;
+}
+
+export function generatePluginsPackageJSON(projectName: string): string {
+  return JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      type: "module",
+      scripts: { dev: "voltx dev", build: "voltx build" },
+      devDependencies: { "create-voltx": "^0.1.0" },
+    },
+    null,
+    2,
+  );
+}
+
+export function generatePluginsREADME(projectName: string): string {
+  return `# ${projectName}
+
+A VoltX.js application with all plugins pre-registered.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   pnpm install
+   \`\`\`
+
+2. Start the development server:
+   \`\`\`bash
+   pnpm dev
+   \`\`\`
+
+3. Open your browser to the URL shown in the terminal.
+
+## Included Plugins
+
+This project includes all VoltX.js plugins:
+
+- **Persist Plugin**: Save state to localStorage/sessionStorage
+- **Scroll Plugin**: Smooth scrolling and scroll restoration
+- **URL Plugin**: Sync state with URL parameters
+- **Surge Plugin**: Declarative animations (fade, slide, scale)
+- **Navigate Plugin**: Client-side routing
+
+## Learn More
+
+- [VoltX.js Documentation](https://stormlightlabs.github.io/volt)
+- [Plugin Reference](https://stormlightlabs.github.io/volt/plugins)
+`;
+}

cli/src/templates/with-router.ts

···
+/**
+ * Generate a VoltX.js project with router plugin.
+ */
+export function generateRouterHTML(projectName: string): string {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${projectName}</title>
+  <link rel="stylesheet" href="voltx.min.css">
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body>
+  <div data-volt>
+    <nav class="nav">
+      <a href="/" data-volt-navigate>Home</a>
+      <a href="/about" data-volt-navigate>About</a>
+      <a href="/contact" data-volt-navigate>Contact</a>
+    </nav>
+
+    <main class="container">
+      <!-- Home page -->
+      <div data-volt-url="/" data-volt-url-exact>
+        <h1>Home</h1>
+        <p>Welcome to ${projectName}!</p>
+        <p>This is a VoltX.js app with client-side routing.</p>
+      </div>
+
+      <!-- About page -->
+      <div data-volt-url="/about">
+        <h1>About</h1>
+        <p>This project demonstrates VoltX.js routing capabilities.</p>
+        <ul>
+          <li>Client-side navigation</li>
+          <li>Clean URLs with History API</li>
+          <li>Declarative route matching</li>
+        </ul>
+      </div>
+
+      <!-- Contact page -->
+      <div data-volt-url="/contact">
+        <h1>Contact</h1>
+        <p>Get in touch with us!</p>
+        <form>
+          <label>
+            Name:
+            <input type="text" placeholder="Your name">
+          </label>
+          <label>
+            Email:
+            <input type="email" placeholder="[e-mail]">
+          </label>
+          <label>
+            Message:
+            <textarea rows="4" placeholder="Your message"></textarea>
+          </label>
+          <button type="submit">Send</button>
+        </form>
+      </div>
+
+      <!-- 404 page -->
+      <div data-volt-url-fallback>
+        <h1>404 - Page Not Found</h1>
+        <p>The page you're looking for doesn't exist.</p>
+        <a href="/" data-volt-navigate>Go back home</a>
+      </div>
+    </main>
+  </div>
+
+  <script type="module">
+    import { charge, registerPlugin, navigatePlugin, urlPlugin } from './voltx.min.js';
+
+    registerPlugin('navigate', navigatePlugin);
+    registerPlugin('url', urlPlugin);
+    charge();
+  </script>
+</body>
+</html>
+`;
+}
+
+export function generateRouterCSS(): string {
+  return `/* Custom styles for your VoltX.js app */
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, sans-serif;
+  background: #f5f5f5;
+  color: #333;
+}
+
+.nav {
+  background: #2563eb;
+  padding: 1rem 2rem;
+  display: flex;
+  gap: 2rem;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+}
+
+.nav a {
+  color: white;
+  text-decoration: none;
+  font-weight: 500;
+  padding: 0.5rem 1rem;
+  border-radius: 4px;
+  transition: background 0.2s;
+}
+
+.nav a:hover {
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.nav a[aria-current="page"] {
+  background: rgba(255, 255, 255, 0.2);
+}
+
+.container {
+  max-width: 800px;
+  margin: 2rem auto;
+  padding: 2rem;
+  background: white;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+h1 {
+  margin-top: 0;
+  color: #2563eb;
+}
+
+form {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  margin-top: 2rem;
+}
+
+label {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  font-weight: 500;
+}
+
+input,
+textarea {
+  padding: 0.75rem;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  font-size: 1rem;
+  font-family: inherit;
+}
+
+input:focus,
+textarea:focus {
+  outline: none;
+  border-color: #2563eb;
+}
+
+button[type="submit"] {
+  padding: 0.75rem 1.5rem;
+  background: #2563eb;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: background 0.2s;
+  align-self: flex-start;
+}
+
+button[type="submit"]:hover {
+  background: #1e40af;
+}
+`;
+}
+
+export function generateRouterPackageJSON(projectName: string): string {
+  return JSON.stringify(
+    {
+      name: projectName,
+      version: "0.1.0",
+      type: "module",
+      scripts: { dev: "voltx dev", build: "voltx build" },
+      devDependencies: { "create-voltx": "^0.1.0" },
+    },
+    null,
+    2,
+  );
+}
+
+export function generateRouterREADME(projectName: string): string {
+  return `# ${projectName}
+
+A VoltX.js application with client-side routing.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   pnpm install
+   \`\`\`
+
+2. Start the development server:
+   \`\`\`bash
+   pnpm dev
+   \`\`\`
+
+3. Open your browser to the URL shown in the terminal.
+
+## Features
+
+This project demonstrates:
+
+- Client-side routing with the History API
+- Declarative route matching with \`data-volt-url\`
+- Navigation with \`data-volt-navigate\`
+- 404 fallback pages
+- Clean URLs without hash routing
+
+## Project Structure
+
+- \`index.html\` - Main HTML file with routes
+- \`styles.css\` - Custom styles
+- \`voltx.min.js\` - VoltX.js framework with router
+- \`voltx.min.css\` - VoltX.js base styles
+
+## Learn More
+
+- [VoltX.js Documentation](https://stormlightlabs.github.io/volt)
+- [Routing Guide](https://stormlightlabs.github.io/volt/guides/routing)
+`;
+}

cli/src/tests/commands.test.ts

···
+import { downloadCommand } from "$commands/download.js";
+import { initCommand } from "$commands/init.js";
+import * as downloadUtils from "$utils/download.js";
+import * as filesUtils from "$utils/files.js";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+// Mock inquirer prompts
+vi.mock("@inquirer/prompts", () => ({ input: vi.fn(), select: vi.fn() }));
+
+describe("CLI commands", () => {
+  let tempDir: string;
+
+  beforeEach(async () => {
+    tempDir = await mkdtemp(path.join(tmpdir(), "voltx-cmd-test-"));
+    vi.spyOn(downloadUtils, "downloadFile").mockResolvedValue();
+    vi.spyOn(filesUtils, "createFile").mockResolvedValue();
+  });
+
+  afterEach(async () => {
+    await rm(tempDir, { recursive: true, force: true }).catch(() => {});
+    vi.clearAllMocks();
+    vi.restoreAllMocks();
+  });
+
+  describe("downloadCommand", () => {
+    it("should download JS and CSS by default", async () => {
+      await downloadCommand({ output: tempDir });
+
+      const downloadFileSpy = vi.mocked(downloadUtils.downloadFile);
+      expect(downloadFileSpy).toHaveBeenCalledTimes(2);
+      expect(downloadFileSpy).toHaveBeenCalledWith(
+        "https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.js",
+        expect.stringContaining("voltx.min.js"),
+      );
+      expect(downloadFileSpy).toHaveBeenCalledWith(
+        "https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.css",
+        expect.stringContaining("voltx.min.css"),
+      );
+    });
+
+    it("should download only JS when css is disabled", async () => {
+      await downloadCommand({ output: tempDir, css: false });
+
+      const downloadFileSpy = vi.mocked(downloadUtils.downloadFile);
+      expect(downloadFileSpy).toHaveBeenCalledTimes(1);
+      expect(downloadFileSpy).toHaveBeenCalledWith(
+        "https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.js",
+        expect.stringContaining("voltx.min.js"),
+      );
+    });
+
+    it("should download only CSS when js is disabled", async () => {
+      await downloadCommand({ output: tempDir, js: false });
+
+      const downloadFileSpy = vi.mocked(downloadUtils.downloadFile);
+      expect(downloadFileSpy).toHaveBeenCalledTimes(1);
+      expect(downloadFileSpy).toHaveBeenCalledWith(
+        "https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.css",
+        expect.stringContaining("voltx.min.css"),
+      );
+    });
+
+    it("should download specific version when specified", async () => {
+      await downloadCommand({ output: tempDir, version: "0.5.0" });
+
+      const downloadFileSpy = vi.mocked(downloadUtils.downloadFile);
+      expect(downloadFileSpy).toHaveBeenCalledWith(
+        "https://cdn.jsdelivr.net/npm/voltx.js@0.5.0/dist/voltx.min.js",
+        expect.stringContaining("voltx.min.js"),
+      );
+      expect(downloadFileSpy).toHaveBeenCalledWith(
+        "https://cdn.jsdelivr.net/npm/voltx.js@0.5.0/dist/voltx.min.css",
+        expect.stringContaining("voltx.min.css"),
+      );
+    });
+
+    it("should handle download errors and exit with code 1", async () => {
+      const downloadFileSpy = vi.spyOn(downloadUtils, "downloadFile").mockRejectedValue(new Error("Network error"));
+      const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => {}) as any);
+
+      await downloadCommand({ output: tempDir });
+
+      expect(downloadFileSpy).toHaveBeenCalled();
+      expect(exitSpy).toHaveBeenCalledWith(1);
+
+      exitSpy.mockRestore();
+    });
+  });
+
+  describe("initCommand", () => {
+    it("should check for existing non-empty directory", async () => {
+      const { input, select } = await import("@inquirer/prompts");
+      vi.mocked(input).mockResolvedValue("test-project");
+      vi.mocked(select).mockResolvedValue("minimal" as any);
+
+      const isEmptyOrMissingSpy = vi.spyOn(filesUtils, "isEmptyOrMissing").mockResolvedValue(false);
+      const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => {}) as any);
+
+      await initCommand();
+
+      expect(isEmptyOrMissingSpy).toHaveBeenCalled();
+      expect(exitSpy).toHaveBeenCalledWith(1);
+
+      exitSpy.mockRestore();
+    });
+
+    it("should create minimal template", async () => {
+      const { select } = await import("@inquirer/prompts");
+      vi.mocked(select).mockResolvedValue("minimal" as any);
+
+      vi.spyOn(filesUtils, "isEmptyOrMissing").mockResolvedValue(true);
+
+      await initCommand("minimal-app");
+
+      expect(vi.mocked(filesUtils.createFile)).toHaveBeenCalled();
+      expect(vi.mocked(downloadUtils.downloadFile)).toHaveBeenCalled();
+    });
+
+    it("should create styles template without JS", async () => {
+      const { select } = await import("@inquirer/prompts");
+      vi.mocked(select).mockResolvedValue("styles" as any);
+
+      vi.spyOn(filesUtils, "isEmptyOrMissing").mockResolvedValue(true);
+
+      await initCommand("styles-app");
+
+      const downloadSpy = vi.mocked(downloadUtils.downloadFile);
+      const calls = downloadSpy.mock.calls;
+      expect(calls.some((call) => call[0].includes("voltx.min.css"))).toBe(true);
+      expect(calls.some((call) => call[0].includes("voltx.min.js"))).toBe(false);
+    });
+
+    it("should create with-router template", async () => {
+      const { select } = await import("@inquirer/prompts");
+      vi.mocked(select).mockResolvedValue("with-router" as any);
+
+      vi.spyOn(filesUtils, "isEmptyOrMissing").mockResolvedValue(true);
+
+      await initCommand("router-app");
+
+      expect(vi.mocked(filesUtils.createFile)).toHaveBeenCalled();
+    });
+
+    it("should create with-plugins template", async () => {
+      const { select } = await import("@inquirer/prompts");
+      vi.mocked(select).mockResolvedValue("with-plugins" as any);
+
+      vi.spyOn(filesUtils, "isEmptyOrMissing").mockResolvedValue(true);
+
+      await initCommand("plugins-app");
+
+      expect(vi.mocked(filesUtils.createFile)).toHaveBeenCalled();
+    });
+  });
+});

cli/src/tests/download.test.ts

···
+import { getCDNUrls } from "$utils/download.js";
+import { describe, expect, it } from "vitest";
+
+describe("download utilities", () => {
+  describe("getCDNUrls", () => {
+    it("should return latest URLs when no version specified", () => {
+      const urls = getCDNUrls();
+
+      expect(urls.js).toBe("https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.js");
+      expect(urls.css).toBe("https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.css");
+    });
+
+    it("should return latest URLs when 'latest' is specified", () => {
+      const urls = getCDNUrls("latest");
+
+      expect(urls.js).toBe("https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.js");
+      expect(urls.css).toBe("https://cdn.jsdelivr.net/npm/voltx.js@latest/dist/voltx.min.css");
+    });
+
+    it("should return versioned URLs when version is specified", () => {
+      const urls = getCDNUrls("1.0.0");
+
+      expect(urls.js).toBe("https://cdn.jsdelivr.net/npm/voltx.js@1.0.0/dist/voltx.min.js");
+      expect(urls.css).toBe("https://cdn.jsdelivr.net/npm/voltx.js@1.0.0/dist/voltx.min.css");
+    });
+  });
+});

cli/src/tests/echo.test.ts

···
+import { echo } from "$utils/echo.js";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+describe("echo utility", () => {
+  let consoleLogSpy: ReturnType<typeof vi.spyOn>;
+  let consoleErrorSpy: ReturnType<typeof vi.spyOn>;
+  let consoleWarnSpy: ReturnType<typeof vi.spyOn>;
+
+  beforeEach(() => {
+    consoleLogSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+    consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+    consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
+  });
+
+  afterEach(() => {
+    consoleLogSpy.mockRestore();
+    consoleErrorSpy.mockRestore();
+    consoleWarnSpy.mockRestore();
+  });
+
+  describe("err", () => {
+    it("should log to stderr", () => {
+      echo.err("Error message");
+      expect(consoleErrorSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+
+    it("should accept additional parameters", () => {
+      echo.err("Error:", "details", 123);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(expect.any(String), "details", 123);
+    });
+  });
+
+  describe("danger", () => {
+    it("should log to stdout", () => {
+      echo.danger("Danger message");
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+  });
+
+  describe("ok", () => {
+    it("should log success message", () => {
+      echo.ok("Success message");
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+  });
+
+  describe("success", () => {
+    it("should log bold success message", () => {
+      echo.success("Success!");
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+  });
+
+  describe("info", () => {
+    it("should log info message", () => {
+      echo.info("Info message");
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+  });
+
+  describe("label", () => {
+    it("should log label message", () => {
+      echo.label("Label");
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+  });
+
+  describe("title", () => {
+    it("should log bold title", () => {
+      echo.title("Title");
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+  });
+
+  describe("warn", () => {
+    it("should log warning", () => {
+      echo.warn("Warning message");
+      expect(consoleWarnSpy).toHaveBeenCalledWith(expect.any(String));
+    });
+  });
+
+  describe("text", () => {
+    it("should be a reference to console.log", () => {
+      expect(typeof echo.text).toBe("function");
+    });
+  });
+});

cli/src/tests/files.test.ts

···
+import { createFile, isEmptyOrMissing } from "$utils/files.js";
+import { mkdir, mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+
+describe("files utilities", () => {
+  let tempDir: string;
+
+  beforeEach(async () => {
+    tempDir = await mkdtemp(path.join(tmpdir(), "voltx-test-"));
+  });
+
+  afterEach(async () => {
+    await rm(tempDir, { recursive: true, force: true });
+  });
+
+  describe("createFile", () => {
+    it("should create a file with content", async () => {
+      const filePath = path.join(tempDir, "test.txt");
+      const content = "Hello VoltX!";
+
+      await createFile(filePath, content);
+
+      const fileContent = await readFile(filePath, "utf8");
+      expect(fileContent).toBe(content);
+    });
+
+    it("should create parent directories if they don't exist", async () => {
+      const filePath = path.join(tempDir, "nested", "deep", "test.txt");
+      const content = "Nested file";
+
+      await createFile(filePath, content);
+
+      const fileContent = await readFile(filePath, "utf8");
+      expect(fileContent).toBe(content);
+    });
+  });
+
+  describe("isEmptyOrMissing", () => {
+    it("should return true for non-existent directory", async () => {
+      const nonExistentDir = path.join(tempDir, "does-not-exist");
+      const result = await isEmptyOrMissing(nonExistentDir);
+      expect(result).toBe(true);
+    });
+
+    it("should return true for empty directory", async () => {
+      const emptyDir = path.join(tempDir, "empty");
+      await mkdir(emptyDir);
+
+      const result = await isEmptyOrMissing(emptyDir);
+      expect(result).toBe(true);
+    });
+
+    it("should return false for directory with files", async () => {
+      const dirWithFiles = path.join(tempDir, "with-files");
+      await mkdir(dirWithFiles);
+      await createFile(path.join(dirWithFiles, "test.txt"), "content");
+
+      const result = await isEmptyOrMissing(dirWithFiles);
+      expect(result).toBe(false);
+    });
+  });
+});

cli/src/tests/templates.test.ts

···
+import { describe, it, expect } from "vitest";
+import {
+  generateMinimalHTML,
+  generateMinimalCSS,
+  generateMinimalPackageJSON,
+  generateMinimalREADME,
+} from "$templates/minimal.js";
+import {
+  generateStylesHTML,
+  generateStylesCSS,
+  generateStylesPackageJSON,
+  generateStylesREADME,
+} from "$templates/styles.js";
+import {
+  generateRouterHTML,
+  generateRouterCSS,
+  generateRouterPackageJSON,
+  generateRouterREADME,
+} from "$templates/with-router.js";
+import {
+  generatePluginsHTML,
+  generatePluginsCSS,
+  generatePluginsPackageJSON,
+  generatePluginsREADME,
+} from "$templates/with-plugins.js";
+
+describe("template generators", () => {
+  const projectName = "test-project";
+
+  describe("minimal template", () => {
+    it("should generate HTML with project name", () => {
+      const html = generateMinimalHTML(projectName);
+      expect(html).toContain(projectName);
+      expect(html).toContain("data-volt");
+      expect(html).toContain("voltx.min.js");
+    });
+
+    it("should generate CSS", () => {
+      const css = generateMinimalCSS();
+      expect(css).toContain(".container");
+      expect(css).toContain(".counter");
+    });
+
+    it("should generate valid package.json", () => {
+      const packageJson = generateMinimalPackageJSON(projectName);
+      const parsed = JSON.parse(packageJson);
+      expect(parsed.name).toBe(projectName);
+      expect(parsed.scripts.dev).toBe("voltx dev");
+      expect(parsed.scripts.build).toBe("voltx build");
+    });
+
+    it("should generate README with project name", () => {
+      const readme = generateMinimalREADME(projectName);
+      expect(readme).toContain(projectName);
+      expect(readme).toContain("pnpm dev");
+    });
+  });
+
+  describe("styles template", () => {
+    it("should generate HTML without VoltX.js framework", () => {
+      const html = generateStylesHTML(projectName);
+      expect(html).toContain(projectName);
+      expect(html).toContain("voltx.min.css");
+      expect(html).not.toContain("voltx.min.js");
+      expect(html).not.toContain("data-volt");
+    });
+
+    it("should generate CSS", () => {
+      const css = generateStylesCSS();
+      expect(css).toContain(".container");
+      expect(css).toContain(".card");
+    });
+
+    it("should generate valid package.json", () => {
+      const packageJson = generateStylesPackageJSON(projectName);
+      const parsed = JSON.parse(packageJson);
+      expect(parsed.name).toBe(projectName);
+    });
+
+    it("should generate README explaining styles-only approach", () => {
+      const readme = generateStylesREADME(projectName);
+      expect(readme).toContain(projectName);
+      expect(readme).toContain("styles-only");
+    });
+  });
+
+  describe("router template", () => {
+    it("should generate HTML with routing", () => {
+      const html = generateRouterHTML(projectName);
+      expect(html).toContain(projectName);
+      expect(html).toContain("data-volt-navigate");
+      expect(html).toContain("data-volt-url");
+      expect(html).toContain("navigatePlugin");
+    });
+
+    it("should generate CSS with navigation styles", () => {
+      const css = generateRouterCSS();
+      expect(css).toContain(".nav");
+    });
+
+    it("should generate valid package.json", () => {
+      const packageJson = generateRouterPackageJSON(projectName);
+      const parsed = JSON.parse(packageJson);
+      expect(parsed.name).toBe(projectName);
+    });
+
+    it("should generate README explaining routing", () => {
+      const readme = generateRouterREADME(projectName);
+      expect(readme).toContain(projectName);
+      expect(readme).toContain("routing");
+    });
+  });
+
+  describe("plugins template", () => {
+    it("should generate HTML with all plugins", () => {
+      const html = generatePluginsHTML(projectName);
+      expect(html).toContain(projectName);
+      expect(html).toContain("persistPlugin");
+      expect(html).toContain("scrollPlugin");
+      expect(html).toContain("urlPlugin");
+      expect(html).toContain("surgePlugin");
+      expect(html).toContain("navigatePlugin");
+    });
+
+    it("should generate CSS for plugin demos", () => {
+      const css = generatePluginsCSS();
+      expect(css).toContain(".card");
+      expect(css).toContain(".counter");
+      expect(css).toContain(".animated-box");
+    });
+
+    it("should generate valid package.json", () => {
+      const packageJson = generatePluginsPackageJSON(projectName);
+      const parsed = JSON.parse(packageJson);
+      expect(parsed.name).toBe(projectName);
+    });
+
+    it("should generate README listing all plugins", () => {
+      const readme = generatePluginsREADME(projectName);
+      expect(readme).toContain(projectName);
+      expect(readme).toContain("Persist Plugin");
+      expect(readme).toContain("Scroll Plugin");
+      expect(readme).toContain("URL Plugin");
+    });
+  });
+});

cli/src/utils/download.ts

···
+import { mkdir, writeFile } from "node:fs/promises";
+import https from "node:https";
+import path from "node:path";
+
+/**
+ * Download a file from a URL and save it to the specified path.
+ */
+export async function downloadFile(url: string, outputPath: string): Promise<void> {
+  const dir = path.dirname(outputPath);
+  await mkdir(dir, { recursive: true });
+
+  return new Promise((resolve, reject) => {
+    https.get(url, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        if (response.headers.location) {
+          downloadFile(response.headers.location, outputPath).then(resolve).catch(reject);
+          return;
+        }
+      }
+
+      if (response.statusCode !== 200) {
+        reject(new Error(`Failed to download: ${response.statusCode} ${response.statusMessage}`));
+        return;
+      }
+
+      const chunks: Buffer[] = [];
+
+      response.on("data", (chunk) => {
+        chunks.push(chunk);
+      });
+
+      response.on("end", async () => {
+        try {
+          const buffer = Buffer.concat(chunks);
+          await writeFile(outputPath, buffer);
+          resolve();
+        } catch (error) {
+          reject(error);
+        }
+      });
+
+      response.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+/**
+ * Get the CDN URLs for VoltX.js assets.
+ */
+export function getCDNUrls(version: string = "latest"): { js: string; css: string } {
+  const baseUrl = version === "latest"
+    ? "https://cdn.jsdelivr.net/npm/voltx.js@latest/dist"
+    : `https://cdn.jsdelivr.net/npm/voltx.js@${version}/dist`;
+
+  return { js: `${baseUrl}/voltx.min.js`, css: `${baseUrl}/voltx.min.css` };
+}

cli/src/utils/echo.ts

···
+import chalk from "chalk";
+
+type Echo = Record<
+  "info" | "success" | "ok" | "warn" | "text" | "err" | "danger" | "label" | "title",
+  (message?: any, ...optionalParams: any[]) => void
+>;
+
+export const echo: Echo = {
+  /**
+   * Red text to stderr
+   */
+  err(message, ...optionalParams) {
+    console.error(chalk.red(message), ...optionalParams);
+  },
+  /**
+   * Red text for recoverable errors (to stdout)
+   */
+  danger(message, ...optionalParams) {
+    console.log(chalk.red(message), ...optionalParams);
+  },
+  ok(message, ...optionalParams) {
+    console.log(chalk.green(message), ...optionalParams);
+  },
+  success(message, ...optionalParams) {
+    console.log(chalk.green.bold(message), ...optionalParams);
+  },
+  info(message, ...optionalParams) {
+    console.log(chalk.cyan(message), ...optionalParams);
+  },
+  label(message, ...optionalParams) {
+    console.log(chalk.blue(message), ...optionalParams);
+  },
+  title(message, ...optionalParams) {
+    console.log(chalk.blue.bold(message), ...optionalParams);
+  },
+  warn(message, ...optionalParams) {
+    console.warn(chalk.yellow(message), ...optionalParams);
+  },
+  text: console.log,
+};

cli/src/utils/files.ts

···
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+/**
+ * Create a file with the given content at the specified path.
+ *
+ * Creates parent directories if they don't exist.
+ */
+export async function createFile(filePath: string, content: string): Promise<void> {
+  const dir = path.dirname(filePath);
+  await mkdir(dir, { recursive: true });
+  await writeFile(filePath, content, "utf8");
+}
+
+/**
+ * Check if a directory is empty or doesn't exist.
+ */
+export async function isEmptyOrMissing(dirPath: string): Promise<boolean> {
+  const { existsSync } = await import("node:fs");
+  const { readdir } = await import("node:fs/promises");
+
+  if (!existsSync(dirPath)) {
+    return true;
+  }
+
+  const files = await readdir(dirPath);
+  return files.length === 0;
+}

cli/tsconfig.json

···
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "paths": {
+      "$commands/*": ["./src/commands/*"],
+      "$templates/*": ["./src/templates/*"],
+      "$utils/*": ["./src/utils/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

cli/tsdown.config.ts

···
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  clean: true,
+  dts: true,
+  shims: true,
+  platform: "node",
+  target: "node18",
+  tsconfig: "./tsconfig.json",
+});

cli/vitest.config.ts

···
+import path from "node:path";
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "html", "lcov"],
+      include: ["src/**/*.ts"],
+      exclude: ["src/tests/**", "src/**/*.test.ts", "src/index.ts", "src/commands/dev.ts", "src/commands/build.ts"],
+      all: true,
+      thresholds: { lines: 95, functions: 95, branches: 80, statements: 95 },
+    },
+  },
+  resolve: {
+    alias: {
+      "$commands": path.resolve(__dirname, "./src/commands"),
+      "$templates": path.resolve(__dirname, "./src/templates"),
+      "$utils": path.resolve(__dirname, "./src/utils"),
+    },
+  },
+});

docs/.vitepress/config.ts

···
       {
         text: "Getting Started",
         items:
-          ([{ text: "Overview", link: "/overview" }, {
-            text: "Installation",
-            link: "/installation",
+          ([{ text: "Overview", link: "/overview" }, { text: "Installation", link: "/installation" }, {
+            text: "CLI",
+            link: "/cli",
           }] as DefaultTheme.SidebarItem[]).concat(...u.scanDir("usage", "/usage")),
       },
       {

docs/cli.md

···
+# CLI
+
+The VoltX.js CLI provides tools for creating and managing VoltX.js applications. Use it to scaffold new projects, run development servers, build for production, and download framework assets.
+
+## Installation
+
+The CLI is available as `create-voltx` on npm:
+
+```bash
+# Use with pnpm (recommended)
+pnpm create voltx my-app
+
+# Use with npm
+npm create voltx@latest my-app
+
+# Use with npx
+npx create-voltx my-app
+```
+
+For ongoing development commands, install the CLI in your project:
+
+```bash
+pnpm add -D create-voltx
+```
+
+## Commands
+
+### `init`
+
+Create a new VoltX.js project with an interactive template selector.
+
+```bash
+# Interactive mode - prompts for project name and template
+pnpm create voltx
+
+# Specify project name
+pnpm create voltx my-app
+
+# Using the voltx command
+voltx init my-app
+```
+
+**Templates:**
+
+- **Minimal** - Basic VoltX.js app with a counter demo
+- **With Router** - Multi-page app with client-side routing
+- **With Plugins** - Demonstration of all VoltX.js plugins
+- **Styles Only** - HTML + CSS using VoltX.js styles without the framework
+
+The init command:
+
+- Creates project directory
+- Generates HTML, CSS, package.json, and README
+- Downloads latest VoltX.js assets from CDN
+- Sets up development scripts
+
+**Generated Structure:**
+
+```sh
+my-app/
+├── index.html       # Main HTML file
+├── styles.css       # Custom styles
+├── package.json     # Project configuration
+├── README.md        # Getting started guide
+├── voltx.min.js     # VoltX.js framework
+└── voltx.min.css    # VoltX.js base styles
+```
+
+### `dev`
+
+Start a Vite development server for your VoltX.js project.
+
+```bash
+voltx dev
+```
+
+**Options:**
+
+- `-p, --port <port>` - Port to run the dev server on (default: 3000)
+- `-o, --open` - Open browser automatically
+
+**Examples:**
+
+```bash
+# Start dev server on default port (3000)
+voltx dev
+
+# Use custom port
+voltx dev --port 8080
+
+# Open browser automatically
+voltx dev --open
+```
+
+The dev server provides:
+
+- Hot module replacement (HMR)
+- Fast refresh for development
+- Automatic browser reload
+- HTTPS support (via Vite)
+
+### `build`
+
+Build your VoltX.js project for production.
+
+```bash
+voltx build
+```
+
+**Options:**
+
+- `--out <dir>` - Output directory (default: dist)
+
+**Examples:**
+
+```bash
+# Build to default dist/ directory
+voltx build
+
+# Build to custom directory
+voltx build --out public
+```
+
+The build command:
+
+- Minifies HTML, CSS, and JavaScript
+- Optimizes assets for production
+- Generates source maps
+- Creates optimized bundle
+
+### `download`
+
+Download VoltX.js assets (JS and CSS) from the CDN.
+
+```bash
+voltx download
+```
+
+**Options:**
+
+- `--version <version>` - VoltX.js version to download (default: latest)
+- `--no-js` - Skip downloading JavaScript file
+- `--no-css` - Skip downloading CSS file
+- `-o, --output <dir>` - Output directory (default: current directory)
+
+**Examples:**
+
+```bash
+# Download latest JS and CSS
+voltx download
+
+# Download specific version
+voltx download --version 0.5.0
+
+# Download only CSS
+voltx download --no-js
+
+# Download to custom directory
+voltx download --output assets
+```
+
+This command downloads minified assets from the jsDelivr CDN.
+
+## Workflows
+
+### Creating a New Project
+
+```bash
+# Create new project
+pnpm create voltx my-app
+
+# Navigate to project
+cd my-app
+
+# Install dependencies
+pnpm install
+
+# Start dev server
+pnpm dev
+```
+
+### Development
+
+```bash
+# Start dev server (watches for changes)
+pnpm dev
+
+# In another terminal, run tests if available
+pnpm test
+```
+
+### Production Build
+
+```bash
+# Build for production
+pnpm build
+
+# Preview production build locally
+npx vite preview --outDir dist
+```
+
+### Updating VoltX.js Assets
+
+```bash
+# Download latest version
+voltx download
+
+# Or download specific version
+voltx download --version 0.5.1
+```
+
+## Project Scripts
+
+All generated projects include these npm scripts:
+
+```json
+{
+  "scripts": {
+    "dev": "voltx dev",
+    "build": "voltx build"
+  }
+}
+```
+
+Run them with your package manager:
+
+```bash
+pnpm dev
+pnpm build
+```
+
+## Templates
+
+### Minimal
+
+A basic VoltX.js application demonstrating:
+
+- Declarative state with `data-volt-state`
+- Reactive bindings
+- Event handlers
+- Counter example
+
+Best for: Learning VoltX.js basics, simple interactive pages.
+
+### With Router
+
+A multi-page application featuring:
+
+- Client-side routing with History API
+- Multiple routes (home, about, contact, 404)
+- Navigation with `data-volt-navigate`
+- Route matching with `data-volt-url`
+
+Best for: Multi-page applications, documentation sites, dashboards.
+
+### With Plugins
+
+A comprehensive demo showcasing:
+
+- Persist plugin (localStorage sync)
+- Scroll plugin (smooth scrolling)
+- URL plugin (URL parameter sync)
+- Surge plugin (animations)
+- Navigate plugin (routing)
+
+Best for: Learning all VoltX.js features, reference implementation.
+
+### Styles Only
+
+HTML and CSS using VoltX.js styles without the reactive framework:
+
+- VoltX.js CSS utilities
+- Semantic HTML
+- No JavaScript required
+
+Best for: Static sites, progressively enhanced pages, CSS-only projects.
+
+## Configuration
+
+### Vite Configuration
+
+The CLI uses Vite as the dev server and build tool. To customize Vite, create a `vite.config.js` in your project root:
+
+```js
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  // Custom Vite configuration
+  server: {
+    port: 3000,
+  },
+  build: {
+    outDir: 'dist',
+  },
+});
+```
+
+See the [Vite documentation](https://vitejs.dev/config/) for all available options.
+
+## Troubleshooting
+
+### Dev Server Won't Start
+
+Ensure you're in a VoltX.js project directory with an `index.html` file:
+
+```bash
+ls index.html
+```
+
+If `index.html` is missing, you may not be in a VoltX.js project.
+
+### Download Fails
+
+Check your internet connection and try again. The CLI downloads assets from:
+
+```text
+https://cdn.jsdelivr.net/npm/voltx.js@{version}/dist/
+```
+
+If jsDelivr is blocked, manually download from the [npm package](https://www.npmjs.com/package/voltx.js).
+
+### Build Fails
+
+Ensure all dependencies are installed:
+
+```bash
+pnpm install
+```
+
+Check for syntax errors in your HTML, CSS, or JavaScript files.
+
+## Next Steps
+
+- Read the [Installation Guide](./installation) for framework setup
+- Explore [Usage Patterns](./usage/state) for state management
+- Check the [API Reference](./api) for detailed documentation
+- Learn about [Plugins](./plugins) for extended functionality

docs/installation.md

···
 </script>
 ```
 
+## CLI (Recommended)
+
+The fastest way to create a new VoltX.js project is with the CLI:
+
+```bash
+pnpm create voltx my-app
+cd my-app
+pnpm install
+pnpm dev
+```
+
+This scaffolds a complete project with development server, build tools, and framework assets. See the [CLI Guide](./cli) for all available commands and templates.
+
 ## Package Manager
 
 For applications using node based tools, install VoltX.js via npm or JSR:

package.json

···
     "docs:dev": "pnpm --filter @voltx/docs dev",
     "docs:build": "pnpm --filter @voltx/docs build",
     "docs:preview": "pnpm --filter @voltx/docs preview",
+    "cli:dev": "pnpm --filter create-voltx dev",
+    "cli:build": "pnpm --filter create-voltx build",
     "typecheck": "pnpm -r typecheck"
   },
   "devDependencies": {

pnpm-lock.yaml

···
         specifier: ^3.2.4
         version: 3.2.4(@types/node@24.8.1)(esbuild@0.25.11)(jiti@2.6.1)(jsdom@27.0.0(postcss@8.5.6))(terser@5.44.0)(yaml@2.8.1)
 
+  cli:
+    dependencies:
+      '@inquirer/prompts':
+        specifier: ^8.0.1
+        version: 8.0.1(@types/node@24.8.1)
+      chalk:
+        specifier: ^5.6.2
+        version: 5.6.2
+      commander:
+        specifier: ^14.0.1
+        version: 14.0.1
+    devDependencies:
+      '@vitest/coverage-v8':
+        specifier: ^3.2.4
+        version: 3.2.4(vitest@3.2.4(@types/node@24.8.1)(esbuild@0.25.11)(jiti@2.6.1)(jsdom@27.0.0(postcss@8.5.6))(terser@5.44.0)(yaml@2.8.1))
+      tsdown:
+        specifier: ^0.15.6
+        version: 0.15.8(typescript@5.9.3)
+
   dev:
     dependencies:
       chalk:
···
   '@iconify/types@2.0.0':
     resolution: {integrity: sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==}
 
+  '@inquirer/ansi@2.0.1':
+    resolution: {integrity: sha512-QAZUk6BBncv/XmSEZTscd8qazzjV3E0leUMrEPjxCd51QBgCKmprUGLex5DTsNtURm7LMzv+CLcd6S86xvBfYg==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+
+  '@inquirer/checkbox@5.0.1':
+    resolution: {integrity: sha512-5VPFBK8jKdsjMK3DTFOlbR0+Kkd4q0AWB7VhWQn6ppv44dr3b7PU8wSJQTC5oA0f/aGW7v/ZozQJAY9zx6PKig==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/confirm@6.0.1':
+    resolution: {integrity: sha512-wD+pM7IxLn1TdcQN12Q6wcFe5VpyCuh/I2sSmqO5KjWH2R4v+GkUToHb+PsDGobOe1MtAlXMwGNkZUPc2+L6NA==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/core@11.0.1':
+    resolution: {integrity: sha512-Tpf49h50e4KYffVUCXzkx4gWMafUi3aDQDwfVAAGBNnVcXiwJIj4m2bKlZ7Kgyf6wjt1eyXH1wDGXcAokm4Ssw==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/editor@5.0.1':
+    resolution: {integrity: sha512-zDKobHI7Ry++4noiV9Z5VfYgSVpPZoMApviIuGwLOMciQaP+dGzCO+1fcwI441riklRiZg4yURWyEoX0Zy2zZw==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/expand@5.0.1':
+    resolution: {integrity: sha512-TBrTpAB6uZNnGQHtSEkbvJZIQ3dXZOrwqQSO9uUbwct3G2LitwBCE5YZj98MbQ5nzihzs5pRjY1K9RRLH4WgoA==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/external-editor@2.0.1':
+    resolution: {integrity: sha512-BPYWJXCAK9w6R+pb2s3WyxUz9ts9SP/LDOUwA9fu7LeuyYgojz83i0DSRwezu736BgMwz14G63Xwj70hSzHohQ==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/figures@2.0.1':
+    resolution: {integrity: sha512-KtMxyjLCuDFqAWHmCY9qMtsZ09HnjMsm8H3OvpSIpfhHdfw3/AiGWHNrfRwbyvHPtOJpumm8wGn5fkhtvkWRsg==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+
+  '@inquirer/input@5.0.1':
+    resolution: {integrity: sha512-cEhEUohCpE2BCuLKtFFZGp4Ief05SEcqeAOq9NxzN5ThOQP8Rl5N/Nt9VEDORK1bRb2Sk/zoOyQYfysPQwyQtA==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/number@4.0.1':
+    resolution: {integrity: sha512-4//zgBGHe8Q/FfCoUXZUrUHyK/q5dyqiwsePz3oSSPSmw1Ijo35ZkjaftnxroygcUlLYfXqm+0q08lnB5hd49A==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/password@5.0.1':
+    resolution: {integrity: sha512-UJudHpd7Ia30Q+x+ctYqI9Nh6SyEkaBscpa7J6Ts38oc1CNSws0I1hJEdxbQBlxQd65z5GEJPM4EtNf6tzfWaQ==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/prompts@8.0.1':
+    resolution: {integrity: sha512-MURRu/cyvLm9vchDDaVZ9u4p+ADnY0Mz3LQr0KTgihrrvuKZlqcWwlBC4lkOMvd0KKX4Wz7Ww9+uA7qEpQaqjg==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/rawlist@5.0.1':
+    resolution: {integrity: sha512-vVfVHKUgH6rZmMlyd0jOuGZo0Fw1jfcOqZF96lMwlgavx7g0x7MICe316bV01EEoI+c68vMdbkTTawuw3O+Fgw==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/search@4.0.1':
+    resolution: {integrity: sha512-XwiaK5xBvr31STX6Ji8iS3HCRysBXfL/jUbTzufdWTS6LTGtvDQA50oVETt1BJgjKyQBp9vt0VU6AmU/AnOaGA==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/select@5.0.1':
+    resolution: {integrity: sha512-gPByrgYoezGyKMq5KjV7Tuy1JU2ArIy6/sI8sprw0OpXope3VGQwP5FK1KD4eFFqEhKu470Dwe6/AyDPmGRA0Q==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@inquirer/type@4.0.1':
+    resolution: {integrity: sha512-odO8YwoQAw/eVu/PSPsDDVPmqO77r/Mq7zcoF5VduVqIu2wSRWUgmYb5K9WH1no0SjLnOe8MDKtDL++z6mfo2g==}
+    engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+    peerDependencies:
+      '@types/node': '>=18'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
   '@isaacs/cliui@8.0.2':
     resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
     engines: {node: '>=12'}
···
   '@oxc-project/types@0.93.0':
     resolution: {integrity: sha512-yNtwmWZIBtJsMr5TEfoZFDxIWV6OdScOpza/f5YxbqUMJk+j6QX3Cf3jgZShGEFYWQJ5j9mJ6jM0tZHu2J9Yrg==}
 
-  '@oxc-project/types@0.97.0':
-    resolution: {integrity: sha512-lxmZK4xFrdvU0yZiDwgVQTCvh2gHWBJCBk5ALsrtsBWhs0uDIi+FTOnXRQeQfs304imdvTdaakT/lqwQ8hkOXQ==}
+  '@oxc-project/types@0.98.0':
+    resolution: {integrity: sha512-Vzmd6FsqVuz5HQVcRC/hrx7Ujo3WEVeQP7C2UNP5uy1hUY4SQvMB+93jxkI1KRHz9a/6cni3glPOtvteN+zpsw==}
 
   '@pkgjs/parseargs@0.11.0':
     resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}
···
     cpu: [arm64]
     os: [android]
 
-  '@rolldown/binding-android-arm64@1.0.0-beta.50':
-    resolution: {integrity: sha512-XlEkrOIHLyGT3avOgzfTFSjG+f+dZMw+/qd+Y3HLN86wlndrB/gSimrJCk4gOhr1XtRtEKfszpadI3Md4Z4/Ag==}
+  '@rolldown/binding-android-arm64@1.0.0-beta.51':
+    resolution: {integrity: sha512-Ctn8FUXKWWQI9pWC61P1yumS9WjQtelNS9riHwV7oCkknPGaAry4o7eFx2KgoLMnI2BgFJYpW7Im8/zX3BuONg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [android]
···
     cpu: [arm64]
     os: [darwin]
 
-  '@rolldown/binding-darwin-arm64@1.0.0-beta.50':
-    resolution: {integrity: sha512-+JRqKJhoFlt5r9q+DecAGPLZ5PxeLva+wCMtAuoFMWPoZzgcYrr599KQ+Ix0jwll4B4HGP43avu9My8KtSOR+w==}
+  '@rolldown/binding-darwin-arm64@1.0.0-beta.51':
+    resolution: {integrity: sha512-EL1aRW2Oq15ShUEkBPsDtLMO8GTqfb/ktM/dFaVzXKQiEE96Ss6nexMgfgQrg8dGnNpndFyffVDb5IdSibsu1g==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [darwin]
···
     cpu: [x64]
     os: [darwin]
 
-  '@rolldown/binding-darwin-x64@1.0.0-beta.50':
-    resolution: {integrity: sha512-fFXDjXnuX7/gQZQm/1FoivVtRcyAzdjSik7Eo+9iwPQ9EgtA5/nB2+jmbzaKtMGG3q+BnZbdKHCtOacmNrkIDA==}
+  '@rolldown/binding-darwin-x64@1.0.0-beta.51':
+    resolution: {integrity: sha512-uGtYKlFen9pMIPvkHPWZVDtmYhMQi5g5Ddsndg1gf3atScKYKYgs5aDP4DhHeTwGXQglhfBG7lEaOIZ4UAIWww==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [darwin]
···
     cpu: [x64]
     os: [freebsd]
 
-  '@rolldown/binding-freebsd-x64@1.0.0-beta.50':
-    resolution: {integrity: sha512-F1b6vARy49tjmT/hbloplzgJS7GIvwWZqt+tAHEstCh0JIh9sa8FAMVqEmYxDviqKBaAI8iVvUREm/Kh/PD26Q==}
+  '@rolldown/binding-freebsd-x64@1.0.0-beta.51':
+    resolution: {integrity: sha512-JRoVTQtHYbZj1P07JLiuTuXjiBtIa7ag7/qgKA6CIIXnAcdl4LrOf7nfDuHPJcuRKaP5dzecMgY99itvWfmUFQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [freebsd]
···
     cpu: [arm]
     os: [linux]
 
-  '@rolldown/binding-linux-arm-gnueabihf@1.0.0-beta.50':
-    resolution: {integrity: sha512-U6cR76N8T8M6lHj7EZrQ3xunLPxSvYYxA8vJsBKZiFZkT8YV4kjgCO3KwMJL0NOjQCPGKyiXO07U+KmJzdPGRw==}
+  '@rolldown/binding-linux-arm-gnueabihf@1.0.0-beta.51':
+    resolution: {integrity: sha512-BKATVnpPZ0TYBW9XfDwyd4kPGgvf964HiotIwUgpMrFOFYWqpZ+9ONNzMV4UFAYC7Hb5C2qgYQk/qj2OnAd4RQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [linux]
···
     cpu: [arm64]
     os: [linux]
 
-  '@rolldown/binding-linux-arm64-gnu@1.0.0-beta.50':
-    resolution: {integrity: sha512-ONgyjofCrrE3bnh5GZb8EINSFyR/hmwTzZ7oVuyUB170lboza1VMCnb8jgE6MsyyRgHYmN8Lb59i3NKGrxrYjw==}
+  '@rolldown/binding-linux-arm64-gnu@1.0.0-beta.51':
+    resolution: {integrity: sha512-xLd7da5jkfbVsBCm1buIRdWtuXY8+hU3+6ESXY/Tk5X5DPHaifrUblhYDgmA34dQt6WyNC2kfXGgrduPEvDI6Q==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
···
     cpu: [arm64]
     os: [linux]
 
-  '@rolldown/binding-linux-arm64-musl@1.0.0-beta.50':
-    resolution: {integrity: sha512-L0zRdH2oDPkmB+wvuTl+dJbXCsx62SkqcEqdM+79LOcB+PxbAxxjzHU14BuZIQdXcAVDzfpMfaHWzZuwhhBTcw==}
+  '@rolldown/binding-linux-arm64-musl@1.0.0-beta.51':
+    resolution: {integrity: sha512-EQFXTgHxxTzv3t5EmjUP/DfxzFYx9sMndfLsYaAY4DWF6KsK1fXGYsiupif6qPTViPC9eVmRm78q0pZU/kuIPg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
···
     cpu: [x64]
     os: [linux]
 
-  '@rolldown/binding-linux-x64-gnu@1.0.0-beta.50':
-    resolution: {integrity: sha512-gyoI8o/TGpQd3OzkJnh1M2kxy1Bisg8qJ5Gci0sXm9yLFzEXIFdtc4EAzepxGvrT2ri99ar5rdsmNG0zP0SbIg==}
+  '@rolldown/binding-linux-x64-gnu@1.0.0-beta.51':
+    resolution: {integrity: sha512-p5P6Xpa68w3yFaAdSzIZJbj+AfuDnMDqNSeglBXM7UlJT14Q4zwK+rV+8Mhp9MiUb4XFISZtbI/seBprhkQbiQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
···
     cpu: [x64]
     os: [linux]
 
-  '@rolldown/binding-linux-x64-musl@1.0.0-beta.50':
-    resolution: {integrity: sha512-zti8A7M+xFDpKlghpcCAzyOi+e5nfUl3QhU023ce5NCgUxRG5zGP2GR9LTydQ1rnIPwZUVBWd4o7NjZDaQxaXA==}
+  '@rolldown/binding-linux-x64-musl@1.0.0-beta.51':
+    resolution: {integrity: sha512-sNVVyLa8HB8wkFipdfz1s6i0YWinwpbMWk5hO5S+XAYH2UH67YzUT13gs6wZTKg2x/3gtgXzYnHyF5wMIqoDAw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
···
     cpu: [arm64]
     os: [openharmony]
 
-  '@rolldown/binding-openharmony-arm64@1.0.0-beta.50':
-    resolution: {integrity: sha512-eZUssog7qljrrRU9Mi0eqYEPm3Ch0UwB+qlWPMKSUXHNqhm3TvDZarJQdTevGEfu3EHAXJvBIe0YFYr0TPVaMA==}
+  '@rolldown/binding-openharmony-arm64@1.0.0-beta.51':
+    resolution: {integrity: sha512-e/JMTz9Q8+T3g/deEi8DK44sFWZWGKr9AOCW5e8C8SCVWzAXqYXAG7FXBWBNzWEZK0Rcwo9TQHTQ9Q0gXgdCaA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [openharmony]
···
     engines: {node: '>=14.0.0'}
     cpu: [wasm32]
 
-  '@rolldown/binding-wasm32-wasi@1.0.0-beta.50':
-    resolution: {integrity: sha512-nmCN0nIdeUnmgeDXiQ+2HU6FT162o+rxnF7WMkBm4M5Ds8qTU7Dzv2Wrf22bo4ftnlrb2hKK6FSwAJSAe2FWLg==}
+  '@rolldown/binding-wasm32-wasi@1.0.0-beta.51':
+    resolution: {integrity: sha512-We3LWqSu6J9s5Y0MK+N7fUiiu37aBGPG3Pc347EoaROuAwkCS2u9xJ5dpIyLW4B49CIbS3KaPmn4kTgPb3EyPw==}
     engines: {node: '>=14.0.0'}
     cpu: [wasm32]
 
···
     cpu: [arm64]
     os: [win32]
 
-  '@rolldown/binding-win32-arm64-msvc@1.0.0-beta.50':
-    resolution: {integrity: sha512-7kcNLi7Ua59JTTLvbe1dYb028QEPaJPJQHqkmSZ5q3tJueUeb6yjRtx8mw4uIqgWZcnQHAR3PrLN4XRJxvgIkA==}
+  '@rolldown/binding-win32-arm64-msvc@1.0.0-beta.51':
+    resolution: {integrity: sha512-fj56buHRuMM+r/cb6ZYfNjNvO/0xeFybI6cTkTROJatdP4fvmQ1NS8D/Lm10FCSDEOkqIz8hK3TGpbAThbPHsA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [win32]
···
     cpu: [ia32]
     os: [win32]
 
-  '@rolldown/binding-win32-ia32-msvc@1.0.0-beta.50':
-    resolution: {integrity: sha512-lL70VTNvSCdSZkDPPVMwWn/M2yQiYvSoXw9hTLgdIWdUfC3g72UaruezusR6ceRuwHCY1Ayu2LtKqXkBO5LIwg==}
+  '@rolldown/binding-win32-ia32-msvc@1.0.0-beta.51':
+    resolution: {integrity: sha512-fkqEqaeEx8AySXiDm54b/RdINb3C0VovzJA3osMhZsbn6FoD73H0AOIiaVAtGr6x63hefruVKTX8irAm4Jkt2w==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ia32]
     os: [win32]
···
     cpu: [x64]
     os: [win32]
 
-  '@rolldown/binding-win32-x64-msvc@1.0.0-beta.50':
-    resolution: {integrity: sha512-4qU4x5DXWB4JPjyTne/wBNPqkbQU8J45bl21geERBKtEittleonioACBL1R0PsBu0Aq21SwMK5a9zdBkWSlQtQ==}
+  '@rolldown/binding-win32-x64-msvc@1.0.0-beta.51':
+    resolution: {integrity: sha512-CWuLG/HMtrVcjKGa0C4GnuxONrku89g0+CsH8nT0SNhOtREXuzwgjIXNJImpE/A/DMf9JF+1Xkrq/YRr+F/rCg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [win32]
···
   '@rolldown/pluginutils@1.0.0-beta.41':
     resolution: {integrity: sha512-ycMEPrS3StOIeb87BT3/+bu+blEtyvwQ4zmo2IcJQy0Rd1DAAhKksA0iUZ3MYSpJtjlPhg0Eo6mvVS6ggPhRbw==}
 
-  '@rolldown/pluginutils@1.0.0-beta.50':
-    resolution: {integrity: sha512-5e76wQiQVeL1ICOZVUg4LSOVYg9jyhGCin+icYozhsUzM+fHE7kddi1bdiE0jwVqTfkjba3jUFbEkoC9WkdvyA==}
+  '@rolldown/pluginutils@1.0.0-beta.51':
+    resolution: {integrity: sha512-51/8cNXMrqWqX3o8DZidhwz1uYq0BhHDDSfVygAND1Skx5s1TDw3APSSxCMcFFedwgqGcx34gRouwY+m404BBQ==}
 
   '@shikijs/core@2.5.0':
     resolution: {integrity: sha512-uu/8RExTKtavlpH7XqnVYBrfBkUc20ngXiX9NSrBhOVZYv/7XQRKUyhtkeflY5QsxC0GbJThCerruZfsUaSldg==}
···
   character-entities-legacy@3.0.0:
     resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
 
+  chardet@2.1.1:
+    resolution: {integrity: sha512-PsezH1rqdV9VvyNhxxOW32/d75r01NY7TQCmOqomRo15ZSOKbpTFVsfjghxo6JloQUCGnH4k1LGu0R4yCLlWQQ==}
+
   check-error@2.1.1:
     resolution: {integrity: sha512-OAlb+T7V4Op9OwdkjmguYRqncdlx5JiofwOAUkmTF+jNdHwzTaTs4sRAGpzLF3oOz5xAyDGrPgeIDFQmDOTiJw==}
     engines: {node: '>= 16'}
···
     resolution: {integrity: sha512-GfisEZEJvzKrmGWkvfhgzcz/BllN1USeqD2V6tg14OAOgaCD2Z/PUEuxnAZ/nPvmaHRG7a8y77p1T/IRQ4D1Hw==}
     engines: {node: '>=4'}
 
+  cli-width@4.1.0:
+    resolution: {integrity: sha512-ouuZd4/dm2Sw5Gmqy6bGyNNNe1qt9RpmxveLSO7KcgsTnU7RXfsw+/bukWGo1abgBiMAic068rclZsO4IWmmxQ==}
+    engines: {node: '>= 12'}
+
   cliui@8.0.1:
     resolution: {integrity: sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==}
     engines: {node: '>=12'}
···
   emoji-regex-xs@1.0.0:
     resolution: {integrity: sha512-LRlerrMYoIDrT6jgpeZ2YYl/L8EulRTt5hQcYjy5AInh7HWXKimpqx68aknBFpGL2+/IcogTcaydJEgaTmOpDg==}
 
+  emoji-regex@10.6.0:
+    resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==}
+
   emoji-regex@8.0.0:
     resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
 
···
     resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
     engines: {node: 6.* || 8.* || >= 10.*}
 
+  get-east-asian-width@1.4.0:
+    resolution: {integrity: sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q==}
+    engines: {node: '>=18'}
+
   get-tsconfig@4.12.0:
     resolution: {integrity: sha512-LScr2aNr2FbjAjZh2C6X6BxRx1/x+aTDExct/xyq2XKbYOiG5c0aK7pMsSuyc0brz3ibr/lbQiHD9jzt4lccJw==}
 
···
 
   iconv-lite@0.6.3:
     resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==}
+    engines: {node: '>=0.10.0'}
+
+  iconv-lite@0.7.0:
+    resolution: {integrity: sha512-cf6L2Ds3h57VVmkZe+Pn+5APsT7FpqJtEhhieDCvrE2MK5Qk9MyffgQyuxQTm6BChfeZNtcOLHp9IcWRVcIcBQ==}
     engines: {node: '>=0.10.0'}
 
   ignore@5.3.2:
···
   ms@2.1.3:
     resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
 
+  mute-stream@3.0.0:
+    resolution: {integrity: sha512-dkEJPVvun4FryqBmZ5KhDo0K9iDXAwn08tMLDinNdRBNPcYEDiWYysLcc6k3mjTMlbP9KyylvRpd4wFtwrT9rw==}
+    engines: {node: ^20.17.0 || >=22.9.0}
+
   nanoid@3.3.11:
     resolution: {integrity: sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==}
     engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
···
     engines: {node: ^20.19.0 || >=22.12.0}
     hasBin: true
 
-  rolldown@1.0.0-beta.50:
-    resolution: {integrity: sha512-JFULvCNl/anKn99eKjOSEubi0lLmNqQDAjyEMME2T4CwezUDL0i6t1O9xZsu2OMehPnV2caNefWpGF+8TnzB6A==}
+  rolldown@1.0.0-beta.51:
+    resolution: {integrity: sha512-ZRLgPlS91l4JztLYEZnmMcd3Umcla1hkXJgiEiR4HloRJBBoeaX8qogTu5Jfu36rRMVLndzqYv0h+M5gJAkUfg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     hasBin: true
 
···
   string-width@5.1.2:
     resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==}
     engines: {node: '>=12'}
+
+  string-width@7.2.0:
+    resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==}
+    engines: {node: '>=18'}
 
   stringify-entities@4.0.4:
     resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==}
···
     resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==}
     engines: {node: '>=12'}
 
+  wrap-ansi@9.0.2:
+    resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==}
+    engines: {node: '>=18'}
+
   ws@8.18.3:
     resolution: {integrity: sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==}
     engines: {node: '>=10.0.0'}
···
 
   '@iconify/types@2.0.0': {}
 
+  '@inquirer/ansi@2.0.1': {}
+
+  '@inquirer/checkbox@5.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/ansi': 2.0.1
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/figures': 2.0.1
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/confirm@6.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/core@11.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/ansi': 2.0.1
+      '@inquirer/figures': 2.0.1
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+      cli-width: 4.1.0
+      mute-stream: 3.0.0
+      signal-exit: 4.1.0
+      wrap-ansi: 9.0.2
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/editor@5.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/external-editor': 2.0.1(@types/node@24.8.1)
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/expand@5.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/external-editor@2.0.1(@types/node@24.8.1)':
+    dependencies:
+      chardet: 2.1.1
+      iconv-lite: 0.7.0
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/figures@2.0.1': {}
+
+  '@inquirer/input@5.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/number@4.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/password@5.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/ansi': 2.0.1
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/prompts@8.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/checkbox': 5.0.1(@types/node@24.8.1)
+      '@inquirer/confirm': 6.0.1(@types/node@24.8.1)
+      '@inquirer/editor': 5.0.1(@types/node@24.8.1)
+      '@inquirer/expand': 5.0.1(@types/node@24.8.1)
+      '@inquirer/input': 5.0.1(@types/node@24.8.1)
+      '@inquirer/number': 4.0.1(@types/node@24.8.1)
+      '@inquirer/password': 5.0.1(@types/node@24.8.1)
+      '@inquirer/rawlist': 5.0.1(@types/node@24.8.1)
+      '@inquirer/search': 4.0.1(@types/node@24.8.1)
+      '@inquirer/select': 5.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/rawlist@5.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/search@4.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/figures': 2.0.1
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/select@5.0.1(@types/node@24.8.1)':
+    dependencies:
+      '@inquirer/ansi': 2.0.1
+      '@inquirer/core': 11.0.1(@types/node@24.8.1)
+      '@inquirer/figures': 2.0.1
+      '@inquirer/type': 4.0.1(@types/node@24.8.1)
+    optionalDependencies:
+      '@types/node': 24.8.1
+
+  '@inquirer/type@4.0.1(@types/node@24.8.1)':
+    optionalDependencies:
+      '@types/node': 24.8.1
+
   '@isaacs/cliui@8.0.2':
     dependencies:
       string-width: 5.1.2
···
 
   '@oxc-project/types@0.93.0': {}
 
-  '@oxc-project/types@0.97.0': {}
+  '@oxc-project/types@0.98.0': {}
 
   '@pkgjs/parseargs@0.11.0':
     optional: true
···
   '@rolldown/binding-android-arm64@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-android-arm64@1.0.0-beta.50':
+  '@rolldown/binding-android-arm64@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-darwin-arm64@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-darwin-arm64@1.0.0-beta.50':
+  '@rolldown/binding-darwin-arm64@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-darwin-x64@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-darwin-x64@1.0.0-beta.50':
+  '@rolldown/binding-darwin-x64@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-freebsd-x64@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-freebsd-x64@1.0.0-beta.50':
+  '@rolldown/binding-freebsd-x64@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-linux-arm-gnueabihf@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-linux-arm-gnueabihf@1.0.0-beta.50':
+  '@rolldown/binding-linux-arm-gnueabihf@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-linux-arm64-gnu@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-linux-arm64-gnu@1.0.0-beta.50':
+  '@rolldown/binding-linux-arm64-gnu@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-linux-arm64-musl@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-linux-arm64-musl@1.0.0-beta.50':
+  '@rolldown/binding-linux-arm64-musl@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-linux-x64-gnu@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-linux-x64-gnu@1.0.0-beta.50':
+  '@rolldown/binding-linux-x64-gnu@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-linux-x64-musl@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-linux-x64-musl@1.0.0-beta.50':
+  '@rolldown/binding-linux-x64-musl@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-openharmony-arm64@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-openharmony-arm64@1.0.0-beta.50':
+  '@rolldown/binding-openharmony-arm64@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-wasm32-wasi@1.0.0-beta.41':
···
       '@napi-rs/wasm-runtime': 1.0.7
     optional: true
 
-  '@rolldown/binding-wasm32-wasi@1.0.0-beta.50':
+  '@rolldown/binding-wasm32-wasi@1.0.0-beta.51':
     dependencies:
       '@napi-rs/wasm-runtime': 1.0.7
     optional: true
···
   '@rolldown/binding-win32-arm64-msvc@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-win32-arm64-msvc@1.0.0-beta.50':
+  '@rolldown/binding-win32-arm64-msvc@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-win32-ia32-msvc@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-win32-ia32-msvc@1.0.0-beta.50':
+  '@rolldown/binding-win32-ia32-msvc@1.0.0-beta.51':
     optional: true
 
   '@rolldown/binding-win32-x64-msvc@1.0.0-beta.41':
     optional: true
 
-  '@rolldown/binding-win32-x64-msvc@1.0.0-beta.50':
+  '@rolldown/binding-win32-x64-msvc@1.0.0-beta.51':
     optional: true
 
   '@rolldown/pluginutils@1.0.0-beta.41': {}
 
-  '@rolldown/pluginutils@1.0.0-beta.50': {}
+  '@rolldown/pluginutils@1.0.0-beta.51': {}
 
   '@shikijs/core@2.5.0':
     dependencies:
···
 
   character-entities-legacy@3.0.0: {}
 
+  chardet@2.1.1: {}
+
   check-error@2.1.1: {}
 
   chokidar@3.6.0:
···
     dependencies:
       escape-string-regexp: 1.0.5
 
+  cli-width@4.1.0: {}
+
   cliui@8.0.1:
     dependencies:
       string-width: 4.2.3
···
   electron-to-chromium@1.5.237: {}
 
   emoji-regex-xs@1.0.0: {}
+
+  emoji-regex@10.6.0: {}
 
   emoji-regex@8.0.0: {}
 
···
 
   get-caller-file@2.0.5: {}
 
+  get-east-asian-width@1.4.0: {}
+
   get-tsconfig@4.12.0:
     dependencies:
       resolve-pkg-maps: 1.0.0
···
     dependencies:
       safer-buffer: 2.1.2
 
+  iconv-lite@0.7.0:
+    dependencies:
+      safer-buffer: 2.1.2
+
   ignore@5.3.2: {}
 
   ignore@7.0.5: {}
···
   mitt@3.0.1: {}
 
   ms@2.1.3: {}
+
+  mute-stream@3.0.0: {}
 
   nanoid@3.3.11: {}
 
···
 
   rfdc@1.4.1: {}
 
-  rolldown-plugin-dts@0.16.12(rolldown@1.0.0-beta.50)(typescript@5.9.3):
+  rolldown-plugin-dts@0.16.12(rolldown@1.0.0-beta.51)(typescript@5.9.3):
     dependencies:
       '@babel/generator': 7.28.3
       '@babel/parser': 7.28.4
···
       dts-resolver: 2.1.2
       get-tsconfig: 4.12.0
       magic-string: 0.30.19
-      rolldown: 1.0.0-beta.50
+      rolldown: 1.0.0-beta.51
     optionalDependencies:
       typescript: 5.9.3
     transitivePeerDependencies:
···
       '@rolldown/binding-win32-ia32-msvc': 1.0.0-beta.41
       '@rolldown/binding-win32-x64-msvc': 1.0.0-beta.41
 
-  rolldown@1.0.0-beta.50:
+  rolldown@1.0.0-beta.51:
     dependencies:
-      '@oxc-project/types': 0.97.0
-      '@rolldown/pluginutils': 1.0.0-beta.50
+      '@oxc-project/types': 0.98.0
+      '@rolldown/pluginutils': 1.0.0-beta.51
     optionalDependencies:
-      '@rolldown/binding-android-arm64': 1.0.0-beta.50
-      '@rolldown/binding-darwin-arm64': 1.0.0-beta.50
-      '@rolldown/binding-darwin-x64': 1.0.0-beta.50
-      '@rolldown/binding-freebsd-x64': 1.0.0-beta.50
-      '@rolldown/binding-linux-arm-gnueabihf': 1.0.0-beta.50
-      '@rolldown/binding-linux-arm64-gnu': 1.0.0-beta.50
-      '@rolldown/binding-linux-arm64-musl': 1.0.0-beta.50
-      '@rolldown/binding-linux-x64-gnu': 1.0.0-beta.50
-      '@rolldown/binding-linux-x64-musl': 1.0.0-beta.50
-      '@rolldown/binding-openharmony-arm64': 1.0.0-beta.50
-      '@rolldown/binding-wasm32-wasi': 1.0.0-beta.50
-      '@rolldown/binding-win32-arm64-msvc': 1.0.0-beta.50
-      '@rolldown/binding-win32-ia32-msvc': 1.0.0-beta.50
-      '@rolldown/binding-win32-x64-msvc': 1.0.0-beta.50
+      '@rolldown/binding-android-arm64': 1.0.0-beta.51
+      '@rolldown/binding-darwin-arm64': 1.0.0-beta.51
+      '@rolldown/binding-darwin-x64': 1.0.0-beta.51
+      '@rolldown/binding-freebsd-x64': 1.0.0-beta.51
+      '@rolldown/binding-linux-arm-gnueabihf': 1.0.0-beta.51
+      '@rolldown/binding-linux-arm64-gnu': 1.0.0-beta.51
+      '@rolldown/binding-linux-arm64-musl': 1.0.0-beta.51
+      '@rolldown/binding-linux-x64-gnu': 1.0.0-beta.51
+      '@rolldown/binding-linux-x64-musl': 1.0.0-beta.51
+      '@rolldown/binding-openharmony-arm64': 1.0.0-beta.51
+      '@rolldown/binding-wasm32-wasi': 1.0.0-beta.51
+      '@rolldown/binding-win32-arm64-msvc': 1.0.0-beta.51
+      '@rolldown/binding-win32-ia32-msvc': 1.0.0-beta.51
+      '@rolldown/binding-win32-x64-msvc': 1.0.0-beta.51
 
   rrweb-cssom@0.8.0: {}
 
···
     dependencies:
       eastasianwidth: 0.2.0
       emoji-regex: 9.2.2
+      strip-ansi: 7.1.2
+
+  string-width@7.2.0:
+    dependencies:
+      emoji-regex: 10.6.0
+      get-east-asian-width: 1.4.0
       strip-ansi: 7.1.2
 
   stringify-entities@4.0.4:
···
       diff: 8.0.2
       empathic: 2.0.0
       hookable: 5.5.3
-      rolldown: 1.0.0-beta.50
-      rolldown-plugin-dts: 0.16.12(rolldown@1.0.0-beta.50)(typescript@5.9.3)
+      rolldown: 1.0.0-beta.51
+      rolldown-plugin-dts: 0.16.12(rolldown@1.0.0-beta.51)(typescript@5.9.3)
       semver: 7.7.3
       tinyexec: 1.0.1
       tinyglobby: 0.2.15
···
     dependencies:
       ansi-styles: 6.2.3
       string-width: 5.1.2
+      strip-ansi: 7.1.2
+
+  wrap-ansi@9.0.2:
+    dependencies:
+      ansi-styles: 6.2.3
+      string-width: 7.2.0
       strip-ansi: 7.1.2
 
   ws@8.18.3: {}

pnpm-workspace.yaml

···
   - 'lib'
   - 'dev'
   - 'docs'
+  - 'cli'