@memberjunction/livekit-room-server 6.2.0-edge.2 → 6.2.0-edge.3

package/dist/room-audio/pcm-frame-pump.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @fileoverview {@link PcmFramePump} — plays a PCM16 buffer out to a sink in real time, one 20 ms frame at a time.
+ *
+ * The native LiveKit wrapper's `publishAudio` queues whatever it is given and drains it as fast as the WebRTC audio
+ * source accepts it; it does not pace. Handing it a whole song would buffer minutes of audio in memory and make pause,
+ * stop and announcements lag by that much. So the pump paces itself: a fast ticker compares monotonic elapsed time
+ * with frames sent and emits only what is due, plus a small lead (~150 ms) that absorbs timer jitter. The lead is all
+ * that is ever outstanding downstream.
+ *
+ * - **Drift correction** — frames due are computed from the elapsed time since the timeline started, never by
+ *   counting ticks, so a late tick sends two frames and the average rate stays exact.
+ * - **Bounded catch-up** — after a long stall (a blocked event loop) the pump does not burst the backlog; it drops it
+ *   and restarts the timeline, so the downstream queue can never grow past the lead plus a small margin.
+ * - **Loop**, **Pause/Resume** (resume restarts the timeline — no burst), and **InsertClip**: the music fades down to a
+ *   duck level, the clip plays over it, and the music fades back up.
+ *
+ * The clock and ticker are injectable so tests drive time by hand.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** A running ticker the pump can cancel. */
+export interface PumpTicker {
+    /** Stops the ticker. Idempotent. */
+    Cancel(): void;
+}
+/** The pump's source of time and ticks — `performance.now()` + `setInterval` in production, a fake in tests. */
+export interface PumpClock {
+    /** Monotonic milliseconds. */
+    Now(): number;
+    /** Calls `callback` every `intervalMs` until cancelled. */
+    StartTicker(callback: () => void, intervalMs: number): PumpTicker;
+}
+/** Why a pump stopped: its (non-looping) audio ran out, it was stopped, or the sink threw. */
+export type PumpEndReason = 'Completed' | 'Stopped' | 'SinkError';
+/** Construction options for {@link PcmFramePump}. */
+export interface PcmFramePumpOptions {
+    /** Mono PCM16 to play, at {@link SampleRate}. Must not be empty. */
+    Music: Int16Array;
+    /** The rate of {@link Music}, of inserted clips, and of the frames handed to {@link Sink}. */
+    SampleRate: number;
+    /** Receives each frame. Every frame is a freshly allocated array the sink may keep. */
+    Sink: (frame: Int16Array<ArrayBuffer>) => void;
+    /** Loop {@link Music} forever. Default `true`. */
+    Loop?: boolean;
+    /** Frame duration in ms. Default 20. */
+    FrameMs?: number;
+    /** How far ahead of real time the pump keeps the sink, in ms. Default 150. */
+    LeadMs?: number;
+    /** How long the music takes to fade down for a clip (and back up after), in ms. Default 150. */
+    DuckMs?: number;
+    /** The music's level while a clip plays, 0–1. Default 0.15. */
+    DuckLevel?: number;
+    /** Time source. Default: {@link SystemPumpClock}. */
+    Clock?: PumpClock;
+    /** Called once when the pump stops, with the reason. */
+    OnEnded?: (reason: PumpEndReason) => void;
+}
+/** The production clock: `performance.now()` and an unref'd `setInterval` (a playing pump never holds the process open). */
+export declare const SystemPumpClock: PumpClock;
+/** Paces mono PCM16 out to a sink in real time. See the file overview. */
+export declare class PcmFramePump {
+    private readonly music;
+    private readonly sampleRate;
+    private readonly sink;
+    private readonly loop;
+    private readonly frameMs;
+    private readonly samplesPerFrame;
+    private readonly leadFrames;
+    private readonly maxBurstFrames;
+    private readonly duckLevel;
+    private readonly gainStep;
+    private readonly clock;
+    private readonly onEnded?;
+    private ticker;
+    private running;
+    private paused;
+    private ended;
+    private timelineStart;
+    private framesOnTimeline;
+    private framesSent;
+    private musicPosition;
+    private musicDone;
+    private gain;
+    private readonly clipQueue;
+    private currentClip;
+    private clipPosition;
+    /** @throws {Error} when the music is empty or a timing option is not positive. */
+    constructor(options: PcmFramePumpOptions);
+    /** True between {@link Start} and the pump ending (including while paused). */
+    get IsRunning(): boolean;
+    /** True while paused. */
+    get IsPaused(): boolean;
+    /** Frames handed to the sink so far. */
+    get FramesSent(): number;
+    /** Samples per frame at the pump's rate. */
+    get SamplesPerFrame(): number;
+    /** Starts playback: sends the lead immediately, then paces in real time. A second call is a no-op. */
+    Start(): void;
+    /** Stops sending frames until {@link Resume}. Playback position, ducking and queued clips are kept. */
+    Pause(): void;
+    /** Continues after {@link Pause} from where it left off, on a fresh timeline (so nothing bursts). */
+    Resume(): void;
+    /**
+     * How much already-sent audio is still ahead of real time, in ms: the pump keeps the sink up to `LeadMs` ahead, so
+     * after the last frame is sent the room is still playing this much. Zero once real time has caught up.
+     */
+    get QueuedAheadMs(): number;
+    /**
+     * Plays `pcm` over the music: the music fades down to the duck level, the clip plays, the music fades back up.
+     * Clips queue behind one another.
+     *
+     * @param pcm Mono PCM16 at the pump's sample rate.
+     * @returns Resolves `true` once the clip has been sent in full, `false` if the pump stopped first or the clip is empty.
+     */
+    InsertClip(pcm: Int16Array): Promise<boolean>;
+    /** Stops the pump for good. Idempotent; pending clips resolve `false`. */
+    Stop(): void;
+    private restartTimeline;
+    private tick;
+    /** Frames owed to the sink now, given elapsed time and the lead. Drops the backlog after a long stall. */
+    private framesDue;
+    private emitFrame;
+    /** The next output sample in [-1, 1]: ducked music plus whatever clip is playing. */
+    private nextSample;
+    /** Moves the music gain one step toward its target: the duck level while a clip is queued or playing, else full. */
+    private advanceGain;
+    private startQueuedClipIfDucked;
+    private nextMusicSample;
+    private nextClipSample;
+    /** Ends the pump once: cancels the ticker, fails any pending clips, reports the reason. */
+    private finish;
+    private failPendingClips;
+}
+//# sourceMappingURL=pcm-frame-pump.d.ts.map

package/dist/room-audio/pcm-frame-pump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-frame-pump.d.ts","sourceRoot":"","sources":["../../src/room-audio/pcm-frame-pump.ts"],"names":[],"mappings":"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"}

package/dist/room-audio/pcm-frame-pump.js

@@ -0,0 +1,253 @@
+/**
+ * @fileoverview {@link PcmFramePump} — plays a PCM16 buffer out to a sink in real time, one 20 ms frame at a time.
+ *
+ * The native LiveKit wrapper's `publishAudio` queues whatever it is given and drains it as fast as the WebRTC audio
+ * source accepts it; it does not pace. Handing it a whole song would buffer minutes of audio in memory and make pause,
+ * stop and announcements lag by that much. So the pump paces itself: a fast ticker compares monotonic elapsed time
+ * with frames sent and emits only what is due, plus a small lead (~150 ms) that absorbs timer jitter. The lead is all
+ * that is ever outstanding downstream.
+ *
+ * - **Drift correction** — frames due are computed from the elapsed time since the timeline started, never by
+ *   counting ticks, so a late tick sends two frames and the average rate stays exact.
+ * - **Bounded catch-up** — after a long stall (a blocked event loop) the pump does not burst the backlog; it drops it
+ *   and restarts the timeline, so the downstream queue can never grow past the lead plus a small margin.
+ * - **Loop**, **Pause/Resume** (resume restarts the timeline — no burst), and **InsertClip**: the music fades down to a
+ *   duck level, the clip plays over it, and the music fades back up.
+ *
+ * The clock and ticker are injectable so tests drive time by hand.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { LogError } from '@memberjunction/core';
+import { FloatToPcm16 } from './audio-decoder.js';
+/** How often the ticker fires, in ms. Shorter than a frame so lateness never exceeds about half a frame. */
+const TICK_MS = 10;
+/** How far behind real time the pump will catch up before it drops the backlog instead, in ms. */
+const MAX_CATCH_UP_MS = 200;
+/** The production clock: `performance.now()` and an unref'd `setInterval` (a playing pump never holds the process open). */
+export const SystemPumpClock = {
+    Now: () => performance.now(),
+    StartTicker: (callback, intervalMs) => {
+        const handle = setInterval(callback, intervalMs);
+        handle.unref?.();
+        return { Cancel: () => clearInterval(handle) };
+    },
+};
+/** Paces mono PCM16 out to a sink in real time. See the file overview. */
+export class PcmFramePump {
+    /** @throws {Error} when the music is empty or a timing option is not positive. */
+    constructor(options) {
+        this.ticker = null;
+        this.running = false;
+        this.paused = false;
+        this.ended = false;
+        this.timelineStart = 0;
+        this.framesOnTimeline = 0;
+        this.framesSent = 0;
+        this.musicPosition = 0;
+        this.musicDone = false;
+        this.gain = 1;
+        this.clipQueue = [];
+        this.currentClip = null;
+        this.clipPosition = 0;
+        if (options.Music.length === 0)
+            throw new Error('PcmFramePump needs non-empty audio to play.');
+        if (!(options.SampleRate > 0))
+            throw new Error(`PcmFramePump needs a positive sample rate; got ${options.SampleRate}.`);
+        this.music = options.Music;
+        this.sampleRate = options.SampleRate;
+        this.sink = options.Sink;
+        this.loop = options.Loop ?? true;
+        this.frameMs = options.FrameMs ?? 20;
+        this.samplesPerFrame = Math.max(1, Math.round((this.sampleRate * this.frameMs) / 1000));
+        this.leadFrames = Math.max(1, Math.ceil((options.LeadMs ?? 150) / this.frameMs));
+        this.maxBurstFrames = this.leadFrames + Math.ceil(MAX_CATCH_UP_MS / this.frameMs);
+        this.duckLevel = Math.min(1, Math.max(0, options.DuckLevel ?? 0.15));
+        const duckSamples = Math.max(1, Math.round(((options.DuckMs ?? 150) * this.sampleRate) / 1000));
+        this.gainStep = (1 - this.duckLevel) / duckSamples;
+        this.clock = options.Clock ?? SystemPumpClock;
+        this.onEnded = options.OnEnded;
+    }
+    /** True between {@link Start} and the pump ending (including while paused). */
+    get IsRunning() {
+        return this.running;
+    }
+    /** True while paused. */
+    get IsPaused() {
+        return this.paused;
+    }
+    /** Frames handed to the sink so far. */
+    get FramesSent() {
+        return this.framesSent;
+    }
+    /** Samples per frame at the pump's rate. */
+    get SamplesPerFrame() {
+        return this.samplesPerFrame;
+    }
+    /** Starts playback: sends the lead immediately, then paces in real time. A second call is a no-op. */
+    Start() {
+        if (this.running || this.ended) {
+            return;
+        }
+        this.running = true;
+        this.restartTimeline();
+        this.ticker = this.clock.StartTicker(() => this.tick(), TICK_MS);
+        this.tick();
+    }
+    /** Stops sending frames until {@link Resume}. Playback position, ducking and queued clips are kept. */
+    Pause() {
+        if (this.running) {
+            this.paused = true;
+        }
+    }
+    /** Continues after {@link Pause} from where it left off, on a fresh timeline (so nothing bursts). */
+    Resume() {
+        if (!this.running || !this.paused) {
+            return;
+        }
+        this.paused = false;
+        this.restartTimeline();
+        this.tick();
+    }
+    /**
+     * How much already-sent audio is still ahead of real time, in ms: the pump keeps the sink up to `LeadMs` ahead, so
+     * after the last frame is sent the room is still playing this much. Zero once real time has caught up.
+     */
+    get QueuedAheadMs() {
+        const sentUntil = this.timelineStart + this.framesOnTimeline * this.frameMs;
+        return Math.max(0, sentUntil - this.clock.Now());
+    }
+    /**
+     * Plays `pcm` over the music: the music fades down to the duck level, the clip plays, the music fades back up.
+     * Clips queue behind one another.
+     *
+     * @param pcm Mono PCM16 at the pump's sample rate.
+     * @returns Resolves `true` once the clip has been sent in full, `false` if the pump stopped first or the clip is empty.
+     */
+    InsertClip(pcm) {
+        if (!this.running || pcm.length === 0) {
+            return Promise.resolve(false);
+        }
+        return new Promise((resolve) => this.clipQueue.push({ Pcm: pcm, Done: resolve }));
+    }
+    /** Stops the pump for good. Idempotent; pending clips resolve `false`. */
+    Stop() {
+        this.finish('Stopped');
+    }
+    restartTimeline() {
+        this.timelineStart = this.clock.Now();
+        this.framesOnTimeline = 0;
+    }
+    tick() {
+        if (!this.running || this.paused) {
+            return;
+        }
+        try {
+            const due = this.framesDue();
+            for (let i = 0; i < due && this.running && !this.paused; i++) {
+                this.emitFrame();
+            }
+        }
+        catch (err) {
+            LogError(`[PcmFramePump] the sink failed; stopping playback: ${err instanceof Error ? err.message : String(err)}`);
+            this.finish('SinkError');
+        }
+    }
+    /** Frames owed to the sink now, given elapsed time and the lead. Drops the backlog after a long stall. */
+    framesDue() {
+        const elapsed = this.clock.Now() - this.timelineStart;
+        const target = Math.floor(elapsed / this.frameMs) + this.leadFrames;
+        const due = target - this.framesOnTimeline;
+        if (due > this.maxBurstFrames) {
+            this.restartTimeline(); // stalled too long: skip the missed audio rather than flood the sink
+            return this.leadFrames;
+        }
+        return Math.max(0, due);
+    }
+    emitFrame() {
+        const frame = new Int16Array(this.samplesPerFrame);
+        for (let i = 0; i < frame.length; i++) {
+            frame[i] = FloatToPcm16(this.nextSample());
+        }
+        this.framesOnTimeline++;
+        this.framesSent++;
+        this.sink(frame);
+        if (this.musicDone && !this.currentClip && this.clipQueue.length === 0) {
+            this.finish('Completed');
+        }
+    }
+    /** The next output sample in [-1, 1]: ducked music plus whatever clip is playing. */
+    nextSample() {
+        this.advanceGain();
+        this.startQueuedClipIfDucked();
+        return this.nextMusicSample() * this.gain + this.nextClipSample();
+    }
+    /** Moves the music gain one step toward its target: the duck level while a clip is queued or playing, else full. */
+    advanceGain() {
+        const ducking = this.currentClip !== null || this.clipQueue.length > 0;
+        const target = ducking ? this.duckLevel : 1;
+        if (this.gain > target) {
+            this.gain = Math.max(target, this.gain - this.gainStep);
+        }
+        else if (this.gain < target) {
+            this.gain = Math.min(target, this.gain + this.gainStep);
+        }
+    }
+    startQueuedClipIfDucked() {
+        if (!this.currentClip && this.clipQueue.length > 0 && this.gain <= this.duckLevel) {
+            this.currentClip = this.clipQueue.shift() ?? null;
+            this.clipPosition = 0;
+        }
+    }
+    nextMusicSample() {
+        if (this.musicDone) {
+            return 0;
+        }
+        const sample = this.music[this.musicPosition] / 32768;
+        this.musicPosition++;
+        if (this.musicPosition >= this.music.length) {
+            this.musicPosition = 0;
+            this.musicDone = !this.loop;
+        }
+        return sample;
+    }
+    nextClipSample() {
+        const clip = this.currentClip;
+        if (!clip) {
+            return 0;
+        }
+        const sample = clip.Pcm[this.clipPosition] / 32768;
+        this.clipPosition++;
+        if (this.clipPosition >= clip.Pcm.length) {
+            this.currentClip = null;
+            clip.Done(true);
+        }
+        return sample;
+    }
+    /** Ends the pump once: cancels the ticker, fails any pending clips, reports the reason. */
+    finish(reason) {
+        if (this.ended) {
+            return;
+        }
+        this.ended = true;
+        this.running = false;
+        this.paused = false;
+        try {
+            this.ticker?.Cancel();
+        }
+        finally {
+            this.ticker = null;
+            this.failPendingClips();
+            this.onEnded?.(reason);
+        }
+    }
+    failPendingClips() {
+        const pending = this.currentClip ? [this.currentClip, ...this.clipQueue] : [...this.clipQueue];
+        this.currentClip = null;
+        this.clipQueue.length = 0;
+        for (const clip of pending) {
+            clip.Done(false);
+        }
+    }
+}
+//# sourceMappingURL=pcm-frame-pump.js.map

package/dist/room-audio/pcm-frame-pump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-frame-pump.js","sourceRoot":"","sources":["../../src/room-audio/pcm-frame-pump.ts"],"names":[],"mappings":"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"}

package/dist/room-audio/room-audio-decode-cache.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview {@link RoomAudioDecodeCache} — a small LRU of ready-to-play PCM keyed by source (an `MJ: Files` id or
+ * a URL), so every caller placed on hold in the same queue does not re-download and re-decode the same file.
+ *
+ * It caches the in-flight PROMISE, so ten callers arriving at once share one download. A failed load is evicted so
+ * the next caller retries. Bounded both by entry count and by total samples held.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** Default maximum number of cached sources. */
+export declare const DEFAULT_DECODE_CACHE_ENTRIES = 8;
+/** Default maximum total samples held across all entries (128 Mi samples = 256 MB of PCM16). */
+export declare const DEFAULT_DECODE_CACHE_MAX_SAMPLES: number;
+/** A bounded, promise-sharing LRU of decoded PCM. */
+export declare class RoomAudioDecodeCache {
+    private readonly maxEntries;
+    private readonly maxSamples;
+    private readonly slots;
+    /**
+     * @param maxEntries Maximum number of cached sources.
+     * @param maxSamples Maximum total samples held across all resolved entries.
+     */
+    constructor(maxEntries?: number, maxSamples?: number);
+    /** How many sources are cached (or loading). */
+    get Size(): number;
+    /**
+     * Returns the cached PCM for `key`, or runs `load` once and caches its result. Concurrent callers for the same key
+     * share one load. A rejected load is removed so the next call retries.
+     */
+    GetOrLoad(key: string, load: () => Promise<Int16Array>): Promise<Int16Array>;
+    /** Empties the cache. */
+    Clear(): void;
+    /** Drops least-recently-used entries until both bounds hold (never the most recent one). */
+    private evictOverflow;
+    private totalSamples;
+}
+//# sourceMappingURL=room-audio-decode-cache.d.ts.map

package/dist/room-audio/room-audio-decode-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-audio-decode-cache.d.ts","sourceRoot":"","sources":["../../src/room-audio/room-audio-decode-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gDAAgD;AAChD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,gGAAgG;AAChG,eAAO,MAAM,gCAAgC,QAAoB,CAAC;AAQlE,qDAAqD;AACrD,qBAAa,oBAAoB;IAQ7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD;;;OAGG;gBAEgB,UAAU,GAAE,MAAqC,EACjD,UAAU,GAAE,MAAyC;IAGxE,gDAAgD;IAChD,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAwBnF,yBAAyB;IAClB,KAAK,IAAI,IAAI;IAIpB,4FAA4F;IAC5F,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/room-audio/room-audio-decode-cache.js

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview {@link RoomAudioDecodeCache} — a small LRU of ready-to-play PCM keyed by source (an `MJ: Files` id or
+ * a URL), so every caller placed on hold in the same queue does not re-download and re-decode the same file.
+ *
+ * It caches the in-flight PROMISE, so ten callers arriving at once share one download. A failed load is evicted so
+ * the next caller retries. Bounded both by entry count and by total samples held.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** Default maximum number of cached sources. */
+export const DEFAULT_DECODE_CACHE_ENTRIES = 8;
+/** Default maximum total samples held across all entries (128 Mi samples = 256 MB of PCM16). */
+export const DEFAULT_DECODE_CACHE_MAX_SAMPLES = 128 * 1024 * 1024;
+/** A bounded, promise-sharing LRU of decoded PCM. */
+export class RoomAudioDecodeCache {
+    /**
+     * @param maxEntries Maximum number of cached sources.
+     * @param maxSamples Maximum total samples held across all resolved entries.
+     */
+    constructor(maxEntries = DEFAULT_DECODE_CACHE_ENTRIES, maxSamples = DEFAULT_DECODE_CACHE_MAX_SAMPLES) {
+        this.maxEntries = maxEntries;
+        this.maxSamples = maxSamples;
+        this.slots = new Map();
+    }
+    /** How many sources are cached (or loading). */
+    get Size() {
+        return this.slots.size;
+    }
+    /**
+     * Returns the cached PCM for `key`, or runs `load` once and caches its result. Concurrent callers for the same key
+     * share one load. A rejected load is removed so the next call retries.
+     */
+    GetOrLoad(key, load) {
+        const existing = this.slots.get(key);
+        if (existing) {
+            this.slots.delete(key); // re-insert: Map order is the recency order
+            this.slots.set(key, existing);
+            return existing.Load;
+        }
+        const slot = { Load: load(), Samples: 0 };
+        this.slots.set(key, slot);
+        this.evictOverflow();
+        slot.Load.then((pcm) => {
+            slot.Samples = pcm.length;
+            this.evictOverflow();
+        }, () => {
+            if (this.slots.get(key) === slot) {
+                this.slots.delete(key); // the caller sees the rejection; the cache just forgets it
+            }
+        });
+        return slot.Load;
+    }
+    /** Empties the cache. */
+    Clear() {
+        this.slots.clear();
+    }
+    /** Drops least-recently-used entries until both bounds hold (never the most recent one). */
+    evictOverflow() {
+        while (this.slots.size > 1 && (this.slots.size > this.maxEntries || this.totalSamples() > this.maxSamples)) {
+            const oldest = this.slots.keys().next().value;
+            if (oldest === undefined) {
+                return;
+            }
+            this.slots.delete(oldest);
+        }
+    }
+    totalSamples() {
+        let total = 0;
+        for (const slot of this.slots.values()) {
+            total += slot.Samples;
+        }
+        return total;
+    }
+}
+//# sourceMappingURL=room-audio-decode-cache.js.map

package/dist/room-audio/room-audio-decode-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-audio-decode-cache.js","sourceRoot":"","sources":["../../src/room-audio/room-audio-decode-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,gGAAgG;AAChG,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAQlE,qDAAqD;AACrD,MAAM,OAAO,oBAAoB;IAG/B;;;OAGG;IACH,YACmB,aAAqB,4BAA4B,EACjD,aAAqB,gCAAgC;QADrD,eAAU,GAAV,UAAU,CAAuC;QACjD,eAAU,GAAV,UAAU,CAA2C;QARvD,UAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IASnD,CAAC;IAEJ,gDAAgD;IAChD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,SAAS,CAAC,GAAW,EAAE,IAA+B;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,4CAA4C;YACpE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC9B,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,IAAI,CACZ,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,EACD,GAAG,EAAE;YACH,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,2DAA2D;YACrF,CAAC;QACH,CAAC,CACF,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,yBAAyB;IAClB,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,4FAA4F;IACpF,aAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3G,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}