@ultimat3/render 25.0.0 → 25.2.0

package/CLAUDE.md

@@ -113,7 +113,7 @@ axiom 6). Never `cli` (upward).
 | Router ↔ the page's lifecycle | `navigation-scroll.ts` owns `scrollRestoration = 'manual'` and RESTORES the entry's saved offset at start, before its first save (a reload, or Back after a full load); `navigation-tabs.ts` owns the `BroadcastChannel`, closed on `pagehide` (it blocks the back/forward cache), reopened and the cache emptied on a persisted `pageshow`. A sheet `loadStylesheets` appends is `owned` at once, so an aborted navigation's sheets are retired by the next swap. A view transition is tracked by identity: an older one finishing never clears the running one. |
 | Router ↔ islands | ONE bootstrap: the swap re-runs the inline hydration runtime, whose `each` visits a root once per tab (`el.__v`). Never add a second mount path for the router. Dispose = call what `el.__x` resolved to. |
 | Router head diff | only elements a SERVER document put in `<head>` (`documentHead`'s set) may be removed; a script-added one is the tab's. Scripts and stylesheets are never diffed. |
-| Router: nothing is sent twice | the router follows no redirect (`redirect: 'manual'`; the server hands it over as `204` + `x-ultimate-location`), never re-submits a POST (a failure is `ultimate:navigation-error`), and hands a 2xx non-page answer to the browser from the bytes it already has. A 4xx/5xx non-page answer (an offline worker's empty 503) is never handed over (it became a `blob:` URL): a POST fails, a GET is loaded by the browser — the ONE deliberate re-send, as there is nothing to show (`responseVerdict`). Its cache never answers with a non-2xx, a hand-over, or a `no-store` page older than 5 s, and is emptied by any POST (when sent AND when it settles), `onClientWrite`, `onRescope` and a `BroadcastChannel` message from another tab. |
+| Router: nothing is sent twice | every router fetch is `cache: 'no-cache'` — the browser's HTTP cache never answers, the router's own is the only reuse layer (#693; `navigation-fetch.test.ts`, `client-navigation-cache.e2e.test.ts`). The router follows no redirect (`redirect: 'manual'`; the server hands it over as `204` + `x-ultimate-location`), never re-submits a POST (a failure is `ultimate:navigation-error`), and hands a 2xx non-page answer to the browser from the bytes it already has. A 4xx/5xx non-page answer (an offline worker's empty 503) is never handed over (it became a `blob:` URL): a POST fails, a GET is loaded by the browser — the ONE deliberate re-send, as there is nothing to show (`responseVerdict`). Its cache never answers with a non-2xx, a hand-over, or a `no-store` page older than 5 s, and is emptied by any POST (when sent AND when it settles), `onClientWrite`, `onRescope` and a `BroadcastChannel` message from another tab. |
 
 Cross-package: `@ultimat3/pwa` consumes route descriptors as **data**, never by import.
 Keep `RouteDescriptor` additive — removing a field breaks `sw.js` generation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/render",
-  "version": "25.0.0",
+  "version": "25.2.0",
   "description": "The route primitive and the five render modes: static, isr, ssr, stream, spa.",
   "license": "MIT",
   "type": "module",
@@ -39,11 +39,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/cache": "25.0.0",
-    "@ultimat3/core": "25.0.0",
-    "@ultimat3/http": "25.0.0",
-    "@ultimat3/i18n": "25.0.0",
-    "@ultimat3/seo": "25.0.0",
+    "@ultimat3/cache": "25.2.0",
+    "@ultimat3/core": "25.2.0",
+    "@ultimat3/http": "25.2.0",
+    "@ultimat3/i18n": "25.2.0",
+    "@ultimat3/seo": "25.2.0",
     "sass": "1.105.1"
   }
 }

package/src/navigation-fetch.ts

@@ -1,8 +1,9 @@
 /**
  * The client router's one request: the headers the server's navigation gate reads (purpose, the
  * document's `<app>:<surface>`, its principal, its build on a GET), `redirect: 'manual'` so no
- * redirect is followed behind the router's back, and the answer read ONCE into an `Answer` — the
- * page's text, or a non-page's bytes to hand over (a prefetch's are dropped unread).
+ * redirect is followed behind the router's back, `cache: 'no-cache'` so the browser's HTTP cache
+ * never answers, and the answer read ONCE into an `Answer` — the page's text, or a non-page's
+ * bytes to hand over (a prefetch's are dropped unread).
  */
 
 import {
@@ -50,8 +51,16 @@ export function fetchDocument(
   // GET only: a skewed GET is refused before any route runs; a POST is never refused mid-submit.
   const build = metaOf(doc, CLIENT_BUILD_META);
   if ((init.method ?? 'GET') === 'GET' && build !== null) headers[CLIENT_BUILD_META] = build;
+  // `no-cache`: the browser's HTTP cache never answers — a `stale-while-revalidate` page would be
+  // swapped in stale after a write, a sign-out or a deploy (#693); the router's cache is the only one.
   return win
-    .fetch(url, { ...init, credentials: 'same-origin', redirect: 'manual', headers })
+    .fetch(url, {
+      ...init,
+      cache: 'no-cache',
+      credentials: 'same-origin',
+      redirect: 'manual',
+      headers,
+    })
     .then(async (response) => {
       const contentType = response.headers.get('content-type') ?? '';
       const opaqueRedirect = response.type === 'opaqueredirect';