feature: e2e manual tests

.e2e-verification

@@ -0,0 +1 @@
+0e6ec972274b1909a8d4303fe3632de6139517993d55fe8edb9dc1be0c814a39

.env.example

@@ -0,0 +1,18 @@
+# Foundry VTT E2E Configuration
+# Copy this file to .env and fill in your local values
+
+# The base URL of your local Foundry instance
+FOUNDRY_URL=http://localhost:30000
+
+# Optional: The admin password to log into the /setup screen
+# Only required if the server is at the setup screen and locked
+FOUNDRY_ADMIN_PASSWORD=
+
+# The name (id) of the world to launch and test in
+FOUNDRY_E2E_WORLD=e2e-test-world
+
+# The username (case-sensitive) to log in as in the world
+FOUNDRY_E2E_USER=Gamemaster
+
+# The password for the world user
+FOUNDRY_E2E_PASSWORD=

.github/workflows/e2e-check.yml

@@ -0,0 +1,44 @@
+name: E2E Verification Check
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  check-e2e:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+
+      - name: Verify E2E Signature
+        run: |
+          if [ ! -f .e2e-verification ]; then
+            echo "::error::.e2e-verification file is missing. You must run 'npm run test:e2e:verify' locally and push the resulting commit."
+            exit 1
+          fi
+
+          # Function to calculate hash (MUST match scripts/e2e-verify.sh)
+          calculate_hash() {
+              git ls-files -z src/ e2e/ public/ package.json package-lock.json playwright.config.ts vite.config.ts tsconfig*.json .tool-versions | \
+              sort -z | \
+              xargs -0 sha256sum | \
+              sha256sum | \
+              cut -d ' ' -f 1
+          }
+
+          EXPECTED_HASH=$(cat .e2e-verification | tr -d '[:space:]')
+          ACTUAL_HASH=$(calculate_hash)
+
+          echo "Expected hash: $EXPECTED_HASH"
+          echo "Actual hash:   $ACTUAL_HASH"
+
+          if [ "$EXPECTED_HASH" != "$ACTUAL_HASH" ]; then
+            echo "::error::E2E verification hash mismatch. Source files or configuration have changed since the last E2E verification. Please run 'npm run test:e2e:verify' locally and push the updated .e2e-verification file."
+            exit 1
+          fi
+
+          echo "✅ E2E verification is valid for the current content."

.gitignore

@@ -8,3 +8,7 @@ dist/
 
 .env.foundryvtt.local
 /.junie/
+/playwright-report/
+/test-results/
+/.env
+e2e/.auth/

.prettierignore

@@ -3,3 +3,4 @@ dist/
 node_modules/
 external-types/
 external-dts/
+e2e/.auth/

DEVELOPMENT.md

@@ -74,4 +74,10 @@ To ensure project stability and type safety, **always** run the following comman
 
 1.  **Type Checking**: Run `npx tsc --noEmit` to ensure there are no TypeScript errors.
 2.  **Tests**: Run `npm run test` to ensure all Vitest tests pass.
-3.  **Linting**: Run `npm run lint` and `npm run fmt:check` to ensure code style compliance.
+3.  **Manual E2E Testing**:
+    - Copy `.env.example` to `.env`.
+    - Configure `FOUNDRY_URL`, `FOUNDRY_E2E_WORLD`, and `FOUNDRY_E2E_USER`.
+    - Ensure your local FoundryVTT is running and the test world has the module enabled.
+    - Run `npm run test:e2e` to execute the Playwright tests.
+    - Run `npm run test:e2e:ui` to open the Playwright UI for debugging.
+4.  **Linting**: Run `npm run lint` and `npm run fmt:check` to ensure code style compliance.