@camstack/types 1.2.548 → 1.2.549

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dist/addon.js +5 -5
  3. package/dist/addon.mjs +5 -5
  4. package/dist/capabilities/accessories.cap.d.ts +1 -1
  5. package/dist/capabilities/battery.cap.d.ts +2 -2
  6. package/dist/capabilities/capability-definition.d.ts +47 -1
  7. package/dist/capabilities/climate-control.cap.d.ts +8 -1
  8. package/dist/capabilities/core-blocks.cap.d.ts +2 -0
  9. package/dist/capabilities/customize-catalog.d.ts +3 -1
  10. package/dist/capabilities/customize-spec.d.ts +26 -2
  11. package/dist/capabilities/device-manager.cap.d.ts +6 -0
  12. package/dist/capabilities/fan-control.cap.d.ts +248 -0
  13. package/dist/capabilities/fan-presets.cap.d.ts +172 -536
  14. package/dist/capabilities/group-active.cap.d.ts +1 -1
  15. package/dist/capabilities/group-commands.cap.d.ts +1 -1
  16. package/dist/capabilities/group-status.cap.d.ts +1 -1
  17. package/dist/capabilities/heating-valve.cap.d.ts +1 -1
  18. package/dist/capabilities/hero-layout.cap.d.ts +2 -0
  19. package/dist/capabilities/humidifier.cap.d.ts +5 -0
  20. package/dist/capabilities/humidity-sensor.cap.d.ts +1 -1
  21. package/dist/capabilities/index.d.ts +4 -4
  22. package/dist/capabilities/media-player.cap.d.ts +7 -0
  23. package/dist/capabilities/pet-fountain.cap.d.ts +5 -0
  24. package/dist/capabilities/power-meter.cap.d.ts +5 -5
  25. package/dist/capabilities/power-source.cap.d.ts +5 -0
  26. package/dist/capabilities/running-state.cap.d.ts +2 -2
  27. package/dist/capabilities/switch.cap.d.ts +1 -1
  28. package/dist/capabilities/temperature-sensor.cap.d.ts +1 -1
  29. package/dist/capabilities/timed-run.cap.d.ts +19 -5
  30. package/dist/capabilities/water-heater.cap.d.ts +7 -0
  31. package/dist/client.js +7 -11
  32. package/dist/client.mjs +7 -11
  33. package/dist/{composed-stable-id-DrGLxjVF.js → composed-stable-id-CDNLq7Y8.js} +27 -10
  34. package/dist/{composed-stable-id-DFNyOFzz.mjs → composed-stable-id-CPp3votu.mjs} +27 -10
  35. package/dist/composition/composition-report.d.ts +6 -0
  36. package/dist/composition/evaluate-field.d.ts +7 -0
  37. package/dist/composition/field-kinds.d.ts +12 -1
  38. package/dist/composition/helpers/index.d.ts +1 -1
  39. package/dist/composition/helpers/source-pick.d.ts +0 -5
  40. package/dist/composition/power-source-link.d.ts +15 -0
  41. package/dist/composition/state-fields.d.ts +2 -0
  42. package/dist/composition/validate-composition.d.ts +15 -1
  43. package/dist/device/base-device-provider.d.ts +13 -0
  44. package/dist/device/device-control-resolution.d.ts +1 -33
  45. package/dist/device/device-kind.d.ts +36 -0
  46. package/dist/device/device-management.d.ts +3 -0
  47. package/dist/device/device-type.d.ts +27 -10
  48. package/dist/device/hero/hero-fragment.d.ts +2 -0
  49. package/dist/device/hero/hero-layout.d.ts +1 -3
  50. package/dist/device/hero/hero-look.d.ts +18 -12
  51. package/dist/device/hero/hero-scene.d.ts +9 -3
  52. package/dist/device/index.d.ts +2 -1
  53. package/dist/device/power-switch.d.ts +82 -0
  54. package/dist/device/schema-fields.d.ts +10 -1
  55. package/dist/generated/addon-api.d.ts +7 -0
  56. package/dist/generated/cap-input-defaults.d.ts +1 -1
  57. package/dist/generated/collection-array-methods.d.ts +1 -1
  58. package/dist/generated/customize-catalog.d.ts +257 -8
  59. package/dist/generated/method-access-map.d.ts +1 -1
  60. package/dist/generated/method-device-selectors.d.ts +1 -1
  61. package/dist/{implemented-methods-M5aguGon.mjs → implemented-methods-5YMDeE3f.mjs} +1 -1
  62. package/dist/{implemented-methods-8AU92riC.js → implemented-methods-Cj65uy2F.js} +1 -1
  63. package/dist/index.d.ts +7 -4
  64. package/dist/index.js +1275 -409
  65. package/dist/index.mjs +1244 -403
  66. package/dist/node.js +2 -2
  67. package/dist/node.mjs +2 -2
  68. package/dist/{sleep-D_NpiLFP.mjs → sleep-Bn346wCJ.mjs} +46 -1
  69. package/dist/{sleep-vzHEmsrO.js → sleep-LFKpQ2_f.js} +46 -1
  70. package/package.json +1 -1
@@ -20,7 +20,7 @@ export declare const groupActiveCapability: {
20
20
  readonly scope: 'device';
21
21
  readonly deviceNative: true;
22
22
  readonly mode: 'singleton';
23
- readonly deviceTypes: readonly [DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Climate, DeviceType.Thermostat];
23
+ readonly deviceTypes: readonly [DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Climate];
24
24
  readonly methods: {};
25
25
  readonly status: {
26
26
  readonly schema: z.ZodObject<{
@@ -25,7 +25,7 @@ export declare const groupCommandsCapability: {
25
25
  readonly scope: 'device';
26
26
  readonly deviceNative: true;
27
27
  readonly mode: 'singleton';
28
- readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Thermostat, DeviceType.Climate];
28
+ readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Climate];
29
29
  readonly methods: {};
30
30
  readonly status: {
31
31
  readonly schema: z.ZodObject<{
@@ -18,7 +18,7 @@ export declare const groupStatusCapability: {
18
18
  readonly scope: 'device';
19
19
  readonly deviceNative: true;
20
20
  readonly mode: 'singleton';
21
- readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Thermostat, DeviceType.Climate];
21
+ readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Climate];
22
22
  readonly methods: {};
23
23
  readonly status: {
24
24
  readonly schema: z.ZodObject<{
@@ -11,7 +11,7 @@ export declare const heatingValveCapability: {
11
11
  readonly scope: 'device';
12
12
  readonly deviceNative: true;
13
13
  readonly mode: 'singleton';
14
- readonly deviceTypes: readonly [DeviceType.Thermostat];
14
+ readonly deviceTypes: readonly [DeviceType.Climate];
15
15
  readonly methods: {};
16
16
  readonly status: {
17
17
  readonly schema: z.ZodObject<{
@@ -782,8 +782,10 @@ export declare const heroLayoutCapability: {
782
782
  }>;
783
783
  }, z.core.$strip>>;
784
784
  }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
785
+ /** The fixed rows of a kind: the type, refined by the role (D1033 — a heater is a switch). */
785
786
  readonly getLayout: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
786
787
  deviceType: z.ZodString;
788
+ role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
787
789
  }, z.core.$strip>, z.ZodObject<{
788
790
  type: z.ZodString;
789
791
  rows: z.ZodArray<z.ZodEnum<{
@@ -34,6 +34,11 @@ export declare const humidifierCapability: {
34
34
  readonly deviceNative: true;
35
35
  readonly mode: 'singleton';
36
36
  readonly deviceTypes: readonly [DeviceType.Humidifier];
37
+ readonly power: {
38
+ readonly kind: 'field';
39
+ readonly field: 'on';
40
+ readonly set: 'setOn';
41
+ };
37
42
  readonly methods: {
38
43
  readonly setOn: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
39
44
  deviceId: z.ZodNumber;
@@ -19,7 +19,7 @@ export declare const humiditySensorCapability: {
19
19
  readonly scope: 'device';
20
20
  readonly deviceNative: true;
21
21
  readonly mode: 'singleton';
22
- readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Thermostat];
22
+ readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Climate];
23
23
  readonly methods: {};
24
24
  readonly status: {
25
25
  readonly schema: z.ZodObject<{
@@ -36,7 +36,7 @@ export { BrokerGetStateInputSchema, BrokerPublishInputSchema, BrokerRegistryStat
36
36
  export { cameraPipelineConfigCapability, type ICameraPipelineConfigProvider, } from './camera-pipeline-config.cap.js';
37
37
  export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, type PickStreamPreferences, PickStreamPreferencesSchema, type PickStreamRequirements, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
38
38
  export { emitsCollectionSelector, extractNestedAddonId, isArrayOutputSchema, isCollectionArrayMethod, isObjectInput, isVoidInput, kebabToCamel, looseSchema, objectInputDeclaresAddonId, objectInputDeclaresRequiredDeviceId, procedureAuthKey, resolveMethodAuth, } from './cap-router-predicates.js';
39
- export type { CapabilityDefinition, CapabilityEventSchema, CapabilityMethodAuth, CapabilityMethodCaller, CapabilityMethodKind, CapabilityMethodOptions, CapabilityMethodSchema, CapabilityMountHint, CapabilityMountKind, CapabilityStatusItemArray, CapabilityStatusKind, CapabilityStatusSchema, CapCaller, DeviceConfigDerivedFormUi, DeviceConfigSpec, DeviceConfigUiSpec, DeviceConfigWidgetUi, DeviceSettingsContribution, InferDeviceProxyCap, InferEvents, InferName, InferNativeProvider, InferProvider, InferRuntimeState, CapabilityHistory, CapabilityHistoryField, CapabilityHistoryItems, HistoryUnit, ProviderKind, RuntimeStateDurability, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
39
+ export type { CapabilityDefinition, CapabilityEventSchema, CapabilityMethodAuth, CapabilityMethodCaller, CapabilityMethodKind, CapabilityMethodOptions, CapabilityMethodSchema, CapabilityMountHint, CapabilityMountKind, CapabilityStatusItemArray, CapabilityStatusKind, CapabilityStatusSchema, CapCaller, DeviceConfigDerivedFormUi, DeviceConfigSpec, DeviceConfigUiSpec, DeviceConfigWidgetUi, DeviceSettingsContribution, InferDeviceProxyCap, InferEvents, InferName, InferNativeProvider, InferProvider, InferRuntimeState, CapabilityHistory, CapabilityHistoryField, CapabilityPowerHint, PowerHintField, PowerHintMethods, PowerHintMode, CapabilityHistoryItems, HistoryUnit, ProviderKind, RuntimeStateDurability, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
40
40
  export { DEFAULT_RUNTIME_STATE_DURABILITY, HISTORY_DEFAULT_MIN_INTERVAL_MS, HISTORY_UNIT_LABELS, historyItemFieldPath, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, event, expandCapMethods, isDeviceConfigCap, method, optionalMethod, PROVIDER_PIN_FIELD, resolveCapMount, } from './capability-definition.js';
41
41
  export { COMPOSER_RUNNER_ID, type ComposerApplyInput, ComposerApplyInputSchema, type ComposerApplyResult, ComposerApplyResultSchema, type ComposerBlock, ComposerBlockSchema, type ComposerBlockVerdict, ComposerBlockVerdictSchema, type ComposerUnreadableBlock, ComposerUnreadableBlockSchema, composerCapability, type IComposerProvider, type UnreleasedClaim, UnreleasedClaimSchema, } from './composer.cap.js';
42
42
  export { CORE_BLOCK_ADDON_PREFIX, CORE_BLOCKS_ADDON_ID, type CompositionBlockInput, CompositionBlockInputSchema, type CompositionBlockPatch, type CompositionCustomizationRead, CompositionCustomizationReadSchema, type CompositionGetRead, CompositionGetReadSchema, type CompositionListRead, CompositionListReadSchema, type CompositionStateRead, CompositionStateReadSchema, type CompositionView, CompositionViewSchema, type CoreBlock, type CoreBlockCompileInput, CoreBlockCompileInputSchema, type CoreBlockCompileResult, CoreBlockCompileResultSchema, type CoreBlockFiles, CoreBlockFilesSchema, type CoreBlockInput, CoreBlockInputFieldsSchema, CoreBlockInputSchema, type CoreBlockPlacement, CoreBlockPlacementSchema, CoreBlockSchema, type CoreBlockSource, type CoreBlockSourceKind, CoreBlockSourceSchema, type CoreBlockStatus, CoreBlockStatusSchema, coreBlockAddonId, coreBlockComposition, coreBlockIdFromAddonId, coreBlockSourceKind, coreBlocksCapability, DEFAULT_CORE_BLOCK_ENTRY, type ICoreBlocksProvider, normalizeCoreBlockWrite, resolveCoreBlockEntry, resolveCoreBlockFiles, } from './core-blocks.cap.js';
@@ -55,7 +55,7 @@ export { DEVICE_HISTORY_ENERGY_KEY, DEVICE_HISTORY_QUERY_MANY_MAX_ITEMS, DEVICE_
55
55
  export { type ApplianceRunDetail, ApplianceRunDetailSchema, DEVICE_RUNS_MAX_PAGE, type DeviceRun, type DeviceRunDetail, DeviceRunDetailSchema, type DeviceRunEnergyMethod, DeviceRunEnergyMethodSchema, type DeviceRunKind, DeviceRunKindSchema, type DeviceRunOutcome, DeviceRunOutcomeSchema, type DeviceRunPhase, DeviceRunPhaseSchema, DeviceRunSchema, type DeviceRunSource, DeviceRunSourceSchema, type DeviceRunState, DeviceRunStateSchema, type IDeviceRunsProvider, deviceRunsCapability, } from './device-runs.cap.js';
56
56
  export { DEVICE_TRANSITIONS_MAX_PAGE, DEVICE_TRANSITIONS_RECORD_BATCH_MAX, deviceTransitionsCapability, type IDeviceTransitionsProvider, type TransitionRecordResult, TransitionRecordResultSchema, type TransitionRefusalReason, TransitionRefusalReasonSchema, type TransitionsStatus, TransitionsStatusSchema, } from './device-transitions.cap.js';
57
57
  export { type DoNotDisturbStatus, DoNotDisturbStatusSchema, doNotDisturbCapability, type IDoNotDisturbProvider, } from './do-not-disturb.cap.js';
58
- export { type ITimedRunProvider, TIMED_RUN_DEVICE_TYPES, TIMED_RUN_LIMITS, type TimedRunActuator, TimedRunActuatorSchema, type TimedRunLimit, type TimedRunOptions, TimedRunOptionsSchema, type TimedRunQuickRun, TimedRunQuickRunSchema, type TimedRunRefusal, TimedRunRefusalSchema, type TimedRunResult, TimedRunResultSchema, type TimedRunSettingsPatch, TimedRunSettingsPatchSchema, type TimedRunStatus, TimedRunStatusSchema, type TimedRunUnit, TimedRunUnitSchema, timedRunCapability, timedRunLimitOf, timedRunMaxIn, timedRunQuickRun, timedRunRemaining, timedRunSeconds, } from './timed-run.cap.js';
58
+ export { type ITimedRunProvider, TIMED_RUN_DEVICE_TYPES, TIMED_RUN_DEVICE_ROLES, TIMED_RUN_HEATER_LIMIT, TIMED_RUN_PET_FOUNTAIN_LIMIT, type TimedRunActuator, TimedRunActuatorSchema, type TimedRunLimit, type TimedRunOptions, TimedRunOptionsSchema, type TimedRunQuickRun, TimedRunQuickRunSchema, type TimedRunRefusal, TimedRunRefusalSchema, type TimedRunResult, TimedRunResultSchema, type TimedRunSettingsPatch, TimedRunSettingsPatchSchema, type TimedRunStatus, TimedRunStatusSchema, type TimedRunUnit, TimedRunUnitSchema, timedRunCapability, timedRunLimitOf, timedRunMaxIn, timedRunQuickRun, timedRunRemaining, timedRunSeconds, } from './timed-run.cap.js';
59
59
  export { type DeviceCaStatus, DeviceCaStatusSchema, type DeviceCertificateSettings, DeviceCertificateSettingsSchema, deviceCredentialsCapability, type IDeviceCredentialsProvider, } from './device-credentials.cap.js';
60
60
  export { type HttpsLeafInfo, HttpsLeafInfoSchema, type INodeCertificatesProvider, type MeshLeafInfo, MeshLeafInfoSchema, type NodeHttpsState, NodeHttpsStateSchema, nodeCertificatesCapability, } from './node-certificates.cap.js';
61
61
  export { type IKeychainAdminProvider, KEYCHAIN_RESET_CONFIRMATION, type KeychainAdminSecret, KeychainAdminSecretSchema, type KeychainAuditAction, KeychainAuditActionSchema, type KeychainAuditEntry, KeychainAuditEntrySchema, type KeychainKeySource, type KeychainKeySourceKind, KeychainKeySourceKindSchema, KeychainKeySourceSchema, KEYCHAIN_RESET_TRIGGER_ACTOR, type KeychainResetRecord, KeychainResetRecordSchema, type KeychainSecretUsage, KeychainSecretUsageSchema, type KeychainStatus, KeychainStatusSchema, keychainAdminCapability, type SystemHeldSecretName, SystemHeldSecretNameSchema, } from './keychain-admin.cap.js';
@@ -170,7 +170,7 @@ export { type AutomationControlStatus, AutomationControlStatusSchema, automation
170
170
  export { type BatteryStatus, BatteryStatusSchema, batteryCapability, type IBatteryProvider, } from './battery.cap.js';
171
171
  export { type BinaryStatus, BinaryStatusSchema, binaryCapability, type IBinaryProvider, } from './binary.cap.js';
172
172
  export { type BrightnessStatus, BrightnessStatusSchema, brightnessCapability, type IBrightnessProvider, } from './brightness.cap.js';
173
- export { FAN_CAPTURE_FIELDS, FAN_CAPTURE_GROUPS, FAN_PRESETS_MAX, FAN_PRESETS_REFUSALS, FAN_PRESET_STEPS_MAX, type FanCaptureField, FanCaptureFieldSchema, type FanCaptureGroup, FanCaptureGroupSchema, type FanCaptureItem, FanCaptureItemSchema, type FanCaptureOmission, FanCaptureOmissionSchema, type FanPreset, type FanPresetApplyResult, FanPresetApplyResultSchema, type FanPresetCaptureResult, FanPresetCaptureResultSchema, FanPresetSchema, type FanPresetStepResult, FanPresetStepResultSchema, type FanPresetsRefusal, FanPresetsRefusalSchema, type FanPresetsSetResult, FanPresetsSetResultSchema, type IFanPresetsProvider, fanPresetsCapability, } from './fan-presets.cap.js';
173
+ export { FAN_CAPTURE_FIELDS, FAN_PRESETS_MAX, FAN_PRESETS_REFUSALS, type FanCaptureField, FanCaptureFieldSchema, type FanCaptureOmission, FanCaptureOmissionSchema, type FanPreset, type FanPresetApplyResult, FanPresetApplyResultSchema, type FanPresetAxis, FanPresetAxisSchema, type FanPresetCaptureResult, FanPresetCaptureResultSchema, type FanPresetFieldResult, FanPresetFieldResultSchema, FanPresetSchema, type FanPresetState, FanPresetStateSchema, type FanPresetsRefusal, FanPresetsRefusalSchema, type FanPresetsSetResult, FanPresetsSetResultSchema, type IFanPresetsProvider, fanPresetsCapability, } from './fan-presets.cap.js';
174
174
  export { type IRemoteProvider, REMOTE_CONFIG_REFUSALS, REMOTE_MAX_REPEAT, REMOTE_MEDIA_COMMANDS, REMOTE_REFUSAL_REASONS, type RemoteBoundCommand, type RemoteCommandList, RemoteCommandListSchema, RemoteBoundCommandSchema, type RemoteMediaCommand, type RemoteMediaCommandResult, RemoteMediaCommandResultSchema, RemoteMediaCommandSchema, type RemoteRefusalReason, RemoteRefusalReasonSchema, type RemoteSendResult, RemoteSendResultSchema, type RemoteSetConfigResult, RemoteSetConfigResultSchema, remoteCapability, } from './remote.cap.js';
175
175
  export { HERO_ROW_MODELS_MAX, heroLayoutCapability, type HeroLayoutRows, HeroLayoutRowsSchema, type IHeroLayoutProvider, } from './hero-layout.cap.js';
176
176
  export { type ITemplateProvider, TEMPLATE_WRITE_REFUSALS, type TemplateDeleteResult, TemplateDeleteResultSchema, type TemplateRecord, TemplateRecordSchema, type TemplateUser, TemplateUserSchema, type TemplateWriteResult, TemplateWriteResultSchema, templateCapability, } from './template.cap.js';
@@ -200,7 +200,7 @@ export { DOORBELL_RISE_DEBOUNCE_MS, type DoorbellPressEvent, DoorbellPressEventS
200
200
  export { type EnumSensorDateTimeFormat, EnumSensorDateTimeFormatSchema, type EnumSensorStatus, EnumSensorStatusSchema, enumSensorCapability, type IEnumSensorProvider, } from './enum-sensor.cap.js';
201
201
  export { type EventEmitterStatus, EventEmitterStatusSchema, type EventFire, EventFireSchema, eventEmitterCapability, type IEventEmitterProvider, } from './event-emitter.cap.js';
202
202
  export { type FaceCluster, type FaceInfo, type FaceSortDirection, type FaceSortField, faceGalleryCapability, type Identity, type IdentitySampleAudit, type IdentitySampleAuditRow, type IdentitySampleInfo, type IFaceGalleryProvider, type ListRecentFacesInput, type SuggestFaceClustersInput, } from './face-gallery.cap.js';
203
- export { type FanControlStatus, FanControlStatusSchema, type FanDirection, FanDirectionSchema, fanControlCapability, type IFanControlProvider, } from './fan-control.cap.js';
203
+ export { anyAxisOscillating, FAN_OSCILLATION_AXES, FAN_OSCILLATION_AXIS_LIMITS, FAN_OSCILLATION_AXIS_REFUSALS, FAN_OSCILLATION_AXIS_SETTABLE, fanAxisPath, type FanControlStatus, FanControlStatusSchema, type FanDirection, FanDirectionSchema, type FanOscillationAxes, FanOscillationAxesSchema, type FanOscillationAxis, type FanOscillationAxisField, FanOscillationAxisFieldSchema, type FanOscillationAxisLimit, type FanOscillationAxisName, FanOscillationAxisNameSchema, type FanOscillationAxisRefusal, FanOscillationAxisRefusalSchema, type FanOscillationAxisResult, FanOscillationAxisResultSchema, FanOscillationAxisSchema, fanControlCapability, type IFanControlProvider, type SetOscillationAxisInput, SetOscillationAxisInputSchema, } from './fan-control.cap.js';
204
204
  export { type FeatureProbeStatus, FeatureProbeStatusSchema, featureProbeCapability, type IFeatureProbeProvider, } from './feature-probe.cap.js';
205
205
  export { type FloodStatus, FloodStatusSchema, floodCapability, type IFloodProvider, } from './flood.cap.js';
206
206
  export { type GasStatus, GasStatusSchema, gasCapability, type IGasProvider } from './gas.cap.js';
@@ -117,6 +117,13 @@ export declare const mediaPlayerCapability: {
117
117
  readonly deviceNative: true;
118
118
  readonly mode: 'singleton';
119
119
  readonly deviceTypes: readonly [DeviceType.MediaPlayer];
120
+ readonly power: {
121
+ readonly kind: 'methods';
122
+ readonly field: 'state';
123
+ readonly offValues: readonly ["off", "standby"];
124
+ readonly on: 'turnOn';
125
+ readonly off: 'turnOff';
126
+ };
120
127
  readonly methods: {
121
128
  readonly turnOn: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
122
129
  deviceId: z.ZodNumber;
@@ -50,6 +50,11 @@ export declare const petFountainCapability: {
50
50
  readonly deviceNative: true;
51
51
  readonly mode: 'singleton';
52
52
  readonly deviceTypes: readonly [DeviceType.PetFountain];
53
+ readonly power: {
54
+ readonly kind: 'field';
55
+ readonly field: 'pumpRunning';
56
+ readonly set: 'setPump';
57
+ };
53
58
  readonly methods: {
54
59
  /** Start or stop the pump. */
55
60
  readonly setPump: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -31,7 +31,7 @@ export declare const powerMeterCapability: {
31
31
  readonly scope: 'device';
32
32
  readonly deviceNative: true;
33
33
  readonly mode: 'singleton';
34
- readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater];
34
+ readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder];
35
35
  readonly deviceConfig: {
36
36
  readonly ui: {
37
37
  readonly kind: 'widget';
@@ -126,7 +126,7 @@ export declare const powerMeterCapability: {
126
126
  readonly cap: 'power-meter';
127
127
  readonly stateField: string;
128
128
  };
129
- readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Heater | DeviceType.Dryer)[];
129
+ readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
130
130
  readonly apply: 'add';
131
131
  readonly path: string;
132
132
  readonly sources: readonly [{
@@ -152,7 +152,7 @@ export declare const powerMeterCapability: {
152
152
  readonly cap: 'power-meter';
153
153
  readonly stateField: string;
154
154
  };
155
- readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Heater | DeviceType.Dryer)[];
155
+ readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
156
156
  readonly apply: 'add';
157
157
  readonly path: string;
158
158
  readonly sources: readonly [{
@@ -178,7 +178,7 @@ export declare const powerMeterCapability: {
178
178
  readonly cap: 'power-meter';
179
179
  readonly stateField: string;
180
180
  };
181
- readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Heater | DeviceType.Dryer)[];
181
+ readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
182
182
  readonly apply: 'add';
183
183
  readonly path: string;
184
184
  readonly sources: readonly [{
@@ -204,7 +204,7 @@ export declare const powerMeterCapability: {
204
204
  readonly cap: 'power-meter';
205
205
  readonly stateField: string;
206
206
  };
207
- readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Heater | DeviceType.Dryer)[];
207
+ readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
208
208
  readonly apply: 'add';
209
209
  readonly path: string;
210
210
  readonly sources: readonly [{
@@ -32,6 +32,7 @@ export declare const PowerSourceRefusalReasonSchema: z.ZodEnum<{
32
32
  "no-power-source": "no-power-source";
33
33
  "restart-in-progress": "restart-in-progress";
34
34
  "switch-call-failed": "switch-call-failed";
35
+ "switch-is-actuator": "switch-is-actuator";
35
36
  "switch-missing": "switch-missing";
36
37
  "switch-offline": "switch-offline";
37
38
  "switch-unknown": "switch-unknown";
@@ -45,6 +46,7 @@ export declare const PowerSourceActionResultSchema: z.ZodDiscriminatedUnion<[z.Z
45
46
  "no-power-source": "no-power-source";
46
47
  "restart-in-progress": "restart-in-progress";
47
48
  "switch-call-failed": "switch-call-failed";
49
+ "switch-is-actuator": "switch-is-actuator";
48
50
  "switch-missing": "switch-missing";
49
51
  "switch-offline": "switch-offline";
50
52
  "switch-unknown": "switch-unknown";
@@ -98,6 +100,7 @@ export declare const powerSourceCapability: {
98
100
  "no-power-source": "no-power-source";
99
101
  "restart-in-progress": "restart-in-progress";
100
102
  "switch-call-failed": "switch-call-failed";
103
+ "switch-is-actuator": "switch-is-actuator";
101
104
  "switch-missing": "switch-missing";
102
105
  "switch-offline": "switch-offline";
103
106
  "switch-unknown": "switch-unknown";
@@ -116,6 +119,7 @@ export declare const powerSourceCapability: {
116
119
  "no-power-source": "no-power-source";
117
120
  "restart-in-progress": "restart-in-progress";
118
121
  "switch-call-failed": "switch-call-failed";
122
+ "switch-is-actuator": "switch-is-actuator";
119
123
  "switch-missing": "switch-missing";
120
124
  "switch-offline": "switch-offline";
121
125
  "switch-unknown": "switch-unknown";
@@ -134,6 +138,7 @@ export declare const powerSourceCapability: {
134
138
  "no-power-source": "no-power-source";
135
139
  "restart-in-progress": "restart-in-progress";
136
140
  "switch-call-failed": "switch-call-failed";
141
+ "switch-is-actuator": "switch-is-actuator";
137
142
  "switch-missing": "switch-missing";
138
143
  "switch-offline": "switch-offline";
139
144
  "switch-unknown": "switch-unknown";
@@ -23,7 +23,7 @@ export type RunningStateStatus = z.infer<typeof RunningStateStatusSchema>;
23
23
  * The cap itself stays on every type — a camera can still report running
24
24
  * natively; it just has no card.
25
25
  */
26
- export declare const RUNNING_CUSTOMIZE_DEVICE_TYPES: readonly [DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder, DeviceType.Heater];
26
+ export declare const RUNNING_CUSTOMIZE_DEVICE_TYPES: readonly [DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.PetFeeder];
27
27
  export declare const runningStateCapability: {
28
28
  readonly name: 'running-state';
29
29
  readonly scope: 'device';
@@ -92,7 +92,7 @@ export declare const runningStateCapability: {
92
92
  readonly cap: 'running-state';
93
93
  readonly stateField: 'running';
94
94
  };
95
- readonly deviceTypes: readonly [DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder, DeviceType.Heater];
95
+ readonly deviceTypes: readonly [DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.PetFeeder];
96
96
  readonly apply: 'add';
97
97
  readonly path: 'running';
98
98
  readonly sources: readonly [{
@@ -18,7 +18,7 @@ export declare const switchCapability: {
18
18
  readonly scope: 'device';
19
19
  readonly deviceNative: true;
20
20
  readonly mode: 'singleton';
21
- readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Heater];
21
+ readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan];
22
22
  readonly methods: {
23
23
  readonly setState: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
24
24
  deviceId: z.ZodNumber;
@@ -23,7 +23,7 @@ export declare const temperatureSensorCapability: {
23
23
  readonly scope: 'device';
24
24
  readonly deviceNative: true;
25
25
  readonly mode: 'singleton';
26
- readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Thermostat];
26
+ readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Climate];
27
27
  readonly methods: {};
28
28
  readonly status: {
29
29
  readonly schema: z.ZodObject<{
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { DeviceType } from '../device/device-type.js';
2
+ import { DeviceRole, DeviceType } from '../device/device-type.js';
3
3
  import { type InferProvider } from './capability-definition.js';
4
4
  /**
5
5
  * timed-run - run a device for a chosen time, then stop it (D993).
@@ -16,7 +16,7 @@ import { type InferProvider } from './capability-definition.js';
16
16
  * retried in a loop - D49); a future one is re-armed.
17
17
  *
18
18
  * What a device may be run for, and for how long at most, is per device type
19
- * ({@link TIMED_RUN_LIMITS}): the maximum is a safety bound, not a preference,
19
+ * and role ({@link timedRunLimitOf}): the maximum is a safety bound, not a preference,
20
20
  * so a request above it is REFUSED with a typed reason, never clamped.
21
21
  */
22
22
  export declare const TimedRunUnitSchema: z.ZodEnum<{
@@ -39,10 +39,23 @@ export interface TimedRunLimit {
39
39
  /** The one-tap run, in `unit`, until the operator sets this device's own. */
40
40
  readonly quickRunDefault: number;
41
41
  }
42
- /** The longest run, per device type. Only these types are offered `timed-run`. */
43
- export declare const TIMED_RUN_LIMITS: Readonly<Partial<Record<DeviceType, TimedRunLimit>>>;
42
+ /** A plug-in heater (switch + `switch-heater`): up to 3 h, in minutes. */
43
+ export declare const TIMED_RUN_HEATER_LIMIT: TimedRunLimit;
44
+ /** A pet fountain's pump: up to 5 min, in seconds. */
45
+ export declare const TIMED_RUN_PET_FOUNTAIN_LIMIT: TimedRunLimit;
46
+ /**
47
+ * The device types `timed-run` may be offered on. A `switch` is narrowed by
48
+ * role ({@link TIMED_RUN_DEVICE_ROLES}): only a plug-in heater runs on a timer.
49
+ */
44
50
  export declare const TIMED_RUN_DEVICE_TYPES: readonly DeviceType[];
45
- export declare function timedRunLimitOf(deviceType: DeviceType): TimedRunLimit | null;
51
+ /** The roles that make a device of these types timed-run-able (D1033). */
52
+ export declare const TIMED_RUN_DEVICE_ROLES: Readonly<Partial<Record<DeviceType, readonly DeviceRole[]>>>;
53
+ /**
54
+ * The longest run of a device, by its type AND role (D1033): a `switch` is a
55
+ * heater only with role `switch-heater`, a pet fountain always is what it is.
56
+ * `null` - the device is not offered `timed-run`.
57
+ */
58
+ export declare function timedRunLimitOf(deviceType: string, role: string | null | undefined): TimedRunLimit | null;
46
59
  /**
47
60
  * Whole units left on an armed run. Minutes and seconds both ceil, and a run
48
61
  * that has not expired yet never reads as zero.
@@ -122,6 +135,7 @@ export declare const timedRunCapability: {
122
135
  readonly kind: 'wrapper';
123
136
  readonly defaultActive: true;
124
137
  readonly deviceTypes: readonly DeviceType[];
138
+ readonly deviceRoles: Readonly<Partial<Record<DeviceType, readonly DeviceRole[]>>>;
125
139
  readonly deviceConfig: {
126
140
  readonly ui: {
127
141
  readonly kind: 'derived-form';
@@ -33,6 +33,13 @@ export declare const waterHeaterCapability: {
33
33
  readonly deviceNative: true;
34
34
  readonly mode: 'singleton';
35
35
  readonly deviceTypes: readonly [DeviceType.WaterHeater];
36
+ readonly power: {
37
+ readonly kind: 'mode';
38
+ readonly field: 'operationMode';
39
+ readonly offValue: 'off';
40
+ readonly set: 'setOperationMode';
41
+ readonly lastField: 'lastActiveMode';
42
+ };
36
43
  readonly methods: {
37
44
  readonly setTargetTemp: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
38
45
  deviceId: z.ZodNumber;
package/dist/client.js CHANGED
@@ -1108,12 +1108,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
1108
1108
  DeviceType["Siren"] = "siren";
1109
1109
  DeviceType["Switch"] = "switch";
1110
1110
  DeviceType["Sensor"] = "sensor";
1111
- DeviceType["Thermostat"] = "thermostat";
1112
- /** Air-conditioner / heat-pump climate device (HVAC) — shares the
1113
- * `climate-control` cap surface with `Thermostat` but renders a
1114
- * dedicated AC-appropriate control UI (mode chips, fan speed,
1115
- * independent vertical/horizontal swing). Sources: native Gree, and
1116
- * reusable by other AC integrations. */
1111
+ /** Every climate device: an air conditioner, a room thermostat, a radiator
1112
+ * valve, a floor-heating zone, a heat-pump circuit. They share one set of
1113
+ * controls (`climate-control`), so they are one type; WHICH kind of climate
1114
+ * device it is is its {@link DeviceRole} (`climate-*`), which the UI and the
1115
+ * exports branch on. The retired `thermostat` type is read as this one
1116
+ * (`canonicalStoredDeviceType`). */
1117
1117
  DeviceType["Climate"] = "climate";
1118
1118
  DeviceType["Button"] = "button";
1119
1119
  /** Generic stateless event emitter — carries a device's EXACT declared
@@ -1204,10 +1204,6 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
1204
1204
  /** Washing machine. A plug-built one is running while its power stays
1205
1205
  * above a threshold. No program cap — that surface is the dishwasher's. */
1206
1206
  DeviceType["Washer"] = "washer";
1207
- /** A dumb plug-in stove or heater: a switch (and, with a meter, a power
1208
- * reading) that only runs while the plug is on. Built from a smart plug;
1209
- * the `timed-run` cap switches it off again after a chosen time. */
1210
- DeviceType["Heater"] = "heater";
1211
1207
  /** Tumble dryer. Same plug-built running surface as {@link Washer}. */
1212
1208
  DeviceType["Dryer"] = "dryer";
1213
1209
  /** The physical bridge box of a vendor ecosystem (Velux KLF-200, and later
@@ -26656,7 +26652,6 @@ function applyPrimaryChildRule(rule, children) {
26656
26652
  var CONTAINER_CHILD_PRIORITY = [
26657
26653
  "media-player",
26658
26654
  "alarm-panel",
26659
- "thermostat",
26660
26655
  "climate",
26661
26656
  "humidifier",
26662
26657
  "water-heater",
@@ -27214,6 +27209,7 @@ function createDeviceProxy(api, binding, opts) {
27214
27209
  setPreset: (input) => dispatch("fan-control", "fanControl", "setPreset", "mutation", input),
27215
27210
  setDirection: (input) => dispatch("fan-control", "fanControl", "setDirection", "mutation", input),
27216
27211
  setOscillating: (input) => dispatch("fan-control", "fanControl", "setOscillating", "mutation", input),
27212
+ setOscillationAxis: (input) => dispatch("fan-control", "fanControl", "setOscillationAxis", "mutation", input),
27217
27213
  getStatus: (input) => dispatch("fan-control", "fanControl", "getStatus", "query", input)
27218
27214
  };
27219
27215
  const featureProbeInterface = { getStatus: (input) => dispatch("feature-probe", "featureProbe", "getStatus", "query", input) };
package/dist/client.mjs CHANGED
@@ -1107,12 +1107,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
1107
1107
  DeviceType["Siren"] = "siren";
1108
1108
  DeviceType["Switch"] = "switch";
1109
1109
  DeviceType["Sensor"] = "sensor";
1110
- DeviceType["Thermostat"] = "thermostat";
1111
- /** Air-conditioner / heat-pump climate device (HVAC) — shares the
1112
- * `climate-control` cap surface with `Thermostat` but renders a
1113
- * dedicated AC-appropriate control UI (mode chips, fan speed,
1114
- * independent vertical/horizontal swing). Sources: native Gree, and
1115
- * reusable by other AC integrations. */
1110
+ /** Every climate device: an air conditioner, a room thermostat, a radiator
1111
+ * valve, a floor-heating zone, a heat-pump circuit. They share one set of
1112
+ * controls (`climate-control`), so they are one type; WHICH kind of climate
1113
+ * device it is is its {@link DeviceRole} (`climate-*`), which the UI and the
1114
+ * exports branch on. The retired `thermostat` type is read as this one
1115
+ * (`canonicalStoredDeviceType`). */
1116
1116
  DeviceType["Climate"] = "climate";
1117
1117
  DeviceType["Button"] = "button";
1118
1118
  /** Generic stateless event emitter — carries a device's EXACT declared
@@ -1203,10 +1203,6 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
1203
1203
  /** Washing machine. A plug-built one is running while its power stays
1204
1204
  * above a threshold. No program cap — that surface is the dishwasher's. */
1205
1205
  DeviceType["Washer"] = "washer";
1206
- /** A dumb plug-in stove or heater: a switch (and, with a meter, a power
1207
- * reading) that only runs while the plug is on. Built from a smart plug;
1208
- * the `timed-run` cap switches it off again after a chosen time. */
1209
- DeviceType["Heater"] = "heater";
1210
1206
  /** Tumble dryer. Same plug-built running surface as {@link Washer}. */
1211
1207
  DeviceType["Dryer"] = "dryer";
1212
1208
  /** The physical bridge box of a vendor ecosystem (Velux KLF-200, and later
@@ -26655,7 +26651,6 @@ function applyPrimaryChildRule(rule, children) {
26655
26651
  var CONTAINER_CHILD_PRIORITY = [
26656
26652
  "media-player",
26657
26653
  "alarm-panel",
26658
- "thermostat",
26659
26654
  "climate",
26660
26655
  "humidifier",
26661
26656
  "water-heater",
@@ -27213,6 +27208,7 @@ function createDeviceProxy(api, binding, opts) {
27213
27208
  setPreset: (input) => dispatch("fan-control", "fanControl", "setPreset", "mutation", input),
27214
27209
  setDirection: (input) => dispatch("fan-control", "fanControl", "setDirection", "mutation", input),
27215
27210
  setOscillating: (input) => dispatch("fan-control", "fanControl", "setOscillating", "mutation", input),
27211
+ setOscillationAxis: (input) => dispatch("fan-control", "fanControl", "setOscillationAxis", "mutation", input),
27216
27212
  getStatus: (input) => dispatch("fan-control", "fanControl", "getStatus", "query", input)
27217
27213
  };
27218
27214
  const featureProbeInterface = { getStatus: (input) => dispatch("feature-probe", "featureProbe", "getStatus", "query", input) };
@@ -19,12 +19,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
19
19
  DeviceType["Siren"] = "siren";
20
20
  DeviceType["Switch"] = "switch";
21
21
  DeviceType["Sensor"] = "sensor";
22
- DeviceType["Thermostat"] = "thermostat";
23
- /** Air-conditioner / heat-pump climate device (HVAC) — shares the
24
- * `climate-control` cap surface with `Thermostat` but renders a
25
- * dedicated AC-appropriate control UI (mode chips, fan speed,
26
- * independent vertical/horizontal swing). Sources: native Gree, and
27
- * reusable by other AC integrations. */
22
+ /** Every climate device: an air conditioner, a room thermostat, a radiator
23
+ * valve, a floor-heating zone, a heat-pump circuit. They share one set of
24
+ * controls (`climate-control`), so they are one type; WHICH kind of climate
25
+ * device it is is its {@link DeviceRole} (`climate-*`), which the UI and the
26
+ * exports branch on. The retired `thermostat` type is read as this one
27
+ * (`canonicalStoredDeviceType`). */
28
28
  DeviceType["Climate"] = "climate";
29
29
  DeviceType["Button"] = "button";
30
30
  /** Generic stateless event emitter — carries a device's EXACT declared
@@ -115,10 +115,6 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
115
115
  /** Washing machine. A plug-built one is running while its power stays
116
116
  * above a threshold. No program cap — that surface is the dishwasher's. */
117
117
  DeviceType["Washer"] = "washer";
118
- /** A dumb plug-in stove or heater: a switch (and, with a meter, a power
119
- * reading) that only runs while the plug is on. Built from a smart plug;
120
- * the `timed-run` cap switches it off again after a chosen time. */
121
- DeviceType["Heater"] = "heater";
122
118
  /** Tumble dryer. Same plug-built running surface as {@link Washer}. */
123
119
  DeviceType["Dryer"] = "dryer";
124
120
  /** The physical bridge box of a vendor ecosystem (Velux KLF-200, and later
@@ -353,6 +349,27 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
353
349
  /** A smart plug: a `switch` whose source says it is an outlet (HA
354
350
  * `device_class: outlet`). The Alexa export shows it as a SMARTPLUG. */
355
351
  DeviceRole["Outlet"] = "outlet";
352
+ /** A dumb plug-in stove or heater behind a switch: it runs only while the
353
+ * switch is on. Offered `timed-run`, which switches it off again after a
354
+ * chosen time. */
355
+ DeviceRole["SwitchHeater"] = "switch-heater";
356
+ /** A plain fan behind a switch (a smart plug powering it): drawn as a fan,
357
+ * with the switch's on/off only. Speed or oscillation appear only when the
358
+ * device also has a fan cap (D1033). */
359
+ DeviceRole["SwitchFan"] = "switch-fan";
360
+ /** Air conditioner / split unit: cooling, fan speed, louvres. */
361
+ DeviceRole["ClimateAc"] = "climate-ac";
362
+ /** Room thermostat: a setpoint and a room temperature. The default. */
363
+ DeviceRole["ClimateThermostat"] = "climate-thermostat";
364
+ /** Floor-heating zone actuator. */
365
+ DeviceRole["ClimateFloor"] = "climate-floor";
366
+ /** Radiator valve (thermostatic radiator head). */
367
+ DeviceRole["ClimateRadiator"] = "climate-radiator";
368
+ /** A heater with its own thermostat (stove, convector). */
369
+ DeviceRole["ClimateHeater"] = "climate-heater";
370
+ /** One heating/cooling circuit of a heat pump: a water loop with comfort /
371
+ * eco setpoints and a heat/cool mode, no room sensor. */
372
+ DeviceRole["ClimateHeatPumpCircuit"] = "climate-heat-pump-circuit";
356
373
  /** Generic motion / occupancy / moving event source. Distinct from
357
374
  * the camera accessory PirSensor role: that one is a camera child;
358
375
  * this is a standalone HA / 3rd-party motion sensor. */
@@ -19,12 +19,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
19
19
  DeviceType["Siren"] = "siren";
20
20
  DeviceType["Switch"] = "switch";
21
21
  DeviceType["Sensor"] = "sensor";
22
- DeviceType["Thermostat"] = "thermostat";
23
- /** Air-conditioner / heat-pump climate device (HVAC) — shares the
24
- * `climate-control` cap surface with `Thermostat` but renders a
25
- * dedicated AC-appropriate control UI (mode chips, fan speed,
26
- * independent vertical/horizontal swing). Sources: native Gree, and
27
- * reusable by other AC integrations. */
22
+ /** Every climate device: an air conditioner, a room thermostat, a radiator
23
+ * valve, a floor-heating zone, a heat-pump circuit. They share one set of
24
+ * controls (`climate-control`), so they are one type; WHICH kind of climate
25
+ * device it is is its {@link DeviceRole} (`climate-*`), which the UI and the
26
+ * exports branch on. The retired `thermostat` type is read as this one
27
+ * (`canonicalStoredDeviceType`). */
28
28
  DeviceType["Climate"] = "climate";
29
29
  DeviceType["Button"] = "button";
30
30
  /** Generic stateless event emitter — carries a device's EXACT declared
@@ -115,10 +115,6 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
115
115
  /** Washing machine. A plug-built one is running while its power stays
116
116
  * above a threshold. No program cap — that surface is the dishwasher's. */
117
117
  DeviceType["Washer"] = "washer";
118
- /** A dumb plug-in stove or heater: a switch (and, with a meter, a power
119
- * reading) that only runs while the plug is on. Built from a smart plug;
120
- * the `timed-run` cap switches it off again after a chosen time. */
121
- DeviceType["Heater"] = "heater";
122
118
  /** Tumble dryer. Same plug-built running surface as {@link Washer}. */
123
119
  DeviceType["Dryer"] = "dryer";
124
120
  /** The physical bridge box of a vendor ecosystem (Velux KLF-200, and later
@@ -353,6 +349,27 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
353
349
  /** A smart plug: a `switch` whose source says it is an outlet (HA
354
350
  * `device_class: outlet`). The Alexa export shows it as a SMARTPLUG. */
355
351
  DeviceRole["Outlet"] = "outlet";
352
+ /** A dumb plug-in stove or heater behind a switch: it runs only while the
353
+ * switch is on. Offered `timed-run`, which switches it off again after a
354
+ * chosen time. */
355
+ DeviceRole["SwitchHeater"] = "switch-heater";
356
+ /** A plain fan behind a switch (a smart plug powering it): drawn as a fan,
357
+ * with the switch's on/off only. Speed or oscillation appear only when the
358
+ * device also has a fan cap (D1033). */
359
+ DeviceRole["SwitchFan"] = "switch-fan";
360
+ /** Air conditioner / split unit: cooling, fan speed, louvres. */
361
+ DeviceRole["ClimateAc"] = "climate-ac";
362
+ /** Room thermostat: a setpoint and a room temperature. The default. */
363
+ DeviceRole["ClimateThermostat"] = "climate-thermostat";
364
+ /** Floor-heating zone actuator. */
365
+ DeviceRole["ClimateFloor"] = "climate-floor";
366
+ /** Radiator valve (thermostatic radiator head). */
367
+ DeviceRole["ClimateRadiator"] = "climate-radiator";
368
+ /** A heater with its own thermostat (stove, convector). */
369
+ DeviceRole["ClimateHeater"] = "climate-heater";
370
+ /** One heating/cooling circuit of a heat pump: a water loop with comfort /
371
+ * eco setpoints and a heat/cool mode, no room sensor. */
372
+ DeviceRole["ClimateHeatPumpCircuit"] = "climate-heat-pump-circuit";
356
373
  /** Generic motion / occupancy / moving event source. Distinct from
357
374
  * the camera accessory PirSensor role: that one is a camera child;
358
375
  * this is a standalone HA / 3rd-party motion sensor. */
@@ -24,10 +24,12 @@ export declare const CompositionProblemCodeSchema: z.ZodEnum<{
24
24
  "not-composable": "not-composable";
25
25
  "not-item-array": "not-item-array";
26
26
  "not-replaceable": "not-replaceable";
27
+ "power-source-is-actuator": "power-source-is-actuator";
27
28
  "reserved-variant": "reserved-variant";
28
29
  retention: "retention";
29
30
  "source-capability-missing": "source-capability-missing";
30
31
  "source-field-unknown": "source-field-unknown";
32
+ "source-kind-mismatch": "source-kind-mismatch";
31
33
  "source-missing": "source-missing";
32
34
  "source-unreadable": "source-unreadable";
33
35
  "target-missing": "target-missing";
@@ -60,10 +62,12 @@ export declare const CompositionProblemSchema: z.ZodObject<{
60
62
  "not-composable": "not-composable";
61
63
  "not-item-array": "not-item-array";
62
64
  "not-replaceable": "not-replaceable";
65
+ "power-source-is-actuator": "power-source-is-actuator";
63
66
  "reserved-variant": "reserved-variant";
64
67
  retention: "retention";
65
68
  "source-capability-missing": "source-capability-missing";
66
69
  "source-field-unknown": "source-field-unknown";
70
+ "source-kind-mismatch": "source-kind-mismatch";
67
71
  "source-missing": "source-missing";
68
72
  "source-unreadable": "source-unreadable";
69
73
  "target-missing": "target-missing";
@@ -286,10 +290,12 @@ export declare const CompositionValidationSchema: z.ZodObject<{
286
290
  "not-composable": "not-composable";
287
291
  "not-item-array": "not-item-array";
288
292
  "not-replaceable": "not-replaceable";
293
+ "power-source-is-actuator": "power-source-is-actuator";
289
294
  "reserved-variant": "reserved-variant";
290
295
  retention: "retention";
291
296
  "source-capability-missing": "source-capability-missing";
292
297
  "source-field-unknown": "source-field-unknown";
298
+ "source-kind-mismatch": "source-kind-mismatch";
293
299
  "source-missing": "source-missing";
294
300
  "source-unreadable": "source-unreadable";
295
301
  "target-missing": "target-missing";