@uniweb/build 0.67.0 → 0.68.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.67.0",
+  "version": "0.68.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.5",
+    "@uniweb/content-reader": "^1.2.6",
     "@uniweb/semantic-parser": "^1.4.1",
-    "@uniweb/projections": "^0.7.7",
+    "@uniweb/schemas": "^0.8.2",
     "@uniweb/content-writer": "^0.3.4",
-    "@uniweb/theming": "^0.1.15",
-    "@uniweb/schemas": "^0.8.1"
+    "@uniweb/projections": "^0.7.7",
+    "@uniweb/theming": "^0.1.15"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "^0.27.9"
+    "@uniweb/runtime": "^0.27.10"
   },
   "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.32.1",
-    "@uniweb/runtime": "^0.27.9"
+    "@uniweb/runtime": "^0.27.10",
+    "@uniweb/core": "^0.32.2"
   },
   "peerDependenciesMeta": {
     "vite": {

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,6 @@
  *
  * Section frontmatter reserved properties:
  * - type: Component type (e.g., "Hero", "Features")
- * - preset: Preset configuration name
- * - input: Input field mapping
  * - 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
@@ -1011,14 +1009,27 @@ 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`).
-  // ⭐ Nor is `grid`: a section key framework reserves for the layout of the section's
-  // child sections — `3` or `'40/60'` [Diego, 2026-09-27] — laid out by kit's
-  // `ChildGrid` from `block.grid`. A component offers layouts in `meta.js`
-  // `children.grid`; it never receives the choice as a param.
-  const { type, preset, input, props, fetch, query, data, grid, id: frontmatterId, ...params } = frontMatter
-  if (grid !== undefined && !parseGrid(grid)) {
+  const { type, preset, input, props, fetch, query, data, id: frontmatterId, ...params } = frontMatter
+  // ⛔ `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)}: grid: ${JSON.stringify(grid)} is not a layout — ` +
+      `[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.
+  // `@uniweb/core` lifts it to `block.grid` (a component never receives it as a param)
+  // and kit's `ChildGrid` lays the children out. ⛔ For a few hours on 2026-09-27 it was
+  // taken out of the params into a field the sync wire could not carry.
+  if (params.grid !== undefined && !parseGrid(params.grid)) {
+    console.warn(
+      `[content-collector] ${relative(siteRoot, filePath)}: grid: ${JSON.stringify(params.grid)} is not a layout — ` +
         `write a column count (grid: 3) or relative widths (grid: '40/60'). The component's own layout applies.`
     )
   }
@@ -1047,12 +1058,9 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
     id,
     stableId,
     type: type || null,
-    preset,
-    input,
     params: { ...params, ...props },
     content: proseMirrorContent,
     fetch: parseFetchConfig(resolvedFetch, relative(siteRoot, filePath), { level: 'section' }),
-    ...(grid !== undefined ? { grid } : {}),
     subsections: []
   }
 

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, 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
@@ -455,8 +457,6 @@ export function sectionRecordToFile({ filePath, record, sourceLocale = LOCALIZED
   if (params && typeof params === 'object') Object.assign(frontmatter, params)
   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,8 +142,8 @@ 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
+// processMarkdownFile takes only type/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.
 // 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
@@ -309,23 +309,12 @@ function mapSectionData(section) {
 
   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)
+  // No `preset` or `input`: nothing read either, and the collector drops them (2026-09-27).
   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)
-  // ⛔ `grid` — the section's layout for its children — is NOT SENT YET: it is a new
-  // field, and the store refuses a whole push carrying a key it has not declared
-  // (kb/framework/build/uwx-format.md § A page section's fields). It goes on the wire
-  // once backend declares it; until then a static build renders it and the file keeps it.
-  if (section.grid !== undefined) {
-    console.warn(
-      `[uwx] section ${section.stableId ?? section.id}: grid: ${JSON.stringify(section.grid)} is not sent — ` +
-        `the backend does not store a section's grid yet. It renders on a static build; the file keeps it.`
-    )
-  }
   return data
 }