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

package/dist/esm/environment/VariableService.js

@@ -0,0 +1,237 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError } from "../MatterError.js";
+import { Diagnostic } from "../log/Diagnostic.js";
+import { isObject } from "../util/Type.js";
+import { Environmental } from "./Environmental.js";
+class VariableService {
+  #vars = {};
+  #usageCollectors = Array();
+  #usages = /* @__PURE__ */ new Set();
+  constructor(environment) {
+    environment.set(VariableService, this);
+  }
+  static [Environmental.create](environment) {
+    return new this(environment);
+  }
+  get [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 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 (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 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;
+}
+export {
+  VariableService
+};
+//# sourceMappingURL=VariableService.js.map

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

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

package/dist/esm/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/esm/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/esm/environment/index.js

@@ -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.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/environment/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/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/esm/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/esm/index.js

@@ -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.js.map

package/dist/esm/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,OAAO;",
+  "names": []
+}

package/dist/esm/log/Diagnostic.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Lifecycle } from "../util/Lifecycle.js";
+import { LogLevel } from "./LogLevel.js";
+/**
+ * Logged values may implement this interface to customize presentation.
+ *
+ * You can use the utility functions such as {@link Diagnostic.dict} to create
+ * Diagnostics from common value types.
+ */
+export interface Diagnostic {
+    readonly [Diagnostic.presentation]?: Diagnostic.Presentation | Lifecycle.Status;
+    readonly [Diagnostic.value]?: unknown;
+}
+/**
+ * Create a diagnostic giving a value a specific presentation.
+ */
+export declare function Diagnostic(presentation: Diagnostic.Presentation | Lifecycle.Status, value: unknown): Diagnostic;
+export declare namespace Diagnostic {
+    enum Presentation {
+        /**
+         * Render an object as a log message.
+         */
+        Message = "message",
+        /**
+         * By default iterables render as a single line with spaces separating.  The "list" presentation treats elements
+         * instead as separate entities which typically means presentation on different lines.
+         *
+         * Within an iterable, a list also serves to present contained items as subordinate to the previous item.
+         */
+        List = "list",
+        /**
+         * Render iterables without intervening spaces.
+         */
+        Squash = "squash",
+        /**
+         * An emphasized diagnostic.  Rendered to draw attention.
+         */
+        Strong = "strong",
+        /**
+         * A deemphasized diagnostic.  Rendered to draw less attention than default rendering.
+         */
+        Weak = "weak",
+        /**
+         * An error message diagnostic.
+         */
+        Error = "error",
+        /**
+         * A key/value diagnostic.  Rendered as a group of key/value pairs.
+         */
+        Dictionary = "dictionary",
+        /**
+         * Path, resource or session identifier.
+         */
+        Via = "via"
+    }
+    const presentation: unique symbol;
+    const value: unique symbol;
+    interface Message {
+        [presentation]?: Presentation.Message;
+        now: Date;
+        level: LogLevel;
+        facility: string;
+        prefix: string;
+        values: unknown[];
+    }
+    /**
+     * Create an object representing a log message.
+     */
+    function message(value: Partial<Message>): Message;
+    /**
+     * Create a value presented emphatically.
+     */
+    function strong(value: unknown): Diagnostic;
+    /**
+     * Create a value presented less emphatically than the default.
+     */
+    function weak(value: unknown): Diagnostic;
+    /**
+     * Create a value identifying the source of a diagnostic event.
+     */
+    function via(value: string): string;
+    /**
+     * A node in a diagnostic tree.  Top-level diagnostic sources registered with DiagnosticSource should present as
+     * nodes.
+     */
+    function node(icon: string, label: unknown, detail: {
+        self?: unknown;
+        children?: unknown[];
+    }): unknown[];
+    /**
+     * Create a value presenting as a list of separate lines.
+     */
+    function list(value: Iterable<unknown>): Diagnostic;
+    /**
+     * Create a value presenting as segments of the same string without intervening spaces.
+     */
+    function squash(...values: unknown[]): Diagnostic;
+    /**
+     * Create a K/V map that presents with formatted keys.
+     */
+    function dict(entries: object): Record<string, unknown> & Diagnostic;
+    /**
+     * Create a Diagnostic for an error.
+     */
+    function error(error: any): string | Diagnostic;
+    /**
+     * Create a diagnostic with a specific {@link Lifecycle}.
+     */
+    function lifecycle(status: Lifecycle.Status, value: unknown): Diagnostic;
+    /**
+     * Create a diagnostic for a {@link Lifecycle.Map}.
+     */
+    function lifecycleList(map: Lifecycle.Map<any>): Diagnostic[];
+    interface Elapsed {
+        readonly startedAt: number;
+        readonly time: number;
+        toString(): string;
+    }
+    /**
+     * Convert an interval to text.
+     */
+    function interval(ms: number): string;
+    /**
+     * Create a diagnostic that renders as elapsed time since creation.
+     */
+    function elapsed(): Elapsed;
+    /**
+     * Upgrade a value to support specialized diagnostic rendering.
+     */
+    function upgrade<T>(value: boolean | number | string | object, diagnostic: unknown): T;
+    /**
+     * Convert a number or bigint to a hex string which is prefixed by "0x" for logging purposes
+     */
+    function hex(value: number | bigint): string;
+}
+//# sourceMappingURL=Diagnostic.d.ts.map

package/dist/esm/log/Diagnostic.d.ts.map

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