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

package/src/clusters/bridged-device-basic-information.ts

@@ -15,6 +15,7 @@ import {
     OptionalWritableAttribute,
     Attribute,
     FixedAttribute,
+    OptionalAttribute,
     OptionalEvent
 } from "../cluster/Cluster.js";
 import { TlvField, TlvObject } from "../tlv/TlvObject.js";
@@ -216,7 +217,7 @@ export namespace BridgedDeviceBasicInformation {
     export const Base = MutableCluster.Component({
         id: 0x39,
         name: "BridgedDeviceBasicInformation",
-        revision: 4,
+        revision: 5,
 
         features: {
             /**
@@ -310,7 +311,7 @@ export namespace BridgedDeviceBasicInformation {
              * reachable may be delayed due to the technique employed (e.g. detecting that a number of expected messages
              * from the bridged device did not arrive). Also see event ReachableChanged below.
              *
-             * @see {@link MatterSpecification.v141.Core} § 9.13.5.1
+             * @see {@link MatterSpecification.v141.Core} § 9.13.5.2
              */
             reachable: Attribute(0x11, TlvBoolean),
 
@@ -320,14 +321,29 @@ export namespace BridgedDeviceBasicInformation {
              * of bridging Matter devices from an earlier revision which were not required to provide a UniqueID
              * attribute), the bridge shall generate a unique id on behalf of the bridged device.
              *
-             * @see {@link MatterSpecification.v141.Core} § 9.13.5.2
+             * NOTE The UniqueID attribute was optional in cluster revisions prior to revision 4.
+             *
+             * @see {@link MatterSpecification.v141.Core} § 9.13.5.3
              */
             uniqueId: FixedAttribute(0x12, TlvString.bound({ maxLength: 32 })),
 
             /**
              * @see {@link MatterSpecification.v141.Core} § 9.13.5
              */
-            productAppearance: OptionalFixedAttribute(0x14, BasicInformation.TlvProductAppearance)
+            productAppearance: OptionalFixedAttribute(0x14, BasicInformation.TlvProductAppearance),
+
+            /**
+             * This attribute shall contain the current version number for the configuration of the bridged device.
+             *
+             * If the bridge detects a change on a bridged device, which it deems as a change in the configuration of
+             * the bridged device, it shall increase this attribute as described in Section 9.2.9, “Node Configuration
+             * Changes”.
+             *
+             * The ability and the method used to detect such a change on a bridged device is manufacturer specific.
+             *
+             * @see {@link MatterSpecification.v141.Core} § 9.13.5.4
+             */
+            configurationVersion: OptionalAttribute(0x18, TlvUInt32.bound({ min: 1 }), { persistent: true })
         },
 
         events: {
@@ -382,8 +398,10 @@ export namespace BridgedDeviceBasicInformation {
     export const ClusterInstance = MutableCluster(Base);
 
     /**
-     * This cluster is a derived cluster of the Basic Information cluster and serves two purposes towards a Node
-     * communicating with a Bridge:
+     * This cluster provides attributes and events for determining basic information about Bridged Nodes.
+     *
+     * This cluster is derived from the Basic Information cluster and serves two purposes towards a Node communicating
+     * with a Bridge:
      *
      *   • Indicate that the functionality on the Endpoint where it is placed (and its Parts) is bridged, and
      *

package/src/clusters/channel.ts

@@ -1038,6 +1038,10 @@ export namespace Channel {
              * This command provides channel up and channel down functionality, but allows channel index jumps of size
              * Count.
              *
+             * Jumps are relative to the available list of channels. For example, when the current channel is 100.0 and
+             * the list of available channels is [100.0, 200.0, 201.0, 305.1], a SkipChannel command with jump value of
+             * 2 shall change the channel to 201.0.
+             *
              * When the value of the increase or decrease is larger than the number of channels remaining in the given
              * direction, then the behavior shall be to return to the beginning (or end) of the channel list and
              * continue. For example, if the current channel is at index 0 and count value of -1 is given, then the

package/src/clusters/color-control.ts

@@ -499,11 +499,8 @@ export namespace ColorControl {
          * This field shall indicate a lower bound on the ColorTemperatureMireds attribute (≡ an upper bound on the
          * color temperature in kelvins) for the current move operation
          *
-         * ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <=
-         *
-         * ### ColorTemperatureMireds
-         *
-         * As such if the move operation takes the ColorTemperatureMireds attribute towards the value of the
+         * ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <= ColorTemperatureMireds As such if the
+         * move operation takes the ColorTemperatureMireds attribute towards the value of the
          * ColorTemperatureMinimumMireds field it shall be clipped so that the above invariant is satisfied. If the
          * ColorTemperatureMinimumMireds field is set to 0, ColorTempPhysicalMinMireds shall be used as the lower bound
          * for the ColorTemperatureMireds attribute.
@@ -516,11 +513,8 @@ export namespace ColorControl {
          * This field shall indicate an upper bound on the ColorTemperatureMireds attribute (≡ a lower bound on the
          * color temperature in kelvins) for the current move operation
          *
-         * ColorTemperatureMireds <= ColorTemperatureMaximumMireds field <=
-         *
-         * ### ColorTempPhysicalMaxMireds
-         *
-         * As such if the move operation takes the ColorTemperatureMireds attribute towards the value of the
+         * ColorTemperatureMireds <= ColorTemperatureMaximumMireds field <= ColorTempPhysicalMaxMireds As such if the
+         * move operation takes the ColorTemperatureMireds attribute towards the value of the
          * ColorTemperatureMaximumMireds field it shall be clipped so that the above invariant is satisfied. If the
          * ColorTemperatureMaximumMireds field is set to 0, ColorTempPhysicalMaxMireds shall be used as the upper bound
          * for the ColorTemperatureMireds attribute.
@@ -573,11 +567,8 @@ export namespace ColorControl {
          * This field shall indicate a lower bound on the ColorTemperatureMireds attribute (≡ an upper bound on the
          * color temperature in kelvins) for the current step operation
          *
-         * ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <=
-         *
-         * ### ColorTemperatureMireds
-         *
-         * As such if the step operation takes the ColorTemperatureMireds attribute towards the value of the
+         * ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <= ColorTemperatureMireds As such if the
+         * step operation takes the ColorTemperatureMireds attribute towards the value of the
          * ColorTemperatureMinimumMireds field it shall be clipped so that the above invariant is satisfied. If the
          * ColorTemperatureMinimumMireds field is set to 0, ColorTempPhysicalMinMireds shall be used as the lower bound
          * for the ColorTemperatureMireds attribute.
@@ -860,7 +851,7 @@ export namespace ColorControl {
         Deactivate = 0,
 
         /**
-         * Activate the color loop from the value in the ColorLoopStartEnhance dHue field.
+         * Activate the color loop from the value in the ColorLoopStartEnhancedHue field.
          */
         ActivateFromColorLoopStartEnhancedHue = 1,
 
@@ -1064,7 +1055,7 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.2
              */
-            currentHue: Attribute(0x0, TlvUInt8.bound({ max: 254 }), { persistent: true, default: 0 }),
+            currentHue: Attribute(0x0, TlvUInt8.bound({ max: 254 }), { persistent: true }),
 
             /**
              * Indicates the current saturation value of the light. It is updated as fast as practical during commands
@@ -1085,11 +1076,7 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.3
              */
-            currentSaturation: Attribute(
-                0x1,
-                TlvUInt8.bound({ max: 254 }),
-                { scene: true, persistent: true, default: 0 }
-            )
+            currentSaturation: Attribute(0x1, TlvUInt8.bound({ max: 254 }), { scene: true, persistent: true })
         },
 
         commands: {
@@ -1153,11 +1140,7 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.5
              */
-            currentX: Attribute(
-                0x3,
-                TlvUInt16.bound({ max: 65279 }),
-                { scene: true, persistent: true, default: 24939 }
-            ),
+            currentX: Attribute(0x3, TlvUInt16.bound({ max: 65279 }), { scene: true, persistent: true }),
 
             /**
              * Indicates the current value of the normalized chromaticity value y, as defined in the CIE xyY Color
@@ -1177,11 +1160,7 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.6
              */
-            currentY: Attribute(
-                0x4,
-                TlvUInt16.bound({ max: 65279 }),
-                { scene: true, persistent: true, default: 24701 }
-            )
+            currentY: Attribute(0x4, TlvUInt16.bound({ max: 65279 }), { scene: true, persistent: true })
         },
 
         commands: {
@@ -1230,12 +1209,11 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.9
              */
-            colorTemperatureMireds: Attribute(0x7, TlvUInt16, { scene: true, persistent: true, default: 250 }),
+            colorTemperatureMireds: Attribute(0x7, TlvUInt16, { scene: true, persistent: true }),
 
             /**
-             * This attribute shall indicate the minimum mired value supported by the hardware.
-             * ColorTempPhysicalMinMireds corresponds to the maximum color temperature in kelvins supported by the
-             * hardware.
+             * Indicates the minimum mired value supported by the hardware. ColorTempPhysicalMinMireds corresponds to
+             * the maximum color temperature in kelvins supported by the hardware.
              *
              * ColorTempPhysicalMinMireds <= ColorTemperatureMireds.
              *
@@ -1244,9 +1222,8 @@ export namespace ColorControl {
             colorTempPhysicalMinMireds: Attribute(0x400b, TlvUInt16.bound({ min: 1, max: 65279 })),
 
             /**
-             * This attribute shall indicate the maximum mired value supported by the hardware.
-             * ColorTempPhysicalMaxMireds corresponds to the minimum color temperature in kelvins supported by the
-             * hardware.
+             * Indicates the maximum mired value supported by the hardware. ColorTempPhysicalMaxMireds corresponds to
+             * the minimum color temperature in kelvins supported by the hardware.
              *
              * ColorTemperatureMireds <= ColorTempPhysicalMaxMireds.
              *
@@ -1267,7 +1244,9 @@ export namespace ColorControl {
              * Note that since this attribute is stored as a micro reciprocal degree (mired) value (i.e. color
              * temperature in kelvins = 1,000,000 / CoupleColorTempToLevelMinMireds), the
              * CoupleColorTempToLevelMinMireds attribute corresponds to an upper bound on the value of the color
-             * temperature in kelvins supported by the device.
+             * temperature
+             *
+             * in kelvins supported by the device.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.22
              */
@@ -1333,7 +1312,7 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.12
              */
-            enhancedCurrentHue: Attribute(0x4000, TlvUInt16, { scene: true, persistent: true, default: 0 })
+            enhancedCurrentHue: Attribute(0x4000, TlvUInt16, { scene: true, persistent: true })
         },
 
         commands: {
@@ -1386,24 +1365,16 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.14
              */
-            colorLoopActive: Attribute(
-                0x4002,
-                TlvEnum<ColorLoopActive>(),
-                { scene: true, persistent: true, default: ColorLoopActive.Inactive }
-            ),
+            colorLoopActive: Attribute(0x4002, TlvEnum<ColorLoopActive>(), { scene: true, persistent: true }),
 
             /**
-             * Indicates the current direction of the color loop. If this attribute has the value 0, the
-             * EnhancedCurrentHue attribute shall be decremented. If this attribute has the value 1, the
+             * Indicates the current direction of the color loop. If this attribute has the value Decrement, the
+             * EnhancedCurrentHue attribute shall be decremented. If this attribute has the value Increment, the
              * EnhancedCurrentHue attribute shall be incremented.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.15
              */
-            colorLoopDirection: Attribute(
-                0x4003,
-                TlvEnum<ColorLoopDirection>(),
-                { scene: true, persistent: true, default: ColorLoopDirection.Decrement }
-            ),
+            colorLoopDirection: Attribute(0x4003, TlvEnum<ColorLoopDirection>(), { scene: true, persistent: true }),
 
             /**
              * Indicates the number of seconds it shall take to perform a full color loop, i.e., to cycle all values of
@@ -1411,14 +1382,14 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.16
              */
-            colorLoopTime: Attribute(0x4004, TlvUInt16, { scene: true, persistent: true, default: 25 }),
+            colorLoopTime: Attribute(0x4004, TlvUInt16, { scene: true, persistent: true }),
 
             /**
              * Indicates the value of the EnhancedCurrentHue attribute from which the color loop shall be started.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.17
              */
-            colorLoopStartEnhancedHue: Attribute(0x4005, TlvUInt16, { default: 8960 }),
+            colorLoopStartEnhancedHue: Attribute(0x4005, TlvUInt16),
 
             /**
              * Indicates the value of the EnhancedCurrentHue attribute before the color loop was started. Once the color
@@ -1426,7 +1397,7 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.18
              */
-            colorLoopStoredEnhancedHue: Attribute(0x4006, TlvUInt16, { default: 0 })
+            colorLoopStoredEnhancedHue: Attribute(0x4006, TlvUInt16)
         },
 
         commands: {
@@ -1448,6 +1419,10 @@ export namespace ColorControl {
             /**
              * This command is provided to allow MoveTo and Step commands to be stopped.
              *
+             * NOTE This automatically provides symmetry to the Level Control cluster.
+             *
+             * NOTE The StopMoveStep command has no effect on an active color loop.
+             *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.8.20
              */
             stopMoveStep: Command(0x47, TlvStopMoveStepRequest, 0x47, TlvNoResponse)
@@ -1513,8 +1488,7 @@ export namespace ColorControl {
             remainingTime: OptionalAttribute(0x2, TlvUInt16, { default: 0 }),
 
             /**
-             * This attribute shall indicate what mechanism, if any, is in use for compensation for color/intensity
-             * drift over time.
+             * Indicates what mechanism, if any, is in use for compensation for color/intensity drift over time.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.7
              */
@@ -1595,12 +1569,18 @@ export namespace ColorControl {
             primary1Y: OptionalFixedAttribute(0x12, TlvUInt16.bound({ max: 65279 })),
 
             /**
-             * Indicates a representation of the maximum intensity of this primary as defined in the Dimming Light Curve
-             * in the Ballast Configuration cluster (see Ballast Configuration Cluster), normalized such that the
-             * primary with the highest maximum intensity contains the value 254.
+             * Indicates a representation of the maximum intensity of this primary as defined in Section 3.1.3, “The
+             * Dimming Light Curve”, normalized such that the primary with the highest maximum intensity contains the
+             * value 254.
              *
              * A value of null shall indicate that this primary is not available.
              *
+             * 3.2.7.28. Primary2X, Primary2Y, Primary2Intensity, Primary3X, Primary3Y, Primary3Intensity, Primary4X,
+             * Primary4Y, Primary4Intensity, Primary5X, Primary5Y, Primary5Intensity, Primary6X, Primary6Y and
+             * Primary6Intensity Attributes These attributes shall represent the capabilities of the 2nd, 3rd, 4th, 5th
+             * and 6th primaries, where present, in the same way as for the Primary1X, Primary1Y and Primary1Intensity
+             * attributes.
+             *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.27
              */
             primary1Intensity: OptionalFixedAttribute(0x13, TlvNullable(TlvUInt8)),
@@ -1741,12 +1721,20 @@ export namespace ColorControl {
             ),
 
             /**
-             * Indicates a representation of the relative intensity of the red color point as defined in the Dimming
-             * Light Curve in the Ballast Configuration cluster (see Ballast Configuration Cluster), normalized such
-             * that the color point with the highest relative intensity contains the value 254.
+             * Indicates a representation of the relative intensity of the red color point as defined in Section 3.1.3,
+             * “The Dimming Light Curve”, normalized such that the color point with the highest relative intensity
+             * contains the value 254.
              *
              * A value of null shall indicate an invalid value.
              *
+             * 3.2.7.34. ColorPointGX, ColorPointGY, ColorPointGIntensity, ColorPointBX, ColorPointBY and
+             * ColorPointBIntensity Attributes These attributes shall represent the chromaticity values and intensities
+             * of the green and blue color points, in the same way as for the ColorPointRX, ColorPointRY and
+             * ColorPointRIntensity attributes.
+             *
+             * If any one of these red, green or blue color point attributes is implemented then they shall all be
+             * implemented.
+             *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.33
              */
             colorPointRIntensity: OptionalWritableAttribute(
@@ -1818,11 +1806,7 @@ export namespace ColorControl {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 3.2.7.13
              */
-            enhancedColorMode: Attribute(
-                0x4001,
-                TlvEnum<EnhancedColorMode>(),
-                { scene: true, persistent: true, default: EnhancedColorMode.CurrentXAndCurrentY }
-            ),
+            enhancedColorMode: Attribute(0x4001, TlvEnum<EnhancedColorMode>(), { scene: true, persistent: true }),
 
             /**
              * Indicates the color control capabilities of the device.

package/src/clusters/commissioner-control.ts

@@ -86,8 +86,8 @@ export namespace CommissionerControl {
      *
      * > [!NOTE]
      *
-     * > This is an alias onto the Open Commissioning Window command within the Administrator Commissioning Cluster.
-     *   Refer to the Open Commissioning Window command for a description of the command behavior and parameters.
+     * > This is an alias onto the OpenCommissioningWindow command within the Administrator Commissioning Cluster. Refer
+     *   to the OpenCommissioningWindow command for a description of the command behavior and parameters.
      *
      * The parameters for ReverseOpenCommissioningWindow command are as follows:
      *
@@ -95,7 +95,7 @@ export namespace CommissionerControl {
      */
     export const TlvReverseOpenCommissioningWindowResponse = TlvObject({
         commissioningTimeout: TlvField(0, TlvUInt16),
-        pakePasscodeVerifier: TlvField(1, TlvByteString),
+        pakePasscodeVerifier: TlvField(1, TlvByteString.bound({ length: 97 })),
         discriminator: TlvField(2, TlvUInt16.bound({ max: 4095 })),
         iterations: TlvField(3, TlvUInt32.bound({ min: 1000, max: 100000 })),
         salt: TlvField(4, TlvByteString.bound({ minLength: 16, maxLength: 32 }))
@@ -113,8 +113,8 @@ export namespace CommissionerControl {
      *
      * > [!NOTE]
      *
-     * > This is an alias onto the Open Commissioning Window command within the Administrator Commissioning Cluster.
-     *   Refer to the Open Commissioning Window command for a description of the command behavior and parameters.
+     * > This is an alias onto the OpenCommissioningWindow command within the Administrator Commissioning Cluster. Refer
+     *   to the OpenCommissioningWindow command for a description of the command behavior and parameters.
      *
      * The parameters for ReverseOpenCommissioningWindow command are as follows:
      *
@@ -241,6 +241,10 @@ export namespace CommissionerControl {
              *   presenting the Commissioner Control Cluster. Clients SHOULD send the CommissionNode command immediately
              *   upon receiving a CommissioningRequestResult event.
              *
+             * 11.26.7.2. RequestID / ClientNodeID Fields The RequestID shall match the RequestID provided to
+             * RequestCommissioningApproval and the ClientNodeID shall match the NodeID of the client which generated
+             * the RequestCommissioningApproval command.
+             *
              * @see {@link MatterSpecification.v141.Core} § 11.26.7.1
              */
             commissioningRequestResult: Event(

package/src/clusters/concentration-measurement.ts

@@ -30,7 +30,7 @@ export namespace ConcentrationMeasurement {
         /**
          * LevelIndication (LEV)
          *
-         * Cluster supports basic level indication for substance using the ConcentrationLev el enum
+         * Cluster supports basic level indication for substance using the ConcentrationLevel enum
          */
         LevelIndication = "LevelIndication",
 
@@ -174,7 +174,7 @@ export namespace ConcentrationMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.1
              */
-            measuredValue: Attribute(0x0, TlvNullable(TlvFloat), { default: null }),
+            measuredValue: Attribute(0x0, TlvNullable(TlvFloat)),
 
             /**
              * Indicates the minimum value of MeasuredValue that is capable of being measured. A MinMeasuredValue of
@@ -182,7 +182,7 @@ export namespace ConcentrationMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.2
              */
-            minMeasuredValue: Attribute(0x1, TlvNullable(TlvFloat), { default: null }),
+            minMeasuredValue: Attribute(0x1, TlvNullable(TlvFloat)),
 
             /**
              * Indicates the maximum value of MeasuredValue that is capable of being measured. A MaxMeasuredValue of
@@ -190,7 +190,7 @@ export namespace ConcentrationMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.3
              */
-            maxMeasuredValue: Attribute(0x2, TlvNullable(TlvFloat), { default: null }),
+            maxMeasuredValue: Attribute(0x2, TlvNullable(TlvFloat)),
 
             /**
              * Indicates the range of error or deviation that can be found in MeasuredValue and PeakMeasuredValue. This
@@ -220,14 +220,14 @@ export namespace ConcentrationMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.4
              */
-            peakMeasuredValue: Attribute(0x3, TlvNullable(TlvFloat), { default: null }),
+            peakMeasuredValue: Attribute(0x3, TlvNullable(TlvFloat)),
 
             /**
              * Indicates the window of time used for determining the PeakMeasuredValue. The value is in seconds.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.5
              */
-            peakMeasuredValueWindow: Attribute(0x4, TlvUInt32.bound({ max: 604800 }), { default: 1 })
+            peakMeasuredValueWindow: Attribute(0x4, TlvUInt32.bound({ max: 604800 }))
         }
     });
 
@@ -243,15 +243,14 @@ export namespace ConcentrationMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.6
              */
-            averageMeasuredValue: Attribute(0x5, TlvNullable(TlvFloat), { default: null }),
+            averageMeasuredValue: Attribute(0x5, TlvNullable(TlvFloat)),
 
             /**
-             * This attribute shall represent the window of time used for determining the AverageMeasuredValue. The
-             * value is in seconds.
+             * Indicates the window of time used for determining the AverageMeasuredValue. The value is in seconds.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.7
              */
-            averageMeasuredValueWindow: Attribute(0x6, TlvUInt32.bound({ max: 604800 }), { default: 1 })
+            averageMeasuredValueWindow: Attribute(0x6, TlvUInt32.bound({ max: 604800 }))
         }
     });
 
@@ -265,7 +264,7 @@ export namespace ConcentrationMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.11
              */
-            levelValue: Attribute(0xa, TlvEnum<LevelValue>(), { default: LevelValue.Unknown })
+            levelValue: Attribute(0xa, TlvEnum<LevelValue>())
         }
     });
 
@@ -281,7 +280,7 @@ export namespace ConcentrationMeasurement {
             numericMeasurement: BitFlag(0),
 
             /**
-             * Cluster supports basic level indication for substance using the ConcentrationLev el enum
+             * Cluster supports basic level indication for substance using the ConcentrationLevel enum
              */
             levelIndication: BitFlag(1),
 
@@ -311,7 +310,7 @@ export namespace ConcentrationMeasurement {
 
         attributes: {
             /**
-             * Indicates the medium in which MeasuredValue is being measured. See MeasurementMediumEnum.
+             * Indicates the medium in which MeasuredValue or LevelValue is being measured. See MeasurementMediumEnum.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.10.6.10
              */

package/src/clusters/content-control.ts

@@ -311,7 +311,8 @@ export namespace ContentControl {
      */
     export const TlvAppInfo = TlvObject({
         /**
-         * This field shall indicate the CSA-issued vendor ID for the catalog. The DIAL registry shall use value 0x0000.
+         * This field shall indicate the Connectivity Standards Alliance-issued vendor ID for the catalog. The DIAL
+         * registry shall use value 0x0000.
          *
          * Content App Platform providers will have their own catalog vendor ID (set to their own Vendor ID) and will
          * assign an ApplicationID to each Content App.
@@ -992,10 +993,9 @@ export namespace ContentControl {
              * activated. If this attribute equals FALSE, then playback of unrated content shall be permitted.
              * Otherwise, the media device shall prevent the playback of unrated content.
              *
-             * When this attribute changes, the device SHOULD make the user aware of any limits of this feature.
-             *
-             * For example, if the feature does not control content within apps, then the device should make this clear
-             * to the user when the attribute changes.
+             * When this attribute changes, the device SHOULD make the user aware of any limits of this feature. For
+             * example, if the feature does not control content within apps, then the device should make this clear to
+             * the user when the attribute changes.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 6.13.7.8
              */
@@ -1018,7 +1018,7 @@ export namespace ContentControl {
              * The purpose of this command is to specify whether programs with no Content rating must be blocked by this
              * media device.
              *
-             * Upon receipt of the UnblockUnratedContent command, the media device shall set the BlockUnrated attribute
+             * Upon receipt of the UnblockUnratedContent command, the media device shall set the BlockUn rated attribute
              * to FALSE.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 6.13.8.9
@@ -1376,6 +1376,8 @@ export namespace ContentControl {
      * responsibility of the end product to enforce appropriate right access (for example, to prevent a child from
      * disabling this feature).
      *
+     * NOTE Support for Content Control cluster is provisional.
+     *
      * ContentControlCluster supports optional features that you can enable with the ContentControlCluster.with()
      * factory method.
      *

package/src/clusters/content-launcher.ts

@@ -162,7 +162,7 @@ export namespace ContentLauncher {
         /**
          * This field shall indicate the color, in RGB or RGBA, used for styling different Video Player sections like
          * Logo, Watermark, etc. The value shall conform to the 6-digit or 8-digit format defined for CSS sRGB
-         * hexadecimal color notation. Examples:
+         * hexadecimal color notation [https://www.w3.org/TR/css-color-4/#hex-notation]. Examples:
          *
          *   • #76DE19 for R=0x76, G=0xDE, B=0x19, A absent
          *
@@ -542,7 +542,7 @@ export namespace ContentLauncher {
         Event = 4,
 
         /**
-         * A franchise is a video entity which can represent a number of video entities, like movies or TV shows.For
+         * A franchise is a video entity which can represent a number of video entities, like movies or TV shows. For
          * example, take the fictional franchise "Intergalactic Wars" which represents a collection of movie trilogies,
          * as well as animated and live action TV shows. This entity type was introduced to account for requests by
          * customers such as "Find Intergalactic Wars movies", which would search for all 'Intergalactic Wars' programs

package/src/clusters/descriptor.ts

@@ -7,7 +7,7 @@
 /*** THIS FILE IS GENERATED, DO NOT EDIT ***/
 
 import { MutableCluster } from "../cluster/mutation/MutableCluster.js";
-import { FixedAttribute, Attribute } from "../cluster/Cluster.js";
+import { FixedAttribute, Attribute, OptionalFixedAttribute } from "../cluster/Cluster.js";
 import { TlvArray } from "../tlv/TlvArray.js";
 import { TlvSemtag } from "../globals/Semtag.js";
 import { BitFlag } from "../schema/BitmapSchema.js";
@@ -17,6 +17,7 @@ import { TlvUInt16 } from "../tlv/TlvNumber.js";
 import { TypeFromSchema } from "../tlv/TlvSchema.js";
 import { TlvClusterId } from "../datatype/ClusterId.js";
 import { TlvEndpointNumber } from "../datatype/EndpointNumber.js";
+import { TlvString } from "../tlv/TlvString.js";
 import { Identity } from "#general";
 import { ClusterRegistry } from "../cluster/ClusterRegistry.js";
 
@@ -106,7 +107,7 @@ export namespace Descriptor {
     export const Base = MutableCluster.Component({
         id: 0x1d,
         name: "Descriptor",
-        revision: 2,
+        revision: 3,
 
         features: {
             /**
@@ -120,8 +121,8 @@ export namespace Descriptor {
 
         attributes: {
             /**
-             * This is a list of device types and corresponding revisions declaring endpoint conformance (see
-             * DeviceTypeStruct). At least one device type entry shall be present.
+             * This is a list of device types and corresponding revisions declaring endpoint conformance (see Section
+             * 9.5.5.1, “DeviceTypeStruct Type”). At least one device type entry shall be present.
              *
              * An endpoint shall conform to all device types listed in the DeviceTypeList. A cluster instance that is in
              * common for more than one device type in the DeviceTypeList shall be supported as a shared cluster
@@ -153,7 +154,24 @@ export namespace Descriptor {
              *
              * @see {@link MatterSpecification.v141.Core} § 9.5.6.4
              */
-            partsList: Attribute(0x3, TlvArray(TlvEndpointNumber), { default: [] })
+            partsList: Attribute(0x3, TlvArray(TlvEndpointNumber), { default: [] }),
+
+            /**
+             * Indicates an identifier which allows to uniquely identify the functionality exposed on an endpoint, and
+             * therefore shall be unique within the device. It is constructed in a manufacturer specific manner.
+             *
+             *   • If a globally unique identifier is used, the same rules as defined for the UniqueID attribute in the
+             *     Basic Information cluster apply.
+             *
+             *   • If the identifier is only unique in the scope of the device, and cannot be used to track the device,
+             *     then it may remain unchanged at factory reset.
+             *
+             * The value does not need to be human readable, since it is intended for machine to machine (M2M)
+             * communication.
+             *
+             * @see {@link MatterSpecification.v141.Core} § 9.5.6.6
+             */
+            endpointUniqueId: OptionalFixedAttribute(0x5, TlvString.bound({ maxLength: 32 }))
         },
 
         /**
@@ -180,8 +198,8 @@ export namespace Descriptor {
      * This cluster supports a list of one or more device type identifiers that represent conformance to device type
      * specifications.
      *
-     * The cluster supports a PartsList attribute that is a list of zero or more endpoints to support a composed device
-     * type.
+     * The cluster supports a PartsList attribute that is a list of zero or more endpoints to support compound devices
+     * or composed device types.
      *
      * DescriptorCluster supports optional features that you can enable with the DescriptorCluster.with() factory
      * method.

package/src/clusters/device-energy-management-mode.ts

@@ -191,6 +191,9 @@ export namespace DeviceEnergyManagementMode {
          * 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