create-frootjs 0.0.0-stage → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrbitNorth LLC
+
+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

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# create-frootjs
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The official CLI project generator for Froot applications.
+
+Quickly spin up production-ready Froot projects with your choice of architectural patterns, complete with TypeScript configuration, onion middleware, and developer tooling.
+
+## Quick Start
+
+Run any of the following commands in your terminal:
+
+```bash
+# Using npm
+npm create frootjs@latest
+
+# Using pnpm
+pnpm create frootjs
+
+# Using yarn
+yarn create frootjs
+
+# Using bun
+bun create frootjs
+```
+
+Or invoke the binary directly:
+
+```bash
+npx create-frootjs my-app
+```
+
+## Available Architectural Templates
+
+| Template | Flag | Description |
+| :--- | :--- | :--- |
+| **MVC / Layered** | `--template mvc` | Enterprise layered pattern: routes, controllers, services, models, and middleware |
+| **Modular (NestJS-style)** | `--template modular` | Feature-based domain modules (`src/modules/*`), auth guard, and error filters |
+| **Streaming & SSE** | `--template streaming` | Server-Sent Events metrics, AI token streaming simulation, and HTML live client |
+| **WebSocket Hub** | `--template websocket` | Cross-runtime WebSockets, pub/sub rooms hub, and interactive chat client |
+| **OpenAPI 3.1 & Docs** | `--template openapi` | Auto-generated OpenAPI 3.1 JSON and Scalar interactive reference UI at `/docs` |
+| **Fullstack JSX & SSR** | `--template fullstack` | Native JSX components, typed layout middleware, and zero-JS server rendering |
+| **Minimal Starter** | `--template minimal` | Lean single-file API starter with JSON endpoints and CORS |
+
+## CLI Options
+
+```
+Usage:
+  npx create-frootjs [project-directory] [options]
+
+Options:
+  -t, --template <name>    Template architecture (mvc, modular, streaming, websocket, openapi, fullstack, minimal)
+  --pm <manager>           Package manager to use: pnpm | npm | yarn | bun
+  --git / --no-git         Initialize a git repository
+  --install / --no-install Automatically install project dependencies
+  -y, --yes                Accept all defaults non-interactively
+  -v, --version            Display CLI version
+  -h, --help               Display help information
+```
+
+### Non-Interactive Automation Example
+
+For CI/CD or scripted setups:
+
+```bash
+npx create-frootjs my-api --template modular --pm pnpm --git --install
+```
+
+## License
+
+MIT (c) OrbitNorth LLC

package/dist/generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Project Scaffolding Engine
+ * Writes template files to disk, initializes git, and executes dependency installation.
+ */
+import { TemplateDefinition } from './templates/index.js';
+export interface ScaffoldOptions {
+    targetDir: string;
+    projectName: string;
+    template: TemplateDefinition;
+    pkgManager: 'pnpm' | 'npm' | 'yarn' | 'bun';
+    gitInit: boolean;
+    installDeps: boolean;
+}
+export interface ScaffoldResult {
+    targetDir: string;
+    filesWritten: number;
+    gitInitialized: boolean;
+    depsInstalled: boolean;
+}
+export declare function scaffoldProject(options: ScaffoldOptions): Promise<ScaffoldResult>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK1D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAuDvF"}

package/dist/generator.js

@@ -0,0 +1,62 @@
+/**
+ * Project Scaffolding Engine
+ * Writes template files to disk, initializes git, and executes dependency installation.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { c, printSuccess, printInfo, printWarning } from './ui.js';
+const execAsync = promisify(exec);
+export async function scaffoldProject(options) {
+    const { targetDir, projectName, template, pkgManager, gitInit, installDeps } = options;
+    // 1. Ensure target directory exists
+    await fs.mkdir(targetDir, { recursive: true });
+    // 2. Generate files map from template
+    const files = template.generate(projectName);
+    const fileKeys = Object.keys(files);
+    // 3. Write each file to destination
+    for (const relativePath of fileKeys) {
+        const filePath = path.join(targetDir, relativePath);
+        const dir = path.dirname(filePath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(filePath, files[relativePath], 'utf8');
+    }
+    printSuccess(`Created ${c.bold}${fileKeys.length}${c.reset} files from template ${c.emerald}${template.name}${c.reset}`);
+    // 4. Git initialization
+    let gitInitialized = false;
+    if (gitInit) {
+        try {
+            await execAsync('git init', { cwd: targetDir });
+            gitInitialized = true;
+            printSuccess(`Initialized git repository`);
+        }
+        catch {
+            printWarning(`Could not initialize git repository (is git installed?)`);
+        }
+    }
+    // 5. Dependency installation
+    let depsInstalled = false;
+    if (installDeps) {
+        printInfo(`Installing dependencies using ${c.bold}${pkgManager}${c.reset}...`);
+        try {
+            // Use .cmd extension on Windows when running npm/pnpm/yarn
+            const isWin = process.platform === 'win32';
+            const cmd = isWin && pkgManager !== 'bun' ? `${pkgManager}.cmd` : pkgManager;
+            await execAsync(`${cmd} install`, { cwd: targetDir });
+            depsInstalled = true;
+            printSuccess(`Dependencies installed successfully`);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            printWarning(`Dependency installation skipped or failed: ${errMsg}`);
+        }
+    }
+    return {
+        targetDir,
+        filesWritten: fileKeys.length,
+        gitInitialized,
+        depsInstalled,
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * create-frootjs CLI Project Generator
+ * Interactive, zero-dependency CLI tool for scaffolding modern Froot web applications.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+/**
+ * create-frootjs CLI Project Generator
+ * Interactive, zero-dependency CLI tool for scaffolding modern Froot web applications.
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { printBanner, printStep, printError, printNextSteps, promptText, promptSelect, promptConfirm, c, } from './ui.js';
+import { TEMPLATES, TEMPLATE_LIST, getTemplate } from './templates/index.js';
+import { scaffoldProject } from './generator.js';
+const VERSION = '1.0.2';
+function parseCliArgs(argv) {
+    const args = {};
+    const raw = argv.slice(2);
+    for (let i = 0; i < raw.length; i++) {
+        const item = raw[i];
+        if (item === '--help' || item === '-h') {
+            args.help = true;
+        }
+        else if (item === '--version' || item === '-v') {
+            args.version = true;
+        }
+        else if (item === '--yes' || item === '-y') {
+            args.yes = true;
+        }
+        else if (item === '--git') {
+            args.git = true;
+        }
+        else if (item === '--no-git') {
+            args.git = false;
+        }
+        else if (item === '--install') {
+            args.install = true;
+        }
+        else if (item === '--no-install') {
+            args.install = false;
+        }
+        else if (item === '--template' || item === '-t') {
+            args.template = raw[++i];
+        }
+        else if (item.startsWith('--template=')) {
+            args.template = item.split('=')[1];
+        }
+        else if (item === '--pm') {
+            args.pkgManager = raw[++i];
+        }
+        else if (item.startsWith('--pm=')) {
+            args.pkgManager = item.split('=')[1];
+        }
+        else if (!item.startsWith('-') && !args.targetDir) {
+            args.targetDir = item;
+        }
+    }
+    return args;
+}
+function printUsage() {
+    console.log(`
+  ${c.bold}Usage:${c.reset}
+    npm create frootjs [project-directory] [options]
+    npx create-frootjs [project-directory] [options]
+
+  ${c.bold}Options:${c.reset}
+    -t, --template <name>    Template architecture:
+                             • mvc          MVC / Layered Architecture
+                             • modular      Modular Architecture (NestJS-style)
+                             • streaming    Real-Time Streaming & SSE
+                             • websocket    WebSocket & Real-Time Pub/Sub
+                             • openapi      OpenAPI 3.1 & Interactive Docs
+                             • fullstack    Fullstack JSX & SSR
+                             • minimal      Minimal Starter (Single-file)
+    --pm <manager>           Package manager: pnpm | npm | yarn | bun
+    --git / --no-git         Initialize a git repository
+    --install / --no-install Automatically install dependencies
+    -y, --yes                Accept all defaults non-interactively
+    -v, --version            Display version
+    -h, --help               Display help information
+`);
+}
+/** Detect which package manager invoked create-frootjs */
+function detectCurrentPackageManager() {
+    const userAgent = process.env.npm_config_user_agent || '';
+    if (userAgent.startsWith('pnpm'))
+        return 'pnpm';
+    if (userAgent.startsWith('yarn'))
+        return 'yarn';
+    if (userAgent.startsWith('bun'))
+        return 'bun';
+    return 'npm';
+}
+async function main() {
+    const args = parseCliArgs(process.argv);
+    if (args.version) {
+        console.log(`create-frootjs v${VERSION}`);
+        return;
+    }
+    if (args.help) {
+        printBanner(VERSION);
+        printUsage();
+        return;
+    }
+    printBanner(VERSION);
+    // 1. Resolve Project Directory & Name
+    let targetDir = args.targetDir;
+    if (!targetDir) {
+        if (args.yes) {
+            targetDir = 'froot-app';
+        }
+        else {
+            printStep(1, 4, 'Project location');
+            targetDir = await promptText('Where would you like to create your project?', 'my-froot-app', (input) => {
+                if (!input.trim())
+                    return 'Project name cannot be empty';
+                return true;
+            });
+            console.log();
+        }
+    }
+    const resolvedTarget = path.resolve(process.cwd(), targetDir);
+    const projectName = path.basename(resolvedTarget);
+    // Verify if directory already exists with files
+    if (fs.existsSync(resolvedTarget)) {
+        const existingFiles = fs.readdirSync(resolvedTarget);
+        if (existingFiles.length > 0 && !args.yes) {
+            printStep(1, 4, 'Target directory warning');
+            const proceed = await promptConfirm(`Target directory "${targetDir}" is not empty. Continue anyway?`, false);
+            console.log();
+            if (!proceed) {
+                printError('Aborted by user.');
+                process.exit(1);
+            }
+        }
+    }
+    // 2. Select Template
+    let selectedTemplate = args.template ? getTemplate(args.template) : undefined;
+    if (args.template && !selectedTemplate) {
+        printError(`Unknown template "${args.template}".`);
+        console.log(`Available templates: ${Object.keys(TEMPLATES).join(', ')}`);
+        process.exit(1);
+    }
+    if (!selectedTemplate) {
+        if (args.yes) {
+            selectedTemplate = TEMPLATES['mvc'];
+        }
+        else {
+            printStep(2, 4, 'Choose architectural template');
+            const choice = await promptSelect('Select the project template that fits your architecture:', TEMPLATE_LIST.map((t) => ({
+                value: t.id,
+                label: t.name,
+                hint: t.description,
+            })));
+            selectedTemplate = getTemplate(choice);
+            console.log();
+        }
+    }
+    // 3. Package Manager Selection
+    const detectedPm = detectCurrentPackageManager();
+    let pkgManager = args.pkgManager || detectedPm;
+    if (!args.pkgManager && !args.yes) {
+        printStep(3, 4, 'Package manager');
+        pkgManager = await promptSelect('Which package manager do you want to use?', [
+            { value: 'pnpm', label: 'pnpm', hint: 'Fast, disk space efficient' },
+            { value: 'npm', label: 'npm', hint: 'Standard Node package manager' },
+            { value: 'yarn', label: 'yarn', hint: 'Classic or Modern Yarn' },
+            { value: 'bun', label: 'bun', hint: 'Ultra-fast all-in-one toolkit' },
+        ]);
+        console.log();
+    }
+    // 4. Git Initialization & Install Preferences
+    let gitInit = args.git;
+    let installDeps = args.install;
+    if (!args.yes) {
+        printStep(4, 4, 'Project setup preferences');
+        if (gitInit === undefined) {
+            gitInit = await promptConfirm('Initialize a new git repository?', true);
+        }
+        if (installDeps === undefined) {
+            installDeps = await promptConfirm(`Install dependencies now with ${pkgManager}?`, true);
+        }
+        console.log();
+    }
+    else {
+        if (gitInit === undefined)
+            gitInit = true;
+        if (installDeps === undefined)
+            installDeps = true;
+    }
+    // 5. Scaffold Project
+    try {
+        const result = await scaffoldProject({
+            targetDir: resolvedTarget,
+            projectName,
+            template: selectedTemplate,
+            pkgManager,
+            gitInit: Boolean(gitInit),
+            installDeps: Boolean(installDeps),
+        });
+        // 6. Print stylized next steps card
+        printNextSteps({
+            projectDir: targetDir,
+            pkgManager,
+            hasInstalled: result.depsInstalled,
+            port: 3000,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        printError(`Scaffolding failed: ${msg}`);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    printError(String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/templates/fullstack.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fullstack JSX & Server-Side Rendering (SSR) Template
+ * Native JSX components rendered on the server with zero client JavaScript overhead.
+ */
+import { TemplateDefinition } from './types.js';
+export declare const fullstackTemplate: TemplateDefinition;
+//# sourceMappingURL=fullstack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fullstack.d.ts","sourceRoot":"","sources":["../../src/templates/fullstack.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAsD,MAAM,YAAY,CAAC;AAEpG,eAAO,MAAM,iBAAiB,EAAE,kBAoO/B,CAAC"}

package/dist/templates/fullstack.js

@@ -0,0 +1,224 @@
+/**
+ * Fullstack JSX & Server-Side Rendering (SSR) Template
+ * Native JSX components rendered on the server with zero client JavaScript overhead.
+ */
+import { COMMON_GITIGNORE, COMMON_TSCONFIG } from './types.js';
+export const fullstackTemplate = {
+    id: 'fullstack',
+    name: 'Fullstack JSX & Server-Side Rendering',
+    description: 'Native JSX components, typed layouts, and zero-JS HTML server rendering',
+    generate: (projectName) => {
+        return {
+            'package.json': JSON.stringify({
+                name: projectName,
+                version: '1.0.0',
+                type: 'module',
+                scripts: {
+                    dev: 'node --experimental-strip-types src/server.tsx',
+                    build: 'tsc',
+                    start: 'node dist/server.js',
+                },
+                dependencies: {
+                    frootjs: '^1.0.1',
+                },
+                devDependencies: {
+                    '@types/node': '^22.10.0',
+                    typescript: '^5.8.0',
+                },
+            }, null, 2) + '\n',
+            'tsconfig.json': COMMON_TSCONFIG,
+            '.gitignore': COMMON_GITIGNORE,
+            'README.md': `# ${projectName}
+
+Froot application built with the **Fullstack JSX & Server-Side Rendering (SSR)** pattern.
+
+## Features
+
+- **Native JSX / TSX**: Pure server-rendered JSX without React runtime baggage
+- **Layout Middleware**: Automatic HTML wrapper layout with \`jsxRenderer()\`
+- **Zero Client JS**: Ultra-fast initial page loads and 100% SEO-friendly markup
+
+## Getting Started
+
+\`\`\`bash
+# 1. Install dependencies
+pnpm install
+
+# 2. Run in development mode
+pnpm run dev
+
+# 3. View in browser
+http://localhost:3000
+\`\`\`
+`,
+            'src/components/Layout.tsx': `import type { FC, PropsWithChildren } from 'frootjs/jsx';
+
+export interface LayoutProps {
+  title?: string;
+}
+
+export const Layout: FC<PropsWithChildren<LayoutProps>> = ({ title = 'Froot JSX App', children }) => {
+  return (
+    <html lang="en">
+      <head>
+        <meta charSet="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>{title}</title>
+        <style>{\`
+          * { box-sizing: border-box; margin: 0; padding: 0; }
+          body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; background: #0f172a; color: #f8fafc; line-height: 1.6; }
+          header { background: #1e293b; border-bottom: 1px solid #334155; padding: 1rem 2rem; display: flex; justify-content: space-between; align-items: center; }
+          .logo { font-size: 1.3rem; font-weight: bold; color: #10b981; text-decoration: none; }
+          nav a { color: #94a3b8; text-decoration: none; margin-left: 1.5rem; font-weight: 500; }
+          nav a:hover { color: #f8fafc; }
+          main { max-width: 900px; margin: 2rem auto; padding: 0 1.5rem; }
+          footer { text-align: center; padding: 2rem; color: #64748b; font-size: 0.9rem; border-top: 1px solid #1e293b; margin-top: 4rem; }
+        \`}</style>
+      </head>
+      <body>
+        <header>
+          <a href="/" className="logo">Froot JSX</a>
+          <nav>
+            <a href="/">Home</a>
+            <a href="/about">About</a>
+            <a href="/features">Features</a>
+          </nav>
+        </header>
+        <main>{children}</main>
+        <footer>
+          <p>Powered by Froot Server-Side Rendering Engine</p>
+        </footer>
+      </body>
+    </html>
+  );
+};
+`,
+            'src/components/Card.tsx': `import type { FC, PropsWithChildren } from 'frootjs/jsx';
+
+export interface CardProps {
+  title: string;
+  badge?: string;
+}
+
+export const Card: FC<PropsWithChildren<CardProps>> = ({ title, badge, children }) => {
+  return (
+    <div style={{
+      background: '#1e293b',
+      border: '1px solid #334155',
+      borderRadius: '8px',
+      padding: '1.5rem',
+      marginBottom: '1.25rem',
+    }}>
+      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: '0.75rem' }}>
+        <h3 style={{ color: '#38bdf8', fontSize: '1.2rem' }}>{title}</h3>
+        {badge ? (
+          <span style={{
+            background: '#064e3b',
+            color: '#34d399',
+            fontSize: '0.75rem',
+            padding: '0.2rem 0.6rem',
+            borderRadius: '9999px',
+            fontWeight: 600,
+          }}>
+            {badge}
+          </span>
+        ) : null}
+      </div>
+      <div>{children}</div>
+    </div>
+  );
+};
+`,
+            'src/pages/Home.tsx': `import type { FC } from 'frootjs/jsx';
+import { Card } from '../components/Card.js';
+
+export const HomePage: FC = () => {
+  return (
+    <div>
+      <div style={{ marginBottom: '2rem' }}>
+        <h1 style={{ fontSize: '2.25rem', color: '#10b981', marginBottom: '0.5rem' }}>
+          Server-Side Rendered JSX
+        </h1>
+        <p style={{ color: '#94a3b8', fontSize: '1.1rem' }}>
+          Blazing fast HTML generated on the server with TypeScript-native JSX components.
+        </p>
+      </div>
+
+      <Card title="Zero Client Runtime" badge="Performance">
+        <p>No heavy virtual DOM diffing in the browser. Pure, pre-rendered semantic HTML delivered instantly.</p>
+      </Card>
+
+      <Card title="Type-Safe Views" badge="DX">
+        <p>Full TypeScript compiler checking for props, children, styles, and HTML attributes.</p>
+      </Card>
+
+      <Card title="Streaming & Islands Ready" badge="Architecture">
+        <p>Seamlessly compose asynchronous server components and stream output as it becomes available.</p>
+      </Card>
+    </div>
+  );
+};
+`,
+            'src/pages/About.tsx': `import type { FC } from 'frootjs/jsx';
+
+export const AboutPage: FC = () => {
+  return (
+    <div style={{ background: '#1e293b', padding: '2rem', borderRadius: '8px', border: '1px solid #334155' }}>
+      <h1 style={{ color: '#10b981', marginBottom: '1rem' }}>About This Application</h1>
+      <p style={{ marginBottom: '1rem' }}>
+        This project showcases Froot's built-in JSX rendering pipeline. Unlike traditional React or Next.js setups,
+        Froot renders JSX straight to HTML strings without requiring React, ReactDOM, or a Node.js bundling step.
+      </p>
+      <p style={{ color: '#94a3b8' }}>
+        It achieves sub-millisecond page render times while maintaining full component composition.
+      </p>
+    </div>
+  );
+};
+`,
+            'src/server.tsx': `import { Froot } from 'frootjs';
+import { jsxRenderer } from 'frootjs/jsx';
+import { Layout } from './components/Layout.js';
+import { HomePage } from './pages/Home.js';
+import { AboutPage } from './pages/About.js';
+
+export const app = new Froot();
+
+// Wrap all HTML responses in the global Layout shell
+app.use('*', jsxRenderer(({ children }) => {
+  return <Layout>{children}</Layout>;
+}));
+
+// Route handlers
+app.get('/', (c) => {
+  return c.render(<HomePage />);
+});
+
+app.get('/about', (c) => {
+  return c.render(<AboutPage />);
+});
+
+app.get('/features', (c) => {
+  return c.render(
+    <div>
+      <h1 style={{ color: '#10b981', marginBottom: '1rem' }}>Framework Features</h1>
+      <ul style={{ paddingLeft: '1.5rem', color: '#cbd5e1' }}>
+        <li>RADIX tree router with O(K) lookup</li>
+        <li>Auto-generated OpenAPI 3.1 & Scalar docs</li>
+        <li>Native JSX & async component support</li>
+        <li>Full WebCrypto authentication ecosystem</li>
+        <li>Universal WebSockets & pub/sub hub</li>
+      </ul>
+    </div>
+  );
+});
+
+const PORT = Number(process.env.PORT) || 3000;
+app.listen(PORT, () => {
+  console.log(\`Fullstack JSX server running on http://localhost:\${PORT}\`);
+});
+`,
+        };
+    },
+};
+//# sourceMappingURL=fullstack.js.map

package/dist/templates/fullstack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullstack.js","sourceRoot":"","sources":["../../src/templates/fullstack.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAuC,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpG,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACnD,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EAAE,yEAAyE;IACtF,QAAQ,EAAE,CAAC,WAAmB,EAAmB,EAAE;QACjD,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,SAAS,CAC5B;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE;oBACP,GAAG,EAAE,gDAAgD;oBACrD,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,qBAAqB;iBAC7B;gBACD,YAAY,EAAE;oBACZ,OAAO,EAAE,QAAQ;iBAClB;gBACD,eAAe,EAAE;oBACf,aAAa,EAAE,UAAU;oBACzB,UAAU,EAAE,QAAQ;iBACrB;aACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI;YAER,eAAe,EAAE,eAAe;YAChC,YAAY,EAAE,gBAAgB;YAE9B,WAAW,EAAE,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;CAsBlC;YAEK,2BAA2B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyClC;YAEK,yBAAyB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmChC;YAEK,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B3B;YAEK,qBAAqB,EAAE;;;;;;;;;;;;;;;;CAgB5B;YAEK,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCvB;SACI,CAAC;IACJ,CAAC;CACF,CAAC"}