@pyreon/zero-cli 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Vit Bokisch
+
+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,33 @@
+# zero-cli
+
+CLI for [Pyreon Zero](https://github.com/user/pyreon-zero) — dev server, production builds, and preview.
+
+## Install
+
+```bash
+bun add -D zero-cli
+```
+
+## Commands
+
+```bash
+zero dev [root]      # Start development server
+zero build [root]    # Build for production
+zero preview [root]  # Preview production build
+```
+
+### Options
+
+```bash
+# dev / preview
+--port <port>    # Server port (default: 3000)
+--host [host]    # Server host
+--open           # Open browser on start
+
+# build
+--mode <mode>    # Rendering mode override (ssr, ssg, spa)
+```
+
+## License
+
+[MIT](LICENSE)

package/bin/zero.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../lib/index.js')

package/lib/index.js

@@ -0,0 +1,136 @@
+import cac from "cac";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { build, createServer, preview } from "vite";
+
+//#region src/commands/build.ts
+/** Extract zero plugin config from a Vite config file. */
+async function loadZeroConfig(configPath) {
+	try {
+		const { loadConfigFromFile } = await import("vite");
+		const loaded = await loadConfigFromFile({
+			command: "build",
+			mode: "production"
+		}, configPath);
+		if (!loaded) return void 0;
+		const zeroPlugin = (loaded.config.plugins ?? []).find((p) => p && typeof p === "object" && "name" in p && p.name === "pyreon-zero");
+		if (zeroPlugin && "_zeroConfig" in zeroPlugin) return zeroPlugin._zeroConfig;
+	} catch {}
+}
+/** Run SSG prerendering pass if configured. */
+async function prerenderIfNeeded(projectRoot, zeroConfig) {
+	const serverEntry = join(projectRoot, "dist/server/entry-server.js");
+	if (!existsSync(serverEntry)) return;
+	try {
+		const { prerender } = await import("@pyreon/server");
+		const serverModule = await import(serverEntry);
+		const paths = await resolveSsgPaths(zeroConfig);
+		const result = await prerender({
+			handler: serverModule.default,
+			paths,
+			outDir: join(projectRoot, "dist/client")
+		});
+		for (const err of result.errors) console.warn("Prerender error:", err);
+	} catch {}
+}
+/** Resolve SSG paths from config (static array or async function). */
+async function resolveSsgPaths(zeroConfig) {
+	const ssgConfig = zeroConfig?.ssg;
+	if (!ssgConfig?.paths) return ["/"];
+	return typeof ssgConfig.paths === "function" ? await ssgConfig.paths() : ssgConfig.paths;
+}
+/** Run the deploy adapter build step. */
+async function runAdapter(projectRoot, zeroConfig) {
+	try {
+		const { resolveAdapter } = await import("@pyreon/zero");
+		await resolveAdapter(zeroConfig).build({
+			serverEntry: join(projectRoot, "dist/server/entry-server.js"),
+			clientOutDir: join(projectRoot, "dist/client"),
+			outDir: join(projectRoot, "dist/output"),
+			config: zeroConfig
+		});
+	} catch {}
+}
+async function build$1(root, options) {
+	try {
+		await runBuild(root, options);
+	} catch (error) {
+		console.error("Build failed:", error.message);
+		process.exit(1);
+	}
+}
+async function runBuild(root, options) {
+	const projectRoot = resolve(root ?? ".");
+	const start = performance.now();
+	await build({
+		root: projectRoot,
+		build: {
+			outDir: "dist/client",
+			ssrManifest: true
+		}
+	});
+	await build({
+		root: projectRoot,
+		build: {
+			outDir: "dist/server",
+			ssr: "src/entry-server.ts",
+			rollupOptions: { input: "src/entry-server.ts" }
+		}
+	});
+	const zeroConfig = await loadZeroConfig(join(projectRoot, "vite.config.ts"));
+	const renderMode = zeroConfig?.mode ?? options.mode ?? "ssr";
+	if (renderMode === "ssg" || renderMode === "isr") await prerenderIfNeeded(projectRoot, zeroConfig);
+	if (!((zeroConfig?.adapter ?? "node") === "static" && renderMode === "ssg")) await runAdapter(projectRoot, zeroConfig ?? {});
+	const elapsed = Math.round(performance.now() - start);
+	console.log(`Build completed in ${elapsed}ms`);
+}
+
+//#endregion
+//#region src/commands/dev.ts
+async function dev(root, options) {
+	try {
+		const server = await createServer({
+			root: resolve(root ?? "."),
+			server: {
+				port: options.port ?? 3e3,
+				host: options.host === true ? "0.0.0.0" : options.host,
+				open: options.open
+			}
+		});
+		await server.listen();
+		server.printUrls();
+	} catch (error) {
+		console.error("Failed to start dev server:", error.message);
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region src/commands/preview.ts
+async function preview$1(root, options) {
+	try {
+		(await preview({
+			root: resolve(root ?? "."),
+			preview: {
+				port: options.port ?? 3e3,
+				host: options.host === true ? "0.0.0.0" : options.host
+			}
+		})).printUrls();
+	} catch (error) {
+		console.error("Failed to start preview server:", error.message);
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region src/index.ts
+const cli = cac("zero");
+cli.command("[root]", "Start dev server").alias("dev").option("--port <port>", "Server port", { default: 3e3 }).option("--host [host]", "Server host").option("--open", "Open browser on start").action(dev);
+cli.command("build [root]", "Build for production").option("--mode <mode>", "Rendering mode override").action(build$1);
+cli.command("preview [root]", "Preview production build").option("--port <port>", "Server port", { default: 3e3 }).option("--host [host]", "Server host").action(preview$1);
+cli.help();
+cli.version("0.0.1");
+cli.parse();
+
+//#endregion
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["build","viteBuild","preview","vitePreview","build","preview"],"sources":["../src/commands/build.ts","../src/commands/dev.ts","../src/commands/preview.ts","../src/index.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { build as viteBuild } from 'vite'\n\nexport interface BuildOptions {\n  mode?: string\n}\n\n/** Extract zero plugin config from a Vite config file. */\nasync function loadZeroConfig(\n  configPath: string,\n): Promise<Record<string, unknown> | undefined> {\n  try {\n    const { loadConfigFromFile } = await import('vite')\n    const loaded = await loadConfigFromFile(\n      { command: 'build', mode: 'production' },\n      configPath,\n    )\n    if (!loaded) return undefined\n\n    const plugins = (loaded.config.plugins ?? []) as Array<{\n      name?: string\n      _zeroConfig?: Record<string, unknown>\n    }>\n    const zeroPlugin = plugins.find(\n      (p) =>\n        p && typeof p === 'object' && 'name' in p && p.name === 'pyreon-zero',\n    )\n    if (zeroPlugin && '_zeroConfig' in zeroPlugin) {\n      return zeroPlugin._zeroConfig as Record<string, unknown>\n    }\n  } catch {\n    // Config loading is optional — fall back to defaults\n  }\n  return undefined\n}\n\n/** Run SSG prerendering pass if configured. */\nasync function prerenderIfNeeded(\n  projectRoot: string,\n  zeroConfig: Record<string, unknown> | undefined,\n) {\n  const serverEntry = join(projectRoot, 'dist/server/entry-server.js')\n  if (!existsSync(serverEntry)) return\n\n  try {\n    const { prerender } = await import('@pyreon/server')\n    const serverModule = await import(serverEntry)\n\n    const paths = await resolveSsgPaths(zeroConfig)\n    const result = await prerender({\n      handler: serverModule.default,\n      paths,\n      outDir: join(projectRoot, 'dist/client'),\n    })\n\n    for (const err of result.errors) {\n      console.warn('Prerender error:', err)\n    }\n  } catch {\n    // Prerender is best-effort — build continues without it\n  }\n}\n\n/** Resolve SSG paths from config (static array or async function). */\nasync function resolveSsgPaths(\n  zeroConfig: Record<string, unknown> | undefined,\n): Promise<string[]> {\n  const ssgConfig = zeroConfig?.ssg as\n    | { paths?: string[] | (() => string[] | Promise<string[]>) }\n    | undefined\n  if (!ssgConfig?.paths) return ['/']\n  return typeof ssgConfig.paths === 'function'\n    ? await ssgConfig.paths()\n    : ssgConfig.paths\n}\n\n/** Run the deploy adapter build step. */\nasync function runAdapter(\n  projectRoot: string,\n  zeroConfig: Record<string, unknown>,\n) {\n  try {\n    const { resolveAdapter } = await import('@pyreon/zero')\n    const adapter = resolveAdapter(zeroConfig)\n    await adapter.build({\n      serverEntry: join(projectRoot, 'dist/server/entry-server.js'),\n      clientOutDir: join(projectRoot, 'dist/client'),\n      outDir: join(projectRoot, 'dist/output'),\n      config: zeroConfig,\n    })\n  } catch {\n    // Adapter build is optional — output may not need it\n  }\n}\n\nexport async function build(root: string | undefined, options: BuildOptions) {\n  try {\n    await runBuild(root, options)\n  } catch (error) {\n    console.error('Build failed:', (error as Error).message)\n    process.exit(1)\n  }\n}\n\nasync function runBuild(root: string | undefined, options: BuildOptions) {\n  const projectRoot = resolve(root ?? '.')\n  const start = performance.now()\n\n  // Client build\n  await viteBuild({\n    root: projectRoot,\n    build: { outDir: 'dist/client', ssrManifest: true },\n  })\n\n  // Server build\n  await viteBuild({\n    root: projectRoot,\n    build: {\n      outDir: 'dist/server',\n      ssr: 'src/entry-server.ts',\n      rollupOptions: { input: 'src/entry-server.ts' },\n    },\n  })\n\n  const configPath = join(projectRoot, 'vite.config.ts')\n  const zeroConfig = await loadZeroConfig(configPath)\n  const renderMode = (zeroConfig?.mode as string) ?? options.mode ?? 'ssr'\n\n  if (renderMode === 'ssg' || renderMode === 'isr') {\n    await prerenderIfNeeded(projectRoot, zeroConfig)\n  }\n\n  const adapterName = (zeroConfig?.adapter as string) ?? 'node'\n  if (!(adapterName === 'static' && renderMode === 'ssg')) {\n    await runAdapter(projectRoot, zeroConfig ?? {})\n  }\n\n  const elapsed = Math.round(performance.now() - start)\n  console.log(`Build completed in ${elapsed}ms`)\n}\n","import { resolve } from 'node:path'\nimport { createServer } from 'vite'\n\nexport interface DevOptions {\n  port?: number\n  host?: string | boolean\n  open?: boolean\n}\n\nexport async function dev(root: string | undefined, options: DevOptions) {\n  try {\n    const projectRoot = resolve(root ?? '.')\n\n    const server = await createServer({\n      root: projectRoot,\n      server: {\n        port: options.port ?? 3000,\n        host: options.host === true ? '0.0.0.0' : options.host,\n        open: options.open,\n      },\n    })\n\n    await server.listen()\n    server.printUrls()\n  } catch (error) {\n    console.error('Failed to start dev server:', (error as Error).message)\n    process.exit(1)\n  }\n}\n","import { resolve } from 'node:path'\nimport { preview as vitePreview } from 'vite'\n\nexport interface PreviewOptions {\n  port?: number\n  host?: string | boolean\n}\n\nexport async function preview(\n  root: string | undefined,\n  options: PreviewOptions,\n) {\n  try {\n    const projectRoot = resolve(root ?? '.')\n\n    const server = await vitePreview({\n      root: projectRoot,\n      preview: {\n        port: options.port ?? 3000,\n        host: options.host === true ? '0.0.0.0' : options.host,\n      },\n    })\n\n    server.printUrls()\n  } catch (error) {\n    console.error('Failed to start preview server:', (error as Error).message)\n    process.exit(1)\n  }\n}\n","import cac from 'cac'\nimport { build } from './commands/build'\nimport { dev } from './commands/dev'\nimport { preview } from './commands/preview'\n\nconst cli = cac('zero')\n\ncli\n  .command('[root]', 'Start dev server')\n  .alias('dev')\n  .option('--port <port>', 'Server port', { default: 3000 })\n  .option('--host [host]', 'Server host')\n  .option('--open', 'Open browser on start')\n  .action(dev)\n\ncli\n  .command('build [root]', 'Build for production')\n  .option('--mode <mode>', 'Rendering mode override')\n  .action(build)\n\ncli\n  .command('preview [root]', 'Preview production build')\n  .option('--port <port>', 'Server port', { default: 3000 })\n  .option('--host [host]', 'Server host')\n  .action(preview)\n\ncli.help()\ncli.version('0.0.1')\ncli.parse()\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@pyreon/zero-cli",
+  "version": "0.1.1",
+  "description": "CLI for Pyreon Zero — dev, build, preview",
+  "license": "MIT",
+  "author": "Vit Bokisch",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pyreon/zero",
+    "directory": "packages/cli"
+  },
+  "type": "module",
+  "main": "./lib/index.js",
+  "files": [
+    "bin",
+    "lib",
+    "!lib/analysis",
+    "LICENSE",
+    "README.md"
+  ],
+  "bin": {
+    "zero": "./bin/zero.js"
+  },
+  "scripts": {
+    "build": "vl_rolldown_build",
+    "dev": "vl_rolldown_build-watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pyreon/server": "^0.2.1",
+    "@pyreon/zero": "workspace:^",
+    "cac": "^7.0.0",
+    "vite": "^8.0.0"
+  }
+}