@vickbk/tests 0.1.0 → 0.2.1

package/dist/index-CKsosUpb.d.mts

@@ -0,0 +1,249 @@
+import { fireEvent } from "@testing-library/react";
+//#region src/features/vitest/modules/dom/modules/toggle-event/utils/types.d.ts
+/**
+ * Possible states for a disclosure or popover toggle transition.
+ *
+ * @example
+ * ```ts
+ * const nextState: ToggleState = "open";
+ * ```
+ */
+type ToggleState = "open" | "closed";
+/**
+ * The previous and next states dispatched by the toggle-event polyfill.
+ *
+ * @example
+ * ```ts
+ * const transition: ToggleConfig = { oldState: "closed", newState: "open" };
+ * ```
+ */
+type ToggleConfig = Record<"oldState" | "newState", ToggleState>;
+/**
+ * Internal shape added to Testing Library's `fireEvent` by its type augmentation.
+ *
+ * @example
+ * ```ts
+ * installToggleEvent();
+ * fireEvent.toggle(document.body, { newState: "open" });
+ * ```
+ */
+type ToggleFireEventExtensions = {
+  toggle: (element: Document | Element | Window | Node, initDict?: Partial<ToggleConfig>) => boolean;
+};
+//#endregion
+//#region src/features/vitest/modules/dom/modules/toggle-event/utils/fireEvent.d.ts
+/**
+ * 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);
+ * ```
+ */
+declare const fireEvent$1: typeof fireEvent & ToggleFireEventExtensions;
+//#endregion
+//#region src/shared/regex/types.d.ts
+type TEXT_PATTERN = RegExp | string;
+type TEXT_WITH_NTH = [TEXT_PATTERN, number];
+type TEXT_MATCHER = TEXT_PATTERN | TEXT_WITH_NTH;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/clickLabelInput.d.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");
+ * ```
+ */
+declare function clickLabelInput(label: TEXT_PATTERN, container?: HTMLElement): Promise<void>;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/isChecked.d.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");
+ * ```
+ */
+declare function isChecked(selector: TEXT_PATTERN, container?: HTMLElement): void;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/isNotChecked.d.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");
+ * ```
+ */
+declare function isNotChecked(selector: TEXT_PATTERN, container?: HTMLElement): void;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/shouldHaveAttributes.d.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" });
+ * ```
+ */
+declare function shouldHaveAttributes(element: HTMLElement, attributes: Record<string, unknown>): void;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/shouldHaveTestId.d.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");
+ * ```
+ */
+declare function shouldHaveTestId(...ids: string[]): HTMLElement[];
+//#endregion
+//#region src/features/vitest/modules/dom/utils/shouldNotHaveTestId.d.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");
+ * ```
+ */
+declare function shouldNotHaveTestId(...ids: string[]): (HTMLElement | null)[];
+//#endregion
+//#region src/features/vitest/modules/dom/utils/shouldNotSee.d.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);
+ * ```
+ */
+declare const shouldNotSee: (...texts: (string | RegExp)[]) => void;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/shouldSee.d.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");
+ * ```
+ */
+declare const shouldSee: (...texts: TEXT_MATCHER[]) => HTMLElement[];
+//#endregion
+//#region src/features/vitest/modules/dom/utils/togglePopover.d.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" });
+ * ```
+ */
+declare function togglePopover({ container, selector, newState }: {
+  container?: HTMLElement;
+  selector: string;
+  newState?: ToggleState;
+}): Element | undefined;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/userClicks.d.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");
+ * ```
+ */
+declare const userClicks: (target: string | RegExp, container?: HTMLElement) => Promise<void>;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/userTypes.d.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");
+ * ```
+ */
+declare const userTypes: (target: TEXT_PATTERN, text: string, container?: HTMLElement, user?: import("@testing-library/user-event").UserEvent) => Promise<HTMLElement>;
+//#endregion
+//#region src/features/vitest/modules/dom/utils/userTypesMultiple.d.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" });
+ * ```
+ */
+declare function userTypesMultiple(inputs: Record<string, string>, container?: HTMLElement): Promise<Record<string, HTMLElement>>;
+//#endregion
+export { shouldSee as a, shouldHaveTestId as c, isChecked as d, clickLabelInput as f, ToggleState as h, togglePopover as i, shouldHaveAttributes as l, ToggleConfig as m, userTypes as n, shouldNotSee as o, fireEvent$1 as p, userClicks as r, shouldNotHaveTestId as s, userTypesMultiple as t, isNotChecked as u };
+//# sourceMappingURL=index-CKsosUpb.d.mts.map

package/dist/index-CKsosUpb.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CKsosUpb.d.mts","names":["fireEvent","rtlFireEvent"],"sources":["../src/features/vitest/modules/dom/modules/toggle-event/utils/types.ts","../src/features/vitest/modules/dom/modules/toggle-event/utils/fireEvent.ts","../src/shared/regex/types.ts","../src/features/vitest/modules/dom/utils/clickLabelInput.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/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/userTypes.ts","../src/features/vitest/modules/dom/utils/userTypesMultiple.ts"],"mappings":";;;;;;;;;;KAQY;;;;;;;;;KAUA,eAAe,gCAAgC;;;;;;;;;;KAW/C;EACV,SACE,SAAS,WAAW,UAAU,SAAS,MACvC,WAAW,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCQVA,oBAyBAC,YAAe;;;KCjEhB,eAAe;KAEf,iBAAiB;KACjB,eAAe,eAAe;;;;;;;;;;;;;;iBCapB,gBACpB,OAAO,cACP,YAAY,cAAW;;;;;;;;;;;;;;iBCHT,UAAU,UAAU,cAAc,YAAY;;;;;;;;;;;;;;iBCA9C,aAAa,UAAU,cAAc,YAAY;;;;;;;;;;;;;;;;;iBCCjD,qBACd,SAAS,aACT,YAAY;;;;;;;;;;;;;iBCLE,oBAAoB,gBAAa;;;;;;;;;;;;;iBCAjC,uBAAuB,iBAAa;;;;;;;;;;;;;cCDvC,kBAAmB,iBAAiB;;;;;;;;;;;;;cCCpC,eAAgB,OAAO,mBAAc;;;;;;;;;;;;;iBCDlC,gBACd,WACA,UACA;EAEA,YAAY;EACZ;EACA,WAAW;IACZ;;;;;;;;;;;;;;cCLY,aACX,iBAAiB,QACjB,YAAY,gBAAW;;;;;;;;;;;;;;;;cCAZ,YACX,QAAQ,cACR,cACA,YAAY,aACZ,6CAAA,cAAwB,QAAA;;;;;;;;;;;;;;iBCRJ,kBACpB,QAAQ,wBACR,YAAY,cAAW,QAAA,eAAA"}

package/dist/index-DtGBqDev.d.mts

@@ -0,0 +1,25 @@
+//#region src/features/vitest/modules/console/utils/console.d.ts
+/**
+ * Suppresses console.log, console.warn, and console.error until resetConsole runs.
+ *
+ * @example
+ * ```ts
+ * beforeEach(shutConsole);
+ * afterEach(resetConsole);
+ * ```
+ */
+declare function shutConsole(): void;
+/**
+ * Restores the console methods most recently suppressed by shutConsole.
+ *
+ * @example
+ * ```ts
+ * shutConsole();
+ * // Run code whose console output should be ignored.
+ * resetConsole();
+ * ```
+ */
+declare function resetConsole(): void;
+//#endregion
+export { shutConsole as n, resetConsole as t };
+//# sourceMappingURL=index-DtGBqDev.d.mts.map

package/dist/index-DtGBqDev.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DtGBqDev.d.mts","names":[],"sources":["../src/features/vitest/modules/console/utils/console.ts"],"mappings":";;;;;;;;;;iBAegB;;;;;;;;;;;iBAkBA"}

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

@@ -1 +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"}
+{"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 {\n  if (typeof RegExp.escape === \"function\") {\n    return RegExp.escape(str);\n  }\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n","import { TEXT_PATTERN } from \"../types\";\nimport { escapeRegExp } from \"./escape-regex\";\n\nexport function patternToRegex(\n  target: TEXT_PATTERN,\n  flags: string = \"i\",\n): RegExp {\n  return typeof target === \"string\"\n    ? new RegExp(escapeRegExp(target), flags)\n    : target;\n}\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.map

@@ -1 +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"}
+{"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 {\n  if (typeof RegExp.escape === \"function\") {\n    return RegExp.escape(str);\n  }\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n","import { TEXT_PATTERN } from \"../types\";\nimport { escapeRegExp } from \"./escape-regex\";\n\nexport function patternToRegex(\n  target: TEXT_PATTERN,\n  flags: string = \"i\",\n): RegExp {\n  return typeof target === \"string\"\n    ? new RegExp(escapeRegExp(target), flags)\n    : target;\n}\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.map

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

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

package/dist/promises.d.cts

@@ -0,0 +1,34 @@
+//#region src/features/promises/utils/resolvedPromise.d.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 });
+ * ```
+ */
+export declare function resolvedPromise<T>(value: T): Promise<T> & {
+  status: "fulfilled";
+  value: T;
+};
+//#endregion
+//#region src/features/promises/utils/rejectedPromise.d.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");
+ * ```
+ */
+export declare function rejectedPromise(reason?: unknown): Promise<never> & {
+  status: "rejected";
+  reason: unknown;
+};
+//#endregion
+//# sourceMappingURL=promises.d.cts.map

package/dist/promises.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promises.d.cts","names":[],"sources":["../src/features/promises/utils/resolvedPromise.ts","../src/features/promises/utils/rejectedPromise.ts"],"mappings":";;;;;;;;;;;;wBAWgB,gBAAgB,GAC9B,OAAO,IACN,QAAQ;EAAO;EAAqB,OAAO;;;;;;;;;;;;;;wBCH9B,gBACd,mBACC;EAAmB;EAAoB"}

package/dist/promises.d.mts

@@ -0,0 +1,34 @@
+//#region src/features/promises/utils/resolvedPromise.d.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 });
+ * ```
+ */
+export declare function resolvedPromise<T>(value: T): Promise<T> & {
+  status: "fulfilled";
+  value: T;
+};
+//#endregion
+//#region src/features/promises/utils/rejectedPromise.d.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");
+ * ```
+ */
+export declare function rejectedPromise(reason?: unknown): Promise<never> & {
+  status: "rejected";
+  reason: unknown;
+};
+//#endregion
+//# sourceMappingURL=promises.d.mts.map

package/dist/promises.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promises.d.mts","names":[],"sources":["../src/features/promises/utils/resolvedPromise.ts","../src/features/promises/utils/rejectedPromise.ts"],"mappings":";;;;;;;;;;;;wBAWgB,gBAAgB,GAC9B,OAAO,IACN,QAAQ;EAAO;EAAqB,OAAO;;;;;;;;;;;;;;wBCH9B,gBACd,mBACC;EAAmB;EAAoB"}

package/dist/promises.mjs

@@ -0,0 +1,43 @@
+//#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
+export { rejectedPromise, resolvedPromise };
+
+//# sourceMappingURL=promises.mjs.map