@letsrunit/bdd 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# BDD Package (`@letsrunit/bdd`)
+
+## Installation
+
+```bash
+npm install @letsrunit/bdd
+# or
+yarn add @letsrunit/bdd
+```
+
+Standard BDD step definitions and Playwright utilities for `letsrunit`. It provides the building blocks for creating and executing Gherkin-based automation.
+
+## Exported Components
+
+### `stepsDefinitions`
+
+An array of `StepDefinition` objects that define the standard steps available in the platform. These include:
+
+- **Assert**: Steps for verifying page state (e.g., `I should see "text"`, `the URL should be "url"`).
+- **Navigation**: Steps for moving between pages (e.g., `I go to "url"`, `I go back`).
+- **Mouse**: Click and hover interactions (e.g., `I click "button"`, `I click on the text "link"`).
+- **Form**: Filling and submitting forms (e.g., `I fill "input" with "value"`, `I select "option" from "select"`).
+- **Keyboard**: Typing and pressing keys.
+- **Mailbox**: Steps for interacting with emails (e.g., `I open the latest email`, `I click the link in the email`).
+- **Clipboard**: Steps for verifying and interacting with the clipboard.
+
+### Custom Parameter Types
+
+The package exports several Cucumber parameter types to make steps more readable and powerful:
+
+- `{text}`: For matching quoted or unquoted text.
+- `{selector}`: For matching Playwright-compatible selectors.
+- `{url}`: For matching URLs.
+
+### `toFile(path)`
+
+A utility to convert a local path or URL to a `File` object, useful for testing file uploads.
+
+## Testing
+
+Run tests for this package:
+
+```bash
+yarn test
+```

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import * as _letsrunit_gherkin from '@letsrunit/gherkin';
+import * as _letsrunit_utils from '@letsrunit/utils';
+import { World as World$1 } from '@cucumber/cucumber';
+import { BrowserContextOptions, Page } from '@playwright/test';
+import { Readable } from 'node:stream';
+
+declare const typeDefinitions: (_letsrunit_gherkin.ParameterTypeDefinition<_letsrunit_utils.Scalar | _letsrunit_utils.Scalar[]> | _letsrunit_gherkin.ParameterTypeDefinition<_letsrunit_gherkin.KeyCombo> | _letsrunit_gherkin.ParameterTypeDefinition<boolean>)[];
+
+interface World extends World$1<BrowserContextOptions> {
+    page: Page;
+    startTime: number;
+    pathParams?: Record<string, string>;
+    lang?: {
+        code: string;
+        name: string;
+    };
+    [_: string]: any;
+}
+type StepHandler = (this: World, ...args: any[]) => Promise<void> | void;
+type StepType = 'Given' | 'When' | 'Then';
+interface StepDefinition {
+    type: StepType;
+    expression: string | RegExp;
+    fn: StepHandler;
+    comment?: string;
+}
+
+declare const stepsDefinitions: StepDefinition[];
+
+type AttachData = string | Buffer | Readable;
+type AttachOptions = string | {
+    mediaType: string;
+    fileName?: string;
+};
+declare function toFile(data: AttachData, options?: AttachOptions): File;
+
+export { type StepDefinition, type StepHandler, type StepType, type World, stepsDefinitions, toFile, typeDefinitions };

package/dist/index.js

@@ -0,0 +1,339 @@
+import { locatorParameter, valueParameter, keysParameter, booleanParameter, enumParameter } from '@letsrunit/gherkin';
+import { locator, setFieldValue, waitAfterInteraction, suppressInterferences, waitForIdle } from '@letsrunit/playwright';
+import { expect } from '@playwright/test';
+import { asFilename, eventually, splitUrl, pathRegexp, sleep, textToHtml } from '@letsrunit/utils';
+import { receiveMail, toEml } from '@letsrunit/mailbox';
+import ISO6391 from 'iso-639-1';
+import metascraper from 'metascraper';
+import metascraperLang from 'metascraper-lang';
+
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var typeDefinitions = [
+  locatorParameter(),
+  valueParameter(),
+  keysParameter(),
+  booleanParameter("visible", "hidden"),
+  booleanParameter("enabled", "disabled", /((?:en|dis)abled)/),
+  booleanParameter("checked", "unchecked", /((?:un)?checked)/),
+  booleanParameter("contains", "not contains", /((?:not )?contains)/),
+  booleanParameter("check", "uncheck", /((?:un)?check)/),
+  booleanParameter("focus", "blur"),
+  enumParameter(["click", "double-click", "right-click", "hover"], /((?:double-|right-)?click|hover)/)
+];
+
+// src/steps/assert.ts
+var assert_exports = {};
+__export(assert_exports, {
+  contain: () => contain,
+  see: () => see
+});
+function expectOrNot(actual, toBe) {
+  return toBe ? expect(actual) : expect(actual).not;
+}
+
+// src/steps/wrappers.ts
+function Given(expression, fn, comment) {
+  return { type: "Given", expression, fn, comment };
+}
+function When(expression, fn, comment) {
+  return { type: "When", expression, fn, comment };
+}
+function Then(expression, fn, comment) {
+  return { type: "Then", expression, fn, comment };
+}
+
+// src/steps/assert.ts
+var WAIT_TIMEOUT = 5e3;
+var see = Then(
+  "The page {contains|not contains} {locator}",
+  async function(visible, selector) {
+    const el = await locator(this.page, selector);
+    await expectOrNot(el, visible).toBeVisible({ timeout: WAIT_TIMEOUT });
+  }
+);
+var contain = Then(
+  "{locator} {contains|not contains} {locator}",
+  async function(selector, contain2, child) {
+    const el = await locator(this.page, selector);
+    const childElement = el.locator(child);
+    await expectOrNot(childElement, contain2).toBeAttached({ timeout: WAIT_TIMEOUT });
+  }
+);
+
+// src/steps/clipboard.ts
+var clipboard_exports = {};
+__export(clipboard_exports, {
+  copy: () => copy,
+  paste: () => paste
+});
+var TIMEOUT = 500;
+async function copyInput(el) {
+  try {
+    return await el.inputValue();
+  } catch {
+  }
+}
+async function copyLink(el) {
+  try {
+    const tag = await el.evaluate((n) => n.tagName.toLowerCase());
+    const href = tag === "a" ? await el.getAttribute("href") : null;
+    if (href) {
+      return href.startsWith("mailto:") ? href.replace(/^mailto:/i, "") : href;
+    }
+  } catch {
+  }
+}
+async function copyText(el) {
+  return await el.textContent() ?? null;
+}
+var copy = When("I copy {locator} to the clipboard", async function(selector) {
+  const el = await locator(this.page, selector);
+  let value = await copyInput(el) ?? await copyLink(el) ?? await copyText(el);
+  this.clipboard = { value };
+});
+var paste = When("I paste from the clipboard into {locator}", async function(selector) {
+  const el = await locator(this.page, selector);
+  const value = this.clipboard?.value || "";
+  await el.fill(String(value), { timeout: TIMEOUT });
+});
+
+// src/steps/form.ts
+var form_exports = {};
+__export(form_exports, {
+  check: () => check,
+  clear: () => clear,
+  focus: () => focus,
+  set: () => set,
+  setRange: () => setRange
+});
+var TIMEOUT2 = 500;
+var DELAY = 500;
+var set = When("I set {locator} to {value}", async function(selector, value) {
+  const el = await locator(this.page, selector);
+  await setFieldValue(el, value, { timeout: TIMEOUT2 });
+  await sleep(DELAY);
+});
+var setRange = When(
+  "I set {locator} to range of {value} to {value}",
+  async function(selector, from, to) {
+    const el = await locator(this.page, selector);
+    await setFieldValue(el, { from, to }, { timeout: TIMEOUT2 });
+    await sleep(DELAY);
+  }
+);
+var clear = When("I clear {locator}", async function(selector) {
+  const el = await locator(this.page, selector);
+  await setFieldValue(el, null, { timeout: TIMEOUT2 });
+  await sleep(DELAY);
+});
+var check = When(
+  "I {check|uncheck} {locator}",
+  async function(check2, selector) {
+    const el = await locator(this.page, selector);
+    await setFieldValue(el, check2, { timeout: TIMEOUT2 });
+    await sleep(DELAY);
+  },
+  "For checkbox input or switch component"
+);
+var focus = When("I {focus|blur} {locator}", async function(focus2, selector) {
+  const el = await locator(this.page, selector);
+  if (focus2) {
+    await el.focus({ timeout: TIMEOUT2 });
+  } else {
+    await el.blur({ timeout: TIMEOUT2 });
+  }
+});
+
+// src/steps/keyboard.ts
+var keyboard_exports = {};
+__export(keyboard_exports, {
+  press: () => press,
+  type: () => type
+});
+var DELAY2 = 500;
+var press = When("I press {keys}", async function(combo) {
+  for (const m of combo.modifiers) await this.page.keyboard.down(m);
+  await this.page.keyboard.press(combo.key);
+  for (const m of combo.modifiers.toReversed()) await this.page.keyboard.up(m);
+  await sleep(DELAY2);
+});
+var type = When("I type {string}", async function(value) {
+  await this.page.keyboard.type(value, { delay: 200 });
+  await sleep(DELAY2);
+});
+
+// src/steps/mailbox.ts
+var mailbox_exports = {};
+__export(mailbox_exports, {
+  receive: () => receive,
+  view: () => view
+});
+var MAX_RECEIVE_WAIT = 12e4;
+var view = Given(
+  `I'm viewing an email sent to {string} with subject {string}`,
+  async function(address, subject) {
+    const emails = await receiveMail(address, { full: true, after: this.startTime, subject, limit: 1 });
+    if (emails.length === 0) {
+      throw new Error(`Did not receive an email with subject "${subject}"`);
+    }
+    const email = emails[0];
+    await this.page.goto("about:blank", { waitUntil: "load" });
+    await this.page.setContent(email.html ?? textToHtml(email.text), { waitUntil: "domcontentloaded" });
+  }
+);
+var receive = Then(
+  "I received an email sent to {string} with subject {string}",
+  async function(address, subject) {
+    const emails = await receiveMail(address, {
+      after: this.startTime,
+      full: true,
+      subject,
+      wait: true,
+      timeout: MAX_RECEIVE_WAIT,
+      limit: 1
+    });
+    if (emails.length === 0) {
+      throw new Error(`Did not receive an email with subject "${subject}"`);
+    }
+    const email = emails[0];
+    this.attach(toEml(email), {
+      mediaType: "message/rfc822",
+      fileName: asFilename(email.subject, "eml")
+    });
+  }
+);
+
+// src/steps/mouse.ts
+var mouse_exports = {};
+__export(mouse_exports, {
+  click: () => click,
+  clickHold: () => clickHold,
+  scroll: () => scroll
+});
+var TIMEOUT3 = 2500;
+async function press2(el, action) {
+  if (action === "hover") {
+    await el.hover({ timeout: TIMEOUT3 });
+  } else {
+    await el.click({
+      button: action === "right-click" ? "right" : "left",
+      clickCount: action === "double-click" ? 2 : 1,
+      timeout: TIMEOUT3
+    });
+  }
+}
+var click = When(
+  "I {click|double-click|right-click|hover} {locator}",
+  async function(action, selector) {
+    const prevUrl = this.page.url();
+    const el = await locator(this.page, selector);
+    await press2(el, action);
+    await waitAfterInteraction(this.page, el, { prevUrl });
+  }
+);
+var clickHold = When(
+  "I {click|double-click|right-click|hover} {locator} while holding {keys}",
+  async function(action, selector, combo) {
+    const prevUrl = this.page.url();
+    const el = await locator(this.page, selector);
+    const keys = [...combo.modifiers, combo.key];
+    for (const m of keys) await this.page.keyboard.down(m);
+    await press2(el, action);
+    for (const m of keys.reverse()) await this.page.keyboard.up(m);
+    await waitAfterInteraction(this.page, el, { prevUrl });
+  }
+);
+var scroll = When("I scroll {locator} into view", async function(selector) {
+  const el = await locator(this.page, selector);
+  await el.scrollIntoViewIfNeeded({ timeout: TIMEOUT3 });
+});
+
+// src/steps/navigation.ts
+var navigation_exports = {};
+__export(navigation_exports, {
+  assertPath: () => assertPath,
+  back: () => back,
+  navHome: () => navHome,
+  navPath: () => navPath,
+  popupClosed: () => popupClosed
+});
+var scrapeLang = metascraper([metascraperLang()]);
+async function getLang(page) {
+  const html = "html" in page ? page.html : await page.content();
+  const url = typeof page.url === "function" ? page.url() : page.url;
+  const { lang = null } = await scrapeLang({ html, url });
+  if (!lang) return null;
+  const code = lang.substring(0, 2);
+  const name = ISO6391.getName(code) || code;
+  return { code, name };
+}
+
+// src/steps/navigation.ts
+async function openPage(world, path) {
+  const { page } = world;
+  const result = await page.goto(path);
+  expect(result?.status()).toBeLessThan(400);
+  await waitForIdle(page);
+  world.lang ??= await getLang(page) || void 0;
+}
+var navHome = Given("I'm on the homepage", async function() {
+  await openPage(this, "/");
+});
+var navPath = Given("I'm on page {string}", async function(path) {
+  await openPage(this, path);
+});
+var popupClosed = Given("all popups are closed", async function() {
+  await suppressInterferences(this.page, { lang: this.lang?.code });
+});
+var assertPath = Then("I should be on page {string}", async function(expectedPath) {
+  await eventually(async () => {
+    const { path: actualPath } = splitUrl(this.page.url());
+    if (expectedPath.includes(":")) {
+      const { regexp, names } = pathRegexp(expectedPath);
+      expect(actualPath, `Expected path ${actualPath} to match pattern ${expectedPath}`).toMatch(regexp);
+      const match = actualPath.match(regexp);
+      this.pathParams = Object.fromEntries(names.map((name, i) => [name, decodeURIComponent(match[i + 1])]));
+    } else {
+      expect(actualPath).toEqual(expectedPath);
+      delete this.pathParams;
+    }
+  });
+});
+var back = When("I go back to the previous page", async function() {
+  await this.page.goBack();
+  await waitForIdle(this.page);
+});
+
+// src/steps/index.ts
+var stepsDefinitions = [
+  ...Object.values(assert_exports),
+  ...Object.values(navigation_exports),
+  ...Object.values(mouse_exports),
+  ...Object.values(form_exports),
+  ...Object.values(keyboard_exports),
+  ...Object.values(mailbox_exports),
+  ...Object.values(clipboard_exports)
+];
+
+// src/utils/file.ts
+function toFile(data, options) {
+  const opt = typeof options === "string" ? { mediaType: options } : options ?? { mediaType: "application/octet-stream" };
+  const type2 = opt.mediaType || "application/octet-stream";
+  const name = opt.fileName || `attachment-${Date.now()}`;
+  if (isReadable(data)) {
+    throw new Error("toFile does not support Readable streams; provide Buffer or string");
+  }
+  const part = typeof data === "string" ? data : new Uint8Array(data);
+  return new File([part], name, { type: type2 });
+}
+function isReadable(value) {
+  return !!value && typeof value === "object" && (typeof value.pipe === "function" || typeof value.read === "function");
+}
+
+export { stepsDefinitions, toFile, typeDefinitions };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parameters.ts","../src/steps/assert.ts","../src/utils/test-helpers.ts","../src/steps/wrappers.ts","../src/steps/clipboard.ts","../src/steps/form.ts","../src/steps/keyboard.ts","../src/steps/mailbox.ts","../src/steps/mouse.ts","../src/steps/navigation.ts","../src/utils/get-lang.ts","../src/steps/index.ts","../src/utils/file.ts"],"names":["contain","locator","TIMEOUT","check","focus","DELAY","sleep","press","expect","type"],"mappings":"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","file":"index.js","sourcesContent":["import { booleanParameter, enumParameter, keysParameter, locatorParameter, valueParameter } from '@letsrunit/gherkin';\n\nexport const typeDefinitions = [\n  locatorParameter(),\n  valueParameter(),\n  keysParameter(),\n\n  booleanParameter('visible', 'hidden'),\n  booleanParameter('enabled', 'disabled', /((?:en|dis)abled)/),\n  booleanParameter('checked', 'unchecked', /((?:un)?checked)/),\n  booleanParameter('contains', 'not contains', /((?:not )?contains)/),\n\n  booleanParameter('check', 'uncheck', /((?:un)?check)/),\n  booleanParameter('focus', 'blur'),\n\n  enumParameter(['click', 'double-click', 'right-click', 'hover'], /((?:double-|right-)?click|hover)/),\n];\n","import { locator } from '@letsrunit/playwright';\nimport { expectOrNot } from '../utils/test-helpers';\nimport { Then } from './wrappers';\n\nconst WAIT_TIMEOUT = 5000;\n\nexport const see = Then(\n  'The page {contains|not contains} {locator}',\n  async function (visible: boolean, selector: string) {\n    const el = await locator(this.page, selector);\n    await expectOrNot(el, visible).toBeVisible({ timeout: WAIT_TIMEOUT });\n  },\n);\n\nexport const contain = Then(\n  '{locator} {contains|not contains} {locator}',\n  async function (selector: string, contain: boolean, child: string) {\n    const el = await locator(this.page, selector);\n    const childElement = el.locator(child);\n    await expectOrNot(childElement, contain).toBeAttached({ timeout: WAIT_TIMEOUT });\n  },\n);\n","import { expect, type Expect } from '@playwright/test';\n\nexport function expectOrNot<T>(\n  actual: T,\n  toBe: boolean\n): ReturnType<Expect<T>> | ReturnType<ReturnType<Expect<T>>['not']> {\n  return toBe ? expect(actual) : expect(actual).not;\n}\n","import type { StepDefinition, StepHandler } from '../types';\n\nexport function Given(expression: string | RegExp, fn: StepHandler, comment?: string): StepDefinition {\n  return { type: 'Given', expression, fn, comment };\n}\n\nexport function When(expression: string | RegExp, fn: StepHandler, comment?: string): StepDefinition {\n  return { type: 'When', expression, fn, comment };\n}\n\nexport function Then(expression: string | RegExp, fn: StepHandler, comment?: string): StepDefinition {\n  return { type: 'Then', expression, fn, comment };\n}\n","import { locator } from '@letsrunit/playwright';\nimport type { Locator } from '@playwright/test';\nimport { When } from './wrappers';\n\nconst TIMEOUT = 500;\n\nasync function copyInput(el: Locator): Promise<string | undefined> {\n  try {\n    return await el.inputValue();\n  } catch {}\n}\n\nasync function copyLink(el: Locator): Promise<string | undefined> {\n  try {\n    const tag = await el.evaluate<string>((n: Element) => n.tagName.toLowerCase());\n    const href = tag === 'a' ? await el.getAttribute('href') : null;\n    if (href) {\n      return href.startsWith('mailto:') ? href.replace(/^mailto:/i, '') : href;\n    }\n  } catch {}\n}\n\nasync function copyText(el: Locator): Promise<string | null> {\n  return (await el.textContent()) ?? null;\n}\n\nexport const copy = When('I copy {locator} to the clipboard', async function (selector: string) {\n  const el = await locator(this.page, selector);\n  let value = (await copyInput(el)) ?? (await copyLink(el)) ?? (await copyText(el));\n\n  this.clipboard = { value };\n});\n\nexport const paste = When('I paste from the clipboard into {locator}', async function (selector: string) {\n  const el = await locator(this.page, selector);\n  const value = this.clipboard?.value || '';\n\n  await el.fill(String(value), { timeout: TIMEOUT });\n});\n","import { locator, setFieldValue } from '@letsrunit/playwright';\nimport { type Scalar, sleep } from '@letsrunit/utils';\nimport { When } from './wrappers';\n\nconst TIMEOUT = 500;\nconst DELAY = 500;\n\nexport const set = When('I set {locator} to {value}', async function (selector: string, value: Scalar | Scalar[]) {\n  const el = await locator(this.page, selector);\n  await setFieldValue(el, value, { timeout: TIMEOUT });\n  await sleep(DELAY);\n});\n\nexport const setRange = When(\n  'I set {locator} to range of {value} to {value}',\n  async function (selector: string, from: Scalar, to: Scalar) {\n    const el = await locator(this.page, selector);\n    await setFieldValue(el, { from, to }, { timeout: TIMEOUT });\n    await sleep(DELAY);\n  },\n);\n\n\nexport const clear = When('I clear {locator}', async function (selector) {\n  const el = await locator(this.page, selector);\n  await setFieldValue(el, null, { timeout: TIMEOUT });\n  await sleep(DELAY);\n});\n\nexport const check = When(\n  'I {check|uncheck} {locator}',\n  async function (check: boolean, selector: string) {\n    const el = await locator(this.page, selector);\n    await setFieldValue(el, check, { timeout: TIMEOUT });\n    await sleep(DELAY);\n  },\n  'For checkbox input or switch component',\n);\n\nexport const focus = When('I {focus|blur} {locator}', async function (focus: boolean, selector: string) {\n  const el = await locator(this.page, selector);\n\n  if (focus) {\n    await el.focus({ timeout: TIMEOUT });\n  } else {\n    await el.blur({ timeout: TIMEOUT });\n  }\n});\n","import type { KeyCombo } from '@letsrunit/gherkin';\nimport { sleep } from '@letsrunit/utils';\nimport { When } from './wrappers';\n\nconst DELAY = 500;\n\nexport const press = When('I press {keys}', async function (combo: KeyCombo) {\n  // Hold modifiers\n  for (const m of combo.modifiers) await this.page.keyboard.down(m);\n\n  // Press final key\n  await this.page.keyboard.press(combo.key);\n\n  // Release modifiers (reverse order)\n  for (const m of combo.modifiers.toReversed()) await this.page.keyboard.up(m);\n\n  await sleep(DELAY);\n});\n\nexport const type = When('I type {string}', async function (value: string) {\n  await this.page.keyboard.type(value, { delay: 200 });\n  await sleep(DELAY);\n});\n","import { receiveMail, toEml } from '@letsrunit/mailbox';\nimport { asFilename, textToHtml } from '@letsrunit/utils';\nimport { Given, Then } from './wrappers';\n\nconst MAX_RECEIVE_WAIT = 120_000; // 2 minutes\n\nexport const view = Given(\n  `I'm viewing an email sent to {string} with subject {string}`,\n  async function (address: string, subject: string) {\n    const emails = await receiveMail(address, { full: true, after: this.startTime, subject, limit: 1 });\n    if (emails.length === 0) {\n      throw new Error(`Did not receive an email with subject \"${subject}\"`);\n    }\n\n    const email = emails[0];\n\n    await this.page.goto('about:blank', { waitUntil: 'load' });\n    await this.page.setContent(email.html ?? textToHtml(email.text!), { waitUntil: 'domcontentloaded' });\n  },\n);\n\nexport const receive = Then(\n  'I received an email sent to {string} with subject {string}',\n  async function (address: string, subject: string) {\n    const emails = await receiveMail(address, {\n      after: this.startTime,\n      full: true,\n      subject,\n      wait: true,\n      timeout: MAX_RECEIVE_WAIT,\n      limit: 1,\n    });\n\n    if (emails.length === 0) {\n      throw new Error(`Did not receive an email with subject \"${subject}\"`);\n    }\n\n    const email = emails[0];\n\n    this.attach(toEml(email), {\n      mediaType: 'message/rfc822',\n      fileName: asFilename(email.subject, 'eml'),\n    });\n  },\n);\n","import type { KeyCombo } from '@letsrunit/gherkin';\nimport { locator, waitAfterInteraction } from '@letsrunit/playwright';\nimport type { Locator } from '@playwright/test';\nimport { When } from './wrappers';\n\nconst TIMEOUT = 2500;\n\ntype MouseAction = 'click' | 'double-click' | 'right-click' | 'hover';\n\nasync function press(el: Locator, action: MouseAction) {\n  if (action === 'hover') {\n    await el.hover({ timeout: TIMEOUT });\n  } else {\n    await el.click({\n      button: action === 'right-click' ? 'right' : 'left',\n      clickCount: action === 'double-click' ? 2 : 1,\n      timeout: TIMEOUT,\n    });\n  }\n}\n\nexport const click = When(\n  'I {click|double-click|right-click|hover} {locator}',\n  async function (action: MouseAction, selector: string) {\n    const prevUrl = this.page.url();\n\n    const el = await locator(this.page, selector);\n    await press(el, action);\n\n    await waitAfterInteraction(this.page, el, { prevUrl });\n  },\n);\n\nexport const clickHold = When(\n  'I {click|double-click|right-click|hover} {locator} while holding {keys}',\n  async function (action: MouseAction, selector: string, combo: KeyCombo) {\n    const prevUrl = this.page.url();\n\n    const el = await locator(this.page, selector);\n    const keys = [...combo.modifiers, combo.key];\n\n    for (const m of keys) await this.page.keyboard.down(m);\n    await press(el, action);\n    for (const m of keys.reverse()) await this.page.keyboard.up(m);\n\n    await waitAfterInteraction(this.page, el, { prevUrl });\n  },\n);\n\nexport const scroll = When('I scroll {locator} into view', async function (selector: string) {\n  const el = await locator(this.page, selector);\n  await el.scrollIntoViewIfNeeded({ timeout: TIMEOUT });\n});\n","import { suppressInterferences, waitForIdle } from '@letsrunit/playwright';\nimport { eventually, pathRegexp, splitUrl } from '@letsrunit/utils';\nimport { expect } from '@playwright/test';\nimport { World } from '../types';\nimport { getLang } from '../utils/get-lang';\nimport { Given, Then, When } from './wrappers';\n\nasync function openPage(world: World, path: string): Promise<void> {\n  const { page } = world;\n\n  const result = await page.goto(path);\n  expect(result?.status()).toBeLessThan(400);\n\n  await waitForIdle(page);\n\n  world.lang ??= (await getLang(page)) || undefined;\n}\n\nexport const navHome = Given(\"I'm on the homepage\", async function () {\n  await openPage(this, '/');\n});\n\nexport const navPath = Given(\"I'm on page {string}\", async function (path: string) {\n  await openPage(this, path);\n});\n\nexport const popupClosed = Given('all popups are closed', async function (){\n  await suppressInterferences(this.page, { lang: this.lang?.code });\n});\n\nexport const assertPath = Then('I should be on page {string}', async function (expectedPath: string) {\n  await eventually(async () => {\n    const { path: actualPath } = splitUrl(this.page.url());\n\n    if (expectedPath.includes(':')) {\n      const { regexp, names } = pathRegexp(expectedPath);\n\n      expect(actualPath, `Expected path ${actualPath} to match pattern ${expectedPath}`).toMatch(regexp);\n\n      const match = actualPath.match(regexp);\n      this.pathParams = Object.fromEntries(names.map((name, i) => [name, decodeURIComponent(match![i + 1])]));\n    } else {\n      expect(actualPath).toEqual(expectedPath);\n      delete this.pathParams;\n    }\n  });\n});\n\nexport const back = When('I go back to the previous page', async function () {\n  await this.page.goBack();\n  await waitForIdle(this.page);\n});\n","import type { Snapshot } from '@letsrunit/playwright';\nimport { Page } from '@playwright/test';\nimport ISO6391 from 'iso-639-1';\nimport metascraper from 'metascraper';\nimport metascraperLang from 'metascraper-lang';\n\nconst scrapeLang = metascraper([metascraperLang()]);\n\nexport async function getLang(\n  page: Pick<Page, 'content' | 'url'> | Snapshot,\n): Promise<{ code: string; name: string} | null> {\n  const html = 'html' in page ? page.html : await page.content();\n  const url = typeof page.url === 'function' ? page.url() : page.url;\n\n  const { lang = null } = await scrapeLang({ html, url });\n  if (!lang) return null;\n\n  const code = lang.substring(0, 2);\n  const name = ISO6391.getName(code) || code;\n\n  return { code, name };\n}\n","import type { StepDefinition } from '../types';\nimport * as assert from './assert';\nimport * as clipboard from './clipboard';\nimport * as form from './form';\nimport * as keyboard from './keyboard';\nimport * as mailbox from './mailbox';\nimport * as mouse from './mouse';\nimport * as navigation from './navigation';\n\n// The order matters for the LLM\nexport const stepsDefinitions: StepDefinition[] = [\n  ...Object.values(assert),\n  ...Object.values(navigation),\n  ...Object.values(mouse),\n  ...Object.values(form),\n  ...Object.values(keyboard),\n  ...Object.values(mailbox),\n  ...Object.values(clipboard),\n];\n","import type { Readable } from 'node:stream';\n\ntype AttachData = string | Buffer | Readable;\ntype AttachOptions = string | {\n  mediaType: string;\n  fileName?: string;\n};\n\nexport function toFile(data: AttachData, options?: AttachOptions): File {\n  const opt =\n    typeof options === 'string'\n      ? { mediaType: options }\n      : options ?? { mediaType: 'application/octet-stream' };\n\n  const type = opt.mediaType || 'application/octet-stream';\n  const name = opt.fileName || `attachment-${Date.now()}`;\n\n  if (isReadable(data)) {\n    throw new Error('toFile does not support Readable streams; provide Buffer or string');\n  }\n\n  const part = typeof data === 'string' ? data : new Uint8Array(data);\n\n  return new File([part], name, { type });\n}\n\nfunction isReadable(value: unknown): value is Readable {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    (typeof (value as any).pipe === 'function' || typeof (value as any).read === 'function')\n  );\n}\n"]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@letsrunit/bdd",
+  "version": "0.1.0",
+  "description": "BDD step definitions for browser automation with letsrunit",
+  "keywords": [
+    "testing",
+    "bdd",
+    "gherkin",
+    "playwright",
+    "letsrunit"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/letsrunit/letsrunit.git",
+    "directory": "packages/bdd"
+  },
+  "bugs": "https://github.com/letsrunit/letsrunit/issues",
+  "homepage": "https://github.com/letsrunit/letsrunit#readme",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "../../node_modules/.bin/tsup",
+    "test": "vitest run",
+    "test:cov": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "gen:stub": "tsx scripts/generate-stub.ts"
+  },
+  "packageManager": "yarn@4.10.3",
+  "dependencies": {
+    "@cucumber/cucumber-expressions": "^18.1.0",
+    "@letsrunit/gherkin": "workspace:*",
+    "@letsrunit/mailbox": "workspace:*",
+    "@letsrunit/playwright": "workspace:*",
+    "@letsrunit/utils": "workspace:*",
+    "@playwright/test": "^1.57.0",
+    "iso-639-1": "^3.1.5",
+    "metascraper": "^5.49.15",
+    "metascraper-lang": "^5.49.15"
+  },
+  "peerDependencies": {
+    "@cucumber/cucumber": "^12.0.0"
+  },
+  "devDependencies": {
+    "@cucumber/cucumber": "^12.5.0",
+    "vitest": "^4.0.17"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}

package/src/_stub.ts

@@ -0,0 +1,13 @@
+// Generated for IDE indexing (WebStorm), never executed.
+import { defineParameterType } from '@cucumber/cucumber';
+
+defineParameterType({ name: 'locator', regexp: /((?:(?:the )?\w+(?: "[^"]*")?|`([^`]+|\\.)*`)(?: with(?:in|out)? (?:(?:the )?\w+(?: "[^"]*")?|`([^`]+|\\.)*`))*)/, transformer: (s: string) => s });
+defineParameterType({ name: 'value', regexp: /"((?:[^"\\]+|\\.)*)"|(-?\d+(?:\.\d+)?)|date (?:of )?((?:today|tomorrow|yesterday|\d+ \w+ (?:ago|from now))(?: (?:at )?\d\d?:\d\d(?:\d\d)?)?|"((?:[^"\\]+|\\.)*)")/, transformer: (s: string) => s });
+defineParameterType({ name: 'keys', regexp: /"([^"]+)"|'([^']+)'/, transformer: (s: string) => s });
+defineParameterType({ name: 'visible|hidden', regexp: /(visible|hidden)/, transformer: (s: string) => s });
+defineParameterType({ name: 'enabled|disabled', regexp: /((?:en|dis)abled)/, transformer: (s: string) => s });
+defineParameterType({ name: 'checked|unchecked', regexp: /((?:un)?checked)/, transformer: (s: string) => s });
+defineParameterType({ name: 'contains|not contains', regexp: /((?:not )?contains)/, transformer: (s: string) => s });
+defineParameterType({ name: 'check|uncheck', regexp: /((?:un)?check)/, transformer: (s: string) => s });
+defineParameterType({ name: 'focus|blur', regexp: /(focus|blur)/, transformer: (s: string) => s });
+defineParameterType({ name: 'click|double-click|right-click|hover', regexp: /((?:double-|right-)?click|hover)/, transformer: (s: string) => s });

package/src/define.ts

@@ -0,0 +1,13 @@
+import { defineParameterType, Given, When, Then } from '@cucumber/cucumber';
+import { typeDefinitions } from './parameters';
+import { stepsDefinitions } from './steps';
+import { sanitizeStepDefinition } from '@letsrunit/gherkin';
+
+for (const type of typeDefinitions) {
+  defineParameterType(type);
+}
+
+for (const step of stepsDefinitions) {
+  const def = step.type === 'Given' ? Given : step.type === 'When' ? When : Then;
+  def(sanitizeStepDefinition(step.expression), step.fn);
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './parameters';
+export * from './steps';
+export * from './types';
+export { toFile } from './utils/file'

package/src/parameters.ts

@@ -0,0 +1,17 @@
+import { booleanParameter, enumParameter, keysParameter, locatorParameter, valueParameter } from '@letsrunit/gherkin';
+
+export const typeDefinitions = [
+  locatorParameter(),
+  valueParameter(),
+  keysParameter(),
+
+  booleanParameter('visible', 'hidden'),
+  booleanParameter('enabled', 'disabled', /((?:en|dis)abled)/),
+  booleanParameter('checked', 'unchecked', /((?:un)?checked)/),
+  booleanParameter('contains', 'not contains', /((?:not )?contains)/),
+
+  booleanParameter('check', 'uncheck', /((?:un)?check)/),
+  booleanParameter('focus', 'blur'),
+
+  enumParameter(['click', 'double-click', 'right-click', 'hover'], /((?:double-|right-)?click|hover)/),
+];

package/src/steps/assert.ts

@@ -0,0 +1,22 @@
+import { locator } from '@letsrunit/playwright';
+import { expectOrNot } from '../utils/test-helpers';
+import { Then } from './wrappers';
+
+const WAIT_TIMEOUT = 5000;
+
+export const see = Then(
+  'The page {contains|not contains} {locator}',
+  async function (visible: boolean, selector: string) {
+    const el = await locator(this.page, selector);
+    await expectOrNot(el, visible).toBeVisible({ timeout: WAIT_TIMEOUT });
+  },
+);
+
+export const contain = Then(
+  '{locator} {contains|not contains} {locator}',
+  async function (selector: string, contain: boolean, child: string) {
+    const el = await locator(this.page, selector);
+    const childElement = el.locator(child);
+    await expectOrNot(childElement, contain).toBeAttached({ timeout: WAIT_TIMEOUT });
+  },
+);

package/src/steps/clipboard.ts

@@ -0,0 +1,39 @@
+import { locator } from '@letsrunit/playwright';
+import type { Locator } from '@playwright/test';
+import { When } from './wrappers';
+
+const TIMEOUT = 500;
+
+async function copyInput(el: Locator): Promise<string | undefined> {
+  try {
+    return await el.inputValue();
+  } catch {}
+}
+
+async function copyLink(el: Locator): Promise<string | undefined> {
+  try {
+    const tag = await el.evaluate<string>((n: Element) => n.tagName.toLowerCase());
+    const href = tag === 'a' ? await el.getAttribute('href') : null;
+    if (href) {
+      return href.startsWith('mailto:') ? href.replace(/^mailto:/i, '') : href;
+    }
+  } catch {}
+}
+
+async function copyText(el: Locator): Promise<string | null> {
+  return (await el.textContent()) ?? null;
+}
+
+export const copy = When('I copy {locator} to the clipboard', async function (selector: string) {
+  const el = await locator(this.page, selector);
+  let value = (await copyInput(el)) ?? (await copyLink(el)) ?? (await copyText(el));
+
+  this.clipboard = { value };
+});
+
+export const paste = When('I paste from the clipboard into {locator}', async function (selector: string) {
+  const el = await locator(this.page, selector);
+  const value = this.clipboard?.value || '';
+
+  await el.fill(String(value), { timeout: TIMEOUT });
+});

package/src/steps/form.ts

@@ -0,0 +1,48 @@
+import { locator, setFieldValue } from '@letsrunit/playwright';
+import { type Scalar, sleep } from '@letsrunit/utils';
+import { When } from './wrappers';
+
+const TIMEOUT = 500;
+const DELAY = 500;
+
+export const set = When('I set {locator} to {value}', async function (selector: string, value: Scalar | Scalar[]) {
+  const el = await locator(this.page, selector);
+  await setFieldValue(el, value, { timeout: TIMEOUT });
+  await sleep(DELAY);
+});
+
+export const setRange = When(
+  'I set {locator} to range of {value} to {value}',
+  async function (selector: string, from: Scalar, to: Scalar) {
+    const el = await locator(this.page, selector);
+    await setFieldValue(el, { from, to }, { timeout: TIMEOUT });
+    await sleep(DELAY);
+  },
+);
+
+
+export const clear = When('I clear {locator}', async function (selector) {
+  const el = await locator(this.page, selector);
+  await setFieldValue(el, null, { timeout: TIMEOUT });
+  await sleep(DELAY);
+});
+
+export const check = When(
+  'I {check|uncheck} {locator}',
+  async function (check: boolean, selector: string) {
+    const el = await locator(this.page, selector);
+    await setFieldValue(el, check, { timeout: TIMEOUT });
+    await sleep(DELAY);
+  },
+  'For checkbox input or switch component',
+);
+
+export const focus = When('I {focus|blur} {locator}', async function (focus: boolean, selector: string) {
+  const el = await locator(this.page, selector);
+
+  if (focus) {
+    await el.focus({ timeout: TIMEOUT });
+  } else {
+    await el.blur({ timeout: TIMEOUT });
+  }
+});

package/src/steps/index.ts

@@ -0,0 +1,19 @@
+import type { StepDefinition } from '../types';
+import * as assert from './assert';
+import * as clipboard from './clipboard';
+import * as form from './form';
+import * as keyboard from './keyboard';
+import * as mailbox from './mailbox';
+import * as mouse from './mouse';
+import * as navigation from './navigation';
+
+// The order matters for the LLM
+export const stepsDefinitions: StepDefinition[] = [
+  ...Object.values(assert),
+  ...Object.values(navigation),
+  ...Object.values(mouse),
+  ...Object.values(form),
+  ...Object.values(keyboard),
+  ...Object.values(mailbox),
+  ...Object.values(clipboard),
+];

package/src/steps/keyboard.ts

@@ -0,0 +1,23 @@
+import type { KeyCombo } from '@letsrunit/gherkin';
+import { sleep } from '@letsrunit/utils';
+import { When } from './wrappers';
+
+const DELAY = 500;
+
+export const press = When('I press {keys}', async function (combo: KeyCombo) {
+  // Hold modifiers
+  for (const m of combo.modifiers) await this.page.keyboard.down(m);
+
+  // Press final key
+  await this.page.keyboard.press(combo.key);
+
+  // Release modifiers (reverse order)
+  for (const m of combo.modifiers.toReversed()) await this.page.keyboard.up(m);
+
+  await sleep(DELAY);
+});
+
+export const type = When('I type {string}', async function (value: string) {
+  await this.page.keyboard.type(value, { delay: 200 });
+  await sleep(DELAY);
+});

package/src/steps/mailbox.ts

@@ -0,0 +1,45 @@
+import { receiveMail, toEml } from '@letsrunit/mailbox';
+import { asFilename, textToHtml } from '@letsrunit/utils';
+import { Given, Then } from './wrappers';
+
+const MAX_RECEIVE_WAIT = 120_000; // 2 minutes
+
+export const view = Given(
+  `I'm viewing an email sent to {string} with subject {string}`,
+  async function (address: string, subject: string) {
+    const emails = await receiveMail(address, { full: true, after: this.startTime, subject, limit: 1 });
+    if (emails.length === 0) {
+      throw new Error(`Did not receive an email with subject "${subject}"`);
+    }
+
+    const email = emails[0];
+
+    await this.page.goto('about:blank', { waitUntil: 'load' });
+    await this.page.setContent(email.html ?? textToHtml(email.text!), { waitUntil: 'domcontentloaded' });
+  },
+);
+
+export const receive = Then(
+  'I received an email sent to {string} with subject {string}',
+  async function (address: string, subject: string) {
+    const emails = await receiveMail(address, {
+      after: this.startTime,
+      full: true,
+      subject,
+      wait: true,
+      timeout: MAX_RECEIVE_WAIT,
+      limit: 1,
+    });
+
+    if (emails.length === 0) {
+      throw new Error(`Did not receive an email with subject "${subject}"`);
+    }
+
+    const email = emails[0];
+
+    this.attach(toEml(email), {
+      mediaType: 'message/rfc822',
+      fileName: asFilename(email.subject, 'eml'),
+    });
+  },
+);

package/src/steps/mouse.ts

@@ -0,0 +1,53 @@
+import type { KeyCombo } from '@letsrunit/gherkin';
+import { locator, waitAfterInteraction } from '@letsrunit/playwright';
+import type { Locator } from '@playwright/test';
+import { When } from './wrappers';
+
+const TIMEOUT = 2500;
+
+type MouseAction = 'click' | 'double-click' | 'right-click' | 'hover';
+
+async function press(el: Locator, action: MouseAction) {
+  if (action === 'hover') {
+    await el.hover({ timeout: TIMEOUT });
+  } else {
+    await el.click({
+      button: action === 'right-click' ? 'right' : 'left',
+      clickCount: action === 'double-click' ? 2 : 1,
+      timeout: TIMEOUT,
+    });
+  }
+}
+
+export const click = When(
+  'I {click|double-click|right-click|hover} {locator}',
+  async function (action: MouseAction, selector: string) {
+    const prevUrl = this.page.url();
+
+    const el = await locator(this.page, selector);
+    await press(el, action);
+
+    await waitAfterInteraction(this.page, el, { prevUrl });
+  },
+);
+
+export const clickHold = When(
+  'I {click|double-click|right-click|hover} {locator} while holding {keys}',
+  async function (action: MouseAction, selector: string, combo: KeyCombo) {
+    const prevUrl = this.page.url();
+
+    const el = await locator(this.page, selector);
+    const keys = [...combo.modifiers, combo.key];
+
+    for (const m of keys) await this.page.keyboard.down(m);
+    await press(el, action);
+    for (const m of keys.reverse()) await this.page.keyboard.up(m);
+
+    await waitAfterInteraction(this.page, el, { prevUrl });
+  },
+);
+
+export const scroll = When('I scroll {locator} into view', async function (selector: string) {
+  const el = await locator(this.page, selector);
+  await el.scrollIntoViewIfNeeded({ timeout: TIMEOUT });
+});

package/src/steps/navigation.ts

@@ -0,0 +1,52 @@
+import { suppressInterferences, waitForIdle } from '@letsrunit/playwright';
+import { eventually, pathRegexp, splitUrl } from '@letsrunit/utils';
+import { expect } from '@playwright/test';
+import { World } from '../types';
+import { getLang } from '../utils/get-lang';
+import { Given, Then, When } from './wrappers';
+
+async function openPage(world: World, path: string): Promise<void> {
+  const { page } = world;
+
+  const result = await page.goto(path);
+  expect(result?.status()).toBeLessThan(400);
+
+  await waitForIdle(page);
+
+  world.lang ??= (await getLang(page)) || undefined;
+}
+
+export const navHome = Given("I'm on the homepage", async function () {
+  await openPage(this, '/');
+});
+
+export const navPath = Given("I'm on page {string}", async function (path: string) {
+  await openPage(this, path);
+});
+
+export const popupClosed = Given('all popups are closed', async function (){
+  await suppressInterferences(this.page, { lang: this.lang?.code });
+});
+
+export const assertPath = Then('I should be on page {string}', async function (expectedPath: string) {
+  await eventually(async () => {
+    const { path: actualPath } = splitUrl(this.page.url());
+
+    if (expectedPath.includes(':')) {
+      const { regexp, names } = pathRegexp(expectedPath);
+
+      expect(actualPath, `Expected path ${actualPath} to match pattern ${expectedPath}`).toMatch(regexp);
+
+      const match = actualPath.match(regexp);
+      this.pathParams = Object.fromEntries(names.map((name, i) => [name, decodeURIComponent(match![i + 1])]));
+    } else {
+      expect(actualPath).toEqual(expectedPath);
+      delete this.pathParams;
+    }
+  });
+});
+
+export const back = When('I go back to the previous page', async function () {
+  await this.page.goBack();
+  await waitForIdle(this.page);
+});

package/src/steps/wrappers.ts

@@ -0,0 +1,13 @@
+import type { StepDefinition, StepHandler } from '../types';
+
+export function Given(expression: string | RegExp, fn: StepHandler, comment?: string): StepDefinition {
+  return { type: 'Given', expression, fn, comment };
+}
+
+export function When(expression: string | RegExp, fn: StepHandler, comment?: string): StepDefinition {
+  return { type: 'When', expression, fn, comment };
+}
+
+export function Then(expression: string | RegExp, fn: StepHandler, comment?: string): StepDefinition {
+  return { type: 'Then', expression, fn, comment };
+}

package/src/types.ts

@@ -0,0 +1,23 @@
+import type { World as BaseWorld } from '@cucumber/cucumber';
+import type { BrowserContextOptions, Page } from '@playwright/test';
+
+export interface World extends BaseWorld<BrowserContextOptions> {
+  page: Page;
+  startTime: number;
+  pathParams?: Record<string, string>;
+  lang?: {
+    code: string;
+    name: string;
+  };
+  [_: string]: any;
+}
+
+export type StepHandler = (this: World, ...args: any[]) => Promise<void> | void;
+export type StepType = 'Given' | 'When' | 'Then';
+
+export interface StepDefinition {
+  type: StepType;
+  expression: string | RegExp;
+  fn: StepHandler;
+  comment?: string;
+}

package/src/utils/file.ts

@@ -0,0 +1,33 @@
+import type { Readable } from 'node:stream';
+
+type AttachData = string | Buffer | Readable;
+type AttachOptions = string | {
+  mediaType: string;
+  fileName?: string;
+};
+
+export function toFile(data: AttachData, options?: AttachOptions): File {
+  const opt =
+    typeof options === 'string'
+      ? { mediaType: options }
+      : options ?? { mediaType: 'application/octet-stream' };
+
+  const type = opt.mediaType || 'application/octet-stream';
+  const name = opt.fileName || `attachment-${Date.now()}`;
+
+  if (isReadable(data)) {
+    throw new Error('toFile does not support Readable streams; provide Buffer or string');
+  }
+
+  const part = typeof data === 'string' ? data : new Uint8Array(data);
+
+  return new File([part], name, { type });
+}
+
+function isReadable(value: unknown): value is Readable {
+  return (
+    !!value &&
+    typeof value === 'object' &&
+    (typeof (value as any).pipe === 'function' || typeof (value as any).read === 'function')
+  );
+}

package/src/utils/get-lang.ts

@@ -0,0 +1,22 @@
+import type { Snapshot } from '@letsrunit/playwright';
+import { Page } from '@playwright/test';
+import ISO6391 from 'iso-639-1';
+import metascraper from 'metascraper';
+import metascraperLang from 'metascraper-lang';
+
+const scrapeLang = metascraper([metascraperLang()]);
+
+export async function getLang(
+  page: Pick<Page, 'content' | 'url'> | Snapshot,
+): Promise<{ code: string; name: string} | null> {
+  const html = 'html' in page ? page.html : await page.content();
+  const url = typeof page.url === 'function' ? page.url() : page.url;
+
+  const { lang = null } = await scrapeLang({ html, url });
+  if (!lang) return null;
+
+  const code = lang.substring(0, 2);
+  const name = ISO6391.getName(code) || code;
+
+  return { code, name };
+}

package/src/utils/test-helpers.ts

@@ -0,0 +1,8 @@
+import { expect, type Expect } from '@playwright/test';
+
+export function expectOrNot<T>(
+  actual: T,
+  toBe: boolean
+): ReturnType<Expect<T>> | ReturnType<ReturnType<Expect<T>>['not']> {
+  return toBe ? expect(actual) : expect(actual).not;
+}