@vickbk/tests 0.1.0 → 0.2.1

package/dist/vitest.mjs

@@ -1,460 +1,6 @@
-import { fireEvent as fireEvent$1, screen, within } from "@testing-library/react";
-import userEvent from "@testing-library/user-event";
-import { expect, vi } from "vitest";
-//#region src/features/vitest/modules/dom/modules/toggle-event/utils/togglePolyfill.ts
-/**
-* Creates the browser ToggleEvent instance used by the fireEvent.toggle polyfill.
-*
-* @param type - Event type to dispatch.
-* @param initDict - Optional toggle event initialization state.
-* @returns A ToggleEvent matching the requested state.
-* @example
-* ```ts
-* const event = createToggleEvent("toggle", {
-*   oldState: "closed",
-*   newState: "open",
-* });
-* ```
-*/
-function createToggleEvent(type, initDict = {
-	oldState: "closed",
-	newState: "open"
-}) {
-	if (typeof globalThis.ToggleEvent === "undefined") {
-		class ToggleEventPolyfill extends Event {
-			oldState;
-			newState;
-			source = null;
-			constructor(eventType, eventInitDict = {}) {
-				super(eventType, eventInitDict);
-				this.oldState = eventInitDict.oldState ?? "closed";
-				this.newState = eventInitDict.newState ?? "open";
-			}
-		}
-		globalThis.ToggleEvent = ToggleEventPolyfill;
-	}
-	return new globalThis.ToggleEvent(type, {
-		bubbles: false,
-		cancelable: false,
-		...initDict
-	});
-}
-/**
-* Polyfills `fireEvent.toggle` for tests by dispatching a native ToggleEvent.
-*
-* @param element - Element or window to dispatch the toggle event on.
-* @param initDict - Optional state values for the toggle transition.
-* @returns Whether the event dispatch completed successfully.
-* @example
-* ```ts
-* fireEvent.toggle(document.body, { newState: "open" });
-* ```
-*/
-function togglePolyfill(element, initDict = {
-	oldState: "closed",
-	newState: "open"
-}) {
-	const event = createToggleEvent("toggle", initDict);
-	return fireEvent$1(element, event);
-}
-//#endregion
-//#region src/features/vitest/modules/dom/modules/toggle-event/utils/fireEvent.ts
-const callableFireEvent = (...args) => fireEvent$1(...args);
-/**
-* Testing Library's fireEvent API with an additional `toggle` event helper.
-*
-* The exported object copies the standard `fireEvent` properties and adds
-* `toggle`, which dispatches the toggle event through `togglePolyfill`.
-* It does not install the extension onto Testing Library's original export.
-*
-* Standard Testing Library event helpers remain available, including
-* `click`, `change`, `input`, `submit`, `focus`, and keyboard/mouse events.
-*
-* @remarks
-* The `toggle` helper defaults to a transition from `closed` to `open`.
-* Call-specific configuration overrides those defaults. This helper does
-* not maintain state between calls.
-*
-* @example
-* ```ts
-* import { fireEvent } from "@vickbk/tests/vitest";
-*
-* const disclosure = document.querySelector("details")!;
-*
-* fireEvent.toggle(disclosure);
-* fireEvent.toggle(disclosure, { newState: "closed" });
-* ```
-*
-* @example
-* ```ts
-* import { fireEvent } from "@vickbk/tests/vitest";
-*
-* const button = document.querySelector("button")!;
-*
-* fireEvent.click(button);
-* ```
-*/
-const fireEvent = Object.assign(callableFireEvent, fireEvent$1, { 
-/**
-* Dispatches a toggle event using the toggle polyfill.
-*
-* @param element - The document, element, node, or window receiving the event.
-* @param initDict - Optional old/new state overrides for this dispatch.
-* @returns The result returned by `togglePolyfill`.
-*
-* @example
-* ```ts
-* fireEvent.toggle(document.body, {
-*   oldState: "closed",
-*   newState: "open",
-* });
-* ```
-*/
-toggle: (element, initDict) => togglePolyfill(element, {
-	oldState: "closed",
-	newState: "open",
-	...initDict
-}) });
-//#endregion
-//#region src/shared/regex/utils/escape-regex.ts
-function escapeRegExp(str) {
-	if (typeof RegExp.escape === "function") return RegExp.escape(str);
-	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-//#endregion
-//#region src/shared/regex/utils/pattern-to-regex.ts
-function patternToRegex(target, flags = "i") {
-	return typeof target === "string" ? new RegExp(escapeRegExp(target), flags) : target;
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/getSearchArea.ts
-/**
-* Returns the Testing Library query API for a container or the whole document.
-*
-* @param container Optional element to scope queries to.
-* @returns The scoped query API, or the global `screen` query API.
-* @example
-* ```ts
-* const queries = getSearchArea(formElement);
-* queries.getByRole("button", { name: "Submit" });
-* ```
-*/
-function getSearchArea(container) {
-	return container ? within(container) : screen;
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/clickLabelInput.ts
-/**
-* Simulates clicking an input found by its label or placeholder.
-*
-* @param label Label or placeholder text/regular expression identifying the input.
-* @param container Optional element that limits the input search.
-* @returns A promise that resolves after the click interaction completes.
-* @example
-* ```ts
-* await clickLabelInput("Email address");
-* ```
-*/
-async function clickLabelInput(label, container) {
-	const user = userEvent.setup();
-	const regex = patternToRegex(label);
-	const searchArea = getSearchArea(container);
-	const element = typeof label === "string" && label.length === 0 ? searchArea.queryByPlaceholderText(regex) || searchArea.getByLabelText(regex) : searchArea.queryByLabelText(regex) || searchArea.getByPlaceholderText(regex);
-	await user.click(element);
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/getCheckboxRadio.ts
-/**
-* Finds a checkbox or radio control by its accessible name.
-*
-* @param target Accessible name to match, as text or a regular expression.
-* @param container Optional element that limits the search.
-* @returns The matching checkbox or radio input.
-* @throws If neither a checkbox nor a radio control matches the target.
-* @example
-* ```ts
-* const consent = getCheckboxRadio("Accept terms");
-* expect(consent).toBeChecked();
-* ```
-*/
-function getCheckboxRadio(target, container) {
-	const regex = patternToRegex(target);
-	const searchArea = getSearchArea(container);
-	const element = searchArea.queryByRole("checkbox", { name: regex }) || searchArea.queryByRole("radio", { name: regex });
-	if (element) return element;
-	throw new Error(`Unable to find a checkbox or radio control named "${String(target)}".`);
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/isChecked.ts
-/**
-* Asserts that the radio button or checkbox matching the accessible name is checked.
-*
-* @param selector Accessible label text or regular expression for the control.
-* @param container Optional element that limits the control search.
-* @returns Nothing; throws an assertion error if the control is absent or unchecked.
-* @example
-* ```ts
-* isChecked("Accept terms");
-* ```
-*/
-function isChecked(selector, container) {
-	expect(getCheckboxRadio(selector, container)).toBeChecked();
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/isNotChecked.ts
-/**
-* Asserts that the radio button or checkbox matching the accessible name is unchecked.
-*
-* @param selector Accessible label text or regular expression for the control.
-* @param container Optional element that limits the control search.
-* @returns Nothing; throws an assertion error if the control is absent or checked.
-* @example
-* ```ts
-* isNotChecked("Subscribe to updates");
-* ```
-*/
-function isNotChecked(selector, container) {
-	expect(getCheckboxRadio(selector, container)).not.toBeChecked();
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/shouldHaveAttributes.ts
-/**
-* Asserts that an HTMLElement possesses the expected set of DOM attributes and values.
-*
-* Handles string/numeric values, boolean attributes (true = present, false = absent),
-* and null/undefined values (absent).
-*
-* @param element The DOM element whose attributes will be checked.
-* @param attributes Attribute names mapped to their expected values.
-* @returns Nothing; throws an assertion error when any attribute does not match.
-* @example
-* ```ts
-* shouldHaveAttributes(input, { required: true, "aria-label": "Email" });
-* ```
-*/
-function shouldHaveAttributes(element, attributes) {
-	Object.entries(attributes).forEach(([key, value]) => {
-		if (value === null || value === void 0 || value === false) expect(element).not.toHaveAttribute(key);
-		else if (value === true) expect(element).toHaveAttribute(key);
-		else expect(element).toHaveAttribute(key, String(value));
-	});
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/shouldHaveTestId.ts
-/**
-* Asserts that elements with all supplied test IDs are present in the document.
-*
-* @param ids One or more `data-testid` values to locate.
-* @returns The elements found, in the same order as the supplied IDs.
-* @example
-* ```ts
-* const [submitButton] = shouldHaveTestId("submit-button");
-* ```
-*/
-function shouldHaveTestId(...ids) {
-	const testElements = ids.map((id) => screen.getByTestId(id));
-	testElements.forEach((element) => expect(element).toBeInTheDocument());
-	return testElements;
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/shouldNotHaveTestId.ts
-/**
-* Asserts that elements with all supplied test IDs are absent from the document.
-*
-* @param ids One or more `data-testid` values to verify are absent.
-* @returns The query results (`null` for each absent element), in ID order.
-* @example
-* ```ts
-* shouldNotHaveTestId("loading-spinner");
-* ```
-*/
-function shouldNotHaveTestId(...ids) {
-	const testElements = ids.map((id) => screen.queryByTestId(id));
-	testElements.forEach((element) => expect(element).not.toBeInTheDocument());
-	return testElements;
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/shouldGetByText.ts
-/**
-* Creates assertion/element pairs for text matchers, supporting a zero-based occurrence index.
-*
-* @param texts Text strings, regular expressions, or `[matcher, occurrenceIndex]` pairs.
-* @returns Assertion and matching-element pairs, with `null` for missing text.
-* @example
-* ```ts
-* const [{ expected, element }] = shouldGetByText(["Item", 1]);
-* ```
-*/
-function shouldGetByText(...texts) {
-	return texts.map((text) => {
-		if (Array.isArray(text)) {
-			const [matcher, nth] = text;
-			const element = screen.queryAllByText(patternToRegex(matcher))[nth] ?? null;
-			return {
-				expected: expect(element),
-				element
-			};
-		}
-		const element = screen.queryByText(patternToRegex(text));
-		return {
-			expected: expect(element),
-			element
-		};
-	});
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/shouldNotSee.ts
-/**
-* Asserts that none of the supplied text matchers appear in the document.
-*
-* @param texts Text strings or regular expressions that must be absent.
-* @returns Nothing; throws an assertion error if any text is found.
-* @example
-* ```ts
-* shouldNotSee("Error", /failed/i);
-* ```
-*/
-const shouldNotSee = (...texts) => {
-	shouldGetByText(...texts).forEach(({ expected }) => expected.not.toBeInTheDocument());
-};
-//#endregion
-//#region src/features/vitest/modules/dom/utils/shouldSee.ts
-/**
-* Asserts that each requested text matcher is present in the document.
-*
-* @param texts Text strings, regular expressions, or `[matcher, occurrenceIndex]` pairs.
-* @returns The matching elements in the same order as the supplied matchers.
-* @example
-* ```ts
-* const [heading] = shouldSee("Welcome");
-* ```
-*/
-const shouldSee = (...texts) => {
-	return shouldGetByText(...texts).map(({ expected, element }) => {
-		expected.toBeInTheDocument();
-		return element;
-	});
-};
-//#endregion
-//#region src/features/vitest/modules/dom/utils/togglePopover.ts
-/**
-* Dispatches a toggle event on the first element matching a selector.
-*
-* @param options Selector, optional search container, and target open/closed state.
-* @returns The matched element, or `undefined` when no matching element exists.
-* @example
-* ```ts
-* const popover = togglePopover({ selector: "#help", newState: "open" });
-* ```
-*/
-function togglePopover({ container, selector, newState = "open" }) {
-	const element = (container ?? document).querySelector(selector);
-	if (!element) return;
-	fireEvent.toggle(element, { newState });
-	return element;
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/userClicks.ts
-/**
-* Simulates a user click on a button with the requested name, or matching text.
-*
-* @param target Button accessible name or text string/regular expression.
-* @param container Optional element that limits the target search.
-* @returns A promise that resolves after the click interaction completes.
-* @example
-* ```ts
-* await userClicks("Save");
-* ```
-*/
-const userClicks = async (target, container) => {
-	const user = userEvent.setup();
-	const regex = patternToRegex(target);
-	const searchArea = container ? within(container) : screen;
-	const element = searchArea.queryByRole("button", { name: regex }) || searchArea.getByText(regex);
-	await user.click(element);
-};
-//#endregion
-//#region src/features/vitest/modules/dom/utils/getTextBox.ts
-/**
-* Finds a text-entry control by its accessible name or placeholder.
-*
-* Supported controls are text-like inputs, textareas, and elements exposed
-* with the textbox role. A matching non-text element is rejected.
-*
-* @param target Accessible name or placeholder to match, as text or a regular expression.
-* @param container Optional element that limits the search.
-* @returns The matching textbox element.
-* @throws If no textbox matches, or a placeholder match is not a text-entry control.
-* @example
-* ```ts
-* const email = getTextBox("Email address");
-* const notes = getTextBox("Notes", dialog);
-* ```
-*/
-function getTextBox(target, container) {
-	const regex = patternToRegex(target);
-	const searchArea = getSearchArea(container);
-	const textBox = searchArea.queryByRole("textbox", { name: regex });
-	if (textBox) return textBox;
-	const placeholderMatch = searchArea.queryByPlaceholderText(regex);
-	if (placeholderMatch) {
-		const isTextInput = placeholderMatch instanceof HTMLInputElement && [
-			"text",
-			"search",
-			"email",
-			"url",
-			"tel",
-			"password"
-		].includes(placeholderMatch.type);
-		const isTextArea = placeholderMatch instanceof HTMLTextAreaElement;
-		const isContentEditable = placeholderMatch.getAttribute("contenteditable") === "true" && placeholderMatch.getAttribute("role") === "textbox";
-		if (isTextInput || isTextArea || isContentEditable) return placeholderMatch;
-		throw new Error(`Element matching placeholder "${String(target)}" is not a text-entry control.`);
-	}
-	return searchArea.getByRole("textbox", { name: regex });
-}
-//#endregion
-//#region src/features/vitest/modules/dom/utils/userTypes.ts
-/**
-* Replaces the value of a textbox found by its label, placeholder, or textbox name.
-*
-* @param target Accessible label, placeholder, or textbox name as text or a regex.
-* @param text Text to type after clearing the existing value.
-* @param container Optional element that limits the textbox search.
-* @param user User-event instance used for the interaction; defaults to a new instance.
-* @returns A promise resolving to the textbox that was updated.
-* @example
-* ```ts
-* const emailInput = await userTypes("Email", "person@example.com");
-* ```
-*/
-const userTypes = async (target, text, container, user = userEvent.setup()) => {
-	const element = getTextBox(target, container);
-	await user.clear(element);
-	if (text) await user.type(element, text);
-	return element;
-};
-//#endregion
-//#region src/features/vitest/modules/dom/utils/userTypesMultiple.ts
-/**
-* Replaces the values of multiple textboxes, located by their respective selectors.
-*
-* @param inputs Object mapping each textbox label/placeholder to the text to enter.
-* @param container Optional element that limits all textbox searches.
-* @returns A promise resolving to an object mapping each selector to its updated textbox.
-* @example
-* ```ts
-* const fields = await userTypesMultiple({ Email: "person@example.com", Name: "Pat" });
-* ```
-*/
-async function userTypesMultiple(inputs, container) {
-	const entries = Object.entries(inputs);
-	const outputs = {};
-	for (const [selector, value] of entries) outputs[selector] = await userTypes(selector, value, container);
-	return outputs;
-}
-//#endregion
-//#region src/features/vitest/modules/promises/utils/resolvedPromise.ts
+import { n as shutConsole, t as resetConsole } from "./console-Cf1taTRK.mjs";
+import { a as shouldSee, c as shouldHaveTestId, d as isChecked, f as clickLabelInput, i as togglePopover, l as shouldHaveAttributes, n as userTypes, o as shouldNotSee, p as fireEvent, r as userClicks, s as shouldNotHaveTestId, t as userTypesMultiple, u as isNotChecked } from "./dom-DeHbD1ni.mjs";
+//#region src/features/promises/utils/resolvedPromise.ts
 /**
 * Creates a fulfilled promise augmented with Vitest's fulfilled-promise metadata.
 *
@@ -466,7 +12,7 @@ async function userTypesMultiple(inputs, container) {
 * expect(payload).toEqual({ id: 1 });
 * ```
 */
-function resolvedPromise(value) {
+function resolvedPromise$1(value) {
 	const promise = Promise.resolve(value);
 	return Object.assign(promise, {
 		status: "fulfilled",
@@ -474,7 +20,7 @@ function resolvedPromise(value) {
 	});
 }
 //#endregion
-//#region src/features/vitest/modules/promises/utils/rejectedPromise.ts
+//#region src/features/promises/utils/rejectedPromise.ts
 /**
 * Creates a rejected promise augmented with Vitest's rejected-promise metadata.
 *
@@ -485,7 +31,7 @@ function resolvedPromise(value) {
 * await expect(rejectedPromise(new Error("Request failed"))).rejects.toThrow("Request failed");
 * ```
 */
-function rejectedPromise(reason = void 0) {
+function rejectedPromise$1(reason = void 0) {
 	const promise = Promise.reject(reason);
 	promise.catch((error) => error);
 	return Object.assign(promise, {
@@ -494,40 +40,17 @@ function rejectedPromise(reason = void 0) {
 	});
 }
 //#endregion
-//#region src/features/vitest/utils/console.ts
-const CONSOLES = [
-	"log",
-	"warn",
-	"error"
-];
-let activeSpies = [];
+//#region src/features/vitest/index.ts
 /**
-* Suppresses console.log, console.warn, and console.error until resetConsole runs.
-*
-* @example
-* ```ts
-* beforeEach(shutConsole);
-* afterEach(resetConsole);
-* ```
+* @deprecated Import `rejectedPromise` from `@vickbk/tests/promises` instead.
+* This re-export is retained for backward compatibility.
 */
-function shutConsole() {
-	resetConsole();
-	activeSpies = CONSOLES.map((cons) => vi.spyOn(console, cons).mockImplementation(() => {}));
-}
+const rejectedPromise = rejectedPromise$1;
 /**
-* Restores the console methods most recently suppressed by shutConsole.
-*
-* @example
-* ```ts
-* shutConsole();
-* // Run code whose console output should be ignored.
-* resetConsole();
-* ```
+* @deprecated Import `resolvedPromise` from `@vickbk/tests/promises` instead.
+* This re-export is retained for backward compatibility.
 */
-function resetConsole() {
-	for (const spy of activeSpies) spy.mockRestore();
-	activeSpies = [];
-}
+const resolvedPromise = resolvedPromise$1;
 //#endregion
 export { clickLabelInput, fireEvent, isChecked, isNotChecked, rejectedPromise, resetConsole, resolvedPromise, shouldHaveAttributes, shouldHaveTestId, shouldNotHaveTestId, shouldNotSee, shouldSee, shutConsole, togglePopover, userClicks, userTypes, userTypesMultiple };
 

package/dist/vitest.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.mjs","names":["fireEvent","rtlFireEvent"],"sources":["../src/features/vitest/modules/dom/modules/toggle-event/utils/togglePolyfill.ts","../src/features/vitest/modules/dom/modules/toggle-event/utils/fireEvent.ts","../src/shared/regex/utils/escape-regex.ts","../src/shared/regex/utils/pattern-to-regex.ts","../src/features/vitest/modules/dom/utils/getSearchArea.ts","../src/features/vitest/modules/dom/utils/clickLabelInput.ts","../src/features/vitest/modules/dom/utils/getCheckboxRadio.ts","../src/features/vitest/modules/dom/utils/isChecked.ts","../src/features/vitest/modules/dom/utils/isNotChecked.ts","../src/features/vitest/modules/dom/utils/shouldHaveAttributes.ts","../src/features/vitest/modules/dom/utils/shouldHaveTestId.ts","../src/features/vitest/modules/dom/utils/shouldNotHaveTestId.ts","../src/features/vitest/modules/dom/utils/shouldGetByText.ts","../src/features/vitest/modules/dom/utils/shouldNotSee.ts","../src/features/vitest/modules/dom/utils/shouldSee.ts","../src/features/vitest/modules/dom/utils/togglePopover.ts","../src/features/vitest/modules/dom/utils/userClicks.ts","../src/features/vitest/modules/dom/utils/getTextBox.ts","../src/features/vitest/modules/dom/utils/userTypes.ts","../src/features/vitest/modules/dom/utils/userTypesMultiple.ts","../src/features/vitest/modules/promises/utils/resolvedPromise.ts","../src/features/vitest/modules/promises/utils/rejectedPromise.ts","../src/features/vitest/utils/console.ts"],"sourcesContent":["import { fireEvent } from \"@testing-library/react\";\r\nimport type { ToggleConfig } from \"./types\";\r\n\r\n/**\r\n * Creates the browser ToggleEvent instance used by the fireEvent.toggle polyfill.\r\n *\r\n * @param type - Event type to dispatch.\r\n * @param initDict - Optional toggle event initialization state.\r\n * @returns A ToggleEvent matching the requested state.\r\n * @example\r\n * ```ts\r\n * const event = createToggleEvent(\"toggle\", {\r\n *   oldState: \"closed\",\r\n *   newState: \"open\",\r\n * });\r\n * ```\r\n */\r\nexport function createToggleEvent(\r\n  type: string,\r\n  initDict: Partial<ToggleConfig> = {\r\n    oldState: \"closed\",\r\n    newState: \"open\",\r\n  },\r\n): ToggleEvent {\r\n  if (typeof globalThis.ToggleEvent === \"undefined\") {\r\n    class ToggleEventPolyfill extends Event {\r\n      oldState: string;\r\n      newState: string;\r\n      source: Element | null = null;\r\n\r\n      constructor(eventType: string, eventInitDict: ToggleEventInit = {}) {\r\n        super(eventType, eventInitDict);\r\n        this.oldState = (eventInitDict as Partial<ToggleConfig>).oldState ?? \"closed\";\r\n        this.newState = (eventInitDict as Partial<ToggleConfig>).newState ?? \"open\";\r\n      }\r\n    }\r\n\r\n    globalThis.ToggleEvent = ToggleEventPolyfill as typeof ToggleEvent;\r\n  }\r\n\r\n  return new globalThis.ToggleEvent(type, {\r\n    bubbles: false,\r\n    cancelable: false,\r\n    ...initDict,\r\n  });\r\n}\r\n\r\n/**\r\n * Polyfills `fireEvent.toggle` for tests by dispatching a native ToggleEvent.\r\n *\r\n * @param element - Element or window to dispatch the toggle event on.\r\n * @param initDict - Optional state values for the toggle transition.\r\n * @returns Whether the event dispatch completed successfully.\r\n * @example\r\n * ```ts\r\n * fireEvent.toggle(document.body, { newState: \"open\" });\r\n * ```\r\n */\r\nexport function togglePolyfill(\r\n  element: Document | Element | Node | Window,\r\n  initDict: Partial<ToggleConfig> = {\r\n    oldState: \"closed\",\r\n    newState: \"open\",\r\n  },\r\n): boolean {\r\n  const event = createToggleEvent(\"toggle\", initDict);\r\n  return fireEvent(element, event);\r\n}\r\n","import { fireEvent as rtlFireEvent } from \"@testing-library/react\";\r\nimport { togglePolyfill } from \"./togglePolyfill\";\r\nimport type { ToggleConfig, ToggleFireEventExtensions } from \"./types\";\r\n\r\nconst callableFireEvent = (...args: Parameters<typeof rtlFireEvent>) =>\r\n  rtlFireEvent(...args);\r\n/**\r\n * Testing Library's fireEvent API with an additional `toggle` event helper.\r\n *\r\n * The exported object copies the standard `fireEvent` properties and adds\r\n * `toggle`, which dispatches the toggle event through `togglePolyfill`.\r\n * It does not install the extension onto Testing Library's original export.\r\n *\r\n * Standard Testing Library event helpers remain available, including\r\n * `click`, `change`, `input`, `submit`, `focus`, and keyboard/mouse events.\r\n *\r\n * @remarks\r\n * The `toggle` helper defaults to a transition from `closed` to `open`.\r\n * Call-specific configuration overrides those defaults. This helper does\r\n * not maintain state between calls.\r\n *\r\n * @example\r\n * ```ts\r\n * import { fireEvent } from \"@vickbk/tests/vitest\";\r\n *\r\n * const disclosure = document.querySelector(\"details\")!;\r\n *\r\n * fireEvent.toggle(disclosure);\r\n * fireEvent.toggle(disclosure, { newState: \"closed\" });\r\n * ```\r\n *\r\n * @example\r\n * ```ts\r\n * import { fireEvent } from \"@vickbk/tests/vitest\";\r\n *\r\n * const button = document.querySelector(\"button\")!;\r\n *\r\n * fireEvent.click(button);\r\n * ```\r\n */\r\nexport const fireEvent = Object.assign(callableFireEvent, rtlFireEvent, {\r\n  /**\r\n   * Dispatches a toggle event using the toggle polyfill.\r\n   *\r\n   * @param element - The document, element, node, or window receiving the event.\r\n   * @param initDict - Optional old/new state overrides for this dispatch.\r\n   * @returns The result returned by `togglePolyfill`.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * fireEvent.toggle(document.body, {\r\n   *   oldState: \"closed\",\r\n   *   newState: \"open\",\r\n   * });\r\n   * ```\r\n   */\r\n  toggle: (\r\n    element: Document | Element | Node | Window,\r\n    initDict?: Partial<ToggleConfig>,\r\n  ) =>\r\n    togglePolyfill(element, {\r\n      oldState: \"closed\",\r\n      newState: \"open\",\r\n      ...initDict,\r\n    }),\r\n}) as typeof rtlFireEvent & ToggleFireEventExtensions;\r\n","export function escapeRegExp(str: string): string {\r\n  if (typeof RegExp.escape === \"function\") {\r\n    return RegExp.escape(str);\r\n  }\r\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { TEXT_PATTERN } from \"../types\";\r\nimport { escapeRegExp } from \"./escape-regex\";\r\n\r\nexport function patternToRegex(\r\n  target: TEXT_PATTERN,\r\n  flags: string = \"i\",\r\n): RegExp {\r\n  return typeof target === \"string\"\r\n    ? new RegExp(escapeRegExp(target), flags)\r\n    : target;\r\n}\r\n","import { screen, within } from \"@testing-library/react\";\r\n\r\n/**\r\n * Returns the Testing Library query API for a container or the whole document.\r\n *\r\n * @param container Optional element to scope queries to.\r\n * @returns The scoped query API, or the global `screen` query API.\r\n * @example\r\n * ```ts\r\n * const queries = getSearchArea(formElement);\r\n * queries.getByRole(\"button\", { name: \"Submit\" });\r\n * ```\r\n */\r\nexport function getSearchArea(container?: HTMLElement) {\r\n  return container ? within(container) : screen;\r\n}\r\n","import type { TEXT_PATTERN } from \"@/shared/regex\";\r\nimport { patternToRegex } from \"@/shared/regex\";\r\nimport userEvent from \"@testing-library/user-event\";\r\nimport { getSearchArea } from \"./getSearchArea\";\r\n\r\n/**\r\n * Simulates clicking an input found by its label or placeholder.\r\n *\r\n * @param label Label or placeholder text/regular expression identifying the input.\r\n * @param container Optional element that limits the input search.\r\n * @returns A promise that resolves after the click interaction completes.\r\n * @example\r\n * ```ts\r\n * await clickLabelInput(\"Email address\");\r\n * ```\r\n */\r\nexport async function clickLabelInput(\r\n  label: TEXT_PATTERN,\r\n  container?: HTMLElement,\r\n) {\r\n  const user = userEvent.setup();\r\n  const regex = patternToRegex(label);\r\n  const searchArea = getSearchArea(container);\r\n  const element =\r\n    typeof label === \"string\" && label.length === 0\r\n      ? searchArea.queryByPlaceholderText(regex) ||\r\n        searchArea.getByLabelText(regex)\r\n      : searchArea.queryByLabelText(regex) ||\r\n        searchArea.getByPlaceholderText(regex);\r\n  await user.click(element);\r\n}\r\n","import type { TEXT_PATTERN } from \"@/shared/regex\";\r\nimport { patternToRegex } from \"@/shared/regex\";\r\nimport { getSearchArea } from \"./getSearchArea\";\r\n\r\n/**\r\n * Finds a checkbox or radio control by its accessible name.\r\n *\r\n * @param target Accessible name to match, as text or a regular expression.\r\n * @param container Optional element that limits the search.\r\n * @returns The matching checkbox or radio input.\r\n * @throws If neither a checkbox nor a radio control matches the target.\r\n * @example\r\n * ```ts\r\n * const consent = getCheckboxRadio(\"Accept terms\");\r\n * expect(consent).toBeChecked();\r\n * ```\r\n */\r\nexport function getCheckboxRadio(\r\n  target: TEXT_PATTERN,\r\n  container?: HTMLElement,\r\n) {\r\n  const regex = patternToRegex(target);\r\n  const searchArea = getSearchArea(container);\r\n  const element =\r\n    searchArea.queryByRole(\"checkbox\", { name: regex }) ||\r\n    searchArea.queryByRole(\"radio\", { name: regex });\r\n\r\n  if (element) return element;\r\n\r\n  throw new Error(\r\n    `Unable to find a checkbox or radio control named \"${String(target)}\".`,\r\n  );\r\n}\r\n","import type { TEXT_PATTERN } from \"@/shared/regex\";\r\nimport { expect } from \"vitest\";\r\nimport { getCheckboxRadio } from \"./getCheckboxRadio\";\r\n\r\n/**\r\n * Asserts that the radio button or checkbox matching the accessible name is checked.\r\n *\r\n * @param selector Accessible label text or regular expression for the control.\r\n * @param container Optional element that limits the control search.\r\n * @returns Nothing; throws an assertion error if the control is absent or unchecked.\r\n * @example\r\n * ```ts\r\n * isChecked(\"Accept terms\");\r\n * ```\r\n */\r\nexport function isChecked(selector: TEXT_PATTERN, container?: HTMLElement) {\r\n  expect(getCheckboxRadio(selector, container)).toBeChecked();\r\n}\r\n","import type { TEXT_PATTERN } from \"@/shared/regex\";\r\nimport { expect } from \"vitest\";\r\nimport { getCheckboxRadio } from \"./getCheckboxRadio\";\r\n\r\n/**\r\n * Asserts that the radio button or checkbox matching the accessible name is unchecked.\r\n *\r\n * @param selector Accessible label text or regular expression for the control.\r\n * @param container Optional element that limits the control search.\r\n * @returns Nothing; throws an assertion error if the control is absent or checked.\r\n * @example\r\n * ```ts\r\n * isNotChecked(\"Subscribe to updates\");\r\n * ```\r\n */\r\nexport function isNotChecked(selector: TEXT_PATTERN, container?: HTMLElement) {\r\n  expect(getCheckboxRadio(selector, container)).not.toBeChecked();\r\n}\r\n","import { expect } from \"vitest\";\r\n\r\n/**\r\n * Asserts that an HTMLElement possesses the expected set of DOM attributes and values.\r\n *\r\n * Handles string/numeric values, boolean attributes (true = present, false = absent),\r\n * and null/undefined values (absent).\r\n *\r\n * @param element The DOM element whose attributes will be checked.\r\n * @param attributes Attribute names mapped to their expected values.\r\n * @returns Nothing; throws an assertion error when any attribute does not match.\r\n * @example\r\n * ```ts\r\n * shouldHaveAttributes(input, { required: true, \"aria-label\": \"Email\" });\r\n * ```\r\n */\r\nexport function shouldHaveAttributes(\r\n  element: HTMLElement,\r\n  attributes: Record<string, unknown>,\r\n): void {\r\n  Object.entries(attributes).forEach(([key, value]) => {\r\n    if (value === null || value === undefined || value === false) {\r\n      expect(element).not.toHaveAttribute(key);\r\n    } else if (value === true) {\r\n      expect(element).toHaveAttribute(key);\r\n    } else {\r\n      expect(element).toHaveAttribute(key, String(value));\r\n    }\r\n  });\r\n}\r\n","import { screen } from \"@testing-library/react\";\r\nimport { expect } from \"vitest\";\r\n\r\n/**\r\n * Asserts that elements with all supplied test IDs are present in the document.\r\n *\r\n * @param ids One or more `data-testid` values to locate.\r\n * @returns The elements found, in the same order as the supplied IDs.\r\n * @example\r\n * ```ts\r\n * const [submitButton] = shouldHaveTestId(\"submit-button\");\r\n * ```\r\n */\r\nexport function shouldHaveTestId(...ids: string[]) {\r\n  const testElements = ids.map((id) => screen.getByTestId(id));\r\n\r\n  testElements.forEach((element) => expect(element).toBeInTheDocument());\r\n  return testElements;\r\n}\r\n","import { screen } from \"@testing-library/react\";\r\nimport { expect } from \"vitest\";\r\n\r\n/**\r\n * Asserts that elements with all supplied test IDs are absent from the document.\r\n *\r\n * @param ids One or more `data-testid` values to verify are absent.\r\n * @returns The query results (`null` for each absent element), in ID order.\r\n * @example\r\n * ```ts\r\n * shouldNotHaveTestId(\"loading-spinner\");\r\n * ```\r\n */\r\nexport function shouldNotHaveTestId(...ids: string[]) {\r\n  const testElements = ids.map((id) => screen.queryByTestId(id));\r\n\r\n  testElements.forEach((element) => expect(element).not.toBeInTheDocument());\r\n  return testElements;\r\n}\r\n","import type { TEXT_MATCHER } from \"@/shared/regex\";\r\nimport { patternToRegex } from \"@/shared/regex\";\r\nimport { screen } from \"@testing-library/react\";\r\nimport { expect } from \"vitest\";\r\n\r\n/**\r\n * Creates assertion/element pairs for text matchers, supporting a zero-based occurrence index.\r\n *\r\n * @param texts Text strings, regular expressions, or `[matcher, occurrenceIndex]` pairs.\r\n * @returns Assertion and matching-element pairs, with `null` for missing text.\r\n * @example\r\n * ```ts\r\n * const [{ expected, element }] = shouldGetByText([\"Item\", 1]);\r\n * ```\r\n */\r\nexport function shouldGetByText(...texts: TEXT_MATCHER[]) {\r\n  return texts.map((text) => {\r\n    if (Array.isArray(text)) {\r\n      const [matcher, nth] = text;\r\n      const element =\r\n        screen.queryAllByText(patternToRegex(matcher))[nth] ?? null;\r\n      return { expected: expect(element), element };\r\n    }\r\n    const element = screen.queryByText(patternToRegex(text));\r\n    return { expected: expect(element), element };\r\n  });\r\n}\r\n","import { shouldGetByText } from \"./shouldGetByText\";\r\n\r\n/**\r\n * Asserts that none of the supplied text matchers appear in the document.\r\n *\r\n * @param texts Text strings or regular expressions that must be absent.\r\n * @returns Nothing; throws an assertion error if any text is found.\r\n * @example\r\n * ```ts\r\n * shouldNotSee(\"Error\", /failed/i);\r\n * ```\r\n */\r\nexport const shouldNotSee = (...texts: (string | RegExp)[]) => {\r\n  shouldGetByText(...texts).forEach(({ expected }) =>\r\n    expected.not.toBeInTheDocument(),\r\n  );\r\n};\r\n","import type { TEXT_MATCHER } from \"@/shared/regex\";\r\nimport { shouldGetByText } from \"./shouldGetByText\";\r\n\r\n/**\r\n * Asserts that each requested text matcher is present in the document.\r\n *\r\n * @param texts Text strings, regular expressions, or `[matcher, occurrenceIndex]` pairs.\r\n * @returns The matching elements in the same order as the supplied matchers.\r\n * @example\r\n * ```ts\r\n * const [heading] = shouldSee(\"Welcome\");\r\n * ```\r\n */\r\nexport const shouldSee = (...texts: TEXT_MATCHER[]) => {\r\n  return shouldGetByText(...texts).map(({ expected, element }) => {\r\n    expected.toBeInTheDocument();\r\n    return element!;\r\n  });\r\n};\r\n","import { fireEvent, type ToggleState } from \"../modules/toggle-event\";\r\n\r\n/**\r\n * Dispatches a toggle event on the first element matching a selector.\r\n *\r\n * @param options Selector, optional search container, and target open/closed state.\r\n * @returns The matched element, or `undefined` when no matching element exists.\r\n * @example\r\n * ```ts\r\n * const popover = togglePopover({ selector: \"#help\", newState: \"open\" });\r\n * ```\r\n */\r\nexport function togglePopover({\r\n  container,\r\n  selector,\r\n  newState = \"open\",\r\n}: {\r\n  container?: HTMLElement;\r\n  selector: string;\r\n  newState?: ToggleState;\r\n}) {\r\n  const element = (container ?? document).querySelector(selector);\r\n  if (!element) return;\r\n  fireEvent.toggle(element, { newState });\r\n  return element;\r\n}\r\n","import { patternToRegex } from \"@/shared/regex\";\r\nimport { screen, within } from \"@testing-library/react\";\r\nimport userEvent from \"@testing-library/user-event\";\r\n\r\n/**\r\n * Simulates a user click on a button with the requested name, or matching text.\r\n *\r\n * @param target Button accessible name or text string/regular expression.\r\n * @param container Optional element that limits the target search.\r\n * @returns A promise that resolves after the click interaction completes.\r\n * @example\r\n * ```ts\r\n * await userClicks(\"Save\");\r\n * ```\r\n */\r\nexport const userClicks = async (\r\n  target: string | RegExp,\r\n  container?: HTMLElement,\r\n) => {\r\n  const user = userEvent.setup();\r\n  const regex = patternToRegex(target);\r\n  const searchArea = container ? within(container) : screen;\r\n  const element =\r\n    searchArea.queryByRole(\"button\", { name: regex }) ||\r\n    searchArea.getByText(regex);\r\n\r\n  await user.click(element);\r\n};\r\n","import { patternToRegex, TEXT_PATTERN } from \"@/shared/regex\";\r\nimport { getSearchArea } from \"./getSearchArea\";\r\n\r\n/**\r\n * Finds a text-entry control by its accessible name or placeholder.\r\n *\r\n * Supported controls are text-like inputs, textareas, and elements exposed\r\n * with the textbox role. A matching non-text element is rejected.\r\n *\r\n * @param target Accessible name or placeholder to match, as text or a regular expression.\r\n * @param container Optional element that limits the search.\r\n * @returns The matching textbox element.\r\n * @throws If no textbox matches, or a placeholder match is not a text-entry control.\r\n * @example\r\n * ```ts\r\n * const email = getTextBox(\"Email address\");\r\n * const notes = getTextBox(\"Notes\", dialog);\r\n * ```\r\n */\r\nexport function getTextBox(target: TEXT_PATTERN, container?: HTMLElement) {\r\n  const regex = patternToRegex(target);\r\n  const searchArea = getSearchArea(container);\r\n  const textBox = searchArea.queryByRole(\"textbox\", { name: regex });\r\n\r\n  if (textBox) return textBox;\r\n\r\n  const placeholderMatch = searchArea.queryByPlaceholderText(regex);\r\n  if (placeholderMatch) {\r\n    const isTextInput =\r\n      placeholderMatch instanceof HTMLInputElement &&\r\n      [\"text\", \"search\", \"email\", \"url\", \"tel\", \"password\"].includes(\r\n        placeholderMatch.type,\r\n      );\r\n    const isTextArea = placeholderMatch instanceof HTMLTextAreaElement;\r\n    const isContentEditable =\r\n      placeholderMatch.getAttribute(\"contenteditable\") === \"true\" &&\r\n      placeholderMatch.getAttribute(\"role\") === \"textbox\";\r\n\r\n    if (isTextInput || isTextArea || isContentEditable) return placeholderMatch;\r\n\r\n    throw new Error(\r\n      `Element matching placeholder \"${String(target)}\" is not a text-entry control.`,\r\n    );\r\n  }\r\n\r\n  return searchArea.getByRole(\"textbox\", { name: regex });\r\n}\r\n","import { TEXT_PATTERN } from \"@/shared/regex\";\r\nimport userEvent from \"@testing-library/user-event\";\r\nimport { getTextBox } from \"./getTextBox\";\r\n\r\n/**\r\n * Replaces the value of a textbox found by its label, placeholder, or textbox name.\r\n *\r\n * @param target Accessible label, placeholder, or textbox name as text or a regex.\r\n * @param text Text to type after clearing the existing value.\r\n * @param container Optional element that limits the textbox search.\r\n * @param user User-event instance used for the interaction; defaults to a new instance.\r\n * @returns A promise resolving to the textbox that was updated.\r\n * @example\r\n * ```ts\r\n * const emailInput = await userTypes(\"Email\", \"person@example.com\");\r\n * ```\r\n */\r\nexport const userTypes = async (\r\n  target: TEXT_PATTERN,\r\n  text: string,\r\n  container?: HTMLElement,\r\n  user = userEvent.setup(),\r\n) => {\r\n  const element = getTextBox(target, container);\r\n\r\n  await user.clear(element);\r\n  if (text) await user.type(element, text);\r\n  return element;\r\n};\r\n","import { userTypes } from \"./userTypes\";\r\n\r\n/**\r\n * Replaces the values of multiple textboxes, located by their respective selectors.\r\n *\r\n * @param inputs Object mapping each textbox label/placeholder to the text to enter.\r\n * @param container Optional element that limits all textbox searches.\r\n * @returns A promise resolving to an object mapping each selector to its updated textbox.\r\n * @example\r\n * ```ts\r\n * const fields = await userTypesMultiple({ Email: \"person@example.com\", Name: \"Pat\" });\r\n * ```\r\n */\r\nexport async function userTypesMultiple(\r\n  inputs: Record<string, string>,\r\n  container?: HTMLElement,\r\n) {\r\n  const entries = Object.entries(inputs);\r\n  const outputs: Record<keyof typeof inputs, HTMLElement> = {};\r\n\r\n  for (const [selector, value] of entries) {\r\n    outputs[selector] = await userTypes(selector, value, container);\r\n  }\r\n\r\n  return outputs;\r\n}\r\n","/**\r\n * Creates a fulfilled promise augmented with Vitest's fulfilled-promise metadata.\r\n *\r\n * @param value The value with which the promise is fulfilled.\r\n * @returns A fulfilled Promise<T> with `status: \"fulfilled\"` and its `value`.\r\n * @example\r\n * ```ts\r\n * const payload = await resolvedPromise({ id: 1 });\r\n * expect(payload).toEqual({ id: 1 });\r\n * ```\r\n */\r\nexport function resolvedPromise<T>(\r\n  value: T,\r\n): Promise<T> & { status: \"fulfilled\"; value: T } {\r\n  const promise = Promise.resolve(value);\r\n  return Object.assign(promise, { status: \"fulfilled\" as const, value });\r\n}\r\n","/**\r\n * Creates a rejected promise augmented with Vitest's rejected-promise metadata.\r\n *\r\n * @param reason The rejection reason, preserved as an unknown value; defaults to `undefined`.\r\n * @returns A rejected Promise<never> with `status: \"rejected\"` and its `reason`.\r\n * @example\r\n * ```ts\r\n * await expect(rejectedPromise(new Error(\"Request failed\"))).rejects.toThrow(\"Request failed\");\r\n * ```\r\n */\r\nexport function rejectedPromise(\r\n  reason: unknown = undefined,\r\n): Promise<never> & { status: \"rejected\"; reason: unknown } {\r\n  const promise = Promise.reject<never>(reason);\r\n\r\n  promise.catch((error) => error);\r\n\r\n  return Object.assign(promise, { status: \"rejected\" as const, reason });\r\n}\r\n","import { MockInstance, vi } from \"vitest\";\r\n\r\nconst CONSOLES = [\"log\", \"warn\", \"error\"] as const;\r\n\r\nlet activeSpies: MockInstance[] = [];\r\n\r\n/**\r\n * Suppresses console.log, console.warn, and console.error until resetConsole runs.\r\n *\r\n * @example\r\n * ```ts\r\n * beforeEach(shutConsole);\r\n * afterEach(resetConsole);\r\n * ```\r\n */\r\nexport function shutConsole() {\r\n  resetConsole();\r\n\r\n  activeSpies = CONSOLES.map((cons) =>\r\n    vi.spyOn(console, cons).mockImplementation(() => {}),\r\n  );\r\n}\r\n\r\n/**\r\n * Restores the console methods most recently suppressed by shutConsole.\r\n *\r\n * @example\r\n * ```ts\r\n * shutConsole();\r\n * // Run code whose console output should be ignored.\r\n * resetConsole();\r\n * ```\r\n */\r\nexport function resetConsole() {\r\n  for (const spy of activeSpies) {\r\n    spy.mockRestore(); // Restores native console behavior\r\n  }\r\n  activeSpies = [];\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"vitest.mjs","names":["resolvedPromise","rejectedPromise","_rejectedPromise","_resolvedPromise"],"sources":["../src/features/promises/utils/resolvedPromise.ts","../src/features/promises/utils/rejectedPromise.ts","../src/features/vitest/index.ts"],"sourcesContent":["/**\n * Creates a fulfilled promise augmented with Vitest's fulfilled-promise metadata.\n *\n * @param value The value with which the promise is fulfilled.\n * @returns A fulfilled Promise<T> with `status: \"fulfilled\"` and its `value`.\n * @example\n * ```ts\n * const payload = await resolvedPromise({ id: 1 });\n * expect(payload).toEqual({ id: 1 });\n * ```\n */\nexport function resolvedPromise<T>(\n  value: T,\n): Promise<T> & { status: \"fulfilled\"; value: T } {\n  const promise = Promise.resolve(value);\n  return Object.assign(promise, { status: \"fulfilled\" as const, value });\n}\n","/**\n * Creates a rejected promise augmented with Vitest's rejected-promise metadata.\n *\n * @param reason The rejection reason, preserved as an unknown value; defaults to `undefined`.\n * @returns A rejected Promise<never> with `status: \"rejected\"` and its `reason`.\n * @example\n * ```ts\n * await expect(rejectedPromise(new Error(\"Request failed\"))).rejects.toThrow(\"Request failed\");\n * ```\n */\nexport function rejectedPromise(\n  reason: unknown = undefined,\n): Promise<never> & { status: \"rejected\"; reason: unknown } {\n  const promise = Promise.reject<never>(reason);\n\n  promise.catch((error) => error);\n\n  return Object.assign(promise, { status: \"rejected\" as const, reason });\n}\n","/* eslint-disable boundaries/dependencies */\nexport * from \"./modules/console\";\nexport * from \"./modules/dom\";\n\nimport {\n  rejectedPromise as _rejectedPromise,\n  resolvedPromise as _resolvedPromise,\n} from \"@/features/promises\";\n\n/**\n * @deprecated Import `rejectedPromise` from `@vickbk/tests/promises` instead.\n * This re-export is retained for backward compatibility.\n */\nexport const rejectedPromise = _rejectedPromise;\n\n/**\n * @deprecated Import `resolvedPromise` from `@vickbk/tests/promises` instead.\n * This re-export is retained for backward compatibility.\n */\nexport const resolvedPromise = _resolvedPromise;\n"],"mappings":";;;;;;;;;;;;;;AAWA,SAAgBA,kBACd,OACgD;CAChD,MAAM,UAAU,QAAQ,QAAQ,KAAK;CACrC,OAAO,OAAO,OAAO,SAAS;EAAE,QAAQ;EAAsB;CAAM,CAAC;AACvE;;;;;;;;;;;;;ACNA,SAAgBC,kBACd,SAAkB,KAAA,GACwC;CAC1D,MAAM,UAAU,QAAQ,OAAc,MAAM;CAE5C,QAAQ,OAAO,UAAU,KAAK;CAE9B,OAAO,OAAO,OAAO,SAAS;EAAE,QAAQ;EAAqB;CAAO,CAAC;AACvE;;;;;;;ACLA,MAAa,kBAAkBC;;;;;AAM/B,MAAa,kBAAkBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vickbk/tests",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Testing helpers for Vitest and Playwright.",
   "publishConfig": {
     "access": "public"
@@ -49,6 +49,28 @@
         "default": "./dist/vitest.mjs"
       }
     },
+    "./vitest/console": {
+      "import": {
+        "types": "./dist/vitest/console.d.mts",
+        "default": "./dist/vitest/console.mjs"
+      }
+    },
+    "./vitest/dom": {
+      "import": {
+        "types": "./dist/vitest/dom.d.mts",
+        "default": "./dist/vitest/dom.mjs"
+      }
+    },
+    "./promises": {
+      "import": {
+        "types": "./dist/promises.d.mts",
+        "default": "./dist/promises.mjs"
+      },
+      "require": {
+        "types": "./dist/promises.d.cts",
+        "default": "./dist/promises.cjs"
+      }
+    },
     "./react": {
       "import": {
         "types": "./dist/react.d.mts",