@cmj/juice 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cmj
+
+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,88 @@
+# 🧃 Juice
+
+Zero-bloat React 19 RSC framework.  
+Streaming SSR. Server Actions. Zero config.
+
+## Install
+
+```bash
+npm install @cmj/juice react@^19 react-dom@^19 vite@^6
+```
+
+## Quickstart
+
+```bash
+npx juice create my-app
+cd my-app
+npm install
+npm run dev
+```
+
+Or scaffold for a specific target:
+
+```bash
+npx juice create my-app --target cloudflare
+```
+
+**Targets:** `bun` (default), `node`, `cloudflare`, `deno`
+
+## CLI
+
+| Command | Description |
+|---------|-------------|
+| `juice create <name>` | Scaffold a new Juice app |
+| `juice dev` | Start the Vite dev server |
+| `juice build` | Production build (client + SSR) |
+
+## API
+
+### `juice/plugin`
+
+The Vite plugin. Zero config.
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import juice from '@cmj/juice/plugin';
+
+export default defineConfig({
+  plugins: [juice()],
+});
+```
+
+### `juice/runtime`
+
+The WinterCG-compliant edge runtime.
+
+```ts
+// server.ts
+import { createRouter } from '@cmj/juice/runtime';
+import manifest from './dist/flight-manifest.json' with { type: 'json' };
+
+const handler = createRouter(manifest);
+// handler: (Request) => Promise<Response>
+```
+
+## How It Works
+
+```
+Source (.tsx) → Vite Plugin → flight-manifest.json → Runtime → Response
+```
+
+1. **Compile:** The Vite plugin detects `'use client'` and `'use server'` directives, generates proxy modules, and emits a `flight-manifest.json`.
+2. **Serve:** The runtime reads the manifest and streams RSC responses using React 19's `renderToReadableStream`.
+3. **Deploy:** The `Request → Response` signature works on any WinterCG platform.
+
+## Features
+
+- **React 19 RSC** — Server Components, Suspense, streaming SSR
+- **Server Actions** — `'use server'` with FormData support
+- **Zero config** — One plugin call, no magic files
+- **Zero runtime deps** — Pure ESM, nothing to install at runtime
+- **Multi-platform** — Bun, Node.js, Cloudflare Workers, Deno
+- **Empathic errors** — "What-Why-How" error messages for fast debugging
+- **HMR** — Full hot module replacement in development
+
+## License
+
+MIT

package/dist/cli/commands.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `juice dev` — starts the Vite dev server.
+ *
+ * Passes through any additional args to `vite dev`.
+ *
+ * @example
+ * ```
+ * juice dev
+ * juice dev --port 4000
+ * juice dev --host 0.0.0.0
+ * ```
+ */
+export declare function runDev(extraArgs?: string[], cwd?: string): Promise<number>;
+/**
+ * `juice build` — runs the Vite dual build.
+ *
+ * 1. Client build: `vite build` (produces client chunks + flight-manifest.json)
+ * 2. SSR build: `vite build --ssr server.ts` (produces server bundle)
+ *
+ * Passes through any additional args to both builds.
+ *
+ * @example
+ * ```
+ * juice build
+ * juice build --outDir dist/production
+ * ```
+ */
+export declare function runBuild(extraArgs?: string[], cwd?: string): Promise<number>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAC1B,SAAS,GAAE,MAAM,EAAO,EACxB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,GAAE,MAAM,EAAO,EACxB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAkCjB"}

package/dist/cli/commands.js

@@ -0,0 +1,102 @@
+// ─────────────────────────────────────────────────────────────────
+// @cmj/juice — CLI Commands (dev / build)
+// Thin wrappers around Vite's CLI. Zero overhead — stdio passthrough.
+// ─────────────────────────────────────────────────────────────────
+import { spawn } from 'node:child_process';
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Find the local `vite` binary. Prefers the project's node_modules/.bin,
+ * falls back to `npx vite` if not found.
+ */
+function findViteBin(cwd) {
+    const local = resolve(cwd, 'node_modules', '.bin', 'vite');
+    if (existsSync(local)) {
+        return { command: local, prefix: [] };
+    }
+    // Fallback: use npx to resolve vite
+    return { command: 'npx', prefix: ['vite'] };
+}
+/**
+ * Spawn a child process and return its exit code.
+ * Stdio is fully inherited — the user sees Vite's output directly.
+ */
+function run(command, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd,
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+        child.on('error', reject);
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+}
+// ── Public API ──────────────────────────────────────────────────
+/**
+ * `juice dev` — starts the Vite dev server.
+ *
+ * Passes through any additional args to `vite dev`.
+ *
+ * @example
+ * ```
+ * juice dev
+ * juice dev --port 4000
+ * juice dev --host 0.0.0.0
+ * ```
+ */
+export async function runDev(extraArgs = [], cwd = process.cwd()) {
+    const { command, prefix } = findViteBin(cwd);
+    const args = [...prefix, 'dev', ...extraArgs];
+    console.log('🧃 Starting dev server...\n');
+    return run(command, args, cwd);
+}
+/**
+ * `juice build` — runs the Vite dual build.
+ *
+ * 1. Client build: `vite build` (produces client chunks + flight-manifest.json)
+ * 2. SSR build: `vite build --ssr server.ts` (produces server bundle)
+ *
+ * Passes through any additional args to both builds.
+ *
+ * @example
+ * ```
+ * juice build
+ * juice build --outDir dist/production
+ * ```
+ */
+export async function runBuild(extraArgs = [], cwd = process.cwd()) {
+    const { command, prefix } = findViteBin(cwd);
+    // Step 1: Client build
+    console.log('🧃 Building client...\n');
+    const clientCode = await run(command, [...prefix, 'build', ...extraArgs], cwd);
+    if (clientCode !== 0) {
+        console.error('\n🧃 Client build failed.\n');
+        return clientCode;
+    }
+    // Step 2: SSR build
+    console.log('\n🧃 Building server (SSR)...\n');
+    // Determine SSR entry — check common locations
+    const ssrEntry = findSSREntry(cwd);
+    const ssrCode = await run(command, [...prefix, 'build', '--ssr', ssrEntry, ...extraArgs], cwd);
+    if (ssrCode !== 0) {
+        console.error('\n🧃 SSR build failed.\n');
+        return ssrCode;
+    }
+    console.log('\n🧃 Build complete.\n');
+    return 0;
+}
+/**
+ * Find the SSR entry point. Checks common locations in order.
+ */
+function findSSREntry(cwd) {
+    const candidates = ['server.ts', 'server.tsx', 'src/server.ts', 'src/entry-server.ts'];
+    for (const candidate of candidates) {
+        if (existsSync(resolve(cwd, candidate))) {
+            return candidate;
+        }
+    }
+    // Default — let Vite resolve it (will error with a clear message if missing)
+    return 'server.ts';
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,0CAA0C;AAC1C,sEAAsE;AACtE,oEAAoE;AAEpE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IACD,oCAAoC;IACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAS,GAAG,CACV,OAAe,EACf,IAAc,EACd,GAAW;IAEX,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG;YACH,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;SACpC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AAEnE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,YAAsB,EAAE,EACxB,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,YAAsB,EAAE,EACxB,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAE7C,uBAAuB;IACvB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,GAAG,CAC1B,OAAO,EACP,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,EAClC,GAAG,CACJ,CAAC;IAEF,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,oBAAoB;IACpB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAE/C,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,GAAG,CACvB,OAAO,EACP,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,EACrD,GAAG,CACJ,CAAC;IAEF,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,qBAAqB,CAAC,CAAC;IAEvF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/cli/create.d.ts

@@ -0,0 +1,35 @@
+import type { DeployTarget } from './templates.js';
+export { DEPLOY_TARGETS, TARGET_LABELS, type DeployTarget } from './templates.js';
+export declare class JuiceCreateError extends Error {
+    name: string;
+}
+/**
+ * Prompts the user to select a deployment target.
+ * Zero dependencies — raw readline.
+ */
+export declare function promptTarget(): Promise<DeployTarget>;
+export interface CreateAppOptions {
+    /** Working directory to create the project in. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Deployment target. Defaults to `'bun'`. */
+    target?: DeployTarget;
+}
+export interface CreateAppResult {
+    /** Absolute path to the created directory. */
+    dir: string;
+    /** List of files created (relative to dir). */
+    files: string[];
+    /** Selected deployment target. */
+    target: DeployTarget;
+}
+/**
+ * Creates a new Juice app.
+ *
+ * ```ts
+ * import { createApp } from '@cmj/juice/create';
+ * const result = createApp('my-app', { target: 'bun' });
+ * // → result.files = ['package.json', 'tsconfig.json', ...]
+ * ```
+ */
+export declare function createApp(name: string, options?: CreateAppOptions): CreateAppResult;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAUlF,qBAAa,gBAAiB,SAAQ,KAAK;IAChC,IAAI,SAAsB;CACpC;AAkBD;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CA0C1D;AAID,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAmCjB"}

package/dist/cli/create.js

@@ -0,0 +1,108 @@
+// ─────────────────────────────────────────────────────────────────
+// @cmj/juice — CLI Scaffolder
+// Creates a new Juice app directory with 5 minimal, typed files.
+// Zero external dependencies — Node.js fs/path only.
+// ─────────────────────────────────────────────────────────────────
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { createInterface } from 'node:readline';
+import { packageJson, tsconfig, viteConfig, serverEntry, homeRoute, DEPLOY_TARGETS, TARGET_LABELS, } from './templates.js';
+export { DEPLOY_TARGETS, TARGET_LABELS } from './templates.js';
+// ── Validation ──────────────────────────────────────────────────
+/**
+ * Valid npm package name: lowercase, may include hyphens, dots,
+ * underscores, and scoped prefixes. No spaces, no uppercase.
+ */
+const VALID_NAME = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+export class JuiceCreateError extends Error {
+    name = 'JuiceCreateError';
+}
+function validateName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new JuiceCreateError('Project name is required.\n\n  Usage: npx juice create <name>\n');
+    }
+    if (!VALID_NAME.test(name)) {
+        throw new JuiceCreateError(`Invalid project name "${name}".\n` +
+            '  Use lowercase letters, hyphens, and dots (e.g. my-app).\n');
+    }
+}
+// ── Interactive prompt ──────────────────────────────────────────
+/**
+ * Prompts the user to select a deployment target.
+ * Zero dependencies — raw readline.
+ */
+export async function promptTarget() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log('\n  🧃 Where are you deploying?\n');
+    for (let i = 0; i < DEPLOY_TARGETS.length; i++) {
+        const target = DEPLOY_TARGETS[i];
+        const marker = i === 0 ? '●' : '○';
+        const label = TARGET_LABELS[target];
+        const suffix = i === 0 ? ' (default)' : '';
+        console.log(`     ${marker} ${i + 1}. ${label}${suffix}`);
+    }
+    console.log();
+    return new Promise((resolve) => {
+        rl.question('  Enter 1–4 (or press Enter for Bun): ', (answer) => {
+            rl.close();
+            const trimmed = answer.trim();
+            if (!trimmed) {
+                resolve('bun');
+                return;
+            }
+            const index = parseInt(trimmed, 10) - 1;
+            if (index >= 0 && index < DEPLOY_TARGETS.length) {
+                resolve(DEPLOY_TARGETS[index]);
+                return;
+            }
+            // Try matching by name
+            const lower = trimmed.toLowerCase();
+            const match = DEPLOY_TARGETS.find((t) => t === lower);
+            if (match) {
+                resolve(match);
+                return;
+            }
+            // Default to bun on invalid input
+            console.log(`  Unknown target "${trimmed}", using Bun.\n`);
+            resolve('bun');
+        });
+    });
+}
+/**
+ * Creates a new Juice app.
+ *
+ * ```ts
+ * import { createApp } from '@cmj/juice/create';
+ * const result = createApp('my-app', { target: 'bun' });
+ * // → result.files = ['package.json', 'tsconfig.json', ...]
+ * ```
+ */
+export function createApp(name, options) {
+    validateName(name);
+    const cwd = options?.cwd ?? process.cwd();
+    const target = options?.target ?? 'bun';
+    const dir = resolve(cwd, name);
+    if (existsSync(dir)) {
+        throw new JuiceCreateError(`Directory "${name}" already exists.\n` +
+            '  Choose a different name or remove the existing directory.\n');
+    }
+    // Create directory structure
+    mkdirSync(join(dir, 'app', 'routes'), { recursive: true });
+    // Write files
+    const files = [
+        ['package.json', packageJson({ name, target })],
+        ['tsconfig.json', tsconfig()],
+        ['vite.config.ts', viteConfig()],
+        ['server.ts', serverEntry(target)],
+        ['app/routes/home.tsx', homeRoute()],
+    ];
+    for (const [path, content] of files) {
+        writeFileSync(join(dir, path), content, 'utf-8');
+    }
+    return {
+        dir,
+        files: files.map(([path]) => path),
+        target,
+    };
+}
+//# sourceMappingURL=create.js.map

package/dist/cli/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// ─────────────────────────────────────────────────────────────────
+// @cmj/juice — CLI Entry Point
+// Usage:
+//   juice create <name> [--target bun|node|cloudflare|deno]
+//   juice dev [--port N] [--host]
+//   juice build
+// ─────────────────────────────────────────────────────────────────
+import { createApp, promptTarget, JuiceCreateError, TARGET_LABELS, DEPLOY_TARGETS } from './create.js';
+import { runDev, runBuild } from './commands.js';
+const args = process.argv.slice(2);
+const command = args[0];
+/**
+ * Parse `--target <value>` from args.
+ * Returns undefined if not provided (will prompt interactively).
+ */
+function parseTarget(argv) {
+    const idx = argv.indexOf('--target');
+    if (idx === -1)
+        return undefined;
+    const value = argv[idx + 1]?.toLowerCase();
+    if (!value || !DEPLOY_TARGETS.includes(value)) {
+        console.error(`\n  🧃 Invalid target "${value ?? '(empty)'}".` +
+            `\n  Valid targets: ${DEPLOY_TARGETS.join(', ')}\n`);
+        process.exit(1);
+    }
+    return value;
+}
+// ── Command: create ─────────────────────────────────────────────
+if (command === 'create') {
+    // Filter out --target and its value to find the project name
+    const positional = args.slice(1).filter((a, i, arr) => a !== '--target' && arr[i - 1] !== '--target');
+    const name = positional[0];
+    if (!name) {
+        console.error('\n  🧃 Project name is required.\n\n  Usage: npx juice create <name>\n');
+        process.exit(1);
+    }
+    try {
+        // Use --target flag if provided, otherwise prompt interactively
+        const flagTarget = parseTarget(args);
+        const target = flagTarget ?? await promptTarget();
+        const result = createApp(name, { target });
+        console.log(`\n  🧃 Created ${result.files.length} files in ./${name}/ (${TARGET_LABELS[result.target]})\n`);
+        for (const file of result.files) {
+            console.log(`     ${file}`);
+        }
+        const install = result.target === 'bun' ? 'bun install' : 'npm install';
+        const dev = result.target === 'bun' ? 'bun run dev' : 'npm run dev';
+        console.log(`\n  Next steps:\n`);
+        console.log(`     cd ${name}`);
+        console.log(`     ${install}`);
+        console.log(`     ${dev}\n`);
+    }
+    catch (error) {
+        if (error instanceof JuiceCreateError) {
+            console.error(`\n  🧃 ${error.message}`);
+            process.exit(1);
+        }
+        throw error;
+    }
+    // ── Command: dev ──────────────────────────────────────────────
+}
+else if (command === 'dev') {
+    const extraArgs = args.slice(1);
+    const code = await runDev(extraArgs);
+    process.exit(code);
+    // ── Command: build ────────────────────────────────────────────
+}
+else if (command === 'build') {
+    const extraArgs = args.slice(1);
+    const code = await runBuild(extraArgs);
+    process.exit(code);
+    // ── Help / unknown ────────────────────────────────────────────
+}
+else {
+    console.log(`
+  🧃 Juice CLI
+
+  Commands:
+    juice create <name>              Scaffold a new Juice app
+    juice create <name> --target T   Skip prompt (T: bun|node|cloudflare|deno)
+    juice dev [vite-args...]         Start the dev server
+    juice build [vite-args...]       Build for production (client + SSR)
+
+  Examples:
+    npx juice create my-app
+    npx juice create my-app --target cloudflare
+    juice dev
+    juice dev --port 4000
+    juice build
+`);
+    if (command && command !== '--help' && command !== '-h') {
+        console.error(`  Unknown command: "${command}"\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/templates.d.ts

@@ -0,0 +1,14 @@
+export type DeployTarget = 'bun' | 'node' | 'cloudflare' | 'deno';
+export declare const DEPLOY_TARGETS: readonly DeployTarget[];
+export declare const TARGET_LABELS: Record<DeployTarget, string>;
+interface TemplateContext {
+    name: string;
+    target: DeployTarget;
+}
+export declare function packageJson({ name, target }: TemplateContext): string;
+export declare function tsconfig(): string;
+export declare function viteConfig(): string;
+export declare function serverEntry(target: DeployTarget): string;
+export declare function homeRoute(): string;
+export {};
+//# sourceMappingURL=templates.d.ts.map

package/dist/cli/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/cli/templates.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC;AAElE,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAmD,CAAC;AAEtG,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKtD,CAAC;AAEF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,MAAM,CAqCrE;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAiBjC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AA8DD,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAExD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAmBlC"}