@contiva/sapbtp-docs-mcp 1.0.1

package/build/indexing/topic-index.js

@@ -0,0 +1,181 @@
+import { readFile } from 'fs/promises';
+import { dirname, resolve } from 'path';
+import { resolveDocsPath, getIndexPath } from '../utils/paths.js';
+/**
+ * Topic Index - parses index.md files to build hierarchical topic structure
+ */
+export class TopicIndex {
+    hierarchies = new Map();
+    docsPath;
+    constructor(docsPath) {
+        this.docsPath = docsPath || resolveDocsPath();
+    }
+    /**
+     * Builds the topic index by parsing index.md files
+     */
+    async build() {
+        console.error('Building topic index...');
+        const startTime = Date.now();
+        const areas = ['ISuite', 'apim'];
+        for (const area of areas) {
+            try {
+                const hierarchy = await this.parseIndexFile(area);
+                this.hierarchies.set(area, hierarchy);
+            }
+            catch (error) {
+                console.error(`Warning: Could not parse index for ${area}:`, error);
+            }
+        }
+        const elapsed = Date.now() - startTime;
+        console.error(`Topic index built in ${elapsed}ms`);
+    }
+    /**
+     * Parses an index.md file to extract topic hierarchy
+     */
+    async parseIndexFile(area) {
+        const indexPath = getIndexPath(area, this.docsPath);
+        const content = await readFile(indexPath, 'utf-8');
+        const topics = this.parseTopicsFromContent(content, indexPath);
+        return {
+            area,
+            topics,
+            totalTopics: this.countTopics(topics),
+        };
+    }
+    /**
+     * Parses topics from index.md content
+     * Expects format like:
+     * - [Topic Title](path/to/file.md)
+     *   - [Subtopic](path/to/subtopic.md)
+     */
+    parseTopicsFromContent(content, indexPath) {
+        const lines = content.split('\n');
+        const topics = [];
+        const stack = [];
+        const indexDir = dirname(indexPath);
+        for (const line of lines) {
+            // Match list items: - [Title](path.md) or   - [Title](path.md)
+            const match = line.match(/^(\s*)-\s*\[([^\]]+)\]\(([^)]+)\)/);
+            if (!match) {
+                continue;
+            }
+            const indent = match[1].length;
+            const title = match[2].trim();
+            const href = match[3];
+            // Skip external links
+            if (href.startsWith('http://') || href.startsWith('https://')) {
+                continue;
+            }
+            // Resolve relative path
+            const [pathPart] = href.split('#');
+            const absolutePath = resolve(indexDir, pathPart);
+            const level = Math.floor(indent / 2); // Assuming 2 spaces per level
+            const topic = {
+                title,
+                path: absolutePath,
+                level,
+                children: [],
+            };
+            // Pop stack until we find the correct parent level
+            while (stack.length > 0 && stack[stack.length - 1].indent >= indent) {
+                stack.pop();
+            }
+            if (stack.length === 0) {
+                // Top-level topic
+                topics.push(topic);
+            }
+            else {
+                // Add as child to parent
+                stack[stack.length - 1].topic.children.push(topic);
+            }
+            stack.push({ topic, indent });
+        }
+        return topics;
+    }
+    /**
+     * Counts total number of topics (including children)
+     */
+    countTopics(topics) {
+        let count = topics.length;
+        for (const topic of topics) {
+            count += this.countTopics(topic.children);
+        }
+        return count;
+    }
+    /**
+     * Gets the topic hierarchy for a specific area
+     */
+    getHierarchy(area) {
+        return this.hierarchies.get(area);
+    }
+    /**
+     * Gets topics up to a specific depth
+     */
+    getTopicsWithDepth(area, maxDepth) {
+        const hierarchy = this.hierarchies.get(area);
+        if (!hierarchy) {
+            return [];
+        }
+        return this.filterByDepth(hierarchy.topics, maxDepth, 0);
+    }
+    /**
+     * Filters topics by maximum depth
+     */
+    filterByDepth(topics, maxDepth, currentDepth) {
+        if (currentDepth >= maxDepth) {
+            return [];
+        }
+        return topics.map(topic => ({
+            ...topic,
+            children: this.filterByDepth(topic.children, maxDepth, currentDepth + 1),
+        }));
+    }
+    /**
+     * Finds topics under a specific parent path
+     */
+    getTopicsUnderPath(area, parentPath) {
+        const hierarchy = this.hierarchies.get(area);
+        if (!hierarchy) {
+            return [];
+        }
+        const topic = this.findTopicByPath(hierarchy.topics, parentPath);
+        return topic ? topic.children : [];
+    }
+    /**
+     * Finds a topic by its path
+     */
+    findTopicByPath(topics, targetPath) {
+        for (const topic of topics) {
+            if (topic.path === targetPath) {
+                return topic;
+            }
+            const found = this.findTopicByPath(topic.children, targetPath);
+            if (found) {
+                return found;
+            }
+        }
+        return null;
+    }
+    /**
+     * Flattens the topic hierarchy into a list
+     */
+    flattenTopics(topics) {
+        const flat = [];
+        for (const topic of topics) {
+            flat.push(topic);
+            flat.push(...this.flattenTopics(topic.children));
+        }
+        return flat;
+    }
+    /**
+     * Gets all topics for an area (flattened)
+     */
+    getAllTopics(area) {
+        const hierarchy = this.hierarchies.get(area);
+        if (!hierarchy) {
+            return [];
+        }
+        return this.flattenTopics(hierarchy.topics);
+    }
+}
+//# sourceMappingURL=topic-index.js.map

package/build/indexing/topic-index.js.map

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

package/build/parsers/links.d.ts

@@ -0,0 +1,14 @@
+import type { ParsedLink } from '../types/index.js';
+/**
+ * Extracts all links from markdown content
+ */
+export declare function extractLinks(content: string, sourcePath: string): ParsedLink[];
+/**
+ * Resolves all relative links in markdown content to absolute paths
+ */
+export declare function resolveLinksInContent(content: string, sourcePath: string): string;
+/**
+ * Extracts links from a "Related Information" section
+ */
+export declare function extractRelatedLinks(content: string, sourcePath: string): ParsedLink[];
+//# sourceMappingURL=links.d.ts.map

package/build/parsers/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/parsers/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,CAiD9E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,CAWrF"}

package/build/parsers/links.js

@@ -0,0 +1,80 @@
+import { resolveRelativeLink, isExternalLink } from '../utils/paths.js';
+/**
+ * Extracts all links from markdown content
+ */
+export function extractLinks(content, sourcePath) {
+    const links = [];
+    const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+    let match;
+    while ((match = linkRegex.exec(content)) !== null) {
+        const text = match[1];
+        const href = match[2];
+        // Skip if it's just an anchor or external link handled separately
+        if (href.startsWith('#')) {
+            links.push({
+                text,
+                href,
+                absolutePath: sourcePath,
+                isExternal: false,
+                anchor: href.substring(1),
+            });
+            continue;
+        }
+        const external = isExternalLink(href);
+        if (external) {
+            links.push({
+                text,
+                href,
+                absolutePath: href,
+                isExternal: true,
+            });
+        }
+        else {
+            // Split href into path and anchor
+            const [pathPart, anchor] = href.split('#');
+            const absolutePath = pathPart
+                ? resolveRelativeLink(sourcePath, pathPart)
+                : sourcePath;
+            links.push({
+                text,
+                href,
+                absolutePath,
+                isExternal: false,
+                anchor,
+            });
+        }
+    }
+    return links;
+}
+/**
+ * Resolves all relative links in markdown content to absolute paths
+ */
+export function resolveLinksInContent(content, sourcePath) {
+    return content.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (match, text, href) => {
+        // Skip external links and anchors
+        if (isExternalLink(href) || href.startsWith('#')) {
+            return match;
+        }
+        const [pathPart, anchor] = href.split('#');
+        if (!pathPart) {
+            return match;
+        }
+        const absolutePath = resolveRelativeLink(sourcePath, pathPart);
+        const newHref = anchor ? `${absolutePath}#${anchor}` : absolutePath;
+        return `[${text}](${newHref})`;
+    });
+}
+/**
+ * Extracts links from a "Related Information" section
+ */
+export function extractRelatedLinks(content, sourcePath) {
+    // Look for "Related Information" section
+    const relatedSectionRegex = /\*\*Related Information\*\*\s*([\s\S]*?)(?=\n##|$)/i;
+    const match = content.match(relatedSectionRegex);
+    if (!match) {
+        return [];
+    }
+    const sectionContent = match[1];
+    return extractLinks(sectionContent, sourcePath);
+}
+//# sourceMappingURL=links.js.map

package/build/parsers/links.js.map

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

package/build/parsers/markdown.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedDocument } from '../types/index.js';
+/**
+ * Parses a markdown file and extracts all relevant information
+ */
+export declare function parseMarkdown(filePath: string): Promise<ParsedDocument>;
+/**
+ * Parses markdown to get structured AST (for advanced processing)
+ */
+export declare function parseMarkdownToAST(content: string): Promise<import("mdast").Root>;
+//# sourceMappingURL=markdown.d.ts.map

package/build/parsers/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/parsers/markdown.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,mBAAmB,CAAC;AAIjE;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgC7E;AA4FD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,iCAIvD"}

package/build/parsers/markdown.js

@@ -0,0 +1,120 @@
+import { readFile } from 'fs/promises';
+import { remark } from 'remark';
+import remarkGfm from 'remark-gfm';
+import stripMarkdown from 'strip-markdown';
+import { extractLoioId, extractMetadata } from './metadata.js';
+import { extractLinks } from './links.js';
+/**
+ * Parses a markdown file and extracts all relevant information
+ */
+export async function parseMarkdown(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    // Extract metadata
+    const loioId = extractLoioId(content);
+    const metadata = await extractMetadata(filePath, content);
+    // Extract title (first H1 heading or from filename)
+    const title = extractTitle(content, filePath);
+    // Extract headings
+    const headings = extractHeadings(content);
+    // Extract links
+    const links = extractLinks(content, filePath);
+    // Extract images
+    const images = extractImages(content);
+    // Get clean text (markdown stripped)
+    const cleanText = await stripMarkdownContent(content);
+    return {
+        title,
+        loioId,
+        content,
+        cleanText,
+        links,
+        headings,
+        images,
+        metadata,
+    };
+}
+/**
+ * Extracts the title from the markdown content (first H1 heading)
+ */
+function extractTitle(content, filePath) {
+    // Try to find first H1 heading
+    const h1Match = content.match(/^#\s+(.+)$/m);
+    if (h1Match) {
+        return h1Match[1].trim();
+    }
+    // Fallback: use filename without extension and hash
+    const filename = filePath.split('/').pop() || filePath;
+    const withoutExt = filename.replace(/\.md$/, '');
+    const withoutHash = withoutExt.replace(/-[a-f0-9]{7}$/, '');
+    // Convert kebab-case to Title Case
+    return withoutHash
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Extracts all headings from markdown content
+ */
+function extractHeadings(content) {
+    const headings = [];
+    const headingRegex = /^(#{1,6})\s+(.+)$/gm;
+    let match;
+    while ((match = headingRegex.exec(content)) !== null) {
+        const level = match[1].length;
+        const text = match[2].trim();
+        const anchor = createAnchor(text);
+        headings.push({
+            level,
+            text,
+            anchor,
+        });
+    }
+    return headings;
+}
+/**
+ * Creates an anchor ID from heading text (GitHub-style)
+ */
+function createAnchor(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Extracts image references from markdown content
+ */
+function extractImages(content) {
+    const images = [];
+    const imageRegex = /!\[.*?\]\(([^)]+)\)/g;
+    let match;
+    while ((match = imageRegex.exec(content)) !== null) {
+        images.push(match[1]);
+    }
+    return images;
+}
+/**
+ * Strips markdown formatting from content to get clean text
+ */
+async function stripMarkdownContent(content) {
+    const result = await remark()
+        .use(remarkGfm)
+        .use(stripMarkdown)
+        .process(content);
+    return String(result)
+        // Remove LOIO comments
+        .replace(/<!--\s*loio[a-f0-9]+\s*-->/g, '')
+        // Normalize whitespace
+        .replace(/\n\n+/g, '\n\n')
+        .trim();
+}
+/**
+ * Parses markdown to get structured AST (for advanced processing)
+ */
+export async function parseMarkdownToAST(content) {
+    const processor = remark().use(remarkGfm);
+    const tree = processor.parse(content);
+    return tree;
+}
+//# sourceMappingURL=markdown.js.map

package/build/parsers/markdown.js.map

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

package/build/parsers/metadata.d.ts

@@ -0,0 +1,19 @@
+import type { DocumentMetadata } from '../types/index.js';
+/**
+ * Extracts the LOIO ID from markdown content
+ * Format: <!-- loio5cc6987511104c418b7cb4c25f3d9cb0 -->
+ */
+export declare function extractLoioId(content: string): string;
+/**
+ * Extracts complete document metadata
+ */
+export declare function extractMetadata(filePath: string, content: string): Promise<DocumentMetadata>;
+/**
+ * Checks if a file path looks like a documentation file
+ */
+export declare function isDocumentationFile(filePath: string): boolean;
+/**
+ * Checks if a file is an index file
+ */
+export declare function isIndexFile(filePath: string): boolean;
+//# sourceMappingURL=metadata.d.ts.map

package/build/parsers/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/parsers/metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoClG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/build/parsers/metadata.js

@@ -0,0 +1,63 @@
+import { stat } from 'fs/promises';
+import { getDocumentArea, getRelativePath, resolveDocsPath } from '../utils/paths.js';
+/**
+ * Extracts the LOIO ID from markdown content
+ * Format: <!-- loio5cc6987511104c418b7cb4c25f3d9cb0 -->
+ */
+export function extractLoioId(content) {
+    const match = content.match(/<!--\s*loio([a-f0-9]+)\s*-->/);
+    if (match) {
+        return `loio${match[1]}`;
+    }
+    // Return empty string if no LOIO ID found
+    return '';
+}
+/**
+ * Extracts complete document metadata
+ */
+export async function extractMetadata(filePath, content) {
+    const loioId = extractLoioId(content);
+    const area = getDocumentArea(filePath);
+    const docsPath = resolveDocsPath();
+    const relativePath = getRelativePath(filePath, docsPath);
+    // Get file stats
+    const stats = await stat(filePath);
+    // Extract title from first H1 heading
+    const titleMatch = content.match(/^#\s+(.+)$/m);
+    let title = '';
+    if (titleMatch) {
+        title = titleMatch[1].trim();
+    }
+    else {
+        // Fallback: use filename
+        const filename = filePath.split('/').pop() || filePath;
+        const withoutExt = filename.replace(/\.md$/, '');
+        const withoutHash = withoutExt.replace(/-[a-f0-9]{7}$/, '');
+        title = withoutHash
+            .split('-')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    return {
+        loioId,
+        title,
+        area,
+        filePath,
+        relativePath,
+        lastModified: stats.mtime,
+        size: stats.size,
+    };
+}
+/**
+ * Checks if a file path looks like a documentation file
+ */
+export function isDocumentationFile(filePath) {
+    return filePath.endsWith('.md') && !filePath.endsWith('index.md');
+}
+/**
+ * Checks if a file is an index file
+ */
+export function isIndexFile(filePath) {
+    return filePath.endsWith('index.md');
+}
+//# sourceMappingURL=metadata.js.map

package/build/parsers/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/parsers/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAE5D,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,0CAA0C;IAC1C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAe;IACrE,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEzD,iBAAiB;IACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,sCAAsC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChD,IAAI,KAAK,GAAG,EAAE,CAAC;IAEf,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;QACvD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAE5D,KAAK,GAAG,WAAW;aAChB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACzD,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK;QACL,IAAI;QACJ,QAAQ;QACR,YAAY;QACZ,YAAY,EAAE,KAAK,CAAC,KAAK;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC"}

package/build/search/fulltext.d.ts

@@ -0,0 +1,20 @@
+import type { FullTextSearchOptions, SearchResult } from '../types/index.js';
+import { FileRegistry } from '../indexing/file-registry.js';
+import { FileCache } from '../cache/file-cache.js';
+/**
+ * Full-text search implementation
+ */
+export declare class FullTextSearch {
+    private registry;
+    private fileCache;
+    constructor(registry: FileRegistry, fileCache: FileCache);
+    /**
+     * Performs full-text search across documentation
+     */
+    search(options: FullTextSearchOptions): Promise<SearchResult[]>;
+    /**
+     * Scores a document based on query relevance
+     */
+    private scoreDocument;
+}
+//# sourceMappingURL=fulltext.d.ts.map

package/build/search/fulltext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulltext.d.ts","sourceRoot":"","sources":["../../src/search/fulltext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD;;GAEG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;gBADT,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,SAAS;IAG9B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0DrE;;OAEG;IACH,OAAO,CAAC,aAAa;CAyDtB"}