From 7281d260353dbbf35b466740f1651f8be14c0b04 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Wed, 8 Apr 2026 16:11:59 -0500
Subject: [PATCH] add mobile affordance helpers to BasePage

---
 web/e2e/pages/base.page.ts | 53 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/web/e2e/pages/base.page.ts b/web/e2e/pages/base.page.ts
index 4362f786f8..9c5fffbb05 100644
--- a/web/e2e/pages/base.page.ts
+++ b/web/e2e/pages/base.page.ts
@@ -79,4 +79,57 @@ export class BasePage {
   async waitForPageLoad() {
     await this.page.waitForSelector("#pageRoot", { timeout: 10_000 });
   }
+
+  /**
+   * Open the mobile-only export pane / sheet that slides up from the
+   * bottom on the export page. No-op on desktop. Returns the pane locator
+   * so the caller can assert against its contents.
+   */
+  async openMobilePane(): Promise<Locator> {
+    if (this.isDesktop) {
+      // Return the desktop equivalent (the main content area itself)
+      return this.pageRoot;
+    }
+    // Look for any element that opens a sheet/dialog on tap.
+    // Specific views override this with their own selector.
+    const pane = this.page.locator('[role="dialog"]').first();
+    return pane;
+  }
+
+  /**
+   * Open a side drawer (e.g. mobile filter drawer). View-specific page
+   * objects should override this with their actual trigger selector.
+   * The default implementation looks for a button labelled "Open menu"
+   * or "Filters" and clicks it, then returns the drawer locator.
+   */
+  async openDrawer(): Promise<Locator> {
+    if (this.isDesktop) {
+      return this.pageRoot;
+    }
+    const trigger = this.page
+      .getByRole("button", { name: /menu|filter/i })
+      .first();
+    if (await trigger.count()) {
+      await trigger.click();
+    }
+    return this.page.locator('[role="dialog"], [data-state="open"]').first();
+  }
+
+  /**
+   * Open a bottom sheet (vaul). View-specific page objects should
+   * override this with their actual trigger selector.
+   */
+  async openBottomSheet(): Promise<Locator> {
+    if (this.isDesktop) {
+      return this.pageRoot;
+    }
+    return this.page.locator('[vaul-drawer]').first();
+  }
+
+  /** Close any currently-open mobile overlay (drawer, sheet, dialog). */
+  async closeMobileOverlay(): Promise<void> {
+    if (this.isDesktop) return;
+    // Press Escape — Radix dialogs and vaul both close on Escape
+    await this.page.keyboard.press("Escape");
+  }
 }