@atomic-testing/react-legacy 0.88.0 → 0.89.0

package/README.md

@@ -89,3 +89,10 @@ package for a dedicated example.
 
 For more in‑depth information, visit
 [https://atomic-testing.dev](https://atomic-testing.dev).
+
+## Public API & stability
+
+The stable surface of this package is its `.` barrel exports, frozen under
+SemVer and machine-checked by the committed [API Extractor](https://api-extractor.com/)
+report at [`etc/react-legacy.api.md`](etc/react-legacy.api.md). Exports tagged `@internal` are
+not part of that guarantee. See the [1.0 API freeze & evolution policy](../../agent-docs/adr/006-1.0-api-freeze-and-evolution.md).

package/dist/index.cjs

@@ -22,10 +22,156 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let _atomic_testing_core = require("@atomic-testing/core");
-let _atomic_testing_react_core = require("@atomic-testing/react-core");
 let react_dom = require("react-dom");
 react_dom = __toESM(react_dom);
 let react_dom_test_utils_js = require("react-dom/test-utils.js");
+let _atomic_testing_dom_core = require("@atomic-testing/dom-core");
+//#region src/LegacyReactInteractor.ts
+/**
+* React 16/17 counterpart of `@atomic-testing/react-core`'s `ReactInteractor`.
+*
+* It is a deliberate parallel implementation rather than a subclass of the
+* react-core interactor: react-core wraps actions with `act` from
+* `@testing-library/react@16`, whose peer range is React 18/19. Reusing it would
+* drag that dependency into react-legacy and make the package impossible to
+* install on React 16/17 (the very versions this adapter exists to support). By
+* extending `DOMInteractor` directly and wrapping with `act` from
+* `react-dom/test-utils` (the React ≤17 act), react-legacy stays on a coherent
+* React-16/17 dependency graph.
+*/
+var LegacyReactInteractor = class LegacyReactInteractor extends _atomic_testing_dom_core.DOMInteractor {
+	async enterText(locator, text, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.enterText(locator, text, option);
+		});
+	}
+	async setRangeValue(locator, value) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.setRangeValue(locator, value);
+		});
+	}
+	async click(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.click(locator, option);
+		});
+	}
+	async hover(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.hover(locator, option);
+		});
+	}
+	async mouseMove(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.mouseMove(locator, option);
+		});
+	}
+	async mouseDown(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.mouseDown(locator, option);
+		});
+	}
+	async mouseUp(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.mouseUp(locator, option);
+		});
+	}
+	async mouseOver(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.mouseOver(locator, option);
+		});
+	}
+	async mouseOut(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.mouseOut(locator, option);
+		});
+	}
+	async mouseEnter(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.mouseEnter(locator, option);
+		});
+	}
+	async mouseLeave(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.mouseLeave(locator, option);
+		});
+	}
+	async focus(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.focus(locator, option);
+		});
+	}
+	async blur(locator, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.blur(locator, option);
+		});
+	}
+	async pressKey(locator, key, option) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.pressKey(locator, key, option);
+		});
+	}
+	async contextMenu(locator) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.contextMenu(locator);
+		});
+	}
+	async activate(locator) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.activate(locator);
+		});
+	}
+	async selectOptionValue(locator, values) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.selectOptionValue(locator, values);
+		});
+	}
+	async setInputFiles(locator, files) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.setInputFiles(locator, files);
+		});
+	}
+	async scrollIntoView(locator) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.scrollIntoView(locator);
+		});
+	}
+	async scrollBy(locator, delta) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.scrollBy(locator, delta);
+		});
+	}
+	async dragTo(source, target) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.dragTo(source, target);
+		});
+	}
+	async drag(locator, delta) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.drag(locator, delta);
+		});
+	}
+	async wait(ms) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.wait(ms);
+		});
+	}
+	async waitUntilComponentState(locator, option = _atomic_testing_core.defaultWaitForOption) {
+		await (0, react_dom_test_utils_js.act)(async () => {
+			await super.waitUntilComponentState(locator, option);
+		});
+	}
+	async waitUntil(option) {
+		let result;
+		await (0, react_dom_test_utils_js.act)(async () => {
+			result = await super.waitUntil(option);
+		});
+		return result;
+	}
+	clone() {
+		return new LegacyReactInteractor(this.rootEl);
+	}
+};
+//#endregion
 //#region src/createTestEngine.ts
 let _rootId = 0;
 function getNextRootElementId() {
@@ -54,7 +200,7 @@ function createTestEngine(node, partDefinitions, option) {
 		rootEl.removeChild(container);
 		return Promise.resolve();
 	};
-	return new _atomic_testing_core.TestEngine((0, _atomic_testing_core.byAttribute)(rootElementAttributeName, rootId), new _atomic_testing_react_core.ReactInteractor(), { parts: partDefinitions }, cleanup);
+	return new _atomic_testing_core.TestEngine((0, _atomic_testing_core.byAttribute)(rootElementAttributeName, rootId), new LegacyReactInteractor(), { parts: partDefinitions }, cleanup);
 }
 /**
 * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19
@@ -72,7 +218,7 @@ function createRenderedTestEngine(rootElement, partDefinitions, _option) {
 		rootElement.removeAttribute(rootElementAttributeName);
 		return Promise.resolve();
 	};
-	return new _atomic_testing_core.TestEngine((0, _atomic_testing_core.byAttribute)(rootElementAttributeName, rootId), new _atomic_testing_react_core.ReactInteractor(), { parts: partDefinitions }, cleanup);
+	return new _atomic_testing_core.TestEngine((0, _atomic_testing_core.byAttribute)(rootElementAttributeName, rootId), new LegacyReactInteractor(), { parts: partDefinitions }, cleanup);
 }
 //#endregion
 exports.createRenderedTestEngine = createRenderedTestEngine;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["TestEngine","ReactInteractor"],"sources":["../src/createTestEngine.ts"],"sourcesContent":["import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';\nimport { ReactInteractor } from '@atomic-testing/react-core';\nimport { ReactElement } from 'react';\nimport ReactDOM from 'react-dom';\nimport { act } from 'react-dom/test-utils';\n\nimport { IReactTestEngineOption } from './types';\n\nlet _rootId = 0;\nfunction getNextRootElementId() {\n  return `${_rootId++}`;\n}\n\nconst rootElementAttributeName = 'data-atomic-testing-react-legacy';\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes a react node and render it into a container element.  For rendered\n * components, use createRenderedLegacyTestEngine\n * @param node The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createTestEngine<T extends ScenePart>(\n  node: ReactElement,\n  partDefinitions: T,\n  option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootEl = option?.rootElement ?? document.body;\n  const container = rootEl.appendChild(document.createElement('div'));\n  const rootId = getNextRootElementId();\n  container.setAttribute(rootElementAttributeName, rootId);\n\n  act(() => {\n    ReactDOM.render(node, container);\n  });\n  const cleanup = () => {\n    ReactDOM.unmountComponentAtNode(container);\n    rootEl.removeChild(container);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new ReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes an html element purportedly rendered by React and create a test engine for it, it\n * can be useful in environment such as Storybook where Storybook renders the component and the test\n * @param rootElement The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createRenderedTestEngine<T extends ScenePart>(\n  rootElement: HTMLElement,\n  partDefinitions: T,\n  _option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootId = getNextRootElementId();\n  rootElement.setAttribute(rootElementAttributeName, rootId);\n\n  const cleanup = () => {\n    rootElement.removeAttribute(rootElementAttributeName);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new ReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,IAAI,UAAU;AACd,SAAS,uBAAuB;CAC9B,OAAO,GAAG;AACZ;AAEA,MAAM,2BAA2B;;;;;;;;;;AAWjC,SAAgB,iBACd,MACA,iBACA,QACe;CACf,MAAM,SAAS,QAAQ,eAAe,SAAS;CAC/C,MAAM,YAAY,OAAO,YAAY,SAAS,cAAc,KAAK,CAAC;CAClE,MAAM,SAAS,qBAAqB;CACpC,UAAU,aAAa,0BAA0B,MAAM;CAEvD,CAAA,GAAA,wBAAA,IAAA,OAAU;EACR,UAAA,QAAS,OAAO,MAAM,SAAS;CACjC,CAAC;CACD,MAAM,gBAAgB;EACpB,UAAA,QAAS,uBAAuB,SAAS;EACzC,OAAO,YAAY,SAAS;EAC5B,OAAO,QAAQ,QAAQ;CACzB;CAWA,OAAO,IATYA,qBAAAA,YAAAA,GAAAA,qBAAAA,YAAAA,CACL,0BAA0B,MAAM,GAC5C,IAAIC,2BAAAA,gBAAgB,GACpB,EACE,OAAO,gBACT,GACA,OAGU;AACd;;;;;;;;;;AAWA,SAAgB,yBACd,aACA,iBACA,SACe;CACf,MAAM,SAAS,qBAAqB;CACpC,YAAY,aAAa,0BAA0B,MAAM;CAEzD,MAAM,gBAAgB;EACpB,YAAY,gBAAgB,wBAAwB;EACpD,OAAO,QAAQ,QAAQ;CACzB;CAWA,OAAO,IATYD,qBAAAA,YAAAA,GAAAA,qBAAAA,YAAAA,CACL,0BAA0B,MAAM,GAC5C,IAAIC,2BAAAA,gBAAgB,GACpB,EACE,OAAO,gBACT,GACA,OAGU;AACd"}
+{"version":3,"file":"index.cjs","names":["DOMInteractor","defaultWaitForOption","TestEngine"],"sources":["../src/LegacyReactInteractor.ts","../src/createTestEngine.ts"],"sourcesContent":["import {\n  BlurOption,\n  ClickOption,\n  defaultWaitForOption,\n  EnterTextOption,\n  FocusOption,\n  HoverOption,\n  Interactor,\n  MouseDownOption,\n  MouseEnterOption,\n  MouseLeaveOption,\n  MouseMoveOption,\n  MouseOutOption,\n  MouseUpOption,\n  PartLocator,\n  Point,\n  PressKeyOption,\n  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { DOMInteractor } from '@atomic-testing/dom-core';\nimport { act } from 'react-dom/test-utils';\n\n/**\n * React 16/17 counterpart of `@atomic-testing/react-core`'s `ReactInteractor`.\n *\n * It is a deliberate parallel implementation rather than a subclass of the\n * react-core interactor: react-core wraps actions with `act` from\n * `@testing-library/react@16`, whose peer range is React 18/19. Reusing it would\n * drag that dependency into react-legacy and make the package impossible to\n * install on React 16/17 (the very versions this adapter exists to support). By\n * extending `DOMInteractor` directly and wrapping with `act` from\n * `react-dom/test-utils` (the React ≤17 act), react-legacy stays on a coherent\n * React-16/17 dependency graph.\n */\nexport class LegacyReactInteractor extends DOMInteractor {\n  override async enterText(locator: PartLocator, text: string, option?: Partial<EnterTextOption>): Promise<void> {\n    await act(async () => {\n      await super.enterText(locator, text, option);\n    });\n  }\n\n  override async setRangeValue(locator: PartLocator, value: number): Promise<void> {\n    await act(async () => {\n      await super.setRangeValue(locator, value);\n    });\n  }\n\n  override async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    await act(async () => {\n      await super.click(locator, option);\n    });\n  }\n\n  override async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    await act(async () => {\n      await super.hover(locator, option);\n    });\n  }\n\n  override async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseMove(locator, option);\n    });\n  }\n\n  override async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseDown(locator, option);\n    });\n  }\n\n  override async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseUp(locator, option);\n    });\n  }\n\n  override async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseOver(locator, option);\n    });\n  }\n\n  override async mouseOut(locator: PartLocator, option?: Partial<MouseOutOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseOut(locator, option);\n    });\n  }\n\n  override async mouseEnter(locator: PartLocator, option?: Partial<MouseEnterOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseEnter(locator, option);\n    });\n  }\n\n  override async mouseLeave(locator: PartLocator, option?: Partial<MouseLeaveOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseLeave(locator, option);\n    });\n  }\n\n  override async focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void> {\n    await act(async () => {\n      await super.focus(locator, option);\n    });\n  }\n\n  override async blur(locator: PartLocator, option?: Partial<BlurOption>): Promise<void> {\n    await act(async () => {\n      await super.blur(locator, option);\n    });\n  }\n\n  override async pressKey(locator: PartLocator, key: string, option?: Partial<PressKeyOption>): Promise<void> {\n    await act(async () => {\n      await super.pressKey(locator, key, option);\n    });\n  }\n\n  override async contextMenu(locator: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.contextMenu(locator);\n    });\n  }\n\n  override async activate(locator: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.activate(locator);\n    });\n  }\n\n  override async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    await act(async () => {\n      await super.selectOptionValue(locator, values);\n    });\n  }\n\n  override async setInputFiles(locator: PartLocator, files: string | string[]): Promise<void> {\n    await act(async () => {\n      await super.setInputFiles(locator, files);\n    });\n  }\n\n  override async scrollIntoView(locator: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.scrollIntoView(locator);\n    });\n  }\n\n  override async scrollBy(locator: PartLocator, delta: Point): Promise<void> {\n    await act(async () => {\n      await super.scrollBy(locator, delta);\n    });\n  }\n\n  override async dragTo(source: PartLocator, target: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.dragTo(source, target);\n    });\n  }\n\n  override async drag(locator: PartLocator, delta: Point): Promise<void> {\n    await act(async () => {\n      await super.drag(locator, delta);\n    });\n  }\n\n  //#region wait condition\n  override async wait(ms: number): Promise<void> {\n    await act(async () => {\n      await super.wait(ms);\n    });\n  }\n\n  override async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption\n  ): Promise<void> {\n    await act(async () => {\n      await super.waitUntilComponentState(locator, option);\n    });\n  }\n\n  override async waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    // The React ≤17 `act` async overload resolves to `undefined`, not the\n    // callback's value (unlike React 18's act), so capture the result via a\n    // closure instead of returning it through `act`.\n    let result!: T;\n    await act(async () => {\n      result = await super.waitUntil(option);\n    });\n    return result;\n  }\n  //#endregion\n\n  override clone(): Interactor {\n    return new LegacyReactInteractor(this.rootEl);\n  }\n}\n","import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';\nimport { ReactElement } from 'react';\nimport ReactDOM from 'react-dom';\nimport { act } from 'react-dom/test-utils';\n\nimport { LegacyReactInteractor } from './LegacyReactInteractor';\nimport { IReactTestEngineOption } from './types';\n\nlet _rootId = 0;\nfunction getNextRootElementId() {\n  return `${_rootId++}`;\n}\n\nconst rootElementAttributeName = 'data-atomic-testing-react-legacy';\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes a react node and render it into a container element.  For rendered\n * components, use createRenderedLegacyTestEngine\n * @param node The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createTestEngine<T extends ScenePart>(\n  node: ReactElement,\n  partDefinitions: T,\n  option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootEl = option?.rootElement ?? document.body;\n  const container = rootEl.appendChild(document.createElement('div'));\n  const rootId = getNextRootElementId();\n  container.setAttribute(rootElementAttributeName, rootId);\n\n  act(() => {\n    ReactDOM.render(node, container);\n  });\n  const cleanup = () => {\n    ReactDOM.unmountComponentAtNode(container);\n    rootEl.removeChild(container);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new LegacyReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes an html element purportedly rendered by React and create a test engine for it, it\n * can be useful in environment such as Storybook where Storybook renders the component and the test\n * @param rootElement The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createRenderedTestEngine<T extends ScenePart>(\n  rootElement: HTMLElement,\n  partDefinitions: T,\n  _option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootId = getNextRootElementId();\n  rootElement.setAttribute(rootElementAttributeName, rootId);\n\n  const cleanup = () => {\n    rootElement.removeAttribute(rootElementAttributeName);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new LegacyReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,IAAa,wBAAb,MAAa,8BAA8BA,yBAAAA,cAAc;CACvD,MAAe,UAAU,SAAsB,MAAc,QAAkD;EAC7G,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,UAAU,SAAS,MAAM,MAAM;EAC7C,CAAC;CACH;CAEA,MAAe,cAAc,SAAsB,OAA8B;EAC/E,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,cAAc,SAAS,KAAK;EAC1C,CAAC;CACH;CAEA,MAAe,MAAM,SAAsB,QAA8C;EACvF,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,MAAM,SAAS,MAAM;EACnC,CAAC;CACH;CAEA,MAAe,MAAM,SAAsB,QAA8C;EACvF,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,MAAM,SAAS,MAAM;EACnC,CAAC;CACH;CAEA,MAAe,UAAU,SAAsB,QAAkD;EAC/F,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,UAAU,SAAS,MAAM;EACvC,CAAC;CACH;CAEA,MAAe,UAAU,SAAsB,QAAkD;EAC/F,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,UAAU,SAAS,MAAM;EACvC,CAAC;CACH;CAEA,MAAe,QAAQ,SAAsB,QAAgD;EAC3F,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,QAAQ,SAAS,MAAM;EACrC,CAAC;CACH;CAEA,MAAe,UAAU,SAAsB,QAA8C;EAC3F,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,UAAU,SAAS,MAAM;EACvC,CAAC;CACH;CAEA,MAAe,SAAS,SAAsB,QAAiD;EAC7F,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,SAAS,SAAS,MAAM;EACtC,CAAC;CACH;CAEA,MAAe,WAAW,SAAsB,QAAmD;EACjG,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,WAAW,SAAS,MAAM;EACxC,CAAC;CACH;CAEA,MAAe,WAAW,SAAsB,QAAmD;EACjG,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,WAAW,SAAS,MAAM;EACxC,CAAC;CACH;CAEA,MAAe,MAAM,SAAsB,QAA8C;EACvF,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,MAAM,SAAS,MAAM;EACnC,CAAC;CACH;CAEA,MAAe,KAAK,SAAsB,QAA6C;EACrF,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,KAAK,SAAS,MAAM;EAClC,CAAC;CACH;CAEA,MAAe,SAAS,SAAsB,KAAa,QAAiD;EAC1G,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,SAAS,SAAS,KAAK,MAAM;EAC3C,CAAC;CACH;CAEA,MAAe,YAAY,SAAqC;EAC9D,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,YAAY,OAAO;EACjC,CAAC;CACH;CAEA,MAAe,SAAS,SAAqC;EAC3D,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,SAAS,OAAO;EAC9B,CAAC;CACH;CAEA,MAAe,kBAAkB,SAAsB,QAAiC;EACtF,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,kBAAkB,SAAS,MAAM;EAC/C,CAAC;CACH;CAEA,MAAe,cAAc,SAAsB,OAAyC;EAC1F,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,cAAc,SAAS,KAAK;EAC1C,CAAC;CACH;CAEA,MAAe,eAAe,SAAqC;EACjE,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,eAAe,OAAO;EACpC,CAAC;CACH;CAEA,MAAe,SAAS,SAAsB,OAA6B;EACzE,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,SAAS,SAAS,KAAK;EACrC,CAAC;CACH;CAEA,MAAe,OAAO,QAAqB,QAAoC;EAC7E,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,OAAO,QAAQ,MAAM;EACnC,CAAC;CACH;CAEA,MAAe,KAAK,SAAsB,OAA6B;EACrE,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,KAAK,SAAS,KAAK;EACjC,CAAC;CACH;CAGA,MAAe,KAAK,IAA2B;EAC7C,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,KAAK,EAAE;EACrB,CAAC;CACH;CAEA,MAAe,wBACb,SACA,SAA2CC,qBAAAA,sBAC5B;EACf,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,MAAM,MAAM,wBAAwB,SAAS,MAAM;EACrD,CAAC;CACH;CAEA,MAAe,UAAa,QAAwC;EAIlE,IAAI;EACJ,OAAA,GAAA,wBAAA,IAAA,CAAU,YAAY;GACpB,SAAS,MAAM,MAAM,UAAU,MAAM;EACvC,CAAC;EACD,OAAO;CACT;CAGA,QAA6B;EAC3B,OAAO,IAAI,sBAAsB,KAAK,MAAM;CAC9C;AACF;;;AC/LA,IAAI,UAAU;AACd,SAAS,uBAAuB;CAC9B,OAAO,GAAG;AACZ;AAEA,MAAM,2BAA2B;;;;;;;;;;AAWjC,SAAgB,iBACd,MACA,iBACA,QACe;CACf,MAAM,SAAS,QAAQ,eAAe,SAAS;CAC/C,MAAM,YAAY,OAAO,YAAY,SAAS,cAAc,KAAK,CAAC;CAClE,MAAM,SAAS,qBAAqB;CACpC,UAAU,aAAa,0BAA0B,MAAM;CAEvD,CAAA,GAAA,wBAAA,IAAA,OAAU;EACR,UAAA,QAAS,OAAO,MAAM,SAAS;CACjC,CAAC;CACD,MAAM,gBAAgB;EACpB,UAAA,QAAS,uBAAuB,SAAS;EACzC,OAAO,YAAY,SAAS;EAC5B,OAAO,QAAQ,QAAQ;CACzB;CAWA,OAAO,IATYC,qBAAAA,YAAAA,GAAAA,qBAAAA,YAAAA,CACL,0BAA0B,MAAM,GAC5C,IAAI,sBAAsB,GAC1B,EACE,OAAO,gBACT,GACA,OAGU;AACd;;;;;;;;;;AAWA,SAAgB,yBACd,aACA,iBACA,SACe;CACf,MAAM,SAAS,qBAAqB;CACpC,YAAY,aAAa,0BAA0B,MAAM;CAEzD,MAAM,gBAAgB;EACpB,YAAY,gBAAgB,wBAAwB;EACpD,OAAO,QAAQ,QAAQ;CACzB;CAWA,OAAO,IATYA,qBAAAA,YAAAA,GAAAA,qBAAAA,YAAAA,CACL,0BAA0B,MAAM,GAC5C,IAAI,sBAAsB,GAC1B,EACE,OAAO,gBACT,GACA,OAGU;AACd"}

package/dist/index.mjs

@@ -1,7 +1,153 @@
-import { TestEngine, byAttribute } from "@atomic-testing/core";
-import { ReactInteractor } from "@atomic-testing/react-core";
+import { TestEngine, byAttribute, defaultWaitForOption } from "@atomic-testing/core";
 import ReactDOM from "react-dom";
 import { act } from "react-dom/test-utils.js";
+import { DOMInteractor } from "@atomic-testing/dom-core";
+//#region src/LegacyReactInteractor.ts
+/**
+* React 16/17 counterpart of `@atomic-testing/react-core`'s `ReactInteractor`.
+*
+* It is a deliberate parallel implementation rather than a subclass of the
+* react-core interactor: react-core wraps actions with `act` from
+* `@testing-library/react@16`, whose peer range is React 18/19. Reusing it would
+* drag that dependency into react-legacy and make the package impossible to
+* install on React 16/17 (the very versions this adapter exists to support). By
+* extending `DOMInteractor` directly and wrapping with `act` from
+* `react-dom/test-utils` (the React ≤17 act), react-legacy stays on a coherent
+* React-16/17 dependency graph.
+*/
+var LegacyReactInteractor = class LegacyReactInteractor extends DOMInteractor {
+	async enterText(locator, text, option) {
+		await act(async () => {
+			await super.enterText(locator, text, option);
+		});
+	}
+	async setRangeValue(locator, value) {
+		await act(async () => {
+			await super.setRangeValue(locator, value);
+		});
+	}
+	async click(locator, option) {
+		await act(async () => {
+			await super.click(locator, option);
+		});
+	}
+	async hover(locator, option) {
+		await act(async () => {
+			await super.hover(locator, option);
+		});
+	}
+	async mouseMove(locator, option) {
+		await act(async () => {
+			await super.mouseMove(locator, option);
+		});
+	}
+	async mouseDown(locator, option) {
+		await act(async () => {
+			await super.mouseDown(locator, option);
+		});
+	}
+	async mouseUp(locator, option) {
+		await act(async () => {
+			await super.mouseUp(locator, option);
+		});
+	}
+	async mouseOver(locator, option) {
+		await act(async () => {
+			await super.mouseOver(locator, option);
+		});
+	}
+	async mouseOut(locator, option) {
+		await act(async () => {
+			await super.mouseOut(locator, option);
+		});
+	}
+	async mouseEnter(locator, option) {
+		await act(async () => {
+			await super.mouseEnter(locator, option);
+		});
+	}
+	async mouseLeave(locator, option) {
+		await act(async () => {
+			await super.mouseLeave(locator, option);
+		});
+	}
+	async focus(locator, option) {
+		await act(async () => {
+			await super.focus(locator, option);
+		});
+	}
+	async blur(locator, option) {
+		await act(async () => {
+			await super.blur(locator, option);
+		});
+	}
+	async pressKey(locator, key, option) {
+		await act(async () => {
+			await super.pressKey(locator, key, option);
+		});
+	}
+	async contextMenu(locator) {
+		await act(async () => {
+			await super.contextMenu(locator);
+		});
+	}
+	async activate(locator) {
+		await act(async () => {
+			await super.activate(locator);
+		});
+	}
+	async selectOptionValue(locator, values) {
+		await act(async () => {
+			await super.selectOptionValue(locator, values);
+		});
+	}
+	async setInputFiles(locator, files) {
+		await act(async () => {
+			await super.setInputFiles(locator, files);
+		});
+	}
+	async scrollIntoView(locator) {
+		await act(async () => {
+			await super.scrollIntoView(locator);
+		});
+	}
+	async scrollBy(locator, delta) {
+		await act(async () => {
+			await super.scrollBy(locator, delta);
+		});
+	}
+	async dragTo(source, target) {
+		await act(async () => {
+			await super.dragTo(source, target);
+		});
+	}
+	async drag(locator, delta) {
+		await act(async () => {
+			await super.drag(locator, delta);
+		});
+	}
+	async wait(ms) {
+		await act(async () => {
+			await super.wait(ms);
+		});
+	}
+	async waitUntilComponentState(locator, option = defaultWaitForOption) {
+		await act(async () => {
+			await super.waitUntilComponentState(locator, option);
+		});
+	}
+	async waitUntil(option) {
+		let result;
+		await act(async () => {
+			result = await super.waitUntil(option);
+		});
+		return result;
+	}
+	clone() {
+		return new LegacyReactInteractor(this.rootEl);
+	}
+};
+//#endregion
 //#region src/createTestEngine.ts
 let _rootId = 0;
 function getNextRootElementId() {
@@ -30,7 +176,7 @@ function createTestEngine(node, partDefinitions, option) {
 		rootEl.removeChild(container);
 		return Promise.resolve();
 	};
-	return new TestEngine(byAttribute(rootElementAttributeName, rootId), new ReactInteractor(), { parts: partDefinitions }, cleanup);
+	return new TestEngine(byAttribute(rootElementAttributeName, rootId), new LegacyReactInteractor(), { parts: partDefinitions }, cleanup);
 }
 /**
 * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19
@@ -48,7 +194,7 @@ function createRenderedTestEngine(rootElement, partDefinitions, _option) {
 		rootElement.removeAttribute(rootElementAttributeName);
 		return Promise.resolve();
 	};
-	return new TestEngine(byAttribute(rootElementAttributeName, rootId), new ReactInteractor(), { parts: partDefinitions }, cleanup);
+	return new TestEngine(byAttribute(rootElementAttributeName, rootId), new LegacyReactInteractor(), { parts: partDefinitions }, cleanup);
 }
 //#endregion
 export { createRenderedTestEngine, createTestEngine };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/createTestEngine.ts"],"sourcesContent":["import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';\nimport { ReactInteractor } from '@atomic-testing/react-core';\nimport { ReactElement } from 'react';\nimport ReactDOM from 'react-dom';\nimport { act } from 'react-dom/test-utils';\n\nimport { IReactTestEngineOption } from './types';\n\nlet _rootId = 0;\nfunction getNextRootElementId() {\n  return `${_rootId++}`;\n}\n\nconst rootElementAttributeName = 'data-atomic-testing-react-legacy';\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes a react node and render it into a container element.  For rendered\n * components, use createRenderedLegacyTestEngine\n * @param node The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createTestEngine<T extends ScenePart>(\n  node: ReactElement,\n  partDefinitions: T,\n  option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootEl = option?.rootElement ?? document.body;\n  const container = rootEl.appendChild(document.createElement('div'));\n  const rootId = getNextRootElementId();\n  container.setAttribute(rootElementAttributeName, rootId);\n\n  act(() => {\n    ReactDOM.render(node, container);\n  });\n  const cleanup = () => {\n    ReactDOM.unmountComponentAtNode(container);\n    rootEl.removeChild(container);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new ReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes an html element purportedly rendered by React and create a test engine for it, it\n * can be useful in environment such as Storybook where Storybook renders the component and the test\n * @param rootElement The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createRenderedTestEngine<T extends ScenePart>(\n  rootElement: HTMLElement,\n  partDefinitions: T,\n  _option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootId = getNextRootElementId();\n  rootElement.setAttribute(rootElementAttributeName, rootId);\n\n  const cleanup = () => {\n    rootElement.removeAttribute(rootElementAttributeName);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new ReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n"],"mappings":";;;;;AAQA,IAAI,UAAU;AACd,SAAS,uBAAuB;CAC9B,OAAO,GAAG;AACZ;AAEA,MAAM,2BAA2B;;;;;;;;;;AAWjC,SAAgB,iBACd,MACA,iBACA,QACe;CACf,MAAM,SAAS,QAAQ,eAAe,SAAS;CAC/C,MAAM,YAAY,OAAO,YAAY,SAAS,cAAc,KAAK,CAAC;CAClE,MAAM,SAAS,qBAAqB;CACpC,UAAU,aAAa,0BAA0B,MAAM;CAEvD,UAAU;EACR,SAAS,OAAO,MAAM,SAAS;CACjC,CAAC;CACD,MAAM,gBAAgB;EACpB,SAAS,uBAAuB,SAAS;EACzC,OAAO,YAAY,SAAS;EAC5B,OAAO,QAAQ,QAAQ;CACzB;CAWA,OAAO,IATY,WACjB,YAAY,0BAA0B,MAAM,GAC5C,IAAI,gBAAgB,GACpB,EACE,OAAO,gBACT,GACA,OAGU;AACd;;;;;;;;;;AAWA,SAAgB,yBACd,aACA,iBACA,SACe;CACf,MAAM,SAAS,qBAAqB;CACpC,YAAY,aAAa,0BAA0B,MAAM;CAEzD,MAAM,gBAAgB;EACpB,YAAY,gBAAgB,wBAAwB;EACpD,OAAO,QAAQ,QAAQ;CACzB;CAWA,OAAO,IATY,WACjB,YAAY,0BAA0B,MAAM,GAC5C,IAAI,gBAAgB,GACpB,EACE,OAAO,gBACT,GACA,OAGU;AACd"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/LegacyReactInteractor.ts","../src/createTestEngine.ts"],"sourcesContent":["import {\n  BlurOption,\n  ClickOption,\n  defaultWaitForOption,\n  EnterTextOption,\n  FocusOption,\n  HoverOption,\n  Interactor,\n  MouseDownOption,\n  MouseEnterOption,\n  MouseLeaveOption,\n  MouseMoveOption,\n  MouseOutOption,\n  MouseUpOption,\n  PartLocator,\n  Point,\n  PressKeyOption,\n  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { DOMInteractor } from '@atomic-testing/dom-core';\nimport { act } from 'react-dom/test-utils';\n\n/**\n * React 16/17 counterpart of `@atomic-testing/react-core`'s `ReactInteractor`.\n *\n * It is a deliberate parallel implementation rather than a subclass of the\n * react-core interactor: react-core wraps actions with `act` from\n * `@testing-library/react@16`, whose peer range is React 18/19. Reusing it would\n * drag that dependency into react-legacy and make the package impossible to\n * install on React 16/17 (the very versions this adapter exists to support). By\n * extending `DOMInteractor` directly and wrapping with `act` from\n * `react-dom/test-utils` (the React ≤17 act), react-legacy stays on a coherent\n * React-16/17 dependency graph.\n */\nexport class LegacyReactInteractor extends DOMInteractor {\n  override async enterText(locator: PartLocator, text: string, option?: Partial<EnterTextOption>): Promise<void> {\n    await act(async () => {\n      await super.enterText(locator, text, option);\n    });\n  }\n\n  override async setRangeValue(locator: PartLocator, value: number): Promise<void> {\n    await act(async () => {\n      await super.setRangeValue(locator, value);\n    });\n  }\n\n  override async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {\n    await act(async () => {\n      await super.click(locator, option);\n    });\n  }\n\n  override async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    await act(async () => {\n      await super.hover(locator, option);\n    });\n  }\n\n  override async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseMove(locator, option);\n    });\n  }\n\n  override async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseDown(locator, option);\n    });\n  }\n\n  override async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseUp(locator, option);\n    });\n  }\n\n  override async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseOver(locator, option);\n    });\n  }\n\n  override async mouseOut(locator: PartLocator, option?: Partial<MouseOutOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseOut(locator, option);\n    });\n  }\n\n  override async mouseEnter(locator: PartLocator, option?: Partial<MouseEnterOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseEnter(locator, option);\n    });\n  }\n\n  override async mouseLeave(locator: PartLocator, option?: Partial<MouseLeaveOption>): Promise<void> {\n    await act(async () => {\n      await super.mouseLeave(locator, option);\n    });\n  }\n\n  override async focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void> {\n    await act(async () => {\n      await super.focus(locator, option);\n    });\n  }\n\n  override async blur(locator: PartLocator, option?: Partial<BlurOption>): Promise<void> {\n    await act(async () => {\n      await super.blur(locator, option);\n    });\n  }\n\n  override async pressKey(locator: PartLocator, key: string, option?: Partial<PressKeyOption>): Promise<void> {\n    await act(async () => {\n      await super.pressKey(locator, key, option);\n    });\n  }\n\n  override async contextMenu(locator: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.contextMenu(locator);\n    });\n  }\n\n  override async activate(locator: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.activate(locator);\n    });\n  }\n\n  override async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {\n    await act(async () => {\n      await super.selectOptionValue(locator, values);\n    });\n  }\n\n  override async setInputFiles(locator: PartLocator, files: string | string[]): Promise<void> {\n    await act(async () => {\n      await super.setInputFiles(locator, files);\n    });\n  }\n\n  override async scrollIntoView(locator: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.scrollIntoView(locator);\n    });\n  }\n\n  override async scrollBy(locator: PartLocator, delta: Point): Promise<void> {\n    await act(async () => {\n      await super.scrollBy(locator, delta);\n    });\n  }\n\n  override async dragTo(source: PartLocator, target: PartLocator): Promise<void> {\n    await act(async () => {\n      await super.dragTo(source, target);\n    });\n  }\n\n  override async drag(locator: PartLocator, delta: Point): Promise<void> {\n    await act(async () => {\n      await super.drag(locator, delta);\n    });\n  }\n\n  //#region wait condition\n  override async wait(ms: number): Promise<void> {\n    await act(async () => {\n      await super.wait(ms);\n    });\n  }\n\n  override async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption\n  ): Promise<void> {\n    await act(async () => {\n      await super.waitUntilComponentState(locator, option);\n    });\n  }\n\n  override async waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    // The React ≤17 `act` async overload resolves to `undefined`, not the\n    // callback's value (unlike React 18's act), so capture the result via a\n    // closure instead of returning it through `act`.\n    let result!: T;\n    await act(async () => {\n      result = await super.waitUntil(option);\n    });\n    return result;\n  }\n  //#endregion\n\n  override clone(): Interactor {\n    return new LegacyReactInteractor(this.rootEl);\n  }\n}\n","import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';\nimport { ReactElement } from 'react';\nimport ReactDOM from 'react-dom';\nimport { act } from 'react-dom/test-utils';\n\nimport { LegacyReactInteractor } from './LegacyReactInteractor';\nimport { IReactTestEngineOption } from './types';\n\nlet _rootId = 0;\nfunction getNextRootElementId() {\n  return `${_rootId++}`;\n}\n\nconst rootElementAttributeName = 'data-atomic-testing-react-legacy';\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes a react node and render it into a container element.  For rendered\n * components, use createRenderedLegacyTestEngine\n * @param node The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createTestEngine<T extends ScenePart>(\n  node: ReactElement,\n  partDefinitions: T,\n  option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootEl = option?.rootElement ?? document.body;\n  const container = rootEl.appendChild(document.createElement('div'));\n  const rootId = getNextRootElementId();\n  container.setAttribute(rootElementAttributeName, rootId);\n\n  act(() => {\n    ReactDOM.render(node, container);\n  });\n  const cleanup = () => {\n    ReactDOM.unmountComponentAtNode(container);\n    rootEl.removeChild(container);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new LegacyReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n\n/**\n * Create test engine for React 17 or before, for React 18 or later, use @atomic-testing/react-18 or @atomic-testing/react-19\n * This function takes an html element purportedly rendered by React and create a test engine for it, it\n * can be useful in environment such as Storybook where Storybook renders the component and the test\n * @param rootElement The React node to render\n * @param partDefinitions The scene part definitions\n * @param option\n * @returns The test engine\n */\nexport function createRenderedTestEngine<T extends ScenePart>(\n  rootElement: HTMLElement,\n  partDefinitions: T,\n  _option?: Readonly<Partial<IReactTestEngineOption>>\n): TestEngine<T> {\n  const rootId = getNextRootElementId();\n  rootElement.setAttribute(rootElementAttributeName, rootId);\n\n  const cleanup = () => {\n    rootElement.removeAttribute(rootElementAttributeName);\n    return Promise.resolve();\n  };\n\n  const engine = new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new LegacyReactInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n\n  return engine;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atomic-testing/react-legacy",
-  "version": "0.88.0",
+  "version": "0.89.0",
   "description": "Adapter for testing React 17 and earlier",
   "keywords": [
     "legacy",
@@ -29,26 +29,26 @@
     }
   },
   "dependencies": {
-    "react-dom": "^17.0.0",
-    "@atomic-testing/core": "0.88.0",
-    "@atomic-testing/react-core": "0.88.0",
-    "@atomic-testing/dom-core": "0.88.0"
+    "@atomic-testing/core": "0.89.0",
+    "@atomic-testing/dom-core": "0.89.0"
   },
   "devDependencies": {
     "@types/react": "^17.0.0",
     "@types/react-dom": "^17.0.0",
     "react": "^17.0.0",
-    "react-dom": "^17.0.0"
+    "react-dom": "^17.0.0",
+    "@atomic-testing/component-driver-html": "0.89.0"
   },
   "peerDependencies": {
     "@testing-library/dom": ">=10.4.1",
-    "@testing-library/react": ">=12.0.0",
     "@testing-library/user-event": ">=14.0.0",
     "react": "^16 || ^17",
     "react-dom": "^16 || ^17"
   },
   "scripts": {
     "build": "tsdown",
-    "check:type": "tsgo --noEmit"
+    "check:type": "tsgo --noEmit",
+    "check:api": "api-extractor run",
+    "test:dom": "jest"
   }
 }

package/src/LegacyReactInteractor.ts

@@ -0,0 +1,200 @@
+import {
+  BlurOption,
+  ClickOption,
+  defaultWaitForOption,
+  EnterTextOption,
+  FocusOption,
+  HoverOption,
+  Interactor,
+  MouseDownOption,
+  MouseEnterOption,
+  MouseLeaveOption,
+  MouseMoveOption,
+  MouseOutOption,
+  MouseUpOption,
+  PartLocator,
+  Point,
+  PressKeyOption,
+  WaitForOption,
+  WaitUntilOption,
+} from '@atomic-testing/core';
+import { DOMInteractor } from '@atomic-testing/dom-core';
+import { act } from 'react-dom/test-utils';
+
+/**
+ * React 16/17 counterpart of `@atomic-testing/react-core`'s `ReactInteractor`.
+ *
+ * It is a deliberate parallel implementation rather than a subclass of the
+ * react-core interactor: react-core wraps actions with `act` from
+ * `@testing-library/react@16`, whose peer range is React 18/19. Reusing it would
+ * drag that dependency into react-legacy and make the package impossible to
+ * install on React 16/17 (the very versions this adapter exists to support). By
+ * extending `DOMInteractor` directly and wrapping with `act` from
+ * `react-dom/test-utils` (the React ≤17 act), react-legacy stays on a coherent
+ * React-16/17 dependency graph.
+ */
+export class LegacyReactInteractor extends DOMInteractor {
+  override async enterText(locator: PartLocator, text: string, option?: Partial<EnterTextOption>): Promise<void> {
+    await act(async () => {
+      await super.enterText(locator, text, option);
+    });
+  }
+
+  override async setRangeValue(locator: PartLocator, value: number): Promise<void> {
+    await act(async () => {
+      await super.setRangeValue(locator, value);
+    });
+  }
+
+  override async click(locator: PartLocator, option?: Partial<ClickOption>): Promise<void> {
+    await act(async () => {
+      await super.click(locator, option);
+    });
+  }
+
+  override async hover(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {
+    await act(async () => {
+      await super.hover(locator, option);
+    });
+  }
+
+  override async mouseMove(locator: PartLocator, option?: Partial<MouseMoveOption>): Promise<void> {
+    await act(async () => {
+      await super.mouseMove(locator, option);
+    });
+  }
+
+  override async mouseDown(locator: PartLocator, option?: Partial<MouseDownOption>): Promise<void> {
+    await act(async () => {
+      await super.mouseDown(locator, option);
+    });
+  }
+
+  override async mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void> {
+    await act(async () => {
+      await super.mouseUp(locator, option);
+    });
+  }
+
+  override async mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void> {
+    await act(async () => {
+      await super.mouseOver(locator, option);
+    });
+  }
+
+  override async mouseOut(locator: PartLocator, option?: Partial<MouseOutOption>): Promise<void> {
+    await act(async () => {
+      await super.mouseOut(locator, option);
+    });
+  }
+
+  override async mouseEnter(locator: PartLocator, option?: Partial<MouseEnterOption>): Promise<void> {
+    await act(async () => {
+      await super.mouseEnter(locator, option);
+    });
+  }
+
+  override async mouseLeave(locator: PartLocator, option?: Partial<MouseLeaveOption>): Promise<void> {
+    await act(async () => {
+      await super.mouseLeave(locator, option);
+    });
+  }
+
+  override async focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void> {
+    await act(async () => {
+      await super.focus(locator, option);
+    });
+  }
+
+  override async blur(locator: PartLocator, option?: Partial<BlurOption>): Promise<void> {
+    await act(async () => {
+      await super.blur(locator, option);
+    });
+  }
+
+  override async pressKey(locator: PartLocator, key: string, option?: Partial<PressKeyOption>): Promise<void> {
+    await act(async () => {
+      await super.pressKey(locator, key, option);
+    });
+  }
+
+  override async contextMenu(locator: PartLocator): Promise<void> {
+    await act(async () => {
+      await super.contextMenu(locator);
+    });
+  }
+
+  override async activate(locator: PartLocator): Promise<void> {
+    await act(async () => {
+      await super.activate(locator);
+    });
+  }
+
+  override async selectOptionValue(locator: PartLocator, values: string[]): Promise<void> {
+    await act(async () => {
+      await super.selectOptionValue(locator, values);
+    });
+  }
+
+  override async setInputFiles(locator: PartLocator, files: string | string[]): Promise<void> {
+    await act(async () => {
+      await super.setInputFiles(locator, files);
+    });
+  }
+
+  override async scrollIntoView(locator: PartLocator): Promise<void> {
+    await act(async () => {
+      await super.scrollIntoView(locator);
+    });
+  }
+
+  override async scrollBy(locator: PartLocator, delta: Point): Promise<void> {
+    await act(async () => {
+      await super.scrollBy(locator, delta);
+    });
+  }
+
+  override async dragTo(source: PartLocator, target: PartLocator): Promise<void> {
+    await act(async () => {
+      await super.dragTo(source, target);
+    });
+  }
+
+  override async drag(locator: PartLocator, delta: Point): Promise<void> {
+    await act(async () => {
+      await super.drag(locator, delta);
+    });
+  }
+
+  //#region wait condition
+  override async wait(ms: number): Promise<void> {
+    await act(async () => {
+      await super.wait(ms);
+    });
+  }
+
+  override async waitUntilComponentState(
+    locator: PartLocator,
+    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption
+  ): Promise<void> {
+    await act(async () => {
+      await super.waitUntilComponentState(locator, option);
+    });
+  }
+
+  override async waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {
+    // The React ≤17 `act` async overload resolves to `undefined`, not the
+    // callback's value (unlike React 18's act), so capture the result via a
+    // closure instead of returning it through `act`.
+    let result!: T;
+    await act(async () => {
+      result = await super.waitUntil(option);
+    });
+    return result;
+  }
+  //#endregion
+
+  override clone(): Interactor {
+    return new LegacyReactInteractor(this.rootEl);
+  }
+}

package/src/createTestEngine.ts

@@ -1,9 +1,9 @@
 import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';
-import { ReactInteractor } from '@atomic-testing/react-core';
 import { ReactElement } from 'react';
 import ReactDOM from 'react-dom';
 import { act } from 'react-dom/test-utils';
 
+import { LegacyReactInteractor } from './LegacyReactInteractor';
 import { IReactTestEngineOption } from './types';
 
 let _rootId = 0;
@@ -43,7 +43,7 @@ export function createTestEngine<T extends ScenePart>(
 
   const engine = new TestEngine(
     byAttribute(rootElementAttributeName, rootId),
-    new ReactInteractor(),
+    new LegacyReactInteractor(),
     {
       parts: partDefinitions,
     },
@@ -77,7 +77,7 @@ export function createRenderedTestEngine<T extends ScenePart>(
 
   const engine = new TestEngine(
     byAttribute(rootElementAttributeName, rootId),
-    new ReactInteractor(),
+    new LegacyReactInteractor(),
     {
       parts: partDefinitions,
     },