@camstack/ui-library 1.2.256 → 1.2.258

package/dist/composites/device-controls/lawn-mower-control.d.ts

@@ -1,24 +1,38 @@
-import { ReactNode } from 'react';
-import { LawnMowerActivity } from '@camstack/types';
-import { DeviceControlProps } from './control-registry';
+/**
+* Robotic lawn-mower controls for a `DeviceType.LawnMower` device.
+*
+* Reads the `lawn-mower-control` cap status slice (activity /
+* batteryLevel) and renders:
+*   - LawnMowerInlineControl (device-list row): compact Mow / Pause /
+*     Dock buttons with activity-aware highlight + a battery % badge.
+*   - LawnMowerHeroCard (device-detail hero): an activity label, the
+*     full action set (Start mowing / Pause / Dock), and the battery
+*     readout.
+*
+* Mirrors the vacuum/cover controls' `useDeviceCapability` pattern so the
+* row and hero never diverge. Buttons are gated on `available`.
+*/
+import type { ReactNode } from "react";
+import type { LawnMowerActivity } from "@camstack/types";
+import type { DeviceControlProps } from "./control-registry";
 export interface LawnMowerActivityMeta {
-    readonly label: string;
-    /** Tailwind text-colour token for the activity label. */
-    readonly tone: string;
+	readonly label: string;
+	/** Tailwind text-colour token for the activity label. */
+	readonly tone: string;
 }
 /**
- * Pure helper — maps a LawnMowerActivity (or undefined when no slice
- * yet) to a human label + colour tone. Exhaustive switch: a new enum
- * member fails the build.
- */
+* Pure helper — maps a LawnMowerActivity (or undefined when no slice
+* yet) to a human label + colour tone. Exhaustive switch: a new enum
+* member fails the build.
+*/
 export declare function lawnMowerActivityMeta(activity: LawnMowerActivity | undefined): LawnMowerActivityMeta;
 /**
- * LawnMowerInlineControl — compact, activity-aware mower controls for a
- * device-list row. Mow / Pause / Dock + battery badge.
- */
+* LawnMowerInlineControl — compact, activity-aware mower controls for a
+* device-list row. Mow / Pause / Dock + battery badge.
+*/
 export declare function LawnMowerInlineControl({ trpc, deviceId }: DeviceControlProps): ReactNode;
 /**
- * LawnMowerHeroCard — full control surface for the device-detail hero
- * area. Activity label + action buttons + battery readout.
- */
+* LawnMowerHeroCard — full control surface for the device-detail hero
+* area. Activity label + action buttons + battery readout.
+*/
 export declare function LawnMowerHeroCard({ trpc, deviceId }: DeviceControlProps): ReactNode;

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

@@ -1,16 +1,16 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /**
- * LightHeroCard — radial dimmer hero for Light devices.
- *
- * Renders:
- *  - RadialGauge: brightness ArcKnob riding a 270° ring at the level fraction,
- *    centered bulb glyph + percentage readout.
- *  - TAP TOGGLE for on/off (Spec §3 — NOT a SlideToggle; slide is safety-only).
- *  - Colour-temperature GripTrack strip — ONLY when the device advertises
- *    DeviceFeature.LightColorMired AND the `color` cap is bound.
- *
- * Composes three caps: `switch` (on/off), `brightness` (level), `color` (CT).
- * Cap-gated on `switch` (always present on a Light) — returns null without it.
- */
-export declare function LightHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
+* LightHeroCard — radial dimmer hero for Light devices.
+*
+* Renders:
+*  - RadialGauge: brightness ArcKnob riding a 270° ring at the level fraction,
+*    centered bulb glyph + percentage readout.
+*  - TAP TOGGLE for on/off (Spec §3 — NOT a SlideToggle; slide is safety-only).
+*  - Colour-temperature GripTrack strip — ONLY when the device advertises
+*    DeviceFeature.LightColorMired AND the `color` cap is bound.
+*
+* Composes three caps: `switch` (on/off), `brightness` (level), `color` (CT).
+* Cap-gated on `switch` (always present on a Light) — returns null without it.
+*/
+export declare function LightHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;

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

@@ -1,15 +1,15 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /**
- * LockHeroCard — padlock hero for lock devices.
- *
- * Renders:
- *  - Padlock glyph: state-colored (locked=green, unlocked=amber, jammed=red)
- *  - SlideToggle (safety gesture): thumb must be dragged past threshold to
- *    confirm lock/unlock — a plain tap never triggers the action (Spec §3).
- *  - Open (unlatch) button: rendered ONLY when device.features includes
- *    DeviceFeature.LockOpen ('lock-open'). Absent otherwise.
- *
- * Cap-gated: returns null when the device has no lockControl cap.
- */
-export declare function LockHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
+* LockHeroCard — padlock hero for lock devices.
+*
+* Renders:
+*  - Padlock glyph: state-colored (locked=green, unlocked=amber, jammed=red)
+*  - SlideToggle (safety gesture): thumb must be dragged past threshold to
+*    confirm lock/unlock — a plain tap never triggers the action (Spec §3).
+*  - Open (unlatch) button: rendered ONLY when device.features includes
+*    DeviceFeature.LockOpen ('lock-open'). Absent otherwise.
+*
+* Cap-gated: returns null when the device has no lockControl cap.
+*/
+export declare function LockHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;

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

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

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

@@ -1,17 +1,17 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /**
- * MediaPlayerHeroCard — now-playing hero for MediaPlayer devices.
- *
- * Renders (Spec §3):
- *  - Now-playing block: cover glyph + title + artist/album.
- *  - Seek GripTrack with a native range overlay (gated on DeviceFeature
- *    MediaPlayerSeek + a known duration).
- *  - Transport row: SkipBack / Play-Pause / SkipForward (lucide icons). Skip
- *    buttons are gated on MediaPlayerPrevious / MediaPlayerNext.
- *  - Volume GripTrack with a native range overlay + mute toggle (gated on a
- *    non-null volume surface + DeviceFeature.MediaPlayerVolume).
- *
- * Cap-gated on `media-player` — returns null when the device lacks the cap.
- */
-export declare function MediaPlayerHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
+* MediaPlayerHeroCard — now-playing hero for MediaPlayer devices.
+*
+* Renders (Spec §3):
+*  - Now-playing block: cover glyph + title + artist/album.
+*  - Seek GripTrack with a native range overlay (gated on DeviceFeature
+*    MediaPlayerSeek + a known duration).
+*  - Transport row: SkipBack / Play-Pause / SkipForward (lucide icons). Skip
+*    buttons are gated on MediaPlayerPrevious / MediaPlayerNext.
+*  - Volume GripTrack with a native range overlay + mute toggle (gated on a
+*    non-null volume surface + DeviceFeature.MediaPlayerVolume).
+*
+* Cap-gated on `media-player` — returns null when the device lacks the cap.
+*/
+export declare function MediaPlayerHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;

package/dist/composites/device-controls/media-player-panel.d.ts

@@ -1,9 +1,9 @@
-import { ReactNode } from 'react';
-import { ControlPanelProps } from './types.js';
-import { MediaPlayerState } from '@camstack/types';
+import type { ReactNode } from "react";
+import type { ControlPanelProps } from "./types.js";
+import type { MediaPlayerState } from "@camstack/types";
 /**
- * Exhaustive colour map — one entry per MediaPlayerState.
- * Build fails if a state is added and not reflected here.
- */
+* Exhaustive colour map — one entry per MediaPlayerState.
+* Build fails if a state is added and not reflected here.
+*/
 export declare const STATE_COLOR: Record<MediaPlayerState, string>;
-export declare function MediaPlayerPanel({ trpc, deviceId, features: _features, layout, optimistic, }: ControlPanelProps): ReactNode;
+export declare function MediaPlayerPanel({ trpc, deviceId, features: _features, layout, optimistic }: ControlPanelProps): ReactNode;

package/dist/composites/device-controls/offline-badge.d.ts

@@ -1,11 +1,26 @@
-import { ReactElement } from 'react';
+/**
+* OfflineBadge — a small, shared "device is unreachable" pill.
+*
+* Rendered ONCE per device (in the detail hero header) when the
+* device-status slice reports `online: false`. Controls themselves stay
+* mounted showing their last-known value (greyed/read-only via the
+* `useDeviceCapability` `available` gate); this badge is the single,
+* legible explanation of WHY they're inert plus how long ago the device
+* was last seen.
+*
+* Pure presentational atom: no fetches, no internal state. The caller
+* supplies `lastChangedAt` (the device-status `lastChangedAt` /
+* `useDeviceCapability` `offlineSince`). When it is absent or
+* non-positive only the "Unavailable" label renders.
+*/
+import type { ReactElement } from "react";
 export interface OfflineBadgeProps {
-    /**
-     * Ms epoch of the last online→offline transition (device-status
-     * `lastChangedAt`). `null`/`undefined`/non-positive → no "last seen"
-     * suffix is shown.
-     */
-    readonly lastChangedAt?: number | null;
-    readonly className?: string;
+	/**
+	* Ms epoch of the last online→offline transition (device-status
+	* `lastChangedAt`). `null`/`undefined`/non-positive → no "last seen"
+	* suffix is shown.
+	*/
+	readonly lastChangedAt?: number | null;
+	readonly className?: string;
 }
 export declare function OfflineBadge({ lastChangedAt, className }: OfflineBadgeProps): ReactElement;

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

@@ -1,20 +1,39 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
-export { ThermostatHeroCard } from './thermostat-hero-card';
-export { LockHeroCard } from './lock-hero-card';
-export { LightHeroCard } from './light-hero-card';
-export { FanHeroCard } from './fan-hero-card';
-export { SwitchHeroCard } from './switch-hero-card';
-export { MediaPlayerHeroCard } from './media-player-hero-card';
-export { AlarmHeroCard, AlarmInlineControl as AlarmPanelInlineControl } from './alarm-hero-card';
-export { AutomationHeroCard, AutomationInlineControl, ScriptHeroCard, ScriptInlineControl, } from './script-automation-controls';
-export declare function SwitchInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function LockInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function LightInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function FanInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function ThermostatInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function AcInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function AcHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function MediaPlayerInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function ControlInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function ControlHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
+/**
+* Panel-backed InlineControl and HeroCard wrappers for all non-Cover actuator types.
+*
+* Each wrapper:
+*  - Guards on `cap === undefined` → returns null (device has no such cap).
+*    Never disappears on a transient undefined slice; the panel itself handles that.
+*  - InlineControl: renders the panel at layout="compact" (row-sized).
+*  - HeroCard: renders the panel at layout="full" in the standard hero shell
+*    (rounded-lg border border-border bg-surface p-4, matching CoverHeroCard's shell).
+*
+* Mapped types:
+*   Switch / Siren → SwitchPanel
+*   Lock           → LockPanel
+*   Light          → SwitchPanel + BrightnessPanel (switch toggle + brightness slider)
+*   Fan            → SwitchPanel + FanPanel
+*   Thermostat     → ClimatePanel
+*   MediaPlayer    → MediaPlayerPanel
+*   Control        → ControlPanel
+*/
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
+export { ThermostatHeroCard } from "./thermostat-hero-card";
+export { LockHeroCard } from "./lock-hero-card";
+export { LightHeroCard } from "./light-hero-card";
+export { FanHeroCard } from "./fan-hero-card";
+export { SwitchHeroCard } from "./switch-hero-card";
+export { MediaPlayerHeroCard } from "./media-player-hero-card";
+export { AlarmHeroCard, AlarmInlineControl as AlarmPanelInlineControl } from "./alarm-hero-card";
+export { AutomationHeroCard, AutomationInlineControl, ScriptHeroCard, ScriptInlineControl } from "./script-automation-controls";
+export declare function SwitchInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function LockInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function LightInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function FanInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function ThermostatInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function AcInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function AcHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function MediaPlayerInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function ControlInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function ControlHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;

package/dist/composites/device-controls/pet-feeder-panel.d.ts

@@ -1,12 +1,30 @@
-import { ReactNode } from 'react';
-import { ControlPanelProps } from './types.js';
-export declare function PetFeederPanel({ trpc, deviceId, layout, optimistic, }: ControlPanelProps): ReactNode;
+/**
+* Pet-feeder controls for a `DeviceType.PetFeeder` device.
+*
+* Reads the `pet-feeder` cap status slice (foodLevel / food1 / food2 /
+* lowFood / batteryPower / desiccantLeftDays / feeding / status / error /
+* errorCode / isDualHopper + the four persisted settings) and renders:
+*   - PetFeederInlineControl (device-list row): a compact food-level +
+*     battery readout with a one-tap Feed button (default portion).
+*   - PetFeederHeroCard (device-detail hero): the food-bowl fill gauge
+*     signature, battery + desiccant readouts, a manual-feed portion
+*     stepper honouring the 4-200 g hardware range (per-hopper on
+*     dual-hopper models), a maintenance action row (Call pet / Reset
+*     desiccant / Mark refilled) and the child-lock / indicator-light /
+*     feed-sound / volume settings.
+*
+* Mirrors the AC card's `useDeviceCapability` + inferred-cap pattern so
+* the row and hero never diverge. Actions are gated on `available`.
+*/
+import { type ReactNode } from "react";
+import type { ControlPanelProps } from "./types.js";
+export declare function PetFeederPanel({ trpc, deviceId, layout, optimistic }: ControlPanelProps): ReactNode;
 interface DeviceControlProps {
-    readonly trpc: ControlPanelProps['trpc'];
-    readonly deviceId: number;
-    readonly features: readonly string[] | undefined;
-    readonly optimistic?: boolean;
+	readonly trpc: ControlPanelProps["trpc"];
+	readonly deviceId: number;
+	readonly features: readonly string[] | undefined;
+	readonly optimistic?: boolean;
 }
-export declare function PetFeederInlineControl({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
-export declare function PetFeederHeroCard({ trpc, deviceId, features, optimistic, }: DeviceControlProps): ReactNode;
+export declare function PetFeederInlineControl({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
+export declare function PetFeederHeroCard({ trpc, deviceId, features, optimistic }: DeviceControlProps): ReactNode;
 export {};

package/dist/composites/device-controls/popover-row-action.d.ts

@@ -1,9 +1,21 @@
-import { ReactNode } from 'react';
-import { LucideIcon } from 'lucide-react';
+/**
+* <PopoverRowAction> — generic icon-button → portal popover.
+*
+* Distilled from `PtzQuickAction` (device-item/actions.tsx): a 5x5
+* icon-button trigger that opens a fixed-position panel mounted on
+* `document.body` (so it escapes the table's `overflow` clip), anchored
+* under the trigger and clamped inside the viewport. Closes on a second
+* trigger click or an outside `mousedown`.
+*
+* Available for use by any composite that needs an icon-button → panel
+* popover pattern (e.g. PTZ quick-action, more-actions menu).
+*/
+import { type ReactNode } from "react";
+import type { LucideIcon } from "lucide-react";
 interface PopoverRowActionProps {
-    readonly icon: LucideIcon;
-    readonly title: string;
-    readonly children: ReactNode;
+	readonly icon: LucideIcon;
+	readonly title: string;
+	readonly children: ReactNode;
 }
-export declare function PopoverRowAction({ icon: Icon, title, children, }: PopoverRowActionProps): ReactNode;
+export declare function PopoverRowAction({ icon: Icon, title, children }: PopoverRowActionProps): ReactNode;
 export {};

package/dist/composites/device-controls/primary-child-picker.d.ts

@@ -1,20 +1,36 @@
-import { ReactNode } from 'react';
-import { ContainerChild } from './container-primary';
+/**
+* <PrimaryChildPicker> — controlled dropdown that selects which entity-child of
+* a CONTAINER device is its PRIMARY child.
+*
+* The picker is a thin, presentation-only controlled `<select>`: it carries each
+* child's numeric `id` on its `<option>` values (stable React keys + selection),
+* but reports a change as the chosen child's re-sync/rename-stable `entityId` —
+* which is what the durable override (`deviceManager.setPrimaryChildEntityId`)
+* persists. Resolving the CURRENT primary child (priority default vs. persisted
+* override) is the caller's job; this component only renders the choice and
+* surfaces a new pick.
+*
+* Extracted from the container detail hero so the same selector can live in the
+* device's primary config block (next to name / location) instead of floating on
+* the hero card. The hero no longer owns it.
+*/
+import type { ReactNode } from "react";
+import { type ContainerChild } from "./container-primary";
 /** A child row the picker can offer. */
 export interface PrimaryChildOption extends ContainerChild {
-    readonly name: string;
+	readonly name: string;
 }
 export interface PrimaryChildPickerProps {
-    /** The container's entity-children (from `deviceManager.getChildren`). */
-    readonly childrenList: readonly PrimaryChildOption[];
-    /** Numeric id of the currently-resolved primary child. */
-    readonly selectedId: number;
-    /** Called with the picked child's re-sync/rename-stable `entityId`. */
-    /** Called with the picked child's `stableId` — the canonical override key. */
-    readonly onSetPrimary: (childStableId: string) => void;
-    /** Disable the control while a persist is in flight. */
-    readonly disabled?: boolean;
-    /** Optional extra classes for the `<select>` (so a host row can size it). */
-    readonly className?: string;
+	/** The container's entity-children (from `deviceManager.getChildren`). */
+	readonly childrenList: readonly PrimaryChildOption[];
+	/** Numeric id of the currently-resolved primary child. */
+	readonly selectedId: number;
+	/** Called with the picked child's re-sync/rename-stable `entityId`. */
+	/** Called with the picked child's `stableId` — the canonical override key. */
+	readonly onSetPrimary: (childStableId: string) => void;
+	/** Disable the control while a persist is in flight. */
+	readonly disabled?: boolean;
+	/** Optional extra classes for the `<select>` (so a host row can size it). */
+	readonly className?: string;
 }
-export declare function PrimaryChildPicker({ childrenList, selectedId, onSetPrimary, disabled, className, }: PrimaryChildPickerProps): ReactNode;
+export declare function PrimaryChildPicker({ childrenList, selectedId, onSetPrimary, disabled, className }: PrimaryChildPickerProps): ReactNode;

package/dist/composites/device-controls/primary-child.d.ts

@@ -1,31 +1,20 @@
-/**
- * Which child a container is rendered AS — this surface's name for the shared
- * rule.
- *
- * The list and the resolution used to live here, in a COPY that carried a
- * comment asking the Home Assistant adoption mapping and the viewer's panel to
- * stay in sync with it. Three lists and three comments is not one rule, it is
- * three chances to drift. Both now come from `@camstack/types`, which all of
- * them already depend on; what remains here is the adapter for this module's
- * historical `ChildRef` shape.
- */
 /** The shared precedence, under this module's historical name. */
 export declare const PRIORITY: readonly string[];
 export interface ChildRef {
-    readonly id: number;
-    readonly entityId: string;
-    readonly type: string;
-    /** `DeviceRole`, ranked ABOVE `type` — see `CONTAINER_CHILD_ROLE_PRIORITY`. */
-    readonly role?: string | undefined;
-    /** Operator-facing name — used for the namesake tiebreak. */
-    readonly name?: string | undefined;
+	readonly id: number;
+	readonly entityId: string;
+	readonly type: string;
+	/** `DeviceRole`, ranked ABOVE `type` — see `CONTAINER_CHILD_ROLE_PRIORITY`. */
+	readonly role?: string | undefined;
+	/** Operator-facing name — used for the namesake tiebreak. */
+	readonly name?: string | undefined;
 }
 /**
- * Resolve a container's primary child: the operator's pick when it still
- * matches a live child, else the highest-priority type.
- *
- * `entityId` here is `sourceInfo?.id ?? stableId` (see `containerChildToRef`).
- * The shared resolver matches its canonical `stableId` key first and accepts
- * that legacy value too, so a pick stored under either keeps resolving.
- */
+* Resolve a container's primary child: the operator's pick when it still
+* matches a live child, else the highest-priority type.
+*
+* `entityId` here is `sourceInfo?.id ?? stableId` (see `containerChildToRef`).
+* The shared resolver matches its canonical `stableId` key first and accepts
+* that legacy value too, so a pick stored under either keeps resolving.
+*/
 export declare function resolvePrimaryChild(children: readonly ChildRef[], overrideEntityId: string | undefined, containerName?: string): ChildRef | null;

package/dist/composites/device-controls/radial-gauge.d.ts

@@ -1,20 +1,20 @@
-import { ReactNode } from 'react';
+import type { ReactNode } from "react";
 export interface RadialGaugeProps {
-    /** Fill fraction 0..1 (brightness or speed level). */
-    readonly fraction: number;
-    /** Hex/CSS colour for the fill arc + knob border. */
-    readonly color: string;
-    /** Centered content (icon + value readout). */
-    readonly children: ReactNode;
-    /**
-     * When provided, the ArcKnob becomes draggable: dragging it reports the new
-     * arc fraction (0..1) to the parent, which owns the value and re-renders the
-     * gauge at the new `fraction`. When omitted the knob is display-only.
-     */
-    readonly onDragFraction?: (fraction: number) => void;
+	/** Fill fraction 0..1 (brightness or speed level). */
+	readonly fraction: number;
+	/** Hex/CSS colour for the fill arc + knob border. */
+	readonly color: string;
+	/** Centered content (icon + value readout). */
+	readonly children: ReactNode;
+	/**
+	* When provided, the ArcKnob becomes draggable: dragging it reports the new
+	* arc fraction (0..1) to the parent, which owns the value and re-renders the
+	* gauge at the new `fraction`. When omitted the knob is display-only.
+	*/
+	readonly onDragFraction?: (fraction: number) => void;
 }
 /**
- * Circular gauge with an ArcKnob at `fraction` and centered children.
- * The knob wrapper carries `data-testid="arc-knob"` for test assertions.
- */
-export declare function RadialGauge({ fraction, color, children, onDragFraction, }: RadialGaugeProps): ReactNode;
+* Circular gauge with an ArcKnob at `fraction` and centered children.
+* The knob wrapper carries `data-testid="arc-knob"` for test assertions.
+*/
+export declare function RadialGauge({ fraction, color, children, onDragFraction }: RadialGaugeProps): ReactNode;

package/dist/composites/device-controls/script-automation-controls.d.ts

@@ -1,14 +1,14 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /**
- * "3 min ago", or nothing at all.
- *
- * **0 means NEVER RUN** on both status schemas, and it must not render as the
- * epoch. "1 Jan 1970" next to a script is the kind of detail that sends an
- * operator looking for a clock problem that does not exist.
- */
+* "3 min ago", or nothing at all.
+*
+* **0 means NEVER RUN** on both status schemas, and it must not render as the
+* epoch. "1 Jan 1970" next to a script is the kind of detail that sends an
+* operator looking for a clock problem that does not exist.
+*/
 export declare function lastRunLabel(atMs: number, nowMs: number): string | null;
 export declare function ScriptInlineControl({ trpc, deviceId, optimistic }: DeviceControlProps): ReactNode;
 export declare function ScriptHeroCard({ trpc, deviceId, optimistic }: DeviceControlProps): ReactNode;
-export declare function AutomationInlineControl({ trpc, deviceId, optimistic, }: DeviceControlProps): ReactNode;
+export declare function AutomationInlineControl({ trpc, deviceId, optimistic }: DeviceControlProps): ReactNode;
 export declare function AutomationHeroCard({ trpc, deviceId, optimistic }: DeviceControlProps): ReactNode;

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

@@ -1,10 +1,28 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
 /**
- * SensorHeroCard — full hero card for the device-detail area.
- *
- * Fetches the device row (name, role, sourceInfo) via React Query
- * (`deviceManager.getDevice`), then delegates rendering to the inner
- * component that reads the live state slice via the proxy.
- */
+* SensorHeroCard — large-format sensor value display for the device-detail
+* hero area.
+*
+* Renders:
+*  - Typed numeric sensors: value in `text-3xl font-semibold tabular-nums` +
+*    canonical unit from ROLE_DESCRIPTOR (e.g. temperature-sensor → '°C').
+*  - Generic numeric-sensor: value + unit read live from the slice
+*    (`slice.unit`, populated by the HA provider from state attributes).
+*  - Binary sensors: coloured state badge ("Detected"/"Clear" etc.) — same
+*    labels and colours as SensorValueAtom's binary branch.
+*  - Presence: Home/Away/zone-name badge — same labels as SensorValueAtom.
+*  - All: sensor name label below the value.
+*
+* Unit resolution uses the same logic as SensorValueAtom (live slice.unit
+* wins, ROLE_DESCRIPTOR canonicalUnit as fallback) — the two surfaces stay
+* in sync.
+*/
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
+/**
+* SensorHeroCard — full hero card for the device-detail area.
+*
+* Fetches the device row (name, role, sourceInfo) via React Query
+* (`deviceManager.getDevice`), then delegates rendering to the inner
+* component that reads the live state slice via the proxy.
+*/
 export declare function SensorHeroCard({ trpc, deviceId }: DeviceControlProps): ReactNode;

package/dist/composites/device-controls/sensor-inline-control.d.ts

@@ -1,11 +1,23 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
 /**
- * Registry InlineControl for Sensor and Presence device types.
- *
- * Fetches the device row once (React Query cache — no waterfall for
- * repeated renders), maps to DeviceItemDevice, and delegates rendering
- * to the existing SensorValueAtom so both the row special-case path and
- * the registry path stay in sync.
- */
+* SensorInlineControl — registry-compatible wrapper around SensorValueAtom.
+*
+* Bridges the registry's `DeviceControlProps` (trpc, deviceId, features) into
+* SensorValueAtom's `{trpc, device}` shape by fetching the device row (role)
+* from `deviceManager.getDevice`. Returns null while the device row is loading
+* or when no role is found (not a sensor accessory).
+*
+* Unit resolution happens in SensorValueAtom: typed roles use the descriptor's
+* canonical unit; generic numeric-sensor reads unit live from the slice.
+* sourceInfo is no longer needed here.
+*/
+import type { ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
+/**
+* Registry InlineControl for Sensor and Presence device types.
+*
+* Fetches the device row once (React Query cache — no waterfall for
+* repeated renders), maps to DeviceItemDevice, and delegates rendering
+* to the existing SensorValueAtom so both the row special-case path and
+* the registry path stay in sync.
+*/
 export declare function SensorInlineControl({ trpc, deviceId }: DeviceControlProps): ReactNode;