0.1.5

1kuang-shared

创意应用动态表单契约:字段类型、编解码、默认值、纯校验(api / website / admin 三端唯一真相)。

零运行时依赖的纯逻辑包,构建产物为 dist/(cjs + esm + dts)。

常用命令

pnpm dev        # tsdown --watch,改动即产出 dist
pnpm build      # 一次性构建
pnpm test       # vitest
pnpm typecheck  # tsc --noEmit

本地联调(三端接入本地代码)

三端(website / admin / api)日常 pnpm install 安装的是 npm 发布版;需要验证本地改动时,用 pnpm link 临时接入(symlink,不碰 package.json):

# 1. 本包持续构建(改动即产出 dist,消费端即时生效)
pnpm dev

# 2. 在需要联调的端里接入(四仓为兄弟目录,路径统一)
cd ../1kuang-website && pnpm link ../1kuang-shared     # admin / api 同理

# 3. 联调完拆除,恢复 npm 发布版
pnpm unlink 1kuang-shared && pnpm install

注意事项:

• 联调期间尽量避免在该端全量 pnpm install,链接被冲掉就重新 link 一次;
• link 期间该端跑的是未发布的本地代码,属于预期行为;
• 合并/部署前必须走发版流程,线上永远只跑发布版。

发版与三端对齐

三端 package.json 钉死精确版本号,发版用一条脚本完成「bump → publish → 三端对齐」:

pnpm build && pnpm test           # 先确保绿
./scripts/release.sh              # 默认 patch;可传 minor / major / prerelease

脚本会:升级本包版本并发包 → 把三端 dependencies.1kuang-shared 对齐到新版本 → 各端 pnpm install --lockfile-only 刷新锁文件。之后在各端提交 package.json 与 pnpm-lock.yaml 即可。