Biome项目中的TypeScript类型导入属性限制问题解析

TypeScript 5.3引入了一个重要的新特性：在CommonJS模块系统中支持使用import type语法结合resolution-mode导入属性。这一特性对于处理混合模块系统(CommonJS和ESM)的项目尤为重要，但在Biome工具链中却遇到了语法规则的限制。

问题背景

在TypeScript项目中，当项目配置为CommonJS(未设置"type": "module")，但使用了nodenext模块和模块解析策略时，如果导入的第三方包(如chalk)是纯ESM模块，开发者需要使用特定的导入语法来获取类型定义：

import type { ChalkInstance } from "chalk" with { "resolution-mode": "import" };

这种语法是TypeScript 5.3+官方支持的特性，用于解决CommonJS项目中导入ESM模块类型定义的问题。然而，Biome的语法检查规则noTypeOnlyImportAttributes目前对此有严格限制，导致项目无法正常使用Biome进行代码格式化和静态检查。

技术细节分析

当前Biome的限制

Biome当前的实现只允许.cts(CommonJS TypeScript)文件使用这种带有导入属性的类型导入语法。这种限制源于：

1. 类型导入属性最初是为ESM模块设计的
2. CommonJS环境下的类型导入是较新的特性
3. Biome团队采取了保守的实现策略

实际开发中的痛点

在实际开发中，开发者面临以下问题：

1. 必须将普通.ts文件重命名为.cts才能通过Biome检查
2. 无法使用biome-ignore指令跳过这条语法规则
3. 混合模块系统项目难以保持一致的代码风格

解决方案探讨

短期解决方案

目前开发者可以采取的临时解决方案包括：

1. 将相关文件扩展名改为.cts
2. 暂时禁用Biome的类型检查功能
3. 使用项目级配置排除特定文件的检查

长期改进方向

从技术实现角度，Biome应该考虑以下改进：

1. 放宽noTypeOnlyImportAttributes规则，支持.ts文件中的类型导入属性
2. 增加对TypeScript 5.3+新特性的完整支持
3. 提供更灵活的规则配置选项

技术实现建议

对于想要贡献代码解决此问题的开发者，可以考虑以下实现路径：

1. 修改语法规则检查逻辑，识别resolution-mode导入属性
2. 更新AST解析器，正确处理类型导入属性
3. 添加测试用例，覆盖CommonJS环境下的类型导入场景

总结

TypeScript生态系统中模块系统的演进带来了新的语法特性，工具链需要及时适应这些变化。Biome作为新兴的JavaScript/TypeScript工具链，在处理这类边缘案例时需要平衡严格性和灵活性。这个问题不仅反映了工具链对新特性的支持程度，也体现了现代JavaScript生态系统中模块系统过渡期的复杂性。