@glasshome/widget-sdk 1.25.2 → 1.27.0

package/README.md

@@ -68,6 +68,17 @@ Provides a `@source` directive for Tailwind v4 so the compiler scans widget SDK
 @source "@glasshome/widget-sdk/tailwind-sources";
 ```
 
+## Dark mode
+
+Style with Tailwind's `dark:` variant and the theme variables (`var(--foreground)`, `var(--card)`): they follow the home's mode in every engine and every SDK version. For logic, call `isDark()`; inside a memo or effect it runs again when the home switches mode. `matchMedia("(prefers-color-scheme: dark)")` answers the device's setting, which differs from the home's mode when the home follows a schedule or the sun.
+
+```tsx
+import { isDark } from "@glasshome/widget-sdk";
+import { createMemo } from "solid-js";
+
+const palette = createMemo(() => (isDark() ? DARK_COLORS : LIGHT_COLORS));
+```
+
 ## Escape patterns, when widgets own their visual surface
 
 Most widgets route through the channel API: `<Widget tone>` / `<Widget color colorTo>` / `<Widget.Icon color>`. A small number of widgets intentionally own their entire visual surface and bypass the channel. These are supported escape patterns, not anti-patterns.

package/dist/deprecations.js

@@ -102,6 +102,13 @@ var e = "https://glasshome.app/docs/widget-sdk/config", t = [
 		removeIn: "2.0.0",
 		replacement: "WidgetVariantConfig.styles (container, class, cssVars)",
 		docsUrl: "https://glasshome.app/docs/widgets/widget-sdk#variants"
+	},
+	{
+		id: "WidgetContext.theme",
+		since: "1.26.0",
+		removeIn: "2.0.0",
+		replacement: "isDark()",
+		docsUrl: "https://glasshome.app/docs/widgets/widget-api-reference"
 	}
 ];
 function n(e) {

package/dist/export-history.json

@@ -5278,5 +5278,293 @@
     "useWidgetViewer",
     "widgetFields",
     "z"
+  ],
+  "1.26.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",
+    "useWidgetViewer",
+    "widgetFields",
+    "z"
+  ],
+  "1.27.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",
+    "useWidgetViewer",
+    "widgetFields",
+    "z"
   ]
 }

package/dist/framework/hooks/use-reduced-motion.d.ts

@@ -1,6 +1,7 @@
 import { type Accessor } from "solid-js";
 /**
- * Reactive `prefers-reduced-motion` accessor.
+ * Reactive reduced-motion accessor: true when the device asks for reduced motion or the home's
+ * Reduce motion setting is on (the `reduce-motion` class on <html>).
  *
  * SSR-safe: returns a constant `false` when `window`/`matchMedia` are absent.
  */

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

@@ -62,6 +62,11 @@ export interface ReactiveWidgetContext {
     onHoldable?: (holds: boolean) => void;
     /** Host hook: a hold on this widget fired. Absent on hosts that predate this field. */
     onHeld?: () => void;
+    /** Host hook: the widget's shell, its tone and its lift (null for the defaults); null when the shell goes. A host that sets it draws the shell's outer glow and shadow, and the widget draws none of its own. Absent on hosts that predate this field. */
+    onShell?: (shell: {
+        tone: string | null;
+        lift: number | null;
+    } | null) => void;
 }
 export declare const WidgetCtx: import("solid-js").Context<ReactiveWidgetContext | undefined>;
 export declare function useWidgetContext(): ReactiveWidgetContext;