@uniweb/build 0.68.0 → 0.69.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.68.0",
+  "version": "0.69.0",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -57,12 +57,12 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
-    "@uniweb/content-reader": "^1.2.6",
-    "@uniweb/semantic-parser": "^1.4.1",
-    "@uniweb/schemas": "^0.8.2",
+    "@uniweb/schemas": "^0.8.3",
     "@uniweb/content-writer": "^0.3.4",
-    "@uniweb/projections": "^0.7.7",
-    "@uniweb/theming": "^0.1.15"
+    "@uniweb/theming": "^0.1.15",
+    "@uniweb/content-reader": "^1.2.7",
+    "@uniweb/projections": "^0.7.8",
+    "@uniweb/semantic-parser": "^1.4.1"
   },
   "optionalDependencies": {
     "@uniweb/runtime": "^0.27.10"
@@ -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.27.10",
-    "@uniweb/core": "^0.32.2"
+    "@uniweb/core": "^0.32.2",
+    "@uniweb/runtime": "^0.27.10"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/site/content-collector.js

@@ -10,6 +10,7 @@
  *
  * Section frontmatter reserved properties:
  * - type: Component type (e.g., "Hero", "Features")
+ * - hidden: `true` makes the section a draft — left out of a published build, kept in dev
  * - props: Additional component props (merged with other params)
  * - fetch: The section's binding — names a query (query, as, where, sort, limit, current,
  *   prerender, detailPage); `query:` is its shorthand
@@ -31,7 +32,7 @@ import yaml from 'js-yaml'
 import { YAML_OPTIONS } from '../utils/yaml-schema.js'
 import { collectSectionAssets, mergeAssetCollections, collectConfigAssets } from './assets.js'
 import { collectSectionIcons, mergeIconCollections, buildIconManifest } from './icons.js'
-import { normalizeHideIn, dropUnpublishedPages } from './nav-visibility.js'
+import { normalizeHideIn, dropUnpublishedPages, dropHiddenSections } from './nav-visibility.js'
 import { parseFetchConfig, toFetchList } from './data-fetcher.js'
 import { resolveExtensionUrls } from './extension-urls.js'
 import { buildTheme, extractFoundationVars } from '../theme/index.js'
@@ -1009,7 +1010,17 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
 
   // `query`, `fetch` and `data` are never params: `query:` / `fetch:` declare the
   // section's own data, and a leftover `data:` is refused (`declaredFetch`).
-  const { type, preset, input, props, fetch, query, data, id: frontmatterId, ...params } = frontMatter
+  const { type, hidden, preset, input, props, fetch, query, data, id: frontmatterId, ...params } = frontMatter
+  // ⭐ `hidden: true` — a draft section, the page's meaning one level down: left out of a
+  // published build, kept by `uniweb dev`, and synced as the section's own `hidden`
+  // [Diego, 2026-09-28]. ⛔ Until then it was an ordinary param: the component received it
+  // and the section rendered everywhere.
+  if (hidden !== undefined && typeof hidden !== 'boolean') {
+    console.warn(
+      `[content-collector] ${relative(siteRoot, filePath)}: hidden: ${JSON.stringify(hidden)} is not true or false — ` +
+        `the section stays visible.`
+    )
+  }
   // ⛔ `preset:` and `input:` do nothing, so they are dropped with a warning rather than
   // handed to the component as params. Nothing ever read either [2026-09-27]: a preset is
   // a named set of params a section type's `meta.js` offers an editor, and a file writes
@@ -1058,6 +1069,7 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
     id,
     stableId,
     type: type || null,
+    ...(hidden === true ? { hidden: true } : {}),
     params: { ...params, ...props },
     content: proseMirrorContent,
     fetch: parseFetchConfig(resolvedFetch, relative(siteRoot, filePath), { level: 'section' }),
@@ -2790,10 +2802,11 @@ export async function collectSiteContent(sitePath, options = {}) {
       links: themeLinks
     },
     // Reachability axis: on the published build paths, drop `hidden` pages and
-    // their whole subtree (cascade). Dev keeps them so drafts stay previewable.
-    pages: dropUnpublished ? dropUnpublishedPages(pages) : pages,
+    // their whole subtree (cascade), and every `hidden` section with its children.
+    // Dev keeps them so drafts stay previewable.
+    pages: dropUnpublished ? dropUnpublishedPages(pages).map(withoutHiddenSections) : pages,
     // Layout area sets: { default: { header: page, footer: page, ... }, marketing: { ... } }
-    layouts,
+    layouts: dropUnpublished ? mapLayoutAreas(layouts, withoutHiddenSections) : 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".
@@ -2806,7 +2819,7 @@ export async function collectSiteContent(sitePath, options = {}) {
     // shell), and `uniweb dev` keeps the page previewable like any other draft.
     // No cascade to resolve: this slot is root-level only, so its own flag is
     // the only one that can apply.
-    notFound: dropUnpublished && notFound?.hidden ? null : notFound,
+    notFound: dropUnpublished ? (notFound?.hidden ? null : withoutHiddenSections(notFound)) : notFound,
     // Versioned scopes: route → { versions, latestId }
     versionedScopes: versionedScopesObj,
     assets: assetCollection.assets,
@@ -2817,6 +2830,25 @@ export async function collectSiteContent(sitePath, options = {}) {
   }
 }
 
+// A page (or a layout area) without its hidden sections — `dropHiddenSections`.
+function withoutHiddenSections(page) {
+  if (!page || !Array.isArray(page.sections)) return page
+  return { ...page, sections: dropHiddenSections(page.sections) }
+}
+
+// Apply `fn` to every area of every layout: `{ default: { header: page, … }, … }`.
+function mapLayoutAreas(layouts, fn) {
+  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,
+    ])
+  )
+}
+
 // Shared pure / IO helpers. Exported for testing AND reused by
 // @uniweb/build/uwx, the .uwx exporter, which re-walks the source rather
 // than the flattened collector output but reuses these primitives so

package/src/site/nav-visibility.js

@@ -1,6 +1,7 @@
 // Page-visibility helpers — the two orthogonal axes a page carries:
 //   • Reachability — `hidden: bool`. `true` = excluded from the PUBLISHED output
-//     entirely (see `dropUnpublishedPages`). Still previewable in `uniweb dev`.
+//     entirely (see `dropUnpublishedPages`, and `dropHiddenSections` for a section).
+//     Still previewable in `uniweb dev`.
 //   • Nav placement — `hideIn: string[]`. Which nav areas suppress the page while
 //     it IS routed (see `normalizeHideIn`). `['*']` = suppressed from every area.
 
@@ -67,3 +68,23 @@ export function dropUnpublishedPages(pages) {
   }
   return pages.filter((p) => !isUnpublished(p))
 }
+
+/**
+ * Drop hidden sections — the same reachability axis, one level down. A section with
+ * `hidden: true` in its frontmatter is a draft: left out of the PUBLISHED output together
+ * with its child sections, and kept by `uniweb dev` so it stays previewable. Applied where
+ * `dropUnpublishedPages` is, to a page's sections and a layout area's alike.
+ *
+ * @param {Array<object>} sections - collected sections (each may hold `subsections`)
+ * @returns {Array<object>} the sections without the hidden ones, at every depth
+ */
+export function dropHiddenSections(sections) {
+  if (!Array.isArray(sections)) return sections
+  return sections
+    .filter((section) => section?.hidden !== true)
+    .map((section) =>
+      Array.isArray(section.subsections) && section.subsections.length > 0
+        ? { ...section, subsections: dropHiddenSections(section.subsections) }
+        : section
+    )
+}

package/src/uwx/project-writer.js

@@ -41,7 +41,8 @@ export const DEFAULT_RESERVED_FRONTMATTER = new Set([
   'fetch',
   'data',
   'nest',
-  'hidden',
+  // ⛔ Not `hidden`, which was here from the start (2026-05-30) with no reason recorded: an
+  // editor toggles it, so a pull must carry the store's value into the file (2026-09-28).
 ])
 
 // js-yaml dump options shared by every config write, so output is byte-stable.

package/src/uwx/site-project.js

@@ -444,7 +444,7 @@ 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, params, content, insets, fetch, background, theme_override } = record || {}
+  const { type, stable_id, hidden, params, content, insets, fetch, background, theme_override } = 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,9 +452,18 @@ 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 frontmatter = {}
   if (type !== undefined) frontmatter.type = type
-  if (params && typeof params === 'object') Object.assign(frontmatter, params)
+  // ⭐ `hidden:` says what the store says: written for a hidden section, and removed from the
+  // file of a visible one — an editor toggles it [2026-09-28]. ⛔ Until then a pull dropped it,
+  // and the next push un-hid the section. A push before that day sent a file's `hidden:` inside
+  // `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

package/src/uwx/site.js

@@ -142,9 +142,9 @@ function stripCredentials(block, label) {
 }
 
 // page_sections and layout_sections share this content shape.
-// processMarkdownFile takes only type/props/fetch/query/data/id out of the
+// processMarkdownFile takes only type/hidden/props/fetch/query/data/id out of the
 // frontmatter (and drops preset/input), so `background:` and `theme:` stay
-// inside section.params — lift them into the entity type's dedicated fields.
+// inside section.params — and ride there on the wire too (`mapSectionData`).
 // The `type` a push sends for a section whose file names none — the Model requires one. A pull does
 // not write it back into a file that names none (`sectionRecordToFile`): absent, the foundation's
 // `defaultSection` renders it, which is not always `Content`.
@@ -302,19 +302,20 @@ function localizePageMeta(page, route, sourceLocale, translations) {
 
 function mapSectionData(section) {
   const params = { ...section.params }
-  const background = params.background
-  const themeOverride = params.theme
-  delete params.background
-  delete params.theme
-
   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.
   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', background)
-  setIf(data, 'theme_override', themeOverride)
+  setIf(data, 'background', params.background)
+  setIf(data, 'theme_override', params.theme)
   return data
 }