@camstack/ui-library 1.2.121 → 1.2.123

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

@@ -22,5 +22,18 @@ export declare function RecordingBandsEditor({ bands, onChange, sensorContext, }
 export interface RecordingSensorContext {
     readonly cameraId: number;
     readonly location: string | null;
+    /**
+     * Does this camera publish its own `recording-signal` — the LEVEL an events
+     * band can follow (`RecordingTriggers.deviceSignal`)? Asked of the camera's
+     * bindings by the host. Absent = the host did not ask; the control is then
+     * offered only to switch OFF a band that already listens.
+     */
+    readonly deviceSignal?: DeviceSignalPresence;
 }
+/**
+ * What the host knows about the camera's `recording-signal` binding. Four
+ * states, not a boolean (D315): `pending` and `unknown` must render as
+ * "not yet known", never as "this camera has no signal".
+ */
+export type DeviceSignalPresence = 'pending' | 'present' | 'absent' | 'unknown';
 export {};

package/dist/index.cjs

@@ -17412,6 +17412,11 @@ function BandRow({ band, onChange, onRemove, sensorContext }) {
 							}, cls);
 						})]
 					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(DeviceSignalTrigger, {
+						presence: sensorContext?.deviceSignal,
+						checked: band.triggers?.deviceSignal === true,
+						onChange: (on) => setTriggers({ deviceSignal: on ? true : void 0 })
+					}),
 					sensorContext !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DeviceMultiSelectField, {
 						field: sensorPickerField(sensorContext),
 						value: (band.triggers?.sensorDeviceIds ?? []).map(String),
@@ -17457,6 +17462,34 @@ function BandRow({ band, onChange, onRemove, sensorContext }) {
 		]
 	});
 }
+/**
+* The `deviceSignal` control. Offered when the camera is KNOWN to publish the
+* signal; shown disabled while that is not yet known (a control that vanishes
+* while a query is in flight reads as "this camera cannot do it"); and, for a
+* band that already listens, always offered so the operator can switch it
+* off — whatever the host knows today.
+*/
+function DeviceSignalTrigger({ presence, checked, onChange }) {
+	const settled = presence === "present" || checked;
+	if (!settled && presence !== "pending" && presence !== "unknown") return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+		className: "flex items-center gap-2 text-xs",
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+				type: "checkbox",
+				"aria-label": "Device signal",
+				checked,
+				disabled: !settled,
+				onChange: (e) => onChange(e.target.checked)
+			}),
+			"Device signal",
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "text-foreground-subtle",
+				children: presence === "pending" ? "checking the camera…" : presence === "unknown" ? "could not check the camera" : presence === "absent" ? "not offered by this camera" : "records for as long as the device reports it is in function"
+			})
+		]
+	});
+}
 //#endregion
 //#region src/composites/cap-settings/RecordingSettings.tsx
 var MODES = [
@@ -19152,6 +19185,8 @@ function RecordingPanel({ deviceId }) {
 	const statusQuery = useRecordingGetStatus({ deviceId });
 	const configQuery = useRecordingGetDeviceConfig({ deviceId });
 	const cameraLocation = useDeviceManagerGetDevice({ deviceId }).data?.location ?? null;
+	const bindingsQuery = useDeviceManagerGetBindings({ deviceId });
+	const deviceSignal = bindingsQuery.status === "pending" ? "pending" : bindingsQuery.status === "error" ? "unknown" : bindingsQuery.data.entries.some((e) => e.capName === "recording-signal") ? "present" : "absent";
 	const setConfig = useRecordingSetDeviceConfig();
 	const rescanStorage = useRecordingRescanStorage();
 	const { data: profileSlots } = useStreamBrokerListAllProfileSlots(void 0, { staleTime: 3e4 });
@@ -19199,7 +19234,8 @@ function RecordingPanel({ deviceId }) {
 				onSave: saveConfig,
 				sensorContext: {
 					cameraId: deviceId,
-					location: cameraLocation
+					location: cameraLocation,
+					deviceSignal
 				}
 			}, JSON.stringify(resolvedConfig)) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "px-1 py-2 text-xs text-foreground-subtle",

package/dist/index.js

@@ -17388,6 +17388,11 @@ function BandRow({ band, onChange, onRemove, sensorContext }) {
 							}, cls);
 						})]
 					}),
+					/* @__PURE__ */ jsx(DeviceSignalTrigger, {
+						presence: sensorContext?.deviceSignal,
+						checked: band.triggers?.deviceSignal === true,
+						onChange: (on) => setTriggers({ deviceSignal: on ? true : void 0 })
+					}),
 					sensorContext !== void 0 ? /* @__PURE__ */ jsx(DeviceMultiSelectField, {
 						field: sensorPickerField(sensorContext),
 						value: (band.triggers?.sensorDeviceIds ?? []).map(String),
@@ -17433,6 +17438,34 @@ function BandRow({ band, onChange, onRemove, sensorContext }) {
 		]
 	});
 }
+/**
+* The `deviceSignal` control. Offered when the camera is KNOWN to publish the
+* signal; shown disabled while that is not yet known (a control that vanishes
+* while a query is in flight reads as "this camera cannot do it"); and, for a
+* band that already listens, always offered so the operator can switch it
+* off — whatever the host knows today.
+*/
+function DeviceSignalTrigger({ presence, checked, onChange }) {
+	const settled = presence === "present" || checked;
+	if (!settled && presence !== "pending" && presence !== "unknown") return null;
+	return /* @__PURE__ */ jsxs("label", {
+		className: "flex items-center gap-2 text-xs",
+		children: [
+			/* @__PURE__ */ jsx("input", {
+				type: "checkbox",
+				"aria-label": "Device signal",
+				checked,
+				disabled: !settled,
+				onChange: (e) => onChange(e.target.checked)
+			}),
+			"Device signal",
+			/* @__PURE__ */ jsx("span", {
+				className: "text-foreground-subtle",
+				children: presence === "pending" ? "checking the camera…" : presence === "unknown" ? "could not check the camera" : presence === "absent" ? "not offered by this camera" : "records for as long as the device reports it is in function"
+			})
+		]
+	});
+}
 //#endregion
 //#region src/composites/cap-settings/RecordingSettings.tsx
 var MODES = [
@@ -19128,6 +19161,8 @@ function RecordingPanel({ deviceId }) {
 	const statusQuery = useRecordingGetStatus({ deviceId });
 	const configQuery = useRecordingGetDeviceConfig({ deviceId });
 	const cameraLocation = useDeviceManagerGetDevice({ deviceId }).data?.location ?? null;
+	const bindingsQuery = useDeviceManagerGetBindings({ deviceId });
+	const deviceSignal = bindingsQuery.status === "pending" ? "pending" : bindingsQuery.status === "error" ? "unknown" : bindingsQuery.data.entries.some((e) => e.capName === "recording-signal") ? "present" : "absent";
 	const setConfig = useRecordingSetDeviceConfig();
 	const rescanStorage = useRecordingRescanStorage();
 	const { data: profileSlots } = useStreamBrokerListAllProfileSlots(void 0, { staleTime: 3e4 });
@@ -19175,7 +19210,8 @@ function RecordingPanel({ deviceId }) {
 				onSave: saveConfig,
 				sensorContext: {
 					cameraId: deviceId,
-					location: cameraLocation
+					location: cameraLocation,
+					deviceSignal
 				}
 			}, JSON.stringify(resolvedConfig)) : /* @__PURE__ */ jsx("div", {
 				className: "px-1 py-2 text-xs text-foreground-subtle",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.121",
+  "version": "1.2.123",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",