@matter/types 0.12.6-alpha.0-20250304-03716637c → 0.13.0-alpha.0-20250307-ebf84a05a

package/dist/cjs/clusters/switch.d.ts

@@ -19,7 +19,7 @@ export declare namespace Switch {
         /**
          * LatchingSwitch (LS)
          *
-         * This feature is for a switch that maintains its position after being pressed (or turned).
+         * This feature flag is for a switch that maintains its position after being pressed (or turned).
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.1
          */
@@ -27,7 +27,7 @@ export declare namespace Switch {
         /**
          * MomentarySwitch (MS)
          *
-         * This feature is for a switch that does not maintain its position after being pressed (or turned). After
+         * This feature flag is for a switch that does not maintain its position after being pressed (or turned). After
          * releasing, it goes back to its idle position.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.2
@@ -36,8 +36,7 @@ export declare namespace Switch {
         /**
          * MomentarySwitchRelease (MSR)
          *
-         * This feature is for a momentary switch that can distinguish and report release events. When this feature
-         * flag MSR is present, MS shall be present as well.
+         * This feature flag is for a momentary switch that can distinguish and report release events.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.3
          */
@@ -45,8 +44,7 @@ export declare namespace Switch {
         /**
          * MomentarySwitchLongPress (MSL)
          *
-         * This feature is for a momentary switch that can distinguish and report long presses from short presses. When
-         * this feature flag MSL is present, MS and MSR shall be present as well.
+         * This feature flag is for a momentary switch that can distinguish and report long presses from short presses.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.4
          */
@@ -54,45 +52,21 @@ export declare namespace Switch {
         /**
          * MomentarySwitchMultiPress (MSM)
          *
-         * This feature is for a momentary switch that can distinguish and report double press and potentially multiple
-         * presses with more events, such as triple press, etc. When this feature flag MSM is present, MS and MSR shall
-         * be present as well.
+         * This feature flag is for a momentary switch that can distinguish and report double press and potentially
+         * multiple presses with more events, such as triple press, etc.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.5
          */
-        MomentarySwitchMultiPress = "MomentarySwitchMultiPress"
-    }
-    /**
-     * Body of the Switch multiPressOngoing event
-     *
-     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
-     */
-    const TlvMultiPressOngoingEvent: import("../tlv/TlvObject.js").ObjectSchema<{
+        MomentarySwitchMultiPress = "MomentarySwitchMultiPress",
         /**
-         * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
+         * ActionSwitch (AS)
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
-         */
-        newPosition: import("../tlv/TlvObject.js").FieldType<number>;
-        /**
-         * This field shall contain:
-         *
-         *   • a value of 2 when the second press of a multi-press sequence has been detected,
-         *
-         *   • a value of 3 when the third press of a multi-press sequence has been detected,
-         *
-         *   • a value of N when the Nth press of a multi-press sequence has been detected.
+         * This feature flag indicates simplified handling of events for multi-press-capable switches. See Multi Press
+         * Details.
          *
-         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
+         * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.6
          */
-        currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
-    }>;
-    /**
-     * Body of the Switch multiPressOngoing event
-     *
-     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
-     */
-    interface MultiPressOngoingEvent extends TypeFromSchema<typeof TlvMultiPressOngoingEvent> {
+        ActionSwitch = "ActionSwitch"
     }
     /**
      * Body of the Switch multiPressComplete event
@@ -210,6 +184,38 @@ export declare namespace Switch {
      */
     interface ShortReleaseEvent extends TypeFromSchema<typeof TlvShortReleaseEvent> {
     }
+    /**
+     * Body of the Switch multiPressOngoing event
+     *
+     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
+     */
+    const TlvMultiPressOngoingEvent: import("../tlv/TlvObject.js").ObjectSchema<{
+        /**
+         * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
+         *
+         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
+         */
+        newPosition: import("../tlv/TlvObject.js").FieldType<number>;
+        /**
+         * This field shall contain:
+         *
+         *   • a value of 2 when the second press of a multi-press sequence has been detected,
+         *
+         *   • a value of 3 when the third press of a multi-press sequence has been detected,
+         *
+         *   • a value of N when the Nth press of a multi-press sequence has been detected.
+         *
+         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
+         */
+        currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
+    }>;
+    /**
+     * Body of the Switch multiPressOngoing event
+     *
+     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
+     */
+    interface MultiPressOngoingEvent extends TypeFromSchema<typeof TlvMultiPressOngoingEvent> {
+    }
     /**
      * A SwitchCluster supports these elements if it supports feature MomentarySwitchMultiPress.
      */
@@ -217,40 +223,32 @@ export declare namespace Switch {
         readonly attributes: {
             /**
              * Indicates how many consecutive presses can be detected and reported by a momentary switch which supports
-             * multi-press (e.g. it will report the value 3 if it can detect single press, double press and triple
-             * press, but not quad press and beyond).
+             * multi-press (MSM feature flag set).
+             *
+             * For example, a momentary switch supporting single press, double press and triple press, but not quad
+             * press and beyond, would return the value 3.
+             *
+             * When more than MultiPressMax presses are detected within a multi-press sequence:
+             *
+             *   • The server for cluster revision < 2 SHOULD generate a MultiPressComplete event with the
+             *     TotalNumberOfPressesCounted field set to the value of the MultiPressMax attribute, and avoid
+             *     generating any further InitialPress and MultiPressOngoing events until the switch has become fully
+             *     idle (i.e. no longer in the process of counting presses within the multipress).
+             *
+             *   • The server for cluster revision >= 2 shall generate a MultiPressComplete event with the
+             *     TotalNumberOfPressesCounted field set to zero (indicating an aborted sequence), and shall NOT
+             *     generate any further InitialPress and MultiPressOngoing events until the switch has become fully
+             *     idle (i.e. no longer in the process of counting presses within the multipress).
+             *
+             * This approach avoids unintentionally causing intermediate actions where there is a very long sequence of
+             * presses beyond MultiPressMax that may be taken in account specially by switches (e.g. to trigger special
+             * behavior such as factory reset for which generating events towards the client is not appropriate).
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.5.3
              */
             readonly multiPressMax: FixedAttribute<number, any>;
         };
         readonly events: {
-            /**
-             * This event shall be generated to indicate how many times the momentary switch has been pressed in a
-             * multi-press sequence, during that sequence. See Multi Press Details below.
-             *
-             * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
-             */
-            readonly multiPressOngoing: Event<import("../tlv/TlvObject.js").TypeFromFields<{
-                /**
-                 * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
-                 *
-                 * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
-                 */
-                newPosition: import("../tlv/TlvObject.js").FieldType<number>;
-                /**
-                 * This field shall contain:
-                 *
-                 *   • a value of 2 when the second press of a multi-press sequence has been detected,
-                 *
-                 *   • a value of 3 when the third press of a multi-press sequence has been detected,
-                 *
-                 *   • a value of N when the Nth press of a multi-press sequence has been detected.
-                 *
-                 * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
-                 */
-                currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
-            }>, any>;
             /**
              * This event shall be generated to indicate how many times the momentary switch has been pressed in a
              * multi-press sequence, after it has been detected that the sequence has ended. See Multi Press Details.
@@ -260,9 +258,11 @@ export declare namespace Switch {
              *
              * The TotalNumberOfPressesCounted field shall contain:
              *
-             *   • a value of 1 when there was one press in a multi-press sequence (and the sequence has ended),
+             *   • a value of 0 when there was an aborted multi-press sequence, where the number of presses goes beyond
+             *     MultiPressMax presses,
              *
-             *     i.e. there was no double press (or more),
+             *   • a value of 1 when there was exactly one press in a multi-press sequence (and the sequence has
+             *     ended), i.e. there was no double press (or more),
              *
              *   • a value of 2 when there were exactly two presses in a multi-press sequence (and the sequence has
              *     ended),
@@ -273,6 +273,14 @@ export declare namespace Switch {
              *   • a value of N when there were exactly N presses in a multi-press sequence (and the sequence has
              *     ended).
              *
+             * NOTE
+             *
+             * The introduction of TotalNumberOfPressesCounted supporting the value 0 may impact clients of switches
+             * using cluster revision 1 since such servers would not use this value of TotalNumberOfPressesCounted to
+             * indicate an aborted sequence. Clients SHOULD always act using the TotalNumberOfPressesCounted field
+             * taken into account since for values from 1 to MultiPressMax, the user action that led to the event was
+             * different depending on the count.
+             *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.7
              */
             readonly multiPressComplete: Event<import("../tlv/TlvObject.js").TypeFromFields<{
@@ -328,8 +336,36 @@ export declare namespace Switch {
     const MomentarySwitchLongPressComponent: {
         readonly events: {
             /**
-             * This event shall be generated, when the momentary switch has been pressed for a "long" time (this time
-             * interval is manufacturer determined (e.g. since it depends on the switch physics)).
+             * This event shall be generated when the momentary switch has been pressed for a "long" time. The time
+             * interval constituting a "long" time is manufacturer-determined, since it depends on the switch physics.
+             *
+             *   • When the AS feature flag is set, this event:
+             *
+             *     ◦ shall NOT be generated during a multi-press sequence (since a long press is a separate cycle from
+             *       any multi-press cycles);
+             *
+             *     ◦ shall only be generated after the first InitialPress following a MultiPressComplete when a long
+             *       press is detected after the idle time.
+             *
+             *   • Else, when the MSM feature flag is set, this event:
+             *
+             *     ◦ shall NOT be generated during a multi-press sequence (since a long press is a separate cycle from
+             *       any multi-press cycles);
+             *
+             *     ◦ shall only be generated after the first InitialPress following a MultiPressComplete when a long
+             *       press is detected after the idle time;
+             *
+             *     ◦ shall NOT be generated after a MultiPressOngoing event without an intervening MultiPressComplete
+             *       event.
+             *
+             * The above constraints imply that for a given activity detection cycle of a switch having MSM and/or MSL
+             * feature flags set, the entire activity is either a single long press detection cycle of (InitialPress,
+             * LongPress, LongRelease), or a single multi-press detection cycle (ending in MultiPressComplete), where
+             * presses that would otherwise be reported as long presses are instead reported as a counted press in the
+             * MultiPressComplete event, and as InitialPress/ShortRelease pairs otherwise (where applicable).
+             *
+             * The rationale for this constraint is the ambiguity of interpretation of events when mixing long presses
+             * and multi-press events.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.3
              */
@@ -365,14 +401,19 @@ export declare namespace Switch {
     const MomentarySwitchReleaseComponent: {
         readonly events: {
             /**
+             * If the server has the Action Switch (AS) feature flag set, this event shall NOT be generated at all,
+             * since setting the Action Switch feature flag forbids the Momentary Switch ShortRelease (MSR) feature
+             * flag from being set. Otherwise, the following paragraphs describe the situations where this event is
+             * generated.
+             *
              * This event shall be generated, when the momentary switch has been released (after debouncing).
              *
-             *   • If the server supports the Momentary Switch LongPress (MSL) feature, this event shall be generated
-             *     when the switch is released if no LongPress event had been generated since the previous InitialPress
-             *     event.
+             *   • If the server has the Momentary Switch LongPress (MSL) feature flag set, then this event shall be
+             *     generated when the switch is released if no LongPress event had been generated since the previous
+             *     InitialPress event.
              *
-             *   • If the server does not support the Momentary Switch LongPress (MSL) feature, this event shall be
-             *     generated when the switch is released - even when the switch was pressed for a long time.
+             *   • If the server does not have the Momentary Switch LongPress (MSL) feature flag set, this event shall
+             *     be generated when the switch is released - even when the switch was pressed for a long time.
              *
              *   • Also see Section 1.13.7, “Sequence of generated events”.
              *
@@ -388,18 +429,55 @@ export declare namespace Switch {
             }>, any>;
         };
     };
+    /**
+     * A SwitchCluster supports these elements if it supports feature MomentarySwitchMultiPress and it doesn't support
+     * feature AS.
+     */
+    const MomentarySwitchMultiPressNotActionSwitchComponent: {
+        readonly events: {
+            /**
+             * If the server has the Action Switch (AS) feature flag set, this event shall NOT be generated at all.
+             * Otherwise, the following paragraphs describe the situations where this event is generated.
+             *
+             * This event shall be generated to indicate how many times the momentary switch has been pressed in a
+             * multi-press sequence, during that sequence. See Multi Press Details below.
+             *
+             * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
+             */
+            readonly multiPressOngoing: Event<import("../tlv/TlvObject.js").TypeFromFields<{
+                /**
+                 * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
+                 *
+                 * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
+                 */
+                newPosition: import("../tlv/TlvObject.js").FieldType<number>;
+                /**
+                 * This field shall contain:
+                 *
+                 *   • a value of 2 when the second press of a multi-press sequence has been detected,
+                 *
+                 *   • a value of 3 when the third press of a multi-press sequence has been detected,
+                 *
+                 *   • a value of N when the Nth press of a multi-press sequence has been detected.
+                 *
+                 * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
+                 */
+                currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
+            }>, any>;
+        };
+    };
     /**
      * These elements and properties are present in all Switch clusters.
      */
     const Base: {
         readonly id: 59;
         readonly name: "Switch";
-        readonly revision: 1;
+        readonly revision: 2;
         readonly features: {
             /**
              * LatchingSwitch
              *
-             * This feature is for a switch that maintains its position after being pressed (or turned).
+             * This feature flag is for a switch that maintains its position after being pressed (or turned).
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.1
              */
@@ -407,8 +485,8 @@ export declare namespace Switch {
             /**
              * MomentarySwitch
              *
-             * This feature is for a switch that does not maintain its position after being pressed (or turned). After
-             * releasing, it goes back to its idle position.
+             * This feature flag is for a switch that does not maintain its position after being pressed (or turned).
+             * After releasing, it goes back to its idle position.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.2
              */
@@ -416,8 +494,7 @@ export declare namespace Switch {
             /**
              * MomentarySwitchRelease
              *
-             * This feature is for a momentary switch that can distinguish and report release events. When this feature
-             * flag MSR is present, MS shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report release events.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.3
              */
@@ -425,8 +502,8 @@ export declare namespace Switch {
             /**
              * MomentarySwitchLongPress
              *
-             * This feature is for a momentary switch that can distinguish and report long presses from short presses.
-             * When this feature flag MSL is present, MS and MSR shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report long presses from short
+             * presses.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.4
              */
@@ -434,13 +511,21 @@ export declare namespace Switch {
             /**
              * MomentarySwitchMultiPress
              *
-             * This feature is for a momentary switch that can distinguish and report double press and potentially
-             * multiple presses with more events, such as triple press, etc. When this feature flag MSM is present, MS
-             * and MSR shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report double press and potentially
+             * multiple presses with more events, such as triple press, etc.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.5
              */
             readonly momentarySwitchMultiPress: BitFlag;
+            /**
+             * ActionSwitch
+             *
+             * This feature flag indicates simplified handling of events for multi-press-capable switches. See Multi
+             * Press Details.
+             *
+             * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.6
+             */
+            readonly actionSwitch: BitFlag;
         };
         readonly attributes: {
             /**
@@ -451,9 +536,10 @@ export declare namespace Switch {
              */
             readonly numberOfPositions: FixedAttribute<number, any>;
             /**
-             * Indicates the position of the switch. The valid range is zero to NumberOfPositions-1. CurrentPosition
-             * value 0 shall be assigned to the default position of the switch: for example the "open" state of a
-             * rocker switch, or the "idle" state of a push button switch.
+             * Indicates the position of the switch. The valid range is zero to NumberOfPositions - 1.
+             *
+             * CurrentPosition value 0 shall be assigned to the default position of the switch: for example the "open"
+             * state of a rocker switch, or the "idle" state of a push button switch.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.5.2
              */
@@ -470,40 +556,32 @@ export declare namespace Switch {
                 readonly attributes: {
                     /**
                      * Indicates how many consecutive presses can be detected and reported by a momentary switch which supports
-                     * multi-press (e.g. it will report the value 3 if it can detect single press, double press and triple
-                     * press, but not quad press and beyond).
+                     * multi-press (MSM feature flag set).
+                     *
+                     * For example, a momentary switch supporting single press, double press and triple press, but not quad
+                     * press and beyond, would return the value 3.
+                     *
+                     * When more than MultiPressMax presses are detected within a multi-press sequence:
+                     *
+                     *   • The server for cluster revision < 2 SHOULD generate a MultiPressComplete event with the
+                     *     TotalNumberOfPressesCounted field set to the value of the MultiPressMax attribute, and avoid
+                     *     generating any further InitialPress and MultiPressOngoing events until the switch has become fully
+                     *     idle (i.e. no longer in the process of counting presses within the multipress).
+                     *
+                     *   • The server for cluster revision >= 2 shall generate a MultiPressComplete event with the
+                     *     TotalNumberOfPressesCounted field set to zero (indicating an aborted sequence), and shall NOT
+                     *     generate any further InitialPress and MultiPressOngoing events until the switch has become fully
+                     *     idle (i.e. no longer in the process of counting presses within the multipress).
+                     *
+                     * This approach avoids unintentionally causing intermediate actions where there is a very long sequence of
+                     * presses beyond MultiPressMax that may be taken in account specially by switches (e.g. to trigger special
+                     * behavior such as factory reset for which generating events towards the client is not appropriate).
                      *
                      * @see {@link MatterSpecification.v13.Cluster} § 1.13.5.3
                      */
                     readonly multiPressMax: FixedAttribute<number, any>;
                 };
                 readonly events: {
-                    /**
-                     * This event shall be generated to indicate how many times the momentary switch has been pressed in a
-                     * multi-press sequence, during that sequence. See Multi Press Details below.
-                     *
-                     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
-                     */
-                    readonly multiPressOngoing: Event<import("../tlv/TlvObject.js").TypeFromFields<{
-                        /**
-                         * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
-                         *
-                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
-                         */
-                        newPosition: import("../tlv/TlvObject.js").FieldType<number>;
-                        /**
-                         * This field shall contain:
-                         *
-                         *   • a value of 2 when the second press of a multi-press sequence has been detected,
-                         *
-                         *   • a value of 3 when the third press of a multi-press sequence has been detected,
-                         *
-                         *   • a value of N when the Nth press of a multi-press sequence has been detected.
-                         *
-                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
-                         */
-                        currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
-                    }>, any>;
                     /**
                      * This event shall be generated to indicate how many times the momentary switch has been pressed in a
                      * multi-press sequence, after it has been detected that the sequence has ended. See Multi Press Details.
@@ -513,9 +591,11 @@ export declare namespace Switch {
                      *
                      * The TotalNumberOfPressesCounted field shall contain:
                      *
-                     *   • a value of 1 when there was one press in a multi-press sequence (and the sequence has ended),
+                     *   • a value of 0 when there was an aborted multi-press sequence, where the number of presses goes beyond
+                     *     MultiPressMax presses,
                      *
-                     *     i.e. there was no double press (or more),
+                     *   • a value of 1 when there was exactly one press in a multi-press sequence (and the sequence has
+                     *     ended), i.e. there was no double press (or more),
                      *
                      *   • a value of 2 when there were exactly two presses in a multi-press sequence (and the sequence has
                      *     ended),
@@ -526,6 +606,14 @@ export declare namespace Switch {
                      *   • a value of N when there were exactly N presses in a multi-press sequence (and the sequence has
                      *     ended).
                      *
+                     * NOTE
+                     *
+                     * The introduction of TotalNumberOfPressesCounted supporting the value 0 may impact clients of switches
+                     * using cluster revision 1 since such servers would not use this value of TotalNumberOfPressesCounted to
+                     * indicate an aborted sequence. Clients SHOULD always act using the TotalNumberOfPressesCounted field
+                     * taken into account since for values from 1 to MultiPressMax, the user action that led to the event was
+                     * different depending on the count.
+                     *
                      * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.7
                      */
                     readonly multiPressComplete: Event<import("../tlv/TlvObject.js").TypeFromFields<{
@@ -584,8 +672,36 @@ export declare namespace Switch {
             readonly component: {
                 readonly events: {
                     /**
-                     * This event shall be generated, when the momentary switch has been pressed for a "long" time (this time
-                     * interval is manufacturer determined (e.g. since it depends on the switch physics)).
+                     * This event shall be generated when the momentary switch has been pressed for a "long" time. The time
+                     * interval constituting a "long" time is manufacturer-determined, since it depends on the switch physics.
+                     *
+                     *   • When the AS feature flag is set, this event:
+                     *
+                     *     ◦ shall NOT be generated during a multi-press sequence (since a long press is a separate cycle from
+                     *       any multi-press cycles);
+                     *
+                     *     ◦ shall only be generated after the first InitialPress following a MultiPressComplete when a long
+                     *       press is detected after the idle time.
+                     *
+                     *   • Else, when the MSM feature flag is set, this event:
+                     *
+                     *     ◦ shall NOT be generated during a multi-press sequence (since a long press is a separate cycle from
+                     *       any multi-press cycles);
+                     *
+                     *     ◦ shall only be generated after the first InitialPress following a MultiPressComplete when a long
+                     *       press is detected after the idle time;
+                     *
+                     *     ◦ shall NOT be generated after a MultiPressOngoing event without an intervening MultiPressComplete
+                     *       event.
+                     *
+                     * The above constraints imply that for a given activity detection cycle of a switch having MSM and/or MSL
+                     * feature flags set, the entire activity is either a single long press detection cycle of (InitialPress,
+                     * LongPress, LongRelease), or a single multi-press detection cycle (ending in MultiPressComplete), where
+                     * presses that would otherwise be reported as long presses are instead reported as a counted press in the
+                     * MultiPressComplete event, and as InitialPress/ShortRelease pairs otherwise (where applicable).
+                     *
+                     * The rationale for this constraint is the ambiguity of interpretation of events when mixing long presses
+                     * and multi-press events.
                      *
                      * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.3
                      */
@@ -622,14 +738,19 @@ export declare namespace Switch {
             readonly component: {
                 readonly events: {
                     /**
+                     * If the server has the Action Switch (AS) feature flag set, this event shall NOT be generated at all,
+                     * since setting the Action Switch feature flag forbids the Momentary Switch ShortRelease (MSR) feature
+                     * flag from being set. Otherwise, the following paragraphs describe the situations where this event is
+                     * generated.
+                     *
                      * This event shall be generated, when the momentary switch has been released (after debouncing).
                      *
-                     *   • If the server supports the Momentary Switch LongPress (MSL) feature, this event shall be generated
-                     *     when the switch is released if no LongPress event had been generated since the previous InitialPress
-                     *     event.
+                     *   • If the server has the Momentary Switch LongPress (MSL) feature flag set, then this event shall be
+                     *     generated when the switch is released if no LongPress event had been generated since the previous
+                     *     InitialPress event.
                      *
-                     *   • If the server does not support the Momentary Switch LongPress (MSL) feature, this event shall be
-                     *     generated when the switch is released - even when the switch was pressed for a long time.
+                     *   • If the server does not have the Momentary Switch LongPress (MSL) feature flag set, this event shall
+                     *     be generated when the switch is released - even when the switch was pressed for a long time.
                      *
                      *   • Also see Section 1.13.7, “Sequence of generated events”.
                      *
@@ -645,12 +766,56 @@ export declare namespace Switch {
                     }>, any>;
                 };
             };
+        }, {
+            readonly flags: {
+                readonly momentarySwitchMultiPress: true;
+                readonly actionSwitch: false;
+            };
+            readonly component: {
+                readonly events: {
+                    /**
+                     * If the server has the Action Switch (AS) feature flag set, this event shall NOT be generated at all.
+                     * Otherwise, the following paragraphs describe the situations where this event is generated.
+                     *
+                     * This event shall be generated to indicate how many times the momentary switch has been pressed in a
+                     * multi-press sequence, during that sequence. See Multi Press Details below.
+                     *
+                     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
+                     */
+                    readonly multiPressOngoing: Event<import("../tlv/TlvObject.js").TypeFromFields<{
+                        /**
+                         * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
+                         *
+                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
+                         */
+                        newPosition: import("../tlv/TlvObject.js").FieldType<number>;
+                        /**
+                         * This field shall contain:
+                         *
+                         *   • a value of 2 when the second press of a multi-press sequence has been detected,
+                         *
+                         *   • a value of 3 when the third press of a multi-press sequence has been detected,
+                         *
+                         *   • a value of N when the Nth press of a multi-press sequence has been detected.
+                         *
+                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
+                         */
+                        currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
+                    }>, any>;
+                };
+            };
         }, {
             readonly flags: {
                 readonly momentarySwitchRelease: true;
                 readonly momentarySwitch: false;
             };
             readonly component: false;
+        }, {
+            readonly flags: {
+                readonly momentarySwitchRelease: true;
+                readonly actionSwitch: true;
+            };
+            readonly component: false;
         }, {
             readonly flags: {
                 readonly momentarySwitchLongPress: true;
@@ -661,6 +826,13 @@ export declare namespace Switch {
             readonly flags: {
                 readonly momentarySwitchLongPress: true;
                 readonly momentarySwitchRelease: false;
+                readonly actionSwitch: false;
+            };
+            readonly component: false;
+        }, {
+            readonly flags: {
+                readonly actionSwitch: true;
+                readonly momentarySwitchMultiPress: false;
             };
             readonly component: false;
         }, {
@@ -675,6 +847,12 @@ export declare namespace Switch {
                 readonly momentarySwitchRelease: false;
             };
             readonly component: false;
+        }, {
+            readonly flags: {
+                readonly actionSwitch: true;
+                readonly momentarySwitch: false;
+            };
+            readonly component: false;
         }, {
             readonly flags: {
                 readonly latchingSwitch: true;
@@ -695,12 +873,12 @@ export declare namespace Switch {
     const ClusterInstance: MutableCluster.ExtensibleOnly<{
         readonly id: 59;
         readonly name: "Switch";
-        readonly revision: 1;
+        readonly revision: 2;
         readonly features: {
             /**
              * LatchingSwitch
              *
-             * This feature is for a switch that maintains its position after being pressed (or turned).
+             * This feature flag is for a switch that maintains its position after being pressed (or turned).
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.1
              */
@@ -708,8 +886,8 @@ export declare namespace Switch {
             /**
              * MomentarySwitch
              *
-             * This feature is for a switch that does not maintain its position after being pressed (or turned). After
-             * releasing, it goes back to its idle position.
+             * This feature flag is for a switch that does not maintain its position after being pressed (or turned).
+             * After releasing, it goes back to its idle position.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.2
              */
@@ -717,8 +895,7 @@ export declare namespace Switch {
             /**
              * MomentarySwitchRelease
              *
-             * This feature is for a momentary switch that can distinguish and report release events. When this feature
-             * flag MSR is present, MS shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report release events.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.3
              */
@@ -726,8 +903,8 @@ export declare namespace Switch {
             /**
              * MomentarySwitchLongPress
              *
-             * This feature is for a momentary switch that can distinguish and report long presses from short presses.
-             * When this feature flag MSL is present, MS and MSR shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report long presses from short
+             * presses.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.4
              */
@@ -735,13 +912,21 @@ export declare namespace Switch {
             /**
              * MomentarySwitchMultiPress
              *
-             * This feature is for a momentary switch that can distinguish and report double press and potentially
-             * multiple presses with more events, such as triple press, etc. When this feature flag MSM is present, MS
-             * and MSR shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report double press and potentially
+             * multiple presses with more events, such as triple press, etc.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.5
              */
             readonly momentarySwitchMultiPress: BitFlag;
+            /**
+             * ActionSwitch
+             *
+             * This feature flag indicates simplified handling of events for multi-press-capable switches. See Multi
+             * Press Details.
+             *
+             * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.6
+             */
+            readonly actionSwitch: BitFlag;
         };
         readonly attributes: {
             /**
@@ -752,9 +937,10 @@ export declare namespace Switch {
              */
             readonly numberOfPositions: FixedAttribute<number, any>;
             /**
-             * Indicates the position of the switch. The valid range is zero to NumberOfPositions-1. CurrentPosition
-             * value 0 shall be assigned to the default position of the switch: for example the "open" state of a
-             * rocker switch, or the "idle" state of a push button switch.
+             * Indicates the position of the switch. The valid range is zero to NumberOfPositions - 1.
+             *
+             * CurrentPosition value 0 shall be assigned to the default position of the switch: for example the "open"
+             * state of a rocker switch, or the "idle" state of a push button switch.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.5.2
              */
@@ -771,40 +957,32 @@ export declare namespace Switch {
                 readonly attributes: {
                     /**
                      * Indicates how many consecutive presses can be detected and reported by a momentary switch which supports
-                     * multi-press (e.g. it will report the value 3 if it can detect single press, double press and triple
-                     * press, but not quad press and beyond).
+                     * multi-press (MSM feature flag set).
+                     *
+                     * For example, a momentary switch supporting single press, double press and triple press, but not quad
+                     * press and beyond, would return the value 3.
+                     *
+                     * When more than MultiPressMax presses are detected within a multi-press sequence:
+                     *
+                     *   • The server for cluster revision < 2 SHOULD generate a MultiPressComplete event with the
+                     *     TotalNumberOfPressesCounted field set to the value of the MultiPressMax attribute, and avoid
+                     *     generating any further InitialPress and MultiPressOngoing events until the switch has become fully
+                     *     idle (i.e. no longer in the process of counting presses within the multipress).
+                     *
+                     *   • The server for cluster revision >= 2 shall generate a MultiPressComplete event with the
+                     *     TotalNumberOfPressesCounted field set to zero (indicating an aborted sequence), and shall NOT
+                     *     generate any further InitialPress and MultiPressOngoing events until the switch has become fully
+                     *     idle (i.e. no longer in the process of counting presses within the multipress).
+                     *
+                     * This approach avoids unintentionally causing intermediate actions where there is a very long sequence of
+                     * presses beyond MultiPressMax that may be taken in account specially by switches (e.g. to trigger special
+                     * behavior such as factory reset for which generating events towards the client is not appropriate).
                      *
                      * @see {@link MatterSpecification.v13.Cluster} § 1.13.5.3
                      */
                     readonly multiPressMax: FixedAttribute<number, any>;
                 };
                 readonly events: {
-                    /**
-                     * This event shall be generated to indicate how many times the momentary switch has been pressed in a
-                     * multi-press sequence, during that sequence. See Multi Press Details below.
-                     *
-                     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
-                     */
-                    readonly multiPressOngoing: Event<import("../tlv/TlvObject.js").TypeFromFields<{
-                        /**
-                         * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
-                         *
-                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
-                         */
-                        newPosition: import("../tlv/TlvObject.js").FieldType<number>;
-                        /**
-                         * This field shall contain:
-                         *
-                         *   • a value of 2 when the second press of a multi-press sequence has been detected,
-                         *
-                         *   • a value of 3 when the third press of a multi-press sequence has been detected,
-                         *
-                         *   • a value of N when the Nth press of a multi-press sequence has been detected.
-                         *
-                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
-                         */
-                        currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
-                    }>, any>;
                     /**
                      * This event shall be generated to indicate how many times the momentary switch has been pressed in a
                      * multi-press sequence, after it has been detected that the sequence has ended. See Multi Press Details.
@@ -814,9 +992,11 @@ export declare namespace Switch {
                      *
                      * The TotalNumberOfPressesCounted field shall contain:
                      *
-                     *   • a value of 1 when there was one press in a multi-press sequence (and the sequence has ended),
+                     *   • a value of 0 when there was an aborted multi-press sequence, where the number of presses goes beyond
+                     *     MultiPressMax presses,
                      *
-                     *     i.e. there was no double press (or more),
+                     *   • a value of 1 when there was exactly one press in a multi-press sequence (and the sequence has
+                     *     ended), i.e. there was no double press (or more),
                      *
                      *   • a value of 2 when there were exactly two presses in a multi-press sequence (and the sequence has
                      *     ended),
@@ -827,6 +1007,14 @@ export declare namespace Switch {
                      *   • a value of N when there were exactly N presses in a multi-press sequence (and the sequence has
                      *     ended).
                      *
+                     * NOTE
+                     *
+                     * The introduction of TotalNumberOfPressesCounted supporting the value 0 may impact clients of switches
+                     * using cluster revision 1 since such servers would not use this value of TotalNumberOfPressesCounted to
+                     * indicate an aborted sequence. Clients SHOULD always act using the TotalNumberOfPressesCounted field
+                     * taken into account since for values from 1 to MultiPressMax, the user action that led to the event was
+                     * different depending on the count.
+                     *
                      * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.7
                      */
                     readonly multiPressComplete: Event<import("../tlv/TlvObject.js").TypeFromFields<{
@@ -885,8 +1073,36 @@ export declare namespace Switch {
             readonly component: {
                 readonly events: {
                     /**
-                     * This event shall be generated, when the momentary switch has been pressed for a "long" time (this time
-                     * interval is manufacturer determined (e.g. since it depends on the switch physics)).
+                     * This event shall be generated when the momentary switch has been pressed for a "long" time. The time
+                     * interval constituting a "long" time is manufacturer-determined, since it depends on the switch physics.
+                     *
+                     *   • When the AS feature flag is set, this event:
+                     *
+                     *     ◦ shall NOT be generated during a multi-press sequence (since a long press is a separate cycle from
+                     *       any multi-press cycles);
+                     *
+                     *     ◦ shall only be generated after the first InitialPress following a MultiPressComplete when a long
+                     *       press is detected after the idle time.
+                     *
+                     *   • Else, when the MSM feature flag is set, this event:
+                     *
+                     *     ◦ shall NOT be generated during a multi-press sequence (since a long press is a separate cycle from
+                     *       any multi-press cycles);
+                     *
+                     *     ◦ shall only be generated after the first InitialPress following a MultiPressComplete when a long
+                     *       press is detected after the idle time;
+                     *
+                     *     ◦ shall NOT be generated after a MultiPressOngoing event without an intervening MultiPressComplete
+                     *       event.
+                     *
+                     * The above constraints imply that for a given activity detection cycle of a switch having MSM and/or MSL
+                     * feature flags set, the entire activity is either a single long press detection cycle of (InitialPress,
+                     * LongPress, LongRelease), or a single multi-press detection cycle (ending in MultiPressComplete), where
+                     * presses that would otherwise be reported as long presses are instead reported as a counted press in the
+                     * MultiPressComplete event, and as InitialPress/ShortRelease pairs otherwise (where applicable).
+                     *
+                     * The rationale for this constraint is the ambiguity of interpretation of events when mixing long presses
+                     * and multi-press events.
                      *
                      * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.3
                      */
@@ -923,14 +1139,19 @@ export declare namespace Switch {
             readonly component: {
                 readonly events: {
                     /**
+                     * If the server has the Action Switch (AS) feature flag set, this event shall NOT be generated at all,
+                     * since setting the Action Switch feature flag forbids the Momentary Switch ShortRelease (MSR) feature
+                     * flag from being set. Otherwise, the following paragraphs describe the situations where this event is
+                     * generated.
+                     *
                      * This event shall be generated, when the momentary switch has been released (after debouncing).
                      *
-                     *   • If the server supports the Momentary Switch LongPress (MSL) feature, this event shall be generated
-                     *     when the switch is released if no LongPress event had been generated since the previous InitialPress
-                     *     event.
+                     *   • If the server has the Momentary Switch LongPress (MSL) feature flag set, then this event shall be
+                     *     generated when the switch is released if no LongPress event had been generated since the previous
+                     *     InitialPress event.
                      *
-                     *   • If the server does not support the Momentary Switch LongPress (MSL) feature, this event shall be
-                     *     generated when the switch is released - even when the switch was pressed for a long time.
+                     *   • If the server does not have the Momentary Switch LongPress (MSL) feature flag set, this event shall
+                     *     be generated when the switch is released - even when the switch was pressed for a long time.
                      *
                      *   • Also see Section 1.13.7, “Sequence of generated events”.
                      *
@@ -946,12 +1167,56 @@ export declare namespace Switch {
                     }>, any>;
                 };
             };
+        }, {
+            readonly flags: {
+                readonly momentarySwitchMultiPress: true;
+                readonly actionSwitch: false;
+            };
+            readonly component: {
+                readonly events: {
+                    /**
+                     * If the server has the Action Switch (AS) feature flag set, this event shall NOT be generated at all.
+                     * Otherwise, the following paragraphs describe the situations where this event is generated.
+                     *
+                     * This event shall be generated to indicate how many times the momentary switch has been pressed in a
+                     * multi-press sequence, during that sequence. See Multi Press Details below.
+                     *
+                     * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6
+                     */
+                    readonly multiPressOngoing: Event<import("../tlv/TlvObject.js").TypeFromFields<{
+                        /**
+                         * This field shall indicate the new value of the CurrentPosition attribute, i.e. while pressed.
+                         *
+                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.1
+                         */
+                        newPosition: import("../tlv/TlvObject.js").FieldType<number>;
+                        /**
+                         * This field shall contain:
+                         *
+                         *   • a value of 2 when the second press of a multi-press sequence has been detected,
+                         *
+                         *   • a value of 3 when the third press of a multi-press sequence has been detected,
+                         *
+                         *   • a value of N when the Nth press of a multi-press sequence has been detected.
+                         *
+                         * @see {@link MatterSpecification.v13.Cluster} § 1.13.6.6.2
+                         */
+                        currentNumberOfPressesCounted: import("../tlv/TlvObject.js").FieldType<number>;
+                    }>, any>;
+                };
+            };
         }, {
             readonly flags: {
                 readonly momentarySwitchRelease: true;
                 readonly momentarySwitch: false;
             };
             readonly component: false;
+        }, {
+            readonly flags: {
+                readonly momentarySwitchRelease: true;
+                readonly actionSwitch: true;
+            };
+            readonly component: false;
         }, {
             readonly flags: {
                 readonly momentarySwitchLongPress: true;
@@ -962,6 +1227,13 @@ export declare namespace Switch {
             readonly flags: {
                 readonly momentarySwitchLongPress: true;
                 readonly momentarySwitchRelease: false;
+                readonly actionSwitch: false;
+            };
+            readonly component: false;
+        }, {
+            readonly flags: {
+                readonly actionSwitch: true;
+                readonly momentarySwitchMultiPress: false;
             };
             readonly component: false;
         }, {
@@ -976,6 +1248,12 @@ export declare namespace Switch {
                 readonly momentarySwitchRelease: false;
             };
             readonly component: false;
+        }, {
+            readonly flags: {
+                readonly actionSwitch: true;
+                readonly momentarySwitch: false;
+            };
+            readonly component: false;
         }, {
             readonly flags: {
                 readonly latchingSwitch: true;
@@ -1018,12 +1296,12 @@ export declare namespace Switch {
     const CompleteInstance: MutableCluster<{
         readonly id: 59;
         readonly name: "Switch";
-        readonly revision: 1;
+        readonly revision: 2;
         readonly features: {
             /**
              * LatchingSwitch
              *
-             * This feature is for a switch that maintains its position after being pressed (or turned).
+             * This feature flag is for a switch that maintains its position after being pressed (or turned).
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.1
              */
@@ -1031,8 +1309,8 @@ export declare namespace Switch {
             /**
              * MomentarySwitch
              *
-             * This feature is for a switch that does not maintain its position after being pressed (or turned). After
-             * releasing, it goes back to its idle position.
+             * This feature flag is for a switch that does not maintain its position after being pressed (or turned).
+             * After releasing, it goes back to its idle position.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.2
              */
@@ -1040,8 +1318,7 @@ export declare namespace Switch {
             /**
              * MomentarySwitchRelease
              *
-             * This feature is for a momentary switch that can distinguish and report release events. When this feature
-             * flag MSR is present, MS shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report release events.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.3
              */
@@ -1049,8 +1326,8 @@ export declare namespace Switch {
             /**
              * MomentarySwitchLongPress
              *
-             * This feature is for a momentary switch that can distinguish and report long presses from short presses.
-             * When this feature flag MSL is present, MS and MSR shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report long presses from short
+             * presses.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.4
              */
@@ -1058,13 +1335,21 @@ export declare namespace Switch {
             /**
              * MomentarySwitchMultiPress
              *
-             * This feature is for a momentary switch that can distinguish and report double press and potentially
-             * multiple presses with more events, such as triple press, etc. When this feature flag MSM is present, MS
-             * and MSR shall be present as well.
+             * This feature flag is for a momentary switch that can distinguish and report double press and potentially
+             * multiple presses with more events, such as triple press, etc.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.5
              */
             readonly momentarySwitchMultiPress: BitFlag;
+            /**
+             * ActionSwitch
+             *
+             * This feature flag indicates simplified handling of events for multi-press-capable switches. See Multi
+             * Press Details.
+             *
+             * @see {@link MatterSpecification.v13.Cluster} § 1.13.4.6
+             */
+            readonly actionSwitch: BitFlag;
         };
         readonly attributes: {
             readonly multiPressMax: FixedAttribute<number, any> & {
@@ -1083,9 +1368,10 @@ export declare namespace Switch {
              */
             readonly numberOfPositions: FixedAttribute<number, any>;
             /**
-             * Indicates the position of the switch. The valid range is zero to NumberOfPositions-1. CurrentPosition
-             * value 0 shall be assigned to the default position of the switch: for example the "open" state of a
-             * rocker switch, or the "idle" state of a push button switch.
+             * Indicates the position of the switch. The valid range is zero to NumberOfPositions - 1.
+             *
+             * CurrentPosition value 0 shall be assigned to the default position of the switch: for example the "open"
+             * state of a rocker switch, or the "idle" state of a push button switch.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.13.5.2
              */
@@ -1192,6 +1478,7 @@ export declare namespace Switch {
                 readonly optionalIf: [] | import("../cluster/Cluster.js").ConditionalFeatureList<import("../schema/BitmapSchema.js").BitSchema>;
                 readonly mandatoryIf: [] | [{
                     momentarySwitchMultiPress: boolean;
+                    actionSwitch: boolean;
                 }];
             };
             readonly multiPressComplete: Event<import("../tlv/TlvObject.js").TypeFromFields<{