@glasshome/widget-sdk 1.22.1 → 1.23.0

package/dist/schemas.js

@@ -1,2 +1 @@
-import { GridSizeSchema as e, PublishBodySchema as t, PublishConfirmSchema as n, PublishRequestSchema as r, capabilitiesSchema as i, capabilityGrantSchema as a, formatSchemaError as o, parseGridSize as s, publishManifestSchema as c, serializeGridSize as l, widgetManifestSchema as u, widgetManifestSchema as d } from "@glasshome/widget-contract";
-export { e as GridSizeSchema, t as PublishBodySchema, n as PublishConfirmSchema, r as PublishRequestSchema, d as WidgetManifestSchema, i as capabilitiesSchema, a as capabilityGrantSchema, o as formatSchemaError, s as parseGridSize, c as publishManifestSchema, l as serializeGridSize, u as widgetManifestSchema };
+export { GridSizeSchema, PublishBodySchema, PublishConfirmSchema, PublishRequestSchema, widgetManifestSchema as WidgetManifestSchema, capabilitiesSchema, capabilityGrantSchema, formatSchemaError, parseGridSize, publishManifestSchema, serializeGridSize, widgetManifestSchema } from "@glasshome/widget-contract";

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,28 +260,23 @@ 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("*");
-			continue;
-		}
-		for (let e of n.slice(1, -1).split(",")) {
-			let n = e.trim().split(/\s+as\s+/)[0];
-			n && t.add(n);
-		}
+	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);
 	}
 	return t;
 }
@@ -276,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 {
@@ -293,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 {
@@ -326,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;
 }
@@ -341,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));
@@ -367,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);
@@ -375,7 +390,7 @@ function W(e) {
 		return null;
 	}
 }
-var he = [
+var ye = [
 	"--radius",
 	"--background",
 	"--foreground",
@@ -394,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.`);
 	}
 }
@@ -403,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.");
@@ -417,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 }",
@@ -426,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;
 }
@@ -510,7 +525,7 @@ async function $(e) {
 				fileName: s.name,
 				cssFileName: s.name
 			},
-			rollupOptions: { external: I },
+			rollupOptions: { external: L },
 			outDir: i,
 			emptyOutDir: !1,
 			copyPublicDir: !1,
@@ -526,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",
@@ -541,7 +556,7 @@ function ge(e) {
 						fileName: "index",
 						cssFileName: "index"
 					},
-					rollupOptions: { external: I }
+					rollupOptions: { external: L }
 				}
 			};
 		}
@@ -550,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,
@@ -558,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");
@@ -570,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",
@@ -600,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",
@@ -628,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.1",
+  "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.28.0",
+    "@glasshome/ui": "1.33.0",
     "@solidjs/testing-library": "^0.8.10",
     "@types/bun": "^1.4.0",
     "@types/node": "^25.2.2",
@@ -100,7 +100,7 @@
   },
   "peerDependencies": {
     "@glasshome/sync-layer": "0.9.1",
-    "@glasshome/ui": "1.28.0",
+    "@glasshome/ui": "1.30.0",
     "solid-js": "^1.9.11"
   },
   "engines": {