Add the Playwright Interactor adapter

[cowboyd]

Motivation

The compiled artifact set needs a Playwright-side consumer that is type-safe in the test process while executing the real Interactor implementation against the browser DOM.

Approach

Add @interactors/playwright, which validates the compiled registry, installs the browser agent for the current document and later navigations, and exposes typed remote proxies derived from the generated declarations. Commands cross page.evaluate() with protocol and registry identity, supporting actions, assertions, nested Interactors, regular expressions, and built-in or custom matchers. Remote failures retain their browser error details.

Remote proxies intentionally omit raw filter getter methods. Tests assert filter values through has() or is(), preserving Interactors' convergence and diagnostics instead of extracting a value for a runner-side equality assertion.

Register the package with the release configuration and derive prerelease npm tags from Git tags so alpha releases remain off latest.

Alternate Designs

Reimplementing Interactors with Playwright locators would duplicate behavior and allow the two implementations to drift. Importing browser-oriented constructors directly into the Playwright process would execute them in the wrong DOM context. The proxy and agent boundary keeps one implementation in the browser.

Possible Drawbacks or Risks

Command inputs must be JSON-shaped values, regular expressions, or remote matchers, and returned values must be serializable by Playwright. The current transport targets the page's main frame and expects one loader call per Page; popup pages must be loaded separately.

TODOs and Open Questions

Supporting child-frame-specific adapters can be considered separately.

Learning

Playwright's init-script lifecycle applies to both navigations and child frames. The adapter guards installation to the main frame and disposes the registered script when its initial agent handshake fails.

Code passed to page.evaluate() cannot safely close over DNT-generated module shims. Browser callbacks instead discover their window through the document passed across the Playwright boundary.

Screenshots

Not applicable; this is a test-runner integration API.

[github-actions]

Package Changes Through 80cf510

There are 1 changes which include @interactors/core with minor

Planned Package Versions

The following package releases are the planned based on the context of changes in this pull request.

package	current	next
@interactors/core	1.0.1	1.1.0
@interactors/cli	1.0.0	1.0.1
@interactors/keyboard	1.0.1	1.0.2
@interactors/html	1.0.1	1.0.2
@interactors/material-ui	5.0.0	5.0.1
@interactors/playwright	1.0.0	1.0.1

Add another change file through the GitHub UI by following this link.

---

Read about change files or the docs at github.com/jbolda/covector

[github-actions]

🚀 Deploy Preview Ready!

• Stable Review Link: https://pr-324--interactors.netlify.app
• Latest Commit Snapshot: https://6aa18bc24b5bfc00b9f933d0--interactors.netlify.app