summon

Summon 技能為 Summon Kotlin Multiplatform UI 框架提供專業協助，使開發人員能夠構建宣告式且類型安全的網頁與 JVM 應用程式。此工具專為需要類似 Compose 體驗且針對瀏覽器 (JS/WASM) 與伺服器端渲染 (SSR) 環境的 Kotlin 開發人員所設計。無論是使用 Summon CLI 構建專案、管理反應式狀態，還是實作複雜的路由邏輯，此技能都能作為框架規範、API 接口與建構最佳實踐的權威參考來源。

• 基於組件的架構，具有類似 Compose 的宣告式語法以及 onMount 與 onDispose 等生命週期鉤子。

• 類型安全的修飾符系統，用 Kotlin DSL 取代原始 CSS，確保透過 px、rem 與 em 等單位進行可靠的樣式設定。

• 整合式路由引擎，支援靜態、動態與捕捉所有 (catch-all) 路由，並具備自動參數處理功能。

• 完整的 SSR 與 Hydration 支援，提升網頁應用程式的 SEO 與首頁載入效能。

• 進階狀態管理工具，包含 remember、mutableStateOf 與屬性委派模式。

• 跨平台支援，涵蓋 commonMain、webMain (JS/WASM) 與 jvmMain 原始碼集層次結構。

• 內建無障礙 (ARIA) 功能與國際化 (i18n) 支援，協助開發人員打造具包容性的全球化應用程式。

• 利用 Summon CLI 進行專案生成，並在獨立 JS 或全端整合 (如 Spring Boot、Ktor 與 Quarkus) 之間進行選擇。

• 務必對公開 API 套用 @JsName 註解，以防止 JavaScript 中混淆後的命名衝突。

• 針對 0.6.0 及以上版本，嚴格遵守遷徙至 codes.yousef 套件命名空間的要求。

• 避免直接操作 DOM；請始終依賴 PlatformRenderer 及其公開方法，以確保跨平台相容性。

• 使用提供的修飾符 API 進行所有樣式設定，以維持類型安全性並受益於 Material Design 與 Catppuccin 色彩庫。

• 在除錯 WASM 建構時，請優先使用 ./gradlew clean 清除建構快取，以解決潛在的過時問題。

• 此技能需要標準的 Kotlin/JVM 工具鏈與 Gradle 配置，以進行建構自動化、測試與部署。