@uniweb/core 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/core",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
   "type": "module",
   "exports": {

package/src/page.js

@@ -22,6 +22,7 @@ export default class Page {
     this.route = pageData.route
     this.sourcePath = pageData.sourcePath || null // Original folder-based path (for ancestor checking)
     this.isIndex = pageData.isIndex || false // True if this page is the index for its parent route
+    this.parentRoute = pageData.parent || null // Declared parent route for hierarchy linking (set by build)
     this.title = pageData.title || ''
     this.description = pageData.description || ''
     this.label = pageData.label || null // Short label for navigation (null = use title)

package/src/uniweb.js

@@ -22,6 +22,10 @@ export default class Uniweb {
     // Set by runtime based on site config
     this.iconResolver = null
 
+    // Pre-populated icon cache for SSR: Map<"family:name", svgString>
+    // Populated by prerender before rendering, read synchronously by Icon component
+    this.iconCache = new Map()
+
     // Initialize analytics (disabled by default, configure via site config)
     this.analytics = new Analytics(configData.analytics || {})
   }
@@ -40,6 +44,16 @@ export default class Uniweb {
     return this.iconResolver(library, name)
   }
 
+  /**
+   * Get a cached icon synchronously (for SSR/prerender)
+   * @param {string} library - Icon family code
+   * @param {string} name - Icon name
+   * @returns {string|null} SVG string or null if not cached
+   */
+  getIconSync(library, name) {
+    return this.iconCache.get(`${library}:${name}`) || null
+  }
+
   /**
    * Set the foundation module after loading
    * @param {Object} foundation - The loaded ESM foundation module

package/src/website.js

@@ -128,48 +128,23 @@ export default class Website {
    * @private
    */
   buildPageHierarchy() {
-    // Sort pages by route depth (parents before children)
-    const sortedPages = [...this.pages].sort((a, b) => {
-      const depthA = (a.route.match(/\//g) || []).length
-      const depthB = (b.route.match(/\//g) || []).length
-      return depthA - depthB
-    })
-
-    // Build a map of route to page for quick lookup
-    // Include both actual routes and nav routes (for index pages)
+    // Build a map of route to page for parent lookup
     const pageMap = new Map()
-    for (const page of sortedPages) {
+    for (const page of this.pages) {
       pageMap.set(page.route, page)
-      // Also map the nav route for index pages so parent lookup works
-      if (page.isIndex) {
-        const navRoute = page.getNavRoute()
-        if (navRoute !== page.route) {
-          pageMap.set(navRoute, page)
-        }
-      }
     }
 
-    // For each page, find its parent and add it as a child
-    for (const page of sortedPages) {
-      const route = page.route
-      // Skip root-level pages (single segment like /home, /about)
-      const segments = route.split('/').filter(Boolean)
-      if (segments.length <= 1) continue
-
-      // Build parent route by removing the last segment
-      // /docs/getting-started -> /docs
-      const parentRoute = '/' + segments.slice(0, -1).join('/')
-      const parent = pageMap.get(parentRoute)
-
-      if (parent) {
-        parent.children.push(page)
-        page.parent = parent
+    // Link pages using the declared parent route (set by build)
+    for (const page of this.pages) {
+      if (page.parentRoute) {
+        const parent = pageMap.get(page.parentRoute)
+        if (parent) {
+          parent.children.push(page)
+          page.parent = parent
+        }
       }
     }
 
-    // Note: Pages arrive pre-sorted from build time.
-    // The hierarchy is hydrated from that order - no runtime sorting needed.
-
     // Build page ID map for makeHref() resolution
     // Supports both explicit IDs and route-based lookup
     this._pageIdMap = new Map()
@@ -796,6 +771,7 @@ export default class Website {
       label: page.getLabel(),
       description: page.description,
       hasContent: page.hasContent(),
+      version: page.version || null, // Version metadata for filtering by version
       children: nested && page.hasChildren()
         ? page.children.filter(isPageVisible).map(buildPageInfo)
         : []