esbuild 对 TypeScript 5.5.0 新特性 `${configDir}` 模板变量的支持解析

在 TypeScript 5.5.0 版本中引入了一个重要的新特性——${configDir} 模板变量，这个特性主要用于 tsconfig.json 配置文件中的路径解析。作为前端构建工具链中的重要一环，esbuild 需要及时适配这一新特性以确保对最新 TypeScript 项目的兼容性。

${configDir} 模板变量的设计初衷是为了简化 tsconfig.json 中路径引用的编写。它代表的是包含当前 tsconfig.json 文件的目录路径，开发者可以用它来构建相对于配置文件目录的路径引用。这在项目结构复杂或需要跨目录引用时特别有用。

在实现层面，当 esbuild 处理 tsconfig.json 中的 baseUrl 和 paths 配置时，如果遇到以 ${configDir} 开头的路径字符串，需要进行特殊处理。具体转换规则是：

1. 将 ${configDir} 前缀替换为 ./
2. 然后将这个相对路径解析为相对于根级 tsconfig.json 文件所在目录的绝对路径

值得注意的是，这种替换只适用于字符串开头位置的 ${configDir}，字符串中间出现的不会被处理。此外，替换后的路径会保留原有的斜杠结构，例如 ${configDir}/lib 会被转换为 ./lib，然后进一步解析为绝对路径。

对于开发者而言，这意味着在升级到 TypeScript 5.5.0 后，可以更灵活地组织项目结构，特别是在以下场景中受益：

1. 多包项目（monorepo）中共享配置
2. 需要从不同目录层级引用公共代码
3. 构建工具链需要解析复杂的路径映射关系

esbuild 的及时适配确保了构建工具链的连续性，使开发者能够无缝地使用 TypeScript 5.5.0 的新特性而不会遇到构建警告或错误。这也体现了 esbuild 作为现代构建工具对 TypeScript 生态系统的紧密跟进。

对于项目维护者来说，理解这一适配背后的技术细节有助于更好地调试构建问题，特别是在处理复杂项目结构或自定义路径映射时。同时，这也为未来可能的路径解析相关特性扩展提供了参考实现模式。