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

package/dist/cjs/clusters/scenes-management.d.ts

@@ -95,17 +95,19 @@ export declare namespace ScenesManagement {
         /**
          * This field shall be present for all instances in a given ExtensionFieldSetStruct.
          *
-         * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+         * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+         * AttributeID, as described in the Value* Fields subsection.
          *
          * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
          * column of the cluster specification.
          *
-         *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-         *              ValueUnsigned64, ValueSigned64 Fields
+         * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+         * ValueUnsigned64, ValueSigned64 Fields
          *
          * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-         * data type of the attribute indicated.
+         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+         *
+         * be determined by the type of the attribute indicated by AttributeID as follows:
          *
          *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
          *
@@ -119,33 +121,48 @@ export declare namespace ScenesManagement {
          *
          *   • Data types int24 and int32 shall map to ValueSigned32.
          *
-         *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+         *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+         *
+         *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
+         *
+         *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+         *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+         *     be treated as if it were of type uint16.
+         *
+         *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
          *
-         *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+         *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+         *     FALSE.
          *
-         *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-         *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-         *     null value for the type.
+         *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+         *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+         *     have the null value for the type.
          *
-         *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-         *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-         *     constrained range.
+         *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+         *     type after accounting for constraints shall be considered to be the valid attribute value that is
+         *     closest to the provided value.
+         *
+         *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+         *       values, the lowest of those values shall be considered the closest valid attribute value.
+         *
+         * If the used field does not match the data type of the attribute indicated by AttributeID, the
+         * AttributeValuePairStruct shall be considered invalid.
          *
          * Examples of processing are:
          *
          *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
          *
-         *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+         *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
          *
-         *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-         *       the attribute’s constraint range: 0xFEFF.
+         *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+         *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
          *
          *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
          *
-         *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+         *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
          *
-         *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-         *       value.
+         *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+         *       considered as the null value.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
          */
@@ -190,17 +207,19 @@ export declare namespace ScenesManagement {
             /**
              * This field shall be present for all instances in a given ExtensionFieldSetStruct.
              *
-             * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+             * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+             * AttributeID, as described in the Value* Fields subsection.
              *
              * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
              * column of the cluster specification.
              *
-             *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-             *              ValueUnsigned64, ValueSigned64 Fields
+             * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+             * ValueUnsigned64, ValueSigned64 Fields
              *
              * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-             * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-             * data type of the attribute indicated.
+             * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+             *
+             * be determined by the type of the attribute indicated by AttributeID as follows:
              *
              *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
              *
@@ -214,33 +233,48 @@ export declare namespace ScenesManagement {
              *
              *   • Data types int24 and int32 shall map to ValueSigned32.
              *
-             *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+             *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+             *
+             *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
              *
-             *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+             *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+             *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+             *     be treated as if it were of type uint16.
              *
-             *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-             *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-             *     null value for the type.
+             *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
              *
-             *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-             *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-             *     constrained range.
+             *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+             *     FALSE.
+             *
+             *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+             *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+             *     have the null value for the type.
+             *
+             *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+             *     type after accounting for constraints shall be considered to be the valid attribute value that is
+             *     closest to the provided value.
+             *
+             *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+             *       values, the lowest of those values shall be considered the closest valid attribute value.
+             *
+             * If the used field does not match the data type of the attribute indicated by AttributeID, the
+             * AttributeValuePairStruct shall be considered invalid.
              *
              * Examples of processing are:
              *
              *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
              *
-             *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+             *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
              *
-             *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-             *       the attribute’s constraint range: 0xFEFF.
+             *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+             *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
              *
              *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
              *
-             *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+             *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
              *
-             *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-             *       value.
+             *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+             *       considered as the null value.
              *
              * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
              */
@@ -316,17 +350,19 @@ export declare namespace ScenesManagement {
                 /**
                  * This field shall be present for all instances in a given ExtensionFieldSetStruct.
                  *
-                 * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+                 * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+                 * AttributeID, as described in the Value* Fields subsection.
                  *
                  * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
                  * column of the cluster specification.
                  *
-                 *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-                 *              ValueUnsigned64, ValueSigned64 Fields
+                 * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+                 * ValueUnsigned64, ValueSigned64 Fields
                  *
                  * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-                 * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-                 * data type of the attribute indicated.
+                 * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+                 *
+                 * be determined by the type of the attribute indicated by AttributeID as follows:
                  *
                  *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
                  *
@@ -340,33 +376,48 @@ export declare namespace ScenesManagement {
                  *
                  *   • Data types int24 and int32 shall map to ValueSigned32.
                  *
-                 *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                 *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                 *
+                 *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
+                 *
+                 *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+                 *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+                 *     be treated as if it were of type uint16.
                  *
-                 *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+                 *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
                  *
-                 *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                 *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-                 *     null value for the type.
+                 *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+                 *     FALSE.
                  *
-                 *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                 *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-                 *     constrained range.
+                 *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+                 *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+                 *     have the null value for the type.
+                 *
+                 *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+                 *     type after accounting for constraints shall be considered to be the valid attribute value that is
+                 *     closest to the provided value.
+                 *
+                 *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+                 *       values, the lowest of those values shall be considered the closest valid attribute value.
+                 *
+                 * If the used field does not match the data type of the attribute indicated by AttributeID, the
+                 * AttributeValuePairStruct shall be considered invalid.
                  *
                  * Examples of processing are:
                  *
                  *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
                  *
-                 *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+                 *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
                  *
-                 *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-                 *       the attribute’s constraint range: 0xFEFF.
+                 *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+                 *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
                  *
                  *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
                  *
-                 *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+                 *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
                  *
-                 *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-                 *       value.
+                 *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+                 *       considered as the null value.
                  *
                  * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
                  */
@@ -504,17 +555,19 @@ export declare namespace ScenesManagement {
                 /**
                  * This field shall be present for all instances in a given ExtensionFieldSetStruct.
                  *
-                 * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+                 * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+                 * AttributeID, as described in the Value* Fields subsection.
                  *
                  * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
                  * column of the cluster specification.
                  *
-                 *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-                 *              ValueUnsigned64, ValueSigned64 Fields
+                 * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+                 * ValueUnsigned64, ValueSigned64 Fields
                  *
                  * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-                 * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-                 * data type of the attribute indicated.
+                 * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+                 *
+                 * be determined by the type of the attribute indicated by AttributeID as follows:
                  *
                  *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
                  *
@@ -528,33 +581,48 @@ export declare namespace ScenesManagement {
                  *
                  *   • Data types int24 and int32 shall map to ValueSigned32.
                  *
-                 *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                 *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                 *
+                 *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
+                 *
+                 *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+                 *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+                 *     be treated as if it were of type uint16.
+                 *
+                 *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
+                 *
+                 *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+                 *     FALSE.
                  *
-                 *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+                 *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+                 *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+                 *     have the null value for the type.
                  *
-                 *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                 *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-                 *     null value for the type.
+                 *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+                 *     type after accounting for constraints shall be considered to be the valid attribute value that is
+                 *     closest to the provided value.
                  *
-                 *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                 *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-                 *     constrained range.
+                 *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+                 *       values, the lowest of those values shall be considered the closest valid attribute value.
+                 *
+                 * If the used field does not match the data type of the attribute indicated by AttributeID, the
+                 * AttributeValuePairStruct shall be considered invalid.
                  *
                  * Examples of processing are:
                  *
                  *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
                  *
-                 *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+                 *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
                  *
-                 *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-                 *       the attribute’s constraint range: 0xFEFF.
+                 *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+                 *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
                  *
                  *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
                  *
-                 *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+                 *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
                  *
-                 *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-                 *       value.
+                 *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+                 *       considered as the null value.
                  *
                  * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
                  */
@@ -904,9 +972,7 @@ export declare namespace ScenesManagement {
          */
         groupIdentifierFrom: import("../tlv/TlvObject.js").FieldType<import("../datatype/GroupId.js").GroupId>;
         /**
-         * This field shall be set to the same values as in the corresponding fields of the received CopyScene
-         *
-         * command.
+         * This field shall be set to the same values as in the corresponding fields of the received CopyScene command.
          *
          * @see {@link MatterSpecification.v13.Cluster} § 1.4.9.16.3
          */
@@ -986,17 +1052,19 @@ export declare namespace ScenesManagement {
                 /**
                  * This field shall be present for all instances in a given ExtensionFieldSetStruct.
                  *
-                 * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+                 * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+                 * AttributeID, as described in the Value* Fields subsection.
                  *
                  * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
                  * column of the cluster specification.
                  *
-                 *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-                 *              ValueUnsigned64, ValueSigned64 Fields
+                 * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+                 * ValueUnsigned64, ValueSigned64 Fields
                  *
                  * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-                 * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-                 * data type of the attribute indicated.
+                 * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+                 *
+                 * be determined by the type of the attribute indicated by AttributeID as follows:
                  *
                  *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
                  *
@@ -1010,33 +1078,48 @@ export declare namespace ScenesManagement {
                  *
                  *   • Data types int24 and int32 shall map to ValueSigned32.
                  *
-                 *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                 *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                 *
+                 *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
+                 *
+                 *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+                 *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+                 *     be treated as if it were of type uint16.
+                 *
+                 *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
                  *
-                 *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+                 *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+                 *     FALSE.
                  *
-                 *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                 *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-                 *     null value for the type.
+                 *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+                 *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+                 *     have the null value for the type.
                  *
-                 *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                 *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-                 *     constrained range.
+                 *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+                 *     type after accounting for constraints shall be considered to be the valid attribute value that is
+                 *     closest to the provided value.
+                 *
+                 *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+                 *       values, the lowest of those values shall be considered the closest valid attribute value.
+                 *
+                 * If the used field does not match the data type of the attribute indicated by AttributeID, the
+                 * AttributeValuePairStruct shall be considered invalid.
                  *
                  * Examples of processing are:
                  *
                  *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
                  *
-                 *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+                 *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
                  *
-                 *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-                 *       the attribute’s constraint range: 0xFEFF.
+                 *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+                 *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
                  *
                  *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
                  *
-                 *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+                 *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
                  *
-                 *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-                 *       value.
+                 *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+                 *       considered as the null value.
                  *
                  * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
                  */
@@ -1223,17 +1306,19 @@ export declare namespace ScenesManagement {
                         /**
                          * This field shall be present for all instances in a given ExtensionFieldSetStruct.
                          *
-                         * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+                         * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+                         * AttributeID, as described in the Value* Fields subsection.
                          *
                          * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
                          * column of the cluster specification.
                          *
-                         *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-                         *              ValueUnsigned64, ValueSigned64 Fields
+                         * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+                         * ValueUnsigned64, ValueSigned64 Fields
                          *
                          * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-                         * data type of the attribute indicated.
+                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+                         *
+                         * be determined by the type of the attribute indicated by AttributeID as follows:
                          *
                          *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
                          *
@@ -1247,33 +1332,48 @@ export declare namespace ScenesManagement {
                          *
                          *   • Data types int24 and int32 shall map to ValueSigned32.
                          *
-                         *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                         *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                         *
+                         *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
+                         *
+                         *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+                         *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+                         *     be treated as if it were of type uint16.
+                         *
+                         *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
+                         *
+                         *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+                         *     FALSE.
+                         *
+                         *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+                         *     have the null value for the type.
                          *
-                         *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+                         *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for constraints shall be considered to be the valid attribute value that is
+                         *     closest to the provided value.
                          *
-                         *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-                         *     null value for the type.
+                         *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+                         *       values, the lowest of those values shall be considered the closest valid attribute value.
                          *
-                         *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-                         *     constrained range.
+                         * If the used field does not match the data type of the attribute indicated by AttributeID, the
+                         * AttributeValuePairStruct shall be considered invalid.
                          *
                          * Examples of processing are:
                          *
                          *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
                          *
-                         *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-                         *       the attribute’s constraint range: 0xFEFF.
+                         *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+                         *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
                          *
                          *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
                          *
-                         *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-                         *       value.
+                         *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+                         *       considered as the null value.
                          *
                          * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
                          */
@@ -1382,17 +1482,19 @@ export declare namespace ScenesManagement {
                         /**
                          * This field shall be present for all instances in a given ExtensionFieldSetStruct.
                          *
-                         * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+                         * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+                         * AttributeID, as described in the Value* Fields subsection.
                          *
                          * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
                          * column of the cluster specification.
                          *
-                         *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-                         *              ValueUnsigned64, ValueSigned64 Fields
+                         * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+                         * ValueUnsigned64, ValueSigned64 Fields
                          *
                          * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-                         * data type of the attribute indicated.
+                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+                         *
+                         * be determined by the type of the attribute indicated by AttributeID as follows:
                          *
                          *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
                          *
@@ -1406,33 +1508,48 @@ export declare namespace ScenesManagement {
                          *
                          *   • Data types int24 and int32 shall map to ValueSigned32.
                          *
-                         *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                         *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                         *
+                         *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
+                         *
+                         *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+                         *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+                         *     be treated as if it were of type uint16.
+                         *
+                         *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
                          *
-                         *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+                         *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+                         *     FALSE.
                          *
-                         *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-                         *     null value for the type.
+                         *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+                         *     have the null value for the type.
                          *
-                         *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-                         *     constrained range.
+                         *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for constraints shall be considered to be the valid attribute value that is
+                         *     closest to the provided value.
+                         *
+                         *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+                         *       values, the lowest of those values shall be considered the closest valid attribute value.
+                         *
+                         * If the used field does not match the data type of the attribute indicated by AttributeID, the
+                         * AttributeValuePairStruct shall be considered invalid.
                          *
                          * Examples of processing are:
                          *
                          *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
                          *
-                         *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-                         *       the attribute’s constraint range: 0xFEFF.
+                         *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+                         *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
                          *
                          *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
                          *
-                         *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-                         *       value.
+                         *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+                         *       considered as the null value.
                          *
                          * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
                          */
@@ -1680,9 +1797,7 @@ export declare namespace ScenesManagement {
                  */
                 groupIdentifierFrom: import("../tlv/TlvObject.js").FieldType<import("../datatype/GroupId.js").GroupId>;
                 /**
-                 * This field shall be set to the same values as in the corresponding fields of the received CopyScene
-                 *
-                 * command.
+                 * This field shall be set to the same values as in the corresponding fields of the received CopyScene command.
                  *
                  * @see {@link MatterSpecification.v13.Cluster} § 1.4.9.16.3
                  */
@@ -1852,17 +1967,19 @@ export declare namespace ScenesManagement {
                         /**
                          * This field shall be present for all instances in a given ExtensionFieldSetStruct.
                          *
-                         * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+                         * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+                         * AttributeID, as described in the Value* Fields subsection.
                          *
                          * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
                          * column of the cluster specification.
                          *
-                         *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-                         *              ValueUnsigned64, ValueSigned64 Fields
+                         * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+                         * ValueUnsigned64, ValueSigned64 Fields
                          *
                          * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-                         * data type of the attribute indicated.
+                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+                         *
+                         * be determined by the type of the attribute indicated by AttributeID as follows:
                          *
                          *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
                          *
@@ -1876,33 +1993,48 @@ export declare namespace ScenesManagement {
                          *
                          *   • Data types int24 and int32 shall map to ValueSigned32.
                          *
-                         *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                         *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                         *
+                         *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
+                         *
+                         *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+                         *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+                         *     be treated as if it were of type uint16.
                          *
-                         *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+                         *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
                          *
-                         *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-                         *     null value for the type.
+                         *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+                         *     FALSE.
                          *
-                         *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-                         *     constrained range.
+                         *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+                         *     have the null value for the type.
+                         *
+                         *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for constraints shall be considered to be the valid attribute value that is
+                         *     closest to the provided value.
+                         *
+                         *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+                         *       values, the lowest of those values shall be considered the closest valid attribute value.
+                         *
+                         * If the used field does not match the data type of the attribute indicated by AttributeID, the
+                         * AttributeValuePairStruct shall be considered invalid.
                          *
                          * Examples of processing are:
                          *
                          *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
                          *
-                         *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-                         *       the attribute’s constraint range: 0xFEFF.
+                         *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+                         *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
                          *
                          *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
                          *
-                         *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-                         *       value.
+                         *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+                         *       considered as the null value.
                          *
                          * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
                          */
@@ -2011,17 +2143,19 @@ export declare namespace ScenesManagement {
                         /**
                          * This field shall be present for all instances in a given ExtensionFieldSetStruct.
                          *
-                         * The data type of AttributeValue shall be the data type of the attribute indicated by AttributeID.
+                         * Which Value* field is used shall be determined based on the data type of the attribute indicated by
+                         * AttributeID, as described in the Value* Fields subsection.
                          *
                          * The AttributeID field shall NOT refer to an attribute without the Scenes ("S") designation in the Quality
                          * column of the cluster specification.
                          *
-                         *   1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
-                         *              ValueUnsigned64, ValueSigned64 Fields
+                         * ### 1.4.7.3.2. ValueUnsigned8, ValueSigned8, ValueUnsigned16, ValueSigned16, ValueUnsigned32, ValueSigned32,
+                         * ValueUnsigned64, ValueSigned64 Fields
                          *
                          * These fields shall indicate the attribute value as part of an extension field set, associated with a given
-                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. The proper field shall be present that maps to the
-                         * data type of the attribute indicated.
+                         * AttributeID under an ExtensionFieldSetStruct’s ClusterID. Which of the fields is used shall
+                         *
+                         * be determined by the type of the attribute indicated by AttributeID as follows:
                          *
                          *   • Data types bool, map8, and uint8 shall map to ValueUnsigned8.
                          *
@@ -2035,33 +2169,48 @@ export declare namespace ScenesManagement {
                          *
                          *   • Data types int24 and int32 shall map to ValueSigned32.
                          *
-                         *   • Data types map64, uint48, uint56 and uint64 shall map to ValueUnsigned64.
+                         *   • Data types map64, uint40, uint48, uint56 and uint64 shall map to ValueUnsigned64.
                          *
-                         *   • Data types int48, int56 and int64 shall map to ValueSigned64.
+                         *   • Data types int40, int48, int56 and int64 shall map to ValueSigned64.
                          *
-                         *   • For nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for range reductions due to being nullable and constraints shall be considered to have the
-                         *     null value for the type.
+                         *   • For derived types, the mapping shall be based on the base type. For example, an attribute of type
+                         *     percent shall be treated as if it were of type uint8, whereas an attribute of type percent100ths shall
+                         *     be treated as if it were of type uint16.
                          *
-                         *   • For non-nullable attributes, any value that is not a valid numeric value for the attribute’s type after
-                         *     accounting for constraints shall be considered to have the maximum legal value in the attribute’s
-                         *     constrained range.
+                         *   • For boolean nullable attributes, any value that is not 0 or 1 shall be considered to have the null value.
+                         *
+                         *   • For boolean non-nullable attributes, any value that is not 0 or 1 shall be considered to have the value
+                         *     FALSE.
+                         *
+                         *   • For non-boolean nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for range reductions due to being nullable and constraints shall be considered to
+                         *     have the null value for the type.
+                         *
+                         *   • For non-boolean non-nullable attributes, any value that is not a valid numeric value for the attribute’s
+                         *     type after accounting for constraints shall be considered to be the valid attribute value that is
+                         *     closest to the provided value.
+                         *
+                         *     ◦ In the event that an invalid provided value is of equal numerical distance to the two closest valid
+                         *       values, the lowest of those values shall be considered the closest valid attribute value.
+                         *
+                         * If the used field does not match the data type of the attribute indicated by AttributeID, the
+                         * AttributeValuePairStruct shall be considered invalid.
                          *
                          * Examples of processing are:
                          *
                          *   • ColorControl cluster CurrentX (AttributeID 0x0003) has a type of uint16 and is not nullable.
                          *
-                         *     ◦ AttributeValue of 0xAB12 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned16 of 0xAB12 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xAA0011 is outside of the range of uint16, and would be saturated to the maximum of
-                         *       the attribute’s constraint range: 0xFEFF.
+                         *     ◦ ValueUnsigned16 of 0xFF80 is outside of the range allowed for attribute CurrentX, and would be
+                         *       saturated to the closest valid value, which is the maximum of the attribute’s constraint range: 0xFEFF.
                          *
                          *   • LevelControl cluster CurrentLevel (AttributeID 0x0000) has a type of uint8 and is nullable.
                          *
-                         *     ◦ AttributeValue of 0xA1 would be used as-is, as it is in range.
+                         *     ◦ ValueUnsigned8 of 0xA1 would be used as-is, as it is in range.
                          *
-                         *     ◦ AttributeValue of 0xBB12 is outside the range of nullable uint8, and would be considered as the null
-                         *       value.
+                         *     ◦ ValueUnsigned8 of 0xFF is outside the range allowed for nullable attribute CurrentLevel, and would be
+                         *       considered as the null value.
                          *
                          * @see {@link MatterSpecification.v13.Cluster} § 1.4.7.3.1
                          */
@@ -2309,9 +2458,7 @@ export declare namespace ScenesManagement {
                  */
                 groupIdentifierFrom: import("../tlv/TlvObject.js").FieldType<import("../datatype/GroupId.js").GroupId>;
                 /**
-                 * This field shall be set to the same values as in the corresponding fields of the received CopyScene
-                 *
-                 * command.
+                 * This field shall be set to the same values as in the corresponding fields of the received CopyScene command.
                  *
                  * @see {@link MatterSpecification.v13.Cluster} § 1.4.9.16.3
                  */
@@ -2332,7 +2479,7 @@ export declare namespace ScenesManagement {
      * In most cases scenes are associated with a particular group identifier. Scenes may also exist without a group,
      * in which case the value 0 replaces the group identifier. Note that extra care is required in these cases to
      * avoid a scene identifier collision, and that commands related to scenes without a group may only be unicast,
-     * i.e., they may not be multicast or broadcast.
+     * i.e., they shall NOT be multicast or broadcast.
      *
      * NOTE Support for Scenes Management cluster is provisional.
      *