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

package/src/clusters/content-launcher.ts

@@ -150,7 +150,8 @@ export namespace ContentLauncher {
     export const TlvStyleInformation = TlvObject({
         /**
          * This field shall indicate the URL of image used for Styling different Video Player sections like Logo,
-         * Watermark etc.
+         * Watermark etc. The syntax of this field shall follow the syntax as specified in RFC 1738 and shall use the
+         * https scheme.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.5.9.1
          */
@@ -170,8 +171,9 @@ export namespace ContentLauncher {
         color: TlvOptionalField(1, TlvString),
 
         /**
-         * This field shall indicate the size of the image used for Styling different Video Player sections like Logo,
-         * Watermark etc.
+         * This field shall indicate the size of the image used for Styling different Video Player sections like
+         *
+         * Logo, Watermark etc.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.5.9.3
          */
@@ -276,9 +278,8 @@ export namespace ContentLauncher {
          *
          * This field shall NOT be present if the track is not an audio track.
          *
-         * If the track is an audio track, this field MUST be present. A value of null shall indicate that the
-         *
-         * server can choose the audio output(s) to play the Audio Track on.
+         * If the track is an audio track, this field MUST be present. A value of null shall indicate that the server
+         * can choose the audio output(s) to play the Audio Track on.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.5.12.3
          */
@@ -303,9 +304,8 @@ export namespace ContentLauncher {
          * This field shall indicate the preferred position (in milliseconds) in the media to launch playback from. In
          * case the position falls in the middle of a frame, the server shall set the position to the beginning of that
          * frame and set the SampledPosition attribute on the MediaPlayback cluster accordingly. A value of null shall
-         * indicate that playback position is not applicable for the current state of the media playback.
-         *
-         * ported).
+         * indicate that playback position is not applicable for the current state of the media playback. (For example
+         * : Live media with no known duration and where seek is not supported).
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.5.11.1
          */
@@ -346,7 +346,8 @@ export namespace ContentLauncher {
      */
     export const TlvLaunchUrlRequest = TlvObject({
         /**
-         * This field shall indicate the URL of content to launch.
+         * This field shall indicate the URL of content to launch. The syntax of this field shall follow the syntax as
+         * specified in RFC 1738 and shall use the https scheme.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.7.2.1
          */
@@ -703,8 +704,9 @@ export namespace ContentLauncher {
     export const UrlPlaybackComponent = MutableCluster.Component({
         attributes: {
             /**
-             * This attribute shall provide a list of content types supported by the Video Player or Content App in the
-             * form of entries in the HTTP "Accept" request header.
+             * This attribute shall provide a list of content types supported by the Video Player or Content App
+             *
+             * in the form of entries in the HTTP "Accept" request header.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 6.7.6.1
              */
@@ -722,9 +724,8 @@ export namespace ContentLauncher {
             /**
              * Upon receipt, this shall launch content from the specified URL.
              *
-             * The content types supported include those identified in the AcceptHeader and SupportedStreaming
-             *
-             * Protocols attributes.
+             * The content types supported include those identified in the AcceptHeader and SupportedStreamingProtocols
+             * attributes.
              *
              * A check shall be made to ensure the URL is secure (uses HTTPS).
              *

package/src/clusters/device-energy-management-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,120 +23,96 @@ export namespace DeviceEnergyManagementMode {
     /**
      * These are optional features supported by DeviceEnergyManagementModeCluster.
      *
-     * @see {@link MatterSpecification.v13.Cluster} § 1.10.4
+     * @see {@link MatterSpecification.v13.Cluster} § 9.8.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 {
         /**
-         * The device prohibits optimization of energy usage management: its energy usage is determined only by the
-         * user configuration and internal device needs. This tag cannot be included with any of the other tags defined
-         * below in a mode.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 9.6.5.1.1
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        NoOptimization = 16384,
+        Auto = 0,
 
         /**
-         * The device is permitted to manage its own energy usage. For example, using tariff information it may obtain.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 9.6.5.1.2
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        DeviceOptimization = 16385,
+        Quick = 1,
 
         /**
-         * The device permits management of energy usage by an energy manager to optimize the local energy usage.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 9.6.5.1.3
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        LocalOptimization = 16386,
+        Quiet = 2,
 
         /**
-         * The device permits management of energy usage by an energy manager to optimize the grid energy usage.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 9.6.5.1.4
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        GridOptimization = 16387,
+        LowNoise = 3,
 
         /**
-         * The device decides which options, features and setting values to use.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        Auto = 0,
+        LowEnergy = 4,
 
         /**
-         * The mode of the device is optimizing for faster completion.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        Quick = 1,
+        Vacation = 5,
 
         /**
-         * The device is silent or barely audible while in this mode.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        Quiet = 2,
+        Min = 6,
 
         /**
-         * Either the mode is inherently low noise or the device optimizes for that.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        LowNoise = 3,
+        Max = 7,
 
         /**
-         * The device is optimizing for lower energy usage in this mode. Sometimes called "Eco mode".
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        LowEnergy = 4,
+        Night = 8,
 
         /**
-         * A mode suitable for use during vacations or other extended absences.
-         *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1
          */
-        Vacation = 5,
+        Day = 9,
 
         /**
-         * The mode uses the lowest available setting value.
+         * The device prohibits optimization of energy usage management: its energy usage is determined only by the
+         * user configuration and internal device needs.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1.1
          */
-        Min = 6,
+        NoOptimization = 16384,
 
         /**
-         * The mode uses the highest available setting value.
+         * The device is permitted to manage its own energy usage. For example, using tariff information it may obtain.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1.2
          */
-        Max = 7,
+        DeviceOptimization = 16385,
 
         /**
-         * The mode is recommended or suitable for use during night time.
+         * The device permits management of energy usage by an energy manager to optimize the local energy usage.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1.3
          */
-        Night = 8,
+        LocalOptimization = 16386,
 
         /**
-         * The mode is recommended or suitable for use during day time.
+         * The device permits management of energy usage by an energy manager to optimize the grid energy usage.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.10.8
+         * @see {@link MatterSpecification.v13.Cluster} § 9.8.7.1.4
          */
-        Day = 9
+        GridOptimization = 16387
     }
 
     /**
@@ -174,7 +142,7 @@ export namespace DeviceEnergyManagementMode {
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.10.5.1.2
          */
-        value: TlvField(1, TlvEnum<ModeTag>())
+        value: TlvField(1, TlvEnum<ModeTag | ModeBase.ModeTag>())
     });
 
     /**
@@ -188,7 +156,7 @@ export namespace DeviceEnergyManagementMode {
      * 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} § 9.6.4.1
+     * @see {@link MatterSpecification.v13.Cluster} § 9.8.5.1
      */
     export const TlvModeOption = TlvObject({
         /**
@@ -250,92 +218,53 @@ export namespace DeviceEnergyManagementMode {
      * 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} § 9.6.4.1
+     * @see {@link MatterSpecification.v13.Cluster} § 9.8.5.1
      */
     export interface ModeOption extends TypeFromSchema<typeof TlvModeOption> {}
 
-    /**
-     * A DeviceEnergyManagementModeCluster 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 DeviceEnergyManagementMode clusters.
      */
     export const Base = MutableCluster.Component({
         id: 0x9f,
         name: "DeviceEnergyManagementMode",
-        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 NoOptimization mode tag in the
+             * ModeTags field.
              *
-             * 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.
+             * At least one entry in the SupportedModes attribute shall include the LocalOptimization mode tag in the
+             * ModeTags field list.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.10.6.2
-             */
-            supportedModes: FixedAttribute(0x0, TlvArray(TlvModeOption, { minLength: 2, maxLength: 255 })),
-
-            /**
-             * 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.
+             * At least one entry in the SupportedModes attribute shall include the GridOptimization mode tag in the
+             * ModeTags field list.
              *
-             * 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.
+             * An entry in the SupportedModes attribute that includes one of an DeviceOptimization, LocalOptimization,
+             * or GridOptimization tags shall NOT also include NoOptimization tag.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.10.6.3
+             * @see {@link MatterSpecification.v13.Cluster} § 9.8.6.1
              */
-            currentMode: Attribute(0x1, TlvUInt8, { scene: true, persistent: true }),
+            supportedModes: FixedAttribute(
+                0x0,
+                TlvArray(TlvModeOption, { minLength: 2, maxLength: 255 }),
+                { default: [] }
+            ),
 
             /**
-             * 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
+             * @see {@link MatterSpecification.v13.Cluster} § 9.8.6
              */
-            startUpMode: OptionalWritableAttribute(0x2, TlvNullable(TlvUInt8), { persistent: true })
+            currentMode: Attribute(0x1, TlvUInt8, { persistent: true })
         },
 
         commands: {
@@ -353,7 +282,7 @@ export namespace DeviceEnergyManagementMode {
          * This metadata controls which DeviceEnergyManagementModeCluster elements matter.js activates for specific
          * feature combinations.
          */
-        extensions: MutableCluster.Extensions({ flags: { onOff: true }, component: OnOffComponent })
+        extensions: MutableCluster.Extensions({ flags: { onOff: true }, component: false })
     });
 
     /**
@@ -362,45 +291,18 @@ export namespace DeviceEnergyManagementMode {
     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 Device Energy Management devices.
      *
-     * NOTE Support for Device Energy Management Mode cluster is provisional.
-     *
      * DeviceEnergyManagementModeCluster supports optional features that you can enable with the
      * DeviceEnergyManagementModeCluster.with() factory method.
      *
-     * @see {@link MatterSpecification.v13.Cluster} § 9.6
+     * @see {@link MatterSpecification.v13.Cluster} § 9.8
      */
     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 DeviceEnergyManagementMode 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 DeviceEnergyManagementModeCluster = DeviceEnergyManagementMode.Cluster;