NPM 包 API 表面提取器

解决的问题

NPM 包发布后，开发者常面临两类 API 边界问题：一是漏导出公开接口依赖的类型（比如 AwesomeButton.draw() 需要 DrawStyle 枚举但未导出），导致消费方使用时报错；二是内部实现变更时无法快速识别哪些公开 API 被修改，容易引入 breaking change。手动梳理这些问题不仅耗时，还容易遗漏非直观的导出项。

核心工作逻辑

该技能通过两个关键工具协同工作：

• 用 TypeScript Compiler API（ts.createProgram）解析 NPM 包源码，识别所有可能的导出项（包括类、接口、函数、类型、枚举等）；
• 调用 @microsoft/api-extractor 提取真正的公开 API 表面，过滤掉仅内部使用的符号；
• 最终生成两类文件：.api.md 报告（记录公开 API 的结构与说明，可用于代码审查）和 .d.ts rollup（合并包内分散的类型声明，减少消费方的类型解析开销）。

使用注意点

• 需提前安装 Node.js 和 TypeScript 环境；
• 依赖目标 NPM 包本身的 TypeScript 配置正确，若包使用 isolatedModules 或动态导出需额外验证；
• 对于依赖原生模块或 CommonJS/ESM 混合导出的包，可能需要调整 API Extractor 的配置参数。