@uniweb/core 0.29.0 → 0.29.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/core",
-  "version": "0.29.0",
+  "version": "0.29.2",
   "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
   "type": "module",
   "exports": {
@@ -46,8 +46,8 @@
     "vitest": "^4.1.7"
   },
   "dependencies": {
-    "@uniweb/theming": "^0.1.15",
-    "@uniweb/semantic-parser": "^1.4.0"
+    "@uniweb/semantic-parser": "^1.4.0",
+    "@uniweb/theming": "^0.1.15"
   },
   "scripts": {
     "test": "vitest run"

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/data-paths.js

@@ -13,7 +13,8 @@
  * (`data-fetcher.js`), core injected the per-record default
  * (`fetch-config.js applyDeferredDetail`), core gated locale-prefixing on it
  * (`fetch-config.js localizeConfig`), the dev server matched it with a regex
- * (`build/src/site/plugin.js`), and kit's `useEntityDetail` requested it.
+ * (`build/src/site/plugin.js`), and kit's `useEntityDetail` — `useWholeRecord`
+ * since 2026-09-14 — requested it.
  *
  * They drifted. `useEntityDetail` was edited to `/_data/` on its own and
  * nothing else followed, so a public documented hook requested a URL that
@@ -73,12 +74,11 @@ export function queryDataUrl(name) {
  * URL of one record's full payload — every field, including deferred ones.
  * Emitted per record only when the query declares `deferred:`.
  *
- * Takes either a concrete slug (kit's `useEntityDetail`, which holds a
- * record) or the literal placeholder `{slug}` (core's `applyDeferredDetail`,
- * which builds a pattern that `substitutePlaceholders` resolves later
- * against the dynamic-route param). Both are plain interpolation; this
- * function does not encode, matching the behavior of the call sites it
- * replaced.
+ * Takes either a concrete slug — a caller holding the record — or the literal
+ * placeholder `{slug}` (core's `applyDeferredDetail`, which builds a pattern
+ * that `substitutePlaceholders` resolves later against the dynamic-route
+ * param). Both are plain interpolation; this function does not encode,
+ * matching the behavior of the call sites it replaced.
  *
  * @param {string} query - The query name.
  * @param {string} slug - A record slug, or a `{param}` placeholder.

package/src/detail-url.js

@@ -45,7 +45,7 @@ function paramContext(paramName, paramValue, record) {
   // detail URL was `/data/articles/{slug}.json`, a guaranteed 404, on every
   // template page with `deferred:` fields (measured 2026-09-04). When the caller
   // holds the record — the entity store does (it matched it), and so does
-  // `useEntityDetail` — its slug fills the name the FILE was written under. A
+  // kit's `useWholeRecord` — its slug fills the name the FILE was written under. A
   // caller with no record in hand leaves `{slug}` literal rather than guessing
   // the capture is one: a visibly unresolved address beats a plausible wrong one.
   const handle = recordHandle(record)

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/website.js

@@ -908,7 +908,7 @@ export default class Website {
    *
    * This is what fills a delivered record's `$route` (`EntityStore`) when its fetch picks
    * no `detailPage`, and how a caller outside a parametric page learns which record field
-   * the page's URL is built on: `kit`'s `useEntityDetail` asks it so a hover card and the
+   * the page's URL is built on: `kit`'s `useWholeRecord` asks it so a hover card and the
    * page it links to address the record by the SAME field.
    *
    * ⛔ Replaces `detailTemplateFor(name)` (2026-09-14), which matched a binding key OR a