@camstack/types 1.2.302 → 1.2.304

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

@@ -1,3 +1,4 @@
+import { DeviceType } from './device-type.js';
 /** An arg the authoring UI collects (not baked into the catalogue entry). */
 export interface DeviceDoOpenArg {
     readonly key: string;
@@ -27,6 +28,36 @@ export interface DeviceDoAction {
 export declare const DEVICE_DO_ACTIONS: readonly DeviceDoAction[];
 /** True when METHOD_ACCESS_MAP still exposes this cap.method as actuatable. */
 export declare function isDoActionActuatable(action: DeviceDoAction): boolean;
+/**
+ * Catalogue caps a `DeviceType` is expected to offer in the Do picker.
+ *
+ * Exhaustive over {@link DeviceType}: adding a new enum member without an
+ * entry fails the TypeScript build here (same pattern as
+ * {@link DEVICE_TYPE_CONTROL_KIND}). An empty list is a deliberate choice
+ * for read-only / non-actuatable types — never "forgotten".
+ *
+ * Camera accessories (ptz, privacy-mask, …) are listed on Camera even though
+ * a given camera may bind only a subset; {@link actionsForBoundCaps} still
+ * filters to what the device actually binds.
+ */
+export declare const DEVICE_TYPE_DO_CAPS: Record<DeviceType, readonly string[]>;
+/**
+ * Whether a device type belongs in a Do / automation action device picker.
+ *
+ * Containers stay in {@link DEVICE_TYPE_DO_CAPS} (empty, for exhaustiveness)
+ * but must never appear as selectable targets — actuate the children instead.
+ */
+export declare function isDoPickerDeviceType(type: string): boolean;
+/**
+ * Do-picker family id — devices that share one may be multi-selected for
+ * the same action (several locks, the climate family, cover+valve, …).
+ *
+ * Distinct from {@link DeviceControlKind}: humidifier / water-heater keep
+ * their own control widgets but author with climate siblings.
+ */
+export declare function deviceDoFamily(type: string): string;
+/** True when two device types may share one multi-target Do step. */
+export declare function sameDoFamily(leftType: string, rightType: string): boolean;
 /**
  * Actions offered for a device that binds the given caps.
  *
@@ -34,6 +65,32 @@ export declare function isDoActionActuatable(action: DeviceDoAction): boolean;
  * METHOD_ACCESS_MAP. Empty bindings → empty list (pick a device first).
  */
 export declare function actionsForBoundCaps(boundCaps: readonly string[]): readonly DeviceDoAction[];
+/**
+ * Catalogue actions for a wire `DeviceType` string — the fallback when
+ * bindings have not answered yet (or answered empty for a typed actuator).
+ * Unknown type strings → empty.
+ */
+export declare function actionsForDeviceType(type: string): readonly DeviceDoAction[];
+/**
+ * Union of bound-cap actions with the type's expected catalogue caps.
+ *
+ * Bindings win for filtering (a lock without `lock-control` bound still
+ * offers nothing from bindings alone); the type map fills gaps when the
+ * binding read is empty so a Lock / Valve / Climate never shows
+ * "No actions for this device" solely because getBindings lagged.
+ */
+export declare function actionsForDevice(input: {
+    readonly boundCaps: readonly string[] | undefined;
+    readonly deviceType: string | undefined;
+}): readonly DeviceDoAction[];
+/**
+ * Intersection of {@link actionsForDevice} across several targets — what a
+ * multi-select same-family Do step may offer.
+ */
+export declare function actionsForDevices(targets: readonly {
+    readonly boundCaps?: readonly string[];
+    readonly deviceType?: string;
+}[]): readonly DeviceDoAction[];
 /** The whole catalogue (still actuatable) — for a `{$var}` automation target. */
 export declare function allDoActions(): readonly DeviceDoAction[];
 /**

package/dist/encode-profile.d.ts

@@ -30,11 +30,11 @@ export declare const VideoEncodeSchema: z.ZodObject<{
     gopFrames: z.ZodOptional<z.ZodNumber>;
     bf: z.ZodOptional<z.ZodNumber>;
     preset: z.ZodOptional<z.ZodEnum<{
-        fast: "fast";
         ultrafast: "ultrafast";
         superfast: "superfast";
         veryfast: "veryfast";
         faster: "faster";
+        fast: "fast";
         medium: "medium";
     }>>;
     tune: z.ZodOptional<z.ZodEnum<{
@@ -78,11 +78,11 @@ export declare const EncodeProfileSchema: z.ZodObject<{
         gopFrames: z.ZodOptional<z.ZodNumber>;
         bf: z.ZodOptional<z.ZodNumber>;
         preset: z.ZodOptional<z.ZodEnum<{
-            fast: "fast";
             ultrafast: "ultrafast";
             superfast: "superfast";
             veryfast: "veryfast";
             faster: "faster";
+            fast: "fast";
             medium: "medium";
         }>>;
         tune: z.ZodOptional<z.ZodEnum<{

package/dist/index.d.ts

@@ -179,7 +179,7 @@ export type { DeviceConstructor, DeviceContext, DeviceManagerApi, IDeviceRegistr
 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, DeviceDoOpenArg } from './device/device-do-actions.js';
-export { actionsForBoundCaps, allDoActions, DEVICE_DO_ACTIONS, doActionSelectValue, isDoActionActuatable, matchDoAction, } from './device/device-do-actions.js';
+export { actionsForBoundCaps, actionsForDevice, actionsForDevices, actionsForDeviceType, allDoActions, DEVICE_DO_ACTIONS, DEVICE_TYPE_DO_CAPS, deviceDoFamily, doActionSelectValue, isDoActionActuatable, isDoPickerDeviceType, matchDoAction, sameDoFamily, } 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';
 export { BATTERY_DEVICE_PROFILE, DEVICE_PROFILES, deviceMatchesProfile, resolveDeviceProfile, } from './device/device-profile.js';
@@ -242,9 +242,9 @@ export { type PreparedAction, type PreparedAttachment, type PreparedNotification
 export { htmlToText, markdownToHtmlLite, markdownToText, type NotificationFormat as NotificationBodyFormat, resolveFormat, textToHtml, transcodeBody, } from './notification/format-transcode.js';
 export { conditionExclusionReason, conditionVisibleForKind, defaultDeliveryForSection, droppedConditionsForKind, isAudioRule, isOccupancyRule, isSystemDelivery, isSystemRuleKind, kindsForDiscriminator, NC_AUDIO_SEED, NC_CAMERA_SCOPE_CAP_NAME, NC_OCCUPANCY_DEFAULTS, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_RULE_SECTIONS, NC_SYSTEM_DELIVERY, NC_SYSTEM_RULE_KINDS, type NcDroppedCondition, type NcKindVisibilitySubject, type NcRuleEditorSection, type NcRuleEditorSectionKey, type NcRuleKind, type NcRuleKindSpec, type NcRuleOwningSectionKey, type NcRuleSection, type NcRuleSectionKey, type NcRuleConditionsSubject, type NcRuleSectionSubject, type NcRuleSeed, parseRuleSection, ruleDeviceCompatCapNames, ruleDeviceCompatCapQueries, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleMatchesSection, ruleSection, ruleSectionOf, ruleSeedForSection, systemFamilyOfKind, systemRuleKindOf, } from './notification/rule-kinds.js';
 export { isScheduleActive } from './notification/schedule.js';
-export { isAlarmControllableCap, NC_ALARM_CONTROLLABLE_CAPS, NC_ALARM_OPENING_EVENT_KINDS, NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING, type NcAlarmControllableCap, type NcAlarmMembershipSubject, type NcAlarmOpeningEventKind, ruleBelongsToAlarm, sensorTransitionNeverFires, } from './notification/alarm-membership.js';
+export { isAlarmControllableCap, NC_ALARM_CONTROLLABLE_CAPS, NC_ALARM_OPENING_EVENT_KINDS, NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING, type NcAlarmControllableCap, type NcAlarmMembershipSubject, type NcAlarmOpeningEventKind, ruleAutoTriggersAlarm, ruleBelongsToAlarm, ruleGatedOnArmedState, sensorTransitionNeverFires, } from './notification/alarm-membership.js';
 export { alarmDeviceBlocksArming, alarmDeviceSecureOnArm, type AlarmDeviceBlocksInput, type AlarmDeviceSecureOnArmInput, type NcAlarmSecureActuation, secureActuationFor, } from './notification/alarm-controllable.js';
-export { alarmPatchLanded, applyBlockingEdit, applyModeDelaysEdits, applyModeDeviceListEdit, applyNonBlockingEdit, applySecureOnArmEdit, NC_ALARM_DELAY_FIELDS, type NcAlarmDelayField, type NcAlarmDelaySettings, type NcAlarmDelaySource, type NcAlarmModeDeviceListEditResult, type NcAlarmNonBlockingEditResult, type NcAlarmResolvedDelays, resolveModeDelays, } from './notification/alarm-settings.js';
+export { alarmPatchLanded, applyBlockingEdit, applyModeDelaysEdits, applyModeDeviceListEdit, applyNonBlockingEdit, applySecureOnArmEdit, derivePostTriggeredAction, NC_ALARM_DELAY_FIELDS, type NcAlarmDelayField, type NcAlarmDelaySettings, type NcAlarmDelaySource, type NcAlarmModeDeviceListEditResult, type NcAlarmNonBlockingEditResult, type NcAlarmResolvedDelays, resolveModeDelays, } from './notification/alarm-settings.js';
 export { activateAlarmProfile, alarmProfileById, cloneAlarmSettings, createAlarmProfile, deleteAlarmProfile, ensureAlarmProfiles, isDefaultAlarmProfileId, NC_ALARM_DEFAULT_PROFILE_ID, NC_ALARM_DEFAULT_PROFILE_NAME, NC_ALARM_SYSTEM_DEFAULT_DELAYS, ncAlarmSystemDefaultSettings, type NcAlarmProfileCreateSource, type NcAlarmProfileRecord, type NcAlarmProfilesMutationResult, type NcAlarmProfilesRefuseReason, type NcAlarmProfilesState, renameAlarmProfile, syncActiveAlarmProfileSettings, } from './notification/alarm-profiles.js';
 export { NC_SENSOR_RAISED_FIELD_BY_KIND, NC_SENSOR_TRANSITION_KINDS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, sensorRaisedOf, sensorTransitionOffered, } from './notification/sensor-raised.js';
 export { NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, isHeldBackTemplateVar, isKnownTemplateVar, servedTemplateVars, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, templateVarsFor, } from './notification/template-vars.js';