@pyreon/zero 0.12.3 → 0.12.5

package/src/favicon.ts

@@ -71,6 +71,23 @@ export interface FaviconPluginConfig {
    * ```
    */
   locales?: Record<string, FaviconLocaleConfig>
+  /**
+   * Dev mode favicon — shown only during development to distinguish
+   * dev tabs from production. Can be:
+   * - A path to a separate icon file
+   * - `true` to auto-generate a dev badge (grayscale + "DEV" overlay)
+   *
+   * @example
+   * ```ts
+   * faviconPlugin({
+   *   source: "./icon.svg",
+   *   devSource: "./icon-dev.svg",     // custom dev icon
+   *   // OR
+   *   devSource: true,                 // auto-generate grayscale badge
+   * })
+   * ```
+   */
+  devSource?: string | boolean
 }
 
 interface FaviconSize {
@@ -122,36 +139,59 @@ export function faviconPlugin(config: FaviconPluginConfig): Plugin {
     // Dev server: serve generated favicons on-the-fly
     configureServer(server) {
       const sourcePath = join(root, config.source)
+      const darkPath = config.darkSource ? join(root, config.darkSource) : null
+      const devSourcePath = typeof config.devSource === 'string'
+        ? join(root, config.devSource)
+        : null
+      const autoDevBadge = config.devSource === true
       const devCache = new Map<string, Uint8Array>()
 
+      /** Resolve source path for a request — handles dark variants and dev badge. */
+      function resolveSourceForDev(baseName: string, defaultSource: string): string {
+        // Dark variant: favicon-dark-32x32.png → use darkSource
+        if (darkPath && baseName.includes('-dark-')) return darkPath
+        // Light variant: favicon-light-32x32.png → use source
+        if (baseName.includes('-light-')) return defaultSource
+        return defaultSource
+      }
+
       server.middlewares.use(async (req, res, next) => {
         const url = req.url ?? ''
 
-        // Resolve locale-specific source: /{locale}/favicon.svg → locale source
+        // Resolve locale-specific source
         const localeSource = resolveLocaleSource(url, config, root)
-
-        // Serve source as favicon.svg in dev
         const svgUrl = localeSource ? localeSource.url : url
         const svgPath = localeSource ? localeSource.sourcePath : sourcePath
         const isSvgSource = localeSource ? localeSource.source.endsWith('.svg') : config.source.endsWith('.svg')
 
+        // Serve favicon.svg — in dev, add dev badge overlay if configured
         if (svgUrl.endsWith('/favicon.svg') && isSvgSource) {
           try {
-            const content = await readFile(svgPath, 'utf-8')
+            let content = await readFile(svgPath, 'utf-8')
+            if (autoDevBadge) content = addDevBadgeToSvg(content)
+            else if (devSourcePath && existsSync(devSourcePath)) {
+              content = await readFile(devSourcePath, 'utf-8')
+            }
             res.setHeader('Content-Type', 'image/svg+xml')
             res.end(content)
             return
           } catch { /* fall through */ }
         }
 
-        // Serve generated PNGs on-demand (supports /{locale}/favicon-32x32.png)
+        // Serve generated PNGs on-demand — supports dark variants + dev badge
         const baseName = svgUrl.split('/').pop() ?? ''
-        const sizeMatch = SIZES.find((s) => s.name === baseName)
+        // Strip light-/dark- prefix for size matching
+        const cleanName = baseName.replace(/-?(light|dark)-/, '-')
+        const sizeMatch = SIZES.find((s) => s.name === cleanName || baseName === s.name)
         if (sizeMatch) {
-          const cacheKey = `${svgPath}:${sizeMatch.size}`
+          const resolvedSource = resolveSourceForDev(baseName, svgPath)
+          const cacheKey = `${resolvedSource}:${sizeMatch.size}:${autoDevBadge}`
           let png = devCache.get(cacheKey)
           if (!png) {
-            const result = await resizeToPng(svgPath, sizeMatch.size)
+            let result = await resizeToPng(resolvedSource, sizeMatch.size)
+            if (result && autoDevBadge) {
+              result = await addDevBadgeToPng(result, sizeMatch.size)
+            }
             if (result) {
               png = result
               devCache.set(cacheKey, result)
@@ -210,12 +250,14 @@ export function faviconPlugin(config: FaviconPluginConfig): Plugin {
     // Inject favicon <link> tags into HTML
     transformIndexHtml() {
       const isSvg = config.source.endsWith('.svg')
+      const hasDark = !!config.darkSource
       const tags: Array<{
         tag: string
         attrs: Record<string, string>
         injectTo: 'head'
       }> = []
 
+      // SVG favicon (with prefers-color-scheme media query when dark variant exists)
       if (isSvg) {
         tags.push({
           tag: 'link',
@@ -224,23 +266,28 @@ export function faviconPlugin(config: FaviconPluginConfig): Plugin {
         })
       }
 
-      tags.push(
-        {
-          tag: 'link',
-          attrs: { rel: 'icon', type: 'image/png', sizes: '32x32', href: '/favicon-32x32.png' },
-          injectTo: 'head',
-        },
-        {
-          tag: 'link',
-          attrs: { rel: 'icon', type: 'image/png', sizes: '16x16', href: '/favicon-16x16.png' },
-          injectTo: 'head',
-        },
-        {
-          tag: 'link',
-          attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon.png' },
-          injectTo: 'head',
-        },
-      )
+      if (hasDark) {
+        // Dual-variant PNG/ICO favicons — light active, dark hidden via media="not all".
+        // The themeScript and initTheme() swap these based on the resolved theme.
+        const lightAttrs = { 'data-favicon-theme': 'light' }
+        const darkAttrs = { 'data-favicon-theme': 'dark', media: 'not all' }
+
+        tags.push(
+          { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '32x32', href: '/favicon-light-32x32.png', ...lightAttrs }, injectTo: 'head' },
+          { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '32x32', href: '/favicon-dark-32x32.png', ...darkAttrs }, injectTo: 'head' },
+          { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '16x16', href: '/favicon-light-16x16.png', ...lightAttrs }, injectTo: 'head' },
+          { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '16x16', href: '/favicon-dark-16x16.png', ...darkAttrs }, injectTo: 'head' },
+          { tag: 'link', attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon-light.png', ...lightAttrs }, injectTo: 'head' },
+          { tag: 'link', attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon-dark.png', ...darkAttrs }, injectTo: 'head' },
+        )
+      } else {
+        // Single-variant (no dark mode)
+        tags.push(
+          { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '32x32', href: '/favicon-32x32.png' }, injectTo: 'head' },
+          { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '16x16', href: '/favicon-16x16.png' }, injectTo: 'head' },
+          { tag: 'link', attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon.png' }, injectTo: 'head' },
+        )
+      }
 
       if (generateManifest) {
         tags.push({
@@ -371,14 +418,43 @@ async function generateFaviconSet(
   }
 
   // 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,
-      })
+  if (darkSource) {
+    // Dual-variant: generate light + dark PNGs with prefixed names
+    const darkPath = join(rootDir, darkSource)
+    const darkExists = existsSync(darkPath)
+
+    for (const { size, name } of SIZES) {
+      // Light variant
+      const lightName = name.replace(/^(favicon-)/, '$1light-').replace(/^(apple-touch-icon)/, '$1-light').replace(/^(icon-)/, '$1light-')
+      const lightPng = await resizeToPng(sourcePath, size)
+      if (lightPng) {
+        this.emitFile({ type: 'asset', fileName: `${prefix}${lightName}`, source: lightPng })
+      }
+
+      // Dark variant
+      if (darkExists) {
+        const darkName = name.replace(/^(favicon-)/, '$1dark-').replace(/^(apple-touch-icon)/, '$1-dark').replace(/^(icon-)/, '$1dark-')
+        const darkPng = await resizeToPng(darkPath, size)
+        if (darkPng) {
+          this.emitFile({ type: 'asset', fileName: `${prefix}${darkName}`, source: darkPng })
+        }
+      }
+    }
+
+    // Also generate standard names (used by manifest + external references)
+    for (const { size, name } of SIZES) {
+      const pngBuffer = await resizeToPng(sourcePath, size)
+      if (pngBuffer) {
+        this.emitFile({ type: 'asset', fileName: `${prefix}${name}`, source: pngBuffer })
+      }
+    }
+  } else {
+    // Single-variant
+    for (const { size, name } of SIZES) {
+      const pngBuffer = await resizeToPng(sourcePath, size)
+      if (pngBuffer) {
+        this.emitFile({ type: 'asset', fileName: `${prefix}${name}`, source: pngBuffer })
+      }
     }
   }
 
@@ -519,3 +595,57 @@ export function createIcoFromPngs(entries: IcoEntry[]): Uint8Array {
 
   return Buffer.concat([header, dirEntries, ...dataBuffers])
 }
+
+// ─── Dev badge helpers ──────────────────────────────────────────────────────
+
+/**
+ * Add a "DEV" badge overlay to an SVG string.
+ * Adds a small colored circle with "DEV" text in the bottom-right corner.
+ */
+function addDevBadgeToSvg(svg: string): string {
+  const viewBoxMatch = svg.match(/viewBox="([^"]*)"/)
+  const viewBox = viewBoxMatch?.[1] ?? '0 0 32 32'
+  const [, , w, h] = viewBox.split(' ').map(Number)
+  const size = Math.min(w ?? 32, h ?? 32)
+  const r = size * 0.28
+  const cx = (w ?? 32) - r
+  const cy = (h ?? 32) - r
+  const fontSize = r * 0.85
+
+  const badge = `<circle cx="${cx}" cy="${cy}" r="${r}" fill="#ef4444" stroke="white" stroke-width="${size * 0.03}"/>` +
+    `<text x="${cx}" y="${cy}" font-size="${fontSize}" font-weight="bold" fill="white" text-anchor="middle" dominant-baseline="central" font-family="sans-serif">D</text>`
+
+  // Insert badge before closing </svg>
+  return svg.replace(/<\/svg>\s*$/, `${badge}</svg>`)
+}
+
+/**
+ * Add a "DEV" badge to a PNG buffer via sharp composite.
+ * Composites a red circle with "D" in the bottom-right corner.
+ */
+async function addDevBadgeToPng(pngBuffer: Uint8Array, size: number): Promise<Uint8Array> {
+  try {
+    const sharp = await import('sharp').then((m) => m.default ?? m)
+    const r = Math.round(size * 0.28)
+    const d = r * 2
+    const fontSize = Math.round(r * 0.85)
+
+    const badgeSvg = `<svg width="${d}" height="${d}" xmlns="http://www.w3.org/2000/svg">
+      <circle cx="${r}" cy="${r}" r="${r}" fill="#ef4444"/>
+      <text x="${r}" y="${r}" font-size="${fontSize}" font-weight="bold" fill="white" text-anchor="middle" dominant-baseline="central" font-family="sans-serif">D</text>
+    </svg>`
+
+    const badgePng = await sharp(Buffer.from(badgeSvg)).png().toBuffer()
+
+    return await (sharp(Buffer.from(pngBuffer)) as any)
+      .composite([{
+        input: badgePng,
+        gravity: 'southeast',
+      }])
+      .png()
+      .toBuffer()
+  } catch {
+    // sharp not available — return original
+    return pngBuffer
+  }
+}

package/src/index.ts

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

package/src/meta.tsx

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

package/src/server.ts

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