@glasshome/widget-sdk 1.14.2 → 1.15.0

package/dist/deprecations.js

@@ -56,6 +56,14 @@ var e = "https://glasshome.app/docs/widget-sdk/config", t = [
 		docsUrl: "https://glasshome.app/docs/widget-styling#importing-ui-components",
 		sourcePattern: "from\\s+[\"']@glasshome/ui(/[^\"']*)?[\"']"
 	},
+	{
+		id: "iconify-icon",
+		since: "1.15.0",
+		removeIn: "2.0.0",
+		replacement: "<Icon icon=\"prefix:name\" /> from \"@glasshome/widget-sdk\"",
+		docsUrl: e,
+		sourcePattern: "(?:from|import)\\s+[\"']@?iconify-icon(/solid)?[\"']"
+	},
 	{
 		id: "raw-zod-config",
 		since: "1.4.0",

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

@@ -44,6 +44,8 @@ type ChoiceOpts<T extends string> = {
     title: string;
     description?: string;
     default?: T;
+    /** Display names for the options; the raw value shows without them. */
+    labels?: Partial<Record<T, string>>;
 };
 type EntitiesOpts = {
     title?: string;
@@ -68,6 +70,15 @@ declare function choice<const T extends string>(values: readonly T[], o: ChoiceO
 declare function choice<const T extends string>(values: readonly T[], o: ChoiceOpts<T>): z.ZodOptional<z.ZodEnum<{
     [K in T]: K;
 }>>;
+type ChoicesOpts<T extends string> = {
+    title: string;
+    description?: string;
+    default?: readonly T[];
+    labels?: Partial<Record<T, string>>;
+};
+declare function choices<const T extends string>(values: readonly T[], o: ChoicesOpts<T>): z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    [K in T]: K;
+}>>>;
 declare function entities(domain: string, o?: EntitiesOpts): z.ZodDefault<z.ZodArray<z.ZodString>>;
 declare function entity(domain: string, o?: EntitiesOpts): z.ZodDefault<z.ZodArray<z.ZodString>>;
 declare function area(o?: {
@@ -79,10 +90,12 @@ declare function area(o?: {
  */
 declare function icon(o: {
     title?: string;
+    description?: string;
     default: string;
 }): z.ZodDefault<z.ZodString>;
 declare function icon(o?: {
     title?: string;
+    description?: string;
 }): z.ZodOptional<z.ZodString>;
 /**
  * Image id (an opaque handle, not a URL). The host renders its picker and
@@ -141,6 +154,7 @@ export declare const field: {
     number: typeof number;
     toggle: typeof toggle;
     choice: typeof choice;
+    choices: typeof choices;
     entities: typeof entities;
     entity: typeof entity;
     area: typeof area;

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

@@ -3,7 +3,9 @@
  *
  * Hooks for widget development: context, dialog, entity group.
  */
-export { type ReactiveWidgetContext, type ServiceCallFn, useWidgetContext, WidgetCtx, type WidgetDimensions, } from "./use-widget-context";
+export { type ReactiveWidgetContext, type ServiceCallFn, useWidgetContext, WidgetCtx, type WidgetDashboard, type WidgetViewer, type WidgetDimensions, } from "./use-widget-context";
+export { useWidgetDashboard } from "./use-widget-dashboard";
+export { useWidgetViewer } from "./use-widget-viewer";
 export { useWidgetDimensions, type WidgetDimensionsAccessor, WidgetSizeCtx, } from "./use-widget-dimensions";
 export { useIntersectionPause } from "./use-intersection-pause";
 export { useReducedMotion } from "./use-reduced-motion";

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

@@ -11,6 +11,11 @@ export interface WidgetDimensions {
     width: number;
     height: number;
 }
+export interface WidgetDashboard {
+    name: string;
+    icon: string;
+    areaId: string | null;
+}
 /** Capability-routed service call: an RPC into the host's HA bridge worker,
     validated there against the widget's granted capabilities. Pass
     `{ returnResponse: true }` for services that return data (e.g.
@@ -19,6 +24,10 @@ export interface WidgetDimensions {
 export type ServiceCallFn = (domain: string, service: string, serviceData?: Record<string, unknown>, target?: Record<string, unknown>, options?: {
     returnResponse?: boolean;
 }) => Promise<unknown>;
+export interface WidgetViewer {
+    /** The signed-in person's name, or null for a paired screen. */
+    name: string | null;
+}
 export interface ReactiveWidgetContext {
     updateConfig: (config: Record<string, unknown>) => void;
     /**
@@ -33,6 +42,10 @@ 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;
+    /** 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. */
+    viewer?: () => WidgetViewer;
 }
 export declare const WidgetCtx: import("solid-js").Context<ReactiveWidgetContext | undefined>;
 export declare function useWidgetContext(): ReactiveWidgetContext;

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

@@ -0,0 +1,2 @@
+import { type WidgetDashboard } from "./use-widget-context";
+export declare function useWidgetDashboard(): () => WidgetDashboard;

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

@@ -0,0 +1,4 @@
+import { type WidgetViewer } from "./use-widget-context";
+/** Who is looking. A paired screen belongs to a room, not to a person, so it
+ *  reads as nobody and nothing greets it by name. */
+export declare function useWidgetViewer(): () => WidgetViewer;

package/dist/framework/index.d.ts

@@ -37,7 +37,7 @@ export { WidgetTitle } from "./components/WidgetTitle";
 export { WidgetValue } from "./components/WidgetValue";
 export { WidgetSliderFill } from "./backgrounds/WidgetSliderFill";
 export { WidgetDialog, type WidgetDialogProps, type WidgetDialogTab } from "./dialogs";
-export { type AggregationPreset, type ReactiveWidgetContext, type ServiceCallFn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDialog, useWidgetDimensions, useWidgetEntityGroup, WidgetCtx, type WidgetDialogReturn, type WidgetDimensions, type WidgetDimensionsAccessor, WidgetSizeCtx, } from "./hooks";
+export { type AggregationPreset, type ReactiveWidgetContext, type ServiceCallFn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDashboard, useWidgetViewer, useWidgetDialog, useWidgetDimensions, useWidgetEntityGroup, WidgetCtx, type WidgetDashboard, 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";