@pyreon/zero 0.5.0 → 0.11.0

package/src/isr.ts

@@ -1,4 +1,4 @@
-import type { ISRConfig } from './types'
+import type { ISRConfig } from "./types"
 
 // ─── ISR Cache ───────────────────────────────────────────────────────────────
 
@@ -28,7 +28,7 @@ export function createISRHandler(
     revalidating.add(key)
 
     try {
-      const req = new Request(url.href, { method: 'GET' })
+      const req = new Request(url.href, { method: "GET" })
       const res = await handler(req)
       const html = await res.text()
       const headers: Record<string, string> = {}
@@ -46,7 +46,7 @@ export function createISRHandler(
 
   return async (req: Request): Promise<Response> => {
     // Only cache GET requests
-    if (req.method !== 'GET') {
+    if (req.method !== "GET") {
       return handler(req)
     }
 
@@ -66,9 +66,9 @@ export function createISRHandler(
         status: 200,
         headers: {
           ...entry.headers,
-          'content-type': 'text/html; charset=utf-8',
-          'x-isr-cache': age > revalidateMs ? 'STALE' : 'HIT',
-          'x-isr-age': String(Math.round(age / 1000)),
+          "content-type": "text/html; charset=utf-8",
+          "x-isr-cache": age > revalidateMs ? "STALE" : "HIT",
+          "x-isr-age": String(Math.round(age / 1000)),
         },
       })
     }
@@ -87,8 +87,8 @@ export function createISRHandler(
       status: 200,
       headers: {
         ...headers,
-        'content-type': 'text/html; charset=utf-8',
-        'x-isr-cache': 'MISS',
+        "content-type": "text/html; charset=utf-8",
+        "x-isr-cache": "MISS",
       },
     })
   }

package/src/link.tsx

@@ -1,6 +1,6 @@
-import { createRef } from '@pyreon/core'
-import { useRouter } from '@pyreon/router'
-import { useIntersectionObserver } from './utils/use-intersection-observer'
+import { createRef } from "@pyreon/core"
+import { useRouter } from "@pyreon/router"
+import { useIntersectionObserver } from "./utils/use-intersection-observer"
 
 // ─── Link component with prefetching ────────────────────────────────────────
 //
@@ -23,19 +23,19 @@ export interface LinkProps {
   /** Class applied when this link exactly matches the current route. */
   exactActiveClass?: string
   /** Prefetch strategy. Default: "hover" */
-  prefetch?: 'hover' | 'viewport' | 'none'
+  prefetch?: "hover" | "viewport" | "none"
   /** Open in new tab. */
   external?: boolean
   /** Inline styles. */
   style?: string
   /** ARIA label. */
-  'aria-label'?: string
+  "aria-label"?: string
 }
 
 /** Props passed to a custom component via createLink. */
 export interface LinkRenderProps {
   href: string
-  ref: import('@pyreon/core').Ref<HTMLElement>
+  ref: import("@pyreon/core").Ref<HTMLAnchorElement>
   onClick: (e: MouseEvent) => void
   onMouseEnter: () => void
   onTouchStart: () => void
@@ -46,14 +46,14 @@ export interface LinkRenderProps {
   style?: string
   target?: string
   rel?: string
-  'aria-label'?: string
+  "aria-label"?: string
   children?: any
 }
 
 /** Return type of useLink. */
 export interface UseLinkReturn {
   /** Ref object — attach to the root element for viewport-based prefetch. */
-  ref: import('@pyreon/core').Ref<HTMLElement>
+  ref: import("@pyreon/core").Ref<HTMLAnchorElement>
   /** Click handler — performs client-side navigation. */
   handleClick: (e: MouseEvent) => void
   /** Mouse enter handler — triggers hover prefetch. */
@@ -74,15 +74,15 @@ function doPrefetch(href: string) {
   if (prefetched.has(href)) return
   prefetched.add(href)
 
-  const docLink = document.createElement('link')
-  docLink.rel = 'prefetch'
+  const docLink = document.createElement("link")
+  docLink.rel = "prefetch"
   docLink.href = href
-  docLink.as = 'document'
+  docLink.as = "document"
   document.head.appendChild(docLink)
 
   try {
-    const chunkHint = document.createElement('link')
-    chunkHint.rel = 'modulepreload'
+    const chunkHint = document.createElement("link")
+    chunkHint.rel = "modulepreload"
     chunkHint.href = href
     document.head.appendChild(chunkHint)
   } catch {
@@ -108,8 +108,8 @@ function doPrefetch(href: string) {
  */
 export function useLink(props: LinkProps): UseLinkReturn {
   const router = useRouter()
-  const elementRef = createRef<HTMLElement>()
-  const strategy = props.prefetch ?? 'hover'
+  const elementRef = createRef<HTMLAnchorElement>()
+  const strategy = props.prefetch ?? "hover"
 
   function handleClick(e: MouseEvent) {
     if (
@@ -128,18 +128,18 @@ export function useLink(props: LinkProps): UseLinkReturn {
   }
 
   function handleMouseEnter() {
-    if (strategy === 'hover') {
+    if (strategy === "hover") {
       doPrefetch(props.href)
     }
   }
 
   function handleTouchStart() {
-    if (strategy === 'hover' || strategy === 'viewport') {
+    if (strategy === "hover" || strategy === "viewport") {
       doPrefetch(props.href)
     }
   }
 
-  if (strategy === 'viewport') {
+  if (strategy === "viewport") {
     useIntersectionObserver(
       () => elementRef.current ?? undefined,
       () => doPrefetch(props.href),
@@ -149,7 +149,7 @@ export function useLink(props: LinkProps): UseLinkReturn {
   const isActive = () => {
     const currentPath = router.currentRoute()?.path
     if (!currentPath || !props.href) return false
-    if (props.href === '/') return currentPath === '/'
+    if (props.href === "/") return currentPath === "/"
     return currentPath.startsWith(props.href)
   }
 
@@ -163,9 +163,8 @@ export function useLink(props: LinkProps): UseLinkReturn {
     const cls: string[] = []
     if (props.class) cls.push(props.class)
     if (props.activeClass && isActive()) cls.push(props.activeClass)
-    if (props.exactActiveClass && isExactActive())
-      cls.push(props.exactActiveClass)
-    return cls.join(' ')
+    if (props.exactActiveClass && isExactActive()) cls.push(props.exactActiveClass)
+    return cls.join(" ")
   }
 
   return {
@@ -214,9 +213,7 @@ export function useLink(props: LinkProps): UseLinkReturn {
  * <ButtonLink href="/about">About</ButtonLink>
  * <CardLink href="/posts" prefetch="viewport">Posts</CardLink>
  */
-export function createLink(
-  Component: (props: LinkRenderProps) => any,
-): (props: LinkProps) => any {
+export function createLink(Component: (props: LinkRenderProps) => any): (props: LinkProps) => any {
   return function WrappedLink(props: LinkProps) {
     const link = useLink(props)
 
@@ -231,8 +228,8 @@ export function createLink(
         isExactActive={link.isExactActive}
         class={link.classes}
         {...(props.style ? { style: props.style } : {})}
-        {...(props.external ? { target: '_blank', rel: 'noopener noreferrer' } : {})}
-        {...(props['aria-label'] ? { 'aria-label': props['aria-label'] } : {})}
+        {...(props.external ? { target: "_blank", rel: "noopener noreferrer" } : {})}
+        {...(props["aria-label"] ? { "aria-label": props["aria-label"] } : {})}
         children={props.children}
       />
     )
@@ -248,14 +245,14 @@ export function createLink(
  */
 export const Link = createLink((props: LinkRenderProps) => (
   <a
-    ref={props.ref as any}
+    ref={props.ref}
     href={props.href}
     {...(props.class ? { class: props.class } : {})}
     {...(props.style ? { style: props.style } : {})}
     {...(props.target ? { target: props.target } : {})}
     {...(props.rel ? { rel: props.rel } : {})}
-    {...(props['aria-label'] ? { 'aria-label': props['aria-label'] } : {})}
-    {...(props.isExactActive() ? { 'aria-current': 'page' as const } : {})}
+    {...(props["aria-label"] ? { "aria-label": props["aria-label"] } : {})}
+    {...(props.isExactActive() ? { "aria-current": "page" as const } : {})}
     onClick={props.onClick}
     onMouseEnter={props.onMouseEnter}
     onTouchStart={props.onTouchStart}

package/src/rate-limit.ts

@@ -1,4 +1,4 @@
-import type { Middleware, MiddlewareContext } from '@pyreon/server'
+import type { Middleware, MiddlewareContext } from "@pyreon/server"
 
 // ─── Rate limiting middleware ───────────────────────────────────────────────
 
@@ -61,7 +61,7 @@ export function rateLimitMiddleware(config: RateLimitConfig = {}): Middleware {
   }, windowMs)
 
   // Allow GC to clean up the interval
-  if (typeof cleanupInterval === 'object' && 'unref' in cleanupInterval) {
+  if (typeof cleanupInterval === "object" && "unref" in cleanupInterval) {
     cleanupInterval.unref()
   }
 
@@ -84,21 +84,21 @@ export function rateLimitMiddleware(config: RateLimitConfig = {}): Middleware {
     const resetSeconds = Math.ceil((entry.resetAt - now) / 1000)
 
     // Set rate limit headers on all responses
-    ctx.headers.set('X-RateLimit-Limit', String(max))
-    ctx.headers.set('X-RateLimit-Remaining', String(remaining))
-    ctx.headers.set('X-RateLimit-Reset', String(resetSeconds))
+    ctx.headers.set("X-RateLimit-Limit", String(max))
+    ctx.headers.set("X-RateLimit-Remaining", String(remaining))
+    ctx.headers.set("X-RateLimit-Reset", String(resetSeconds))
 
     if (entry.count > max) {
       if (onLimit) return onLimit(ctx)
 
-      return new Response(JSON.stringify({ error: 'Too many requests' }), {
+      return new Response(JSON.stringify({ error: "Too many requests" }), {
         status: 429,
         headers: {
-          'Content-Type': 'application/json',
-          'Retry-After': String(resetSeconds),
-          'X-RateLimit-Limit': String(max),
-          'X-RateLimit-Remaining': '0',
-          'X-RateLimit-Reset': String(resetSeconds),
+          "Content-Type": "application/json",
+          "Retry-After": String(resetSeconds),
+          "X-RateLimit-Limit": String(max),
+          "X-RateLimit-Remaining": "0",
+          "X-RateLimit-Reset": String(resetSeconds),
         },
       })
     }
@@ -107,15 +107,15 @@ export function rateLimitMiddleware(config: RateLimitConfig = {}): Middleware {
 
 function defaultKeyFn(ctx: MiddlewareContext): string {
   return (
-    ctx.req.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ??
-    ctx.req.headers.get('x-real-ip') ??
-    'unknown'
+    ctx.req.headers.get("x-forwarded-for")?.split(",")[0]?.trim() ??
+    ctx.req.headers.get("x-real-ip") ??
+    "unknown"
   )
 }
 
 /** Simple glob matching for path patterns. Supports trailing `*`. */
 function matchSimpleGlob(pattern: string, path: string): boolean {
-  if (pattern.endsWith('/*')) {
+  if (pattern.endsWith("/*")) {
     return path.startsWith(pattern.slice(0, -1))
   }
   return pattern === path

package/src/script.tsx

@@ -1,6 +1,6 @@
-import type { VNodeChild } from '@pyreon/core'
-import { createRef, onMount, onUnmount } from '@pyreon/core'
-import { useIntersectionObserver } from './utils/use-intersection-observer'
+import type { VNodeChild } from "@pyreon/core"
+import { createRef, onMount, onUnmount } from "@pyreon/core"
+import { useIntersectionObserver } from "./utils/use-intersection-observer"
 
 // ─── Script optimization component ─────────────────────────────────────────
 //
@@ -29,11 +29,11 @@ export interface ScriptProps {
 }
 
 export type ScriptStrategy =
-  | 'beforeHydration'
-  | 'afterHydration'
-  | 'onIdle'
-  | 'onInteraction'
-  | 'onViewport'
+  | "beforeHydration"
+  | "afterHydration"
+  | "onIdle"
+  | "onInteraction"
+  | "onViewport"
 
 /**
  * Optimized script loading component.
@@ -55,15 +55,14 @@ export function Script(props: ScriptProps): VNodeChild {
     // Deduplication
     if (props.id && document.getElementById(props.id)) return
 
-    const script = document.createElement('script')
+    const script = document.createElement("script")
     if (props.src) script.src = props.src
     if (props.id) script.id = props.id
     script.async = props.async !== false
 
     if (props.onLoad) script.onload = props.onLoad
     if (props.onError) {
-      script.onerror = () =>
-        props.onError?.(new Error(`Failed to load: ${props.src}`))
+      script.onerror = () => props.onError?.(new Error(`Failed to load: ${props.src}`))
     }
 
     if (props.children && !props.src) {
@@ -74,28 +73,28 @@ export function Script(props: ScriptProps): VNodeChild {
   }
 
   onMount(() => {
-    const strategy = props.strategy ?? 'afterHydration'
+    const strategy = props.strategy ?? "afterHydration"
 
     switch (strategy) {
-      case 'beforeHydration':
+      case "beforeHydration":
         // Already in HTML — do nothing
         break
 
-      case 'afterHydration':
+      case "afterHydration":
         // Load immediately after mount (hydration is complete)
         loadScript()
         break
 
-      case 'onIdle':
-        if ('requestIdleCallback' in window) {
+      case "onIdle":
+        if ("requestIdleCallback" in window) {
           requestIdleCallback(() => loadScript(), { timeout: 5000 })
         } else {
           setTimeout(loadScript, 200)
         }
         break
 
-      case 'onInteraction': {
-        const events = ['click', 'scroll', 'keydown', 'touchstart']
+      case "onInteraction": {
+        const events = ["click", "scroll", "keydown", "touchstart"]
         function handler() {
           for (const e of events) document.removeEventListener(e, handler)
           loadScript()
@@ -109,7 +108,7 @@ export function Script(props: ScriptProps): VNodeChild {
         break
       }
 
-      case 'onViewport':
+      case "onViewport":
         // Handled below via useIntersectionObserver on the sentinel element
         break
     }
@@ -117,16 +116,16 @@ export function Script(props: ScriptProps): VNodeChild {
   })
 
   const sentinelRef = createRef<HTMLElement>()
-  const strategy = props.strategy ?? 'afterHydration'
+  const strategy = props.strategy ?? "afterHydration"
 
-  if (strategy === 'onViewport') {
+  if (strategy === "onViewport") {
     useIntersectionObserver(
       () => sentinelRef.current ?? undefined,
       () => loadScript(),
     )
   }
 
-  if (strategy === 'onViewport') {
+  if (strategy === "onViewport") {
     return <div ref={sentinelRef} style="width:0;height:0;overflow:hidden" />
   }
 

package/src/seo.ts

@@ -1,5 +1,5 @@
-import type { Middleware } from '@pyreon/server'
-import type { Plugin } from 'vite'
+import type { Middleware } from "@pyreon/server"
+import type { Plugin } from "vite"
 
 // ─── SEO utilities ──────────────────────────────────────────────────────────
 //
@@ -29,47 +29,37 @@ export interface SitemapEntry {
   lastmod?: string
 }
 
-export type ChangeFreq =
-  | 'always'
-  | 'hourly'
-  | 'daily'
-  | 'weekly'
-  | 'monthly'
-  | 'yearly'
-  | 'never'
+export type ChangeFreq = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never"
 
 /**
  * Generate a sitemap.xml string from route file paths.
  */
-export function generateSitemap(
-  routeFiles: string[],
-  config: SitemapConfig,
-): string {
-  const { origin, exclude = [], changefreq = 'weekly', priority = 0.7 } = config
+export function generateSitemap(routeFiles: string[], config: SitemapConfig): string {
+  const { origin, exclude = [], changefreq = "weekly", priority = 0.7 } = config
 
   const paths = routeFiles
     .filter((f) => {
       // Exclude layout, error, loading files
       const name = f
-        .split('/')
+        .split("/")
         .pop()
-        ?.replace(/\.\w+$/, '')
-      return name !== '_layout' && name !== '_error' && name !== '_loading'
+        ?.replace(/\.\w+$/, "")
+      return name !== "_layout" && name !== "_error" && name !== "_loading"
     })
     .map((f) => {
       // Convert file path to URL
       let path = f
-        .replace(/\.\w+$/, '')
-        .replace(/\/index$/, '/')
-        .replace(/^index$/, '/')
+        .replace(/\.\w+$/, "")
+        .replace(/\/index$/, "/")
+        .replace(/^index$/, "/")
 
       // Skip dynamic routes — they need additionalPaths
-      if (path.includes('[')) return null
+      if (path.includes("[")) return null
 
       // Strip route groups
-      path = path.replace(/\([\w-]+\)\//g, '')
+      path = path.replace(/\([\w-]+\)\//g, "")
 
-      if (!path.startsWith('/')) path = `/${path}`
+      if (!path.startsWith("/")) path = `/${path}`
       return path
     })
     .filter((p): p is string => p !== null)
@@ -82,14 +72,14 @@ export function generateSitemap(
 
   const entries = allPaths
     .map((entry) => {
-      const loc = `${origin}${entry.path === '/' ? '' : entry.path}`
+      const loc = `${origin}${entry.path === "/" ? "" : entry.path}`
       return `  <url>
     <loc>${escapeXml(loc)}</loc>
     <changefreq>${entry.changefreq ?? changefreq}</changefreq>
-    <priority>${entry.priority ?? priority}</priority>${entry.lastmod ? `\n    <lastmod>${entry.lastmod}</lastmod>` : ''}
+    <priority>${entry.priority ?? priority}</priority>${entry.lastmod ? `\n    <lastmod>${entry.lastmod}</lastmod>` : ""}
   </url>`
     })
-    .join('\n')
+    .join("\n")
 
   return `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
@@ -99,11 +89,11 @@ ${entries}
 
 function escapeXml(str: string): string {
   return str
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&apos;')
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;")
 }
 
 // ─── Robots.txt ─────────────────────────────────────────────────────────────
@@ -128,7 +118,7 @@ export interface RobotsRule {
  * Generate a robots.txt string.
  */
 export function generateRobots(config: RobotsConfig = {}): string {
-  const { rules = [{ userAgent: '*', allow: ['/'] }], sitemap, host } = config
+  const { rules = [{ userAgent: "*", allow: ["/"] }], sitemap, host } = config
   const lines: string[] = []
 
   for (const rule of rules) {
@@ -140,27 +130,27 @@ export function generateRobots(config: RobotsConfig = {}): string {
       for (const path of rule.disallow) lines.push(`Disallow: ${path}`)
     }
     if (rule.crawlDelay) lines.push(`Crawl-delay: ${rule.crawlDelay}`)
-    lines.push('')
+    lines.push("")
   }
 
   if (sitemap) lines.push(`Sitemap: ${sitemap}`)
   if (host) lines.push(`Host: ${host}`)
 
-  return lines.join('\n')
+  return lines.join("\n")
 }
 
 // ─── Structured data (JSON-LD) ──────────────────────────────────────────────
 
 export type JsonLdType =
-  | 'WebSite'
-  | 'WebPage'
-  | 'Article'
-  | 'BlogPosting'
-  | 'Product'
-  | 'Organization'
-  | 'Person'
-  | 'BreadcrumbList'
-  | 'FAQPage'
+  | "WebSite"
+  | "WebPage"
+  | "Article"
+  | "BlogPosting"
+  | "Product"
+  | "Organization"
+  | "Person"
+  | "BreadcrumbList"
+  | "FAQPage"
   | (string & {})
 
 /**
@@ -177,7 +167,7 @@ export type JsonLdType =
  */
 export function jsonLd(data: Record<string, unknown>): string {
   const ld = {
-    '@context': 'https://schema.org',
+    "@context": "https://schema.org",
     ...data,
   }
   return `<script type="application/ld+json">${JSON.stringify(ld)}</script>`
@@ -212,13 +202,13 @@ export interface SeoPluginConfig {
  */
 export function seoPlugin(config: SeoPluginConfig = {}): Plugin {
   return {
-    name: 'pyreon-zero-seo',
-    apply: 'build',
+    name: "pyreon-zero-seo",
+    apply: "build",
 
     async generateBundle(_, _bundle) {
       // Generate sitemap.xml
       if (config.sitemap) {
-        const { scanRouteFiles } = await import('./fs-router')
+        const { scanRouteFiles } = await import("./fs-router")
         const routesDir = `${process.cwd()}/src/routes`
 
         try {
@@ -226,8 +216,8 @@ export function seoPlugin(config: SeoPluginConfig = {}): Plugin {
           const sitemap = generateSitemap(files, config.sitemap)
 
           this.emitFile({
-            type: 'asset',
-            fileName: 'sitemap.xml',
+            type: "asset",
+            fileName: "sitemap.xml",
             source: sitemap,
           })
         } catch {
@@ -240,8 +230,8 @@ export function seoPlugin(config: SeoPluginConfig = {}): Plugin {
         const robots = generateRobots(config.robots)
 
         this.emitFile({
-          type: 'asset',
-          fileName: 'robots.txt',
+          type: "asset",
+          fileName: "robots.txt",
           source: robots,
         })
       }
@@ -257,21 +247,21 @@ export function seoPlugin(config: SeoPluginConfig = {}): Plugin {
  */
 export function seoMiddleware(config: SeoPluginConfig = {}): Middleware {
   return async (ctx) => {
-    if (ctx.url.pathname === '/robots.txt' && config.robots) {
+    if (ctx.url.pathname === "/robots.txt" && config.robots) {
       return new Response(generateRobots(config.robots), {
-        headers: { 'Content-Type': 'text/plain' },
+        headers: { "Content-Type": "text/plain" },
       })
     }
 
-    if (ctx.url.pathname === '/sitemap.xml' && config.sitemap) {
+    if (ctx.url.pathname === "/sitemap.xml" && config.sitemap) {
       try {
-        const { scanRouteFiles } = await import('./fs-router')
+        const { scanRouteFiles } = await import("./fs-router")
         const routesDir = `${process.cwd()}/src/routes`
         const files = await scanRouteFiles(routesDir)
         const sitemap = generateSitemap(files, config.sitemap)
 
         return new Response(sitemap, {
-          headers: { 'Content-Type': 'application/xml' },
+          headers: { "Content-Type": "application/xml" },
         })
       } catch {
         // Sitemap generation failed — continue to rendering

package/src/sharp.d.ts

@@ -1,10 +1,6 @@
-declare module 'sharp' {
+declare module "sharp" {
   interface SharpInstance {
-    resize(
-      width: number,
-      height?: number,
-      options?: { fit?: string },
-    ): SharpInstance
+    resize(width: number, height?: number, options?: { fit?: string }): SharpInstance
     webp(options?: { quality?: number }): SharpInstance
     avif(options?: { quality?: number }): SharpInstance
     jpeg(options?: { quality?: number; mozjpeg?: boolean }): SharpInstance