@project-chip/matter.js 0.4.0 → 0.5.0

package/dist/es/model/logic/ValidateModel.js

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger } from "../../log/Logger.js";
+import { ModelValidator } from "./definition-validation/ModelValidator.js";
+const logger = Logger.get("ValidateModel");
+/**
+ * Ensures that a model's definition is correct.  Places errors into the error
+ * array of invalid models.
+ *
+ * Makes a few minor modifications to the model as a side effect:
+ *
+ * - Default values are cast to the correct type if possible
+ * - Cross-references are deleted if they're redundant with the parent
+ *
+ * Note that we run validation against model classes rather than element
+ * datatypes.  The classes implement type resolution, error handling and other
+ * logic we rely on for validation.
+ */
+export function ValidateModel(model) {
+    const result = new ValidateModel.Result(model);
+    function validate(model) {
+        const Validator = ModelValidator.validators[model.tag];
+        if (!Validator) {
+            model.error("UNKNOWN_MODEL_TYPE", `No validator for ${model.tag}`);
+            return;
+        }
+        try {
+            new Validator(model).validate();
+        }
+        catch (e) {
+            console.error(`Error validating ${model.path}`);
+            throw e;
+        }
+        result.elementCount++;
+        if (!model.valid) {
+            result.invalidElementCount++;
+            if (model.errors) {
+                for (const error of model.errors) {
+                    if (result.errorCounts[error.code]) {
+                        result.errorCounts[error.code]++;
+                    }
+                    else {
+                        result.errorCounts[error.code] = 1;
+                    }
+                    result.errors.push(error);
+                }
+            }
+        }
+        // Need another logging level before enabling this
+        // logger.debug(
+        //     `${model.valid ? "✔": "✘"} ${model.name}`,
+        //     Logger.dict({
+        //         tag: model.tag,
+        //         children: model.children.length || undefined,
+        //         id: model.id ? `0x${model.id?.toString(16)}` : undefined,
+        //         xref: model.xref
+        //     })
+        // );
+        Logger.nest(() => {
+            model.children.forEach(validate);
+        });
+    }
+    logger.info("Validating matter model");
+    validate(model);
+    return result;
+}
+(function (ValidateModel) {
+    class Result {
+        get invalidElementPercent() {
+            return ((this.invalidElementCount / this.elementCount) * 100).toPrecision(2);
+        }
+        constructor(model) {
+            this.model = model;
+            this.elementCount = 0;
+            this.invalidElementCount = 0;
+            this.errorCounts = {};
+            this.errors = Array();
+        }
+        report() {
+            if (this.errors.length) {
+                logger.error("*** Validation error summary ***");
+                this.errors.forEach(error => logger.error(error.message, Logger.dict({ code: error.code, xref: error.xref, src: error.source })));
+                logger.error("Error counts by code:");
+                Logger.nest(() => {
+                    const codes = Object.keys(this.errorCounts).sort((a, b) => a.localeCompare(b, undefined, { sensitivity: "base" }));
+                    for (const code of codes) {
+                        logger.error(`${code}: ${this.errorCounts[code]}`);
+                    }
+                });
+                logger.error(`*** Total ${this.errors.length} validation error${this.errors.length === 1 ? "" : "s"} ***`);
+                logger.error(`*** Total ${this.invalidElementCount} invalid element${this.invalidElementCount === 1 ? "" : "s"} (${this.invalidElementPercent}%) ***`);
+            }
+            else {
+                logger.info(`*** Validation successful ***`);
+            }
+            logger.debug(`*** Total ${this.elementCount} element${this.elementCount === 1 ? "" : "s"} ***`);
+        }
+    }
+    ValidateModel.Result = Result;
+})(ValidateModel = ValidateModel || (ValidateModel = {}));
+//# sourceMappingURL=ValidateModel.js.map

package/dist/es/model/logic/ValidateModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateModel.js","sourceRoot":"","sources":["../../../../src/model/logic/ValidateModel.ts"],"names":[],"mappings":"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"}

package/dist/es/model/logic/cluster-variance/FeatureBitmap.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ClusterModel } from "../../models/index.js";
+export type FeatureFlags = string[];
+export type FeatureBitmap = {
+    [name: string]: boolean;
+};
+export type FeatureNames = {
+    [key: string]: string;
+};
+export declare function FeatureBitmap(bitmap?: FeatureBitmap | FeatureFlags): FeatureBitmap;
+/**
+ * Map the names in a feature bitmap to different names.  Used to convert from
+ * a feature code bitmap to a feature name bitmap.
+ *
+ * E.g. { F: true } -> { foo: true }
+ *
+ * If a name isn't present leaves the feature code intact.
+ */
+export declare function translateBitmap(bitmap: FeatureBitmap, cluster: ClusterModel): {
+    [k: string]: boolean;
+};
+//# sourceMappingURL=FeatureBitmap.d.ts.map

package/dist/es/model/logic/cluster-variance/FeatureBitmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureBitmap.d.ts","sourceRoot":"","sources":["../../../../../src/model/logic/cluster-variance/FeatureBitmap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC;AACpC,MAAM,MAAM,aAAa,GAAG;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAErD,wBAAgB,aAAa,CAAC,MAAM,GAAE,aAAa,GAAG,YAAiB,GAAG,aAAa,CAKtF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY;;EAO3E"}

package/dist/es/model/logic/cluster-variance/FeatureBitmap.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { camelize } from "../../../util/String.js";
+import { DatatypeModel } from "../../models/index.js";
+export function FeatureBitmap(bitmap = {}) {
+    if (Array.isArray(bitmap)) {
+        return Object.fromEntries(bitmap.map(name => [name, true]));
+    }
+    return bitmap;
+}
+/**
+ * Map the names in a feature bitmap to different names.  Used to convert from
+ * a feature code bitmap to a feature name bitmap.
+ *
+ * E.g. { F: true } -> { foo: true }
+ *
+ * If a name isn't present leaves the feature code intact.
+ */
+export function translateBitmap(bitmap, cluster) {
+    return Object.fromEntries(Object.entries(bitmap).map(([k, v]) => {
+        var _a;
+        const feature = cluster.featureMap.get(DatatypeModel, k);
+        return [camelize((_a = feature === null || feature === void 0 ? void 0 : feature.description) !== null && _a !== void 0 ? _a : k, false), v];
+    }));
+}
+//# sourceMappingURL=FeatureBitmap.js.map

package/dist/es/model/logic/cluster-variance/FeatureBitmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureBitmap.js","sourceRoot":"","sources":["../../../../../src/model/logic/cluster-variance/FeatureBitmap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAgB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAMpE,MAAM,UAAU,aAAa,CAAC,SAAuC,EAAE;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QACvB,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;KAC/D;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB,EAAE,OAAqB;IACxE,OAAO,MAAM,CAAC,WAAW,CACrB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,QAAQ,CAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CACL,CAAC;AACN,CAAC"}

package/dist/es/model/logic/cluster-variance/IllegalFeatureCombinations.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ClusterModel } from "../../models/index.js";
+import { FeatureBitmap } from "./FeatureBitmap.js";
+export type IllegalFeatureCombinations = FeatureBitmap[];
+/**
+ * Analyzes feature conformance to ascertain feature combinations that are
+ * unsupported.  Uses rules to match the conformance AST.
+ *
+ * Rule matching is not exhaustive but supports a significant subset of the
+ * conformance dialect that is inclusive of all feature conformances used by
+ * the 1.1 specifications.
+ *
+ * Throws an error if conformance does not adhere to supported rules.  This
+ * indicates the ruleset needs augmentation.
+ */
+export declare function IllegalFeatureCombinations(cluster: ClusterModel): {
+    illegal: IllegalFeatureCombinations;
+    requiresFeatures: boolean;
+};
+//# sourceMappingURL=IllegalFeatureCombinations.d.ts.map

package/dist/es/model/logic/cluster-variance/IllegalFeatureCombinations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IllegalFeatureCombinations.d.ts","sourceRoot":"","sources":["../../../../../src/model/logic/cluster-variance/IllegalFeatureCombinations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,0BAA0B,GAAG,aAAa,EAAE,CAAC;AASzD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY;;;EAqC/D"}

package/dist/es/model/logic/cluster-variance/IllegalFeatureCombinations.js

@@ -0,0 +1,122 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError } from "../../../common/MatterError.js";
+import { isDeepEqual } from "../../../util/DeepEqual.js";
+import { Conformance } from "../../aspects/index.js";
+import { FeatureBitmap } from "./FeatureBitmap.js";
+/**
+ * Analyzes feature conformance to ascertain feature combinations that are
+ * unsupported.  Uses rules to match the conformance AST.
+ *
+ * Rule matching is not exhaustive but supports a significant subset of the
+ * conformance dialect that is inclusive of all feature conformances used by
+ * the 1.1 specifications.
+ *
+ * Throws an error if conformance does not adhere to supported rules.  This
+ * indicates the ruleset needs augmentation.
+ */
+export function IllegalFeatureCombinations(cluster) {
+    const illegal = [];
+    const choices = {};
+    for (const f of cluster.features) {
+        addFeatureNode(f, f.conformance.ast, illegal, choices);
+    }
+    function add(flags) {
+        if (!illegal.some(e => isDeepEqual(e, flags))) {
+            illegal.push(flags);
+        }
+    }
+    for (const choice of Object.values(choices)) {
+        // If choices are mutually exclusive, reject any two flags in
+        // combination
+        if (choice.exclusive) {
+            for (const f1 of choice.features) {
+                for (const f2 of choice.features) {
+                    if (f1 !== f2) {
+                        add({ [f1]: true, [f2]: true });
+                    }
+                }
+            }
+        }
+        // At least one feature choice must be enabled
+        const flags = FeatureBitmap();
+        for (const f of choice.features) {
+            flags[f] = false;
+        }
+        add(flags);
+    }
+    return { illegal, requiresFeatures: !!choices.length };
+}
+function addFeatureNode(feature, node, illegal, choices) {
+    function unsupported() {
+        throw new InternalError(`New rule required to support ${feature.path} conformance "${feature.conformance}"`);
+    }
+    function addDisjunctRequirement(flags, node) {
+        switch (node.type) {
+            case Conformance.Special.Name:
+                flags[node.param] = false;
+                break;
+            case Conformance.OR:
+                addDisjunctRequirement(flags, node.param.lhs);
+                addDisjunctRequirement(flags, node.param.rhs);
+                break;
+            default:
+                unsupported();
+        }
+    }
+    function addConjunctRequirement(feature, node) {
+        switch (node.type) {
+            case Conformance.Special.Name:
+                illegal.push({ [feature]: true, [node.param]: false });
+                break;
+            case Conformance.AND:
+                addConjunctRequirement(feature, node.param.lhs);
+                addConjunctRequirement(feature, node.param.rhs);
+                break;
+        }
+    }
+    switch (node.type) {
+        case Conformance.Special.Empty:
+        case Conformance.Flag.Optional:
+        case Conformance.Flag.Provisional:
+            break;
+        case Conformance.Special.Group:
+            node.param.forEach(ast => addFeatureNode(feature, ast, illegal, choices));
+            break;
+        case Conformance.Special.Choice:
+            if (node.param.num > 1) {
+                unsupported();
+            }
+            let choice = choices[node.param.name];
+            if (choice) {
+                choice.features.push(feature.name);
+            }
+            else {
+                choice = choices[node.param.name] = {
+                    exclusive: !node.param.orMore,
+                    features: [feature.name],
+                };
+            }
+            break;
+        case Conformance.Special.Name:
+            illegal.push({ [node.param]: true, [feature.name]: false });
+            break;
+        case Conformance.Special.OptionalIf:
+            if (node.param.type == Conformance.AND) {
+                addConjunctRequirement(feature.name, node.param);
+            }
+            else {
+                const flags = FeatureBitmap({ [feature.name]: true });
+                addDisjunctRequirement(flags, node.param);
+                illegal.push(flags);
+            }
+            break;
+        default:
+            unsupported();
+            break;
+    }
+}
+//# sourceMappingURL=IllegalFeatureCombinations.js.map

package/dist/es/model/logic/cluster-variance/IllegalFeatureCombinations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IllegalFeatureCombinations.js","sourceRoot":"","sources":["../../../../../src/model/logic/cluster-variance/IllegalFeatureCombinations.ts"],"names":[],"mappings":"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"}

package/dist/es/model/logic/cluster-variance/InferredComponents.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ClusterModel, ValueModel } from "../../models/index.js";
+import { VarianceCondition } from "./VarianceCondition.js";
+/**
+ * Lists mandatory and optional elements for a specific context.
+ */
+export type InferredComponent = {
+    mandatory: ValueModel[];
+    optional: ValueModel[];
+    condition?: VarianceCondition;
+};
+/**
+ * A list of component definitions.
+ */
+export type InferredComponents = InferredComponent[];
+/**
+ * Details components generated by analyzing variance of cluster elements.
+ */
+export declare function InferredComponents(cluster: ClusterModel): InferredComponents;
+//# sourceMappingURL=InferredComponents.d.ts.map

package/dist/es/model/logic/cluster-variance/InferredComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferredComponents.d.ts","sourceRoot":"","sources":["../../../../../src/model/logic/cluster-variance/InferredComponents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAkB,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,EAAE,CAAC;AAErD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,kBAAkB,CAI5E"}

package/dist/es/model/logic/cluster-variance/InferredComponents.js

@@ -0,0 +1,229 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { NotImplementedError } from "../../../common/MatterError.js";
+import { isDeepEqual } from "../../../util/DeepEqual.js";
+import { AttributeModel } from "../../models/index.js";
+/**
+ * Details components generated by analyzing variance of cluster elements.
+ */
+export function InferredComponents(cluster) {
+    const result = [];
+    cluster.children.forEach(child => addElement(result, child));
+    return result;
+}
+function pattern(...parts) {
+    parts = parts.map(p => {
+        switch (p) {
+            case "[":
+            case "]":
+            case "(":
+            case ")":
+                return `\\${p}`;
+            default:
+                return p;
+        }
+    });
+    return new RegExp(`^${parts.join("")}$`);
+}
+const FEATURE_NAME = "[A-Z_][A-Z_]+";
+const FEATURE = `(${FEATURE_NAME})`;
+const CONJUNCT_FEATURES = `(${FEATURE_NAME}(?: & ${FEATURE_NAME})*)`;
+const DISJUNCT_FEATURES = CONJUNCT_FEATURES.replace("&", "[|,]");
+const FIELD = "[A-Z][A-Za-z_$]*[a-z][A-Za-z_$]*";
+const AND = " & ";
+const NOT = "!";
+function splitConjunction(conjunction) {
+    return conjunction.split(" & ");
+}
+function splitDisjunction(disjunction) {
+    return disjunction.split(" | ");
+}
+/**
+ * We use a rules-based approach to infer cluster variance.  The goal is to
+ * classify into as few sets as possible.  This leads to fewer duplicated
+ * elements and reduced complexity of generated clusters.
+ *
+ * Matches string form rather than the AST because that is also simpler for
+ * the moment.  Note this is less fragile than it may appear because string is
+ * normalized product of parser -> AST -> serializer.
+ *
+ * Note also that this only applies to conformance of cluster-level elements.
+ * There is considerably more variance in field-level conformance but we handle
+ * that with the record validator which supports the entire dialect.
+ */
+const VarianceMatchers = [
+    // Mandatory, unconditional
+    {
+        pattern: pattern("(?:|M)"),
+        processor: add => {
+            add();
+        },
+    },
+    // Optional, unconditional
+    {
+        pattern: pattern("(?:O|desc)"),
+        processor: add => {
+            add(true);
+        },
+    },
+    // Optional, unconditional.  Ignores field expression which can only be
+    // enforced at runtime
+    {
+        pattern: pattern(FIELD, " > ", "\\d+"),
+        processor: add => {
+            add(true);
+        },
+    },
+    // FOO & fieldName (field ignored as must be runtime enforced)
+    {
+        pattern: pattern(FEATURE, AND, FIELD),
+        processor: (add, match) => {
+            add(true, { allOf: match });
+        },
+    },
+    // FOO<& BAR>*
+    {
+        pattern: pattern(CONJUNCT_FEATURES),
+        processor: (add, match) => {
+            add(false, { allOf: splitConjunction(match[0]) });
+        },
+    },
+    // [FOO<& BAR>*]
+    {
+        pattern: pattern("[", CONJUNCT_FEATURES, "]"),
+        processor: (add, match) => {
+            add(true, { allOf: splitConjunction(match[0]) });
+        },
+    },
+    // FOO<| BAR*> or FOO<, BAR>*
+    {
+        pattern: pattern(DISJUNCT_FEATURES),
+        processor: (add, match) => {
+            add(false, { anyOf: splitDisjunction(match[0]) });
+        },
+    },
+    // FOO, [BAR]
+    {
+        pattern: pattern(FEATURE, ", ", "[", FEATURE, "]"),
+        processor: (add, match) => {
+            // Must add to two sets because optionality differs
+            add(false, { allOf: [match[0]] });
+            add(true, { allOf: [match[1]] });
+        },
+    },
+    // !FOO & BAR
+    {
+        pattern: pattern(NOT, FEATURE, AND, FEATURE),
+        processor: (add, match) => {
+            add(false, { allOf: [match[1]], not: match[0] });
+        },
+    },
+    // !FOO & [BAR]
+    {
+        pattern: pattern(NOT, FEATURE, AND, "[", FEATURE, "]"),
+        processor: (add, match) => {
+            add(true, { allOf: [match[1]], not: match[0] });
+        },
+    },
+    // !FOO & (BAR<| BIZ>*)
+    {
+        pattern: pattern(NOT, FEATURE, AND, "(", DISJUNCT_FEATURES, ")"),
+        processor: (add, match) => {
+            add(true, { allOf: splitDisjunction(match[1]), not: match[0] });
+        },
+    },
+    // !FOO
+    {
+        pattern: pattern(NOT, FEATURE),
+        processor: (add, match) => {
+            add(false, { not: match[0] });
+        },
+    },
+    // [!FOO]
+    {
+        pattern: pattern("[", NOT, FEATURE, "]"),
+        processor: (add, match) => {
+            add(true, { not: match[0] });
+        },
+    },
+    // FOO & BAR, [BIZ]
+    {
+        pattern: pattern(FEATURE, AND, FEATURE, ", ", "[", FEATURE, "]"),
+        processor: (add, match) => {
+            add(false, { allOf: match.slice(0, 2) });
+            add(true, { allOf: [match[2]] });
+        },
+    },
+];
+function addElement(components, element) {
+    if (element.base instanceof AttributeModel) {
+        const globalBase = element.globalBase;
+        if (globalBase instanceof AttributeModel && globalBase.id === element.id) {
+            return;
+        }
+    }
+    let text = element.conformance.toString();
+    if (text === "X") {
+        return;
+    }
+    while (true) {
+        if (text.match(/^[DP], /)) {
+            text = text.substring(3);
+        }
+        else {
+            break;
+        }
+    }
+    if (text === "D") {
+        text = "O";
+    }
+    else if (text === "P") {
+        text = "M";
+    }
+    for (const matcher of VarianceMatchers) {
+        const match = text.match(matcher.pattern);
+        if (match) {
+            matcher.processor((optional, condition) => {
+                addVariance(components, element, optional, condition);
+            }, match.slice(1));
+            return;
+        }
+    }
+    throw new NotImplementedError(`New rule needed for conformance "${element.conformance}" (element ${element.path})`);
+}
+function addVariance(components, element, optional, condition) {
+    let into;
+    // Find set
+    for (const existing of components) {
+        if (isDeepEqual(existing.condition, condition)) {
+            into = existing;
+            break;
+        }
+    }
+    // If set does not exist, create it
+    if (!into) {
+        into = {
+            condition,
+            optional: [],
+            mandatory: [],
+        };
+        if (condition) {
+            components.push(into);
+        }
+        else {
+            // Unconditional elements should always be detailed first
+            components.unshift(into);
+        }
+    }
+    // Add the element to the set
+    if (optional) {
+        into.optional.push(element);
+    }
+    else {
+        into.mandatory.push(element);
+    }
+}
+//# sourceMappingURL=InferredComponents.js.map

package/dist/es/model/logic/cluster-variance/InferredComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferredComponents.js","sourceRoot":"","sources":["../../../../../src/model/logic/cluster-variance/InferredComponents.ts"],"names":[],"mappings":"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"}

package/dist/es/model/logic/cluster-variance/NamedComponents.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ClusterModel } from "../../models/index.js";
+import { InferredComponent, InferredComponents } from "./InferredComponents.js";
+/**
+ * An inferred with generated name and documentation.
+ */
+export type NamedComponent = InferredComponent & {
+    name: string;
+    documentation: string;
+};
+/**
+ * A set of components keyed by generated names.
+ */
+export type NamedComponents = NamedComponent[];
+/**
+ * Compute name and documentation a set of inferred components.
+ */
+export declare function NamedComponents(cluster: ClusterModel, inferredComponents: InferredComponents): {
+    base: InferredComponent;
+    components: NamedComponents;
+};
+//# sourceMappingURL=NamedComponents.d.ts.map

package/dist/es/model/logic/cluster-variance/NamedComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamedComponents.d.ts","sourceRoot":"","sources":["../../../../../src/model/logic/cluster-variance/NamedComponents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,EAAE,CAAC;AAE/C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB;;;EAoE5F"}