ytgrab 0.1.0

package/dist/utils/index.js

@@ -0,0 +1,403 @@
+"use strict";
+/**
+ * Core utility functions ported from yt_dlp/utils/_utils.py
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegexNotFoundError = exports.UnsupportedError = exports.GeoRestrictedError = exports.DownloadError = exports.ExtractorError = exports.tryGet = exports.traverseObj = void 0;
+exports.intOrNone = intOrNone;
+exports.floatOrNone = floatOrNone;
+exports.strOrNone = strOrNone;
+exports.urlOrNone = urlOrNone;
+exports.boolOrNone = boolOrNone;
+exports.unescapeHTML = unescapeHTML;
+exports.cleanHTML = cleanHTML;
+exports.stripOrNone = stripOrNone;
+exports.sanitizeFilename = sanitizeFilename;
+exports.determineExt = determineExt;
+exports.parseDuration = parseDuration;
+exports.unifiedStrdate = unifiedStrdate;
+exports.unifiedTimestamp = unifiedTimestamp;
+exports.formatBytes = formatBytes;
+exports.parseFilesize = parseFilesize;
+exports.mimetypeToExt = mimetypeToExt;
+exports.jsToJson = jsToJson;
+exports.stripJsonp = stripJsonp;
+exports.getElementByID = getElementByID;
+exports.getElementByClass = getElementByClass;
+exports.extractAttributes = extractAttributes;
+exports.parseCodecs = parseCodecs;
+exports.variadic = variadic;
+exports.filterDict = filterDict;
+exports.mergeDicts = mergeDicts;
+exports.qualities = qualities;
+exports.escapeRegex = escapeRegex;
+exports.orderedSet = orderedSet;
+exports.formatField = formatField;
+exports.removeStart = removeStart;
+exports.removeEnd = removeEnd;
+exports.sleep = sleep;
+var traversal_js_1 = require("./traversal.js");
+Object.defineProperty(exports, "traverseObj", { enumerable: true, get: function () { return traversal_js_1.traverseObj; } });
+Object.defineProperty(exports, "tryGet", { enumerable: true, get: function () { return traversal_js_1.tryGet; } });
+// --- Type coercion helpers ---
+function intOrNone(v, scale = 1, defaultVal = null) {
+    if (v === null || v === undefined || v === '')
+        return defaultVal;
+    try {
+        const num = typeof v === 'number' ? v : parseInt(String(v), 10);
+        if (isNaN(num))
+            return defaultVal;
+        return Math.round(num / scale);
+    }
+    catch {
+        return defaultVal;
+    }
+}
+function floatOrNone(v, scale = 1, defaultVal = null) {
+    if (v === null || v === undefined || v === '')
+        return defaultVal;
+    try {
+        const num = typeof v === 'number' ? v : parseFloat(String(v));
+        if (isNaN(num))
+            return defaultVal;
+        return num / scale;
+    }
+    catch {
+        return defaultVal;
+    }
+}
+function strOrNone(v) {
+    if (v === null || v === undefined)
+        return null;
+    const s = String(v);
+    return s || null;
+}
+function urlOrNone(url) {
+    if (typeof url !== 'string')
+        return null;
+    const trimmed = url.trim();
+    if (!trimmed || trimmed.startsWith('//')) {
+        return trimmed.startsWith('//') ? `https:${trimmed}` : null;
+    }
+    if (/^https?:\/\//.test(trimmed))
+        return trimmed;
+    return null;
+}
+function boolOrNone(v) {
+    if (typeof v === 'boolean')
+        return v;
+    return null;
+}
+// --- String helpers ---
+function unescapeHTML(s) {
+    if (!s)
+        return '';
+    return s
+        .replace(/&/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/g, "'")
+        .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(parseInt(n, 10)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, n) => String.fromCharCode(parseInt(n, 16)));
+}
+function cleanHTML(html) {
+    if (!html)
+        return '';
+    let text = html
+        .replace(/<\s*br\s*\/?>/gi, '\n')
+        .replace(/<\s*\/p\s*>/gi, '\n')
+        .replace(/<[^>]+>/g, '')
+        .trim();
+    return unescapeHTML(text);
+}
+function stripOrNone(v) {
+    if (typeof v !== 'string')
+        return null;
+    const stripped = v.trim();
+    return stripped || null;
+}
+// --- Filename helpers ---
+const FILENAME_UNSAFE_RE = /[<>:"/\\|?*\x00-\x1f]/g;
+const FILENAME_RESTRICTED_RE = /[^\w.\-]/g;
+function sanitizeFilename(s, restricted = false) {
+    let result = s.replace(FILENAME_UNSAFE_RE, '_');
+    if (restricted) {
+        result = result.replace(FILENAME_RESTRICTED_RE, '_');
+    }
+    // Remove leading/trailing dots and spaces
+    result = result.replace(/^[\s.]+|[\s.]+$/g, '');
+    // Collapse multiple underscores
+    result = result.replace(/_+/g, '_');
+    return result || '_';
+}
+function determineExt(url, defaultExt = 'unknown_video') {
+    const parsed = url.split('?')[0].split('#')[0];
+    const lastDot = parsed.lastIndexOf('.');
+    if (lastDot === -1)
+        return defaultExt;
+    const ext = parsed.slice(lastDot + 1).toLowerCase();
+    if (ext.length > 10 || ext.length === 0)
+        return defaultExt;
+    return ext;
+}
+// --- Date/time helpers ---
+function parseDuration(s) {
+    if (typeof s === 'number')
+        return s;
+    if (typeof s !== 'string' || !s.trim())
+        return null;
+    const str = s.trim();
+    // HH:MM:SS or MM:SS or SS
+    const hmsMatch = str.match(/^(?:(\d+):)?(\d{1,2}):(\d{2})(?:\.(\d+))?$/);
+    if (hmsMatch) {
+        const hours = parseInt(hmsMatch[1] || '0', 10);
+        const mins = parseInt(hmsMatch[2], 10);
+        const secs = parseInt(hmsMatch[3], 10);
+        const frac = hmsMatch[4] ? parseFloat(`0.${hmsMatch[4]}`) : 0;
+        return hours * 3600 + mins * 60 + secs + frac;
+    }
+    // ISO 8601 duration PT1H2M3S
+    const isoMatch = str.match(/^P?T?(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?$/i);
+    if (isoMatch && (isoMatch[1] || isoMatch[2] || isoMatch[3])) {
+        const hours = parseInt(isoMatch[1] || '0', 10);
+        const mins = parseInt(isoMatch[2] || '0', 10);
+        const secs = parseFloat(isoMatch[3] || '0');
+        return hours * 3600 + mins * 60 + secs;
+    }
+    // Plain seconds
+    const secMatch = str.match(/^(\d+(?:\.\d+)?)$/);
+    if (secMatch)
+        return parseFloat(secMatch[1]);
+    return null;
+}
+function unifiedStrdate(dateStr) {
+    if (!dateStr)
+        return null;
+    const cleaned = dateStr.replace(/[,\s]+/g, ' ').trim();
+    const d = new Date(cleaned);
+    if (!isNaN(d.getTime())) {
+        const year = d.getUTCFullYear();
+        const month = String(d.getUTCMonth() + 1).padStart(2, '0');
+        const day = String(d.getUTCDate()).padStart(2, '0');
+        return `${year}${month}${day}`;
+    }
+    return null;
+}
+function unifiedTimestamp(dateStr) {
+    if (!dateStr)
+        return null;
+    const cleaned = dateStr.replace(/[,\s]+/g, ' ').trim();
+    const d = new Date(cleaned);
+    if (!isNaN(d.getTime())) {
+        return Math.floor(d.getTime() / 1000);
+    }
+    return null;
+}
+// --- Size formatting ---
+const SIZE_UNITS = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'];
+function formatBytes(bytes) {
+    if (bytes === null || bytes === undefined || isNaN(bytes))
+        return 'N/A';
+    let size = bytes;
+    let unitIdx = 0;
+    while (size >= 1024 && unitIdx < SIZE_UNITS.length - 1) {
+        size /= 1024;
+        unitIdx++;
+    }
+    return `${size.toFixed(2)} ${SIZE_UNITS[unitIdx]}`;
+}
+function parseFilesize(s) {
+    if (!s)
+        return null;
+    const match = s.trim().match(/^(\d+(?:\.\d+)?)\s*(B|KB|KiB|MB|MiB|GB|GiB|TB|TiB)?$/i);
+    if (!match)
+        return null;
+    const num = parseFloat(match[1]);
+    const unit = (match[2] || 'B').toUpperCase();
+    const multipliers = {
+        'B': 1, 'KB': 1000, 'KIB': 1024,
+        'MB': 1e6, 'MIB': 1024 ** 2,
+        'GB': 1e9, 'GIB': 1024 ** 3,
+        'TB': 1e12, 'TIB': 1024 ** 4,
+    };
+    return Math.round(num * (multipliers[unit] || 1));
+}
+// --- MIME type helpers ---
+const MIME_TO_EXT = {
+    'video/mp4': 'mp4', 'video/webm': 'webm', 'video/x-flv': 'flv',
+    'video/3gpp': '3gp', 'video/x-matroska': 'mkv', 'video/quicktime': 'mov',
+    'video/x-msvideo': 'avi', 'video/x-ms-wmv': 'wmv',
+    'audio/mp4': 'm4a', 'audio/mpeg': 'mp3', 'audio/webm': 'weba',
+    'audio/ogg': 'ogg', 'audio/opus': 'opus', 'audio/flac': 'flac',
+    'audio/wav': 'wav', 'audio/x-wav': 'wav', 'audio/aac': 'aac',
+    'text/vtt': 'vtt', 'application/x-mpegURL': 'm3u8',
+    'application/dash+xml': 'mpd', 'text/xml': 'xml',
+    'application/ttml+xml': 'ttml',
+};
+function mimetypeToExt(mt) {
+    if (!mt)
+        return null;
+    const base = mt.split(';')[0].trim().toLowerCase();
+    return MIME_TO_EXT[base] || null;
+}
+// --- JSON helpers ---
+function jsToJson(code) {
+    // Convert JavaScript object notation to valid JSON
+    let result = code;
+    // Remove single-line comments
+    result = result.replace(/\/\/[^\n]*/g, '');
+    // Remove multi-line comments
+    result = result.replace(/\/\*[\s\S]*?\*\//g, '');
+    // Replace single quotes with double quotes (basic — doesn't handle escaped quotes in all cases)
+    result = result.replace(/'([^'\\]*(?:\\.[^'\\]*)*)'/g, '"$1"');
+    // Add quotes to unquoted keys
+    result = result.replace(/(\{|,)\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\s*:/g, '$1"$2":');
+    // Remove trailing commas
+    result = result.replace(/,\s*([\]}])/g, '$1');
+    return result;
+}
+function stripJsonp(code) {
+    return code.replace(/^[a-zA-Z_$][a-zA-Z0-9_$]*\s*\(\s*/, '').replace(/\s*\)\s*;?\s*$/, '');
+}
+// --- HTML extraction helpers ---
+function getElementByID(id, html) {
+    const re = new RegExp(`<[^>]+\\bid\\s*=\\s*["']${escapeRegex(id)}["'][^>]*>([\\s\\S]*?)</`, 'i');
+    const match = html.match(re);
+    return match ? match[1] : null;
+}
+function getElementByClass(className, html) {
+    const re = new RegExp(`<[^>]+\\bclass\\s*=\\s*["'][^"']*\\b${escapeRegex(className)}\\b[^"']*["'][^>]*>([\\s\\S]*?)</`, 'i');
+    const match = html.match(re);
+    return match ? match[1] : null;
+}
+function extractAttributes(tag) {
+    const attrs = {};
+    const re = /\b([a-zA-Z_:][a-zA-Z0-9_:.-]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|(\S+))/g;
+    let match;
+    while ((match = re.exec(tag)) !== null) {
+        attrs[match[1]] = unescapeHTML(match[2] ?? match[3] ?? match[4]);
+    }
+    return attrs;
+}
+// --- Codec parsing ---
+function parseCodecs(codecsStr) {
+    if (!codecsStr)
+        return {};
+    const codecs = codecsStr.split(',').map(c => c.trim());
+    const result = {};
+    for (const codec of codecs) {
+        if (/^(avc|hev|hvc|vp[089]|av01|theora)/i.test(codec)) {
+            result.vcodec = codec;
+        }
+        else if (/^(mp4a|opus|vorb|flac|ac-3|ec-3|dtse|mp3|aac)/i.test(codec)) {
+            result.acodec = codec;
+        }
+    }
+    return result;
+}
+// --- Miscellaneous ---
+function variadic(x) {
+    return Array.isArray(x) ? x : [x];
+}
+function filterDict(dct, condition = (_, v) => v !== null && v !== undefined) {
+    const result = {};
+    for (const [key, val] of Object.entries(dct)) {
+        if (condition(key, val))
+            result[key] = val;
+    }
+    return result;
+}
+function mergeDicts(...dicts) {
+    const result = {};
+    for (const d of dicts) {
+        for (const [key, val] of Object.entries(d)) {
+            if (val !== null && val !== undefined && !(key in result && result[key] !== null && result[key] !== undefined)) {
+                result[key] = val;
+            }
+        }
+    }
+    return result;
+}
+function qualities(qualityIds) {
+    return (id) => {
+        const idx = qualityIds.indexOf(id);
+        return idx;
+    };
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function orderedSet(iterable) {
+    const seen = new Set();
+    const result = [];
+    for (const item of iterable) {
+        if (!seen.has(item)) {
+            seen.add(item);
+            result.push(item);
+        }
+    }
+    return result;
+}
+function formatField(obj, field, template = '%s', defaultVal = '') {
+    let val;
+    if (field) {
+        val = typeof obj === 'object' && obj !== null ? obj[field] : undefined;
+    }
+    else {
+        val = obj;
+    }
+    if (val === null || val === undefined || val === '')
+        return defaultVal;
+    return template.replace('%s', String(val));
+}
+function removeStart(s, start) {
+    return s.startsWith(start) ? s.slice(start.length) : s;
+}
+function removeEnd(s, end) {
+    return s.endsWith(end) ? s.slice(0, -end.length) : s;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+class ExtractorError extends Error {
+    cause_;
+    video_id;
+    constructor(message, cause_, video_id) {
+        super(message);
+        this.cause_ = cause_;
+        this.video_id = video_id;
+        this.name = 'ExtractorError';
+    }
+}
+exports.ExtractorError = ExtractorError;
+class DownloadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DownloadError';
+    }
+}
+exports.DownloadError = DownloadError;
+class GeoRestrictedError extends ExtractorError {
+    constructor(message = 'This content is not available in your region') {
+        super(message);
+        this.name = 'GeoRestrictedError';
+    }
+}
+exports.GeoRestrictedError = GeoRestrictedError;
+class UnsupportedError extends ExtractorError {
+    constructor(url) {
+        super(`Unsupported URL: ${url}`);
+        this.name = 'UnsupportedError';
+    }
+}
+exports.UnsupportedError = UnsupportedError;
+class RegexNotFoundError extends ExtractorError {
+    constructor(name) {
+        super(`Unable to extract ${name}`);
+        this.name = 'RegexNotFoundError';
+    }
+}
+exports.RegexNotFoundError = RegexNotFoundError;
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/traversal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Ported from yt_dlp/utils/traversal.py
+ * Safe nested data traversal with multiple path support.
+ */
+/**
+ * Safely traverse nested objects/arrays following the given paths.
+ *
+ * @param obj - The object to traverse
+ * @param paths - One or more path arrays. Each path is an array of keys/indices.
+ * @param options - default value, expected_type, get_all flag
+ *
+ * Usage:
+ *   traverseObj(data, ['video', 0, 'url'])
+ *   traverseObj(data, ['video', 'title'], ['name'], { default: 'Unknown' })
+ */
+export declare function traverseObj(obj: unknown, ...args: unknown[]): unknown;
+/**
+ * Safe getter — tries a function and returns default on error.
+ * Port of try_get from yt_dlp.
+ */
+export declare function tryGet<T>(src: unknown, getter: ((v: unknown) => T) | ((v: unknown) => T)[], expectedType?: (v: unknown) => boolean): T | undefined;
+//# sourceMappingURL=traversal.d.ts.map

package/dist/utils/traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../../src/utils/traversal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAyBT;AA4CD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,EAAE,EACnD,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GACrC,CAAC,GAAG,SAAS,CAaf"}

package/dist/utils/traversal.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Ported from yt_dlp/utils/traversal.py
+ * Safe nested data traversal with multiple path support.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traverseObj = traverseObj;
+exports.tryGet = tryGet;
+const NO_DEFAULT = Symbol('NO_DEFAULT');
+/**
+ * Safely traverse nested objects/arrays following the given paths.
+ *
+ * @param obj - The object to traverse
+ * @param paths - One or more path arrays. Each path is an array of keys/indices.
+ * @param options - default value, expected_type, get_all flag
+ *
+ * Usage:
+ *   traverseObj(data, ['video', 0, 'url'])
+ *   traverseObj(data, ['video', 'title'], ['name'], { default: 'Unknown' })
+ */
+function traverseObj(obj, ...args) {
+    let options = {};
+    let paths = [];
+    for (const arg of args) {
+        if (Array.isArray(arg)) {
+            paths.push(arg);
+        }
+        else if (typeof arg === 'object' && arg !== null && !Array.isArray(arg)) {
+            options = arg;
+        }
+    }
+    if (paths.length === 0)
+        return options.default;
+    const { default: defaultVal, expected_type, get_all = true } = options;
+    for (const path of paths) {
+        const result = traversePath(obj, path, get_all);
+        if (result !== undefined && result !== null) {
+            if (expected_type && !expected_type(result))
+                continue;
+            return result;
+        }
+    }
+    return defaultVal;
+}
+function traversePath(obj, path, getAll) {
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof key === 'string' || typeof key === 'number') {
+            if (Array.isArray(current)) {
+                if (typeof key === 'number') {
+                    current = current[key < 0 ? current.length + key : key];
+                }
+                else {
+                    // Try to get from array of objects
+                    const results = current
+                        .map(item => (item && typeof item === 'object' ? item[key] : undefined))
+                        .filter(v => v !== undefined);
+                    current = getAll ? results : results[0];
+                }
+            }
+            else if (typeof current === 'object') {
+                current = current[String(key)];
+            }
+            else {
+                return undefined;
+            }
+        }
+        else if (typeof key === 'function') {
+            if (Array.isArray(current)) {
+                const results = current.filter(key);
+                current = getAll ? results : results[0];
+            }
+            else {
+                current = key(current) ? current : undefined;
+            }
+        }
+        else if (key === null || key === undefined) {
+            // Ellipsis equivalent — get all values
+            if (Array.isArray(current)) {
+                // current stays as array
+            }
+            else if (typeof current === 'object') {
+                current = Object.values(current);
+            }
+        }
+    }
+    return current;
+}
+/**
+ * Safe getter — tries a function and returns default on error.
+ * Port of try_get from yt_dlp.
+ */
+function tryGet(src, getter, expectedType) {
+    const getters = Array.isArray(getter) ? getter : [getter];
+    for (const fn of getters) {
+        try {
+            const result = fn(src);
+            if (result === undefined || result === null)
+                continue;
+            if (expectedType && !expectedType(result))
+                continue;
+            return result;
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=traversal.js.map

package/dist/utils/traversal.js.map

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

package/dist/ytgrab.d.ts

@@ -0,0 +1,48 @@
+/**
+ * YtGrab - Main orchestrator class
+ * Ported from yt_dlp/YoutubeDL.py
+ *
+ * Coordinates extractors, downloaders, and post-processors.
+ */
+import type { InfoDict, VideoFormat, YtGrabOptions, Subtitle } from './types.js';
+export declare class YtGrab {
+    readonly params: YtGrabOptions;
+    private _extractors;
+    private _postProcessors;
+    private _progressHooks;
+    constructor(options?: YtGrabOptions);
+    private _setupPostProcessors;
+    /**
+     * Extract info from a URL without downloading.
+     */
+    getInfo(url: string): Promise<InfoDict>;
+    /**
+     * Extract info and download.
+     */
+    download(urls: string | string[]): Promise<InfoDict[]>;
+    /**
+     * List available formats for a URL.
+     */
+    listFormats(url: string): Promise<VideoFormat[]>;
+    /**
+     * List available subtitles for a URL.
+     */
+    listSubtitles(url: string): Promise<{
+        subtitles: Record<string, Subtitle[]>;
+        automatic_captions: Record<string, Subtitle[]>;
+    }>;
+    extractInfo(url: string, download?: boolean): Promise<InfoDict>;
+    processInfo(info: InfoDict): Promise<void>;
+    private _selectFormat;
+    private _prepareFilename;
+    private _downloadSubtitles;
+    private _downloadThumbnail;
+    private _writeInfoJson;
+    private _printFormats;
+    private _printSubtitles;
+    private _findExtractor;
+    toScreen(msg: string): void;
+    reportWarning(msg: string): void;
+    reportError(msg: string): void;
+}
+//# sourceMappingURL=ytgrab.d.ts.map

package/dist/ytgrab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ytgrab.d.ts","sourceRoot":"","sources":["../src/ytgrab.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,OAAO,KAAK,EACV,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAgB,QAAQ,EAC7D,MAAM,YAAY,CAAC;AAEpB,qBAAa,MAAM;IACjB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,cAAc,CAAsB;gBAEhC,OAAO,GAAE,aAAkB;IA6BvC,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI7C;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwB5D;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKtD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;KAChD,CAAC;IAUI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBrE,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwFhD,OAAO,CAAC,aAAa;IAqDrB,OAAO,CAAC,gBAAgB;YA8BV,kBAAkB;YAqElB,kBAAkB;YAmBlB,cAAc;IAS5B,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,cAAc;IAStB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK3B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIhC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG/B"}