SuperAPI AI 工具集

ts-library

编程与开发

查看项目

更新于 10-16 02:39

技能介绍

用途:该技能用于编写高质量的 TypeScript 库或 npm 包,内容来自对 unocss、shiki、unplugin、vite、vitest、vueuse、zod、trpc、drizzle-orm 等项目的模式提取。适用于新建单包或 monorepo 库、配置双 CJS/ESM 导出、设置 tsconfig、选择构建工具、设计类型安全 API、编写高级类型、搭建 vitest 测试以及配置发布与 CI 工作流。Nuxt 模块开发应改用 nuxt-modules 技能。

主要能力:按任务提供参考文件,包括 project-setup(新项目结构)、package-exports(package.json 导出与双格式)、typescript-config(tsconfig)、build-tooling(tsdown/unbuild)、eslint-config、api-design(builder、factory、插件模式)、type-patterns(类型推断技巧)、testing(vitest)、release(发布与版本)、ci-workflows(GitHub Actions)。文档提示不要一次加载全部文件,只加载与当前任务相关的部分。

使用方式:新建库按顺序执行——创建结构、配置 exports、用 tsdown 构建、验证构建、加测试、配置发布。验证命令为 pnpm build && pnpm pack --dry-run,检查输出是否包含 .mjs、.cjs、.d.ts。最小 package.json 示例设置 type 为 module,exports 中 import 指向 ./dist/index.mjs、require 指向 ./dist/index.cjs,并声明 main、module、types、files。tsdown 配置使用 defineConfig,设置 entry、format 为 esm 与 cjs、dts 为 true。

核心原则:ESM 优先;同时支持 CJS 与 ESM;使用 moduleResolution 为 Bundler;多数构建用 tsdown,复杂情况用 unbuild;提供智能默认值;保持可 tree-shaking,采用惰性 getter 与 sideEffects 为 false。

限制:未提供具体定价、许可证、平台或收费信息;参考文件仅以文件名列出,正文未包含其完整内容。