SuperAPI AI 工具集

sanity-pkg-utils

通用与其它

查看项目

更新于 10-16 08:42

技能介绍

用途:@sanity/pkg-utils 面向遵循 Sanity 约定的库包,以作者手写的 package.json#exports 作为构建清单,推导入口、格式及运行时相关构建,并生成可发布且不含 source 的目标(写入 publishConfig.exports)。它组合 tsdown 与 @sanity/tsdown-config,加入 browserslist 目标和 Sanity 包约定。若使用直接 tsdown.config.ts 构建,应改用 sanity-tsdown-config;通用 tsdown 选项参见 tsdown 文档。

主要能力:支持 pkg build、pkg watch、pkg check;build 可加 --strict、--check、--no-clean、--quiet。exports 支持 source 条件,pkg 会保留本地 source 供开发使用,并据此创建 browser/node 等平台构建。默认继承 tsdown 的 source map、保留名称的压缩、依赖子路径解析和循环依赖警告;JS 目标由 browserslist 推导;tsdoc 默认启用(watch 模式跳过);publint 通过 pkg check 运行。

使用方式:安装 pnpm add -D @sanity/pkg-utils,13.x 需要 Node.js ^22.18.0 || ^24.11.0 || >=26.0.0。脚本中优先使用短命令 pkg(pkg-utils 为别名),例如 "build": "pkg build --strict --check"、"watch": "pkg watch"。配置仅读取 package.config.ts(也支持 .mts/.js/.mjs),不加载 tsdown.config.*,二者不可混用。常用选项包括 tsconfig、dist、clean、sourcemap、minify、runtime、deps、dts、define、extra Rolldown 插件、reactCompiler、styledComponents、vanillaExtract、css、bundleAnalyzer、tsdoc、bundles。导出路径下的 source 决定入口与格式,bundles 仅用于不被导出的产物(如 worker、CLI)。

适用场景:构建、监听和校验 Sanity 风格的 npm 库;需要 exports 驱动的多格式/多平台产物;需要发布前清理 exports 并运行 TSDoc/publint 检查。

限制与注意:pkg init 为交互式 raw-TTY 命令,不宜在非交互环境通过管道自动化。watch 不重写 package.json exports,修改包元数据后需运行完整 build。reactCompiler 不支持 reactServer,需要该双构建时改用 tsdown 与 @sanity/tsdown-config。声明生成不等于类型检查。发出的 CSS 需加入 sideEffects。不要默认使用 --no-clean。不要默认全量压缩,默认压缩已做死代码消除并保留名称。external 已弃用,改用 deps.neverBundle 或 deps.alwaysBundle。bundle-analyzer 输出不应发布。v12 之前的 babel、extract、rollup 等选项已移除。费用、价格等未提供。