@nifrajs/web 2.10.0 → 2.12.0

package/dist/index.d.ts

@@ -7,19 +7,20 @@
  * the adapter interprets them. That keeps this package both framework-agnostic and free
  * of DOM types: it is pure server orchestration + string building.
  */
-import { server } from "@nifrajs/core/server";
+import { type ServerOptions, server } from "@nifrajs/core/server";
 import { type Deferred, defer } from "./deferred.js";
-import type { LinkDescriptor, Manifest, Meta, MetaArgs, MetaDescriptor, MetaInput, ScriptDescriptor, UnsafeScriptDescriptor } from "./manifest.js";
-import { type Submission } from "./router.js";
+import { mergeHeads, resolveMeta } from "./internal/head-merge.js";
+import type { LinkDescriptor, Manifest, Meta, MetaDescriptor, ScriptDescriptor, UnsafeScriptDescriptor } from "./manifest.js";
+import type { RenderAdapter } from "./render-seam.js";
 export { DRAFT_COOKIE, type DraftCookieControls, disableDraft, type EnableDraftOptions, enableDraft, isDraftEnabled, type PreviewEndpointOptions, previewEndpoint, } from "./draft.js";
 export { type FontDisplay, type FontFace, type FontPreloadInput, type FontSource, fontFace, fontPreload, } from "./fonts.js";
 export { type CachedResponse, type CacheStore, ISR_REVALIDATE_HEADER, ISR_REVALIDATE_TAGS_HEADER, ISR_STATUS_HEADER, type ISRApp, type ISROptions, type ISRPlatform, KVCacheStore, type KVCacheStoreOptions, type KVNamespaceLike, MemoryCacheStore, type MemoryCacheStoreOptions, type RevalidateEndpointOptions, revalidateEndpoint, withISR, } from "./isr.js";
-export { type Action, buildManifest, enumerateStaticRoutes, filePathToPattern, filePathToPatterns, type GetStaticPaths, type InertScriptType, type LayoutEntry, type LinkDescriptor, type Loader, type LoaderContext, type Manifest, type Meta, type MetaArgs, type MetaInput, type RouteEntry, type RouteModule, type ScriptDescriptor, type StaticPath, type StaticPaths, type StaticRoutes, type UnsafeScriptDescriptor, } from "./manifest.js";
+export { type Action, buildManifest, enumerateStaticRoutes, filePathToPattern, filePathToPatterns, type GetStaticPaths, type InertScriptType, type LayoutEntry, type LinkDescriptor, type Loader, type LoaderContext, type Manifest, type Meta, type MetaArgs, type MetaDescriptor, type MetaInput, type RouteEntry, type RouteModule, type ScriptDescriptor, type StaticPath, type StaticPaths, type StaticRoutes, type UnsafeScriptDescriptor, } from "./manifest.js";
 export { type Blocker, type BlockerController, type BlockerFunction, type BlockerLocation, type BlockerState, type BrowserNavigate, getBrowserNavigate, IDLE_BLOCKER, type NavigateFunction, type NavigateOptions, type NavigateSearchOf, type NavigateTargetInput, type RouteSearch, registerBlocker, resolveNavigate, setBlockerController, setBrowserNavigate, } from "./navigation.js";
 export { type PublicDirCache, resolvePublicPath, type ServePublicDirOptions, servePublicDir, } from "./public-dir.js";
 export { createMutation, createQueryClient, type DehydratedState, hashQueryKey, type InfiniteData, type InfiniteQueryHandle, type InfiniteQueryOptions, type MutationCallbacks, type MutationHandle, type MutationState, type MutationStatus, type QueryClient, type QueryClientOptions, type QueryHandle, type QueryOptions, type QueryState, type QueryStatus, } from "./query.js";
 export { type ClientRouter, type ClientRouterOptions, createClientRouter, createMatcher, DATA_HEADER, type Fetcher, type FetcherState, type FetchRouteData, type MountRouterOptions, NAV_FROM_HEADER, REDIRECT_HEADER, RETAIN_HEADER, REVALIDATE_HEADER, type RouteMatch, type RoutePattern, type RouterState, STATUS_HEADER, type Submission, type SubmitOptions, } from "./router.js";
-export { type Deferred, defer };
+export { type Deferred, defer, mergeHeads, resolveMeta };
 /** Phantom brand key for {@link ServerOnly}. A unique symbol so the brand can't be forged by a plain
  * object literal; `unique symbol` keys never appear in the emitted JS, so the brand is purely
  * type-level (zero runtime cost). The property is optional + `never`-typed, so a `ServerOnly<T>`
@@ -50,97 +51,8 @@ export type ServerOnly<T> = T & {
     readonly [SERVER_ONLY_BRAND]?: never;
 };
 export { assertRenderAdapterConformance, RenderAdapterConformanceError, type RenderAdapterConformanceFixture, } from "./conformance.js";
+export { ACTION_GLOBAL, DATA_GLOBAL, LAYOUT_DATA_GLOBAL, type RenderAdapter, type RenderProps, ROOT_ATTRIBUTE, ROUTE_GLOBAL, type SsrModuleLoader, setSsrModuleLoader, ssrModuleLoader, } from "./render-seam.js";
 export { type SearchOf, searchOf, searchOfChain, serializeSearch } from "./search.js";
-/** The data handed to a route component. Opaque to the core. `actionData` is the return of a
- * route `action` after a POST (absent on plain GETs). `pending` + `submission` are client-only
- * (absent on SSR): they drive **optimistic UI** - render from `submission.formData` while `pending`. */
-export interface RenderProps {
-    readonly data: unknown;
-    /**
-     * Per-layout loader data, aligned index-for-index with the layout prefix of `chain`.
-     *
-     * Absent when no layout in the chain exports a `loader`, so a page-only app is byte-identical to
-     * before. An adapter that does not read it renders exactly as it did; one that does passes
-     * `layoutData[i]` to `chain[i]`.
-     */
-    readonly layoutData?: readonly unknown[];
-    readonly actionData?: unknown;
-    /** True while a client navigation or submit is in flight (client-only; absent/false on SSR). */
-    readonly pending?: boolean;
-    /** The path a client navigation is transitioning TO while `pending` (client-only; absent on SSR and
-     * when idle). Lets an adapter tell a `NavLink` whether its own target is the one loading. */
-    readonly pendingPath?: string;
-    /** The in-flight client submit, for optimistic UI (client-only; absent on SSR + when idle). */
-    readonly submission?: Submission;
-    /** The matched route's decoded path params (`/users/:id` → `{ id: "7" }`). Threaded identically on
-     * SSR (from the request match) and on client navigation (from router state) so an adapter's
-     * `useParams` reads the same value on both, with no hydration mismatch. Absent ⇒ no params (`{}`). */
-    readonly params?: Readonly<Record<string, string>>;
-    /** The current URL's `pathname + search` (no hash - the hash never reaches the server). Threaded on
-     * SSR and client alike so an adapter's `useLocation`/`useSearchParams` hydrate consistently. Absent
-     * on adapters/callers that don't supply it (treated as `""`). */
-    readonly path?: string;
-    /** The route's typed, validated search params (the value the loader also gets as `ctx.search`),
-     * threaded to the adapter's `useSearch`. Derived identically on SSR (from the request) and on client
-     * navigation (adapter mount) via the shared `searchOf`, so a component reading it hydrates with no
-     * drift. Absent ⇒ no search context (`{}`). */
-    readonly search?: Record<string, unknown>;
-}
-/**
- * The seam every render adapter implements. New adapters should prove these invariants with
- * {@link assertRenderAdapterConformance}; framework-specific behavior remains locally tested.
- */
-export interface RenderAdapter {
-    /**
-     * Server: render a route's layout `chain` (outermost layout → page) to a **stream** of HTML
-     * bytes, including the framework's hydration markers. The page (innermost) receives `props`
-     * (the loader data); each layout wraps the child via its `children`. Returns (or resolves to)
-     * a Web `ReadableStream<Uint8Array>`: a streaming renderer flushes the shell first and streams
-     * Suspense boundaries as they resolve; a non-streaming renderer may return a one-chunk stream.
-     * May be async - e.g. React resolves once the shell is renderable, so a shell-render throw can
-     * still map to an error status before any byte is sent.
-     */
-    renderToStream(chain: readonly unknown[], props: RenderProps): ReadableStream<Uint8Array> | Promise<ReadableStream<Uint8Array>>;
-    /**
-     * Server (optional): render the chain to a complete HTML **string** in one pass, with the same
-     * hydration markers `renderToStream` produces. When provided, `renderPage` uses it for any page
-     * that does **not** `defer()` - buffering the document is faster than the streaming pipeline there,
-     * because the framework's synchronous renderer (React `renderToString`, Solid `renderToString`,
-     * Preact `render`, Vue `renderToString`, Svelte `render`) is markedly cheaper than its streaming
-     * renderer - most visibly on Bun, where React Fizz / Solid `renderToStream` are the heaviest. Pages
-     * that `defer()` keep the streaming path (progressive `<Await>` needs it). Markup MUST be
-     * hydration-equivalent to `renderToStream`; a throw surfaces like the streaming shell-readiness
-     * await (the `_error` boundary maps it to a status). Omit it to always stream.
-     */
-    renderToString?(chain: readonly unknown[], props: RenderProps): string | Promise<string>;
-    /**
-     * Server: per-document bootstrap markup injected into `<head>` that the client
-     * `hydrate` requires (Solid: `generateHydrationScript()`). Empty string if none.
-     */
-    hydrationHead(nonce?: string): string;
-}
-/** Global the server serializes loader data into; the client reads it to hydrate. */
-export declare const DATA_GLOBAL = "__NIFRA_DATA__";
-/** Per-layout loader data for hydration. Emitted ONLY when some layout in the chain has a loader, so
- * a page-only app's HTML is byte-identical to before layout loaders existed. */
-export declare const LAYOUT_DATA_GLOBAL = "__NIFRA_LAYOUT_DATA__";
-/** Global the server writes the matched route id into; the client uses it to pick the chain. */
-export declare const ROUTE_GLOBAL = "__NIFRA_ROUTE__";
-/** Global the server serializes an action's data return into (absent on GETs); the client
- * reads it so hydration after a native form POST matches the server-rendered markup. */
-export declare const ACTION_GLOBAL = "__NIFRA_ACTION__";
-/**
- * Marker attribute on the app container, emitted ONLY when `rootId` is not the default.
- *
- * `rootId` is a per-RENDER option; the client entry is a per-BUILD artifact, so it cannot be
- * generated knowing which id a given render will use. The container therefore announces itself, and
- * the entry finds it by this attribute before falling back to `#root`. It has to be the DOM rather
- * than another `window.__NIFRA_*` global: a second copy of the id can drift from the markup, while
- * this is written by the same expression that writes the id and cannot.
- *
- * Absent on a default render, so an app that never sets `rootId` emits the same bytes it always has.
- */
-export declare const ROOT_ATTRIBUTE = "data-nifra-root";
 /**
  * Pre-hydration form guard - a tiny inline script flushed in `<head>` (it runs in the window between
  * first paint and the island bundle taking over). It neutralizes the one real hydration footgun: a
@@ -406,8 +318,6 @@ export declare function revalidate<T>(paths: readonly string[], data: T): Revali
  * separators.
  */
 export declare function serializeData(data: unknown): string;
-/** Resolve a route's `meta` (static or a function of the loader data + params) to a {@link Meta}. */
-export declare function resolveMeta(meta: MetaInput | undefined, args: MetaArgs): Meta;
 /**
  * A `<link rel="canonical">` descriptor for a route's `meta.link`. The canonical URL tells search
  * engines which URL is authoritative for a page (deduping query-string / tracking variants).
@@ -458,33 +368,67 @@ export declare function unsafeInlineScript(content: string, options: {
     readonly nonce: string;
     readonly type?: "module" | "text/javascript";
 }): UnsafeScriptDescriptor;
-/**
- * Merge a route's `<head>` contributions from its layout chain + the page into one {@link Meta}.
- *
- * The head contract (see {@link CreateWebAppOptions} and `LayoutEntry`): a `_layout.tsx` may export
- * `meta` to put sitewide tags (`hreflang`, `preconnect`, a default `<title>`, …) on every page below
- * it. `heads` is passed **outermost layout → … → innermost layout → page** (the same order as the
- * render chain), and merges:
- *  - **`title`** - *nearest-wins*: the last defined value across the list, so the page overrides an
- *    inner layout, which overrides an outer one. A layout `title` is the section default; an undefined
- *    page `title` keeps it.
- *  - **`meta` / `link`** - *concatenated* in list order (outermost first, page last). Duplicate-tag
- *    de-duplication is the caller's concern; the framework emits exactly what's declared so a layout
- *    can ship N `<link rel="alternate" hreflang>` tags and a page can add its own canonical.
- *
- * Returns a fresh object whose identity is stable per `heads` *content* only when every entry is a
- * static (by-reference) `Meta` and there is exactly one - otherwise a new object each call. That is
- * fine: {@link headTags}'s memo is keyed on identity, so a per-request merge simply recomputes (its
- * content can vary with loader data anyway).
- */
-export declare function mergeHeads(heads: readonly Meta[]): Meta;
-export interface CreateWebAppOptions {
+export interface CreateWebAppOptions<Env = unknown> {
     readonly adapter: RenderAdapter;
     readonly manifest: Manifest;
     /** URL of the built client entry (module script) injected into every page. */
     readonly clientEntry: string;
     /** Default document title for all pages. */
     readonly title?: string;
+    /**
+     * Options for the underlying `server()` - `requestTimeoutMs`, `admission`, `gracefulSignals`, and
+     * the rest of {@link ServerOptions}.
+     *
+     * Needed because the `Server` is constructed in here, so a caller has no other way to reach its
+     * constructor: a page app could set no request timeout and no capacity gate, which are exactly the
+     * two knobs a production readiness check looks for. An SSR app wants them MORE than a backend does -
+     * a render is slow and allocation-heavy, so a burst that a JSON API would absorb is the one that
+     * exhausts the pod.
+     *
+     * Applies to the whole app, {@link mounts} and the {@link api} auto-mount included: the capacity gate
+     * sits at the fetch entry, ahead of the request hooks those are dispatched from.
+     */
+    readonly server?: ServerOptions;
+    /**
+     * Runs against the app BEFORE any page route is registered - the seam for `securityHeaders()`,
+     * `requestId()`, `logger()`, a rate limit, or anything else applied with `use`.
+     *
+     * ```ts
+     * createWebApp({
+     *   …,
+     *   use: (app) => {
+     *     app.use(securityHeaders())
+     *     app.use(requestId())
+     *   },
+     * })
+     * ```
+     *
+     * A callback rather than an array because `use` is overloaded - `Middleware`, `IdentityPlugin`,
+     * `ContextPlugin` - and only the real call site instantiates the right overload. The return value
+     * is ignored: this is for cross-cutting concerns, not for declaring routes (declare those on the
+     * returned app, where they get their types).
+     *
+     * **Why the timing matters.** `beforeHandle`, `afterHandle`, `around`, `derive`/`decorate`, and
+     * `onError` are snapshotted into each route AS IT IS DECLARED, and `createWebApp` declares every
+     * page (plus the `/*` catch-all) before it returns - so a caller's `app.use(…)` afterwards binds
+     * them to nothing, silently. `requestId()` is exactly that case: it is a `derive`, so applied late
+     * it leaves every page without `c.requestId`. Route assurance evidence is order-scoped the same
+     * way, so a late `securityHeaders()` leaves the pages unable to PROVE the header to `nifra assure`
+     * even though it does still set it.
+     *
+     * `onRequest`/`onResponse` (and the response header/body hooks) are app-global arrays read at
+     * request time, so those alone DO work when added late. Using this seam for everything avoids
+     * having to remember which is which.
+     *
+     * Runs ahead of the {@link mounts} / {@link api} request hooks, so an `onRequest` middleware guards
+     * a mounted auth handler too.
+     *
+     * A `ContextPlugin` applied here takes runtime effect but cannot widen the declared return type of
+     * this function, so `c.requestId` is not typed on routes you declare afterwards. Named plugins are
+     * idempotent, so `app.use(requestId())` on the returned app recovers the TYPE without applying the
+     * plugin a second time.
+     */
+    readonly use?: (app: ReturnType<typeof server<Env>>) => void;
     /** Injected into each loader's `ctx.api` - typically an `inProcessClient(app)` (typed
      * per-route via `@nifrajs/client`'s `createRoutes`). Opaque to the core.
      *
@@ -551,6 +495,11 @@ export interface CreateWebAppOptions {
      * `prerendered.json`). Injected as `window.__NIFRA_PRERENDERED__` on every page so a client soft-nav
      * into a prerendered route fetches its static `_data.json` instead of hitting the worker. */
     readonly prerenderedPaths?: readonly string[];
+    /** Publish the project's `AGENTS.md` inside `/llms.txt` and `/llms-full.txt`. **Off by default**:
+     * those endpoints are public and unauthenticated, while `AGENTS.md` is a repo file written for the
+     * team - unreleased feature names, internal hostnames, and "don't touch X yet" notes live there
+     * routinely. Turn it on only for a repo whose guidelines you would publish as a page. */
+    readonly publishLocalGuidelines?: boolean;
     /** SSG: per dynamic route pattern, its `getStaticPaths` `fallback` (from `enumerateStaticRoutes` or
      * the build's `prerendered.json`). A route mapped to `"404"` rejects any path NOT in
      * `prerenderedPaths` with the 404 page - the unlisted path simply doesn't exist. `"ssr"` (the
@@ -582,7 +531,7 @@ export interface CreateWebAppOptions {
  * (same `Env`) so `ctx.env.MY_KV` is typed there too. Omit the parameter and `Env` is `unknown` - the
  * secure default; validate at the trust boundary before use.
  */
-export declare function createWebApp<Env = unknown>(options: CreateWebAppOptions): ReturnType<typeof server<Env>>;
+export declare function createWebApp<Env = unknown>(options: CreateWebAppOptions<Env>): ReturnType<typeof server<Env>>;
 export interface GenerateClientEntryOptions {
     /**
      * Module specifier for the adapter's client runtime, e.g. `"@nifrajs/web-solid/client"`.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -12,10 +12,15 @@ import { server, urlPartsOf } from "@nifrajs/core/server";
 import { DEFERRED_ERROR_CODE, DEFERRED_RUNTIME, defer, MAP_DEFERRED_SOURCE, ndjsonStream, prepareDeferred, } from "./deferred.js";
 import { isDraftEnabled } from "./draft.js";
 import { trustedHeadAttributes } from "./internal/head-attributes.js";
+// Head resolution/merging. Defined in an internal module so `@nifrajs/web/client` can export the same
+// two functions to the generated client entry without dragging THIS module (and its server code) into
+// the browser graph - see internal/head-merge.ts. Re-exported here so the public API is unchanged.
+import { mergeHeads, resolveMeta } from "./internal/head-merge.js";
 import { jsStringLiteral } from "./internal/js-string.js";
 import { EXECUTABLE_SCRIPT_TYPES, INERT_SCRIPT_TYPES } from "./internal/script-types.js";
 import { ISR_REVALIDATE_HEADER, ISR_REVALIDATE_TAGS_HEADER, serializeISRTags } from "./isr.js";
 import { generateLlmsTxt } from "./llms-txt.js";
+import { ACTION_GLOBAL, DATA_GLOBAL, LAYOUT_DATA_GLOBAL, ROOT_ATTRIBUTE, ROUTE_GLOBAL, } from "./render-seam.js";
 import { createMatcher, DATA_HEADER, NAV_FROM_HEADER, PRERENDERED_GLOBAL, REDIRECT_HEADER, RETAIN_HEADER, REVALIDATE_HEADER, STATUS_HEADER, } from "./router.js";
 import { searchOf, searchOfChain } from "./search.js";
 // Draft / preview mode - a signed cookie that flips `ctx.draft` for loaders + bypasses ISR for editors.
@@ -39,35 +44,14 @@ export { createMutation, createQueryClient, hashQueryKey, } from "./query.js";
 // `DATA_HEADER` marks a navigation's data-only GET; `createWebApp` answers it with loader JSON.
 export { createClientRouter, createMatcher, DATA_HEADER, NAV_FROM_HEADER, REDIRECT_HEADER, RETAIN_HEADER, REVALIDATE_HEADER, STATUS_HEADER, } from "./router.js";
 // Deferred loader data (`defer()` + the `Deferred<T>` type) - consumed by the adapter's `<Await>`.
-export { defer };
+export { defer, mergeHeads, resolveMeta };
 export { assertRenderAdapterConformance, RenderAdapterConformanceError, } from "./conformance.js";
+export { ACTION_GLOBAL, DATA_GLOBAL, LAYOUT_DATA_GLOBAL, ROOT_ATTRIBUTE, ROUTE_GLOBAL, setSsrModuleLoader, ssrModuleLoader, } from "./render-seam.js";
 // The search-derivation primitive: parse a URL query, validate it against a route's `searchSchema`
 // (fail-closed to defaults), or return the raw parsed query when there is none. Both the server (loader
 // ctx + `renderPage`) and a client adapter mount call this with the same URL + schema, so the two sides
 // produce the identical value by construction. An adapter's `useSearch` binding reads its result.
 export { searchOf, searchOfChain, serializeSearch } from "./search.js";
-/** Global the server serializes loader data into; the client reads it to hydrate. */
-export const DATA_GLOBAL = "__NIFRA_DATA__";
-/** Per-layout loader data for hydration. Emitted ONLY when some layout in the chain has a loader, so
- * a page-only app's HTML is byte-identical to before layout loaders existed. */
-export const LAYOUT_DATA_GLOBAL = "__NIFRA_LAYOUT_DATA__";
-/** Global the server writes the matched route id into; the client uses it to pick the chain. */
-export const ROUTE_GLOBAL = "__NIFRA_ROUTE__";
-/** Global the server serializes an action's data return into (absent on GETs); the client
- * reads it so hydration after a native form POST matches the server-rendered markup. */
-export const ACTION_GLOBAL = "__NIFRA_ACTION__";
-/**
- * Marker attribute on the app container, emitted ONLY when `rootId` is not the default.
- *
- * `rootId` is a per-RENDER option; the client entry is a per-BUILD artifact, so it cannot be
- * generated knowing which id a given render will use. The container therefore announces itself, and
- * the entry finds it by this attribute before falling back to `#root`. It has to be the DOM rather
- * than another `window.__NIFRA_*` global: a second copy of the id can drift from the markup, while
- * this is written by the same expression that writes the id and cannot.
- *
- * Absent on a default render, so an app that never sets `rootId` emits the same bytes it always has.
- */
-export const ROOT_ATTRIBUTE = "data-nifra-root";
 /**
  * Pre-hydration form guard - a tiny inline script flushed in `<head>` (it runs in the window between
  * first paint and the island bundle taking over). It neutralizes the one real hydration footgun: a
@@ -458,6 +442,19 @@ function withDuplicateInstanceHint(err) {
         augmented.stack = err.stack;
     return augmented;
 }
+/**
+ * An action's `Response` passes straight through - except a redirect on a client-submit data
+ * request: fetch would follow the 3xx into HTML the client can't use, so the redirect rides the
+ * X-Nifra-Redirect header on a 204 and the client navigates. One conversion shared by the
+ * returned- and thrown-Response paths, so `return redirect()` and `throw redirect()` agree.
+ */
+function actionResponse(response, isDataRequest) {
+    if (isDataRequest && response.status >= 300 && response.status < 400) {
+        const location = response.headers.get("location") ?? "/";
+        return new Response(null, { status: 204, headers: { [REDIRECT_HEADER]: location } });
+    }
+    return response;
+}
 /**
  * Narrow the route's params to the ones a layout owns.
  *
@@ -696,12 +693,6 @@ function headTags(head) {
     headTagsCache.set(head, out);
     return out;
 }
-/** Resolve a route's `meta` (static or a function of the loader data + params) to a {@link Meta}. */
-export function resolveMeta(meta, args) {
-    if (meta === undefined)
-        return {};
-    return typeof meta === "function" ? meta(args) : meta;
-}
 /**
  * A `<link rel="canonical">` descriptor for a route's `meta.link`. The canonical URL tells search
  * engines which URL is authoritative for a page (deduping query-string / tracking variants).
@@ -769,74 +760,6 @@ export function unsafeInlineScript(content, options) {
         content,
     };
 }
-/**
- * Merge a route's `<head>` contributions from its layout chain + the page into one {@link Meta}.
- *
- * The head contract (see {@link CreateWebAppOptions} and `LayoutEntry`): a `_layout.tsx` may export
- * `meta` to put sitewide tags (`hreflang`, `preconnect`, a default `<title>`, …) on every page below
- * it. `heads` is passed **outermost layout → … → innermost layout → page** (the same order as the
- * render chain), and merges:
- *  - **`title`** - *nearest-wins*: the last defined value across the list, so the page overrides an
- *    inner layout, which overrides an outer one. A layout `title` is the section default; an undefined
- *    page `title` keeps it.
- *  - **`meta` / `link`** - *concatenated* in list order (outermost first, page last). Duplicate-tag
- *    de-duplication is the caller's concern; the framework emits exactly what's declared so a layout
- *    can ship N `<link rel="alternate" hreflang>` tags and a page can add its own canonical.
- *
- * Returns a fresh object whose identity is stable per `heads` *content* only when every entry is a
- * static (by-reference) `Meta` and there is exactly one - otherwise a new object each call. That is
- * fine: {@link headTags}'s memo is keyed on identity, so a per-request merge simply recomputes (its
- * content can vary with loader data anyway).
- */
-export function mergeHeads(heads) {
-    // Single-head fast path (a route with no layout `meta`, by far the common case) - return the
-    // resolved object by reference so headTags' identity-keyed memo hits across requests for static meta.
-    if (heads.length === 1)
-        return heads[0];
-    let title;
-    let lang;
-    let dir;
-    const meta = [];
-    const link = [];
-    const script = [];
-    const unsafeScript = [];
-    for (const h of heads) {
-        if (h.title !== undefined)
-            title = h.title; // nearest-wins: later (more specific) overrides
-        if (h.lang !== undefined)
-            lang = h.lang; // nearest-wins, like title
-        if (h.dir !== undefined)
-            dir = h.dir;
-        if (h.meta !== undefined)
-            meta.push(...h.meta);
-        if (h.link !== undefined)
-            link.push(...h.link);
-        if (h.script !== undefined)
-            script.push(...h.script); // concatenated like meta/link (outermost first)
-        if (h.unsafeScript !== undefined)
-            unsafeScript.push(...h.unsafeScript);
-    }
-    // Build the result with only the fields that were actually contributed - an empty `meta`/`link`/
-    // `script` array would otherwise be a spurious (if harmless) key. A mutable local; the cast to `Meta`
-    // is sound because a key is assigned only when defined (so `exactOptionalPropertyTypes` never sees
-    // `undefined`).
-    const merged = {};
-    if (title !== undefined)
-        merged.title = title;
-    if (meta.length > 0)
-        merged.meta = meta;
-    if (link.length > 0)
-        merged.link = link;
-    if (script.length > 0)
-        merged.script = script;
-    if (unsafeScript.length > 0)
-        merged.unsafeScript = unsafeScript;
-    if (lang !== undefined)
-        merged.lang = lang;
-    if (dir !== undefined)
-        merged.dir = dir;
-    return merged;
-}
 /**
  * Re-issue `request` with `prefix` removed from its pathname.
  *
@@ -920,7 +843,11 @@ export function createWebApp(options) {
     // Seed the context with the declared `Env` so `app.fetch(req, { env })` / `toFetchHandler(app)` type
     // the platform bindings (see the `createWebApp` doc). The runtime `env` still arrives per-request via
     // `app.fetch(req, { env })`; this is a compile-time-only seed (`server<Env>()` casts, doesn't store).
-    const app = server();
+    const app = server(options.server);
+    // Before the mount hooks and before every page route, so the order-scoped hooks (`derive`,
+    // `beforeHandle`, assurance evidence) actually bind to them - see the `use` option. A caller
+    // cannot do this after the fact: by the time this function returns, the routes are declared.
+    options.use?.(app);
     // Auto-mount the in-process backend over HTTP at `apiPrefix` (default `/api`), BEFORE page routing.
     // `onRequest` runs on the raw request ahead of the router, so this wins over the page wildcard `/*`
     // for every method (POST/GET/PUT/…) - not just the GET page routes - and a backend 404 (`/api/none`)
@@ -1403,6 +1330,15 @@ export function createWebApp(options) {
                 }
                 return renderError(route, errorId, withDuplicateInstanceHint(err));
             }
+            // A loader may RETURN its control-flow signal instead of throwing it - `return redirect(...)`
+            // reads naturally and must not silently serialize the `Response` as loader data. Mirror the
+            // catch above exactly: a status signal renders its boundary, any other `Response` (a
+            // redirect, a hand-rolled response) passes through to core verbatim - so return and throw
+            // are interchangeable.
+            if (isStatusSignal(data))
+                return renderStatusSignal(c.req, data);
+            if (data instanceof Response)
+                return data;
             // Client-side navigation asks (via the X-Nifra-Data header) for just the loader data - no full
             // document, no layout chain. A route with deferred data streams NDJSON (critical data first,
             // then each deferred value as it settles); otherwise one JSON (the fast path). Same loader,
@@ -1512,11 +1448,23 @@ export function createWebApp(options) {
                 draft,
                 search: loaderSearch(mod.searchSchema, c.req),
             };
-            // A gate is an authorization boundary for everything beneath its layout, mutations included.
-            // Run only gates before the action; ordinary layout data loaders run after a native mutation.
-            const layoutModules = await runLayoutGates(route, actionContext);
-            const result = await mod.action(actionContext);
             const isDataRequest = c.req.headers.get(DATA_HEADER) !== null;
+            let layoutModules;
+            let result;
+            try {
+                // A gate is an authorization boundary for everything beneath its layout, mutations included.
+                // Run only gates before the action; ordinary layout data loaders run after a native mutation.
+                layoutModules = await runLayoutGates(route, actionContext);
+                result = await mod.action(actionContext);
+            }
+            catch (err) {
+                // A THROWN Response is the same control-flow signal as a returned one (`throw redirect()`
+                // in a gate or an action) - route it through the same conversion as the returned-Response
+                // branch below, so throw and return are interchangeable on the mutation path too.
+                if (err instanceof Response)
+                    return actionResponse(err, isDataRequest);
+                throw err;
+            }
             // An action may wrap its data in `revalidate(paths, data)` to declare which routes it changed.
             // Unwrap to the inner data; the paths ride the `X-Nifra-Revalidate` header on the data-mode
             // responses (the client acts on them - a full-page POST re-runs loaders inline, so no header).
@@ -1525,15 +1473,8 @@ export function createWebApp(options) {
             const revalidateHeader = isRevalidate
                 ? { [REVALIDATE_HEADER]: result.__nifraRevalidate.join(",") }
                 : {};
-            if (actionResult instanceof Response) {
-                // Client submit can't read a 3xx Location (fetch follows it to HTML), so convey the
-                // redirect via a header on a 204 and let the client navigate. Native forms get the 3xx.
-                if (isDataRequest && actionResult.status >= 300 && actionResult.status < 400) {
-                    const location = actionResult.headers.get("location") ?? "/";
-                    return new Response(null, { status: 204, headers: { [REDIRECT_HEADER]: location } });
-                }
-                return actionResult;
-            }
+            if (actionResult instanceof Response)
+                return actionResponse(actionResult, isDataRequest);
             // Client submit wants just the action's data (it revalidates the loader itself); a native
             // form POST re-renders the full page (loader re-runs) with the action data.
             if (isDataRequest) {
@@ -1589,14 +1530,15 @@ export function createWebApp(options) {
         });
     }
     // Register llms.txt & llms-full.txt
+    const llmsOptions = { includeLocalGuidelines: options.publishLocalGuidelines === true };
     app.register("GET", "/llms.txt", undefined, async () => {
-        const text = await generateLlmsTxt(false, manifest.routes, api);
+        const text = await generateLlmsTxt(false, manifest.routes, api, llmsOptions);
         return new Response(text, {
             headers: { "content-type": "text/plain; charset=utf-8" },
         });
     });
     app.register("GET", "/llms-full.txt", undefined, async () => {
-        const text = await generateLlmsTxt(true, manifest.routes, api);
+        const text = await generateLlmsTxt(true, manifest.routes, api, llmsOptions);
         return new Response(text, {
             headers: { "content-type": "text/plain; charset=utf-8" },
         });
@@ -1654,12 +1596,24 @@ export function generateClientEntry(manifest, options) {
         statusRoutes[Number(status)] = routeId;
     }
     return `${[
-        'import { createClientRouter, createMatcher, mergeHeads, resolveMeta } from "@nifrajs/web"',
+        // `/client`, never the root: the root's graph carries the server (renderPage, the static-file
+        // server), and Vite's dev server evaluates what it is given instead of tree-shaking it.
+        'import { createClientRouter, createMatcher, mergeHeads, resolveMeta } from "@nifrajs/web/client"',
         'import { applyHead, installForms, installHistory, signalHydrated } from "@nifrajs/web/client"',
         // Namespace import: `errorBoundary` is optional (an adapter may not export it). A namespace member
         // access yields `undefined` if absent - unlike a named import, which would be a link error.
         `import * as __adapter from ${JSON.stringify(clientModule)}`,
         "const { mountRouter } = __adapter",
+        // The assurance hook is optional: ordinary client entries pay only for the namespace lookup, while
+        // hydration runners get a runtime identity from the exact adapter module that mounted the page. The
+        // registry is token-only and lives on a Symbol.for key so it cannot collide with app data.
+        "const __hydrationHook = __adapter.hydrationAssuranceHook",
+        'if (__hydrationHook && typeof __hydrationHook.runtimeIdentity === "function") {',
+        '  const __runtimeKey = Symbol.for("nifra.hydration.runtime")',
+        "  const __runtimeState = globalThis[__runtimeKey]",
+        "  const __identities = __runtimeState && Array.isArray(__runtimeState.identities) ? __runtimeState.identities : []",
+        "  globalThis[__runtimeKey] = { framework: __hydrationHook.framework, identities: [...__identities, __hydrationHook.runtimeIdentity()] }",
+        "}",
         // The `clientModule` contract is a string specifier, so nothing type-checks that the module it
         // names actually exports `mountRouter`. Without this the miss surfaces as
         // "mountRouter is not a function" from inside a bundled chunk, at first paint, naming neither the
@@ -1669,6 +1623,16 @@ export function generateClientEntry(manifest, options) {
             "the generated bootstrap, so a self-executing entry will not work. Use your adapter's " +
             '`/client` entry (e.g. "@nifrajs/web-react/client"), or re-export mountRouter from it.')})`,
         "const errorBoundary = __adapter.errorBoundary",
+        // A hot update that the framework cannot actually apply must end in a reload, not in nothing.
+        //
+        // Bun's dev server applies React Fast Refresh to JSX modules. For React that patches the component
+        // and preserves state. For Preact it does not - the module still LOOKS Fast-Refresh-able, so the
+        // update is accepted and then swallowed: `bun:beforeUpdate`/`bun:afterUpdate` both fire, the server
+        // logs a rebuild, and the page silently keeps rendering the old code. An edit that appears to do
+        // nothing is the worst failure mode in a dev loop - worse than a reload, because there is no signal
+        // to act on. An adapter that knows its framework is in that position says so, and the entry turns
+        // the swallowed update into an honest full reload.
+        'if (import.meta.hot && __adapter.hotUpdateNeedsReload) import.meta.hot.on("bun:afterUpdate", () => location.reload())',
         `const errorRouteIds = new Set(${JSON.stringify(errorRouteIds)})`,
         // Each route is a lazy loader: dynamic imports → Bun.build (splitting) emits one chunk per
         // route, shared layouts/deps deduped into shared chunks, so a route's code loads only when