@glasshome/widget-sdk 0.4.0 → 0.4.2

package/dist/framework/core/Widget.d.ts

@@ -22,11 +22,8 @@
 import { type JSX } from "solid-js";
 import type { WidgetSliderFill as WidgetSliderFillType } from "../backgrounds/WidgetSliderFill";
 import type { WidgetContent as WidgetContentType } from "../components/WidgetContent";
-import type { WidgetEmptyState as WidgetEmptyStateType } from "../components/WidgetEmptyState";
 import type { WidgetIcon as WidgetIconType } from "../components/WidgetIcon";
-import type { WidgetMetrics as WidgetMetricsType } from "../components/WidgetMetrics";
 import type { WidgetStatus as WidgetStatusType } from "../components/WidgetStatus";
-import type { WidgetSubtitle as WidgetSubtitleType } from "../components/WidgetSubtitle";
 import type { WidgetTitle as WidgetTitleType } from "../components/WidgetTitle";
 import type { WidgetValue as WidgetValueType } from "../components/WidgetValue";
 import type { GestureHandlers } from "../gestures/use-widget-gestures";
@@ -89,11 +86,8 @@ interface WidgetComponent {
     Content: typeof WidgetContentType;
     Icon: typeof WidgetIconType;
     Title: typeof WidgetTitleType;
-    Subtitle: typeof WidgetSubtitleType;
     Status: typeof WidgetStatusType;
     Value: typeof WidgetValueType;
-    Metrics: typeof WidgetMetricsType;
-    EmptyState: typeof WidgetEmptyStateType;
     SliderFill: typeof WidgetSliderFillType;
 }
 export declare const Widget: WidgetComponent;

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

@@ -1,14 +1,8 @@
 /**
  * Framework Hooks - Barrel Export
  *
- * All hooks for widget development: context, responsive, dialog, form,
- * config, entity, entity group, debug data, and gestures.
+ * Hooks for widget development: context, dialog, entity group.
  */
-export { type UseDebugDataOptions, useDebugData } from "./use-debug-data";
-export { type UseWidgetConfigOptions, type UseWidgetConfigReturn, useWidgetConfig, } from "./use-widget-config";
-export { type BridgeableWidgetContext, type BridgeFns, type ReactiveWidgetContext, useWidgetContext, warnIfStub, WidgetCtx, } from "./use-widget-context";
+export { type BridgeableWidgetContext, type BridgeFns, type ReactiveWidgetContext, useWidgetContext, WidgetCtx, } from "./use-widget-context";
 export { useWidgetDialog, type WidgetDialogReturn } from "./use-widget-dialog";
-export { type UseWidgetEntityOptions, type UseWidgetEntityResult, useWidgetEntity, } from "./use-widget-entity";
 export { type AggregationPreset, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useWidgetEntityGroup, } from "./use-widget-entity-group";
-export { type UseWidgetFormOptions, type UseWidgetFormReturn, useWidgetForm, } from "./use-widget-form";
-export { useWidgetResponsive, type WidgetResponsiveUtils } from "./use-widget-responsive";

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

@@ -57,11 +57,6 @@ export interface BridgeableWidgetContext extends ReactiveWidgetContext {
     /** Setter functions called by Widget.tsx createEffect to push real values */
     _bridge: BridgeFns;
 }
-/**
- * Emit a one-time dev-mode console.warn when stub context values are read
- * before Widget has mounted and bridged real measured values.
- */
-export declare function warnIfStub(isStub: () => boolean): void;
 /**
  * Widget context
  * Uses reactive accessor pattern for SolidJS

package/dist/framework/index.d.ts

@@ -10,8 +10,6 @@
  *   Widget,
  *   useWidgetGestures,
  *   useWidgetDialog,
- *   spacing,
- *   cn,
  * } from "@glasshome/widget-sdk";
  *
  * export function MyWidget(props) {
@@ -33,25 +31,15 @@
  */
 export { Widget } from "./core/Widget";
 export { WidgetContent } from "./components/WidgetContent";
-export { WidgetEmptyState } from "./components/WidgetEmptyState";
 export { WidgetIcon } from "./components/WidgetIcon";
-export { WidgetMetrics } from "./components/WidgetMetrics";
 export { WidgetStatus } from "./components/WidgetStatus";
-export { WidgetSubtitle } from "./components/WidgetSubtitle";
 export { WidgetTitle } from "./components/WidgetTitle";
 export { WidgetValue } from "./components/WidgetValue";
-export { Glow } from "./backgrounds/Glow";
 export { WidgetSliderFill } from "./backgrounds/WidgetSliderFill";
-export { WidgetStack } from "./layout/WidgetStack";
 export { WidgetDialog, type WidgetDialogProps, type WidgetDialogTab } from "./dialogs";
-export { type AggregationPreset, type BridgeableWidgetContext, type BridgeFns, type ReactiveWidgetContext, type UseDebugDataOptions, type UseWidgetConfigOptions, type UseWidgetConfigReturn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, type UseWidgetEntityOptions, type UseWidgetEntityResult, type UseWidgetFormOptions, type UseWidgetFormReturn, useDebugData, useWidgetConfig, useWidgetContext, useWidgetDialog, useWidgetEntity, useWidgetEntityGroup, useWidgetForm, useWidgetResponsive, warnIfStub, WidgetCtx, type WidgetDialogReturn, type WidgetResponsiveUtils, } from "./hooks";
+export { type AggregationPreset, type BridgeableWidgetContext, type BridgeFns, type ReactiveWidgetContext, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useWidgetContext, useWidgetDialog, useWidgetEntityGroup, WidgetCtx, type WidgetDialogReturn, } from "./hooks";
 export { type GestureHandlers, useWidgetGestures } from "./gestures/use-widget-gestures";
-export { getSpacingClass, spacing } from "./design-system/spacing";
-export { typography } from "./design-system/typography";
-export { WIDGET_Z, type WidgetZIndex } from "./design-system/z-index";
-export { GRADIENT_NAMES, GRADIENT_PRESET_KEYS, GRADIENT_PRESETS, type GradientPreset, getGradient, getGradientFromString, gradientColorPresets, injectTokens, stateColors, type Tone, ToneSchema, type WidgetColorPreset, } from "./theming";
-export { applyCssVars, applyLayout, builtInVariants, classicGlass, compactHorizontal, composeVariants, createFlexLayout, extendVariant, getBuiltInVariant, getBuiltInVariantIds, isBuiltInVariant, mergeVariants, minimal, } from "./variants";
+export { injectTokens, type Tone, ToneSchema, } from "./theming";
 export { widgetFields } from "./fields";
-export { extractDefaults, toFormSchema } from "./to-form-schema";
-export { allEntitiesInState, anyEntityInState, calculateLightGroup, calculateSensorGroup, cn, countActiveEntities, countAvailableEntities, countEntitiesByState, createEmptyStateConfig, type EmptyStateConfigOptions, formatValue, getEntityAttribute, getEntityState, interpretValue, isEntityActive, isEntityAvailable, type LightGroupResult, type SensorGroupResult, type SensorGroupType, type WidgetEmptyStateConfig, } from "./utils";
-export type { AbsoluteLayoutStrategy, BaseComponentProps, CustomLayoutStrategy, ElementConfig, EntityView, FlexLayoutStrategy, GestureConfig, GradientConfig, GridLayoutStrategy, HoldGestureConfig, ImageOverlay, InteractionConfig, LayoutStrategy, PositionConfig, SlideGestureConfig, SpacingScale, VariantPlugins, VariantRegistry, WidgetContextValue, WidgetDimensions, WidgetElement, WidgetOrientation, WidgetSize, WidgetStyles, WidgetVariant, WidgetVariantConfig, } from "./types";
+export { calculateLightGroup, calculateSensorGroup, countActiveEntities, getEntityAttribute, isEntityActive, type LightGroupResult, type SensorGroupResult, type SensorGroupType, } from "./utils";
+export type { EntityView, WidgetContextValue, WidgetDimensions, WidgetOrientation, WidgetSize, WidgetStyles, WidgetVariantConfig, } from "./types";

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

@@ -1,9 +1,7 @@
 /**
- * Widget Theming - Shared Colors
+ * Widget Theming
  *
- * Simple color palette for entity states.
- * Widgets can use these or define their own logic.
+ * Tone schema and token injection.
  */
-export { GRADIENT_NAMES, GRADIENT_PRESET_KEYS, GRADIENT_PRESETS, type GradientPreset, getGradient, getGradientFromString, gradientColorPresets, stateColors, type WidgetColorPreset, } from "./colors";
 export { ToneSchema, type Tone } from "./tone";
 export { injectTokens } from "./tokens";

package/dist/framework/types.d.ts

@@ -46,15 +46,6 @@ export interface WidgetContextValue {
     /** Whether widget is in edit mode */
     isEditMode: boolean;
 }
-/**
- * Gradient configuration
- */
-export interface GradientConfig {
-    /** Tailwind gradient from class (e.g., "from-blue-500") */
-    from: string;
-    /** Tailwind gradient to class (e.g., "to-blue-700") */
-    to: string;
-}
 /**
  * Slide gesture configuration
  */
@@ -96,22 +87,8 @@ export interface GestureConfig {
  * Spacing scale
  */
 export type SpacingScale = "S1" | "S2" | "S3" | "S4";
-/**
- * Image overlay types
- */
-export type ImageOverlay = "gradient" | "dark" | "none";
-/**
- * Base props that all framework components accept
- */
-export interface BaseComponentProps {
-    /** Additional CSS classes (SolidJS uses `class` instead of `className`) */
-    class?: string;
-    /** Child elements */
-    children?: JSX.Element;
-}
 /**
  * CSS variable-based styling configuration
- * Replaces brittle Tailwind class strings with type-safe CSS variables
  */
 export interface WidgetStyles {
     /** Inline CSS properties applied to widget container */
@@ -126,17 +103,11 @@ export interface WidgetStyles {
  */
 export interface FlexLayoutStrategy {
     type: "flex";
-    /** Flex direction */
     direction: "row" | "column" | "row-reverse" | "column-reverse";
-    /** Align items */
     align: "start" | "center" | "end" | "stretch";
-    /** Justify content */
     justify: "start" | "center" | "end" | "between" | "around";
-    /** Flex wrap */
     wrap?: boolean;
-    /** Gap between items (CSS value) */
     gap?: string;
-    /** Custom order for specific elements */
     order?: Partial<Record<WidgetElement, number>>;
 }
 /**
@@ -144,15 +115,10 @@ export interface FlexLayoutStrategy {
  */
 export interface GridLayoutStrategy {
     type: "grid";
-    /** Grid template areas string */
     areas: string;
-    /** Grid template columns */
     columns?: string;
-    /** Grid template rows */
     rows?: string;
-    /** Gap between items (CSS value) */
     gap?: string;
-    /** Grid area assignments for elements */
     elementAreas: Partial<Record<WidgetElement, string>>;
 }
 /**
@@ -160,7 +126,6 @@ export interface GridLayoutStrategy {
  */
 export interface AbsoluteLayoutStrategy {
     type: "absolute";
-    /** Position configurations for specific elements */
     positions: Partial<Record<WidgetElement, PositionConfig>>;
 }
 /**
@@ -168,12 +133,10 @@ export interface AbsoluteLayoutStrategy {
  */
 export interface CustomLayoutStrategy {
     type: "custom";
-    /** Custom render function or component */
     renderer: string;
 }
 /**
  * Discriminated union of all layout strategies
- * Ensures type safety - can't use gridArea with flex, etc.
  */
 export type LayoutStrategy = FlexLayoutStrategy | GridLayoutStrategy | AbsoluteLayoutStrategy | CustomLayoutStrategy;
 /**
@@ -194,68 +157,42 @@ export type WidgetElement = "icon" | "title" | "subtitle" | "status" | "value" |
  * Element-specific configuration
  */
 export interface ElementConfig {
-    /** Show/hide specific elements */
     visible?: Partial<Record<WidgetElement, boolean>>;
-    /** Element-specific styling */
     styles?: Partial<Record<WidgetElement, JSX.CSSProperties>>;
-    /** Element-specific CSS classes */
     classNames?: Partial<Record<WidgetElement, string>>;
 }
 /**
  * Plugin system configuration (serializable)
- * Uses string IDs instead of JSX.Element for serializability
  */
 export interface VariantPlugins {
-    /** Background plugin ID */
     background?: string;
-    /** Overlay plugin ID */
     overlay?: string;
-    /** Decoration plugin IDs */
     decorations?: string[];
 }
 /**
  * Interaction configuration
  */
 export interface InteractionConfig {
-    /** Enable hover effects */
     hover?: boolean;
-    /** Enable active/pressed state */
     active?: boolean;
-    /** Enable focus ring */
     focus?: boolean;
-    /** Custom hover scale (e.g., 1.02) */
     hoverScale?: number;
-    /** Custom active scale (e.g., 0.98) */
     activeScale?: number;
 }
 /**
  * Complete variant configuration
- * This is the core of the variant system
  */
 export interface WidgetVariantConfig {
-    /** Unique variant identifier */
     id: string;
-    /** Human-readable name */
     name: string;
-    /** Description of variant purpose/style */
     description?: string;
-    /** Styling configuration */
     styles?: WidgetStyles;
-    /** Layout strategy */
     layout?: LayoutStrategy;
-    /** Element-specific configuration */
     elements?: ElementConfig;
-    /** Plugin configurations */
     plugins?: VariantPlugins;
-    /** Interaction behavior */
     interactions?: InteractionConfig;
-    /** Base variant to extend (enables composition) */
     extends?: string;
 }
-/**
- * Variant type union (built-in + custom)
- */
-export type WidgetVariant = "classic-glass" | "minimal" | "compact-horizontal" | (string & {});
 /**
  * Variant registry type
  */
@@ -284,8 +221,13 @@ export interface EntityView {
     domain: EntityDomain;
     /** Current state value */
     state: string;
-    /** Entity attributes */
-    attributes: Record<string, any>;
+    /**
+     * Entity attributes from Home Assistant, excluding keys that are
+     * surfaced as canonical resolved fields elsewhere on EntityView
+     * (`deviceClass`, `unitOfMeasurement`, `friendlyName`, `icon`).
+     * Use those fields instead of reaching into `attributes`.
+     */
+    attributes: Omit<Record<string, any>, "device_class" | "unit_of_measurement" | "friendly_name" | "icon">;
     /** When the state last changed */
     lastChanged: Date;
     /** When the state was last updated (even if unchanged) */

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

@@ -8,18 +8,6 @@
  * (calculateLightGroup, calculateSensorGroup).
  */
 import type { EntityView } from "../types";
-/**
- * Check if entity is available (not unavailable/unknown)
- *
- * @example
- * ```typescript
- * const isAvailable = isEntityAvailable(entity);
- * if (isAvailable) {
- *   // Entity is available, can display state
- * }
- * ```
- */
-export declare function isEntityAvailable(entity: EntityView | null | undefined): boolean;
 /**
  * Check if entity is active (on, open, locked, etc.)
  * Domain-aware state checking
@@ -31,16 +19,6 @@ export declare function isEntityAvailable(entity: EntityView | null | undefined)
  * ```
  */
 export declare function isEntityActive(entity: EntityView | null | undefined): boolean;
-/**
- * Get entity state with fallback
- *
- * @example
- * ```typescript
- * const state = getEntityState(entity, "unknown");
- * return <Widget.Status>{state}</Widget.Status>;
- * ```
- */
-export declare function getEntityState(entity: EntityView | null | undefined, fallback?: string): string;
 /**
  * Get entity attribute with type safety
  *
@@ -51,26 +29,6 @@ export declare function getEntityState(entity: EntityView | null | undefined, fa
  * ```
  */
 export declare function getEntityAttribute<T = unknown>(entity: EntityView | null | undefined, attributeName: string, fallback?: T): T | undefined;
-/**
- * Count entities by state
- *
- * @example
- * ```typescript
- * const onCount = countEntitiesByState(entities, "on");
- * return <Widget.Status>{onCount} lights on</Widget.Status>;
- * ```
- */
-export declare function countEntitiesByState(entities: EntityView[], state: string): number;
-/**
- * Count available entities (excludes unavailable/unknown)
- *
- * @example
- * ```typescript
- * const availableCount = countAvailableEntities(entities);
- * const unavailableCount = entities.length - availableCount;
- * ```
- */
-export declare function countAvailableEntities(entities: EntityView[]): number;
 /**
  * Count active entities (on, open, etc.)
  *
@@ -81,23 +39,3 @@ export declare function countAvailableEntities(entities: EntityView[]): number;
  * ```
  */
 export declare function countActiveEntities(entities: EntityView[]): number;
-/**
- * Check if all entities match state
- *
- * @example
- * ```typescript
- * const allOn = allEntitiesInState(entities, "on");
- * const statusText = allOn ? "All on" : "Mixed";
- * ```
- */
-export declare function allEntitiesInState(entities: EntityView[], state: string): boolean;
-/**
- * Check if any entity matches state
- *
- * @example
- * ```typescript
- * const anyOpen = anyEntityInState(entities, "open");
- * const iconColor = anyOpen ? "red" : "green";
- * ```
- */
-export declare function anyEntityInState(entities: EntityView[], state: string): boolean;

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

@@ -1,12 +1,12 @@
 /**
- * Framework Utilities - Barrel Export
+ * Framework Utilities - Barrel Export (internal)
  *
- * Helper functions for value formatting, entity state management,
- * and class name composition.
+ * Public exports are routed through src/framework/index.ts. Files that remain
+ * in this directory are still consumed internally even when not part of the
+ * public re-export surface.
  */
 export { cn } from "./cn";
-export { createEmptyStateConfig, type EmptyStateConfigOptions, type WidgetEmptyStateConfig, } from "./empty-state";
 export { calculateLightGroup, calculateSensorGroup, type LightGroupResult, type SensorGroupResult, type SensorGroupType, } from "./entity-aggregation";
-export { allEntitiesInState, anyEntityInState, countActiveEntities, countAvailableEntities, countEntitiesByState, getEntityAttribute, getEntityState, isEntityActive, isEntityAvailable, } from "./entity-state";
+export { countActiveEntities, getEntityAttribute, isEntityActive, } from "./entity-state";
 export { formatValue } from "./format-value";
 export { interpretValue } from "./interpret-value";

package/dist/index.d.ts

@@ -1,8 +1,6 @@
-export type { Entity } from "./create-entity";
-export { createEntity } from "./create-entity";
 export { defineWidget } from "./define-widget";
 export * from "./framework";
-export { formatSchemaError, GridSizeSchema, PublishBodySchema, PublishConfirmSchema, PublishRequestSchema, parseGridSize, serializeGridSize, WidgetManifestSchema, } from "./schemas";
-export { getThemeToken, isDark } from "./theme";
+export { formatSchemaError, WidgetManifestSchema } from "./schemas";
+export { isDark } from "./theme";
 export type { GridSize, WidgetContext, WidgetDefinition, WidgetManifest, } from "./types";
 export { SDK_VERSION } from "./version";