cc-agentic-framework 1.14.1

package/dist/lib/boundary-validator.js

@@ -0,0 +1,494 @@
+/**
+ * Boundary Validator
+ *
+ * Validates separation between framework (publishable) and instance (deployed) zones.
+ *
+ * Rules:
+ * 1. Framework files must NOT reference instance paths (.claude/, .claude/, CLAUDE.md, routes.yml)
+ * 2. Instance files must NOT reference framework paths (framework/)
+ * 3. No hardcoded absolute paths (/Users/, /home/, C:\)
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { glob } from 'glob';
+/**
+ * Reference extractor - detects path references in various file types
+ */
+class ReferenceExtractor {
+    projectRoot;
+    // Markdown links: [text](path) - exclude external URLs
+    static MARKDOWN_LINK_REGEX = /\[([^\]]*)\]\(([^)]+)\)/g;
+    // Absolute path patterns (hardcoded)
+    static ABSOLUTE_PATH_PATTERNS = [
+        /\/Users\/[^\s"')>\]]+/g, // macOS
+        /\/home\/[^\s"')>\]]+/g, // Linux
+        /[A-Z]:\\[^\s"')>\]]+/g, // Windows
+    ];
+    // Project placeholder pattern - these are valid and should be skipped
+    static PROJECT_PLACEHOLDER = '{project}/';
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Check if a string is an external URL
+     */
+    isExternalUrl(str) {
+        return (str.startsWith('http://') ||
+            str.startsWith('https://') ||
+            str.startsWith('mailto:') ||
+            str.startsWith('ftp://'));
+    }
+    /**
+     * Check if a string looks like a file path
+     */
+    looksLikePath(str) {
+        if (!str || typeof str !== 'string')
+            return false;
+        if (this.isExternalUrl(str))
+            return false;
+        // Must contain path-like characters
+        return (str.includes('/') ||
+            str.includes('\\') ||
+            str.endsWith('.md') ||
+            str.endsWith('.json') ||
+            str.endsWith('.yml') ||
+            str.endsWith('.yaml') ||
+            str.endsWith('.ts') ||
+            str.endsWith('.js'));
+    }
+    /**
+     * Extract references from markdown file
+     */
+    extractMarkdownReferences(content, filePath, sourceZone) {
+        const references = [];
+        const lines = content.split('\n');
+        let inCodeBlock = false;
+        for (let lineNum = 0; lineNum < lines.length; lineNum++) {
+            const line = lines[lineNum];
+            // Track code blocks - skip links inside them
+            if (line.trim().startsWith('```')) {
+                inCodeBlock = !inCodeBlock;
+                continue;
+            }
+            if (inCodeBlock)
+                continue;
+            // Extract markdown links
+            const linkRegex = new RegExp(ReferenceExtractor.MARKDOWN_LINK_REGEX);
+            let match;
+            while ((match = linkRegex.exec(line)) !== null) {
+                const target = match[2].split('#')[0]; // Remove anchor
+                // Skip external URLs, anchor-only, and empty targets
+                if (!target || this.isExternalUrl(target) || target === '')
+                    continue;
+                // Skip {project}/ placeholders - these are valid and resolved during sync
+                if (target.includes(ReferenceExtractor.PROJECT_PLACEHOLDER))
+                    continue;
+                references.push({
+                    sourceFile: filePath,
+                    sourceZone,
+                    line: lineNum + 1,
+                    column: match.index,
+                    referenceType: 'markdown-link',
+                    rawReference: target,
+                    resolvedPath: this.resolvePath(target, filePath),
+                    targetZone: null, // Will be set later
+                });
+            }
+            // Extract absolute paths (even in text)
+            for (const pattern of ReferenceExtractor.ABSOLUTE_PATH_PATTERNS) {
+                const absRegex = new RegExp(pattern);
+                let absMatch;
+                while ((absMatch = absRegex.exec(line)) !== null) {
+                    references.push({
+                        sourceFile: filePath,
+                        sourceZone,
+                        line: lineNum + 1,
+                        column: absMatch.index,
+                        referenceType: 'absolute-path',
+                        rawReference: absMatch[0],
+                        resolvedPath: absMatch[0],
+                        targetZone: null,
+                    });
+                }
+            }
+        }
+        return references;
+    }
+    /**
+     * Extract references from JSON file
+     */
+    extractJsonReferences(content, filePath, sourceZone) {
+        const references = [];
+        try {
+            const lines = content.split('\n');
+            // Simple approach: scan each line for path-like strings
+            for (let lineNum = 0; lineNum < lines.length; lineNum++) {
+                const line = lines[lineNum];
+                // Look for string values that look like paths
+                const stringMatch = /"([^"]+)"/g;
+                let match;
+                while ((match = stringMatch.exec(line)) !== null) {
+                    const value = match[1];
+                    if (this.looksLikePath(value)) {
+                        references.push({
+                            sourceFile: filePath,
+                            sourceZone,
+                            line: lineNum + 1,
+                            column: match.index,
+                            referenceType: 'json-path',
+                            rawReference: value,
+                            resolvedPath: this.resolvePath(value, filePath),
+                            targetZone: null,
+                        });
+                    }
+                }
+                // Also check for absolute paths
+                for (const pattern of ReferenceExtractor.ABSOLUTE_PATH_PATTERNS) {
+                    const absRegex = new RegExp(pattern);
+                    let absMatch;
+                    while ((absMatch = absRegex.exec(line)) !== null) {
+                        references.push({
+                            sourceFile: filePath,
+                            sourceZone,
+                            line: lineNum + 1,
+                            column: absMatch.index,
+                            referenceType: 'absolute-path',
+                            rawReference: absMatch[0],
+                            resolvedPath: absMatch[0],
+                            targetZone: null,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Invalid JSON, skip
+        }
+        return references;
+    }
+    /**
+     * Extract references from YAML file
+     */
+    extractYamlReferences(content, filePath, sourceZone) {
+        const references = [];
+        const lines = content.split('\n');
+        for (let lineNum = 0; lineNum < lines.length; lineNum++) {
+            const line = lines[lineNum];
+            // Look for path-like values (with slashes or file extensions)
+            const pathPattern = /:\s*['"]?([^\s'"#]+(?:\/[^\s'"#]*|\.(?:md|json|yml|yaml|ts|js)))['"]?/;
+            const match = pathPattern.exec(line);
+            if (match && !this.isExternalUrl(match[1])) {
+                references.push({
+                    sourceFile: filePath,
+                    sourceZone,
+                    line: lineNum + 1,
+                    column: match.index,
+                    referenceType: 'yaml-path',
+                    rawReference: match[1],
+                    resolvedPath: this.resolvePath(match[1], filePath),
+                    targetZone: null,
+                });
+            }
+            // Check for absolute paths
+            for (const pattern of ReferenceExtractor.ABSOLUTE_PATH_PATTERNS) {
+                const absRegex = new RegExp(pattern);
+                let absMatch;
+                while ((absMatch = absRegex.exec(line)) !== null) {
+                    references.push({
+                        sourceFile: filePath,
+                        sourceZone,
+                        line: lineNum + 1,
+                        column: absMatch.index,
+                        referenceType: 'absolute-path',
+                        rawReference: absMatch[0],
+                        resolvedPath: absMatch[0],
+                        targetZone: null,
+                    });
+                }
+            }
+        }
+        return references;
+    }
+    /**
+     * Resolve a reference path to an absolute path
+     */
+    resolvePath(reference, sourceFile) {
+        try {
+            // URL decode
+            let targetPath = decodeURIComponent(reference);
+            // Remove anchor fragments
+            targetPath = targetPath.split('#')[0];
+            if (!targetPath)
+                return null;
+            // Already absolute
+            if (path.isAbsolute(targetPath)) {
+                return targetPath;
+            }
+            // Project-relative (starts with /)
+            if (targetPath.startsWith('/')) {
+                return path.join(this.projectRoot, targetPath.slice(1));
+            }
+            // Relative path
+            const sourceDir = path.dirname(sourceFile);
+            return path.resolve(sourceDir, targetPath);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Main Boundary Validator class
+ */
+export class BoundaryValidator {
+    projectRoot;
+    extractor;
+    frameworkPath;
+    instancePaths;
+    constructor(projectRoot, options) {
+        this.projectRoot = projectRoot;
+        this.extractor = new ReferenceExtractor(projectRoot);
+        this.frameworkPath = options?.frameworkPath || 'framework/';
+        this.instancePaths = options?.instancePaths || [
+            '.claude/',
+            '.claude/',
+            'docs/',
+            'CLAUDE.md',
+            'routes.yml',
+        ];
+    }
+    /**
+     * Classify which zone a file belongs to
+     */
+    classifyZone(filePath) {
+        const relativePath = path.relative(this.projectRoot, filePath);
+        // Framework zone
+        if (relativePath.startsWith(this.frameworkPath)) {
+            return 'framework';
+        }
+        // Instance zone
+        for (const instancePath of this.instancePaths) {
+            const normalizedInstance = instancePath.replace(/\/$/, '');
+            if (relativePath.startsWith(instancePath) ||
+                relativePath === normalizedInstance) {
+                return 'instance';
+            }
+        }
+        // Default to framework for other files
+        return 'framework';
+    }
+    /**
+     * Get files to scan based on glob patterns
+     */
+    async getFilesToScan(patterns) {
+        const patternArray = Array.isArray(patterns) ? patterns : [patterns];
+        const files = [];
+        for (const pattern of patternArray) {
+            const matches = await glob(pattern, {
+                cwd: this.projectRoot,
+                absolute: true,
+                ignore: ['**/node_modules/**', '**/.git/**'],
+            });
+            files.push(...matches);
+        }
+        return [...new Set(files)]; // Deduplicate
+    }
+    /**
+     * Extract all references from a file
+     */
+    async extractReferences(filePath) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const ext = path.extname(filePath).toLowerCase();
+        const sourceZone = this.classifyZone(filePath);
+        switch (ext) {
+            case '.md':
+                return this.extractor.extractMarkdownReferences(content, filePath, sourceZone);
+            case '.json':
+                return this.extractor.extractJsonReferences(content, filePath, sourceZone);
+            case '.yml':
+            case '.yaml':
+                return this.extractor.extractYamlReferences(content, filePath, sourceZone);
+            default:
+                return [];
+        }
+    }
+    /**
+     * Check if a path reference appears to be a documentation example.
+     *
+     * Documentation examples (in ANTI-PATTERNS.md, QUICK-REFERENCE.md, etc.)
+     * intentionally show absolute paths to teach correct MCP tool usage.
+     * These are not actual references and should not be flagged.
+     */
+    isDocumentationExample(ref) {
+        const fileName = path.basename(ref.sourceFile).toLowerCase();
+        // Files that commonly contain intentional absolute path examples
+        const documentationFiles = ['anti-patterns.md', 'quick-reference.md', 'tools-reference.md', 'examples.md'];
+        // Only skip if BOTH in a documentation file AND matches example patterns
+        // This prevents false positives in regular files that happen to contain /Users/anton/
+        if (documentationFiles.includes(fileName)) {
+            // Generic patterns that indicate documentation examples
+            // These show paths like `/Users/anton/project/...` as teaching examples
+            const examplePatterns = [
+                /\/Users\/anton\//, // Generic example user
+                /\/Users\/\.\.\./, // Truncated example path
+            ];
+            return examplePatterns.some(pattern => pattern.test(ref.rawReference));
+        }
+        return false;
+    }
+    /**
+     * Check if a reference violates boundary rules
+     */
+    checkViolation(ref) {
+        // Skip {project}/ placeholders - these are valid and resolved during sync
+        if (ref.rawReference.includes('{project}/')) {
+            return null;
+        }
+        // Rule 1: Hardcoded absolute paths (any zone)
+        if (ref.referenceType === 'absolute-path') {
+            // Skip absolute paths that point to current project root - these are valid after sync
+            // Instance files (.claude/, .claude/) should have current project paths after sync
+            if (ref.sourceZone === 'instance' && ref.rawReference.startsWith(this.projectRoot)) {
+                return null;
+            }
+            // Skip if the path is a documentation example (contains backticks or is in a table)
+            // These are teaching examples, not actual references
+            if (this.isDocumentationExample(ref)) {
+                return null;
+            }
+            return {
+                reference: ref,
+                rule: 'hardcoded-absolute',
+                message: `Hardcoded absolute path: ${ref.rawReference}`,
+                severity: 'error',
+            };
+        }
+        // Need resolved path for zone checking
+        if (!ref.resolvedPath)
+            return null;
+        // Get relative path from project root
+        let relativePath;
+        try {
+            relativePath = path.relative(this.projectRoot, ref.resolvedPath);
+        }
+        catch {
+            return null;
+        }
+        // External references (outside project) are OK
+        if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
+            return null;
+        }
+        // Classify target zone
+        const targetZone = this.classifyZone(ref.resolvedPath);
+        // Update reference with target zone
+        ref.targetZone = targetZone;
+        // Rule 2: Framework to Instance
+        if (ref.sourceZone === 'framework' && targetZone === 'instance') {
+            return {
+                reference: ref,
+                rule: 'framework-to-instance',
+                message: `Framework file references instance path: ${relativePath}`,
+                severity: 'error',
+            };
+        }
+        // Rule 3: Instance to Framework
+        if (ref.sourceZone === 'instance' && targetZone === 'framework') {
+            return {
+                reference: ref,
+                rule: 'instance-to-framework',
+                message: `Instance file references framework path: ${relativePath}`,
+                severity: 'error',
+            };
+        }
+        return null;
+    }
+    /**
+     * Validate all files in the project for boundary violations
+     */
+    async validateProject() {
+        const violations = [];
+        let filesScanned = 0;
+        let referencesChecked = 0;
+        // Scan framework files
+        const frameworkFiles = await this.getFilesToScan([
+            'framework/**/*.md',
+            'framework/**/*.json',
+            'framework/**/*.yml',
+            'framework/**/*.yaml',
+        ]);
+        // Scan instance files
+        const instanceFiles = await this.getFilesToScan([
+            '.claude/**/*.md',
+            '.claude/**/*.md',
+            '.claude/**/*.json',
+            'CLAUDE.md',
+            'routes.yml',
+        ]);
+        const allFiles = [...frameworkFiles, ...instanceFiles];
+        for (const filePath of allFiles) {
+            try {
+                filesScanned++;
+                const references = await this.extractReferences(filePath);
+                for (const ref of references) {
+                    referencesChecked++;
+                    const violation = this.checkViolation(ref);
+                    if (violation) {
+                        violations.push(violation);
+                    }
+                }
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+        return {
+            valid: violations.length === 0,
+            violations,
+            stats: {
+                filesScanned,
+                referencesChecked,
+                frameworkViolations: violations.filter((v) => v.rule === 'framework-to-instance').length,
+                instanceViolations: violations.filter((v) => v.rule === 'instance-to-framework').length,
+                absolutePathViolations: violations.filter((v) => v.rule === 'hardcoded-absolute').length,
+            },
+        };
+    }
+    /**
+     * Format violations as a human-readable report
+     */
+    formatReport(result) {
+        const lines = [];
+        lines.push('=== BOUNDARY VALIDATION REPORT ===');
+        lines.push(`Files Scanned: ${result.stats.filesScanned}`);
+        lines.push(`References Checked: ${result.stats.referencesChecked}`);
+        lines.push('');
+        lines.push('Violations by Type:');
+        lines.push(`  Framework→Instance: ${result.stats.frameworkViolations}`);
+        lines.push(`  Instance→Framework: ${result.stats.instanceViolations}`);
+        lines.push(`  Hardcoded Absolute: ${result.stats.absolutePathViolations}`);
+        if (result.violations.length > 0) {
+            lines.push('');
+            lines.push('Violations:');
+            // Group by file
+            const byFile = new Map();
+            for (const v of result.violations) {
+                const file = path.relative(this.projectRoot, v.reference.sourceFile);
+                const existing = byFile.get(file);
+                if (existing) {
+                    existing.push(v);
+                }
+                else {
+                    byFile.set(file, [v]);
+                }
+            }
+            for (const [file, fileViolations] of byFile) {
+                lines.push(`  ${file}:`);
+                for (const v of fileViolations) {
+                    lines.push(`    L${v.reference.line}: [${v.rule}] ${v.message}`);
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=boundary-validator.js.map

package/dist/lib/boundary-validator.js.map

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

package/dist/lib/build/build-engine.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Build Engine - Unified validation for framework artifacts
+ *
+ * Provides compile-time-like validation for markdown files with YAML frontmatter.
+ * Consolidates schema validation, link checking, and cross-reference verification.
+ *
+ * @module build/build-engine
+ */
+/**
+ * Build error with file location
+ */
+export interface BuildError {
+    /** Error severity */
+    severity: "error" | "warning";
+    /** Error code for categorization */
+    code: string;
+    /** Human-readable message */
+    message: string;
+    /** File path (relative to project root) */
+    file: string;
+    /** Line number (1-indexed, if available) */
+    line?: number;
+    /** Column number (if available) */
+    column?: number;
+    /** Field path for schema errors */
+    field?: string;
+    /** Suggested fix */
+    suggestion?: string;
+}
+/**
+ * Build result summary
+ */
+export interface BuildResult {
+    /** Whether build passed (no errors) */
+    success: boolean;
+    /** Total errors found */
+    errorCount: number;
+    /** Total warnings found */
+    warningCount: number;
+    /** All errors and warnings */
+    issues: BuildError[];
+    /** Validation statistics */
+    stats: {
+        agentsChecked: number;
+        skillsChecked: number;
+        linksChecked: number;
+        filesChecked: number;
+        capabilitiesValidated: number;
+    };
+    /** Duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Build options
+ */
+export interface BuildOptions {
+    /** Project root path */
+    projectPath: string;
+    /** Framework source path (for self-dev projects) */
+    frameworkPath?: string;
+    /** Check external links (slower) */
+    externalLinks?: boolean;
+    /** Quick mode - schema validation only */
+    quick?: boolean;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Generate JSON schemas for IDE */
+    emitSchemas?: boolean;
+    /** Output directory for generated schemas */
+    schemaOutputDir?: string;
+}
+/**
+ * Build Engine - main entry point for framework validation
+ */
+export declare class BuildEngine {
+    private readonly projectPath;
+    private readonly frameworkPath;
+    private readonly options;
+    private readonly issues;
+    private agents;
+    private skills;
+    private providedCapabilities;
+    constructor(options: BuildOptions);
+    /**
+     * Run the full build process
+     */
+    build(): Promise<BuildResult>;
+    /**
+     * Validate all agent frontmatter schemas
+     */
+    private validateAgentSchemas;
+    /**
+     * Validate a single agent file
+     */
+    private validateAgentFile;
+    /**
+     * Validate all skill frontmatter schemas
+     */
+    private validateSkillSchemas;
+    /**
+     * Validate a single skill file
+     */
+    private validateSkillFile;
+    /**
+     * Validate cross-references between agents and skills
+     */
+    private validateCrossReferences;
+    /**
+     * Find similar capability names for suggestions
+     */
+    private findSimilarCapabilities;
+    /**
+     * Simple Levenshtein distance for typo detection
+     */
+    private levenshteinDistance;
+    /**
+     * Validate markdown links
+     */
+    private validateLinks;
+    /**
+     * Generate JSON schemas for IDE integration
+     */
+    private emitJsonSchemas;
+    /**
+     * Convert Zod errors to build errors
+     */
+    private addZodErrors;
+    /**
+     * Get suggestion for Zod validation error
+     * Updated for Zod v4 - issue types are no longer exported
+     */
+    private getZodSuggestion;
+    /**
+     * Add an error to the issues list
+     */
+    private addError;
+}
+/**
+ * Format build results for console output
+ */
+export declare function formatBuildOutput(result: BuildResult, verbose: boolean): string;
+//# sourceMappingURL=build-engine.d.ts.map

package/dist/lib/build/build-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-engine.d.ts","sourceRoot":"","sources":["../../../src/lib/build/build-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,4BAA4B;IAC5B,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoBD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAG3C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,oBAAoB,CAAqB;gBAErC,OAAO,EAAE,YAAY;IAQjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAsDnC;;OAEG;YACW,oBAAoB;IAiBlC;;OAEG;YACW,iBAAiB;IAwC/B;;OAEG;YACW,oBAAoB;IAiBlC;;OAEG;YACW,iBAAiB;IA0C/B;;OAEG;YACW,uBAAuB;IA+CrC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;OAEG;YACW,aAAa;IA4C3B;;OAEG;YACW,eAAe;IA8D7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAGjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,GACf,MAAM,CAgFR"}