@glasshome/widget-sdk 1.23.1 → 1.25.0

package/dist/host/index.d.ts

@@ -1 +1 @@
-export { instantiateWidget, type MountOptions, type WidgetInstanceHandle, } from "./instantiate-widget";
+export { delegateInside, instantiateWidget, type MountOptions, type WidgetInstanceHandle, } from "./instantiate-widget";

package/dist/host/index.js

@@ -30,16 +30,19 @@ var h = (e) => {
 if (typeof document < "u") {
 	let e = [...n];
 	i(e);
-	for (let t of e) document.addEventListener(t, h);
+	for (let t of e) document.addEventListener(t, h, { passive: !0 });
 }
-function g(e) {
+function g(e, t = /* @__PURE__ */ new Set()) {
 	if (e.mode !== "closed") return () => {};
-	let t = [...n], a = e;
-	i(t, a);
-	for (let n of t) e.addEventListener(n, h);
+	let a = [...n], o = {
+		addEventListener: (n, r) => e.addEventListener(n, r, { passive: t.has(n) }),
+		removeEventListener: (t, n) => e.removeEventListener(t, n)
+	};
+	i(a, o);
+	for (let t of a) e.addEventListener(t, h, { passive: !0 });
 	return () => {
-		r(a);
-		for (let n of t) e.removeEventListener(n, h);
+		r(o);
+		for (let t of a) e.removeEventListener(t, h);
 	};
 }
 function _(n, r) {
@@ -66,4 +69,4 @@ function _(n, r) {
 	} };
 }
 //#endregion
-export { _ as instantiateWidget };
+export { g as delegateInside, _ as instantiateWidget };

package/dist/host/instantiate-widget.d.ts

@@ -28,6 +28,11 @@ export interface MountOptions {
      */
     mirrorClasses?: string[];
 }
+/**
+ * Solid handlers inside a closed root run; anything a host renders into one it owns needs this.
+ * Event types in `passive` are listened to passively, so they never hold up scrolling.
+ */
+export declare function delegateInside(shadow: ShadowRoot, passive?: ReadonlySet<string>): () => void;
 /**
  * Mount a widget into a closed shadow root on `host`.
  *

package/dist/index.js

@@ -3136,7 +3136,7 @@ function Co() {
 //#region src/version.ts
 var wo = {
 	name: "@glasshome/widget-sdk",
-	version: "1.23.1",
+	version: "1.25.0",
 	description: "SDK for building GlassHome dashboard widgets with SolidJS",
 	keywords: [
 		"dashboard",
@@ -3192,14 +3192,15 @@ var wo = {
 			types: "./dist/vite/index.d.ts",
 			import: "./dist/vite/index.js"
 		},
+		"./export-history": "./dist/export-history.json",
 		"./tailwind-sources": "./tailwind-sources.css",
 		"./package.json": "./package.json"
 	},
 	publishConfig: { access: "public" },
 	scripts: {
-		build: "vite build && tsc -p tsconfig.build.json && bun scripts/check-host-singleton.ts",
+		build: "vite build && tsc -p tsconfig.build.json && bun scripts/check-host-singleton.ts && bun scripts/export-names.ts --emit",
 		dev: "vite build --watch",
-		test: "bun test src && vitest run",
+		test: "bun test src scripts && vitest run",
 		"test:dom": "vitest run",
 		"test:dom:watch": "vitest",
 		"typecheck:test": "tsc --noEmit",
@@ -3207,7 +3208,7 @@ var wo = {
 		lint: "oxlint --type-aware . && oxfmt --check ."
 	},
 	dependencies: {
-		"@glasshome/widget-contract": "0.4.1",
+		"@glasshome/widget-contract": "0.5.0",
 		"@tailwindcss/vite": "^4.1.13",
 		clsx: "^2.1.1",
 		"happy-dom": "^20.0.0",
@@ -3221,14 +3222,16 @@ var wo = {
 		"@solidjs/testing-library": "^0.8.10",
 		"@types/bun": "^1.4.0",
 		"@types/node": "^25.2.2",
+		"@vitest/browser-playwright": "4.1.11",
 		fallow: "3.17.0",
 		oxfmt: "0.65.0",
 		oxlint: "1.81.0",
 		"oxlint-tsgolint": "7.0.2001",
+		playwright: "1.63.0",
 		typescript: "^7.0.2",
 		vite: "^8.1.0",
 		"vite-plugin-solid": "^2.11.12",
-		vitest: "^4.1.10"
+		vitest: "4.1.11"
 	},
 	peerDependencies: {
 		"@glasshome/sync-layer": "0.9.1",

package/dist/vite/index.d.ts

@@ -16,8 +16,6 @@ export interface GlasshomeWidgetOptions {
  * author decide which states matter rather than discovering the loss never.
  */
 export declare const MAX_EXAMPLES = 20;
-/** What a built bundle imports from the SDK, by exported name; `*` for a namespace or dynamic import. */
-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;

package/dist/vite/index.js

@@ -5,16 +5,17 @@ import { existsSync as s, mkdirSync as c, readFileSync as l, readdirSync as u, r
 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 x } from "node:child_process";
+import { sdkImportsOf as ee } from "@glasshome/widget-contract/sdk-floor";
+import te from "@tailwindcss/vite";
+import { spawn as ne, spawnSync as re } from "node:child_process";
 //#region node_modules/@glasshome/widget-contract/dist/clock.mjs
-var S = (e) => e, C = (e) => e, ne = {
+var x = (e) => e, S = (e) => e, ie = {
 	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;
+	setTimeout: (e, t) => x(globalThis.setTimeout(e, t)),
+	clearTimeout: (e) => globalThis.clearTimeout(S(e)),
+	setInterval: (e, t) => x(globalThis.setInterval(e, t)),
+	clearInterval: (e) => globalThis.clearInterval(S(e))
+}, C = 262144e3, w = 3e4, ae = 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;
@@ -25,7 +26,7 @@ function E(e, t) {
 		ok: !1,
 		reason: "introspect not found next to the sdk"
 	};
-	let r = x(process.execPath, [
+	let r = re(process.execPath, [
 		"--conditions",
 		"browser",
 		n,
@@ -54,8 +55,8 @@ function E(e, t) {
 		};
 	}
 }
-function ae(e) {
-	let t = te(process.execPath, [
+function D(e) {
+	let t = ne(process.execPath, [
 		"--conditions",
 		"browser",
 		e
@@ -99,7 +100,7 @@ function oe(e) {
 }
 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();
+	let t = e?.rssLimitBytes ?? C, n = e?.timeoutMs ?? w, r = e?.slowMs ?? ae, i = e?.clock ?? ie, a = e?.spawnWorker ?? D, o = null, s = !1, c = 0, l = Promise.resolve();
 	function u(e, t) {
 		for (let n of e.pending.values()) n({
 			ok: !1,
@@ -206,17 +207,17 @@ function se(e) {
 }
 //#endregion
 //#region src/vite/index.ts
-var D = 2;
-function O(e) {
-	if (Array.isArray(e)) return `[${e.map(O).join(",")}]`;
+var O = 2;
+function k(e) {
+	if (Array.isArray(e)) return `[${e.map(k).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)}:${O(t[e])}`).join(",")}}`;
+		return `{${Object.keys(t).sort().filter((e) => t[e] !== void 0).map((e) => `${JSON.stringify(e)}:${k(t[e])}`).join(",")}}`;
 	}
 	return JSON.stringify(e) ?? "null";
 }
 function ce(e) {
-	return o("sha256").update(O(e)).digest("hex").slice(0, 16);
+	return o("sha256").update(k(e)).digest("hex").slice(0, 16);
 }
 var le = 20;
 async function ue(e, t) {
@@ -269,20 +270,9 @@ function pe(e, t, n) {
 	let o = `${JSON.stringify(i, null, 2)}\n`;
 	o !== r && p(e, o);
 }
-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();
-	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;
-}
 var A = { useDaylight: "sun.sun" };
 function j(e, t, n) {
-	let r = k(e);
+	let r = ee(e);
 	for (let [e, a] of Object.entries(A)) {
 		if (!r.has(e) && !r.has("*") || i(t, a)) continue;
 		let o = a.split(".")[0];
@@ -308,18 +298,18 @@ async function M(e) {
 		} catch {
 			n = null;
 		}
-		if (n && n.hashVersion === D) {
+		if (n && n.hashVersion === O) {
 			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 ${D}. 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 ${O}. 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: D
+		hashVersion: O
 	})}\n`;
 	m !== f && p(e.hashFile, m);
 }
-var ge = "virtual:glasshome-widget", N = "\0virtual:glasshome-widget", P = "/@glasshome/preview";
+var N = "virtual:glasshome-widget", P = "\0virtual:glasshome-widget", me = "/@glasshome/preview";
 function F(e) {
 	return y === "\\" ? e.split(y).join("/") : e;
 }
@@ -330,10 +320,10 @@ function I() {
 function L(e) {
 	return r(e);
 }
-var R = /\.(ts|tsx|js|jsx)$/, _e = /from\s+["']@glasshome\/sync-layer(\/[^"']*)?["']/;
+var R = /\.(ts|tsx|js|jsx)$/, he = /from\s+["']@glasshome\/sync-layer(\/[^"']*)?["']/;
 function z(e, t) {
 	let n = F(e).split("?")[0] ?? "";
-	return n.includes("/node_modules/") || !R.test(n) ? !1 : _e.test(t);
+	return n.includes("/node_modules/") || !R.test(n) ? !1 : he.test(t);
 }
 function B() {
 	return {
@@ -382,7 +372,7 @@ function U(n) {
 		}
 	};
 }
-var ve = "node_modules/.cache/glasshome-widgets";
+var ge = "node_modules/.cache/glasshome-widgets";
 function W(e) {
 	try {
 		return m(g(process.cwd(), "package.json")).resolve(e);
@@ -390,7 +380,7 @@ function W(e) {
 		return null;
 	}
 }
-var ye = [
+var _e = [
 	"--radius",
 	"--background",
 	"--foreground",
@@ -409,7 +399,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 = ye.find((e) => n.includes(`${e}:`));
+		let n = e[1] ?? "", r = _e.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.`);
 	}
 }
@@ -418,7 +408,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, ve);
+	let i = v(e, ge);
 	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.");
@@ -451,7 +441,7 @@ function Y() {
 	return { lightningcss: { include: e.HexAlphaColors } };
 }
 function X() {
-	let e = ee();
+	let e = te();
 	for (let t of e) t.apply ??= "build";
 	return e;
 }
@@ -541,7 +531,7 @@ async function $(e) {
 	});
 	Q(r, i);
 }
-function be(e) {
+function ve(e) {
 	let t = e?.entry ?? "src/index.tsx", n = {
 		name: "glasshome-widget:build",
 		apply: "build",
@@ -585,14 +575,14 @@ function be(e) {
 			});
 		},
 		resolveId(e) {
-			if (e === P) {
+			if (e === me) {
 				let e = I();
 				return F(g(e, "host.tsx"));
 			}
-			if (e === ge) return N;
+			if (e === N) return P;
 		},
 		load(e) {
-			if (e === N) return `export { default } from "${F(v(process.cwd(), t))}";`;
+			if (e === P) return `export { default } from "${F(v(process.cwd(), t))}";`;
 		}
 	}, i = {
 		name: "glasshome-widget:schema",
@@ -615,7 +605,7 @@ function be(e) {
 		r
 	];
 }
-function xe(e) {
+function ye(e) {
 	let t = e?.srcDir ?? "src", n = e?.outDir ?? "dist", r = [];
 	return [{
 		name: "glasshome-widgets:build",
@@ -643,4 +633,4 @@ function xe(e) {
 	}];
 }
 //#endregion
-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 };
+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, ve as glasshomeWidget, ye as glasshomeWidgets, E as introspectOnce, z as isDirectSyncLayerImportSource, V as isDirectUiImportSource, L as isWidgetExternal, M as runSchemaGuard, q as widgetProjectScanDirs };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glasshome/widget-sdk",
-  "version": "1.23.1",
+  "version": "1.25.0",
   "description": "SDK for building GlassHome dashboard widgets with SolidJS",
   "keywords": [
     "dashboard",
@@ -58,6 +58,7 @@
       "types": "./dist/vite/index.d.ts",
       "import": "./dist/vite/index.js"
     },
+    "./export-history": "./dist/export-history.json",
     "./tailwind-sources": "./tailwind-sources.css",
     "./package.json": "./package.json"
   },
@@ -65,9 +66,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "vite build && tsc -p tsconfig.build.json && bun scripts/check-host-singleton.ts",
+    "build": "vite build && tsc -p tsconfig.build.json && bun scripts/check-host-singleton.ts && bun scripts/export-names.ts --emit",
     "dev": "vite build --watch",
-    "test": "bun test src && vitest run",
+    "test": "bun test src scripts && vitest run",
     "test:dom": "vitest run",
     "test:dom:watch": "vitest",
     "typecheck:test": "tsc --noEmit",
@@ -75,7 +76,7 @@
     "lint": "oxlint --type-aware . && oxfmt --check ."
   },
   "dependencies": {
-    "@glasshome/widget-contract": "0.4.1",
+    "@glasshome/widget-contract": "0.5.0",
     "@tailwindcss/vite": "^4.1.13",
     "clsx": "^2.1.1",
     "happy-dom": "^20.0.0",
@@ -89,14 +90,16 @@
     "@solidjs/testing-library": "^0.8.10",
     "@types/bun": "^1.4.0",
     "@types/node": "^25.2.2",
+    "@vitest/browser-playwright": "4.1.11",
     "fallow": "3.17.0",
     "oxfmt": "0.65.0",
     "oxlint": "1.81.0",
     "oxlint-tsgolint": "7.0.2001",
+    "playwright": "1.63.0",
     "typescript": "^7.0.2",
     "vite": "^8.1.0",
     "vite-plugin-solid": "^2.11.12",
-    "vitest": "^4.1.10"
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
     "@glasshome/sync-layer": "0.9.1",