yukimu 1.0.0

package/dist/Player.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Player = void 0;
+const Queue_1 = require("./Queue");
+class Player {
+    constructor(manager, node, options) {
+        // State
+        this.playing = false;
+        this.paused = false;
+        this.connected = false;
+        this.position = 0;
+        this.ping = -1;
+        // Voice connection
+        this.sessionId = null;
+        this.voiceToken = null;
+        this.voiceEndpoint = null;
+        // Filters
+        this.filters = {};
+        // Loop mode
+        this.loop = "none";
+        this.manager = manager;
+        this.node = node;
+        this.queue = new Queue_1.Queue();
+        this.guildId = options.guildId;
+        this.voiceChannelId = options.voiceChannelId;
+        this.textChannelId = options.textChannelId;
+        this.volume = options.volume ?? 100;
+        // Send voice channel join payload to Discord
+        this.sendVoicePayload(options.voiceChannelId, options.selfDeaf ?? true, options.selfMute ?? false);
+    }
+    // ─── Voice ───────────────────────────────────────────────────────
+    sendVoicePayload(channelId, selfDeaf, selfMute) {
+        this.manager.sendPayload(this.guildId, {
+            op: 4,
+            d: {
+                guild_id: this.guildId,
+                channel_id: channelId,
+                self_deaf: selfDeaf,
+                self_mute: selfMute,
+            },
+        });
+    }
+    /** Called when both sessionId and voiceToken/endpoint are available */
+    checkVoiceReady() {
+        if (!this.sessionId || !this.voiceToken || !this.voiceEndpoint)
+            return;
+        const voiceState = {
+            token: this.voiceToken,
+            endpoint: this.voiceEndpoint,
+            sessionId: this.sessionId,
+        };
+        this.node
+            .request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}`, {
+            voice: voiceState,
+        })
+            .catch(console.error);
+    }
+    // ─── Playback ─────────────────────────────────────────────────────
+    /** Play a track */
+    async play(track, options) {
+        this.queue.current = track;
+        await this.node.request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}?noReplace=false`, {
+            track: { encoded: track.encoded },
+            volume: this.volume,
+            ...(options?.startTime && { position: options.startTime }),
+            ...(options?.endTime && { endTime: options.endTime }),
+        });
+        this.playing = true;
+        this.paused = false;
+    }
+    /** Pause or resume playback */
+    async pause(state = true) {
+        await this.node.request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}`, {
+            paused: state,
+        });
+        this.paused = state;
+        this.playing = !state;
+    }
+    /** Resume playback */
+    async resume() {
+        return this.pause(false);
+    }
+    /** Stop playback */
+    async stop() {
+        await this.node.request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}`, {
+            track: { encoded: null },
+        });
+        this.playing = false;
+        this.paused = false;
+        this.position = 0;
+        this.queue.current = null;
+    }
+    /** Skip to next track */
+    async skip() {
+        const next = this.queue.next();
+        if (next) {
+            await this.play(next);
+        }
+        else {
+            await this.stop();
+            this.manager.emit("queueEnd", this);
+        }
+        return next;
+    }
+    /** Seek to position in milliseconds */
+    async seek(position) {
+        if (!this.queue.current?.info.isSeekable)
+            throw new Error("Current track is not seekable");
+        await this.node.request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}`, {
+            position,
+        });
+        this.position = position;
+    }
+    /** Set volume (0–1000, Lavalink default 100) */
+    async setVolume(volume) {
+        if (volume < 0 || volume > 1000)
+            throw new Error("Volume must be between 0 and 1000");
+        await this.node.request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}`, {
+            volume,
+        });
+        this.volume = volume;
+    }
+    // ─── Filters ──────────────────────────────────────────────────────
+    /** Apply audio filters (bass boost, nightcore, 8D, etc.) */
+    async setFilters(filters) {
+        this.filters = filters;
+        await this.node.request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}`, {
+            filters,
+        });
+    }
+    /** Enable bass boost */
+    async setBassBoost(level) {
+        const bands = [];
+        const gains = {
+            off: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+            low: [0.2, 0.15, 0.1, 0.05, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+            medium: [0.4, 0.3, 0.2, 0.1, 0.05, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+            high: [0.6, 0.5, 0.4, 0.25, 0.1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+        };
+        for (let i = 0; i < 15; i++) {
+            bands.push({ band: i, gain: gains[level][i] });
+        }
+        await this.setFilters({ ...this.filters, equalizer: bands });
+    }
+    /** Enable nightcore effect */
+    async setNightcore(enabled) {
+        await this.setFilters({
+            ...this.filters,
+            timescale: enabled ? { speed: 1.2, pitch: 1.2, rate: 1.0 } : {},
+        });
+    }
+    /** Enable 8D audio */
+    async set8D(enabled) {
+        await this.setFilters({
+            ...this.filters,
+            rotation: enabled ? { rotationHz: 0.2 } : {},
+        });
+    }
+    /** Clear all filters */
+    async clearFilters() {
+        this.filters = {};
+        await this.node.request("PATCH", `/sessions/${this.node.sessionId}/players/${this.guildId}`, {
+            filters: {},
+        });
+    }
+    // ─── Queue Helpers ────────────────────────────────────────────────
+    /** Add track(s) to queue and optionally start playing */
+    async add(tracks, playNow = false) {
+        const arr = Array.isArray(tracks) ? tracks : [tracks];
+        if (!this.queue.current && arr.length > 0) {
+            const first = arr.shift();
+            this.queue.current = first;
+            this.queue.add(arr);
+            await this.play(first);
+        }
+        else {
+            this.queue.add(arr);
+            if (playNow && arr.length > 0) {
+                await this.play(arr[0]);
+            }
+        }
+    }
+    /** Set loop mode */
+    setLoop(mode) {
+        this.loop = mode;
+    }
+    // ─── Disconnect ───────────────────────────────────────────────────
+    /** Disconnect from voice and clean up */
+    async destroy() {
+        this.sendVoicePayload(null, false, false);
+        await this.node
+            .request("DELETE", `/sessions/${this.node.sessionId}/players/${this.guildId}`)
+            .catch(() => { });
+        this.playing = false;
+        this.connected = false;
+        this.queue.clear();
+    }
+    /** Move to a different voice channel */
+    async move(channelId, selfDeaf = true) {
+        this.voiceChannelId = channelId;
+        this.sendVoicePayload(channelId, selfDeaf, false);
+    }
+}
+exports.Player = Player;
+//# sourceMappingURL=Player.js.map

package/dist/Player.js.map

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

package/dist/Queue.d.ts

@@ -0,0 +1,29 @@
+import { Track } from "./types";
+export declare class Queue {
+    current: Track | null;
+    previous: Track | null;
+    private tracks;
+    /** Add tracks to the end of the queue */
+    add(tracks: Track | Track[]): void;
+    /** Remove and return the next track */
+    next(): Track | null;
+    /** Peek at upcoming tracks without modifying queue */
+    peek(count?: number): Track[];
+    /** Remove a track at a specific index */
+    remove(index: number): Track | null;
+    /** Clear all queued tracks (does not affect current) */
+    clear(): void;
+    /** Fisher-Yates shuffle */
+    shuffle(): void;
+    /** Move a track from one position to another */
+    move(from: number, to: number): void;
+    /** Total tracks in queue (not including current) */
+    get size(): number;
+    /** Total duration of all queued tracks in ms */
+    get totalDuration(): number;
+    /** Whether the queue is empty */
+    get isEmpty(): boolean;
+    /** All tracks as array (read-only view) */
+    get list(): ReadonlyArray<Track>;
+}
+//# sourceMappingURL=Queue.d.ts.map

package/dist/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../src/Queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,KAAK;IACT,OAAO,EAAE,KAAK,GAAG,IAAI,CAAQ;IAC7B,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAQ;IACrC,OAAO,CAAC,MAAM,CAAe;IAI7B,yCAAyC;IAClC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI;IAKzC,uCAAuC;IAChC,IAAI,IAAI,KAAK,GAAG,IAAI;IAM3B,sDAAsD;IAC/C,IAAI,CAAC,KAAK,GAAE,MAAU,GAAG,KAAK,EAAE;IAIvC,yCAAyC;IAClC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAM1C,wDAAwD;IACjD,KAAK,IAAI,IAAI;IAQpB,2BAA2B;IACpB,OAAO,IAAI,IAAI;IAStB,gDAAgD;IACzC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ3C,oDAAoD;IACpD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,gDAAgD;IAChD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,iCAAiC;IACjC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,2CAA2C;IAC3C,IAAI,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,CAE/B;CACF"}

package/dist/Queue.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue = void 0;
+class Queue {
+    constructor() {
+        this.current = null;
+        this.previous = null;
+        this.tracks = [];
+    }
+    // ─── Basic Operations ─────────────────────────────────────────────
+    /** Add tracks to the end of the queue */
+    add(tracks) {
+        const arr = Array.isArray(tracks) ? tracks : [tracks];
+        this.tracks.push(...arr);
+    }
+    /** Remove and return the next track */
+    next() {
+        if (this.current)
+            this.previous = this.current;
+        this.current = this.tracks.shift() ?? null;
+        return this.current;
+    }
+    /** Peek at upcoming tracks without modifying queue */
+    peek(count = 5) {
+        return this.tracks.slice(0, count);
+    }
+    /** Remove a track at a specific index */
+    remove(index) {
+        if (index < 0 || index >= this.tracks.length)
+            return null;
+        const [removed] = this.tracks.splice(index, 1);
+        return removed;
+    }
+    /** Clear all queued tracks (does not affect current) */
+    clear() {
+        this.tracks = [];
+        this.current = null;
+        this.previous = null;
+    }
+    // ─── Shuffle ──────────────────────────────────────────────────────
+    /** Fisher-Yates shuffle */
+    shuffle() {
+        for (let i = this.tracks.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [this.tracks[i], this.tracks[j]] = [this.tracks[j], this.tracks[i]];
+        }
+    }
+    // ─── Move / Reorder ───────────────────────────────────────────────
+    /** Move a track from one position to another */
+    move(from, to) {
+        if (from < 0 || to < 0 || from >= this.tracks.length || to >= this.tracks.length)
+            return;
+        const [track] = this.tracks.splice(from, 1);
+        this.tracks.splice(to, 0, track);
+    }
+    // ─── Getters ──────────────────────────────────────────────────────
+    /** Total tracks in queue (not including current) */
+    get size() {
+        return this.tracks.length;
+    }
+    /** Total duration of all queued tracks in ms */
+    get totalDuration() {
+        return this.tracks.reduce((acc, t) => acc + (t.info.length ?? 0), 0);
+    }
+    /** Whether the queue is empty */
+    get isEmpty() {
+        return this.tracks.length === 0;
+    }
+    /** All tracks as array (read-only view) */
+    get list() {
+        return this.tracks;
+    }
+}
+exports.Queue = Queue;
+//# sourceMappingURL=Queue.js.map

package/dist/Queue.js.map

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

package/dist/Resolver.d.ts

@@ -0,0 +1,30 @@
+import { SearchResult, SearchSource } from "./types";
+import type { Yukimu } from "./Yukimu";
+export declare class Resolver {
+    private manager;
+    private spotifyToken;
+    private spotifyExpiry;
+    constructor(manager: Yukimu);
+    /**
+     * Resolve a query or URL to Lavalink tracks
+     */
+    resolve(query: string, source: SearchSource): Promise<SearchResult>;
+    /**
+     * Detect what platform a URL belongs to
+     */
+    detectSource(url: string): SearchSource | null;
+    /**
+     * Get Spotify API token (for resolving Spotify metadata without LavaSrc)
+     * Only needed if you're NOT using the LavaSrc Lavalink plugin
+     */
+    getSpotifyToken(): Promise<string | null>;
+    /**
+     * Resolve a Spotify URL to track metadata (title + artist for YouTube fallback search)
+     * Used when LavaSrc plugin is NOT installed
+     */
+    resolveSpotifyFallback(url: string): Promise<{
+        title: string;
+        artist: string;
+    } | null>;
+}
+//# sourceMappingURL=Resolver.d.ts.map

package/dist/Resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resolver.d.ts","sourceRoot":"","sources":["../src/Resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAkC,MAAM,SAAS,CAAC;AACrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAgCvC,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,aAAa,CAAa;gBAEtB,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACU,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBhF;;OAEG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IASrD;;;OAGG;IACU,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyBtD;;;OAGG;IACU,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAoBpG"}

package/dist/Resolver.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Resolver = void 0;
+const types_1 = require("./types");
+// ─── URL Patterns ─────────────────────────────────────────────────────────────
+const URL_PATTERNS = {
+    youtube: [
+        /^https?:\/\/(www\.)?(youtube\.com|youtu\.be)\/.+/,
+        /^https?:\/\/music\.youtube\.com\/.+/,
+    ],
+    spotify: [
+        /^https?:\/\/open\.spotify\.com\/(track|album|playlist|artist)\/.+/,
+    ],
+    soundcloud: [
+        /^https?:\/\/(www\.)?soundcloud\.com\/.+/,
+    ],
+    deezer: [
+        /^https?:\/\/(www\.)?deezer\.com\/(track|album|playlist)\/.+/,
+    ],
+    applemusic: [
+        /^https?:\/\/music\.apple\.com\/.+/,
+    ],
+    tidal: [
+        /^https?:\/\/(www\.)?tidal\.com\/(browse\/)?(track|album|playlist)\/.+/,
+    ],
+    jiosaavn: [
+        /^https?:\/\/(www\.)?jiosaavn\.com\/.+/,
+    ],
+    yandexmusic: [
+        /^https?:\/\/music\.yandex\.(ru|com)\/.+/,
+    ],
+};
+class Resolver {
+    constructor(manager) {
+        this.spotifyToken = null;
+        this.spotifyExpiry = 0;
+        this.manager = manager;
+    }
+    /**
+     * Resolve a query or URL to Lavalink tracks
+     */
+    async resolve(query, source) {
+        const node = this.manager.getBestNode();
+        // Check if query is a direct URL
+        const detectedSource = this.detectSource(query);
+        if (detectedSource) {
+            // It's a URL — pass directly to Lavalink (LavaSrc handles platform resolution)
+            return node.loadTracks(query);
+        }
+        // It's a search query — use source prefix
+        const prefix = types_1.SourcePrefixes[source];
+        return node.loadTracks(`${prefix}:${query}`);
+    }
+    /**
+     * Detect what platform a URL belongs to
+     */
+    detectSource(url) {
+        for (const [source, patterns] of Object.entries(URL_PATTERNS)) {
+            if (patterns.some(p => p.test(url))) {
+                return source;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get Spotify API token (for resolving Spotify metadata without LavaSrc)
+     * Only needed if you're NOT using the LavaSrc Lavalink plugin
+     */
+    async getSpotifyToken() {
+        const opts = this.manager.options.spotify;
+        if (!opts)
+            return null;
+        if (this.spotifyToken && Date.now() < this.spotifyExpiry)
+            return this.spotifyToken;
+        try {
+            const res = await fetch("https://accounts.spotify.com/api/token", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/x-www-form-urlencoded",
+                    Authorization: `Basic ${Buffer.from(`${opts.clientId}:${opts.clientSecret}`).toString("base64")}`,
+                },
+                body: "grant_type=client_credentials",
+            });
+            const data = await res.json();
+            this.spotifyToken = data.access_token;
+            this.spotifyExpiry = Date.now() + data.expires_in * 1000 - 5000;
+            return this.spotifyToken;
+        }
+        catch (err) {
+            console.error("[Yukimu] Failed to fetch Spotify token:", err);
+            return null;
+        }
+    }
+    /**
+     * Resolve a Spotify URL to track metadata (title + artist for YouTube fallback search)
+     * Used when LavaSrc plugin is NOT installed
+     */
+    async resolveSpotifyFallback(url) {
+        const token = await this.getSpotifyToken();
+        if (!token)
+            return null;
+        const match = url.match(/spotify\.com\/track\/([a-zA-Z0-9]+)/);
+        if (!match)
+            return null;
+        try {
+            const res = await fetch(`https://api.spotify.com/v1/tracks/${match[1]}`, {
+                headers: { Authorization: `Bearer ${token}` },
+            });
+            const data = await res.json();
+            return {
+                title: data.name,
+                artist: data.artists[0]?.name ?? "Unknown",
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.Resolver = Resolver;
+//# sourceMappingURL=Resolver.js.map

package/dist/Resolver.js.map

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

package/dist/Yukimu.d.ts

@@ -0,0 +1,59 @@
+import { EventEmitter } from "events";
+import { Node } from "./Node";
+import { Player } from "./Player";
+import { Resolver } from "./Resolver";
+import { YukimuOptions, PlayerOptions, YukimuEvents, SearchSource, SearchResult } from "./types";
+/**
+ * Yukimu - A powerful Lavalink v4 wrapper for Discord bots
+ * Supports: YouTube, YouTube Music, Spotify, Deezer, Apple Music,
+ *           JioSaavn, Tidal, SoundCloud, Yandex Music
+ */
+export declare class Yukimu extends EventEmitter {
+    readonly options: YukimuOptions;
+    readonly nodes: Map<string, Node>;
+    readonly players: Map<string, Player>;
+    readonly resolver: Resolver;
+    /** Send function — you must set this to send voice payloads to Discord */
+    sendPayload: (guildId: string, payload: unknown) => void;
+    constructor(options: YukimuOptions);
+    /** Add a new Lavalink node */
+    addNode(options: import("./types").NodeOptions): Node;
+    /** Remove a node by name */
+    removeNode(name: string): void;
+    /** Get the best available node (least load) */
+    getBestNode(): Node;
+    /** Create a new player for a guild */
+    createPlayer(options: PlayerOptions): Player;
+    /** Get an existing player */
+    getPlayer(guildId: string): Player | undefined;
+    /** Destroy a player */
+    destroyPlayer(guildId: string): void;
+    /**
+     * Search for tracks across any supported source
+     * @param query - Search query or direct URL
+     * @param source - Where to search (youtube, spotify, deezer, etc.)
+     */
+    search(query: string, source?: SearchSource): Promise<SearchResult>;
+    /**
+     * Handle Discord voice state updates — call this in your bot's
+     * voiceStateUpdate event handler
+     */
+    handleVoiceStateUpdate(data: {
+        guild_id?: string;
+        user_id: string;
+        session_id: string;
+        channel_id?: string | null;
+    }): void;
+    /**
+     * Handle Discord voice server updates — call this in your bot's
+     * voiceServerUpdate event handler
+     */
+    handleVoiceServerUpdate(data: {
+        guild_id: string;
+        token: string;
+        endpoint?: string | null;
+    }): void;
+    on<K extends keyof YukimuEvents>(event: K, listener: (...args: YukimuEvents[K]) => void): this;
+    emit<K extends keyof YukimuEvents>(event: K, ...args: YukimuEvents[K]): boolean;
+}
+//# sourceMappingURL=Yukimu.d.ts.map

package/dist/Yukimu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Yukimu.d.ts","sourceRoot":"","sources":["../src/Yukimu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,YAAY;IACtC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAa;IACrD,SAAgB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IACzD,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,0EAA0E;IACnE,WAAW,EAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;gBAErD,OAAO,EAAE,aAAa;IAalC,8BAA8B;IACvB,OAAO,CAAC,OAAO,EAAE,OAAO,SAAS,EAAE,WAAW,GAAG,IAAI;IAO5D,4BAA4B;IACrB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOrC,+CAA+C;IACxC,WAAW,IAAI,IAAI;IAa1B,sCAAsC;IAC/B,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAcnD,6BAA6B;IACtB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD,uBAAuB;IAChB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU3C;;;;OAIG;IACU,MAAM,CACjB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,YAAsD,GAC7D,OAAO,CAAC,YAAY,CAAC;IAMxB;;;OAGG;IACI,sBAAsB,CAAC,IAAI,EAAE;QAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,GAAG,IAAI;IAoBR;;;OAGG;IACI,uBAAuB,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,GAAG,IAAI;IAYD,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,IAAI;IAIA,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EACtC,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,OAAO;CAGX"}