@stella_project/stellalib 1.0.0

package/dist/Structures/Player.js

@@ -0,0 +1,598 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StellaPlayer = void 0;
+const Filters_1 = require("./Filters");
+const Utils_1 = require("./Utils");
+const PlayerCheck_1 = __importDefault(require("../Utils/PlayerCheck"));
+class StellaPlayer {
+    options;
+    /** The Queue for the Player. */
+    queue = new (Utils_1.Structure.get("Queue"))();
+    /** The filters applied to the audio. */
+    filters;
+    /** Whether the queue repeats the track. */
+    trackRepeat = false;
+    /** Whether the queue repeats the queue. */
+    queueRepeat = false;
+    /** Whether the queue repeats and shuffles after each song. */
+    dynamicRepeat = false;
+    /** The time the player is in the track. */
+    position = 0;
+    /** Whether the player is playing. */
+    playing = false;
+    /** Whether the player is paused. */
+    paused = false;
+    /** The volume for the player. */
+    volume;
+    /** The Node for the Player. */
+    node;
+    /** The guild for the player. */
+    guild;
+    /** The voice channel for the player. */
+    voiceChannel = null;
+    /** The text channel for the player. */
+    textChannel = null;
+    /** The current state of the player. */
+    state = "DISCONNECTED";
+    /** The equalizer bands array. */
+    bands = new Array(15).fill(0.0);
+    /** The voice state object from Discord. */
+    voiceState;
+    /** The Manager. */
+    manager;
+    /** The autoplay state of the player. */
+    isAutoplay = false;
+    /** History of recently auto-played track URIs (avoids repeats). */
+    autoplayHistory = [];
+    /** Max autoplay history size before it rotates. */
+    static AUTOPLAY_HISTORY_MAX = 50;
+    /** Seed pool: last N tracks used for multi-seed smart mix recommendations. */
+    autoplaySeedPool = [];
+    /** Max seed pool size. */
+    static SEED_POOL_MAX = 5;
+    /** Whether the voice connection is ready. */
+    connected = false;
+    /** The ping to the voice server in ms. */
+    ping = -1;
+    static _manager;
+    data = {};
+    dynamicLoopInterval;
+    /** Whether the voice connection handshake is complete. */
+    voiceReady = false;
+    /** @hidden */
+    voiceReadyResolvers = [];
+    /**
+     * Set custom data.
+     * @param key
+     * @param value
+     */
+    set(key, value) {
+        this.data[key] = value;
+    }
+    /**
+     * Get custom data.
+     * @param key
+     */
+    get(key) {
+        return this.data[key];
+    }
+    /** @hidden */
+    static init(manager) {
+        this._manager = manager;
+    }
+    /**
+     * Creates a new player, returns one if it already exists.
+     * @param options
+     */
+    constructor(options) {
+        this.options = options;
+        if (!this.manager)
+            this.manager = Utils_1.Structure.get("Player")._manager;
+        if (!this.manager)
+            throw new RangeError("Manager has not been initiated.");
+        if (this.manager.players.has(options.guild))
+            return this.manager.players.get(options.guild);
+        (0, PlayerCheck_1.default)(options);
+        this.guild = options.guild;
+        this.voiceState = Object.assign({
+            op: "voiceUpdate",
+            guildId: options.guild,
+        });
+        if (options.voiceChannel)
+            this.voiceChannel = options.voiceChannel;
+        if (options.textChannel)
+            this.textChannel = options.textChannel;
+        const node = this.manager.nodes.get(options.node);
+        this.node = node || this.manager.useableNodes;
+        if (!this.node)
+            throw new RangeError("No available nodes.");
+        this.manager.players.set(options.guild, this);
+        this.manager.emit("PlayerCreate", this);
+        this.setVolume(options.volume ?? 11);
+        this.filters = new Filters_1.Filters(this);
+    }
+    /**
+     * Same as Manager#search() but a shortcut on the player itself.
+     * @param query The query to search.
+     * @param requester The user who requested the search.
+     */
+    search(query, requester) {
+        return this.manager.search(query, requester);
+    }
+    /** Connect to the voice channel. */
+    connect() {
+        if (!this.voiceChannel)
+            throw new RangeError("No voice channel has been set.");
+        this.state = "CONNECTING";
+        this.manager.emit("Debug", `[Player:${this.guild}] Connecting to voice channel ${this.voiceChannel}`);
+        this.manager.options.send(this.guild, {
+            op: 4,
+            d: {
+                guild_id: this.guild,
+                channel_id: this.voiceChannel,
+                self_mute: this.options.selfMute || false,
+                self_deaf: this.options.selfDeafen || false,
+            },
+        });
+        this.state = "CONNECTED";
+        return this;
+    }
+    /**
+     * Waits for the voice connection to be ready before playing.
+     * @param timeout Timeout in ms (default: 15000).
+     */
+    waitForVoice(timeout = 15000) {
+        if (this.voiceReady)
+            return Promise.resolve();
+        this.manager.emit("Debug", `[Player:${this.guild}] Waiting for voice connection before playing...`);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const idx = this.voiceReadyResolvers.indexOf(resolve);
+                if (idx !== -1)
+                    this.voiceReadyResolvers.splice(idx, 1);
+                reject(new Error("Voice connection timed out"));
+            }, timeout);
+            this.voiceReadyResolvers.push(() => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Moves the player to a different node.
+     * @param node The ID of the node to move to.
+     */
+    async moveNode(node) {
+        const targetId = node ||
+            this.manager.leastLoadNode.values().next().value?.options.identifier ||
+            [...this.manager.nodes.values()].find((n) => n.connected)?.options.identifier;
+        if (!targetId || !this.manager.nodes.has(targetId))
+            throw new RangeError("No nodes available.");
+        if (this.node.options.identifier === targetId)
+            return this;
+        const currentNode = this.node;
+        const destinationNode = this.manager.nodes.get(targetId);
+        let position = this.position;
+        if (currentNode.connected) {
+            try {
+                const fetchedPlayer = (await currentNode.rest.getPlayer(this.guild));
+                position = fetchedPlayer?.track?.info?.position ?? this.position;
+            }
+            catch {
+                // Use local position
+            }
+        }
+        await destinationNode.rest.updatePlayer({
+            guildId: this.guild,
+            data: {
+                encodedTrack: this.queue.current?.track,
+                position,
+                volume: this.volume,
+                paused: this.paused,
+                filters: {
+                    distortion: this.filters.distortion,
+                    equalizer: this.filters.equalizer,
+                    karaoke: this.filters.karaoke,
+                    rotation: this.filters.rotation,
+                    timescale: this.filters.timescale,
+                    vibrato: this.filters.vibrato,
+                    volume: this.filters.volume,
+                },
+            },
+        });
+        // Send voice state to the new node (with channelId)
+        if (this.voiceState?.sessionId) {
+            await destinationNode.rest.updatePlayer({
+                guildId: this.guild,
+                data: {
+                    voice: {
+                        token: this.voiceState.event?.token,
+                        endpoint: this.voiceState.event?.endpoint,
+                        sessionId: this.voiceState.sessionId,
+                        channelId: this.voiceChannel ?? undefined,
+                    },
+                },
+            });
+        }
+        this.node = destinationNode;
+        this.state = "MOVING";
+        // Destroy player on old node
+        if (currentNode.connected) {
+            currentNode.rest.destroyPlayer(this.guild).catch(() => { });
+        }
+        setTimeout(() => {
+            if (this.state === "MOVING")
+                this.state = "CONNECTED";
+        }, 5000);
+        return this;
+    }
+    /** Disconnect from the voice channel. */
+    disconnect() {
+        if (this.voiceChannel === null)
+            return this;
+        this.state = "DISCONNECTING";
+        this.pause(true);
+        this.manager.options.send(this.guild, {
+            op: 4,
+            d: {
+                guild_id: this.guild,
+                channel_id: null,
+                self_mute: false,
+                self_deaf: false,
+            },
+        });
+        this.voiceChannel = null;
+        this.voiceReady = false;
+        this.state = "DISCONNECTED";
+        return this;
+    }
+    /** Destroys the player, cleaning up all timers and resources. */
+    destroy(disconnect = true) {
+        this.state = "DESTROYING";
+        // Clean up dynamic repeat interval
+        if (this.dynamicLoopInterval) {
+            clearInterval(this.dynamicLoopInterval);
+            this.dynamicLoopInterval = undefined;
+        }
+        // Clear pending voice resolvers
+        this.voiceReadyResolvers = [];
+        this.voiceReady = false;
+        if (disconnect)
+            this.disconnect();
+        this.node.rest.destroyPlayer(this.guild).catch(() => { });
+        this.manager.emit("PlayerDestroy", this);
+        this.manager.players.delete(this.guild);
+    }
+    /**
+     * Sets the player voice channel.
+     * @param channel
+     */
+    setVoiceChannel(channel) {
+        if (typeof channel !== "string")
+            throw new TypeError("Channel must be a non-empty string.");
+        this.voiceChannel = channel;
+        this.connect();
+        return this;
+    }
+    /**
+     * Sets the player text channel.
+     * @param channel
+     */
+    setTextChannel(channel) {
+        if (typeof channel !== "string")
+            throw new TypeError("Channel must be a non-empty string.");
+        this.textChannel = channel;
+        return this;
+    }
+    async play(optionsOrTrack, playOptions) {
+        if (typeof optionsOrTrack !== "undefined" && Utils_1.TrackUtils.validate(optionsOrTrack)) {
+            if (this.queue.current)
+                this.queue.previous = this.queue.current;
+            this.queue.current = optionsOrTrack;
+        }
+        if (!this.queue.current)
+            throw new RangeError("No current track.");
+        const finalOptions = playOptions
+            ? playOptions
+            : ["startTime", "endTime", "noReplace"].every((v) => Object.keys(optionsOrTrack || {}).includes(v))
+                ? optionsOrTrack
+                : {};
+        if (Utils_1.TrackUtils.isUnresolvedTrack(this.queue.current)) {
+            try {
+                this.queue.current = await Utils_1.TrackUtils.getClosestTrack(this.queue.current);
+            }
+            catch (error) {
+                this.manager.emit("TrackError", this, this.queue.current, error);
+                if (this.queue[0])
+                    return this.play(this.queue[0]);
+                return;
+            }
+        }
+        // Wait for voice connection to be ready before playing
+        if (!this.voiceReady) {
+            await this.waitForVoice();
+        }
+        await this.node.rest.updatePlayer({
+            guildId: this.guild,
+            data: {
+                encodedTrack: this.queue.current?.track,
+                ...finalOptions,
+            },
+        });
+        Object.assign(this, { position: 0, playing: true });
+    }
+    /**
+     * Sets the autoplay state of the player.
+     * @param autoplayState
+     * @param botUser
+     */
+    setAutoplay(autoplayState, botUser) {
+        if (typeof autoplayState !== "boolean")
+            throw new TypeError("autoplayState must be a boolean.");
+        if (typeof botUser !== "object")
+            throw new TypeError("botUser must be a user-object.");
+        this.isAutoplay = autoplayState;
+        this.set("Internal_BotUser", botUser);
+        return this;
+    }
+    /**
+     * Gets recommended tracks and returns an array of tracks.
+     * @param track
+     * @param requester
+     */
+    async getRecommended(track, requester) {
+        const node = this.manager.useableNodes;
+        if (!node)
+            throw new Error("No available nodes.");
+        const hasSpotifyURL = ["spotify.com", "open.spotify.com"].some((url) => track.uri?.includes(url));
+        const hasYouTubeURL = ["youtube.com", "youtu.be"].some((url) => track.uri?.includes(url));
+        if (hasSpotifyURL) {
+            try {
+                const info = await node.rest.getInfo();
+                const isSpotifyPluginEnabled = info.plugins?.some((plugin) => plugin.name === "lavasrc-plugin");
+                const isSpotifySourceManagerEnabled = info.sourceManagers?.includes("spotify");
+                if (isSpotifyPluginEnabled && isSpotifySourceManagerEnabled) {
+                    const trackID = node.extractSpotifyTrackID(track.uri);
+                    const artistID = track.pluginInfo?.artistUrl
+                        ? node.extractSpotifyArtistID(track.pluginInfo.artistUrl)
+                        : null;
+                    let identifier = "";
+                    if (trackID && artistID)
+                        identifier = `sprec:seed_artists=${artistID}&seed_tracks=${trackID}`;
+                    else if (trackID)
+                        identifier = `sprec:seed_tracks=${trackID}`;
+                    else if (artistID)
+                        identifier = `sprec:seed_artists=${artistID}`;
+                    if (identifier) {
+                        const recommendedResult = await node.rest.loadTracks(identifier);
+                        if (recommendedResult.loadType === "playlist") {
+                            const playlistData = recommendedResult.data;
+                            if (playlistData.tracks)
+                                return playlistData.tracks.map((t) => Utils_1.TrackUtils.build(t, requester));
+                        }
+                    }
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        let videoID = track.uri?.substring(track.uri.indexOf("=") + 1);
+        if (!hasYouTubeURL) {
+            const res = await this.manager.search(`${track.author} - ${track.title}`);
+            videoID = res.tracks[0]?.uri?.substring(res.tracks[0].uri.indexOf("=") + 1);
+        }
+        if (!videoID)
+            return undefined;
+        const searchURI = `https://www.youtube.com/watch?v=${videoID}&list=RD${videoID}`;
+        const res = await this.manager.search(searchURI);
+        if (res.loadType === "empty" || res.loadType === "error")
+            return undefined;
+        let tracks = res.tracks;
+        if (res.loadType === "playlist")
+            tracks = res.playlist?.tracks ?? [];
+        const filteredTracks = tracks.filter((t) => t.uri !== `https://www.youtube.com/watch?v=${videoID}`);
+        if (this.manager.options.replaceYouTubeCredentials) {
+            for (const t of filteredTracks) {
+                t.author = t.author.replace("- Topic", "").trim();
+                t.title = t.title.replace("Topic -", "").trim();
+                if (t.title.includes("-")) {
+                    const [author, title] = t.title.split("-").map((s) => s.trim());
+                    t.author = author;
+                    t.title = title;
+                }
+            }
+        }
+        return filteredTracks;
+    }
+    /**
+     * Sets the player volume.
+     * @param volume
+     */
+    setVolume(volume) {
+        if (isNaN(volume))
+            throw new TypeError("Volume must be a number.");
+        this.node.rest.updatePlayer({
+            guildId: this.options.guild,
+            data: { volume },
+        });
+        this.volume = volume;
+        return this;
+    }
+    /**
+     * Sets the track repeat.
+     * @param repeat
+     */
+    setTrackRepeat(repeat) {
+        if (typeof repeat !== "boolean")
+            throw new TypeError('Repeat can only be "true" or "false".');
+        const oldPlayer = { ...this };
+        this.trackRepeat = repeat;
+        this.queueRepeat = false;
+        this.dynamicRepeat = false;
+        this.manager.emit("PlayerStateUpdate", oldPlayer, this);
+        return this;
+    }
+    /**
+     * Sets the queue repeat.
+     * @param repeat
+     */
+    setQueueRepeat(repeat) {
+        if (typeof repeat !== "boolean")
+            throw new TypeError('Repeat can only be "true" or "false".');
+        const oldPlayer = { ...this };
+        this.trackRepeat = false;
+        this.queueRepeat = repeat;
+        this.dynamicRepeat = false;
+        this.manager.emit("PlayerStateUpdate", oldPlayer, this);
+        return this;
+    }
+    /**
+     * Sets the queue to repeat and shuffles the queue after each song.
+     * @param repeat Whether to enable dynamic repeat.
+     * @param ms After how many milliseconds to trigger dynamic repeat.
+     */
+    setDynamicRepeat(repeat, ms) {
+        if (typeof repeat !== "boolean")
+            throw new TypeError('Repeat can only be "true" or "false".');
+        if (this.queue.size <= 1)
+            throw new RangeError("The queue size must be greater than 1.");
+        const oldPlayer = { ...this };
+        if (repeat) {
+            this.trackRepeat = false;
+            this.queueRepeat = false;
+            this.dynamicRepeat = true;
+            this.dynamicLoopInterval = setInterval(() => {
+                if (!this.dynamicRepeat)
+                    return;
+                const shuffled = [...this.queue].sort(() => Math.random() - 0.5);
+                this.queue.clear();
+                shuffled.forEach((track) => this.queue.add(track));
+            }, ms);
+        }
+        else {
+            if (this.dynamicLoopInterval)
+                clearInterval(this.dynamicLoopInterval);
+            this.trackRepeat = false;
+            this.queueRepeat = false;
+            this.dynamicRepeat = false;
+        }
+        this.manager.emit("PlayerStateUpdate", oldPlayer, this);
+        return this;
+    }
+    /** Restarts the current track to the start. */
+    restart() {
+        if (!this.queue.current?.track) {
+            if (this.queue.length)
+                this.play();
+            return;
+        }
+        this.node.rest.updatePlayer({
+            guildId: this.guild,
+            data: { position: 0, encodedTrack: this.queue.current?.track },
+        });
+    }
+    /** Stops the current track, optionally give an amount to skip to. */
+    stop(amount) {
+        if (typeof amount === "number" && amount > 1) {
+            if (amount > this.queue.length)
+                throw new RangeError("Cannot skip more than the queue length.");
+            this.queue.splice(0, amount - 1);
+        }
+        this.node.rest.updatePlayer({
+            guildId: this.guild,
+            data: { encodedTrack: null },
+        });
+        return this;
+    }
+    /**
+     * Pauses the current track.
+     * @param pause
+     */
+    pause(pause) {
+        if (typeof pause !== "boolean")
+            throw new RangeError('Pause can only be "true" or "false".');
+        if (this.paused === pause || !this.queue.totalSize)
+            return this;
+        const oldPlayer = { ...this };
+        this.playing = !pause;
+        this.paused = pause;
+        this.node.rest.updatePlayer({
+            guildId: this.guild,
+            data: { paused: pause },
+        });
+        this.manager.emit("PlayerStateUpdate", oldPlayer, this);
+        return this;
+    }
+    /** Go back to the previous song. */
+    previous() {
+        if (this.queue.previous) {
+            this.queue.unshift(this.queue.previous);
+        }
+        this.stop();
+        return this;
+    }
+    /**
+     * Seeks to the position in the current track.
+     * @param position
+     */
+    seek(position) {
+        if (!this.queue.current)
+            return undefined;
+        position = Number(position);
+        if (isNaN(position))
+            throw new RangeError("Position must be a number.");
+        if (position < 0 || position > this.queue.current.duration)
+            position = Math.max(Math.min(position, this.queue.current.duration), 0);
+        this.position = position;
+        this.node.rest.updatePlayer({
+            guildId: this.guild,
+            data: { position },
+        });
+        return this;
+    }
+    /**
+     * Called internally when voice state is flushed to Lavalink.
+     * Resolves all pending waitForVoice() callers.
+     */
+    resolveVoiceReady() {
+        this.voiceReady = true;
+        this.connected = true;
+        const resolvers = this.voiceReadyResolvers;
+        this.voiceReadyResolvers = [];
+        for (const resolve of resolvers)
+            resolve();
+    }
+    /**
+     * Returns a snapshot of the player's current state.
+     * Useful for persistence, debugging, or manual resume.
+     */
+    getStateSnapshot() {
+        return {
+            guildId: this.guild,
+            track: this.queue.current?.track ?? null,
+            position: this.position,
+            volume: this.volume,
+            paused: this.paused,
+            filters: {
+                distortion: this.filters.distortion,
+                equalizer: this.filters.equalizer,
+                karaoke: this.filters.karaoke,
+                rotation: this.filters.rotation,
+                timescale: this.filters.timescale,
+                vibrato: this.filters.vibrato,
+                volume: this.filters.volume,
+            },
+            voiceChannelId: this.voiceChannel,
+            textChannelId: this.textChannel,
+            trackRepeat: this.trackRepeat,
+            queueRepeat: this.queueRepeat,
+            dynamicRepeat: this.dynamicRepeat,
+        };
+    }
+}
+exports.StellaPlayer = StellaPlayer;
+//# sourceMappingURL=Player.js.map

package/dist/Structures/Player.js.map

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

package/dist/Structures/Queue.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * StellaLib — Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel (OSL-3.0)
+ * Derived from LithiumX — Copyright (c) 2025 Anantix Network (MIT)
+ * See LICENSE and THIRD-PARTY-NOTICES.md for full license details.
+ */
+import type { Track, UnresolvedTrack } from "./Types";
+/**
+ * The player's queue. The `current` property is the currently playing track,
+ * think of the rest as the upcoming tracks.
+ */
+export declare class StellaQueue extends Array<Track | UnresolvedTrack> {
+    /** The total duration of the queue including the current track. */
+    get duration(): number;
+    /** The total size of tracks in the queue including the current track. */
+    get totalSize(): number;
+    /** The size of tracks in the queue (excluding current). */
+    get size(): number;
+    /** The current track. */
+    current: Track | UnresolvedTrack | null;
+    /** The previous track. */
+    previous: Track | UnresolvedTrack | null;
+    /**
+     * Adds a track to the queue.
+     * @param track The track or array of tracks to add.
+     * @param offset Optional position to insert at.
+     */
+    add(track: (Track | UnresolvedTrack) | (Track | UnresolvedTrack)[], offset?: number): void;
+    /**
+     * Removes a track from the queue by position.
+     * Defaults to the first track, returning the removed track(s).
+     */
+    remove(position?: number): (Track | UnresolvedTrack)[];
+    /**
+     * Removes tracks using a start and end index, returning the removed tracks.
+     */
+    remove(start: number, end: number): (Track | UnresolvedTrack)[];
+    /** Clears the queue. */
+    clear(): void;
+    /** Shuffles the queue using the Fisher-Yates algorithm. */
+    shuffle(): void;
+    /**
+     * Shuffles the queue but distributes tracks evenly by requester,
+     * so no single user dominates the upcoming tracks.
+     */
+    equalizedShuffle(): void;
+}
+//# sourceMappingURL=Queue.d.ts.map

package/dist/Structures/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../src/Structures/Queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGtD;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK,CAAC,KAAK,GAAG,eAAe,CAAC;IAC9D,mEAAmE;IACnE,IAAW,QAAQ,IAAI,MAAM,CAG5B;IAED,yEAAyE;IACzE,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,2DAA2D;IAC3D,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,yBAAyB;IAClB,OAAO,EAAE,KAAK,GAAG,eAAe,GAAG,IAAI,CAAQ;IAEtD,0BAA0B;IACnB,QAAQ,EAAE,KAAK,GAAG,eAAe,GAAG,IAAI,CAAQ;IAEvD;;;;OAIG;IACI,GAAG,CACT,KAAK,EAAE,CAAC,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,GAAG,eAAe,CAAC,EAAE,EAC9D,MAAM,CAAC,EAAE,MAAM,GACb,IAAI;IAiCP;;;OAGG;IACI,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,eAAe,CAAC,EAAE;IAE7D;;OAEG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,eAAe,CAAC,EAAE;IAatE,wBAAwB;IACjB,KAAK,IAAI,IAAI;IAIpB,2DAA2D;IACpD,OAAO,IAAI,IAAI;IAOtB;;;OAGG;IACI,gBAAgB,IAAI,IAAI;CAoB/B"}