@matter/model 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/aspects/Constraint.js

@@ -0,0 +1,361 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Constraint_exports = {};
+__export(Constraint_exports, {
+  Constraint: () => Constraint
+});
+module.exports = __toCommonJS(Constraint_exports);
+var import_general = require("@matter/general");
+var import_common = require("../common/index.js");
+var import_Aspect = require("./Aspect.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class Constraint extends import_Aspect.Aspect {
+  /**
+   * Initialize from a Constraint.Definition or the constraint DSL defined by the Matter Specification.
+   */
+  constructor(definition) {
+    super(definition);
+    let ast;
+    switch (typeof definition) {
+      case "string":
+        if (definition.match(/(?:0b[0x ]*x[0x ]*)|(?:0x[0x_]*x[0x_]*)|(?:00[0x]*x)/i)) {
+          break;
+        }
+        ast = Constraint.parse(this, definition);
+        break;
+      case "number":
+        ast = { value: definition };
+        break;
+      default:
+        ast = definition;
+        if (ast?.definition) {
+          this.definition = ast.definition;
+        }
+        break;
+    }
+    if (!ast) {
+      return;
+    }
+    if (ast.desc !== void 0) {
+      this.desc = ast.desc;
+    }
+    if (ast.value !== void 0) {
+      this.value = ast.value;
+    }
+    if (ast.min !== void 0) {
+      this.min = ast.min;
+    }
+    if (ast.max !== void 0) {
+      this.max = ast.max;
+    }
+    if (ast.in !== void 0) {
+      this.in = ast.in;
+    }
+    if (ast.entry !== void 0) {
+      this.entry = new Constraint(ast.entry);
+    }
+    if (ast.parts !== void 0) {
+      this.parts = ast.parts.map((p) => new Constraint(p));
+    }
+  }
+  /**
+   * Test a value against a constraint.  Does not recurse into arrays.
+   */
+  test(value, properties) {
+    function valueOf(value2, raw = false) {
+      if (!raw && (typeof value2 === "string" || Array.isArray(value2))) {
+        return value2.length;
+      }
+      if ((0, import_general.isObject)(value2)) {
+        const { type, name } = value2;
+        if (type === import_common.FieldValue.reference && typeof name === "string") {
+          value2 = valueOf(properties?.[(0, import_general.camelize)(name)], raw);
+        }
+      }
+      return value2;
+    }
+    if (value === void 0) {
+      return false;
+    }
+    if (this.in) {
+      let set = valueOf(this.in, true);
+      if (!Array.isArray(set)) {
+        set = [set];
+      }
+      return set.indexOf(value) !== -1;
+    }
+    const v = valueOf(this.value);
+    if (v === value) {
+      return true;
+    }
+    if (v !== void 0 || value === null) {
+      return false;
+    }
+    if (this.min !== void 0 && this.min !== null) {
+      const min = valueOf(this.min);
+      if (min !== void 0 && min !== null && min > value) {
+        return false;
+      }
+    }
+    if (this.max !== void 0 && this.max !== null) {
+      const max = valueOf(this.max);
+      if (max !== void 0 && max !== null && max < value) {
+        return false;
+      }
+    }
+    if (this.parts?.every((part) => part.test(value, properties) === false)) {
+      return false;
+    }
+    return true;
+  }
+  toString() {
+    if (!this.valid && this.definition) {
+      return this.definition.toString();
+    }
+    return Constraint.serialize(this);
+  }
+  freeze() {
+    if (this.parts) {
+      Object.freeze(this.parts);
+    }
+    super.freeze();
+  }
+}
+((Constraint2) => {
+  function parseValue(numOrName) {
+    let value;
+    if (numOrName.match(/^-?0[xb]/)) {
+      value = Number.parseInt(numOrName.replace(/[_ ]/g, ""));
+    } else {
+      value = Number.parseFloat(numOrName);
+    }
+    if (typeof numOrName === "string") {
+      const lower = numOrName.toLowerCase();
+      switch (lower) {
+        case "true":
+          return true;
+        case "false":
+          return false;
+      }
+    }
+    if (Number.isNaN(value)) {
+      return import_common.FieldValue.Reference((0, import_general.camelize)(numOrName));
+    }
+    if (numOrName.endsWith("%")) {
+      return import_common.FieldValue.Percent(value);
+    }
+    if (numOrName.endsWith("\xB0C")) {
+      return import_common.FieldValue.Celsius(value);
+    }
+    return value;
+  }
+  function parseAtom(constraint, words) {
+    switch (words.length) {
+      case 0:
+        return void 0;
+      case 1:
+        switch (words[0].toLowerCase()) {
+          case "desc":
+            return { desc: true };
+          case "all":
+          case "any":
+            return {};
+        }
+        const value = parseValue(words[0]);
+        if (value === void 0 || value === null) {
+          return;
+        }
+        return { value };
+      case 2:
+        switch (words[0].toLowerCase()) {
+          case "min":
+            const min = parseValue(words[1]);
+            if (min === void 0 || min === null) {
+              return;
+            }
+            return { min };
+          case "max":
+            const max = parseValue(words[1]);
+            if (max === void 0 || max === null) {
+              return;
+            }
+            return { max };
+          case "in":
+            const ref = parseValue(words[1]);
+            return { in: ref };
+          default:
+            constraint.error(
+              "INVALID_CONSTRAINT",
+              `Two word constraint "${words.join(" ")}" does not start with "min" or "max"`
+            );
+        }
+        return;
+      case 3:
+        if (words[1].toLowerCase() === "to") {
+          let parseBound2 = function(name, pos) {
+            if (words[pos].toLowerCase() === name) {
+              return void 0;
+            }
+            return parseValue(words[pos]);
+          };
+          var parseBound = parseBound2;
+          const ast = {};
+          const min = parseBound2("min", 0);
+          if (min !== void 0 && min !== null) {
+            ast.min = min;
+          }
+          const max = parseBound2("max", 2);
+          if (max !== void 0 && max !== null) {
+            ast.max = max;
+          }
+          if (ast.min !== void 0 && ast.min !== null || ast.max !== void 0 && ast.max !== null) {
+            return ast;
+          }
+        }
+        return;
+    }
+    constraint.error("INVALID_CONSTRAINT", `Unrecognized value constraint "${words.join(" ")}"`);
+  }
+  function parse(constraint, definition) {
+    let pos = 2;
+    let current = definition[0];
+    let peeked = definition[1];
+    function next() {
+      current = peeked;
+      if (pos === definition.length) {
+        peeked = void 0;
+      } else {
+        peeked = definition[pos];
+        pos++;
+      }
+    }
+    function scan(depth) {
+      const parts = Array();
+      let words = Array();
+      let word = "";
+      function parseWords() {
+        if (word) {
+          words.push(word);
+          word = "";
+        }
+        const atom = parseAtom(constraint, words);
+        words = Array();
+        return atom;
+      }
+      function emit() {
+        const atom = parseWords();
+        if (atom !== void 0) {
+          parts.push(atom);
+        }
+      }
+      while (current !== void 0) {
+        switch (current) {
+          case " ":
+          case "	":
+          case "\r":
+          case "\n":
+          case "\v":
+          case "\f":
+            if (word) {
+              words.push(word);
+              word = "";
+            }
+            break;
+          case "[":
+            next();
+            let ast = parseWords();
+            const entry = scan(depth + 1);
+            if (entry) {
+              if (!ast) {
+                ast = {};
+              }
+              ast.entry = entry;
+            }
+            if (ast) {
+              parts.push(ast);
+            }
+            break;
+          case "]":
+            if (!depth) {
+              constraint.error("INVALID_CONSTRAINT", 'Unexpected "]"');
+              break;
+            }
+            emit();
+            if (parts.length > 1) {
+              return { parts };
+            }
+            return parts[0];
+          case ",":
+            emit();
+            break;
+          default:
+            word += current;
+            break;
+        }
+        next();
+      }
+      if (depth) {
+        constraint.error("INVALID_CONSTRAINT", "Unterminated sub-constraint");
+      }
+      emit();
+      if (parts.length < 2) {
+        return parts[0];
+      }
+      return { parts };
+    }
+    return scan(0);
+  }
+  Constraint2.parse = parse;
+  function serializeAtom(ast) {
+    if (ast.desc) {
+      return "desc";
+    }
+    if (ast.value !== void 0 && ast.value !== null) {
+      return `${import_common.FieldValue.serialize(ast.value)}`;
+    }
+    if (ast.min !== void 0 && ast.min !== null) {
+      if (ast.max === void 0 || ast.max === null) {
+        return `min ${import_common.FieldValue.serialize(ast.min)}`;
+      }
+      return `${import_common.FieldValue.serialize(ast.min)} to ${import_common.FieldValue.serialize(ast.max)}`;
+    }
+    if (ast.max !== void 0 && ast.max !== null) {
+      return `max ${import_common.FieldValue.serialize(ast.max)}`;
+    }
+    if (ast.in !== void 0) {
+      return `in ${import_common.FieldValue.serialize(ast.in)}`;
+    }
+    return "all";
+  }
+  function serialize(ast) {
+    if (ast.parts) {
+      return ast.parts.map(serialize).join(", ");
+    }
+    if (ast.entry) {
+      return `${serializeAtom(ast)}[${serialize(ast.entry)}]`;
+    }
+    return serializeAtom(ast);
+  }
+  Constraint2.serialize = serialize;
+})(Constraint || (Constraint = {}));
+//# sourceMappingURL=Constraint.js.map

package/dist/cjs/aspects/Constraint.js.map

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

package/dist/cjs/aspects/Quality.d.ts

@@ -0,0 +1,163 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Aspect } from "./Aspect.js";
+/**
+ * An operational representation of "other quality" as defined by the Matter
+ * specification.
+ *
+ * "Other qualities" are defined behaviors of data fields and cluster elements
+ * that do not involve access or conformance.
+ */
+export declare class Quality extends Aspect<Quality.Definition> implements Quality.Ast {
+    nullable?: boolean;
+    nonvolatile?: boolean;
+    fixed?: boolean;
+    changesOmitted?: boolean;
+    scene?: boolean;
+    reportable?: boolean;
+    singleton?: boolean;
+    disallowed?: Quality.AllProperties;
+    quieter?: boolean;
+    largeMessage?: boolean;
+    diagnostics?: boolean;
+    /**
+     * Initialize from a Quality.All definition or a string conforming to the
+     * "other quality" DSL defined in the Matter specification.
+     */
+    constructor(definition: Quality.Definition);
+    private parse;
+    /**
+     * Display quality using standard Matter syntax.
+     */
+    toString(): string;
+}
+export declare namespace Quality {
+    /**
+     * Various ways to define quality.
+     */
+    type Definition = Ast | `${Flag}`[] | string | undefined;
+    /**
+     * All qualities designated as "other qualities" in the Matter specification.
+     */
+    enum Field {
+        nullable = "X",
+        nonvolatile = "N",
+        fixed = "F",
+        scene = "S",
+        reportable = "P",
+        changesOmitted = "C",
+        singleton = "I",
+        quieter = "Q",
+        largeMessage = "L",
+        diagnostics = "K"
+    }
+    /**
+     * Quality flags and the logical field they map to.
+     */
+    enum Flag {
+        X = "nullable",
+        N = "nonvolatile",
+        F = "fixed",
+        S = "scene",
+        P = "reportable",
+        C = "changesOmitted",
+        I = "singleton",
+        Q = "quieter",
+        L = "largeMessage",
+        K = "diagnostics"
+    }
+    /**
+     * Valid "other quality" flags.
+     */
+    type FlagName = `${Field}`;
+    /**
+     * Runtime version of QualityFlag.
+     */
+    const FlagNames: FlagName[];
+    /**
+     * Quality values that apply to data fields.
+     */
+    type DataField = {
+        /**
+         * Designates a data field as nullable?
+         *
+         * Scope: data field
+         */
+        nullable?: boolean;
+    };
+    /**
+     * Quality values that apply to attribute data.
+     */
+    type AttributeData = DataField & {
+        /**
+         * Designates attribute value persistant across restarts?
+         */
+        nonvolatile?: boolean;
+        /**
+         * Designates a value as unchanging short of software replacement.
+         */
+        fixed?: boolean;
+        /**
+         * Designates a fast-changing value for which delta changes are
+         * unavailable.
+         */
+        changesOmitted?: boolean;
+        /**
+         * Designates data with fluctuating product rate or where some deltas are meaningless or otherwise undesirable
+         * to report.
+         */
+        quieter?: boolean;
+    };
+    /**
+     * Quality values that apply to attributes.
+     */
+    type Attribute = AttributeData & {
+        /**
+         * Designates an attribute as part of a scene.
+         */
+        scene?: boolean;
+        /**
+         * Designates best-effort reporting as available for an attribute.
+         */
+        reportable?: boolean;
+    };
+    type Command = {
+        /**
+         * Designates commands with payloads that potentially exceed a single IPv6 packet (1280 bytes, the minimum IPv6
+         * MTU).
+         */
+        largeMessage?: boolean;
+    };
+    type Cluster = {
+        /**
+         * Designates a cluster as a singleton on the node for the device type.
+         */
+        singleton?: boolean;
+        /**
+         * Designates a cluster as a diagnostics cluster.  Diagnostics clusters may be omitted from attribute expansion.
+         */
+        diagnostics?: boolean;
+    };
+    /**
+     * Quality properties that apply to device types.
+     */
+    type AllProperties = Attribute & Command & Cluster;
+    /**
+     * Quality values that apply to device types.
+     */
+    type DeviceType = AllProperties & {
+        /**
+         * Designates qualities that are disallowed for the device type.
+         */
+        disallowed?: AllProperties;
+    };
+    /**
+     * Values for all qualities designated as "other qualities" in the Matter
+     * specification.
+     */
+    type Ast = DeviceType;
+}
+//# sourceMappingURL=Quality.d.ts.map

package/dist/cjs/aspects/Quality.d.ts.map

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

package/dist/cjs/aspects/Quality.js

@@ -0,0 +1,122 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Quality_exports = {};
+__export(Quality_exports, {
+  Quality: () => Quality
+});
+module.exports = __toCommonJS(Quality_exports);
+var import_Aspect = require("./Aspect.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class Quality extends import_Aspect.Aspect {
+  /**
+   * Initialize from a Quality.All definition or a string conforming to the
+   * "other quality" DSL defined in the Matter specification.
+   */
+  constructor(definition) {
+    super(definition);
+    if (typeof definition === "string") {
+      this.parse(this, definition);
+    } else if (Array.isArray(definition)) {
+      definition.map((f) => this.parse(this, f));
+    } else {
+      Object.assign(this, definition);
+    }
+  }
+  parse(quality, definition) {
+    const text = definition.toUpperCase();
+    if (text === "DERIVED") {
+      return;
+    }
+    let disallow = false;
+    for (const char of text) {
+      if (char === " " || char === "	") {
+        continue;
+      }
+      if (char === "!") {
+        disallow = true;
+        continue;
+      }
+      const field = Quality.Flag[char];
+      if (field) {
+        if (this.disallowed?.[field]) {
+          continue;
+        }
+        if (disallow) {
+          delete this[field];
+          if (!this.disallowed) {
+            this.disallowed = {};
+          }
+          this.disallowed[field] = true;
+          disallow = false;
+        } else {
+          this[field] = true;
+        }
+      } else {
+        quality.error("UNKNOWN_QUALITY_FLAG", `Unknown flag "${char}"`);
+      }
+    }
+  }
+  /**
+   * Display quality using standard Matter syntax.
+   */
+  toString() {
+    const flags = [];
+    for (const f of Quality.FlagNames) {
+      const field = Quality.Flag[f];
+      if (this[field] && !this.disallowed?.[field]) {
+        flags.push(f);
+      }
+    }
+    return flags.join(" ");
+  }
+}
+((Quality2) => {
+  let Field;
+  ((Field2) => {
+    Field2["nullable"] = "X";
+    Field2["nonvolatile"] = "N";
+    Field2["fixed"] = "F";
+    Field2["scene"] = "S";
+    Field2["reportable"] = "P";
+    Field2["changesOmitted"] = "C";
+    Field2["singleton"] = "I";
+    Field2["quieter"] = "Q";
+    Field2["largeMessage"] = "L";
+    Field2["diagnostics"] = "K";
+  })(Field = Quality2.Field || (Quality2.Field = {}));
+  let Flag;
+  ((Flag2) => {
+    Flag2["X"] = "nullable";
+    Flag2["N"] = "nonvolatile";
+    Flag2["F"] = "fixed";
+    Flag2["S"] = "scene";
+    Flag2["P"] = "reportable";
+    Flag2["C"] = "changesOmitted";
+    Flag2["I"] = "singleton";
+    Flag2["Q"] = "quieter";
+    Flag2["L"] = "largeMessage";
+    Flag2["K"] = "diagnostics";
+  })(Flag = Quality2.Flag || (Quality2.Flag = {}));
+  Quality2.FlagNames = ["X", "N", "F", "S", "P", "C", "I", "Q", "L", "K"];
+})(Quality || (Quality = {}));
+//# sourceMappingURL=Quality.js.map

package/dist/cjs/aspects/Quality.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/aspects/Quality.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAAuB;AANvB;AAAA;AAAA;AAAA;AAAA;AAeO,MAAM,gBAAgB,qBAAkD;AAAA;AAAA;AAAA;AAAA;AAAA,EAiB3E,YAAY,YAAgC;AACxC,UAAM,UAAU;AAEhB,QAAI,OAAO,eAAe,UAAU;AAChC,WAAK,MAAM,MAAM,UAAU;AAAA,IAC/B,WAAW,MAAM,QAAQ,UAAU,GAAG;AAClC,iBAAW,IAAI,OAAK,KAAK,MAAM,MAAM,CAAC,CAAC;AAAA,IAC3C,OAAO;AACH,aAAO,OAAO,MAAM,UAAU;AAAA,IAClC;AAAA,EACJ;AAAA,EAEQ,MAAM,SAAkB,YAAoB;AAChD,UAAM,OAAO,WAAW,YAAY;AACpC,QAAI,SAAS,WAAW;AACpB;AAAA,IACJ;AAEA,QAAI,WAAW;AACf,eAAW,QAAQ,MAAM;AACrB,UAAI,SAAS,OAAO,SAAS,KAAM;AAC/B;AAAA,MACJ;AAEA,UAAI,SAAS,KAAK;AACd,mBAAW;AACX;AAAA,MACJ;AAEA,YAAM,QAAQ,QAAQ,KAAK,IAAwB;AACnD,UAAI,OAAO;AACP,YAAI,KAAK,aAAa,KAAK,GAAG;AAC1B;AAAA,QACJ;AACA,YAAI,UAAU;AACV,iBAAO,KAAK,KAAK;AACjB,cAAI,CAAC,KAAK,YAAY;AAClB,iBAAK,aAAa,CAAC;AAAA,UACvB;AACA,eAAK,WAAW,KAAK,IAAI;AACzB,qBAAW;AAAA,QACf,OAAO;AACH,eAAK,KAAK,IAAI;AAAA,QAClB;AAAA,MACJ,OAAO;AACH,gBAAQ,MAAM,wBAAwB,iBAAiB,IAAI,GAAG;AAAA,MAClE;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKS,WAAW;AAChB,UAAM,QAAQ,CAAC;AAEf,eAAW,KAAK,QAAQ,WAAW;AAC/B,YAAM,QAAQ,QAAQ,KAAK,CAAC;AAC5B,UAAI,KAAK,KAAK,KAAK,CAAC,KAAK,aAAa,KAAK,GAAG;AAC1C,cAAM,KAAK,CAAC;AAAA,MAChB;AAAA,IACJ;AAEA,WAAO,MAAM,KAAK,GAAG;AAAA,EACzB;AACJ;AAAA,CAEO,CAAUA,aAAV;AASI,MAAK;AAAL,IAAKC,WAAL;AACH,IAAAA,OAAA,cAAW;AACX,IAAAA,OAAA,iBAAc;AACd,IAAAA,OAAA,WAAQ;AACR,IAAAA,OAAA,WAAQ;AACR,IAAAA,OAAA,gBAAa;AACb,IAAAA,OAAA,oBAAiB;AACjB,IAAAA,OAAA,eAAY;AACZ,IAAAA,OAAA,aAAU;AACV,IAAAA,OAAA,kBAAe;AACf,IAAAA,OAAA,iBAAc;AAAA,KAVN,QAAAD,SAAA,UAAAA,SAAA;AAgBL,MAAK;AAAL,IAAKE,UAAL;AACH,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AACJ,IAAAA,MAAA,OAAI;AAAA,KAVI,OAAAF,SAAA,SAAAA,SAAA;AAqBL,EAAMA,SAAA,YAAwB,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAAA,GA9CzE;",
+  "names": ["Quality", "Field", "Flag"]
+}

package/dist/cjs/aspects/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Access.js";
+export * from "./Aspect.js";
+export * from "./Conformance.js";
+export * from "./Constraint.js";
+export * from "./Quality.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/aspects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/aspects/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}