specweave 0.28.68 → 0.29.0

package/dist/src/core/discrepancy/increment-generator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Discrepancy to Increment Generator
+ *
+ * Converts brownfield discrepancies into actionable increments.
+ */
+import { Logger } from '../../utils/logger.js';
+import { BrownfieldDiscrepancy } from './brownfield-types.js';
+/**
+ * Options for generating an increment from discrepancies
+ */
+export interface GenerateIncrementOptions {
+    discrepancyIds: string[];
+    projectPath: string;
+    incrementTitle?: string;
+    logger?: Logger;
+}
+/**
+ * Result of increment generation
+ */
+export interface GenerateIncrementResult {
+    success: boolean;
+    incrementId: string;
+    incrementPath: string;
+    discrepanciesLinked: number;
+    error?: string;
+}
+/**
+ * Generate an increment spec from discrepancies
+ */
+export declare function generateSpecFromDiscrepancies(discrepancies: BrownfieldDiscrepancy[], incrementId: string, incrementTitle?: string): Promise<string>;
+/**
+ * Link discrepancies to an increment
+ */
+export declare function linkDiscrepanciesToIncrement(projectPath: string, discrepancyIds: string[], incrementId: string, options?: {
+    logger?: Logger;
+}): Promise<number>;
+/**
+ * Resolve discrepancies when increment is completed
+ */
+export declare function resolveDiscrepanciesOnCompletion(projectPath: string, incrementId: string, options?: {
+    logger?: Logger;
+}): Promise<number>;
+/**
+ * Get the next increment ID for documentation improvements
+ */
+export declare function getNextIncrementId(projectPath: string): string;
+/**
+ * Generate increment from discrepancies
+ */
+export declare function generateIncrementFromDiscrepancies(options: GenerateIncrementOptions): Promise<GenerateIncrementResult>;
+//# sourceMappingURL=increment-generator.d.ts.map

package/dist/src/core/discrepancy/increment-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"increment-generator.d.ts","sourceRoot":"","sources":["../../../../src/core/discrepancy/increment-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,qBAAqB,EAAE,EACtC,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAgFjB;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiB9D;AAED;;GAEG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAoGlC"}

package/dist/src/core/discrepancy/increment-generator.js

@@ -0,0 +1,234 @@
+/**
+ * Discrepancy to Increment Generator
+ *
+ * Converts brownfield discrepancies into actionable increments.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { consoleLogger } from '../../utils/logger.js';
+import { BrownfieldDiscrepancyManager } from './brownfield-manager.js';
+/**
+ * Generate an increment spec from discrepancies
+ */
+export async function generateSpecFromDiscrepancies(discrepancies, incrementId, incrementTitle) {
+    // Group by module
+    const byModule = new Map();
+    for (const disc of discrepancies) {
+        const module = disc.module || 'unknown';
+        if (!byModule.has(module)) {
+            byModule.set(module, []);
+        }
+        byModule.get(module).push(disc);
+    }
+    const modules = Array.from(byModule.keys());
+    const primaryModule = modules[0];
+    const title = incrementTitle || `Documentation Improvement: ${primaryModule}`;
+    // Build discrepancy table
+    const discTable = discrepancies.map(d => `| ${d.id} | ${d.type} | ${d.priority} | ${d.summary.slice(0, 50)}${d.summary.length > 50 ? '...' : ''} |`).join('\n');
+    // Build acceptance criteria
+    const acs = discrepancies.map((d, i) => `- [ ] **AC-US1-${String(i + 1).padStart(2, '0')}**: ${d.summary} (${d.id})`).join('\n');
+    // Build affected files section
+    const affectedFiles = discrepancies
+        .filter(d => d.codeLocation)
+        .map(d => `- \`${d.codeLocation}\` (${d.id})`)
+        .join('\n');
+    const spec = `---
+increment: ${incrementId}
+status: planning
+type: documentation
+created: ${new Date().toISOString().split('T')[0]}
+---
+
+# ${title}
+
+## Context
+
+This increment addresses documentation gaps detected during brownfield analysis.
+
+### Source Discrepancies
+
+| ID | Type | Priority | Summary |
+|----|------|----------|---------|
+${discTable}
+
+## User Stories
+
+### US-001: Document ${primaryModule} Module
+
+**As a** new developer joining the team,
+**I want** comprehensive documentation for the ${primaryModule} module,
+**So that** I can understand and contribute to this area of the codebase.
+
+#### Acceptance Criteria
+
+${acs}
+
+## Technical Notes
+
+### Affected Files
+
+${affectedFiles || 'No specific files identified.'}
+
+### Linked Discrepancies
+
+${discrepancies.map(d => `- **${d.id}**: ${d.type} - ${d.summary}`).join('\n')}
+
+## Success Criteria
+
+- All acceptance criteria marked complete
+- Documentation reviewed by at least one team member
+- No new discrepancies detected in this module on next analysis
+`;
+    return spec;
+}
+/**
+ * Link discrepancies to an increment
+ */
+export async function linkDiscrepanciesToIncrement(projectPath, discrepancyIds, incrementId, options = {}) {
+    const logger = options.logger ?? consoleLogger;
+    const manager = new BrownfieldDiscrepancyManager(projectPath, { logger });
+    let linked = 0;
+    for (const id of discrepancyIds) {
+        try {
+            const success = await manager.linkToIncrement(id, incrementId);
+            if (success) {
+                linked++;
+                logger.log(`Linked ${id} to increment ${incrementId}`);
+            }
+            else {
+                logger.warn(`Discrepancy ${id} not found`);
+            }
+        }
+        catch (error) {
+            logger.error(`Failed to link ${id}:`, error);
+        }
+    }
+    return linked;
+}
+/**
+ * Resolve discrepancies when increment is completed
+ */
+export async function resolveDiscrepanciesOnCompletion(projectPath, incrementId, options = {}) {
+    const logger = options.logger ?? consoleLogger;
+    const manager = new BrownfieldDiscrepancyManager(projectPath, { logger });
+    // Find all discrepancies linked to this increment
+    const discrepancies = await manager.listDiscrepancies({
+        incrementId,
+        status: 'in-progress',
+    });
+    let resolved = 0;
+    for (const disc of discrepancies) {
+        try {
+            await manager.resolveDiscrepancy(disc.id, {
+                type: 'doc-updated',
+                resolvedAt: new Date().toISOString(),
+                resolvedBy: 'increment-completion',
+                notes: `Resolved via increment ${incrementId}`,
+            });
+            resolved++;
+            logger.log(`Resolved ${disc.id}`);
+        }
+        catch (error) {
+            logger.error(`Failed to resolve ${disc.id}:`, error);
+        }
+    }
+    return resolved;
+}
+/**
+ * Get the next increment ID for documentation improvements
+ */
+export function getNextIncrementId(projectPath) {
+    const incrementsDir = path.join(projectPath, '.specweave', 'increments');
+    if (!fs.existsSync(incrementsDir)) {
+        return '0001';
+    }
+    const folders = fs.readdirSync(incrementsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory() && /^\d{4}-/.test(d.name))
+        .map(d => parseInt(d.name.slice(0, 4), 10));
+    if (folders.length === 0) {
+        return '0001';
+    }
+    const maxId = Math.max(...folders);
+    return String(maxId + 1).padStart(4, '0');
+}
+/**
+ * Generate increment from discrepancies
+ */
+export async function generateIncrementFromDiscrepancies(options) {
+    const logger = options.logger ?? consoleLogger;
+    const manager = new BrownfieldDiscrepancyManager(options.projectPath, { logger });
+    try {
+        // Load discrepancies
+        const discrepancies = [];
+        for (const id of options.discrepancyIds) {
+            const disc = await manager.getDiscrepancy(id);
+            if (disc) {
+                if (disc.status !== 'pending') {
+                    logger.warn(`Discrepancy ${id} is not in pending status (${disc.status})`);
+                }
+                discrepancies.push(disc);
+            }
+            else {
+                logger.warn(`Discrepancy ${id} not found`);
+            }
+        }
+        if (discrepancies.length === 0) {
+            return {
+                success: false,
+                incrementId: '',
+                incrementPath: '',
+                discrepanciesLinked: 0,
+                error: 'No valid discrepancies found',
+            };
+        }
+        // Determine module name and generate increment ID
+        const primaryModule = discrepancies[0].module.replace(/[^a-z0-9-]/gi, '-').toLowerCase();
+        const incrementNum = getNextIncrementId(options.projectPath);
+        const incrementId = `${incrementNum}-${primaryModule}-docs`;
+        // Create increment directory
+        const incrementPath = path.join(options.projectPath, '.specweave', 'increments', incrementId);
+        fs.mkdirSync(incrementPath, { recursive: true });
+        // Generate and write spec.md
+        const specContent = await generateSpecFromDiscrepancies(discrepancies, incrementId, options.incrementTitle);
+        fs.writeFileSync(path.join(incrementPath, 'spec.md'), specContent);
+        // Create metadata.json
+        const metadata = {
+            incrementId,
+            title: options.incrementTitle || `Documentation: ${primaryModule}`,
+            status: 'planning',
+            type: 'documentation',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            linkedDiscrepancies: options.discrepancyIds,
+            userStories: [
+                {
+                    id: 'US-001',
+                    title: `Document ${primaryModule} module`,
+                    status: 'pending',
+                },
+            ],
+        };
+        fs.writeFileSync(path.join(incrementPath, 'metadata.json'), JSON.stringify(metadata, null, 2));
+        // Link discrepancies to increment
+        const linked = await linkDiscrepanciesToIncrement(options.projectPath, options.discrepancyIds, incrementId, { logger });
+        logger.log(`Created increment ${incrementId} with ${linked} discrepancies`);
+        return {
+            success: true,
+            incrementId,
+            incrementPath,
+            discrepanciesLinked: linked,
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.error('Failed to generate increment:', error);
+        return {
+            success: false,
+            incrementId: '',
+            incrementPath: '',
+            discrepanciesLinked: 0,
+            error: errorMsg,
+        };
+    }
+}
+//# sourceMappingURL=increment-generator.js.map

package/dist/src/core/discrepancy/increment-generator.js.map

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

package/dist/src/core/discrepancy/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Code-to-Spec Discrepancy Detection
+ *
+ * Detects discrepancies between code and specifications.
+ * Core principle: CODE is source of truth.
+ *
+ * @module core/discrepancy
+ */
+export { TypeScriptAnalyzer, type FunctionSignature, type FunctionParam, type TypeDefinition, type TypeScriptAnalyzerConfig, type AnalysisResult, } from './analyzers/typescript-analyzer.js';
+export { ApiRouteAnalyzer, type ApiRoute, type HttpMethod, type ApiRouteAnalyzerConfig, type RouteAnalysisResult, } from './analyzers/api-route-analyzer.js';
+export { SpecParser, type ParsedSpec, type SpecType, type SpecParserConfig, type SpecParseResult, } from './spec-parser.js';
+export { DiscrepancyDetector, type Discrepancy, type DiscrepancyType, type DiscrepancyCategory, type DiscrepancySeverity, type DiscrepancyRecommendation, type CodeSignatures, type DetectionResult, } from './detector.js';
+export { SeverityClassifier, type ChangeDetails, type ClassificationResult, type SeverityClassifierConfig, } from './severity-classifier.js';
+export { UpdateRecommender, type UpdatePatch, type RecommendationResult, type UpdateRecommenderConfig, } from './update-recommender.js';
+export type { BrownfieldDiscrepancyType, BrownfieldDiscrepancyStatus, BrownfieldDiscrepancyPriority, BrownfieldDiscrepancySource, BrownfieldResolutionType, BrownfieldDiscrepancyEvidence, BrownfieldDiscrepancyResolution, BrownfieldDiscrepancy, BrownfieldDiscrepancyStats, BrownfieldDiscrepancyIndex, BrownfieldDiscrepancyFilter, BrownfieldDiscrepancyCreate, BrownfieldDiscrepancyUpdate, } from './brownfield-types.js';
+export { BrownfieldDiscrepancyManager } from './brownfield-manager.js';
+export { generateSpecFromDiscrepancies, linkDiscrepanciesToIncrement, resolveDiscrepanciesOnCompletion, getNextIncrementId, generateIncrementFromDiscrepancies, type GenerateIncrementOptions, type GenerateIncrementResult, } from './increment-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/discrepancy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/discrepancy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,GACpB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,UAAU,EACV,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,EAC/B,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,gCAAgC,EAChC,kBAAkB,EAClB,kCAAkC,EAClC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC"}

package/dist/src/core/discrepancy/index.js

@@ -0,0 +1,24 @@
+/**
+ * Code-to-Spec Discrepancy Detection
+ *
+ * Detects discrepancies between code and specifications.
+ * Core principle: CODE is source of truth.
+ *
+ * @module core/discrepancy
+ */
+// Analyzers
+export { TypeScriptAnalyzer, } from './analyzers/typescript-analyzer.js';
+export { ApiRouteAnalyzer, } from './analyzers/api-route-analyzer.js';
+// Spec Parser
+export { SpecParser, } from './spec-parser.js';
+// Detector
+export { DiscrepancyDetector, } from './detector.js';
+// Severity Classifier
+export { SeverityClassifier, } from './severity-classifier.js';
+// Update Recommender
+export { UpdateRecommender, } from './update-recommender.js';
+// Brownfield Discrepancy Manager
+export { BrownfieldDiscrepancyManager } from './brownfield-manager.js';
+// Increment Generator (discrepancy → increment conversion)
+export { generateSpecFromDiscrepancies, linkDiscrepanciesToIncrement, resolveDiscrepanciesOnCompletion, getNextIncrementId, generateIncrementFromDiscrepancies, } from './increment-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/discrepancy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/discrepancy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY;AACZ,OAAO,EACL,kBAAkB,GAMnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,gBAAgB,GAKjB,MAAM,mCAAmC,CAAC;AAE3C,cAAc;AACd,OAAO,EACL,UAAU,GAKX,MAAM,kBAAkB,CAAC;AAE1B,WAAW;AACX,OAAO,EACL,mBAAmB,GAQpB,MAAM,eAAe,CAAC;AAEvB,sBAAsB;AACtB,OAAO,EACL,kBAAkB,GAInB,MAAM,0BAA0B,CAAC;AAElC,qBAAqB;AACrB,OAAO,EACL,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AAmBjC,iCAAiC;AACjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAEvE,2DAA2D;AAC3D,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,gCAAgC,EAChC,kBAAkB,EAClB,kCAAkC,GAGnC,MAAM,0BAA0B,CAAC"}

package/dist/src/core/discrepancy/severity-classifier.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Severity Classifier
+ *
+ * Classifies discrepancy severity to determine appropriate action.
+ * Conservative by default: when uncertain, classify higher severity.
+ *
+ * @module core/discrepancy/severity-classifier
+ */
+import { Logger } from '../../utils/logger.js';
+/**
+ * Severity levels for discrepancies.
+ */
+export type DiscrepancySeverity = 'trivial' | 'minor' | 'major' | 'breaking';
+/**
+ * Category of change.
+ */
+export type ChangeCategory = 'added' | 'removed' | 'modified';
+/**
+ * Type of item that changed.
+ */
+export type ItemType = 'api-route' | 'function-signature' | 'type-definition';
+/**
+ * Details about a change for classification.
+ */
+export interface ChangeDetails {
+    category: ChangeCategory;
+    itemType: ItemType;
+    specValue: string;
+    codeValue: string;
+    description?: string;
+}
+/**
+ * Classification result with reasoning.
+ */
+export interface ClassificationResult {
+    severity: DiscrepancySeverity;
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Configuration for severity classification.
+ */
+export interface SeverityClassifierConfig {
+    /** Be conservative: when uncertain, classify higher */
+    conservative?: boolean;
+    /** Treat all removals as breaking */
+    strictRemovals?: boolean;
+}
+/**
+ * Classifies discrepancy severity based on change type and details.
+ */
+export declare class SeverityClassifier {
+    private readonly logger;
+    private readonly config;
+    constructor(options?: {
+        logger?: Logger;
+        config?: SeverityClassifierConfig;
+    });
+    /**
+     * Classify the severity of a discrepancy.
+     */
+    classify(change: ChangeDetails): ClassificationResult;
+    private classifyRemoval;
+    private classifyAddition;
+    private classifyModification;
+    private isTrivialChange;
+    private normalize;
+    private isBreakingSignatureChange;
+    private hasFewerParams;
+    private getBreakingChangeReason;
+    private classifyApiRouteChange;
+    private classifyFunctionChange;
+    private extractPath;
+    private isVersionChange;
+    private isPathStructureChange;
+    /**
+     * Map severity to recommended action.
+     */
+    getRecommendation(severity: DiscrepancySeverity): 'auto-update' | 'review-required' | 'notify' | 'alert';
+}
+//# sourceMappingURL=severity-classifier.d.ts.map

package/dist/src/core/discrepancy/severity-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity-classifier.d.ts","sourceRoot":"","sources":["../../../../src/core/discrepancy/severity-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAEhD,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,wBAAwB,CAAA;KAAO;IAQhF;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,oBAAoB;IAerD,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,yBAAyB;IAqBjC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,sBAAsB;IA8B9B,OAAO,CAAC,sBAAsB;IA4B9B,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,aAAa,GAAG,iBAAiB,GAAG,QAAQ,GAAG,OAAO;CAYzG"}