@uniweb/core 0.29.2 → 0.29.3

package/package.json

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

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
         }