生成声明文件时哪些源码设计会导致公开类型意外泄漏内部实现

# 核心结论

声明文件是库的公共类型契约，而不是构建过程中的附属物。任何能够从导出函数的参数和返回值、导出变量、公开类成员或导出类型别名到达的类型，都可能进入声明依赖图。若这些签名依赖内部文件、匿名复杂结构、私有品牌、路径别名或不稳定的第三方类型，生成的声明就可能泄漏实现细节，并让消费者依赖生产者的目录结构和安装布局。公共边界应优先使用有名称、可导出、语义稳定且只包含必要能力的类型。

# 底层机制

启用声明生成后，编译器需要把所有公开可达签名序列化为声明。显式标注的公共类型通常可以直接引用；依赖推断的导出值则要求编译器为推断结果寻找可表达形式。例如：

const internalClient = crea