@matter/types 0.13.0-alpha.0-20250304-d4a7592a4 → 0.13.0-alpha.0-20250307-ebf84a05a

package/src/clusters/oven-mode.ts

@@ -7,23 +7,15 @@
 /*** THIS FILE IS GENERATED, DO NOT EDIT ***/
 
 import { MutableCluster } from "../cluster/mutation/MutableCluster.js";
-import {
-    WritableAttribute,
-    FixedAttribute,
-    Attribute,
-    OptionalWritableAttribute,
-    Command,
-    TlvNoResponse
-} from "../cluster/Cluster.js";
-import { TlvUInt8, TlvEnum } from "../tlv/TlvNumber.js";
-import { TlvNullable } from "../tlv/TlvNullable.js";
 import { BitFlag } from "../schema/BitmapSchema.js";
+import { FixedAttribute, Attribute, Command, TlvNoResponse } from "../cluster/Cluster.js";
 import { TlvArray } from "../tlv/TlvArray.js";
 import { TlvField, TlvOptionalField, TlvObject } from "../tlv/TlvObject.js";
 import { TlvString } from "../tlv/TlvString.js";
+import { TlvUInt8, TlvEnum } from "../tlv/TlvNumber.js";
 import { TlvVendorId } from "../datatype/VendorId.js";
-import { TypeFromSchema } from "../tlv/TlvSchema.js";
 import { ModeBase } from "./mode-base.js";
+import { TypeFromSchema } from "../tlv/TlvSchema.js";
 import { Identity } from "#general";
 import { ClusterRegistry } from "../cluster/ClusterRegistry.js";
 
@@ -31,156 +23,133 @@ export namespace OvenMode {
     /**
      * These are optional features supported by OvenModeCluster.
      *
-     * @see {@link MatterSpecification.v13.Cluster} § 1.10.4
+     * @see {@link MatterSpecification.v13.Cluster} § 8.11.4
      */
     export enum Feature {
         /**
          * OnOff (DEPONOFF)
          *
-         * This feature creates a dependency between an OnOff cluster instance and this cluster instance on the same
-         * endpoint. See OnMode for more information.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.4.1
+         * Dependency with the OnOff cluster
          */
         OnOff = "OnOff"
     }
 
     export enum ModeTag {
         /**
-         * This mode sets the device into baking mode for baking food items.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1.1
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Bake = 16384,
+        Auto = 0,
 
         /**
-         * This mode sets the device into convection mode which creates an airflow within the device during the cooking
-         * duration.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1.2
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Convection = 16385,
+        Quick = 1,
 
         /**
-         * This mode sets the device into grill mode for grilling food items. This is the same as Broil for many
-         * regions.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1.3
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Grill = 16386,
+        Quiet = 2,
 
         /**
-         * This mode sets the device into roast mode for roasting food items.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1.4
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Roast = 16387,
+        LowNoise = 3,
 
         /**
-         * This mode sets the device into cleaning mode to clean the internal components of the appliance.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1.5
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Clean = 16388,
+        LowEnergy = 4,
 
         /**
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        ConvectionBake = 16389,
+        Vacation = 5,
 
         /**
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        ConvectionRoast = 16390,
+        Min = 6,
 
         /**
-         * This mode sets the device into a warming mode which begins warming the cavity.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Warming = 16391,
+        Max = 7,
 
         /**
-         * This mode sets the device into proofing mode which creates an environment ready for proofing.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1.9
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Proofing = 16392,
+        Night = 8,
 
         /**
-         * @see {@link MatterSpecification.v13.Cluster} § 8.11.4.1
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Steam = 16393,
+        Day = 9,
 
         /**
-         * The device decides which options, features and setting values to use.
+         * This mode sets the device into baking mode for baking food items.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1.1
          */
-        Auto = 0,
+        Bake = 16384,
 
         /**
-         * The mode of the device is optimizing for faster completion.
+         * This mode sets the device into convection mode which creates an airflow within the device during the cooking
+         * duration.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1.2
          */
-        Quick = 1,
+        Convection = 16385,
 
         /**
-         * The device is silent or barely audible while in this mode.
+         * This mode sets the device into grill mode for grilling food items. This is the same as Broil for many
+         * regions.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1.3
          */
-        Quiet = 2,
+        Grill = 16386,
 
         /**
-         * Either the mode is inherently low noise or the device optimizes for that.
+         * This mode sets the device into roast mode for roasting food items.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1.4
          */
-        LowNoise = 3,
+        Roast = 16387,
 
         /**
-         * The device is optimizing for lower energy usage in this mode. Sometimes called "Eco mode".
+         * This mode sets the device into cleaning mode to clean the internal components of the appliance.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1.5
          */
-        LowEnergy = 4,
+        Clean = 16388,
 
         /**
-         * A mode suitable for use during vacations or other extended absences.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Vacation = 5,
+        ConvectionBake = 16389,
 
         /**
-         * The mode uses the lowest available setting value.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Min = 6,
+        ConvectionRoast = 16390,
 
         /**
-         * The mode uses the highest available setting value.
+         * This mode sets the device into a warming mode which begins warming the cavity.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1.8
          */
-        Max = 7,
+        Warming = 16391,
 
         /**
-         * The mode is recommended or suitable for use during night time.
+         * This mode sets the device into proofing mode which creates an environment ready for proofing.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1.9
          */
-        Night = 8,
+        Proofing = 16392,
 
         /**
-         * The mode is recommended or suitable for use during day time.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 8.11.7.1
          */
-        Day = 9
+        Steam = 16393
     }
 
     /**
@@ -210,7 +179,7 @@ export namespace OvenMode {
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.10.5.1.2
          */
-        value: TlvField(1, TlvEnum<ModeTag>())
+        value: TlvField(1, TlvEnum<ModeTag | ModeBase.ModeTag>())
     });
 
     /**
@@ -221,9 +190,10 @@ export namespace OvenMode {
     export interface ModeTagStruct extends TypeFromSchema<typeof TlvModeTagStruct> {}
 
     /**
-     * This is a struct representing a possible mode of the server.
+     * The table below lists the changes relative to the Mode Base cluster for the fields of the ModeOptionStruct type.
+     * A blank field indicates no change.
      *
-     * @see {@link MatterSpecification.v13.Cluster} § 1.10.5.2
+     * @see {@link MatterSpecification.v13.Cluster} § 8.11.5.1
      */
     export const TlvModeOption = TlvObject({
         /**
@@ -282,94 +252,47 @@ export namespace OvenMode {
     });
 
     /**
-     * This is a struct representing a possible mode of the server.
+     * The table below lists the changes relative to the Mode Base cluster for the fields of the ModeOptionStruct type.
+     * A blank field indicates no change.
      *
-     * @see {@link MatterSpecification.v13.Cluster} § 1.10.5.2
+     * @see {@link MatterSpecification.v13.Cluster} § 8.11.5.1
      */
     export interface ModeOption extends TypeFromSchema<typeof TlvModeOption> {}
 
-    /**
-     * A OvenModeCluster supports these elements if it supports feature OnOff.
-     */
-    export const OnOffComponent = MutableCluster.Component({
-        attributes: {
-            /**
-             * Indicates whether the value of CurrentMode depends on the state of the On/Off cluster on the same
-             * endpoint. If this attribute is not present or is set to null, there is no dependency, otherwise the
-             * CurrentMode attribute shall depend on the OnOff attribute in the On/Off cluster
-             *
-             * The value of this field shall match the Mode field of one of the entries in the SupportedModes attribute.
-             *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.10.6.5
-             */
-            onMode: WritableAttribute(0x3, TlvNullable(TlvUInt8), { persistent: true, default: null })
-        }
-    });
-
     /**
      * These elements and properties are present in all OvenMode clusters.
      */
     export const Base = MutableCluster.Component({
         id: 0x49,
         name: "OvenMode",
-        revision: 1,
+        revision: 2,
 
         features: {
             /**
              * OnOff
              *
-             * This feature creates a dependency between an OnOff cluster instance and this cluster instance on the
-             * same endpoint. See OnMode for more information.
-             *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.10.4.1
+             * Dependency with the OnOff cluster
              */
             onOff: BitFlag(0)
         },
 
         attributes: {
             /**
-             * This attribute shall contain the list of supported modes that may be selected for the CurrentMode
-             * attribute. Each item in this list represents a unique mode as indicated by the Mode field of the
-             * ModeOptionStruct.
+             * At least one entry in the SupportedModes attribute shall include the Bake mode tag in the ModeTags field
+             * list.
              *
-             * Each entry in this list shall have a unique value for the Mode field. Each entry in this list shall have
-             * a unique value for the Label field.
-             *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.10.6.2
+             * @see {@link MatterSpecification.v13.Cluster} § 8.11.6.1
              */
-            supportedModes: FixedAttribute(0x0, TlvArray(TlvModeOption, { minLength: 2, maxLength: 255 })),
+            supportedModes: FixedAttribute(
+                0x0,
+                TlvArray(TlvModeOption, { minLength: 2, maxLength: 255 }),
+                { default: [] }
+            ),
 
             /**
-             * Indicates the current mode of the server.
-             *
-             * The value of this field shall match the Mode field of one of the entries in the SupportedModes attribute.
-             *
-             * The value of this attribute may change at any time via an out-of-band interaction outside of the server,
-             * such as interactions with a user interface, via internal mode changes due to autonomously progressing
-             * through a sequence of operations, on system time-outs or idle delays, or via interactions coming from a
-             * fabric other than the one which last executed a ChangeToMode.
-             *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.10.6.3
+             * @see {@link MatterSpecification.v13.Cluster} § 8.11.6
              */
-            currentMode: Attribute(0x1, TlvUInt8, { scene: true, persistent: true }),
-
-            /**
-             * Indicates the desired startup mode for the server when it is supplied with power.
-             *
-             * If this attribute is not null, the CurrentMode attribute shall be set to the StartUpMode value, when the
-             * server is powered up, except in the case when the OnMode attribute overrides the StartUpMode attribute
-             * (see OnModeWithPowerUp).
-             *
-             * This behavior does not apply to reboots associated with OTA. After an OTA restart, the CurrentMode
-             * attribute shall return to its value prior to the restart.
-             *
-             * The value of this field shall match the Mode field of one of the entries in the SupportedModes attribute.
-             *
-             * If this attribute is not implemented, or is set to the null value, it shall have no effect.
-             *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.10.6.4
-             */
-            startUpMode: OptionalWritableAttribute(0x2, TlvNullable(TlvUInt8), { persistent: true })
+            currentMode: Attribute(0x1, TlvUInt8, { persistent: true })
         },
 
         commands: {
@@ -386,7 +309,7 @@ export namespace OvenMode {
         /**
          * This metadata controls which OvenModeCluster elements matter.js activates for specific feature combinations.
          */
-        extensions: MutableCluster.Extensions({ flags: { onOff: true }, component: OnOffComponent })
+        extensions: MutableCluster.Extensions({ flags: { onOff: true }, component: false })
     });
 
     /**
@@ -395,7 +318,7 @@ export namespace OvenMode {
     export const ClusterInstance = MutableCluster(Base);
 
     /**
-     * This cluster is derived from the Mode Base cluster, defining additional mode tags and namespaced enumerated
+     * This cluster is derived from the Mode Base cluster and defines additional mode tags and namespaced enumerated
      * values for oven devices.
      *
      * OvenModeCluster supports optional features that you can enable with the OvenModeCluster.with() factory method.
@@ -405,32 +328,7 @@ export namespace OvenMode {
     export interface Cluster extends Identity<typeof ClusterInstance> {}
 
     export const Cluster: Cluster = ClusterInstance;
-    const DEPONOFF = { onOff: true };
-
-    /**
-     * @see {@link Complete}
-     */
-    export const CompleteInstance = MutableCluster({
-        id: Cluster.id,
-        name: Cluster.name,
-        revision: Cluster.revision,
-        features: Cluster.features,
-        attributes: {
-            ...Cluster.attributes,
-            onMode: MutableCluster.AsConditional(OnOffComponent.attributes.onMode, { mandatoryIf: [DEPONOFF] })
-        },
-        commands: Cluster.commands
-    });
-
-    /**
-     * This cluster supports all OvenMode 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.
-     */
-    export interface Complete extends Identity<typeof CompleteInstance> {}
-
-    export const Complete: Complete = CompleteInstance;
+    export const Complete = Cluster;
 }
 
 export type OvenModeCluster = OvenMode.Cluster;

package/src/clusters/power-source.ts

@@ -1053,21 +1053,33 @@ export namespace PowerSource {
              * value of 48 is equivalent to 24%. A value of NULL shall indicate the Node is currently unable to assess
              * the value.
              *
+             * Changes to this attribute shall only be marked as reportable in the following cases:
+             *
+             *   • At most once every 10 seconds, or
+             *
+             *   • When it changes from null to any other value and vice versa.
+             *
+             * Since reporting consumes power, devices SHOULD be careful not to over-report.
+             *
              * @see {@link MatterSpecification.v13.Core} § 11.7.7.13
              */
-            batPercentRemaining: OptionalAttribute(
-                0xc,
-                TlvNullable(TlvUInt8.bound({ max: 200 })),
-                { omitChanges: true }
-            ),
+            batPercentRemaining: OptionalAttribute(0xc, TlvNullable(TlvUInt8.bound({ max: 200 }))),
 
             /**
              * Indicates the estimated time in seconds before the battery will no longer be able to provide power to
              * the Node. A value of NULL shall indicate the Node is currently unable to assess the value.
              *
+             * Changes to this attribute shall only be marked as reportable in the following cases:
+             *
+             *   • At most once every 10 seconds, or
+             *
+             *   • When it changes from null to any other value and vice versa.
+             *
+             * Since reporting consumes power, devices SHOULD be careful not to over-report.
+             *
              * @see {@link MatterSpecification.v13.Core} § 11.7.7.14
              */
-            batTimeRemaining: OptionalAttribute(0xd, TlvNullable(TlvUInt32), { omitChanges: true }),
+            batTimeRemaining: OptionalAttribute(0xd, TlvNullable(TlvUInt32)),
 
             /**
              * Indicates a coarse ranking of the charge level of the battery, used to indicate when intervention is
@@ -1108,7 +1120,9 @@ export namespace PowerSource {
              * contributing to a fault have been cleared, the corresponding BatFaultEnum value shall be removed from
              * this list. An empty list shall indicate there are currently no active faults. The order of this list
              * SHOULD have no significance. Clients interested in monitoring changes in active faults may subscribe to
-             * this attribute, or they may subscribe to BatFaultChange.
+             * this attribute, or they may subscribe to Bat
+             *
+             * FaultChange.
              *
              * @see {@link MatterSpecification.v13.Core} § 11.7.7.19
              */
@@ -1212,9 +1226,17 @@ export namespace PowerSource {
              * Indicates the estimated time in seconds before the battery source will be at full charge. A value of
              * NULL shall indicate the Node is currently unable to assess the value.
              *
+             * Changes to this attribute shall only be marked as reportable in the following cases:
+             *
+             *   • At most once every 10 seconds, or
+             *
+             *   • When it changes from null to any other value and vice versa.
+             *
+             * Since reporting consumes power, devices SHOULD be careful not to over-report.
+             *
              * @see {@link MatterSpecification.v13.Core} § 11.7.7.28
              */
-            batTimeToFullCharge: OptionalAttribute(0x1b, TlvNullable(TlvUInt32), { omitChanges: true }),
+            batTimeToFullCharge: OptionalAttribute(0x1b, TlvNullable(TlvUInt32)),
 
             /**
              * Indicates whether the Node can remain operational while the battery source is charging.
@@ -1268,7 +1290,7 @@ export namespace PowerSource {
     export const Base = MutableCluster.Component({
         id: 0x2f,
         name: "PowerSource",
-        revision: 2,
+        revision: 3,
 
         features: {
             /**
@@ -1375,23 +1397,25 @@ export namespace PowerSource {
             { flags: { rechargeable: true }, component: ReplaceableOrRechargeableComponent },
             { flags: { rechargeable: true }, component: RechargeableComponent },
             { flags: { rechargeable: true, battery: false }, component: false },
-            { flags: { replaceable: true, battery: false }, component: false }
+            { flags: { replaceable: true, battery: false }, component: false },
+            { flags: { wired: true, battery: true }, component: false },
+            { flags: { wired: false, battery: false }, component: false }
         )
     });
 
     /**
      * @see {@link Cluster}
      */
-    export const ClusterInstance = MutableCluster(Base);
+    export const ClusterInstance = MutableCluster.ExtensibleOnly(Base);
 
     /**
      * This cluster is used to describe the configuration and capabilities of a physical power source that provides
-     * power to one or more endpoints on a node. In case the node has multiple power sources, each is described by its
-     * own cluster instance. Each instance of this cluster may be associated with one or more endpoints or the entire
-     * node.
+     * power to one or more endpoints on a node. In case the node has multiple power sources, each shall be described
+     * by its own cluster instance. Each instance of this cluster may be associated with one or more endpoints or the
+     * entire node.
      *
-     * PowerSourceCluster supports optional features that you can enable with the PowerSourceCluster.with() factory
-     * method.
+     * Per the Matter specification you cannot use {@link PowerSourceCluster} without enabling certain feature
+     * combinations. You must use the {@link with} factory method to obtain a working cluster.
      *
      * @see {@link MatterSpecification.v13.Core} § 11.7
      */
@@ -1407,13 +1431,13 @@ export namespace PowerSource {
      * @see {@link Complete}
      */
     export const CompleteInstance = MutableCluster({
-        id: Cluster.id,
-        name: Cluster.name,
-        revision: Cluster.revision,
-        features: Cluster.features,
+        id: Base.id,
+        name: Base.name,
+        revision: Base.revision,
+        features: Base.features,
 
         attributes: {
-            ...Cluster.attributes,
+            ...Base.attributes,
             wiredAssessedInputVoltage: MutableCluster.AsConditional(
                 WiredComponent.attributes.wiredAssessedInputVoltage,
                 { optionalIf: [WIRED] }

package/src/clusters/pressure-measurement.ts

@@ -51,7 +51,7 @@ export namespace PressureMeasurement {
              *
              * @see {@link MatterSpecification.v13.Cluster} § 2.4.5.6
              */
-            minScaledValue: Attribute(0x11, TlvNullable(TlvInt16.bound({ min: -32767 })), { default: 0 }),
+            minScaledValue: Attribute(0x11, TlvNullable(TlvInt16.bound({ max: 32766 })), { default: 0 }),
 
             /**
              * Indicates the maximum value of ScaledValue that can be measured. The null value indicates that the value
@@ -117,7 +117,7 @@ export namespace PressureMeasurement {
              *
              * @see {@link MatterSpecification.v13.Cluster} § 2.4.5.2
              */
-            minMeasuredValue: Attribute(0x1, TlvNullable(TlvInt16.bound({ min: -32767 }))),
+            minMeasuredValue: Attribute(0x1, TlvNullable(TlvInt16.bound({ max: 32766 }))),
 
             /**
              * Indicates the maximum value of MeasuredValue that can be measured. See Measured Value for more details.