工程引用如何划分大型项目的编译单元与类型依赖方向

# 核心结论

工程引用应按照公共接口、运行环境以及可独立构建或发布的边界，把大型 TypeScript 仓库划分为多个编译单元，并用 references 明确类型依赖方向。引用图应与真实包依赖大体一致，保持有向无环；下游只能通过上游公开入口及声明产物消费类型，不能穿透目录直接读取内部源码。合理拆分既能限制浏览器、服务器和测试环境类型相互污染，也能让构建器只处理真正受到变化影响的节点。

# 底层机制

被引用项目通常需要启用 composite，以建立可预测的输入集合、输出和构建状态。项目作为其他项目的依赖时，通常还应生成声明文件，使下游从公开类型表面观察它，而不是把上游所有源码再次纳入自身编译。构建模式通过