@matter/types 0.13.1-alpha.0-20250508-047aa0277 → 0.13.1-alpha.0-20250511-74ef153aa

package/src/clusters/smoke-co-alarm.ts

@@ -85,13 +85,16 @@ export namespace SmokeCoAlarm {
     }
 
     /**
-     * This value shall indicate that the smoke sensor has nominal contamination levels, no customer action is required.
-     *
      * @see {@link MatterSpecification.v14.Cluster} § 2.11.5.6
      */
     export enum ContaminationState {
         /**
          * Nominal state, the sensor is not contaminated
+         *
+         * This value shall indicate that the smoke sensor has nominal contamination levels, no customer action is
+         * required.
+         *
+         * @see {@link MatterSpecification.v14.Cluster} § 2.11.5.6.1
          */
         Normal = 0,
 
@@ -232,13 +235,15 @@ export namespace SmokeCoAlarm {
     export interface InterconnectCoAlarmEvent extends TypeFromSchema<typeof TlvInterconnectCoAlarmEvent> {}
 
     /**
-     * This value shall indicate that this alarm is not alarming.
-     *
      * @see {@link MatterSpecification.v14.Cluster} § 2.11.5.3
      */
     export enum ExpressedState {
         /**
          * Nominal state, the device is not alarming
+         *
+         * This value shall indicate that this alarm is not alarming.
+         *
+         * @see {@link MatterSpecification.v14.Cluster} § 2.11.5.3.1
          */
         Normal = 0,
 
@@ -537,8 +542,8 @@ export namespace SmokeCoAlarm {
             deviceMuted: OptionalAttribute(0x4, TlvEnum<MuteState>(), { persistent: true }),
 
             /**
-             * Indicates whether the device self-test is currently activated. If the device self- test is activated,
-             * this attribute shall be set to True, otherwise it shall be set to False.
+             * Indicates whether the device self-test is currently activated. If the device self-test is activated, this
+             * attribute shall be set to True, otherwise it shall be set to False.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 2.11.6.6
              */

package/src/clusters/software-diagnostics.ts

@@ -154,7 +154,7 @@ export namespace SoftwareDiagnostics {
              *
              *   • The CurrentHeapHighWatermark attribute This command has no payload.
              *
-             * Effect on Receipt
+             * ### Effect on Receipt
              *
              * On receipt of this command, the Node shall make the following modifications to attributes it supports:
              *

package/src/clusters/switch.ts

@@ -294,13 +294,13 @@ export namespace Switch {
              *   • a value of N when there were exactly N presses in a multi-press sequence (and the sequence has
              *     ended).
              *
-             * NOTE
+             *     > [!NOTE]
              *
-             * The introduction of TotalNumberOfPressesCounted supporting the value 0 may impact clients of switches
-             * using cluster revision 1 since such servers would not use this value of TotalNumberOfPressesCounted to
-             * indicate an aborted sequence. Clients SHOULD always act using the TotalNumberOfPressesCounted field taken
-             * into account since for values from 1 to MultiPressMax, the user action that led to the event was
-             * different depending on the count.
+             *     > The introduction of TotalNumberOfPressesCounted supporting the value 0 may impact clients of
+             *       switches using cluster revision 1 since such servers would not use this value of
+             *       TotalNumberOfPressesCounted to indicate an aborted sequence. Clients SHOULD always act using the
+             *       TotalNumberOfPressesCounted field taken into account since for values from 1 to MultiPressMax, the
+             *       user action that led to the event was different depending on the count.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 1.13.6.7
              */

package/src/clusters/thermostat.ts

@@ -412,7 +412,7 @@ export namespace Thermostat {
         /**
          * Users are on vacation
          *
-         * This value shall indicate the preset for periods when users are on vacation, or otherwise out-of- home for
+         * This value shall indicate the preset for periods when users are on vacation, or otherwise out-of-home for
          * extended periods of time.
          *
          * @see {@link MatterSpecification.v14.Cluster} § 4.3.8.22.6
@@ -448,7 +448,7 @@ export namespace Thermostat {
         automatic: BitFlag(0),
 
         /**
-         * Preset supports user- provided names
+         * Preset supports user-provided names
          */
         supportsNames: BitFlag(1)
     };
@@ -1058,9 +1058,9 @@ export namespace Thermostat {
     };
 
     /**
-     * NOTE
+     * > [!NOTE]
      *
-     * CoolingAndHeating
+     * > CoolingAndHeating
      *
      * A thermostat indicating it supports CoolingAndHeating (or CoolingAndHeatingWithReheat) SHOULD be able to request
      * heating or cooling on demand and will usually support the Auto SystemMode.
@@ -1444,7 +1444,7 @@ export namespace Thermostat {
              * Indicates the absolute minimum level that the heating setpoint may be set to. This is a limitation
              * imposed by the manufacturer.
              *
-             * Refer to Setpoint Limits for constraints
+             * ### Refer to Setpoint Limits for constraints
              *
              * @see {@link MatterSpecification.v14.Cluster} § 4.3.9.5
              */
@@ -1471,9 +1471,8 @@ export namespace Thermostat {
              * If an attempt is made to set this attribute to a value greater than MaxHeatSetpointLimit or less than
              * MinHeatSetpointLimit, a response with the status code CONSTRAINT_ERROR shall be returned.
              *
-             * If this attribute is set to a value that is greater than
-             *
-             * Band), the value of OccupiedCoolingSetpoint shall be adjusted to (OccupiedHeatingSetpoint +
+             * If this attribute is set to a value that is greater than (OccupiedCoolingSetpoint - MinSetpointDeadBand),
+             * the value of OccupiedCoolingSetpoint shall be adjusted to (OccupiedHeatingSetpoint +
              * MinSetpointDeadBand).
              *
              * If the occupancy status of the room is unknown, this attribute shall be used as the heating mode
@@ -1541,7 +1540,7 @@ export namespace Thermostat {
              * Indicates the absolute maximum level that the cooling setpoint may be set to. This is a limitation
              * imposed by the manufacturer.
              *
-             * Refer to Setpoint Limits for constraints
+             * ### Refer to Setpoint Limits for constraints
              *
              * @see {@link MatterSpecification.v14.Cluster} § 4.3.9.8
              */
@@ -1631,10 +1630,10 @@ export namespace Thermostat {
              * (e.g., out of the range supported by the Thermostat server), the Thermostat server shall respond with a
              * status of SUCCESS and set the value of LocalTemperatureCalibration to the upper or lower limit reached.
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * Prior to revision 8 of this cluster specification the value of this attribute was constrained to a range
-             * of -2.5°C to 2.5°C.
+             * > Prior to revision 8 of this cluster specification the value of this attribute was constrained to a
+             *   range of -2.5°C to 2.5°C.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 4.3.9.12
              */
@@ -1688,8 +1687,7 @@ export namespace Thermostat {
              *
              * If this attribute is set to a value that is greater than (UnoccupiedCoolingSetpoint -
              * MinSetpointDeadBand), the value of UnoccupiedCoolingSetpoint shall be adjusted to
-             *
-             * + MinSetpointDeadBand).
+             * (UnoccupiedHeatingSetpoint + MinSetpointDeadBand).
              *
              * If the occupancy status of the room is unknown, this attribute shall NOT be used.
              *
@@ -1714,12 +1712,10 @@ export namespace Thermostat {
              *
              * Refer to Setpoint Limits for constraints.
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * Prior to revision 8 of this cluster specification the value of this attribute was constrained to a range
-             * of 0°C to 2.5°C.
-             *
-             * NOTE
+             * > Prior to revision 8 of this cluster specification the value of this attribute was constrained to a
+             *   range of 0°C to 2.5°C.
              *
              * For backwards compatibility, this attribute is optionally writeable. However any writes to this attribute
              * shall be silently ignored.
@@ -1824,8 +1820,9 @@ export namespace Thermostat {
              * Indicates the amount that the Thermostat server will allow the Calculated Local Temperature to float
              * above the OccupiedCoolingSetpoint (i.e., OccupiedCoolingSetpoint + OccupiedSetback) or below the
              * OccupiedHeatingSetpoint setpoint (i.e., OccupiedHeatingSetpoint – OccupiedSetback) before initiating a
-             * state change to bring the temperature back to the user’s desired setpoint. This attribute is sometimes
-             * also referred to as the “span.”
+             * state change to bring the temperature back to the user’s
+             *
+             * desired setpoint. This attribute is sometimes also referred to as the “span.”
              *
              * The purpose of this attribute is to allow remote configuration of the span between the desired setpoint
              * and the measured temperature to help prevent over-cycling and reduce energy bills, though this may result
@@ -2007,8 +2004,8 @@ export namespace Thermostat {
              *     a. If the BuiltIn field is null:
              *
              *       i. If there is a PresetStruct in the current value with a matching PresetHandle field, the BuiltIn
-             *           field on the pending PresetStruct shall be set to the value of the BuiltIn on the matching
-             *           PresetStruct.
+             *          field on the pending PresetStruct shall be set to the value of the BuiltIn on the matching
+             *          PresetStruct.
              *
              *       ii. Otherwise, the BuiltIn field on the pending PresetStruct shall be set to false.
              *
@@ -2021,11 +2018,11 @@ export namespace Thermostat {
              *        PresetStruct, the server shall check for invalid removal of the PresetStruct:
              *
              *       i. If the BuiltIn field is true on the removed PresetStruct, the attribute status shall be
-             *            CONSTRAINT_ERROR.
+             *          CONSTRAINT_ERROR.
              *
              *       ii. If the MSCH feature is supported and the removed PresetHandle would be referenced by any
-             *            PresetHandle on any ScheduleTransitionStruct on any ScheduleStruct in the updated value of the
-             *            Schedules attribute, the attribute status shall be INVALID_IN_STATE.
+             *           PresetHandle on any ScheduleTransitionStruct on any ScheduleStruct in the updated value of the
+             *           Schedules attribute, the attribute status shall be INVALID_IN_STATE.
              *
              *       iii. If the removed PresetHandle is equal to the value of the ActivePresetHandle attribute, the
              *            attribute status shall be INVALID_IN_STATE.
@@ -2109,11 +2106,11 @@ export namespace Thermostat {
              *        modification of an existing schedule.
              *
              *       i. If the value of the ScheduleHandle field does not match any of the existing schedules, a
-             *            response with the status code NOT_FOUND shall be returned.
+             *          response with the status code NOT_FOUND shall be returned.
              *
              *       ii. If the BuiltIn field is true, and the ScheduleStruct in the current value with a matching
-             *            ScheduleHandle field has a BuiltIn field set to false, a response with the status code
-             *            CONSTRAINT_ERROR shall be returned.
+             *           ScheduleHandle field has a BuiltIn field set to false, a response with the status code
+             *           CONSTRAINT_ERROR shall be returned.
              *
              *       iii. If the BuiltIn field is false, and the ScheduleStruct in the current value with a matching
              *            ScheduleHandle field has a BuiltIn field set to true, a response with the status code
@@ -2150,8 +2147,8 @@ export namespace Thermostat {
              *        PresetHandle field, a response with the status code CONSTRAINT_ERROR shall be returned.
              *
              *       i. If the SystemMode field is present, but the ScheduleTypeStruct matching the value of the
-             *           SystemMode field on the encompassing ScheduleStruct does not have the SupportsSetpoints bit
-             *           set, a response with the status code CONSTRAINT_ERROR shall be returned.
+             *          SystemMode field on the encompassing ScheduleStruct does not have the SupportsSetpoints bit set,
+             *          a response with the status code CONSTRAINT_ERROR shall be returned.
              *
              *       ii. If the SystemMode field is has a value of SystemModeOff, but the ScheduleTypeStruct matching
              *           the value of the SystemMode field on the encompassing ScheduleStruct does not have the
@@ -2181,8 +2178,8 @@ export namespace Thermostat {
              *     a. If the BuiltIn field is null:
              *
              *       i. If there is a ScheduleStruct in the current value with a matching ScheduleHandle field, the
-             *           BuiltIn field on the pending ScheduleStruct shall be set to the value of the BuiltIn on the
-             *           matching ScheduleStruct.
+             *          BuiltIn field on the pending ScheduleStruct shall be set to the value of the BuiltIn on the
+             *          matching ScheduleStruct.
              *
              *       ii. Otherwise, the BuiltIn field on the pending ScheduleStruct shall be set to false.
              *
@@ -2195,7 +2192,7 @@ export namespace Thermostat {
              *        ScheduleStruct, the server shall check for invalid removal of the ScheduleStruct:
              *
              *       i. If the BuiltIn field is true on the removed ScheduleStruct, the attribute status shall be
-             *           CONSTRAINT_ERROR.
+             *          CONSTRAINT_ERROR.
              *
              *       ii. If the removed ScheduleHandle is equal to the value of the ActiveScheduleHandle attribute, the
              *           attribute status shall be INVALID_IN_STATE.
@@ -2323,10 +2320,9 @@ export namespace Thermostat {
 
             /**
              * Indicates the HVAC system type controlled by the thermostat. If the thermostat uses physical DIP switches
-             * to set these parameters, this information shall be available read-only
-             *
-             * from the DIP switches. If these parameters are set via software, there shall be read/write access in
-             * order to provide remote programming capability.
+             * to set these parameters, this information shall be available read-only from the DIP switches. If these
+             * parameters are set via software, there shall be read/write access in order to provide remote programming
+             * capability.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 4.3.9.11
              * @deprecated
@@ -2393,7 +2389,7 @@ export namespace Thermostat {
              * If the server supports a setpoint hold for a specific duration, it SHOULD also implement the
              * SetpointHoldExpiryTimestamp attribute.
              *
-             * If this attribute is updated to SetpointHoldOn and the TemperatureSetpointHoldDuration has a non- null
+             * If this attribute is updated to SetpointHoldOn and the TemperatureSetpointHoldDuration has a non-null
              * value and the SetpointHoldExpiryTimestamp is supported, the server shall update the
              * SetpointHoldExpiryTimestamp with a value of current UTC timestamp, in seconds, plus the value in
              * TemperatureSetpointHoldDuration multiplied by 60.
@@ -2442,10 +2438,10 @@ export namespace Thermostat {
              * When ScheduleActive is not set, the setpoint is altered only by manual up/down changes at the thermostat
              * or remotely, not by internal schedule programming.
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * Modifying the ScheduleActive bit does not clear or delete previous weekly schedule programming
-             * configurations.
+             * > Modifying the ScheduleActive bit does not clear or delete previous weekly schedule programming
+             *   configurations.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 4.3.9.32
              */
@@ -2673,44 +2669,6 @@ export namespace Thermostat {
     /**
      * This cluster provides an interface to the functionality of a thermostat.
      *
-     * Optional temperature, humidity and occupancy sensors
-     *
-     * Thermostat
-     *
-     * Heating / cooling control panel
-     *
-     * C
-     *
-     * Dehumidification configuration
-     *
-     * Dehumidification notification
-     *
-     * ThermostatS
-     *
-     * Heating / cooling device (e.g. indoor air handler)
-     *
-     * S
-     *
-     * user interface S
-     *
-     * configuration
-     *
-     * C
-     *
-     * Configuration tool
-     *
-     * Thermostat configuration
-     *
-     * C C Fan control S
-     *
-     * ThermostatS notification C
-     *
-     * C = Client S = Server
-     *
-     * Note: Device names are examples for illustration purposes only
-     *
-     * Figure 15. Example Usage of the Thermostat and Related Clusters"
-     *
      * Per the Matter specification you cannot use {@link ThermostatCluster} without enabling certain feature
      * combinations. You must use the {@link with} factory method to obtain a working cluster.
      *

package/src/clusters/thread-border-router-management.ts

@@ -33,11 +33,11 @@ export namespace ThreadBorderRouterManagement {
          * This feature shall indicate the ability of the Border Router to change its already configured PAN to another,
          * by setting a pending dataset.
          *
-         * NOTE
+         * > [!NOTE]
          *
-         * This feature flag can be used to protect an already-configured network from accidental configuration change,
-         * e.g. when the Thread Border Router serves non-Matter devices that do not support PAN change for an
-         * implementation-specific reason.
+         * > This feature flag can be used to protect an already-configured network from accidental configuration
+         *   change, e.g. when the Thread Border Router serves non- Matter devices that do not support PAN change for an
+         *   implementation-specific reason.
          *
          * @see {@link MatterSpecification.v14.Cluster} § 10.3.4.1
          */
@@ -164,11 +164,11 @@ export namespace ThreadBorderRouterManagement {
              * This feature shall indicate the ability of the Border Router to change its already configured PAN to
              * another, by setting a pending dataset.
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * This feature flag can be used to protect an already-configured network from accidental configuration
-             * change, e.g. when the Thread Border Router serves non-Matter devices that do not support PAN change for
-             * an implementation-specific reason.
+             * > This feature flag can be used to protect an already-configured network from accidental configuration
+             *   change, e.g. when the Thread Border Router serves non- Matter devices that do not support PAN change
+             *   for an implementation-specific reason.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 10.3.4.1
              */

package/src/clusters/thread-network-diagnostics.ts

@@ -681,11 +681,10 @@ export namespace ThreadNetworkDiagnostics {
             txAckedCount: OptionalAttribute(0x1a, TlvUInt32, { omitChanges: true, default: 0 }),
 
             /**
-             * The TxNoAckRequestedCount attribute shall indicate the total number of unique MAC frame
-             *
-             * transmission requests without requested acknowledgment. The TxNoAckRequestedCount attribute shall only be
-             * incremented by 1 for each MAC transmission request that is does not request acknowledgement regardless of
-             * the amount of CCA failures, CSMA-CA attempts, or retransmissions.
+             * The TxNoAckRequestedCount attribute shall indicate the total number of unique MAC frame transmission
+             * requests without requested acknowledgment. The TxNoAckRequestedCount attribute shall only be incremented
+             * by 1 for each MAC transmission request that is does not request acknowledgement regardless of the amount
+             * of CCA failures, CSMA-CA attempts, or retransmissions.
              *
              * @see {@link MatterSpecification.v14.Core} § 11.14.6.28
              */
@@ -751,11 +750,10 @@ export namespace ThreadNetworkDiagnostics {
             txRetryCount: OptionalAttribute(0x21, TlvUInt32, { omitChanges: true, default: 0 }),
 
             /**
-             * The TxDirectMaxRetryExpiryCount attribute shall indicate the total number of unique MAC
-             *
-             * transmission packets that meet maximal retry limit for direct packets. The TxDirectMaxRetryExpiryCount
-             * attribute shall only be incremented by 1 for each unique MAC transmission packets that meets the maximal
-             * retry limit for direct packets. This value shall only be reset upon a Node reboot.
+             * The TxDirectMaxRetryExpiryCount attribute shall indicate the total number of unique MAC transmission
+             * packets that meet maximal retry limit for direct packets. The TxDirectMaxRetryExpiryCount attribute shall
+             * only be incremented by 1 for each unique MAC transmission packets that meets the maximal retry limit for
+             * direct packets. This value shall only be reset upon a Node reboot.
              *
              * @see {@link MatterSpecification.v14.Core} § 11.14.6.35
              */
@@ -824,9 +822,8 @@ export namespace ThreadNetworkDiagnostics {
             rxBroadcastCount: OptionalAttribute(0x29, TlvUInt32, { omitChanges: true, default: 0 }),
 
             /**
-             * The RxDataCount attribute shall indicate the total number of received unique MAC Data frames.
-             *
-             * This value shall only be reset upon a Node reboot.
+             * The RxDataCount attribute shall indicate the total number of received unique MAC Data frames. This value
+             * shall only be reset upon a Node reboot.
              *
              * @see {@link MatterSpecification.v14.Core} § 11.14.6.43
              */
@@ -902,9 +899,8 @@ export namespace ThreadNetworkDiagnostics {
 
             /**
              * The RxErrUnknownNeighborCount attribute shall indicate the total number of received unique MAC frame
-             * requests that have been dropped as a result of originating from an unknown neighbor
-             *
-             * device. This value shall only be reset upon a Node reboot.
+             * requests that have been dropped as a result of originating from an unknown neighbor device. This value
+             * shall only be reset upon a Node reboot.
              *
              * @see {@link MatterSpecification.v14.Core} § 11.14.6.52
              */
@@ -999,10 +995,9 @@ export namespace ThreadNetworkDiagnostics {
 
             /**
              * The RoutingRole attribute shall indicate the role that this Node has within the routing of messages
-             * through the Thread network, as defined by RoutingRoleEnum. The potential roles are defined
-             *
-             * in the following table. A value of null shall indicate that the Thread interface is not currently
-             * configured or operational.
+             * through the Thread network, as defined by RoutingRoleEnum. The potential roles are defined in the
+             * following table. A value of null shall indicate that the Thread interface is not currently configured or
+             * operational.
              *
              * @see {@link MatterSpecification.v14.Core} § 11.14.6.2
              */

package/src/clusters/thread-network-directory.ts

@@ -183,9 +183,9 @@ export namespace ThreadNetworkDirectory {
             threadNetworks: Attribute(0x1, TlvArray(TlvThreadNetwork), { persistent: true, default: [] }),
 
             /**
-             * Indicates the maximum number of entries that can be held in the ThreadNetworks list; it shall be at least
-             * 2 times the number of SupportedFabrics advertised in the Operational Credentials Cluster on the root
-             * endpoint of this node.
+             * This attribute shall indicate the maximum number of entries that can be held in the ThreadNetworks list;
+             * it shall be at least 2 times the number of SupportedFabrics advertised in the Operational Credentials
+             * Cluster on the root endpoint of this node.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 10.4.5.3
              */

package/src/clusters/time-synchronization.ts

@@ -402,14 +402,14 @@ export namespace TimeSynchronization {
         SecondsGranularity = 2,
 
         /**
-         * This indicates the node is synchronized to an upstream source using high resolution time- synchronization
+         * This indicates the node is synchronized to an upstream source using high resolution time-synchronization
          * protocol such as NTP, or has built-in GNSS with some amount of jitter applying its GNSS timestamp. UTC Time
          * is accurate to ± 50 ms.
          */
         MillisecondsGranularity = 3,
 
         /**
-         * This indicates the node is synchronized to an upstream source using a highly precise time- synchronization
+         * This indicates the node is synchronized to an upstream source using a highly precise time-synchronization
          * protocol such as PTP, or has built-in GNSS. UTC time is accurate to ± 10 μs.
          */
         MicrosecondsGranularity = 4
@@ -790,8 +790,7 @@ export namespace TimeSynchronization {
              * This command is used to set the DST offsets for a node.
              *
              *   • If the length of DSTOffset is larger than DSTOffsetListMaxSize, the node shall respond with
-             *
-             * RESOURCE_EXHAUSTED.
+             *     RESOURCE_EXHAUSTED.
              *
              *   • Else if the list entries do not conform to the list requirements for DSTOffset attribute, the node
              *     shall respond with CONSTRAINT_ERROR.
@@ -950,9 +949,8 @@ export namespace TimeSynchronization {
              * time source, it may send a Granularity of NoTimeGranularity.
              *
              * Upon receipt of this command, the node may update its UTCTime attribute to match the time specified in
-             * the command, if the stated Granularity and TimeSource are acceptable. The node shall
-             *
-             * update its UTCTime attribute if its current Granularity is NoTimeGranularity.
+             * the command, if the stated Granularity and TimeSource are acceptable. The node shall update its UTCTime
+             * attribute if its current Granularity is NoTimeGranularity.
              *
              * If the time is updated, the node shall also update its Granularity attribute based on the granularity
              * specified in the command and the expected clock drift of the node. This SHOULD normally be one level

package/src/clusters/wake-on-lan.ts

@@ -34,14 +34,14 @@ export namespace WakeOnLan {
             macAddress: OptionalFixedAttribute(0x0, TlvString.bound({ maxLength: 12 })),
 
             /**
-             * Indicates the current link-local address of the device. Only 128-bit IPv6 link- local addresses shall be
+             * Indicates the current link-local address of the device. Only 128-bit IPv6 link-local addresses shall be
              * used for this attribute.
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * Some companies may consider MAC Address to be protected data subject to PII handling considerations and
-             * will therefore choose not to include it or read it. The MAC Address can often be determined using ARP in
-             * IPv4 or NDP in IPv6.
+             * > Some companies may consider MAC Address to be protected data subject to PII handling considerations and
+             *   will therefore choose not to include it or read it. The MAC Address can often be determined using ARP
+             *   in IPv4 or NDP in IPv6.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 1.12.4.2
              */

package/src/clusters/water-heater-management.ts

@@ -220,7 +220,7 @@ export namespace WaterHeaterManagement {
              * For example, if the target temperature was 60°C, the current temperature was 20°C and the tank volume was
              * 100L:
              *
-             * Mass of water = 1kg per Litre
+             * ### Mass of water = 1kg per Litre
              *
              * Total Mass = 100 x 1kg = 100kg
              *
@@ -228,24 +228,28 @@ export namespace WaterHeaterManagement {
              *
              * = (60°C - 20°C) = 40°C
              *
-             * Energy required to
+             * ### Energy required to
              *
              * heat the water to 60°C = 4182 x 40 x 100 = 16,728,000 J
              *
              * Converting Joules in to Wh of heat (divide by 3600):
              *
+             * = 16,728,000 J / 3600
+             *
+             * = 4647 Wh (4.65kWh)
+             *
              * If the TankPercent feature is supported, then this estimate shall also take into account the percentage
              * of the water in the tank which is already hot.
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * The electrical energy required to heat the water depends on the heating system used to heat the water.
-             * For example, a direct electric immersion heating element can be close to 100% efficient, so the
-             * electrical energy needed to heat the hot water is nearly the same as the EstimatedHeatEnergyRequired.
-             * However some forms of heating, such as an air-source heat pump which extracts heat from ambient air,
-             * requires much less electrical energy to heat hot water. Heat pumps can be produce 3kWh of heat output for
-             * 1kWh of electrical energy input. The conversion between heat energy and electrical energy is outside the
-             * scope of this cluster.
+             * > The electrical energy required to heat the water depends on the heating system used to heat the water.
+             *   For example, a direct electric immersion heating element can be close to 100% efficient, so the
+             *   electrical energy needed to heat the hot water is nearly the same as the EstimatedHeatEnergyRequired.
+             *   However some forms of heating, such as an air-source heat pump which extracts heat from ambient air,
+             *   requires much less electrical energy to heat hot water. Heat pumps can be produce 3kWh of heat output
+             *   for 1kWh of electrical energy input. The conversion between heat energy and electrical energy is
+             *   outside the scope of this cluster.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 9.5.7.4
              */
@@ -283,7 +287,7 @@ export namespace WaterHeaterManagement {
              *
              * TankPercentage = min( max(TankPercentage,0), 100)
              *
-             * TankPercentage = 50%
+             * ### TankPercentage = 50%
              *
              * @see {@link MatterSpecification.v14.Cluster} § 9.5.7.5
              */
@@ -333,9 +337,7 @@ export namespace WaterHeaterManagement {
             heatDemand: Attribute(0x1, TlvBitmap(TlvUInt8, WaterHeaterHeatSource)),
 
             /**
-             * Indicates whether the Boost, as triggered by a Boost command, is currently
-             *
-             * Active or Inactive.
+             * Indicates whether the Boost, as triggered by a Boost command, is currently Active or Inactive.
              *
              * See Boost and CancelBoost commands for more details.
              *

package/src/clusters/water-heater-mode.ts

@@ -178,9 +178,8 @@ export namespace WaterHeaterMode {
          * 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
+         * 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

package/src/clusters/wi-fi-network-management.ts

@@ -50,12 +50,12 @@ export namespace WiFiNetworkManagement {
              * A value of null shall indicate that no primary Wi-Fi network is available (e.g. because the Wi-Fi network
              * has not yet been configured by the user).
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * The SSID in Wi-Fi is a collection of 1-32 bytes, the text encoding of which is not specified.
-             * Implementations must be careful to support transferring these byte strings without requiring a particular
-             * encoding. The most common encoding is UTF-8, however this is just a convention. Some configurations may
-             * use Latin-1 or other character sets.
+             * > The SSID in Wi-Fi is a collection of 1-32 bytes, the text encoding of which is not specified.
+             *   Implementations must be careful to support transferring these byte strings without requiring a
+             *   particular encoding. The most common encoding is UTF- 8, however this is just a convention. Some
+             *   configurations may use Latin-1 or other character sets.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 10.2.4.1
              */
@@ -77,13 +77,11 @@ export namespace WiFiNetworkManagement {
              * It is recommended that servers implement this attribute as either a timestamp or a counter. When
              * implemented as a counter it SHOULD be initialized with a random value.
              *
-             * NOTE
+             * > [!NOTE]
              *
-             * The passphrase itself is not exposed as an attribute to avoid its unintentional retrieval or caching by
-             * clients that use wildcard reads or otherwise routinely read all available attributes. It can be retrieved
-             * using the NetworkPassphraseRequest
-             *
-             * command.
+             * > The passphrase itself is not exposed as an attribute to avoid its unintentional retrieval or caching by
+             *   clients that use wildcard reads or otherwise routinely read all available attributes. It can be
+             *   retrieved using the NetworkPassphraseRequest command.
              *
              * @see {@link MatterSpecification.v14.Cluster} § 10.2.4.2
              */