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

package/src/clusters/window-covering.ts

@@ -229,9 +229,6 @@ export namespace WindowCovering {
          */
         operational: BitFlag(0),
 
-        /**
-         * Deprecated and reserved.
-         */
         onlineReserved: BitFlag(1),
 
         /**
@@ -631,7 +628,7 @@ export namespace WindowCovering {
              * Indicates the maximum possible encoder position possible (Unit cm, centimeters) to position the height
              * of the window covering lift.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.3
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.2
              */
             physicalClosedLimitLift: OptionalFixedAttribute(0x1, TlvUInt16, { default: 0 }),
 
@@ -639,7 +636,7 @@ export namespace WindowCovering {
              * Indicates the actual lift position (Unit cm, centimeters) of the window covering from the fully-open
              * position.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.5
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.4
              */
             currentPositionLift: OptionalAttribute(0x3, TlvNullable(TlvUInt16), { persistent: true, default: null }),
 
@@ -647,7 +644,7 @@ export namespace WindowCovering {
              * Indicates the open limit for lifting the window covering whether position (in centimeters) is encoded or
              * timed.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.18
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.17
              */
             installedOpenLimitLift: Attribute(0x10, TlvUInt16.bound({ max: 65534 }), { persistent: true, default: 0 }),
 
@@ -655,7 +652,7 @@ export namespace WindowCovering {
              * Indicates the closed limit for lifting the window covering whether position (in centimeters) is encoded
              * or timed.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.19
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.18
              */
             installedClosedLimitLift: Attribute(
                 0x11,
@@ -675,7 +672,7 @@ export namespace WindowCovering {
              * Indicates the maximum possible encoder position possible (Unit 0.1°, tenths of a degree) to position the
              * angle of the window covering tilt.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.4
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.3
              */
             physicalClosedLimitTilt: OptionalFixedAttribute(0x2, TlvUInt16, { default: 0 }),
 
@@ -683,7 +680,7 @@ export namespace WindowCovering {
              * Indicates the actual tilt position (Unit 0.1°, tenths of a degree) of the window covering from the
              * fully-open position.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.6
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.5
              */
             currentPositionTilt: OptionalAttribute(0x4, TlvNullable(TlvUInt16), { persistent: true, default: null }),
 
@@ -691,7 +688,7 @@ export namespace WindowCovering {
              * Indicates the open limit for tilting the window covering whether position (in tenth of a degree) is
              * encoded or timed.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.20
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.19
              */
             installedOpenLimitTilt: Attribute(0x12, TlvUInt16.bound({ max: 65534 }), { persistent: true, default: 0 }),
 
@@ -699,7 +696,7 @@ export namespace WindowCovering {
              * Indicates the closed limit for tilting the window covering whether position (in tenth of a degree) is
              * encoded or timed.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.21
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.20
              */
             installedClosedLimitTilt: Attribute(
                 0x13,
@@ -718,7 +715,7 @@ export namespace WindowCovering {
              * Indicates the total number of lift/slide actuations applied to the window covering since the device was
              * installed.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.7
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.6
              */
             numberOfActuationsLift: OptionalAttribute(0x5, TlvUInt16, { persistent: true, default: 0 })
         },
@@ -756,7 +753,7 @@ export namespace WindowCovering {
              * Indicates the total number of tilt actuations applied to the window covering since the device was
              * installed.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.8
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.7
              */
             numberOfActuationsTilt: OptionalAttribute(0x6, TlvUInt16, { persistent: true, default: 0 })
         },
@@ -794,30 +791,26 @@ export namespace WindowCovering {
              * Indicates the actual position as a percentage from 0% to 100% with 1% default step. This attribute is
              * equal to CurrentPositionLiftPercent100ths attribute divided by 100.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.12
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.11
              */
             currentPositionLiftPercentage: OptionalAttribute(
                 0x8,
                 TlvNullable(TlvPercent),
-                { scene: true, persistent: true, default: null }
+                { persistent: true, default: null }
             ),
 
             /**
              * Indicates the position where the window covering lift will go or is moving to as a percentage (Unit
              * 0.01%).
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.14
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.13
              */
-            targetPositionLiftPercent100ths: Attribute(
-                0xb,
-                TlvNullable(TlvPercent100ths),
-                { scene: true, default: null }
-            ),
+            targetPositionLiftPercent100ths: Attribute(0xb, TlvNullable(TlvPercent100ths), { default: null }),
 
             /**
              * Indicates the actual position as a percentage with a minimal step of 0.01%. E.g Max 10000 equals 100.00%.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.10
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.9
              */
             currentPositionLiftPercent100ths: Attribute(
                 0xe,
@@ -859,30 +852,26 @@ export namespace WindowCovering {
              * Indicates the actual position as a percentage from 0% to 100% with 1% default step. This attribute is
              * equal to CurrentPositionTiltPercent100ths attribute divided by 100.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.13
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.12
              */
             currentPositionTiltPercentage: OptionalAttribute(
                 0x9,
                 TlvNullable(TlvPercent),
-                { scene: true, persistent: true, default: null }
+                { persistent: true, default: null }
             ),
 
             /**
              * Indicates the position where the window covering tilt will go or is moving to as a percentage (Unit
              * 0.01%).
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.15
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.14
              */
-            targetPositionTiltPercent100ths: Attribute(
-                0xc,
-                TlvNullable(TlvPercent100ths),
-                { scene: true, default: null }
-            ),
+            targetPositionTiltPercent100ths: Attribute(0xc, TlvNullable(TlvPercent100ths), { default: null }),
 
             /**
              * Indicates the actual position as a percentage with a minimal step of 0.01%. E.g Max 10000 equals 100.00%.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.11
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.10
              */
             currentPositionTiltPercent100ths: Attribute(
                 0xf,
@@ -1000,7 +989,7 @@ export namespace WindowCovering {
             /**
              * This attribute shall identify the type of window covering.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.2
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.1
              */
             type: FixedAttribute(0x0, TlvEnum<WindowCoveringType>(), { default: WindowCoveringType.Rollershade }),
 
@@ -1010,14 +999,14 @@ export namespace WindowCovering {
              * To change settings, devices shall write to the Mode attribute. The behavior causing the setting or
              * clearing of each bit is vendor specific.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.9
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.8
              */
             configStatus: Attribute(0x7, TlvBitmap(TlvUInt8, ConfigStatus), { persistent: true }),
 
             /**
              * Indicates the currently ongoing operations and applies to all type of devices.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.16
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.15
              */
             operationalStatus: Attribute(0xa, TlvBitmap(TlvUInt8, OperationalStatus)),
 
@@ -1027,7 +1016,7 @@ export namespace WindowCovering {
              *
              * The table below helps to match the EndProductType attribute with the Type attribute.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.17
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.16
              */
             endProductType: FixedAttribute(0xd, TlvEnum<EndProductType>(), { default: EndProductType.RollerShade }),
 
@@ -1041,7 +1030,7 @@ export namespace WindowCovering {
              * write interaction to the Mode attribute, with an unsupported mode bit or any out of bounds bits set,
              * must be ignored and a response containing the status of CONSTRAINT_ERROR will be returned.
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.22
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.21
              */
             mode: WritableAttribute(
                 0x17,
@@ -1054,7 +1043,7 @@ export namespace WindowCovering {
              * movements. By default for nominal operation all flags are cleared (0). A device might support none, one
              * or several bit flags from this attribute (all optional).
              *
-             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.23
+             * @see {@link MatterSpecification.v13.Cluster} § 5.3.6.22
              */
             safetyStatus: OptionalAttribute(0x1a, TlvBitmap(TlvUInt16, SafetyStatus))
         },

package/src/globals/AtomicAttributeStatus.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvAttributeId } from "../datatype/AttributeId.js";
+import { Status } from "./Status.js";
+import { TlvEnum } from "../tlv/TlvNumber.js";
+import { TypeFromSchema } from "../tlv/TlvSchema.js";
+
+/**
+ * This struct indicates the status of an attribute during an atomic write.
+ *
+ * @see {@link MatterSpecification.v13.Core} § 7.15.5
+ */
+export const TlvAtomicAttributeStatus = TlvObject({
+    /**
+     * This field shall indicate the ID of the attribute with the associated StatusCode.
+     *
+     * @see {@link MatterSpecification.v13.Core} § 7.15.5.1
+     */
+    attributeId: TlvField(0, TlvAttributeId),
+
+    /**
+     * This field shall indicate the atomic status of an attribute.
+     *
+     * @see {@link MatterSpecification.v13.Core} § 7.15.5.2
+     */
+    statusCode: TlvField(1, TlvEnum<Status>())
+});
+
+/**
+ * This struct indicates the status of an attribute during an atomic write.
+ *
+ * @see {@link MatterSpecification.v13.Core} § 7.15.5
+ */
+export interface AtomicAttributeStatus extends TypeFromSchema<typeof TlvAtomicAttributeStatus> {}

package/src/globals/AtomicRequestType.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+/**
+ * @see {@link MatterSpecification.v13.Core} § 7.15.4
+ */
+export enum AtomicRequestType {
+    /**
+     * Begin an atomic write
+     */
+    BeginWrite = 0,
+
+    /**
+     * Commit an atomic write
+     */
+    CommitWrite = 1,
+
+    /**
+     * Rollback an atomic write, discarding any pending changes
+     */
+    RollbackWrite = 2
+}

package/src/globals/Locationdesc.ts

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { TlvField, TlvObject } from "../tlv/TlvObject.js";
+import { TlvString } from "../tlv/TlvString.js";
+import { TlvInt16, TlvUInt8 } from "../tlv/TlvNumber.js";
+import { TlvNullable } from "../tlv/TlvNullable.js";
+import { TypeFromSchema } from "../tlv/TlvSchema.js";
+
+/**
+ * Location Descriptor
+ *
+ * This data type shall be represented by the following structure:
+ *
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.45
+ */
+export const TlvLocationdesc = TlvObject({
+    /**
+     * This field shall indicate the name of the location. For example, "blue room".
+     *
+     * If the location name is not user provided, the logic that generates it (clients, devices etc.) SHOULD utilize
+     * synthesized user-friendly, understandable, names for the location, rather than opaque values such as "private"
+     * or "2fe7c241-a50a-4863-896e-c5878da5ed68".
+     *
+     * @see {@link MatterSpecification.v13.Core} § 7.19.2.45.1
+     */
+    locationName: TlvField(0, TlvString.bound({ maxLength: 128 })),
+
+    /**
+     * This field shall indicate the level number. Negative values correspond to basement levels.
+     *
+     * Value zero indicates this is the main floor, which typically includes the main entrance to the user’s home. For
+     * a building with multiple levels, it is the client’s responsibility to map each level to/from a FloorNumber tag
+     * value, using the level numbering convention of the region where the client operates. For example, if the client
+     * operates in Europe, building level 1, which is one level up from the street level, SHOULD be mapped to
+     * FloorNumber tag value 0x1. If the client operates in North America, building level 1, which is at street level,
+     * SHOULD be mapped to FloorNumber tag value 0x0.
+     *
+     * A null value indicates that this information is not available.
+     *
+     * When the clients present the level information for user selection, they SHOULD use the operating region to
+     * determine how to render and map this data. For example, if the client operates in North America it SHOULD
+     * present the user a list that includes entries labeled "basement", "first", "second", and internally mapped to
+     * floor numbers -1, 0, and 1. If operating in Europe, the client SHOULD present a list that includes entries
+     * labeled "basement", "ground", "first", internally mapped to floor numbers -1, 0, and 1.
+     *
+     * The floor number information is expected to be mostly useful to the clients, rather than the devices, such as
+     * for grouping devices that are located on the same level. For example, an automation may be defined for all
+     * devices located at the basement level (floor number -1).
+     *
+     * NOTE
+     *
+     * Handling complex level situations, such as half levels (side split houses), or the levels from an apartment
+     * building, is up to the client and/or user.
+     *
+     * @see {@link MatterSpecification.v13.Core} § 7.19.2.45.2
+     */
+    floorNumber: TlvField(1, TlvNullable(TlvInt16)),
+
+    /**
+     * This field shall be the ID of an area semantic tag, located within the Common Area Namespace. For example, this
+     * tag may indicate that the location refers to a bedroom.
+     *
+     * If this field is null, that indicates that the area type information is not available.
+     *
+     * NOTE
+     *
+     * This field only indicates the type of the area. Multiple areas of the same type, such as bedrooms, may exist in
+     * a user’s home.
+     *
+     * @see {@link MatterSpecification.v13.Core} § 7.19.2.45.3
+     */
+    areaType: TlvField(2, TlvNullable(TlvUInt8))
+});
+
+/**
+ * Location Descriptor
+ *
+ * This data type shall be represented by the following structure:
+ *
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.45
+ */
+export interface Locationdesc extends TypeFromSchema<typeof TlvLocationdesc> {}

package/src/globals/Priority.ts

@@ -13,7 +13,7 @@
  * particular ordering among the values. Specific uses of the data type may assign semantics to the values that imply
  * an ordering relationship.
  *
- * @see {@link MatterSpecification.v13.Core} § 7.18.2.17
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.17
  */
 export enum Priority {
     /**

package/src/globals/Semtag.ts

@@ -18,7 +18,7 @@ import { TypeFromSchema } from "../tlv/TlvSchema.js";
  *
  * This data type shall be represented by the following structure:
  *
- * @see {@link MatterSpecification.v13.Core} § 7.18.2.42
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.42
  */
 export const TlvSemtag = TlvObject({
     /**
@@ -32,7 +32,7 @@ export const TlvSemtag = TlvObject({
      *
      * If MfgCode is null, the NamespaceID field shall indicate a standard namespace.
      *
-     * @see {@link MatterSpecification.v13.Core} § 7.18.2.42.1
+     * @see {@link MatterSpecification.v13.Core} § 7.19.2.42.1
      */
     mfgCode: TlvField(0, TlvNullable(TlvVendorId)),
 
@@ -41,7 +41,7 @@ export const TlvSemtag = TlvObject({
      *
      * The common and device-specific semantic tag namespaces are listed in StandardNamespaces.
      *
-     * @see {@link MatterSpecification.v13.Core} § 7.18.2.42.2
+     * @see {@link MatterSpecification.v13.Core} § 7.19.2.42.2
      */
     namespaceId: TlvField(1, TlvUInt8),
 
@@ -51,7 +51,7 @@ export const TlvSemtag = TlvObject({
      * A device may expose tags from the common or device-specific namespaces and from manufacturer-specific namespaces
      * in a single TagList.
      *
-     * @see {@link MatterSpecification.v13.Core} § 7.18.2.42.3
+     * @see {@link MatterSpecification.v13.Core} § 7.19.2.42.3
      */
     tag: TlvField(2, TlvUInt8),
 
@@ -64,7 +64,7 @@ export const TlvSemtag = TlvObject({
      * "room" in a location namespace, would require the a label string to qualify the type of room, such as "1", "2b",
      * "Bathroom", etc.
      *
-     * @see {@link MatterSpecification.v13.Core} § 7.18.2.42.4
+     * @see {@link MatterSpecification.v13.Core} § 7.19.2.42.4
      */
     label: TlvOptionalField(3, TlvNullable(TlvString.bound({ maxLength: 64 })))
 })
@@ -74,6 +74,6 @@ export const TlvSemtag = TlvObject({
  *
  * This data type shall be represented by the following structure:
  *
- * @see {@link MatterSpecification.v13.Core} § 7.18.2.42
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.42
  */
 export interface Semtag extends TypeFromSchema<typeof TlvSemtag> {}

package/src/globals/SoftwareVersionCertificationStatus.ts

@@ -10,7 +10,7 @@
  * The values 0 through 2 shall correspond to the values 0 through 2 used in certification_type in the Certification
  * Declaration.
  *
- * @see {@link MatterSpecification.v13.Core} § 11.23.7.2
+ * @see {@link MatterSpecification.v13.Core} § 11.23.8.2
  */
 export enum SoftwareVersionCertificationStatus {
     /**

package/src/globals/Status.ts

@@ -22,7 +22,7 @@
  *
  * Status codes in an undefined range, or status codes undefined within a range are reserved and shall NOT be indicated.
  *
- * @see {@link MatterSpecification.v13.Core} § 7.18.2.18
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.18
  */
 export enum Status {
     /**
@@ -168,6 +168,13 @@ export enum Status {
      */
     Busy = 156,
 
+    /**
+     * The access to the action or command by the sender is permitted by the ACL but restricted by the ARL.
+     *
+     * @see {@link MatterSpecification.v13.Core} § 8.10.1
+     */
+    AccessRestricted = 157,
+
     /**
      * The cluster indicated is not supported on the endpoint.
      *
@@ -234,7 +241,17 @@ export enum Status {
     NoCommandResponse = 204,
 
     /**
-     * Matter 1.4, temporarily patched in manually.
+     * The node requires updated TC acceptance. The user MAY be directed to visit the EnhancedSetupFlowMaintenanceUrl
+     * to complete this.
+     *
+     * @see {@link MatterSpecification.v13.Core} § 8.10.1
+     */
+    TermsAndConditionsChanged = 205,
+
+    /**
+     * The node requires the user to visit the EnhancedSetupFlowMaintenanceUrl for instructions on further action.
+     *
+     * @see {@link MatterSpecification.v13.Core} § 8.10.1
      */
-    AccessRestricted = 0x9d,
+    MaintenanceRequired = 206
 }

package/src/globals/Tod.ts

@@ -15,7 +15,7 @@ import { TypeFromSchema } from "../tlv/TlvSchema.js";
  *
  * Represents time without a date component.
  *
- * @see {@link MatterSpecification.v13.Core} § 7.18.2.3
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.3
  */
 export const TlvTod = TlvObject({
     /**
@@ -44,6 +44,6 @@ export const TlvTod = TlvObject({
  *
  * Represents time without a date component.
  *
- * @see {@link MatterSpecification.v13.Core} § 7.18.2.3
+ * @see {@link MatterSpecification.v13.Core} § 7.19.2.3
  */
 export interface Tod extends TypeFromSchema<typeof TlvTod> {}

package/src/globals/index.ts

@@ -6,11 +6,14 @@
 
 /*** THIS FILE IS GENERATED, DO NOT EDIT ***/
 
+export * from "./AtomicAttributeStatus.js";
+export * from "./AtomicRequestType.js";
 export * from "./MeasurementAccuracyRange.js";
 export * from "./MeasurementAccuracy.js";
 export * from "./MeasurementType.js";
 export * from "./SoftwareVersionCertificationStatus.js";
 export * from "./WildcardPathFlags.js";
+export * from "./Locationdesc.js";
 export * from "./Priority.js";
 export * from "./Semtag.js";
 export * from "./Status.js";

package/src/schema/QrCodeSchema.ts

@@ -156,7 +156,7 @@ export class QrCodeSchema extends Schema<string, string> {
 
         //qrCode.forEach((line, x) => line.forEach((_v, y) => qrCode[x][y] = 1))
 
-        // Gererate the bit string
+        // Generate the bit string
         const bitString = bitStringBuilder.join("");
 
         // Xor the bits
@@ -181,7 +181,10 @@ export class QrCodeSchema extends Schema<string, string> {
                     if (y === 20 || qrCode[y + 1][x] === 1) {
                         result.push("▄");
                     } else {
-                        result.push(" ");
+                        result.push(
+                            // Use a braille blank rather than a space to ensure no wrapping/whitespace collapsing
+                            "\u2800",
+                        );
                     }
                 } else {
                     if (y === 20 || qrCode[y + 1][x] === 1) {
@@ -193,7 +196,9 @@ export class QrCodeSchema extends Schema<string, string> {
             }
             result.push("█\n");
         }
+
         result.push("▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀\n");
+
         return result.join("");
     }