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

package/dist/cjs/protocol/ChannelManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelManager.d.ts","sourceRoot":"","sources":["../../../src/protocol/ChannelManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAU,WAAW,EAAE,MAAM,UAAU,CAAC;AACpF,OAAO,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,qBAAa,cAAe,SAAQ,WAAW;CAAG;AAElD,qBAAa,cAAc;;gBAMX,4BAA4B,SAAI;IAI5C,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW;IAMvC,IAAI,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAE7C;IAYK,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc;IAkB9D,UAAU,CAAC,OAAO,EAAE,WAAW;IAI/B,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO;IAYlD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,OAAO;IAa/B,qBAAqB,CAAC,OAAO,EAAE,WAAW;IAO1C,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO;IAiB1D,OAAO,CAAC,wBAAwB;IAU1B,kBAAkB,CAAC,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO;IAyB1E,KAAK;CAYd"}

package/dist/cjs/protocol/ChannelManager.js

@@ -0,0 +1,168 @@
+"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 ChannelManager_exports = {};
+__export(ChannelManager_exports, {
+  ChannelManager: () => ChannelManager,
+  NoChannelError: () => NoChannelError
+});
+module.exports = __toCommonJS(ChannelManager_exports);
+var import_general = require("#general");
+var import_PeerAddress = require("#peer/PeerAddress.js");
+var import_ExchangeManager = require("./ExchangeManager.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("ChannelManager");
+class NoChannelError extends import_general.MatterError {
+}
+class ChannelManager {
+  #channels = new import_PeerAddress.PeerAddressMap();
+  #paseChannels = /* @__PURE__ */ new Map();
+  #caseSessionsPerFabricAndNode;
+  // TODO evaluate with controller the effects of limiting the entries just for FabricIndex and not also NodeId
+  constructor(caseSessionsPerFabricAndNode = 3) {
+    this.#caseSessionsPerFabricAndNode = caseSessionsPerFabricAndNode;
+  }
+  [import_general.Environmental.create](env) {
+    const instance = new ChannelManager();
+    env.set(ChannelManager, this);
+    return instance;
+  }
+  set caseSessionsPerFabricAndNode(count) {
+    this.#caseSessionsPerFabricAndNode = count;
+  }
+  #findLeastActiveChannel(channels) {
+    let oldest = channels[0];
+    for (const channel of channels) {
+      if (channel.session.timestamp < oldest.session.timestamp) {
+        oldest = channel;
+      }
+    }
+    return oldest;
+  }
+  async setChannel(address, channel) {
+    channel.closeCallback = async () => this.removeChannel(address, channel.session);
+    const currentChannels = this.#channels.get(address) ?? [];
+    currentChannels.push(channel);
+    this.#channels.set(address, currentChannels);
+    if (currentChannels.length > this.#caseSessionsPerFabricAndNode) {
+      const oldestChannel = this.#findLeastActiveChannel(currentChannels);
+      const { session: oldSession } = oldestChannel;
+      if (channel.session.id !== oldSession.id) {
+        await oldSession.destroy(false, false);
+      }
+      logger.info(`Close oldest channel for fabric ${(0, import_PeerAddress.PeerAddress)(address)} (from session ${oldSession.id})`);
+      await oldestChannel.close();
+    }
+  }
+  hasChannel(address) {
+    return !!this.#channels.get(address)?.length;
+  }
+  getChannel(address, session) {
+    let results = this.#channels.get(address) ?? [];
+    if (session !== void 0) {
+      results = results.filter((channel) => channel.session.id === session.id);
+    }
+    if (results.length === 0)
+      throw new NoChannelError(
+        `Can't find a channel to ${(0, import_PeerAddress.PeerAddress)(address)}${session !== void 0 ? ` session ${session.id}` : ""}`
+      );
+    return results[results.length - 1];
+  }
+  /**
+   * Returns the last established session for a Fabric and Node
+   */
+  getChannelForSession(session) {
+    if (session.isSecure && !session.isPase) {
+      const secureSession = session;
+      const fabric = secureSession.fabric;
+      const nodeId = secureSession.peerNodeId;
+      if (fabric === void 0) {
+        return this.#paseChannels.get(session);
+      }
+      return this.getChannel(fabric.addressOf(nodeId), session);
+    }
+    return this.#paseChannels.get(session);
+  }
+  async removeAllNodeChannels(address) {
+    const channelsToRemove = this.#channels.get(address) ?? [];
+    for (const channel of channelsToRemove) {
+      await channel.close();
+    }
+  }
+  async removeChannel(address, session) {
+    const fabricChannels = this.#channels.get(address) ?? [];
+    const channelEntryIndex = fabricChannels.findIndex(
+      ({ session: entrySession }) => entrySession.id === session.id
+    );
+    if (channelEntryIndex === -1) {
+      return;
+    }
+    const channelEntry = fabricChannels.splice(channelEntryIndex, 1)[0];
+    if (channelEntry === void 0) {
+      return;
+    }
+    await channelEntry.close();
+    this.#channels.set(address, fabricChannels);
+  }
+  getOrCreateAsPaseChannel(byteArrayChannel, session) {
+    const msgChannel = new import_ExchangeManager.MessageChannel(
+      byteArrayChannel,
+      session,
+      async () => void this.#paseChannels.delete(session)
+    );
+    this.#paseChannels.set(session, msgChannel);
+    return msgChannel;
+  }
+  async getOrCreateChannel(byteArrayChannel, session) {
+    if (!session.isSecure) {
+      return this.getOrCreateAsPaseChannel(byteArrayChannel, session);
+    }
+    const secureSession = session;
+    const fabric = secureSession.fabric;
+    const nodeId = secureSession.peerNodeId;
+    if (fabric === void 0) {
+      return this.getOrCreateAsPaseChannel(byteArrayChannel, session);
+    }
+    const address = fabric.addressOf(nodeId);
+    try {
+      return this.getChannel(address, session);
+    } catch (e) {
+      NoChannelError.accept(e);
+    }
+    const result = new import_ExchangeManager.MessageChannel(byteArrayChannel, session, async () => this.removeChannel(address, session));
+    await this.setChannel(address, result);
+    return result;
+  }
+  async close() {
+    for (const channel of this.#paseChannels.values()) {
+      await channel.close();
+    }
+    this.#paseChannels.clear();
+    for (const channels of this.#channels.values()) {
+      for (const channel of channels) {
+        await channel.close();
+      }
+    }
+    this.#channels.clear();
+  }
+}
+//# sourceMappingURL=ChannelManager.js.map

package/dist/cjs/protocol/ChannelManager.js.map

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

package/dist/cjs/protocol/DeviceAdvertiser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommissioningMode, CommissioningModeInstanceData, InstanceBroadcaster } from "#common/InstanceBroadcaster.js";
+import { Fabric } from "#fabric/Fabric.js";
+import { FabricManager } from "#fabric/FabricManager.js";
+import { AsyncObservable, Environment, Environmental } from "#general";
+import { SessionManager } from "#session/SessionManager.js";
+/**
+ * Interfaces the {@link DeviceAdvertiser} with other components.
+ */
+export interface DeviceAdvertiserContext {
+    fabrics: FabricManager;
+    sessions: SessionManager;
+}
+/**
+ * Advertises a node for commissioning (if uncommissioned) or operationally (if commissioned).
+ */
+export declare class DeviceAdvertiser {
+    #private;
+    constructor(context: DeviceAdvertiserContext);
+    [Environmental.create](env: Environment): DeviceAdvertiser;
+    /**
+     * Emitted when the advertising window closes with no response.
+     */
+    get timedOut(): AsyncObservable<[], void>;
+    /**
+     * Emitted when the device stops advertising due to decommissioning.
+     */
+    get operationalModeEnded(): AsyncObservable<[], void>;
+    enterCommissioningMode(mode: CommissioningMode, deviceData: CommissioningModeInstanceData): Promise<void>;
+    exitCommissioningMode(): Promise<void>;
+    startAdvertising(): Promise<void>;
+    advertise(once?: boolean): Promise<void>;
+    advertiseFabrics(fabrics: Fabric[], expireCommissioningAnnouncement?: boolean): Promise<void>;
+    close(): Promise<void>;
+    hasBroadcaster(broadcaster: InstanceBroadcaster): boolean;
+    addBroadcaster(broadcaster: InstanceBroadcaster): void;
+    deleteBroadcaster(broadcaster: InstanceBroadcaster): Promise<void>;
+}
+//# sourceMappingURL=DeviceAdvertiser.d.ts.map

package/dist/cjs/protocol/DeviceAdvertiser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceAdvertiser.d.ts","sourceRoot":"","sources":["../../../src/protocol/DeviceAdvertiser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACvH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EACH,eAAe,EAEf,WAAW,EACX,aAAa,EAMhB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAK5D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,gBAAgB;;gBAgBb,OAAO,EAAE,uBAAuB;IA6B5C,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW;IASvC;;OAEG;IACH,IAAI,QAAQ,8BAEX;IAED;;OAEG;IACH,IAAI,oBAAoB,8BAEvB;IAEK,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,6BAA6B;IAQzF,qBAAqB;IASrB,gBAAgB;IAUhB,SAAS,CAAC,IAAI,UAAQ;IA0CtB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,+BAA+B,UAAQ;IAa3E,KAAK;IAQX,cAAc,CAAC,WAAW,EAAE,mBAAmB;IAI/C,cAAc,CAAC,WAAW,EAAE,mBAAmB;IAIzC,iBAAiB,CAAC,WAAW,EAAE,mBAAmB;CAK3D"}

package/dist/cjs/protocol/DeviceAdvertiser.js

@@ -0,0 +1,185 @@
+"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 DeviceAdvertiser_exports = {};
+__export(DeviceAdvertiser_exports, {
+  DeviceAdvertiser: () => DeviceAdvertiser
+});
+module.exports = __toCommonJS(DeviceAdvertiser_exports);
+var import_InstanceBroadcaster = require("#common/InstanceBroadcaster.js");
+var import_FabricManager = require("#fabric/FabricManager.js");
+var import_general = require("#general");
+var import_SessionManager = require("#session/SessionManager.js");
+var import_types = require("#types");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("DeviceAdvertiser");
+class DeviceAdvertiser {
+  #context;
+  #broadcasters = /* @__PURE__ */ new Set();
+  #timedOut = (0, import_general.AsyncObservable)();
+  #operationalModeEnded = new import_general.AsyncObservable();
+  #observers = new import_general.ObserverGroup();
+  #interval;
+  #startTime = null;
+  #isClosing = false;
+  #commissioningMode = import_InstanceBroadcaster.CommissioningMode.NotCommissioning;
+  // Currently we do not put much effort into synchronizing announcements as it probably isn't really necessary.  But
+  // this mutex prevents automated announcements from piling up and allows us to ensure announcements are complete on
+  // close
+  #mutex = new import_general.Mutex(this);
+  constructor(context) {
+    this.#context = context;
+    this.#interval = import_general.Time.getPeriodicTimer(
+      "Server node announcement",
+      import_types.DEVICE_ANNOUNCEMENT_INTERVAL_MS,
+      () => (
+        // Announcement needs to await a previous announcement because otherwise in testing at least announcement
+        // may crash if started simultaneously
+        this.#mutex.run(() => this.advertise())
+      )
+    );
+    this.#observers.on(this.#context.fabrics.events.deleted, async () => {
+      if (this.#context.fabrics.getFabrics().length === 0) {
+        await this.#exitOperationalMode();
+      }
+    });
+    this.#observers.on(this.#context.sessions.resubmissionStarted, (nodeId) => {
+      logger.debug(`Resubmission started, re-announce node ${nodeId}`);
+      this.advertise(true).catch((error) => logger.warn("Error sending announcement:", error));
+    });
+    this.#observers.on(this.#context.sessions.subscriptionsChanged, (_session, subscription) => {
+      if (subscription.isCanceledByPeer) {
+        logger.debug(`Subscription canceled by peer, re-announce`);
+        this.startAdvertising().catch((error) => logger.warn("Error sending announcement:", error));
+      }
+    });
+  }
+  [import_general.Environmental.create](env) {
+    const instance = new DeviceAdvertiser({
+      fabrics: env.get(import_FabricManager.FabricManager),
+      sessions: env.get(import_SessionManager.SessionManager)
+    });
+    env.set(DeviceAdvertiser, instance);
+    return instance;
+  }
+  /**
+   * Emitted when the advertising window closes with no response.
+   */
+  get timedOut() {
+    return this.#timedOut;
+  }
+  /**
+   * Emitted when the device stops advertising due to decommissioning.
+   */
+  get operationalModeEnded() {
+    return this.#operationalModeEnded;
+  }
+  async enterCommissioningMode(mode, deviceData) {
+    this.#commissioningMode = mode;
+    for (const broadcaster of this.#broadcasters) {
+      await broadcaster.setCommissionMode(mode, deviceData);
+    }
+    await this.startAdvertising();
+  }
+  async exitCommissioningMode() {
+    this.#commissioningMode = import_InstanceBroadcaster.CommissioningMode.NotCommissioning;
+    this.#interval.stop();
+    this.#startTime = null;
+    for (const broadcaster of this.#broadcasters) {
+      await broadcaster.expireCommissioningAnnouncement();
+    }
+  }
+  async startAdvertising() {
+    if (this.#isClosing) return;
+    if (this.#interval.isRunning) {
+      this.#interval.stop();
+    }
+    this.#startTime = import_general.Time.nowMs();
+    this.#interval.start();
+    await this.advertise();
+  }
+  async advertise(once = false) {
+    if (!once) {
+      if (this.#startTime !== null && import_general.Time.nowMs() - this.#startTime > import_types.DEVICE_ANNOUNCEMENT_DURATION_MS) {
+        logger.debug("Announcement duration reached, stop announcing");
+        await this.#timedOut.emit();
+        return;
+      }
+      if (this.#commissioningMode !== import_InstanceBroadcaster.CommissioningMode.NotCommissioning) {
+        for (const broadcaster of this.#broadcasters) {
+          await broadcaster.announce();
+        }
+        return;
+      }
+    }
+    const fabrics = this.#context.fabrics.getFabrics();
+    if (fabrics.length) {
+      let fabricsWithoutSessions = 0;
+      for (const fabric of fabrics) {
+        const session = this.#context.sessions.getSessionForNode(fabric.addressOf(fabric.rootNodeId));
+        if (session === void 0 || !session.isSecure || session.subscriptions.size === 0) {
+          fabricsWithoutSessions++;
+          logger.debug("Announcing", import_general.Diagnostic.dict({ fabric: fabric.fabricId }));
+        }
+      }
+      for (const broadcaster of this.#broadcasters) {
+        await broadcaster.setFabrics(fabrics);
+        if (fabricsWithoutSessions > 0 || this.#commissioningMode !== import_InstanceBroadcaster.CommissioningMode.NotCommissioning) {
+          await broadcaster.announce();
+        }
+      }
+    } else {
+      await this.#exitOperationalMode();
+      await this.#operationalModeEnded.emit();
+    }
+  }
+  async advertiseFabrics(fabrics, expireCommissioningAnnouncement = false) {
+    for (const broadcaster of this.#broadcasters) {
+      await broadcaster.setFabrics(fabrics, expireCommissioningAnnouncement);
+      await broadcaster.announce();
+    }
+  }
+  async #exitOperationalMode() {
+    for (const broadcaster of this.#broadcasters) {
+      await broadcaster.expireFabricAnnouncement();
+    }
+  }
+  async close() {
+    await this.#mutex;
+    this.#observers.close();
+    for (const broadcaster of this.#broadcasters) {
+      await broadcaster.close();
+    }
+  }
+  hasBroadcaster(broadcaster) {
+    return this.#broadcasters.has(broadcaster);
+  }
+  addBroadcaster(broadcaster) {
+    this.#broadcasters.add(broadcaster);
+  }
+  async deleteBroadcaster(broadcaster) {
+    if (this.#broadcasters.delete(broadcaster)) {
+      await broadcaster.expireAllAnnouncements();
+    }
+  }
+}
+//# sourceMappingURL=DeviceAdvertiser.js.map

package/dist/cjs/protocol/DeviceAdvertiser.js.map

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

package/dist/cjs/protocol/DeviceCommissioner.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FailsafeContext } from "#common/FailsafeContext.js";
+import { FabricManager } from "#fabric/FabricManager.js";
+import { Environment, Environmental } from "#general";
+import { SecureChannelProtocol } from "#securechannel/SecureChannelProtocol.js";
+import { PaseServer, SessionManager } from "#session/index.js";
+import { CommissioningOptions } from "#types";
+import { DeviceAdvertiser } from "./DeviceAdvertiser.js";
+/**
+ * The component allows commissioning configuration to change after the {@link DeviceCommissioner} is initialized.
+ */
+export declare abstract class CommissioningConfigProvider {
+    abstract values: CommissioningOptions.Configuration;
+}
+/**
+ * Interfaces the {@link DeviceCommissioner} with other components.
+ */
+export interface DeviceCommissionerContext {
+    fabrics: FabricManager;
+    sessions: SessionManager;
+    advertiser: DeviceAdvertiser;
+    secureChannelProtocol: SecureChannelProtocol;
+    commissioningConfig: CommissioningConfigProvider;
+}
+/**
+ * Implements commissioning for devices.
+ *
+ * Note this implements commissioning for a *local* device; use {@link ControllerCommissioner} to commission a *remote*
+ * device.
+ */
+export declare class DeviceCommissioner {
+    #private;
+    constructor(context: DeviceCommissionerContext);
+    [Environmental.create](env: Environment): DeviceCommissioner;
+    get failsafeContext(): FailsafeContext;
+    allowEnhancedCommissioning(discriminator: number, paseServer: PaseServer, commissioningEndCallback: () => void): Promise<void>;
+    allowBasicCommissioning(commissioningEndCallback?: () => void): Promise<void>;
+    beginTimed(failsafeContext: FailsafeContext): Promise<void>;
+    get isFailsafeArmed(): boolean;
+    assertFailsafeArmed(message?: string): void;
+    reactivateAdvertiser(): void;
+    endCommissioning(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=DeviceCommissioner.d.ts.map

package/dist/cjs/protocol/DeviceCommissioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceCommissioner.d.ts","sourceRoot":"","sources":["../../../src/protocol/DeviceCommissioner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAGH,WAAW,EACX,aAAa,EAMhB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAmC,MAAM,QAAQ,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD;;GAEG;AACH,8BAAsB,2BAA2B;IAC7C,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,aAAa,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,mBAAmB,EAAE,2BAA2B,CAAC;CACpD;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;;gBAQf,OAAO,EAAE,yBAAyB;IAsC9C,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW;IAYvC,IAAI,eAAe,oBAGlB;IAEK,0BAA0B,CAC5B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,UAAU,EACtB,wBAAwB,EAAE,MAAM,IAAI;IAgBlC,uBAAuB,CAAC,wBAAwB,CAAC,EAAE,MAAM,IAAI;IAoB7D,UAAU,CAAC,eAAe,EAAE,eAAe;IAwBjD,IAAI,eAAe,YAElB;IAED,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM;IAQpC,oBAAoB;IAsDd,gBAAgB;IA0BhB,KAAK;CAQd"}