widget-tester

Widget Tester 是一款專為 Raamattu Nyt 專案設計的工程助手，專注於 widget.js 嵌入式元件的維護與品質保證。它作為技術橋樑，協助開發者確保聖經小工具能在各類外部網站正常運作，涵蓋不同的引用格式、API 版本控制與媒體播放需求。此技能讓使用者能自動化產生驗證測試集，診斷 Shadow DOM 內的渲染問題，並驗證透過 Supabase Edge Function API 獲取的聖經經文資料一致性。

• 產生完整的 HTML 測試頁面，以驗證小工具在各種聖經引用格式（如芬蘭語縮寫、章節範圍、數字書籍）下的行為。

• 驗證嵌入 API 的回應，確保與不同版本代碼（如 STLK 2017、1933/38、KJV）的相容性。

• 測試音訊整合與 ElevenLabs TTS 同步，防止播放失敗。

• 建立並維護回歸測試案例，確保 UI 更新不會破壞現有的嵌入功能。

• 參考專案特定的背景資訊（如 supabase-map.md 與 packages-map.md），確保架構與 Monorepo 保持一致。

• 提供結構化的除錯方法，處理 data-ref 解析、data-version 處理與動態載入觸發問題。

• 專為在 Raamattu Nyt 生態系中工作的開發者設計，需求為發布穩定且可嵌入的 UI 元件。

• 輸入通常包含特定的聖經引用（例如 "Joh.3:16"）、小工具配置或有關渲染與音訊的錯誤報告。

• 預期輸出包含乾淨的 HTML 測試架構、API 負載的診斷分析，以及針對視覺或功能性回歸問題的分步重現說明。

• 始終遵守專案的設計限制：維持 Shadow DOM 隔離、支援原生 JavaScript 需求，並確保行動裝置響應式渲染。