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

package/dist/cjs/environment/RuntimeService.js

@@ -0,0 +1,222 @@
+"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 RuntimeService_exports = {};
+__export(RuntimeService_exports, {
+  RuntimeService: () => RuntimeService
+});
+module.exports = __toCommonJS(RuntimeService_exports);
+var import_Diagnostic = require("../log/Diagnostic.js");
+var import_DiagnosticSource = require("../log/DiagnosticSource.js");
+var import_Logger = require("../log/Logger.js");
+var import_Lifecycle = require("../util/Lifecycle.js");
+var import_Observable = require("../util/Observable.js");
+var import_Environmental = require("./Environmental.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_Logger.Logger.get("Runtime");
+class RuntimeService {
+  #workers = /* @__PURE__ */ new Set();
+  #cancelled = /* @__PURE__ */ new Set();
+  #workerDeleted = (0, import_Observable.Observable)();
+  #canceled = false;
+  #started = (0, import_Observable.Observable)();
+  #stopped = (0, import_Observable.Observable)();
+  #crashed = (0, import_Observable.Observable)();
+  constructor(environment) {
+    environment.set(RuntimeService, this);
+    import_DiagnosticSource.DiagnosticSource.add(this);
+  }
+  /**
+   * Add a {@link Worker}.
+   *
+   * The runtime considers itself "active" if there are one or more workers installed.
+   *
+   * A worker must either be {@link PromiseLike} or {@link Constructable} for the runtime to detect completion. On
+   * completion the worker is removed and destroyed if the worker is {@link Destructable}.
+   *
+   * Once added, the {@link worker} is owned by the RuntimeService until closed, resolved or removed via
+   * {@link delete}.
+   */
+  add(worker) {
+    if (!worker) {
+      return;
+    }
+    if (this.#workers.has(worker)) {
+      return;
+    }
+    this.#workers.add(worker);
+    if (this.#workers.size === 1) {
+      this.#started.emit();
+    }
+    if (worker.then) {
+      Promise.resolve(worker).catch((error) => this.#crash(error)).finally(() => this.delete(worker));
+      return;
+    }
+    if (worker.construction?.change) {
+      worker.construction.change.on((status) => {
+        switch (status) {
+          case import_Lifecycle.Lifecycle.Status.Crashed:
+            this.#crash();
+            break;
+          case import_Lifecycle.Lifecycle.Status.Destroyed:
+            this.delete(worker);
+            break;
+        }
+      });
+    } else if (worker.then) {
+      if (worker.then) {
+        Promise.resolve(worker).catch((error) => this.#crash(error)).finally(() => this.delete(worker));
+      }
+    }
+  }
+  /**
+   * Remove a worker.
+   */
+  delete(worker) {
+    if (!this.#workers.has(worker)) {
+      return;
+    }
+    this.#workers.delete(worker);
+    this.#cancelled.delete(worker);
+    this.#workerDeleted.emit();
+    if (this.#workers.size) {
+      return;
+    }
+    this.cancel();
+    void this.inactive.finally(() => this.#stopped.emit());
+  }
+  /**
+   * Emits when a worker is added when previously there were none.
+   */
+  get started() {
+    return this.#started;
+  }
+  /**
+   * Emits when the last worker departs.
+   */
+  get stopped() {
+    return this.#stopped;
+  }
+  /**
+   * Emits when a worker experiences an unhandled error.
+   */
+  get crashed() {
+    return this.#crashed;
+  }
+  static [import_Environmental.Environmental.create](environment) {
+    return new this(environment);
+  }
+  /**
+   * Cancel execution.
+   *
+   * On cancel the runtime destroys all workers.
+   */
+  cancel() {
+    if (this.#canceled) {
+      return;
+    }
+    this.#canceled = true;
+    logger.notice("Shutting down");
+    for (const worker of this.#workers) {
+      const disposal = this.#cancelWorker(worker);
+      if (disposal) {
+        this.add(disposal);
+      }
+    }
+  }
+  /**
+   * Resolves when no workers are active.
+   */
+  get inactive() {
+    if (!this.#workers.size) {
+      return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+      const listener = () => {
+        if (!this.#workers.size) {
+          this.#workerDeleted.off(listener);
+          resolve();
+        }
+      };
+      this.#workerDeleted.on(listener);
+    });
+  }
+  async close() {
+    this.cancel();
+    await this.inactive;
+    import_DiagnosticSource.DiagnosticSource.delete(this);
+  }
+  [Symbol.asyncDispose]() {
+    return this.close();
+  }
+  get [import_Diagnostic.Diagnostic.value]() {
+    return import_Diagnostic.Diagnostic.node("\u{1F6E0}", "Workers", {
+      children: [...this.#workers].map((worker) => {
+        let diagnostic = worker[RuntimeService.label];
+        if (diagnostic === void 0) {
+          diagnostic = worker[import_Diagnostic.Diagnostic.value];
+          if (diagnostic === void 0) {
+            diagnostic = worker.toString();
+          }
+        }
+        return diagnostic;
+      })
+    });
+  }
+  #cancelWorker(worker) {
+    if (this.#cancelled.has(worker)) {
+      return;
+    }
+    const cancel = () => {
+      this.#cancelled.add(worker);
+      if (worker.close) {
+        this.#cancelled.add(worker);
+        return Promise.resolve(worker.close()).finally(() => this.delete(worker));
+      }
+      if (worker[Symbol.asyncDispose]) {
+        this.#cancelled.add(worker);
+        return Promise.resolve(worker[Symbol.asyncDispose]?.()).finally(() => this.delete(worker));
+      }
+      if (worker[Symbol.dispose]) {
+        worker[Symbol.dispose]?.();
+        this.delete(worker);
+        return;
+      }
+    };
+    if (worker.construction) {
+      worker.construction.onSuccess(cancel);
+      return;
+    }
+    return cancel();
+  }
+  #crash(cause) {
+    if (cause) {
+      logger.error(cause);
+    }
+    this.crashed.emit(cause);
+    this.cancel();
+  }
+}
+((RuntimeService2) => {
+  RuntimeService2.label = Symbol("label");
+})(RuntimeService || (RuntimeService = {}));
+//# sourceMappingURL=RuntimeService.js.map

package/dist/cjs/environment/RuntimeService.js.map

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

package/dist/cjs/environment/VariableService.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic } from "../log/Diagnostic.js";
+import type { Environment } from "./Environment.js";
+import { Environmental } from "./Environmental.js";
+/**
+ * Environmental configuration values.
+ */
+export declare class VariableService {
+    #private;
+    constructor(environment: Environment);
+    static [Environmental.create](environment: Environment): VariableService;
+    get [Diagnostic.value](): string;
+    get vars(): VariableService.Map;
+    /**
+     * Configure a component.
+     *
+     * Runs the supplied {@link configurator} immediately and whenever variables reference by the {@link configurator}
+     * change.
+     *
+     * To terminate reconfiguration invoke {@link VariableService.Usage.close} on the return value.
+     */
+    use(configurator: () => void): VariableService.Usage;
+    get<T extends VariableService.Primitive>(name: string, fallback?: T): T;
+    get<T extends VariableService.Value>(name: string, fallback: T): T;
+    get<T extends VariableService.Value>(name: string): T | undefined;
+    has(name: string): boolean;
+    set(name: string, value: VariableService.Value): void;
+    string(name: string): string;
+    boolean(name: string): boolean;
+    number(name: string): number | undefined;
+    integer(name: string, fallback?: number): number | undefined;
+    increment(name: string): number;
+    addConfigStyle(vars: VariableService.Map): void;
+    addUnixEnvStyle(vars: Record<string, string | undefined>): void;
+    addArgvStyle(vars: string[]): void;
+}
+export declare namespace VariableService {
+    interface Options {
+        unixEnvStyle?: Record<string, string>;
+        argvStyle?: string[];
+        configStyle?: Map;
+    }
+    interface Map extends Record<string, Value> {
+    }
+    type List = Value[];
+    type Primitive = number | string | boolean;
+    type Value = Primitive | Map | List;
+    interface Usage {
+        variables: Set<string>;
+        configurator(): void;
+        close(): void;
+    }
+}
+//# sourceMappingURL=VariableService.d.ts.map

package/dist/cjs/environment/VariableService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableService.d.ts","sourceRoot":"","sources":["../../../src/environment/VariableService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,eAAe;;gBAKZ,WAAW,EAAE,WAAW;IAIpC,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,WAAW;IAItD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,WAErB;IAED,IAAI,IAAI,wBAEP;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK;IAqBpD,GAAG,CAAC,CAAC,SAAS,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC;IAEvE,GAAG,CAAC,CAAC,SAAS,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAElE,GAAG,CAAC,CAAC,SAAS,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IA4BjE,GAAG,CAAC,IAAI,EAAE,MAAM;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK;IA2B9C,MAAM,CAAC,IAAI,EAAE,MAAM;IAcnB,OAAO,CAAC,IAAI,EAAE,MAAM;IAkBpB,MAAM,CAAC,IAAI,EAAE,MAAM;IAcnB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAOvC,SAAS,CAAC,IAAI,EAAE,MAAM;IAMtB,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,GAAG;IAmBxC,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAIxD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE;CAgB9B;AAED,yBAAiB,eAAe,CAAC;IAC7B,UAAiB,OAAO;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,GAAG,CAAC;KACrB;IAED,UAAiB,GAAI,SAAQ,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;KAAG;IACrD,KAAY,IAAI,GAAG,KAAK,EAAE,CAAC;IAC3B,KAAY,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClD,KAAY,KAAK,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC;IAC3C,UAAiB,KAAK;QAClB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,YAAY,IAAI,IAAI,CAAC;QACrB,KAAK,IAAI,IAAI,CAAC;KACjB;CACJ"}

package/dist/cjs/environment/VariableService.js

@@ -0,0 +1,257 @@
+"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 VariableService_exports = {};
+__export(VariableService_exports, {
+  VariableService: () => VariableService
+});
+module.exports = __toCommonJS(VariableService_exports);
+var import_MatterError = require("../MatterError.js");
+var import_Diagnostic = require("../log/Diagnostic.js");
+var import_Type = require("../util/Type.js");
+var import_Environmental = require("./Environmental.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class VariableService {
+  #vars = {};
+  #usageCollectors = Array();
+  #usages = /* @__PURE__ */ new Set();
+  constructor(environment) {
+    environment.set(VariableService, this);
+  }
+  static [import_Environmental.Environmental.create](environment) {
+    return new this(environment);
+  }
+  get [import_Diagnostic.Diagnostic.value]() {
+    return "Configuration";
+  }
+  get vars() {
+    return this.#vars;
+  }
+  /**
+   * Configure a component.
+   *
+   * Runs the supplied {@link configurator} immediately and whenever variables reference by the {@link configurator}
+   * change.
+   *
+   * To terminate reconfiguration invoke {@link VariableService.Usage.close} on the return value.
+   */
+  use(configurator) {
+    const variables = /* @__PURE__ */ new Set();
+    try {
+      this.#usageCollectors.push(variables);
+      configurator();
+    } finally {
+      this.#usageCollectors.pop();
+    }
+    const usage = {
+      variables,
+      configurator,
+      close: () => {
+        this.#usages.delete(usage);
+      }
+    };
+    this.#usages.add(usage);
+    return usage;
+  }
+  get(name, fallback) {
+    for (const collector of this.#usageCollectors) {
+      collector.add(name);
+    }
+    switch (typeof fallback) {
+      case "string":
+        return this.string(name) ?? fallback;
+      case "number":
+        return this.number(name) ?? fallback;
+      case "boolean":
+        return this.boolean(name) ?? fallback;
+    }
+    let value = this.#vars;
+    for (const segment of this.#parseName(name)) {
+      if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return fallback;
+      }
+      value = value[segment];
+    }
+    return value ?? fallback;
+  }
+  has(name) {
+    return this.get(name) !== void 0;
+  }
+  set(name, value) {
+    const segments = name.toLowerCase().split(".");
+    const key = segments.pop();
+    let parent = this.#vars;
+    for (const segment of segments) {
+      let nextParent = parent[segment];
+      if (nextParent === void 0 || nextParent === null) {
+        nextParent = parent[segment] = {};
+      } else if (typeof nextParent !== "object" || Array.isArray(nextParent)) {
+        throw new import_MatterError.ImplementationError(`Can't set ${name} because segment ${segment} is not a map`);
+      }
+      parent = nextParent;
+    }
+    if (parent[key] === value) {
+      return;
+    }
+    parent[key] = value;
+    for (const usage of this.#usages) {
+      if (usage.variables.has(name)) {
+        usage.configurator();
+      }
+    }
+  }
+  string(name) {
+    const value = this.get(name);
+    if (value === void 0) {
+      return value;
+    }
+    if (typeof value === "string") {
+      return value;
+    }
+    if (value === null) {
+      return "null";
+    }
+    return value.toString();
+  }
+  boolean(name) {
+    const value = this.get(name);
+    switch (value) {
+      case void 0:
+        return value;
+      case null:
+      case 0:
+      case false:
+      case "false":
+      case "off":
+        return false;
+      default:
+        return true;
+    }
+  }
+  number(name) {
+    let value = this.get(name);
+    if (typeof value === "number") {
+      return value;
+    }
+    if (typeof value === "string") {
+      value = Number.parseFloat(value);
+      if (Number.isNaN(value)) {
+        return;
+      }
+      return value;
+    }
+  }
+  integer(name, fallback) {
+    const number = this.number(name) ?? fallback;
+    if (typeof number === "number") {
+      return Math.floor(number);
+    }
+  }
+  increment(name) {
+    const value = this.integer(name) ?? 0;
+    this.set(name, value + 1);
+    return value;
+  }
+  addConfigStyle(vars) {
+    const path = Array();
+    const add = (vars2) => {
+      for (const name in vars2) {
+        const val = vars2[name];
+        if ((0, import_Type.isObject)(val)) {
+          path.push(name);
+          add(val);
+          path.pop();
+        } else {
+          this.set([...path, name].join("."), val);
+        }
+      }
+    };
+    add(vars);
+  }
+  addUnixEnvStyle(vars) {
+    this.addConfigStyle(parseUnixStyle(vars));
+  }
+  addArgvStyle(vars) {
+    this.addConfigStyle(parseArgvStyle(vars));
+  }
+  #parseName(name) {
+    return name.toLowerCase().split(".").map((segment) => {
+      segment = segment.trim();
+      if (segment === "") {
+        throw new import_MatterError.ImplementationError(`Variable name ${name} contains empty segments`);
+      }
+      return segment;
+    });
+  }
+}
+function addVariable(into, path, value) {
+  if (!path.length) {
+    return;
+  }
+  let current = into[path[0]];
+  if (path.length === 1) {
+    if (current === void 0) {
+      into[path[0]] = value;
+    }
+    return;
+  }
+  if (typeof current !== "object") {
+    current = into[path[0]] = {};
+  }
+  addVariable(current, path.slice(1), value);
+}
+function parseUnixStyle(values) {
+  const variables = {};
+  for (const key in values) {
+    if (key.startsWith("MATTER_")) {
+      if (values[key] === void 0 || values[key] === "") {
+        continue;
+      }
+      addVariable(variables, key.slice(7).toLowerCase().split("_"), values[key]);
+    }
+  }
+  return variables;
+}
+function parseArgvStyle(values) {
+  const variables = {};
+  for (let arg of values) {
+    if (!arg.startsWith("--")) {
+      continue;
+    }
+    arg = arg.slice(2);
+    const separatorPos = arg.indexOf("=");
+    let key, value;
+    if (separatorPos === -1) {
+      key = arg;
+      value = true;
+    } else {
+      key = arg.slice(0, separatorPos);
+      value = arg.slice(separatorPos + 1);
+      if (value.startsWith("'") && value.endsWith("'") || value.startsWith('"') && value.endsWith('"')) {
+        value = value.slice(1, -1).replaceAll("\\'", "'").replaceAll('\\"', '"');
+      }
+    }
+    addVariable(variables, key.toLowerCase().split("-"), value);
+  }
+  return variables;
+}
+//# sourceMappingURL=VariableService.js.map

package/dist/cjs/environment/VariableService.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Environment.js";
+export * from "./Environmental.js";
+export * from "./RuntimeService.js";
+export * from "./VariableService.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/environment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/cjs/environment/index.js

@@ -0,0 +1,27 @@
+"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 environment_exports = {};
+module.exports = __toCommonJS(environment_exports);
+__reExport(environment_exports, require("./Environment.js"), module.exports);
+__reExport(environment_exports, require("./Environmental.js"), module.exports);
+__reExport(environment_exports, require("./RuntimeService.js"), module.exports);
+__reExport(environment_exports, require("./VariableService.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/environment/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,gCAAc,6BANd;AAOA,gCAAc,+BAPd;AAQA,gCAAc,gCARd;AASA,gCAAc,iCATd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./codec/index.js";
+export * from "./crypto/index.js";
+export * from "./environment/index.js";
+export * from "./log/index.js";
+export * from "./math/index.js";
+export * from "./MatterError.js";
+export * from "./net/index.js";
+export * from "./storage/index.js";
+export * from "./time/index.js";
+export * from "./util/index.js";
+import "./polyfills/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,sBAAsB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,34 @@
+"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 src_exports = {};
+module.exports = __toCommonJS(src_exports);
+__reExport(src_exports, require("./codec/index.js"), module.exports);
+__reExport(src_exports, require("./crypto/index.js"), module.exports);
+__reExport(src_exports, require("./environment/index.js"), module.exports);
+__reExport(src_exports, require("./log/index.js"), module.exports);
+__reExport(src_exports, require("./math/index.js"), module.exports);
+__reExport(src_exports, require("./MatterError.js"), module.exports);
+__reExport(src_exports, require("./net/index.js"), module.exports);
+__reExport(src_exports, require("./storage/index.js"), module.exports);
+__reExport(src_exports, require("./time/index.js"), module.exports);
+__reExport(src_exports, require("./util/index.js"), module.exports);
+var import_polyfills = require("./polyfills/index.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map