feat(robot): port ~8 Playwright keywords for comparison PoC

Add app launcher, form, modal, and related list keywords to
SalesforcePlaywright.py using Playwright accessibility selectors.

Author: jstvz

cumulusci/robotframework/SalesforcePlaywright.py

@@ -210,6 +210,131 @@ def _check_for_classic(self):
         except AssertionError:
             return False
 
+    @capture_screenshot_on_error
+    def open_app_launcher(self, timeout="15 seconds"):
+        """Opens the Salesforce App Launcher by clicking the waffle button.
+
+        Waits for the App Launcher modal dialog to appear.
+        """
+        self.browser.click("button.slds-icon-waffle_container")
+        self.wait_until_modal_is_open(timeout=timeout)
+
+    @capture_screenshot_on_error
+    def select_app_launcher_app(self, app_name, timeout="15 seconds"):
+        """Searches for and selects an app in the App Launcher.
+
+        Requires the App Launcher dialog to already be open.
+        """
+        search_input = "input[placeholder='Search apps and items...']"
+        self.browser.fill_text(search_input, app_name)
+        time.sleep(1)
+        self.browser.click(f"a.slds-app-launcher__tile--small:has-text('{app_name}')")
+        self.wait_until_loading_is_complete()
+
+    @capture_screenshot_on_error
+    def select_app_launcher_tab(self, tab_name, timeout="15 seconds"):
+        """Searches for and selects a tab/item in the App Launcher.
+
+        Requires the App Launcher dialog to already be open.
+        """
+        search_input = "input[placeholder='Search apps and items...']"
+        self.browser.fill_text(search_input, tab_name)
+        time.sleep(1)
+        self.browser.click(f"one-app-launcher-menu-item a:has-text('{tab_name}')")
+        self.wait_until_loading_is_complete()
+
+    @capture_screenshot_on_error
+    def populate_field(self, name, value):
+        """Finds a form field by its label and fills it with the given value.
+
+        ``name`` is the label text of the field.
+        ``value`` is the text to enter.
+        """
+        input_el = f"lightning-input label:has-text('{name}')"
+        try:
+            self.browser.get_element(input_el)
+            self.browser.fill_text(
+                f"lightning-input:has(label:has-text('{name}')) input", value
+            )
+            return
+        except (AssertionError, Exception):
+            pass
+
+        textarea_el = f"lightning-textarea:has(label:has-text('{name}')) textarea"
+        try:
+            self.browser.get_element(textarea_el)
+            self.browser.fill_text(textarea_el, value)
+            return
+        except (AssertionError, Exception):
+            pass
+
+        generic = f"label:has-text('{name}')"
+        self.browser.get_element(generic)
+        self.browser.fill_text(
+            f":near({generic}) input, :near({generic}) textarea", value
+        )
+
+    @capture_screenshot_on_error
+    def populate_form(self, **kwargs):
+        """Fills in multiple form fields at once.
+
+        Each keyword argument maps a field label to its desired value.
+
+        Example::
+
+            Populate Form    First Name=Alice    Last Name=Smith
+        """
+        for name, value in kwargs.items():
+            self.populate_field(name, value)
+
+    @capture_screenshot_on_error
+    def click_modal_button(self, button_text, timeout="15 seconds"):
+        """Clicks a button with the given text inside the currently open modal dialog.
+
+        Waits for the modal to be present first.
+        """
+        self.wait_until_modal_is_open(timeout=timeout)
+        self.browser.click(
+            f"div.slds-modal__container button:has-text('{button_text}')"
+        )
+
+    @capture_screenshot_on_error
+    def wait_until_modal_is_open(self, timeout="15 seconds"):
+        """Waits until a Salesforce modal dialog (``slds-modal``) is visible."""
+        self.browser.wait_for_elements_state("section.slds-modal", "visible", timeout)
+
+    @capture_screenshot_on_error
+    def wait_until_modal_is_closed(self, timeout="15 seconds"):
+        """Waits until all Salesforce modal dialogs (``slds-modal``) have disappeared."""
+        self.browser.wait_for_elements_state("section.slds-modal", "detached", timeout)
+
+    @capture_screenshot_on_error
+    def click_related_list_button(self, heading, button_title):
+        """Clicks a button within a related list identified by its heading.
+
+        ``heading`` is the title text of the related list (e.g. "Contacts").
+        ``button_title`` is the visible text of the button to click.
+        """
+        card = f"article.slds-card:has(span[title='{heading}'])"
+        self.browser.click(f"{card} button:has-text('{button_title}')")
+
+    @capture_screenshot_on_error
+    def get_related_list_count(self, heading):
+        """Returns the item count displayed in a related list's heading.
+
+        ``heading`` is the title of the related list (e.g. "Contacts").
+        Returns the integer count parsed from the heading, or 0 if no
+        count is found.
+        """
+        span_text = self.browser.get_text(
+            f"article.slds-card:has(span[title='{heading}']) "
+            f"span.slds-card__header-title"
+        )
+        match = re.search(r"\((\d+)\)", span_text)
+        if match:
+            return int(match.group(1))
+        return 0
+
     def breakpoint(self):
         """Serves as a breakpoint for the robot debugger