@camstack/ui-library 1.2.327 → 1.2.328

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

@@ -0,0 +1,24 @@
+import type { SensorDescriptor } from "./sensor-value-atom";
+export type SnapshotStatus = "pending" | "error" | "success";
+export type SensorHeroResolution = {
+	readonly kind: "value";
+	readonly slice: unknown;
+} | {
+	readonly kind: "awaiting";
+} | {
+	readonly kind: "quiet";
+};
+export interface SensorHeroSourceInput {
+	readonly addonId: string;
+	readonly role: string | null | undefined;
+	readonly descriptor: SensorDescriptor | undefined;
+	readonly capName: string | undefined;
+	readonly live: unknown;
+	readonly snapshotStatus: SnapshotStatus;
+	readonly snapshotCaps: unknown;
+}
+/** Cap a role's primary reading is stored on. Kept beside the hero, not a second renderer. */
+export declare const ROLE_OUTPUT_CAP: Readonly<Record<string, string>>;
+/** The descriptor can render this slice. `false` and `0` count; a missing field does not. */
+export declare function sensorSliceReady(descriptor: SensorDescriptor, slice: unknown): boolean;
+export declare function resolveSensorHeroReading(input: SensorHeroSourceInput): SensorHeroResolution;

package/dist/index.cjs

@@ -14428,7 +14428,7 @@ Button.displayName = "Button";
 //#region src/composites/account-sign-in-field.tsx
 var INPUT_CLASS$1 = "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-xs text-foreground focus:border-primary focus:ring-1 focus:ring-primary/30 outline-none disabled:opacity-50 disabled:cursor-not-allowed";
 var BARE_CODE = /^[A-Za-z0-9._~-]{8,}$/;
-function isRecord$3(value) {
+function isRecord$4(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isPresent(value) {
@@ -14457,7 +14457,7 @@ function choicesOf(value) {
 	if (!Array.isArray(value)) return [];
 	const out = [];
 	for (const row of value) {
-		if (!isRecord$3(row) || typeof row["value"] !== "string" || typeof row["label"] !== "string") continue;
+		if (!isRecord$4(row) || typeof row["value"] !== "string" || typeof row["label"] !== "string") continue;
 		out.push({
 			value: row["value"],
 			label: row["label"],
@@ -14511,7 +14511,7 @@ function AccountSignInField({ field, values, disabled, onAction, onChangeMany })
 		setError(null);
 		try {
 			const result = await onAction(field.beginAction, field.key, {});
-			if (!isRecord$3(result) || typeof result["authorizeUrl"] !== "string" || typeof result["attemptId"] !== "string") {
+			if (!isRecord$4(result) || typeof result["authorizeUrl"] !== "string" || typeof result["attemptId"] !== "string") {
 				setError(t("uiLibrary.accountSignIn.noLink", "The sign-in page could not be opened. Try again."));
 				return;
 			}
@@ -14539,7 +14539,7 @@ function AccountSignInField({ field, values, disabled, onAction, onChangeMany })
 				attemptId,
 				callback
 			});
-			if (!isRecord$3(result)) {
+			if (!isRecord$4(result)) {
 				setError(t("uiLibrary.accountSignIn.rejected", "The sign-in was not accepted. Start again."));
 				return;
 			}
@@ -19906,11 +19906,11 @@ function useDeviceSnapshotImage(deviceId, options = {}) {
 //#region src/composites/cap-settings/camera-grid-layout.ts
 /** Smallest rectangle the editor will produce — ffmpeg refuses a zero-area crop. */
 var MIN_EXTENT = .02;
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function readRect(value) {
-	if (!isRecord$2(value)) return null;
+	if (!isRecord$3(value)) return null;
 	const { x, y, width, height } = value;
 	if (typeof x !== "number" || typeof y !== "number" || typeof width !== "number" || typeof height !== "number") return null;
 	if (x < 0 || y < 0 || width <= 0 || height <= 0) return null;
@@ -19923,7 +19923,7 @@ function readRect(value) {
 	};
 }
 function readCell(value) {
-	if (!isRecord$2(value)) return null;
+	if (!isRecord$3(value)) return null;
 	const deviceId = value["deviceId"];
 	if (typeof deviceId !== "number" || !Number.isInteger(deviceId)) return null;
 	const source = readRect(value["source"]);
@@ -19936,7 +19936,7 @@ function readCell(value) {
 	};
 }
 function readProfileOffer(value) {
-	if (!isRecord$2(value)) return null;
+	if (!isRecord$3(value)) return null;
 	const profile = value["profile"];
 	const offered = value["offered"];
 	const missing = value["missingSources"];
@@ -19965,7 +19965,7 @@ function readProfileOffer(value) {
 */
 function parseGridView(raw) {
 	if (raw === null) return null;
-	if (!isRecord$2(raw)) return "unreadable";
+	if (!isRecord$3(raw)) return "unreadable";
 	const { instanceId, deviceId, name, fps, cells, profiles } = raw;
 	if (typeof instanceId !== "string" || typeof deviceId !== "number" || typeof name !== "string" || typeof fps !== "number" || !Array.isArray(cells) || !Array.isArray(profiles)) return "unreadable";
 	const parsed = [];
@@ -34127,10 +34127,7 @@ function RunningBadge({ running, children, className }) {
 function RunningStatusLine({ running, since, phase, className, now = Date.now() }) {
 	const t = useUiText();
 	const parts = runningStatusParts(running, since, phase, now);
-	if (parts.key === "unknown") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-		className: cn("text-[11px] text-foreground-subtle", className),
-		children: t("uiLibrary.runningStatus.unknown", "Unknown")
-	});
+	if (parts.key === "unknown" || running !== true && running !== false) return null;
 	if (parts.key === "idle") {
 		const base = t("uiLibrary.runningStatus.idle", "Idle");
 		const text = parts.phase === void 0 ? base : t("uiLibrary.runningStatus.withPhase", "{{state}} · {{phase}}", {
@@ -47382,6 +47379,92 @@ function SensorInlineControl({ trpc, deviceId }) {
 	});
 }
 //#endregion
+//#region src/composites/device-controls/sensor-hero-source.ts
+/**
+* Where a sensor hero reads its number. The live proxy slice is the
+* usual source. A composed device publishes the same reading on the
+* snapshot before that proxy has a binding, and it has no running-state
+* to stand in for the reading. An answered snapshot with no primary
+* field is quiet — it must not say the value is still on its way.
+*/
+/** Cap a role's primary reading is stored on. Kept beside the hero, not a second renderer. */
+var ROLE_OUTPUT_CAP = {
+	"temperature-sensor": "temperature-sensor",
+	"humidity-sensor": "humidity-sensor",
+	"ambient-light-sensor": "ambient-light-sensor",
+	"pressure-sensor": "pressure-sensor",
+	"numeric-sensor": "numeric-sensor",
+	"wind-sensor": "numeric-sensor",
+	"rain-sensor": "numeric-sensor",
+	"uv-sensor": "numeric-sensor",
+	"solar-radiation-sensor": "numeric-sensor",
+	"soil-moisture-sensor": "numeric-sensor",
+	"power-sensor": "power-meter",
+	"energy-sensor": "power-meter",
+	"voltage-sensor": "power-meter",
+	"current-sensor": "power-meter",
+	"battery-sensor": "numeric-sensor",
+	"generic-sensor": "numeric-sensor",
+	"motion-sensor": "motion",
+	"pir-sensor": "motion",
+	"contact-sensor": "contact",
+	"smoke-sensor": "smoke",
+	"leak-sensor": "flood",
+	"co-sensor": "carbon-monoxide",
+	"binary-sensor": "binary",
+	presence: "presence",
+	"enum-sensor": "enum-sensor",
+	"datetime-sensor": "enum-sensor"
+};
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** The descriptor can render this slice. `false` and `0` count; a missing field does not. */
+function sensorSliceReady(descriptor, slice) {
+	if (!isRecord$2(slice)) return false;
+	if (descriptor.kind === "presence") return typeof slice["state"] === "string";
+	if (descriptor.kind === "string" || descriptor.kind === "datetime") return typeof slice["value"] === "string" && slice["value"] !== "";
+	const value = slice[descriptor.field];
+	if (descriptor.kind === "numeric") return typeof value === "number";
+	return typeof value === "boolean";
+}
+function capSlice(caps, capName) {
+	if (capName === void 0 || !isRecord$2(caps)) return void 0;
+	return caps[capName];
+}
+/**
+* A battery group writes `battery.percentage`. The role's usual cap is
+* `numeric-sensor.value`. Hand the renderer a slice whose `value` is that
+* percentage so one numeric path draws both.
+*/
+function batteryPercentageSlice(caps) {
+	const battery = capSlice(caps, "battery");
+	if (!isRecord$2(battery) || typeof battery["percentage"] !== "number") return void 0;
+	return {
+		...battery,
+		value: battery["percentage"]
+	};
+}
+function snapshotSlice(input) {
+	const direct = capSlice(input.snapshotCaps, input.capName);
+	if (input.descriptor !== void 0 && sensorSliceReady(input.descriptor, direct)) return direct;
+	if (input.role === "battery-sensor" && input.descriptor?.kind === "numeric") return batteryPercentageSlice(input.snapshotCaps);
+}
+function resolveSensorHeroReading(input) {
+	const descriptor = input.descriptor;
+	if (descriptor !== void 0 && sensorSliceReady(descriptor, input.live)) return {
+		kind: "value",
+		slice: input.live
+	};
+	const fromSnapshot = snapshotSlice(input);
+	if (descriptor !== void 0 && sensorSliceReady(descriptor, fromSnapshot)) return {
+		kind: "value",
+		slice: fromSnapshot
+	};
+	if (input.addonId === _camstack_types.COMPOSER_ADDON_ID && input.snapshotStatus === "success") return { kind: "quiet" };
+	return { kind: "awaiting" };
+}
+//#endregion
 //#region src/composites/device-controls/sensor-hero-card.tsx
 /**
 * SensorHeroCard — large-format sensor value display for the device-detail
@@ -47448,7 +47531,28 @@ function SensorHeroInner({ trpc, device }) {
 	const occupancySlice = useDeviceStateSlice(dev !== null && !isBattery ? dev.state.binary : void 0);
 	const useBinaryBattery = isBattery && roleDescriptor?.kind === "numeric" && !hasBatteryNumericValue(numericSlice, roleDescriptor.field) && binaryBatterySlice !== void 0;
 	const descriptor = useBinaryBattery ? BINARY_BATTERY_DESCRIPTOR : roleDescriptor;
-	const slice = useBinaryBattery ? binaryBatterySlice : numericSlice;
+	const liveSlice = useBinaryBattery ? binaryBatterySlice : numericSlice;
+	const snapshot = useDeviceStateGetSnapshot({ deviceId: device.id }, { staleTime: 5e3 });
+	const capName = useBinaryBattery ? "binary" : device.role != null ? ROLE_OUTPUT_CAP[device.role] : ROLE_OUTPUT_CAP["temperature-sensor"];
+	const snapshotStatus = snapshot.status === "success" || snapshot.status === "error" ? snapshot.status : "pending";
+	const resolution = resolveSensorHeroReading({
+		addonId: device.addonId,
+		role: device.role,
+		descriptor,
+		capName,
+		live: liveSlice,
+		snapshotStatus,
+		snapshotCaps: snapshot.data
+	});
+	if (resolution.kind === "quiet") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "flex flex-col items-center justify-center gap-2 rounded-lg border border-border bg-surface p-4 min-h-[96px]",
+		"data-testid": "sensor-hero-quiet",
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: "text-sm text-foreground-subtle",
+			children: device.name
+		})
+	});
+	const slice = resolution.kind === "value" ? resolution.slice : void 0;
 	if (descriptor === void 0 || slice === void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "flex flex-col items-center justify-center gap-2 rounded-lg border border-border bg-surface p-4 min-h-[96px]",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -47467,7 +47571,7 @@ function SensorHeroInner({ trpc, device }) {
 		const rendered = resolveSensorDisplay({
 			display: device.display,
 			capName: device.role === "numeric-sensor" ? "numeric-sensor" : void 0,
-			roleDefault: device.role != null ? roleDefaultsData?.defaults[device.role] : roleDefaultsData?.defaults["temperature-sensor"],
+			roleDefault: device.role != null ? roleDefaultsData?.defaults?.[device.role] : roleDefaultsData?.defaults?.["temperature-sensor"],
 			quantity: descriptor.quantity ?? "device",
 			deviceQuantity: deviceQuantity === "device" ? void 0 : deviceQuantity
 		}).format(rawValue);

package/dist/index.js

@@ -5,7 +5,7 @@ import * as __mfHostReact from "react";
 import React, { Fragment, Suspense, cloneElement, createContext, createElement, forwardRef, lazy, useCallback, useContext, useEffect, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
 import * as __mfHostReactJsxRuntime from "react/jsx-runtime";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
-import { ALL_CAPABILITY_DEFINITIONS, CAM_PROFILE_ORDER, CLIP_STILL_DISPOSITION_HEADER, CLIP_STILL_REASON_CODE_HEADER, CLIP_STILL_REASON_HEADER, CONTAINER_CHILD_PRIORITY, ConsumableLevelSchema, DEFAULT_DISPLAY_PREFERENCE, DEFAULT_EVENTS_BAND_BUFFER_SEC, DEVICE_HISTORY_ENERGY_KEY, DEVICE_HISTORY_QUERY_MANY_MAX_ITEMS, DEVICE_TYPE_CONTROL_KIND, DeviceExportStatusSchema, DeviceFeature, DeviceRole, DeviceType, EXTENSION_SLOTS, EXTENSION_SLOT_IDS, EventCategory, ExposedDeviceSchema, FIRST_LEVEL_MACRO_CLASSES, HISTORY_CATALOG, ICON_CATEGORIES, KNOWN_CAP_NAMES, MAX_SENSOR_TRIGGER_DEVICES, MODEL_PROVIDER_IDS, NAVIGATION_LIGHT_LEVEL_MAX, NAVIGATION_LIGHT_LEVEL_MIN, NODE_COLOR_IDS, NodeColorIdSchema, PALETTE_ENTRY_IDS, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, RECORDING_AUDIO_TRIGGER_OFFERED_DBFS, RECORDING_SOURCE_CAMSTACK_ADDON, REDACTED_SECRET, RecordingConfigSchema, RecordingStatusSchema, SECRET_CLEAR, SOURCE_CAP_ACTIVE_FIELD, STATIONARY_OVERLAY_STYLE, SUBJECT_PATH_DWELL_EPS, SUBJECT_PATH_FULL_FRAME_COVERAGE, SUBJECT_PATH_MAX_POINTS, TIMEZONES, USE_ROOT_MODEL_SETTING_KEY, assignNodeColorId, assignNodeColorId as assignNodeColorId$1, baseUnitOf, buildModelVariantGroups, buildSubjectPath, bundledCamstack, canConvertUnit, canonicalIconKey, clearModelBoundOverrides, clearModelBoundSetting, clusterStepSettingFieldsFor, collectModelBoundKeys, consumableFormOf, consumableKindOf, createDeviceProxy, createLazyTrpcSource, createSliceHandle, dehydrateSchema, deriveRecordingMode, describeModelVariant, displayUnitFor, effectiveStepSettings, findTimezone, formatParkedFor, formatReading, hasModelBoundOverrides, iconCategoryLabel, iconsInCategory, isDrawableSubjectPath, isKeychainStoredField, isModelScopedStepSettingKey, isReadingQuantity, isRootSuppliableStepId, isSecretClear, isSecretFieldView, isSecretMarker, modelBindingKey, normalizeUnit, paintHex, parseOccupancyScope, projectSubjectPath, publicEventCategories, resolveContainerPrimaryChild, resolveDeviceControlKind, resolveIconKey, resolveModelBoundSetting, resolveRecordingProfiles, resolveRootSupply, resolveVariantModelId, resolveViewableDeviceIds, searchIcons, selectAssignedProfileSlots, stepSettingSource, subjectPathSampleFromBox, subjectPathSvgPoints, tryConvertUnit, unitsForDimension, withFieldFrom, withoutField, writeModelBoundSetting } from "@camstack/types";
+import { ALL_CAPABILITY_DEFINITIONS, CAM_PROFILE_ORDER, CLIP_STILL_DISPOSITION_HEADER, CLIP_STILL_REASON_CODE_HEADER, CLIP_STILL_REASON_HEADER, COMPOSER_ADDON_ID, CONTAINER_CHILD_PRIORITY, ConsumableLevelSchema, DEFAULT_DISPLAY_PREFERENCE, DEFAULT_EVENTS_BAND_BUFFER_SEC, DEVICE_HISTORY_ENERGY_KEY, DEVICE_HISTORY_QUERY_MANY_MAX_ITEMS, DEVICE_TYPE_CONTROL_KIND, DeviceExportStatusSchema, DeviceFeature, DeviceRole, DeviceType, EXTENSION_SLOTS, EXTENSION_SLOT_IDS, EventCategory, ExposedDeviceSchema, FIRST_LEVEL_MACRO_CLASSES, HISTORY_CATALOG, ICON_CATEGORIES, KNOWN_CAP_NAMES, MAX_SENSOR_TRIGGER_DEVICES, MODEL_PROVIDER_IDS, NAVIGATION_LIGHT_LEVEL_MAX, NAVIGATION_LIGHT_LEVEL_MIN, NODE_COLOR_IDS, NodeColorIdSchema, PALETTE_ENTRY_IDS, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, RECORDING_AUDIO_TRIGGER_OFFERED_DBFS, RECORDING_SOURCE_CAMSTACK_ADDON, REDACTED_SECRET, RecordingConfigSchema, RecordingStatusSchema, SECRET_CLEAR, SOURCE_CAP_ACTIVE_FIELD, STATIONARY_OVERLAY_STYLE, SUBJECT_PATH_DWELL_EPS, SUBJECT_PATH_FULL_FRAME_COVERAGE, SUBJECT_PATH_MAX_POINTS, TIMEZONES, USE_ROOT_MODEL_SETTING_KEY, assignNodeColorId, assignNodeColorId as assignNodeColorId$1, baseUnitOf, buildModelVariantGroups, buildSubjectPath, bundledCamstack, canConvertUnit, canonicalIconKey, clearModelBoundOverrides, clearModelBoundSetting, clusterStepSettingFieldsFor, collectModelBoundKeys, consumableFormOf, consumableKindOf, createDeviceProxy, createLazyTrpcSource, createSliceHandle, dehydrateSchema, deriveRecordingMode, describeModelVariant, displayUnitFor, effectiveStepSettings, findTimezone, formatParkedFor, formatReading, hasModelBoundOverrides, iconCategoryLabel, iconsInCategory, isDrawableSubjectPath, isKeychainStoredField, isModelScopedStepSettingKey, isReadingQuantity, isRootSuppliableStepId, isSecretClear, isSecretFieldView, isSecretMarker, modelBindingKey, normalizeUnit, paintHex, parseOccupancyScope, projectSubjectPath, publicEventCategories, resolveContainerPrimaryChild, resolveDeviceControlKind, resolveIconKey, resolveModelBoundSetting, resolveRecordingProfiles, resolveRootSupply, resolveVariantModelId, resolveViewableDeviceIds, searchIcons, selectAssignedProfileSlots, stepSettingSource, subjectPathSampleFromBox, subjectPathSvgPoints, tryConvertUnit, unitsForDimension, withFieldFrom, withoutField, writeModelBoundSetting } from "@camstack/types";
 import * as __mfHostTrpcReactQuery from "@trpc/react-query";
 import { createTRPCReact } from "@trpc/react-query";
 import * as __mfHostReactDOM from "react-dom";
@@ -14404,7 +14404,7 @@ Button.displayName = "Button";
 //#region src/composites/account-sign-in-field.tsx
 var INPUT_CLASS$1 = "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-xs text-foreground focus:border-primary focus:ring-1 focus:ring-primary/30 outline-none disabled:opacity-50 disabled:cursor-not-allowed";
 var BARE_CODE = /^[A-Za-z0-9._~-]{8,}$/;
-function isRecord$3(value) {
+function isRecord$4(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isPresent(value) {
@@ -14433,7 +14433,7 @@ function choicesOf(value) {
 	if (!Array.isArray(value)) return [];
 	const out = [];
 	for (const row of value) {
-		if (!isRecord$3(row) || typeof row["value"] !== "string" || typeof row["label"] !== "string") continue;
+		if (!isRecord$4(row) || typeof row["value"] !== "string" || typeof row["label"] !== "string") continue;
 		out.push({
 			value: row["value"],
 			label: row["label"],
@@ -14487,7 +14487,7 @@ function AccountSignInField({ field, values, disabled, onAction, onChangeMany })
 		setError(null);
 		try {
 			const result = await onAction(field.beginAction, field.key, {});
-			if (!isRecord$3(result) || typeof result["authorizeUrl"] !== "string" || typeof result["attemptId"] !== "string") {
+			if (!isRecord$4(result) || typeof result["authorizeUrl"] !== "string" || typeof result["attemptId"] !== "string") {
 				setError(t("uiLibrary.accountSignIn.noLink", "The sign-in page could not be opened. Try again."));
 				return;
 			}
@@ -14515,7 +14515,7 @@ function AccountSignInField({ field, values, disabled, onAction, onChangeMany })
 				attemptId,
 				callback
 			});
-			if (!isRecord$3(result)) {
+			if (!isRecord$4(result)) {
 				setError(t("uiLibrary.accountSignIn.rejected", "The sign-in was not accepted. Start again."));
 				return;
 			}
@@ -19882,11 +19882,11 @@ function useDeviceSnapshotImage(deviceId, options = {}) {
 //#region src/composites/cap-settings/camera-grid-layout.ts
 /** Smallest rectangle the editor will produce — ffmpeg refuses a zero-area crop. */
 var MIN_EXTENT = .02;
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function readRect(value) {
-	if (!isRecord$2(value)) return null;
+	if (!isRecord$3(value)) return null;
 	const { x, y, width, height } = value;
 	if (typeof x !== "number" || typeof y !== "number" || typeof width !== "number" || typeof height !== "number") return null;
 	if (x < 0 || y < 0 || width <= 0 || height <= 0) return null;
@@ -19899,7 +19899,7 @@ function readRect(value) {
 	};
 }
 function readCell(value) {
-	if (!isRecord$2(value)) return null;
+	if (!isRecord$3(value)) return null;
 	const deviceId = value["deviceId"];
 	if (typeof deviceId !== "number" || !Number.isInteger(deviceId)) return null;
 	const source = readRect(value["source"]);
@@ -19912,7 +19912,7 @@ function readCell(value) {
 	};
 }
 function readProfileOffer(value) {
-	if (!isRecord$2(value)) return null;
+	if (!isRecord$3(value)) return null;
 	const profile = value["profile"];
 	const offered = value["offered"];
 	const missing = value["missingSources"];
@@ -19941,7 +19941,7 @@ function readProfileOffer(value) {
 */
 function parseGridView(raw) {
 	if (raw === null) return null;
-	if (!isRecord$2(raw)) return "unreadable";
+	if (!isRecord$3(raw)) return "unreadable";
 	const { instanceId, deviceId, name, fps, cells, profiles } = raw;
 	if (typeof instanceId !== "string" || typeof deviceId !== "number" || typeof name !== "string" || typeof fps !== "number" || !Array.isArray(cells) || !Array.isArray(profiles)) return "unreadable";
 	const parsed = [];
@@ -34103,10 +34103,7 @@ function RunningBadge({ running, children, className }) {
 function RunningStatusLine({ running, since, phase, className, now = Date.now() }) {
 	const t = useUiText();
 	const parts = runningStatusParts(running, since, phase, now);
-	if (parts.key === "unknown") return /* @__PURE__ */ jsx("p", {
-		className: cn("text-[11px] text-foreground-subtle", className),
-		children: t("uiLibrary.runningStatus.unknown", "Unknown")
-	});
+	if (parts.key === "unknown" || running !== true && running !== false) return null;
 	if (parts.key === "idle") {
 		const base = t("uiLibrary.runningStatus.idle", "Idle");
 		const text = parts.phase === void 0 ? base : t("uiLibrary.runningStatus.withPhase", "{{state}} · {{phase}}", {
@@ -47358,6 +47355,92 @@ function SensorInlineControl({ trpc, deviceId }) {
 	});
 }
 //#endregion
+//#region src/composites/device-controls/sensor-hero-source.ts
+/**
+* Where a sensor hero reads its number. The live proxy slice is the
+* usual source. A composed device publishes the same reading on the
+* snapshot before that proxy has a binding, and it has no running-state
+* to stand in for the reading. An answered snapshot with no primary
+* field is quiet — it must not say the value is still on its way.
+*/
+/** Cap a role's primary reading is stored on. Kept beside the hero, not a second renderer. */
+var ROLE_OUTPUT_CAP = {
+	"temperature-sensor": "temperature-sensor",
+	"humidity-sensor": "humidity-sensor",
+	"ambient-light-sensor": "ambient-light-sensor",
+	"pressure-sensor": "pressure-sensor",
+	"numeric-sensor": "numeric-sensor",
+	"wind-sensor": "numeric-sensor",
+	"rain-sensor": "numeric-sensor",
+	"uv-sensor": "numeric-sensor",
+	"solar-radiation-sensor": "numeric-sensor",
+	"soil-moisture-sensor": "numeric-sensor",
+	"power-sensor": "power-meter",
+	"energy-sensor": "power-meter",
+	"voltage-sensor": "power-meter",
+	"current-sensor": "power-meter",
+	"battery-sensor": "numeric-sensor",
+	"generic-sensor": "numeric-sensor",
+	"motion-sensor": "motion",
+	"pir-sensor": "motion",
+	"contact-sensor": "contact",
+	"smoke-sensor": "smoke",
+	"leak-sensor": "flood",
+	"co-sensor": "carbon-monoxide",
+	"binary-sensor": "binary",
+	presence: "presence",
+	"enum-sensor": "enum-sensor",
+	"datetime-sensor": "enum-sensor"
+};
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** The descriptor can render this slice. `false` and `0` count; a missing field does not. */
+function sensorSliceReady(descriptor, slice) {
+	if (!isRecord$2(slice)) return false;
+	if (descriptor.kind === "presence") return typeof slice["state"] === "string";
+	if (descriptor.kind === "string" || descriptor.kind === "datetime") return typeof slice["value"] === "string" && slice["value"] !== "";
+	const value = slice[descriptor.field];
+	if (descriptor.kind === "numeric") return typeof value === "number";
+	return typeof value === "boolean";
+}
+function capSlice(caps, capName) {
+	if (capName === void 0 || !isRecord$2(caps)) return void 0;
+	return caps[capName];
+}
+/**
+* A battery group writes `battery.percentage`. The role's usual cap is
+* `numeric-sensor.value`. Hand the renderer a slice whose `value` is that
+* percentage so one numeric path draws both.
+*/
+function batteryPercentageSlice(caps) {
+	const battery = capSlice(caps, "battery");
+	if (!isRecord$2(battery) || typeof battery["percentage"] !== "number") return void 0;
+	return {
+		...battery,
+		value: battery["percentage"]
+	};
+}
+function snapshotSlice(input) {
+	const direct = capSlice(input.snapshotCaps, input.capName);
+	if (input.descriptor !== void 0 && sensorSliceReady(input.descriptor, direct)) return direct;
+	if (input.role === "battery-sensor" && input.descriptor?.kind === "numeric") return batteryPercentageSlice(input.snapshotCaps);
+}
+function resolveSensorHeroReading(input) {
+	const descriptor = input.descriptor;
+	if (descriptor !== void 0 && sensorSliceReady(descriptor, input.live)) return {
+		kind: "value",
+		slice: input.live
+	};
+	const fromSnapshot = snapshotSlice(input);
+	if (descriptor !== void 0 && sensorSliceReady(descriptor, fromSnapshot)) return {
+		kind: "value",
+		slice: fromSnapshot
+	};
+	if (input.addonId === COMPOSER_ADDON_ID && input.snapshotStatus === "success") return { kind: "quiet" };
+	return { kind: "awaiting" };
+}
+//#endregion
 //#region src/composites/device-controls/sensor-hero-card.tsx
 /**
 * SensorHeroCard — large-format sensor value display for the device-detail
@@ -47424,7 +47507,28 @@ function SensorHeroInner({ trpc, device }) {
 	const occupancySlice = useDeviceStateSlice(dev !== null && !isBattery ? dev.state.binary : void 0);
 	const useBinaryBattery = isBattery && roleDescriptor?.kind === "numeric" && !hasBatteryNumericValue(numericSlice, roleDescriptor.field) && binaryBatterySlice !== void 0;
 	const descriptor = useBinaryBattery ? BINARY_BATTERY_DESCRIPTOR : roleDescriptor;
-	const slice = useBinaryBattery ? binaryBatterySlice : numericSlice;
+	const liveSlice = useBinaryBattery ? binaryBatterySlice : numericSlice;
+	const snapshot = useDeviceStateGetSnapshot({ deviceId: device.id }, { staleTime: 5e3 });
+	const capName = useBinaryBattery ? "binary" : device.role != null ? ROLE_OUTPUT_CAP[device.role] : ROLE_OUTPUT_CAP["temperature-sensor"];
+	const snapshotStatus = snapshot.status === "success" || snapshot.status === "error" ? snapshot.status : "pending";
+	const resolution = resolveSensorHeroReading({
+		addonId: device.addonId,
+		role: device.role,
+		descriptor,
+		capName,
+		live: liveSlice,
+		snapshotStatus,
+		snapshotCaps: snapshot.data
+	});
+	if (resolution.kind === "quiet") return /* @__PURE__ */ jsx("div", {
+		className: "flex flex-col items-center justify-center gap-2 rounded-lg border border-border bg-surface p-4 min-h-[96px]",
+		"data-testid": "sensor-hero-quiet",
+		children: /* @__PURE__ */ jsx("span", {
+			className: "text-sm text-foreground-subtle",
+			children: device.name
+		})
+	});
+	const slice = resolution.kind === "value" ? resolution.slice : void 0;
 	if (descriptor === void 0 || slice === void 0) return /* @__PURE__ */ jsxs("div", {
 		className: "flex flex-col items-center justify-center gap-2 rounded-lg border border-border bg-surface p-4 min-h-[96px]",
 		children: [/* @__PURE__ */ jsx("span", {
@@ -47443,7 +47547,7 @@ function SensorHeroInner({ trpc, device }) {
 		const rendered = resolveSensorDisplay({
 			display: device.display,
 			capName: device.role === "numeric-sensor" ? "numeric-sensor" : void 0,
-			roleDefault: device.role != null ? roleDefaultsData?.defaults[device.role] : roleDefaultsData?.defaults["temperature-sensor"],
+			roleDefault: device.role != null ? roleDefaultsData?.defaults?.[device.role] : roleDefaultsData?.defaults?.["temperature-sensor"],
 			quantity: descriptor.quantity ?? "device",
 			deviceQuantity: deviceQuantity === "device" ? void 0 : deviceQuantity
 		}).format(rawValue);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.327",
+  "version": "1.2.328",
   "repository": {
     "type": "git",
     "url": "https://github.com/camstack/server.git",