@uniweb/core 0.29.1 → 0.29.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/core",
-  "version": "0.29.1",
+  "version": "0.29.3",
   "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
   "type": "module",
   "exports": {

package/src/block.js

@@ -104,10 +104,16 @@ export default class Block {
 
     // Merge fetched data from prerender (if present)
     // Prerender stores fetched data in blockData.parsedContent.data
+    //
+    // ⭐ THE SECTION'S OWN DATA WINS, as it does when nothing was prerendered: a tagged
+    // data block fills its key first, and a fetch fills only what is left. ⛔ The
+    // prerendered answer was spread LAST until 2026-09-14, so a key held by both a
+    // tagged block and the section's own fetch showed the fetch's records on a
+    // prerendered page and the tagged block in the browser.
     if (blockData.parsedContent?.data) {
       this.parsedContent.data = {
-        ...(this.parsedContent.data || {}),
         ...blockData.parsedContent.data,
+        ...(this.parsedContent.data || {}),
       }
     }
 

package/src/entity-store.js

@@ -144,7 +144,7 @@ export default class EntityStore {
 
   /**
    * The ROUTE QUERY of the block's page — the query its URL names one record of —
-   * worked out from the same sources `_findFetchConfigs` walks, at the page that
+   * worked out from the same sources `_levels` reads, at the page that
    * captured the URL's variable (`pageRouteQuery`, `./fetch-config.js`): its fetch,
    * its parent's, the site's, and, when none of those declares one, the key its
    * sections share. So what a section receives and what the URL narrows are read

package/src/fetch-config.js

@@ -195,8 +195,12 @@ function localizeConfig(cfg, locale, defaultLocale) {
  *     by the URL's value (`buildDetailConfig`);
  *   - an external query declaring `record:` → `true`: its own request;
  *   - a query declaring `deferred:` → `/data/<query>/{slug}.json`, the per-record
- *     file the build emits beside the lean list. Per-record files are keyed by the
- *     record's slug, and are not localized.
+ *     file the build emits beside the lean list, keyed by the record's slug. ⭐ On a
+ *     locale other than the default it is `/<locale>/data/<query>/{slug}.json`, the
+ *     way the list's own path is (`localizeConfig`): a localized build writes a
+ *     translated copy of every per-record file beside the translated list. ⛔ Until
+ *     2026-09-14 the pattern was never localized, so a translated record page asked
+ *     for the default locale's file and showed an untranslated body.
  *
  * ⛔ `detail:` is no longer AUTHORED (retired 2026-09-13 [Diego]; the build refuses
  * it): its `rest`, `query`, pattern and `{ body, envelope }` forms are an external
@@ -208,9 +212,11 @@ function localizeConfig(cfg, locale, defaultLocale) {
  *
  * @param {Object} cfg
  * @param {Object|null} queries - the site's `config.queries` map
+ * @param {string|null} [locale] - the page's locale
+ * @param {string|null} [defaultLocale] - the site's default locale
  * @returns {Object} the original config, or a copy carrying `detail`
  */
-function applyDeferredDetail(cfg, queries) {
+function applyDeferredDetail(cfg, queries, locale = null, defaultLocale = null) {
   if (cfg.detail !== undefined) return cfg
 
   // The records service answers a RECORD by the query's set narrowed to it, so
@@ -239,7 +245,9 @@ function applyDeferredDetail(cfg, queries) {
   if (!collConfig || typeof collConfig !== 'object') return cfg
   const deferred = Array.isArray(collConfig.deferred) ? collConfig.deferred : null
   if (!deferred || deferred.length === 0) return cfg
-  return { ...cfg, detail: recordDataUrl(queryName, '{slug}') }
+  const pattern = recordDataUrl(queryName, '{slug}')
+  const localized = locale && locale !== defaultLocale && isDataUrl(pattern) ? `/${locale}${pattern}` : pattern
+  return { ...cfg, detail: localized }
 }
 
 /**
@@ -549,7 +557,7 @@ export function resolveFetchConfigs(sources, options = {}) {
       const sourced = resolveQuerySource(cfg, services, { queries, locale, defaultLocale })
       const localized = localizeConfig(sourced, locale, defaultLocale)
       const bound = dropRootScope(bindRouteVariables(localized, variables))
-      configs.set(key, stampDepthAndLocale(applyDeferredDetail(bound, queries), locale, defaultLocale))
+      configs.set(key, stampDepthAndLocale(applyDeferredDetail(bound, queries, locale, defaultLocale), locale, defaultLocale))
     }
   }
 

package/src/index.js

@@ -67,6 +67,7 @@ export {
   splitPathCapture,
   joinPathCapture,
   recordHandle,
+  recordTitle,
   routeParamValue,
   routeParamValues,
   matchesRouteParam,

package/src/route-match.js

@@ -261,6 +261,36 @@ export function recordHandle(record) {
   return record.slug
 }
 
+/**
+ * A record's DISPLAY TITLE — what the page about it, and a search result for it, are called.
+ *
+ * ⭐ ONE RULE, read by every producer of that title (ruled 2026-09-14 [Diego]): the
+ * parametric page (`Website._createDynamicPage`, so the SPA and a host's render), the
+ * static build's page expansion, and the record search index (`@uniweb/projections`).
+ *
+ *     title  →  name  →  the record's handle (`recordHandle`: `$name`, else `slug`)
+ *
+ * ⛔ Until then a page read `title` alone while the search index read `title || name`,
+ * so a record with a `name` and no `title` — a person — titled its search result and
+ * left its page carrying the template's own title, which on the site where this was
+ * measured was the route token itself: `:slug` (2026-09-14).
+ *
+ * Only a non-empty string (or a finite number — `title: 2024` in YAML) names a record.
+ * A localized map or a rich document is structure this rule cannot render, and
+ * `String()` of one is `[object Object]`.
+ *
+ * @param {Object} record
+ * @returns {string|undefined}
+ */
+export function recordTitle(record) {
+  if (!record || typeof record !== 'object') return undefined
+  for (const value of [record.title, record.name, recordHandle(record)]) {
+    if (typeof value === 'string' && value.trim() !== '') return value
+    if (typeof value === 'number' && Number.isFinite(value)) return String(value)
+  }
+  return undefined
+}
+
 /**
  * The record field a route param is matched on — ONE MAP, read by the local match
  * (`routeParamValue`, below) and by the records service's record question (`match`,

package/src/website.js

@@ -11,7 +11,7 @@ import FetcherDispatcher from './fetcher-dispatcher.js'
 import ObservableState from './observable-state.js'
 import { normalizeSeo } from './seo.js'
 import { resolveDefaultLocale, localeLabel } from './locale-config.js'
-import { matchDynamicRoute, decodeRouteValue, matchesRouteParam, routeBinding, routeParamName, parentRouteOf } from './route-match.js'
+import { matchDynamicRoute, decodeRouteValue, matchesRouteParam, recordTitle, routeBinding, routeParamName, parentRouteOf } from './route-match.js'
 import { resolveFetchConfigs, pageRouteQuery, recordPages, routeSelection, siteReaches } from './fetch-config.js'
 import { declaredKeys } from './data-keys.js'
 import { buildDetailConfig } from './detail-url.js'
@@ -679,7 +679,11 @@ export default class Website {
       }
 
       if (currentItem) {
-        if (currentItem.title) pageData.title = currentItem.title
+        // ⭐ The record names the page by the one rule its search result is named by
+        // too (`recordTitle`: `title`, `name`, then its handle). ⛔ Until 2026-09-14 this
+        // read `title` alone, so a person record kept the template's title — `:slug`.
+        const title = recordTitle(currentItem)
+        if (title) pageData.title = title
         if (currentItem.description || currentItem.excerpt) {
           pageData.description = currentItem.description || currentItem.excerpt
         }