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

package/dist/esm/util/DataWriter.js

@@ -0,0 +1,94 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Endian } from "./Bytes.js";
+import { toBigInt, toNumber } from "./Number.js";
+class DataWriter {
+  littleEndian;
+  length = 0;
+  chunks = new Array();
+  constructor(endian) {
+    this.littleEndian = endian === Endian.Little;
+  }
+  writeUInt8(value) {
+    this.chunks.push(new Uint8Array([toNumber(value)]));
+    this.length += 1;
+  }
+  writeUInt16(value) {
+    const chunk = new Uint8Array(2);
+    new DataView(chunk.buffer, 0, 2).setUint16(0, toNumber(value), this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 2;
+  }
+  writeUInt32(value) {
+    const chunk = new Uint8Array(4);
+    new DataView(chunk.buffer, 0, 4).setUint32(0, toNumber(value), this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 4;
+  }
+  writeUInt64(value) {
+    const chunk = new Uint8Array(8);
+    new DataView(chunk.buffer, 0, 8).setBigUint64(0, toBigInt(value), this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 8;
+  }
+  writeInt8(value) {
+    const chunk = new Uint8Array(1);
+    new DataView(chunk.buffer, 0, 1).setInt8(0, toNumber(value));
+    this.chunks.push(chunk);
+    this.length += 1;
+  }
+  writeInt16(value) {
+    const chunk = new Uint8Array(2);
+    new DataView(chunk.buffer, 0, 2).setInt16(0, toNumber(value), this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 2;
+  }
+  writeInt32(value) {
+    const chunk = new Uint8Array(4);
+    new DataView(chunk.buffer, 0, 4).setInt32(0, toNumber(value), this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 4;
+  }
+  writeInt64(value) {
+    const chunk = new Uint8Array(8);
+    new DataView(chunk.buffer, 0, 8).setBigInt64(0, toBigInt(value), this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 8;
+  }
+  writeFloat(value) {
+    const chunk = new Uint8Array(4);
+    new DataView(chunk.buffer, 0, 4).setFloat32(0, value, this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 4;
+  }
+  writeDouble(value) {
+    const chunk = new Uint8Array(8);
+    new DataView(chunk.buffer, 0, 8).setFloat64(0, value, this.littleEndian);
+    this.chunks.push(chunk);
+    this.length += 8;
+  }
+  writeByteArray(value) {
+    this.chunks.push(value);
+    this.length += value.byteLength;
+  }
+  toByteArray() {
+    if (this.chunks.length === 0) return new Uint8Array(0);
+    if (this.chunks.length === 1) return this.chunks[0];
+    const result = new Uint8Array(this.length);
+    let offset = 0;
+    this.chunks.forEach((chunk) => {
+      result.set(chunk, offset);
+      offset += chunk.byteLength;
+    });
+    this.chunks.length = 0;
+    this.chunks.push(result);
+    return result;
+  }
+}
+export {
+  DataWriter
+};
+//# sourceMappingURL=DataWriter.js.map

package/dist/esm/util/DataWriter.js.map

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

package/dist/esm/util/DeepCopy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Create a deep copy of a data structure.
+ *
+ * Only copies enumerable properties.  Handles typed arrays and graphs.
+ */
+export declare function deepCopy<T>(value: T): T;
+//# sourceMappingURL=DeepCopy.d.ts.map

package/dist/esm/util/DeepCopy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepCopy.d.ts","sourceRoot":"","sources":["../../../src/util/DeepCopy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAmCvC"}

package/dist/esm/util/DeepCopy.js

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function deepCopy(value) {
+  let clones;
+  function copy(value2) {
+    if (typeof value2 === "object") {
+      if (value2 === null) {
+        return null;
+      }
+      let clone = clones?.get(value2);
+      if (clone) {
+        return clone;
+      }
+      if (Array.isArray(value2)) {
+        clone = value2.map(copy);
+      } else if (ArrayBuffer.isView(value2)) {
+        const ViewType = value2.constructor;
+        clone = new ViewType(value2.buffer.slice(value2.byteOffset, value2.byteOffset + value2.byteLength));
+      } else {
+        clone = Object.fromEntries(Object.entries(value2).map(([k, v]) => [k, copy(v)]));
+      }
+      if (!clones) {
+        clones = /* @__PURE__ */ new Map();
+      }
+      clones.set(value2, clone);
+      return clone;
+    }
+    return value2;
+  }
+  return copy(value);
+}
+export {
+  deepCopy
+};
+//# sourceMappingURL=DeepCopy.js.map

package/dist/esm/util/DeepCopy.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/DeepCopy.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAWO,SAAS,SAAY,OAAa;AACrC,MAAI;AAEJ,WAAS,KAAKA,QAAgB;AAC1B,QAAI,OAAOA,WAAU,UAAU;AAC3B,UAAIA,WAAU,MAAM;AAChB,eAAO;AAAA,MACX;AAEA,UAAI,QAAQ,QAAQ,IAAIA,MAAK;AAC7B,UAAI,OAAO;AACP,eAAO;AAAA,MACX;AAEA,UAAI,MAAM,QAAQA,MAAK,GAAG;AACtB,gBAAQA,OAAM,IAAI,IAAI;AAAA,MAC1B,WAAW,YAAY,OAAOA,MAAK,GAAG;AAClC,cAAM,WAAWA,OAAM;AACvB,gBAAQ,IAAI,SAASA,OAAM,OAAO,MAAMA,OAAM,YAAYA,OAAM,aAAaA,OAAM,UAAU,CAAC;AAAA,MAClG,OAAO;AACH,gBAAQ,OAAO,YAAY,OAAO,QAAQA,MAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAAA,MAClF;AAEA,UAAI,CAAC,QAAQ;AACT,iBAAS,oBAAI,IAAI;AAAA,MACrB;AACA,aAAO,IAAIA,QAAO,KAAK;AAEvB,aAAO;AAAA,IACX;AAEA,WAAOA;AAAA,EACX;AAEA,SAAO,KAAK,KAAK;AACrB;",
+  "names": ["value"]
+}

package/dist/esm/util/DeepEqual.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function isDeepEqual(a: any, b: any): boolean;
+//# sourceMappingURL=DeepEqual.d.ts.map

package/dist/esm/util/DeepEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepEqual.d.ts","sourceRoot":"","sources":["../../../src/util/DeepEqual.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,WAwCzC"}

package/dist/esm/util/DeepEqual.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function isDeepEqual(a, b) {
+  if (a === null || a === void 0 || b === null || b === void 0 || typeof a !== typeof b || typeof a !== "object" && typeof b !== "object") {
+    return a === b;
+  }
+  const aProps = Object.getOwnPropertyNames(a);
+  const bProps = Object.getOwnPropertyNames(b);
+  if (aProps.length !== bProps.length) {
+    return false;
+  }
+  for (let i = 0; i < aProps.length; i++) {
+    const propName = aProps[i];
+    if (typeof a[propName] !== typeof b[propName]) {
+      return false;
+    }
+    if (typeof a[propName] === "object") {
+      if (!isDeepEqual(a[propName], b[propName])) {
+        return false;
+      }
+    } else {
+      if (a[propName] !== b[propName]) {
+        return false;
+      }
+    }
+  }
+  return true;
+}
+export {
+  isDeepEqual
+};
+//# sourceMappingURL=DeepEqual.js.map

package/dist/esm/util/DeepEqual.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/DeepEqual.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,SAAS,YAAY,GAAQ,GAAQ;AACxC,MACI,MAAM,QACN,MAAM,UACN,MAAM,QACN,MAAM,UACN,OAAO,MAAM,OAAO,KACnB,OAAO,MAAM,YAAY,OAAO,MAAM,UACzC;AACE,WAAO,MAAM;AAAA,EACjB;AAEA,QAAM,SAAS,OAAO,oBAAoB,CAAC;AAC3C,QAAM,SAAS,OAAO,oBAAoB,CAAC;AAG3C,MAAI,OAAO,WAAW,OAAO,QAAQ;AACjC,WAAO;AAAA,EACX;AAEA,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACpC,UAAM,WAAW,OAAO,CAAC;AAEzB,QAAI,OAAO,EAAE,QAAQ,MAAM,OAAO,EAAE,QAAQ,GAAG;AAC3C,aAAO;AAAA,IACX;AACA,QAAI,OAAO,EAAE,QAAQ,MAAM,UAAU;AACjC,UAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,EAAE,QAAQ,CAAC,GAAG;AACxC,eAAO;AAAA,MACX;AAAA,IACJ,OAAO;AAEH,UAAI,EAAE,QAAQ,MAAM,EAAE,QAAQ,GAAG;AAC7B,eAAO;AAAA,MACX;AAAA,IACJ;AAAA,EACJ;AAGA,SAAO;AACX;",
+  "names": []
+}

package/dist/esm/util/Error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Ensure that a cause is an error object.
+ *
+ * We consider anything with a "message" property to be a reasonable error object.
+ */
+export declare function errorOf(cause: unknown): Error;
+//# sourceMappingURL=Error.d.ts.map

package/dist/esm/util/Error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Error.d.ts","sourceRoot":"","sources":["../../../src/util/Error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAkB7C"}

package/dist/esm/util/Error.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function errorOf(cause) {
+  if (cause?.construction?.error) {
+    cause = cause?.construction.error;
+  }
+  if (cause === void 0 || cause === null) {
+    return Error("Unknown error");
+  }
+  if (cause.message !== void 0) {
+    return cause;
+  }
+  return new Error(cause.toString());
+}
+export {
+  errorOf
+};
+//# sourceMappingURL=Error.js.map

package/dist/esm/util/Error.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Error.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,QAAQ,OAAuB;AAE3C,MAAK,OAAyB,cAAc,OAAO;AAC/C,YAAS,OAAyB,aAAa;AAAA,EACnD;AAGA,MAAI,UAAU,UAAa,UAAU,MAAM;AACvC,WAAO,MAAM,eAAe;AAAA,EAChC;AAGA,MAAK,MAAgB,YAAY,QAAW;AACxC,WAAO;AAAA,EACX;AAGA,SAAO,IAAI,MAAM,MAAM,SAAS,CAAC;AACrC;",
+  "names": []
+}

package/dist/esm/util/GeneratedClass.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Helper function for class generation.
+ *
+ * This factory does not offer TypeScript types for the resulting class.  You must cast separately.
+ */
+export declare function GeneratedClass(options: GeneratedClass.Options): new (...args: any) => any;
+export declare namespace GeneratedClass {
+    /**
+     * These fields control class behavior.
+     */
+    interface Mixin {
+        /**
+         * A function that performs initialization after instantiation.  "this" will be the object and arguments are the
+         * arguments to the constructor.
+         */
+        initialize?: (...args: any[]) => void;
+        /**
+         * Instance properties.
+         */
+        instanceProperties?: object;
+        /**
+         * Instance properties defined using descriptors.
+         */
+        instanceDescriptors?: PropertyDescriptorMap;
+        /**
+         * Static properties.
+         */
+        staticProperties?: object;
+        /**
+         * Static properties defined using descriptors.
+         */
+        staticDescriptors?: PropertyDescriptorMap;
+    }
+    /**
+     * Input to {@link GeneratedClass}.
+     */
+    interface Options extends Mixin {
+        /**
+         * The name of the class.
+         */
+        name?: string;
+        /**
+         * The base class, if any.
+         */
+        base?: new (...args: any) => any;
+        /**
+         * A preprocessor for arguments.  Derivatives may use this to transform arguments prior to call to super() and
+         * initialize().
+         */
+        args?: (...args: any[]) => any[];
+        /**
+         * Options is a default mixin but you can provide others here.
+         */
+        mixins?: Mixin[];
+    }
+}
+//# sourceMappingURL=GeneratedClass.d.ts.map

package/dist/esm/util/GeneratedClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeneratedClass.d.ts","sourceRoot":"","sources":["../../../src/util/GeneratedClass.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,iBA6LZ,GAAG,KAAK,GAAG,CAzK5D;AAiBD,yBAAiB,cAAc,CAAC;IAC5B;;OAEG;IACH,UAAiB,KAAK;QAClB;;;WAGG;QACH,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QAEtC;;WAEG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAE5B;;WAEG;QACH,mBAAmB,CAAC,EAAE,qBAAqB,CAAC;QAE5C;;WAEG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAE1B;;WAEG;QACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;KAC7C;IAED;;OAEG;IACH,UAAiB,OAAQ,SAAQ,KAAK;QAClC;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;QAEjC;;;WAGG;QACH,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,CAAC;QAEjC;;WAEG;QACH,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;KACpB;CACJ"}

package/dist/esm/util/GeneratedClass.js

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError } from "../MatterError.js";
+function GeneratedClass(options) {
+  const { base: base2, name: name2, args: args2, mixins: mixins2 } = options;
+  const allMixins = mixins2 ? [...mixins2, options] : [options];
+  const type = createConstructor({
+    name: name2 ?? (base2 ? `${base2.name}$` : "GeneratedClass"),
+    base: base2,
+    args: args2,
+    mixins: allMixins
+  });
+  for (const mixin of allMixins) {
+    applyMixin(type, mixin);
+  }
+  return type;
+}
+function applyMixin(constructor, { staticProperties, staticDescriptors, instanceDescriptors }) {
+  if (staticProperties) {
+    Object.assign(constructor, staticProperties);
+  }
+  if (staticDescriptors) {
+    Object.defineProperties(constructor, staticDescriptors);
+  }
+  if (instanceDescriptors) {
+    Object.defineProperties(constructor.prototype, instanceDescriptors);
+  }
+}
+function createConstructor({ name, base, args, mixins }) {
+  const _InternalError = InternalError;
+  _InternalError;
+  if (!name.match(/^(?:\p{L}|[0-9$_])+$/u)) {
+    throw new InternalError("Refusing to generate class with untrustworthy name");
+  }
+  let ext;
+  if (base) {
+    ext = `extends base `;
+  } else {
+    ext = "";
+  }
+  const code = [`class ${name} ${ext}{`];
+  let initialize;
+  let instanceProperties;
+  for (const mixin of mixins) {
+    const mixinInitialize = mixin.initialize;
+    if (mixinInitialize) {
+      if (initialize) {
+        const baseInitialize = initialize;
+        initialize = function(...args2) {
+          baseInitialize.call(this, ...args2);
+          mixinInitialize.call(this, ...args2);
+        };
+      } else {
+        initialize = mixinInitialize;
+      }
+    }
+    if (mixin.instanceProperties) {
+      if (instanceProperties) {
+        instanceProperties = {
+          ...instanceProperties,
+          ...mixin.instanceProperties
+        };
+      } else {
+        instanceProperties = mixin.instanceProperties;
+      }
+    }
+  }
+  if (args || initialize || instanceProperties) {
+    code.push("constructor() {");
+    let argsName;
+    if (args) {
+      argsName = "a";
+      code.push(`const a = args(...arguments)`);
+    } else {
+      argsName = "arguments";
+    }
+    if (base) {
+      code.push(`super(...${argsName})`);
+    }
+    if (instanceProperties) {
+      code.push(`for (const k in instanceProperties) this[k] = instanceProperties[k]`);
+    }
+    if (initialize) {
+      code.push(`initialize.apply(this, ${argsName})`);
+    }
+    code.push("}");
+  }
+  code.push("}", name);
+  return eval(code.join("\n"));
+}
+export {
+  GeneratedClass
+};
+//# sourceMappingURL=GeneratedClass.js.map

package/dist/esm/util/GeneratedClass.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/GeneratedClass.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,qBAAqB;AAOvB,SAAS,eAAe,SAAiC;AAC5D,QAAM,EAAE,MAAAA,OAAM,MAAAC,OAAM,MAAAC,OAAM,QAAAC,QAAO,IAAI;AAGrC,QAAM,YAAYA,UAAS,CAAC,GAAGA,SAAQ,OAAO,IAAI,CAAC,OAAO;AAG1D,QAAM,OAAO,kBAAkB;AAAA,IAC3B,MAAMF,UAASD,QAAO,GAAGA,MAAK,IAAI,MAAM;AAAA,IACxC,MAAAA;AAAA,IACA,MAAAE;AAAA,IACA,QAAQ;AAAA,EACZ,CAAC;AAGD,aAAW,SAAS,WAAW;AAC3B,eAAW,MAAM,KAAK;AAAA,EAC1B;AAEA,SAAO;AACX;AAEA,SAAS,WACL,aACA,EAAE,kBAAkB,mBAAmB,oBAAoB,GAC7D;AACE,MAAI,kBAAkB;AAClB,WAAO,OAAO,aAAa,gBAAgB;AAAA,EAC/C;AACA,MAAI,mBAAmB;AACnB,WAAO,iBAAiB,aAAa,iBAAiB;AAAA,EAC1D;AACA,MAAI,qBAAqB;AACrB,WAAO,iBAAiB,YAAY,WAAW,mBAAmB;AAAA,EACtE;AACJ;AAoEA,SAAS,kBAAkB,EAAE,MAAM,MAAM,MAAM,OAAO,GAAuB;AAEzE,QAAM,iBAAiB;AACvB;AAOA,MAAI,CAAC,KAAK,MAAM,uBAAuB,GAAG;AACtC,UAAM,IAAI,cAAc,oDAAoD;AAAA,EAChF;AAEA,MAAI;AACJ,MAAI,MAAM;AACN,UAAM;AAAA,EACV,OAAO;AACH,UAAM;AAAA,EACV;AAEA,QAAM,OAAO,CAAC,SAAS,IAAI,IAAI,GAAG,GAAG;AAGrC,MAAI;AACJ,MAAI;AAEJ,aAAW,SAAS,QAAQ;AACxB,UAAM,kBAAkB,MAAM;AAG9B,QAAI,iBAAiB;AACjB,UAAI,YAAY;AACZ,cAAM,iBAAiB;AACvB,qBAAa,YAAwBA,OAAM;AACvC,yBAAe,KAAK,MAAM,GAAGA,KAAI;AACjC,0BAAgB,KAAK,MAAM,GAAGA,KAAI;AAAA,QACtC;AAAA,MACJ,OAAO;AACH,qBAAa;AAAA,MACjB;AAAA,IACJ;AAGA,QAAI,MAAM,oBAAoB;AAC1B,UAAI,oBAAoB;AACpB,6BAAqB;AAAA,UACjB,GAAG;AAAA,UACH,GAAG,MAAM;AAAA,QACb;AAAA,MACJ,OAAO;AACH,6BAAqB,MAAM;AAAA,MAC/B;AAAA,IACJ;AAAA,EACJ;AAGA,MAAI,QAAQ,cAAc,oBAAoB;AAC1C,SAAK,KAAK,iBAAiB;AAE3B,QAAI;AACJ,QAAI,MAAM;AACN,iBAAW;AACX,WAAK,KAAK,8BAA8B;AAAA,IAC5C,OAAO;AACH,iBAAW;AAAA,IACf;AAEA,QAAI,MAAM;AACN,WAAK,KAAK,YAAY,QAAQ,GAAG;AAAA,IACrC;AAEA,QAAI,oBAAoB;AAEpB,WAAK,KAAK,qEAAqE;AAAA,IACnF;AAEA,QAAI,YAAY;AACZ,WAAK,KAAK,0BAA0B,QAAQ,GAAG;AAAA,IACnD;AAEA,SAAK,KAAK,GAAG;AAAA,EACjB;AAEA,OAAK,KAAK,KAAK,IAAI;AAEnB,SAAO,KAAK,KAAK,KAAK,IAAI,CAAC;AAC/B;",
+  "names": ["base", "name", "args", "mixins"]
+}

package/dist/esm/util/Introspection.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Utilities for object introspection.
+ */
+export declare namespace Introspection {
+    /**
+     * Obtain a {@link PropertyDescriptor} from any level in {@link subject}'s
+     * prototype chain.
+     */
+    function propertyDescriptorOf(subject: object, name: string): PropertyDescriptor | undefined;
+    /**
+     * Obtain {@link PropertyDescriptor}s from properties in any level of
+     * {@link subject}'s prototype chain.
+     */
+    function propertyDescriptorsOf(subject: object): Record<string, PropertyDescriptor>;
+    /**
+     * Determine whether a single property of {@link subject} is readable
+     * and/or writable.
+     */
+    function propertyAccessibilityOf(subject: object, name: string): PropertyAccessibility;
+    /**
+     * Obtain properties from {@link subject} and whether they're readable
+     * and/or writable.
+     */
+    function objectAccessibilityOf(subject: object): ObjectAccessibilty;
+    function propertyDescriptorToAccessibility(pd: PropertyDescriptor): PropertyAccessibility;
+    interface PropertyAccessibility {
+        readable: boolean;
+        writable: boolean;
+    }
+    interface ObjectAccessibilty extends Record<string, PropertyAccessibility> {
+    }
+}
+//# sourceMappingURL=Introspection.d.ts.map

package/dist/esm/util/Introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Introspection.d.ts","sourceRoot":"","sources":["../../../src/util/Introspection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,yBAAiB,aAAa,CAAC;IAC3B;;;OAGG;IACH,SAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CASlG;IAED;;;OAGG;IACH,SAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,sCAqBpD;IAED;;;OAGG;IACH,SAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,yBAMpE;IAED;;;OAGG;IACH,SAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,sBASpD;IAED,SAAgB,iCAAiC,CAAC,EAAE,EAAE,kBAAkB,GAAG,qBAAqB,CAK/F;IAED,UAAiB,qBAAqB;QAClC,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;KACrB;IAED,UAAiB,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC;KAAG;CACvF"}

package/dist/esm/util/Introspection.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Introspection;
+((Introspection2) => {
+  function propertyDescriptorOf(subject, name) {
+    const descriptor = Reflect.getOwnPropertyDescriptor(subject, name);
+    if (descriptor) {
+      return descriptor;
+    }
+    const prototype = Reflect.getPrototypeOf(subject);
+    if (prototype !== null) {
+      return Introspection2.propertyDescriptorOf(prototype, name);
+    }
+  }
+  Introspection2.propertyDescriptorOf = propertyDescriptorOf;
+  function propertyDescriptorsOf(subject) {
+    const descriptors = {};
+    function addDescriptors(subject2) {
+      const localDescriptors = Object.getOwnPropertyDescriptors(subject2);
+      for (const name in localDescriptors) {
+        if (descriptors[name] === void 0) {
+          descriptors[name] = localDescriptors[name];
+        }
+      }
+      const prototype = Reflect.getPrototypeOf(subject2);
+      if (prototype !== null) {
+        addDescriptors(prototype);
+      }
+    }
+    addDescriptors(subject);
+    return descriptors;
+  }
+  Introspection2.propertyDescriptorsOf = propertyDescriptorsOf;
+  function propertyAccessibilityOf(subject, name) {
+    const pd = propertyDescriptorOf(subject, name);
+    if (pd) {
+      return propertyDescriptorToAccessibility(pd);
+    }
+    return { readable: true, writable: true };
+  }
+  Introspection2.propertyAccessibilityOf = propertyAccessibilityOf;
+  function objectAccessibilityOf(subject) {
+    const accessibilty = {};
+    const propertyDescriptors = Introspection2.propertyDescriptorsOf(subject);
+    for (const name in propertyDescriptors) {
+      accessibilty[name] = propertyDescriptorToAccessibility(propertyDescriptors[name]);
+    }
+    return accessibilty;
+  }
+  Introspection2.objectAccessibilityOf = objectAccessibilityOf;
+  function propertyDescriptorToAccessibility(pd) {
+    return {
+      readable: !!(pd.set && !pd.get),
+      writable: !!(pd.set || pd.writable)
+    };
+  }
+  Introspection2.propertyDescriptorToAccessibility = propertyDescriptorToAccessibility;
+})(Introspection || (Introspection = {}));
+export {
+  Introspection
+};
+//# sourceMappingURL=Introspection.js.map

package/dist/esm/util/Introspection.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Introspection.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAU;AAAA,CAAV,CAAUA,mBAAV;AAKI,WAAS,qBAAqB,SAAiB,MAA8C;AAChG,UAAM,aAAa,QAAQ,yBAAyB,SAAS,IAAI;AACjE,QAAI,YAAY;AACZ,aAAO;AAAA,IACX;AACA,UAAM,YAAY,QAAQ,eAAe,OAAO;AAChD,QAAI,cAAc,MAAM;AACpB,aAAOA,eAAc,qBAAqB,WAAW,IAAI;AAAA,IAC7D;AAAA,EACJ;AATO,EAAAA,eAAS;AAeT,WAAS,sBAAsB,SAAiB;AACnD,UAAM,cAAc,CAAC;AAErB,aAAS,eAAeC,UAAiB;AACrC,YAAM,mBAAmB,OAAO,0BAA0BA,QAAO;AAEjE,iBAAW,QAAQ,kBAAkB;AACjC,YAAI,YAAY,IAAI,MAAM,QAAW;AACjC,sBAAY,IAAI,IAAI,iBAAiB,IAAI;AAAA,QAC7C;AAAA,MACJ;AAEA,YAAM,YAAY,QAAQ,eAAeA,QAAO;AAChD,UAAI,cAAc,MAAM;AACpB,uBAAe,SAAS;AAAA,MAC5B;AAAA,IACJ;AAEA,mBAAe,OAAO;AAEtB,WAAO;AAAA,EACX;AArBO,EAAAD,eAAS;AA2BT,WAAS,wBAAwB,SAAiB,MAAc;AACnE,UAAM,KAAK,qBAAqB,SAAS,IAAI;AAC7C,QAAI,IAAI;AACJ,aAAO,kCAAkC,EAAE;AAAA,IAC/C;AACA,WAAO,EAAE,UAAU,MAAM,UAAU,KAAK;AAAA,EAC5C;AANO,EAAAA,eAAS;AAYT,WAAS,sBAAsB,SAAiB;AACnD,UAAM,eAAe,CAAC;AAEtB,UAAM,sBAAsBA,eAAc,sBAAsB,OAAO;AACvE,eAAW,QAAQ,qBAAqB;AACpC,mBAAa,IAAI,IAAI,kCAAkC,oBAAoB,IAAI,CAAC;AAAA,IACpF;AAEA,WAAO;AAAA,EACX;AATO,EAAAA,eAAS;AAWT,WAAS,kCAAkC,IAA+C;AAC7F,WAAO;AAAA,MACH,UAAU,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG;AAAA,MAC3B,UAAU,CAAC,EAAE,GAAG,OAAO,GAAG;AAAA,IAC9B;AAAA,EACJ;AALO,EAAAA,eAAS;AAAA,GAtEH;",
+  "names": ["Introspection", "subject"]
+}

package/dist/esm/util/Ip.d.ts

@@ -0,0 +1,8 @@
+export declare function isIPv4(ip: string): boolean;
+export declare function isIPv6(ip: string): boolean;
+export declare function ipv4ToNumber(ip: string): number;
+export declare function ipv4ToBytes(ip: string): Uint8Array;
+export declare function ipv6ToArray(ip: string): Uint16Array;
+export declare function ipv6ToBytes(ip: string): Uint8Array;
+export declare function onSameNetwork(ip1: string, ip2: string, mask: string): boolean | undefined;
+//# sourceMappingURL=Ip.d.ts.map

package/dist/esm/util/Ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ip.d.ts","sourceRoot":"","sources":["../../../src/util/Ip.ts"],"names":[],"mappings":"AAOA,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,WAEhC;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,WAEhC;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,UAGtC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,cAOrC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,eAarC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,cAErC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,uBAsBnE"}

package/dist/esm/util/Ip.js

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "./Bytes.js";
+function isIPv4(ip) {
+  return ip.includes(".");
+}
+function isIPv6(ip) {
+  return ip.includes(":");
+}
+function ipv4ToNumber(ip) {
+  const dataView = Bytes.dataViewOf(ipv4ToBytes(ip));
+  return dataView.getUint32(0);
+}
+function ipv4ToBytes(ip) {
+  const array = new Uint8Array(4);
+  const ipParts = ip.split(".");
+  for (let i = 0; i < 4; i++) {
+    array[i] = parseInt(ipParts[i]);
+  }
+  return array;
+}
+function ipv6ToArray(ip) {
+  const array = new Uint16Array(8);
+  let ipParts = ip.split(":");
+  const valueCount = ipParts.filter((value) => value !== "").length;
+  if (valueCount !== 8) {
+    ipParts = ip.replace("::", ":".padEnd((8 - valueCount) * 2 + 1, "0:")).split(":");
+  }
+  let index = 0;
+  ipParts.forEach((part) => {
+    if (part === "") return;
+    array[index++] = parseInt(part, 16);
+  });
+  return array;
+}
+function ipv6ToBytes(ip) {
+  return Uint8Array.from(Array.from(ipv6ToArray(ip)).flatMap((value) => [value >> 8, value & 255]));
+}
+function onSameNetwork(ip1, ip2, mask) {
+  if (isIPv4(ip1)) {
+    if (!isIPv4(ip2) || !isIPv4(mask)) return false;
+    const ip1Number = ipv4ToNumber(ip1);
+    const ip2Number = ipv4ToNumber(ip2);
+    const maskNumber = ipv4ToNumber(mask);
+    return (ip1Number & maskNumber) === (ip2Number & maskNumber);
+  } else {
+    if (isIPv4(ip2) || isIPv4(mask)) return false;
+    const ip1Array = ipv6ToArray(ip1);
+    const ip2Array = ipv6ToArray(ip2);
+    const maskArray = ipv6ToArray(mask);
+    for (let i = 0; i < 16; i++) {
+      const mask2 = maskArray[i];
+      if (mask2 === 0) return true;
+      if ((ip1Array[i] & mask2) !== (ip2Array[i] & mask2)) return false;
+    }
+  }
+}
+export {
+  ipv4ToBytes,
+  ipv4ToNumber,
+  ipv6ToArray,
+  ipv6ToBytes,
+  isIPv4,
+  isIPv6,
+  onSameNetwork
+};
+//# sourceMappingURL=Ip.js.map

package/dist/esm/util/Ip.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Ip.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,SAAS,aAAa;AAEf,SAAS,OAAO,IAAY;AAC/B,SAAO,GAAG,SAAS,GAAG;AAC1B;AAEO,SAAS,OAAO,IAAY;AAC/B,SAAO,GAAG,SAAS,GAAG;AAC1B;AAEO,SAAS,aAAa,IAAY;AACrC,QAAM,WAAW,MAAM,WAAW,YAAY,EAAE,CAAC;AACjD,SAAO,SAAS,UAAU,CAAC;AAC/B;AAEO,SAAS,YAAY,IAAY;AACpC,QAAM,QAAQ,IAAI,WAAW,CAAC;AAC9B,QAAM,UAAU,GAAG,MAAM,GAAG;AAC5B,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AACxB,UAAM,CAAC,IAAI,SAAS,QAAQ,CAAC,CAAC;AAAA,EAClC;AACA,SAAO;AACX;AAEO,SAAS,YAAY,IAAY;AACpC,QAAM,QAAQ,IAAI,YAAY,CAAC;AAC/B,MAAI,UAAU,GAAG,MAAM,GAAG;AAC1B,QAAM,aAAa,QAAQ,OAAO,WAAS,UAAU,EAAE,EAAE;AACzD,MAAI,eAAe,GAAG;AAClB,cAAU,GAAG,QAAQ,MAAM,IAAI,QAAQ,IAAI,cAAc,IAAI,GAAG,IAAI,CAAC,EAAE,MAAM,GAAG;AAAA,EACpF;AACA,MAAI,QAAQ;AACZ,UAAQ,QAAQ,UAAQ;AACpB,QAAI,SAAS,GAAI;AACjB,UAAM,OAAO,IAAI,SAAS,MAAM,EAAE;AAAA,EACtC,CAAC;AACD,SAAO;AACX;AAEO,SAAS,YAAY,IAAY;AACpC,SAAO,WAAW,KAAK,MAAM,KAAK,YAAY,EAAE,CAAC,EAAE,QAAQ,WAAS,CAAC,SAAS,GAAG,QAAQ,GAAI,CAAC,CAAC;AACnG;AAEO,SAAS,cAAc,KAAa,KAAa,MAAc;AAClE,MAAI,OAAO,GAAG,GAAG;AAEb,QAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAG,QAAO;AAC1C,UAAM,YAAY,aAAa,GAAG;AAClC,UAAM,YAAY,aAAa,GAAG;AAClC,UAAM,aAAa,aAAa,IAAI;AAEpC,YAAQ,YAAY,iBAAiB,YAAY;AAAA,EACrD,OAAO;AAEH,QAAI,OAAO,GAAG,KAAK,OAAO,IAAI,EAAG,QAAO;AACxC,UAAM,WAAW,YAAY,GAAG;AAChC,UAAM,WAAW,YAAY,GAAG;AAChC,UAAM,YAAY,YAAY,IAAI;AAElC,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AACzB,YAAMA,QAAO,UAAU,CAAC;AACxB,UAAIA,UAAS,EAAG,QAAO;AACvB,WAAK,SAAS,CAAC,IAAIA,YAAW,SAAS,CAAC,IAAIA,OAAO,QAAO;AAAA,IAC9D;AAAA,EACJ;AACJ;",
+  "names": ["mask"]
+}