fix(playwright): adapter to support Page and FrameLocator

[gpichot]

Summary

This PR refactors the Playwright adapter to properly support both Playwright Page and FrameLocator objects, improving type safety and fixing issues with the selectOption method's return type.

Key Changes

• Separated interface concerns: Created a new PwPage interface to represent the minimal surface needed from a Playwright Page or FrameLocator, distinct from PwLocatable which represents individual locators
• Updated function signature: Changed playwright() to accept PwPage | PwLocatable instead of just PwLocatable, allowing it to work with both page-level and locator-level objects
• Fixed selectOption return type: Updated the return type from Promise<void> to Promise<string[]> to match Playwright's actual API
• Introduced locatable getter: Added a private getter that safely casts this.pw to PwLocatable for methods that require locator-specific operations
• Updated method implementations: All action methods (click, fill, check, etc.) now use the locatable getter to ensure type safety
• Fixed selectOption implementation: Made it properly async and discards the return value as expected by the adapter interface
• Updated test file: Modified e2e tests to cast .get() results to PwLocator for Playwright's expect() assertions
• Fixed TypeScript config: Changed rootDir from "./src" to "." in example-react to include e2e tests in compilation

Implementation Details

The refactoring maintains backward compatibility while improving the adapter's flexibility. The separation of PwPage and PwLocatable interfaces allows the adapter to handle both entry points (page/frame) and nested locators without type confusion. The locatable getter provides a clean way to access locator-specific methods while keeping the public API flexible.

https://claude.ai/code/session_01NLDZ5mExRobdxnCYZse77Z

[netlify]

✅ Deploy Preview for ui-testing-library ready!

Name	Link
🔨 Latest commit	761535c
🔍 Latest deploy log	https://app.netlify.com/projects/ui-testing-library/deploys/69c46eef463b4600081bd282
😎 Deploy Preview	https://deploy-preview-4--ui-testing-library.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.