@trevordsouzabrite/test-package 1.0.0

package/tests/ApplicantDashboardPageTest.spec.ts

@@ -0,0 +1,74 @@
+// spec: specs/Applicant Dashboard Page Test Plan.md
+// seed: seed.spec.ts
+
+import { test, expect } from '@playwright/test';
+import { ApplicantPage } from '@pages/ApplicantPage';
+import {
+  CreateApplicationPage
+} from '@pages/CreateApplicationPage';
+import { WebActions } from '@lib/WebActions';
+import { expectApplicantAuthenticatedHeaderFooterVisible } from '@lib/ApplicantPortalAssertions';
+
+  
+test.describe('Applicant Dashboard Page Tests', () => {
+  let applicantPage: ApplicantPage;
+  let webActions: WebActions;
+  let createApplicationPage: CreateApplicationPage; 
+  test.beforeEach(async ({ page }) => {
+    applicantPage = new ApplicantPage(page);
+    createApplicationPage = new CreateApplicationPage(page);
+    webActions = new WebActions(page, page.context());
+    await applicantPage.gotoURL('/polkphpapplicant/s/?language=en_US');
+    await webActions.waitForElementAttached(applicantPage.Logout_Btn);
+    //Navigate to the login page by clicking the login button on the header
+  });
+
+  test('Verify the applicant is logged-in and on the dashboard page @auth @smoke', async ({ page }) => {
+    //Verify the dashboard elements are visible
+    await expectApplicantAuthenticatedHeaderFooterVisible(applicantPage);
+    //Heading & Content Section Validations
+    await expect.soft(applicantPage.WelcomeHeading_Text).toBeVisible();
+    const text = await applicantPage.Instructions_Text.textContent();
+    console.log(`Instructions Text: ${text}`);
+    await expect.soft(applicantPage.Banner_Img).toBeVisible();
+  });
+
+  test('Verify Navigation of Create Application Page @auth', async ({ page }) => {
+    //Click on the Create Application link
+    await applicantPage.clickCreateApplicationLink();
+    //Verify the URL is correct & Form Title is visible
+    expect.soft(page.url()).toContain('createapplication');
+    await webActions.waitForElementAttached(createApplicationPage.ApplicationLanguageTitle_Lbl);
+    await expect.soft(createApplicationPage.ApplicationLanguageTitle_Lbl).toBeVisible();
+  });
+
+  test('Verify Navigation of My Application Page @auth', async ({ page }) => {
+    //Click on the My Application link
+    await applicantPage.clickMyApplicationLink();
+    //Verify the URL is correct & Table is visible
+    expect.soft(page.url()).toContain('careprogram');
+    await expect.soft(applicantPage.MyApplications_Table).toBeVisible();
+  });
+
+  test('Verify Navigation of My Medical Coverage Page @auth', async ({ page }) => {
+    //Click on the My Medical Coverage link
+    await applicantPage.clickMyMedicalCoverageLink();
+    //Verify the URL is correct & Table is visible
+    expect.soft(page.url()).toContain('enrollments');
+    //Verify the my medical coverage page elements are visible
+    if(await applicantPage.MyMedicalCoverageRecords.isVisible()) {
+      await expect.soft(applicantPage.MyMedicalCoverageRecords).toBeVisible();
+    } else {
+      await expect.soft(applicantPage.NoEnrollments_Text).toBeVisible();
+    }
+  });
+
+  test('Verify Navigation of Resources Page @auth', async ({ page }) => {
+    //Click on the Resources link
+    await applicantPage.clickResourcesLink();
+    //Verify the URL is correct & Title is visible
+    expect.soft(page.url()).toContain('resourcespage');
+    await expect.soft(applicantPage.ResourcesTitle_Text).toBeVisible();
+  });
+
+});

package/tests/ApplicantForgotPasswordPageTest.spec.ts

@@ -0,0 +1,88 @@
+// spec: specs/Applicant Forgot Password Page Test Plan.md
+// seed: seed.spec.ts
+
+import { test, expect } from '@playwright/test';
+import { ApplicantPage } from '@pages/ApplicantPage';
+import { WebActions } from '@lib/WebActions';
+import emailData from '../test-data/forgotPassword/email.json';
+import forgotPasswordTextData from '../test-data/forgotPassword/textMessages.json';
+  
+test.describe('Applicant Forgot Password Page Tests', () => {
+  let applicantPage: ApplicantPage;
+  let webActions: WebActions;
+  test.beforeEach(async ({ page }) => {
+    applicantPage = new ApplicantPage(page);
+    webActions = new WebActions(page, page.context());
+    await applicantPage.gotoURL('/polkphpapplicant/s/?language=en_US');
+    await applicantPage.clickLoginButton();
+    await applicantPage.clickForgotPasswordLink();
+    await webActions.waitForElementAttached(applicantPage.ForgotPasswordTitle_Text);
+  });
+
+  test('Verify all the elements of the forgot password page are visible @no-auth', async ({ page }) => {
+    //Verify the forgot password page elements are visible
+    await expect.soft(applicantPage.ForgotPasswordTitle_Text).toBeVisible();
+    expect.soft(await applicantPage.ForgotPasswordMessage_Text.textContent()).toBe(forgotPasswordTextData.forgotPasswordMessage);
+    await expect.soft(applicantPage.ForgotPasswordField_Lbl).toBeVisible();
+    await expect.soft(applicantPage.ForgotPasswordField_Input).toBeVisible();
+    await expect.soft(applicantPage.SendResetLink_Btn).toBeVisible();
+  });
+
+  test('Verify when the forgot password input field is left blank the submit button is disabled @no-auth', async ({ page }) => {
+    await expect.soft(applicantPage.ForgotPasswordField_Input).toBeEmpty();
+    await expect.soft(applicantPage.SendResetLink_Btn).toBeDisabled();
+  });
+  
+  test('Verify when the forgot password input field is not empty with valid input the submit button is enabled & success message should be displayed on submission @no-auth', async ({ page }) => {
+    await applicantPage.ForgotPasswordField_Input.fill(emailData.validEmail);
+    await expect.soft(applicantPage.ForgotPasswordField_Input).not.toBeEmpty();
+    await expect.soft(applicantPage.SendResetLink_Btn).toBeEnabled();
+    await applicantPage.clickSendResetLinkButton();
+    await webActions.waitForElementAttached(applicantPage.ForgotPasswordSuccessMessage_Text);
+    await expect.soft(applicantPage.ForgotPasswordSuccessMessage_Text).toBeVisible();
+    expect.soft(await applicantPage.ForgotPasswordSuccessMessage_Text.textContent()).toBe(forgotPasswordTextData.successMessage);
+  });
+
+  test('Verify when invalid email format is entered, error message should be displayed @no-auth', async ({ page }) => {
+    await applicantPage.ForgotPasswordField_Input.fill(emailData.invalidEmail);
+    await applicantPage.clickSendResetLinkButton();
+    await webActions.waitForElementAttached(applicantPage.ForgotPasswordRequiredFieldError_Text)
+    await expect.soft(applicantPage.ForgotPasswordRequiredFieldError_Text).toBeVisible();
+    expect.soft(await applicantPage.ForgotPasswordRequiredFieldError_Text.textContent()).toBe(forgotPasswordTextData.invalidEmailError);
+    await expect.soft(applicantPage.ForgotPasswordSuccessMessage_Text).toBeHidden();
+  });
+
+  test('Verify the success message is not shown before submit @no-auth', async ({ page }) => {
+    await applicantPage.ForgotPasswordField_Input.fill(emailData.validEmail);
+    await expect.soft(applicantPage.ForgotPasswordSuccessMessage_Text).toBeHidden();
+  });
+
+  test('Verify clearing the field after valid input disables the submit button again @no-auth', async ({ page }) => {
+    await applicantPage.ForgotPasswordField_Input.fill(emailData.validEmail);
+    await expect.soft(applicantPage.SendResetLink_Btn).toBeEnabled();
+
+    await applicantPage.ForgotPasswordField_Input.clear();
+    await expect.soft(applicantPage.SendResetLink_Btn).toBeDisabled();
+  });
+
+  test('Verify invalid email error clears after correcting input and submitting successfully @no-auth', async ({ page }) => {
+    await applicantPage.ForgotPasswordField_Input.fill(emailData.invalidEmail);
+    await applicantPage.clickSendResetLinkButton();
+    await webActions.waitForElementAttached(applicantPage.ForgotPasswordRequiredFieldError_Text);
+    await expect.soft(applicantPage.ForgotPasswordRequiredFieldError_Text).toBeVisible();
+    await applicantPage.ForgotPasswordField_Input.fill(emailData.validEmail);
+    await applicantPage.clickSendResetLinkButton();
+    await expect.soft(applicantPage.ForgotPasswordRequiredFieldError_Text).toBeHidden();
+    await applicantPage.clickSendResetLinkButton();
+    await webActions.waitForElementAttached(applicantPage.ForgotPasswordSuccessMessage_Text);
+    await expect.soft(applicantPage.ForgotPasswordSuccessMessage_Text).toBeVisible();
+    expect.soft(await applicantPage.ForgotPasswordSuccessMessage_Text.textContent()).toBe(forgotPasswordTextData.successMessage);
+  });
+
+  test('Verify whitespace-only input does not submit a reset as valid email @no-auth', async ({ page }) => {
+    await applicantPage.ForgotPasswordField_Input.fill(emailData.whitespaceEmail);
+    await applicantPage.ForgotPasswordTitle_Text.click();
+    await expect.soft(applicantPage.SendResetLink_Btn).toBeDisabled();
+    await expect.soft(applicantPage.ForgotPasswordRequiredFieldError_Text).toBeVisible();
+  });
+});

package/tests/ApplicantHelpPageTest.spec.ts

@@ -0,0 +1,468 @@
+// spec: specs/Applicant Help Page Test Plan.md
+// seed: seed.spec.ts
+
+import { test, expect } from '@playwright/test';
+import { ApplicantPage } from '@pages/ApplicantPage';
+import { WebActions } from '@lib/WebActions';
+import {
+  expectApplicantAuthenticatedHeaderFooterVisible,
+  expectApplicantAuthenticatedHeaderVisible,
+  expectApplicantFooterVisible,
+} from '@lib/ApplicantPortalAssertions';
+import helpTextData from '../test-data/help/textContent.json';
+
+test.describe('Applicant Help Page Tests', () => {
+  let applicantPage: ApplicantPage;
+  let webActions: WebActions;
+
+  test.beforeEach(async ({ page }) => {
+    applicantPage = new ApplicantPage(page);
+    webActions = new WebActions(page, page.context());
+    await applicantPage.gotoURL('/polkphpapplicant/s/?language=en_US');
+    await webActions.waitForElementAttached(applicantPage.Logout_Btn);
+    // Click the Help link in the header navigation
+    await applicantPage.clickHelpHeaderLink();
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseH1_Text);
+  });
+
+  // TC-01 — Authenticated Header, Footer, And Help Page H1 Are Visible
+  test('TC-01 - Authenticated Header, Footer, And Help Page H1 Are Visible @auth', async ({ page }) => {
+    // 1. Navigate to /polkphpapplicant/s/?language=en_US and wait for the Logout button (done in beforeEach)
+    // 2. Click the Help link and wait for the Knowledge Base H1 (done in beforeEach)
+    // Verify URL contains knowledge-base
+    expect.soft(page.url()).toContain('knowledge-base');
+    // 3. Verify all authenticated header & footer elements
+    await expectApplicantAuthenticatedHeaderFooterVisible(applicantPage)
+  });
+
+  // TC-02 — Knowledge Base Page Title Section Content Is Correct
+  test('TC-02 - Knowledge Base Page Title Section Content Is Correct @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the H1 heading to appear (done in beforeEach)
+    // 2. Locate the H1 heading and the subtitle paragraph directly beneath it
+    await expect.soft(applicantPage.KnowledgeBaseH1_Text).toBeVisible();
+    await expect.soft(applicantPage.KnowledgeBaseSubtitle_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseSubtitle_Text.textContent()).toContain(helpTextData.subtitle);
+    // 3. Verify the search bar is present and has the correct placeholder text
+    await expect.soft(applicantPage.KnowledgeBaseSearch_Input).toBeVisible();
+    await expect(applicantPage.KnowledgeBaseSearch_Input).toHaveAttribute('placeholder', helpTextData.searchPlaceholder);
+  });
+
+  // TC-03 — Article List Displays The Correct Article Card Content
+  test('TC-03 - Article List Displays The Correct Article Card Content @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the article card list to load (done in beforeEach)
+    // Verify at least one article card is visible (first card's "Read more →" link must appear)
+    await expect.soft(applicantPage.KnowledgeBaseArticleCards_All.first()).toBeVisible();
+    // 2. Inspect the first article card in the list
+    // Verify article type badge Procedure is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardBadge_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardBadge_Text.textContent()).toContain(helpTextData.articleCardBadge);
+    // Verify article title How to Reset Your Password is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardTitle_Text.textContent()).toContain(helpTextData.articleCardTitle);
+    // Verify summary text is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardSummary_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardSummary_Text.textContent()).toContain(helpTextData.articleCardSummary);
+    // Verify publish date is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardDate_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardDate_Text.textContent()).toContain(helpTextData.articleCardPublishDate);
+    // Verify Read more link text is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardReadMore_Lnk).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardReadMore_Lnk.textContent()).toContain(helpTextData.articleCardReadMore);
+  });
+
+  // TC-04 — Category Filter Narrows Article List
+  test('TC-04 - Category Filter Narrows Article List @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the article list to load (done in beforeEach)
+    // Verify Categories sidebar is visible with all labels
+    await expect.soft(applicantPage.KnowledgeBaseCategoryAll_Lnk).toBeVisible();
+    await expect.soft(applicantPage.KnowledgeBaseCategorySupport_Lnk).toBeVisible();
+    await expect.soft(applicantPage.KnowledgeBaseCategoryAccount_Lnk).toBeVisible();
+    await expect.soft(applicantPage.KnowledgeBaseCategoryGeneral_Lnk).toBeVisible();
+    // 2. Click the Account category filter
+    await applicantPage.clickAccountCategoryFilter();
+    // Verify the How to Reset Your Password card is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardTitle_Text.textContent()).toContain(helpTextData.articleCardTitle);
+    // 3. Click the Support category filter (shows 0 articles)
+    await applicantPage.clickSupportCategoryFilter();
+    // Verify empty-state message is visible
+    await expect.soft(applicantPage.KnowledgeBaseEmptyState_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseEmptyState_Text.textContent()).toContain(helpTextData.emptyStateMessage);
+    // 4. Click the General category filter (shows 0 articles)
+    await applicantPage.clickGeneralCategoryFilter();
+    // Verify empty-state message is visible
+    await expect.soft(applicantPage.KnowledgeBaseEmptyState_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseEmptyState_Text.textContent()).toContain(helpTextData.emptyStateMessage);
+    // 5. Click the All category filter
+    await applicantPage.clickAllCategoryFilter();
+    // Verify the How to Reset Your Password card is visible again
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardTitle_Text.textContent()).toContain(helpTextData.articleCardTitle);
+  });
+
+  // TC-05 — Article Type Filter Narrows Article List
+  test('TC-05 - Article Type Filter Narrows Article List @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the article list to load (done in beforeEach)
+    // Verify Article Type sidebar is visible with all labels
+    await expect.soft(applicantPage.KnowledgeBaseTypeAll_Lnk).toBeVisible();
+    await expect.soft(applicantPage.KnowledgeBaseTypeFaq_Lnk).toBeVisible();
+    await expect.soft(applicantPage.KnowledgeBaseTypeProcedure_Lnk).toBeVisible();
+    // 2. Click the Procedure article type filter
+    await applicantPage.clickProcedureArticleTypeFilter();
+    // Verify the How to Reset Your Password card is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardTitle_Text.textContent()).toContain(helpTextData.articleCardTitle);
+    // 3. Click the FAQ article type filter (no FAQ articles)
+    await applicantPage.clickFaqArticleTypeFilter();
+    // Verify empty-state message is visible
+    await expect.soft(applicantPage.KnowledgeBaseEmptyState_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseEmptyState_Text.textContent()).toContain(helpTextData.emptyStateMessage);
+    // 4. Click the All article type filter
+    await applicantPage.clickAllArticleTypeFilter();
+    // Verify the How to Reset Your Password card is visible again
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardTitle_Text.textContent()).toContain(helpTextData.articleCardTitle);
+  });
+
+  // TC-06 — Search Box Filters Articles And Shows Empty State For No Matches
+  test('TC-06 - Search Box Filters Articles And Shows Empty State For No Matches @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the article list to load (done in beforeEach)
+    // Verify the search box is visible and empty
+    await expect.soft(applicantPage.KnowledgeBaseSearch_Input).toBeVisible();
+    // 2. Type 'password' in the search box
+    await applicantPage.KnowledgeBaseSearch_Input.fill('password');
+    // Verify the How to Reset Your Password card is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseFirstCardTitle_Text.textContent()).toContain(helpTextData.articleCardTitle);
+    // Verify the Clear button appears
+    await expect.soft(applicantPage.KnowledgeBaseSearchClear_Btn).toBeVisible();
+    // 3. Click the Clear button
+    await applicantPage.clickSearchClearButton();
+    // Verify the search box is cleared
+    await expect(applicantPage.KnowledgeBaseSearch_Input).toHaveValue('');
+    // Verify the Clear button disappears
+    await expect.soft(applicantPage.KnowledgeBaseSearchClear_Btn).not.toBeVisible();
+    // Verify the How to Reset Your Password card is visible again
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    // 4. Type 'xyznotfound' in the search box
+    await applicantPage.KnowledgeBaseSearch_Input.fill('xyznotfound');
+    // Verify empty-state message is visible
+    await expect.soft(applicantPage.KnowledgeBaseEmptyState_Text).toBeVisible();
+    expect.soft(await applicantPage.KnowledgeBaseEmptyState_Text.textContent()).toContain(helpTextData.emptyStateMessage);
+    // 5. Click the Clear button to reset the search
+    await applicantPage.clickSearchClearButton();
+    // Verify the search box is cleared
+    await expect(applicantPage.KnowledgeBaseSearch_Input).toHaveValue('');
+    // Verify the full article list is restored
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+  });
+
+  // TC-07 — Article Card Click Navigates To The Article Detail Page
+  test('TC-07 - Article Card Click Navigates To The Article Detail Page @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the article list to load (done in beforeEach)
+    // 2. Click the How to Reset Your Password article card
+    await applicantPage.clickHowToResetPasswordCard();
+    await webActions.waitForElementAttached(applicantPage.ArticleDetailH1_Text);
+    // Verify URL contains article?urlName=how-to-reset-password
+    expect.soft(page.url()).toContain('article?urlName=how-to-reset-password');
+    // Verify the H1 heading How to Reset Your Password is visible
+    await expect.soft(applicantPage.ArticleDetailH1_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailH1_Text.textContent()).toContain(helpTextData.articleDetailH1);
+    // Verify the article type badge Procedure is visible
+    await expect.soft(applicantPage.ArticleDetailBadge_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailBadge_Text.textContent()).toContain(helpTextData.articleDetailBadge);
+    // Verify metadata: Published date, Category, Article #
+    await expect.soft(applicantPage.ArticleDetailPublished_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailPublished_Text.textContent()).toContain(helpTextData.articleDetailPublished);
+    await expect.soft(applicantPage.ArticleDetailCategory_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailCategory_Text.textContent()).toContain(helpTextData.articleDetailCategory);
+    await expect.soft(applicantPage.ArticleDetailArticleNumber_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailArticleNumber_Text.textContent()).toContain(helpTextData.articleDetailArticleNumber);
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+  });
+
+  // TC-08 — Article Detail Page Sections And Content Are Correct
+  test('TC-08 - Article Detail Page Sections And Content Are Correct @auth', async ({ page }) => {
+    // 1. Navigate to the article detail page at /polkphpapplicant/s/article?urlName=how-to-reset-password
+    await applicantPage.gotoURL('/polkphpapplicant/s/article?urlName=how-to-reset-password');
+    await webActions.waitForElementAttached(applicantPage.ArticleDetailH1_Text);
+    // 2. Verify the Summary section
+    await expect.soft(applicantPage.ArticleDetailSummaryLabel_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailSummaryLabel_Text.textContent()).toContain(helpTextData.articleDetailSectionSummary);
+    await expect.soft(applicantPage.ArticleDetailSummaryContent_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailSummaryContent_Text.textContent()).toContain(helpTextData.articleDetailSummaryText);
+    // 3. Verify the Audience section
+    await expect.soft(applicantPage.ArticleDetailAudienceLabel_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailAudienceLabel_Text.textContent()).toContain(helpTextData.articleDetailSectionAudience);
+    await expect.soft(applicantPage.ArticleDetailAudienceContent_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailAudienceContent_Text.textContent()).toContain(helpTextData.articleDetailAudienceText);
+    // 4. Verify the Purpose section
+    await expect.soft(applicantPage.ArticleDetailPurposeLabel_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailPurposeLabel_Text.textContent()).toContain(helpTextData.articleDetailSectionPurpose);
+    await expect.soft(applicantPage.ArticleDetailPurposeContent_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailPurposeContent_Text.textContent()).toContain(helpTextData.articleDetailPurposeText);
+    // 5. Verify the warning block
+    for (const bullet of helpTextData.articleDetailWarningBullets) {
+      await expect.soft(applicantPage.ArticleDetailWarningBlock_Text.filter({ hasText: bullet })).toBeVisible();
+    }
+    // 6. Verify the Steps section
+    await expect.soft(applicantPage.ArticleDetailStepsLabel_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailStepsLabel_Text.textContent()).toContain(helpTextData.articleDetailSectionSteps);
+    for (const step of helpTextData.articleDetailSteps) {
+      await expect.soft(applicantPage.ArticleDetailStepsContent_Block.filter({ hasText: step })).toBeVisible();
+    }
+  });
+
+  // TC-09 — Was This Article Helpful Widget Is Functional
+  // FIXME: Vote counts (👍 Yes / 👎 No) reset to 0 after a page reload. The app does not persist
+  // vote counts across navigation/reload — the Salesforce Apex call that would save votes
+  // returns a connection error (net::ERR_CONNECTION) in the sandbox environment. Step 5 of this
+  // test (reload persistence check) therefore always fails. The widget click behaviour (steps 2–4)
+  // works correctly but cannot be verified independently without also running the broken step 5.
+  test.fixme('TC-09 - Was This Article Helpful Widget Is Functional @auth @knownissue', async ({ page }) => {
+    // 1. Navigate to the article detail page at /polkphpapplicant/s/article?urlName=how-to-reset-password
+    await applicantPage.gotoURL('/polkphpapplicant/s/article?urlName=how-to-reset-password');
+    await webActions.waitForElementAttached(applicantPage.ArticleDetailH1_Text);
+    // 2. Locate the Was this article helpful? widget
+    await expect.soft(applicantPage.ArticleDetailHelpfulLabel_Text).toBeVisible();
+    expect.soft(await applicantPage.ArticleDetailHelpfulLabel_Text.textContent()).toContain(helpTextData.articleDetailHelpfulLabel);
+    await expect.soft(applicantPage.ArticleDetailHelpfulYes_Btn).toBeVisible();
+    await expect.soft(applicantPage.ArticleDetailHelpfulNo_Btn).toBeVisible();
+    // Capture initial vote counts from the button labels
+    const yesBefore = await applicantPage.getHelpfulYesCount();
+    const noBefore = await applicantPage.getHelpfulNoCount();
+    // 3. Click the Yes button
+    await applicantPage.clickHelpfulYesButton();
+    // Verify Yes vote count incremented by exactly 1 (poll until the label updates)
+    await expect.poll(() => applicantPage.getHelpfulYesCount()).toBe(yesBefore + 1);
+    // Verify user remains on the article detail page
+    expect.soft(page.url()).toContain('article?urlName=how-to-reset-password');
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+    // 4. Click the No button
+    await applicantPage.clickHelpfulNoButton();
+    // Verify No vote count incremented by exactly 1 (poll until the label updates)
+    await expect.poll(() => applicantPage.getHelpfulNoCount()).toBe(noBefore + 1);
+    // Verify user remains on the article detail page
+    expect.soft(page.url()).toContain('article?urlName=how-to-reset-password');
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+    // 5. Click the browser refresh button
+    await page.reload();
+    await webActions.waitForElementAttached(applicantPage.ArticleDetailH1_Text);
+    // Verify the counts are persisted (not reverted to 0) — should still be at least the post-vote values
+    expect.soft(await applicantPage.getHelpfulYesCount()).toBeGreaterThanOrEqual(yesBefore + 1);
+    expect.soft(await applicantPage.getHelpfulNoCount()).toBeGreaterThanOrEqual(noBefore + 1);
+  });
+
+  // TC-10 — Back To Knowledge Base Button Returns To The Knowledge Base List
+  test('TC-10 - Back To Knowledge Base Button Returns To The Knowledge Base List @auth', async ({ page }) => {
+    // 1. Navigate to the article detail page at /polkphpapplicant/s/article?urlName=how-to-reset-password
+    await applicantPage.gotoURL('/polkphpapplicant/s/article?urlName=how-to-reset-password');
+    await webActions.waitForElementAttached(applicantPage.ArticleDetailH1_Text);
+    // 2. Click the Back to Knowledge Base button
+    await applicantPage.clickBackToKnowledgeBase();
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseH1_Text);
+    // Verify URL contains knowledge-base
+    expect.soft(page.url()).toContain('knowledge-base');
+    // Verify the Knowledge Base H1 heading is visible
+    await expect.soft(applicantPage.KnowledgeBaseH1_Text).toBeVisible();
+    // Verify the article card list is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+  });
+
+  // TC-11 — Browser Tab Title Is Knowledge Base
+  test('TC-11 - Browser Tab Title Is Knowledge Base @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the H1 heading to appear (done in beforeEach)
+    // 2. Read document.title from the browser and verify it matches expected title
+    await expect(page).toHaveTitle(helpTextData.documentTitle);
+  });
+
+  // TC-12 — Heading Hierarchy And Accessibility Attributes Are Correct
+  test('TC-12 - Heading Hierarchy And Accessibility Attributes Are Correct @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the H1 heading to appear (done in beforeEach)
+    // 2. Inspect the heading hierarchy
+    // Verify exactly one H1 element with the text Knowledge Base
+    await expect(applicantPage.KnowledgeBaseH1_All).toHaveCount(1);
+    await expect(applicantPage.KnowledgeBaseH1Role_Heading).toHaveText(helpTextData.h1Title);
+    // Verify zero H2 elements on the page
+    await expect(applicantPage.KnowledgeBaseH2_All).toHaveCount(0);
+    // Verify zero H3 elements on the page
+    await expect(applicantPage.KnowledgeBaseH3_All).toHaveCount(0);
+    // 3. Verify the HTML lang attribute on the root html element
+    await expect(applicantPage.HtmlRoot_Elem).toHaveAttribute('lang', helpTextData.htmlLang);
+    // 4. Verify the Logo image has a meaningful alt attribute
+    await expect(applicantPage.Logo_Img).toHaveAttribute('alt', helpTextData.logoAlt);
+  });
+
+  // TC-13 — Help Page Is Reachable Via The Help Header Link From The Dashboard
+  test('TC-13 - Help Page Is Reachable Via The Help Header Link From The Dashboard @auth', async ({ page }) => {
+    // 1. Navigate to /polkphpapplicant/s/?language=en_US and confirm the Logout button is visible (done in beforeEach)
+    // beforeEach already navigated to dashboard and clicked Help - we only need to verify the result here
+    // 2. Locate the Help link in the header navigation
+    // Go back to dashboard first to verify the link is there
+    await applicantPage.gotoURL('/polkphpapplicant/s/?language=en_US');
+    await webActions.waitForElementAttached(applicantPage.Logout_Btn);
+    // Verify the Help link is visible in the header
+    await expect.soft(applicantPage.Help_Lnk).toBeVisible();
+    // Verify the Help link href resolves to /polkphpapplicant/s/knowledge-base
+    await expect(applicantPage.Help_Lnk).toHaveAttribute('href', '/polkphpapplicant/s/knowledge-base');
+    // 3. Click the Help link
+    await applicantPage.clickHelpHeaderLink();
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseH1_Text);
+    // Verify URL contains knowledge-base
+    expect.soft(page.url()).toContain('knowledge-base');
+    // Verify the Knowledge Base H1 heading is visible
+    await expect.soft(applicantPage.KnowledgeBaseH1_Text).toBeVisible();
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+  });
+
+  // TC-14 — Help Page Is Reachable Via The Help Header Link From The Resources Page
+  test('TC-14 - Help Page Is Reachable Via The Help Header Link From The Resources Page @auth', async ({ page }) => {
+    // 1. Navigate to the authenticated Resources page
+    await applicantPage.gotoURL('/polkphpapplicant/s/resourcespage');
+    await webActions.waitForElementAttached(applicantPage.ResourcesTitle_Text);
+    // Verify Resources page loads and user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+    // 2. Click the Help link in the header navigation
+    await applicantPage.clickHelpHeaderLink();
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseH1_Text);
+    // Verify URL contains knowledge-base
+    expect.soft(page.url()).toContain('knowledge-base');
+    // Verify the Knowledge Base H1 heading is visible
+    await expect.soft(applicantPage.KnowledgeBaseH1_Text).toBeVisible();
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+  });
+
+  // TC-15 — Header Nav Links From Help Page Return To Dashboard While Authenticated
+  test('TC-15 - Header Nav Links From Help Page Return To Dashboard While Authenticated @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the H1 heading to appear (done in beforeEach)
+    // 2. Click the Home link in the header navigation
+    await applicantPage.clickHomeLink();
+    await webActions.waitForElementAttached(applicantPage.WelcomeHeading_Text);
+    // Verify URL contains /polkphpapplicant/s/ and does not contain knowledge-base
+    expect.soft(page.url()).toContain('/polkphpapplicant/s/');
+    expect.soft(page.url()).not.toContain('knowledge-base');
+    // Verify the Welcome heading is visible
+    await expect.soft(applicantPage.WelcomeHeading_Text).toBeVisible();
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+    // 3. Navigate back to Help / Knowledge Base page and click the Logo image
+    await applicantPage.clickHelpHeaderLink();
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseH1_Text);
+    await applicantPage.Logo_Img.click();
+    await webActions.waitForElementAttached(applicantPage.WelcomeHeading_Text);
+    // Verify URL contains /polkphpapplicant/s/ and does not contain knowledge-base
+    expect.soft(page.url()).toContain('/polkphpapplicant/s/');
+    expect.soft(page.url()).not.toContain('knowledge-base');
+    // Verify user remains authenticated
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+  });
+
+  // TC-16 — Desktop Viewport Layout (1500x730) Renders Correctly
+  test('TC-16 - Desktop Viewport Layout (1500x730) Renders Correctly @auth', async ({ page }) => {
+    // 1. Set the viewport to 1500x730 and navigate to the Knowledge Base page
+    await page.setViewportSize({ width: 1500, height: 730 });
+    await applicantPage.gotoURL('/polkphpapplicant/s/knowledge-base');
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseH1_Text);
+    // Verify the Knowledge Base H1 heading is visible
+    await expect.soft(applicantPage.KnowledgeBaseH1_Text).toBeVisible();
+    // 2. Verify header, main content area, and footer are all visible
+    await expectApplicantAuthenticatedHeaderFooterVisible(applicantPage);
+    // Verify the subtitle is visible
+    await expect.soft(applicantPage.KnowledgeBaseSubtitle_Text).toBeVisible();
+    // Verify the search bar is visible
+    await expect.soft(applicantPage.KnowledgeBaseSearch_Input).toBeVisible();
+    // Verify category filters are visible
+    await expect.soft(applicantPage.KnowledgeBaseCategoryAll_Lnk).toBeVisible();
+    // Verify article card grid is visible
+    await expect.soft(applicantPage.KnowledgeBaseFirstCardTitle_Text).toBeVisible();
+    // Verify no horizontal overflow (allow small tolerance for scrollbar width)
+    await expect
+      .poll(() => page.evaluate(() => document.documentElement.scrollWidth <= document.documentElement.clientWidth + 20))
+      .toBeTruthy();
+  });
+
+  // TC-17 — Mobile Viewport Layout (Pixel 4a 412x732) Renders Correctly
+  test('TC-17 - Mobile Viewport Layout (Pixel 4a 412x732) Renders Correctly @auth', async ({ page }) => {
+    // 1. Set the viewport to 412x732 and navigate to the Knowledge Base page
+    await page.setViewportSize({ width: 412, height: 732 });
+    await applicantPage.gotoURL('/polkphpapplicant/s/knowledge-base');
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseH1_Text);
+    // Verify the Knowledge Base H1 heading is visible
+    await expect.soft(applicantPage.KnowledgeBaseH1_Text).toBeVisible();
+    // Verify the Logo image is visible
+    await expect.soft(applicantPage.Logo_Img).toBeVisible();
+    // Verify the Logout button is visible
+    await expect.soft(applicantPage.Logout_Btn).toBeVisible();
+    // Verify the search bar is visible
+    await expect.soft(applicantPage.KnowledgeBaseSearch_Input).toBeVisible();
+    // 2. Scroll to the footer and verify footer content
+    await applicantPage.PolkHealthCare_Img.scrollIntoViewIfNeeded();
+    await expect.soft(applicantPage.PolkHealthCare_Img).toBeVisible();
+    await expect.soft(applicantPage.Copyright_Text).toBeVisible();
+  });
+
+  // TC-18 — No Broken Images On The Knowledge Base Page
+  test('TC-18 - No Broken Images On The Knowledge Base Page @auth', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the H1 heading to appear (done in beforeEach)
+    // 2. Check that the header Logo image has loaded correctly
+    await applicantPage.Logo_Img.scrollIntoViewIfNeeded();
+    await expect.soft(applicantPage.Logo_Img).toBeVisible();
+    await expect
+      .poll(() => applicantPage.Logo_Img.evaluate((img) => (img as HTMLImageElement).naturalWidth))
+      .toBeGreaterThan(0);
+    // 3. Scroll to the footer and check that the Polk HealthCare Plan footer image has loaded correctly
+    await applicantPage.PolkHealthCare_Img.scrollIntoViewIfNeeded();
+    await expect.soft(applicantPage.PolkHealthCare_Img).toBeVisible();
+    await expect
+      .poll(() => applicantPage.PolkHealthCare_Img.evaluate((img) => (img as HTMLImageElement).naturalWidth))
+      .toBeGreaterThan(0);
+  });
+
+  // TC-19 — No Broken Images On The Article Detail Page
+  test('TC-19 - No Broken Images On The Article Detail Page @auth', async ({ page }) => {
+    // 1. Navigate to the article detail page at /polkphpapplicant/s/article?urlName=how-to-reset-password
+    await applicantPage.gotoURL('/polkphpapplicant/s/article?urlName=how-to-reset-password');
+    await webActions.waitForElementAttached(applicantPage.ArticleDetailH1_Text);
+    // 2. Check that the header Logo image has loaded correctly
+    await applicantPage.Logo_Img.scrollIntoViewIfNeeded();
+    await expect.soft(applicantPage.Logo_Img).toBeVisible();
+    await expect
+      .poll(() => applicantPage.Logo_Img.evaluate((img) => (img as HTMLImageElement).naturalWidth))
+      .toBeGreaterThan(0);
+    // 3. Check that the article banner image has loaded correctly
+    await applicantPage.ArticleDetailBanner_Img.scrollIntoViewIfNeeded();
+    await expect.soft(applicantPage.ArticleDetailBanner_Img).toBeVisible();
+    await expect
+      .poll(() => applicantPage.ArticleDetailBanner_Img.evaluate((img) => (img as HTMLImageElement).naturalWidth))
+      .toBeGreaterThan(0);
+    // 4. Scroll to the footer and check that the Polk HealthCare Plan footer image has loaded correctly
+    await applicantPage.PolkHealthCare_Img.scrollIntoViewIfNeeded();
+    await expect.soft(applicantPage.PolkHealthCare_Img).toBeVisible();
+    await expect
+      .poll(() => applicantPage.PolkHealthCare_Img.evaluate((img) => (img as HTMLImageElement).naturalWidth))
+      .toBeGreaterThan(0);
+  });
+
+  // TC-20 — Category Filter counts should not get changed on clicking other category
+  test.fixme('TC-20 - Category Filter counts should not get changed on clicking other category @auth @knownissue', async ({ page }) => {
+    // 1. Open the Help / Knowledge Base page and wait for the article list to load (done in beforeEach)
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseCategoryAll_Lnk);
+    // Capture the total article count shown in the All filter before clicking any other filter
+    const allCount = applicantPage.KnowledgeBaseCategoryAll_Lnk.locator('.cat-count');
+    const allFilterTextBefore = await applicantPage.getFilterCount(allCount);
+    // 2. Click the Support category filter (shows 0 articles)
+    await applicantPage.clickSupportCategoryFilter();
+    await webActions.waitForElementAttached(applicantPage.KnowledgeBaseEmptyState_Text)
+    // Verify the count in All filter should update to show Support category count
+    const allFilterTextAfter = await applicantPage.getFilterCount(allCount);
+    // The All filter count should now reflect the Support category article count
+    await expect.soft(allFilterTextAfter).toBe(allFilterTextBefore)
+  });
+});