@tyndall/test-playwright

Overview

Scenario-driven Playwright testing package for end-to-end validation and report generation.

Responsibilities

• Load and validate scenario definitions
• Execute scenario steps against running apps
• Produce console, json, and html reports with extension hooks
• Guard app launch ports to avoid attaching scenarios to stale pre-existing servers
• Stabilize async UI assertions through polling-based selector expectation checks

Public API Highlights

• ScenarioLoader and ScenarioValidator
• PlaywrightRunner and StepExecutor
• Reporter interfaces

Development

• Build: bun run --filter @tyndall/test-playwright build
• Test (from workspace root): bun test

Documentation

• Package specification: spec.md
• Package architecture: architecture.md
• Package changes: CHANGELOG.md

Maintenance Rules

• Keep this document aligned with implemented package behavior.
• Update spec.md and architecture.md whenever package contracts or design boundaries change.
• Record user-visible package changes in CHANGELOG.md.