@microsoft/webui-framework 0.0.19 → 0.0.21

package/dist/template.js

@@ -1,22 +1,11 @@
-import { dispatchTemplatesRegistered } from './template-events.js';
+import { dispatchTemplatesRegistered, templateRegistrationDetail, TEMPLATES_REGISTERED_EVENT, } from './template-events.js';
 const WEBUI_DATA_ID = 'webui-data';
 const normalizedTemplates = new WeakSet();
+const assetNormalizedTemplates = new WeakSet();
 let webuiDataLoaded = false;
-export function getTemplate(name) {
-    let meta = window.__webui?.templates?.[name];
-    if (!meta) {
-        loadWebUIDataBlock();
-        meta = window.__webui?.templates?.[name];
-    }
-    if (meta)
-        normalizeTemplate(name, meta);
-    return meta;
-}
-export function getTemplateRegistry() {
-    loadWebUIDataBlock();
-    return window.__webui?.templates;
-}
-export function registerTemplateData(templates, templateFns) {
+const pendingTemplateDefinitions = new Map();
+function acceptTemplateData(templates, templateFns) {
+    prepareTemplateData(templates, templateFns);
     const w = window;
     if (!w.__webui)
         w.__webui = {};
@@ -32,16 +21,73 @@ export function registerTemplateData(templates, templateFns) {
         }
     }
     const names = Object.keys(templates);
-    let hasTemplates = false;
     for (let i = 0; i < names.length; i++) {
         const tag = names[i];
-        const meta = templates[tag];
-        w.__webui.templates[tag] = meta;
-        normalizeTemplate(tag, meta);
-        hasTemplates = true;
+        w.__webui.templates[tag] = templates[tag];
+    }
+    for (let i = 0; i < names.length; i++) {
+        const pending = pendingTemplateDefinitions.get(names[i]);
+        if (!pending)
+            continue;
+        pendingTemplateDefinitions.delete(names[i]);
+        pending.define();
+    }
+    return names.length > 0;
+}
+if (typeof window !== 'undefined' && typeof window.addEventListener === 'function') {
+    window.addEventListener(TEMPLATES_REGISTERED_EVENT, (event) => {
+        const templates = templateRegistrationDetail(event)?.templates;
+        if (templates)
+            acceptTemplateData(templates);
+    });
+}
+export function getTemplate(name) {
+    let meta = window.__webui?.templates?.[name];
+    if (!meta) {
+        loadWebUIDataBlock();
+        meta = window.__webui?.templates?.[name];
     }
-    if (hasTemplates)
+    if (meta)
+        normalizeTemplate(name, meta);
+    return meta;
+}
+export function getTemplateRegistry() {
+    loadWebUIDataBlock();
+    return window.__webui?.templates;
+}
+export function registerTemplateData(templates, templateFns) {
+    if (acceptTemplateData(templates, templateFns)) {
         dispatchTemplatesRegistered(templates);
+    }
+}
+function prepareTemplateData(templates, templateFns) {
+    const names = Object.keys(templates);
+    for (let i = 0; i < names.length; i++) {
+        const name = names[i];
+        normalizeTemplate(name, templates[name], templateFns?.[name]);
+    }
+}
+export function prepareAssetTemplateData(templates, templateFns) {
+    const names = Object.keys(templates);
+    for (let i = 0; i < names.length; i++) {
+        const name = names[i];
+        const meta = templates[name];
+        if (assetNormalizedTemplates.has(meta))
+            continue;
+        normalizeTemplateConditions(name, meta, templateFns?.[name] ?? []);
+        normalizedTemplates.add(meta);
+        assetNormalizedTemplates.add(meta);
+    }
+}
+export function deferTemplateDefinition(tagName, ctor, define) {
+    const pending = pendingTemplateDefinitions.get(tagName);
+    if (pending) {
+        if (pending.ctor === ctor) {
+            throw new Error(`[WebUI] <${tagName}> is already pending definition.`);
+        }
+        throw new Error(`[WebUI] <${tagName}> already has a pending authored definition.`);
+    }
+    pendingTemplateDefinitions.set(tagName, { ctor, define });
 }
 function loadWebUIDataBlock() {
     if (webuiDataLoaded || window.__webui?.state !== undefined || typeof document === 'undefined')
@@ -62,10 +108,14 @@ function loadWebUIDataBlock() {
     el.remove();
     webuiDataLoaded = true;
 }
-function normalizeTemplate(name, meta) {
+function normalizeTemplate(name, meta, suppliedFns) {
     if (normalizedTemplates.has(meta))
         return;
-    const fns = window.__webui?.templateFns?.[name] ?? [];
+    const fns = suppliedFns ?? window.__webui?.templateFns?.[name] ?? [];
+    normalizeTemplateConditions(name, meta, fns);
+    normalizedTemplates.add(meta);
+}
+function normalizeTemplateConditions(name, meta, fns) {
     const stack = [meta];
     while (stack.length > 0) {
         const block = stack.pop();
@@ -89,7 +139,6 @@ function normalizeTemplate(name, meta) {
                 stack.push(children[i]);
         }
     }
-    normalizedTemplates.add(meta);
 }
 function normalizeCondition(tagName, condition, fns) {
     const first = condition[0];

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@microsoft/webui-framework",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "type": "module",
-  "description": "WebUI Framework Next — Preact-inspired lightweight Web Component runtime with SSR hydration. 15KB minified, compiled-template path mapping, no hydration markers.",
+  "description": "WebUI Framework Next — Preact-inspired lightweight Web Component runtime with SSR hydration and compiled-template path mapping.",
   "license": "MIT",
   "exports": {
     ".": {
@@ -16,6 +16,12 @@
         "types": "./dist/component-asset.d.ts",
         "default": "./dist/component-asset.js"
       }
+    },
+    "./streaming.js": {
+      "import": {
+        "types": "./dist/streaming-entry.d.ts",
+        "default": "./dist/streaming-entry.js"
+      }
     }
   },
   "files": [
@@ -25,7 +31,7 @@
     "@playwright/test": "^1.61.1",
     "@types/node": "^26.1.0",
     "typescript": "^6.0.3",
-    "@microsoft/webui-test-support": "0.0.19"
+    "@microsoft/webui-test-support": "0.0.21"
   },
   "scripts": {
     "build": "tsc",