@camstack/ui-library 1.2.257 → 1.2.258

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

@@ -1,41 +1,59 @@
-import { ReactNode } from 'react';
-import { DeviceControlProps } from './control-registry';
+/**
+* Weather controls for a `DeviceType.Weather` device.
+*
+* Read-only: the `weather` cap has no setters. Reads the `weather` cap
+* status slice (condition + current temperature / humidity / pressure /
+* wind) and renders:
+*   - WeatherInlineControl (device-list row): a compact condition icon +
+*     temperature readout. Row-narrow.
+*   - WeatherHeroCard (device-detail hero): a bespoke state-tinted sky
+*     scene SVG in the framed-box language whose graphic varies by HA
+*     `condition`, plus a big temperature readout and humidity / wind /
+*     pressure readouts. Pure — no controls. Decorative SVG aria-hidden.
+*
+* Mirrors the climate / humidifier controls' `useDeviceCapability` read
+* pattern so the row and hero never diverge. The condition→glyph map is
+* a small internal switch over the known HA condition set with a neutral
+* default.
+*/
+import { type ReactNode } from "react";
+import type { DeviceControlProps } from "./control-registry";
 /** Which sky glyph a condition maps to. Drives both the inline icon and
- *  the hero scene's graphic branch. */
-export type WeatherGlyph = 'sun' | 'clear-night' | 'partly-cloudy' | 'cloudy' | 'rain' | 'snow' | 'lightning' | 'fog' | 'wind' | 'hail';
+*  the hero scene's graphic branch. */
+export type WeatherGlyph = "sun" | "clear-night" | "partly-cloudy" | "cloudy" | "rain" | "snow" | "lightning" | "fog" | "wind" | "hail";
 export interface WeatherConditionMeta {
-    /** Human-readable label for the condition. */
-    readonly label: string;
-    /** Which glyph to render. */
-    readonly glyph: WeatherGlyph;
+	/** Human-readable label for the condition. */
+	readonly label: string;
+	/** Which glyph to render. */
+	readonly glyph: WeatherGlyph;
 }
 export interface WeatherTint {
-    /** Tailwind class for the wash behind the scene. */
-    readonly glow: string;
-    /** Tailwind text token driving the scene glyph via currentColor. */
-    readonly accent: string;
+	/** Tailwind class for the wash behind the scene. */
+	readonly glow: string;
+	/** Tailwind text token driving the scene glyph via currentColor. */
+	readonly accent: string;
 }
 /**
- * Pure helper — maps a verbatim HA condition string to a label + glyph.
- * Covers the known HA `weather.*` condition set; an unknown / null
- * condition falls back to a neutral cloud.
- */
+* Pure helper — maps a verbatim HA condition string to a label + glyph.
+* Covers the known HA `weather.*` condition set; an unknown / null
+* condition falls back to a neutral cloud.
+*/
 export declare function weatherConditionMeta(condition: string | null): WeatherConditionMeta;
 /**
- * Pure helper — maps a verbatim HA condition string to a tint. Exhaustive
- * over the known condition set with a neutral default.
- */
+* Pure helper — maps a verbatim HA condition string to a tint. Exhaustive
+* over the known condition set with a neutral default.
+*/
 export declare function weatherTint(condition: string | null): WeatherTint;
 /**
- * WeatherInlineControl — compact condition icon + temperature readout
- * for a device-list row. Read-only; must NOT blow out the row width.
- */
+* WeatherInlineControl — compact condition icon + temperature readout
+* for a device-list row. Read-only; must NOT blow out the row width.
+*/
 export declare function WeatherInlineControl({ trpc, deviceId }: DeviceControlProps): ReactNode;
 /**
- * WeatherHeroCard — read-only weather panel for the device-detail hero.
- *
- * Bespoke state-tinted sky scene + a large temperature readout +
- * humidity / wind-speed (with a bearing arrow) / pressure readouts.
- * Pure — no controls (the cap is read-only).
- */
+* WeatherHeroCard — read-only weather panel for the device-detail hero.
+*
+* Bespoke state-tinted sky scene + a large temperature readout +
+* humidity / wind-speed (with a bearing arrow) / pressure readouts.
+* Pure — no controls (the cap is read-only).
+*/
 export declare function WeatherHeroCard({ trpc, deviceId }: DeviceControlProps): ReactNode;

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

@@ -1,42 +1,42 @@
-import { ReactElement } from 'react';
+import { type ReactElement } from "react";
 /** Where the viewer's "rows per page" choice for this table is remembered. */
 export declare const DEVICE_EXPORT_PAGE_SIZE_KEY = "camstack.device-export.pageSize";
 export interface DeviceExportPanelProps {
-    /**
-     * Addon id of the export addon whose surface is rendered. Used for
-     * labelling and to scope cache invalidation; the underlying cap
-     * router resolves the (hub-resident) provider by `nodeId`.
-     */
-    readonly addonId: string;
-    /**
-     * Optional callback to open a device-details page.
-     *
-     * There is no `trpc` prop. It existed to feed the device-mode list's per-row
-     * capability atoms (snapshot, switch, live control); this surface renders
-     * type + name + export and asks a device nothing, so the prop was removed
-     * rather than left as a parameter every caller still threads and nothing
-     * reads.
-     */
-    readonly onOpenDevice?: (deviceId: string) => void;
-    /**
-     * Render the exporter's error and Setup block (pairing QR, copyable fields)
-     * inside the panel. Default true. A page that places the devices table at
-     * the bottom renders `<DeviceExportSetup>` near the top instead and passes
-     * false, so the pairing code is not buried under settings and logs.
-     */
-    readonly showSetup?: boolean;
+	/**
+	* Addon id of the export addon whose surface is rendered. Used for
+	* labelling and to scope cache invalidation; the underlying cap
+	* router resolves the (hub-resident) provider by `nodeId`.
+	*/
+	readonly addonId: string;
+	/**
+	* Optional callback to open a device-details page.
+	*
+	* There is no `trpc` prop. It existed to feed the device-mode list's per-row
+	* capability atoms (snapshot, switch, live control); this surface renders
+	* type + name + export and asks a device nothing, so the prop was removed
+	* rather than left as a parameter every caller still threads and nothing
+	* reads.
+	*/
+	readonly onOpenDevice?: (deviceId: string) => void;
+	/**
+	* Render the exporter's error and Setup block (pairing QR, copyable fields)
+	* inside the panel. Default true. A page that places the devices table at
+	* the bottom renders `<DeviceExportSetup>` near the top instead and passes
+	* false, so the pairing code is not buried under settings and logs.
+	*/
+	readonly showSetup?: boolean;
 }
 /**
- * The exporter's error and Setup block on their own — for a page that shows
- * them above its settings while the devices table sits at the bottom. Renders
- * nothing when the exporter reports neither. Shares `getStatus`'s query key
- * with the panel, so mounting both costs one request.
- */
+* The exporter's error and Setup block on their own — for a page that shows
+* them above its settings while the devices table sits at the bottom. Renders
+* nothing when the exporter reports neither. Shares `getStatus`'s query key
+* with the panel, so mounting both costs one request.
+*/
 export declare function DeviceExportSetup({ addonId }: {
-    readonly addonId: string;
+	readonly addonId: string;
 }): ReactElement | null;
 /**
- * Generic device-export panel. Addon-agnostic — only the `device-export`
- * cap drives it.
- */
-export declare function DeviceExportPanel({ addonId, onOpenDevice, showSetup, }: DeviceExportPanelProps): ReactElement;
+* Generic device-export panel. Addon-agnostic — only the `device-export`
+* cap drives it.
+*/
+export declare function DeviceExportPanel({ addonId, onOpenDevice, showSetup }: DeviceExportPanelProps): ReactElement;

package/dist/composites/device-grid.d.ts

@@ -1,12 +1,12 @@
-import { ReactNode } from 'react';
+import { type ReactNode, type JSX } from "react";
 export interface DeviceGridProps {
-    /** Grid items */
-    children: ReactNode;
-    /** Minimum card width in pixels (default 220) */
-    minCardWidth?: number;
-    /** Gap between cards in Tailwind spacing units (default 3) */
-    gap?: number;
-    /** Additional CSS classes */
-    className?: string;
+	/** Grid items */
+	children: ReactNode;
+	/** Minimum card width in pixels (default 220) */
+	minCardWidth?: number;
+	/** Gap between cards in Tailwind spacing units (default 3) */
+	gap?: number;
+	/** Additional CSS classes */
+	className?: string;
 }
-export declare function DeviceGrid({ children, minCardWidth, gap, className }: DeviceGridProps): import("react").JSX.Element;
+export declare function DeviceGrid({ children, minCardWidth, gap, className }: DeviceGridProps): JSX.Element;

package/dist/composites/device-item/actions.d.ts

@@ -1,20 +1,42 @@
-import { ReactNode } from 'react';
-import { UseDeviceProxyTrpc } from '../../hooks/use-device-proxy';
-import { ControlPlacement } from '../device-controls/control-registry';
-import { DeviceItemDevice, VariantDefaults } from './helpers';
+/**
+* <DeviceItemActions> — type-aware dispatcher for inline quick actions.
+*
+* Two layers compose the row's trailing affordances:
+*   1. Type-specific InlineControl: rendered directly from the
+*      `DEVICE_TYPE_CONTROL` registry (cover → ↑■↓ + %; all other
+*      non-sensor types → DummyInline which renders nothing visible).
+*      Sensor / Presence device rows display their live value via
+*      `SensorValueAtom` instead (needs device.role + sourceInfo which
+*      DeviceControlProps does not carry).
+*   2. Cross-cutting feature-gated extras (motion-trigger, PTZ, reboot)
+*      stay here — they gate on `device.features`, are device-type
+*      agnostic, and so are NOT in the per-type registry.
+*
+* High-frequency toggles stay inline. Reboot is a dedicated row-level
+* action button (`RebootQuickAction`) — destructive, so clicking it opens
+* a confirm modal rather than rebooting on the first click.
+*
+* Each atom self-gates via `useDeviceCapability` / the panel's own cap
+* lookup — the dispatcher is a coarse pre-flight only. An atom that
+* finds its cap unbound returns `null` so the row stays compact.
+*/
+import { type ReactNode } from "react";
+import type { UseDeviceProxyTrpc } from "../../hooks/use-device-proxy";
+import { type ControlPlacement } from "../device-controls/control-registry";
+import type { DeviceItemDevice, VariantDefaults } from "./helpers";
 export interface DeviceItemActionsProps {
-    readonly trpc: UseDeviceProxyTrpc;
-    readonly device: DeviceItemDevice;
-    readonly flags: VariantDefaults;
-    /**
-     * Where the control sits and whether the column carries the fixed `w-[140px]`
-     * box. `'right'` (default) → flush right in the fixed column, for card /
-     * minimal views. `'center'` → centered in the fixed column. `'table'` → the
-     * column sizes to its content (no fixed width) so a wide control lays out in
-     * sequence with the trailing trash + status dot without overflowing/colliding
-     * — used by the main devices table. FILL controls stretch to the fixed column
-     * width under `'right'`/`'center'`; under `'table'` they take natural width.
-     */
-    readonly controlPlacement?: ControlPlacement;
+	readonly trpc: UseDeviceProxyTrpc;
+	readonly device: DeviceItemDevice;
+	readonly flags: VariantDefaults;
+	/**
+	* Where the control sits and whether the column carries the fixed `w-[140px]`
+	* box. `'right'` (default) → flush right in the fixed column, for card /
+	* minimal views. `'center'` → centered in the fixed column. `'table'` → the
+	* column sizes to its content (no fixed width) so a wide control lays out in
+	* sequence with the trailing trash + status dot without overflowing/colliding
+	* — used by the main devices table. FILL controls stretch to the fixed column
+	* width under `'right'`/`'center'`; under `'table'` they take natural width.
+	*/
+	readonly controlPlacement?: ControlPlacement;
 }
-export declare function DeviceItemActions({ trpc, device, controlPlacement, }: DeviceItemActionsProps): ReactNode;
+export declare function DeviceItemActions({ trpc, device, controlPlacement }: DeviceItemActionsProps): ReactNode;

package/dist/composites/device-item/admin-link-quick-action.d.ts

@@ -1,30 +1,70 @@
-import { ReactNode } from 'react';
-import { DeviceAdminLink } from '@camstack/types';
-import { UseDeviceProxyTrpc } from '../../hooks/use-device-proxy';
+/**
+* <AdminLinkQuickAction> — the row-level "open this device's own config page"
+* affordance.
+*
+* ## Discreet, in this row's vocabulary
+*
+* The trailing run of a device row already carries a type-specific inline
+* control (a switch, a cover triad, a climate stepper, a sensor value), an
+* on-motion toggle, a PTZ button, a reboot button, whatever the caller injects
+* through `renderRowAction`, a delete button in table view and a status dot.
+* Anything added there competes with a control the operator uses daily, and
+* this one he uses roughly never.
+*
+* So it is the quietest thing the row can hold: a bare 12px glyph in
+* `text-foreground-subtle`, no chrome, no label, no colour until hover — a
+* step below `RebootQuickAction`, which at least has a hover surface, and it
+* sits LAST among the actions so it never displaces one. It renders as an `<a>`
+* rather than a button so the browser's own middle-click / copy-link /
+* open-in-new-tab all work, which is most of what an operator wants from it.
+*
+* ## It draws nothing rather than something dead
+*
+* Four gates, all of which draw nothing:
+*
+*  - the device proxy has not resolved, or the cap is not bound (the provider
+*    cannot answer for this device at all — a cloud-only vacuum, a Wyze cam);
+*  - the query has not answered yet, or failed (a non-admin session loses it,
+*    which is the intended outcome — no button beats a button that 403s);
+*  - the provider answered `null` (this device HAS no page);
+*  - the link is the DEVICE's own page and the device is offline — a web server
+*    on a camera that is not answering will not answer a browser either.
+*
+* That last gate is why `target` exists on the payload: an `integration` link
+* (the Home Assistant device page, the UniFi controller) stays put when the
+* device is offline, because the page is served by something else entirely and
+* is very often exactly where the operator wants to go when a device drops.
+*
+* D62's rule holds from the other side: nothing here renders a DISABLED button.
+* A greyed-out link would say "broken", and none of these four states is.
+*/
+import { type ReactNode } from "react";
+import type { DeviceAdminLink } from "@camstack/types";
+import type { UseDeviceProxyTrpc } from "../../hooks/use-device-proxy";
 export interface AdminLinkQuickActionProps {
-    readonly trpc: UseDeviceProxyTrpc;
-    readonly deviceId: number;
-    /** Extra classes for the anchor — the detail header uses a larger glyph. */
-    readonly className?: string;
-    /** Glyph size. The row wants 12px; the header wants 14px. */
-    readonly iconClassName?: string;
+	readonly trpc: UseDeviceProxyTrpc;
+	readonly deviceId: number;
+	/** Extra classes for the anchor — the detail header uses a larger glyph. */
+	readonly className?: string;
+	/** Glyph size. The row wants 12px; the header wants 14px. */
+	readonly iconClassName?: string;
 }
 /**
- * Resolve the link, or null, applying every gate. Split out so the row button
- * and the detail-header button share ONE decision — two copies of a four-state
- * gate is how the two surfaces end up disagreeing about the same device.
- *
- * Asked through the DEVICE PROXY (`cap.getAdminLink`), not through the
- * generated tRPC hook. The generated hook reads ui-library's own tRPC react
- * context, which the device row does not have and must not require: the row
- * takes its `trpc` as a PROP precisely so a caller can render it against a
- * different client. Wiring the generated hook in here turned 120 existing
- * device-item tests red with "Unable to find tRPC Context" — and would have
- * done the same to any embedding that does not sit under ui-library's provider.
- *
- * One read per (device, binding). The answer is a configured address: it
- * changes when an operator edits a connection, which respawns the runner and
- * re-resolves the proxy anyway.
- */
+* Resolve the link, or null, applying every gate. Split out so the row button
+* and the detail-header button share ONE decision — two copies of a four-state
+* gate is how the two surfaces end up disagreeing about the same device.
+*
+* Asked through the DEVICE PROXY (`cap.getAdminLink`), not through the
+* generated tRPC hook. The generated hook reads ui-library's own tRPC react
+* context, which the device row does not have and must not require: the row
+* takes its `trpc` as a PROP precisely so a caller can render it against a
+* different client. Wiring the generated hook in here turned 120 existing
+* device-item tests red with "Unable to find tRPC Context" — and would have
+* done the same to any embedding that does not sit under ui-library's provider.
+*
+* One read per (device, binding). The answer is a configured address: it
+* changes when an operator edits a connection, which respawns the runner and
+* re-resolves the proxy anyway.
+*/
 export declare function useDeviceAdminLink(trpc: UseDeviceProxyTrpc, deviceId: number): DeviceAdminLink | null;
-export declare function AdminLinkQuickAction({ trpc, deviceId, className, iconClassName, }: AdminLinkQuickActionProps): ReactNode;
+export declare function AdminLinkQuickAction({ trpc, deviceId, className, iconClassName }: AdminLinkQuickActionProps): ReactNode;

package/dist/composites/device-item/child-layout.d.ts

@@ -1,32 +1,49 @@
-import { ChildLayout } from '@camstack/types';
-import { DeviceItemDevice } from './helpers';
+/**
+* Pure grouping helper for a container's `childLayout`.
+*
+* A CONTAINER device may carry a `childLayout` directive (see
+* `ChildLayoutEntry` in `@camstack/types`) that assigns specific accessory
+* children to named accordion SECTIONS. This module partitions a parent's
+* children into the provider-declared sections plus the remaining
+* (ungrouped) children, which keep their current plain rendering.
+*
+* A child matches an entry when its `stableId` equals
+* `${parentStableId}-${entry.childKey}` — `childKey` is the child's
+* re-sync-stable accessory `stableIdSuffix`.
+*
+* Pure — no I/O, no React. Both the device-detail children list and the
+* DevicesList table-row expansion consume this single helper so the two
+* surfaces share the exact same grouping semantics.
+*/
+import type { ChildLayout } from "@camstack/types";
+import type { DeviceItemDevice } from "./helpers";
 export interface ChildLayoutSection {
-    readonly title: string;
-    readonly children: readonly DeviceItemDevice[];
-    /** Whether the section renders open by default. `false` when any matched
-     *  layout entry for this section declared `collapsed: true`. */
-    readonly defaultOpen: boolean;
-    /** When `true`, the section's children render visually de-emphasized
-     *  (muted). Set only on the synthetic "Disabled" section. */
-    readonly muted?: boolean;
+	readonly title: string;
+	readonly children: readonly DeviceItemDevice[];
+	/** Whether the section renders open by default. `false` when any matched
+	*  layout entry for this section declared `collapsed: true`. */
+	readonly defaultOpen: boolean;
+	/** When `true`, the section's children render visually de-emphasized
+	*  (muted). Set only on the synthetic "Disabled" section. */
+	readonly muted?: boolean;
 }
 export interface GroupedChildren {
-    /** Sections ordered by first appearance in `childLayout`. */
-    readonly sections: readonly ChildLayoutSection[];
-    /** Children not referenced by any layout entry — render plainly, as today. */
-    readonly ungrouped: readonly DeviceItemDevice[];
-    /** Trailing synthetic section gathering every child whose CamStack-side
-     *  `disabled` flag is set. Kept SEPARATE from `sections`/`ungrouped` so
-     *  consumers render it LAST (after provider sections + ungrouped) and
-     *  muted. Undefined when no child is disabled. Generic — driven purely by
-     *  `child.disabled`, no provider/HA-specific input. */
-    readonly disabledSection?: ChildLayoutSection;
+	/** Sections ordered by first appearance in `childLayout`. */
+	readonly sections: readonly ChildLayoutSection[];
+	/** Children not referenced by any layout entry — render plainly, as today. */
+	readonly ungrouped: readonly DeviceItemDevice[];
+	/** Trailing synthetic section gathering every child whose CamStack-side
+	*  `disabled` flag is set. Kept SEPARATE from `sections`/`ungrouped` so
+	*  consumers render it LAST (after provider sections + ungrouped) and
+	*  muted. Undefined when no child is disabled. Generic — driven purely by
+	*  `child.disabled`, no provider/HA-specific input. */
+	readonly disabledSection?: ChildLayoutSection;
 }
 /**
- * Partition a parent's children into provider-declared accordion sections +
- * the remaining (ungrouped) children. A child matches an entry when
- * `child.stableId === ${parentStableId}-${entry.childKey}`. Within a section,
- * children sort by `order ?? Number.MAX_SAFE_INTEGER` then by name. Sections
- * appear in first-seen order across `childLayout`. Pure — no I/O.
- */
+* Partition a parent's children into provider-declared accordion sections +
+* the remaining (ungrouped) children. A child matches an entry when
+* `child.stableId === ${parentStableId}-${entry.childKey}`. Within a section,
+* children sort by `order ?? Number.MAX_SAFE_INTEGER` then by name. Sections
+* appear in first-seen order across `childLayout`. Pure — no I/O.
+*/
 export declare function groupChildrenByLayout(parentStableId: string, children: readonly DeviceItemDevice[], childLayout: ChildLayout | undefined): GroupedChildren;

package/dist/composites/device-item/child-section-accordion.d.ts

@@ -1,9 +1,23 @@
-import { ReactNode } from 'react';
+/**
+* <ChildSectionAccordion> — a reusable collapsible section for the CARD/LIST
+* context (device-detail children list). Renders a header button (chevron +
+* title + count badge) that toggles a local open state, and the body (the
+* section's children) when open.
+*
+* Open by default. Styling mirrors `children-accordion.tsx` (uppercase
+* text-[10px] section headers, `hover:bg-surface-hover`, subtle dividers) so
+* the device-detail accordions read consistently with the rest of the list.
+*
+* The TABLE context can't reuse this component (rows must be `<tr>`/`<td>`),
+* so it shares the `groupChildrenByLayout` helper + its own section-header
+* `<tr>` instead — see `device-list/table-layout.tsx`.
+*/
+import { type ReactNode } from "react";
 interface ChildSectionAccordionProps {
-    readonly title: string;
-    readonly count: number;
-    readonly children: ReactNode;
-    readonly defaultOpen?: boolean;
+	readonly title: string;
+	readonly count: number;
+	readonly children: ReactNode;
+	readonly defaultOpen?: boolean;
 }
-export declare function ChildSectionAccordion({ title, count, children, defaultOpen, }: ChildSectionAccordionProps): ReactNode;
+export declare function ChildSectionAccordion({ title, count, children, defaultOpen }: ChildSectionAccordionProps): ReactNode;
 export {};

package/dist/composites/device-item/children-accordion.d.ts

@@ -1,14 +1,14 @@
-import { ReactNode } from 'react';
-import { UseDeviceProxyTrpc } from '../../hooks/use-device-proxy';
-import { DeviceItemDevice } from './helpers';
+import { type ReactNode } from "react";
+import type { UseDeviceProxyTrpc } from "../../hooks/use-device-proxy";
+import type { DeviceItemDevice } from "./helpers";
 interface ChildrenAccordionProps {
-    readonly trpc: UseDeviceProxyTrpc;
-    readonly accessoryChildren: readonly DeviceItemDevice[];
-    readonly adoptedChildren: readonly DeviceItemDevice[];
-    readonly onNavigate: (id: number) => void;
-    /** Parent row's name — used to strip the redundant baked-in prefix from each
-     *  child's DISPLAY name (the underlying `child.name` is untouched). */
-    readonly parentName: string;
+	readonly trpc: UseDeviceProxyTrpc;
+	readonly accessoryChildren: readonly DeviceItemDevice[];
+	readonly adoptedChildren: readonly DeviceItemDevice[];
+	readonly onNavigate: (id: number) => void;
+	/** Parent row's name — used to strip the redundant baked-in prefix from each
+	*  child's DISPLAY name (the underlying `child.name` is untouched). */
+	readonly parentName: string;
 }
-export declare function ChildrenAccordion({ trpc, accessoryChildren, adoptedChildren, onNavigate, parentName, }: ChildrenAccordionProps): ReactNode;
+export declare function ChildrenAccordion({ trpc, accessoryChildren, adoptedChildren, onNavigate, parentName }: ChildrenAccordionProps): ReactNode;
 export {};

package/dist/composites/device-item/container-children-context.d.ts

@@ -1,15 +1,32 @@
-import { ReactNode } from 'react';
-import { DeviceItemDevice } from './helpers';
+/**
+* Container-children context — a per-list lookup of `parentId → children`
+* so a row's sub-components (`DeviceItemHeader`, `DeviceItemActions`, the
+* table-row's `effectiveType`) can resolve a Container's children THEMSELVES
+* instead of having the array threaded down as a `containerChildren` prop.
+*
+* A Container row renders AS its primary child (icon + inline control + the
+* effective type badge), which needs the container's children. Previously the
+* owning list passed those children into `<DeviceItem>`, which re-threaded them
+* into every sub-component. The list now publishes the whole `parentId → []`
+* map once via `ContainerChildrenProvider`, and each sub-component reads its
+* own slice with `useContainerChildren(deviceId)`.
+*
+* Outside a provider (e.g. the minimal child list on the device-detail page,
+* or a standalone test) the hook returns a stable empty array — the same
+* graceful default the old optional prop had.
+*/
+import { type ReactNode } from "react";
+import type { DeviceItemDevice } from "./helpers";
 export interface ContainerChildrenProviderProps {
-    /** `parentDeviceId → that parent's children`. Built once by the list. */
-    readonly value: ReadonlyMap<number, readonly DeviceItemDevice[]>;
-    readonly children: ReactNode;
+	/** `parentDeviceId → that parent's children`. Built once by the list. */
+	readonly value: ReadonlyMap<number, readonly DeviceItemDevice[]>;
+	readonly children: ReactNode;
 }
-export declare function ContainerChildrenProvider({ value, children, }: ContainerChildrenProviderProps): ReactNode;
+export declare function ContainerChildrenProvider({ value, children }: ContainerChildrenProviderProps): ReactNode;
 /**
- * The children of `deviceId` as published by the nearest
- * `ContainerChildrenProvider`. Returns a stable empty array when there is no
- * provider or the device has no children — so a non-container row, or a row
- * rendered outside a list, degrades exactly like the old optional prop.
- */
+* The children of `deviceId` as published by the nearest
+* `ContainerChildrenProvider`. Returns a stable empty array when there is no
+* provider or the device has no children — so a non-container row, or a row
+* rendered outside a list, degrades exactly like the old optional prop.
+*/
 export declare function useContainerChildren(deviceId: number): readonly DeviceItemDevice[];

package/dist/composites/device-item/device-delete-action.d.ts

@@ -1,8 +1,26 @@
-import { ReactNode } from 'react';
-import { DeviceItemDevice } from './helpers';
+/**
+* DeviceDeleteAction — built-in confirmed per-row delete trash button.
+*
+* The unified device table owns delete as a first-class action: when a
+* consumer passes `onDelete` to `<DeviceList>`/`<DeviceItem>`, this red trash
+* button renders in the merged previewActions cell. Delete is destructive, so
+* it MUST ask first — clicking the trash opens the shared centered confirm
+* dialog (`useConfirm`, provider mounted app-wide) and only calls `onDelete`
+* once the operator confirms.
+*
+* Cap/feature-agnostic by design: delete is generic and never branches on the
+* device's capabilities. Context gating lives entirely at the call site — a
+* consumer that doesn't pass `onDelete` gets no trash.
+*
+* Encapsulating `useConfirm` here (rather than inline in the row) keeps the
+* presentational `DeviceItemTableRow` free of side-effecting hooks and lets
+* the trash + confirm contract be tested in isolation.
+*/
+import { type ReactNode } from "react";
+import type { DeviceItemDevice } from "./helpers";
 export interface DeviceDeleteActionProps {
-    readonly device: DeviceItemDevice;
-    /** Called only after the operator confirms the destructive delete. */
-    readonly onDelete: (device: DeviceItemDevice) => void;
+	readonly device: DeviceItemDevice;
+	/** Called only after the operator confirms the destructive delete. */
+	readonly onDelete: (device: DeviceItemDevice) => void;
 }
 export declare function DeviceDeleteAction({ device, onDelete }: DeviceDeleteActionProps): ReactNode;

package/dist/composites/device-item/features.d.ts

@@ -1,17 +1,35 @@
-import { ReactNode } from 'react';
-import { UseDeviceProxyTrpc } from '../../hooks/use-device-proxy';
-import { DeviceItemDevice, VariantDefaults } from './helpers';
+/**
+* <DeviceItemFeatures> — children-count badge + optional feature-icon
+* row with hover popover.
+*
+* Battery / charging / sleeping pills moved to <DeviceItemPreview> in
+* Phase 2 (status pills belong with the preview/snapshot, not features).
+*
+* What this renders is now driven by `useDeviceFeatures` — the row
+* shows ONLY features whose corresponding cap is actually registered
+* on the device (or pure informational markers like `battery-operated`
+* / `doorbell-button` that have no cap to interrogate). The popover
+* labels each row `native` / `enhanced` / `marker` based on the live
+* `getBindings` entry's `kind` field. The previous conservative
+* advertised/no-slice/bound trio is gone — it under-reported wired
+* features (only 2 of 8 had a slice mapping) and gave operators
+* misleading "advertised" gray pills on Reolink cameras that fully
+* implement snapshot/reboot/ptz/intercom natively.
+*/
+import { type ReactNode } from "react";
+import type { UseDeviceProxyTrpc } from "../../hooks/use-device-proxy";
+import { type DeviceItemDevice, type VariantDefaults } from "./helpers";
 export interface DeviceItemFeaturesProps {
-    readonly trpc: UseDeviceProxyTrpc;
-    readonly device: DeviceItemDevice;
-    readonly flags: VariantDefaults;
-    readonly accessoryCount: number;
-    readonly adoptedCount: number;
-    /**
-     * When true, render the feature-icon row + popover (table view's
-     * "Features" column). Off in card view — only battery + +N badge
-     * to save horizontal space.
-     */
-    readonly showFeatureRow?: boolean;
+	readonly trpc: UseDeviceProxyTrpc;
+	readonly device: DeviceItemDevice;
+	readonly flags: VariantDefaults;
+	readonly accessoryCount: number;
+	readonly adoptedCount: number;
+	/**
+	* When true, render the feature-icon row + popover (table view's
+	* "Features" column). Off in card view — only battery + +N badge
+	* to save horizontal space.
+	*/
+	readonly showFeatureRow?: boolean;
 }
-export declare function DeviceItemFeatures({ trpc, device, flags, accessoryCount, adoptedCount, showFeatureRow, }: DeviceItemFeaturesProps): ReactNode;
+export declare function DeviceItemFeatures({ trpc, device, flags, accessoryCount, adoptedCount, showFeatureRow }: DeviceItemFeaturesProps): ReactNode;