@uniweb/build 0.70.1 → 0.71.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.70.1",
+  "version": "0.71.0",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -58,14 +58,14 @@
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
     "@uniweb/content-writer": "^0.3.4",
-    "@uniweb/projections": "^0.7.9",
-    "@uniweb/content-reader": "^1.2.7",
-    "@uniweb/schemas": "^0.9.0",
     "@uniweb/semantic-parser": "^1.4.1",
-    "@uniweb/theming": "^0.1.16"
+    "@uniweb/projections": "^0.7.10",
+    "@uniweb/theming": "^0.1.16",
+    "@uniweb/content-reader": "^1.2.7",
+    "@uniweb/schemas": "^0.9.1"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "^0.28.0"
+    "@uniweb/runtime": "^0.28.1"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -74,8 +74,8 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/runtime": "^0.28.0",
-    "@uniweb/core": "^0.33.0"
+    "@uniweb/core": "^0.34.0",
+    "@uniweb/runtime": "^0.28.1"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/uwx/same-content.js

@@ -32,7 +32,7 @@ export function sameMarkdownDocument(markdown, doc) {
 }
 
 // A document without the attributes that only restate a default: an inset's `embedKind: 'visual'`,
-// which the parser writes and the pull's re-inlining leaves out (`reinlineInsets`) — so a body holding
+// which the parser writes and the pull's re-inlining (retired 2026-09-28) left out — so a body holding
 // an inset never compared as unchanged (measured 2026-09-26 on the `marketing` template's hero).
 function withoutDefaults(doc) {
   return JSON.parse(JSON.stringify(doc), (_, v) => {

package/src/uwx/site-diff.js

@@ -29,8 +29,8 @@
 // It needs TWO bases, and that is the non-obvious part.
 //
 // Our document and the backend's are not byte-comparable renderings of the same
-// unit: the backend's copy carries fields we don't emit (`params`,
-// `theme_override`, its own `$uuid`) and serializes in its own key order. So a hash
+// unit: the backend's copy carries fields we don't emit (its own `$uuid`, for
+// one) and serializes in its own key order. So a hash
 // taken on our side and one taken on theirs differ for a unit NEITHER side touched.
 // A single base therefore validates exactly one comparison and silently corrupts
 // the other — with a local-representation base every unit looks "changed

package/src/uwx/site-project.js

@@ -383,50 +383,12 @@ export function siteInfoToConfig({ document, siteRoot, backend = null, sourceLoc
 // Section records → section .md files
 // ---------------------------------------------------------------------------
 
-/**
- * Re-inline a section's extracted insets back into its ProseMirror content —
- * the exact inverse of content-collector's `extractInsets`. The producer pulls
- * each `![alt](@Component){params}` ref out of the body into an `insets[]` array
- * and leaves an `inset_placeholder` behind; content-writer only serializes
- * `inset_ref` nodes, so we restore them before serializing or the inset would
- * be reported as unmappable and dropped.
- *
- * @param {object} content - the section's ProseMirror document (placeholders in)
- * @param {Array} insets - `[{ refId, type, params, title, embedKind }]`
- * @returns {object} a content document with `inset_ref` nodes restored
- */
-function reinlineInsets(content, insets) {
-  if (!content || !Array.isArray(content.content) || !Array.isArray(insets) || insets.length === 0) {
-    return content
-  }
-  const byRef = new Map(insets.map((i) => [i.refId, i]))
-
-  const visit = (nodes) =>
-    nodes.map((node) => {
-      if (!node) return node
-      if (node.type === 'inset_placeholder') {
-        const inset = byRef.get(node.attrs?.refId)
-        if (!inset) return node // no match → leave the placeholder (the guard reports it)
-        const attrs = { component: inset.type, ...(inset.params || {}) }
-        if (inset.title != null) attrs.alt = inset.title
-        // `visual` is the extractor's default — omit it so the projected markdown
-        // doesn't gain a spurious `{embedKind=visual}` the source never had.
-        if (inset.embedKind && inset.embedKind !== 'visual') attrs.embedKind = inset.embedKind
-        return { type: 'inset_ref', attrs }
-      }
-      if (Array.isArray(node.content)) return { ...node, content: visit(node.content) }
-      return node
-    })
-
-  return { ...content, content: visit(content.content) }
-}
-
 /**
  * Project one section `$`-record (from `page_sections` / `layout_sections`) to a
  * section `.md` file — the inverse of site.js `mapSectionData`. Frontmatter is
- * `type` + the flat `params` + `background` / `theme` (`theme_override`) /
- * `fetch` / `id` (`stable_id`); the body is the section's
- * content (insets re-inlined) serialized to markdown. Idempotent.
+ * `type` + `hidden` + the flat `params` (`background` and `theme` among them) +
+ * the data declaration (`params.fetch`, else the `fetch` field) + `id` (`stable_id`);
+ * the body is the section's content serialized to markdown. Idempotent.
  *
  * Note: `$children` (a section's child sections) are NOT written here — the page
  * walk (`pageSectionsToFiles`) writes each to its own file and nests it under its
@@ -444,7 +406,10 @@ function reinlineInsets(content, insets) {
 export function sectionRecordToFile({ filePath, record, sourceLocale = LOCALIZED_FIELD_ASSUMPTION.defaultSourceLocale, collector, freeformRelPath, freeformCandidates = null, writeId = true, context = null }) {
   // ⛔ A stored `preset` or `input` is not written back: neither has an effect, and the build
   // would only warn about it (2026-09-27).
-  const { type, stable_id, hidden, params, content, insets, fetch, background, theme_override } = record || {}
+  // ⛔ No `background` / `theme_override` / `insets`: the site-content Model dropped all three
+  // (2026-09-28), with a stored background and theme copied into `params`. Until then a field
+  // filled in where `params` lacked the key, and a stored `insets[]` was re-inlined into the body.
+  const { type, stable_id, hidden, params, content, fetch } = record || {}
 
   // A localized `content` field unwraps to the source-locale doc for the body; its
   // target-locale structural maps are captured into the locales/ collector, and any
@@ -452,7 +417,7 @@ export function sectionRecordToFile({ filePath, record, sourceLocale = LOCALIZED
   // locales/freeform/. A bare doc (source-only / pre-localization) passes through.
   const sourceContent = unwrapLocalizedContent(content, sourceLocale, collector, freeformRelPath, freeformCandidates, context)
 
-  const { hidden: paramHidden, ...paramsRest } = params && typeof params === 'object' ? params : {}
+  const { hidden: paramHidden, fetch: paramFetch, ...paramsRest } = params && typeof params === 'object' ? params : {}
   const frontmatter = {}
   if (type !== undefined) frontmatter.type = type
   // ⭐ `hidden:` says what the store says: written for a hidden section, and removed from the
@@ -461,25 +426,22 @@ export function sectionRecordToFile({ filePath, record, sourceLocale = LOCALIZED
   // `params`, so one stored there counts when the field is absent.
   frontmatter.hidden = (typeof hidden === 'boolean' ? hidden : paramHidden === true) ? true : undefined
   Object.assign(frontmatter, paramsRest)
-  // ⚠️ A stored `background` / `theme_override` field wins over the same key in `params` while
-  // one is stored: an editor may still write the fields rather than `params` (2026-09-28;
-  // uwx-format.md § A page section's fields, Order).
-  if (background !== undefined) frontmatter.background = background
-  if (theme_override !== undefined) frontmatter.theme = theme_override
   // Invert the build's resolution rather than copy it — see fetch-shapes.js. A new
   // file gets `query:` for a declaration of names alone; a section that declares
   // its data locally keeps it (`writeSectionFile`, the declaration keys).
-  if (fetch !== undefined) {
-    const { key, value } = authorableDeclaration(fetch)
+  // ⭐ From `params.fetch` when present — where a section carries its data since 2026-09-28 —
+  // else the stored field.
+  const ownFetch = paramFetch !== undefined ? paramFetch : fetch
+  if (ownFetch !== undefined) {
+    const { key, value } = authorableDeclaration(ownFetch)
     frontmatter[key] = value
   }
   // `id:` only where the file's name does not already give it (`writeId`, `pageSectionsToFiles`).
   if (stable_id !== undefined && writeId) frontmatter.id = stable_id
 
-  const body = insets ? reinlineInsets(sourceContent, insets) : sourceContent
   // ⛔ Not `type: Content` into a file that names no type: it is what the push sent for it, and
   // absent, the foundation's `defaultSection` renders it. Until 2026-09-26 a pull wrote it back.
-  return writeSectionFile({ filePath, content: body, params: frontmatter, implied: { type: FILLED_SECTION_TYPE } })
+  return writeSectionFile({ filePath, content: sourceContent, params: frontmatter, implied: { type: FILLED_SECTION_TYPE } })
 }
 
 // ---------------------------------------------------------------------------

package/src/uwx/site.js

@@ -302,6 +302,10 @@ function localizePageMeta(page, route, sourceLocale, translations) {
 
 function mapSectionData(section) {
   const params = { ...section.params }
+  // ⭐ The section's own data rides in `params.fetch` [Diego, 2026-09-28] — nothing on a store's
+  // side acts on it by name. ⚠️ Also sent as the `fetch` field it had until then, until an
+  // editor's reader looks in `params.fetch` (uwx-format.md § A page section's fields).
+  if (section.fetch) params.fetch = section.fetch
   const data = { type: section.type || FILLED_SECTION_TYPE } // entity type requires `type`
   setIf(data, 'stable_id', section.stableId ?? undefined)
   // ⭐ A draft section — the store's own `hidden`, which an editor also writes [2026-09-28].