@uniweb/build 0.8.27 → 0.8.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.8.27",
+  "version": "0.8.29",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -54,9 +54,9 @@
     "@uniweb/theming": "0.1.3"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "0.6.23",
-    "@uniweb/content-reader": "1.1.4",
-    "@uniweb/schemas": "0.2.1"
+    "@uniweb/runtime": "0.6.25",
+    "@uniweb/schemas": "0.2.1",
+    "@uniweb/content-reader": "1.1.4"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -65,7 +65,7 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/core": "0.5.17"
+    "@uniweb/core": "0.5.18"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/site/content-collector.js

@@ -1466,12 +1466,16 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
       orderedMdPages = mdPageItems
     }
 
-    // In folder mode, determine index: pages: first item, or explicit index:
+    // In folder mode, determine index page (homepage only).
+    // Index promotion only happens at the site root — at deeper levels,
+    // pages: controls order only and every folder keeps its natural route.
     let indexName = null
-    if (pagesParsedFM && pagesParsedFM.before.length > 0) {
-      indexName = extractItemName(pagesParsedFM.before[0])
-    } else {
-      indexName = orderConfig?.index || null
+    if (parentRoute === '/') {
+      if (pagesParsedFM && pagesParsedFM.before.length > 0) {
+        indexName = extractItemName(pagesParsedFM.before[0])
+      } else {
+        indexName = orderConfig?.index || null
+      }
     }
 
     // Add md-file-pages
@@ -1608,12 +1612,16 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
 
   // --- Sections mode (default): existing behavior ---
 
-  // Determine which page is the index for this level
-  // A directory with its own .md content is a real page, not a container —
-  // never promote a child as index, even if explicit config says so
+  // Determine which page is the index for this level.
+  // Index promotion only happens at the site root (parentRoute === '/') — the
+  // homepage needs to live at '/'.  At all other levels, folders keep their
+  // natural route (1:1 folder-to-route mapping).  Content-less containers
+  // exist in the hierarchy with hasContent: false and auto-redirect at runtime.
   const hasExplicitOrder = orderConfig?.index || (Array.isArray(orderConfig?.pages) && orderConfig.pages.length > 0)
   const hasMdContent = entries.some(e => isMarkdownFile(e))
-  const indexPageName = hasMdContent ? null : determineIndexPage(orderConfig, orderedFolders)
+  const indexPageName = parentRoute === '/' && !hasMdContent
+    ? determineIndexPage(orderConfig, orderedFolders)
+    : null
 
   // Second pass: process each page folder
   for (const folder of orderedFolders) {
@@ -1972,8 +1980,9 @@ export async function collectSiteContent(sitePath, options = {}) {
   const { pages, assetCollection, iconCollection, notFound, versionedScopes } =
     await collectPagesRecursive(pagesPath, '/', sitePath, siteOrderConfig, null, null, rootContentMode, mounts, siteLayoutName)
 
-  // Deduplicate: remove content-less container pages whose route duplicates
-  // a content-bearing page (e.g., a promoted index page)
+  // Deduplicate: at the root level, homepage promotion can create a route
+  // collision between the promoted page and a content-less container.
+  // At deeper levels, 1:1 mapping means collisions shouldn't happen — warn.
   const routeCounts = new Map()
   for (const page of pages) {
     const existing = routeCounts.get(page.route)
@@ -1985,6 +1994,9 @@ export async function collectSiteContent(sitePath, options = {}) {
   }
   for (const [route, group] of routeCounts) {
     if (group.length > 1) {
+      if (route !== '/') {
+        console.warn(`[content-collector] Unexpected route collision at '${route}' — ${group.length} pages share this route`)
+      }
       // Keep the page with content, remove content-less duplicates
       const withContent = group.filter(p => p.sections && p.sections.length > 0)
       const toRemove = withContent.length > 0