@glasshome/widget-sdk 1.15.0 → 1.16.0

package/dist/deprecations.js

@@ -71,6 +71,22 @@ var e = "https://glasshome.app/docs/widget-sdk/config", t = [
 		replacement: "defineConfig({ ... })",
 		docsUrl: e,
 		sourcePattern: "configSchema\\s*=\\s*z\\.object\\("
+	},
+	{
+		id: "widget.gradient",
+		since: "1.16.0",
+		removeIn: "2.0.0",
+		replacement: "<Widget color colorTo>",
+		docsUrl: "https://glasshome.app/docs/widget-sdk/widget",
+		sourcePattern: "<Widget[^>]*\\sgradient="
+	},
+	{
+		id: "sliderFill.color",
+		since: "1.16.0",
+		removeIn: "2.0.0",
+		replacement: "the Widget's tone or color; the fill follows the card",
+		docsUrl: "https://glasshome.app/docs/widget-sdk/widget",
+		sourcePattern: "<WidgetSliderFill[^>]*\\scolor="
 	}
 ];
 function n(e) {

package/dist/framework/backgrounds/WidgetSliderFill.d.ts

@@ -2,7 +2,7 @@ import type { JSX } from "solid-js";
 interface WidgetSliderFillProps {
     /** Current value (0-100) */
     value: number;
-    /** Per-fill channel override; sets --widget-icon-color inline. */
+    /** @deprecated Ignored: the fill wears the card's own tone. Removed in 2.0.0. */
     color?: string;
     /** Disables the fill transition while the user is dragging. */
     isDragging?: boolean;

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

@@ -31,7 +31,7 @@ interface WidgetProps {
     color?: string;
     /** Second-stop gradient color (`--widget-color-to`). */
     colorTo?: string;
-    /** Full CSS gradient string (`--widget-gradient`); overrides the auto-shell. */
+    /** @deprecated Use `color` + `colorTo`; a full gradient paints over the material. Removed in 2.0.0. */
     gradient?: string;
     loading?: boolean;
     class?: string;

package/dist/framework/dialogs/debug-view.d.ts

@@ -0,0 +1,27 @@
+import { type JSX } from "solid-js";
+import type { EntityView } from "../types";
+export interface WidgetDebugEntity {
+    entity_id: string;
+    state: string;
+    domain: string;
+    friendly_name?: string;
+    device_class: string | null;
+    area_id: string | null;
+    last_changed: string;
+    last_updated: string;
+    attributes: Record<string, unknown>;
+}
+export interface WidgetDebugData {
+    widgetConfig: Record<string, unknown>;
+    entities: WidgetDebugEntity[];
+    [key: string]: unknown;
+}
+export declare function buildDebugData(config: Record<string, unknown>, entities: EntityView[], extra?: Record<string, unknown>): WidgetDebugData;
+export declare function WidgetDebugView(props: {
+    data: WidgetDebugData;
+}): JSX.Element;
+/** The debug tab a widget gets for free: the shaped view when its data came
+ *  from buildDebugData, the raw payload otherwise. */
+export declare function WidgetDebugTab(props: {
+    data?: string | Record<string, unknown>;
+}): JSX.Element;

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

@@ -1,4 +1,5 @@
 /**
  * Dialog Components - Barrel Export
  */
+export { buildDebugData, WidgetDebugTab, WidgetDebugView, type WidgetDebugData, type WidgetDebugEntity, } from "./debug-view";
 export { WidgetDialog, type WidgetDialogProps, type WidgetDialogTab } from "./WidgetDialog";

package/dist/framework/index.d.ts

@@ -36,11 +36,11 @@ export { WidgetStatus } from "./components/WidgetStatus";
 export { WidgetTitle } from "./components/WidgetTitle";
 export { WidgetValue } from "./components/WidgetValue";
 export { WidgetSliderFill } from "./backgrounds/WidgetSliderFill";
-export { WidgetDialog, type WidgetDialogProps, type WidgetDialogTab } from "./dialogs";
+export { buildDebugData, WidgetDebugTab, type WidgetDebugData, type WidgetDebugEntity, WidgetDebugView, WidgetDialog, type WidgetDialogProps, type WidgetDialogTab, } from "./dialogs";
 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";
 export { type ConfigShape, defineConfig, field, type Field, type Infer, } from "./config";
-export { calculateLightGroup, calculateSensorGroup, countActiveEntities, getEntityAttribute, isEntityActive, type LightGroupResult, type SensorGroupResult, type SensorGroupType, } from "./utils";
+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";

package/dist/framework/types.d.ts

@@ -44,7 +44,7 @@ export interface WidgetStyles {
     /** Tailwind utility classes (for simple styling) */
     class?: string;
     /** CSS custom properties for themeable values */
-    cssVars?: Record<`--widget-${string}`, string | number>;
+    cssVars?: Record<`--widget-${string}` | `--glass-${string}`, string | number>;
 }
 /**
  * Flex layout strategy with type-safe configuration

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

@@ -0,0 +1,9 @@
+export type CopyState = "idle" | "copied" | "failed";
+/** Dashboards are reached over plain http on the LAN, where navigator.clipboard
+ *  does not exist; the selection path is the only copy those installs have. */
+export declare function copyText(text: string): Promise<boolean>;
+/** Copy plus the state a control needs to say what happened. */
+export declare function useCopyText(resetAfterMs?: number): {
+    state: import("solid-js").Accessor<CopyState>;
+    copy: (text: string) => Promise<void>;
+};

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

@@ -6,6 +6,7 @@
  * 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 { formatValue } from "./format-value";

package/dist/framework/variants/variant-utils.d.ts

@@ -16,7 +16,7 @@ import type { FlexLayoutStrategy, LayoutStrategy, WidgetVariantConfig } from "..
  * const customVariant = mergeVariants(classicGlass, {
  *   styles: {
  *     cssVars: {
- *       "--widget-bg": "rgba(0, 0, 0, 0.5)"
+ *       "--glass-base": "oklch(0.2 0 0 / 0.5)"
  *     }
  *   }
  * });
@@ -36,7 +36,7 @@ export declare function mergeVariants(base: WidgetVariantConfig, override: Parti
  *   name: "Dark Glass",
  *   styles: {
  *     cssVars: {
- *       "--widget-bg": "rgba(0, 0, 0, 0.5)"
+ *       "--glass-base": "oklch(0.2 0 0 / 0.5)"
  *     }
  *   }
  * });
@@ -86,12 +86,12 @@ export declare function applyLayout(variant: WidgetVariantConfig, layout: Layout
  * @example
  * ```tsx
  * const blueTinted = applyCssVars(classicGlass, {
- *   "--widget-bg": "rgba(59, 130, 246, 0.2)",
- *   "--widget-border": "rgba(59, 130, 246, 0.3)"
+ *   "--glass-tone": "oklch(0.62 0.2 260)",
+ *   "--glass-wash": "30%"
  * });
  * ```
  */
-export declare function applyCssVars(variant: WidgetVariantConfig, cssVars: Record<`--widget-${string}`, string | number>): WidgetVariantConfig;
+export declare function applyCssVars(variant: WidgetVariantConfig, cssVars: Record<`--widget-${string}` | `--glass-${string}`, string | number>): WidgetVariantConfig;
 /**
  * Create a flex layout strategy
  *