@camstack/ui-library 1.2.385 → 1.2.387

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.387] - 2026-11-05
+
+### Changed
+
+- Choosing a primary child on a container whose children carry a source id (ESPHome) now sticks: the picked child is shown and used. Every dropdown in the library is now the shared Select.
+- A confirmed device delete now shows the row as Removing… with its actions disabled until the hub has finished, then drops it; a failure restores the row with the error
+
+## [1.2.386] - 2026-11-05
+
+### Changed
+
+- PageShell exposes PageHeaderActions so a page body can place its Add button in the page header
+
 ## [1.2.385] - 2026-11-05
 
 ### Removed

package/dist/{PrivacyMaskSettings-BUWvVF_n.cjs → PrivacyMaskSettings-BLM8OfT5.cjs}

@@ -1,4 +1,4 @@
-const require_mic_off = require("./mic-off-4nCMfrMI.cjs");
+const require_mic_off = require("./mic-off-BKguA8pd.cjs");
 const require_index = require("./index.cjs");
 const require_MaskShapeCanvas = require("./MaskShapeCanvas-NCNwu9_5.cjs");
 let react = require("react");

package/dist/{PrivacyMaskSettings-D7o4tx8e.js → PrivacyMaskSettings-DZfNWppi.js}

@@ -1,4 +1,4 @@
-import { n as Hexagon, t as MicOff } from "./mic-off-C2VTYr91.js";
+import { n as Hexagon, t as MicOff } from "./mic-off-B83GCRGo.js";
 import { A as Trash2, TEXT_HINT, UiTrans, W as Square, WidgetPanel, Yt as Mic, isAbsentProvider, useDeviceProxy, usePlayerOverlayLayer, useSystem, useUiText, zn as EyeOff } from "./index.js";
 import { MaskShapeCanvas } from "./MaskShapeCanvas-C9cJlxvG.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";

package/dist/{SceneMonitorEditor-BwelmHlF.js → SceneMonitorEditor-C09HggGp.js}

@@ -1,5 +1,5 @@
-import { t as Settings2 } from "./settings-2-jT1iBqHD.js";
-import { A as Trash2, Or as Camera, SCENE_CAPTURE_VARIANTS, TEXT_HINT, UiTrans, _n as ImageOff, badgeFor, coverageLine, gt as RotateCcw, hubPath, isAbsentProvider, roiTooLarge, statusLine, useConfirm, useDeviceProxy, useDeviceSnapshotImage, useDeviceStateSlice, useSystem, useUiText, variantLabel } from "./index.js";
+import { t as Settings2 } from "./settings-2-CHcjJCqa.js";
+import { A as Trash2, Dr as Camera, SCENE_CAPTURE_VARIANTS, Select, TEXT_HINT, UiTrans, _n as ImageOff, badgeFor, coverageLine, gt as RotateCcw, hubPath, isAbsentProvider, roiTooLarge, statusLine, useConfirm, useDeviceProxy, useDeviceSnapshotImage, useDeviceStateSlice, useSystem, useUiText, variantLabel } from "./index.js";
 import { MaskShapeCanvas } from "./MaskShapeCanvas-C9cJlxvG.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -183,6 +183,41 @@ function formatCapturedAt(at) {
 }
 //#endregion
 //#region src/composites/cap-settings/SceneSettingsForm.tsx
+/**
+* SceneSettingsForm — every knob a scene actually has, per scene.
+*
+* ## Why this exists
+*
+* The model has carried `enabled`, `triggerMode`, `checkIntervalSec`,
+* `check.threshold`, `check.hysteresisCount`, `quietSeconds`,
+* `minObservationSpacingSec`, `emit`, `autoRestore` and `confirm` since the
+* provider shipped, and `updateScene` has accepted a patch for all of them —
+* but the editor exposed **none**. Every scene therefore ran on the creation
+* defaults, and an operator whose scene fired too eagerly (or not at all) had
+* no move available except deleting it and drawing it again. Tuning knobs that
+* exist and cannot be reached are worse than absent ones: they read, from the
+* code, as a feature that shipped.
+*
+* ## What is deliberately NOT here
+*
+* `check.mode: 'llm'`. The cap declares it and the engine has an adapter seam
+* for it, but no production caller supplies `SceneEngineDeps.llm` — an
+* `llm`-mode scene reports `availability: 'unavailable'` forever. Offering the
+* switch would let an operator convert a working scene into a permanently
+* broken one in one click. The vision model reaches a scene through the
+* **`confirm`** adjudicator instead, which IS wired (`SceneConfirmGate`, built
+* unconditionally at the engine's construction site) and is the better
+* topology anyway: CLIP proposes at the poll cadence, the model is asked only
+* on a candidate flip.
+*
+* ## Editing model
+*
+* Local draft, committed on blur when it differs — the `AutotrackSection`
+* shape. Selects and checkboxes commit on change, because there is no
+* intermediate state worth protecting. There is no second store and no "save"
+* button: `updateScene` writes the authority the provider already owns and the
+* caller refetches (D62).
+*/
 var FIELD = "rounded-md border border-border bg-surface px-2 py-1 text-[11px] text-foreground focus:border-primary focus:outline-none disabled:opacity-50";
 var LABEL = "text-[10px] font-medium text-foreground-subtle";
 var GROUP = "flex flex-col gap-2 rounded-md border border-border bg-surface/40 p-2";
@@ -289,7 +324,7 @@ function SceneSettingsForm({ monitor, disabled, onPatch }) {
 						children: [/* @__PURE__ */ jsx("span", {
 							className: LABEL,
 							children: t("uiLibrary.sceneSettingsForm.whenToLook", "When to look")
-						}), /* @__PURE__ */ jsxs("select", {
+						}), /* @__PURE__ */ jsxs(Select, {
 							value: monitor.triggerMode,
 							disabled,
 							className: FIELD,
@@ -487,7 +522,7 @@ function SceneSettingsForm({ monitor, disabled, onPatch }) {
 						children: [/* @__PURE__ */ jsx("span", {
 							className: LABEL,
 							children: t("uiLibrary.sceneSettingsForm.noReference", "When a light has no reference of its own")
-						}), /* @__PURE__ */ jsxs("select", {
+						}), /* @__PURE__ */ jsxs(Select, {
 							value: monitor.onUncoveredCondition,
 							disabled,
 							className: FIELD,
@@ -522,7 +557,7 @@ function SceneSettingsForm({ monitor, disabled, onPatch }) {
 						children: [/* @__PURE__ */ jsx("span", {
 							className: LABEL,
 							children: t("uiLibrary.sceneSettingsForm.notificationsFollow", "Notifications follow")
-						}), /* @__PURE__ */ jsxs("select", {
+						}), /* @__PURE__ */ jsxs(Select, {
 							value: monitor.emit,
 							disabled,
 							className: FIELD,

package/dist/{SceneMonitorEditor-C-way4ES.cjs → SceneMonitorEditor-DjZ61oOM.cjs}

@@ -1,4 +1,4 @@
-const require_settings_2 = require("./settings-2-CR4WtEw4.cjs");
+const require_settings_2 = require("./settings-2-LxL8s7fK.cjs");
 const require_index = require("./index.cjs");
 const require_MaskShapeCanvas = require("./MaskShapeCanvas-NCNwu9_5.cjs");
 let react = require("react");
@@ -183,6 +183,41 @@ function formatCapturedAt(at) {
 }
 //#endregion
 //#region src/composites/cap-settings/SceneSettingsForm.tsx
+/**
+* SceneSettingsForm — every knob a scene actually has, per scene.
+*
+* ## Why this exists
+*
+* The model has carried `enabled`, `triggerMode`, `checkIntervalSec`,
+* `check.threshold`, `check.hysteresisCount`, `quietSeconds`,
+* `minObservationSpacingSec`, `emit`, `autoRestore` and `confirm` since the
+* provider shipped, and `updateScene` has accepted a patch for all of them —
+* but the editor exposed **none**. Every scene therefore ran on the creation
+* defaults, and an operator whose scene fired too eagerly (or not at all) had
+* no move available except deleting it and drawing it again. Tuning knobs that
+* exist and cannot be reached are worse than absent ones: they read, from the
+* code, as a feature that shipped.
+*
+* ## What is deliberately NOT here
+*
+* `check.mode: 'llm'`. The cap declares it and the engine has an adapter seam
+* for it, but no production caller supplies `SceneEngineDeps.llm` — an
+* `llm`-mode scene reports `availability: 'unavailable'` forever. Offering the
+* switch would let an operator convert a working scene into a permanently
+* broken one in one click. The vision model reaches a scene through the
+* **`confirm`** adjudicator instead, which IS wired (`SceneConfirmGate`, built
+* unconditionally at the engine's construction site) and is the better
+* topology anyway: CLIP proposes at the poll cadence, the model is asked only
+* on a candidate flip.
+*
+* ## Editing model
+*
+* Local draft, committed on blur when it differs — the `AutotrackSection`
+* shape. Selects and checkboxes commit on change, because there is no
+* intermediate state worth protecting. There is no second store and no "save"
+* button: `updateScene` writes the authority the provider already owns and the
+* caller refetches (D62).
+*/
 var FIELD = "rounded-md border border-border bg-surface px-2 py-1 text-[11px] text-foreground focus:border-primary focus:outline-none disabled:opacity-50";
 var LABEL = "text-[10px] font-medium text-foreground-subtle";
 var GROUP = "flex flex-col gap-2 rounded-md border border-border bg-surface/40 p-2";
@@ -289,7 +324,7 @@ function SceneSettingsForm({ monitor, disabled, onPatch }) {
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: LABEL,
 							children: t("uiLibrary.sceneSettingsForm.whenToLook", "When to look")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_index.Select, {
 							value: monitor.triggerMode,
 							disabled,
 							className: FIELD,
@@ -487,7 +522,7 @@ function SceneSettingsForm({ monitor, disabled, onPatch }) {
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: LABEL,
 							children: t("uiLibrary.sceneSettingsForm.noReference", "When a light has no reference of its own")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_index.Select, {
 							value: monitor.onUncoveredCondition,
 							disabled,
 							className: FIELD,
@@ -522,7 +557,7 @@ function SceneSettingsForm({ monitor, disabled, onPatch }) {
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: LABEL,
 							children: t("uiLibrary.sceneSettingsForm.notificationsFollow", "Notifications follow")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_index.Select, {
 							value: monitor.emit,
 							disabled,
 							className: FIELD,

package/dist/{createLucideIcon-kNomBP27.js → chevron-down-B71qEdFG.js}

@@ -107,5 +107,15 @@ var createLucideIcon = (iconName, iconNode) => {
 	Component.displayName = toPascalCase(iconName);
 	return Component;
 };
+/**
+* @license lucide-react v0.576.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+var ChevronDown = createLucideIcon("chevron-down", [["path", {
+	d: "m6 9 6 6 6-6",
+	key: "qrunsl"
+}]]);
 //#endregion
-export { createLucideIcon as t };
+export { createLucideIcon as n, ChevronDown as t };

package/dist/{createLucideIcon-COWDteJh.cjs → chevron-down-VnEXTuJa.cjs}

@@ -107,7 +107,23 @@ var createLucideIcon = (iconName, iconNode) => {
 	Component.displayName = toPascalCase(iconName);
 	return Component;
 };
+/**
+* @license lucide-react v0.576.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+var ChevronDown = createLucideIcon("chevron-down", [["path", {
+	d: "m6 9 6 6 6-6",
+	key: "qrunsl"
+}]]);
 //#endregion
+Object.defineProperty(exports, "ChevronDown", {
+	enumerable: true,
+	get: function() {
+		return ChevronDown;
+	}
+});
 Object.defineProperty(exports, "createLucideIcon", {
 	enumerable: true,
 	get: function() {

package/dist/composites/cap-settings/NavigationPanel.d.ts

@@ -1,14 +1,3 @@
-/**
-* NavigationPanel — the `navigation` cap's own panel (`host/navigation-panel`):
-* a drive pad, the data-driven action and sound buttons, the fill light.
-*
-* Nothing here knows a vendor: the buttons come from `listActions()` (enabled
-* entries only, icons mapped from the entry's lucide hint), the primitives
-* from `getFeatures()`, and the live chips from the `navigation` slice. Hold
-* a drive button to move — the hook nudges at 1 Hz and stops on release, like
-* the robot app's joystick. The manual level slider appears only in manual
-* mode, as the cap's own contract asks.
-*/
 import { type JSX } from "react";
 import type { CapSettingsComponentProps } from "./index";
 export declare function NavigationPanel({ deviceId }: CapSettingsComponentProps): JSX.Element;

package/dist/composites/cap-settings/SceneSettingsForm.d.ts

@@ -1,38 +1,3 @@
-/**
-* SceneSettingsForm — every knob a scene actually has, per scene.
-*
-* ## Why this exists
-*
-* The model has carried `enabled`, `triggerMode`, `checkIntervalSec`,
-* `check.threshold`, `check.hysteresisCount`, `quietSeconds`,
-* `minObservationSpacingSec`, `emit`, `autoRestore` and `confirm` since the
-* provider shipped, and `updateScene` has accepted a patch for all of them —
-* but the editor exposed **none**. Every scene therefore ran on the creation
-* defaults, and an operator whose scene fired too eagerly (or not at all) had
-* no move available except deleting it and drawing it again. Tuning knobs that
-* exist and cannot be reached are worse than absent ones: they read, from the
-* code, as a feature that shipped.
-*
-* ## What is deliberately NOT here
-*
-* `check.mode: 'llm'`. The cap declares it and the engine has an adapter seam
-* for it, but no production caller supplies `SceneEngineDeps.llm` — an
-* `llm`-mode scene reports `availability: 'unavailable'` forever. Offering the
-* switch would let an operator convert a working scene into a permanently
-* broken one in one click. The vision model reaches a scene through the
-* **`confirm`** adjudicator instead, which IS wired (`SceneConfirmGate`, built
-* unconditionally at the engine's construction site) and is the better
-* topology anyway: CLIP proposes at the poll cadence, the model is asked only
-* on a candidate flip.
-*
-* ## Editing model
-*
-* Local draft, committed on blur when it differs — the `AutotrackSection`
-* shape. Selects and checkboxes commit on change, because there is no
-* intermediate state worth protecting. There is no second store and no "save"
-* button: `updateScene` writes the authority the provider already owns and the
-* caller refetches (D62).
-*/
 import type { SceneCheck, SceneMonitor, SceneUncoveredPolicy } from "@camstack/types";
 import { type JSX } from "react";
 /** The subset of `updateScene`'s patch this form can produce. */

package/dist/composites/data-table.d.ts

@@ -46,6 +46,7 @@
 * the operator moves through the rows.
 */
 import { type JSX, type ReactNode } from "react";
+import type { RowOperationState } from "../hooks/use-row-operations";
 import { type DataTablePaginationLabels } from "./data-table-pagination";
 import { type DataTableSelection } from "./data-table-selection";
 import { type TableSortState, type TableSortValue } from "./table-sort";
@@ -108,6 +109,12 @@ export interface DataTableProps<T> {
 	/** Per-row className resolver (e.g. status-coloured backgrounds). */
 	readonly rowClassName?: (row: T, rowIndex: number) => string | undefined;
 	/**
+	* Per-row operation in flight (`useRowOperations().stateOf(key)`): `pending`
+	* dims the row, marks it `aria-busy` and withholds `onRowClick`; `failed`
+	* tints it and exposes the message as its title. Absent = idle rows.
+	*/
+	readonly rowState?: (row: T, rowIndex: number) => RowOperationState | undefined;
+	/**
 	* Tailwind `max-h-*` class capping the table. The rows then scroll INSIDE
 	* this container and the column header is pinned to its top; the page around
 	* it does not move. Absent (default) = the table is as tall as its rows and
@@ -176,4 +183,4 @@ export interface DataTableProps<T> {
 * does not need a breakpoint of its own.
 */
 export declare const TABLE_SCROLL_MAX_H: "max-h-[60vh]";
-export declare function DataTable<T>({ columns, rows, rowKey, onRowClick, minWidthPx, emptyMessage, className, bordered, rowClassName, maxBodyHeight, fill, defaultSort, sort: sortProp, onSortChange, pageSize, page: pageProp, onPageChange, paginationLabels, selection, renderExpanded, isExpanded }: DataTableProps<T>): JSX.Element | null;
+export declare function DataTable<T>({ columns, rows, rowKey, onRowClick, minWidthPx, emptyMessage, className, bordered, rowClassName, rowState, maxBodyHeight, fill, defaultSort, sort: sortProp, onSortChange, pageSize, page: pageProp, onPageChange, paginationLabels, selection, renderExpanded, isExpanded }: DataTableProps<T>): JSX.Element | null;

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

@@ -1,17 +1,3 @@
-/**
-* Dishwasher controls for a `DeviceType.Dishwasher` device.
-*
-* Reads the `dishwasher` cap status slice and renders inline + hero surfaces
-* mirroring vacuum-control / pet-feeder patterns.
-*
-* Salt and rinse aid are not here: they are items of the device's `consumables`
-* cap, shown by the page's Consumables section like every device's (D915).
-*
-* UNKNOWN IS NOT OFF. The slice carries `null` for everything the appliance has not
-* reported, and this view renders that as "—" / a disabled control, never as an unchecked
-* box or a zero. It also does not echo a command before the appliance confirms it: the
-* slice moves when the appliance says so.
-*/
 import { type UiTextFn } from "../../contexts/ui-text";
 import type { ReactNode } from "react";
 import type { DishwasherOperationState, DishwasherStatus } from "@camstack/types";

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

@@ -3,6 +3,12 @@ export declare const PRIORITY: readonly string[];
 export interface ChildRef {
 	readonly id: number;
 	readonly entityId: string;
+	/**
+	* The child's own `stableId` — the key a pick is persisted under. Distinct
+	* from `entityId` whenever the integration populates `sourceInfo.id`
+	* (ESPHome children do), so it must travel separately.
+	*/
+	readonly stableId?: string | undefined;
 	readonly type: string;
 	/** `DeviceRole`, ranked ABOVE `type` — see `CONTAINER_CHILD_ROLE_PRIORITY`. */
 	readonly role?: string | undefined;
@@ -13,8 +19,8 @@ export interface ChildRef {
 * 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.
+* `entityId` here is `sourceInfo?.id ?? stableId` (see `containerChildToRef`);
+* `stableId` is the child's own. The shared resolver matches the canonical
+* `stableId` key first and accepts the `entityId` as the legacy value, 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/vacuum-control.d.ts

@@ -1,19 +1,3 @@
-/**
-* Robot-vacuum controls for a `DeviceType.Vacuum` device.
-*
-* Reads the `vacuum-control` cap status slice (state / batteryLevel /
-* fanSpeed / availableFanSpeeds) and renders:
-*   - VacuumInlineControl (device-list row): compact Start / Pause /
-*     Return-to-base buttons with state-aware highlight + a battery %
-*     badge.
-*   - VacuumHeroCard (device-detail hero): a state glyph + label, the
-*     full action set (Start / Pause / Stop / Return / Locate), a
-*     fan-speed selector built from `availableFanSpeeds`, and the
-*     battery readout.
-*
-* Mirrors the cover/update controls' `useDeviceCapability` pattern so the
-* row and hero never diverge. Buttons are gated on `available`.
-*/
 import { type UiTextFn } from "../../contexts/ui-text";
 import type { ReactNode } from "react";
 import type { VacuumState } from "@camstack/types";

package/dist/composites/device-controls/water-heater-control.d.ts

@@ -1,20 +1,3 @@
-/**
-* Water-heater controls for a `DeviceType.WaterHeater` device.
-*
-* Reads the `water-heater` cap status slice (current / target temp /
-* operation mode / away / bounds) and renders:
-*   - WaterHeaterInlineControl (device-list row): a compact
-*     `current°→target°` readout + a tiny mode hint. Row-narrow.
-*   - WaterHeaterHeroCard (device-detail hero): a bespoke state-tinted
-*     tank / boiler SVG (water fill + heating-element glow when actively
-*     heating) in the framed-box language, a target-temp stepper with
-*     min/max clamp, an operation-mode `<select>`, an "Away" toggle
-*     (only when `away !== null`), and the current-temp readout.
-*
-* Mirrors the climate / valve controls' `useDeviceCapability` +
-* `useOptimisticSlice` pattern. Controls are gated on `available`. The
-* decorative SVG is aria-hidden.
-*/
 import { type ReactNode } from "react";
 import type { DeviceControlProps } from "./control-registry";
 /** Heating phase derived from the slice — drives the tank tint + element glow. */

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

@@ -15,6 +15,7 @@
 *     `hasMotionTriggerFeature`.
 *   - `shortStableId` — display-token for stableId tail.
 */
+import type { RowOperationState } from "../../hooks/use-row-operations";
 import { type ChildLayout, type DeviceDisplayOverride, type RoleDisplayDefault, type SourceInfo } from "@camstack/types";
 import type { LucideIcon } from "lucide-react";
 import type { ReactNode } from "react";
@@ -187,6 +188,13 @@ export interface DeviceItemProps {
 	*/
 	readonly onDelete?: (device: DeviceItemDevice) => void;
 	/**
+	* An operation in flight on this row (table view). `pending` dims the row,
+	* swaps its actions for a "Removing…" indicator and withholds the row click;
+	* `failed` keeps the row interactive and shows the error inline. Comes from
+	* `useDeviceRemoval().rowOperation`.
+	*/
+	readonly operation?: RowOperationState;
+	/**
 	* When provided, renders a leading checkbox for row selection.
 	* Only passed to top-level rows (accessory sub-rows omit it).
 	* Omitted ⇒ no checkbox, zero layout change for existing callers.

package/dist/composites/device-list/device-mode.d.ts

@@ -1,5 +1,6 @@
 import { type ReactNode } from "react";
 import type { UseDeviceProxyTrpc } from "../../hooks/use-device-proxy";
+import type { RowOperationState } from "../../hooks/use-row-operations";
 import type { DeviceItemDevice, DeviceItemParent } from "../device-item/helpers";
 import { type TableContext } from "./columns";
 import type { MultiSelectOption } from "./multi-select";
@@ -89,6 +90,13 @@ export interface DeviceListDeviceProps {
 	*/
 	readonly onDeleteDevice?: (device: DeviceItemDevice) => void;
 	/**
+	* The state of a removal in flight, per row (`useDeviceRemoval().rowOperation`).
+	* `pending` shows the row dimmed with "Removing…" and its actions disabled until
+	* the removal has completed; `failed` restores it with the error inline.
+	* Omitted ⇒ rows render exactly as before.
+	*/
+	readonly rowOperation?: (device: DeviceItemDevice) => RowOperationState | undefined;
+	/**
 	* When `true`, renders a leading checkbox on each top-level row
 	* (accessory sub-rows are excluded — same gate as `renderRowAction`).
 	* Selection state may be controlled via `selectedIds`; when omitted

package/dist/composites/device-list/page-size-select.d.ts

@@ -1,9 +1,3 @@
-/**
-* <PageSizeSelect> — the "Per page" control under a paginated list.
-*
-* One control for both list modes (the device table and the generic table),
-* so the two never drift in look or wording. `PAGE_SIZE_ALL` renders as "All".
-*/
 import { type ReactNode } from "react";
 import { type UiTextFn } from "../../contexts/ui-text";
 export interface PageSizeSelectProps {

package/dist/composites/device-list/table-layout.d.ts

@@ -1,5 +1,6 @@
 import { type ReactNode } from "react";
 import type { UseDeviceProxyTrpc } from "../../hooks/use-device-proxy";
+import type { RowOperationState } from "../../hooks/use-row-operations";
 import type { DeviceItemDevice, DeviceItemParent } from "../device-item/helpers";
 import { type DeviceColumnId } from "./columns";
 import type { DeviceSort, SortableColumnId } from "./sort";
@@ -30,6 +31,8 @@ interface TableLayoutProps extends DeviceRowsProps {
 	*  top-level rows carry it (accessory sub-rows are excluded — same gate
 	*  as `renderRowAction`). */
 	readonly onDeleteDevice: ((device: DeviceItemDevice) => void) | null;
+	/** Per-row operation in flight (a removal): pending dims + disables the row. */
+	readonly rowOperation: ((device: DeviceItemDevice) => RowOperationState | undefined) | null;
 	/** Parent rows the OPERATOR opened. Only the chevron writes it — a search
 	*  never does (it narrows the rows; it does not open them). */
 	readonly expandedParents: ReadonlySet<number>;
@@ -46,5 +49,5 @@ interface TableLayoutProps extends DeviceRowsProps {
 	/** Header-click handler — toggles the column's sort (asc→desc→none). */
 	readonly onSort: (columnId: SortableColumnId) => void;
 }
-export declare function TableLayout({ rows, accessoriesByParent, expandedParents, onToggleExpand, devices, visibleColumns, trpc, resolveIntegrationIcon, resolveParent, onNavigate, renderRowAction, onDeleteDevice, selectable, rowClickSelects, activeSelected, onToggleSelection, sort, onSort }: TableLayoutProps): ReactNode;
+export declare function TableLayout({ rows, accessoriesByParent, expandedParents, onToggleExpand, devices, visibleColumns, trpc, resolveIntegrationIcon, resolveParent, onNavigate, renderRowAction, onDeleteDevice, rowOperation, selectable, rowClickSelects, activeSelected, onToggleSelection, sort, onSort }: TableLayoutProps): ReactNode;
 export {};

package/dist/composites/page-shell.d.ts

@@ -6,7 +6,15 @@
 * `nav` slot under it for hub pills / selectors.
 */
 import type { LucideIcon } from "lucide-react";
-import type { ReactNode, JSX } from "react";
+import { type ReactNode, type JSX } from "react";
+/**
+* Put `children` in the actions area of the enclosing PageShell header, from any depth of the
+* page body (a table that owns its own Add button). Outside a shell with a title row there is no
+* header to join, so it renders inline in a right-aligned row instead.
+*/
+export declare function PageHeaderActions({ children }: {
+	readonly children: ReactNode;
+}): JSX.Element | null;
 export interface PageShellProps {
 	readonly icon?: LucideIcon;
 	readonly title?: string;

package/dist/composites/pipeline-step.d.ts

@@ -1,10 +1,3 @@
-/**
-* PipelineStep — single step card in the pipeline builder.
-*
-* Driven entirely by PipelineAddonSchema. No hardcoded addon names or models.
-* Renders: colored left border, header with I/O class tags, expandable config
-* (Model → Confidence), children recursively.
-*/
 import { type JSX } from "react";
 import type { PipelineSlot, PipelineAddonSchema, ConfigField } from "@camstack/types";
 export interface PipelineStepDisplayConfig {

package/dist/composites/scope-picker.d.ts

@@ -1,26 +1,3 @@
-/**
-* <ScopePicker> — operator-facing editor for a `TokenScope[]` value.
-*
-* Two consumers: the user-scope editor on `/system/users` (admin grants
-* a baseline scope set to a non-admin user) and the scoped-token create
-* modal on `/system/api-keys` (a caller carves out a subset of THEIR
-* scopes for a token).
-*
-* Row shapes per scope `type`:
-*   - category   → target: 'device' | 'system'
-*   - capability → target: cap name from `KNOWN_CAP_NAMES`
-*   - addon      → target: addon id from `useAddonsList`
-*   - device     → a v3 `DeviceSelector` (all / ids / types / locations)
-*                  plus `includeLinked`, edited by `<DeviceSelectorPicker>`
-*
-* `access` is always 3 independent checkboxes (view / create / delete).
-*
-* `clampToParent` narrows the target dropdown + access checkboxes to
-* what the CALLER possesses. Admins pass `null` to allow everything.
-*
-* This is the RAW editor, for TOKENS. People are not edited here: a person
-* is an Admin or a Viewer (D921), set from `/system/identity?tab=users`.
-*/
 import { type ReactNode } from "react";
 import { type TokenScope } from "@camstack/types";
 import { type UiTextFn } from "../contexts/ui-text";

package/dist/composites/stream-panel.d.ts

@@ -1,13 +1,3 @@
-/**
-* StreamPanel — unified camera stream viewer with header bar, overlay toggles,
-* stream selector, pipeline phase, play/stop, and snapshot preview.
-*
-* Combines features from LiveStreamViewer (admin-ui) and PipelineTab (benchmark)
-* into a single reusable component in ui-library.
-*
-* The component is data-agnostic: callers fetch devices/streams/detections using
-* their own hooks and pass the results as props.
-*/
 import { type ReactNode, type JSX } from "react";
 import type { CamProfile, WebrtcSessionDebug } from "@camstack/types";
 import type { ApplyDownlinkProbe } from "./adaptive-downlink";

package/dist/composites/unit-picker/UnitPicker.d.ts

@@ -1,8 +1,3 @@
-/**
-* Same-dimension unit picker. Lists only `unitsForDimension(dimension)`; an
-* empty dimension disables the control and shows `emptyReason` so the operator
-* never sees a refused conversion as a pickable option.
-*/
 import { type UnitDimension } from "@camstack/types";
 import type { ReactNode } from "react";
 export interface UnitPickerProps {

package/dist/hooks/index.d.ts

@@ -31,6 +31,10 @@ export { SNAPSHOT_MEDIA_PATH, useDeviceSnapshotImage } from "./use-device-snapsh
 export type { DevicePipelineMetrics, DeviceWebrtcResult, SessionRenegotiationState, UseDeviceWebrtcTrpc, WebrtcTarget } from "./use-device-webrtc";
 export { useDeviceWebrtc } from "./use-device-webrtc";
 export { useDevice, useDevices } from "./use-devices";
+export type { DeviceRemoval, UseDeviceRemovalOptions } from "./use-device-removal";
+export { useDeviceRemoval } from "./use-device-removal";
+export type { RowOperationState, UseRowOperationsResult } from "./use-row-operations";
+export { errorMessageOf, useRowOperations } from "./use-row-operations";
 export type { DoorbellPressEvent, UseDoorbellEventsOptions, UseDoorbellEventsResult } from "./use-doorbell-events";
 export { useDoorbellEvents } from "./use-doorbell-events";
 export { useEventInvalidation } from "./use-event-invalidation";

package/dist/hooks/use-device-removal.d.ts

@@ -0,0 +1,26 @@
+import { type RowOperationState } from "./use-row-operations";
+export interface UseDeviceRemovalOptions {
+	/** Must resolve only once the removal has completed on the hub. */
+	readonly remove: (input: {
+		readonly deviceId: number;
+	}) => Promise<unknown>;
+	/** Awaited after `remove`: refetch the devices list the table renders. */
+	readonly refresh?: () => Promise<unknown>;
+	/** A removal failed; the row is restored. Surface `message` (a toast). */
+	readonly onError?: (deviceId: number, message: string) => void;
+}
+export interface DeviceRemoval {
+	/** Fire-and-track; has the shape of `DeviceListBatchActions.remove`. */
+	readonly remove: (input: {
+		readonly deviceId: number;
+	}) => void;
+	/** Awaitable form: `true` when the device was removed. */
+	readonly removeAsync: (input: {
+		readonly deviceId: number;
+	}) => Promise<boolean>;
+	/** The row's state for `<DeviceList rowOperation>`; undefined = idle. */
+	readonly rowOperation: (device: {
+		readonly id: number;
+	}) => RowOperationState | undefined;
+}
+export declare function useDeviceRemoval(options: UseDeviceRemovalOptions): DeviceRemoval;

package/dist/hooks/use-row-operations.d.ts

@@ -0,0 +1,22 @@
+export type RowOperationState = {
+	readonly kind: "pending";
+} | {
+	readonly kind: "failed";
+	readonly message: string;
+};
+export interface UseRowOperationsResult<K> {
+	/** Every row with a state — absent keys are idle. */
+	readonly states: ReadonlyMap<K, RowOperationState>;
+	readonly stateOf: (key: K) => RowOperationState | undefined;
+	readonly isPending: (key: K) => boolean;
+	/**
+	* Run `task` for `key`. Resolves `true` when it completed, `false` when it
+	* threw or when `key` was already pending (nothing was started). A failure
+	* is reported to `onError` and kept as the key's `failed` state.
+	*/
+	readonly run: (key: K, task: () => Promise<unknown>, onError?: (message: string) => void) => Promise<boolean>;
+	/** Forget a key's failure (the row goes back to idle). */
+	readonly clearFailure: (key: K) => void;
+}
+export declare function errorMessageOf(error: unknown): string;
+export declare function useRowOperations<K>(): UseRowOperationsResult<K>;