refactor: improve context view tests by utilizing utility functions

- Replaced direct element locators with utility functions for better readability and maintainability in context view tests.
- Removed unnecessary wait statements and replaced them with appropriate utility functions to enhance test reliability.
- Streamlined the verification process for file visibility and content loading, ensuring tests are more efficient and easier to understand.

apps/app/tests/context-view.spec.ts

@@ -76,9 +76,7 @@ test.describe("Context View - File Management", () => {
     await waitForContextFile(page, "test-context.md", 10000);
 
     // Verify file appears in list
-    const fileButton = page.locator(
+    const fileButton = await getByTestId(page, "context-file-test-context.md");
-      '[data-testid="context-file-test-context.md"]'
-    );
     await expect(fileButton).toBeVisible();
 
     // Click on the file and wait for it to be selected
@@ -96,9 +94,7 @@ test.describe("Context View - File Management", () => {
     });
 
     // Verify content in editor
-    const editorContent = await page
+    const editorContent = await getContextEditorContent(page);
-      .locator('[data-testid="context-editor"]')
-      .inputValue();
     expect(editorContent).toBe(testContent);
   });
 
@@ -234,7 +230,8 @@ test.describe("Context View - File Management", () => {
     );
 
     // Wait for image preview to appear (indicates upload success)
-    await page.waitForTimeout(500);
+    const addDialog = await getByTestId(page, "add-context-dialog");
+    await addDialog.locator("img").waitFor({ state: "visible" });
 
     // Click confirm
     await clickElement(page, "confirm-add-file");
@@ -256,7 +253,8 @@ test.describe("Context View - File Management", () => {
     await page.waitForSelector('[data-testid="image-preview"]', {
       timeout: 5000,
     });
-    await expect(page.locator('[data-testid="image-preview"]')).toBeVisible();
+    const imagePreview = await getByTestId(page, "image-preview");
+    await expect(imagePreview).toBeVisible();
   });
 
   test("should remove an image context file", async ({ page }) => {
@@ -313,24 +311,22 @@ test.describe("Context View - File Management", () => {
     await navigateToContext(page);
 
     // Click on the markdown file
-    const fileButton = page.locator(
+    const fileButton = await getByTestId(page, "context-file-preview-test.md");
-      '[data-testid="context-file-preview-test.md"]'
-    );
     await fileButton.waitFor({ state: "visible", timeout: 5000 });
     await fileButton.click();
 
-    // Wait for editor to appear (default mode for md files is preview based on component code)
+    // Wait for content to load (markdown files open in preview mode by default)
-    await page.waitForTimeout(500);
+    await waitForFileContentToLoad(page);
 
     // Check if preview button is visible (indicates it's a markdown file)
     const previewToggle = await getByTestId(page, "toggle-preview-mode");
     await expect(previewToggle).toBeVisible();
 
-    // Check current mode - if we see markdown-preview, we're in preview mode
+    // Markdown files always open in preview mode by default (see context-view.tsx:163)
+    // Verify we're in preview mode
     const markdownPreview = await getByTestId(page, "markdown-preview");
-    const isInPreviewMode = await markdownPreview.isVisible().catch(() => false);
+    await expect(markdownPreview).toBeVisible();
 
-    if (isInPreviewMode) {
     // Click to switch to edit mode
     await previewToggle.click();
     await page.waitForSelector('[data-testid="context-editor"]', {
@@ -350,26 +346,6 @@ test.describe("Context View - File Management", () => {
 
     // Verify preview is shown
     await expect(markdownPreview).toBeVisible();
-    } else {
-      // We're in edit mode, click to switch to preview
-      await previewToggle.click();
-      await page.waitForSelector('[data-testid="markdown-preview"]', {
-        timeout: 5000,
-      });
-
-      // Verify preview is shown
-      await expect(markdownPreview).toBeVisible();
-
-      // Click to switch back to edit mode
-      await previewToggle.click();
-      await page.waitForSelector('[data-testid="context-editor"]', {
-        timeout: 5000,
-      });
-
-      // Verify editor is shown
-      const editor = await getByTestId(page, "context-editor");
-      await expect(editor).toBeVisible();
-    }
   });
 });
 
@@ -412,13 +388,13 @@ test.describe("Context View - Drag and Drop", () => {
       droppedContent
     );
 
-    // Wait for content to be populated
+    // Wait for content to be populated in textarea
-    await page.waitForTimeout(500);
+    const textarea = await getByTestId(page, "new-file-content");
+    await textarea.waitFor({ state: "visible" });
+    await expect(textarea).toHaveValue(droppedContent);
 
     // Verify content is populated in textarea
-    const textareaContent = await page
+    const textareaContent = await textarea.inputValue();
-      .locator('[data-testid="new-file-content"]')
-      .inputValue();
     expect(textareaContent).toBe(droppedContent);
 
     // Verify filename is auto-filled
@@ -535,7 +511,7 @@ test.describe("Context View - Edge Cases", () => {
     await originalFile.click();
 
     // Wait for content to load
-    await page.waitForTimeout(500);
+    await waitForFileContentToLoad(page);
 
     // Switch to edit mode (markdown files open in preview mode)
     await switchToEditMode(page);
@@ -599,7 +575,7 @@ test.describe("Context View - Edge Cases", () => {
     await fileWithHyphens.click();
 
     // Wait for content to load
-    await page.waitForTimeout(500);
+    await waitForFileContentToLoad(page);
 
     // Switch to edit mode (markdown files open in preview mode)
     await switchToEditMode(page);
@@ -643,7 +619,7 @@ test.describe("Context View - Edge Cases", () => {
     await emptyFile.click();
 
     // Wait for content to load
-    await page.waitForTimeout(500);
+    await waitForFileContentToLoad(page);
 
     // Switch to edit mode (markdown files open in preview mode)
     await switchToEditMode(page);
@@ -706,9 +682,7 @@ test.describe("Context View - Edge Cases", () => {
       timeout: 5000,
     });
 
-    const persistedContent = await page
+    const persistedContent = await getContextEditorContent(page);
-      .locator('[data-testid="context-editor"]')
-      .inputValue();
     expect(persistedContent).toBe(testContent);
   });
 });

apps/app/tests/utils/views/context.ts

@@ -144,9 +144,6 @@ export async function selectContextFile(
   const fileButton = await getByTestId(page, `context-file-${filename}`);
   await fileButton.waitFor({ state: "visible", timeout });
 
-  // Small delay to ensure React has finished rendering the file list
-  await page.waitForTimeout(200);
-
   // Use JavaScript click to ensure React onClick handler fires
   await fileButton.evaluate((el) => (el as HTMLButtonElement).click());