@forgeax/engine-net-websocket 0.0.0-dev.8d955ade1c79

package/dist/browser.mjs

@@ -0,0 +1,261 @@
+import { EndpointError, ENDPOINT_ERROR_HINTS, ENDPOINT_EXPECTED } from '@forgeax/engine-net';
+import { ok, err } from '@forgeax/engine-types';
+
+// src/websocket-client-core.ts
+
+// src/event-queue.ts
+var DEFAULT_MAX_QUEUED_EVENTS = 1024;
+var BoundedEventQueue = class {
+  constructor(maxQueuedEvents) {
+    this.maxQueuedEvents = maxQueuedEvents;
+    if (!Number.isInteger(maxQueuedEvents) || maxQueuedEvents < 1) {
+      throw new RangeError("maxQueuedEvents must be a positive integer");
+    }
+  }
+  maxQueuedEvents;
+  #events = [];
+  #closed = false;
+  #disconnectReason;
+  get closed() {
+    return this.#closed;
+  }
+  get disconnectReason() {
+    return this.#disconnectReason;
+  }
+  enqueue(event) {
+    if (this.#closed) return false;
+    if (this.#events.length === this.maxQueuedEvents) {
+      this.close(`event queue overflow (maxQueuedEvents=${this.maxQueuedEvents})`);
+      return false;
+    }
+    this.#events.push(event);
+    return true;
+  }
+  close(reason) {
+    if (this.#closed) return;
+    this.#closed = true;
+    this.#disconnectReason = reason;
+  }
+  drain() {
+    return this.#events.splice(0);
+  }
+};
+
+// src/websocket-client-core.ts
+var CLIENT_PEER_ID = 1;
+function createWebSocketClientEndpoint(WebSocket2, options) {
+  return new Promise((resolve) => {
+    const clientPeerId = options.peerId ?? CLIENT_PEER_ID;
+    const signal = options.signal ?? new AbortController().signal;
+    if (signal.aborted) {
+      resolve(connectionFailed(options.url, "WebSocket connection aborted."));
+      return;
+    }
+    let queue;
+    try {
+      queue = new BoundedEventQueue(options.maxQueuedEvents ?? DEFAULT_MAX_QUEUED_EVENTS);
+    } catch (cause) {
+      resolve(connectionFailed(options.url, cause));
+      return;
+    }
+    let socket;
+    try {
+      socket = new WebSocket2(options.url);
+      socket.binaryType = "arraybuffer";
+    } catch (cause) {
+      resolve(connectionFailed(options.url, cause));
+      return;
+    }
+    const terminalEvents = [];
+    let opened = false;
+    let settled = false;
+    let closed = false;
+    let locallyClosed = false;
+    let messageTail = Promise.resolve();
+    const removeAbortListener = () => {
+      signal.removeEventListener("abort", abortPendingConnection);
+    };
+    const abortPendingConnection = () => {
+      if (opened || settled) return;
+      settled = true;
+      try {
+        socket.close();
+      } catch {
+      }
+      removeAbortListener();
+      resolve(connectionFailed(options.url, "WebSocket connection aborted."));
+    };
+    signal.addEventListener("abort", abortPendingConnection, { once: true });
+    if (signal.aborted) {
+      abortPendingConnection();
+      return;
+    }
+    const disconnect = (reason) => {
+      if (closed) return;
+      closed = true;
+      queue.close(reason);
+      terminalEvents.push({ kind: "peer-disconnected", peerId: clientPeerId });
+    };
+    const endpoint = {
+      poll: () => [...queue.drain(), ...terminalEvents.splice(0)],
+      send: (peerId, data) => {
+        if (closed) return locallyClosed ? alreadyClosed() : connectionClosed(peerId);
+        if (peerId !== clientPeerId)
+          return err(
+            new EndpointError({
+              code: "peer-not-found",
+              expected: ENDPOINT_EXPECTED["peer-not-found"],
+              hint: ENDPOINT_ERROR_HINTS["peer-not-found"],
+              detail: { peerId }
+            })
+          );
+        if (socket.readyState !== socket.OPEN)
+          return err(
+            new EndpointError({
+              code: "connection-closed",
+              expected: ENDPOINT_EXPECTED["connection-closed"],
+              hint: ENDPOINT_ERROR_HINTS["connection-closed"],
+              detail: { peerId }
+            })
+          );
+        try {
+          socket.send(data);
+          return ok(void 0);
+        } catch (cause) {
+          return err(
+            new EndpointError({
+              code: "send-failed",
+              expected: ENDPOINT_EXPECTED["send-failed"],
+              hint: ENDPOINT_ERROR_HINTS["send-failed"],
+              detail: { peerId, cause: normalizeCause(cause) }
+            })
+          );
+        }
+      },
+      close: () => {
+        if (closed)
+          return err(
+            new EndpointError({
+              code: "already-closed",
+              expected: ENDPOINT_EXPECTED["already-closed"],
+              hint: ENDPOINT_ERROR_HINTS["already-closed"],
+              detail: { cause: "The WebSocket endpoint is already closed." }
+            })
+          );
+        locallyClosed = true;
+        disconnect("Endpoint close requested.");
+        socket.close();
+        return ok(void 0);
+      }
+    };
+    socket.onopen = () => {
+      if (settled) return;
+      removeAbortListener();
+      opened = true;
+      settled = true;
+      queue.enqueue({ kind: "peer-connected", peerId: clientPeerId });
+      resolve(ok(endpoint));
+    };
+    socket.onmessage = ({ data }) => {
+      messageTail = messageTail.then(async () => {
+        const bytes = await options.toBytes(data);
+        if (!bytes || closed) return;
+        if (!queue.enqueue({ kind: "message", peerId: clientPeerId, data: bytes })) {
+          socket.close();
+        }
+      }).catch(() => void 0);
+    };
+    socket.onerror = (cause) => {
+      if (opened) disconnect(`WebSocket error: ${normalizeCause(cause)}`);
+      else if (!settled) {
+        settled = true;
+        removeAbortListener();
+        resolve(connectionFailed(options.url, cause));
+      }
+    };
+    socket.onclose = (cause) => {
+      if (!opened && !settled) {
+        settled = true;
+        removeAbortListener();
+        resolve(connectionFailed(options.url, cause));
+        return;
+      }
+      disconnect(`WebSocket closed: ${normalizeCause(cause)}`);
+    };
+  });
+}
+function connectionFailed(address, cause) {
+  return err(
+    new EndpointError({
+      code: "connection-failed",
+      expected: ENDPOINT_EXPECTED["connection-failed"],
+      hint: ENDPOINT_ERROR_HINTS["connection-failed"],
+      detail: { address, cause: normalizeCause(cause) }
+    })
+  );
+}
+function alreadyClosed() {
+  return err(
+    new EndpointError({
+      code: "already-closed",
+      expected: ENDPOINT_EXPECTED["already-closed"],
+      hint: ENDPOINT_ERROR_HINTS["already-closed"],
+      detail: { cause: "The WebSocket endpoint is closed." }
+    })
+  );
+}
+function connectionClosed(peerId) {
+  return err(
+    new EndpointError({
+      code: "connection-closed",
+      expected: ENDPOINT_EXPECTED["connection-closed"],
+      hint: ENDPOINT_ERROR_HINTS["connection-closed"],
+      detail: { peerId }
+    })
+  );
+}
+function normalizeCause(cause) {
+  if (cause instanceof Error) return cause.message;
+  if (typeof cause === "string") return cause;
+  return "WebSocket operation failed without a platform error message.";
+}
+
+// src/websocket-connector.ts
+function createWebSocketConnectorAdapter(runtime, url, options = {}) {
+  let nextPeerId = 1;
+  return {
+    connect: (signal) => {
+      const peerId = nextPeerId++;
+      return createWebSocketClientEndpoint(runtime.WebSocket, {
+        url,
+        maxQueuedEvents: options.maxQueuedEvents,
+        peerId,
+        signal,
+        toBytes: runtime.toBytes
+      });
+    }
+  };
+}
+
+// src/browser.ts
+function createWebSocketConnector(url, options = {}) {
+  return createWebSocketConnectorAdapter(
+    { WebSocket, toBytes },
+    url,
+    options
+  );
+}
+function connectWebSocketClientEndpoint(url, options = {}) {
+  return createWebSocketConnector(url, options).connect(new AbortController().signal);
+}
+function toBytes(data) {
+  if (data instanceof ArrayBuffer) return new Uint8Array(data);
+  if (typeof Blob !== "undefined" && data instanceof Blob) {
+    return data.arrayBuffer().then((buffer) => new Uint8Array(buffer));
+  }
+  return void 0;
+}
+
+export { connectWebSocketClientEndpoint, createWebSocketConnector };
+//# sourceMappingURL=browser.mjs.map
+//# sourceMappingURL=browser.mjs.map

package/dist/browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-queue.ts","../src/websocket-client-core.ts","../src/websocket-connector.ts","../src/browser.ts"],"names":["WebSocket"],"mappings":"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","file":"browser.mjs","sourcesContent":["import type { EndpointEvent } from '@forgeax/engine-net';\n\nexport const DEFAULT_MAX_QUEUED_EVENTS = 1024;\n\nexport class BoundedEventQueue {\n  readonly #events: EndpointEvent[] = [];\n  #closed = false;\n  #disconnectReason: string | undefined;\n\n  constructor(readonly maxQueuedEvents: number) {\n    if (!Number.isInteger(maxQueuedEvents) || maxQueuedEvents < 1) {\n      throw new RangeError('maxQueuedEvents must be a positive integer');\n    }\n  }\n\n  get closed(): boolean {\n    return this.#closed;\n  }\n\n  get disconnectReason(): string | undefined {\n    return this.#disconnectReason;\n  }\n\n  enqueue(event: EndpointEvent): boolean {\n    if (this.#closed) return false;\n    if (this.#events.length === this.maxQueuedEvents) {\n      this.close(`event queue overflow (maxQueuedEvents=${this.maxQueuedEvents})`);\n      return false;\n    }\n    this.#events.push(event);\n    return true;\n  }\n\n  close(reason: string): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    this.#disconnectReason = reason;\n  }\n\n  drain(): EndpointEvent[] {\n    return this.#events.splice(0);\n  }\n}\n","import {\n  ENDPOINT_ERROR_HINTS,\n  ENDPOINT_EXPECTED,\n  EndpointError,\n  type EndpointEvent,\n  type NetEndpoint,\n  type PeerId,\n} from '@forgeax/engine-net';\nimport { err, ok, type Result } from '@forgeax/engine-types';\nimport { BoundedEventQueue, DEFAULT_MAX_QUEUED_EVENTS } from './event-queue';\n\nexport interface WebSocketLike {\n  readonly CONNECTING: number;\n  readonly OPEN: number;\n  readonly CLOSING: number;\n  readonly CLOSED: number;\n  readonly readyState: number;\n  binaryType?: string;\n  onopen: ((event: unknown) => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onerror: ((event: unknown) => void) | null;\n  onclose: ((event: unknown) => void) | null;\n  send(data: Uint8Array): void;\n  close(): void;\n}\n\nexport interface WebSocketConstructor {\n  new (url: string): WebSocketLike;\n}\n\nexport interface WebSocketClientCoreOptions {\n  readonly url: string;\n  readonly maxQueuedEvents?: number | undefined;\n  readonly peerId?: PeerId;\n  readonly signal?: AbortSignal;\n  readonly toBytes: (data: unknown) => Uint8Array | Promise<Uint8Array | undefined> | undefined;\n}\n\nconst CLIENT_PEER_ID = 1 as PeerId;\n\nexport function createWebSocketClientEndpoint(\n  WebSocket: WebSocketConstructor,\n  options: WebSocketClientCoreOptions,\n): Promise<Result<NetEndpoint, EndpointError>> {\n  return new Promise((resolve) => {\n    const clientPeerId = options.peerId ?? CLIENT_PEER_ID;\n    const signal = options.signal ?? new AbortController().signal;\n    if (signal.aborted) {\n      resolve(connectionFailed(options.url, 'WebSocket connection aborted.'));\n      return;\n    }\n\n    let queue: BoundedEventQueue;\n    try {\n      queue = new BoundedEventQueue(options.maxQueuedEvents ?? DEFAULT_MAX_QUEUED_EVENTS);\n    } catch (cause) {\n      resolve(connectionFailed(options.url, cause));\n      return;\n    }\n\n    let socket: WebSocketLike;\n    try {\n      socket = new WebSocket(options.url);\n      socket.binaryType = 'arraybuffer';\n    } catch (cause) {\n      resolve(connectionFailed(options.url, cause));\n      return;\n    }\n\n    const terminalEvents: EndpointEvent[] = [];\n    let opened = false;\n    let settled = false;\n    let closed = false;\n    let locallyClosed = false;\n    let messageTail = Promise.resolve();\n\n    const removeAbortListener = (): void => {\n      signal.removeEventListener('abort', abortPendingConnection);\n    };\n\n    const abortPendingConnection = (): void => {\n      if (opened || settled) return;\n      settled = true;\n      try {\n        socket.close();\n      } catch {\n        // Closing a partially opened platform socket is best effort.\n      }\n      removeAbortListener();\n      resolve(connectionFailed(options.url, 'WebSocket connection aborted.'));\n    };\n\n    signal.addEventListener('abort', abortPendingConnection, { once: true });\n    if (signal.aborted) {\n      abortPendingConnection();\n      return;\n    }\n\n    const disconnect = (reason: string): void => {\n      if (closed) return;\n      closed = true;\n      queue.close(reason);\n      terminalEvents.push({ kind: 'peer-disconnected', peerId: clientPeerId });\n    };\n\n    const endpoint: NetEndpoint = {\n      poll: () => [...queue.drain(), ...terminalEvents.splice(0)],\n      send: (peerId, data) => {\n        if (closed) return locallyClosed ? alreadyClosed() : connectionClosed(peerId);\n        if (peerId !== clientPeerId)\n          return err(\n            new EndpointError({\n              code: 'peer-not-found',\n              expected: ENDPOINT_EXPECTED['peer-not-found'],\n              hint: ENDPOINT_ERROR_HINTS['peer-not-found'],\n              detail: { peerId },\n            }),\n          );\n        if (socket.readyState !== socket.OPEN)\n          return err(\n            new EndpointError({\n              code: 'connection-closed',\n              expected: ENDPOINT_EXPECTED['connection-closed'],\n              hint: ENDPOINT_ERROR_HINTS['connection-closed'],\n              detail: { peerId },\n            }),\n          );\n        try {\n          socket.send(data);\n          return ok(undefined);\n        } catch (cause) {\n          return err(\n            new EndpointError({\n              code: 'send-failed',\n              expected: ENDPOINT_EXPECTED['send-failed'],\n              hint: ENDPOINT_ERROR_HINTS['send-failed'],\n              detail: { peerId, cause: normalizeCause(cause) },\n            }),\n          );\n        }\n      },\n      close: () => {\n        if (closed)\n          return err(\n            new EndpointError({\n              code: 'already-closed',\n              expected: ENDPOINT_EXPECTED['already-closed'],\n              hint: ENDPOINT_ERROR_HINTS['already-closed'],\n              detail: { cause: 'The WebSocket endpoint is already closed.' },\n            }),\n          );\n        locallyClosed = true;\n        disconnect('Endpoint close requested.');\n        socket.close();\n        return ok(undefined);\n      },\n    };\n\n    socket.onopen = () => {\n      if (settled) return;\n      removeAbortListener();\n      opened = true;\n      settled = true;\n      queue.enqueue({ kind: 'peer-connected', peerId: clientPeerId });\n      resolve(ok(endpoint));\n    };\n    socket.onmessage = ({ data }) => {\n      // Blob.arrayBuffer() is asynchronous. Serialize conversion so that\n      // ordered WebSocket messages retain their wire order after decoding.\n      messageTail = messageTail\n        .then(async () => {\n          const bytes = await options.toBytes(data);\n          if (!bytes || closed) return;\n          if (!queue.enqueue({ kind: 'message', peerId: clientPeerId, data: bytes })) {\n            socket.close();\n          }\n        })\n        .catch(() => undefined);\n    };\n    socket.onerror = (cause) => {\n      if (opened) disconnect(`WebSocket error: ${normalizeCause(cause)}`);\n      else if (!settled) {\n        settled = true;\n        removeAbortListener();\n        resolve(connectionFailed(options.url, cause));\n      }\n    };\n    socket.onclose = (cause) => {\n      if (!opened && !settled) {\n        settled = true;\n        removeAbortListener();\n        resolve(connectionFailed(options.url, cause));\n        return;\n      }\n      disconnect(`WebSocket closed: ${normalizeCause(cause)}`);\n    };\n  });\n}\n\nfunction connectionFailed(address: string, cause: unknown): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'connection-failed',\n      expected: ENDPOINT_EXPECTED['connection-failed'],\n      hint: ENDPOINT_ERROR_HINTS['connection-failed'],\n      detail: { address, cause: normalizeCause(cause) },\n    }),\n  );\n}\n\nfunction alreadyClosed(): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'already-closed',\n      expected: ENDPOINT_EXPECTED['already-closed'],\n      hint: ENDPOINT_ERROR_HINTS['already-closed'],\n      detail: { cause: 'The WebSocket endpoint is closed.' },\n    }),\n  );\n}\n\nfunction connectionClosed(peerId: PeerId): Result<never, EndpointError> {\n  return err(\n    new EndpointError({\n      code: 'connection-closed',\n      expected: ENDPOINT_EXPECTED['connection-closed'],\n      hint: ENDPOINT_ERROR_HINTS['connection-closed'],\n      detail: { peerId },\n    }),\n  );\n}\n\nfunction normalizeCause(cause: unknown): string {\n  if (cause instanceof Error) return cause.message;\n  if (typeof cause === 'string') return cause;\n  return 'WebSocket operation failed without a platform error message.';\n}\n","import type { NetEndpointConnector, PeerId } from '@forgeax/engine-net';\nimport {\n  createWebSocketClientEndpoint,\n  type WebSocketClientCoreOptions,\n  type WebSocketConstructor,\n} from './websocket-client-core';\n\nexport interface WebSocketConnectorOptions {\n  readonly maxQueuedEvents?: number | undefined;\n}\n\nexport interface WebSocketConnectorRuntime {\n  readonly WebSocket: WebSocketConstructor;\n  readonly toBytes: WebSocketClientCoreOptions['toBytes'];\n}\n\nexport function createWebSocketConnectorAdapter(\n  runtime: WebSocketConnectorRuntime,\n  url: string,\n  options: WebSocketConnectorOptions = {},\n): NetEndpointConnector {\n  let nextPeerId = 1;\n  return {\n    connect: (signal) => {\n      const peerId = nextPeerId++ as PeerId;\n      return createWebSocketClientEndpoint(runtime.WebSocket, {\n        url,\n        maxQueuedEvents: options.maxQueuedEvents,\n        peerId,\n        signal,\n        toBytes: runtime.toBytes,\n      });\n    },\n  };\n}\n","import type { EndpointError, NetEndpoint, NetEndpointConnector } from '@forgeax/engine-net';\nimport type { Result } from '@forgeax/engine-types';\nimport type { WebSocketConstructor } from './websocket-client-core';\nimport {\n  createWebSocketConnectorAdapter,\n  type WebSocketConnectorOptions,\n} from './websocket-connector';\n\nexport interface ConnectWebSocketClientEndpointOptions {\n  readonly maxQueuedEvents?: number | undefined;\n}\n\n/**\n * Creates the browser WebSocket adapter for the public NetEndpointConnector.\n * Each connect call accepts an AbortSignal and creates one replacement-capable\n * NetEndpoint. Transport lifecycle and EndpointError results stay here;\n * authoritative resync and replication policy stay with NetSession.\n */\nexport function createWebSocketConnector(\n  url: string,\n  options: WebSocketConnectorOptions = {},\n): NetEndpointConnector {\n  return createWebSocketConnectorAdapter(\n    { WebSocket: WebSocket as unknown as WebSocketConstructor, toBytes },\n    url,\n    options,\n  );\n}\n\n/**\n * Connects one browser WebSocket with the default one-shot AbortSignal.\n * Use createWebSocketConnector when the caller must cancel or replace an\n * endpoint through an explicit signal.\n */\nexport function connectWebSocketClientEndpoint(\n  url: string,\n  options: ConnectWebSocketClientEndpointOptions = {},\n): Promise<Result<NetEndpoint, EndpointError>> {\n  return createWebSocketConnector(url, options).connect(new AbortController().signal);\n}\n\nfunction toBytes(data: unknown): Uint8Array | Promise<Uint8Array | undefined> | undefined {\n  if (data instanceof ArrayBuffer) return new Uint8Array(data);\n  if (typeof Blob !== 'undefined' && data instanceof Blob) {\n    return data.arrayBuffer().then((buffer) => new Uint8Array(buffer));\n  }\n  return undefined;\n}\n"]}

package/dist/event-queue.d.ts

@@ -0,0 +1,13 @@
+import type { EndpointEvent } from '@forgeax/engine-net';
+export declare const DEFAULT_MAX_QUEUED_EVENTS = 1024;
+export declare class BoundedEventQueue {
+    #private;
+    readonly maxQueuedEvents: number;
+    constructor(maxQueuedEvents: number);
+    get closed(): boolean;
+    get disconnectReason(): string | undefined;
+    enqueue(event: EndpointEvent): boolean;
+    close(reason: string): void;
+    drain(): EndpointEvent[];
+}
+//# sourceMappingURL=event-queue.d.ts.map

package/dist/event-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-queue.d.ts","sourceRoot":"","sources":["../src/event-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,qBAAa,iBAAiB;;IAKhB,QAAQ,CAAC,eAAe,EAAE,MAAM;gBAAvB,eAAe,EAAE,MAAM;IAM5C,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAUtC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3B,KAAK,IAAI,aAAa,EAAE;CAGzB"}

package/dist/node.d.ts

@@ -0,0 +1,30 @@
+import { EndpointError, type NetEndpoint } from '@forgeax/engine-net';
+import { type Result } from '@forgeax/engine-types';
+export interface ListenWebSocketEndpointOptions {
+    readonly port: number;
+    readonly host?: string;
+    readonly maxPeers?: number;
+    readonly maxQueuedEvents?: number | undefined;
+}
+export interface ConnectWebSocketClientEndpointOptions {
+    readonly maxQueuedEvents?: number | undefined;
+}
+/**
+ * Creates the Node WebSocket adapter for the public NetEndpointConnector.
+ * Each connect call accepts an AbortSignal and creates one replacement-capable
+ * NetEndpoint. Transport lifecycle and EndpointError results stay here;
+ * authoritative resync and replication policy stay with NetSession.
+ */
+export declare function createWebSocketConnector(url: string, options?: ConnectWebSocketClientEndpointOptions): import('@forgeax/engine-net').NetEndpointConnector;
+/**
+ * Connects one Node WebSocket with the default one-shot AbortSignal.
+ * Use createWebSocketConnector when the caller must cancel or replace an
+ * endpoint through an explicit signal.
+ */
+export declare function connectWebSocketClientEndpoint(url: string, options?: ConnectWebSocketClientEndpointOptions): Promise<Result<NetEndpoint, EndpointError>>;
+/**
+ * Starts a Node WebSocket listener that exposes NetEndpoint peer events and
+ * binary messages without owning NetSession or replication policy.
+ */
+export declare function listenWebSocketEndpoint(options: ListenWebSocketEndpointOptions): Promise<Result<NetEndpoint, EndpointError>>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EAEb,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM7D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qCAA0C,GAClD,OAAO,qBAAqB,EAAE,oBAAoB,CASpD;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAE7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CA6H7C"}