@matter/types 0.16.0-alpha.0-20251022-5a69ce65a → 0.16.0-alpha.0-20251027-17770fb28

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

@@ -15,7 +15,6 @@ import { TlvField, TlvObject, TlvOptionalField } from "../tlv/TlvObject.js";
 import { TypeFromSchema } from "../tlv/TlvSchema.js";
 import { BitFlag } from "../schema/BitmapSchema.js";
 import { TlvMeasurementAccuracy } from "../globals/MeasurementAccuracy.js";
-import { MeasurementType } from "../globals/MeasurementType.js";
 import { Priority } from "../globals/Priority.js";
 import { Identity } from "#general";
 import { ClusterRegistry } from "../cluster/ClusterRegistry.js";
@@ -74,14 +73,14 @@ export namespace ElectricalPowerMeasurement {
     }
 
     /**
-     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3
+     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.4
      */
     export const TlvHarmonicMeasurement = TlvObject({
         /**
          * This field shall be the order of the harmonic being measured. Typically this is an odd number, but servers
          * may choose to report even harmonics.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.1
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.4.1
          */
         order: TlvField(0, TlvUInt8.bound({ min: 1 })),
 
@@ -98,13 +97,13 @@ export namespace ElectricalPowerMeasurement {
          *
          * If this measurement is not currently available, a value of null shall be returned.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.2
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.4.2
          */
         measurement: TlvField(1, TlvNullable(TlvInt64))
     });
 
     /**
-     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3
+     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.4
      */
     export interface HarmonicMeasurement extends TypeFromSchema<typeof TlvHarmonicMeasurement> {}
 
@@ -125,6 +124,93 @@ export namespace ElectricalPowerMeasurement {
         Ac = 2
     }
 
+    /**
+     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2
+     */
+    export enum MeasurementType {
+        Unspecified = 0,
+
+        /**
+         * Voltage in millivolts (mV)
+         */
+        Voltage = 1,
+
+        /**
+         * Active current in milliamps (mA)
+         */
+        ActiveCurrent = 2,
+
+        /**
+         * Reactive current in milliamps (mA)
+         */
+        ReactiveCurrent = 3,
+
+        /**
+         * Apparent current in milliamps (mA)
+         */
+        ApparentCurrent = 4,
+
+        /**
+         * Active power in milliwatts (mW)
+         */
+        ActivePower = 5,
+
+        /**
+         * Reactive power in millivolt-amps reactive (mVAR)
+         */
+        ReactivePower = 6,
+
+        /**
+         * Apparent power in millivolt-amps (mVA)
+         */
+        ApparentPower = 7,
+
+        /**
+         * Root mean squared voltage in millivolts (mV)
+         */
+        RmsVoltage = 8,
+
+        /**
+         * Root mean squared current in milliamps (mA)
+         */
+        RmsCurrent = 9,
+
+        /**
+         * Root mean squared power in milliwatts (mW)
+         */
+        RmsPower = 10,
+
+        /**
+         * AC frequency in millihertz (mHz)
+         */
+        Frequency = 11,
+
+        /**
+         * Power Factor ratio in+/- 1/100ths of a percent.
+         */
+        PowerFactor = 12,
+
+        /**
+         * AC neutral current in milliamps (mA)
+         */
+        NeutralCurrent = 13,
+
+        /**
+         * Electrical energy in milliwatt-hours (mWh)
+         */
+        ElectricalEnergy = 14,
+
+        /**
+         * Reactive power in millivolt-amp-hours reactive (mVARh)
+         */
+        ReactiveEnergy = 15,
+
+        /**
+         * Apparent power in millivolt-amp-hours (mVAh)
+         */
+        ApparentEnergy = 16
+    }
+
     /**
      * This struct shall indicate the maximum and minimum values of a given measurement type during a measurement
      * period, along with the observation times of these values.
@@ -137,13 +223,13 @@ export namespace ElectricalPowerMeasurement {
      * since boot for a given timestamp; this allows for client-side resolution of UTC time for previous reports that
      * only included systime.
      *
-     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2
+     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3
      */
     export const TlvMeasurementRange = TlvObject({
         /**
          * This field shall be the type of measurement for the range provided.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2.1
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.1
          */
         measurementType: TlvField(0, TlvEnum<MeasurementType>()),
 
@@ -151,7 +237,7 @@ export namespace ElectricalPowerMeasurement {
          * 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.v141.Cluster} § 2.13.5.2.2
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.2
          */
         min: TlvField(1, TlvInt64),
 
@@ -159,7 +245,7 @@ export namespace ElectricalPowerMeasurement {
          * This field shall be the largest measured value for the associated measurement over the period between either
          * StartTimestamp and EndTimestamp or the period between StartSystime and EndSystime, or both.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2.3
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.3
          */
         max: TlvField(2, TlvInt64),
 
@@ -169,7 +255,7 @@ export namespace ElectricalPowerMeasurement {
          * 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.v141.Cluster} § 2.13.5.2.4
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.4
          */
         startTimestamp: TlvOptionalField(3, TlvEpochS),
 
@@ -179,7 +265,7 @@ export namespace ElectricalPowerMeasurement {
          * 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.v141.Cluster} § 2.13.5.2.5
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.5
          */
         endTimestamp: TlvOptionalField(4, TlvEpochS),
 
@@ -189,7 +275,7 @@ export namespace ElectricalPowerMeasurement {
          * 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.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2.6
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.6
          */
         minTimestamp: TlvOptionalField(5, TlvEpochS),
 
@@ -198,7 +284,7 @@ export namespace ElectricalPowerMeasurement {
          * 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.v141.Cluster} § 2.13.5.2.7
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.7
          */
         maxTimestamp: TlvOptionalField(6, TlvEpochS),
 
@@ -208,7 +294,7 @@ export namespace ElectricalPowerMeasurement {
          * 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.v141.Cluster} § 2.13.5.2.8
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.8
          */
         startSystime: TlvOptionalField(7, TlvSysTimeMS),
 
@@ -218,7 +304,7 @@ export namespace ElectricalPowerMeasurement {
          * If the server had determined the time in UTC at the end of the measurement period, this field may be omitted
          * along with the StartSystime field, MinSystime, and MaxSystime fields.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2.9
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.9
          */
         endSystime: TlvOptionalField(8, TlvSysTimeMS),
 
@@ -228,7 +314,7 @@ export namespace ElectricalPowerMeasurement {
          *
          * This field shall be less than or equal to the value of the EndSystime field.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2.10
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.10
          */
         minSystime: TlvOptionalField(9, TlvSysTimeMS),
 
@@ -238,7 +324,7 @@ export namespace ElectricalPowerMeasurement {
          *
          * This field shall be less than or equal to the value of the EndSystime field.
          *
-         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2.11
+         * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3.11
          */
         maxSystime: TlvOptionalField(10, TlvSysTimeMS)
     });
@@ -255,7 +341,7 @@ export namespace ElectricalPowerMeasurement {
      * since boot for a given timestamp; this allows for client-side resolution of UTC time for previous reports that
      * only included systime.
      *
-     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.2
+     * @see {@link MatterSpecification.v141.Cluster} § 2.13.5.3
      */
     export interface MeasurementRange extends TypeFromSchema<typeof TlvMeasurementRange> {}
 
@@ -270,7 +356,7 @@ export namespace ElectricalPowerMeasurement {
          *
          * @see {@link MatterSpecification.v141.Cluster} § 2.13.7.1.1
          */
-        ranges: TlvField(0, TlvArray(TlvMeasurementRange))
+        ranges: TlvField(0, TlvArray(TlvMeasurementRange, { minLength: 1 }))
     });
 
     /**
@@ -310,6 +396,9 @@ export namespace ElectricalPowerMeasurement {
              * This shall indicate the most recent ApparentCurrent (square root sum of the squares of active and
              * reactive currents) reading in milliamps (mA).
              *
+             * A positive value represents current flowing into the server, while a negative value represents current
+             * flowing out of the server.
+             *
              * The reporting interval of this attribute shall be manufacturer dependent. The server may choose to omit
              * publication of deltas considered not meaningful.
              *
@@ -323,7 +412,7 @@ export namespace ElectricalPowerMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.13.6.8
              */
-            apparentCurrent: OptionalAttribute(0x7, TlvNullable(TlvInt64.bound({ min: 0 })), { default: null }),
+            apparentCurrent: OptionalAttribute(0x7, TlvNullable(TlvInt64), { default: null }),
 
             /**
              * This shall indicate the most recent ReactivePower reading in millivolt-amps reactive (mVAR). A positive
@@ -486,7 +575,7 @@ export namespace ElectricalPowerMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.13.6.16
              */
-            harmonicCurrents: Attribute(0xf, TlvNullable(TlvArray(TlvHarmonicMeasurement)), { default: null })
+            harmonicCurrents: Attribute(0xf, TlvNullable(TlvArray(TlvHarmonicMeasurement, { maxLength: 25 })))
         }
     });
 
@@ -511,7 +600,7 @@ export namespace ElectricalPowerMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.13.6.17
              */
-            harmonicPhases: Attribute(0x10, TlvNullable(TlvArray(TlvHarmonicMeasurement)), { default: null })
+            harmonicPhases: Attribute(0x10, TlvNullable(TlvArray(TlvHarmonicMeasurement, { maxLength: 25 })))
         }
     });
 
@@ -526,9 +615,8 @@ export namespace ElectricalPowerMeasurement {
              *
              * If the neutral current cannot be measured or derived, a value of null shall be returned.
              *
-             * A positive value represents an imbalance between the phase currents when power is imported.
-             *
-             * A negative value represents an imbalance between the phase currents when power is exported.
+             * A positive value represents an imbalance between the phase currents when power is imported. A negative
+             * value represents an imbalance between the phase currents when power is exported.
              *
              * The reporting interval of this attribute shall be manufacturer dependent. The server may choose to omit
              * publication of deltas considered not meaningful.
@@ -551,7 +639,7 @@ export namespace ElectricalPowerMeasurement {
     export const Base = MutableCluster.Component({
         id: 0x90,
         name: "ElectricalPowerMeasurement",
-        revision: 1,
+        revision: 3,
 
         features: {
             /**
@@ -604,7 +692,7 @@ export namespace ElectricalPowerMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.13.6.2
              */
-            numberOfMeasurementTypes: FixedAttribute(0x1, TlvUInt8.bound({ min: 1 })),
+            numberOfMeasurementTypes: FixedAttribute(0x1, TlvUInt8.bound({ max: 32 })),
 
             /**
              * This shall indicate a list of accuracy specifications for the measurement types supported by the server.
@@ -692,7 +780,7 @@ export namespace ElectricalPowerMeasurement {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 2.13.6.9
              */
-            activePower: Attribute(0x8, TlvNullable(TlvInt64), { default: null })
+            activePower: Attribute(0x8, TlvNullable(TlvInt64))
         },
 
         events: {

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

@@ -203,6 +203,9 @@ export namespace EnergyEvseMode {
          * 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.
          *
+         * Each mode tag in this field shall be distinct from other mode tags in this field. For example, a simplified
+         * list containing [Auto, Auto] would not be allowed.
+         *
          * A few examples are provided below.
          *
          *   • A mode named "100%" can have both the High (manufacturer specific) and Max (standard) mode tag. Clients

package/src/clusters/energy-evse.ts

@@ -271,8 +271,9 @@ export namespace EnergyEvse {
          *   • the AddedEnergy field shall take precedence over the TargetSoC field, and if the EVSE does not support
          *     the SOC feature then the TargetSoC field may only take the values null or 100%.
          *
-         *   • if the AddedEnergy field has not been provided, the EVSE SHOULD assume the vehicle is empty and charge
-         *     until the vehicle stops demanding a charge.
+         *   • if the AddedEnergy field has not been provided, the EVSE SHOULD assume the vehicle is empty
+         *
+         * and charge until the vehicle stops demanding a charge.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 9.3.7.6.2
          */
@@ -451,7 +452,7 @@ export namespace EnergyEvse {
         SessionEnding = 5,
 
         /**
-         * There is a fault (see FaultState attribute)
+         * There is a fault, further details in the FaultState attribute
          */
         Fault = 6
     }
@@ -602,8 +603,8 @@ export namespace EnergyEvse {
          * This field shall indicate the minimum current that can be delivered by the EVSE to the EV in trickle mode.
          * The EVSE current limit can be advertised to an EV in 0.6A steps.
          *
-         * The value of the MinimumChargeCurrent attribute shall be set to the value of this field (see
-         * MinimumChargeCurrent attribute for further details).
+         * The value of the MinimumChargeCurrent attribute shall be set to the value of this field (see Section 9.3.8.7,
+         * “MinimumChargeCurrent Attribute” for further details).
          *
          * @see {@link MatterSpecification.v141.Cluster} § 9.3.9.2.2
          */
@@ -888,7 +889,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.5
              */
-            dischargingEnabledUntil: Attribute(0x4, TlvNullable(TlvEpochS), { persistent: true, default: 0 }),
+            dischargingEnabledUntil: Attribute(0x4, TlvNullable(TlvEpochS), { persistent: true }),
 
             /**
              * Indicates the maximum current that can be received by the EVSE from the EV. This attribute can be set
@@ -904,16 +905,12 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.9
              */
-            maximumDischargeCurrent: Attribute(0x8, TlvInt64.bound({ min: 0 }), { persistent: true, default: 0 }),
+            maximumDischargeCurrent: Attribute(0x8, TlvInt64.bound({ min: 0 }), { persistent: true }),
 
             /**
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8
              */
-            sessionEnergyDischarged: Attribute(
-                0x43,
-                TlvNullable(TlvInt64.bound({ min: 0 })),
-                { persistent: true, default: null }
-            )
+            sessionEnergyDischarged: Attribute(0x43, TlvNullable(TlvInt64.bound({ min: 0 })), { persistent: true })
         },
 
         commands: {
@@ -942,7 +939,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.12
              */
-            nextChargeStartTime: Attribute(0x23, TlvNullable(TlvEpochS), { default: null }),
+            nextChargeStartTime: Attribute(0x23, TlvNullable(TlvEpochS)),
 
             /**
              * Indicates the time, in UTC, when the EVSE SHOULD complete the next scheduled charge based on the charging
@@ -954,7 +951,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.13
              */
-            nextChargeTargetTime: Attribute(0x24, TlvNullable(TlvEpochS), { default: null }),
+            nextChargeTargetTime: Attribute(0x24, TlvNullable(TlvEpochS)),
 
             /**
              * Indicates the amount of energy that the EVSE is going to attempt to add to the vehicle in the next
@@ -966,7 +963,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.14
              */
-            nextChargeRequiredEnergy: Attribute(0x25, TlvNullable(TlvInt64.bound({ min: 0 })), { default: null }),
+            nextChargeRequiredEnergy: Attribute(0x25, TlvNullable(TlvInt64.bound({ min: 0 }))),
 
             /**
              * Indicates the target SoC the EVSE is going to attempt to reach when the vehicle is next charged.
@@ -979,7 +976,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.15
              */
-            nextChargeTargetSoC: Attribute(0x26, TlvNullable(TlvPercent), { default: null }),
+            nextChargeTargetSoC: Attribute(0x26, TlvNullable(TlvPercent)),
 
             /**
              * Indicates the vehicle efficiency rating for a connected vehicle.
@@ -1057,14 +1054,14 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.17
              */
-            stateOfCharge: Attribute(0x30, TlvNullable(TlvPercent), { default: null }),
+            stateOfCharge: Attribute(0x30, TlvNullable(TlvPercent)),
 
             /**
              * Indicates the capacity of the EV battery in mWh. This value is always positive.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.18
              */
-            batteryCapacity: Attribute(0x31, TlvNullable(TlvInt64.bound({ min: 0 })), { default: null })
+            batteryCapacity: Attribute(0x31, TlvNullable(TlvInt64.bound({ min: 0 })))
         }
     });
 
@@ -1082,7 +1079,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.19
              */
-            vehicleId: Attribute(0x32, TlvNullable(TlvString.bound({ maxLength: 32 })), { default: null })
+            vehicleId: Attribute(0x32, TlvNullable(TlvString.bound({ maxLength: 32 })))
         }
     });
 
@@ -1203,8 +1200,9 @@ export namespace EnergyEvse {
              * > SessionEnding is not really a state but a transition. However, the transition period may take a few
              *   seconds and is useful for some clean up purposes.
              *
-             * The Fault state is used to indicate that the FaultState attribute is not NoError. A null value shall
-             * indicate that the state cannot be determined.
+             * The Fault state is used to indicate that the FaultState attribute is not NoError.
+             *
+             * A null value shall indicate that the state cannot be determined.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.1
              */
@@ -1241,7 +1239,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.4
              */
-            chargingEnabledUntil: Attribute(0x3, TlvNullable(TlvEpochS), { persistent: true, default: 0 }),
+            chargingEnabledUntil: Attribute(0x3, TlvNullable(TlvEpochS), { persistent: true }),
 
             /**
              * Indicates the capacity that the circuit that the EVSE is connected to can provide. It is intended to
@@ -1250,15 +1248,16 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.6
              */
-            circuitCapacity: Attribute(0x5, TlvInt64.bound({ min: 0 }), { persistent: true, default: 0 }),
+            circuitCapacity: Attribute(0x5, TlvInt64.bound({ min: 0 }), { persistent: true }),
 
             /**
-             * Indicates the minimum current that can be delivered by the EVSE to the EV. The attribute can be set using
-             * the EnableCharging command.
+             * Indicates the minimum current that can be delivered by the EVSE to the EV.
+             *
+             * The attribute can be set using the EnableCharging command.
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.7
              */
-            minimumChargeCurrent: Attribute(0x6, TlvInt64.bound({ min: 0 }), { persistent: true, default: 6000 }),
+            minimumChargeCurrent: Attribute(0x6, TlvInt64.bound({ min: 0 }), { persistent: true }),
 
             /**
              * Indicates the maximum current that can be delivered by the EVSE to the EV.
@@ -1282,7 +1281,7 @@ export namespace EnergyEvse {
              *
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8.8
              */
-            maximumChargeCurrent: Attribute(0x7, TlvInt64.bound({ min: 0 }), { persistent: true, default: 0 }),
+            maximumChargeCurrent: Attribute(0x7, TlvInt64.bound({ min: 0 }), { persistent: true }),
 
             /**
              * Indicates a maximum current that can set by the consumer (e.g. via an app) as a preference to further
@@ -1328,21 +1327,17 @@ export namespace EnergyEvse {
             /**
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8
              */
-            sessionId: Attribute(0x40, TlvNullable(TlvUInt32), { persistent: true, default: null }),
+            sessionId: Attribute(0x40, TlvNullable(TlvUInt32), { persistent: true }),
 
             /**
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8
              */
-            sessionDuration: Attribute(0x41, TlvNullable(TlvUInt32), { persistent: true, default: null }),
+            sessionDuration: Attribute(0x41, TlvNullable(TlvUInt32), { persistent: true }),
 
             /**
              * @see {@link MatterSpecification.v141.Cluster} § 9.3.8
              */
-            sessionEnergyCharged: Attribute(
-                0x42,
-                TlvNullable(TlvInt64.bound({ min: 0 })),
-                { persistent: true, default: null }
-            )
+            sessionEnergyCharged: Attribute(0x42, TlvNullable(TlvInt64.bound({ min: 0 })), { persistent: true })
         },
 
         commands: {
@@ -1459,15 +1454,15 @@ export namespace EnergyEvse {
      * cluster.
      *
      * This cluster supports a safety mechanism that may lockout remote operation until the initial latching conditions
-     * have been met. Some of the fault conditions defined in SAE J1772, such as Ground-Fault Circuit Interrupter (GFCI)
-     * or Charging Circuit Interrupting Device (CCID), may require clearing by an operator by, for example, pressing a
-     * button on the equipment or breaker panel.
+     * have been met. Some of the fault conditions defined in SAE J1772, such as Ground- Fault Circuit Interrupter
+     * (GFCI) or Charging Circuit Interrupting Device (CCID), may require clearing by an operator by, for example,
+     * pressing a button on the equipment or breaker panel.
      *
      * This EVSE cluster is written around support of a single EVSE. Having multiple EVSEs at home or a business is
      * managed by backend system and outside scope of this cluster.
      *
      * Note that in many deployments the EVSE may be outside the home and may suffer from intermittent network
-     * connections (e.g. a weak WiFi signal). It also allows for a charging profile to be pre-configured, in case there
+     * connections (e.g. a weak Wi-Fi signal). It also allows for a charging profile to be pre-configured, in case there
      * is a temporary communications loss during a charging session.
      *
      * EnergyEvseCluster supports optional features that you can enable with the EnergyEvseCluster.with() factory

package/src/clusters/energy-preference.ts

@@ -182,9 +182,7 @@ export namespace EnergyPreference {
         attributes: {
             /**
              * Indicates a list of BalanceStructs, each representing a condition or set of conditions for the device to
-             * enter a low power mode.
-             *
-             * This shall contain at least two BalanceStructs.
+             * enter a low power mode. This shall contain at least two BalanceStructs.
              *
              * Each BalanceStruct shall have a Step field larger than the Step field on the previous BalanceStruct in
              * the list.
@@ -257,6 +255,8 @@ export namespace EnergyPreference {
     /**
      * This cluster provides an interface to specify preferences for how devices should consume energy.
      *
+     * NOTE Support for Energy Preference cluster is provisional.
+     *
      * Per the Matter specification you cannot use {@link EnergyPreferenceCluster} without enabling certain feature
      * combinations. You must use the {@link with} factory method to obtain a working cluster.
      *