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

package/src/standard/elements/PressureMeasurement.ts

@@ -75,9 +75,7 @@ export const PressureMeasurement = Cluster(
         {
             name: "ScaledValue", id: 0x10, type: "int16", access: "R V", conformance: "EXT",
             constraint: "minScaledValue to maxScaledValue", default: 0, quality: "X",
-            details: "Indicates the pressure in Pascals as follows:" +
-                "\n" +
-                "ScaledValue = 10Scale x Pressure [Pa]" +
+            details: "Indicates the pressure in Pascals as follows: ScaledValue = 10Scale x Pressure [Pa]" +
                 "\n" +
                 "The null value indicates that the value is not available.",
             xref: { document: "cluster", section: "2.4.5.5" }
@@ -103,9 +101,8 @@ export const PressureMeasurement = Cluster(
     Attribute({
         name: "ScaledTolerance", id: 0x13, type: "uint16", access: "R V", conformance: "[EXT]",
         constraint: "max 2048", default: 0,
-        details: "Indicates the magnitude of the possible error that is associated with Scaled" +
-            "\n" +
-            "Value. The true value is located in the range" +
+        details: "Indicates the magnitude of the possible error that is associated with ScaledValue. The true value is " +
+            "located in the range" +
             "\n" +
             "(ScaledValue – ScaledTolerance) to (ScaledValue + ScaledTolerance).",
         xref: { document: "cluster", section: "2.4.5.8" }

package/src/standard/elements/PumpConfigurationAndControl.ts

@@ -27,13 +27,11 @@ export const PumpConfigurationAndControl = Cluster(
             "\n" +
             "C Pump configuration and control S C Level control S" +
             "\n" +
-            "C On/Off S" +
+            "### C On/Off S" +
             "\n" +
             "C = Client S = Server" +
             "\n" +
-            "Note: Device names are examples for illustration purposes only" +
-            "\n" +
-            "Figure 14. Typical Usage of Pump Configuration and Control Cluster",
+            "Note: Device names are examples for illustration purposes only",
 
         xref: { document: "cluster", section: "4.2" }
     },
@@ -145,9 +143,8 @@ export const PumpConfigurationAndControl = Cluster(
     Attribute({
         name: "MinConstSpeed", id: 0x7, type: "uint16", access: "R V", conformance: "SPD, [AUTO]",
         default: null, quality: "X F",
-        details: "This attribute specifies the minimum speed the pump can achieve when it is working with the Con" +
-            "\n" +
-            "trolMode attribute set to ConstantSpeed." +
+        details: "This attribute specifies the minimum speed the pump can achieve when it is working with the " +
+            "ControlMode attribute set to ConstantSpeed." +
             "\n" +
             "Valid range is 0 to 65,534 RPM (steps of 1 RPM). Null if the value is invalid.",
         xref: { document: "cluster", section: "4.2.7.8" }
@@ -196,14 +193,11 @@ export const PumpConfigurationAndControl = Cluster(
     Attribute({
         name: "MaxConstTemp", id: 0xc, type: "int16", access: "R V", conformance: "TEMP, [AUTO]",
         constraint: "min -27315", default: null, quality: "X F",
-
         details: "This attribute specifies the maximum temperature the pump can maintain in the system when it is " +
             "working with the ControlMode attribute set to ConstantTemperature." +
             "\n" +
-            "MaxConstTemp shall be greater than or equal to MinConstTemp" +
-            "\n" +
-            "Valid range is –273.15 °C to 327.67 °C (steps of 0.01 °C). Null if the value is invalid.",
-
+            "MaxConstTemp shall be greater than or equal to MinConstTemp Valid range is –273.15 °C to 327.67 °C " +
+            "(steps of 0.01 °C). Null if the value is invalid.",
         xref: { document: "cluster", section: "4.2.7.13" }
     }),
 
@@ -211,8 +205,7 @@ export const PumpConfigurationAndControl = Cluster(
         name: "PumpStatus", id: 0x10, type: "PumpStatusBitmap", access: "R V", conformance: "O",
         constraint: "desc", default: 0, quality: "P",
         details: "This attribute specifies the activity status of the pump functions as listed in PumpStatusBitmap. " +
-            "Where a pump controller function is active, the corresponding bit shall be set to 1. Where a pump" +
-            "\n" +
+            "Where a pump controller function is active, the corresponding bit shall be set to 1. Where a pump " +
             "controller function is not active, the corresponding bit shall be set to 0.",
         xref: { document: "cluster", section: "4.2.7.14" }
     }),
@@ -355,7 +348,7 @@ export const PumpConfigurationAndControl = Cluster(
             "ControlMode and the optional connection of a remote sensor. The operation and control is prioritized " +
             "as shown in the scheme below:" +
             "\n" +
-            "Priority Scheme of Pump Operation and Control" +
+            "### Priority Scheme of Pump Operation and Control" +
             "\n" +
             "If this attribute is Maximum, Minimum or Local, the OperationMode attribute decides how the pump is " +
             "operated." +
@@ -575,10 +568,9 @@ export const PumpConfigurationAndControl = Cluster(
         Field({
             name: "ProportionalPressure", id: 0x2, conformance: "PRSCOMP",
             description: "The pump will regulate its speed to maintain a constant differential pressure over its flanges.",
-            details: "The setpoint is interpreted as a percentage of the range derived of the [MinCompPressure – Max" +
-                "\n" +
-                "CompPressure] attributes. The internal setpoint will be lowered (compensated) dependent on the flow " +
-                "in the pump (lower flow ⇒ lower internal setpoint).",
+            details: "The setpoint is interpreted as a percentage of the range derived of the [MinCompPressure – " +
+                "MaxCompPressure] attributes. The internal setpoint will be lowered (compensated) dependent on the " +
+                "flow in the pump (lower flow ⇒ lower internal setpoint).",
             xref: { document: "cluster", section: "4.2.6.3.3" }
         }),
 

package/src/standard/elements/ResourceMonitoring.ts

@@ -19,17 +19,16 @@ export const ResourceMonitoring = Cluster(
     {
         name: "ResourceMonitoring", classification: "application", pics: "REPM",
 
-        details: "This generic cluster provides an interface to the current condition of a resource. A resource is a" +
-            "\n" +
+        details: "This generic cluster provides an interface to the current condition of a resource. A resource is a " +
             "component of a device that is designed to be replaced, refilled, or emptied when exhausted or full. " +
             "Examples of resources include filters, cartridges, and water tanks. While batteries fit this " +
             "definition they are not intended to be used with this cluster. Use the power source cluster for " +
             "batteries instead." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "This cluster is not meant to be used for monitoring of the system resources, such as processing, " +
-            "memory utilization, networking properties, etc." +
+            "> This cluster is not meant to be used for monitoring of the system resources, such as processing, " +
+            "  memory utilization, networking properties, etc." +
             "\n" +
             "This cluster shall be used via an alias to a specific resource type (see Cluster IDs).",
 

package/src/standard/elements/RootNodeDT.ts

@@ -46,7 +46,7 @@ export const RootNodeDt = DeviceType(
             name: "AccessControl", id: 0x1f, conformance: "M", element: "serverCluster", quality: "I",
             xref: { document: "device", section: "2.1.5" }
         },
-        Requirement({ name: "MNGD", conformance: "[ManagedAclAllowed]", constraint: "desc", element: "feature" })
+        Requirement({ name: "MNGD", conformance: "[ManagedAcl, Allowed]", constraint: "desc", element: "feature" })
     ),
 
     Requirement({

package/src/standard/elements/RvcRunMode.ts

@@ -108,11 +108,11 @@ export const RvcRunMode = Cluster(
                 "or paused due to an error, due to a pause command, or for recharging etc. If currently paused and " +
                 "the device can resume, it will continue to map." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "this mode is intended to be used so the current space can be mapped by the device if the robot has " +
-                "not previously done that, or if the layout has substantially changed, for an optimal subsequent " +
-                "cleaning experience.",
+                "> this mode is intended to be used so the current space can be mapped by the device if the robot has " +
+                "  not previously done that, or if the layout has substantially changed, for an optimal subsequent " +
+                "  cleaning experience.",
 
             xref: { document: "cluster", section: "7.2.7.2.3" }
         })

package/src/standard/elements/ScenesManagement.ts

@@ -26,9 +26,7 @@ export const ScenesManagement = Cluster(
             "In most cases scenes are associated with a particular group identifier. Scenes may also exist " +
             "without a group, in which case the value 0 replaces the group identifier. Note that extra care is " +
             "required in these cases to avoid a scene identifier collision, and that commands related to scenes " +
-            "without a group may only be unicast, i.e., they shall NOT be multicast or broadcast." +
-            "\n" +
-            "NOTE Support for Scenes Management cluster is provisional.",
+            "without a group may only be unicast, i.e., they shall NOT be multicast or broadcast.",
 
         xref: { document: "cluster", section: "1.4" }
     },
@@ -62,7 +60,7 @@ export const ScenesManagement = Cluster(
         name: "SceneTableSize", id: 0x1, type: "uint16", access: "R V", conformance: "M",
         constraint: "desc", default: 16, quality: "F",
         details: "Indicates the number of entries in the Scene Table on this endpoint. This is the total across all " +
-            "fabrics; note that a single fabric cannot use all those entries (see Handling of fabric- scoping). " +
+            "fabrics; note that a single fabric cannot use all those entries (see Handling of fabric-scoping). " +
             "The minimum size of this table, (i.e., the minimum number of scenes to support across all fabrics " +
             "per endpoint) shall be 16, unless a device type in which this cluster is used, defines a larger " +
             "value in the device type definition.",
@@ -573,9 +571,8 @@ export const ScenesManagement = Cluster(
                 "ValueSigned32, ValueUnsigned64, ValueSigned64 Fields" +
                 "\n" +
                 "These fields shall indicate the attribute value as part of an extension field set, associated with a " +
-                "given AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall" +
-                "\n" +
-                "be determined by the type of the attribute indicated by AttributeID as follows:" +
+                "given AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall be " +
+                "determined by the type of the attribute indicated by AttributeID as follows:" +
                 "\n" +
                 "  • Data types bool, map8, and uint8 shall map to ValueUnsigned8." +
                 "\n" +

package/src/standard/elements/ServiceArea.ts

@@ -75,11 +75,11 @@ export const ServiceArea = Cluster(
                 "\n" +
                 "An empty value indicates that the device is currently unable to provide the list of supported areas." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "due to the maximum size of this list and to the fact that the entries may include strings (see " +
-                "LocationName), care must be taken by implementers to avoid creating a data structure that is overly " +
-                "large, which can result in significant latency in accessing this attribute." +
+                "> due to the maximum size of this list and to the fact that the entries may include strings (see " +
+                "  LocationName), care must be taken by implementers to avoid creating a data structure that is " +
+                "  overly large, which can result in significant latency in accessing this attribute." +
                 "\n" +
                 "The value of this attribute may change at any time via an out-of-band interaction outside of the " +
                 "server, such as interactions with a user interface, or due to internal device changes." +
@@ -143,11 +143,12 @@ export const ServiceArea = Cluster(
                 "\n" +
                 "Each entry in this list shall have a unique value for the Name field." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "due to the maximum size of this list and to the fact that the entries may include strings (see the " +
-                "Name field of the MapStruct data type), care must be taken by implementers to avoid creating a data " +
-                "structure that is overly large, which can result in significant latency in accessing this attribute." +
+                "> due to the maximum size of this list and to the fact that the entries may include strings (see the " +
+                "  Name field of the MapStruct data type), care must be taken by implementers to avoid creating a " +
+                "  data structure that is overly large, which can result in significant latency in accessing this " +
+                "  attribute." +
                 "\n" +
                 "The value of this attribute may change at any time via an out-of-band interaction outside of the " +
                 "server, such as interactions with a user interface." +
@@ -155,10 +156,8 @@ export const ServiceArea = Cluster(
                 "When updating the SupportedMaps attribute list by deleting entries, or by setting the attribute to " +
                 "an empty list, the SupportedLocations attribute shall be updated such that all entries in that list " +
                 "meet the constraints indicated in the description of the SupportedLocations attribute. This may " +
-                "result in" +
-                "\n" +
-                "the server removing entries from the SupportedAreas attribute list. See the SupportedAreas attribute " +
-                "description for the implications of changing that attribute." +
+                "result in the server removing entries from the SupportedAreas attribute list. See the SupportedAreas " +
+                "attribute description for the implications of changing that attribute." +
                 "\n" +
                 "The SupportedMaps attribute list changes mentioned above SHOULD NOT be allowed while the device is " +
                 "operating, to reduce the impact on the clients, and the potential confusion for the users.",
@@ -207,9 +206,10 @@ export const ServiceArea = Cluster(
             "takes video of (serviced area) or which area it currently has in view but not taking video of (e.g. " +
             "an area which is traversed while panning)." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "A device may traverse an area regardless of the status of the area (pending, skipped, or completed)." +
+            "> A device may traverse an area regardless of the status of the area (pending, skipped, or " +
+            "  completed)." +
             "\n" +
             "If a device can simultaneously operate at multiple areas, such as in the case of a sensor that can " +
             "monitor multiple areas at the same time, the CurrentArea attribute shall NOT be implemented, since " +
@@ -252,10 +252,11 @@ export const ServiceArea = Cluster(
             "\n" +
             "  • when it changes to or from null" +
             "\n" +
-            "NOTE" +
+            "    > [!NOTE]" +
             "\n" +
-            "If the device is capable of pausing its operation, this attribute may be set to null, to indicate " +
-            "that completion time is unknown, or increment the value while being in the paused state.",
+            "    > If the device is capable of pausing its operation, this attribute may be set to null, to " +
+            "      indicate that completion time is unknown, or increment the value while being in the paused " +
+            "      state.",
 
         xref: { document: "cluster", section: "1.17.6.5" }
     }),
@@ -295,14 +296,14 @@ export const ServiceArea = Cluster(
                 "SupportedMaps or SupportedAreas attributes, so the clients can retrieve the progress information at " +
                 "that time." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "if the device implements the Operational Status cluster, or a derivation of it, in case the device " +
-                "fails to service any locations in the SelectedAreas list before ending the operation, it SHOULD use " +
-                "the Operational Status cluster to indicate that the device was unable to complete the operation (see " +
-                "the UnableToCompleteOperation error from that cluster specification). The clients SHOULD then read " +
-                "the Progress attribute, and indicate which areas have been successfully serviced (marked as " +
-                "completed).",
+                "> if the device implements the Operational Status cluster, or a derivation of it, in case the device " +
+                "  fails to service any locations in the SelectedAreas list before ending the operation, it SHOULD " +
+                "  use the Operational Status cluster to indicate that the device was unable to complete the " +
+                "  operation (see the UnableToCompleteOperation error from that cluster specification). The clients " +
+                "  SHOULD then read the Progress attribute, and indicate which areas have been successfully serviced " +
+                "  (marked as completed).",
 
             xref: { document: "cluster", section: "1.17.6.6" }
         },
@@ -349,9 +350,8 @@ export const ServiceArea = Cluster(
             name: "Status", id: 0x0, type: "SelectAreasStatus", conformance: "M",
 
             details: "If the Status field is set to Success or UnsupportedArea, the server may use a non-empty string for " +
-                "the StatusText field to provide additional information. For example, if Status is set to Unsupport" +
-                "\n" +
-                "edArea, the server may use StatusText to indicate which areas are unsupported." +
+                "the StatusText field to provide additional information. For example, if Status is set to " +
+                "UnsupportedArea, the server may use StatusText to indicate which areas are unsupported." +
                 "\n" +
                 "If the Status field is not set to Success, or UnsupportedArea, the StatusText field shall include a " +
                 "vendor-defined error description which can be used to explain the error to the user. For example, if " +
@@ -577,10 +577,10 @@ export const ServiceArea = Cluster(
                 "This SHOULD be used by clients to determine the name and/or the full, or the partial, semantics of a " +
                 "certain area." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "If any entries on the SupportedAreas attribute’s list have the AreaInfo field missing the semantic " +
-                "data, the client may remind the user to assign the respective data.",
+                "> If any entries on the SupportedAreas attribute’s list have the AreaInfo field missing the semantic " +
+                "  data, the client may remind the user to assign the respective data.",
 
             xref: { document: "cluster", section: "1.17.5.4.3" }
         })
@@ -617,9 +617,8 @@ export const ServiceArea = Cluster(
                 "A value of null indicates that the total operational time is unknown." +
                 "\n" +
                 "There may be cases where the total operational time exceeds the maximum value that can be conveyed " +
-                "by this attribute, and in such instances this attribute shall be populated with null." +
-                "\n" +
-                "Null if the Status field is not set to Completed or Skipped.",
+                "by this attribute, and in such instances this attribute shall be populated with null. Null if the " +
+                "Status field is not set to Completed or Skipped.",
 
             xref: { document: "cluster", section: "1.17.5.5.3" }
         }),

package/src/standard/elements/SmokeCoAlarm.ts

@@ -85,8 +85,8 @@ export const SmokeCoAlarm = Cluster(
 
     Attribute({
         name: "TestInProgress", id: 0x5, type: "bool", access: "R V", conformance: "M",
-        details: "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.",
+        details: "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.",
         xref: { document: "cluster", section: "2.11.6.6" }
     }),
 
@@ -302,12 +302,12 @@ export const SmokeCoAlarm = Cluster(
     ),
 
     Datatype(
-        {
-            name: "ExpressedStateEnum", type: "enum8",
+        { name: "ExpressedStateEnum", type: "enum8", xref: { document: "cluster", section: "2.11.5.3" } },
+        Field({
+            name: "Normal", id: 0x0, conformance: "M", description: "Nominal state, the device is not alarming",
             details: "This value shall indicate that this alarm is not alarming.",
-            xref: { document: "cluster", section: "2.11.5.3" }
-        },
-        Field({ name: "Normal", id: 0x0, conformance: "M", description: "Nominal state, the device is not alarming" }),
+            xref: { document: "cluster", section: "2.11.5.3.1" }
+        }),
 
         Field({
             name: "SmokeAlarm", id: 0x1, conformance: "SMOKE", description: "Smoke Alarm state",
@@ -408,14 +408,15 @@ export const SmokeCoAlarm = Cluster(
     ),
 
     Datatype(
-        {
-            name: "ContaminationStateEnum", type: "enum8",
+        { name: "ContaminationStateEnum", type: "enum8", xref: { document: "cluster", section: "2.11.5.6" } },
+
+        Field({
+            name: "Normal", id: 0x0, conformance: "M",
+            description: "Nominal state, the sensor is not contaminated",
             details: "This value shall indicate that the smoke sensor has nominal contamination levels, no customer action " +
                 "is required.",
-            xref: { document: "cluster", section: "2.11.5.6" }
-        },
-
-        Field({ name: "Normal", id: 0x0, conformance: "M", description: "Nominal state, the sensor is not contaminated" }),
+            xref: { document: "cluster", section: "2.11.5.6.1" }
+        }),
 
         Field({
             name: "Low", id: 0x1, conformance: "O", description: "Low contamination",

package/src/standard/elements/SoftwareDiagnostics.ts

@@ -109,7 +109,7 @@ export const SoftwareDiagnostics = Cluster(
             "\n" +
             "  • The CurrentHeapHighWatermark attribute This command has no payload." +
             "\n" +
-            "Effect on Receipt" +
+            "### Effect on Receipt" +
             "\n" +
             "On receipt of this command, the Node shall make the following modifications to attributes it " +
             "supports:" +

package/src/standard/elements/Switch.ts

@@ -322,13 +322,13 @@ export const Switch = Cluster(
                 "  • a value of N when there were exactly N presses in a multi-press sequence (and the sequence has " +
                 "    ended)." +
                 "\n" +
-                "NOTE" +
+                "    > [!NOTE]" +
                 "\n" +
-                "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.",
 
             xref: { document: "cluster", section: "1.13.6.7" }
         },