@glasshome/widget-sdk 1.8.0 → 1.9.0

package/dist/tokens-CFl0mCx4.js

@@ -0,0 +1,33 @@
+import { createContext as e, useContext as t } from "solid-js";
+//#region src/framework/hooks/use-widget-context.ts
+var n = e();
+function r() {
+	let e = t(n);
+	if (!e) throw Error("useWidgetContext must be used within a Widget component");
+	return e;
+}
+//#endregion
+//#region src/framework/theming/tokens.css?raw
+var i = "/* Authoritative SDK CSS contract. Injected once on first Widget mount\n * via framework/theming/tokens.ts.\n *\n * All widget-internal visual scale is driven from CSS custom properties +\n * container queries on the `.glasshome-widget` shell (`container-type: size`).\n * No JS classifier, no size tier enum.\n */\n\n:root {\n  --tone-success:  oklch(0.70 0.18 145);\n  --tone-warning:  oklch(0.80 0.17 75);\n  --tone-danger:   oklch(0.64 0.22 27);\n  --tone-info:     oklch(0.66 0.20 245);\n  --tone-neutral:  oklch(0.65 0.02 250);\n  --tone-accent:   oklch(0.74 0.18 60);\n\n  --widget-grad-strength:    1;\n  --widget-glow-default:     0.4;\n  --widget-border-highlight: oklch(0.98 0 0 / 0.4);\n}\n\n.dark {\n  --tone-success:  oklch(0.74 0.18 145);\n  --tone-warning:  oklch(0.82 0.17 75);\n  --tone-danger:   oklch(0.68 0.22 27);\n  --tone-info:     oklch(0.70 0.20 245);\n  --tone-neutral:  oklch(0.69 0.02 250);\n  --tone-accent:   oklch(0.78 0.18 60);\n\n  --widget-grad-strength:    1.1;\n  --widget-glow-default:     0.5;\n  --widget-border-highlight: oklch(1 0 0 / 0.08);\n}\n\n@property --widget-color {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: oklch(0.65 0.02 250);\n}\n\n/* === Widget shell ===\n * Fluid scale tokens — tied to the shell's own container box (cqb=height, cqi=width).\n * Icon/pad/gap track HEIGHT (cqb) not the shortest side: two widgets of equal\n * height match regardless of width (a 2×2 and a 4×2 get the same icon). cqmin\n * starved portrait tiles by pinning the icon to the narrow width. Tune\n * multipliers / clamps to adjust density. */\n.glasshome-widget {\n  --widget-color: var(--tone-neutral);\n  --widget-glow-strength: var(--widget-glow-default);\n\n  --widget-icon-box:    clamp(44px, 25cqb, 58px);\n  --widget-icon-glyph:  clamp(24px, 14cqb, 33px);\n  --widget-pad:         clamp(8px,  3.5cqb, 22px);\n  --widget-gap:         clamp(6px,  2cqb,  14px);\n  --widget-title-size:  clamp(12px, 2cqi,    18px);\n  --widget-subtitle:    clamp(12px, 2.5cqi,  20px);\n  --widget-status-size: clamp(14px, 5cqi,    36px);\n  --widget-value-size:  clamp(18px, 7cqi,    48px);\n  --widget-badge-size:  clamp(11px, 1.6cqi,  14px);\n}\n\n/* Shell material. Two channels, both host/variant-driven:\n * - `--widget-backdrop`: the live backdrop filter (the shared glass recipe is\n *   blur + saturate, matching ui's CARD_BLUR). Default none — a variant opts\n *   in (classic-glass), and a performant-blur host disables it via override\n *   sheet when it paints a precomputed frost instead.\n * - `--glass-frost`: one full background layer (image + position / size +\n *   repeat) composited at the BOTTOM, under the accent gradient — the same\n *   frost slot ui's `.glass` formula ends its background list with. Unset →\n *   none. A performant-blur host sets it per shell with the viewport-aligned\n *   slice of its pre-blurred bitmap. */\n.glasshome-widget {\n  background:\n    var(--widget-gradient,\n      linear-gradient(135deg,\n        color-mix(in oklch, var(--widget-color) calc(22% * var(--widget-grad-strength)), transparent),\n        color-mix(in oklch, var(--widget-color-to, var(--widget-color)) calc(11% * var(--widget-grad-strength)), transparent)\n      )\n    ),\n    var(--glass-frost, none);\n  backdrop-filter: var(--widget-backdrop, none);\n  -webkit-backdrop-filter: var(--widget-backdrop, none);\n  box-shadow: inset 0 1px 0 var(--widget-border-highlight);\n}\n\n/* === Slot: content layout === */\n/* Default: column. Flip to row only on wide-and-short widgets (matches the\n * old contentLayout heuristic: aspect > 1 AND height < 150px). */\n.glasshome-widget-content {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  justify-content: space-between;\n  width: 100%;\n  height: 100%;\n  padding: var(--widget-pad);\n  gap: var(--widget-gap);\n  overflow: hidden;\n}\n@container widget (min-aspect-ratio: 1) and (max-height: 149px) {\n  .glasshome-widget-content {\n    flex-direction: row;\n    align-items: center;\n    justify-content: flex-start;\n  }\n}\n\n/* === Compact 1×1 ===\n * Small in BOTH axes → stack the tile: icon on top, label + status centered\n * under it. Icon stays moderate (not a hero) so the text keeps room. Wide\n * tiles (2×1) fail the width test and keep the row layout above. Placed after\n * the row-flip so it wins. */\n@container widget (max-width: 189px) and (max-height: 189px) {\n  .glasshome-widget-content {\n    flex-direction: column;\n    align-items: center;\n    justify-content: center;\n    text-align: center;\n    gap: clamp(4px, 2.5cqmin, 8px);\n  }\n  .glasshome-widget-content > * { align-items: center; text-align: center; }\n  .glasshome-widget-icon {\n    --widget-icon-box:   clamp(36px, 30cqmin, 56px);\n    --widget-icon-glyph: clamp(20px, 17cqmin, 32px);\n  }\n  .glasshome-widget-title  { font-size: clamp(11px, 6cqmin, 14px); max-width: 100%; }\n  .glasshome-widget-status,\n  .glasshome-widget-value  { font-size: clamp(13px, 7cqmin, 17px); }\n  .glasshome-widget-content [class*=\"ml-auto\"] { margin-left: 0 !important; }\n}\n.glasshome-widget-content [class*=\"ml-auto\"] {\n  position: relative;\n  z-index: 30;\n}\n\n/* === Slot: icon === */\n.glasshome-widget-icon {\n  width: var(--widget-icon-box);\n  height: var(--widget-icon-box);\n  border-radius: var(--radius-sm, 12px);\n  background: var(--widget-icon-color, var(--widget-color));\n  box-shadow: 0 0 calc(var(--widget-glow-strength) * 30px)\n    color-mix(in oklch, var(--widget-icon-color, var(--widget-color)) 50%, transparent);\n  color: oklch(from var(--widget-icon-color, var(--widget-color)) calc(0.52 + sign(0.5 - l) * 0.43) calc(c * 0.2) h);\n}\n.glasshome-widget-icon-glyph {\n  font-size: var(--widget-icon-glyph);\n  line-height: 1;\n}\n.glasshome-widget-icon-stack {\n  position: absolute;\n  width: 102%;\n  height: 102%;\n  border-radius: var(--radius-sm, 12px);\n}\n.glasshome-widget-icon-stack-2 { bottom: -14%; right: -10%; opacity: 0.45; z-index: -2; }\n.glasshome-widget-icon-stack-3 { bottom: -28%; right: -20%; opacity: 0.20; z-index: -3; }\n\n/* === Slot: text === */\n.glasshome-widget-title {\n  font-size: var(--widget-title-size);\n  line-height: 1.2;\n  color: color-mix(in oklch, var(--color-foreground, currentColor) 60%, transparent);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.glasshome-widget-subtitle {\n  font-size: var(--widget-subtitle);\n  color: color-mix(in oklch, var(--color-foreground, currentColor) 60%, transparent);\n}\n.glasshome-widget-status {\n  font-size: var(--widget-status-size);\n  font-weight: 700;\n  color: var(--color-foreground, currentColor);\n  line-height: 1.1;\n}\n.glasshome-widget-value {\n  font-size: var(--widget-value-size);\n  font-weight: 700;\n  color: var(--color-foreground, currentColor);\n  line-height: 1.05;\n}\n.glasshome-widget-badge {\n  font-size: var(--widget-badge-size);\n  font-weight: 500;\n  padding: 0.125rem 0.5rem;\n  border-radius: 9999px;\n  background: color-mix(in oklch, var(--color-foreground, currentColor) 20%, transparent);\n  color: var(--color-foreground, currentColor);\n}\n\n.glasshome-widget-loading {\n  background: color-mix(in oklch, var(--widget-color) 20%, transparent);\n}\n\n/* === Slider fill ===\n * Value flows in via --widget-fill-value (0-100). Vertical orientation auto-\n * detected via container query. */\n.glasshome-widget-slider-fill {\n  --widget-fill-value: 0;\n  background: color-mix(in oklch, var(--widget-icon-color, var(--widget-color)) 30%, transparent);\n  box-shadow: 0 0 calc(var(--widget-glow-strength) * 40px)\n    color-mix(in oklch, var(--widget-icon-color, var(--widget-color)) 40%, transparent);\n  clip-path: inset(0 calc((100 - var(--widget-fill-value)) * 1%) 0 0);\n}\n@container widget (max-aspect-ratio: 1) {\n  .glasshome-widget-slider-fill {\n    clip-path: inset(calc((100 - var(--widget-fill-value)) * 1%) 0 0 0);\n  }\n}\n", a = !1, o, s = /* @__PURE__ */ new WeakSet();
+function c() {
+	return o || (o = new CSSStyleSheet(), o.replaceSync(i.replace(/:root\b/g, ":host").replace(/^\.dark\b/gm, ":host(.dark)"))), o;
+}
+function l(e) {
+	if (typeof ShadowRoot < "u" && e instanceof ShadowRoot) {
+		if (s.has(e)) return;
+		let t = c();
+		e.adoptedStyleSheets.includes(t) || (e.adoptedStyleSheets = [...e.adoptedStyleSheets, t]), s.add(e);
+		return;
+	}
+	if (a) return;
+	let t = e ?? (typeof document > "u" ? void 0 : document);
+	if (!t) return;
+	if (t.head.querySelector?.("style[data-glasshome-tokens]")) {
+		a = !0;
+		return;
+	}
+	let n = t.createElement("style");
+	n.setAttribute("data-glasshome-tokens", ""), n.textContent = i, t.head.appendChild(n), a = !0;
+}
+//#endregion
+export { n, r, l as t };

package/dist/ui.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Host UI primitives, re-exported so the SDK is the single gated door.
+ *
+ * The host serves `@glasshome/ui/solid` through its import map with no compat
+ * check of its own, so a widget importing it directly is exposed to ui drift
+ * across the Hub auto-update boundary. Routed through here, the same
+ * primitives sit behind `sdkVersion` — the one contract `checkSdkCompat`
+ * enforces (same model as the sync-layer hooks).
+ *
+ * The set is exactly what shipped widgets use; extending it is an additive
+ * SDK minor. Direct `@glasshome/ui` imports keep working but are deprecated
+ * (`direct-ui-import` in the registry), removed in 2.0.0.
+ *
+ * `@glasshome/ui/solid` is a vite external of this package: these re-exports
+ * resolve to the host-provided singleton at runtime, never a bundled copy.
+ */
+export { Badge, Button, type Color, ColorSlider, ColorWheel, Input, Label, parseColor, ResponsiveDialog, ResponsiveDialogContent, ResponsiveDialogDescription, ResponsiveDialogHeader, ResponsiveDialogTitle, SchemaForm, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Slider, Switch, } from "@glasshome/ui/solid";

package/dist/vite/index.d.ts

@@ -11,18 +11,6 @@ export interface GlasshomeWidgetOptions {
  * author decide which states matter rather than discovering the loss never.
  */
 export declare const MAX_EXAMPLES = 20;
-/**
- * Configuration-drift guard (D-11). Imports 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
- * parses, only its meaning shifts. Legacy plain-hash records (written by
- * pre-1.7 builds) cannot prove a missing bump, so they only warn, then upgrade
- * to the JSON record format.
- *
- * When `manifestPath` is given (single-widget projects), the generated JSON
- * Schema is also written into `manifest.json` as `schema`.
- */
 export declare function runSchemaGuard(args: {
     outFile: string;
     hashFile: string;
@@ -37,6 +25,14 @@ export declare function runSchemaGuard(args: {
  * must be bundled, because leaving it external is a runtime 404.
  */
 export declare function isWidgetExternal(id: string): boolean;
+/**
+ * True when a widget source file imports `@glasshome/ui` directly. The regex is
+ * the registry's `sourcePattern` for `direct-ui-import`, so the build warning and
+ * the widget-cli lint can never disagree on what counts as a direct import.
+ * node_modules is excluded: dependencies and the SDK's own generated entries in
+ * BUILD_CACHE_DIR (the theme `@import`) are the SDK's business, not the widget's.
+ */
+export declare function isDirectUiImportSource(id: string, code: string): boolean;
 interface DiscoveredWidget {
     name: string;
     entry: string;

package/dist/vite/index.js

@@ -1,17 +1,19 @@
-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 { 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";
 //#region src/vite/index.ts
-function v(e) {
+function S(e) {
 	let t = JSON.stringify(e, Object.keys(e).sort());
-	return r("sha256").update(t).digest("hex").slice(0, 16);
+	return o("sha256").update(t).digest("hex").slice(0, 16);
 }
-var y = 20;
-async function b(e, t) {
+var C = 20;
+async function w(e, t) {
 	if (e === void 0) return;
 	let n;
 	try {
@@ -31,54 +33,103 @@ 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;
-	try {
-		t = (await import(`${e.outFile}?t=${Date.now()}`)).default;
-	} catch {
-		return;
-	}
-	if (await b(t?.manifest?.examples, t?.manifest?.name ?? e.widgetName), !t?.configSchema) return;
-	let n;
+function T(e, t) {
+	if (!e?.length) return;
+	let n = e.map((e) => {
+		let t = e.label ? `"${e.label}"` : `#${e.index}`;
+		return [`  examples[${e.index}] ${t}:`, ...e.problems.map((e) => `    ${e}`)].join("\n");
+	}).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 {
-		let { z: e } = await import("zod");
-		n = e.toJSONSchema(t.configSchema, { unrepresentable: "any" });
+		return {
+			ok: !0,
+			value: JSON.parse(r.stdout)
+		};
 	} catch {
-		return;
+		return {
+			ok: !1,
+			reason: "introspect returned unparseable output"
+		};
 	}
-	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 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;
+}
+var D = [
+	"schema",
+	"defaultConfig",
+	"examples",
+	"configVersion"
+];
+function O(e, t, n) {
+	let r = l(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]);
+	let o = `${JSON.stringify(i, null, 2)}\n`;
+	o !== r && p(e, o);
+}
+async function k(e) {
+	if (!s(e.outFile)) return;
+	let t = 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 w(n.manifest?.examples, r), T(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;
 		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 !== 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`);
 	}
-	u(e.hashFile, `${JSON.stringify({
-		hash: r,
-		configVersion: a
+	p(e.hashFile, `${JSON.stringify({
+		hash: a,
+		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 A = "virtual:glasshome-widget", j = "\0virtual:glasshome-widget", M = "/@glasshome/preview";
+function N(e) {
+	return y === "\\" ? e.split(y).join("/") : e;
 }
-function E() {
-	return m(f(g(import.meta.url)), "../../preview");
+function P() {
+	let e = b(import.meta.url);
+	return v(h(e), "../../preview");
 }
-function D(e) {
-	return t(e);
+function F(e) {
+	return r(e);
 }
-function O() {
+function I() {
 	return {
 		name: "glasshome-widget:sync-layer-guard",
 		apply: "build",
@@ -88,15 +139,38 @@ function O() {
 		}
 	};
 }
-var k = "node_modules/.cache/glasshome-widgets";
-function A(e) {
+var L = /\.(ts|tsx|js|jsx)$/;
+function R(t, n) {
+	let r = N(t).split("?")[0] ?? "";
+	if (r.includes("/node_modules/") || !L.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 z() {
+	let n = /* @__PURE__ */ new Set();
+	return {
+		name: "glasshome-widget:ui-import-guard",
+		apply: "build",
+		enforce: "pre",
+		transform(e, t) {
+			return R(t, e) && n.add(N(_(process.cwd(), t.split("?")[0] ?? t))), null;
+		},
+		buildEnd() {
+			if (n.size === 0) return;
+			let r = e.find((e) => e.id === "direct-ui-import"), i = r ? t(r) : "[@glasshome/widget-sdk] Direct @glasshome/ui imports are deprecated; import the same export from \"@glasshome/widget-sdk\".", a = [...n].map((e) => `    ${e}`).join("\n");
+			console.warn(`${i}\n  Direct @glasshome/ui import(s) in:\n${a}`);
+		}
+	};
+}
+var B = "node_modules/.cache/glasshome-widgets";
+function V(e) {
 	try {
-		return d(p(process.cwd(), "package.json")).resolve(e);
+		return m(g(process.cwd(), "package.json")).resolve(e);
 	} catch {
 		return null;
 	}
 }
-var j = [
+var H = [
 	"--radius",
 	"--background",
 	"--foreground",
@@ -106,128 +180,130 @@ 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 U(e, t) {
+	let n = g(e, `${t}.css`);
+	if (!s(n)) return;
+	let r = l(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 = H.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 W(e, t, n) {
+	let r = v(e, B);
+	c(r, { recursive: !0 });
+	let i = V("@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 = V("@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, [
 		"@import \"tailwindcss\" source(none);",
 		"@import \"tw-animate-css\";",
 		"@import \"@glasshome/ui/styles/theme\";",
-		...d.map((e) => `@source "${T(e)}";`),
+		...u.map((e) => `@source "${N(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 f = v(r, `${t}.entry.ts`);
+	return p(f, [
+		`import "${N(d)}";`,
+		`export { default } from "${N(n)}";`,
 		""
-	].join("\n")), g;
+	].join("\n")), f;
 }
-function P() {
-	let e = _();
+function G() {
+	let e = x();
 	for (let t of e) t.apply ??= "build";
 	return e;
 }
-function F(e) {
+function K(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 (!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({
 			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,
+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`));
+		r.push({
+			...c.data,
 			bundleUrl: `./${a}.js`,
-			...d ? { cssUrl: `./${a}.css` } : {}
+			...u ? { cssUrl: `./${a}.css` } : {}
 		});
 	}
-	let d = {
+	let a = {
 		version: 1,
 		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 		baseUrl: "./",
-		widgets: c
+		widgets: r
 	};
-	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)`);
+	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)`);
 }
-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);
-	if (s.length === 0) {
+async function J(e) {
+	let { build: t } = await import("vite"), n = process.cwd(), r = v(n, e?.srcDir ?? "src"), i = v(n, e?.outDir ?? "dist"), a = K(r);
+	if (a.length === 0) {
 		console.warn("[glasshome-widgets] No widgets found in", r);
 		return;
 	}
 	if (e?.only) {
 		let t = new Set(e.only);
-		s = s.filter((e) => t.has(e.name));
+		a = a.filter((e) => t.has(e.name));
 	}
-	e?.only || i(o) && c(o, { recursive: !0 }), i(o) || a(o, { recursive: !0 });
-	for (let r of s) await t({
+	e?.only || s(i) && d(i, { recursive: !0 }), s(i) || c(i, { recursive: !0 });
+	for (let r of a) await t({
 		configFile: !1,
 		root: n,
 		plugins: [
-			...P(),
+			...G(),
 			...e?.plugins ?? [],
-			O()
+			I(),
+			z()
 		],
 		...e?.viteConfig,
 		build: {
 			lib: {
-				entry: N(n, r.name, r.entry),
+				entry: W(n, r.name, r.entry),
 				formats: ["es"],
 				fileName: r.name,
 				cssFileName: r.name
 			},
-			rollupOptions: { external: D },
-			outDir: o,
+			rollupOptions: { external: F },
+			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"),
-		widgetName: r.name
+	}), U(i, r.name), await k({
+		outFile: g(i, `${r.name}.js`),
+		hashFile: g(h(r.entry), ".schema-hash"),
+		widgetName: r.name,
+		manifestPath: g(h(r.entry), "manifest.json")
 	});
-	I(r, o);
+	q(r, i);
 }
-function R(e) {
+function Y(e) {
 	let t = e?.entry ?? "src/index.tsx", n = {
 		name: "glasshome-widget:build",
 		apply: "build",
@@ -235,12 +311,12 @@ function R(e) {
 			let e = process.cwd();
 			return { build: {
 				lib: {
-					entry: N(e, "index", m(e, t)),
+					entry: W(e, "index", v(e, t)),
 					formats: ["es"],
 					fileName: "index",
 					cssFileName: "index"
 				},
-				rollupOptions: { external: D }
+				rollupOptions: { external: F }
 			} };
 		}
 	}, r = {
@@ -248,19 +324,19 @@ function R(e) {
 		apply: "serve",
 		enforce: "pre",
 		config() {
-			let e = E(), t = process.cwd();
+			let e = P(), t = process.cwd();
 			return { server: { fs: { allow: [
 				e,
 				t,
-				m(t, "..", "..")
+				v(t, "..", "..")
 			] } } };
 		},
 		configureServer(e) {
-			let t = p(E(), "preview.html");
-			e.middlewares.use(async (n, r, i) => {
-				if (n.url === "/" || n.url === "/index.html") try {
-					let i = o(t, "utf-8");
-					i = await e.transformIndexHtml(n.url, i), r.setHeader("Content-Type", "text/html"), r.statusCode = 200, r.end(i);
+			let t = P(), 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");
+					i = await e.transformIndexHtml(t.url, i), r.setHeader("Content-Type", "text/html"), r.statusCode = 200, r.end(i);
 				} catch (e) {
 					i(e);
 				}
@@ -268,33 +344,37 @@ function R(e) {
 			});
 		},
 		resolveId(e) {
-			if (e === w) return T(p(E(), "host.tsx"));
-			if (e === S) return C;
+			if (e === M) {
+				let e = P();
+				return N(g(e, "host.tsx"));
+			}
+			if (e === A) return j;
 		},
 		load(e) {
-			if (e === C) return `export { default } from "${T(m(process.cwd(), t))}";`;
+			if (e === j) return `export { default } from "${N(v(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"),
+			U(v(process.cwd(), "dist"), "index"), await k({
+				outFile: v(process.cwd(), "dist", "index.js"),
+				hashFile: v(process.cwd(), ".schema-hash"),
 				widgetName: "index",
-				manifestPath: m(process.cwd(), "manifest.json")
+				manifestPath: v(process.cwd(), "manifest.json")
 			});
 		}
 	};
 	return [
-		...P(),
+		...G(),
 		n,
-		O(),
+		I(),
+		z(),
 		i,
 		r
 	];
 }
-function z(e) {
+function X(e) {
 	let t = e?.srcDir ?? "src", n = e?.outDir ?? "dist", r = [];
 	return [{
 		name: "glasshome-widgets:build",
@@ -313,7 +393,7 @@ function z(e) {
 			if (e === "\0glasshome-noop") return "export {}";
 		},
 		async closeBundle() {
-			await L({
+			await J({
 				srcDir: t,
 				outDir: n,
 				plugins: r
@@ -322,4 +402,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 { C as MAX_EXAMPLES, J as buildWidgets, K as discoverWidgets, q as generateRegistry, Y as glasshomeWidget, X as glasshomeWidgets, R as isDirectUiImportSource, F as isWidgetExternal, k as runSchemaGuard };

package/dist/vite/introspect.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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.
+ */
+export interface ExampleConfigIssue {
+    index: number;
+    label?: string;
+    problems: string[];
+}