@uniweb/core 0.36.0 → 0.37.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/core",
-  "version": "0.36.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/index.js

@@ -93,7 +93,10 @@ export {
   landingRoute,
   RESOLUTION_STATUS,
 } from './resolve-route.js'
-export { isRichSchema } from './schemas.js'
+// ⛔ No `isRichSchema` (removed 2026-10-05). It told a form-shaped `data:` value from a field
+// map for the runtime's field defaults and the build's runtime schema; both went when the
+// runtime stopped filling field defaults. A registered schema says it outright — `kind: 'form'`
+// in format 3 (`@uniweb/schemas/foundation`) — and the editor, its last reader, reads that.
 // ⛔ `Tracker` is NOT on the package entry. It is a FEATURE, not part of the
 // object graph this package exists to define, and putting it here made every
 // consumer of core carry 1,576 gzip of it -- press, unipress, `@uniweb/api`

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.
@@ -755,7 +760,7 @@ export default class Website {
   /**
    * Get layout metadata from foundation config
    * @param {string} layoutName - Layout name
-   * @returns {Object|null} Layout meta { areas, transitions, defaults }
+   * @returns {Object|null} Layout meta { transitions, layers, scroll, defaults } — a page's areas are its site's `layout/` folder (`getLayoutAreas`)
    */
   getLayoutMeta(layoutName) {
     return findLayoutEntry(globalThis.uniweb?.foundationConfig?.layoutMeta, layoutName) || null

package/src/schemas.js

@@ -1,45 +0,0 @@
-/**
- * The rich-form-schema predicate. One function, and deliberately only one.
- *
- * Rich schemas live under `data.schemas` in a component's meta.js. They drive
- * two author input paths that both land at `content.data[schema-id]`: tagged
- * markdown blocks (``` ```yaml:<id> ``` ```) and the editor's FormBlock widget.
- *
- * `isRichSchema` is a **dispatch** predicate — "is this already the rich shape?"
- * — and it is read at render by `runtime/src/prepare-props.js` (`applySchemas`)
- * and at build by `build/src/runtime-schema.js`. Both are on the hot path of
- * every site, which is what earns it a place in this package.
- *
- * ⛔ **Do not add editor-side schema code here.** `normalizeSchema` — "can this
- * be edited, and as what?" — sat beside this function until 2026-09-01 purely
- * because the two were adjacent; it never called `isRichSchema` and had no
- * consumer outside the editor. `@uniweb/core` loads on every site in every lane
- * and is not tree-shaken on the hosted one, so an editor-only function on its
- * entry is paid for by every visitor of every site. It now lives in the
- * zero-dependency leaf that owns what a data-schema *means*:
- * **`@uniweb/schemas/editor-form`**.
- *
- * Conditional field visibility (a rich-schema feature) is likewise editor-only
- * and is not implemented here — the editor owns its own evaluator.
- */
-
-/**
- * Does a `data.schemas` entry look like a rich form schema?
- *
- * Rich schemas have an ordered `fields` array (composite arrays and
- * nested objects), distinct from simple keyed-object schemas used for
- * tagged blocks. Markers (any of):
- *   - `fields` is an array
- *   - `isComposite: true`
- *   - `childSchema` present
- *
- * @param {*} schema - Schema value to inspect.
- * @returns {boolean}
- */
-export function isRichSchema(schema) {
-  if (!schema || typeof schema !== 'object') return false
-  if (Array.isArray(schema.fields)) return true
-  if (schema.isComposite === true) return true
-  if (schema.childSchema && typeof schema.childSchema === 'object') return true
-  return false
-}