@uniweb/core 0.37.0 → 0.37.2

package/package.json

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

package/src/records-service.js

@@ -36,13 +36,16 @@
  *
  * ## ⛔ The HOST tier only — and the reason is mechanical, not a policy
  *
- * `resolveService` reads the site's authored tier first and the host's second.
- * This does not, because it cannot: its caller `resolveFetchConfigs` is a leaf
- * that runs in an SSR isolate over a plain content object with no `Website` to
- * hand. It reads `config.services` directly, so the authored tier is not
- * available here. ⇒ **A site does not declare its own record provider**, which
- * is also the standing ruling — a third-party source is a foundation transport,
- * not site-level config *(2026-09-04, the retired `fetcher:` vocabulary)*.
+ * `resolveService` reads two tiers: the host's offer, then the site's authored
+ * declaration for what the host does not offer. *(This said "the site's authored
+ * tier first" until 2026-10-06; the host's offer has come first since 2026-09-10.)*
+ * This reads the host's alone, because it cannot read the other: its caller
+ * `resolveFetchConfigs` is a leaf that runs in an SSR isolate over a plain
+ * content object with no `Website` to hand. It reads `config.services` directly,
+ * so the authored tier is not available here. ⇒ **A site does not declare its
+ * own record provider**, which is also the standing ruling — a third-party
+ * source is a foundation transport, not site-level config *(2026-09-04, the
+ * retired `fetcher:` vocabulary)*.
  *
  * ## ⛔ A pattern, not a base — and the reason is a deleted function
  *

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.