@glasshome/widget-sdk 1.20.1 → 1.22.0

package/dist/deprecations.js

@@ -88,6 +88,14 @@ var e = "https://glasshome.app/docs/widget-sdk/config", t = [
 		docsUrl: "https://glasshome.app/docs/widget-sdk/widget",
 		sourcePattern: "<WidgetSliderFill[^>]*\\scolor="
 	},
+	{
+		id: "internal-material-vars",
+		since: "1.21.0",
+		removeIn: "2.0.0",
+		replacement: "the --material-* variables on the materials page, or useMaterial()",
+		docsUrl: "https://glasshome.app/docs/widgets/widget-sdk/materials",
+		sourcePattern: "var\\(\\s*--(?:glass-[a-z0-9-]+|_[a-z0-9-]+|material-(?:depth|hue|reach|ink|ink-level|ink-lift|edge-width|edge-ink|edge-accent)(?![a-z0-9-]))"
+	},
 	{
 		id: "WidgetVariantConfig.layout",
 		since: "1.18.0",

package/dist/framework/hooks/index.d.ts

@@ -3,9 +3,10 @@
  *
  * Hooks for widget development: context, dialog, entity group.
  */
-export { type ReactiveWidgetContext, type ServiceCallFn, useWidgetContext, WidgetCtx, type WidgetDashboard, type WidgetViewer, type WidgetDimensions, } from "./use-widget-context";
+export { type ReactiveWidgetContext, type ServiceCallFn, useWidgetContext, WidgetCtx, type WidgetDashboard, type WidgetMaterial, type WidgetViewer, type WidgetDimensions, } from "./use-widget-context";
 export { useWidgetDashboard } from "./use-widget-dashboard";
 export { useWidgetViewer } from "./use-widget-viewer";
+export { useMaterial } from "./use-material";
 export { useWidgetDimensions, type WidgetDimensionsAccessor, WidgetSizeCtx, } from "./use-widget-dimensions";
 export { useIntersectionPause } from "./use-intersection-pause";
 export { type Daylight, type DaylightPhase, useDaylight } from "./use-daylight";

package/dist/framework/hooks/use-material.d.ts

@@ -0,0 +1,4 @@
+import { type WidgetMaterial } from "./use-widget-context";
+/** The material the home is wearing, by id with its terms. Style from the
+ *  public --material-* variables; read this to decide, never to paint. */
+export declare function useMaterial(): () => WidgetMaterial;

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

@@ -1,3 +1,4 @@
+import type { MaterialTerms } from "@glasshome/ui/tokens";
 /**
  * Reactive widget context.
  *
@@ -28,6 +29,11 @@ export interface WidgetViewer {
     /** The signed-in person's name, or null for a paired screen. */
     name: string | null;
 }
+export interface WidgetMaterial {
+    /** The preset today; a shared material's id once materials can be shared. */
+    id: string;
+    terms: MaterialTerms;
+}
 export interface ReactiveWidgetContext {
     updateConfig: (config: Record<string, unknown>) => void;
     /**
@@ -46,6 +52,8 @@ export interface ReactiveWidgetContext {
     dashboard?: () => WidgetDashboard;
     /** Who is looking. Absent on hosts that predate this field. */
     viewer?: () => WidgetViewer;
+    /** The material the home wears. Absent on hosts that predate this field. */
+    material?: () => WidgetMaterial;
     /** True when the household turned on Developer Mode; widget dialogs show Debug only then. */
     developer?: () => boolean;
     /** The tile's box on the page, so a held tile's sheet opens beside it. Absent: it opens centred. */

package/dist/framework/index.d.ts

@@ -36,7 +36,7 @@ export { WidgetSliderFill } from "./backgrounds/WidgetSliderFill";
 export { type PanelFact, PanelFacts, PanelRow, type PanelRowProps, PanelRows, PanelSection, type PanelSlide, } from "./panel/panel";
 export { isPanelControllable, PanelEntityRow } from "./panel/panel-entity";
 export { buildDebugData, WidgetDebugTab, type WidgetDebugData, type WidgetDebugEntity, WidgetDebugView, WidgetDialog, type SheetTile, type WidgetDialogProps, type WidgetDialogTab, } from "./dialogs";
-export { type AggregationPreset, type ReactiveWidgetContext, type ServiceCallFn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, type Daylight, type DaylightPhase, useDaylight, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDashboard, useWidgetViewer, useWidgetDialog, useWidgetDimensions, useWidgetEntityGroup, WidgetCtx, type WidgetDashboard, type WidgetViewer, type WidgetDialogReturn, type WidgetDimensions, type WidgetDimensionsAccessor, WidgetSizeCtx, } from "./hooks";
+export { type AggregationPreset, type ReactiveWidgetContext, type ServiceCallFn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, type Daylight, type DaylightPhase, useDaylight, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDashboard, useMaterial, useWidgetViewer, useWidgetDialog, useWidgetDimensions, useWidgetEntityGroup, WidgetCtx, type WidgetDashboard, type WidgetMaterial, type WidgetViewer, type WidgetDialogReturn, type WidgetDimensions, type WidgetDimensionsAccessor, WidgetSizeCtx, } from "./hooks";
 export { type GestureHandlers, useWidgetGestures } from "./gestures/use-widget-gestures";
 export { injectTokens, type SvgColorKey, svgColors, type Tone, ToneSchema } from "./theming";
 export { widgetFields } from "./fields";