@zenithbuild/cli 0.4.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zenith Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @zenithbuild/cli ⚡
+
+The command-line interface for developing and building Zenith applications.
+
+## Overview
+
+`@zenithbuild/cli` provides the toolchain needed to manage Zenith projects. While `create-zenith` is for scaffolding, this CLI is for the daily development loop: serving apps, building for production, and managing plugins.
+
+## Features
+
+- **Dev Server**: Instant HMR (Hot Module Replacement) powered by Bun.
+- **Build System**: optimized production bundling.
+- **Plugin Management**: Easily add and remove Zenith plugins.
+- **Preview**: Test your production builds locally.
+
+## Commands
+
+### `zenith dev`
+Starts the development server on `localhost:3000`.
+
+### `zenith build`
+Compiles and bundles your application for production.
+
+### `zenith preview`
+Serves the locally built application for verification.
+
+### `zenith add <plugin>`
+Installs and configures a Zenith plugin.
+
+## Installation
+
+Typically installed as a dev dependency in your Zenith project:
+
+```bash
+bun add -d @zenithbuild/cli
+```
+
+## License
+
+MIT

package/bin/zen-build.ts

@@ -0,0 +1,2 @@
+import { runCLI } from '../src/main'
+runCLI({ defaultCommand: 'build' })

package/bin/zen-dev.ts

@@ -0,0 +1,2 @@
+import { runCLI } from '../src/main'
+runCLI({ defaultCommand: 'dev' })

package/bin/zen-preview.ts

@@ -0,0 +1,2 @@
+import { runCLI } from '../src/main'
+runCLI({ defaultCommand: 'preview' })

package/bin/zenith.ts

@@ -0,0 +1,2 @@
+import { runCLI } from '../src/main'
+runCLI()

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@zenithbuild/cli",
+  "version": "0.4.2",
+  "description": "CLI for Zenith framework - dev server, build tools, and plugin management",
+  "type": "module",
+  "bin": {
+    "zenith": "./dist/zenith.js",
+    "zen-dev": "./dist/zen-dev.js",
+    "zen-build": "./dist/zen-build.js",
+    "zen-preview": "./dist/zen-preview.js"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "dev": "bun run build && bin/zenith.ts dev",
+    "build": "bun build bin/zenith.ts bin/zen-dev.ts bin/zen-build.ts bin/zen-preview.ts --outdir dist --target bun --bundle && for f in dist/*.js; do echo '#!/usr/bin/env bun' | cat - \"$f\" > \"$f.tmp\" && mv \"$f.tmp\" \"$f\" && chmod +x \"$f\"; done",
+    "start": "bun run build && bun run dev",
+    "test": "bun test",
+    "release": "bun run scripts/release.ts",
+    "release:dry": "bun run scripts/release.ts --dry-run",
+    "release:patch": "bun run scripts/release.ts --bump=patch",
+    "release:minor": "bun run scripts/release.ts --bump=minor",
+    "release:major": "bun run scripts/release.ts --bump=major"
+  },
+  "keywords": [
+    "zenith",
+    "cli",
+    "framework",
+    "ssg",
+    "ssr"
+  ],
+  "author": "Zenith Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:zenithbuild/zenith-cli.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "private": false,
+  "peerDependencies": {
+    "@zenithbuild/core": "^1.2.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "dependencies": {
+    "@zenithbuild/compiler": "1.0.2",
+    "@zenithbuild/router": "1.0.1",
+    "picocolors": "^1.0.0"
+  }
+}

package/src/commands/add.ts

@@ -0,0 +1,37 @@
+/**
+ * @zenithbuild/cli - Add Command
+ * 
+ * Registers a plugin in the project
+ */
+
+import { requireProject } from '../utils/project'
+import { addPlugin, hasPlugin } from '../utils/plugin-manager'
+import * as logger from '../utils/logger'
+
+export interface AddOptions {
+    options?: Record<string, unknown>
+}
+
+export async function add(pluginName: string, options: AddOptions = {}): Promise<void> {
+    requireProject()
+
+    logger.header('Add Plugin')
+
+    if (!pluginName) {
+        logger.error('Plugin name required. Usage: zenith add <plugin>')
+        process.exit(1)
+    }
+
+    if (hasPlugin(pluginName)) {
+        logger.warn(`Plugin "${pluginName}" is already registered`)
+        return
+    }
+
+    const success = addPlugin(pluginName, options.options)
+
+    if (success) {
+        logger.info(`Plugin "${pluginName}" has been registered.`)
+        logger.info('Note: You may need to install the package manually:')
+        logger.log(`  bun add @zenithbuild/plugin-${pluginName}`)
+    }
+}

package/src/commands/build.ts

@@ -0,0 +1,36 @@
+/**
+ * @zenithbuild/cli - Build Command
+ * 
+ * Builds the application for production using SSG.
+ */
+
+import { requireProject } from '../utils/project'
+import * as logger from '../utils/logger'
+import { buildSSG } from '@zenithbuild/compiler'
+
+export interface BuildOptions {
+    outDir?: string
+}
+
+export async function build(options: BuildOptions = {}): Promise<void> {
+    const project = requireProject()
+    const outDir = options.outDir || project.distDir
+
+    logger.header('Zenith Build')
+    logger.log(`Source: ${project.pagesDir}`)
+    logger.log(`Output: ${outDir}`)
+
+    try {
+        buildSSG({
+            pagesDir: project.pagesDir,
+            outDir: outDir,
+            baseDir: project.root
+        })
+        logger.success('Build complete!')
+
+    } catch (err: unknown) {
+        const message = err instanceof Error ? err.message : String(err)
+        logger.error(`Build failed: ${message}`)
+        process.exit(1)
+    }
+}