@glasshome/widget-sdk 1.20.0 → 1.21.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/components/anatomy.d.ts

@@ -24,7 +24,8 @@ export declare function WidgetHero(props: {
     art?: JSX.Element;
     class?: string;
 }): JSX.Element;
-/** The tile's control row: beside the value on a wide tile, under it on a narrow one, hidden on a short one. */
+/** The tile's control row: beside the value on a wide tile, under it on a narrow one, hidden on a short one.
+    A press here belongs to the row's controls; the widget only takes a hold from it. */
 export declare function WidgetControls(props: {
     children: JSX.Element;
 }): JSX.Element;

package/dist/framework/dialogs/WidgetDialog.d.ts

@@ -31,7 +31,7 @@ export interface WidgetDialogProps {
     controlsContent?: JSX.Element;
     /** What holding the tile opens: only what the tile cannot show (a group's members, colours, modes),
         as `PanelSection`s. It opens beside the tile, or from the bottom on a phone. A widget with nothing
-        the tile lacks passes none, and holding it opens nothing. */
+        the tile lacks passes none, and holding it says there is nothing more. */
     sheet?: () => JSX.Element;
     /** The tile's look, worn by its sheet so the tile reads as growing open: its icon in the head,
         its tone in the glass, its picture (a room, an album cover) as a band behind the head. */

package/dist/framework/gestures/use-widget-gestures.d.ts

@@ -7,6 +7,8 @@
  */
 import type { GestureConfig } from "../types";
 type GestureOrientation = "horizontal" | "vertical" | "square";
+/** A press that starts on a control inside a widget belongs to that control. */
+export declare const INTERACTIVE = "button, a, input, select, textarea, [role=\"slider\"], [role=\"radio\"], [role=\"switch\"]";
 export interface GestureHandlers {
     onPointerDown: (e: PointerEvent) => void;
     onPointerMove: (e: PointerEvent) => void;
@@ -26,7 +28,7 @@ export interface GestureHandlers {
     dispose: () => void;
     /** Where a hold is filling from, relative to the element; `fired` once it opened. */
     hold?: () => HoldFlood | null;
-    /** True while a hold does something. */
+    /** True while a hold opens something; the "nothing more here" answer does not count. */
     holds?: () => boolean;
     /** Keyboard door: Enter or Space taps, the context-menu key or Shift+F10 holds. */
     onKeyDown?: (e: KeyboardEvent) => void;

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/hooks/widget-registry.d.ts

@@ -1,5 +1,5 @@
 import { type Accessor, type Setter } from "solid-js";
-/** What a widget's parts tell each other: whether its dialog has a sheet, and the look the sheet wears. */
+/** What a widget's parts tell each other: whether its dialog has a sheet, the look the sheet wears, and a hold that found none. */
 export interface WidgetRegistry {
     hasSheet: Accessor<boolean>;
     setHasSheet: Setter<boolean>;
@@ -12,6 +12,9 @@ export interface WidgetRegistry {
     /** The head's icon. */
     icon: Accessor<string | undefined>;
     setIcon: Setter<string | undefined>;
+    /** A hold found no sheet: the shell says the widget has nothing more to show. */
+    nothingMore: Accessor<boolean>;
+    setNothingMore: Setter<boolean>;
 }
 /** `<Widget>` hands its parts a copy of the host context; this points the copy back at the original. */
 export declare const REGISTRY_KEY: unique symbol;

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";