@zeus-js/testing 0.0.0-stage → 0.1.1-beta.14

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @zeus-js/testing
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Zeus 的官方测试工具，面向组件和应用测试提供稳定的公共入口，不要求测试代码导入 runtime-dom 或 signal 的 private subpath。
+
+```ts
+import {
+  fireEvent,
+  flushEffects,
+  queryByRole,
+  render,
+} from '@zeus-js/testing'
+
+const view = render(() => <button onClick={() => {}}>Save</button>)
+
+fireEvent.click(queryByRole(view.container, 'button', { name: 'Save' })!)
+await flushEffects()
+view.dispose()
+```
+
+`render` 返回当前容器、`dispose`/`unmount` 和 `rerender`。`fireEvent` 创建并派发 DOM 事件；`queryByRole` 支持显式 role 以及常用原生元素的隐式 role，并可按 accessible name 过滤。
+
+该包只依赖 `@zeus-js/zeus` 公共 API。它不提供网络、浏览器启动或快照功能；浏览器级测试继续使用项目的 Playwright/Puppeteer 配置。

package/dist/testing.cjs

@@ -0,0 +1,149 @@
+/**
+* testing v0.1.1-beta.14
+* (c) 2026 baicie
+* Released under the MIT License.
+**/
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _zeus_js_zeus = require("@zeus-js/zeus");
+//#region packages/core/testing/src/index.ts
+/** Mount a Zeus view into an isolated test container. */
+function render(value, options = {}) {
+	const document = getDocument();
+	const container = options.container ?? document.createElement("div");
+	const baseElement = container.ownerDocument?.body ?? container;
+	let dispose = (0, _zeus_js_zeus.render)(value, container);
+	const unmount = () => {
+		dispose();
+	};
+	return {
+		container,
+		baseElement,
+		dispose: unmount,
+		unmount,
+		rerender(nextValue) {
+			dispose();
+			dispose = (0, _zeus_js_zeus.render)(nextValue, container);
+		}
+	};
+}
+function getDocument() {
+	if (typeof globalThis.document === "undefined") throw new Error("@zeus-js/testing requires a DOM environment. Configure JSDOM or a browser test environment before rendering.");
+	return globalThis.document;
+}
+function fireEvent(element, eventOrType, init = {}) {
+	const event = typeof eventOrType === "string" ? createEvent(element.ownerDocument, eventOrType, init) : eventOrType;
+	return element.dispatchEvent(event);
+}
+(function(_fireEvent) {
+	function click(element, init) {
+		return fireEvent(element, "click", init);
+	}
+	_fireEvent.click = click;
+	function input(element, init) {
+		return fireEvent(element, "input", init);
+	}
+	_fireEvent.input = input;
+	function change(element, init) {
+		return fireEvent(element, "change", init);
+	}
+	_fireEvent.change = change;
+	function submit(element, init) {
+		return fireEvent(element, "submit", init);
+	}
+	_fireEvent.submit = submit;
+	function focus(element, init) {
+		return fireEvent(element, "focus", init);
+	}
+	_fireEvent.focus = focus;
+	function blur(element, init) {
+		return fireEvent(element, "blur", init);
+	}
+	_fireEvent.blur = blur;
+})(fireEvent || (fireEvent = {}));
+function createEvent(document, type, init) {
+	const EventConstructor = eventConstructor(type, document.defaultView);
+	const { bubbles = true, cancelable = true, composed = true, ...extra } = init;
+	const event = new EventConstructor(type, {
+		bubbles,
+		cancelable,
+		composed
+	});
+	for (const [key, value] of Object.entries(extra)) try {
+		Object.defineProperty(event, key, {
+			configurable: true,
+			enumerable: true,
+			value
+		});
+	} catch {}
+	return event;
+}
+function eventConstructor(type, window) {
+	if (!window) return globalThis.Event;
+	if (/^(click|dblclick|mousedown|mouseup|mousemove|mouseover|mouseout)$/.test(type)) return window.MouseEvent;
+	if (/^(input|change|beforeinput)$/.test(type)) return window.InputEvent;
+	if (/^(submit|reset)$/.test(type)) return window.Event;
+	if (/^(focus|blur|focusin|focusout)$/.test(type)) return window.FocusEvent;
+	if (type.startsWith("key")) return window.KeyboardEvent;
+	return window.Event;
+}
+/** Let queued microtasks and framework effects settle before assertions. */
+async function flushEffects() {
+	await Promise.resolve();
+	await new Promise((resolve) => queueMicrotask(resolve));
+}
+/** Find the first element with an explicit or implicit ARIA role. */
+function queryByRole(container, role, options = {}) {
+	return [...isElement(container) && hasRole(container, role) ? [container] : [], ...Array.from(container.querySelectorAll("*")).filter((element) => hasRole(element, role))].find((element) => {
+		const name = accessibleName(element);
+		return options.name === void 0 ? true : typeof options.name === "string" ? name === options.name : options.name.test(name);
+	}) ?? null;
+}
+function isElement(value) {
+	return "getAttribute" in value && typeof value.getAttribute === "function";
+}
+function hasRole(element, requestedRole) {
+	const explicitRole = element.getAttribute("role");
+	if (explicitRole) return explicitRole.split(/\s+/).includes(requestedRole);
+	const tag = element.tagName.toLowerCase();
+	if (requestedRole === "button") return tag === "button";
+	if (requestedRole === "link") return tag === "a" && element.hasAttribute("href");
+	if (requestedRole === "heading") return /^h[1-6]$/.test(tag);
+	if (requestedRole === "checkbox") return tag === "input" && element.getAttribute("type") === "checkbox";
+	if (requestedRole === "radio") return tag === "input" && element.getAttribute("type") === "radio";
+	if (requestedRole === "textbox") return tag === "textarea" || tag === "input" && ![
+		"button",
+		"checkbox",
+		"hidden",
+		"image",
+		"radio",
+		"range",
+		"reset",
+		"submit"
+	].includes(element.getAttribute("type") ?? "text");
+	if (requestedRole === "img") return tag === "img" && element.hasAttribute("alt");
+	if (requestedRole === "list") return tag === "ul" || tag === "ol";
+	if (requestedRole === "listitem") return tag === "li";
+	if (requestedRole === "option") return tag === "option";
+	return false;
+}
+function accessibleName(element) {
+	const labelledBy = element.getAttribute("aria-labelledby");
+	if (labelledBy) {
+		const document = element.ownerDocument;
+		return labelledBy.split(/\s+/).map((id) => document.getElementById(id)?.textContent ?? "").join(" ").trim();
+	}
+	return (element.getAttribute("aria-label") ?? element.getAttribute("alt") ?? element.getAttribute("title") ?? element.textContent ?? "").trim();
+}
+//#endregion
+Object.defineProperty(exports, "fireEvent", {
+	enumerable: true,
+	get: function() {
+		return fireEvent;
+	}
+});
+exports.flushEffects = flushEffects;
+exports.queryByRole = queryByRole;
+exports.render = render;

package/dist/testing.d.ts

@@ -0,0 +1,34 @@
+import { JSXValue } from '@zeus-js/zeus';
+
+export interface RenderResult {
+    container: HTMLElement;
+    baseElement: HTMLElement;
+    dispose: () => void;
+    unmount: () => void;
+    rerender: (value: JSXValue | (() => JSXValue)) => void;
+}
+export interface RenderTestOptions {
+    container?: HTMLElement;
+}
+/** Mount a Zeus view into an isolated test container. */
+export declare function render(value: JSXValue | (() => JSXValue), options?: RenderTestOptions): RenderResult;
+export type FireEventInit = EventInit & Record<string, unknown>;
+export declare function fireEvent(element: Element, event: Event): boolean;
+export declare function fireEvent(element: Element, type: string, init?: FireEventInit): boolean;
+declare namespace fireEvent {
+    function click(element: Element, init?: FireEventInit): boolean;
+    function input(element: Element, init?: FireEventInit): boolean;
+    function change(element: Element, init?: FireEventInit): boolean;
+    function submit(element: Element, init?: FireEventInit): boolean;
+    function focus(element: Element, init?: FireEventInit): boolean;
+    function blur(element: Element, init?: FireEventInit): boolean;
+}
+/** Let queued microtasks and framework effects settle before assertions. */
+export declare function flushEffects(): Promise<void>;
+export interface RoleQueryOptions {
+    name?: string | RegExp;
+}
+/** Find the first element with an explicit or implicit ARIA role. */
+export declare function queryByRole(container: ParentNode, role: string, options?: RoleQueryOptions): HTMLElement | null;
+
+

package/dist/testing.esm-bundler.js

@@ -0,0 +1,137 @@
+/**
+* testing v0.1.1-beta.14
+* (c) 2026 baicie
+* Released under the MIT License.
+**/
+import { render as render$1 } from "@zeus-js/zeus";
+//#region packages/core/testing/src/index.ts
+/** Mount a Zeus view into an isolated test container. */
+function render(value, options = {}) {
+	const document = getDocument();
+	const container = options.container ?? document.createElement("div");
+	const baseElement = container.ownerDocument?.body ?? container;
+	let dispose = render$1(value, container);
+	const unmount = () => {
+		dispose();
+	};
+	return {
+		container,
+		baseElement,
+		dispose: unmount,
+		unmount,
+		rerender(nextValue) {
+			dispose();
+			dispose = render$1(nextValue, container);
+		}
+	};
+}
+function getDocument() {
+	if (typeof globalThis.document === "undefined") throw new Error("@zeus-js/testing requires a DOM environment. Configure JSDOM or a browser test environment before rendering.");
+	return globalThis.document;
+}
+function fireEvent(element, eventOrType, init = {}) {
+	const event = typeof eventOrType === "string" ? createEvent(element.ownerDocument, eventOrType, init) : eventOrType;
+	return element.dispatchEvent(event);
+}
+(function(_fireEvent) {
+	function click(element, init) {
+		return fireEvent(element, "click", init);
+	}
+	_fireEvent.click = click;
+	function input(element, init) {
+		return fireEvent(element, "input", init);
+	}
+	_fireEvent.input = input;
+	function change(element, init) {
+		return fireEvent(element, "change", init);
+	}
+	_fireEvent.change = change;
+	function submit(element, init) {
+		return fireEvent(element, "submit", init);
+	}
+	_fireEvent.submit = submit;
+	function focus(element, init) {
+		return fireEvent(element, "focus", init);
+	}
+	_fireEvent.focus = focus;
+	function blur(element, init) {
+		return fireEvent(element, "blur", init);
+	}
+	_fireEvent.blur = blur;
+})(fireEvent || (fireEvent = {}));
+function createEvent(document, type, init) {
+	const EventConstructor = eventConstructor(type, document.defaultView);
+	const { bubbles = true, cancelable = true, composed = true, ...extra } = init;
+	const event = new EventConstructor(type, {
+		bubbles,
+		cancelable,
+		composed
+	});
+	for (const [key, value] of Object.entries(extra)) try {
+		Object.defineProperty(event, key, {
+			configurable: true,
+			enumerable: true,
+			value
+		});
+	} catch {}
+	return event;
+}
+function eventConstructor(type, window) {
+	if (!window) return globalThis.Event;
+	if (/^(click|dblclick|mousedown|mouseup|mousemove|mouseover|mouseout)$/.test(type)) return window.MouseEvent;
+	if (/^(input|change|beforeinput)$/.test(type)) return window.InputEvent;
+	if (/^(submit|reset)$/.test(type)) return window.Event;
+	if (/^(focus|blur|focusin|focusout)$/.test(type)) return window.FocusEvent;
+	if (type.startsWith("key")) return window.KeyboardEvent;
+	return window.Event;
+}
+/** Let queued microtasks and framework effects settle before assertions. */
+async function flushEffects() {
+	await Promise.resolve();
+	await new Promise((resolve) => queueMicrotask(resolve));
+}
+/** Find the first element with an explicit or implicit ARIA role. */
+function queryByRole(container, role, options = {}) {
+	return [...isElement(container) && hasRole(container, role) ? [container] : [], ...Array.from(container.querySelectorAll("*")).filter((element) => hasRole(element, role))].find((element) => {
+		const name = accessibleName(element);
+		return options.name === void 0 ? true : typeof options.name === "string" ? name === options.name : options.name.test(name);
+	}) ?? null;
+}
+function isElement(value) {
+	return "getAttribute" in value && typeof value.getAttribute === "function";
+}
+function hasRole(element, requestedRole) {
+	const explicitRole = element.getAttribute("role");
+	if (explicitRole) return explicitRole.split(/\s+/).includes(requestedRole);
+	const tag = element.tagName.toLowerCase();
+	if (requestedRole === "button") return tag === "button";
+	if (requestedRole === "link") return tag === "a" && element.hasAttribute("href");
+	if (requestedRole === "heading") return /^h[1-6]$/.test(tag);
+	if (requestedRole === "checkbox") return tag === "input" && element.getAttribute("type") === "checkbox";
+	if (requestedRole === "radio") return tag === "input" && element.getAttribute("type") === "radio";
+	if (requestedRole === "textbox") return tag === "textarea" || tag === "input" && ![
+		"button",
+		"checkbox",
+		"hidden",
+		"image",
+		"radio",
+		"range",
+		"reset",
+		"submit"
+	].includes(element.getAttribute("type") ?? "text");
+	if (requestedRole === "img") return tag === "img" && element.hasAttribute("alt");
+	if (requestedRole === "list") return tag === "ul" || tag === "ol";
+	if (requestedRole === "listitem") return tag === "li";
+	if (requestedRole === "option") return tag === "option";
+	return false;
+}
+function accessibleName(element) {
+	const labelledBy = element.getAttribute("aria-labelledby");
+	if (labelledBy) {
+		const document = element.ownerDocument;
+		return labelledBy.split(/\s+/).map((id) => document.getElementById(id)?.textContent ?? "").join(" ").trim();
+	}
+	return (element.getAttribute("aria-label") ?? element.getAttribute("alt") ?? element.getAttribute("title") ?? element.textContent ?? "").trim();
+}
+//#endregion
+export { fireEvent, flushEffects, queryByRole, render };

package/dist/testing.prod.cjs

@@ -0,0 +1,149 @@
+/**
+* testing v0.1.1-beta.14
+* (c) 2026 baicie
+* Released under the MIT License.
+**/
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _zeus_js_zeus = require("@zeus-js/zeus");
+//#region packages/core/testing/src/index.ts
+/** Mount a Zeus view into an isolated test container. */
+function render(value, options = {}) {
+	const document = getDocument();
+	const container = options.container ?? document.createElement("div");
+	const baseElement = container.ownerDocument?.body ?? container;
+	let dispose = (0, _zeus_js_zeus.render)(value, container);
+	const unmount = () => {
+		dispose();
+	};
+	return {
+		container,
+		baseElement,
+		dispose: unmount,
+		unmount,
+		rerender(nextValue) {
+			dispose();
+			dispose = (0, _zeus_js_zeus.render)(nextValue, container);
+		}
+	};
+}
+function getDocument() {
+	if (typeof globalThis.document === "undefined") throw new Error("@zeus-js/testing requires a DOM environment. Configure JSDOM or a browser test environment before rendering.");
+	return globalThis.document;
+}
+function fireEvent(element, eventOrType, init = {}) {
+	const event = typeof eventOrType === "string" ? createEvent(element.ownerDocument, eventOrType, init) : eventOrType;
+	return element.dispatchEvent(event);
+}
+(function(_fireEvent) {
+	function click(element, init) {
+		return fireEvent(element, "click", init);
+	}
+	_fireEvent.click = click;
+	function input(element, init) {
+		return fireEvent(element, "input", init);
+	}
+	_fireEvent.input = input;
+	function change(element, init) {
+		return fireEvent(element, "change", init);
+	}
+	_fireEvent.change = change;
+	function submit(element, init) {
+		return fireEvent(element, "submit", init);
+	}
+	_fireEvent.submit = submit;
+	function focus(element, init) {
+		return fireEvent(element, "focus", init);
+	}
+	_fireEvent.focus = focus;
+	function blur(element, init) {
+		return fireEvent(element, "blur", init);
+	}
+	_fireEvent.blur = blur;
+})(fireEvent || (fireEvent = {}));
+function createEvent(document, type, init) {
+	const EventConstructor = eventConstructor(type, document.defaultView);
+	const { bubbles = true, cancelable = true, composed = true, ...extra } = init;
+	const event = new EventConstructor(type, {
+		bubbles,
+		cancelable,
+		composed
+	});
+	for (const [key, value] of Object.entries(extra)) try {
+		Object.defineProperty(event, key, {
+			configurable: true,
+			enumerable: true,
+			value
+		});
+	} catch {}
+	return event;
+}
+function eventConstructor(type, window) {
+	if (!window) return globalThis.Event;
+	if (/^(click|dblclick|mousedown|mouseup|mousemove|mouseover|mouseout)$/.test(type)) return window.MouseEvent;
+	if (/^(input|change|beforeinput)$/.test(type)) return window.InputEvent;
+	if (/^(submit|reset)$/.test(type)) return window.Event;
+	if (/^(focus|blur|focusin|focusout)$/.test(type)) return window.FocusEvent;
+	if (type.startsWith("key")) return window.KeyboardEvent;
+	return window.Event;
+}
+/** Let queued microtasks and framework effects settle before assertions. */
+async function flushEffects() {
+	await Promise.resolve();
+	await new Promise((resolve) => queueMicrotask(resolve));
+}
+/** Find the first element with an explicit or implicit ARIA role. */
+function queryByRole(container, role, options = {}) {
+	return [...isElement(container) && hasRole(container, role) ? [container] : [], ...Array.from(container.querySelectorAll("*")).filter((element) => hasRole(element, role))].find((element) => {
+		const name = accessibleName(element);
+		return options.name === void 0 ? true : typeof options.name === "string" ? name === options.name : options.name.test(name);
+	}) ?? null;
+}
+function isElement(value) {
+	return "getAttribute" in value && typeof value.getAttribute === "function";
+}
+function hasRole(element, requestedRole) {
+	const explicitRole = element.getAttribute("role");
+	if (explicitRole) return explicitRole.split(/\s+/).includes(requestedRole);
+	const tag = element.tagName.toLowerCase();
+	if (requestedRole === "button") return tag === "button";
+	if (requestedRole === "link") return tag === "a" && element.hasAttribute("href");
+	if (requestedRole === "heading") return /^h[1-6]$/.test(tag);
+	if (requestedRole === "checkbox") return tag === "input" && element.getAttribute("type") === "checkbox";
+	if (requestedRole === "radio") return tag === "input" && element.getAttribute("type") === "radio";
+	if (requestedRole === "textbox") return tag === "textarea" || tag === "input" && ![
+		"button",
+		"checkbox",
+		"hidden",
+		"image",
+		"radio",
+		"range",
+		"reset",
+		"submit"
+	].includes(element.getAttribute("type") ?? "text");
+	if (requestedRole === "img") return tag === "img" && element.hasAttribute("alt");
+	if (requestedRole === "list") return tag === "ul" || tag === "ol";
+	if (requestedRole === "listitem") return tag === "li";
+	if (requestedRole === "option") return tag === "option";
+	return false;
+}
+function accessibleName(element) {
+	const labelledBy = element.getAttribute("aria-labelledby");
+	if (labelledBy) {
+		const document = element.ownerDocument;
+		return labelledBy.split(/\s+/).map((id) => document.getElementById(id)?.textContent ?? "").join(" ").trim();
+	}
+	return (element.getAttribute("aria-label") ?? element.getAttribute("alt") ?? element.getAttribute("title") ?? element.textContent ?? "").trim();
+}
+//#endregion
+Object.defineProperty(exports, "fireEvent", {
+	enumerable: true,
+	get: function() {
+		return fireEvent;
+	}
+});
+exports.flushEffects = flushEffects;
+exports.queryByRole = queryByRole;
+exports.render = render;

package/index.cjs

@@ -0,0 +1,7 @@
+'use strict'
+
+if (process.env.NODE_ENV === 'production') {
+  module.exports = require('./dist/testing.prod.cjs')
+} else {
+  module.exports = require('./dist/testing.cjs')
+}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@zeus-js/testing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "0.1.1-beta.14",
+  "description": "Official testing utilities for Zeus applications and components",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baicie/zeus",
+    "directory": "packages/core/testing"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/testing.d.ts",
+      "module": "./dist/testing.esm-bundler.js",
+      "import": "./dist/testing.esm-bundler.js",
+      "require": {
+        "production": "./dist/testing.prod.cjs",
+        "development": "./dist/testing.cjs",
+        "default": "./index.cjs"
+      }
+    }
+  },
+  "files": [
+    "index.cjs",
+    "dist"
+  ],
+  "dependencies": {
+    "@zeus-js/zeus": "0.1.1-beta.14"
+  },
+  "author": "Baicie",
+  "bugs": {
+    "url": "https://github.com/baicie/zeus/issues"
+  },
+  "buildOptions": {
+    "name": "ZeusTesting",
+    "formats": [
+      "esm-bundler",
+      "cjs"
+    ],
+    "target": "es2022"
+  },
+  "homepage": "https://github.com/baicie/zeus/tree/main/packages/core/testing#readme",
+  "keywords": [
+    "zeus",
+    "testing",
+    "vitest"
+  ],
+  "main": "index.cjs",
+  "module": "dist/testing.esm-bundler.js",
+  "types": "dist/testing.d.ts"
 }