specweave 2.2.3 → 3.0.0

package/dist/src/core/discrepancy/severity-classifier.js

@@ -1,255 +0,0 @@
-/**
- * Severity Classifier
- *
- * Classifies discrepancy severity to determine appropriate action.
- * Conservative by default: when uncertain, classify higher severity.
- *
- * @module core/discrepancy/severity-classifier
- */
-import { consoleLogger } from '../../utils/logger.js';
-/**
- * Classifies discrepancy severity based on change type and details.
- */
-export class SeverityClassifier {
-    constructor(options = {}) {
-        this.logger = options.logger ?? consoleLogger;
-        this.config = {
-            conservative: options.config?.conservative ?? true,
-            strictRemovals: options.config?.strictRemovals ?? true,
-        };
-    }
-    /**
-     * Classify the severity of a discrepancy.
-     */
-    classify(change) {
-        // Removal = breaking (might break consumers)
-        if (change.category === 'removed') {
-            return this.classifyRemoval(change);
-        }
-        // Addition = major (new undocumented functionality)
-        if (change.category === 'added') {
-            return this.classifyAddition(change);
-        }
-        // Modification = depends on what changed
-        return this.classifyModification(change);
-    }
-    classifyRemoval(change) {
-        if (this.config.strictRemovals) {
-            return {
-                severity: 'breaking',
-                reason: `${change.itemType} removed: ${change.specValue}`,
-                confidence: 'high',
-            };
-        }
-        // Type definitions are major, all other removals are breaking
-        if (change.itemType === 'type-definition') {
-            return {
-                severity: 'major',
-                reason: `Type definition removed: ${change.specValue}`,
-                confidence: 'medium',
-            };
-        }
-        const itemLabels = {
-            'api-route': 'API route',
-            'function-signature': 'Exported function',
-            'type-definition': 'Type definition',
-        };
-        return {
-            severity: 'breaking',
-            reason: `${itemLabels[change.itemType]} removed: ${change.specValue}`,
-            confidence: 'high',
-        };
-    }
-    classifyAddition(change) {
-        // Types are minor (usually supporting types), all others are major
-        if (change.itemType === 'type-definition') {
-            return {
-                severity: 'minor',
-                reason: `New type definition not documented: ${change.codeValue}`,
-                confidence: 'medium',
-            };
-        }
-        const itemLabels = {
-            'api-route': 'API route',
-            'function-signature': 'exported function',
-            'type-definition': 'type definition',
-        };
-        return {
-            severity: 'major',
-            reason: `New ${itemLabels[change.itemType]} not documented: ${change.codeValue}`,
-            confidence: 'high',
-        };
-    }
-    classifyModification(change) {
-        const description = change.description?.toLowerCase() ?? '';
-        // Check for trivial changes
-        if (this.isTrivialChange(change.specValue, change.codeValue, description)) {
-            return {
-                severity: 'trivial',
-                reason: 'Minor formatting or documentation change',
-                confidence: 'high',
-            };
-        }
-        // Check for breaking signature changes
-        if (this.isBreakingSignatureChange(change)) {
-            return {
-                severity: 'breaking',
-                reason: this.getBreakingChangeReason(change),
-                confidence: 'high',
-            };
-        }
-        // API route path changes
-        if (change.itemType === 'api-route') {
-            return this.classifyApiRouteChange(change);
-        }
-        // Function signature changes
-        if (change.itemType === 'function-signature') {
-            return this.classifyFunctionChange(change);
-        }
-        // Default to minor for modifications
-        return {
-            severity: this.config.conservative ? 'minor' : 'trivial',
-            reason: 'Modification detected',
-            confidence: 'low',
-        };
-    }
-    isTrivialChange(specValue, codeValue, description) {
-        // If normalized values are same, it's just formatting
-        if (this.normalize(specValue) === this.normalize(codeValue)) {
-            return true;
-        }
-        // Check for typo indicators in description
-        return description.includes('typo') || description.includes('whitespace');
-    }
-    normalize(value) {
-        return value
-            .toLowerCase()
-            .replace(/\s+/g, ' ')
-            .replace(/['"]/g, '')
-            .trim();
-    }
-    isBreakingSignatureChange(change) {
-        const description = change.description?.toLowerCase() ?? '';
-        // Return type changes are breaking
-        if (description.includes('return type')) {
-            return true;
-        }
-        // Required parameter additions are breaking
-        if (description.includes('required param')) {
-            return true;
-        }
-        // Parameter removal is breaking
-        if (description.includes('parameter count') && this.hasFewerParams(change)) {
-            return true;
-        }
-        return false;
-    }
-    hasFewerParams(change) {
-        // Extract param counts from description
-        const match = change.description?.match(/spec has (\d+), code has (\d+)/);
-        if (match) {
-            const specCount = parseInt(match[1], 10);
-            const codeCount = parseInt(match[2], 10);
-            return codeCount < specCount;
-        }
-        return false;
-    }
-    getBreakingChangeReason(change) {
-        const description = change.description ?? '';
-        if (description.includes('required param')) {
-            return 'Breaking: New required parameter added';
-        }
-        if (description.includes('return type') || description.includes('parameter count')) {
-            return `Breaking: ${description}`;
-        }
-        return 'Breaking signature change detected';
-    }
-    classifyApiRouteChange(change) {
-        const specPath = this.extractPath(change.specValue);
-        const codePath = this.extractPath(change.codeValue);
-        // Version change (v1 -> v2) is major
-        if (this.isVersionChange(specPath, codePath)) {
-            return {
-                severity: 'major',
-                reason: `API version changed: ${specPath} → ${codePath}`,
-                confidence: 'high',
-            };
-        }
-        // Path structure change is major
-        if (this.isPathStructureChange(specPath, codePath)) {
-            return {
-                severity: 'major',
-                reason: `API path structure changed: ${specPath} → ${codePath}`,
-                confidence: 'medium',
-            };
-        }
-        // Param name change is minor
-        return {
-            severity: 'minor',
-            reason: `API route modified: ${change.description ?? 'path changed'}`,
-            confidence: 'medium',
-        };
-    }
-    classifyFunctionChange(change) {
-        const description = change.description?.toLowerCase() ?? '';
-        // Parameter type changes are minor (TypeScript will catch issues)
-        if (description.includes('parameter') && !description.includes('count')) {
-            return {
-                severity: 'minor',
-                reason: 'Parameter type or name changed',
-                confidence: 'medium',
-            };
-        }
-        // Optional parameter additions are minor
-        if (description.includes('optional')) {
-            return {
-                severity: 'minor',
-                reason: 'Optional parameter added',
-                confidence: 'high',
-            };
-        }
-        return {
-            severity: this.config.conservative ? 'minor' : 'trivial',
-            reason: 'Function signature modified',
-            confidence: 'low',
-        };
-    }
-    extractPath(value) {
-        // Extract path from "METHOD /path" format
-        const match = value.match(/(?:GET|POST|PUT|DELETE|PATCH)\s+(\S+)/i);
-        return match ? match[1] : value;
-    }
-    isVersionChange(specPath, codePath) {
-        const versionPattern = /\/v(\d+)\//;
-        const specVersion = specPath.match(versionPattern);
-        const codeVersion = codePath.match(versionPattern);
-        // New version added where none existed
-        if (!specVersion && codeVersion) {
-            return true;
-        }
-        // Both have versions - check if different
-        return specVersion !== null && codeVersion !== null && specVersion[1] !== codeVersion[1];
-    }
-    isPathStructureChange(specPath, codePath) {
-        // Normalize paths for comparison
-        const specParts = specPath.split('/').filter(Boolean);
-        const codeParts = codePath.split('/').filter(Boolean);
-        // Different segment count (excluding params)
-        const specSegments = specParts.filter(p => !p.startsWith(':'));
-        const codeSegments = codeParts.filter(p => !p.startsWith(':'));
-        return specSegments.length !== codeSegments.length;
-    }
-    /**
-     * Map severity to recommended action.
-     */
-    getRecommendation(severity) {
-        const actionMap = {
-            trivial: 'auto-update',
-            minor: 'review-required',
-            major: 'notify',
-            breaking: 'alert',
-        };
-        return actionMap[severity];
-    }
-}
-//# sourceMappingURL=severity-classifier.js.map

package/dist/src/core/discrepancy/severity-classifier.js.map

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

package/dist/src/core/discrepancy/spec-parser.d.ts

@@ -1,74 +0,0 @@
-/**
- * Spec Parser
- *
- * Parses living docs to extract documented API endpoints and function signatures.
- *
- * @module core/discrepancy/spec-parser
- */
-import { Logger } from '../../utils/logger.js';
-/**
- * Type of specification (API route or function).
- */
-export type SpecType = 'api' | 'function' | 'type';
-/**
- * Represents a parsed specification from living docs.
- */
-export interface ParsedSpec {
-    type: SpecType;
-    source: string;
-    lineNumber: number;
-    identifier: string;
-    description: string;
-    method?: string;
-    params?: string[];
-    returnType?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Configuration for the spec parser.
- */
-export interface SpecParserConfig {
-    /** Base path for living docs */
-    docsPath?: string;
-}
-/**
- * Result of spec parsing.
- */
-export interface SpecParseResult {
-    specs: ParsedSpec[];
-    errors: string[];
-}
-/**
- * Parses living docs to extract documented behavior.
- */
-export declare class SpecParser {
-    private readonly logger;
-    private readonly config;
-    constructor(options?: {
-        logger?: Logger;
-        config?: SpecParserConfig;
-    });
-    /**
-     * Parse all specs from the living docs directory.
-     */
-    parseAll(docsPath?: string): Promise<SpecParseResult>;
-    /**
-     * Parse a single markdown file for specs.
-     */
-    parseFile(filePath: string): Promise<SpecParseResult>;
-    /**
-     * Parse API specs from a docs path.
-     */
-    parseApiSpecs(docsPath: string): Promise<ParsedSpec[]>;
-    /**
-     * Parse function specs from a docs path.
-     */
-    parseFunctionSpecs(docsPath: string): Promise<ParsedSpec[]>;
-    private parseApiLine;
-    private parseFunctionLine;
-    private parseTypeLine;
-    private extractDescription;
-    private extractRouteParams;
-    private findMarkdownFiles;
-}
-//# sourceMappingURL=spec-parser.d.ts.map

package/dist/src/core/discrepancy/spec-parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-parser.d.ts","sourceRoot":"","sources":["../../../../src/core/discrepancy/spec-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAExC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;KAAO;IAOxE;;OAEG;IACG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA2B3D;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAyC3D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAK5D;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKjE,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,iBAAiB;CAmB1B"}

package/dist/src/core/discrepancy/spec-parser.js

@@ -1,208 +0,0 @@
-/**
- * Spec Parser
- *
- * Parses living docs to extract documented API endpoints and function signatures.
- *
- * @module core/discrepancy/spec-parser
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { consoleLogger } from '../../utils/logger.js';
-/**
- * Parses living docs to extract documented behavior.
- */
-export class SpecParser {
-    constructor(options = {}) {
-        this.logger = options.logger ?? consoleLogger;
-        this.config = {
-            docsPath: options.config?.docsPath ?? '.specweave/docs',
-        };
-    }
-    /**
-     * Parse all specs from the living docs directory.
-     */
-    async parseAll(docsPath) {
-        const basePath = docsPath ?? this.config.docsPath;
-        const specs = [];
-        const errors = [];
-        if (!fs.existsSync(basePath)) {
-            errors.push(`Docs path not found: ${basePath}`);
-            return { specs, errors };
-        }
-        // Scan for markdown files
-        const files = this.findMarkdownFiles(basePath);
-        for (const file of files) {
-            try {
-                const result = await this.parseFile(file);
-                specs.push(...result.specs);
-                errors.push(...result.errors);
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                errors.push(`Failed to parse ${file}: ${message}`);
-            }
-        }
-        return { specs, errors };
-    }
-    /**
-     * Parse a single markdown file for specs.
-     */
-    async parseFile(filePath) {
-        const specs = [];
-        const errors = [];
-        if (!fs.existsSync(filePath)) {
-            errors.push(`File not found: ${filePath}`);
-            return { specs, errors };
-        }
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const lines = content.split('\n');
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            // Parse API route documentation
-            const apiSpec = this.parseApiLine(line, i + 1, filePath);
-            if (apiSpec) {
-                // Look for description in following lines
-                apiSpec.description = this.extractDescription(lines, i + 1);
-                specs.push(apiSpec);
-            }
-            // Parse function documentation
-            const funcSpec = this.parseFunctionLine(line, i + 1, filePath);
-            if (funcSpec) {
-                funcSpec.description = this.extractDescription(lines, i + 1);
-                specs.push(funcSpec);
-            }
-            // Parse type documentation
-            const typeSpec = this.parseTypeLine(line, i + 1, filePath);
-            if (typeSpec) {
-                typeSpec.description = this.extractDescription(lines, i + 1);
-                specs.push(typeSpec);
-            }
-        }
-        return { specs, errors };
-    }
-    /**
-     * Parse API specs from a docs path.
-     */
-    async parseApiSpecs(docsPath) {
-        const result = await this.parseAll(docsPath);
-        return result.specs.filter(s => s.type === 'api');
-    }
-    /**
-     * Parse function specs from a docs path.
-     */
-    async parseFunctionSpecs(docsPath) {
-        const result = await this.parseAll(docsPath);
-        return result.specs.filter(s => s.type === 'function');
-    }
-    parseApiLine(line, lineNumber, filePath) {
-        // Pattern: ## GET /users or ### POST /api/users
-        const apiPattern = /^#{2,4}\s+(GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS)\s+(\S+)/i;
-        const match = line.match(apiPattern);
-        if (!match)
-            return null;
-        const method = match[1].toUpperCase();
-        const routePath = match[2];
-        const params = this.extractRouteParams(routePath);
-        return {
-            type: 'api',
-            source: filePath,
-            lineNumber,
-            identifier: routePath,
-            description: '',
-            method,
-            params,
-        };
-    }
-    parseFunctionLine(line, lineNumber, filePath) {
-        // Pattern: ### functionName(param1: type, param2: type): returnType
-        // Or: ### `functionName(param1, param2)`
-        const funcPattern = /^#{2,4}\s+`?(\w+)\s*\(([^)]*)\)\s*(?::\s*(\w+))?`?/;
-        const match = line.match(funcPattern);
-        if (!match)
-            return null;
-        const name = match[1];
-        const paramsStr = match[2];
-        const returnType = match[3];
-        // Parse parameters
-        const params = paramsStr
-            .split(',')
-            .map(p => p.trim())
-            .filter(p => p.length > 0);
-        return {
-            type: 'function',
-            source: filePath,
-            lineNumber,
-            identifier: name,
-            description: '',
-            params,
-            returnType,
-        };
-    }
-    parseTypeLine(line, lineNumber, filePath) {
-        // Pattern: ### interface TypeName or ### type TypeName
-        const typePattern = /^#{2,4}\s+(interface|type|class)\s+(\w+)/i;
-        const match = line.match(typePattern);
-        if (!match)
-            return null;
-        const kind = match[1].toLowerCase();
-        const name = match[2];
-        return {
-            type: 'type',
-            source: filePath,
-            lineNumber,
-            identifier: name,
-            description: '',
-            metadata: { kind },
-        };
-    }
-    extractDescription(lines, startIndex) {
-        const descriptionLines = [];
-        for (let i = startIndex; i < lines.length; i++) {
-            const line = lines[i];
-            // Stop at next heading
-            if (/^#{1,6}\s/.test(line))
-                break;
-            // Stop at empty line followed by heading
-            if (line.trim() === '' && i + 1 < lines.length && /^#{1,6}\s/.test(lines[i + 1]))
-                break;
-            // Skip empty lines at the start
-            if (descriptionLines.length === 0 && line.trim() === '')
-                continue;
-            // Add non-empty content
-            if (line.trim()) {
-                descriptionLines.push(line.trim());
-            }
-            // Stop after a few lines of description
-            if (descriptionLines.length >= 3)
-                break;
-        }
-        return descriptionLines.join(' ').slice(0, 500);
-    }
-    extractRouteParams(routePath) {
-        // Extract :param or {param} from path
-        const colonParams = routePath.match(/:([^/]+)/g) || [];
-        const braceParams = routePath.match(/\{([^}]+)\}/g) || [];
-        return [
-            ...colonParams.map(p => p.slice(1)),
-            ...braceParams.map(p => p.slice(1, -1)),
-        ];
-    }
-    findMarkdownFiles(dir) {
-        if (!fs.existsSync(dir))
-            return [];
-        const files = [];
-        const skipDirs = new Set(['node_modules', '.git', 'dist', '_archive']);
-        const entries = fs.readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const fullPath = path.join(dir, entry.name);
-            if (entry.isDirectory() && !skipDirs.has(entry.name)) {
-                files.push(...this.findMarkdownFiles(fullPath));
-            }
-            else if (entry.isFile() && entry.name.endsWith('.md')) {
-                files.push(fullPath);
-            }
-        }
-        return files;
-    }
-}
-//# sourceMappingURL=spec-parser.js.map

package/dist/src/core/discrepancy/spec-parser.js.map

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

package/dist/src/core/discrepancy/update-recommender.d.ts

@@ -1,77 +0,0 @@
-/**
- * Update Recommender
- *
- * Generates recommendations for handling discrepancies and creates update patches.
- *
- * @module core/discrepancy/update-recommender
- */
-import { Logger } from '../../utils/logger.js';
-import { Discrepancy, DiscrepancyRecommendation } from './detector.js';
-/**
- * An update patch for a spec file.
- */
-export interface UpdatePatch {
-    filePath: string;
-    lineNumber: number;
-    originalText: string;
-    newText: string;
-    reason: string;
-}
-/**
- * Recommendation with optional patch.
- */
-export interface RecommendationResult {
-    discrepancyId: string;
-    recommendation: DiscrepancyRecommendation;
-    patch?: UpdatePatch;
-    explanation: string;
-    riskLevel: 'low' | 'medium' | 'high';
-}
-/**
- * Configuration for the update recommender.
- */
-export interface UpdateRecommenderConfig {
-    /** Auto-update trivial changes */
-    autoUpdateTrivial?: boolean;
-    /** Generate patches for review-required changes */
-    generatePatches?: boolean;
-}
-/**
- * Generates recommendations for handling discrepancies.
- */
-export declare class UpdateRecommender {
-    private readonly logger;
-    private readonly config;
-    constructor(options?: {
-        logger?: Logger;
-        config?: UpdateRecommenderConfig;
-    });
-    /**
-     * Generate recommendations for a list of discrepancies.
-     */
-    recommendAll(discrepancies: Discrepancy[]): RecommendationResult[];
-    /**
-     * Generate a recommendation for a single discrepancy.
-     */
-    recommend(discrepancy: Discrepancy): RecommendationResult;
-    /**
-     * Generate an update patch for a discrepancy.
-     */
-    generatePatch(discrepancy: Discrepancy): UpdatePatch | undefined;
-    private mapSeverityToRecommendation;
-    private generateExplanation;
-    private assessRisk;
-    private shouldGeneratePatch;
-    private generateApiRoutePatch;
-    private generateFunctionPatch;
-    private generateTypePatch;
-    private generateApiDocSection;
-    private generateFunctionDocSection;
-    private generateTypeDocSection;
-    /**
-     * Generate a summary report of recommendations.
-     */
-    generateReport(recommendations: RecommendationResult[]): string;
-    private groupBy;
-}
-//# sourceMappingURL=update-recommender.d.ts.map

package/dist/src/core/discrepancy/update-recommender.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"update-recommender.d.ts","sourceRoot":"","sources":["../../../../src/core/discrepancy/update-recommender.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAuB,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,yBAAyB,CAAC;IAC1C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAE/C,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,uBAAuB,CAAA;KAAO;IAQ/E;;OAEG;IACH,YAAY,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,oBAAoB,EAAE;IAIlE;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB;IAoBzD;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS;IAkBhE,OAAO,CAAC,2BAA2B;IAUnC,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,qBAAqB;IAsC7B,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,0BAA0B;IAgBlC,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,cAAc,CAAC,eAAe,EAAE,oBAAoB,EAAE,GAAG,MAAM;IA8D/D,OAAO,CAAC,OAAO;CAWhB"}