@microsoft/webui-framework 0.0.6 → 0.0.8

package/dist/index.js

@@ -1,12 +1,25 @@
-import { WebUIElement } from "./element.js";
-import { observable, attr } from "./decorators.js";
-import { getTemplate } from "./template.js";
-import { hydrationStart, hydrationEnd } from "./lifecycle.js";
-export {
-  WebUIElement,
-  attr,
-  getTemplate,
-  hydrationEnd,
-  hydrationStart,
-  observable
-};
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * @microsoft/webui-framework — lightweight Web Component runtime with SSR hydration.
+ *
+ * Provides a reactive base class, decorators, and hydration utilities for
+ * building Web Components that work with WebUI's server-side rendering pipeline.
+ *
+ * @example
+ * ```ts
+ * import { WebUIElement, observable, attr } from '@microsoft/webui-framework';
+ *
+ * class MyCounter extends WebUIElement {
+ *   @attr count = 0;
+ *   @observable label = 'Count';
+ * }
+ * MyCounter.define('my-counter');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { WebUIElement } from './element.js';
+export { observable, attr } from './decorators.js';
+export { getTemplate } from './template.js';
+export { hydrationStart, hydrationEnd } from './lifecycle.js';

package/dist/lifecycle.js

@@ -1,27 +1,51 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * Hydration lifecycle tracker.
+ *
+ * Tracks aggregate hydration timing via the Performance API and fires a
+ * global `webui:hydration-complete` event on `window` once every registered
+ * component has finished hydrating.
+ *
+ * ## Performance marks
+ *
+ * Global:
+ * - `webui:hydrate:total:start`  — first component begins hydrating
+ * - `webui:hydrate:total:end`    — last component finishes
+ * - measure `webui:hydrate:total`
+ *
+ * ## Window event
+ *
+ * `webui:hydration-complete` — dispatched once on `window` when all
+ * components are hydrated.
+ */
+/** How many components are still waiting to hydrate. */
 let pendingCount = 0;
+/** Whether the global start mark has been placed. */
 let started = false;
+/** Whether the global complete event has already fired. */
 let completed = false;
-function hydrationStart() {
-  if (!started) {
-    performance.mark("webui:hydrate:total:start");
-    started = true;
-  }
-  pendingCount++;
+/**
+ * Call before a component begins hydration.
+ * Increments the pending counter and (once) places the global start mark.
+ */
+export function hydrationStart() {
+    if (!started) {
+        performance.mark('webui:hydrate:total:start');
+        started = true;
+    }
+    pendingCount++;
 }
-function hydrationEnd() {
-  pendingCount--;
-  if (pendingCount <= 0 && !completed) {
-    completed = true;
-    performance.mark("webui:hydrate:total:end");
-    performance.measure(
-      "webui:hydrate:total",
-      "webui:hydrate:total:start",
-      "webui:hydrate:total:end"
-    );
-    window.dispatchEvent(new Event("webui:hydration-complete"));
-  }
+/**
+ * Call after a component has finished hydration.
+ * When the last component finishes, fires the global event + measure.
+ */
+export function hydrationEnd() {
+    pendingCount--;
+    if (pendingCount <= 0 && !completed) {
+        completed = true;
+        performance.mark('webui:hydrate:total:end');
+        performance.measure('webui:hydrate:total', 'webui:hydrate:total:start', 'webui:hydrate:total:end');
+        window.dispatchEvent(new Event('webui:hydration-complete'));
+    }
 }
-export {
-  hydrationEnd,
-  hydrationStart
-};

package/dist/template-types.js

@@ -0,0 +1,3 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+export {};

package/dist/template.js

@@ -1,6 +1,5 @@
-function getTemplate(name) {
-  return window.__webui_templates?.[name];
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+export function getTemplate(name) {
+    return window.__webui_templates?.[name];
 }
-export {
-  getTemplate
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/webui-framework",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "description": "WebUI Framework Next — Preact-inspired lightweight Web Component runtime with SSR hydration. 15KB minified, compiled-template path mapping, no hydration markers.",
   "license": "MIT",
@@ -18,20 +18,17 @@
   "devDependencies": {
     "@playwright/test": "^1.58.2",
     "@types/node": "^25.3.5",
-    "esbuild": "^0.27.3",
     "typescript": "^5.9.3",
-    "@microsoft/webui-test-support": "0.0.6"
+    "@microsoft/webui-test-support": "0.0.8"
   },
   "scripts": {
-    "build": "find src -name '*.ts' ! -name '*.test.ts' | xargs esbuild --outdir=dist --outbase=src --format=esm --platform=browser && tsc --emitDeclarationOnly",
+    "build": "tsc",
     "typecheck": "tsc --noEmit",
     "typecheck:e2e": "tsc -p tsconfig.test.json --noEmit",
-    "build:e2e:scripts": "esbuild ./tests/server.ts --bundle --external:esbuild --outdir=tests/dist --format=esm --platform=node --target=es2022",
-    "build:e2e": "pnpm build:e2e:scripts",
     "test": "pnpm test:unit && pnpm test:e2e",
-    "test:unit": "esbuild \"src/**/*.test.ts\" --bundle --outdir=dist/tests --outbase=src --format=esm --platform=node --target=es2022 && node --test \"dist/tests/**/*.test.js\"",
-    "test:e2e": "pnpm typecheck:e2e && pnpm build:e2e && playwright test",
+    "test:unit": "tsc -p tsconfig.unit-test.json && node --test \"dist/**/*.test.js\"",
+    "test:e2e": "pnpm typecheck:e2e && playwright test",
     "test:update-snapshots": "pnpm test:e2e:update-snapshots",
-    "test:e2e:update-snapshots": "pnpm typecheck:e2e && pnpm build:e2e && playwright test --update-snapshots"
+    "test:e2e:update-snapshots": "pnpm typecheck:e2e && playwright test --update-snapshots"
   }
 }