preact-homeassistant 0.5.0 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -14,6 +14,8 @@ pnpm add preact preact-homeassistant
14
14
 
15
15
  ## Quick start
16
16
 
17
+ The easiest way is to [use the template](https://github.com/stutrek/preact-homeassistant-template)
18
+
17
19
  ```tsx
18
20
  import { registerPreactCard, HACard, useEntity, css } from 'preact-homeassistant';
19
21
 
@@ -167,26 +169,56 @@ const { getHass } = useHass();
167
169
  await getHass()?.callService('script', 'morning_routine');
168
170
  ```
169
171
 
170
- ### `useCalendarEvents(entityId, { start, end })`
172
+ ### `useHassValue(selector, isEqual?)`
173
+
174
+ Subscribe to a derived slice of the `hass` object (config, themes, anything
175
+ that isn't entity state — entity state goes through `useEntity`). The selector
176
+ runs on every hass update, but the consumer only re-renders when `isEqual`
177
+ reports a change, so it's cheap for rarely-changing values. `isEqual` defaults
178
+ to `Object.is`.
179
+
180
+ ```tsx
181
+ const unitSystem = useHassValue((hass) => hass?.config?.unit_system?.temperature);
182
+ ```
183
+
184
+ ### `useHassConfig()`
171
185
 
172
- Fetch calendar events for a date range from a single calendar.
186
+ Shorthand for `useHassValue((hass) => hass?.config)`. Re-renders when
187
+ `hass.config` changes (units, latitude/longitude, etc.).
173
188
 
174
- ### `useMultiCalendarEvents(entityIds, { start, end })`
189
+ ### `useDarkMode()`
175
190
 
176
- Fetch events from multiple calendars. Events are returned with `calendarId`
177
- attached. Caches to localStorage and debounce-refetches when entities change.
191
+ Shorthand for the active theme's dark-mode flag. Returns `boolean`.
192
+
193
+ ### `useCalendarEvents(entityIds, { start, end })`
194
+
195
+ Fetch events from one or more calendars for a date range. `entityIds` is an
196
+ array of `` `calendar.${string}` `` IDs, and every returned event carries the
197
+ `calendarId` it came from. Caches per-card in memory with
198
+ stale-while-revalidate, and debounce-refetches when any of the entities change.
178
199
 
179
200
  ```tsx
180
- const { events, status, error, refetch } = useMultiCalendarEvents(
201
+ const { events, status, error, refetch, prefetch } = useCalendarEvents(
181
202
  ['calendar.family', 'calendar.work'],
182
203
  { start, end },
183
204
  );
184
205
  // status: 'loading' | 'cached' | 'ready' | 'refreshing'
206
+
207
+ // Warm adjacent months without touching component state:
208
+ prefetch({ start: prevMonthStart, end: prevMonthEnd });
185
209
  ```
186
210
 
211
+ `prefetch(range)` is best-effort — it skips ranges already cached and swallows
212
+ failures.
213
+
214
+ Events are read from the REST view `GET /api/calendars/{entity_id}`, which
215
+ (unlike the `calendar.get_events` service response) includes `uid`,
216
+ `recurrence_id`, and `rrule`. The service call is used as a fallback when
217
+ `hass.callApi` isn't available (test mocks, Storybook).
218
+
187
219
  ### `useWeatherForecast(entityId, type)`
188
220
 
189
- Fetch weather forecast data. Caches to localStorage, debounce-refetches on
221
+ Fetch weather forecast data. Caches per-card in memory, debounce-refetches on
190
222
  entity changes, and auto-refetches at the top of each hour.
191
223
 
192
224
  ```tsx
@@ -195,8 +227,23 @@ const { forecast, status, error, refetch } = useWeatherForecast('weather.home',
195
227
 
196
228
  ### `useCachedFetch(cacheKey, fetcher, deps)`
197
229
 
198
- Generic hook for fetching data with localStorage caching. The domain-specific
199
- hooks above are built on this.
230
+ Generic hook for fetching data with per-card caching. The domain-specific hooks
231
+ above are built on this. `fetcher` is re-run whenever `deps` change; the result
232
+ is stored under `cacheKey` in the provider's cache.
233
+
234
+ ```tsx
235
+ const { data, status, error, refetch } = useCachedFetch(
236
+ `my-thing:${id}`,
237
+ () => fetchMyThing(id),
238
+ [id],
239
+ );
240
+ ```
241
+
242
+ Behavior is stale-while-revalidate and key-change aware: when `cacheKey`
243
+ changes it swaps to that key's cached value synchronously, or keeps the
244
+ previously rendered data on a cold key — it never blanks to a loading state.
245
+ `'loading'` only appears on a true cold start (nothing cached, nothing
246
+ fetched). In-flight fetches are ignored if a newer one has started.
200
247
 
201
248
  ### `useResizeObserver(ref, callback, deps?)`
202
249
 
@@ -272,12 +319,52 @@ import './MyCard.styles'; // registers styles on import
272
319
 
273
320
  ### `registerRawStyles(cssString)`
274
321
 
275
- Register a raw CSS string, e.g. from a Vite `?inline` import.
322
+ Register a raw CSS string, e.g. from a Vite `?inline` import. No-ops if the
323
+ exact string is already registered.
324
+
325
+ ### `getAllStyles()`
326
+
327
+ Returns every registered style as one concatenated string. `registerPreactCard`
328
+ calls this to inject styles into the card's Shadow DOM; you only need it if
329
+ you're rendering a card tree yourself.
330
+
331
+ ## Calendar mutations
332
+
333
+ Plain async functions (not hooks) for calendars that support writes, e.g. Local
334
+ Calendar. Each takes the `hass` object — get it from `useHass()`. They require
335
+ entity control permission, not admin, and WebSocket errors reject unchanged so
336
+ you can inspect `err.code` (e.g. `'unauthorized'`).
337
+
338
+ ```tsx
339
+ import { createCalendarEvent, updateCalendarEvent, deleteCalendarEvent } from 'preact-homeassistant';
340
+
341
+ const { getHass } = useHass();
342
+
343
+ await createCalendarEvent(getHass(), 'calendar.family', {
344
+ dtstart: '2026-07-17T09:00:00',
345
+ dtend: '2026-07-17T10:00:00',
346
+ summary: 'Dentist',
347
+ });
348
+
349
+ await updateCalendarEvent(getHass(), 'calendar.family', uid, { ...event, summary: 'Dentist ✅' });
350
+
351
+ await deleteCalendarEvent(getHass(), 'calendar.family', uid, {
352
+ recurrenceId, // optional, for one instance of a recurring event
353
+ recurrenceRange, // optional, e.g. 'THISANDFUTURE'
354
+ });
355
+ ```
356
+
357
+ `CalendarMutationEvent` is the payload type: `dtstart` / `dtend` are either
358
+ date-only strings (`'2026-07-17'`, all-day) or ISO datetimes, plus `summary`
359
+ and optional `description`, `location`, `rrule`.
276
360
 
277
361
  ## Cache utilities
278
362
 
279
- `loadFromCache(key)` / `saveToCache(key, data)` localStorage wrapper with
280
- 24-hour expiry. Used internally by the data hooks.
363
+ The fetch hooks cache into an in-memory `Map` owned by the provider, so its
364
+ lifetime matches the card and it is garbage-collected on teardown. There is
365
+ intentionally no persistence, TTL, or size cap: freshness comes from entity
366
+ subscriptions and periodic refetch rather than cache expiry. The read/write
367
+ helpers are internal — reach the cache through `useCachedFetch`.
281
368
 
282
369
  ## Other utilities
283
370
 
@@ -286,6 +373,25 @@ Register a raw CSS string, e.g. from a Vite `?inline` import.
286
373
  Returns a stable callback ref that always calls the latest `fn`. Avoids effect
287
374
  re-runs while keeping the closure current.
288
375
 
376
+ ### `HAProvider`
377
+
378
+ The context provider `registerPreactCard` wraps your card in. Export exists so
379
+ you can render a card outside Home Assistant (Storybook, tests) with a mock
380
+ `hass`.
381
+
382
+ ```tsx
383
+ <HAProvider hass={mockHass} subscribeToEntity={() => () => {}}>
384
+ <MyCardContent config={config} />
385
+ </HAProvider>
386
+ ```
387
+
388
+ | Prop | Type | Required | Description |
389
+ |---|---|---|---|
390
+ | `hass` | `HomeAssistant \| undefined` | Yes | The hass object handed to hooks. |
391
+ | `subscribeToEntity` | `(entityId, cb) => () => void` | Yes | Entity subscription plumbing. Return a no-op unsubscribe for static mocks. |
392
+ | `subscribeToHass` | `(cb) => () => void` | No | Notifies `useHassValue` consumers. Defaults to a no-op, so those hooks return their initial value and never update. |
393
+ | `cache` | `Cache` | No | Inject a cache Map to seed or inspect it. Defaults to a fresh per-provider Map. |
394
+
289
395
  ## Types
290
396
 
291
397
  All HA domain types live in [`src/types/`](src/types/):
@@ -302,20 +408,27 @@ Re-exported from the package root:
302
408
  ```ts
303
409
  import type {
304
410
  HomeAssistant,
411
+ FetchStatus,
305
412
  CalendarEntity,
413
+ CalendarEvent,
414
+ CalendarEventWithSource,
415
+ CalendarMutationEvent,
306
416
  WeatherEntity,
417
+ WeatherForecast,
418
+ ForecastType,
307
419
  SunEntity,
308
420
  FanEntity,
309
421
  FanServices,
310
- WeatherForecast,
311
422
  EntityForId,
312
423
  DomainEntityMap,
313
424
  DomainServiceMap,
314
425
  ServicesForId,
315
- /* ... */
316
426
  } from 'preact-homeassistant';
317
427
  ```
318
428
 
429
+ The non-domain types `HACardAlign`, `ElementSize`, and `ResizeCallback` are
430
+ exported from the root as well, alongside their components/hooks.
431
+
319
432
  ## Contributing types
320
433
 
321
434
  The HA domain types in this package are intentionally minimal — only the
@@ -342,8 +455,10 @@ attributes can land later.
342
455
  ```bash
343
456
  pnpm install
344
457
  pnpm test # vitest run
458
+ pnpm typecheck # tsc --noEmit
345
459
  pnpm build # tsc --noEmit && vite build
346
- pnpm lint # biome check
460
+ pnpm lint # biome check src
461
+ pnpm lint:fix # biome check --write src
347
462
  ```
348
463
 
349
464
  ## Publishing
@@ -351,7 +466,7 @@ pnpm lint # biome check
351
466
  Releases are published to npm manually from a local machine (no CI publish):
352
467
 
353
468
  ```bash
354
- pnpm test && pnpm build && pnpm typecheck
469
+ pnpm test && pnpm build
355
470
  git tag v0.X.Y && git push origin v0.X.Y
356
471
  pnpm publish --access public --provenance
357
472
  ```
package/dist/index.d.ts CHANGED
@@ -345,6 +345,7 @@ export declare function useDarkMode(): boolean;
345
345
  * - 'calendar.xyz' -> CalendarEntity
346
346
  * - 'weather.xyz' -> WeatherEntity
347
347
  * - 'sun.sun' -> SunEntity
348
+ * - 'fan.xyz' -> FanEntity
348
349
  * - other domains -> HassEntity (fallback)
349
350
  */
350
351
  export declare function useEntity<T extends string>(entityId: T): EntityForId<T> | undefined;
package/dist/index.js.map CHANGED
@@ -1 +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":";;;AAaO,SAAS,UAAa,OAAc,KAA4B;AACrE,SAAQ,MAAM,IAAI,GAAG,GAAiC;AACxD;AAEO,SAAS,WAAc,OAAc,KAAa,MAAe;AACtE,QAAM,IAAI,KAAK,EAAE,KAAA,CAAM;AACzB;ACVO,SAAS,kBAA2D,UAAgB;AACzF,QAAM,cAAc,OAAU,QAAQ;AAEtC,cAAY,UAAU;AAGtB,QAAM,YAAY,OAAiB,IAAI;AACvC,MAAI,UAAU,YAAY,MAAM;AAC9B,cAAU,WAAW,IAAI,SAAwB;AAC/C,aAAO,YAAY,QAAQ,GAAG,IAAI;AAAA,IACpC;AAAA,EACF;AAEA,SAAO,UAAU;AACnB;ACJA,MAAM,sBAAuC,MAAM,MAAM;AAAC;AAW1D,MAAM,YAAY,cAA8B,IAAI;AAY7C,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAoB;AAClB,QAAM,UAAU,OAAO,IAAI;AAC3B,UAAQ,UAAU;AAElB,QAAM,UAAU,kBAAkB,MAAM,QAAQ,OAAO;AAEvD,QAAM,WAAW,OAAA;AACjB,MAAI,CAAC,SAAS,kBAAkB,UAAU,6BAAa,IAAA;AAEvD,QAAM,0BAA0B,mBAAmB;AAEnD,QAAM,QAAQ;AAAA,IACZ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,iBAAiB;AAAA,MACjB,OAAO,SAAS;AAAA,IAAA;AAAA,IAElB,CAAC,SAAS,mBAAmB,uBAAuB;AAAA,EAAA;AAGtD,6BAAQ,UAAU,UAAV,EAAmB,OAAO,OAAQ,UAAS;AACrD;AAGO,SAAS,aAAsB;AACpC,QAAM,QAAQ,WAAW,SAAS;AAClC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,SAAO;AACT;AAWO,SAAS,UAA4B,UAAyC;AACnF,QAAM,QAAQ,WAAA;AACd,QAAM,WAAW,UAAU,QAAQ;AAEnC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAqC,MAAM;AACrE,UAAM,UAAU,MAAM,QAAA,GAAW,OAAO,QAAQ;AAChD,QAAI,QAAS,QAAO;AACpB,WAAO,UAA0B,MAAM,OAAO,QAAQ;AAAA,EACxD,CAAC;AAED,YAAU,MAAM;AACd,UAAM,cAAc,MAAM,kBAAkB,UAAU,CAAC,cAAc;AACnE,gBAAU,SAA2B;AACrC,iBAAW,MAAM,OAAO,UAAU,SAAS;AAAA,IAC7C,CAAC;AACD,WAAO;AAAA,EACT,GAAG,CAAC,UAAU,MAAM,mBAAmB,MAAM,OAAO,QAAQ,CAAC;AAE7D,SAAO;AACT;AAMO,SAAS,UAAwD;AACtE,QAAM,QAAQ,WAAA;AACd,SAAO,EAAE,SAAS,MAAM,QAAA;AAC1B;AASO,SAAS,aACd,UACA,UAAmC,OAAO,IACvC;AACH,QAAM,QAAQ,WAAA;AAEd,QAAM,cAAc,OAAO,QAAQ;AACnC,cAAY,UAAU;AACtB,QAAM,aAAa,OAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAY,MAAM,YAAY,QAAQ,MAAM,QAAA,CAAS,CAAC;AAEhF,YAAU,MAAM;AACd,UAAM,cAAc,MAAM,gBAAgB,MAAM;AAC9C,YAAM,OAAO,YAAY,QAAQ,MAAM,SAAS;AAChD,eAAS,CAAC,SAAU,WAAW,QAAQ,MAAM,IAAI,IAAI,OAAO,IAAK;AAAA,IACnE,CAAC;AACD,WAAO;AAAA,EACT,GAAG,CAAC,MAAM,iBAAiB,MAAM,OAAO,CAAC;AAEzC,SAAO;AACT;AAGO,SAAS,gBAAqD;AACnE,SAAO,aAAa,CAAC,SAAS,MAAM,MAAM;AAC5C;AAGO,SAAS,cAAuB;AACrC,SAAO,aAAa,CAAC,SAAS,MAAM,QAAQ,YAAY,KAAK;AAC/D;AAsBO,SAAS,WAA6B,UAA+B;AAC1E,QAAM,EAAE,QAAA,IAAY,QAAA;AACpB,SAAO,mBAAmB,CAAC,SAAiB,SAAkB;AAC5D,UAAM,OAAO,QAAA;AACb,QAAI,CAAC,QAAQ,CAAC,SAAS,SAAS,GAAG,EAAG,QAAO,QAAQ,QAAA;AACrD,UAAM,SAAS,SAAS,MAAM,KAAK,CAAC,EAAE,CAAC;AACvC,WAAO,KAAK,YAAY,QAAQ,SAAS,EAAE,WAAW,UAAU,GAAG,MAAM;AAAA,EAC3E,EAAA;AACF;AAaO,SAAS,eACd,UACA,SACA,MACyB;AACzB,QAAM,QAAQ,WAAA;AACd,QAAM,CAAC,MAAM,OAAO,IAAI,SAAwB,MAAM,UAAa,MAAM,OAAO,QAAQ,CAAC;AACzF,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAC5C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAClD,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA4B,MAAS;AAO/D,QAAM,aAAa,OAAO,QAAQ;AAClC,MAAI,aAAa,WAAW,SAAS;AACnC,eAAW,UAAU;AACrB,eAAW,KAAK;AAChB,aAAS,MAAS;AAClB,UAAM,SAAS,UAAa,MAAM,OAAO,QAAQ;AACjD,QAAI,WAAW,OAAW,SAAQ,MAAM;AAAA,EAE1C;AAEA,QAAM,aAAa,OAAO,CAAC;AAE3B,QAAM,UAAU,kBAAkB,YAAY;AAC5C,UAAM,UAAU,EAAE,WAAW;AAC7B,kBAAc,IAAI;AAClB,aAAS,MAAS;AAElB,QAAI;AACF,YAAM,SAAS,MAAM,QAAA;AACrB,UAAI,YAAY,WAAW,SAAS;AAClC,gBAAQ,MAAM;AACd,mBAAW,IAAI;AACf,mBAAW,MAAM,OAAO,UAAU,MAAM;AAAA,MAC1C;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,YAAY,WAAW,SAAS;AAClC,iBAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;AAAA,MAC9D;AAAA,IACF,UAAA;AACE,UAAI,YAAY,WAAW,SAAS;AAClC,sBAAc,KAAK;AAAA,MACrB;AAAA,IACF;AAAA,EACF,CAAC;AAED,YAAU,MAAM;AACd,YAAA;AAAA,EACF,GAAG,IAAI;AAEP,QAAM,SAAsB,QAAQ,MAAM;AACxC,QAAI,CAAC,QAAQ,WAAY,QAAO;AAChC,QAAI,QAAQ,CAAC,WAAW,WAAY,QAAO;AAC3C,QAAI,QAAQ,WAAW,WAAY,QAAO;AAC1C,WAAO;AAAA,EACT,GAAG,CAAC,MAAM,SAAS,UAAU,CAAC;AAE9B,SAAO,EAAE,MAAM,QAAQ,OAAO,SAAS,QAAA;AACzC;AAaO,SAAS,mBACd,UACA,MAC0B;AAC1B,QAAM,QAAQ,WAAA;AACd,QAAM,EAAE,QAAA,IAAY,QAAA;AACpB,QAAM,WAAW,YAAY,QAAQ,IAAI,IAAI;AAE7C,QAAM,mBAAmB,OAA6C,IAAI;AAC1E,QAAM,iBAAiB,OAA6C,IAAI;AAExE,QAAM,UAAU,kBAAkB,YAAY;AAC5C,UAAM,OAAO,QAAA;AACb,QAAI,CAAC,MAAM,YAAY;AACrB,YAAM,IAAI,MAAM,yCAAyC;AAAA,IAC3D;AAEA,UAAM,SAAS,MAAM,KAAK,WAAW,mBAElC;AAAA,MACD,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,cAAc,EAAE,KAAA;AAAA,MAChB,QAAQ,EAAE,WAAW,SAAA;AAAA,MACrB,iBAAiB;AAAA,IAAA,CAClB;AAED,WAAO,OAAO,WAAW,QAAQ,GAAG,YAAY,CAAA;AAAA,EAClD,CAAC;AAED,QAAM;AAAA,IACJ,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACE,eAAe,UAAU,SAAS,CAAC,UAAU,IAAI,CAAC;AAEtD,QAAM,mBAAmB,kBAAkB,MAAM;AAC/C,QAAI,iBAAiB,SAAS;AAC5B,mBAAa,iBAAiB,OAAO;AAAA,IACvC;AACA,qBAAiB,UAAU,WAAW,MAAM,QAAA,GAAW,GAAG;AAAA,EAC5D,CAAC;AAED,QAAM,wBAAwB,kBAAkB,MAAM;AACpD,QAAI,eAAe,SAAS;AAC1B,mBAAa,eAAe,OAAO;AAAA,IACrC;AACA,UAAM,0BAAU,KAAA;AAChB,UAAM,WAAW,IAAI,KAAK,GAAG;AAC7B,aAAS,SAAS,IAAI,SAAA,IAAa,GAAG,GAAG,GAAG,CAAC;AAC7C,UAAM,kBAAkB,SAAS,QAAA,IAAY,IAAI,QAAA;AAEjD,mBAAe,UAAU,WAAW,MAAM;AACxC,cAAA;AACA,4BAAA;AAAA,IACF,GAAG,eAAe;AAAA,EACpB,CAAC;AAED,YAAU,MAAM;AACd,0BAAA;AAAA,EACF,GAAG,CAAC,UAAU,MAAM,qBAAqB,CAAC;AAE1C,YAAU,MAAM;AACd,UAAM,cAAc,MAAM,kBAAkB,UAAU,gBAAgB;AACtE,WAAO,MAAM;AACX,kBAAA;AACA,UAAI,iBAAiB,SAAS;AAC5B,qBAAa,iBAAiB,OAAO;AAAA,MACvC;AACA,UAAI,eAAe,SAAS;AAC1B,qBAAa,eAAe,OAAO;AAAA,MACrC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,UAAU,MAAM,mBAAmB,gBAAgB,CAAC;AAExD,SAAO,EAAE,UAAU,QAAQ,OAAO,QAAA;AACpC;ACjWA,MAAM,gBAA0B,CAAA;AAMzB,MAAM,MAAM,CAAC,YAAkC,WAA8B;AAClF,QAAM,SAAS,QAAQ,OAAO,CAAC,KAAK,KAAK,MAAM,MAAM,OAAO,OAAO,CAAC,KAAK,KAAK,EAAE;AAChF,gBAAc,KAAK,MAAM;AACzB,SAAO;AACT;AAMO,SAAS,kBAAkB,QAAsB;AACtD,MAAI,CAAC,cAAc,SAAS,MAAM,GAAG;AACnC,kBAAc,KAAK,MAAM;AAAA,EAC3B;AACF;AAKO,SAAS,eAAuB;AACrC,SAAO,cAAc,KAAK,IAAI;AAChC;ACAA,MAAM,oBAAoB;AAEnB,SAAS,mBAA4B,SAA6C;AACvF,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACE;AAAA,EAKJ,MAAe,mBAAmB,YAAY;AAAA,IAClC;AAAA,IACA;AAAA,IACF;AAAA,IAIE,sBAA4B;AAAA,IAAC;AAAA,IAEvC,oBAAoB;AAClB,UAAI,KAAK,mBAAmB,QAAW;AACrC,qBAAa,KAAK,cAAc;AAChC,aAAK,iBAAiB;AAAA,MACxB;AACA,WAAK,sBAAA;AAAA,IACP;AAAA,IAEU,wBAAwB;AAChC,UAAI,KAAK,SAAS,KAAK,SAAS;AAC9B,aAAK,QAAA;AAAA,MACP;AAAA,IACF;AAAA,IAEA,uBAAuB;AACrB,UAAI,KAAK,mBAAmB,OAAW,cAAa,KAAK,cAAc;AACvE,WAAK,iBAAiB,WAAW,MAAM;AAIrC,eAAO,MAAM,KAAK,gBAAgB;AAClC,aAAK,iBAAiB;AAAA,MACxB,GAAG,iBAAiB;AAAA,IACtB;AAAA,IAEA,UAAU,QAAiB;AACzB,WAAK,UAAU;AACf,UAAI,KAAK,SAAS,KAAK,aAAa;AAClC,aAAK,QAAA;AAAA,MACP;AAAA,IACF;AAAA,IAEU,UAAU;AAClB,UAAI,CAAC,KAAK,WAAW,CAAC,KAAK,OAAO;AAChC,aAAK,oBAAA;AACL;AAAA,MACF;AACA,WAAK,YAAA;AAAA,IACP;AAAA,EAAA;AAAA,EAGF,MAAMA,gBAAe,WAAW;AAAA,IACtB;AAAA,IACA,6CAA6B,IAAA;AAAA,IAC7B,2CAA2B,IAAA;AAAA,IAEnC,cAAc;AACZ,YAAA;AACA,WAAK,cAAc,KAAK,aAAa,EAAE,MAAM,QAAQ;AAAA,IACvD;AAAA,IAEU,iBAAiB;AACzB,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,IAAI,KAAK,MAAqB;AAC5B,YAAM,aAAa,KAAK,OAAO;AAC/B,WAAK,QAAQ;AAEb,iBAAW,CAAC,UAAU,SAAS,KAAK,KAAK,wBAAwB;AAC/D,cAAM,WAAW,KAAK,OAAO,QAAQ;AACrC,cAAM,WAAW,aAAa,QAAQ;AACtC,YAAI,aAAa,UAAU;AACzB,oBAAU,QAAQ,CAAC,aAAa,SAAS,QAAQ,CAAC;AAAA,QACpD;AAAA,MACF;AAKA,WAAK,qBAAqB,QAAQ,CAAC,aAAa,UAAU;AAE1D,UAAI,CAAC,cAAc,KAAK,WAAW,KAAK,aAAa;AACnD,aAAK,QAAA;AAAA,MACP;AAAA,IACF;AAAA,IAEQ,qBAAqB,CAAC,UAAkB,aAAoC;AAClF,UAAI,CAAC,KAAK,uBAAuB,IAAI,QAAQ,GAAG;AAC9C,aAAK,uBAAuB,IAAI,UAAU,oBAAI,KAAK;AAAA,MACrD;AACA,WAAK,uBAAuB,IAAI,QAAQ,EAAG,IAAI,QAAQ;AAEvD,aAAO,MAAM;AACX,cAAM,YAAY,KAAK,uBAAuB,IAAI,QAAQ;AAC1D,YAAI,WAAW;AACb,oBAAU,OAAO,QAAQ;AACzB,cAAI,UAAU,SAAS,GAAG;AACxB,iBAAK,uBAAuB,OAAO,QAAQ;AAAA,UAC7C;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEQ,mBAAmB,CAAC,aAAyB;AACnD,WAAK,qBAAqB,IAAI,QAAQ;AACtC,aAAO,MAAM;AACX,aAAK,qBAAqB,OAAO,QAAQ;AAAA,MAC3C;AAAA,IACF;AAAA,IAEU,cAAc;AACtB;AAAA,QACE;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAM,KAAK;AAAA,YACX,mBAAmB,KAAK;AAAA,YACxB,iBAAiB,KAAK;AAAA,YAEtB,UAAA;AAAA,cAAA,oBAAC,SAAA,EAAO,yBAAa,CAAE;AAAA,cACvB,oBAAC,WAAA,EAAU,QAAQ,KAAK,QAAA,CAAU;AAAA,YAAA;AAAA,UAAA;AAAA,QAAA;AAAA,QAEpC,KAAK;AAAA,MAAA;AAAA,IAET;AAAA,IAEU,sBAAsB;AAC9B,UAAI,uBAAuB;AACzB,eAAO,oBAAC,uBAAA,CAAA,CAAsB,GAAI,KAAK,WAAW;AAAA,MACpD;AAAA,IACF;AAAA,IAEA,OAAO,mBAAmB;AACxB,UAAI,iBAAiB;AACnB,eAAO,SAAS,cAAc,GAAG,IAAI,SAAS;AAAA,MAChD;AACA,aAAO;AAAA,IACT;AAAA,IAEA,OAAO,gBAAgB;AACrB,aAAO,gBAAA,KAAqB,CAAA;AAAA,IAC9B;AAAA,EAAA;AAGF,iBAAe,OAAO,MAAMA,OAAM;AAElC,MAAI,iBAAiB;AACnB,UAAM,kBAAkB;AAAA,IAExB,MAAM,qBAAqB,WAAW;AAAA,MAC1B,iBAAiB;AACzB,eAAO;AAAA,MACT;AAAA;AAAA;AAAA;AAAA,MAKA,IAAI,KAAK,MAAqB;AAC5B,aAAK,QAAQ;AACb,aAAK,QAAA;AAAA,MACP;AAAA;AAAA;AAAA,MAIA,UAAU,QAAiB;AACzB,aAAK,UAAU;AACf,aAAK,QAAA;AAAA,MACP;AAAA,MAEQ,qBAAqB,CAAC,WAAoB;AAChD,aAAK;AAAA,UACH,IAAI,YAAY,kBAAkB;AAAA,YAChC,QAAQ,EAAE,OAAA;AAAA,YACV,SAAS;AAAA,YACT,UAAU;AAAA,UAAA,CACX;AAAA,QAAA;AAAA,MAEL;AAAA;AAAA,MAGU,cAAc;AACtB;AAAA,UACE;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,MAAM,KAAK;AAAA,cACX,QAAQ,KAAK;AAAA,cACb,iBAAiB,KAAK;AAAA,YAAA;AAAA,UAAA;AAAA,UAExB;AAAA,QAAA;AAAA,MAEJ;AAAA,IAAA;AAGF,mBAAe,OAAO,GAAG,IAAI,WAAW,YAAY;AAAA,EACtD;AAEA,SAAO,cAAc,OAAO,eAAe,CAAA;AAC3C,SAAO,YAAY,KAAK,EAAE,MAAM,MAAM,aAAa;AAEnD,UAAQ;AAAA,IACN,MAAM,KAAK,YAAA,CAAa;AAAA,IACxB;AAAA,IACA;AAAA,EAAA;AAEJ;ACvOA,MAAM,gBAAwC,EAAE,KAAK,cAAc,QAAQ,WAAA;AAiBpE,SAAS,OAAO,EAAE,QAAQ,OAAO,OAAO,WAAW,YAAyB;AACjF,QAAM,UAAU,cAAc,KAAK,KAAK;AACxC,SACE,qBAAA,UAAA,EAIE,UAAA;AAAA,IAAA,oBAAC,WAAO,UAAA,0DAAA,CAA0D;AAAA,IACjE;AAAA,MACC;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,OAAO;AAAA,UACL,QAAQ;AAAA,UACR,WAAW;AAAA,UACX,SAAS;AAAA,UACT,eAAe;AAAA,UACf,gBAAgB;AAAA,QAAA;AAAA,MAClB;AAAA,MAEF;AAAA,IAAA;AAAA,EACF,GACF;AAEJ;ACrCA,SAAS,uBACP,WACA,OACQ;AACR,SAAO,UAAU,UAAU,KAAK,GAAG,CAAC,IAAI,MAAM,MAAM,QAAA,CAAS,IAAI,MAAM,IAAI,SAAS;AACtF;AAeA,SAAS,cAAc,OAAqD;AAC1E,SAAO,MAAM,YAAY,MAAM,QAAQ;AACzC;AAEA,eAAe,sBACb,MACA,UACA,OAC0B;AAC1B,QAAM,QACJ,SAAS,mBAAmB,MAAM,MAAM,YAAA,CAAa,CAAC,QAC9C,mBAAmB,MAAM,IAAI,YAAA,CAAa,CAAC;AACrD,QAAM,YAAY,MAAM,KAAK;AAAA,IAC3B;AAAA,IACA,aAAa,QAAQ,IAAI,KAAK;AAAA,EAAA;AAEhC,SAAO,UAAU,IAAI,CAAC,WAAW;AAAA,IAC/B,OAAO,cAAc,MAAM,KAAK;AAAA,IAChC,KAAK,cAAc,MAAM,GAAG;AAAA,IAC5B,SAAS,MAAM;AAAA,IACf,GAAI,MAAM,eAAe,QAAQ,EAAE,aAAa,MAAM,YAAA;AAAA,IACtD,GAAI,MAAM,YAAY,QAAQ,EAAE,UAAU,MAAM,SAAA;AAAA,IAChD,GAAI,MAAM,OAAO,QAAQ,EAAE,KAAK,MAAM,IAAA;AAAA,IACtC,GAAI,MAAM,iBAAiB,QAAQ,EAAE,eAAe,MAAM,cAAA;AAAA,IAC1D,GAAI,MAAM,SAAS,QAAQ,EAAE,OAAO,MAAM,MAAA;AAAA,EAAM,EAChD;AACJ;AAEA,eAAe,oBACb,MACA,UACA,OAC0B;AAC1B,QAAM,SAAS,MAAM,KAAK,WAAW,mBAElC;AAAA,IACD,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,cAAc;AAAA,MACZ,iBAAiB,MAAM,MAAM,YAAA;AAAA,MAC7B,eAAe,MAAM,IAAI,YAAA;AAAA,IAAY;AAAA,IAEvC,QAAQ,EAAE,WAAW,SAAA;AAAA,IACrB,iBAAiB;AAAA,EAAA,CAClB;AAED,SAAO,OAAO,WAAW,QAAQ,GAAG,UAAU,CAAA;AAChD;AAEA,eAAe,mBACb,MACA,WACA,OACoC;AACpC,MAAI,CAAC,MAAM,YAAY;AACrB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AACA,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,CAAA;AAAA,EACT;AAEA,QAAM,UAAU,MAAM,QAAQ;AAAA,IAC5B,UAAU,IAAI,OAAO,aAAa;AAChC,UAAI;AAKF,cAAM,iBAAiB,KAAK,UACxB,MAAM,sBAAsB,MAAM,UAAU,KAAK,IACjD,MAAM,oBAAoB,MAAM,UAAU,KAAK;AACnD,eAAO,eAAe;AAAA,UACpB,CAAC,WAAoC,EAAE,GAAG,OAAO,YAAY,SAAA;AAAA,QAAS;AAAA,MAE1E,SAAS,KAAK;AACZ,gBAAQ,MAAM,8BAA8B,QAAQ,KAAK,GAAG;AAC5D,eAAO,CAAA;AAAA,MACT;AAAA,IACF,CAAC;AAAA,EAAA;AAGH,SAAO,QAAQ,KAAA;AACjB;AAOO,SAAS,kBACd,WACA,SACyB;AACzB,QAAM,QAAQ,WAAA;AACd,QAAM,EAAE,QAAA,IAAY,QAAA;AAEpB,QAAM,mBAAmB,OAA6C,IAAI;AAE1E,QAAM,eAAe,UAAU,KAAK,GAAG;AACvC,QAAM,eAAe,GAAG,QAAQ,MAAM,SAAS,IAAI,QAAQ,IAAI,QAAA,CAAS;AACxE,QAAM,WAAW,UAAU,YAAY,IAAI,YAAY;AAEvD,QAAM,UAAU,kBAAkB,MAAM,mBAAmB,WAAW,WAAW,OAAO,CAAC;AAEzF,QAAM;AAAA,IACJ,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACE,eAAe,UAAU,SAAS,CAAC,cAAc,YAAY,CAAC;AAElE,QAAM,WAAW,kBAAkB,CAAC,UAAsC;AACxE,UAAM,MAAM,uBAAuB,WAAW,KAAK;AACnD,QAAI,MAAM,MAAM,IAAI,GAAG,EAAG;AAC1B,uBAAmB,WAAW,WAAW,KAAK,EAC3C,KAAK,CAAC,WAAW,WAAW,MAAM,OAAO,KAAK,MAAM,CAAC,EACrD,MAAM,MAAM;AAAA,IAEb,CAAC;AAAA,EACL,CAAC;AAED,QAAM,mBAAmB,kBAAkB,MAAM;AAC/C,QAAI,iBAAiB,SAAS;AAC5B,mBAAa,iBAAiB,OAAO;AAAA,IACvC;AACA,qBAAiB,UAAU,WAAW,MAAM,QAAA,GAAW,GAAG;AAAA,EAC5D,CAAC;AAED,YAAU,MAAM;AACd,UAAM,eAAe,UAAU;AAAA,MAAI,CAAC,aAClC,MAAM,kBAAkB,UAAU,gBAAgB;AAAA,IAAA;AAEpD,WAAO,MAAM;AACX,mBAAa,QAAQ,CAAC,UAAU,MAAA,CAAO;AACvC,UAAI,iBAAiB,SAAS;AAC5B,qBAAa,iBAAiB,OAAO;AAAA,MACvC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,cAAc,MAAM,mBAAmB,gBAAgB,CAAC;AAE5D,SAAO,EAAE,QAAQ,QAAQ,OAAO,SAAS,SAAA;AAC3C;AAeA,SAAS,kBAAkB,MAAgD;AACzE,MAAI,CAAC,MAAM,YAAY;AACrB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AACA,SAAO;AACT;AAOA,eAAsB,oBACpB,MACA,UACA,OACe;AACf,QAAM,kBAAkB,IAAI,EAAE,WAAW,mBAAmB;AAAA,IAC1D,MAAM;AAAA,IACN,WAAW;AAAA,IACX;AAAA,EAAA,CACD;AACH;AAGA,eAAsB,oBACpB,MACA,UACA,KACA,MACe;AACf,QAAM,kBAAkB,IAAI,EAAE,WAAW,mBAAmB;AAAA,IAC1D,MAAM;AAAA,IACN,WAAW;AAAA,IACX;AAAA,IACA,GAAI,MAAM,iBAAiB,UAAa,EAAE,eAAe,KAAK,aAAA;AAAA,IAC9D,GAAI,MAAM,oBAAoB,UAAa,EAAE,kBAAkB,KAAK,gBAAA;AAAA,EAAgB,CACrF;AACH;AAGA,eAAsB,oBACpB,MACA,UACA,KACA,OACe;AACf,QAAM,kBAAkB,IAAI,EAAE,WAAW,mBAAmB;AAAA,IAC1D,MAAM;AAAA,IACN,WAAW;AAAA,IACX;AAAA,IACA;AAAA,EAAA,CACD;AACH;ACjNO,SAAS,kBACd,KACA,UACA,OAAkB,CAAA,GACZ;AACN,QAAM,cAAc,OAAO,QAAQ;AACnC,cAAY,UAAU;AAKtB,YAAU,MAAM;AACd,UAAM,UAAU,IAAI;AACpB,QAAI,CAAC,QAAS;AAEd,UAAM,OAAO,MAAM;AACjB,UAAI,CAAC,QAAQ,YAAa;AAC1B,kBAAY,QAAQ;AAAA,QAClB,OAAO,QAAQ;AAAA,QACf,QAAQ,QAAQ;AAAA,MAAA,CACjB;AAAA,IACH;AAEA,UAAM,WAAW,IAAI,eAAe,IAAI;AACxC,aAAS,QAAQ,OAAO;AACxB,WAAO,MAAM,SAAS,WAAA;AAAA,EAGxB,GAAG,CAAA,CAAE;AAIL,QAAM,aAAa,OAAO,IAAI;AAC9B,YAAU,MAAM;AACd,QAAI,WAAW,SAAS;AACtB,iBAAW,UAAU;AACrB;AAAA,IACF;AACA,UAAM,UAAU,IAAI;AACpB,QAAI,CAAC,WAAW,CAAC,QAAQ,YAAa;AACtC,gBAAY,QAAQ;AAAA,MAClB,OAAO,QAAQ;AAAA,MACf,QAAQ,QAAQ;AAAA,IAAA,CACjB;AAAA,EAEH,GAAG,IAAI;AACT;AC1DO,SAAS,SAAgC,KAAuC;AACrF,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA6B,MAAS;AAChE,oBAAkB,KAAK,CAAC,SAAS;AAC/B,QAAI,KAAK,UAAU,EAAG;AACtB,aAAS,CAAC,SAAU,SAAS,KAAK,QAAQ,OAAO,KAAK,KAAM;AAAA,EAC9D,CAAC;AACD,SAAO;AACT;"}
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 * - '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\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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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "preact-homeassistant",
3
- "version": "0.5.0",
3
+ "version": "0.5.2",
4
4
  "description": "Preact hooks and helpers for building Home Assistant custom cards",
5
5
  "author": {
6
6
  "name": "Stu Kabakoff",
package/src/HAContext.tsx CHANGED
@@ -86,6 +86,7 @@ export function useHAStore(): HAStore {
86
86
  * - 'calendar.xyz' -> CalendarEntity
87
87
  * - 'weather.xyz' -> WeatherEntity
88
88
  * - 'sun.sun' -> SunEntity
89
+ * - 'fan.xyz' -> FanEntity
89
90
  * - other domains -> HassEntity (fallback)
90
91
  */
91
92
  export function useEntity<T extends string>(entityId: T): EntityForId<T> | undefined {