@dotcontext/mcp 0.9.0

package/dist/utils/cliUI.js

@@ -0,0 +1,216 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIInterface = void 0;
+const ora_1 = __importDefault(require("ora"));
+const cliProgress = __importStar(require("cli-progress"));
+const theme_1 = require("./theme");
+class CLIInterface {
+    constructor(translate) {
+        this.translate = translate;
+        this.spinner = null;
+        this.progressBar = null;
+        this.startTime = Date.now();
+    }
+    displayProjectInfo(repoPath, outputDir, mode) {
+        console.log(theme_1.typography.header(this.t('ui.projectConfiguration.title')));
+        console.log('');
+        console.log(theme_1.typography.labeledValue(this.t('ui.projectConfiguration.repository'), repoPath, 14));
+        console.log(theme_1.typography.labeledValue(this.t('ui.projectConfiguration.output'), outputDir, 14));
+        console.log(theme_1.typography.labeledValue(this.t('ui.projectConfiguration.mode'), mode, 14));
+        console.log('');
+    }
+    startSpinner(text) {
+        // Stop any existing spinner to prevent orphaned spinners
+        if (this.spinner) {
+            this.spinner.stop();
+        }
+        this.spinner = (0, ora_1.default)({
+            text: theme_1.colors.secondary(text),
+            spinner: 'dots',
+            color: 'white'
+        }).start();
+    }
+    updateSpinner(text, type) {
+        if (!this.spinner)
+            return;
+        switch (type) {
+            case 'success':
+                this.spinner.stopAndPersist({
+                    symbol: theme_1.colors.success(theme_1.symbols.success),
+                    text: theme_1.colors.primary(text)
+                });
+                break;
+            case 'fail':
+                this.spinner.stopAndPersist({
+                    symbol: theme_1.colors.error(theme_1.symbols.error),
+                    text: theme_1.colors.primary(text)
+                });
+                break;
+            case 'warn':
+                this.spinner.stopAndPersist({
+                    symbol: theme_1.colors.warning(theme_1.symbols.warning),
+                    text: theme_1.colors.primary(text)
+                });
+                break;
+            case 'info':
+                this.spinner.stopAndPersist({
+                    symbol: theme_1.colors.accent(theme_1.symbols.info),
+                    text: theme_1.colors.primary(text)
+                });
+                break;
+            default:
+                this.spinner.text = theme_1.colors.secondary(text);
+        }
+    }
+    stopSpinner(success = true) {
+        if (!this.spinner)
+            return;
+        if (success) {
+            this.spinner.stop();
+        }
+        else {
+            this.spinner.fail();
+        }
+        this.spinner = null;
+    }
+    createProgressBar(total, title) {
+        this.progressBar = new cliProgress.SingleBar({
+            format: `${theme_1.colors.secondary(title)} {bar} {percentage}% ${theme_1.colors.secondaryDim('{value}/{total}')} ${theme_1.colors.secondaryDim('{task}')}`,
+            barCompleteChar: '\u2588',
+            barIncompleteChar: '\u2591',
+            hideCursor: true,
+            stopOnComplete: true,
+            clearOnComplete: false
+        }, cliProgress.Presets.rect);
+        this.progressBar.start(total, 0, {
+            task: this.t('ui.progress.starting')
+        });
+    }
+    updateProgress(current, task) {
+        if (!this.progressBar)
+            return;
+        this.progressBar.update(current, { task });
+    }
+    completeProgress() {
+        if (!this.progressBar)
+            return;
+        this.progressBar.stop();
+        this.progressBar = null;
+    }
+    displayAnalysisResults(totalFiles, totalDirs, totalSize) {
+        console.log('');
+        console.log(theme_1.typography.header(this.t('ui.analysis.complete.title')));
+        console.log('');
+        console.log(theme_1.typography.labeledValue(this.t('ui.analysis.files'), totalFiles.toString()));
+        console.log(theme_1.typography.labeledValue(this.t('ui.analysis.directories'), totalDirs.toString()));
+        console.log(theme_1.typography.labeledValue(this.t('ui.analysis.totalSize'), totalSize));
+        console.log('');
+    }
+    displayFileTypeDistribution(distribution, totalFiles) {
+        console.log(theme_1.typography.header(this.t('ui.fileTypeDistribution.title')));
+        console.log('');
+        const sorted = Array.from(distribution.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10);
+        sorted.forEach(([ext, count]) => {
+            const percentage = ((count / totalFiles) * 100).toFixed(1);
+            const barLength = Math.round((count / totalFiles) * 30);
+            const bar = '\u2588'.repeat(barLength) + '\u2591'.repeat(30 - barLength);
+            console.log(`  ${theme_1.colors.primary(ext.padEnd(12))} ${theme_1.colors.secondaryDim(bar)} ${theme_1.colors.secondary(count.toString().padStart(4))} ${theme_1.colors.secondaryDim(`(${percentage}%)`)}`);
+        });
+        console.log('');
+    }
+    displayGenerationSummary(docsGenerated, agentsGenerated, skillsGenerated) {
+        const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
+        console.log('');
+        console.log(theme_1.typography.separator());
+        console.log(theme_1.typography.header(this.t('ui.generationSummary.title')));
+        console.log('');
+        console.log(theme_1.typography.labeledValue(this.t('ui.generationSummary.documentation'), `${docsGenerated} files`));
+        console.log(theme_1.typography.labeledValue(this.t('ui.generationSummary.agents'), `${agentsGenerated} playbooks`));
+        if (skillsGenerated !== undefined && skillsGenerated > 0) {
+            console.log(theme_1.typography.labeledValue(this.t('ui.generationSummary.skills'), `${skillsGenerated} skills`));
+        }
+        console.log(theme_1.typography.labeledValue(this.t('ui.generationSummary.timeElapsed'), `${elapsed}s`));
+        console.log('');
+        console.log(theme_1.colors.secondaryDim(this.t('ui.generationSummary.nextStep')));
+        console.log('');
+    }
+    displayError(message, error) {
+        console.log('');
+        console.log(`${theme_1.colors.error(theme_1.symbols.error)} ${theme_1.colors.primaryBold(this.t('ui.error.title'))}`);
+        console.log('');
+        console.log(`  ${theme_1.colors.primary(message)}`);
+        if (error?.stack) {
+            console.log('');
+            console.log(theme_1.colors.secondaryDim(error.stack));
+        }
+        console.log('');
+    }
+    displayInfo(title, message) {
+        console.log('');
+        console.log(`${theme_1.colors.accent(theme_1.symbols.info)} ${theme_1.typography.header(title)}`);
+        console.log('');
+        console.log(`  ${theme_1.colors.primary(message)}`);
+        console.log('');
+    }
+    displaySuccess(message) {
+        console.log(theme_1.typography.success(message));
+    }
+    displayWarning(message) {
+        console.log(theme_1.typography.warning(message));
+    }
+    displayStep(step, total, description) {
+        console.log(theme_1.colors.secondaryDim(`[${step}/${total}]`) + ' ' +
+            theme_1.colors.primary(description));
+    }
+    formatBytes(bytes) {
+        if (bytes === 0)
+            return '0 Bytes';
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+    }
+    t(key, params) {
+        return this.translate(key, params);
+    }
+}
+exports.CLIInterface = CLIInterface;
+//# sourceMappingURL=cliUI.js.map

package/dist/utils/cliUI.js.map

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

package/dist/utils/fileMapper.d.ts

@@ -0,0 +1,13 @@
+import { FileInfo, RepoStructure } from '../types';
+export declare class FileMapper {
+    private excludePatterns;
+    private readonly gitIgnoreManager;
+    constructor(customExcludes?: string[]);
+    private loadGitignorePatterns;
+    mapRepository(repoPath: string, includePatterns?: string[]): Promise<RepoStructure>;
+    readFileContent(filePath: string): Promise<string>;
+    getFilesByExtension(files: FileInfo[], extension: string): FileInfo[];
+    isTextFile(filePath: string): boolean;
+    private extractTopLevelSegment;
+}
+//# sourceMappingURL=fileMapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileMapper.d.ts","sourceRoot":"","sources":["../../src/utils/fileMapper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAA0B,MAAM,UAAU,CAAC;AAG3E,qBAAa,UAAU;IACrB,OAAO,CAAC,eAAe,CAWrB;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAExC,cAAc,GAAE,MAAM,EAAO;YAK3B,qBAAqB;IAY7B,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAkFnF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxD,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIrE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAarC,OAAO,CAAC,sBAAsB;CAI/B"}

package/dist/utils/fileMapper.js

@@ -0,0 +1,165 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileMapper = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const glob_1 = require("glob");
+const gitignoreManager_1 = require("./gitignoreManager");
+class FileMapper {
+    constructor(customExcludes = []) {
+        this.excludePatterns = [
+            'node_modules',
+            '**/node_modules',
+            '**/node_modules/**',
+            '.git/**',
+            'dist/**',
+            'build/**',
+            '*.log',
+            '.env*',
+            '*.tmp',
+            '**/.DS_Store'
+        ];
+        this.excludePatterns = [...this.excludePatterns, ...customExcludes];
+        this.gitIgnoreManager = new gitignoreManager_1.GitIgnoreManager({ extraPatterns: customExcludes });
+    }
+    async loadGitignorePatterns(repoPath) {
+        const gitignorePath = path.join(repoPath, '.gitignore');
+        if (!await fs.pathExists(gitignorePath)) {
+            return [];
+        }
+        const content = await fs.readFile(gitignorePath, 'utf-8');
+        return content
+            .split('\n')
+            .map(line => line.trim())
+            .filter(line => line.length > 0 && !line.startsWith('#'));
+    }
+    async mapRepository(repoPath, includePatterns) {
+        const absolutePath = path.resolve(repoPath);
+        if (!await fs.pathExists(absolutePath)) {
+            throw new Error(`Repository path does not exist: ${absolutePath}`);
+        }
+        const gitignorePatterns = await this.loadGitignorePatterns(absolutePath);
+        const ignorePatterns = [...this.excludePatterns, ...gitignorePatterns];
+        const patterns = includePatterns || ['**/*'];
+        const allFiles = [];
+        for (const pattern of patterns) {
+            const files = await (0, glob_1.glob)(pattern, {
+                cwd: absolutePath,
+                ignore: ignorePatterns,
+                dot: false,
+                absolute: false
+            });
+            allFiles.push(...files);
+        }
+        // Apply .gitignore filtering on top of glob excludes
+        const filteredFiles = this.gitIgnoreManager.filterPaths(allFiles);
+        const uniqueFiles = [...new Set(filteredFiles)];
+        const fileInfos = [];
+        const directories = [];
+        let totalSize = 0;
+        const topLevelStats = new Map();
+        const concurrency = 32;
+        for (let index = 0; index < uniqueFiles.length; index += concurrency) {
+            const slice = uniqueFiles.slice(index, index + concurrency);
+            await Promise.all(slice.map(async (relativePath) => {
+                const fullPath = path.join(absolutePath, relativePath);
+                const stats = await fs.stat(fullPath);
+                const info = {
+                    path: fullPath,
+                    relativePath,
+                    extension: path.extname(relativePath),
+                    size: stats.size,
+                    type: stats.isDirectory() ? 'directory' : 'file'
+                };
+                const topLevelSegment = this.extractTopLevelSegment(relativePath);
+                if (topLevelSegment) {
+                    const current = topLevelStats.get(topLevelSegment) ?? { fileCount: 0, totalSize: 0 };
+                    if (!stats.isDirectory()) {
+                        current.fileCount += 1;
+                        current.totalSize += stats.size;
+                    }
+                    topLevelStats.set(topLevelSegment, current);
+                }
+                if (stats.isDirectory()) {
+                    directories.push(info);
+                }
+                else {
+                    fileInfos.push(info);
+                    totalSize += stats.size;
+                }
+            }));
+        }
+        const topLevelDirectoryStats = Array.from(topLevelStats.entries())
+            .map(([name, stats]) => ({ name, fileCount: stats.fileCount, totalSize: stats.totalSize }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        return {
+            rootPath: absolutePath,
+            files: fileInfos,
+            directories,
+            totalFiles: fileInfos.length,
+            totalSize,
+            topLevelDirectoryStats
+        };
+    }
+    async readFileContent(filePath) {
+        try {
+            return await fs.readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            return `Error reading file: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    }
+    getFilesByExtension(files, extension) {
+        return files.filter(file => file.extension === extension);
+    }
+    isTextFile(filePath) {
+        const textExtensions = [
+            '.js', '.ts', '.jsx', '.tsx', '.py', '.java', '.cpp', '.c', '.h',
+            '.css', '.scss', '.sass', '.html', '.xml', '.json', '.yaml', '.yml',
+            '.md', '.txt', '.sql', '.sh', '.bat', '.ps1', '.php', '.rb', '.go',
+            '.rs', '.swift', '.kt', '.scala', '.r', '.m', '.pl', '.lua', '.vim',
+            '.dockerfile', '.gitignore', '.env'
+        ];
+        const ext = path.extname(filePath).toLowerCase();
+        return textExtensions.includes(ext) || !ext;
+    }
+    extractTopLevelSegment(relativePath) {
+        const parts = relativePath.split(/[/\\]/).filter(Boolean);
+        return parts.length > 0 ? parts[0] : null;
+    }
+}
+exports.FileMapper = FileMapper;
+//# sourceMappingURL=fileMapper.js.map

package/dist/utils/fileMapper.js.map

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

package/dist/utils/frontMatter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * YAML Front Matter utilities for status detection
+ *
+ * Allows instant detection of unfilled files by reading only the first line.
+ * Supports both v1 (simple) and v2 (scaffold) frontmatter formats.
+ */
+import type { ScaffoldFileType, ScaffoldStatus } from '../types/scaffoldFrontmatter';
+/**
+ * Legacy v1 frontmatter (simple status tracking)
+ */
+export interface FrontMatter {
+    status?: 'unfilled' | 'filled';
+    generated?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Parsed v2 scaffold frontmatter
+ */
+export interface ParsedScaffoldFrontmatter {
+    type: ScaffoldFileType;
+    name: string;
+    description: string;
+    generated: string;
+    status: ScaffoldStatus;
+    scaffoldVersion: '2.0.0';
+    category?: string;
+    agentType?: string;
+    skillSlug?: string;
+    planSlug?: string;
+    phases?: string[];
+    mode?: boolean;
+    disableModelInvocation?: boolean;
+    summary?: string;
+    agents?: Array<{
+        type: string;
+        role: string;
+    }>;
+    docs?: string[];
+}
+/**
+ * Check if frontmatter is v2 scaffold format
+ */
+export declare function isScaffoldFrontmatter(fm: FrontMatter | ParsedScaffoldFrontmatter): fm is ParsedScaffoldFrontmatter;
+/**
+ * Check if a file needs to be filled by reading only the frontmatter block.
+ * Searches for 'status: unfilled' only within the YAML frontmatter (between --- delimiters),
+ * not in the document body where example code might contain the same string.
+ */
+export declare function needsFill(filePath: string): Promise<boolean>;
+/**
+ * Parse YAML front matter from content string
+ */
+export declare function parseFrontMatter(content: string): {
+    frontMatter: FrontMatter | null;
+    body: string;
+};
+/**
+ * Add front matter to content
+ */
+export declare function addFrontMatter(content: string, frontMatter: FrontMatter): string;
+/**
+ * Remove front matter from content (used after filling)
+ */
+export declare function removeFrontMatter(content: string): string;
+/**
+ * Check if content has front matter
+ */
+export declare function hasFrontMatter(content: string): boolean;
+/**
+ * Create standard unfilled front matter
+ */
+export declare function createUnfilledFrontMatter(): FrontMatter;
+/**
+ * Get all unfilled files in a directory
+ */
+export declare function getUnfilledFiles(contextDir: string): Promise<string[]>;
+/**
+ * Count filled vs unfilled files
+ */
+export declare function getFilledStats(contextDir: string): Promise<{
+    total: number;
+    filled: number;
+    unfilled: number;
+    files: {
+        path: string;
+        filled: boolean;
+    }[];
+}>;
+/**
+ * Parse scaffold frontmatter with support for arrays and nested objects
+ */
+export declare function parseScaffoldFrontMatter(content: string): {
+    frontMatter: ParsedScaffoldFrontmatter | null;
+    body: string;
+};
+/**
+ * Get the document name from frontmatter (works for both v1 and v2)
+ */
+export declare function getDocumentName(content: string): string | null;
+/**
+ * Check if content is v2 scaffold format
+ */
+export declare function isScaffoldContent(content: string): boolean;
+//# sourceMappingURL=frontMatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontMatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontMatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAuB,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE1G;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IAEzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,yBAAyB,GAAG,EAAE,IAAI,yBAAyB,CAElH;AAID;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBlE;AA2BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA0BnG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAahF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,CAKvD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY5E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAC5C,CAAC,CAiBD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG;IACzD,WAAW,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd,CA+GA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG1D"}