Add end-to-end tests for JaSketch application

- Created test suite for JaSketch with comprehensive E2E tests covering UI rendering, tool selection, shape drawing, text editing, undo/redo, deletion, export, and zoom/pan functionalities.
- Implemented shared fixtures in `conftest.py` to manage JaSketch server lifecycle and provide a base URL for tests.
- Added various test cases to validate the behavior of drawing tools, element manipulation, context menu operations, and persistence across page reloads.
- Ensured tests are structured for clarity and maintainability, with helper functions for common actions.

Author: MalithaPrabhashana

.github/workflows/e2e-tests.yml

@@ -0,0 +1,56 @@
+name: JaSketch E2E Tests
+
+on:
+  push:
+    branches: [main, dev]
+    paths:
+      - "jasketch/**"
+  pull_request:
+    branches: [main]
+    paths:
+      - "jasketch/**"
+  workflow_dispatch:
+
+defaults:
+  run:
+    working-directory: jasketch
+
+jobs:
+  e2e-tests:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up Node.js 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install Jac and dependencies
+        run: |
+          pip install jaclang jac-client jac-scale pytest pytest-playwright pytest-timeout
+
+      - name: Install Playwright browsers
+        run: python -m playwright install --with-deps chromium
+
+      - name: Install app dependencies
+        run: jac install
+
+      - name: Run E2E tests
+        run: pytest tests/e2e/ -v --timeout=300
+
+      - name: Upload test results
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: e2e-test-results
+          path: jasketch/tests/e2e/
+          retention-days: 7

tests/__init__.py

@@ -0,0 +1,63 @@
+"""Shared fixtures for JaSketch E2E tests."""
+
+import os
+import socket
+import subprocess
+import time
+
+import pytest
+from playwright.sync_api import Page
+
+JASKETCH_DIR = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), "..", "..")
+)
+APP_READY_TIMEOUT = 60_000  # 1 min for app to render
+
+
+def _get_free_port() -> int:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.bind(("127.0.0.1", 0))
+        return s.getsockname()[1]
+
+
+def _wait_for_port(port: int, timeout: float = 60.0) -> bool:
+    deadline = time.time() + timeout
+    while time.time() < deadline:
+        try:
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                s.connect(("127.0.0.1", port))
+                return True
+        except OSError:
+            time.sleep(0.5)
+    return False
+
+
+@pytest.fixture(scope="session")
+def base_url():
+    """Start the JaSketch server, yield its base URL."""
+    port = _get_free_port()
+    proc = subprocess.Popen(
+        ["jac", "start", "--port", str(port)],
+        cwd=JASKETCH_DIR,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+    assert _wait_for_port(port), f"Server failed to start on port {port}"
+    yield f"http://127.0.0.1:{port}"
+    proc.terminate()
+    try:
+        proc.wait(timeout=10)
+    except subprocess.TimeoutExpired:
+        proc.kill()
+
+
+@pytest.fixture(scope="module")
+def app(browser, base_url) -> Page:
+    """Navigate to JaSketch, wait for canvas to be ready."""
+    context = browser.new_context(permissions=["clipboard-read", "clipboard-write"])
+    page = context.new_page()
+    page.goto(base_url, wait_until="load")
+    # Wait for the canvas element to be visible (app is rendered)
+    page.locator("canvas").first.wait_for(state="visible", timeout=APP_READY_TIMEOUT)
+    yield page
+    context.close()