@uniweb/runtime 0.5.15 → 0.5.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/runtime",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "description": "Minimal runtime for loading Uniweb foundations",
   "type": "module",
   "exports": {
@@ -31,7 +31,7 @@
     "node": ">=20.19"
   },
   "dependencies": {
-    "@uniweb/core": "0.4.3"
+    "@uniweb/core": "0.4.4"
   },
   "devDependencies": {
     "@vitejs/plugin-react": "^4.5.2",

package/src/index.jsx

@@ -130,6 +130,42 @@ async function loadFoundation(source) {
   }
 }
 
+/**
+ * Load extensions (secondary foundations) in parallel
+ * @param {Array<string|Object>} urls - Extension URLs or {url, cssUrl} objects
+ * @param {Object} uniwebInstance - The Uniweb instance to register extensions on
+ */
+async function loadExtensions(urls, uniwebInstance) {
+  if (!urls?.length) return
+
+  // Resolve extension URLs against base path for subdirectory deployments
+  // e.g., /effects/foundation.js → /templates/extensions/effects/foundation.js
+  const basePath = import.meta.env?.BASE_URL || '/'
+  function resolveUrl(source) {
+    if (basePath === '/') return source
+    if (typeof source === 'string' && source.startsWith('/')) {
+      return basePath + source.slice(1)
+    }
+    if (typeof source === 'object' && source.url?.startsWith('/')) {
+      return { ...source, url: basePath + source.url.slice(1) }
+    }
+    return source
+  }
+
+  const results = await Promise.allSettled(
+    urls.map(url => loadFoundation(resolveUrl(url)))
+  )
+
+  for (let i = 0; i < results.length; i++) {
+    if (results[i].status === 'fulfilled') {
+      uniwebInstance.registerExtension(results[i].value)
+      console.log(`[Runtime] Extension loaded: ${urls[i]}`)
+    } else {
+      console.warn(`[Runtime] Extension failed to load: ${urls[i]}`, results[i].reason)
+    }
+  }
+}
+
 /**
  * Map friendly family names to react-icons codes
  * The existing CDN uses react-icons structure: /{familyCode}/{familyCode}-{name}.svg
@@ -411,6 +447,12 @@ async function initRuntime(foundationSource, options = {}) {
       uniwebInstance.setFoundationConfig(foundation.capabilities)
     }
 
+    // Load extensions (secondary foundations)
+    const extensions = configData?.config?.extensions
+    if (extensions?.length) {
+      await loadExtensions(extensions, uniwebInstance)
+    }
+
     // Render the app
     render({ development, basename })
 
@@ -452,15 +494,23 @@ async function initRuntime(foundationSource, options = {}) {
 /**
  * Simplified entry point for sites
  *
- * Reads configuration from (in order of priority):
- * 1. __DATA__ element (dynamic backends) - combined foundation config + site content
- * 2. Build-time __FOUNDATION_CONFIG__ (static builds) - foundation config only
+ * Template main.js calls this with config + foundation/styles promises:
+ *
+ *   start({
+ *     config: __FOUNDATION_CONFIG__,
+ *     styles: import('#foundation/styles'),
+ *     foundation: import('#foundation')
+ *   })
+ *
+ * In runtime mode, the foundation/styles promises resolve to noop modules
+ * (configured by the site Vite plugin) and are ignored.
  *
  * @param {Object} options
+ * @param {Object} options.config - Build-time config from __FOUNDATION_CONFIG__
  * @param {Promise} options.foundation - Promise from import('#foundation')
  * @param {Promise} options.styles - Promise from import('#foundation/styles')
  */
-async function start({ foundation, styles } = {}) {
+async function start({ config, foundation, styles } = {}) {
   // Try __DATA__ first (dynamic backends inject combined config + content)
   const data = await decodeData()
 
@@ -472,15 +522,14 @@ async function start({ foundation, styles } = {}) {
     )
   }
 
-  // Static build mode - use build-time config
-  const config =
-    typeof __FOUNDATION_CONFIG__ !== 'undefined' ? __FOUNDATION_CONFIG__ : { mode: 'bundled' }
+  // Use provided config, or fall back to bundled mode
+  const mode = config?.mode ?? 'bundled'
 
-  if (config.mode === 'runtime') {
-    // Runtime mode (foundation URL in site.yml)
+  if (mode === 'runtime') {
+    // Runtime mode - foundation loaded from URL
     return initRuntime({ url: config.url, cssUrl: config.cssUrl })
   } else {
-    // Bundled mode - foundation included in build
+    // Bundled mode - use the provided foundation/styles promises
     const [foundationModule] = await Promise.all([foundation, styles])
     return initRuntime(foundationModule)
   }