@qodalis/mcp-cli 0.0.0-stage → 0.2.0

package/dist/src/dev/api.js

@@ -0,0 +1,425 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+/**
+ * `qcli_api`: TypeScript declarations of the published `@qodalis/*` packages, read from
+ * the project's node_modules when installed there, otherwise from the npm registry
+ * (`latest`) through a CDN, cached in memory and in a temp directory.
+ */
+export const DEFAULT_API_PACKAGE = '@qodalis/cli-core';
+const FETCH_TIMEOUT_MS = 15_000;
+/** Most `.d.ts` files followed through relative re-exports of one package. */
+const MAX_FILES = 400;
+/** `cli-core`, `@qodalis/cli-core` → `@qodalis/cli-core`; anything outside @qodalis is refused. */
+export const normalizePackageName = (input) => {
+    const name = (input ?? '').trim() || DEFAULT_API_PACKAGE;
+    const full = name.startsWith('@') ? name : `@qodalis/${name}`;
+    if (!/^@qodalis\/[a-z0-9][a-z0-9._-]*$/.test(full)) {
+        throw new Error(`"${input}" is not a @qodalis package name (e.g. @qodalis/cli-core, @qodalis/cli).`);
+    }
+    return full;
+};
+const KEYWORDS = 'interface|type|class|function|enum|const|let|var|namespace|module';
+const DECLARATION = new RegExp(`^(?:export\\s+)?(?:default\\s+)?(?:declare\\s+)?(?:abstract\\s+)?(?:const\\s+(?=enum))?(${KEYWORDS})\\s+([A-Za-z_$][\\w$]*)`);
+const BLOCK_KINDS = new Set(['interface', 'class', 'enum', 'namespace', 'module']);
+/**
+ * `source` with comments, strings and template literals replaced by spaces (newlines
+ * kept), so offsets match the original and braces in JSDoc or string types do not count.
+ */
+export const blankNonCode = (source) => {
+    const out = source.split('');
+    const blank = (from, to) => {
+        for (let k = from; k < to && k < out.length; k++) {
+            if (out[k] !== '\n') {
+                out[k] = ' ';
+            }
+        }
+    };
+    for (let i = 0; i < source.length; i++) {
+        const ch = source[i];
+        const next = source[i + 1];
+        if (ch === '/' && next === '/') {
+            const eol = source.indexOf('\n', i);
+            const end = eol === -1 ? source.length : eol;
+            blank(i, end);
+            i = end - 1;
+        }
+        else if (ch === '/' && next === '*') {
+            const close = source.indexOf('*/', i + 2);
+            const end = close === -1 ? source.length : close + 2;
+            blank(i, end);
+            i = end - 1;
+        }
+        else if (ch === '"' || ch === "'" || ch === '`') {
+            let j = i + 1;
+            for (; j < source.length && source[j] !== ch; j++) {
+                if (source[j] === '\\') {
+                    j++;
+                }
+            }
+            blank(i + 1, j);
+            i = j;
+        }
+    }
+    return out.join('');
+};
+/**
+ * End offset of the declaration starting at `start` in comment-free `code`: a block
+ * declaration ends at the `}` that closes its body, anything else at the first `;`
+ * outside brackets (or at the end of a balanced line followed by a new statement).
+ */
+const declarationEnd = (code, start, block) => {
+    let depth = 0;
+    let opened = false;
+    for (let i = start; i < code.length; i++) {
+        const ch = code[i];
+        const arrow = code[i - 1] === '=';
+        if (ch === '{' || ch === '(' || ch === '[' || (ch === '<' && !arrow)) {
+            depth++;
+            opened ||= ch === '{';
+        }
+        else if (ch === '}' || ch === ')' || ch === ']' || (ch === '>' && !arrow)) {
+            depth = Math.max(0, depth - 1);
+            if (block && opened && depth === 0 && ch === '}') {
+                return i + 1;
+            }
+        }
+        else if (depth === 0 && ch === ';') {
+            return i + 1;
+        }
+        else if (depth === 0 && !block && ch === '\n') {
+            const rest = code.slice(i + 1, i + 200).trimStart();
+            if (rest === '' || /^(export|declare|interface|type|import|abstract)\b/.test(rest)) {
+                return i;
+            }
+        }
+    }
+    return code.length;
+};
+/** Start of the JSDoc block directly above `start` (at most one line break between), else `start`. */
+const leadingDoc = (source, start) => {
+    const before = source.slice(0, start).trimEnd();
+    if (!before.endsWith('*/')) {
+        return start;
+    }
+    const open = before.lastIndexOf('/**');
+    if (open === -1 || before.slice(open + 3, -2).includes('*/')) {
+        return start;
+    }
+    const gap = source.slice(before.length, start);
+    return gap.split('\n').length <= 2 ? open : start;
+};
+/** Top-level declarations in `source`: kind, name and start offset. */
+const topLevel = (source) => {
+    const code = blankNonCode(source);
+    const found = [];
+    let depth = 0;
+    let offset = 0;
+    for (const line of code.split('\n')) {
+        if (depth === 0) {
+            const trimmed = line.trimStart();
+            const match = DECLARATION.exec(trimmed);
+            if (match) {
+                found.push({
+                    kind: match[1],
+                    name: match[2],
+                    start: offset + line.length - trimmed.length,
+                });
+            }
+        }
+        for (const ch of line) {
+            depth += ch === '{' ? 1 : ch === '}' ? -1 : 0;
+        }
+        depth = Math.max(0, depth);
+        offset += line.length + 1;
+    }
+    return found;
+};
+/** Every top-level declaration of `symbol` in `source` (overloads and merged interfaces included). */
+export const extractDeclarations = (source, symbol) => {
+    const code = blankNonCode(source);
+    return topLevel(source)
+        .filter((d) => d.name === symbol)
+        .map((d) => source
+        .slice(leadingDoc(source, d.start), declarationEnd(code, d.start, BLOCK_KINDS.has(d.kind)))
+        .trim());
+};
+/** Names of every top-level declaration in the files. */
+export const declaredNames = (sources) => new Set(sources.flatMap((source) => topLevel(source).map((d) => d.name)));
+/** `export { Local as Symbol }` aliases: the local name a public symbol is declared under. */
+export const aliasOf = (sources, symbol) => {
+    for (const source of sources) {
+        for (const list of source.matchAll(/export\s*(?:type\s*)?\{([^}]*)\}/g)) {
+            for (const entry of list[1].split(',')) {
+                const m = /^\s*(?:type\s+)?([\w$]+)\s+as\s+([\w$]+)\s*$/.exec(entry);
+                if (m && m[2] === symbol && m[1] !== symbol) {
+                    return m[1];
+                }
+            }
+        }
+    }
+    return undefined;
+};
+/** Relative module specifiers a .d.ts imports or re-exports from. */
+const relativeSpecifiers = (source) => [...source.matchAll(/(?:from|import)\s*\(?\s*['"](\.{1,2}\/[^'"]+)['"]/g)].map((m) => m[1]);
+/** Finds `symbol` in the package's declaration files. */
+export const lookupSymbol = (types, symbol) => {
+    const sources = [...types.files.values()];
+    const find = (name) => [...types.files].flatMap(([file, content]) => extractDeclarations(content, name).map((text) => ({ file, text })));
+    let declarations = find(symbol);
+    if (declarations.length === 0) {
+        const local = aliasOf(sources, symbol);
+        if (local) {
+            declarations = find(local);
+        }
+    }
+    const names = declaredNames(sources);
+    const related = new Set();
+    for (const { text } of declarations) {
+        for (const word of text.match(/\b[A-Za-z_$][\w$]*\b/g) ?? []) {
+            if (word !== symbol && names.has(word)) {
+                related.add(word);
+            }
+        }
+    }
+    const lower = symbol.toLowerCase();
+    const suggestions = declarations.length > 0
+        ? []
+        : [...names]
+            .filter((n) => {
+            const candidate = n.toLowerCase();
+            return (candidate.includes(lower) ||
+                (candidate.length > 3 && lower.includes(candidate)));
+        })
+            .sort((a, b) => a.length - b.length || a.localeCompare(b))
+            .slice(0, 15);
+    return { declarations, related: [...related].sort(), suggestions, types };
+};
+/** The declaration entry of a package.json: `types`, `typings`, `exports["."].types`. */
+export const typesEntry = (pkg) => {
+    const dot = pkg.exports?.['.'];
+    const fromExports = dot && typeof dot === 'object'
+        ? dot['types']
+        : undefined;
+    return (pkg.types ?? pkg.typings ?? fromExports ?? 'index.d.ts').replace(/^\.\//, '');
+};
+/** `x.js` / `x` / `x/` → candidate declaration paths. */
+const declarationCandidates = (specifier) => {
+    const base = specifier.replace(/\.(m|c)?js$/, '');
+    return [`${base}.d.ts`, `${base}.d.mts`, `${base}/index.d.ts`, specifier];
+};
+/**
+ * Loads the entry file and every .d.ts reachable through relative imports/re-exports
+ * with `read` (returns undefined for a missing file).
+ */
+export const collectTypeFiles = async (entry, read) => {
+    const files = new Map();
+    const tried = new Set();
+    const queue = [[entry]];
+    while (queue.length > 0 && files.size < MAX_FILES) {
+        const candidates = queue.shift().filter((c) => !tried.has(c));
+        candidates.forEach((c) => tried.add(c));
+        for (const candidate of candidates) {
+            const content = await read(candidate);
+            if (content === undefined) {
+                continue;
+            }
+            files.set(candidate, content);
+            for (const specifier of relativeSpecifiers(content)) {
+                queue.push(declarationCandidates(path.posix.normalize(path.posix.join(path.posix.dirname(candidate), specifier))));
+            }
+            break;
+        }
+    }
+    return files;
+};
+/** `<dir>/node_modules/<pkg>` for `dir` and each of its parents. */
+export const findInstalledPackage = (cwd, name) => {
+    let dir = path.resolve(cwd);
+    for (;;) {
+        const candidate = path.join(dir, 'node_modules', ...name.split('/'));
+        if (existsSync(path.join(candidate, 'package.json'))) {
+            return candidate;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+};
+const readLocal = (root) => async (relative) => {
+    const full = path.join(root, relative);
+    if (!full.startsWith(root) || !full.match(/\.d\.(m|c)?ts$/)) {
+        return undefined;
+    }
+    try {
+        return readFileSync(full, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+};
+const DEFAULT_CDNS = ['https://cdn.jsdelivr.net/npm', 'https://unpkg.com'];
+/**
+ * Resolves a package's declaration files: (1) the project's node_modules, (2) an
+ * in-memory copy, (3) the registry's `latest` version from the temp-dir cache or a CDN,
+ * (4) without network, the newest version in the temp-dir cache.
+ */
+export class ApiSource {
+    options;
+    memory = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    get(name) {
+        const local = findInstalledPackage(this.options.cwd ?? process.cwd(), name);
+        if (local) {
+            return this.fromDirectory(name, local);
+        }
+        let pending = this.memory.get(name);
+        if (!pending) {
+            pending = this.download(name);
+            this.memory.set(name, pending);
+            pending.catch(() => this.memory.delete(name));
+        }
+        return pending;
+    }
+    async fromDirectory(name, root) {
+        const pkg = JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8'));
+        const files = await collectTypeFiles(typesEntry(pkg), readLocal(root));
+        if (files.size === 0) {
+            throw new Error(`${name} in ${root} has no declaration files.`);
+        }
+        return {
+            files,
+            package: name,
+            source: `node_modules (${root})`,
+            version: pkg.version ?? '?',
+        };
+    }
+    get cacheDir() {
+        return this.options.cacheDir === null
+            ? undefined
+            : (this.options.cacheDir ?? path.join(tmpdir(), 'qodalis-mcp-cli'));
+    }
+    async fetchText(url) {
+        const response = await (this.options.fetch ?? fetch)(url, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        if (response.status === 404) {
+            return undefined;
+        }
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status} from ${url}`);
+        }
+        return response.text();
+    }
+    async download(name) {
+        const registry = this.options.registryUrl ?? 'https://registry.npmjs.org';
+        let manifest;
+        try {
+            const text = await this.fetchText(`${registry}/${name}/latest`);
+            if (text === undefined) {
+                throw new Error(`${name} is not published on npm.`);
+            }
+            manifest = JSON.parse(text);
+        }
+        catch (error) {
+            const cached = this.newestCached(name);
+            if (cached) {
+                this.options.log?.(`api: registry unavailable (${error.message}); using cached ${name}@${cached.version}`);
+                return cached;
+            }
+            throw error;
+        }
+        const version = manifest.version ?? 'latest';
+        const fromCache = this.readCache(name, version);
+        if (fromCache) {
+            return fromCache;
+        }
+        const entry = typesEntry(manifest);
+        let lastError;
+        for (const cdn of this.options.cdns ?? DEFAULT_CDNS) {
+            try {
+                const base = `${cdn}/${name}@${version}`;
+                const files = await collectTypeFiles(entry, async (file) => /\.d\.(m|c)?ts$/.test(file) ? this.fetchText(`${base}/${file}`) : undefined);
+                if (files.size === 0) {
+                    throw new Error(`no declaration file at ${base}/${entry}`);
+                }
+                const types = { files, package: name, source: base, version };
+                this.writeCache(types);
+                return types;
+            }
+            catch (error) {
+                lastError = error;
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error(String(lastError));
+    }
+    cacheFile(name, version) {
+        const dir = this.cacheDir;
+        return dir ? path.join(dir, `${name.replace('/', '__')}@${version}.json`) : undefined;
+    }
+    readCache(name, version) {
+        const file = this.cacheFile(name, version);
+        try {
+            if (!file || !existsSync(file)) {
+                return undefined;
+            }
+            const data = JSON.parse(readFileSync(file, 'utf8'));
+            return {
+                files: new Map(Object.entries(data)),
+                package: name,
+                source: `cache (${file})`,
+                version,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    writeCache(types) {
+        const file = this.cacheFile(types.package, types.version);
+        if (!file) {
+            return;
+        }
+        try {
+            mkdirSync(path.dirname(file), { recursive: true });
+            writeFileSync(file, JSON.stringify(Object.fromEntries(types.files)));
+        }
+        catch (error) {
+            this.options.log?.(`api: could not cache declarations (${error.message})`);
+        }
+    }
+    newestCached(name) {
+        const dir = this.cacheDir;
+        if (!dir || !existsSync(dir)) {
+            return undefined;
+        }
+        const prefix = `${name.replace('/', '__')}@`;
+        const versions = readdirSync(dir)
+            .filter((f) => f.startsWith(prefix) && f.endsWith('.json'))
+            .map((f) => f.slice(prefix.length, -'.json'.length))
+            .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
+        const newest = versions.at(-1);
+        return newest ? this.readCache(name, newest) : undefined;
+    }
+}
+/** Markdown answer for `qcli_api`. */
+export const formatLookup = (symbol, lookup) => {
+    const { types } = lookup;
+    const origin = `${types.package}@${types.version} from ${types.source}`;
+    if (lookup.declarations.length === 0) {
+        const hint = lookup.suggestions.length
+            ? `Similar names: ${lookup.suggestions.join(', ')}.`
+            : 'Search the docs with qcli_docs_search, or try package "@qodalis/cli".';
+        return `No declaration named "${symbol}" in ${origin}. ${hint}`;
+    }
+    const blocks = lookup.declarations.map((d) => `\`\`\`ts\n// ${d.file}\n${d.text}\n\`\`\``);
+    const related = lookup.related.length
+        ? `\n\nRelated declarations (look up with qcli_api): ${lookup.related.join(', ')}`
+        : '';
+    return `# ${symbol}\n\n${origin}\n\n${blocks.join('\n\n')}${related}`;
+};
+//# sourceMappingURL=api.js.map

package/dist/src/dev/api.js.map

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

package/dist/src/dev/docs.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The plugin-development guide (`llms-full.txt`): plain markdown with a
+ * `# Qodalis CLI plugin development` title, `## ` sections and `### ` topics,
+ * each topic self-contained and starting with a one-line summary.
+ */
+export declare const DOCS_TITLE = "# Qodalis CLI plugin development";
+/** How long fetched docs are reused before they are fetched again. */
+export declare const DOCS_TTL_MS: number;
+/** After a failed download the URL is tried again after this long. */
+export declare const DOCS_RETRY_MS: number;
+export type DocTopic = {
+    /** Full markdown, heading included */
+    content: string;
+    section: string;
+    /** First prose line after the heading */
+    summary: string;
+    title: string;
+    /** `<section-slug>/<topic-slug>`, unique within the document */
+    uri: string;
+};
+export type DocSection = {
+    /** Full markdown of the section, topics included */
+    content: string;
+    slug: string;
+    title: string;
+    topics: DocTopic[];
+};
+export type Docs = {
+    sections: DocSection[];
+    /** Where the text came from, e.g. the URL or `bundled snapshot` */
+    source: string;
+    topics: DocTopic[];
+};
+export declare const slugify: (text: string) => string;
+/** Splits the guide into `## ` sections and `### ` topics; headings inside code fences are ignored. */
+export declare const parseDocs: (markdown: string, source?: string) => Docs;
+/** Lower-case search terms; `ICliModule`, `read-line` and `readLine` all stay searchable. */
+export declare const searchTerms: (query: string) => string[];
+export type SearchHit = {
+    excerpt: string;
+    score: number;
+    topic: DocTopic;
+};
+/**
+ * Keyword ranking over topics: a term in the title weighs most, then the summary and
+ * the section name, then occurrences in the body (capped); every matched term and an
+ * exact phrase match add a bonus, so topics covering the whole query come first.
+ */
+export declare const searchDocs: (docs: Docs, query: string, limit?: number) => SearchHit[];
+export type ReadResult = {
+    kind: 'section';
+    section: DocSection;
+} | {
+    kind: 'topics';
+    topics: DocTopic[];
+} | {
+    kind: 'not-found';
+};
+/**
+ * A topic by heading (case-insensitive), `Section › Topic`, `Section/Topic` or its
+ * resource path; a whole `## ` section by its heading; else a unique partial match.
+ */
+export declare const readDocs: (docs: Docs, query: string) => ReadResult;
+/** `Section › Topic` lines, grouped by section, for "not found" answers. */
+export declare const listTopics: (docs: Docs) => string;
+/** The `docs/llms-full.txt` bundled with the package (one or two levels above this file). */
+export declare const readBundledDocs: () => string;
+export type DocsSourceOptions = {
+    /** Overrides the HTTP client (tests) */
+    fetch?: typeof fetch;
+    log?: (message: string) => void;
+    now?: () => number;
+    /** Overrides the bundled snapshot (tests) */
+    snapshot?: () => string;
+    ttlMs?: number;
+    url: string;
+};
+/**
+ * The guide from `url` (cached for {@link DOCS_TTL_MS}), falling back to the last good
+ * download and then to the bundled snapshot, so the tools work offline and before the
+ * site publishes the file. A response that is not the guide (an HTML page) is ignored.
+ */
+export declare class DocsSource {
+    private readonly options;
+    private cached;
+    private downloaded;
+    private loading;
+    private snapshotDocs;
+    constructor(options: DocsSourceOptions);
+    get(): Promise<Docs>;
+    private load;
+}
+//# sourceMappingURL=docs.d.ts.map

package/dist/src/dev/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/dev/docs.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,UAAU,qCAAqC,CAAC;AAC7D,sEAAsE;AACtE,eAAO,MAAM,WAAW,QAAc,CAAC;AACvC,sEAAsE;AACtE,eAAO,MAAM,aAAa,QAAa,CAAC;AAGxC,MAAM,MAAM,QAAQ,GAAG;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACf,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,EAAE,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MAKO,CAAC;AAqB/C,uGAAuG;AACvG,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,eAAiB,KAAG,IA2D/D,CAAC;AAQF,6FAA6F;AAC7F,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAAM,EAQjD,CAAC;AAcF,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAkB5E;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,EAAE,OAAO,MAAM,EAAE,cAAS,KAAG,SAAS,EAmC1E,CAAC;AAKF,MAAM,MAAM,UAAU,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,EAAE,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,OAAO,MAAM,KAAG,UAkCpD,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,MAMnB,CAAC;AAEtB,6FAA6F;AAC7F,eAAO,MAAM,eAAe,QAAO,MASlC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,qBAAa,UAAU;IAMP,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,YAAY,CAAmB;gBAEV,OAAO,EAAE,iBAAiB;IAEjD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YASZ,IAAI;CAoCrB"}