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

package/src/standard/elements/Thermostat.ts

@@ -18,50 +18,9 @@ import {
 export const Thermostat = Cluster(
     {
         name: "Thermostat", id: 0x201, asOf: "1.3", classification: "application", pics: "TSTAT",
-
-        details: "This cluster provides an interface to the functionality of a thermostat." +
-            "\n" +
-            "Optional temperature, humidity and occupancy sensors" +
-            "\n" +
-            "Thermostat" +
-            "\n" +
-            "Heating / cooling control panel" +
-            "\n" +
-            "C" +
-            "\n" +
-            "Dehumidification configuration" +
-            "\n" +
-            "Dehumidification notification" +
-            "\n" +
-            "ThermostatS" +
-            "\n" +
-            "Heating / cooling device (e.g. indoor air handler)" +
-            "\n" +
-            "S" +
-            "\n" +
-            "user interface S" +
-            "\n" +
-            "configuration" +
-            "\n" +
-            "C" +
-            "\n" +
-            "Configuration tool" +
-            "\n" +
-            "Thermostat configuration" +
-            "\n" +
-            "C C Fan control S" +
-            "\n" +
-            "ThermostatS notification C" +
-            "\n" +
-            "C = Client S = Server" +
-            "\n" +
-            "Note: Device names are examples for illustration purposes only" +
-            "\n" +
-            "Figure 15. Example Usage of the Thermostat and Related Clusters\"",
-
+        details: "This cluster provides an interface to the functionality of a thermostat.",
         xref: { document: "cluster", section: "4.3" }
     },
-
     Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 8 }),
 
     Attribute(
@@ -150,7 +109,7 @@ export const Thermostat = Cluster(
         details: "Indicates the absolute minimum level that the heating setpoint may be set to. This is a limitation " +
             "imposed by the manufacturer." +
             "\n" +
-            "Refer to Setpoint Limits for constraints",
+            "### Refer to Setpoint Limits for constraints",
         xref: { document: "cluster", section: "4.3.9.5" }
     }),
 
@@ -171,7 +130,7 @@ export const Thermostat = Cluster(
         details: "Indicates the absolute maximum level that the cooling setpoint may be set to. This is a limitation " +
             "imposed by the manufacturer." +
             "\n" +
-            "Refer to Setpoint Limits for constraints",
+            "### Refer to Setpoint Limits for constraints",
         xref: { document: "cluster", section: "4.3.9.8" }
     }),
 
@@ -199,10 +158,9 @@ export const Thermostat = Cluster(
         name: "HvacSystemTypeConfiguration", id: 0x9, type: "HVACSystemTypeBitmap", access: "R[W] VM",
         conformance: "D", constraint: "desc", default: 0, quality: "N",
         details: "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" +
-            "\n" +
-            "from the DIP switches. If these parameters are set via software, there shall be read/write access in " +
-            "order to provide remote programming capability.",
+            "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.",
         xref: { document: "cluster", section: "4.3.9.11" }
     }),
 
@@ -222,10 +180,10 @@ export const Thermostat = Cluster(
             "respond with a status of SUCCESS and set the value of LocalTemperatureCalibration to the upper or " +
             "lower limit reached." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "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.",
 
         xref: { document: "cluster", section: "4.3.9.12" }
     }),
@@ -264,10 +222,9 @@ export const Thermostat = Cluster(
             "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." +
             "\n" +
-            "If this attribute is set to a value that is greater than" +
-            "\n" +
-            "Band), the value of OccupiedCoolingSetpoint shall be adjusted to (OccupiedHeatingSetpoint + " +
-            "MinSetpointDeadBand)." +
+            "If this attribute is set to a value that is greater than (OccupiedCoolingSetpoint - " +
+            "MinSetpointDeadBand), the value of OccupiedCoolingSetpoint shall be adjusted to " +
+            "(OccupiedHeatingSetpoint + MinSetpointDeadBand)." +
             "\n" +
             "If the occupancy status of the room is unknown, this attribute shall be used as the heating mode " +
             "setpoint." +
@@ -315,9 +272,8 @@ export const Thermostat = Cluster(
             "than MinHeatSetpointLimit, a response with the status code CONSTRAINT_ERROR shall be returned." +
             "\n" +
             "If this attribute is set to a value that is greater than (UnoccupiedCoolingSetpoint - " +
-            "MinSetpointDeadBand), the value of UnoccupiedCoolingSetpoint shall be adjusted to" +
-            "\n" +
-            "+ MinSetpointDeadBand)." +
+            "MinSetpointDeadBand), the value of UnoccupiedCoolingSetpoint shall be adjusted to " +
+            "(UnoccupiedHeatingSetpoint + MinSetpointDeadBand)." +
             "\n" +
             "If the occupancy status of the room is unknown, this attribute shall NOT be used." +
             "\n" +
@@ -402,12 +358,10 @@ export const Thermostat = Cluster(
             "\n" +
             "Refer to Setpoint Limits for constraints." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "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." +
-            "\n" +
-            "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." +
             "\n" +
             "For backwards compatibility, this attribute is optionally writeable. However any writes to this " +
             "attribute shall be silently ignored.",
@@ -503,8 +457,8 @@ export const Thermostat = Cluster(
             "If the server supports a setpoint hold for a specific duration, it SHOULD also implement the " +
             "SetpointHoldExpiryTimestamp attribute." +
             "\n" +
-            "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 " +
+            "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." +
             "\n" +
@@ -549,10 +503,10 @@ export const Thermostat = Cluster(
             "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." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "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.",
 
         xref: { document: "cluster", section: "4.3.9.32" }
     }),
@@ -605,8 +559,9 @@ export const Thermostat = Cluster(
         details: "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.”" +
+            "a state change to bring the temperature back to the user’s" +
+            "\n" +
+            "desired setpoint. This attribute is sometimes also referred to as the “span.”" +
             "\n" +
             "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 " +
@@ -911,8 +866,8 @@ export const Thermostat = Cluster(
                 "    a. If the BuiltIn field is null:" +
                 "\n" +
                 "      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." +
+                "         BuiltIn field on the pending PresetStruct shall be set to the value of the BuiltIn on the " +
+                "         matching PresetStruct." +
                 "\n" +
                 "      ii. Otherwise, the BuiltIn field on the pending PresetStruct shall be set to false." +
                 "\n" +
@@ -925,11 +880,11 @@ export const Thermostat = Cluster(
                 "       PresetStruct, the server shall check for invalid removal of the PresetStruct:" +
                 "\n" +
                 "      i. If the BuiltIn field is true on the removed PresetStruct, the attribute status shall be " +
-                "           CONSTRAINT_ERROR." +
+                "         CONSTRAINT_ERROR." +
                 "\n" +
                 "      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." +
                 "\n" +
                 "      iii. If the removed PresetHandle is equal to the value of the ActivePresetHandle attribute, " +
                 "           the attribute status shall be INVALID_IN_STATE." +
@@ -961,11 +916,11 @@ export const Thermostat = Cluster(
                 "       modification of an existing schedule." +
                 "\n" +
                 "      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." +
                 "\n" +
                 "      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." +
                 "\n" +
                 "      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 " +
@@ -1002,8 +957,8 @@ export const Thermostat = Cluster(
                 "       PresetHandle field, a response with the status code CONSTRAINT_ERROR shall be returned." +
                 "\n" +
                 "      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." +
                 "\n" +
                 "      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 " +
@@ -1034,8 +989,8 @@ export const Thermostat = Cluster(
                 "    a. If the BuiltIn field is null:" +
                 "\n" +
                 "      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." +
                 "\n" +
                 "      ii. Otherwise, the BuiltIn field on the pending ScheduleStruct shall be set to false." +
                 "\n" +
@@ -1048,7 +1003,7 @@ export const Thermostat = Cluster(
                 "       the ScheduleStruct, the server shall check for invalid removal of the ScheduleStruct:" +
                 "\n" +
                 "      i. If the BuiltIn field is true on the removed ScheduleStruct, the attribute status shall be " +
-                "          CONSTRAINT_ERROR." +
+                "         CONSTRAINT_ERROR." +
                 "\n" +
                 "      ii. If the removed ScheduleHandle is equal to the value of the ActiveScheduleHandle attribute, " +
                 "          the attribute status shall be INVALID_IN_STATE." +
@@ -1264,7 +1219,7 @@ export const Thermostat = Cluster(
             quality: "X"
         }),
         Field({
-            name: "SetPoint", id: 0x4, type: "temperature", conformance: "M",
+            name: "Setpoint", id: 0x4, type: "temperature", conformance: "M",
             details: "This field shall indicate the target setpoint temperature when the log is captured.",
             xref: { document: "cluster", section: "4.3.10.7.5" }
         }),
@@ -1463,7 +1418,7 @@ export const Thermostat = Cluster(
     Datatype(
         { name: "PresetTypeFeaturesBitmap", type: "map16", xref: { document: "cluster", section: "4.3.8.8" } },
         Field({ name: "Automatic", constraint: "0", description: "Preset may be automatically activated by the thermostat" }),
-        Field({ name: "SupportsNames", constraint: "1", description: "Preset supports user- provided names" })
+        Field({ name: "SupportsNames", constraint: "1", description: "Preset supports user-provided names" })
     ),
 
     Datatype(
@@ -1607,9 +1562,9 @@ export const Thermostat = Cluster(
         {
             name: "ControlSequenceOfOperationEnum", type: "enum8",
 
-            details: "NOTE" +
+            details: "> [!NOTE]" +
                 "\n" +
-                "CoolingAndHeating" +
+                "> CoolingAndHeating" +
                 "\n" +
                 "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." +
@@ -1673,8 +1628,8 @@ export const Thermostat = Cluster(
 
         Field({
             name: "Vacation", id: 0x5, conformance: "M", description: "Users are on vacation",
-            details: "This value shall indicate the preset for periods when users are on vacation, or otherwise out-of- " +
-                "home for extended periods of time.",
+            details: "This value shall indicate the preset for periods when users are on vacation, or otherwise " +
+                "out-of-home for extended periods of time.",
             xref: { document: "cluster", section: "4.3.8.22.6" }
         }),
 

package/src/standard/elements/ThreadBorderRouterManagement.ts

@@ -34,11 +34,11 @@ export const ThreadBorderRouterManagement = Cluster(
             details: "This feature shall indicate the ability of the Border Router to change its already configured PAN to " +
                 "another, by setting a pending dataset." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "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.",
 
             xref: { document: "cluster", section: "10.3.4.1" }
         })

package/src/standard/elements/ThreadNetworkDiagnostics.ts

@@ -62,9 +62,8 @@ export const ThreadNetworkDiagnostics = Cluster(
         name: "RoutingRole", id: 0x1, type: "RoutingRoleEnum", access: "R V", conformance: "M",
         quality: "X",
         details: "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" +
-            "\n" +
-            "in the following table. A value of null shall indicate that the Thread interface is not currently " +
+            "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.",
         xref: { document: "core", section: "11.14.6.2" }
     }),
@@ -296,10 +295,9 @@ export const ThreadNetworkDiagnostics = Cluster(
     Attribute({
         name: "TxNoAckRequestedCount", id: 0x1b, type: "uint32", access: "R V", conformance: "[MACCNT]",
         default: 0, quality: "C",
-        details: "The TxNoAckRequestedCount attribute shall indicate the total number of unique MAC frame" +
-            "\n" +
-            "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 " +
+        details: "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.",
         xref: { document: "core", section: "11.14.6.28" }
     }),
@@ -366,14 +364,10 @@ export const ThreadNetworkDiagnostics = Cluster(
     Attribute({
         name: "TxDirectMaxRetryExpiryCount", id: 0x22, type: "uint32", access: "R V",
         conformance: "[MACCNT]", default: 0, quality: "C",
-
-        details: "The TxDirectMaxRetryExpiryCount attribute shall indicate the total number of unique MAC" +
-            "\n" +
-            "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.",
-
+        details: "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.",
         xref: { document: "core", section: "11.14.6.35" }
     }),
 
@@ -443,9 +437,8 @@ export const ThreadNetworkDiagnostics = Cluster(
     Attribute({
         name: "RxDataCount", id: 0x2a, type: "uint32", access: "R V", conformance: "[MACCNT]", default: 0,
         quality: "C",
-        details: "The RxDataCount attribute shall indicate the total number of received unique MAC Data frames." +
-            "\n" +
-            "This value shall only be reset upon a Node reboot.",
+        details: "The RxDataCount attribute shall indicate the total number of received unique MAC Data frames. This " +
+            "value shall only be reset upon a Node reboot.",
         xref: { document: "core", section: "11.14.6.43" }
     }),
 
@@ -521,9 +514,8 @@ export const ThreadNetworkDiagnostics = Cluster(
         name: "RxErrUnknownNeighborCount", id: 0x33, type: "uint32", access: "R V", conformance: "[MACCNT]",
         default: 0, quality: "C",
         details: "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" +
-            "\n" +
-            "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.",
         xref: { document: "core", section: "11.14.6.52" }
     }),
 

package/src/standard/elements/ThreadNetworkDirectory.ts

@@ -79,9 +79,9 @@ export const ThreadNetworkDirectory = Cluster(
     Attribute({
         name: "ThreadNetworkTableSize", id: 0x2, type: "uint8", access: "R V", conformance: "M",
         constraint: "desc", default: 10, quality: "F",
-        details: "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.",
+        details: "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.",
         xref: { document: "cluster", section: "10.4.5.3" }
     }),
 

package/src/standard/elements/TimeSynchronization.ts

@@ -343,9 +343,8 @@ export const TimeSynchronization = Cluster(
                 "valid time source, it may send a Granularity of NoTimeGranularity." +
                 "\n" +
                 "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" +
-                "\n" +
-                "update its UTCTime attribute if its current Granularity is NoTimeGranularity." +
+                "in the command, if the stated Granularity and TimeSource are acceptable. The node shall update its " +
+                "UTCTime attribute if its current Granularity is NoTimeGranularity." +
                 "\n" +
                 "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 " +
@@ -457,9 +456,8 @@ export const TimeSynchronization = Cluster(
 
             details: "This command is used to set the DST offsets for a node." +
                 "\n" +
-                "  • If the length of DSTOffset is larger than DSTOffsetListMaxSize, the node shall respond with" +
-                "\n" +
-                "RESOURCE_EXHAUSTED." +
+                "  • If the length of DSTOffset is larger than DSTOffsetListMaxSize, the node shall respond with " +
+                "    RESOURCE_EXHAUSTED." +
                 "\n" +
                 "  • Else if the list entries do not conform to the list requirements for DSTOffset attribute, the " +
                 "    node shall respond with CONSTRAINT_ERROR." +
@@ -518,11 +516,11 @@ export const TimeSynchronization = Cluster(
         }),
         Field({
             name: "MillisecondsGranularity", id: 0x3, conformance: "M",
-            description: "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."
+            description: "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."
         }),
         Field({
             name: "MicrosecondsGranularity", id: 0x4, conformance: "M",
-            description: "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."
+            description: "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."
         })
     ),
 

package/src/standard/elements/WakeOnLan.ts

@@ -60,14 +60,14 @@ export const WakeOnLan = Cluster(
         name: "LinkLocalAddress", id: 0x1, type: "ipv6adr", access: "R V", conformance: "O",
         constraint: "desc", quality: "F",
 
-        details: "Indicates the current link-local address of the device. Only 128-bit IPv6 link- local addresses " +
-            "shall be used for this attribute." +
+        details: "Indicates the current link-local address of the device. Only 128-bit IPv6 link-local addresses shall " +
+            "be used for this attribute." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "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.",
 
         xref: { document: "cluster", section: "1.12.4.2" }
     })

package/src/standard/elements/WaterHeaterManagement.ts

@@ -80,7 +80,7 @@ export const WaterHeaterManagement = Cluster(
                 "For example, if the target temperature was 60°C, the current temperature was 20°C and the tank " +
                 "volume was 100L:" +
                 "\n" +
-                "Mass of water = 1kg per Litre" +
+                "### Mass of water = 1kg per Litre" +
                 "\n" +
                 "Total Mass = 100 x 1kg = 100kg" +
                 "\n" +
@@ -88,24 +88,28 @@ export const WaterHeaterManagement = Cluster(
                 "\n" +
                 "= (60°C - 20°C) = 40°C" +
                 "\n" +
-                "Energy required to" +
+                "### Energy required to" +
                 "\n" +
                 "heat the water to 60°C = 4182 x 40 x 100 = 16,728,000 J" +
                 "\n" +
                 "Converting Joules in to Wh of heat (divide by 3600):" +
                 "\n" +
+                "= 16,728,000 J / 3600" +
+                "\n" +
+                "= 4647 Wh (4.65kWh)" +
+                "\n" +
                 "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." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "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.",
 
             xref: { document: "cluster", section: "9.5.7.4" }
         }
@@ -140,7 +144,7 @@ export const WaterHeaterManagement = Cluster(
                 "\n" +
                 "TankPercentage = min( max(TankPercentage,0), 100)" +
                 "\n" +
-                "TankPercentage = 50%",
+                "### TankPercentage = 50%",
 
             xref: { document: "cluster", section: "9.5.7.5" }
         }
@@ -148,9 +152,7 @@ export const WaterHeaterManagement = Cluster(
 
     Attribute({
         name: "BoostState", id: 0x5, type: "BoostStateEnum", access: "R V", conformance: "M", default: 0,
-        details: "Indicates whether the Boost, as triggered by a Boost command, is currently" +
-            "\n" +
-            "Active or Inactive." +
+        details: "Indicates whether the Boost, as triggered by a Boost command, is currently Active or Inactive." +
             "\n" +
             "See Boost and CancelBoost commands for more details.",
         xref: { document: "cluster", section: "9.5.7.6" }

package/src/standard/elements/WiFiNetworkManagement.ts

@@ -36,12 +36,12 @@ export const WiFiNetworkManagement = Cluster(
             "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)." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "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.",
 
         xref: { document: "cluster", section: "10.2.4.1" }
     }),
@@ -61,13 +61,11 @@ export const WiFiNetworkManagement = Cluster(
             "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." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "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" +
-            "\n" +
-            "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.",
 
         xref: { document: "cluster", section: "10.2.4.2" }
     }),

package/src/standard/elements/WindowCovering.ts

@@ -289,8 +289,9 @@ export const WindowCovering = Cluster(
             "\n" +
             "  • CurrentPositionTiltPercent100ths attribute shall be 0.00%." +
             "\n" +
-            "  • CurrentPositionTiltPercentage attribute shall be 0%. if the AbsolutePosition feature is " +
-            "    supported:" +
+            "  • CurrentPositionTiltPercentage attribute shall be 0%." +
+            "\n" +
+            "if the AbsolutePosition feature is supported:" +
             "\n" +
             "  • CurrentPositionLift attribute shall be equal to the InstalledOpenLimitLift attribute." +
             "\n" +
@@ -324,8 +325,9 @@ export const WindowCovering = Cluster(
             "\n" +
             "  • CurrentPositionTiltPercent100ths attribute shall be 100.00%." +
             "\n" +
-            "  • CurrentPositionTiltPercentage attribute shall be 100%. if the AbsolutePosition feature is " +
-            "    supported:" +
+            "  • CurrentPositionTiltPercentage attribute shall be 100%." +
+            "\n" +
+            "if the AbsolutePosition feature is supported:" +
             "\n" +
             "  • CurrentPositionLift attribute shall be equal to the InstalledClosedLimitLift attribute." +
             "\n" +

package/src/standard/elements/definitions.ts

@@ -127,7 +127,7 @@ export * from "./OperationalCredentials.js";
 export * from "./AdministratorCommissioning.js";
 export * from "./OtaSoftwareUpdateProvider.js";
 export * from "./OtaSoftwareUpdateRequestor.js";
-export * from "./JointFabricDatastoreCluster.js";
+export * from "./JointFabricDatastore.js";
 export * from "./JointFabricPki.js";
 export * from "./CommissionerControl.js";
 export * from "./MeasurementTypeEnum.js";

package/src/standard/elements/epoch-us.ts

@@ -52,7 +52,7 @@ export const epochUs = Datatype(
             "\n" +
             "  • 2000-06-01T00:00-04 if the associated local time offset is -4 hours." +
             "\n" +
-            "Conversion from NTP timestamps" +
+            "### Conversion from NTP timestamps" +
             "\n" +
             "Timestamps from NTP also do not count leap seconds, but have a different epoch. NTP 128-bit " +
             "timestamps consist of a 64-bit seconds portion (NTP(s)) and a 64-bit fractional seconds portion " +

package/src/standard/elements/locationdesc.ts

@@ -52,10 +52,10 @@ export const locationdesc = Datatype(
             "devices, such as for grouping devices that are located on the same level. For example, an automation " +
             "may be defined for all devices located at the basement level (floor number -1)." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "Handling complex level situations, such as half levels (side split houses), or the levels from an " +
-            "apartment building, is up to the client and/or user.",
+            "> Handling complex level situations, such as half levels (side split houses), or the levels from an " +
+            "  apartment building, is up to the client and/or user.",
 
         xref: { document: "core", section: "7.19.2.45.2" }
     }),
@@ -68,10 +68,10 @@ export const locationdesc = Datatype(
             "\n" +
             "If this field is null, that indicates that the area type information is not available." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "This field only indicates the type of the area. Multiple areas of the same type, such as bedrooms, " +
-            "may exist in a user’s home.",
+            "> This field only indicates the type of the area. Multiple areas of the same type, such as bedrooms, " +
+            "  may exist in a user’s home.",
 
         xref: { document: "core", section: "7.19.2.45.3" }
     })