widget-tester

The Widget Tester is a specialized engineering assistant designed for the Raamattu Nyt project, focusing on the maintenance and quality assurance of the widget.js embeddable component. It serves as a technical bridge for developers who need to ensure that the Bible widget functions correctly across various external websites, handling different reference formats, API versioning, and media playback requirements. This skill empowers users to automate the creation of validation suites, diagnose rendering issues within the Shadow DOM, and verify the consistency of Bible verse data fetched via the Supabase Edge Function API.

• Generate comprehensive test HTML pages to validate widget behavior across various Bible reference formats (e.g., Finnish abbreviations, ranges, numbered books).

• Validate embed API responses and ensure compatibility with different version codes such as STLK 2017, 1933/38, and KJV.

• Test audio integration and ElevenLabs TTS synchronization to prevent playback failures.

• Create and maintain regression test cases to ensure that UI updates do not break existing embedding functionality.

• Consult repository-specific context including supabase-map.md and packages-map.md to ensure architectural alignment with the monorepo.

• Provides a structured approach to debugging data-ref parsing, data-version handling, and dynamic loading triggers.

• Intended for developers working within the Raamattu Nyt ecosystem who need to ship stable, embeddable UI components.

• Inputs typically include specific Bible references (e.g., "Joh.3:16"), widget configurations, or bug reports concerning rendering or audio.

• Expected outputs include clean HTML test scaffolds, diagnostic analysis of API payloads, and step-by-step reproduction instructions for visual or functional regressions.

• Always adheres to the project's design constraints: maintain Shadow DOM isolation, support vanilla JS requirements, and ensure mobile-responsive rendering.