@uniweb/build 0.70.0 → 0.71.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.70.0",
+  "version": "0.71.0",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -57,15 +57,15 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
-    "@uniweb/content-reader": "^1.2.7",
     "@uniweb/content-writer": "^0.3.4",
     "@uniweb/semantic-parser": "^1.4.1",
-    "@uniweb/schemas": "^0.9.0",
-    "@uniweb/projections": "^0.7.9",
-    "@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/core": "^0.33.0",
-    "@uniweb/runtime": "^0.28.0"
+    "@uniweb/core": "^0.34.0",
+    "@uniweb/runtime": "^0.28.1"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/site/content-collector.js

@@ -749,8 +749,13 @@ function prettifySlug(slug) {
  *
  * A node with no sections of its own (a group/container node, a redirect stub)
  * has nothing to humanize from, so it shows the identifier the author actually
- * wrote — `v1` stays `v1`. A node with content falls back to its opening H1,
- * and only then to a prettified slug.
+ * wrote — `v1` stays `v1`. A node with content falls back to the opening H1 of
+ * its first section that publishes, and only then to a prettified slug.
+ *
+ * ⭐ "That publishes": a `hidden: true` section is a draft, so its heading never
+ * titles the page — in dev as in a published build, so the title does not change
+ * between them, and as a backend's publish does [2026-09-28]. A node whose sections
+ * are all hidden takes the prettified slug.
  *
  * The runtime has no fallback of its own: an empty title renders empty. The
  * fill belongs here, at the producer, because `title` also feeds `<title>`,
@@ -765,7 +770,8 @@ function prettifySlug(slug) {
 function resolveDisplayTitle(declaredTitle, segment, sections) {
   if (declaredTitle) return declaredTitle
   if (!sections?.length) return segment
-  return extractH1(sections[0]?.content) || prettifySlug(segment)
+  const first = sections.find((section) => section?.hidden !== true)
+  return extractH1(first?.content) || prettifySlug(segment)
 }
 
 // ⭐ The rule now lives in `utils/numeric-prefix.js` — `records/folder.yml` needs the
@@ -957,7 +963,9 @@ async function processFileAsPage(filePath, fileName, siteRoot, parentRoute) {
       version: null,
       versionMeta: null,
       versionScope: null,
-      hidden: false,
+      // The file IS the page, so its `hidden: true` drafts the page — left out of a published
+      // build, kept in dev — rather than leaving a page with no section (2026-09-28).
+      hidden: section.hidden === true,
       hideIn: [],
       layout: {},
       seo: {
@@ -2806,7 +2814,7 @@ export async function collectSiteContent(sitePath, options = {}) {
     // Dev keeps them so drafts stay previewable.
     pages: dropUnpublished ? dropUnpublishedPages(pages).map(withoutHiddenSections) : pages,
     // Layout area sets: { default: { header: page, footer: page, ... }, marketing: { ... } }
-    layouts: dropUnpublished ? mapLayoutAreas(layouts, withoutHiddenSections) : layouts,
+    layouts: dropUnpublished ? withoutHiddenAreas(layouts) : layouts,
     // ⭐ THE SAME REACHABILITY AXIS, for the 404 slot. `hidden: true` means DRAFT —
     // "excluded from the published site" (`docs/reference/page-configuration.md`);
     // `hideIn: ['*']` is the control for "routed but in no nav".
@@ -2836,16 +2844,23 @@ function withoutHiddenSections(page) {
   return { ...page, sections: dropHiddenSections(page.sections) }
 }
 
-// Apply `fn` to every area of every layout: `{ default: { header: page, … }, … }`.
-function mapLayoutAreas(layouts, fn) {
+// Every layout's areas without their hidden sections — and without an area whose sections
+// were all hidden: drafting every section of an area drafts the area, so a layout gets no area
+// there rather than an empty one (a backend's publish does the same).
+function withoutHiddenAreas(layouts) {
   if (!layouts || typeof layouts !== 'object') return layouts
   return Object.fromEntries(
-    Object.entries(layouts).map(([name, areas]) => [
-      name,
-      areas && typeof areas === 'object'
-        ? Object.fromEntries(Object.entries(areas).map(([area, page]) => [area, fn(page)]))
-        : areas,
-    ])
+    Object.entries(layouts).map(([name, areas]) => {
+      if (!areas || typeof areas !== 'object') return [name, areas]
+      const kept = {}
+      for (const [area, page] of Object.entries(areas)) {
+        const shown = withoutHiddenSections(page)
+        const hadSections = Array.isArray(page?.sections) && page.sections.length > 0
+        if (hadSections && shown.sections.length === 0) continue
+        kept[area] = shown
+      }
+      return [name, kept]
+    })
   )
 }
 

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,20 +302,25 @@ 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].
   if (section.hidden === true) data.hidden = true
   // No `preset` or `input`: nothing read either, and the collector drops them (2026-09-27).
-  // ⭐ `background` and `theme` stay IN `params` [Diego, 2026-09-28] — where the runtime reads
-  // them, and where a section stores them from now on. ⚠️ Also sent as the two fields they had
-  // until today, until every reader of a stored section reads `params`; a pull prefers a
-  // stored field meanwhile (`sectionRecordToFile`). uwx-format.md § A page section's fields.
+  // ⭐ `background` and `theme` ride IN `params` [Diego, 2026-09-28] — where the runtime reads
+  // them, and where a section stores them. ⛔ Not also as the `background` / `theme_override`
+  // fields, as build 0.69 sent them: every reader of a stored section reads `params` — a publish
+  // carries `params` whole, and the app reads a stored field first, then `params` — so nothing
+  // needs them, and a push that stops sending them lets a backend retire them without refusing
+  // it. A pull still prefers a stored field while one exists (`sectionRecordToFile`).
+  // uwx-format.md § A page section's fields, Order.
   if (Object.keys(params).length > 0) data.params = params
   data.content = section.content // leaf insets in it as written — no `insets` field since 2026-09-27
   setIf(data, 'fetch', section.fetch ?? undefined)
-  setIf(data, 'background', params.background)
-  setIf(data, 'theme_override', params.theme)
   return data
 }