@uniweb/build 0.15.6 → 0.15.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.15.6",
+  "version": "0.15.8",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -59,14 +59,14 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.33.2",
     "yaml": "^2.5.0",
-    "@uniweb/projections": "0.1.1",
     "@uniweb/theming": "0.1.14",
-    "@uniweb/content-writer": "0.2.8"
+    "@uniweb/projections": "0.1.2",
+    "@uniweb/content-writer": "0.2.9"
   },
   "optionalDependencies": {
-    "@uniweb/content-reader": "1.1.16",
-    "@uniweb/runtime": "0.8.37",
-    "@uniweb/schemas": "0.2.4"
+    "@uniweb/content-reader": "1.1.17",
+    "@uniweb/schemas": "0.2.4",
+    "@uniweb/runtime": "0.8.38"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -75,7 +75,7 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/core": "0.7.30"
+    "@uniweb/core": "0.7.31"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/site/content-collector.js

@@ -527,6 +527,38 @@ function prettifySlug(slug) {
     .join(' ')
 }
 
+/**
+ * Resolve a page's display title when the author declared none.
+ *
+ * Keys on whether the node has content of its own — the property the page
+ * payload already carries as `hasContent` — and deliberately NOT on which
+ * config file declared the folder. `folder.yml` vs `page.yml` decides how a
+ * directory's markdown is read; it says nothing about what the node IS, and
+ * keying on it made a content-less group node's name depend on how it happened
+ * to be declared. A `page.yml` folder with no markdown is the same group node
+ * as a `folder.yml` one and renders identically in nav.
+ *
+ * A node with no sections of its own (a group/container node, a redirect stub)
+ * has nothing to humanize from, so it shows the identifier the author actually
+ * wrote — `v1` stays `v1`. A node with content falls back to its opening H1,
+ * and only then to a prettified slug.
+ *
+ * The runtime has no fallback of its own: an empty title renders empty. The
+ * fill belongs here, at the producer, because `title` also feeds `<title>`,
+ * `og:title`, `llms.txt` and the search index — a fix applied at render would
+ * repair the nav row and leave the rest blank.
+ *
+ * @param {string|undefined} declaredTitle - Author-supplied title, if any
+ * @param {string} segment - Route segment (directory or file name)
+ * @param {Array|null} sections - The node's own sections, if any
+ * @returns {string}
+ */
+function resolveDisplayTitle(declaredTitle, segment, sections) {
+  if (declaredTitle) return declaredTitle
+  if (!sections?.length) return segment
+  return extractH1(sections[0]?.content) || prettifySlug(segment)
+}
+
 function parseNumericPrefix(filename) {
   const match = filename.match(/^(\d+(?:\.\d+)*)-?(.*)$/)
   if (match) {
@@ -1031,7 +1063,7 @@ async function processPage(pagePath, pageName, siteRoot, { isIndex = false, pare
         sourcePath: parentRoute === '/' ? `/${pageName}` : `${parentRoute}/${pageName}`,
         id: pageConfig.id || null,
         isIndex,
-        title: pageConfig.title || prettifySlug(pageName),
+        title: resolveDisplayTitle(pageConfig.title, pageName, null),
         description: pageConfig.description || '',
         label: pageConfig.label || null,
         hidden: pageConfig.hidden || false,
@@ -1057,7 +1089,7 @@ async function processPage(pagePath, pageName, siteRoot, { isIndex = false, pare
         sourcePath: parentRoute === '/' ? `/${pageName}` : `${parentRoute}/${pageName}`,
         id: pageConfig.id || null,
         isIndex,
-        title: pageConfig.title || prettifySlug(pageName),
+        title: resolveDisplayTitle(pageConfig.title, pageName, null),
         description: pageConfig.description || '',
         label: pageConfig.label || null,
         hidden: pageConfig.hidden || false,
@@ -1318,7 +1350,7 @@ async function processPage(pagePath, pageName, siteRoot, { isIndex = false, pare
       sourcePath, // Original folder-based path (for ancestor checking in navigation)
       id: pageConfig.id || null, // Stable page ID for page: links (survives reorganization)
       isIndex, // Marks this page as the index for its parent route
-      title: pageConfig.title || extractH1(hierarchicalSections[0]?.content) || prettifySlug(pageName),
+      title: resolveDisplayTitle(pageConfig.title, pageName, hierarchicalSections),
       description: pageConfig.description || '',
       label: pageConfig.label || null, // Short label for navigation (defaults to title)
       // Localized URL slug overrides: { <locale>: <segment> }. Compiled into
@@ -1705,7 +1737,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
           sourcePath: isIndex ? (parentRoute === '/' ? `/${entry}` : `${parentRoute}/${entry}`) : null,
           id: dirConfig.id || null,
           isIndex,
-          title: dirConfig.title || entry,
+          title: resolveDisplayTitle(dirConfig.title, entry, null),
           description: dirConfig.description || '',
           label: dirConfig.label || null,
           lastModified: null,
@@ -1801,7 +1833,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
         sourcePath: isIndex ? (parentRoute === '/' ? `/${entry}` : `${parentRoute}/${entry}`) : null,
         id: dirConfig.id || null,
         isIndex,
-        title: dirConfig.title || entry,
+        title: resolveDisplayTitle(dirConfig.title, entry, null),
         description: dirConfig.description || '',
         label: dirConfig.label || null,
         lastModified: null,

package/src/site/data-ball.js

@@ -56,7 +56,7 @@ function collectionOf(relPath) {
  * @returns {Promise<{ data: Object, search: Object }|null>} null when there is nothing
  *          to deliver (no schema-less data AND no search index).
  */
-export async function assembleDataBall(distDir, schemalessNames = [], { projections = false } = {}) {
+export async function assembleDataBall(distDir, schemalessNames = []) {
   const schemaless = new Set(schemalessNames)
   const allData = await readJsonTree(join(distDir, 'data'))
   const data = {}
@@ -65,47 +65,22 @@ export async function assembleDataBall(distDir, schemalessNames = [], { projecti
   }
   const search = await readJsonTree(join(distDir, '_search'))
 
-  // Agent projections ride the same ball — same shape of thing (precomputed
-  // at publish, opaque to the backend, served as-is), just text rather than
-  // JSON. Off by default: what the artifacts are called and how they are
-  // addressed on the serving side is the backend's to specify, and shipping
-  // an unrecognized key into a payload the backend unwraps is not something
-  // to decide unilaterally. Flip this on once that contract is agreed.
-  const projectionFiles = projections ? await readTextTree(distDir) : {}
+  // Agent projections deliberately do NOT ride the ball.
+  //
+  // A backend that stores the site's content derives them itself at publish —
+  // one producer, so shipping ours would upload an artifact to the one host
+  // that does not need it, and invite two answers for one site. The projections
+  // this build emits into `dist/` are for hosts with no backend to derive them:
+  // static hosts and foreign backends. That is `@uniweb/projections`' scope and
+  // it is unchanged.
+  //
+  // (An opt-in `projections` bucket lived here while the delivery contract was
+  // open. It never shipped enabled, and the one-producer ruling closed the
+  // question — removed rather than left as a flag nobody may turn on.)
 
-  const empty =
-    Object.keys(data).length === 0 &&
-    Object.keys(search).length === 0 &&
-    Object.keys(projectionFiles).length === 0
-  if (empty) return null
+  if (Object.keys(data).length === 0 && Object.keys(search).length === 0) return null
 
-  return projections ? { data, search, projections: projectionFiles } : { data, search }
-}
-
-/**
- * Collect the agent projections from a built dist/ — `llms.txt` plus every
- * `.md` page projection, keyed by their served path.
- *
- * Deliberately excludes `node_modules`-shaped noise and anything under the
- * bundle's own asset directories; a site's `dist/` at this point holds only
- * what the link lane emitted.
- *
- * @param {string} distDir
- * @returns {Promise<Object<string, string>>}
- */
-async function readTextTree(distDir) {
-  if (!existsSync(distDir)) return {}
-  const out = {}
-  const entries = await readdir(distDir, { withFileTypes: true, recursive: true })
-  for (const entry of entries) {
-    if (!entry.isFile()) continue
-    const isProjection = entry.name === 'llms.txt' || entry.name.endsWith('.md')
-    if (!isProjection) continue
-    const full = join(entry.parentPath || entry.path, entry.name)
-    const rel = relative(distDir, full).split(sep).join('/')
-    out[rel] = await readFile(full, 'utf8')
-  }
-  return out
+  return { data, search }
 }
 
 // --- local media in the ball -------------------------------------------------