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

package/src/clusters/operational-state.ts

@@ -76,9 +76,8 @@ export namespace OperationalState {
         operationalStateId: TlvField(0, TlvEnum<OperationalStateEnum>()),
 
         /**
-         * This field shall be present if the OperationalStateID is from the set reserved for Manufacturer Specific
-         * States, otherwise it shall NOT be present. If present, this shall contain a human-readable description of the
-         * operational state.
+         * This field is present when the OperationalStateID is from the set reserved for Manufacturer Specific States.
+         * If present, this shall contain a human-readable description of the operational state.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.2.2
          */
@@ -147,10 +146,8 @@ export namespace OperationalState {
         errorStateId: TlvField(0, TlvEnum<ErrorState>()),
 
         /**
-         * This field shall be present if the ErrorStateID is from the set reserved for Manufacturer Specific Errors,
-         * otherwise it shall NOT be present. If present, this shall contain a human-readable description of the
-         * ErrorStateID; e.g. for a manufacturer specific ErrorStateID of "0x80" the ErrorStateLabel may contain "My
-         * special error".
+         * This field is present when the ErrorStateID is from the set reserved for Manufacturer Specific errors. If
+         * present, this shall contain a human-readable description of the error state.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 1.14.4.4.2
          */
@@ -183,7 +180,7 @@ export namespace OperationalState {
     export const TlvOperationalCommandResponse = TlvObject({
         /**
          * This shall indicate the success or otherwise of the attempted command invocation. On a successful invocation
-         * of the attempted command, the ErrorStateID shall be populated with NoError. Please see the individual command
+         * of the attempted command, the ErrorStateID shall be populated with NoError. See the individual command
          * sections for additional specific requirements on population.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.5.1
@@ -348,8 +345,8 @@ export namespace OperationalState {
 
             /**
              * This attribute shall specify the details of any current error condition being experienced on the device
-             * when the OperationalState attribute is populated with Error. Please see ErrorStateStruct for general
-             * requirements on the population of this attribute.
+             * when the OperationalState attribute is populated with Error. See Section 1.14.4.4, “ErrorStateStruct
+             * Type” for general requirements on the population of this attribute.
              *
              * When there is no error detected, this shall have an ErrorStateID of NoError.
              *

package/src/clusters/ota-software-update-provider.ts

@@ -148,6 +148,8 @@ export namespace OtaSoftwareUpdateProvider {
          * whereby strictly correct additional MetadataForProvider is expected to fulfill the OTA Software Update
          * process.
          *
+         * ### Usage of the QueryImage Command
+         *
          * OTA Requestors shall send a QueryImage command to the OTA Provider to determine the availability of a new
          * Software Image.
          *
@@ -274,7 +276,8 @@ export namespace OtaSoftwareUpdateProvider {
          * Requestors to follow this value to their best capability, however, a restarting Node may come back sooner,
          * due to having lost track of this state response.
          *
-         * The DelayedActionTime field shall only be present if the Status field is set to Busy.
+         * Beware, this field is conditionally present based on the conformance listed in Section 11.20.6.5.2,
+         * “QueryImageResponse Command”.
          *
          * See Section 11.20.3.2, “Querying the OTA Provider” for details about the rules regarding this field.
          *
@@ -283,10 +286,11 @@ export namespace OtaSoftwareUpdateProvider {
         delayedActionTime: TlvOptionalField(1, TlvUInt32),
 
         /**
-         * This field, when present, shall contain a URI where the OTA Requestor SHOULD download a Software Image. The
+         * This field, when present, shall contain a URI where the OTA Requestor SHOULD download a Soft ware Image. The
          * syntax of the ImageURI field shall follow the URI syntax as specified in RFC 3986.
          *
-         * This field shall be present if it appears in a QueryImageResponse with a Status of UpdateAvailable.
+         * Beware, this field is conditionally present based on the conformance listed in Section 11.20.6.5.2,
+         * “QueryImageResponse Command”.
          *
          * If the ImageURI specifies a BDX Protocol bdx: scheme, then the following rules describe the location to be
          * used for download:
@@ -384,10 +388,10 @@ export namespace OtaSoftwareUpdateProvider {
         imageUri: TlvOptionalField(2, TlvString.bound({ maxLength: 256 })),
 
         /**
-         * This field indicates the version of the image being provided to the OTA Requestor by the OTA Provider when
-         * the Status is UpdateAvailable.
+         * This field indicates the version of the image being provided to the OTA Requestor by the OTA Provider.
          *
-         * This field shall be present if it appears in a QueryImageResponse with a Status of UpdateAvailable.
+         * Beware, this field is conditionally present based on the conformance listed in Section 11.20.6.5.2,
+         * “QueryImageResponse Command”.
          *
          * See Section 11.20.3.2, “Querying the OTA Provider” for additional details about the flow and acceptable
          * values.
@@ -397,10 +401,11 @@ export namespace OtaSoftwareUpdateProvider {
         softwareVersion: TlvOptionalField(3, TlvUInt32),
 
         /**
-         * This field provides a string version of the image being provided to the OTA Requestor by the OTA Provider
-         * when the Status is UpdateAvailable.
+         * This field provides a string version of the image being provided to the OTA Requestor by the OTA Provider.
+         *
+         * Beware, this field is conditionally present based on the conformance listed in Section 11.20.6.5.2,
          *
-         * This field shall be present if it appears in a QueryImageResponse with a Status of UpdateAvailable.
+         * “QueryImageResponse Command”.
          *
          * See Section 11.20.3.2, “Querying the OTA Provider” for additional details about the flow and acceptable
          * values.
@@ -410,7 +415,8 @@ export namespace OtaSoftwareUpdateProvider {
         softwareVersionString: TlvOptionalField(4, TlvString.bound({ minLength: 1, maxLength: 64 })),
 
         /**
-         * This optional field shall be present when the Status field contains UpdateAvailable.
+         * Beware, this field is conditionally present based on the conformance listed in Section 11.20.6.5.2,
+         * “QueryImageResponse Command”.
          *
          * See Section 11.20.3.6.1, “UpdateToken usage” for additional details about the generation and usage of
          * UpdateToken.
@@ -474,9 +480,13 @@ export namespace OtaSoftwareUpdateProvider {
          * Software Image which the OTA Requestor is ready to start applying. The OTA Provider may use this new version
          * to track or record Software Image application by OTA Requestors.
          *
+         * ### When Generated
+         *
          * The ApplyUpdateRequest Command shall be invoked by an OTA Requestor once it is ready to apply a previously
          * downloaded Software Image.
          *
+         * ### Effect on Receipt
+         *
          * Upon receipt of this command the OTA Provider shall respond with an Action field consistent with the next
          * action the OTA Requestor should take, including any possible time delay.
          *
@@ -487,6 +497,8 @@ export namespace OtaSoftwareUpdateProvider {
          * See Section 11.20.3.6, “Applying a software update” for a description of the flow in response to an OTA
          * Provider receiving an invocation of this command.
          *
+         * ### Handling Error Cases
+         *
          * See Section 11.20.3.6, “Applying a software update” for all error-handling information.
          *
          * @see {@link MatterSpecification.v141.Core} § 11.20.6.5.3.2
@@ -571,10 +583,12 @@ export namespace OtaSoftwareUpdateProvider {
          * attribute in the invoking OTA Requestor’s Basic Information Cluster, and SHOULD be consistent with the value
          * representing a new version running on the Node invoking the command.
          *
+         * ### When Generated
+         *
          * The NotifyUpdateApplied command SHOULD be invoked in the following two circumstances:
          *
          *   1. An OTA Requestor has just successfully applied a Software Image it had obtained from a previous
-         *      QueryImage response.
+         *      QueryImageResponse.
          *
          *   2. An OTA Requestor has just successfully applied a Software Image it had obtained through means different
          *      than those of this Cluster.
@@ -587,6 +601,8 @@ export namespace OtaSoftwareUpdateProvider {
          * This command shall be considered optional and shall NOT result in reduced availability of the OTA Provider
          * functionality if OTA Requestors never invoke this command.
          *
+         * ### Effect on Receipt
+         *
          * An OTA Provider receiving an invocation of this command may log it internally.
          *
          * On receiving this command, an OTA Provider may use the information to update its bookkeeping of cached

package/src/clusters/ota-software-update-requestor.ts

@@ -239,6 +239,8 @@ export namespace OtaSoftwareUpdateRequestor {
          * Provider cluster server on the ProviderNodeID. This is provided to avoid having to do discovery of the
          * location of that endpoint by walking over all endpoints and checking their Descriptor Cluster.
          *
+         * ### When Generated
+         *
          * An OTA Provider may invoke this command directly to an OTA Requestor, to announce its presence as an OTA
          * Provider on the Fabric.
          *
@@ -247,12 +249,11 @@ export namespace OtaSoftwareUpdateRequestor {
          * UrgentUpdateAvailable, in which case this command may be more frequent.
          *
          * Any invocation shall be made with a delay of at least 1 second between invocations from a given OTA Provider,
-         * to reduce burden on the networking infrastructure and affect a form of serialized
-         *
-         * jitter. It is recommended to offset the first announcement of a round (i.e. new set of announcements after a
-         * previous complete set) by a random delay time with a distribution span of
+         * to reduce burden on the networking infrastructure and affect a form of serialized jitter. It is recommended
+         * to offset the first announcement of a round (i.e. new set of announcements after a previous complete set) by
+         * a random delay time with a distribution span of >= 60 seconds to jitter announcement schedules over time.
          *
-         * >= 60 seconds to jitter announcement schedules over time.
+         * ### Effect on Receipt
          *
          * On receipt of this command, an OTA Requestor SHOULD consider the new ProviderNodeID and AnnouncementReason to
          * possibly query for new software sooner than it would have with its default behavior.

package/src/clusters/oven-cavity-operational-state.ts

@@ -27,7 +27,7 @@ export namespace OvenCavityOperationalState {
     export const TlvOperationalCommandResponse = TlvObject({
         /**
          * This shall indicate the success or otherwise of the attempted command invocation. On a successful invocation
-         * of the attempted command, the ErrorStateID shall be populated with NoError. Please see the individual command
+         * of the attempted command, the ErrorStateID shall be populated with NoError. See the individual command
          * sections for additional specific requirements on population.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 1.14.6.5.1
@@ -131,8 +131,8 @@ export namespace OvenCavityOperationalState {
 
             /**
              * This attribute shall specify the details of any current error condition being experienced on the device
-             * when the OperationalState attribute is populated with Error. Please see ErrorStateStruct for general
-             * requirements on the population of this attribute.
+             * when the OperationalState attribute is populated with Error. See Section 1.14.4.4, “ErrorStateStruct
+             * Type” for general requirements on the population of this attribute.
              *
              * When there is no error detected, this shall have an ErrorStateID of NoError.
              *

package/src/clusters/oven-mode.ts

@@ -196,9 +196,61 @@ export namespace OvenMode {
      * @see {@link MatterSpecification.v141.Cluster} § 8.11.5.1
      */
     export const TlvModeOption = TlvObject({
+        /**
+         * This field shall indicate readable text that describes the mode option, so that a client can provide it to
+         * the user to indicate what this option means. This field is meant to be readable and understandable by the
+         * user.
+         *
+         * @see {@link MatterSpecification.v141.Cluster} § 1.10.5.2.1
+         */
         label: TlvField(0, TlvString.bound({ maxLength: 64 })),
+
+        /**
+         * This field is used to identify the mode option.
+         *
+         * @see {@link MatterSpecification.v141.Cluster} § 1.10.5.2.2
+         */
         mode: TlvField(1, TlvUInt8),
-        modeTags: TlvField(2, TlvArray(TlvModeTagStruct, { minLength: 1, maxLength: 8 }))
+
+        /**
+         * This field shall contain a list of tags that are associated with the mode option. This may be used by clients
+         * to determine the full or the partial semantics of a certain mode, depending on which tags they understand,
+         * using standard definitions and/or manufacturer specific namespace definitions.
+         *
+         * The standard mode tags are defined in this cluster specification. For the derived cluster instances, if the
+         * specification of the derived cluster defines a namespace, the set of standard mode tags also includes the
+         * mode tag values from that namespace.
+         *
+         * Mode tags can help clients look for options that meet certain criteria, render the user interface, use the
+         * mode in an automation, or to craft help text their voice-driven interfaces. A mode tag shall be either a
+         * standard tag or a manufacturer specific tag, as defined in each ModeTagStruct list entry.
+         *
+         * A mode option may have more than one mode tag. A mode option may be associated with a mixture of standard and
+         * manufacturer specific mode tags. A mode option shall be associated with at least one standard mode tag.
+         *
+         * Each mode tag in this field shall be distinct from other mode tags in this field. For example, a simplified
+         * list containing [Auto, Auto] would not be allowed.
+         *
+         * A few examples are provided below.
+         *
+         *   • A mode named "100%" can have both the High (manufacturer specific) and Max (standard) mode tag. Clients
+         *     seeking the mode for either High or Max will find the same mode in this case.
+         *
+         *   • A mode that includes a LowEnergy tag can be displayed by the client using a widget icon that shows a
+         *     green leaf.
+         *
+         *   • A mode that includes a LowNoise tag may be used by the client when the user wishes for a lower level of
+         *     audible sound, less likely to disturb the household’s activities.
+         *
+         *   • A mode that includes a LowEnergy tag (standard, defined in this cluster specification) and also a
+         *     Delicate tag (standard, defined in the namespace of a Laundry Mode derived cluster).
+         *
+         *   • A mode that includes both a generic Quick tag (defined here), and Vacuum and Mop tags, (defined in the
+         *     RVC Clean cluster that is a derivation of this cluster).
+         *
+         * @see {@link MatterSpecification.v141.Cluster} § 1.10.5.2.3
+         */
+        modeTags: TlvField(2, TlvArray(TlvModeTagStruct, { maxLength: 8 }))
     });
 
     /**

package/src/clusters/power-source.ts

@@ -1073,7 +1073,7 @@ export namespace PowerSource {
             batReplacementNeeded: Attribute(0xf, TlvBoolean),
 
             /**
-             * This attribute shall indicate the replaceability of the battery as specified in BatReplaceabilityEnum.
+             * Indicates the replaceability of the battery as specified in BatReplaceabilityEnum.
              *
              * @see {@link MatterSpecification.v141.Core} § 11.7.7.17
              */
@@ -1298,7 +1298,7 @@ export namespace PowerSource {
             /**
              * Indicates the relative preference with which the Node will select this source to provide power. A source
              * with a lower order shall be selected by the Node to provide power before any other source with a higher
-             * order, if the lower order source is available (see Status).
+             * order, if the lower order source is available (see Section 11.7.7.1, “Status Attribute”).
              *
              * Note, Order is read-only and therefore NOT intended to allow clients control over power source selection.
              *
@@ -1331,10 +1331,14 @@ export namespace PowerSource {
              * The above rules allow that some endpoints can have an unknown power source, and therefore would not be
              * indicated by any instance of this cluster.
              *
+             * ### Empty list examples
+             *
              * Typically, there is one power source for the node. Also common is mains power for the node with battery
              * backup power for the node. In both these common cases, for each cluster instance described, the list is
              * empty.
              *
+             * ### Populated list example
+             *
              * A node has a mains power source with Order as 0 (zero), but some application endpoints (not all) have a
              * battery back up source with Order as 1, which means this list is empty for the Power Source cluster
              * associated with the mains power, because it indicates the entire node, but the Power Source cluster

package/src/clusters/pressure-measurement.ts

@@ -35,13 +35,15 @@ export namespace PressureMeasurement {
     export const ExtendedComponent = MutableCluster.Component({
         attributes: {
             /**
-             * Indicates the pressure in Pascals as follows: ScaledValue = 10Scale x Pressure [Pa]
+             * Indicates the pressure in Pascals as follows:
+             *
+             * ScaledValue = 10Scale x Pressure [Pa]
              *
              * The null value indicates that the value is not available.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.4.5.5
              */
-            scaledValue: Attribute(0x10, TlvNullable(TlvInt16), { default: 0 }),
+            scaledValue: Attribute(0x10, TlvNullable(TlvInt16)),
 
             /**
              * Indicates the minimum value of ScaledValue that can be measured. The null value indicates that the value
@@ -49,7 +51,7 @@ export namespace PressureMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.4.5.6
              */
-            minScaledValue: Attribute(0x11, TlvNullable(TlvInt16.bound({ max: 32766 })), { default: 0 }),
+            minScaledValue: Attribute(0x11, TlvNullable(TlvInt16.bound({ max: 32766 }))),
 
             /**
              * Indicates the maximum value of ScaledValue that can be measured. The null value indicates that the value
@@ -57,11 +59,12 @@ export namespace PressureMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.4.5.7
              */
-            maxScaledValue: Attribute(0x12, TlvNullable(TlvInt16), { default: 0 }),
+            maxScaledValue: Attribute(0x12, TlvNullable(TlvInt16)),
 
             /**
-             * Indicates the magnitude of the possible error that is associated with ScaledValue. The true value is
-             * located in the range
+             * Indicates the magnitude of the possible error that is associated with Scaled
+             *
+             * ### Value. The true value is located in the range
              *
              * (ScaledValue – ScaledTolerance) to (ScaledValue + ScaledTolerance).
              *
@@ -74,7 +77,7 @@ export namespace PressureMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.4.5.9
              */
-            scale: Attribute(0x14, TlvInt8.bound({ min: -127 }), { default: 0 })
+            scale: Attribute(0x14, TlvInt8.bound({ min: -127 }))
         }
     });
 

package/src/clusters/pump-configuration-and-control.ts

@@ -221,7 +221,7 @@ export namespace PumpConfigurationAndControl {
         /**
          * The pump will regulate its speed to maintain a constant differential pressure over its flanges.
          *
-         * The setpoint is interpreted as a percentage of the range derived of the [MinCompPressure – MaxCompPressure]
+         * The setpoint is interpreted as a percentage of the range derived of the [MinCompPressure – Max CompPressure]
          * attributes. The internal setpoint will be lowered (compensated) dependent on the flow in the pump (lower flow
          * ⇒ lower internal setpoint).
          *
@@ -339,7 +339,7 @@ export namespace PumpConfigurationAndControl {
             maxCompPressure: OptionalFixedAttribute(0x6, TlvNullable(TlvInt16), { default: null }),
 
             /**
-             * This attribute specifies the minimum speed the pump can achieve when it is working with the ControlMode
+             * This attribute specifies the minimum speed the pump can achieve when it is working with the Con trolMode
              * attribute set to ConstantSpeed.
              *
              * Valid range is 0 to 65,534 RPM (steps of 1 RPM). Null if the value is invalid.
@@ -393,7 +393,9 @@ export namespace PumpConfigurationAndControl {
              * with the ControlMode attribute set to ConstantTemperature.
              *
              * MaxConstTemp shall be greater than or equal to MinConstTemp Valid range is –273.15 °C to 327.67 °C (steps
-             * of 0.01 °C). Null if the value is invalid.
+             * of 0.01 °C).
+             *
+             * Null if the value is invalid.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 4.2.7.13
              */
@@ -434,7 +436,7 @@ export namespace PumpConfigurationAndControl {
     export const ConstantSpeedComponent = MutableCluster.Component({
         attributes: {
             /**
-             * This attribute specifies the minimum speed the pump can achieve when it is working with the ControlMode
+             * This attribute specifies the minimum speed the pump can achieve when it is working with the Con trolMode
              * attribute set to ConstantSpeed.
              *
              * Valid range is 0 to 65,534 RPM (steps of 1 RPM). Null if the value is invalid.
@@ -502,7 +504,9 @@ export namespace PumpConfigurationAndControl {
              * with the ControlMode attribute set to ConstantTemperature.
              *
              * MaxConstTemp shall be greater than or equal to MinConstTemp Valid range is –273.15 °C to 327.67 °C (steps
-             * of 0.01 °C). Null if the value is invalid.
+             * of 0.01 °C).
+             *
+             * Null if the value is invalid.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 4.2.7.13
              */
@@ -605,8 +609,8 @@ export namespace PumpConfigurationAndControl {
              *
              *   • The LocalOverride bit in the PumpStatus attribute is set,
              *
-             * See OperationMode and ControlMode attributes for a detailed description of the operation and control of
-             * the pump.
+             * See OperationMode Attribute and ControlMode Attribute for a detailed description of the operation and
+             * control of the pump.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 4.2.7.15
              */
@@ -629,8 +633,8 @@ export namespace PumpConfigurationAndControl {
              * In case the ControlMode attribute is not included on the device and no remote sensors are connected, the
              * value of the EffectiveControlMode shall match the vendor-specific behavior of the pump.
              *
-             * See OperationMode and ControlMode attributes for detailed a description of the operation and control of
-             * the pump.
+             * See OperationMode Attribute and ControlMode Attribute for detailed a description of the operation and
+             * control of the pump.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 4.2.7.16
              */
@@ -700,9 +704,8 @@ export namespace PumpConfigurationAndControl {
              * consumption of the pump increases. If LifetimeEnergyConsumed rises above maximum value it “rolls over”
              * and starts at 0 (zero).
              *
-             * This attribute is writeable, in order to allow setting to an appropriate value after maintenance.
-             *
-             * Valid range is 0 kWh to 4,294,967,294 kWh.
+             * This attribute is writeable, in order to allow setting to an appropriate value after maintenance. Valid
+             * range is 0 kWh to 4,294,967,294 kWh.
              *
              * Null if the value is unknown.
              *
@@ -752,7 +755,7 @@ export namespace PumpConfigurationAndControl {
             /**
              * This attribute specifies the control mode of the pump as defined in ControlModeEnum.
              *
-             * See the OperationMode attribute for a detailed description of the operation and control of the pump.
+             * See OperationMode Attribute for a detailed description of the operation and control of the pump.
              *
              * ControlMode may be changed at any time, even when the pump is running. The behavior of the pump at the
              * point of changing is vendor-specific.

package/src/clusters/refrigerator-alarm.ts

@@ -179,7 +179,7 @@ export namespace RefrigeratorAlarm {
 
         events: {
             /**
-             * This event shall be generated when one or more alarms change state, and shall have these fields:
+             * This event shall be generated when one or more alarms change state.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 1.15.8.1
              */

package/src/clusters/refrigerator-and-temperature-controlled-cabinet-mode.ts

@@ -176,6 +176,9 @@ export namespace RefrigeratorAndTemperatureControlledCabinetMode {
          * A mode option may have more than one mode tag. A mode option may be associated with a mixture of standard and
          * manufacturer specific mode tags. A mode option shall be associated with at least one standard mode tag.
          *
+         * Each mode tag in this field shall be distinct from other mode tags in this field. For example, a simplified
+         * list containing [Auto, Auto] would not be allowed.
+         *
          * A few examples are provided below.
          *
          *   • A mode named "100%" can have both the High (manufacturer specific) and Max (standard) mode tag. Clients

package/src/clusters/resource-monitoring.ts

@@ -215,7 +215,7 @@ export namespace ResourceMonitoring {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.8.6.3
              */
-            changeIndication: Attribute(0x2, TlvEnum<ChangeIndication>(), { default: ChangeIndication.Ok }),
+            changeIndication: Attribute(0x2, TlvEnum<ChangeIndication>()),
 
             /**
              * Indicates whether a resource is currently installed. A value of true shall indicate that a resource is

package/src/clusters/rvc-clean-mode.ts

@@ -102,7 +102,12 @@ export namespace RvcCleanMode {
          *
          * @see {@link MatterSpecification.v141.Cluster} § 7.3.7.2.3
          */
-        Mop = 16386
+        Mop = 16386,
+
+        /**
+         * @see {@link MatterSpecification.v141.Cluster} § 7.3.7.2
+         */
+        VacuumThenMop = 16387
     }
 
     /**
@@ -181,6 +186,9 @@ export namespace RvcCleanMode {
          * A mode option may have more than one mode tag. A mode option may be associated with a mixture of standard and
          * manufacturer specific mode tags. A mode option shall be associated with at least one standard mode tag.
          *
+         * Each mode tag in this field shall be distinct from other mode tags in this field. For example, a simplified
+         * list containing [Auto, Auto] would not be allowed.
+         *
          * A few examples are provided below.
          *
          *   • A mode named "100%" can have both the High (manufacturer specific) and Max (standard) mode tag. Clients
@@ -245,7 +253,7 @@ export namespace RvcCleanMode {
     export const Base = MutableCluster.Component({
         id: 0x55,
         name: "RvcCleanMode",
-        revision: 3,
+        revision: 4,
 
         features: {
             /**