@glasshome/widget-sdk 1.22.2 → 1.23.0

package/dist/index.js

@@ -3136,7 +3136,7 @@ function Co() {
 //#region src/version.ts
 var wo = {
 	name: "@glasshome/widget-sdk",
-	version: "1.22.2",
+	version: "1.23.0",
 	description: "SDK for building GlassHome dashboard widgets with SolidJS",
 	keywords: [
 		"dashboard",
@@ -3207,7 +3207,7 @@ var wo = {
 		lint: "oxlint --type-aware . && oxfmt --check ."
 	},
 	dependencies: {
-		"@glasshome/widget-contract": "0.3.0",
+		"@glasshome/widget-contract": "0.4.0",
 		"@tailwindcss/vite": "^4.1.13",
 		clsx: "^2.1.1",
 		"happy-dom": "^20.0.0",
@@ -3217,7 +3217,7 @@ var wo = {
 		zod: "^4.1.13"
 	},
 	devDependencies: {
-		"@glasshome/ui": "1.30.0",
+		"@glasshome/ui": "1.33.0",
 		"@solidjs/testing-library": "^0.8.10",
 		"@types/bun": "^1.4.0",
 		"@types/node": "^25.2.2",

package/dist/vite/in-process-introspector.d.ts

@@ -0,0 +1,2 @@
+import type { Introspector } from "./index";
+export declare const inProcessIntrospector: Introspector;

package/dist/vite/index.d.ts

@@ -1,7 +1,7 @@
 import { type CapabilityGrant } from "@glasshome/widget-contract";
 import type { InlineConfig, Plugin } from "vite";
 import type { ExampleConfigIssue, WidgetIntrospection } from "./introspect-core";
-import { createIntrospectSession, type IntrospectSession, type IntrospectSessionOptions, introspectOnce } from "./introspect-session";
+import { createIntrospectSession, type IntrospectResult, type IntrospectSession, type IntrospectSessionOptions, introspectOnce } from "./introspect-session";
 export { createIntrospectSession, introspectOnce };
 export type { ExampleConfigIssue, IntrospectSession, IntrospectSessionOptions, WidgetIntrospection, };
 export interface GlasshomeWidgetOptions {
@@ -21,6 +21,7 @@ export declare function sdkImportsOf(code: string): Set<string>;
 /** SDK hooks that read a fixed entity on the widget's behalf, so the widget must declare that read. */
 export declare const HOOK_READS: Record<string, string>;
 export declare function assertHookReadsDeclared(code: string, capabilities: readonly CapabilityGrant[], widgetName: string): void;
+export type Introspector = (outFile: string) => IntrospectResult | Promise<IntrospectResult>;
 export declare function runSchemaGuard(args: {
     outFile: string;
     hashFile: string;
@@ -28,6 +29,8 @@ export declare function runSchemaGuard(args: {
     manifestPath?: string;
     /** Persistent worker to reuse. Only `bun widget connect`'s watch loop passes one. */
     session?: IntrospectSession;
+    /** Reads the bundle when no session is given. Defaults to one subprocess per call. */
+    introspect?: Introspector;
 }): Promise<void>;
 /**
  * Packages provided by the host import map — widgets must not bundle these.

package/dist/vite/index.js

@@ -6,40 +6,46 @@ 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 ee from "@tailwindcss/vite";
-import { spawn as te, spawnSync as ne } from "node:child_process";
-//#region src/vite/introspect-session.ts
-var x = 262144e3, S = 3e4, re = 3e3;
-function C(e) {
+import { spawn as te, spawnSync as x } from "node:child_process";
+//#region node_modules/@glasshome/widget-contract/dist/clock.mjs
+var S = (e) => e, C = (e) => e, ne = {
+	now: () => Date.now(),
+	setTimeout: (e, t) => S(globalThis.setTimeout(e, t)),
+	clearTimeout: (e) => globalThis.clearTimeout(C(e)),
+	setInterval: (e, t) => S(globalThis.setInterval(e, t)),
+	clearInterval: (e) => globalThis.clearInterval(C(e))
+}, re = 262144e3, w = 3e4, ie = 3e3;
+function T(e) {
 	let t = h(b(import.meta.url));
 	return [g(t, `${e}.js`), g(t, `${e}.ts`)].find((e) => s(e)) ?? null;
 }
-function w(e) {
-	let t = C("introspect");
-	if (!t) return {
+function E(e, t) {
+	let n = T("introspect");
+	if (!n) return {
 		ok: !1,
 		reason: "introspect not found next to the sdk"
 	};
-	let n = ne(process.execPath, [
+	let r = x(process.execPath, [
 		"--conditions",
 		"browser",
-		t,
+		n,
 		e
 	], {
 		encoding: "utf-8",
-		timeout: S
+		timeout: t?.timeoutMs ?? w
 	});
-	if (n.error) return {
+	if (r.error) return {
 		ok: !1,
-		reason: n.error.message
+		reason: r.error.message
 	};
-	if (n.status !== 0) return {
+	if (r.status !== 0) return {
 		ok: !1,
-		reason: (n.stderr || "").trim().split("\n")[0] || `exit ${n.status}`
+		reason: (r.stderr || "").trim().split("\n")[0] || `exit ${r.status}`
 	};
 	try {
 		return {
 			ok: !0,
-			value: JSON.parse(n.stdout)
+			value: JSON.parse(r.stdout)
 		};
 	} catch {
 		return {
@@ -48,27 +54,63 @@ function w(e) {
 		};
 	}
 }
-function ie() {
+function ae(e) {
+	let t = te(process.execPath, [
+		"--conditions",
+		"browser",
+		e
+	], { stdio: [
+		"pipe",
+		"pipe",
+		"inherit"
+	] });
+	return {
+		write(e) {
+			return t.stdin?.writable ? (t.stdin.write(e), !0) : !1;
+		},
+		onLine(e) {
+			let n = "";
+			t.stdout?.setEncoding("utf-8"), t.stdout?.on("data", (t) => {
+				n += t;
+				let r = n.indexOf("\n");
+				for (; r >= 0;) {
+					let t = n.slice(0, r).trim();
+					n = n.slice(r + 1), t && e(t), r = n.indexOf("\n");
+				}
+			});
+		},
+		onExit(e) {
+			t.on("error", (t) => e(t.message)), t.on("exit", (t, n) => e(`introspect worker exited (${n ?? `code ${t}`})`));
+		},
+		kill() {
+			t.kill();
+		},
+		get pid() {
+			return t.pid ?? null;
+		}
+	};
+}
+function oe(e) {
 	return {
-		introspect: async (e) => w(e),
+		introspect: async (t) => E(t, { timeoutMs: e }),
 		dispose: async () => {},
 		childPid: null
 	};
 }
-function ae(e) {
-	if (process.env.GLASSHOME_WIDGET_NO_WORKER === "1") return ie();
-	let t = e?.rssLimitBytes ?? x, n = e?.timeoutMs ?? S, r = e?.slowMs ?? re, i = null, a = !1, o = 0, s = Promise.resolve();
-	function c(e, t) {
+function se(e) {
+	if (process.env.GLASSHOME_WIDGET_NO_WORKER === "1") return oe(e?.timeoutMs);
+	let t = e?.rssLimitBytes ?? re, n = e?.timeoutMs ?? w, r = e?.slowMs ?? ie, i = e?.clock ?? ne, a = e?.spawnWorker ?? ae, o = null, s = !1, c = 0, l = Promise.resolve();
+	function u(e, t) {
 		for (let n of e.pending.values()) n({
 			ok: !1,
 			reason: t
 		});
 		e.pending.clear();
 	}
-	function l(e, t) {
-		i === e && (i = null), c(e, t), e.proc.kill();
+	function d(e, t) {
+		o === e && (o = null), u(e, t), e.proc.kill();
 	}
-	function u(e, n) {
+	function f(e, n) {
 		let i;
 		try {
 			i = JSON.parse(n);
@@ -85,56 +127,38 @@ function ae(e) {
 			reason: i.reason ?? "introspection failed"
 		}));
 	}
-	function d(e) {
-		let t = Date.now(), n = te(process.execPath, [
-			"--conditions",
-			"browser",
-			e
-		], { stdio: [
-			"pipe",
-			"pipe",
-			"inherit"
-		] }), a = {
-			proc: n,
+	function p(e) {
+		let t = i.now(), n = {
+			proc: a(e),
 			ready: Promise.resolve(),
 			pending: /* @__PURE__ */ new Map(),
 			retireAfterRequest: !1
 		};
-		return a.ready = new Promise((e, o) => {
-			let s = "", l = !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 (!l && n.includes("\"ready\"")) {
-							l = !0;
-							let n = Date.now() - t;
-							n > r && console.warn(`[widget-sdk] introspect worker took ${n}ms to boot`), e();
-						} else u(a, n);
-					}
-					i = s.indexOf("\n");
-				}
+		return n.ready = new Promise((e, a) => {
+			let s = !1;
+			n.proc.onLine((a) => {
+				if (!s && a.includes("\"ready\"")) {
+					s = !0;
+					let n = i.now() - t;
+					n > r && console.warn(`[widget-sdk] introspect worker took ${n}ms to boot`), e();
+				} else f(n, a);
+			}), n.proc.onExit((e) => {
+				s || a(Error(e)), o === n && (o = null), u(n, e);
 			});
-			let d = (e) => {
-				l || o(Error(e)), i === a && (i = null), c(a, e);
-			};
-			n.on("error", (e) => d(e.message)), n.on("exit", (e, t) => d(`introspect worker exited (${t ?? `code ${e}`})`));
-		}), a;
+		}), n;
 	}
-	async function f(e) {
-		if (a) return {
+	async function m(e) {
+		if (s) return {
 			ok: !1,
 			reason: "introspect session disposed"
 		};
-		let t = C("introspect-worker");
+		let t = T("introspect-worker");
 		if (!t) return {
 			ok: !1,
 			reason: "introspect-worker not found next to the sdk"
 		};
-		i?.retireAfterRequest && l(i, "worker was replaced");
-		let r = i ??= d(t);
+		o?.retireAfterRequest && d(o, "worker was replaced");
+		let r = o ??= p(t);
 		try {
 			await r.ready;
 		} catch (e) {
@@ -143,28 +167,24 @@ function ae(e) {
 				reason: e instanceof Error ? e.message : String(e)
 			};
 		}
-		if (!r.proc.stdin?.writable) return {
-			ok: !1,
-			reason: "introspect worker is not writable"
-		};
-		let s = ++o;
+		let a = ++c;
 		return new Promise((t) => {
-			let i = setTimeout(() => {
-				r.pending.delete(s), l(r, `introspection timed out after ${n}ms`), t({
+			let o = i.setTimeout(() => {
+				r.pending.delete(a), d(r, `introspection timed out after ${n}ms`), t({
 					ok: !1,
 					reason: `introspection timed out after ${n}ms`
 				});
 			}, n);
-			r.pending.set(s, (e) => {
-				clearTimeout(i), t(e);
+			r.pending.set(a, (e) => {
+				i.clearTimeout(o), t(e);
 			});
 			try {
-				r.proc.stdin?.write(`${JSON.stringify({
-					id: s,
+				if (!r.proc.write(`${JSON.stringify({
+					id: a,
 					outFile: e
-				})}\n`);
+				})}\n`)) throw Error("introspect worker is not writable");
 			} catch (e) {
-				clearTimeout(i), r.pending.delete(s), r.retireAfterRequest = !0, t({
+				i.clearTimeout(o), r.pending.delete(a), r.retireAfterRequest = !0, t({
 					ok: !1,
 					reason: e instanceof Error ? e.message : String(e)
 				});
@@ -173,33 +193,33 @@ function ae(e) {
 	}
 	return {
 		introspect(e) {
-			let t = s.then(() => f(e));
-			return s = t.catch(() => void 0), t;
+			let t = l.then(() => m(e));
+			return l = t.catch(() => void 0), t;
 		},
 		async dispose() {
-			a = !0, i && l(i, "introspect session disposed");
+			s = !0, o && d(o, "introspect session disposed");
 		},
 		get childPid() {
-			return i?.proc.pid ?? null;
+			return o?.proc.pid ?? null;
 		}
 	};
 }
 //#endregion
 //#region src/vite/index.ts
-var T = 2;
-function E(e) {
-	if (Array.isArray(e)) return `[${e.map(E).join(",")}]`;
+var D = 2;
+function O(e) {
+	if (Array.isArray(e)) return `[${e.map(O).join(",")}]`;
 	if (typeof e == "object" && e) {
 		let t = e;
-		return `{${Object.keys(t).sort().filter((e) => t[e] !== void 0).map((e) => `${JSON.stringify(e)}:${E(t[e])}`).join(",")}}`;
+		return `{${Object.keys(t).sort().filter((e) => t[e] !== void 0).map((e) => `${JSON.stringify(e)}:${O(t[e])}`).join(",")}}`;
 	}
 	return JSON.stringify(e) ?? "null";
 }
-function oe(e) {
-	return o("sha256").update(E(e)).digest("hex").slice(0, 16);
+function ce(e) {
+	return o("sha256").update(O(e)).digest("hex").slice(0, 16);
 }
-var se = 20;
-async function D(e, t) {
+var le = 20;
+async function ue(e, t) {
 	if (e === void 0) return;
 	let n;
 	try {
@@ -219,7 +239,7 @@ async function D(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 O(e, t) {
+function de(e, t) {
 	if (!e?.length) return;
 	let n = e.map((e) => {
 		let t = e.label ? `"${e.label}"` : `#${e.index}`;
@@ -227,7 +247,7 @@ function O(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.`);
 }
-var ce = [
+var fe = [
 	"schema",
 	"defaultConfig",
 	"examples",
@@ -240,20 +260,20 @@ var ce = [
 	"minSize",
 	"maxSize"
 ];
-function le(e, t, n) {
+function pe(e, t, n) {
 	let r = l(e, "utf-8"), i = JSON.parse(r), a = {
 		...t.manifest ?? {},
 		schema: n
 	};
-	for (let e of ce) a[e] !== void 0 && (i[e] = a[e]);
+	for (let e of fe) a[e] !== void 0 && (i[e] = a[e]);
 	let o = `${JSON.stringify(i, null, 2)}\n`;
 	o !== r && p(e, o);
 }
-var ue = /import\s*(\{[^}]*\}|\*\s*as\s+[\w$]+)\s*from\s*["']@glasshome\/widget-sdk["']/g, de = /import\(\s*["']@glasshome\/widget-sdk["']\s*\)/;
+var me = /import\s*(\{[^}]*\}|\*\s*as\s+[\w$]+)\s*from\s*["']@glasshome\/widget-sdk["']/g, he = /import\(\s*["']@glasshome\/widget-sdk["']\s*\)/;
 function k(e) {
 	let t = /* @__PURE__ */ new Set();
-	de.test(e) && t.add("*");
-	for (let [, n = ""] of e.matchAll(ue)) if (!n.startsWith("{")) t.add("*");
+	he.test(e) && t.add("*");
+	for (let [, n = ""] of e.matchAll(me)) if (!n.startsWith("{")) t.add("*");
 	else for (let e of n.slice(1, -1).split(",")) {
 		let n = e.trim().split(/\s+as\s+/)[0];
 		n && t.add(n);
@@ -271,16 +291,16 @@ function j(e, t, n) {
 }
 async function M(e) {
 	if (!s(e.outFile)) return;
-	let t = e.session ? await e.session.introspect(e.outFile) : w(e.outFile);
+	let t = e.session ? await e.session.introspect(e.outFile) : await (e.introspect ?? E)(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 D(n.manifest?.examples, r), O(n.exampleConfigIssues, r);
+	await ue(n.manifest?.examples, r), de(n.exampleConfigIssues, r);
 	let i = n.jsonSchema, a = e.manifestPath && s(e.manifestPath) ? e.manifestPath : null;
-	i && a && le(a, n, i);
+	i && a && pe(a, n, i);
 	let o = a ? JSON.parse(l(a, "utf-8")).capabilities : n.manifest?.capabilities;
 	if (j(l(e.outFile, "utf-8"), o ?? [], r), !i) return;
-	let c = oe(i), u = n.manifest?.configVersion ?? null, d = n.manifest?.name ?? e.widgetName, f = s(e.hashFile) ? l(e.hashFile, "utf-8") : null;
+	let c = ce(i), u = n.manifest?.configVersion ?? null, d = n.manifest?.name ?? e.widgetName, f = s(e.hashFile) ? l(e.hashFile, "utf-8") : null;
 	if (f !== null) {
 		let t = f.trim(), n = null;
 		if (t.startsWith("{")) try {
@@ -288,32 +308,32 @@ async function M(e) {
 		} catch {
 			n = null;
 		}
-		if (n && n.hashVersion === T) {
+		if (n && n.hashVersion === D) {
 			if (n.hash !== c && n.configVersion === u) throw Error(`[widget-sdk] Config schema shape changed for "${d}" without a configVersion bump. Bump configVersion in defineWidget (currently ${u ?? "unset"}) or revert the schema change, then rebuild. Recorded in ${e.hashFile}`);
-		} else console.warn(`[widget-sdk] Schema shape record for "${d}" was written by an older SDK, so it cannot be compared. Re-recording it under hash format ${T}. This build is not checked for a missing configVersion bump; the next one is. (${e.hashFile})`);
+		} else console.warn(`[widget-sdk] Schema shape record for "${d}" was written by an older SDK, so it cannot be compared. Re-recording it under hash format ${D}. This build is not checked for a missing configVersion bump; the next one is. (${e.hashFile})`);
 	}
 	let m = `${JSON.stringify({
 		hash: c,
 		configVersion: u,
-		hashVersion: T
+		hashVersion: D
 	})}\n`;
 	m !== f && p(e.hashFile, m);
 }
-var fe = "virtual:glasshome-widget", N = "\0virtual:glasshome-widget", pe = "/@glasshome/preview";
-function P(e) {
+var ge = "virtual:glasshome-widget", N = "\0virtual:glasshome-widget", P = "/@glasshome/preview";
+function F(e) {
 	return y === "\\" ? e.split(y).join("/") : e;
 }
-function F() {
+function I() {
 	let e = b(import.meta.url);
 	return v(h(e), "../../preview");
 }
-function I(e) {
+function L(e) {
 	return r(e);
 }
-var L = /\.(ts|tsx|js|jsx)$/, R = /from\s+["']@glasshome\/sync-layer(\/[^"']*)?["']/;
+var R = /\.(ts|tsx|js|jsx)$/, _e = /from\s+["']@glasshome\/sync-layer(\/[^"']*)?["']/;
 function z(e, t) {
-	let n = P(e).split("?")[0] ?? "";
-	return n.includes("/node_modules/") || !L.test(n) ? !1 : R.test(t);
+	let n = F(e).split("?")[0] ?? "";
+	return n.includes("/node_modules/") || !R.test(n) ? !1 : _e.test(t);
 }
 function B() {
 	return {
@@ -321,14 +341,14 @@ function B() {
 		apply: "build",
 		enforce: "pre",
 		transform(e, t) {
-			if (z(t, e)) throw Error(`Widgets must not import "@glasshome/sync-layer" directly (imported by ${P(_(process.cwd(), t.split("?")[0] ?? t))}). Import the equivalent hook from "@glasshome/widget-sdk" instead (e.g. useEntity, useEntities, useService).`);
+			if (z(t, e)) throw Error(`Widgets must not import "@glasshome/sync-layer" directly (imported by ${F(_(process.cwd(), t.split("?")[0] ?? t))}). Import the equivalent hook from "@glasshome/widget-sdk" instead (e.g. useEntity, useEntities, useService).`);
 			return null;
 		}
 	};
 }
 function V(t, n) {
-	let r = P(t).split("?")[0] ?? "";
-	if (r.includes("/node_modules/") || !L.test(r)) return !1;
+	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;
 }
@@ -336,7 +356,7 @@ function H(e = /* @__PURE__ */ new Set()) {
 	let t = /* @__PURE__ */ new Set();
 	return {
 		scan(e, n) {
-			V(e, n) && t.add(P(_(process.cwd(), e.split("?")[0] ?? e)));
+			V(e, n) && t.add(F(_(process.cwd(), e.split("?")[0] ?? e)));
 		},
 		take() {
 			let n = [...t].filter((t) => !e.has(t));
@@ -362,7 +382,7 @@ function U(n) {
 		}
 	};
 }
-var me = "node_modules/.cache/glasshome-widgets";
+var ve = "node_modules/.cache/glasshome-widgets";
 function W(e) {
 	try {
 		return m(g(process.cwd(), "package.json")).resolve(e);
@@ -370,7 +390,7 @@ function W(e) {
 		return null;
 	}
 }
-var he = [
+var ye = [
 	"--radius",
 	"--background",
 	"--foreground",
@@ -389,7 +409,7 @@ function K(e, t) {
 	let r = l(n, "utf-8"), i = G(r);
 	i !== r && p(n, i);
 	for (let e of i.matchAll(/:host[^{]*\{([^}]*)\}/g)) {
-		let n = e[1] ?? "", r = he.find((e) => n.includes(`${e}:`));
+		let n = e[1] ?? "", r = ye.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.`);
 	}
 }
@@ -398,7 +418,7 @@ function q(e, t) {
 	return [r, ...u(n, { withFileTypes: !0 }).filter((e) => e.isDirectory()).map((e) => g(n, e.name)).filter((e) => !i.has(e))];
 }
 function J(e, t, n, r) {
-	let i = v(e, me);
+	let i = v(e, ve);
 	c(i, { recursive: !0 });
 	let a = W("@glasshome/ui/styles");
 	if (!a) 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.");
@@ -412,7 +432,7 @@ function J(e, t, n, r) {
 		"@import \"tailwindcss\" source(none);",
 		"@import \"tw-animate-css\";",
 		"@import \"@glasshome/ui/styles/theme\";",
-		...d.map((e) => `@source "${P(e)}";`),
+		...d.map((e) => `@source "${F(e)}";`),
 		"@custom-variant dark {",
 		"  &:is(.dark *) { @slot }",
 		"  :host(.dark) & { @slot }",
@@ -421,8 +441,8 @@ function J(e, t, n, r) {
 	].join("\n"));
 	let m = v(i, `${t}.entry.ts`);
 	return p(m, [
-		`import "${P(f)}";`,
-		`export { default } from "${P(n)}";`,
+		`import "${F(f)}";`,
+		`export { default } from "${F(n)}";`,
 		""
 	].join("\n")), m;
 }
@@ -505,7 +525,7 @@ async function $(e) {
 				fileName: s.name,
 				cssFileName: s.name
 			},
-			rollupOptions: { external: I },
+			rollupOptions: { external: L },
 			outDir: i,
 			emptyOutDir: !1,
 			copyPublicDir: !1,
@@ -521,7 +541,7 @@ async function $(e) {
 	});
 	Q(r, i);
 }
-function ge(e) {
+function be(e) {
 	let t = e?.entry ?? "src/index.tsx", n = {
 		name: "glasshome-widget:build",
 		apply: "build",
@@ -536,7 +556,7 @@ function ge(e) {
 						fileName: "index",
 						cssFileName: "index"
 					},
-					rollupOptions: { external: I }
+					rollupOptions: { external: L }
 				}
 			};
 		}
@@ -545,7 +565,7 @@ function ge(e) {
 		apply: "serve",
 		enforce: "pre",
 		config() {
-			let e = F(), t = process.cwd();
+			let e = I(), t = process.cwd();
 			return { server: { fs: { allow: [
 				e,
 				t,
@@ -553,7 +573,7 @@ function ge(e) {
 			] } } };
 		},
 		configureServer(e) {
-			let t = F(), n = g(t, "preview.html");
+			let t = I(), n = g(t, "preview.html");
 			e.middlewares.use(async (t, r, i) => {
 				if (t.url === "/" || t.url === "/index.html") try {
 					let i = l(n, "utf-8");
@@ -565,14 +585,14 @@ function ge(e) {
 			});
 		},
 		resolveId(e) {
-			if (e === pe) {
-				let e = F();
-				return P(g(e, "host.tsx"));
+			if (e === P) {
+				let e = I();
+				return F(g(e, "host.tsx"));
 			}
-			if (e === fe) return N;
+			if (e === ge) return N;
 		},
 		load(e) {
-			if (e === N) return `export { default } from "${P(v(process.cwd(), t))}";`;
+			if (e === N) return `export { default } from "${F(v(process.cwd(), t))}";`;
 		}
 	}, i = {
 		name: "glasshome-widget:schema",
@@ -595,7 +615,7 @@ function ge(e) {
 		r
 	];
 }
-function _e(e) {
+function xe(e) {
 	let t = e?.srcDir ?? "src", n = e?.outDir ?? "dist", r = [];
 	return [{
 		name: "glasshome-widgets:build",
@@ -623,4 +643,4 @@ function _e(e) {
 	}];
 }
 //#endregion
-export { A as HOOK_READS, se as MAX_EXAMPLES, j as assertHookReadsDeclared, $ as buildWidgets, ae as createIntrospectSession, H as createUiImportTracker, Z as discoverWidgets, G as dropSelfReferencingVars, Q as generateRegistry, ge as glasshomeWidget, _e as glasshomeWidgets, w as introspectOnce, z as isDirectSyncLayerImportSource, V as isDirectUiImportSource, I as isWidgetExternal, M as runSchemaGuard, k as sdkImportsOf, q as widgetProjectScanDirs };
+export { A as HOOK_READS, le as MAX_EXAMPLES, j as assertHookReadsDeclared, $ as buildWidgets, se as createIntrospectSession, H as createUiImportTracker, Z as discoverWidgets, G as dropSelfReferencingVars, Q as generateRegistry, be as glasshomeWidget, xe as glasshomeWidgets, E as introspectOnce, z as isDirectSyncLayerImportSource, V as isDirectUiImportSource, L as isWidgetExternal, M as runSchemaGuard, k as sdkImportsOf, q as widgetProjectScanDirs };

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

@@ -1,3 +1,4 @@
+import { type Clock } from "@glasshome/widget-contract/clock";
 import type { WidgetIntrospection } from "./introspect-core";
 export type IntrospectResult = {
     ok: true;
@@ -13,6 +14,15 @@ export interface IntrospectSessionOptions {
     timeoutMs?: number;
     /** Log spawn and import durations above this. */
     slowMs?: number;
+    clock?: Clock;
+    spawnWorker?: (probe: string) => WorkerTransport;
+}
+export interface WorkerTransport {
+    write(line: string): boolean;
+    onLine(cb: (line: string) => void): void;
+    onExit(cb: (reason: string) => void): void;
+    kill(): void;
+    readonly pid: number | null;
 }
 export interface IntrospectSession {
     introspect(outFile: string): Promise<IntrospectResult>;
@@ -20,7 +30,9 @@ export interface IntrospectSession {
     readonly childPid: number | null;
 }
 /** One process per check. The path `build`, `capture` and the fallback take. */
-export declare function introspectOnce(outFile: string): IntrospectResult;
+export declare function introspectOnce(outFile: string, options?: {
+    timeoutMs?: number;
+}): IntrospectResult;
 /**
  * A worker reused across rebuilds, for callers that own a session.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glasshome/widget-sdk",
-  "version": "1.22.2",
+  "version": "1.23.0",
   "description": "SDK for building GlassHome dashboard widgets with SolidJS",
   "keywords": [
     "dashboard",
@@ -75,7 +75,7 @@
     "lint": "oxlint --type-aware . && oxfmt --check ."
   },
   "dependencies": {
-    "@glasshome/widget-contract": "0.3.0",
+    "@glasshome/widget-contract": "0.4.0",
     "@tailwindcss/vite": "^4.1.13",
     "clsx": "^2.1.1",
     "happy-dom": "^20.0.0",
@@ -85,7 +85,7 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@glasshome/ui": "1.30.0",
+    "@glasshome/ui": "1.33.0",
     "@solidjs/testing-library": "^0.8.10",
     "@types/bun": "^1.4.0",
     "@types/node": "^25.2.2",