@atomic-testing/vue-3 0.71.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tianzhen Lin (Tangent)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @atomic-testing/vue-3
+
+Adapter for integrating Atomic Testing with [Vue 3](https://vuejs.org).
+
+## Installation
+
+```bash
+pnpm add @atomic-testing/vue-3
+```

package/dist/index.d.mts

@@ -0,0 +1,36 @@
+import { ClickOption, EnterTextOption, FocusOption, HoverOption, IComponentDriverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
+import { Component } from "vue";
+import { DOMInteractor } from "@atomic-testing/dom-core";
+
+//#region src/types.d.ts
+interface IVueTestEngineOption extends IComponentDriverOption {
+  rootElement?: Element;
+}
+//#endregion
+//#region src/createTestEngine.d.ts
+declare function createTestEngine<T extends ScenePart>(component: Component, partDefinitions: T, option?: Readonly<Partial<IVueTestEngineOption>>): TestEngine<T>;
+declare function createRenderedTestEngine<T extends ScenePart>(rootElement: HTMLElement, partDefinitions: T, _option?: Readonly<Partial<IVueTestEngineOption>>): TestEngine<T>;
+//#endregion
+//#region src/VueInteractor.d.ts
+declare class VueInteractor extends DOMInteractor {
+  private flush;
+  enterText(locator: PartLocator, text: string, option?: Partial<EnterTextOption>): Promise<void>;
+  click(locator: PartLocator, option?: Partial<ClickOption>): 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>;
+  mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void>;
+  mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void>;
+  mouseOut(locator: PartLocator, option?: Partial<MouseOutOption>): Promise<void>;
+  mouseEnter(locator: PartLocator, option?: Partial<MouseEnterOption>): Promise<void>;
+  mouseLeave(locator: PartLocator, option?: Partial<MouseLeaveOption>): Promise<void>;
+  focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void>;
+  selectOptionValue(locator: PartLocator, values: string[]): Promise<void>;
+  wait(ms: number): Promise<void>;
+  waitUntilComponentState(locator: PartLocator, option?: Partial<Readonly<WaitForOption>>): Promise<void>;
+  waitUntil<T>(option: WaitUntilOption<T>): Promise<T>;
+  clone(): Interactor;
+}
+//#endregion
+export { IVueTestEngineOption, VueInteractor, createRenderedTestEngine, createTestEngine };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import { ClickOption, EnterTextOption, FocusOption, HoverOption, IComponentDriverOption, Interactor, MouseDownOption, MouseEnterOption, MouseLeaveOption, MouseMoveOption, MouseOutOption, MouseUpOption, PartLocator, ScenePart, TestEngine, WaitForOption, WaitUntilOption } from "@atomic-testing/core";
+import { Component } from "vue";
+import { DOMInteractor } from "@atomic-testing/dom-core";
+
+//#region src/types.d.ts
+interface IVueTestEngineOption extends IComponentDriverOption {
+  rootElement?: Element;
+}
+//#endregion
+//#region src/createTestEngine.d.ts
+declare function createTestEngine<T extends ScenePart>(component: Component, partDefinitions: T, option?: Readonly<Partial<IVueTestEngineOption>>): TestEngine<T>;
+declare function createRenderedTestEngine<T extends ScenePart>(rootElement: HTMLElement, partDefinitions: T, _option?: Readonly<Partial<IVueTestEngineOption>>): TestEngine<T>;
+//#endregion
+//#region src/VueInteractor.d.ts
+declare class VueInteractor extends DOMInteractor {
+  private flush;
+  enterText(locator: PartLocator, text: string, option?: Partial<EnterTextOption>): Promise<void>;
+  click(locator: PartLocator, option?: Partial<ClickOption>): 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>;
+  mouseUp(locator: PartLocator, option?: Partial<MouseUpOption>): Promise<void>;
+  mouseOver(locator: PartLocator, option?: Partial<HoverOption>): Promise<void>;
+  mouseOut(locator: PartLocator, option?: Partial<MouseOutOption>): Promise<void>;
+  mouseEnter(locator: PartLocator, option?: Partial<MouseEnterOption>): Promise<void>;
+  mouseLeave(locator: PartLocator, option?: Partial<MouseLeaveOption>): Promise<void>;
+  focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void>;
+  selectOptionValue(locator: PartLocator, values: string[]): Promise<void>;
+  wait(ms: number): Promise<void>;
+  waitUntilComponentState(locator: PartLocator, option?: Partial<Readonly<WaitForOption>>): Promise<void>;
+  waitUntil<T>(option: WaitUntilOption<T>): Promise<T>;
+  clone(): Interactor;
+}
+//#endregion
+export { IVueTestEngineOption, VueInteractor, createRenderedTestEngine, createTestEngine };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,145 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const __atomic_testing_core = __toESM(require("@atomic-testing/core"));
+const __testing_library_vue = __toESM(require("@testing-library/vue"));
+const vue = __toESM(require("vue"));
+const __atomic_testing_dom_core = __toESM(require("@atomic-testing/dom-core"));
+
+//#region src/VueInteractor.ts
+var VueInteractor = class VueInteractor extends __atomic_testing_dom_core.DOMInteractor {
+	async flush() {
+		await (0, vue.nextTick)();
+	}
+	async enterText(locator, text, option) {
+		await super.enterText(locator, text, option);
+		await this.flush();
+	}
+	async click(locator, option) {
+		await super.click(locator, option);
+		await this.flush();
+	}
+	async hover(locator, option) {
+		await super.hover(locator, option);
+		await this.flush();
+	}
+	async mouseMove(locator, option) {
+		await super.mouseMove(locator, option);
+		await this.flush();
+	}
+	async mouseDown(locator, option) {
+		await super.mouseDown(locator, option);
+		await this.flush();
+	}
+	async mouseUp(locator, option) {
+		await super.mouseUp(locator, option);
+		await this.flush();
+	}
+	async mouseOver(locator, option) {
+		await super.mouseOver(locator, option);
+		await this.flush();
+	}
+	async mouseOut(locator, option) {
+		await super.mouseOut(locator, option);
+		await this.flush();
+	}
+	async mouseEnter(locator, option) {
+		await super.mouseEnter(locator, option);
+		await this.flush();
+	}
+	async mouseLeave(locator, option) {
+		await super.mouseLeave(locator, option);
+		await this.flush();
+	}
+	async focus(locator, option) {
+		await super.focus(locator, option);
+		await this.flush();
+	}
+	async selectOptionValue(locator, values) {
+		await super.selectOptionValue(locator, values);
+		await this.flush();
+	}
+	async wait(ms) {
+		await super.wait(ms);
+		await this.flush();
+	}
+	async waitUntilComponentState(locator, option = __atomic_testing_core.defaultWaitForOption) {
+		await super.waitUntilComponentState(locator, option);
+		await this.flush();
+	}
+	async waitUntil(option) {
+		const result = await super.waitUntil(option);
+		await this.flush();
+		return result;
+	}
+	clone() {
+		return new VueInteractor();
+	}
+};
+
+//#endregion
+//#region src/createTestEngine.ts
+let _rootId = 0;
+function getNextRootElementId() {
+	return `${_rootId++}`;
+}
+const rootElementAttributeName = "data-atomic-testing-vue";
+function createTestEngine(component, partDefinitions, option) {
+	const rootEl = option?.rootElement ?? document.body;
+	const container = rootEl.appendChild(document.createElement("div"));
+	const rootId = getNextRootElementId();
+	container.setAttribute(rootElementAttributeName, rootId);
+	let unmount;
+	let app;
+	try {
+		const renderResult = (0, __testing_library_vue.render)(component, { container });
+		unmount = renderResult.unmount;
+	} catch (_error) {
+		app = (0, vue.createApp)(component);
+		app.mount(container);
+		unmount = () => {
+			if (app) app.unmount();
+		};
+	}
+	const cleanup = () => {
+		unmount();
+		rootEl.removeChild(container);
+		return Promise.resolve();
+	};
+	return new __atomic_testing_core.TestEngine((0, __atomic_testing_core.byAttribute)(rootElementAttributeName, rootId), new VueInteractor(), { parts: partDefinitions }, cleanup);
+}
+function createRenderedTestEngine(rootElement, partDefinitions, _option) {
+	const rootId = getNextRootElementId();
+	rootElement.setAttribute(rootElementAttributeName, rootId);
+	const cleanup = () => {
+		rootElement.removeAttribute(rootElementAttributeName);
+		return Promise.resolve();
+	};
+	return new __atomic_testing_core.TestEngine((0, __atomic_testing_core.byAttribute)(rootElementAttributeName, rootId), new VueInteractor(), { parts: partDefinitions }, cleanup);
+}
+
+//#endregion
+exports.VueInteractor = VueInteractor;
+exports.createRenderedTestEngine = createRenderedTestEngine;
+exports.createTestEngine = createTestEngine;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DOMInteractor","locator: PartLocator","text: string","option?: Partial<EnterTextOption>","option?: Partial<ClickOption>","option?: Partial<HoverOption>","option?: Partial<MouseMoveOption>","option?: Partial<MouseDownOption>","option?: Partial<MouseUpOption>","option?: Partial<MouseOutOption>","option?: Partial<MouseEnterOption>","option?: Partial<MouseLeaveOption>","option?: Partial<FocusOption>","values: string[]","ms: number","option: Partial<Readonly<WaitForOption>>","defaultWaitForOption","option: WaitUntilOption<T>","component: Component","partDefinitions: T","option?: Readonly<Partial<IVueTestEngineOption>>","unmount: () => void","app: App","TestEngine","rootElement: HTMLElement","_option?: Readonly<Partial<IVueTestEngineOption>>"],"sources":["../src/VueInteractor.ts","../src/createTestEngine.ts"],"sourcesContent":["import {\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  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { DOMInteractor } from '@atomic-testing/dom-core';\nimport { nextTick } from 'vue';\n\nexport class VueInteractor extends DOMInteractor {\n  private async flush() {\n    await nextTick();\n  }\n\n  override async enterText(\n    locator: PartLocator,\n    text: string,\n    option?: Partial<EnterTextOption>,\n  ): Promise<void> {\n    await super.enterText(locator, text, option);\n    await this.flush();\n  }\n\n  override async click(\n    locator: PartLocator,\n    option?: Partial<ClickOption>,\n  ): Promise<void> {\n    await super.click(locator, option);\n    await this.flush();\n  }\n\n  override async hover(\n    locator: PartLocator,\n    option?: Partial<HoverOption>,\n  ): Promise<void> {\n    await super.hover(locator, option);\n    await this.flush();\n  }\n\n  async mouseMove(\n    locator: PartLocator,\n    option?: Partial<MouseMoveOption>,\n  ): Promise<void> {\n    await super.mouseMove(locator, option);\n    await this.flush();\n  }\n\n  async mouseDown(\n    locator: PartLocator,\n    option?: Partial<MouseDownOption>,\n  ): Promise<void> {\n    await super.mouseDown(locator, option);\n    await this.flush();\n  }\n\n  async mouseUp(\n    locator: PartLocator,\n    option?: Partial<MouseUpOption>,\n  ): Promise<void> {\n    await super.mouseUp(locator, option);\n    await this.flush();\n  }\n\n  async mouseOver(\n    locator: PartLocator,\n    option?: Partial<HoverOption>,\n  ): Promise<void> {\n    await super.mouseOver(locator, option);\n    await this.flush();\n  }\n\n  async mouseOut(\n    locator: PartLocator,\n    option?: Partial<MouseOutOption>,\n  ): Promise<void> {\n    await super.mouseOut(locator, option);\n    await this.flush();\n  }\n\n  async mouseEnter(\n    locator: PartLocator,\n    option?: Partial<MouseEnterOption>,\n  ): Promise<void> {\n    await super.mouseEnter(locator, option);\n    await this.flush();\n  }\n\n  async mouseLeave(\n    locator: PartLocator,\n    option?: Partial<MouseLeaveOption>,\n  ): Promise<void> {\n    await super.mouseLeave(locator, option);\n    await this.flush();\n  }\n\n  async focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void> {\n    await super.focus(locator, option);\n    await this.flush();\n  }\n\n  override async selectOptionValue(\n    locator: PartLocator,\n    values: string[],\n  ): Promise<void> {\n    await super.selectOptionValue(locator, values);\n    await this.flush();\n  }\n\n  override async wait(ms: number): Promise<void> {\n    await super.wait(ms);\n    await this.flush();\n  }\n\n  override async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption,\n  ): Promise<void> {\n    await super.waitUntilComponentState(locator, option);\n    await this.flush();\n  }\n\n  override async waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    const result = await super.waitUntil(option);\n    await this.flush();\n    return result;\n  }\n\n  override clone(): Interactor {\n    return new VueInteractor();\n  }\n}\n","import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';\nimport { render } from '@testing-library/vue';\nimport { App, Component, createApp } from 'vue';\n\nimport { VueInteractor } from './VueInteractor';\nimport { IVueTestEngineOption } from './types';\n\nlet _rootId = 0;\nfunction getNextRootElementId() {\n  return `${_rootId++}`;\n}\n\nconst rootElementAttributeName = 'data-atomic-testing-vue';\n\nexport function createTestEngine<T extends ScenePart>(\n  component: Component,\n  partDefinitions: T,\n  option?: Readonly<Partial<IVueTestEngineOption>>\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  let unmount: () => void;\n  let app: App;\n  \n  try {\n    const renderResult = render(component, { container });\n    unmount = renderResult.unmount;\n  } catch (_error) {\n    // Fallback to manual Vue app creation if render fails\n    app = createApp(component);\n    app.mount(container);\n    unmount = () => {\n      if (app) {\n        app.unmount();\n      }\n    };\n  }\n\n  const cleanup = () => {\n    unmount();\n    rootEl.removeChild(container);\n    return Promise.resolve();\n  };\n\n  return new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new VueInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n}\n\nexport function createRenderedTestEngine<T extends ScenePart>(\n  rootElement: HTMLElement,\n  partDefinitions: T,\n  _option?: Readonly<Partial<IVueTestEngineOption>>\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  return new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new VueInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,120 @@
+import { TestEngine, byAttribute, defaultWaitForOption } from "@atomic-testing/core";
+import { render } from "@testing-library/vue";
+import { createApp, nextTick } from "vue";
+import { DOMInteractor } from "@atomic-testing/dom-core";
+
+//#region src/VueInteractor.ts
+var VueInteractor = class VueInteractor extends DOMInteractor {
+	async flush() {
+		await nextTick();
+	}
+	async enterText(locator, text, option) {
+		await super.enterText(locator, text, option);
+		await this.flush();
+	}
+	async click(locator, option) {
+		await super.click(locator, option);
+		await this.flush();
+	}
+	async hover(locator, option) {
+		await super.hover(locator, option);
+		await this.flush();
+	}
+	async mouseMove(locator, option) {
+		await super.mouseMove(locator, option);
+		await this.flush();
+	}
+	async mouseDown(locator, option) {
+		await super.mouseDown(locator, option);
+		await this.flush();
+	}
+	async mouseUp(locator, option) {
+		await super.mouseUp(locator, option);
+		await this.flush();
+	}
+	async mouseOver(locator, option) {
+		await super.mouseOver(locator, option);
+		await this.flush();
+	}
+	async mouseOut(locator, option) {
+		await super.mouseOut(locator, option);
+		await this.flush();
+	}
+	async mouseEnter(locator, option) {
+		await super.mouseEnter(locator, option);
+		await this.flush();
+	}
+	async mouseLeave(locator, option) {
+		await super.mouseLeave(locator, option);
+		await this.flush();
+	}
+	async focus(locator, option) {
+		await super.focus(locator, option);
+		await this.flush();
+	}
+	async selectOptionValue(locator, values) {
+		await super.selectOptionValue(locator, values);
+		await this.flush();
+	}
+	async wait(ms) {
+		await super.wait(ms);
+		await this.flush();
+	}
+	async waitUntilComponentState(locator, option = defaultWaitForOption) {
+		await super.waitUntilComponentState(locator, option);
+		await this.flush();
+	}
+	async waitUntil(option) {
+		const result = await super.waitUntil(option);
+		await this.flush();
+		return result;
+	}
+	clone() {
+		return new VueInteractor();
+	}
+};
+
+//#endregion
+//#region src/createTestEngine.ts
+let _rootId = 0;
+function getNextRootElementId() {
+	return `${_rootId++}`;
+}
+const rootElementAttributeName = "data-atomic-testing-vue";
+function createTestEngine(component, partDefinitions, option) {
+	const rootEl = option?.rootElement ?? document.body;
+	const container = rootEl.appendChild(document.createElement("div"));
+	const rootId = getNextRootElementId();
+	container.setAttribute(rootElementAttributeName, rootId);
+	let unmount;
+	let app;
+	try {
+		const renderResult = render(component, { container });
+		unmount = renderResult.unmount;
+	} catch (_error) {
+		app = createApp(component);
+		app.mount(container);
+		unmount = () => {
+			if (app) app.unmount();
+		};
+	}
+	const cleanup = () => {
+		unmount();
+		rootEl.removeChild(container);
+		return Promise.resolve();
+	};
+	return new TestEngine(byAttribute(rootElementAttributeName, rootId), new VueInteractor(), { parts: partDefinitions }, cleanup);
+}
+function createRenderedTestEngine(rootElement, partDefinitions, _option) {
+	const rootId = getNextRootElementId();
+	rootElement.setAttribute(rootElementAttributeName, rootId);
+	const cleanup = () => {
+		rootElement.removeAttribute(rootElementAttributeName);
+		return Promise.resolve();
+	};
+	return new TestEngine(byAttribute(rootElementAttributeName, rootId), new VueInteractor(), { parts: partDefinitions }, cleanup);
+}
+
+//#endregion
+export { VueInteractor, createRenderedTestEngine, createTestEngine };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["locator: PartLocator","text: string","option?: Partial<EnterTextOption>","option?: Partial<ClickOption>","option?: Partial<HoverOption>","option?: Partial<MouseMoveOption>","option?: Partial<MouseDownOption>","option?: Partial<MouseUpOption>","option?: Partial<MouseOutOption>","option?: Partial<MouseEnterOption>","option?: Partial<MouseLeaveOption>","option?: Partial<FocusOption>","values: string[]","ms: number","option: Partial<Readonly<WaitForOption>>","option: WaitUntilOption<T>","component: Component","partDefinitions: T","option?: Readonly<Partial<IVueTestEngineOption>>","unmount: () => void","app: App","rootElement: HTMLElement","_option?: Readonly<Partial<IVueTestEngineOption>>"],"sources":["../src/VueInteractor.ts","../src/createTestEngine.ts"],"sourcesContent":["import {\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  WaitForOption,\n  WaitUntilOption,\n} from '@atomic-testing/core';\nimport { DOMInteractor } from '@atomic-testing/dom-core';\nimport { nextTick } from 'vue';\n\nexport class VueInteractor extends DOMInteractor {\n  private async flush() {\n    await nextTick();\n  }\n\n  override async enterText(\n    locator: PartLocator,\n    text: string,\n    option?: Partial<EnterTextOption>,\n  ): Promise<void> {\n    await super.enterText(locator, text, option);\n    await this.flush();\n  }\n\n  override async click(\n    locator: PartLocator,\n    option?: Partial<ClickOption>,\n  ): Promise<void> {\n    await super.click(locator, option);\n    await this.flush();\n  }\n\n  override async hover(\n    locator: PartLocator,\n    option?: Partial<HoverOption>,\n  ): Promise<void> {\n    await super.hover(locator, option);\n    await this.flush();\n  }\n\n  async mouseMove(\n    locator: PartLocator,\n    option?: Partial<MouseMoveOption>,\n  ): Promise<void> {\n    await super.mouseMove(locator, option);\n    await this.flush();\n  }\n\n  async mouseDown(\n    locator: PartLocator,\n    option?: Partial<MouseDownOption>,\n  ): Promise<void> {\n    await super.mouseDown(locator, option);\n    await this.flush();\n  }\n\n  async mouseUp(\n    locator: PartLocator,\n    option?: Partial<MouseUpOption>,\n  ): Promise<void> {\n    await super.mouseUp(locator, option);\n    await this.flush();\n  }\n\n  async mouseOver(\n    locator: PartLocator,\n    option?: Partial<HoverOption>,\n  ): Promise<void> {\n    await super.mouseOver(locator, option);\n    await this.flush();\n  }\n\n  async mouseOut(\n    locator: PartLocator,\n    option?: Partial<MouseOutOption>,\n  ): Promise<void> {\n    await super.mouseOut(locator, option);\n    await this.flush();\n  }\n\n  async mouseEnter(\n    locator: PartLocator,\n    option?: Partial<MouseEnterOption>,\n  ): Promise<void> {\n    await super.mouseEnter(locator, option);\n    await this.flush();\n  }\n\n  async mouseLeave(\n    locator: PartLocator,\n    option?: Partial<MouseLeaveOption>,\n  ): Promise<void> {\n    await super.mouseLeave(locator, option);\n    await this.flush();\n  }\n\n  async focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void> {\n    await super.focus(locator, option);\n    await this.flush();\n  }\n\n  override async selectOptionValue(\n    locator: PartLocator,\n    values: string[],\n  ): Promise<void> {\n    await super.selectOptionValue(locator, values);\n    await this.flush();\n  }\n\n  override async wait(ms: number): Promise<void> {\n    await super.wait(ms);\n    await this.flush();\n  }\n\n  override async waitUntilComponentState(\n    locator: PartLocator,\n    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption,\n  ): Promise<void> {\n    await super.waitUntilComponentState(locator, option);\n    await this.flush();\n  }\n\n  override async waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {\n    const result = await super.waitUntil(option);\n    await this.flush();\n    return result;\n  }\n\n  override clone(): Interactor {\n    return new VueInteractor();\n  }\n}\n","import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';\nimport { render } from '@testing-library/vue';\nimport { App, Component, createApp } from 'vue';\n\nimport { VueInteractor } from './VueInteractor';\nimport { IVueTestEngineOption } from './types';\n\nlet _rootId = 0;\nfunction getNextRootElementId() {\n  return `${_rootId++}`;\n}\n\nconst rootElementAttributeName = 'data-atomic-testing-vue';\n\nexport function createTestEngine<T extends ScenePart>(\n  component: Component,\n  partDefinitions: T,\n  option?: Readonly<Partial<IVueTestEngineOption>>\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  let unmount: () => void;\n  let app: App;\n  \n  try {\n    const renderResult = render(component, { container });\n    unmount = renderResult.unmount;\n  } catch (_error) {\n    // Fallback to manual Vue app creation if render fails\n    app = createApp(component);\n    app.mount(container);\n    unmount = () => {\n      if (app) {\n        app.unmount();\n      }\n    };\n  }\n\n  const cleanup = () => {\n    unmount();\n    rootEl.removeChild(container);\n    return Promise.resolve();\n  };\n\n  return new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new VueInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n}\n\nexport function createRenderedTestEngine<T extends ScenePart>(\n  rootElement: HTMLElement,\n  partDefinitions: T,\n  _option?: Readonly<Partial<IVueTestEngineOption>>\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  return new TestEngine(\n    byAttribute(rootElementAttributeName, rootId),\n    new VueInteractor(),\n    {\n      parts: partDefinitions,\n    },\n    cleanup\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@atomic-testing/vue-3",
+  "version": "0.71.0",
+  "description": "",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "author": "Tianzhen Lin <tangent@usa.net>",
+  "keywords": [
+    "testing",
+    "vue",
+    "unit",
+    "integration"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/atomic-testing/atomic-testing.git",
+    "directory": "packages/vue-3"
+  },
+  "dependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/vue": "^8.1.0",
+    "@atomic-testing/core": "0.71.0",
+    "@atomic-testing/dom-core": "0.71.0"
+  },
+  "devDependencies": {
+    "vue": "^3.5.0"
+  },
+  "peerDependencies": {
+    "@testing-library/dom": ">=10.4.0",
+    "@testing-library/vue": ">=8.1.0",
+    "@testing-library/user-event": ">=14.0.0",
+    "vue": ">=3.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check:type": "tsc --noEmit"
+  }
+}

package/src/VueInteractor.ts

@@ -0,0 +1,142 @@
+import {
+  ClickOption,
+  defaultWaitForOption,
+  EnterTextOption,
+  FocusOption,
+  HoverOption,
+  Interactor,
+  MouseDownOption,
+  MouseEnterOption,
+  MouseLeaveOption,
+  MouseMoveOption,
+  MouseOutOption,
+  MouseUpOption,
+  PartLocator,
+  WaitForOption,
+  WaitUntilOption,
+} from '@atomic-testing/core';
+import { DOMInteractor } from '@atomic-testing/dom-core';
+import { nextTick } from 'vue';
+
+export class VueInteractor extends DOMInteractor {
+  private async flush() {
+    await nextTick();
+  }
+
+  override async enterText(
+    locator: PartLocator,
+    text: string,
+    option?: Partial<EnterTextOption>,
+  ): Promise<void> {
+    await super.enterText(locator, text, option);
+    await this.flush();
+  }
+
+  override async click(
+    locator: PartLocator,
+    option?: Partial<ClickOption>,
+  ): Promise<void> {
+    await super.click(locator, option);
+    await this.flush();
+  }
+
+  override async hover(
+    locator: PartLocator,
+    option?: Partial<HoverOption>,
+  ): Promise<void> {
+    await super.hover(locator, option);
+    await this.flush();
+  }
+
+  async mouseMove(
+    locator: PartLocator,
+    option?: Partial<MouseMoveOption>,
+  ): Promise<void> {
+    await super.mouseMove(locator, option);
+    await this.flush();
+  }
+
+  async mouseDown(
+    locator: PartLocator,
+    option?: Partial<MouseDownOption>,
+  ): Promise<void> {
+    await super.mouseDown(locator, option);
+    await this.flush();
+  }
+
+  async mouseUp(
+    locator: PartLocator,
+    option?: Partial<MouseUpOption>,
+  ): Promise<void> {
+    await super.mouseUp(locator, option);
+    await this.flush();
+  }
+
+  async mouseOver(
+    locator: PartLocator,
+    option?: Partial<HoverOption>,
+  ): Promise<void> {
+    await super.mouseOver(locator, option);
+    await this.flush();
+  }
+
+  async mouseOut(
+    locator: PartLocator,
+    option?: Partial<MouseOutOption>,
+  ): Promise<void> {
+    await super.mouseOut(locator, option);
+    await this.flush();
+  }
+
+  async mouseEnter(
+    locator: PartLocator,
+    option?: Partial<MouseEnterOption>,
+  ): Promise<void> {
+    await super.mouseEnter(locator, option);
+    await this.flush();
+  }
+
+  async mouseLeave(
+    locator: PartLocator,
+    option?: Partial<MouseLeaveOption>,
+  ): Promise<void> {
+    await super.mouseLeave(locator, option);
+    await this.flush();
+  }
+
+  async focus(locator: PartLocator, option?: Partial<FocusOption>): Promise<void> {
+    await super.focus(locator, option);
+    await this.flush();
+  }
+
+  override async selectOptionValue(
+    locator: PartLocator,
+    values: string[],
+  ): Promise<void> {
+    await super.selectOptionValue(locator, values);
+    await this.flush();
+  }
+
+  override async wait(ms: number): Promise<void> {
+    await super.wait(ms);
+    await this.flush();
+  }
+
+  override async waitUntilComponentState(
+    locator: PartLocator,
+    option: Partial<Readonly<WaitForOption>> = defaultWaitForOption,
+  ): Promise<void> {
+    await super.waitUntilComponentState(locator, option);
+    await this.flush();
+  }
+
+  override async waitUntil<T>(option: WaitUntilOption<T>): Promise<T> {
+    const result = await super.waitUntil(option);
+    await this.flush();
+    return result;
+  }
+
+  override clone(): Interactor {
+    return new VueInteractor();
+  }
+}

package/src/createTestEngine.ts

@@ -0,0 +1,79 @@
+import { byAttribute, ScenePart, TestEngine } from '@atomic-testing/core';
+import { render } from '@testing-library/vue';
+import { App, Component, createApp } from 'vue';
+
+import { VueInteractor } from './VueInteractor';
+import { IVueTestEngineOption } from './types';
+
+let _rootId = 0;
+function getNextRootElementId() {
+  return `${_rootId++}`;
+}
+
+const rootElementAttributeName = 'data-atomic-testing-vue';
+
+export function createTestEngine<T extends ScenePart>(
+  component: Component,
+  partDefinitions: T,
+  option?: Readonly<Partial<IVueTestEngineOption>>
+): TestEngine<T> {
+  const rootEl = option?.rootElement ?? document.body;
+  const container = rootEl.appendChild(document.createElement('div'));
+  const rootId = getNextRootElementId();
+  container.setAttribute(rootElementAttributeName, rootId);
+  
+  let unmount: () => void;
+  let app: App;
+  
+  try {
+    const renderResult = render(component, { container });
+    unmount = renderResult.unmount;
+  } catch (_error) {
+    // Fallback to manual Vue app creation if render fails
+    app = createApp(component);
+    app.mount(container);
+    unmount = () => {
+      if (app) {
+        app.unmount();
+      }
+    };
+  }
+
+  const cleanup = () => {
+    unmount();
+    rootEl.removeChild(container);
+    return Promise.resolve();
+  };
+
+  return new TestEngine(
+    byAttribute(rootElementAttributeName, rootId),
+    new VueInteractor(),
+    {
+      parts: partDefinitions,
+    },
+    cleanup
+  );
+}
+
+export function createRenderedTestEngine<T extends ScenePart>(
+  rootElement: HTMLElement,
+  partDefinitions: T,
+  _option?: Readonly<Partial<IVueTestEngineOption>>
+): TestEngine<T> {
+  const rootId = getNextRootElementId();
+  rootElement.setAttribute(rootElementAttributeName, rootId);
+
+  const cleanup = () => {
+    rootElement.removeAttribute(rootElementAttributeName);
+    return Promise.resolve();
+  };
+
+  return new TestEngine(
+    byAttribute(rootElementAttributeName, rootId),
+    new VueInteractor(),
+    {
+      parts: partDefinitions,
+    },
+    cleanup
+  );
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { createRenderedTestEngine, createTestEngine } from './createTestEngine';
+export { VueInteractor } from './VueInteractor';
+export type { IVueTestEngineOption } from './types';

package/src/types.ts

@@ -0,0 +1,5 @@
+import { IComponentDriverOption } from '@atomic-testing/core';
+
+export interface IVueTestEngineOption extends IComponentDriverOption {
+  rootElement?: Element;
+}