@matter/types 0.13.0-alpha.0-20250311-3eb0af5f2 → 0.13.0-alpha.0-20250322-f085fa576

package/src/clusters/ecosystem-information.ts

@@ -25,8 +25,8 @@ export namespace EcosystemInformation {
      */
     export const TlvEcosystemDevice = TlvObject({
         /**
-         * This field shall indicate the device’s name, which is provided externally if the user consents. (For
-         * example, provided by the user in an ecosystem specific interface.)
+         * This field shall indicate the device’s name, which is provided externally if the user consents. (For example,
+         * provided by the user in an ecosystem specific interface.)
          *
          * @see {@link MatterSpecification.v13.Core} § 9.18.4.1.1
          */
@@ -108,18 +108,18 @@ export namespace EcosystemInformation {
          * This field shall indicate a unique identifier for a specific Ecosystem Information Cluster server instance
          * representing the location independent of its LocationDescriptor field.
          *
-         * UniqueLocationID can be used by the client to determine if the change is a relocation of the device or just
-         * a renaming of the location.
+         * UniqueLocationID can be used by the client to determine if the change is a relocation of the device or just a
+         * renaming of the location.
          *
          * No guarantees are given for consistency of the ID between server instances. The same location may be
-         * represented by different IDs on different Ecosystem Information Cluster server instances, so only the
-         * history from a single server instance should be considered when evaluating a change.
+         * represented by different IDs on different Ecosystem Information Cluster server instances, so only the history
+         * from a single server instance should be considered when evaluating a change.
          *
          * UniqueLocationID shall be changed when the LocationDescriptor changes from one existing location to another
          * location as a result of an external interaction. (For example, the user changes the location assignment.)
          *
-         * UniqueLocationID shall NOT be changed when the LocationDescriptor changes name, but still represents the
-         * same location. (For example, the user renames a room.)
+         * UniqueLocationID shall NOT be changed when the LocationDescriptor changes name, but still represents 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
@@ -159,10 +159,10 @@ export namespace EcosystemInformation {
     export const ClusterInstance = MutableCluster({ id: 0x750, name: "EcosystemInformation", revision: 1 });
 
     /**
-     * The Ecosystem Information Cluster provides extended device information for all the logical devices represented
-     * by a Bridged Node. The Ecosystem Information Cluster presents the view of device name and location metadata for
-     * presentation by a client of the cluster to a user. This cluster is intended to support Fabric Synchronization
-     * and be present on an endpoint with the BridgedNode device type listed in the DeviceTypeList of the endpoint’s
+     * The Ecosystem Information Cluster provides extended device information for all the logical devices represented by
+     * a Bridged Node. The Ecosystem Information Cluster presents the view of device name and location metadata for
+     * presentation by a client of the cluster to a user. This cluster is intended to support Fabric Synchronization and
+     * be present on an endpoint with the BridgedNode device type listed in the DeviceTypeList of the endpoint’s
      * Descriptor cluster.
      *
      * This augments the Bridged Device Basic Information Cluster in the following ways:
@@ -174,8 +174,8 @@ export namespace EcosystemInformation {
      *   • The Ecosystem Information Cluster adds metadata to support conflict resolution between multiple sources of
      *     the name and location data.
      *
-     *   • The Ecosystem Information Cluster supports user control for the presence of the name and location
-     *     information by specifying more restricted access.
+     *   • The Ecosystem Information Cluster supports user control for the presence of the name and location information
+     *     by specifying more restricted access.
      *
      * A client SHOULD use the information provided by the Ecosystem Information Cluster to help the user organize and
      * interact with their devices. Some examples may include:

package/src/clusters/electrical-energy-measurement.ts

@@ -45,10 +45,10 @@ export namespace ElectricalEnergyMeasurement {
         /**
          * CumulativeEnergy (CUME)
          *
-         * The feature indicates the server is capable of measuring how much energy has been imported or exported by
-         * the server over the device’s lifetime. This measurement may start from when a device’s firmware is updated
-         * to include this feature, when a device’s firmware is updated to correct measurement errors, or when a device
-         * is factory reset.
+         * The feature indicates the server is capable of measuring how much energy has been imported or exported by the
+         * server over the device’s lifetime. This measurement may start from when a device’s firmware is updated to
+         * include this feature, when a device’s firmware is updated to correct measurement errors, or when a device is
+         * factory reset.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.4.3
          */
@@ -57,9 +57,9 @@ export namespace ElectricalEnergyMeasurement {
         /**
          * PeriodicEnergy (PERE)
          *
-         * The feature indicates the server is capable of measuring how much energy has been imported or exported by
-         * the server during a certain period of time. The start and end times for measurement periods shall be
-         * determined by the server, and may represent overlapping periods.
+         * The feature indicates the server is capable of measuring how much energy has been imported or exported by the
+         * server during a certain period of time. The start and end times for measurement periods shall be determined
+         * by the server, and may represent overlapping periods.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.4.4
          */
@@ -86,8 +86,8 @@ export namespace ElectricalEnergyMeasurement {
          * recorded at either the value of the EndTimestamp field or the value of the EndSystime field, or both.
          *
          * If the EnergyMeasurementStruct represents periodic energy, then this shall represent the energy recorded
-         * during the period specified by either the StartTimestamp and EndTimestamp fields, the period specified by
-         * the StartSystime and EndSystime fields, or both.
+         * during the period specified by either the StartTimestamp and EndTimestamp fields, the period specified by the
+         * StartSystime and EndSystime fields, or both.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.1.1
          */
@@ -99,12 +99,11 @@ export namespace ElectricalEnergyMeasurement {
          *
          * If this EnergyMeasurementStruct represents cumulative energy, this field shall be omitted.
          *
-         * Otherwise, if the server had determined the time in UTC at or before the beginning of the measurement
-         * period, this field shall be indicated.
+         * Otherwise, if the server had determined the time in UTC at or before the beginning of the measurement period,
+         * this field shall be indicated.
          *
-         * Otherwise, if the server had not yet determined the time in UTC at or before the beginning of the
-         * measurement period, or does not have the capability of determining the time in UTC, this field shall be
-         * omitted.
+         * Otherwise, if the server had not yet determined the time in UTC at or before the beginning of the measurement
+         * period, or does not have the capability of determining the time in UTC, this field shall be omitted.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.1.2
          */
@@ -117,8 +116,8 @@ export namespace ElectricalEnergyMeasurement {
          * If the server had determined the time in UTC by the end of the measurement period, this field shall be
          * indicated.
          *
-         * Otherwise, if the server had not yet determined the time in UTC by the end of the measurement period, or
-         * does not have the capability of determining the time in UTC, this field shall be omitted.
+         * Otherwise, if the server had not yet determined the time in UTC by the end of the measurement period, or does
+         * not have the capability of determining the time in UTC, this field shall be omitted.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.1.3
          */
@@ -133,9 +132,9 @@ export namespace ElectricalEnergyMeasurement {
          *
          * period, or does not have the capability of determining the time in UTC, this field shall be indicated.
          *
-         * Otherwise, if the server had determined the time in UTC at or before the beginning of the measurement
-         * period, this field may be omitted; if it is indicated, its value shall be the time elapsed since boot at the
-         * UTC time indicated in StartTimestamp.
+         * Otherwise, if the server had determined the time in UTC at or before the beginning of the measurement period,
+         * this field may be omitted; if it is indicated, its value shall be the time elapsed since boot at the UTC time
+         * indicated in StartTimestamp.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.1.4
          */
@@ -186,11 +185,11 @@ export namespace ElectricalEnergyMeasurement {
          * CumulativeEnergyImported attribute was most recently zero, this field shall be indicated.
          *
          * Otherwise, if the server had not yet determined the time in UTC when the value of the Energy field on the
-         * CumulativeEnergyImported attribute was most recently zero, or does not have the capability of determining
-         * the time in UTC, this field shall be omitted.
+         * CumulativeEnergyImported attribute was most recently zero, or does not have the capability of determining the
+         * time in UTC, this field shall be omitted.
          *
-         * If the timestamp in UTC when the value of the Energy field on the CumulativeEnergyImported attribute was
-         * most recently zero cannot currently be determined, a value of null shall be returned.
+         * If the timestamp in UTC when the value of the Energy field on the CumulativeEnergyImported attribute was most
+         * recently zero cannot currently be determined, a value of null shall be returned.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.2.1
          */
@@ -204,11 +203,11 @@ export namespace ElectricalEnergyMeasurement {
          * CumulativeEnergyExported attribute was most recently zero, this field shall be indicated.
          *
          * Otherwise, if the server had not yet determined the time in UTC when the value of the Energy field on the
-         * CumulativeEnergyExported attribute was most recently zero, or does not have the capability of determining
-         * the time in UTC, this field shall be omitted.
+         * CumulativeEnergyExported attribute was most recently zero, or does not have the capability of determining the
+         * time in UTC, this field shall be omitted.
          *
-         * If the timestamp in UTC when the value of the Energy field on the CumulativeEnergyExported attribute was
-         * most recently zero cannot currently be determined, a value of null shall be returned.
+         * If the timestamp in UTC when the value of the Energy field on the CumulativeEnergyExported attribute was most
+         * recently zero cannot currently be determined, a value of null shall be returned.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.2.2
          */
@@ -219,12 +218,12 @@ export namespace ElectricalEnergyMeasurement {
          * CumulativeEnergyImported attribute was most recently zero.
          *
          * If the server had not yet determined the time in UTC when the value of the Energy field on the
-         * CumulativeEnergyImported attribute was most recently zero, or does not have the capability of determining
-         * the time in UTC, this field shall be indicated.
+         * CumulativeEnergyImported attribute was most recently zero, or does not have the capability of determining the
+         * time in UTC, this field shall be indicated.
          *
          * Otherwise, if the server had determined the time in UTC when the value of the Energy field on the
-         * CumulativeEnergyImported attribute was most recently zero, this field may be omitted; if it is indicated,
-         * its value shall be the time elapsed since boot at the UTC time indicated in ImportedResetTimestamp.
+         * CumulativeEnergyImported attribute was most recently zero, this field may be omitted; if it is indicated, its
+         * value shall be the time elapsed since boot at the UTC time indicated in ImportedResetTimestamp.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.2.3
          */
@@ -235,12 +234,12 @@ export namespace ElectricalEnergyMeasurement {
          * CumulativeEnergyExported attribute was most recently zero.
          *
          * If the server had not yet determined the time in UTC when the value of the Energy field on the
-         * CumulativeEnergyExported attribute was most recently zero, or does not have the capability of determining
-         * the time in UTC, this field shall be indicated.
+         * CumulativeEnergyExported attribute was most recently zero, or does not have the capability of determining the
+         * time in UTC, this field shall be indicated.
          *
          * Otherwise, if the server had determined the time in UTC when the value of the Energy field on the
-         * CumulativeEnergyExported attribute was most recently zero, this field may be omitted; if it is indicated,
-         * its value shall be the time elapsed since boot at the UTC time indicated in ImportedResetTimestamp.
+         * CumulativeEnergyExported attribute was most recently zero, this field may be omitted; if it is indicated, its
+         * value shall be the time elapsed since boot at the UTC time indicated in ImportedResetTimestamp.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.12.5.2.4
          */
@@ -376,8 +375,8 @@ export namespace ElectricalEnergyMeasurement {
     export const ImportedEnergyAndPeriodicEnergyComponent = MutableCluster.Component({
         attributes: {
             /**
-             * Indicates the most recent measurement of energy imported by the server and the period during which it
-             * was measured.
+             * Indicates the most recent measurement of energy imported by the server and the period during which it was
+             * measured.
              *
              * The reporting interval of this attribute shall be manufacturer dependent. The server may choose to omit
              * publication of deltas considered not meaningful.
@@ -403,8 +402,8 @@ export namespace ElectricalEnergyMeasurement {
     export const ExportedEnergyAndPeriodicEnergyComponent = MutableCluster.Component({
         attributes: {
             /**
-             * Indicates the most recent measurement of energy exported by the server and the period during which it
-             * was measured.
+             * Indicates the most recent measurement of energy exported by the server and the period during which it was
+             * measured.
              *
              * The reporting interval of this attribute shall be manufacturer dependent. The server may choose to omit
              * publication of deltas considered not meaningful.
@@ -493,8 +492,8 @@ export namespace ElectricalEnergyMeasurement {
             /**
              * CumulativeEnergy
              *
-             * The feature indicates the server is capable of measuring how much energy has been imported or exported
-             * by the server over the device’s lifetime. This measurement may start from when a device’s firmware is
+             * The feature indicates the server is capable of measuring how much energy has been imported or exported by
+             * the server over the device’s lifetime. This measurement may start from when a device’s firmware is
              * updated to include this feature, when a device’s firmware is updated to correct measurement errors, or
              * when a device is factory reset.
              *
@@ -505,8 +504,8 @@ export namespace ElectricalEnergyMeasurement {
             /**
              * PeriodicEnergy
              *
-             * The feature indicates the server is capable of measuring how much energy has been imported or exported
-             * by the server during a certain period of time. The start and end times for measurement periods shall be
+             * The feature indicates the server is capable of measuring how much energy has been imported or exported by
+             * the server during a certain period of time. The start and end times for measurement periods shall be
              * determined by the server, and may represent overlapping periods.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 2.12.4.4
@@ -624,8 +623,8 @@ export namespace ElectricalEnergyMeasurement {
     /**
      * This cluster supports all ElectricalEnergyMeasurement features. It may support illegal feature combinations.
      *
-     * If you use this cluster you must manually specify which features are active and ensure the set of active
-     * features is legal per the Matter specification.
+     * If you use this cluster you must manually specify which features are active and ensure the set of active features
+     * is legal per the Matter specification.
      */
     export interface Complete extends Identity<typeof CompleteInstance> {}
 

package/src/clusters/electrical-power-measurement.ts

@@ -148,8 +148,8 @@ export namespace ElectricalPowerMeasurement {
         measurementType: TlvField(0, TlvEnum<MeasurementType>()),
 
         /**
-         * This field shall be the smallest measured value for the associated measurement over either the period
-         * between StartTimestamp and EndTimestamp, or the period between StartSystime and EndSystime, or both.
+         * This field shall be the smallest measured value for the associated measurement over either the period between
+         * StartTimestamp and EndTimestamp, or the period between StartSystime and EndSystime, or both.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.13.5.2.2
          */
@@ -166,8 +166,8 @@ export namespace ElectricalPowerMeasurement {
         /**
          * This field shall be the timestamp in UTC of the beginning of the measurement period.
          *
-         * If the server had not yet determined the time in UTC at or before the beginning of the measurement period,
-         * or does not have the capability of determining the time in UTC, this field shall be omitted.
+         * If the server had not yet determined the time in UTC at or before the beginning of the measurement period, or
+         * does not have the capability of determining the time in UTC, this field shall be omitted.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.13.5.2.4
          */
@@ -176,8 +176,8 @@ export namespace ElectricalPowerMeasurement {
         /**
          * This field shall be the timestamp in UTC of the end of the measurement period.
          *
-         * If the server had not yet determined the time in UTC at or before the beginning of the measurement period,
-         * or does not have the capability of determining the time in UTC, this field shall be omitted.
+         * If the server had not yet determined the time in UTC at or before the beginning of the measurement period, or
+         * does not have the capability of determining the time in UTC, this field shall be omitted.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.13.5.2.5
          */
@@ -195,8 +195,8 @@ export namespace ElectricalPowerMeasurement {
 
         /**
          * This field shall be the most recent timestamp in UTC of the value in the Max field. This field shall be
-         * greater than or equal to the value of the StartTimestamp field. This field shall be less than or equal to
-         * the value of the EndTimestamp field.
+         * greater than or equal to the value of the StartTimestamp field. This field shall be less than or equal to the
+         * value of the EndTimestamp field.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.13.5.2.7
          */
@@ -205,8 +205,8 @@ export namespace ElectricalPowerMeasurement {
         /**
          * This field shall be the time since boot of the beginning of the measurement period.
          *
-         * If the server had determined the time in UTC at or before the start of the measurement period, this field
-         * may be omitted along with the EndSystime, MinSystime, and MaxSystime fields.
+         * If the server had determined the time in UTC at or before the start of the measurement period, this field may
+         * be omitted along with the EndSystime, MinSystime, and MaxSystime fields.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 2.13.5.2.8
          */
@@ -522,8 +522,8 @@ export namespace ElectricalPowerMeasurement {
     export const PolyphasePowerComponent = MutableCluster.Component({
         attributes: {
             /**
-             * This shall indicate the most recent NeutralCurrent reading in milliamps (mA). Typically this is a
-             * derived value, taking the magnitude of the vector sum of phase currents.
+             * This shall indicate the most recent NeutralCurrent reading in milliamps (mA). Typically this is a derived
+             * value, taking the magnitude of the vector sum of phase currents.
              *
              * If the neutral current cannot be measured or derived, a value of null shall be returned.
              *
@@ -819,8 +819,8 @@ export namespace ElectricalPowerMeasurement {
     /**
      * This cluster supports all ElectricalPowerMeasurement features. It may support illegal feature combinations.
      *
-     * If you use this cluster you must manually specify which features are active and ensure the set of active
-     * features is legal per the Matter specification.
+     * If you use this cluster you must manually specify which features are active and ensure the set of active features
+     * is legal per the Matter specification.
      */
     export interface Complete extends Identity<typeof CompleteInstance> {}
 

package/src/clusters/energy-evse-mode.ts

@@ -8,7 +8,7 @@
 
 import { MutableCluster } from "../cluster/mutation/MutableCluster.js";
 import { BitFlag } from "../schema/BitmapSchema.js";
-import { FixedAttribute, Attribute, Command, TlvNoResponse } from "../cluster/Cluster.js";
+import { FixedAttribute, Attribute, Command } from "../cluster/Cluster.js";
 import { TlvArray } from "../tlv/TlvArray.js";
 import { TlvField, TlvOptionalField, TlvObject } from "../tlv/TlvObject.js";
 import { TlvString } from "../tlv/TlvString.js";
@@ -86,8 +86,8 @@ export namespace EnergyEvseMode {
         Day = 9,
 
         /**
-         * While in modes with this tag, and once enabled with the EnableCharging command, the EVSE will permit
-         * charging based on demand from the EV.
+         * While in modes with this tag, and once enabled with the EnableCharging command, the EVSE will permit charging
+         * based on demand from the EV.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 9.4.7.1.1
          */
@@ -119,8 +119,8 @@ export namespace EnergyEvseMode {
          *
          * NOTE
          *
-         * being in a mode with this tag set or not does not affect the handling of the EnableDischarging command by
-         * the Energy EVSE cluster, but once enabled, only modes with this tag enable the discharging to actually occur.
+         * being in a mode with this tag set or not does not affect the handling of the EnableDischarging command by the
+         * Energy EVSE cluster, but once enabled, only modes with this tag enable the discharging to actually occur.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 9.4.7.1.4
          */
@@ -188,9 +188,9 @@ export namespace EnergyEvseMode {
         mode: TlvField(1, TlvUInt8),
 
         /**
-         * This field shall contain a list of tags that are associated with the mode option. This may be used by
-         * clients to determine the full or the partial semantics of a certain mode, depending on which tags they
-         * understand, using standard definitions and/or manufacturer specific namespace definitions.
+         * This field shall contain a list of tags that are associated with the mode option. This may be used by clients
+         * to determine the full or the partial semantics of a certain mode, depending on which tags they understand,
+         * using standard definitions and/or manufacturer specific namespace definitions.
          *
          * The standard mode tags are defined in this cluster specification. For the derived cluster instances, if the
          * specification of the derived cluster defines a namespace, the set of standard mode tags also includes the
@@ -201,8 +201,8 @@ export namespace EnergyEvseMode {
          * the mode in an automation, or to craft help text their voice-driven interfaces. A mode tag shall be either a
          * standard tag or a manufacturer specific tag, as defined in each ModeTagStruct list entry.
          *
-         * A mode option may have more than one mode tag. A mode option may be associated with a mixture of standard
-         * and manufacturer specific mode tags. A mode option shall be associated with at least one standard mode tag.
+         * A mode option may have more than one mode tag. A mode option may be associated with a mixture of standard and
+         * manufacturer specific mode tags. A mode option shall be associated with at least one standard mode tag.
          *
          * A few examples are provided below.
          *
@@ -286,7 +286,7 @@ export namespace EnergyEvseMode {
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.10.7.1
              */
-            changeToMode: Command(0x0, ModeBase.TlvChangeToModeRequest, 0x0, TlvNoResponse)
+            changeToMode: Command(0x0, ModeBase.TlvChangeToModeRequest, 0x1, ModeBase.TlvChangeToModeResponse)
         },
 
         /**