preact-homeassistant 0.1.0 → 0.2.2

package/README.md

@@ -102,19 +102,42 @@ Returns a strict type based on the domain prefix:
 - `'calendar.*'` → `CalendarEntity`
 - `'weather.*'` → `WeatherEntity`
 - `'sun.sun'` → `SunEntity`
+- `'fan.*'` → `FanEntity`
 - Other domains → `HassEntity` (the loose type from `home-assistant-js-websocket`)
 
 The mapping comes from the `DomainEntityMap` interface. To add a new domain,
 see the *Contributing types* section below.
 
+### `useService(entityId)`
+
+Returns a stable function that calls services on a specific entity. The
+service domain is parsed from the entity ID prefix and `entity_id` is
+auto-injected into every call. Service names and data shapes are
+strongly typed via `DomainServiceMap` when the domain is registered.
+
+```tsx
+const fanService = useService(config.entity);   // config.entity: `fan.${string}`
+await fanService('toggle');                     // entity_id auto-injected
+await fanService('set_percentage', { percentage: 67 });
+```
+
+For registered domains (currently `fan`), TypeScript autocompletes service
+names and validates the data shape. For other domains the hook still works,
+just without per-service autocomplete — useful for ad-hoc calls until the
+domain is added to `DomainServiceMap`.
+
+The returned function is a no-op if the entity ID is empty (common while the
+card config is being set up) or if `hass` isn't connected yet.
+
 ### `useHass()`
 
-Access the full `hass` object for calling services or reading config. Does not
-re-render on entity changes.
+Access the full `hass` object for reading config or making service calls that
+`useService` doesn't cover (different entity per call, no entity, custom
+`return_response`, etc.). Does not re-render on entity changes.
 
 ```tsx
 const { getHass } = useHass();
-await getHass()?.callService('light', 'turn_on', { entity_id: 'light.bedroom' });
+await getHass()?.callService('script', 'morning_routine');
 ```
 
 ### `useCalendarEvents(entityId, { start, end })`
@@ -148,6 +171,60 @@ const { forecast, status, error, refetch } = useWeatherForecast('weather.home',
 Generic hook for fetching data with localStorage caching. The domain-specific
 hooks above are built on this.
 
+### `useResizeObserver(ref, callback, deps?)`
+
+Observe an element's size via `ResizeObserver`. The callback fires once after
+mount with the current size, on every subsequent resize, and whenever `deps`
+change. The callback is held in a ref, so passing a fresh closure each render
+is safe — the observer is never re-created.
+
+```tsx
+const containerRef = useRef<HTMLDivElement>(null);
+
+useResizeObserver(
+  containerRef,
+  ({ width, height }) => {
+    if (width === 0 || height === 0) return; // optional, consumer's call
+    drawChart(canvasRef.current, forecast, width, height);
+  },
+  [forecast],
+);
+```
+
+The callback is suppressed while the element is detached from the document.
+Zero width/height is passed through — many draw routines need to guard
+against zero dimensions (a 0-sized canvas throws `InvalidStateError` on
+`drawImage`; ratios of measurements like `Math.ceil(width / cellSize)`
+produce `Infinity` when a dimension is zero and infinite-loop the next
+`for` they feed into) — but the guard belongs at the call site so the hook
+stays general-purpose.
+
+Sizes are read from `offsetWidth` / `offsetHeight` (CSS pixels, includes
+padding and border).
+
+### `useWidth(ref)`
+
+Stateful sibling to `useResizeObserver` for the JSX path: tracks a
+referenced element's width and re-renders the component when it changes.
+Returns `undefined` until the first non-zero measurement, then a positive
+number that never returns to `undefined` or `0` — transient zero-width
+firings during HA layout transitions (dashboard switch, edit-mode toggle)
+and detached states are silently ignored.
+
+```tsx
+const ref = useRef<HTMLDivElement>(null);
+const width = useWidth(ref);
+return (
+  <div ref={ref}>
+    {width !== undefined && <Chart width={width} />}
+  </div>
+);
+```
+
+Use this when the width needs to appear in JSX (responsive layout, prop to
+a sized child). For imperative use inside a draw callback, prefer
+`useResizeObserver` directly — no state, no extra re-renders.
+
 ## Styles
 
 Styles are registered globally via the `css\`\`` tagged template and
@@ -189,8 +266,9 @@ All HA domain types live in [`src/types/`](src/types/):
 - [`calendar.ts`](src/types/calendar.ts) — `CalendarEntity`, `CalendarEvent`, `CalendarEventWithSource`
 - [`weather.ts`](src/types/weather.ts) — `WeatherEntity`, `WeatherForecast`, `ForecastType`
 - [`sun.ts`](src/types/sun.ts) — `SunEntity`
+- [`fan.ts`](src/types/fan.ts) — `FanEntity`, `FanServices`
 - [`common.ts`](src/types/common.ts) — `HomeAssistant`, `FetchStatus`
-- [`index.ts`](src/types/index.ts) — `DomainEntityMap`, `EntityForId<T>`
+- [`index.ts`](src/types/index.ts) — `DomainEntityMap`, `EntityForId<T>`, `DomainServiceMap`, `ServicesForId<T>`
 
 Re-exported from the package root:
 
@@ -200,8 +278,13 @@ import type {
   CalendarEntity,
   WeatherEntity,
   SunEntity,
+  FanEntity,
+  FanServices,
   WeatherForecast,
   EntityForId,
+  DomainEntityMap,
+  DomainServiceMap,
+  ServicesForId,
   /* ... */
 } from 'preact-homeassistant';
 ```
@@ -214,11 +297,16 @@ for another domain (light, climate, media_player, cover, etc.), PRs are very
 welcome.
 
 1. Look up the domain in the [Home Assistant frontend repo](https://github.com/home-assistant/frontend/tree/dev/src/data) — most domains have a `data/<domain>.ts` file with TypeScript types.
-2. Add `src/types/<domain>.ts` mirroring the fields your card needs. Extend `HassEntityBase` and `HassEntityAttributeBase` from `home-assistant-js-websocket`.
-3. Add the entity to `DomainEntityMap` in [`src/types/index.ts`](src/types/index.ts) and re-export the types.
+2. Add `src/types/<domain>.ts`. Include an entity interface that extends `HassEntityBase` / `HassEntityAttributeBase` from `home-assistant-js-websocket`, plus a services interface mapping each service name to its data shape (or `undefined` for services that take no payload beyond `entity_id`). See [`src/types/fan.ts`](src/types/fan.ts) for the shape.
+3. In [`src/types/index.ts`](src/types/index.ts), add the entity to `DomainEntityMap` and the services to `DomainServiceMap`, and re-export the new types.
 4. Add a quick test under `src/__tests__/` if you're feeling thorough.
 5. PR.
 
+Both the entity types and the service types are opt-in: until a domain
+appears in `DomainEntityMap`, `useEntity('light.foo')` falls back to
+`HassEntity`; until it appears in `DomainServiceMap`, `useService('light.foo')`
+still works but without per-service autocomplete.
+
 We err toward including only fields that are well-documented; speculative
 attributes can land later.
 

package/dist/index.d.ts

@@ -62,6 +62,16 @@ export declare interface DomainEntityMap {
     calendar: CalendarEntity;
     weather: WeatherEntity;
     sun: SunEntity;
+    fan: FanEntity;
+}
+
+/**
+ * Map of known HA domains to their service signatures. Mirrors DomainEntityMap.
+ * Contributors adding a new domain's actions should add a new file under
+ * `src/types/` and extend this map.
+ */
+export declare interface DomainServiceMap {
+    fan: FanServices;
 }
 
 /**
@@ -73,10 +83,64 @@ export declare interface DomainEntityMap {
  */
 export declare type EntityForId<T extends string> = T extends `${infer D}.${string}` ? D extends KnownDomain ? DomainEntityMap[D] : HassEntity : HassEntity;
 
+/**
+ * Fan entity - speed is reported as percentage (0-100) with percentage_step
+ * giving the smallest discrete increment the fan supports.
+ */
+export declare interface FanEntity extends HassEntityBase {
+    state: 'on' | 'off' | 'unavailable' | 'unknown';
+    attributes: HassEntityAttributeBase & {
+        percentage?: number;
+        percentage_step?: number;
+        preset_modes?: string[];
+        preset_mode?: string;
+        oscillating?: boolean;
+        direction?: 'forward' | 'reverse';
+        supported_features?: number;
+    };
+}
+
+/**
+ * Data payload shapes for each service in the `fan` domain.
+ * `undefined` means the service accepts no payload beyond `entity_id`.
+ * See https://www.home-assistant.io/integrations/fan/#actions
+ */
+export declare interface FanServices {
+    turn_on: {
+        percentage?: number;
+        preset_mode?: string;
+    };
+    turn_off: undefined;
+    toggle: undefined;
+    set_percentage: {
+        percentage: number;
+    };
+    set_preset_mode: {
+        preset_mode: string;
+    };
+    oscillate: {
+        oscillating: boolean;
+    };
+    set_direction: {
+        direction: 'forward' | 'reverse';
+    };
+    increase_speed: {
+        percentage_step?: number;
+    };
+    decrease_speed: {
+        percentage_step?: number;
+    };
+}
+
 export declare type FetchStatus = 'loading' | 'cached' | 'ready' | 'refreshing';
 
 export declare type ForecastType = 'daily' | 'hourly' | 'twice_daily';
 
+/**
+ * Get all registered styles for Shadow DOM injection.
+ */
+export declare function getAllStyles(): string;
+
 export declare function HAProvider({ hass, subscribeToEntity, children }: HAProviderProps): JSX.Element;
 
 declare interface HAProviderProps {
@@ -102,6 +166,8 @@ export declare interface HomeAssistant {
 
 declare type KnownDomain = keyof DomainEntityMap;
 
+declare type KnownServiceDomain = keyof DomainServiceMap;
+
 export declare function loadFromCache<T>(key: string): T | undefined;
 
 export declare function registerPreactCard<TConfig>(options: RegisterPreactCardOptions<TConfig>): void;
@@ -130,6 +196,16 @@ export declare function registerRawStyles(styles: string): void;
 
 export declare function saveToCache<T>(key: string, data: T): void;
 
+declare type ServiceCaller<T extends string> = <S extends keyof ServicesForId<T> & string>(service: S, ...args: ServicesForId<T>[S] extends undefined ? [] : Record<string, never> extends Exclude<ServicesForId<T>[S], undefined> ? [data?: ServicesForId<T>[S]] : [data: ServicesForId<T>[S]]) => Promise<void>;
+
+/**
+ * Infers the service registry from an entity ID literal type. Mirrors EntityForId.
+ *
+ *   ServicesForId<'fan.bedroom'> -> FanServices
+ *   ServicesForId<'sensor.foo'>  -> Record<string, Record<string, unknown> | undefined>  (fallback)
+ */
+export declare type ServicesForId<T extends string> = T extends `${infer D}.${string}` ? D extends KnownServiceDomain ? DomainServiceMap[D] : Record<string, Record<string, unknown> | undefined> : Record<string, Record<string, unknown> | undefined>;
+
 /**
  * Sun entity - provides sunrise/sunset and elevation information.
  */
@@ -221,6 +297,19 @@ declare interface UseMultiCalendarEventsResult {
     refetch: () => void;
 }
 
+/**
+ * Returns a stable function that calls services on a specific HA entity.
+ * The service domain is parsed from the entity ID prefix and `entity_id` is
+ * auto-injected into every call. Service names and data shapes are strongly
+ * typed via DomainServiceMap when the domain is registered. No-ops if hass
+ * is not yet available or the entity ID is empty.
+ *
+ *   const fanService = useService(config.entity);   // `fan.${string}`
+ *   await fanService('turn_off');
+ *   await fanService('set_percentage', { percentage: 67 });
+ */
+export declare function useService<T extends string>(entityId: T): ServiceCaller<T>;
+
 /**
  * Fetch weather forecast data with localStorage caching. Auto-refetches at the
  * top of each hour and when the underlying entity changes (debounced).

package/dist/index.js

@@ -79,6 +79,15 @@ function useHass() {
   const store = useHAStore();
   return { getHass: store.getHass };
 }
+function useService(entityId) {
+  const { getHass } = useHass();
+  return useCallbackStable(((service, data) => {
+    const hass = getHass();
+    if (!hass || !entityId.includes(".")) return Promise.resolve();
+    const domain = entityId.split(".", 1)[0];
+    return hass.callService(domain, service, { entity_id: entityId, ...data });
+  }));
+}
 function useCachedFetch(cacheKey, fetcher, deps) {
   const [data, setData] = useState(() => loadFromCache(cacheKey));
   const [isFresh, setIsFresh] = useState(false);
@@ -320,17 +329,30 @@ function registerPreactCard(options) {
     _shadowRoot;
     _hasRendered = false;
     _entityChangeListeners = /* @__PURE__ */ new Map();
+    // Pending tree teardown — see disconnectedCallback.
+    _unmountTimer;
     constructor() {
       super();
       this._shadowRoot = this.attachShadow({ mode: "open" });
     }
     connectedCallback() {
+      if (this._unmountTimer !== void 0) {
+        clearTimeout(this._unmountTimer);
+        this._unmountTimer = void 0;
+      }
       if (this._hass && this._config && !this._hasRendered) {
         this._render();
       }
     }
     disconnectedCallback() {
-      this._entityChangeListeners.clear();
+      if (this._unmountTimer !== void 0) return;
+      this._unmountTimer = setTimeout(() => {
+        this._unmountTimer = void 0;
+        if (this.isConnected) return;
+        render(null, this._shadowRoot);
+        this._hasRendered = false;
+        this._entityChangeListeners.clear();
+      }, 100);
     }
     set hass(hass) {
       const prevStates = this._hass?.states;
@@ -444,6 +466,7 @@ function registerPreactCard(options) {
 export {
   HAProvider,
   css,
+  getAllStyles,
   loadFromCache,
   registerPreactCard,
   registerRawStyles,
@@ -454,6 +477,7 @@ export {
   useEntity,
   useHass,
   useMultiCalendarEvents,
+  useService,
   useWeatherForecast
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/cacheUtils.ts","../src/useCallbackStable.ts","../src/HAContext.tsx","../src/styleRegistry.ts","../src/registerPreactCard.tsx"],"sourcesContent":["const CACHE_PREFIX = 'preact-ha:';\nconst CACHE_EXPIRY_MS = 24 * 60 * 60 * 1000;\n\ninterface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\nexport function loadFromCache<T>(key: string): T | undefined {\n  try {\n    const raw = localStorage.getItem(`${CACHE_PREFIX}${key}`);\n    if (!raw) return undefined;\n\n    const entry: CacheEntry<T> = JSON.parse(raw);\n    if (Date.now() - entry.timestamp > CACHE_EXPIRY_MS) {\n      localStorage.removeItem(`${CACHE_PREFIX}${key}`);\n      return undefined;\n    }\n    return entry.data;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function saveToCache<T>(key: string, data: T): void {\n  try {\n    const entry: CacheEntry<T> = { data, timestamp: Date.now() };\n    localStorage.setItem(`${CACHE_PREFIX}${key}`, JSON.stringify(entry));\n  } catch (e) {\n    console.warn('[preact-homeassistant cache] Failed to save:', e);\n  }\n}\n","import { useRef } from 'preact/hooks';\n\n/**\n * Creates a stable callback reference that always calls the latest version of the callback.\n * Unlike useCallback, this never changes identity, so it won't cause re-renders in children.\n *\n * @param callback The callback function to stabilize\n * @returns A stable function reference that always calls the latest callback\n */\nexport function useCallbackStable<T extends (...args: never[]) => unknown>(callback: T): T {\n  const callbackRef = useRef<T>(callback);\n\n  callbackRef.current = callback;\n\n  // Create a stable function reference once\n  const stableRef = useRef<T | null>(null);\n  if (stableRef.current === null) {\n    stableRef.current = ((...args: Parameters<T>) => {\n      return callbackRef.current(...args);\n    }) as T;\n  }\n\n  return stableRef.current;\n}\n","import { createContext } from 'preact';\nimport type { ComponentChildren } from 'preact';\nimport { useContext, useEffect, useMemo, useRef, useState } from 'preact/hooks';\n\nimport { loadFromCache, saveToCache } from './cacheUtils';\nimport type {\n  CalendarEvent,\n  CalendarEventWithSource,\n  EntityForId,\n  FetchStatus,\n  ForecastType,\n  HomeAssistant,\n  WeatherForecast,\n} from './types';\nimport { useCallbackStable } from './useCallbackStable';\n\ninterface HAStore {\n  hass: HomeAssistant | undefined;\n  getHass: () => HomeAssistant | undefined;\n  subscribeToEntity: (entityId: string, callback: (entity: any) => void) => () => void;\n}\n\nconst HAContext = createContext<HAStore | null>(null);\n\ninterface HAProviderProps {\n  hass: HomeAssistant | undefined;\n  subscribeToEntity: (entityId: string, callback: (entity: any) => void) => () => void;\n  children: ComponentChildren;\n}\n\nexport function HAProvider({ hass, subscribeToEntity, children }: HAProviderProps) {\n  const hassRef = useRef(hass);\n  hassRef.current = hass;\n\n  const getHass = useCallbackStable(() => hassRef.current);\n\n  const store = useMemo<HAStore>(\n    () => ({\n      hass: hassRef.current,\n      getHass,\n      subscribeToEntity,\n    }),\n    [getHass, subscribeToEntity],\n  );\n\n  return <HAContext.Provider value={store}>{children}</HAContext.Provider>;\n}\n\nfunction useHAStore(): HAStore {\n  const store = useContext(HAContext);\n  if (!store) {\n    throw new Error('useEntity/useHass must be used within an HAProvider');\n  }\n  return store;\n}\n\n/**\n * Subscribe to a specific entity by ID. Re-renders only when that entity changes.\n *\n * Returns a typed entity based on the domain prefix:\n *   - 'calendar.xyz' -> CalendarEntity\n *   - 'weather.xyz' -> WeatherEntity\n *   - 'sun.sun'     -> SunEntity\n *   - other domains -> HassEntity (fallback)\n */\nexport function useEntity<T extends string>(entityId: T): EntityForId<T> | undefined {\n  const store = useHAStore();\n  const cacheKey = `entity:${entityId}`;\n\n  const [entity, setEntity] = useState<EntityForId<T> | undefined>(() => {\n    const current = store.hass?.states[entityId] as EntityForId<T> | undefined;\n    if (current) return current;\n    return loadFromCache<EntityForId<T>>(cacheKey);\n  });\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToEntity(entityId, (newEntity) => {\n      setEntity(newEntity as EntityForId<T>);\n      saveToCache(cacheKey, newEntity);\n    });\n    return unsubscribe;\n  }, [entityId, store.subscribeToEntity, cacheKey]);\n\n  return entity;\n}\n\n/**\n * Get access to the full hass object for calling services / accessing config.\n * Does NOT re-render on entity changes. Use useEntity for that.\n */\nexport function useHass(): { getHass: () => HomeAssistant | undefined } {\n  const store = useHAStore();\n  return { getHass: store.getHass };\n}\n\ninterface UseCachedFetchResult<T> {\n  data: T | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Generic hook for fetching data with localStorage caching. Returns a cache-aware\n * status string to distinguish cached vs fresh data.\n */\nexport function useCachedFetch<T>(\n  cacheKey: string,\n  fetcher: () => Promise<T>,\n  deps: unknown[],\n): UseCachedFetchResult<T> {\n  const [data, setData] = useState<T | undefined>(() => loadFromCache<T>(cacheKey));\n  const [isFresh, setIsFresh] = useState(false);\n  const [isFetching, setIsFetching] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchIdRef = useRef(0);\n\n  const doFetch = useCallbackStable(async () => {\n    const fetchId = ++fetchIdRef.current;\n    setIsFetching(true);\n    setError(undefined);\n\n    try {\n      const result = await fetcher();\n      if (fetchId === fetchIdRef.current) {\n        setData(result);\n        setIsFresh(true);\n        saveToCache(cacheKey, result);\n      }\n    } catch (err) {\n      if (fetchId === fetchIdRef.current) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n      }\n    } finally {\n      if (fetchId === fetchIdRef.current) {\n        setIsFetching(false);\n      }\n    }\n  });\n\n  useEffect(() => {\n    doFetch();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n\n  const status: FetchStatus = useMemo(() => {\n    if (!data && isFetching) return 'loading';\n    if (data && !isFresh && isFetching) return 'cached';\n    if (data && isFresh && isFetching) return 'refreshing';\n    return 'ready';\n  }, [data, isFresh, isFetching]);\n\n  return { data, status, error, refetch: doFetch };\n}\n\ninterface UseCalendarEventsResult {\n  events: CalendarEvent[] | undefined;\n  loading: boolean;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Fetch calendar events for a date range from a single calendar.\n */\nexport function useCalendarEvents(\n  entityId: `calendar.${string}`,\n  options: { start: Date; end: Date },\n): UseCalendarEventsResult {\n  const { getHass } = useHass();\n  const [events, setEvents] = useState<CalendarEvent[] | undefined>(undefined);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchIdRef = useRef(0);\n\n  const fetchEvents = useCallbackStable(async () => {\n    const hass = getHass();\n    if (!hass?.connection) {\n      setError(new Error('Home Assistant connection not available'));\n      return;\n    }\n\n    const fetchId = ++fetchIdRef.current;\n    setLoading(true);\n    setError(undefined);\n\n    try {\n      const result = await hass.connection.sendMessagePromise<{\n        response: { [entityId: string]: { events: CalendarEvent[] } };\n      }>({\n        type: 'call_service',\n        domain: 'calendar',\n        service: 'get_events',\n        service_data: {\n          start_date_time: options.start.toISOString(),\n          end_date_time: options.end.toISOString(),\n        },\n        target: { entity_id: entityId },\n        return_response: true,\n      });\n\n      if (fetchId === fetchIdRef.current) {\n        const entityEvents = result.response?.[entityId]?.events ?? [];\n        setEvents(entityEvents);\n        setLoading(false);\n      }\n    } catch (err) {\n      if (fetchId === fetchIdRef.current) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n    }\n  });\n\n  useEffect(() => {\n    fetchEvents();\n  }, [entityId, options.start.getTime(), options.end.getTime(), fetchEvents]);\n\n  return { events, loading, error, refetch: fetchEvents };\n}\n\ninterface UseMultiCalendarEventsResult {\n  events: CalendarEventWithSource[] | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Fetch events from multiple calendars for a date range, with localStorage\n * caching. Events are tagged with their source calendar ID.\n */\nexport function useMultiCalendarEvents(\n  entityIds: `calendar.${string}`[],\n  options: { start: Date; end: Date },\n): UseMultiCalendarEventsResult {\n  const store = useHAStore();\n  const { getHass } = useHass();\n\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const entityIdsKey = entityIds.join(',');\n  const dateRangeKey = `${options.start.getTime()}-${options.end.getTime()}`;\n  const cacheKey = `events:${entityIdsKey}:${dateRangeKey}`;\n\n  const fetcher = useCallbackStable(async () => {\n    const hass = getHass();\n    if (!hass?.connection) {\n      throw new Error('Home Assistant connection not available');\n    }\n\n    if (entityIds.length === 0) {\n      return [];\n    }\n\n    const results = await Promise.all(\n      entityIds.map(async (entityId) => {\n        try {\n          const result = await hass.connection.sendMessagePromise<{\n            response: { [key: string]: { events: CalendarEvent[] } };\n          }>({\n            type: 'call_service',\n            domain: 'calendar',\n            service: 'get_events',\n            service_data: {\n              start_date_time: options.start.toISOString(),\n              end_date_time: options.end.toISOString(),\n            },\n            target: { entity_id: entityId },\n            return_response: true,\n          });\n\n          const calendarEvents = result.response?.[entityId]?.events ?? [];\n          return calendarEvents.map(\n            (event): CalendarEventWithSource => ({ ...event, calendarId: entityId }),\n          );\n        } catch (err) {\n          console.error(`Failed to fetch events for ${entityId}:`, err);\n          return [];\n        }\n      }),\n    );\n\n    return results.flat();\n  });\n\n  const {\n    data: events,\n    status,\n    error,\n    refetch,\n  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey]);\n\n  const debouncedRefetch = useCallbackStable(() => {\n    if (debounceTimerRef.current) {\n      clearTimeout(debounceTimerRef.current);\n    }\n    debounceTimerRef.current = setTimeout(() => refetch(), 500);\n  });\n\n  useEffect(() => {\n    const unsubscribes = entityIds.map((entityId) =>\n      store.subscribeToEntity(entityId, debouncedRefetch),\n    );\n    return () => {\n      unsubscribes.forEach((unsub) => unsub());\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n    };\n  }, [entityIdsKey, store.subscribeToEntity, debouncedRefetch]);\n\n  return { events, status, error, refetch };\n}\n\ninterface UseWeatherForecastResult {\n  forecast: WeatherForecast[] | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Fetch weather forecast data with localStorage caching. Auto-refetches at the\n * top of each hour and when the underlying entity changes (debounced).\n */\nexport function useWeatherForecast(\n  entityId: `weather.${string}`,\n  type: ForecastType,\n): UseWeatherForecastResult {\n  const store = useHAStore();\n  const { getHass } = useHass();\n  const cacheKey = `forecast:${entityId}:${type}`;\n\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const hourlyTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const fetcher = useCallbackStable(async () => {\n    const hass = getHass();\n    if (!hass?.connection) {\n      throw new Error('Home Assistant connection not available');\n    }\n\n    const result = await hass.connection.sendMessagePromise<{\n      response: { [entityId: string]: { forecast: WeatherForecast[] } };\n    }>({\n      type: 'call_service',\n      domain: 'weather',\n      service: 'get_forecasts',\n      service_data: { type },\n      target: { entity_id: entityId },\n      return_response: true,\n    });\n\n    return result.response?.[entityId]?.forecast ?? [];\n  });\n\n  const {\n    data: forecast,\n    status,\n    error,\n    refetch,\n  } = useCachedFetch(cacheKey, fetcher, [entityId, type]);\n\n  const debouncedRefetch = useCallbackStable(() => {\n    if (debounceTimerRef.current) {\n      clearTimeout(debounceTimerRef.current);\n    }\n    debounceTimerRef.current = setTimeout(() => refetch(), 500);\n  });\n\n  const scheduleHourlyRefetch = useCallbackStable(() => {\n    if (hourlyTimerRef.current) {\n      clearTimeout(hourlyTimerRef.current);\n    }\n    const now = new Date();\n    const nextHour = new Date(now);\n    nextHour.setHours(now.getHours() + 1, 0, 0, 0);\n    const msUntilNextHour = nextHour.getTime() - now.getTime();\n\n    hourlyTimerRef.current = setTimeout(() => {\n      refetch();\n      scheduleHourlyRefetch();\n    }, msUntilNextHour);\n  });\n\n  useEffect(() => {\n    scheduleHourlyRefetch();\n  }, [entityId, type, scheduleHourlyRefetch]);\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToEntity(entityId, debouncedRefetch);\n    return () => {\n      unsubscribe();\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      if (hourlyTimerRef.current) {\n        clearTimeout(hourlyTimerRef.current);\n      }\n    };\n  }, [entityId, store.subscribeToEntity, debouncedRefetch]);\n\n  return { forecast, status, error, refetch };\n}\n","// Style registry for Shadow DOM injection\n// Each .styles.ts file uses css`` which auto-registers\n\nconst styleRegistry: string[] = [];\n\n/**\n * CSS tagged template literal for syntax highlighting.\n * Automatically registers the styles with the global registry.\n */\nexport const css = (strings: TemplateStringsArray, ...values: unknown[]): string => {\n  const result = strings.reduce((acc, str, i) => acc + str + (values[i] ?? ''), '');\n  styleRegistry.push(result);\n  return result;\n};\n\n/**\n * Register raw CSS string (e.g., from ?inline imports).\n * Only registers if not already present.\n */\nexport function registerRawStyles(styles: string): void {\n  if (!styleRegistry.includes(styles)) {\n    styleRegistry.push(styles);\n  }\n}\n\n/**\n * Get all registered styles for Shadow DOM injection.\n */\nexport function getAllStyles(): string {\n  return styleRegistry.join('\\n');\n}\n","import { type ComponentType, render } from 'preact';\nimport { HAProvider } from './HAContext';\nimport { getAllStyles } from './styleRegistry';\nimport type { HomeAssistant } from './types';\n\ninterface RegisterPreactCardOptions<TConfig> {\n  type: string;\n  name: string;\n  description: string;\n  Component: ComponentType<{ config: TConfig }>;\n  ConfigComponent?: ComponentType<{\n    hass: HomeAssistant;\n    config: TConfig;\n    onConfigChanged: (config: TConfig) => void;\n  }>;\n  UnconfiguredComponent?: ComponentType<{}>;\n  getStubConfig?: () => Partial<TConfig>;\n}\n\ndeclare global {\n  interface Window {\n    customCards?: Array<{ type: string; name: string; description: string }>;\n  }\n}\n\nexport function registerPreactCard<TConfig>(options: RegisterPreactCardOptions<TConfig>) {\n  const {\n    type,\n    name,\n    description,\n    Component,\n    ConfigComponent,\n    UnconfiguredComponent,\n    getStubConfig,\n  } = options;\n\n  class HACard extends HTMLElement {\n    private _hass?: HomeAssistant;\n    private _config?: TConfig;\n    private _shadowRoot: ShadowRoot;\n    private _hasRendered = false;\n    private _entityChangeListeners = new Map<string, Set<(entity: any) => void>>();\n\n    constructor() {\n      super();\n      this._shadowRoot = this.attachShadow({ mode: 'open' });\n    }\n\n    connectedCallback() {\n      // HA disconnects + reconnects the element during edit-mode toggling.\n      // Re-rendering on each connect causes Preact to lose its diff anchor and\n      // append a duplicate tree, so only render once per attachment cycle.\n      if (this._hass && this._config && !this._hasRendered) {\n        this._render();\n      }\n    }\n\n    disconnectedCallback() {\n      this._entityChangeListeners.clear();\n    }\n\n    set hass(hass: HomeAssistant) {\n      const prevStates = this._hass?.states;\n      this._hass = hass;\n\n      for (const [entityId, listeners] of this._entityChangeListeners) {\n        const newState = hass.states[entityId];\n        const oldState = prevStates?.[entityId];\n        if (newState !== oldState) {\n          listeners.forEach((listener) => listener(newState));\n        }\n      }\n\n      // Render only when attached. HA may set hass/config before insertion;\n      // rendering into a detached shadow root then again on connect duplicates\n      // the tree. connectedCallback handles the detached-first-render case.\n      if (!prevStates && this._config && this.isConnected) {\n        this._render();\n      }\n    }\n\n    setConfig(config: TConfig) {\n      this._config = config;\n      if (this._hass && this.isConnected) {\n        this._render();\n      }\n    }\n\n    private _subscribeToEntity = (entityId: string, callback: (entity: any) => void) => {\n      if (!this._entityChangeListeners.has(entityId)) {\n        this._entityChangeListeners.set(entityId, new Set());\n      }\n      this._entityChangeListeners.get(entityId)!.add(callback);\n\n      return () => {\n        const listeners = this._entityChangeListeners.get(entityId);\n        if (listeners) {\n          listeners.delete(callback);\n          if (listeners.size === 0) {\n            this._entityChangeListeners.delete(entityId);\n          }\n        }\n      };\n    };\n\n    private _render() {\n      if (!this._config || !this._hass) {\n        if (UnconfiguredComponent) {\n          render(<UnconfiguredComponent />, this._shadowRoot);\n        }\n        return;\n      }\n\n      render(\n        <HAProvider hass={this._hass} subscribeToEntity={this._subscribeToEntity}>\n          <style>{getAllStyles()}</style>\n          <Component config={this._config} />\n        </HAProvider>,\n        this._shadowRoot,\n      );\n      this._hasRendered = true;\n    }\n\n    static getConfigElement() {\n      if (ConfigComponent) {\n        return document.createElement(`${type}-editor`);\n      }\n      return undefined;\n    }\n\n    static getStubConfig() {\n      return getStubConfig?.() ?? {};\n    }\n  }\n\n  customElements.define(type, HACard);\n\n  if (ConfigComponent) {\n    const EditorComponent = ConfigComponent;\n\n    class HACardEditor extends HTMLElement {\n      private _hass?: HomeAssistant;\n      private _config?: TConfig;\n\n      set hass(hass: HomeAssistant) {\n        this._hass = hass;\n        this._render();\n      }\n\n      setConfig(config: TConfig) {\n        this._config = config;\n        this._render();\n      }\n\n      private _fireConfigChanged = (config: TConfig) => {\n        this.dispatchEvent(\n          new CustomEvent('config-changed', {\n            detail: { config },\n            bubbles: true,\n            composed: true,\n          }),\n        );\n      };\n\n      private _render() {\n        if (!this._hass || !this._config) return;\n\n        // Render to light DOM so HA's custom elements (ha-select etc.) work.\n        render(\n          <EditorComponent\n            hass={this._hass}\n            config={this._config}\n            onConfigChanged={this._fireConfigChanged}\n          />,\n          this,\n        );\n      }\n    }\n\n    customElements.define(`${type}-editor`, HACardEditor);\n  }\n\n  window.customCards = window.customCards || [];\n  window.customCards.push({ type, name, description });\n\n  console.info(\n    `%c ${name.toUpperCase()} %c loaded `,\n    'background: #3b82f6; color: white; font-weight: bold',\n    '',\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/cacheUtils.ts","../src/useCallbackStable.ts","../src/HAContext.tsx","../src/styleRegistry.ts","../src/registerPreactCard.tsx"],"sourcesContent":["const CACHE_PREFIX = 'preact-ha:';\nconst CACHE_EXPIRY_MS = 24 * 60 * 60 * 1000;\n\ninterface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\nexport function loadFromCache<T>(key: string): T | undefined {\n  try {\n    const raw = localStorage.getItem(`${CACHE_PREFIX}${key}`);\n    if (!raw) return undefined;\n\n    const entry: CacheEntry<T> = JSON.parse(raw);\n    if (Date.now() - entry.timestamp > CACHE_EXPIRY_MS) {\n      localStorage.removeItem(`${CACHE_PREFIX}${key}`);\n      return undefined;\n    }\n    return entry.data;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function saveToCache<T>(key: string, data: T): void {\n  try {\n    const entry: CacheEntry<T> = { data, timestamp: Date.now() };\n    localStorage.setItem(`${CACHE_PREFIX}${key}`, JSON.stringify(entry));\n  } catch (e) {\n    console.warn('[preact-homeassistant cache] Failed to save:', e);\n  }\n}\n","import { useRef } from 'preact/hooks';\n\n/**\n * Creates a stable callback reference that always calls the latest version of the callback.\n * Unlike useCallback, this never changes identity, so it won't cause re-renders in children.\n *\n * @param callback The callback function to stabilize\n * @returns A stable function reference that always calls the latest callback\n */\nexport function useCallbackStable<T extends (...args: never[]) => unknown>(callback: T): T {\n  const callbackRef = useRef<T>(callback);\n\n  callbackRef.current = callback;\n\n  // Create a stable function reference once\n  const stableRef = useRef<T | null>(null);\n  if (stableRef.current === null) {\n    stableRef.current = ((...args: Parameters<T>) => {\n      return callbackRef.current(...args);\n    }) as T;\n  }\n\n  return stableRef.current;\n}\n","import { createContext } from 'preact';\nimport type { ComponentChildren } from 'preact';\nimport { useContext, useEffect, useMemo, useRef, useState } from 'preact/hooks';\n\nimport { loadFromCache, saveToCache } from './cacheUtils';\nimport type {\n  CalendarEvent,\n  CalendarEventWithSource,\n  EntityForId,\n  FetchStatus,\n  ForecastType,\n  HomeAssistant,\n  ServicesForId,\n  WeatherForecast,\n} from './types';\nimport { useCallbackStable } from './useCallbackStable';\n\ninterface HAStore {\n  hass: HomeAssistant | undefined;\n  getHass: () => HomeAssistant | undefined;\n  subscribeToEntity: (entityId: string, callback: (entity: any) => void) => () => void;\n}\n\nconst HAContext = createContext<HAStore | null>(null);\n\ninterface HAProviderProps {\n  hass: HomeAssistant | undefined;\n  subscribeToEntity: (entityId: string, callback: (entity: any) => void) => () => void;\n  children: ComponentChildren;\n}\n\nexport function HAProvider({ hass, subscribeToEntity, children }: HAProviderProps) {\n  const hassRef = useRef(hass);\n  hassRef.current = hass;\n\n  const getHass = useCallbackStable(() => hassRef.current);\n\n  const store = useMemo<HAStore>(\n    () => ({\n      hass: hassRef.current,\n      getHass,\n      subscribeToEntity,\n    }),\n    [getHass, subscribeToEntity],\n  );\n\n  return <HAContext.Provider value={store}>{children}</HAContext.Provider>;\n}\n\nfunction useHAStore(): HAStore {\n  const store = useContext(HAContext);\n  if (!store) {\n    throw new Error('useEntity/useHass must be used within an HAProvider');\n  }\n  return store;\n}\n\n/**\n * Subscribe to a specific entity by ID. Re-renders only when that entity changes.\n *\n * Returns a typed entity based on the domain prefix:\n *   - 'calendar.xyz' -> CalendarEntity\n *   - 'weather.xyz' -> WeatherEntity\n *   - 'sun.sun'     -> SunEntity\n *   - other domains -> HassEntity (fallback)\n */\nexport function useEntity<T extends string>(entityId: T): EntityForId<T> | undefined {\n  const store = useHAStore();\n  const cacheKey = `entity:${entityId}`;\n\n  const [entity, setEntity] = useState<EntityForId<T> | undefined>(() => {\n    const current = store.hass?.states[entityId] as EntityForId<T> | undefined;\n    if (current) return current;\n    return loadFromCache<EntityForId<T>>(cacheKey);\n  });\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToEntity(entityId, (newEntity) => {\n      setEntity(newEntity as EntityForId<T>);\n      saveToCache(cacheKey, newEntity);\n    });\n    return unsubscribe;\n  }, [entityId, store.subscribeToEntity, cacheKey]);\n\n  return entity;\n}\n\n/**\n * Get access to the full hass object for calling services / accessing config.\n * Does NOT re-render on entity changes. Use useEntity for that.\n */\nexport function useHass(): { getHass: () => HomeAssistant | undefined } {\n  const store = useHAStore();\n  return { getHass: store.getHass };\n}\n\ntype ServiceCaller<T extends string> = <S extends keyof ServicesForId<T> & string>(\n  service: S,\n  ...args: ServicesForId<T>[S] extends undefined\n    ? []\n    : Record<string, never> extends Exclude<ServicesForId<T>[S], undefined>\n      ? [data?: ServicesForId<T>[S]]\n      : [data: ServicesForId<T>[S]]\n) => Promise<void>;\n\n/**\n * Returns a stable function that calls services on a specific HA entity.\n * The service domain is parsed from the entity ID prefix and `entity_id` is\n * auto-injected into every call. Service names and data shapes are strongly\n * typed via DomainServiceMap when the domain is registered. No-ops if hass\n * is not yet available or the entity ID is empty.\n *\n *   const fanService = useService(config.entity);   // `fan.${string}`\n *   await fanService('turn_off');\n *   await fanService('set_percentage', { percentage: 67 });\n */\nexport function useService<T extends string>(entityId: T): ServiceCaller<T> {\n  const { getHass } = useHass();\n  return useCallbackStable(((service: string, data?: object) => {\n    const hass = getHass();\n    if (!hass || !entityId.includes('.')) return Promise.resolve();\n    const domain = entityId.split('.', 1)[0];\n    return hass.callService(domain, service, { entity_id: entityId, ...data });\n  }) as ServiceCaller<T>);\n}\n\ninterface UseCachedFetchResult<T> {\n  data: T | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Generic hook for fetching data with localStorage caching. Returns a cache-aware\n * status string to distinguish cached vs fresh data.\n */\nexport function useCachedFetch<T>(\n  cacheKey: string,\n  fetcher: () => Promise<T>,\n  deps: unknown[],\n): UseCachedFetchResult<T> {\n  const [data, setData] = useState<T | undefined>(() => loadFromCache<T>(cacheKey));\n  const [isFresh, setIsFresh] = useState(false);\n  const [isFetching, setIsFetching] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchIdRef = useRef(0);\n\n  const doFetch = useCallbackStable(async () => {\n    const fetchId = ++fetchIdRef.current;\n    setIsFetching(true);\n    setError(undefined);\n\n    try {\n      const result = await fetcher();\n      if (fetchId === fetchIdRef.current) {\n        setData(result);\n        setIsFresh(true);\n        saveToCache(cacheKey, result);\n      }\n    } catch (err) {\n      if (fetchId === fetchIdRef.current) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n      }\n    } finally {\n      if (fetchId === fetchIdRef.current) {\n        setIsFetching(false);\n      }\n    }\n  });\n\n  useEffect(() => {\n    doFetch();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n\n  const status: FetchStatus = useMemo(() => {\n    if (!data && isFetching) return 'loading';\n    if (data && !isFresh && isFetching) return 'cached';\n    if (data && isFresh && isFetching) return 'refreshing';\n    return 'ready';\n  }, [data, isFresh, isFetching]);\n\n  return { data, status, error, refetch: doFetch };\n}\n\ninterface UseCalendarEventsResult {\n  events: CalendarEvent[] | undefined;\n  loading: boolean;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Fetch calendar events for a date range from a single calendar.\n */\nexport function useCalendarEvents(\n  entityId: `calendar.${string}`,\n  options: { start: Date; end: Date },\n): UseCalendarEventsResult {\n  const { getHass } = useHass();\n  const [events, setEvents] = useState<CalendarEvent[] | undefined>(undefined);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchIdRef = useRef(0);\n\n  const fetchEvents = useCallbackStable(async () => {\n    const hass = getHass();\n    if (!hass?.connection) {\n      setError(new Error('Home Assistant connection not available'));\n      return;\n    }\n\n    const fetchId = ++fetchIdRef.current;\n    setLoading(true);\n    setError(undefined);\n\n    try {\n      const result = await hass.connection.sendMessagePromise<{\n        response: { [entityId: string]: { events: CalendarEvent[] } };\n      }>({\n        type: 'call_service',\n        domain: 'calendar',\n        service: 'get_events',\n        service_data: {\n          start_date_time: options.start.toISOString(),\n          end_date_time: options.end.toISOString(),\n        },\n        target: { entity_id: entityId },\n        return_response: true,\n      });\n\n      if (fetchId === fetchIdRef.current) {\n        const entityEvents = result.response?.[entityId]?.events ?? [];\n        setEvents(entityEvents);\n        setLoading(false);\n      }\n    } catch (err) {\n      if (fetchId === fetchIdRef.current) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n    }\n  });\n\n  useEffect(() => {\n    fetchEvents();\n  }, [entityId, options.start.getTime(), options.end.getTime(), fetchEvents]);\n\n  return { events, loading, error, refetch: fetchEvents };\n}\n\ninterface UseMultiCalendarEventsResult {\n  events: CalendarEventWithSource[] | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Fetch events from multiple calendars for a date range, with localStorage\n * caching. Events are tagged with their source calendar ID.\n */\nexport function useMultiCalendarEvents(\n  entityIds: `calendar.${string}`[],\n  options: { start: Date; end: Date },\n): UseMultiCalendarEventsResult {\n  const store = useHAStore();\n  const { getHass } = useHass();\n\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const entityIdsKey = entityIds.join(',');\n  const dateRangeKey = `${options.start.getTime()}-${options.end.getTime()}`;\n  const cacheKey = `events:${entityIdsKey}:${dateRangeKey}`;\n\n  const fetcher = useCallbackStable(async () => {\n    const hass = getHass();\n    if (!hass?.connection) {\n      throw new Error('Home Assistant connection not available');\n    }\n\n    if (entityIds.length === 0) {\n      return [];\n    }\n\n    const results = await Promise.all(\n      entityIds.map(async (entityId) => {\n        try {\n          const result = await hass.connection.sendMessagePromise<{\n            response: { [key: string]: { events: CalendarEvent[] } };\n          }>({\n            type: 'call_service',\n            domain: 'calendar',\n            service: 'get_events',\n            service_data: {\n              start_date_time: options.start.toISOString(),\n              end_date_time: options.end.toISOString(),\n            },\n            target: { entity_id: entityId },\n            return_response: true,\n          });\n\n          const calendarEvents = result.response?.[entityId]?.events ?? [];\n          return calendarEvents.map(\n            (event): CalendarEventWithSource => ({ ...event, calendarId: entityId }),\n          );\n        } catch (err) {\n          console.error(`Failed to fetch events for ${entityId}:`, err);\n          return [];\n        }\n      }),\n    );\n\n    return results.flat();\n  });\n\n  const {\n    data: events,\n    status,\n    error,\n    refetch,\n  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey]);\n\n  const debouncedRefetch = useCallbackStable(() => {\n    if (debounceTimerRef.current) {\n      clearTimeout(debounceTimerRef.current);\n    }\n    debounceTimerRef.current = setTimeout(() => refetch(), 500);\n  });\n\n  useEffect(() => {\n    const unsubscribes = entityIds.map((entityId) =>\n      store.subscribeToEntity(entityId, debouncedRefetch),\n    );\n    return () => {\n      unsubscribes.forEach((unsub) => unsub());\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n    };\n  }, [entityIdsKey, store.subscribeToEntity, debouncedRefetch]);\n\n  return { events, status, error, refetch };\n}\n\ninterface UseWeatherForecastResult {\n  forecast: WeatherForecast[] | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Fetch weather forecast data with localStorage caching. Auto-refetches at the\n * top of each hour and when the underlying entity changes (debounced).\n */\nexport function useWeatherForecast(\n  entityId: `weather.${string}`,\n  type: ForecastType,\n): UseWeatherForecastResult {\n  const store = useHAStore();\n  const { getHass } = useHass();\n  const cacheKey = `forecast:${entityId}:${type}`;\n\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const hourlyTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const fetcher = useCallbackStable(async () => {\n    const hass = getHass();\n    if (!hass?.connection) {\n      throw new Error('Home Assistant connection not available');\n    }\n\n    const result = await hass.connection.sendMessagePromise<{\n      response: { [entityId: string]: { forecast: WeatherForecast[] } };\n    }>({\n      type: 'call_service',\n      domain: 'weather',\n      service: 'get_forecasts',\n      service_data: { type },\n      target: { entity_id: entityId },\n      return_response: true,\n    });\n\n    return result.response?.[entityId]?.forecast ?? [];\n  });\n\n  const {\n    data: forecast,\n    status,\n    error,\n    refetch,\n  } = useCachedFetch(cacheKey, fetcher, [entityId, type]);\n\n  const debouncedRefetch = useCallbackStable(() => {\n    if (debounceTimerRef.current) {\n      clearTimeout(debounceTimerRef.current);\n    }\n    debounceTimerRef.current = setTimeout(() => refetch(), 500);\n  });\n\n  const scheduleHourlyRefetch = useCallbackStable(() => {\n    if (hourlyTimerRef.current) {\n      clearTimeout(hourlyTimerRef.current);\n    }\n    const now = new Date();\n    const nextHour = new Date(now);\n    nextHour.setHours(now.getHours() + 1, 0, 0, 0);\n    const msUntilNextHour = nextHour.getTime() - now.getTime();\n\n    hourlyTimerRef.current = setTimeout(() => {\n      refetch();\n      scheduleHourlyRefetch();\n    }, msUntilNextHour);\n  });\n\n  useEffect(() => {\n    scheduleHourlyRefetch();\n  }, [entityId, type, scheduleHourlyRefetch]);\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToEntity(entityId, debouncedRefetch);\n    return () => {\n      unsubscribe();\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      if (hourlyTimerRef.current) {\n        clearTimeout(hourlyTimerRef.current);\n      }\n    };\n  }, [entityId, store.subscribeToEntity, debouncedRefetch]);\n\n  return { forecast, status, error, refetch };\n}\n","// Style registry for Shadow DOM injection\n// Each .styles.ts file uses css`` which auto-registers\n\nconst styleRegistry: string[] = [];\n\n/**\n * CSS tagged template literal for syntax highlighting.\n * Automatically registers the styles with the global registry.\n */\nexport const css = (strings: TemplateStringsArray, ...values: unknown[]): string => {\n  const result = strings.reduce((acc, str, i) => acc + str + (values[i] ?? ''), '');\n  styleRegistry.push(result);\n  return result;\n};\n\n/**\n * Register raw CSS string (e.g., from ?inline imports).\n * Only registers if not already present.\n */\nexport function registerRawStyles(styles: string): void {\n  if (!styleRegistry.includes(styles)) {\n    styleRegistry.push(styles);\n  }\n}\n\n/**\n * Get all registered styles for Shadow DOM injection.\n */\nexport function getAllStyles(): string {\n  return styleRegistry.join('\\n');\n}\n","import { type ComponentType, render } from 'preact';\nimport { HAProvider } from './HAContext';\nimport { getAllStyles } from './styleRegistry';\nimport type { HomeAssistant } from './types';\n\ninterface RegisterPreactCardOptions<TConfig> {\n  type: string;\n  name: string;\n  description: string;\n  Component: ComponentType<{ config: TConfig }>;\n  ConfigComponent?: ComponentType<{\n    hass: HomeAssistant;\n    config: TConfig;\n    onConfigChanged: (config: TConfig) => void;\n  }>;\n  UnconfiguredComponent?: ComponentType<{}>;\n  getStubConfig?: () => Partial<TConfig>;\n}\n\ndeclare global {\n  interface Window {\n    customCards?: Array<{ type: string; name: string; description: string }>;\n  }\n}\n\nexport function registerPreactCard<TConfig>(options: RegisterPreactCardOptions<TConfig>) {\n  const {\n    type,\n    name,\n    description,\n    Component,\n    ConfigComponent,\n    UnconfiguredComponent,\n    getStubConfig,\n  } = options;\n\n  class HACard extends HTMLElement {\n    private _hass?: HomeAssistant;\n    private _config?: TConfig;\n    private _shadowRoot: ShadowRoot;\n    private _hasRendered = false;\n    private _entityChangeListeners = new Map<string, Set<(entity: any) => void>>();\n    // Pending tree teardown — see disconnectedCallback.\n    private _unmountTimer: ReturnType<typeof setTimeout> | undefined;\n\n    constructor() {\n      super();\n      this._shadowRoot = this.attachShadow({ mode: 'open' });\n    }\n\n    connectedCallback() {\n      // If a teardown was scheduled by a recent disconnect, cancel it: HA is\n      // doing a transient detach/reattach (edit-mode toggle, drag/drop) and\n      // the tree is still valid.\n      if (this._unmountTimer !== undefined) {\n        clearTimeout(this._unmountTimer);\n        this._unmountTimer = undefined;\n      }\n      if (this._hass && this._config && !this._hasRendered) {\n        this._render();\n      }\n    }\n\n    disconnectedCallback() {\n      // HA disconnects + reconnects the element during edit-mode toggling and\n      // drag-and-drop. A reconnect lands within a tick. If we're still\n      // detached after a short delay, tear the Preact tree down properly so\n      // useEffect cleanups run (e.g. Leaflet's map.remove(), which removes\n      // its non-passive touch/wheel listeners from window/document).\n      // Leaving the tree mounted on a detached shadow root leaks listeners on\n      // every reconnect cycle and eventually locks up the UI.\n      if (this._unmountTimer !== undefined) return;\n      this._unmountTimer = setTimeout(() => {\n        this._unmountTimer = undefined;\n        if (this.isConnected) return;\n        render(null, this._shadowRoot);\n        this._hasRendered = false;\n        this._entityChangeListeners.clear();\n      }, 100);\n    }\n\n    set hass(hass: HomeAssistant) {\n      const prevStates = this._hass?.states;\n      this._hass = hass;\n\n      for (const [entityId, listeners] of this._entityChangeListeners) {\n        const newState = hass.states[entityId];\n        const oldState = prevStates?.[entityId];\n        if (newState !== oldState) {\n          listeners.forEach((listener) => listener(newState));\n        }\n      }\n\n      // Render only when attached. HA may set hass/config before insertion;\n      // rendering into a detached shadow root then again on connect duplicates\n      // the tree. connectedCallback handles the detached-first-render case.\n      if (!prevStates && this._config && this.isConnected) {\n        this._render();\n      }\n    }\n\n    setConfig(config: TConfig) {\n      this._config = config;\n      if (this._hass && this.isConnected) {\n        this._render();\n      }\n    }\n\n    private _subscribeToEntity = (entityId: string, callback: (entity: any) => void) => {\n      if (!this._entityChangeListeners.has(entityId)) {\n        this._entityChangeListeners.set(entityId, new Set());\n      }\n      this._entityChangeListeners.get(entityId)!.add(callback);\n\n      return () => {\n        const listeners = this._entityChangeListeners.get(entityId);\n        if (listeners) {\n          listeners.delete(callback);\n          if (listeners.size === 0) {\n            this._entityChangeListeners.delete(entityId);\n          }\n        }\n      };\n    };\n\n    private _render() {\n      if (!this._config || !this._hass) {\n        if (UnconfiguredComponent) {\n          render(<UnconfiguredComponent />, this._shadowRoot);\n        }\n        return;\n      }\n\n      render(\n        <HAProvider hass={this._hass} subscribeToEntity={this._subscribeToEntity}>\n          <style>{getAllStyles()}</style>\n          <Component config={this._config} />\n        </HAProvider>,\n        this._shadowRoot,\n      );\n      this._hasRendered = true;\n    }\n\n    static getConfigElement() {\n      if (ConfigComponent) {\n        return document.createElement(`${type}-editor`);\n      }\n      return undefined;\n    }\n\n    static getStubConfig() {\n      return getStubConfig?.() ?? {};\n    }\n  }\n\n  customElements.define(type, HACard);\n\n  if (ConfigComponent) {\n    const EditorComponent = ConfigComponent;\n\n    class HACardEditor extends HTMLElement {\n      private _hass?: HomeAssistant;\n      private _config?: TConfig;\n\n      set hass(hass: HomeAssistant) {\n        this._hass = hass;\n        this._render();\n      }\n\n      setConfig(config: TConfig) {\n        this._config = config;\n        this._render();\n      }\n\n      private _fireConfigChanged = (config: TConfig) => {\n        this.dispatchEvent(\n          new CustomEvent('config-changed', {\n            detail: { config },\n            bubbles: true,\n            composed: true,\n          }),\n        );\n      };\n\n      private _render() {\n        if (!this._hass || !this._config) return;\n\n        // Render to light DOM so HA's custom elements (ha-select etc.) work.\n        render(\n          <EditorComponent\n            hass={this._hass}\n            config={this._config}\n            onConfigChanged={this._fireConfigChanged}\n          />,\n          this,\n        );\n      }\n    }\n\n    customElements.define(`${type}-editor`, HACardEditor);\n  }\n\n  window.customCards = window.customCards || [];\n  window.customCards.push({ type, name, description });\n\n  console.info(\n    `%c ${name.toUpperCase()} %c loaded `,\n    'background: #3b82f6; color: white; font-weight: bold',\n    '',\n  );\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "preact-homeassistant",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "Preact hooks and helpers for building Home Assistant custom cards",
   "author": {
     "name": "Stu Kabakoff",

package/src/HAContext.tsx

@@ -10,6 +10,7 @@ import type {
   FetchStatus,
   ForecastType,
   HomeAssistant,
+  ServicesForId,
   WeatherForecast,
 } from './types';
 import { useCallbackStable } from './useCallbackStable';
@@ -93,6 +94,36 @@ export function useHass(): { getHass: () => HomeAssistant | undefined } {
   return { getHass: store.getHass };
 }
 
+type ServiceCaller<T extends string> = <S extends keyof ServicesForId<T> & string>(
+  service: S,
+  ...args: ServicesForId<T>[S] extends undefined
+    ? []
+    : Record<string, never> extends Exclude<ServicesForId<T>[S], undefined>
+      ? [data?: ServicesForId<T>[S]]
+      : [data: ServicesForId<T>[S]]
+) => Promise<void>;
+
+/**
+ * Returns a stable function that calls services on a specific HA entity.
+ * The service domain is parsed from the entity ID prefix and `entity_id` is
+ * auto-injected into every call. Service names and data shapes are strongly
+ * typed via DomainServiceMap when the domain is registered. No-ops if hass
+ * is not yet available or the entity ID is empty.
+ *
+ *   const fanService = useService(config.entity);   // `fan.${string}`
+ *   await fanService('turn_off');
+ *   await fanService('set_percentage', { percentage: 67 });
+ */
+export function useService<T extends string>(entityId: T): ServiceCaller<T> {
+  const { getHass } = useHass();
+  return useCallbackStable(((service: string, data?: object) => {
+    const hass = getHass();
+    if (!hass || !entityId.includes('.')) return Promise.resolve();
+    const domain = entityId.split('.', 1)[0];
+    return hass.callService(domain, service, { entity_id: entityId, ...data });
+  }) as ServiceCaller<T>);
+}
+
 interface UseCachedFetchResult<T> {
   data: T | undefined;
   status: FetchStatus;

package/src/__tests__/registerPreactCard.test.tsx

@@ -154,7 +154,12 @@ describe('registerPreactCard', () => {
     expect(callback).toHaveBeenCalledWith({ state: 'on' });
   });
 
-  it('clears all listeners on disconnect', () => {
+  it('preserves entity subscriptions across disconnect + reconnect', () => {
+    // HA detaches + reattaches cards during edit-mode toggling. The shadow
+    // root and its Preact tree travel with the host, so subscriptions
+    // registered by useEffect must survive — otherwise the host's listener
+    // map empties while components still believe they're subscribed, and
+    // entity updates stop reaching the UI.
     const type = uniqueType();
     registerPreactCard({
       type,
@@ -173,11 +178,12 @@ describe('registerPreactCard', () => {
     card.hass = makeHass({ 'sensor.temp': { state: '72' } });
     expect(callback).toHaveBeenCalledTimes(1);
 
-    card.disconnectedCallback();
+    document.body.removeChild(card);
+    document.body.appendChild(card);
     callback.mockClear();
 
     card.hass = makeHass({ 'sensor.temp': { state: '73' } });
-    expect(callback).not.toHaveBeenCalled();
+    expect(callback).toHaveBeenCalledWith({ state: '73' });
   });
 
   it('registers editor element when ConfigComponent is provided', () => {

package/src/__tests__/useResizeObserver.test.tsx

@@ -0,0 +1,151 @@
+import { act, render } from '@testing-library/preact';
+import { useRef } from 'preact/hooks';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { type ElementSize, useResizeObserver } from '../useResizeObserver';
+
+// jsdom doesn't implement ResizeObserver. Provide a controllable stub so we
+// can drive size changes deterministically.
+type StubObserver = {
+  observe: ReturnType<typeof vi.fn>;
+  disconnect: ReturnType<typeof vi.fn>;
+  trigger: () => void;
+};
+const liveObservers: StubObserver[] = [];
+
+beforeEach(() => {
+  liveObservers.length = 0;
+  (globalThis as any).ResizeObserver = class {
+    private cb: () => void;
+    public observe: any;
+    public disconnect: any;
+    constructor(cb: () => void) {
+      this.cb = cb;
+      this.observe = vi.fn();
+      this.disconnect = vi.fn(() => {
+        const idx = liveObservers.findIndex((o) => o.observe === this.observe);
+        if (idx !== -1) liveObservers.splice(idx, 1);
+      });
+      liveObservers.push({
+        observe: this.observe,
+        disconnect: this.disconnect,
+        trigger: () => this.cb(),
+      });
+    }
+  };
+});
+
+afterEach(() => {
+  (globalThis as any).ResizeObserver = undefined;
+  document.body.innerHTML = '';
+});
+
+function setSize(el: HTMLElement, width: number, height: number) {
+  Object.defineProperty(el, 'offsetWidth', { configurable: true, value: width });
+  Object.defineProperty(el, 'offsetHeight', { configurable: true, value: height });
+}
+
+function Probe({
+  callback,
+  deps,
+  initialWidth = 400,
+  initialHeight = 80,
+}: {
+  callback: (size: ElementSize) => void;
+  deps?: unknown[];
+  initialWidth?: number;
+  initialHeight?: number;
+}) {
+  const ref = useRef<HTMLDivElement>(null);
+  // Apply size to the element synchronously before useResizeObserver's effect
+  // runs by relying on the callback ref pattern: the ref is populated before
+  // useEffect fires.
+  useResizeObserver(
+    ref,
+    (size) => {
+      callback(size);
+    },
+    deps,
+  );
+  return (
+    <div
+      ref={(el) => {
+        if (el) {
+          ref.current = el;
+          setSize(el, initialWidth, initialHeight);
+        }
+      }}
+    />
+  );
+}
+
+describe('useResizeObserver', () => {
+  it('fires once with the current size after mount', () => {
+    const cb = vi.fn();
+    render(<Probe callback={cb} initialWidth={300} initialHeight={150} />);
+    act(() => liveObservers[0].trigger());
+    expect(cb).toHaveBeenCalledTimes(1);
+    expect(cb).toHaveBeenCalledWith({ width: 300, height: 150 });
+  });
+
+  it('fires again when the element resizes', () => {
+    const cb = vi.fn();
+    const { container } = render(<Probe callback={cb} />);
+    act(() => liveObservers[0].trigger());
+    cb.mockClear();
+
+    const el = container.firstChild as HTMLElement;
+    setSize(el, 500, 100);
+    act(() => liveObservers[0].trigger());
+
+    expect(cb).toHaveBeenCalledWith({ width: 500, height: 100 });
+  });
+
+  it('delivers zero dimensions to the callback (consumer decides)', () => {
+    const cb = vi.fn();
+    render(<Probe callback={cb} initialWidth={0} initialHeight={80} />);
+    act(() => liveObservers[0].trigger());
+    expect(cb).toHaveBeenCalledWith({ width: 0, height: 80 });
+  });
+
+  it('does not fire when the element is detached', () => {
+    const cb = vi.fn();
+    const { container, unmount } = render(<Probe callback={cb} />);
+    const el = container.firstChild as HTMLElement;
+    setSize(el, 400, 80);
+
+    // Detach without unmounting Preact (simulates HA moving the host).
+    el.remove();
+    act(() => liveObservers[0]?.trigger());
+
+    expect(cb).not.toHaveBeenCalled();
+    unmount();
+  });
+
+  it('re-fires when deps change', () => {
+    const cb = vi.fn();
+    const { rerender } = render(<Probe callback={cb} deps={[1]} />);
+    act(() => liveObservers[0].trigger());
+    cb.mockClear();
+
+    rerender(<Probe callback={cb} deps={[2]} />);
+    expect(cb).toHaveBeenCalledWith({ width: 400, height: 80 });
+  });
+
+  it('does not re-fire on the mount run of the deps effect', () => {
+    // The observer fires once on .observe(). The deps effect's first-mount run
+    // must not double-fire with the same dimensions.
+    const cb = vi.fn();
+    render(<Probe callback={cb} deps={[1]} />);
+    act(() => liveObservers[0].trigger());
+    expect(cb).toHaveBeenCalledTimes(1);
+  });
+
+  it('disconnects the observer on unmount', () => {
+    const cb = vi.fn();
+    const { unmount } = render(<Probe callback={cb} />);
+    const observer = liveObservers[0];
+    expect(observer.disconnect).not.toHaveBeenCalled();
+    unmount();
+    expect(observer.disconnect).toHaveBeenCalled();
+  });
+});

package/src/__tests__/useService.test.tsx

@@ -0,0 +1,113 @@
+import { act } from '@testing-library/preact';
+import { useEffect, useRef } from 'preact/hooks';
+import { describe, expect, it, vi } from 'vitest';
+import { useService } from '../HAContext';
+import { makeHass, renderWithHA } from './testHelpers';
+
+function ServiceCallProbe({
+  entityId,
+  onReady,
+}: {
+  entityId: string;
+  onReady: (call: ReturnType<typeof useService>) => void;
+}) {
+  const call = useService(entityId);
+  useEffect(() => {
+    onReady(call);
+  }, [call, onReady]);
+  return null;
+}
+
+describe('useService', () => {
+  it('calls hass.callService with the parsed domain, service, and injected entity_id', async () => {
+    const callService = vi.fn().mockResolvedValue(undefined);
+    const hass = makeHass({}, { callService });
+
+    let invoke: ReturnType<typeof useService> | undefined;
+    renderWithHA(
+      <ServiceCallProbe
+        entityId="fan.bedroom"
+        onReady={(call) => {
+          invoke = call;
+        }}
+      />,
+      { hass },
+    );
+
+    await act(async () => {
+      await invoke!('set_percentage', { percentage: 67 });
+    });
+
+    expect(callService).toHaveBeenCalledWith('fan', 'set_percentage', {
+      entity_id: 'fan.bedroom',
+      percentage: 67,
+    });
+  });
+
+  it('calls services that take no data with just the injected entity_id', async () => {
+    const callService = vi.fn().mockResolvedValue(undefined);
+    const hass = makeHass({}, { callService });
+
+    let invoke: ReturnType<typeof useService> | undefined;
+    renderWithHA(
+      <ServiceCallProbe
+        entityId="fan.bedroom"
+        onReady={(call) => {
+          invoke = call;
+        }}
+      />,
+      { hass },
+    );
+
+    await act(async () => {
+      await invoke!('turn_off');
+    });
+
+    expect(callService).toHaveBeenCalledWith('fan', 'turn_off', {
+      entity_id: 'fan.bedroom',
+    });
+  });
+
+  it('returns a stable function reference across renders', () => {
+    const hass = makeHass({}, { callService: vi.fn() });
+
+    const refs: Array<ReturnType<typeof useService>> = [];
+
+    function Probe() {
+      const call = useService('fan.bedroom');
+      const renderCount = useRef(0);
+      renderCount.current++;
+      refs.push(call);
+      return <div data-testid="renders">{renderCount.current}</div>;
+    }
+
+    const { rerender } = renderWithHA(<Probe />, { hass });
+    rerender(<Probe />);
+    rerender(<Probe />);
+
+    // All captured refs should be the same function.
+    expect(new Set(refs).size).toBe(1);
+  });
+
+  it('is a no-op when the entity ID is empty', async () => {
+    const callService = vi.fn();
+    const hass = makeHass({}, { callService });
+
+    let invoke: ReturnType<typeof useService> | undefined;
+    renderWithHA(
+      <ServiceCallProbe
+        entityId=""
+        onReady={(call) => {
+          invoke = call;
+        }}
+      />,
+      { hass },
+    );
+
+    await act(async () => {
+      await invoke!('turn_off' as never);
+    });
+
+    expect(callService).not.toHaveBeenCalled();
+  });
+});

package/src/__tests__/useWidth.test.tsx

@@ -0,0 +1,110 @@
+import { act, render } from '@testing-library/preact';
+import { useRef } from 'preact/hooks';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { useWidth } from '../useWidth';
+
+// Controllable ResizeObserver stub (same shape as useResizeObserver.test).
+type StubObserver = {
+  observe: ReturnType<typeof vi.fn>;
+  disconnect: ReturnType<typeof vi.fn>;
+  trigger: () => void;
+};
+const liveObservers: StubObserver[] = [];
+
+beforeEach(() => {
+  liveObservers.length = 0;
+  (globalThis as any).ResizeObserver = class {
+    private cb: () => void;
+    public observe: any;
+    public disconnect: any;
+    constructor(cb: () => void) {
+      this.cb = cb;
+      this.observe = vi.fn();
+      this.disconnect = vi.fn(() => {
+        const idx = liveObservers.findIndex((o) => o.observe === this.observe);
+        if (idx !== -1) liveObservers.splice(idx, 1);
+      });
+      liveObservers.push({
+        observe: this.observe,
+        disconnect: this.disconnect,
+        trigger: () => this.cb(),
+      });
+    }
+  };
+});
+
+afterEach(() => {
+  (globalThis as any).ResizeObserver = undefined;
+  document.body.innerHTML = '';
+});
+
+function setSize(el: HTMLElement, width: number, height: number) {
+  Object.defineProperty(el, 'offsetWidth', { configurable: true, value: width });
+  Object.defineProperty(el, 'offsetHeight', { configurable: true, value: height });
+}
+
+let lastWidth: number | undefined;
+
+function Probe({ initialWidth = 400 }: { initialWidth?: number }) {
+  const ref = useRef<HTMLDivElement>(null);
+  lastWidth = useWidth(ref);
+  return (
+    <div
+      ref={(el) => {
+        if (el) {
+          ref.current = el;
+          setSize(el, initialWidth, 80);
+        }
+      }}
+    />
+  );
+}
+
+describe('useWidth', () => {
+  beforeEach(() => {
+    lastWidth = undefined;
+  });
+
+  it('returns undefined until the first measurement', () => {
+    render(<Probe />);
+    expect(lastWidth).toBeUndefined();
+  });
+
+  it('returns the observed width after the first non-zero measurement', () => {
+    const { container } = render(<Probe initialWidth={400} />);
+    act(() => liveObservers[0].trigger());
+    expect(lastWidth).toBe(400);
+
+    const el = container.firstChild as HTMLElement;
+    setSize(el, 500, 80);
+    act(() => liveObservers[0].trigger());
+    expect(lastWidth).toBe(500);
+  });
+
+  it('ignores zero-width measurements (keeps last good value)', () => {
+    const { container } = render(<Probe initialWidth={400} />);
+    act(() => liveObservers[0].trigger());
+    expect(lastWidth).toBe(400);
+
+    const el = container.firstChild as HTMLElement;
+    setSize(el, 0, 80);
+    act(() => liveObservers[0].trigger());
+    expect(lastWidth).toBe(400);
+
+    setSize(el, 450, 80);
+    act(() => liveObservers[0].trigger());
+    expect(lastWidth).toBe(450);
+  });
+
+  it('does not update while the element is detached', () => {
+    const { container } = render(<Probe initialWidth={400} />);
+    act(() => liveObservers[0].trigger());
+    expect(lastWidth).toBe(400);
+
+    const el = container.firstChild as HTMLElement;
+    el.remove();
+    setSize(el, 999, 80);
+    act(() => liveObservers[0]?.trigger());
+    expect(lastWidth).toBe(400);
+  });
+});

package/src/index.ts

@@ -3,12 +3,19 @@ export {
   HAProvider,
   useEntity,
   useHass,
+  useService,
   useCachedFetch,
   useCalendarEvents,
   useMultiCalendarEvents,
   useWeatherForecast,
 } from './HAContext';
 export { useCallbackStable } from './useCallbackStable';
+export {
+  useResizeObserver,
+  type ElementSize,
+  type ResizeCallback,
+} from './useResizeObserver';
+export { useWidth } from './useWidth';
 export { css, registerRawStyles, getAllStyles } from './styleRegistry';
 export { loadFromCache, saveToCache } from './cacheUtils';
 
@@ -22,6 +29,10 @@ export type {
   WeatherForecast,
   ForecastType,
   SunEntity,
+  FanEntity,
+  FanServices,
   EntityForId,
   DomainEntityMap,
+  DomainServiceMap,
+  ServicesForId,
 } from './types';

package/src/registerPreactCard.tsx

@@ -38,7 +38,6 @@ export function registerPreactCard<TConfig>(options: RegisterPreactCardOptions<T
     private _hass?: HomeAssistant;
     private _config?: TConfig;
     private _shadowRoot: ShadowRoot;
-    private _hasRendered = false;
     private _entityChangeListeners = new Map<string, Set<(entity: any) => void>>();
 
     constructor() {
@@ -47,18 +46,11 @@ export function registerPreactCard<TConfig>(options: RegisterPreactCardOptions<T
     }
 
     connectedCallback() {
-      // HA disconnects + reconnects the element during edit-mode toggling.
-      // Re-rendering on each connect causes Preact to lose its diff anchor and
-      // append a duplicate tree, so only render once per attachment cycle.
-      if (this._hass && this._config && !this._hasRendered) {
+      if (this._hass && this._config) {
         this._render();
       }
     }
 
-    disconnectedCallback() {
-      this._entityChangeListeners.clear();
-    }
-
     set hass(hass: HomeAssistant) {
       const prevStates = this._hass?.states;
       this._hass = hass;
@@ -71,9 +63,6 @@ export function registerPreactCard<TConfig>(options: RegisterPreactCardOptions<T
         }
       }
 
-      // Render only when attached. HA may set hass/config before insertion;
-      // rendering into a detached shadow root then again on connect duplicates
-      // the tree. connectedCallback handles the detached-first-render case.
       if (!prevStates && this._config && this.isConnected) {
         this._render();
       }
@@ -118,7 +107,6 @@ export function registerPreactCard<TConfig>(options: RegisterPreactCardOptions<T
         </HAProvider>,
         this._shadowRoot,
       );
-      this._hasRendered = true;
     }
 
     static getConfigElement() {

package/src/types/fan.ts

@@ -0,0 +1,35 @@
+import type { HassEntityAttributeBase, HassEntityBase } from 'home-assistant-js-websocket';
+
+/**
+ * Fan entity - speed is reported as percentage (0-100) with percentage_step
+ * giving the smallest discrete increment the fan supports.
+ */
+export interface FanEntity extends HassEntityBase {
+  state: 'on' | 'off' | 'unavailable' | 'unknown';
+  attributes: HassEntityAttributeBase & {
+    percentage?: number;
+    percentage_step?: number;
+    preset_modes?: string[];
+    preset_mode?: string;
+    oscillating?: boolean;
+    direction?: 'forward' | 'reverse';
+    supported_features?: number;
+  };
+}
+
+/**
+ * Data payload shapes for each service in the `fan` domain.
+ * `undefined` means the service accepts no payload beyond `entity_id`.
+ * See https://www.home-assistant.io/integrations/fan/#actions
+ */
+export interface FanServices {
+  turn_on: { percentage?: number; preset_mode?: string };
+  turn_off: undefined;
+  toggle: undefined;
+  set_percentage: { percentage: number };
+  set_preset_mode: { preset_mode: string };
+  oscillate: { oscillating: boolean };
+  set_direction: { direction: 'forward' | 'reverse' };
+  increase_speed: { percentage_step?: number };
+  decrease_speed: { percentage_step?: number };
+}

package/src/types/index.ts

@@ -1,5 +1,6 @@
 import type { HassEntity } from 'home-assistant-js-websocket';
 import type { CalendarEntity } from './calendar';
+import type { FanEntity, FanServices } from './fan';
 import type { SunEntity } from './sun';
 import type { WeatherEntity } from './weather';
 
@@ -11,6 +12,7 @@ export type {
 } from './calendar';
 export type { WeatherEntity, WeatherForecast, ForecastType } from './weather';
 export type { SunEntity } from './sun';
+export type { FanEntity, FanServices } from './fan';
 
 /**
  * Map of known HA domains to their strict entity types. Contributors adding
@@ -20,6 +22,7 @@ export interface DomainEntityMap {
   calendar: CalendarEntity;
   weather: WeatherEntity;
   sun: SunEntity;
+  fan: FanEntity;
 }
 
 type KnownDomain = keyof DomainEntityMap;
@@ -36,3 +39,26 @@ export type EntityForId<T extends string> = T extends `${infer D}.${string}`
     ? DomainEntityMap[D]
     : HassEntity
   : HassEntity;
+
+/**
+ * Map of known HA domains to their service signatures. Mirrors DomainEntityMap.
+ * Contributors adding a new domain's actions should add a new file under
+ * `src/types/` and extend this map.
+ */
+export interface DomainServiceMap {
+  fan: FanServices;
+}
+
+type KnownServiceDomain = keyof DomainServiceMap;
+
+/**
+ * Infers the service registry from an entity ID literal type. Mirrors EntityForId.
+ *
+ *   ServicesForId<'fan.bedroom'> -> FanServices
+ *   ServicesForId<'sensor.foo'>  -> Record<string, Record<string, unknown> | undefined>  (fallback)
+ */
+export type ServicesForId<T extends string> = T extends `${infer D}.${string}`
+  ? D extends KnownServiceDomain
+    ? DomainServiceMap[D]
+    : Record<string, Record<string, unknown> | undefined>
+  : Record<string, Record<string, unknown> | undefined>;

package/src/useResizeObserver.ts

@@ -0,0 +1,88 @@
+import type { RefObject } from 'preact';
+import { useEffect, useRef } from 'preact/hooks';
+
+export interface ElementSize {
+  width: number;
+  height: number;
+}
+
+export type ResizeCallback = (size: ElementSize) => void;
+
+/**
+ * Observe an element's size via ResizeObserver. The callback fires:
+ *
+ *   1. Once after mount, with the element's current size.
+ *   2. Whenever the element's size changes.
+ *   3. Whenever `deps` change, re-firing with the current size — so callers
+ *      can re-run draws when their inputs change without re-creating the
+ *      observer.
+ *
+ * The callback is suppressed only while the element is detached from the
+ * document. Zero width/height is delivered to the callback as-is — consumers
+ * that need to skip degenerate sizes (e.g. canvas painters where a 0-sized
+ * drawImage throws InvalidStateError) should add their own early return.
+ *
+ * Sizes are read from `offsetWidth` / `offsetHeight` (CSS pixels, includes
+ * padding + border). The callback is held in a ref, so passing a fresh
+ * function each render is safe — it never re-creates the observer.
+ *
+ * @example
+ * const containerRef = useRef<HTMLDivElement>(null);
+ * const canvasRef = useRef<HTMLCanvasElement>(null);
+ *
+ * useResizeObserver(
+ *   containerRef,
+ *   ({ width, height }) => {
+ *     if (width === 0 || height === 0) return; // optional, consumer's call
+ *     drawChart(canvasRef.current, forecast, width, height);
+ *   },
+ *   [forecast],
+ * );
+ */
+export function useResizeObserver<T extends HTMLElement>(
+  ref: RefObject<T>,
+  callback: ResizeCallback,
+  deps: unknown[] = [],
+): void {
+  const callbackRef = useRef(callback);
+  callbackRef.current = callback;
+
+  // Set up the observer once per element. ResizeObserver fires once
+  // synchronously-ish after `.observe()` with the current size, which
+  // covers the initial draw.
+  useEffect(() => {
+    const element = ref.current;
+    if (!element) return;
+
+    const fire = () => {
+      if (!element.isConnected) return;
+      callbackRef.current({
+        width: element.offsetWidth,
+        height: element.offsetHeight,
+      });
+    };
+
+    const observer = new ResizeObserver(fire);
+    observer.observe(element);
+    return () => observer.disconnect();
+    // ref identity is stable across renders; observer setup runs once.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  // Re-fire on dependency change. Skip the first render — the observer's
+  // initial `.observe()` fire already delivers the mount-time size.
+  const isFirstRun = useRef(true);
+  useEffect(() => {
+    if (isFirstRun.current) {
+      isFirstRun.current = false;
+      return;
+    }
+    const element = ref.current;
+    if (!element || !element.isConnected) return;
+    callbackRef.current({
+      width: element.offsetWidth,
+      height: element.offsetHeight,
+    });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, deps);
+}

package/src/useWidth.ts

@@ -0,0 +1,37 @@
+import type { RefObject } from 'preact';
+import { useState } from 'preact/hooks';
+import { useResizeObserver } from './useResizeObserver';
+
+/**
+ * Track the current width of a referenced element in CSS pixels.
+ *
+ * Returns `undefined` until the first non-zero measurement is observed, then
+ * a positive number that updates as the element resizes. Once a real width
+ * is captured the hook will never report `undefined` or `0` again, even
+ * during HA layout transitions (dashboard switch, edit-mode toggle) — the
+ * underlying ResizeObserver firings are silently dropped while the element
+ * is detached or transiently zero-width, so the component renders with the
+ * last good value instead of flashing through a degenerate state.
+ *
+ * Use this when you need a width value in JSX (responsive layout, prop to a
+ * sized child). If you only need the value imperatively inside a draw
+ * callback, prefer `useResizeObserver` directly — it doesn't allocate
+ * component state or cause re-renders.
+ *
+ * @example
+ * const ref = useRef<HTMLDivElement>(null);
+ * const width = useWidth(ref);
+ * return (
+ *   <div ref={ref}>
+ *     {width !== undefined && <Chart width={width} />}
+ *   </div>
+ * );
+ */
+export function useWidth<T extends HTMLElement>(ref: RefObject<T>): number | undefined {
+  const [width, setWidth] = useState<number | undefined>(undefined);
+  useResizeObserver(ref, (size) => {
+    if (size.width === 0) return;
+    setWidth((prev) => (prev === size.width ? prev : size.width));
+  });
+  return width;
+}