Monorepo Dependency Mapper 🗺️

📦 功能特性

• 智能依赖识别
  自动识别 workspace: 协议和隐式依赖
• 多格式输出
  支持生成 DOT / Mermaid / JSON 格式
• 深度分析
  区分开发依赖与生产依赖
• 质量保障
  严格模式校验依赖有效性
• 可视化支持
  生成可直接渲染的架构图

🚀 快速开始

安装

npm install -g dmapper
# 或
npx dmapper [command]

基础使用

# 生成依赖图（默认DOT格式）
dmapper analyze -p ./packages

# 生成Mermaid流程图
dmapper analyze -f mermaid > architecture.md

# 生成JSON报告
dmapper analyze -f json > dependencies.json

⚙️ 配置选项

| 参数 | 说明 | 默认值 | |---------------|-------------------------------|-----------| | -p, --path | monorepo 包目录路径 | ./packages| | -f, --format| 输出格式 (dot/mermaid/json) | dot | | -t, --type | 依赖类型 (prod/dev/all) | all | | -s, --strict| 启用严格模式校验 | false | | -e, --externals | 包含外部依赖 | false | | -v, --verbose | 显示详细日志 | false |

🌟 使用示例

1. 生成交互式架构图

dmapper analyze -f dot | dot -Tsvg > graph.svg

2. 检测无效依赖

dmapper analyze --strict -t dev

3. CI 集成示例

# 检查循环依赖
dmapper analyze -f json | jq 'if .warnings|length > 0 then exit 1 else exit 0 end'

output

cd vuejs/core && ./dmapper > graph.dot

📜 开源协议

本项目采用 MIT License

可视化

https://edotor.net/