Merge branch 'main' into chore/update-eslint-dependencies

Author: lumirlumir

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

@@ -1,8 +1,17 @@
 /**
- * Tests for code editing functionality and AST tool interaction.
+ * @fileoverview Tests for code editing functionality and AST tool interaction.
  */
+
+//-----------------------------------------------------------------------------
+// Imports
+//-----------------------------------------------------------------------------
+
 import { expect, test } from "@playwright/test";
 
+//-----------------------------------------------------------------------------
+// Type Definitions
+//-----------------------------------------------------------------------------
+
 type HighlightSamplesState = {
 	intervalId: number;
 	samples: string[];
@@ -14,6 +23,10 @@ declare global {
 	}
 }
 
+//-----------------------------------------------------------------------------
+// Tests
+//-----------------------------------------------------------------------------
+
 /**
  * This test verifies that:
  * - Users can edit code in the editor

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

@@ -1,9 +1,17 @@
 /**
- * Tests for theme switching functionality.
+ * @fileoverview Tests for theme switching functionality.
  */
 
+//-----------------------------------------------------------------------------
+// Imports
+//-----------------------------------------------------------------------------
+
 import { expect, test } from "@playwright/test";
 
+//-----------------------------------------------------------------------------
+// Tests
+//-----------------------------------------------------------------------------
+
 /**
  * This test verifies that:
  * - The application shows light theme by default

e2e-tests/options.test.ts

@@ -1,8 +1,17 @@
 /**
- * Tests for language selection and options panel functionality.
+ * @fileoverview Tests for language selection and options panel functionality.
  */
+
+//-----------------------------------------------------------------------------
+// Imports
+//-----------------------------------------------------------------------------
+
 import { expect, test } from "@playwright/test";
 
+//-----------------------------------------------------------------------------
+// Tests
+//-----------------------------------------------------------------------------
+
 /**
  * This test verifies that:
  * - Users can open the language options popover

e2e-tests/persistence.test.ts

@@ -1,5 +1,17 @@
+/**
+ * @fileoverview Tests for state persistence functionality.
+ */
+
+//-----------------------------------------------------------------------------
+// Imports
+//-----------------------------------------------------------------------------
+
 import { expect, test, type Page } from "@playwright/test";
 
+//-----------------------------------------------------------------------------
+// Helpers
+//-----------------------------------------------------------------------------
+
 const storageKey = "eslint-explorer";
 
 async function getPersistedJavaScriptCode(page: Page): Promise<string> {
@@ -47,6 +59,10 @@ async function replaceEditorValue(page: Page, value: string) {
 	await codeEditor.pressSequentially(value);
 }
 
+//-----------------------------------------------------------------------------
+// Tests
+//-----------------------------------------------------------------------------
+
 test("should persist unicode code safely in the URL hash", async ({ page }) => {
 	await page.addInitScript(key => {
 		window.localStorage.removeItem(key);

e2e-tests/tools.test.ts

@@ -1,8 +1,17 @@
 /**
- * Tests for the Code Analysis Tools Panel.
+ * @fileoverview Tests for the Code Analysis Tools Panel.
  */
+
+//-----------------------------------------------------------------------------
+// Imports
+//-----------------------------------------------------------------------------
+
 import { expect, test } from "@playwright/test";
 
+//-----------------------------------------------------------------------------
+// Tests
+//-----------------------------------------------------------------------------
+
 /**
  * This test verifies that:
  * - Users can switch between different code analysis tools (AST, Scope, Code Path)