@theglitchking/hit-em-with-the-docs 2.0.0

package/dist/core/integrate/integrator.js

@@ -0,0 +1,216 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { join, relative, basename, dirname } from 'path';
+import { logger } from '../../utils/logger.js';
+import { parseFrontmatter, setFrontmatter } from '../../utils/frontmatter.js';
+import { pathExists, findMarkdownFiles } from '../../utils/glob.js';
+import { detectDomain } from '../domains/detector.js';
+import { classifyTier } from '../domains/classifier.js';
+import { generateMetadata, mergeMetadata } from '../metadata/generator.js';
+import levenshtein from 'fast-levenshtein';
+/**
+ * Integrate a document into the documentation system
+ */
+export async function integrateDocument(options) {
+    const { filePath, docsPath, auto = false, dryRun = false, force = false, silent = false, } = options;
+    const result = {
+        success: false,
+        integrated: false,
+        originalPath: filePath,
+    };
+    if (!silent) {
+        logger.header('Document Integration');
+        logger.info(`File: ${filePath}`);
+        if (dryRun)
+            logger.info('Running in dry-run mode');
+    }
+    try {
+        // Check if file exists
+        if (!(await pathExists(filePath))) {
+            result.error = 'File does not exist';
+            return result;
+        }
+        // Read file content
+        const content = await readFile(filePath, 'utf-8');
+        const { data: existingMetadata } = parseFrontmatter(content);
+        // Detect domain
+        const domainResult = detectDomain(filePath, content, docsPath);
+        if (domainResult.domain) {
+            result.domain = domainResult.domain;
+        }
+        if (!silent) {
+            logger.info(`Detected domain: ${result.domain ?? 'unknown'} (${(domainResult.confidence * 100).toFixed(0)}% confidence)`);
+        }
+        // Classify tier
+        const tierResult = classifyTier(content);
+        result.tier = tierResult.tier;
+        if (!silent) {
+            logger.info(`Detected tier: ${result.tier} (${(tierResult.confidence * 100).toFixed(0)}% confidence)`);
+        }
+        // Check for duplicates
+        const duplicates = await findDuplicates(existingMetadata.title ?? basename(filePath, '.md'), content, docsPath);
+        if (duplicates.length > 0) {
+            result.duplicates = duplicates;
+            if (!silent) {
+                logger.warn(`Found ${duplicates.length} potential duplicate(s):`);
+                for (const dup of duplicates) {
+                    logger.warn(`  - ${dup.path} (${(dup.similarity * 100).toFixed(0)}% similar)`);
+                }
+            }
+            // If high similarity and not force, don't integrate
+            const highSimilarity = duplicates.some((d) => d.similarity > 0.7);
+            if (highSimilarity && !force && !auto) {
+                result.error = 'Potential duplicate detected. Use --force to override.';
+                return result;
+            }
+        }
+        // Generate metadata
+        const generated = generateMetadata({
+            filePath,
+            content,
+            docsRoot: docsPath,
+            existingMetadata,
+        });
+        const finalMetadata = mergeMetadata(existingMetadata, generated);
+        result.metadata = finalMetadata;
+        // Determine target path
+        const targetDomain = result.domain ?? 'features';
+        const fileName = basename(filePath);
+        const targetPath = join(docsPath, targetDomain, fileName);
+        result.targetPath = targetPath;
+        if (!silent) {
+            logger.newline();
+            logger.info('Generated metadata:');
+            logger.info(`  Title: ${finalMetadata.title}`);
+            logger.info(`  Tier: ${finalMetadata.tier}`);
+            logger.info(`  Domains: ${finalMetadata.domains?.join(', ')}`);
+            logger.info(`  Status: ${finalMetadata.status}`);
+            logger.newline();
+            logger.info(`Target path: ${relative(docsPath, targetPath)}`);
+        }
+        if (dryRun) {
+            result.success = true;
+            if (!silent) {
+                logger.info('Dry-run complete. No changes made.');
+            }
+            return result;
+        }
+        // Create target directory if needed
+        const targetDir = dirname(targetPath);
+        if (!(await pathExists(targetDir))) {
+            await mkdir(targetDir, { recursive: true });
+        }
+        // Write file with updated metadata
+        const newContent = setFrontmatter(content, finalMetadata);
+        await writeFile(targetPath, newContent, 'utf-8');
+        // Update domain INDEX.md
+        await updateDomainIndex(docsPath, targetDomain, targetPath, finalMetadata);
+        result.success = true;
+        result.integrated = true;
+        if (!silent) {
+            logger.newline();
+            logger.success('Document integrated successfully!');
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        result.error = message;
+        if (!silent) {
+            logger.error(`Integration failed: ${message}`);
+        }
+    }
+    return result;
+}
+/**
+ * Find potential duplicate documents
+ */
+async function findDuplicates(title, content, docsPath) {
+    const files = await findMarkdownFiles(docsPath);
+    const duplicates = [];
+    const normalizedTitle = title.toLowerCase().replace(/[^a-z0-9]/g, '');
+    for (const file of files) {
+        try {
+            const fileContent = await readFile(file, 'utf-8');
+            const { data } = parseFrontmatter(fileContent);
+            const existingTitle = data.title ?? basename(file, '.md');
+            const normalizedExisting = existingTitle.toLowerCase().replace(/[^a-z0-9]/g, '');
+            // Calculate title similarity using Levenshtein distance
+            const titleDistance = levenshtein.get(normalizedTitle, normalizedExisting);
+            const maxLen = Math.max(normalizedTitle.length, normalizedExisting.length);
+            const titleSimilarity = maxLen > 0 ? 1 - titleDistance / maxLen : 1;
+            // Also check content similarity (simple approach: word overlap)
+            const contentSimilarity = calculateContentSimilarity(content, fileContent);
+            // Combined similarity
+            const similarity = titleSimilarity * 0.6 + contentSimilarity * 0.4;
+            if (similarity > 0.5) {
+                duplicates.push({
+                    path: relative(docsPath, file),
+                    title: existingTitle,
+                    similarity,
+                });
+            }
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    return duplicates.sort((a, b) => b.similarity - a.similarity);
+}
+/**
+ * Calculate content similarity using word overlap
+ */
+function calculateContentSimilarity(content1, content2) {
+    const words1 = new Set(content1.toLowerCase().match(/\b\w+\b/g) ?? []);
+    const words2 = new Set(content2.toLowerCase().match(/\b\w+\b/g) ?? []);
+    let intersection = 0;
+    for (const word of words1) {
+        if (words2.has(word)) {
+            intersection++;
+        }
+    }
+    const union = words1.size + words2.size - intersection;
+    return union > 0 ? intersection / union : 0;
+}
+/**
+ * Update domain INDEX.md with new document
+ */
+async function updateDomainIndex(docsPath, domain, filePath, metadata) {
+    const indexPath = join(docsPath, domain, 'INDEX.md');
+    if (!(await pathExists(indexPath))) {
+        return;
+    }
+    try {
+        const indexContent = await readFile(indexPath, 'utf-8');
+        // Check if document is already listed
+        const relPath = relative(join(docsPath, domain), filePath);
+        if (indexContent.includes(relPath)) {
+            return;
+        }
+        // Find the documents table and add entry
+        const tableRegex = /(\| Document \| Tier \| Status \| Updated \|\n\|[-|\s]+\n)([\s\S]*?)(\n\n|$)/;
+        const match = indexContent.match(tableRegex);
+        if (match) {
+            const [fullMatch, header, existingRows, ending] = match;
+            const newRow = `| [${metadata.title}](${relPath}) | ${metadata.tier} | ${metadata.status} | ${metadata.last_updated} |\n`;
+            const newContent = indexContent.replace(fullMatch, `${header}${existingRows}${newRow}${ending}`);
+            await writeFile(indexPath, newContent, 'utf-8');
+        }
+    }
+    catch {
+        // Silently fail if we can't update the index
+    }
+}
+/**
+ * Batch integrate multiple documents
+ */
+export async function batchIntegrate(files, options) {
+    const results = [];
+    for (const file of files) {
+        const result = await integrateDocument({
+            ...options,
+            filePath: file,
+        });
+        results.push(result);
+    }
+    return results;
+}
+//# sourceMappingURL=integrator.js.map

package/dist/core/integrate/integrator.js.map

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

package/dist/core/links/checker.d.ts

@@ -0,0 +1,64 @@
+import type { Domain } from '../domains/constants.js';
+export { type MarkdownLink } from '../../utils/markdown.js';
+export interface LinkCheckOptions {
+    docsPath: string;
+    domain?: string;
+    checkExternal?: boolean;
+    silent?: boolean;
+}
+export interface LinkCheckResult {
+    totalFiles: number;
+    totalLinks: number;
+    validLinks: number;
+    brokenLinks: BrokenLink[];
+    crossDomainLinks: CrossDomainLink[];
+    externalLinks: ExternalLink[];
+    stats: LinkStats;
+}
+export interface BrokenLink {
+    sourceFile: string;
+    targetPath: string;
+    lineNumber: number;
+    linkText: string;
+    reason: string;
+}
+export interface CrossDomainLink {
+    sourceFile: string;
+    sourceDomain: Domain | null;
+    targetPath: string;
+    targetDomain: Domain | null;
+    linkText: string;
+}
+export interface ExternalLink {
+    sourceFile: string;
+    url: string;
+    linkText: string;
+    status?: number;
+}
+export interface LinkStats {
+    internalLinks: number;
+    externalLinks: number;
+    crossDomainLinks: number;
+    brokenPercentage: number;
+    topConnectedDomains: {
+        from: string;
+        to: string;
+        count: number;
+    }[];
+}
+/**
+ * Check all links in documentation
+ */
+export declare function checkLinks(options: LinkCheckOptions): Promise<LinkCheckResult>;
+/**
+ * Check a single link and return its status
+ */
+export declare function checkSingleLink(linkUrl: string, sourceFile: string, docsPath: string): Promise<{
+    valid: boolean;
+    reason?: string;
+}>;
+/**
+ * Get broken links for a specific file
+ */
+export declare function getFileBrokenLinks(filePath: string, docsPath: string): Promise<BrokenLink[]>;
+//# sourceMappingURL=checker.d.ts.map

package/dist/core/links/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../../src/core/links/checker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmJpF;AAuBD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAW9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAyBvB"}

package/dist/core/links/checker.js

@@ -0,0 +1,190 @@
+import { readFile } from 'fs/promises';
+import { join, relative, dirname, resolve } from 'path';
+import { findMarkdownFiles, pathExists } from '../../utils/glob.js';
+import { extractLinks } from '../../utils/markdown.js';
+import { logger } from '../../utils/logger.js';
+import { detectDomainFromPath } from '../domains/detector.js';
+/**
+ * Check all links in documentation
+ */
+export async function checkLinks(options) {
+    const { docsPath, domain, checkExternal = false, silent = false, } = options;
+    const result = {
+        totalFiles: 0,
+        totalLinks: 0,
+        validLinks: 0,
+        brokenLinks: [],
+        crossDomainLinks: [],
+        externalLinks: [],
+        stats: {
+            internalLinks: 0,
+            externalLinks: 0,
+            crossDomainLinks: 0,
+            brokenPercentage: 0,
+            topConnectedDomains: [],
+        },
+    };
+    if (!silent) {
+        logger.header('Link Checker');
+    }
+    // Find all markdown files
+    let files = await findMarkdownFiles(docsPath);
+    // Filter by domain if specified
+    if (domain) {
+        files = files.filter((f) => {
+            const rel = relative(docsPath, f);
+            return rel.startsWith(domain + '/') || rel.startsWith(domain + '\\');
+        });
+    }
+    result.totalFiles = files.length;
+    if (!silent) {
+        logger.info(`Checking ${files.length} files...`);
+    }
+    const domainConnections = new Map();
+    for (const file of files) {
+        try {
+            const content = await readFile(file, 'utf-8');
+            const links = extractLinks(content);
+            const relFile = relative(docsPath, file);
+            const fileDir = dirname(file);
+            for (const link of links) {
+                result.totalLinks++;
+                if (link.isInternal) {
+                    result.stats.internalLinks++;
+                    // Resolve the link path
+                    const targetPath = resolveLink(link.url, fileDir, docsPath);
+                    // Check if target exists
+                    const exists = await pathExists(targetPath);
+                    if (!exists) {
+                        result.brokenLinks.push({
+                            sourceFile: relFile,
+                            targetPath: link.url,
+                            lineNumber: link.lineNumber,
+                            linkText: link.text,
+                            reason: 'Target file does not exist',
+                        });
+                    }
+                    else {
+                        result.validLinks++;
+                        // Track cross-domain links
+                        const sourceDomain = detectDomainFromPath(file, docsPath).domain;
+                        const targetDomain = detectDomainFromPath(targetPath, docsPath).domain;
+                        if (sourceDomain && targetDomain && sourceDomain !== targetDomain) {
+                            result.stats.crossDomainLinks++;
+                            result.crossDomainLinks.push({
+                                sourceFile: relFile,
+                                sourceDomain,
+                                targetPath: link.url,
+                                targetDomain,
+                                linkText: link.text,
+                            });
+                            // Track domain connections
+                            const connKey = `${sourceDomain} -> ${targetDomain}`;
+                            domainConnections.set(connKey, (domainConnections.get(connKey) ?? 0) + 1);
+                        }
+                    }
+                }
+                else {
+                    // External link
+                    result.stats.externalLinks++;
+                    result.externalLinks.push({
+                        sourceFile: relFile,
+                        url: link.url,
+                        linkText: link.text,
+                    });
+                    // Optionally check external links
+                    if (checkExternal) {
+                        // Note: External link checking would go here
+                        // For now, we just track them
+                    }
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (!silent) {
+                logger.warn(`Error processing ${relative(docsPath, file)}: ${message}`);
+            }
+        }
+    }
+    // Calculate stats
+    result.stats.brokenPercentage =
+        result.stats.internalLinks > 0
+            ? (result.brokenLinks.length / result.stats.internalLinks) * 100
+            : 0;
+    // Get top connected domains
+    result.stats.topConnectedDomains = [...domainConnections.entries()]
+        .map(([key, count]) => {
+        const [from, to] = key.split(' -> ');
+        return { from: from ?? '', to: to ?? '', count };
+    })
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 10);
+    if (!silent) {
+        logger.newline();
+        logger.success(`Link check complete!`);
+        logger.info(`Total links: ${result.totalLinks}`);
+        logger.info(`Valid: ${result.validLinks}`);
+        if (result.brokenLinks.length > 0) {
+            logger.warn(`Broken: ${result.brokenLinks.length}`);
+        }
+        logger.info(`Cross-domain: ${result.stats.crossDomainLinks}`);
+    }
+    return result;
+}
+/**
+ * Resolve a relative link to an absolute path
+ */
+function resolveLink(linkUrl, fileDir, docsPath) {
+    // Remove anchor
+    const pathPart = linkUrl.split('#')[0] ?? '';
+    if (!pathPart) {
+        // Link is just an anchor, it's valid
+        return fileDir;
+    }
+    // Handle absolute links (from docs root)
+    if (pathPart.startsWith('/')) {
+        return join(docsPath, pathPart);
+    }
+    // Handle relative links
+    return resolve(fileDir, pathPart);
+}
+/**
+ * Check a single link and return its status
+ */
+export async function checkSingleLink(linkUrl, sourceFile, docsPath) {
+    const fileDir = dirname(sourceFile);
+    const targetPath = resolveLink(linkUrl, fileDir, docsPath);
+    const exists = await pathExists(targetPath);
+    if (!exists) {
+        return { valid: false, reason: 'Target file does not exist' };
+    }
+    return { valid: true };
+}
+/**
+ * Get broken links for a specific file
+ */
+export async function getFileBrokenLinks(filePath, docsPath) {
+    const content = await readFile(filePath, 'utf-8');
+    const links = extractLinks(content);
+    const brokenLinks = [];
+    const fileDir = dirname(filePath);
+    const relFile = relative(docsPath, filePath);
+    for (const link of links) {
+        if (link.isInternal) {
+            const targetPath = resolveLink(link.url, fileDir, docsPath);
+            const exists = await pathExists(targetPath);
+            if (!exists) {
+                brokenLinks.push({
+                    sourceFile: relFile,
+                    targetPath: link.url,
+                    lineNumber: link.lineNumber,
+                    linkText: link.text,
+                    reason: 'Target file does not exist',
+                });
+            }
+        }
+    }
+    return brokenLinks;
+}
+//# sourceMappingURL=checker.js.map

package/dist/core/links/checker.js.map

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

package/dist/core/links/tracker.d.ts

@@ -0,0 +1,69 @@
+import type { Domain } from '../domains/constants.js';
+export interface LinkGraph {
+    nodes: LinkNode[];
+    edges: LinkEdge[];
+}
+export interface LinkNode {
+    id: string;
+    path: string;
+    domain: Domain | null;
+    title?: string;
+    inDegree: number;
+    outDegree: number;
+}
+export interface LinkEdge {
+    source: string;
+    target: string;
+    linkText: string;
+    lineNumber: number;
+}
+export interface DomainConnectionMatrix {
+    domains: Domain[];
+    matrix: number[][];
+    totalConnections: number;
+}
+/**
+ * Build a complete link graph for the documentation
+ */
+export declare function buildLinkGraph(docsPath: string): Promise<LinkGraph>;
+/**
+ * Build a domain connection matrix showing how domains link to each other
+ */
+export declare function buildDomainConnectionMatrix(docsPath: string): Promise<DomainConnectionMatrix>;
+/**
+ * Get top connected domain pairs
+ */
+export declare function getTopConnectedDomains(docsPath: string, limit?: number): Promise<{
+    from: Domain;
+    to: Domain;
+    count: number;
+}[]>;
+/**
+ * Get backlinks for a specific file
+ */
+export declare function getBacklinks(targetFile: string, docsPath: string): Promise<{
+    source: string;
+    linkText: string;
+    lineNumber: number;
+}[]>;
+/**
+ * Find orphan files (files with no incoming links)
+ */
+export declare function findOrphanFiles(docsPath: string): Promise<string[]>;
+/**
+ * Find highly connected files (hubs)
+ */
+export declare function findHubFiles(docsPath: string, minDegree?: number): Promise<LinkNode[]>;
+/**
+ * Get link statistics summary
+ */
+export declare function getLinkStatistics(docsPath: string): Promise<{
+    totalNodes: number;
+    totalEdges: number;
+    avgInDegree: number;
+    avgOutDegree: number;
+    orphanCount: number;
+    hubCount: number;
+    crossDomainPercentage: number;
+}>;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/core/links/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/core/links/tracker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAiEzE;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CA+BjC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAoBxD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAWrE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWzE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAU,GACpB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMrB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC,CA8BD"}