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

package/dist/cjs/aspects/Access.js

@@ -0,0 +1,295 @@
+"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 Access_exports = {};
+__export(Access_exports, {
+  Access: () => Access,
+  AccessLevel: () => AccessLevel
+});
+module.exports = __toCommonJS(Access_exports);
+var import_general = require("@matter/general");
+var import_Aspect = require("./Aspect.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var AccessLevel = /* @__PURE__ */ ((AccessLevel2) => {
+  AccessLevel2[AccessLevel2["View"] = 1] = "View";
+  AccessLevel2[AccessLevel2["ProxyView"] = 2] = "ProxyView";
+  AccessLevel2[AccessLevel2["Operate"] = 3] = "Operate";
+  AccessLevel2[AccessLevel2["Manage"] = 4] = "Manage";
+  AccessLevel2[AccessLevel2["Administer"] = 5] = "Administer";
+  return AccessLevel2;
+})(AccessLevel || {});
+class Access extends import_Aspect.Aspect {
+  get readable() {
+    return !this.rw || this.rw !== Access.Rw.Write;
+  }
+  get writable() {
+    return !!this.rw && this.rw !== Access.Rw.Read;
+  }
+  get fabricScoped() {
+    return this.fabric === Access.Fabric.Scoped;
+  }
+  get fabricSensitive() {
+    return this.fabric === Access.Fabric.Sensitive;
+  }
+  get empty() {
+    return (!this.rw || this.rw === Access.Rw.Read) && !this.fabric && !this.readPriv && !this.writePriv && !this.timed;
+  }
+  /**
+   * Determine whether this access is fully specified.  This means we know
+   * whether reads and/or writes are allowed and if so the required access
+   * levels.
+   */
+  get complete() {
+    return this.rw !== void 0 && (!this.readable || this.rw !== void 0) && (!this.writable || this.rw !== void 0);
+  }
+  /**
+   * Initialize from an Access.Definition or the access control DSL defined
+   * by the Matter Specification.
+   */
+  constructor(definition) {
+    super(definition);
+    if (Array.isArray(definition)) {
+      this.set(definition.flat());
+    } else if ((0, import_general.isObject)(definition)) {
+      Object.assign(this, definition);
+    } else if (definition !== void 0 && definition !== null) {
+      this.set(Array.from(Access.parse(this, definition)));
+    }
+  }
+  /**
+   * Parses standard Matter access syntax into an AccessFlag set.  Extremely
+   * lenient.
+   */
+  static parse(access, definition) {
+    definition = definition.toUpperCase();
+    if (definition === "DERIVED") {
+      return [];
+    }
+    const flags = [];
+    for (let i = 0; i < definition.length; i++) {
+      switch (definition[i]) {
+        case "R":
+          flags.push(Access.Rw.Read);
+          break;
+        case "U":
+          flags.push(Access.Fabric.Unaware);
+          break;
+        case "F":
+          flags.push(Access.Fabric.Scoped);
+          break;
+        case "S":
+          flags.push(Access.Fabric.Sensitive);
+          break;
+        case "V":
+          flags.push(Access.Privilege.View);
+          break;
+        case "O":
+          flags.push(Access.Privilege.Operate);
+          break;
+        case "M":
+          flags.push(Access.Privilege.Manage);
+          break;
+        case "A":
+          flags.push(Access.Privilege.Administer);
+          break;
+        case "T":
+          flags.push(Access.Timed.Required);
+          break;
+        case "W":
+          flags.push(Access.Rw.Write);
+          break;
+        case "[":
+          if (i < definition.length - 2 && definition[i + 1] === "W" && definition[i + 2] === "]") {
+            flags.push(Access.Rw.ReadWriteOption);
+            i += 2;
+          }
+          break;
+        case "*":
+          if (i < definition.length - 1 && definition[i + 1] === "W") {
+            flags.push(Access.Rw.ReadWriteOption);
+            i++;
+          }
+          break;
+        case " ":
+        case "	":
+        case "\n":
+        case "\r":
+        case "\f":
+        case "\v":
+          break;
+        default:
+          access.error("UNKNOWN_ACCESS_FLAG", `Unknown flag "${definition[i]}"`);
+          i++;
+          break;
+      }
+    }
+    return flags;
+  }
+  /**
+   * Displays access using the standard Matter syntax.
+   */
+  toString() {
+    const parts = [];
+    if (this.rw !== void 0) {
+      parts.push(this.rw);
+    }
+    if (this.fabric !== void 0) {
+      parts.push(this.fabric);
+    }
+    if (this.readPriv === this.writePriv) {
+      if (this.readPriv !== void 0) {
+        parts.push(this.readPriv);
+      }
+    } else if (this.readPriv) {
+      if (this.writePriv) {
+        parts.push(`${this.readPriv}${this.writePriv}`);
+      } else {
+        parts.push(this.readPriv);
+      }
+    } else if (this.writePriv) {
+      parts.push(this.writePriv);
+    }
+    if (this.timed) {
+      parts.push(Access.Timed.Required);
+    }
+    return parts.join(" ");
+  }
+  set(flags) {
+    flags.forEach((f) => {
+      switch (f) {
+        case Access.Rw.Read:
+          if (!this.rw) {
+            this.rw = f;
+          }
+          break;
+        case Access.Rw.Write:
+          if (!this.rw) {
+            this.rw = f;
+          } else if (this.rw === Access.Rw.Read) {
+            this.rw = Access.Rw.ReadWrite;
+          }
+          break;
+        case Access.Rw.ReadWrite:
+          if (this.rw !== Access.Rw.ReadWriteOption) {
+            this.rw = f;
+          }
+          break;
+        case Access.Rw.ReadWriteOption:
+          this.rw = f;
+          break;
+        case Access.Fabric.Unaware:
+          this.fabric = Access.Fabric.Unaware;
+          break;
+        case Access.Fabric.Scoped:
+          if (this.fabric !== Access.Fabric.Sensitive) {
+            this.fabric = f;
+          }
+          break;
+        case Access.Fabric.Sensitive:
+          this.fabric = f;
+          break;
+        case Access.Privilege.View:
+          this.readPriv = f;
+          break;
+        case Access.Privilege.Operate:
+        case Access.Privilege.Manage:
+        case Access.Privilege.Administer:
+          if (!this.readPriv || Access.PrivilegeLevel[f] < Access.PrivilegeLevel[this.readPriv]) {
+            this.readPriv = f;
+          }
+          if (!this.writePriv || Access.PrivilegeLevel[f] > Access.PrivilegeLevel[this.writePriv]) {
+            this.writePriv = f;
+          }
+          break;
+        case Access.Timed.Required:
+          this.timed = true;
+          break;
+      }
+    });
+  }
+}
+((Access2) => {
+  let Rw;
+  ((Rw2) => {
+    Rw2["Read"] = "R";
+    Rw2["Write"] = "W";
+    Rw2["ReadWrite"] = "RW";
+    Rw2["ReadWriteOption"] = "R[W]";
+  })(Rw = Access2.Rw || (Access2.Rw = {}));
+  let Fabric;
+  ((Fabric2) => {
+    Fabric2["Unaware"] = "U";
+    Fabric2["Scoped"] = "F";
+    Fabric2["Sensitive"] = "S";
+  })(Fabric = Access2.Fabric || (Access2.Fabric = {}));
+  let Privilege;
+  ((Privilege2) => {
+    Privilege2["View"] = "V";
+    Privilege2["Operate"] = "O";
+    Privilege2["Manage"] = "M";
+    Privilege2["Administer"] = "A";
+  })(Privilege = Access2.Privilege || (Access2.Privilege = {}));
+  let PrivilegeName;
+  ((PrivilegeName2) => {
+    PrivilegeName2["V"] = "View";
+    PrivilegeName2["O"] = "Operate";
+    PrivilegeName2["M"] = "Manage";
+    PrivilegeName2["A"] = "Administer";
+  })(PrivilegeName = Access2.PrivilegeName || (Access2.PrivilegeName = {}));
+  Access2.PrivilegeLevel = {
+    V: 1 /* View */,
+    // 2 is ProxyView, seems not in use/model right now
+    O: 3 /* Operate */,
+    M: 4 /* Manage */,
+    A: 5 /* Administer */
+  };
+  let Timed;
+  ((Timed2) => {
+    Timed2["Required"] = "T";
+  })(Timed = Access2.Timed || (Access2.Timed = {}));
+  Access2.R = "R" /* Read */;
+  Access2.W = "W" /* Write */;
+  Access2.RW = "RW" /* ReadWrite */;
+  Access2.RWo = "R[W]" /* ReadWriteOption */;
+  Access2.U = "U" /* Unaware */;
+  Access2.F = "F" /* Scoped */;
+  Access2.S = "S" /* Sensitive */;
+  Access2.V = "V" /* View */;
+  Access2.O = ["O" /* Operate */];
+  Access2.M = ["M" /* Manage */];
+  Access2.A = ["A" /* Administer */];
+  Access2.VO = ["V" /* View */, "O" /* Operate */];
+  Access2.VM = ["V" /* View */, "M" /* Manage */];
+  Access2.VA = ["V" /* View */, "A" /* Administer */];
+  Access2.OM = ["O" /* Operate */, "M" /* Manage */];
+  Access2.OA = ["O" /* Operate */, "A" /* Administer */];
+  Access2.MA = ["M" /* Manage */, "A" /* Administer */];
+  Access2.T = "T" /* Required */;
+})(Access || (Access = {}));
+((Access2) => {
+  Access2.Default = new Access2({
+    rw: Access2.RW,
+    readPriv: "V" /* View */,
+    writePriv: "O" /* Operate */
+  });
+})(Access || (Access = {}));
+//# sourceMappingURL=Access.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/aspects/Access.ts"],
+  "mappings": "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",
+  "names": ["AccessLevel", "Access", "Rw", "Fabric", "Privilege", "PrivilegeName", "Timed"]
+}

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DefinitionError } from "../common/DefinitionError.js";
+/**
+ * An "aspect" is metadata about a Matter element that affects implementation behavior.  Aspects are mostly "qualities"
+ * in the Matter specification except for "constraint" which is not formally described as a quality.
+ */
+export declare abstract class Aspect<D> {
+    definition: D;
+    errors?: DefinitionError[];
+    get valid(): boolean;
+    constructor(definition: D);
+    get empty(): boolean;
+    /**
+     * Test for logical equivalence.
+     */
+    equals(other: any): boolean;
+    valueOf(): string;
+    abstract toString(): string;
+    error(code: string, message: string): void;
+    extend<This extends Aspect<any>>(this: This, other: Exclude<D, "string">): This;
+    freeze(): void;
+}
+//# sourceMappingURL=Aspect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Aspect.d.ts","sourceRoot":"","sources":["../../../src/aspects/Aspect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;GAGG;AACH,8BAAsB,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,CAAC,CAAC;IACN,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAEnC,IAAI,KAAK,YAER;gBAEW,UAAU,EAAE,CAAC;IAIzB,IAAI,KAAK,YAOR;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,GAAG;IAOjB,OAAO;IAKP,QAAQ,CAAC,QAAQ,IAAI,MAAM;IAE3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAWnC,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,GAe9B,IAAI;IAG9C,MAAM;CAGT"}

package/dist/cjs/aspects/Aspect.js

@@ -0,0 +1,87 @@
+"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 Aspect_exports = {};
+__export(Aspect_exports, {
+  Aspect: () => Aspect
+});
+module.exports = __toCommonJS(Aspect_exports);
+var import_general = require("@matter/general");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class Aspect {
+  definition;
+  get valid() {
+    return !this.errors;
+  }
+  constructor(definition) {
+    this.definition = definition;
+  }
+  get empty() {
+    for (const [k, v] of Object.entries(this)) {
+      if (k !== "definition" && v !== void 0) {
+        return false;
+      }
+    }
+    return true;
+  }
+  /**
+   * Test for logical equivalence.
+   */
+  equals(other) {
+    if (!(other instanceof this.constructor)) {
+      return false;
+    }
+    return (0, import_general.isDeepEqual)(this.valueOf(), other.valueOf());
+  }
+  valueOf() {
+    return this.toString();
+  }
+  error(code, message) {
+    if (!this.errors) {
+      this.errors = [];
+    }
+    this.errors.push({
+      code,
+      source: `${this.constructor.name} ${(0, import_general.serialize)(this.definition)}`,
+      message
+    });
+  }
+  extend(other) {
+    const descriptors = [
+      ...Object.entries(Object.getOwnPropertyDescriptors(this)),
+      ...Object.entries(Object.getOwnPropertyDescriptors(other))
+    ];
+    const definition = {};
+    for (const [name, descriptor] of descriptors) {
+      if (name === "definition" || name === "errors" || descriptor.value === void 0) {
+        continue;
+      }
+      definition[name] = descriptor.value;
+    }
+    const constructor = this.constructor;
+    return new constructor(definition);
+  }
+  freeze() {
+    Object.freeze(this);
+  }
+}
+//# sourceMappingURL=Aspect.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/aspects/Aspect.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAuC;AANvC;AAAA;AAAA;AAAA;AAAA;AAaO,MAAe,OAAU;AAAA,EAC5B;AAAA,EAGA,IAAI,QAAQ;AACR,WAAO,CAAC,KAAK;AAAA,EACjB;AAAA,EAEA,YAAY,YAAe;AACvB,SAAK,aAAa;AAAA,EACtB;AAAA,EAEA,IAAI,QAAQ;AACR,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAAI,GAAG;AACvC,UAAI,MAAM,gBAAgB,MAAM,QAAW;AACvC,eAAO;AAAA,MACX;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,OAAY;AACf,QAAI,EAAE,iBAAiB,KAAK,cAAc;AACtC,aAAO;AAAA,IACX;AACA,eAAO,4BAAY,KAAK,QAAQ,GAAG,MAAM,QAAQ,CAAC;AAAA,EACtD;AAAA,EAEA,UAAU;AACN,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA,EAKA,MAAM,MAAc,SAAiB;AACjC,QAAI,CAAC,KAAK,QAAQ;AACd,WAAK,SAAS,CAAC;AAAA,IACnB;AACA,SAAK,OAAO,KAAK;AAAA,MACb;AAAA,MACA,QAAQ,GAAG,KAAK,YAAY,IAAI,QAAI,0BAAU,KAAK,UAAU,CAAC;AAAA,MAC9D;AAAA,IACJ,CAAC;AAAA,EACL;AAAA,EAEA,OAA6C,OAA6B;AACtE,UAAM,cAAc;AAAA,MAChB,GAAG,OAAO,QAAQ,OAAO,0BAA0B,IAAI,CAAC;AAAA,MACxD,GAAG,OAAO,QAAQ,OAAO,0BAA0B,KAAK,CAAC;AAAA,IAC7D;AAEA,UAAM,aAAa,CAAC;AACpB,eAAW,CAAC,MAAM,UAAU,KAAK,aAAa;AAC1C,UAAI,SAAS,gBAAgB,SAAS,YAAY,WAAW,UAAU,QAAW;AAC9E;AAAA,MACJ;AACA,iBAAW,IAAI,IAAI,WAAW;AAAA,IAClC;AAEA,UAAM,cAAc,KAAK;AACzB,WAAO,IAAI,YAAY,UAAU;AAAA,EACrC;AAAA,EAEA,SAAS;AACL,WAAO,OAAO,IAAI;AAAA,EACtB;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,147 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FieldValue } from "../common/index.js";
+import { Aspect } from "./Aspect.js";
+/**
+ * An operational view of conformance as defined by the Matter Specification.
+ *
+ * We extend the specification's syntax to add ">", "<", ">=" and "<=".  These are required to encode some portions of
+ * the specification that are described in prose.
+ *
+ * "Conformance" controls when a data field or cluster element is allowed or required.
+ */
+export declare class Conformance extends Aspect<Conformance.Definition> {
+    ast: Conformance.Ast;
+    get type(): Conformance.Special | Conformance.Flag | Conformance.Operator.NOT | Conformance.Operator.EQ | Conformance.Operator.NE | Conformance.Operator.OR | Conformance.Operator.XOR | Conformance.Operator.AND | Conformance.Operator.GT | Conformance.Operator.LT | Conformance.Operator.GTE | Conformance.Operator.LTE;
+    get empty(): boolean;
+    /**
+     * Initialize from a Conformance.Definition or the conformance DSL defined by the Matter Specification.
+     */
+    constructor(definition: Conformance.Definition);
+    validateReferences(lookup: Conformance.ReferenceResolver<boolean>): void;
+    /**
+     * Is the associated element mandatory?
+     *
+     * This supports a limited subset of conformance and is only appropriate for field and requirement conformance.
+     */
+    get isMandatory(): boolean;
+    /**
+     * Perform limited conformance evaluation to determine whether this conformance is applicable given a feature
+     * combination.
+     *
+     * Ignores subexpressions that reference field values.
+     *
+     * This is useful for filtering elements at compile time.  For complete accuracy you then need to filter at runtime
+     * once field values are known.
+     */
+    isApplicable(features: Iterable<string>, supportedFeatures: Iterable<string>): boolean;
+    toString(): string;
+    freeze(): void;
+}
+export declare namespace Conformance {
+    type AstParam = Ast.Name | Ast.Value | Ast.Option | Ast.UnaryOperand | Ast.BinaryOperands | Ast.Group | Ast.Choice;
+    type Ast = {
+        type: Special.Empty | Special.Desc | Flag;
+    } | {
+        type: Special.Name;
+        param: Ast.Name;
+    } | {
+        type: Special.Value;
+        param: Ast.Value;
+    } | {
+        type: Special.Choice;
+        param: Ast.Choice;
+    } | {
+        type: Special.Group;
+        param: Ast.Group;
+    } | {
+        type: Special.OptionalIf;
+        param: Ast.Option;
+    } | {
+        type: Operator.AND | Operator.OR | Operator.XOR | Operator.EQ | Operator.NE | Operator.LT | Operator.GT | Operator.LTE | Operator.GTE;
+        param: Ast.BinaryOperands;
+    } | {
+        type: Operator.NOT;
+        param: Ast.UnaryOperand;
+    };
+    namespace Ast {
+        type Name = string;
+        type Value = FieldValue;
+        type Option = Ast;
+        type UnaryOperand = Ast;
+        type BinaryOperands = {
+            lhs: Ast;
+            rhs: Ast;
+        };
+        type Group = Ast[];
+        type Choice = {
+            name: ChoiceName;
+            num: number;
+            orMore?: boolean;
+            expr: Ast;
+        };
+    }
+    enum Special {
+        Empty = "empty",
+        Desc = "desc",
+        Name = "name",
+        Value = "value",
+        Choice = "choice",
+        Group = "group",
+        OptionalIf = "optionalIf"
+    }
+    enum Flag {
+        Mandatory = "M",
+        Optional = "O",
+        Provisional = "P",
+        Deprecated = "D",
+        Disallowed = "X"
+    }
+    enum Operator {
+        NOT = "!",
+        EQ = "==",
+        NE = "!=",
+        OR = "|",
+        XOR = "^",
+        AND = "&",
+        DOT = ".",
+        GT = ">",
+        LT = "<",
+        GTE = ">=",
+        LTE = "<="
+    }
+    const M = Flag.Mandatory;
+    const O = Flag.Optional;
+    const P = Flag.Provisional;
+    const D = Flag.Deprecated;
+    const X = Flag.Disallowed;
+    const EQ = Operator.EQ;
+    const NE = Operator.NE;
+    const OR = Operator.OR;
+    const XOR = Operator.XOR;
+    const AND = Operator.AND;
+    const DOT = Operator.DOT;
+    const GT = Operator.GT;
+    const LT = Operator.LT;
+    const GTE = Operator.GTE;
+    const LTE = Operator.LTE;
+    type Name = string;
+    type Number = number;
+    type ChoiceName = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z";
+    type ReferenceResolver<T> = (name: string) => T;
+    /**
+     * Supported ways of expressing conformance (conceptually union should include Flag but that is covered by string).
+     */
+    type Definition = string | string[] | {
+        ast: Conformance.Ast;
+    } | undefined;
+    function validateReferences(conformance: Conformance, ast: Ast, resolver: ReferenceResolver<boolean>): void;
+    function serialize(ast: Ast): string;
+    function isBinaryOperator(type: Ast["type"] | Operator): type is Operator;
+    function precedenceOf(operator: Ast["type"] | Operator): number | undefined;
+    function isHigherPrecedence(operator: Ast["type"] | Operator, other: Ast["type"] | Operator): boolean;
+}
+//# sourceMappingURL=Conformance.d.ts.map

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

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