spec-gen-cli 1.0.0

package/dist/core/analyzer/significance-scorer.js

@@ -0,0 +1,407 @@
+/**
+ * File Significance Scorer
+ *
+ * Ranks files by their likely importance to understanding system architecture.
+ * This determines what gets sent to the LLM and what gets skipped.
+ *
+ * Scoring algorithm: 0-100 points per file
+ * - Name-based scoring: 0-30 points
+ * - Path-based scoring: 0-25 points
+ * - Structure-based scoring: 0-25 points
+ * - Connectivity scoring: 0-20 points
+ */
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+// ============================================================================
+// NAME-BASED SCORING (0-30 points)
+// ============================================================================
+const HIGH_VALUE_NAMES = {
+    // Schema/model files (+25)
+    schema: 25,
+    model: 25,
+    entity: 25,
+    types: 25,
+    interfaces: 25,
+    // Auth files (+25)
+    auth: 25,
+    authentication: 25,
+    authorization: 25,
+    // API files (+25)
+    api: 25,
+    routes: 25,
+    endpoints: 25,
+    controller: 25,
+    controllers: 25,
+    // Database files (+25)
+    database: 25,
+    db: 25,
+    repository: 25,
+    store: 25,
+    // Config files (+20)
+    config: 20,
+    configuration: 20,
+    settings: 20,
+    // Middleware (+20)
+    middleware: 20,
+    interceptor: 20,
+    guard: 20,
+    // Services (+15)
+    service: 15,
+    provider: 15,
+    manager: 15,
+    // Utilities (+5)
+    utils: 5,
+    util: 5,
+    helpers: 5,
+    helper: 5,
+    common: 5,
+};
+const NEGATIVE_NAMES = {
+    // Test files (-10)
+    test: -10,
+    spec: -10,
+    mock: -10,
+    stub: -10,
+    fake: -10,
+    // Fixtures (-10)
+    fixture: -10,
+    fixtures: -10,
+    snapshot: -10,
+    snapshots: -10,
+    // Examples (-5)
+    example: -5,
+    examples: -5,
+    sample: -5,
+    samples: -5,
+    demo: -5,
+    // Deprecated (-15)
+    backup: -15,
+    old: -15,
+    deprecated: -15,
+    legacy: -15,
+};
+/**
+ * Calculate name-based score for a file
+ */
+function calculateNameScore(fileName, config) {
+    const nameLower = fileName.toLowerCase();
+    const nameWithoutExt = basename(nameLower, nameLower.substring(nameLower.lastIndexOf('.')));
+    let score = 0;
+    // Check high-value names
+    const highValueNames = { ...HIGH_VALUE_NAMES, ...config?.highValueNames };
+    for (const [pattern, points] of Object.entries(highValueNames)) {
+        if (nameWithoutExt.includes(pattern)) {
+            score = Math.max(score, points);
+        }
+    }
+    // Check negative names
+    const negativeNames = { ...NEGATIVE_NAMES, ...config?.negativeNames };
+    for (const [pattern, points] of Object.entries(negativeNames)) {
+        if (nameWithoutExt.includes(pattern)) {
+            score += points; // Negative values
+        }
+    }
+    // Clamp to valid range
+    return Math.max(0, Math.min(30, score));
+}
+// ============================================================================
+// PATH-BASED SCORING (0-25 points)
+// ============================================================================
+const HIGH_VALUE_PATHS = {
+    'src/': 10,
+    'lib/': 10,
+    'core/': 15,
+    'domain/': 15,
+    'models/': 15,
+    'api/': 15,
+    'routes/': 15,
+    'controllers/': 15,
+    'config/': 10,
+    'configs/': 10,
+    'services/': 10,
+    'schemas/': 15,
+};
+/**
+ * Calculate path-based score for a file
+ */
+function calculatePathScore(relativePath, depth, config) {
+    let score = 0;
+    // Root directory bonus
+    if (depth === 0) {
+        score += 15;
+    }
+    // Check high-value paths
+    const highValuePaths = { ...HIGH_VALUE_PATHS, ...config?.highValuePaths };
+    for (const [pattern, points] of Object.entries(highValuePaths)) {
+        if (relativePath.startsWith(pattern) || relativePath.includes('/' + pattern)) {
+            score = Math.max(score, points);
+        }
+    }
+    // Penalty for deeply nested files
+    if (depth > 5) {
+        score -= 10;
+    }
+    // Penalty for deeply nested utils/helpers
+    const pathLower = relativePath.toLowerCase();
+    if ((pathLower.includes('utils/') || pathLower.includes('helpers/')) && depth > 3) {
+        score -= 5;
+    }
+    // Clamp to valid range
+    return Math.max(0, Math.min(25, score));
+}
+// ============================================================================
+// STRUCTURE-BASED SCORING (0-25 points)
+// ============================================================================
+/**
+ * Quick content analysis patterns
+ */
+const STRUCTURE_PATTERNS = {
+    hasClass: /\bclass\s+\w+/,
+    hasInterface: /\b(interface|type)\s+\w+\s*[={<]/,
+    hasExport: /\bexport\s+(default\s+)?(class|function|const|let|var|interface|type|enum)/,
+    hasDecorator: /@\w+\s*\(/,
+    importStatement: /\bimport\s+.*from\s+['"][^'"]+['"]/g,
+};
+/**
+ * Calculate structure-based score from file content
+ */
+async function calculateStructureScore(absolutePath, lines) {
+    let score = 0;
+    try {
+        const content = await readFile(absolutePath, 'utf-8');
+        // Has class definitions (+10)
+        if (STRUCTURE_PATTERNS.hasClass.test(content)) {
+            score += 10;
+        }
+        // Has interface/type definitions (+15)
+        if (STRUCTURE_PATTERNS.hasInterface.test(content)) {
+            score += 15;
+        }
+        // Has export statements (+5)
+        if (STRUCTURE_PATTERNS.hasExport.test(content)) {
+            score += 5;
+        }
+        // Has decorators (+15)
+        if (STRUCTURE_PATTERNS.hasDecorator.test(content)) {
+            score += 15;
+        }
+        // Count import statements
+        const imports = content.match(STRUCTURE_PATTERNS.importStatement);
+        if (imports && imports.length > 10) {
+            score += 10; // Many imports = integration point
+        }
+        // File size scoring
+        if (lines >= 50 && lines <= 500) {
+            score += 5; // Sweet spot
+        }
+        else if (lines > 1000) {
+            score -= 5; // Probably generated or data file
+        }
+    }
+    catch {
+        // File read error, return 0 for structure score
+        return 0;
+    }
+    // Clamp to valid range
+    return Math.max(0, Math.min(25, score));
+}
+// ============================================================================
+// CONNECTIVITY SCORING (0-20 points)
+// ============================================================================
+/**
+ * Build file relationships from import analysis
+ */
+export function buildFileRelationships(files) {
+    const relationships = new Map();
+    // Initialize all files
+    for (const file of files) {
+        relationships.set(file.path, {
+            filePath: file.path,
+            imports: [],
+            importedBy: [],
+        });
+    }
+    return relationships;
+}
+/**
+ * Calculate connectivity score based on import relationships
+ */
+function calculateConnectivityScore(filePath, relationships) {
+    const rel = relationships.get(filePath);
+    if (!rel) {
+        return 0;
+    }
+    let score = 0;
+    // Imported by many files
+    const importedByCount = rel.importedBy.length;
+    if (importedByCount >= 5) {
+        score += 20;
+    }
+    else if (importedByCount >= 2) {
+        score += 10;
+    }
+    // Imports many local files
+    const importsCount = rel.imports.length;
+    if (importsCount >= 5) {
+        score += 10;
+    }
+    // Orphan penalty
+    if (importsCount === 0 && importedByCount === 0) {
+        score -= 10;
+    }
+    // Clamp to valid range
+    return Math.max(0, Math.min(20, score));
+}
+// ============================================================================
+// TAGGING
+// ============================================================================
+/**
+ * Generate tags for a scored file
+ */
+function generateTags(file, scoreBreakdown) {
+    const tags = [];
+    // Entry point tag
+    if (file.isEntryPoint) {
+        tags.push('entry-point');
+    }
+    // Config tag
+    if (file.isConfig) {
+        tags.push('config');
+    }
+    // Test tag
+    if (file.isTest) {
+        tags.push('test');
+    }
+    // Generated tag
+    if (file.isGenerated) {
+        tags.push('generated');
+    }
+    // Schema/model tag
+    const nameLower = file.name.toLowerCase();
+    if (nameLower.includes('schema') ||
+        nameLower.includes('model') ||
+        nameLower.includes('entity')) {
+        tags.push('schema');
+    }
+    // API/route tag
+    if (nameLower.includes('api') ||
+        nameLower.includes('route') ||
+        nameLower.includes('controller')) {
+        tags.push('api');
+    }
+    // Service tag
+    if (nameLower.includes('service') || nameLower.includes('provider')) {
+        tags.push('service');
+    }
+    // High name score tag
+    if (scoreBreakdown.name >= 20) {
+        tags.push('high-value-name');
+    }
+    // High connectivity tag
+    if (scoreBreakdown.connectivity >= 15) {
+        tags.push('high-connectivity');
+    }
+    return tags;
+}
+// ============================================================================
+// MAIN SCORER CLASS
+// ============================================================================
+/**
+ * File Significance Scorer
+ */
+export class SignificanceScorer {
+    config;
+    relationships;
+    constructor(config = {}) {
+        this.config = config;
+        this.relationships = new Map();
+    }
+    /**
+     * Set file relationships for connectivity scoring
+     */
+    setRelationships(relationships) {
+        this.relationships = relationships;
+    }
+    /**
+     * Score a single file
+     */
+    async scoreFile(file) {
+        const nameScore = calculateNameScore(file.name, this.config);
+        const pathScore = calculatePathScore(file.path, file.depth, this.config);
+        const structureScore = await calculateStructureScore(file.absolutePath, file.lines);
+        const connectivityScore = calculateConnectivityScore(file.path, this.relationships);
+        const totalScore = nameScore + pathScore + structureScore + connectivityScore;
+        const scoreBreakdown = {
+            name: nameScore,
+            path: pathScore,
+            structure: structureScore,
+            connectivity: connectivityScore,
+        };
+        const tags = generateTags(file, scoreBreakdown);
+        return {
+            ...file,
+            score: Math.max(0, Math.min(100, totalScore)),
+            scoreBreakdown,
+            tags,
+        };
+    }
+    /**
+     * Score all files
+     */
+    async scoreFiles(files) {
+        const scoredFiles = [];
+        for (const file of files) {
+            const scored = await this.scoreFile(file);
+            // Apply minimum score filter if configured
+            if (this.config.minScore === undefined || scored.score >= this.config.minScore) {
+                scoredFiles.push(scored);
+            }
+        }
+        // Sort by score descending
+        scoredFiles.sort((a, b) => b.score - a.score);
+        return scoredFiles;
+    }
+}
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Get top N files by score
+ */
+export function getTopFiles(files, n) {
+    return [...files].sort((a, b) => b.score - a.score).slice(0, n);
+}
+/**
+ * Get files matching a specific tag
+ */
+export function getFilesByTag(files, tag) {
+    return files.filter((file) => file.tags.includes(tag));
+}
+/**
+ * Get files with score above threshold
+ */
+export function getFilesAboveThreshold(files, threshold) {
+    return files.filter((file) => file.score >= threshold);
+}
+/**
+ * Group files by tag
+ */
+export function groupFilesByTag(files) {
+    const groups = new Map();
+    for (const file of files) {
+        for (const tag of file.tags) {
+            const group = groups.get(tag) ?? [];
+            group.push(file);
+            groups.set(tag, group);
+        }
+    }
+    return groups;
+}
+/**
+ * Convenience function to score files
+ */
+export async function scoreFiles(files, config) {
+    const scorer = new SignificanceScorer(config);
+    return scorer.scoreFiles(files);
+}
+//# sourceMappingURL=significance-scorer.js.map

package/dist/core/analyzer/significance-scorer.js.map

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

package/dist/core/analyzer/subgraph-extractor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Subgraph Extractor
+ *
+ * For files that are too large to send as raw source to the LLM,
+ * extracts a compact call-graph neighborhood around "god functions"
+ * (high fan-out) and formats it as a structured prompt section.
+ *
+ * This dramatically reduces token usage while preserving structural
+ * information about complex orchestration code.
+ */
+import type { SerializedCallGraph, FunctionNode } from './call-graph.js';
+import type { FileSignatureMap } from './signature-extractor.js';
+export interface SubGraphNode {
+    name: string;
+    file: string;
+    fanIn: number;
+    fanOut: number;
+}
+export interface SubGraph {
+    root: SubGraphNode;
+    /** Callee nodes reachable within MAX_DEPTH */
+    nodes: SubGraphNode[];
+    /** [callerName, calleeName] pairs */
+    edges: Array<[string, string]>;
+}
+/**
+ * Return all god functions (fanOut >= threshold) defined in a given file.
+ * Normalises path separators for cross-platform matching.
+ */
+export declare function getFileGodFunctions(callGraph: SerializedCallGraph, filePath: string, fanOutThreshold?: number): FunctionNode[];
+/**
+ * Extract a depth-limited subgraph around a root node.
+ * Only follows outgoing (callee) edges.
+ */
+export declare function extractSubgraph(callGraph: SerializedCallGraph, root: FunctionNode): SubGraph;
+/**
+ * Build a graph-based prompt section for a large file.
+ *
+ * Returns null if no call-graph data is available for the file,
+ * signalling the caller to fall back to raw source chunking.
+ */
+export declare function buildGraphPromptSection(callGraph: SerializedCallGraph | undefined, signatures: FileSignatureMap[] | undefined, filePath: string): string | null;
+//# sourceMappingURL=subgraph-extractor.d.ts.map

package/dist/core/analyzer/subgraph-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph-extractor.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/subgraph-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAajE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,8CAA8C;IAC9C,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,qCAAqC;IACrC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChC;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,mBAAmB,EAC9B,QAAQ,EAAE,MAAM,EAChB,eAAe,SAAuB,GACrC,YAAY,EAAE,CAKhB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,YAAY,GACjB,QAAQ,CA0CV;AA+BD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,mBAAmB,GAAG,SAAS,EAC1C,UAAU,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAC1C,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAiCf"}

package/dist/core/analyzer/subgraph-extractor.js

@@ -0,0 +1,129 @@
+/**
+ * Subgraph Extractor
+ *
+ * For files that are too large to send as raw source to the LLM,
+ * extracts a compact call-graph neighborhood around "god functions"
+ * (high fan-out) and formats it as a structured prompt section.
+ *
+ * This dramatically reduces token usage while preserving structural
+ * information about complex orchestration code.
+ */
+// Fan-out threshold for god-function detection (matches refactor-analyzer.ts)
+const GOD_FANOUT_THRESHOLD = 8;
+// Max graph depth and nodes per subgraph to avoid prompt explosion
+const MAX_DEPTH = 2;
+const MAX_NODES = 30;
+// ============================================================================
+// CORE FUNCTIONS
+// ============================================================================
+/**
+ * Return all god functions (fanOut >= threshold) defined in a given file.
+ * Normalises path separators for cross-platform matching.
+ */
+export function getFileGodFunctions(callGraph, filePath, fanOutThreshold = GOD_FANOUT_THRESHOLD) {
+    const normalised = filePath.replace(/\\/g, '/');
+    return callGraph.nodes.filter(n => n.filePath.replace(/\\/g, '/').endsWith(normalised) && n.fanOut >= fanOutThreshold);
+}
+/**
+ * Extract a depth-limited subgraph around a root node.
+ * Only follows outgoing (callee) edges.
+ */
+export function extractSubgraph(callGraph, root) {
+    const nodeMap = new Map(callGraph.nodes.map(n => [n.id, n]));
+    const visited = new Set();
+    const resultNodes = [];
+    const edges = [];
+    function visit(nodeId, depth) {
+        if (visited.has(nodeId) || depth > MAX_DEPTH || visited.size >= MAX_NODES)
+            return;
+        visited.add(nodeId);
+        const outgoing = callGraph.edges.filter(e => e.callerId === nodeId && e.calleeId);
+        for (const edge of outgoing) {
+            const callerNode = nodeMap.get(edge.callerId);
+            const calleeNode = nodeMap.get(edge.calleeId);
+            if (!callerNode || !calleeNode)
+                continue;
+            edges.push([callerNode.name, calleeNode.name]);
+            if (!visited.has(edge.calleeId)) {
+                resultNodes.push({
+                    name: calleeNode.name,
+                    file: calleeNode.filePath,
+                    fanIn: calleeNode.fanIn,
+                    fanOut: calleeNode.fanOut,
+                });
+                visit(edge.calleeId, depth + 1);
+            }
+        }
+    }
+    visit(root.id, 0);
+    return {
+        root: {
+            name: root.name,
+            file: root.filePath,
+            fanIn: root.fanIn,
+            fanOut: root.fanOut,
+        },
+        nodes: resultNodes,
+        edges,
+    };
+}
+/**
+ * Format a single subgraph as a compact ASCII block for LLM prompts.
+ *
+ * Example output:
+ *   run (fanIn=0, fanOut=12)
+ *     → runStage1, runStage2, runStage3 ...
+ */
+function formatSubgraph(sub) {
+    const lines = [];
+    lines.push(`${sub.root.name} (fanIn=${sub.root.fanIn}, fanOut=${sub.root.fanOut})`);
+    // Direct callees of root
+    const directCallees = sub.edges
+        .filter(([from]) => from === sub.root.name)
+        .map(([, to]) => to);
+    if (directCallees.length > 0) {
+        lines.push(`  → ${directCallees.join(', ')}`);
+    }
+    // Second-level callees
+    const secondLevel = sub.edges.filter(([from]) => from !== sub.root.name);
+    for (const [from, to] of secondLevel) {
+        lines.push(`    ${from} → ${to}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Build a graph-based prompt section for a large file.
+ *
+ * Returns null if no call-graph data is available for the file,
+ * signalling the caller to fall back to raw source chunking.
+ */
+export function buildGraphPromptSection(callGraph, signatures, filePath) {
+    if (!callGraph)
+        return null;
+    const godFunctions = getFileGodFunctions(callGraph, filePath);
+    // No god functions means the graph adds little value; let caller chunk normally
+    if (godFunctions.length === 0)
+        return null;
+    const lines = [
+        `[Graph-based analysis — file too large to include full source]`,
+        '',
+    ];
+    // Signatures for this file (from signature-extractor)
+    const sigMap = signatures?.find(s => s.path.replace(/\\/g, '/').endsWith(filePath.replace(/\\/g, '/')));
+    if (sigMap && sigMap.entries.length > 0) {
+        lines.push('Signatures:');
+        for (const entry of sigMap.entries) {
+            const doc = entry.docstring ? `  // ${entry.docstring}` : '';
+            lines.push(`  ${entry.signature}${doc}`);
+        }
+        lines.push('');
+    }
+    // Subgraphs for each god function
+    lines.push(`High-complexity functions (fanOut >= ${GOD_FANOUT_THRESHOLD}):`);
+    for (const godFn of godFunctions) {
+        const sub = extractSubgraph(callGraph, godFn);
+        lines.push(formatSubgraph(sub));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=subgraph-extractor.js.map

package/dist/core/analyzer/subgraph-extractor.js.map

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

package/dist/core/analyzer/vector-index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * VectorIndex
+ *
+ * Builds and queries a LanceDB vector index over the call graph functions.
+ * Each function is represented by a document combining its signature, docstring,
+ * file path, language, and topological metadata (fanIn/fanOut, hub, entry point).
+ *
+ * Storage: <outputDir>/vector-index/  (LanceDB database folder)
+ * Table name: "functions"
+ *
+ * Usage:
+ *   // Build (after spec-gen analyze --embed)
+ *   await VectorIndex.build(outputDir, nodes, signatures, hubIds, entryPointIds, embedSvc);
+ *
+ *   // Search
+ *   const results = await VectorIndex.search(outputDir, "authenticate user with JWT", embedSvc);
+ */
+import type { FunctionNode } from './call-graph.js';
+import type { FileSignatureMap } from './signature-extractor.js';
+import type { EmbeddingService } from './embedding-service.js';
+export interface FunctionRecord {
+    id: string;
+    name: string;
+    filePath: string;
+    className: string;
+    language: string;
+    signature: string;
+    docstring: string;
+    fanIn: number;
+    fanOut: number;
+    isHub: boolean;
+    isEntryPoint: boolean;
+    /** Concatenated text used for embedding */
+    text: string;
+    /** Embedding vector */
+    vector: number[];
+}
+export interface SearchResult {
+    record: Omit<FunctionRecord, 'vector'>;
+    /** Distance score (lower = more similar) */
+    score: number;
+}
+export declare class VectorIndex {
+    /**
+     * Build (or rebuild) the vector index from call graph nodes + signatures.
+     * Overwrites any existing index.
+     */
+    static build(outputDir: string, nodes: FunctionNode[], signatures: FileSignatureMap[], hubIds: Set<string>, entryPointIds: Set<string>, embedSvc: EmbeddingService): Promise<void>;
+    /**
+     * Semantic search over the index.
+     * Returns up to `limit` results sorted by similarity (closest first).
+     */
+    static search(outputDir: string, query: string, embedSvc: EmbeddingService, opts?: {
+        limit?: number;
+        language?: string;
+        minFanIn?: number;
+    }): Promise<SearchResult[]>;
+    /**
+     * Returns true if a vector index has been built for this output directory.
+     */
+    static exists(outputDir: string): boolean;
+}
+//# sourceMappingURL=vector-index.d.ts.map

package/dist/core/analyzer/vector-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/vector-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACvC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAiED,qBAAa,WAAW;IACtB;;;OAGG;WACU,KAAK,CAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,EAAE,EACrB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EACnB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAC1B,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC;IAkDhB;;;OAGG;WACU,MAAM,CACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,GAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd,GACL,OAAO,CAAC,YAAY,EAAE,CAAC;IAmD1B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAG1C"}