@procwire/transport 0.1.3 → 0.3.0

package/dist/framing/length-prefixed.js

@@ -17,11 +17,17 @@ import { FramingError } from "../utils/errors.js";
 export class LengthPrefixedFraming {
     static HEADER_SIZE = 4;
     maxMessageSize;
-    buffer;
+    buffers;
+    totalLength;
     expectedLength;
     constructor(options = {}) {
+        // Validate options
+        if (options.maxMessageSize !== undefined && options.maxMessageSize <= 0) {
+            throw new Error("LengthPrefixedFraming: maxMessageSize must be positive");
+        }
         this.maxMessageSize = options.maxMessageSize ?? 32 * 1024 * 1024; // 32MB
-        this.buffer = Buffer.allocUnsafe(0);
+        this.buffers = [];
+        this.totalLength = 0;
         this.expectedLength = null;
     }
     /**
@@ -37,19 +43,26 @@ export class LengthPrefixedFraming {
      * Buffers partial headers and payloads.
      */
     decode(chunk) {
-        // Append chunk to buffer
-        this.buffer = Buffer.concat([this.buffer, chunk]);
+        // Append chunk to buffer list
+        if (chunk.length > 0) {
+            this.buffers.push(chunk);
+            this.totalLength += chunk.length;
+        }
         const frames = [];
         // Process all complete frames in buffer
         while (true) {
             // Do we need to read the header?
             if (this.expectedLength === null) {
                 // Need at least HEADER_SIZE bytes
-                if (this.buffer.length < LengthPrefixedFraming.HEADER_SIZE) {
+                if (this.totalLength < LengthPrefixedFraming.HEADER_SIZE) {
                     break; // Wait for more data
                 }
                 // Read length from header
-                const length = this.buffer.readUInt32BE(0);
+                const header = this.peekBytes(LengthPrefixedFraming.HEADER_SIZE);
+                if (!header) {
+                    break;
+                }
+                const length = header.readUInt32BE(0);
                 // Validate length
                 if (length > this.maxMessageSize) {
                     const error = new FramingError(`Message length ${length} exceeds maximum ${this.maxMessageSize}`);
@@ -57,23 +70,22 @@ export class LengthPrefixedFraming {
                     throw error;
                 }
                 this.expectedLength = length;
-                this.buffer = this.buffer.subarray(LengthPrefixedFraming.HEADER_SIZE);
+                this.consumeBytes(LengthPrefixedFraming.HEADER_SIZE);
             }
             // Do we have the complete payload?
-            if (this.buffer.length < this.expectedLength) {
+            if (this.totalLength < this.expectedLength) {
                 break; // Wait for more data
             }
             // Extract frame
-            const frame = this.buffer.subarray(0, this.expectedLength);
+            const frame = this.takeBytes(this.expectedLength);
             frames.push(frame);
             // Move past this frame
-            this.buffer = this.buffer.subarray(this.expectedLength);
             this.expectedLength = null;
         }
         // Validate buffer doesn't grow unbounded
         const maxBufferSize = LengthPrefixedFraming.HEADER_SIZE + this.maxMessageSize;
-        if (this.buffer.length > maxBufferSize) {
-            const error = new FramingError(`Buffer size ${this.buffer.length} exceeds maximum ${maxBufferSize}`);
+        if (this.totalLength > maxBufferSize) {
+            const error = new FramingError(`Buffer size ${this.totalLength} exceeds maximum ${maxBufferSize}`);
             this.reset();
             throw error;
         }
@@ -83,20 +95,87 @@ export class LengthPrefixedFraming {
      * Resets internal buffer state.
      */
     reset() {
-        this.buffer = Buffer.allocUnsafe(0);
+        this.buffers = [];
+        this.totalLength = 0;
         this.expectedLength = null;
     }
     /**
      * Returns true if there is buffered partial data.
      */
     hasBufferedData() {
-        return this.buffer.length > 0 || this.expectedLength !== null;
+        return this.totalLength > 0 || this.expectedLength !== null;
     }
     /**
      * Returns current buffer size in bytes.
      */
     getBufferSize() {
-        return this.buffer.length;
+        return this.totalLength;
+    }
+    peekBytes(length) {
+        if (length > this.totalLength || this.buffers.length === 0) {
+            return null;
+        }
+        const first = this.buffers[0];
+        if (first.length >= length) {
+            return first.subarray(0, length);
+        }
+        const parts = [];
+        let remaining = length;
+        for (const buffer of this.buffers) {
+            const slice = buffer.subarray(0, Math.min(buffer.length, remaining));
+            parts.push(slice);
+            remaining -= slice.length;
+            if (remaining === 0) {
+                break;
+            }
+        }
+        return Buffer.concat(parts, length);
+    }
+    takeBytes(length) {
+        if (length === 0) {
+            return Buffer.allocUnsafe(0);
+        }
+        if (length > this.totalLength) {
+            return Buffer.allocUnsafe(0);
+        }
+        const first = this.buffers[0];
+        if (first.length >= length) {
+            const slice = first.subarray(0, length);
+            this.consumeBytes(length);
+            return slice;
+        }
+        const parts = [];
+        let remaining = length;
+        while (remaining > 0 && this.buffers.length > 0) {
+            const buffer = this.buffers[0];
+            if (remaining >= buffer.length) {
+                parts.push(buffer);
+                this.buffers.shift();
+                remaining -= buffer.length;
+            }
+            else {
+                parts.push(buffer.subarray(0, remaining));
+                this.buffers[0] = buffer.subarray(remaining);
+                remaining = 0;
+            }
+        }
+        this.totalLength -= length;
+        return parts.length === 1 ? parts[0] : Buffer.concat(parts, length);
+    }
+    consumeBytes(length) {
+        let remaining = length;
+        while (remaining > 0 && this.buffers.length > 0) {
+            const buffer = this.buffers[0];
+            if (remaining >= buffer.length) {
+                this.buffers.shift();
+                remaining -= buffer.length;
+            }
+            else {
+                this.buffers[0] = buffer.subarray(remaining);
+                remaining = 0;
+            }
+        }
+        this.totalLength -= length;
     }
 }
 //# sourceMappingURL=length-prefixed.js.map

package/dist/framing/length-prefixed.js.map

@@ -1 +1 @@
-{"version":3,"file":"length-prefixed.js","sourceRoot":"","sources":["../../src/framing/length-prefixed.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"length-prefixed.js","sourceRoot":"","sources":["../../src/framing/length-prefixed.ts"],"names":[],"mappings":"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"}

package/dist/framing/line-delimited.d.ts

@@ -33,7 +33,8 @@ export declare class LineDelimitedFraming implements FramingCodec {
     private readonly delimiter;
     private readonly maxBufferSize;
     private readonly stripDelimiter;
-    private buffer;
+    private buffers;
+    private totalLength;
     constructor(options?: LineDelimitedFramingOptions);
     /**
      * Encodes a payload with delimiter.
@@ -57,5 +58,7 @@ export declare class LineDelimitedFraming implements FramingCodec {
      * Returns current buffer size in bytes.
      */
     getBufferSize(): number;
+    private buildFrame;
+    private compactBuffers;
 }
 //# sourceMappingURL=line-delimited.d.ts.map

package/dist/framing/line-delimited.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"line-delimited.d.ts","sourceRoot":"","sources":["../../src/framing/line-delimited.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,2BAAgC;IAOrD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAa/B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IA0C/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}
+{"version":3,"file":"line-delimited.d.ts","sourceRoot":"","sources":["../../src/framing/line-delimited.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,2BAAgC;IAgBrD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAa/B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAwD/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,UAAU;IA8BlB,OAAO,CAAC,cAAc;CA4BvB"}

package/dist/framing/line-delimited.js

@@ -15,12 +15,21 @@ export class LineDelimitedFraming {
     delimiter;
     maxBufferSize;
     stripDelimiter;
-    buffer;
+    buffers;
+    totalLength;
     constructor(options = {}) {
+        // Validate options
+        if (options.delimiter !== undefined && (options.delimiter < 0 || options.delimiter > 255)) {
+            throw new Error("LineDelimitedFraming: delimiter must be a byte value (0-255)");
+        }
+        if (options.maxBufferSize !== undefined && options.maxBufferSize <= 0) {
+            throw new Error("LineDelimitedFraming: maxBufferSize must be positive");
+        }
         this.delimiter = options.delimiter ?? 0x0a; // '\n'
         this.maxBufferSize = options.maxBufferSize ?? 8 * 1024 * 1024; // 8MB
         this.stripDelimiter = options.stripDelimiter ?? true;
-        this.buffer = Buffer.allocUnsafe(0);
+        this.buffers = [];
+        this.totalLength = 0;
     }
     /**
      * Encodes a payload with delimiter.
@@ -42,53 +51,110 @@ export class LineDelimitedFraming {
      * Buffers partial data until delimiter is found.
      */
     decode(chunk) {
-        // Append chunk to buffer
-        this.buffer = Buffer.concat([this.buffer, chunk]);
+        // Append chunk to buffer list
+        if (chunk.length > 0) {
+            this.buffers.push(chunk);
+            this.totalLength += chunk.length;
+        }
         // Check buffer size limit
-        if (this.buffer.length > this.maxBufferSize) {
-            const error = new FramingError(`Buffer size ${this.buffer.length} exceeds maximum ${this.maxBufferSize}`);
+        if (this.totalLength > this.maxBufferSize) {
+            const error = new FramingError(`Buffer size ${this.totalLength} exceeds maximum ${this.maxBufferSize}`);
             this.reset();
             throw error;
         }
         const frames = [];
-        let searchStart = 0;
+        let frameStartBufferIndex = 0;
+        let frameStartOffset = 0;
+        let bufferIndex = 0;
+        let searchOffset = 0;
         // Find all complete frames (terminated by delimiter)
-        while (searchStart < this.buffer.length) {
-            const delimiterIndex = this.buffer.indexOf(this.delimiter, searchStart);
+        while (bufferIndex < this.buffers.length) {
+            const buffer = this.buffers[bufferIndex];
+            const delimiterIndex = buffer.indexOf(this.delimiter, searchOffset);
             if (delimiterIndex === -1) {
-                // No more delimiters found
-                break;
+                bufferIndex++;
+                searchOffset = 0;
+                continue;
             }
-            // Extract frame
-            const frameEnd = this.stripDelimiter ? delimiterIndex : delimiterIndex + 1;
-            const frame = this.buffer.subarray(searchStart, frameEnd);
-            frames.push(frame);
+            const frameEndOffset = this.stripDelimiter ? delimiterIndex : delimiterIndex + 1;
+            frames.push(this.buildFrame(frameStartBufferIndex, frameStartOffset, bufferIndex, frameEndOffset));
             // Move past delimiter
-            searchStart = delimiterIndex + 1;
-        }
-        // Keep remaining data in buffer
-        if (searchStart > 0) {
-            this.buffer = this.buffer.subarray(searchStart);
+            if (delimiterIndex + 1 < buffer.length) {
+                frameStartBufferIndex = bufferIndex;
+                frameStartOffset = delimiterIndex + 1;
+                searchOffset = frameStartOffset;
+            }
+            else {
+                frameStartBufferIndex = bufferIndex + 1;
+                frameStartOffset = 0;
+                bufferIndex = frameStartBufferIndex;
+                searchOffset = 0;
+            }
         }
+        this.compactBuffers(frameStartBufferIndex, frameStartOffset);
         return frames;
     }
     /**
      * Resets internal buffer state.
      */
     reset() {
-        this.buffer = Buffer.allocUnsafe(0);
+        this.buffers = [];
+        this.totalLength = 0;
     }
     /**
      * Returns true if there is buffered partial data.
      */
     hasBufferedData() {
-        return this.buffer.length > 0;
+        return this.totalLength > 0;
     }
     /**
      * Returns current buffer size in bytes.
      */
     getBufferSize() {
-        return this.buffer.length;
+        return this.totalLength;
+    }
+    buildFrame(startIndex, startOffset, endIndex, endOffset) {
+        if (startIndex === endIndex) {
+            return this.buffers[startIndex].subarray(startOffset, endOffset);
+        }
+        const parts = [];
+        let totalLength = 0;
+        const first = this.buffers[startIndex].subarray(startOffset);
+        parts.push(first);
+        totalLength += first.length;
+        for (let i = startIndex + 1; i < endIndex; i++) {
+            const buffer = this.buffers[i];
+            parts.push(buffer);
+            totalLength += buffer.length;
+        }
+        const last = this.buffers[endIndex].subarray(0, endOffset);
+        parts.push(last);
+        totalLength += last.length;
+        return Buffer.concat(parts, totalLength);
+    }
+    compactBuffers(startIndex, startOffset) {
+        if (startIndex === 0 && startOffset === 0) {
+            return;
+        }
+        if (startIndex >= this.buffers.length) {
+            this.buffers = [];
+            this.totalLength = 0;
+            return;
+        }
+        const nextBuffers = [];
+        let nextLength = 0;
+        for (let i = startIndex; i < this.buffers.length; i++) {
+            let buffer = this.buffers[i];
+            if (i === startIndex && startOffset > 0) {
+                buffer = buffer.subarray(startOffset);
+            }
+            if (buffer.length > 0) {
+                nextBuffers.push(buffer);
+                nextLength += buffer.length;
+            }
+        }
+        this.buffers = nextBuffers;
+        this.totalLength = nextLength;
     }
 }
 //# sourceMappingURL=line-delimited.js.map

package/dist/framing/line-delimited.js.map

@@ -1 +1 @@
-{"version":3,"file":"line-delimited.js","sourceRoot":"","sources":["../../src/framing/line-delimited.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"line-delimited.js","sourceRoot":"","sources":["../../src/framing/line-delimited.ts"],"names":[],"mappings":"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"}

package/dist/heartbeat/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Heartbeat manager constants.
+ *
+ * @packageDocumentation
+ * @module Heartbeat
+ */
+import type { HeartbeatOptions } from "./types.js";
+/**
+ * Default heartbeat configuration options.
+ */
+export declare const DEFAULT_HEARTBEAT_OPTIONS: Readonly<Required<HeartbeatOptions>>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/heartbeat/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/heartbeat/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAM1E,CAAC"}

package/dist/heartbeat/constants.js

@@ -0,0 +1,17 @@
+/**
+ * Heartbeat manager constants.
+ *
+ * @packageDocumentation
+ * @module Heartbeat
+ */
+/**
+ * Default heartbeat configuration options.
+ */
+export const DEFAULT_HEARTBEAT_OPTIONS = {
+    enabled: true,
+    interval: 30_000,
+    timeout: 5_000,
+    maxMissed: 3,
+    implicitHeartbeat: true,
+};
+//# sourceMappingURL=constants.js.map

package/dist/heartbeat/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/heartbeat/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAyC;IAC7E,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,CAAC;IACZ,iBAAiB,EAAE,IAAI;CACxB,CAAC"}

package/dist/heartbeat/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Heartbeat module for detecting unresponsive workers.
+ *
+ * @packageDocumentation
+ * @module Heartbeat
+ */
+export * from "./types.js";
+export * from "./constants.js";
+export * from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/heartbeat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/heartbeat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/heartbeat/index.js

@@ -0,0 +1,10 @@
+/**
+ * Heartbeat module for detecting unresponsive workers.
+ *
+ * @packageDocumentation
+ * @module Heartbeat
+ */
+export * from "./types.js";
+export * from "./constants.js";
+export * from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/heartbeat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/heartbeat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/heartbeat/manager.d.ts

@@ -0,0 +1,107 @@
+/**
+ * HeartbeatManager implementation.
+ *
+ * @packageDocumentation
+ * @module Heartbeat
+ */
+import type { Channel } from "../channel/types.js";
+import type { HeartbeatPongParams } from "../protocol/reserved-types.js";
+import { EventEmitter } from "../utils/events.js";
+import type { HeartbeatOptions, HeartbeatState, HeartbeatEventMap } from "./types.js";
+/**
+ * Manages heartbeat ping/pong cycle to detect unresponsive workers.
+ *
+ * The HeartbeatManager sends periodic `__heartbeat_ping__` notifications via the
+ * control channel and expects `__heartbeat_pong__` responses within the configured
+ * timeout. After `maxMissed` consecutive missed pongs, the worker is declared dead.
+ *
+ * @example
+ * ```typescript
+ * const heartbeat = new HeartbeatManager(controlChannel, {
+ *   interval: 30000,
+ *   timeout: 5000,
+ *   maxMissed: 3,
+ * });
+ *
+ * heartbeat.on('heartbeat:pong', ({ latencyMs }) => {
+ *   console.log(`Pong received with ${latencyMs}ms latency`);
+ * });
+ *
+ * heartbeat.on('heartbeat:dead', ({ missedCount }) => {
+ *   console.log(`Worker dead after ${missedCount} missed pongs`);
+ *   // Trigger restart or cleanup
+ * });
+ *
+ * heartbeat.start();
+ *
+ * // When done
+ * heartbeat.stop();
+ * ```
+ */
+export declare class HeartbeatManager extends EventEmitter<HeartbeatEventMap> {
+    private readonly options;
+    private readonly channel;
+    private state;
+    private intervalHandle;
+    private timeoutHandle;
+    /**
+     * Creates a new HeartbeatManager.
+     *
+     * @param channel - Control channel to send heartbeat notifications on
+     * @param options - Configuration options (merged with defaults)
+     */
+    constructor(channel: Channel, options?: Partial<HeartbeatOptions>);
+    /**
+     * Start heartbeat monitoring.
+     * Sends first ping immediately, then at configured interval.
+     */
+    start(): void;
+    /**
+     * Stop heartbeat monitoring.
+     * Clears all timers and resets counters for clean restart.
+     */
+    stop(): void;
+    /**
+     * Call when any activity occurs on the channel.
+     * If implicitHeartbeat is enabled, resets the missed counter, clears pending ping,
+     * and emits heartbeat:recovered if the worker was previously considered unhealthy.
+     */
+    onActivity(): void;
+    /**
+     * Handle incoming pong notification.
+     * Should be called by the channel when `__heartbeat_pong__` is received.
+     *
+     * @param params - The pong notification parameters
+     */
+    handlePong(params: HeartbeatPongParams): void;
+    /**
+     * Get current heartbeat state (readonly).
+     */
+    getState(): Readonly<HeartbeatState>;
+    /**
+     * Get current options (readonly).
+     */
+    getOptions(): Readonly<Required<HeartbeatOptions>>;
+    /**
+     * Check if heartbeat is currently running.
+     */
+    isRunning(): boolean;
+    /**
+     * Reset state for restart scenarios.
+     * Clears timers and resets all counters.
+     */
+    reset(): void;
+    /**
+     * Sends a heartbeat ping notification.
+     */
+    private sendPing;
+    /**
+     * Handles a missed pong (timeout or send failure).
+     */
+    private handleMissed;
+    /**
+     * Clears all active timers.
+     */
+    private clearTimers;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/heartbeat/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/heartbeat/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAuB,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,OAAO,CAAC,KAAK,CAMX;IAEF,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,aAAa,CAA8C;IAEnE;;;;;OAKG;gBACS,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAMrE;;;OAGG;IACH,KAAK,IAAI,IAAI;IAiBb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAYZ;;;;OAIG;IACH,UAAU,IAAI,IAAI;IA2BlB;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAmC7C;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,cAAc,CAAC;IAIpC;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAIlD;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,OAAO,CAAC,QAAQ;IA2BhB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,WAAW;CAUpB"}