Feature/bcss 22027 surveillanceregressiontests scenario 14 (#168)

<!-- markdownlint-disable-next-line first-line-heading -->
## Description

<!-- Describe your changes in detail. -->
Migrating scenario 14 of Surveillance Regression tests from selenium to
playwright

## Context

<!-- Why is this change required? What problem does it solve? -->
Migrating scenario 14 of Surveillance Regression tests from selenium to
playwright

## Type of changes

<!-- What types of changes does your code introduce? Put an `x` in all
the boxes that apply. -->

- [ ] Refactoring (non-breaking change)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would change existing
functionality)
- [ ] Bug fix (non-breaking change which fixes an issue)

## Checklist

<!-- Go over all the following points, and put an `x` in all the boxes
that apply. -->

- [x] I am familiar with the [contributing
guidelines](https://github.com/nhs-england-tools/playwright-python-blueprint/blob/main/CONTRIBUTING.md)
- [x] I have followed the code style of the project
- [x] I have added tests to cover my changes (where appropriate)
- [x] I have updated the documentation accordingly
- [ ] This PR is a result of pair or mob programming

---

## Sensitive Information Declaration

To ensure the utmost confidentiality and protect your and others
privacy, we kindly ask you to NOT including [PII (Personal Identifiable
Information) / PID (Personal Identifiable
Data)](https://digital.nhs.uk/data-and-information/keeping-data-safe-and-benefitting-the-public)
or any other sensitive data in this PR (Pull Request) and the codebase
changes. We will remove any PR that do contain any sensitive
information. We really appreciate your cooperation in this matter.

- [x] I confirm that neither PII/PID nor sensitive data are included in
this PR and the codebase changes.

---------

Signed-off-by: adrianoaru-nhs <[email protected]>

Author: adrianoaru-nhs

pages/screening_subject_search/contact_with_patient_page.py

@@ -186,3 +186,18 @@ def verify_outcome_select_options(self, options: list) -> None:
             f"Missing expected dropdown values in the outcome options: {missing}."
             f"Actual options: {actual_options}"
         )
+
+    def patient_outcome_dropdown_contains_options(self, options: List[str]) -> None:
+        """
+        Asserts that all provided options are present in the Patient Outcome dropdown.
+
+        Args:
+            options (List[str]): List of option strings to check.
+        """
+        dropdown_options = [
+            opt.inner_text() for opt in self.outcome_dropdown.locator("option").all()
+        ]
+        for item in options:
+            assert (
+                item in dropdown_options
+            ), f"Dropdown is missing expected option: '{item}'"

pages/screening_subject_search/diagnostic_test_outcome_page.py

@@ -38,7 +38,7 @@ def __init__(self, page: Page):
         self.test_outcome_dropdown = self.page.get_by_label(
             "Outcome of Diagnostic Test"
         )
-        self.reason_for_sympptomatic_referral_dropdown = self.page.get_by_label(
+        self.reason_for_symptomatic_referral_dropdown = self.page.get_by_label(
             "Reason for Symptomatic Referral"
         )
         self.save_button = self.page.get_by_role("button", name="Save")
@@ -102,6 +102,26 @@ def reason_for_onward_referral_dropdown_contains_options(
                 item in dropdown_options
             ), f"Dropdown is missing expected option: '{item}'"
 
+    def reason_for_symptomatic_referral_dropdown_contains_options(
+        self, options: List[str]
+    ) -> None:
+        """
+        Asserts that all provided options are present in the Reason for Symptomatic Referral dropdown.
+
+        Args:
+            options (List[str]): List of option strings to check.
+        """
+        dropdown_options = [
+            opt.inner_text()
+            for opt in self.reason_for_symptomatic_referral_dropdown.locator(
+                "option"
+            ).all()
+        ]
+        for item in options:
+            assert (
+                item in dropdown_options
+            ), f"Dropdown is missing expected option: '{item}'"
+
     def verify_reason_for_symptomatic_referral(self, symptomatic_reason: str) -> None:
         """
         Verify reason for symptomatic referral is visible.
@@ -119,7 +139,7 @@ def select_reason_for_symptomatic_referral_option(self, option: str) -> None:
         Args:
             option (str): option (str): The option to select from the Reason For Symptomatic Referral options.
         """
-        self.reason_for_sympptomatic_referral_dropdown.select_option(option)
+        self.reason_for_symptomatic_referral_dropdown.select_option(option)
 
     def click_save_button(self) -> None:
         """Click the 'Save' button."""

pages/screening_subject_search/subject_screening_summary_page.py

@@ -87,6 +87,9 @@ def __init__(self, page: Page):
         self.postpone_surveillance_episode_button = self.page.get_by_role(
             "button", name="Postpone Surveillance Episode"
         )
+        self.uncease_subject_button = self.page.get_by_role(
+            "button", name="Uncease Subject"
+        )
 
         # List of Subject Episodes - page filters
         self.view_events_link = self.page.get_by_role("link", name="events")
@@ -510,6 +513,10 @@ def can_postpone_surveillance_episode(self, able_to_click: bool = True) -> None:
         else:
             expect(self.postpone_surveillance_episode_button).not_to_be_visible()
 
+    def click_uncease_subject_button(self) -> None:
+        """Click the 'Uncease Subject' button."""
+        self.click(self.uncease_subject_button)
+
 
 class ChangeScreeningStatusOptions(StrEnum):
     """Enum for Change Screening Status options."""

pages/screening_subject_search/uncease_and_initiate_optin_episode_page.py

@@ -0,0 +1,39 @@
+from playwright.sync_api import Page
+from pages.base_page import BasePage
+
+
+class UnceaseAndInitiateOptinEpisodePage(BasePage):
+    """Uncease and Initiate Opt-in Episode Page locators, and methods for interacting with the page."""
+
+    def __init__(self, page: Page):
+        super().__init__(page)
+        self.page = page
+        self.notes_field = self.page.locator("#UI_NOTES_TEXT")
+        self.send_a_kit_button = self.page.get_by_role("button", name="Send a kit")
+
+    def enter_notes(self, notes: str) -> None:
+        """
+        Enter notes into the 'Notes' field.
+        Args:
+            notes (str): The notes to enter into the field.
+        """
+        self.notes_field.fill(notes)
+
+    def click_send_a_kit_button(self) -> None:
+        """
+        Clicks the 'Send a kit' button.
+        """
+        self.safe_accept_dialog(self.send_a_kit_button)
+
+    def manually_uncease_the_subject(self, action: str) -> None:
+        """
+        Uncease the subject and take the specified action.
+        Args:
+            action (str): The action to take after unceasing the subject.
+        """
+        self.enter_notes(
+            f"Auto test scenario: manual unceasing test for age extension to {action}"
+        )
+        match action:
+            case "send a new kit":
+                self.click_send_a_kit_button()