@camstack/types 1.2.299 → 1.2.300

package/dist/capabilities/alarm-panel.cap.d.ts

@@ -51,6 +51,13 @@ export declare const AlarmPanelStatusSchema: z.ZodObject<{
         disarming: "disarming";
         triggered: "triggered";
     }>;
+    targetMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        home: "home";
+        away: "away";
+        night: "night";
+        vacation: "vacation";
+        custom_bypass: "custom_bypass";
+    }>>>;
     availableModes: z.ZodArray<z.ZodEnum<{
         home: "home";
         away: "away";
@@ -109,6 +116,13 @@ export declare const alarmPanelCapability: {
                 disarming: "disarming";
                 triggered: "triggered";
             }>;
+            targetMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                home: "home";
+                away: "away";
+                night: "night";
+                vacation: "vacation";
+                custom_bypass: "custom_bypass";
+            }>>>;
             availableModes: z.ZodArray<z.ZodEnum<{
                 home: "home";
                 away: "away";
@@ -139,6 +153,13 @@ export declare const alarmPanelCapability: {
             disarming: "disarming";
             triggered: "triggered";
         }>;
+        targetMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            home: "home";
+            away: "away";
+            night: "night";
+            vacation: "vacation";
+            custom_bypass: "custom_bypass";
+        }>>>;
         availableModes: z.ZodArray<z.ZodEnum<{
             home: "home";
             away: "away";

package/dist/device/device-do-actions.d.ts

@@ -1,3 +1,9 @@
+/** An arg the authoring UI collects (not baked into the catalogue entry). */
+export interface DeviceDoOpenArg {
+    readonly key: string;
+    readonly label: string;
+    readonly kind: 'string' | 'number';
+}
 /** One operator-facing action that becomes a cap method call. */
 export interface DeviceDoAction {
     /** Stable id for the select value, e.g. `switch.on`. */
@@ -7,6 +13,12 @@ export interface DeviceDoAction {
     readonly cap: string;
     readonly method: string;
     readonly args?: Readonly<Record<string, unknown>>;
+    /**
+     * Keys the operator fills after picking the action (e.g. `presetId` for
+     * `ptz.goToPreset`). Matching ignores these — only baked {@link args} must
+     * agree — so a saved step with a filled preset still selects this entry.
+     */
+    readonly openArgs?: readonly DeviceDoOpenArg[];
 }
 /**
  * The curated catalogue. Order is the order the select draws.

package/dist/index.d.ts

@@ -178,7 +178,7 @@ export { DeviceConfig } from './device/device-config.js';
 export type { DeviceConstructor, DeviceContext, DeviceManagerApi, IDeviceRegistry, IDeviceRegistryReader, } from './device/device-context.js';
 export type { AccessoryControlInput, AccessoryControlKind, AccessoryControlPick, DeviceControlKind, SensorMapping, } from './device/device-control-resolution.js';
 export { DEVICE_TYPE_CONTROL_KIND, hasMotionTrigger, isNode, MOTION_TRIGGER_FEATURE, pickAccessoryControl, resolveDeviceControlKind, resolveMutate, SENSOR_FEATURES, SENSOR_MAP, } from './device/device-control-resolution.js';
-export type { DeviceDoAction } from './device/device-do-actions.js';
+export type { DeviceDoAction, DeviceDoOpenArg } from './device/device-do-actions.js';
 export { actionsForBoundCaps, allDoActions, DEVICE_DO_ACTIONS, doActionSelectValue, isDoActionActuatable, matchDoAction, } from './device/device-do-actions.js';
 export type { ChildLayout, ChildLayoutEntry, CreateDeviceSpec, DeviceCapDisplayOverride, DeviceDiscovery, DeviceDisplayOverride, DeviceManualCreation, DeviceMeta, DiscoveredDevice, InitialDeviceMeta, RoleDisplayDefault, SavedDevice, } from './device/device-management.js';
 export type { DeviceProfile, DeviceProfileDefaults, DeviceProfileMatch, PipelinePhaseMode, } from './device/device-profile.js';

package/dist/index.js

@@ -18950,6 +18950,15 @@ var AlarmArmModeSchema = zod.z.enum([
 var AlarmPanelStatusSchema = zod.z.object({
 	/** Current lifecycle state. */
 	state: AlarmStateSchema,
+	/**
+	* The arm mode the machine belongs to under transitional words
+	* (`arming` / `pending` / `triggered` / `disarming`). `null` when
+	* disarmed or when a provider cannot name one. Exporters MUST prefer
+	* this over an in-process memo — a HomeKit accessory that missed the
+	* settled `armed_*` slice used to map `pending` to DISARMED and hide
+	* an entry delay.
+	*/
+	targetMode: AlarmArmModeSchema.nullable().optional(),
 	/** Subset of arm modes the panel accepts. UI renders one button per
 	*  mode in this list. */
 	availableModes: zod.z.array(AlarmArmModeSchema),
@@ -57636,6 +57645,199 @@ var DEVICE_DO_ACTIONS = [
 		method: "stop",
 		args: {}
 	},
+	{
+		id: "climate.off",
+		label: "Climate off",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "off" }
+	},
+	{
+		id: "climate.heat",
+		label: "Heat",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "heat" }
+	},
+	{
+		id: "climate.cool",
+		label: "Cool",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "cool" }
+	},
+	{
+		id: "climate.auto",
+		label: "Climate auto",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "auto" }
+	},
+	{
+		id: "fan.off",
+		label: "Fan off",
+		cap: "fan-control",
+		method: "setPercentage",
+		args: { percentage: 0 }
+	},
+	{
+		id: "fan.full",
+		label: "Fan full",
+		cap: "fan-control",
+		method: "setPercentage",
+		args: { percentage: 100 }
+	},
+	{
+		id: "vacuum.start",
+		label: "Start cleaning",
+		cap: "vacuum-control",
+		method: "start",
+		args: {}
+	},
+	{
+		id: "vacuum.pause",
+		label: "Pause",
+		cap: "vacuum-control",
+		method: "pause",
+		args: {}
+	},
+	{
+		id: "vacuum.stop",
+		label: "Stop",
+		cap: "vacuum-control",
+		method: "stop",
+		args: {}
+	},
+	{
+		id: "vacuum.dock",
+		label: "Return to base",
+		cap: "vacuum-control",
+		method: "returnToBase",
+		args: {}
+	},
+	{
+		id: "ptz.goHome",
+		label: "PTZ go home",
+		cap: "ptz",
+		method: "goHome",
+		args: {}
+	},
+	{
+		id: "ptz.goToPreset",
+		label: "PTZ go to preset",
+		cap: "ptz",
+		method: "goToPreset",
+		openArgs: [{
+			key: "presetId",
+			label: "Preset id",
+			kind: "string"
+		}]
+	},
+	{
+		id: "ptz.autotrackOn",
+		label: "Autotrack on",
+		cap: "ptz-autotrack",
+		method: "setEnabled",
+		args: { enabled: true }
+	},
+	{
+		id: "ptz.autotrackOff",
+		label: "Autotrack off",
+		cap: "ptz-autotrack",
+		method: "setEnabled",
+		args: { enabled: false }
+	},
+	{
+		id: "privacy.maskOn",
+		label: "Privacy mask on",
+		cap: "privacy-mask",
+		method: "setMask",
+		args: { patch: { enabled: true } }
+	},
+	{
+		id: "privacy.maskOff",
+		label: "Privacy mask off",
+		cap: "privacy-mask",
+		method: "setMask",
+		args: { patch: { enabled: false } }
+	},
+	{
+		id: "privacy.micOn",
+		label: "Microphone on",
+		cap: "privacy-mask",
+		method: "setAudioEnabled",
+		args: { enabled: true }
+	},
+	{
+		id: "privacy.micOff",
+		label: "Microphone off",
+		cap: "privacy-mask",
+		method: "setAudioEnabled",
+		args: { enabled: false }
+	},
+	{
+		id: "dayNight.auto",
+		label: "Day/night auto",
+		cap: "day-night",
+		method: "setSettings",
+		args: { settings: { mode: "auto" } }
+	},
+	{
+		id: "dayNight.day",
+		label: "Day mode",
+		cap: "day-night",
+		method: "setSettings",
+		args: { settings: { mode: "day" } }
+	},
+	{
+		id: "dayNight.night",
+		label: "Night mode",
+		cap: "day-night",
+		method: "setSettings",
+		args: { settings: { mode: "night" } }
+	},
+	{
+		id: "reboot.reboot",
+		label: "Reboot device",
+		cap: "reboot",
+		method: "reboot",
+		args: {}
+	},
+	{
+		id: "brightness.full",
+		label: "Brightness full",
+		cap: "brightness",
+		method: "setBrightness",
+		args: { percentage: 100 }
+	},
+	{
+		id: "brightness.half",
+		label: "Brightness half",
+		cap: "brightness",
+		method: "setBrightness",
+		args: { percentage: 50 }
+	},
+	{
+		id: "brightness.off",
+		label: "Brightness off",
+		cap: "brightness",
+		method: "setBrightness",
+		args: { percentage: 0 }
+	},
+	{
+		id: "motionTrigger.on",
+		label: "Motion trigger on",
+		cap: "motion-trigger",
+		method: "setMotionTrigger",
+		args: { enabled: true }
+	},
+	{
+		id: "motionTrigger.off",
+		label: "Motion trigger off",
+		cap: "motion-trigger",
+		method: "setMotionTrigger",
+		args: { enabled: false }
+	},
 	{
 		id: "alarm.trigger",
 		label: "Trigger alarm",
@@ -57703,15 +57905,42 @@ function isDoActionActuatable(action) {
 	}
 	return false;
 }
-function argsEqual(left, right) {
-	const a = left ?? {};
-	const b = right ?? {};
+function valueEqual(left, right) {
+	if (left === right) return true;
+	if (left === null || right === null) return left === right;
+	if (typeof left !== "object" || typeof right !== "object") return false;
+	if (Array.isArray(left) || Array.isArray(right)) {
+		if (!Array.isArray(left) || !Array.isArray(right)) return false;
+		if (left.length !== right.length) return false;
+		for (let i = 0; i < left.length; i++) if (!valueEqual(left[i], right[i])) return false;
+		return true;
+	}
+	const a = left;
+	const b = right;
 	const aKeys = Object.keys(a);
 	const bKeys = Object.keys(b);
 	if (aKeys.length !== bKeys.length) return false;
-	for (const key of aKeys) if (a[key] !== b[key]) return false;
+	for (const key of aKeys) if (!valueEqual(a[key], b[key])) return false;
 	return true;
 }
+function argsEqual(left, right) {
+	return valueEqual(left ?? {}, right ?? {});
+}
+/** Baked args only — open-arg keys the operator fills are ignored for matching. */
+function bakedArgsEqual(action, args) {
+	if (action.openArgs !== void 0) {
+		const open = new Set(action.openArgs.map((a) => a.key));
+		const baked = action.args ?? {};
+		const actual = args ?? {};
+		for (const key of Object.keys(baked)) if (!valueEqual(baked[key], actual[key])) return false;
+		for (const key of Object.keys(actual)) {
+			if (open.has(key)) continue;
+			if (!(key in baked)) return false;
+		}
+		return true;
+	}
+	return argsEqual(action.args, args);
+}
 /**
 * Actions offered for a device that binds the given caps.
 *
@@ -57734,7 +57963,7 @@ function allDoActions() {
 function matchDoAction(cap, method, args) {
 	for (const action of DEVICE_DO_ACTIONS) {
 		if (action.cap !== cap || action.method !== method) continue;
-		if (!argsEqual(action.args, args)) continue;
+		if (!bakedArgsEqual(action, args)) continue;
 		return action;
 	}
 	return null;

package/dist/index.mjs

@@ -18949,6 +18949,15 @@ var AlarmArmModeSchema = z.enum([
 var AlarmPanelStatusSchema = z.object({
 	/** Current lifecycle state. */
 	state: AlarmStateSchema,
+	/**
+	* The arm mode the machine belongs to under transitional words
+	* (`arming` / `pending` / `triggered` / `disarming`). `null` when
+	* disarmed or when a provider cannot name one. Exporters MUST prefer
+	* this over an in-process memo — a HomeKit accessory that missed the
+	* settled `armed_*` slice used to map `pending` to DISARMED and hide
+	* an entry delay.
+	*/
+	targetMode: AlarmArmModeSchema.nullable().optional(),
 	/** Subset of arm modes the panel accepts. UI renders one button per
 	*  mode in this list. */
 	availableModes: z.array(AlarmArmModeSchema),
@@ -57635,6 +57644,199 @@ var DEVICE_DO_ACTIONS = [
 		method: "stop",
 		args: {}
 	},
+	{
+		id: "climate.off",
+		label: "Climate off",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "off" }
+	},
+	{
+		id: "climate.heat",
+		label: "Heat",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "heat" }
+	},
+	{
+		id: "climate.cool",
+		label: "Cool",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "cool" }
+	},
+	{
+		id: "climate.auto",
+		label: "Climate auto",
+		cap: "climate-control",
+		method: "setMode",
+		args: { mode: "auto" }
+	},
+	{
+		id: "fan.off",
+		label: "Fan off",
+		cap: "fan-control",
+		method: "setPercentage",
+		args: { percentage: 0 }
+	},
+	{
+		id: "fan.full",
+		label: "Fan full",
+		cap: "fan-control",
+		method: "setPercentage",
+		args: { percentage: 100 }
+	},
+	{
+		id: "vacuum.start",
+		label: "Start cleaning",
+		cap: "vacuum-control",
+		method: "start",
+		args: {}
+	},
+	{
+		id: "vacuum.pause",
+		label: "Pause",
+		cap: "vacuum-control",
+		method: "pause",
+		args: {}
+	},
+	{
+		id: "vacuum.stop",
+		label: "Stop",
+		cap: "vacuum-control",
+		method: "stop",
+		args: {}
+	},
+	{
+		id: "vacuum.dock",
+		label: "Return to base",
+		cap: "vacuum-control",
+		method: "returnToBase",
+		args: {}
+	},
+	{
+		id: "ptz.goHome",
+		label: "PTZ go home",
+		cap: "ptz",
+		method: "goHome",
+		args: {}
+	},
+	{
+		id: "ptz.goToPreset",
+		label: "PTZ go to preset",
+		cap: "ptz",
+		method: "goToPreset",
+		openArgs: [{
+			key: "presetId",
+			label: "Preset id",
+			kind: "string"
+		}]
+	},
+	{
+		id: "ptz.autotrackOn",
+		label: "Autotrack on",
+		cap: "ptz-autotrack",
+		method: "setEnabled",
+		args: { enabled: true }
+	},
+	{
+		id: "ptz.autotrackOff",
+		label: "Autotrack off",
+		cap: "ptz-autotrack",
+		method: "setEnabled",
+		args: { enabled: false }
+	},
+	{
+		id: "privacy.maskOn",
+		label: "Privacy mask on",
+		cap: "privacy-mask",
+		method: "setMask",
+		args: { patch: { enabled: true } }
+	},
+	{
+		id: "privacy.maskOff",
+		label: "Privacy mask off",
+		cap: "privacy-mask",
+		method: "setMask",
+		args: { patch: { enabled: false } }
+	},
+	{
+		id: "privacy.micOn",
+		label: "Microphone on",
+		cap: "privacy-mask",
+		method: "setAudioEnabled",
+		args: { enabled: true }
+	},
+	{
+		id: "privacy.micOff",
+		label: "Microphone off",
+		cap: "privacy-mask",
+		method: "setAudioEnabled",
+		args: { enabled: false }
+	},
+	{
+		id: "dayNight.auto",
+		label: "Day/night auto",
+		cap: "day-night",
+		method: "setSettings",
+		args: { settings: { mode: "auto" } }
+	},
+	{
+		id: "dayNight.day",
+		label: "Day mode",
+		cap: "day-night",
+		method: "setSettings",
+		args: { settings: { mode: "day" } }
+	},
+	{
+		id: "dayNight.night",
+		label: "Night mode",
+		cap: "day-night",
+		method: "setSettings",
+		args: { settings: { mode: "night" } }
+	},
+	{
+		id: "reboot.reboot",
+		label: "Reboot device",
+		cap: "reboot",
+		method: "reboot",
+		args: {}
+	},
+	{
+		id: "brightness.full",
+		label: "Brightness full",
+		cap: "brightness",
+		method: "setBrightness",
+		args: { percentage: 100 }
+	},
+	{
+		id: "brightness.half",
+		label: "Brightness half",
+		cap: "brightness",
+		method: "setBrightness",
+		args: { percentage: 50 }
+	},
+	{
+		id: "brightness.off",
+		label: "Brightness off",
+		cap: "brightness",
+		method: "setBrightness",
+		args: { percentage: 0 }
+	},
+	{
+		id: "motionTrigger.on",
+		label: "Motion trigger on",
+		cap: "motion-trigger",
+		method: "setMotionTrigger",
+		args: { enabled: true }
+	},
+	{
+		id: "motionTrigger.off",
+		label: "Motion trigger off",
+		cap: "motion-trigger",
+		method: "setMotionTrigger",
+		args: { enabled: false }
+	},
 	{
 		id: "alarm.trigger",
 		label: "Trigger alarm",
@@ -57702,15 +57904,42 @@ function isDoActionActuatable(action) {
 	}
 	return false;
 }
-function argsEqual(left, right) {
-	const a = left ?? {};
-	const b = right ?? {};
+function valueEqual(left, right) {
+	if (left === right) return true;
+	if (left === null || right === null) return left === right;
+	if (typeof left !== "object" || typeof right !== "object") return false;
+	if (Array.isArray(left) || Array.isArray(right)) {
+		if (!Array.isArray(left) || !Array.isArray(right)) return false;
+		if (left.length !== right.length) return false;
+		for (let i = 0; i < left.length; i++) if (!valueEqual(left[i], right[i])) return false;
+		return true;
+	}
+	const a = left;
+	const b = right;
 	const aKeys = Object.keys(a);
 	const bKeys = Object.keys(b);
 	if (aKeys.length !== bKeys.length) return false;
-	for (const key of aKeys) if (a[key] !== b[key]) return false;
+	for (const key of aKeys) if (!valueEqual(a[key], b[key])) return false;
 	return true;
 }
+function argsEqual(left, right) {
+	return valueEqual(left ?? {}, right ?? {});
+}
+/** Baked args only — open-arg keys the operator fills are ignored for matching. */
+function bakedArgsEqual(action, args) {
+	if (action.openArgs !== void 0) {
+		const open = new Set(action.openArgs.map((a) => a.key));
+		const baked = action.args ?? {};
+		const actual = args ?? {};
+		for (const key of Object.keys(baked)) if (!valueEqual(baked[key], actual[key])) return false;
+		for (const key of Object.keys(actual)) {
+			if (open.has(key)) continue;
+			if (!(key in baked)) return false;
+		}
+		return true;
+	}
+	return argsEqual(action.args, args);
+}
 /**
 * Actions offered for a device that binds the given caps.
 *
@@ -57733,7 +57962,7 @@ function allDoActions() {
 function matchDoAction(cap, method, args) {
 	for (const action of DEVICE_DO_ACTIONS) {
 		if (action.cap !== cap || action.method !== method) continue;
-		if (!argsEqual(action.args, args)) continue;
+		if (!bakedArgsEqual(action, args)) continue;
 		return action;
 	}
 	return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.299",
+  "version": "1.2.300",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",