@matter/model 0.16.0-alpha.0-20251023-bb23617e5 → 0.16.0-alpha.0-20251029-bd92894d4

package/src/standard/resources/battery-storage.resource.ts

@@ -15,5 +15,5 @@ Resource.add({
         "monitored and controlled by an Energy Management System in order to manage the peaks and troughs of " +
         "supply and demand, and/or to optimize cost of the energy consumed in premises. It is not intended to " +
         "be used for a UPS directly supplying a set of appliances, nor for portable battery storage devices.",
-    children: [{ tag: "requirement", name: "Identify", xref: "device§14.4.6" }]
+    children: [{ tag: "requirement", name: "Identify", xref: "device§14.4.7" }]
 });

package/src/standard/resources/boolean-state-configuration.resource.ts

@@ -108,10 +108,10 @@ Resource.add(
             {
                 tag: "attribute", name: "AlarmsEnabled", xref: "cluster§1.8.6.6",
 
-                details: "Indicates the alarm modes that will be emitted if the sensor is triggered." +
+                details: "Indicates the alarm modes that will be emitted if the sensor is triggered. If an alarm mode is not " +
+                    "supported, the bit indicating this alarm mode shall always be 0." +
                     "\n" +
-                    "If an alarm mode is not supported, the bit indicating this alarm mode shall always be 0. A bit shall " +
-                    "indicate whether the alarm mode is enabled or disabled:" +
+                    "A bit shall indicate whether the alarm mode is enabled or disabled:" +
                     "\n" +
                     "  • 0 = Disabled" +
                     "\n" +

package/src/standard/resources/bridged-device-basic-information.resource.ts

@@ -12,8 +12,10 @@ Resource.add({
     tag: "cluster", name: "BridgedDeviceBasicInformation", classification: "endpoint", pics: "BRBINFO",
     xref: "core§9.13",
 
-    details: "This cluster is a derived cluster of the Basic Information cluster and serves two purposes towards a " +
-        "Node communicating with a Bridge:" +
+    details: "This cluster provides attributes and events for determining basic information about Bridged Nodes." +
+        "\n" +
+        "This cluster is derived from the Basic Information cluster and serves two purposes towards a Node " +
+        "communicating with a Bridge:" +
         "\n" +
         "  • Indicate that the functionality on the Endpoint where it is placed (and its Parts) is bridged, " +
         "    and" +
@@ -63,7 +65,7 @@ Resource.add({
         { tag: "attribute", name: "LocalConfigDisabled", xref: "core§9.13.5" },
 
         {
-            tag: "attribute", name: "Reachable", xref: "core§9.13.5.1",
+            tag: "attribute", name: "Reachable", xref: "core§9.13.5.2",
 
             details: "This attribute shall be used to indicate whether the bridged device is reachable by the bridge, so a " +
                 "Matter Node which wants to communicate with a bridged device can get an indication that this might " +
@@ -77,18 +79,35 @@ Resource.add({
         },
 
         {
-            tag: "attribute", name: "UniqueId", xref: "core§9.13.5.2",
+            tag: "attribute", name: "UniqueId", xref: "core§9.13.5.3",
+
             details: "This attribute shall, for a Bridged Device, be updated when the Bridge is factory reset. If the " +
                 "bridged device does not provide some unique id (e.g. in the case of bridging from non-Matter " +
                 "devices, or in case of bridging Matter devices from an earlier revision which were not required to " +
                 "provide a UniqueID attribute), the bridge shall generate a unique id on behalf of the bridged " +
-                "device."
+                "device." +
+                "\n" +
+                "NOTE The UniqueID attribute was optional in cluster revisions prior to revision 4."
         },
 
         { tag: "attribute", name: "CapabilityMinima", xref: "core§9.13.5" },
         { tag: "attribute", name: "ProductAppearance", xref: "core§9.13.5" },
         { tag: "attribute", name: "SpecificationVersion", xref: "core§9.13.5" },
         { tag: "attribute", name: "MaxPathsPerInvoke", xref: "core§9.13.5" },
+
+        {
+            tag: "attribute", name: "ConfigurationVersion", xref: "core§9.13.5.4",
+
+            details: "This attribute shall contain the current version number for the configuration of the bridged device." +
+                "\n" +
+                "If the bridge detects a change on a bridged device, which it deems as a change in the configuration " +
+                "of the bridged device, it shall increase this attribute as described in Section 9.2.9, “Node " +
+                "Configuration Changes”." +
+                "\n" +
+                "The ability and the method used to detect such a change on a bridged device is manufacturer " +
+                "specific."
+        },
+
         { tag: "event", name: "StartUp", xref: "core§9.13.7" },
         { tag: "event", name: "ShutDown", xref: "core§9.13.7" },
 

package/src/standard/resources/casting-video-player.resource.ts

@@ -22,9 +22,9 @@ Resource.add({
         "For example, a Casting Video Player can be a smart TV device, a TV Set Top Box, or a content " +
         "streaming device that provides input to another device like a TV or computer monitor." +
         "\n" +
-        "Please see Video Player Architecture for additional Casting Video Player requirements relating to " +
-        "Video Player device endpoint composition, commissioning, feature representation in clusters, and UI " +
-        "context.",
+        "See Section 10.1, “Video Player Architecture” for additional Casting Video Player requirements " +
+        "relating to Video Player device endpoint composition, commissioning, feature representation in " +
+        "clusters, and UI context.",
 
     children: [
         { tag: "requirement", name: "OnOff", xref: "device§10.3.4" },

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

@@ -112,6 +112,10 @@ Resource.add({
             details: "This command provides channel up and channel down functionality, but allows channel index jumps of " +
                 "size Count." +
                 "\n" +
+                "Jumps are relative to the available list of channels. For example, when the current channel is 100.0 " +
+                "and the list of available channels is [100.0, 200.0, 201.0, 305.1], a SkipChannel command with jump " +
+                "value of 2 shall change the channel to 201.0." +
+                "\n" +
                 "When the value of the increase or decrease is larger than the number of channels remaining in the " +
                 "given direction, then the behavior shall be to return to the beginning (or end) of the channel list " +
                 "and continue. For example, if the current channel is at index 0 and count value of -1 is given, then " +

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

@@ -10,8 +10,17 @@ import { Resource } from "#models/Resource.js";
 
 Resource.add({
     tag: "semanticNamespace", name: "Closure", xref: "namespace§2",
+
     details: "The tags contained in this namespace may be used in any domain or context, to indicate an " +
-        "association with a feature of a Closure, e.g. the button to activate opening a garage door.",
+        "association with a feature of a Closure, e.g. the button to activate opening a garage door." +
+        "\n" +
+        "> [!NOTE]" +
+        "\n" +
+        "> This namespace has been deprecated as of Matter 1.4.2." +
+        "\n" +
+        "Clients SHOULD still have support for these tags, since the tags could be used by a server certified " +
+        "on a previous revision of Matter.",
+
     children: [
         { tag: "semanticTag", name: "Opening", description: "Move toward open position" },
         { tag: "semanticTag", name: "Closing", description: "Move toward closed position" },

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

@@ -138,8 +138,7 @@ Resource.add(
 
             {
                 tag: "attribute", name: "DriftCompensation", xref: "cluster§3.2.7.7",
-                details: "This attribute shall indicate what mechanism, if any, is in use for compensation for color/intensity " +
-                    "drift over time."
+                details: "Indicates what mechanism, if any, is in use for compensation for color/intensity drift over time."
             },
             {
                 tag: "attribute", name: "CompensationText", xref: "cluster§3.2.7.8",
@@ -234,11 +233,18 @@ Resource.add(
 
             {
                 tag: "attribute", name: "Primary1Intensity", xref: "cluster§3.2.7.27",
-                details: "Indicates a representation of the maximum intensity of this primary as defined in the Dimming Light " +
-                    "Curve in the Ballast Configuration cluster (see Ballast Configuration Cluster), normalized such that " +
-                    "the primary with the highest maximum intensity contains the value 254." +
+
+                details: "Indicates a representation of the maximum intensity of this primary as defined in Section 3.1.3, " +
+                    "“The Dimming Light Curve”, normalized such that the primary with the highest maximum intensity " +
+                    "contains the value 254." +
+                    "\n" +
+                    "A value of null shall indicate that this primary is not available." +
                     "\n" +
-                    "A value of null shall indicate that this primary is not available."
+                    "3.2.7.28. Primary2X, Primary2Y, Primary2Intensity, Primary3X, Primary3Y, Primary3Intensity, " +
+                    "Primary4X, Primary4Y, Primary4Intensity, Primary5X, Primary5Y, Primary5Intensity, Primary6X, " +
+                    "Primary6Y and Primary6Intensity Attributes These attributes shall represent the capabilities of the " +
+                    "2nd, 3rd, 4th, 5th and 6th primaries, where present, in the same way as for the Primary1X, Primary1Y " +
+                    "and Primary1Intensity attributes."
             },
 
             { tag: "attribute", name: "Primary2X", xref: "cluster§3.2.7" },
@@ -295,11 +301,20 @@ Resource.add(
 
             {
                 tag: "attribute", name: "ColorPointRIntensity", xref: "cluster§3.2.7.33",
-                details: "Indicates a representation of the relative intensity of the red color point as defined in the " +
-                    "Dimming Light Curve in the Ballast Configuration cluster (see Ballast Configuration Cluster), " +
-                    "normalized such that the color point with the highest relative intensity contains the value 254." +
+
+                details: "Indicates a representation of the relative intensity of the red color point as defined in Section " +
+                    "3.1.3, “The Dimming Light Curve”, normalized such that the color point with the highest relative " +
+                    "intensity contains the value 254." +
+                    "\n" +
+                    "A value of null shall indicate an invalid value." +
                     "\n" +
-                    "A value of null shall indicate an invalid value."
+                    "3.2.7.34. ColorPointGX, ColorPointGY, ColorPointGIntensity, ColorPointBX, ColorPointBY and " +
+                    "ColorPointBIntensity Attributes These attributes shall represent the chromaticity values and " +
+                    "intensities of the green and blue color points, in the same way as for the ColorPointRX, " +
+                    "ColorPointRY and ColorPointRIntensity attributes." +
+                    "\n" +
+                    "If any one of these red, green or blue color point attributes is implemented then they shall all be " +
+                    "implemented."
             },
 
             { tag: "attribute", name: "ColorPointGx", xref: "cluster§3.2.7" },
@@ -348,8 +363,8 @@ Resource.add(
 
             {
                 tag: "attribute", name: "ColorLoopDirection", xref: "cluster§3.2.7.15",
-                details: "Indicates the current direction of the color loop. If this attribute has the value 0, the " +
-                    "EnhancedCurrentHue attribute shall be decremented. If this attribute has the value 1, the " +
+                details: "Indicates the current direction of the color loop. If this attribute has the value Decrement, the " +
+                    "EnhancedCurrentHue attribute shall be decremented. If this attribute has the value Increment, the " +
                     "EnhancedCurrentHue attribute shall be incremented."
             },
 
@@ -392,18 +407,16 @@ Resource.add(
 
             {
                 tag: "attribute", name: "ColorTempPhysicalMinMireds", xref: "cluster§3.2.7.20",
-                details: "This attribute shall indicate the minimum mired value supported by the hardware. " +
-                    "ColorTempPhysicalMinMireds corresponds to the maximum color temperature in kelvins supported by the " +
-                    "hardware." +
+                details: "Indicates the minimum mired value supported by the hardware. ColorTempPhysicalMinMireds corresponds " +
+                    "to the maximum color temperature in kelvins supported by the hardware." +
                     "\n" +
                     "ColorTempPhysicalMinMireds <= ColorTemperatureMireds."
             },
 
             {
                 tag: "attribute", name: "ColorTempPhysicalMaxMireds", xref: "cluster§3.2.7.21",
-                details: "This attribute shall indicate the maximum mired value supported by the hardware. " +
-                    "ColorTempPhysicalMaxMireds corresponds to the minimum color temperature in kelvins supported by the " +
-                    "hardware." +
+                details: "Indicates the maximum mired value supported by the hardware. ColorTempPhysicalMaxMireds corresponds " +
+                    "to the minimum color temperature in kelvins supported by the hardware." +
                     "\n" +
                     "ColorTemperatureMireds <= ColorTempPhysicalMaxMireds."
             },
@@ -423,7 +436,9 @@ Resource.add(
                     "Note that since this attribute is stored as a micro reciprocal degree (mired) value (i.e. color " +
                     "temperature in kelvins = 1,000,000 / CoupleColorTempToLevelMinMireds), the " +
                     "CoupleColorTempToLevelMinMireds attribute corresponds to an upper bound on the value of the color " +
-                    "temperature in kelvins supported by the device."
+                    "temperature" +
+                    "\n" +
+                    "in kelvins supported by the device."
             },
 
             {
@@ -693,7 +708,11 @@ Resource.add(
 
             {
                 tag: "command", name: "StopMoveStep", xref: "cluster§3.2.8.20",
-                details: "This command is provided to allow MoveTo and Step commands to be stopped."
+                details: "This command is provided to allow MoveTo and Step commands to be stopped." +
+                    "\n" +
+                    "NOTE This automatically provides symmetry to the Level Control cluster." +
+                    "\n" +
+                    "NOTE The StopMoveStep command has no effect on an active color loop."
             },
 
             {
@@ -717,11 +736,8 @@ Resource.add(
                         details: "This field shall indicate a lower bound on the ColorTemperatureMireds attribute (≡ an upper bound on " +
                             "the color temperature in kelvins) for the current move operation" +
                             "\n" +
-                            "ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <=" +
-                            "\n" +
-                            "### ColorTemperatureMireds" +
-                            "\n" +
-                            "As such if the move operation takes the ColorTemperatureMireds attribute towards the value of the " +
+                            "ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <= ColorTemperatureMireds As such " +
+                            "if the move operation takes the ColorTemperatureMireds attribute towards the value of the " +
                             "ColorTemperatureMinimumMireds field it shall be clipped so that the above invariant is satisfied. If " +
                             "the ColorTemperatureMinimumMireds field is set to 0, ColorTempPhysicalMinMireds shall be used as the " +
                             "lower bound for the ColorTemperatureMireds attribute."
@@ -733,11 +749,8 @@ Resource.add(
                         details: "This field shall indicate an upper bound on the ColorTemperatureMireds attribute (≡ a lower bound on " +
                             "the color temperature in kelvins) for the current move operation" +
                             "\n" +
-                            "ColorTemperatureMireds <= ColorTemperatureMaximumMireds field <=" +
-                            "\n" +
-                            "### ColorTempPhysicalMaxMireds" +
-                            "\n" +
-                            "As such if the move operation takes the ColorTemperatureMireds attribute towards the value of the " +
+                            "ColorTemperatureMireds <= ColorTemperatureMaximumMireds field <= ColorTempPhysicalMaxMireds As such " +
+                            "if the move operation takes the ColorTemperatureMireds attribute towards the value of the " +
                             "ColorTemperatureMaximumMireds field it shall be clipped so that the above invariant is satisfied. If " +
                             "the ColorTemperatureMaximumMireds field is set to 0, ColorTempPhysicalMaxMireds shall be used as the " +
                             "upper bound for the ColorTemperatureMireds attribute."
@@ -773,11 +786,8 @@ Resource.add(
                         details: "This field shall indicate a lower bound on the ColorTemperatureMireds attribute (≡ an upper bound on " +
                             "the color temperature in kelvins) for the current step operation" +
                             "\n" +
-                            "ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <=" +
-                            "\n" +
-                            "### ColorTemperatureMireds" +
-                            "\n" +
-                            "As such if the step operation takes the ColorTemperatureMireds attribute towards the value of the " +
+                            "ColorTempPhysicalMinMireds <= ColorTemperatureMinimumMireds field <= ColorTemperatureMireds As such " +
+                            "if the step operation takes the ColorTemperatureMireds attribute towards the value of the " +
                             "ColorTemperatureMinimumMireds field it shall be clipped so that the above invariant is satisfied. If " +
                             "the ColorTemperatureMinimumMireds field is set to 0, ColorTempPhysicalMinMireds shall be used as the " +
                             "lower bound for the ColorTemperatureMireds attribute."
@@ -964,7 +974,7 @@ Resource.add(
                     { tag: "field", name: "Deactivate", description: "De-activate the color loop." },
                     {
                         tag: "field", name: "ActivateFromColorLoopStartEnhancedHue",
-                        description: "Activate the color loop from the value in the ColorLoopStartEnhance dHue field."
+                        description: "Activate the color loop from the value in the ColorLoopStartEnhancedHue field."
                     },
                     {
                         tag: "field", name: "ActivateFromEnhancedCurrentHue",

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

@@ -39,7 +39,11 @@ Resource.add({
                 "\n" +
                 "> The approval is valid for a period determined by the manufacturer and characteristics of the node " +
                 "  presenting the Commissioner Control Cluster. Clients SHOULD send the CommissionNode command " +
-                "  immediately upon receiving a CommissioningRequestResult event."
+                "  immediately upon receiving a CommissioningRequestResult event." +
+                "\n" +
+                "11.26.7.2. RequestID / ClientNodeID Fields The RequestID shall match the RequestID provided to " +
+                "RequestCommissioningApproval and the ClientNodeID shall match the NodeID of the client which " +
+                "generated the RequestCommissioningApproval command."
         },
 
         {
@@ -106,8 +110,8 @@ Resource.add({
                 "\n" +
                 "> [!NOTE]" +
                 "\n" +
-                "> This is an alias onto the Open Commissioning Window command within the Administrator Commissioning " +
-                "  Cluster. Refer to the Open Commissioning Window command for a description of the command behavior " +
+                "> This is an alias onto the OpenCommissioningWindow command within the Administrator Commissioning " +
+                "  Cluster. Refer to the OpenCommissioningWindow command for a description of the command behavior " +
                 "  and parameters." +
                 "\n" +
                 "The parameters for ReverseOpenCommissioningWindow command are as follows:"

package/src/standard/resources/concentration-measurement.resource.ts

@@ -22,7 +22,7 @@ Resource.add({
                 { tag: "field", name: "MEA", details: "Cluster supports numeric measurement of substance" },
                 {
                     tag: "field", name: "LEV",
-                    details: "Cluster supports basic level indication for substance using the ConcentrationLev el enum"
+                    details: "Cluster supports basic level indication for substance using the ConcentrationLevel enum"
                 },
                 { tag: "field", name: "MED", details: "Cluster supports the Medium Concentration Level" },
                 { tag: "field", name: "CRI", details: "Cluster supports the Critical Concentration Level" },
@@ -72,8 +72,7 @@ Resource.add({
 
         {
             tag: "attribute", name: "AverageMeasuredValueWindow", xref: "cluster§2.10.6.7",
-            details: "This attribute shall represent the window of time used for determining the AverageMeasuredValue. The " +
-                "value is in seconds."
+            details: "Indicates the window of time used for determining the AverageMeasuredValue. The value is in seconds."
         },
         {
             tag: "attribute", name: "Uncertainty", xref: "cluster§2.10.6.8",
@@ -86,7 +85,8 @@ Resource.add({
         },
         {
             tag: "attribute", name: "MeasurementMedium", xref: "cluster§2.10.6.10",
-            details: "Indicates the medium in which MeasuredValue is being measured. See MeasurementMediumEnum."
+            details: "Indicates the medium in which MeasuredValue or LevelValue is being measured. See " +
+                "MeasurementMediumEnum."
         },
         {
             tag: "attribute", name: "LevelValue", xref: "cluster§2.10.6.11",

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

@@ -17,7 +17,9 @@ Resource.add({
         "\n" +
         "This cluster allows to configure content control settings by clients with the Management privilege. " +
         "It is responsibility of the end product to enforce appropriate right access (for example, to prevent " +
-        "a child from disabling this feature).",
+        "a child from disabling this feature)." +
+        "\n" +
+        "NOTE Support for Content Control cluster is provisional.",
 
     children: [
         {
@@ -140,8 +142,7 @@ Resource.add({
                 "activated. If this attribute equals FALSE, then playback of unrated content shall be permitted. " +
                 "Otherwise, the media device shall prevent the playback of unrated content." +
                 "\n" +
-                "When this attribute changes, the device SHOULD make the user aware of any limits of this feature." +
-                "\n" +
+                "When this attribute changes, the device SHOULD make the user aware of any limits of this feature. " +
                 "For example, if the feature does not control content within apps, then the device should make this " +
                 "clear to the user when the attribute changes."
         },
@@ -309,7 +310,7 @@ Resource.add({
             details: "The purpose of this command is to specify whether programs with no Content rating must be blocked by " +
                 "this media device." +
                 "\n" +
-                "Upon receipt of the UnblockUnratedContent command, the media device shall set the BlockUnrated " +
+                "Upon receipt of the UnblockUnratedContent command, the media device shall set the BlockUn rated " +
                 "attribute to FALSE."
         },
 
@@ -536,8 +537,8 @@ Resource.add({
             children: [
                 {
                     tag: "field", name: "CatalogVendorId", xref: "cluster§6.13.5.4.1",
-                    details: "This field shall indicate the CSA-issued vendor ID for the catalog. The DIAL registry shall use " +
-                        "value 0x0000." +
+                    details: "This field shall indicate the Connectivity Standards Alliance-issued vendor ID for the catalog. The " +
+                        "DIAL registry shall use value 0x0000." +
                         "\n" +
                         "Content App Platform providers will have their own catalog vendor ID (set to their own Vendor ID) " +
                         "and will assign an ApplicationID to each Content App."