SuperAPI AI 工具集

npm-library-setup

通用与其它

查看项目

更新于 10-15 22:15

技能介绍

用途:帮助创建和配置 npm 库,以 ES Modules(ESM)为优先方案,覆盖基础包、TypeScript 包、React 组件库以及构建与测试配置。

主要能力:以 "type": "module" 启用纯 ESM;使用现代 exports 字段替代已弃用的 module 字段;用 bunchee 做零配置打包;用 vitest 做测试;支持 TypeScript 类型声明与 React 组件库。

使用方式:先执行 npm init -y,在 package.json 添加 "type": "module",再执行 npm install -D bunchee vitest,源码放在 src/,运行 npm run build。典型 package.json 含 main、types、exports、scripts(build 为 bunchee,test 为 vitest,test:run 为 vitest run)与 engines。导入时始终写显式 .js 扩展名,即使 TypeScript 文件中也是如此;文件路径用 kebab-case。TypeScript 需 npm install -D typescript @types/node,tsconfig 配置 target ES2022、module ESNext、moduleResolution NodeNext、declaration 与 strict。React 组件库将 react、@types/react 安装为 devDependencies,并在 peerDependencies 声明 react。

适用场景:搭建新 npm 包、配置 ESM package.json、创建 TypeScript 包或 React 组件库时。

限制与注意事项:文档未说明具体版本号、定价或跨平台差异,暂未提供;Node 版本应选用当前仍维护的最旧 LTS,需自行查看 Node.js 发布计划确认;bunchee 与 vitest 的更多配置细节需参考各自官方文档。