@atomic-testing/playwright 0.87.0 → 0.89.0

package/dist/index.mjs

@@ -1,5 +1,4 @@
-import { TestEngine, byCssSelector, dateUtil, defaultWaitForOption, interactorUtil, locatorUtil, timingUtil } from "@atomic-testing/core";
-import { expect, test } from "@playwright/test";
+import { ElementNotFoundError, TestEngine, byCssSelector, dateUtil, defaultWaitForOption, interactorUtil, locatorUtil, timingUtil } from "@atomic-testing/core";
 //#region src/PlaywrightInteractor.ts
 /**
 * Implementation of the {@link Interactor} interface using Playwright.
@@ -12,14 +11,138 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		this.page = page;
 	}
 	/**
+	* Run a Playwright mutation and normalize a "locator matched nothing" failure
+	* into {@link ElementNotFoundError}, so a missing element throws the same error
+	* class here as it does in `DOMInteractor`, regardless of environment (the
+	* unified contract ratified in ADR-006).
+	*
+	* Playwright auto-waits for actionability and then throws its own
+	* `TimeoutError`. We translate that to `ElementNotFoundError` ONLY when the
+	* element genuinely does not exist (count 0) and otherwise rethrow the original
+	* error — preserving Playwright's auto-wait for an element that exists but is
+	* briefly not actionable (covered, disabled, animating). The trade-off is that
+	* a truly-missing element waits out the page's action timeout before throwing;
+	* bound it with `page.setDefaultTimeout` when fast failure matters.
+	*
+	* @param locator - Locator the mutation targets
+	* @param action - Method name used in the error message (e.g. `'click'`)
+	* @param run - The Playwright action to execute
+	* @throws {ElementNotFoundError} If the action fails and the element is absent
+	*/
+	async runMutation(locator, action, run) {
+		try {
+			return await run();
+		} catch (e) {
+			if (await this.exists(locator) === false) throw new ElementNotFoundError(locator, action);
+			throw e;
+		}
+	}
+	/**
 	* Select the given option values on a `<select>` element.
 	*
 	* @param locator - Locator to the `<select>` element.
 	* @param values - Values to select.
+	* @throws {ElementNotFoundError} If the element is not found
 	*/
 	async selectOptionValue(locator, values) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).selectOption(values);
+		await this.runMutation(locator, "selectOptionValue", () => this.page.locator(cssLocator).selectOption(values));
+	}
+	/**
+	* Set the selected files on a `<input type="file">` element.
+	*
+	* Playwright's native `setInputFiles` reads the given paths from disk and
+	* populates the input's `FileList`, firing the change event — the only way to
+	* fill a file input, whose value cannot be set programmatically.
+	*
+	* @param locator - Locator of the `<input type="file">` element
+	* @param files - One or more filesystem paths to upload
+	* @throws {ElementNotFoundError} If the element is not found
+	*/
+	async setInputFiles(locator, files) {
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		await this.runMutation(locator, "setInputFiles", () => this.page.locator(cssLocator).setInputFiles(files));
+	}
+	/**
+	* Scroll the located element into view, no-op if already visible.
+	*
+	* Delegates to Playwright's `scrollIntoViewIfNeeded`, which performs a real
+	* layout-aware scroll in the browser.
+	*
+	* @param locator - Locator of the element to scroll into view
+	* @throws {ElementNotFoundError} If the element is not found
+	*/
+	async scrollIntoView(locator) {
+		const css = await locatorUtil.toCssSelector(locator, this);
+		await this.runMutation(locator, "scrollIntoView", () => this.page.locator(css).scrollIntoViewIfNeeded());
+	}
+	/**
+	* Scroll the located element by the given pixel delta.
+	*
+	* The scroll is performed by evaluating `el.scrollBy(dx, dy)` on the element
+	* itself rather than `page.mouse.wheel`. A wheel event scrolls whatever sits
+	* under the pointer and is non-deterministic across chromium/firefox/webkit,
+	* whereas evaluating `scrollBy` on the resolved element scrolls exactly that
+	* element. This is a deliberate deviation from ADR 0001's per-engine table
+	* (which lists `page.mouse.wheel`), taking the alternative the step-5 prompt
+	* permits ("or evaluate el.scrollBy") for cross-browser determinism.
+	*
+	* @param locator - Locator of the scrollable element
+	* @param delta - Pixel offset to scroll by
+	* @throws {ElementNotFoundError} If the element is not found
+	*/
+	async scrollBy(locator, delta) {
+		const css = await locatorUtil.toCssSelector(locator, this);
+		await this.runMutation(locator, "scrollBy", () => this.page.locator(css).evaluate((el, d) => el.scrollBy(d.x, d.y), {
+			x: delta.x,
+			y: delta.y
+		}));
+	}
+	/**
+	* Drag the source element and drop it onto the target element.
+	*
+	* Delegates to Playwright's native `Locator.dragTo`, which performs a real,
+	* layout-aware drag gesture in the browser.
+	*
+	* @param source - Locator of the element to drag
+	* @param target - Locator of the drop target
+	* @throws {ElementNotFoundError} If either the source or target is not found
+	*/
+	async dragTo(source, target) {
+		const srcCss = await locatorUtil.toCssSelector(source, this);
+		const tgtCss = await locatorUtil.toCssSelector(target, this);
+		try {
+			await this.page.locator(srcCss).dragTo(this.page.locator(tgtCss));
+		} catch (e) {
+			if (await this.exists(source) === false) throw new ElementNotFoundError(source, "dragTo");
+			if (await this.exists(target) === false) throw new ElementNotFoundError(target, "dragTo");
+			throw e;
+		}
+	}
+	/**
+	* Drag the located element by the given pixel delta from its center.
+	*
+	* The gesture is a single uninterrupted `move → down → move → up` sequence
+	* computed from the element's center. It deliberately does NOT reuse
+	* {@link mouseMove}/{@link mouseDown} — `mouseMove` resets the pointer with
+	* `page.mouse.move(0, 0)` after hovering, which would corrupt the drag path
+	* (see ADR 0001, option 5). The center comes from {@link getBoundingRect},
+	* which throws `ElementNotFoundError` when the element has no box, so this
+	* shares that "element not found" contract instead of re-deriving the box +
+	* guard here.
+	*
+	* @param locator - Locator of the element to drag
+	* @param delta - Pixel offset to drag by
+	* @throws {ElementNotFoundError} If the element has no bounding box
+	*/
+	async drag(locator, delta) {
+		const rect = await this.getBoundingRect(locator);
+		const cx = rect.x + rect.width / 2;
+		const cy = rect.y + rect.height / 2;
+		await this.page.mouse.move(cx, cy);
+		await this.page.mouse.down();
+		await this.page.mouse.move(cx + delta.x, cy + delta.y, { steps: 8 });
+		await this.page.mouse.up();
 	}
 	/**
 	* Get the value of an `<input>` element.
@@ -69,65 +192,105 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 	}
 	async enterText(locator, text, option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		if (!option?.append) await this.page.locator(cssLocator).clear();
-		const type = await this.getAttribute(locator, "type") ?? "";
-		if (dateUtil.isHtmlDateInputType(type)) {
-			const result = dateUtil.validateHtmlDateInput(type, text);
-			if (!result.valid) throw new Error(`Invalid date format for type: ${type}, expected format: ${result.format}, example: ${result.example}`);
-		}
-		await this.page.locator(cssLocator).fill(text);
+		await this.runMutation(locator, "enterText", async () => {
+			if (!option?.append) await this.page.locator(cssLocator).clear();
+			const type = await this.getAttribute(locator, "type") ?? "";
+			if (dateUtil.isHtmlDateInputType(type)) {
+				const result = dateUtil.validateHtmlDateInput(type, text);
+				if (!result.valid) throw new Error(`Invalid date format for type: ${type}, expected format: ${result.format}, example: ${result.example}`);
+			}
+			await this.page.locator(cssLocator).fill(text);
+		});
+	}
+	async setRangeValue(locator, value) {
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		await this.runMutation(locator, "setRangeValue", () => this.page.locator(cssLocator).evaluate((el, nextValue) => {
+			const input = el;
+			(Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, "value")?.set)?.call(input, nextValue);
+			input.dispatchEvent(new Event("input", { bubbles: true }));
+			input.dispatchEvent(new Event("change", { bubbles: true }));
+		}, String(value)));
 	}
 	async click(locator, option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).click({ position: option?.position });
+		await this.runMutation(locator, "click", () => this.page.locator(cssLocator).click({ position: option?.position }));
+	}
+	/**
+	* Dispatch a right-click on the located element to open its context menu.
+	*
+	* Delegates to Playwright's native right-button click, which fires a real
+	* `contextmenu` event in the browser.
+	*
+	* @param locator - Locator of the element to right-click
+	* @throws {ElementNotFoundError} If the element is not found
+	*/
+	async contextMenu(locator) {
+		const css = await locatorUtil.toCssSelector(locator, this);
+		await this.runMutation(locator, "contextMenu", () => this.page.locator(css).click({ button: "right" }));
 	}
 	async hover(locator, option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).hover({ position: option?.position });
+		await this.runMutation(locator, "hover", () => this.page.locator(cssLocator).hover({ position: option?.position }));
 	}
 	async mouseMove(locator, option) {
-		await this.hover(locator, { position: option?.position });
-		await this.page.mouse.move(0, 0);
+		await this.runMutation(locator, "mouseMove", async () => {
+			await this.hover(locator, { position: option?.position });
+			await this.page.mouse.move(0, 0);
+		});
 	}
 	async mouseDown(locator, option) {
-		await this.hover(locator, { position: option?.position });
-		await this.page.mouse.down();
+		await this.runMutation(locator, "mouseDown", async () => {
+			await this.hover(locator, { position: option?.position });
+			await this.page.mouse.down();
+		});
 	}
 	async mouseUp(locator, option) {
-		await this.hover(locator, { position: option?.position });
-		await this.page.mouse.up();
+		await this.runMutation(locator, "mouseUp", async () => {
+			await this.hover(locator, { position: option?.position });
+			await this.page.mouse.up();
+		});
 	}
 	async mouseOver(locator, option) {
-		return this.hover(locator, option);
+		await this.runMutation(locator, "mouseOver", () => this.hover(locator, option));
 	}
 	async mouseOut(locator, _option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).hover();
-		await this.page.locator(cssLocator).dispatchEvent("mouseout");
+		await this.runMutation(locator, "mouseOut", async () => {
+			await this.page.locator(cssLocator).hover();
+			await this.page.locator(cssLocator).dispatchEvent("mouseout");
+		});
 	}
 	async mouseEnter(locator, _option) {
-		return this.hover(locator);
+		await this.runMutation(locator, "mouseEnter", () => this.hover(locator));
 	}
 	async mouseLeave(locator, _option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).hover();
-		await this.page.locator(cssLocator).dispatchEvent("mouseout");
+		await this.runMutation(locator, "mouseLeave", async () => {
+			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);
+		await this.runMutation(locator, "focus", () => this.page.focus(cssLocator));
 	}
 	async blur(locator, _option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).blur();
+		await this.runMutation(locator, "blur", () => this.page.locator(cssLocator).blur());
 	}
-	async pressKey(locator, key, _option) {
+	async pressKey(locator, key, option) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).press(key);
+		const modifiers = [];
+		if (option?.ctrl) modifiers.push("Control");
+		if (option?.alt) modifiers.push("Alt");
+		if (option?.shift) modifiers.push("Shift");
+		if (option?.meta) modifiers.push("Meta");
+		const chord = modifiers.length > 0 ? `${modifiers.join("+")}+${key}` : key;
+		await this.runMutation(locator, "pressKey", () => this.page.locator(cssLocator).press(chord));
 	}
 	async activate(locator) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
-		await this.page.locator(cssLocator).dispatchEvent("click");
+		await this.runMutation(locator, "activate", () => this.page.locator(cssLocator).dispatchEvent("click"));
 	}
 	wait(ms) {
 		return timingUtil.wait(ms);
@@ -156,6 +319,28 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
 		return await this.page.locator(cssLocator).textContent() ?? void 0;
 	}
+	/**
+	* Get the located element's bounding rectangle.
+	*
+	* `boundingBox()` returns `null` for a detached/invisible element rather than
+	* auto-waiting, so this throws `ElementNotFoundError` directly (no auto-wait)
+	* — matching the unified "element not found" contract (ADR-006).
+	*
+	* @param locator - Locator of the element to measure
+	* @returns The element's bounding rectangle in CSS pixels
+	* @throws {ElementNotFoundError} If the element has no bounding box
+	*/
+	async getBoundingRect(locator) {
+		const css = await locatorUtil.toCssSelector(locator, this);
+		const box = await this.page.locator(css).boundingBox();
+		if (box == null) throw new ElementNotFoundError(locator, "getBoundingRect");
+		return {
+			x: box.x,
+			y: box.y,
+			width: box.width,
+			height: box.height
+		};
+	}
 	async exists(locator) {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
 		return await this.page.locator(cssLocator).count() > 0;
@@ -216,47 +401,6 @@ function createTestEngine(page, partDefinitions) {
 	return new TestEngine([], new PlaywrightInteractor(page), { parts: partDefinitions });
 }
 //#endregion
-//#region src/testRunnerAdapter.ts
-async function goto(url, fixture) {
-	await fixture.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);
-}
-/**
-* 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,
-	beforeAll: test.beforeAll,
-	afterAll: test.afterAll,
-	test,
-	it: test
-};
-/**
-* Get a typed interface for running end-to-end tests with Playwright.
-*/
-function getTestRunnerInterface() {
-	return {
-		getTestEngine: playwrightGetTestEngine,
-		goto
-	};
-}
-//#endregion
-export { PlaywrightInteractor, createTestEngine, getTestRunnerInterface, goto, playWrightTestFrameworkMapper, playwrightGetTestEngine };
+export { PlaywrightInteractor, createTestEngine };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"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  PressKeyOption,\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  async pressKey(locator: PartLocator, key: string, _option?: Partial<PressKeyOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // locator.press auto-focuses the element, then dispatches a real, trusted\n    // KeyboardEvent — the browser equivalent of the DOM focus-first keyDown/keyUp.\n    await this.page.locator(cssLocator).press(key);\n  }\n\n  async activate(locator: PartLocator): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // Geometry-free activation mirrors the mouseout dispatch precedent above: it\n    // bypasses hit-testing to actuate a covered or zero-size input that\n    // locator.click() (a real geometry hit-test) cannot reach.\n    await this.page.locator(cssLocator).dispatchEvent('click');\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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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/PlaywrightInteractor.ts","../src/createTestEngine.ts"],"sourcesContent":["import {\n  BlurOption,\n  BoundingRect,\n  byCssSelector,\n  ClickOption,\n  CssProperty,\n  dateUtil,\n  defaultWaitForOption,\n  ElementNotFoundError,\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  Point,\n  PressKeyOption,\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   * Run a Playwright mutation and normalize a \"locator matched nothing\" failure\n   * into {@link ElementNotFoundError}, so a missing element throws the same error\n   * class here as it does in `DOMInteractor`, regardless of environment (the\n   * unified contract ratified in ADR-006).\n   *\n   * Playwright auto-waits for actionability and then throws its own\n   * `TimeoutError`. We translate that to `ElementNotFoundError` ONLY when the\n   * element genuinely does not exist (count 0) and otherwise rethrow the original\n   * error — preserving Playwright's auto-wait for an element that exists but is\n   * briefly not actionable (covered, disabled, animating). The trade-off is that\n   * a truly-missing element waits out the page's action timeout before throwing;\n   * bound it with `page.setDefaultTimeout` when fast failure matters.\n   *\n   * @param locator - Locator the mutation targets\n   * @param action - Method name used in the error message (e.g. `'click'`)\n   * @param run - The Playwright action to execute\n   * @throws {ElementNotFoundError} If the action fails and the element is absent\n   */\n  private async runMutation<T>(locator: PartLocator, action: string, run: () => Promise<T>): Promise<T> {\n    try {\n      return await run();\n    } catch (e) {\n      if ((await this.exists(locator)) === false) {\n        throw new ElementNotFoundError(locator, action);\n      }\n      throw e;\n    }\n  }\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   * @throws {ElementNotFoundError} If the element is not found\n   */\n  async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'selectOptionValue', () => this.page.locator(cssLocator).selectOption(values));\n  }\n\n  /**\n   * Set the selected files on a `<input type=\"file\">` element.\n   *\n   * Playwright's native `setInputFiles` reads the given paths from disk and\n   * populates the input's `FileList`, firing the change event — the only way to\n   * fill a file input, whose value cannot be set programmatically.\n   *\n   * @param locator - Locator of the `<input type=\"file\">` element\n   * @param files - One or more filesystem paths to upload\n   * @throws {ElementNotFoundError} If the element is not found\n   */\n  async setInputFiles(locator: PartLocator, files: string | string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'setInputFiles', () => this.page.locator(cssLocator).setInputFiles(files));\n  }\n\n  /**\n   * Scroll the located element into view, no-op if already visible.\n   *\n   * Delegates to Playwright's `scrollIntoViewIfNeeded`, which performs a real\n   * layout-aware scroll in the browser.\n   *\n   * @param locator - Locator of the element to scroll into view\n   * @throws {ElementNotFoundError} If the element is not found\n   */\n  async scrollIntoView(locator: PartLocator): Promise<void> {\n    const css = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'scrollIntoView', () => this.page.locator(css).scrollIntoViewIfNeeded());\n  }\n\n  /**\n   * Scroll the located element by the given pixel delta.\n   *\n   * The scroll is performed by evaluating `el.scrollBy(dx, dy)` on the element\n   * itself rather than `page.mouse.wheel`. A wheel event scrolls whatever sits\n   * under the pointer and is non-deterministic across chromium/firefox/webkit,\n   * whereas evaluating `scrollBy` on the resolved element scrolls exactly that\n   * element. This is a deliberate deviation from ADR 0001's per-engine table\n   * (which lists `page.mouse.wheel`), taking the alternative the step-5 prompt\n   * permits (\"or evaluate el.scrollBy\") for cross-browser determinism.\n   *\n   * @param locator - Locator of the scrollable element\n   * @param delta - Pixel offset to scroll by\n   * @throws {ElementNotFoundError} If the element is not found\n   */\n  async scrollBy(locator: PartLocator, delta: Point): Promise<void> {\n    const css = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'scrollBy', () =>\n      this.page.locator(css).evaluate((el, d) => el.scrollBy(d.x, d.y), { x: delta.x, y: delta.y })\n    );\n  }\n\n  /**\n   * Drag the source element and drop it onto the target element.\n   *\n   * Delegates to Playwright's native `Locator.dragTo`, which performs a real,\n   * layout-aware drag gesture in the browser.\n   *\n   * @param source - Locator of the element to drag\n   * @param target - Locator of the drop target\n   * @throws {ElementNotFoundError} If either the source or target is not found\n   */\n  async dragTo(source: PartLocator, target: PartLocator): Promise<void> {\n    const srcCss = await locatorUtil.toCssSelector(source, this);\n    const tgtCss = await locatorUtil.toCssSelector(target, this);\n    try {\n      await this.page.locator(srcCss).dragTo(this.page.locator(tgtCss));\n    } catch (e) {\n      if ((await this.exists(source)) === false) {\n        throw new ElementNotFoundError(source, 'dragTo');\n      }\n      if ((await this.exists(target)) === false) {\n        throw new ElementNotFoundError(target, 'dragTo');\n      }\n      throw e;\n    }\n  }\n\n  /**\n   * Drag the located element by the given pixel delta from its center.\n   *\n   * The gesture is a single uninterrupted `move → down → move → up` sequence\n   * computed from the element's center. It deliberately does NOT reuse\n   * {@link mouseMove}/{@link mouseDown} — `mouseMove` resets the pointer with\n   * `page.mouse.move(0, 0)` after hovering, which would corrupt the drag path\n   * (see ADR 0001, option 5). The center comes from {@link getBoundingRect},\n   * which throws `ElementNotFoundError` when the element has no box, so this\n   * shares that \"element not found\" contract instead of re-deriving the box +\n   * guard here.\n   *\n   * @param locator - Locator of the element to drag\n   * @param delta - Pixel offset to drag by\n   * @throws {ElementNotFoundError} If the element has no bounding box\n   */\n  async drag(locator: PartLocator, delta: Point): Promise<void> {\n    const rect = await this.getBoundingRect(locator);\n    const cx = rect.x + rect.width / 2;\n    const cy = rect.y + rect.height / 2;\n    await this.page.mouse.move(cx, cy);\n    await this.page.mouse.down();\n    await this.page.mouse.move(cx + delta.x, cy + delta.y, { steps: 8 });\n    await this.page.mouse.up();\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    await this.runMutation(locator, 'enterText', async () => {\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\n  async setRangeValue(locator: PartLocator, value: number): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // Playwright's `fill` rejects `<input type=\"range\">` (it is not a fillable\n    // text control), so set the value in-page through the native value setter.\n    // Calling the prototype setter both sanitizes the value to the input's step\n    // (the browser snaps an off-step target to the nearest valid step) and lets\n    // React's value tracker observe the change; the dispatched input/change\n    // events then drive a controlled component (e.g. MUI Slider) to re-render.\n    await this.runMutation(locator, 'setRangeValue', () =>\n      this.page.locator(cssLocator).evaluate((el, nextValue) => {\n        const input = el as HTMLInputElement;\n        const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value')?.set;\n        setter?.call(input, nextValue);\n        input.dispatchEvent(new Event('input', { bubbles: true }));\n        input.dispatchEvent(new Event('change', { bubbles: true }));\n      }, String(value))\n    );\n  }\n\n  async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'click', () => this.page.locator(cssLocator).click({ position: option?.position }));\n  }\n\n  /**\n   * Dispatch a right-click on the located element to open its context menu.\n   *\n   * Delegates to Playwright's native right-button click, which fires a real\n   * `contextmenu` event in the browser.\n   *\n   * @param locator - Locator of the element to right-click\n   * @throws {ElementNotFoundError} If the element is not found\n   */\n  async contextMenu(locator: PartLocator): Promise<void> {\n    const css = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'contextMenu', () => this.page.locator(css).click({ button: 'right' }));\n  }\n\n  async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'hover', () => this.page.locator(cssLocator).hover({ position: option?.position }));\n  }\n\n  async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await this.runMutation(locator, 'mouseMove', async () => {\n      await this.hover(locator, { position: option?.position });\n      await this.page.mouse.move(0, 0);\n    });\n  }\n\n  async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await this.runMutation(locator, 'mouseDown', async () => {\n      await this.hover(locator, { position: option?.position });\n      await this.page.mouse.down();\n    });\n  }\n\n  async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await this.runMutation(locator, 'mouseUp', async () => {\n      await this.hover(locator, { position: option?.position });\n      await this.page.mouse.up();\n    });\n  }\n\n  async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    await this.runMutation(locator, 'mouseOver', () => 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    await this.runMutation(locator, 'mouseOut', async () => {\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\n  async mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void> {\n    await this.runMutation(locator, 'mouseEnter', () => this.hover(locator));\n  }\n\n  async mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'mouseLeave', async () => {\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\n  async focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.runMutation(locator, 'focus', () => 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.runMutation(locator, 'blur', () => this.page.locator(cssLocator).blur());\n  }\n\n  async pressKey(locator: PartLocator, key: string, option?: Partial<PressKeyOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // Compose Playwright's chord syntax — modifiers joined to the key by `+`, in\n    // Playwright's accepted Control+Alt+Shift+Meta order — so the browser holds\n    // those modifiers across the keypress and the event carries ctrlKey/etc.\n    const modifiers: string[] = [];\n    if (option?.ctrl) {\n      modifiers.push('Control');\n    }\n    if (option?.alt) {\n      modifiers.push('Alt');\n    }\n    if (option?.shift) {\n      modifiers.push('Shift');\n    }\n    if (option?.meta) {\n      modifiers.push('Meta');\n    }\n    const chord = modifiers.length > 0 ? `${modifiers.join('+')}+${key}` : key;\n    // locator.press auto-focuses the element, then dispatches a real, trusted\n    // KeyboardEvent — the browser equivalent of the DOM focus-first keyDown/keyUp.\n    // Caveat: for Shift + a printable key the browser case-folds `event.key`\n    // (`Shift+a` → `'A'`) whereas the jsdom path keeps `'a'` — only the modifier\n    // flags are delivered identically across engines (see #924).\n    await this.runMutation(locator, 'pressKey', () => this.page.locator(cssLocator).press(chord));\n  }\n\n  async activate(locator: PartLocator): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // Geometry-free activation mirrors the mouseout dispatch precedent above: it\n    // bypasses hit-testing to actuate a covered or zero-size input that\n    // locator.click() (a real geometry hit-test) cannot reach.\n    await this.runMutation(locator, 'activate', () => this.page.locator(cssLocator).dispatchEvent('click'));\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  /**\n   * Get the located element's bounding rectangle.\n   *\n   * `boundingBox()` returns `null` for a detached/invisible element rather than\n   * auto-waiting, so this throws `ElementNotFoundError` directly (no auto-wait)\n   * — matching the unified \"element not found\" contract (ADR-006).\n   *\n   * @param locator - Locator of the element to measure\n   * @returns The element's bounding rectangle in CSS pixels\n   * @throws {ElementNotFoundError} If the element has no bounding box\n   */\n  async getBoundingRect(locator: PartLocator): Promise<BoundingRect> {\n    const css = await locatorUtil.toCssSelector(locator, this);\n    const box = await this.page.locator(css).boundingBox();\n    if (box == null) {\n      throw new ElementNotFoundError(locator, 'getBoundingRect');\n    }\n    return { x: box.x, y: box.y, width: box.width, height: box.height };\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"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atomic-testing/playwright",
-  "version": "0.87.0",
+  "version": "0.89.0",
   "description": "Atomic Testing Playwright Adapter",
   "keywords": [],
   "license": "MIT",
@@ -25,14 +25,14 @@
     }
   },
   "dependencies": {
-    "@atomic-testing/core": "0.87.0",
-    "@atomic-testing/internal-test-runner": "0.87.0"
+    "@atomic-testing/core": "0.89.0"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.50.0"
   },
   "scripts": {
     "build": "tsdown",
-    "check:type": "tsgo --noEmit"
+    "check:type": "tsgo --noEmit",
+    "check:api": "api-extractor run"
   }
 }