@matter/node 0.16.0-alpha.0-20251022-5a69ce65a → 0.16.0-alpha.0-20251027-17770fb28

package/src/behaviors/window-covering/WindowCoveringInterface.ts

@@ -96,6 +96,9 @@ export namespace WindowCoveringInterface {
 
     export interface Lift {
         /**
+         * This command is used to set the target lift position of the window covering to the percentage value specified
+         * in the command.
+         *
          * Upon receipt of this command, the server will adjust the window covering to the lift/slide percentage
          * specified in the payload of this command.
          *
@@ -119,6 +122,9 @@ export namespace WindowCoveringInterface {
 
     export interface Tilt {
         /**
+         * This command is used to set the target tilt position of the window covering to the percentage value specified
+         * in the command.
+         *
          * Upon receipt of this command, the server will adjust the window covering to the tilt percentage specified in
          * the payload of this command.
          *
@@ -142,6 +148,9 @@ export namespace WindowCoveringInterface {
 
     export interface LiftAndPositionAwareLift {
         /**
+         * This command is used to set the target lift position of the window covering to the percentage value specified
+         * in the command.
+         *
          * Upon receipt of this command, the server will adjust the window covering to the lift/slide percentage
          * specified in the payload of this command.
          *
@@ -165,6 +174,9 @@ export namespace WindowCoveringInterface {
 
     export interface TiltAndPositionAwareTilt {
         /**
+         * This command is used to set the target tilt position of the window covering to the percentage value specified
+         * in the command.
+         *
          * Upon receipt of this command, the server will adjust the window covering to the tilt percentage specified in
          * the payload of this command.
          *
@@ -188,6 +200,9 @@ export namespace WindowCoveringInterface {
 
     export interface LiftAndAbsolutePosition {
         /**
+         * This command is used to set the target lift position of the window covering to the value specified in the
+         * command.
+         *
          * @see {@link MatterSpecification.v141.Cluster} § 5.3.7.4
          */
         goToLiftValue(request: WindowCovering.GoToLiftValueRequest): MaybePromise;
@@ -195,6 +210,9 @@ export namespace WindowCoveringInterface {
 
     export interface TiltAndAbsolutePosition {
         /**
+         * This command is used to set the target tilt position of the window covering to the value specified in the
+         * command.
+         *
          * @see {@link MatterSpecification.v141.Cluster} § 5.3.7.6
          */
         goToTiltValue(request: WindowCovering.GoToTiltValueRequest): MaybePromise;

package/src/devices/basic-video-player.ts

@@ -34,8 +34,8 @@ import { Identity } from "#general";
  * For example, a Basic Video Player can be a traditional TV device a physical media playback device such as a DVD
  * Player, or a device that provides input to another device like a TV or computer monitor.
  *
- * Please see Video Player Architecture for additional Basic Video Player requirements relating to Video Player device
- * endpoint composition, commissioning, feature representation in clusters, and UI context.
+ * See Section 10.1, “Video Player Architecture” for additional Basic Video Player requirements relating to Video Player
+ * device endpoint composition, commissioning, feature representation in clusters, and UI context.
  *
  * @see {@link MatterSpecification.v141.Device} § 10.2
  */

package/src/devices/casting-video-player.ts

@@ -38,8 +38,8 @@ import { Identity } from "#general";
  * For example, a Casting Video Player can be a smart TV device, a TV Set Top Box, or a content streaming device that
  * provides input to another device like a TV or computer monitor.
  *
- * Please see Video Player Architecture for additional Casting Video Player requirements relating to Video Player device
- * endpoint composition, commissioning, feature representation in clusters, and UI context.
+ * See Section 10.1, “Video Player Architecture” for additional Casting Video Player requirements relating to Video
+ * Player device endpoint composition, commissioning, feature representation in clusters, and UI context.
  *
  * @see {@link MatterSpecification.v141.Device} § 10.3
  */

package/src/devices/color-temperature-light.ts

@@ -8,12 +8,12 @@
 
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
-import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
-import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
-import { ColorControlServer as BaseColorControlServer } from "../behaviors/color-control/ColorControlServer.js";
 import {
     ScenesManagementServer as BaseScenesManagementServer
 } from "../behaviors/scenes-management/ScenesManagementServer.js";
+import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
+import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
+import { ColorControlServer as BaseColorControlServer } from "../behaviors/color-control/ColorControlServer.js";
 import {
     OccupancySensingBehavior as BaseOccupancySensingBehavior
 } from "../behaviors/occupancy-sensing/OccupancySensingBehavior.js";
@@ -45,6 +45,14 @@ export namespace ColorTemperatureLightRequirements {
      */
     export const GroupsServer = BaseGroupsServer;
 
+    /**
+     * The ScenesManagement cluster is required by the Matter specification.
+     *
+     * This version of {@link ScenesManagementServer} is specialized per the specification.
+     */
+    export const ScenesManagementServer = BaseScenesManagementServer
+        .alter({ commands: { copyScene: { optional: false } } });
+
     /**
      * The OnOff cluster is required by the Matter specification.
      *
@@ -76,13 +84,6 @@ export namespace ColorTemperatureLightRequirements {
         .with("ColorTemperature")
         .alter({ attributes: { remainingTime: { optional: false } } });
 
-    /**
-     * The ScenesManagement cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ScenesManagementServer} for convenience.
-     */
-    export const ScenesManagementServer = BaseScenesManagementServer;
-
     /**
      * The OccupancySensing cluster is optional per the Matter specification.
      *
@@ -97,12 +98,11 @@ export namespace ColorTemperatureLightRequirements {
         mandatory: {
             Identify: IdentifyServer,
             Groups: GroupsServer,
+            ScenesManagement: ScenesManagementServer,
             OnOff: OnOffServer,
             LevelControl: LevelControlServer,
             ColorControl: ColorControlServer
-        },
-
-        optional: { ScenesManagement: ScenesManagementServer }
+        }
     };
 
     /**
@@ -120,6 +120,7 @@ export const ColorTemperatureLightDeviceDefinition = MutableEndpoint({
     behaviors: SupportedBehaviors(
         ColorTemperatureLightRequirements.server.mandatory.Identify,
         ColorTemperatureLightRequirements.server.mandatory.Groups,
+        ColorTemperatureLightRequirements.server.mandatory.ScenesManagement,
         ColorTemperatureLightRequirements.server.mandatory.OnOff,
         ColorTemperatureLightRequirements.server.mandatory.LevelControl,
         ColorTemperatureLightRequirements.server.mandatory.ColorControl

package/src/devices/control-bridge.ts

@@ -9,12 +9,12 @@
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { IdentifyBehavior as BaseIdentifyBehavior } from "../behaviors/identify/IdentifyBehavior.js";
 import { GroupsBehavior as BaseGroupsBehavior } from "../behaviors/groups/GroupsBehavior.js";
-import { OnOffBehavior as BaseOnOffBehavior } from "../behaviors/on-off/OnOffBehavior.js";
-import { LevelControlBehavior as BaseLevelControlBehavior } from "../behaviors/level-control/LevelControlBehavior.js";
-import { ColorControlBehavior as BaseColorControlBehavior } from "../behaviors/color-control/ColorControlBehavior.js";
 import {
     ScenesManagementBehavior as BaseScenesManagementBehavior
 } from "../behaviors/scenes-management/ScenesManagementBehavior.js";
+import { OnOffBehavior as BaseOnOffBehavior } from "../behaviors/on-off/OnOffBehavior.js";
+import { LevelControlBehavior as BaseLevelControlBehavior } from "../behaviors/level-control/LevelControlBehavior.js";
+import { ColorControlBehavior as BaseColorControlBehavior } from "../behaviors/color-control/ColorControlBehavior.js";
 import {
     IlluminanceMeasurementBehavior as BaseIlluminanceMeasurementBehavior
 } from "../behaviors/illuminance-measurement/IlluminanceMeasurementBehavior.js";
@@ -56,6 +56,13 @@ export namespace ControlBridgeRequirements {
      */
     export const GroupsBehavior = BaseGroupsBehavior;
 
+    /**
+     * The ScenesManagement cluster is required by the Matter specification.
+     *
+     * We provide this alias to the default implementation {@link ScenesManagementBehavior} for convenience.
+     */
+    export const ScenesManagementBehavior = BaseScenesManagementBehavior;
+
     /**
      * The OnOff cluster is required by the Matter specification.
      *
@@ -77,13 +84,6 @@ export namespace ControlBridgeRequirements {
      */
     export const ColorControlBehavior = BaseColorControlBehavior;
 
-    /**
-     * The ScenesManagement cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ScenesManagementBehavior} for convenience.
-     */
-    export const ScenesManagementBehavior = BaseScenesManagementBehavior;
-
     /**
      * The IlluminanceMeasurement cluster is optional per the Matter specification.
      *
@@ -110,13 +110,13 @@ export namespace ControlBridgeRequirements {
         mandatory: {
             Identify: IdentifyBehavior,
             Groups: GroupsBehavior,
+            ScenesManagement: ScenesManagementBehavior,
             OnOff: OnOffBehavior,
             LevelControl: LevelControlBehavior,
             ColorControl: ColorControlBehavior
         },
 
         optional: {
-            ScenesManagement: ScenesManagementBehavior,
             IlluminanceMeasurement: IlluminanceMeasurementBehavior,
             OccupancySensing: OccupancySensingBehavior
         }

package/src/devices/cook-surface.ts

@@ -29,9 +29,9 @@ export namespace CookSurfaceRequirements {
     /**
      * The TemperatureControl cluster is optional per the Matter specification.
      *
-     * We provide this alias to the default implementation {@link TemperatureControlServer} for convenience.
+     * This version of {@link TemperatureControlServer} is specialized per the specification.
      */
-    export const TemperatureControlServer = BaseTemperatureControlServer;
+    export const TemperatureControlServer = BaseTemperatureControlServer.with("TemperatureLevel");
 
     /**
      * The TemperatureMeasurement cluster is optional per the Matter specification.
@@ -63,7 +63,7 @@ export namespace CookSurfaceRequirements {
 export const CookSurfaceDeviceDefinition = MutableEndpoint({
     name: "CookSurface",
     deviceType: 0x77,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: CookSurfaceRequirements,
     behaviors: SupportedBehaviors()
 });

package/src/devices/dimmable-light.ts

@@ -8,11 +8,11 @@
 
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
-import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
-import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
 import {
     ScenesManagementServer as BaseScenesManagementServer
 } from "../behaviors/scenes-management/ScenesManagementServer.js";
+import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
+import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
 import {
     OccupancySensingBehavior as BaseOccupancySensingBehavior
 } from "../behaviors/occupancy-sensing/OccupancySensingBehavior.js";
@@ -44,6 +44,14 @@ export namespace DimmableLightRequirements {
      */
     export const GroupsServer = BaseGroupsServer;
 
+    /**
+     * The ScenesManagement cluster is required by the Matter specification.
+     *
+     * This version of {@link ScenesManagementServer} is specialized per the specification.
+     */
+    export const ScenesManagementServer = BaseScenesManagementServer
+        .alter({ commands: { copyScene: { optional: false } } });
+
     /**
      * The OnOff cluster is required by the Matter specification.
      *
@@ -66,13 +74,6 @@ export namespace DimmableLightRequirements {
             }
         });
 
-    /**
-     * The ScenesManagement cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ScenesManagementServer} for convenience.
-     */
-    export const ScenesManagementServer = BaseScenesManagementServer;
-
     /**
      * The OccupancySensing cluster is optional per the Matter specification.
      *
@@ -87,11 +88,10 @@ export namespace DimmableLightRequirements {
         mandatory: {
             Identify: IdentifyServer,
             Groups: GroupsServer,
+            ScenesManagement: ScenesManagementServer,
             OnOff: OnOffServer,
             LevelControl: LevelControlServer
-        },
-
-        optional: { ScenesManagement: ScenesManagementServer }
+        }
     };
 
     /**
@@ -109,6 +109,7 @@ export const DimmableLightDeviceDefinition = MutableEndpoint({
     behaviors: SupportedBehaviors(
         DimmableLightRequirements.server.mandatory.Identify,
         DimmableLightRequirements.server.mandatory.Groups,
+        DimmableLightRequirements.server.mandatory.ScenesManagement,
         DimmableLightRequirements.server.mandatory.OnOff,
         DimmableLightRequirements.server.mandatory.LevelControl
     )

package/src/devices/dimmable-plug-in-unit.ts

@@ -8,11 +8,11 @@
 
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
-import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
-import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
 import {
     ScenesManagementServer as BaseScenesManagementServer
 } from "../behaviors/scenes-management/ScenesManagementServer.js";
+import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
+import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
 import {
     OccupancySensingBehavior as BaseOccupancySensingBehavior
 } from "../behaviors/occupancy-sensing/OccupancySensingBehavior.js";
@@ -25,6 +25,17 @@ import { Identity } from "#general";
  * being switched on or off and have its level adjusted. The Dimmable Plug-in Unit is typically used to control a
  * conventional non-communicating light through its mains connection using phase cutting.
  *
+ * The Mounted Dimmable Load Control (added in Matter 1.4) has identical cluster requirements as the Dimmable Plug-In
+ * Unit, and is marked as a superset of this device type (since Matter 1.4.2). For devices intended to be mounted
+ * permanently, the Mounted Dimmable Load Control device type shall be used, with the Dimmable Plug-In Unit device type
+ * optionally added to the DeviceTypeList of the Descriptor cluster in addition to the Mounted Dimmable Load Control
+ * device type (see [ref_MountedDimmableLoadControlServerGuidance]).
+ *
+ * ### Before Matter 1.4, mounted dimmable load control units typically used the Dimmable Plug-In Unit device type.
+ * Clients can encounter devices which were made before or after these specification updates. Therefore, clients SHOULD
+ * use the following heuristic to distinguish the type of physical device based on the device type revision found on an
+ * endpoint ("--" means the device type is not listed).
+ *
  * @see {@link MatterSpecification.v141.Device} § 5.2
  */
 export interface DimmablePlugInUnitDevice extends Identity<typeof DimmablePlugInUnitDeviceDefinition> {}
@@ -44,6 +55,14 @@ export namespace DimmablePlugInUnitRequirements {
      */
     export const GroupsServer = BaseGroupsServer;
 
+    /**
+     * The ScenesManagement cluster is required by the Matter specification.
+     *
+     * This version of {@link ScenesManagementServer} is specialized per the specification.
+     */
+    export const ScenesManagementServer = BaseScenesManagementServer
+        .alter({ commands: { copyScene: { optional: false } } });
+
     /**
      * The OnOff cluster is required by the Matter specification.
      *
@@ -66,13 +85,6 @@ export namespace DimmablePlugInUnitRequirements {
             }
         });
 
-    /**
-     * The ScenesManagement cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ScenesManagementServer} for convenience.
-     */
-    export const ScenesManagementServer = BaseScenesManagementServer;
-
     /**
      * The OccupancySensing cluster is optional per the Matter specification.
      *
@@ -87,11 +99,10 @@ export namespace DimmablePlugInUnitRequirements {
         mandatory: {
             Identify: IdentifyServer,
             Groups: GroupsServer,
+            ScenesManagement: ScenesManagementServer,
             OnOff: OnOffServer,
             LevelControl: LevelControlServer
-        },
-
-        optional: { ScenesManagement: ScenesManagementServer }
+        }
     };
 
     /**
@@ -103,12 +114,13 @@ export namespace DimmablePlugInUnitRequirements {
 export const DimmablePlugInUnitDeviceDefinition = MutableEndpoint({
     name: "DimmablePlugInUnit",
     deviceType: 0x10b,
-    deviceRevision: 4,
+    deviceRevision: 5,
     requirements: DimmablePlugInUnitRequirements,
 
     behaviors: SupportedBehaviors(
         DimmablePlugInUnitRequirements.server.mandatory.Identify,
         DimmablePlugInUnitRequirements.server.mandatory.Groups,
+        DimmablePlugInUnitRequirements.server.mandatory.ScenesManagement,
         DimmablePlugInUnitRequirements.server.mandatory.OnOff,
         DimmablePlugInUnitRequirements.server.mandatory.LevelControl
     )

package/src/devices/dishwasher.ts

@@ -33,9 +33,10 @@ export namespace DishwasherRequirements {
     /**
      * The OperationalState cluster is required by the Matter specification.
      *
-     * We provide this alias to the default implementation {@link OperationalStateServer} for convenience.
+     * This version of {@link OperationalStateServer} is specialized per the specification.
      */
-    export const OperationalStateServer = BaseOperationalStateServer;
+    export const OperationalStateServer = BaseOperationalStateServer
+        .alter({ events: { operationCompletion: { optional: false } } });
 
     /**
      * The Identify cluster is optional per the Matter specification.
@@ -91,7 +92,7 @@ export namespace DishwasherRequirements {
 export const DishwasherDeviceDefinition = MutableEndpoint({
     name: "Dishwasher",
     deviceType: 0x75,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: DishwasherRequirements,
     behaviors: SupportedBehaviors(DishwasherRequirements.server.mandatory.OperationalState)
 });

package/src/devices/extended-color-light.ts

@@ -8,12 +8,12 @@
 
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
-import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
-import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
-import { ColorControlServer as BaseColorControlServer } from "../behaviors/color-control/ColorControlServer.js";
 import {
     ScenesManagementServer as BaseScenesManagementServer
 } from "../behaviors/scenes-management/ScenesManagementServer.js";
+import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
+import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
+import { ColorControlServer as BaseColorControlServer } from "../behaviors/color-control/ColorControlServer.js";
 import {
     OccupancySensingBehavior as BaseOccupancySensingBehavior
 } from "../behaviors/occupancy-sensing/OccupancySensingBehavior.js";
@@ -47,6 +47,14 @@ export namespace ExtendedColorLightRequirements {
      */
     export const GroupsServer = BaseGroupsServer;
 
+    /**
+     * The ScenesManagement cluster is required by the Matter specification.
+     *
+     * This version of {@link ScenesManagementServer} is specialized per the specification.
+     */
+    export const ScenesManagementServer = BaseScenesManagementServer
+        .alter({ commands: { copyScene: { optional: false } } });
+
     /**
      * The OnOff cluster is required by the Matter specification.
      *
@@ -78,13 +86,6 @@ export namespace ExtendedColorLightRequirements {
         .with("Xy", "ColorTemperature")
         .alter({ attributes: { remainingTime: { optional: false } } });
 
-    /**
-     * The ScenesManagement cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ScenesManagementServer} for convenience.
-     */
-    export const ScenesManagementServer = BaseScenesManagementServer;
-
     /**
      * The OccupancySensing cluster is optional per the Matter specification.
      *
@@ -99,12 +100,11 @@ export namespace ExtendedColorLightRequirements {
         mandatory: {
             Identify: IdentifyServer,
             Groups: GroupsServer,
+            ScenesManagement: ScenesManagementServer,
             OnOff: OnOffServer,
             LevelControl: LevelControlServer,
             ColorControl: ColorControlServer
-        },
-
-        optional: { ScenesManagement: ScenesManagementServer }
+        }
     };
 
     /**
@@ -122,6 +122,7 @@ export const ExtendedColorLightDeviceDefinition = MutableEndpoint({
     behaviors: SupportedBehaviors(
         ExtendedColorLightRequirements.server.mandatory.Identify,
         ExtendedColorLightRequirements.server.mandatory.Groups,
+        ExtendedColorLightRequirements.server.mandatory.ScenesManagement,
         ExtendedColorLightRequirements.server.mandatory.OnOff,
         ExtendedColorLightRequirements.server.mandatory.LevelControl,
         ExtendedColorLightRequirements.server.mandatory.ColorControl

package/src/devices/index.ts

@@ -59,6 +59,7 @@ export * from "./solar-power.js";
 export * from "./speaker.js";
 export * from "./temperature-controlled-cabinet.js";
 export * from "./temperature-sensor.js";
+export * from "./thermostat-controller.js";
 export * from "./thermostat.js";
 export * from "./video-remote-control.js";
 export * from "./water-freeze-detector.js";

package/src/devices/laundry-dryer.ts

@@ -35,9 +35,10 @@ export namespace LaundryDryerRequirements {
     /**
      * The OperationalState cluster is required by the Matter specification.
      *
-     * We provide this alias to the default implementation {@link OperationalStateServer} for convenience.
+     * This version of {@link OperationalStateServer} is specialized per the specification.
      */
-    export const OperationalStateServer = BaseOperationalStateServer;
+    export const OperationalStateServer = BaseOperationalStateServer
+        .alter({ events: { operationCompletion: { optional: false } } });
 
     /**
      * The Identify cluster is optional per the Matter specification.
@@ -93,7 +94,7 @@ export namespace LaundryDryerRequirements {
 export const LaundryDryerDeviceDefinition = MutableEndpoint({
     name: "LaundryDryer",
     deviceType: 0x7c,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: LaundryDryerRequirements,
     behaviors: SupportedBehaviors(LaundryDryerRequirements.server.mandatory.OperationalState)
 });

package/src/devices/laundry-washer.ts

@@ -38,9 +38,10 @@ export namespace LaundryWasherRequirements {
     /**
      * The OperationalState cluster is required by the Matter specification.
      *
-     * We provide this alias to the default implementation {@link OperationalStateServer} for convenience.
+     * This version of {@link OperationalStateServer} is specialized per the specification.
      */
-    export const OperationalStateServer = BaseOperationalStateServer;
+    export const OperationalStateServer = BaseOperationalStateServer
+        .alter({ events: { operationCompletion: { optional: false } } });
 
     /**
      * The Identify cluster is optional per the Matter specification.
@@ -96,7 +97,7 @@ export namespace LaundryWasherRequirements {
 export const LaundryWasherDeviceDefinition = MutableEndpoint({
     name: "LaundryWasher",
     deviceType: 0x73,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: LaundryWasherRequirements,
     behaviors: SupportedBehaviors(LaundryWasherRequirements.server.mandatory.OperationalState)
 });

package/src/devices/microwave-oven.ts

@@ -40,7 +40,7 @@ export namespace MicrowaveOvenRequirements {
      * This version of {@link OperationalStateServer} is specialized per the specification.
      */
     export const OperationalStateServer = BaseOperationalStateServer
-        .alter({ attributes: { countdownTime: { optional: false } } });
+        .alter({ attributes: { countdownTime: { optional: false } }, events: { operationCompletion: { optional: false } } });
 
     /**
      * The MicrowaveOvenMode cluster is required by the Matter specification.
@@ -86,7 +86,7 @@ export namespace MicrowaveOvenRequirements {
 export const MicrowaveOvenDeviceDefinition = MutableEndpoint({
     name: "MicrowaveOven",
     deviceType: 0x79,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: MicrowaveOvenRequirements,
     behaviors: SupportedBehaviors(
         MicrowaveOvenRequirements.server.mandatory.OperationalState,

package/src/devices/mounted-dimmable-load-control.ts

@@ -8,11 +8,11 @@
 
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
-import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
-import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
 import {
     ScenesManagementServer as BaseScenesManagementServer
 } from "../behaviors/scenes-management/ScenesManagementServer.js";
+import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
+import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
 import {
     OccupancySensingBehavior as BaseOccupancySensingBehavior
 } from "../behaviors/occupancy-sensing/OccupancySensingBehavior.js";
@@ -21,9 +21,22 @@ import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js
 import { Identity } from "#general";
 
 /**
- * A Mounted Dimmable Load Control is a fixed device that provides power to another device that is plugged into it, and
- * is capable of being switched on or off and have its level adjusted. The Mounted Dimmable Load Control is typically
- * used to control a conventional non-communicating light through its mains connection using phase cutting.
+ * A Mounted Dimmable Load Control is a fixed device that provides power to a load connected to it, and is capable of
+ * being switched on or off and have its level adjusted. The Mounted Dimmable Load Control is typically used to control
+ * a conventional non-communicating light through its mains connection using phase cutting.
+ *
+ * This device type is intended for any wall-mounted or hardwired dimmer-capable load controller, while Dimmable Plug-In
+ * Unit is intended only for dimmer-capable smart plugs that are not permanently connected, and which can be unplugged
+ * from their power source.
+ *
+ * > [!NOTE]
+ *
+ * > Since this device type was added in Matter 1.4, for endpoints using this device type
+ *
+ * it is recommended to add the subset device type Dimmable Plug-In Unit to the DeviceTypeList of the Descriptor cluster
+ * on the same endpoint for backward compatibility with existing clients.
+ *
+ * See [ref_MountedDimmablePlugInUnitClientGuidance] for client guidance with these two device types.
  *
  * @see {@link MatterSpecification.v141.Device} § 5.4
  */
@@ -44,6 +57,14 @@ export namespace MountedDimmableLoadControlRequirements {
      */
     export const GroupsServer = BaseGroupsServer;
 
+    /**
+     * The ScenesManagement cluster is required by the Matter specification.
+     *
+     * This version of {@link ScenesManagementServer} is specialized per the specification.
+     */
+    export const ScenesManagementServer = BaseScenesManagementServer
+        .alter({ commands: { copyScene: { optional: false } } });
+
     /**
      * The OnOff cluster is required by the Matter specification.
      *
@@ -66,13 +87,6 @@ export namespace MountedDimmableLoadControlRequirements {
             }
         });
 
-    /**
-     * The ScenesManagement cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ScenesManagementServer} for convenience.
-     */
-    export const ScenesManagementServer = BaseScenesManagementServer;
-
     /**
      * The OccupancySensing cluster is optional per the Matter specification.
      *
@@ -87,11 +101,10 @@ export namespace MountedDimmableLoadControlRequirements {
         mandatory: {
             Identify: IdentifyServer,
             Groups: GroupsServer,
+            ScenesManagement: ScenesManagementServer,
             OnOff: OnOffServer,
             LevelControl: LevelControlServer
-        },
-
-        optional: { ScenesManagement: ScenesManagementServer }
+        }
     };
 
     /**
@@ -103,12 +116,13 @@ export namespace MountedDimmableLoadControlRequirements {
 export const MountedDimmableLoadControlDeviceDefinition = MutableEndpoint({
     name: "MountedDimmableLoadControl",
     deviceType: 0x110,
-    deviceRevision: 1,
+    deviceRevision: 2,
     requirements: MountedDimmableLoadControlRequirements,
 
     behaviors: SupportedBehaviors(
         MountedDimmableLoadControlRequirements.server.mandatory.Identify,
         MountedDimmableLoadControlRequirements.server.mandatory.Groups,
+        MountedDimmableLoadControlRequirements.server.mandatory.ScenesManagement,
         MountedDimmableLoadControlRequirements.server.mandatory.OnOff,
         MountedDimmableLoadControlRequirements.server.mandatory.LevelControl
     )