yukimu 1.2.0 → 2.0.0

package/dist/Constants.js

@@ -1,18 +1,22 @@
 "use strict";
-/** Lavalink v3/v4 supported ops and constants */
+/** Yukimu v2.0.0 — Constants & Enumerations */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.URL_PATTERNS = exports.SOURCE_PREFIXES = exports.STOPPED_REASONS = exports.TrackEndReason = exports.EventType = exports.LoadType = exports.OpCodes = exports.PlayerState = exports.State = exports.CLIENT_NAME = exports.VERSION = void 0;
+exports.DEFAULTS = exports.BITRATE_BY_BOOST_TIER = exports.WS_CLOSE_CODES = exports.STOPPED_REASONS = exports.URL_PATTERNS = exports.SOURCE_PREFIXES = exports.PlayerState = exports.State = exports.CLIENT_NAME = exports.VERSION = void 0;
 exports.VERSION = "2.0.0";
 exports.CLIENT_NAME = `Yukimu/${exports.VERSION}`;
+// ─── Node Connection State ──────────────────────────────────────────────────
 var State;
 (function (State) {
     State[State["CONNECTING"] = 0] = "CONNECTING";
+    /** WebSocket open, waiting for ready op */
     State[State["NEARLY"] = 1] = "NEARLY";
+    /** Fully connected and ready */
     State[State["CONNECTED"] = 2] = "CONNECTED";
     State[State["DISCONNECTING"] = 3] = "DISCONNECTING";
     State[State["DISCONNECTED"] = 4] = "DISCONNECTED";
     State[State["RECONNECTING"] = 5] = "RECONNECTING";
 })(State || (exports.State = State = {}));
+// ─── Player Connection State ────────────────────────────────────────────────
 var PlayerState;
 (function (PlayerState) {
     PlayerState[PlayerState["CONNECTING"] = 0] = "CONNECTING";
@@ -20,62 +24,9 @@ var PlayerState;
     PlayerState[PlayerState["DISCONNECTING"] = 2] = "DISCONNECTING";
     PlayerState[PlayerState["DISCONNECTED"] = 3] = "DISCONNECTED";
 })(PlayerState || (exports.PlayerState = PlayerState = {}));
-var OpCodes;
-(function (OpCodes) {
-    // v3 WebSocket ops
-    OpCodes["PLAY"] = "play";
-    OpCodes["STOP"] = "stop";
-    OpCodes["PAUSE"] = "pause";
-    OpCodes["SEEK"] = "seek";
-    OpCodes["VOLUME"] = "volume";
-    OpCodes["FILTERS"] = "filters";
-    OpCodes["DESTROY"] = "destroy";
-    OpCodes["VOICE_UPDATE"] = "voiceUpdate";
-    OpCodes["EQUALIZER"] = "equalizer";
-    // Incoming
-    OpCodes["STATS"] = "stats";
-    OpCodes["PLAYER_UPDATE"] = "playerUpdate";
-    OpCodes["EVENT"] = "event";
-    OpCodes["READY"] = "ready";
-})(OpCodes || (exports.OpCodes = OpCodes = {}));
-var LoadType;
-(function (LoadType) {
-    LoadType["TRACK"] = "track";
-    LoadType["PLAYLIST"] = "playlist";
-    LoadType["SEARCH"] = "search";
-    LoadType["EMPTY"] = "empty";
-    LoadType["ERROR"] = "error";
-    // v3 equivalents (normalized internally)
-    LoadType["TRACK_LOADED"] = "track_loaded";
-    LoadType["PLAYLIST_LOADED"] = "playlist_loaded";
-    LoadType["SEARCH_RESULT"] = "search_result";
-    LoadType["NO_MATCHES"] = "no_matches";
-    LoadType["LOAD_FAILED"] = "load_failed";
-})(LoadType || (exports.LoadType = LoadType = {}));
-var EventType;
-(function (EventType) {
-    EventType["TRACK_START"] = "TrackStartEvent";
-    EventType["TRACK_END"] = "TrackEndEvent";
-    EventType["TRACK_EXCEPTION"] = "TrackExceptionEvent";
-    EventType["TRACK_STUCK"] = "TrackStuckEvent";
-    EventType["WS_CLOSED"] = "WebSocketClosedEvent";
-})(EventType || (exports.EventType = EventType = {}));
-var TrackEndReason;
-(function (TrackEndReason) {
-    TrackEndReason["FINISHED"] = "finished";
-    TrackEndReason["LOAD_FAILED"] = "loadFailed";
-    TrackEndReason["STOPPED"] = "stopped";
-    TrackEndReason["REPLACED"] = "replaced";
-    TrackEndReason["CLEANUP"] = "cleanup";
-    // v3
-    TrackEndReason["FINISHED_V3"] = "FINISHED";
-    TrackEndReason["STOPPED_V3"] = "STOPPED";
-    TrackEndReason["REPLACED_V3"] = "REPLACED";
-    TrackEndReason["CLEANUP_V3"] = "CLEANUP";
-})(TrackEndReason || (exports.TrackEndReason = TrackEndReason = {}));
-exports.STOPPED_REASONS = new Set([
-    "replaced", "stopped", "REPLACED", "STOPPED",
-]);
+// ─── Source Search Prefixes ─────────────────────────────────────────────────
+// These are the Lavalink search prefixes used when the query is not a URL.
+// Requires corresponding Lavalink plugins (LavaSrc, Topis-Source-Manager, etc.)
 exports.SOURCE_PREFIXES = {
     youtube: "ytsearch",
     youtubemusic: "ytmsearch",
@@ -86,16 +37,132 @@ exports.SOURCE_PREFIXES = {
     tidal: "tdsearch",
     jiosaavn: "jssearch",
     yandexmusic: "ymsearch",
-    flowery: "ftts",
+    bandcamp: "bcsearch",
+    vimeo: "vmsearch",
+    twitch: "twsearch",
+    bilibili: "blsearch",
+    mixcloud: "mxsearch",
+    http: "http",
 };
+// ─── URL Detection Patterns ─────────────────────────────────────────────────
+// Used to auto-detect the source platform from a URL so the user doesn't
+// have to specify the source manually.
 exports.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)\/.+/],
+    youtube: [
+        /^https?:\/\/(www\.)?(youtube\.com|youtu\.be)\/.+/,
+        /^https?:\/\/music\.youtube\.com\/.+/,
+        /^https?:\/\/(www\.)?youtube\.com\/shorts\/.+/,
+    ],
+    spotify: [
+        /^https?:\/\/open\.spotify\.com\/(track|album|playlist|artist|episode|show)\/.+/,
+    ],
+    soundcloud: [
+        /^https?:\/\/(www\.|m\.)?soundcloud\.com\/.+/,
+        /^https?:\/\/on\.soundcloud\.com\/.+/,
+    ],
+    deezer: [
+        /^https?:\/\/(www\.)?deezer\.com\/(track|album|playlist|artist)\/.+/,
+    ],
+    applemusic: [
+        /^https?:\/\/music\.apple\.com\/.+/,
+    ],
+    tidal: [
+        /^https?:\/\/(www\.|listen\.)?tidal\.com\/.+/,
+    ],
+    jiosaavn: [
+        /^https?:\/\/(www\.)?jiosaavn\.com\/.+/,
+    ],
+    yandexmusic: [
+        /^https?:\/\/music\.yandex\.(ru|com|by|kz|uz)\/.+/,
+    ],
+    bandcamp: [
+        /^https?:\/\/[a-zA-Z0-9-]+\.bandcamp\.com\/.+/,
+        /^https?:\/\/(www\.)?bandcamp\.com\/.+/,
+    ],
+    vimeo: [
+        /^https?:\/\/(www\.|player\.)?vimeo\.com\/.+/,
+    ],
+    twitch: [
+        /^https?:\/\/(www\.|clips\.)?twitch\.tv\/.+/,
+    ],
+    tiktok: [
+        /^https?:\/\/(www\.|vm\.|vt\.)?tiktok\.com\/.+/,
+    ],
+    facebook: [
+        /^https?:\/\/(www\.|m\.|fb\.)?facebook\.com\/.+/,
+        /^https?:\/\/fb\.watch\/.+/,
+    ],
+    twitter: [
+        /^https?:\/\/(www\.)?(twitter\.com|x\.com)\/.+/,
+    ],
+    reddit: [
+        /^https?:\/\/(www\.|old\.|new\.)?reddit\.com\/.+/,
+        /^https?:\/\/v\.redd\.it\/.+/,
+    ],
+    instagram: [
+        /^https?:\/\/(www\.)?instagram\.com\/(p|reel|tv)\/.+/,
+    ],
+    pornhub: [
+        /^https?:\/\/(www\.)?pornhub\.com\/view_video.+/,
+    ],
+    mixcloud: [
+        /^https?:\/\/(www\.)?mixcloud\.com\/.+/,
+    ],
+    bilibili: [
+        /^https?:\/\/(www\.)?bilibili\.com\/video\/.+/,
+        /^https?:\/\/b23\.tv\/.+/,
+    ],
+};
+// ─── Track End Reasons ──────────────────────────────────────────────────────
+// These indicate that track replacement or manual stop occurred,
+// so we should NOT auto-advance the queue.
+exports.STOPPED_REASONS = new Set([
+    "replaced",
+    "stopped",
+    "cleanup",
+    "REPLACED",
+    "STOPPED",
+    "CLEANUP",
+]);
+// ─── WebSocket Close Codes ──────────────────────────────────────────────────
+exports.WS_CLOSE_CODES = {
+    1000: "Normal closure",
+    1001: "Going away",
+    1006: "Abnormal closure",
+    4001: "Unknown opcode",
+    4002: "Failed to decode payload",
+    4003: "Not authenticated",
+    4004: "Authentication failed",
+    4005: "Already authenticated",
+    4006: "Session no longer valid",
+    4009: "Session timeout",
+    4014: "Disconnected (channel deleted, kick, or stage)",
+    4015: "Voice server crashed",
+};
+exports.BITRATE_BY_BOOST_TIER = {
+    0: { maxBitrate: 96, recommendedVolume: 100, enhancedEQ: false },
+    1: { maxBitrate: 128, recommendedVolume: 100, enhancedEQ: false },
+    2: { maxBitrate: 256, recommendedVolume: 100, enhancedEQ: true },
+    3: { maxBitrate: 384, recommendedVolume: 100, enhancedEQ: true },
+};
+// ─── Default Configuration ──────────────────────────────────────────────────
+exports.DEFAULTS = {
+    VOICE_CONNECTION_TIMEOUT: 15_000,
+    MAX_CACHE_SIZE: 1000,
+    CACHE_TTL: 3_600_000, // 1 hour
+    HEARTBEAT_INTERVAL: 30_000,
+    WS_SEND_TIMEOUT: 30_000,
+    WS_MAX_QUEUE: 100,
+    REST_TIMEOUT: 30_000,
+    REST_MAX_RETRIES: 3,
+    REST_RETRY_BASE_DELAY: 1000,
+    REST_RETRY_MAX_DELAY: 15_000,
+    NODE_CONNECTION_TIMEOUT: 10_000,
+    NODE_MAX_RETRIES: 5,
+    NODE_MAX_RECONNECT_DELAY: 30_000,
+    PREVIOUS_HISTORY_SIZE: 25,
+    CACHE_SWEEP_INTERVAL: 300_000, // 5 minutes
+    SPOTIFY_TOKEN_REFRESH_BUFFER: 30_000,
+    MAX_SEARCH_RETRIES: 2,
 };
 //# sourceMappingURL=Constants.js.map

package/dist/Constants.js.map

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

package/dist/Logger.d.ts

@@ -0,0 +1,22 @@
+/** Yukimu v2.0.0 — Configurable Logger System */
+import type { LogLevel, YukimuLogger } from "./types";
+/**
+ * Built-in logger with configurable log levels.
+ * Users can inject their own logger (Winston, Pino, etc.) via YukimuOptions.
+ */
+export declare class Logger implements YukimuLogger {
+    private readonly prefix;
+    private level;
+    private custom?;
+    constructor(level?: LogLevel, custom?: YukimuLogger);
+    /** Update the log level at runtime */
+    setLevel(level: LogLevel): void;
+    /** Inject a custom logger implementation */
+    setCustomLogger(logger: YukimuLogger | undefined): void;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    private timestamp;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAUtD;;;GAGG;AACH,qBAAa,MAAO,YAAW,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAC,CAAe;gBAElB,KAAK,GAAE,QAAiB,EAAE,MAAM,CAAC,EAAE,YAAY;IAM3D,sCAAsC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAItC,4CAA4C;IACrC,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI;IAIvD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAShD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAS/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAS/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IASvD,OAAO,CAAC,SAAS;CAGlB"}

package/dist/Logger.js

@@ -0,0 +1,74 @@
+"use strict";
+/** Yukimu v2.0.0 — Configurable Logger System */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const LOG_LEVELS = {
+    none: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+/**
+ * Built-in logger with configurable log levels.
+ * Users can inject their own logger (Winston, Pino, etc.) via YukimuOptions.
+ */
+class Logger {
+    prefix;
+    level;
+    custom;
+    constructor(level = "info", custom) {
+        this.prefix = "[Yukimu]";
+        this.level = LOG_LEVELS[level];
+        this.custom = custom;
+    }
+    /** Update the log level at runtime */
+    setLevel(level) {
+        this.level = LOG_LEVELS[level];
+    }
+    /** Inject a custom logger implementation */
+    setCustomLogger(logger) {
+        this.custom = logger;
+    }
+    debug(message, ...args) {
+        if (this.level < LOG_LEVELS.debug)
+            return;
+        if (this.custom) {
+            this.custom.debug(`${this.prefix} ${message}`, ...args);
+            return;
+        }
+        console.debug(`${this.prefix} ${this.timestamp()} [DEBUG] ${message}`, ...args);
+    }
+    info(message, ...args) {
+        if (this.level < LOG_LEVELS.info)
+            return;
+        if (this.custom) {
+            this.custom.info(`${this.prefix} ${message}`, ...args);
+            return;
+        }
+        console.log(`${this.prefix} ${this.timestamp()} [INFO] ${message}`, ...args);
+    }
+    warn(message, ...args) {
+        if (this.level < LOG_LEVELS.warn)
+            return;
+        if (this.custom) {
+            this.custom.warn(`${this.prefix} ${message}`, ...args);
+            return;
+        }
+        console.warn(`${this.prefix} ${this.timestamp()} [WARN] ${message}`, ...args);
+    }
+    error(message, ...args) {
+        if (this.level < LOG_LEVELS.error)
+            return;
+        if (this.custom) {
+            this.custom.error(`${this.prefix} ${message}`, ...args);
+            return;
+        }
+        console.error(`${this.prefix} ${this.timestamp()} [ERROR] ${message}`, ...args);
+    }
+    timestamp() {
+        return new Date().toISOString();
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=Logger.js.map

package/dist/Logger.js.map

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

package/dist/Node.d.ts

@@ -1,12 +1,26 @@
+/** Yukimu v2.0.0 — Lavalink Node Manager */
 import WebSocket from "ws";
 import { Rest } from "./Rest";
 import { WsQueue } from "./WsQueue";
 import { State } from "./Constants";
 import type { Yukimu } from "./Yukimu";
 import type { NodeOptions, NodeStats, NodeInfo, SearchResult } from "./types";
+/**
+ * Represents a connection to a single Lavalink node.
+ *
+ * Critical fixes from v1:
+ * 1. Session resume: waits for `ready` op before calling updateSession()
+ * 2. WsQueue race condition: no duplicate `open` listener, flush called explicitly after onOpen
+ * 3. Heartbeat memory leak: properly clears interval on all disconnect paths
+ * 4. Connection timeout: WebSocket connection has a 10s timeout
+ * 5. Reconnect jitter: prevents thundering herd on multi-node reconnect
+ * 6. playerPath() null-safety for missing sessionId
+ * 7. Uses CLIENT_NAME constant, not hardcoded string
+ * 8. Uses STOPPED_REASONS Set for track end handling
+ */
 export declare class Node {
     readonly manager: Yukimu;
-    readonly options: NodeOptions;
+    readonly options: Required<Pick<NodeOptions, "name" | "host" | "port" | "password">> & NodeOptions;
     readonly rest: Rest;
     readonly wsQueue: WsQueue;
     readonly version: 3 | 4;
@@ -18,10 +32,10 @@ export declare class Node {
     resumed: boolean;
     penalties: number;
     ping: number;
-    private restQueue;
     private reconnectAttempts;
     private reconnectTimeout?;
     private heartbeatInterval?;
+    private connectionTimeout?;
     private lastHeartbeatAt;
     constructor(manager: Yukimu, options: NodeOptions);
     get connected(): boolean;
@@ -40,8 +54,7 @@ export declare class Node {
     private reconnectPlayers;
     private handlePlayerUpdate;
     private handleEvent;
-    send(data: Record<string, unknown>): Promise<void>;
-    enqueueRest<T>(fn: () => Promise<T>): Promise<T>;
+    send(data: Record<string, unknown>, priority?: boolean): Promise<void>;
     loadTracks(identifier: string): Promise<SearchResult>;
     playerPath(guildId: string): string;
 }

package/dist/Node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../src/Node.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAS,YAAY,EAAqB,MAAM,SAAS,CAAC;AAKxG,qBAAa,IAAI;IACf,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,OAAO,EAAE,WAAW,CAAC;IACrC,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAExB,EAAE,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC5B,KAAK,EAAE,KAAK,CAAsB;IAClC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC/B,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChC,OAAO,EAAE,OAAO,CAAS;IACzB,SAAS,EAAE,MAAM,CAAK;IACtB,IAAI,EAAE,MAAM,CAAM;IAEzB,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAgC;IACzD,OAAO,CAAC,iBAAiB,CAAC,CAAiC;IAC3D,OAAO,CAAC,eAAe,CAAK;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAQjD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,KAAK,IAAI,MAAM,CAIlB;IAED,IAAI,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAStC;IAEM,kBAAkB,IAAI,MAAM;IAU5B,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,SAAS,UAAQ,GAAG,IAAI;YAYzB,MAAM;IAqBpB,OAAO,CAAC,SAAS;IA2CjB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,WAAW;IA8DZ,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAM1C,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI3D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAK3C"}
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../src/Node.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAA0D,MAAM,aAAa,CAAC;AAE5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAS,YAAY,EAAE,MAAM,SAAS,CAAC;AAIrF;;;;;;;;;;;;GAYG;AACH,qBAAa,IAAI;IACf,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC,GAAG,WAAW,CAAC;IAC1G,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAExB,EAAE,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC5B,KAAK,EAAE,KAAK,CAAsB;IAClC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC/B,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChC,OAAO,UAAS;IAChB,SAAS,SAAK;IACd,IAAI,SAAM;IAEjB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAgC;IACzD,OAAO,CAAC,iBAAiB,CAAC,CAAiC;IAC3D,OAAO,CAAC,iBAAiB,CAAC,CAAgC;IAC1D,OAAO,CAAC,eAAe,CAAK;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAkBjD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,KAAK,IAAI,MAAM,CAIlB;IAED,IAAI,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAStC;IAIM,kBAAkB,IAAI,MAAM;IAa5B,OAAO,IAAI,IAAI;IAkCf,OAAO,CAAC,SAAS,UAAQ,GAAG,IAAI;YAsCzB,MAAM;IAiCpB,OAAO,CAAC,SAAS;IA8DjB,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,WAAW;IAsFZ,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI3D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAU3C"}