docs: add documentation for e2e tests

Author: pkerschbaum

e2e-tests/code-editing-and-ast-interaction.spec.ts

@@ -1,5 +1,15 @@
+/**
+ * Tests for code editing functionality and AST tool interaction.
+ */
 import test, { expect } from "@playwright/test";
 
+/**
+ * This test verifies that:
+ * - Users can edit code in the editor
+ * - The AST updates in response to code changes
+ * - ESQuery selectors correctly highlight matching code and AST nodes
+ * - AST node expansion functionality works properly
+ */
 test(`should change code, then highlight code and AST nodes matching ESQuery selector`, async ({
 	page,
 }) => {

e2e-tests/light-dark-theme.spec.ts

@@ -1,5 +1,15 @@
+/**
+ * Tests for theme switching functionality.
+ */
+
 import { test, expect } from "@playwright/test";
 
+/**
+ * This test verifies that:
+ * - The application shows light theme by default
+ * - Users can toggle between light and dark themes
+ * - Theme changes are visually reflected in the UI
+ */
 test("should show light theme by default and switch to dark theme", async ({
 	page,
 }) => {

e2e-tests/options.spec.ts

@@ -1,5 +1,14 @@
+/**
+ * Tests for language selection and options panel functionality.
+ */
 import { test, expect } from "@playwright/test";
 
+/**
+ * This test verifies that:
+ * - Users can open the language options popover
+ * - Users can switch between supported languages (JavaScript, JSON, Markdown, CSS)
+ * - For each language the entire page is correctly rendered
+ */
 test("should switch language and show options for each", async ({ page }) => {
 	await page.goto("/");
 

e2e-tests/tools.spec.ts

@@ -1,5 +1,14 @@
+/**
+ * Tests for the Code Analysis Tools Panel.
+ */
 import { test, expect } from "@playwright/test";
 
+/**
+ * This test verifies that:
+ * - Users can switch between different code analysis tools (AST, Scope, Code Path)
+ * - Each tool displays correctly
+ * - Tool-specific interactions work as expected (e.g. scope selection)
+ */
 test("should switch to each tool and show it", async ({ page }) => {
 	await page.goto("/");