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

package/dist/cjs/util/String.js

@@ -0,0 +1,208 @@
+"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 String_exports = {};
+__export(String_exports, {
+  camelize: () => camelize,
+  capitalize: () => capitalize,
+  decamelize: () => decamelize,
+  describeList: () => describeList,
+  serialize: () => serialize
+});
+module.exports = __toCommonJS(String_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function capitalize(text) {
+  return text[0].toUpperCase() + text.slice(1);
+}
+function camelize(name, upperFirst = false) {
+  const pieces = new Array();
+  let pieceStart = 0, sawUpper = false, sawLower = false, i = 0;
+  function addPiece(to) {
+    if (pieceStart < to) pieces.push(name.slice(pieceStart, to));
+    sawLower = sawUpper = false;
+  }
+  for (; i < name.length; i++) {
+    if (name[i] >= "A" && name[i] <= "Z") {
+      if (sawLower) {
+        addPiece(i);
+        pieceStart = i;
+      }
+      sawUpper = true;
+      continue;
+    }
+    if (name[i] >= "a" && name[i] <= "z") {
+      if (!sawLower) {
+        if (sawUpper) {
+          addPiece(i - 1);
+          pieceStart = i - 1;
+        }
+      }
+      sawLower = true;
+      continue;
+    }
+    addPiece(i);
+    if (name[i] >= "0" && name[i] <= "9" || name[i] === "$") {
+      pieces.push(name[i]);
+    }
+    pieceStart = i + 1;
+    continue;
+  }
+  addPiece(i);
+  let didFirst = false;
+  let result = pieces.map((piece) => {
+    let firstChar = piece[0];
+    if (upperFirst || didFirst) {
+      firstChar = firstChar.toUpperCase();
+    } else {
+      firstChar = firstChar.toLowerCase();
+      didFirst = true;
+    }
+    return `${firstChar}${piece.slice(1).toLowerCase()}`;
+  }).join("");
+  result = result.replace(/(\d+)Ths/i, "$1ths");
+  return result;
+}
+function decamelize(name, separator = "-") {
+  const result = Array();
+  let needSeparator = false;
+  for (const c of name) {
+    if (c >= "A" && c <= "Z") {
+      if (needSeparator) {
+        result.push(separator);
+        needSeparator = false;
+      }
+      result.push(c.toLowerCase());
+    } else {
+      result.push(c);
+      needSeparator = true;
+    }
+  }
+  return result.join("");
+}
+function serialize(value) {
+  const visited = /* @__PURE__ */ new Set();
+  function asValidKey(key) {
+    if (key.match(/[a-z_$][a-z_$0-9]*/i)) {
+      return key;
+    }
+    return JSON.stringify(key);
+  }
+  function serializeOne(value2) {
+    if (value2 === void 0) {
+      return;
+    }
+    if (value2 === null) {
+      return "null";
+    }
+    if (value2[serialize.SERIALIZE]) {
+      return value2[serialize.SERIALIZE]();
+    }
+    if (typeof value2 === "function") {
+      return;
+    }
+    if (typeof value2 === "bigint" || value2 instanceof BigInt) {
+      return value2.toString();
+    }
+    if (typeof value2 === "number" || value2 instanceof Number) {
+      return value2.toString();
+    }
+    if (typeof value2 === "string" || value2 instanceof String) {
+      return JSON.stringify(value2);
+    }
+    if (typeof value2 === "boolean") {
+      return value2 ? "true" : "false";
+    }
+    if (ArrayBuffer.isView(value2)) {
+      const dv = new DataView(value2.buffer, value2.byteOffset, value2.byteLength);
+      const bytes = Array();
+      for (let i = 0; i < dv.byteLength; i++) {
+        bytes.push(dv.getUint8(i).toString(16).padStart(2, "0"));
+      }
+      return bytes.join("");
+    }
+    if (visited.has(value2)) {
+      return;
+    }
+    if (value2.toJSON) {
+      value2 = JSON.parse(JSON.stringify(value2));
+    }
+    try {
+      visited.add(value2);
+      if (Array.isArray(value2)) {
+        if (value2.length) {
+          return `[ ${value2.map(serializeOne).join(", ")} ]`;
+        }
+        return "[]";
+      }
+      const entries = Object.entries(value2).map(([k, v]) => [k, serializeOne(v)]).filter(([_k, v]) => v !== void 0).map(([k, v]) => `${asValidKey(k ?? "")}: ${v}`);
+      if (!entries.length) {
+        return "{}";
+      }
+      return `{ ${entries.join(", ")} }`;
+    } finally {
+      visited.delete(value2);
+    }
+  }
+  return serializeOne(value);
+}
+((serialize2) => {
+  serialize2.SERIALIZE = Symbol("SERIALIZE");
+  function asIs(value) {
+    if (typeof value === "string") {
+      value = new String(value);
+    }
+    if (value !== void 0 && value !== null) {
+      value[serialize2.SERIALIZE] = function() {
+        return this.toString();
+      };
+    }
+    return value;
+  }
+  serialize2.asIs = asIs;
+  function isPrimitive(value) {
+    if (value === void 0 || value === null || value instanceof Date || ArrayBuffer.isView(value) || value[serialize2.SERIALIZE]) {
+      return true;
+    }
+    if (Array.isArray(value)) {
+      return false;
+    }
+    return typeof value !== "object";
+  }
+  serialize2.isPrimitive = isPrimitive;
+})(serialize || (serialize = {}));
+function describeList(setType, ...entries) {
+  const text = Array();
+  if (entries.length === 1) {
+    return entries[0];
+  }
+  for (let i = 0; i < entries.length; i++) {
+    if (i === entries.length - 1) {
+      text.push(setType, entries[i]);
+    } else if (i === entries.length - 2) {
+      text.push(entries[i]);
+    } else {
+      text.push(`${entries[i]},`);
+    }
+  }
+  return text.join(" ");
+}
+//# sourceMappingURL=String.js.map

package/dist/cjs/util/String.js.map

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

package/dist/cjs/util/Type.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type Properties = {
+    [key: string]: any;
+};
+/** Merges two types into one. */
+export type Merge<A extends Properties, B extends Properties> = {
+    [K in keyof A as K extends keyof B ? never : K]: A[K];
+} & B;
+export declare function Merge<A extends Properties, B extends Properties>(a: A, b: B): Merge<A, B>;
+/** Type that represents a class constructor of a defined type or extend of it */
+export type ClassExtends<C> = {
+    new (...args: any[]): C;
+};
+/** Merge an array of objects into one.  Currently assumes unique elements */
+export type MergeAll<T> = T extends [infer O extends Properties | undefined, ...infer R] ? O extends undefined ? MergeAll<R> : O & MergeAll<R> : T extends [] ? {} : never;
+export declare function MergeAll<T extends (Properties | undefined)[]>(...objects: readonly [...T]): MergeAll<T>;
+/** Pluck an item from an array of objects if present */
+export type Pluck<K, T extends readonly [...any]> = T extends [infer O, ...infer R] ? K extends keyof O ? [O[K], ...Pluck<K, R>] : Pluck<K, R> : T extends [] ? T : never;
+export declare function Pluck<T extends Properties[], K extends keyof T[number]>(key: K, ...objects: readonly [...T]): Pluck<K, T>;
+/** Same as "a == undefined" but keeps the kids happy */
+export declare function isNullish(a: any): boolean;
+export type MakeMandatory<T> = Exclude<T, undefined>;
+/** Create a branded type */
+declare const __brand: unique symbol;
+export type Brand<B> = {
+    [__brand]: B;
+};
+export type Branded<T, B> = T & Brand<B>;
+/**
+ * Make a type immutable.
+ *
+ * TODO - might need to extend depending type (e.g. doesn't handle Maps, Sets or Promises yet)
+ *
+ * Good reference implementation here:
+ *
+ *     https://github.com/ts-essentials/ts-essentials/blob/master/lib/deep-readonly/index.ts
+ */
+export type Immutable<T> = T extends (...args: any[]) => any ? T : T extends number ? T : T extends bigint ? T : T extends object ? {
+    readonly [K in keyof T]: Immutable<T[K]>;
+} : T;
+export type Mutable<T> = T extends (...args: any[]) => any ? T : T extends number ? T : T extends bigint ? T : T extends object ? {
+    -readonly [K in keyof T]: Mutable<T[K]>;
+} : T;
+export declare function Mutable<T>(value: Immutable<T>): Mutable<T>;
+/**
+ * Convert a union to an interface.
+ *
+ * @see {@link https://stackoverflow.com/questions/50374908}
+ */
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * An identity type.
+ *
+ * You can't do:
+ *
+ *     interface Foo extends typeof Bar {}
+ *
+ * But you can do:
+ *
+ *     interface Foo extends Identity<typeof Bar> {}
+ *
+ * Without this type you'd have to do:
+ *
+ *     interface FooType = typeof Bar;
+ *     interface Foo extends FooType {};
+ *
+ * We have to do this a lot because we generate complex objects with detailed
+ * type information.  When exported, TS (as of 5.2) inlines the type of these
+ * objects in declarations which makes our declarations massive.  To avoid this
+ * we create an interface from the type then cast to the interface for export.
+ */
+export type Identity<T> = T;
+/**
+ * Tests whether the given variable is a real object and not an Array
+ * @param it The variable to test
+ * @returns true if it is Record<string, any>
+ */
+export declare function isObject(it: unknown): it is Record<string, unknown>;
+export {};
+//# sourceMappingURL=Type.d.ts.map

package/dist/cjs/util/Type.d.ts.map

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

package/dist/cjs/util/Type.js

@@ -0,0 +1,52 @@
+"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 Type_exports = {};
+__export(Type_exports, {
+  Merge: () => Merge,
+  MergeAll: () => MergeAll,
+  Mutable: () => Mutable,
+  Pluck: () => Pluck,
+  isNullish: () => isNullish,
+  isObject: () => isObject
+});
+module.exports = __toCommonJS(Type_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function Merge(a, b) {
+  return { ...a, ...b };
+}
+function MergeAll(...objects) {
+  return Object.assign({}, ...objects);
+}
+function Pluck(key, ...objects) {
+  return objects.map((o) => o[key]).filter((o) => o !== void 0);
+}
+function isNullish(a) {
+  return a === void 0 || a === null;
+}
+function Mutable(value) {
+  return value;
+}
+function isObject(it) {
+  return Object.prototype.toString.call(it) === "[object Object]";
+}
+//# sourceMappingURL=Type.js.map

package/dist/cjs/util/Type.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Type.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,MAAkD,GAAM,GAAmB;AACvF,SAAO,EAAE,GAAG,GAAG,GAAG,EAAE;AACxB;AAcO,SAAS,YAAkD,SAAuC;AACrG,SAAO,OAAO,OAAO,CAAC,GAAG,GAAG,OAAO;AACvC;AAWO,SAAS,MACZ,QACG,SACQ;AACX,SAAO,QAAQ,IAAI,OAAM,EAAU,GAAG,CAAC,EAAE,OAAO,OAAK,MAAM,MAAS;AACxE;AAGO,SAAS,UAAU,GAAQ;AAC9B,SAAO,MAAM,UAAa,MAAM;AACpC;AA8CO,SAAS,QAAW,OAAiC;AACxD,SAAO;AACX;AAqCO,SAAS,SAAS,IAA4C;AAKjE,SAAO,OAAO,UAAU,SAAS,KAAK,EAAE,MAAM;AAElD;",
+  "names": []
+}

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

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Array.js";
+export * from "./Bytes.js";
+export * from "./Cache.js";
+export * from "./Construction.js";
+export * from "./DataReader.js";
+export * from "./DataReadQueue.js";
+export * from "./DataWriter.js";
+export * from "./DeepCopy.js";
+export * from "./DeepEqual.js";
+export * from "./Error.js";
+export * from "./GeneratedClass.js";
+export * from "./Ip.js";
+export * from "./Lifecycle.js";
+export * from "./Mutex.js";
+export * from "./NamedHandler.js";
+export * from "./Number.js";
+export * from "./Observable.js";
+export * from "./PromiseQueue.js";
+export * from "./Promises.js";
+export * from "./Set.js";
+export * from "./Singleton.js";
+export * from "./Stream.js";
+export * from "./String.js";
+export * from "./Type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/cjs/util/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var util_exports = {};
+module.exports = __toCommonJS(util_exports);
+__reExport(util_exports, require("./Array.js"), module.exports);
+__reExport(util_exports, require("./Bytes.js"), module.exports);
+__reExport(util_exports, require("./Cache.js"), module.exports);
+__reExport(util_exports, require("./Construction.js"), module.exports);
+__reExport(util_exports, require("./DataReader.js"), module.exports);
+__reExport(util_exports, require("./DataReadQueue.js"), module.exports);
+__reExport(util_exports, require("./DataWriter.js"), module.exports);
+__reExport(util_exports, require("./DeepCopy.js"), module.exports);
+__reExport(util_exports, require("./DeepEqual.js"), module.exports);
+__reExport(util_exports, require("./Error.js"), module.exports);
+__reExport(util_exports, require("./GeneratedClass.js"), module.exports);
+__reExport(util_exports, require("./Ip.js"), module.exports);
+__reExport(util_exports, require("./Lifecycle.js"), module.exports);
+__reExport(util_exports, require("./Mutex.js"), module.exports);
+__reExport(util_exports, require("./NamedHandler.js"), module.exports);
+__reExport(util_exports, require("./Number.js"), module.exports);
+__reExport(util_exports, require("./Observable.js"), module.exports);
+__reExport(util_exports, require("./PromiseQueue.js"), module.exports);
+__reExport(util_exports, require("./Promises.js"), module.exports);
+__reExport(util_exports, require("./Set.js"), module.exports);
+__reExport(util_exports, require("./Singleton.js"), module.exports);
+__reExport(util_exports, require("./Stream.js"), module.exports);
+__reExport(util_exports, require("./String.js"), module.exports);
+__reExport(util_exports, require("./Type.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/util/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,yBAAc,uBANd;AAOA,yBAAc,uBAPd;AAQA,yBAAc,uBARd;AASA,yBAAc,8BATd;AAUA,yBAAc,4BAVd;AAWA,yBAAc,+BAXd;AAYA,yBAAc,4BAZd;AAaA,yBAAc,0BAbd;AAcA,yBAAc,2BAdd;AAeA,yBAAc,uBAfd;AAgBA,yBAAc,gCAhBd;AAiBA,yBAAc,oBAjBd;AAkBA,yBAAc,2BAlBd;AAmBA,yBAAc,uBAnBd;AAoBA,yBAAc,8BApBd;AAqBA,yBAAc,wBArBd;AAsBA,yBAAc,4BAtBd;AAuBA,yBAAc,8BAvBd;AAwBA,yBAAc,0BAxBd;AAyBA,yBAAc,qBAzBd;AA0BA,yBAAc,2BA1Bd;AA2BA,yBAAc,wBA3Bd;AA4BA,yBAAc,wBA5Bd;AA6BA,yBAAc,sBA7Bd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/esm/MatterError.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+declare const inspect: unique symbol;
+/**
+ * Error base class for all errors thrown by this library.
+ */
+export declare class MatterError extends Error {
+    /**
+     * Convert the error to formatted text.
+     *
+     * Matter encodes errors with modern JS features including {@link Error#cause} and {@link AggregateError#errors}
+     * subfields.  You can use this function to ensure all error details are presented regardless of environment.
+     */
+    format(format?: "plain" | "ansi" | "html", indents?: number): string;
+    /**
+     * Node.js-style object inspection.
+     *
+     * Node's default inspection only prevents two levels of depth which may hide critical information.  It's also
+     * considerably more verbose than native matter.js formatting.  We therefore offer this custom implementation.
+     *
+     * Note that this conforms to Node's API but is not dependent on Node.
+     */
+    [inspect](depth: number, inspectionOptions?: {
+        colors?: boolean;
+    }): unknown;
+    /**
+     * Rethrow an error unless it is an instance of this class.
+     */
+    static accept<T extends MatterError>(this: new (...args: any[]) => T, error: unknown): asserts error is T;
+    /**
+     * Rethrow an error if it is an instance of this class.
+     */
+    static reject(error: unknown): void;
+    /**
+     * The fallback formatter factory.  This produces a limited plaintext formatter.
+     */
+    static defaultFormatterFactory: () => typeof fallbackFormatter;
+    /**
+     * The error formatter factory.  The default formatter is replaced by Matter.js in ./Format.ts.
+     */
+    static formatterFor: (formatName: string) => (value: unknown, indents?: number) => unknown;
+}
+/**
+ * Error thrown when a Platform specific implementation was not added and so a provider (Network, Time, Crypto, etc)
+ * is not available.
+ */
+export declare class NoProviderError extends MatterError {
+}
+/**
+ * Error thrown when an internal error occurs like unexpected cases or missing data that should be there. Please
+ * report such errors.
+ */
+export declare class InternalError extends MatterError {
+}
+/** Error thrown when a feature is not implemented yet. Please report such errors. */
+export declare class NotImplementedError extends InternalError {
+}
+/** Error thrown when an unexpected case in the matter flow is encountered. Please report such errors. */
+export declare class MatterFlowError extends MatterError {
+}
+/** Error thrown when an unexpected data is encountered. Please report such errors. */
+export declare class UnexpectedDataError extends MatterError {
+}
+/**
+ * Error thrown if most likely an implementation error is detected. Please check and correct your implementation and
+ * provided data. if you are sure your code is correct please report the issue.
+ */
+export declare class ImplementationError extends MatterError {
+}
+/**
+ * Thrown for write attempts against immutable data.
+ */
+export declare class ReadOnlyError extends ImplementationError {
+    constructor(message?: string);
+}
+/**
+ * Thrown for errors that have multiple underlying causes.
+ */
+export declare class MatterAggregateError extends AggregateError {
+    constructor(causes: Iterable<unknown>, message?: string);
+    [inspect]: (depth: number, inspectionOptions?: {
+        colors?: boolean;
+    }) => unknown;
+    format: (format?: "plain" | "ansi" | "html", indents?: number) => string;
+    static [Symbol.hasInstance](instance: unknown): boolean;
+}
+/**
+ * It's never reasonable to fail to present error information so we include this rudimentary fallback error formatter.
+ */
+declare function fallbackFormatter(value: unknown, indents?: number): string;
+export {};
+//# sourceMappingURL=MatterError.d.ts.map

package/dist/esm/MatterError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatterError.d.ts","sourceRoot":"","sources":["../../src/MatterError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,QAAA,MAAM,OAAO,eAA2C,CAAC;AAEzD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,GAAE,OAAO,GAAG,MAAM,GAAG,MAAgB,EAAE,OAAO,SAAI,GAgB1C,MAAM;IAG3B;;;;;;;OAOG;IACH,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;IAcjE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC;IAOzG;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAMnC;;OAEG;IACH,MAAM,CAAC,uBAAuB,iCAA2B;IAEzD;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAClD;CAU3C;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,WAAW;CAAG;AAEnD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,WAAW;CAAG;AAEjD,qFAAqF;AACrF,qBAAa,mBAAoB,SAAQ,aAAa;CAAG;AAEzD,yGAAyG;AACzG,qBAAa,eAAgB,SAAQ,WAAW;CAAG;AAEnD,sFAAsF;AACtF,qBAAa,mBAAoB,SAAQ,WAAW;CAAG;AAEvD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;CAAG;AAEvD;;GAEG;AACH,qBAAa,aAAc,SAAQ,mBAAmB;gBACtC,OAAO,SAA2B;CAGjD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;gBACxC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM;IAKvD,CAAC,OAAO,CAAC,UAnGQ,MAAM,sBAAsB;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,aAmGtB;IAC3C,MAAM,YA/HS,OAAO,GAAG,MAAM,GAAG,MAAM,uBAgBnB,MAAM,CA+GW;WAGtB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO;CAMzD;AAED;;GAEG;AACH,iBAAS,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAI,UA2CrD"}