@matter/model 0.13.1-alpha.0-20250508-047aa0277 → 0.13.1-alpha.0-20250511-74ef153aa

package/src/logic/definition-validation/ValueValidator.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import { ModelTraversal } from "#logic/ModelTraversal.js";
 import { Access, Aspect, Conformance, Constraint, Quality } from "../../aspects/index.js";
 import { DefinitionError, FieldValue, Metatype } from "../../common/index.js";
 import { ClusterModel, Globals, ValueModel } from "../../models/index.js";
@@ -23,7 +24,7 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
         this.validateProperty({ name: "quality", type: Quality });
         this.validateProperty({ name: "metatype", type: Metatype });
 
-        this.validateAspect("conformance");
+        this.#validateAspect("conformance");
         this.model.conformance.validateReferences(this, name => {
             // Features are all caps, other names are field references
             if (name.match(/^[A-Z0-9_$]+$/)) {
@@ -41,24 +42,24 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
             }
         });
 
-        this.validateAspect("constraint");
-        this.validateAspect("access");
-        this.validateAspect("quality");
+        this.#validateAspect("constraint");
+        this.#validateAspect("access");
+        this.#validateAspect("quality");
 
-        this.validateType();
-        this.validateEntries();
+        this.#validateType();
+        this.#validateEntries();
 
         super.validate();
     }
 
-    private validateAspect(name: string) {
+    #validateAspect(name: string) {
         const aspect = (this.model as any)[name] as Aspect;
         if (aspect?.errors) {
             aspect.errors.forEach((e: DefinitionError) => this.model.error(e.code, `${e.source}: ${e.message}`));
         }
     }
 
-    private validateType() {
+    #validateType() {
         if (this.model.effectiveType === undefined) {
             if (this.model.metatype) {
                 // Not a derivative type
@@ -70,9 +71,13 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
                 return;
             }
 
-            // Non-global types must specify a base type
-            this.error("NO_TYPE", "No type information");
-            return;
+            // If the type is supposed to have a shadow but we didn't find it due to a case mismatch, we correct that
+            // now.  Otherwise this is an error
+            if (!this.#correctCaseFromShadow()) {
+                // Non-global types must specify a base type
+                this.error("NO_TYPE", "No type information");
+                return;
+            }
         }
 
         const base = this.model.base;
@@ -99,7 +104,7 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
             return;
         }
 
-        if (this.validateSpecialDefault(metatype, defaultValue)) {
+        if (this.#validateSpecialDefault(metatype, defaultValue)) {
             return;
         }
 
@@ -159,7 +164,7 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
         this.model.default = defaultValue;
     }
 
-    private validateEntries() {
+    #validateEntries() {
         // Note - these checks only apply for first-order derived types, so use direct metatype
         const metatype =
             this.model.type === undefined
@@ -186,9 +191,9 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
                 }
 
                 if (metatype == Metatype.enum) {
-                    this.validateEnumKeys();
+                    this.#validateEnumKeys();
                 } else {
-                    this.validateBitFields();
+                    this.#validateBitFields();
                 }
                 break;
 
@@ -202,7 +207,7 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
         }
     }
 
-    private validateEnumKeys() {
+    #validateEnumKeys() {
         const ids = new Set<number>();
         const names = new Set<string>();
         for (const c of this.model.children) {
@@ -222,7 +227,7 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
         }
     }
 
-    private validateBitFields() {
+    #validateBitFields() {
         const ranges = Array<{ name: string; min: number; max: number }>();
         for (const c of this.model.children) {
             let min, max;
@@ -255,7 +260,7 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
         }
     }
 
-    private validateSpecialDefault(metatype: Metatype, def: any) {
+    #validateSpecialDefault(metatype: Metatype, def: any) {
         // Special "reference" object referencing another field by name
         if (typeof def === "object" && FieldValue.is(def, FieldValue.reference)) {
             const reference = (def as FieldValue.Reference).name;
@@ -299,4 +304,20 @@ export class ValueValidator<T extends ValueModel> extends ModelValidator<T> {
             return true;
         }
     }
+
+    #correctCaseFromShadow() {
+        const tag = this.model.tag;
+        const name = this.model.name.toLowerCase();
+        return (
+            false ===
+            new ModelTraversal().visitInheritance(this.model.parent?.base, owner => {
+                for (const child of owner.children) {
+                    if (child.tag === tag && child.name.toLowerCase() === name) {
+                        this.model.name = child.name;
+                        return false;
+                    }
+                }
+            })
+        );
+    }
 }

package/src/parser/Lexer.ts

@@ -16,7 +16,7 @@ function isNameChar(c: string) {
  *
  * Tokenizes simple text dialects.  Currently sufficient for Matter conformance and constraint tokenization.
  */
-export class Lexer<T extends BasicToken<KW>, const KW extends string[] = []> {
+export class Lexer<T extends BasicToken<KW>, const KW extends readonly string[] = []> {
     #keywords: Set<string>;
 
     constructor(keywords?: KW) {

package/src/parser/Token.ts

@@ -18,7 +18,7 @@ export interface Token {
 /**
  * The base token produced by the tokenizer.
  */
-export type BasicToken<KW extends string[] = []> =
+export type BasicToken<KW extends readonly string[] = []> =
     | BasicToken.Special
     | BasicToken.Word
     | BasicToken.Number
@@ -68,7 +68,7 @@ export namespace BasicToken {
         value: FieldValue;
     }
 
-    export interface Keyword<T extends string[]> extends Token {
+    export interface Keyword<T extends readonly string[]> extends Token {
         type: T[number];
     }
 }

package/src/standard/elements/AcceptedCommandList.ts

@@ -22,9 +22,8 @@ export const AcceptedCommandList = Attribute(
             "This attribute shall be a list of the command IDs for client generated commands that are supported " +
             "and processed by the server." +
             "\n" +
-            "For each client request command in this list that mandates a response from the server, the" +
-            "\n" +
-            "response command shall be indicated in the GeneratedCommandList attribute." +
+            "For each client request command in this list that mandates a response from the server, the response " +
+            "command shall be indicated in the GeneratedCommandList attribute." +
             "\n" +
             "If any attribute on a server supports atomic writes, this attribute shall contain the command ID for " +
             "AtomicRequest.",

package/src/standard/elements/AccessControl.ts

@@ -199,7 +199,7 @@ export const AccessControl = Cluster(
 
     Attribute(
         {
-            name: "CommissioningArL", id: 0x5, type: "list", access: "R V", conformance: "MNGD",
+            name: "CommissioningArl", id: 0x5, type: "list", access: "R V", conformance: "MNGD",
             constraint: "desc", default: [], quality: "F",
 
             details: "This attribute shall provide the set of CommissioningAccessRestrictionEntryStruct applied during " +
@@ -452,13 +452,11 @@ export const AccessControl = Cluster(
                     "\n" +
                     "  • The query shall use the & delimiter between key/value pairs." +
                     "\n" +
-                    "  • The key-value pairs shall in the format name=<value> where name is the key name, and <value>" +
+                    "  • The key-value pairs shall in the format name=<value> where name is the key name, and <value> is " +
+                    "    the contents of the value encoded with proper URL-encoded escaping." +
                     "\n" +
-                    "is the contents of the value encoded with proper URL-encoded escaping." +
-                    "\n" +
-                    "  • If key MTcu is present, it shall have a value of \"_\" (i.e. MTcu=_). This is the \"callback URL" +
-                    "\n" +
-                    "backUrl) placeholder\"." +
+                    "  • If key MTcu is present, it shall have a value of \"_\" (i.e. MTcu=_). This is the \"callback URL " +
+                    "    (CallbackUrl) placeholder\"." +
                     "\n" +
                     "  • Any key whose name begins with MT not mentioned in the previous bullets shall be reserved for " +
                     "    future use by this specification. Manufacturers shall NOT include query keys starting with MT in " +
@@ -467,8 +465,6 @@ export const AccessControl = Cluster(
                     "Any other element in the ARLRequestFlowUrl query field not covered by the above rules, as well as " +
                     "the fragment field (if present), shall remain including the order of query key/value pairs present." +
                     "\n" +
-                    "Expansion of ARLRequestFlowUrl by client" +
-                    "\n" +
                     "Once the URL is obtained, it shall be expanded to form a final URL (ExpandedARLRequestFlowUrl) by " +
                     "proceeding with the following substitution algorithm on the original ARLRequestFlowUrl:" +
                     "\n" +
@@ -491,9 +487,8 @@ export const AccessControl = Cluster(
                     "\n" +
                     "  • The query shall use the & delimiter between key/value pairs." +
                     "\n" +
-                    "  • The key-value pairs shall follow the format name=<value> where name is the key name, and" +
-                    "\n" +
-                    "<value> is the contents of the value encoded with proper URL-encoded escaping." +
+                    "  • The key-value pairs shall follow the format name=<value> where name is the key name, and <value> " +
+                    "    is the contents of the value encoded with proper URL-encoded escaping." +
                     "\n" +
                     "  • If key MTaer is present, it shall have a value of \"_\" (i.e. MTaer=_). This is the placeholder " +
                     "    for a \"access extension response\" provided by the manufacturer flow to the client. The " +
@@ -504,14 +499,10 @@ export const AccessControl = Cluster(
                     "  • Any key whose name begins with MT not mentioned in the previous bullets shall be reserved for " +
                     "    future use by this specification." +
                     "\n" +
-                    "Any other element in the CallbackUrl query field not covered by the above rules, as well as the frag" +
-                    "\n" +
-                    "ment field (if present), shall remain as provided by the client through embedding within the" +
-                    "\n" +
+                    "Any other element in the CallbackUrl query field not covered by the above rules, as well as the " +
+                    "fragment field (if present), shall remain as provided by the client through embedding within the " +
                     "ExpandedARLRequestFlowUrl, including the order of query key/value pairs present." +
                     "\n" +
-                    "### Expansion of CallbackUrl by the manufacturer custom flow" +
-                    "\n" +
                     "Once the CallbackUrl is obtained by the manufacturer flow, it may be expanded to form a final " +
                     "ExpandedARLRequestCallbackUrl URL to be used by proceeding with the following substitution algorithm " +
                     "on the provided CallbackUrl:" +
@@ -538,7 +529,7 @@ export const AccessControl = Cluster(
                     "ExpandedARLRequestCallbackUrl, on completion of the request, if an ExpandedARLRequestCallbackUrl was " +
                     "computed from the CallbackUrl and opening such a URL is supported." +
                     "\n" +
-                    "Examples of ARLRequestFlowUrl URLs" +
+                    "### Examples of ARLRequestFlowUrl URLs" +
                     "\n" +
                     "Below are some examples of valid ExpandedARLRequestFlowUrl for several valid values of " +
                     "ARLRequestFlowUrl, as well as some examples of invalid values of ARLRequestFlowUrl:" +
@@ -557,10 +548,9 @@ export const AccessControl = Cluster(
                     "\n" +
                     "https://company.domain.example/matter/arl?vid=FFF1&pid=1234&MTcu=_" +
                     "\n" +
-                    "  ◦ After expansion:" +
-                    "\n" +
-                    "https://company.domain.example/matter/arl?vid=FFF1&pid=1234&MTcu=https%3A%2F%2Fc " +
-                    "lient.domain.example%2Fcb%3Ftoken%3DmAsJ6_vqbr-vjDiG_w%253D%253D%26MTaer%3D_" +
+                    "  ◦ After expansion: " +
+                    "    https://company.domain.example/matter/arl?vid=FFF1&pid=1234&MTcu=https%3A%2F%2Fc " +
+                    "    lient.domain.example%2Fcb%3Ftoken%3DmAsJ6_vqbr-vjDiG_w%253D%253D%26MTaer%3D_" +
                     "\n" +
                     "  ◦ The ExpandedARLRequestFlowUrl URL contains:" +
                     "\n" +
@@ -572,7 +562,7 @@ export const AccessControl = Cluster(
                     "      return access extension completion status of Success, the ExpandedARLRequestCallbackUrl would " +
                     "      be:" +
                     "\n" +
-                    "https://client.domain.example/cb?token=mAsJ6_vqbr- vjDiG_w%3D%3D&MTaer=Success" +
+                    "https://client.domain.example/cb?token=mAsJ6_vqbr-vjDiG_w%3D%3D&MTaer=Success" +
                     "\n" +
                     "Note that the MTcu key/value pair was initially provided URL-encoded within the " +
                     "ExpandedARLRequestFlowUrl URL and the MTaer=_ key/value pair placeholder now contains a substituted " +
@@ -652,9 +642,9 @@ export const AccessControl = Cluster(
     Datatype(
         {
             name: "AccessControlEntryPrivilegeEnum", type: "enum8",
-            details: "Proxy View Value" +
+            details: "### Proxy View Value" +
                 "\n" +
-                "This value implicitly grants View privileges",
+                "### This value implicitly grants View privileges",
             xref: { document: "core", section: "9.10.5.2" }
         },
 
@@ -670,7 +660,7 @@ export const AccessControl = Cluster(
         Field({
             name: "Operate", id: 0x3, conformance: "M",
             description: "View privileges, and can perform the primary function of this Node (except Access Control Cluster)",
-            details: "This value implicitly grants View privileges",
+            details: "### This value implicitly grants View privileges",
             xref: { document: "core", section: "9.10.5.2.1" }
         }),
 
@@ -730,8 +720,6 @@ export const AccessControl = Cluster(
             name: "Privilege", id: 0x1, type: "AccessControlEntryPrivilegeEnum", access: "S", conformance: "M",
 
             details: "The privilege field shall specify the level of privilege granted by this Access Control Entry." +
-                "\n" +
-                "NOTE The Proxy View privilege is provisional." +
                 "\n" +
                 "Each privilege builds upon its predecessor, expanding the set of actions that can be performed upon " +
                 "a Node. Administer is the highest privilege, and is special as it pertains to the administration of " +
@@ -741,8 +729,6 @@ export const AccessControl = Cluster(
                 "privilege levels as well. The following diagram illustrates how the higher privilege levels subsume " +
                 "the lower privilege levels:" +
                 "\n" +
-                "Figure 46. Access Control Privilege Levels" +
-                "\n" +
                 "Individual clusters shall define whether attributes are readable, writable, or both readable and " +
                 "writable. Clusters also shall define which privilege is minimally required to be able to perform a " +
                 "particular read or write action on those attributes, or invoke particular commands. Device type " +
@@ -777,8 +763,6 @@ export const AccessControl = Cluster(
                     "\n" +
                     "### Subject ID shall be of type uint64 with semantics depending on the entry’s AuthMode as follows:" +
                     "\n" +
-                    "Subject Semantics" +
-                    "\n" +
                     "An empty subjects list indicates a wildcard; that is, this entry shall grant access to any Node that " +
                     "successfully authenticates via AuthMode. The subjects list shall NOT be empty if the entry’s " +
                     "AuthMode is PASE." +
@@ -825,8 +809,6 @@ export const AccessControl = Cluster(
                     "\n" +
                     "A target grants access based on the presence of fields as follows:" +
                     "\n" +
-                    "Target Semantics" +
-                    "\n" +
                     "An empty targets list indicates a wildcard: that is, this entry shall grant access to all cluster " +
                     "instances on all endpoints on this Node.",
 
@@ -845,8 +827,7 @@ export const AccessControl = Cluster(
         Field({
             name: "Data", id: 0x1, type: "octstr", access: "S", conformance: "M", constraint: "max 128",
 
-            details: "This field may be used by manufacturers to store arbitrary TLV-encoded data related to a fabric’s" +
-                "\n" +
+            details: "This field may be used by manufacturers to store arbitrary TLV-encoded data related to a fabric’s " +
                 "Access Control Entries." +
                 "\n" +
                 "The contents shall consist of a top-level anonymous list; each list element shall include a " +

package/src/standard/elements/AccountLogin.ts

@@ -40,10 +40,9 @@ export const AccountLogin = Cluster(
             "The cluster server for this cluster may be supported on each endpoint that represents a Content App " +
             "on a Video Player device." +
             "\n" +
-            "See Device Type Library document for details of how a Content App, represented as an endpoint on" +
-            "\n" +
-            "the Video Player device, may implement the cluster server for this cluster to simplify account login " +
-            "for its users.",
+            "See Device Type Library document for details of how a Content App, represented as an endpoint on the " +
+            "Video Player device, may implement the cluster server for this cluster to simplify account login for " +
+            "its users.",
 
         xref: { document: "cluster", section: "6.2" }
     },
@@ -78,10 +77,9 @@ export const AccountLogin = Cluster(
                 "\n" +
                 "For example, a Video Player with a Content App Platform may invoke this command on one of its " +
                 "Content App endpoints to facilitate commissioning of a Phone App made by the same vendor as the " +
-                "Content App. If the accounts match, then the Content App may return a setup code that can be used" +
-                "\n" +
-                "by the Video Player to commission the Phone App without requiring the user to physically input a " +
-                "setup code." +
+                "Content App. If the accounts match, then the Content App may return a setup code that can be used by " +
+                "the Video Player to commission the Phone App without requiring the user to physically input a setup " +
+                "code." +
                 "\n" +
                 "The account match is determined by the Content App using a method which is outside the scope of this " +
                 "specification and will typically involve a central service which is in communication with both the " +
@@ -145,10 +143,10 @@ export const AccountLogin = Cluster(
             details: "This field shall provide the setup PIN code as a text string at least 8 characters in length or " +
                 "empty string to indicate that the accounts do not match." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "Newer cluster clients should be aware that AccountLogin cluster version 1 specified an 11 digit " +
-                "minimum length.",
+                "> Newer cluster clients should be aware that AccountLogin cluster version 1 specified an 11 digit " +
+                "  minimum length.",
 
             xref: { document: "cluster", section: "6.2.4.2.1" }
         })
@@ -212,10 +210,10 @@ export const AccountLogin = Cluster(
 
             details: "This field shall provide the setup PIN code as a text string at least 8 characters in length." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "Newer cluster clients should be aware that AccountLogin cluster version 1 specified an 11 digit " +
-                "minimum length.",
+                "> Newer cluster clients should be aware that AccountLogin cluster version 1 specified an 11 digit " +
+                "  minimum length.",
 
             xref: { document: "cluster", section: "6.2.4.3.2" }
         }),
@@ -239,8 +237,7 @@ export const AccountLogin = Cluster(
 
         Field({
             name: "Node", id: 0x0, type: "node-id", conformance: "O",
-            details: "This optional field shall provide the Node ID of the Client. This field can be used by the Content" +
-                "\n" +
+            details: "This optional field shall provide the Node ID of the Client. This field can be used by the Content " +
                 "App to keep track of Nodes which currently have access to it.",
             xref: { document: "cluster", section: "6.2.4.4.1" }
         })

package/src/standard/elements/Actions.ts

@@ -505,9 +505,7 @@ export const Actions = Cluster(
                 "InstantActionWithTransition), or to bring these endpoints into a more dynamic state (typically using " +
                 "StartAction), where the endpoints would e.g. gradually cycle through certain colors for a pleasing " +
                 "effect. A voice controller could use \"set\" (to map to InstantAction) or \"play\" (to map to " +
-                "StartAction) to trig" +
-                "\n" +
-                "ger such actions." +
+                "StartAction) to trigger such actions." +
                 "\n" +
                 "Example: see examples 1 and 2.",
 
@@ -619,13 +617,11 @@ export const Actions = Cluster(
             description: "User-configured group of endpoints where an endpoint can be in any number of zones",
 
             details: "Is a more general concept where an endpoint can be part of multiple zones, e.g. a light in the " +
-                "living" +
-                "\n" +
-                "room can be part of the \"reading corner\" zone (subset of the lights in the living room) but also " +
-                "part of the \"downstairs\" zone which contains all the lights on a floor, e.g. combining living room, " +
-                "kitchen and hallway. This indicates that a user has defined this list of endpoints as something they " +
-                "logically would like to control as a group, so Matter controllers could provide the user with a way " +
-                "to do as such.",
+                "living room can be part of the \"reading corner\" zone (subset of the lights in the living room) but " +
+                "also part of the \"downstairs\" zone which contains all the lights on a floor, e.g. combining living " +
+                "room, kitchen and hallway. This indicates that a user has defined this list of endpoints as " +
+                "something they logically would like to control as a group, so Matter controllers could provide the " +
+                "user with a way to do as such.",
 
             xref: { document: "core", section: "9.14.4.5.3" }
         })

package/src/standard/elements/AdministratorCommissioning.ts

@@ -62,11 +62,11 @@ export const AdministratorCommissioning = Cluster(
             "\n" +
             "This attribute shall revert to WindowNotOpen upon expiry of a commissioning window." +
             "\n" +
-            "NOTE" +
+            "> [!NOTE]" +
             "\n" +
-            "An initial commissioning window is not opened using either the OpenCommissioningWindow command or " +
-            "the OpenBasicCommissioningWindow command, and therefore this attribute shall be set to WindowNotOpen " +
-            "on initial commissioning.",
+            "> An initial commissioning window is not opened using either the OpenCommissioningWindow command or " +
+            "  the OpenBasicCommissioningWindow command, and therefore this attribute shall be set to " +
+            "  WindowNotOpen on initial commissioning.",
 
         xref: { document: "core", section: "11.19.7.1" }
     }),
@@ -114,9 +114,8 @@ export const AdministratorCommissioning = Cluster(
                 "\n" +
                 "When the OpenCommissioningWindow command expires or commissioning completes, the Node shall remove " +
                 "the Passcode by deleting the PAKE passcode verifier as well as stop publishing the DNS-SD record " +
-                "corresponding to this command as described in Section 4.3.1, “Commissionable" +
-                "\n" +
-                "Node Discovery”. The commissioning into a new Fabric completes when the Node successfully receives a " +
+                "corresponding to this command as described in Section 4.3.1, “Commissionable Node Discovery”. The " +
+                "commissioning into a new Fabric completes when the Node successfully receives a " +
                 "CommissioningComplete command, see Section 5.5, “Commissioning Flows”." +
                 "\n" +
                 "The parameters for OpenCommissioningWindow command are as follows:" +
@@ -155,13 +154,13 @@ export const AdministratorCommissioning = Cluster(
         Field({
             name: "PakePasscodeVerifier", id: 0x1, type: "octstr", conformance: "M", constraint: "97",
 
-            details: "This field shall specify an ephemeral PAKE passcode verifier (see Section 3.10, " +
-                "“Password-Authenticated Key Exchange (PAKE)”) computed by the existing Administrator to be used for " +
-                "this commissioning. The field is concatenation of two values (w0 || L) shall be " +
-                "(CRYPTO_GROUP_SIZE_BYTES + CRYPTO_PUBLIC_KEY_SIZE_BYTES)-octets long as detailed in " +
-                "Crypto_PAKEValues_Responder. It shall be derived from an ephemeral passcode (See PAKE). It shall be " +
-                "deleted by the Node at the end of commissioning or expiration of the OpenCommissioningWindow " +
-                "command, and shall be deleted by the existing Administrator after sending it to the Node(s).",
+            details: "This field shall specify an ephemeral PAKE passcode verifier (see Section 3.10, “Password- " +
+                "Authenticated Key Exchange (PAKE)”) computed by the existing Administrator to be used for this " +
+                "commissioning. The field is concatenation of two values (w0 || L) shall be (CRYPTO_GROUP_SIZE_BYTES " +
+                "+ CRYPTO_PUBLIC_KEY_SIZE_BYTES)-octets long as detailed in Crypto_PAKEValues_Responder. It shall be " +
+                "derived from an ephemeral passcode (See PAKE). It shall be deleted by the Node at the end of " +
+                "commissioning or expiration of the OpenCommissioningWindow command, and shall be deleted by the " +
+                "existing Administrator after sending it to the Node(s).",
 
             xref: { document: "core", section: "11.19.8.1.2" }
         }),
@@ -268,9 +267,8 @@ export const AdministratorCommissioning = Cluster(
             "specific status code of WindowNotOpen." +
             "\n" +
             "If the commissioning window was open and the fail-safe was armed when this command is received, the " +
-            "device shall immediately expire the fail-safe and perform the cleanup steps outlined" +
-            "\n" +
-            "in Section 11.10.7.2.2, “Behavior on expiry of Fail-Safe timer”.",
+            "device shall immediately expire the fail-safe and perform the cleanup steps outlined in Section " +
+            "11.10.7.2.2, “Behavior on expiry of Fail-Safe timer”.",
 
         xref: { document: "core", section: "11.19.8.3" }
     }),

package/src/standard/elements/ApplicationLauncher.ts

@@ -104,12 +104,12 @@ export const ApplicationLauncher = Cluster(
 
             details: "This field shall specify optional app-specific data to be sent to the app." +
                 "\n" +
-                "NOTE" +
+                "> [!NOTE]" +
                 "\n" +
-                "This format and meaning of this value is proprietary and outside the specification. It provides a " +
-                "transition path for device makers that use other protocols (like DIAL) which allow for proprietary " +
-                "data. Apps that are not yet Matter aware can be launched via Matter, while retaining the existing " +
-                "ability to launch with proprietary data.",
+                "> This format and meaning of this value is proprietary and outside the specification. It provides a " +
+                "  transition path for device makers that use other protocols (like DIAL) which allow for proprietary " +
+                "  data. Apps that are not yet Matter aware can be launched via Matter, while retaining the existing " +
+                "  ability to launch with proprietary data.",
 
             xref: { document: "cluster", section: "6.4.7.1.2" }
         })
@@ -158,9 +158,7 @@ export const ApplicationLauncher = Cluster(
                 "constraints if any. The Status attribute shall be updated to ActiveHidden or Stopped, depending on " +
                 "the action taken, on the Application Basic cluster of the Endpoint corresponding to the application " +
                 "on which the action was taken. The Status attribute shall be updated on any other application whose " +
-                "Status may have changed as a result of this command." +
-                "\n" +
-                "This command returns a Launcher Response.",
+                "Status may have changed as a result of this command. This command returns a Launcher Response.",
 
             xref: { document: "cluster", section: "6.4.7.3" }
         },

package/src/standard/elements/BallastConfiguration.ts

@@ -17,12 +17,9 @@ import {
 export const BallastConfiguration = Cluster(
     {
         name: "BallastConfiguration", id: 0x301, classification: "application", pics: "BC",
-        details: "This cluster is used for configuring a lighting ballast." +
-            "\n" +
-            "NOTE Support for Ballast Configuration cluster is provisional.",
+        details: "This cluster is used for configuring a lighting ballast.",
         xref: { document: "cluster", section: "3.3" }
     },
-
     Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 4 }),
 
     Attribute({
@@ -75,11 +72,10 @@ export const BallastConfiguration = Cluster(
             "(see Dimming Curve) when the Level Control Cluster’s CurrentLevel attribute equals to 254 (and the " +
             "On/Off Cluster’s OnOff attribute equals to TRUE)." +
             "\n" +
-            "The value of this attribute shall be both less than or equal to PhysicalMaxLevel and greater than" +
-            "\n" +
-            "or equal to MinLevel. If an attempt is made to set this attribute to a level where these conditions " +
-            "are not met, a response shall be returned with status code set to CONSTRAINT_ERROR, and the level " +
-            "shall NOT be set.",
+            "The value of this attribute shall be both less than or equal to PhysicalMaxLevel and greater than or " +
+            "equal to MinLevel. If an attempt is made to set this attribute to a level where these conditions are " +
+            "not met, a response shall be returned with status code set to CONSTRAINT_ERROR, and the level shall " +
+            "NOT be set.",
 
         xref: { document: "cluster", section: "3.3.6.5" }
     }),
@@ -106,7 +102,7 @@ export const BallastConfiguration = Cluster(
                 "configured light output of the lamps. A typical use for this attribute is to compensate for " +
                 "reduction in efficiency over the lifetime of a lamp." +
                 "\n" +
-                "The light output is given by" +
+                "### The light output is given by" +
                 "\n" +
                 "actual light output = configured light output x BallastFactorAdjustment / 100%" +
                 "\n" +
@@ -169,9 +165,7 @@ export const BallastConfiguration = Cluster(
         name: "LampAlarmMode", id: 0x34, type: "LampAlarmModeBitmap", access: "RW VM", conformance: "O",
         default: 0,
         details: "This attribute shall specify which attributes may cause an alarm notification to be generated. Ain " +
-            "each bit position means that its associated attribute is able to generate an alarm." +
-            "\n" +
-            "NOTE All alarms are also logged in the alarm table – see Alarms cluster.",
+            "each bit position means that its associated attribute is able to generate an alarm.",
         xref: { document: "cluster", section: "3.3.6.13" }
     }),