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 中設計共享函式庫時使用，以防止內部實作細節外洩。