@uniweb/core 0.7.6 → 0.7.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/core",
-  "version": "0.7.6",
+  "version": "0.7.8",
   "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
   "type": "module",
   "exports": {
@@ -30,7 +30,7 @@
     "jest": "^29.7.0"
   },
   "dependencies": {
-    "@uniweb/semantic-parser": "1.1.14",
+    "@uniweb/semantic-parser": "1.1.15",
     "@uniweb/theming": "0.1.3"
   },
   "scripts": {

package/src/page.js

@@ -480,6 +480,34 @@ export default class Page {
     return this.route // Fallback to own route
   }
 
+  /**
+   * Resolve which Page should actually be rendered when this one is
+   * requested. If the page has its own content, it renders itself. If
+   * it's a content-less folder with a designated index child, that
+   * child renders in its place. Otherwise, returns `this` so the caller
+   * can decide what to do with an empty page (typically an empty
+   * <main>, not a 404 — the route exists, it just has no body).
+   *
+   * Distinct from `getNavigableRoute()`, which recursively walks
+   * descendants to find a navigation target. `getRenderableSelf()` only
+   * looks one level down (to the immediate index child) — the contract
+   * is "give me the page to render *here*," not "give me the next URL
+   * with content."
+   *
+   * Used by SSR paths (Cloudflare Worker isolate today; framework SSG
+   * pre-handles this differently via expandDynamicPages) to avoid
+   * rendering nothing when an author requests `/docs` and the page is
+   * a folder whose actual landing content lives in `/docs/intro` flagged
+   * as `isIndex: true`.
+   *
+   * @returns {Page} The page to render — `this` or its index child.
+   */
+  getRenderableSelf() {
+    if (this.hasContent()) return this
+    const indexChild = this.children?.find((c) => c.isIndex)
+    return indexChild || this
+  }
+
   /**
    * Get route without leading/trailing slashes.
    * Delegates to Website.normalizeRoute() for consistent normalization.

package/src/website.js

@@ -74,7 +74,6 @@ export default class Website {
     this.pageRoutes = []
     this.themeData = {}
     this.config = {}
-    this.xref = null
     this.siteDefaultLocale = 'en'
     this.defaultLocale = 'en'
     this.activeLocale = 'en'
@@ -108,7 +107,6 @@ export default class Website {
       notFound,
       versionedScopes = {},
       assets = {},
-      xref = null,
     } = content || {}
 
     this.name = config.name || ''
@@ -167,10 +165,6 @@ export default class Website {
     this._routeTranslations = this._buildRouteTranslations(config)
     this.versionedScopes = versionedScopes
     this.assets = assets
-    // Cross-reference registry — populated by content-loader from {#id}
-    // attributes on labeled block elements. Read by kit's <Ref>
-    // component to resolve `[#id]` cross-reference insets.
-    this.xref = xref || null
   }
 
   /**