@glasshome/widget-sdk 1.17.1 → 1.18.1

package/dist/deprecations.js

@@ -87,6 +87,13 @@ var e = "https://glasshome.app/docs/widget-sdk/config", t = [
 		replacement: "the Widget's tone or color; the fill follows the card",
 		docsUrl: "https://glasshome.app/docs/widget-sdk/widget",
 		sourcePattern: "<WidgetSliderFill[^>]*\\scolor="
+	},
+	{
+		id: "WidgetVariantConfig.layout",
+		since: "1.18.0",
+		removeIn: "2.0.0",
+		replacement: "WidgetVariantConfig.styles (container, class, cssVars)",
+		docsUrl: "https://glasshome.app/docs/widgets/widget-sdk#variants"
 	}
 ];
 function n(e) {

package/dist/framework/components/anatomy.d.ts

@@ -52,7 +52,7 @@ export declare function WidgetAction(props: {
     /** Visible label; without one the action is a square icon control named by `aria-label`. */
     children?: JSX.Element;
     "aria-label"?: string;
-    run: () => Promise<unknown> | unknown;
+    run: () => unknown;
     confirm?: Confirm;
     /** Key within a shared `confirm`; defaults to the label or icon. */
     id?: string;

package/dist/framework/design-system/z-index.d.ts

@@ -20,4 +20,3 @@ export declare const WIDGET_Z: {
     /** Action layer (buttons, edit controls) */
     readonly ACTIONS: 30;
 };
-export type WidgetZIndex = (typeof WIDGET_Z)[keyof typeof WIDGET_Z];

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

@@ -29,7 +29,7 @@ export interface GestureHandlers {
     /** Keyboard door: Enter or Space taps, the context-menu key or Shift+F10 holds. */
     onKeyDown?: (e: KeyboardEvent) => void;
 }
-export interface HoldFlood {
+interface HoldFlood {
     x: number;
     y: number;
     /** Radius that reaches the farthest corner, so the fill ends as the hold fires. */

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

@@ -4,7 +4,7 @@ export interface Confirm {
     /** Whether anything ran a moment ago. */
     any: () => boolean;
     /** Runs the action; resolves whether it succeeded. */
-    run: (keys: string[], action: () => Promise<unknown> | unknown) => Promise<boolean>;
+    run: (keys: string[], action: () => unknown) => Promise<boolean>;
 }
 /**
  * For actions that leave no state to show (a scene, a button press, a stop): the keys that just ran,

package/dist/framework/index.d.ts

@@ -38,9 +38,9 @@ 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 GestureHandlers, useWidgetGestures } from "./gestures/use-widget-gestures";
-export { injectTokens, type SvgColorKey, svgColors, type Tone, ToneSchema, } from "./theming";
+export { injectTokens, type SvgColorKey, svgColors, type Tone, ToneSchema } from "./theming";
 export { widgetFields } from "./fields";
 export { type ConfigShape, defineConfig, field, type Field, type ImagePresetSource, type Infer, } from "./config";
 export { imageSrc } from "./image-src";
 export { calculateLightGroup, calculateSensorGroup, type CopyState, copyText, countActiveEntities, getEntityAttribute, isEntityActive, type LightGroupResult, type SensorGroupResult, type SensorGroupType, useCopyText, } from "./utils";
-export type { EntityView, WidgetStyles, WidgetVariantConfig, } from "./types";
+export type { EntityView, WidgetStyles, WidgetVariantConfig } from "./types";

package/dist/framework/types.d.ts

@@ -1,7 +1,7 @@
 /** Core type definitions for the Widget Framework. */
 import type { JSX } from "solid-js";
 /** Slide gesture configuration */
-export interface SlideGestureConfig {
+interface SlideGestureConfig {
     /** Current value */
     value: number;
     /** Value change handler */
@@ -18,7 +18,7 @@ export interface SlideGestureConfig {
 /**
  * Hold gesture configuration
  */
-export interface HoldGestureConfig {
+interface HoldGestureConfig {
     /** Action to perform on hold */
     action: () => void;
     /** Hold delay in ms (default: 300) */
@@ -35,21 +35,15 @@ export interface GestureConfig {
     /** Slide gesture configuration */
     slide?: SlideGestureConfig;
 }
-/**
- * CSS variable-based styling configuration
- */
+/** Look applied to the widget shell: inline style, utility classes and CSS custom properties. */
 export interface WidgetStyles {
-    /** Inline CSS properties applied to widget container */
     container?: JSX.CSSProperties;
-    /** Tailwind utility classes (for simple styling) */
     class?: string;
-    /** CSS custom properties for themeable values */
     cssVars?: Record<`--widget-${string}` | `--glass-${string}`, string | number>;
 }
-/**
- * Flex layout strategy with type-safe configuration
- */
-export interface FlexLayoutStrategy {
+type WidgetElement = "icon" | "title" | "subtitle" | "status" | "value" | "metrics" | "content" | "background" | "overlay" | "decorations";
+/** @deprecated Never read by the shell. Removed in 2.0.0. */
+type LayoutStrategy = {
     type: "flex";
     direction: "row" | "column" | "row-reverse" | "column-reverse";
     align: "start" | "center" | "end" | "stretch";
@@ -57,106 +51,69 @@ export interface FlexLayoutStrategy {
     wrap?: boolean;
     gap?: string;
     order?: Partial<Record<WidgetElement, number>>;
-}
-/**
- * Grid layout strategy with type-safe configuration
- */
-export interface GridLayoutStrategy {
+} | {
     type: "grid";
     areas: string;
     columns?: string;
     rows?: string;
     gap?: string;
     elementAreas: Partial<Record<WidgetElement, string>>;
-}
-/**
- * Absolute positioning strategy with type-safe configuration
- */
-export interface AbsoluteLayoutStrategy {
+} | {
     type: "absolute";
-    positions: Partial<Record<WidgetElement, PositionConfig>>;
-}
-/**
- * Custom layout strategy (escape hatch)
- */
-export interface CustomLayoutStrategy {
+    positions: Partial<Record<WidgetElement, {
+        top?: string;
+        right?: string;
+        bottom?: string;
+        left?: string;
+        transform?: string;
+    }>>;
+} | {
     type: "custom";
     renderer: string;
-}
-/**
- * Discriminated union of all layout strategies
- */
-export type LayoutStrategy = FlexLayoutStrategy | GridLayoutStrategy | AbsoluteLayoutStrategy | CustomLayoutStrategy;
-/**
- * Position configuration for absolute layout
- */
-export interface PositionConfig {
-    top?: string;
-    right?: string;
-    bottom?: string;
-    left?: string;
-    transform?: string;
-}
-/**
- * Widget element identifiers for layout configuration
- */
-export type WidgetElement = "icon" | "title" | "subtitle" | "status" | "value" | "metrics" | "content" | "background" | "overlay" | "decorations";
-/**
- * Element-specific configuration
- */
-export interface ElementConfig {
-    visible?: Partial<Record<WidgetElement, boolean>>;
-    styles?: Partial<Record<WidgetElement, JSX.CSSProperties>>;
-    classNames?: Partial<Record<WidgetElement, string>>;
-}
-/**
- * Plugin system configuration (serializable)
- */
-export interface VariantPlugins {
-    background?: string;
-    overlay?: string;
-    decorations?: string[];
-}
-/**
- * Interaction configuration
- */
-export interface InteractionConfig {
-    hover?: boolean;
-    active?: boolean;
-    focus?: boolean;
-    hoverScale?: number;
-    activeScale?: number;
-}
-/**
- * Complete variant configuration
- */
+};
+/** A custom shell look; only `styles` is applied. */
 export interface WidgetVariantConfig {
     id: string;
     name: string;
     description?: string;
     styles?: WidgetStyles;
+    /** @deprecated Never read by the shell. Removed in 2.0.0. */
     layout?: LayoutStrategy;
-    elements?: ElementConfig;
-    plugins?: VariantPlugins;
-    interactions?: InteractionConfig;
+    /** @deprecated Never read by the shell. Removed in 2.0.0. */
+    elements?: {
+        visible?: Partial<Record<WidgetElement, boolean>>;
+        styles?: Partial<Record<WidgetElement, JSX.CSSProperties>>;
+        classNames?: Partial<Record<WidgetElement, string>>;
+    };
+    /** @deprecated Never read by the shell. Removed in 2.0.0. */
+    plugins?: {
+        background?: string;
+        overlay?: string;
+        decorations?: string[];
+    };
+    /** @deprecated Never read by the shell. Removed in 2.0.0. */
+    interactions?: {
+        hover?: boolean;
+        active?: boolean;
+        focus?: boolean;
+        hoverScale?: number;
+        activeScale?: number;
+    };
+    /** @deprecated Never read by the shell. Removed in 2.0.0. */
     extends?: string;
 }
-/**
- * Variant registry type
- */
-export type VariantRegistry = Record<string, WidgetVariantConfig>;
 /** Unique entity identifier (e.g., "light.living_room") */
-export type EntityId = string;
+type EntityId = string;
 /** Entity domain (e.g., "light", "sensor", "switch") */
-export type EntityDomain = string;
+type EntityDomain = string;
 /** Area identifier */
-export type AreaId = string;
+type AreaId = string;
 /** Device identifier */
-export type DeviceId = string;
+type DeviceId = string;
 /** Label identifier */
-export type LabelId = string;
+type LabelId = string;
 /** Entity category for filtering */
-export type EntityCategory = "config" | "diagnostic" | null;
+type EntityCategory = "config" | "diagnostic" | null;
 /**
  * Full entity view interface representing a Home Assistant entity.
  * This is the canonical type used by SDK framework utils and widgets.
@@ -219,3 +176,4 @@ export interface EntityView {
     /** Bitmask of supported features */
     supportedFeatures?: number;
 }
+export {};

package/dist/framework/utils/empty-state.d.ts

@@ -1,49 +1,6 @@
-/**
- * Empty State Utilities
- *
- * Helper functions for creating consistent empty state configurations across widgets.
- */
 import type { JSX } from "solid-js";
-/**
- * Empty state configuration for a widget
- */
 export interface WidgetEmptyStateConfig {
-    /** Icon to display */
     icon: JSX.Element;
-    /** Main title/heading */
     title: string;
-    /** Descriptive message */
     message: string;
 }
-export interface EmptyStateConfigOptions {
-    /** Icon to display */
-    icon: JSX.Element;
-    /** Main title/heading */
-    title: string;
-    /** Descriptive message (optional - uses default template if not provided) */
-    message?: string;
-    /** Entity type for default message template (e.g., "a light", "a lock") */
-    entityType?: string;
-}
-/**
- * Creates a consistent empty state configuration for widgets
- *
- * @example
- * ```typescript
- * // Custom message
- * const config = createEmptyStateConfig({
- *   icon: <Thermometer />,
- *   title: "No climate entity",
- *   message: "Configure this widget to add a climate device",
- * });
- *
- * // Default message template
- * const config = createEmptyStateConfig({
- *   icon: <Lock />,
- *   title: "No lock entity",
- *   entityType: "a lock",
- * });
- * // Result: message = "Configure this widget to add a lock"
- * ```
- */
-export declare function createEmptyStateConfig(options: EmptyStateConfigOptions): WidgetEmptyStateConfig;

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

@@ -5,9 +5,8 @@
  * in this directory are still consumed internally even when not part of the
  * public re-export surface.
  */
-export { cn } from "./cn";
 export { copyText, type CopyState, useCopyText } from "./clipboard";
 export { calculateLightGroup, calculateSensorGroup, type LightGroupResult, type SensorGroupResult, type SensorGroupType, } from "./entity-aggregation";
-export { countActiveEntities, getEntityAttribute, isEntityActive, } from "./entity-state";
+export { countActiveEntities, getEntityAttribute, isEntityActive } from "./entity-state";
 export { formatValue } from "./format-value";
 export { interpretValue } from "./interpret-value";

package/dist/framework/variants/built-in-variants.d.ts

@@ -1,39 +1,2 @@
-/**
- * Built-in Widget Variants
- *
- * Simplified set of pre-built variant definitions that ship with the framework.
- * These variants can be used as-is or extended/composed.
- *
- * Includes 3 core variants (classic-glass, minimal, compact-horizontal).
- * Additional variants can be added later or created by widget authors
- * using the variant composition utilities.
- */
-import type { VariantRegistry, WidgetVariantConfig } from "../types";
-export declare const classicGlass: WidgetVariantConfig;
-export declare const minimal: WidgetVariantConfig;
-export declare const compactHorizontal: WidgetVariantConfig;
-/**
- * Built-in variant registry
- * Maps variant IDs to their configurations
- */
-export declare const builtInVariants: VariantRegistry;
-/**
- * Get a variant by ID from the built-in registry
- *
- * @param id Variant ID
- * @returns Variant configuration or undefined if not found
- */
-export declare function getBuiltInVariant(id: string): WidgetVariantConfig | undefined;
-/**
- * Check if a variant ID is a built-in variant
- *
- * @param id Variant ID to check
- * @returns True if the variant is built-in
- */
-export declare function isBuiltInVariant(id: string): boolean;
-/**
- * Get all built-in variant IDs
- *
- * @returns Array of built-in variant IDs
- */
-export declare function getBuiltInVariantIds(): string[];
+import type { WidgetStyles } from "../types";
+export declare function getBuiltInVariantStyles(id: string): WidgetStyles | undefined;