@uniweb/build 1.9.0 → 1.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -56,15 +56,15 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
-    "@uniweb/projections": "~1.2.0",
-    "@uniweb/theming": "~1.2.1",
-    "@uniweb/schemas": "~1.6.5",
     "@uniweb/content-reader": "~1.5.6",
+    "@uniweb/projections": "~1.2.0",
     "@uniweb/content-writer": "~1.3.0",
-    "@uniweb/semantic-parser": "~1.13.0"
+    "@uniweb/schemas": "~1.6.5",
+    "@uniweb/semantic-parser": "~1.13.0",
+    "@uniweb/theming": "~1.2.1"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "~1.2.0"
+    "@uniweb/runtime": "~1.2.2"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -73,8 +73,8 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/core": "~1.4.5",
-    "@uniweb/runtime": "~1.2.0"
+    "@uniweb/runtime": "~1.2.2",
+    "@uniweb/core": "~1.4.6"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/prerender.js

@@ -988,20 +988,30 @@ export async function prerenderSite(siteDir, options = {}) {
     })
     const buildDataCache = new DataStore()
 
-    // Build-specific: pre-populate DataStore so EntityStore can resolve data during prerender.
-    // hydrateDataStore handles cache-key derivation + value-shape wrapping
-    // — same helper used by the browser SPA boot and by the Cloudflare
-    // Worker SSR isolate, so all three render paths agree on shape.
-    // ⛔ `siteContent.fetchedData`, not the raw list: only it holds the route-bound
-    // views, and an expanded page rendered without them paints "not found" (measured).
-    hydrateDataStore(uniweb.activeWebsite, siteContent.fetchedData)
-
     // Pre-fetch icons for SSR embedding
     await prefetchIcons(siteContent, uniweb, onProgress)
 
     // Pre-render each page
     const website = uniweb.activeWebsite
 
+    /**
+     * ⭐ A PAGE RENDERS AGAINST WHAT IT CARRIES — the entries its HTML embeds, which are all the
+     * browser's store holds when it boots on that page (`initUniweb` hydrates from them). The
+     * browser renders over the prerendered page, so a render that reads more paints content the
+     * browser does not have, and the browser replaces it with a loading state at boot.
+     *
+     * ⛔ Until 2026-10-25 the store was hydrated once for the whole locale and then took every
+     * page's answers in turn, so a page could render data that only other pages carried. A
+     * section can read the store directly (kit's `useFetched`, `useWholeRecord`), beyond what its
+     * page declares: a page showing records whole through `useWholeRecord` prerendered the ones
+     * the record pages before it had fetched, carried none of them, and showed "loading…" at
+     * boot (measured).
+     */
+    const holdOnly = (carried) => {
+      website.dataStore.clear()
+      hydrateDataStore(website, carried)
+    }
+
     for (const page of website.pages) {
       // Skip dynamic template pages — they exist in the content for runtime
       // route matching but can't be pre-rendered (no concrete route)
@@ -1085,7 +1095,6 @@ export async function prerenderSite(siteDir, options = {}) {
         prerender: 'author',
         cache: buildDataCache,
       })
-      hydrateDataStore(website, asked)
       // Filed under this page, the way a route-bound view always has been: `scopeFetchedData`
       // embeds it in this page's HTML and nowhere else, and one address embedded twice collapses.
       for (const entry of asked) {
@@ -1093,6 +1102,15 @@ export async function prerenderSite(siteDir, options = {}) {
         siteContent.fetchedData.push({ ...entry, _scope: page.route, _routeBound: true })
       }
 
+      // scopeRoutes mirrors the runtime data cascade (page → page.parent → site)
+      // so split-mode pages embed only the collection data their first render reads.
+      // An expanded page's own fetch was read under its TEMPLATE's route — the
+      // route it had when the fetches ran — so that route is in its cascade too.
+      const scopeRoutes = new Set([page.route, page.parent?.route, page.dynamicContext?.templateRoute].filter(Boolean))
+      // The same call `injectBuildData` makes below for this page's HTML, so the render holds what
+      // the HTML embeds — the page's own data step's answers among them.
+      holdOnly(scopeFetchedData(siteContent.fetchedData, splitContent ? scopeRoutes : null, page.route))
+
       onProgress(`Rendering ${outputRoute}...`)
 
       // ⭐ `renderer.render` IS the sequence this loop used to spell out —
@@ -1133,11 +1151,6 @@ export async function prerenderSite(siteDir, options = {}) {
       let html = result.html
 
       // Build-specific: theme CSS, __SITE_CONTENT__, icon cache.
-      // scopeRoutes mirrors the runtime data cascade (page → page.parent → site)
-      // so split-mode pages embed only the collection data their first render reads.
-      // An expanded page's own fetch was read under its TEMPLATE's route — the
-      // route it had when the fetches ran — so that route is in its cascade too.
-      const scopeRoutes = new Set([page.route, page.parent?.route, page.dynamicContext?.templateRoute].filter(Boolean))
       html = injectBuildData(html, siteContent, {
         splitContent,
         currentRoute: page.route,
@@ -1162,6 +1175,8 @@ export async function prerenderSite(siteDir, options = {}) {
       currentRoute: null,  // 404 has no current page — manifest only
       scopeRoutes: new Set(),  // SPA fallback carries site-level fetched data only
     })
+    // The 404 page renders against what 404.html carries, as every page above does.
+    holdOnly(scopeFetchedData(siteContent.fetchedData, splitContent ? new Set() : null, null))
     const { html: notFoundHtml, hasNotFoundPage } = generate404Html({
       baseHtml: fallbackBaseHtml,
       website,

package/src/site/plugin.js

@@ -305,7 +305,6 @@ import { mountDevApi } from '../dev/api-mount.js'
  * @param {boolean} [options.assets.pdfThumbnails=true] - Generate thumbnails for PDFs (requires pdf-lib)
  * @param {Object} [options.search] - Search index configuration
  * @param {boolean} [options.search.enabled=true] - Generate search index (uses site.yml config by default)
- * @param {string} [options.search.filename='search-index.json'] - Search index filename
  * @param {string} [options.foundationPath] - Path to foundation directory (for loading theme vars)
  */
 export function siteContentPlugin(options = {}) {
@@ -1080,7 +1079,10 @@ export function siteContentPlugin(options = {}) {
         // ⛔ No sitemap.xml or robots.txt here: the prerender writes them from the pages it
         // renders (`./seo-files.js`), and a dev server renders none ahead of a visit.
 
-        // Serve search-index.json in dev mode (supports locale prefixes)
+        // Serve search-index.json in dev mode, under a language's prefix too.
+        // ⚠️ Made from the default language's content whatever the prefix, and with no records for
+        // another language: the build's `/fr/search-index.json` is in French, this one is not
+        // (measured 2026-10-25).
         const searchIndexMatch = req.url.match(new RegExp(`^(?:\\/(${LOCALE_RE}))?\\/search-index\\.json$`))
         if (searchIndexMatch && siteContent) {
           const searchEnabled = searchPluginConfig.enabled !== false && searchDeclaredOn(siteContent)
@@ -1111,7 +1113,10 @@ export function siteContentPlugin(options = {}) {
         // Without this the artifacts can only be inspected by deploying, and
         // `uniweb doctor`'s address warning describes something invisible
         // locally. Both routes reuse the build's generators, so what a
-        // developer sees here is what ships.
+        // developer sees here is what ships — for the default language.
+        // ⚠️ Not for another one (measured 2026-10-25): the build writes it no `llms.txt` or `.md`,
+        // and the `.md` route below finds a page by its source route, so the translated links this
+        // `llms.txt` gives (`/fr/a-propos.md`) are answered with the page shell.
         if (siteContent) {
           const agents = resolveAgentsConfig(siteContent.config)
           const url = req.url.split('?')[0]

package/src/site/record-projections.js

@@ -8,6 +8,10 @@
  * ⛔ Until 2026-10-25 the static build made its projections from the site's pages alone: llms.txt
  * and the search index held none of a site's books, talks or posts, while a host's held all of them
  * (measured on a site with 16 record pages: 0 in llms.txt, 0 in the search index).
+ *
+ * ⚠️ For the default language only. Another language's search index is still made from its pages
+ * alone, before its records are translated (`i18n/index.js::buildLocalizedContent`), and the build
+ * writes that language no llms.txt or `.md` (measured 2026-10-25 on a site in three languages).
  */
 
 import { readFileSync } from 'node:fs'