Skip to content

fix(deps): declare esbuild as a direct devDependency — dsh-settings-ui test imports it but only resolves via npm hoisting #2009

Closed

Description

@ranxianglei

来源: #2007 (PR fix(typecheck): unblock CI) 分析 master typecheck 红灯时发现

现象

影响

  • pnpm 用户(及任何非扁平 hoist 的安装方式)本地 typecheck 恒红,且会掩盖真实类型错误。
  • 测试可运行性不应依赖包管理器的提升实现细节。

建议修复

  • devDependencies 增加 "esbuild": "^0.27.0"(与 tsup 8.5.1 声明的范围一致),npm install 刷新 lockfile。纯声明变更,零运行时影响(dist 不引用 esbuild)。

Activity

  1. ranxianglei commented on Oct 3, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 已核实,问题成立,正在修复。

    审核三步结论:

    1. 复现/查证 ✅:tests/dsh-settings-ui.test.ts:241,387 两处 await import("esbuild");package.json 的 dependencies/devDependencies/optionalDependencies 均未声明 esbuild;lockfile 中顶层 node_modules/esbuild@0.27.7 来自 tsup 的传递依赖(tsup 声明 ^0.27.0)——纯 npm 扁平提升产物。本地模拟严格布局(临时移走提升副本后跑 tsc --noEmit --project tsconfig.json)精确多出 2 个新错误:
    2. 定位层次:根因是「测试直接 import 的包未声明」,表面现象是 pnpm 用户 typecheck 恒红。修法打在声明层(根因),不是绕开解析(治标)。
    3. 方案评估:issue 建议的 "esbuild": "^0.27.0" 正确且最小——与 tsup 8.5.1 声明的范围一致,npm 会 dedupe 到同一份 0.27.7,lockfile 变更极小;纯声明变更,dist 不引用 esbuild(tsbuild 期由 tsup 使用),零运行时影响。采纳。

    另注:本仓其他位置无 esbuild 直接引用(grep 全仓仅该测试文件 2 处)。查重:open/closed issues 无重复项。开始实现。

  2. ranxianglei commented on Oct 3, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 修复完成,PR 已开:**#2010 #2009)

    结构化七问:

    1. 是什么问题:测试文件直接 import 的包(esbuild)从未在 package.json 声明——依赖声明缺失,不是 esbuild 本身有问题。
    2. 什么原因导致的:tests/dsh-settings-ui.test.ts:241,387 两处 await import("esbuild");esbuild 实际是 tsup@8.5.1 的传递依赖(其声明 ^0.27.0)。npm 扁平布局把它提升到 node_modules 顶层 → 恰好可解析;pnpm 严格布局(及任何非 hoist 安装)顶层不可解析 → tsc TS2307。因果链:未声明 → 解析成功与否取决于包管理器实现细节。已实测复现:临时移走提升副本后 tsc --noEmit --project tsconfig.json 精确多出 2 个新错误(241,387 各一个 TS2307),diff 无其他变化。(issue 估 4 个、实测 2 个,机制一致。)
    3. 怎么修复的:在声明层补齐——devDependencies 加 "esbuild": "^0.27.0"。选这个范围是因为与 tsup 8.5.1 已声明的范围一致,npm dedupe 到同一份实例,不引入第二份拷贝也不动任何版本。修的是「直接依赖必须显式声明」这条根因规则,不是给 pnpm 用户打补丁。
    4. 是否有回归问题:无。全仓 grep 确认 esbuild 仅该测试文件引用(构建期由 tsup 消费,dist 零引用);lockfile diff 仅 1 行(root 包 devDeps 增项),解析版本保持 0.27.7 不变,无任何传递版本漂移;npm run typecheck(CI 门禁,tsconfig.build.json)干净;定向跑 tests/dsh-settings-ui.test.ts 7/7 通过。高危模式逐项:默认值/阈值/时序/输出格式均未触碰,纯声明变更。
    5. 是否破坏缓存:不涉及——纯 package.json/lockfile 声明变更,不触及运行时缓存、重试、增量游标或去重键。
    6. 是否改了设计方向:不涉及。
    7. 是否引入了新的配置:不涉及——无新 config 字段/env/CLI flag(devDependency 不属于配置面)。

    收工判定:可合并。2 行 diff(package.json + lockfile 各 1 行),单一模块范围,纯 fix: 且带回归证据(复现→修复→验证闭环),符合 auto-merge gate 全部条件;等 CI 绿后请人工合并。

  3. added a commit that references this issue on Oct 3, 2026
    686d0dc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions