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

package/dist/cjs/endpoint/Endpoint.js

@@ -0,0 +1,579 @@
+"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 Endpoint_exports = {};
+__export(Endpoint_exports, {
+  Endpoint: () => Endpoint
+});
+module.exports = __toCommonJS(Endpoint_exports);
+var import_Behavior = require("#behavior/Behavior.js");
+var import_NodeActivity = require("#behavior/context/NodeActivity.js");
+var import_OfflineContext = require("#behavior/context/server/OfflineContext.js");
+var import_general = require("#general");
+var import_model = require("#model");
+var import_IdentityService = require("#node/server/IdentityService.js");
+var import_types = require("#types");
+var import_root = require("../endpoints/root.js");
+var import_Agent = require("./Agent.js");
+var import_Behaviors = require("./properties/Behaviors.js");
+var import_EndpointInitializer = require("./properties/EndpointInitializer.js");
+var import_EndpointLifecycle = require("./properties/EndpointLifecycle.js");
+var import_Parts = require("./properties/Parts.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("Endpoint");
+class Endpoint {
+  #type;
+  #id;
+  #number;
+  #owner;
+  #agentType;
+  #behaviors;
+  #lifecycle;
+  #parts;
+  #construction;
+  #stateView = {};
+  #events = {};
+  #activity;
+  /**
+   * A string that uniquely identifies an endpoint.
+   *
+   * This ID must be unique amongst all Parts with the same owner.
+   */
+  get id() {
+    if (this.#id === void 0) {
+      throw new import_general.UninitializedDependencyError(
+        this.toString(),
+        "endpoint ID is not yet assigned; set ID or await endpoint.construction to avoid this error"
+      );
+    }
+    return this.#id;
+  }
+  /**
+   * The endpoint ID or undefined if not yet assigned.
+   */
+  get maybeId() {
+    return this.#id;
+  }
+  /**
+   * The Matter {@link EndpointNumber} of the endpoint.  This uniquely identifies the {@link Endpoint} in the scope of the
+   * Matter node.
+   */
+  get number() {
+    if (this.#number === void 0) {
+      throw new import_general.UninitializedDependencyError(
+        this.toString(),
+        "endpoint number is not yet assigned; set number or await endpoint.construction to avoid this error"
+      );
+    }
+    return this.#number;
+  }
+  /**
+   * The endpoint number or undefined if not yet assigned.
+   */
+  get maybeNumber() {
+    return this.#number;
+  }
+  /**
+   * The owner of the endpoint.
+   *
+   * Every endpoint but the root endpoint (the "server node") is owned by another endpoint.
+   */
+  get owner() {
+    return this.#owner;
+  }
+  /**
+   * Search for the owner of a specific type.
+   *
+   * Returns undefined if this owner is not found on the way up to the root endpoint.
+   */
+  ownerOfType(type) {
+    for (let endpoint = this; endpoint !== void 0; endpoint = endpoint.owner) {
+      if (endpoint.type.deviceClass === type.deviceClass) {
+        return endpoint;
+      }
+    }
+  }
+  /**
+   * The endpoint's environment.  Endpoint implementations use the environment to access platform components such as
+   * storage and network components.
+   */
+  get env() {
+    if (this.owner) {
+      return this.owner.env;
+    }
+    return import_general.Environment.default;
+  }
+  /**
+   * Access the pool of behaviors supported by this endpoint.
+   */
+  get behaviors() {
+    return this.#behaviors;
+  }
+  /**
+   * Current state values for all behaviors, keyed by behavior ID.  This view is read-only.
+   */
+  get state() {
+    return this.#stateView;
+  }
+  /**
+   * Current state for a specific behavior.
+   */
+  stateOf(type) {
+    if (!this.behaviors.has(type)) {
+      throw new import_general.ImplementationError(`Behavior ${type.id} is not supported by ${this}`);
+    }
+    return this.#stateView[type.id];
+  }
+  /**
+   * Update state values.  This is a patch operation; it only modifies properties in {@link values}.
+   *
+   * {@link values} is an object with a {@link Behavior.id} as the key and state values as sub-objects.
+   *
+   * Input values must adhere to the {@link Behavior.schema} of the target {@link Behavior}.  If not, set will throw
+   * an error.
+   *
+   * This is a transactional operation.  An error results in no change.  The endpoint will wait for exclusive access
+   * before applying changes.
+   *
+   * @param values the values to change
+   */
+  async set(values) {
+    await this.act(`set<${this}>`, async (agent) => {
+      const tx = agent.context.transaction;
+      await tx.begin();
+      for (const behaviorId in values) {
+        const behavior = agent[behaviorId];
+        if (!(behavior instanceof import_Behavior.Behavior)) {
+          throw new import_general.ImplementationError(`Behavior ID ${behaviorId} does not exist`);
+        }
+        const vals = values[behaviorId];
+        if (vals === void 0) {
+          continue;
+        }
+        await tx.addResources(behavior);
+        const patch = behavior.constructor.supervisor.patch;
+        if (typeof vals !== "object") {
+          throw new import_general.ImplementationError(
+            `State values for ${behaviorId} must be an object, not ${typeof vals}`
+          );
+        }
+        if (Array.isArray(vals)) {
+          throw new import_general.ImplementationError(`StateValue for ${behaviorId} must be an object, not an array`);
+        }
+        patch(vals, behavior.state, this.path);
+      }
+    });
+  }
+  /**
+   * Update state values for a single behavior.
+   *
+   * The patch semantics used here are identical to {@link set}.
+   *
+   * @param type the {@link Behavior} to patch
+   * @param values the values to change
+   */
+  async setStateOf(type, values) {
+    await this.act(`setStateOf<${this}>`, async (agent) => {
+      const behavior = agent.get(type);
+      const tx = agent.context.transaction;
+      await tx.begin();
+      await tx.addResources(behavior);
+      const patch = behavior.constructor.supervisor.patch;
+      if (typeof values !== "object") {
+        throw new import_general.ImplementationError(`State values for ${type.id} must be an object, not ${typeof values}`);
+      }
+      if (Array.isArray(values)) {
+        throw new import_general.ImplementationError(`State values for ${type.id} must be an object, not an array`);
+      }
+      patch(values, behavior.state, this.path);
+    });
+  }
+  /**
+   * Events for all behaviors keyed by behavior ID.
+   */
+  get events() {
+    return this.#events;
+  }
+  /**
+   * Events for a specific behavior.
+   */
+  eventsOf(type) {
+    if (!this.behaviors.has(type)) {
+      throw new import_general.ImplementationError(`Behavior ${type.id} is not supported by this endpoint`);
+    }
+    return this.#events[type.id];
+  }
+  get construction() {
+    return this.#construction;
+  }
+  constructor(definition, options) {
+    const config = Endpoint.configurationFor(definition, options);
+    this.#type = config.type;
+    this.#construction = (0, import_general.Construction)(this);
+    this.#lifecycle = this.createLifecycle(config.isEssential);
+    this.#lifecycle.ready.on(() => this.#logReady());
+    if (config.id !== void 0) {
+      this.id = config.id;
+    }
+    if (config.number !== void 0) {
+      this.number = config.number;
+    }
+    this.#behaviors = new import_Behaviors.Behaviors(this, config);
+    if (config.owner) {
+      this.owner = config.owner instanceof import_Agent.Agent ? config.owner.endpoint : config.owner;
+    }
+    if (config.parts) {
+      for (const part of config.parts) {
+        this.parts.add(part);
+      }
+    }
+  }
+  set id(id) {
+    if (this.#id === id) {
+      return;
+    }
+    if (this.#id !== void 0) {
+      throw new import_general.ImplementationError(`${this} ID is already assigned, cannot reassign`);
+    }
+    if (typeof id !== "string") {
+      throw new import_general.ImplementationError(`Illegal endpoint ID type "${typeof id}"`);
+    }
+    if (id === "") {
+      throw new import_general.ImplementationError("Endpoint ID may not be empty");
+    }
+    if (id.includes(".")) {
+      throw new import_general.ImplementationError('Endpoint ID may not include "."');
+    }
+    if (this.lifecycle.isInstalled) {
+      this.#container.assertIdAvailable(id, this);
+    }
+    this.#id = id;
+    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.IdAssigned);
+  }
+  get container() {
+    return this.owner?.parts;
+  }
+  set number(number) {
+    if (this.#number === number) {
+      return;
+    }
+    if (this.#number !== void 0) {
+      throw new import_general.ImplementationError(
+        `${this} endpoint number ${this.#number} is already assigned, cannot reassign`
+      );
+    }
+    if (typeof number !== "number") {
+      throw new import_general.ImplementationError(`Illegal endpoint number type "${typeof number}"`);
+    }
+    if (!Number.isInteger(number)) {
+      throw new import_general.ImplementationError(`Endpoint number ${number} is not an integer`);
+    }
+    if (number < 0) {
+      throw new import_general.ImplementationError(`Endpoint number ${number} is negative`);
+    }
+    if (number > 65535) {
+      throw new import_general.ImplementationError(`Endpoint number ${number} is greater than the maximum of 65535`);
+    }
+    if (this.type.deviceClass === import_root.RootEndpoint.deviceClass) {
+      if (number !== 0) {
+        throw new import_general.ImplementationError("The root endpoint must have ID 0");
+      }
+    } else {
+      if (number === 0) {
+        throw new import_general.ImplementationError("Only root endpoint may have ID 0");
+      }
+      if (this.lifecycle.isInstalled) {
+        this.env.get(import_IdentityService.IdentityService).assertNumberAvailable(number, this);
+      }
+    }
+    this.#number = (0, import_types.EndpointNumber)(number);
+    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.NumberAssigned);
+  }
+  set owner(owner) {
+    if (this.#owner === owner) {
+      return;
+    }
+    if (this.#owner) {
+      throw new import_general.ImplementationError("Endpoint owner cannot be reassigned");
+    }
+    if (owner === void 0) {
+      throw new import_general.ImplementationError("Endpoint owner must be defined");
+    }
+    this.#owner = owner;
+    try {
+      this.#container.add(this);
+    } catch (e) {
+      this.#container.delete(this);
+      this.#owner = void 0;
+      throw e;
+    }
+  }
+  async add(definition, options) {
+    if (!this.lifecycle.isInstalled) {
+      throw new import_general.ImplementationError(`You may not use add() here because ${this} is not installed in a Node`);
+    }
+    await this.construction;
+    let endpoint;
+    if (definition instanceof Endpoint) {
+      endpoint = definition;
+    } else {
+      endpoint = new Endpoint(definition, options);
+    }
+    if (this.#lifecycle.isPartsReady) {
+      endpoint.construction.onError(() => {
+      });
+    }
+    this.parts.add(endpoint);
+    try {
+      await endpoint.construction.ready;
+    } catch (e) {
+      if (endpoint.lifecycle.isEssential) {
+        await endpoint.reset();
+        this.parts.delete(endpoint);
+        endpoint.#owner = void 0;
+      }
+      if (!endpoint.lifecycle.isEssential) {
+        logger.error(`Initialization error in non-essential endpoint ${endpoint}:`, e);
+      }
+      throw e;
+    }
+    return endpoint;
+  }
+  /**
+   * The type of endpoint this endpoint implements.
+   */
+  get type() {
+    return this.#type;
+  }
+  /**
+   * Access child parts.
+   */
+  get parts() {
+    if (!this.#parts) {
+      this.#parts = new import_Parts.Parts(this);
+    }
+    return this.#parts;
+  }
+  /**
+   * Is this a parent Endpoint?
+   */
+  get hasParts() {
+    return !!this.#parts?.size;
+  }
+  /**
+   * Endpoint information that varies as the endpoint initializes.
+   */
+  get lifecycle() {
+    return this.#lifecycle;
+  }
+  createLifecycle(isEssential) {
+    return new import_EndpointLifecycle.EndpointLifecycle(this, isEssential);
+  }
+  /**
+   * Create an {@link Agent.Type} for the endpoint.
+   */
+  get agentType() {
+    if (!this.#agentType) {
+      this.#agentType = import_Agent.Agent.for(this.type, this.behaviors.supported);
+    }
+    return this.#agentType;
+  }
+  act(actorOrPurpose, actor) {
+    let purpose;
+    if (typeof actorOrPurpose === "string") {
+      purpose = actorOrPurpose;
+    } else {
+      actor = actorOrPurpose;
+      purpose = "offline";
+    }
+    if (typeof actor !== "function") {
+      throw new import_general.ImplementationError("Actor must be a function");
+    }
+    this.construction.assert(this.toString());
+    if (!this.#activity) {
+      this.#activity = this.env.get(import_NodeActivity.NodeActivity);
+    }
+    return import_OfflineContext.OfflineContext.act(purpose, this.#activity, (context) => {
+      return actor(context.agentFor(this));
+    });
+  }
+  /**
+   * Perform "soft" reset of the endpoint, reverting all in-memory structures to uninitialized.
+   */
+  async reset() {
+    try {
+      this.lifecycle.resetting();
+      await this.parts.reset();
+      await this.behaviors.close();
+      await this.lifecycle.reset.emit();
+      this.construction.setStatus(import_general.Lifecycle.Status.Inactive);
+    } catch (e) {
+      logger.error(`Unhandled error during reset of ${this}`, e);
+    }
+  }
+  /**
+   * Apply a depth-first visitor function to myself and all descendents.
+   */
+  visit(visitor) {
+    const promise = visitor(this);
+    const childIterator = this.parts[Symbol.iterator]();
+    const visitChildren = () => {
+      for (let next = childIterator.next(); !next.done; next = childIterator.next()) {
+        const promise2 = next.value.visit(visitor);
+        if (import_general.MaybePromise.is(promise2)) {
+          return promise2.then(visitChildren);
+        }
+      }
+    };
+    if (import_general.MaybePromise.is(promise)) {
+      return promise.then(visitChildren);
+    }
+    return visitChildren();
+  }
+  async close() {
+    await this.#construction.close();
+  }
+  async [import_general.Construction.destruct]() {
+    await this.#parts?.close();
+    await this.#behaviors?.close();
+    for (const events of Object.values(this.#events)) {
+      events[Symbol.dispose]();
+    }
+    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.Destroyed);
+    this.#owner = void 0;
+  }
+  async [Symbol.asyncDispose]() {
+    await this.close();
+  }
+  toString() {
+    return this.path.toString();
+  }
+  /**
+   * Path identifying the endpoint in the Matter data model.
+   */
+  get path() {
+    let ident;
+    if (this.lifecycle?.hasId) {
+      ident = this.id;
+    } else if (this.lifecycle?.hasNumber) {
+      ident = this.number;
+    } else {
+      ident = "?";
+    }
+    if (this.#owner) {
+      return this.#owner.path.at(ident, this.#type.name);
+    }
+    return (0, import_model.DataModelPath)(ident, this.type?.name);
+  }
+  /**
+   * Asynchronous initialization.
+   *
+   * Derivatives may override to perform async construction prior to full initialization.
+   */
+  initialize() {
+    this.env.get(import_EndpointInitializer.EndpointInitializer).initializeDescendent(this);
+    let promise = this.behaviors.initialize();
+    if (promise) {
+      promise = promise.then(this.parts.initialize.bind(this.parts));
+    } else {
+      promise = this.parts.initialize();
+    }
+    return promise;
+  }
+  /**
+   * Ensure requirements for construction are met.
+   */
+  assertConstructable() {
+    if (this.#owner === void 0) {
+      throw new import_general.ImplementationError(`Endpoint construction initiated without owner`);
+    }
+    if (!this.#owner.#lifecycle.isInstalled) {
+      throw new import_general.ImplementationError(`Endpoint construction initiated with uninstalled owner`);
+    }
+  }
+  /**
+   * Complete initialization.  Invoked via {@link Construction#start} by the owner.
+   */
+  [import_general.Construction.construct]() {
+    this.assertConstructable();
+    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.Installed);
+    return this.initialize();
+  }
+  #logReady() {
+    logger.info(import_general.Diagnostic.strong(this.toString()), "ready", this.diagnosticDict);
+  }
+  /**
+   * Hierarchical diagnostics of endpoint and children.
+   */
+  get [import_general.Diagnostic.value]() {
+    return [
+      import_general.Diagnostic.strong(this.id),
+      import_general.Diagnostic.dict({
+        ...this.#diagnosticProps,
+        class: this.constructor.name
+      }),
+      import_general.Diagnostic.list([...this.behaviors.detailedDiagnostic, ...this.parts])
+    ];
+  }
+  /**
+   * Diagnostic information regarding endpoint state.
+   */
+  get diagnosticDict() {
+    return import_general.Diagnostic.dict({
+      ...this.#diagnosticProps,
+      behaviors: this.behaviors
+    });
+  }
+  get #diagnosticProps() {
+    return {
+      "endpoint#": this.number,
+      type: `${this.type.name} (0x${this.type.deviceType.toString(16)})`
+    };
+  }
+  get #container() {
+    const container = this.container;
+    if (container === void 0) {
+      throw new import_general.ImplementationError(`No container for installed endpoint ${this}`);
+    }
+    return container;
+  }
+}
+((Endpoint2) => {
+  function configurationFor(definition, options) {
+    if (definition.deviceType) {
+      return {
+        ...options,
+        type: definition
+      };
+    }
+    return definition;
+  }
+  Endpoint2.configurationFor = configurationFor;
+  function partFor(definition) {
+    if (definition instanceof Endpoint2) {
+      return definition;
+    }
+    return new Endpoint2(definition);
+  }
+  Endpoint2.partFor = partFor;
+})(Endpoint || (Endpoint = {}));
+//# sourceMappingURL=Endpoint.js.map

package/dist/cjs/endpoint/Endpoint.js.map

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

package/dist/cjs/endpoint/EndpointClient.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EndpointClient.d.ts.map

package/dist/cjs/endpoint/EndpointClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointClient.d.ts","sourceRoot":"","sources":["../../../src/endpoint/EndpointClient.ts"],"names":[],"mappings":""}

package/dist/cjs/endpoint/EndpointClient.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=EndpointClient.js.map

package/dist/cjs/endpoint/EndpointClient.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": [],
+  "mappings": "",
+  "names": []
+}

package/dist/cjs/endpoint/EndpointServer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "#behavior/Behavior.js";
+import { BehaviorBacking } from "#behavior/internal/BehaviorBacking.js";
+import { ClusterClientObj, ClusterServer, EndpointInterface } from "#protocol";
+import { ClusterId, ClusterType, EndpointNumber } from "#types";
+import { Endpoint } from "./Endpoint.js";
+/**
+ * EndpointServer makes an {@link Endpoint} available for remote access as an Endpoint on a Matter network.
+ */
+export declare class EndpointServer implements EndpointInterface {
+    #private;
+    get endpoint(): Endpoint<import("./index.js").EndpointType.Empty>;
+    get deviceType(): import("#types").DeviceTypeId;
+    constructor(endpoint: Endpoint);
+    createBacking(type: Behavior.Type): BehaviorBacking;
+    get number(): EndpointNumber;
+    get name(): string;
+    getNumber(): EndpointNumber;
+    removeFromStructure(): void;
+    updatePartsList(): EndpointNumber[];
+    getChildEndpoints(): EndpointInterface[];
+    determineUniqueID(): string | undefined;
+    verifyRequiredClusters(): void;
+    close(): void;
+    [Symbol.asyncDispose](): Promise<void>;
+    setStructureChangedCallback(): void;
+    addClusterServer(server: ClusterServer): void;
+    hasClusterServer(cluster: ClusterType): boolean;
+    getClusterServer(cluster: ClusterType): ClusterServer | undefined;
+    getClusterServerById(clusterId: ClusterId): ClusterServer | undefined;
+    getAllClusterServers(): ClusterServer[];
+    getAllClusterClients(): ClusterClientObj[];
+    addClusterClient(): void;
+    getClusterClient(): any;
+    addChildEndpoint(endpoint: EndpointInterface): void;
+    getChildEndpoint(id: EndpointNumber): EndpointInterface | undefined;
+    /**
+     * Retrieve the server for an endpoint.
+     */
+    static forEndpoint(endpoint: Endpoint): EndpointServer;
+}
+//# sourceMappingURL=EndpointServer.d.ts.map

package/dist/cjs/endpoint/EndpointServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointServer.d.ts","sourceRoot":"","sources":["../../../src/endpoint/EndpointServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAIxE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC;;GAEG;AACH,qBAAa,cAAe,YAAW,iBAAiB;;IAKpD,IAAI,QAAQ,sDAEX;IAED,IAAI,UAAU,kCAEb;gBAEW,QAAQ,EAAE,QAAQ;IAM9B,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,eAAe;IAiBnD,IAAI,MAAM,mBAET;IAED,IAAI,IAAI,WAEP;IAED,SAAS,IAAI,cAAc;IAO3B,mBAAmB,IAAI,IAAI;IAI3B,eAAe,IAAI,cAAc,EAAE;IAKnC,iBAAiB,IAAI,iBAAiB,EAAE;IAQxC,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC,sBAAsB,IAAI,IAAI;IAI9B,KAAK,IAAI,IAAI;IAIP,CAAC,MAAM,CAAC,YAAY,CAAC;IAY3B,2BAA2B,IAAI,IAAI;IAInC,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAI7C,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAI/C,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS;IAOjE,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IAIrE,oBAAoB,IAAI,aAAa,EAAE;IAIvC,oBAAoB,IAAI,gBAAgB,EAAE;IAK1C,gBAAgB,IAAI,IAAI;IAIxB,gBAAgB,IAAI,GAAG;IAIvB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAQnD,gBAAgB,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,GAAG,SAAS;IAWnE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ;CAOxC"}