@glasshome/widget-sdk 0.5.2 → 1.1.0

package/dist/data.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Home Assistant data and service hooks, re-exported from
+ * @glasshome/sync-layer. Widgets must import these from the SDK instead of
+ * sync-layer directly: the single store instance lives in the host (via the
+ * import map), and a direct import would bundle a second, disconnected
+ * store. Phase 4 routes these through capability checks.
+ */
+export { getForecasts, getStream, getWebRtcClientConfig, sendWebRtcCandidate, startWebRtcSession, state, trackEntityHistory, untrackEntityHistory, } from "@glasshome/sync-layer";
+export type { AreaView } from "@glasshome/sync-layer";
+export { byDomain, useArea, useCamera, useConnection, useCurrency, useEntities, useEntity, useEntityHistory, useEntityStatistics, useForecast, useHassConfig, useLocale, useStore, useTemperatureUnit, useUnitSystem, } from "@glasshome/sync-layer/solid";
+export { useService, useToggle, useTurnOff, useTurnOn } from "./framework/hooks/use-service";

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

@@ -3,7 +3,7 @@
  *
  * Hooks for widget development: context, dialog, entity group.
  */
-export { type ReactiveWidgetContext, useWidgetContext, WidgetCtx, } from "./use-widget-context";
+export { type ReactiveWidgetContext, type ServiceCallFn, useWidgetContext, WidgetCtx, } from "./use-widget-context";
 export { useIntersectionPause } from "./use-intersection-pause";
 export { useReducedMotion } from "./use-reduced-motion";
 export { useWidgetDialog, type WidgetDialogReturn } from "./use-widget-dialog";

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

@@ -0,0 +1,11 @@
+import { useToggle as useDirectToggle, useTurnOff as useDirectTurnOff, useTurnOn as useDirectTurnOn } from "@glasshome/sync-layer/solid";
+import { type ServiceCallFn } from "./use-widget-context";
+export declare function useService(): {
+    callService: ServiceCallFn;
+    turnOn: ReturnType<typeof useDirectTurnOn>;
+    turnOff: ReturnType<typeof useDirectTurnOff>;
+    toggle: ReturnType<typeof useDirectToggle>;
+};
+export declare function useTurnOn(): ReturnType<typeof useDirectTurnOn>;
+export declare function useTurnOff(): ReturnType<typeof useDirectTurnOff>;
+export declare function useToggle(): ReturnType<typeof useDirectToggle>;

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

@@ -15,6 +15,9 @@ export interface WidgetDimensions {
     width: number;
     height: number;
 }
+/** Capability-routed service call: an RPC into the host's HA bridge worker,
+    validated there against the widget's granted capabilities. */
+export type ServiceCallFn = (domain: string, service: string, serviceData?: Record<string, unknown>, target?: Record<string, unknown>) => Promise<void>;
 export interface ReactiveWidgetContext {
     isEditMode: () => boolean;
     updateConfig: (config: Record<string, unknown>) => void;
@@ -23,6 +26,9 @@ export interface ReactiveWidgetContext {
     /** Host RPC: `useWidgetDialog` registers its opener here so the host can
         open the widget's dialog on a chosen tab. Called with `null` on cleanup. */
     registerDialogOpener?: (open: ((tab?: string) => void) | null) => void;
+    /** Present when the host mounts the widget; the service hooks route
+        through it. Absent in previews/tests (direct sync-layer fallback). */
+    callService?: ServiceCallFn;
 }
 export declare const WidgetCtx: import("solid-js").Context<ReactiveWidgetContext | undefined>;
 export declare function useWidgetContext(): ReactiveWidgetContext;

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 UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDialog, useWidgetEntityGroup, WidgetCtx, type WidgetDialogReturn, } from "./hooks";
+export { type AggregationPreset, type ReactiveWidgetContext, type ServiceCallFn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDialog, useWidgetEntityGroup, WidgetCtx, type WidgetDialogReturn, } 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";

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

@@ -2,7 +2,7 @@
  * Minimal document-shape needed for token injection. Allows tests to pass
  * a stub without a full DOM implementation.
  */
-interface InjectTokensRoot {
+export interface InjectTokensRoot {
     head: {
         appendChild: (node: unknown) => void;
         querySelector?: (sel: string) => unknown;
@@ -13,12 +13,17 @@ interface InjectTokensRoot {
     };
 }
 /**
- * Inject the SDK tokens stylesheet into <head>. Idempotent across:
+ * Inject the SDK tokens stylesheet into the widget's root.
+ *
+ * ShadowRoot: adopts a shared constructed CSSStyleSheet (one instance for
+ * all widget shadow roots), idempotent per root via WeakSet.
+ *
+ * Document (or no argument, legacy): appends a <style> to <head>.
+ * Idempotent across:
  *  - Repeated calls within the same module instance (boolean sentinel).
  *  - Multiple SDK module instances (DOM sentinel data-glasshome-tokens).
  *  - SSR / non-browser environments (no-op when document is undefined).
  */
-export declare function injectTokens(doc?: InjectTokensRoot): void;
+export declare function injectTokens(root?: Document | ShadowRoot): void;
 /** Test-only: reset the module-level sentinel. Not exported from the package root. */
 export declare function __resetInjectedForTests(): void;
-export {};

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { defineWidget } from "./define-widget";
+export * from "./data";
 export * from "./framework";
 export { monotoneCubicPath } from "./shared/spline";
 export { formatSchemaError, WidgetManifestSchema } from "./schemas";