@glasshome/widget-sdk 1.10.3 → 1.11.0

package/README.md

@@ -86,6 +86,12 @@ The `area` widget renders quick-glance metric pills (CO2 traffic-light, humidity
 
 If your widget needs full visual control (a chart, a video stream, a custom animated surface), follow these patterns: keep the `<Widget>` shell neutral (no `tone`/`color`), place your custom DOM inside `<Widget.Content>`, and document the choice in the widget's README.
 
+## Troubleshooting
+
+| Variable                     | Effect                                                                                                                             |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `GLASSHOME_WIDGET_NO_WORKER` | Set to `1` to make `bun widget connect` check each rebuild in a fresh process again, instead of reusing one worker for the session. |
+
 ## Peer Dependencies
 
 | Package    | Required | Notes                                       |

package/dist/index.js

@@ -1451,7 +1451,7 @@ function Un() {
 //#region src/version.ts
 var Wn = {
 	name: "@glasshome/widget-sdk",
-	version: "1.10.3",
+	version: "1.11.0",
 	description: "SDK for building GlassHome dashboard widgets with SolidJS",
 	keywords: [
 		"glasshome",

package/dist/introspect-core-DYv9Uufi.js

@@ -0,0 +1,72 @@
+import { copyFileSync as e, rmSync as t } from "node:fs";
+import { pathToFileURL as n } from "node:url";
+//#region src/vite/introspect-core.ts
+function r(e) {
+	return typeof e?.safeParse == "function";
+}
+function i(e, t) {
+	if (!r(e) || !Array.isArray(t)) return [];
+	let n = [];
+	for (let [r, i] of t.entries()) {
+		let t = i?.config;
+		if (typeof t != "object" || !t) continue;
+		let a = e.safeParse(t);
+		a.success || n.push({
+			index: r,
+			label: i.label,
+			problems: (a.error?.issues ?? []).map((e) => {
+				let t = e.path.map(String).join(".");
+				return t ? `${t}: ${e.message}` : e.message;
+			})
+		});
+	}
+	return n;
+}
+var a = [
+	"window",
+	"document",
+	"navigator",
+	"location",
+	"customElements",
+	"HTMLElement",
+	"Element",
+	"Node",
+	"CSS",
+	"getComputedStyle",
+	"requestAnimationFrame",
+	"cancelAnimationFrame",
+	"matchMedia"
+];
+async function o() {
+	let { Window: e } = await import("happy-dom"), t = new e({ url: "http://localhost" });
+	for (let e of a) try {
+		Object.defineProperty(globalThis, e, {
+			value: t[e],
+			configurable: !0,
+			writable: !0
+		});
+	} catch {}
+}
+async function s(r, i) {
+	let a = `${r}.introspect-${i}.mjs`;
+	e(r, a);
+	try {
+		return await import(n(a).href);
+	} finally {
+		t(a, { force: !0 });
+	}
+}
+async function c(e, t) {
+	let r = (t ? await s(e, t) : await import(n(e).href)).default, a = null;
+	if (r?.configSchema) {
+		let { z: e } = await import("zod");
+		a = e.toJSONSchema(r.configSchema, { unrepresentable: "any" });
+	}
+	return {
+		manifest: r?.manifest ?? null,
+		jsonSchema: a,
+		exampleConfigIssues: i(r?.configSchema, r?.manifest?.examples)
+	};
+}
+//#endregion
+export { c as n, o as t };

package/dist/vite/fixtures/orphan-parent.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/vite/index.d.ts

@@ -1,4 +1,8 @@
 import type { InlineConfig, Plugin } from "vite";
+import type { ExampleConfigIssue, WidgetIntrospection } from "./introspect-core";
+import { createIntrospectSession, type IntrospectSession, type IntrospectSessionOptions, introspectOnce } from "./introspect-session";
+export { createIntrospectSession, introspectOnce };
+export type { ExampleConfigIssue, IntrospectSession, IntrospectSessionOptions, WidgetIntrospection, };
 export interface GlasshomeWidgetOptions {
     /** Entry file for the widget (default: "src/index.tsx") */
     entry?: string;
@@ -16,6 +20,8 @@ export declare function runSchemaGuard(args: {
     hashFile: string;
     widgetName: string;
     manifestPath?: string;
+    /** Persistent worker to reuse. Only `bun widget connect`'s watch loop passes one. */
+    session?: IntrospectSession;
 }): Promise<void>;
 /**
  * Packages provided by the host import map — widgets must not bundle these.
@@ -74,6 +80,8 @@ export interface BuildWidgetsOptions {
     viteConfig?: InlineConfig;
     /** Build only these widget names (subdirectory names). Skips full clean. */
     only?: string[];
+    /** Persistent introspection worker to reuse across rebuilds. */
+    session?: IntrospectSession;
 }
 /**
  * Build each widget as a separate Vite invocation so shared code is inlined
@@ -103,4 +111,3 @@ export interface GlasshomeWidgetsOptions {
  * default build, and `closeBundle()` runs the actual per-widget builds.
  */
 export declare function glasshomeWidgets(options?: GlasshomeWidgetsOptions): Plugin[];
-export {};

package/dist/vite/index.js

@@ -1,19 +1,193 @@
 import { deprecations as e, formatDeprecation as t } from "../deprecations.js";
 import { formatSchemaError as n, isHostProvidedModule as r, widgetManifestSchema as i } from "@glasshome/widget-contract";
-import { spawnSync as a } from "node:child_process";
-import { createHash as o } from "node:crypto";
-import { existsSync as s, mkdirSync as c, readFileSync as l, readdirSync as u, rmSync as d, statSync as f, writeFileSync as p } from "node:fs";
-import { createRequire as m } from "node:module";
-import { dirname as h, join as g, relative as _, resolve as v, sep as y } from "node:path";
-import { fileURLToPath as b } from "node:url";
-import x from "@tailwindcss/vite";
+import { createHash as a } from "node:crypto";
+import { existsSync as o, mkdirSync as s, readFileSync as c, readdirSync as l, rmSync as u, statSync as d, writeFileSync as f } from "node:fs";
+import { createRequire as p } from "node:module";
+import { dirname as m, join as h, relative as g, resolve as _, sep as v } from "node:path";
+import { fileURLToPath as y } from "node:url";
+import ee from "@tailwindcss/vite";
+import { spawn as b, spawnSync as x } from "node:child_process";
+//#region src/vite/introspect-session.ts
+var te = 262144e3, S = 3e4, C = 3e3;
+function w(e) {
+	let t = m(y(import.meta.url));
+	return [h(t, `${e}.js`), h(t, `${e}.ts`)].find((e) => o(e)) ?? null;
+}
+function T(e) {
+	let t = w("introspect");
+	if (!t) return {
+		ok: !1,
+		reason: "introspect not found next to the sdk"
+	};
+	let n = x(process.execPath, [
+		"--conditions",
+		"browser",
+		t,
+		e
+	], {
+		encoding: "utf-8",
+		timeout: S
+	});
+	if (n.error) return {
+		ok: !1,
+		reason: n.error.message
+	};
+	if (n.status !== 0) return {
+		ok: !1,
+		reason: (n.stderr || "").trim().split("\n")[0] || `exit ${n.status}`
+	};
+	try {
+		return {
+			ok: !0,
+			value: JSON.parse(n.stdout)
+		};
+	} catch {
+		return {
+			ok: !1,
+			reason: "introspect returned unparseable output"
+		};
+	}
+}
+function ne() {
+	return {
+		introspect: async (e) => T(e),
+		dispose: async () => {},
+		childPid: null
+	};
+}
+function re(e) {
+	if (process.env.GLASSHOME_WIDGET_NO_WORKER === "1") return ne();
+	let t = e?.rssLimitBytes ?? te, n = e?.timeoutMs ?? S, r = e?.slowMs ?? C, i = null, a = null, o = !1, s = !1, c = 0, l = Promise.resolve(), u = /* @__PURE__ */ new Map();
+	function d(e) {
+		for (let t of u.values()) t({
+			ok: !1,
+			reason: e
+		});
+		u.clear();
+	}
+	function f(e) {
+		let t = i;
+		i = null, a = null, o = !1, d(e), t?.kill();
+	}
+	function p(e) {
+		let n;
+		try {
+			n = JSON.parse(e);
+		} catch {
+			return;
+		}
+		if (typeof n.id != "number") return;
+		let i = u.get(n.id);
+		i && (u.delete(n.id), (n.rss ?? 0) > t && (o = !0), (n.importMs ?? 0) > r && console.warn(`[widget-sdk] introspection took ${n.importMs}ms`), i(n.ok ? {
+			ok: !0,
+			value: n.value
+		} : {
+			ok: !1,
+			reason: n.reason ?? "introspection failed"
+		}));
+	}
+	function m() {
+		if (i && a && !o) return a;
+		(o || i) && f("worker was replaced");
+		let e = w("introspect-worker");
+		if (!e) return Promise.reject(/* @__PURE__ */ Error("introspect-worker not found next to the sdk"));
+		let t = Date.now(), n = b(process.execPath, [
+			"--conditions",
+			"browser",
+			e
+		], { stdio: [
+			"pipe",
+			"pipe",
+			"inherit"
+		] });
+		i = n;
+		let s = new Promise((e, o) => {
+			let s = "", c = !1;
+			n.stdout?.setEncoding("utf-8"), n.stdout?.on("data", (n) => {
+				s += n;
+				let i = s.indexOf("\n");
+				for (; i >= 0;) {
+					let n = s.slice(0, i).trim();
+					if (s = s.slice(i + 1), n) {
+						if (!c && n.includes("\"ready\"")) {
+							c = !0;
+							let n = Date.now() - t;
+							n > r && console.warn(`[widget-sdk] introspect worker took ${n}ms to boot`), e();
+						} else p(n);
+					}
+					i = s.indexOf("\n");
+				}
+			});
+			let l = (e) => {
+				i === n && (i = null, a = null), d(e), c || o(Error(e));
+			};
+			n.on("error", (e) => l(e.message)), n.on("exit", (e, t) => l(`introspect worker exited (${t ?? `code ${e}`})`));
+		});
+		return a = s, s;
+	}
+	async function h(e) {
+		if (s) return {
+			ok: !1,
+			reason: "introspect session disposed"
+		};
+		try {
+			await m();
+		} catch (e) {
+			return {
+				ok: !1,
+				reason: e instanceof Error ? e.message : String(e)
+			};
+		}
+		let t = i;
+		if (!t?.stdin?.writable) return {
+			ok: !1,
+			reason: "introspect worker is not writable"
+		};
+		let r = ++c;
+		return new Promise((i) => {
+			let a = setTimeout(() => {
+				u.delete(r), f(`introspection timed out after ${n}ms`), i({
+					ok: !1,
+					reason: `introspection timed out after ${n}ms`
+				});
+			}, n);
+			u.set(r, (e) => {
+				clearTimeout(a), i(e);
+			});
+			try {
+				t.stdin?.write(`${JSON.stringify({
+					id: r,
+					outFile: e
+				})}\n`);
+			} catch (e) {
+				clearTimeout(a), u.delete(r), o = !0, i({
+					ok: !1,
+					reason: e instanceof Error ? e.message : String(e)
+				});
+			}
+		});
+	}
+	return {
+		introspect(e) {
+			let t = l.then(() => h(e));
+			return l = t.catch(() => void 0), t;
+		},
+		async dispose() {
+			s = !0, f("introspect session disposed");
+		},
+		get childPid() {
+			return i?.pid ?? null;
+		}
+	};
+}
+//#endregion
 //#region src/vite/index.ts
-function S(e) {
+function E(e) {
 	let t = JSON.stringify(e, Object.keys(e).sort());
-	return o("sha256").update(t).digest("hex").slice(0, 16);
+	return a("sha256").update(t).digest("hex").slice(0, 16);
 }
-var C = 20;
-async function w(e, t) {
+var D = 20;
+async function O(e, t) {
 	if (e === void 0) return;
 	let n;
 	try {
@@ -33,7 +207,7 @@ async function w(e, t) {
 	let a = i.error.issues.map((e) => `  examples${e.path.length ? `[${e.path.join("][")}]` : ""}: ${e.message}`).join("\n");
 	throw Error(`[widget-sdk] Invalid \`examples\` for "${t}":\n${a}\nEach example needs a \`config\` object and a \`size\` of whole positive tiles, and at most 20 are rendered.`);
 }
-function T(e, t) {
+function k(e, t) {
 	if (!e?.length) return;
 	let n = e.map((e) => {
 		let t = e.label ? `"${e.label}"` : `#${e.index}`;
@@ -41,42 +215,7 @@ function T(e, t) {
 	}).join("\n");
 	throw Error(`[widget-sdk] Example config rejected by "${t}"'s own configSchema:\n${n}\nEach example's \`config\` must be a config the widget would actually accept, or its preview renders empty.`);
 }
-function E(e) {
-	let t = h(b(import.meta.url)), n = [g(t, "introspect.js"), g(t, "introspect.ts")].find((e) => s(e));
-	if (!n) return {
-		ok: !1,
-		reason: `introspect not found next to ${t}`
-	};
-	let r = a(process.execPath, [
-		"--conditions",
-		"browser",
-		n,
-		e
-	], {
-		encoding: "utf-8",
-		timeout: 3e4
-	});
-	if (r.error) return {
-		ok: !1,
-		reason: r.error.message
-	};
-	if (r.status !== 0) return {
-		ok: !1,
-		reason: (r.stderr || "").trim().split("\n")[0] || `exit ${r.status}`
-	};
-	try {
-		return {
-			ok: !0,
-			value: JSON.parse(r.stdout)
-		};
-	} catch {
-		return {
-			ok: !1,
-			reason: "introspect returned unparseable output"
-		};
-	}
-}
-var D = [
+var A = [
 	"schema",
 	"defaultConfig",
 	"examples",
@@ -89,80 +228,80 @@ var D = [
 	"minSize",
 	"maxSize"
 ];
-function O(e, t, n) {
-	let r = l(e, "utf-8"), i = JSON.parse(r), a = {
+function j(e, t, n) {
+	let r = c(e, "utf-8"), i = JSON.parse(r), a = {
 		...t.manifest ?? {},
 		schema: n
 	};
-	for (let e of D) a[e] !== void 0 && (i[e] = a[e]);
+	for (let e of A) a[e] !== void 0 && (i[e] = a[e]);
 	let o = `${JSON.stringify(i, null, 2)}\n`;
-	o !== r && p(e, o);
+	o !== r && f(e, o);
 }
-async function k(e) {
-	if (!s(e.outFile)) return;
-	let t = E(e.outFile);
+async function M(e) {
+	if (!o(e.outFile)) return;
+	let t = e.session ? await e.session.introspect(e.outFile) : T(e.outFile);
 	if (!t.ok) throw Error(`[widget-sdk] Could not read "${e.widgetName}" to check it: ${t.reason}\n  Its examples and config schema could not be validated, so the build cannot continue.
   This usually means the bundle throws while being imported.`);
 	let n = t.value, r = n.manifest?.name ?? e.widgetName;
-	await w(n.manifest?.examples, r), T(n.exampleConfigIssues, r);
+	await O(n.manifest?.examples, r), k(n.exampleConfigIssues, r);
 	let i = n.jsonSchema;
 	if (!i) return;
-	e.manifestPath && s(e.manifestPath) && O(e.manifestPath, n, i);
-	let a = S(i), o = n.manifest?.configVersion ?? null, c = n.manifest?.name ?? e.widgetName;
-	if (s(e.hashFile)) {
-		let t = l(e.hashFile, "utf-8").trim(), n = null;
+	e.manifestPath && o(e.manifestPath) && j(e.manifestPath, n, i);
+	let a = E(i), s = n.manifest?.configVersion ?? null, l = n.manifest?.name ?? e.widgetName;
+	if (o(e.hashFile)) {
+		let t = c(e.hashFile, "utf-8").trim(), n = null;
 		if (t.startsWith("{")) try {
 			n = JSON.parse(t);
 		} catch {
 			n = null;
 		}
 		if (n) {
-			if (n.hash !== a && n.configVersion === o) throw Error(`[widget-sdk] Config schema shape changed for "${c}" without a configVersion bump. Bump configVersion in defineWidget (currently ${o ?? "unset"}) or revert the schema change, then rebuild. Recorded in ${e.hashFile}`);
-		} else t !== a && console.warn(`[widget-sdk] Schema shape changed for "${c}" — verify configVersion was bumped`);
+			if (n.hash !== a && n.configVersion === s) throw Error(`[widget-sdk] Config schema shape changed for "${l}" without a configVersion bump. Bump configVersion in defineWidget (currently ${s ?? "unset"}) or revert the schema change, then rebuild. Recorded in ${e.hashFile}`);
+		} else t !== a && console.warn(`[widget-sdk] Schema shape changed for "${l}" — verify configVersion was bumped`);
 	}
-	p(e.hashFile, `${JSON.stringify({
+	f(e.hashFile, `${JSON.stringify({
 		hash: a,
-		configVersion: o
+		configVersion: s
 	})}\n`);
 }
-var A = "virtual:glasshome-widget", j = "\0virtual:glasshome-widget", M = "/@glasshome/preview";
-function N(e) {
-	return y === "\\" ? e.split(y).join("/") : e;
+var ie = "virtual:glasshome-widget", N = "\0virtual:glasshome-widget", P = "/@glasshome/preview";
+function F(e) {
+	return v === "\\" ? e.split(v).join("/") : e;
 }
-function P() {
-	let e = b(import.meta.url);
-	return v(h(e), "../../preview");
+function I() {
+	let e = y(import.meta.url);
+	return _(m(e), "../../preview");
 }
-function F(e) {
+function L(e) {
 	return r(e);
 }
-var I = /\.(ts|tsx|js|jsx)$/, L = /from\s+["']@glasshome\/sync-layer(\/[^"']*)?["']/;
-function R(e, t) {
-	let n = N(e).split("?")[0] ?? "";
-	return n.includes("/node_modules/") || !I.test(n) ? !1 : L.test(t);
+var R = /\.(ts|tsx|js|jsx)$/, z = /from\s+["']@glasshome\/sync-layer(\/[^"']*)?["']/;
+function B(e, t) {
+	let n = F(e).split("?")[0] ?? "";
+	return n.includes("/node_modules/") || !R.test(n) ? !1 : z.test(t);
 }
-function z() {
+function V() {
 	return {
 		name: "glasshome-widget:sync-layer-guard",
 		apply: "build",
 		enforce: "pre",
 		transform(e, t) {
-			if (R(t, e)) throw Error(`Widgets must not import "@glasshome/sync-layer" directly (imported by ${N(_(process.cwd(), t.split("?")[0] ?? t))}). Import the equivalent hook from "@glasshome/widget-sdk" instead (e.g. useEntity, useEntities, useService).`);
+			if (B(t, e)) throw Error(`Widgets must not import "@glasshome/sync-layer" directly (imported by ${F(g(process.cwd(), t.split("?")[0] ?? t))}). Import the equivalent hook from "@glasshome/widget-sdk" instead (e.g. useEntity, useEntities, useService).`);
 			return null;
 		}
 	};
 }
-function B(t, n) {
-	let r = N(t).split("?")[0] ?? "";
-	if (r.includes("/node_modules/") || !I.test(r)) return !1;
+function H(t, n) {
+	let r = F(t).split("?")[0] ?? "";
+	if (r.includes("/node_modules/") || !R.test(r)) return !1;
 	let i = e.find((e) => e.id === "direct-ui-import");
 	return i?.sourcePattern ? new RegExp(i.sourcePattern).test(n) : !1;
 }
-function V(e = /* @__PURE__ */ new Set()) {
+function U(e = /* @__PURE__ */ new Set()) {
 	let t = /* @__PURE__ */ new Set();
 	return {
 		scan(e, n) {
-			B(e, n) && t.add(N(_(process.cwd(), e.split("?")[0] ?? e)));
+			H(e, n) && t.add(F(g(process.cwd(), e.split("?")[0] ?? e)));
 		},
 		take() {
 			let n = [...t].filter((t) => !e.has(t));
@@ -171,8 +310,8 @@ function V(e = /* @__PURE__ */ new Set()) {
 		}
 	};
 }
-function H(n) {
-	let r = V(n);
+function W(n) {
+	let r = U(n);
 	return {
 		name: "glasshome-widget:ui-import-guard",
 		apply: "build",
@@ -188,15 +327,15 @@ function H(n) {
 		}
 	};
 }
-var U = "node_modules/.cache/glasshome-widgets";
-function W(e) {
+var G = "node_modules/.cache/glasshome-widgets";
+function K(e) {
 	try {
-		return m(g(process.cwd(), "package.json")).resolve(e);
+		return p(h(process.cwd(), "package.json")).resolve(e);
 	} catch {
 		return null;
 	}
 }
-var G = [
+var q = [
 	"--radius",
 	"--background",
 	"--foreground",
@@ -206,74 +345,74 @@ var G = [
 	"--muted",
 	"--accent"
 ];
-function K(e, t) {
-	let n = g(e, `${t}.css`);
-	if (!s(n)) return;
-	let r = l(n, "utf-8");
+function J(e, t) {
+	let n = h(e, `${t}.css`);
+	if (!o(n)) return;
+	let r = c(n, "utf-8");
 	for (let e of r.matchAll(/:host[^{]*\{([^}]*)\}/g)) {
-		let n = e[1] ?? "", r = G.find((e) => n.includes(`${e}:`));
+		let n = e[1] ?? "", r = q.find((e) => n.includes(`${e}:`));
 		if (r) throw Error(`[glasshome-widget] "${t}.css" defines theme variable "${r}" on :host. Theme variables must inherit from the document so widgets follow the household theme — never re-scope them into the widget's shadow root.`);
 	}
 }
-function q(e, t, n) {
-	let r = v(e, U);
-	c(r, { recursive: !0 });
-	let i = W("@glasshome/ui/styles");
+function Y(e, t, n) {
+	let r = _(e, G);
+	s(r, { recursive: !0 });
+	let i = K("@glasshome/ui/styles");
 	if (!i) throw Error("[widget-sdk] @glasshome/ui is required to build widgets (it provides the theme every GlassHome widget ships with). Add it to your widget's dependencies.");
-	let a = v(h(i), "../.."), o = W("@glasshome/widget-sdk/tailwind-sources"), l = o ? h(o) : null, u = [
-		g(a, "src"),
-		g(a, "dist"),
-		...l ? [g(l, "src"), g(l, "dist")] : [],
-		h(n)
-	].filter((e) => s(e)), d = v(r, `${t}.tailwind.css`);
-	p(d, [
+	let a = _(m(i), "../.."), c = K("@glasshome/widget-sdk/tailwind-sources"), l = c ? m(c) : null, u = [
+		h(a, "src"),
+		h(a, "dist"),
+		...l ? [h(l, "src"), h(l, "dist")] : [],
+		m(n)
+	].filter((e) => o(e)), d = _(r, `${t}.tailwind.css`);
+	f(d, [
 		"@import \"tailwindcss\" source(none);",
 		"@import \"tw-animate-css\";",
 		"@import \"@glasshome/ui/styles/theme\";",
-		...u.map((e) => `@source "${N(e)}";`),
+		...u.map((e) => `@source "${F(e)}";`),
 		"@custom-variant dark {",
 		"  &:is(.dark *) { @slot }",
 		"  :host(.dark) & { @slot }",
 		"}",
 		""
 	].join("\n"));
-	let f = v(r, `${t}.entry.ts`);
-	return p(f, [
-		`import "${N(d)}";`,
-		`export { default } from "${N(n)}";`,
+	let p = _(r, `${t}.entry.ts`);
+	return f(p, [
+		`import "${F(d)}";`,
+		`export { default } from "${F(n)}";`,
 		""
-	].join("\n")), f;
+	].join("\n")), p;
 }
-function J() {
-	let e = x();
+function X() {
+	let e = ee();
 	for (let t of e) t.apply ??= "build";
 	return e;
 }
-function Y(e) {
+function Z(e) {
 	let t = [];
-	if (!s(e)) return t;
-	for (let n of u(e)) {
-		let r = v(e, n);
-		if (!f(r).isDirectory()) continue;
-		let i = v(r, "index.tsx"), a = v(r, "manifest.json");
-		s(i) && s(a) && t.push({
+	if (!o(e)) return t;
+	for (let n of l(e)) {
+		let r = _(e, n);
+		if (!d(r).isDirectory()) continue;
+		let i = _(r, "index.tsx"), a = _(r, "manifest.json");
+		o(i) && o(a) && t.push({
 			name: n,
 			entry: i
 		});
 	}
 	return t;
 }
-function X(e, t) {
+function Q(e, t) {
 	let r = [];
-	if (s(e)) for (let a of u(e)) {
-		if (!f(g(e, a)).isDirectory()) continue;
-		let o = g(e, a, "manifest.json");
-		if (!s(o)) continue;
-		let c = i.safeParse(JSON.parse(l(o, "utf-8")));
-		if (!c.success) throw Error(`[registry] Invalid manifest for "${a}": ${n(c.error)}`);
-		let u = s(g(t, `${a}.css`));
+	if (o(e)) for (let a of l(e)) {
+		if (!d(h(e, a)).isDirectory()) continue;
+		let s = h(e, a, "manifest.json");
+		if (!o(s)) continue;
+		let l = i.safeParse(JSON.parse(c(s, "utf-8")));
+		if (!l.success) throw Error(`[registry] Invalid manifest for "${a}": ${n(l.error)}`);
+		let u = o(h(t, `${a}.css`));
 		r.push({
-			...c.data,
+			...l.data,
 			bundleUrl: `./${a}.js`,
 			...u ? { cssUrl: `./${a}.css` } : {}
 		});
@@ -284,10 +423,10 @@ function X(e, t) {
 		baseUrl: "./",
 		widgets: r
 	};
-	s(t) || c(t, { recursive: !0 }), p(g(t, "registry.json"), JSON.stringify(a, null, 2)), console.log(`[registry] Generated registry.json with ${r.length} widget(s)`);
+	o(t) || s(t, { recursive: !0 }), f(h(t, "registry.json"), JSON.stringify(a, null, 2)), console.log(`[registry] Generated registry.json with ${r.length} widget(s)`);
 }
-async function Z(e) {
-	let { build: t } = await import("vite"), n = process.cwd(), r = v(n, e?.srcDir ?? "src"), i = v(n, e?.outDir ?? "dist"), a = Y(r);
+async function $(e) {
+	let { build: t } = await import("vite"), n = process.cwd(), r = _(n, e?.srcDir ?? "src"), i = _(n, e?.outDir ?? "dist"), a = Z(r);
 	if (a.length === 0) {
 		console.warn("[glasshome-widgets] No widgets found in", r);
 		return;
@@ -296,41 +435,42 @@ async function Z(e) {
 		let t = new Set(e.only);
 		a = a.filter((e) => t.has(e.name));
 	}
-	e?.only || s(i) && d(i, { recursive: !0 }), s(i) || c(i, { recursive: !0 });
-	let o = /* @__PURE__ */ new Set();
+	e?.only || o(i) && u(i, { recursive: !0 }), o(i) || s(i, { recursive: !0 });
+	let c = /* @__PURE__ */ new Set();
 	for (let r of a) await t({
 		configFile: !1,
 		root: n,
 		plugins: [
-			...J(),
+			...X(),
 			...e?.plugins ?? [],
-			z(),
-			H(o)
+			V(),
+			W(c)
 		],
 		...e?.viteConfig,
 		build: {
 			lib: {
-				entry: q(n, r.name, r.entry),
+				entry: Y(n, r.name, r.entry),
 				formats: ["es"],
 				fileName: r.name,
 				cssFileName: r.name
 			},
-			rollupOptions: { external: F },
+			rollupOptions: { external: L },
 			outDir: i,
 			emptyOutDir: !1,
 			copyPublicDir: !1,
 			...e?.viteConfig?.build
 		},
 		logLevel: "warn"
-	}), K(i, r.name), await k({
-		outFile: g(i, `${r.name}.js`),
-		hashFile: g(h(r.entry), ".schema-hash"),
+	}), J(i, r.name), await M({
+		outFile: h(i, `${r.name}.js`),
+		hashFile: h(m(r.entry), ".schema-hash"),
 		widgetName: r.name,
-		manifestPath: g(h(r.entry), "manifest.json")
+		manifestPath: h(m(r.entry), "manifest.json"),
+		session: e?.session
 	});
-	X(r, i);
+	Q(r, i);
 }
-function Q(e) {
+function ae(e) {
 	let t = e?.entry ?? "src/index.tsx", n = {
 		name: "glasshome-widget:build",
 		apply: "build",
@@ -338,12 +478,12 @@ function Q(e) {
 			let e = process.cwd();
 			return { build: {
 				lib: {
-					entry: q(e, "index", v(e, t)),
+					entry: Y(e, "index", _(e, t)),
 					formats: ["es"],
 					fileName: "index",
 					cssFileName: "index"
 				},
-				rollupOptions: { external: F }
+				rollupOptions: { external: L }
 			} };
 		}
 	}, r = {
@@ -351,18 +491,18 @@ function Q(e) {
 		apply: "serve",
 		enforce: "pre",
 		config() {
-			let e = P(), t = process.cwd();
+			let e = I(), t = process.cwd();
 			return { server: { fs: { allow: [
 				e,
 				t,
-				v(t, "..", "..")
+				_(t, "..", "..")
 			] } } };
 		},
 		configureServer(e) {
-			let t = P(), n = g(t, "preview.html");
+			let t = I(), n = h(t, "preview.html");
 			e.middlewares.use(async (t, r, i) => {
 				if (t.url === "/" || t.url === "/index.html") try {
-					let i = l(n, "utf-8");
+					let i = c(n, "utf-8");
 					i = await e.transformIndexHtml(t.url, i), r.setHeader("Content-Type", "text/html"), r.statusCode = 200, r.end(i);
 				} catch (e) {
 					i(e);
@@ -371,37 +511,37 @@ function Q(e) {
 			});
 		},
 		resolveId(e) {
-			if (e === M) {
-				let e = P();
-				return N(g(e, "host.tsx"));
+			if (e === P) {
+				let e = I();
+				return F(h(e, "host.tsx"));
 			}
-			if (e === A) return j;
+			if (e === ie) return N;
 		},
 		load(e) {
-			if (e === j) return `export { default } from "${N(v(process.cwd(), t))}";`;
+			if (e === N) return `export { default } from "${F(_(process.cwd(), t))}";`;
 		}
 	}, i = {
 		name: "glasshome-widget:schema",
 		apply: "build",
 		async closeBundle() {
-			K(v(process.cwd(), "dist"), "index"), await k({
-				outFile: v(process.cwd(), "dist", "index.js"),
-				hashFile: v(process.cwd(), ".schema-hash"),
+			J(_(process.cwd(), "dist"), "index"), await M({
+				outFile: _(process.cwd(), "dist", "index.js"),
+				hashFile: _(process.cwd(), ".schema-hash"),
 				widgetName: "index",
-				manifestPath: v(process.cwd(), "manifest.json")
+				manifestPath: _(process.cwd(), "manifest.json")
 			});
 		}
 	};
 	return [
-		...J(),
+		...X(),
 		n,
-		z(),
-		H(),
+		V(),
+		W(),
 		i,
 		r
 	];
 }
-function $(e) {
+function oe(e) {
 	let t = e?.srcDir ?? "src", n = e?.outDir ?? "dist", r = [];
 	return [{
 		name: "glasshome-widgets:build",
@@ -420,7 +560,7 @@ function $(e) {
 			if (e === "\0glasshome-noop") return "export {}";
 		},
 		async closeBundle() {
-			await Z({
+			await $({
 				srcDir: t,
 				outDir: n,
 				plugins: r
@@ -429,4 +569,4 @@ function $(e) {
 	}];
 }
 //#endregion
-export { C as MAX_EXAMPLES, Z as buildWidgets, V as createUiImportTracker, Y as discoverWidgets, X as generateRegistry, Q as glasshomeWidget, $ as glasshomeWidgets, R as isDirectSyncLayerImportSource, B as isDirectUiImportSource, F as isWidgetExternal, k as runSchemaGuard };
+export { D as MAX_EXAMPLES, $ as buildWidgets, re as createIntrospectSession, U as createUiImportTracker, Z as discoverWidgets, Q as generateRegistry, ae as glasshomeWidget, oe as glasshomeWidgets, T as introspectOnce, B as isDirectSyncLayerImportSource, H as isDirectUiImportSource, L as isWidgetExternal, M as runSchemaGuard };

package/dist/vite/introspect-core.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Reads a built widget bundle's definition under a fake DOM.
+ *
+ * A widget bundle cannot be imported by the build process: `solid-js/web`
+ * resolves to its server build under Node's conditions and throws the moment
+ * the module initialises, and browser conditions then need a DOM for the
+ * templates Solid creates at import time. Both callers (the one-shot
+ * `introspect.ts` CLI and the persistent `introspect-worker.ts`) run under
+ * `--conditions browser` and install a DOM before importing.
+ */
+export interface ExampleConfigIssue {
+    index: number;
+    label?: string;
+    problems: string[];
+}
+export interface WidgetIntrospection {
+    manifest: ({
+        name?: string;
+        configVersion?: number;
+        examples?: unknown;
+    } & Record<string, unknown>) | null;
+    /** JSON Schema derived from the widget's configSchema, when it has one. */
+    jsonSchema: object | null;
+    /** Examples whose config the widget's own configSchema rejects. */
+    exampleConfigIssues: ExampleConfigIssue[];
+}
+/**
+ * Install a fresh DOM. Unconditional: the persistent worker calls this per
+ * request, and skipping already-set keys would leak the previous widget's
+ * mutated window into the next one.
+ */
+export declare function installDom(): Promise<void>;
+export declare function introspectBundle(bundlePath: string, cacheBust?: string): Promise<WidgetIntrospection>;

package/dist/vite/introspect-session.d.ts

@@ -0,0 +1,30 @@
+import type { WidgetIntrospection } from "./introspect-core";
+export type IntrospectResult = {
+    ok: true;
+    value: WidgetIntrospection;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface IntrospectSessionOptions {
+    /** Respawn once the worker's RSS crosses this, between requests only. */
+    rssLimitBytes?: number;
+    /** Per-request ceiling; a module-eval hang can only be cured by a kill. */
+    timeoutMs?: number;
+    /** Log spawn and import durations above this. */
+    slowMs?: number;
+}
+export interface IntrospectSession {
+    introspect(outFile: string): Promise<IntrospectResult>;
+    dispose(): Promise<void>;
+    readonly childPid: number | null;
+}
+/** One process per check. The path `build`, `capture` and the fallback take. */
+export declare function introspectOnce(outFile: string): IntrospectResult;
+/**
+ * A worker reused across rebuilds, for callers that own a session.
+ *
+ * Only `bun widget connect`'s watch loop does: it is the one call site that
+ * re-pays the per-check process boot tax on every save.
+ */
+export declare function createIntrospectSession(options?: IntrospectSessionOptions): IntrospectSession;

package/dist/vite/introspect-worker.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Long-lived introspection worker for `bun widget connect`.
+ *
+ * Newline-delimited JSON over stdio. Every request carries an id: a widget
+ * bundle can print at module-eval time, and without id pairing one stray line
+ * offsets every later response.
+ *
+ * Usage: bun --conditions browser introspect-worker.js
+ */
+export {};

package/dist/vite/introspect-worker.js

@@ -0,0 +1,76 @@
+import { n as e, t } from "../introspect-core-DYv9Uufi.js";
+//#region src/vite/introspect-worker.ts
+var n = process.stdout.write.bind(process.stdout);
+process.stdout.write = ((e, ...t) => process.stderr.write(e, ...t));
+function r(e) {
+	n(`${JSON.stringify(e)}\n`);
+}
+function i(e) {
+	return e instanceof Error ? e.message : String(e);
+}
+var a = null, o = 0, s = Promise.resolve();
+async function c(n, s) {
+	a = n;
+	let c = performance.now();
+	try {
+		await t(), r({
+			id: n,
+			ok: !0,
+			value: await e(s, String(++o)),
+			rss: process.memoryUsage().rss,
+			importMs: Math.round(performance.now() - c)
+		});
+	} catch (e) {
+		r({
+			id: n,
+			ok: !1,
+			reason: i(e),
+			rss: process.memoryUsage().rss,
+			importMs: Math.round(performance.now() - c)
+		});
+	} finally {
+		a = null;
+	}
+}
+function l(e) {
+	let t;
+	try {
+		t = JSON.parse(e);
+	} catch {
+		return;
+	}
+	if (typeof t.id != "number" || typeof t.outFile != "string") return;
+	let { id: n, outFile: r } = t;
+	s = s.then(() => c(n, r));
+}
+function u(e) {
+	a !== null && r({
+		id: a,
+		ok: !1,
+		reason: i(e),
+		rss: process.memoryUsage().rss,
+		importMs: 0
+	}), process.exit(1);
+}
+process.on("uncaughtException", u), process.on("unhandledRejection", u);
+var d = "";
+process.stdin.setEncoding("utf-8"), process.stdin.on("data", (e) => {
+	d += e;
+	let t = d.indexOf("\n");
+	for (; t >= 0;) {
+		let e = d.slice(0, t).trim();
+		d = d.slice(t + 1), e && l(e), t = d.indexOf("\n");
+	}
+}), process.stdin.on("end", () => process.exit(0)), process.stdin.on("close", () => process.exit(0)), process.stdin.resume();
+var f = process.ppid;
+setInterval(() => {
+	try {
+		process.kill(f, 0);
+	} catch {
+		process.exit(0);
+	}
+}, 5e3), r({
+	id: 0,
+	ready: !0
+});
+//#endregion

package/dist/vite/introspect.d.ts

@@ -1,21 +1,12 @@
 /**
  * Reads a built widget bundle's definition and prints it as JSON.
  *
- * Runs as its own process because a widget bundle cannot be imported by the
- * build: `solid-js/web` resolves to its server build under Node's conditions
- * and throws "Client-only API called on the server side" the moment the module
- * initialises, and forcing browser conditions then needs a DOM for the
- * templates Solid creates at import time. The build spawns this with
- * `--conditions browser` and a DOM in place, so the import succeeds.
- *
- * Until this existed the guard swallowed that import failure and silently did
- * nothing — for every widget, on every build.
+ * One-shot counterpart to introspect-worker.ts: a fresh process per check, used
+ * by `bun widget build`, the render worker's capture, and as the
+ * GLASSHOME_WIDGET_NO_WORKER fallback.
  *
  * Usage: bun --conditions browser introspect.js <bundle.js>
- * Prints: { manifest, jsonSchema } on stdout, or exits non-zero with a reason.
+ * Prints: { manifest, jsonSchema, exampleConfigIssues } on stdout, or exits
+ * non-zero with a reason.
  */
-export interface ExampleConfigIssue {
-    index: number;
-    label?: string;
-    problems: string[];
-}
+export {};

package/dist/vite/introspect.js

@@ -1,60 +1,10 @@
-import { pathToFileURL as e } from "node:url";
+import { n as e, t } from "../introspect-core-DYv9Uufi.js";
 //#region src/vite/introspect.ts
-function t(e) {
-	return typeof e?.safeParse == "function";
+async function n() {
+	let n = process.argv[2];
+	n || (process.stderr.write("introspect: no bundle path given\n"), process.exit(2)), await t(), process.stdout.write(JSON.stringify(await e(n)));
 }
-function n(e, n) {
-	if (!t(e) || !Array.isArray(n)) return [];
-	let r = [];
-	for (let [t, i] of n.entries()) {
-		let n = i?.config;
-		if (typeof n != "object" || !n) continue;
-		let a = e.safeParse(n);
-		a.success || r.push({
-			index: t,
-			label: i.label,
-			problems: (a.error?.issues ?? []).map((e) => {
-				let t = e.path.map(String).join(".");
-				return t ? `${t}: ${e.message}` : e.message;
-			})
-		});
-	}
-	return r;
-}
-async function r() {
-	let { Window: e } = await import("happy-dom"), t = new e({ url: "http://localhost" });
-	for (let e of [
-		"window",
-		"document",
-		"navigator",
-		"location",
-		"customElements",
-		"HTMLElement",
-		"Element",
-		"Node",
-		"CSS",
-		"getComputedStyle",
-		"requestAnimationFrame",
-		"cancelAnimationFrame",
-		"matchMedia"
-	]) globalThis[e] === void 0 && (globalThis[e] = t[e]);
-}
-async function i() {
-	let t = process.argv[2];
-	t || (process.stderr.write("introspect: no bundle path given\n"), process.exit(2)), await r();
-	let i = (await import(e(t).href)).default, a = null;
-	if (i?.configSchema) {
-		let { z: e } = await import("zod");
-		a = e.toJSONSchema(i.configSchema, { unrepresentable: "any" });
-	}
-	let o = {
-		manifest: i?.manifest ?? null,
-		jsonSchema: a,
-		exampleConfigIssues: n(i?.configSchema, i?.manifest?.examples)
-	};
-	process.stdout.write(JSON.stringify(o));
-}
-i().catch((e) => {
+n().catch((e) => {
 	process.stderr.write(`${e instanceof Error ? e.message : String(e)}\n`), process.exit(1);
 });
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glasshome/widget-sdk",
-  "version": "1.10.3",
+  "version": "1.11.0",
   "description": "SDK for building GlassHome dashboard widgets with SolidJS",
   "keywords": [
     "glasshome",