Rework Driver tests

Author: smnandre

.github/workflows/ci.yml renamed to .github/workflows/CI.yml

@@ -20,7 +20,7 @@ jobs:
         with:
           php-version: '8.4'
           coverage: none
-          tools: composer
+          tools: composer, phpstan, php-cs-fixer
 
       - name: Composer cache
         uses: actions/cache@v4
@@ -33,12 +33,12 @@ jobs:
         run: composer install --no-interaction --prefer-dist --no-progress
 
       - name: PHPStan (max level)
-        run: vendor/bin/phpstan analyse --no-progress
+        run: phpstan analyse --no-progress
 
       - name: PHP-CS-Fixer (dry-run)
         run: |
           if [ -f .php-cs-fixer.php ]; then
-            vendor/bin/php-cs-fixer fix --diff --dry-run
+            php-cs-fixer fix --diff --dry-run
           else
             echo "No .php-cs-fixer.php; skipping."
           fi
@@ -80,14 +80,44 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
 
-      - name: Install Playwright (${{ matrix.browser }})
-        run: npx playwright install --with-deps ${{ matrix.browser }}
+      - name: Cache Playwright browsers
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/ms-playwright
+          key: ms-playwright-${{ runner.os }}-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ms-playwright-${{ runner.os }}-
+
+      - name: Install Playwright (browsers + system deps)
+        run: vendor/bin/playwright-install --with-deps
 
       - name: Start Mink test server
         run: vendor/bin/mink-test-server > mink-test-server.log 2>&1 &
         shell: bash
 
+      - name: Wait for Mink test server to be ready
+        run: |
+          for i in {1..60}; do
+            if curl -fsS http://127.0.0.1:8002/ >/dev/null; then
+              echo "Mink test server is up"; exit 0;
+            fi
+            sleep 1;
+          done
+          echo "Mink test server did not become ready in time"; exit 1
+
       - name: PHPUnit (Mink driver testsuite)
         run: vendor/bin/phpunit --colors=always
+
+      - name: Show Mink server log on failure
+        if: failure()
+        run: |
+          echo "==== mink-test-server.log ===="
+          tail -n +1 mink-test-server.log || true
+
+      - name: Upload Mink server log artifact
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: mink-test-server-log-${{ matrix.php }}-${{ matrix.browser }}
+          path: mink-test-server.log
+          if-no-files-found: ignore

README.md

@@ -12,6 +12,13 @@
 
 A [Mink](https://mink.behat.org/) driver powered by **[Playwright PHP](https://github.com/playwright-php)**.
 
+
+> [!IMPORTANT]  
+> This package is **experimental**. Its API may still change before the upcoming `1.0` release.  
+>  
+> Curious or interested? Try it out, [share your feedback](https://github.com/playwright-php/playwright-mink/issues), or ideas!
+
+
 ## Features
 
 - Run real browsers: Chromium, Firefox, WebKit (headless or not)  
@@ -22,7 +29,7 @@ A [Mink](https://mink.behat.org/) driver powered by **[Playwright PHP](https://g
 
 **Requirements**
 
-- PHP 8.3 or higher
+- PHP 8.2 or higher
 - [Playwright PHP](https://github.com/playwright-php/playwright)
 
 **Install the driver**
@@ -52,6 +59,8 @@ $session->stop();
 
 This driver is validated against the official [`minkphp/driver-testsuite`](https://github.com/minkphp/driver-testsuite).
 
+**Test Results**: 212/218 tests passing (97.2%) with 491 assertions
+
 **Start the test server**
 
 ```bash
@@ -64,6 +73,13 @@ vendor/bin/mink-test-server
 vendor/bin/phpunit
 ```
 
+### Known Limitations
+
+6 tests are skipped due to known limitations:
+
+- **jQuery UI Drag & Drop** (2 tests): jQuery UI uses mouse events API, Playwright uses HTML5 Drag & Drop API - these are incompatible
+- **Popup Window Tracking** (4 tests): Async event timing with `window.open()` requires improvements in Playwright PHP event handling
+
 ## License
 
 This package is released by the [Playwright PHP](https://playwright-php.dev) 

composer.json

@@ -4,11 +4,11 @@
     "license": "MIT",
     "type": "library",
     "keywords": [
-        "php",
         "mink",
         "mink-driver",
         "browser",
         "behat",
+        "behat-driver",
         "mink-extension",
         "playwright-php",
         "playwright"
@@ -28,8 +28,7 @@
     "require": {
         "php": "^8.2",
         "behat/mink": "^1.10",
-        "playwright-php/playwright": "dev-main",
-        "symfony/clock": "^7.3 || ^8.0"
+        "playwright-php/playwright": "dev-main"
     },
     "require-dev": {
         "mink/driver-testsuite": "dev-master",
@@ -46,6 +45,9 @@
         }
     },
     "extra": {
+        "branch-alias": {
+            "dev-main": "0.x-dev"
+        },
         "thanks": {
             "name": "playwright-php/playwright",
             "url": "https://github.com/playwright-php/playwright"