@glasshome/widget-sdk 1.28.0 → 1.30.0

package/dist/deprecations.js

@@ -103,6 +103,14 @@ var e = "https://glasshome.app/docs/widget-sdk/config", t = [
 		replacement: "WidgetVariantConfig.styles (container, class, cssVars)",
 		docsUrl: "https://glasshome.app/docs/widgets/widget-sdk#variants"
 	},
+	{
+		id: "host.instantiateWidget",
+		since: "1.30.0",
+		removeIn: "2.0.0",
+		replacement: "the sealed engine: Dash's WidgetSlot, or bun widget preview",
+		docsUrl: "https://glasshome.app/docs/widgets/widget-sealed-engine",
+		sourcePattern: "\\binstantiateWidget\\b"
+	},
 	{
 		id: "WidgetContext.theme",
 		since: "1.26.0",

package/dist/export-history.json

@@ -5855,5 +5855,295 @@
     "useWidgetViewer",
     "widgetFields",
     "z"
+  ],
+  "1.29.0": [
+    "Badge",
+    "Button",
+    "ButtonGroup",
+    "Carousel",
+    "CarouselContent",
+    "CarouselDots",
+    "CarouselItem",
+    "CarouselNext",
+    "CarouselPrevious",
+    "ColorDisc",
+    "ColorSlider",
+    "ColorWheel",
+    "CountPill",
+    "Icon",
+    "Input",
+    "Label",
+    "PanelEntityRow",
+    "PanelFacts",
+    "PanelRow",
+    "PanelRows",
+    "PanelSection",
+    "Progress",
+    "ResponsiveDialog",
+    "ResponsiveDialogBody",
+    "ResponsiveDialogClose",
+    "ResponsiveDialogContent",
+    "ResponsiveDialogDescription",
+    "ResponsiveDialogFooter",
+    "ResponsiveDialogHeader",
+    "ResponsiveDialogTitle",
+    "SDK_VERSION",
+    "SchemaForm",
+    "SectionIcon",
+    "SectionTitle",
+    "Select",
+    "SelectContent",
+    "SelectItem",
+    "SelectTrigger",
+    "SelectValue",
+    "Slider",
+    "SwatchPicker",
+    "Switch",
+    "Tabs",
+    "TabsContent",
+    "TabsList",
+    "TabsTrigger",
+    "TemperatureBar",
+    "Toggle",
+    "ToggleGroup",
+    "ToggleGroupItem",
+    "ToneSchema",
+    "Widget",
+    "WidgetAction",
+    "WidgetBackdrop",
+    "WidgetChip",
+    "WidgetChoice",
+    "WidgetContent",
+    "WidgetControls",
+    "WidgetCtx",
+    "WidgetDebugTab",
+    "WidgetDebugView",
+    "WidgetDialog",
+    "WidgetGlyph",
+    "WidgetHead",
+    "WidgetHero",
+    "WidgetIcon",
+    "WidgetLayer",
+    "WidgetManifestSchema",
+    "WidgetSizeCtx",
+    "WidgetSliderFill",
+    "WidgetStatus",
+    "WidgetStepper",
+    "WidgetTitle",
+    "WidgetValue",
+    "buildDebugData",
+    "byDomain",
+    "calculateLightGroup",
+    "calculateSensorGroup",
+    "copyText",
+    "countActiveEntities",
+    "defineConfig",
+    "defineWidget",
+    "deprecations",
+    "field",
+    "formatDeprecation",
+    "formatSchemaError",
+    "getEntityAttribute",
+    "getForecasts",
+    "getStream",
+    "getWebRtcClientConfig",
+    "hassMediaUrl",
+    "imagePreset",
+    "imageSrc",
+    "imageUrl",
+    "injectTokens",
+    "isDark",
+    "isEntityActive",
+    "isPanelControllable",
+    "mediaUrl",
+    "monotoneCubicPath",
+    "parseColor",
+    "presetValue",
+    "sendWebRtcCandidate",
+    "startWebRtcSession",
+    "state",
+    "svgColors",
+    "trackEntityHistory",
+    "untrackEntityHistory",
+    "useArea",
+    "useCalendarEvents",
+    "useCamera",
+    "useConfirm",
+    "useConnection",
+    "useCopyText",
+    "useCurrency",
+    "useDaylight",
+    "useEntities",
+    "useEntity",
+    "useEntityHistory",
+    "useEntityStatistics",
+    "useForecast",
+    "useHassConfig",
+    "useIntersectionPause",
+    "useLocale",
+    "useMaterial",
+    "useReducedMotion",
+    "useService",
+    "useStore",
+    "useTemperatureUnit",
+    "useToggle",
+    "useTurnOff",
+    "useTurnOn",
+    "useUnitSystem",
+    "useWidgetContext",
+    "useWidgetDashboard",
+    "useWidgetDialog",
+    "useWidgetDimensions",
+    "useWidgetEntityGroup",
+    "useWidgetGestures",
+    "useWidgetState",
+    "useWidgetViewer",
+    "widgetFields",
+    "z"
+  ],
+  "1.30.0": [
+    "Badge",
+    "Button",
+    "ButtonGroup",
+    "Carousel",
+    "CarouselContent",
+    "CarouselDots",
+    "CarouselItem",
+    "CarouselNext",
+    "CarouselPrevious",
+    "ColorDisc",
+    "ColorSlider",
+    "ColorWheel",
+    "CountPill",
+    "Icon",
+    "Input",
+    "Label",
+    "PanelEntityRow",
+    "PanelFacts",
+    "PanelRow",
+    "PanelRows",
+    "PanelSection",
+    "Progress",
+    "ResponsiveDialog",
+    "ResponsiveDialogBody",
+    "ResponsiveDialogClose",
+    "ResponsiveDialogContent",
+    "ResponsiveDialogDescription",
+    "ResponsiveDialogFooter",
+    "ResponsiveDialogHeader",
+    "ResponsiveDialogTitle",
+    "SDK_VERSION",
+    "SchemaForm",
+    "SectionIcon",
+    "SectionTitle",
+    "Select",
+    "SelectContent",
+    "SelectItem",
+    "SelectTrigger",
+    "SelectValue",
+    "Slider",
+    "SwatchPicker",
+    "Switch",
+    "Tabs",
+    "TabsContent",
+    "TabsList",
+    "TabsTrigger",
+    "TemperatureBar",
+    "Toggle",
+    "ToggleGroup",
+    "ToggleGroupItem",
+    "ToneSchema",
+    "Widget",
+    "WidgetAction",
+    "WidgetBackdrop",
+    "WidgetChip",
+    "WidgetChoice",
+    "WidgetContent",
+    "WidgetControls",
+    "WidgetCtx",
+    "WidgetDebugTab",
+    "WidgetDebugView",
+    "WidgetDialog",
+    "WidgetGlyph",
+    "WidgetHead",
+    "WidgetHero",
+    "WidgetIcon",
+    "WidgetLayer",
+    "WidgetManifestSchema",
+    "WidgetSizeCtx",
+    "WidgetSliderFill",
+    "WidgetStatus",
+    "WidgetStepper",
+    "WidgetTitle",
+    "WidgetValue",
+    "buildDebugData",
+    "byDomain",
+    "calculateLightGroup",
+    "calculateSensorGroup",
+    "copyText",
+    "countActiveEntities",
+    "defineConfig",
+    "defineWidget",
+    "deprecations",
+    "field",
+    "formatDeprecation",
+    "formatSchemaError",
+    "getEntityAttribute",
+    "getForecasts",
+    "getStream",
+    "getWebRtcClientConfig",
+    "hassMediaUrl",
+    "imagePreset",
+    "imageSrc",
+    "imageUrl",
+    "injectTokens",
+    "isDark",
+    "isEntityActive",
+    "isPanelControllable",
+    "mediaUrl",
+    "monotoneCubicPath",
+    "parseColor",
+    "presetValue",
+    "sendWebRtcCandidate",
+    "startWebRtcSession",
+    "state",
+    "svgColors",
+    "trackEntityHistory",
+    "untrackEntityHistory",
+    "useArea",
+    "useCalendarEvents",
+    "useCamera",
+    "useConfirm",
+    "useConnection",
+    "useCopyText",
+    "useCurrency",
+    "useDaylight",
+    "useEntities",
+    "useEntity",
+    "useEntityHistory",
+    "useEntityStatistics",
+    "useForecast",
+    "useHassConfig",
+    "useIntersectionPause",
+    "useLocale",
+    "useMaterial",
+    "useReducedMotion",
+    "useService",
+    "useStore",
+    "useTemperatureUnit",
+    "useToggle",
+    "useTurnOff",
+    "useTurnOn",
+    "useUnitSystem",
+    "useWidgetContext",
+    "useWidgetDashboard",
+    "useWidgetDialog",
+    "useWidgetDimensions",
+    "useWidgetEntityGroup",
+    "useWidgetGestures",
+    "useWidgetState",
+    "useWidgetViewer",
+    "widgetFields",
+    "z"
   ]
 }

package/dist/framework/hooks/use-widget-context.d.ts

@@ -54,6 +54,9 @@ export interface ReactiveWidgetContext {
     /** Present when the host mounts the widget; the service hooks route
         through it. Absent in previews/tests (direct sync-layer fallback). */
     callService?: ServiceCallFn;
+    /** Whether the widget's own grant lets it make this call, so a control it cannot run is never drawn.
+        Absent on hosts that predate this field: draw the control and let the call answer. */
+    canCall?: (domain: string, service: string, entityIds: string[]) => boolean;
     /** The dashboard this instance sits on. Absent on hosts that predate this field. */
     dashboard?: () => WidgetDashboard;
     /** Who is looking. Absent on hosts that predate this field. */

package/dist/framework/panel/panel-entity.d.ts

@@ -4,6 +4,7 @@ export declare function isPanelControllable(domain: string): boolean;
 /**
  * A row for any entity, drawn and wired from its domain: a light dims, a cover
  * opens, a lock locks. The same row the area panel and every group panel use.
+ * A call the widget's grant refuses draws no control; the row still reads.
  */
 export declare function PanelEntityRow(props: {
     entityId: string;

package/dist/framework/panel/panel.d.ts

@@ -9,7 +9,7 @@ export interface PanelSlide {
     onCommit?: (value: number) => void;
     /** Names the value for screen readers and the keyboard handle ("Brightness"). */
     label?: string;
-    /** Keyboard step; the drag reports whole numbers. */
+    /** The value moves in steps of this size, by drag and by keyboard. Unset: the drag reports whole numbers and a key moves 5. */
     step?: number;
 }
 /** A labelled group in the panel's aside ("Lights", "Playing on"). */

package/dist/host/index.js

@@ -1,63 +1,64 @@
-import { ErrorBoundary as e, createComponent as t } from "solid-js";
-import { DelegatedEvents as n, clearDelegatedEvents as r, delegateEvents as i, render as a } from "solid-js/web";
-import { WidgetCtx as o, injectTokens as s } from "@glasshome/widget-sdk";
+import { deprecate as e } from "../deprecations.js";
+import { ErrorBoundary as t, createComponent as n } from "solid-js";
+import { DelegatedEvents as r, clearDelegatedEvents as i, delegateEvents as a, render as o } from "solid-js/web";
+import { WidgetCtx as s, injectTokens as c } from "@glasshome/widget-sdk";
 //#region src/host/instantiate-widget.ts
-var c = /* @__PURE__ */ new Map();
-function l(e) {
-	let t = c.get(e);
+var l = /* @__PURE__ */ new Map();
+function u(e) {
+	let t = l.get(e);
 	if (t) return t;
 	let n = new CSSStyleSheet();
-	return n.replaceSync(e), c.set(e, n), n;
+	return n.replaceSync(e), l.set(e, n), n;
 }
-var u = /* @__PURE__ */ new Set(), d = /* @__PURE__ */ new Map(), f = !1;
-function p(e, t) {
+var d = /* @__PURE__ */ new Set(), f = /* @__PURE__ */ new Map(), p = !1;
+function m(e, t) {
 	for (let n of t) e.classList.toggle(n, document.documentElement.classList.contains(n));
 }
-function m(e, t) {
-	for (let e of t) u.add(e);
-	return d.set(e, t), p(e, t), f || (f = !0, new MutationObserver(() => {
-		for (let [e, t] of d) p(e, t);
+function h(e, t) {
+	for (let e of t) d.add(e);
+	return f.set(e, t), m(e, t), p || (p = !0, new MutationObserver(() => {
+		for (let [e, t] of f) m(e, t);
 	}).observe(document.documentElement, {
 		attributes: !0,
 		attributeFilter: ["class"]
 	})), () => {
-		d.delete(e);
+		f.delete(e);
 	};
 }
-var h = (e) => {
+var g = (e) => {
 	Reflect.deleteProperty(e, "target"), Reflect.deleteProperty(e, "currentTarget");
 };
 if (typeof document < "u") {
-	let e = [...n];
-	i(e);
-	for (let t of e) document.addEventListener(t, h, { passive: !0 });
+	let e = [...r];
+	a(e);
+	for (let t of e) document.addEventListener(t, g, { passive: !0 });
 }
-function g(e, t = /* @__PURE__ */ new Set()) {
+function _(e, t = /* @__PURE__ */ new Set()) {
 	if (e.mode !== "closed") return () => {};
-	let a = [...n], o = {
+	let n = [...r], 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 });
+	a(n, o);
+	for (let t of n) e.addEventListener(t, g, { passive: !0 });
 	return () => {
-		r(o);
-		for (let t of a) e.removeEventListener(t, h);
+		i(o);
+		for (let t of n) e.removeEventListener(t, g);
 	};
 }
-function _(n, r) {
-	let i = n.attachShadow({ mode: "closed" }), c = g(i), u = m(n, r.mirrorClasses ?? ["dark"]);
-	s(i), r.cssText !== null && (i.adoptedStyleSheets = [...i.adoptedStyleSheets, l(r.cssText)]), r.extraSheets?.length && (i.adoptedStyleSheets = [...i.adoptedStyleSheets, ...r.extraSheets]);
-	let d = a(() => t(o.Provider, {
+function v(e, r) {
+	let i = e.attachShadow({ mode: "closed" }), a = _(i), l = h(e, r.mirrorClasses ?? ["dark"]);
+	c(i), r.cssText !== null && (i.adoptedStyleSheets = [...i.adoptedStyleSheets, u(r.cssText)]), r.extraSheets?.length && (i.adoptedStyleSheets = [...i.adoptedStyleSheets, ...r.extraSheets]);
+	let d = o(() => n(s.Provider, {
 		value: r.ctx,
 		get children() {
-			return t(e, {
+			return n(t, {
 				fallback: (e) => {
 					let t = e instanceof Error ? e : Error(String(e));
 					return queueMicrotask(() => r.onCrash(t)), null;
 				},
 				get children() {
-					return t(r.definition.component, { get config() {
+					return n(r.definition.component, { get config() {
 						return r.config();
 					} });
 				}
@@ -65,8 +66,9 @@ function _(n, r) {
 		}
 	}), i);
 	return { dispose: () => {
-		u(), d(), c();
+		l(), d(), a();
 	} };
 }
+var y = e(v, "host.instantiateWidget");
 //#endregion
-export { g as delegateInside, _ as instantiateWidget };
+export { _ as delegateInside, y as instantiateWidget };

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

@@ -34,19 +34,11 @@ export interface MountOptions {
  */
 export declare function delegateInside(shadow: ShadowRoot, passive?: ReadonlySet<string>): () => void;
 /**
- * Mount a widget into a closed shadow root on `host`.
+ * Mount a widget into a closed shadow root on `host`, on the page engine: SDK tokens, the widget's
+ * CSS and any host `extraSheets` adopted, the requested document classes mirrored, the widget rendered
+ * under a re-provided `WidgetCtx` and a crash boundary.
  *
- * 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.
+ * @deprecated since 1.30.0, removed in 2.0.0. Homes and previews mount widgets in the sealed engine:
+ * Dash's WidgetSlot, or `bun widget preview`. See https://glasshome.app/docs/widgets/widget-sealed-engine
  */
-export declare function instantiateWidget(host: HTMLElement, opts: MountOptions): WidgetInstanceHandle;
+export declare const instantiateWidget: (host: HTMLElement, opts: MountOptions) => WidgetInstanceHandle;