@atomic-testing/playwright 0.79.0 → 0.81.0

package/dist/index.cjs

@@ -102,22 +102,26 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		return this.hover(locator, option);
 	}
 	async mouseOut(locator, _option) {
-		await this.hover(locator, { position: {
-			x: 0,
-			y: 0
-		} });
-		await this.page.mouse.move(-10, -10);
+		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).hover();
+		await this.page.locator(cssLocator).dispatchEvent("mouseout");
 	}
 	async mouseEnter(locator, _option) {
 		return this.hover(locator);
 	}
 	async mouseLeave(locator, _option) {
-		return this.mouseOut(locator);
+		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).hover();
+		await this.page.locator(cssLocator).dispatchEvent("mouseout");
 	}
 	async focus(locator, _option) {
 		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
 		return this.page.focus(cssLocator);
 	}
+	async blur(locator, _option) {
+		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).blur();
+	}
 	wait(ms) {
 		return _atomic_testing_core.timingUtil.wait(ms);
 	}
@@ -221,8 +225,15 @@ function playwrightGetTestEngine(scenePart, fixture) {
 	const page = fixture.page;
 	return createTestEngine(page, scenePart);
 }
+/**
+* Playwright adapter for the TestFrameworkMapper interface.
+*/
 const playWrightTestFrameworkMapper = {
 	assertEqual: (a, b) => (0, _playwright_test.expect)(a).toEqual(b),
+	assertNotEqual: (a, b) => (0, _playwright_test.expect)(a).not.toEqual(b),
+	assertTrue: (value) => (0, _playwright_test.expect)(value).toBe(true),
+	assertFalse: (value) => (0, _playwright_test.expect)(value).toBe(false),
+	assertApproxEqual: (actual, expected, tolerance) => (0, _playwright_test.expect)(Math.abs(actual - expected)).toBeLessThanOrEqual(tolerance),
 	describe: _playwright_test.test.describe,
 	beforeEach: _playwright_test.test.beforeEach,
 	afterEach: _playwright_test.test.afterEach,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["page: Page","locatorUtil","optionLocator: PartLocator","values: string[]","labels: string[]","dateUtil","timingUtil","defaultWaitForOption","interactorUtil","locator","TestEngine","playWrightTestFrameworkMapper: TestFrameworkMapper","test"],"sources":["../src/PlaywrightInteractor.ts","../src/createTestEngine.ts","../src/testRunnerAdapter.ts"],"sourcesContent":["import {\n  byCssSelector,\n  ClickOption,\n  CssProperty,\n  dateUtil,\n  defaultWaitForOption,\n  EnterTextOption,\n  FocusOption,\n  HoverOption,\n  Interactor,\n  interactorUtil,\n  locatorUtil,\n  MouseEnterOption,\n  MouseLeaveOption,\n  MouseOutOption,\n  MouseDownOption,\n  MouseMoveOption,\n  MouseUpOption,\n  Optional,\n  PartLocator,\n  timingUtil,\n  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\n/**\n * Implementation of the {@link Interactor} interface using Playwright.\n */\nexport class PlaywrightInteractor implements Interactor {\n  /**\n   * @param page - Playwright page instance used to drive the browser.\n   */\n  constructor(public readonly page: Page) {}\n\n  /**\n   * Select the given option values on a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @param values - Values to select.\n   */\n  async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).selectOption(values);\n  }\n\n  /**\n   * Get the value of an `<input>` element.\n   *\n   * @param locator - Locator pointing to the input element.\n   * @returns The current value of the input or `undefined` if not present.\n   */\n  async getInputValue(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).inputValue();\n  }\n\n  /**\n   * Retrieve the values of selected options within a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @returns Array of selected option values or `undefined` when no option is selected.\n   */\n  async getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const values: string[] = [];\n    for (const option of allOptions) {\n      const value = await option.getAttribute('value');\n      if (value != null) {\n        values.push(value);\n      }\n    }\n    return values;\n  }\n\n  async getSelectLabels(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const labels: string[] = [];\n    for (const option of allOptions) {\n      const label = await option.textContent();\n      if (label != null) {\n        labels.push(label);\n      }\n    }\n    return labels;\n  }\n\n  async getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    const value = await elLocator.evaluate((element, prop) => {\n      return window.getComputedStyle(element).getPropertyValue(prop as string);\n    }, propertyName);\n    return value;\n  }\n\n  async enterText(locator: PartLocator, text: string, option?: Optional<Partial<EnterTextOption>>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    if (!option?.append) {\n      await this.page.locator(cssLocator).clear();\n    }\n\n    // If it is a date, time or datetime-local input, validate the date format\n    const type = (await this.getAttribute(locator, 'type')) ?? '';\n    if (dateUtil.isHtmlDateInputType(type)) {\n      const result = dateUtil.validateHtmlDateInput(type, text);\n      if (!result.valid) {\n        throw new Error(\n          `Invalid date format for type: ${type}, expected format: ${result.format}, example: ${result.example}`\n        );\n      }\n    }\n    await this.page.locator(cssLocator).fill(text);\n  }\n\n  async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).click({ position: option?.position });\n  }\n\n  async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).hover({ position: option?.position });\n  }\n\n  async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.move(0, 0);\n  }\n\n  async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.down();\n  }\n\n  async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.up();\n  }\n\n  async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    return this.hover(locator, option);\n  }\n\n  async mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void> {\n    await this.hover(locator, {\n      position: {\n        x: 0,\n        y: 0,\n      },\n    });\n    await this.page.mouse.move(-10, -10);\n  }\n\n  async mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void> {\n    return this.hover(locator);\n  }\n\n  async mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void> {\n    return this.mouseOut(locator);\n  }\n\n  async focus(locator: PartLocator, _option: Partial<FocusOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.focus(cssLocator);\n  }\n\n  //#region wait conditions\n  wait(ms: number): Promise<void> {\n    return timingUtil.wait(ms);\n  }\n\n  async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption\n  ): Promise<void> {\n    return interactorUtil.interactorWaitUtil(locator, this, option);\n  }\n\n  waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    return timingUtil.waitUntil(option);\n  }\n  //#endregion\n\n  async getAttribute(locator: PartLocator, name: string, isMultiple: true): Promise<readonly string[]>;\n  async getAttribute(locator: PartLocator, name: string, isMultiple: false): Promise<Optional<string>>;\n  async getAttribute(locator: PartLocator, name: string): Promise<Optional<string>>;\n  async getAttribute(\n    locator: PartLocator,\n    name: string,\n    isMultiple?: boolean\n  ): Promise<Optional<string> | readonly string[]> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    if (isMultiple) {\n      const locators = await elLocator.all();\n      const values: string[] = [];\n      for (const locator of locators) {\n        const value = await locator.getAttribute(name);\n        if (value != null) {\n          values.push(value);\n        }\n      }\n      return values;\n    }\n    const value = await elLocator.getAttribute(name);\n    return value ?? undefined;\n  }\n\n  async getText(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const text = await this.page.locator(cssLocator).textContent();\n    return text ?? undefined;\n  }\n\n  async exists(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const count = await this.page.locator(cssLocator).count();\n    return count > 0;\n  }\n\n  async isChecked(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const checked = await this.page.locator(cssLocator).isChecked();\n    return checked;\n  }\n\n  async isDisabled(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const isDisabled = await this.page.locator(cssLocator).isDisabled();\n    return isDisabled;\n  }\n\n  async isReadonly(locator: PartLocator): Promise<boolean> {\n    const readonly = await this.getAttribute(locator, 'readonly');\n    return readonly != null;\n  }\n\n  async isVisible(locator: PartLocator): Promise<boolean> {\n    const exists = await this.exists(locator);\n    if (!exists) {\n      return false;\n    }\n\n    async function checkCssVisibility(\n      prop: CssProperty,\n      invisibleValue: string,\n      interactor: PlaywrightInteractor\n    ): Promise<boolean> {\n      try {\n        const value = await interactor.getStyleValue(locator, prop);\n        return value !== invisibleValue;\n      } catch (e) {\n        // Element may disappear or detached while being checked because of animation\n        // when it happens, an error is thrown.  In this case, if indeed the element\n        // is not visible, we return false.  Otherwise, we re-throw the error.\n        if ((await interactor.exists(locator)) === false) {\n          return false;\n        }\n        throw e;\n      }\n    }\n\n    if ((await checkCssVisibility('opacity', '0', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('visibility', 'hidden', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('display', 'none', this)) === false) {\n      return false;\n    }\n\n    return true;\n  }\n\n  async hasCssClass(locator: PartLocator, className: string): Promise<boolean> {\n    const classNames = await this.getAttribute(locator, 'class');\n    if (classNames == null) {\n      return false;\n    }\n\n    const names = classNames.split(/\\s+/);\n    return names.includes(className);\n  }\n\n  async hasAttribute(locator: PartLocator, name: string): Promise<boolean> {\n    const attrValue = await this.getAttribute(locator, name);\n    return attrValue != null;\n  }\n\n  //#region\n  async innerHTML(locator: PartLocator): Promise<string> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).innerHTML();\n  }\n  //#endregion\n\n  clone(): Interactor {\n    return new PlaywrightInteractor(this.page);\n  }\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\nimport { PlaywrightInteractor } from './PlaywrightInteractor';\n\n/**\n * Create a {@link TestEngine} instance backed by Playwright.\n *\n * @param page - Playwright page used for interaction.\n * @param partDefinitions - Scene part definitions describing the scene\n *   structure for the engine.\n * @returns A configured {@link TestEngine} ready for use.\n */\nexport function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T> {\n  const engine = new TestEngine([], new PlaywrightInteractor(page), {\n    parts: partDefinitions,\n  });\n\n  return engine;\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport {\n  E2eTestInterface,\n  E2eTestRunEnvironmentFixture,\n  TestFrameworkMapper,\n} from '@atomic-testing/internal-test-runner';\nimport { expect, Page, test } from '@playwright/test';\n\nimport { createTestEngine } from './createTestEngine';\n\n/**\n * Navigate the current Playwright page to the provided URL.\n *\n * @param url - Destination URL to load.\n * @param fixture - Optional test fixture supplying the Playwright page.\n */\nexport async function goto(url: string): Promise<void>;\nexport async function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;\nexport async function goto(url: string, fixture?: E2eTestRunEnvironmentFixture): Promise<void> {\n  const page = fixture!.page as Page;\n  await page.goto(url);\n}\n\n/**\n * Create a {@link TestEngine} bound to the Playwright page in the given fixture.\n *\n * @param scenePart - Scene definition to drive.\n * @param fixture - Fixture providing the Playwright page.\n */\nexport function playwrightGetTestEngine<T extends ScenePart>(\n  scenePart: T,\n  fixture: E2eTestRunEnvironmentFixture\n): TestEngine<T> {\n  const page = fixture.page as Page;\n  return createTestEngine(page, scenePart);\n}\n\nexport const playWrightTestFrameworkMapper: TestFrameworkMapper = {\n  assertEqual: (a, b) => expect(a).toEqual(b),\n  // @ts-expect-error - expect type is not compatible with the type of the test framework\n  describe: test.describe,\n\n  beforeEach: test.beforeEach,\n  afterEach: test.afterEach,\n  beforeAll: test.beforeAll,\n  afterAll: test.afterAll,\n\n  // @ts-expect-error - expect type is not compatible with the type of the test framework\n  test: test,\n\n  // @ts-expect-error - expect type is not compatible with the type of the test framework\n  it: test,\n};\n\n/**\n * Get a typed interface for running end-to-end tests with Playwright.\n */\nexport function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T> {\n  return {\n    getTestEngine: playwrightGetTestEngine,\n    goto,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["page: Page","locatorUtil","optionLocator: PartLocator","values: string[]","labels: string[]","dateUtil","timingUtil","defaultWaitForOption","interactorUtil","locator","TestEngine","playWrightTestFrameworkMapper: TestFrameworkMapper","test"],"sources":["../src/PlaywrightInteractor.ts","../src/createTestEngine.ts","../src/testRunnerAdapter.ts"],"sourcesContent":["import {\n  BlurOption,\n  byCssSelector,\n  ClickOption,\n  CssProperty,\n  dateUtil,\n  defaultWaitForOption,\n  EnterTextOption,\n  FocusOption,\n  HoverOption,\n  Interactor,\n  interactorUtil,\n  locatorUtil,\n  MouseEnterOption,\n  MouseLeaveOption,\n  MouseOutOption,\n  MouseDownOption,\n  MouseMoveOption,\n  MouseUpOption,\n  Optional,\n  PartLocator,\n  timingUtil,\n  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\n/**\n * Implementation of the {@link Interactor} interface using Playwright.\n */\nexport class PlaywrightInteractor implements Interactor {\n  /**\n   * @param page - Playwright page instance used to drive the browser.\n   */\n  constructor(public readonly page: Page) {}\n\n  /**\n   * Select the given option values on a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @param values - Values to select.\n   */\n  async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).selectOption(values);\n  }\n\n  /**\n   * Get the value of an `<input>` element.\n   *\n   * @param locator - Locator pointing to the input element.\n   * @returns The current value of the input or `undefined` if not present.\n   */\n  async getInputValue(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).inputValue();\n  }\n\n  /**\n   * Retrieve the values of selected options within a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @returns Array of selected option values or `undefined` when no option is selected.\n   */\n  async getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const values: string[] = [];\n    for (const option of allOptions) {\n      const value = await option.getAttribute('value');\n      if (value != null) {\n        values.push(value);\n      }\n    }\n    return values;\n  }\n\n  async getSelectLabels(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const labels: string[] = [];\n    for (const option of allOptions) {\n      const label = await option.textContent();\n      if (label != null) {\n        labels.push(label);\n      }\n    }\n    return labels;\n  }\n\n  async getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    const value = await elLocator.evaluate((element, prop) => {\n      return window.getComputedStyle(element).getPropertyValue(prop as string);\n    }, propertyName);\n    return value;\n  }\n\n  async enterText(locator: PartLocator, text: string, option?: Optional<Partial<EnterTextOption>>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    if (!option?.append) {\n      await this.page.locator(cssLocator).clear();\n    }\n\n    // If it is a date, time or datetime-local input, validate the date format\n    const type = (await this.getAttribute(locator, 'type')) ?? '';\n    if (dateUtil.isHtmlDateInputType(type)) {\n      const result = dateUtil.validateHtmlDateInput(type, text);\n      if (!result.valid) {\n        throw new Error(\n          `Invalid date format for type: ${type}, expected format: ${result.format}, example: ${result.example}`\n        );\n      }\n    }\n    await this.page.locator(cssLocator).fill(text);\n  }\n\n  async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).click({ position: option?.position });\n  }\n\n  async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).hover({ position: option?.position });\n  }\n\n  async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.move(0, 0);\n  }\n\n  async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.down();\n  }\n\n  async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.up();\n  }\n\n  async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    return this.hover(locator, option);\n  }\n\n  async mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // First hover over the element to trigger mouseenter/mouseover\n    await this.page.locator(cssLocator).hover();\n    // Then dispatch mouseout event directly for cross-browser reliability\n    await this.page.locator(cssLocator).dispatchEvent('mouseout');\n  }\n\n  async mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void> {\n    return this.hover(locator);\n  }\n\n  async mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // First hover over the element to trigger mouseenter/mouseover\n    await this.page.locator(cssLocator).hover();\n    // Dispatch mouseout which triggers both mouseout and mouseleave handlers in React\n    await this.page.locator(cssLocator).dispatchEvent('mouseout');\n  }\n\n  async focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.focus(cssLocator);\n  }\n\n  async blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).blur();\n  }\n\n  //#region wait conditions\n  wait(ms: number): Promise<void> {\n    return timingUtil.wait(ms);\n  }\n\n  async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption\n  ): Promise<void> {\n    return interactorUtil.interactorWaitUtil(locator, this, option);\n  }\n\n  waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    return timingUtil.waitUntil(option);\n  }\n  //#endregion\n\n  async getAttribute(locator: PartLocator, name: string, isMultiple: true): Promise<readonly string[]>;\n  async getAttribute(locator: PartLocator, name: string, isMultiple: false): Promise<Optional<string>>;\n  async getAttribute(locator: PartLocator, name: string): Promise<Optional<string>>;\n  async getAttribute(\n    locator: PartLocator,\n    name: string,\n    isMultiple?: boolean\n  ): Promise<Optional<string> | readonly string[]> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    if (isMultiple) {\n      const locators = await elLocator.all();\n      const values: string[] = [];\n      for (const locator of locators) {\n        const value = await locator.getAttribute(name);\n        if (value != null) {\n          values.push(value);\n        }\n      }\n      return values;\n    }\n    const value = await elLocator.getAttribute(name);\n    return value ?? undefined;\n  }\n\n  async getText(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const text = await this.page.locator(cssLocator).textContent();\n    return text ?? undefined;\n  }\n\n  async exists(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const count = await this.page.locator(cssLocator).count();\n    return count > 0;\n  }\n\n  async isChecked(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const checked = await this.page.locator(cssLocator).isChecked();\n    return checked;\n  }\n\n  async isDisabled(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const isDisabled = await this.page.locator(cssLocator).isDisabled();\n    return isDisabled;\n  }\n\n  async isReadonly(locator: PartLocator): Promise<boolean> {\n    const readonly = await this.getAttribute(locator, 'readonly');\n    return readonly != null;\n  }\n\n  async isVisible(locator: PartLocator): Promise<boolean> {\n    const exists = await this.exists(locator);\n    if (!exists) {\n      return false;\n    }\n\n    async function checkCssVisibility(\n      prop: CssProperty,\n      invisibleValue: string,\n      interactor: PlaywrightInteractor\n    ): Promise<boolean> {\n      try {\n        const value = await interactor.getStyleValue(locator, prop);\n        return value !== invisibleValue;\n      } catch (e) {\n        // Element may disappear or detached while being checked because of animation\n        // when it happens, an error is thrown.  In this case, if indeed the element\n        // is not visible, we return false.  Otherwise, we re-throw the error.\n        if ((await interactor.exists(locator)) === false) {\n          return false;\n        }\n        throw e;\n      }\n    }\n\n    if ((await checkCssVisibility('opacity', '0', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('visibility', 'hidden', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('display', 'none', this)) === false) {\n      return false;\n    }\n\n    return true;\n  }\n\n  async hasCssClass(locator: PartLocator, className: string): Promise<boolean> {\n    const classNames = await this.getAttribute(locator, 'class');\n    if (classNames == null) {\n      return false;\n    }\n\n    const names = classNames.split(/\\s+/);\n    return names.includes(className);\n  }\n\n  async hasAttribute(locator: PartLocator, name: string): Promise<boolean> {\n    const attrValue = await this.getAttribute(locator, name);\n    return attrValue != null;\n  }\n\n  //#region\n  async innerHTML(locator: PartLocator): Promise<string> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).innerHTML();\n  }\n  //#endregion\n\n  clone(): Interactor {\n    return new PlaywrightInteractor(this.page);\n  }\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\nimport { PlaywrightInteractor } from './PlaywrightInteractor';\n\n/**\n * Create a {@link TestEngine} instance backed by Playwright.\n *\n * @param page - Playwright page used for interaction.\n * @param partDefinitions - Scene part definitions describing the scene\n *   structure for the engine.\n * @returns A configured {@link TestEngine} ready for use.\n */\nexport function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T> {\n  const engine = new TestEngine([], new PlaywrightInteractor(page), {\n    parts: partDefinitions,\n  });\n\n  return engine;\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport {\n  E2eTestInterface,\n  E2eTestRunEnvironmentFixture,\n  TestFrameworkMapper,\n} from '@atomic-testing/internal-test-runner';\nimport { expect, Page, test } from '@playwright/test';\n\nimport { createTestEngine } from './createTestEngine';\n\n/**\n * Navigate the current Playwright page to the provided URL.\n *\n * @param url - Destination URL to load.\n * @param fixture - Optional test fixture supplying the Playwright page.\n */\nexport async function goto(url: string): Promise<void>;\nexport async function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;\nexport async function goto(url: string, fixture?: E2eTestRunEnvironmentFixture): Promise<void> {\n  const page = fixture!.page as Page;\n  await page.goto(url);\n}\n\n/**\n * Create a {@link TestEngine} bound to the Playwright page in the given fixture.\n *\n * @param scenePart - Scene definition to drive.\n * @param fixture - Fixture providing the Playwright page.\n */\nexport function playwrightGetTestEngine<T extends ScenePart>(\n  scenePart: T,\n  fixture: E2eTestRunEnvironmentFixture\n): TestEngine<T> {\n  const page = fixture.page as Page;\n  return createTestEngine(page, scenePart);\n}\n\n/**\n * Playwright adapter for the TestFrameworkMapper interface.\n */\nexport const playWrightTestFrameworkMapper: TestFrameworkMapper = {\n  /*\n   * INTENTIONAL @ts-expect-error comments: Playwright's test functions have different type\n   * signatures than the normalized TestFrameworkMapper interface. Playwright uses fixture-based\n   * callbacks with destructuring ({ page, browser }) while our interface uses a union type for\n   * Jest compatibility (done callback or fixture object). The functions are compatible at runtime\n   * but TypeScript cannot verify this due to these fundamental signature differences.\n   */\n\n  assertEqual: (a, b) => expect(a).toEqual(b),\n  assertNotEqual: (a, b) => expect(a).not.toEqual(b),\n  assertTrue: value => expect(value).toBe(true),\n  assertFalse: value => expect(value).toBe(false),\n  assertApproxEqual: (actual, expected, tolerance) =>\n    expect(Math.abs(actual - expected)).toBeLessThanOrEqual(tolerance),\n  // @ts-expect-error - Playwright describe signature differs from TestFrameworkMapper.Describe\n  describe: test.describe,\n\n  beforeEach: test.beforeEach,\n  afterEach: test.afterEach,\n  beforeAll: test.beforeAll,\n  afterAll: test.afterAll,\n\n  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test\n  test: test,\n\n  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test\n  it: test,\n};\n\n/**\n * Get a typed interface for running end-to-end tests with Playwright.\n */\nexport function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T> {\n  return {\n    getTestEngine: playwrightGetTestEngine,\n    goto,\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
+import { BlurOption, ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
 import { Page } from "@playwright/test";
 import { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from "@atomic-testing/internal-test-runner";
 
@@ -57,7 +57,8 @@ declare class PlaywrightInteractor implements Interactor {
   mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void>;
   mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void>;
   mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void>;
-  focus(locator: PartLocator, _option: Partial<FocusOption>): Promise<void>;
+  focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void>;
+  blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void>;
   wait(ms: number): Promise<void>;
   waitUntilComponentState(locator: PartLocator, option?: Partial<Readonly<WaitForOption>>): Promise<void>;
   waitUntil<T>(option: WaitUntilOption<T>): Promise<T>;
@@ -92,6 +93,9 @@ declare function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promi
  * @param fixture - Fixture providing the Playwright page.
  */
 declare function playwrightGetTestEngine<T extends ScenePart>(scenePart: T, fixture: E2eTestRunEnvironmentFixture): TestEngine<T>;
+/**
+ * Playwright adapter for the TestFrameworkMapper interface.
+ */
 declare const playWrightTestFrameworkMapper: TestFrameworkMapper;
 /**
  * Get a typed interface for running end-to-end tests with Playwright.

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
+import { BlurOption, ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
 import { Page } from "@playwright/test";
 import { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from "@atomic-testing/internal-test-runner";
 
@@ -57,7 +57,8 @@ declare class PlaywrightInteractor implements Interactor {
   mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void>;
   mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void>;
   mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void>;
-  focus(locator: PartLocator, _option: Partial<FocusOption>): Promise<void>;
+  focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void>;
+  blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void>;
   wait(ms: number): Promise<void>;
   waitUntilComponentState(locator: PartLocator, option?: Partial<Readonly<WaitForOption>>): Promise<void>;
   waitUntil<T>(option: WaitUntilOption<T>): Promise<T>;
@@ -92,6 +93,9 @@ declare function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promi
  * @param fixture - Fixture providing the Playwright page.
  */
 declare function playwrightGetTestEngine<T extends ScenePart>(scenePart: T, fixture: E2eTestRunEnvironmentFixture): TestEngine<T>;
+/**
+ * Playwright adapter for the TestFrameworkMapper interface.
+ */
 declare const playWrightTestFrameworkMapper: TestFrameworkMapper;
 /**
  * Get a typed interface for running end-to-end tests with Playwright.

package/dist/index.mjs

@@ -102,22 +102,26 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		return this.hover(locator, option);
 	}
 	async mouseOut(locator, _option) {
-		await this.hover(locator, { position: {
-			x: 0,
-			y: 0
-		} });
-		await this.page.mouse.move(-10, -10);
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).hover();
+		await this.page.locator(cssLocator).dispatchEvent("mouseout");
 	}
 	async mouseEnter(locator, _option) {
 		return this.hover(locator);
 	}
 	async mouseLeave(locator, _option) {
-		return this.mouseOut(locator);
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).hover();
+		await this.page.locator(cssLocator).dispatchEvent("mouseout");
 	}
 	async focus(locator, _option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
 		return this.page.focus(cssLocator);
 	}
+	async blur(locator, _option) {
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).blur();
+	}
 	wait(ms) {
 		return timingUtil.wait(ms);
 	}
@@ -221,8 +225,15 @@ function playwrightGetTestEngine(scenePart, fixture) {
 	const page = fixture.page;
 	return createTestEngine(page, scenePart);
 }
+/**
+* Playwright adapter for the TestFrameworkMapper interface.
+*/
 const playWrightTestFrameworkMapper = {
 	assertEqual: (a, b) => expect(a).toEqual(b),
+	assertNotEqual: (a, b) => expect(a).not.toEqual(b),
+	assertTrue: (value) => expect(value).toBe(true),
+	assertFalse: (value) => expect(value).toBe(false),
+	assertApproxEqual: (actual, expected, tolerance) => expect(Math.abs(actual - expected)).toBeLessThanOrEqual(tolerance),
 	describe: test.describe,
 	beforeEach: test.beforeEach,
 	afterEach: test.afterEach,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["page: Page","optionLocator: PartLocator","values: string[]","labels: string[]","locator","playWrightTestFrameworkMapper: TestFrameworkMapper"],"sources":["../src/PlaywrightInteractor.ts","../src/createTestEngine.ts","../src/testRunnerAdapter.ts"],"sourcesContent":["import {\n  byCssSelector,\n  ClickOption,\n  CssProperty,\n  dateUtil,\n  defaultWaitForOption,\n  EnterTextOption,\n  FocusOption,\n  HoverOption,\n  Interactor,\n  interactorUtil,\n  locatorUtil,\n  MouseEnterOption,\n  MouseLeaveOption,\n  MouseOutOption,\n  MouseDownOption,\n  MouseMoveOption,\n  MouseUpOption,\n  Optional,\n  PartLocator,\n  timingUtil,\n  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\n/**\n * Implementation of the {@link Interactor} interface using Playwright.\n */\nexport class PlaywrightInteractor implements Interactor {\n  /**\n   * @param page - Playwright page instance used to drive the browser.\n   */\n  constructor(public readonly page: Page) {}\n\n  /**\n   * Select the given option values on a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @param values - Values to select.\n   */\n  async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).selectOption(values);\n  }\n\n  /**\n   * Get the value of an `<input>` element.\n   *\n   * @param locator - Locator pointing to the input element.\n   * @returns The current value of the input or `undefined` if not present.\n   */\n  async getInputValue(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).inputValue();\n  }\n\n  /**\n   * Retrieve the values of selected options within a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @returns Array of selected option values or `undefined` when no option is selected.\n   */\n  async getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const values: string[] = [];\n    for (const option of allOptions) {\n      const value = await option.getAttribute('value');\n      if (value != null) {\n        values.push(value);\n      }\n    }\n    return values;\n  }\n\n  async getSelectLabels(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const labels: string[] = [];\n    for (const option of allOptions) {\n      const label = await option.textContent();\n      if (label != null) {\n        labels.push(label);\n      }\n    }\n    return labels;\n  }\n\n  async getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    const value = await elLocator.evaluate((element, prop) => {\n      return window.getComputedStyle(element).getPropertyValue(prop as string);\n    }, propertyName);\n    return value;\n  }\n\n  async enterText(locator: PartLocator, text: string, option?: Optional<Partial<EnterTextOption>>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    if (!option?.append) {\n      await this.page.locator(cssLocator).clear();\n    }\n\n    // If it is a date, time or datetime-local input, validate the date format\n    const type = (await this.getAttribute(locator, 'type')) ?? '';\n    if (dateUtil.isHtmlDateInputType(type)) {\n      const result = dateUtil.validateHtmlDateInput(type, text);\n      if (!result.valid) {\n        throw new Error(\n          `Invalid date format for type: ${type}, expected format: ${result.format}, example: ${result.example}`\n        );\n      }\n    }\n    await this.page.locator(cssLocator).fill(text);\n  }\n\n  async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).click({ position: option?.position });\n  }\n\n  async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).hover({ position: option?.position });\n  }\n\n  async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.move(0, 0);\n  }\n\n  async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.down();\n  }\n\n  async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.up();\n  }\n\n  async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    return this.hover(locator, option);\n  }\n\n  async mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void> {\n    await this.hover(locator, {\n      position: {\n        x: 0,\n        y: 0,\n      },\n    });\n    await this.page.mouse.move(-10, -10);\n  }\n\n  async mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void> {\n    return this.hover(locator);\n  }\n\n  async mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void> {\n    return this.mouseOut(locator);\n  }\n\n  async focus(locator: PartLocator, _option: Partial<FocusOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.focus(cssLocator);\n  }\n\n  //#region wait conditions\n  wait(ms: number): Promise<void> {\n    return timingUtil.wait(ms);\n  }\n\n  async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption\n  ): Promise<void> {\n    return interactorUtil.interactorWaitUtil(locator, this, option);\n  }\n\n  waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    return timingUtil.waitUntil(option);\n  }\n  //#endregion\n\n  async getAttribute(locator: PartLocator, name: string, isMultiple: true): Promise<readonly string[]>;\n  async getAttribute(locator: PartLocator, name: string, isMultiple: false): Promise<Optional<string>>;\n  async getAttribute(locator: PartLocator, name: string): Promise<Optional<string>>;\n  async getAttribute(\n    locator: PartLocator,\n    name: string,\n    isMultiple?: boolean\n  ): Promise<Optional<string> | readonly string[]> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    if (isMultiple) {\n      const locators = await elLocator.all();\n      const values: string[] = [];\n      for (const locator of locators) {\n        const value = await locator.getAttribute(name);\n        if (value != null) {\n          values.push(value);\n        }\n      }\n      return values;\n    }\n    const value = await elLocator.getAttribute(name);\n    return value ?? undefined;\n  }\n\n  async getText(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const text = await this.page.locator(cssLocator).textContent();\n    return text ?? undefined;\n  }\n\n  async exists(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const count = await this.page.locator(cssLocator).count();\n    return count > 0;\n  }\n\n  async isChecked(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const checked = await this.page.locator(cssLocator).isChecked();\n    return checked;\n  }\n\n  async isDisabled(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const isDisabled = await this.page.locator(cssLocator).isDisabled();\n    return isDisabled;\n  }\n\n  async isReadonly(locator: PartLocator): Promise<boolean> {\n    const readonly = await this.getAttribute(locator, 'readonly');\n    return readonly != null;\n  }\n\n  async isVisible(locator: PartLocator): Promise<boolean> {\n    const exists = await this.exists(locator);\n    if (!exists) {\n      return false;\n    }\n\n    async function checkCssVisibility(\n      prop: CssProperty,\n      invisibleValue: string,\n      interactor: PlaywrightInteractor\n    ): Promise<boolean> {\n      try {\n        const value = await interactor.getStyleValue(locator, prop);\n        return value !== invisibleValue;\n      } catch (e) {\n        // Element may disappear or detached while being checked because of animation\n        // when it happens, an error is thrown.  In this case, if indeed the element\n        // is not visible, we return false.  Otherwise, we re-throw the error.\n        if ((await interactor.exists(locator)) === false) {\n          return false;\n        }\n        throw e;\n      }\n    }\n\n    if ((await checkCssVisibility('opacity', '0', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('visibility', 'hidden', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('display', 'none', this)) === false) {\n      return false;\n    }\n\n    return true;\n  }\n\n  async hasCssClass(locator: PartLocator, className: string): Promise<boolean> {\n    const classNames = await this.getAttribute(locator, 'class');\n    if (classNames == null) {\n      return false;\n    }\n\n    const names = classNames.split(/\\s+/);\n    return names.includes(className);\n  }\n\n  async hasAttribute(locator: PartLocator, name: string): Promise<boolean> {\n    const attrValue = await this.getAttribute(locator, name);\n    return attrValue != null;\n  }\n\n  //#region\n  async innerHTML(locator: PartLocator): Promise<string> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).innerHTML();\n  }\n  //#endregion\n\n  clone(): Interactor {\n    return new PlaywrightInteractor(this.page);\n  }\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\nimport { PlaywrightInteractor } from './PlaywrightInteractor';\n\n/**\n * Create a {@link TestEngine} instance backed by Playwright.\n *\n * @param page - Playwright page used for interaction.\n * @param partDefinitions - Scene part definitions describing the scene\n *   structure for the engine.\n * @returns A configured {@link TestEngine} ready for use.\n */\nexport function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T> {\n  const engine = new TestEngine([], new PlaywrightInteractor(page), {\n    parts: partDefinitions,\n  });\n\n  return engine;\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport {\n  E2eTestInterface,\n  E2eTestRunEnvironmentFixture,\n  TestFrameworkMapper,\n} from '@atomic-testing/internal-test-runner';\nimport { expect, Page, test } from '@playwright/test';\n\nimport { createTestEngine } from './createTestEngine';\n\n/**\n * Navigate the current Playwright page to the provided URL.\n *\n * @param url - Destination URL to load.\n * @param fixture - Optional test fixture supplying the Playwright page.\n */\nexport async function goto(url: string): Promise<void>;\nexport async function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;\nexport async function goto(url: string, fixture?: E2eTestRunEnvironmentFixture): Promise<void> {\n  const page = fixture!.page as Page;\n  await page.goto(url);\n}\n\n/**\n * Create a {@link TestEngine} bound to the Playwright page in the given fixture.\n *\n * @param scenePart - Scene definition to drive.\n * @param fixture - Fixture providing the Playwright page.\n */\nexport function playwrightGetTestEngine<T extends ScenePart>(\n  scenePart: T,\n  fixture: E2eTestRunEnvironmentFixture\n): TestEngine<T> {\n  const page = fixture.page as Page;\n  return createTestEngine(page, scenePart);\n}\n\nexport const playWrightTestFrameworkMapper: TestFrameworkMapper = {\n  assertEqual: (a, b) => expect(a).toEqual(b),\n  // @ts-expect-error - expect type is not compatible with the type of the test framework\n  describe: test.describe,\n\n  beforeEach: test.beforeEach,\n  afterEach: test.afterEach,\n  beforeAll: test.beforeAll,\n  afterAll: test.afterAll,\n\n  // @ts-expect-error - expect type is not compatible with the type of the test framework\n  test: test,\n\n  // @ts-expect-error - expect type is not compatible with the type of the test framework\n  it: test,\n};\n\n/**\n * Get a typed interface for running end-to-end tests with Playwright.\n */\nexport function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T> {\n  return {\n    getTestEngine: playwrightGetTestEngine,\n    goto,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["page: Page","optionLocator: PartLocator","values: string[]","labels: string[]","locator","playWrightTestFrameworkMapper: TestFrameworkMapper"],"sources":["../src/PlaywrightInteractor.ts","../src/createTestEngine.ts","../src/testRunnerAdapter.ts"],"sourcesContent":["import {\n  BlurOption,\n  byCssSelector,\n  ClickOption,\n  CssProperty,\n  dateUtil,\n  defaultWaitForOption,\n  EnterTextOption,\n  FocusOption,\n  HoverOption,\n  Interactor,\n  interactorUtil,\n  locatorUtil,\n  MouseEnterOption,\n  MouseLeaveOption,\n  MouseOutOption,\n  MouseDownOption,\n  MouseMoveOption,\n  MouseUpOption,\n  Optional,\n  PartLocator,\n  timingUtil,\n  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\n/**\n * Implementation of the {@link Interactor} interface using Playwright.\n */\nexport class PlaywrightInteractor implements Interactor {\n  /**\n   * @param page - Playwright page instance used to drive the browser.\n   */\n  constructor(public readonly page: Page) {}\n\n  /**\n   * Select the given option values on a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @param values - Values to select.\n   */\n  async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).selectOption(values);\n  }\n\n  /**\n   * Get the value of an `<input>` element.\n   *\n   * @param locator - Locator pointing to the input element.\n   * @returns The current value of the input or `undefined` if not present.\n   */\n  async getInputValue(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).inputValue();\n  }\n\n  /**\n   * Retrieve the values of selected options within a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @returns Array of selected option values or `undefined` when no option is selected.\n   */\n  async getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const values: string[] = [];\n    for (const option of allOptions) {\n      const value = await option.getAttribute('value');\n      if (value != null) {\n        values.push(value);\n      }\n    }\n    return values;\n  }\n\n  async getSelectLabels(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const labels: string[] = [];\n    for (const option of allOptions) {\n      const label = await option.textContent();\n      if (label != null) {\n        labels.push(label);\n      }\n    }\n    return labels;\n  }\n\n  async getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    const value = await elLocator.evaluate((element, prop) => {\n      return window.getComputedStyle(element).getPropertyValue(prop as string);\n    }, propertyName);\n    return value;\n  }\n\n  async enterText(locator: PartLocator, text: string, option?: Optional<Partial<EnterTextOption>>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    if (!option?.append) {\n      await this.page.locator(cssLocator).clear();\n    }\n\n    // If it is a date, time or datetime-local input, validate the date format\n    const type = (await this.getAttribute(locator, 'type')) ?? '';\n    if (dateUtil.isHtmlDateInputType(type)) {\n      const result = dateUtil.validateHtmlDateInput(type, text);\n      if (!result.valid) {\n        throw new Error(\n          `Invalid date format for type: ${type}, expected format: ${result.format}, example: ${result.example}`\n        );\n      }\n    }\n    await this.page.locator(cssLocator).fill(text);\n  }\n\n  async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).click({ position: option?.position });\n  }\n\n  async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).hover({ position: option?.position });\n  }\n\n  async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.move(0, 0);\n  }\n\n  async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.down();\n  }\n\n  async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.up();\n  }\n\n  async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    return this.hover(locator, option);\n  }\n\n  async mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // First hover over the element to trigger mouseenter/mouseover\n    await this.page.locator(cssLocator).hover();\n    // Then dispatch mouseout event directly for cross-browser reliability\n    await this.page.locator(cssLocator).dispatchEvent('mouseout');\n  }\n\n  async mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void> {\n    return this.hover(locator);\n  }\n\n  async mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // First hover over the element to trigger mouseenter/mouseover\n    await this.page.locator(cssLocator).hover();\n    // Dispatch mouseout which triggers both mouseout and mouseleave handlers in React\n    await this.page.locator(cssLocator).dispatchEvent('mouseout');\n  }\n\n  async focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.focus(cssLocator);\n  }\n\n  async blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).blur();\n  }\n\n  //#region wait conditions\n  wait(ms: number): Promise<void> {\n    return timingUtil.wait(ms);\n  }\n\n  async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption\n  ): Promise<void> {\n    return interactorUtil.interactorWaitUtil(locator, this, option);\n  }\n\n  waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    return timingUtil.waitUntil(option);\n  }\n  //#endregion\n\n  async getAttribute(locator: PartLocator, name: string, isMultiple: true): Promise<readonly string[]>;\n  async getAttribute(locator: PartLocator, name: string, isMultiple: false): Promise<Optional<string>>;\n  async getAttribute(locator: PartLocator, name: string): Promise<Optional<string>>;\n  async getAttribute(\n    locator: PartLocator,\n    name: string,\n    isMultiple?: boolean\n  ): Promise<Optional<string> | readonly string[]> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    if (isMultiple) {\n      const locators = await elLocator.all();\n      const values: string[] = [];\n      for (const locator of locators) {\n        const value = await locator.getAttribute(name);\n        if (value != null) {\n          values.push(value);\n        }\n      }\n      return values;\n    }\n    const value = await elLocator.getAttribute(name);\n    return value ?? undefined;\n  }\n\n  async getText(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const text = await this.page.locator(cssLocator).textContent();\n    return text ?? undefined;\n  }\n\n  async exists(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const count = await this.page.locator(cssLocator).count();\n    return count > 0;\n  }\n\n  async isChecked(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const checked = await this.page.locator(cssLocator).isChecked();\n    return checked;\n  }\n\n  async isDisabled(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const isDisabled = await this.page.locator(cssLocator).isDisabled();\n    return isDisabled;\n  }\n\n  async isReadonly(locator: PartLocator): Promise<boolean> {\n    const readonly = await this.getAttribute(locator, 'readonly');\n    return readonly != null;\n  }\n\n  async isVisible(locator: PartLocator): Promise<boolean> {\n    const exists = await this.exists(locator);\n    if (!exists) {\n      return false;\n    }\n\n    async function checkCssVisibility(\n      prop: CssProperty,\n      invisibleValue: string,\n      interactor: PlaywrightInteractor\n    ): Promise<boolean> {\n      try {\n        const value = await interactor.getStyleValue(locator, prop);\n        return value !== invisibleValue;\n      } catch (e) {\n        // Element may disappear or detached while being checked because of animation\n        // when it happens, an error is thrown.  In this case, if indeed the element\n        // is not visible, we return false.  Otherwise, we re-throw the error.\n        if ((await interactor.exists(locator)) === false) {\n          return false;\n        }\n        throw e;\n      }\n    }\n\n    if ((await checkCssVisibility('opacity', '0', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('visibility', 'hidden', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('display', 'none', this)) === false) {\n      return false;\n    }\n\n    return true;\n  }\n\n  async hasCssClass(locator: PartLocator, className: string): Promise<boolean> {\n    const classNames = await this.getAttribute(locator, 'class');\n    if (classNames == null) {\n      return false;\n    }\n\n    const names = classNames.split(/\\s+/);\n    return names.includes(className);\n  }\n\n  async hasAttribute(locator: PartLocator, name: string): Promise<boolean> {\n    const attrValue = await this.getAttribute(locator, name);\n    return attrValue != null;\n  }\n\n  //#region\n  async innerHTML(locator: PartLocator): Promise<string> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).innerHTML();\n  }\n  //#endregion\n\n  clone(): Interactor {\n    return new PlaywrightInteractor(this.page);\n  }\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\nimport { PlaywrightInteractor } from './PlaywrightInteractor';\n\n/**\n * Create a {@link TestEngine} instance backed by Playwright.\n *\n * @param page - Playwright page used for interaction.\n * @param partDefinitions - Scene part definitions describing the scene\n *   structure for the engine.\n * @returns A configured {@link TestEngine} ready for use.\n */\nexport function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T> {\n  const engine = new TestEngine([], new PlaywrightInteractor(page), {\n    parts: partDefinitions,\n  });\n\n  return engine;\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport {\n  E2eTestInterface,\n  E2eTestRunEnvironmentFixture,\n  TestFrameworkMapper,\n} from '@atomic-testing/internal-test-runner';\nimport { expect, Page, test } from '@playwright/test';\n\nimport { createTestEngine } from './createTestEngine';\n\n/**\n * Navigate the current Playwright page to the provided URL.\n *\n * @param url - Destination URL to load.\n * @param fixture - Optional test fixture supplying the Playwright page.\n */\nexport async function goto(url: string): Promise<void>;\nexport async function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;\nexport async function goto(url: string, fixture?: E2eTestRunEnvironmentFixture): Promise<void> {\n  const page = fixture!.page as Page;\n  await page.goto(url);\n}\n\n/**\n * Create a {@link TestEngine} bound to the Playwright page in the given fixture.\n *\n * @param scenePart - Scene definition to drive.\n * @param fixture - Fixture providing the Playwright page.\n */\nexport function playwrightGetTestEngine<T extends ScenePart>(\n  scenePart: T,\n  fixture: E2eTestRunEnvironmentFixture\n): TestEngine<T> {\n  const page = fixture.page as Page;\n  return createTestEngine(page, scenePart);\n}\n\n/**\n * Playwright adapter for the TestFrameworkMapper interface.\n */\nexport const playWrightTestFrameworkMapper: TestFrameworkMapper = {\n  /*\n   * INTENTIONAL @ts-expect-error comments: Playwright's test functions have different type\n   * signatures than the normalized TestFrameworkMapper interface. Playwright uses fixture-based\n   * callbacks with destructuring ({ page, browser }) while our interface uses a union type for\n   * Jest compatibility (done callback or fixture object). The functions are compatible at runtime\n   * but TypeScript cannot verify this due to these fundamental signature differences.\n   */\n\n  assertEqual: (a, b) => expect(a).toEqual(b),\n  assertNotEqual: (a, b) => expect(a).not.toEqual(b),\n  assertTrue: value => expect(value).toBe(true),\n  assertFalse: value => expect(value).toBe(false),\n  assertApproxEqual: (actual, expected, tolerance) =>\n    expect(Math.abs(actual - expected)).toBeLessThanOrEqual(tolerance),\n  // @ts-expect-error - Playwright describe signature differs from TestFrameworkMapper.Describe\n  describe: test.describe,\n\n  beforeEach: test.beforeEach,\n  afterEach: test.afterEach,\n  beforeAll: test.beforeAll,\n  afterAll: test.afterAll,\n\n  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test\n  test: test,\n\n  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test\n  it: test,\n};\n\n/**\n * Get a typed interface for running end-to-end tests with Playwright.\n */\nexport function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T> {\n  return {\n    getTestEngine: playwrightGetTestEngine,\n    goto,\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atomic-testing/playwright",
-  "version": "0.79.0",
+  "version": "0.81.0",
   "description": "Atomic Testing Playwright Adapter",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -17,8 +17,8 @@
     "directory": "packages/playwright"
   },
   "dependencies": {
-    "@atomic-testing/core": "0.79.0",
-    "@atomic-testing/internal-test-runner": "0.79.0"
+    "@atomic-testing/core": "0.81.0",
+    "@atomic-testing/internal-test-runner": "0.81.0"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.50.0"

package/src/PlaywrightInteractor.ts

@@ -1,4 +1,5 @@
 import {
+  BlurOption,
   byCssSelector,
   ClickOption,
   CssProperty,
@@ -155,13 +156,11 @@ export class PlaywrightInteractor implements Interactor {
   }
 
   async mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void> {
-    await this.hover(locator, {
-      position: {
-        x: 0,
-        y: 0,
-      },
-    });
-    await this.page.mouse.move(-10, -10);
+    const cssLocator = await locatorUtil.toCssSelector(locator, this);
+    // First hover over the element to trigger mouseenter/mouseover
+    await this.page.locator(cssLocator).hover();
+    // Then dispatch mouseout event directly for cross-browser reliability
+    await this.page.locator(cssLocator).dispatchEvent('mouseout');
   }
 
   async mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void> {
@@ -169,14 +168,23 @@ export class PlaywrightInteractor implements Interactor {
   }
 
   async mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void> {
-    return this.mouseOut(locator);
+    const cssLocator = await locatorUtil.toCssSelector(locator, this);
+    // First hover over the element to trigger mouseenter/mouseover
+    await this.page.locator(cssLocator).hover();
+    // Dispatch mouseout which triggers both mouseout and mouseleave handlers in React
+    await this.page.locator(cssLocator).dispatchEvent('mouseout');
   }
 
-  async focus(locator: PartLocator, _option: Partial<FocusOption>): Promise<void> {
+  async focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void> {
     const cssLocator = await locatorUtil.toCssSelector(locator, this);
     return this.page.focus(cssLocator);
   }
 
+  async blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void> {
+    const cssLocator = await locatorUtil.toCssSelector(locator, this);
+    await this.page.locator(cssLocator).blur();
+  }
+
   //#region wait conditions
   wait(ms: number): Promise<void> {
     return timingUtil.wait(ms);

package/src/testRunnerAdapter.ts

@@ -35,9 +35,25 @@ export function playwrightGetTestEngine<T extends ScenePart>(
   return createTestEngine(page, scenePart);
 }
 
+/**
+ * Playwright adapter for the TestFrameworkMapper interface.
+ */
 export const playWrightTestFrameworkMapper: TestFrameworkMapper = {
+  /*
+   * INTENTIONAL @ts-expect-error comments: Playwright's test functions have different type
+   * signatures than the normalized TestFrameworkMapper interface. Playwright uses fixture-based
+   * callbacks with destructuring ({ page, browser }) while our interface uses a union type for
+   * Jest compatibility (done callback or fixture object). The functions are compatible at runtime
+   * but TypeScript cannot verify this due to these fundamental signature differences.
+   */
+
   assertEqual: (a, b) => expect(a).toEqual(b),
-  // @ts-expect-error - expect type is not compatible with the type of the test framework
+  assertNotEqual: (a, b) => expect(a).not.toEqual(b),
+  assertTrue: value => expect(value).toBe(true),
+  assertFalse: value => expect(value).toBe(false),
+  assertApproxEqual: (actual, expected, tolerance) =>
+    expect(Math.abs(actual - expected)).toBeLessThanOrEqual(tolerance),
+  // @ts-expect-error - Playwright describe signature differs from TestFrameworkMapper.Describe
   describe: test.describe,
 
   beforeEach: test.beforeEach,
@@ -45,10 +61,10 @@ export const playWrightTestFrameworkMapper: TestFrameworkMapper = {
   beforeAll: test.beforeAll,
   afterAll: test.afterAll,
 
-  // @ts-expect-error - expect type is not compatible with the type of the test framework
+  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test
   test: test,
 
-  // @ts-expect-error - expect type is not compatible with the type of the test framework
+  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test
   it: test,
 };