@uniweb/build 0.74.1 → 0.74.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.74.1",
+  "version": "0.74.3",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -59,13 +59,13 @@
     "yaml": "^2.5.0",
     "@uniweb/content-reader": "^1.2.8",
     "@uniweb/content-writer": "^0.3.4",
+    "@uniweb/schemas": "^0.10.1",
     "@uniweb/projections": "^0.7.11",
-    "@uniweb/semantic-parser": "^1.5.1",
-    "@uniweb/schemas": "^0.10.0",
-    "@uniweb/theming": "^0.2.0"
+    "@uniweb/theming": "^0.2.0",
+    "@uniweb/semantic-parser": "^1.5.1"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "^0.28.5"
+    "@uniweb/runtime": "^0.28.6"
   },
   "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.35.0",
-    "@uniweb/runtime": "^0.28.5"
+    "@uniweb/core": "^0.35.1",
+    "@uniweb/runtime": "^0.28.6"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/prerender.js

@@ -279,10 +279,11 @@ export async function executeAllFetches(siteContent, siteDir, onProgress, locale
  *
  * Emitting the canonical route raw sent a reader who asked for `/fr/<container>`
  * to the DEFAULT-locale page — a language switch they never asked for, from a
- * URL that was correct. The runtime's copy of this redirect (PageRenderer.jsx)
- * had the identical bug and was fixed first; this is its twin, and the two must
- * agree or a container behaves differently on a cold load than on an in-app
- * navigation.
+ * URL that was correct. The in-app redirect had the identical bug and was fixed
+ * first. ⭐ Since 2026-09-30 that one is `resolveRoute`'s (`@uniweb/core/resolve-route`,
+ * `localeUrl`); this is the static twin of its destination — the same prefix and
+ * translated slug, with the deployment base this pass writes under — and the two
+ * must agree or a container behaves differently on a cold load than in the app.
  *
  * The DECISION to redirect stays canonical (`target !== page.route`) — only the
  * destination is localized. Comparing a localized destination against a
@@ -1024,9 +1025,10 @@ export async function prerenderSite(siteDir, options = {}) {
         continue
       }
 
-      // Content-less containers: auto-redirect to first descendant with content.
-      // Mirrors the runtime's auto-redirect in PageRenderer.jsx so the redirect
-      // works without JS (via <meta http-equiv="refresh">).
+      // Content-less containers: auto-redirect to first descendant with content —
+      // `getNavigableRoute()`, which is `resolveRoute`'s landing rule
+      // (`@uniweb/core/resolve-route`), so the stub goes where the app would.
+      // A stub so the redirect works without JS (via <meta http-equiv="refresh">).
       if (!page.hasContent()) {
         const target = page.getNavigableRoute()
         if (target && target !== page.route) {

package/src/uwx/data-schema.js

@@ -112,8 +112,8 @@ export function isContentBodyField(field) {
  * @param {(ref: string) => string} [opts.resolveOptions] - maps an `options`
  *   (item_ref) ref to its full `@org/model/<section>` path. Falls back to
  *   `resolveName` (model only) when not supplied.
- * @returns {Object} the declaration (`{ name, label?, description?, source_locale?,
- *          linkable?, sections }`).
+ * @returns {Object} the declaration (`{ name, label?, plural?, description?,
+ *          source_locale?, linkable?, sections }`).
  */
 export function toDataSchemaDeclaration(normalized, { name, resolveName, resolveOptions } = {}) {
   if (!name) throw new Error('toDataSchemaDeclaration: a registry name is required')
@@ -136,19 +136,23 @@ export function toDataSchemaDeclaration(normalized, { name, resolveName, resolve
 
   const decl = { name }
   if (normalized.label) decl.label = normalized.label
+  if (normalized.plural) decl.plural = normalized.plural
   if (normalized.description) decl.description = normalized.description
   if (normalized.sourceLocale) decl.source_locale = normalized.sourceLocale
   // ⛔ No `creatable_by`: retired 2026-09-23 — Models are open, and `@uniweb/schemas`
   // refuses the key. (It was emitted here when authored.)
 
   // `linkable` — AUTHORED ONLY (2026-09-27 [Diego]). A model is linkable unless it says
-  // `linkable: false` (omitted ⇒ true), with or without a brief: only `linkable: false`
-  // keeps its entries out of references and out of a site's folder. A reference to a
-  // model with no brief carries no card, and that is not a reason to refuse one.
+  // `linkable: false` (omitted ⇒ true), with or without a brief. `linkable: false` keeps
+  // its entries out of references and out of a site's folder, and nothing else keeps them
+  // out of a folder. Whether a reference field may point at a model with no brief — no
+  // card to show — is the host's to decide, and nothing here derives it.
   //
   // ⛔ Until then a brief-less model was emitted `linkable: false` and `linkable: true`
   // on one was refused, on the reasoning that a reference would have no card to show —
   // which kept its records out of every site's folder.
+  // ⛔ And until 2026-09-30 this said a missing card "is not a reason to refuse" a
+  // reference, which read as a promise that one is accepted. A backend refuses it.
   if (normalized.linkable === false) decl.linkable = false
 
   decl.sections = sections

package/src/uwx/site-project.js

@@ -839,7 +839,7 @@ function writePagesTree(pages, pagesDir, sourceLocale, report, ctx, routePrefix
 // ⚖️ A pull adds and changes these, and never removes one: a page pushed by a CLI from before carries
 // none, and reading that as "none" would delete what the author wrote.
 function pageSlugToYml(record, canon, existing, sourceLocale, ctx) {
-  if (record.is_dynamic) return null
+  if (record.is_dynamic) return dynamicOwnSlug(record, existing, sourceLocale)
   const targets = localizedTargets(record.slug, sourceLocale)
   const own = isPlainRecord(existing?.slug)
   if (!own && ctx.routes?.siteMap && !record.is_index) {
@@ -851,6 +851,20 @@ function pageSlugToYml(record, canon, existing, sourceLocale, ctx) {
   return own && stableJson(next) === stableJson(existing.slug) ? null : next
 }
 
+// A parametric page's folder is named by its param (`pageDirName`), so its OWN slug — where a page
+// made in an app gives it one of its own (`slug: detail`, `param_name: id`) — has no other place on
+// disk. It is kept in `page.yml` as a plain string, which the build never reads for a route (only a
+// per-language map names URL segments) and the push sends back as the page's slug. A string written
+// here before is rewritten to the stored slug, so it is never left stale.
+// ⛔ Until 2026-09-30 a pull dropped it, and the next push sent the param in its place: an authored
+// value lost on a round trip (`uwx-format.md` § THE ROUND-TRIP LAW).
+function dynamicOwnSlug(record, existing, sourceLocale) {
+  const own = unwrapLocalized(record.slug, sourceLocale)
+  if (typeof own !== 'string' || !own || own === '...path') return null
+  if (own !== (record.param_name || own)) return own
+  return typeof existing?.slug === 'string' ? own : null
+}
+
 // The locales of a pulled localized `slug` other than the source one.
 function localizedTargets(slug, sourceLocale) {
   if (!isPlainRecord(slug)) return {}

package/src/uwx/site.js

@@ -224,7 +224,15 @@ function localizeRouteSlugs(pages, siteYml, sourceLocale) {
 export function buildRouteOf(record, parentRoute, sourceLocale) {
   if (record?.is_index) return parentRoute
   const slug = unwrapLocalized(record?.slug, sourceLocale)
-  const segment = record?.is_dynamic ? (slug === CATCH_ALL_MARKER ? ':path*' : `:${slug}`) : slug
+  // A parametric page's segment is its PARAM — the name the pull gives its folder, `[param_name]`
+  // (`site-project.js::pageDirName`), which is the route the build then reads. A page pushed from
+  // files has one word for both; a page made in an app may not (`slug: detail`, `param_name: id`).
+  // ⛔ Until 2026-09-30 this used the slug, so such a page was addressed `/…/:detail` while its
+  // folder built `/…/:id`, and its translated title and description were filed under a route no
+  // build reads.
+  const segment = record?.is_dynamic
+    ? (slug === CATCH_ALL_MARKER ? ':path*' : `:${record.param_name || slug}`)
+    : slug
   return parentRoute === '/' ? `/${segment}` : `${parentRoute}/${segment}`
 }
 
@@ -783,6 +791,12 @@ async function walkPagesNested(ctx, dirPath, parentSlugPath, inheritedMode, pare
     // A page's own localized URL segments, for `localizeRouteSlugs` — under a symbol, so they
     // are never serialized as a field of the record.
     if (!dyn && isPlainRecord(f.config?.slug)) record[AUTHORED_SLUG] = f.config.slug
+    // A parametric page's OWN slug, where it is not its param — a page made in an app — is kept in
+    // its page.yml by the pull as a plain string (`site-project.js::dynamicOwnSlug`), since its folder
+    // is named by its param. The route, the folder and the page's identity stay the param's.
+    if (dyn && dyn[1] !== CATCH_ALL_MARKER && typeof f.config?.slug === 'string' && f.config.slug) {
+      record.slug = { ...record.slug, [sourceLocale]: f.config.slug }
+    }
 
     if (mode === 'page') {
       const sections = await collectPageSectionsNested(f.path, siteRoot, f.config)