@matter/model 0.13.1-alpha.0-20250508-047aa0277 → 0.13.1-alpha.0-20250509-28e1567e1

package/src/standard/elements/DeviceEnergyManagement.ts

@@ -20,15 +20,12 @@ export const DeviceEnergyManagement = Cluster(
     {
         name: "DeviceEnergyManagement", id: 0x98, classification: "application", pics: "DEM",
 
-        details: "This cluster allows a client to manage the power draw of a device. An example of such a client could" +
-            "\n" +
+        details: "This cluster allows a client to manage the power draw of a device. An example of such a client could " +
             "be an Energy Management System (EMS) which controls an Energy Smart Appliance (ESA)." +
             "\n" +
             "In most deployments the EMS will be the client, and the ESA will host the Device Energy Management " +
             "Cluster server." +
             "\n" +
-            "Figure 17. Example of the how an EMS is a client of multiple ESAs Device Energy Management clusters." +
-            "\n" +
             "This cluster is intended to be generic in nature and could apply to any electrical load or generator " +
             "(e.g. a Battery Electric Storage System - BESS, solar PV inverter, EVSE, HVAC, heat pump, hot water " +
             "heater, white goods appliances etc)." +
@@ -56,17 +53,15 @@ export const DeviceEnergyManagement = Cluster(
             "carbon intensity', 'time of use' or 'type of use' tariffs to schedule its operation to run at the " +
             "cheapest and greenest times." +
             "\n" +
-            "Figure 18. Example of the how an HVAC may use multiple clusters" +
-            "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "Grid Services are market dependent and will use other protocols ([OpenADR] / [IEEE2030.5]) to " +
-            "communicate grid events to the EMS. These are outside the scope of Matter." +
+            "> Grid Services are market dependent and will use other protocols ([OpenADR] / [IEEE2030.5]) to " +
+            "  communicate grid events to the EMS. These are outside the scope of Matter." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "Different markets may follow different approaches, but the UK [PAS1878] and [EUCodeOfConduct] give " +
-            "examples of how ESAs may be mandated to support these features in the future.",
+            "> Different markets may follow different approaches, but the UK [PAS1878] and [EUCodeOfConduct] give " +
+            "  examples of how ESAs may be mandated to support these features in the future.",
 
         xref: { document: "cluster", section: "9.2" }
     },
@@ -86,13 +81,7 @@ export const DeviceEnergyManagement = Cluster(
                 "\n" +
                 "For example, a home may have solar PV which often produces more power than the home requires, " +
                 "resulting in the excess power flowing into the grid. This excess power naturally fluctuates when " +
-                "clouds pass overhead and other loads in the home are switched on and off." +
-                "\n" +
-                "EVSE Example: An EMS may therefore be able to turn on the EVSE (if the vehicle is plugged in) and " +
-                "can start charging the vehicle, and periodically modify the charging power depending on PV " +
-                "generation and other home loads, so as to minimize import and export to the grid. An EMS may also " +
-                "use this feature to control the discharging (and re-charging) of the vehicle if the EVSE and vehicle " +
-                "support the V2X feature of the EVSE cluster of the associated EVSE device.",
+                "clouds pass overhead and other loads in the home are switched on and off.",
 
             xref: { document: "cluster", section: "9.2.4.1" }
         }),
@@ -109,10 +98,6 @@ export const DeviceEnergyManagement = Cluster(
                 "Forecasts are defined from a current time, using a slot format, where the slot is akin to a " +
                 "relatively constant operating mode." +
                 "\n" +
-                "Washing machine example: a washing machine may have stages of a washing cycle: heating, tumbling, " +
-                "rinse and spin stages. At each stage, the approximate minimum and maximum power consumption may be " +
-                "known, as well as the duration of that stage." +
-                "\n" +
                 "In some circumstances the ESA may allow the stage to be delayed or paused (subject to safety and " +
                 "manufacturer’s discretion and user preferences)." +
                 "\n" +
@@ -127,8 +112,6 @@ export const DeviceEnergyManagement = Cluster(
                 "\n" +
                 "The PowerForecastReporting and the adjustment features aim to align to the [SAREF4ENER] ontology." +
                 "\n" +
-                "Inverter driven ESAs: some inverter driven ESAs can consume or generate a variable amount of power." +
-                "\n" +
                 "For example, a single phase EVSE can be adjusted in the range of 6-32Amps in 0.6 Amp steps in EU or " +
                 "on a hardwired 120V supply in the range of 6-15 Amps in US." +
                 "\n" +
@@ -168,9 +151,6 @@ export const DeviceEnergyManagement = Cluster(
             details: "ESAs which support the Start Time Adjustment feature, allow an EMS to recommend a change to the " +
                 "start time of the energy transfer that the ESA has previously suggested it would use." +
                 "\n" +
-                "Washing machine example: A Washing Machine may have been set to start a wash cycle at 9pm when the " +
-                "variable tariff normally reduces." +
-                "\n" +
                 "However, the EMS is aware that a grid event has occurred, making it cheaper to run the cycle at a " +
                 "later time, but the washing machine is not aware of this." +
                 "\n" +
@@ -190,12 +170,9 @@ export const DeviceEnergyManagement = Cluster(
         Field({
             name: "PAU", conformance: "O", constraint: "4", description: "Pausable",
 
-            details: "ESAs which support the Pausable feature, allow an EMS to recommend a pause in the middle of a" +
-                "\n" +
+            details: "ESAs which support the Pausable feature, allow an EMS to recommend a pause in the middle of a " +
                 "forecast power profile that the ESA is currently using." +
                 "\n" +
-                "Washing machine example: A Washing Machine is in operation, and starting its water heating step." +
-                "\n" +
                 "However, the EMS becomes aware from the smart meter that the total home load on the grid is close to " +
                 "exceeding its allowed total grid load." +
                 "\n" +
@@ -220,11 +197,6 @@ export const DeviceEnergyManagement = Cluster(
                 "duration and/or power level limits of the steps of the power profile that the ESA has previously " +
                 "suggested it would use." +
                 "\n" +
-                "Heat pump and Solar PV example: A heat pump may have the ability to heat hot water as well as " +
-                "heating the home. The heat pump scheduling system may have determined that the home will be " +
-                "unoccupied during the day, or that the indoor temperature is above the set-point and so it knows " +
-                "that it will not need to heat the home." +
-                "\n" +
                 "However, the hot water tank is likely to need to be reheated before the homeowner comes home in the " +
                 "evening. The heat pump is not aware that the property also has a solar PV inverter which is also an " +
                 "ESA that is communicating with the EMS." +
@@ -249,13 +221,8 @@ export const DeviceEnergyManagement = Cluster(
 
             details: "ESAs which support the Constraint-Based Adjustment feature allow an EMS to inform the ESA of periods " +
                 "during which power usage should be modified (for example when the EMS has been made aware that the " +
-                "grid supplier has requested reduced energy usage due to overall peak grid demand)" +
-                "\n" +
-                "and may cause the ESA to modify the intended power profile has previously suggested it would use." +
-                "\n" +
-                "EVSE example: An EVSE scheduling system may have determined that the vehicle would be charged " +
-                "starting at a moderate rate at 1am, so that it has enough charge by the time it is needed later that " +
-                "morning." +
+                "grid supplier has requested reduced energy usage due to overall peak grid demand) and may cause the " +
+                "ESA to modify the intended power profile has previously suggested it would use." +
                 "\n" +
                 "However, the DSR service provider has informed the EMS that due to high forecast winds it is now " +
                 "forecast that there will be very cheap energy available from wind generation between 2am and 3am." +
@@ -344,11 +311,11 @@ export const DeviceEnergyManagement = Cluster(
         details: "Indicates the minimum electrical power that the ESA can consume when switched on. This does not " +
             "include when in power save or standby modes." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "For Generator ESAs that can discharge an internal battery (such as a battery storage inverter) to " +
-            "loads in the home, the AbsMinPower will be a negative number representing the maximum power that the " +
-            "ESA can discharge its internal battery.",
+            "> For Generator ESAs that can discharge an internal battery (such as a battery storage inverter) to " +
+            "  loads in the home, the AbsMinPower will be a negative number representing the maximum power that " +
+            "  the ESA can discharge its internal battery.",
 
         xref: { document: "cluster", section: "9.2.8.4" }
     }),
@@ -434,10 +401,9 @@ export const DeviceEnergyManagement = Cluster(
             "\n" +
             "If the user changes the Opt-Out state of the ESA which is currently operating with a Forecast that " +
             "is due to a previous StartTimeAdjustRequest, ModifyForecastRequest or RequestConstraintBasedForecast " +
-            "command that would now not be permitted due to the new Opt-out state" +
-            "\n" +
-            "attribute ForecastUpdateReason field currently contains a reason which is now opted out), the ESA " +
-            "shall behave as if it had received a CancelRequest command." +
+            "command that would now not be permitted due to the new Opt-out state (i.e. the Forecast attribute " +
+            "ForecastUpdateReason field currently contains a reason which is now opted out), the ESA shall behave " +
+            "as if it had received a CancelRequest command." +
             "\n" +
             "If the user changes the Opt-Out state of the ESA which currently has the ESAStateEnum with value " +
             "Paused due to a previous PauseRequest command that would now not be permitted due to the new Opt-out " +
@@ -670,9 +636,8 @@ export const DeviceEnergyManagement = Cluster(
                     "If this ESA supports PFR this would have 2 entries in the list as follows:" +
                     "\n" +
                     "If this ESA supports SFR where it does not know the actual power, but has an understanding of the " +
-                    "functions that use more energy, it could be requested to use more or less energy using the LoadCon" +
-                    "\n" +
-                    "trol field as follows:",
+                    "functions that use more energy, it could be requested to use more or less energy using the " +
+                    "LoadControl field as follows:",
 
                 xref: { document: "cluster", section: "9.2.9.7.1" }
             },
@@ -751,7 +716,7 @@ export const DeviceEnergyManagement = Cluster(
         { name: "ESAStateEnum", type: "enum8", xref: { document: "cluster", section: "9.2.7.3" } },
         Field({
             name: "Offline", id: 0x0, conformance: "M",
-            description: "The ESA is not available to the EMS (e.g. start- up, maintenance mode)"
+            description: "The ESA is not available to the EMS (e.g. start-up, maintenance mode)"
         }),
         Field({
             name: "Online", id: 0x1, conformance: "M",
@@ -895,7 +860,8 @@ export const DeviceEnergyManagement = Cluster(
             name: "MinPower", id: 0x0, type: "power-mW", conformance: "M", default: 0,
             details: "This field shall indicate the minimum power that the ESA can have its power adjusted to." +
                 "\n" +
-                "Note that this is a signed value. Negative values indicate power flows out of the node (e.g. " +
+                "Note that this is a signed value. Negative values indicate power flows out of the node" +
+                "\n" +
                 "discharging a battery).",
             xref: { document: "cluster", section: "9.2.7.10.1" }
         }),
@@ -982,8 +948,7 @@ export const DeviceEnergyManagement = Cluster(
                 "use, with different power and energy demands per slot. For example, slots might be used to describe " +
                 "the distinct stages of a washing machine cycle." +
                 "\n" +
-                "Where an ESA does not know the actual power and energy use of the system, it may support the SFR" +
-                "\n" +
+                "Where an ESA does not know the actual power and energy use of the system, it may support the SFR " +
                 "feature and instead report its internal state.",
 
             xref: { document: "cluster", section: "9.2.7.13" }
@@ -1161,8 +1126,6 @@ export const DeviceEnergyManagement = Cluster(
                 "they may choose to use values between 0-100 as a percentage of compressor modulation, or could use " +
                 "these values as Enum states meaning heating with fan, heating without fan etc." +
                 "\n" +
-                "NOTE An ESA shall always use the same value to represent the same operating state." +
-                "\n" +
                 "By providing this information a smart EMS may be able to learn the observed power draw when the ESA " +
                 "is put into a specific state. It can potentially then use the ManufacturerESAState field in the " +
                 "Forecast attribute along with observed power drawn to predict the power draw from the appliance and " +

package/src/standard/elements/DeviceEnergyManagementDT.ts

@@ -31,11 +31,11 @@ export const DeviceEnergyManagementDt = DeviceType(
             name: "DeviceEnergyManagement", id: 0x98, conformance: "M", element: "serverCluster",
             xref: { document: "device", section: "2.7.4" }
         },
-        Requirement({ name: "POWERADJUSTMENT", conformance: "ControllableESA.a+", element: "feature" }),
-        Requirement({ name: "STARTTIMEADJUSTMENT", conformance: "ControllableESA.a+", element: "feature" }),
-        Requirement({ name: "PAUSABLE", conformance: "ControllableESA.a+", element: "feature" }),
-        Requirement({ name: "FORECASTADJUSTMENT", conformance: "ControllableESA.a+", element: "feature" }),
-        Requirement({ name: "CONSTRAINTBASEDADJUSTMENT", conformance: "ControllableESA.a+", element: "feature" })
+        Requirement({ name: "POWERADJUSTMENT", conformance: "Controllable, ESA.a+", element: "feature" }),
+        Requirement({ name: "STARTTIMEADJUSTMENT", conformance: "Controllable, ESA.a+", element: "feature" }),
+        Requirement({ name: "PAUSABLE", conformance: "Controllable, ESA.a+", element: "feature" }),
+        Requirement({ name: "FORECASTADJUSTMENT", conformance: "Controllable, ESA.a+", element: "feature" }),
+        Requirement({ name: "CONSTRAINTBASEDADJUSTMENT", conformance: "Controllable, ESA.a+", element: "feature" })
     ),
 
     Requirement({

package/src/standard/elements/DiagnosticLogs.ts

@@ -62,7 +62,7 @@ export const DiagnosticLogs = Cluster(
             details: "This field shall be present if the RequestedProtocol is BDX. The TransferFileDesignator shall be set " +
                 "as the File Designator of the BDX transfer if initiated." +
                 "\n" +
-                "Effect on Receipt" +
+                "### Effect on Receipt" +
                 "\n" +
                 "On receipt of this command, the Node shall respond with a RetrieveLogsResponse command." +
                 "\n" +
@@ -140,7 +140,7 @@ export const DiagnosticLogs = Cluster(
 
         Field({
             name: "EndUserSupport", id: 0x0, conformance: "M",
-            description: "Logs to be used for end- user support",
+            description: "Logs to be used for end-user support",
             details: "shall indicate that the purpose of the log request is to retrieve logs for the intention of " +
                 "providing support to an end-user.",
             xref: { document: "core", section: "11.11.4.1.1" }

package/src/standard/elements/DoorLock.ts

@@ -21,9 +21,7 @@ export const DoorLock = Cluster(
         name: "DoorLock", id: 0x101, classification: "application", pics: "DRLK",
         details: "The door lock cluster provides an interface to a generic way to secure a door. The physical object " +
             "that provides the locking functionality is abstracted from the cluster. The cluster has a small list " +
-            "of mandatory attributes and functions and a list of optional features." +
-            "\n" +
-            "Figure 16. Typical Usage of the Door Lock Cluster",
+            "of mandatory attributes and functions and a list of optional features.",
         xref: { document: "cluster", section: "5.2" }
     },
 
@@ -113,8 +111,7 @@ export const DoorLock = Cluster(
 
         Field({
             name: "COTA", conformance: "O", constraint: "7", description: "CredentialOverTheAirAccess",
-            details: "If this feature is supported then the lock supports the ability to verify a credential provided in a" +
-                "\n" +
+            details: "If this feature is supported then the lock supports the ability to verify a credential provided in a " +
                 "lock/unlock command. Currently the cluster only supports providing the PIN credential to the " +
                 "lock/unlock commands. If this feature is supported then the PIN Credential feature shall also be " +
                 "supported.",
@@ -364,7 +361,8 @@ export const DoorLock = Cluster(
     Attribute({
         name: "OperatingMode", id: 0x25, type: "OperatingModeEnum", access: "R[W] VM", conformance: "M",
         constraint: "desc", default: 0, quality: "P",
-        details: "Indicates the current operating mode of the lock as defined in OperatingModeEnum.",
+        details: "This attribute shall indicate the current operating mode of the lock as defined in " +
+            "OperatingModeEnum.",
         xref: { document: "cluster", section: "5.2.9.24" }
     }),
 
@@ -382,10 +380,8 @@ export const DoorLock = Cluster(
         conformance: "O", default: 0, quality: "P",
 
         details: "Indicates the default configurations as they are physically set on the device (example: hardware dip " +
-            "switch setting, etc…) and represents the default setting for some of the" +
-            "\n" +
-            "attributes within this cluster (for example: LED, Auto Lock, Sound Volume, and Operating Mode " +
-            "attributes)." +
+            "switch setting, etc…) and represents the default setting for some of the attributes within this " +
+            "cluster (for example: LED, Auto Lock, Sound Volume, and Operating Mode attributes)." +
             "\n" +
             "This is a read-only attribute and is intended to allow clients to determine what changes may need to " +
             "be made without having to query all the included attributes. It may be beneficial for the clients to " +
@@ -490,11 +486,10 @@ export const DoorLock = Cluster(
             "server’s TX operation. If it is false, then it is not ok for the device to send PIN in any messages " +
             "over the air." +
             "\n" +
-            "The PIN field within any door lock cluster message shall keep the first octet unchanged and" +
-            "\n" +
-            "masks the actual code by replacing with 0xFF. For example (PIN \"1234\" ): If the attribute value is " +
-            "True, 0x04 0x31 0x32 0x33 0x34 shall be used in the PIN field in any door lock cluster message " +
-            "payload. If the attribute value is False, 0x04 0xFF 0xFF 0xFF 0xFF shall be used.",
+            "The PIN field within any door lock cluster message shall keep the first octet unchanged and masks " +
+            "the actual code by replacing with 0xFF. For example (PIN \"1234\" ): If the attribute value is True, " +
+            "0x04 0x31 0x32 0x33 0x34 shall be used in the PIN field in any door lock cluster message payload. If " +
+            "the attribute value is False, 0x04 0xFF 0xFF 0xFF 0xFF shall be used.",
 
         xref: { document: "cluster", section: "5.2.9.34" }
     }),
@@ -617,13 +612,13 @@ export const DoorLock = Cluster(
             "applies to the sum of the number of AliroEvictableEndpointKey credentials and the number of " +
             "AliroNonEvictableEndpointKey credentials." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "The credential indices used for these two credential types are independent of each other, similar to " +
-            "all other credential types. As long as NumberOfAliroEndpointKeysSupported is at least 2 a client " +
-            "could add a credential of type AliroEvictableEndpointKey at any index from 1 to " +
-            "NumberOfAliroEndpointKeysSupported and also add a credential of type AliroNonEvictableEndpointKey at " +
-            "the same index, and both credentials would exist on the server.",
+            "> The credential indices used for these two credential types are independent of each other, similar " +
+            "  to all other credential types. As long as NumberOfAliroEndpointKeysSupported is at least 2 a " +
+            "  client could add a credential of type AliroEvictableEndpointKey at any index from 1 to " +
+            "  NumberOfAliroEndpointKeysSupported and also add a credential of type AliroNonEvictableEndpointKey " +
+            "  at the same index, and both credentials would exist on the server.",
 
         xref: { document: "cluster", section: "5.2.9.46" }
     }),
@@ -684,9 +679,8 @@ export const DoorLock = Cluster(
                 "    ◦ shall generate a LockOperation event of LockOperationType Unlatch when it is actuated from the " +
                 "      outside." +
                 "\n" +
-                "    ◦ may generate a LockOperation event of LockOperationType Unlatch when it is actuated" +
-                "\n" +
-                "from the inside.",
+                "    ◦ may generate a LockOperation event of LockOperationType Unlatch when it is actuated from the " +
+                "      inside.",
 
             xref: { document: "cluster", section: "5.2.11.3" }
         },
@@ -897,10 +891,10 @@ export const DoorLock = Cluster(
                 "the lock. The door lock may require a code depending on the value of the " +
                 "RequirePINForRemoteOperation attribute." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "If the attribute AutoRelockTime is supported the lock will transition to the locked state when the " +
-                "auto relock time has expired.",
+                "> If the attribute AutoRelockTime is supported the lock will transition to the locked state when the " +
+                "  auto relock time has expired.",
 
             xref: { document: "cluster", section: "5.2.10.2" }
         },
@@ -1044,10 +1038,10 @@ export const DoorLock = Cluster(
 
         details: "Clear out all PINs on the lock." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "On the server, the clear all PIN codes command SHOULD have the same effect as the ClearPINCode " +
-            "command with respect to the setting of user status, user type and schedules.",
+            "> On the server, the clear all PIN codes command SHOULD have the same effect as the ClearPINCode " +
+            "  command with respect to the setting of user status, user type and schedules.",
 
         xref: { document: "cluster", section: "5.2.10.8" }
     }),
@@ -1736,9 +1730,7 @@ export const DoorLock = Cluster(
                 "Fields used for different use cases:" +
                 "\n" +
                 "Return status is a global status code or a cluster-specific status code from the Status Codes table " +
-                "and" +
-                "\n" +
-                "shall be one of the following values:" +
+                "and shall be one of the following values:" +
                 "\n" +
                 "  • SUCCESS, if setting User was successful." +
                 "\n" +
@@ -1867,14 +1859,10 @@ export const DoorLock = Cluster(
         {
             name: "GetUser", id: 0x1b, access: "A", conformance: "USR", direction: "request",
             response: "GetUserResponse",
-
             details: "Retrieve user." +
                 "\n" +
-                "An InvokeResponse command shall be sent with an appropriate error" +
-                "\n" +
-                "COMMAND, etc.) as needed otherwise the GetUserResponse Command shall be sent implying a status of " +
-                "SUCCESS.",
-
+                "An InvokeResponse command shall be sent with an appropriate error (e.g. FAILURE, INVALID_COMMAND, " +
+                "etc.) as needed otherwise the GetUserResponse Command shall be sent implying a status of SUCCESS.",
             xref: { document: "cluster", section: "5.2.10.33" }
         },
 
@@ -2198,10 +2186,9 @@ export const DoorLock = Cluster(
             details: "This field shall indicate the next occupied index in the database for the credential type requested, " +
                 "which is useful for quickly identifying occupied credential slots in the database. This shall NOT be " +
                 "null if there is at least one occupied entry after the requested credential index in the " +
-                "corresponding" +
-                "\n" +
-                "database and shall be null if there are no more occupied entries. The NextCredentialIndex reported " +
-                "shall NOT exceed the maximum number of credentials for a particular credential type.",
+                "corresponding database and shall be null if there are no more occupied entries. The " +
+                "NextCredentialIndex reported shall NOT exceed the maximum number of credentials for a particular " +
+                "credential type.",
 
             xref: { document: "cluster", section: "5.2.10.39.5" }
         }),
@@ -2220,10 +2207,10 @@ export const DoorLock = Cluster(
                 "Otherwise, the value of this field shall be the value of the relevant credential, as a 65-byte " +
                 "uncompressed elliptic curve public key as defined in section 2.3.3 of SEC 1." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "Since the Aliro credentials are public keys, there is no security risk in allowing them to be read. " +
-                "Possession of the credential octet string does not allow operating the lock.",
+                "> Since the Aliro credentials are public keys, there is no security risk in allowing them to be " +
+                "  read. Possession of the credential octet string does not allow operating the lock.",
 
             xref: { document: "cluster", section: "5.2.10.39.6" }
         })
@@ -2267,10 +2254,10 @@ export const DoorLock = Cluster(
                 "includes an optional code for the lock. The door lock may require a code depending on the value of " +
                 "the RequirePINForRemoteOperation attribute." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "If the attribute AutoRelockTime is supported, the lock will transition to the locked state when the " +
-                "auto relock time has expired.",
+                "> If the attribute AutoRelockTime is supported, the lock will transition to the locked state when " +
+                "  the auto relock time has expired.",
 
             xref: { document: "cluster", section: "5.2.10.41" }
         },
@@ -2322,11 +2309,11 @@ export const DoorLock = Cluster(
         details: "This command allows clearing an existing Aliro Reader configuration for the lock. Administrators " +
             "shall NOT clear an Aliro Reader configuration without explicit user permission." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "Using this command will revoke the ability of all existing Aliro user devices that have the old " +
-            "verification key to interact with the lock. This effect is not restricted to a single fabric or " +
-            "otherwise scoped in any way.",
+            "> Using this command will revoke the ability of all existing Aliro user devices that have the old " +
+            "  verification key to interact with the lock. This effect is not restricted to a single fabric or " +
+            "  otherwise scoped in any way.",
 
         xref: { document: "cluster", section: "5.2.10.43" }
     }),
@@ -2787,12 +2774,12 @@ export const DoorLock = Cluster(
                 "\n" +
                 "* Interface Operational: Yes, No or N/A" +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "For modes that disable the remote interface, the door lock shall respond to Lock, Unlock, Toggle, " +
-                "and Unlock with Timeout commands with a response status Failure and not take the action requested by " +
-                "those commands. The door lock shall NOT disable the radio or otherwise unbind or leave the network. " +
-                "It shall still respond to all other commands and requests.",
+                "> For modes that disable the remote interface, the door lock shall respond to Lock, Unlock, Toggle, " +
+                "  and Unlock with Timeout commands with a response status Failure and not take the action requested " +
+                "  by those commands. The door lock shall NOT disable the radio or otherwise unbind or leave the " +
+                "  network. It shall still respond to all other commands and requests.",
 
             xref: { document: "cluster", section: "5.2.6.15" }
         },

package/src/standard/elements/EcosystemInformation.ts

@@ -57,9 +57,7 @@ export const EcosystemInformation = Cluster(
             name: "DeviceDirectory", id: 0x0, type: "list", access: "R F M", conformance: "M", quality: "N",
             details: "This attribute shall contain the list of logical devices represented by a Bridged Node. Most of the " +
                 "time this will contain a single entry, but may grow with more complex device compositions (e.g. " +
-                "another bridge.)" +
-                "\n" +
-                "An empty list indicates that the information is not available.",
+                "another bridge.) An empty list indicates that the information is not available.",
             xref: { document: "core", section: "9.18.5.1" }
         },
 
@@ -74,9 +72,7 @@ export const EcosystemInformation = Cluster(
                 "entries, and shall NOT contain locations which are dynamically generated and removed by an " +
                 "ecosystem. (E.g. a location that is generated and removed based on the user being home is not " +
                 "permitted. However, an initially generated location name that does not quickly change is " +
-                "acceptable.)" +
-                "\n" +
-                "An empty list indicates that the information is not available." +
+                "acceptable.) An empty list indicates that the information is not available." +
                 "\n" +
                 "LocationDirectory entries shall be removed if there is no DeviceDirectory that references it.",
 
@@ -156,12 +152,12 @@ export const EcosystemInformation = Cluster(
 
             details: "This field shall indicate the timestamp of when the UniqueLocationIDs was last modified." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "If multiple server instances update the UniqueLocationIDs field at the same time, it is possible one " +
-                "of the updates will be missed. This is considered an acceptable limitation to reduce the complexity " +
-                "of the design. Since this is meant to be provided from user input, it is unlikely these signals " +
-                "would be happening at one time.",
+                "> If multiple server instances update the UniqueLocationIDs field at the same time, it is possible " +
+                "  one of the updates will be missed. This is considered an acceptable limitation to reduce the " +
+                "  complexity of the design. Since this is meant to be provided from user input, it is unlikely these " +
+                "  signals would be happening at one time.",
 
             xref: { document: "core", section: "9.18.4.1.7" }
         }),
@@ -191,11 +187,9 @@ export const EcosystemInformation = Cluster(
                 "assignment.)" +
                 "\n" +
                 "UniqueLocationID shall NOT be changed when the LocationDescriptor changes name, but still represents " +
-                "the same location. (For example, the user renames a room.)" +
-                "\n" +
-                "UniqueLocationID shall be changed when LocationDescriptor changes as a result of another Ecosystem " +
-                "Information Cluster server instance changing and the UniqueLocationID on the remote server instance " +
-                "also changes." +
+                "the same location. (For example, the user renames a room.) UniqueLocationID shall be changed when " +
+                "LocationDescriptor changes as a result of another Ecosystem Information Cluster server instance " +
+                "changing and the UniqueLocationID on the remote server instance also changes." +
                 "\n" +
                 "UniqueLocationID shall NOT be changed when LocationDescriptor changes as a result of another " +
                 "Ecosystem Information Cluster server instance changing and the UniqueLocationID on the remote server " +

package/src/standard/elements/ElectricalEnergyMeasurement.ts

@@ -275,9 +275,9 @@ export const ElectricalEnergyMeasurement = Cluster(
             details: "This field shall indicate the time elapsed since boot at the beginning of the period during which " +
                 "the value of the Energy field was measured." +
                 "\n" +
-                "If this EnergyMeasurementStruct represents cumulative energy, this field shall be omitted. " +
-                "Otherwise, if the server had not yet determined the time in UTC at the start of the measurement" +
+                "If this EnergyMeasurementStruct represents cumulative energy, this field shall be omitted." +
                 "\n" +
+                "Otherwise, if the server had not yet determined the time in UTC at the start of the measurement " +
                 "period, or does not have the capability of determining the time in UTC, this field shall be " +
                 "indicated." +
                 "\n" +

package/src/standard/elements/ElectricalPowerMeasurement.ts

@@ -380,9 +380,8 @@ export const ElectricalPowerMeasurement = Cluster(
             constraint: "desc", default: null, quality: "X Q",
 
             details: "This shall indicate a list of HarmonicMeasurementStruct values, with each HarmonicMeasurementStruct " +
-                "representing the most recent phase of the harmonic current reading for the harmonic" +
-                "\n" +
-                "order specified by Order." +
+                "representing the most recent phase of the harmonic current reading for the harmonic order specified " +
+                "by Order." +
                 "\n" +
                 "The reporting interval of this attribute shall be manufacturer dependent. The server may choose to " +
                 "omit publication of deltas considered not meaningful." +
@@ -426,8 +425,9 @@ export const ElectricalPowerMeasurement = Cluster(
             "\n" +
             "If the neutral current cannot be measured or derived, a value of null shall be returned." +
             "\n" +
-            "A positive value represents an imbalance between the phase currents when power is imported. A " +
-            "negative value represents an imbalance between the phase currents when power is exported." +
+            "A positive value represents an imbalance between the phase currents when power is imported." +
+            "\n" +
+            "A negative value represents an imbalance between the phase currents when power is exported." +
             "\n" +
             "The reporting interval of this attribute shall be manufacturer dependent. The server may choose to " +
             "omit publication of deltas considered not meaningful." +
@@ -602,8 +602,7 @@ export const ElectricalPowerMeasurement = Cluster(
                 "reading in milliamps (mA). A positive value indicates that the measured harmonic current is " +
                 "positive, and a negative value indicates that the measured harmonic current is negative." +
                 "\n" +
-                "For the Harmonic Phases attribute, this value is the most recent phase of the given harmonic order" +
-                "\n" +
+                "For the Harmonic Phases attribute, this value is the most recent phase of the given harmonic order " +
                 "in millidegrees (mDeg). A positive value indicates that the measured phase is leading, and a " +
                 "negative value indicates that the measured phase is lagging." +
                 "\n" +