@glasshome/widget-sdk 1.17.0 → 1.18.0

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/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,7 +5,6 @@
  * 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";

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;