@pyreon/zero 0.24.4 → 0.24.6

package/src/meta.tsx

@@ -1,354 +0,0 @@
-import type { VNodeChild } from '@pyreon/core'
-import type { UseHeadInput } from '@pyreon/head'
-import { useHead } from '@pyreon/head'
-import type { I18nRoutingConfig } from './i18n-routing'
-import { extractLocaleFromPath } from './i18n-routing'
-
-// ─── 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 ────────────────────────────────────────────────────────
-
-export interface MetaProps {
-  /** Page title. Accepts reactive accessor `() => string`. */
-  title?: string | (() => string)
-  /** Page description. Accepts reactive accessor. */
-  description?: string | (() => string)
-  /** Canonical URL. Also sets og:url. */
-  canonical?: string
-  /** Open Graph image URL. Also sets twitter:image. */
-  image?: string
-  /** Image alt text for accessibility. */
-  imageAlt?: string
-  /** Image width in pixels (og:image:width). Helps crawlers layout before loading. */
-  imageWidth?: number
-  /** Image height in pixels (og:image:height). */
-  imageHeight?: number
-  /** Open Graph type. Default: "website" */
-  type?: 'website' | 'article' | 'product' | 'profile'
-  /** Site name for og:site_name. */
-  siteName?: string
-  /** Twitter card type. Default: "summary_large_image" */
-  twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player'
-  /** Twitter @handle. */
-  twitterSite?: string
-  /** Twitter creator @handle. */
-  twitterCreator?: string
-  /** Locale. Default: "en_US" */
-  locale?: string
-  /** Alternate locales for hreflang. */
-  alternateLocales?: Array<{ locale: string; url: string }>
-  /** Robots directives. Default: "index, follow" */
-  robots?: string
-  /** Convenience: set `true` to emit `noindex, nofollow`. Overrides `robots`. */
-  noIndex?: boolean
-  /** Published time (ISO 8601) for article type. */
-  publishedTime?: string
-  /** Modified time (ISO 8601) for article type. */
-  modifiedTime?: string
-  /** Article author. */
-  author?: string
-  /** Article tags. */
-  tags?: string[]
-  /** JSON-LD structured data object. */
-  jsonLd?: Record<string, unknown>
-  /** Additional custom meta tags. */
-  extra?: Array<{ name?: string; property?: string; content: string }>
-  /**
-   * Open Graph video URL. Also sets og:video:type if the URL ends with
-   * a known extension (.mp4, .webm).
-   */
-  video?: string
-  /** Video width in pixels. */
-  videoWidth?: number
-  /** Video height in pixels. */
-  videoHeight?: number
-  /**
-   * Open Graph audio URL.
-   */
-  audio?: string
-  /**
-   * I18n routing config — when provided, auto-generates hreflang alternate
-   * links for all locales based on the current path.
-   * Also sets og:locale and og:locale:alternate.
-   */
-  i18n?: I18nRoutingConfig
-  /** Base URL for building absolute hreflang URLs. e.g. "https://example.com" */
-  origin?: string
-  /**
-   * Favicon plugin config — when provided, injects locale-aware favicon
-   * `<link>` tags into `<head>`. Uses the current locale to select
-   * the correct favicon set.
-   */
-  favicon?: FaviconPluginConfig
-  /**
-   * OG image template name — auto-resolves to the correct locale-specific
-   * OG image path generated by `ogImagePlugin`.
-   * Sets both `og:image` and `twitter:image` unless `image` is also provided.
-   */
-  ogTemplate?: string
-  /** Output directory for OG images. Default: "og" */
-  ogImageDir?: string
-  /** OG image format. Default: "png" */
-  ogImageFormat?: 'png' | 'jpeg'
-  children?: VNodeChild
-}
-
-const resolveStr = (v: string | (() => string) | undefined): string | undefined =>
-  typeof v === 'function' ? v() : v
-
-/**
- * Declarative meta component for SSR-compatible page metadata.
- *
- * Supports reactive title/description — when passed as `() => string` accessors,
- * they are forwarded to `useHead()` as a reactive getter so updates propagate
- * automatically via signal tracking.
- *
- * @example
- * ```tsx
- * <Meta title="My Page" description="..." image="/og.jpg" canonical="https://..." />
- * ```
- *
- * @example Reactive title
- * ```tsx
- * const count = signal(0)
- * <Meta title={() => `${count()} items`} />
- * ```
- */
-export function Meta(props: MetaProps): VNodeChild {
-  const hasReactiveTitle = typeof props.title === 'function'
-  const hasReactiveDescription = typeof props.description === 'function'
-
-  // If title or description are reactive accessors, pass a getter to useHead
-  // so it re-evaluates when the signals change.
-  if (hasReactiveTitle || hasReactiveDescription) {
-    useHead((): UseHeadInput => {
-      const title = resolveStr(props.title)
-      const description = resolveStr(props.description)
-      const resolved = { ...props, title, description } as Parameters<typeof buildMetaTags>[0]
-      const tags = buildMetaTags(resolved)
-      const input: UseHeadInput = { meta: tags.meta, link: tags.link, script: tags.script }
-      if (title) input.title = title
-      return input
-    })
-  } else {
-    const title = resolveStr(props.title)
-    const description = resolveStr(props.description)
-    const resolved = { ...props, title, description } as Parameters<typeof buildMetaTags>[0]
-    const tags = buildMetaTags(resolved)
-    const input: UseHeadInput = { meta: tags.meta, link: tags.link, script: tags.script }
-    if (title) input.title = title
-    useHead(input)
-  }
-
-  return props.children ?? null
-}
-
-interface MetaTagEntry {
-  name?: string
-  property?: string
-  content: string
-  [key: string]: string | undefined
-}
-
-interface LinkTagEntry {
-  rel: string
-  href?: string
-  hreflang?: string
-  type?: string
-  sizes?: string
-  [key: string]: string | undefined
-}
-
-interface ScriptTagEntry {
-  type: string
-  children: string
-}
-
-interface MetaTags {
-  meta: MetaTagEntry[]
-  link: LinkTagEntry[]
-  script: ScriptTagEntry[]
-}
-
-export function buildMetaTags(
-  props: Omit<MetaProps, 'title' | 'description' | 'children'> & {
-    title?: string
-    description?: string
-  },
-): MetaTags {
-  const meta: MetaTagEntry[] = []
-  const link: LinkTagEntry[] = []
-  const script: ScriptTagEntry[] = []
-
-  const {
-    title, description, canonical, imageAlt, imageWidth, imageHeight,
-    type = 'website', siteName,
-    twitterCard = 'summary_large_image', twitterSite, twitterCreator,
-    locale = 'en_US', alternateLocales,
-    publishedTime, modifiedTime, author, tags, jsonLd, extra,
-    video, videoWidth, videoHeight, audio,
-    favicon, ogTemplate, ogImageDir, ogImageFormat,
-  } = props
-
-  // noIndex convenience overrides robots
-  const robots = props.noIndex ? 'noindex, nofollow' : (props.robots ?? 'index, follow')
-
-  // Resolve image: explicit `image` prop takes precedence over `ogTemplate`
-  const image = props.image ?? (
-    ogTemplate
-      ? ogImagePath(ogTemplate, locale !== 'en_US' ? locale : undefined, ogImageDir, ogImageFormat)
-      : undefined
-  )
-
-  // Auto-resolve image dimensions for OG template images
-  const resolvedImageWidth = imageWidth ?? (ogTemplate && !props.image ? 1200 : undefined)
-  const resolvedImageHeight = imageHeight ?? (ogTemplate && !props.image ? 630 : undefined)
-
-  if (description) meta.push({ name: 'description', content: description })
-  if (robots) meta.push({ name: 'robots', content: robots })
-  if (author) meta.push({ name: 'author', content: author })
-
-  if (title) meta.push({ property: 'og:title', content: title })
-  if (description) meta.push({ property: 'og:description', content: description })
-  if (canonical) meta.push({ property: 'og:url', content: canonical })
-  if (image) meta.push({ property: 'og:image', content: image })
-  if (imageAlt) meta.push({ property: 'og:image:alt', content: imageAlt })
-  if (resolvedImageWidth) meta.push({ property: 'og:image:width', content: String(resolvedImageWidth) })
-  if (resolvedImageHeight) meta.push({ property: 'og:image:height', content: String(resolvedImageHeight) })
-  meta.push({ property: 'og:type', content: type })
-  if (siteName) meta.push({ property: 'og:site_name', content: siteName })
-  meta.push({ property: 'og:locale', content: locale })
-
-  // Video
-  if (video) {
-    meta.push({ property: 'og:video', content: video })
-    if (videoWidth) meta.push({ property: 'og:video:width', content: String(videoWidth) })
-    if (videoHeight) meta.push({ property: 'og:video:height', content: String(videoHeight) })
-    // Auto-detect video type from extension
-    if (video.endsWith('.mp4')) meta.push({ property: 'og:video:type', content: 'video/mp4' })
-    else if (video.endsWith('.webm')) meta.push({ property: 'og:video:type', content: 'video/webm' })
-  }
-
-  // Audio
-  if (audio) {
-    meta.push({ property: 'og:audio', content: audio })
-  }
-
-  if (type === 'article') {
-    if (publishedTime) meta.push({ property: 'article:published_time', content: publishedTime })
-    if (modifiedTime) meta.push({ property: 'article:modified_time', content: modifiedTime })
-    if (author) meta.push({ property: 'article:author', content: author })
-    if (tags) for (const tag of tags) meta.push({ property: 'article:tag', content: tag })
-  }
-
-  meta.push({ name: 'twitter:card', content: twitterCard })
-  if (title) meta.push({ name: 'twitter:title', content: title })
-  if (description) meta.push({ name: 'twitter:description', content: description })
-  if (image) meta.push({ name: 'twitter:image', content: image })
-  if (imageAlt) meta.push({ name: 'twitter:image:alt', content: imageAlt })
-  if (twitterSite) meta.push({ name: 'twitter:site', content: twitterSite })
-  if (twitterCreator) meta.push({ name: 'twitter:creator', content: twitterCreator })
-
-  if (canonical) link.push({ rel: 'canonical', href: canonical })
-  if (alternateLocales) {
-    for (const alt of alternateLocales) {
-      link.push({ rel: 'alternate', hreflang: alt.locale, href: alt.url })
-    }
-  }
-
-  if (jsonLd) {
-    script.push({
-      type: 'application/ld+json',
-      children: JSON.stringify({ '@context': 'https://schema.org', ...jsonLd }),
-    })
-  }
-
-  if (extra) for (const tag of extra) meta.push(tag)
-
-  // I18n: auto-generate hreflang alternates from i18nRouting config
-  if (props.i18n) {
-    const i18nConfig = props.i18n
-    const origin = props.origin ?? ''
-    const currentPath = canonical?.replace(origin, '') ?? '/'
-    const { pathWithoutLocale } = extractLocaleFromPath(
-      currentPath,
-      i18nConfig.locales,
-      i18nConfig.defaultLocale,
-    )
-    const strategy = i18nConfig.strategy ?? 'prefix-except-default'
-
-    for (const loc of i18nConfig.locales) {
-      const localizedPath =
-        strategy === 'prefix-except-default' && loc === i18nConfig.defaultLocale
-          ? pathWithoutLocale
-          : `/${loc}${pathWithoutLocale === '/' ? '' : pathWithoutLocale}`
-
-      link.push({
-        rel: 'alternate',
-        hreflang: loc,
-        href: `${origin}${localizedPath}`,
-      })
-
-      // og:locale:alternate for non-current locales
-      if (loc !== locale) {
-        meta.push({ property: 'og:locale:alternate', content: loc })
-      }
-    }
-
-    // x-default hreflang pointing to default locale
-    link.push({
-      rel: 'alternate',
-      hreflang: 'x-default',
-      href: `${origin}${pathWithoutLocale}`,
-    })
-  }
-
-  // Favicon: inject locale-aware favicon links
-  if (favicon) {
-    const faviconLocale = locale !== 'en_US' ? locale : undefined
-    for (const fl of faviconLinks(faviconLocale, favicon)) {
-      link.push(fl as LinkTagEntry)
-    }
-    // Theme color meta from favicon config
-    if (favicon.themeColor) {
-      meta.push({ name: 'theme-color', content: favicon.themeColor })
-    }
-  }
-
-  return { meta, link, script }
-}

package/src/middleware.ts

@@ -1,65 +0,0 @@
-import type { Middleware, MiddlewareContext } from '@pyreon/server'
-
-// ─── Middleware composition ─────────────────────────────────────────────────
-//
-// Chains multiple middleware functions into a single middleware.
-// Each middleware runs in order. If any returns a Response, the chain
-// short-circuits and that Response is returned. If all return void,
-// the composed middleware returns void (continues to rendering).
-
-/**
- * Compose multiple middleware into a single middleware function.
- * Middleware runs sequentially — if any returns a Response, the chain stops.
- *
- * @example
- * import { compose } from "@pyreon/zero/middleware"
- * import { corsMiddleware } from "@pyreon/zero/cors"
- * import { rateLimitMiddleware } from "@pyreon/zero/rate-limit"
- *
- * const combined = compose(
- *   corsMiddleware({ origin: "*" }),
- *   rateLimitMiddleware({ max: 100 }),
- *   cacheMiddleware(),
- * )
- */
-export function compose(...middlewares: Middleware[]): Middleware {
-  return async (ctx: MiddlewareContext) => {
-    for (const mw of middlewares) {
-      const result = await mw(ctx)
-      if (result instanceof Response) return result
-    }
-  }
-}
-
-// ─── Shared request context ─────────────────────────────────────────────────
-//
-// Lightweight context bag attached to MiddlewareContext.locals so middleware
-// can communicate without coupling. Uses a namespaced key to avoid collisions
-// with user-defined locals.
-
-const ZERO_CTX_KEY = '__zeroCtx'
-
-/**
- * Get the shared Zero context from a middleware context.
- * Creates one if it doesn't exist. Middleware can use this to
- * pass data to downstream middleware without polluting `ctx.locals`.
- *
- * @example
- * const authMiddleware: Middleware = (ctx) => {
- *   const zctx = getContext(ctx)
- *   zctx.userId = "user_123"
- * }
- *
- * const loggingMiddleware: Middleware = (ctx) => {
- *   const zctx = getContext(ctx)
- *   console.log("User:", zctx.userId)
- * }
- */
-export function getContext(ctx: MiddlewareContext): Record<string, unknown> {
-  let zctx = ctx.locals[ZERO_CTX_KEY] as Record<string, unknown> | undefined
-  if (!zctx) {
-    zctx = {}
-    ctx.locals[ZERO_CTX_KEY] = zctx
-  }
-  return zctx
-}

package/src/not-found.ts

@@ -1,44 +0,0 @@
-import type { ComponentFn } from "@pyreon/core";
-import { h } from "@pyreon/core";
-import { renderToString } from "@pyreon/runtime-server";
-
-// ─── 404 Not Found rendering ────────────────────────────────────────────────
-//
-// Shared utility for rendering 404 pages in both dev (vite-plugin) and
-// production (entry-server). Renders the notFoundComponent into HTML
-// and wraps it in a minimal document if no template is provided.
-
-const DEFAULT_404_BODY =
-	"<h1>404 — Not Found</h1><p>The page you requested does not exist.</p>";
-
-/**
- * Render a 404 component to a full HTML string.
- * If no component is provided, returns a default 404 page.
- */
-export async function render404Page(
-	component: ComponentFn | undefined,
-	template?: string,
-): Promise<string> {
-	let body: string;
-	if (component) {
-		body = await renderToString(h(component, null));
-	} else {
-		body = DEFAULT_404_BODY;
-	}
-
-	if (template?.includes("<!--pyreon-app-->")) {
-		return template.replace("<!--pyreon-app-->", body);
-	}
-
-	return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>404 — Not Found</title>
-</head>
-<body>
-  ${body}
-</body>
-</html>`;
-}