@uniweb/build 0.67.1 → 0.69.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.67.1",
+  "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.5",
+    "@uniweb/schemas": "^0.8.3",
     "@uniweb/content-writer": "^0.3.4",
-    "@uniweb/schemas": "^0.8.1",
-    "@uniweb/semantic-parser": "^1.4.1",
-    "@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"

package/src/schema.js

@@ -17,6 +17,7 @@ import { isFontVar } from '@uniweb/theming'
 import { join, dirname, extname, basename } from 'node:path'
 import { pathToFileURL } from 'node:url'
 import { describeChildren, describeVisuals } from '@uniweb/schemas/component'
+import { SECTION_PARAMS } from '@uniweb/schemas/section'
 import { collectSchemaRefs, buildDataSchemaMap, ownSchemaRefs } from './resolve-data-schema.js'
 import {
   composeSupports,
@@ -957,13 +958,17 @@ export function reportPlacementDeclarations(components) {
           `provides renders "Component not found".`
       )
     }
-    // `grid` is a section key framework reserves for the layout of a section's children,
-    // so a param by that name never receives what an author writes as `grid:`.
-    if (entry.params && typeof entry.params === 'object' && Object.hasOwn(entry.params, 'grid')) {
+    // A name framework reserves in a section's params whose value the component never
+    // receives — `component: false` in `@uniweb/schemas/section`, as `grid` is.
+    const params = entry.params && typeof entry.params === 'object' ? entry.params : {}
+    for (const [param, reserved] of Object.entries(SECTION_PARAMS)) {
+      if (reserved.component || !Object.hasOwn(params, param)) continue
       console.warn(
-        `Warning: ${name} (meta.js): a param named "grid" never receives the author's grid: — it is a section ` +
-          `key reserved for the layout of child sections. Offer layouts with children: { grid: [...] } and ` +
-          `lay the children out with kit's ChildGrid, or rename the param.`
+        `Warning: ${name} (meta.js): a param named "${param}" never receives the author's ${param}: — framework ` +
+          `reserves it in a section's params (@uniweb/schemas/section). Rename the param.` +
+          (param === 'grid'
+            ? ` To offer layouts for the child sections, declare children: { grid: [...] } and lay them out with kit's ChildGrid.`
+            : '')
       )
     }
   }

package/src/site/content-collector.js

@@ -10,8 +10,7 @@
  *
  * Section frontmatter reserved properties:
  * - type: Component type (e.g., "Hero", "Features")
- * - preset: Preset configuration name
- * - input: Input field mapping
+ * - 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
@@ -33,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'
@@ -1011,7 +1010,28 @@ 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
+  // the params themselves (`uniweb add section <Type> --starter --preset <name>` writes them).
+  for (const [key, value] of [['preset', preset], ['input', input]]) {
+    if (value === undefined) continue
+    console.warn(
+      `[content-collector] ${relative(siteRoot, filePath)}: ${key}: ${JSON.stringify(value)} has no effect and is ignored` +
+        (key === 'preset' ? ' — write the preset’s params in the frontmatter instead.' : '.')
+    )
+  }
   // ⭐ `grid` — the layout of the section's child sections, `3` or `'40/60'` [Diego,
   // 2026-09-27] — is a name framework reserves, and it stays in the params like
   // `background`: that is where it is stored and synced, with no field of its own.
@@ -1049,8 +1069,7 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
     id,
     stableId,
     type: type || null,
-    preset,
-    input,
+    ...(hidden === true ? { hidden: true } : {}),
     params: { ...params, ...props },
     content: proseMirrorContent,
     fetch: parseFetchConfig(resolvedFetch, relative(siteRoot, filePath), { level: 'section' }),
@@ -2783,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".
@@ -2799,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,
@@ -2810,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

@@ -425,7 +425,7 @@ function reinlineInsets(content, insets) {
  * 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`) /
- * `preset` / `input` / `fetch` / `id` (`stable_id`); the body is the section's
+ * `fetch` / `id` (`stable_id`); the body is the section's
  * content (insets re-inlined) serialized to markdown. Idempotent.
  *
  * Note: `$children` (a section's child sections) are NOT written here — the page
@@ -442,7 +442,9 @@ function reinlineInsets(content, insets) {
  * @returns {'updated'|'unchanged'}
  */
 export function sectionRecordToFile({ filePath, record, sourceLocale = LOCALIZED_FIELD_ASSUMPTION.defaultSourceLocale, collector, freeformRelPath, freeformCandidates = null, writeId = true, context = null }) {
-  const { type, stable_id, preset, input, params, content, insets, fetch, background, theme_override } = record || {}
+  // ⛔ 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 || {}
 
   // 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
@@ -450,13 +452,20 @@ 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
-  if (preset !== undefined) frontmatter.preset = preset
-  if (input !== undefined) frontmatter.input = input
   // 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).

package/src/uwx/site.js

@@ -142,9 +142,9 @@ function stripCredentials(block, label) {
 }
 
 // page_sections and layout_sections share this content shape.
-// processMarkdownFile only destructures type/component/preset/input/props/
-// fetch/data/id out of frontmatter, so `background:` and `theme:` stay
-// inside section.params — lift them into the entity type's dedicated fields.
+// 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 — 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,20 +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)
-  setIf(data, 'preset', section.preset ?? undefined)
-  setIf(data, 'input', section.input ?? 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
 }