@matter/model 0.16.0-alpha.0-20251023-bb23617e5 → 0.16.0-alpha.0-20251027-17770fb28

package/src/standard/resources/service-area.resource.ts

@@ -131,10 +131,10 @@ Resource.add({
                 "server, such as interactions with a user interface." +
                 "\n" +
                 "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 the server removing entries from the SupportedAreas attribute list. See the SupportedAreas " +
-                "attribute description for the implications of changing that attribute." +
+                "an empty list, the SupportedAreas attribute shall be updated such that all entries in that list meet " +
+                "the constraints indicated in the description of the SupportedAreas attribute. This may 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."
@@ -202,7 +202,7 @@ Resource.add({
                 "Null if the CurrentArea attribute is null." +
                 "\n" +
                 "If the Progress attribute is available, and it contains an entry matching CurrentArea, the server " +
-                "may use the time estimate provided in the InitialTimeEstimate field of that entry to compute the " +
+                "may use the time estimate provided in the EstimatedTime field of that entry to compute the " +
                 "EstimatedEndTime attribute." +
                 "\n" +
                 "The value of this attribute shall only be reported in the following cases:" +
@@ -289,8 +289,8 @@ Resource.add({
                 tag: "field", name: "Status", xref: "cluster§1.17.7.2.1",
 
                 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 " +
-                    "UnsupportedArea, 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 Unsupport " +
+                    "edArea, 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 " +
@@ -301,13 +301,9 @@ Resource.add({
 
         {
             tag: "command", name: "SkipArea", xref: "cluster§1.17.7.3",
-
             details: "This command is used to skip the given area, and to attempt operating at other areas on the " +
                 "SupportedAreas attribute list." +
                 "\n" +
-                "This command shall NOT be implemented if the CurrentArea attribute and the Progress attribute are " +
-                "both not implemented. Else, this command shall be optionally implemented." +
-                "\n" +
                 "On receipt of this command the device shall respond with a SkipAreaResponse command.",
 
             children: [{
@@ -516,8 +512,9 @@ Resource.add({
                         "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. 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." +
+                        "\n" +
+                        "Null if the Status field is not set to Completed or Skipped."
                 },
 
                 {

package/src/standard/resources/smoke-co-alarm-cluster.resource.ts

@@ -233,13 +233,10 @@ Resource.add({
 
         {
             tag: "datatype", name: "ExpressedStateEnum", xref: "cluster§2.11.5.3",
+            details: "This value shall indicate that this alarm is not alarming.",
 
             children: [
-                {
-                    tag: "field", name: "Normal", description: "Nominal state, the device is not alarming",
-                    xref: "cluster§2.11.5.3.1",
-                    details: "This value shall indicate that this alarm is not alarming."
-                },
+                { tag: "field", name: "Normal", description: "Nominal state, the device is not alarming" },
 
                 {
                     tag: "field", name: "SmokeAlarm", description: "Smoke Alarm state", xref: "cluster§2.11.5.3.2",
@@ -338,15 +335,11 @@ Resource.add({
 
         {
             tag: "datatype", name: "ContaminationStateEnum", xref: "cluster§2.11.5.6",
+            details: "This value shall indicate that the smoke sensor has nominal contamination levels, no customer action " +
+                "is required.",
 
             children: [
-                {
-                    tag: "field", name: "Normal", description: "Nominal state, the sensor is not contaminated",
-                    xref: "cluster§2.11.5.6.1",
-                    details: "This value shall indicate that the smoke sensor has nominal contamination levels, no customer action " +
-                        "is required."
-                },
-
+                { tag: "field", name: "Normal", description: "Nominal state, the sensor is not contaminated" },
                 {
                     tag: "field", name: "Low", description: "Low contamination", xref: "cluster§2.11.5.6.2",
                     details: "This value shall indicate that the smoke sensor has detectable contamination levels, but the " +

package/src/standard/resources/software-diagnostics.resource.ts

@@ -27,48 +27,44 @@ Resource.add({
 
         {
             tag: "attribute", name: "ThreadMetrics", xref: "core§11.13.6.1",
-            details: "The ThreadMetrics attribute shall be a list of ThreadMetricsStruct structs. Each active thread on " +
-                "the Node shall be represented by a single entry within the ThreadMetrics attribute."
+            details: "This attribute shall be a list of ThreadMetricsStruct structs. Each active thread on the Node shall " +
+                "be represented by a single entry within the ThreadMetrics attribute."
         },
         {
             tag: "attribute", name: "CurrentHeapFree", xref: "core§11.13.6.2",
-            details: "The CurrentHeapFree attribute shall indicate the current amount of heap memory, in bytes, that are " +
-                "free for allocation. The effective amount may be smaller due to heap fragmentation or other reasons."
+            details: "Indicates the current amount of heap memory, in bytes, that are free for allocation. The effective " +
+                "amount may be smaller due to heap fragmentation or other reasons."
         },
         {
             tag: "attribute", name: "CurrentHeapUsed", xref: "core§11.13.6.3",
-            details: "The CurrentHeapUsed attribute shall indicate the current amount of heap memory, in bytes, that is " +
-                "being used."
+            details: "Indicates the current amount of heap memory, in bytes, that is being used."
         },
-
         {
             tag: "attribute", name: "CurrentHeapHighWatermark", xref: "core§11.13.6.4",
-            details: "The CurrentHeapHighWatermark attribute shall indicate the maximum amount of heap memory, in bytes, " +
-                "that has been used by the Node. This value shall only be reset upon a Node reboot or upon receiving " +
-                "of the ResetWatermarks command."
+            details: "Indicates the maximum amount of heap memory, in bytes, that has been used by the Node. This value " +
+                "shall only be reset upon a Node reboot or upon receiving of the ResetWatermarks command."
         },
 
         {
             tag: "event", name: "SoftwareFault", xref: "core§11.13.8.1",
-            details: "The SoftwareFault Event shall be generated when a software fault takes place on the Node.",
+            details: "This Event shall be generated when a software fault occurs on the Node.",
 
             children: [
                 {
                     tag: "field", name: "Id", xref: "core§11.13.8.1.1",
-                    details: "The ID field shall be set to the ID of the software thread in which the last software fault " +
-                        "occurred."
+                    details: "This field shall be set to the ID of the software thread in which the last software fault occurred."
                 },
                 {
                     tag: "field", name: "Name", xref: "core§11.13.8.1.2",
-                    details: "The Name field shall be set to a manufacturer-specified name or prefix of the software thread in " +
-                        "which the last software fault occurred."
+                    details: "This field shall be set to a manufacturer-specified name or prefix of the software thread in which " +
+                        "the last software fault occurred."
                 },
 
                 {
                     tag: "field", name: "FaultRecording", xref: "core§11.13.8.1.3",
-                    details: "The FaultRecording field shall be a manufacturer-specified payload intended to convey information to " +
-                        "assist in further diagnosing or debugging a software fault. The FaultRecording field may be used to " +
-                        "convey information such as, but not limited to, thread backtraces or register contents."
+                    details: "This field shall be a manufacturer-specified payload intended to convey information to assist in " +
+                        "further diagnosing or debugging a software fault. The FaultRecording field may be used to convey " +
+                        "information such as, but not limited to, thread backtraces or register contents."
                 }
             ]
         },
@@ -76,11 +72,13 @@ Resource.add({
         {
             tag: "command", name: "ResetWatermarks", xref: "core§11.13.7.1",
 
-            details: "Receipt of this command shall reset the following values which track high and lower watermarks:" +
+            details: "This command is used to reset the high watermarks for heap and stack memory." +
+                "\n" +
+                "Receipt of this command shall reset the following values which track high and lower watermarks:" +
                 "\n" +
                 "  • The StackFreeMinimum field of the ThreadMetrics attribute" +
                 "\n" +
-                "  • The CurrentHeapHighWatermark attribute This command has no payload." +
+                "  • The CurrentHeapHighWatermark attribute" +
                 "\n" +
                 "### Effect on Receipt" +
                 "\n" +

package/src/standard/resources/software-version-certification-status-enum.resource.ts

@@ -20,7 +20,7 @@ Resource.add({
         },
         {
             tag: "field", name: "Provisional",
-            description: "used for a SoftwareVersion when going into certification testing (These might or might not be placed in DCL, depending on CSA policy and procedures)"
+            description: "used for a SoftwareVersion when going into certification testing (These might or might not be placed in DCL, depending on the Connectivity Standards Alliance policy and procedures)"
         },
         { tag: "field", name: "Certified", description: "used for a SoftwareVersion which has been certified" },
         { tag: "field", name: "Revoked", description: "used for a SoftwareVersion which has been revoked" }

package/src/standard/resources/status.resource.ts

@@ -39,7 +39,7 @@ Resource.add({
         },
         {
             tag: "field", name: "InvalidCommand",
-            description: "The cluster command is malformed, has missing fields, or fields with invalid values.Command not carried out.",
+            description: "The cluster command is malformed, has missing fields, or fields with invalid values. Command not carried out.",
             xref: "core§8.10.1"
         },
         {
@@ -146,12 +146,27 @@ Resource.add({
         },
         {
             tag: "field", name: "TermsAndConditionsChanged",
-            description: "The node requires updated TC acceptance. The user MAY be directed to visit the EnhancedSetupFlowMaintenan ceUrl to complete this.",
+            description: "The node requires updated TC acceptance. The user MAY be directed to visit the EnhancedSetupFlowMaintenanceUrl to complete this.",
             xref: "core§8.10.1"
         },
         {
             tag: "field", name: "MaintenanceRequired",
-            description: "The node requires the user to visit the EnhancedSetupFlowMaintenan ceUrl for instructions on further action.",
+            description: "The node requires the user to visit the EnhancedSetupFlowMaintenanceUrl for instructions on further action.",
+            xref: "core§8.10.1"
+        },
+        {
+            tag: "field", name: "DynamicConstraintError",
+            description: "The value for the data type was not accepted due to runtime validation issues. Command or action not carried out.",
+            xref: "core§8.10.1"
+        },
+        {
+            tag: "field", name: "AlreadyExists",
+            description: "Attempt to create an entity that already exists or create an entity with an identifier that is already in use. Command or action not carried out.",
+            xref: "core§8.10.1"
+        },
+        {
+            tag: "field", name: "InvalidTransportType",
+            description: "Attempt to process on a transport type not valid for this element. Command or action not carried out.",
             xref: "core§8.10.1"
         }
     ]

package/src/standard/resources/struct.resource.ts

@@ -50,21 +50,21 @@ Resource.add({
         "  • The global FabricIndex field of a fabric-scoped struct shall be ignored in a write interaction." +
         "\n" +
         "  • The global FabricIndex field SHOULD NOT be indicated on a fabric-scoped struct contained in the " +
-        "    payload of a command request." +
+        "    payload of a request command." +
         "\n" +
         "  • The global FabricIndex field shall be ignored on a fabric-scoped struct contained in the payload " +
-        "    of a command request." +
+        "    of a request command." +
         "\n" +
         "  • When a write interaction creates a fabric-scoped struct entry (in a fabric-scoped list), the " +
         "    server shall implicitly load the accessing fabric-index into the global FabricIndex field of the " +
         "    struct." +
         "\n" +
-        "  • When the payload of a command request contains a fabric-scoped struct, the server shall " +
+        "  • When the payload of a request command contains a fabric-scoped struct, the server shall " +
         "    implicitly load the accessing fabric-index into the global FabricIndex field of the struct." +
         "\n" +
         "### • A fabric-scoped struct may be defined with some fields that are fabric-sensitive." +
         "\n" +
         "  • For interactions on a fabric-scoped struct that report back data, fabric-sensitive struct fields " +
-        "    shall NOT be indicated when reporting data back to the client, when the struct has an associated " +
+        "    shall be omitted when reporting data back to the client, when the struct has an associated " +
         "    fabric, and it is not the accessing fabric."
 });

package/src/standard/resources/subject-id.resource.ts

@@ -10,7 +10,7 @@ import { Resource } from "#models/Resource.js";
 
 Resource.add({
     tag: "datatype", name: "subject-id",
-    description: "A subject granted privileges to interact with a node.",
+    description: "A subject granted privileges to interact with a node.", xref: "core§7.19.2",
     details: "The Matter specifications do not define this formally as a global but the core specification " +
         "references it (as subject-id or SubjectID) from a number of different clusters."
 });

package/src/standard/resources/switch.resource.ts

@@ -55,7 +55,7 @@ Resource.add({
                 {
                     tag: "field", name: "AS", xref: "cluster§1.13.4.6",
                     details: "This feature flag indicates simplified handling of events for multi-press-capable switches. See " +
-                        "Multi Press Details."
+                        "Section 1.13.8, “Sequence of events for MultiPress”."
                 }
             ]
         },
@@ -63,7 +63,7 @@ Resource.add({
         {
             tag: "attribute", name: "NumberOfPositions", xref: "cluster§1.13.5.1",
             details: "Indicates the maximum number of positions the switch has. Any kind of switch has a minimum of 2 " +
-                "positions. Also see Multi Position Details for the case NumberOfPositions>2."
+                "positions. Also see Section 1.13.10, “Multi Position Details” for the case NumberOfPositions>2."
         },
 
         {
@@ -208,7 +208,7 @@ Resource.add({
                 "Otherwise, the following paragraphs describe the situations where this event is generated." +
                 "\n" +
                 "This event shall be generated to indicate how many times the momentary switch has been pressed in a " +
-                "multi-press sequence, during that sequence. See Multi Press Details below.",
+                "multi-press sequence, during that sequence. See Section 1.13.8, “Sequence of events for MultiPress”.",
 
             children: [
                 {
@@ -234,8 +234,8 @@ Resource.add({
             tag: "event", name: "MultiPressComplete", xref: "cluster§1.13.6.7",
 
             details: "This event shall be generated to indicate how many times the momentary switch has been pressed in a " +
-                "multi-press sequence, after it has been detected that the sequence has ended. See Multi Press " +
-                "Details." +
+                "multi-press sequence, after it has been detected that the sequence has ended. See Section 1.13.8, " +
+                "“Sequence of events for MultiPress”." +
                 "\n" +
                 "The PreviousPosition field shall indicate the previous value of the CurrentPosition attribute, i.e. " +
                 "just prior to release." +

package/src/standard/resources/switches.resource.ts

@@ -16,15 +16,16 @@ Resource.add({
         "switch device to allow a client to make an optimized user interface which matches the actual device " +
         "without requiring a-priori knowledge of the layout of each specific switch device." +
         "\n" +
-        "Please see the rules for applying these and other tags for switch devices, e.g. from the Common " +
-        "Position Namespace and the Common Number Namespace in the Generic Switch device type section in the " +
-        "Device Library.",
+        "See the rules for applying these and other tags for switch devices, e.g. from the Common Position " +
+        "Namespace and the Common Number Namespace in the Generic Switch device type section in the Device " +
+        "Library.",
 
     children: [
         { tag: "semanticTag", name: "Up", description: "e.g. dim up (light)" },
         { tag: "semanticTag", name: "Down", description: "e.g. dim down (light)" },
         { tag: "semanticTag", name: "Next", description: "e.g. select next scene" },
         { tag: "semanticTag", name: "Previous", description: "e.g. select previous scene" },
+        { tag: "semanticTag", name: "EnterOkSelect", description: "Enter/OK/Select function" },
 
         {
             tag: "semanticTag", name: "Custom", description: "Textual description provided in Label field",
@@ -32,6 +33,10 @@ Resource.add({
             details: "When this value is used, the Label field in the same Semantic Tag structure shall be filled with a " +
                 "textual description of the function indicated on the button, such as a label or icon printed on the " +
                 "button, e.g. \"dining\"."
-        }
+        },
+
+        { tag: "semanticTag", name: "Open", description: "e.g. open window covering" },
+        { tag: "semanticTag", name: "Close", description: "e.g. close window covering" },
+        { tag: "semanticTag", name: "Stop", description: "e.g. stop moving window covering" }
     ]
 });

package/src/standard/resources/tag.resource.ts

@@ -9,6 +9,6 @@
 import { Resource } from "#models/Resource.js";
 
 Resource.add({
-    tag: "datatype", name: "tag", description: "Tag", xref: "core§7.19.2.44",
+    tag: "datatype", name: "tag", description: "Tag", xref: "core§7.19.2.48",
     details: "The Tag type shall identify a semantic tag located within a namespace."
 });

package/src/standard/resources/temperature-control.resource.ts

@@ -64,8 +64,8 @@ Resource.add(
                 details: "Indicates the maximum temperature to which the TemperatureSetpoint attribute may be set." +
                     "\n" +
                     "If the Step attribute is supported, this attribute shall be such that MaxTemperature = " +
-                    "MinTemperature + Step * n, where n is an integer and n > 0. If the Step attribute is not supported, " +
-                    "this attribute shall be such that MaxTemperature > MinTemperature."
+                    "MinTemperature + (Step * n), where n is an integer and n > 0. If the Step attribute is not " +
+                    "supported, this attribute shall be such that MaxTemperature > MinTemperature."
             },
 
             {
@@ -75,8 +75,9 @@ Resource.add(
                     "SetTemperature command." +
                     "\n" +
                     "For example, if the value of MinTemperature is 25.00C (2500) and the Step value is 0.50C (50), valid " +
-                    "values of the TargetTemperature field of the SetTemperature command would be 25.50C (2550), 26.00C " +
-                    "(2600), 26.50C (2650), etc."
+                    "values of the TargetTemperature field of the SetTemperature command would be 25.50C" +
+                    "\n" +
+                    "(2550), 26.00C (2600), 26.50C (2650), etc."
             },
 
             {
@@ -102,6 +103,7 @@ Resource.add(
 
             {
                 tag: "command", name: "SetTemperature", xref: "cluster§8.2.6.1",
+                details: "This command is used to set the temperature setpoint.",
 
                 children: [
                     {

package/src/standard/resources/temperature.resource.ts

@@ -10,7 +10,7 @@ import { Resource } from "#models/Resource.js";
 
 Resource.add(
     {
-        tag: "datatype", name: "temperature", description: "Temperature", xref: "core§7.19.2.11",
+        tag: "datatype", name: "temperature", description: "Temperature", xref: "core§7.19.2.9",
 
         details: "This type represents a temperature on the Celsius scale with a resolution of 0.01°C." +
             "\n" +
@@ -20,7 +20,8 @@ Resource.add(
             "\n" +
             "### Conversion of Temperature Values for Display" +
             "\n" +
-            "When converting temperature values for display manufacturers SHOULD ensure that calculations" +
+            "When converting temperature values for display manufacturers SHOULD ensure that calculations round " +
+            "to the nearest representable value. Particular care is needed when using integer arithmetic." +
             "\n" +
             "### Sample Conversion Code" +
             "\n" +
@@ -30,7 +31,7 @@ Resource.add(
             "For degF: the value is a int8u representing 2x temperature value in Fahrenheit (to get 0.5 " +
             "resolution)." +
             "\n" +
-            "For degC: the value is a int16s representing Celsius in 0.01 resolution as expected by the ZCL " +
+            "For degC: the value is a int16s representing Celsius in 0.01 resolution as expected by the Matter " +
             "format."
     }
 );