create-fuzor 0.4.0 → 0.5.3

package/dist/create.d.ts

@@ -0,0 +1,20 @@
+export declare function createApp(directory: string | undefined, options?: {
+    yes?: boolean;
+    install?: boolean;
+}): Promise<string>;
+export declare const createCommand: import("citty").CommandDef<{
+    readonly directory: {
+        readonly type: "positional";
+        readonly description: "Directory for the new app";
+        readonly required: false;
+    };
+    readonly yes: {
+        readonly type: "boolean";
+        readonly description: "Use defaults without prompting";
+    };
+    readonly install: {
+        readonly type: "boolean";
+        readonly description: "Install dependencies with pnpm";
+    };
+}>;
+export declare function runCreateCli(): void;

package/dist/create.js

@@ -0,0 +1,109 @@
+import { spawn } from "node:child_process";
+import { cp, mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { defineCommand, runMain } from "citty";
+import * as prompts from "@clack/prompts";
+import colors from "picocolors";
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const templateRoot = path.join(packageRoot, "templates/basic");
+async function available(directory) {
+    try {
+        return (await readdir(directory)).length === 0;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return true;
+        throw error;
+    }
+}
+async function installDependencies(directory) {
+    await new Promise((resolve, reject) => {
+        const child = spawn(process.platform === "win32" ? "pnpm.cmd" : "pnpm", ["install"], { cwd: directory, stdio: "inherit" });
+        child.once("error", reject);
+        child.once("exit", (code) => code === 0 ? resolve() : reject(new Error(`pnpm install exited with ${code}`)));
+    });
+}
+export async function createApp(directory, options = {}) {
+    prompts.intro(colors.cyan(colors.bold("◉ Create Fuzor")));
+    let selected = directory;
+    if (!selected) {
+        if (options.yes)
+            selected = "fuzor-app";
+        else if (!process.stdin.isTTY)
+            throw new Error("Pass a directory or --yes in a non-interactive terminal.");
+        else {
+            const answer = await prompts.text({ message: "Where should we create your app?", placeholder: "my-fuzor-app", defaultValue: "my-fuzor-app" });
+            if (typeof answer !== "string") {
+                prompts.cancel("Creation cancelled.");
+                return "";
+            }
+            selected = answer.trim();
+        }
+    }
+    if (!selected)
+        throw new Error("App directory cannot be empty.");
+    const destination = path.resolve(selected);
+    if (!(await available(destination)))
+        throw new Error(`${destination} is not empty. Choose another directory.`);
+    const name = path.basename(destination).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "") || "fuzor-app";
+    const creatorPackage = JSON.parse(await readFile(path.join(packageRoot, "package.json"), "utf8"));
+    const dependency = `^${creatorPackage.version}`;
+    const spin = process.stdout.isTTY ? prompts.spinner() : undefined;
+    if (spin)
+        spin.start("Creating your app");
+    else
+        console.log("Creating your app...");
+    try {
+        await mkdir(destination, { recursive: true });
+        await cp(templateRoot, destination, { recursive: true });
+        await rename(path.join(destination, "_gitignore"), path.join(destination, ".gitignore"));
+        const packageFile = path.join(destination, "package.json");
+        const contents = (await readFile(packageFile, "utf8"))
+            .replaceAll("__APP_NAME__", name)
+            .replaceAll("__FUZOR_VERSION__", dependency);
+        await writeFile(packageFile, contents);
+        const readmeFile = path.join(destination, "README.md");
+        await writeFile(readmeFile, (await readFile(readmeFile, "utf8")).replaceAll("__APP_NAME__", name));
+        if (spin)
+            spin.stop(`Created ${colors.cyan(name)}`);
+        else
+            console.log(`Created ${name}`);
+    }
+    catch (error) {
+        if (spin)
+            spin.stop("Could not create app");
+        throw error;
+    }
+    let installed = false;
+    if (options.install) {
+        prompts.log.info("Installing dependencies with pnpm");
+        await installDependencies(destination);
+        installed = true;
+    }
+    else if (!options.yes && process.stdin.isTTY) {
+        const answer = await prompts.confirm({ message: "Install dependencies now?", initialValue: true });
+        if (prompts.isCancel(answer))
+            prompts.cancel("Dependency installation skipped.");
+        else if (answer) {
+            await installDependencies(destination);
+            installed = true;
+        }
+    }
+    prompts.note(`cd ${path.relative(process.cwd(), destination) || "."}\n${installed ? "" : "pnpm install\n"}pnpm dev`, "Next steps");
+    prompts.outro(colors.green("Ready to build with Fuzor"));
+    return destination;
+}
+export const createCommand = defineCommand({
+    meta: { name: "create", description: "Scaffold a new Fuzor app" },
+    args: {
+        directory: { type: "positional", description: "Directory for the new app", required: false },
+        yes: { type: "boolean", description: "Use defaults without prompting" },
+        install: { type: "boolean", description: "Install dependencies with pnpm" }
+    },
+    async run({ args }) { await createApp(args.directory, { yes: args.yes ?? false, install: args.install ?? false }); }
+});
+export function runCreateCli() {
+    void runMain({ ...createCommand, meta: { name: "create-fuzor", description: "Scaffold a new Fuzor app" } });
+}
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

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

package/index.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { runCreateCli } from "fuzor/create";
+import { runCreateCli } from "./dist/create.js";
 
 runCreateCli();

package/package.json

@@ -1,22 +1,26 @@
 {
   "name": "create-fuzor",
-  "version": "0.4.0",
+  "version": "0.5.3",
   "type": "module",
   "description": "Create a Fuzor app from the official starter",
   "license": "MIT",
   "homepage": "https://fuzor.dev",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ivanjeremic/fuzor.git",
-    "directory": "packages/create-fuzor"
+  "repository": { "type": "git", "url": "git+https://github.com/ivanjeremic/fuzor.git", "directory": "packages/create-fuzor" },
+  "bin": { "create-fuzor": "./index.mjs" },
+  "files": ["index.mjs", "dist", "templates/basic"],
+  "scripts": {
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.json",
+    "prepack": "pnpm build",
+    "typecheck": "tsc --noEmit"
   },
-  "bin": {
-    "create-fuzor": "./index.mjs"
-  },
-  "files": [
-    "index.mjs"
-  ],
   "dependencies": {
-    "fuzor": "0.4.0"
-  }
-}
+    "@clack/prompts": "^1.8.0",
+    "citty": "^0.2.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3"
+  },
+  "engines": { "node": "^22.15.0 || >=24.0.0" }
+}

package/templates/basic/README.md

@@ -0,0 +1,26 @@
+# __APP_NAME__
+
+A [Fuzor](https://fuzor.dev) app. Every page in `pages/` is compiled to finished HTML at build time; choose SPA or MPA navigation and static or server delivery when you build.
+
+```bash
+pnpm dev                  # SPA development server
+pnpm dev:mpa              # MPA development server
+pnpm dev:electron         # prompts to install Electron, then starts Vite HMR + Electron host
+pnpm build:spa            # .fuzor/web/dist-spa/: one document, lazy native behavior chunks
+pnpm build:spa --inline   # .fuzor/web/dist-spa/index.html with everything inlined
+pnpm build:mpa            # .fuzor/web/dist-mpa/: one HTML file per page
+pnpm build:electron       # .fuzor/dist-desktop/: inline SPA + Electron host/preload
+pnpm build:mpa:server     # .fuzor/dist-backend/: the same pages plus a Node server
+pnpm preview:mpa          # serve a finished build locally
+pnpm start:mpa:server     # run the server build with server.mjs
+```
+
+| Path | Purpose |
+| --- | --- |
+| `pages/` | Routes: `index.html` or `index.md` per folder, plus `layout.html` |
+| `components/` | Build-time HTML components such as `<app-badge>` |
+| `client/` | JS/TS modules referenced by HTML module scripts |
+| `index.html` | The document shell with the Fuzor outlet |
+| `server.mjs` | A Node server for server builds |
+
+The counter uses native `fuzor.state` and a lazy named `fuzor.action`; its initial value is prerendered. Adding an `api/` folder, a `server.ts` next to a page, or an HTML server-script request loader/action selects backend output automatically. Build-only server props remain static. See the [documentation](https://fuzor.dev/docs/).

package/templates/basic/_gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.env*.local
+.fuzor/

package/templates/basic/client/context.d.ts

@@ -0,0 +1,3 @@
+declare const host: HTMLElement
+declare const signal: AbortSignal
+declare function onCleanup(cleanup: () => void | Promise<void>): void

package/templates/basic/client/counter.ts

@@ -0,0 +1,3 @@
+import { fuzor } from "fuzor"
+const count = fuzor.state("count", 0)
+fuzor.action("increment", () => count.update(value => value + 1))

package/templates/basic/components/app-badge.html

@@ -0,0 +1 @@
+<span class="badge">Your Fuzor app is ready</span>

package/templates/basic/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Fuzor app</title>
+    <link rel="stylesheet" href="/style.css" />
+  </head>
+  <body>
+    <!--fuzor:outlet-start--><!--fuzor:outlet-end-->
+  </body>
+</html>

package/templates/basic/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "__APP_NAME__",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.33.0",
+  "scripts": {
+    "dev": "fuzor dev",
+    "dev:spa": "fuzor dev --target spa",
+    "dev:mpa": "fuzor dev --target mpa",
+    "dev:spa:server": "fuzor dev --target spa --server",
+    "dev:mpa:server": "fuzor dev --target mpa --server",
+    "dev:electron": "fuzor dev --target electron",
+    "build": "fuzor build",
+    "build:spa": "fuzor build --target spa",
+    "build:mpa": "fuzor build --target mpa",
+    "build:spa:server": "fuzor build --target spa --server",
+    "build:mpa:server": "fuzor build --target mpa --server",
+    "build:electron": "fuzor build --target electron",
+    "preview": "fuzor preview --target mpa",
+    "preview:spa": "fuzor preview --target spa",
+    "preview:mpa": "fuzor preview --target mpa",
+    "preview:spa:server": "fuzor preview --target spa --server",
+    "preview:mpa:server": "fuzor preview --target mpa --server",
+    "start:spa:server": "node server.mjs spa",
+    "start:mpa:server": "node server.mjs mpa",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": { "fuzor": "__FUZOR_VERSION__" },
+  "devDependencies": { "typescript": "^6.0.3", "vite": "^6.4.3", "@types/node": "^25.9.1" },
+  "engines": { "node": "^22.15.0 || >=24.0.0" }
+}

package/templates/basic/pages/about/index.html

@@ -0,0 +1,5 @@
+<section class="hero">
+  <p class="eyebrow">A second route</p>
+  <h1>About this app</h1>
+  <p>The router, compiler, and native DOM behavior come from Fuzor. Change your build target without changing these page files.</p>
+</section>

package/templates/basic/pages/docs/index.md

@@ -0,0 +1,25 @@
+---
+title: Markdown page
+description: A Markdown route with a component and a native behavior.
+---
+
+# Your Markdown route
+
+This page is Markdown. Fuzor compiles it to HTML before the browser requests it.
+
+- `pages/` defines routes.
+- `pages/layout.html` wraps them.
+- `behaviors/` holds native DOM behavior.
+
+Components and native behaviors work in Markdown when they are on their own line:
+
+<app-badge></app-badge>
+
+<section><button type="button" class="counter">Count: 0</button><script type="module" src="/client/counter.ts"></script></section>
+
+```ts
+// behaviors/counter.ts runs only where a native behavior uses it.
+export function mount(host: HTMLElement) {}
+```
+
+[Return home](/)

package/templates/basic/pages/index.html

@@ -0,0 +1,9 @@
+<section class="hero">
+  <p class="eyebrow">HTML first · SPA or MPA · Static or server</p>
+  <app-badge></app-badge>
+  <h1>Build once. Choose how to ship.</h1>
+  <p>Edit <code>pages/index.html</code> and build the same app as SPA or MPA, with static or server delivery.</p>
+  <section><script type="module" src="/client/counter.ts"></script><button type="button" class="counter" data-fz-click="increment">Count: <fz-state name="count"></fz-state></button></section>
+  <p class="hint">The initial count is prerendered. Its native action loads on interaction.</p>
+  <fuzor-link href="/docs/" class="link">Explore the Markdown page →</fuzor-link>
+</section>

package/templates/basic/pages/layout.html

@@ -0,0 +1,8 @@
+<div class="shell">
+  <header class="header">
+    <a href="/" class="brand">◉ Fuzor</a>
+    <nav><fuzor-link href="/">Home</fuzor-link><fuzor-link href="/about/">About</fuzor-link><fuzor-link href="/docs/">Docs</fuzor-link></nav>
+  </header>
+  <main><slot></slot></main>
+  <footer>One app. SPA or MPA. Static or server.</footer>
+</div>

package/templates/basic/pnpm-workspace.yaml

@@ -0,0 +1,5 @@
+packages:
+  - .
+
+onlyBuiltDependencies:
+  - esbuild

package/templates/basic/server.mjs

@@ -0,0 +1,14 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createNodeServer, handleShutdownSignals } from "fuzor/server/node";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const target = process.argv[2] ?? "mpa";
+if (!["spa", "mpa"].includes(target)) throw new Error(`Unknown server target: ${target}. Choose spa or mpa.`);
+const directory = `.fuzor/web/dist-${target}`;
+const { handler, manifest } = await import("./.fuzor/dist-backend/entry.mjs");
+const host = process.env.HOST ?? "127.0.0.1";
+const port = Number(process.env.PORT ?? 4173);
+const server = createNodeServer({ handler, base: manifest.base, assetsDir: path.join(here, directory) });
+handleShutdownSignals(server);
+server.listen(port, host, () => console.log(`Fuzor ${target.toUpperCase()} server listening on http://${host}:${port}`));

package/templates/basic/style.css

@@ -0,0 +1 @@
+:root{font-family:Inter,ui-sans-serif,system-ui,sans-serif;color:#e9efff;background:#0d1220;font-synthesis:none}*{box-sizing:border-box}body{margin:0}.shell{min-height:100vh;display:flex;flex-direction:column}.header{display:flex;align-items:center;justify-content:space-between;padding:1.5rem max(5vw,1.5rem);border-bottom:1px solid #263044}.brand{color:#8bd8c7;font-weight:800;text-decoration:none;letter-spacing:-.04em}nav{display:flex;gap:1.25rem}nav a,.link{color:#b7c5e1;text-decoration:none}nav a:hover,.link:hover{color:#8bd8c7}main{width:min(880px,90vw);margin:0 auto;flex:1;padding:7vw 0}.hero{max-width:680px}.eyebrow{text-transform:uppercase;letter-spacing:.18em;color:#8bd8c7;font-size:.72rem;font-weight:700}.badge{display:inline-block;padding:.35rem .65rem;border:1px solid #316456;border-radius:999px;color:#8bd8c7;font-size:.78rem}h1{font-size:clamp(2.6rem,7vw,5rem);line-height:1.05;letter-spacing:-.065em;margin:.5rem 0 1.5rem}p,li{line-height:1.7;color:#bac6dc}code{color:#8bd8c7}.counter{background:#8bd8c7;color:#10221f;border:0;border-radius:999px;padding:.85rem 1.25rem;font:inherit;font-weight:700;cursor:pointer}.hint{font-size:.86rem}.link{display:inline-block;margin-top:1.5rem}footer{padding:1.5rem max(5vw,1.5rem);border-top:1px solid #263044;color:#71819e;font-size:.8rem}

package/templates/basic/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "types": [
+      "vite/client"
+    ],
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": [
+    "vite.config.ts",
+    ".fuzor/*.d.ts",
+    "client/**/*.ts"
+  ]
+}

package/templates/basic/vite.config.ts

@@ -0,0 +1,4 @@
+import { defineConfig } from "vite";
+import { fuzorPlugin } from "fuzor/vite";
+
+export default defineConfig({ plugins: [fuzorPlugin()] });