@uniweb/core 0.4.2 → 0.4.4

package/package.json

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

package/src/uniweb.js

@@ -16,6 +16,7 @@ export default class Uniweb {
     this.foundation = null // The loaded foundation module
     this.foundationConfig = {} // Configuration from foundation (capabilities)
     this.meta = {} // Per-component runtime metadata (from meta.js)
+    this.extensions = [] // Array of { foundation, meta } objects
     this.language = 'en'
 
     // Icon resolver: (library, name) => Promise<string|null>
@@ -67,13 +68,30 @@ export default class Uniweb {
     }
   }
 
+  /**
+   * Register an extension (secondary foundation)
+   * @param {Object} foundation - The loaded ESM extension module
+   */
+  registerExtension(foundation) {
+    const meta = foundation.meta || {}
+    this.extensions.push({ foundation, meta })
+  }
+
   /**
    * Get runtime metadata for a component
    * @param {string} componentName
    * @returns {Object|null} Meta with defaults, context, initialState, background, data
    */
   getComponentMeta(componentName) {
-    return this.meta[componentName] || null
+    const primary = this.meta[componentName]
+    if (primary) return primary
+
+    for (const ext of this.extensions) {
+      const meta = ext.meta[componentName]
+      if (meta) return meta
+    }
+
+    return null
   }
 
   /**
@@ -82,7 +100,7 @@ export default class Uniweb {
    * @returns {Object} Default values (empty object if none)
    */
   getComponentDefaults(componentName) {
-    return this.meta[componentName]?.defaults || {}
+    return this.getComponentMeta(componentName)?.defaults || {}
   }
 
   /**
@@ -96,8 +114,17 @@ export default class Uniweb {
       return undefined
     }
 
-    // Look in components object first, then direct access (named export)
-    return this.foundation.components?.[name] || this.foundation[name]
+    // Primary foundation first
+    const primary = this.foundation.components?.[name] || this.foundation[name]
+    if (primary) return primary
+
+    // Fall through to extensions (declared order)
+    for (const ext of this.extensions) {
+      const component = ext.foundation.components?.[name] || ext.foundation[name]
+      if (component) return component
+    }
+
+    return undefined
   }
 
   /**
@@ -105,14 +132,23 @@ export default class Uniweb {
    * @returns {string[]}
    */
   listComponents() {
-    if (!this.foundation) return []
+    const names = new Set()
+
+    if (this.foundation?.components) {
+      for (const name of Object.keys(this.foundation.components)) {
+        names.add(name)
+      }
+    }
 
-    // Use components object if available
-    if (this.foundation.components) {
-      return Object.keys(this.foundation.components)
+    for (const ext of this.extensions) {
+      if (ext.foundation.components) {
+        for (const name of Object.keys(ext.foundation.components)) {
+          names.add(name)
+        }
+      }
     }
 
-    return []
+    return [...names]
   }
 
   /**

package/src/website.js

@@ -18,21 +18,19 @@ export default class Website {
     this.description = config.description || ''
     this.url = config.url || ''
 
-    // Store special pages (layout areas)
+    // Store layout panels (header, footer, left, right)
     // These come from top-level properties set by content-collector
-    // Fallback to searching pages array for backwards compatibility
-    this.headerPage = header || pages.find((p) => p.route === '/@header') || null
-    this.footerPage = footer || pages.find((p) => p.route === '/@footer') || null
-    this.leftPage = left || pages.find((p) => p.route === '/@left') || null
-    this.rightPage = right || pages.find((p) => p.route === '/@right') || null
+    this.headerPage = header || null
+    this.footerPage = footer || null
+    this.leftPage = left || null
+    this.rightPage = right || null
 
     // Store 404 page (for SPA routing)
     // Convention: pages/404/ directory
     this.notFoundPage = notFound || pages.find((p) => p.route === '/404') || null
 
-    // Filter out special pages from regular pages array
-    const specialRoutes = ['/@header', '/@footer', '/@left', '/@right', '/404']
-    const regularPages = pages.filter((page) => !specialRoutes.includes(page.route))
+    // Filter out 404 from regular pages array
+    const regularPages = pages.filter((page) => page.route !== '/404')
 
     // Store original page data for dynamic pages (needed to create instances on-demand)
     this._dynamicPageData = new Map()
@@ -792,9 +790,6 @@ export default class Website {
 
     // Filter pages based on navigation type and visibility
     const isPageVisible = (page) => {
-      // Always exclude special pages (header/footer are already separated)
-      if (page.route.startsWith('/@')) return false
-
       // Always exclude dynamic route template pages (e.g., /blog/:slug)
       // These are templates for generating pages, not actual navigable pages
       if (page.route.includes(':')) return false