@pyreon/zero 0.12.1 → 0.12.3

package/src/favicon.ts

@@ -27,6 +27,13 @@ function warnSharpMissing() {
 //   import { faviconPlugin } from "@pyreon/zero"
 //   export default { plugins: [zero(), faviconPlugin({ source: "./icon.svg" })] }
 
+export interface FaviconLocaleConfig {
+  /** Locale-specific source icon (SVG or PNG). */
+  source: string
+  /** Optional dark mode variant for this locale. */
+  darkSource?: string
+}
+
 export interface FaviconPluginConfig {
   /** Path to the source icon (SVG or PNG, at least 512x512 for PNG). */
   source: string
@@ -44,6 +51,26 @@ export interface FaviconPluginConfig {
    * to switch between light and dark variants.
    */
   darkSource?: string
+  /**
+   * Locale-specific icon overrides. Each key is a locale code,
+   * value is a source icon (and optional dark variant).
+   * Locales not in this map use the base `source`.
+   *
+   * Generated files are placed under `/{locale}/` prefix:
+   *   /de/favicon.svg, /de/favicon-32x32.png, etc.
+   *
+   * @example
+   * ```ts
+   * faviconPlugin({
+   *   source: "./icon.svg",
+   *   locales: {
+   *     de: { source: "./icon-de.svg" },
+   *     cs: { source: "./icon-cs.svg" },
+   *   },
+   * })
+   * ```
+   */
+  locales?: Record<string, FaviconLocaleConfig>
 }
 
 interface FaviconSize {
@@ -95,24 +122,41 @@ export function faviconPlugin(config: FaviconPluginConfig): Plugin {
     // Dev server: serve generated favicons on-the-fly
     configureServer(server) {
       const sourcePath = join(root, config.source)
+      const devCache = new Map<string, Uint8Array>()
 
       server.middlewares.use(async (req, res, next) => {
         const url = req.url ?? ''
 
+        // Resolve locale-specific source: /{locale}/favicon.svg → locale source
+        const localeSource = resolveLocaleSource(url, config, root)
+
         // Serve source as favicon.svg in dev
-        if (url === '/favicon.svg' && config.source.endsWith('.svg')) {
+        const svgUrl = localeSource ? localeSource.url : url
+        const svgPath = localeSource ? localeSource.sourcePath : sourcePath
+        const isSvgSource = localeSource ? localeSource.source.endsWith('.svg') : config.source.endsWith('.svg')
+
+        if (svgUrl.endsWith('/favicon.svg') && isSvgSource) {
           try {
-            const content = await readFile(sourcePath, 'utf-8')
+            const content = await readFile(svgPath, 'utf-8')
             res.setHeader('Content-Type', 'image/svg+xml')
             res.end(content)
             return
           } catch { /* fall through */ }
         }
 
-        // Serve generated PNGs on-demand
-        const sizeMatch = SIZES.find((s) => url === `/${s.name}`)
+        // Serve generated PNGs on-demand (supports /{locale}/favicon-32x32.png)
+        const baseName = svgUrl.split('/').pop() ?? ''
+        const sizeMatch = SIZES.find((s) => s.name === baseName)
         if (sizeMatch) {
-          const png = await resizeToPng(sourcePath, sizeMatch.size)
+          const cacheKey = `${svgPath}:${sizeMatch.size}`
+          let png = devCache.get(cacheKey)
+          if (!png) {
+            const result = await resizeToPng(svgPath, sizeMatch.size)
+            if (result) {
+              png = result
+              devCache.set(cacheKey, result)
+            }
+          }
           if (png) {
             res.setHeader('Content-Type', 'image/png')
             res.setHeader('Cache-Control', 'no-cache')
@@ -122,8 +166,16 @@ export function faviconPlugin(config: FaviconPluginConfig): Plugin {
         }
 
         // Serve generated ICO on-demand
-        if (url === '/favicon.ico') {
-          const ico = await generateIco(sourcePath)
+        if (baseName === 'favicon.ico') {
+          const cacheKey = `ico:${svgPath}`
+          let ico: Uint8Array | undefined = devCache.get(cacheKey)
+          if (!ico) {
+            const result = await generateIco(svgPath)
+            if (result) {
+              ico = result
+              devCache.set(cacheKey, result)
+            }
+          }
           if (ico) {
             res.setHeader('Content-Type', 'image/x-icon')
             res.setHeader('Cache-Control', 'no-cache')
@@ -132,14 +184,15 @@ export function faviconPlugin(config: FaviconPluginConfig): Plugin {
           }
         }
 
-        // Serve manifest
-        if (url === '/site.webmanifest' && generateManifest) {
+        // Serve manifest (supports /{locale}/site.webmanifest)
+        if (baseName === 'site.webmanifest' && generateManifest) {
+          const prefix = localeSource ? `/${localeSource.locale}` : ''
           const manifest = {
             name: config.name ?? 'App',
             short_name: config.name ?? 'App',
             icons: [
-              { src: '/icon-192.png', sizes: '192x192', type: 'image/png' },
-              { src: '/icon-512.png', sizes: '512x512', type: 'image/png' },
+              { src: `${prefix}/icon-192.png`, sizes: '192x192', type: 'image/png' },
+              { src: `${prefix}/icon-512.png`, sizes: '512x512', type: 'image/png' },
             ],
             theme_color: themeColor,
             background_color: backgroundColor,
@@ -209,78 +262,15 @@ export function faviconPlugin(config: FaviconPluginConfig): Plugin {
     async generateBundle() {
       if (!isBuild) return
 
-      const sourcePath = join(root, config.source)
-      if (!existsSync(sourcePath)) {
-        // oxlint-disable-next-line no-console
-        console.warn(`[zero:favicon] Source not found: ${sourcePath}`)
-        return
-      }
-
-      const isSvg = config.source.endsWith('.svg')
-
-      // Copy SVG as favicon.svg
-      if (isSvg) {
-        const svgContent = await readFile(sourcePath, 'utf-8')
-        let finalSvg = svgContent
-
-        // If dark mode variant provided, wrap in media query
-        if (config.darkSource) {
-          const darkPath = join(root, config.darkSource)
-          if (existsSync(darkPath)) {
-            const darkSvg = await readFile(darkPath, 'utf-8')
-            finalSvg = wrapSvgWithDarkMode(svgContent, darkSvg)
-          }
-        }
-
-        this.emitFile({
-          type: 'asset',
-          fileName: 'favicon.svg',
-          source: finalSvg,
-        })
-      }
+      // Generate favicons for the base (default) source
+      await generateFaviconSet.call(this, root, config.source, config.darkSource, '', config, themeColor, backgroundColor, generateManifest)
 
-      // Generate PNG sizes via sharp
-      for (const { size, name } of SIZES) {
-        const pngBuffer = await resizeToPng(sourcePath, size)
-        if (pngBuffer) {
-          this.emitFile({
-            type: 'asset',
-            fileName: name,
-            source: pngBuffer,
-          })
+      // Generate locale-specific favicon sets
+      if (config.locales) {
+        for (const [locale, localeConfig] of Object.entries(config.locales)) {
+          await generateFaviconSet.call(this, root, localeConfig.source, localeConfig.darkSource, `${locale}/`, config, themeColor, backgroundColor, generateManifest)
         }
       }
-
-      // Generate favicon.ico (16 + 32)
-      const ico = await generateIco(sourcePath)
-      if (ico) {
-        this.emitFile({
-          type: 'asset',
-          fileName: 'favicon.ico',
-          source: ico,
-        })
-      }
-
-      // Generate web manifest
-      if (generateManifest) {
-        const manifest = {
-          name: config.name ?? 'App',
-          short_name: config.name ?? 'App',
-          icons: [
-            { src: '/icon-192.png', sizes: '192x192', type: 'image/png' },
-            { src: '/icon-512.png', sizes: '512x512', type: 'image/png' },
-          ],
-          theme_color: themeColor,
-          background_color: backgroundColor,
-          display: 'standalone',
-        }
-
-        this.emitFile({
-          type: 'asset',
-          fileName: 'site.webmanifest',
-          source: JSON.stringify(manifest, null, 2),
-        })
-      }
     },
   }
 }
@@ -311,6 +301,157 @@ function stripSvgWrapper(svg: string): string {
     .trim()
 }
 
+/**
+ * Resolve the source path for a locale-prefixed favicon URL.
+ * Returns null if the URL is not locale-prefixed or locale has no override.
+ */
+function resolveLocaleSource(
+  url: string,
+  config: FaviconPluginConfig,
+  rootDir: string,
+): { locale: string; url: string; source: string; sourcePath: string } | null {
+  if (!config.locales) return null
+
+  for (const [locale, localeConfig] of Object.entries(config.locales)) {
+    const prefix = `/${locale}/`
+    if (url.startsWith(prefix)) {
+      return {
+        locale,
+        url,
+        source: localeConfig.source,
+        sourcePath: join(rootDir, localeConfig.source),
+      }
+    }
+  }
+  return null
+}
+
+/**
+ * Generate a complete favicon set (SVG, PNGs, ICO, manifest) with a file prefix.
+ * Called once for base (prefix = '') and once per locale (prefix = '{locale}/').
+ */
+async function generateFaviconSet(
+  this: any,
+  rootDir: string,
+  source: string,
+  darkSource: string | undefined,
+  prefix: string,
+  config: FaviconPluginConfig,
+  themeColor: string,
+  backgroundColor: string,
+  generateManifest: boolean,
+): Promise<void> {
+  const sourcePath = join(rootDir, source)
+  if (!existsSync(sourcePath)) {
+    // oxlint-disable-next-line no-console
+    console.warn(`[zero:favicon] Source not found: ${sourcePath}`)
+    return
+  }
+
+  const isSvg = source.endsWith('.svg')
+
+  // Copy SVG as favicon.svg
+  if (isSvg) {
+    const svgContent = await readFile(sourcePath, 'utf-8')
+    let finalSvg = svgContent
+
+    if (darkSource) {
+      const darkPath = join(rootDir, darkSource)
+      if (existsSync(darkPath)) {
+        const darkSvg = await readFile(darkPath, 'utf-8')
+        finalSvg = wrapSvgWithDarkMode(svgContent, darkSvg)
+      }
+    }
+
+    this.emitFile({
+      type: 'asset',
+      fileName: `${prefix}favicon.svg`,
+      source: finalSvg,
+    })
+  }
+
+  // Generate PNG sizes via sharp
+  for (const { size, name } of SIZES) {
+    const pngBuffer = await resizeToPng(sourcePath, size)
+    if (pngBuffer) {
+      this.emitFile({
+        type: 'asset',
+        fileName: `${prefix}${name}`,
+        source: pngBuffer,
+      })
+    }
+  }
+
+  // Generate favicon.ico (16 + 32)
+  const ico = await generateIco(sourcePath)
+  if (ico) {
+    this.emitFile({
+      type: 'asset',
+      fileName: `${prefix}favicon.ico`,
+      source: ico,
+    })
+  }
+
+  // Generate web manifest
+  if (generateManifest) {
+    const manifestPrefix = prefix ? `/${prefix.slice(0, -1)}` : ''
+    const manifest = {
+      name: config.name ?? 'App',
+      short_name: config.name ?? 'App',
+      icons: [
+        { src: `${manifestPrefix}/icon-192.png`, sizes: '192x192', type: 'image/png' },
+        { src: `${manifestPrefix}/icon-512.png`, sizes: '512x512', type: 'image/png' },
+      ],
+      theme_color: themeColor,
+      background_color: backgroundColor,
+      display: 'standalone',
+    }
+
+    this.emitFile({
+      type: 'asset',
+      fileName: `${prefix}site.webmanifest`,
+      source: JSON.stringify(manifest, null, 2),
+    })
+  }
+}
+
+/**
+ * Get favicon link tags for a specific locale.
+ * Returns link objects suitable for `useHead()` or direct HTML injection.
+ *
+ * @example
+ * ```ts
+ * const links = faviconLinks("de", { source: "./icon.svg", locales: { de: { source: "./icon-de.svg" } } })
+ * // → [{ rel: "icon", type: "image/svg+xml", href: "/de/favicon.svg" }, ...]
+ * ```
+ */
+export function faviconLinks(
+  locale: string | undefined,
+  config: FaviconPluginConfig,
+): Array<{ rel: string; type?: string; sizes?: string; href: string }> {
+  const hasLocaleOverride = locale && config.locales?.[locale]
+  const prefix = hasLocaleOverride ? `/${locale}` : ''
+  const isSvg = (hasLocaleOverride ? config.locales![locale]!.source : config.source).endsWith('.svg')
+
+  const links: Array<{ rel: string; type?: string; sizes?: string; href: string }> = []
+
+  if (isSvg) {
+    links.push({ rel: 'icon', type: 'image/svg+xml', href: `${prefix}/favicon.svg` })
+  }
+
+  links.push(
+    { rel: 'icon', type: 'image/png', sizes: '32x32', href: `${prefix}/favicon-32x32.png` },
+    { rel: 'icon', type: 'image/png', sizes: '16x16', href: `${prefix}/favicon-16x16.png` },
+    { rel: 'apple-touch-icon', sizes: '180x180', href: `${prefix}/apple-touch-icon.png` },
+  )
+
+  if (config.manifest !== false) {
+    links.push({ rel: 'manifest', href: `${prefix}/site.webmanifest` })
+  }
+
+  return links
+}
+
 async function resizeToPng(input: string, size: number): Promise<Uint8Array | null> {
   try {
     const sharp = await import('sharp').then((m) => m.default ?? m)

package/src/index.ts

@@ -32,9 +32,12 @@ export { createISRHandler } from "./isr";
 
 export {
 	bunAdapter,
+	cloudflareAdapter,
+	netlifyAdapter,
 	nodeAdapter,
 	resolveAdapter,
 	staticAdapter,
+	vercelAdapter,
 } from "./adapters";
 
 // ─── Components ─────────────────────────────────────────────────────────────
@@ -85,6 +88,7 @@ export type { Theme } from "./theme";
 export {
 	initTheme,
 	resolvedTheme,
+	setSSRThemeDefault,
 	setTheme,
 	ThemeToggle,
 	theme,
@@ -148,8 +152,17 @@ export { createActionMiddleware, defineAction } from "./actions";
 
 // ─── Favicon ────────────────────────────────────────────────────────────────
 
-export type { FaviconPluginConfig } from "./favicon";
-export { faviconPlugin } from "./favicon";
+export type { FaviconLocaleConfig, FaviconPluginConfig } from "./favicon";
+export { faviconLinks, faviconPlugin } from "./favicon";
+
+// ─── OG Image ───────────────────────────────────────────────────────────────
+
+export type {
+	OgImageLayer,
+	OgImagePluginConfig,
+	OgImageTemplate,
+} from "./og-image";
+export { ogImagePath, ogImagePlugin } from "./og-image";
 
 // ─── Meta ───────────────────────────────────────────────────────────────────
 
@@ -169,6 +182,33 @@ export {
 	useLocale,
 } from "./i18n-routing";
 
+// ─── CSP ────────────────────────────────────────────────────────────────────
+
+export type { CspConfig, CspDirectives } from "./csp";
+export { buildCspHeader, cspMiddleware, useNonce } from "./csp";
+
+// ─── Environment validation ─────────────────────────────────────────────────
+
+export type { LogEntry, LoggerConfig } from "./logger";
+export { loggerMiddleware } from "./logger";
+
+// ─── Request logging ────────────────────────────────────────────────────────
+
+export type { EnvValidator } from "./env";
+export { bool, num, oneOf, publicEnv, schema, str, url, validateEnv } from "./env";
+
+// ─── AI integration ─────────────────────────────────────────────────────────
+
+export type { AiPluginConfig, InferJsonLdOptions } from "./ai";
+export {
+	aiPlugin,
+	generateAiPluginManifest,
+	generateLlmsFullTxt,
+	generateLlmsTxt,
+	generateOpenApiSpec,
+	inferJsonLd,
+} from "./ai";
+
 // ─── Types ───────────────────────────────────────────────────────────────────
 
 export type {

package/src/link.tsx

@@ -70,10 +70,16 @@ export interface UseLinkReturn {
   classes: () => string
 }
 
+const MAX_PREFETCH_CACHE = 200
 const prefetched = new Set<string>()
 
 function doPrefetch(href: string) {
   if (prefetched.has(href)) return
+  // Evict oldest entries when cache is full
+  if (prefetched.size >= MAX_PREFETCH_CACHE) {
+    const first = prefetched.values().next().value
+    if (first) prefetched.delete(first)
+  }
   prefetched.add(href)
 
   const docLink = document.createElement('link')

package/src/logger.ts

@@ -0,0 +1,144 @@
+/**
+ * Request logging middleware.
+ *
+ * Logs HTTP requests with method, path, status, and duration.
+ * Supports custom formatters and log levels.
+ *
+ * @example
+ * ```ts
+ * import { loggerMiddleware } from "@pyreon/zero"
+ *
+ * export default defineConfig({
+ *   middleware: [loggerMiddleware()],
+ * })
+ * ```
+ */
+import type { Middleware, MiddlewareContext } from '@pyreon/server'
+
+export interface LoggerConfig {
+  /**
+   * Log level — controls which requests are logged.
+   * - "all": log every request
+   * - "none": disable logging
+   * Default: "all"
+   */
+  level?: 'all' | 'none'
+  /**
+   * Custom log formatter. Receives request details and returns
+   * the string to log (or null to skip).
+   */
+  format?: (entry: LogEntry) => string | null
+  /**
+   * Skip logging for these path prefixes.
+   * Default: ["/__", "/@", "/node_modules"]
+   */
+  skip?: string[]
+  /**
+   * Enable colorized output (ANSI codes).
+   * Default: true in development, false in production.
+   */
+  colors?: boolean
+}
+
+export interface LogEntry {
+  method: string
+  path: string
+  duration: number
+  timestamp: Date
+  userAgent?: string | undefined
+  ip?: string | undefined
+}
+
+const COLORS = {
+  reset: '\x1b[0m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+}
+
+function methodColor(method: string, colors: boolean): string {
+  if (!colors) return method.padEnd(7)
+  const padded = method.padEnd(7)
+  switch (method) {
+    case 'GET': return `${COLORS.green}${padded}${COLORS.reset}`
+    case 'POST': return `${COLORS.cyan}${padded}${COLORS.reset}`
+    case 'PUT': return `${COLORS.yellow}${padded}${COLORS.reset}`
+    case 'PATCH': return `${COLORS.yellow}${padded}${COLORS.reset}`
+    case 'DELETE': return `${COLORS.red}${padded}${COLORS.reset}`
+    default: return `${COLORS.magenta}${padded}${COLORS.reset}`
+  }
+}
+
+function defaultFormat(entry: LogEntry, colors: boolean): string {
+  const dur = entry.duration < 1
+    ? '<1ms'
+    : entry.duration < 1000
+      ? `${Math.round(entry.duration)}ms`
+      : `${(entry.duration / 1000).toFixed(2)}s`
+
+  const dim = colors ? COLORS.dim : ''
+  const reset = colors ? COLORS.reset : ''
+
+  return `  ${methodColor(entry.method, colors)} ${entry.path} ${dim}${dur}${reset}`
+}
+
+/**
+ * Request logging middleware.
+ *
+ * Logs incoming requests with method, path, and duration.
+ * Runs in middleware phase — logs timing from middleware start to
+ * microtask completion (approximate request duration).
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * loggerMiddleware()
+ *
+ * // Custom format
+ * loggerMiddleware({
+ *   format: (e) => `${e.method} ${e.path} (${e.duration}ms)`,
+ * })
+ * ```
+ */
+export function loggerMiddleware(config?: LoggerConfig): Middleware {
+  const level = config?.level ?? 'all'
+  if (level === 'none') return () => {}
+
+  const skip = config?.skip ?? ['/__', '/@', '/node_modules']
+  const isDev = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'
+  const colors = config?.colors ?? isDev
+
+  return (ctx: MiddlewareContext) => {
+    // Skip internal paths
+    if (skip.some((p) => ctx.path.startsWith(p))) return
+
+    const start = performance.now()
+
+    const entry: LogEntry = {
+      method: ctx.req.method ?? 'GET',
+      path: ctx.path,
+      duration: 0,
+      timestamp: new Date(),
+      userAgent: ctx.req.headers.get('user-agent') ?? undefined,
+    }
+
+    // Use queueMicrotask to log after the middleware chain completes
+    queueMicrotask(() => {
+      entry.duration = performance.now() - start
+
+      if (config?.format) {
+        const line = config.format(entry)
+        if (line) {
+          // oxlint-disable-next-line no-console
+          console.log(line)
+        }
+      } else {
+        // oxlint-disable-next-line no-console
+        console.log(defaultFormat(entry, colors))
+      }
+    })
+  }
+}