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

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

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import "../polyfills/disposable.js";
+import { Observable } from "../util/Observable.js";
+import { Environmental } from "./Environmental.js";
+import { RuntimeService } from "./RuntimeService.js";
+import { VariableService } from "./VariableService.js";
+/**
+ * Access to general platform-dependent features.
+ *
+ * The following variables are defined by this class:
+ * * `log.level` - Log level to use {@link Logger.LEVEL}
+ * * `log.format` - Log format to use {@link Logger.FORMAT}
+ * * `log.stack.limit` - Stack trace limit, see https://nodejs.org/api/errors.html#errorstacktracelimit
+ * * `mdns.networkInterface` - Network interface to use for MDNS broadcasts and scanning, default are all available interfaces
+ * * `mdns.ipv4` - Also announce/scan on IPv4 interfaces
+ * * `network.interface` - Map of interface names to types, expected to be defined as object with name as key and of `{type: string|number}` objects with types: 1=Wifi, 2=Ethernet, 3=Cellular, 4=Thread (strings or numbers can be used). Can also be provided via env or cli like `MATTER_NETWORK_INTERFACE_ETH0_TYPE=Ethernet`
+ *
+ * TODO - could remove global singletons by moving here
+ */
+export declare class Environment {
+    #private;
+    constructor(name: string, parent?: Environment);
+    /**
+     * Determine if an environmental service is available.
+     */
+    has(type: abstract new (...args: any[]) => any): boolean;
+    /**
+     * Access an environmental service.
+     */
+    get<T extends object>(type: abstract new (...args: any[]) => T): T;
+    /**
+     * Remove an environmental service.
+     *
+     * @param type the class of the service to remove
+     * @param instance optional instance expected, if existing instance does not match it is not deleted
+     */
+    delete(type: abstract new (...args: any[]) => any, instance?: any): void;
+    /**
+     * Access an environmental service, waiting for any async initialization to complete.
+     */
+    load<T extends Environmental.Service>(type: Environmental.Factory<T>): Promise<T>;
+    /**
+     * Install a preinitialized version of an environmental service.
+     */
+    set<T extends {}>(type: abstract new (...args: any[]) => T, instance: T): void;
+    /**
+     * Name of the environment.
+     */
+    get name(): string;
+    /**
+     * Emits on service add.
+     *
+     * Currently only emits for services owned directly by this environment.
+     */
+    get added(): Observable<[type: abstract new (...args: any[]) => {}, instance: {}], void>;
+    /**
+     * Emits on service delete.
+     *
+     * Currently only emits for services owned directly by this environment.
+     */
+    get deleted(): Observable<[type: abstract new (...args: any[]) => {}, instance: {}], void>;
+    /**
+     * Obtain an object with events that trigger when a specific service is added or deleted.
+     *
+     * This is a more convenient way to observe a specific service than {@link added} and {@link deleted}.
+     */
+    eventsFor<T extends Environmental.Factory<any>>(type: T): Environmental.ServiceEvents<T>;
+    /**
+     * The default environment.
+     *
+     * Currently only emits for services owned directly by this environment.
+     */
+    static get default(): Environment;
+    /**
+     * Set the default environment.
+     */
+    static set default(env: Environment);
+    /**
+     * Shortcut for accessing {@link VariableService.vars}.
+     */
+    get vars(): VariableService;
+    /**
+     * Shortcut for accessing {@link RuntimeService}.
+     */
+    get runtime(): RuntimeService;
+    /**
+     * Display tasks that supply diagnostics.
+     */
+    diagnose(): void;
+    protected loadVariables(): Record<string, any>;
+}
+//# sourceMappingURL=Environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Environment.d.ts","sourceRoot":"","sources":["../../../src/environment/Environment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,4BAA4B,CAAC;AAGpC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIvD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;;gBAQR,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW;IAK9C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO;IAIxD;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;IAelE;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG;IAejE;;OAEG;IACG,IAAI,CAAC,CAAC,SAAS,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAM1E;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IAYvE;;OAEG;IACH,IAAI,IAAI,WAEP;IAED;;;;OAIG;IACH,IAAI,KAAK,6CA3FyC,GAAG,EAAE,KAAK,EAAE,uBA6F7D;IAED;;;;OAIG;IACH,IAAI,OAAO,6CAnGyC,GAAG,EAAE,KAAK,EAAE,uBAqG/D;IAED;;;;OAIG;IACH,SAAS,CAAC,CAAC,SAAS,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GASlC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAGnD;;;;OAIG;IACH,MAAM,KAAK,OAAO,IAOM,WAAW,CALlC;IAED;;OAEG;IACH,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,WAAW,EAYlC;IAED;;OAEG;IACH,IAAI,IAAI,oBAEP;IAED;;OAEG;IACH,IAAI,OAAO,mBAEV;IAED;;OAEG;IACH,QAAQ;IAUR,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGjD"}

package/dist/cjs/environment/Environment.js

@@ -0,0 +1,199 @@
+"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 Environment_exports = {};
+__export(Environment_exports, {
+  Environment: () => Environment
+});
+module.exports = __toCommonJS(Environment_exports);
+var import_DiagnosticSource = require("../log/DiagnosticSource.js");
+var import_Logger = require("../log/Logger.js");
+var import_disposable = require("../polyfills/disposable.js");
+var import_Time = require("../time/Time.js");
+var import_Lifecycle = require("../util/Lifecycle.js");
+var import_Observable = require("../util/Observable.js");
+var import_Environmental = require("./Environmental.js");
+var import_RuntimeService = require("./RuntimeService.js");
+var import_VariableService = require("./VariableService.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_Logger.Logger.get("Environment");
+class Environment {
+  #services;
+  #name;
+  #parent;
+  #added = (0, import_Observable.Observable)();
+  #deleted = (0, import_Observable.Observable)();
+  #serviceEvents = /* @__PURE__ */ new Map();
+  constructor(name, parent) {
+    this.#name = name;
+    this.#parent = parent;
+  }
+  /**
+   * Determine if an environmental service is available.
+   */
+  has(type) {
+    return this.#services?.get(type) !== void 0 || (this.#parent?.has(type) ?? false);
+  }
+  /**
+   * Access an environmental service.
+   */
+  get(type) {
+    let instance = this.#services?.get(type) ?? this.#parent?.get(type);
+    if (instance) {
+      return instance;
+    }
+    if (type[import_Environmental.Environmental.create]) {
+      this.set(type, instance = type[import_Environmental.Environmental.create](this));
+      return instance;
+    }
+    throw new import_Lifecycle.UnsupportedDependencyError(`Required dependency ${type.name}`, "is not available");
+  }
+  /**
+   * Remove an environmental service.
+   *
+   * @param type the class of the service to remove
+   * @param instance optional instance expected, if existing instance does not match it is not deleted
+   */
+  delete(type, instance) {
+    if (instance !== void 0 && this.#services?.get(type) !== instance) {
+      return;
+    }
+    this.#services?.delete(type);
+    this.#parent?.delete(type);
+    this.#deleted.emit(type, instance);
+    const serviceEvents = this.#serviceEvents.get(type);
+    if (serviceEvents) {
+      serviceEvents.deleted.emit(instance);
+    }
+  }
+  /**
+   * Access an environmental service, waiting for any async initialization to complete.
+   */
+  async load(type) {
+    const instance = this.get(type);
+    await instance.construction;
+    return instance;
+  }
+  /**
+   * Install a preinitialized version of an environmental service.
+   */
+  set(type, instance) {
+    if (!this.#services) {
+      this.#services = /* @__PURE__ */ new Map();
+    }
+    this.#services.set(type, instance);
+    this.#added.emit(type, instance);
+    const serviceEvents = this.#serviceEvents.get(type);
+    if (serviceEvents) {
+      serviceEvents.added.emit(instance);
+    }
+  }
+  /**
+   * Name of the environment.
+   */
+  get name() {
+    return this.#name;
+  }
+  /**
+   * Emits on service add.
+   *
+   * Currently only emits for services owned directly by this environment.
+   */
+  get added() {
+    return this.#added;
+  }
+  /**
+   * Emits on service delete.
+   *
+   * Currently only emits for services owned directly by this environment.
+   */
+  get deleted() {
+    return this.#deleted;
+  }
+  /**
+   * Obtain an object with events that trigger when a specific service is added or deleted.
+   *
+   * This is a more convenient way to observe a specific service than {@link added} and {@link deleted}.
+   */
+  eventsFor(type) {
+    let events = this.#serviceEvents.get(type);
+    if (events === void 0) {
+      events = {
+        added: new import_Observable.Observable(),
+        deleted: new import_Observable.Observable()
+      };
+      this.#serviceEvents.set(type, events);
+    }
+    return events;
+  }
+  /**
+   * The default environment.
+   *
+   * Currently only emits for services owned directly by this environment.
+   */
+  static get default() {
+    return global;
+  }
+  /**
+   * Set the default environment.
+   */
+  static set default(env) {
+    global = env;
+    env.vars.use(() => {
+      import_Logger.Logger.level = env.vars.get("log.level", import_Logger.Logger.level);
+      import_Logger.Logger.format = env.vars.get("log.format", import_Logger.Logger.format);
+      const stackLimit = global.vars.number("log.stack.limit");
+      if (stackLimit !== void 0) {
+        Error.stackTraceLimit = stackLimit;
+      }
+    });
+  }
+  /**
+   * Shortcut for accessing {@link VariableService.vars}.
+   */
+  get vars() {
+    return this.get(import_VariableService.VariableService);
+  }
+  /**
+   * Shortcut for accessing {@link RuntimeService}.
+   */
+  get runtime() {
+    return this.get(import_RuntimeService.RuntimeService);
+  }
+  /**
+   * Display tasks that supply diagnostics.
+   */
+  diagnose() {
+    import_Time.Time.getTimer("Diagnostics", 0, () => {
+      try {
+        logger.notice("Diagnostics follow", import_DiagnosticSource.DiagnosticSource);
+      } catch (e) {
+        logger.error(`Unhandled error gathering diagnostics:`, e);
+      }
+    }).start();
+  }
+  loadVariables() {
+    return {};
+  }
+}
+let global = new Environment("default");
+//# sourceMappingURL=Environment.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic } from "../log/Diagnostic.js";
+import { Observable } from "../util/Observable.js";
+import type { Environment } from "./Environment.js";
+export declare namespace Environmental {
+    const create: unique symbol;
+    /**
+     * An "environmental service" is an object available via {@link Environment.get}.
+     *
+     * Any object may be an environmental service.  This methods in this interface are optional.
+     */
+    interface Service {
+        /**
+         * Asynchronous construction, respected by {@link Environment.load}.
+         */
+        construction?: Promise<any>;
+        /**
+         * Asynchronous destruction.  Invoked by the environment when it is destroyed.
+         */
+        [Symbol.asyncDispose]?: () => Promise<any>;
+        /**
+         * Standard diagnostic presentation.
+         */
+        [Diagnostic.presentation]?: Diagnostic.Presentation;
+        /**
+         * Standard diagnostic value.
+         */
+        [Diagnostic.value]?: unknown;
+    }
+    /**
+     * A factory for a {@link Service}.  Any constructor may be a service factory.
+     */
+    interface Factory<T extends Service> {
+        new (...args: any[]): T;
+        /**
+         * The environment will create the service automatically if the factory supports {@link create}.
+         */
+        [create]?: (environment: Environment) => T;
+    }
+    /**
+     * Events related to service lifecycle.
+     */
+    interface ServiceEvents<T extends abstract new (...args: any[]) => T> {
+        added: Observable<[instance: InstanceType<T>]>;
+        deleted: Observable<[instance: InstanceType<T>]>;
+    }
+}
+//# sourceMappingURL=Environmental.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Environmental.d.ts","sourceRoot":"","sources":["../../../src/environment/Environmental.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,yBAAiB,aAAa,CAAC;IACpB,MAAM,MAAM,eAAmB,CAAC;IAEvC;;;;OAIG;IACH,UAAiB,OAAO;QACpB;;WAEG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAE5B;;WAEG;QACH,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QAE3C;;WAEG;QACH,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC;QAEpD;;WAEG;QACH,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;KAChC;IAED;;OAEG;IACH,UAAiB,OAAO,CAAC,CAAC,SAAS,OAAO;QACtC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAExB;;WAEG;QACH,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,CAAC,CAAC;KAC9C;IAED;;OAEG;IACH,UAAiB,aAAa,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC;QACvE,KAAK,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACpD;CACJ"}

package/dist/cjs/environment/Environmental.js

@@ -0,0 +1,33 @@
+"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 Environmental_exports = {};
+__export(Environmental_exports, {
+  Environmental: () => Environmental
+});
+module.exports = __toCommonJS(Environmental_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Environmental;
+((Environmental2) => {
+  Environmental2.create = Symbol("create");
+})(Environmental || (Environmental = {}));
+//# sourceMappingURL=Environmental.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/environment/Environmental.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUO,IAAU;AAAA,CAAV,CAAUA,mBAAV;AACI,EAAMA,eAAA,SAAS,OAAO,QAAQ;AAAA,GADxB;",
+  "names": ["Environmental"]
+}

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

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic } from "../log/Diagnostic.js";
+import { Construction } from "../util/Construction.js";
+import { Cancellable, Destructable } from "../util/Lifecycle.js";
+import { Multiplex } from "../util/Multiplex.js";
+import { Observable } from "../util/Observable.js";
+import type { Environment } from "./Environment.js";
+import { Environmental } from "./Environmental.js";
+/**
+ * Handles lifecycle management of other components.
+ */
+export declare class RuntimeService implements Multiplex {
+    #private;
+    constructor(environment: Environment);
+    /**
+     * 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: RuntimeService.Worker | void): void;
+    /**
+     * Remove a worker.
+     */
+    delete(worker: RuntimeService.Worker): void;
+    /**
+     * Emits when a worker is added when previously there were none.
+     */
+    get started(): Observable<[], void>;
+    /**
+     * Emits when the last worker departs.
+     */
+    get stopped(): Observable<[], void>;
+    /**
+     * Emits when a worker experiences an unhandled error.
+     */
+    get crashed(): Observable<[cause: any], void>;
+    static [Environmental.create](environment: Environment): RuntimeService;
+    /**
+     * Cancel execution.
+     *
+     * On cancel the runtime destroys all workers.
+     */
+    cancel(): void;
+    /**
+     * Resolves when no workers are active.
+     */
+    get inactive(): Promise<void>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    get [Diagnostic.value](): unknown[];
+}
+export declare namespace RuntimeService {
+    const label: unique symbol;
+    /**
+     * The runtime tracks individual discrete tasks as "workers".
+     *
+     * The state of the runtime is dependent on installed workers.  Any JS object may be a worker but the runtime's
+     * interaction with workers varies as documented here.
+     *
+     * If a worker is a {@link PromiseLike} the runtime will delete and/or destroy it on completion.
+     */
+    interface Worker extends Partial<PromiseLike<any>>, Partial<Cancellable>, Partial<Destructable> {
+        /**
+         * If the worker supports {@link Construction}, the runtime will monitor the worker's lifecycle:
+         *
+         *   - If the worker crashed (e.g. experiences an error during initialization) the runtime will cancel all
+         *     workers and exit
+         *
+         *   - If the worker is destroyed the runtime deletes it from the set of known workers
+         */
+        construction?: Construction<any>;
+        /**
+         * If the worker supports {@link Symbol.asyncDispose} the runtime will invoke when the worker is no longer
+         * needed.  This happens if:
+         *
+         *   - The worker is a {@link PromiseLike} that resolves
+         *
+         *   - The worker's {@link construction} status changed as noted above
+         *
+         *   - The runtime is canceled via {@link RuntimeService.cancel}
+         */
+        [Symbol.asyncDispose]?: () => void | Promise<void>;
+        /**
+         * Workers may implement {@link Symbol.dispose} to handle disposal.  Works the same as the async equivalent.
+         */
+        [Symbol.dispose]?: () => void;
+        /**
+         * If label is present, it will be presented in diagnostics.  This takes precedence over [Diagnostic.value].
+         */
+        [label]?: unknown;
+        /**
+         * In diagnostics workers render using toString() unless they provide explicit diagnostics.
+         */
+        [Diagnostic.value]?: unknown;
+    }
+}
+//# sourceMappingURL=RuntimeService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeService.d.ts","sourceRoot":"","sources":["../../../src/environment/RuntimeService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAsB,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAa,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD;;GAEG;AACH,qBAAa,cAAe,YAAW,SAAS;;gBAShC,WAAW,EAAE,WAAW;IAKpC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,GAAG,IAAI;IA4CxC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM;IAsBpC;;OAEG;IACH,IAAI,OAAO,yBAEV;IAED;;OAEG;IACH,IAAI,OAAO,yBAEV;IAED;;OAEG;IACH,IAAI,OAAO,mCAEV;IAED,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,WAAW;IAItD;;;;OAIG;IACH,MAAM;IAeN;;OAEG;IACH,IAAI,QAAQ,kBAcX;IAEK,KAAK;IAMX,CAAC,MAAM,CAAC,YAAY,CAAC;IAIrB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,cAgBrB;CA4CJ;AAED,yBAAiB,cAAc,CAAC;IACrB,MAAM,KAAK,eAAkB,CAAC;IAErC;;;;;;;OAOG;IACH,UAAiB,MAAO,SAAQ,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;QAClG;;;;;;;WAOG;QACH,YAAY,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;QAEjC;;;;;;;;;WASG;QACH,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnD;;WAEG;QACH,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC;QAE9B;;WAEG;QACH,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;KAChC;CACJ"}