@uniweb/runtime 0.28.5 → 0.28.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/runtime",
-  "version": "0.28.5",
+  "version": "0.28.7",
   "description": "Minimal runtime for loading Uniweb foundations",
   "type": "module",
   "exports": {
@@ -36,7 +36,7 @@
     "node": ">=20.19"
   },
   "dependencies": {
-    "@uniweb/core": "^0.35.0",
+    "@uniweb/core": "^0.35.2",
     "@uniweb/theming": "^0.2.0"
   },
   "devDependencies": {
@@ -44,7 +44,7 @@
     "esbuild": "^0.21.0 || ^0.23.0 || ^0.24.0 || ^0.25.0 || ^0.27.0",
     "vite": "^7.3.1",
     "vitest": "^4.1.7",
-    "@uniweb/build": "0.74.0"
+    "@uniweb/build": "0.74.3"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/components/PageRenderer.jsx

@@ -122,12 +122,14 @@ export default function PageRenderer() {
   // Force re-render counter — incremented by DataStore listener below
   const [, forceUpdate] = useReducer((x) => x + 1, 0)
 
-  // Resolve page from current URL and sync website.activePage immediately.
-  // This must happen synchronously (not in an effect) so child components
-  // like Header see the correct activePage during the same render cycle.
+  // ⭐ WHAT THE URL NAMES — `Website#resolveRoute`, the one rule every lane calls
+  // (`@uniweb/core/resolve-route`): a page, a redirect, a page served from elsewhere, or
+  // nothing. Resolved synchronously (not in an effect) so child components like Header see the
+  // correct activePage during the same render cycle.
   const navigate = useNavigate()
 
-  let page = website?.getPage(location.pathname)
+  const resolution = website?.resolveRoute?.(location.pathname) ?? null
+  let page = resolution && resolution.kind !== 'notFound' ? resolution.page : null
   if (page && website) website.setActivePage(location.pathname)
 
   // ─── Content loading (split page content) ───
@@ -155,32 +157,25 @@ export default function PageRenderer() {
 
   // ─── Compute navigation targets (before hooks, no early returns) ───
 
-  // Explicit redirect: in page.yml
-  const redirectTarget = page?.redirect || null
-
-  // Auto-redirect for content-less pages (structural containers).
-  // Folders with page.yml but no markdown keep their route in the hierarchy;
-  // when visited directly, redirect to the first descendant with content.
-  //
-  // The DECISION stays canonical — `getNavigableRoute()` and `page.route` are
-  // both canonical, and comparing a localized URL against a canonical route
-  // would make a folder-with-index redirect to itself forever.
-  const navigableRoute = page && !page.redirect && !page.hasContent()
-    ? page.getNavigableRoute()
-    : null
-  const shouldAutoRedirect = !!(navigableRoute && navigableRoute !== page?.route)
-
-  // The DESTINATION is localized. `getNavigableRoute()` returns a canonical
-  // route, so navigating to it raw dropped both the slug translation and the
-  // `/<locale>` prefix: visiting `/fr/Guide-de-démarrage-rapide` landed on
-  // `/Quick-Start-Guide/From-Idea-to-Website` and served the page in ENGLISH.
-  // getLocaleUrl() is the same helper the language switcher uses.
-  const autoRedirectRoute = shouldAutoRedirect
-    ? website?.getLocaleUrl?.(website.activeLocale, navigableRoute) || navigableRoute
-    : null
+  // The redirect the URL names, as the resolver gives it: an author's `redirect:` — a page of the
+  // site as THIS locale shows it, anything else as written; a page with no content to its first
+  // descendant with content, in this locale too (the decision canonical, the destination localized —
+  // `localeUrl`, the language switcher's rule); or the locale served unprefixed, asked for with its
+  // prefix, to the path without it.
+  // ⛔ This component worked the first two out for itself until 2026-09-30, and the static build
+  // and every host each had a copy.
+  const redirectLocation = resolution?.kind === 'redirect' ? resolution.location : null
+
+  // ⭐ A page served from elsewhere (`rewrite:`) is the HOST's to proxy, before the app loads.
+  // Reached by in-app navigation, it is loaded for real so the host can. Reached as the document's
+  // own first load (`location.key === 'default'`), the host served the app instead — it does not
+  // proxy — so there is no page here: the not-found page, as a static build emits none for it.
+  // ⛔ Until 2026-09-30 both reloaded, and on a host that does not proxy that reload never ended.
+  const isRewrite = resolution?.kind === 'rewrite'
+  const rewriteNotProxied = isRewrite && location.key === 'default'
 
   // If no page found, try the 404 page (do NOT fall back to activePage/homepage)
-  const isNotFound = !page && !redirectTarget
+  const isNotFound = (!page && !redirectLocation) || rewriteNotProxied
   if (isNotFound) {
     page = website?.getNotFoundPage?.() || null
   }
@@ -194,18 +189,14 @@ export default function PageRenderer() {
   // ─── All hooks called unconditionally (React rules of hooks) ───
 
   useEffect(() => {
-    if (!redirectTarget) return
-    if (redirectTarget.startsWith('http')) {
-      window.location.replace(redirectTarget)
+    if (!redirectLocation) return
+    // A URL with a scheme leaves the app — another site, or a locale's own domain.
+    if (/^[a-z][a-z0-9+.-]*:/i.test(redirectLocation)) {
+      window.location.replace(redirectLocation)
     } else {
-      navigate(redirectTarget, { replace: true })
+      navigate(redirectLocation, { replace: true })
     }
-  }, [redirectTarget, navigate])
-
-  useEffect(() => {
-    if (!shouldAutoRedirect) return
-    navigate(autoRedirectRoute, { replace: true })
-  }, [shouldAutoRedirect, autoRedirectRoute, navigate])
+  }, [redirectLocation, navigate])
 
   useHeadMeta(headMeta, { siteName })
 
@@ -221,13 +212,10 @@ export default function PageRenderer() {
 
   // ─── Early returns (after all hooks) ───
 
-  if (redirectTarget) return null
-  if (shouldAutoRedirect) return null
+  if (redirectLocation) return null
 
-  // Rewrite pages are served by an external site — the host handles routing.
-  // In SPA mode this shouldn't be reached (host proxies before JS loads),
-  // but if it is (e.g., dev mode), do a full page reload to let the host handle it.
-  if (page?.rewrite) {
+  // An in-app navigation to a rewrite route: load it for real, so a host that proxies can.
+  if (isRewrite && !rewriteNotProxied) {
     window.location.reload()
     return null
   }

package/src/default-fetcher.js

@@ -252,7 +252,9 @@ export function createDefaultFetcher({ basePath = '', dev = false, fetch: fetchI
  * Anything the service does not answer (a retired operator) is sent as written and
  * answered there: never approximated.
  */
-function toQuestion(request) {
+// Exported so the question a parametric page's record is asked with can be generated as test
+// vectors: it is this body, and nothing else composes one.
+export function toQuestion(request) {
   const q = { schema: request.schema }
   const where = request.where && typeof request.where === 'object' ? request.where : null
   // ⭐ `scope` crosses as authored. ⛔ A top-level `where.path.under` was respelled

package/src/isolate-api.js

@@ -5,11 +5,13 @@
  * ⭐ THE ONE PLACE THE NUMBER IS STATED. A host loads the SITE'S pinned runtime as a
  * dynamically-loaded artifact — never an import — so it cannot link-check what it
  * calls; it feature-detects, and an export that is missing looks exactly like an old
- * runtime. The backend evaluates a site's runtime at publish and holds this floor as
- * a constant of its own [Diego, 2026-09-04: "We will set a runtime version floor that
- * guarantees they are there"], composing it as `max(absoluteFloor, foundationFloors)`.
- * That constant is copied from here, and `tests/isolate-api.test.js` is what keeps
- * this file honest: every export of `src/ssr.js` must appear below with the version
+ * runtime. The backend evaluates a site's runtime at publish against this floor [Diego,
+ * 2026-09-04: "We will set a runtime version floor that guarantees they are there"],
+ * composing it as `max(floor, foundationFloors)`. It reads the floor from the runtime
+ * channel's index (`minUsable`), which every channel publish writes from this file —
+ * since 2026-09-05, when that replaced a constant copied from here by hand. (This said
+ * the backend held a copied constant until 2026-09-30.) `tests/isolate-api.test.js` is
+ * what keeps this file honest: every export of `src/ssr.js` must appear below with the version
  * it first shipped in, and every name below must still be exported — by the source
  * and by the built `dist/ssr.js` when it is present. Forgetting to stamp a new export
  * fails HERE, in the repo where the change happens; a rename fails here too.
@@ -57,7 +59,9 @@
  *   3. replace `UNRELEASED` with the version that publish produced — the floor
  *      moves here, and the runtime channel's `minUsable` follows at the
  *      next channel publish;
- *   4. tell backend, which holds the number and must ratchet it.
+ *   4. nothing to copy by hand: the backend reads the floor from the channel index, so
+ *      a raise reaches it at the channel publish AFTER the commit that makes it. (This
+ *      step said "tell backend, which holds the number" until 2026-09-30.)
  *
  * ⚖️ **Step 3 is a real obligation, not bookkeeping**: an export left
  * `UNRELEASED` after it ships keeps the floor below its own API forever, so a
@@ -106,6 +110,12 @@ export const ISOLATE_API = Object.freeze({
   prefetchAndHydrate: '0.14.2',
   // the whole corpus, for a host that indexes rather than renders
   collectSiteRecords: '0.17.0',
+  // what a URL names — a page, a redirect, a page served from elsewhere, or nothing
+  resolveRoute: '0.28.6',
+  routeIndex: '0.28.6',
+  localeOfPath: '0.28.6',
+  localeUrl: '0.28.6',
+  RESOLUTION_STATUS: '0.28.6',
 })
 
 /**

package/src/ssr.js

@@ -63,10 +63,18 @@ export {
 // hydration.
 export { loadPageData } from './load-page-data.js'
 
-// Which page a route names — the rule, not a copy of it (`@uniweb/core/route-match`). A host
-// resolving a route before it asks us anything imports this rather than comparing strings: the
-// SPA normalizes a trailing slash, and a copy that did not made `/about/` prefetch nothing and
-// then render fine (2026-09-12).
+// ⭐ WHAT A URL NAMES — a page, a redirect, a page served from elsewhere, or nothing: the rule the
+// SPA and the static build call (`@uniweb/core/resolve-route`). A host asks it BEFORE it fetches:
+// a redirect needs no data and a URL naming nothing needs no render. It reads one locale's content;
+// `localeOfPath` says which locale a path names, so which content to read. `status` is what a host
+// that sends one sends. ⛔ Each host kept its own copy of the redirect and locale rules until
+// 2026-09-30, and the copies disagreed.
+export { resolveRoute, routeIndex, localeOfPath, localeUrl, RESOLUTION_STATUS } from '@uniweb/core/resolve-route'
+
+// Which page a route names, by its exact route and then the parametric patterns
+// (`@uniweb/core/route-match`). ⚠️ The subset of `resolveRoute`: no locale prefix, no translated
+// route, no index page — for a canonical, unprefixed route only. A copy that compared strings made
+// `/about/` prefetch nothing and then render fine (2026-09-12).
 // ⛔ `prefetchPageData`, `resolvePageFetchConfigs` and `executeFetchConfigs` are GONE (2026-09-20).
 // They worked from the payload alone, which cannot say which keys a component declares, which
 // layout a page draws, or which transport a key is routed to — four measured cases wrong