agentic-qe 2.5.10 → 2.6.0

package/dist/code-intelligence/visualization/ClassDiagramBuilder.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * Class Diagram Builder
+ *
+ * Generates Mermaid class diagrams with inheritance,
+ * methods, properties, and visibility markers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClassDiagramBuilder = void 0;
+const MermaidGenerator_js_1 = require("./MermaidGenerator.js");
+class ClassDiagramBuilder {
+    /**
+     * Build class diagram from graph nodes.
+     */
+    static build(nodes, edges, options = {}) {
+        const { includeMethods = true, includeProperties = true, showParameters = true, showReturnTypes = true, groupByNamespace = false, maxNodes = 30, } = options;
+        // Filter to class/interface nodes
+        let classNodes = nodes.filter(n => n.type === 'class' || n.type === 'interface');
+        if (classNodes.length > maxNodes) {
+            classNodes = classNodes.slice(0, maxNodes);
+        }
+        // Enrich class nodes with methods and properties
+        const enrichedNodes = classNodes.map(node => this.enrichClassNode(node, nodes, {
+            includeMethods,
+            includeProperties,
+            showParameters,
+            showReturnTypes,
+        }));
+        // Filter edges to inheritance/implementation
+        const classNodeIds = new Set(classNodes.map(n => n.id));
+        const relevantEdges = edges.filter(e => classNodeIds.has(e.source) && classNodeIds.has(e.target) &&
+            (e.type === 'extends' || e.type === 'implements' || e.type === 'uses'));
+        const diagram = MermaidGenerator_js_1.MermaidGenerator.generate(enrichedNodes, relevantEdges, 'classDiagram', options);
+        if (groupByNamespace) {
+            return this.addNamespaceGrouping(diagram, enrichedNodes);
+        }
+        return diagram;
+    }
+    /**
+     * Build inheritance hierarchy for a specific class.
+     */
+    static buildHierarchy(rootClassId, nodes, edges, options = {}) {
+        const rootNode = nodes.find(n => n.id === rootClassId);
+        if (!rootNode) {
+            throw new Error(`Class not found: ${rootClassId}`);
+        }
+        // Traverse up (superclasses) and down (subclasses)
+        const hierarchyNodes = new Set([rootClassId]);
+        const hierarchyEdges = [];
+        // Find superclasses (extends/implements)
+        const findSuperclasses = (nodeId) => {
+            const extendsEdges = edges.filter(e => e.source === nodeId && (e.type === 'extends' || e.type === 'implements'));
+            for (const edge of extendsEdges) {
+                if (!hierarchyNodes.has(edge.target)) {
+                    hierarchyNodes.add(edge.target);
+                    hierarchyEdges.push(edge);
+                    findSuperclasses(edge.target);
+                }
+            }
+        };
+        // Find subclasses
+        const findSubclasses = (nodeId) => {
+            const subclassEdges = edges.filter(e => e.target === nodeId && (e.type === 'extends' || e.type === 'implements'));
+            for (const edge of subclassEdges) {
+                if (!hierarchyNodes.has(edge.source)) {
+                    hierarchyNodes.add(edge.source);
+                    hierarchyEdges.push(edge);
+                    findSubclasses(edge.source);
+                }
+            }
+        };
+        findSuperclasses(rootClassId);
+        findSubclasses(rootClassId);
+        const hierarchyNodeList = nodes.filter(n => hierarchyNodes.has(n.id));
+        return this.build(hierarchyNodeList, hierarchyEdges, options);
+    }
+    /**
+     * Enrich class node with methods and properties from child nodes.
+     */
+    static enrichClassNode(classNode, allNodes, options) {
+        const enriched = { ...classNode };
+        if (!enriched.properties) {
+            enriched.properties = {};
+        }
+        // Find methods (child nodes of type 'method')
+        if (options.includeMethods) {
+            const methods = allNodes.filter(n => n.type === 'method' && n.filePath === classNode.filePath &&
+                n.startLine >= classNode.startLine && n.endLine <= classNode.endLine);
+            enriched.properties.methods = methods.map(m => ({
+                name: m.label,
+                visibility: this.inferVisibility(m.label),
+                returnType: options.showReturnTypes ? m.properties.returnType : undefined,
+                params: options.showParameters ? m.properties.params : undefined,
+            }));
+        }
+        // Find properties (child nodes of type 'variable')
+        if (options.includeProperties) {
+            const properties = allNodes.filter(n => n.type === 'variable' && n.filePath === classNode.filePath &&
+                n.startLine >= classNode.startLine && n.endLine <= classNode.endLine);
+            enriched.properties.properties = properties.map(p => ({
+                name: p.label,
+                visibility: this.inferVisibility(p.label),
+                type: p.properties.type,
+            }));
+        }
+        return enriched;
+    }
+    /**
+     * Infer visibility from naming convention.
+     */
+    static inferVisibility(name) {
+        if (name.startsWith('_'))
+            return 'private';
+        if (name.startsWith('#'))
+            return 'private';
+        if (name.startsWith('__'))
+            return 'private';
+        return 'public';
+    }
+    /**
+     * Add namespace grouping to diagram.
+     */
+    static addNamespaceGrouping(diagram, nodes) {
+        const lines = diagram.split('\n');
+        const namespaces = new Map();
+        // Group nodes by file path (namespace)
+        for (const node of nodes) {
+            const namespace = this.extractNamespace(node.filePath);
+            const existing = namespaces.get(namespace) || [];
+            existing.push(MermaidGenerator_js_1.MermaidGenerator['sanitizeMermaidId'](node.label));
+            namespaces.set(namespace, existing);
+        }
+        // Insert namespace declarations after classDiagram header
+        const namespaceLines = [];
+        for (const [namespace, classes] of namespaces.entries()) {
+            namespaceLines.push(`  namespace ${namespace} {`);
+            for (const className of classes) {
+                namespaceLines.push(`    class ${className}`);
+            }
+            namespaceLines.push('  }');
+        }
+        // Insert after first line
+        return [lines[0], ...namespaceLines, ...lines.slice(1)].join('\n');
+    }
+    /**
+     * Extract namespace from file path.
+     */
+    static extractNamespace(filePath) {
+        const parts = filePath.split('/');
+        if (parts.length > 1) {
+            // Use parent directory as namespace
+            return parts[parts.length - 2].replace(/[^a-zA-Z0-9]/g, '_');
+        }
+        return 'default';
+    }
+    /**
+     * Generate interface overview diagram.
+     */
+    static buildInterfaceOverview(nodes, edges, options = {}) {
+        // Filter to interfaces only
+        const interfaceNodes = nodes.filter(n => n.type === 'interface');
+        // Find all classes that implement these interfaces
+        const implementsEdges = edges.filter(e => e.type === 'implements');
+        const relevantNodeIds = new Set(interfaceNodes.map(n => n.id));
+        for (const edge of implementsEdges) {
+            if (relevantNodeIds.has(edge.target)) {
+                relevantNodeIds.add(edge.source);
+            }
+        }
+        const relevantNodes = nodes.filter(n => relevantNodeIds.has(n.id));
+        const relevantEdges = implementsEdges.filter(e => relevantNodeIds.has(e.source) && relevantNodeIds.has(e.target));
+        return this.build(relevantNodes, relevantEdges, {
+            ...options,
+            includeMethods: true,
+            includeProperties: false,
+        });
+    }
+}
+exports.ClassDiagramBuilder = ClassDiagramBuilder;
+//# sourceMappingURL=ClassDiagramBuilder.js.map

package/dist/code-intelligence/visualization/ClassDiagramBuilder.js.map

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

package/dist/code-intelligence/visualization/DependencyGraphBuilder.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Dependency Graph Builder
+ *
+ * Generates Mermaid dependency graphs showing module relationships,
+ * import chains, and circular dependencies.
+ */
+import { GraphNode, GraphEdge } from '../graph/types.js';
+import { MermaidOptions } from './MermaidGenerator.js';
+export interface DependencyGraphOptions extends MermaidOptions {
+    /** Show only direct dependencies */
+    directOnly?: boolean;
+    /** Maximum depth for dependency tree */
+    maxDepth?: number;
+    /** Highlight circular dependencies */
+    highlightCycles?: boolean;
+    /** Group by directory */
+    groupByDirectory?: boolean;
+    /** Show external dependencies (node_modules) */
+    showExternal?: boolean;
+}
+export declare class DependencyGraphBuilder {
+    /**
+     * Build dependency graph from import relationships.
+     */
+    static build(nodes: GraphNode[], edges: GraphEdge[], options?: DependencyGraphOptions): string;
+    /**
+     * Build dependency tree for a specific file.
+     */
+    static buildDependencyTree(rootFileId: string, nodes: GraphNode[], edges: GraphEdge[], options?: DependencyGraphOptions): string;
+    /**
+     * Build reverse dependency graph (who depends on this file).
+     */
+    static buildReverseDependencies(targetFileId: string, nodes: GraphNode[], edges: GraphEdge[], options?: DependencyGraphOptions): string;
+    /**
+     * Analyze dependency metrics.
+     */
+    static analyzeDependencies(nodes: GraphNode[], edges: GraphEdge[]): DependencyMetrics;
+    /**
+     * Filter to direct dependencies only.
+     */
+    private static filterDirectDependencies;
+    /**
+     * Generate dependency matrix (tabular view).
+     */
+    static generateDependencyMatrix(nodes: GraphNode[], edges: GraphEdge[]): string;
+    /**
+     * Shorten file path for display.
+     */
+    private static shortenPath;
+}
+export interface DependencyMetrics {
+    totalFiles: number;
+    totalDependencies: number;
+    avgDependenciesPerFile: number;
+    mostImported: Array<{
+        file: string;
+        imports: number;
+    }>;
+    mostImporting: Array<{
+        file: string;
+        dependencies: number;
+    }>;
+    circularDependencies: number;
+    circularDependencyPaths: string[][];
+}
+//# sourceMappingURL=DependencyGraphBuilder.d.ts.map

package/dist/code-intelligence/visualization/DependencyGraphBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyGraphBuilder.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/visualization/DependencyGraphBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAoB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEzE,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,oCAAoC;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,KAAK,CACV,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE,sBAA2B,GACnC,MAAM;IAwDT;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE,sBAA2B,GACnC,MAAM;IAgDT;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE,sBAA2B,GACnC,MAAM;IA+BT;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,GACjB,iBAAiB;IAmDpB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAgBvC;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,GACjB,MAAM;IAmCT;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAO3B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,EAAE,EAAE,CAAC;CACrC"}

package/dist/code-intelligence/visualization/DependencyGraphBuilder.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * Dependency Graph Builder
+ *
+ * Generates Mermaid dependency graphs showing module relationships,
+ * import chains, and circular dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyGraphBuilder = void 0;
+const MermaidGenerator_js_1 = require("./MermaidGenerator.js");
+class DependencyGraphBuilder {
+    /**
+     * Build dependency graph from import relationships.
+     */
+    static build(nodes, edges, options = {}) {
+        const { directOnly = false, maxDepth = 3, highlightCycles = true, showExternal = false, maxNodes = 50, } = options;
+        // Filter to file nodes
+        let fileNodes = nodes.filter(n => n.type === 'file');
+        // Filter out node_modules unless requested
+        if (!showExternal) {
+            fileNodes = fileNodes.filter(n => !n.filePath.includes('node_modules'));
+        }
+        if (fileNodes.length > maxNodes) {
+            fileNodes = fileNodes.slice(0, maxNodes);
+        }
+        // Filter to import/export edges
+        const fileNodeIds = new Set(fileNodes.map(n => n.id));
+        let dependencyEdges = edges.filter(e => fileNodeIds.has(e.source) && fileNodeIds.has(e.target) &&
+            (e.type === 'imports' || e.type === 'exports'));
+        // If directOnly, filter to depth 1
+        if (directOnly) {
+            dependencyEdges = this.filterDirectDependencies(fileNodes, dependencyEdges);
+        }
+        if (highlightCycles) {
+            return MermaidGenerator_js_1.MermaidGenerator.generateDependencyGraphWithCycles(fileNodes, dependencyEdges, options);
+        }
+        return MermaidGenerator_js_1.MermaidGenerator.generate(fileNodes, dependencyEdges, 'graph', {
+            ...options,
+            direction: 'LR',
+            edgeTypeFilter: ['imports', 'exports'],
+        });
+    }
+    /**
+     * Build dependency tree for a specific file.
+     */
+    static buildDependencyTree(rootFileId, nodes, edges, options = {}) {
+        const { maxDepth = 3, highlightCycles = true, } = options;
+        const rootNode = nodes.find(n => n.id === rootFileId);
+        if (!rootNode) {
+            throw new Error(`File not found: ${rootFileId}`);
+        }
+        const treeNodes = new Set([rootFileId]);
+        const treeEdges = [];
+        // BFS traversal of dependencies
+        const queue = [
+            { nodeId: rootFileId, depth: 0 }
+        ];
+        const visited = new Set([rootFileId]);
+        while (queue.length > 0) {
+            const { nodeId, depth } = queue.shift();
+            if (depth >= maxDepth)
+                continue;
+            const dependencies = edges.filter(e => e.source === nodeId && (e.type === 'imports' || e.type === 'uses'));
+            for (const edge of dependencies) {
+                treeNodes.add(edge.target);
+                treeEdges.push(edge);
+                if (!visited.has(edge.target)) {
+                    visited.add(edge.target);
+                    queue.push({ nodeId: edge.target, depth: depth + 1 });
+                }
+            }
+        }
+        const treeNodeList = nodes.filter(n => treeNodes.has(n.id));
+        return this.build(treeNodeList, treeEdges, {
+            ...options,
+            highlightCycles,
+        });
+    }
+    /**
+     * Build reverse dependency graph (who depends on this file).
+     */
+    static buildReverseDependencies(targetFileId, nodes, edges, options = {}) {
+        const targetNode = nodes.find(n => n.id === targetFileId);
+        if (!targetNode) {
+            throw new Error(`File not found: ${targetFileId}`);
+        }
+        // Find all nodes that import/use target
+        const dependents = new Set([targetFileId]);
+        const reverseEdges = [];
+        const findDependents = (nodeId) => {
+            const incomingEdges = edges.filter(e => e.target === nodeId && (e.type === 'imports' || e.type === 'uses'));
+            for (const edge of incomingEdges) {
+                if (!dependents.has(edge.source)) {
+                    dependents.add(edge.source);
+                    reverseEdges.push(edge);
+                    findDependents(edge.source);
+                }
+            }
+        };
+        findDependents(targetFileId);
+        const dependentNodes = nodes.filter(n => dependents.has(n.id));
+        return this.build(dependentNodes, reverseEdges, options);
+    }
+    /**
+     * Analyze dependency metrics.
+     */
+    static analyzeDependencies(nodes, edges) {
+        const fileNodes = nodes.filter(n => n.type === 'file');
+        const importEdges = edges.filter(e => e.type === 'imports');
+        const inDegree = new Map();
+        const outDegree = new Map();
+        for (const node of fileNodes) {
+            inDegree.set(node.id, 0);
+            outDegree.set(node.id, 0);
+        }
+        for (const edge of importEdges) {
+            inDegree.set(edge.target, (inDegree.get(edge.target) || 0) + 1);
+            outDegree.set(edge.source, (outDegree.get(edge.source) || 0) + 1);
+        }
+        // Find most imported (highly coupled)
+        const mostImported = Array.from(inDegree.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([nodeId, count]) => {
+            const node = nodes.find(n => n.id === nodeId);
+            return { file: node.label, imports: count };
+        });
+        // Find most importing (highly dependent)
+        const mostImporting = Array.from(outDegree.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([nodeId, count]) => {
+            const node = nodes.find(n => n.id === nodeId);
+            return { file: node.label, dependencies: count };
+        });
+        // Find circular dependencies
+        const cycles = MermaidGenerator_js_1.MermaidGenerator.findCircularDependencies(fileNodes, importEdges);
+        return {
+            totalFiles: fileNodes.length,
+            totalDependencies: importEdges.length,
+            avgDependenciesPerFile: fileNodes.length > 0
+                ? importEdges.length / fileNodes.length
+                : 0,
+            mostImported,
+            mostImporting,
+            circularDependencies: cycles.length,
+            circularDependencyPaths: cycles,
+        };
+    }
+    /**
+     * Filter to direct dependencies only.
+     */
+    static filterDirectDependencies(nodes, edges) {
+        // For each node, keep only first-level dependencies
+        const directEdges = [];
+        const nodeIds = new Set(nodes.map(n => n.id));
+        for (const nodeId of nodeIds) {
+            const outgoing = edges.filter(e => e.source === nodeId);
+            directEdges.push(...outgoing);
+        }
+        return directEdges;
+    }
+    /**
+     * Generate dependency matrix (tabular view).
+     */
+    static generateDependencyMatrix(nodes, edges) {
+        const fileNodes = nodes.filter(n => n.type === 'file');
+        const importEdges = edges.filter(e => e.type === 'imports');
+        const matrix = [];
+        const header = ['File', ...fileNodes.map(n => this.shortenPath(n.label))];
+        matrix.push(header);
+        for (const source of fileNodes) {
+            const row = [this.shortenPath(source.label)];
+            for (const target of fileNodes) {
+                const hasEdge = importEdges.some(e => e.source === source.id && e.target === target.id);
+                row.push(hasEdge ? 'X' : '');
+            }
+            matrix.push(row);
+        }
+        // Format as markdown table
+        const lines = [];
+        lines.push('## Dependency Matrix');
+        lines.push('');
+        lines.push(matrix[0].join(' | '));
+        lines.push(matrix[0].map(() => '---').join(' | '));
+        for (let i = 1; i < matrix.length; i++) {
+            lines.push(matrix[i].join(' | '));
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Shorten file path for display.
+     */
+    static shortenPath(path) {
+        const parts = path.split('/');
+        if (parts.length > 2) {
+            return `.../${parts[parts.length - 1]}`;
+        }
+        return path;
+    }
+}
+exports.DependencyGraphBuilder = DependencyGraphBuilder;
+//# sourceMappingURL=DependencyGraphBuilder.js.map

package/dist/code-intelligence/visualization/DependencyGraphBuilder.js.map

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

package/dist/code-intelligence/visualization/MermaidGenerator.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Mermaid Diagram Generator
+ *
+ * Converts Code Intelligence graph to Mermaid syntax
+ * for GitHub-compatible visualization.
+ */
+import { GraphNode, GraphEdge, EdgeType, NodeType } from '../graph/types.js';
+export interface MermaidOptions {
+    /** Maximum nodes to include (prevents overwhelming large graphs) */
+    maxNodes?: number;
+    /** Include legend for relationship types */
+    includeLegend?: boolean;
+    /** Direction for flowcharts (TB, LR, RL, BT) */
+    direction?: 'TB' | 'LR' | 'RL' | 'BT';
+    /** Style theme */
+    theme?: 'default' | 'dark' | 'forest' | 'neutral';
+    /** Filter by node types */
+    nodeTypeFilter?: NodeType[];
+    /** Filter by edge types */
+    edgeTypeFilter?: EdgeType[];
+}
+export declare class MermaidGenerator {
+    /**
+     * Generate Mermaid diagram from nodes and edges.
+     */
+    static generate(nodes: GraphNode[], edges: GraphEdge[], type: 'classDiagram' | 'graph' | 'flowchart', options?: MermaidOptions): string;
+    /**
+     * Generate class diagram.
+     */
+    private static generateClassDiagram;
+    /**
+     * Generate flowchart/graph diagram.
+     */
+    private static generateFlowchart;
+    /**
+     * Get visibility symbol for class members.
+     */
+    private static getVisibilitySymbol;
+    /**
+     * Get class diagram relationship syntax.
+     */
+    private static getClassRelationship;
+    /**
+     * Get node shape for flowchart.
+     */
+    private static getNodeShape;
+    /**
+     * Get node style CSS.
+     */
+    private static getNodeStyle;
+    /**
+     * Get edge arrow style.
+     */
+    private static getEdgeArrow;
+    /**
+     * Get edge label.
+     */
+    private static getEdgeLabel;
+    /**
+     * Sanitize ID for Mermaid (alphanumeric and underscores only).
+     */
+    private static sanitizeMermaidId;
+    /**
+     * Escape label for Mermaid (handle special characters).
+     */
+    private static escapeLabel;
+    /**
+     * Detect circular dependencies in graph.
+     */
+    static findCircularDependencies(nodes: GraphNode[], edges: GraphEdge[]): string[][];
+    /**
+     * Generate dependency graph with circular dependency highlighting.
+     */
+    static generateDependencyGraphWithCycles(nodes: GraphNode[], edges: GraphEdge[], options?: MermaidOptions): string;
+}
+//# sourceMappingURL=MermaidGenerator.d.ts.map

package/dist/code-intelligence/visualization/MermaidGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MermaidGenerator.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/visualization/MermaidGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,gDAAgD;IAChD,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAEtC,kBAAkB;IAClB,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAElD,2BAA2B;IAC3B,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;IAE5B,2BAA2B;IAC3B,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,WAAW,EAC5C,OAAO,GAAE,cAAmB,GAC3B,MAAM;IAyCT;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAkEnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAkDhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAgBlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAenC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAsB3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAqB3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAwB3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IA+B3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAIhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAW1B;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,GACjB,MAAM,EAAE,EAAE;IA8Cb;;OAEG;IACH,MAAM,CAAC,iCAAiC,CACtC,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE,cAAmB,GAC3B,MAAM;CAgCV"}