@pyreon/zero 0.16.0 → 0.18.0

package/lib/server.js

@@ -1,4 +1,4 @@
-import { _ as render404Page, a as detectLocaleFromHeader, c as vercelAdapter, d as netlifyAdapter, f as cloudflareAdapter, g as createServer, h as resolveConfig, i as createLocaleContext, l as staticAdapter, m as defineConfig, o as i18nRouting, p as bunAdapter, r as zeroPlugin, s as resolveAdapter, t as getZeroPluginConfig, u as nodeAdapter, v as createApp } from "./vite-plugin-xjWZwudX.js";
+import { _ as render404Page, a as detectLocaleFromHeader, c as vercelAdapter, d as netlifyAdapter, f as cloudflareAdapter, g as createServer, h as resolveConfig, i as createLocaleContext, l as staticAdapter, m as defineConfig, o as i18nRouting, p as bunAdapter, r as zeroPlugin, s as resolveAdapter, t as getZeroPluginConfig, u as nodeAdapter, v as createApp } from "./vite-plugin-y0NmCLJA.js";
 import { i as generateRouteModule, o as parseFileRoutes, r as generateMiddlewareModule, s as scanRouteFiles, t as filePathToUrlPath } from "./fs-router-MewHc5SB.js";
 import { existsSync } from "node:fs";
 import { join, resolve } from "node:path";

package/lib/types/config.d.ts

@@ -210,6 +210,38 @@ interface ZeroConfig {
       currentPath: string;
       elapsed: number;
     }) => void | Promise<void>;
+    /**
+     * Route-level code splitting in SSG mode. Default `true`.
+     *
+     * When `true` (default), each route file becomes its own dynamic-import
+     * chunk via `lazy(() => import("..."))` — only the route the user
+     * lands on plus its dependencies ship in the initial bundle, the
+     * rest fetch on navigation. Matches the SSR/SPA-mode behaviour zero
+     * has always had; brings parity to SSG.
+     *
+     * When `false`, every route is bundled statically into the main
+     * client chunk (the pre-2026-Q3 SSG behaviour). Useful for tiny
+     * sites (2-5 pages) where the single-chunk-then-instant-nav trade
+     * is preferable — the chunk-fetch cost on navigation is gone, and
+     * the marginal bytes are negligible.
+     *
+     * Crossover point: ~5-8 routes. Below that, single-chunk is fine.
+     * Above that, lazy() shrinks the initial bundle by a meaningful
+     * amount (a 50-route docs site might drop from 200 KB to 80 KB on
+     * first paint).
+     *
+     * Underlying mechanism is the same 3-tier generator zero already
+     * uses for SSR/SPA mode (`fs-router.ts:generateRouteEntry`): lazy
+     * component + inlined metadata when possible, lazy + lazy-thunked
+     * function exports when not, namespace-import fallback for cases
+     * the literal-extractor can't reach.
+     *
+     * @example
+     * ssg: {
+     *   splitChunks: false, // bundle-everything for a 3-page marketing site
+     * }
+     */
+    splitChunks?: boolean;
   };
   /** ISR config — only used when mode is "isr". */
   isr?: ISRConfig;

package/lib/types/index.d.ts

@@ -628,6 +628,38 @@ interface ZeroConfig {
       currentPath: string;
       elapsed: number;
     }) => void | Promise<void>;
+    /**
+     * Route-level code splitting in SSG mode. Default `true`.
+     *
+     * When `true` (default), each route file becomes its own dynamic-import
+     * chunk via `lazy(() => import("..."))` — only the route the user
+     * lands on plus its dependencies ship in the initial bundle, the
+     * rest fetch on navigation. Matches the SSR/SPA-mode behaviour zero
+     * has always had; brings parity to SSG.
+     *
+     * When `false`, every route is bundled statically into the main
+     * client chunk (the pre-2026-Q3 SSG behaviour). Useful for tiny
+     * sites (2-5 pages) where the single-chunk-then-instant-nav trade
+     * is preferable — the chunk-fetch cost on navigation is gone, and
+     * the marginal bytes are negligible.
+     *
+     * Crossover point: ~5-8 routes. Below that, single-chunk is fine.
+     * Above that, lazy() shrinks the initial bundle by a meaningful
+     * amount (a 50-route docs site might drop from 200 KB to 80 KB on
+     * first paint).
+     *
+     * Underlying mechanism is the same 3-tier generator zero already
+     * uses for SSR/SPA mode (`fs-router.ts:generateRouteEntry`): lazy
+     * component + inlined metadata when possible, lazy + lazy-thunked
+     * function exports when not, namespace-import fallback for cases
+     * the literal-extractor can't reach.
+     *
+     * @example
+     * ssg: {
+     *   splitChunks: false, // bundle-everything for a 3-page marketing site
+     * }
+     */
+    splitChunks?: boolean;
   };
   /** ISR config — only used when mode is "isr". */
   isr?: ISRConfig;

package/lib/types/server.d.ts

@@ -331,6 +331,38 @@ interface ZeroConfig {
       currentPath: string;
       elapsed: number;
     }) => void | Promise<void>;
+    /**
+     * Route-level code splitting in SSG mode. Default `true`.
+     *
+     * When `true` (default), each route file becomes its own dynamic-import
+     * chunk via `lazy(() => import("..."))` — only the route the user
+     * lands on plus its dependencies ship in the initial bundle, the
+     * rest fetch on navigation. Matches the SSR/SPA-mode behaviour zero
+     * has always had; brings parity to SSG.
+     *
+     * When `false`, every route is bundled statically into the main
+     * client chunk (the pre-2026-Q3 SSG behaviour). Useful for tiny
+     * sites (2-5 pages) where the single-chunk-then-instant-nav trade
+     * is preferable — the chunk-fetch cost on navigation is gone, and
+     * the marginal bytes are negligible.
+     *
+     * Crossover point: ~5-8 routes. Below that, single-chunk is fine.
+     * Above that, lazy() shrinks the initial bundle by a meaningful
+     * amount (a 50-route docs site might drop from 200 KB to 80 KB on
+     * first paint).
+     *
+     * Underlying mechanism is the same 3-tier generator zero already
+     * uses for SSR/SPA mode (`fs-router.ts:generateRouteEntry`): lazy
+     * component + inlined metadata when possible, lazy + lazy-thunked
+     * function exports when not, namespace-import fallback for cases
+     * the literal-extractor can't reach.
+     *
+     * @example
+     * ssg: {
+     *   splitChunks: false, // bundle-everything for a 3-page marketing site
+     * }
+     */
+    splitChunks?: boolean;
   };
   /** ISR config — only used when mode is "isr". */
   isr?: ISRConfig;

package/lib/{vite-plugin-xjWZwudX.js → vite-plugin-y0NmCLJA.js}

@@ -2073,6 +2073,7 @@ function ssgPlugin(userConfig = {}) {
 //#endregion
 //#region src/vite-plugin.ts
 var vite_plugin_exports = /* @__PURE__ */ __exportAll({
+	argvHasPortFlag: () => argvHasPortFlag,
 	getZeroPluginConfig: () => getZeroPluginConfig,
 	zeroPlugin: () => zeroPlugin
 });
@@ -2129,6 +2130,25 @@ function getZeroPluginConfig(plugin) {
 	return zeroPluginConfigMap.get(plugin);
 }
 /**
+* Detects `--port` / `--port=N` / `-p N` / `-p=N` in `process.argv`.
+* Used by the plugin's `config()` hook to decide whether to apply the
+* default port — when the CLI was invoked with `--port`, the plugin
+* must skip its default so the CLI flag wins (see the comment at the
+* port-handling block in `zeroPlugin()` for the full precedence model).
+*
+* Exported for testing only (the plugin uses it internally).
+*
+* @internal
+*/
+function argvHasPortFlag(argv = process.argv) {
+	for (let i = 0; i < argv.length; i++) {
+		const a = argv[i];
+		if (a === "--port" || a === "-p") return true;
+		if (a !== void 0 && (a.startsWith("--port=") || a.startsWith("-p="))) return true;
+	}
+	return false;
+}
+/**
 * Zero Vite plugin — adds file-based routing and zero-config conventions
 * on top of @pyreon/vite-plugin.
 *
@@ -2160,7 +2180,9 @@ function zeroPlugin(userConfig = {}) {
 		async load(id) {
 			if (id === RESOLVED_VIRTUAL_ROUTES_ID) try {
 				const baseRoutes = await scanRouteFilesWithExports(routesDir, config.mode);
-				return generateRouteModuleFromRoutes(config.i18n ? expandRoutesForLocales(baseRoutes, config.i18n) : baseRoutes, routesDir, { staticImports: config.mode === "ssg" });
+				const routes = config.i18n ? expandRoutesForLocales(baseRoutes, config.i18n) : baseRoutes;
+				const ssgSplitDisabled = config.mode === "ssg" && config.ssg?.splitChunks === false;
+				return generateRouteModuleFromRoutes(routes, routesDir, { staticImports: ssgSplitDisabled });
 			} catch (_err) {
 				return `export const routes = []`;
 			}
@@ -2289,7 +2311,7 @@ function zeroPlugin(userConfig = {}) {
 					...runtimeServerAlias ? { alias: { "@pyreon/runtime-server": runtimeServerAlias } } : {}
 				} },
 				optimizeDeps: { exclude: pyreonExclude },
-				...userConfig.port !== void 0 ? { server: { port: config.port } } : {},
+				...userConfig.port === void 0 && argvHasPortFlag() ? {} : { server: { port: config.port } },
 				base: config.base,
 				define: {
 					__ZERO_MODE__: JSON.stringify(config.mode),
@@ -2451,4 +2473,4 @@ function flattenRoutePatterns(routes) {
 
 //#endregion
 export { render404Page as _, detectLocaleFromHeader as a, vercelAdapter as c, netlifyAdapter as d, cloudflareAdapter as f, createServer as g, resolveConfig as h, createLocaleContext as i, staticAdapter as l, defineConfig as m, vite_plugin_exports as n, i18nRouting as o, bunAdapter as p, zeroPlugin as r, resolveAdapter as s, getZeroPluginConfig as t, nodeAdapter as u, createApp as v };
-//# sourceMappingURL=vite-plugin-xjWZwudX.js.map
+//# sourceMappingURL=vite-plugin-y0NmCLJA.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/zero",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Pyreon Zero — zero-config full-stack framework powered by Pyreon and Vite",
   "license": "MIT",
   "author": "Vit Bokisch",
@@ -168,15 +168,15 @@
     "lint": "oxlint ."
   },
   "dependencies": {
-    "@pyreon/core": "^0.16.0",
-    "@pyreon/head": "^0.16.0",
-    "@pyreon/meta": "^0.16.0",
-    "@pyreon/reactivity": "^0.16.0",
-    "@pyreon/router": "^0.16.0",
-    "@pyreon/runtime-dom": "^0.16.0",
-    "@pyreon/runtime-server": "^0.16.0",
-    "@pyreon/server": "^0.16.0",
-    "@pyreon/vite-plugin": "^0.16.0",
+    "@pyreon/core": "^0.18.0",
+    "@pyreon/head": "^0.18.0",
+    "@pyreon/meta": "^0.18.0",
+    "@pyreon/reactivity": "^0.18.0",
+    "@pyreon/router": "^0.18.0",
+    "@pyreon/runtime-dom": "^0.18.0",
+    "@pyreon/runtime-server": "^0.18.0",
+    "@pyreon/server": "^0.18.0",
+    "@pyreon/vite-plugin": "^0.18.0",
     "vite": "^8.0.0"
   },
   "devDependencies": {

package/src/types.ts

@@ -254,6 +254,38 @@ export interface ZeroConfig {
       currentPath: string
       elapsed: number
     }) => void | Promise<void>
+    /**
+     * Route-level code splitting in SSG mode. Default `true`.
+     *
+     * When `true` (default), each route file becomes its own dynamic-import
+     * chunk via `lazy(() => import("..."))` — only the route the user
+     * lands on plus its dependencies ship in the initial bundle, the
+     * rest fetch on navigation. Matches the SSR/SPA-mode behaviour zero
+     * has always had; brings parity to SSG.
+     *
+     * When `false`, every route is bundled statically into the main
+     * client chunk (the pre-2026-Q3 SSG behaviour). Useful for tiny
+     * sites (2-5 pages) where the single-chunk-then-instant-nav trade
+     * is preferable — the chunk-fetch cost on navigation is gone, and
+     * the marginal bytes are negligible.
+     *
+     * Crossover point: ~5-8 routes. Below that, single-chunk is fine.
+     * Above that, lazy() shrinks the initial bundle by a meaningful
+     * amount (a 50-route docs site might drop from 200 KB to 80 KB on
+     * first paint).
+     *
+     * Underlying mechanism is the same 3-tier generator zero already
+     * uses for SSR/SPA mode (`fs-router.ts:generateRouteEntry`): lazy
+     * component + inlined metadata when possible, lazy + lazy-thunked
+     * function exports when not, namespace-import fallback for cases
+     * the literal-extractor can't reach.
+     *
+     * @example
+     * ssg: {
+     *   splitChunks: false, // bundle-everything for a 3-page marketing site
+     * }
+     */
+    splitChunks?: boolean
   }
 
   /** ISR config — only used when mode is "isr". */

package/src/vite-plugin.ts

@@ -90,6 +90,27 @@ export function getZeroPluginConfig(plugin: Plugin): ZeroConfig | undefined {
 	return zeroPluginConfigMap.get(plugin);
 }
 
+/**
+ * Detects `--port` / `--port=N` / `-p N` / `-p=N` in `process.argv`.
+ * Used by the plugin's `config()` hook to decide whether to apply the
+ * default port — when the CLI was invoked with `--port`, the plugin
+ * must skip its default so the CLI flag wins (see the comment at the
+ * port-handling block in `zeroPlugin()` for the full precedence model).
+ *
+ * Exported for testing only (the plugin uses it internally).
+ *
+ * @internal
+ */
+export function argvHasPortFlag(argv: readonly string[] = process.argv): boolean {
+	for (let i = 0; i < argv.length; i++) {
+		const a = argv[i];
+		if (a === "--port" || a === "-p") return true;
+		if (a !== undefined && (a.startsWith("--port=") || a.startsWith("-p=")))
+			return true;
+	}
+	return false;
+}
+
 /**
  * Zero Vite plugin — adds file-based routing and zero-config conventions
  * on top of @pyreon/vite-plugin.
@@ -138,8 +159,23 @@ export function zeroPlugin(userConfig: ZeroConfig = {}): Plugin[] {
 					const routes = config.i18n
 						? expandRoutesForLocales(baseRoutes, config.i18n)
 						: baseRoutes;
+					// SSG mode: lazy() route splitting by default (parity with
+					// SSR/SPA). Opt-out via `ssg.splitChunks: false` for tiny
+					// sites that prefer single-chunk + instant navigation.
+					//
+					// Pre-2026-Q3: SSG was hardcoded to `staticImports: true`
+					// (bundle everything). Trade-off was instant post-hydration
+					// nav, but the initial bundle grew linearly with route
+					// count — a 50-route docs site shipped all 50 route
+					// components on first paint. Lazy splitting (now the
+					// default for SSG) fixes that: only the landing route +
+					// deps load up front, the rest fetch on navigation. See
+					// `ssg.splitChunks` JSDoc in types.ts for the crossover-
+					// point rationale.
+					const ssgSplitDisabled =
+						config.mode === "ssg" && config.ssg?.splitChunks === false;
 					return generateRouteModuleFromRoutes(routes, routesDir, {
-						staticImports: config.mode === 'ssg',
+						staticImports: ssgSplitDisabled,
 					});
 				} catch (_err) {
 					return `export const routes = []`;
@@ -389,16 +425,32 @@ export function zeroPlugin(userConfig: ZeroConfig = {}): Plugin[] {
 				optimizeDeps: {
 					exclude: pyreonExclude,
 				},
-				// Only set the port when the user explicitly provided one in
-				// `zero({ port: N })`. Without this guard, the plugin always
-				// returned `server: { port: 3000 }` which overrode Vite's CLI
-				// `--port` flag and made multi-example dev impossible — every
-				// example tried to bind 3000 even when launched with
-				// `vite --port 5173`. Surfaced when wiring up the playwright
-				// e2e suite.
-				...(userConfig.port !== undefined
-					? { server: { port: config.port } }
-					: {}),
+				// Port handling — the zero-canonical default is 3000 (matches
+				// `zero dev` / `zero preview` / the runtime adapter, and
+				// matches Next.js / Remix / Astro convention).
+				//
+				// Apply the default UNLESS Vite's CLI was invoked with
+				// `--port`/`-p` (in which case the CLI flag must win — see
+				// memory: vite cli port doesnt override plugin). PR #579
+				// proved this empirically: returning `server: { port: 3000 }`
+				// unconditionally clobbered `vite --port 517N --strictPort`
+				// in the e2e playwright config and every webServer timed
+				// out. argv detection here lets the CLI win at the source.
+				//
+				// Precedence (CLI > user vite.config > zero({port}) > 3000):
+				//   1. `vite --port N` → argvHasPortFlag() === true → plugin
+				//      omits `server.port` entirely → CLI value wins
+				//   2. User `vite.config.ts server: { port: N }` → user
+				//      config beats plugin in Vite's merge order
+				//   3. `zero({ port: N })` → resolved into `config.port`
+				//   4. Default 3000 — when no other source set a port
+				//
+				// `process.argv` is populated by the time Vite invokes the
+				// plugin's config() hook (Vite calls plugins synchronously
+				// during CLI bootstrap before applying inline overrides).
+				...(userConfig.port === undefined && argvHasPortFlag()
+					? {}
+					: { server: { port: config.port } }),
 				// Propagate `zero({ base })` to Vite's `base` config — that's
 				// what controls asset URL rewriting in the built HTML/JS
 				// (`<script src="/blog/assets/…">`). Pre-fix this was a