@ebowwa/dependency-graph

Core dependency graph analysis and visualization for monorepos.

Installation

bun add @ebowwa/dependency-graph
# or
npm install @ebowwa/dependency-graph

Usage

import {
  DependencyGraphBuilder,
  formatGraph,
  analyzeImpact,
  findCircularDependencies,
  findUnusedPackages,
  getPackageInfo
} from '@ebowwa/dependency-graph';

// Build the graph
const builder = new DependencyGraphBuilder('/path/to/monorepo');
const graph = await builder.build({
  includeDevDependencies: false,
  analyzeImports: true,
  excludePatterns: ['^@types/', '^@eslint/']
});

// Format as Mermaid diagram
const mermaid = formatGraph(graph, 'mermaid');

// Format as ASCII tree
const tree = formatGraph(graph, 'tree');

// Find circular dependencies
const cycles = findCircularDependencies(graph, 10);

// Analyze impact of changing a package
const impact = analyzeImpact(graph, '@ebowwa/terminal', true);
console.log(`Direct: ${impact.direct}`);
console.log(`Transitive: ${impact.transitive}`);

// Find unused packages
const unused = findUnusedPackages(graph);

// Get package info
const info = getPackageInfo(graph, '@ebowwa/ssh');

API

DependencyGraphBuilder

Builds dependency graphs from package.json and import analysis.

const builder = new DependencyGraphBuilder(monorepoRoot);
const graph = await builder.build(options);

Options:

• includeDevDependencies - Include devDependencies (default: false)
• analyzeImports - Analyze TypeScript/JavaScript imports (default: true)
• excludePatterns - Regex patterns to exclude (default: [])

Formatters

• formatGraph(graph, format) - Format graph (json, mermaid, dot, tree)
• formatAsJson(graph) - JSON output
• formatAsMermaid(graph) - Mermaid diagram
• formatAsDot(graph) - Graphviz DOT format
• formatAsTree(graph) - ASCII tree visualization

Analysis

• findCircularDependencies(graph, maxDepth) - Find dependency cycles
• analyzeImpact(graph, packageName, includeTransitive) - Impact analysis
• findUnusedPackages(graph, includeExternal) - Find packages with no dependents
• getPackageInfo(graph, packageName) - Get detailed package info
• getWorkspacePackages(graph) - Get all workspace packages
• getExternalDependencies(graph) - Get all external dependencies

License

MIT