@uniweb/runtime 0.9.4 → 0.9.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/runtime",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Minimal runtime for loading Uniweb foundations",
   "type": "module",
   "exports": {
@@ -13,7 +13,8 @@
   },
   "files": [
     "src",
-    "dist"
+    "dist",
+    "!dist/app/**/*.map"
   ],
   "keywords": [
     "uniweb",
@@ -43,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.16.9"
+    "@uniweb/build": "0.16.12"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/ssr-renderer.js

@@ -553,6 +553,30 @@ export async function prefetchIcons(siteContent, uniweb, onProgress = () => {})
  * @param {Error} err
  * @returns {{ type: 'hooks'|'null-component'|'unknown', message: string }}
  */
+/**
+ * Resolve a route to the Page that should render it.
+ *
+ * Exists because this module exported `renderPage(page, …)` and no supported way
+ * to *get* a page — so every host rendering server-side wrote its own lookup,
+ * and the obvious one (`website.pages.find(p => p.route === route)`) cannot
+ * match a dynamic route, because the payload holds `/blog/:id` and the request
+ * carries `/blog/1`. One host wrote that lookup three times in three files
+ * before the gap was noticed. A renderer that takes a Page owes callers a Page.
+ *
+ * This is `Website#getPage` — the same seven-step resolution the browser runs,
+ * literally the same function, so a server-rendered page and the one hydrating
+ * over it cannot disagree. Pure `@uniweb/core`: no React, no DOM, no DataStore
+ * required, safe in a Worker isolate.
+ *
+ * @param {Website} website
+ * @param {string} route - The requested path, e.g. `/blog/1`
+ * @returns {Page|undefined} The page, or undefined when nothing matches — which
+ *   is a genuine 404 and the caller's to turn into one.
+ */
+export function resolvePage(website, route) {
+  return website.getPage(route)
+}
+
 export function classifyRenderError(err) {
   const msg = err.message || ''
 
@@ -589,6 +613,27 @@ export function classifyRenderError(err) {
 export function renderPage(page, website) {
   website.setActivePage(page.route)
 
+  // A page that claims content but yields no blocks has not been loaded — it is
+  // not an empty page. `Page#bodyBlocks` returns [] when its sections are absent
+  // from the payload (split content), on the understanding that a caller loads
+  // them first: the SPA does, in PageRenderer and at boot. THIS path never has.
+  //
+  // Left alone, that renders a structurally valid, completely empty document and
+  // reports success — which is the worst shape a failure can take, and it cost a
+  // host most of a day chasing a renderer that was doing what it was told.
+  // Distinguishing it here is cheap: a content-less container reports
+  // hasContent() === false and is correctly empty, so the two never collide.
+  if (page.hasContent?.() && page.getBodyBlocks().length === 0) {
+    return {
+      error: {
+        type: 'content-not-loaded',
+        message:
+          `page "${page.route}" declares content but has no loaded sections — ` +
+          'its sections are not in the payload and this renderer does not fetch them',
+      },
+    }
+  }
+
   const element = renderLayout(page, website)
 
   let renderedContent

package/src/ssr.js

@@ -39,7 +39,12 @@ export {
   hydrateDataStore,
   prefetchIcons,
 
-  // Layer 3: Per-page rendering
+  // Layer 3: Per-page rendering.
+  // `resolvePage` belongs beside `renderPage` and its absence was a real bug:
+  // this list handed callers a renderer that takes a Page and no supported way
+  // to get one, so a host wrote its own lookup three times — and the obvious
+  // one, an exact match over `website.pages`, cannot match a dynamic route.
+  resolvePage,
   renderPage,
   classifyRenderError,
 

package/dist/app/_importmap/@uniweb-core.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"@uniweb-core.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}