preact-homeassistant 0.5.1 → 0.6.0

package/README.md

@@ -14,6 +14,8 @@ pnpm add preact preact-homeassistant
 
 ## Quick start
 
+The easiest way is to [use the template](https://github.com/stutrek/preact-homeassistant-template)
+
 ```tsx
 import { registerPreactCard, HACard, useEntity, css } from 'preact-homeassistant';
 
@@ -167,36 +169,86 @@ const { getHass } = useHass();
 await getHass()?.callService('script', 'morning_routine');
 ```
 
-### `useCalendarEvents(entityId, { start, end })`
+### `useHassValue(selector, isEqual?)`
+
+Subscribe to a derived slice of the `hass` object (config, themes, anything
+that isn't entity state — entity state goes through `useEntity`). The selector
+runs on every hass update, but the consumer only re-renders when `isEqual`
+reports a change, so it's cheap for rarely-changing values. `isEqual` defaults
+to `Object.is`.
+
+```tsx
+const unitSystem = useHassValue((hass) => hass?.config?.unit_system?.temperature);
+```
+
+### `useHassConfig()`
+
+Shorthand for `useHassValue((hass) => hass?.config)`. Re-renders when
+`hass.config` changes (units, latitude/longitude, etc.).
+
+### `useDarkMode()`
 
-Fetch calendar events for a date range from a single calendar.
+Shorthand for the active theme's dark-mode flag. Returns `boolean`.
 
-### `useMultiCalendarEvents(entityIds, { start, end })`
+### `useCalendarEvents(entityIds, { start, end })`
 
-Fetch events from multiple calendars. Events are returned with `calendarId`
-attached. Caches to localStorage and debounce-refetches when entities change.
+Fetch events from one or more calendars for a date range. `entityIds` is an
+array of `` `calendar.${string}` `` IDs, and every returned event carries the
+`calendarId` it came from. Caches per-card in memory with
+stale-while-revalidate, persists each calendar's events to localStorage (see
+[Caching](#caching)), and debounce-refetches when any of the entities change.
 
 ```tsx
-const { events, status, error, refetch } = useMultiCalendarEvents(
+const { events, status, error, refetch, prefetch } = useCalendarEvents(
   ['calendar.family', 'calendar.work'],
   { start, end },
 );
 // status: 'loading' | 'cached' | 'ready' | 'refreshing'
+
+// Warm adjacent months without touching component state:
+prefetch({ start: prevMonthStart, end: prevMonthEnd });
 ```
 
+`prefetch(range)` is best-effort — it skips ranges already cached and swallows
+failures.
+
+Events are read from the REST view `GET /api/calendars/{entity_id}`, which
+(unlike the `calendar.get_events` service response) includes `uid`,
+`recurrence_id`, and `rrule`. The service call is used as a fallback when
+`hass.callApi` isn't available (test mocks, Storybook).
+
 ### `useWeatherForecast(entityId, type)`
 
-Fetch weather forecast data. Caches to localStorage, debounce-refetches on
-entity changes, and auto-refetches at the top of each hour.
+Fetch weather forecast data. Caches per-card in memory and in localStorage,
+debounce-refetches on entity changes, and auto-refetches at the top of each hour.
 
 ```tsx
 const { forecast, status, error, refetch } = useWeatherForecast('weather.home', 'hourly');
 ```
 
-### `useCachedFetch(cacheKey, fetcher, deps)`
+### `useCachedFetch(cacheKey, fetcher, deps, options?)`
+
+Generic hook for fetching data with per-card caching. The domain-specific hooks
+above are built on this. `fetcher` is re-run whenever `deps` change; the result
+is stored under `cacheKey` in the provider's cache.
+
+```tsx
+const { data, status, error, refetch } = useCachedFetch(
+  `my-thing:${id}`,
+  () => fetchMyThing(id),
+  [id],
+);
+```
+
+Behavior is stale-while-revalidate and key-change aware: when `cacheKey`
+changes it swaps to that key's cached value synchronously, or keeps the
+previously rendered data on a cold key — it never blanks to a loading state.
+`'loading'` only appears on a true cold start (nothing cached, nothing
+fetched). In-flight fetches are ignored if a newer one has started.
 
-Generic hook for fetching data with localStorage caching. The domain-specific
-hooks above are built on this.
+`options.seed` is a fallback read used when the in-memory cache misses (the
+built-in hooks use it to read localStorage). Seeded data reports `'cached'` and
+is revalidated like any other hit.
 
 ### `useResizeObserver(ref, callback, deps?)`
 
@@ -272,12 +324,72 @@ import './MyCard.styles'; // registers styles on import
 
 ### `registerRawStyles(cssString)`
 
-Register a raw CSS string, e.g. from a Vite `?inline` import.
+Register a raw CSS string, e.g. from a Vite `?inline` import. No-ops if the
+exact string is already registered.
+
+### `getAllStyles()`
+
+Returns every registered style as one concatenated string. `registerPreactCard`
+calls this to inject styles into the card's Shadow DOM; you only need it if
+you're rendering a card tree yourself.
+
+## Calendar mutations
 
-## Cache utilities
+Plain async functions (not hooks) for calendars that support writes, e.g. Local
+Calendar. Each takes the `hass` object — get it from `useHass()`. They require
+entity control permission, not admin, and WebSocket errors reject unchanged so
+you can inspect `err.code` (e.g. `'unauthorized'`).
 
-`loadFromCache(key)` / `saveToCache(key, data)` — localStorage wrapper with
-24-hour expiry. Used internally by the data hooks.
+```tsx
+import { createCalendarEvent, updateCalendarEvent, deleteCalendarEvent } from 'preact-homeassistant';
+
+const { getHass } = useHass();
+
+await createCalendarEvent(getHass(), 'calendar.family', {
+  dtstart: '2026-07-17T09:00:00',
+  dtend: '2026-07-17T10:00:00',
+  summary: 'Dentist',
+});
+
+await updateCalendarEvent(getHass(), 'calendar.family', uid, { ...event, summary: 'Dentist ✅' });
+
+await deleteCalendarEvent(getHass(), 'calendar.family', uid, {
+  recurrenceId,   // optional, for one instance of a recurring event
+  recurrenceRange, // optional, e.g. 'THISANDFUTURE'
+});
+```
+
+`CalendarMutationEvent` is the payload type: `dtstart` / `dtend` are either
+date-only strings (`'2026-07-17'`, all-day) or ISO datetimes, plus `summary`
+and optional `description`, `location`, `rrule`.
+
+## Caching
+
+The fetch hooks cache into an in-memory `Map` owned by the provider, so its
+lifetime matches the card and it is garbage-collected on teardown.
+
+Beneath that, calendar events and forecasts persist to localStorage so a
+reload renders immediately. Persisted data only seeds a cold start: it's always
+reported as `'cached'` and revalidated, so freshness still comes from entity
+subscriptions and periodic refetch. Expiry exists to bound storage:
+
+- Calendar events are stored **per entity** and range, so any set of calendars
+  (across cards, or a card's regular and highlight calendars) shares entries.
+- Entries older than 3 days are dropped and never shown.
+- At most 60 entries are kept; the least recently used are evicted.
+- Expiry and the cap cover the whole `preact-ha:` namespace, not just this
+  version's keys: every card built on this library shares one localStorage, so
+  data left behind by a deleted card (or one on another library version)
+  expires whenever any preact-ha card loads.
+- Keys are prefixed `preact-ha:v2:`; bumping the version makes old entries
+  unreadable, and they then age out.
+- Cross-version contract: every value under `preact-ha:` is JSON with numeric
+  `s` (saved at) and `u` (last used) timestamps in ms. Future versions must keep
+  this so they can expire each other's data.
+- Failed fetches are never persisted, and storage errors fall back to
+  memory-only.
+
+The read/write helpers are internal — reach the cache through `useCachedFetch`.
 
 ## Other utilities
 
@@ -286,6 +398,25 @@ Register a raw CSS string, e.g. from a Vite `?inline` import.
 Returns a stable callback ref that always calls the latest `fn`. Avoids effect
 re-runs while keeping the closure current.
 
+### `HAProvider`
+
+The context provider `registerPreactCard` wraps your card in. Export exists so
+you can render a card outside Home Assistant (Storybook, tests) with a mock
+`hass`.
+
+```tsx
+<HAProvider hass={mockHass} subscribeToEntity={() => () => {}}>
+  <MyCardContent config={config} />
+</HAProvider>
+```
+
+| Prop | Type | Required | Description |
+|---|---|---|---|
+| `hass` | `HomeAssistant \| undefined` | Yes | The hass object handed to hooks. |
+| `subscribeToEntity` | `(entityId, cb) => () => void` | Yes | Entity subscription plumbing. Return a no-op unsubscribe for static mocks. |
+| `subscribeToHass` | `(cb) => () => void` | No | Notifies `useHassValue` consumers. Defaults to a no-op, so those hooks return their initial value and never update. |
+| `cache` | `Cache` | No | Inject a cache Map to seed or inspect it. Defaults to a fresh per-provider Map. |
+
 ## Types
 
 All HA domain types live in [`src/types/`](src/types/):
@@ -302,20 +433,27 @@ Re-exported from the package root:
 ```ts
 import type {
   HomeAssistant,
+  FetchStatus,
   CalendarEntity,
+  CalendarEvent,
+  CalendarEventWithSource,
+  CalendarMutationEvent,
   WeatherEntity,
+  WeatherForecast,
+  ForecastType,
   SunEntity,
   FanEntity,
   FanServices,
-  WeatherForecast,
   EntityForId,
   DomainEntityMap,
   DomainServiceMap,
   ServicesForId,
-  /* ... */
 } from 'preact-homeassistant';
 ```
 
+The non-domain types `HACardAlign`, `ElementSize`, and `ResizeCallback` are
+exported from the root as well, alongside their components/hooks.
+
 ## Contributing types
 
 The HA domain types in this package are intentionally minimal — only the
@@ -342,8 +480,10 @@ attributes can land later.
 ```bash
 pnpm install
 pnpm test       # vitest run
+pnpm typecheck  # tsc --noEmit
 pnpm build      # tsc --noEmit && vite build
-pnpm lint       # biome check
+pnpm lint       # biome check src
+pnpm lint:fix   # biome check --write src
 ```
 
 ## Publishing
@@ -351,7 +491,7 @@ pnpm lint       # biome check
 Releases are published to npm manually from a local machine (no CI publish):
 
 ```bash
-pnpm test && pnpm build && pnpm typecheck
+pnpm test && pnpm build
 git tag v0.X.Y && git push origin v0.X.Y
 pnpm publish --access public --provenance
 ```

package/dist/index.d.ts

@@ -288,10 +288,19 @@ export declare interface SunEntity extends HassEntityBase {
 export declare function updateCalendarEvent(hass: HomeAssistant | undefined, entityId: `calendar.${string}`, uid: string, event: CalendarMutationEvent): Promise<void>;
 
 /**
- * Generic hook for fetching data with localStorage caching. Returns a cache-aware
- * status string to distinguish cached vs fresh data.
+ * Generic hook for fetching data with in-memory caching (optionally seeded from
+ * a persistent store). Returns a cache-aware status string to distinguish cached
+ * vs fresh data.
  */
-export declare function useCachedFetch<T>(cacheKey: string, fetcher: () => Promise<T>, deps: unknown[]): UseCachedFetchResult<T>;
+export declare function useCachedFetch<T>(cacheKey: string, fetcher: () => Promise<T>, deps: unknown[], options?: UseCachedFetchOptions<T>): UseCachedFetchResult<T>;
+
+declare interface UseCachedFetchOptions<T> {
+    /**
+     * Fallback read when the in-memory cache misses (e.g. from localStorage).
+     * Seeded data is shown as stale (`'cached'`) and revalidated like any hit.
+     */
+    seed?: () => T | undefined;
+}
 
 declare interface UseCachedFetchResult<T> {
     data: T | undefined;
@@ -302,8 +311,10 @@ declare interface UseCachedFetchResult<T> {
 
 /**
  * Fetch events from one or more calendars for a date range, with in-memory
- * (per-card) caching and stale-while-revalidate behavior. Events are tagged
- * with their source calendar ID. Returns `prefetch` to warm adjacent ranges.
+ * (per-card) caching and stale-while-revalidate behavior. Each calendar's
+ * events are also persisted to localStorage per entity, so a reload renders
+ * immediately. Events are tagged with their source calendar ID. Returns
+ * `prefetch` to warm adjacent ranges.
  */
 export declare function useCalendarEvents(entityIds: `calendar.${string}`[], options: {
     start: Date;
@@ -345,6 +356,7 @@ export declare function useDarkMode(): boolean;
  *   - 'calendar.xyz' -> CalendarEntity
  *   - 'weather.xyz' -> WeatherEntity
  *   - 'sun.sun'     -> SunEntity
+ *   - 'fan.xyz'     -> FanEntity
  *   - other domains -> HassEntity (fallback)
  */
 export declare function useEntity<T extends string>(entityId: T): EntityForId<T> | undefined;
@@ -416,8 +428,9 @@ export declare function useResizeObserver<T extends HTMLElement>(ref: RefObject<
 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).
+ * Fetch weather forecast data, cached in memory and persisted to localStorage
+ * so a reload renders immediately. Auto-refetches at the top of each hour and
+ * when the underlying entity changes (debounced).
  */
 export declare function useWeatherForecast(entityId: `weather.${string}`, type: ForecastType): UseWeatherForecastResult;
 

package/dist/index.js

@@ -7,6 +7,97 @@ function readCache(cache, key) {
 function writeCache(cache, key, data) {
   cache.set(key, { data });
 }
+const NAMESPACE = "preact-ha:";
+const PREFIX = "preact-ha:v2:";
+const MAX_AGE_MS = 3 * 24 * 60 * 60 * 1e3;
+const MAX_ENTRIES = 60;
+let swept = false;
+function storage() {
+  try {
+    return globalThis.localStorage ?? void 0;
+  } catch {
+    return void 0;
+  }
+}
+function timesOf(raw) {
+  if (!raw) return void 0;
+  try {
+    const value = JSON.parse(raw);
+    const saved = typeof value?.s === "number" ? value.s : value?.timestamp;
+    if (typeof saved !== "number") return void 0;
+    return { saved, used: typeof value.u === "number" ? value.u : saved };
+  } catch {
+    return void 0;
+  }
+}
+function namespaceKeys(ls) {
+  const keys = [];
+  for (let i = 0; i < ls.length; i++) {
+    const key = ls.key(i);
+    if (key?.startsWith(NAMESPACE)) keys.push(key);
+  }
+  return keys;
+}
+function entriesByUse(ls) {
+  return namespaceKeys(ls).map((key) => ({ key, used: timesOf(ls.getItem(key))?.used ?? 0 })).sort((a, b) => a.used - b.used);
+}
+function evictOverCap(ls) {
+  const count = namespaceKeys(ls).length;
+  if (count <= MAX_ENTRIES) return;
+  const entries = entriesByUse(ls);
+  for (let i = 0; i < count - MAX_ENTRIES; i++) {
+    ls.removeItem(entries[i].key);
+  }
+}
+function sweep(ls) {
+  if (swept) return;
+  swept = true;
+  const now = Date.now();
+  for (const key of namespaceKeys(ls)) {
+    const times = timesOf(ls.getItem(key));
+    if (!times || now - times.saved > MAX_AGE_MS) ls.removeItem(key);
+  }
+  evictOverCap(ls);
+}
+function readPersisted(key) {
+  const ls = storage();
+  if (!ls) return void 0;
+  try {
+    sweep(ls);
+    const fullKey = PREFIX + key;
+    const raw = ls.getItem(fullKey);
+    if (!raw) return void 0;
+    const entry = JSON.parse(raw);
+    const now = Date.now();
+    if (typeof entry?.s !== "number" || now - entry.s > MAX_AGE_MS) {
+      ls.removeItem(fullKey);
+      return void 0;
+    }
+    entry.u = now;
+    ls.setItem(fullKey, JSON.stringify(entry));
+    return entry.d;
+  } catch {
+    return void 0;
+  }
+}
+function writePersisted(key, data) {
+  const ls = storage();
+  if (!ls) return;
+  const now = Date.now();
+  const value = JSON.stringify({ d: data, s: now, u: now });
+  try {
+    sweep(ls);
+    ls.setItem(PREFIX + key, value);
+    evictOverCap(ls);
+  } catch {
+    try {
+      const oldest = entriesByUse(ls)[0];
+      if (oldest) ls.removeItem(oldest.key);
+      ls.setItem(PREFIX + key, value);
+    } catch {
+    }
+  }
+}
 function useCallbackStable(callback) {
   const callbackRef = useRef(callback);
   callbackRef.current = callback;
@@ -104,9 +195,10 @@ function useService(entityId) {
     return hass.callService(domain, service, { entity_id: entityId, ...data });
   }));
 }
-function useCachedFetch(cacheKey, fetcher, deps) {
+function useCachedFetch(cacheKey, fetcher, deps, options = {}) {
   const store = useHAStore();
-  const [data, setData] = useState(() => readCache(store.cache, cacheKey));
+  const readCached = () => readCache(store.cache, cacheKey) ?? options.seed?.();
+  const [data, setData] = useState(readCached);
   const [isFresh, setIsFresh] = useState(false);
   const [isFetching, setIsFetching] = useState(false);
   const [error, setError] = useState(void 0);
@@ -115,7 +207,7 @@ function useCachedFetch(cacheKey, fetcher, deps) {
     dataKeyRef.current = cacheKey;
     setIsFresh(false);
     setError(void 0);
-    const cached = readCache(store.cache, cacheKey);
+    const cached = readCached();
     if (cached !== void 0) setData(cached);
   }
   const fetchIdRef = useRef(0);
@@ -170,14 +262,18 @@ function useWeatherForecast(entityId, type) {
       target: { entity_id: entityId },
       return_response: true
     });
-    return result.response?.[entityId]?.forecast ?? [];
+    const forecast2 = result.response?.[entityId]?.forecast ?? [];
+    writePersisted(cacheKey, forecast2);
+    return forecast2;
   });
   const {
     data: forecast,
     status,
     error,
     refetch
-  } = useCachedFetch(cacheKey, fetcher, [entityId, type]);
+  } = useCachedFetch(cacheKey, fetcher, [entityId, type], {
+    seed: () => readPersisted(cacheKey)
+  });
   const debouncedRefetch = useCallbackStable(() => {
     if (debounceTimerRef.current) {
       clearTimeout(debounceTimerRef.current);
@@ -435,6 +531,19 @@ function HACard({ align = "top", class: className, children }) {
 function calendarEventsCacheKey(entityIds, range) {
   return `events:${entityIds.join(",")}:${range.start.getTime()}-${range.end.getTime()}`;
 }
+function entityEventsPersistKey(entityId, range) {
+  return `events:${entityId}:${range.start.getTime()}-${range.end.getTime()}`;
+}
+function readPersistedRange(entityIds, range) {
+  if (entityIds.length === 0) return void 0;
+  const result = [];
+  for (const entityId of entityIds) {
+    const events = readPersisted(entityEventsPersistKey(entityId, range));
+    if (!events) return void 0;
+    for (const event of events) result.push({ ...event, calendarId: entityId });
+  }
+  return result;
+}
 function apiDateString(value) {
   return value.dateTime ?? value.date ?? "";
 }
@@ -480,6 +589,7 @@ async function fetchCalendarRange(hass, entityIds, range) {
     entityIds.map(async (entityId) => {
       try {
         const calendarEvents = hass.callApi ? await fetchEntityEventsRest(hass, entityId, range) : await fetchEntityEventsWs(hass, entityId, range);
+        writePersisted(entityEventsPersistKey(entityId, range), calendarEvents);
         return calendarEvents.map(
           (event) => ({ ...event, calendarId: entityId })
         );
@@ -504,7 +614,9 @@ function useCalendarEvents(entityIds, options) {
     status,
     error,
     refetch
-  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey]);
+  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey], {
+    seed: () => readPersistedRange(entityIds, options)
+  });
   const prefetch = useCallbackStable((range) => {
     const key = calendarEventsCacheKey(entityIds, range);
     if (store.cache.has(key)) return;

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","../src/HACard.tsx","../src/calendars.ts","../src/useResizeObserver.ts","../src/useWidth.ts"],"sourcesContent":["// In-memory cache helpers. The cache Map is owned per-card by the HAProvider\n// store (see HAContext), so its lifetime matches the card and it is\n// garbage-collected when the card is torn down. There is intentionally no\n// persistence, TTL, or size cap: freshness comes from entity subscriptions and\n// periodic refetch, not from cache expiry, and growth is bounded by the ranges\n// a single card visits in a session.\n\nexport interface CacheEntry<T> {\n  data: T;\n}\n\nexport type Cache = Map<string, CacheEntry<unknown>>;\n\nexport function readCache<T>(cache: Cache, key: string): T | undefined {\n  return (cache.get(key) as CacheEntry<T> | undefined)?.data;\n}\n\nexport function writeCache<T>(cache: Cache, key: string, data: T): void {\n  cache.set(key, { data });\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 { type Cache, readCache, writeCache } from './cacheUtils';\nimport type {\n  EntityForId,\n  FetchStatus,\n  ForecastType,\n  HomeAssistant,\n  ServicesForId,\n  WeatherForecast,\n} from './types';\nimport { useCallbackStable } from './useCallbackStable';\n\ntype SubscribeToHass = (callback: () => void) => () => void;\n\n// Default for providers that don't wire up hass-value notifications (Storybook,\n// tests). useHassValue then simply returns its initial value and never updates.\nconst noopSubscribeToHass: SubscribeToHass = () => () => {};\n\ninterface HAStore {\n  getHass: () => HomeAssistant | undefined;\n  subscribeToEntity: (entityId: string, callback: (entity: any) => void) => () => void;\n  subscribeToHass: SubscribeToHass;\n  // Per-card cache (events, forecasts, entities). Owned by the provider so its\n  // lifetime is the card's — GC'd with the store when the card is torn down.\n  cache: Cache;\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  subscribeToHass?: SubscribeToHass;\n  // Optional injected cache (tests seed/inspect it); defaults to a fresh\n  // per-provider Map held stable across re-renders.\n  cache?: Cache;\n  children: ComponentChildren;\n}\n\nexport function HAProvider({\n  hass,\n  subscribeToEntity,\n  subscribeToHass,\n  cache,\n  children,\n}: HAProviderProps) {\n  const hassRef = useRef(hass);\n  hassRef.current = hass;\n\n  const getHass = useCallbackStable(() => hassRef.current);\n\n  const cacheRef = useRef<Cache>();\n  if (!cacheRef.current) cacheRef.current = cache ?? new Map();\n\n  const resolvedSubscribeToHass = subscribeToHass ?? noopSubscribeToHass;\n\n  const store = useMemo<HAStore>(\n    () => ({\n      getHass,\n      subscribeToEntity,\n      subscribeToHass: resolvedSubscribeToHass,\n      cache: cacheRef.current!,\n    }),\n    [getHass, subscribeToEntity, resolvedSubscribeToHass],\n  );\n\n  return <HAContext.Provider value={store}>{children}</HAContext.Provider>;\n}\n\n/** Internal accessor for the provider store (cache, subscriptions). Not part of the public API. */\nexport function 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.getHass()?.states[entityId] as EntityForId<T> | undefined;\n    if (current) return current;\n    return readCache<EntityForId<T>>(store.cache, cacheKey);\n  });\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToEntity(entityId, (newEntity) => {\n      setEntity(newEntity as EntityForId<T>);\n      writeCache(store.cache, cacheKey, newEntity);\n    });\n    return unsubscribe;\n  }, [entityId, store.subscribeToEntity, store.cache, 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\n/**\n * Subscribe to a derived slice of the `hass` object (e.g. config, themes) and\n * re-render only when that slice changes. Use this for non-entity values —\n * entity state goes through `useEntity`. The selector runs on every hass update\n * but only re-renders the consumer when `isEqual` reports a change, so it's\n * cheap for rarely-changing values like config/themes.\n */\nexport function useHassValue<T>(\n  selector: (hass: HomeAssistant | undefined) => T,\n  isEqual: (a: T, b: T) => boolean = Object.is,\n): T {\n  const store = useHAStore();\n\n  const selectorRef = useRef(selector);\n  selectorRef.current = selector;\n  const isEqualRef = useRef(isEqual);\n  isEqualRef.current = isEqual;\n\n  const [value, setValue] = useState<T>(() => selectorRef.current(store.getHass()));\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToHass(() => {\n      const next = selectorRef.current(store.getHass());\n      setValue((prev) => (isEqualRef.current(prev, next) ? prev : next));\n    });\n    return unsubscribe;\n  }, [store.subscribeToHass, store.getHass]);\n\n  return value;\n}\n\n/** Re-renders when `hass.config` changes (units, latitude/longitude, etc.). */\nexport function useHassConfig(): HomeAssistant['config'] | undefined {\n  return useHassValue((hass) => hass?.config);\n}\n\n/** Re-renders when the active theme's dark mode flips. */\nexport function useDarkMode(): boolean {\n  return useHassValue((hass) => hass?.themes?.darkMode ?? false);\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 store = useHAStore();\n  const [data, setData] = useState<T | undefined>(() => readCache<T>(store.cache, cacheKey));\n  const [isFresh, setIsFresh] = useState(false);\n  const [isFetching, setIsFetching] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  // Stale-while-revalidate, key-change aware. When `cacheKey` changes we swap to\n  // the new key's cached value synchronously (SWR hit) or keep the previously\n  // rendered data (keep-previous-data on a cold key) — never blanking to a\n  // loading state. The `deps` effect below issues the background refetch; the\n  // only `'loading'` state is a true cold start (nothing cached, nothing fetched).\n  const dataKeyRef = useRef(cacheKey);\n  if (cacheKey !== dataKeyRef.current) {\n    dataKeyRef.current = cacheKey;\n    setIsFresh(false);\n    setError(undefined);\n    const cached = readCache<T>(store.cache, cacheKey);\n    if (cached !== undefined) setData(cached);\n    // cache miss: leave `data` as-is (keep-previous-data)\n  }\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        writeCache(store.cache, 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  }, 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 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\n// Grace period before a disconnected card is torn down. HA detaches and\n// re-attaches cards transiently (scroll virtualization, edit mode); only a card\n// that stays gone past this window is genuinely removed, so we defer the\n// Preact unmount — and the effect cleanups it triggers (timers, subscriptions)\n// — until then. A reconnect within the window cancels the teardown.\nconst TEARDOWN_GRACE_MS = 5000;\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  // Shared host-element plumbing: config/hass storage, connect/disconnect\n  // lifecycle, deferred teardown, and the render skeleton. Subclasses supply\n  // the render root and the tree to render, and may override hass behavior.\n  abstract class BaseHACard extends HTMLElement {\n    protected _hass?: HomeAssistant;\n    protected _config?: TConfig;\n    private _teardownTimer?: ReturnType<typeof setTimeout>;\n\n    protected abstract _getRenderRoot(): Element | ShadowRoot;\n    protected abstract _renderTree(): void;\n    protected _renderUnconfigured(): void {}\n\n    connectedCallback() {\n      if (this._teardownTimer !== undefined) {\n        clearTimeout(this._teardownTimer);\n        this._teardownTimer = undefined;\n      }\n      this._maybeRenderOnConnect();\n    }\n\n    protected _maybeRenderOnConnect() {\n      if (this._hass && this._config) {\n        this._render();\n      }\n    }\n\n    disconnectedCallback() {\n      if (this._teardownTimer !== undefined) clearTimeout(this._teardownTimer);\n      this._teardownTimer = setTimeout(() => {\n        // Unmount the Preact tree, running effect cleanups (clears timers and\n        // entity subscriptions). Scheduled, never synchronous, so a transient\n        // disconnect+reconnect leaves the tree intact.\n        render(null, this._getRenderRoot());\n        this._teardownTimer = undefined;\n      }, TEARDOWN_GRACE_MS);\n    }\n\n    setConfig(config: TConfig) {\n      this._config = config;\n      if (this._hass && this.isConnected) {\n        this._render();\n      }\n    }\n\n    protected _render() {\n      if (!this._config || !this._hass) {\n        this._renderUnconfigured();\n        return;\n      }\n      this._renderTree();\n    }\n  }\n\n  class HACard extends BaseHACard {\n    private _shadowRoot: ShadowRoot;\n    private _entityChangeListeners = new Map<string, Set<(entity: any) => void>>();\n    private _hassChangeListeners = new Set<() => void>();\n\n    constructor() {\n      super();\n      this._shadowRoot = this.attachShadow({ mode: 'open' });\n    }\n\n    protected _getRenderRoot() {\n      return this._shadowRoot;\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      // Notify non-entity (config/themes) subscribers on every update. This does\n      // not re-render the whole card — useHassValue re-renders only its own\n      // consumer, and only when its selected slice actually changes.\n      this._hassChangeListeners.forEach((listener) => listener());\n\n      if (!prevStates && this._config && 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 _subscribeToHass = (callback: () => void) => {\n      this._hassChangeListeners.add(callback);\n      return () => {\n        this._hassChangeListeners.delete(callback);\n      };\n    };\n\n    protected _renderTree() {\n      render(\n        <HAProvider\n          hass={this._hass}\n          subscribeToEntity={this._subscribeToEntity}\n          subscribeToHass={this._subscribeToHass}\n        >\n          <style>{getAllStyles()}</style>\n          <Component config={this._config!} />\n        </HAProvider>,\n        this._shadowRoot,\n      );\n    }\n\n    protected _renderUnconfigured() {\n      if (UnconfiguredComponent) {\n        render(<UnconfiguredComponent />, this._shadowRoot);\n      }\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 BaseHACard {\n      protected _getRenderRoot() {\n        return this;\n      }\n\n      // The editor re-renders on every hass update: it passes `hass` straight to\n      // HA's <ha-form>/<ha-selector>, whose entity pickers need a fresh hass to\n      // stay current. (Unlike the card, which renders once then subscribes.)\n      set hass(hass: HomeAssistant) {\n        this._hass = hass;\n        this._render();\n      }\n\n      // Render whenever config arrives, regardless of connection — HA may set\n      // config/hass before connecting the editor element.\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      // Render to light DOM so HA's custom elements (ha-form etc.) work.\n      protected _renderTree() {\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","import { type ComponentChildren, createElement } from 'preact';\n\n// `align` controls how content sits within the height HA assigns. Friendly\n// aliases map to flex justify-content; any raw flex value also passes through.\n// Default 'top' keeps content compact at the top (today's look, but the card\n// box now fills the slot). Use 'center', 'bottom', or 'space-between' to spread.\nexport type HACardAlign =\n  | 'top'\n  | 'center'\n  | 'bottom'\n  | 'flex-start'\n  | 'flex-end'\n  | 'space-between'\n  | 'space-around'\n  | 'space-evenly';\n\nconst ALIGN_ALIASES: Record<string, string> = { top: 'flex-start', bottom: 'flex-end' };\n\ninterface HACardProps {\n  align?: HACardAlign;\n  class?: string;\n  children?: ComponentChildren;\n}\n\n// Drop-in replacement for a raw <ha-card> that fills the height Home Assistant\n// assigns. In the sections (grid) layout HA gives the card's host element a\n// definite height; a plain ha-card collapses to natural content height and\n// renders slightly short. HACard makes the host and ha-card fill that height\n// and flex-distributes content per `align`.\n//\n// `ha-card` is created via createElement (rather than as a JSX intrinsic) so\n// the component carries no dependency on consumers declaring it in their JSX\n// IntrinsicElements — it just works when imported.\nexport function HACard({ align = 'top', class: className, children }: HACardProps) {\n  const justify = ALIGN_ALIASES[align] ?? align;\n  return (\n    <>\n      {/* Host must have a definite height for ha-card's 100% to resolve. In\n          masonry/auto-row layouts the parent height is auto, so this safely\n          collapses back to natural height. */}\n      <style>{':host{display:block;height:100%;box-sizing:border-box;}'}</style>\n      {createElement(\n        'ha-card',\n        {\n          class: className,\n          style: {\n            height: '100%',\n            boxSizing: 'border-box',\n            display: 'flex',\n            flexDirection: 'column',\n            justifyContent: justify,\n          },\n        },\n        children,\n      )}\n    </>\n  );\n}\n","import { useEffect, useRef } from 'preact/hooks';\n\nimport { useCachedFetch, useHAStore, useHass } from './HAContext';\nimport { writeCache } from './cacheUtils';\nimport type { CalendarEvent, CalendarEventWithSource, FetchStatus, HomeAssistant } from './types';\nimport { useCallbackStable } from './useCallbackStable';\n\ninterface UseCalendarEventsResult {\n  events: CalendarEventWithSource[] | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n  /**\n   * Warm the cache for an arbitrary range (e.g. adjacent months) without\n   * touching component state. Best-effort: skips ranges already cached and\n   * swallows failures.\n   */\n  prefetch: (range: { start: Date; end: Date }) => void;\n}\n\nfunction calendarEventsCacheKey(\n  entityIds: `calendar.${string}`[],\n  range: { start: Date; end: Date },\n): string {\n  return `events:${entityIds.join(',')}:${range.start.getTime()}-${range.end.getTime()}`;\n}\n\n/** Event shape returned by the REST view GET /api/calendars/{entity_id}. */\ninterface ApiCalendarEvent {\n  summary: string;\n  description?: string | null;\n  location?: string | null;\n  uid?: string | null;\n  recurrence_id?: string | null;\n  rrule?: string | null;\n  start: { dateTime?: string; date?: string };\n  end: { dateTime?: string; date?: string };\n}\n\n/** Flatten the REST API's {dateTime}/{date} start/end into our string form. */\nfunction apiDateString(value: { dateTime?: string; date?: string }): string {\n  return value.dateTime ?? value.date ?? '';\n}\n\nasync function fetchEntityEventsRest(\n  hass: HomeAssistant,\n  entityId: `calendar.${string}`,\n  range: { start: Date; end: Date },\n): Promise<CalendarEvent[]> {\n  const query =\n    `start=${encodeURIComponent(range.start.toISOString())}` +\n    `&end=${encodeURIComponent(range.end.toISOString())}`;\n  const apiEvents = await hass.callApi!<ApiCalendarEvent[]>(\n    'GET',\n    `calendars/${entityId}?${query}`,\n  );\n  return apiEvents.map((event) => ({\n    start: apiDateString(event.start),\n    end: apiDateString(event.end),\n    summary: event.summary,\n    ...(event.description != null && { description: event.description }),\n    ...(event.location != null && { location: event.location }),\n    ...(event.uid != null && { uid: event.uid }),\n    ...(event.recurrence_id != null && { recurrence_id: event.recurrence_id }),\n    ...(event.rrule != null && { rrule: event.rrule }),\n  }));\n}\n\nasync function fetchEntityEventsWs(\n  hass: HomeAssistant,\n  entityId: `calendar.${string}`,\n  range: { start: Date; end: Date },\n): Promise<CalendarEvent[]> {\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: range.start.toISOString(),\n      end_date_time: range.end.toISOString(),\n    },\n    target: { entity_id: entityId },\n    return_response: true,\n  });\n\n  return result.response?.[entityId]?.events ?? [];\n}\n\nasync function fetchCalendarRange(\n  hass: HomeAssistant | undefined,\n  entityIds: `calendar.${string}`[],\n  range: { start: Date; end: Date },\n): Promise<CalendarEventWithSource[]> {\n  if (!hass?.connection) {\n    throw new Error('Home Assistant connection not available');\n  }\n  if (entityIds.length === 0) {\n    return [];\n  }\n\n  const results = await Promise.all(\n    entityIds.map(async (entityId) => {\n      try {\n        // Prefer the REST view: unlike the calendar.get_events service\n        // response (filtered to LIST_EVENT_FIELDS in HA core), it includes\n        // uid/recurrence_id/rrule. The WS service call remains as a fallback\n        // for environments without callApi (test mocks, Storybook).\n        const calendarEvents = hass.callApi\n          ? await fetchEntityEventsRest(hass, entityId, range)\n          : await fetchEntityEventsWs(hass, entityId, range);\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/**\n * Fetch events from one or more calendars for a date range, with in-memory\n * (per-card) caching and stale-while-revalidate behavior. Events are tagged\n * with their source calendar ID. Returns `prefetch` to warm adjacent ranges.\n */\nexport function useCalendarEvents(\n  entityIds: `calendar.${string}`[],\n  options: { start: Date; end: Date },\n): UseCalendarEventsResult {\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(() => fetchCalendarRange(getHass(), entityIds, options));\n\n  const {\n    data: events,\n    status,\n    error,\n    refetch,\n  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey]);\n\n  const prefetch = useCallbackStable((range: { start: Date; end: Date }) => {\n    const key = calendarEventsCacheKey(entityIds, range);\n    if (store.cache.has(key)) return; // already warm\n    fetchCalendarRange(getHass(), entityIds, range)\n      .then((result) => writeCache(store.cache, key, result))\n      .catch(() => {\n        // best-effort prefetch; ignore failures\n      });\n  });\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, prefetch };\n}\n\n/**\n * Event payload for the calendar mutation WebSocket commands. Dates are either\n * date-only strings (\"2026-07-17\", all-day) or ISO datetimes.\n */\nexport interface CalendarMutationEvent {\n  dtstart: string;\n  dtend: string;\n  summary: string;\n  description?: string;\n  location?: string;\n  rrule?: string;\n}\n\nfunction requireConnection(hass: HomeAssistant | undefined): HomeAssistant {\n  if (!hass?.connection) {\n    throw new Error('Home Assistant connection not available');\n  }\n  return hass;\n}\n\n/**\n * Create an event on a calendar that supports mutation (e.g. Local Calendar).\n * Requires entity control permission, not admin. WS errors reject unchanged so\n * callers can inspect `err.code` (e.g. 'unauthorized').\n */\nexport async function createCalendarEvent(\n  hass: HomeAssistant | undefined,\n  entityId: `calendar.${string}`,\n  event: CalendarMutationEvent,\n): Promise<void> {\n  await requireConnection(hass).connection.sendMessagePromise({\n    type: 'calendar/event/create',\n    entity_id: entityId,\n    event,\n  });\n}\n\n/** Delete a calendar event by its uid. */\nexport async function deleteCalendarEvent(\n  hass: HomeAssistant | undefined,\n  entityId: `calendar.${string}`,\n  uid: string,\n  opts?: { recurrenceId?: string; recurrenceRange?: string },\n): Promise<void> {\n  await requireConnection(hass).connection.sendMessagePromise({\n    type: 'calendar/event/delete',\n    entity_id: entityId,\n    uid,\n    ...(opts?.recurrenceId !== undefined && { recurrence_id: opts.recurrenceId }),\n    ...(opts?.recurrenceRange !== undefined && { recurrence_range: opts.recurrenceRange }),\n  });\n}\n\n/** Replace a calendar event's content by its uid. */\nexport async function updateCalendarEvent(\n  hass: HomeAssistant | undefined,\n  entityId: `calendar.${string}`,\n  uid: string,\n  event: CalendarMutationEvent,\n): Promise<void> {\n  await requireConnection(hass).connection.sendMessagePromise({\n    type: 'calendar/event/update',\n    entity_id: entityId,\n    uid,\n    event,\n  });\n}\n","import type { RefObject } from 'preact';\nimport { useEffect, useRef } from 'preact/hooks';\n\nexport interface ElementSize {\n  width: number;\n  height: number;\n}\n\nexport type ResizeCallback = (size: ElementSize) => void;\n\n/**\n * Observe an element's size via ResizeObserver. The callback fires:\n *\n *   1. Once after mount, with the element's current size.\n *   2. Whenever the element's size changes.\n *   3. Whenever `deps` change, re-firing with the current size — so callers\n *      can re-run draws when their inputs change without re-creating the\n *      observer.\n *\n * The callback is suppressed only while the element is detached from the\n * document. Zero width/height is delivered to the callback as-is — consumers\n * that need to skip degenerate sizes (e.g. canvas painters where a 0-sized\n * drawImage throws InvalidStateError) should add their own early return.\n *\n * Sizes are read from `offsetWidth` / `offsetHeight` (CSS pixels, includes\n * padding + border). The callback is held in a ref, so passing a fresh\n * function each render is safe — it never re-creates the observer.\n *\n * @example\n * const containerRef = useRef<HTMLDivElement>(null);\n * const canvasRef = useRef<HTMLCanvasElement>(null);\n *\n * useResizeObserver(\n *   containerRef,\n *   ({ width, height }) => {\n *     if (width === 0 || height === 0) return; // optional, consumer's call\n *     drawChart(canvasRef.current, forecast, width, height);\n *   },\n *   [forecast],\n * );\n */\nexport function useResizeObserver<T extends HTMLElement>(\n  ref: RefObject<T>,\n  callback: ResizeCallback,\n  deps: unknown[] = [],\n): void {\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  // Set up the observer once per element. ResizeObserver fires once\n  // synchronously-ish after `.observe()` with the current size, which\n  // covers the initial draw.\n  useEffect(() => {\n    const element = ref.current;\n    if (!element) return;\n\n    const fire = () => {\n      if (!element.isConnected) return;\n      callbackRef.current({\n        width: element.offsetWidth,\n        height: element.offsetHeight,\n      });\n    };\n\n    const observer = new ResizeObserver(fire);\n    observer.observe(element);\n    return () => observer.disconnect();\n    // ref identity is stable across renders; observer setup runs once.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // Re-fire on dependency change. Skip the first render — the observer's\n  // initial `.observe()` fire already delivers the mount-time size.\n  const isFirstRun = useRef(true);\n  useEffect(() => {\n    if (isFirstRun.current) {\n      isFirstRun.current = false;\n      return;\n    }\n    const element = ref.current;\n    if (!element || !element.isConnected) return;\n    callbackRef.current({\n      width: element.offsetWidth,\n      height: element.offsetHeight,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n}\n","import type { RefObject } from 'preact';\nimport { useState } from 'preact/hooks';\nimport { useResizeObserver } from './useResizeObserver';\n\n/**\n * Track the current width of a referenced element in CSS pixels.\n *\n * Returns `undefined` until the first non-zero measurement is observed, then\n * a positive number that updates as the element resizes. Once a real width\n * is captured the hook will never report `undefined` or `0` again, even\n * during HA layout transitions (dashboard switch, edit-mode toggle) — the\n * underlying ResizeObserver firings are silently dropped while the element\n * is detached or transiently zero-width, so the component renders with the\n * last good value instead of flashing through a degenerate state.\n *\n * Use this when you need a width value in JSX (responsive layout, prop to a\n * sized child). If you only need the value imperatively inside a draw\n * callback, prefer `useResizeObserver` directly — it doesn't allocate\n * component state or cause re-renders.\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const width = useWidth(ref);\n * return (\n *   <div ref={ref}>\n *     {width !== undefined && <Chart width={width} />}\n *   </div>\n * );\n */\nexport function useWidth<T extends HTMLElement>(ref: RefObject<T>): number | undefined {\n  const [width, setWidth] = useState<number | undefined>(undefined);\n  useResizeObserver(ref, (size) => {\n    if (size.width === 0) return;\n    setWidth((prev) => (prev === size.width ? prev : size.width));\n  });\n  return width;\n}\n"],"names":["HACard"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/cacheUtils.ts","../src/persistentCache.ts","../src/useCallbackStable.ts","../src/HAContext.tsx","../src/styleRegistry.ts","../src/registerPreactCard.tsx","../src/HACard.tsx","../src/calendars.ts","../src/useResizeObserver.ts","../src/useWidth.ts"],"sourcesContent":["// In-memory cache helpers. The cache Map is owned per-card by the HAProvider\n// store (see HAContext), so its lifetime matches the card and it is\n// garbage-collected when the card is torn down. There is intentionally no TTL\n// or size cap here: freshness comes from entity subscriptions and periodic\n// refetch, not from cache expiry, and growth is bounded by the ranges a single\n// card visits in a session. Cross-reload persistence (with expiry) lives in\n// persistentCache.ts and only seeds this cache on a miss.\n\nexport interface CacheEntry<T> {\n  data: T;\n}\n\nexport type Cache = Map<string, CacheEntry<unknown>>;\n\nexport function readCache<T>(cache: Cache, key: string): T | undefined {\n  return (cache.get(key) as CacheEntry<T> | undefined)?.data;\n}\n\nexport function writeCache<T>(cache: Cache, key: string, data: T): void {\n  cache.set(key, { data });\n}\n","// localStorage persistence beneath the per-card in-memory cache. It only seeds\n// a cold start: persisted data is always shown as stale ('cached') and then\n// revalidated, so expiry here bounds storage rather than guaranteeing freshness.\n//\n// Every card built on this library bundles its own copy, and they all share one\n// localStorage. Housekeeping therefore covers the whole `preact-ha:` NAMESPACE,\n// not just this version's PREFIX, so data left by a deleted card (or a card on\n// another library version) still expires as long as any preact-ha card loads.\n//\n// - Entries older than MAX_AGE_MS are dropped (never shown).\n// - At most MAX_ENTRIES are kept namespace-wide; least-recently-used go first.\n// - The first access per page sweeps expired and unrecognizable entries.\n// - The versioned PREFIX scopes what this version *reads*; bumping it makes old\n//   entries unreadable to new code, and they then age out via the sweep.\n// - Quota errors evict the oldest entry and retry once, then give up silently.\n//\n// Cross-version contract — keep stable in all future versions: every value under\n// NAMESPACE is JSON with numeric `s` (saved at, ms) and `u` (last used, ms).\n// Pre-0.3 entries ({ data, timestamp }) are understood via `timestamp`.\n\nconst NAMESPACE = 'preact-ha:';\nconst PREFIX = 'preact-ha:v2:';\nexport const MAX_AGE_MS = 3 * 24 * 60 * 60 * 1000;\nexport const MAX_ENTRIES = 60;\n\ninterface PersistedEntry<T> {\n  /** data */\n  d: T;\n  /** saved at (ms) */\n  s: number;\n  /** last used (ms) */\n  u: number;\n}\n\ninterface EntryTimes {\n  saved: number;\n  used: number;\n}\n\nlet swept = false;\n\nfunction storage(): Storage | undefined {\n  try {\n    return globalThis.localStorage ?? undefined;\n  } catch {\n    // Access can throw (sandboxed iframes, disabled storage)\n    return undefined;\n  }\n}\n\n/** Timestamps from any version's entry; undefined if unrecognizable. */\nfunction timesOf(raw: string | null): EntryTimes | undefined {\n  if (!raw) return undefined;\n  try {\n    const value = JSON.parse(raw);\n    const saved = typeof value?.s === 'number' ? value.s : value?.timestamp;\n    if (typeof saved !== 'number') return undefined;\n    return { saved, used: typeof value.u === 'number' ? value.u : saved };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction namespaceKeys(ls: Storage): string[] {\n  const keys: string[] = [];\n  for (let i = 0; i < ls.length; i++) {\n    const key = ls.key(i);\n    if (key?.startsWith(NAMESPACE)) keys.push(key);\n  }\n  return keys;\n}\n\n/** Namespace entries, least recently used first. */\nfunction entriesByUse(ls: Storage): { key: string; used: number }[] {\n  return namespaceKeys(ls)\n    .map((key) => ({ key, used: timesOf(ls.getItem(key))?.used ?? 0 }))\n    .sort((a, b) => a.used - b.used);\n}\n\nfunction evictOverCap(ls: Storage): void {\n  // Cheap key count first; only parse entries when we actually need to evict.\n  const count = namespaceKeys(ls).length;\n  if (count <= MAX_ENTRIES) return;\n  const entries = entriesByUse(ls);\n  for (let i = 0; i < count - MAX_ENTRIES; i++) {\n    ls.removeItem(entries[i].key);\n  }\n}\n\n/** Drop expired and unrecognizable entries namespace-wide, then enforce the cap. Once per page. */\nfunction sweep(ls: Storage): void {\n  if (swept) return;\n  swept = true;\n  const now = Date.now();\n  for (const key of namespaceKeys(ls)) {\n    const times = timesOf(ls.getItem(key));\n    if (!times || now - times.saved > MAX_AGE_MS) ls.removeItem(key);\n  }\n  evictOverCap(ls);\n}\n\nexport function readPersisted<T>(key: string): T | undefined {\n  const ls = storage();\n  if (!ls) return undefined;\n  try {\n    sweep(ls);\n    const fullKey = PREFIX + key;\n    const raw = ls.getItem(fullKey);\n    if (!raw) return undefined;\n    const entry = JSON.parse(raw) as PersistedEntry<T>;\n    const now = Date.now();\n    if (typeof entry?.s !== 'number' || now - entry.s > MAX_AGE_MS) {\n      ls.removeItem(fullKey);\n      return undefined;\n    }\n    entry.u = now;\n    ls.setItem(fullKey, JSON.stringify(entry));\n    return entry.d;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function writePersisted<T>(key: string, data: T): void {\n  const ls = storage();\n  if (!ls) return;\n  const now = Date.now();\n  const value = JSON.stringify({ d: data, s: now, u: now } satisfies PersistedEntry<T>);\n  try {\n    sweep(ls);\n    ls.setItem(PREFIX + key, value);\n    evictOverCap(ls);\n  } catch {\n    // Most likely quota exceeded: free the oldest entry and retry once.\n    try {\n      const oldest = entriesByUse(ls)[0];\n      if (oldest) ls.removeItem(oldest.key);\n      ls.setItem(PREFIX + key, value);\n    } catch {\n      // Give up; the in-memory cache still works.\n    }\n  }\n}\n\n/** Test hook: forget that the startup sweep ran. */\nexport function resetPersistedSweep(): void {\n  swept = false;\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 { type Cache, readCache, writeCache } from './cacheUtils';\nimport { readPersisted, writePersisted } from './persistentCache';\nimport type {\n  EntityForId,\n  FetchStatus,\n  ForecastType,\n  HomeAssistant,\n  ServicesForId,\n  WeatherForecast,\n} from './types';\nimport { useCallbackStable } from './useCallbackStable';\n\ntype SubscribeToHass = (callback: () => void) => () => void;\n\n// Default for providers that don't wire up hass-value notifications (Storybook,\n// tests). useHassValue then simply returns its initial value and never updates.\nconst noopSubscribeToHass: SubscribeToHass = () => () => {};\n\ninterface HAStore {\n  getHass: () => HomeAssistant | undefined;\n  subscribeToEntity: (entityId: string, callback: (entity: any) => void) => () => void;\n  subscribeToHass: SubscribeToHass;\n  // Per-card cache (events, forecasts, entities). Owned by the provider so its\n  // lifetime is the card's — GC'd with the store when the card is torn down.\n  cache: Cache;\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  subscribeToHass?: SubscribeToHass;\n  // Optional injected cache (tests seed/inspect it); defaults to a fresh\n  // per-provider Map held stable across re-renders.\n  cache?: Cache;\n  children: ComponentChildren;\n}\n\nexport function HAProvider({\n  hass,\n  subscribeToEntity,\n  subscribeToHass,\n  cache,\n  children,\n}: HAProviderProps) {\n  const hassRef = useRef(hass);\n  hassRef.current = hass;\n\n  const getHass = useCallbackStable(() => hassRef.current);\n\n  const cacheRef = useRef<Cache>();\n  if (!cacheRef.current) cacheRef.current = cache ?? new Map();\n\n  const resolvedSubscribeToHass = subscribeToHass ?? noopSubscribeToHass;\n\n  const store = useMemo<HAStore>(\n    () => ({\n      getHass,\n      subscribeToEntity,\n      subscribeToHass: resolvedSubscribeToHass,\n      cache: cacheRef.current!,\n    }),\n    [getHass, subscribeToEntity, resolvedSubscribeToHass],\n  );\n\n  return <HAContext.Provider value={store}>{children}</HAContext.Provider>;\n}\n\n/** Internal accessor for the provider store (cache, subscriptions). Not part of the public API. */\nexport function 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 *   - 'fan.xyz'     -> FanEntity\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.getHass()?.states[entityId] as EntityForId<T> | undefined;\n    if (current) return current;\n    return readCache<EntityForId<T>>(store.cache, cacheKey);\n  });\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToEntity(entityId, (newEntity) => {\n      setEntity(newEntity as EntityForId<T>);\n      writeCache(store.cache, cacheKey, newEntity);\n    });\n    return unsubscribe;\n  }, [entityId, store.subscribeToEntity, store.cache, 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\n/**\n * Subscribe to a derived slice of the `hass` object (e.g. config, themes) and\n * re-render only when that slice changes. Use this for non-entity values —\n * entity state goes through `useEntity`. The selector runs on every hass update\n * but only re-renders the consumer when `isEqual` reports a change, so it's\n * cheap for rarely-changing values like config/themes.\n */\nexport function useHassValue<T>(\n  selector: (hass: HomeAssistant | undefined) => T,\n  isEqual: (a: T, b: T) => boolean = Object.is,\n): T {\n  const store = useHAStore();\n\n  const selectorRef = useRef(selector);\n  selectorRef.current = selector;\n  const isEqualRef = useRef(isEqual);\n  isEqualRef.current = isEqual;\n\n  const [value, setValue] = useState<T>(() => selectorRef.current(store.getHass()));\n\n  useEffect(() => {\n    const unsubscribe = store.subscribeToHass(() => {\n      const next = selectorRef.current(store.getHass());\n      setValue((prev) => (isEqualRef.current(prev, next) ? prev : next));\n    });\n    return unsubscribe;\n  }, [store.subscribeToHass, store.getHass]);\n\n  return value;\n}\n\n/** Re-renders when `hass.config` changes (units, latitude/longitude, etc.). */\nexport function useHassConfig(): HomeAssistant['config'] | undefined {\n  return useHassValue((hass) => hass?.config);\n}\n\n/** Re-renders when the active theme's dark mode flips. */\nexport function useDarkMode(): boolean {\n  return useHassValue((hass) => hass?.themes?.darkMode ?? false);\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\ninterface UseCachedFetchOptions<T> {\n  /**\n   * Fallback read when the in-memory cache misses (e.g. from localStorage).\n   * Seeded data is shown as stale (`'cached'`) and revalidated like any hit.\n   */\n  seed?: () => T | undefined;\n}\n\n/**\n * Generic hook for fetching data with in-memory caching (optionally seeded from\n * a persistent store). Returns a cache-aware status string to distinguish cached\n * vs fresh data.\n */\nexport function useCachedFetch<T>(\n  cacheKey: string,\n  fetcher: () => Promise<T>,\n  deps: unknown[],\n  options: UseCachedFetchOptions<T> = {},\n): UseCachedFetchResult<T> {\n  const store = useHAStore();\n  const readCached = () => readCache<T>(store.cache, cacheKey) ?? options.seed?.();\n  const [data, setData] = useState<T | undefined>(readCached);\n  const [isFresh, setIsFresh] = useState(false);\n  const [isFetching, setIsFetching] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  // Stale-while-revalidate, key-change aware. When `cacheKey` changes we swap to\n  // the new key's cached value synchronously (SWR hit) or keep the previously\n  // rendered data (keep-previous-data on a cold key) — never blanking to a\n  // loading state. The `deps` effect below issues the background refetch; the\n  // only `'loading'` state is a true cold start (nothing cached, nothing fetched).\n  const dataKeyRef = useRef(cacheKey);\n  if (cacheKey !== dataKeyRef.current) {\n    dataKeyRef.current = cacheKey;\n    setIsFresh(false);\n    setError(undefined);\n    const cached = readCached();\n    if (cached !== undefined) setData(cached);\n    // cache miss: leave `data` as-is (keep-previous-data)\n  }\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        writeCache(store.cache, 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  }, 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 UseWeatherForecastResult {\n  forecast: WeatherForecast[] | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\n/**\n * Fetch weather forecast data, cached in memory and persisted to localStorage\n * so a reload renders immediately. Auto-refetches at the top of each hour and\n * 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    const forecast = result.response?.[entityId]?.forecast ?? [];\n    writePersisted(cacheKey, forecast);\n    return forecast;\n  });\n\n  const {\n    data: forecast,\n    status,\n    error,\n    refetch,\n  } = useCachedFetch(cacheKey, fetcher, [entityId, type], {\n    seed: () => readPersisted<WeatherForecast[]>(cacheKey),\n  });\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\n// Grace period before a disconnected card is torn down. HA detaches and\n// re-attaches cards transiently (scroll virtualization, edit mode); only a card\n// that stays gone past this window is genuinely removed, so we defer the\n// Preact unmount — and the effect cleanups it triggers (timers, subscriptions)\n// — until then. A reconnect within the window cancels the teardown.\nconst TEARDOWN_GRACE_MS = 5000;\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  // Shared host-element plumbing: config/hass storage, connect/disconnect\n  // lifecycle, deferred teardown, and the render skeleton. Subclasses supply\n  // the render root and the tree to render, and may override hass behavior.\n  abstract class BaseHACard extends HTMLElement {\n    protected _hass?: HomeAssistant;\n    protected _config?: TConfig;\n    private _teardownTimer?: ReturnType<typeof setTimeout>;\n\n    protected abstract _getRenderRoot(): Element | ShadowRoot;\n    protected abstract _renderTree(): void;\n    protected _renderUnconfigured(): void {}\n\n    connectedCallback() {\n      if (this._teardownTimer !== undefined) {\n        clearTimeout(this._teardownTimer);\n        this._teardownTimer = undefined;\n      }\n      this._maybeRenderOnConnect();\n    }\n\n    protected _maybeRenderOnConnect() {\n      if (this._hass && this._config) {\n        this._render();\n      }\n    }\n\n    disconnectedCallback() {\n      if (this._teardownTimer !== undefined) clearTimeout(this._teardownTimer);\n      this._teardownTimer = setTimeout(() => {\n        // Unmount the Preact tree, running effect cleanups (clears timers and\n        // entity subscriptions). Scheduled, never synchronous, so a transient\n        // disconnect+reconnect leaves the tree intact.\n        render(null, this._getRenderRoot());\n        this._teardownTimer = undefined;\n      }, TEARDOWN_GRACE_MS);\n    }\n\n    setConfig(config: TConfig) {\n      this._config = config;\n      if (this._hass && this.isConnected) {\n        this._render();\n      }\n    }\n\n    protected _render() {\n      if (!this._config || !this._hass) {\n        this._renderUnconfigured();\n        return;\n      }\n      this._renderTree();\n    }\n  }\n\n  class HACard extends BaseHACard {\n    private _shadowRoot: ShadowRoot;\n    private _entityChangeListeners = new Map<string, Set<(entity: any) => void>>();\n    private _hassChangeListeners = new Set<() => void>();\n\n    constructor() {\n      super();\n      this._shadowRoot = this.attachShadow({ mode: 'open' });\n    }\n\n    protected _getRenderRoot() {\n      return this._shadowRoot;\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      // Notify non-entity (config/themes) subscribers on every update. This does\n      // not re-render the whole card — useHassValue re-renders only its own\n      // consumer, and only when its selected slice actually changes.\n      this._hassChangeListeners.forEach((listener) => listener());\n\n      if (!prevStates && this._config && 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 _subscribeToHass = (callback: () => void) => {\n      this._hassChangeListeners.add(callback);\n      return () => {\n        this._hassChangeListeners.delete(callback);\n      };\n    };\n\n    protected _renderTree() {\n      render(\n        <HAProvider\n          hass={this._hass}\n          subscribeToEntity={this._subscribeToEntity}\n          subscribeToHass={this._subscribeToHass}\n        >\n          <style>{getAllStyles()}</style>\n          <Component config={this._config!} />\n        </HAProvider>,\n        this._shadowRoot,\n      );\n    }\n\n    protected _renderUnconfigured() {\n      if (UnconfiguredComponent) {\n        render(<UnconfiguredComponent />, this._shadowRoot);\n      }\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 BaseHACard {\n      protected _getRenderRoot() {\n        return this;\n      }\n\n      // The editor re-renders on every hass update: it passes `hass` straight to\n      // HA's <ha-form>/<ha-selector>, whose entity pickers need a fresh hass to\n      // stay current. (Unlike the card, which renders once then subscribes.)\n      set hass(hass: HomeAssistant) {\n        this._hass = hass;\n        this._render();\n      }\n\n      // Render whenever config arrives, regardless of connection — HA may set\n      // config/hass before connecting the editor element.\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      // Render to light DOM so HA's custom elements (ha-form etc.) work.\n      protected _renderTree() {\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","import { type ComponentChildren, createElement } from 'preact';\n\n// `align` controls how content sits within the height HA assigns. Friendly\n// aliases map to flex justify-content; any raw flex value also passes through.\n// Default 'top' keeps content compact at the top (today's look, but the card\n// box now fills the slot). Use 'center', 'bottom', or 'space-between' to spread.\nexport type HACardAlign =\n  | 'top'\n  | 'center'\n  | 'bottom'\n  | 'flex-start'\n  | 'flex-end'\n  | 'space-between'\n  | 'space-around'\n  | 'space-evenly';\n\nconst ALIGN_ALIASES: Record<string, string> = { top: 'flex-start', bottom: 'flex-end' };\n\ninterface HACardProps {\n  align?: HACardAlign;\n  class?: string;\n  children?: ComponentChildren;\n}\n\n// Drop-in replacement for a raw <ha-card> that fills the height Home Assistant\n// assigns. In the sections (grid) layout HA gives the card's host element a\n// definite height; a plain ha-card collapses to natural content height and\n// renders slightly short. HACard makes the host and ha-card fill that height\n// and flex-distributes content per `align`.\n//\n// `ha-card` is created via createElement (rather than as a JSX intrinsic) so\n// the component carries no dependency on consumers declaring it in their JSX\n// IntrinsicElements — it just works when imported.\nexport function HACard({ align = 'top', class: className, children }: HACardProps) {\n  const justify = ALIGN_ALIASES[align] ?? align;\n  return (\n    <>\n      {/* Host must have a definite height for ha-card's 100% to resolve. In\n          masonry/auto-row layouts the parent height is auto, so this safely\n          collapses back to natural height. */}\n      <style>{':host{display:block;height:100%;box-sizing:border-box;}'}</style>\n      {createElement(\n        'ha-card',\n        {\n          class: className,\n          style: {\n            height: '100%',\n            boxSizing: 'border-box',\n            display: 'flex',\n            flexDirection: 'column',\n            justifyContent: justify,\n          },\n        },\n        children,\n      )}\n    </>\n  );\n}\n","import { useEffect, useRef } from 'preact/hooks';\n\nimport { useCachedFetch, useHAStore, useHass } from './HAContext';\nimport { writeCache } from './cacheUtils';\nimport { readPersisted, writePersisted } from './persistentCache';\nimport type { CalendarEvent, CalendarEventWithSource, FetchStatus, HomeAssistant } from './types';\nimport { useCallbackStable } from './useCallbackStable';\n\ninterface UseCalendarEventsResult {\n  events: CalendarEventWithSource[] | undefined;\n  status: FetchStatus;\n  error: Error | undefined;\n  refetch: () => void;\n  /**\n   * Warm the cache for an arbitrary range (e.g. adjacent months) without\n   * touching component state. Best-effort: skips ranges already cached and\n   * swallows failures.\n   */\n  prefetch: (range: { start: Date; end: Date }) => void;\n}\n\nfunction calendarEventsCacheKey(\n  entityIds: `calendar.${string}`[],\n  range: { start: Date; end: Date },\n): string {\n  return `events:${entityIds.join(',')}:${range.start.getTime()}-${range.end.getTime()}`;\n}\n\n/**\n * Persistent (localStorage) key for one calendar's events over a range. Stored\n * per entity rather than per entity set, so any combination of calendars —\n * across cards, or the same card's regular vs highlight calendars — shares it.\n */\nfunction entityEventsPersistKey(\n  entityId: `calendar.${string}`,\n  range: { start: Date; end: Date },\n): string {\n  return `events:${entityId}:${range.start.getTime()}-${range.end.getTime()}`;\n}\n\n/** Assemble a range from persisted per-entity entries; undefined unless all are present. */\nfunction readPersistedRange(\n  entityIds: `calendar.${string}`[],\n  range: { start: Date; end: Date },\n): CalendarEventWithSource[] | undefined {\n  if (entityIds.length === 0) return undefined;\n  const result: CalendarEventWithSource[] = [];\n  for (const entityId of entityIds) {\n    const events = readPersisted<CalendarEvent[]>(entityEventsPersistKey(entityId, range));\n    if (!events) return undefined;\n    for (const event of events) result.push({ ...event, calendarId: entityId });\n  }\n  return result;\n}\n\n/** Event shape returned by the REST view GET /api/calendars/{entity_id}. */\ninterface ApiCalendarEvent {\n  summary: string;\n  description?: string | null;\n  location?: string | null;\n  uid?: string | null;\n  recurrence_id?: string | null;\n  rrule?: string | null;\n  start: { dateTime?: string; date?: string };\n  end: { dateTime?: string; date?: string };\n}\n\n/** Flatten the REST API's {dateTime}/{date} start/end into our string form. */\nfunction apiDateString(value: { dateTime?: string; date?: string }): string {\n  return value.dateTime ?? value.date ?? '';\n}\n\nasync function fetchEntityEventsRest(\n  hass: HomeAssistant,\n  entityId: `calendar.${string}`,\n  range: { start: Date; end: Date },\n): Promise<CalendarEvent[]> {\n  const query =\n    `start=${encodeURIComponent(range.start.toISOString())}` +\n    `&end=${encodeURIComponent(range.end.toISOString())}`;\n  const apiEvents = await hass.callApi!<ApiCalendarEvent[]>(\n    'GET',\n    `calendars/${entityId}?${query}`,\n  );\n  return apiEvents.map((event) => ({\n    start: apiDateString(event.start),\n    end: apiDateString(event.end),\n    summary: event.summary,\n    ...(event.description != null && { description: event.description }),\n    ...(event.location != null && { location: event.location }),\n    ...(event.uid != null && { uid: event.uid }),\n    ...(event.recurrence_id != null && { recurrence_id: event.recurrence_id }),\n    ...(event.rrule != null && { rrule: event.rrule }),\n  }));\n}\n\nasync function fetchEntityEventsWs(\n  hass: HomeAssistant,\n  entityId: `calendar.${string}`,\n  range: { start: Date; end: Date },\n): Promise<CalendarEvent[]> {\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: range.start.toISOString(),\n      end_date_time: range.end.toISOString(),\n    },\n    target: { entity_id: entityId },\n    return_response: true,\n  });\n\n  return result.response?.[entityId]?.events ?? [];\n}\n\nasync function fetchCalendarRange(\n  hass: HomeAssistant | undefined,\n  entityIds: `calendar.${string}`[],\n  range: { start: Date; end: Date },\n): Promise<CalendarEventWithSource[]> {\n  if (!hass?.connection) {\n    throw new Error('Home Assistant connection not available');\n  }\n  if (entityIds.length === 0) {\n    return [];\n  }\n\n  const results = await Promise.all(\n    entityIds.map(async (entityId) => {\n      try {\n        // Prefer the REST view: unlike the calendar.get_events service\n        // response (filtered to LIST_EVENT_FIELDS in HA core), it includes\n        // uid/recurrence_id/rrule. The WS service call remains as a fallback\n        // for environments without callApi (test mocks, Storybook).\n        const calendarEvents = hass.callApi\n          ? await fetchEntityEventsRest(hass, entityId, range)\n          : await fetchEntityEventsWs(hass, entityId, range);\n        // Persist only successful fetches; a failure must not cache as \"no events\".\n        writePersisted(entityEventsPersistKey(entityId, range), calendarEvents);\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/**\n * Fetch events from one or more calendars for a date range, with in-memory\n * (per-card) caching and stale-while-revalidate behavior. Each calendar's\n * events are also persisted to localStorage per entity, so a reload renders\n * immediately. Events are tagged with their source calendar ID. Returns\n * `prefetch` to warm adjacent ranges.\n */\nexport function useCalendarEvents(\n  entityIds: `calendar.${string}`[],\n  options: { start: Date; end: Date },\n): UseCalendarEventsResult {\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(() => fetchCalendarRange(getHass(), entityIds, options));\n\n  const {\n    data: events,\n    status,\n    error,\n    refetch,\n  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey], {\n    seed: () => readPersistedRange(entityIds, options),\n  });\n\n  const prefetch = useCallbackStable((range: { start: Date; end: Date }) => {\n    const key = calendarEventsCacheKey(entityIds, range);\n    if (store.cache.has(key)) return; // already warm\n    fetchCalendarRange(getHass(), entityIds, range)\n      .then((result) => writeCache(store.cache, key, result))\n      .catch(() => {\n        // best-effort prefetch; ignore failures\n      });\n  });\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, prefetch };\n}\n\n/**\n * Event payload for the calendar mutation WebSocket commands. Dates are either\n * date-only strings (\"2026-07-17\", all-day) or ISO datetimes.\n */\nexport interface CalendarMutationEvent {\n  dtstart: string;\n  dtend: string;\n  summary: string;\n  description?: string;\n  location?: string;\n  rrule?: string;\n}\n\nfunction requireConnection(hass: HomeAssistant | undefined): HomeAssistant {\n  if (!hass?.connection) {\n    throw new Error('Home Assistant connection not available');\n  }\n  return hass;\n}\n\n/**\n * Create an event on a calendar that supports mutation (e.g. Local Calendar).\n * Requires entity control permission, not admin. WS errors reject unchanged so\n * callers can inspect `err.code` (e.g. 'unauthorized').\n */\nexport async function createCalendarEvent(\n  hass: HomeAssistant | undefined,\n  entityId: `calendar.${string}`,\n  event: CalendarMutationEvent,\n): Promise<void> {\n  await requireConnection(hass).connection.sendMessagePromise({\n    type: 'calendar/event/create',\n    entity_id: entityId,\n    event,\n  });\n}\n\n/** Delete a calendar event by its uid. */\nexport async function deleteCalendarEvent(\n  hass: HomeAssistant | undefined,\n  entityId: `calendar.${string}`,\n  uid: string,\n  opts?: { recurrenceId?: string; recurrenceRange?: string },\n): Promise<void> {\n  await requireConnection(hass).connection.sendMessagePromise({\n    type: 'calendar/event/delete',\n    entity_id: entityId,\n    uid,\n    ...(opts?.recurrenceId !== undefined && { recurrence_id: opts.recurrenceId }),\n    ...(opts?.recurrenceRange !== undefined && { recurrence_range: opts.recurrenceRange }),\n  });\n}\n\n/** Replace a calendar event's content by its uid. */\nexport async function updateCalendarEvent(\n  hass: HomeAssistant | undefined,\n  entityId: `calendar.${string}`,\n  uid: string,\n  event: CalendarMutationEvent,\n): Promise<void> {\n  await requireConnection(hass).connection.sendMessagePromise({\n    type: 'calendar/event/update',\n    entity_id: entityId,\n    uid,\n    event,\n  });\n}\n","import type { RefObject } from 'preact';\nimport { useEffect, useRef } from 'preact/hooks';\n\nexport interface ElementSize {\n  width: number;\n  height: number;\n}\n\nexport type ResizeCallback = (size: ElementSize) => void;\n\n/**\n * Observe an element's size via ResizeObserver. The callback fires:\n *\n *   1. Once after mount, with the element's current size.\n *   2. Whenever the element's size changes.\n *   3. Whenever `deps` change, re-firing with the current size — so callers\n *      can re-run draws when their inputs change without re-creating the\n *      observer.\n *\n * The callback is suppressed only while the element is detached from the\n * document. Zero width/height is delivered to the callback as-is — consumers\n * that need to skip degenerate sizes (e.g. canvas painters where a 0-sized\n * drawImage throws InvalidStateError) should add their own early return.\n *\n * Sizes are read from `offsetWidth` / `offsetHeight` (CSS pixels, includes\n * padding + border). The callback is held in a ref, so passing a fresh\n * function each render is safe — it never re-creates the observer.\n *\n * @example\n * const containerRef = useRef<HTMLDivElement>(null);\n * const canvasRef = useRef<HTMLCanvasElement>(null);\n *\n * useResizeObserver(\n *   containerRef,\n *   ({ width, height }) => {\n *     if (width === 0 || height === 0) return; // optional, consumer's call\n *     drawChart(canvasRef.current, forecast, width, height);\n *   },\n *   [forecast],\n * );\n */\nexport function useResizeObserver<T extends HTMLElement>(\n  ref: RefObject<T>,\n  callback: ResizeCallback,\n  deps: unknown[] = [],\n): void {\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  // Set up the observer once per element. ResizeObserver fires once\n  // synchronously-ish after `.observe()` with the current size, which\n  // covers the initial draw.\n  useEffect(() => {\n    const element = ref.current;\n    if (!element) return;\n\n    const fire = () => {\n      if (!element.isConnected) return;\n      callbackRef.current({\n        width: element.offsetWidth,\n        height: element.offsetHeight,\n      });\n    };\n\n    const observer = new ResizeObserver(fire);\n    observer.observe(element);\n    return () => observer.disconnect();\n    // ref identity is stable across renders; observer setup runs once.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // Re-fire on dependency change. Skip the first render — the observer's\n  // initial `.observe()` fire already delivers the mount-time size.\n  const isFirstRun = useRef(true);\n  useEffect(() => {\n    if (isFirstRun.current) {\n      isFirstRun.current = false;\n      return;\n    }\n    const element = ref.current;\n    if (!element || !element.isConnected) return;\n    callbackRef.current({\n      width: element.offsetWidth,\n      height: element.offsetHeight,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n}\n","import type { RefObject } from 'preact';\nimport { useState } from 'preact/hooks';\nimport { useResizeObserver } from './useResizeObserver';\n\n/**\n * Track the current width of a referenced element in CSS pixels.\n *\n * Returns `undefined` until the first non-zero measurement is observed, then\n * a positive number that updates as the element resizes. Once a real width\n * is captured the hook will never report `undefined` or `0` again, even\n * during HA layout transitions (dashboard switch, edit-mode toggle) — the\n * underlying ResizeObserver firings are silently dropped while the element\n * is detached or transiently zero-width, so the component renders with the\n * last good value instead of flashing through a degenerate state.\n *\n * Use this when you need a width value in JSX (responsive layout, prop to a\n * sized child). If you only need the value imperatively inside a draw\n * callback, prefer `useResizeObserver` directly — it doesn't allocate\n * component state or cause re-renders.\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const width = useWidth(ref);\n * return (\n *   <div ref={ref}>\n *     {width !== undefined && <Chart width={width} />}\n *   </div>\n * );\n */\nexport function useWidth<T extends HTMLElement>(ref: RefObject<T>): number | undefined {\n  const [width, setWidth] = useState<number | undefined>(undefined);\n  useResizeObserver(ref, (size) => {\n    if (size.width === 0) return;\n    setWidth((prev) => (prev === size.width ? prev : size.width));\n  });\n  return width;\n}\n"],"names":["forecast","HACard"],"mappings":"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"}

package/package.json

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

package/src/HAContext.tsx

@@ -3,6 +3,7 @@ import type { ComponentChildren } from 'preact';
 import { useContext, useEffect, useMemo, useRef, useState } from 'preact/hooks';
 
 import { type Cache, readCache, writeCache } from './cacheUtils';
+import { readPersisted, writePersisted } from './persistentCache';
 import type {
   EntityForId,
   FetchStatus,
@@ -86,6 +87,7 @@ export function useHAStore(): HAStore {
  *   - 'calendar.xyz' -> CalendarEntity
  *   - 'weather.xyz' -> WeatherEntity
  *   - 'sun.sun'     -> SunEntity
+ *   - 'fan.xyz'     -> FanEntity
  *   - other domains -> HassEntity (fallback)
  */
 export function useEntity<T extends string>(entityId: T): EntityForId<T> | undefined {
@@ -196,17 +198,28 @@ interface UseCachedFetchResult<T> {
   refetch: () => void;
 }
 
+interface UseCachedFetchOptions<T> {
+  /**
+   * Fallback read when the in-memory cache misses (e.g. from localStorage).
+   * Seeded data is shown as stale (`'cached'`) and revalidated like any hit.
+   */
+  seed?: () => T | undefined;
+}
+
 /**
- * Generic hook for fetching data with localStorage caching. Returns a cache-aware
- * status string to distinguish cached vs fresh data.
+ * Generic hook for fetching data with in-memory caching (optionally seeded from
+ * a persistent store). Returns a cache-aware status string to distinguish cached
+ * vs fresh data.
  */
 export function useCachedFetch<T>(
   cacheKey: string,
   fetcher: () => Promise<T>,
   deps: unknown[],
+  options: UseCachedFetchOptions<T> = {},
 ): UseCachedFetchResult<T> {
   const store = useHAStore();
-  const [data, setData] = useState<T | undefined>(() => readCache<T>(store.cache, cacheKey));
+  const readCached = () => readCache<T>(store.cache, cacheKey) ?? options.seed?.();
+  const [data, setData] = useState<T | undefined>(readCached);
   const [isFresh, setIsFresh] = useState(false);
   const [isFetching, setIsFetching] = useState(false);
   const [error, setError] = useState<Error | undefined>(undefined);
@@ -221,7 +234,7 @@ export function useCachedFetch<T>(
     dataKeyRef.current = cacheKey;
     setIsFresh(false);
     setError(undefined);
-    const cached = readCache<T>(store.cache, cacheKey);
+    const cached = readCached();
     if (cached !== undefined) setData(cached);
     // cache miss: leave `data` as-is (keep-previous-data)
   }
@@ -273,8 +286,9 @@ interface UseWeatherForecastResult {
 }
 
 /**
- * Fetch weather forecast data with localStorage caching. Auto-refetches at the
- * top of each hour and when the underlying entity changes (debounced).
+ * Fetch weather forecast data, cached in memory and persisted to localStorage
+ * so a reload renders immediately. Auto-refetches at the top of each hour and
+ * when the underlying entity changes (debounced).
  */
 export function useWeatherForecast(
   entityId: `weather.${string}`,
@@ -304,7 +318,9 @@ export function useWeatherForecast(
       return_response: true,
     });
 
-    return result.response?.[entityId]?.forecast ?? [];
+    const forecast = result.response?.[entityId]?.forecast ?? [];
+    writePersisted(cacheKey, forecast);
+    return forecast;
   });
 
   const {
@@ -312,7 +328,9 @@ export function useWeatherForecast(
     status,
     error,
     refetch,
-  } = useCachedFetch(cacheKey, fetcher, [entityId, type]);
+  } = useCachedFetch(cacheKey, fetcher, [entityId, type], {
+    seed: () => readPersisted<WeatherForecast[]>(cacheKey),
+  });
 
   const debouncedRefetch = useCallbackStable(() => {
     if (debounceTimerRef.current) {

package/src/__tests__/persistentCache.test.ts

@@ -0,0 +1,118 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import {
+  MAX_AGE_MS,
+  MAX_ENTRIES,
+  readPersisted,
+  resetPersistedSweep,
+  writePersisted,
+} from '../persistentCache';
+
+describe('persistentCache', () => {
+  afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+  });
+
+  it('round-trips data through localStorage', () => {
+    writePersisted('k', { foo: 'bar' });
+    expect(readPersisted('k')).toEqual({ foo: 'bar' });
+  });
+
+  it('returns undefined for missing or corrupt entries', () => {
+    expect(readPersisted('missing')).toBeUndefined();
+    localStorage.setItem('preact-ha:v2:bad', '{not json');
+    expect(readPersisted('bad')).toBeUndefined();
+  });
+
+  it('drops entries older than the max age on read', () => {
+    vi.useFakeTimers();
+    writePersisted('k', 1);
+    vi.advanceTimersByTime(MAX_AGE_MS + 1);
+    expect(readPersisted('k')).toBeUndefined();
+    expect(localStorage.getItem('preact-ha:v2:k')).toBeNull();
+  });
+
+  it('expires entries written by other library versions, keeping fresh ones', () => {
+    vi.useFakeTimers();
+    const now = Date.now();
+    const old = now - MAX_AGE_MS - 1;
+    localStorage.setItem('preact-ha:v3:stale', JSON.stringify({ d: 1, s: old, u: old }));
+    localStorage.setItem('preact-ha:v3:fresh', JSON.stringify({ d: 1, s: now, u: now }));
+    localStorage.setItem('preact-ha:events:stale', JSON.stringify({ data: 1, timestamp: old }));
+    localStorage.setItem('preact-ha:events:fresh', JSON.stringify({ data: 1, timestamp: now }));
+
+    readPersisted('anything');
+
+    expect(localStorage.getItem('preact-ha:v3:stale')).toBeNull();
+    expect(localStorage.getItem('preact-ha:events:stale')).toBeNull();
+    expect(localStorage.getItem('preact-ha:v3:fresh')).not.toBeNull();
+    expect(localStorage.getItem('preact-ha:events:fresh')).not.toBeNull();
+  });
+
+  it('applies the cap across all library versions', () => {
+    vi.useFakeTimers();
+    const now = Date.now();
+    localStorage.setItem('preact-ha:v3:other', JSON.stringify({ d: 1, s: now, u: now - 1 }));
+    for (let i = 0; i < MAX_ENTRIES; i++) {
+      writePersisted(`k${i}`, i);
+      vi.advanceTimersByTime(1);
+    }
+    expect(localStorage.getItem('preact-ha:v3:other')).toBeNull();
+    expect(readPersisted('k0')).toBe(0);
+  });
+
+  it('sweeps expired and unrecognizable entries on first access', () => {
+    vi.useFakeTimers();
+    writePersisted('old', 1);
+    vi.advanceTimersByTime(MAX_AGE_MS + 1);
+    writePersisted('fresh', 2);
+    localStorage.setItem('preact-ha:events:legacy', '{}');
+    localStorage.setItem('unrelated', 'keep');
+
+    resetPersistedSweep();
+    readPersisted('fresh');
+
+    expect(localStorage.getItem('preact-ha:v2:old')).toBeNull();
+    expect(localStorage.getItem('preact-ha:events:legacy')).toBeNull();
+    expect(localStorage.getItem('preact-ha:v2:fresh')).not.toBeNull();
+    expect(localStorage.getItem('unrelated')).toBe('keep');
+  });
+
+  it('evicts the least recently used entries beyond the cap', () => {
+    vi.useFakeTimers();
+    for (let i = 0; i < MAX_ENTRIES; i++) {
+      writePersisted(`k${i}`, i);
+      vi.advanceTimersByTime(1);
+    }
+    // Touch the oldest so it becomes most recently used
+    readPersisted('k0');
+    vi.advanceTimersByTime(1);
+    writePersisted('new', 'x');
+
+    expect(readPersisted('k0')).toBe(0);
+    expect(readPersisted('k1')).toBeUndefined();
+    expect(readPersisted('new')).toBe('x');
+  });
+
+  it('evicts the oldest entry and retries when storage is full', () => {
+    vi.useFakeTimers();
+    writePersisted('a', 1);
+    vi.advanceTimersByTime(1);
+    writePersisted('b', 2);
+
+    const realSetItem = localStorage.setItem;
+    let failed = false;
+    vi.spyOn(localStorage, 'setItem').mockImplementation((key, value) => {
+      if (!failed && key === 'preact-ha:v2:c') {
+        failed = true;
+        throw new DOMException('full', 'QuotaExceededError');
+      }
+      realSetItem(key, value);
+    });
+
+    writePersisted('c', 3);
+    expect(localStorage.getItem('preact-ha:v2:a')).toBeNull();
+    expect(readPersisted('b')).toBe(2);
+    expect(readPersisted('c')).toBe(3);
+  });
+});

package/src/__tests__/setup.ts

@@ -1,3 +1,6 @@
+import { beforeEach } from 'vitest';
+import { resetPersistedSweep } from '../persistentCache';
+
 // Node 22+ has a built-in localStorage that conflicts with jsdom's.
 // This setup ensures we have a proper Web Storage API implementation.
 
@@ -25,3 +28,9 @@ Object.defineProperty(globalThis, 'localStorage', {
   writable: true,
   configurable: true,
 });
+
+// Persisted cache entries must not leak between tests.
+beforeEach(() => {
+  store.clear();
+  resetPersistedSweep();
+});

package/src/__tests__/useCalendarEvents.test.tsx

@@ -298,3 +298,67 @@ describe('useCalendarEvents REST path', () => {
     });
   });
 });
+
+describe('useCalendarEvents persistence', () => {
+  const start = new Date('2025-01-01');
+  const end = new Date('2025-01-31');
+
+  function renderWith(
+    entityIds: `calendar.${string}`[],
+    sendMessagePromise: ReturnType<typeof vi.fn>,
+  ) {
+    const hass = makeHass({}, { connection: { sendMessagePromise } as any });
+    const { subscribe } = createMockSubscribe();
+    return render(
+      <HAProvider hass={hass} subscribeToEntity={subscribe}>
+        <CalendarDisplay entityIds={entityIds} start={start} end={end} />
+      </HAProvider>,
+    );
+  }
+
+  const respond = (msg: { target: { entity_id: string } }) => ({
+    response: {
+      [msg.target.entity_id]: {
+        events: [{ start: '2025-01-05', end: '2025-01-05', summary: msg.target.entity_id }],
+      },
+    },
+  });
+
+  it('seeds a fresh provider from persisted per-entity events', async () => {
+    const first = renderWith(['calendar.family'], vi.fn().mockImplementation(respond));
+    await waitFor(() => expect(screen.getByTestId('status').textContent).toBe('ready'));
+    first.unmount();
+
+    // New provider = empty in-memory cache; a never-resolving fetch shows the seed.
+    renderWith(['calendar.family'], vi.fn().mockReturnValue(new Promise(() => {})));
+    expect(screen.getByTestId('status').textContent).toBe('cached');
+    expect(screen.getByTestId('events').textContent).toBe('calendar.family:calendar.family');
+  });
+
+  it('composes a different calendar set from per-entity entries', async () => {
+    const a = renderWith(['calendar.family'], vi.fn().mockImplementation(respond));
+    await waitFor(() => expect(screen.getByTestId('status').textContent).toBe('ready'));
+    a.unmount();
+    const b = renderWith(['calendar.work'], vi.fn().mockImplementation(respond));
+    await waitFor(() => expect(screen.getByTestId('status').textContent).toBe('ready'));
+    b.unmount();
+
+    renderWith(
+      ['calendar.family', 'calendar.work'],
+      vi.fn().mockReturnValue(new Promise(() => {})),
+    );
+    expect(screen.getByTestId('status').textContent).toBe('cached');
+    expect(screen.getByTestId('count').textContent).toBe('2');
+  });
+
+  it('does not seed when any calendar is missing, and never persists failures', async () => {
+    vi.spyOn(console, 'error').mockImplementation(() => {});
+    const failing = vi.fn().mockRejectedValue(new Error('offline'));
+    const first = renderWith(['calendar.family'], failing);
+    await waitFor(() => expect(screen.getByTestId('status').textContent).toBe('ready'));
+    first.unmount();
+
+    renderWith(['calendar.family'], vi.fn().mockReturnValue(new Promise(() => {})));
+    expect(screen.getByTestId('status').textContent).toBe('loading');
+  });
+});

package/src/cacheUtils.ts

@@ -1,9 +1,10 @@
 // In-memory cache helpers. The cache Map is owned per-card by the HAProvider
 // store (see HAContext), so its lifetime matches the card and it is
-// garbage-collected when the card is torn down. There is intentionally no
-// persistence, TTL, or size cap: freshness comes from entity subscriptions and
-// periodic refetch, not from cache expiry, and growth is bounded by the ranges
-// a single card visits in a session.
+// garbage-collected when the card is torn down. There is intentionally no TTL
+// or size cap here: freshness comes from entity subscriptions and periodic
+// refetch, not from cache expiry, and growth is bounded by the ranges a single
+// card visits in a session. Cross-reload persistence (with expiry) lives in
+// persistentCache.ts and only seeds this cache on a miss.
 
 export interface CacheEntry<T> {
   data: T;

package/src/calendars.ts

@@ -2,6 +2,7 @@ import { useEffect, useRef } from 'preact/hooks';
 
 import { useCachedFetch, useHAStore, useHass } from './HAContext';
 import { writeCache } from './cacheUtils';
+import { readPersisted, writePersisted } from './persistentCache';
 import type { CalendarEvent, CalendarEventWithSource, FetchStatus, HomeAssistant } from './types';
 import { useCallbackStable } from './useCallbackStable';
 
@@ -25,6 +26,33 @@ function calendarEventsCacheKey(
   return `events:${entityIds.join(',')}:${range.start.getTime()}-${range.end.getTime()}`;
 }
 
+/**
+ * Persistent (localStorage) key for one calendar's events over a range. Stored
+ * per entity rather than per entity set, so any combination of calendars —
+ * across cards, or the same card's regular vs highlight calendars — shares it.
+ */
+function entityEventsPersistKey(
+  entityId: `calendar.${string}`,
+  range: { start: Date; end: Date },
+): string {
+  return `events:${entityId}:${range.start.getTime()}-${range.end.getTime()}`;
+}
+
+/** Assemble a range from persisted per-entity entries; undefined unless all are present. */
+function readPersistedRange(
+  entityIds: `calendar.${string}`[],
+  range: { start: Date; end: Date },
+): CalendarEventWithSource[] | undefined {
+  if (entityIds.length === 0) return undefined;
+  const result: CalendarEventWithSource[] = [];
+  for (const entityId of entityIds) {
+    const events = readPersisted<CalendarEvent[]>(entityEventsPersistKey(entityId, range));
+    if (!events) return undefined;
+    for (const event of events) result.push({ ...event, calendarId: entityId });
+  }
+  return result;
+}
+
 /** Event shape returned by the REST view GET /api/calendars/{entity_id}. */
 interface ApiCalendarEvent {
   summary: string;
@@ -110,6 +138,8 @@ async function fetchCalendarRange(
         const calendarEvents = hass.callApi
           ? await fetchEntityEventsRest(hass, entityId, range)
           : await fetchEntityEventsWs(hass, entityId, range);
+        // Persist only successful fetches; a failure must not cache as "no events".
+        writePersisted(entityEventsPersistKey(entityId, range), calendarEvents);
         return calendarEvents.map(
           (event): CalendarEventWithSource => ({ ...event, calendarId: entityId }),
         );
@@ -125,8 +155,10 @@ async function fetchCalendarRange(
 
 /**
  * Fetch events from one or more calendars for a date range, with in-memory
- * (per-card) caching and stale-while-revalidate behavior. Events are tagged
- * with their source calendar ID. Returns `prefetch` to warm adjacent ranges.
+ * (per-card) caching and stale-while-revalidate behavior. Each calendar's
+ * events are also persisted to localStorage per entity, so a reload renders
+ * immediately. Events are tagged with their source calendar ID. Returns
+ * `prefetch` to warm adjacent ranges.
  */
 export function useCalendarEvents(
   entityIds: `calendar.${string}`[],
@@ -148,7 +180,9 @@ export function useCalendarEvents(
     status,
     error,
     refetch,
-  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey]);
+  } = useCachedFetch(cacheKey, fetcher, [entityIdsKey, dateRangeKey], {
+    seed: () => readPersistedRange(entityIds, options),
+  });
 
   const prefetch = useCallbackStable((range: { start: Date; end: Date }) => {
     const key = calendarEventsCacheKey(entityIds, range);

package/src/persistentCache.ts

@@ -0,0 +1,148 @@
+// localStorage persistence beneath the per-card in-memory cache. It only seeds
+// a cold start: persisted data is always shown as stale ('cached') and then
+// revalidated, so expiry here bounds storage rather than guaranteeing freshness.
+//
+// Every card built on this library bundles its own copy, and they all share one
+// localStorage. Housekeeping therefore covers the whole `preact-ha:` NAMESPACE,
+// not just this version's PREFIX, so data left by a deleted card (or a card on
+// another library version) still expires as long as any preact-ha card loads.
+//
+// - Entries older than MAX_AGE_MS are dropped (never shown).
+// - At most MAX_ENTRIES are kept namespace-wide; least-recently-used go first.
+// - The first access per page sweeps expired and unrecognizable entries.
+// - The versioned PREFIX scopes what this version *reads*; bumping it makes old
+//   entries unreadable to new code, and they then age out via the sweep.
+// - Quota errors evict the oldest entry and retry once, then give up silently.
+//
+// Cross-version contract — keep stable in all future versions: every value under
+// NAMESPACE is JSON with numeric `s` (saved at, ms) and `u` (last used, ms).
+// Pre-0.3 entries ({ data, timestamp }) are understood via `timestamp`.
+
+const NAMESPACE = 'preact-ha:';
+const PREFIX = 'preact-ha:v2:';
+export const MAX_AGE_MS = 3 * 24 * 60 * 60 * 1000;
+export const MAX_ENTRIES = 60;
+
+interface PersistedEntry<T> {
+  /** data */
+  d: T;
+  /** saved at (ms) */
+  s: number;
+  /** last used (ms) */
+  u: number;
+}
+
+interface EntryTimes {
+  saved: number;
+  used: number;
+}
+
+let swept = false;
+
+function storage(): Storage | undefined {
+  try {
+    return globalThis.localStorage ?? undefined;
+  } catch {
+    // Access can throw (sandboxed iframes, disabled storage)
+    return undefined;
+  }
+}
+
+/** Timestamps from any version's entry; undefined if unrecognizable. */
+function timesOf(raw: string | null): EntryTimes | undefined {
+  if (!raw) return undefined;
+  try {
+    const value = JSON.parse(raw);
+    const saved = typeof value?.s === 'number' ? value.s : value?.timestamp;
+    if (typeof saved !== 'number') return undefined;
+    return { saved, used: typeof value.u === 'number' ? value.u : saved };
+  } catch {
+    return undefined;
+  }
+}
+
+function namespaceKeys(ls: Storage): string[] {
+  const keys: string[] = [];
+  for (let i = 0; i < ls.length; i++) {
+    const key = ls.key(i);
+    if (key?.startsWith(NAMESPACE)) keys.push(key);
+  }
+  return keys;
+}
+
+/** Namespace entries, least recently used first. */
+function entriesByUse(ls: Storage): { key: string; used: number }[] {
+  return namespaceKeys(ls)
+    .map((key) => ({ key, used: timesOf(ls.getItem(key))?.used ?? 0 }))
+    .sort((a, b) => a.used - b.used);
+}
+
+function evictOverCap(ls: Storage): void {
+  // Cheap key count first; only parse entries when we actually need to evict.
+  const count = namespaceKeys(ls).length;
+  if (count <= MAX_ENTRIES) return;
+  const entries = entriesByUse(ls);
+  for (let i = 0; i < count - MAX_ENTRIES; i++) {
+    ls.removeItem(entries[i].key);
+  }
+}
+
+/** Drop expired and unrecognizable entries namespace-wide, then enforce the cap. Once per page. */
+function sweep(ls: Storage): void {
+  if (swept) return;
+  swept = true;
+  const now = Date.now();
+  for (const key of namespaceKeys(ls)) {
+    const times = timesOf(ls.getItem(key));
+    if (!times || now - times.saved > MAX_AGE_MS) ls.removeItem(key);
+  }
+  evictOverCap(ls);
+}
+
+export function readPersisted<T>(key: string): T | undefined {
+  const ls = storage();
+  if (!ls) return undefined;
+  try {
+    sweep(ls);
+    const fullKey = PREFIX + key;
+    const raw = ls.getItem(fullKey);
+    if (!raw) return undefined;
+    const entry = JSON.parse(raw) as PersistedEntry<T>;
+    const now = Date.now();
+    if (typeof entry?.s !== 'number' || now - entry.s > MAX_AGE_MS) {
+      ls.removeItem(fullKey);
+      return undefined;
+    }
+    entry.u = now;
+    ls.setItem(fullKey, JSON.stringify(entry));
+    return entry.d;
+  } catch {
+    return undefined;
+  }
+}
+
+export function writePersisted<T>(key: string, data: T): void {
+  const ls = storage();
+  if (!ls) return;
+  const now = Date.now();
+  const value = JSON.stringify({ d: data, s: now, u: now } satisfies PersistedEntry<T>);
+  try {
+    sweep(ls);
+    ls.setItem(PREFIX + key, value);
+    evictOverCap(ls);
+  } catch {
+    // Most likely quota exceeded: free the oldest entry and retry once.
+    try {
+      const oldest = entriesByUse(ls)[0];
+      if (oldest) ls.removeItem(oldest.key);
+      ls.setItem(PREFIX + key, value);
+    } catch {
+      // Give up; the in-memory cache still works.
+    }
+  }
+}
+
+/** Test hook: forget that the startup sweep ran. */
+export function resetPersistedSweep(): void {
+  swept = false;
+}