@glasshome/widget-sdk 1.8.0 → 1.8.1

package/dist/index.js

@@ -1314,7 +1314,7 @@ function rn() {
 //#region src/version.ts
 var an = {
 	name: "@glasshome/widget-sdk",
-	version: "1.8.0",
+	version: "1.8.1",
 	description: "SDK for building GlassHome dashboard widgets with SolidJS",
 	keywords: [
 		"glasshome",
@@ -1377,11 +1377,12 @@ var an = {
 	dependencies: {
 		"@glasshome/widget-contract": "0.2.0",
 		"@modular-forms/solid": "^0.25.1",
+		"@tailwindcss/vite": "^4.1.13",
 		clsx: "^2.1.1",
+		"happy-dom": "^20.0.0",
 		"tailwind-merge": "^3.5.0",
-		zod: "^4.1.13",
-		"@tailwindcss/vite": "^4.1.13",
-		tailwindcss: "^4.1.13"
+		tailwindcss: "^4.1.13",
+		zod: "^4.1.13"
 	},
 	devDependencies: {
 		"@types/bun": "latest",

package/dist/vite/index.d.ts

@@ -12,7 +12,7 @@ export interface GlasshomeWidgetOptions {
  */
 export declare const MAX_EXAMPLES = 20;
 /**
- * Configuration-drift guard (D-11). Imports the built bundle, derives the JSON
+ * Configuration-drift guard (D-11). Reads the built bundle, derives the JSON
  * Schema from its configSchema, and compares against the recorded
  * `.schema-hash`. A shape change without a configVersion bump fails the build:
  * tsc cannot catch this class of break because the old persisted config still

package/dist/vite/index.js

@@ -1,17 +1,18 @@
 import { formatSchemaError as e, isHostProvidedModule as t, widgetManifestSchema as n } from "@glasshome/widget-contract";
-import { createHash as r } from "node:crypto";
-import { existsSync as i, mkdirSync as a, readFileSync as o, readdirSync as s, rmSync as c, statSync as l, writeFileSync as u } from "node:fs";
-import { createRequire as d } from "node:module";
-import { dirname as f, join as p, resolve as m, sep as h } from "node:path";
-import { fileURLToPath as g } from "node:url";
-import _ from "@tailwindcss/vite";
+import { spawnSync as r } from "node:child_process";
+import { createHash as i } from "node:crypto";
+import { existsSync as a, mkdirSync as o, readFileSync as s, readdirSync as c, rmSync as l, statSync as u, writeFileSync as d } from "node:fs";
+import { createRequire as f } from "node:module";
+import { dirname as p, join as m, resolve as h, sep as g } from "node:path";
+import { fileURLToPath as _ } from "node:url";
+import v from "@tailwindcss/vite";
 //#region src/vite/index.ts
-function v(e) {
+function y(e) {
 	let t = JSON.stringify(e, Object.keys(e).sort());
-	return r("sha256").update(t).digest("hex").slice(0, 16);
+	return i("sha256").update(t).digest("hex").slice(0, 16);
 }
-var y = 20;
-async function b(e, t) {
+var b = 20;
+async function x(e, t) {
 	if (e === void 0) return;
 	let n;
 	try {
@@ -31,54 +32,84 @@ async function b(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.`);
 }
-async function x(e) {
-	if (!i(e.outFile)) return;
-	let t;
+function S(e) {
+	let t = p(_(import.meta.url)), n = [m(t, "introspect.js"), m(t, "introspect.ts")].find((e) => a(e));
+	if (!n) return {
+		ok: !1,
+		reason: `introspect not found next to ${t}`
+	};
+	let i = r(process.execPath, [
+		"--conditions",
+		"browser",
+		n,
+		e
+	], {
+		encoding: "utf-8",
+		timeout: 3e4
+	});
+	if (i.error) return {
+		ok: !1,
+		reason: i.error.message
+	};
+	if (i.status !== 0) return {
+		ok: !1,
+		reason: (i.stderr || "").trim().split("\n")[0] || `exit ${i.status}`
+	};
 	try {
-		t = (await import(`${e.outFile}?t=${Date.now()}`)).default;
+		return {
+			ok: !0,
+			value: JSON.parse(i.stdout)
+		};
 	} catch {
-		return;
+		return {
+			ok: !1,
+			reason: "introspect returned unparseable output"
+		};
 	}
-	if (await b(t?.manifest?.examples, t?.manifest?.name ?? e.widgetName), !t?.configSchema) return;
-	let n;
-	try {
-		let { z: e } = await import("zod");
-		n = e.toJSONSchema(t.configSchema, { unrepresentable: "any" });
-	} catch {
+}
+async function C(e) {
+	if (!a(e.outFile)) return;
+	let t = S(e.outFile);
+	if (!t.ok) {
+		console.warn(`[widget-sdk] Could not read "${e.widgetName}" to check it: ${t.reason}\n  Its examples and config schema were NOT validated.`);
 		return;
 	}
-	if (e.manifestPath && i(e.manifestPath)) {
-		let t = JSON.parse(o(e.manifestPath, "utf-8"));
-		t.schema = n, u(e.manifestPath, JSON.stringify(t, null, 2));
+	let n = t.value;
+	await x(n.manifest?.examples, n.manifest?.name ?? e.widgetName);
+	let r = n.jsonSchema;
+	if (!r) return;
+	if (e.manifestPath && a(e.manifestPath)) {
+		let t = JSON.parse(s(e.manifestPath, "utf-8"));
+		t.schema = r, d(e.manifestPath, JSON.stringify(t, null, 2));
 	}
-	let r = v(n), a = t.manifest?.configVersion ?? null, s = t.manifest?.name ?? e.widgetName;
-	if (i(e.hashFile)) {
-		let t = o(e.hashFile, "utf-8").trim(), n = null;
+	let i = y(r), o = n.manifest?.configVersion ?? null, c = n.manifest?.name ?? e.widgetName;
+	if (a(e.hashFile)) {
+		let t = s(e.hashFile, "utf-8").trim(), n = null;
 		if (t.startsWith("{")) try {
 			n = JSON.parse(t);
 		} catch {
 			n = null;
 		}
 		if (n) {
-			if (n.hash !== r && n.configVersion === a) throw Error(`[widget-sdk] Config schema shape changed for "${s}" without a configVersion bump. Bump configVersion in defineWidget (currently ${a ?? "unset"}) or revert the schema change, then rebuild. Recorded in ${e.hashFile}`);
-		} else t !== r && console.warn(`[widget-sdk] Schema shape changed for "${s}" — verify configVersion was bumped`);
+			if (n.hash !== i && 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 !== i && console.warn(`[widget-sdk] Schema shape changed for "${c}" — verify configVersion was bumped`);
 	}
-	u(e.hashFile, `${JSON.stringify({
-		hash: r,
-		configVersion: a
+	d(e.hashFile, `${JSON.stringify({
+		hash: i,
+		configVersion: o
 	})}\n`);
 }
-var S = "virtual:glasshome-widget", C = "\0virtual:glasshome-widget", w = "/@glasshome/preview";
-function T(e) {
-	return h === "\\" ? e.split(h).join("/") : e;
+var w = "virtual:glasshome-widget", T = "\0virtual:glasshome-widget", E = "/@glasshome/preview";
+function D(e) {
+	return g === "\\" ? e.split(g).join("/") : e;
 }
-function E() {
-	return m(f(g(import.meta.url)), "../../preview");
+function O() {
+	return h(p(_(import.meta.url)), "../../preview");
 }
-function D(e) {
+function k(e) {
 	return t(e);
 }
-function O() {
+function A() {
 	return {
 		name: "glasshome-widget:sync-layer-guard",
 		apply: "build",
@@ -88,15 +119,15 @@ function O() {
 		}
 	};
 }
-var k = "node_modules/.cache/glasshome-widgets";
-function A(e) {
+var j = "node_modules/.cache/glasshome-widgets";
+function M(e) {
 	try {
-		return d(p(process.cwd(), "package.json")).resolve(e);
+		return f(m(process.cwd(), "package.json")).resolve(e);
 	} catch {
 		return null;
 	}
 }
-var j = [
+var N = [
 	"--radius",
 	"--background",
 	"--foreground",
@@ -106,88 +137,88 @@ var j = [
 	"--muted",
 	"--accent"
 ];
-function M(e, t) {
-	let n = p(e, `${t}.css`);
-	if (!i(n)) return;
-	let r = o(n, "utf-8");
+function P(e, t) {
+	let n = m(e, `${t}.css`);
+	if (!a(n)) return;
+	let r = s(n, "utf-8");
 	for (let e of r.matchAll(/:host[^{]*\{([^}]*)\}/g)) {
-		let n = e[1] ?? "", r = j.find((e) => n.includes(`${e}:`));
+		let n = e[1] ?? "", r = N.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 N(e, t, n) {
-	let r = m(e, k);
-	a(r, { recursive: !0 });
-	let o = A("@glasshome/ui/styles");
-	if (!o) 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 s = m(f(o), "../.."), c = A("@glasshome/widget-sdk/tailwind-sources"), l = c ? f(c) : null, d = [
-		p(s, "src"),
-		p(s, "dist"),
-		...l ? [p(l, "src"), p(l, "dist")] : [],
-		f(n)
-	].filter((e) => i(e)), h = m(r, `${t}.tailwind.css`);
-	u(h, [
+function F(e, t, n) {
+	let r = h(e, j);
+	o(r, { recursive: !0 });
+	let i = M("@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 s = h(p(i), "../.."), c = M("@glasshome/widget-sdk/tailwind-sources"), l = c ? p(c) : null, u = [
+		m(s, "src"),
+		m(s, "dist"),
+		...l ? [m(l, "src"), m(l, "dist")] : [],
+		p(n)
+	].filter((e) => a(e)), f = h(r, `${t}.tailwind.css`);
+	d(f, [
 		"@import \"tailwindcss\" source(none);",
 		"@import \"tw-animate-css\";",
 		"@import \"@glasshome/ui/styles/theme\";",
-		...d.map((e) => `@source "${T(e)}";`),
+		...u.map((e) => `@source "${D(e)}";`),
 		"@custom-variant dark {",
 		"  &:is(.dark *) { @slot }",
 		"  :host(.dark) & { @slot }",
 		"}",
 		""
 	].join("\n"));
-	let g = m(r, `${t}.entry.ts`);
-	return u(g, [
-		`import "${T(h)}";`,
-		`export { default } from "${T(n)}";`,
+	let g = h(r, `${t}.entry.ts`);
+	return d(g, [
+		`import "${D(f)}";`,
+		`export { default } from "${D(n)}";`,
 		""
 	].join("\n")), g;
 }
-function P() {
-	let e = _();
+function I() {
+	let e = v();
 	for (let t of e) t.apply ??= "build";
 	return e;
 }
-function F(e) {
+function L(e) {
 	let t = [];
-	if (!i(e)) return t;
-	for (let n of s(e)) {
-		let r = m(e, n);
-		if (!l(r).isDirectory()) continue;
-		let a = m(r, "index.tsx"), o = m(r, "manifest.json");
-		i(a) && i(o) && t.push({
+	if (!a(e)) return t;
+	for (let n of c(e)) {
+		let r = h(e, n);
+		if (!u(r).isDirectory()) continue;
+		let i = h(r, "index.tsx"), o = h(r, "manifest.json");
+		a(i) && a(o) && t.push({
 			name: n,
-			entry: a
+			entry: i
 		});
 	}
 	return t;
 }
-function I(t, r) {
-	let c = [];
-	if (i(t)) for (let a of s(t)) {
-		if (!l(p(t, a)).isDirectory()) continue;
-		let s = p(t, a, "manifest.json");
-		if (!i(s)) continue;
-		let u = n.safeParse(JSON.parse(o(s, "utf-8")));
-		if (!u.success) throw Error(`[registry] Invalid manifest for "${a}": ${e(u.error)}`);
-		let d = i(p(r, `${a}.css`));
-		c.push({
-			...u.data,
-			bundleUrl: `./${a}.js`,
-			...d ? { cssUrl: `./${a}.css` } : {}
+function R(t, r) {
+	let i = [];
+	if (a(t)) for (let o of c(t)) {
+		if (!u(m(t, o)).isDirectory()) continue;
+		let c = m(t, o, "manifest.json");
+		if (!a(c)) continue;
+		let l = n.safeParse(JSON.parse(s(c, "utf-8")));
+		if (!l.success) throw Error(`[registry] Invalid manifest for "${o}": ${e(l.error)}`);
+		let d = a(m(r, `${o}.css`));
+		i.push({
+			...l.data,
+			bundleUrl: `./${o}.js`,
+			...d ? { cssUrl: `./${o}.css` } : {}
 		});
 	}
-	let d = {
+	let l = {
 		version: 1,
 		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 		baseUrl: "./",
-		widgets: c
+		widgets: i
 	};
-	i(r) || a(r, { recursive: !0 }), u(p(r, "registry.json"), JSON.stringify(d, null, 2)), console.log(`[registry] Generated registry.json with ${c.length} widget(s)`);
+	a(r) || o(r, { recursive: !0 }), d(m(r, "registry.json"), JSON.stringify(l, null, 2)), console.log(`[registry] Generated registry.json with ${i.length} widget(s)`);
 }
-async function L(e) {
-	let { build: t } = await import("vite"), n = process.cwd(), r = m(n, e?.srcDir ?? "src"), o = m(n, e?.outDir ?? "dist"), s = F(r);
+async function z(e) {
+	let { build: t } = await import("vite"), n = process.cwd(), r = h(n, e?.srcDir ?? "src"), i = h(n, e?.outDir ?? "dist"), s = L(r);
 	if (s.length === 0) {
 		console.warn("[glasshome-widgets] No widgets found in", r);
 		return;
@@ -196,38 +227,38 @@ async function L(e) {
 		let t = new Set(e.only);
 		s = s.filter((e) => t.has(e.name));
 	}
-	e?.only || i(o) && c(o, { recursive: !0 }), i(o) || a(o, { recursive: !0 });
+	e?.only || a(i) && l(i, { recursive: !0 }), a(i) || o(i, { recursive: !0 });
 	for (let r of s) await t({
 		configFile: !1,
 		root: n,
 		plugins: [
-			...P(),
+			...I(),
 			...e?.plugins ?? [],
-			O()
+			A()
 		],
 		...e?.viteConfig,
 		build: {
 			lib: {
-				entry: N(n, r.name, r.entry),
+				entry: F(n, r.name, r.entry),
 				formats: ["es"],
 				fileName: r.name,
 				cssFileName: r.name
 			},
-			rollupOptions: { external: D },
-			outDir: o,
+			rollupOptions: { external: k },
+			outDir: i,
 			emptyOutDir: !1,
 			copyPublicDir: !1,
 			...e?.viteConfig?.build
 		},
 		logLevel: "warn"
-	}), M(o, r.name), await x({
-		outFile: p(o, `${r.name}.js`),
-		hashFile: p(f(r.entry), ".schema-hash"),
+	}), P(i, r.name), await C({
+		outFile: m(i, `${r.name}.js`),
+		hashFile: m(p(r.entry), ".schema-hash"),
 		widgetName: r.name
 	});
-	I(r, o);
+	R(r, i);
 }
-function R(e) {
+function B(e) {
 	let t = e?.entry ?? "src/index.tsx", n = {
 		name: "glasshome-widget:build",
 		apply: "build",
@@ -235,12 +266,12 @@ function R(e) {
 			let e = process.cwd();
 			return { build: {
 				lib: {
-					entry: N(e, "index", m(e, t)),
+					entry: F(e, "index", h(e, t)),
 					formats: ["es"],
 					fileName: "index",
 					cssFileName: "index"
 				},
-				rollupOptions: { external: D }
+				rollupOptions: { external: k }
 			} };
 		}
 	}, r = {
@@ -248,18 +279,18 @@ function R(e) {
 		apply: "serve",
 		enforce: "pre",
 		config() {
-			let e = E(), t = process.cwd();
+			let e = O(), t = process.cwd();
 			return { server: { fs: { allow: [
 				e,
 				t,
-				m(t, "..", "..")
+				h(t, "..", "..")
 			] } } };
 		},
 		configureServer(e) {
-			let t = p(E(), "preview.html");
+			let t = m(O(), "preview.html");
 			e.middlewares.use(async (n, r, i) => {
 				if (n.url === "/" || n.url === "/index.html") try {
-					let i = o(t, "utf-8");
+					let i = s(t, "utf-8");
 					i = await e.transformIndexHtml(n.url, i), r.setHeader("Content-Type", "text/html"), r.statusCode = 200, r.end(i);
 				} catch (e) {
 					i(e);
@@ -268,33 +299,33 @@ function R(e) {
 			});
 		},
 		resolveId(e) {
-			if (e === w) return T(p(E(), "host.tsx"));
-			if (e === S) return C;
+			if (e === E) return D(m(O(), "host.tsx"));
+			if (e === w) return T;
 		},
 		load(e) {
-			if (e === C) return `export { default } from "${T(m(process.cwd(), t))}";`;
+			if (e === T) return `export { default } from "${D(h(process.cwd(), t))}";`;
 		}
 	}, i = {
 		name: "glasshome-widget:schema",
 		apply: "build",
 		async closeBundle() {
-			M(m(process.cwd(), "dist"), "index"), await x({
-				outFile: m(process.cwd(), "dist", "index.js"),
-				hashFile: m(process.cwd(), ".schema-hash"),
+			P(h(process.cwd(), "dist"), "index"), await C({
+				outFile: h(process.cwd(), "dist", "index.js"),
+				hashFile: h(process.cwd(), ".schema-hash"),
 				widgetName: "index",
-				manifestPath: m(process.cwd(), "manifest.json")
+				manifestPath: h(process.cwd(), "manifest.json")
 			});
 		}
 	};
 	return [
-		...P(),
+		...I(),
 		n,
-		O(),
+		A(),
 		i,
 		r
 	];
 }
-function z(e) {
+function V(e) {
 	let t = e?.srcDir ?? "src", n = e?.outDir ?? "dist", r = [];
 	return [{
 		name: "glasshome-widgets:build",
@@ -313,7 +344,7 @@ function z(e) {
 			if (e === "\0glasshome-noop") return "export {}";
 		},
 		async closeBundle() {
-			await L({
+			await z({
 				srcDir: t,
 				outDir: n,
 				plugins: r
@@ -322,4 +353,4 @@ function z(e) {
 	}];
 }
 //#endregion
-export { y as MAX_EXAMPLES, L as buildWidgets, F as discoverWidgets, I as generateRegistry, R as glasshomeWidget, z as glasshomeWidgets, D as isWidgetExternal, x as runSchemaGuard };
+export { b as MAX_EXAMPLES, z as buildWidgets, L as discoverWidgets, R as generateRegistry, B as glasshomeWidget, V as glasshomeWidgets, k as isWidgetExternal, C as runSchemaGuard };

package/dist/vite/introspect.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ *
+ * Usage: bun --conditions browser introspect.js <bundle.js>
+ * Prints: { manifest, jsonSchema } on stdout, or exits non-zero with a reason.
+ */
+interface Introspection {
+    manifest: {
+        name?: string;
+        configVersion?: number;
+        examples?: unknown;
+    } | null;
+    /** JSON Schema derived from the widget's configSchema, when it has one. */
+    jsonSchema: object | null;
+}
+declare function installDom(): Promise<void>;
+declare function main(): Promise<void>;

package/dist/vite/introspect.js

@@ -0,0 +1,37 @@
+//#region src/vite/introspect.ts
+async function e() {
+	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 t() {
+	let t = process.argv[2];
+	t || (process.stderr.write("introspect: no bundle path given\n"), process.exit(2)), await e();
+	let n = (await import(t)).default, r = null;
+	if (n?.configSchema) {
+		let { z: e } = await import("zod");
+		r = e.toJSONSchema(n.configSchema, { unrepresentable: "any" });
+	}
+	let i = {
+		manifest: n?.manifest ?? null,
+		jsonSchema: r
+	};
+	process.stdout.write(JSON.stringify(i));
+}
+t().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.8.0",
+  "version": "1.8.1",
   "description": "SDK for building GlassHome dashboard widgets with SolidJS",
   "keywords": [
     "glasshome",
@@ -63,11 +63,12 @@
   "dependencies": {
     "@glasshome/widget-contract": "0.2.0",
     "@modular-forms/solid": "^0.25.1",
+    "@tailwindcss/vite": "^4.1.13",
     "clsx": "^2.1.1",
+    "happy-dom": "^20.0.0",
     "tailwind-merge": "^3.5.0",
-    "zod": "^4.1.13",
-    "@tailwindcss/vite": "^4.1.13",
-    "tailwindcss": "^4.1.13"
+    "tailwindcss": "^4.1.13",
+    "zod": "^4.1.13"
   },
   "devDependencies": {
     "@types/bun": "latest",