@vickbk/tests 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-24
+
+### Added
+
+- Shared text-pattern utilities and types, including `patternToRegex`, `LABEL_LOCATOR`, `TEXT_MATCHER`, `TEXT_PATTERN`, and `TEXT_WITH_NTH` through `@vickbk/tests`.
+- Vitest utilities for DOM assertions, console controls, user interactions, promise helpers, and toggle-event handling through `@vickbk/tests/vitest`.
+- React Server Component tree resolution through `@vickbk/tests/react`.
+- Playwright utilities for assertions, locators, interactions, and reusable test execution through `@vickbk/tests/playwright`.
+- Public package entrypoints for shared helpers, Vitest utilities, React utilities, and Playwright utilities.
+- TypeScript declaration files for the published entrypoints.
+- ESM and CommonJS builds for supported entrypoints, with the `@vickbk/tests/vitest` entrypoint published as ESM-only.
+- Package documentation covering installation, peer dependencies, setup, and API usage.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vick Bake
+
+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

@@ -1,3 +1,192 @@
-# Temporary Holding Version
-
-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.
+# @vickbk/tests
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/@vickbk/tests.svg)](https://www.npmjs.com/package/@vickbk/tests)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/vickbk/tests/lint-test-docs.yml?branch=main)](https://github.com/vickbk/tests/actions)
+[![Test Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](https://github.com/vickbk/tests)
+
+Reusable testing utilities for TypeScript projects: framework-agnostic shared
+helpers, a collection of Vitest utilities, React Server Component helpers, and
+a Playwright DSL. Import only the entrypoint that matches the testing tools
+and integrations used by your project.
+
+## Overview
+
+The package is organized around stable public entrypoints:
+
+- Shared text-pattern helpers and types are available from the package root.
+- Vitest utilities provide DOM assertions and interactions, console controls,
+  promise helpers, and a package-provided toggle-event helper.
+- React utilities provide React Server Component (RSC) tree resolution.
+- Playwright utilities provide assertions, locators, interactions, and a
+  reusable runner.
+
+## Installation
+
+Install the package as a development dependency:
+
+```sh
+pnpm add -D @vickbk/tests
+```
+
+The integrations are optional peer dependencies. Add the peers needed by your
+project; for Vitest DOM tests, for example:
+
+```sh
+pnpm add -D vitest jsdom @testing-library/react @testing-library/user-event @testing-library/jest-dom
+```
+
+For Playwright tests, install `@playwright/test`. For React Server Component
+helpers, install `react` and `react-dom` (and `@types/react` when using
+TypeScript).
+
+## Public entrypoints
+
+| Import path                | Purpose                                                   |
+| -------------------------- | --------------------------------------------------------- |
+| `@vickbk/tests`            | Shared text-pattern utilities and types                   |
+| `@vickbk/tests/vitest`     | Vitest console, DOM, promise, and toggle-event helpers    |
+| `@vickbk/tests/react`      | React Server Component tree resolution                    |
+| `@vickbk/tests/playwright` | Playwright assertions, locators, interactions, and runner |
+
+**Module format:** The `@vickbk/tests/vitest` entrypoint is ESM-only. Use
+`import` to consume it; CommonJS `require()` is not supported. The other
+entrypoints retain their existing module-format support.
+
+## Shared text-pattern helpers
+
+The shared API provides `patternToRegex` and the `LABEL_LOCATOR`,
+`TEXT_MATCHER`, `TEXT_PATTERN`, and `TEXT_WITH_NTH` types.
+
+```ts
+import { patternToRegex, type TEXT_MATCHER } from "@vickbk/tests";
+
+const matcher: TEXT_MATCHER = ["Welcome", 0];
+const caseInsensitive = patternToRegex("Welcome");
+```
+
+## Vitest setup
+
+The package supports Node.js 20 and newer. Its peer dependency ranges are:
+
+| Peer dependency               | Supported range        | Used for                                              |
+| ----------------------------- | ---------------------- | ----------------------------------------------------- |
+| `vitest`                      | `^5.0.4`               | Vitest helpers                                        |
+| `@testing-library/react`      | `^16.0.0`              | DOM queries, interactions, and toggle events          |
+| `@testing-library/user-event` | `^14.6.8`              | User-like DOM interactions                            |
+| `@testing-library/jest-dom`   | `^7.0.1`               | DOM matcher setup used by the DOM assertion helpers   |
+| `@playwright/test`            | `^1.64.0`              | Playwright helpers and direct `test`/`expect` exports |
+| `react`, `react-dom`          | `^18.0.0` or `^19.0.0` | React integrations and RSC helpers                    |
+| `@types/react`                | `^18.0.0` or `^19.0.0` | React TypeScript types                                |
+
+All peers are optional at the package level. Install the peers for the
+entrypoints your project imports.
+
+Configure Vitest to use a DOM environment for DOM tests, and load the
+jest-dom Vitest matchers from a setup file:
+
+```ts
+// vitest.config.ts
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "jsdom",
+    setupFiles: ["./tests/setup.ts"],
+  },
+});
+```
+
+```ts
+// tests/setup.ts
+import "@testing-library/jest-dom/vitest";
+```
+
+## Vitest utilities
+
+Import DOM helpers and console controls from `@vickbk/tests/vitest`.
+`shouldSee` returns the matched elements, while `shouldHaveTestId` returns the
+elements located by test ID.
+
+```tsx
+import { render } from "@testing-library/react";
+import { shouldHaveTestId, shouldSee } from "@vickbk/tests/vitest";
+
+render(
+  <main>
+    <h1>Welcome</h1>
+    <button data-testid="save-button">Save</button>
+  </main>,
+);
+
+const [heading] = shouldSee("Welcome");
+const [saveButton] = shouldHaveTestId("save-button");
+```
+
+To suppress console output during a test, pair `shutConsole` with
+`resetConsole`:
+
+```ts
+import { afterEach, beforeEach } from "vitest";
+import { resetConsole, shutConsole } from "@vickbk/tests/vitest";
+
+beforeEach(shutConsole);
+afterEach(resetConsole);
+```
+
+The Vitest entrypoint provides its own `fireEvent`, combining standard Testing
+Library event helpers with `toggle`. Import it directly; no separate toggle
+installation is needed:
+
+```ts
+import { fireEvent } from "@vickbk/tests/vitest";
+
+fireEvent.click(document.body);
+fireEvent.toggle(document.body);
+```
+
+The Vitest entrypoint also exports `shouldNotSee`, `isChecked`,
+`isNotChecked`, `shouldHaveAttributes`, `shouldNotHaveTestId`, `userClicks`,
+`userTypes`, `userTypesMultiple`, `togglePopover`, `resolvedPromise`, and
+`rejectedPromise`.
+
+[For more details on Vitest API](./src/features/vitest/README.md)
+
+## React utilities
+
+The React entrypoint exposes `resolveRscTree`:
+
+```tsx
+import { resolveRscTree } from "@vickbk/tests/react";
+
+const resolved = await resolveRscTree(<ServerPage />);
+```
+
+[For more on React API](./src/features/react/README.md)
+
+## Playwright utilities
+
+Playwright helpers are imported from `@vickbk/tests/playwright`.
+
+```ts
+import { expect, test } from "@playwright/test";
+import { clickButton, getButton, shouldSee } from "@vickbk/tests/playwright";
+
+test("saves the page", async ({ page }) => {
+  await page.goto("/");
+  await shouldSee(page, "Welcome");
+  await clickButton(page, "Save");
+  await expect(getButton(page, "Save")).toBeVisible();
+});
+```
+
+The public API also includes `shouldNotSee`, `isChecked`, `isNotChecked`,
+`getLocatorByText`, `getLabel`, `getLink`, `fillLocatorWith`,
+`setLocatorValue`, `setValueForLocators`, `clickLink`, `clickLabelInput`,
+`clickMultipleLabelInputs`, `clickBodyCorner`, and `runSimilarTests`.
+
+[For more details on the Playwright API](./src/features/playwright/README.md)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_pattern_to_regex = require("./pattern-to-regex-BrMJtzu8.cjs");
+exports.patternToRegex = require_pattern_to_regex.patternToRegex;

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+import { i as TEXT_WITH_NTH, n as TEXT_MATCHER, r as TEXT_PATTERN, t as LABEL_LOCATOR } from "./types-BlSFP07Z.cjs";
+//#region src/shared/regex/utils/pattern-to-regex.d.ts
+export declare function patternToRegex(target: TEXT_PATTERN, flags?: string): RegExp;
+//#endregion
+export type { LABEL_LOCATOR, TEXT_MATCHER, TEXT_PATTERN, TEXT_WITH_NTH };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/shared/regex/utils/pattern-to-regex.ts"],"mappings":";;wBAGgB,eACd,QAAQ,cACR,iBACC"}

package/dist/index.d.mts

@@ -0,0 +1,6 @@
+import { i as TEXT_WITH_NTH, n as TEXT_MATCHER, r as TEXT_PATTERN, t as LABEL_LOCATOR } from "./types-BlSFP07Z.mjs";
+//#region src/shared/regex/utils/pattern-to-regex.d.ts
+export declare function patternToRegex(target: TEXT_PATTERN, flags?: string): RegExp;
+//#endregion
+export type { LABEL_LOCATOR, TEXT_MATCHER, TEXT_PATTERN, TEXT_WITH_NTH };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/shared/regex/utils/pattern-to-regex.ts"],"mappings":";;wBAGgB,eACd,QAAQ,cACR,iBACC"}

package/dist/index.mjs

@@ -0,0 +1 @@
+export { t as patternToRegex } from "./pattern-to-regex-CO5Y0oDU.mjs";

package/dist/pattern-to-regex-BrMJtzu8.cjs

@@ -0,0 +1,19 @@
+//#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
+Object.defineProperty(exports, "patternToRegex", {
+	enumerable: true,
+	get: function() {
+		return patternToRegex;
+	}
+});
+
+//# sourceMappingURL=pattern-to-regex-BrMJtzu8.cjs.map

package/dist/pattern-to-regex-BrMJtzu8.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-to-regex-BrMJtzu8.cjs","names":[],"sources":["../src/shared/regex/utils/escape-regex.ts","../src/shared/regex/utils/pattern-to-regex.ts"],"sourcesContent":["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"],"mappings":";AAAA,SAAgB,aAAa,KAAqB;CAChD,IAAI,OAAO,OAAO,WAAW,YAC3B,OAAO,OAAO,OAAO,GAAG;CAE1B,OAAO,IAAI,QAAQ,uBAAuB,MAAM;AAClD;;;ACFA,SAAgB,eACd,QACA,QAAgB,KACR;CACR,OAAO,OAAO,WAAW,WACrB,IAAI,OAAO,aAAa,MAAM,GAAG,KAAK,IACtC;AACN"}

package/dist/pattern-to-regex-CO5Y0oDU.mjs

@@ -0,0 +1,14 @@
+//#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
+export { patternToRegex as t };
+
+//# sourceMappingURL=pattern-to-regex-CO5Y0oDU.mjs.map

package/dist/pattern-to-regex-CO5Y0oDU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-to-regex-CO5Y0oDU.mjs","names":[],"sources":["../src/shared/regex/utils/escape-regex.ts","../src/shared/regex/utils/pattern-to-regex.ts"],"sourcesContent":["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"],"mappings":";AAAA,SAAgB,aAAa,KAAqB;CAChD,IAAI,OAAO,OAAO,WAAW,YAC3B,OAAO,OAAO,OAAO,GAAG;CAE1B,OAAO,IAAI,QAAQ,uBAAuB,MAAM;AAClD;;;ACFA,SAAgB,eACd,QACA,QAAgB,KACR;CACR,OAAO,OAAO,WAAW,WACrB,IAAI,OAAO,aAAa,MAAM,GAAG,KAAK,IACtC;AACN"}

package/dist/playwright.cjs

@@ -0,0 +1,327 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+const require_pattern_to_regex = require("./pattern-to-regex-BrMJtzu8.cjs");
+let _playwright_test = require("@playwright/test");
+_playwright_test = require_rolldown_runtime.__toESM(_playwright_test, 1);
+//#region src/features/playwright/modules/assertions/utils/isChecked.ts
+/**
+* Asserts that the element selected by the CSS selector is checked.
+*
+* @param page The Playwright page to search.
+* @param selector CSS selector for a checkbox or radio input.
+* @returns The checked locator.
+* @example
+* ```ts
+* const checkbox = await isChecked(page, "#terms");
+* ```
+*/
+async function isChecked(page, selector) {
+	const locator = page.locator(selector);
+	await (0, _playwright_test.expect)(locator).toBeChecked();
+	return locator;
+}
+//#endregion
+//#region src/features/playwright/modules/assertions/utils/isNotChecked.ts
+/**
+* Asserts that the element selected by the CSS selector is not checked.
+*
+* @param page The Playwright page to search.
+* @param selector CSS selector for a checkbox or radio input.
+* @returns The unchecked locator.
+* @example
+* ```ts
+* const checkbox = await isNotChecked(page, "#terms");
+* ```
+*/
+async function isNotChecked(page, selector) {
+	const locator = page.locator(selector);
+	await (0, _playwright_test.expect)(locator).not.toBeChecked();
+	return locator;
+}
+//#endregion
+//#region src/features/playwright/modules/assertions/utils/getMatcher.ts
+function getMatcher(page, ...textes) {
+	return textes.map((text) => {
+		if (Array.isArray(text)) {
+			const [matcher, nth] = text;
+			return (0, _playwright_test.expect)(page.getByText(require_pattern_to_regex.patternToRegex(matcher)).nth(nth));
+		}
+		return (0, _playwright_test.expect)(page.getByText(text));
+	});
+}
+//#endregion
+//#region src/features/playwright/modules/assertions/utils/shouldNotSee.ts
+/**
+* Asserts that each text matcher is not visible on the page.
+*
+* @param page The Playwright page to inspect.
+* @param textes Text strings, regular expressions, or `[matcher, occurrenceIndex]` pairs.
+* @returns A promise that resolves when every matching element is not visible.
+* @example
+* ```ts
+* await shouldNotSee(page, "Error message");
+* ```
+*/
+async function shouldNotSee(page, ...textes) {
+	const matchers = getMatcher(page, ...textes);
+	for (let i = 0; i < matchers.length; i++) await matchers[i].not.toBeVisible();
+}
+//#endregion
+//#region src/features/playwright/modules/assertions/utils/shouldSee.ts
+/**
+* Asserts that each text matcher is visible on the page.
+*
+* @param page The Playwright page to inspect.
+* @param textes Text strings, regular expressions, or `[matcher, occurrenceIndex]` pairs.
+* @returns A promise that resolves when every matching element is visible.
+* @example
+* ```ts
+* await shouldSee(page, "Welcome", [/Saved/i, 0]);
+* ```
+*/
+async function shouldSee(page, ...textes) {
+	const matchers = getMatcher(page, ...textes);
+	for (let i = 0; i < matchers.length; i++) await matchers[i].toBeVisible();
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickBodyCorner.ts
+/**
+* Clicks the top-left corner of the page body.
+*
+* @param page The Playwright page to interact with.
+* @returns A promise that resolves after the click.
+* @example
+* ```ts
+* await clickBodyCorner(page);
+* ```
+*/
+async function clickBodyCorner(page) {
+	await page.locator("body").click({ position: {
+		x: 0,
+		y: 0
+	} });
+}
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getLocatorByText.ts
+/**
+* Locates elements matching a selector and text pattern.
+*
+* @param page The Playwright page to search.
+* @param locator Selector paired with text that the element must contain.
+* @returns A locator matching the selector and text.
+* @example
+* ```ts
+* const save = getLocatorByText(page, ["button", "Save"]);
+* ```
+*/
+function getLocatorByText(page, [locator, hasText]) {
+	return page.locator(locator, { hasText });
+}
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getButton.ts
+/**
+* Locates a button by its contained text.
+*
+* @param page The Playwright page to search.
+* @param hasText Text or regular expression contained by the button.
+* @returns A locator for the matching button.
+* @example
+* ```ts
+* const saveButton = getButton(page, "Save");
+* ```
+*/
+function getButton(page, hasText) {
+	return getLocatorByText(page, ["button", hasText]);
+}
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getLabel.ts
+/**
+* Locates a label by its contained text.
+*
+* @param page The Playwright page to search.
+* @param hasText Text or regular expression contained by the label.
+* @returns A locator for the matching label.
+* @example
+* ```ts
+* const emailLabel = getLabel(page, "Email");
+* ```
+*/
+function getLabel(page, hasText) {
+	return getLocatorByText(page, ["label", hasText]);
+}
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getLink.ts
+/**
+* Locates a link by its accessible name.
+*
+* @param page The Playwright page to search.
+* @param hasText Text or regular expression matching the link's accessible name.
+* @returns A locator for the matching link.
+* @example
+* ```ts
+* const documentationLink = getLink(page, "Documentation");
+* ```
+*/
+function getLink(page, hasText) {
+	return page.getByRole("link", { name: hasText });
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickButton.ts
+/**
+* Clicks a button matching the supplied text.
+*
+* @param page The Playwright page to search.
+* @param hasText Text or regular expression contained by the button.
+* @returns A promise that resolves after the button is clicked.
+* @example
+* ```ts
+* await clickButton(page, "Save");
+* ```
+*/
+async function clickButton(page, hasText) {
+	await getButton(page, hasText).click();
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickLabelInput.ts
+/**
+* Clicks the label matching the supplied text.
+*
+* @param page The Playwright page to search.
+* @param labelText Text or regular expression contained by the label.
+* @returns A promise that resolves after the label is clicked.
+* @example
+* ```ts
+* await clickLabelInput(page, "Subscribe");
+* ```
+*/
+async function clickLabelInput(page, labelText) {
+	await getLabel(page, labelText).click();
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickLink.ts
+/**
+* Clicks a link matching the supplied accessible name.
+*
+* @param page The Playwright page to search.
+* @param hasText Text or regular expression matching the link name.
+* @returns A promise that resolves after the link is clicked.
+* @example
+* ```ts
+* await clickLink(page, "Documentation");
+* ```
+*/
+async function clickLink(page, hasText) {
+	await getLink(page, hasText).click();
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickMultipleLabelInputs.ts
+/**
+* Clicks each matching label in the supplied order.
+*
+* @param page The Playwright page to search.
+* @param labelTexts Text or regular expressions for the labels to click.
+* @returns A promise that resolves after all labels are clicked.
+* @example
+* ```ts
+* await clickMultipleLabelInputs(page, ["Email", "Subscribe"]);
+* ```
+*/
+async function clickMultipleLabelInputs(page, labelTexts) {
+	for (const labelText of labelTexts) await clickLabelInput(page, labelText);
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/fillLocatorWith.ts
+/**
+* Clicks a locator and fills it with the supplied value.
+*
+* @param locator The input-like locator to fill.
+* @param value The value to enter.
+* @returns A promise that resolves after the locator is filled.
+* @example
+* ```ts
+* await fillLocatorWith(page.getByLabel("Email"), "user@example.com");
+* ```
+*/
+async function fillLocatorWith(locator, value) {
+	await locator.click();
+	await locator.fill(value);
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/setLocatorValue.ts
+/**
+* Clicks the label matching the pattern and fills it with the supplied value.
+*
+* @param page The Playwright page to search.
+* @param locatorAndValue Label text or pattern paired with the value to fill.
+* @returns A promise that resolves after the matching label is filled.
+* @example
+* ```ts
+* await setLocatorValue(page, ["Email", "user@example.com"]);
+* ```
+*/
+async function setLocatorValue(page, [locator, value]) {
+	const element = page.locator("label", { hasText: require_pattern_to_regex.patternToRegex(locator) });
+	await element.click();
+	await element.fill(value);
+}
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/setValueForLocators.ts
+/**
+* Sets values for a sequence of label/value pairs in order.
+*
+* @param page The Playwright page to search.
+* @param locatorsAndValues Label text or pattern paired with its value.
+* @returns A promise that resolves after all values are set.
+* @example
+* ```ts
+* await setValueForLocators(page, [
+*   ["Email", "user@example.com"],
+*   ["Name", "Alex"],
+* ]);
+* ```
+*/
+async function setValueForLocators(page, locatorsAndValues) {
+	for (const locatorAndValue of locatorsAndValues) await setLocatorValue(page, locatorAndValue);
+}
+//#endregion
+//#region src/features/playwright/modules/runners/utils/runSimilarTests.ts
+/**
+* Registers tests that share the same page navigation and setup.
+*
+* @param tests Tuples of test names followed by page callbacks.
+* @returns Nothing; registers one Playwright test for each tuple.
+* @example
+* ```ts
+* runSimilarTests([
+*   ["shows the home page", async (page) => {
+*     await page.getByRole("heading", { name: "Home" }).waitFor();
+*   }],
+* ]);
+* ```
+*/
+function runSimilarTests(...tests) {
+	tests.forEach(([testName, ...testFunctions]) => (0, _playwright_test.default)(testName, async ({ page }) => {
+		await page.goto("/");
+		for (const testFunction of testFunctions) await testFunction(page);
+	}));
+}
+//#endregion
+exports.clickBodyCorner = clickBodyCorner;
+exports.clickButton = clickButton;
+exports.clickLabelInput = clickLabelInput;
+exports.clickLink = clickLink;
+exports.clickMultipleLabelInputs = clickMultipleLabelInputs;
+exports.fillLocatorWith = fillLocatorWith;
+exports.getButton = getButton;
+exports.getLabel = getLabel;
+exports.getLink = getLink;
+exports.getLocatorByText = getLocatorByText;
+exports.isChecked = isChecked;
+exports.isNotChecked = isNotChecked;
+exports.runSimilarTests = runSimilarTests;
+exports.setLocatorValue = setLocatorValue;
+exports.setValueForLocators = setValueForLocators;
+exports.shouldNotSee = shouldNotSee;
+exports.shouldSee = shouldSee;
+
+//# sourceMappingURL=playwright.cjs.map