@atomic-testing/playwright 0.85.0 → 0.88.0

package/dist/index.cjs

@@ -23,6 +23,100 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		await 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. Following
+	* this layer's convention, no `ElementNotFoundError` is fabricated: a missing
+	* element surfaces through Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the `<input type="file">` element
+	* @param files - One or more filesystem paths to upload
+	*/
+	async setInputFiles(locator, files) {
+		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await 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. Per this layer's convention, no
+	* `ElementNotFoundError` is fabricated: a missing element surfaces through
+	* Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the element to scroll into view
+	*/
+	async scrollIntoView(locator) {
+		const css = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await 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. As with
+	* {@link scrollIntoView}, no `ElementNotFoundError` is fabricated; a missing
+	* element surfaces through Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the scrollable element
+	* @param delta - Pixel offset to scroll by
+	*/
+	async scrollBy(locator, delta) {
+		const css = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await 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. Per this layer's convention, no
+	* `ElementNotFoundError` is fabricated: a missing element surfaces through
+	* Playwright's own auto-wait timeout.
+	*
+	* @param source - Locator of the element to drag
+	* @param target - Locator of the drop target
+	*/
+	async dragTo(source, target) {
+		const srcCss = await _atomic_testing_core.locatorUtil.toCssSelector(source, this);
+		const tgtCss = await _atomic_testing_core.locatorUtil.toCssSelector(target, this);
+		await this.page.locator(srcCss).dragTo(this.page.locator(tgtCss));
+	}
+	/**
+	* 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
+	* (detached/invisible) rather than auto-waiting — 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.
 	*
 	* @param locator - Locator pointing to the input element.
@@ -82,6 +176,20 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
 		await 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. Per this layer's convention, no
+	* `ElementNotFoundError` is fabricated: a missing element surfaces through
+	* Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the element to right-click
+	*/
+	async contextMenu(locator) {
+		const css = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(css).click({ button: "right" });
+	}
 	async hover(locator, option) {
 		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
 		await this.page.locator(cssLocator).hover({ position: option?.position });
@@ -122,6 +230,20 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
 		await this.page.locator(cssLocator).blur();
 	}
+	async pressKey(locator, key, option) {
+		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		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.page.locator(cssLocator).press(chord);
+	}
+	async activate(locator) {
+		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).dispatchEvent("click");
+	}
 	wait(ms) {
 		return _atomic_testing_core.timingUtil.wait(ms);
 	}
@@ -149,6 +271,29 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		const cssLocator = await _atomic_testing_core.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 is one of the few Playwright methods that throws
+	* `ElementNotFoundError` — matching the house "element not found" contract
+	* (ADR 0001).
+	*
+	* @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 _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
+		const box = await this.page.locator(css).boundingBox();
+		if (box == null) throw new _atomic_testing_core.ElementNotFoundError(locator, "getBoundingRect");
+		return {
+			x: box.x,
+			y: box.y,
+			width: box.width,
+			height: box.height
+		};
+	}
 	async exists(locator) {
 		const cssLocator = await _atomic_testing_core.locatorUtil.toCssSelector(locator, this);
 		return await this.page.locator(cssLocator).count() > 0;
@@ -238,7 +383,8 @@ const playWrightTestFrameworkMapper = {
 	beforeAll: _playwright_test.test.beforeAll,
 	afterAll: _playwright_test.test.afterAll,
 	test: _playwright_test.test,
-	it: _playwright_test.test
+	it: _playwright_test.test,
+	hasLayout: true
 };
 /**
 * Get a typed interface for running end-to-end tests with Playwright.

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["locatorUtil","dateUtil","timingUtil","defaultWaitForOption","interactorUtil","TestEngine","test"],"sources":["../src/PlaywrightInteractor.ts","../src/createTestEngine.ts","../src/testRunnerAdapter.ts"],"sourcesContent":["import {\n  BlurOption,\n  byCssSelector,\n  ClickOption,\n  CssProperty,\n  dateUtil,\n  defaultWaitForOption,\n  EnterTextOption,\n  FocusOption,\n  HoverOption,\n  Interactor,\n  interactorUtil,\n  locatorUtil,\n  MouseEnterOption,\n  MouseLeaveOption,\n  MouseOutOption,\n  MouseDownOption,\n  MouseMoveOption,\n  MouseUpOption,\n  Optional,\n  PartLocator,\n  timingUtil,\n  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\n/**\n * Implementation of the {@link Interactor} interface using Playwright.\n */\nexport class PlaywrightInteractor implements Interactor {\n  /**\n   * @param page - Playwright page instance used to drive the browser.\n   */\n  constructor(public readonly page: Page) {}\n\n  /**\n   * Select the given option values on a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @param values - Values to select.\n   */\n  async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).selectOption(values);\n  }\n\n  /**\n   * Get the value of an `<input>` element.\n   *\n   * @param locator - Locator pointing to the input element.\n   * @returns The current value of the input or `undefined` if not present.\n   */\n  async getInputValue(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).inputValue();\n  }\n\n  /**\n   * Retrieve the values of selected options within a `<select>` element.\n   *\n   * @param locator - Locator to the `<select>` element.\n   * @returns Array of selected option values or `undefined` when no option is selected.\n   */\n  async getSelectValues(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const values: string[] = [];\n    for (const option of allOptions) {\n      const value = await option.getAttribute('value');\n      if (value != null) {\n        values.push(value);\n      }\n    }\n    return values;\n  }\n\n  async getSelectLabels(locator: PartLocator): Promise<Optional<readonly string[]>> {\n    const optionLocator: PartLocator = byCssSelector('option:checked');\n    const selectedOptionLocator = locatorUtil.append(locator, optionLocator);\n    const cssLocator = await locatorUtil.toCssSelector(selectedOptionLocator, this);\n    const allOptions = await this.page.locator(cssLocator).all();\n    const labels: string[] = [];\n    for (const option of allOptions) {\n      const label = await option.textContent();\n      if (label != null) {\n        labels.push(label);\n      }\n    }\n    return labels;\n  }\n\n  async getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    const value = await elLocator.evaluate((element, prop) => {\n      return window.getComputedStyle(element).getPropertyValue(prop as string);\n    }, propertyName);\n    return value;\n  }\n\n  async enterText(locator: PartLocator, text: string, option?: Optional<Partial<EnterTextOption>>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    if (!option?.append) {\n      await this.page.locator(cssLocator).clear();\n    }\n\n    // If it is a date, time or datetime-local input, validate the date format\n    const type = (await this.getAttribute(locator, 'type')) ?? '';\n    if (dateUtil.isHtmlDateInputType(type)) {\n      const result = dateUtil.validateHtmlDateInput(type, text);\n      if (!result.valid) {\n        throw new Error(\n          `Invalid date format for type: ${type}, expected format: ${result.format}, example: ${result.example}`\n        );\n      }\n    }\n    await this.page.locator(cssLocator).fill(text);\n  }\n\n  async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).click({ position: option?.position });\n  }\n\n  async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).hover({ position: option?.position });\n  }\n\n  async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.move(0, 0);\n  }\n\n  async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.down();\n  }\n\n  async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await this.hover(locator, {\n      position: option?.position,\n    });\n    await this.page.mouse.up();\n  }\n\n  async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    return this.hover(locator, option);\n  }\n\n  async mouseOut(locator: PartLocator, _option?: Partial<MouseOutOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // First hover over the element to trigger mouseenter/mouseover\n    await this.page.locator(cssLocator).hover();\n    // Then dispatch mouseout event directly for cross-browser reliability\n    await this.page.locator(cssLocator).dispatchEvent('mouseout');\n  }\n\n  async mouseEnter(locator: PartLocator, _option?: Partial<MouseEnterOption>): Promise<void> {\n    return this.hover(locator);\n  }\n\n  async mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    // First hover over the element to trigger mouseenter/mouseover\n    await this.page.locator(cssLocator).hover();\n    // Dispatch mouseout which triggers both mouseout and mouseleave handlers in React\n    await this.page.locator(cssLocator).dispatchEvent('mouseout');\n  }\n\n  async focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.focus(cssLocator);\n  }\n\n  async blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(cssLocator).blur();\n  }\n\n  //#region wait conditions\n  wait(ms: number): Promise<void> {\n    return timingUtil.wait(ms);\n  }\n\n  async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption\n  ): Promise<void> {\n    return interactorUtil.interactorWaitUtil(locator, this, option);\n  }\n\n  waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    return timingUtil.waitUntil(option);\n  }\n  //#endregion\n\n  async getAttribute(locator: PartLocator, name: string, isMultiple: true): Promise<readonly string[]>;\n  async getAttribute(locator: PartLocator, name: string, isMultiple: false): Promise<Optional<string>>;\n  async getAttribute(locator: PartLocator, name: string): Promise<Optional<string>>;\n  async getAttribute(\n    locator: PartLocator,\n    name: string,\n    isMultiple?: boolean\n  ): Promise<Optional<string> | readonly string[]> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const elLocator = this.page.locator(cssLocator);\n    if (isMultiple) {\n      const locators = await elLocator.all();\n      const values: string[] = [];\n      for (const locator of locators) {\n        const value = await locator.getAttribute(name);\n        if (value != null) {\n          values.push(value);\n        }\n      }\n      return values;\n    }\n    const value = await elLocator.getAttribute(name);\n    return value ?? undefined;\n  }\n\n  async getText(locator: PartLocator): Promise<Optional<string>> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const text = await this.page.locator(cssLocator).textContent();\n    return text ?? undefined;\n  }\n\n  async exists(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const count = await this.page.locator(cssLocator).count();\n    return count > 0;\n  }\n\n  async isChecked(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const checked = await this.page.locator(cssLocator).isChecked();\n    return checked;\n  }\n\n  async isDisabled(locator: PartLocator): Promise<boolean> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    const isDisabled = await this.page.locator(cssLocator).isDisabled();\n    return isDisabled;\n  }\n\n  async isReadonly(locator: PartLocator): Promise<boolean> {\n    const readonly = await this.getAttribute(locator, 'readonly');\n    return readonly != null;\n  }\n\n  async isVisible(locator: PartLocator): Promise<boolean> {\n    const exists = await this.exists(locator);\n    if (!exists) {\n      return false;\n    }\n\n    async function checkCssVisibility(\n      prop: CssProperty,\n      invisibleValue: string,\n      interactor: PlaywrightInteractor\n    ): Promise<boolean> {\n      try {\n        const value = await interactor.getStyleValue(locator, prop);\n        return value !== invisibleValue;\n      } catch (e) {\n        // Element may disappear or detached while being checked because of animation\n        // when it happens, an error is thrown.  In this case, if indeed the element\n        // is not visible, we return false.  Otherwise, we re-throw the error.\n        if ((await interactor.exists(locator)) === false) {\n          return false;\n        }\n        throw e;\n      }\n    }\n\n    if ((await checkCssVisibility('opacity', '0', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('visibility', 'hidden', this)) === false) {\n      return false;\n    }\n\n    if ((await checkCssVisibility('display', 'none', this)) === false) {\n      return false;\n    }\n\n    return true;\n  }\n\n  async hasCssClass(locator: PartLocator, className: string): Promise<boolean> {\n    const classNames = await this.getAttribute(locator, 'class');\n    if (classNames == null) {\n      return false;\n    }\n\n    const names = classNames.split(/\\s+/);\n    return names.includes(className);\n  }\n\n  async hasAttribute(locator: PartLocator, name: string): Promise<boolean> {\n    const attrValue = await this.getAttribute(locator, name);\n    return attrValue != null;\n  }\n\n  //#region\n  async innerHTML(locator: PartLocator): Promise<string> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    return this.page.locator(cssLocator).innerHTML();\n  }\n  //#endregion\n\n  clone(): Interactor {\n    return new PlaywrightInteractor(this.page);\n  }\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport { Page } from '@playwright/test';\n\nimport { PlaywrightInteractor } from './PlaywrightInteractor';\n\n/**\n * Create a {@link TestEngine} instance backed by Playwright.\n *\n * @param page - Playwright page used for interaction.\n * @param partDefinitions - Scene part definitions describing the scene\n *   structure for the engine.\n * @returns A configured {@link TestEngine} ready for use.\n */\nexport function createTestEngine<T extends ScenePart>(page: Page, partDefinitions: T): TestEngine<T> {\n  const engine = new TestEngine([], new PlaywrightInteractor(page), {\n    parts: partDefinitions,\n  });\n\n  return engine;\n}\n","import { ScenePart, TestEngine } from '@atomic-testing/core';\nimport {\n  E2eTestInterface,\n  E2eTestRunEnvironmentFixture,\n  TestFrameworkMapper,\n} from '@atomic-testing/internal-test-runner';\nimport { expect, Page, test } from '@playwright/test';\n\nimport { createTestEngine } from './createTestEngine';\n\n/**\n * Navigate the current Playwright page to the provided URL.\n *\n * @param url - Destination URL to load.\n * @param fixture - Optional test fixture supplying the Playwright page.\n */\nexport async function goto(url: string): Promise<void>;\nexport async function goto(url: string, fixture: E2eTestRunEnvironmentFixture): Promise<void>;\nexport async function goto(url: string, fixture?: E2eTestRunEnvironmentFixture): Promise<void> {\n  const page = fixture!.page as Page;\n  await page.goto(url);\n}\n\n/**\n * Create a {@link TestEngine} bound to the Playwright page in the given fixture.\n *\n * @param scenePart - Scene definition to drive.\n * @param fixture - Fixture providing the Playwright page.\n */\nexport function playwrightGetTestEngine<T extends ScenePart>(\n  scenePart: T,\n  fixture: E2eTestRunEnvironmentFixture\n): TestEngine<T> {\n  const page = fixture.page as Page;\n  return createTestEngine(page, scenePart);\n}\n\n/**\n * Playwright adapter for the TestFrameworkMapper interface.\n */\nexport const playWrightTestFrameworkMapper: TestFrameworkMapper = {\n  /*\n   * INTENTIONAL @ts-expect-error comments: Playwright's test functions have different type\n   * signatures than the normalized TestFrameworkMapper interface. Playwright uses fixture-based\n   * callbacks with destructuring ({ page, browser }) while our interface uses a union type for\n   * Jest compatibility (done callback or fixture object). The functions are compatible at runtime\n   * but TypeScript cannot verify this due to these fundamental signature differences.\n   */\n\n  assertEqual: (a, b) => expect(a).toEqual(b),\n  assertNotEqual: (a, b) => expect(a).not.toEqual(b),\n  assertTrue: value => expect(value).toBe(true),\n  assertFalse: value => expect(value).toBe(false),\n  assertApproxEqual: (actual, expected, tolerance) =>\n    expect(Math.abs(actual - expected)).toBeLessThanOrEqual(tolerance),\n  // @ts-expect-error - Playwright describe signature differs from TestFrameworkMapper.Describe\n  describe: test.describe,\n\n  beforeEach: test.beforeEach,\n  afterEach: test.afterEach,\n  beforeAll: test.beforeAll,\n  afterAll: test.afterAll,\n\n  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test\n  test: test,\n\n  // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test\n  it: test,\n};\n\n/**\n * Get a typed interface for running end-to-end tests with Playwright.\n */\nexport function getTestRunnerInterface<T extends ScenePart>(): E2eTestInterface<T> {\n  return {\n    getTestEngine: playwrightGetTestEngine,\n    goto,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["locatorUtil","dateUtil","timingUtil","defaultWaitForOption","interactorUtil","ElementNotFoundError","TestEngine","test"],"sources":["../src/PlaywrightInteractor.ts","../src/createTestEngine.ts","../src/testRunnerAdapter.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   * 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   * 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. Following\n   * this layer's convention, no `ElementNotFoundError` is fabricated: a missing\n   * element surfaces through Playwright's own auto-wait timeout.\n   *\n   * @param locator - Locator of the `<input type=\"file\">` element\n   * @param files - One or more filesystem paths to upload\n   */\n  async setInputFiles(locator: PartLocator, files: string | string[]): Promise<void> {\n    const cssLocator = await locatorUtil.toCssSelector(locator, this);\n    await 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. Per this layer's convention, no\n   * `ElementNotFoundError` is fabricated: a missing element surfaces through\n   * Playwright's own auto-wait timeout.\n   *\n   * @param locator - Locator of the element to scroll into view\n   */\n  async scrollIntoView(locator: PartLocator): Promise<void> {\n    const css = await locatorUtil.toCssSelector(locator, this);\n    await 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. As with\n   * {@link scrollIntoView}, no `ElementNotFoundError` is fabricated; a missing\n   * element surfaces through Playwright's own auto-wait timeout.\n   *\n   * @param locator - Locator of the scrollable element\n   * @param delta - Pixel offset to scroll by\n   */\n  async scrollBy(locator: PartLocator, delta: Point): Promise<void> {\n    const css = await locatorUtil.toCssSelector(locator, this);\n    await this.page.locator(css).evaluate((el, d) => el.scrollBy(d.x, d.y), { x: delta.x, y: delta.y });\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. Per this layer's convention, no\n   * `ElementNotFoundError` is fabricated: a missing element surfaces through\n   * Playwright's own auto-wait timeout.\n   *\n   * @param source - Locator of the element to drag\n   * @param target - Locator of the drop target\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    await this.page.locator(srcCss).dragTo(this.page.locator(tgtCss));\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\n   * (detached/invisible) rather than auto-waiting — so this shares that\n   * \"element not found\" contract instead of re-deriving the box + 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    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  /**\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. Per this layer's convention, no\n   * `ElementNotFoundError` is fabricated: a missing element surfaces through\n   * Playwright's own auto-wait timeout.\n   *\n   * @param locator - Locator of the element to right-click\n   */\n  async contextMenu(locator: PartLocator): Promise<void> {\n    const css = await locatorUtil.toCssSelector(locator, this);\n    await 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.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    // 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.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.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 is one of the few Playwright methods that throws\n   * `ElementNotFoundError` — matching the house \"element not found\" contract\n   * (ADR 0001).\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","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  hasLayout: true,\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":";;;;;;;AAkCA,IAAa,uBAAb,MAAa,qBAA2C;;;;CAItD,YAAY,MAA4B;EAAZ,KAAA,OAAA;CAAa;;;;;;;CAQzC,MAAM,kBAAkB,SAAsB,QAAiC;EAC7E,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,aAAa,MAAM;CACzD;;;;;;;;;;;;;CAcA,MAAM,cAAc,SAAsB,OAAyC;EACjF,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,cAAc,KAAK;CACzD;;;;;;;;;;;CAYA,MAAM,eAAe,SAAqC;EACxD,MAAM,MAAM,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EACzD,MAAM,KAAK,KAAK,QAAQ,GAAG,CAAC,CAAC,uBAAuB;CACtD;;;;;;;;;;;;;;;;;CAkBA,MAAM,SAAS,SAAsB,OAA6B;EAChE,MAAM,MAAM,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EACzD,MAAM,KAAK,KAAK,QAAQ,GAAG,CAAC,CAAC,UAAU,IAAI,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG;GAAE,GAAG,MAAM;GAAG,GAAG,MAAM;EAAE,CAAC;CACpG;;;;;;;;;;;;CAaA,MAAM,OAAO,QAAqB,QAAoC;EACpE,MAAM,SAAS,MAAMA,qBAAAA,YAAY,cAAc,QAAQ,IAAI;EAC3D,MAAM,SAAS,MAAMA,qBAAAA,YAAY,cAAc,QAAQ,IAAI;EAC3D,MAAM,KAAK,KAAK,QAAQ,MAAM,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,MAAM,CAAC;CAClE;;;;;;;;;;;;;;;;;CAkBA,MAAM,KAAK,SAAsB,OAA6B;EAC5D,MAAM,OAAO,MAAM,KAAK,gBAAgB,OAAO;EAC/C,MAAM,KAAK,KAAK,IAAI,KAAK,QAAQ;EACjC,MAAM,KAAK,KAAK,IAAI,KAAK,SAAS;EAClC,MAAM,KAAK,KAAK,MAAM,KAAK,IAAI,EAAE;EACjC,MAAM,KAAK,KAAK,MAAM,KAAK;EAC3B,MAAM,KAAK,KAAK,MAAM,KAAK,KAAK,MAAM,GAAG,KAAK,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC;EACnE,MAAM,KAAK,KAAK,MAAM,GAAG;CAC3B;;;;;;;CAQA,MAAM,cAAc,SAAiD;EACnE,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,OAAO,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,WAAW;CAClD;;;;;;;CAQA,MAAM,gBAAgB,SAA4D;EAChF,MAAM,iBAAA,GAAA,qBAAA,cAAA,CAA2C,gBAAgB;EACjE,MAAM,wBAAwBA,qBAAAA,YAAY,OAAO,SAAS,aAAa;EACvE,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,uBAAuB,IAAI;EAC9E,MAAM,aAAa,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,IAAI;EAC3D,MAAM,SAAmB,CAAC;EAC1B,KAAK,MAAM,UAAU,YAAY;GAC/B,MAAM,QAAQ,MAAM,OAAO,aAAa,OAAO;GAC/C,IAAI,SAAS,MACX,OAAO,KAAK,KAAK;EAErB;EACA,OAAO;CACT;CAEA,MAAM,gBAAgB,SAA4D;EAChF,MAAM,iBAAA,GAAA,qBAAA,cAAA,CAA2C,gBAAgB;EACjE,MAAM,wBAAwBA,qBAAAA,YAAY,OAAO,SAAS,aAAa;EACvE,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,uBAAuB,IAAI;EAC9E,MAAM,aAAa,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,IAAI;EAC3D,MAAM,SAAmB,CAAC;EAC1B,KAAK,MAAM,UAAU,YAAY;GAC/B,MAAM,QAAQ,MAAM,OAAO,YAAY;GACvC,IAAI,SAAS,MACX,OAAO,KAAK,KAAK;EAErB;EACA,OAAO;CACT;CAEA,MAAM,cAAc,SAAsB,cAAsD;EAC9F,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAKhE,OAAO,MAJW,KAAK,KAAK,QAAQ,UACR,CAAC,CAAC,UAAU,SAAS,SAAS;GACxD,OAAO,OAAO,iBAAiB,OAAO,CAAC,CAAC,iBAAiB,IAAc;EACzE,GAAG,YAAY;CAEjB;CAEA,MAAM,UAAU,SAAsB,MAAc,QAA4D;EAC9G,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,IAAI,CAAC,QAAQ,QACX,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,MAAM;EAI5C,MAAM,OAAQ,MAAM,KAAK,aAAa,SAAS,MAAM,KAAM;EAC3D,IAAIC,qBAAAA,SAAS,oBAAoB,IAAI,GAAG;GACtC,MAAM,SAASA,qBAAAA,SAAS,sBAAsB,MAAM,IAAI;GACxD,IAAI,CAAC,OAAO,OACV,MAAM,IAAI,MACR,iCAAiC,KAAK,qBAAqB,OAAO,OAAO,aAAa,OAAO,SAC/F;EAEJ;EACA,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,KAAK,IAAI;CAC/C;CAEA,MAAM,MAAM,SAAsB,QAA8C;EAC9E,MAAM,aAAa,MAAMD,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,MAAM,EAAE,UAAU,QAAQ,SAAS,CAAC;CAC1E;;;;;;;;;;;CAYA,MAAM,YAAY,SAAqC;EACrD,MAAM,MAAM,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EACzD,MAAM,KAAK,KAAK,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,QAAQ,CAAC;CACxD;CAEA,MAAM,MAAM,SAAsB,QAA8C;EAC9E,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,MAAM,EAAE,UAAU,QAAQ,SAAS,CAAC;CAC1E;CAEA,MAAM,UAAU,SAAsB,QAAkD;EACtF,MAAM,KAAK,MAAM,SAAS,EACxB,UAAU,QAAQ,SACpB,CAAC;EACD,MAAM,KAAK,KAAK,MAAM,KAAK,GAAG,CAAC;CACjC;CAEA,MAAM,UAAU,SAAsB,QAAkD;EACtF,MAAM,KAAK,MAAM,SAAS,EACxB,UAAU,QAAQ,SACpB,CAAC;EACD,MAAM,KAAK,KAAK,MAAM,KAAK;CAC7B;CAEA,MAAM,QAAQ,SAAsB,QAAgD;EAClF,MAAM,KAAK,MAAM,SAAS,EACxB,UAAU,QAAQ,SACpB,CAAC;EACD,MAAM,KAAK,KAAK,MAAM,GAAG;CAC3B;CAEA,MAAM,UAAU,SAAsB,QAA8C;EAClF,OAAO,KAAK,MAAM,SAAS,MAAM;CACnC;CAEA,MAAM,SAAS,SAAsB,SAAkD;EACrF,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAEhE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,MAAM;EAE1C,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,cAAc,UAAU;CAC9D;CAEA,MAAM,WAAW,SAAsB,SAAoD;EACzF,OAAO,KAAK,MAAM,OAAO;CAC3B;CAEA,MAAM,WAAW,SAAsB,SAAoD;EACzF,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAEhE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,MAAM;EAE1C,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,cAAc,UAAU;CAC9D;CAEA,MAAM,MAAM,SAAsB,SAA+C;EAC/E,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,OAAO,KAAK,KAAK,MAAM,UAAU;CACnC;CAEA,MAAM,KAAK,SAAsB,SAA8C;EAC7E,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,KAAK;CAC3C;CAEA,MAAM,SAAS,SAAsB,KAAa,QAAiD;EACjG,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAIhE,MAAM,YAAsB,CAAC;EAC7B,IAAI,QAAQ,MACV,UAAU,KAAK,SAAS;EAE1B,IAAI,QAAQ,KACV,UAAU,KAAK,KAAK;EAEtB,IAAI,QAAQ,OACV,UAAU,KAAK,OAAO;EAExB,IAAI,QAAQ,MACV,UAAU,KAAK,MAAM;EAEvB,MAAM,QAAQ,UAAU,SAAS,IAAI,GAAG,UAAU,KAAK,GAAG,EAAE,GAAG,QAAQ;EAMvE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,MAAM,KAAK;CACjD;CAEA,MAAM,SAAS,SAAqC;EAClD,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAIhE,MAAM,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,cAAc,OAAO;CAC3D;CAGA,KAAK,IAA2B;EAC9B,OAAOE,qBAAAA,WAAW,KAAK,EAAE;CAC3B;CAEA,MAAM,wBACJ,SACA,SAA2CC,qBAAAA,sBAC5B;EACf,OAAOC,qBAAAA,eAAe,mBAAmB,SAAS,MAAM,MAAM;CAChE;CAEA,UAAa,QAAwC;EACnD,OAAOF,qBAAAA,WAAW,UAAU,MAAM;CACpC;CAMA,MAAM,aACJ,SACA,MACA,YAC+C;EAC/C,MAAM,aAAa,MAAMF,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,MAAM,YAAY,KAAK,KAAK,QAAQ,UAAU;EAC9C,IAAI,YAAY;GACd,MAAM,WAAW,MAAM,UAAU,IAAI;GACrC,MAAM,SAAmB,CAAC;GAC1B,KAAK,MAAM,WAAW,UAAU;IAC9B,MAAM,QAAQ,MAAM,QAAQ,aAAa,IAAI;IAC7C,IAAI,SAAS,MACX,OAAO,KAAK,KAAK;GAErB;GACA,OAAO;EACT;EAEA,OAAO,MADa,UAAU,aAAa,IAAI,KAC/B,KAAA;CAClB;CAEA,MAAM,QAAQ,SAAiD;EAC7D,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAEhE,OAAO,MADY,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,YAAY,KAC9C,KAAA;CACjB;;;;;;;;;;;;;CAcA,MAAM,gBAAgB,SAA6C;EACjE,MAAM,MAAM,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EACzD,MAAM,MAAM,MAAM,KAAK,KAAK,QAAQ,GAAG,CAAC,CAAC,YAAY;EACrD,IAAI,OAAO,MACT,MAAM,IAAIK,qBAAAA,qBAAqB,SAAS,iBAAiB;EAE3D,OAAO;GAAE,GAAG,IAAI;GAAG,GAAG,IAAI;GAAG,OAAO,IAAI;GAAO,QAAQ,IAAI;EAAO;CACpE;CAEA,MAAM,OAAO,SAAwC;EACnD,MAAM,aAAa,MAAML,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAEhE,OAAO,MADa,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,MAAM,IACzC;CACjB;CAEA,MAAM,UAAU,SAAwC;EACtD,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAEhE,OAAO,MADe,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,UAAU;CAEhE;CAEA,MAAM,WAAW,SAAwC;EACvD,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAEhE,OAAO,MADkB,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,WAAW;CAEpE;CAEA,MAAM,WAAW,SAAwC;EAEvD,OAAO,MADgB,KAAK,aAAa,SAAS,UAAU,KACzC;CACrB;CAEA,MAAM,UAAU,SAAwC;EAEtD,IAAI,CAAC,MADgB,KAAK,OAAO,OAAO,GAEtC,OAAO;EAGT,eAAe,mBACb,MACA,gBACA,YACkB;GAClB,IAAI;IAEF,OAAO,MADa,WAAW,cAAc,SAAS,IAAI,MACzC;GACnB,SAAS,GAAG;IAIV,IAAK,MAAM,WAAW,OAAO,OAAO,MAAO,OACzC,OAAO;IAET,MAAM;GACR;EACF;EAEA,IAAK,MAAM,mBAAmB,WAAW,KAAK,IAAI,MAAO,OACvD,OAAO;EAGT,IAAK,MAAM,mBAAmB,cAAc,UAAU,IAAI,MAAO,OAC/D,OAAO;EAGT,IAAK,MAAM,mBAAmB,WAAW,QAAQ,IAAI,MAAO,OAC1D,OAAO;EAGT,OAAO;CACT;CAEA,MAAM,YAAY,SAAsB,WAAqC;EAC3E,MAAM,aAAa,MAAM,KAAK,aAAa,SAAS,OAAO;EAC3D,IAAI,cAAc,MAChB,OAAO;EAIT,OADc,WAAW,MAAM,KACpB,CAAC,CAAC,SAAS,SAAS;CACjC;CAEA,MAAM,aAAa,SAAsB,MAAgC;EAEvE,OAAO,MADiB,KAAK,aAAa,SAAS,IAAI,KACnC;CACtB;CAGA,MAAM,UAAU,SAAuC;EACrD,MAAM,aAAa,MAAMA,qBAAAA,YAAY,cAAc,SAAS,IAAI;EAChE,OAAO,KAAK,KAAK,QAAQ,UAAU,CAAC,CAAC,UAAU;CACjD;CAGA,QAAoB;EAClB,OAAO,IAAI,qBAAqB,KAAK,IAAI;CAC3C;AACF;;;;;;;;;;;ACjeA,SAAgB,iBAAsC,MAAY,iBAAmC;CAKnG,OAAO,IAJYM,qBAAAA,WAAW,CAAC,GAAG,IAAI,qBAAqB,IAAI,GAAG,EAChE,OAAO,gBACT,CAEY;AACd;;;ACDA,eAAsB,KAAK,KAAa,SAAuD;CAE7F,MADa,QAAS,KACX,KAAK,GAAG;AACrB;;;;;;;AAQA,SAAgB,wBACd,WACA,SACe;CACf,MAAM,OAAO,QAAQ;CACrB,OAAO,iBAAiB,MAAM,SAAS;AACzC;;;;AAKA,MAAa,gCAAqD;CAShE,cAAc,GAAG,OAAA,GAAA,iBAAA,OAAA,CAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;CAC1C,iBAAiB,GAAG,OAAA,GAAA,iBAAA,OAAA,CAAa,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;CACjD,aAAY,WAAA,GAAA,iBAAA,OAAA,CAAgB,KAAK,CAAC,CAAC,KAAK,IAAI;CAC5C,cAAa,WAAA,GAAA,iBAAA,OAAA,CAAgB,KAAK,CAAC,CAAC,KAAK,KAAK;CAC9C,oBAAoB,QAAQ,UAAU,eAAA,GAAA,iBAAA,OAAA,CAC7B,KAAK,IAAI,SAAS,QAAQ,CAAC,CAAC,CAAC,oBAAoB,SAAS;CAEnE,UAAUC,iBAAAA,KAAK;CAEf,YAAYA,iBAAAA,KAAK;CACjB,WAAWA,iBAAAA,KAAK;CAChB,WAAWA,iBAAAA,KAAK;CAChB,UAAUA,iBAAAA,KAAK;CAGf,MAAMA,iBAAAA;CAGN,IAAIA,iBAAAA;CAEJ,WAAW;AACb;;;;AAKA,SAAgB,yBAAmE;CACjF,OAAO;EACL,eAAe;EACf;CACF;AACF"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { BlurOption, ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
+import { BlurOption, BoundingRect, ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, Point, PressKeyOption, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
 import { Page } from "@playwright/test";
 import { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from "@atomic-testing/internal-test-runner";
 
@@ -30,6 +30,76 @@ declare class PlaywrightInteractor implements Interactor {
    * @param values - Values to select.
    */
   selectOptionValue(locator: PartLocator, values: string[]): Promise<void>;
+  /**
+   * 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. Following
+   * this layer's convention, no `ElementNotFoundError` is fabricated: a missing
+   * element surfaces through Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the `<input type="file">` element
+   * @param files - One or more filesystem paths to upload
+   */
+  setInputFiles(locator: PartLocator, files: string | string[]): Promise<void>;
+  /**
+   * 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the element to scroll into view
+   */
+  scrollIntoView(locator: PartLocator): Promise<void>;
+  /**
+   * 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. As with
+   * {@link scrollIntoView}, no `ElementNotFoundError` is fabricated; a missing
+   * element surfaces through Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the scrollable element
+   * @param delta - Pixel offset to scroll by
+   */
+  scrollBy(locator: PartLocator, delta: Point): Promise<void>;
+  /**
+   * 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param source - Locator of the element to drag
+   * @param target - Locator of the drop target
+   */
+  dragTo(source: PartLocator, target: PartLocator): Promise<void>;
+  /**
+   * 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
+   * (detached/invisible) rather than auto-waiting — 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
+   */
+  drag(locator: PartLocator, delta: Point): Promise<void>;
   /**
    * Get the value of an `<input>` element.
    *
@@ -48,6 +118,17 @@ declare class PlaywrightInteractor implements Interactor {
   getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>>;
   enterText(locator: PartLocator, text: string, option?: Optional<Partial<EnterTextOption>>): Promise<void>;
   click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void>;
+  /**
+   * 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the element to right-click
+   */
+  contextMenu(locator: PartLocator): Promise<void>;
   hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void>;
   mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void>;
   mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void>;
@@ -58,6 +139,8 @@ declare class PlaywrightInteractor implements Interactor {
   mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void>;
   focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void>;
   blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void>;
+  pressKey(locator: PartLocator, key: string, option?: Partial<PressKeyOption>): Promise<void>;
+  activate(locator: PartLocator): Promise<void>;
   wait(ms: number): Promise<void>;
   waitUntilComponentState(locator: PartLocator, option?: Partial<Readonly<WaitForOption>>): Promise<void>;
   waitUntil<T>(option: WaitUntilOption<T>): Promise<T>;
@@ -65,6 +148,19 @@ declare class PlaywrightInteractor implements Interactor {
   getAttribute(locator: PartLocator, name: string, isMultiple: false): Promise<Optional<string>>;
   getAttribute(locator: PartLocator, name: string): Promise<Optional<string>>;
   getText(locator: PartLocator): Promise<Optional<string>>;
+  /**
+   * Get the located element's bounding rectangle.
+   *
+   * `boundingBox()` returns `null` for a detached/invisible element rather than
+   * auto-waiting, so this is one of the few Playwright methods that throws
+   * `ElementNotFoundError` — matching the house "element not found" contract
+   * (ADR 0001).
+   *
+   * @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
+   */
+  getBoundingRect(locator: PartLocator): Promise<BoundingRect>;
   exists(locator: PartLocator): Promise<boolean>;
   isChecked(locator: PartLocator): Promise<boolean>;
   isDisabled(locator: PartLocator): Promise<boolean>;

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BlurOption, ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
+import { BlurOption, BoundingRect, ClickOption, CssProperty, EnterTextOption, FocusOption, HoverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, Optional, PartLocator, Point, PressKeyOption, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
 import { Page } from "@playwright/test";
 import { E2eTestInterface, E2eTestRunEnvironmentFixture, TestFrameworkMapper } from "@atomic-testing/internal-test-runner";
 
@@ -30,6 +30,76 @@ declare class PlaywrightInteractor implements Interactor {
    * @param values - Values to select.
    */
   selectOptionValue(locator: PartLocator, values: string[]): Promise<void>;
+  /**
+   * 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. Following
+   * this layer's convention, no `ElementNotFoundError` is fabricated: a missing
+   * element surfaces through Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the `<input type="file">` element
+   * @param files - One or more filesystem paths to upload
+   */
+  setInputFiles(locator: PartLocator, files: string | string[]): Promise<void>;
+  /**
+   * 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the element to scroll into view
+   */
+  scrollIntoView(locator: PartLocator): Promise<void>;
+  /**
+   * 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. As with
+   * {@link scrollIntoView}, no `ElementNotFoundError` is fabricated; a missing
+   * element surfaces through Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the scrollable element
+   * @param delta - Pixel offset to scroll by
+   */
+  scrollBy(locator: PartLocator, delta: Point): Promise<void>;
+  /**
+   * 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param source - Locator of the element to drag
+   * @param target - Locator of the drop target
+   */
+  dragTo(source: PartLocator, target: PartLocator): Promise<void>;
+  /**
+   * 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
+   * (detached/invisible) rather than auto-waiting — 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
+   */
+  drag(locator: PartLocator, delta: Point): Promise<void>;
   /**
    * Get the value of an `<input>` element.
    *
@@ -48,6 +118,17 @@ declare class PlaywrightInteractor implements Interactor {
   getStyleValue(locator: PartLocator, propertyName: CssProperty): Promise<Optional<string>>;
   enterText(locator: PartLocator, text: string, option?: Optional<Partial<EnterTextOption>>): Promise<void>;
   click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void>;
+  /**
+   * 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the element to right-click
+   */
+  contextMenu(locator: PartLocator): Promise<void>;
   hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void>;
   mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void>;
   mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void>;
@@ -58,6 +139,8 @@ declare class PlaywrightInteractor implements Interactor {
   mouseLeave(locator: PartLocator, _option?: Partial<MouseLeaveOption>): Promise<void>;
   focus(locator: PartLocator, _option?: Partial<FocusOption>): Promise<void>;
   blur(locator: PartLocator, _option?: Partial<BlurOption>): Promise<void>;
+  pressKey(locator: PartLocator, key: string, option?: Partial<PressKeyOption>): Promise<void>;
+  activate(locator: PartLocator): Promise<void>;
   wait(ms: number): Promise<void>;
   waitUntilComponentState(locator: PartLocator, option?: Partial<Readonly<WaitForOption>>): Promise<void>;
   waitUntil<T>(option: WaitUntilOption<T>): Promise<T>;
@@ -65,6 +148,19 @@ declare class PlaywrightInteractor implements Interactor {
   getAttribute(locator: PartLocator, name: string, isMultiple: false): Promise<Optional<string>>;
   getAttribute(locator: PartLocator, name: string): Promise<Optional<string>>;
   getText(locator: PartLocator): Promise<Optional<string>>;
+  /**
+   * Get the located element's bounding rectangle.
+   *
+   * `boundingBox()` returns `null` for a detached/invisible element rather than
+   * auto-waiting, so this is one of the few Playwright methods that throws
+   * `ElementNotFoundError` — matching the house "element not found" contract
+   * (ADR 0001).
+   *
+   * @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
+   */
+  getBoundingRect(locator: PartLocator): Promise<BoundingRect>;
   exists(locator: PartLocator): Promise<boolean>;
   isChecked(locator: PartLocator): Promise<boolean>;
   isDisabled(locator: PartLocator): Promise<boolean>;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { TestEngine, byCssSelector, dateUtil, defaultWaitForOption, interactorUtil, locatorUtil, timingUtil } from "@atomic-testing/core";
+import { ElementNotFoundError, TestEngine, byCssSelector, dateUtil, defaultWaitForOption, interactorUtil, locatorUtil, timingUtil } from "@atomic-testing/core";
 import { expect, test } from "@playwright/test";
 //#region src/PlaywrightInteractor.ts
 /**
@@ -22,6 +22,100 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		await 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. Following
+	* this layer's convention, no `ElementNotFoundError` is fabricated: a missing
+	* element surfaces through Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the `<input type="file">` element
+	* @param files - One or more filesystem paths to upload
+	*/
+	async setInputFiles(locator, files) {
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		await 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. Per this layer's convention, no
+	* `ElementNotFoundError` is fabricated: a missing element surfaces through
+	* Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the element to scroll into view
+	*/
+	async scrollIntoView(locator) {
+		const css = await locatorUtil.toCssSelector(locator, this);
+		await 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. As with
+	* {@link scrollIntoView}, no `ElementNotFoundError` is fabricated; a missing
+	* element surfaces through Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the scrollable element
+	* @param delta - Pixel offset to scroll by
+	*/
+	async scrollBy(locator, delta) {
+		const css = await locatorUtil.toCssSelector(locator, this);
+		await 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. Per this layer's convention, no
+	* `ElementNotFoundError` is fabricated: a missing element surfaces through
+	* Playwright's own auto-wait timeout.
+	*
+	* @param source - Locator of the element to drag
+	* @param target - Locator of the drop target
+	*/
+	async dragTo(source, target) {
+		const srcCss = await locatorUtil.toCssSelector(source, this);
+		const tgtCss = await locatorUtil.toCssSelector(target, this);
+		await this.page.locator(srcCss).dragTo(this.page.locator(tgtCss));
+	}
+	/**
+	* 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
+	* (detached/invisible) rather than auto-waiting — 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.
 	*
 	* @param locator - Locator pointing to the input element.
@@ -81,6 +175,20 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
 		await 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. Per this layer's convention, no
+	* `ElementNotFoundError` is fabricated: a missing element surfaces through
+	* Playwright's own auto-wait timeout.
+	*
+	* @param locator - Locator of the element to right-click
+	*/
+	async contextMenu(locator) {
+		const css = await locatorUtil.toCssSelector(locator, this);
+		await 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 });
@@ -121,6 +229,20 @@ var PlaywrightInteractor = class PlaywrightInteractor {
 		const cssLocator = await locatorUtil.toCssSelector(locator, this);
 		await this.page.locator(cssLocator).blur();
 	}
+	async pressKey(locator, key, option) {
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		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.page.locator(cssLocator).press(chord);
+	}
+	async activate(locator) {
+		const cssLocator = await locatorUtil.toCssSelector(locator, this);
+		await this.page.locator(cssLocator).dispatchEvent("click");
+	}
 	wait(ms) {
 		return timingUtil.wait(ms);
 	}
@@ -148,6 +270,29 @@ 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 is one of the few Playwright methods that throws
+	* `ElementNotFoundError` — matching the house "element not found" contract
+	* (ADR 0001).
+	*
+	* @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;
@@ -237,7 +382,8 @@ const playWrightTestFrameworkMapper = {
 	beforeAll: test.beforeAll,
 	afterAll: test.afterAll,
 	test,
-	it: test
+	it: test,
+	hasLayout: true
 };
 /**
 * Get a typed interface for running end-to-end tests with Playwright.

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

package/src/PlaywrightInteractor.ts

@@ -1,10 +1,12 @@
 import {
   BlurOption,
+  BoundingRect,
   byCssSelector,
   ClickOption,
   CssProperty,
   dateUtil,
   defaultWaitForOption,
+  ElementNotFoundError,
   EnterTextOption,
   FocusOption,
   HoverOption,
@@ -19,6 +21,8 @@ import {
   MouseUpOption,
   Optional,
   PartLocator,
+  Point,
+  PressKeyOption,
   timingUtil,
   WaitForOption,
   WaitUntilOption,
@@ -45,6 +49,102 @@ export class PlaywrightInteractor implements Interactor {
     await 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. Following
+   * this layer's convention, no `ElementNotFoundError` is fabricated: a missing
+   * element surfaces through Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the `<input type="file">` element
+   * @param files - One or more filesystem paths to upload
+   */
+  async setInputFiles(locator: PartLocator, files: string | string[]): Promise<void> {
+    const cssLocator = await locatorUtil.toCssSelector(locator, this);
+    await 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the element to scroll into view
+   */
+  async scrollIntoView(locator: PartLocator): Promise<void> {
+    const css = await locatorUtil.toCssSelector(locator, this);
+    await 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. As with
+   * {@link scrollIntoView}, no `ElementNotFoundError` is fabricated; a missing
+   * element surfaces through Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the scrollable element
+   * @param delta - Pixel offset to scroll by
+   */
+  async scrollBy(locator: PartLocator, delta: Point): Promise<void> {
+    const css = await locatorUtil.toCssSelector(locator, this);
+    await 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param source - Locator of the element to drag
+   * @param target - Locator of the drop target
+   */
+  async dragTo(source: PartLocator, target: PartLocator): Promise<void> {
+    const srcCss = await locatorUtil.toCssSelector(source, this);
+    const tgtCss = await locatorUtil.toCssSelector(target, this);
+    await this.page.locator(srcCss).dragTo(this.page.locator(tgtCss));
+  }
+
+  /**
+   * 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
+   * (detached/invisible) rather than auto-waiting — 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: PartLocator, delta: Point): Promise<void> {
+    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.
    *
@@ -125,6 +225,21 @@ export class PlaywrightInteractor implements Interactor {
     await 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. Per this layer's convention, no
+   * `ElementNotFoundError` is fabricated: a missing element surfaces through
+   * Playwright's own auto-wait timeout.
+   *
+   * @param locator - Locator of the element to right-click
+   */
+  async contextMenu(locator: PartLocator): Promise<void> {
+    const css = await locatorUtil.toCssSelector(locator, this);
+    await this.page.locator(css).click({ button: 'right' });
+  }
+
   async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {
     const cssLocator = await locatorUtil.toCssSelector(locator, this);
     await this.page.locator(cssLocator).hover({ position: option?.position });
@@ -185,6 +300,41 @@ export class PlaywrightInteractor implements Interactor {
     await this.page.locator(cssLocator).blur();
   }
 
+  async pressKey(locator: PartLocator, key: string, option?: Partial<PressKeyOption>): Promise<void> {
+    const cssLocator = await locatorUtil.toCssSelector(locator, this);
+    // Compose Playwright's chord syntax — modifiers joined to the key by `+`, in
+    // Playwright's accepted Control+Alt+Shift+Meta order — so the browser holds
+    // those modifiers across the keypress and the event carries ctrlKey/etc.
+    const modifiers: string[] = [];
+    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;
+    // locator.press auto-focuses the element, then dispatches a real, trusted
+    // KeyboardEvent — the browser equivalent of the DOM focus-first keyDown/keyUp.
+    // Caveat: for Shift + a printable key the browser case-folds `event.key`
+    // (`Shift+a` → `'A'`) whereas the jsdom path keeps `'a'` — only the modifier
+    // flags are delivered identically across engines (see #924).
+    await this.page.locator(cssLocator).press(chord);
+  }
+
+  async activate(locator: PartLocator): Promise<void> {
+    const cssLocator = await locatorUtil.toCssSelector(locator, this);
+    // Geometry-free activation mirrors the mouseout dispatch precedent above: it
+    // bypasses hit-testing to actuate a covered or zero-size input that
+    // locator.click() (a real geometry hit-test) cannot reach.
+    await this.page.locator(cssLocator).dispatchEvent('click');
+  }
+
   //#region wait conditions
   wait(ms: number): Promise<void> {
     return timingUtil.wait(ms);
@@ -233,6 +383,27 @@ export class PlaywrightInteractor implements Interactor {
     return text ?? undefined;
   }
 
+  /**
+   * Get the located element's bounding rectangle.
+   *
+   * `boundingBox()` returns `null` for a detached/invisible element rather than
+   * auto-waiting, so this is one of the few Playwright methods that throws
+   * `ElementNotFoundError` — matching the house "element not found" contract
+   * (ADR 0001).
+   *
+   * @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: PartLocator): Promise<BoundingRect> {
+    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: PartLocator): Promise<boolean> {
     const cssLocator = await locatorUtil.toCssSelector(locator, this);
     const count = await this.page.locator(cssLocator).count();

package/src/testRunnerAdapter.ts

@@ -66,6 +66,8 @@ export const playWrightTestFrameworkMapper: TestFrameworkMapper = {
 
   // @ts-expect-error - Playwright test signature differs from TestFrameworkMapper.Test
   it: test,
+
+  hasLayout: true,
 };
 
 /**