@vickbk/tests 0.0.0-stage → 0.2.0

package/dist/playwright.d.mts

@@ -0,0 +1,254 @@
+import { i as TEXT_WITH_NTH, n as TEXT_MATCHER, r as TEXT_PATTERN, t as LABEL_LOCATOR } from "./types-BlSFP07Z.mjs";
+import { Locator, Page } from "@playwright/test";
+//#region src/features/playwright/modules/assertions/utils/isChecked.d.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");
+ * ```
+ */
+export declare function isChecked(page: Page, selector: string): Promise<Locator>;
+//#endregion
+//#region src/features/playwright/modules/assertions/utils/isNotChecked.d.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");
+ * ```
+ */
+export declare function isNotChecked(page: Page, selector: string): Promise<Locator>;
+//#endregion
+//#region src/features/playwright/modules/assertions/utils/shouldNotSee.d.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");
+ * ```
+ */
+export declare function shouldNotSee(page: Page, ...textes: TEXT_MATCHER[]): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/assertions/utils/shouldSee.d.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]);
+ * ```
+ */
+export declare function shouldSee(page: Page, ...textes: TEXT_MATCHER[]): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickBodyCorner.d.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);
+ * ```
+ */
+export declare function clickBodyCorner(page: Page): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickButton.d.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");
+ * ```
+ */
+export declare function clickButton(page: Page, hasText: TEXT_PATTERN): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickLabelInput.d.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");
+ * ```
+ */
+export declare function clickLabelInput(page: Page, labelText: TEXT_PATTERN): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickLink.d.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");
+ * ```
+ */
+export declare function clickLink(page: Page, hasText: TEXT_PATTERN): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/clickMultipleLabelInputs.d.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"]);
+ * ```
+ */
+export declare function clickMultipleLabelInputs(page: Page, labelTexts: TEXT_PATTERN[]): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/fillLocatorWith.d.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");
+ * ```
+ */
+export declare function fillLocatorWith(locator: Locator, value: string): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/setLocatorValue.d.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"]);
+ * ```
+ */
+export declare function setLocatorValue(page: Page, [locator, value]: LABEL_LOCATOR): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/interactions/utils/setValueForLocators.d.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"],
+ * ]);
+ * ```
+ */
+export declare function setValueForLocators(page: Page, locatorsAndValues: LABEL_LOCATOR[]): Promise<void>;
+//#endregion
+//#region src/features/playwright/modules/runners/types.d.ts
+type TestRunner = (page: Page) => void | Promise<void>;
+type SimpleTest = [string, ...TestRunner[]];
+//#endregion
+//#region src/features/playwright/modules/runners/utils/runSimilarTests.d.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();
+ *   }],
+ * ]);
+ * ```
+ */
+export declare function runSimilarTests(...tests: SimpleTest[]): void;
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getButton.d.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");
+ * ```
+ */
+export declare function getButton(page: Page, hasText: TEXT_PATTERN): import("@playwright/test").Locator;
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getLabel.d.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");
+ * ```
+ */
+export declare function getLabel(page: Page, hasText: TEXT_PATTERN): import("@playwright/test").Locator;
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getLink.d.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");
+ * ```
+ */
+export declare function getLink(page: Page, hasText: TEXT_PATTERN): import("@playwright/test").Locator;
+//#endregion
+//#region src/features/playwright/shared/locators/types.d.ts
+type LocatorWithText = [string, TEXT_PATTERN];
+//#endregion
+//#region src/features/playwright/shared/locators/utils/getLocatorByText.d.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"]);
+ * ```
+ */
+export declare function getLocatorByText(page: Page, [locator, hasText]: LocatorWithText): import("@playwright/test").Locator;
+//#endregion
+export type { LABEL_LOCATOR, LocatorWithText, SimpleTest, TEXT_MATCHER, TEXT_PATTERN, TEXT_WITH_NTH, TestRunner };
+//# sourceMappingURL=playwright.d.mts.map

package/dist/playwright.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.mts","names":[],"sources":["../src/features/playwright/modules/assertions/utils/isChecked.ts","../src/features/playwright/modules/assertions/utils/isNotChecked.ts","../src/features/playwright/modules/assertions/utils/shouldNotSee.ts","../src/features/playwright/modules/assertions/utils/shouldSee.ts","../src/features/playwright/modules/interactions/utils/clickBodyCorner.ts","../src/features/playwright/modules/interactions/utils/clickButton.ts","../src/features/playwright/modules/interactions/utils/clickLabelInput.ts","../src/features/playwright/modules/interactions/utils/clickLink.ts","../src/features/playwright/modules/interactions/utils/clickMultipleLabelInputs.ts","../src/features/playwright/modules/interactions/utils/fillLocatorWith.ts","../src/features/playwright/modules/interactions/utils/setLocatorValue.ts","../src/features/playwright/modules/interactions/utils/setValueForLocators.ts","../src/features/playwright/modules/runners/types.ts","../src/features/playwright/modules/runners/utils/runSimilarTests.ts","../src/features/playwright/shared/locators/utils/getButton.ts","../src/features/playwright/shared/locators/utils/getLabel.ts","../src/features/playwright/shared/locators/utils/getLink.ts","../src/features/playwright/shared/locators/types.ts","../src/features/playwright/shared/locators/utils/getLocatorByText.ts"],"mappings":";;;;;;;;;;;;;;wBAcsB,UACpB,MAAM,MACN,mBACC,QAAQ;;;;;;;;;;;;;;wBCHW,aACpB,MAAM,MACN,mBACC,QAAQ;;;;;;;;;;;;;;wBCFW,aAAa,MAAM,SAAS,QAAQ,iBAAc;;;;;;;;;;;;;;wBCAlD,UAAU,MAAM,SAAS,QAAQ,iBAAc;;;;;;;;;;;;;wBCH/C,gBAAgB,MAAM,OAAI;;;;;;;;;;;;;;wBCG1B,YAAY,MAAM,MAAM,SAAS,eAAY;;;;;;;;;;;;;;wBCA7C,gBAAgB,MAAM,MAAM,WAAW,eAAY;;;;;;;;;;;;;;wBCAnD,UAAU,MAAM,MAAM,SAAS,eAAY;;;;;;;;;;;;;;wBCA3C,yBACpB,MAAM,MACN,YAAY,iBAAc;;;;;;;;;;;;;;wBCJN,gBAAgB,SAAS,SAAS,gBAAa;;;;;;;;;;;;;;wBCC/C,gBACpB,MAAM,OACL,SAAS,QAAQ,gBAAa;;;;;;;;;;;;;;;;;wBCEX,oBACpB,MAAM,MACN,mBAAmB,kBAAe;;;KClBxB,cAAc,MAAM,gBAAgB;KACpC,yBAAyB;;;;;;;;;;;;;;;;;wBCcrB,mBAAmB,OAAO;;;;;;;;;;;;;;wBCF1B,UAAU,MAAM,MAAM,SAAS,0CAAY;;;;;;;;;;;;;;wBCA3C,SAAS,MAAM,MAAM,SAAS,0CAAY;;;;;;;;;;;;;;wBCD1C,QAAQ,MAAM,MAAM,SAAS,0CAAY;;;KCZ7C,2BAA2B;;;;;;;;;;;;;;wBCYvB,iBACd,MAAM,OACL,SAAS,UAAU,6CAAe"}

package/dist/playwright.mjs

@@ -0,0 +1,308 @@
+import { t as patternToRegex } from "./pattern-to-regex-CO5Y0oDU.mjs";
+import test, { expect } from "@playwright/test";
+//#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 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 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 expect(page.getByText(patternToRegex(matcher)).nth(nth));
+		}
+		return 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: 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]) => test(testName, async ({ page }) => {
+		await page.goto("/");
+		for (const testFunction of testFunctions) await testFunction(page);
+	}));
+}
+//#endregion
+export { clickBodyCorner, clickButton, clickLabelInput, clickLink, clickMultipleLabelInputs, fillLocatorWith, getButton, getLabel, getLink, getLocatorByText, isChecked, isNotChecked, runSimilarTests, setLocatorValue, setValueForLocators, shouldNotSee, shouldSee };
+
+//# sourceMappingURL=playwright.mjs.map

package/dist/playwright.mjs.map

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

package/dist/promises.cjs

@@ -0,0 +1,45 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/features/promises/utils/resolvedPromise.ts
+/**
+* Creates a fulfilled promise augmented with Vitest's fulfilled-promise metadata.
+*
+* @param value The value with which the promise is fulfilled.
+* @returns A fulfilled Promise<T> with `status: "fulfilled"` and its `value`.
+* @example
+* ```ts
+* const payload = await resolvedPromise({ id: 1 });
+* expect(payload).toEqual({ id: 1 });
+* ```
+*/
+function resolvedPromise(value) {
+	const promise = Promise.resolve(value);
+	return Object.assign(promise, {
+		status: "fulfilled",
+		value
+	});
+}
+//#endregion
+//#region src/features/promises/utils/rejectedPromise.ts
+/**
+* Creates a rejected promise augmented with Vitest's rejected-promise metadata.
+*
+* @param reason The rejection reason, preserved as an unknown value; defaults to `undefined`.
+* @returns A rejected Promise<never> with `status: "rejected"` and its `reason`.
+* @example
+* ```ts
+* await expect(rejectedPromise(new Error("Request failed"))).rejects.toThrow("Request failed");
+* ```
+*/
+function rejectedPromise(reason = void 0) {
+	const promise = Promise.reject(reason);
+	promise.catch((error) => error);
+	return Object.assign(promise, {
+		status: "rejected",
+		reason
+	});
+}
+//#endregion
+exports.rejectedPromise = rejectedPromise;
+exports.resolvedPromise = resolvedPromise;
+
+//# sourceMappingURL=promises.cjs.map

package/dist/promises.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"promises.cjs","names":[],"sources":["../src/features/promises/utils/resolvedPromise.ts","../src/features/promises/utils/rejectedPromise.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"],"mappings":";;;;;;;;;;;;;AAWA,SAAgB,gBACd,OACgD;CAChD,MAAM,UAAU,QAAQ,QAAQ,KAAK;CACrC,OAAO,OAAO,OAAO,SAAS;EAAE,QAAQ;EAAsB;CAAM,CAAC;AACvE;;;;;;;;;;;;;ACNA,SAAgB,gBACd,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"}