@pyreon/zero 0.12.3 → 0.12.4

package/src/index.ts

@@ -1,46 +1,17 @@
-// ─── Core ─────────────────────────────────────────────────────────────────────
-
-export type { CreateAppOptions } from "./app";
-export { createApp } from "./app";
-export type { CreateServerOptions } from "./entry-server";
-export { createServer } from "./entry-server";
-
-// ─── Vite plugin ─────────────────────────────────────────────────────────────
-
-export { zeroPlugin as default } from "./vite-plugin";
-
-// ─── File-system routing ─────────────────────────────────────────────────────
-
-export type { GenerateRouteModuleOptions } from './fs-router'
-export {
-	filePathToUrlPath,
-	generateMiddlewareModule,
-	generateRouteModule,
-	parseFileRoutes,
-	scanRouteFiles,
-} from './fs-router'
-
-// ─── Config ──────────────────────────────────────────────────────────────────
-
-export { defineConfig, resolveConfig } from "./config";
-
-// ─── ISR ─────────────────────────────────────────────────────────────────────
-
-export { createISRHandler } from "./isr";
-
-// ─── Adapters ────────────────────────────────────────────────────────────────
-
-export {
-	bunAdapter,
-	cloudflareAdapter,
-	netlifyAdapter,
-	nodeAdapter,
-	resolveAdapter,
-	staticAdapter,
-	vercelAdapter,
-} from "./adapters";
-
-// ─── Components ─────────────────────────────────────────────────────────────
+/**
+ * @pyreon/zero — client-safe exports.
+ *
+ * This entry contains only browser-safe components and hooks.
+ * No node:fs, node:path, or other server-only imports.
+ *
+ * For server/build-time features, use subpath imports:
+ *   import { faviconPlugin } from "@pyreon/zero/favicon"
+ *   import { createServer } from "@pyreon/zero/server"
+ *   import { defineConfig } from "@pyreon/zero/config"
+ *   import { validateEnv } from "@pyreon/zero/env"
+ */
+
+// ─── Components (browser-safe) ──────────────────────────────────────────────
 
 export type { ImageProps, ImageSource } from "./image";
 export { Image } from "./image";
@@ -48,41 +19,10 @@ export type { LinkProps, LinkRenderProps, UseLinkReturn } from "./link";
 export { createLink, Link, prefetchRoute, useLink } from "./link";
 export type { ScriptProps, ScriptStrategy } from "./script";
 export { Script } from "./script";
+export type { MetaProps } from "./meta";
+export { buildMetaTags, Meta } from "./meta";
 
-// ─── 404 Not Found ──────────────────────────────────────────────────────────
-
-export { render404Page } from "./not-found";
-
-// ─── Middleware ──────────────────────────────────────────────────────────────
-
-export type { CacheConfig, CacheRule } from "./cache";
-export { cacheMiddleware, securityHeaders, varyEncoding } from "./cache";
-export { compose, getContext } from "./middleware";
-
-// ─── Font optimization ─────────────────────────────────────────────────────
-
-export type {
-	FallbackMetrics,
-	FontConfig,
-	FontDisplay,
-	GoogleFontInput,
-	GoogleFontStatic,
-	GoogleFontVariable,
-	LocalFont,
-} from "./font";
-export { fontPlugin, fontVariables } from "./font";
-
-// ─── Image processing ──────────────────────────────────────────────────────
-
-export type {
-	FormatSource,
-	ImageFormat,
-	ImagePluginConfig,
-	ProcessedImage,
-} from "./image-plugin";
-export { imagePlugin } from "./image-plugin";
-
-// ─── Theme ──────────────────────────────────────────────────────────────────
+// ─── Theme (browser-safe) ───────────────────────────────────────────────────
 
 export type { Theme } from "./theme";
 export {
@@ -96,120 +36,17 @@ export {
 	toggleTheme,
 } from "./theme";
 
-// ─── SEO ────────────────────────────────────────────────────────────────────
-
-export type {
-	ChangeFreq,
-	JsonLdType,
-	RobotsConfig,
-	RobotsRule,
-	SeoPluginConfig,
-	SitemapConfig,
-	SitemapEntry,
-} from "./seo";
-export {
-	generateRobots,
-	generateSitemap,
-	jsonLd,
-	seoMiddleware,
-	seoPlugin,
-} from "./seo";
-
-// ─── API routes ──────────────────────────────────────────────────────────────
-
-export type {
-	ApiContext,
-	ApiHandler,
-	ApiRouteEntry,
-	ApiRouteModule,
-	HttpMethod,
-} from "./api-routes";
-export { createApiMiddleware, generateApiRouteModule } from "./api-routes";
-
-// ─── CORS ────────────────────────────────────────────────────────────────────
-
-export type { CorsConfig } from "./cors";
-export { corsMiddleware } from "./cors";
-
-// ─── Rate limiting ──────────────────────────────────────────────────────────
-
-export type { RateLimitConfig } from "./rate-limit";
-export { rateLimitMiddleware } from "./rate-limit";
-
-// ─── Compression ────────────────────────────────────────────────────────────
-
-export type { CompressionConfig } from "./compression";
-export {
-	compressionMiddleware,
-	compressResponse,
-	isCompressible,
-} from "./compression";
-
-// ─── Actions ─────────────────────────────────────────────────────────────────
-
-export type { Action, ActionContext, ActionHandler } from "./actions";
-export { createActionMiddleware, defineAction } from "./actions";
-
-// ─── Favicon ────────────────────────────────────────────────────────────────
-
-export type { FaviconLocaleConfig, FaviconPluginConfig } from "./favicon";
-export { faviconLinks, faviconPlugin } from "./favicon";
-
-// ─── OG Image ───────────────────────────────────────────────────────────────
-
-export type {
-	OgImageLayer,
-	OgImagePluginConfig,
-	OgImageTemplate,
-} from "./og-image";
-export { ogImagePath, ogImagePlugin } from "./og-image";
-
-// ─── Meta ───────────────────────────────────────────────────────────────────
-
-export type { MetaProps } from "./meta";
-export { buildMetaTags, Meta } from "./meta";
-
-// ─── I18n routing ───────────────────────────────────────────────────────────
+// ─── I18n hooks (browser-safe) ──────────────────────────────────────────────
 
 export type { I18nRoutingConfig, LocaleContext } from "./i18n-routing";
 export {
 	buildLocalePath,
-	createLocaleContext,
-	detectLocaleFromHeader,
 	extractLocaleFromPath,
-	i18nRouting,
 	setLocale,
 	useLocale,
 } from "./i18n-routing";
 
-// ─── CSP ────────────────────────────────────────────────────────────────────
-
-export type { CspConfig, CspDirectives } from "./csp";
-export { buildCspHeader, cspMiddleware, useNonce } from "./csp";
-
-// ─── Environment validation ─────────────────────────────────────────────────
-
-export type { LogEntry, LoggerConfig } from "./logger";
-export { loggerMiddleware } from "./logger";
-
-// ─── Request logging ────────────────────────────────────────────────────────
-
-export type { EnvValidator } from "./env";
-export { bool, num, oneOf, publicEnv, schema, str, url, validateEnv } from "./env";
-
-// ─── AI integration ─────────────────────────────────────────────────────────
-
-export type { AiPluginConfig, InferJsonLdOptions } from "./ai";
-export {
-	aiPlugin,
-	generateAiPluginManifest,
-	generateLlmsFullTxt,
-	generateLlmsTxt,
-	generateOpenApiSpec,
-	inferJsonLd,
-} from "./ai";
-
-// ─── Types ───────────────────────────────────────────────────────────────────
+// ─── Types (no runtime, safe everywhere) ────────────────────────────────────
 
 export type {
 	Adapter,

package/src/meta.tsx

@@ -1,11 +1,45 @@
 import type { VNodeChild } from '@pyreon/core'
 import type { UseHeadInput } from '@pyreon/head'
 import { useHead } from '@pyreon/head'
-import type { FaviconPluginConfig } from './favicon'
-import { faviconLinks } from './favicon'
 import type { I18nRoutingConfig } from './i18n-routing'
 import { extractLocaleFromPath } from './i18n-routing'
-import { ogImagePath } from './og-image'
+
+// ─── Inline helpers (no node:fs dependency) ─────────────────────────────────
+// These are inlined to avoid importing from favicon.ts/og-image.ts which
+// pull in node:fs at the top level — making Meta unsafe for client bundles.
+
+/** Favicon plugin config shape (type-only). */
+interface FaviconPluginConfig {
+  source: string
+  themeColor?: string
+  manifest?: boolean
+  locales?: Record<string, { source: string; darkSource?: string }>
+  [key: string]: unknown
+}
+
+function faviconLinks(
+  locale: string | undefined,
+  config: FaviconPluginConfig,
+): Array<{ rel: string; type?: string; sizes?: string; href: string }> {
+  const hasLocaleOverride = locale && config.locales?.[locale]
+  const prefix = hasLocaleOverride ? `/${locale}` : ''
+  const isSvg = (hasLocaleOverride ? config.locales![locale]!.source : config.source).endsWith('.svg')
+  const links: Array<{ rel: string; type?: string; sizes?: string; href: string }> = []
+  if (isSvg) links.push({ rel: 'icon', type: 'image/svg+xml', href: `${prefix}/favicon.svg` })
+  links.push(
+    { rel: 'icon', type: 'image/png', sizes: '32x32', href: `${prefix}/favicon-32x32.png` },
+    { rel: 'icon', type: 'image/png', sizes: '16x16', href: `${prefix}/favicon-16x16.png` },
+    { rel: 'apple-touch-icon', sizes: '180x180', href: `${prefix}/apple-touch-icon.png` },
+  )
+  if (config.manifest !== false) links.push({ rel: 'manifest', href: `${prefix}/site.webmanifest` })
+  return links
+}
+
+function ogImagePath(templateName: string, locale?: string, outDir = 'og', format: 'png' | 'jpeg' = 'png'): string {
+  const ext = format === 'jpeg' ? 'jpg' : 'png'
+  const suffix = locale ? `-${locale}` : ''
+  return `/${outDir}/${templateName}${suffix}.${ext}`
+}
 
 // ─── Meta component ────────────────────────────────────────────────────────
 

package/src/server.ts

@@ -0,0 +1,70 @@
+/**
+ * @pyreon/zero/server — server-only exports.
+ *
+ * Import from this subpath for SSR, middleware, adapters, and build tools.
+ * These modules use node:fs, node:path, etc. and must NOT be imported
+ * in client-side code.
+ *
+ * @example
+ * ```ts
+ * import { createServer, createApp } from "@pyreon/zero/server"
+ * ```
+ */
+
+// ─── Server entry ───────────────────────────────────────────────────────────
+
+export type { CreateAppOptions } from "./app";
+export { createApp } from "./app";
+export type { CreateServerOptions } from "./entry-server";
+export { createServer } from "./entry-server";
+
+// ─── Config ─────────────────────────────────────────────────────────────────
+
+export { defineConfig, resolveConfig } from "./config";
+
+// ─── File-system routing ────────────────────────────────────────────────────
+
+export type { GenerateRouteModuleOptions } from './fs-router'
+export {
+	filePathToUrlPath,
+	generateMiddlewareModule,
+	generateRouteModule,
+	parseFileRoutes,
+	scanRouteFiles,
+} from './fs-router'
+
+// ─── ISR ────────────────────────────────────────────────────────────────────
+
+export { createISRHandler } from "./isr";
+
+// ─── Adapters ───────────────────────────────────────────────────────────────
+
+export {
+	bunAdapter,
+	cloudflareAdapter,
+	netlifyAdapter,
+	nodeAdapter,
+	resolveAdapter,
+	staticAdapter,
+	vercelAdapter,
+} from "./adapters";
+
+// ─── 404 ────────────────────────────────────────────────────────────────────
+
+export { render404Page } from "./not-found";
+
+// ─── Middleware ──────────────────────────────────────────────────────────────
+
+export { compose, getContext } from "./middleware";
+
+// ─── Vite plugin ────────────────────────────────────────────────────────────
+
+export { zeroPlugin as default } from "./vite-plugin";
+
+// ─── I18n server-only ───────────────────────────────────────────────────────
+
+export {
+	createLocaleContext,
+	detectLocaleFromHeader,
+	i18nRouting,
+} from "./i18n-routing";

package/lib/fs-router-Dil4IKZR.js

@@ -1,290 +0,0 @@
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (!no_symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
-	return target;
-};
-
-//#endregion
-//#region src/fs-router.ts
-var fs_router_exports = /* @__PURE__ */ __exportAll({
-	filePathToUrlPath: () => filePathToUrlPath,
-	generateMiddlewareModule: () => generateMiddlewareModule,
-	generateRouteModule: () => generateRouteModule,
-	parseFileRoutes: () => parseFileRoutes,
-	scanRouteFiles: () => scanRouteFiles
-});
-const ROUTE_EXTENSIONS = [
-	".tsx",
-	".jsx",
-	".ts",
-	".js"
-];
-/**
-* Parse a set of file paths (relative to routes dir) into FileRoute objects.
-*
-* @param files Array of file paths like ["index.tsx", "users/[id].tsx"]
-* @param defaultMode Default rendering mode from config
-*/
-function parseFileRoutes(files, defaultMode = "ssr") {
-	return files.filter((f) => ROUTE_EXTENSIONS.some((ext) => f.endsWith(ext))).map((filePath) => parseFilePath(filePath, defaultMode)).sort(sortRoutes);
-}
-function parseFilePath(filePath, defaultMode) {
-	let route = filePath;
-	for (const ext of ROUTE_EXTENSIONS) if (route.endsWith(ext)) {
-		route = route.slice(0, -ext.length);
-		break;
-	}
-	const fileName = getFileName(route);
-	const isLayout = fileName === "_layout";
-	const isError = fileName === "_error";
-	const isLoading = fileName === "_loading";
-	const isNotFound = fileName === "_404" || fileName === "_not-found";
-	const isCatchAll = route.includes("[...");
-	const parts = route.split("/");
-	parts.pop();
-	const dirPath = parts.filter((s) => !(s.startsWith("(") && s.endsWith(")"))).join("/");
-	const urlPath = filePathToUrlPath(route);
-	return {
-		filePath,
-		urlPath,
-		dirPath,
-		depth: urlPath === "/" ? 0 : urlPath.split("/").filter(Boolean).length,
-		isLayout,
-		isError,
-		isLoading,
-		isNotFound,
-		isCatchAll,
-		renderMode: defaultMode
-	};
-}
-/**
-* Convert a file path (without extension) to a URL path pattern.
-*
-* Examples:
-*   "index"            → "/"
-*   "about"            → "/about"
-*   "users/index"      → "/users"
-*   "users/[id]"       → "/users/:id"
-*   "blog/[...slug]"   → "/blog/:slug*"
-*   "(auth)/login"     → "/login"         (group stripped)
-*   "_layout"          → "/"              (layout marker)
-*/
-function filePathToUrlPath(filePath) {
-	const segments = filePath.split("/");
-	const urlSegments = [];
-	for (const seg of segments) {
-		if (seg.startsWith("(") && seg.endsWith(")")) continue;
-		if (seg === "_layout" || seg === "_error" || seg === "_loading" || seg === "_404" || seg === "_not-found") continue;
-		if (seg === "index") continue;
-		const catchAll = seg.match(/^\[\.\.\.(\w+)\]$/);
-		if (catchAll) {
-			urlSegments.push(`:${catchAll[1]}*`);
-			continue;
-		}
-		const dynamic = seg.match(/^\[(\w+)\]$/);
-		if (dynamic) {
-			urlSegments.push(`:${dynamic[1]}`);
-			continue;
-		}
-		urlSegments.push(seg);
-	}
-	return `/${urlSegments.join("/")}` || "/";
-}
-/** Sort routes: static before dynamic, catch-all last. */
-function sortRoutes(a, b) {
-	if (a.isCatchAll !== b.isCatchAll) return a.isCatchAll ? 1 : -1;
-	if (a.isLayout !== b.isLayout) return a.isLayout ? -1 : 1;
-	const aDynamic = a.urlPath.includes(":");
-	if (aDynamic !== b.urlPath.includes(":")) return aDynamic ? 1 : -1;
-	return a.urlPath.localeCompare(b.urlPath);
-}
-function getFileName(filePath) {
-	const parts = filePath.split("/");
-	return parts[parts.length - 1] ?? "";
-}
-/**
-* Group flat file routes into a directory tree.
-*/
-function getOrCreateChild(node, segment) {
-	let child = node.children.get(segment);
-	if (!child) {
-		child = {
-			pages: [],
-			children: /* @__PURE__ */ new Map()
-		};
-		node.children.set(segment, child);
-	}
-	return child;
-}
-function resolveNode(root, dirPath) {
-	let node = root;
-	if (dirPath) for (const segment of dirPath.split("/")) node = getOrCreateChild(node, segment);
-	return node;
-}
-function placeRoute(node, route) {
-	if (route.isLayout) node.layout = route;
-	else if (route.isError) node.error = route;
-	else if (route.isLoading) node.loading = route;
-	else if (route.isNotFound) node.notFound = route;
-	else node.pages.push(route);
-}
-function buildRouteTree(routes) {
-	const root = {
-		pages: [],
-		children: /* @__PURE__ */ new Map()
-	};
-	for (const route of routes) placeRoute(resolveNode(root, route.dirPath), route);
-	return root;
-}
-function generateRouteModule(files, routesDir, options) {
-	const tree = buildRouteTree(parseFileRoutes(files));
-	const imports = [];
-	let importCounter = 0;
-	const useStaticImports = options?.staticImports ?? false;
-	function nextImport(filePath, exportName = "default") {
-		const name = `_${importCounter++}`;
-		const fullPath = `${routesDir}/${filePath}`;
-		if (exportName === "default") imports.push(`import ${name} from "${fullPath}"`);
-		else imports.push(`import { ${exportName} as ${name} } from "${fullPath}"`);
-		return name;
-	}
-	function nextLazy(filePath, loadingName, errorName) {
-		const name = `_${importCounter++}`;
-		const fullPath = `${routesDir}/${filePath}`;
-		if (useStaticImports) imports.push(`import ${name} from "${fullPath}"`);
-		else {
-			const opts = [];
-			if (loadingName) opts.push(`loading: ${loadingName}`);
-			if (errorName) opts.push(`error: ${errorName}`);
-			const optsStr = opts.length > 0 ? `, { ${opts.join(", ")} }` : "";
-			imports.push(`const ${name} = lazy(() => import("${fullPath}")${optsStr})`);
-		}
-		return name;
-	}
-	function nextModuleImport(filePath) {
-		const name = `_m${importCounter++}`;
-		const fullPath = `${routesDir}/${filePath}`;
-		imports.push(`import * as ${name} from "${fullPath}"`);
-		return name;
-	}
-	function generatePageRoute(page, indent, loadingName, errorName, notFoundName) {
-		const mod = nextModuleImport(page.filePath);
-		const comp = nextLazy(page.filePath, loadingName, errorName);
-		const props = [
-			`${indent}  path: ${JSON.stringify(page.urlPath)}`,
-			`${indent}  component: ${comp}`,
-			`${indent}  loader: ${mod}.loader`,
-			`${indent}  beforeEnter: ${mod}.guard`,
-			`${indent}  meta: { ...${mod}.meta, renderMode: ${mod}.renderMode }`
-		];
-		if (errorName) props.push(`${indent}  errorComponent: ${mod}.error || ${errorName}`);
-		if (notFoundName) props.push(`${indent}  notFoundComponent: ${notFoundName}`);
-		return `${indent}{\n${props.join(",\n")}\n${indent}}`;
-	}
-	function wrapWithLayout(node, children, indent, errorName, notFoundName) {
-		const layout = node.layout;
-		const layoutMod = nextModuleImport(layout.filePath);
-		const layoutComp = nextImport(layout.filePath, "layout");
-		const props = [
-			`${indent}path: ${JSON.stringify(layout.urlPath)}`,
-			`${indent}component: ${layoutComp}`,
-			`${indent}loader: ${layoutMod}.loader`,
-			`${indent}beforeEnter: ${layoutMod}.guard`,
-			`${indent}meta: { ...${layoutMod}.meta, renderMode: ${layoutMod}.renderMode }`
-		];
-		if (errorName) props.push(`${indent}errorComponent: ${errorName}`);
-		if (notFoundName) props.push(`${indent}notFoundComponent: ${notFoundName}`);
-		if (children.length > 0) props.push(`${indent}children: [\n${children.join(",\n")}\n${indent}]`);
-		return `${indent}{\n${props.map((p) => `  ${p}`).join(",\n")}\n${indent}}`;
-	}
-	/**
-	* Generate route definitions for a tree node.
-	*/
-	function generateNode(node, depth) {
-		const indent = "  ".repeat(depth + 1);
-		const errorName = node.error ? nextImport(node.error.filePath) : void 0;
-		const loadingName = node.loading ? nextImport(node.loading.filePath) : void 0;
-		const notFoundName = node.notFound ? nextImport(node.notFound.filePath) : void 0;
-		const childRouteDefs = [];
-		for (const [, childNode] of node.children) childRouteDefs.push(...generateNode(childNode, depth + 1));
-		const allChildren = [...node.pages.map((page) => generatePageRoute(page, indent, loadingName, errorName, notFoundName)), ...childRouteDefs];
-		if (node.layout) return [wrapWithLayout(node, allChildren, indent, errorName, notFoundName)];
-		return allChildren;
-	}
-	const routeDefs = generateNode(tree, 0);
-	return [
-		`import { lazy } from "@pyreon/router"`,
-		"",
-		...imports,
-		"",
-		`function clean(routes) {`,
-		`  return routes.map(r => {`,
-		`    const c = {}`,
-		`    for (const k in r) if (r[k] !== undefined) c[k] = r[k]`,
-		`    if (c.children) c.children = clean(c.children)`,
-		`    return c`,
-		`  })`,
-		`}`,
-		"",
-		`export const routes = clean([`,
-		routeDefs.join(",\n"),
-		`])`
-	].join("\n");
-}
-/**
-* Generate a virtual module that maps URL patterns to their middleware exports.
-* Used by the server entry to dispatch per-route middleware.
-*/
-function generateMiddlewareModule(files, routesDir) {
-	const routes = parseFileRoutes(files);
-	const imports = [];
-	const entries = [];
-	let counter = 0;
-	for (const route of routes) {
-		if (route.isLayout || route.isError || route.isLoading || route.isNotFound) continue;
-		const name = `_mw${counter++}`;
-		const fullPath = `${routesDir}/${route.filePath}`;
-		imports.push(`import { middleware as ${name} } from "${fullPath}"`);
-		entries.push(`  { pattern: ${JSON.stringify(route.urlPath)}, middleware: ${name} }`);
-	}
-	return [
-		...imports,
-		"",
-		`export const routeMiddleware = [`,
-		entries.join(",\n"),
-		`].filter(e => e.middleware)`
-	].join("\n");
-}
-/**
-* Scan a directory for route files.
-* Returns paths relative to the routes directory.
-*/
-async function scanRouteFiles(routesDir) {
-	const { readdir } = await import("node:fs/promises");
-	const { join, relative } = await import("node:path");
-	const files = [];
-	async function walk(dir) {
-		const entries = await readdir(dir, { withFileTypes: true });
-		for (const entry of entries) {
-			const fullPath = join(dir, entry.name);
-			if (entry.isDirectory()) await walk(fullPath);
-			else if (ROUTE_EXTENSIONS.some((ext) => entry.name.endsWith(ext))) files.push(relative(routesDir, fullPath));
-		}
-	}
-	await walk(routesDir);
-	return files;
-}
-
-//#endregion
-export { parseFileRoutes as a, generateRouteModule as i, fs_router_exports as n, scanRouteFiles as o, generateMiddlewareModule as r, filePathToUrlPath as t };
-//# sourceMappingURL=fs-router-Dil4IKZR.js.map