@camstack/ui-library 1.2.257 → 1.2.258

package/dist/index.js

@@ -10693,7 +10693,10 @@ var IconButton = forwardRef(({ className, variant, size, icon: Icon, ...props },
 			size
 		}), className),
 		...props,
-		children: /* @__PURE__ */ jsx(Icon, { className: "h-4 w-4" })
+		children: /* @__PURE__ */ jsx(Icon, {
+			className: "h-4 w-4",
+			"aria-hidden": "true"
+		})
 	});
 });
 IconButton.displayName = "IconButton";
@@ -10714,19 +10717,19 @@ var inputVariants = cva("h-7 w-full px-2.5 text-xs bg-surface border rounded-md
 });
 var Input = forwardRef(({ className, state, leftSlot, rightSlot, ...props }, ref) => {
 	if (leftSlot || rightSlot) return /* @__PURE__ */ jsxs("div", {
-		className: "relative flex items-center w-full",
+		className: cn("relative flex items-center", className),
 		children: [
 			leftSlot && /* @__PURE__ */ jsx("div", {
-				className: "absolute left-2.5 flex items-center pointer-events-none",
+				className: "absolute left-2.5 flex items-center text-foreground-subtle pointer-events-none",
 				children: leftSlot
 			}),
 			/* @__PURE__ */ jsx("input", {
 				ref,
-				className: cn(inputVariants({ state }), leftSlot ? "pl-7" : "", rightSlot ? "pr-7" : "", className),
+				className: cn(inputVariants({ state }), leftSlot && "pl-8", rightSlot && "pr-8", className),
 				...props
 			}),
 			rightSlot && /* @__PURE__ */ jsx("div", {
-				className: "absolute right-2.5 flex items-center pointer-events-none",
+				className: "absolute right-2.5 flex items-center text-foreground-subtle",
 				children: rightSlot
 			})
 		]
@@ -30702,16 +30705,6 @@ function resolveEffectiveStepModel(input) {
 }
 //#endregion
 //#region src/composites/root-model-source.tsx
-/**
-* "Use the root model" — the step editor's control for a step the camera's
-* ROOT detection model can supply (D730).
-*
-* The flag (`useRootModel`, in the step's own settings) is an operator INTENT
-* kept beside the step's model: checking it never changes the model, and a
-* root that cannot supply the step leaves the step running its own model while
-* the flag waits, inactive, for a root that can. Whether it is in force is
-* `resolveRootSupply` — the same function the runner decides with.
-*/
 /** The editor's view of the flag for one step, or `null` for a step no root can supply. */
 function rootSourceState(stepId, settings, rootModel) {
 	if (!isRootSuppliableStepId(stepId)) return null;
@@ -31663,6 +31656,7 @@ var Separator = forwardRef(({ className, orientation, ...props }, ref) => {
 	return /* @__PURE__ */ jsx("div", {
 		ref,
 		role: "separator",
+		"aria-orientation": orientation ?? "horizontal",
 		className: cn(separatorVariants({ orientation }), className),
 		...props
 	});
@@ -31964,15 +31958,27 @@ var ScrollArea = forwardRef(({ className, ...props }, ref) => {
 ScrollArea.displayName = "ScrollArea";
 //#endregion
 //#region src/primitives/floating-panel.tsx
-function FloatingPanel({ title, onClose, children, defaultWidth = 360, defaultHeight = 280, minWidth = 280, minHeight = 160, offsetIndex = 0, className }) {
-	const [pos, setPos] = useState({
+function FloatingPanel({ title, icon: Icon, position, onPositionChange, size: controlledSize, onSizeChange, onClose, children, defaultWidth = 360, defaultHeight = 280, minWidth = 280, minHeight = 160, offsetIndex = 0, className }) {
+	const [ownPos, setOwnPos] = useState({
 		x: 80 + offsetIndex * 30,
 		y: 80 + offsetIndex * 30
 	});
-	const [size, setSize] = useState({
+	const [ownSize, setOwnSize] = useState({
 		w: defaultWidth,
 		h: defaultHeight
 	});
+	const pos = position ?? ownPos;
+	const size = controlledSize ?? ownSize;
+	const latest = useRef({
+		size,
+		onPositionChange,
+		onSizeChange
+	});
+	latest.current = {
+		size,
+		onPositionChange,
+		onSizeChange
+	};
 	const [minimized, setMinimized] = useState(false);
 	const dragging = useRef(false);
 	const resizing = useRef(false);
@@ -32000,10 +32006,14 @@ function FloatingPanel({ title, onClose, children, defaultWidth = 360, defaultHe
 	}, []);
 	useEffect(() => {
 		const onMouseMove = (e) => {
-			if (dragging.current) setPos({
-				x: e.clientX - offset.current.x,
-				y: e.clientY - offset.current.y
-			});
+			if (dragging.current) {
+				const next = {
+					x: e.clientX - offset.current.x,
+					y: e.clientY - offset.current.y
+				};
+				setOwnPos(next);
+				latest.current.onPositionChange?.(next);
+			}
 			if (resizing.current) {
 				const dx = e.clientX - offset.current.x;
 				const dy = e.clientY - offset.current.y;
@@ -32011,10 +32021,17 @@ function FloatingPanel({ title, onClose, children, defaultWidth = 360, defaultHe
 					x: e.clientX,
 					y: e.clientY
 				};
-				setSize((prev) => ({
+				const prev = latest.current.size;
+				const next = {
 					w: Math.max(minWidth, prev.w + dx),
 					h: Math.max(minHeight, prev.h + dy)
-				}));
+				};
+				latest.current = {
+					...latest.current,
+					size: next
+				};
+				setOwnSize(next);
+				latest.current.onSizeChange?.(next);
 			}
 		};
 		const onMouseUp = () => {
@@ -32033,9 +32050,15 @@ function FloatingPanel({ title, onClose, children, defaultWidth = 360, defaultHe
 		style: { maxHeight: "60dvh" },
 		children: [/* @__PURE__ */ jsxs("div", {
 			className: "flex items-center justify-between gap-2 px-3 py-2 border-b border-border shrink-0 bg-surface",
-			children: [/* @__PURE__ */ jsx("span", {
-				className: "text-[11px] font-medium truncate",
-				children: title
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-2 min-w-0",
+				children: [Icon && /* @__PURE__ */ jsx(Icon, {
+					size: 12,
+					className: "text-primary shrink-0"
+				}), /* @__PURE__ */ jsx("span", {
+					className: "text-[11px] font-medium truncate",
+					children: title
+				})]
 			}), /* @__PURE__ */ jsxs("div", {
 				className: "flex items-center gap-1 shrink-0",
 				children: [/* @__PURE__ */ jsx("button", {
@@ -32066,13 +32089,20 @@ function FloatingPanel({ title, onClose, children, defaultWidth = 360, defaultHe
 			className: "flex items-center justify-between gap-2 px-3 py-2 border-b border-border cursor-move select-none shrink-0 bg-surface",
 			children: [/* @__PURE__ */ jsxs("div", {
 				className: "flex items-center gap-2 min-w-0",
-				children: [/* @__PURE__ */ jsx(GripHorizontal, {
-					size: 12,
-					className: "text-foreground-subtle shrink-0"
-				}), /* @__PURE__ */ jsx("span", {
-					className: "text-[11px] font-medium truncate",
-					children: title
-				})]
+				children: [
+					/* @__PURE__ */ jsx(GripHorizontal, {
+						size: 12,
+						className: "text-foreground-subtle shrink-0"
+					}),
+					Icon && /* @__PURE__ */ jsx(Icon, {
+						size: 12,
+						className: "text-primary shrink-0"
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "text-[11px] font-medium truncate",
+						children: title
+					})
+				]
 			}), /* @__PURE__ */ jsxs("div", {
 				className: "flex items-center gap-1 shrink-0",
 				children: [/* @__PURE__ */ jsx("button", {
@@ -32549,19 +32579,6 @@ function AudioWaveform({ samples, sampleRate = 16e3, height = 96, className = ""
 }
 //#endregion
 //#region src/composites/battery-badge.tsx
-/**
-* BatteryBadge — compact battery indicator for camera tiles + headers.
-*
-* Renders a battery icon with the percentage, a charging glyph when the
-* device is on DC/solar, and a moon when the camera is sleeping (so
-* operators don't blame the platform for low fps on a sleeping cam).
-*
-* Self-contained on data: the caller passes a `status` snapshot from
-* `trpc.battery.getStatus.useQuery` or the `battery.onStatusChanged`
-* event subscription. Returns `null` when status is missing so the
-* call-site can drop the badge in unconditionally — non-battery
-* cameras simply produce no badge.
-*/
 /** A binary battery is "low" below this stand-in percentage (normal maps to
 *  100, low to a sub-threshold value). Keep in sync with the HA container. */
 var BINARY_LOW_THRESHOLD = 50;
@@ -58578,26 +58595,39 @@ function SnapshotButton({ trpc, deviceId, deviceName, size = "sm", className })
 }
 //#endregion
 //#region src/composites/stat-card.tsx
-function StatCard({ value, label, trend, className }) {
-	return /* @__PURE__ */ jsxs(Card, {
-		className: cn("flex flex-col gap-1", className),
-		children: [/* @__PURE__ */ jsxs("div", {
-			className: "flex items-baseline gap-2",
-			children: [/* @__PURE__ */ jsx("span", {
-				className: "text-2xl font-semibold text-foreground",
-				children: value
-			}), trend && /* @__PURE__ */ jsxs("span", {
-				className: cn("inline-flex items-center gap-0.5 text-xs font-medium", trend.direction === "up" ? "text-success" : "text-danger"),
-				children: [
-					trend.direction === "up" ? /* @__PURE__ */ jsx(TrendingUp, { className: "h-3 w-3" }) : /* @__PURE__ */ jsx(TrendingDown, { className: "h-3 w-3" }),
-					trend.value,
-					"%"
-				]
-			})]
-		}), /* @__PURE__ */ jsx("span", {
-			className: "text-xs text-foreground-muted",
-			children: label
-		})]
+function StatCard({ value, label, icon: Icon, subtext, valueClassName, trend, className }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("rounded-lg border border-border bg-surface p-2 sm:p-2.5 min-w-0", className),
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-1.5 mb-0.5 min-w-0",
+				children: [Icon && /* @__PURE__ */ jsx(Icon, { className: "h-3 w-3 text-foreground-subtle flex-shrink-0" }), /* @__PURE__ */ jsx("span", {
+					className: "text-[10px] text-foreground-subtle uppercase tracking-wider whitespace-nowrap overflow-hidden text-ellipsis min-w-0",
+					title: label,
+					children: label
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-baseline gap-2 min-w-0",
+				children: [/* @__PURE__ */ jsx("p", {
+					className: cn("text-lg font-semibold leading-tight whitespace-nowrap overflow-hidden text-ellipsis min-w-0", valueClassName ?? "text-foreground"),
+					title: String(value),
+					children: value
+				}), trend && /* @__PURE__ */ jsxs("span", {
+					className: cn("inline-flex items-center gap-0.5 text-xs font-medium shrink-0", trend.direction === "up" ? "text-success" : "text-danger"),
+					children: [
+						trend.direction === "up" ? /* @__PURE__ */ jsx(TrendingUp, { className: "h-3 w-3" }) : /* @__PURE__ */ jsx(TrendingDown, { className: "h-3 w-3" }),
+						trend.value,
+						"%"
+					]
+				})]
+			}),
+			subtext && /* @__PURE__ */ jsx("p", {
+				className: "text-[10px] text-foreground-subtle mt-0.5 truncate",
+				title: subtext,
+				children: subtext
+			})
+		]
 	});
 }
 //#endregion
@@ -58618,9 +58648,33 @@ var statusConfig = {
 	unknown: {
 		colorClass: "bg-foreground-subtle",
 		label: "Unknown"
+	},
+	running: {
+		colorClass: "bg-success",
+		label: "Running"
+	},
+	stopped: {
+		colorClass: "bg-foreground-subtle",
+		label: "Stopped"
+	},
+	error: {
+		colorClass: "bg-danger",
+		label: "Error"
+	},
+	idle: {
+		colorClass: "bg-info",
+		label: "Idle"
+	},
+	enabled: {
+		colorClass: "bg-success",
+		label: "Enabled"
+	},
+	disabled: {
+		colorClass: "bg-warning",
+		label: "Disabled"
 	}
 };
-function StatusBadge({ status, showDot = true, showLabel = true, size = "sm", className }) {
+function StatusBadge({ status, label, showDot = true, showLabel = true, size = "sm", className }) {
 	const config = statusConfig[status];
 	return /* @__PURE__ */ jsxs("span", {
 		className: cn("inline-flex items-center gap-1.5", size === "sm" ? "text-xs" : "text-sm", className),
@@ -58629,7 +58683,7 @@ function StatusBadge({ status, showDot = true, showLabel = true, size = "sm", cl
 			"aria-hidden": "true"
 		}), showLabel && /* @__PURE__ */ jsx("span", {
 			className: "text-foreground",
-			children: config.label
+			children: label ?? config.label
 		})]
 	});
 }

package/dist/lib/cap-error.d.ts

@@ -1,41 +1,20 @@
 /**
- * Shared capability-error utilities for the admin UI.
- *
- * The primary export `isAbsentProvider` lets UI components distinguish
- * "this device doesn't have this cap" (expected — hide the widget) from
- * "something went wrong while calling a present cap" (unexpected — surface
- * the error to the operator).
- *
- * Detection strategy (two-tier):
- *
- *   1. **Typed reason** (preferred): tRPC's errorFormatter augments the
- *      error shape with `data.capRouteReason` when the server throws a
- *      CapRouteError. Read it from `err.data?.capRouteReason` to avoid
- *      brittle string matching.
- *
- *   2. **Substring fallback** (transitional safety): older error paths
- *      that don't carry a typed reason still emit the human-readable
- *      message "provider not available". The fallback is ONLY engaged
- *      when `capRouteReason` is absent — future clean-up can drop it
- *      once every throw site has been migrated.
- */
-/**
- * Returns `true` when `err` indicates that the requested capability has
- * no provider bound for the device — i.e. the device legitimately does
- * not expose this cap and the UI should stay hidden / show a friendly
- * "not supported" message.
- *
- * Returns `false` for real dispatch errors (`transport-failed`) — those
- * should be surfaced to the operator as unexpected failures.
- *
- * ## Absent-provider reasons
- * - `'no-provider'`  — no provider is registered for this cap/device pair.
- * - `'node-offline'` — the node that hosts the cap is not reachable; the
- *   device is effectively unavailable so we treat it as absent.
- *
- * ## Not-absent reasons
- * - `'transport-failed'` — a provider exists but the call failed in transit.
- * - `'cap-unknown'`      — the cap name isn't registered at all; treat as
- *   a real error (likely a programming mistake or version skew).
- */
+* Returns `true` when `err` indicates that the requested capability has
+* no provider bound for the device — i.e. the device legitimately does
+* not expose this cap and the UI should stay hidden / show a friendly
+* "not supported" message.
+*
+* Returns `false` for real dispatch errors (`transport-failed`) — those
+* should be surfaced to the operator as unexpected failures.
+*
+* ## Absent-provider reasons
+* - `'no-provider'`  — no provider is registered for this cap/device pair.
+* - `'node-offline'` — the node that hosts the cap is not reachable; the
+*   device is effectively unavailable so we treat it as absent.
+*
+* ## Not-absent reasons
+* - `'transport-failed'` — a provider exists but the call failed in transit.
+* - `'cap-unknown'`      — the cap name isn't registered at all; treat as
+*   a real error (likely a programming mistake or version skew).
+*/
 export declare function isAbsentProvider(err: unknown): boolean;

package/dist/lib/cn.d.ts

@@ -1,2 +1,2 @@
-import { ClassValue } from 'clsx';
+import { type ClassValue } from "clsx";
 export declare function cn(...inputs: ClassValue[]): string;

package/dist/lib/fleet-query-defaults.d.ts

@@ -1,41 +1,75 @@
-import { QueryClient, QueryKey } from '@tanstack/react-query';
 /**
- * The tRPC query-key PREFIX shared by every `deviceManager.listAll` observer.
- * tRPC v11 builds `[[path], { input, type }]`, and `partialMatchKey` treats a
- * shorter key as a prefix — so this matches all inputs, and only this method.
- */
+* Fleet-list query defaults — the ONE owner of the `deviceManager.listAll`
+* caching window (D274).
+*
+* ── The bug class this prevents ────────────────────────────────────────────
+* `staleTime` is a per-OBSERVER setting in React Query, not a property of the
+* cache entry. `defaultQueryOptions` resolves it once per mounted observer as
+*
+*   { ...defaultOptions.queries, ...getQueryDefaults(queryKey), ...callSite }
+*
+* so a single observer that leaves `staleTime` at the app-wide default of `0`
+* re-triggers a fetch of the shared key on mount, no matter what its ~40
+* siblings passed. The admin UI mounts the fleet list from the sidebar, the
+* Devices page, Integrations, Recordings, Scenes, Retrain, the detection
+* sections and four ui-library pickers at once — on a hub with 1017 devices
+* that is one `deviceManager.listAll` round-trip per forgetful call site, at
+* every boot.
+*
+* The previous attempt fixed this by hand at the call site, 25 times. It had
+* already drifted before this file existed: every ui-library composite was
+* missed, and those are the ones asking for the UNPROJECTED fleet.
+*
+* ── Why the query client and not the call site ─────────────────────────────
+* `setQueryDefaults` keys off a query-key PREFIX, so one registration covers
+* every `input` variant of the method — `{}`, `{ projection: 'slim' }`,
+* `{ isCamera: true, projection: 'slim' }`, and whatever call site 44 invents.
+* It sits ABOVE the call site in the merge order, so it cannot be forgotten;
+* it sits BELOW an explicit option, so a call site that genuinely needs
+* something else (a `refetchInterval`) still gets it.
+*
+* `scripts/check-fleet-query-defaults.ts` keeps both halves honest: every
+* `QueryClient` in the admin UI and ui-library must run through here, and no
+* call site may re-declare the window locally.
+*/
+import type { QueryClient, QueryKey } from "@tanstack/react-query";
+/**
+* The tRPC query-key PREFIX shared by every `deviceManager.listAll` observer.
+* tRPC v11 builds `[[path], { input, type }]`, and `partialMatchKey` treats a
+* shorter key as a prefix — so this matches all inputs, and only this method.
+*/
 export declare const FLEET_LIST_QUERY_KEY: QueryKey;
 /**
- * 30 s, matching the window `GlobalSearch` established and the 21 call sites
- * that copied it — this registration replaces them rather than competing with
- * them.
- *
- * It is not longer for one reason: device mutations invalidate
- * `[['deviceManager']]` (~20 call sites do, and the prefix covers `listAll`
- * under every input), so an operator EDIT is never the thing this window makes
- * stale. What it does bound is the change no client mutation announces — a
- * provider discovering a camera, a device going offline, a scan adding rows.
- * Nothing invalidates those, so the window is the only thing that picks them
- * up, and 30 s is the cost an operator will tolerate for a row that appeared
- * on its own.
- */
-export declare const FLEET_LIST_STALE_TIME_MS = 30000;
+* 30 s, matching the window `GlobalSearch` established and the 21 call sites
+* that copied it — this registration replaces them rather than competing with
+* them.
+*
+* It is not longer for one reason: device mutations invalidate
+* `[['deviceManager']]` (~20 call sites do, and the prefix covers `listAll`
+* under every input), so an operator EDIT is never the thing this window makes
+* stale. What it does bound is the change no client mutation announces — a
+* provider discovering a camera, a device going offline, a scan adding rows.
+* Nothing invalidates those, so the window is the only thing that picks them
+* up, and 30 s is the cost an operator will tolerate for a row that appeared
+* on its own.
+*/
+export declare const FLEET_LIST_STALE_TIME_MS = 3e4;
 /**
- * 5 min. The app-wide default is `gcTime: 0` (a deliberate "no cross-navigation
- * cache" choice), which drops the entry the instant its last observer
- * unmounts — and that would make the `staleTime` above inert for every key
- * without a permanently-mounted reader. `{ projection: 'slim' }` has one (the
- * sidebar search); `{ isCamera: true, … }` and `{}` do not, so leaving `gcTime`
- * at 0 would refetch the whole fleet on every return to Recordings or Scenes.
- *
- * Scoped to this one key: the fleet list is the largest and most re-read
- * response in the UI, and it is comprehensively invalidated. The global
- * default is untouched.
- */
+* 5 min. The app-wide default is `gcTime: 0` (a deliberate "no cross-navigation
+* cache" choice), which drops the entry the instant its last observer
+* unmounts — and that would make the `staleTime` above inert for every key
+* without a permanently-mounted reader. `{ projection: 'slim' }` has one (the
+* sidebar search); `{ isCamera: true, … }` and `{}` do not, so leaving `gcTime`
+* at 0 would refetch the whole fleet on every return to Recordings or Scenes.
+*
+* Scoped to this one key: the fleet list is the largest and most re-read
+* response in the UI, and it is comprehensively invalidated. The global
+* default is untouched.
+*/
 export declare const FLEET_LIST_GC_TIME_MS: number;
 /**
- * Register the fleet-list window on a query client. Call this on EVERY
- * `QueryClient` that can mount a fleet consumer, immediately after
- * construction — the guard enforces it.
- */
+* Register the fleet-list window on a query client. Call this on EVERY
+* `QueryClient` that can mount a fleet consumer, immediately after
+* construction — the guard enforces it.
+*/
 export declare function applyFleetQueryDefaults(queryClient: QueryClient): void;

package/dist/lib/format-control-datetime.d.ts

@@ -1,18 +1,18 @@
 /**
- * Format an HA-native datetime control value in the user's locale.
- *
- * The `control` cap keeps the value verbatim in one of three HA-native shapes:
- *   - date     → 'YYYY-MM-DD'
- *   - time     → 'HH:MM' or 'HH:MM:SS'
- *   - datetime → full ISO timestamp ('YYYY-MM-DDTHH:MM[:SS]' or space-separated)
- *
- * This helper renders that value for the READ-ONLY (at-a-glance) context:
- *   - 'date'     → locale date    (e.g. en-US '6/7/2026')
- *   - 'time'     → locale time    (e.g. en-US '07:30 AM')
- *   - 'datetime' → locale date+time (medium date + short time)
- *
- * It NEVER throws: any value it cannot parse is returned unchanged (graceful
- * fallback). `locale` is optional and defaults to the runtime/browser locale.
- */
-export type ControlDateTimeFormat = 'date' | 'time' | 'datetime';
+* Format an HA-native datetime control value in the user's locale.
+*
+* The `control` cap keeps the value verbatim in one of three HA-native shapes:
+*   - date     → 'YYYY-MM-DD'
+*   - time     → 'HH:MM' or 'HH:MM:SS'
+*   - datetime → full ISO timestamp ('YYYY-MM-DDTHH:MM[:SS]' or space-separated)
+*
+* This helper renders that value for the READ-ONLY (at-a-glance) context:
+*   - 'date'     → locale date    (e.g. en-US '6/7/2026')
+*   - 'time'     → locale time    (e.g. en-US '07:30 AM')
+*   - 'datetime' → locale date+time (medium date + short time)
+*
+* It NEVER throws: any value it cannot parse is returned unchanged (graceful
+* fallback). `locale` is optional and defaults to the runtime/browser locale.
+*/
+export type ControlDateTimeFormat = "date" | "time" | "datetime";
 export declare function formatControlDateTime(value: string, format: ControlDateTimeFormat, locale?: string): string;

package/dist/lib/format-duration.d.ts

@@ -1,14 +1,14 @@
 /**
- * How long something lasted, the way this product says it.
- *
- * Promoted verbatim from `composites/cap-settings/RecordingPanel.tsx`, which
- * had been the only place answering this question about MEDIA. It is now the
- * only place, so a clip's length and a recording's retention read the same.
- *
- * Two other private formatters stay where they are, on purpose:
- * `config-form-field.tsx` formats a config VALUE (sub-second `ms`, `—` for a
- * value that is not a number), and `scene-monitor-copy.ts`'s `humanDuration`
- * is deliberately single-unit and coarse for a sentence. Neither is a media
- * length, and folding them in here would change what they say.
- */
+* How long something lasted, the way this product says it.
+*
+* Promoted verbatim from `composites/cap-settings/RecordingPanel.tsx`, which
+* had been the only place answering this question about MEDIA. It is now the
+* only place, so a clip's length and a recording's retention read the same.
+*
+* Two other private formatters stay where they are, on purpose:
+* `config-form-field.tsx` formats a config VALUE (sub-second `ms`, `—` for a
+* value that is not a number), and `scene-monitor-copy.ts`'s `humanDuration`
+* is deliberately single-unit and coarse for a sentence. Neither is a media
+* length, and folding them in here would change what they say.
+*/
 export declare function formatDurationMs(ms: number): string;

package/dist/lib/format-last-seen.d.ts

@@ -1,21 +1,8 @@
 /**
- * Relative "last seen" formatter for the offline affordance.
- *
- * Renders a short relative-time label from a millisecond epoch:
- * "just now", "5m ago", "3h ago", "2d ago". Returns `null` for missing
- * inputs, or inputs below {@link MIN_PLAUSIBLE_TIMESTAMP_MS} (a
- * placeholder or a seeded "known value, unknown change time" stamp), so
- * callers can render nothing rather than a misleading "—", "NaN ago", or
- * (for a seeded `1`) "20000 days ago".
- *
- * Future timestamps (clock skew between the device and the browser)
- * collapse to "just now" instead of a negative duration.
- */
-/**
- * The earliest timestamp a real "last seen" could plausibly carry. Below
- * this, a value is a placeholder or a seeded "known value, unknown change
- * time" stamp (e.g. Homematic's `HM_SEEDED_CHANGED_AT = 1`) — never a real
- * instant. Year 2000 predates every device this renders.
- */
+* The earliest timestamp a real "last seen" could plausibly carry. Below
+* this, a value is a placeholder or a seeded "known value, unknown change
+* time" stamp (e.g. Homematic's `HM_SEEDED_CHANGED_AT = 1`) — never a real
+* instant. Year 2000 predates every device this renders.
+*/
 export declare const MIN_PLAUSIBLE_TIMESTAMP_MS: number;
 export declare function formatLastSeen(timestampMs: number | null | undefined): string | null;

package/dist/lib/format-numeric.d.ts

@@ -1,9 +1,9 @@
 /**
- * Format a numeric sensor / control value with optional display precision.
- *
- * When `precision` is provided, delegates to `value.toFixed(precision)` which
- * matches the HA `suggested_display_precision` contract.
- * When absent, falls back to auto-formatting: integers render without a
- * decimal point; non-integers use one decimal place.
- */
+* Format a numeric sensor / control value with optional display precision.
+*
+* When `precision` is provided, delegates to `value.toFixed(precision)` which
+* matches the HA `suggested_display_precision` contract.
+* When absent, falls back to auto-formatting: integers render without a
+* decimal point; non-integers use one decimal place.
+*/
 export declare function formatNumeric(value: number, precision: number | undefined): string;

package/dist/lib/hub-mount.d.ts

@@ -1,50 +1,16 @@
 /**
- * Where the hub is, from inside a page the hub served.
- *
- * The admin UI is not always at the hub's root. The Home Assistant component
- * frames it through a same-origin relay — `https://<ha>/api/camstack/p/<grant>/…`
- * → `https://<hub>:4443/…` — so the browser never has to trust the hub's
- * local certificate. The relay sends `X-Forwarded-Prefix` and the hub
- * injects two things into the shell it serves for that request:
- *
- *   <base href="<prefix>/">
- *   <meta name="camstack-mount" content="<prefix>/">
- *
- * This module is the ONE reader of that fact. Every URL the page composes
- * toward the hub — tRPC HTTP and WS, `/api/webrtc`, `/addon/…` data planes,
- * `/api/addon-assets`, MF remote entries, `<img src>` — goes through it:
- *
- *   - `hubPath('/api/x')`  → `/api/x` at the root, `/<prefix>/api/x` under one.
- *     A same-origin path; the default for fetch, `<img>`, links.
- *   - `hubOrigin()`        → `https://host` or `https://host/<prefix>`; the
- *     `serverUrl` handed to the SDK and the players (they append `/trpc`,
- *     `/api/webrtc`, `/adaptive-probe` themselves).
- *   - `hubUrl()` / `hubWsUrl()` — absolute http(s) / ws(s) forms.
- *   - `routerBasename()`   → `''` or `/<prefix>`, for `<BrowserRouter>`.
- *
- * Why not `window.location.origin` + a literal: `<base>` does not apply to a
- * root-absolute path, so `'/api/x'` leaves the relay and lands on HA's own
- * `/api/x`. And why not `document.baseURI` alone: without a `<base>` it is
- * the DOCUMENT's URL, so `/devices/5` would read as a mount of `/devices/`.
- * The meta is the authority; a `<base>` element is accepted on its own for a
- * host that injects only that.
- *
- * `scripts/check-hub-paths-through-mount.ts` keeps every other module from
- * spelling a hub path directly.
- */
-/**
- * The path the app is mounted at, with a trailing slash: `/` or `/<prefix>/`.
- * Resolved once — the shell is the only thing that can say where it lives,
- * and it says so before any script runs.
- */
+* The path the app is mounted at, with a trailing slash: `/` or `/<prefix>/`.
+* Resolved once — the shell is the only thing that can say where it lives,
+* and it says so before any script runs.
+*/
 export declare function mountPath(): string;
 /** `<BrowserRouter basename>`: the mount without its trailing slash. */
 export declare function routerBasename(): string;
 /**
- * A same-origin path under the mount. Absolute URLs and paths already under
- * the mount pass through unchanged, so a server-stamped `bundleUrl` can be
- * wrapped without knowing whether it was.
- */
+* A same-origin path under the mount. Absolute URLs and paths already under
+* the mount pass through unchanged, so a server-stamped `bundleUrl` can be
+* wrapped without knowing whether it was.
+*/
 export declare function hubPath(pathname: string): string;
 /** The absolute hub base with no trailing slash — the SDK's `serverUrl`. */
 export declare function hubOrigin(): string;