@uniweb/build 1.8.2 → 1.8.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -56,15 +56,15 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
-    "@uniweb/content-reader": "~1.5.4",
+    "@uniweb/content-reader": "~1.5.5",
     "@uniweb/projections": "~1.1.7",
+    "@uniweb/content-writer": "~1.3.0",
     "@uniweb/schemas": "~1.6.5",
-    "@uniweb/semantic-parser": "~1.12.2",
-    "@uniweb/theming": "~1.2.1",
-    "@uniweb/content-writer": "~1.3.0"
+    "@uniweb/semantic-parser": "~1.13.0",
+    "@uniweb/theming": "~1.2.1"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "~1.1.16"
+    "@uniweb/runtime": "~1.1.18"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -73,8 +73,8 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/core": "~1.4.1",
-    "@uniweb/runtime": "~1.1.16"
+    "@uniweb/core": "~1.4.3",
+    "@uniweb/runtime": "~1.1.18"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/site/content-collector.js

@@ -241,6 +241,22 @@ function detectVersions(folderNames) {
   return versions
 }
 
+/**
+ * An id an author wrote — a page's `id:` in `page.yml`, a section's in its frontmatter — as the
+ * string it names. YAML reads `id: 404` as a number, and an id is never one: a `page:404` link
+ * names the string, and a store holds a stable id as text.
+ *
+ * ⛔ *Until 2026-10-24 the parsed value was kept, so a page with `id: 404` matched no `page:`
+ * link, and a push sent its stable id as a number, which a backend refuses (measured that day:
+ * HTTP 400, "item.data.stable_id must be a string").*
+ *
+ * @param {*} value
+ * @returns {string|null} null for an id not written, or written empty
+ */
+export function authoredId(value) {
+  return value === undefined || value === null || value === '' ? null : String(value)
+}
+
 /**
  * `query:` — the shorthand for `fetch: { query }`, at every level that declares
  * data: a section's frontmatter, `page.yml`, `folder.yml` and `site.yml`, on the
@@ -1168,7 +1184,7 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
 
   // Stable ID for scroll targeting: frontmatter id > filename-derived > null
   // This ID is stable across reordering (unlike the positional id)
-  const stableId = frontmatterId || defaultStableId || null
+  const stableId = authoredId(frontmatterId) || defaultStableId || null
 
   const section = {
     id,
@@ -1434,7 +1450,7 @@ async function processPage(pagePath, pageName, siteRoot, { isIndex = false, pare
       page: {
         route,
         sourcePath: parentRoute === '/' ? `/${pageName}` : `${parentRoute}/${pageName}`,
-        id: pageConfig.id || null,
+        id: authoredId(pageConfig.id),
         isIndex,
         title: resolveDisplayTitle(pageConfig.title, pageName, null),
         description: pageConfig.description || '',
@@ -1460,7 +1476,7 @@ async function processPage(pagePath, pageName, siteRoot, { isIndex = false, pare
       page: {
         route,
         sourcePath: parentRoute === '/' ? `/${pageName}` : `${parentRoute}/${pageName}`,
-        id: pageConfig.id || null,
+        id: authoredId(pageConfig.id),
         isIndex,
         title: resolveDisplayTitle(pageConfig.title, pageName, null),
         description: pageConfig.description || '',
@@ -1731,7 +1747,7 @@ async function processPage(pagePath, pageName, siteRoot, { isIndex = false, pare
     page: {
       route,
       sourcePath, // Original folder-based path (for ancestor checking in navigation)
-      id: pageConfig.id || null, // Stable page ID for page: links (survives reorganization)
+      id: authoredId(pageConfig.id), // Stable page ID for page: links (survives reorganization)
       isIndex, // Marks this page as the index for its parent route
       title: resolveDisplayTitle(pageConfig.title, pageName, hierarchicalSections),
       description: pageConfig.description || '',

package/src/uwx/site.js

@@ -71,6 +71,7 @@ import {
   rootOrderConfig,
   composeLocalizedRoute,
   isValidSlugSegment,
+  authoredId,
 } from '../site/content-collector.js'
 import { refuseBinding, refuseUnder, refuseOutsideLanguage, warnDuplicateBindings } from '../site/data-fetcher.js'
 import { readLayoutFolder, layoutAreaRoute } from '../site/layout-folder.js'
@@ -312,7 +313,8 @@ function buildPageData(config, ctx) {
   // `localizeRouteSlugs`, once the whole tree is known. `mode` is the plain
   // delivery mode.
   const data = { slug: { [sourceLocale]: slug }, mode } // both required by the entity type
-  setIf(data, 'stable_id', config.id)
+  // An authored id is a string (`authoredId`): `id: 404` reads as a number, which a store refuses.
+  setIf(data, 'stable_id', authoredId(config.id) ?? undefined)
   setIf(data, 'title', localizeScalar(config.title, sourceLocale, translations))
   setIf(data, 'description', localizeScalar(config.description, sourceLocale, translations))
   setIf(data, 'label', localizeScalar(config.label, sourceLocale, translations))