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 需求，并确保行动装置响应式渲染。