@atomic-testing/playwright 0.59.0 → 0.70.0

package/dist/index.d.mts

@@ -3,14 +3,47 @@ import { Page } from "@playwright/test";
 import { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from "@atomic-testing/test-runner";
 
 //#region src/createTestEngine.d.ts
+
+/**
+ * Create a {@link TestEngine} instance backed by Playwright.
+ *
+ * @param page - Playwright page used for interaction.
+ * @param partDefinitions - Scene part definitions describing the scene
+ *   structure for the engine.
+ * @returns A configured {@link TestEngine} ready for use.
+ */
 declare function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T>;
 //#endregion
 //#region src/PlaywrightInteractor.d.ts
+/**
+ * Implementation of the {@link Interactor} interface using Playwright.
+ */
 declare class PlaywrightInteractor implements Interactor {
   readonly page: Page;
+  /**
+   * @param page - Playwright page instance used to drive the browser.
+   */
   constructor(page: Page);
+  /**
+   * Select the given option values on a `<select>` element.
+   *
+   * @param locator - Locator to the `<select>` element.
+   * @param values - Values to select.
+   */
   selectOptionValue(locator: PartLocator, values: string[]): Promise<void>;
+  /**
+   * Get the value of an `<input>` element.
+   *
+   * @param locator - Locator pointing to the input element.
+   * @returns The current value of the input or `undefined` if not present.
+   */
   getInputValue(locator: PartLocator): Promise<Optional<string>>;
+  /**
+   * Retrieve the values of selected options within a `<select>` element.
+   *
+   * @param locator - Locator to the `<select>` element.
+   * @returns Array of selected option values or `undefined` when no option is selected.
+   */
   getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>>;
   getSelectLabels(locator: PartLocator): Promise<Optional<readonly string[]>>;
   getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>>;
@@ -44,10 +77,25 @@ declare class PlaywrightInteractor implements Interactor {
 }
 //#endregion
 //#region src/testRunnerAdapter.d.ts
+/**
+ * Navigate the current Playwright page to the provided URL.
+ *
+ * @param url - Destination URL to load.
+ * @param fixture - Optional test fixture supplying the Playwright page.
+ */
 declare function goto(url: string): Promise<void>;
 declare function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;
+/**
+ * Create a {@link TestEngine} bound to the Playwright page in the given fixture.
+ *
+ * @param scenePart - Scene definition to drive.
+ * @param fixture - Fixture providing the Playwright page.
+ */
 declare function playwrightGetTestEngine<T extends ScenePart>(scenePart: T, fixture: E2eTestRunEnvironmentFixture): TestEngine<T>;
 declare const playWrightTestFrameworkMapper: TestFrameworkMapper;
+/**
+ * Get a typed interface for running end-to-end tests with Playwright.
+ */
 declare function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T>;
 //#endregion
 export { PlaywrightInteractor, createTestEngine, getTestRunnerInterface, goto, playWrightTestFrameworkMapper, playwrightGetTestEngine };

package/dist/index.d.ts

@@ -3,14 +3,47 @@ import { Page } from "@playwright/test";
 import { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from "@atomic-testing/test-runner";
 
 //#region src/createTestEngine.d.ts
+
+/**
+ * Create a {@link TestEngine} instance backed by Playwright.
+ *
+ * @param page - Playwright page used for interaction.
+ * @param partDefinitions - Scene part definitions describing the scene
+ *   structure for the engine.
+ * @returns A configured {@link TestEngine} ready for use.
+ */
 declare function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T>;
 //#endregion
 //#region src/PlaywrightInteractor.d.ts
+/**
+ * Implementation of the {@link Interactor} interface using Playwright.
+ */
 declare class PlaywrightInteractor implements Interactor {
   readonly page: Page;
+  /**
+   * @param page - Playwright page instance used to drive the browser.
+   */
   constructor(page: Page);
+  /**
+   * Select the given option values on a `<select>` element.
+   *
+   * @param locator - Locator to the `<select>` element.
+   * @param values - Values to select.
+   */
   selectOptionValue(locator: PartLocator, values: string[]): Promise<void>;
+  /**
+   * Get the value of an `<input>` element.
+   *
+   * @param locator - Locator pointing to the input element.
+   * @returns The current value of the input or `undefined` if not present.
+   */
   getInputValue(locator: PartLocator): Promise<Optional<string>>;
+  /**
+   * Retrieve the values of selected options within a `<select>` element.
+   *
+   * @param locator - Locator to the `<select>` element.
+   * @returns Array of selected option values or `undefined` when no option is selected.
+   */
   getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>>;
   getSelectLabels(locator: PartLocator): Promise<Optional<readonly string[]>>;
   getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>>;
@@ -44,10 +77,25 @@ declare class PlaywrightInteractor implements Interactor {
 }
 //#endregion
 //#region src/testRunnerAdapter.d.ts
+/**
+ * Navigate the current Playwright page to the provided URL.
+ *
+ * @param url - Destination URL to load.
+ * @param fixture - Optional test fixture supplying the Playwright page.
+ */
 declare function goto(url: string): Promise<void>;
 declare function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;
+/**
+ * Create a {@link TestEngine} bound to the Playwright page in the given fixture.
+ *
+ * @param scenePart - Scene definition to drive.
+ * @param fixture - Fixture providing the Playwright page.
+ */
 declare function playwrightGetTestEngine<T extends ScenePart>(scenePart: T, fixture: E2eTestRunEnvironmentFixture): TestEngine<T>;
 declare const playWrightTestFrameworkMapper: TestFrameworkMapper;
+/**
+ * Get a typed interface for running end-to-end tests with Playwright.
+ */
 declare function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T>;
 //#endregion
 export { PlaywrightInteractor, createTestEngine, getTestRunnerInterface, goto, playWrightTestFrameworkMapper, playwrightGetTestEngine };

package/dist/index.js

@@ -25,18 +25,42 @@ const __atomic_testing_core = __toESM(require("@atomic-testing/core"));
 const __playwright_test = __toESM(require("@playwright/test"));
 
 //#region src/PlaywrightInteractor.ts
+/**
+* Implementation of the {@link Interactor} interface using Playwright.
+*/
 var PlaywrightInteractor = class PlaywrightInteractor {
+	/**
+	* @param page - Playwright page instance used to drive the browser.
+	*/
 	constructor(page) {
 		this.page = page;
 	}
+	/**
+	* Select the given option values on a `<select>` element.
+	*
+	* @param locator - Locator to the `<select>` element.
+	* @param values - Values to select.
+	*/
 	async selectOptionValue(locator, values) {
 		const cssLocator = await __atomic_testing_core.locatorUtil.toCssSelector(locator, this);
 		await this.page.locator(cssLocator).selectOption(values);
 	}
+	/**
+	* Get the value of an `<input>` element.
+	*
+	* @param locator - Locator pointing to the input element.
+	* @returns The current value of the input or `undefined` if not present.
+	*/
 	async getInputValue(locator) {
 		const cssLocator = await __atomic_testing_core.locatorUtil.toCssSelector(locator, this);
 		return this.page.locator(cssLocator).inputValue();
 	}
+	/**
+	* Retrieve the values of selected options within a `<select>` element.
+	*
+	* @param locator - Locator to the `<select>` element.
+	* @returns Array of selected option values or `undefined` when no option is selected.
+	*/
 	async getSelectValues(locator) {
 		const optionLocator = (0, __atomic_testing_core.byCssSelector)("option:checked");
 		const selectedOptionLocator = __atomic_testing_core.locatorUtil.append(locator, optionLocator);
@@ -205,6 +229,14 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 
 //#endregion
 //#region src/createTestEngine.ts
+/**
+* Create a {@link TestEngine} instance backed by Playwright.
+*
+* @param page - Playwright page used for interaction.
+* @param partDefinitions - Scene part definitions describing the scene
+*   structure for the engine.
+* @returns A configured {@link TestEngine} ready for use.
+*/
 function createTestEngine(page, partDefinitions) {
 	const engine = new __atomic_testing_core.TestEngine([], new PlaywrightInteractor(page), { parts: partDefinitions });
 	return engine;
@@ -216,6 +248,12 @@ async function goto(url, fixture) {
 	const page = fixture.page;
 	await page.goto(url);
 }
+/**
+* Create a {@link TestEngine} bound to the Playwright page in the given fixture.
+*
+* @param scenePart - Scene definition to drive.
+* @param fixture - Fixture providing the Playwright page.
+*/
 function playwrightGetTestEngine(scenePart, fixture) {
 	const page = fixture.page;
 	return createTestEngine(page, scenePart);
@@ -230,6 +268,9 @@ const playWrightTestFrameworkMapper = {
 	test: __playwright_test.test,
 	it: __playwright_test.test
 };
+/**
+* Get a typed interface for running end-to-end tests with Playwright.
+*/
 function getTestRunnerInterface() {
 	return {
 		getTestEngine: playwrightGetTestEngine,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["page: Page","locator: PartLocator","values: string[]","optionLocator: PartLocator","labels: string[]","propertyName: CssProperty","text: string","option?: Optional<Partial<EnterTextOption>>","option?: Partial<ClickOption>","option?: Partial<HoverOption>","option?: Partial<MouseMoveOption>","option?: Partial<MouseDownOption>","option?: Partial<MouseUpOption>","_option?: Partial<MouseOutOption>","_option?: Partial<MouseEnterOption>","_option?: Partial<MouseLeaveOption>","_option: Partial<FocusOption>","ms: number","option: Partial<Readonly<WaitForOption>>","defaultWaitForOption","option: WaitUntilOption<T>","name: string","isMultiple?: boolean","locator","value","prop: CssProperty","invisibleValue: string","interactor: PlaywrightInteractor","className: string","page: Page","partDefinitions: T","TestEngine","url: string","fixture?: E2eTestRunEnvironmentFixture","scenePart: T","fixture: E2eTestRunEnvironmentFixture","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\nexport class PlaywrightInteractor implements Interactor {\n  constructor(public readonly page: Page) {}\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  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  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\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 { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from '@atomic-testing/test-runner';\nimport { expect, Page, test } from '@playwright/test';\n\nimport { createTestEngine } from './createTestEngine';\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\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\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.js","names":["page: Page","locator: PartLocator","values: string[]","optionLocator: PartLocator","labels: string[]","propertyName: CssProperty","text: string","option?: Optional<Partial<EnterTextOption>>","option?: Partial<ClickOption>","option?: Partial<HoverOption>","option?: Partial<MouseMoveOption>","option?: Partial<MouseDownOption>","option?: Partial<MouseUpOption>","_option?: Partial<MouseOutOption>","_option?: Partial<MouseEnterOption>","_option?: Partial<MouseLeaveOption>","_option: Partial<FocusOption>","ms: number","option: Partial<Readonly<WaitForOption>>","defaultWaitForOption","option: WaitUntilOption<T>","name: string","isMultiple?: boolean","locator","value","prop: CssProperty","invisibleValue: string","interactor: PlaywrightInteractor","className: string","page: Page","partDefinitions: T","TestEngine","url: string","fixture?: E2eTestRunEnvironmentFixture","scenePart: T","fixture: E2eTestRunEnvironmentFixture","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>(\n  page: Page,\n  partDefinitions: T,\n): 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/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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"}

package/dist/index.mjs

@@ -2,18 +2,42 @@ import { TestEngine, byCssSelector, dateUtil, defaultWaitForOption, interactorUt
 import { expect, test } from "@playwright/test";
 
 //#region src/PlaywrightInteractor.ts
+/**
+* Implementation of the {@link Interactor} interface using Playwright.
+*/
 var PlaywrightInteractor = class PlaywrightInteractor {
+	/**
+	* @param page - Playwright page instance used to drive the browser.
+	*/
 	constructor(page) {
 		this.page = page;
 	}
+	/**
+	* Select the given option values on a `<select>` element.
+	*
+	* @param locator - Locator to the `<select>` element.
+	* @param values - Values to select.
+	*/
 	async selectOptionValue(locator, values) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
 		await this.page.locator(cssLocator).selectOption(values);
 	}
+	/**
+	* Get the value of an `<input>` element.
+	*
+	* @param locator - Locator pointing to the input element.
+	* @returns The current value of the input or `undefined` if not present.
+	*/
 	async getInputValue(locator) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
 		return this.page.locator(cssLocator).inputValue();
 	}
+	/**
+	* Retrieve the values of selected options within a `<select>` element.
+	*
+	* @param locator - Locator to the `<select>` element.
+	* @returns Array of selected option values or `undefined` when no option is selected.
+	*/
 	async getSelectValues(locator) {
 		const optionLocator = byCssSelector("option:checked");
 		const selectedOptionLocator = locatorUtil.append(locator, optionLocator);
@@ -182,6 +206,14 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 
 //#endregion
 //#region src/createTestEngine.ts
+/**
+* Create a {@link TestEngine} instance backed by Playwright.
+*
+* @param page - Playwright page used for interaction.
+* @param partDefinitions - Scene part definitions describing the scene
+*   structure for the engine.
+* @returns A configured {@link TestEngine} ready for use.
+*/
 function createTestEngine(page, partDefinitions) {
 	const engine = new TestEngine([], new PlaywrightInteractor(page), { parts: partDefinitions });
 	return engine;
@@ -193,6 +225,12 @@ async function goto(url, fixture) {
 	const page = fixture.page;
 	await page.goto(url);
 }
+/**
+* Create a {@link TestEngine} bound to the Playwright page in the given fixture.
+*
+* @param scenePart - Scene definition to drive.
+* @param fixture - Fixture providing the Playwright page.
+*/
 function playwrightGetTestEngine(scenePart, fixture) {
 	const page = fixture.page;
 	return createTestEngine(page, scenePart);
@@ -207,6 +245,9 @@ const playWrightTestFrameworkMapper = {
 	test,
 	it: test
 };
+/**
+* Get a typed interface for running end-to-end tests with Playwright.
+*/
 function getTestRunnerInterface() {
 	return {
 		getTestEngine: playwrightGetTestEngine,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["page: Page","locator: PartLocator","values: string[]","optionLocator: PartLocator","labels: string[]","propertyName: CssProperty","text: string","option?: Optional<Partial<EnterTextOption>>","option?: Partial<ClickOption>","option?: Partial<HoverOption>","option?: Partial<MouseMoveOption>","option?: Partial<MouseDownOption>","option?: Partial<MouseUpOption>","_option?: Partial<MouseOutOption>","_option?: Partial<MouseEnterOption>","_option?: Partial<MouseLeaveOption>","_option: Partial<FocusOption>","ms: number","option: Partial<Readonly<WaitForOption>>","option: WaitUntilOption<T>","name: string","isMultiple?: boolean","locator","value","prop: CssProperty","invisibleValue: string","interactor: PlaywrightInteractor","className: string","page: Page","partDefinitions: T","url: string","fixture?: E2eTestRunEnvironmentFixture","scenePart: T","fixture: E2eTestRunEnvironmentFixture","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\nexport class PlaywrightInteractor implements Interactor {\n  constructor(public readonly page: Page) {}\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  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  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\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 { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from '@atomic-testing/test-runner';\nimport { expect, Page, test } from '@playwright/test';\n\nimport { createTestEngine } from './createTestEngine';\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\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\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","locator: PartLocator","values: string[]","optionLocator: PartLocator","labels: string[]","propertyName: CssProperty","text: string","option?: Optional<Partial<EnterTextOption>>","option?: Partial<ClickOption>","option?: Partial<HoverOption>","option?: Partial<MouseMoveOption>","option?: Partial<MouseDownOption>","option?: Partial<MouseUpOption>","_option?: Partial<MouseOutOption>","_option?: Partial<MouseEnterOption>","_option?: Partial<MouseLeaveOption>","_option: Partial<FocusOption>","ms: number","option: Partial<Readonly<WaitForOption>>","option: WaitUntilOption<T>","name: string","isMultiple?: boolean","locator","value","prop: CssProperty","invisibleValue: string","interactor: PlaywrightInteractor","className: string","page: Page","partDefinitions: T","url: string","fixture?: E2eTestRunEnvironmentFixture","scenePart: T","fixture: E2eTestRunEnvironmentFixture","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>(\n  page: Page,\n  partDefinitions: T,\n): 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/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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atomic-testing/playwright",
-  "version": "0.59.0",
+  "version": "0.70.0",
   "description": "Atomic Testing Playwright Adapter",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -18,8 +18,8 @@
     "directory": "packages/playwright"
   },
   "dependencies": {
-    "@atomic-testing/core": "0.59.0",
-    "@atomic-testing/test-runner": "0.59.0"
+    "@atomic-testing/core": "0.70.0",
+    "@atomic-testing/test-runner": "0.70.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.51.1",

package/src/PlaywrightInteractor.ts

@@ -24,19 +24,43 @@ import {
 } from '@atomic-testing/core';
 import { Page } from '@playwright/test';
 
+/**
+ * Implementation of the {@link Interactor} interface using Playwright.
+ */
 export class PlaywrightInteractor implements Interactor {
+  /**
+   * @param page - Playwright page instance used to drive the browser.
+   */
   constructor(public readonly page: Page) {}
 
+  /**
+   * Select the given option values on a `<select>` element.
+   *
+   * @param locator - Locator to the `<select>` element.
+   * @param values - Values to select.
+   */
   async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {
     const cssLocator = await locatorUtil.toCssSelector(locator, this);
     await this.page.locator(cssLocator).selectOption(values);
   }
 
+  /**
+   * Get the value of an `<input>` element.
+   *
+   * @param locator - Locator pointing to the input element.
+   * @returns The current value of the input or `undefined` if not present.
+   */
   async getInputValue(locator: PartLocator): Promise<Optional<string>> {
     const cssLocator = await locatorUtil.toCssSelector(locator, this);
     return this.page.locator(cssLocator).inputValue();
   }
 
+  /**
+   * Retrieve the values of selected options within a `<select>` element.
+   *
+   * @param locator - Locator to the `<select>` element.
+   * @returns Array of selected option values or `undefined` when no option is selected.
+   */
   async getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>> {
     const optionLocator: PartLocator = byCssSelector('option:checked');
     const selectedOptionLocator = locatorUtil.append(locator, optionLocator);

package/src/createTestEngine.ts

@@ -3,7 +3,18 @@ import { Page } from '@playwright/test';
 
 import { PlaywrightInteractor } from './PlaywrightInteractor';
 
-export function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T> {
+/**
+ * Create a {@link TestEngine} instance backed by Playwright.
+ *
+ * @param page - Playwright page used for interaction.
+ * @param partDefinitions - Scene part definitions describing the scene
+ *   structure for the engine.
+ * @returns A configured {@link TestEngine} ready for use.
+ */
+export function createTestEngine<T extends ScenePart>(
+  page: Page,
+  partDefinitions: T,
+): TestEngine<T> {
   const engine = new TestEngine([], new PlaywrightInteractor(page), {
     parts: partDefinitions,
   });

package/src/testRunnerAdapter.ts

@@ -1,9 +1,19 @@
 import { ScenePart, TestEngine } from '@atomic-testing/core';
-import { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from '@atomic-testing/test-runner';
+import {
+  E2eTestInterface,
+  E2eTestRunEnvironmentFixture,
+  TestFrameworkMapper,
+} from '@atomic-testing/test-runner';
 import { expect, Page, test } from '@playwright/test';
 
 import { createTestEngine } from './createTestEngine';
 
+/**
+ * Navigate the current Playwright page to the provided URL.
+ *
+ * @param url - Destination URL to load.
+ * @param fixture - Optional test fixture supplying the Playwright page.
+ */
 export async function goto(url: string): Promise<void>;
 export async function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;
 export async function goto(url: string, fixture?: E2eTestRunEnvironmentFixture): Promise<void> {
@@ -11,9 +21,15 @@ export async function goto(url: string, fixture?: E2eTestRunEnvironmentFixture):
   await page.goto(url);
 }
 
+/**
+ * Create a {@link TestEngine} bound to the Playwright page in the given fixture.
+ *
+ * @param scenePart - Scene definition to drive.
+ * @param fixture - Fixture providing the Playwright page.
+ */
 export function playwrightGetTestEngine<T extends ScenePart>(
   scenePart: T,
-  fixture: E2eTestRunEnvironmentFixture
+  fixture: E2eTestRunEnvironmentFixture,
 ): TestEngine<T> {
   const page = fixture.page as Page;
   return createTestEngine(page, scenePart);
@@ -36,6 +52,9 @@ export const playWrightTestFrameworkMapper: TestFrameworkMapper = {
   it: test,
 };
 
+/**
+ * Get a typed interface for running end-to-end tests with Playwright.
+ */
 export function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T> {
   return {
     getTestEngine: playwrightGetTestEngine,