@pyreon/zero 0.24.5 → 0.24.6

package/src/types.ts

@@ -1,624 +0,0 @@
-import type { ComponentFn } from '@pyreon/core'
-import type { LoaderContext, NavigationGuard } from '@pyreon/router'
-import type { Middleware } from '@pyreon/server'
-import type { I18nRoutingConfig } from './i18n-routing'
-
-// Re-export router's `LoaderContext` so consumers importing it from
-// `@pyreon/zero` keep working. The previous duplicate `interface
-// LoaderContext` (with a `request: Request` field that was never
-// populated by the actually-constructed runtime ctx) was a
-// typed-but-unimplemented bug class — caught by `audit-types`. If
-// SSR loaders need access to the request, plumb it through the
-// router-level `LoaderContext` in a follow-up PR; do NOT add fields
-// here that the runtime doesn't populate.
-export type { LoaderContext }
-
-// ─── Route module conventions ────────────────────────────────────────────────
-
-/** What a route file (e.g. `src/routes/index.tsx`) can export. */
-export interface RouteModule {
-  /** Default export is the page component. */
-  default?: ComponentFn
-  /** Layout wrapper — wraps this route and all children. */
-  layout?: ComponentFn
-  /** Loading component shown while lazy-loading or during Suspense. */
-  loading?: ComponentFn
-  /** Error component shown when the route errors. */
-  error?: ComponentFn
-  /** Server-side data loader. */
-  loader?: (ctx: LoaderContext) => Promise<unknown>
-  /** Per-route middleware. */
-  middleware?: Middleware | Middleware[]
-  /** Navigation guard — can redirect or block navigation. */
-  guard?: NavigationGuard
-  /** Route metadata. */
-  meta?: RouteMeta
-  /** Rendering mode override for this route. */
-  renderMode?: RenderMode
-}
-
-/** Per-route metadata. */
-export interface RouteMeta {
-  title?: string
-  description?: string
-  [key: string]: unknown
-}
-
-// ─── Rendering modes ─────────────────────────────────────────────────────────
-
-export type RenderMode = 'ssr' | 'ssg' | 'spa' | 'isr'
-
-export interface ISRConfig {
-  /** Revalidation interval in seconds. */
-  revalidate: number
-  /**
-   * Maximum number of distinct URL paths to keep in the in-memory cache.
-   * Oldest-first LRU eviction once the cap is reached. Default: `1000`.
-   * Set higher for SSG-heavy sites, lower for routes with unbounded URL
-   * space (e.g. `/user/:id` where `:id` is free-form).
-   */
-  maxEntries?: number
-  /**
-   * Max wall-time (ms) for a single background revalidation before it is
-   * abandoned. Without a bound, a handler that hangs leaves its key
-   * pinned in the in-flight set forever — every later request for that
-   * key short-circuits the de-dupe guard and the entry can never
-   * recover from stale. Default: `30000` (matches the Suspense
-   * streaming timeout).
-   */
-  revalidateTimeoutMs?: number
-  /**
-   * Cache-key derivation function. The default keys cache entries by
-   * `url.pathname` ONLY — query strings, cookies, and headers are
-   * stripped.
-   *
-   * **⚠️ Auth-gated incompatibility.** The default behavior is
-   * unsafe for request-dependent loaders. A loader that reads
-   * `request.headers.get('cookie')` to gate auth will render ONCE
-   * with the first user's cookie, then serve that HTML to every
-   * subsequent user. To use ISR with personalized / auth-gated
-   * pages, supply a `cacheKey` that varies on the auth identifier
-   * (session cookie, user-id header, etc.), OR don't use ISR for
-   * such routes — use SSR instead.
-   *
-   * @example
-   * // Vary cache by session cookie:
-   * isr: {
-   *   revalidate: 60,
-   *   cacheKey: (req) => {
-   *     const url = new URL(req.url)
-   *     const session = req.headers.get('cookie')?.match(/session=([^;]+)/)?.[1] ?? 'anon'
-   *     return `${url.pathname}::${session}`
-   *   },
-   * }
-   *
-   * @example
-   * // Vary by a query parameter:
-   * isr: {
-   *   revalidate: 60,
-   *   cacheKey: (req) => {
-   *     const url = new URL(req.url)
-   *     return `${url.pathname}?sort=${url.searchParams.get('sort') ?? ''}`
-   *   },
-   * }
-   */
-  cacheKey?: (req: Request) => string
-  /**
-   * Pluggable cache backing for multi-instance / horizontally-scaled
-   * production. Default: in-memory `Map` per-process (capped by
-   * `maxEntries`). Pass a Redis / Vercel KV / Cloudflare KV / Upstash
-   * adapter (anything matching the `ISRStore` interface from
-   * `@pyreon/zero/server`) for state shared across instances — a
-   * revalidation in one pod is visible to all pods.
-   *
-   * The store interface accepts BOTH sync and async returns; the
-   * handler `await`s the result either way, so an in-memory store
-   * stays cheap (no Promise allocation per request) while a Redis
-   * store can return its native promises directly.
-   *
-   * When set, `maxEntries` is ignored — the custom store owns its own
-   * eviction / TTL policy.
-   *
-   * @example
-   * // Redis adapter (uses `ioredis` or `@upstash/redis`):
-   * const redis = new Redis(...)
-   * const store: ISRStore = {
-   *   async get(key) {
-   *     const v = await redis.get(`isr:${key}`)
-   *     return v ? JSON.parse(v) : undefined
-   *   },
-   *   async set(key, entry) {
-   *     await redis.set(`isr:${key}`, JSON.stringify(entry), 'EX', 86400)
-   *   },
-   *   async delete(key) {
-   *     await redis.del(`isr:${key}`)
-   *   },
-   * }
-   *
-   * isr: { revalidate: 60, store }
-   */
-  // The actual type lives in `./isr` to avoid `types.ts` pulling the
-  // implementation file; we type it as `unknown` here and let consumers
-  // pass an `ISRStore` directly — `createISRHandler`'s signature checks
-  // the shape statically.
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  store?: import('./isr').ISRStore<any>
-  /**
-   * Construct the `Request` used for background revalidation. Default:
-   * the ORIGINAL user's request (headers, method, URL) — which means a
-   * `cacheKey`-bearing entry triggered by user A is revalidated against
-   * A's cookies / auth headers. For auth-gated `cacheKey` setups this
-   * is risky: if A's session expires before the revalidation runs, the
-   * new render may misbehave (auth-gate hits redirect path, or worse,
-   * still emits A's personalized HTML because the server hasn't yet
-   * invalidated the session token).
-   *
-   * Supply `revalidateRequest` to construct a request scoped to the
-   * cache key — e.g. anonymous for anonymous entries, service-account
-   * for shared entries. Returning `null` SKIPS revalidation entirely
-   * for this entry (stale stays stale until the next live request).
-   *
-   * Compatible with `store`: the revalidate path still reads/writes
-   * the configured store; this hook only controls what request the
-   * re-render runs against.
-   *
-   * @example
-   * isr: {
-   *   revalidate: 60,
-   *   cacheKey: (req) => {
-   *     const session = req.headers.get('cookie')?.match(/session=([^;]+)/)?.[1] ?? 'anon'
-   *     return `${new URL(req.url).pathname}::${session}`
-   *   },
-   *   revalidateRequest: (req) => {
-   *     // Anonymous entries re-revalidate as anonymous (safe default).
-   *     // Authenticated entries skip revalidation — the user's next
-   *     // hit will re-render with their current cookies on cache miss.
-   *     const hasAuth = /session=(?!anon)/.test(req.headers.get('cookie') ?? '')
-   *     return hasAuth ? null : new Request(req.url, { method: 'GET' })
-   *   },
-   * }
-   */
-  revalidateRequest?: (req: Request) => Request | null
-}
-
-// ─── Zero config ─────────────────────────────────────────────────────────────
-
-export interface ZeroConfig {
-  /** Default rendering mode. Default: "ssr" */
-  mode?: RenderMode
-
-  /** Vite config overrides. */
-  vite?: Record<string, unknown>
-
-  /** SSR options. */
-  ssr?: {
-    /** Streaming mode. Default: "string" */
-    mode?: 'string' | 'stream'
-  }
-
-  /** SSG options — only used when mode is "ssg". */
-  ssg?: {
-    /** Paths to prerender (or function returning paths). */
-    paths?: string[] | (() => string[] | Promise<string[]>)
-    /**
-     * Auto-emit `dist/404.html` from the route tree's `_404.tsx` /
-     * `_not-found.tsx` convention. fs-router already wires `_404.tsx` as
-     * `notFoundComponent` on its parent layout route; the SSG plugin walks
-     * the tree, picks up the first one, renders it through the same SSR
-     * pipeline as regular paths (so styler CSS / @pyreon/head metadata land
-     * correctly), and writes the result to `dist/404.html`. Static hosts
-     * (Netlify, Cloudflare Pages, GitHub Pages, S3+CloudFront) serve this
-     * file automatically for unmatched URLs. Default: `true`. Set to
-     * `false` to opt out — the route tree is left alone.
-     */
-    emit404?: boolean
-    /**
-     * When a route loader throws `redirect('/target')` during SSG, write
-     * a `dist/_redirects` file (Netlify / Cloudflare Pages convention)
-     * AND a `dist/_redirects.json` (Vercel convention) listing every
-     * redirected source path → target. Static hosts pick whichever
-     * format their platform supports automatically. The redirected
-     * path's HTML file is NOT emitted — the redirect is the response.
-     *
-     * Without this option, redirect-throwing loaders land in
-     * `errors[]` and the path silently disappears from the build —
-     * the user sees no output for `/old` AND no warning that the
-     * loader ran a redirect. Default: `true`. Set to `false` to
-     * restore the pre-PR-B behaviour (redirects treated as errors).
-     */
-    emitRedirects?: boolean
-    /**
-     * Additionally emit a static HTML file at the source path with a
-     * `<meta http-equiv="refresh">` redirect — for adapters / hosts
-     * that don't read `_redirects` (plain S3, GitHub Pages, simple
-     * file servers). The meta-refresh fallback works on any HTTP
-     * server that serves static files.
-     *
-     * - `'none'` (default): only `_redirects` / `_redirects.json` are
-     *   emitted; no per-redirect HTML file.
-     * - `'meta-refresh'`: emit `dist/<source>/index.html` containing
-     *   `<meta http-equiv="refresh" content="0; url=<target>">` plus
-     *   a canonical link tag for SEO. Status code information is
-     *   lost (meta-refresh has no status equivalent), so 301/302/307/
-     *   308 all collapse to "client-side refresh".
-     */
-    redirectsAsHtml?: 'none' | 'meta-refresh'
-    /**
-     * Callback invoked when a path's render throws (loader-throw that
-     * isn't a `redirect()`, render exception, anything that lands in the
-     * `errors[]` collection). Returns either:
-     * - `string` → written as the path's HTML in place of the failed
-     *   render. Use this to emit a per-path fallback page (e.g. a generic
-     *   "this content is temporarily unavailable" template) so static
-     *   hosts have something to serve at that URL instead of 404'ing.
-     * - `null` → skip; the path produces no HTML output. The error
-     *   stays in `errors[]` for the post-build summary.
-     *
-     * The callback runs ONCE per failed path. Async callbacks are
-     * awaited. If the callback itself throws, the throw is captured as
-     * a separate error entry and the path is skipped (no fallback HTML).
-     * Default: `undefined` — failed paths just land in `errors[]`.
-     *
-     * @example
-     * ssg: {
-     *   onPathError: async (path, error) => {
-     *     console.error(\`SSG render failed for \${path}:\`, error)
-     *     return \`<!DOCTYPE html><html><body><h1>Page unavailable</h1></body></html>\`
-     *   },
-     * }
-     */
-    onPathError?: (
-      path: string,
-      error: unknown,
-    ) => string | null | Promise<string | null>
-    /**
-     * When `'json'` (default), write `dist/_pyreon-ssg-errors.json` after
-     * the render loop summarising every error encountered (path traversal,
-     * timeout, render exception, getStaticPaths throw, fallback callback
-     * throw). Each entry has `{ path, message, name, stack }`. The file
-     * is ONLY written when `errors.length > 0` — successful builds don't
-     * leak an empty manifest. Reading it lets CI gate on render failures
-     * without parsing console output (e.g.
-     * `cat dist/_pyreon-ssg-errors.json | jq '.errors | length' | grep -q 0`).
-     *
-     * Set to `'none'` to opt out entirely — errors stay in console-only,
-     * matching pre-PR-G behaviour.
-     */
-    errorArtifact?: 'json' | 'none'
-    /**
-     * Maximum number of paths rendered in parallel during the SSG closeBundle
-     * loop. Default: `4` — a sensible balance between speedup and the risk
-     * of exhausting downstream resources (DB connection pools, fetch
-     * rate-limits) inside loaders. Set to `1` to render fully sequentially
-     * (the pre-PR-D behaviour). Set to a higher value for faster builds
-     * on CI / multi-core hosts; the practical ceiling is the number of
-     * loader-side concurrent connections your app's data layer tolerates.
-     *
-     * The render-error pipeline (`onPathError` callback, `errors[]`
-     * collection, `_pyreon-ssg-errors.json` artifact) is unchanged —
-     * concurrency only affects how many paths are in flight at once,
-     * not how their successes / failures are recorded.
-     *
-     * @example
-     * ssg: {
-     *   concurrency: 8, // Faster builds for static-content sites
-     * }
-     */
-    concurrency?: number
-    /**
-     * Per-path progress callback. Invoked once per path AFTER its render
-     * settles (success, redirect, OR failure) — never during in-flight
-     * renders. Receives `{ completed, total, currentPath, elapsed }`
-     * where:
-     *   - `completed` is the count of paths whose render has settled (1-indexed)
-     *   - `total` is the full path count from `resolvePaths()`
-     *   - `currentPath` is the path that just settled
-     *   - `elapsed` is wall-clock ms since the loop started
-     *
-     * Use cases: build-tool progress bars (Vite picks up stdout), CI
-     * heartbeat lines on long builds (10k-path sites take minutes —
-     * silent stretches look hung), build-time perf instrumentation.
-     *
-     * Async callbacks are awaited before the next path's progress fires,
-     * so a slow callback can serialize progress reporting (it does NOT
-     * gate the worker pool — paths keep rendering in parallel; only
-     * the progress callbacks themselves are serialized). Throws are
-     * captured into `errors[]` with the path suffix `(onProgress)` so
-     * a buggy callback can't take down the build.
-     *
-     * @example
-     * ssg: {
-     *   onProgress: ({ completed, total, currentPath, elapsed }) => {
-     *     console.log(`[${completed}/${total}] ${currentPath} (${elapsed}ms)`)
-     *   },
-     * }
-     */
-    onProgress?: (info: {
-      completed: number
-      total: number
-      currentPath: string
-      elapsed: number
-    }) => void | Promise<void>
-    /**
-     * Route-level code splitting in SSG mode. Default `true`.
-     *
-     * When `true` (default), each route file becomes its own dynamic-import
-     * chunk via `lazy(() => import("..."))` — only the route the user
-     * lands on plus its dependencies ship in the initial bundle, the
-     * rest fetch on navigation. Matches the SSR/SPA-mode behaviour zero
-     * has always had; brings parity to SSG.
-     *
-     * When `false`, every route is bundled statically into the main
-     * client chunk (the pre-2026-Q3 SSG behaviour). Useful for tiny
-     * sites (2-5 pages) where the single-chunk-then-instant-nav trade
-     * is preferable — the chunk-fetch cost on navigation is gone, and
-     * the marginal bytes are negligible.
-     *
-     * Crossover point: ~5-8 routes. Below that, single-chunk is fine.
-     * Above that, lazy() shrinks the initial bundle by a meaningful
-     * amount (a 50-route docs site might drop from 200 KB to 80 KB on
-     * first paint).
-     *
-     * Underlying mechanism is the same 3-tier generator zero already
-     * uses for SSR/SPA mode (`fs-router.ts:generateRouteEntry`): lazy
-     * component + inlined metadata when possible, lazy + lazy-thunked
-     * function exports when not, namespace-import fallback for cases
-     * the literal-extractor can't reach.
-     *
-     * @example
-     * ssg: {
-     *   splitChunks: false, // bundle-everything for a 3-page marketing site
-     * }
-     */
-    splitChunks?: boolean
-  }
-
-  /** ISR config — only used when mode is "isr". */
-  isr?: ISRConfig
-
-  /**
-   * Deploy adapter. Default: `"node"`.
-   *
-   * Accepts either a built-in adapter name (string) OR a constructed
-   * `Adapter` instance (e.g. `vercelAdapter()`). The scaffolded templates
-   * emit the instance form (`adapter: vercelAdapter()`) by convention.
-   * `resolveAdapter` (see `adapters/index.ts`) accepts both shapes —
-   * strings go through a switch lookup, instances pass through
-   * unchanged.
-   */
-  adapter?: 'node' | 'bun' | 'static' | 'vercel' | 'cloudflare' | 'netlify' | Adapter
-
-  /** Base URL path. Default: "/" */
-  base?: string
-
-  /**
-   * i18n routing — locale-prefixed route variants generated at build time
-   * (PR H of the SSG roadmap). When set, every `FileRoute` is fanned into
-   * per-locale duplicates by `expandRoutesForLocales` from
-   * `@pyreon/zero`. Independent from the `i18nRouting()` Vite plugin
-   * (which only handles request-time locale detection); both can be used
-   * together. See `expandRoutesForLocales` JSDoc for strategy semantics.
-   */
-  i18n?: I18nRoutingConfig
-
-  /** App-level middleware applied to all routes. */
-  middleware?: Middleware[]
-
-  /** Server port for dev/preview. Default: 3000 */
-  port?: number
-}
-
-// ─── File-system route ───────────────────────────────────────────────────────
-
-/**
- * Which optional metadata exports a route file declares.
- * Detected at scan time by parsing the file source. The code generator
- * uses this to skip emitting `import * as mod` for routes that only
- * export `default`, eliminating the dual-import collision with `lazy()`
- * and silencing `IMPORT_IS_UNDEFINED` warnings from Rolldown.
- */
-export interface RouteFileExports {
-  /** Has `export const loader` or `export function loader` */
-  hasLoader: boolean
-  /** Has `export const guard` or `export function guard` */
-  hasGuard: boolean
-  /** Has `export const meta` */
-  hasMeta: boolean
-  /** Has `export const renderMode` */
-  hasRenderMode: boolean
-  /** Has `export const error` (custom per-route error component) */
-  hasError: boolean
-  /** Has `export const middleware` */
-  hasMiddleware: boolean
-  /**
-   * Has `export const loaderKey` or `export function loaderKey`. When present,
-   * the route generator wires it as the `loaderKey` field on the route record,
-   * which controls cache identity for `_loaderCache`. Useful for auth-gate
-   * loaders that should invalidate when the session cookie changes — read
-   * `document.cookie` (CSR) or `ctx.request.headers.get('cookie')` (SSR) and
-   * derive a key from session identity. Default cache key is `path + params`,
-   * which doesn't see cookie changes.
-   */
-  hasLoaderKey: boolean
-  /**
-   * Has `export const gcTime` (number, in ms). When present, the route generator
-   * inlines it on the route record. `gcTime: 0` disables caching entirely —
-   * the loader runs on every navigation. Useful for auth-gate loaders that
-   * must validate session on every navigation rather than serve stale data.
-   */
-  hasGcTime: boolean
-  /**
-   * Has `export function getStaticPaths` or `export const getStaticPaths`.
-   * Used at SSG build time to enumerate concrete values for dynamic routes
-   * (`/posts/[id].tsx` → `[/posts/1, /posts/2, …]`). The function returns
-   * `Array<{ params: Record<string, string> }>`. Mirrors Astro's per-route
-   * convention. Without it, dynamic routes are silently skipped during SSG
-   * auto-detect — the user must hand-list every value in `ssg.paths`.
-   */
-  hasGetStaticPaths: boolean
-  /**
-   * Has `export const revalidate` (number, in seconds, or `false` for
-   * never-revalidate). PR I — build-time ISR. The SSG plugin emits a
-   * `dist/_pyreon-revalidate.json` manifest mapping `{ path: revalidate }`
-   * which the deploy adapter (Vercel / Cloudflare / Netlify) consumes
-   * to wire platform-specific ISR rebuild-on-stale. The route generator
-   * does NOT inline `revalidate` onto the route record — it's a
-   * build-time-only concern that never reaches the runtime router.
-   */
-  hasRevalidate: boolean
-  /**
-   * Raw text of the `export const meta = …` initializer, captured as a
-   * literal expression. When present, the route generator inlines this
-   * value directly into the generated routes module instead of importing
-   * it from the route file — which means the route file can be lazy()'d
-   * without forcing the entire dependency tree into the main bundle.
-   *
-   * Only set when the meta export is a top-level `export const meta = { … }`
-   * literal that can be extracted via balanced-brace scanning. Anything
-   * fancier (computed values, function calls, references to other
-   * declarations) leaves this undefined and falls back to a static module
-   * import.
-   */
-  metaLiteral?: string
-  /**
-   * Raw text of the `export const renderMode = …` initializer, captured
-   * as a literal expression. Same inlining strategy as `metaLiteral`.
-   */
-  renderModeLiteral?: string
-  /**
-   * Raw text of the `export const revalidate = …` initializer (e.g.
-   * `'60'`, `'false'`, `'3600'`). Captured at scan time so the SSG
-   * plugin can read the value to emit the build-time ISR manifest
-   * WITHOUT loading the route module — which is critical because the
-   * manifest is emitted from the synthetic SSR build's outer plugin
-   * context, where evaluating route modules would re-trigger the
-   * recursive sub-build env-flag guard.
-   *
-   * Only set when the revalidate export is a top-level
-   * `export const revalidate = <numeric|boolean literal>` that passes
-   * `isPureLiteral`. Anything else (function calls, references to
-   * other declarations) leaves this undefined and the manifest falls
-   * back to omitting the entry.
-   */
-  revalidateLiteral?: string
-}
-
-/** Internal representation of a file-system route before conversion to RouteRecord. */
-export interface FileRoute {
-  /** File path relative to routes dir (e.g. "users/[id].tsx") */
-  filePath: string
-  /** Parsed URL path pattern (e.g. "/users/:id") */
-  urlPath: string
-  /** Directory path for grouping (e.g. "users" or "" for root) */
-  dirPath: string
-  /** Route segment depth for nesting. */
-  depth: number
-  /** Whether this is a layout file. */
-  isLayout: boolean
-  /** Whether this is an error boundary file. */
-  isError: boolean
-  /** Whether this is a loading fallback file. */
-  isLoading: boolean
-  /** Whether this is a not-found (404) file. */
-  isNotFound: boolean
-  /** Whether this is a catch-all route. */
-  isCatchAll: boolean
-  /** Resolved rendering mode. */
-  renderMode: RenderMode
-  /**
-   * Detected optional exports from the file source.
-   * When undefined, the generator treats the file as having no metadata
-   * exports and emits the optimal `lazy()` shape (one dynamic import,
-   * no static metadata wiring). When provided, the generator emits a
-   * single namespace import for files with metadata or `lazy()` for
-   * files with only a default export.
-   */
-  exports?: RouteFileExports
-}
-
-// ─── Route middleware ────────────────────────────────────────────────────
-
-/** Entry mapping a URL pattern to its route-level middleware. */
-export interface RouteMiddlewareEntry {
-  pattern: string
-  middleware: Middleware | Middleware[]
-}
-
-// ─── Adapter ─────────────────────────────────────────────────────────────────
-
-export interface Adapter {
-  name: string
-  /** Build the production server/output for this adapter. */
-  build(options: AdapterBuildOptions): Promise<void>
-  /**
-   * Revalidate a prerendered path on the deploy platform's ISR layer
-   * (PR I — build-time ISR). Called by user code (webhook handlers,
-   * cron jobs, CMS triggers, etc.) to trigger a rebuild-on-stale for
-   * the named path. Optional — adapters without platform ISR support
-   * (static, node, bun) implement a no-op. Returns `{ regenerated:
-   * boolean }` so user code can branch on whether the platform actually
-   * accepted the revalidation request.
-   *
-   * Distinct from runtime ISR (`mode: 'isr'`, on-demand LRU caching in
-   * `@pyreon/zero/server`'s `createISRHandler`). Build-time ISR is
-   * static prerender + platform-driven rebuild-on-stale; runtime ISR is
-   * SSR-cached-with-TTL. They can coexist.
-   *
-   * Per-route `revalidate` metadata flows from `export const revalidate
-   * = 60` in route files into a `dist/_pyreon-revalidate.json` manifest
-   * the adapter reads at deploy time. Adapters use that manifest to
-   * configure platform ISR (Vercel `output/config.json`, Cloudflare
-   * Cache API rules, Netlify revalidation headers).
-   */
-  revalidate?(path: string): Promise<AdapterRevalidateResult>
-}
-
-/**
- * Result of `Adapter.revalidate(path)`. `regenerated: false` means the
- * adapter does not support platform ISR (no-op fallback) OR the
- * platform rejected the request. Adapters that throw on platform-API
- * failure should let it propagate so user code can handle the rejection.
- */
-export interface AdapterRevalidateResult {
-  regenerated: boolean
-}
-
-/**
- * Inputs the build pipeline passes to an adapter's `build()` method.
- *
- * The `kind` field discriminates the two shapes. **SSR mode** (`'ssr'`)
- * carries `serverEntry` + `clientOutDir` so adapters can wrap the user's
- * server bundle as a serverless function. **SSG mode** (`'ssg'`) carries
- * only `outDir` (which IS the rendered dist/) — no serverEntry exists
- * because every page is already prerendered. SSG-mode adapters write
- * platform-specific routing config so the host knows the deploy is
- * fully-static (no function invocation per request).
- *
- * Pre-PR-J this was a single SSR-shaped struct; the SSG path had no way
- * to invoke `adapter.build()` because it couldn't supply `serverEntry`.
- * Adding `kind` (with TS-narrowing per branch) lets `ssgPlugin`
- * `closeBundle` call `adapter.build({ kind: 'ssg', outDir, config })`
- * cleanly, AND keeps the SSR-mode adapter implementations unchanged.
- */
-export type AdapterBuildOptions =
-  | {
-      kind: 'ssr'
-      /** Path to the built server entry. */
-      serverEntry: string
-      /** Path to the client build output. */
-      clientOutDir: string
-      /** Final output directory. */
-      outDir: string
-      config: ZeroConfig
-    }
-  | {
-      kind: 'ssg'
-      /**
-       * The rendered dist directory. For SSG, this directory IS the
-       * publishable output — adapters write platform-specific routing
-       * config alongside (e.g. `.vercel/output/config.json`,
-       * `_routes.json`, `netlify.toml`) but generally don't move files.
-       */
-      outDir: string
-      config: ZeroConfig
-    }

package/src/utils/use-intersection-observer.ts

@@ -1,36 +0,0 @@
-import { onMount, onUnmount } from '@pyreon/core'
-
-/**
- * Observes an element and calls `onIntersect` once it enters the viewport.
- * Automatically disconnects after the first intersection.
- *
- * @param getElement - Getter for the target element (may be undefined before mount).
- * @param onIntersect - Callback fired when the element becomes visible.
- * @param rootMargin - IntersectionObserver rootMargin. Default: "200px".
- */
-export function useIntersectionObserver(
-  getElement: () => HTMLElement | undefined,
-  onIntersect: () => void,
-  rootMargin = '200px',
-) {
-  onMount(() => {
-    const el = getElement()
-    if (!el) return undefined
-
-    const observer = new IntersectionObserver(
-      (entries) => {
-        for (const entry of entries) {
-          if (entry.isIntersecting) {
-            onIntersect()
-            observer.disconnect()
-          }
-        }
-      },
-      { rootMargin },
-    )
-
-    observer.observe(el)
-    onUnmount(() => observer.disconnect())
-    return undefined
-  })
-}

package/src/utils/with-headers.ts

@@ -1,13 +0,0 @@
-/**
- * Clone a Response with modified headers.
- * Avoids repeating the `new Response(body, { status, statusText, headers })` pattern.
- */
-export function withHeaders(response: Response, modify: (headers: Headers) => void): Response {
-  const headers = new Headers(response.headers)
-  modify(headers)
-  return new Response(response.body, {
-    status: response.status,
-    statusText: response.statusText,
-    headers,
-  })
-}