@matter/model 0.16.0-alpha.0-20251004-92135c7df → 0.16.0-alpha.0-20251006-3fe1e7c57

package/dist/esm/models/ValueModel.js

@@ -56,6 +56,9 @@ class ValueModel extends Model {
   get fields() {
     return Scope(this).membersOf(this, { tags: [ElementTag.Field] });
   }
+  get conformant() {
+    return new ValueModel.Conformant(this);
+  }
   /**
    * Metatype is only present on global types with specific semantic meaning. This model is significant because it
    * gives us information about how to manipulate the data.  This accessor retrieves this model.
@@ -243,6 +246,30 @@ class ValueModel extends Model {
     });
   }
 }
+((ValueModel2) => {
+  class Conformant {
+    #model;
+    constructor(model) {
+      this.#model = model;
+    }
+    /**
+     * The model's conformant fields.
+     */
+    get fields() {
+      return Scope(this.#model).membersOf(this.#model, {
+        tags: [ElementTag.Field],
+        conformance: "conformant"
+      });
+    }
+    /**
+     * An alias for {@link fields} that offers compatibility with the same field for clusters.
+     */
+    get properties() {
+      return this.fields;
+    }
+  }
+  ValueModel2.Conformant = Conformant;
+})(ValueModel || (ValueModel = {}));
 export {
   ValueModel
 };

package/dist/esm/models/ValueModel.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/models/ValueModel.ts"],
-  "mappings": "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",
-  "names": []
+  "mappings": "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",
+  "names": ["ValueModel"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/model",
-    "version": "0.16.0-alpha.0-20251004-92135c7df",
+    "version": "0.16.0-alpha.0-20251006-3fe1e7c57",
     "description": "Matter data model",
     "keywords": [
         "iot",
@@ -31,11 +31,11 @@
         "embed-examples": "embedme **/README.md"
     },
     "dependencies": {
-        "@matter/general": "0.16.0-alpha.0-20251004-92135c7df"
+        "@matter/general": "0.16.0-alpha.0-20251006-3fe1e7c57"
     },
     "devDependencies": {
-        "@matter/testing": "0.16.0-alpha.0-20251004-92135c7df",
-        "@matter/tools": "0.16.0-alpha.0-20251004-92135c7df"
+        "@matter/testing": "0.16.0-alpha.0-20251006-3fe1e7c57",
+        "@matter/tools": "0.16.0-alpha.0-20251006-3fe1e7c57"
     },
     "files": [
         "dist/**/*",

package/src/elements/DatatypeElement.ts

@@ -43,9 +43,8 @@ export namespace DatatypeElement {
     /**
      * Convert a TypeScript enum to Matter enum values.
      *
-     * Matter enums include conformance and other metadata.  They may also have
-     * multiple definitions of the same value selectable by conformance.  So
-     * we can't use a TypeScript enum directly.
+     * Matter enums include conformance and other metadata.  They may also have multiple definitions of the same value
+     * selectable by conformance.  So we can't use a TypeScript enum directly.
      */
     export function ListValues(values: ValueMap): ListValues {
         const result = Array<FieldElement>();
@@ -67,16 +66,14 @@ export namespace DatatypeElement {
     }
 
     /**
-     * We express enum values as IntElements as this gives us conformance
-     * and other metadata.
+     * We express enum values as IntElements as this gives us conformance and other metadata.
      */
     export type ListValues = FieldElement[];
 
     /**
-     * Per the Matter specification, enums are named integers.  The following
-     * allows TypeScript enums to be supplied for translation into Matter
-     * enums.  To do so, we must accept both numeric and string values.  For
-     * generating the Matter enum we ignore the string keys.
+     * Per the Matter specification, enums are named integers.  The following allows TypeScript enums to be supplied for
+     * translation into Matter enums.  To do so, we must accept both numeric and string values.  For generating the
+     * Matter enum we ignore the string keys.
      */
     export type ValueMap = { [name: string]: number | string };
 }

package/src/logic/ModelIndex.ts

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { camelize } from "#general";
+import { Model } from "../models/Model.js";
+
+/**
+ * An read-only array of models with support for efficient lookup by name and ID.
+ *
+ * Name search uses canonical camel case, so "FooBar", "fooBar" and "foo-bar" are considered equivalent.
+ */
+export interface ModelIndex<T extends Model = Model> extends ReadonlyArray<T> {
+    /**
+     * Retrieve a model for the given ID or name.
+     *
+     * Use the two-parameter version for indices that contain multiple model types.
+     */
+    for(key: number | string): T | undefined;
+
+    /**
+     * Retrieve a model of the specific type for the given ID or name.
+     *
+     * Name search uses canonical camel case.
+     */
+    for<M extends T>(key: number | string, type: Model.Type<M>): M | undefined;
+
+    /**
+     * Filter to a specific model subtype.
+     */
+    ofType<M extends T>(type: Model.Type<M>): M[];
+}
+
+/**
+ * Implementation of {@link ModelIndex} used for initial creation.
+ */
+export class MutableModelIndex<T extends Model = Model> extends Array<T> implements ModelIndex {
+    #nameIndex?: Map<string, T | T[]>;
+    #idIndex?: Map<number, T | T[]>;
+
+    for(key: number | string): T;
+    for<M extends T>(key: number | string, type: Model.Type<M>): M;
+
+    for(key: number | string, type?: Model.Type): Model | undefined {
+        let untyped: undefined | Model | Model[];
+
+        if (typeof key === "number") {
+            untyped = this.#ids.get(key);
+        } else {
+            untyped = this.#names.get(camelize(key));
+        }
+
+        if (untyped === undefined) {
+            return undefined;
+        }
+
+        if (Array.isArray(untyped)) {
+            if (type) {
+                return untyped.find(m => m instanceof type);
+            }
+            return untyped[0];
+        }
+
+        if (type && !(untyped instanceof type)) {
+            return undefined;
+        }
+
+        return untyped;
+    }
+
+    ofType<T extends Model.Type>(type: T): InstanceType<T>[] {
+        return this.filter(m => m instanceof type) as InstanceType<T>[];
+    }
+
+    get #ids() {
+        if (this.#idIndex) {
+            return this.#idIndex;
+        }
+
+        const index = (this.#idIndex = new Map<number, T | T[]>());
+        for (const model of this) {
+            if (model.id === undefined) {
+                continue;
+            }
+
+            const already = index.get(model.id);
+            if (already) {
+                if (Array.isArray(already)) {
+                    already.push(model);
+                } else {
+                    index.set(model.id, [already, model]);
+                }
+            } else {
+                index.set(model.id, model);
+            }
+        }
+
+        return this.#idIndex;
+    }
+
+    get #names() {
+        if (this.#nameIndex) {
+            return this.#nameIndex;
+        }
+
+        const index = (this.#nameIndex = new Map<string, T | T[]>());
+        for (const model of this) {
+            const name = camelize(model.name);
+            const already = index.get(name);
+            if (already) {
+                if (Array.isArray(already)) {
+                    already.push(model);
+                } else {
+                    index.set(name, [already, model]);
+                }
+            } else {
+                index.set(name, model);
+            }
+        }
+
+        return this.#nameIndex;
+    }
+}

package/src/logic/Scope.ts

@@ -12,6 +12,7 @@ import { ModelTraversal } from "./ModelTraversal.js";
 
 // These must be types to avoid circular references
 import type { ClusterModel, Model, ScopeModel, ValueModel } from "#models/index.js";
+import { ModelIndex, MutableModelIndex } from "./ModelIndex.js";
 
 const DEFAULT_TAGS = new Set([ElementTag.Field, ElementTag.Attribute]);
 const GLOBAL_IDS = new Set([0xfffd, 0xfffc, 0xfffb, 0xfffa, 0xfff9, 0xfff8]);
@@ -61,7 +62,7 @@ export interface Scope {
     /**
      * Identify members (child properties) of the designated model in this scope.
      */
-    membersOf<T extends Model>(parent: T, options?: Scope.MemberOptions): Model.ChildOf<T>[];
+    membersOf<T extends Model>(parent: T, options?: Scope.MemberOptions): ModelIndex<Model.ChildOf<T>>;
 }
 
 /**
@@ -156,11 +157,14 @@ export function Scope(subject: Model, options: Scope.ScopeOptions = {}) {
         const allMembers = findAllMembers(parent, tags, result);
 
         if (parent.tag === ElementTag.Cluster && tags.has(ElementTag.Attribute)) {
-            injectGlobalAttributes(owner, allMembers);
+            injectGlobalAttributes(
+                owner as ClusterModel,
+                allMembers as unknown as MutableModelIndex<ClusterModel.Child>,
+            );
         }
 
         if (!conformanceMode || conformanceMode === "ignore") {
-            return allMembers as Model.ChildOf<T>[];
+            return allMembers;
         }
 
         const conformantOnly = conformanceMode === "conformant";
@@ -177,7 +181,7 @@ export function Scope(subject: Model, options: Scope.ScopeOptions = {}) {
             supportedFeatures,
             conformantOnly,
             conformantOnly ? deconflictedMemberCache : conformantMemberCache,
-        ) as Model.ChildOf<T>[];
+        );
     }
 
     if (useCache) {
@@ -248,8 +252,8 @@ export namespace Scope {
 /**
  * Selects all candidate members for a model.
  */
-function findAllMembers(parent: Model, tags: Set<ElementTag>, scope: Scope) {
-    const members = Array<Model>();
+function findAllMembers<T extends Model>(parent: T, tags: Set<ElementTag>, scope: Scope) {
+    const members = new MutableModelIndex<Model.ChildOf<T>>();
 
     // This is a map of identity (based on tag + id/name + discriminator) to a priority based on inheritance depth
     const defined = {} as Record<string, number | undefined>;
@@ -288,7 +292,7 @@ function findAllMembers(parent: Model, tags: Set<ElementTag>, scope: Scope) {
             defined[nameIdentity] = level;
 
             // Found a member
-            members.push(child);
+            members.push(child as Model.ChildOf<T>);
         }
     };
     traversal.visitInheritance(parent, childSearchVisitor);
@@ -300,7 +304,7 @@ function findAllMembers(parent: Model, tags: Set<ElementTag>, scope: Scope) {
  * We consider the standard set of "global" attributes members of all clusters.  This injects those members that are
  * not otherwise defined in the cluster.
  */
-function injectGlobalAttributes(scope: Model, members: Model[]) {
+function injectGlobalAttributes(scope: ClusterModel, members: ClusterModel.Child[]) {
     const missingGlobalIds = new Set(GLOBAL_IDS);
     for (const m of members) {
         if (m.tag === ElementTag.Attribute && m.id) {
@@ -342,8 +346,8 @@ function injectGlobalAttributes(scope: Model, members: Model[]) {
  * Note 2 - members may not be differentiated with conformance rules that rely on field values in this way. That will
  * probably never be necessary and would require an entirely different (more complicated) structure.
  */
-function filterWithConformance(
-    parent: Model,
+function filterWithConformance<T extends Model>(
+    parent: T,
     tags: Set<ElementTag>,
     members: Model[],
     features: FeatureSet,
@@ -352,7 +356,7 @@ function filterWithConformance(
     cache?: Map<Model, Map<ElementTag, Set<Model>>>,
 ) {
     const tagsToCollect = new Set<ElementTag>(tags);
-    const result = Array<Model>();
+    const result = new MutableModelIndex<Model.ChildOf<T>>();
     const cached = cache ? (cache.get(parent) ?? new Map()) : undefined;
 
     if (cache && cached) {
@@ -415,7 +419,7 @@ function filterWithConformance(
     }
 
     for (const tag in selectedMembers) {
-        const tagResult = Object.values(selectedMembers[tag]);
+        const tagResult = Object.values(selectedMembers[tag]) as Model.ChildOf<T>[];
         if (tagResult.length) {
             result.push(...tagResult);
             if (cached) {

package/src/logic/index.ts

@@ -13,6 +13,7 @@ export * from "./ClusterVariance.js";
 export * from "./DefaultValue.js";
 export * from "./MergedModel.js";
 export * from "./ModelDiff.js";
+export * from "./ModelIndex.js";
 export * from "./ModelVariantTraversal.js";
 export * from "./Scope.js";
 export * from "./ValidateModel.js";

package/src/models/ClusterModel.ts

@@ -5,6 +5,7 @@
  */
 
 import { camelize, describeList } from "#general";
+import { ModelIndex } from "#logic/ModelIndex.js";
 import { ModelTraversal } from "#logic/ModelTraversal.js";
 import { Access } from "../aspects/Access.js";
 import { Quality } from "../aspects/Quality.js";
@@ -40,19 +41,23 @@ export class ClusterModel extends ScopeModel<ClusterElement, ClusterModel.Child>
     }
 
     get attributes() {
-        return this.scope.membersOf(this, { tags: [ElementTag.Attribute] }) as AttributeModel[];
+        return this.scope.membersOf(this, { tags: [ElementTag.Attribute] }) as ModelIndex<AttributeModel>;
     }
 
     get commands() {
-        return this.scope.membersOf(this, { tags: [ElementTag.Command] }) as CommandModel[];
+        return this.scope.membersOf(this, { tags: [ElementTag.Command] }) as ModelIndex<CommandModel>;
     }
 
     get events() {
-        return this.scope.membersOf(this, { tags: [ElementTag.Event] }) as EventModel[];
+        return this.scope.membersOf(this, { tags: [ElementTag.Event] }) as ModelIndex<EventModel>;
     }
 
     get datatypes() {
-        return this.scope.membersOf(this, { tags: [ElementTag.Datatype] }) as DatatypeModel[];
+        return this.scope.membersOf(this, { tags: [ElementTag.Datatype] }) as ModelIndex<DatatypeModel>;
+    }
+
+    get conformant() {
+        return new ClusterModel.Conformant(this);
     }
 
     get classification(): ClusterElement.Classification | undefined {
@@ -79,11 +84,9 @@ export class ClusterModel extends ScopeModel<ClusterElement, ClusterModel.Child>
      * Get attributes, commands and events whether inherited or defined directly in this model.
      */
     get allAces() {
-        return this.scope.membersOf(this, { tags: [ElementTag.Attribute, ElementTag.Command, ElementTag.Event] }) as (
-            | AttributeModel
-            | CommandModel
-            | EventModel
-        )[];
+        return this.scope.membersOf(this, {
+            tags: [ElementTag.Attribute, ElementTag.Command, ElementTag.Event],
+        }) as ModelIndex<AttributeModel | CommandModel | EventModel>;
     }
 
     get revision() {
@@ -193,4 +196,74 @@ export namespace ClusterModel {
 
         // Fields are not cluster children in canonical schema but we allow them as private values in operational schema
         | FieldModel;
+
+    /**
+     * A conformant view of {@link ClusterModel} child indices properties.
+     */
+    export class Conformant {
+        #model: ClusterModel;
+
+        constructor(model: ClusterModel) {
+            this.#model = model;
+        }
+
+        /**
+         * The cluster's conformant attributes.
+         */
+        get attributes() {
+            return this.#model.scope.membersOf(this.#model, {
+                tags: [ElementTag.Attribute],
+                conformance: "conformant",
+            }) as ModelIndex<AttributeModel>;
+        }
+
+        /**
+         * The cluster's conformant properties (includes fields and attributes).
+         *
+         * This offers compatibility with the equivalent field for ValueModel.  It is useful when treating a cluster as
+         * a struct.
+         */
+        get properties() {
+            return this.#model.scope.membersOf(this.#model, {
+                tags: [ElementTag.Attribute, ElementTag.Field],
+                conformance: "conformant",
+            }) as ModelIndex<AttributeModel | FieldModel>;
+        }
+
+        /**
+         * The cluster's conformant fields.
+         *
+         * Fields are not formally allowed on clusters but we allow for extensions that should not be served via the
+         * Matter protocol.
+         *
+         * This is primarily here to allow simplified access to fields in contexts where a variable is typed as a
+         * ClusterModel or ValueModel.
+         */
+        get fields() {
+            return this.#model.scope.membersOf(this.#model, {
+                tags: [ElementTag.Field],
+                conformance: "conformant",
+            }) as ModelIndex<FieldModel>;
+        }
+
+        /**
+         * The cluster's conformant commands.
+         */
+        get commands() {
+            return this.#model.scope.membersOf(this.#model, {
+                tags: [ElementTag.Command],
+                conformance: "conformant",
+            }) as ModelIndex<CommandModel>;
+        }
+
+        /**
+         * The cluster's conformant events.
+         */
+        get events() {
+            return this.#model.scope.membersOf(this.#model, {
+                tags: [ElementTag.Event],
+                conformance: "conformant",
+            }) as ModelIndex<EventModel>;
+        }
+    }
 }

package/src/models/ValueModel.ts

@@ -14,6 +14,7 @@ import type { PropertyModel } from "./PropertyModel.js";
 
 // These are circular dependencies so just to be safe we only import the types.  We also need the class, though, at
 // runtime.  So we use the references in the Model.constructors factory pool.
+import { ModelIndex } from "#logic/ModelIndex.js";
 import type { FieldModel } from "./FieldModel.js";
 
 /**
@@ -74,7 +75,11 @@ export abstract class ValueModel<T extends ValueElement = ValueElement>
     }
 
     get fields() {
-        return Scope(this).membersOf(this, { tags: [ElementTag.Field] }) as FieldModel[];
+        return Scope(this).membersOf(this, { tags: [ElementTag.Field] }) as ModelIndex<FieldModel>;
+    }
+
+    get conformant() {
+        return new ValueModel.Conformant(this);
     }
 
     /**
@@ -165,8 +170,8 @@ export abstract class ValueModel<T extends ValueElement = ValueElement>
     /**
      * All {@link FieldModel} children in the context of the model's containing scope.
      */
-    get members(): PropertyModel[] {
-        return Scope(this).membersOf(this) as PropertyModel[];
+    get members() {
+        return Scope(this).membersOf(this) as ModelIndex<PropertyModel>;
     }
 
     /**
@@ -294,3 +299,30 @@ export abstract class ValueModel<T extends ValueElement = ValueElement>
         });
     }
 }
+
+export namespace ValueModel {
+    export class Conformant {
+        #model: Model;
+
+        constructor(model: Model) {
+            this.#model = model;
+        }
+
+        /**
+         * The model's conformant fields.
+         */
+        get fields() {
+            return Scope(this.#model).membersOf(this.#model, {
+                tags: [ElementTag.Field],
+                conformance: "conformant",
+            }) as ModelIndex<FieldModel>;
+        }
+
+        /**
+         * An alias for {@link fields} that offers compatibility with the same field for clusters.
+         */
+        get properties() {
+            return this.fields;
+        }
+    }
+}