@groovenet/player 0.0.0-stage → 0.1.1

package/build/mpvBackend.js

@@ -0,0 +1,309 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { EventEmitter } from "node:events";
+import { createConnection } from "node:net";
+import { unlink } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { PlayerError } from "./types.js";
+/** mpv child process controlled through its line-delimited JSON IPC socket. */
+export class MpvBackend extends EventEmitter {
+    process = null;
+    socket = null;
+    socketPath = join(tmpdir(), `gn-mpv-${process.pid}-${randomUUID().slice(0, 12)}.sock`);
+    buffer = "";
+    nextId = 1;
+    pending = new Map();
+    startup = null;
+    closing = false;
+    spawnError = null;
+    executable;
+    startupTimeoutMs;
+    commandTimeoutMs;
+    spawnProcess;
+    connectSocket;
+    duration = null;
+    constructor(options = {}) {
+        super();
+        this.executable = options.executable ?? "mpv";
+        this.startupTimeoutMs = options.startupTimeoutMs ?? 5000;
+        this.commandTimeoutMs = options.commandTimeoutMs ?? 5000;
+        this.spawnProcess = options.spawnProcess ?? ((executable, args) => spawn(executable, args, { stdio: "ignore" }));
+        this.connectSocket = options.connectSocket ?? createConnection;
+        this.insecureTls = options.insecureTls ?? false;
+    }
+    insecureTls;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    on(event, listener) { return super.on(event, listener); }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    off(event, listener) { return super.off(event, listener); }
+    async load(source) {
+        await this.ensureStarted();
+        if (source.headers && Object.keys(source.headers).length) {
+            const fields = Object.entries(source.headers).map(([name, value]) => `${name}: ${value}`);
+            await this.command("set_property", "http-header-fields", fields);
+        }
+        else {
+            await this.command("set_property", "http-header-fields", []);
+        }
+        await this.command("loadfile", source.url, "replace");
+    }
+    async pause(paused) {
+        await this.command("set_property", "pause", paused);
+    }
+    async seek(seconds) {
+        await this.command("seek", seconds, "absolute+exact");
+    }
+    async setVolume(volume) {
+        await this.command("set_property", "volume", volume);
+    }
+    async listDevices() {
+        await this.ensureStarted();
+        const result = await this.command("get_property", "audio-device-list");
+        if (!Array.isArray(result))
+            return [];
+        return result.flatMap((item) => {
+            if (!item || typeof item !== "object")
+                return [];
+            const device = item;
+            if (typeof device.name !== "string")
+                return [];
+            return [{
+                    id: device.name,
+                    name: typeof device.description === "string" ? device.description : device.name,
+                    ...(typeof device.description === "string" ? { description: device.description } : {}),
+                }];
+        });
+    }
+    async setOutputDevice(deviceId) {
+        try {
+            await this.ensureStarted();
+            await this.command("set_property", "audio-device", deviceId);
+        }
+        catch (error) {
+            throw new PlayerError("DEVICE_UNAVAILABLE", `Could not select audio output “${deviceId}”. Check that the device is connected and visible to mpv.`, { cause: error });
+        }
+    }
+    async close() {
+        this.closing = true;
+        if (!this.process)
+            return;
+        try {
+            if (this.socket?.writable)
+                await this.command("quit");
+        }
+        catch {
+            // The process may already have exited; continue with forced cleanup below.
+        }
+        const child = this.process;
+        if (child.exitCode === null && child.signalCode === null) {
+            await Promise.race([
+                new Promise((resolve) => child.once("exit", () => resolve())),
+                new Promise((resolve) => setTimeout(resolve, 1000)),
+            ]);
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill("SIGTERM");
+                await Promise.race([
+                    new Promise((resolve) => child.once("exit", () => resolve())),
+                    new Promise((resolve) => setTimeout(resolve, 1000)),
+                ]);
+                if (child.exitCode === null && child.signalCode === null)
+                    child.kill("SIGKILL");
+            }
+        }
+        this.socket?.destroy();
+        this.socket = null;
+        this.process = null;
+        try {
+            await unlink(this.socketPath);
+        }
+        catch { /* socket is already gone */ }
+    }
+    ensureStarted() {
+        if (this.startup)
+            return this.startup;
+        this.closing = false;
+        this.startup = this.startMpv().catch(async (error) => {
+            await this.cleanupAfterStartupFailure();
+            this.startup = null;
+            throw error;
+        });
+        return this.startup;
+    }
+    async startMpv() {
+        this.spawnError = null;
+        const args = ["--idle=yes", "--no-terminal", `--input-ipc-server=${this.socketPath}`];
+        if (this.insecureTls)
+            args.push("--tls-verify=no");
+        try {
+            this.process = this.spawnProcess(this.executable, args);
+        }
+        catch (error) {
+            throw new PlayerError("MPV_NOT_FOUND", "Could not start mpv. Install mpv and ensure it is on PATH.", { cause: error });
+        }
+        const child = this.process;
+        child.once("error", (error) => {
+            const wrapped = new PlayerError("MPV_NOT_FOUND", "Could not start mpv. Install mpv and ensure it is on PATH.", { cause: error });
+            this.spawnError = wrapped;
+            this.rejectPending(wrapped);
+            this.reportError(wrapped);
+        });
+        child.once("exit", (code, signal) => {
+            this.socket?.destroy();
+            this.socket = null;
+            this.rejectPending(new PlayerError("MPV_EXITED", `mpv exited unexpectedly (${signal ?? code ?? "unknown status"}).`));
+            if (!this.closing) {
+                this.startup = null;
+                this.reportError(new PlayerError("MPV_EXITED", `mpv exited unexpectedly (${signal ?? code ?? "unknown status"}).`));
+            }
+        });
+        const deadline = Date.now() + this.startupTimeoutMs;
+        while (Date.now() < deadline) {
+            if (this.spawnError)
+                throw this.spawnError;
+            if (child.exitCode !== null || child.signalCode !== null) {
+                throw new PlayerError("MPV_EXITED", "mpv exited while starting. Check the mpv installation and audio output configuration.");
+            }
+            try {
+                await this.connect();
+                if (this.spawnError)
+                    throw this.spawnError;
+                await this.command("observe_property", 1, "time-pos");
+                if (this.spawnError)
+                    throw this.spawnError;
+                await this.command("observe_property", 2, "duration");
+                if (this.spawnError)
+                    throw this.spawnError;
+                return;
+            }
+            catch {
+                this.socket?.destroy();
+                this.socket = null;
+                await new Promise((resolve) => setTimeout(resolve, 40));
+            }
+        }
+        throw new PlayerError("MPV_IPC", "mpv started but its IPC socket did not become ready.");
+    }
+    connect() {
+        return new Promise((resolve, reject) => {
+            const socket = this.connectSocket(this.socketPath);
+            const failed = (error) => { socket.destroy(); reject(error); };
+            socket.once("error", failed);
+            socket.once("connect", () => {
+                socket.off("error", failed);
+                this.socket = socket;
+                socket.on("data", (chunk) => this.onData(chunk));
+                socket.on("error", (error) => this.rejectPending(new PlayerError("MPV_IPC", `mpv IPC connection failed: ${error.message}`, { cause: error })));
+                socket.on("close", () => this.rejectPending(new PlayerError("MPV_IPC", "mpv IPC connection closed.")));
+                resolve();
+            });
+        });
+    }
+    command(name, ...args) {
+        const socket = this.socket;
+        if (!socket?.writable)
+            return Promise.reject(new PlayerError("MPV_IPC", "mpv is not connected."));
+        const request_id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(request_id);
+                reject(new PlayerError("MPV_IPC", `mpv did not answer the “${name}” command within ${this.commandTimeoutMs} ms.`));
+            }, this.commandTimeoutMs);
+            this.pending.set(request_id, { resolve, reject, timer });
+            socket.write(`${JSON.stringify({ command: [name, ...args], request_id })}\n`, (error) => {
+                if (error) {
+                    const pending = this.pending.get(request_id);
+                    this.pending.delete(request_id);
+                    if (pending)
+                        clearTimeout(pending.timer);
+                    reject(new PlayerError("MPV_IPC", `Could not send command to mpv: ${error.message}`, { cause: error }));
+                }
+            });
+        });
+    }
+    onData(chunk) {
+        this.buffer += chunk.toString("utf8");
+        let newline;
+        while ((newline = this.buffer.indexOf("\n")) >= 0) {
+            const line = this.buffer.slice(0, newline);
+            this.buffer = this.buffer.slice(newline + 1);
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (message.request_id !== undefined) {
+                const pending = this.pending.get(message.request_id);
+                if (!pending)
+                    continue;
+                this.pending.delete(message.request_id);
+                clearTimeout(pending.timer);
+                if (message.error && message.error !== "success")
+                    pending.reject(this.mapMpvError(message.error));
+                else
+                    pending.resolve(message.data);
+            }
+            else {
+                this.onEvent(message);
+            }
+        }
+    }
+    onEvent(message) {
+        if (message.event === "property-change") {
+            const position = message.name === "time-pos" ? message.data : undefined;
+            if (message.name === "duration")
+                this.duration = typeof message.data === "number" ? message.data : null;
+            if (typeof position === "number") {
+                this.emit("position", position, this.duration);
+            }
+        }
+        else if (message.event === "end-file") {
+            const reason = message.reason;
+            if (reason === "eof")
+                this.emit("ended");
+            else if (reason === "error")
+                this.reportError(new PlayerError("STREAM_FAILED", "mpv could not read the audio stream. Check the server URL, API key, and downloaded audio."));
+        }
+    }
+    mapMpvError(error) {
+        if (error.includes("audio-device"))
+            return new PlayerError("DEVICE_UNAVAILABLE", `mpv could not select the audio device: ${error}. Check that it is connected.`);
+        return new PlayerError("MPV_IPC", `mpv command failed: ${error}`);
+    }
+    rejectPending(error) {
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    async cleanupAfterStartupFailure() {
+        this.closing = true;
+        this.socket?.destroy();
+        this.socket = null;
+        const child = this.process;
+        if (child && child.exitCode === null && child.signalCode === null) {
+            child.kill("SIGTERM");
+            await Promise.race([
+                new Promise((resolve) => child.once("exit", () => resolve())),
+                new Promise((resolve) => setTimeout(resolve, 1000)),
+            ]);
+            if (child.exitCode === null && child.signalCode === null)
+                child.kill("SIGKILL");
+        }
+        this.process = null;
+        try {
+            await unlink(this.socketPath);
+        }
+        catch { /* socket was never created or already removed */ }
+    }
+    reportError(error) {
+        // EventEmitter treats an unhandled `error` event as an exception. A backend
+        // can be used directly before a client subscribes, so report only to listeners.
+        if (this.listenerCount("error") > 0)
+            this.emit("error", error);
+    }
+}
+//# sourceMappingURL=mpvBackend.js.map

package/build/mpvBackend.js.map

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

package/build/player.d.ts

@@ -0,0 +1,46 @@
+import { EventEmitter } from "node:events";
+import { TrackQueue } from "./queue.js";
+import { TrackResolver } from "./resolver.js";
+import type { PlaybackBackend, PlaybackSnapshot, QueueEntry } from "./types.js";
+import { PlayerError, type AudioDevice } from "./types.js";
+export interface PlayerCoreEvents {
+    change: (snapshot: PlaybackSnapshot) => void;
+    "track-started": (entry: QueueEntry) => void;
+    "track-ended": (entry: QueueEntry) => void;
+    "track-skipped": (entry: QueueEntry, error: PlayerError) => void;
+}
+export declare class PlayerCore extends EventEmitter {
+    private readonly backend;
+    private readonly resolver;
+    readonly queue: TrackQueue;
+    private current;
+    private status;
+    private position;
+    private duration;
+    private volume;
+    private error;
+    private currentIndex;
+    constructor(backend: PlaybackBackend, resolver: TrackResolver);
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+    on<E extends keyof PlayerCoreEvents>(event: E, listener: PlayerCoreEvents[E]): this;
+    off(event: string | symbol, listener: (...args: any[]) => void): this;
+    off<E extends keyof PlayerCoreEvents>(event: E, listener: PlayerCoreEvents[E]): this;
+    get snapshot(): PlaybackSnapshot;
+    add(tracks: Parameters<TrackQueue["add"]>[0], at?: number): QueueEntry[];
+    enqueueSearch(query: string, limit?: number): Promise<QueueEntry[]>;
+    enqueuePlaylist(playlistId: number | string): Promise<QueueEntry[]>;
+    remove(idOrIndex: string | number): QueueEntry | undefined;
+    move(from: number, to: number): void;
+    play(index?: number): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    next(): Promise<void>;
+    previous(): Promise<void>;
+    seek(seconds: number): Promise<void>;
+    setVolume(volume: number): Promise<void>;
+    listDevices(): Promise<AudioDevice[]>;
+    setOutputDevice(deviceId: string): Promise<void>;
+    close(): Promise<void>;
+    private playNextPlayable;
+}
+//# sourceMappingURL=player.d.ts.map

package/build/player.d.ts.map

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

package/build/player.js

@@ -0,0 +1,176 @@
+import { EventEmitter } from "node:events";
+import { TrackQueue } from "./queue.js";
+import { PlayerError } from "./types.js";
+export class PlayerCore extends EventEmitter {
+    backend;
+    resolver;
+    queue = new TrackQueue();
+    current = null;
+    status = "stopped";
+    position = 0;
+    duration = null;
+    volume = 100;
+    error = null;
+    currentIndex = -1;
+    constructor(backend, resolver) {
+        super();
+        this.backend = backend;
+        this.resolver = resolver;
+        backend.on("position", (position, duration) => {
+            this.position = position;
+            this.duration = duration;
+            this.emit("change", this.snapshot);
+        });
+        backend.on("ended", () => {
+            if (this.current)
+                this.emit("track-ended", this.current);
+            void this.next().catch(() => { });
+        });
+        backend.on("error", (error) => {
+            this.status = "error";
+            this.error = error;
+            this.emit("change", this.snapshot);
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    on(event, listener) { return super.on(event, listener); }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    off(event, listener) { return super.off(event, listener); }
+    get snapshot() {
+        return {
+            status: this.status,
+            current: this.current,
+            queue: this.queue.items,
+            position: this.position,
+            duration: this.duration,
+            volume: this.volume,
+            error: this.error,
+        };
+    }
+    add(tracks, at) {
+        const added = this.queue.add(tracks, at);
+        this.emit("change", this.snapshot);
+        return added;
+    }
+    async enqueueSearch(query, limit = 50) {
+        return this.add(await this.resolver.search(query, limit));
+    }
+    async enqueuePlaylist(playlistId) {
+        return this.add(await this.resolver.playlist(playlistId));
+    }
+    remove(idOrIndex) {
+        const removed = this.queue.remove(idOrIndex);
+        if (removed)
+            this.emit("change", this.snapshot);
+        return removed;
+    }
+    move(from, to) {
+        this.queue.move(from, to);
+        this.emit("change", this.snapshot);
+    }
+    async play(index) {
+        const currentIndex = this.current ? this.queue.items.findIndex((entry) => entry.id === this.current.id) : this.currentIndex;
+        const targetIndex = index ?? (currentIndex < 0 ? 0 : currentIndex);
+        const entry = this.queue.items[targetIndex];
+        if (!entry)
+            throw new PlayerError("INVALID_ARGUMENT", "The playback queue is empty or the index is out of range");
+        const source = this.resolver.source(entry.track);
+        if (!source) {
+            this.status = "error";
+            this.error = new PlayerError("NO_AUDIO", `No downloaded audio is available for “${entry.track.title}”. Skipping it.`);
+            this.emit("track-skipped", entry, this.error);
+            this.emit("change", this.snapshot);
+            await this.playNextPlayable(targetIndex + 1);
+            return;
+        }
+        this.status = "loading";
+        this.error = null;
+        this.current = entry;
+        this.currentIndex = targetIndex;
+        this.position = 0;
+        this.duration = null;
+        this.emit("change", this.snapshot);
+        try {
+            await this.backend.load(source);
+            this.status = "playing";
+        }
+        catch (error) {
+            this.status = "error";
+            this.error = error instanceof PlayerError ? error : new PlayerError("STREAM_FAILED", `Could not play “${entry.track.title}”: ${String(error)}`, { cause: error });
+            this.emit("change", this.snapshot);
+            throw this.error;
+        }
+        this.emit("track-started", entry);
+        this.emit("change", this.snapshot);
+    }
+    async pause() {
+        await this.backend.pause(true);
+        this.status = "paused";
+        this.emit("change", this.snapshot);
+    }
+    async resume() {
+        await this.backend.pause(false);
+        this.status = "playing";
+        this.emit("change", this.snapshot);
+    }
+    async next() {
+        const index = this.current ? this.queue.items.findIndex((entry) => entry.id === this.current.id) : this.currentIndex;
+        await this.playNextPlayable(index + 1);
+    }
+    async previous() {
+        if (!this.queue.length)
+            throw new PlayerError("INVALID_ARGUMENT", "The playback queue is empty");
+        const index = this.current ? this.queue.items.findIndex((entry) => entry.id === this.current.id) : this.currentIndex;
+        let target = Math.max(0, index - 1);
+        while (target >= 0 && !this.resolver.source(this.queue.items[target].track)) {
+            const skipped = this.queue.items[target];
+            this.emit("track-skipped", skipped, new PlayerError("NO_AUDIO", `No downloaded audio is available for “${skipped.track.title}”.`));
+            target--;
+        }
+        if (target >= 0)
+            await this.play(target);
+    }
+    async seek(seconds) {
+        if (!Number.isFinite(seconds) || seconds < 0)
+            throw new PlayerError("INVALID_ARGUMENT", "Seek position must be a non-negative number of seconds");
+        await this.backend.seek(seconds);
+    }
+    async setVolume(volume) {
+        if (!Number.isFinite(volume) || volume < 0 || volume > 100)
+            throw new PlayerError("INVALID_ARGUMENT", "Volume must be between 0 and 100");
+        await this.backend.setVolume(volume);
+        this.volume = volume;
+        this.emit("change", this.snapshot);
+    }
+    listDevices() {
+        return this.backend.listDevices();
+    }
+    async setOutputDevice(deviceId) {
+        await this.backend.setOutputDevice(deviceId);
+    }
+    async close() {
+        await this.backend.close();
+        this.status = "stopped";
+        this.current = null;
+        this.currentIndex = -1;
+        this.position = 0;
+        this.duration = null;
+        this.emit("change", this.snapshot);
+    }
+    async playNextPlayable(index) {
+        while (index < this.queue.length && !this.resolver.source(this.queue.items[index].track)) {
+            const skipped = this.queue.items[index];
+            this.emit("track-skipped", skipped, new PlayerError("NO_AUDIO", `No downloaded audio is available for “${skipped.track.title}”.`));
+            index++;
+        }
+        if (index >= this.queue.length) {
+            this.current = null;
+            this.currentIndex = -1;
+            this.status = "ended";
+            this.emit("change", this.snapshot);
+            return;
+        }
+        await this.play(index);
+    }
+}
+//# sourceMappingURL=player.js.map

package/build/player.js.map

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

package/build/protocol.d.ts

@@ -0,0 +1,51 @@
+import { EventEmitter } from "node:events";
+import { type Socket } from "node:net";
+export declare const PLAYER_PROTOCOL_VERSION = 1;
+export interface PlayerRpcRequest {
+    jsonrpc: "2.0";
+    version: number;
+    id: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface PlayerRpcError {
+    code: string;
+    message: string;
+}
+export interface PlayerRpcResponse {
+    jsonrpc: "2.0";
+    version: number;
+    id: number;
+    result?: unknown;
+    error?: PlayerRpcError;
+}
+export interface PlayerRpcEvent {
+    jsonrpc: "2.0";
+    version: number;
+    event: string;
+    data: unknown;
+}
+export declare class PlayerProtocolError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export type PlayerSocketConnector = (path: string) => Socket;
+export declare function encodeRpcRequest(id: number, method: string, params?: Record<string, unknown>): string;
+export declare function encodeRpcResponse(response: Omit<PlayerRpcResponse, "jsonrpc">): string;
+export declare function encodeRpcEvent(event: string, data: unknown): string;
+export declare class PlayerControlClient extends EventEmitter {
+    private readonly socketPath;
+    private readonly timeoutMs;
+    private readonly connectSocket;
+    private socket;
+    private buffer;
+    private nextId;
+    private pending;
+    constructor(socketPath: string, timeoutMs?: number, connectSocket?: PlayerSocketConnector);
+    connect(): Promise<void>;
+    request<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+    close(): Promise<void>;
+    private onData;
+    private rejectPending;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/build/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEzD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAInD;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAE7D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQrG;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAAG,MAAM,CAEtF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAEnE;AAED,qBAAa,mBAAoB,SAAQ,YAAY;IAOjD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IARhC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAoH;gBAGhH,UAAU,EAAE,MAAM,EAClB,SAAS,SAAO,EAChB,aAAa,GAAE,qBAAwC;IAKpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBxB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBlF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,MAAM;IAyBd,OAAO,CAAC,aAAa;CAOtB"}