@pyreon/zero 0.12.13 → 0.12.15

package/lib/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","names":[],"sources":["../src/i18n-routing.ts","../src/meta.tsx"],"sourcesContent":["import { createContext } from '@pyreon/core'\nimport { signal } from '@pyreon/reactivity'\nimport type { Plugin } from 'vite'\n\n// ─── Localized routing ─────────────────────────────────────────────────────\n//\n// Adds locale-prefixed routes to Zero's file-system router:\n// - /about → /en/about, /de/about, /cs/about\n// - / → /en, /de, /cs (or default locale without prefix)\n// - Automatic locale detection from Accept-Language header\n// - Redirect to preferred locale\n// - hreflang link generation\n//\n// Usage:\n//   import { i18nRouting } from \"@pyreon/zero\"\n//   export default { plugins: [zero(), i18nRouting({ locales: [\"en\", \"de\"], defaultLocale: \"en\" })] }\n\nexport interface I18nRoutingConfig {\n  /** Supported locales. e.g. [\"en\", \"de\", \"cs\"] */\n  locales: string[]\n  /** Default locale — served without prefix (/ instead of /en/). */\n  defaultLocale: string\n  /** Redirect root to detected locale. Default: true */\n  detectLocale?: boolean\n  /** Cookie name to persist locale preference. Default: \"locale\" */\n  cookieName?: string\n  /** URL strategy. Default: \"prefix-except-default\" */\n  strategy?: 'prefix' | 'prefix-except-default'\n}\n\nexport interface LocaleContext {\n  /** Current locale code. e.g. \"en\", \"de\" */\n  locale: string\n  /** All supported locales. */\n  locales: string[]\n  /** Default locale. */\n  defaultLocale: string\n  /** Build a localized path. e.g. localePath(\"/about\", \"de\") → \"/de/about\" */\n  localePath: (path: string, locale?: string) => string\n  /** Get hreflang alternates for the current path. */\n  alternates: () => Array<{ locale: string; url: string }>\n}\n\n/**\n * Detect preferred locale from Accept-Language header.\n */\nexport function detectLocaleFromHeader(\n  acceptLanguage: string | null | undefined,\n  locales: string[],\n  defaultLocale: string,\n): string {\n  if (!acceptLanguage) return defaultLocale\n\n  // Parse Accept-Language: en-US,en;q=0.9,de;q=0.8\n  const preferred = acceptLanguage\n    .split(',')\n    .map((part) => {\n      const [lang, q] = part.trim().split(';q=')\n      return {\n        lang: lang?.split('-')[0]?.toLowerCase() ?? '',\n        quality: q ? Number.parseFloat(q) : 1,\n      }\n    })\n    .sort((a, b) => b.quality - a.quality)\n\n  for (const { lang } of preferred) {\n    if (locales.includes(lang)) return lang\n  }\n\n  return defaultLocale\n}\n\n/**\n * Extract locale from a URL path.\n * Returns { locale, pathWithoutLocale }.\n */\nexport function extractLocaleFromPath(\n  path: string,\n  locales: string[],\n  defaultLocale: string,\n): { locale: string; pathWithoutLocale: string } {\n  const segments = path.split('/').filter(Boolean)\n  const firstSegment = segments[0]?.toLowerCase()\n\n  if (firstSegment && locales.includes(firstSegment)) {\n    return {\n      locale: firstSegment,\n      pathWithoutLocale: '/' + segments.slice(1).join('/') || '/',\n    }\n  }\n\n  return { locale: defaultLocale, pathWithoutLocale: path }\n}\n\n/**\n * Build a localized path.\n */\nexport function buildLocalePath(\n  path: string,\n  locale: string,\n  defaultLocale: string,\n  strategy: 'prefix' | 'prefix-except-default',\n): string {\n  const clean = path === '/' ? '' : path\n  if (strategy === 'prefix-except-default' && locale === defaultLocale) {\n    return path\n  }\n  return `/${locale}${clean}`\n}\n\n/**\n * Create a LocaleContext for use in components and loaders.\n */\nexport function createLocaleContext(\n  locale: string,\n  path: string,\n  config: I18nRoutingConfig,\n): LocaleContext {\n  const strategy = config.strategy ?? 'prefix-except-default'\n\n  return {\n    locale,\n    locales: config.locales,\n    defaultLocale: config.defaultLocale,\n\n    localePath(targetPath: string, targetLocale?: string) {\n      return buildLocalePath(\n        targetPath,\n        targetLocale ?? locale,\n        config.defaultLocale,\n        strategy,\n      )\n    },\n\n    alternates() {\n      const { pathWithoutLocale } = extractLocaleFromPath(\n        path,\n        config.locales,\n        config.defaultLocale,\n      )\n      return config.locales.map((loc) => ({\n        locale: loc,\n        url: buildLocalePath(pathWithoutLocale, loc, config.defaultLocale, strategy),\n      }))\n    },\n  }\n}\n\n/**\n * I18n routing middleware for Zero's server.\n *\n * - Detects locale from URL prefix or Accept-Language header\n * - Redirects root to preferred locale (when detectLocale is true)\n * - Sets locale context for loaders and components\n *\n * @example\n * ```ts\n * // zero.config.ts\n * import { i18nRouting } from \"@pyreon/zero\"\n *\n * export default defineConfig({\n *   plugins: [\n *     i18nRouting({\n *       locales: [\"en\", \"de\", \"cs\"],\n *       defaultLocale: \"en\",\n *     }),\n *   ],\n * })\n * ```\n */\nexport function i18nRouting(config: I18nRoutingConfig): Plugin {\n  const strategy = config.strategy ?? 'prefix-except-default'\n  const detectEnabled = config.detectLocale !== false\n  const cookieName = config.cookieName ?? 'locale'\n\n  return {\n    name: 'pyreon-zero-i18n-routing',\n\n    // Route duplication is NOT handled here. The fs-router's `scanRouteFiles`\n    // consumes the i18n config to duplicate routes per locale at build time.\n    // This plugin only provides: (1) the server middleware for locale detection\n    // and (2) the runtime hooks (useLocale, setLocale) for client-side use.\n    configResolved() {},\n\n    configureServer(server) {\n      server.middlewares.use((req, res, next) => {\n        const url = req.url ?? '/'\n\n        // Skip static assets\n        if (url.startsWith('/@') || url.startsWith('/__') || url.includes('.')) {\n          return next()\n        }\n\n        const { locale } = extractLocaleFromPath(\n          url,\n          config.locales,\n          config.defaultLocale,\n        )\n\n        // Redirect root to detected locale\n        if (detectEnabled && url === '/') {\n          const cookies = parseCookies(req.headers.cookie)\n          const preferredFromCookie = cookies[cookieName]\n          const preferredFromHeader = detectLocaleFromHeader(\n            req.headers['accept-language'],\n            config.locales,\n            config.defaultLocale,\n          )\n          const preferred = preferredFromCookie && config.locales.includes(preferredFromCookie)\n            ? preferredFromCookie\n            : preferredFromHeader\n\n          if (strategy === 'prefix' || preferred !== config.defaultLocale) {\n            res.writeHead(302, { Location: `/${preferred}/` })\n            res.end()\n            return\n          }\n        }\n\n        // Attach locale context to request for loaders\n        ;(req as any).__locale = locale\n        ;(req as any).__localeContext = createLocaleContext(locale, url, config)\n\n        // Update the module-level signal so useLocale() returns the correct value\n        localeSignal.set(locale)\n\n        next()\n      })\n    },\n  }\n}\n\nfunction parseCookies(header: string | undefined): Record<string, string> {\n  if (!header) return {}\n  const result: Record<string, string> = {}\n  for (const pair of header.split(';')) {\n    const [key, value] = pair.trim().split('=')\n    if (key && value) result[key] = decodeURIComponent(value)\n  }\n  return result\n}\n\n// ─── Reactive locale hook ───────────────────────────────────────────────────\n\n/** @internal Context for the current locale. */\nexport const LocaleCtx = createContext<string>('en')\n\n/** Current locale signal — set by the server middleware or client-side detection. */\nexport const localeSignal = signal('en')\n\n/**\n * Read the current locale reactively.\n *\n * Returns the locale signal value directly — reactive in both SSR and CSR.\n * The server middleware sets `localeSignal` per-request, and client-side\n * `setLocale()` updates it as well.\n *\n * @example\n * ```tsx\n * const locale = useLocale() // \"en\", \"de\", etc.\n * ```\n */\nexport function useLocale(): string {\n  return localeSignal()\n}\n\n/**\n * Set the locale client-side and update the URL.\n *\n * @example\n * ```tsx\n * <button onClick={() => setLocale('de')}>Deutsch</button>\n * ```\n */\nexport function setLocale(\n  locale: string,\n  config: I18nRoutingConfig,\n): void {\n  localeSignal.set(locale)\n\n  // Persist to cookie\n  if (typeof document !== 'undefined') {\n    document.cookie = `${config.cookieName ?? 'locale'}=${locale}; path=/; max-age=31536000`\n  }\n\n  // Navigate to localized URL — use pushState to avoid full page reload\n  if (typeof window !== 'undefined') {\n    const strategy = config.strategy ?? 'prefix-except-default'\n    const { pathWithoutLocale } = extractLocaleFromPath(\n      window.location.pathname,\n      config.locales,\n      config.defaultLocale,\n    )\n    const newPath = buildLocalePath(pathWithoutLocale, locale, config.defaultLocale, strategy)\n    window.history.pushState(null, '', newPath)\n    // Dispatch popstate so @pyreon/router picks up the URL change\n    window.dispatchEvent(new PopStateEvent('popstate'))\n  }\n}\n","import type { VNodeChild } from '@pyreon/core'\nimport type { UseHeadInput } from '@pyreon/head'\nimport { useHead } from '@pyreon/head'\nimport type { I18nRoutingConfig } from './i18n-routing'\nimport { extractLocaleFromPath } from './i18n-routing'\n\n// ─── Inline helpers (no node:fs dependency) ─────────────────────────────────\n// These are inlined to avoid importing from favicon.ts/og-image.ts which\n// pull in node:fs at the top level — making Meta unsafe for client bundles.\n\n/** Favicon plugin config shape (type-only). */\ninterface FaviconPluginConfig {\n  source: string\n  themeColor?: string\n  manifest?: boolean\n  locales?: Record<string, { source: string; darkSource?: string }>\n  [key: string]: unknown\n}\n\nfunction faviconLinks(\n  locale: string | undefined,\n  config: FaviconPluginConfig,\n): Array<{ rel: string; type?: string; sizes?: string; href: string }> {\n  const hasLocaleOverride = locale && config.locales?.[locale]\n  const prefix = hasLocaleOverride ? `/${locale}` : ''\n  const isSvg = (hasLocaleOverride ? config.locales![locale]!.source : config.source).endsWith('.svg')\n  const links: Array<{ rel: string; type?: string; sizes?: string; href: string }> = []\n  if (isSvg) links.push({ rel: 'icon', type: 'image/svg+xml', href: `${prefix}/favicon.svg` })\n  links.push(\n    { rel: 'icon', type: 'image/png', sizes: '32x32', href: `${prefix}/favicon-32x32.png` },\n    { rel: 'icon', type: 'image/png', sizes: '16x16', href: `${prefix}/favicon-16x16.png` },\n    { rel: 'apple-touch-icon', sizes: '180x180', href: `${prefix}/apple-touch-icon.png` },\n  )\n  if (config.manifest !== false) links.push({ rel: 'manifest', href: `${prefix}/site.webmanifest` })\n  return links\n}\n\nfunction ogImagePath(templateName: string, locale?: string, outDir = 'og', format: 'png' | 'jpeg' = 'png'): string {\n  const ext = format === 'jpeg' ? 'jpg' : 'png'\n  const suffix = locale ? `-${locale}` : ''\n  return `/${outDir}/${templateName}${suffix}.${ext}`\n}\n\n// ─── Meta component ────────────────────────────────────────────────────────\n\nexport interface MetaProps {\n  /** Page title. Accepts reactive accessor `() => string`. */\n  title?: string | (() => string)\n  /** Page description. Accepts reactive accessor. */\n  description?: string | (() => string)\n  /** Canonical URL. Also sets og:url. */\n  canonical?: string\n  /** Open Graph image URL. Also sets twitter:image. */\n  image?: string\n  /** Image alt text for accessibility. */\n  imageAlt?: string\n  /** Image width in pixels (og:image:width). Helps crawlers layout before loading. */\n  imageWidth?: number\n  /** Image height in pixels (og:image:height). */\n  imageHeight?: number\n  /** Open Graph type. Default: \"website\" */\n  type?: 'website' | 'article' | 'product' | 'profile'\n  /** Site name for og:site_name. */\n  siteName?: string\n  /** Twitter card type. Default: \"summary_large_image\" */\n  twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player'\n  /** Twitter @handle. */\n  twitterSite?: string\n  /** Twitter creator @handle. */\n  twitterCreator?: string\n  /** Locale. Default: \"en_US\" */\n  locale?: string\n  /** Alternate locales for hreflang. */\n  alternateLocales?: Array<{ locale: string; url: string }>\n  /** Robots directives. Default: \"index, follow\" */\n  robots?: string\n  /** Convenience: set `true` to emit `noindex, nofollow`. Overrides `robots`. */\n  noIndex?: boolean\n  /** Published time (ISO 8601) for article type. */\n  publishedTime?: string\n  /** Modified time (ISO 8601) for article type. */\n  modifiedTime?: string\n  /** Article author. */\n  author?: string\n  /** Article tags. */\n  tags?: string[]\n  /** JSON-LD structured data object. */\n  jsonLd?: Record<string, unknown>\n  /** Additional custom meta tags. */\n  extra?: Array<{ name?: string; property?: string; content: string }>\n  /**\n   * Open Graph video URL. Also sets og:video:type if the URL ends with\n   * a known extension (.mp4, .webm).\n   */\n  video?: string\n  /** Video width in pixels. */\n  videoWidth?: number\n  /** Video height in pixels. */\n  videoHeight?: number\n  /**\n   * Open Graph audio URL.\n   */\n  audio?: string\n  /**\n   * I18n routing config — when provided, auto-generates hreflang alternate\n   * links for all locales based on the current path.\n   * Also sets og:locale and og:locale:alternate.\n   */\n  i18n?: I18nRoutingConfig\n  /** Base URL for building absolute hreflang URLs. e.g. \"https://example.com\" */\n  origin?: string\n  /**\n   * Favicon plugin config — when provided, injects locale-aware favicon\n   * `<link>` tags into `<head>`. Uses the current locale to select\n   * the correct favicon set.\n   */\n  favicon?: FaviconPluginConfig\n  /**\n   * OG image template name — auto-resolves to the correct locale-specific\n   * OG image path generated by `ogImagePlugin`.\n   * Sets both `og:image` and `twitter:image` unless `image` is also provided.\n   */\n  ogTemplate?: string\n  /** Output directory for OG images. Default: \"og\" */\n  ogImageDir?: string\n  /** OG image format. Default: \"png\" */\n  ogImageFormat?: 'png' | 'jpeg'\n  children?: VNodeChild\n}\n\nconst resolveStr = (v: string | (() => string) | undefined): string | undefined =>\n  typeof v === 'function' ? v() : v\n\n/**\n * Declarative meta component for SSR-compatible page metadata.\n *\n * Supports reactive title/description — when passed as `() => string` accessors,\n * they are forwarded to `useHead()` as a reactive getter so updates propagate\n * automatically via signal tracking.\n *\n * @example\n * ```tsx\n * <Meta title=\"My Page\" description=\"...\" image=\"/og.jpg\" canonical=\"https://...\" />\n * ```\n *\n * @example Reactive title\n * ```tsx\n * const count = signal(0)\n * <Meta title={() => `${count()} items`} />\n * ```\n */\nexport function Meta(props: MetaProps): VNodeChild {\n  const hasReactiveTitle = typeof props.title === 'function'\n  const hasReactiveDescription = typeof props.description === 'function'\n\n  // If title or description are reactive accessors, pass a getter to useHead\n  // so it re-evaluates when the signals change.\n  if (hasReactiveTitle || hasReactiveDescription) {\n    useHead((): UseHeadInput => {\n      const title = resolveStr(props.title)\n      const description = resolveStr(props.description)\n      const resolved = { ...props, title, description } as Parameters<typeof buildMetaTags>[0]\n      const tags = buildMetaTags(resolved)\n      const input: UseHeadInput = { meta: tags.meta, link: tags.link, script: tags.script }\n      if (title) input.title = title\n      return input\n    })\n  } else {\n    const title = resolveStr(props.title)\n    const description = resolveStr(props.description)\n    const resolved = { ...props, title, description } as Parameters<typeof buildMetaTags>[0]\n    const tags = buildMetaTags(resolved)\n    const input: UseHeadInput = { meta: tags.meta, link: tags.link, script: tags.script }\n    if (title) input.title = title\n    useHead(input)\n  }\n\n  return props.children ?? null\n}\n\ninterface MetaTagEntry {\n  name?: string\n  property?: string\n  content: string\n  [key: string]: string | undefined\n}\n\ninterface LinkTagEntry {\n  rel: string\n  href?: string\n  hreflang?: string\n  type?: string\n  sizes?: string\n  [key: string]: string | undefined\n}\n\ninterface ScriptTagEntry {\n  type: string\n  children: string\n}\n\ninterface MetaTags {\n  meta: MetaTagEntry[]\n  link: LinkTagEntry[]\n  script: ScriptTagEntry[]\n}\n\nexport function buildMetaTags(\n  props: Omit<MetaProps, 'title' | 'description' | 'children'> & {\n    title?: string\n    description?: string\n  },\n): MetaTags {\n  const meta: MetaTagEntry[] = []\n  const link: LinkTagEntry[] = []\n  const script: ScriptTagEntry[] = []\n\n  const {\n    title, description, canonical, imageAlt, imageWidth, imageHeight,\n    type = 'website', siteName,\n    twitterCard = 'summary_large_image', twitterSite, twitterCreator,\n    locale = 'en_US', alternateLocales,\n    publishedTime, modifiedTime, author, tags, jsonLd, extra,\n    video, videoWidth, videoHeight, audio,\n    favicon, ogTemplate, ogImageDir, ogImageFormat,\n  } = props\n\n  // noIndex convenience overrides robots\n  const robots = props.noIndex ? 'noindex, nofollow' : (props.robots ?? 'index, follow')\n\n  // Resolve image: explicit `image` prop takes precedence over `ogTemplate`\n  const image = props.image ?? (\n    ogTemplate\n      ? ogImagePath(ogTemplate, locale !== 'en_US' ? locale : undefined, ogImageDir, ogImageFormat)\n      : undefined\n  )\n\n  // Auto-resolve image dimensions for OG template images\n  const resolvedImageWidth = imageWidth ?? (ogTemplate && !props.image ? 1200 : undefined)\n  const resolvedImageHeight = imageHeight ?? (ogTemplate && !props.image ? 630 : undefined)\n\n  if (description) meta.push({ name: 'description', content: description })\n  if (robots) meta.push({ name: 'robots', content: robots })\n  if (author) meta.push({ name: 'author', content: author })\n\n  if (title) meta.push({ property: 'og:title', content: title })\n  if (description) meta.push({ property: 'og:description', content: description })\n  if (canonical) meta.push({ property: 'og:url', content: canonical })\n  if (image) meta.push({ property: 'og:image', content: image })\n  if (imageAlt) meta.push({ property: 'og:image:alt', content: imageAlt })\n  if (resolvedImageWidth) meta.push({ property: 'og:image:width', content: String(resolvedImageWidth) })\n  if (resolvedImageHeight) meta.push({ property: 'og:image:height', content: String(resolvedImageHeight) })\n  meta.push({ property: 'og:type', content: type })\n  if (siteName) meta.push({ property: 'og:site_name', content: siteName })\n  meta.push({ property: 'og:locale', content: locale })\n\n  // Video\n  if (video) {\n    meta.push({ property: 'og:video', content: video })\n    if (videoWidth) meta.push({ property: 'og:video:width', content: String(videoWidth) })\n    if (videoHeight) meta.push({ property: 'og:video:height', content: String(videoHeight) })\n    // Auto-detect video type from extension\n    if (video.endsWith('.mp4')) meta.push({ property: 'og:video:type', content: 'video/mp4' })\n    else if (video.endsWith('.webm')) meta.push({ property: 'og:video:type', content: 'video/webm' })\n  }\n\n  // Audio\n  if (audio) {\n    meta.push({ property: 'og:audio', content: audio })\n  }\n\n  if (type === 'article') {\n    if (publishedTime) meta.push({ property: 'article:published_time', content: publishedTime })\n    if (modifiedTime) meta.push({ property: 'article:modified_time', content: modifiedTime })\n    if (author) meta.push({ property: 'article:author', content: author })\n    if (tags) for (const tag of tags) meta.push({ property: 'article:tag', content: tag })\n  }\n\n  meta.push({ name: 'twitter:card', content: twitterCard })\n  if (title) meta.push({ name: 'twitter:title', content: title })\n  if (description) meta.push({ name: 'twitter:description', content: description })\n  if (image) meta.push({ name: 'twitter:image', content: image })\n  if (imageAlt) meta.push({ name: 'twitter:image:alt', content: imageAlt })\n  if (twitterSite) meta.push({ name: 'twitter:site', content: twitterSite })\n  if (twitterCreator) meta.push({ name: 'twitter:creator', content: twitterCreator })\n\n  if (canonical) link.push({ rel: 'canonical', href: canonical })\n  if (alternateLocales) {\n    for (const alt of alternateLocales) {\n      link.push({ rel: 'alternate', hreflang: alt.locale, href: alt.url })\n    }\n  }\n\n  if (jsonLd) {\n    script.push({\n      type: 'application/ld+json',\n      children: JSON.stringify({ '@context': 'https://schema.org', ...jsonLd }),\n    })\n  }\n\n  if (extra) for (const tag of extra) meta.push(tag)\n\n  // I18n: auto-generate hreflang alternates from i18nRouting config\n  if (props.i18n) {\n    const i18nConfig = props.i18n\n    const origin = props.origin ?? ''\n    const currentPath = canonical?.replace(origin, '') ?? '/'\n    const { pathWithoutLocale } = extractLocaleFromPath(\n      currentPath,\n      i18nConfig.locales,\n      i18nConfig.defaultLocale,\n    )\n    const strategy = i18nConfig.strategy ?? 'prefix-except-default'\n\n    for (const loc of i18nConfig.locales) {\n      const localizedPath =\n        strategy === 'prefix-except-default' && loc === i18nConfig.defaultLocale\n          ? pathWithoutLocale\n          : `/${loc}${pathWithoutLocale === '/' ? '' : pathWithoutLocale}`\n\n      link.push({\n        rel: 'alternate',\n        hreflang: loc,\n        href: `${origin}${localizedPath}`,\n      })\n\n      // og:locale:alternate for non-current locales\n      if (loc !== locale) {\n        meta.push({ property: 'og:locale:alternate', content: loc })\n      }\n    }\n\n    // x-default hreflang pointing to default locale\n    link.push({\n      rel: 'alternate',\n      hreflang: 'x-default',\n      href: `${origin}${pathWithoutLocale}`,\n    })\n  }\n\n  // Favicon: inject locale-aware favicon links\n  if (favicon) {\n    const faviconLocale = locale !== 'en_US' ? locale : undefined\n    for (const fl of faviconLinks(faviconLocale, favicon)) {\n      link.push(fl as LinkTagEntry)\n    }\n    // Theme color meta from favicon config\n    if (favicon.themeColor) {\n      meta.push({ name: 'theme-color', content: favicon.themeColor })\n    }\n  }\n\n  return { meta, link, script }\n}\n"],"mappings":";;;;;;;;;AA4EA,SAAgB,sBACd,MACA,SACA,eAC+C;CAC/C,MAAM,WAAW,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ;CAChD,MAAM,eAAe,SAAS,IAAI,aAAa;AAE/C,KAAI,gBAAgB,QAAQ,SAAS,aAAa,CAChD,QAAO;EACL,QAAQ;EACR,mBAAmB,MAAM,SAAS,MAAM,EAAE,CAAC,KAAK,IAAI,IAAI;EACzD;AAGH,QAAO;EAAE,QAAQ;EAAe,mBAAmB;EAAM;;;AA0J3D,MAAa,YAAY,cAAsB,KAAK;;AAGpD,MAAa,eAAe,OAAO,KAAK;;;;ACrOxC,SAAS,aACP,QACA,QACqE;CACrE,MAAM,oBAAoB,UAAU,OAAO,UAAU;CACrD,MAAM,SAAS,oBAAoB,IAAI,WAAW;CAClD,MAAM,SAAS,oBAAoB,OAAO,QAAS,QAAS,SAAS,OAAO,QAAQ,SAAS,OAAO;CACpG,MAAM,QAA6E,EAAE;AACrF,KAAI,MAAO,OAAM,KAAK;EAAE,KAAK;EAAQ,MAAM;EAAiB,MAAM,GAAG,OAAO;EAAe,CAAC;AAC5F,OAAM,KACJ;EAAE,KAAK;EAAQ,MAAM;EAAa,OAAO;EAAS,MAAM,GAAG,OAAO;EAAqB,EACvF;EAAE,KAAK;EAAQ,MAAM;EAAa,OAAO;EAAS,MAAM,GAAG,OAAO;EAAqB,EACvF;EAAE,KAAK;EAAoB,OAAO;EAAW,MAAM,GAAG,OAAO;EAAwB,CACtF;AACD,KAAI,OAAO,aAAa,MAAO,OAAM,KAAK;EAAE,KAAK;EAAY,MAAM,GAAG,OAAO;EAAoB,CAAC;AAClG,QAAO;;AAGT,SAAS,YAAY,cAAsB,QAAiB,SAAS,MAAM,SAAyB,OAAe;CACjH,MAAM,MAAM,WAAW,SAAS,QAAQ;AAExC,QAAO,IAAI,OAAO,GAAG,eADN,SAAS,IAAI,WAAW,GACI,GAAG;;AA0FhD,MAAM,cAAc,MAClB,OAAO,MAAM,aAAa,GAAG,GAAG;;;;;;;;;;;;;;;;;;;AAoBlC,SAAgB,KAAK,OAA8B;CACjD,MAAM,mBAAmB,OAAO,MAAM,UAAU;CAChD,MAAM,yBAAyB,OAAO,MAAM,gBAAgB;AAI5D,KAAI,oBAAoB,uBACtB,eAA4B;EAC1B,MAAM,QAAQ,WAAW,MAAM,MAAM;EACrC,MAAM,cAAc,WAAW,MAAM,YAAY;EAEjD,MAAM,OAAO,cADI;GAAE,GAAG;GAAO;GAAO;GAAa,CACb;EACpC,MAAM,QAAsB;GAAE,MAAM,KAAK;GAAM,MAAM,KAAK;GAAM,QAAQ,KAAK;GAAQ;AACrF,MAAI,MAAO,OAAM,QAAQ;AACzB,SAAO;GACP;MACG;EACL,MAAM,QAAQ,WAAW,MAAM,MAAM;EACrC,MAAM,cAAc,WAAW,MAAM,YAAY;EAEjD,MAAM,OAAO,cADI;GAAE,GAAG;GAAO;GAAO;GAAa,CACb;EACpC,MAAM,QAAsB;GAAE,MAAM,KAAK;GAAM,MAAM,KAAK;GAAM,QAAQ,KAAK;GAAQ;AACrF,MAAI,MAAO,OAAM,QAAQ;AACzB,UAAQ,MAAM;;AAGhB,QAAO,MAAM,YAAY;;AA8B3B,SAAgB,cACd,OAIU;CACV,MAAM,OAAuB,EAAE;CAC/B,MAAM,OAAuB,EAAE;CAC/B,MAAM,SAA2B,EAAE;CAEnC,MAAM,EACJ,OAAO,aAAa,WAAW,UAAU,YAAY,aACrD,OAAO,WAAW,UAClB,cAAc,uBAAuB,aAAa,gBAClD,SAAS,SAAS,kBAClB,eAAe,cAAc,QAAQ,MAAM,QAAQ,OACnD,OAAO,YAAY,aAAa,OAChC,SAAS,YAAY,YAAY,kBAC/B;CAGJ,MAAM,SAAS,MAAM,UAAU,sBAAuB,MAAM,UAAU;CAGtE,MAAM,QAAQ,MAAM,UAClB,aACI,YAAY,YAAY,WAAW,UAAU,SAAS,QAAW,YAAY,cAAc,GAC3F;CAIN,MAAM,qBAAqB,eAAe,cAAc,CAAC,MAAM,QAAQ,OAAO;CAC9E,MAAM,sBAAsB,gBAAgB,cAAc,CAAC,MAAM,QAAQ,MAAM;AAE/E,KAAI,YAAa,MAAK,KAAK;EAAE,MAAM;EAAe,SAAS;EAAa,CAAC;AACzE,KAAI,OAAQ,MAAK,KAAK;EAAE,MAAM;EAAU,SAAS;EAAQ,CAAC;AAC1D,KAAI,OAAQ,MAAK,KAAK;EAAE,MAAM;EAAU,SAAS;EAAQ,CAAC;AAE1D,KAAI,MAAO,MAAK,KAAK;EAAE,UAAU;EAAY,SAAS;EAAO,CAAC;AAC9D,KAAI,YAAa,MAAK,KAAK;EAAE,UAAU;EAAkB,SAAS;EAAa,CAAC;AAChF,KAAI,UAAW,MAAK,KAAK;EAAE,UAAU;EAAU,SAAS;EAAW,CAAC;AACpE,KAAI,MAAO,MAAK,KAAK;EAAE,UAAU;EAAY,SAAS;EAAO,CAAC;AAC9D,KAAI,SAAU,MAAK,KAAK;EAAE,UAAU;EAAgB,SAAS;EAAU,CAAC;AACxE,KAAI,mBAAoB,MAAK,KAAK;EAAE,UAAU;EAAkB,SAAS,OAAO,mBAAmB;EAAE,CAAC;AACtG,KAAI,oBAAqB,MAAK,KAAK;EAAE,UAAU;EAAmB,SAAS,OAAO,oBAAoB;EAAE,CAAC;AACzG,MAAK,KAAK;EAAE,UAAU;EAAW,SAAS;EAAM,CAAC;AACjD,KAAI,SAAU,MAAK,KAAK;EAAE,UAAU;EAAgB,SAAS;EAAU,CAAC;AACxE,MAAK,KAAK;EAAE,UAAU;EAAa,SAAS;EAAQ,CAAC;AAGrD,KAAI,OAAO;AACT,OAAK,KAAK;GAAE,UAAU;GAAY,SAAS;GAAO,CAAC;AACnD,MAAI,WAAY,MAAK,KAAK;GAAE,UAAU;GAAkB,SAAS,OAAO,WAAW;GAAE,CAAC;AACtF,MAAI,YAAa,MAAK,KAAK;GAAE,UAAU;GAAmB,SAAS,OAAO,YAAY;GAAE,CAAC;AAEzF,MAAI,MAAM,SAAS,OAAO,CAAE,MAAK,KAAK;GAAE,UAAU;GAAiB,SAAS;GAAa,CAAC;WACjF,MAAM,SAAS,QAAQ,CAAE,MAAK,KAAK;GAAE,UAAU;GAAiB,SAAS;GAAc,CAAC;;AAInG,KAAI,MACF,MAAK,KAAK;EAAE,UAAU;EAAY,SAAS;EAAO,CAAC;AAGrD,KAAI,SAAS,WAAW;AACtB,MAAI,cAAe,MAAK,KAAK;GAAE,UAAU;GAA0B,SAAS;GAAe,CAAC;AAC5F,MAAI,aAAc,MAAK,KAAK;GAAE,UAAU;GAAyB,SAAS;GAAc,CAAC;AACzF,MAAI,OAAQ,MAAK,KAAK;GAAE,UAAU;GAAkB,SAAS;GAAQ,CAAC;AACtE,MAAI,KAAM,MAAK,MAAM,OAAO,KAAM,MAAK,KAAK;GAAE,UAAU;GAAe,SAAS;GAAK,CAAC;;AAGxF,MAAK,KAAK;EAAE,MAAM;EAAgB,SAAS;EAAa,CAAC;AACzD,KAAI,MAAO,MAAK,KAAK;EAAE,MAAM;EAAiB,SAAS;EAAO,CAAC;AAC/D,KAAI,YAAa,MAAK,KAAK;EAAE,MAAM;EAAuB,SAAS;EAAa,CAAC;AACjF,KAAI,MAAO,MAAK,KAAK;EAAE,MAAM;EAAiB,SAAS;EAAO,CAAC;AAC/D,KAAI,SAAU,MAAK,KAAK;EAAE,MAAM;EAAqB,SAAS;EAAU,CAAC;AACzE,KAAI,YAAa,MAAK,KAAK;EAAE,MAAM;EAAgB,SAAS;EAAa,CAAC;AAC1E,KAAI,eAAgB,MAAK,KAAK;EAAE,MAAM;EAAmB,SAAS;EAAgB,CAAC;AAEnF,KAAI,UAAW,MAAK,KAAK;EAAE,KAAK;EAAa,MAAM;EAAW,CAAC;AAC/D,KAAI,iBACF,MAAK,MAAM,OAAO,iBAChB,MAAK,KAAK;EAAE,KAAK;EAAa,UAAU,IAAI;EAAQ,MAAM,IAAI;EAAK,CAAC;AAIxE,KAAI,OACF,QAAO,KAAK;EACV,MAAM;EACN,UAAU,KAAK,UAAU;GAAE,YAAY;GAAsB,GAAG;GAAQ,CAAC;EAC1E,CAAC;AAGJ,KAAI,MAAO,MAAK,MAAM,OAAO,MAAO,MAAK,KAAK,IAAI;AAGlD,KAAI,MAAM,MAAM;EACd,MAAM,aAAa,MAAM;EACzB,MAAM,SAAS,MAAM,UAAU;EAE/B,MAAM,EAAE,sBAAsB,sBADV,WAAW,QAAQ,QAAQ,GAAG,IAAI,KAGpD,WAAW,SACX,WAAW,cACZ;EACD,MAAM,WAAW,WAAW,YAAY;AAExC,OAAK,MAAM,OAAO,WAAW,SAAS;GACpC,MAAM,gBACJ,aAAa,2BAA2B,QAAQ,WAAW,gBACvD,oBACA,IAAI,MAAM,sBAAsB,MAAM,KAAK;AAEjD,QAAK,KAAK;IACR,KAAK;IACL,UAAU;IACV,MAAM,GAAG,SAAS;IACnB,CAAC;AAGF,OAAI,QAAQ,OACV,MAAK,KAAK;IAAE,UAAU;IAAuB,SAAS;IAAK,CAAC;;AAKhE,OAAK,KAAK;GACR,KAAK;GACL,UAAU;GACV,MAAM,GAAG,SAAS;GACnB,CAAC;;AAIJ,KAAI,SAAS;EACX,MAAM,gBAAgB,WAAW,UAAU,SAAS;AACpD,OAAK,MAAM,MAAM,aAAa,eAAe,QAAQ,CACnD,MAAK,KAAK,GAAmB;AAG/B,MAAI,QAAQ,WACV,MAAK,KAAK;GAAE,MAAM;GAAe,SAAS,QAAQ;GAAY,CAAC;;AAInE,QAAO;EAAE;EAAM;EAAM;EAAQ"}
+{"version":3,"file":"meta.js","names":[],"sources":["../src/i18n-routing.ts","../src/meta.tsx"],"sourcesContent":["import { createContext } from '@pyreon/core'\nimport { signal } from '@pyreon/reactivity'\nimport type { Plugin } from 'vite'\n\n// ─── Localized routing ─────────────────────────────────────────────────────\n//\n// Adds locale-prefixed routes to Zero's file-system router:\n// - /about → /en/about, /de/about, /cs/about\n// - / → /en, /de, /cs (or default locale without prefix)\n// - Automatic locale detection from Accept-Language header\n// - Redirect to preferred locale\n// - hreflang link generation\n//\n// Usage:\n//   import { i18nRouting } from \"@pyreon/zero\"\n//   export default { plugins: [Pyreon], defaultLocale: \"en\" })] }\n\nexport interface I18nRoutingConfig {\n  /** Supported locales. e.g. [\"en\", \"de\", \"cs\"] */\n  locales: string[]\n  /** Default locale — served without prefix (/ instead of /en/). */\n  defaultLocale: string\n  /** Redirect root to detected locale. Default: true */\n  detectLocale?: boolean\n  /** Cookie name to persist locale preference. Default: \"locale\" */\n  cookieName?: string\n  /** URL strategy. Default: \"prefix-except-default\" */\n  strategy?: 'prefix' | 'prefix-except-default'\n}\n\nexport interface LocaleContext {\n  /** Current locale code. e.g. \"en\", \"de\" */\n  locale: string\n  /** All supported locales. */\n  locales: string[]\n  /** Default locale. */\n  defaultLocale: string\n  /** Build a localized path. e.g. localePath(\"/about\", \"de\") → \"/de/about\" */\n  localePath: (path: string, locale?: string) => string\n  /** Get hreflang alternates for the current path. */\n  alternates: () => Array<{ locale: string; url: string }>\n}\n\n/**\n * Detect preferred locale from Accept-Language header.\n */\nexport function detectLocaleFromHeader(\n  acceptLanguage: string | null | undefined,\n  locales: string[],\n  defaultLocale: string,\n): string {\n  if (!acceptLanguage) return defaultLocale\n\n  // Parse Accept-Language: en-US,en;q=0.9,de;q=0.8\n  const preferred = acceptLanguage\n    .split(',')\n    .map((part) => {\n      const [lang, q] = part.trim().split(';q=')\n      return {\n        lang: lang?.split('-')[0]?.toLowerCase() ?? '',\n        quality: q ? Number.parseFloat(q) : 1,\n      }\n    })\n    .sort((a, b) => b.quality - a.quality)\n\n  for (const { lang } of preferred) {\n    if (locales.includes(lang)) return lang\n  }\n\n  return defaultLocale\n}\n\n/**\n * Extract locale from a URL path.\n * Returns { locale, pathWithoutLocale }.\n */\nexport function extractLocaleFromPath(\n  path: string,\n  locales: string[],\n  defaultLocale: string,\n): { locale: string; pathWithoutLocale: string } {\n  const segments = path.split('/').filter(Boolean)\n  const firstSegment = segments[0]?.toLowerCase()\n\n  if (firstSegment && locales.includes(firstSegment)) {\n    return {\n      locale: firstSegment,\n      pathWithoutLocale: '/' + segments.slice(1).join('/') || '/',\n    }\n  }\n\n  return { locale: defaultLocale, pathWithoutLocale: path }\n}\n\n/**\n * Build a localized path.\n */\nexport function buildLocalePath(\n  path: string,\n  locale: string,\n  defaultLocale: string,\n  strategy: 'prefix' | 'prefix-except-default',\n): string {\n  const clean = path === '/' ? '' : path\n  if (strategy === 'prefix-except-default' && locale === defaultLocale) {\n    return path\n  }\n  return `/${locale}${clean}`\n}\n\n/**\n * Create a LocaleContext for use in components and loaders.\n */\nexport function createLocaleContext(\n  locale: string,\n  path: string,\n  config: I18nRoutingConfig,\n): LocaleContext {\n  const strategy = config.strategy ?? 'prefix-except-default'\n\n  return {\n    locale,\n    locales: config.locales,\n    defaultLocale: config.defaultLocale,\n\n    localePath(targetPath: string, targetLocale?: string) {\n      return buildLocalePath(\n        targetPath,\n        targetLocale ?? locale,\n        config.defaultLocale,\n        strategy,\n      )\n    },\n\n    alternates() {\n      const { pathWithoutLocale } = extractLocaleFromPath(\n        path,\n        config.locales,\n        config.defaultLocale,\n      )\n      return config.locales.map((loc) => ({\n        locale: loc,\n        url: buildLocalePath(pathWithoutLocale, loc, config.defaultLocale, strategy),\n      }))\n    },\n  }\n}\n\n/**\n * I18n routing middleware for Zero's server.\n *\n * - Detects locale from URL prefix or Accept-Language header\n * - Redirects root to preferred locale (when detectLocale is true)\n * - Sets locale context for loaders and components\n *\n * @example\n * ```ts\n * // zero.config.ts\n * import { i18nRouting } from \"@pyreon/zero\"\n *\n * export default defineConfig({\n *   plugins: [\n *     i18nRouting({\n *       locales: [\"en\", \"de\", \"cs\"],\n *       defaultLocale: \"en\",\n *     }),\n *   ],\n * })\n * ```\n */\nexport function i18nRouting(config: I18nRoutingConfig): Plugin {\n  const strategy = config.strategy ?? 'prefix-except-default'\n  const detectEnabled = config.detectLocale !== false\n  const cookieName = config.cookieName ?? 'locale'\n\n  return {\n    name: 'pyreon-zero-i18n-routing',\n\n    // Route duplication is NOT handled here. The fs-router's `scanRouteFiles`\n    // consumes the i18n config to duplicate routes per locale at build time.\n    // This plugin only provides: (1) the server middleware for locale detection\n    // and (2) the runtime hooks (useLocale, setLocale) for client-side use.\n    configResolved() {},\n\n    configureServer(server) {\n      server.middlewares.use((req, res, next) => {\n        const url = req.url ?? '/'\n\n        // Skip static assets\n        if (url.startsWith('/@') || url.startsWith('/__') || url.includes('.')) {\n          return next()\n        }\n\n        const { locale } = extractLocaleFromPath(\n          url,\n          config.locales,\n          config.defaultLocale,\n        )\n\n        // Redirect root to detected locale\n        if (detectEnabled && url === '/') {\n          const cookies = parseCookies(req.headers.cookie)\n          const preferredFromCookie = cookies[cookieName]\n          const preferredFromHeader = detectLocaleFromHeader(\n            req.headers['accept-language'],\n            config.locales,\n            config.defaultLocale,\n          )\n          const preferred = preferredFromCookie && config.locales.includes(preferredFromCookie)\n            ? preferredFromCookie\n            : preferredFromHeader\n\n          if (strategy === 'prefix' || preferred !== config.defaultLocale) {\n            res.writeHead(302, { Location: `/${preferred}/` })\n            res.end()\n            return\n          }\n        }\n\n        // Attach locale context to request for loaders\n        ;(req as any).__locale = locale\n        ;(req as any).__localeContext = createLocaleContext(locale, url, config)\n\n        // Update the module-level signal so useLocale() returns the correct value\n        localeSignal.set(locale)\n\n        next()\n      })\n    },\n  }\n}\n\nfunction parseCookies(header: string | undefined): Record<string, string> {\n  if (!header) return {}\n  const result: Record<string, string> = {}\n  for (const pair of header.split(';')) {\n    const [key, value] = pair.trim().split('=')\n    if (key && value) result[key] = decodeURIComponent(value)\n  }\n  return result\n}\n\n// ─── Reactive locale hook ───────────────────────────────────────────────────\n\n/** @internal Context for the current locale. */\nexport const LocaleCtx = createContext<string>('en')\n\n/** Current locale signal — set by the server middleware or client-side detection. */\nexport const localeSignal = signal('en')\n\n/**\n * Read the current locale reactively.\n *\n * Returns the locale signal value directly — reactive in both SSR and CSR.\n * The server middleware sets `localeSignal` per-request, and client-side\n * `setLocale()` updates it as well.\n *\n * @example\n * ```tsx\n * const locale = useLocale() // \"en\", \"de\", etc.\n * ```\n */\nexport function useLocale(): string {\n  return localeSignal()\n}\n\n/**\n * Set the locale client-side and update the URL.\n *\n * @example\n * ```tsx\n * <button onClick={() => setLocale('de')}>Deutsch</button>\n * ```\n */\nexport function setLocale(\n  locale: string,\n  config: I18nRoutingConfig,\n): void {\n  localeSignal.set(locale)\n\n  // Persist to cookie\n  if (typeof document !== 'undefined') {\n    document.cookie = `${config.cookieName ?? 'locale'}=${locale}; path=/; max-age=31536000`\n  }\n\n  // Navigate to localized URL — use pushState to avoid full page reload\n  if (typeof window !== 'undefined') {\n    const strategy = config.strategy ?? 'prefix-except-default'\n    const { pathWithoutLocale } = extractLocaleFromPath(\n      window.location.pathname,\n      config.locales,\n      config.defaultLocale,\n    )\n    const newPath = buildLocalePath(pathWithoutLocale, locale, config.defaultLocale, strategy)\n    window.history.pushState(null, '', newPath)\n    // Dispatch popstate so @pyreon/router picks up the URL change\n    window.dispatchEvent(new PopStateEvent('popstate'))\n  }\n}\n","import type { VNodeChild } from '@pyreon/core'\nimport type { UseHeadInput } from '@pyreon/head'\nimport { useHead } from '@pyreon/head'\nimport type { I18nRoutingConfig } from './i18n-routing'\nimport { extractLocaleFromPath } from './i18n-routing'\n\n// ─── Inline helpers (no node:fs dependency) ─────────────────────────────────\n// These are inlined to avoid importing from favicon.ts/og-image.ts which\n// pull in node:fs at the top level — making Meta unsafe for client bundles.\n\n/** Favicon plugin config shape (type-only). */\ninterface FaviconPluginConfig {\n  source: string\n  themeColor?: string\n  manifest?: boolean\n  locales?: Record<string, { source: string; darkSource?: string }>\n  [key: string]: unknown\n}\n\nfunction faviconLinks(\n  locale: string | undefined,\n  config: FaviconPluginConfig,\n): Array<{ rel: string; type?: string; sizes?: string; href: string }> {\n  const hasLocaleOverride = locale && config.locales?.[locale]\n  const prefix = hasLocaleOverride ? `/${locale}` : ''\n  const isSvg = (hasLocaleOverride ? config.locales![locale]!.source : config.source).endsWith('.svg')\n  const links: Array<{ rel: string; type?: string; sizes?: string; href: string }> = []\n  if (isSvg) links.push({ rel: 'icon', type: 'image/svg+xml', href: `${prefix}/favicon.svg` })\n  links.push(\n    { rel: 'icon', type: 'image/png', sizes: '32x32', href: `${prefix}/favicon-32x32.png` },\n    { rel: 'icon', type: 'image/png', sizes: '16x16', href: `${prefix}/favicon-16x16.png` },\n    { rel: 'apple-touch-icon', sizes: '180x180', href: `${prefix}/apple-touch-icon.png` },\n  )\n  if (config.manifest !== false) links.push({ rel: 'manifest', href: `${prefix}/site.webmanifest` })\n  return links\n}\n\nfunction ogImagePath(templateName: string, locale?: string, outDir = 'og', format: 'png' | 'jpeg' = 'png'): string {\n  const ext = format === 'jpeg' ? 'jpg' : 'png'\n  const suffix = locale ? `-${locale}` : ''\n  return `/${outDir}/${templateName}${suffix}.${ext}`\n}\n\n// ─── Meta component ────────────────────────────────────────────────────────\n\nexport interface MetaProps {\n  /** Page title. Accepts reactive accessor `() => string`. */\n  title?: string | (() => string)\n  /** Page description. Accepts reactive accessor. */\n  description?: string | (() => string)\n  /** Canonical URL. Also sets og:url. */\n  canonical?: string\n  /** Open Graph image URL. Also sets twitter:image. */\n  image?: string\n  /** Image alt text for accessibility. */\n  imageAlt?: string\n  /** Image width in pixels (og:image:width). Helps crawlers layout before loading. */\n  imageWidth?: number\n  /** Image height in pixels (og:image:height). */\n  imageHeight?: number\n  /** Open Graph type. Default: \"website\" */\n  type?: 'website' | 'article' | 'product' | 'profile'\n  /** Site name for og:site_name. */\n  siteName?: string\n  /** Twitter card type. Default: \"summary_large_image\" */\n  twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player'\n  /** Twitter @handle. */\n  twitterSite?: string\n  /** Twitter creator @handle. */\n  twitterCreator?: string\n  /** Locale. Default: \"en_US\" */\n  locale?: string\n  /** Alternate locales for hreflang. */\n  alternateLocales?: Array<{ locale: string; url: string }>\n  /** Robots directives. Default: \"index, follow\" */\n  robots?: string\n  /** Convenience: set `true` to emit `noindex, nofollow`. Overrides `robots`. */\n  noIndex?: boolean\n  /** Published time (ISO 8601) for article type. */\n  publishedTime?: string\n  /** Modified time (ISO 8601) for article type. */\n  modifiedTime?: string\n  /** Article author. */\n  author?: string\n  /** Article tags. */\n  tags?: string[]\n  /** JSON-LD structured data object. */\n  jsonLd?: Record<string, unknown>\n  /** Additional custom meta tags. */\n  extra?: Array<{ name?: string; property?: string; content: string }>\n  /**\n   * Open Graph video URL. Also sets og:video:type if the URL ends with\n   * a known extension (.mp4, .webm).\n   */\n  video?: string\n  /** Video width in pixels. */\n  videoWidth?: number\n  /** Video height in pixels. */\n  videoHeight?: number\n  /**\n   * Open Graph audio URL.\n   */\n  audio?: string\n  /**\n   * I18n routing config — when provided, auto-generates hreflang alternate\n   * links for all locales based on the current path.\n   * Also sets og:locale and og:locale:alternate.\n   */\n  i18n?: I18nRoutingConfig\n  /** Base URL for building absolute hreflang URLs. e.g. \"https://example.com\" */\n  origin?: string\n  /**\n   * Favicon plugin config — when provided, injects locale-aware favicon\n   * `<link>` tags into `<head>`. Uses the current locale to select\n   * the correct favicon set.\n   */\n  favicon?: FaviconPluginConfig\n  /**\n   * OG image template name — auto-resolves to the correct locale-specific\n   * OG image path generated by `ogImagePlugin`.\n   * Sets both `og:image` and `twitter:image` unless `image` is also provided.\n   */\n  ogTemplate?: string\n  /** Output directory for OG images. Default: \"og\" */\n  ogImageDir?: string\n  /** OG image format. Default: \"png\" */\n  ogImageFormat?: 'png' | 'jpeg'\n  children?: VNodeChild\n}\n\nconst resolveStr = (v: string | (() => string) | undefined): string | undefined =>\n  typeof v === 'function' ? v() : v\n\n/**\n * Declarative meta component for SSR-compatible page metadata.\n *\n * Supports reactive title/description — when passed as `() => string` accessors,\n * they are forwarded to `useHead()` as a reactive getter so updates propagate\n * automatically via signal tracking.\n *\n * @example\n * ```tsx\n * <Meta title=\"My Page\" description=\"...\" image=\"/og.jpg\" canonical=\"https://...\" />\n * ```\n *\n * @example Reactive title\n * ```tsx\n * const count = signal(0)\n * <Meta title={() => `${count()} items`} />\n * ```\n */\nexport function Meta(props: MetaProps): VNodeChild {\n  const hasReactiveTitle = typeof props.title === 'function'\n  const hasReactiveDescription = typeof props.description === 'function'\n\n  // If title or description are reactive accessors, pass a getter to useHead\n  // so it re-evaluates when the signals change.\n  if (hasReactiveTitle || hasReactiveDescription) {\n    useHead((): UseHeadInput => {\n      const title = resolveStr(props.title)\n      const description = resolveStr(props.description)\n      const resolved = { ...props, title, description } as Parameters<typeof buildMetaTags>[0]\n      const tags = buildMetaTags(resolved)\n      const input: UseHeadInput = { meta: tags.meta, link: tags.link, script: tags.script }\n      if (title) input.title = title\n      return input\n    })\n  } else {\n    const title = resolveStr(props.title)\n    const description = resolveStr(props.description)\n    const resolved = { ...props, title, description } as Parameters<typeof buildMetaTags>[0]\n    const tags = buildMetaTags(resolved)\n    const input: UseHeadInput = { meta: tags.meta, link: tags.link, script: tags.script }\n    if (title) input.title = title\n    useHead(input)\n  }\n\n  return props.children ?? null\n}\n\ninterface MetaTagEntry {\n  name?: string\n  property?: string\n  content: string\n  [key: string]: string | undefined\n}\n\ninterface LinkTagEntry {\n  rel: string\n  href?: string\n  hreflang?: string\n  type?: string\n  sizes?: string\n  [key: string]: string | undefined\n}\n\ninterface ScriptTagEntry {\n  type: string\n  children: string\n}\n\ninterface MetaTags {\n  meta: MetaTagEntry[]\n  link: LinkTagEntry[]\n  script: ScriptTagEntry[]\n}\n\nexport function buildMetaTags(\n  props: Omit<MetaProps, 'title' | 'description' | 'children'> & {\n    title?: string\n    description?: string\n  },\n): MetaTags {\n  const meta: MetaTagEntry[] = []\n  const link: LinkTagEntry[] = []\n  const script: ScriptTagEntry[] = []\n\n  const {\n    title, description, canonical, imageAlt, imageWidth, imageHeight,\n    type = 'website', siteName,\n    twitterCard = 'summary_large_image', twitterSite, twitterCreator,\n    locale = 'en_US', alternateLocales,\n    publishedTime, modifiedTime, author, tags, jsonLd, extra,\n    video, videoWidth, videoHeight, audio,\n    favicon, ogTemplate, ogImageDir, ogImageFormat,\n  } = props\n\n  // noIndex convenience overrides robots\n  const robots = props.noIndex ? 'noindex, nofollow' : (props.robots ?? 'index, follow')\n\n  // Resolve image: explicit `image` prop takes precedence over `ogTemplate`\n  const image = props.image ?? (\n    ogTemplate\n      ? ogImagePath(ogTemplate, locale !== 'en_US' ? locale : undefined, ogImageDir, ogImageFormat)\n      : undefined\n  )\n\n  // Auto-resolve image dimensions for OG template images\n  const resolvedImageWidth = imageWidth ?? (ogTemplate && !props.image ? 1200 : undefined)\n  const resolvedImageHeight = imageHeight ?? (ogTemplate && !props.image ? 630 : undefined)\n\n  if (description) meta.push({ name: 'description', content: description })\n  if (robots) meta.push({ name: 'robots', content: robots })\n  if (author) meta.push({ name: 'author', content: author })\n\n  if (title) meta.push({ property: 'og:title', content: title })\n  if (description) meta.push({ property: 'og:description', content: description })\n  if (canonical) meta.push({ property: 'og:url', content: canonical })\n  if (image) meta.push({ property: 'og:image', content: image })\n  if (imageAlt) meta.push({ property: 'og:image:alt', content: imageAlt })\n  if (resolvedImageWidth) meta.push({ property: 'og:image:width', content: String(resolvedImageWidth) })\n  if (resolvedImageHeight) meta.push({ property: 'og:image:height', content: String(resolvedImageHeight) })\n  meta.push({ property: 'og:type', content: type })\n  if (siteName) meta.push({ property: 'og:site_name', content: siteName })\n  meta.push({ property: 'og:locale', content: locale })\n\n  // Video\n  if (video) {\n    meta.push({ property: 'og:video', content: video })\n    if (videoWidth) meta.push({ property: 'og:video:width', content: String(videoWidth) })\n    if (videoHeight) meta.push({ property: 'og:video:height', content: String(videoHeight) })\n    // Auto-detect video type from extension\n    if (video.endsWith('.mp4')) meta.push({ property: 'og:video:type', content: 'video/mp4' })\n    else if (video.endsWith('.webm')) meta.push({ property: 'og:video:type', content: 'video/webm' })\n  }\n\n  // Audio\n  if (audio) {\n    meta.push({ property: 'og:audio', content: audio })\n  }\n\n  if (type === 'article') {\n    if (publishedTime) meta.push({ property: 'article:published_time', content: publishedTime })\n    if (modifiedTime) meta.push({ property: 'article:modified_time', content: modifiedTime })\n    if (author) meta.push({ property: 'article:author', content: author })\n    if (tags) for (const tag of tags) meta.push({ property: 'article:tag', content: tag })\n  }\n\n  meta.push({ name: 'twitter:card', content: twitterCard })\n  if (title) meta.push({ name: 'twitter:title', content: title })\n  if (description) meta.push({ name: 'twitter:description', content: description })\n  if (image) meta.push({ name: 'twitter:image', content: image })\n  if (imageAlt) meta.push({ name: 'twitter:image:alt', content: imageAlt })\n  if (twitterSite) meta.push({ name: 'twitter:site', content: twitterSite })\n  if (twitterCreator) meta.push({ name: 'twitter:creator', content: twitterCreator })\n\n  if (canonical) link.push({ rel: 'canonical', href: canonical })\n  if (alternateLocales) {\n    for (const alt of alternateLocales) {\n      link.push({ rel: 'alternate', hreflang: alt.locale, href: alt.url })\n    }\n  }\n\n  if (jsonLd) {\n    script.push({\n      type: 'application/ld+json',\n      children: JSON.stringify({ '@context': 'https://schema.org', ...jsonLd }),\n    })\n  }\n\n  if (extra) for (const tag of extra) meta.push(tag)\n\n  // I18n: auto-generate hreflang alternates from i18nRouting config\n  if (props.i18n) {\n    const i18nConfig = props.i18n\n    const origin = props.origin ?? ''\n    const currentPath = canonical?.replace(origin, '') ?? '/'\n    const { pathWithoutLocale } = extractLocaleFromPath(\n      currentPath,\n      i18nConfig.locales,\n      i18nConfig.defaultLocale,\n    )\n    const strategy = i18nConfig.strategy ?? 'prefix-except-default'\n\n    for (const loc of i18nConfig.locales) {\n      const localizedPath =\n        strategy === 'prefix-except-default' && loc === i18nConfig.defaultLocale\n          ? pathWithoutLocale\n          : `/${loc}${pathWithoutLocale === '/' ? '' : pathWithoutLocale}`\n\n      link.push({\n        rel: 'alternate',\n        hreflang: loc,\n        href: `${origin}${localizedPath}`,\n      })\n\n      // og:locale:alternate for non-current locales\n      if (loc !== locale) {\n        meta.push({ property: 'og:locale:alternate', content: loc })\n      }\n    }\n\n    // x-default hreflang pointing to default locale\n    link.push({\n      rel: 'alternate',\n      hreflang: 'x-default',\n      href: `${origin}${pathWithoutLocale}`,\n    })\n  }\n\n  // Favicon: inject locale-aware favicon links\n  if (favicon) {\n    const faviconLocale = locale !== 'en_US' ? locale : undefined\n    for (const fl of faviconLinks(faviconLocale, favicon)) {\n      link.push(fl as LinkTagEntry)\n    }\n    // Theme color meta from favicon config\n    if (favicon.themeColor) {\n      meta.push({ name: 'theme-color', content: favicon.themeColor })\n    }\n  }\n\n  return { meta, link, script }\n}\n"],"mappings":"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"}

package/lib/og-image.js

@@ -36,7 +36,7 @@ let sharpWarned = false;
 function warnSharpMissing() {
 	if (sharpWarned) return;
 	sharpWarned = true;
-	console.warn("\n[zero:og-image] sharp not installed — OG images will not be generated. Install for full support: bun add -D sharp\n");
+	console.warn("\n[Pyreon] sharp not installed — OG images will not be generated. Install for full support: bun add -D sharp\n");
 }
 function resolvePosition(value, dimension, fallback = "50%") {
 	if (value === void 0) value = fallback;
@@ -210,7 +210,7 @@ function ogImagePlugin(config) {
 					if (typeof template.background === "string") {
 						const bgPath = join(root, template.background);
 						if (!existsSync(bgPath)) {
-							console.warn(`[zero:og-image] Background not found: ${bgPath}`);
+							console.warn(`[Pyreon] Background not found: ${bgPath}`);
 							continue;
 						}
 					}

package/lib/og-image.js.map

@@ -1 +1 @@
-{"version":3,"file":"og-image.js","names":[],"sources":["../src/og-image.ts"],"sourcesContent":["/**\n * OG Image generation plugin.\n *\n * Generates Open Graph images at build time from templates with\n * text overlays. Supports locale-specific text for i18n apps.\n * Uses sharp for image processing (same optional dep as favicon/image plugins).\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { ogImagePlugin } from \"@pyreon/zero/og-image\"\n *\n * export default {\n *   plugins: [\n *     ogImagePlugin({\n *       locales: [\"en\", \"de\", \"cs\"],\n *       templates: [{\n *         name: \"default\",\n *         background: \"./src/assets/og-bg.jpg\",\n *         layers: [{\n *           text: { en: \"Build faster\", de: \"Schneller bauen\", cs: \"Stavte rychleji\" },\n *           y: \"40%\",\n *           fontSize: 72,\n *         }],\n *       }],\n *     }),\n *   ],\n * }\n * ```\n */\nimport { existsSync } from 'node:fs'\nimport { join } from 'node:path'\nimport type { Plugin } from 'vite'\n\nlet sharpWarned = false\nfunction warnSharpMissing() {\n  if (sharpWarned) return\n  sharpWarned = true\n  // oxlint-disable-next-line no-console\n  console.warn(\n    '\\n[zero:og-image] sharp not installed — OG images will not be generated. Install for full support: bun add -D sharp\\n',\n  )\n}\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nexport interface OgImageLayer {\n  /**\n   * Text content. Can be:\n   * - A string (same for all locales)\n   * - A record mapping locale → text\n   * - A function receiving locale and returning text\n   */\n  text: string | Record<string, string> | ((locale: string) => string)\n  /** X position — number (px) or string with % (e.g. \"50%\"). Default: \"50%\" */\n  x?: number | string\n  /** Y position — number (px) or string with % (e.g. \"40%\"). Default: \"50%\" */\n  y?: number | string\n  /** Font size in px. Default: 64 */\n  fontSize?: number\n  /** Font family. Default: \"sans-serif\" */\n  fontFamily?: string\n  /** Font weight. Default: \"bold\" */\n  fontWeight?: string\n  /** Text color. Default: \"#ffffff\" */\n  color?: string\n  /** Text anchor (alignment). Default: \"middle\" */\n  textAnchor?: 'start' | 'middle' | 'end'\n  /** Max width in px before wrapping. Default: 80% of image width. */\n  maxWidth?: number\n}\n\nexport interface OgImageTemplate {\n  /** Template name — used for output file naming. */\n  name: string\n  /**\n   * Background: path to an image file, or a solid color config.\n   *\n   * @example \"./src/assets/og-bg.jpg\"\n   * @example { color: \"#0066ff\", width: 1200, height: 630 }\n   */\n  background: string | { color: string; width?: number; height?: number }\n  /** Output width. Default: 1200 */\n  width?: number\n  /** Output height. Default: 630 */\n  height?: number\n  /** Output format. Default: \"png\" */\n  format?: 'png' | 'jpeg'\n  /** JPEG quality (1-100). Default: 90 */\n  quality?: number\n  /** Text layers to overlay on the background. */\n  layers?: OgImageLayer[]\n}\n\nexport interface OgImagePluginConfig {\n  /** Templates to generate. */\n  templates: OgImageTemplate[]\n  /** Locales to generate for. When omitted, generates a single image per template. */\n  locales?: string[]\n  /** Output directory prefix. Default: \"og\" */\n  outDir?: string\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nfunction resolvePosition(value: number | string | undefined, dimension: number, fallback = '50%'): number {\n  if (value === undefined) value = fallback\n  if (typeof value === 'number') return value\n  if (value.endsWith('%')) return Math.round((Number.parseFloat(value) / 100) * dimension)\n  return Number.parseInt(value, 10) || 0\n}\n\nfunction resolveLayerText(layer: OgImageLayer, locale: string): string {\n  if (typeof layer.text === 'string') return layer.text\n  if (typeof layer.text === 'function') return layer.text(locale)\n  return layer.text[locale] ?? layer.text[Object.keys(layer.text)[0] ?? ''] ?? ''\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;')\n}\n\n/**\n * Build an SVG overlay with text layers.\n * @internal Exported for testing.\n */\nexport function buildTextOverlaySvg(\n  layers: OgImageLayer[],\n  width: number,\n  height: number,\n  locale: string,\n): string {\n  const textElements = layers.map((layer) => {\n    const text = resolveLayerText(layer, locale)\n    const x = resolvePosition(layer.x, width, '50%')\n    const y = resolvePosition(layer.y, height, '50%')\n    const fontSize = layer.fontSize ?? 64\n    const fontFamily = layer.fontFamily ?? 'sans-serif'\n    const fontWeight = layer.fontWeight ?? 'bold'\n    const color = layer.color ?? '#ffffff'\n    const anchor = layer.textAnchor ?? 'middle'\n    const maxWidth = layer.maxWidth ?? Math.round(width * 0.8)\n\n    // Word wrapping via tspan elements.\n    // Width estimation: Latin chars ~0.55em, CJK chars ~1.0em, narrow chars ~0.35em.\n    const words = text.split(' ')\n    const lines: string[] = []\n    let currentLine = ''\n\n    const estimateWidth = (s: string): number => {\n      let width = 0\n      for (let i = 0; i < s.length; i++) {\n        const code = s.charCodeAt(i)\n        if (code >= 0x3000 && code <= 0x9FFF) {\n          // CJK characters — full width\n          width += fontSize * 1.0\n        } else if (code <= 0x7E && 'iljft!|:;.,\\''.includes(s[i]!)) {\n          // Narrow Latin characters\n          width += fontSize * 0.35\n        } else {\n          // Regular Latin characters\n          width += fontSize * 0.55\n        }\n      }\n      return width\n    }\n\n    for (const word of words) {\n      const testLine = currentLine ? `${currentLine} ${word}` : word\n      if (estimateWidth(testLine) > maxWidth && currentLine) {\n        lines.push(currentLine)\n        currentLine = word\n      } else {\n        currentLine = testLine\n      }\n    }\n    if (currentLine) lines.push(currentLine)\n\n    const tspans = lines\n      .map((line, i) => {\n        const dy = i === 0 ? '0' : `${fontSize * 1.2}`\n        return `<tspan x=\"${x}\" dy=\"${dy}\">${escapeXml(line)}</tspan>`\n      })\n      .join('')\n\n    return `<text x=\"${x}\" y=\"${y}\" font-size=\"${fontSize}\" font-family=\"${escapeXml(fontFamily)}\" font-weight=\"${fontWeight}\" fill=\"${color}\" text-anchor=\"${anchor}\" dominant-baseline=\"middle\">${tspans}</text>`\n  })\n\n  return `<svg width=\"${width}\" height=\"${height}\" xmlns=\"http://www.w3.org/2000/svg\">${textElements.join('')}</svg>`\n}\n\n/**\n * Render an OG image from a template for a specific locale.\n * @internal Exported for testing.\n */\nexport async function renderOgImage(\n  template: OgImageTemplate,\n  locale: string,\n  rootDir: string,\n): Promise<Uint8Array | null> {\n  try {\n    const sharp = await import('sharp').then((m) => m.default ?? m)\n    const width = template.width ?? 1200\n    const height = template.height ?? 630\n\n    let pipeline: any\n    if (typeof template.background === 'string') {\n      const bgPath = join(rootDir, template.background)\n      pipeline = sharp(bgPath).resize(width, height, { fit: 'cover' })\n    } else {\n      pipeline = (sharp as any)({\n        create: {\n          width,\n          height,\n          channels: 4,\n          background: template.background.color,\n        },\n      })\n    }\n\n    // Overlay text layers if any\n    if (template.layers && template.layers.length > 0) {\n      const svgOverlay = buildTextOverlaySvg(template.layers, width, height, locale)\n      pipeline = pipeline.composite([{\n        input: Buffer.from(svgOverlay),\n        top: 0,\n        left: 0,\n      }])\n    }\n\n    if (template.format === 'jpeg') {\n      return await pipeline.jpeg({ quality: template.quality ?? 90 }).toBuffer()\n    }\n    return await pipeline.png().toBuffer()\n  } catch {\n    warnSharpMissing()\n    return null\n  }\n}\n\n// ─── Path utility ───────────────────────────────────────────────────────────\n\n/**\n * Compute the OG image path for a template and locale.\n *\n * @example\n * ```ts\n * ogImagePath(\"default\", \"de\")      // → \"/og/default-de.png\"\n * ogImagePath(\"default\")            // → \"/og/default.png\"\n * ogImagePath(\"hero\", \"en\", \"images\") // → \"/images/hero-en.png\"\n * ```\n */\nexport function ogImagePath(\n  templateName: string,\n  locale?: string,\n  outDir = 'og',\n  format: 'png' | 'jpeg' = 'png',\n): string {\n  const ext = format === 'jpeg' ? 'jpg' : 'png'\n  const suffix = locale ? `-${locale}` : ''\n  return `/${outDir}/${templateName}${suffix}.${ext}`\n}\n\n// ─── Vite plugin ────────────────────────────────────────────────────────────\n\n/**\n * OG image generation Vite plugin.\n *\n * Generates Open Graph images at build time. In dev, generates on-demand.\n * Requires `sharp` as an optional dependency.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { ogImagePlugin } from \"@pyreon/zero/og-image\"\n *\n * export default {\n *   plugins: [\n *     ogImagePlugin({\n *       locales: [\"en\", \"de\"],\n *       templates: [{\n *         name: \"default\",\n *         background: { color: \"#0066ff\" },\n *         layers: [{ text: { en: \"Hello\", de: \"Hallo\" }, fontSize: 72 }],\n *       }],\n *     }),\n *   ],\n * }\n * ```\n */\nexport function ogImagePlugin(config: OgImagePluginConfig): Plugin {\n  const outDir = config.outDir ?? 'og'\n  let root = ''\n  let isBuild = false\n\n  return {\n    name: 'pyreon-zero-og-image',\n    enforce: 'pre',\n\n    configResolved(resolvedConfig) {\n      root = resolvedConfig.root\n      isBuild = resolvedConfig.command === 'build'\n    },\n\n    // Dev: generate on-demand\n    configureServer(server) {\n      const devCache = new Map<string, Uint8Array>()\n\n      server.middlewares.use(async (req, res, next) => {\n        const url = req.url ?? ''\n        if (!url.startsWith(`/${outDir}/`)) return next()\n\n        // Parse: /og/default-en.png → template=default, locale=en\n        const fileName = url.slice(outDir.length + 2) // strip /{outDir}/\n        const match = fileName.match(/^(.+?)(?:-([a-z]{2,5}))?\\.(png|jpe?g)$/)\n        if (!match) return next()\n\n        const [, templateName, locale, ext] = match\n        const template = config.templates.find((t) => t.name === templateName)\n        if (!template) return next()\n\n        const resolvedLocale = locale ?? config.locales?.[0] ?? 'en'\n        const cacheKey = `${templateName}:${resolvedLocale}`\n\n        let buffer = devCache.get(cacheKey)\n        if (!buffer) {\n          const result = await renderOgImage(template, resolvedLocale, root)\n          if (!result) return next()\n          buffer = result\n          devCache.set(cacheKey, result)\n        }\n\n        const contentType = ext === 'jpg' || ext === 'jpeg' ? 'image/jpeg' : 'image/png'\n        res.setHeader('Content-Type', contentType)\n        res.setHeader('Cache-Control', 'no-cache')\n        res.end(Buffer.from(buffer))\n      })\n    },\n\n    // Build: generate all variants\n    async generateBundle() {\n      if (!isBuild) return\n\n      for (const template of config.templates) {\n        const locales = config.locales ?? [undefined]\n        const format = template.format ?? 'png'\n        const ext = format === 'jpeg' ? 'jpg' : 'png'\n\n        for (const locale of locales) {\n          // Validate background exists if it's a file path\n          if (typeof template.background === 'string') {\n            const bgPath = join(root, template.background)\n            if (!existsSync(bgPath)) {\n              // oxlint-disable-next-line no-console\n              console.warn(`[zero:og-image] Background not found: ${bgPath}`)\n              continue\n            }\n          }\n\n          const buffer = await renderOgImage(template, locale ?? 'en', root)\n          if (!buffer) continue\n\n          const suffix = locale ? `-${locale}` : ''\n          this.emitFile({\n            type: 'asset',\n            fileName: `${outDir}/${template.name}${suffix}.${ext}`,\n            source: buffer,\n          })\n        }\n      }\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"og-image.js","names":[],"sources":["../src/og-image.ts"],"sourcesContent":["/**\n * OG Image generation plugin.\n *\n * Generates Open Graph images at build time from templates with\n * text overlays. Supports locale-specific text for i18n apps.\n * Uses sharp for image processing (same optional dep as favicon/image plugins).\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { ogImagePlugin } from \"@pyreon/zero/og-image\"\n *\n * export default {\n *   plugins: [\n *     ogImagePlugin({\n *       locales: [\"en\", \"de\", \"cs\"],\n *       templates: [{\n *         name: \"default\",\n *         background: \"./src/assets/og-bg.jpg\",\n *         layers: [{\n *           text: { en: \"Build faster\", de: \"Schneller bauen\", cs: \"Stavte rychleji\" },\n *           y: \"40%\",\n *           fontSize: 72,\n *         }],\n *       }],\n *     }),\n *   ],\n * }\n * ```\n */\nimport { existsSync } from 'node:fs'\nimport { join } from 'node:path'\nimport type { Plugin } from 'vite'\n\nlet sharpWarned = false\nfunction warnSharpMissing() {\n  if (sharpWarned) return\n  sharpWarned = true\n  // oxlint-disable-next-line no-console\n  console.warn(\n    '\\n[Pyreon] sharp not installed — OG images will not be generated. Install for full support: bun add -D sharp\\n',\n  )\n}\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nexport interface OgImageLayer {\n  /**\n   * Text content. Can be:\n   * - A string (same for all locales)\n   * - A record mapping locale → text\n   * - A function receiving locale and returning text\n   */\n  text: string | Record<string, string> | ((locale: string) => string)\n  /** X position — number (px) or string with % (e.g. \"50%\"). Default: \"50%\" */\n  x?: number | string\n  /** Y position — number (px) or string with % (e.g. \"40%\"). Default: \"50%\" */\n  y?: number | string\n  /** Font size in px. Default: 64 */\n  fontSize?: number\n  /** Font family. Default: \"sans-serif\" */\n  fontFamily?: string\n  /** Font weight. Default: \"bold\" */\n  fontWeight?: string\n  /** Text color. Default: \"#ffffff\" */\n  color?: string\n  /** Text anchor (alignment). Default: \"middle\" */\n  textAnchor?: 'start' | 'middle' | 'end'\n  /** Max width in px before wrapping. Default: 80% of image width. */\n  maxWidth?: number\n}\n\nexport interface OgImageTemplate {\n  /** Template name — used for output file naming. */\n  name: string\n  /**\n   * Background: path to an image file, or a solid color config.\n   *\n   * @example \"./src/assets/og-bg.jpg\"\n   * @example { color: \"#0066ff\", width: 1200, height: 630 }\n   */\n  background: string | { color: string; width?: number; height?: number }\n  /** Output width. Default: 1200 */\n  width?: number\n  /** Output height. Default: 630 */\n  height?: number\n  /** Output format. Default: \"png\" */\n  format?: 'png' | 'jpeg'\n  /** JPEG quality (1-100). Default: 90 */\n  quality?: number\n  /** Text layers to overlay on the background. */\n  layers?: OgImageLayer[]\n}\n\nexport interface OgImagePluginConfig {\n  /** Templates to generate. */\n  templates: OgImageTemplate[]\n  /** Locales to generate for. When omitted, generates a single image per template. */\n  locales?: string[]\n  /** Output directory prefix. Default: \"og\" */\n  outDir?: string\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nfunction resolvePosition(value: number | string | undefined, dimension: number, fallback = '50%'): number {\n  if (value === undefined) value = fallback\n  if (typeof value === 'number') return value\n  if (value.endsWith('%')) return Math.round((Number.parseFloat(value) / 100) * dimension)\n  return Number.parseInt(value, 10) || 0\n}\n\nfunction resolveLayerText(layer: OgImageLayer, locale: string): string {\n  if (typeof layer.text === 'string') return layer.text\n  if (typeof layer.text === 'function') return layer.text(locale)\n  return layer.text[locale] ?? layer.text[Object.keys(layer.text)[0] ?? ''] ?? ''\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;')\n}\n\n/**\n * Build an SVG overlay with text layers.\n * @internal Exported for testing.\n */\nexport function buildTextOverlaySvg(\n  layers: OgImageLayer[],\n  width: number,\n  height: number,\n  locale: string,\n): string {\n  const textElements = layers.map((layer) => {\n    const text = resolveLayerText(layer, locale)\n    const x = resolvePosition(layer.x, width, '50%')\n    const y = resolvePosition(layer.y, height, '50%')\n    const fontSize = layer.fontSize ?? 64\n    const fontFamily = layer.fontFamily ?? 'sans-serif'\n    const fontWeight = layer.fontWeight ?? 'bold'\n    const color = layer.color ?? '#ffffff'\n    const anchor = layer.textAnchor ?? 'middle'\n    const maxWidth = layer.maxWidth ?? Math.round(width * 0.8)\n\n    // Word wrapping via tspan elements.\n    // Width estimation: Latin chars ~0.55em, CJK chars ~1.0em, narrow chars ~0.35em.\n    const words = text.split(' ')\n    const lines: string[] = []\n    let currentLine = ''\n\n    const estimateWidth = (s: string): number => {\n      let width = 0\n      for (let i = 0; i < s.length; i++) {\n        const code = s.charCodeAt(i)\n        if (code >= 0x3000 && code <= 0x9FFF) {\n          // CJK characters — full width\n          width += fontSize * 1.0\n        } else if (code <= 0x7E && 'iljft!|:;.,\\''.includes(s[i]!)) {\n          // Narrow Latin characters\n          width += fontSize * 0.35\n        } else {\n          // Regular Latin characters\n          width += fontSize * 0.55\n        }\n      }\n      return width\n    }\n\n    for (const word of words) {\n      const testLine = currentLine ? `${currentLine} ${word}` : word\n      if (estimateWidth(testLine) > maxWidth && currentLine) {\n        lines.push(currentLine)\n        currentLine = word\n      } else {\n        currentLine = testLine\n      }\n    }\n    if (currentLine) lines.push(currentLine)\n\n    const tspans = lines\n      .map((line, i) => {\n        const dy = i === 0 ? '0' : `${fontSize * 1.2}`\n        return `<tspan x=\"${x}\" dy=\"${dy}\">${escapeXml(line)}</tspan>`\n      })\n      .join('')\n\n    return `<text x=\"${x}\" y=\"${y}\" font-size=\"${fontSize}\" font-family=\"${escapeXml(fontFamily)}\" font-weight=\"${fontWeight}\" fill=\"${color}\" text-anchor=\"${anchor}\" dominant-baseline=\"middle\">${tspans}</text>`\n  })\n\n  return `<svg width=\"${width}\" height=\"${height}\" xmlns=\"http://www.w3.org/2000/svg\">${textElements.join('')}</svg>`\n}\n\n/**\n * Render an OG image from a template for a specific locale.\n * @internal Exported for testing.\n */\nexport async function renderOgImage(\n  template: OgImageTemplate,\n  locale: string,\n  rootDir: string,\n): Promise<Uint8Array | null> {\n  try {\n    const sharp = await import('sharp').then((m) => m.default ?? m)\n    const width = template.width ?? 1200\n    const height = template.height ?? 630\n\n    let pipeline: any\n    if (typeof template.background === 'string') {\n      const bgPath = join(rootDir, template.background)\n      pipeline = sharp(bgPath).resize(width, height, { fit: 'cover' })\n    } else {\n      pipeline = (sharp as any)({\n        create: {\n          width,\n          height,\n          channels: 4,\n          background: template.background.color,\n        },\n      })\n    }\n\n    // Overlay text layers if any\n    if (template.layers && template.layers.length > 0) {\n      const svgOverlay = buildTextOverlaySvg(template.layers, width, height, locale)\n      pipeline = pipeline.composite([{\n        input: Buffer.from(svgOverlay),\n        top: 0,\n        left: 0,\n      }])\n    }\n\n    if (template.format === 'jpeg') {\n      return await pipeline.jpeg({ quality: template.quality ?? 90 }).toBuffer()\n    }\n    return await pipeline.png().toBuffer()\n  } catch {\n    warnSharpMissing()\n    return null\n  }\n}\n\n// ─── Path utility ───────────────────────────────────────────────────────────\n\n/**\n * Compute the OG image path for a template and locale.\n *\n * @example\n * ```ts\n * ogImagePath(\"default\", \"de\")      // → \"/og/default-de.png\"\n * ogImagePath(\"default\")            // → \"/og/default.png\"\n * ogImagePath(\"hero\", \"en\", \"images\") // → \"/images/hero-en.png\"\n * ```\n */\nexport function ogImagePath(\n  templateName: string,\n  locale?: string,\n  outDir = 'og',\n  format: 'png' | 'jpeg' = 'png',\n): string {\n  const ext = format === 'jpeg' ? 'jpg' : 'png'\n  const suffix = locale ? `-${locale}` : ''\n  return `/${outDir}/${templateName}${suffix}.${ext}`\n}\n\n// ─── Vite plugin ────────────────────────────────────────────────────────────\n\n/**\n * OG image generation Vite plugin.\n *\n * Generates Open Graph images at build time. In dev, generates on-demand.\n * Requires `sharp` as an optional dependency.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { ogImagePlugin } from \"@pyreon/zero/og-image\"\n *\n * export default {\n *   plugins: [\n *     ogImagePlugin({\n *       locales: [\"en\", \"de\"],\n *       templates: [{\n *         name: \"default\",\n *         background: { color: \"#0066ff\" },\n *         layers: [{ text: { en: \"Hello\", de: \"Hallo\" }, fontSize: 72 }],\n *       }],\n *     }),\n *   ],\n * }\n * ```\n */\nexport function ogImagePlugin(config: OgImagePluginConfig): Plugin {\n  const outDir = config.outDir ?? 'og'\n  let root = ''\n  let isBuild = false\n\n  return {\n    name: 'pyreon-zero-og-image',\n    enforce: 'pre',\n\n    configResolved(resolvedConfig) {\n      root = resolvedConfig.root\n      isBuild = resolvedConfig.command === 'build'\n    },\n\n    // Dev: generate on-demand\n    configureServer(server) {\n      const devCache = new Map<string, Uint8Array>()\n\n      server.middlewares.use(async (req, res, next) => {\n        const url = req.url ?? ''\n        if (!url.startsWith(`/${outDir}/`)) return next()\n\n        // Parse: /og/default-en.png → template=default, locale=en\n        const fileName = url.slice(outDir.length + 2) // strip /{outDir}/\n        const match = fileName.match(/^(.+?)(?:-([a-z]{2,5}))?\\.(png|jpe?g)$/)\n        if (!match) return next()\n\n        const [, templateName, locale, ext] = match\n        const template = config.templates.find((t) => t.name === templateName)\n        if (!template) return next()\n\n        const resolvedLocale = locale ?? config.locales?.[0] ?? 'en'\n        const cacheKey = `${templateName}:${resolvedLocale}`\n\n        let buffer = devCache.get(cacheKey)\n        if (!buffer) {\n          const result = await renderOgImage(template, resolvedLocale, root)\n          if (!result) return next()\n          buffer = result\n          devCache.set(cacheKey, result)\n        }\n\n        const contentType = ext === 'jpg' || ext === 'jpeg' ? 'image/jpeg' : 'image/png'\n        res.setHeader('Content-Type', contentType)\n        res.setHeader('Cache-Control', 'no-cache')\n        res.end(Buffer.from(buffer))\n      })\n    },\n\n    // Build: generate all variants\n    async generateBundle() {\n      if (!isBuild) return\n\n      for (const template of config.templates) {\n        const locales = config.locales ?? [undefined]\n        const format = template.format ?? 'png'\n        const ext = format === 'jpeg' ? 'jpg' : 'png'\n\n        for (const locale of locales) {\n          // Validate background exists if it's a file path\n          if (typeof template.background === 'string') {\n            const bgPath = join(root, template.background)\n            if (!existsSync(bgPath)) {\n              // oxlint-disable-next-line no-console\n              console.warn(`[Pyreon] Background not found: ${bgPath}`)\n              continue\n            }\n          }\n\n          const buffer = await renderOgImage(template, locale ?? 'en', root)\n          if (!buffer) continue\n\n          const suffix = locale ? `-${locale}` : ''\n          this.emitFile({\n            type: 'asset',\n            fileName: `${outDir}/${template.name}${suffix}.${ext}`,\n            source: buffer,\n          })\n        }\n      }\n    },\n  }\n}\n"],"mappings":"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"}

package/lib/script.js

@@ -92,6 +92,7 @@ function jsx(type, props, key) {
 */
 function Script(props) {
 	function loadScript() {
+		if (typeof document === "undefined") return;
 		if (props.id && document.getElementById(props.id)) return;
 		const script = document.createElement("script");
 		if (props.src) script.src = props.src;

package/lib/script.js.map

@@ -1 +1 @@
-{"version":3,"file":"script.js","names":[],"sources":["../src/utils/use-intersection-observer.ts","../../../core/core/lib/jsx-runtime.js","../src/script.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, onMount, onUnmount } from '@pyreon/core'\nimport { useIntersectionObserver } from './utils/use-intersection-observer'\n\n// ─── Script optimization component ─────────────────────────────────────────\n//\n// <Script> provides optimized third-party script loading:\n// - Defer loading until after hydration\n// - Load on idle (requestIdleCallback)\n// - Load on interaction (click, scroll, etc.)\n// - Load on viewport entry\n// - Worker offloading for analytics scripts\n\nexport interface ScriptProps {\n  /** Script source URL. */\n  src: string\n  /** Loading strategy. Default: \"afterHydration\" */\n  strategy?: ScriptStrategy\n  /** Inline script content (alternative to src). */\n  children?: string\n  /** Script id for deduplication. */\n  id?: string\n  /** Async attribute. Default: true */\n  async?: boolean\n  /** onLoad callback. */\n  onLoad?: () => void\n  /** onError callback. */\n  onError?: (error: Error) => void\n}\n\nexport type ScriptStrategy =\n  | 'beforeHydration'\n  | 'afterHydration'\n  | 'onIdle'\n  | 'onInteraction'\n  | 'onViewport'\n\n/**\n * Optimized script loading component.\n *\n * @example\n * // Load analytics after page is interactive\n * <Script src=\"https://analytics.example.com/script.js\" strategy=\"onIdle\" />\n *\n * // Load chat widget when user scrolls\n * <Script src=\"/chat-widget.js\" strategy=\"onViewport\" />\n *\n * // Inline script with deferred execution\n * <Script strategy=\"afterHydration\">\n *   {`console.log(\"App hydrated!\")`}\n * </Script>\n */\nexport function Script(props: ScriptProps): VNodeChild {\n  function loadScript() {\n    // Deduplication\n    if (props.id && document.getElementById(props.id)) return\n\n    const script = document.createElement('script')\n    if (props.src) script.src = props.src\n    if (props.id) script.id = props.id\n    script.async = props.async !== false\n\n    if (props.onLoad) script.onload = props.onLoad\n    if (props.onError) {\n      script.onerror = () => props.onError?.(new Error(`Failed to load: ${props.src}`))\n    }\n\n    if (props.children && !props.src) {\n      script.textContent = props.children\n    }\n\n    document.head.appendChild(script)\n  }\n\n  onMount(() => {\n    const strategy = props.strategy ?? 'afterHydration'\n\n    switch (strategy) {\n      case 'beforeHydration':\n        // Already in HTML — do nothing\n        break\n\n      case 'afterHydration':\n        // Load immediately after mount (hydration is complete)\n        loadScript()\n        break\n\n      case 'onIdle':\n        if ('requestIdleCallback' in window) {\n          requestIdleCallback(() => loadScript(), { timeout: 5000 })\n        } else {\n          setTimeout(loadScript, 200)\n        }\n        break\n\n      case 'onInteraction': {\n        const events = ['click', 'scroll', 'keydown', 'touchstart']\n        function handler() {\n          for (const e of events) document.removeEventListener(e, handler)\n          loadScript()\n        }\n        for (const e of events) {\n          document.addEventListener(e, handler, { once: true, passive: true })\n        }\n        onUnmount(() => {\n          for (const e of events) document.removeEventListener(e, handler)\n        })\n        break\n      }\n\n      case 'onViewport':\n        // Handled below via useIntersectionObserver on the sentinel element\n        break\n    }\n    return undefined\n  })\n\n  const sentinelRef = createRef<HTMLElement>()\n  const strategy = props.strategy ?? 'afterHydration'\n\n  if (strategy === 'onViewport') {\n    useIntersectionObserver(\n      () => sentinelRef.current ?? undefined,\n      () => loadScript(),\n    )\n  }\n\n  if (strategy === 'onViewport') {\n    return <div ref={sentinelRef} style=\"width:0;height:0;overflow:hidden\" />\n  }\n\n  return null\n}\n"],"mappings":"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"}
+{"version":3,"file":"script.js","names":[],"sources":["../src/utils/use-intersection-observer.ts","../../../core/core/lib/jsx-runtime.js","../src/script.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, onMount, onUnmount } from '@pyreon/core'\nimport { useIntersectionObserver } from './utils/use-intersection-observer'\n\n// ─── Script optimization component ─────────────────────────────────────────\n//\n// <Script> provides optimized third-party script loading:\n// - Defer loading until after hydration\n// - Load on idle (requestIdleCallback)\n// - Load on interaction (click, scroll, etc.)\n// - Load on viewport entry\n// - Worker offloading for analytics scripts\n\nexport interface ScriptProps {\n  /** Script source URL. */\n  src: string\n  /** Loading strategy. Default: \"afterHydration\" */\n  strategy?: ScriptStrategy\n  /** Inline script content (alternative to src). */\n  children?: string\n  /** Script id for deduplication. */\n  id?: string\n  /** Async attribute. Default: true */\n  async?: boolean\n  /** onLoad callback. */\n  onLoad?: () => void\n  /** onError callback. */\n  onError?: (error: Error) => void\n}\n\nexport type ScriptStrategy =\n  | 'beforeHydration'\n  | 'afterHydration'\n  | 'onIdle'\n  | 'onInteraction'\n  | 'onViewport'\n\n/**\n * Optimized script loading component.\n *\n * @example\n * // Load analytics after page is interactive\n * <Script src=\"https://analytics.example.com/script.js\" strategy=\"onIdle\" />\n *\n * // Load chat widget when user scrolls\n * <Script src=\"/chat-widget.js\" strategy=\"onViewport\" />\n *\n * // Inline script with deferred execution\n * <Script strategy=\"afterHydration\">\n *   {`console.log(\"App hydrated!\")`}\n * </Script>\n */\nexport function Script(props: ScriptProps): VNodeChild {\n  function loadScript() {\n    // Only invoked from `onMount` — explicit guard documents the\n    // SSR-safety contract at the callsite (the rule can't AST-trace the\n    // indirect call).\n    if (typeof document === 'undefined') return\n    // Deduplication\n    if (props.id && document.getElementById(props.id)) return\n\n    const script = document.createElement('script')\n    if (props.src) script.src = props.src\n    if (props.id) script.id = props.id\n    script.async = props.async !== false\n\n    if (props.onLoad) script.onload = props.onLoad\n    if (props.onError) {\n      script.onerror = () => props.onError?.(new Error(`Failed to load: ${props.src}`))\n    }\n\n    if (props.children && !props.src) {\n      script.textContent = props.children\n    }\n\n    document.head.appendChild(script)\n  }\n\n  onMount(() => {\n    const strategy = props.strategy ?? 'afterHydration'\n\n    switch (strategy) {\n      case 'beforeHydration':\n        // Already in HTML — do nothing\n        break\n\n      case 'afterHydration':\n        // Load immediately after mount (hydration is complete)\n        loadScript()\n        break\n\n      case 'onIdle':\n        if ('requestIdleCallback' in window) {\n          requestIdleCallback(() => loadScript(), { timeout: 5000 })\n        } else {\n          setTimeout(loadScript, 200)\n        }\n        break\n\n      case 'onInteraction': {\n        const events = ['click', 'scroll', 'keydown', 'touchstart']\n        function handler() {\n          for (const e of events) document.removeEventListener(e, handler)\n          loadScript()\n        }\n        for (const e of events) {\n          document.addEventListener(e, handler, { once: true, passive: true })\n        }\n        onUnmount(() => {\n          for (const e of events) document.removeEventListener(e, handler)\n        })\n        break\n      }\n\n      case 'onViewport':\n        // Handled below via useIntersectionObserver on the sentinel element\n        break\n    }\n    return undefined\n  })\n\n  const sentinelRef = createRef<HTMLElement>()\n  const strategy = props.strategy ?? 'afterHydration'\n\n  if (strategy === 'onViewport') {\n    useIntersectionObserver(\n      () => sentinelRef.current ?? undefined,\n      () => loadScript(),\n    )\n  }\n\n  if (strategy === 'onViewport') {\n    return <div ref={sentinelRef} style=\"width:0;height:0;overflow:hidden\" />\n  }\n\n  return null\n}\n"],"mappings":"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"}

package/lib/server.js

@@ -328,11 +328,36 @@ function resolveConfig(userConfig = {}) {
 *
 * Wraps an SSR handler and caches responses per URL path.
 * Serves stale content immediately while revalidating in the background.
+*
+* Bounded by `config.maxEntries` (default: 1000) with LRU eviction. The
+* `Map` preserves insertion order, so re-inserting an entry on every
+* serve (touching it) keeps the LRU order correct. Without the cap,
+* unbounded URL spaces like `/user/:id` would grow cache memory without
+* limit over the server's lifetime — a real leak in long-running
+* deployments.
 */
 function createISRHandler(handler, config) {
 	const cache = /* @__PURE__ */ new Map();
 	const revalidating = /* @__PURE__ */ new Set();
 	const revalidateMs = config.revalidate * 1e3;
+	const maxEntries = Math.max(1, config.maxEntries ?? 1e3);
+	function set(key, entry) {
+		if (cache.has(key)) cache.delete(key);
+		cache.set(key, entry);
+		while (cache.size > maxEntries) {
+			const oldest = cache.keys().next().value;
+			if (oldest === void 0) break;
+			cache.delete(oldest);
+		}
+	}
+	function touch(key) {
+		const entry = cache.get(key);
+		if (entry !== void 0) {
+			cache.delete(key);
+			cache.set(key, entry);
+		}
+		return entry;
+	}
 	async function revalidate(url) {
 		const key = url.pathname;
 		if (revalidating.has(key)) return;
@@ -344,7 +369,7 @@ function createISRHandler(handler, config) {
 			res.headers.forEach((v, k) => {
 				headers[k] = v;
 			});
-			cache.set(key, {
+			set(key, {
 				html,
 				headers,
 				timestamp: Date.now()
@@ -357,7 +382,7 @@ function createISRHandler(handler, config) {
 		if (req.method !== "GET") return handler(req);
 		const url = new URL(req.url);
 		const key = url.pathname;
-		const entry = cache.get(key);
+		const entry = touch(key);
 		if (entry) {
 			const age = Date.now() - entry.timestamp;
 			if (age > revalidateMs) revalidate(url);
@@ -402,8 +427,8 @@ function createISRHandler(handler, config) {
 */
 async function validateBuildInputs(options) {
 	const { existsSync } = await import("node:fs");
-	if (!existsSync(options.clientOutDir)) throw new Error(`[zero:adapter] Client build output not found: ${options.clientOutDir}. Run "vite build" first.`);
-	if (!existsSync(options.serverEntry)) throw new Error(`[zero:adapter] Server entry not found: ${options.serverEntry}. Run "vite build --ssr" first.`);
+	if (!existsSync(options.clientOutDir)) throw new Error(`[Pyreon] Client build output not found: ${options.clientOutDir}. Run "vite build" first.`);
+	if (!existsSync(options.serverEntry)) throw new Error(`[Pyreon] Server entry not found: ${options.serverEntry}. Run "vite build --ssr" first.`);
 }
 
 //#endregion
@@ -813,7 +838,7 @@ function resolveAdapter(config) {
 		case "vercel": return vercelAdapter();
 		case "cloudflare": return cloudflareAdapter();
 		case "netlify": return netlifyAdapter();
-		default: throw new Error(`[zero] Unknown adapter: "${name}". Use "node", "bun", "static", "vercel", "cloudflare", or "netlify".`);
+		default: throw new Error(`[Pyreon] Unknown adapter: "${name}". Use "node", "bun", "static", "vercel", "cloudflare", or "netlify".`);
 	}
 }
 
@@ -990,6 +1015,19 @@ function scanPyreonPackages(root) {
 		return [];
 	}
 }
+/**
+* Resolve a package that isn't at the app's top-level `node_modules` but is
+* nested under another `@pyreon/*` package. Used to alias `@pyreon/runtime-server`
+* to the copy under `node_modules/@pyreon/zero/node_modules/@pyreon/runtime-server`
+* so `ssrLoadModule` works without requiring the app to declare it as a
+* direct dep.
+*/
+function resolveNestedPackage(root, name) {
+	const direct = join(root, "node_modules", name);
+	if (existsSync(direct)) return direct;
+	const nested = join(root, "node_modules", "@pyreon", "zero", "node_modules", name);
+	if (existsSync(nested)) return nested;
+}
 const VIRTUAL_ROUTES_ID = "virtual:zero/routes";
 const RESOLVED_VIRTUAL_ROUTES_ID = `\0${VIRTUAL_ROUTES_ID}`;
 const VIRTUAL_MIDDLEWARE_ID = "virtual:zero/route-middleware";
@@ -1044,6 +1082,28 @@ function zeroPlugin(userConfig = {}) {
 			}
 		},
 		configureServer(server) {
+			if (config.mode === "ssr") server.middlewares.use((req, res, next) => {
+				const accept = req.headers.accept ?? "";
+				if (!accept.includes("text/html") && !accept.includes("*/*")) return next();
+				const pathname = req.url?.split("?")[0] ?? "/";
+				if (pathname.startsWith("/@") || pathname.startsWith("/__")) return next();
+				if (/\.\w+$/.test(pathname)) return next();
+				renderSsr(server, root, req.originalUrl ?? pathname, pathname).then((result) => {
+					if (result === null) return next();
+					res.statusCode = 200;
+					res.setHeader("Content-Type", "text/html; charset=utf-8");
+					res.setHeader("Content-Length", Buffer.byteLength(result));
+					res.end(result);
+				}, (err) => {
+					const error = err instanceof Error ? err : new Error(String(err));
+					server.ssrFixStacktrace(error);
+					const html = renderErrorOverlay(error);
+					res.statusCode = 500;
+					res.setHeader("Content-Type", "text/html; charset=utf-8");
+					res.setHeader("Content-Length", Buffer.byteLength(html));
+					res.end(html);
+				});
+			});
 			server.middlewares.use((req, res, next) => {
 				const accept = req.headers.accept ?? "";
 				if (!accept.includes("text/html") && !accept.includes("*/*")) return next();
@@ -1053,7 +1113,7 @@ function zeroPlugin(userConfig = {}) {
 				handle404(server, routesDir, pathname, res).then((handled) => {
 					if (!handled) next();
 				}, (err) => {
-					console.error("[zero] Error in 404 handler:", err);
+					console.error("[Pyreon] Error in 404 handler:", err);
 					next();
 				});
 			});
@@ -1096,9 +1156,19 @@ function zeroPlugin(userConfig = {}) {
 			});
 		},
 		config(userConfig) {
+			const root = userConfig.root ?? process.cwd();
+			const pyreonExclude = scanPyreonPackages(root);
+			const runtimeServerAlias = resolveNestedPackage(root, "@pyreon/runtime-server");
 			return {
-				resolve: { conditions: ["bun"] },
-				optimizeDeps: { exclude: scanPyreonPackages(userConfig.root ?? process.cwd()) },
+				resolve: {
+					conditions: ["bun"],
+					...runtimeServerAlias ? { alias: { "@pyreon/runtime-server": runtimeServerAlias } } : {}
+				},
+				ssr: { resolve: {
+					conditions: ["bun"],
+					...runtimeServerAlias ? { alias: { "@pyreon/runtime-server": runtimeServerAlias } } : {}
+				} },
+				optimizeDeps: { exclude: pyreonExclude },
 				server: { port: config.port },
 				define: {
 					__ZERO_MODE__: JSON.stringify(config.mode),
@@ -1127,6 +1197,56 @@ async function handle404(server, _routesDir, pathname, res) {
 	res.end(html);
 	return true;
 }
+/**
+* Dev-mode SSR render pipeline. Returns the composed HTML string, or `null`
+* if the URL doesn't match any known route (caller falls through to the 404
+* middleware). Mirrors the production `createServer` flow:
+*   1. Load virtual:zero/routes + app.ts via Vite's ssrLoadModule
+*   2. Create a per-request router bound to the request URL
+*   3. Pre-run loaders for the matched route(s)
+*   4. Render app tree with head tag collection
+*   5. Serialize loader data into `window.__PYREON_LOADER_DATA__`
+*   6. Inject everything into the user's transformed index.html (so Vite
+*      still gets a chance to inject its HMR client + JSX runtime prelude)
+*/
+async function renderSsr(server, root, originalUrl, pathname) {
+	const routes = (await server.ssrLoadModule(VIRTUAL_ROUTES_ID)).routes;
+	if (!flattenRoutePatterns(routes).some((pattern) => matchPattern(pattern, pathname))) return null;
+	let template = await readFile(join(root, "index.html"), "utf-8");
+	template = await server.transformIndexHtml(originalUrl, template);
+	const [core, headPkg, headSsr, routerPkg, runtimeServer] = await Promise.all([
+		server.ssrLoadModule("@pyreon/core"),
+		server.ssrLoadModule("@pyreon/head"),
+		server.ssrLoadModule("@pyreon/head/ssr"),
+		server.ssrLoadModule("@pyreon/router"),
+		server.ssrLoadModule("@pyreon/runtime-server")
+	]);
+	let userLayout;
+	for (const ext of [
+		"tsx",
+		"ts",
+		"jsx",
+		"js"
+	]) try {
+		const layoutMod = await server.ssrLoadModule(`/src/routes/_layout.${ext}`);
+		userLayout = layoutMod.layout ?? layoutMod.default;
+		if (userLayout) break;
+	} catch {}
+	const { App, router: routerInst } = (await server.ssrLoadModule("@pyreon/zero/server")).createApp({
+		routes,
+		routerMode: "history",
+		url: pathname,
+		...userLayout ? { layout: userLayout } : {}
+	});
+	await routerInst.preload(pathname);
+	return runtimeServer.runWithRequestContext(async () => {
+		const app = core.h(App, null);
+		const { html: appHtml, head } = await headSsr.renderWithHead(app);
+		const loaderData = routerPkg.serializeLoaderData(routerInst);
+		const loaderScript = loaderData && Object.keys(loaderData).length > 0 ? `<script>window.__PYREON_LOADER_DATA__=${JSON.stringify(loaderData).replace(/<\//g, "<\\/")}<\/script>` : "";
+		return template.replace("<!--pyreon-head-->", head).replace("<!--pyreon-app-->", appHtml).replace("<!--pyreon-scripts-->", loaderScript);
+	});
+}
 /** Extract all URL patterns from a nested route tree. */
 function flattenRoutePatterns(routes, prefix = "") {
 	const patterns = [];
@@ -1145,7 +1265,7 @@ let sharpWarned$1 = false;
 function warnSharpMissing$1() {
 	if (sharpWarned$1) return;
 	sharpWarned$1 = true;
-	console.warn("\n[zero:favicon] sharp not installed — favicons will not be generated. Install for full support: bun add -D sharp\n");
+	console.warn("\n[Pyreon] sharp not installed — favicons will not be generated. Install for full support: bun add -D sharp\n");
 }
 const SIZES = [
 	{
@@ -1465,7 +1585,7 @@ function resolveLocaleSource(url, config, rootDir) {
 async function generateFaviconSet(rootDir, source, darkSource, prefix, config, themeColor, backgroundColor, generateManifest) {
 	const sourcePath = join(rootDir, source);
 	if (!existsSync(sourcePath)) {
-		console.warn(`[zero:favicon] Source not found: ${sourcePath}`);
+		console.warn(`[Pyreon] Source not found: ${sourcePath}`);
 		return;
 	}
 	if (source.endsWith(".svg")) {
@@ -1878,7 +1998,7 @@ let sharpWarned = false;
 function warnSharpMissing() {
 	if (sharpWarned) return;
 	sharpWarned = true;
-	console.warn("\n[zero:og-image] sharp not installed — OG images will not be generated. Install for full support: bun add -D sharp\n");
+	console.warn("\n[Pyreon] sharp not installed — OG images will not be generated. Install for full support: bun add -D sharp\n");
 }
 function resolvePosition(value, dimension, fallback = "50%") {
 	if (value === void 0) value = fallback;
@@ -2052,7 +2172,7 @@ function ogImagePlugin(config) {
 					if (typeof template.background === "string") {
 						const bgPath = join(root, template.background);
 						if (!existsSync(bgPath)) {
-							console.warn(`[zero:og-image] Background not found: ${bgPath}`);
+							console.warn(`[Pyreon] Background not found: ${bgPath}`);
 							continue;
 						}
 					}