@matter/types 0.13.0-alpha.0-20250318-c1aa38b08 → 0.13.0-alpha.0-20250322-f085fa576

package/src/clusters/content-control.ts

@@ -245,8 +245,8 @@ export namespace ContentControl {
         minorNumber: TlvField(2, TlvUInt16),
 
         /**
-         * This field shall indicate the unique identifier for a specific channel. This field is optional, but SHOULD
-         * be provided when MajorNumber and MinorNumber are not available.
+         * This field shall indicate the unique identifier for a specific channel. This field is optional, but SHOULD be
+         * provided when MajorNumber and MinorNumber are not available.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.3.4
          */
@@ -318,8 +318,8 @@ export namespace ContentControl {
         catalogVendorId: TlvField(0, TlvUInt16),
 
         /**
-         * This field shall indicate the application identifier, expressed as a string, such as "PruneVideo" or
-         * "Company X". This field shall be unique within a catalog.
+         * This field shall indicate the application identifier, expressed as a string, such as "PruneVideo" or "Company
+         * X". This field shall be unique within a catalog.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.4.2
          */
@@ -440,9 +440,9 @@ export namespace ContentControl {
         endHour: TlvField(2, TlvUInt8.bound({ max: 23 })),
 
         /**
-         * This field shall indicate the ending minute. If EndHour is equal to StartHour then EndMinute shall be
-         * greater than StartMinute. If the EndHour is equal to 23 and the EndMinute is equal to 59, all contents shall
-         * be blocked until 23:59:59.
+         * This field shall indicate the ending minute. If EndHour is equal to StartHour then EndMinute shall be greater
+         * than StartMinute. If the EndHour is equal to 23 and the EndMinute is equal to 59, all contents shall be
+         * blocked until 23:59:59.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.13.5.6.4
          */
@@ -657,11 +657,10 @@ export namespace ContentControl {
             onDemandRatings: Attribute(0x1, TlvArray(TlvRatingName), { default: [] }),
 
             /**
-             * Indicates a threshold rating as a content filter which is compared with the rating for on-demand
-             * content. For example, if the on-demand content rating is greater than or equal to
-             * OnDemandRatingThreshold, for a rating system that is ordered from lower viewer age to higher viewer age,
-             * then on-demand content is not appropriate for the User and the Node shall prevent the playback of
-             * content.
+             * Indicates a threshold rating as a content filter which is compared with the rating for on-demand content.
+             * For example, if the on-demand content rating is greater than or equal to OnDemandRatingThreshold, for a
+             * rating system that is ordered from lower viewer age to higher viewer age, then on-demand content is not
+             * appropriate for the User and the Node shall prevent the playback of content.
              *
              * This attribute shall be set to one of the values present in the OnDemandRatings attribute.
              *
@@ -782,9 +781,9 @@ export namespace ContentControl {
             /**
              * The purpose of this command is to add the extra screen time for the user.
              *
-             * If a client with Operate privilege invokes this command, the media device shall check whether the
-             * PINCode passed in the command matches the current PINCode value. If these match, then the
-             * RemainingScreenTime attribute shall be increased by the specified BonusTime value.
+             * If a client with Operate privilege invokes this command, the media device shall check whether the PINCode
+             * passed in the command matches the current PINCode value. If these match, then the RemainingScreenTime
+             * attribute shall be increased by the specified BonusTime value.
              *
              * If the PINs do not match, then a response with InvalidPINCode error status shall be returned, and no
              * changes shall be made to RemainingScreenTime.
@@ -792,8 +791,8 @@ export namespace ContentControl {
              * If a client with Manage privilege or greater invokes this command, the media device shall ignore the
              * PINCode field and directly increase the RemainingScreenTime attribute by the specified BonusTime value.
              *
-             * A server that does not support the PM feature shall respond with InvalidPINCode to clients that only
-             * have Operate privilege unless:
+             * A server that does not support the PM feature shall respond with InvalidPINCode to clients that only have
+             * Operate privilege unless:
              *
              *   • It has been provided with the PIN value to expect via an out of band mechanism, and
              *
@@ -851,19 +850,19 @@ export namespace ContentControl {
 
         commands: {
             /**
-             * The purpose of this command is to specify whether programs with no Content rating must be blocked by
-             * this media device.
+             * The purpose of this command is to specify whether programs with no Content rating must be blocked by this
+             * media device.
              *
-             * Upon receipt of the BlockUnratedContent command, the media device shall set the BlockUnrated attribute
-             * to TRUE.
+             * Upon receipt of the BlockUnratedContent command, the media device shall set the BlockUnrated attribute to
+             * TRUE.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 6.13.8.8
              */
             blockUnratedContent: Command(0x7, TlvNoArguments, 0x7, TlvNoResponse, { invokeAcl: AccessLevel.Manage }),
 
             /**
-             * The purpose of this command is to specify whether programs with no Content rating must be blocked by
-             * this media device.
+             * The purpose of this command is to specify whether programs with no Content rating must be blocked by this
+             * media device.
              *
              * Upon receipt of the UnblockUnratedContent command, the media device shall set the BlockUnrated attribute
              * to FALSE.
@@ -919,8 +918,8 @@ export namespace ContentControl {
              *
              * Upon receipt of the RemoveBlockChannels command, the media device shall check if the channels indicated
              * by ChannelIndexes passed in this command are present in BlockChannelList attribute. If one or more
-             * channels indicated by ChannelIndexes passed in this command field are not present in the
-             * BlockChannelList attribute, then a response with ChannelNotExist error Status shall be returned.
+             * channels indicated by ChannelIndexes passed in this command field are not present in the BlockChannelList
+             * attribute, then a response with ChannelNotExist error Status shall be returned.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 6.13.8.13
              */
@@ -951,9 +950,9 @@ export namespace ContentControl {
             /**
              * The purpose of this command is to set applications to the BlockApplicationList attribute.
              *
-             * Upon receipt of the AddBlockApplications command, the media device shall check if the Applications
-             * passed in this command are installed. If there is an application in Applications field which is not
-             * identified by media device, then a response with UnidentifiableApplication error Status may be
+             * Upon receipt of the AddBlockApplications command, the media device shall check if the Applications passed
+             * in this command are installed. If there is an application in Applications field which is not identified
+             * by media device, then a response with UnidentifiableApplication error Status may be
              *
              * returned.
              *
@@ -1000,11 +999,11 @@ export namespace ContentControl {
     export const BlockContentTimeWindowComponent = MutableCluster.Component({
         attributes: {
             /**
-             * Indicates a set of periods during which the playback of content on media device shall be blocked when
-             * the Content Control feature is activated. The media device shall reject any request to play content
-             * during one period of this attribute. If it is entering any one period of this attribute, the media
-             * device shall block content which is playing and generate an event EnteringBlockContentTimeWindow. There
-             * shall NOT be multiple entries in this attribute list for the same day of week.
+             * Indicates a set of periods during which the playback of content on media device shall be blocked when the
+             * Content Control feature is activated. The media device shall reject any request to play content during
+             * one period of this attribute. If it is entering any one period of this attribute, the media device shall
+             * block content which is playing and generate an event EnteringBlockContentTimeWindow. There shall NOT be
+             * multiple entries in this attribute list for the same day of week.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 6.13.7.11
              */
@@ -1039,8 +1038,8 @@ export namespace ContentControl {
              * The purpose of this command is to remove the selected time windows from the BlockContentTimeWindow
              * attribute.
              *
-             * Upon receipt of the RemoveBlockContentTimeWindow command, the media device shall check if the time
-             * window index passed in this command presents in the BlockContentTimeWindow attribute.
+             * Upon receipt of the RemoveBlockContentTimeWindow command, the media device shall check if the time window
+             * index passed in this command presents in the BlockContentTimeWindow attribute.
              *
              * If one or more time window indexes passed in this command are not present in BlockContentTimeWindow
              * attribute, then a response with TimeWindowNotExist error status shall be returned.
@@ -1073,8 +1072,8 @@ export namespace ContentControl {
     export const PinManagementComponent = MutableCluster.Component({
         commands: {
             /**
-             * The purpose of this command is to update the PIN used for protecting configuration of the content
-             * control settings. Upon success, the old PIN shall no longer work.
+             * The purpose of this command is to update the PIN used for protecting configuration of the content control
+             * settings. Upon success, the old PIN shall no longer work.
              *
              * The PIN is used to ensure that only the Node (or User) with the PIN code can make changes to the Content
              * Control settings, for example, turn off Content Controls or modify the ScreenDailyTime. The PIN is
@@ -1085,9 +1084,9 @@ export namespace ContentControl {
              * response with InvalidPINCode error status shall be returned.
              *
              * The media device may provide a default PIN to the User via an out of band mechanism. For security
-             * reasons, it is recommended that a client encourage the user to update the PIN from its default value
-             * when performing configuration of the Content Control settings exposed by this cluster. The ResetPIN
-             * command can also be used to obtain the default PIN.
+             * reasons, it is recommended that a client encourage the user to update the PIN from its default value when
+             * performing configuration of the Content Control settings exposed by this cluster. The ResetPIN command
+             * can also be used to obtain the default PIN.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 6.13.8.1
              */
@@ -1384,8 +1383,8 @@ export namespace ContentControl {
     /**
      * This cluster supports all ContentControl 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/content-launcher.ts

@@ -95,10 +95,10 @@ export namespace ContentLauncher {
         /**
          * Dimensions defined as a percentage
          *
-         * This value is for dimensions defined as a percentage of the overall display dimensions. For example, if
-         * using a Percentage Metric type for a Width measurement of 50.0, against a display width of 1920 pixels, then
-         * the resulting value used would be 960 pixels (50.0% of 1920) for that dimension. Whenever a measurement uses
-         * this Metric type, the resulting values shall be rounded ("floored") towards 0 if the measurement requires an
+         * This value is for dimensions defined as a percentage of the overall display dimensions. For example, if using
+         * a Percentage Metric type for a Width measurement of 50.0, against a display width of 1920 pixels, then the
+         * resulting value used would be 960 pixels (50.0% of 1920) for that dimension. Whenever a measurement uses this
+         * Metric type, the resulting values shall be rounded ("floored") towards 0 if the measurement requires an
          * integer final value.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.5.4.2
@@ -211,8 +211,8 @@ export namespace ContentLauncher {
         background: TlvOptionalField(1, TlvStyleInformation),
 
         /**
-         * This field shall indicate the logo shown when the Video Player is launching. This is also used when the
-         * Video Player is in the idle state and Splash field is not available.
+         * This field shall indicate the logo shown when the Video Player is launching. This is also used when the Video
+         * Player is in the idle state and Splash field is not available.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.5.10.3
          */
@@ -226,8 +226,8 @@ export namespace ContentLauncher {
         progressBar: TlvOptionalField(3, TlvStyleInformation),
 
         /**
-         * This field shall indicate the screen shown when the Video Player is in an idle state. If this property is
-         * not populated, the Video Player shall default to logo or the provider name.
+         * This field shall indicate the screen shown when the Video Player is in an idle state. If this property is not
+         * populated, the Video Player shall default to logo or the provider name.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.5.10.5
          */
@@ -304,8 +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. (For example
-         * : Live media with no known duration and where seek is not supported).
+         * 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
          */
@@ -354,8 +354,8 @@ export namespace ContentLauncher {
         contentUrl: TlvField(0, TlvString),
 
         /**
-         * This field, if present, shall provide a string that may be used to describe the content being accessed at
-         * the given URL.
+         * This field, if present, shall provide a string that may be used to describe the content being accessed at the
+         * given URL.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.7.2.2
          */
@@ -371,12 +371,12 @@ export namespace ContentLauncher {
 
         /**
          * This field, if present, shall indicate the user’s preferred Text/AudioTracks and playbackPosition for the
-         * media, sent from the client to the server. If the server does not find an available track for the title
-         * being played exactly matching a Track requested here, in the list of available tracks, it may default to
-         * picking another track that closely matches the requested track. Alternately, it may go with user preferences
-         * set on the server side (it will use this option if these PlaybackPreferences are not specified). In the case
-         * of text tracks, that may mean that the subtitle text is not displayed at all. In the cases where the
-         * preferred Text/AudioTracks are not available, the server shall return the TextTrackNotAvailable and/or
+         * media, sent from the client to the server. If the server does not find an available track for the title being
+         * played exactly matching a Track requested here, in the list of available tracks, it may default to picking
+         * another track that closely matches the requested track. Alternately, it may go with user preferences set on
+         * the server side (it will use this option if these PlaybackPreferences are not specified). In the case of text
+         * tracks, that may mean that the subtitle text is not displayed at all. In the cases where the preferred
+         * Text/AudioTracks are not available, the server shall return the TextTrackNotAvailable and/or
          * AudioTrackNotAvailable Status(es) in the LauncherResponse.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.7.2.4
@@ -667,12 +667,12 @@ export namespace ContentLauncher {
 
         /**
          * This field, if present, shall indicate the user’s preferred Text/AudioTracks and playbackPosition for the
-         * media, sent from the client to the server. If the server does not find an available track for the title
-         * being played exactly matching a Track requested here, in the list of available tracks, it may default to
-         * picking another track that closely matches the requested track. Alternately, it may go with user preferences
-         * set on the server side (it will use this option if these PlaybackPreferences are not specified). In the case
-         * of text tracks, that may mean that the subtitle text is not displayed at all. In the cases where the
-         * preferred Text/AudioTracks are not available, the server shall return the TextTrackNotAvailable and/or
+         * media, sent from the client to the server. If the server does not find an available track for the title being
+         * played exactly matching a Track requested here, in the list of available tracks, it may default to picking
+         * another track that closely matches the requested track. Alternately, it may go with user preferences set on
+         * the server side (it will use this option if these PlaybackPreferences are not specified). In the case of text
+         * tracks, that may mean that the subtitle text is not displayed at all. In the cases where the preferred
+         * Text/AudioTracks are not available, the server shall return the TextTrackNotAvailable and/or
          * AudioTrackNotAvailable Status(es) in the LauncherResponse.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 6.7.7.1.4
@@ -730,9 +730,9 @@ export namespace ContentLauncher {
              * A check shall be made to ensure the URL is secure (uses HTTPS).
              *
              * When playing a video stream in response to this command, an indication (ex. visual) of the identity of
-             * the origin node of the video stream shall be provided. This could be in the form of a friendly name
-             * label which uniquely identifies the node to the user. This friendly name label is typically assigned by
-             * the Matter Admin (ex. TV) at the time of commissioning and, when it’s a device, is often editable by the
+             * the origin node of the video stream shall be provided. This could be in the form of a friendly name label
+             * which uniquely identifies the node to the user. This friendly name label is typically assigned by the
+             * Matter Admin (ex. TV) at the time of commissioning and, when it’s a device, is often editable by the
              * user. It might be a combination of a company name and friendly name, for example, ”Acme” or “Acme
              * Streaming Service on Alice’s Phone”.
              *
@@ -750,8 +750,8 @@ export namespace ContentLauncher {
     export const ContentSearchComponent = MutableCluster.Component({
         commands: {
             /**
-             * Upon receipt, this shall launch the specified content with optional search criteria. This command
-             * returns a Launch Response.
+             * Upon receipt, this shall launch the specified content with optional search criteria. This command returns
+             * a Launch Response.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 6.7.7.1
              */
@@ -886,8 +886,8 @@ export namespace ContentLauncher {
     /**
      * This cluster supports all ContentLauncher 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/descriptor.ts

@@ -30,8 +30,8 @@ export namespace Descriptor {
         /**
          * TagList (TAGLIST)
          *
-         * See the Disambiguation section in the System Model spec for conformance requirements for this feature and
-         * the corresponding attribute.
+         * See the Disambiguation section in the System Model spec for conformance requirements for this feature and the
+         * corresponding attribute.
          *
          * @see {@link MatterSpecification.v13.Core} § 9.5.4.1
          */
@@ -81,11 +81,11 @@ export namespace Descriptor {
              * device with two buttons, with this attribute being used to indicate which of the two endpoints
              * corresponds to the button on the left side.
              *
-             * It may also be used to provide information about an endpoint (e.g. the relative location of a
-             * Temperature sensor in a Temperature Controlled Cabinet).
+             * It may also be used to provide information about an endpoint (e.g. the relative location of a Temperature
+             * sensor in a Temperature Controlled Cabinet).
              *
-             *   • A client SHOULD use these tags to convey disambiguation information and other relevant information
-             *     to the user (e.g. showing it in a user interface), as appropriate.
+             *   • A client SHOULD use these tags to convey disambiguation information and other relevant information to
+             *     the user (e.g. showing it in a user interface), as appropriate.
              *
              *   • A client SHOULD use these tags in its logic to make decisions, as appropriate.
              *
@@ -112,8 +112,8 @@ export namespace Descriptor {
             /**
              * TagList
              *
-             * See the Disambiguation section in the System Model spec for conformance requirements for this feature
-             * and the corresponding attribute.
+             * See the Disambiguation section in the System Model spec for conformance requirements for this feature and
+             * the corresponding attribute.
              *
              * @see {@link MatterSpecification.v13.Core} § 9.5.4.1
              */
@@ -125,8 +125,8 @@ export namespace Descriptor {
              * This is a list of device types and corresponding revisions declaring endpoint conformance (see
              * DeviceTypeStruct). At least one device type entry shall be present.
              *
-             * An endpoint shall conform to all device types listed in the DeviceTypeList. A cluster instance that is
-             * in common for more than one device type in the DeviceTypeList shall be supported as a shared cluster
+             * An endpoint shall conform to all device types listed in the DeviceTypeList. A cluster instance that is in
+             * common for more than one device type in the DeviceTypeList shall be supported as a shared cluster
              * instance on the endpoint.
              *
              * @see {@link MatterSpecification.v13.Core} § 9.5.6.1
@@ -173,8 +173,8 @@ export namespace Descriptor {
     /**
      * NOTE
      *
-     * The Descriptor cluster is meant to replace the support from the Zigbee Device Object (ZDO) for describing a
-     * node, its endpoints and clusters.
+     * The Descriptor cluster is meant to replace the support from the Zigbee Device Object (ZDO) for describing a node,
+     * its endpoints and clusters.
      *
      * This cluster describes an endpoint instance on the node, independently from other endpoints, but also allows
      * composition of endpoints to conform to complex device type patterns.
@@ -212,8 +212,8 @@ export namespace Descriptor {
     /**
      * This cluster supports all Descriptor 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/device-energy-management-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 DeviceEnergyManagementMode {
         Day = 9,
 
         /**
-         * The device prohibits optimization of energy usage management: its energy usage is determined only by the
-         * user configuration and internal device needs.
+         * 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} § 9.8.7.1.1
          */
@@ -176,9 +176,9 @@ export namespace DeviceEnergyManagementMode {
         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
@@ -189,8 +189,8 @@ export namespace DeviceEnergyManagementMode {
          * 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.
          *
@@ -275,7 +275,7 @@ export namespace DeviceEnergyManagementMode {
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.10.7.1
              */
-            changeToMode: Command(0x0, ModeBase.TlvChangeToModeRequest, 0x0, TlvNoResponse)
+            changeToMode: Command(0x0, ModeBase.TlvChangeToModeRequest, 0x1, ModeBase.TlvChangeToModeResponse)
         },
 
         /**