@pyreon/zero 0.1.0

package/lib/fs-router-jfd1QGLB.js

@@ -0,0 +1,261 @@
+//#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,
+	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 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,
+		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") 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 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;
+}
+/**
+* Generate a virtual module that exports a nested route tree.
+* Wires up layouts as parent routes with children, loaders, guards,
+* error/loading components, middleware, and meta from route module exports.
+*/
+function generateRouteModule(files, routesDir) {
+	const tree = buildRouteTree(parseFileRoutes(files));
+	const imports = [];
+	let importCounter = 0;
+	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}`;
+		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) {
+		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`
+		];
+		if (errorName) props.push(`${indent}  errorComponent: ${mod}.error || ${errorName}`);
+		else props.push(`${indent}  errorComponent: ${mod}.error`);
+		return `${indent}{\n${props.join(",\n")}\n${indent}}`;
+	}
+	function wrapWithLayout(node, children, indent, errorName) {
+		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`
+		];
+		if (errorName) props.push(`${indent}errorComponent: ${errorName}`);
+		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 childRouteDefs = [];
+		for (const [, childNode] of node.children) childRouteDefs.push(...generateNode(childNode, depth + 1));
+		const allChildren = [...node.pages.map((page) => generatePageRoute(page, indent, loadingName, errorName)), ...childRouteDefs];
+		if (node.layout) return [wrapWithLayout(node, allChildren, indent, errorName)];
+		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");
+}
+/**
+* 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 { scanRouteFiles as a, parseFileRoutes as i, fs_router_exports as n, generateRouteModule as r, filePathToUrlPath as t };
+//# sourceMappingURL=fs-router-jfd1QGLB.js.map

package/lib/fs-router-jfd1QGLB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-router-jfd1QGLB.js","names":[],"sources":["../src/fs-router.ts"],"sourcesContent":["import type { FileRoute, RenderMode } from './types'\n\n// ─── File-system route conventions ──────────────────────────────────────────\n//\n// src/routes/\n//   _layout.tsx          → layout for all routes\n//   index.tsx            → /\n//   about.tsx            → /about\n//   users/\n//     _layout.tsx        → layout for /users/*\n//     _loading.tsx       → loading fallback for /users/*\n//     _error.tsx         → error boundary for /users/*\n//     index.tsx          → /users\n//     [id].tsx           → /users/:id\n//     [id]/\n//       settings.tsx     → /users/:id/settings\n//   blog/\n//     [...slug].tsx      → /blog/* (catch-all)\n//\n// Conventions:\n//   [param]     → dynamic segment  → :param\n//   [...param]  → catch-all        → :param*\n//   _layout     → layout wrapper (not a route itself)\n//   _error      → error component\n//   _loading    → loading component\n//   (group)     → route group (directory ignored in URL)\n\nconst ROUTE_EXTENSIONS = ['.tsx', '.jsx', '.ts', '.js']\n\n/**\n * Parse a set of file paths (relative to routes dir) into FileRoute objects.\n *\n * @param files Array of file paths like [\"index.tsx\", \"users/[id].tsx\"]\n * @param defaultMode Default rendering mode from config\n */\nexport function parseFileRoutes(\n  files: string[],\n  defaultMode: RenderMode = 'ssr',\n): FileRoute[] {\n  return files\n    .filter((f) => ROUTE_EXTENSIONS.some((ext) => f.endsWith(ext)))\n    .map((filePath) => parseFilePath(filePath, defaultMode))\n    .sort(sortRoutes)\n}\n\nfunction parseFilePath(filePath: string, defaultMode: RenderMode): FileRoute {\n  // Remove extension\n  let route = filePath\n  for (const ext of ROUTE_EXTENSIONS) {\n    if (route.endsWith(ext)) {\n      route = route.slice(0, -ext.length)\n      break\n    }\n  }\n\n  const fileName = getFileName(route)\n  const isLayout = fileName === '_layout'\n  const isError = fileName === '_error'\n  const isLoading = fileName === '_loading'\n  const isCatchAll = route.includes('[...')\n\n  // Get directory path (strip groups for consistent grouping)\n  const parts = route.split('/')\n  parts.pop() // remove filename\n  const dirPath = parts\n    .filter((s) => !(s.startsWith('(') && s.endsWith(')')))\n    .join('/')\n\n  // Convert file path to URL pattern\n  const urlPath = filePathToUrlPath(route)\n  const depth = urlPath === '/' ? 0 : urlPath.split('/').filter(Boolean).length\n\n  return {\n    filePath,\n    urlPath,\n    dirPath,\n    depth,\n    isLayout,\n    isError,\n    isLoading,\n    isCatchAll,\n    renderMode: defaultMode,\n  }\n}\n\n/**\n * Convert a file path (without extension) to a URL path pattern.\n *\n * Examples:\n *   \"index\"            → \"/\"\n *   \"about\"            → \"/about\"\n *   \"users/index\"      → \"/users\"\n *   \"users/[id]\"       → \"/users/:id\"\n *   \"blog/[...slug]\"   → \"/blog/:slug*\"\n *   \"(auth)/login\"     → \"/login\"         (group stripped)\n *   \"_layout\"          → \"/\"              (layout marker)\n */\nexport function filePathToUrlPath(filePath: string): string {\n  const segments = filePath.split('/')\n  const urlSegments: string[] = []\n\n  for (const seg of segments) {\n    // Skip route groups \"(name)\"\n    if (seg.startsWith('(') && seg.endsWith(')')) continue\n\n    // Skip special files\n    if (seg === '_layout' || seg === '_error' || seg === '_loading') continue\n\n    // \"index\" maps to the parent path\n    if (seg === 'index') continue\n\n    // Catch-all: [...param] → :param*\n    const catchAll = seg.match(/^\\[\\.\\.\\.(\\w+)\\]$/)\n    if (catchAll) {\n      urlSegments.push(`:${catchAll[1]}*`)\n      continue\n    }\n\n    // Dynamic: [param] → :param\n    const dynamic = seg.match(/^\\[(\\w+)\\]$/)\n    if (dynamic) {\n      urlSegments.push(`:${dynamic[1]}`)\n      continue\n    }\n\n    urlSegments.push(seg)\n  }\n\n  const path = `/${urlSegments.join('/')}`\n  return path || '/'\n}\n\n/** Sort routes: static before dynamic, catch-all last. */\nfunction sortRoutes(a: FileRoute, b: FileRoute): number {\n  // Catch-all routes go last\n  if (a.isCatchAll !== b.isCatchAll) return a.isCatchAll ? 1 : -1\n  // Layouts go first within same depth\n  if (a.isLayout !== b.isLayout) return a.isLayout ? -1 : 1\n  // Static segments before dynamic\n  const aDynamic = a.urlPath.includes(':')\n  const bDynamic = b.urlPath.includes(':')\n  if (aDynamic !== bDynamic) return aDynamic ? 1 : -1\n  // Alphabetical\n  return a.urlPath.localeCompare(b.urlPath)\n}\n\nfunction getFileName(filePath: string): string {\n  const parts = filePath.split('/')\n  return parts[parts.length - 1] ?? ''\n}\n\n// ─── Route generation (for Vite plugin) ─────────────────────────────────────\n\n/** Internal tree node for building nested route structures. */\ninterface RouteNode {\n  /** Page routes at this directory level. */\n  pages: FileRoute[]\n  /** Layout file for this directory (if any). */\n  layout?: FileRoute\n  /** Error boundary file (if any). */\n  error?: FileRoute\n  /** Loading fallback file (if any). */\n  loading?: FileRoute\n  /** Child directories. */\n  children: Map<string, RouteNode>\n}\n\n/**\n * Group flat file routes into a directory tree.\n */\nfunction getOrCreateChild(node: RouteNode, segment: string): RouteNode {\n  let child = node.children.get(segment)\n  if (!child) {\n    child = { pages: [], children: new Map() }\n    node.children.set(segment, child)\n  }\n  return child\n}\n\nfunction resolveNode(root: RouteNode, dirPath: string): RouteNode {\n  let node = root\n  if (dirPath) {\n    for (const segment of dirPath.split('/')) {\n      node = getOrCreateChild(node, segment)\n    }\n  }\n  return node\n}\n\nfunction placeRoute(node: RouteNode, route: FileRoute) {\n  if (route.isLayout) node.layout = route\n  else if (route.isError) node.error = route\n  else if (route.isLoading) node.loading = route\n  else node.pages.push(route)\n}\n\nfunction buildRouteTree(routes: FileRoute[]): RouteNode {\n  const root: RouteNode = { pages: [], children: new Map() }\n  for (const route of routes) {\n    placeRoute(resolveNode(root, route.dirPath), route)\n  }\n  return root\n}\n\n/**\n * Generate a virtual module that exports a nested route tree.\n * Wires up layouts as parent routes with children, loaders, guards,\n * error/loading components, middleware, and meta from route module exports.\n */\nexport function generateRouteModule(\n  files: string[],\n  routesDir: string,\n): string {\n  const routes = parseFileRoutes(files)\n  const tree = buildRouteTree(routes)\n  const imports: string[] = []\n  let importCounter = 0\n\n  function nextImport(filePath: string, exportName = 'default'): string {\n    const name = `_${importCounter++}`\n    const fullPath = `${routesDir}/${filePath}`\n    if (exportName === 'default') {\n      imports.push(`import ${name} from \"${fullPath}\"`)\n    } else {\n      imports.push(`import { ${exportName} as ${name} } from \"${fullPath}\"`)\n    }\n    return name\n  }\n\n  function nextLazy(\n    filePath: string,\n    loadingName?: string,\n    errorName?: string,\n  ): string {\n    const name = `_${importCounter++}`\n    const fullPath = `${routesDir}/${filePath}`\n    const opts: string[] = []\n    if (loadingName) opts.push(`loading: ${loadingName}`)\n    if (errorName) opts.push(`error: ${errorName}`)\n    const optsStr = opts.length > 0 ? `, { ${opts.join(', ')} }` : ''\n    imports.push(`const ${name} = lazy(() => import(\"${fullPath}\")${optsStr})`)\n    return name\n  }\n\n  function nextModuleImport(filePath: string): string {\n    const name = `_m${importCounter++}`\n    const fullPath = `${routesDir}/${filePath}`\n    imports.push(`import * as ${name} from \"${fullPath}\"`)\n    return name\n  }\n\n  function generatePageRoute(\n    page: FileRoute,\n    indent: string,\n    loadingName: string | undefined,\n    errorName: string | undefined,\n  ): string {\n    const mod = nextModuleImport(page.filePath)\n    const comp = nextLazy(page.filePath, loadingName, errorName)\n\n    const props: string[] = [\n      `${indent}  path: ${JSON.stringify(page.urlPath)}`,\n      `${indent}  component: ${comp}`,\n      `${indent}  loader: ${mod}.loader`,\n      `${indent}  beforeEnter: ${mod}.guard`,\n      `${indent}  meta: ${mod}.meta`,\n    ]\n\n    if (errorName) {\n      props.push(`${indent}  errorComponent: ${mod}.error || ${errorName}`)\n    } else {\n      props.push(`${indent}  errorComponent: ${mod}.error`)\n    }\n\n    return `${indent}{\\n${props.join(',\\n')}\\n${indent}}`\n  }\n\n  function wrapWithLayout(\n    node: RouteNode,\n    children: string[],\n    indent: string,\n    errorName: string | undefined,\n  ): string {\n    const layout = node.layout as FileRoute\n    const layoutMod = nextModuleImport(layout.filePath)\n    const layoutComp = nextImport(layout.filePath, 'layout')\n\n    const props: string[] = [\n      `${indent}path: ${JSON.stringify(layout.urlPath)}`,\n      `${indent}component: ${layoutComp}`,\n      `${indent}loader: ${layoutMod}.loader`,\n      `${indent}beforeEnter: ${layoutMod}.guard`,\n      `${indent}meta: ${layoutMod}.meta`,\n    ]\n    if (errorName) {\n      props.push(`${indent}errorComponent: ${errorName}`)\n    }\n    if (children.length > 0) {\n      props.push(`${indent}children: [\\n${children.join(',\\n')}\\n${indent}]`)\n    }\n\n    return `${indent}{\\n${props.map((p) => `  ${p}`).join(',\\n')}\\n${indent}}`\n  }\n\n  /**\n   * Generate route definitions for a tree node.\n   */\n  function generateNode(node: RouteNode, depth: number): string[] {\n    const indent = '  '.repeat(depth + 1)\n\n    const errorName = node.error ? nextImport(node.error.filePath) : undefined\n    const loadingName = node.loading\n      ? nextImport(node.loading.filePath)\n      : undefined\n\n    const childRouteDefs: string[] = []\n    for (const [, childNode] of node.children) {\n      childRouteDefs.push(...generateNode(childNode, depth + 1))\n    }\n\n    const pageRouteDefs = node.pages.map((page) =>\n      generatePageRoute(page, indent, loadingName, errorName),\n    )\n\n    const allChildren = [...pageRouteDefs, ...childRouteDefs]\n\n    if (node.layout) {\n      return [wrapWithLayout(node, allChildren, indent, errorName)]\n    }\n    return allChildren\n  }\n\n  const routeDefs = generateNode(tree, 0)\n\n  return [\n    `import { lazy } from \"@pyreon/router\"`,\n    '',\n    ...imports,\n    '',\n    // Filter out undefined properties at runtime\n    `function clean(routes) {`,\n    `  return routes.map(r => {`,\n    `    const c = {}`,\n    `    for (const k in r) if (r[k] !== undefined) c[k] = r[k]`,\n    `    if (c.children) c.children = clean(c.children)`,\n    `    return c`,\n    `  })`,\n    `}`,\n    '',\n    `export const routes = clean([`,\n    routeDefs.join(',\\n'),\n    `])`,\n  ].join('\\n')\n}\n\n/**\n * Scan a directory for route files.\n * Returns paths relative to the routes directory.\n */\nexport async function scanRouteFiles(routesDir: string): Promise<string[]> {\n  const { readdir } = await import('node:fs/promises')\n  const { join, relative } = await import('node:path')\n\n  const files: string[] = []\n\n  async function walk(dir: string) {\n    const entries = await readdir(dir, { withFileTypes: true })\n    for (const entry of entries) {\n      const fullPath = join(dir, entry.name)\n      if (entry.isDirectory()) {\n        await walk(fullPath)\n      } else if (ROUTE_EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {\n        files.push(relative(routesDir, fullPath))\n      }\n    }\n  }\n\n  await walk(routesDir)\n  return files\n}\n"],"mappings":"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"}

package/lib/image-plugin.js

@@ -0,0 +1,289 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, extname, join } from "node:path";
+
+//#region src/image-plugin.ts
+let sharpWarned = false;
+function warnSharpMissing() {
+	if (sharpWarned) return;
+	sharpWarned = true;
+	console.warn("\n[zero:image] sharp not installed — images will not be optimized. Install for full support: bun add -D sharp\n");
+}
+const IMAGE_EXT_RE = /\.(jpe?g|png|webp|avif)$/i;
+/**
+* Zero image processing Vite plugin.
+*
+* Transforms image imports with query params into optimized responsive images:
+*
+* @example
+* // vite.config.ts
+* import { imagePlugin } from "@pyreon/zero/image-plugin"
+*
+* export default {
+*   plugins: [
+*     pyreon(),
+*     zero(),
+*     imagePlugin({ widths: [480, 960, 1440], quality: 85 }),
+*   ],
+* }
+*
+* @example
+* // In a component — import with ?optimize
+* import hero from "./images/hero.jpg?optimize"
+* // hero = { src, srcset, width, height, placeholder }
+*
+* <Image {...hero} alt="Hero" priority />
+*/
+function imagePlugin(config = {}) {
+	const defaultWidths = config.widths ?? [
+		640,
+		1024,
+		1920
+	];
+	const defaultFormats = config.formats ?? ["webp"];
+	const quality = config.quality ?? 80;
+	const placeholderSize = config.placeholderSize ?? 16;
+	const outSubDir = config.outDir ?? "assets/img";
+	const include = config.include ?? IMAGE_EXT_RE;
+	let root = "";
+	let outDir = "";
+	let isBuild = false;
+	return {
+		name: "pyreon-zero-images",
+		enforce: "pre",
+		configResolved(resolvedConfig) {
+			root = resolvedConfig.root;
+			outDir = resolvedConfig.build.outDir;
+			isBuild = resolvedConfig.command === "build";
+		},
+		async resolveId(id) {
+			if (id.includes("?optimize") && include.test(id.split("?")[0])) return `\0virtual:zero-image:${id}`;
+			return null;
+		},
+		async load(id) {
+			if (!id.startsWith("\0virtual:zero-image:")) return null;
+			const rawPath = id.replace("\0virtual:zero-image:", "").split("?")[0] ?? id;
+			const absPath = rawPath.startsWith("/") ? join(root, "public", rawPath) : rawPath;
+			if (!isBuild) {
+				const result = await loadDevImage(absPath, rawPath, placeholderSize);
+				return `export default ${JSON.stringify(result)}`;
+			}
+			const processed = await processImage(absPath, {
+				widths: defaultWidths,
+				formats: defaultFormats,
+				quality,
+				placeholderSize,
+				outSubDir,
+				outDir: join(root, outDir)
+			});
+			await emitProcessedSources(processed, outSubDir, this);
+			rebuildFormatSrcsets(processed, absPath);
+			return `export default ${JSON.stringify(processed)}`;
+		}
+	};
+}
+async function loadDevImage(absPath, rawPath, placeholderSize) {
+	const metadata = await getImageMetadata(absPath);
+	const publicPath = rawPath.startsWith("/") ? rawPath : `/@fs/${absPath}`;
+	return {
+		src: publicPath,
+		srcset: "",
+		width: metadata.width,
+		height: metadata.height,
+		placeholder: await generateBlurPlaceholder(absPath, placeholderSize),
+		formats: [],
+		sources: [{
+			src: publicPath,
+			width: metadata.width,
+			format: "original"
+		}]
+	};
+}
+async function emitProcessedSources(processed, outSubDir, ctx) {
+	for (const source of processed.sources) {
+		const fileName = join(outSubDir, basename(source.src));
+		const content = await readFile(source.src);
+		ctx.emitFile({
+			type: "asset",
+			fileName,
+			source: content
+		});
+		source.src = `/${fileName}`;
+	}
+}
+function rebuildFormatSrcsets(processed, fallbackPath) {
+	const formatGroups = /* @__PURE__ */ new Map();
+	for (const s of processed.sources) {
+		let group = formatGroups.get(s.format);
+		if (!group) {
+			group = [];
+			formatGroups.set(s.format, group);
+		}
+		group.push(`${s.src} ${s.width}w`);
+	}
+	processed.formats = [...formatGroups.entries()].map(([fmt, entries]) => ({
+		type: `image/${fmt}`,
+		srcset: entries.join(", ")
+	}));
+	processed.srcset = processed.formats.at(-1)?.srcset ?? "";
+	processed.src = processed.sources.at(-1)?.src ?? fallbackPath;
+}
+async function processImage(absPath, opts) {
+	const metadata = await getImageMetadata(absPath);
+	const name = basename(absPath, extname(absPath));
+	const sources = [];
+	const processedDir = join(opts.outDir, opts.outSubDir);
+	if (!existsSync(processedDir)) await mkdir(processedDir, { recursive: true });
+	for (const format of opts.formats) for (const targetWidth of opts.widths) {
+		const width = Math.min(targetWidth, metadata.width);
+		const outPath = join(processedDir, `${name}-${width}.${format}`);
+		await resizeImage(absPath, outPath, width, format, opts.quality);
+		sources.push({
+			src: outPath,
+			width,
+			format
+		});
+	}
+	const formatGroups = /* @__PURE__ */ new Map();
+	for (const s of sources) {
+		let group = formatGroups.get(s.format);
+		if (!group) {
+			group = [];
+			formatGroups.set(s.format, group);
+		}
+		group.push({
+			src: s.src,
+			width: s.width
+		});
+	}
+	const formats = [...formatGroups.entries()].map(([fmt, group]) => ({
+		type: `image/${fmt === "jpeg" ? "jpeg" : fmt}`,
+		srcset: group.map((s) => `${s.src} ${s.width}w`).join(", ")
+	}));
+	const fallbackFormat = formats[formats.length - 1];
+	const fallbackSources = formatGroups.get([...formatGroups.keys()].pop());
+	const placeholder = await generateBlurPlaceholder(absPath, opts.placeholderSize);
+	return {
+		src: fallbackSources[fallbackSources.length - 1]?.src ?? absPath,
+		srcset: fallbackFormat?.srcset ?? "",
+		width: metadata.width,
+		height: metadata.height,
+		placeholder,
+		formats,
+		sources
+	};
+}
+/**
+* Read basic image metadata.
+* Uses minimal binary header parsing — no external dependencies.
+*/
+async function getImageMetadata(absPath) {
+	const buffer = await readFile(absPath);
+	const ext = extname(absPath).toLowerCase();
+	if (ext === ".png") return {
+		width: buffer.readUInt32BE(16),
+		height: buffer.readUInt32BE(20),
+		format: "png"
+	};
+	if (ext === ".jpg" || ext === ".jpeg") return {
+		...parseJpegDimensions(buffer),
+		format: "jpeg"
+	};
+	if (ext === ".webp") return {
+		...parseWebPDimensions(buffer),
+		format: "webp"
+	};
+	return {
+		width: 0,
+		height: 0,
+		format: ext.slice(1)
+	};
+}
+/** @internal Exported for testing */
+function parseJpegDimensions(buffer) {
+	let offset = 2;
+	while (offset < buffer.length) {
+		if (buffer[offset] !== 255) break;
+		const marker = buffer[offset + 1];
+		if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
+			const height = buffer.readUInt16BE(offset + 5);
+			return {
+				width: buffer.readUInt16BE(offset + 7),
+				height
+			};
+		}
+		const length = buffer.readUInt16BE(offset + 2);
+		offset += 2 + length;
+	}
+	return {
+		width: 0,
+		height: 0
+	};
+}
+/** @internal Exported for testing */
+function parseWebPDimensions(buffer) {
+	const chunk = buffer.toString("ascii", 12, 16);
+	if (chunk === "VP8 ") return {
+		width: buffer.readUInt16LE(26) & 16383,
+		height: buffer.readUInt16LE(28) & 16383
+	};
+	if (chunk === "VP8L") {
+		const bits = buffer.readUInt32LE(21);
+		return {
+			width: (bits & 16383) + 1,
+			height: (bits >> 14 & 16383) + 1
+		};
+	}
+	if (chunk === "VP8X") return {
+		width: 1 + ((buffer[24] | buffer[25] << 8 | buffer[26] << 16) & 16777215),
+		height: 1 + ((buffer[27] | buffer[28] << 8 | buffer[29] << 16) & 16777215)
+	};
+	return {
+		width: 0,
+		height: 0
+	};
+}
+/**
+* Resize an image using native platform capabilities.
+* Uses sharp if available, falls back to canvas API.
+*/
+async function resizeImage(input, output, width, format, quality) {
+	try {
+		let pipeline = (await import("sharp").then((m) => m.default ?? m))(input).resize(width);
+		switch (format) {
+			case "webp":
+				pipeline = pipeline.webp({ quality });
+				break;
+			case "avif":
+				pipeline = pipeline.avif({ quality });
+				break;
+			case "jpeg":
+				pipeline = pipeline.jpeg({
+					quality,
+					mozjpeg: true
+				});
+				break;
+			case "png":
+				pipeline = pipeline.png({ compressionLevel: 9 });
+				break;
+		}
+		await pipeline.toFile(output);
+	} catch {
+		warnSharpMissing();
+		await writeFile(output, await readFile(input));
+	}
+}
+/**
+* Generate a tiny blur placeholder as a base64 data URI.
+*/
+async function generateBlurPlaceholder(input, size) {
+	try {
+		return `data:image/webp;base64,${(await (await import("sharp").then((m) => m.default ?? m))(input).resize(size, size, { fit: "inside" }).blur(2).webp({ quality: 20 }).toBuffer()).toString("base64")}`;
+	} catch {
+		return "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1' height='1'%3E%3C/svg%3E";
+	}
+}
+
+//#endregion
+export { imagePlugin, parseJpegDimensions, parseWebPDimensions };
+//# sourceMappingURL=image-plugin.js.map

package/lib/image-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-plugin.js","names":[],"sources":["../src/image-plugin.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { mkdir, readFile, writeFile } from 'node:fs/promises'\nimport { basename, extname, join } from 'node:path'\nimport type { Plugin } from 'vite'\n\nlet sharpWarned = false\nfunction warnSharpMissing() {\n  if (sharpWarned) return\n  sharpWarned = true\n  // biome-ignore lint/suspicious/noConsole: intentional build-time warning\n  console.warn(\n    '\\n[zero:image] sharp not installed — images will not be optimized. Install for full support: bun add -D sharp\\n',\n  )\n}\n\n// ─── Image processing Vite plugin ──────────────────────────────────────────\n//\n// Processes images at build time:\n// - Generates multiple sizes for responsive srcset\n// - Converts to modern formats (WebP, AVIF)\n// - Creates tiny blur placeholders (base64 inline)\n// - Outputs optimized images to the build directory\n//\n// Usage in code:\n//   import heroImg from \"./hero.jpg?optimize\"\n//   // → { src, srcset, width, height, placeholder }\n//\n// Or use the component helper:\n//   import { Image } from \"@pyreon/zero/image\"\n//   <Image src=\"/hero.jpg\" width={1920} height={1080} optimize />\n\nexport interface ImagePluginConfig {\n  /** Output directory for processed images. Default: \"assets/img\" */\n  outDir?: string\n  /** Default widths for responsive images. Default: [640, 1024, 1920] */\n  widths?: number[]\n  /** Output formats. Default: [\"webp\"] */\n  formats?: ImageFormat[]\n  /** Quality for lossy formats (1-100). Default: 80 */\n  quality?: number\n  /** Blur placeholder size in px. Default: 16 */\n  placeholderSize?: number\n  /** File patterns to process. Default: /\\.(jpe?g|png|webp|avif)$/i */\n  include?: RegExp\n}\n\nexport type ImageFormat = 'webp' | 'avif' | 'jpeg' | 'png'\n\n/** Per-format source set for <picture> <source> elements. */\nexport interface FormatSource {\n  /** MIME type. e.g. \"image/webp\", \"image/avif\" */\n  type: string\n  /** srcset string for this format. e.g. \"/img-640.webp 640w, /img-1920.webp 1920w\" */\n  srcset: string\n}\n\nexport interface ProcessedImage {\n  /** Fallback source path (last format, largest width). */\n  src: string\n  /** Fallback srcset string (last format). */\n  srcset: string\n  /** Intrinsic width. */\n  width: number\n  /** Intrinsic height. */\n  height: number\n  /** Base64 blur placeholder data URI. */\n  placeholder: string\n  /** Per-format source sets for <picture> element. Ordered by priority (best format first). */\n  formats: FormatSource[]\n  /** Flat list of all sources. */\n  sources: Array<{ src: string; width: number; format: string }>\n}\n\nconst IMAGE_EXT_RE = /\\.(jpe?g|png|webp|avif)$/i\n\n/**\n * Zero image processing Vite plugin.\n *\n * Transforms image imports with query params into optimized responsive images:\n *\n * @example\n * // vite.config.ts\n * import { imagePlugin } from \"@pyreon/zero/image-plugin\"\n *\n * export default {\n *   plugins: [\n *     pyreon(),\n *     zero(),\n *     imagePlugin({ widths: [480, 960, 1440], quality: 85 }),\n *   ],\n * }\n *\n * @example\n * // In a component — import with ?optimize\n * import hero from \"./images/hero.jpg?optimize\"\n * // hero = { src, srcset, width, height, placeholder }\n *\n * <Image {...hero} alt=\"Hero\" priority />\n */\nexport function imagePlugin(config: ImagePluginConfig = {}): Plugin {\n  const defaultWidths = config.widths ?? [640, 1024, 1920]\n  const defaultFormats = config.formats ?? ['webp']\n  const quality = config.quality ?? 80\n  const placeholderSize = config.placeholderSize ?? 16\n  const outSubDir = config.outDir ?? 'assets/img'\n  const include = config.include ?? IMAGE_EXT_RE\n\n  let root = ''\n  let outDir = ''\n  let isBuild = false\n\n  return {\n    name: 'pyreon-zero-images',\n    enforce: 'pre',\n\n    configResolved(resolvedConfig) {\n      root = resolvedConfig.root\n      outDir = resolvedConfig.build.outDir\n      isBuild = resolvedConfig.command === 'build'\n    },\n\n    async resolveId(id) {\n      // Handle ?optimize query on image imports\n      if (id.includes('?optimize') && include.test(id.split('?')[0]!)) {\n        return `\\0virtual:zero-image:${id}`\n      }\n      return null\n    },\n\n    async load(id) {\n      if (!id.startsWith('\\0virtual:zero-image:')) return null\n\n      const rawPath =\n        id.replace('\\0virtual:zero-image:', '').split('?')[0] ?? id\n      const absPath = rawPath.startsWith('/')\n        ? join(root, 'public', rawPath)\n        : rawPath\n\n      if (!isBuild) {\n        const result = await loadDevImage(absPath, rawPath, placeholderSize)\n        return `export default ${JSON.stringify(result)}`\n      }\n\n      const processed = await processImage(absPath, {\n        widths: defaultWidths,\n        formats: defaultFormats,\n        quality,\n        placeholderSize,\n        outSubDir,\n        outDir: join(root, outDir),\n      })\n\n      await emitProcessedSources(processed, outSubDir, this)\n      rebuildFormatSrcsets(processed, absPath)\n\n      return `export default ${JSON.stringify(processed)}`\n    },\n  }\n}\n\nasync function loadDevImage(\n  absPath: string,\n  rawPath: string,\n  placeholderSize: number,\n): Promise<ProcessedImage> {\n  const metadata = await getImageMetadata(absPath)\n  const publicPath = rawPath.startsWith('/') ? rawPath : `/@fs/${absPath}`\n\n  return {\n    src: publicPath,\n    srcset: '',\n    width: metadata.width,\n    height: metadata.height,\n    placeholder: await generateBlurPlaceholder(absPath, placeholderSize),\n    formats: [],\n    sources: [{ src: publicPath, width: metadata.width, format: 'original' }],\n  }\n}\n\nasync function emitProcessedSources(\n  processed: ProcessedImage,\n  outSubDir: string,\n  ctx: {\n    emitFile: (f: {\n      type: 'asset'\n      fileName: string\n      source: Uint8Array\n    }) => void\n  },\n) {\n  for (const source of processed.sources) {\n    const fileName = join(outSubDir, basename(source.src))\n    const content = await readFile(source.src)\n    ctx.emitFile({ type: 'asset', fileName, source: content })\n    source.src = `/${fileName}`\n  }\n}\n\nfunction rebuildFormatSrcsets(processed: ProcessedImage, fallbackPath: string) {\n  const formatGroups = new Map<string, string[]>()\n  for (const s of processed.sources) {\n    let group = formatGroups.get(s.format)\n    if (!group) {\n      group = []\n      formatGroups.set(s.format, group)\n    }\n    group.push(`${s.src} ${s.width}w`)\n  }\n  processed.formats = [...formatGroups.entries()].map(([fmt, entries]) => ({\n    type: `image/${fmt}`,\n    srcset: entries.join(', '),\n  }))\n\n  const lastFormat = processed.formats.at(-1)\n  processed.srcset = lastFormat?.srcset ?? ''\n  processed.src = processed.sources.at(-1)?.src ?? fallbackPath\n}\n\n// ─── Image processing utilities ─────────────────────────────────────────────\n\ninterface ProcessOptions {\n  widths: number[]\n  formats: ImageFormat[]\n  quality: number\n  placeholderSize: number\n  outSubDir: string\n  outDir: string\n}\n\nasync function processImage(\n  absPath: string,\n  opts: ProcessOptions,\n): Promise<ProcessedImage> {\n  const metadata = await getImageMetadata(absPath)\n  const ext = extname(absPath)\n  const name = basename(absPath, ext)\n  const sources: Array<{ src: string; width: number; format: string }> = []\n\n  // Ensure output directory exists\n  const processedDir = join(opts.outDir, opts.outSubDir)\n  if (!existsSync(processedDir)) {\n    await mkdir(processedDir, { recursive: true })\n  }\n\n  // Generate resized variants — iterate formats first so sources are grouped by format\n  for (const format of opts.formats) {\n    for (const targetWidth of opts.widths) {\n      // Don't upscale\n      const width = Math.min(targetWidth, metadata.width)\n      const outName = `${name}-${width}.${format}`\n      const outPath = join(processedDir, outName)\n\n      await resizeImage(absPath, outPath, width, format, opts.quality)\n      sources.push({ src: outPath, width, format })\n    }\n  }\n\n  // Build per-format source sets for <picture>\n  const formatGroups = new Map<string, Array<{ src: string; width: number }>>()\n  for (const s of sources) {\n    let group = formatGroups.get(s.format)\n    if (!group) {\n      group = []\n      formatGroups.set(s.format, group)\n    }\n    group.push({ src: s.src, width: s.width })\n  }\n\n  const formats: FormatSource[] = [...formatGroups.entries()].map(\n    ([fmt, group]) => ({\n      type: `image/${fmt === 'jpeg' ? 'jpeg' : fmt}`,\n      srcset: group.map((s) => `${s.src} ${s.width}w`).join(', '),\n    }),\n  )\n\n  // Fallback: last format's srcset\n  const fallbackFormat = formats[formats.length - 1]\n  const fallbackSources = formatGroups.get([...formatGroups.keys()].pop()!)!\n\n  // Generate blur placeholder\n  const placeholder = await generateBlurPlaceholder(\n    absPath,\n    opts.placeholderSize,\n  )\n\n  return {\n    src: fallbackSources[fallbackSources.length - 1]?.src ?? absPath,\n    srcset: fallbackFormat?.srcset ?? '',\n    width: metadata.width,\n    height: metadata.height,\n    placeholder,\n    formats,\n    sources,\n  }\n}\n\ninterface ImageMetadata {\n  width: number\n  height: number\n  format: string\n}\n\n/**\n * Read basic image metadata.\n * Uses minimal binary header parsing — no external dependencies.\n */\nasync function getImageMetadata(absPath: string): Promise<ImageMetadata> {\n  const buffer = await readFile(absPath)\n  const ext = extname(absPath).toLowerCase()\n\n  if (ext === '.png') {\n    // PNG: width at bytes 16-19, height at 20-23 (big-endian)\n    const width = buffer.readUInt32BE(16)\n    const height = buffer.readUInt32BE(20)\n    return { width, height, format: 'png' }\n  }\n\n  if (ext === '.jpg' || ext === '.jpeg') {\n    // JPEG: scan for SOF markers\n    const dimensions = parseJpegDimensions(buffer)\n    return { ...dimensions, format: 'jpeg' }\n  }\n\n  if (ext === '.webp') {\n    // WebP: VP8 header\n    const dimensions = parseWebPDimensions(buffer)\n    return { ...dimensions, format: 'webp' }\n  }\n\n  // Fallback\n  return { width: 0, height: 0, format: ext.slice(1) }\n}\n\n/** @internal Exported for testing */\nexport function parseJpegDimensions(buffer: Buffer): {\n  width: number\n  height: number\n} {\n  let offset = 2 // Skip SOI marker\n  while (offset < buffer.length) {\n    if (buffer[offset] !== 0xff) break\n    const marker = buffer[offset + 1]!\n    // SOF markers (0xC0-0xCF except 0xC4, 0xC8, 0xCC)\n    if (\n      marker >= 0xc0 &&\n      marker <= 0xcf &&\n      marker !== 0xc4 &&\n      marker !== 0xc8 &&\n      marker !== 0xcc\n    ) {\n      const height = buffer.readUInt16BE(offset + 5)\n      const width = buffer.readUInt16BE(offset + 7)\n      return { width, height }\n    }\n    const length = buffer.readUInt16BE(offset + 2)\n    offset += 2 + length\n  }\n  return { width: 0, height: 0 }\n}\n\n/** @internal Exported for testing */\nexport function parseWebPDimensions(buffer: Buffer): {\n  width: number\n  height: number\n} {\n  // RIFF header: bytes 0-3 = \"RIFF\", 8-11 = \"WEBP\"\n  const chunk = buffer.toString('ascii', 12, 16)\n  if (chunk === 'VP8 ') {\n    // Lossy VP8\n    const width = buffer.readUInt16LE(26) & 0x3fff\n    const height = buffer.readUInt16LE(28) & 0x3fff\n    return { width, height }\n  }\n  if (chunk === 'VP8L') {\n    // Lossless VP8L\n    const bits = buffer.readUInt32LE(21)\n    const width = (bits & 0x3fff) + 1\n    const height = ((bits >> 14) & 0x3fff) + 1\n    return { width, height }\n  }\n  if (chunk === 'VP8X') {\n    // Extended VP8X\n    const width =\n      1 + ((buffer[24]! | (buffer[25]! << 8) | (buffer[26]! << 16)) & 0xffffff)\n    const height =\n      1 + ((buffer[27]! | (buffer[28]! << 8) | (buffer[29]! << 16)) & 0xffffff)\n    return { width, height }\n  }\n  return { width: 0, height: 0 }\n}\n\n/**\n * Resize an image using native platform capabilities.\n * Uses sharp if available, falls back to canvas API.\n */\nasync function resizeImage(\n  input: string,\n  output: string,\n  width: number,\n  format: ImageFormat,\n  quality: number,\n): Promise<void> {\n  try {\n    // Try sharp (the standard Node.js image processing library)\n    const sharp = await import('sharp').then((m) => m.default ?? m)\n    let pipeline = sharp(input).resize(width)\n\n    switch (format) {\n      case 'webp':\n        pipeline = pipeline.webp({ quality })\n        break\n      case 'avif':\n        pipeline = pipeline.avif({ quality })\n        break\n      case 'jpeg':\n        pipeline = pipeline.jpeg({ quality, mozjpeg: true })\n        break\n      case 'png':\n        pipeline = pipeline.png({ compressionLevel: 9 })\n        break\n    }\n\n    await pipeline.toFile(output)\n  } catch {\n    // sharp not available — copy original as fallback\n    warnSharpMissing()\n    const content = await readFile(input)\n    await writeFile(output, content)\n  }\n}\n\n/**\n * Generate a tiny blur placeholder as a base64 data URI.\n */\nasync function generateBlurPlaceholder(\n  input: string,\n  size: number,\n): Promise<string> {\n  try {\n    const sharp = await import('sharp').then((m) => m.default ?? m)\n    const buffer = await sharp(input)\n      .resize(size, size, { fit: 'inside' })\n      .blur(2)\n      .webp({ quality: 20 })\n      .toBuffer()\n\n    return `data:image/webp;base64,${buffer.toString('base64')}`\n  } catch {\n    // sharp not available — return a transparent placeholder\n    return \"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1' height='1'%3E%3C/svg%3E\"\n  }\n}\n"],"mappings":"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"}