NgRx Signals 中 DeepSignal 未导出问题解析

问题背景

在 Angular 18 项目中，当开发者尝试使用 NgRx Signals 的 signalStore 功能处理嵌套对象时，会遇到一个类型相关的编译错误。错误提示表明编译器无法识别 DeepSignal 类型，导致构建过程失败。

问题表现

具体表现为：

1. 使用 WebStorm 或执行 ng build 命令时出现错误提示
2. 错误信息明确指出需要引用 @ngrx/signals/src/deep-signal 模块
3. 临时解决方案包括：
   • 将 tsconfig.json 中的 declaration 设置为 false
   • 手动添加 DeepSignal 的导出声明

技术分析

DeepSignal 是 NgRx Signals 内部使用的一个关键类型，用于处理嵌套信号对象。当前版本（18.0.0-beta.1）中，该类型未在公共 API 中导出，导致以下问题：

1. 类型推断问题：当 signalStore 处理嵌套对象时，内部会使用 DeepSignal 类型
2. 类型声明生成：在构建 Angular 库时，编译器需要明确所有使用类型的导出位置
3. 模块隔离性：库开发场景下，类型必须显式导出才能被外部消费

解决方案

官方已在后续版本中修复此问题。对于遇到此问题的开发者，可以采取以下措施：

1. 升级 NgRx Signals：使用已修复该问题的版本
2. 临时解决方案：

   // 在项目中添加类型声明
   declare module '@ngrx/signals' {
     export type DeepSignal<T> = import('@ngrx/signals/src/deep-signal').DeepSignal<T>;
   }
   

3. 调整构建配置：如非必要，可暂时关闭声明文件生成

最佳实践建议

1. 在使用 beta 版本时，应密切关注官方更新日志
2. 库开发中，所有使用的类型都应确保可被导出
3. 遇到类似类型问题时，可优先检查相关类型的导出状态

总结

这个问题展示了类型系统在 Angular 库开发中的重要性。DeepSignal 作为 NgRx Signals 内部实现的关键部分，其导出状态直接影响着开发体验。开发者在使用新兴功能时，应当注意这类边界情况，并及时跟进官方更新。