@pyreon/zero 0.3.0 → 0.4.0

package/lib/client.js

@@ -13,7 +13,7 @@ function createApp(options) {
 	const router = createRouter({
 		routes: options.routes,
 		mode: options.routerMode ?? "history",
-		url: options.url,
+		...options.url ? { url: options.url } : {},
 		scrollBehavior: "top"
 	});
 	const Layout = options.layout ?? DefaultLayout;
@@ -46,7 +46,7 @@ function startClient(options) {
 	const { App } = createApp({
 		routes: options.routes,
 		routerMode: "history",
-		layout: options.layout
+		...options.layout ? { layout: options.layout } : {}
 	});
 	const vnode = h(App, null);
 	if (container.childNodes.length > 0) return hydrateRoot(container, vnode);

package/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../src/app.ts","../src/client.ts"],"sourcesContent":["import type { ComponentFn, Props } from '@pyreon/core'\nimport { Fragment, h } from '@pyreon/core'\nimport { HeadProvider } from '@pyreon/head'\nimport type { RouteRecord } from '@pyreon/router'\nimport { createRouter, RouterProvider, RouterView } from '@pyreon/router'\n\n// ─── App assembly ────────────────────────────────────────────────────────────\n\nexport interface CreateAppOptions {\n  /** Route definitions (from file-based routing or manual). */\n  routes: RouteRecord[]\n\n  /** Router mode. Default: \"history\" for SSR, \"hash\" for SPA. */\n  routerMode?: 'hash' | 'history'\n\n  /** Initial URL for SSR. */\n  url?: string\n\n  /** Root layout component wrapping all routes. */\n  layout?: ComponentFn\n\n  /** Global error component. */\n  errorComponent?: ComponentFn\n}\n\n/**\n * Create a full Zero app — assembles router, head provider, and root layout.\n *\n * Used internally by entry-server and entry-client.\n */\nexport function createApp(options: CreateAppOptions) {\n  const router = createRouter({\n    routes: options.routes,\n    mode: options.routerMode ?? 'history',\n    url: options.url,\n    scrollBehavior: 'top',\n  })\n\n  const Layout = options.layout ?? DefaultLayout\n\n  function App() {\n    return h(\n      HeadProvider,\n      null,\n      h(\n        RouterProvider as ComponentFn<Props>,\n        { router },\n        h(Layout, null, h(RouterView as ComponentFn<Props>, null)),\n      ),\n    )\n  }\n\n  return { App, router }\n}\n\nfunction DefaultLayout(props: Props) {\n  return h(\n    Fragment,\n    null,\n    ...(Array.isArray(props.children) ? props.children : [props.children]),\n  )\n}\n","import type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport type { RouteRecord } from '@pyreon/router'\nimport { hydrateRoot, mount } from '@pyreon/runtime-dom'\nimport { createApp } from './app'\n\n// ─── Client entry factory ───────────────────────────────────────────────────\n\nexport interface StartClientOptions {\n  /** Route definitions. */\n  routes: RouteRecord[]\n  /** Root layout component. */\n  layout?: ComponentFn\n}\n\n/**\n * Start the client-side app — hydrates SSR content or mounts fresh for SPA.\n *\n * @example\n * import { routes } from \"virtual:zero/routes\"\n * import { startClient } from \"@pyreon/zero/client\"\n *\n * startClient({ routes })\n */\nexport function startClient(options: StartClientOptions) {\n  const container = document.getElementById('app')\n  if (!container) throw new Error('[zero] Missing #app container element')\n\n  const { App } = createApp({\n    routes: options.routes,\n    routerMode: 'history',\n    layout: options.layout,\n  })\n\n  const vnode = h(App, null)\n\n  // If container has SSR content, hydrate. Otherwise mount fresh.\n  if (container.childNodes.length > 0) {\n    return hydrateRoot(container, vnode)\n  }\n\n  return mount(vnode, container)\n}\n"],"mappings":";;;;;;;;;;;AA8BA,SAAgB,UAAU,SAA2B;CACnD,MAAM,SAAS,aAAa;EAC1B,QAAQ,QAAQ;EAChB,MAAM,QAAQ,cAAc;EAC5B,KAAK,QAAQ;EACb,gBAAgB;EACjB,CAAC;CAEF,MAAM,SAAS,QAAQ,UAAU;CAEjC,SAAS,MAAM;AACb,SAAO,EACL,cACA,MACA,EACE,gBACA,EAAE,QAAQ,EACV,EAAE,QAAQ,MAAM,EAAE,YAAkC,KAAK,CAAC,CAC3D,CACF;;AAGH,QAAO;EAAE;EAAK;EAAQ;;AAGxB,SAAS,cAAc,OAAc;AACnC,QAAO,EACL,UACA,MACA,GAAI,MAAM,QAAQ,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,MAAM,SAAS,CACtE;;;;;;;;;;;;;;ACpCH,SAAgB,YAAY,SAA6B;CACvD,MAAM,YAAY,SAAS,eAAe,MAAM;AAChD,KAAI,CAAC,UAAW,OAAM,IAAI,MAAM,wCAAwC;CAExE,MAAM,EAAE,QAAQ,UAAU;EACxB,QAAQ,QAAQ;EAChB,YAAY;EACZ,QAAQ,QAAQ;EACjB,CAAC;CAEF,MAAM,QAAQ,EAAE,KAAK,KAAK;AAG1B,KAAI,UAAU,WAAW,SAAS,EAChC,QAAO,YAAY,WAAW,MAAM;AAGtC,QAAO,MAAM,OAAO,UAAU"}
+{"version":3,"file":"client.js","names":[],"sources":["../src/app.ts","../src/client.ts"],"sourcesContent":["import type { ComponentFn, Props } from '@pyreon/core'\nimport { Fragment, h } from '@pyreon/core'\nimport { HeadProvider } from '@pyreon/head'\nimport type { RouteRecord } from '@pyreon/router'\nimport { createRouter, RouterProvider, RouterView } from '@pyreon/router'\n\n// ─── App assembly ────────────────────────────────────────────────────────────\n\nexport interface CreateAppOptions {\n  /** Route definitions (from file-based routing or manual). */\n  routes: RouteRecord[]\n\n  /** Router mode. Default: \"history\" for SSR, \"hash\" for SPA. */\n  routerMode?: 'hash' | 'history'\n\n  /** Initial URL for SSR. */\n  url?: string\n\n  /** Root layout component wrapping all routes. */\n  layout?: ComponentFn\n\n  /** Global error component. */\n  errorComponent?: ComponentFn\n}\n\n/**\n * Create a full Zero app — assembles router, head provider, and root layout.\n *\n * Used internally by entry-server and entry-client.\n */\nexport function createApp(options: CreateAppOptions) {\n  const router = createRouter({\n    routes: options.routes,\n    mode: options.routerMode ?? 'history',\n    ...(options.url ? { url: options.url } : {}),\n    scrollBehavior: 'top',\n  })\n\n  const Layout = options.layout ?? DefaultLayout\n\n  function App() {\n    return h(\n      HeadProvider,\n      null,\n      h(\n        RouterProvider as ComponentFn<Props>,\n        { router },\n        h(Layout, null, h(RouterView as ComponentFn<Props>, null)),\n      ),\n    )\n  }\n\n  return { App, router }\n}\n\nfunction DefaultLayout(props: Props) {\n  return h(\n    Fragment,\n    null,\n    ...(Array.isArray(props.children) ? props.children : [props.children]),\n  )\n}\n","import type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport type { RouteRecord } from '@pyreon/router'\nimport { hydrateRoot, mount } from '@pyreon/runtime-dom'\nimport { createApp } from './app'\n\n// ─── Client entry factory ───────────────────────────────────────────────────\n\nexport interface StartClientOptions {\n  /** Route definitions. */\n  routes: RouteRecord[]\n  /** Root layout component. */\n  layout?: ComponentFn\n}\n\n/**\n * Start the client-side app — hydrates SSR content or mounts fresh for SPA.\n *\n * @example\n * import { routes } from \"virtual:zero/routes\"\n * import { startClient } from \"@pyreon/zero/client\"\n *\n * startClient({ routes })\n */\nexport function startClient(options: StartClientOptions) {\n  const container = document.getElementById('app')\n  if (!container) throw new Error('[zero] Missing #app container element')\n\n  const { App } = createApp({\n    routes: options.routes,\n    routerMode: 'history',\n    ...(options.layout ? { layout: options.layout } : {}),\n  })\n\n  const vnode = h(App, null)\n\n  // If container has SSR content, hydrate. Otherwise mount fresh.\n  if (container.childNodes.length > 0) {\n    return hydrateRoot(container, vnode)\n  }\n\n  return mount(vnode, container)\n}\n"],"mappings":";;;;;;;;;;;AA8BA,SAAgB,UAAU,SAA2B;CACnD,MAAM,SAAS,aAAa;EAC1B,QAAQ,QAAQ;EAChB,MAAM,QAAQ,cAAc;EAC5B,GAAI,QAAQ,MAAM,EAAE,KAAK,QAAQ,KAAK,GAAG,EAAE;EAC3C,gBAAgB;EACjB,CAAC;CAEF,MAAM,SAAS,QAAQ,UAAU;CAEjC,SAAS,MAAM;AACb,SAAO,EACL,cACA,MACA,EACE,gBACA,EAAE,QAAQ,EACV,EAAE,QAAQ,MAAM,EAAE,YAAkC,KAAK,CAAC,CAC3D,CACF;;AAGH,QAAO;EAAE;EAAK;EAAQ;;AAGxB,SAAS,cAAc,OAAc;AACnC,QAAO,EACL,UACA,MACA,GAAI,MAAM,QAAQ,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,MAAM,SAAS,CACtE;;;;;;;;;;;;;;ACpCH,SAAgB,YAAY,SAA6B;CACvD,MAAM,YAAY,SAAS,eAAe,MAAM;AAChD,KAAI,CAAC,UAAW,OAAM,IAAI,MAAM,wCAAwC;CAExE,MAAM,EAAE,QAAQ,UAAU;EACxB,QAAQ,QAAQ;EAChB,YAAY;EACZ,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,QAAQ,GAAG,EAAE;EACrD,CAAC;CAEF,MAAM,QAAQ,EAAE,KAAK,KAAK;AAG1B,KAAI,UAAU,WAAW,SAAS,EAChC,QAAO,YAAY,WAAW,MAAM;AAGtC,QAAO,MAAM,OAAO,UAAU"}

package/lib/font.js

@@ -25,24 +25,25 @@ function resolveGoogleFont(input) {
 * Variable with italic: "Inter:ital,wght@100..900"
 */
 function parseGoogleFamily(input) {
-	const [familyPart, spec] = input.split(":");
-	const family = familyPart?.trim();
+	const parts = input.split(":");
+	const family = (parts[0] ?? "").trim();
+	const spec = parts[1];
 	let italic = false;
 	if (spec) {
 		italic = spec.includes("ital");
 		const rangeMatch = spec.match(/wght@(\d+)\.\.(\d+)/);
-		if (rangeMatch) return {
+		if (rangeMatch && rangeMatch[1] && rangeMatch[2]) return {
 			family,
 			italic,
 			variable: true,
 			weightRange: [Number(rangeMatch[1]), Number(rangeMatch[2])]
 		};
 		const weightMatch = spec.match(/wght@([\d;]+)/);
-		if (weightMatch) return {
+		if (weightMatch && weightMatch[1]) return {
 			family,
 			italic,
 			variable: false,
-			weights: weightMatch[1]?.split(";").map(Number)
+			weights: weightMatch[1].split(";").map(Number)
 		};
 	}
 	return {

package/lib/font.js.map

@@ -1 +1 @@
-{"version":3,"file":"font.js","names":[],"sources":["../src/font.ts"],"sourcesContent":["import type { Plugin } from 'vite'\n\n// ─── Font optimization ──────────────────────────────────────────────────────\n//\n// Zero provides automatic font optimization:\n// - Downloads and self-hosts Google Fonts at build time (privacy + performance)\n// - Falls back to CDN link in dev mode (for fast dev startup)\n// - Injects preconnect/preload hints into the HTML\n// - Sets font-display: swap to prevent FOIT (Flash of Invisible Text)\n// - Generates optimized @font-face declarations\n// - Size-adjusted fallback fonts to reduce CLS\n\nexport interface FontConfig {\n  /**\n   * Google Fonts families.\n   *\n   * Accepts both string shorthand and structured objects:\n   * - String: \"Inter:wght@400;500;700\" or \"Inter:wght@100..900\"\n   * - Object: { family: \"Inter\", weights: [400, 500, 700] }\n   * - Variable: { family: \"Inter\", variable: true, weightRange: [100, 900] }\n   */\n  google?: GoogleFontInput[]\n  /** Local font files. */\n  local?: LocalFont[]\n  /** Default font-display strategy. Default: \"swap\" */\n  display?: FontDisplay\n  /** Preload critical fonts. Default: true */\n  preload?: boolean\n  /** Self-host Google Fonts at build time. Default: true */\n  selfHost?: boolean\n  /** Fallback font metrics for reducing CLS. */\n  fallbacks?: Record<string, FallbackMetrics>\n}\n\n/** Static Google Font config. */\nexport interface GoogleFontStatic {\n  family: string\n  weights: number[]\n  italic?: boolean\n  variable?: false\n}\n\n/** Variable Google Font config. */\nexport interface GoogleFontVariable {\n  family: string\n  /** Weight range as [min, max] tuple. e.g. [100, 900] */\n  weightRange: [number, number]\n  italic?: boolean\n  variable: true\n}\n\n/** Google font input: structured object or string shorthand. */\nexport type GoogleFontInput = GoogleFontStatic | GoogleFontVariable | string\n\nexport interface LocalFont {\n  family: string\n  src: string\n  /** Single weight (400) or variable range (\"100 900\"). */\n  weight?: number | `${number} ${number}`\n  style?: 'normal' | 'italic'\n  display?: FontDisplay\n}\n\nexport type FontDisplay = 'auto' | 'block' | 'swap' | 'fallback' | 'optional'\n\n/** Metrics for generating size-adjusted fallback fonts to reduce CLS. */\nexport interface FallbackMetrics {\n  /** The fallback font to adjust. e.g. \"Arial\", \"Georgia\" */\n  fallback: string\n  /** Size adjustment factor. e.g. 1.05 */\n  sizeAdjust?: number\n  /** Ascent override percentage. e.g. 90 */\n  ascentOverride?: number\n  /** Descent override percentage. e.g. 22 */\n  descentOverride?: number\n  /** Line gap override percentage. e.g. 0 */\n  lineGapOverride?: number\n}\n\ninterface ResolvedFontBase {\n  family: string\n  italic: boolean\n}\n\ninterface StaticFont extends ResolvedFontBase {\n  variable: false\n  weights: number[]\n}\n\ninterface VariableFont extends ResolvedFontBase {\n  variable: true\n  weightRange: [number, number]\n}\n\ntype ResolvedFont = StaticFont | VariableFont\n\n/**\n * Normalize a GoogleFontInput (string or object) into a ResolvedFont.\n */\nexport function resolveGoogleFont(input: GoogleFontInput): ResolvedFont {\n  if (typeof input === 'string') {\n    return parseGoogleFamily(input)\n  }\n\n  if (input.variable) {\n    return {\n      family: input.family,\n      italic: input.italic ?? false,\n      variable: true,\n      weightRange: input.weightRange,\n    }\n  }\n\n  return {\n    family: input.family,\n    italic: input.italic ?? false,\n    variable: false,\n    weights: input.weights,\n  }\n}\n\n/**\n * Parse Google Fonts family string shorthand.\n *\n * Static weights: \"Inter:wght@400;500;700\"\n * Variable range:  \"Inter:wght@100..900\"\n * Variable with italic: \"Inter:ital,wght@100..900\"\n */\nexport function parseGoogleFamily(input: string): ResolvedFont {\n  const [familyPart, spec] = input.split(':')\n  const family = familyPart?.trim()\n  let italic = false\n\n  if (spec) {\n    italic = spec.includes('ital')\n\n    // Variable font range syntax: wght@100..900\n    const rangeMatch = spec.match(/wght@(\\d+)\\.\\.(\\d+)/)\n    if (rangeMatch) {\n      return {\n        family,\n        italic,\n        variable: true,\n        weightRange: [Number(rangeMatch[1]), Number(rangeMatch[2])],\n      }\n    }\n\n    // Static weights: wght@400;500;700\n    const weightMatch = spec.match(/wght@([\\d;]+)/)\n    if (weightMatch) {\n      return {\n        family,\n        italic,\n        variable: false,\n        weights: weightMatch[1]?.split(';').map(Number),\n      }\n    }\n  }\n\n  return { family, italic, variable: false, weights: [400] }\n}\n\n/**\n * Generate a Google Fonts CSS URL.\n */\nexport function googleFontsUrl(\n  families: ResolvedFont[],\n  display: FontDisplay = 'swap',\n): string {\n  const params = families\n    .map((f) => {\n      const axes = f.italic ? 'ital,wght' : 'wght'\n      const name = f.family.replace(/ /g, '+')\n\n      if (f.variable) {\n        const range = `${f.weightRange[0]}..${f.weightRange[1]}`\n        const value = f.italic ? `0,${range};1,${range}` : range\n        return `family=${name}:${axes}@${value}`\n      }\n\n      const values = f.weights\n        .map((w) => (f.italic ? `0,${w};1,${w}` : String(w)))\n        .join(';')\n      return `family=${name}:${axes}@${values}`\n    })\n    .join('&')\n\n  return `https://fonts.googleapis.com/css2?${params}&display=${display}`\n}\n\n/**\n * Generate @font-face CSS for local fonts.\n */\nfunction localFontFaces(fonts: LocalFont[], display: FontDisplay): string {\n  return fonts\n    .map(\n      (f) => `@font-face {\n  font-family: \"${f.family}\";\n  src: url(\"${f.src}\");\n  font-weight: ${f.weight ?? '400'};\n  font-style: ${f.style ?? 'normal'};\n  font-display: ${f.display ?? display};\n}`,\n    )\n    .join('\\n\\n')\n}\n\n/**\n * Generate size-adjusted fallback @font-face declarations to reduce CLS.\n */\nfunction fallbackFontFaces(fallbacks: Record<string, FallbackMetrics>): string {\n  return Object.entries(fallbacks)\n    .map(([family, metrics]) => {\n      const overrides: string[] = []\n      if (metrics.sizeAdjust != null)\n        overrides.push(`  size-adjust: ${metrics.sizeAdjust * 100}%;`)\n      if (metrics.ascentOverride != null)\n        overrides.push(`  ascent-override: ${metrics.ascentOverride}%;`)\n      if (metrics.descentOverride != null)\n        overrides.push(`  descent-override: ${metrics.descentOverride}%;`)\n      if (metrics.lineGapOverride != null)\n        overrides.push(`  line-gap-override: ${metrics.lineGapOverride}%;`)\n\n      return `@font-face {\n  font-family: \"${family} Fallback\";\n  src: local(\"${metrics.fallback}\");\n${overrides.join('\\n')}\n}`\n    })\n    .join('\\n\\n')\n}\n\n/**\n * Generate preload link tags for critical font files.\n */\nfunction preloadTags(fonts: LocalFont[]): string {\n  return fonts\n    .map((f) => {\n      const ext = f.src.split('.').pop()\n      const type =\n        ext === 'woff2'\n          ? 'font/woff2'\n          : ext === 'woff'\n            ? 'font/woff'\n            : ext === 'ttf'\n              ? 'font/ttf'\n              : 'font/otf'\n      return `<link rel=\"preload\" href=\"${f.src}\" as=\"font\" type=\"${type}\" crossorigin>`\n    })\n    .join('\\n')\n}\n\n/**\n * Download Google Fonts CSS with woff2 user agent.\n */\nasync function downloadGoogleFontsCSS(url: string): Promise<string> {\n  const response = await fetch(url, {\n    headers: {\n      'User-Agent':\n        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',\n    },\n  })\n  if (!response.ok) {\n    throw new Error(`Failed to fetch Google Fonts CSS: ${response.status}`)\n  }\n  return response.text()\n}\n\n/**\n * Download a font file.\n */\nasync function downloadFontFile(url: string): Promise<Buffer> {\n  const response = await fetch(url)\n  if (!response.ok) throw new Error(`Failed to download font: ${url}`)\n  const arrayBuffer = await response.arrayBuffer()\n  return Buffer.from(arrayBuffer)\n}\n\n/**\n * Extract font file URLs from Google Fonts CSS.\n */\nfunction extractFontUrls(css: string): string[] {\n  const urls: string[] = []\n  const regex = /url\\((https:\\/\\/fonts\\.gstatic\\.com\\/[^)]+)\\)/g\n  for (const match of css.matchAll(regex)) {\n    if (match[1]) urls.push(match[1])\n  }\n  return urls\n}\n\n/**\n * Self-host Google Fonts: download CSS + font files, rewrite URLs to local paths.\n */\nasync function selfHostFonts(\n  cssUrl: string,\n  fontsSubDir: string,\n): Promise<{\n  css: string\n  fontFiles: Array<{ name: string; content: Buffer }>\n}> {\n  const css = await downloadGoogleFontsCSS(cssUrl)\n  const fontUrls = extractFontUrls(css)\n  const fontFiles: Array<{ name: string; content: Buffer }> = []\n\n  let rewrittenCss = css\n\n  for (const url of fontUrls) {\n    const urlParts = url.split('/')\n    const fileName = urlParts.at(-1)?.split('?')[0] ?? 'font'\n    const content = await downloadFontFile(url)\n\n    fontFiles.push({ name: fileName, content })\n    rewrittenCss = rewrittenCss.replace(url, `/${fontsSubDir}/${fileName}`)\n  }\n\n  return { css: rewrittenCss, fontFiles }\n}\n\n/**\n * Zero font optimization Vite plugin.\n *\n * Dev mode: injects Google Fonts CDN link for fast startup.\n * Build mode: downloads and self-hosts fonts for maximum performance + privacy.\n *\n * @example\n * import { fontPlugin } from \"@pyreon/zero/font\"\n *\n * export default {\n *   plugins: [\n *     pyreon(),\n *     zero(),\n *     fontPlugin({\n *       google: [\"Inter:wght@400;500;600;700\", \"JetBrains Mono:wght@400\"],\n *       fallbacks: {\n *         \"Inter\": { fallback: \"Arial\", sizeAdjust: 1.07, ascentOverride: 90 },\n *       },\n *     }),\n *   ],\n * }\n */\nexport function fontPlugin(config: FontConfig = {}): Plugin {\n  const display = config.display ?? 'swap'\n  const shouldPreload = config.preload !== false\n  const shouldSelfHost = config.selfHost !== false\n  const googleFamilies = (config.google ?? []).map(resolveGoogleFont)\n\n  let isBuild = false\n  let selfHostedCSS = ''\n  let selfHostedFontFiles: Array<{ name: string; content: Buffer }> = []\n\n  return {\n    name: 'pyreon-zero-fonts',\n\n    configResolved(resolvedConfig) {\n      isBuild = resolvedConfig.command === 'build'\n    },\n\n    async buildStart() {\n      if (isBuild && shouldSelfHost && googleFamilies.length > 0) {\n        const cssUrl = googleFontsUrl(googleFamilies, display)\n        try {\n          const result = await selfHostFonts(cssUrl, 'assets/fonts')\n          selfHostedCSS = result.css\n          selfHostedFontFiles = result.fontFiles\n        } catch {\n          // Self-hosting failed — fall back to CDN link\n        }\n      }\n    },\n\n    generateBundle() {\n      // Emit self-hosted font files as assets\n      for (const file of selfHostedFontFiles) {\n        this.emitFile({\n          type: 'asset',\n          fileName: `assets/fonts/${file.name}`,\n          source: file.content,\n        })\n      }\n    },\n\n    transformIndexHtml(html) {\n      const tags: string[] = []\n\n      collectGoogleFontTags(tags, {\n        isBuild,\n        selfHostedCSS,\n        selfHostedFontFiles,\n        shouldPreload,\n        googleFamilies,\n        display,\n      })\n      collectLocalFontTags(tags, config, shouldPreload, display)\n\n      if (tags.length === 0) return html\n      return html.replace('</head>', `${tags.join('\\n')}\\n</head>`)\n    },\n  }\n}\n\nfunction collectGoogleFontTags(\n  tags: string[],\n  opts: {\n    isBuild: boolean\n    selfHostedCSS: string\n    selfHostedFontFiles: Array<{ name: string; content: Buffer }>\n    shouldPreload: boolean\n    googleFamilies: ResolvedFont[]\n    display: FontDisplay\n  },\n) {\n  if (opts.isBuild && opts.selfHostedCSS) {\n    tags.push(`<style>${opts.selfHostedCSS}</style>`)\n    if (opts.shouldPreload) {\n      for (const file of opts.selfHostedFontFiles.slice(\n        0,\n        opts.googleFamilies.length,\n      )) {\n        const ext = file.name.split('.').pop()\n        const type = ext === 'woff2' ? 'font/woff2' : 'font/woff'\n        tags.push(\n          `<link rel=\"preload\" href=\"/assets/fonts/${file.name}\" as=\"font\" type=\"${type}\" crossorigin>`,\n        )\n      }\n    }\n  } else if (opts.googleFamilies.length > 0) {\n    const cssUrl = googleFontsUrl(opts.googleFamilies, opts.display)\n    tags.push(`<link rel=\"preconnect\" href=\"https://fonts.googleapis.com\">`)\n    tags.push(\n      `<link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin>`,\n    )\n    tags.push(`<link rel=\"stylesheet\" href=\"${cssUrl}\">`)\n  }\n}\n\nfunction collectLocalFontTags(\n  tags: string[],\n  config: FontConfig,\n  shouldPreload: boolean,\n  display: FontDisplay,\n) {\n  if (shouldPreload && config.local?.length) {\n    tags.push(preloadTags(config.local))\n  }\n  if (config.local?.length) {\n    tags.push(`<style>${localFontFaces(config.local, display)}</style>`)\n  }\n  if (config.fallbacks && Object.keys(config.fallbacks).length > 0) {\n    tags.push(`<style>${fallbackFontFaces(config.fallbacks)}</style>`)\n  }\n}\n\n/**\n * Generate CSS variables for font families.\n */\nexport function fontVariables(families: Record<string, string>): string {\n  const vars = Object.entries(families)\n    .map(([key, value]) => `  --font-${key}: ${value};`)\n    .join('\\n')\n  return `:root {\\n${vars}\\n}`\n}\n"],"mappings":"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"}
+{"version":3,"file":"font.js","names":[],"sources":["../src/font.ts"],"sourcesContent":["import type { Plugin } from 'vite'\n\n// ─── Font optimization ──────────────────────────────────────────────────────\n//\n// Zero provides automatic font optimization:\n// - Downloads and self-hosts Google Fonts at build time (privacy + performance)\n// - Falls back to CDN link in dev mode (for fast dev startup)\n// - Injects preconnect/preload hints into the HTML\n// - Sets font-display: swap to prevent FOIT (Flash of Invisible Text)\n// - Generates optimized @font-face declarations\n// - Size-adjusted fallback fonts to reduce CLS\n\nexport interface FontConfig {\n  /**\n   * Google Fonts families.\n   *\n   * Accepts both string shorthand and structured objects:\n   * - String: \"Inter:wght@400;500;700\" or \"Inter:wght@100..900\"\n   * - Object: { family: \"Inter\", weights: [400, 500, 700] }\n   * - Variable: { family: \"Inter\", variable: true, weightRange: [100, 900] }\n   */\n  google?: GoogleFontInput[]\n  /** Local font files. */\n  local?: LocalFont[]\n  /** Default font-display strategy. Default: \"swap\" */\n  display?: FontDisplay\n  /** Preload critical fonts. Default: true */\n  preload?: boolean\n  /** Self-host Google Fonts at build time. Default: true */\n  selfHost?: boolean\n  /** Fallback font metrics for reducing CLS. */\n  fallbacks?: Record<string, FallbackMetrics>\n}\n\n/** Static Google Font config. */\nexport interface GoogleFontStatic {\n  family: string\n  weights: number[]\n  italic?: boolean\n  variable?: false\n}\n\n/** Variable Google Font config. */\nexport interface GoogleFontVariable {\n  family: string\n  /** Weight range as [min, max] tuple. e.g. [100, 900] */\n  weightRange: [number, number]\n  italic?: boolean\n  variable: true\n}\n\n/** Google font input: structured object or string shorthand. */\nexport type GoogleFontInput = GoogleFontStatic | GoogleFontVariable | string\n\nexport interface LocalFont {\n  family: string\n  src: string\n  /** Single weight (400) or variable range (\"100 900\"). */\n  weight?: number | `${number} ${number}`\n  style?: 'normal' | 'italic'\n  display?: FontDisplay\n}\n\nexport type FontDisplay = 'auto' | 'block' | 'swap' | 'fallback' | 'optional'\n\n/** Metrics for generating size-adjusted fallback fonts to reduce CLS. */\nexport interface FallbackMetrics {\n  /** The fallback font to adjust. e.g. \"Arial\", \"Georgia\" */\n  fallback: string\n  /** Size adjustment factor. e.g. 1.05 */\n  sizeAdjust?: number\n  /** Ascent override percentage. e.g. 90 */\n  ascentOverride?: number\n  /** Descent override percentage. e.g. 22 */\n  descentOverride?: number\n  /** Line gap override percentage. e.g. 0 */\n  lineGapOverride?: number\n}\n\ninterface ResolvedFontBase {\n  family: string\n  italic: boolean\n}\n\ninterface StaticFont extends ResolvedFontBase {\n  variable: false\n  weights: number[]\n}\n\ninterface VariableFont extends ResolvedFontBase {\n  variable: true\n  weightRange: [number, number]\n}\n\ntype ResolvedFont = StaticFont | VariableFont\n\n/**\n * Normalize a GoogleFontInput (string or object) into a ResolvedFont.\n */\nexport function resolveGoogleFont(input: GoogleFontInput): ResolvedFont {\n  if (typeof input === 'string') {\n    return parseGoogleFamily(input)\n  }\n\n  if (input.variable) {\n    return {\n      family: input.family,\n      italic: input.italic ?? false,\n      variable: true,\n      weightRange: input.weightRange,\n    }\n  }\n\n  return {\n    family: input.family,\n    italic: input.italic ?? false,\n    variable: false,\n    weights: input.weights,\n  }\n}\n\n/**\n * Parse Google Fonts family string shorthand.\n *\n * Static weights: \"Inter:wght@400;500;700\"\n * Variable range:  \"Inter:wght@100..900\"\n * Variable with italic: \"Inter:ital,wght@100..900\"\n */\nexport function parseGoogleFamily(input: string): ResolvedFont {\n  const parts = input.split(':')\n  const family = (parts[0] ?? '').trim()\n  const spec = parts[1]\n  let italic = false\n\n  if (spec) {\n    italic = spec.includes('ital')\n\n    // Variable font range syntax: wght@100..900\n    const rangeMatch = spec.match(/wght@(\\d+)\\.\\.(\\d+)/)\n    if (rangeMatch && rangeMatch[1] && rangeMatch[2]) {\n      return {\n        family,\n        italic,\n        variable: true,\n        weightRange: [Number(rangeMatch[1]), Number(rangeMatch[2])],\n      }\n    }\n\n    // Static weights: wght@400;500;700\n    const weightMatch = spec.match(/wght@([\\d;]+)/)\n    if (weightMatch && weightMatch[1]) {\n      return {\n        family,\n        italic,\n        variable: false,\n        weights: weightMatch[1].split(';').map(Number),\n      }\n    }\n  }\n\n  return { family, italic, variable: false, weights: [400] }\n}\n\n/**\n * Generate a Google Fonts CSS URL.\n */\nexport function googleFontsUrl(\n  families: ResolvedFont[],\n  display: FontDisplay = 'swap',\n): string {\n  const params = families\n    .map((f) => {\n      const axes = f.italic ? 'ital,wght' : 'wght'\n      const name = f.family.replace(/ /g, '+')\n\n      if (f.variable) {\n        const range = `${f.weightRange[0]}..${f.weightRange[1]}`\n        const value = f.italic ? `0,${range};1,${range}` : range\n        return `family=${name}:${axes}@${value}`\n      }\n\n      const values = f.weights\n        .map((w) => (f.italic ? `0,${w};1,${w}` : String(w)))\n        .join(';')\n      return `family=${name}:${axes}@${values}`\n    })\n    .join('&')\n\n  return `https://fonts.googleapis.com/css2?${params}&display=${display}`\n}\n\n/**\n * Generate @font-face CSS for local fonts.\n */\nfunction localFontFaces(fonts: LocalFont[], display: FontDisplay): string {\n  return fonts\n    .map(\n      (f) => `@font-face {\n  font-family: \"${f.family}\";\n  src: url(\"${f.src}\");\n  font-weight: ${f.weight ?? '400'};\n  font-style: ${f.style ?? 'normal'};\n  font-display: ${f.display ?? display};\n}`,\n    )\n    .join('\\n\\n')\n}\n\n/**\n * Generate size-adjusted fallback @font-face declarations to reduce CLS.\n */\nfunction fallbackFontFaces(fallbacks: Record<string, FallbackMetrics>): string {\n  return Object.entries(fallbacks)\n    .map(([family, metrics]) => {\n      const overrides: string[] = []\n      if (metrics.sizeAdjust != null)\n        overrides.push(`  size-adjust: ${metrics.sizeAdjust * 100}%;`)\n      if (metrics.ascentOverride != null)\n        overrides.push(`  ascent-override: ${metrics.ascentOverride}%;`)\n      if (metrics.descentOverride != null)\n        overrides.push(`  descent-override: ${metrics.descentOverride}%;`)\n      if (metrics.lineGapOverride != null)\n        overrides.push(`  line-gap-override: ${metrics.lineGapOverride}%;`)\n\n      return `@font-face {\n  font-family: \"${family} Fallback\";\n  src: local(\"${metrics.fallback}\");\n${overrides.join('\\n')}\n}`\n    })\n    .join('\\n\\n')\n}\n\n/**\n * Generate preload link tags for critical font files.\n */\nfunction preloadTags(fonts: LocalFont[]): string {\n  return fonts\n    .map((f) => {\n      const ext = f.src.split('.').pop()\n      const type =\n        ext === 'woff2'\n          ? 'font/woff2'\n          : ext === 'woff'\n            ? 'font/woff'\n            : ext === 'ttf'\n              ? 'font/ttf'\n              : 'font/otf'\n      return `<link rel=\"preload\" href=\"${f.src}\" as=\"font\" type=\"${type}\" crossorigin>`\n    })\n    .join('\\n')\n}\n\n/**\n * Download Google Fonts CSS with woff2 user agent.\n */\nasync function downloadGoogleFontsCSS(url: string): Promise<string> {\n  const response = await fetch(url, {\n    headers: {\n      'User-Agent':\n        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',\n    },\n  })\n  if (!response.ok) {\n    throw new Error(`Failed to fetch Google Fonts CSS: ${response.status}`)\n  }\n  return response.text()\n}\n\n/**\n * Download a font file.\n */\nasync function downloadFontFile(url: string): Promise<Buffer> {\n  const response = await fetch(url)\n  if (!response.ok) throw new Error(`Failed to download font: ${url}`)\n  const arrayBuffer = await response.arrayBuffer()\n  return Buffer.from(arrayBuffer)\n}\n\n/**\n * Extract font file URLs from Google Fonts CSS.\n */\nfunction extractFontUrls(css: string): string[] {\n  const urls: string[] = []\n  const regex = /url\\((https:\\/\\/fonts\\.gstatic\\.com\\/[^)]+)\\)/g\n  for (const match of css.matchAll(regex)) {\n    if (match[1]) urls.push(match[1])\n  }\n  return urls\n}\n\n/**\n * Self-host Google Fonts: download CSS + font files, rewrite URLs to local paths.\n */\nasync function selfHostFonts(\n  cssUrl: string,\n  fontsSubDir: string,\n): Promise<{\n  css: string\n  fontFiles: Array<{ name: string; content: Buffer }>\n}> {\n  const css = await downloadGoogleFontsCSS(cssUrl)\n  const fontUrls = extractFontUrls(css)\n  const fontFiles: Array<{ name: string; content: Buffer }> = []\n\n  let rewrittenCss = css\n\n  for (const url of fontUrls) {\n    const urlParts = url.split('/')\n    const fileName = urlParts.at(-1)?.split('?')[0] ?? 'font'\n    const content = await downloadFontFile(url)\n\n    fontFiles.push({ name: fileName, content })\n    rewrittenCss = rewrittenCss.replace(url, `/${fontsSubDir}/${fileName}`)\n  }\n\n  return { css: rewrittenCss, fontFiles }\n}\n\n/**\n * Zero font optimization Vite plugin.\n *\n * Dev mode: injects Google Fonts CDN link for fast startup.\n * Build mode: downloads and self-hosts fonts for maximum performance + privacy.\n *\n * @example\n * import { fontPlugin } from \"@pyreon/zero/font\"\n *\n * export default {\n *   plugins: [\n *     pyreon(),\n *     zero(),\n *     fontPlugin({\n *       google: [\"Inter:wght@400;500;600;700\", \"JetBrains Mono:wght@400\"],\n *       fallbacks: {\n *         \"Inter\": { fallback: \"Arial\", sizeAdjust: 1.07, ascentOverride: 90 },\n *       },\n *     }),\n *   ],\n * }\n */\nexport function fontPlugin(config: FontConfig = {}): Plugin {\n  const display = config.display ?? 'swap'\n  const shouldPreload = config.preload !== false\n  const shouldSelfHost = config.selfHost !== false\n  const googleFamilies = (config.google ?? []).map(resolveGoogleFont)\n\n  let isBuild = false\n  let selfHostedCSS = ''\n  let selfHostedFontFiles: Array<{ name: string; content: Buffer }> = []\n\n  return {\n    name: 'pyreon-zero-fonts',\n\n    configResolved(resolvedConfig) {\n      isBuild = resolvedConfig.command === 'build'\n    },\n\n    async buildStart() {\n      if (isBuild && shouldSelfHost && googleFamilies.length > 0) {\n        const cssUrl = googleFontsUrl(googleFamilies, display)\n        try {\n          const result = await selfHostFonts(cssUrl, 'assets/fonts')\n          selfHostedCSS = result.css\n          selfHostedFontFiles = result.fontFiles\n        } catch {\n          // Self-hosting failed — fall back to CDN link\n        }\n      }\n    },\n\n    generateBundle() {\n      // Emit self-hosted font files as assets\n      for (const file of selfHostedFontFiles) {\n        this.emitFile({\n          type: 'asset',\n          fileName: `assets/fonts/${file.name}`,\n          source: file.content,\n        })\n      }\n    },\n\n    transformIndexHtml(html) {\n      const tags: string[] = []\n\n      collectGoogleFontTags(tags, {\n        isBuild,\n        selfHostedCSS,\n        selfHostedFontFiles,\n        shouldPreload,\n        googleFamilies,\n        display,\n      })\n      collectLocalFontTags(tags, config, shouldPreload, display)\n\n      if (tags.length === 0) return html\n      return html.replace('</head>', `${tags.join('\\n')}\\n</head>`)\n    },\n  }\n}\n\nfunction collectGoogleFontTags(\n  tags: string[],\n  opts: {\n    isBuild: boolean\n    selfHostedCSS: string\n    selfHostedFontFiles: Array<{ name: string; content: Buffer }>\n    shouldPreload: boolean\n    googleFamilies: ResolvedFont[]\n    display: FontDisplay\n  },\n) {\n  if (opts.isBuild && opts.selfHostedCSS) {\n    tags.push(`<style>${opts.selfHostedCSS}</style>`)\n    if (opts.shouldPreload) {\n      for (const file of opts.selfHostedFontFiles.slice(\n        0,\n        opts.googleFamilies.length,\n      )) {\n        const ext = file.name.split('.').pop()\n        const type = ext === 'woff2' ? 'font/woff2' : 'font/woff'\n        tags.push(\n          `<link rel=\"preload\" href=\"/assets/fonts/${file.name}\" as=\"font\" type=\"${type}\" crossorigin>`,\n        )\n      }\n    }\n  } else if (opts.googleFamilies.length > 0) {\n    const cssUrl = googleFontsUrl(opts.googleFamilies, opts.display)\n    tags.push(`<link rel=\"preconnect\" href=\"https://fonts.googleapis.com\">`)\n    tags.push(\n      `<link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin>`,\n    )\n    tags.push(`<link rel=\"stylesheet\" href=\"${cssUrl}\">`)\n  }\n}\n\nfunction collectLocalFontTags(\n  tags: string[],\n  config: FontConfig,\n  shouldPreload: boolean,\n  display: FontDisplay,\n) {\n  if (shouldPreload && config.local?.length) {\n    tags.push(preloadTags(config.local))\n  }\n  if (config.local?.length) {\n    tags.push(`<style>${localFontFaces(config.local, display)}</style>`)\n  }\n  if (config.fallbacks && Object.keys(config.fallbacks).length > 0) {\n    tags.push(`<style>${fallbackFontFaces(config.fallbacks)}</style>`)\n  }\n}\n\n/**\n * Generate CSS variables for font families.\n */\nexport function fontVariables(families: Record<string, string>): string {\n  const vars = Object.entries(families)\n    .map(([key, value]) => `  --font-${key}: ${value};`)\n    .join('\\n')\n  return `:root {\\n${vars}\\n}`\n}\n"],"mappings":";;;;AAmGA,SAAgB,kBAAkB,OAAsC;AACtE,KAAI,OAAO,UAAU,SACnB,QAAO,kBAAkB,MAAM;AAGjC,KAAI,MAAM,SACR,QAAO;EACL,QAAQ,MAAM;EACd,QAAQ,MAAM,UAAU;EACxB,UAAU;EACV,aAAa,MAAM;EACpB;AAGH,QAAO;EACL,QAAQ,MAAM;EACd,QAAQ,MAAM,UAAU;EACxB,UAAU;EACV,SAAS,MAAM;EAChB;;;;;;;;;AAUH,SAAgB,kBAAkB,OAA6B;CAC7D,MAAM,QAAQ,MAAM,MAAM,IAAI;CAC9B,MAAM,UAAU,MAAM,MAAM,IAAI,MAAM;CACtC,MAAM,OAAO,MAAM;CACnB,IAAI,SAAS;AAEb,KAAI,MAAM;AACR,WAAS,KAAK,SAAS,OAAO;EAG9B,MAAM,aAAa,KAAK,MAAM,sBAAsB;AACpD,MAAI,cAAc,WAAW,MAAM,WAAW,GAC5C,QAAO;GACL;GACA;GACA,UAAU;GACV,aAAa,CAAC,OAAO,WAAW,GAAG,EAAE,OAAO,WAAW,GAAG,CAAC;GAC5D;EAIH,MAAM,cAAc,KAAK,MAAM,gBAAgB;AAC/C,MAAI,eAAe,YAAY,GAC7B,QAAO;GACL;GACA;GACA,UAAU;GACV,SAAS,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,OAAO;GAC/C;;AAIL,QAAO;EAAE;EAAQ;EAAQ,UAAU;EAAO,SAAS,CAAC,IAAI;EAAE;;;;;AAM5D,SAAgB,eACd,UACA,UAAuB,QACf;AAmBR,QAAO,qCAlBQ,SACZ,KAAK,MAAM;EACV,MAAM,OAAO,EAAE,SAAS,cAAc;EACtC,MAAM,OAAO,EAAE,OAAO,QAAQ,MAAM,IAAI;AAExC,MAAI,EAAE,UAAU;GACd,MAAM,QAAQ,GAAG,EAAE,YAAY,GAAG,IAAI,EAAE,YAAY;AAEpD,UAAO,UAAU,KAAK,GAAG,KAAK,GADhB,EAAE,SAAS,KAAK,MAAM,KAAK,UAAU;;AAOrD,SAAO,UAAU,KAAK,GAAG,KAAK,GAHf,EAAE,QACd,KAAK,MAAO,EAAE,SAAS,KAAK,EAAE,KAAK,MAAM,OAAO,EAAE,CAAE,CACpD,KAAK,IAAI;GAEZ,CACD,KAAK,IAAI,CAEuC,WAAW;;;;;AAMhE,SAAS,eAAe,OAAoB,SAA8B;AACxE,QAAO,MACJ,KACE,MAAM;kBACK,EAAE,OAAO;cACb,EAAE,IAAI;iBACH,EAAE,UAAU,MAAM;gBACnB,EAAE,SAAS,SAAS;kBAClB,EAAE,WAAW,QAAQ;GAElC,CACA,KAAK,OAAO;;;;;AAMjB,SAAS,kBAAkB,WAAoD;AAC7E,QAAO,OAAO,QAAQ,UAAU,CAC7B,KAAK,CAAC,QAAQ,aAAa;EAC1B,MAAM,YAAsB,EAAE;AAC9B,MAAI,QAAQ,cAAc,KACxB,WAAU,KAAK,kBAAkB,QAAQ,aAAa,IAAI,IAAI;AAChE,MAAI,QAAQ,kBAAkB,KAC5B,WAAU,KAAK,sBAAsB,QAAQ,eAAe,IAAI;AAClE,MAAI,QAAQ,mBAAmB,KAC7B,WAAU,KAAK,uBAAuB,QAAQ,gBAAgB,IAAI;AACpE,MAAI,QAAQ,mBAAmB,KAC7B,WAAU,KAAK,wBAAwB,QAAQ,gBAAgB,IAAI;AAErE,SAAO;kBACK,OAAO;gBACT,QAAQ,SAAS;EAC/B,UAAU,KAAK,KAAK,CAAC;;GAEjB,CACD,KAAK,OAAO;;;;;AAMjB,SAAS,YAAY,OAA4B;AAC/C,QAAO,MACJ,KAAK,MAAM;EACV,MAAM,MAAM,EAAE,IAAI,MAAM,IAAI,CAAC,KAAK;EAClC,MAAM,OACJ,QAAQ,UACJ,eACA,QAAQ,SACN,cACA,QAAQ,QACN,aACA;AACV,SAAO,6BAA6B,EAAE,IAAI,oBAAoB,KAAK;GACnE,CACD,KAAK,KAAK;;;;;AAMf,eAAe,uBAAuB,KAA8B;CAClE,MAAM,WAAW,MAAM,MAAM,KAAK,EAChC,SAAS,EACP,cACE,yHACH,EACF,CAAC;AACF,KAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,qCAAqC,SAAS,SAAS;AAEzE,QAAO,SAAS,MAAM;;;;;AAMxB,eAAe,iBAAiB,KAA8B;CAC5D,MAAM,WAAW,MAAM,MAAM,IAAI;AACjC,KAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,4BAA4B,MAAM;CACpE,MAAM,cAAc,MAAM,SAAS,aAAa;AAChD,QAAO,OAAO,KAAK,YAAY;;;;;AAMjC,SAAS,gBAAgB,KAAuB;CAC9C,MAAM,OAAiB,EAAE;AAEzB,MAAK,MAAM,SAAS,IAAI,SADV,iDACyB,CACrC,KAAI,MAAM,GAAI,MAAK,KAAK,MAAM,GAAG;AAEnC,QAAO;;;;;AAMT,eAAe,cACb,QACA,aAIC;CACD,MAAM,MAAM,MAAM,uBAAuB,OAAO;CAChD,MAAM,WAAW,gBAAgB,IAAI;CACrC,MAAM,YAAsD,EAAE;CAE9D,IAAI,eAAe;AAEnB,MAAK,MAAM,OAAO,UAAU;EAE1B,MAAM,WADW,IAAI,MAAM,IAAI,CACL,GAAG,GAAG,EAAE,MAAM,IAAI,CAAC,MAAM;EACnD,MAAM,UAAU,MAAM,iBAAiB,IAAI;AAE3C,YAAU,KAAK;GAAE,MAAM;GAAU;GAAS,CAAC;AAC3C,iBAAe,aAAa,QAAQ,KAAK,IAAI,YAAY,GAAG,WAAW;;AAGzE,QAAO;EAAE,KAAK;EAAc;EAAW;;;;;;;;;;;;;;;;;;;;;;;;AAyBzC,SAAgB,WAAW,SAAqB,EAAE,EAAU;CAC1D,MAAM,UAAU,OAAO,WAAW;CAClC,MAAM,gBAAgB,OAAO,YAAY;CACzC,MAAM,iBAAiB,OAAO,aAAa;CAC3C,MAAM,kBAAkB,OAAO,UAAU,EAAE,EAAE,IAAI,kBAAkB;CAEnE,IAAI,UAAU;CACd,IAAI,gBAAgB;CACpB,IAAI,sBAAgE,EAAE;AAEtE,QAAO;EACL,MAAM;EAEN,eAAe,gBAAgB;AAC7B,aAAU,eAAe,YAAY;;EAGvC,MAAM,aAAa;AACjB,OAAI,WAAW,kBAAkB,eAAe,SAAS,GAAG;IAC1D,MAAM,SAAS,eAAe,gBAAgB,QAAQ;AACtD,QAAI;KACF,MAAM,SAAS,MAAM,cAAc,QAAQ,eAAe;AAC1D,qBAAgB,OAAO;AACvB,2BAAsB,OAAO;YACvB;;;EAMZ,iBAAiB;AAEf,QAAK,MAAM,QAAQ,oBACjB,MAAK,SAAS;IACZ,MAAM;IACN,UAAU,gBAAgB,KAAK;IAC/B,QAAQ,KAAK;IACd,CAAC;;EAIN,mBAAmB,MAAM;GACvB,MAAM,OAAiB,EAAE;AAEzB,yBAAsB,MAAM;IAC1B;IACA;IACA;IACA;IACA;IACA;IACD,CAAC;AACF,wBAAqB,MAAM,QAAQ,eAAe,QAAQ;AAE1D,OAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,UAAO,KAAK,QAAQ,WAAW,GAAG,KAAK,KAAK,KAAK,CAAC,WAAW;;EAEhE;;AAGH,SAAS,sBACP,MACA,MAQA;AACA,KAAI,KAAK,WAAW,KAAK,eAAe;AACtC,OAAK,KAAK,UAAU,KAAK,cAAc,UAAU;AACjD,MAAI,KAAK,cACP,MAAK,MAAM,QAAQ,KAAK,oBAAoB,MAC1C,GACA,KAAK,eAAe,OACrB,EAAE;GAED,MAAM,OADM,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,KACjB,UAAU,eAAe;AAC9C,QAAK,KACH,2CAA2C,KAAK,KAAK,oBAAoB,KAAK,gBAC/E;;YAGI,KAAK,eAAe,SAAS,GAAG;EACzC,MAAM,SAAS,eAAe,KAAK,gBAAgB,KAAK,QAAQ;AAChE,OAAK,KAAK,8DAA8D;AACxE,OAAK,KACH,uEACD;AACD,OAAK,KAAK,gCAAgC,OAAO,IAAI;;;AAIzD,SAAS,qBACP,MACA,QACA,eACA,SACA;AACA,KAAI,iBAAiB,OAAO,OAAO,OACjC,MAAK,KAAK,YAAY,OAAO,MAAM,CAAC;AAEtC,KAAI,OAAO,OAAO,OAChB,MAAK,KAAK,UAAU,eAAe,OAAO,OAAO,QAAQ,CAAC,UAAU;AAEtE,KAAI,OAAO,aAAa,OAAO,KAAK,OAAO,UAAU,CAAC,SAAS,EAC7D,MAAK,KAAK,UAAU,kBAAkB,OAAO,UAAU,CAAC,UAAU;;;;;AAOtE,SAAgB,cAAc,UAA0C;AAItE,QAAO,YAHM,OAAO,QAAQ,SAAS,CAClC,KAAK,CAAC,KAAK,WAAW,YAAY,IAAI,IAAI,MAAM,GAAG,CACnD,KAAK,KAAK,CACW"}

package/lib/image.js

@@ -26,7 +26,7 @@ function useIntersectionObserver(getElement, onIntersect, rootMargin = "200px")
 }
 
 //#endregion
-//#region ../../node_modules/.bun/@pyreon+core@0.7.0/node_modules/@pyreon/core/lib/jsx-runtime.js
+//#region ../../node_modules/.bun/@pyreon+core@0.7.5/node_modules/@pyreon/core/lib/jsx-runtime.js
 /**
 * Hyperscript function — the compiled output of JSX.
 * `<div class="x">hello</div>` → `h("div", { class: "x" }, "hello")`

package/lib/image.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.js","names":[],"sources":["../src/utils/use-intersection-observer.ts","../../../node_modules/.bun/@pyreon+core@0.7.0/node_modules/@pyreon/core/lib/jsx-runtime.js","../src/image.tsx"],"sourcesContent":["import { onMount, onUnmount } from '@pyreon/core'\n\n/**\n * Observes an element and calls `onIntersect` once it enters the viewport.\n * Automatically disconnects after the first intersection.\n *\n * @param getElement - Getter for the target element (may be undefined before mount).\n * @param onIntersect - Callback fired when the element becomes visible.\n * @param rootMargin - IntersectionObserver rootMargin. Default: \"200px\".\n */\nexport function useIntersectionObserver(\n  getElement: () => HTMLElement | undefined,\n  onIntersect: () => void,\n  rootMargin = '200px',\n) {\n  onMount(() => {\n    const el = getElement()\n    if (!el) return undefined\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            onIntersect()\n            observer.disconnect()\n          }\n        }\n      },\n      { rootMargin },\n    )\n\n    observer.observe(el)\n    onUnmount(() => observer.disconnect())\n    return undefined\n  })\n}\n","//#region src/h.ts\n/** Marker for fragment nodes — renders children without a wrapper element */\nconst Fragment = Symbol(\"Pyreon.Fragment\");\n/**\n* Hyperscript function — the compiled output of JSX.\n* `<div class=\"x\">hello</div>` → `h(\"div\", { class: \"x\" }, \"hello\")`\n*\n* Generic on P so TypeScript validates props match the component's signature\n* at the call site, then stores the result in the loosely-typed VNode.\n*/\n/** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */\nconst EMPTY_PROPS = {};\nfunction h(type, props, ...children) {\n\treturn {\n\t\ttype,\n\t\tprops: props ?? EMPTY_PROPS,\n\t\tchildren: normalizeChildren(children),\n\t\tkey: props?.key ?? null\n\t};\n}\nfunction normalizeChildren(children) {\n\tfor (let i = 0; i < children.length; i++) if (Array.isArray(children[i])) return flattenChildren(children);\n\treturn children;\n}\nfunction flattenChildren(children) {\n\tconst result = [];\n\tfor (const child of children) if (Array.isArray(child)) result.push(...flattenChildren(child));\n\telse result.push(child);\n\treturn result;\n}\n\n//#endregion\n//#region src/jsx-runtime.ts\n/**\n* JSX automatic runtime.\n*\n* When tsconfig has `\"jsxImportSource\": \"@pyreon/core\"`, the TS/bundler compiler\n* rewrites JSX to imports from this file automatically:\n*   <div class=\"x\" />  →  jsx(\"div\", { class: \"x\" })\n*/\nfunction jsx(type, props, key) {\n\tconst { children, ...rest } = props;\n\tconst propsWithKey = key != null ? {\n\t\t...rest,\n\t\tkey\n\t} : rest;\n\tif (typeof type === \"function\") return h(type, children !== void 0 ? {\n\t\t...propsWithKey,\n\t\tchildren\n\t} : propsWithKey);\n\treturn h(type, propsWithKey, ...children === void 0 ? [] : Array.isArray(children) ? children : [children]);\n}\nconst jsxs = jsx;\n\n//#endregion\nexport { Fragment, jsx, jsxs };\n//# sourceMappingURL=jsx-runtime.js.map","import { createRef } from '@pyreon/core'\nimport { signal } from '@pyreon/reactivity'\nimport type { FormatSource } from './image-plugin'\nimport { useIntersectionObserver } from './utils/use-intersection-observer'\n\n// ─── Image optimization component ───────────────────────────────────────────\n//\n// <Image> provides:\n// - Lazy loading via IntersectionObserver (loads when near viewport)\n// - Automatic width/height to prevent CLS (Cumulative Layout Shift)\n// - Responsive srcset generation from width descriptors\n// - Multi-format support via <picture> (WebP/AVIF with fallback)\n// - Blur-up placeholder while loading\n// - Priority loading for above-the-fold images\n\nexport interface ImageProps {\n  /** Image source URL. */\n  src: string\n  /** Alt text (required for accessibility). */\n  alt: string\n  /** Intrinsic width of the image. */\n  width: number\n  /** Intrinsic height of the image. */\n  height: number\n  /** Responsive sizes attribute. Default: \"100vw\" */\n  sizes?: string\n  /** Responsive srcset string or source array. */\n  srcset?: string | ImageSource[]\n  /** Per-format source sets for <picture>. Provided automatically by imagePlugin. */\n  formats?: FormatSource[]\n  /** Loading strategy. \"lazy\" uses IntersectionObserver, \"eager\" loads immediately. Default: \"lazy\" */\n  loading?: 'lazy' | 'eager'\n  /** Mark as priority (LCP image). Disables lazy loading, adds fetchpriority=\"high\". */\n  priority?: boolean\n  /** Low-quality placeholder image URL or base64 data URI for blur-up effect. */\n  placeholder?: string\n  /** CSS class name. */\n  class?: string\n  /** Inline styles. */\n  style?: string\n  /** CSS object-fit. Default: \"cover\" */\n  fit?: 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'\n  /** Decode async. Default: true */\n  decoding?: 'sync' | 'async' | 'auto'\n}\n\nexport interface ImageSource {\n  src: string\n  width: number\n}\n\n/**\n * Optimized image component with lazy loading, responsive images,\n * multi-format <picture> support, and blur-up placeholders.\n *\n * @example\n * // With imagePlugin — spread the import directly\n * import hero from \"./hero.jpg?optimize\"\n * <Image {...hero} alt=\"Hero\" priority />\n *\n * @example\n * // Manual usage\n * <Image src=\"/hero.jpg\" alt=\"Hero\" width={1200} height={630} />\n */\nexport function Image(props: ImageProps) {\n  const isEager = props.priority || props.loading === 'eager'\n  const loaded = signal(isEager)\n  const inView = signal(isEager)\n  const containerRef = createRef<HTMLElement>()\n\n  // Resolve srcset from string or array\n  const resolvedSrcset =\n    typeof props.srcset === 'string'\n      ? props.srcset\n      : props.srcset?.map((s) => `${s.src} ${s.width}w`).join(', ')\n\n  const sizes = props.sizes ?? '100vw'\n  const fit = props.fit ?? 'cover'\n  const hasFormats = props.formats && props.formats.length > 0\n  const aspectRatio = `${props.width} / ${props.height}`\n\n  if (!isEager) {\n    useIntersectionObserver(\n      () => containerRef.current ?? undefined,\n      () => inView.set(true),\n    )\n  }\n\n  // Static styles (don't depend on signals)\n  const containerStyle = [\n    'position: relative',\n    'overflow: hidden',\n    `aspect-ratio: ${aspectRatio}`,\n    `max-width: ${props.width}px`,\n    'width: 100%',\n    props.style,\n  ]\n    .filter(Boolean)\n    .join('; ')\n\n  const imgEl = (\n    <img\n      src={() => (inView() ? props.src : '')}\n      srcset={() =>\n        !hasFormats && inView() && resolvedSrcset ? resolvedSrcset : ''\n      }\n      sizes={resolvedSrcset ? sizes : undefined}\n      alt={props.alt}\n      width={props.width}\n      height={props.height}\n      loading={isEager ? 'eager' : 'lazy'}\n      decoding={props.decoding ?? 'async'}\n      fetchpriority={props.priority ? 'high' : undefined}\n      onload={() => loaded.set(true)}\n      style={() =>\n        [\n          'display: block',\n          'width: 100%',\n          'height: 100%',\n          `object-fit: ${fit}`,\n          'transition: opacity 0.3s ease',\n          props.placeholder && !loaded() ? 'opacity: 0' : 'opacity: 1',\n        ].join('; ')\n      }\n    />\n  )\n\n  return (\n    <div ref={containerRef} class={props.class} style={containerStyle}>\n      {props.placeholder && (\n        <img\n          src={props.placeholder}\n          alt=\"\"\n          aria-hidden=\"true\"\n          loading=\"eager\"\n          style={() =>\n            [\n              'position: absolute',\n              'inset: 0',\n              'width: 100%',\n              'height: 100%',\n              'object-fit: cover',\n              'filter: blur(20px)',\n              'transform: scale(1.1)',\n              'transition: opacity 0.4s ease',\n              loaded() ? 'opacity: 0; pointer-events: none' : 'opacity: 1',\n            ].join('; ')\n          }\n        />\n      )}\n      {hasFormats ? (\n        <picture>\n          {props.formats?.map((fmt) => (\n            <source\n              type={fmt.type}\n              srcset={() => (inView() ? fmt.srcset : undefined)}\n              sizes={sizes}\n            />\n          ))}\n          {imgEl}\n        </picture>\n      ) : (\n        imgEl\n      )}\n    </div>\n  )\n}\n"],"x_google_ignoreList":[1],"mappings":"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"}
+{"version":3,"file":"image.js","names":[],"sources":["../src/utils/use-intersection-observer.ts","../../../node_modules/.bun/@pyreon+core@0.7.5/node_modules/@pyreon/core/lib/jsx-runtime.js","../src/image.tsx"],"sourcesContent":["import { onMount, onUnmount } from '@pyreon/core'\n\n/**\n * Observes an element and calls `onIntersect` once it enters the viewport.\n * Automatically disconnects after the first intersection.\n *\n * @param getElement - Getter for the target element (may be undefined before mount).\n * @param onIntersect - Callback fired when the element becomes visible.\n * @param rootMargin - IntersectionObserver rootMargin. Default: \"200px\".\n */\nexport function useIntersectionObserver(\n  getElement: () => HTMLElement | undefined,\n  onIntersect: () => void,\n  rootMargin = '200px',\n) {\n  onMount(() => {\n    const el = getElement()\n    if (!el) return undefined\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            onIntersect()\n            observer.disconnect()\n          }\n        }\n      },\n      { rootMargin },\n    )\n\n    observer.observe(el)\n    onUnmount(() => observer.disconnect())\n    return undefined\n  })\n}\n","//#region src/h.ts\n/** Marker for fragment nodes — renders children without a wrapper element */\nconst Fragment = Symbol(\"Pyreon.Fragment\");\n/**\n* Hyperscript function — the compiled output of JSX.\n* `<div class=\"x\">hello</div>` → `h(\"div\", { class: \"x\" }, \"hello\")`\n*\n* Generic on P so TypeScript validates props match the component's signature\n* at the call site, then stores the result in the loosely-typed VNode.\n*/\n/** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */\nconst EMPTY_PROPS = {};\nfunction h(type, props, ...children) {\n\treturn {\n\t\ttype,\n\t\tprops: props ?? EMPTY_PROPS,\n\t\tchildren: normalizeChildren(children),\n\t\tkey: props?.key ?? null\n\t};\n}\nfunction normalizeChildren(children) {\n\tfor (let i = 0; i < children.length; i++) if (Array.isArray(children[i])) return flattenChildren(children);\n\treturn children;\n}\nfunction flattenChildren(children) {\n\tconst result = [];\n\tfor (const child of children) if (Array.isArray(child)) result.push(...flattenChildren(child));\n\telse result.push(child);\n\treturn result;\n}\n\n//#endregion\n//#region src/jsx-runtime.ts\n/**\n* JSX automatic runtime.\n*\n* When tsconfig has `\"jsxImportSource\": \"@pyreon/core\"`, the TS/bundler compiler\n* rewrites JSX to imports from this file automatically:\n*   <div class=\"x\" />  →  jsx(\"div\", { class: \"x\" })\n*/\nfunction jsx(type, props, key) {\n\tconst { children, ...rest } = props;\n\tconst propsWithKey = key != null ? {\n\t\t...rest,\n\t\tkey\n\t} : rest;\n\tif (typeof type === \"function\") return h(type, children !== void 0 ? {\n\t\t...propsWithKey,\n\t\tchildren\n\t} : propsWithKey);\n\treturn h(type, propsWithKey, ...children === void 0 ? [] : Array.isArray(children) ? children : [children]);\n}\nconst jsxs = jsx;\n\n//#endregion\nexport { Fragment, jsx, jsxs };\n//# sourceMappingURL=jsx-runtime.js.map","import type { VNodeChild } from '@pyreon/core'\nimport { createRef } from '@pyreon/core'\nimport { signal } from '@pyreon/reactivity'\nimport type { FormatSource } from './image-plugin'\nimport { useIntersectionObserver } from './utils/use-intersection-observer'\n\n// ─── Image optimization component ───────────────────────────────────────────\n//\n// <Image> provides:\n// - Lazy loading via IntersectionObserver (loads when near viewport)\n// - Automatic width/height to prevent CLS (Cumulative Layout Shift)\n// - Responsive srcset generation from width descriptors\n// - Multi-format support via <picture> (WebP/AVIF with fallback)\n// - Blur-up placeholder while loading\n// - Priority loading for above-the-fold images\n\nexport interface ImageProps {\n  /** Image source URL. */\n  src: string\n  /** Alt text (required for accessibility). */\n  alt: string\n  /** Intrinsic width of the image. */\n  width: number\n  /** Intrinsic height of the image. */\n  height: number\n  /** Responsive sizes attribute. Default: \"100vw\" */\n  sizes?: string\n  /** Responsive srcset string or source array. */\n  srcset?: string | ImageSource[]\n  /** Per-format source sets for <picture>. Provided automatically by imagePlugin. */\n  formats?: FormatSource[]\n  /** Loading strategy. \"lazy\" uses IntersectionObserver, \"eager\" loads immediately. Default: \"lazy\" */\n  loading?: 'lazy' | 'eager'\n  /** Mark as priority (LCP image). Disables lazy loading, adds fetchpriority=\"high\". */\n  priority?: boolean\n  /** Low-quality placeholder image URL or base64 data URI for blur-up effect. */\n  placeholder?: string\n  /** CSS class name. */\n  class?: string\n  /** Inline styles. */\n  style?: string\n  /** CSS object-fit. Default: \"cover\" */\n  fit?: 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'\n  /** Decode async. Default: true */\n  decoding?: 'sync' | 'async' | 'auto'\n}\n\nexport interface ImageSource {\n  src: string\n  width: number\n}\n\n/**\n * Optimized image component with lazy loading, responsive images,\n * multi-format <picture> support, and blur-up placeholders.\n *\n * @example\n * // With imagePlugin — spread the import directly\n * import hero from \"./hero.jpg?optimize\"\n * <Image {...hero} alt=\"Hero\" priority />\n *\n * @example\n * // Manual usage\n * <Image src=\"/hero.jpg\" alt=\"Hero\" width={1200} height={630} />\n */\nexport function Image(props: ImageProps): VNodeChild {\n  const isEager = props.priority || props.loading === 'eager'\n  const loaded = signal(isEager)\n  const inView = signal(isEager)\n  const containerRef = createRef<HTMLElement>()\n\n  // Resolve srcset from string or array\n  const resolvedSrcset =\n    typeof props.srcset === 'string'\n      ? props.srcset\n      : props.srcset?.map((s) => `${s.src} ${s.width}w`).join(', ')\n\n  const sizes = props.sizes ?? '100vw'\n  const fit = props.fit ?? 'cover'\n  const hasFormats = props.formats && props.formats.length > 0\n  const aspectRatio = `${props.width} / ${props.height}`\n\n  if (!isEager) {\n    useIntersectionObserver(\n      () => containerRef.current ?? undefined,\n      () => inView.set(true),\n    )\n  }\n\n  // Static styles (don't depend on signals)\n  const containerStyle = [\n    'position: relative',\n    'overflow: hidden',\n    `aspect-ratio: ${aspectRatio}`,\n    `max-width: ${props.width}px`,\n    'width: 100%',\n    props.style,\n  ]\n    .filter(Boolean)\n    .join('; ')\n\n  const imgEl = (\n    <img\n      src={() => (inView() ? props.src : '')}\n      srcset={() =>\n        !hasFormats && inView() && resolvedSrcset ? resolvedSrcset : ''\n      }\n      sizes={resolvedSrcset ? sizes : undefined}\n      alt={props.alt}\n      width={props.width}\n      height={props.height}\n      loading={isEager ? 'eager' : 'lazy'}\n      decoding={props.decoding ?? 'async'}\n      fetchpriority={props.priority ? 'high' : undefined}\n      onload={() => loaded.set(true)}\n      style={() =>\n        [\n          'display: block',\n          'width: 100%',\n          'height: 100%',\n          `object-fit: ${fit}`,\n          'transition: opacity 0.3s ease',\n          props.placeholder && !loaded() ? 'opacity: 0' : 'opacity: 1',\n        ].join('; ')\n      }\n    />\n  )\n\n  return (\n    <div ref={containerRef} class={props.class} style={containerStyle}>\n      {props.placeholder && (\n        <img\n          src={props.placeholder}\n          alt=\"\"\n          aria-hidden=\"true\"\n          loading=\"eager\"\n          style={() =>\n            [\n              'position: absolute',\n              'inset: 0',\n              'width: 100%',\n              'height: 100%',\n              'object-fit: cover',\n              'filter: blur(20px)',\n              'transform: scale(1.1)',\n              'transition: opacity 0.4s ease',\n              loaded() ? 'opacity: 0; pointer-events: none' : 'opacity: 1',\n            ].join('; ')\n          }\n        />\n      )}\n      {hasFormats ? (\n        <picture>\n          {props.formats?.map((fmt) => (\n            <source\n              type={fmt.type}\n              srcset={() => (inView() ? fmt.srcset : undefined)}\n              sizes={sizes}\n            />\n          ))}\n          {imgEl}\n        </picture>\n      ) : (\n        imgEl\n      )}\n    </div>\n  )\n}\n"],"x_google_ignoreList":[1],"mappings":"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"}

package/lib/index.js

@@ -18,7 +18,7 @@ function createApp(options) {
 	const router = createRouter({
 		routes: options.routes,
 		mode: options.routerMode ?? "history",
-		url: options.url,
+		...options.url ? { url: options.url } : {},
 		scrollBehavior: "top"
 	});
 	const Layout = options.layout ?? DefaultLayout;
@@ -46,6 +46,7 @@ function matchApiRoute(pattern, path) {
 	const params = {};
 	for (let i = 0; i < patternParts.length; i++) {
 		const pp = patternParts[i];
+		if (!pp) continue;
 		if (pp.endsWith("*")) {
 			const paramName = pp.slice(1, -1);
 			params[paramName] = pathParts.slice(i).join("/");
@@ -152,8 +153,10 @@ function generateApiRouteModule(files, routesDir) {
 	const entries = [];
 	for (let i = 0; i < apiFiles.length; i++) {
 		const name = `_api${i}`;
-		const fullPath = `${routesDir}/${apiFiles[i]}`;
-		const pattern = apiFilePathToPattern(apiFiles[i]);
+		const file = apiFiles[i];
+		if (!file) continue;
+		const fullPath = `${routesDir}/${file}`;
+		const pattern = apiFilePathToPattern(file);
 		imports.push(`import * as ${name} from "${fullPath}"`);
 		entries.push(`  { pattern: ${JSON.stringify(pattern)}, module: ${name} }`);
 	}
@@ -188,6 +191,7 @@ function matchPattern(pattern, path) {
 	const pathParts = path.split("/").filter(Boolean);
 	for (let i = 0; i < patternParts.length; i++) {
 		const pp = patternParts[i];
+		if (!pp) continue;
 		if (pp.endsWith("*")) return true;
 		if (pp.startsWith(":")) continue;
 		if (pp !== pathParts[i]) return false;
@@ -220,8 +224,8 @@ function createServer(options) {
 		routes: options.routes,
 		middleware: allMiddleware,
 		mode: config.ssr?.mode ?? "string",
-		template: options.template,
-		clientEntry: options.clientEntry
+		...options.template ? { template: options.template } : {},
+		...options.clientEntry ? { clientEntry: options.clientEntry } : {}
 	});
 }
 
@@ -760,7 +764,7 @@ function useIntersectionObserver(getElement, onIntersect, rootMargin = "200px")
 }
 
 //#endregion
-//#region ../../node_modules/.bun/@pyreon+core@0.7.0/node_modules/@pyreon/core/lib/jsx-runtime.js
+//#region ../../node_modules/.bun/@pyreon+core@0.7.5/node_modules/@pyreon/core/lib/jsx-runtime.js
 /**
 * Hyperscript function — the compiled output of JSX.
 * `<div class="x">hello</div>` → `h("div", { class: "x" }, "hello")`
@@ -1016,10 +1020,12 @@ function createLink(Component) {
 			isActive: link.isActive,
 			isExactActive: link.isExactActive,
 			class: link.classes,
-			style: props.style,
-			target: props.external ? "_blank" : void 0,
-			rel: props.external ? "noopener noreferrer" : void 0,
-			"aria-label": props["aria-label"],
+			...props.style ? { style: props.style } : {},
+			...props.external ? {
+				target: "_blank",
+				rel: "noopener noreferrer"
+			} : {},
+			...props["aria-label"] ? { "aria-label": props["aria-label"] } : {},
 			children: props.children
 		});
 	};
@@ -1034,12 +1040,12 @@ function createLink(Component) {
 const Link = createLink((props) => /* @__PURE__ */ jsx("a", {
 	ref: props.ref,
 	href: props.href,
-	class: props.class,
-	style: props.style,
-	target: props.target,
-	rel: props.rel,
-	"aria-label": props["aria-label"],
-	"aria-current": props.isExactActive() ? "page" : void 0,
+	...props.class ? { class: props.class } : {},
+	...props.style ? { style: props.style } : {},
+	...props.target ? { target: props.target } : {},
+	...props.rel ? { rel: props.rel } : {},
+	...props["aria-label"] ? { "aria-label": props["aria-label"] } : {},
+	...props.isExactActive() ? { "aria-current": "page" } : {},
 	onclick: props.onClick,
 	onmouseenter: props.onMouseEnter,
 	ontouchstart: props.onTouchStart,
@@ -1224,24 +1230,25 @@ function resolveGoogleFont(input) {
 * Variable with italic: "Inter:ital,wght@100..900"
 */
 function parseGoogleFamily(input) {
-	const [familyPart, spec] = input.split(":");
-	const family = familyPart?.trim();
+	const parts = input.split(":");
+	const family = (parts[0] ?? "").trim();
+	const spec = parts[1];
 	let italic = false;
 	if (spec) {
 		italic = spec.includes("ital");
 		const rangeMatch = spec.match(/wght@(\d+)\.\.(\d+)/);
-		if (rangeMatch) return {
+		if (rangeMatch && rangeMatch[1] && rangeMatch[2]) return {
 			family,
 			italic,
 			variable: true,
 			weightRange: [Number(rangeMatch[1]), Number(rangeMatch[2])]
 		};
 		const weightMatch = spec.match(/wght@([\d;]+)/);
-		if (weightMatch) return {
+		if (weightMatch && weightMatch[1]) return {
 			family,
 			italic,
 			variable: false,
-			weights: weightMatch[1]?.split(";").map(Number)
+			weights: weightMatch[1].split(";").map(Number)
 		};
 	}
 	return {