@uniweb/core 0.37.0 → 0.37.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/core",
-  "version": "0.37.0",
+  "version": "0.37.1",
   "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
   "type": "module",
   "exports": {
@@ -49,8 +49,8 @@
     "vitest": "^4.1.7"
   },
   "dependencies": {
-    "@uniweb/semantic-parser": "^1.5.1",
-    "@uniweb/theming": "^0.2.0"
+    "@uniweb/theming": "^0.2.0",
+    "@uniweb/semantic-parser": "^1.5.1"
   },
   "scripts": {
     "test": "vitest run"

package/src/route-match.js

@@ -297,6 +297,27 @@ export function recordTitle(record) {
   return undefined
 }
 
+/**
+ * A record's SHARED IMAGE — what a link to the page about it shows (its `og:image`).
+ *
+ * ONE RULE, read where `recordTitle` is: the parametric page (`Website._createDynamicPage`)
+ * and the static build's page expansion. It is the record's `image` — the card's picture,
+ * which a page names itself from as it does from the card's title — and it takes the
+ * place of the page's own `seo.image`, which then serves a record that has none. A site's
+ * `seo.image` comes last (`Page.getHeadMeta`).
+ *
+ * Only a non-empty string is an image: a localized map or an object is structure this
+ * rule cannot write into a meta tag.
+ *
+ * @param {Object} record
+ * @returns {string|undefined}
+ */
+export function recordImage(record) {
+  if (!record || typeof record !== 'object') return undefined
+  const image = record.image
+  return typeof image === 'string' && image.trim() !== '' ? image : 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, recordTitle, routeBinding, routeParamName, parentRouteOf } from './route-match.js'
+import { matchDynamicRoute, recordTitle, recordImage, routeBinding, routeParamName, parentRouteOf } from './route-match.js'
 import { resolveFetchConfigs, pageRouteQuery, recordPages } from './fetch-config.js'
 import { declaredKeys } from './data-keys.js'
 import { pageRecordConfig, planFor, runPlanSync } from './page-data.js'
@@ -636,6 +636,11 @@ export default class Website {
         if (currentItem.description || currentItem.excerpt) {
           pageData.description = currentItem.description || currentItem.excerpt
         }
+        // ⭐ And by its picture: a link to the page shows the record's image (`recordImage`).
+        // ⛔ Until 2026-10-05 it showed the page's or the site's `seo.image`, the same for
+        // every record.
+        const image = recordImage(currentItem)
+        if (image) pageData.seo = { ...(pageData.seo || {}), image }
       } else if (answered) {
         // The cache answered and the record is not there: the set is loaded and this ID is
         // not in it, or the record question answered `[]` — definitive not found.