chore: adds work in progress

Author: nunomaduro

.gitignore

@@ -10,3 +10,10 @@ coverage.xml
 *.swp
 *.swo
 .phpunit.cache
+
+# Playwright
+node_modules/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/

.temp/e2e/.gitkeep

@@ -0,0 +1,6 @@
+import { test, expect } from '@playwright/test';
+
+test('runtime', async ({ page }) => {
+    await page.goto('https://laravel.com');
+await expect(page).toHaveTitle(/Laravel/);
+});

.temp/e2e/runtime.spec.js

@@ -14,11 +14,12 @@
     "require": {
         "php": "^8.2",
         "pestphp/pest": "^3.0.0",
-        "pestphp/pest-plugin": "^3.0.0"
+        "pestphp/pest-plugin": "^3.0.0",
+        "symfony/process": "^7.2"
     },
     "autoload": {
         "psr-4": {
-            "Pest\\PluginName\\": "src/"
+            "Pest\\Browser\\": "src/"
         },
         "files": [
             "src/Autoload.php"

composer.json

@@ -0,0 +1,25 @@
+{
+  "name": "pest-plugin-browser",
+  "version": "1.0.0",
+  "description": "This repository contains the Pest Plugin Browser.",
+  "main": "index.js",
+  "directories": {
+    "test": "tests"
+  },
+  "scripts": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pestphp/pest-plugin-browser.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/pestphp/pest-plugin-browser/issues"
+  },
+  "homepage": "https://github.com/pestphp/pest-plugin-browser#readme",
+  "devDependencies": {
+    "@playwright/test": "^1.50.1",
+    "@types/node": "^22.13.1"
+  }
+}

package-lock.json

@@ -0,0 +1,83 @@
+// @ts-check
+import { defineConfig, devices } from '@playwright/test';
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// import dotenv from 'dotenv';
+// import path from 'path';
+// dotenv.config({ path: path.resolve(__dirname, '.env') });
+
+/**
+ * @see https://playwright.dev/docs/test-configuration
+ */
+export default defineConfig({
+  testDir: './.temp/e2e',
+  /* Run tests in files in parallel */
+  fullyParallel: true,
+  /* Fail the build on CI if you accidentally left test.only in the source code. */
+  forbidOnly: !!process.env.CI,
+  /* Retry on CI only */
+  retries: process.env.CI ? 2 : 0,
+  /* Opt out of parallel tests on CI. */
+  workers: process.env.CI ? 1 : undefined,
+  /* Reporter to use. See https://playwright.dev/docs/test-reporters */
+  reporter: 'html',
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    /* Base URL to use in actions like `await page.goto('/')`. */
+    // baseURL: 'http://127.0.0.1:3000',
+
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+  },
+
+  /* Configure projects for major browsers */
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+
+      /*
+
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+
+    /* Test against mobile viewports. */
+    // {
+    //   name: 'Mobile Chrome',
+    //   use: { ...devices['Pixel 5'] },
+    // },
+    // {
+    //   name: 'Mobile Safari',
+    //   use: { ...devices['iPhone 12'] },
+    // },
+
+    /* Test against branded browsers. */
+    // {
+    //   name: 'Microsoft Edge',
+    //   use: { ...devices['Desktop Edge'], channel: 'msedge' },
+    // },
+    // {
+    //   name: 'Google Chrome',
+    //   use: { ...devices['Desktop Chrome'], channel: 'chrome' },
+    // },
+  ],
+
+  /* Run your local dev server before starting the tests */
+  // webServer: {
+  //   command: 'npm run start',
+  //   url: 'http://127.0.0.1:3000',
+  //   reuseExistingServer: !process.env.CI,
+  // },
+});
+

package.json

@@ -2,17 +2,13 @@
 
 declare(strict_types=1);
 
-namespace Pest\PluginName;
+namespace Pest\Browser;
 
 use Pest\Plugin;
-use PHPUnit\Framework\TestCase;
 
 Plugin::uses(Example::class);
 
-/**
- * @return TestCase
- */
-function example(string $argument)
+function visit(string $url): PendingTest
 {
-    return test()->example(...func_get_args()); // @phpstan-ignore-line
+    return (new PendingTest)->visit($url);
 }

playwright.config.js

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pest\Browser;
+
+use Pest\Browser\Contracts\Operation;
+
+/**
+ * @internal
+ */
+final class Compiler
+{
+    /**
+     * The path to the tests.
+     */
+    private const TEST_PATH = __DIR__.'/../.temp/e2e/runtime.spec.js';
+
+    /**
+     * @param  array<int, Operation>  $operations
+     */
+    public function __construct(
+        private array $operations
+    ) {
+        //
+    }
+
+    /**
+     * Compiles the operations.
+     */
+    public function compile(): void
+    {
+        $content = implode(
+            "\n",
+            array_map(
+                static fn (Operation $operation): string => $operation->compile(),
+                $this->operations,
+            ),
+        );
+
+        file_put_contents(self::TEST_PATH, <<<JS
+            import { test, expect } from '@playwright/test';
+
+            test('runtime', async ({ page }) => {
+                $content
+            });
+            JS,
+        );
+    }
+}

src/Autoload.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pest\Browser\Contracts;
+
+/**
+ * @internal
+ */
+interface Operation
+{
+    /**
+     * Compile the operation to JavaScript code.
+     */
+    public function compile(): string;
+}