@camstack/ui-library 1.2.256 → 1.2.258

package/dist/composites/device-controls/control-panel.d.ts

@@ -1,10 +1,10 @@
-import { ReactNode } from 'react';
-import { ControlPanelProps } from './types.js';
+import { type ReactNode } from "react";
+import type { ControlPanelProps } from "./types.js";
 /** Trim an HA date value to the `<input type=date>` shape ('YYYY-MM-DD'). */
 export declare function toDateInput(value: string): string;
 /** Trim an HA time value ('HH:MM:SS') to the `<input type=time>` shape ('HH:MM'). */
 export declare function toTimeInput(value: string): string;
 /** Trim an HA datetime value to the `<input type=datetime-local>` shape
- *  ('YYYY-MM-DDTHH:MM'). Accepts both 'T'- and space-separated forms. */
+*  ('YYYY-MM-DDTHH:MM'). Accepts both 'T'- and space-separated forms. */
 export declare function toDateTimeInput(value: string): string;
-export declare function ControlPanel({ trpc, deviceId, features: _features, layout, optimistic, }: ControlPanelProps): ReactNode;
+export declare function ControlPanel({ trpc, deviceId, features: _features, layout, optimistic }: ControlPanelProps): ReactNode;

package/dist/composites/device-controls/control-registry.d.ts

@@ -1,83 +1,94 @@
-import { ReactNode } from 'react';
-import { DeviceType } from '@camstack/types';
-import { UseDeviceProxyTrpc } from '../../hooks/use-device-proxy';
-import { ControlAlign } from './atoms';
-export { coverHighlight } from './cover-inline';
+/**
+* Per-DeviceType control registry.
+*
+* Single source of truth for which InlineControl (row) and HeroCard
+* (device-detail hero area) to render for each DeviceType. Both the
+* device-list row and the device-detail hero card pull from this
+* registry, so they can never diverge.
+*
+* The mapping is EXHAUSTIVE — `Record<DeviceType, DeviceTypeControl>`
+* means omitting a new enum member fails the build.
+*/
+import type { ReactNode } from "react";
+import { DeviceType } from "@camstack/types";
+import type { UseDeviceProxyTrpc } from "../../hooks/use-device-proxy";
+import { type ControlAlign } from "./atoms";
+export { coverHighlight } from "./cover-inline";
 export interface DeviceControlProps {
-    readonly trpc: UseDeviceProxyTrpc;
-    readonly deviceId: number;
-    readonly features: readonly string[] | undefined;
-    /** Enable optimistic UI mode (default: true). Set to false to disable. */
-    readonly optimistic?: boolean;
+	readonly trpc: UseDeviceProxyTrpc;
+	readonly deviceId: number;
+	readonly features: readonly string[] | undefined;
+	/** Enable optimistic UI mode (default: true). Set to false to disable. */
+	readonly optimistic?: boolean;
 }
 export interface DeviceTypeControl {
-    /** Compact, state-aware controls rendered directly in a device-list row. */
-    readonly InlineControl: (p: DeviceControlProps) => ReactNode;
-    /** Full control surface rendered as a card in the device-detail hero area. */
-    readonly HeroCard: (p: DeviceControlProps) => ReactNode;
+	/** Compact, state-aware controls rendered directly in a device-list row. */
+	readonly InlineControl: (p: DeviceControlProps) => ReactNode;
+	/** Full control surface rendered as a card in the device-detail hero area. */
+	readonly HeroCard: (p: DeviceControlProps) => ReactNode;
 }
 /**
- * Exhaustive record over DeviceType, DERIVED from the shared decision
- * (`DEVICE_TYPE_CONTROL_KIND`) composed with the web `CONTROL_KIND_COMPONENTS`
- * binding — so the type→control mapping can never diverge from the single
- * source in `@camstack/types`. Preserved as a public export for consumers/tests
- * that index it by `DeviceType`.
- *
- * The `Object.fromEntries` result is a `{ [k: string]: DeviceTypeControl }`;
- * `Object.values(DeviceType)` (a string enum) yields exactly the enum's members,
- * so the record is fully populated — the assertion narrows that documented
- * enum-record projection boundary.
- */
+* Exhaustive record over DeviceType, DERIVED from the shared decision
+* (`DEVICE_TYPE_CONTROL_KIND`) composed with the web `CONTROL_KIND_COMPONENTS`
+* binding — so the type→control mapping can never diverge from the single
+* source in `@camstack/types`. Preserved as a public export for consumers/tests
+* that index it by `DeviceType`.
+*
+* The `Object.fromEntries` result is a `{ [k: string]: DeviceTypeControl }`;
+* `Object.values(DeviceType)` (a string enum) yields exactly the enum's members,
+* so the record is fully populated — the assertion narrows that documented
+* enum-record projection boundary.
+*/
 export declare const DEVICE_TYPE_CONTROL: Record<DeviceType, DeviceTypeControl>;
 /**
- * Per-type FILL flag.
- *
- *   true  — range / choice / button controls (cover ▲■▼ triad, thermostat
- *           setpoint stepper, media/control/button action buttons, alarm
- *           segmented control). The child STRETCHES to the full column width.
- *   false — readouts, tap-toggles, icon controls (lock), and dummy/placeholder
- *           types. The child keeps its NATURAL width; where it sits in the
- *           column (flush right vs centered) is decided by the caller via a
- *           `ControlPlacement` — see `resolveControlAlign`.
- *
- * Dummy types (Camera, Hub, Generic, Weather, Vacuum, Container, and placeholder
- * types Notifier/Script/Automation whose InlineControl renders "—") are `false` —
- * the dash placeholder must not be stretched to the full column width. (AlarmPanel
- * has a real segmented inline control and is `true`.) When a later task gives a
- * remaining placeholder type a real stretchy inline control, flip its flag to true.
- *
- * Exhaustive over DeviceType — a missing member is a TypeScript build error.
- */
+* Per-type FILL flag.
+*
+*   true  — range / choice / button controls (cover ▲■▼ triad, thermostat
+*           setpoint stepper, media/control/button action buttons, alarm
+*           segmented control). The child STRETCHES to the full column width.
+*   false — readouts, tap-toggles, icon controls (lock), and dummy/placeholder
+*           types. The child keeps its NATURAL width; where it sits in the
+*           column (flush right vs centered) is decided by the caller via a
+*           `ControlPlacement` — see `resolveControlAlign`.
+*
+* Dummy types (Camera, Hub, Generic, Weather, Vacuum, Container, and placeholder
+* types Notifier/Script/Automation whose InlineControl renders "—") are `false` —
+* the dash placeholder must not be stretched to the full column width. (AlarmPanel
+* has a real segmented inline control and is `true`.) When a later task gives a
+* remaining placeholder type a real stretchy inline control, flip its flag to true.
+*
+* Exhaustive over DeviceType — a missing member is a TypeScript build error.
+*/
 export declare const CONTROL_FILLS: Record<DeviceType, boolean>;
 /**
- * Where a control sits, and whether the column carries the fixed `w-[140px]` box.
- *   'right'  — natural-width content flush to the fixed column's right edge (card / minimal views).
- *   'center' — natural-width content centered in the fixed column.
- *   'table'  — the column DROPS its fixed width and sizes to its content (table view). Every type
- *              resolves to FIT so the control takes its natural width and lays out in sequence with
- *              the trailing trash + status dot, never overflowing a fixed box and colliding.
- * FILL controls ignore 'right'/'center' (they always stretch to the fixed width); under 'table'
- * a FILL control simply takes its natural width in the content-sized wrapper.
- */
-export type ControlPlacement = 'right' | 'center' | 'table';
+* Where a control sits, and whether the column carries the fixed `w-[140px]` box.
+*   'right'  — natural-width content flush to the fixed column's right edge (card / minimal views).
+*   'center' — natural-width content centered in the fixed column.
+*   'table'  — the column DROPS its fixed width and sizes to its content (table view). Every type
+*              resolves to FIT so the control takes its natural width and lays out in sequence with
+*              the trailing trash + status dot, never overflowing a fixed box and colliding.
+* FILL controls ignore 'right'/'center' (they always stretch to the fixed width); under 'table'
+* a FILL control simply takes its natural width in the content-sized wrapper.
+*/
+export type ControlPlacement = "right" | "center" | "table";
 /**
- * Runtime-string-safe lookup: a device row's `type` crosses the wire as a plain
- * string. The type→control-kind DECISION is single-sourced in `@camstack/types`
- * (`resolveDeviceControlKind`, null for an unrecognised type); this maps the
- * resolved kind onto the web components.
- */
+* Runtime-string-safe lookup: a device row's `type` crosses the wire as a plain
+* string. The type→control-kind DECISION is single-sourced in `@camstack/types`
+* (`resolveDeviceControlKind`, null for an unrecognised type); this maps the
+* resolved kind onto the web components.
+*/
 export declare function resolveDeviceControl(type: string): DeviceTypeControl | null;
 /**
- * Runtime-string-safe alignment lookup for the fixed-width control column.
- *
- * A device's `type` crosses the wire as a plain string;
- * `DEVICE_TYPE_VALUES.has(type)` narrows it to `DeviceType` before indexing
- * `CONTROL_FILLS`, making the cast sound. The `'table'` placement is
- * content-width for EVERY type (returns `FIT`), so a wide control never
- * overflows a fixed box — the FILL flag is irrelevant there. For the fixed-box
- * placements a FILL type always stretches (`FILL`) and a natural-width type is
- * placed by the caller's `placement` — `'center'` → `CENTER`, `'right'` →
- * `RIGHT` (card / minimal view). An unrecognised type falls back to
- * natural-width placement.
- */
+* Runtime-string-safe alignment lookup for the fixed-width control column.
+*
+* A device's `type` crosses the wire as a plain string;
+* `DEVICE_TYPE_VALUES.has(type)` narrows it to `DeviceType` before indexing
+* `CONTROL_FILLS`, making the cast sound. The `'table'` placement is
+* content-width for EVERY type (returns `FIT`), so a wide control never
+* overflows a fixed box — the FILL flag is irrelevant there. For the fixed-box
+* placements a FILL type always stretches (`FILL`) and a natural-width type is
+* placed by the caller's `placement` — `'center'` → `CENTER`, `'right'` →
+* `RIGHT` (card / minimal view). An unrecognised type falls back to
+* natural-width placement.
+*/
 export declare function resolveControlAlign(type: string, placement: ControlPlacement): ControlAlign;

package/dist/composites/device-controls/cover-hero-card.d.ts

@@ -1,27 +1,27 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+import { type ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /**
- * CoverHeroCard — full control surface for the device-detail hero area.
- *
- * TWO VARIANTS based on whether the cover reports a position:
- *
- * With position (position !== null):
- *  - Window graphic with slats descending from top to (100-position)%
- *  - Visual (display-only) lever at the slat boundary with % label
- *  - Open / Stop / Close buttons with state-aware highlight
- *  - Interactive position range input (gated on CoverPositionable)
- *  - Tilt range input (gated on CoverTilt)
- *
- * Without position (open/close-only, position === null):
- *  - Window graphic showing state via clear pane (open) or full slats (closed)
- *  - NO lever, NO % label; the value slot shows the cover STATE text (no %)
- *  - Open / Stop / Close buttons with state-aware highlight
- *
- * Position support is detected via `CoverStatus.position !== null`.
- * The interactive setPosition slider is gated on `DeviceFeature.CoverPositionable`.
- *
- * Follows the same `useDeviceCapability` pattern as CoverPanel / CoverInlineControl.
- * Only hides when the device truly has no cover cap — a transient undefined slice
- * renders a neutral "unknown" state with all buttons still mounted.
- */
-export declare function CoverHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
+* CoverHeroCard — full control surface for the device-detail hero area.
+*
+* TWO VARIANTS based on whether the cover reports a position:
+*
+* With position (position !== null):
+*  - Window graphic with slats descending from top to (100-position)%
+*  - Visual (display-only) lever at the slat boundary with % label
+*  - Open / Stop / Close buttons with state-aware highlight
+*  - Interactive position range input (gated on CoverPositionable)
+*  - Tilt range input (gated on CoverTilt)
+*
+* Without position (open/close-only, position === null):
+*  - Window graphic showing state via clear pane (open) or full slats (closed)
+*  - NO lever, NO % label; the value slot shows the cover STATE text (no %)
+*  - Open / Stop / Close buttons with state-aware highlight
+*
+* Position support is detected via `CoverStatus.position !== null`.
+* The interactive setPosition slider is gated on `DeviceFeature.CoverPositionable`.
+*
+* Follows the same `useDeviceCapability` pattern as CoverPanel / CoverInlineControl.
+* Only hides when the device truly has no cover cap — a transient undefined slice
+* renders a neutral "unknown" state with all buttons still mounted.
+*/
+export declare function CoverHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;

package/dist/composites/device-controls/cover-inline.d.ts

@@ -1,27 +1,27 @@
-import { ReactNode } from 'react';
-import { CoverState } from '@camstack/types';
-import { DeviceControlProps } from './control-registry';
+import type { ReactNode } from "react";
+import type { CoverState } from "@camstack/types";
+import type { DeviceControlProps } from "./control-registry";
 /** Button highlight variant for cover state-aware colouring. */
-export type CoverHighlightVariant = 'accent' | 'filled' | 'neutral';
+export type CoverHighlightVariant = "accent" | "filled" | "neutral";
 export interface CoverButtonHighlight {
-    readonly up: CoverHighlightVariant;
-    readonly stop: CoverHighlightVariant;
-    readonly down: CoverHighlightVariant;
+	readonly up: CoverHighlightVariant;
+	readonly stop: CoverHighlightVariant;
+	readonly down: CoverHighlightVariant;
 }
 /**
- * Pure helper — maps a live CoverState (or undefined when no slice yet)
- * to per-button highlight variants.
- *
- *   opening → up:accent  (transient/active upward motion)
- *   closing → down:accent (transient/active downward motion)
- *   open    → up:filled   (stable fully-open state)
- *   closed  → down:filled (stable fully-closed state)
- *   stopped / undefined → neutral (no active state)
- */
+* Pure helper — maps a live CoverState (or undefined when no slice yet)
+* to per-button highlight variants.
+*
+*   opening → up:accent  (transient/active upward motion)
+*   closing → down:accent (transient/active downward motion)
+*   open    → up:filled   (stable fully-open state)
+*   closed  → down:filled (stable fully-closed state)
+*   stopped / undefined → neutral (no active state)
+*/
 export declare function coverHighlight(state: CoverState | undefined): CoverButtonHighlight;
 /**
- * CoverInlineControl — compact, state-aware cover controls for a
- * device-list row. Renders ↑ ■ ↓ buttons + optional % open badge.
- * Reuses `useDeviceCapability` exactly as `CoverPanel` does.
- */
+* CoverInlineControl — compact, state-aware cover controls for a
+* device-list row. Renders ↑ ■ ↓ buttons + optional % open badge.
+* Reuses `useDeviceCapability` exactly as `CoverPanel` does.
+*/
 export declare function CoverInlineControl({ trpc, deviceId, optimistic }: DeviceControlProps): ReactNode;

package/dist/composites/device-controls/cover-panel.d.ts

@@ -1,3 +1,3 @@
-import { ReactNode } from 'react';
-import { ControlPanelProps } from './types';
+import type { ReactNode } from "react";
+import type { ControlPanelProps } from "./types";
 export declare function CoverPanel({ trpc, deviceId, features, layout }: ControlPanelProps): ReactNode;

package/dist/composites/device-controls/dummy-hero-card.d.ts

@@ -1,5 +1,5 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /** Inline placeholder: renders nothing (no-op row atom for types with no inline control). */
 export declare function DummyInline(_p: DeviceControlProps): ReactNode;
 /** Hero card placeholder: shows a muted "Controls coming soon" card for unimplemented types. */

package/dist/composites/device-controls/fan-hero-card.d.ts

@@ -1,21 +1,21 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /**
- * FanHeroCard — radial speed-dial hero for Fan devices.
- *
- * Renders:
- *  - RadialGauge: draggable speed ArcKnob riding a 270° ring at the speed
- *    fraction (drag snaps to the device's percentageStep), centered fan glyph +
- *    percentage readout. The gauge is the sole speed control — no slider.
- *  - Preset selector (centered) — ONLY when the device advertises
- *    DeviceFeature.FanPreset AND the slice exposes a non-empty
- *    `availablePresets`.
- *  - TAP TOGGLE for on/off (Spec §3 — NOT a SlideToggle; slide is safety-only).
- *  - Oscillate toggle button — ONLY when the device advertises
- *    DeviceFeature.FanOscillating AND the slice exposes a non-null
- *    `oscillating` value.
- *
- * Composes two caps: `switch` (on/off) + `fan-control` (speed / oscillate).
- * Cap-gated on `switch` (always present on a Fan) — returns null without it.
- */
-export declare function FanHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
+* FanHeroCard — radial speed-dial hero for Fan devices.
+*
+* Renders:
+*  - RadialGauge: draggable speed ArcKnob riding a 270° ring at the speed
+*    fraction (drag snaps to the device's percentageStep), centered fan glyph +
+*    percentage readout. The gauge is the sole speed control — no slider.
+*  - Preset selector (centered) — ONLY when the device advertises
+*    DeviceFeature.FanPreset AND the slice exposes a non-empty
+*    `availablePresets`.
+*  - TAP TOGGLE for on/off (Spec §3 — NOT a SlideToggle; slide is safety-only).
+*  - Oscillate toggle button — ONLY when the device advertises
+*    DeviceFeature.FanOscillating AND the slice exposes a non-null
+*    `oscillating` value.
+*
+* Composes two caps: `switch` (on/off) + `fan-control` (speed / oscillate).
+* Cap-gated on `switch` (always present on a Fan) — returns null without it.
+*/
+export declare function FanHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;

package/dist/composites/device-controls/fan-panel.d.ts

@@ -1,3 +1,3 @@
-import { ReactNode } from 'react';
-import { ControlPanelProps } from './types';
-export declare function FanPanel({ trpc, deviceId, features, layout, optimistic, }: ControlPanelProps): ReactNode;
+import type { ReactNode } from "react";
+import type { ControlPanelProps } from "./types";
+export declare function FanPanel({ trpc, deviceId, features, layout, optimistic }: ControlPanelProps): ReactNode;

package/dist/composites/device-controls/humidifier-control.d.ts

@@ -1,37 +1,54 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+/**
+* Humidifier controls for a `DeviceType.Humidifier` device.
+*
+* Reads the `humidifier` cap status slice (on / current / target /
+* mode / action / bounds) and renders:
+*   - HumidifierInlineControl (device-list row): a compact on/off
+*     tap-toggle + a small `current%→target%` readout. Row-narrow.
+*   - HumidifierHeroCard (device-detail hero): a bespoke state-tinted
+*     droplet + rising-mist SVG in the framed-box language, an on/off
+*     toggle, a target-humidity range slider with a `%` readout, a
+*     current-humidity readout, and a mode `<select>` (only when modes
+*     are available).
+*
+* Mirrors the climate / valve controls' `useDeviceCapability` +
+* `useOptimisticSlice` pattern so the row and hero never diverge.
+* Controls are gated on `available`. The decorative SVG is aria-hidden.
+*/
+import { type ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /** The `action` HA attribute drives the droplet / mist tint. */
-export type HumidifierAction = 'humidifying' | 'drying' | 'idle' | 'off';
+export type HumidifierAction = "humidifying" | "drying" | "idle" | "off";
 export interface HumidifierTint {
-    /** Tailwind class for the wash behind the droplet. */
-    readonly glow: string;
-    /** Tailwind text token driving the droplet via currentColor. */
-    readonly accent: string;
-    /** Whether to render the upward mist dashes (actively humidifying). */
-    readonly misting: boolean;
+	/** Tailwind class for the wash behind the droplet. */
+	readonly glow: string;
+	/** Tailwind text token driving the droplet via currentColor. */
+	readonly accent: string;
+	/** Whether to render the upward mist dashes (actively humidifying). */
+	readonly misting: boolean;
 }
 /**
- * Pure helper — maps the device's on-state + HA `action` to a tint.
- * Exhaustive over the known action strings; an unknown / null action
- * falls back to on/off heuristics.
- *
- *   humidifying → primary (blue)
- *   drying      → warning
- *   idle / off  → muted
- */
+* Pure helper — maps the device's on-state + HA `action` to a tint.
+* Exhaustive over the known action strings; an unknown / null action
+* falls back to on/off heuristics.
+*
+*   humidifying → primary (blue)
+*   drying      → warning
+*   idle / off  → muted
+*/
 export declare function humidifierTint(on: boolean, action: string | null): HumidifierTint;
 /**
- * HumidifierInlineControl — compact on/off toggle + current→target readout
- * for a device-list row. Must NOT blow out the row width.
- */
-export declare function HumidifierInlineControl({ trpc, deviceId, optimistic, }: DeviceControlProps): ReactNode;
+* HumidifierInlineControl — compact on/off toggle + current→target readout
+* for a device-list row. Must NOT blow out the row width.
+*/
+export declare function HumidifierInlineControl({ trpc, deviceId, optimistic }: DeviceControlProps): ReactNode;
 /**
- * HumidifierHeroCard — full control surface for the device-detail hero.
- *
- * Bespoke droplet + mist graphic + a large target-humidity readout +
- * an on/off toggle + a target-humidity range slider (bounds from
- * min/maxHumidity ?? 0..100) + a current-humidity readout + a mode
- * `<select>` (only when modes are available). Gated on `available`.
- * Only hides when the device truly has no humidifier cap.
- */
+* HumidifierHeroCard — full control surface for the device-detail hero.
+*
+* Bespoke droplet + mist graphic + a large target-humidity readout +
+* an on/off toggle + a target-humidity range slider (bounds from
+* min/maxHumidity ?? 0..100) + a current-humidity readout + a mode
+* `<select>` (only when modes are available). Gated on `available`.
+* Only hides when the device truly has no humidifier cap.
+*/
 export declare function HumidifierHeroCard({ trpc, deviceId, optimistic }: DeviceControlProps): ReactNode;

package/dist/composites/device-controls/image-control.d.ts

@@ -1,35 +1,49 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
 /**
- * ImageDetailModal — a full-view image dialog with zoom in/out/reset and pan
- * (scroll when zoomed). Generous padding frames the image. Opened by clicking
- * the inline thumbnail or the hero image. Controlled via `open`/`onOpenChange`.
- */
-export declare function ImageDetailModal({ url, alt, open, onOpenChange, }: {
-    readonly url: string;
-    readonly alt: string;
-    readonly open: boolean;
-    readonly onOpenChange: (open: boolean) => void;
+* Image controls for a `DeviceType.Image` device.
+*
+* Read-only: the `image` cap has no setters. Reads the `image` cap status
+* slice (an absolute signed `url` the browser loads directly) and renders:
+*   - ImageInlineControl (device-list row): a small thumbnail when a url
+*     is present; a muted `ImageOff` placeholder when null. Row-narrow.
+*   - ImageHeroCard (device-detail hero): a framed image in the
+*     cover-style framed box (object-contain) when a url is present; a
+*     centered placeholder when null.
+*
+* Mirrors the read pattern of the other controls' `useDeviceCapability`
+* usage so the row and hero never diverge.
+*/
+import { type ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
+/**
+* ImageDetailModal — a full-view image dialog with zoom in/out/reset and pan
+* (scroll when zoomed). Generous padding frames the image. Opened by clicking
+* the inline thumbnail or the hero image. Controlled via `open`/`onOpenChange`.
+*/
+export declare function ImageDetailModal({ url, alt, open, onOpenChange }: {
+	readonly url: string;
+	readonly alt: string;
+	readonly open: boolean;
+	readonly onOpenChange: (open: boolean) => void;
 }): ReactNode;
 /**
- * ImageInlineControl — compact thumbnail for a device-list row that expands
- * into a floating preview on hover/focus (shared `HoverZoomImage`). Shows a
- * muted ImageOff placeholder box when no url is available. Row-narrow.
- *
- * `DeviceControlProps` carries no device name, so the alt/caption is the
- * generic 'Image'; the framed hero (ImageHeroCard) carries the real name.
- */
+* ImageInlineControl — compact thumbnail for a device-list row that expands
+* into a floating preview on hover/focus (shared `HoverZoomImage`). Shows a
+* muted ImageOff placeholder box when no url is available. Row-narrow.
+*
+* `DeviceControlProps` carries no device name, so the alt/caption is the
+* generic 'Image'; the framed hero (ImageHeroCard) carries the real name.
+*/
 export declare function ImageInlineControl({ trpc, deviceId }: DeviceControlProps): ReactNode;
 export interface ImageHeroCardProps extends DeviceControlProps {
-    /** Optional device name for the image alt text. */
-    readonly deviceName?: string;
+	/** Optional device name for the image alt text. */
+	readonly deviceName?: string;
 }
 /**
- * ImageHeroCard — read-only framed image for the device-detail hero.
- *
- * A still image in the cover-style framed box (rounded border,
- * object-contain) when a url is present; a centered ImageOff + "No image"
- * placeholder when null. Keeps the framed-box chrome for visual
- * consistency with the other heroes.
- */
+* ImageHeroCard — read-only framed image for the device-detail hero.
+*
+* A still image in the cover-style framed box (rounded border,
+* object-contain) when a url is present; a centered ImageOff + "No image"
+* placeholder when null. Keeps the framed-box chrome for visual
+* consistency with the other heroes.
+*/
 export declare function ImageHeroCard({ trpc, deviceId, deviceName }: ImageHeroCardProps): ReactNode;

package/dist/composites/device-controls/index.d.ts

@@ -1,34 +1,34 @@
-export { ControlColumn, ValueReadout, FILL, RIGHT, CENTER, type ControlAlign, Stepper, SlideToggle, ArcKnob, GripTrack, } from './atoms';
-export { RadialGauge, type RadialGaugeProps } from './radial-gauge';
-export { TapToggle, type TapToggleProps } from './tap-toggle';
-export { ButtonControl, ButtonHeroCard } from './button-control';
-export { CoverPanel } from './cover-panel';
-export { LockPanel } from './lock-panel';
-export { SwitchPanel } from './switch-panel';
-export { BrightnessPanel } from './brightness-panel';
-export { FanPanel } from './fan-panel';
-export { ClimatePanel, MODE_COLOR } from './climate-panel';
-export { MediaPlayerPanel, STATE_COLOR } from './media-player-panel';
-export { ControlPanel } from './control-panel';
-export { CONTROL_CAP_NAMES, type ControlCapName, type ControlPanelProps } from './types';
-export { PopoverRowAction } from './popover-row-action';
-export { SensorValueAtom, ROLE_DESCRIPTOR, type SensorDescriptor, type SensorValueAtomProps, } from './sensor-value-atom';
-export { DEVICE_TYPE_CONTROL, CONTROL_FILLS, resolveDeviceControl, resolveControlAlign, coverHighlight, type DeviceTypeControl, type DeviceControlProps, type ControlPlacement, } from './control-registry';
-export { OfflineBadge, type OfflineBadgeProps } from './offline-badge';
-export { CoverInlineControl, type CoverHighlightVariant, type CoverButtonHighlight, } from './cover-inline';
-export { CoverHeroCard } from './cover-hero-card';
-export { VacuumInlineControl, VacuumHeroCard, vacuumStateMeta, tankAlert, type VacuumStateMeta, type TankKind, type TankAlert, } from './vacuum-control';
-export { LawnMowerInlineControl, LawnMowerHeroCard, lawnMowerActivityMeta, type LawnMowerActivityMeta, } from './lawn-mower-control';
-export { ValveInlineControl, ValveHeroCard, valveStateMeta, type ValveStateMeta, } from './valve-control';
-export { HumidifierInlineControl, HumidifierHeroCard, humidifierTint, type HumidifierTint, type HumidifierAction, } from './humidifier-control';
-export { WaterHeaterInlineControl, WaterHeaterHeroCard, waterHeaterTint, waterHeaterPhase, type WaterHeaterTint, type WaterHeaterPhase, } from './water-heater-control';
-export { WeatherInlineControl, WeatherHeroCard, weatherTint, weatherConditionMeta, type WeatherTint, type WeatherConditionMeta, type WeatherGlyph, } from './weather-control';
-export { ImageInlineControl, ImageHeroCard, type ImageHeroCardProps, } from './image-control';
-export { DummyInline, DummyHeroCard } from './dummy-hero-card';
-export { SensorInlineControl } from './sensor-inline-control';
-export { SensorHeroCard } from './sensor-hero-card';
-export { SwitchInlineControl, SwitchHeroCard, LockInlineControl, LockHeroCard, LightInlineControl, LightHeroCard, FanInlineControl, FanHeroCard, ThermostatInlineControl, ThermostatHeroCard, MediaPlayerInlineControl, MediaPlayerHeroCard, AlarmPanelInlineControl, AlarmHeroCard, ScriptInlineControl, ScriptHeroCard, AutomationInlineControl, AutomationHeroCard, ControlInlineControl, ControlHeroCard, } from './panel-controls';
-export { resolvePrimaryChild, PRIORITY, type ChildRef } from './primary-child';
-export { resolveContainerPrimary, overrideEntityIdFromLink, containerChildToRef, childEntityId, type ContainerChild, } from './container-primary';
-export { ContainerPrimaryHero, type ContainerPrimaryHeroProps, type ContainerHeroChild, } from './container-primary-hero';
-export { PrimaryChildPicker, type PrimaryChildPickerProps, type PrimaryChildOption, } from './primary-child-picker';
+export { ControlColumn, ValueReadout, FILL, RIGHT, CENTER, type ControlAlign, Stepper, SlideToggle, ArcKnob, GripTrack } from "./atoms";
+export { RadialGauge, type RadialGaugeProps } from "./radial-gauge";
+export { TapToggle, type TapToggleProps } from "./tap-toggle";
+export { ButtonControl, ButtonHeroCard } from "./button-control";
+export { CoverPanel } from "./cover-panel";
+export { LockPanel } from "./lock-panel";
+export { SwitchPanel } from "./switch-panel";
+export { BrightnessPanel } from "./brightness-panel";
+export { FanPanel } from "./fan-panel";
+export { ClimatePanel, MODE_COLOR } from "./climate-panel";
+export { MediaPlayerPanel, STATE_COLOR } from "./media-player-panel";
+export { ControlPanel } from "./control-panel";
+export { CONTROL_CAP_NAMES, type ControlCapName, type ControlPanelProps } from "./types";
+export { PopoverRowAction } from "./popover-row-action";
+export { SensorValueAtom, ROLE_DESCRIPTOR, type SensorDescriptor, type SensorValueAtomProps } from "./sensor-value-atom";
+export { DEVICE_TYPE_CONTROL, CONTROL_FILLS, resolveDeviceControl, resolveControlAlign, coverHighlight, type DeviceTypeControl, type DeviceControlProps, type ControlPlacement } from "./control-registry";
+export { OfflineBadge, type OfflineBadgeProps } from "./offline-badge";
+export { CoverInlineControl, type CoverHighlightVariant, type CoverButtonHighlight } from "./cover-inline";
+export { CoverHeroCard } from "./cover-hero-card";
+export { VacuumInlineControl, VacuumHeroCard, vacuumStateMeta, tankAlert, type VacuumStateMeta, type TankKind, type TankAlert } from "./vacuum-control";
+export { LawnMowerInlineControl, LawnMowerHeroCard, lawnMowerActivityMeta, type LawnMowerActivityMeta } from "./lawn-mower-control";
+export { ValveInlineControl, ValveHeroCard, valveStateMeta, type ValveStateMeta } from "./valve-control";
+export { HumidifierInlineControl, HumidifierHeroCard, humidifierTint, type HumidifierTint, type HumidifierAction } from "./humidifier-control";
+export { WaterHeaterInlineControl, WaterHeaterHeroCard, waterHeaterTint, waterHeaterPhase, type WaterHeaterTint, type WaterHeaterPhase } from "./water-heater-control";
+export { WeatherInlineControl, WeatherHeroCard, weatherTint, weatherConditionMeta, type WeatherTint, type WeatherConditionMeta, type WeatherGlyph } from "./weather-control";
+export { ImageInlineControl, ImageHeroCard, type ImageHeroCardProps } from "./image-control";
+export { DummyInline, DummyHeroCard } from "./dummy-hero-card";
+export { SensorInlineControl } from "./sensor-inline-control";
+export { SensorHeroCard } from "./sensor-hero-card";
+export { SwitchInlineControl, SwitchHeroCard, LockInlineControl, LockHeroCard, LightInlineControl, LightHeroCard, FanInlineControl, FanHeroCard, ThermostatInlineControl, ThermostatHeroCard, MediaPlayerInlineControl, MediaPlayerHeroCard, AlarmPanelInlineControl, AlarmHeroCard, ScriptInlineControl, ScriptHeroCard, AutomationInlineControl, AutomationHeroCard, ControlInlineControl, ControlHeroCard } from "./panel-controls";
+export { resolvePrimaryChild, PRIORITY, type ChildRef } from "./primary-child";
+export { resolveContainerPrimary, overrideEntityIdFromLink, containerChildToRef, childEntityId, type ContainerChild } from "./container-primary";
+export { ContainerPrimaryHero, type ContainerPrimaryHeroProps, type ContainerHeroChild } from "./container-primary-hero";
+export { PrimaryChildPicker, type PrimaryChildPickerProps, type PrimaryChildOption } from "./primary-child-picker";