@glasshome/widget-sdk 1.6.0 → 1.7.0

package/dist/host/index.d.ts

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

package/dist/host/index.js

@@ -0,0 +1,51 @@
+import { n as e, t } from "../tokens-Bdfb1xYe.js";
+import { ErrorBoundary as n, createComponent as r } from "solid-js";
+import { render as i } from "solid-js/web";
+//#region src/host/instantiate-widget.ts
+var a = /* @__PURE__ */ new Map();
+function o(e) {
+	let t = a.get(e);
+	if (t) return t;
+	let n = new CSSStyleSheet();
+	return n.replaceSync(e), a.set(e, n), n;
+}
+var s = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Map(), l = !1;
+function u(e, t) {
+	for (let n of t) e.classList.toggle(n, document.documentElement.classList.contains(n));
+}
+function d(e, t) {
+	for (let e of t) s.add(e);
+	return c.set(e, t), u(e, t), l || (l = !0, new MutationObserver(() => {
+		for (let [e, t] of c) u(e, t);
+	}).observe(document.documentElement, {
+		attributes: !0,
+		attributeFilter: ["class"]
+	})), () => {
+		c.delete(e);
+	};
+}
+function f(a, s) {
+	let c = a.attachShadow({ mode: "closed" }), l = d(a, s.mirrorClasses ?? ["dark"]);
+	t(c), s.cssText !== null && (c.adoptedStyleSheets = [...c.adoptedStyleSheets, o(s.cssText)]), s.extraSheets?.length && (c.adoptedStyleSheets = [...c.adoptedStyleSheets, ...s.extraSheets]);
+	let u = i(() => r(e.Provider, {
+		value: s.ctx,
+		get children() {
+			return r(n, {
+				fallback: (e) => {
+					let t = e instanceof Error ? e : Error(String(e));
+					return queueMicrotask(() => s.onCrash(t)), null;
+				},
+				get children() {
+					return r(s.definition.component, { get config() {
+						return s.config();
+					} });
+				}
+			});
+		}
+	}), c);
+	return { dispose: () => {
+		l(), u();
+	} };
+}
+//#endregion
+export { f as instantiateWidget };

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

@@ -0,0 +1,48 @@
+import { type Accessor } from "solid-js";
+import type { ReactiveWidgetContext } from "../framework/hooks/use-widget-context";
+import type { WidgetDefinition } from "../types";
+export interface WidgetInstanceHandle {
+    dispose: () => void;
+}
+export interface MountOptions {
+    definition: WidgetDefinition;
+    /** Read inside the shadow render root so config changes propagate reactively across it. */
+    config: Accessor<Record<string, unknown>>;
+    /** Host context, re-provided inside the new render root (context does not cross roots). */
+    ctx: ReactiveWidgetContext;
+    /** Per-widget stylesheet text fetched by the host; null when the widget ships no CSS. */
+    cssText: string | null;
+    /** Called when the widget tree throws; the host owns crash counting and remount. */
+    onCrash: (error: Error) => void;
+    /**
+     * Extra sheets adopted AFTER the widget's own CSS, so their `!important` rules
+     * win ties. The host supplies these for effects it drives from outside the
+     * shadow (e.g. performant-blur / a11y overrides keyed on a mirrored class).
+     * Injection of SDK tokens is unchanged and never includes ui theme tokens.
+     */
+    extraSheets?: CSSStyleSheet[];
+    /**
+     * Document classes mirrored onto the shadow host so `:host(.x)` variants match
+     * (descendant selectors like `.dark *` cannot cross the boundary). Defaults to
+     * `["dark"]` — the SDK's dark variant. A host adds its own (reduce-blur,
+     * reduce-motion, perf-blur, …) when it ships sheets keyed on them.
+     */
+    mirrorClasses?: string[];
+}
+/**
+ * Mount a widget into a closed shadow root on `host`.
+ *
+ * The only ShadowRoot reference lives in this closure — `mode: "closed"` keeps
+ * it off `host.shadowRoot`, so neither the widget nor another bundle can reach
+ * into a foreign widget's DOM through the host element.
+ *
+ * This is the framework half of the widget host contract, shared by dash, the
+ * preview harness, and the hub render worker. It attaches the shadow, injects
+ * SDK tokens (tones + widget vars only — the ui theme reaches widgets by
+ * document inheritance, never pinned on `:host`), adopts the widget's CSS and
+ * any host `extraSheets`, mirrors the requested document classes, and renders
+ * the widget under a re-provided `WidgetCtx` and a crash boundary. Trust
+ * boundary steps that are host-specific (freeze-intrinsics, capability
+ * enforcement) stay in the host and are not part of this recipe.
+ */
+export declare function instantiateWidget(host: HTMLElement, opts: MountOptions): WidgetInstanceHandle;