Advanced Modular Library Design

此技能为构建强大、可扩展且模块化的 TypeScript 库提供架构指导。通过利用 HexDI 框架，它协助开发人员定义严格的包边界，并确保编译时的类型安全依赖注入，有效消除常见的运行时注入失败。此技能专为在复杂 Monorepo 或企业级 TypeScript 环境中工作的软件架构师与资深工程师所设计，他们需要维护干净、解耦且具备高可测试性与可维护性的代码库。

• 实现依赖图的编译时验证，确保服务合约 (Ports) 在应用程序运行前皆已满足。

• 通过 Ports、Adapters 与 Containers 推广功能优先的组织结构，以强化明确的模块边界并减少循环依赖。

• 提供管理服务生命周期的策略，包括单例 (Singleton)、作用域 (Scoped) 与瞬态 (Transient) 模式，适用于 HTTP 请求上下文或共享基础设施资源等多元需求。

• 促进使用不可变的构建者模式 (Immutable Builder Pattern) 进行图组合，以便于针对测试或暂存环境进行分支与特定环境的配置。

• 支持 React 与 Hono 的高级整合模式，允许在用户界面或服务器端逻辑中进行无缝的状态注入与依赖解析。

• 输入：项目架构需求、服务接口定义或现有单体架构的重构任务。

• 输出：结构化的架构计划、依赖图配置或遵循 HexDI 原则的重构代码模式。

• 实施限制：需要 TypeScript 5.0+ 版本，且具备六角架构 (Hexagonal Architecture) 原则的基础知识以发挥最大效用。

• 用户应专注于先定义 Ports 以建立稳定的合约，接着创建 Adapters 以实现逻辑，最后使用 GraphBuilder 组装图以实现类型安全的解析。

• 最适用于从全局状态或松散耦合转换至严格验证的 DI 系统，或是在 Monorepo 中设计共享库时使用，以防止内部实现细节外泄。