@vesk/adapter 0.2.59 → 0.2.61

package/dist/default-pages.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Branded built-in fallback pages.
+ *
+ * These are the pages a Vesk app gets when it has NOT defined its own
+ * `app/not-found.vsk` / `app/error.vsk` (or when rendering one throws). They
+ * deliberately mirror the shape of Next.js' built-in 404/500 page — a large
+ * status code, a hairline divider, the message — but carry the Vesk design
+ * language (light-default monochrome that follows `prefers-color-scheme`, a
+ * single rust accent, sharp corners, Space Grotesk / JetBrains Mono with system
+ * fallbacks) instead of the generic `<h1>404</h1>` that shipped before.
+ *
+ * The module is intentionally dependency-free and side-effect-free: the HTML
+ * is a plain string, so it can be served by the Node prod server, the dev
+ * server, the generated platform (edge) handler, and inlined into generated
+ * error bodies — all from this one source of truth.
+ *
+ * Fonts are NOT fetched here: a fallback page must render instantly and
+ * without network access, so the stacks degrade to system fonts gracefully.
+ */
+export interface DefaultPageOptions {
+    /** HTTP status shown and set by the caller (404 / 500). */
+    status?: number;
+    /** Document `<title>`. */
+    title?: string;
+    /** Short label rendered next to the big status code. */
+    message?: string;
+    /** The requested path, shown as a muted detail line when present. */
+    url?: string;
+    /** Primary action target. Pass `null` to omit the button. */
+    homeHref?: string | null;
+    /** Primary action label. */
+    homeLabel?: string;
+    /** Extra markup for `<head>` (baked onHead-plugin snippets). */
+    headExtra?: string;
+    /** Paint the status code in the rust accent (used for 5xx). */
+    accentStatus?: boolean;
+}
+export declare function escapeDefaultPageHtml(value: unknown): string;
+/**
+ * Render a complete, self-contained HTML document for a built-in fallback page.
+ */
+export declare function renderDefaultPage(opts?: DefaultPageOptions): string;
+/** The built-in 404: matches Next.js' "This page could not be found." shape. */
+export declare function renderDefaultNotFoundPage(opts?: {
+    url?: string;
+    headExtra?: string;
+}): string;
+/** The built-in 500: never leaks a stack trace; message is opt-in (dev). */
+export declare function renderDefaultErrorPage(opts?: {
+    status?: number;
+    message?: string;
+    url?: string;
+    headExtra?: string;
+}): string;
+/**
+ * Compact, self-contained error panel for contexts where a full document is
+ * wrong — chiefly the generated `__renderErrorBody` fallback, which is injected
+ * as the page body *inside* the app's layout chain when `error.vsk` exists but
+ * throws mid-render. Inline styles only (no external class dependency) so it
+ * survives inside any user layout.
+ */
+export declare function renderDefaultErrorFragment(opts?: {
+    status?: number;
+    message?: string;
+}): string;
+//# sourceMappingURL=default-pages.d.ts.map

package/dist/default-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-pages.d.ts","sourceRoot":"","sources":["../src/default-pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,kBAAkB;IAClC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO5D;AAgDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,MAAM,CAgCvE;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAQjG;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAWjI;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CASnG"}

package/dist/default-pages.js

@@ -0,0 +1,146 @@
+/**
+ * Branded built-in fallback pages.
+ *
+ * These are the pages a Vesk app gets when it has NOT defined its own
+ * `app/not-found.vsk` / `app/error.vsk` (or when rendering one throws). They
+ * deliberately mirror the shape of Next.js' built-in 404/500 page — a large
+ * status code, a hairline divider, the message — but carry the Vesk design
+ * language (light-default monochrome that follows `prefers-color-scheme`, a
+ * single rust accent, sharp corners, Space Grotesk / JetBrains Mono with system
+ * fallbacks) instead of the generic `<h1>404</h1>` that shipped before.
+ *
+ * The module is intentionally dependency-free and side-effect-free: the HTML
+ * is a plain string, so it can be served by the Node prod server, the dev
+ * server, the generated platform (edge) handler, and inlined into generated
+ * error bodies — all from this one source of truth.
+ *
+ * Fonts are NOT fetched here: a fallback page must render instantly and
+ * without network access, so the stacks degrade to system fonts gracefully.
+ */
+export function escapeDefaultPageHtml(value) {
+    return String(value ?? '')
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * Theme tokens lifted from the vesk-doc `app/global.css` design system. Light is
+ * the default (matching the general web default); `prefers-color-scheme: dark`
+ * swaps to the inverted band so the page follows the visitor's theme. Kept
+ * inline so the page is fully self-contained.
+ */
+const DEFAULT_PAGE_CSS = [
+    ':root{color-scheme:light;',
+    '--vsk-bg:oklch(0.941 0.014 88);',
+    '--vsk-fg:oklch(0.185 0.008 62);',
+    '--vsk-surface:oklch(0.965 0.012 88);',
+    '--vsk-muted:oklch(0.475 0.014 72);',
+    '--vsk-accent:oklch(0.560 0.140 42);',
+    '--vsk-border:oklch(0.86 0.012 82);',
+    '--vsk-border-strong:oklch(0.72 0.014 80);',
+    '--vsk-font:"Space Grotesk",ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;',
+    '--vsk-mono:"JetBrains Mono",ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;}',
+    '@media (prefers-color-scheme:dark){:root{color-scheme:dark;',
+    '--vsk-bg:oklch(0.155 0.006 60);',
+    '--vsk-fg:oklch(0.931 0.014 88);',
+    '--vsk-surface:oklch(0.196 0.008 70);',
+    '--vsk-muted:oklch(0.618 0.016 80);',
+    '--vsk-accent:oklch(0.632 0.132 45);',
+    '--vsk-border:oklch(0.29 0.009 75);',
+    '--vsk-border-strong:oklch(0.40 0.011 75);}}',
+    '*{box-sizing:border-box}',
+    'html,body{margin:0;min-height:100%}',
+    'body{background:var(--vsk-bg);color:var(--vsk-fg);font-family:var(--vsk-font);-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}',
+    '.vsk-page{min-height:100vh;display:flex;align-items:center;justify-content:center;padding:24px}',
+    '.vsk-page__card{width:100%;max-width:540px;border:1px solid var(--vsk-border);background:var(--vsk-surface);padding:clamp(28px,6vw,44px);text-align:center}',
+    '@supports (background:color-mix(in oklab,red,red)){.vsk-page__card{background:color-mix(in oklab,var(--vsk-surface) 60%,transparent)}}',
+    '.vsk-page__brand{margin:0 0 26px;font-family:var(--vsk-mono);font-size:10px;line-height:1;letter-spacing:.24em;text-transform:uppercase;color:var(--vsk-muted)}',
+    '.vsk-page__brand b{color:var(--vsk-fg);font-weight:600}',
+    '.vsk-page__row{display:flex;align-items:center;justify-content:center;gap:0;flex-wrap:wrap}',
+    '.vsk-page__status{font-size:clamp(34px,9vw,46px);font-weight:600;line-height:1;letter-spacing:-.03em;padding-right:22px;margin-right:22px;border-right:1px solid var(--vsk-border-strong)}',
+    '.vsk-page--error .vsk-page__status{color:var(--vsk-accent)}',
+    '.vsk-page__msg{font-family:var(--vsk-mono);font-size:13px;line-height:1.5;color:var(--vsk-muted);text-align:left;max-width:270px}',
+    '@media (max-width:440px){.vsk-page__row{flex-direction:column}.vsk-page__status{padding:0 0 16px;margin:0 0 16px;border-right:0;border-bottom:1px solid var(--vsk-border-strong)}.vsk-page__msg{text-align:center}}',
+    '.vsk-page__detail{margin:20px 0 0;font-family:var(--vsk-mono);font-size:11px;line-height:1.6;color:var(--vsk-muted);word-break:break-all}',
+    '.vsk-page__actions{margin-top:30px;display:flex;justify-content:center;gap:10px;flex-wrap:wrap}',
+    '.vsk-page__btn{display:inline-block;padding:11px 22px;font-size:13px;font-weight:500;line-height:1;text-decoration:none;border:1px solid var(--vsk-fg);background:var(--vsk-fg);color:var(--vsk-bg);transition:opacity .18s cubic-bezier(.2,0,0,1)}',
+    '.vsk-page__btn:hover{opacity:.86}',
+    '.vsk-page__btn--ghost{background:transparent;color:var(--vsk-fg);border-color:var(--vsk-border-strong)}',
+    '.vsk-page__btn--ghost:hover{background:var(--vsk-fg);color:var(--vsk-bg);border-color:var(--vsk-fg);opacity:1}',
+].join('');
+/**
+ * Render a complete, self-contained HTML document for a built-in fallback page.
+ */
+export function renderDefaultPage(opts = {}) {
+    const status = opts.status ?? 404;
+    const title = escapeDefaultPageHtml(opts.title ?? `${status} — Vesk`);
+    const message = escapeDefaultPageHtml(opts.message ?? 'This page could not be found.');
+    const url = opts.url ? escapeDefaultPageHtml(opts.url) : '';
+    const headExtra = opts.headExtra || '';
+    const homeHref = opts.homeHref === undefined ? '/' : opts.homeHref;
+    const homeLabel = escapeDefaultPageHtml(opts.homeLabel ?? 'Back to home');
+    const variant = `vsk-page${opts.accentStatus ? ' vsk-page--error' : ''}`;
+    const action = homeHref === null
+        ? ''
+        : `<a class="vsk-page__btn" href="${escapeDefaultPageHtml(homeHref)}">${homeLabel}</a>`;
+    return '<!DOCTYPE html><html lang="en"><head><meta charset="utf-8">' +
+        '<meta name="viewport" content="width=device-width, initial-scale=1">' +
+        '<meta name="robots" content="noindex">' +
+        `<title>${title}</title>` +
+        `<style>${DEFAULT_PAGE_CSS}</style>` +
+        headExtra +
+        '</head><body>' +
+        `<main class="${variant}" data-vesk-default-page="${status}">` +
+        '<div class="vsk-page__card">' +
+        '<p class="vsk-page__brand"><b>Vesk</b> · built-in error page</p>' +
+        '<div class="vsk-page__row">' +
+        `<span class="vsk-page__status">${status}</span>` +
+        `<span class="vsk-page__msg">${message}</span>` +
+        '</div>' +
+        (url ? `<p class="vsk-page__detail">${url}</p>` : '') +
+        (action ? `<div class="vsk-page__actions">${action}</div>` : '') +
+        '</div></main>' +
+        '</body></html>';
+}
+/** The built-in 404: matches Next.js' "This page could not be found." shape. */
+export function renderDefaultNotFoundPage(opts = {}) {
+    return renderDefaultPage({
+        status: 404,
+        title: '404 — Not Found',
+        message: 'This page could not be found.',
+        url: opts.url,
+        headExtra: opts.headExtra,
+    });
+}
+/** The built-in 500: never leaks a stack trace; message is opt-in (dev). */
+export function renderDefaultErrorPage(opts = {}) {
+    const status = opts.status ?? 500;
+    return renderDefaultPage({
+        status,
+        title: `${status} — Internal Server Error`,
+        message: opts.message || 'Internal Server Error',
+        url: opts.url,
+        headExtra: opts.headExtra,
+        accentStatus: true,
+        homeHref: null,
+    });
+}
+/**
+ * Compact, self-contained error panel for contexts where a full document is
+ * wrong — chiefly the generated `__renderErrorBody` fallback, which is injected
+ * as the page body *inside* the app's layout chain when `error.vsk` exists but
+ * throws mid-render. Inline styles only (no external class dependency) so it
+ * survives inside any user layout.
+ */
+export function renderDefaultErrorFragment(opts = {}) {
+    const status = opts.status ?? 500;
+    const message = escapeDefaultPageHtml(opts.message || 'Internal Server Error');
+    return '<div data-vesk-default-error-fragment="' + status + '" style="display:flex;align-items:center;justify-content:center;min-height:60vh;padding:32px">' +
+        '<div style="display:flex;flex-direction:column;align-items:center;gap:10px;text-align:center;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace">' +
+        '<div style="display:flex;align-items:center">' +
+        '<span style="font-size:24px;font-weight:500;line-height:49px;padding-right:23px;margin-right:20px;border-right:1px solid currentColor;opacity:.85">' + status + '</span>' +
+        '<span style="font-size:14px;line-height:49px;opacity:.7">' + message + '</span>' +
+        '</div></div></div>';
+}

package/dist/dev-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAA6C,MAAM,WAAW,CAAC;AASjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAK7C,OAAO,KAAK,EAAa,gBAAgB,EAAwB,MAAM,yBAAyB,CAAC;AAgBjG;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB;+EAC2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD;AAuCD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AAkBD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mHAAmH;IACnH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B;;8BAE0B;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,WAAW,CAAC;IAChC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG;IACvE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAChH,CAUA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AA8CD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwqBvG"}
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAA6C,MAAM,WAAW,CAAC;AASjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAM7C,OAAO,KAAK,EAAa,gBAAgB,EAAwB,MAAM,yBAAyB,CAAC;AAgBjG;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB;+EAC2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD;AAuCD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AAkBD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mHAAmH;IACnH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B;;8BAE0B;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,WAAW,CAAC;IAChC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG;IACvE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAChH,CAUA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AA8CD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAorBvG"}

package/dist/dev-server.js

@@ -11,6 +11,7 @@ import { buildErrorPayload, createHmrServer } from './hmr';
 import * as hmrApi from './hmr';
 import { createDevApiRouter } from './dev-api';
 import { resolveRuntimeErrorPayload, renderDevErrorPage } from './ssr-error';
+import { renderDefaultNotFoundPage, renderDefaultErrorPage } from '@vesk/adapter/src/default-pages';
 import { buildTreeShakenRuntime, runtimeExportNames } from '@vesk/adapter/src/client-bundle';
 import { resolveWithin, installMdReadHook } from '@vesk/adapter/src/paths';
 import { getPluginRecords } from './plugins';
@@ -381,7 +382,7 @@ export async function startDevServer(appDir, options) {
             return injectDevScripts(renderDevErrorPage(payload, { status: 500, url: pathname }));
         }
         catch {
-            return '<!DOCTYPE html><html><body><h1>500</h1><pre>Internal Server Error</pre></body></html>';
+            return injectDevScripts(renderDefaultErrorPage({ message: e instanceof Error ? e.message : undefined, url: pathname }));
         }
     }
     let eventsMod = null;
@@ -567,6 +568,18 @@ export async function startDevServer(appDir, options) {
             res.end(lines.join('\n') || '// no ssr data');
             return;
         }
+        // Persisted-store pre-paint payload — same token-stash/consume contract as
+        // /ssr-data.js above so the dev SPA fallback never serves HTML as JS.
+        if (url.pathname === '/store-init.js') {
+            const token = url.searchParams.get('t') || '';
+            const store = globalThis.__vsk_store_init_payload_store;
+            const payload = store?.[token];
+            if (payload)
+                delete store[token];
+            res.writeHead(200, { 'Content-Type': 'application/javascript', 'Cache-Control': 'no-store' });
+            res.end(payload ?? '// no store init');
+            return;
+        }
         if (url.pathname.startsWith('/_vesk/static/')) {
             const relPath = url.pathname.slice('/_vesk/static/'.length);
             const staticPath = resolveWithin(resolve(devDir, 'static'), relPath);
@@ -740,7 +753,7 @@ export async function startDevServer(appDir, options) {
             }
         }
         res.writeHead(404, { 'Content-Type': 'text/html' });
-        res.end('<!DOCTYPE html><html><body><h1>404</h1><p>Not Found</p></body></html>');
+        res.end(injectDevScripts(renderDefaultNotFoundPage({ url: url.pathname })));
     });
     const hmr = createHmrServer(server, appDir, devDir, componentMap);
     hmrSession = hmr;

package/dist/hmr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAUxC,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEvG,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AAIzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAaD,wBAAgB,WAAW,IAAI;IAC7B,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAQA;AAED,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,wBAA6B,GAClC,eAAe,CAsGjB;AAoSD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvH,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CACnD,CA6KA"}
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAWxC,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEvG,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AAIzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAaD,wBAAgB,WAAW,IAAI;IAC7B,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAQA;AAED,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,wBAA6B,GAClC,eAAe,CAsGjB;AAqTD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvH,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CACnD,CA6KA"}

package/dist/hmr.js

@@ -5,8 +5,9 @@ import { fileURLToPath } from 'node:url';
 import { compileClient } from '@vesk/compiler/src/client-codegen';
 import { buildHmrEvalSnippet } from './client-bundle';
 import { resolveComponentName, randomToken } from '@vesk/compiler/src/server-codegen';
-import { resolveErrorFile } from '@vesk/adapter/src/ssr-function';
+import { resolveErrorFile, persistedStoreSsrCode } from '@vesk/adapter/src/ssr-function';
 import { resolveCssUrls, hasBuiltGlobalCss } from '@vesk/adapter/src/css';
+import { renderDefaultErrorFragment } from '@vesk/adapter/src/default-pages';
 import { isAllowedWsUpgrade } from '@vesk/adapter/src/paths';
 import { parseCompilerError, buildCodeframe } from '@vesk/adapter/src/error-codeframe';
 import { suggestFor } from '@vesk/adapter/src/error-tips';
@@ -363,6 +364,7 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
             // serialized by `renderFullPage` under another and the page would ship
             // with no ssr-data script.
             '  return withSsrStore(async () => {',
+            '  resetPersistedStoreKeys();',
             '  let page;',
             '  let caughtError = null;',
             '  try {',
@@ -382,7 +384,7 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
             "    if (_inner.head) _head = _inner.head + _head;",
             '  }',
             "  const html = await renderFullPage(_layoutSrcList[0], _layoutCompList[0], { params, children: _body }, __componentRegistry, { hydrate: true, cached: _layoutCompiledList[0]" + bakedOptions + clientScriptOption + dataScriptOption + ', pageHead: _head, sourcePath: _layoutPathList[0] });',
-            "  return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: caughtError ? 500 : 200 });",
+            "  return new Response(__injectStoreInit(html), { headers: { 'Content-Type': 'text/html' }, status: caughtError ? 500 : 200 });",
             '  });',
         ].join('\n');
     }
@@ -390,6 +392,7 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
         renderCode = [
             '  return withSsrStore(async () => {',
             '  let stream;',
+            "  const __streamToken = globalThis.__vsk_ssr_token || '';",
             '  try {',
             '    stream = renderPageStream(_src, _comp, { params }, __componentRegistry, { hydrate: true, cached: _srcCompiled' + bakedOptions + clientScriptOption + dataScriptOption + ", sourcePath: _srcPath });",
             '  } catch (err) {',
@@ -398,13 +401,26 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
             "    const message = err && typeof err === 'object' && 'message' in err ? String(err.message) : String(err);",
             "    const stack = err && typeof err === 'object' && 'stack' in err ? String(err.stack) : '';",
             "    const html = await renderFullPage(_errorSrc, _errorComp, { params, statusCode: 500, error: message, stack, url: url.href }, __componentRegistry, { hydrate: true, cached: _errorCompiled" + bakedOptions + clientScriptOption + dataScriptOption + ', sourcePath: _errorPath });',
-            "    return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: 500 });",
+            "    return new Response(__injectStoreInit(html), { headers: { 'Content-Type': 'text/html' }, status: 500 });",
             '  }',
             '  return new Response(new ReadableStream({',
             '    async start(controller) {',
             '      const enc = new TextEncoder();',
+            "      let __tail = null;",
+            '      resetPersistedStoreKeys(__streamToken);',
             '      for await (const chunk of stream) {',
-            '        controller.enqueue(enc.encode(chunk));',
+            '        if (__tail !== null) controller.enqueue(enc.encode(__tail));',
+            '        __tail = chunk;',
+            '      }',
+            '      if (__tail !== null) {',
+            '        const __tag = __storeInitTag(__streamToken);',
+            "        if (__tag !== '') {",
+            "          const __bi = __tail.lastIndexOf('</body>');",
+            "          __tail = __bi === -1 ? __tail + __tag : __tail.slice(0, __bi) + __tag + __tail.slice(__bi);",
+            '        }',
+            '        controller.enqueue(enc.encode(__tail));',
+            '      } else {',
+            '        resetPersistedStoreKeys(__streamToken);',
             '      }',
             '      controller.close();',
             '    },',
@@ -419,15 +435,17 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
         '    const result = await renderPage(_errorSrc, _errorComp, props, __componentRegistry, { hydrate: true, cached: _errorCompiled, sourcePath: _errorPath });',
         '    return result.body;',
         '  } catch {',
-        "    return '<h1>500 \\u2014 Internal Server Error</h1>';",
+        `    return ${JSON.stringify(renderDefaultErrorFragment())};`,
         '  }',
         '}',
     ].join('\n');
     const funcCode = [
-        "import { renderFullPage, renderPageStream, renderPage, compileFile, setVskHydrate, storeDataScriptGlobal, withSsrStore } from '../runtime.js';",
+        "import { renderFullPage, renderPageStream, renderPage, compileFile, setVskHydrate, storeDataScriptGlobal, withSsrStore, installPersistedStoreServerHooks, persistedStoreCookieName, getPersistedStoreKeys, resetPersistedStoreKeys, buildStorePrePaintPayload, storeInitScriptGlobal, storeInitScriptTag } from '../runtime.js';",
         '', registryCode, src, '',
         errorBodyFnCode,
         '',
+        persistedStoreSsrCode(),
+        '',
         'export async function handle(request) {',
         '  const url = new URL(request.url);',
         "  const urlParts = url.pathname.split('/').filter(Boolean);",

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACe,YAAY,EAAE,WAAW,EAC7B,UAAU,EAChC,MAAM,yBAAyB,CAAC;AAiBjC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9C,UAAU,EAAE,CAQd;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,EAAE,CAGd;AAkDD,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAsWpG;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACe,YAAY,EAAE,WAAW,EAC7B,UAAU,EAChC,MAAM,yBAAyB,CAAC;AAoDjC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9C,UAAU,EAAE,CAQd;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,EAAE,CAGd;AAkDD,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAiXpG;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -28,6 +28,38 @@ async function resolveCompilerApi(name) {
     }
     return import(`@vesk/compiler/src/${name.replace(/\.js$/, '')}`);
 }
+/**
+ * Build gate against two page files claiming one URL.
+ *
+ * SSR routes are keyed by URL pattern (fullPath) — last write wins in the
+ * path->file map — while the client router walks the manifest tree first-match
+ * wins, so a group page and a root page both claiming `/` ship a document for
+ * one of them and hydrate the other. Both respond 200; the only symptom is a
+ * page whose claims land on the layout's elements. Refuse the build instead.
+ */
+function findRouteConflicts(routeTree, appDir) {
+    const projectRoot = resolve(appDir, '..');
+    const byPath = new Map();
+    const walk = (nodes) => {
+        for (const node of nodes) {
+            if (node.page) {
+                const pageFile = join(node.sourceDir, 'page.vsk');
+                const files = byPath.get(node.fullPath) ?? [];
+                files.push(relative(projectRoot, pageFile));
+                byPath.set(node.fullPath, files);
+            }
+            if (node.children && node.children.length > 0)
+                walk(node.children);
+        }
+    };
+    walk(routeTree);
+    const conflicts = [];
+    for (const [fullPath, files] of byPath) {
+        if (files.length > 1)
+            conflicts.push({ fullPath, files });
+    }
+    return conflicts;
+}
 /**
  * Defensive local mirror of the plugin-manager's `filterActivePlugins`
  * (`@vesk/adapter/src/plugins`): keep when there is no matching record, or the
@@ -214,6 +246,14 @@ export async function build(appDir, options) {
         console.error('vesk build: no routes found in', appDir);
         return;
     }
+    const routeConflicts = findRouteConflicts(routeTree, appDir);
+    if (routeConflicts.length > 0) {
+        for (const conflict of routeConflicts) {
+            console.error(`vesk build: conflicting routes for ${conflict.fullPath}: ${conflict.files.join(', ')}`);
+        }
+        const first = routeConflicts[0];
+        throw new Error(`conflicting routes: ${first.fullPath} is claimed by both ${first.files.join(' and ')}`);
+    }
     const projectRoot = resolve(appDir, '..');
     const componentsDir = resolve(projectRoot, 'components');
     const componentMap = scanComponents(componentsDir);

package/dist/platform-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-handler.d.ts","sourceRoot":"","sources":["../src/platform-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIvE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMpD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAgBD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAwLjF;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFzF;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"platform-handler.d.ts","sourceRoot":"","sources":["../src/platform-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AASvE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMpD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAgBD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAyMjF;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFzF;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/platform-handler.js

@@ -1,6 +1,11 @@
 import { existsSync } from 'node:fs';
 import { resolve, dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+// Relative (not `@vesk/adapter/src/...`) so the compiled module keeps working
+// when the dist is copied into a registry-style node_modules layout — see
+// platform-handler.test.ts. No other runtime import in this file, so the pack
+// stays standalone.
+import { renderDefaultNotFoundPage } from './default-pages';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 export function routeName(segments) {
     const parts = segments.filter(Boolean).map(s => {
@@ -65,6 +70,7 @@ export function generatePlatformHandlerSource(input) {
         ? `const __prerendered = new Set(${JSON.stringify(prerenderedPaths)});\n`
         : 'const __prerendered = new Set();\n';
     const isrCache = 'const __isrCache = new Map();';
+    const defaultNotFoundLine = `const __defaultNotFoundHtml = ${JSON.stringify(renderDefaultNotFoundPage())};`;
     const serverStoreLine = hasEvents ? 'const __serverStore = globalThis.__vesk_server_ctx || {};' : '';
     const eventsStartLine = hasEvents ? '  await __eventsStart({ server: null });' : '';
     const eventsRequestLine = hasEvents ? '  await __eventsRequest(mwCtx);' : '';
@@ -80,6 +86,7 @@ ${mwImport}
 ${eventsImport}
 ${prerenderedList}
 ${isrCache}
+${defaultNotFoundLine}
 const __routes = [${routeEntries.join(',\n')}];
 
 async function __invokeRoute(route, request) {
@@ -93,7 +100,7 @@ async function __invokeRoute(route, request) {
       });
     }
     if (e && typeof e === 'object' && e.name === 'NotFoundError') {
-      return new Response('<!DOCTYPE html><html><body><h1>404</h1><p>Not Found</p></body></html>', {
+      return new Response(__defaultNotFoundHtml, {
         status: 404,
         headers: { 'Content-Type': 'text/html' },
       });
@@ -154,6 +161,20 @@ ${serverStoreLine}
     });
   }
 
+  // Persisted-store pre-paint payload (buildStorePrePaintPayload) — same
+  // token-stash/consume contract as /ssr-data.js, own store so neither handoff
+  // can eat the other.
+  if (pathname === '/store-init.js') {
+    const initToken = url.searchParams.get('t') || '';
+    const initStore = (globalThis.__vsk_store_init_payload_store || {});
+    const initPayload = initStore[initToken];
+    if (initPayload !== undefined) delete initStore[initToken];
+    return new Response(initPayload ?? '// no store init', {
+      status: 200,
+      headers: { 'Content-Type': 'application/javascript', 'Cache-Control': 'no-store' },
+    });
+  }
+
 ${eventsStartLine}
   let mwCtx = { params: {}, url, locals: ${localsSeed}, cookies: {}, request, resolveUrl(u) { return new URL(u, request.url).href; }, set() {}, get() { return undefined; } };
   if (${hasMwLiteral}) {
@@ -206,7 +227,7 @@ ${eventsRequestLine}
     return response;
   }
 
-  return new Response('<!DOCTYPE html><html><body><h1>404</h1><p>Not Found</p></body></html>', {
+  return new Response(__defaultNotFoundHtml, {
     status: 404,
     headers: { 'Content-Type': 'text/html' },
   });

package/dist/prod-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prod-server.d.ts","sourceRoot":"","sources":["../src/prod-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAiDjG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AAkGD,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwdxI"}
+{"version":3,"file":"prod-server.d.ts","sourceRoot":"","sources":["../src/prod-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAkDjG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AAkGD,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqexI"}

package/dist/prod-server.js

@@ -10,6 +10,7 @@ import { executeError } from '@vesk/adapter/src/events';
 import { resolveWithin, installMdReadHook } from '@vesk/adapter/src/paths';
 import { resolveCssUrls, hasBuiltGlobalCss } from '@vesk/adapter/src/css';
 import { loadVeskConfig } from '@vesk/adapter/src/load-config';
+import { renderDefaultNotFoundPage, renderDefaultErrorPage } from '@vesk/adapter/src/default-pages';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 async function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
     const chunks = [];
@@ -290,6 +291,19 @@ export async function startProdServer(outDir, options) {
             res.end(lines.join('\n') || '// no ssr data');
             return;
         }
+        // Persisted-store pre-paint payload (buildStorePrePaintPayload), stashed by
+        // storeInitScriptGlobal under its own token store so consuming one never
+        // eats the page's /ssr-data.js handoff. Served once, consumed-and-deleted.
+        if (url.pathname === '/store-init.js') {
+            const token = url.searchParams.get('t') || '';
+            const store = globalThis.__vsk_store_init_payload_store;
+            const payload = store?.[token];
+            if (payload)
+                delete store[token];
+            res.writeHead(200, { 'Content-Type': 'application/javascript', 'Cache-Control': 'no-store' });
+            res.end(payload ?? '// no store init');
+            return;
+        }
         // Stable alias for the client runtime: the file on disk is content-hashed in
         // production, so the name is resolved from the manifest rather than assumed.
         if (url.pathname === '/_vesk/runtime.js') {
@@ -509,7 +523,7 @@ export async function startProdServer(outDir, options) {
                             }
                             if (err.name === 'NotFoundError') {
                                 res.writeHead(404, { 'Content-Type': 'text/html' });
-                                res.end(notFoundHtml || '<!DOCTYPE html><html><body><h1>404</h1><p>Not Found</p></body></html>');
+                                res.end(notFoundHtml || renderDefaultNotFoundPage({ url: url.pathname, headExtra: bakedHeadExtra }));
                                 return;
                             }
                             console.error('vesk ssr error:', err.message);
@@ -541,7 +555,7 @@ export async function startProdServer(outDir, options) {
                                 catch { }
                             }
                             res.writeHead(500, { 'Content-Type': 'text/html' });
-                            res.end(errorHtml || '<!DOCTYPE html><html><body><h1>500</h1><pre>Internal Server Error</pre></body></html>');
+                            res.end(errorHtml || renderDefaultErrorPage({ message: process.env.NODE_ENV !== 'production' ? err.message : undefined, url: url.pathname, headExtra: bakedHeadExtra }));
                             return;
                         }
                     }
@@ -549,7 +563,7 @@ export async function startProdServer(outDir, options) {
             }
         }
         res.writeHead(404, { 'Content-Type': 'text/html' });
-        res.end(notFoundHtml || '<!DOCTYPE html><html><body><h1>404</h1><p>Not Found</p></body></html>');
+        res.end(notFoundHtml || renderDefaultNotFoundPage({ url: url.pathname, headExtra: bakedHeadExtra }));
     });
     try {
         await eventsMod?.executeStart?.({ server, port, host });

package/dist/runtime-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bundle.d.ts","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAuCA,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4JnF"}
+{"version":3,"file":"runtime-bundle.d.ts","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAuCA,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+LnF"}

package/dist/runtime-bundle.js

@@ -42,6 +42,7 @@ export async function bundleRuntime(appDir, outDir) {
         `import { renderPage, renderFullPage, renderPageStream, compileFile, setRuntimeModule, setVskHydrate, hydratePrecompile, assertSameOrigin, withSsrStore } from ${JSON.stringify(resolve(compilerRoot, 'server-codegen.js'))};`,
         `import { parseCookies } from ${JSON.stringify(resolve(compilerRoot, 'server-cookies.js'))};`,
         `import * as __veskRuntime from ${JSON.stringify(resolve(runtimeRoot, 'index-server.js'))};`,
+        `import * as __persistence from ${JSON.stringify(resolve(runtimeRoot, 'store-persistence.js'))};`,
         '',
         '// Inject runtime module so server-codegen can find components like NavLink, Link, etc.',
         'setRuntimeModule(__veskRuntime);',
@@ -107,6 +108,40 @@ export async function bundleRuntime(appDir, outDir) {
         "  return '/ssr-data.js?t=' + token;",
         '}',
         '',
+        '// Persisted-store SSR continuity. `installPersistedStoreServerHooks` installs the',
+        '// adapter-side read hook; `get/getReset` handle the per-request key registry',
+        '// the server drains into the pre-paint payload. The init payload is delivered',
+        '// as an origin-served script (/store-init.js?t=...) exactly like /ssr-data.js',
+        '// so strict CSP (no unsafe-inline) cannot block it; it is never inlined.',
+        'export const installPersistedStoreServerHooks = __persistence.installPersistedStoreServerHooks;',
+        'export const persistedStoreCookieName = __persistence.persistedStoreCookieName;',
+        'export const getPersistedStoreKeys = __persistence.getPersistedStoreKeys;',
+        'export const resetPersistedStoreKeys = __persistence.resetPersistedStoreKeys;',
+        'export const buildStorePrePaintPayload = __persistence.buildStorePrePaintPayload;',
+        'export const storeInitScriptTag = __persistence.storeInitScriptTag;',
+        '',
+        '// Stash the pre-paint payload under a CSPRNG token and return the origin URL',
+        '// the blocking <head> script points at. Own token store (NOT __vsk_ssr_payload_store)',
+        '// so consuming the page hydration handoff never eats the store-init payload',
+        '// and vice versa. Same 100-entry bound as /ssr-data.js.',
+        'export function storeInitScriptGlobal(payload) {',
+        "  if (!payload) return null;",
+        '  const bytes = new Uint8Array(12);',
+        '  crypto.getRandomValues(bytes);',
+        "  let tk = '';",
+        "  for (const b of bytes) tk += b.toString(16).padStart(2, '0');",
+        '  const token = tk;',
+        "  const store = (globalThis.__vsk_store_init_payload_store ||= {});",
+        "  store[token] = payload;",
+        "  const keys = Object.keys(store);",
+        '  if (keys.length > 100) {',
+        '    for (let i = 0; i < keys.length - 100; i++) {',
+        '      delete store[keys[i]];',
+        '    }',
+        '  }',
+        "  return '/store-init.js?t=' + token;",
+        '}',
+        '',
         '// Re-export runtime classes used by API routes',
         'export const VeskRequest = __veskRuntime.VeskRequest;',
         'export const PayloadTooLargeError = __veskRuntime.PayloadTooLargeError;',

package/dist/ssr-function.d.ts

@@ -1,5 +1,10 @@
 import type { RouteNode, SsrFunctionOptions } from '@vesk/adapter/src/types';
 export declare function resolveErrorFile(sourceDir: string, appDir: string): string | null;
+/** Shared persisted-store SSR helper block emitted into every generated SSR
+ *  function (prod via ssr-function.ts, dev via hmr.ts — keep the two callers
+ *  in sync by calling this). Emit it AFTER the function declarations so the
+ *  module-level `installPersistedStoreServerHooks` call runs on import. */
+export declare function persistedStoreSsrCode(): string;
 export declare function generateSsrFunction(routeNode: RouteNode, appDir: string, outDir: string, componentMap?: Map<string, string>, options?: SsrFunctionOptions): {
     funcPath: string;
     funcCode: string;

package/dist/ssr-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-function.d.ts","sourceRoot":"","sources":["../src/ssr-function.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAkB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjF;AAgED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwZtD"}
+{"version":3,"file":"ssr-function.d.ts","sourceRoot":"","sources":["../src/ssr-function.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAkB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjF;AAgED;;;2EAG2E;AAC3E,wBAAgB,qBAAqB,IAAI,MAAM,CA4C9C;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4btD"}

package/dist/ssr-function.js

@@ -2,6 +2,7 @@ import { readFileSync, existsSync } from 'node:fs';
 import { resolve, relative, join } from 'node:path';
 import { resolveComponentName, precompileFile } from '@vesk/compiler/src/server-codegen';
 import { resolveCssUrls, hasBuiltGlobalCss } from '@vesk/adapter/src/css';
+import { renderDefaultErrorFragment } from '@vesk/adapter/src/default-pages';
 // Finds the nearest error.vsk walking up from the route's own directory to the
 // app root, mirroring the router's findErrorComponent chain semantics.
 export function resolveErrorFile(sourceDir, appDir) {
@@ -77,6 +78,55 @@ function buildParamExtraction(node, urlParts) {
     walk(node);
     return parts;
 }
+/** Shared persisted-store SSR helper block emitted into every generated SSR
+ *  function (prod via ssr-function.ts, dev via hmr.ts — keep the two callers
+ *  in sync by calling this). Emit it AFTER the function declarations so the
+ *  module-level `installPersistedStoreServerHooks` call runs on import. */
+export function persistedStoreSsrCode() {
+    return [
+        '// ── Persisted-store SSR continuity (createStore / createPathStore persist) ──',
+        '// Reads a persisted store\'s cookie value through the adapter request context.',
+        '// Client writes mirror URL-encoded; decode on the way back (best effort).',
+        'function __persistRead(key) {',
+        '  const cookieName = persistedStoreCookieName(key);',
+        '  const req = globalThis.__vesk_request;',
+        '  if (!req) return null;',
+        '  const c = req.cookies || {};',
+        '  const v = typeof c.get === \'function\' ? c.get(cookieName) : c[cookieName];',
+        '  if (v == null) return null;',
+        '  try { return decodeURIComponent(String(v)); } catch { return String(v); }',
+        '}',
+        '',
+        '// Drain this request\'s registered persisted keys into a served pre-paint',
+        '// script (/store-init.js?t=...) then forget them. `token` selects the',
+        '// render\'s bucket for callers outside the ALS scope (the no-layout stream',
+        '// path captures its token at the renderPageStream call site); the layout',
+        '// path runs this inside the scope and relies on the ambient token.',
+        'function __storeInitTag(token) {',
+        '  const keys = getPersistedStoreKeys(token);',
+        '  if (keys.length === 0) { resetPersistedStoreKeys(token); return \'\'; }',
+        '  const values = {};',
+        '  for (let __i = 0; __i < keys.length; __i++) values[keys[__i]] = __persistRead(keys[__i]);',
+        '  resetPersistedStoreKeys(token);',
+        '  const payload = buildStorePrePaintPayload(values);',
+        '  const url = storeInitScriptGlobal(payload);',
+        '  return url ? storeInitScriptTag(url) : \'\';',
+        '}',
+        '',
+        '// Inject the blocking store-init <script src> into a full HTML string',
+        '// (before </head>; append if the document has no head).',
+        'function __injectStoreInit(html) {',
+        '  const tag = __storeInitTag();',
+        '  if (tag === \'\') return html;',
+        '  const idx = html.lastIndexOf(\'</head>\');',
+        '  if (idx === -1) return html + tag;',
+        '  return html.slice(0, idx) + tag + html.slice(idx);',
+        '}',
+        '',
+        'installPersistedStoreServerHooks({ read: __persistRead });',
+        '',
+    ].join('\n');
+}
 export function generateSsrFunction(routeNode, appDir, outDir, componentMap, options) {
     const ancestorLayouts = options?.ancestorLayouts || [];
     const middlewareCode = options?.middlewareCode || null;
@@ -161,12 +211,13 @@ export function generateSsrFunction(routeNode, appDir, outDir, componentMap, opt
             '    const result = await renderPage(\'\', _errorComp, props, __componentRegistry, { hydrate: true, cached: _errorCompiled });',
             '    return result.body;',
             '  } catch {',
-            '    return \'<h1>500 \\u2014 Internal Server Error</h1>\';',
+            `    return ${JSON.stringify(renderDefaultErrorFragment())};`,
             '  }',
             '}',
             '',
             'async function __renderHtml(params, requestUrl) {',
             '  return withSsrStore(async () => {',
+            '  resetPersistedStoreKeys();',
             '  let page;',
             '  let caughtError = null;',
             "  const __expose = process.env.NODE_ENV !== 'production';",
@@ -187,7 +238,7 @@ export function generateSsrFunction(routeNode, appDir, outDir, componentMap, opt
             '    if (_inner.head) _head = _inner.head + _head;',
             '  }',
             "  const html = await renderFullPage('', _layoutCompList[0], { params, children: _body }, __componentRegistry, { hydrate: true, cached: _layoutCompiledList[0]" + bakedOptions + clientScriptOption + dataScriptOption + ", pageHead: _head });",
-            "  return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: caughtError ? 500 : 200 });",
+            "  return new Response(__injectStoreInit(html), { headers: { 'Content-Type': 'text/html' }, status: caughtError ? 500 : 200 });",
             '  });',
             '}',
             '',
@@ -207,25 +258,48 @@ export function generateSsrFunction(routeNode, appDir, outDir, componentMap, opt
             'async function __renderHtml(params, requestUrl) {',
             '  return withSsrStore(async () => {',
             '  let stream;',
+            // The streamed no-layout page emits its <head> before the component body
+            // renders, so its persisted stores don't exist yet when the head is
+            // flushed — the pre-paint tag therefore goes into the final chunk, right
+            // before </body> (still a blocking, pre-paint script). Capture the render
+            // token now (renderPageStream adopts this exact ambient store) so the
+            // registry drain in the consumer's start() can hit the right bucket even
+            // though it runs outside the ALS scope.
+            "  const __streamToken = globalThis.__vsk_ssr_token || '';",
             '  try {',
             "    stream = renderPageStream('', _comp, { params }, __componentRegistry, { hydrate: true, cached: _compiled" + bakedOptions + clientScriptOption + dataScriptOption + ' });',
             '  } catch (err) {',
             '    if (err && (err.name === \'NotFoundError\' || err.name === \'Redirect\')) throw err;',
             '    const html = await __renderErrorFullPage(params, requestUrl, err);',
-            "    return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: 500 });",
+            "    return new Response(__injectStoreInit(html), { headers: { 'Content-Type': 'text/html' }, status: 500 });",
             '  }',
             '  return new Response(new ReadableStream({',
             '    async start(controller) {',
             '      const enc = new TextEncoder();',
+            "      let __tail = null;",
+            '      resetPersistedStoreKeys(__streamToken);',
             '      try {',
             '        for await (const chunk of stream) {',
-            '          controller.enqueue(enc.encode(chunk));',
+            '          if (__tail !== null) controller.enqueue(enc.encode(__tail));',
+            '          __tail = chunk;',
+            '        }',
+            '        if (__tail !== null) {',
+            '          const __tag = __storeInitTag(__streamToken);',
+            '          if (__tag !== \'\') {',
+            '            const __bi = __tail.lastIndexOf(\'</body>\');',
+            '            __tail = __bi === -1 ? __tail + __tag : __tail.slice(0, __bi) + __tag + __tail.slice(__bi);',
+            '          }',
+            '          controller.enqueue(enc.encode(__tail));',
+            '        } else {',
+            '          // Empty stream (no chunks) — nothing to attach the tag to; just',
+            '          // clear the registry so a later render can\'t inherit these keys.',
+            '          resetPersistedStoreKeys(__streamToken);',
             '        }',
             '      } catch (err) {',
             '        if (err && (err.name === \'NotFoundError\' || err.name === \'Redirect\')) throw err;',
             '        try {',
             '          const html = await __renderErrorFullPage(params, requestUrl, err);',
-            '          controller.enqueue(enc.encode(html));',
+            '          controller.enqueue(enc.encode(__injectStoreInit(html)));',
             '        } catch {}',
             '      }',
             '      controller.close();',
@@ -236,6 +310,12 @@ export function generateSsrFunction(routeNode, appDir, outDir, componentMap, opt
             '',
         ].join('\n');
     }
+    // Persisted-store SSR continuity (createStore / createPathStore persist).
+    // The adapter-installed read hook pulls each store's cookie value through the
+    // request context; the tag the generated pages emit points at an origin-served
+    // /store-init.js?t=<token> file (CSP-safe, never inlined — see
+    // buildStorePrePaintPayload) so the client can pre-paint the user's value.
+    const persistCode = persistedStoreSsrCode();
     let dataCode;
     const exposeErr = "process.env.NODE_ENV !== 'production'";
     // SPA data-nav renders page + layouts through renderPage and never runs
@@ -254,6 +334,9 @@ export function generateSsrFunction(routeNode, appDir, outDir, componentMap, opt
         // process-global token — the cross-request data-slot race, for good. The
         // token dies with the withSsrStore scope wrapped around this block instead.
         '      delete globalThis.__vsk_ssr_data;',
+        // SPA data-nav only runs renderPage, so the persisted-store registration
+        // bucket would otherwise keep this request's keys forever.
+        '      resetPersistedStoreKeys();',
         '    }',
     ];
     // The data-nav branch never runs renderFullPage/renderPageStream, so it needs
@@ -446,7 +529,7 @@ export function generateSsrFunction(routeNode, appDir, outDir, componentMap, opt
         '',
     ].join('\n');
     const funcCode = [
-        "import { renderFullPage, renderPageStream, renderPage, hydratePrecompile, parseCookies, getAction, validateActionInput, issuesToFieldMap, storeDataScriptGlobal, withSsrStore, assertSameOrigin, VeskRequest } from '../runtime.js';",
+        "import { renderFullPage, renderPageStream, renderPage, hydratePrecompile, parseCookies, getAction, validateActionInput, issuesToFieldMap, storeDataScriptGlobal, withSsrStore, assertSameOrigin, VeskRequest, installPersistedStoreServerHooks, persistedStoreCookieName, getPersistedStoreKeys, resetPersistedStoreKeys, buildStorePrePaintPayload, storeInitScriptGlobal, storeInitScriptTag } from '../runtime.js';",
         '',
         middlewareCode || '',
         registryCode,
@@ -455,6 +538,8 @@ export function generateSsrFunction(routeNode, appDir, outDir, componentMap, opt
         paramsCode,
         htmlFnCode,
         '',
+        persistCode,
+        '',
         'export async function handle(request) {',
         '  const url = new URL(request.url);',
         '  const params = __paramsFor(url.pathname);',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesk/adapter",
-  "version": "0.2.59",
+  "version": "0.2.61",
   "type": "module",
   "description": "Vesk adapter — builds deployable .vesk/ output for Deno and Node serverless",
   "main": "./dist/index.js",
@@ -23,9 +23,9 @@
     "sharp": "^0.35.3"
   },
   "dependencies": {
-    "@vesk/compiler": "^0.2.59",
-    "@vesk/runtime": "^0.2.59",
-    "@vesk/types": "^0.2.59"
+    "@vesk/compiler": "^0.2.61",
+    "@vesk/runtime": "^0.2.61",
+    "@vesk/types": "^0.2.61"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",