@harnessed-ts/cypress 0.0.0-stage → 0.7.0

package/dist/index.cjs

@@ -0,0 +1,535 @@
+'use strict';
+
+var core = require('@harnessed-ts/core');
+var resolve = require('@harnessed-ts/resolve');
+var dom = require('@testing-library/dom');
+var userEvent = require('@testing-library/user-event');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var userEvent__default = /*#__PURE__*/_interopDefault(userEvent);
+
+// src/driver-id.ts
+var CYPRESS_DRIVER = "cypress";
+
+// src/real-events.ts
+var NAMED_KEYS = {
+  Enter: { code: "Enter", keyCode: 13, text: "\r" },
+  Tab: { code: "Tab", keyCode: 9 },
+  Backspace: { code: "Backspace", keyCode: 8 },
+  Delete: { code: "Delete", keyCode: 46 },
+  Escape: { code: "Escape", keyCode: 27 },
+  Space: { code: "Space", keyCode: 32, text: " " },
+  ArrowUp: { code: "ArrowUp", keyCode: 38 },
+  ArrowDown: { code: "ArrowDown", keyCode: 40 },
+  ArrowLeft: { code: "ArrowLeft", keyCode: 37 },
+  ArrowRight: { code: "ArrowRight", keyCode: 39 },
+  Home: { code: "Home", keyCode: 36 },
+  End: { code: "End", keyCode: 35 },
+  PageUp: { code: "PageUp", keyCode: 33 },
+  PageDown: { code: "PageDown", keyCode: 34 },
+  Insert: { code: "Insert", keyCode: 45 }
+};
+function keyDefinition(key) {
+  const named = NAMED_KEYS[key];
+  if (named !== void 0) return { key: key === "Space" ? " " : key, ...named };
+  if ([...key].length === 1) {
+    const upper = key.toUpperCase();
+    const code = /[A-Z]/.test(upper) ? `Key${upper}` : /[0-9]/.test(key) ? `Digit${key}` : "";
+    const keyCode = /[A-Z0-9]/.test(upper) ? upper.charCodeAt(0) : 0;
+    return { key, code, keyCode, text: key };
+  }
+  throw new Error(
+    `harnessed: realEvents cannot press "${key}". It presses single characters and ${Object.keys(NAMED_KEYS).join(", ")}; drop realEvents to press it through user-event.`
+  );
+}
+function send(command, params) {
+  return Promise.resolve(Cypress.automation("remote:debugger:protocol", { command, params }));
+}
+function requireChromium() {
+  if (!Cypress.isBrowser({ family: "chromium" })) {
+    throw new Error(
+      `harnessed: realEvents drives Chrome DevTools Protocol input, which only Chromium-family browsers (Chrome, Edge, Electron) have; this run is in ${Cypress.browser.name}. Leave realEvents off to use user-event there.`
+    );
+  }
+}
+function framesDownTo(target, within) {
+  for (const frame of within.querySelectorAll("iframe")) {
+    if (frame.contentWindow === target) return [frame];
+    const inner = frame.contentDocument;
+    const path = inner === null ? null : framesDownTo(target, inner);
+    if (path !== null) return [frame, ...path];
+  }
+  return null;
+}
+function centreOf(element) {
+  element.scrollIntoView({ block: "center", inline: "center" });
+  const box = element.getBoundingClientRect();
+  let x = box.left + box.width / 2;
+  let y = box.top + box.height / 2;
+  const view = element.ownerDocument.defaultView;
+  const top = window.top ?? window;
+  const frames = view === null || view === top ? [] : framesDownTo(view, top.document) ?? [];
+  for (const frame of frames.reverse()) {
+    const frameBox = frame.getBoundingClientRect();
+    const scale = frame.offsetWidth > 0 ? frameBox.width / frame.offsetWidth : 1;
+    const style = frame.ownerDocument.defaultView?.getComputedStyle(frame);
+    const insetX = frame.clientLeft + parseFloat(style?.paddingLeft ?? "0");
+    const insetY = frame.clientTop + parseFloat(style?.paddingTop ?? "0");
+    x = frameBox.left + (insetX + x) * scale;
+    y = frameBox.top + (insetY + y) * scale;
+  }
+  return { x, y };
+}
+async function realHover(element) {
+  const { x, y } = centreOf(element);
+  await send("Input.dispatchMouseEvent", { type: "mouseMoved", x, y });
+}
+async function realClick(element) {
+  const { x, y } = centreOf(element);
+  await send("Input.dispatchMouseEvent", { type: "mouseMoved", x, y });
+  const press = { x, y, button: "left", clickCount: 1 };
+  await send("Input.dispatchMouseEvent", { type: "mousePressed", buttons: 1, ...press });
+  await send("Input.dispatchMouseEvent", { type: "mouseReleased", buttons: 0, ...press });
+}
+async function realPress(key) {
+  const { text, keyCode, ...definition } = keyDefinition(key);
+  const common = { ...definition, windowsVirtualKeyCode: keyCode, nativeVirtualKeyCode: keyCode };
+  await send(
+    "Input.dispatchKeyEvent",
+    text === void 0 ? { type: "rawKeyDown", ...common } : { type: "keyDown", text, unmodifiedText: text, ...common }
+  );
+  await send("Input.dispatchKeyEvent", { type: "keyUp", ...common });
+}
+async function realInsertText(text) {
+  await send("Input.insertText", { text });
+}
+
+// src/cypress-query.ts
+function toKeyboardInput(key) {
+  return key.length === 1 ? key : `{${key}}`;
+}
+var users = /* @__PURE__ */ new WeakMap();
+function userFor(env) {
+  const { document } = env;
+  const bound = users.get(env);
+  if (bound !== void 0 && bound.document === document) return bound.user;
+  const user = userEvent__default.default.setup({ document });
+  users.set(env, { document, user });
+  return user;
+}
+async function waitUntil(condition, container, timeout) {
+  let refused;
+  await dom.waitFor(
+    async () => {
+      try {
+        await condition();
+      } catch (error) {
+        if (!(error instanceof resolve.FrameEntryError || error instanceof core.StrictModeViolation)) {
+          throw error;
+        }
+        refused = error;
+      }
+    },
+    // The default container is the spec frame's document, which never changes;
+    // watching the AUT's is what lets a mutation end the wait early.
+    { container, timeout }
+  );
+  if (refused !== void 0) throw refused;
+}
+var CypressQuery = class _CypressQuery extends core.Query {
+  constructor(env, scope, selector) {
+    super(scope, selector);
+    this.env = env;
+  }
+  env;
+  clone(selector) {
+    return new _CypressQuery(this.env, this.scope, selector);
+  }
+  /** Read per query: navigation replaces the document, and with it the body. */
+  get container() {
+    const { document } = this.env;
+    return document.body ?? document.documentElement;
+  }
+  element(options) {
+    return resolve.resolveOne(this.container, this.scope, this.selector, options?.timeout);
+  }
+  /** Keeps the command log telling the story: one entry per harness action. */
+  log(action, detail) {
+    if (!this.env.log) return;
+    const target = core.describeScope(this.scope, this.selector);
+    Cypress.log({
+      name: "harness",
+      message: `**${action}** ${target}${detail === void 0 ? "" : ` ${detail}`}`,
+      consoleProps: () => ({ action, target, detail })
+    });
+  }
+  get user() {
+    return userFor(this.env);
+  }
+  get real() {
+    if (this.env.realEvents) requireChromium();
+    return this.env.realEvents;
+  }
+  /**
+   * Trusted input returns as soon as the browser has dispatched it, so a read
+   * straight after could beat a framework that renders on a timer of its own
+   * (zoneless Angular schedules after the event). A zero-delay timer in the AUT
+   * window runs after any it queued, as user-event's own pause does in the
+   * other mode.
+   */
+  async afterReal(action) {
+    await action;
+    await new Promise((resolve) => this.env.window.setTimeout(resolve, 0));
+  }
+  /**
+   * Every match, resolved in one pass — see `DomQuery.all` for why. Each result is
+   * bound to its node and falls back to index resolution once that node leaves
+   * the document.
+   */
+  async all() {
+    return (await resolve.resolveAll(this.container, this.scope, this.selector)).map(
+      (element, index) => new BoundCypressQuery(this.env, this.scope, core.nth(this.selector, index), element)
+    );
+  }
+  // --- interactions -------------------------------------------------------
+  async click(options) {
+    this.log("click");
+    const element = await this.element(options);
+    await (this.real ? this.afterReal(realClick(element)) : this.user.click(element));
+  }
+  async fill(value, options) {
+    this.log("fill", JSON.stringify(value));
+    const element = await this.element(options);
+    if (this.real) {
+      await this.afterReal(realReplace(element, value));
+      return;
+    }
+    await this.user.clear(element);
+    if (value !== "") await this.user.type(element, value);
+  }
+  async clear(options) {
+    this.log("clear");
+    const element = await this.element(options);
+    await (this.real ? this.afterReal(realReplace(element, "")) : this.user.clear(element));
+  }
+  async check(options) {
+    this.log("check");
+    const element = await this.element(options);
+    if (element.checked) return;
+    await (this.real ? this.afterReal(realClick(element)) : this.user.click(element));
+  }
+  async uncheck(options) {
+    this.log("uncheck");
+    const element = await this.element(options);
+    if (!element.checked) return;
+    await (this.real ? this.afterReal(realClick(element)) : this.user.click(element));
+  }
+  /**
+   * Through user-event in both modes: a native `<select>` opens a popup the
+   * browser draws outside the page, which CDP pointer input cannot operate.
+   */
+  async selectOption(value, options) {
+    this.log("selectOption", JSON.stringify(value));
+    const element = await this.element(options);
+    if (element.multiple) {
+      const selected = [...element.selectedOptions].map((option) => option.value);
+      if (selected.length > 0) await this.user.deselectOptions(element, selected);
+    }
+    await this.user.selectOptions(element, value);
+  }
+  async hover(options) {
+    this.log("hover");
+    const element = await this.element(options);
+    await (this.real ? this.afterReal(realHover(element)) : this.user.hover(element));
+  }
+  async focus(options) {
+    this.log("focus");
+    (await this.element(options)).focus();
+  }
+  async blur(options) {
+    this.log("blur");
+    (await this.element(options)).blur();
+  }
+  async press(key, options) {
+    this.log("press", key);
+    const element = await this.element(options);
+    element.focus();
+    await (this.real ? this.afterReal(realPress(key)) : this.user.keyboard(toKeyboardInput(key)));
+  }
+  // --- observations -------------------------------------------------------
+  /**
+   * Through user-event, real events or not: the Chrome DevTools Protocol sets
+   * files only from paths on disk, and a File here has none.
+   */
+  async upload(files, options) {
+    const list = Array.isArray(files) ? files : [files];
+    this.log("upload", list.map((file) => file.name).join(", "));
+    const input = resolve.fileInputOf(await this.element(options));
+    core.checkFileTarget(input, list.length, this.scope, this.selector);
+    await this.user.upload(input, list);
+  }
+  async boundingBox(options) {
+    this.log("boundingBox");
+    return resolve.boundingBoxOf(await this.element(options), this.env.document);
+  }
+  async text(options) {
+    this.log("text");
+    return ((await this.element(options)).textContent ?? "").trim();
+  }
+  async inputValue(options) {
+    this.log("inputValue");
+    const element = await this.element(options);
+    return element.value ?? "";
+  }
+  async attribute(name, options) {
+    this.log("attribute", name);
+    return (await this.element(options)).getAttribute(name);
+  }
+  async isVisible(options) {
+    this.log("isVisible");
+    return this.visible(options);
+  }
+  /**
+   * A real browser lays the page out, so visibility is a layout question — a
+   * box, and not `visibility: hidden` — answered the way Playwright answers it,
+   * rather than the dom driver's computed-style walk.
+   */
+  async visible(options) {
+    try {
+      return resolve.isVisibleInLayout(await this.element(options), this.env.document);
+    } catch (error) {
+      if (error instanceof resolve.FrameEntryError || error instanceof core.StrictModeViolation) throw error;
+      return false;
+    }
+  }
+  async isEnabled(options) {
+    this.log("isEnabled");
+    const element = await this.element(options);
+    const disabled = element.disabled === true || element.closest(":disabled") !== null;
+    return core.enabledFrom(disabled, element.getAttribute("aria-disabled"));
+  }
+  async isChecked(options) {
+    this.log("isChecked");
+    const element = await this.element(options);
+    return core.checkedFrom(
+      element.getAttribute("aria-checked"),
+      Boolean(element.checked)
+    );
+  }
+  async selectedOptions(options) {
+    this.log("selectedOptions");
+    const element = await this.element(options);
+    return [...element.selectedOptions ?? []].map((option) => option.value);
+  }
+  // --- waiting ------------------------------------------------------------
+  async waitFor(state, options) {
+    this.log("waitFor", state);
+    const timeout = core.timeoutFor(options?.timeout);
+    const root = this.env.document.documentElement;
+    if (state === "visible") {
+      await waitUntil(
+        async () => {
+          if (!await this.visible({ timeout })) throw new Error("not visible yet");
+        },
+        root,
+        timeout
+      );
+      return;
+    }
+    await waitUntil(
+      async () => {
+        if (await this.count() !== 0 && await this.visible({ timeout })) {
+          throw new Error("still visible");
+        }
+      },
+      root,
+      timeout
+    );
+  }
+  async count() {
+    return resolve.countAll(this.container, this.scope, this.selector);
+  }
+};
+var SET_VALUE_TYPES = ["color", "date", "time", "datetime-local", "month", "range", "week"];
+function setValue(input, value) {
+  const setter = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(input), "value")?.set;
+  if (setter === void 0) input.value = value;
+  else setter.call(input, value);
+  if (input.value !== value) {
+    throw new Error(
+      `harnessed: "${value}" is not a valid value for an <input type="${input.type}">.`
+    );
+  }
+  input.dispatchEvent(new Event("input", { bubbles: true, composed: true }));
+  input.dispatchEvent(new Event("change", { bubbles: true }));
+}
+async function realReplace(element, value) {
+  element.focus();
+  const input = element;
+  if (element.localName === "input" && SET_VALUE_TYPES.includes(input.type)) {
+    setValue(input, value);
+    return;
+  }
+  if (element.localName === "input" || element.localName === "textarea") {
+    element.select();
+  } else {
+    element.ownerDocument.getSelection()?.selectAllChildren(element);
+  }
+  await (value === "" ? realPress("Delete") : realInsertText(value));
+}
+var BoundCypressQuery = class extends CypressQuery {
+  constructor(env, scope, selector, bound) {
+    super(env, scope, selector);
+    this.bound = bound;
+  }
+  bound;
+  async element(options) {
+    if (this.bound.isConnected) return this.bound;
+    return super.element(options);
+  }
+};
+core.registerDriver(CYPRESS_DRIVER, (env, scope, selector) => {
+  return new CypressQuery(env, scope, selector);
+});
+var POLL_MS = 20;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function baseOf(window2) {
+  const baseUrl = Cypress.config("baseUrl");
+  if (baseUrl !== null && baseUrl !== "") return baseUrl;
+  if (/^https?:$/.test(window2.location.protocol)) return window2.location.href;
+  return void 0;
+}
+function resolveUrl(window2, url) {
+  try {
+    return new URL(url, baseOf(window2));
+  } catch {
+    throw new Error(
+      `harnessed: cannot resolve "${url}": the application under test has not loaded a page yet and Cypress has no baseUrl. Set baseUrl, or pass an absolute URL.`
+    );
+  }
+}
+function sameDocument(from, to) {
+  const current = new URL(from);
+  return to.hash !== "" && current.href.split("#")[0] === to.href.split("#")[0];
+}
+async function goto(env, url) {
+  if (Cypress.testingType === "component") {
+    throw new Error(
+      "harnessed: goto() cannot run in component testing \u2014 the component is mounted in the spec frame, so navigating it would end the test. Navigate in an e2e spec, or mount the screen you want."
+    );
+  }
+  const { window: window2 } = env;
+  const leaving = window2.document;
+  const target = resolveUrl(window2, url);
+  const sameDoc = window2.location.protocol !== "about:" && sameDocument(window2.location.href, target);
+  window2.location.href = target.href;
+  if (sameDoc) return;
+  const timeout = Cypress.config("pageLoadTimeout");
+  const deadline = Date.now() + timeout;
+  for (; ; ) {
+    const document = window2.document;
+    if (document !== leaving && document.readyState !== "loading") return;
+    if (Date.now() > deadline) {
+      throw new Error(`harnessed: ${target.href} did not load within ${timeout}ms.`);
+    }
+    await sleep(POLL_MS);
+  }
+}
+core.registerNavigation(CYPRESS_DRIVER, {
+  goto,
+  currentUrl(env) {
+    return env.window.location.href;
+  },
+  async waitForUrl(env, matches, timeout) {
+    const { window: window2 } = env;
+    const deadline = Date.now() + timeout;
+    while (!matches(new URL(window2.location.href))) {
+      if (Date.now() > deadline) {
+        throw new Error(
+          `harnessed: the URL did not match within ${timeout}ms; it is ${window2.location.href}.`
+        );
+      }
+      await sleep(POLL_MS);
+    }
+  }
+});
+
+// src/env.ts
+function cypress({
+  window: window2,
+  document,
+  realEvents = false,
+  log = true
+}) {
+  return {
+    driver: CYPRESS_DRIVER,
+    window: window2,
+    get document() {
+      return document ?? window2.document;
+    },
+    realEvents,
+    log
+  };
+}
+function timeoutOf(options) {
+  return options?.timeout ?? core.getConfig().defaultTimeout * 4;
+}
+function envFor(window2, options) {
+  return cypress({
+    window: window2,
+    realEvents: options?.realEvents ?? false,
+    log: options?.log ?? true
+  });
+}
+function inPage(subject, fn, options) {
+  return cy.window({ log: false }).then({ timeout: timeoutOf(options) }, async (window2) => ({
+    result: await fn(envFor(window2, options))
+  })).then(({ result }) => cy.wrap(result === void 0 ? subject : result, { log: false }));
+}
+function registerCommands() {
+  Cypress.Commands.add(
+    "harnessEnv",
+    { prevSubject: "optional" },
+    (subject, fn, options) => inPage(subject, fn, options)
+  );
+  Cypress.Commands.add(
+    "harness",
+    { prevSubject: "optional" },
+    (subject, Harness, fnOrOptions, maybeOptions) => {
+      const fn = typeof fnOrOptions === "function" ? fnOrOptions : void 0;
+      const options = typeof fnOrOptions === "function" ? maybeOptions : fnOrOptions;
+      Cypress.log({ name: "harness", message: Harness.name });
+      return inPage(
+        subject,
+        (env) => {
+          const harness = new Harness(env);
+          return fn === void 0 ? harness : fn(harness);
+        },
+        options
+      );
+    }
+  );
+  Cypress.Commands.add(
+    "visitPage",
+    (Page, params, rawOptions) => {
+      const options = rawOptions;
+      return cy.window({ log: false }).then((window2) => {
+        const page = new Page(envFor(window2, options));
+        return cy.visit(page.urlFor(params)).then({ timeout: timeoutOf(options) }, async () => {
+          await page.expectReady();
+          return page;
+        });
+      });
+    }
+  );
+}
+
+exports.CYPRESS_DRIVER = CYPRESS_DRIVER;
+exports.CypressQuery = CypressQuery;
+exports.cypress = cypress;
+exports.registerCommands = registerCommands;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/driver-id.ts","../src/real-events.ts","../src/cypress-query.ts","../src/navigation.ts","../src/env.ts","../src/commands.ts"],"names":["userEvent","waitForCondition","FrameEntryError","StrictModeViolation","Query","resolveOne","describeScope","resolveAll","withNth","fileInputOf","checkFileTarget","boundingBoxOf","isVisibleInLayout","enabledFrom","checkedFrom","timeoutFor","countAll","registerDriver","window","registerNavigation","getConfig"],"mappings":"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","file":"index.cjs","sourcesContent":["/** Its own module so `env.ts` and `cypress-query.ts` can share it without a cycle. */\nexport const CYPRESS_DRIVER = 'cypress'\n","/**\n * Trusted input through the Chrome DevTools Protocol, for `realEvents: true`.\n *\n * Cypress's own `trigger` and the cypress-real-events commands are `cy`\n * commands, and a harness runs inside a promise where nothing can be enqueued.\n * `Cypress.automation('remote:debugger:protocol')` is the one way to reach CDP\n * that is itself a promise. The browser then produces the events — `isTrusted`,\n * default actions and all — rather than a script imitating them.\n */\n\ninterface KeyDefinition {\n  code: string\n  keyCode: number\n  /** What the key types, for the keys that type something. */\n  text?: string\n}\n\n/** The named keys a harness presses. Printable characters are derived instead. */\nconst NAMED_KEYS: Record<string, KeyDefinition> = {\n  Enter: { code: 'Enter', keyCode: 13, text: '\\r' },\n  Tab: { code: 'Tab', keyCode: 9 },\n  Backspace: { code: 'Backspace', keyCode: 8 },\n  Delete: { code: 'Delete', keyCode: 46 },\n  Escape: { code: 'Escape', keyCode: 27 },\n  Space: { code: 'Space', keyCode: 32, text: ' ' },\n  ArrowUp: { code: 'ArrowUp', keyCode: 38 },\n  ArrowDown: { code: 'ArrowDown', keyCode: 40 },\n  ArrowLeft: { code: 'ArrowLeft', keyCode: 37 },\n  ArrowRight: { code: 'ArrowRight', keyCode: 39 },\n  Home: { code: 'Home', keyCode: 36 },\n  End: { code: 'End', keyCode: 35 },\n  PageUp: { code: 'PageUp', keyCode: 33 },\n  PageDown: { code: 'PageDown', keyCode: 34 },\n  Insert: { code: 'Insert', keyCode: 45 },\n}\n\nfunction keyDefinition(key: string): { key: string } & KeyDefinition {\n  const named = NAMED_KEYS[key]\n  if (named !== undefined) return { key: key === 'Space' ? ' ' : key, ...named }\n  if ([...key].length === 1) {\n    const upper = key.toUpperCase()\n    const code = /[A-Z]/.test(upper) ? `Key${upper}` : /[0-9]/.test(key) ? `Digit${key}` : ''\n    const keyCode = /[A-Z0-9]/.test(upper) ? upper.charCodeAt(0) : 0\n    return { key, code, keyCode, text: key }\n  }\n  throw new Error(\n    `harnessed: realEvents cannot press \"${key}\". It presses single characters and ` +\n      `${Object.keys(NAMED_KEYS).join(', ')}; drop realEvents to press it through user-event.`,\n  )\n}\n\nfunction send(command: string, params: Record<string, unknown>): Promise<unknown> {\n  return Promise.resolve(Cypress.automation('remote:debugger:protocol', { command, params }))\n}\n\n/** Refuses early and by name, instead of failing inside the automation channel. */\nexport function requireChromium(): void {\n  if (!Cypress.isBrowser({ family: 'chromium' })) {\n    throw new Error(\n      `harnessed: realEvents drives Chrome DevTools Protocol input, which only ` +\n        `Chromium-family browsers (Chrome, Edge, Electron) have; this run is in ` +\n        `${Cypress.browser.name}. Leave realEvents off to use user-event there.`,\n    )\n  }\n}\n\n/**\n * The `<iframe>` elements between the top-level page and `target`, outermost\n * first. Searched for from the top rather than climbed to with `frameElement`,\n * because Cypress hides the AUT's `frameElement` from the app (it reads `null`).\n */\nfunction framesDownTo(target: Window, within: Document): HTMLIFrameElement[] | null {\n  for (const frame of within.querySelectorAll('iframe')) {\n    if (frame.contentWindow === target) return [frame]\n    // A cross-origin frame's document is null: nothing to search in it.\n    const inner = frame.contentDocument\n    const path = inner === null ? null : framesDownTo(target, inner)\n    if (path !== null) return [frame, ...path]\n  }\n  return null\n}\n\n/**\n * The centre of an element in the top-level viewport, which is where CDP input\n * is addressed. The AUT is a frame inside Cypress's runner — scaled to fit it,\n * in run mode — and a framed harness adds frames of its own, so each level adds\n * its frame's offset and scales by the transform the runner put on it.\n */\nfunction centreOf(element: Element): { x: number; y: number } {\n  element.scrollIntoView({ block: 'center', inline: 'center' })\n  const box = element.getBoundingClientRect()\n  let x = box.left + box.width / 2\n  let y = box.top + box.height / 2\n  const view = element.ownerDocument.defaultView\n  const top = window.top ?? window\n  const frames = view === null || view === top ? [] : (framesDownTo(view, top.document) ?? [])\n  for (const frame of frames.reverse()) {\n    const frameBox = frame.getBoundingClientRect()\n    const scale = frame.offsetWidth > 0 ? frameBox.width / frame.offsetWidth : 1\n    const style = frame.ownerDocument.defaultView?.getComputedStyle(frame)\n    const insetX = frame.clientLeft + parseFloat(style?.paddingLeft ?? '0')\n    const insetY = frame.clientTop + parseFloat(style?.paddingTop ?? '0')\n    x = frameBox.left + (insetX + x) * scale\n    y = frameBox.top + (insetY + y) * scale\n  }\n  return { x, y }\n}\n\nexport async function realHover(element: Element): Promise<void> {\n  const { x, y } = centreOf(element)\n  await send('Input.dispatchMouseEvent', { type: 'mouseMoved', x, y })\n}\n\nexport async function realClick(element: Element): Promise<void> {\n  const { x, y } = centreOf(element)\n  await send('Input.dispatchMouseEvent', { type: 'mouseMoved', x, y })\n  const press = { x, y, button: 'left', clickCount: 1 }\n  await send('Input.dispatchMouseEvent', { type: 'mousePressed', buttons: 1, ...press })\n  await send('Input.dispatchMouseEvent', { type: 'mouseReleased', buttons: 0, ...press })\n}\n\n/** One key, down then up, into whatever has focus. */\nexport async function realPress(key: string): Promise<void> {\n  const { text, keyCode, ...definition } = keyDefinition(key)\n  const common = { ...definition, windowsVirtualKeyCode: keyCode, nativeVirtualKeyCode: keyCode }\n  // `keyDown` with text is what types; a key that types nothing is a raw key.\n  await send(\n    'Input.dispatchKeyEvent',\n    text === undefined\n      ? { type: 'rawKeyDown', ...common }\n      : { type: 'keyDown', text, unmodifiedText: text, ...common },\n  )\n  await send('Input.dispatchKeyEvent', { type: 'keyUp', ...common })\n}\n\n/** Text into whatever has focus, the way an IME commits it — Playwright's `fill`. */\nexport async function realInsertText(text: string): Promise<void> {\n  await send('Input.insertText', { text })\n}\n","import { Query, registerDriver } from '@harnessed-ts/core'\nimport type { BoundingBox, EnvConfig, Selector, WaitOptions, WaitState } from '@harnessed-ts/core'\nimport {\n  checkedFrom,\n  checkFileTarget,\n  describeScope,\n  enabledFrom,\n  nth as withNth,\n  StrictModeViolation,\n  timeoutFor,\n} from '@harnessed-ts/core'\nimport {\n  boundingBoxOf,\n  countAll,\n  fileInputOf,\n  FrameEntryError,\n  isVisibleInLayout,\n  resolveAll,\n  resolveOne,\n} from '@harnessed-ts/resolve'\nimport { waitFor as waitForCondition } from '@testing-library/dom'\nimport userEvent from '@testing-library/user-event'\nimport type { UserEvent } from '@testing-library/user-event'\nimport { CYPRESS_DRIVER } from './driver-id'\nimport type { CypressEnv } from './env'\nimport { realClick, realHover, realInsertText, realPress, requireChromium } from './real-events'\n\n/** Playwright key names such as `Enter` map onto user-event's `{Enter}` syntax. */\nfunction toKeyboardInput(key: string): string {\n  return key.length === 1 ? key : `{${key}}`\n}\n\n/**\n * One user-event instance per env and AUT document — the dom driver's one\n * `userEvent.setup()` per test, made lazily.\n *\n * It has to be bound to the AUT's document: by default it binds to the spec\n * frame's, which is a different page. Navigation brings a new document, so the\n * binding is renewed when the document changes. And it must not outlive the\n * env: user-event remembers the last element the pointer was over, and in\n * component testing — one document for the whole run — that element may sit in\n * a frame an earlier test unmounted, whose window is gone.\n */\nconst users = new WeakMap<CypressEnv, { document: Document; user: UserEvent }>()\n\nfunction userFor(env: CypressEnv): UserEvent {\n  const { document } = env\n  const bound = users.get(env)\n  if (bound !== undefined && bound.document === document) return bound.user\n  const user = userEvent.setup({ document })\n  users.set(env, { document, user })\n  return user\n}\n\n/**\n * Testing Library's `waitFor` retries every throw, but a frame that cannot be\n * entered never becomes enterable, and several matches never become one — so\n * either ends the wait at once.\n */\nasync function waitUntil(\n  condition: () => Promise<void>,\n  container: HTMLElement,\n  timeout: number,\n): Promise<void> {\n  let refused: FrameEntryError | StrictModeViolation | undefined\n  await waitForCondition(\n    async () => {\n      try {\n        await condition()\n      } catch (error) {\n        if (!(error instanceof FrameEntryError || error instanceof StrictModeViolation)) {\n          throw error\n        }\n        refused = error\n      }\n    },\n    // The default container is the spec frame's document, which never changes;\n    // watching the AUT's is what lets a mutation end the wait early.\n    { container, timeout },\n  )\n  if (refused !== undefined) throw refused\n}\n\n/**\n * Cypress driver. It runs inside the `cy.harness` bridge's promise, in the spec\n * frame, and reaches into the application under test's frame — same-origin, so\n * the shared resolver works on its document directly, exactly as the dom driver\n * does on jsdom's.\n */\nexport class CypressQuery extends Query {\n  constructor(\n    protected readonly env: CypressEnv,\n    scope: readonly Selector[],\n    selector: Selector,\n  ) {\n    super(scope, selector)\n  }\n\n  protected override clone(selector: Selector): Query {\n    return new CypressQuery(this.env, this.scope, selector)\n  }\n\n  /** Read per query: navigation replaces the document, and with it the body. */\n  private get container(): HTMLElement {\n    const { document } = this.env\n    return document.body ?? document.documentElement\n  }\n\n  protected element(options?: WaitOptions): Promise<HTMLElement> {\n    return resolveOne(this.container, this.scope, this.selector, options?.timeout)\n  }\n\n  /** Keeps the command log telling the story: one entry per harness action. */\n  protected log(action: string, detail?: string): void {\n    if (!this.env.log) return\n    const target = describeScope(this.scope, this.selector)\n    Cypress.log({\n      name: 'harness',\n      message: `**${action}** ${target}${detail === undefined ? '' : ` ${detail}`}`,\n      consoleProps: () => ({ action, target, detail }),\n    })\n  }\n\n  private get user(): UserEvent {\n    return userFor(this.env)\n  }\n\n  private get real(): boolean {\n    if (this.env.realEvents) requireChromium()\n    return this.env.realEvents\n  }\n\n  /**\n   * Trusted input returns as soon as the browser has dispatched it, so a read\n   * straight after could beat a framework that renders on a timer of its own\n   * (zoneless Angular schedules after the event). A zero-delay timer in the AUT\n   * window runs after any it queued, as user-event's own pause does in the\n   * other mode.\n   */\n  private async afterReal(action: Promise<void>): Promise<void> {\n    await action\n    await new Promise<void>(resolve => this.env.window.setTimeout(resolve, 0))\n  }\n\n  /**\n   * Every match, resolved in one pass — see `DomQuery.all` for why. Each result is\n   * bound to its node and falls back to index resolution once that node leaves\n   * the document.\n   */\n  override async all(): Promise<Query[]> {\n    return (await resolveAll(this.container, this.scope, this.selector)).map(\n      (element, index) =>\n        new BoundCypressQuery(this.env, this.scope, withNth(this.selector, index), element),\n    )\n  }\n\n  // --- interactions -------------------------------------------------------\n\n  override async click(options?: WaitOptions): Promise<void> {\n    this.log('click')\n    const element = await this.element(options)\n    await (this.real ? this.afterReal(realClick(element)) : this.user.click(element))\n  }\n\n  override async fill(value: string, options?: WaitOptions): Promise<void> {\n    this.log('fill', JSON.stringify(value))\n    const element = await this.element(options)\n    if (this.real) {\n      await this.afterReal(realReplace(element, value))\n      return\n    }\n    await this.user.clear(element)\n    // user-event throws on an empty string, and clearing is the whole intent\n    // anyway — which is also what Playwright's fill('') does.\n    if (value !== '') await this.user.type(element, value)\n  }\n\n  override async clear(options?: WaitOptions): Promise<void> {\n    this.log('clear')\n    const element = await this.element(options)\n    await (this.real ? this.afterReal(realReplace(element, '')) : this.user.clear(element))\n  }\n\n  override async check(options?: WaitOptions): Promise<void> {\n    this.log('check')\n    const element = await this.element(options)\n    if ((element as HTMLInputElement).checked) return\n    await (this.real ? this.afterReal(realClick(element)) : this.user.click(element))\n  }\n\n  override async uncheck(options?: WaitOptions): Promise<void> {\n    this.log('uncheck')\n    const element = await this.element(options)\n    if (!(element as HTMLInputElement).checked) return\n    await (this.real ? this.afterReal(realClick(element)) : this.user.click(element))\n  }\n\n  /**\n   * Through user-event in both modes: a native `<select>` opens a popup the\n   * browser draws outside the page, which CDP pointer input cannot operate.\n   */\n  override async selectOption(value: string | string[], options?: WaitOptions): Promise<void> {\n    this.log('selectOption', JSON.stringify(value))\n    const element = (await this.element(options)) as HTMLSelectElement\n    // user-event adds to a multi-select's existing selection; Playwright replaces\n    // it. Replacing is the useful semantic and the one the shared API promises,\n    // so clear first.\n    if (element.multiple) {\n      const selected = [...element.selectedOptions].map(option => option.value)\n      if (selected.length > 0) await this.user.deselectOptions(element, selected)\n    }\n    await this.user.selectOptions(element, value)\n  }\n\n  override async hover(options?: WaitOptions): Promise<void> {\n    this.log('hover')\n    const element = await this.element(options)\n    await (this.real ? this.afterReal(realHover(element)) : this.user.hover(element))\n  }\n\n  override async focus(options?: WaitOptions): Promise<void> {\n    this.log('focus')\n    ;(await this.element(options)).focus()\n  }\n\n  override async blur(options?: WaitOptions): Promise<void> {\n    this.log('blur')\n    ;(await this.element(options)).blur()\n  }\n\n  override async press(key: string, options?: WaitOptions): Promise<void> {\n    this.log('press', key)\n    const element = await this.element(options)\n    element.focus()\n    await (this.real ? this.afterReal(realPress(key)) : this.user.keyboard(toKeyboardInput(key)))\n  }\n\n  // --- observations -------------------------------------------------------\n\n  /**\n   * Through user-event, real events or not: the Chrome DevTools Protocol sets\n   * files only from paths on disk, and a File here has none.\n   */\n  override async upload(files: File | File[], options?: WaitOptions): Promise<void> {\n    const list = Array.isArray(files) ? files : [files]\n    this.log('upload', list.map(file => file.name).join(', '))\n    const input = fileInputOf(await this.element(options))\n    checkFileTarget(input, list.length, this.scope, this.selector)\n    await this.user.upload(input, list)\n  }\n\n  override async boundingBox(options?: WaitOptions): Promise<BoundingBox> {\n    this.log('boundingBox')\n    return boundingBoxOf(await this.element(options), this.env.document)\n  }\n\n  override async text(options?: WaitOptions): Promise<string> {\n    this.log('text')\n    return ((await this.element(options)).textContent ?? '').trim()\n  }\n\n  override async inputValue(options?: WaitOptions): Promise<string> {\n    this.log('inputValue')\n    const element = await this.element(options)\n    return (element as HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement).value ?? ''\n  }\n\n  override async attribute(name: string, options?: WaitOptions): Promise<string | null> {\n    this.log('attribute', name)\n    return (await this.element(options)).getAttribute(name)\n  }\n\n  override async isVisible(options?: WaitOptions): Promise<boolean> {\n    this.log('isVisible')\n    return this.visible(options)\n  }\n\n  /**\n   * A real browser lays the page out, so visibility is a layout question — a\n   * box, and not `visibility: hidden` — answered the way Playwright answers it,\n   * rather than the dom driver's computed-style walk.\n   */\n  private async visible(options?: WaitOptions): Promise<boolean> {\n    try {\n      return isVisibleInLayout(await this.element(options), this.env.document)\n    } catch (error) {\n      // Several matches is ambiguity, not invisibility: answering false would\n      // claim that nodes on screen are not.\n      if (error instanceof FrameEntryError || error instanceof StrictModeViolation) throw error\n      // Not on screen at all, or an index past the last match. Prefer isAbsent()\n      // to ask this — it answers without first waiting out the retry timeout.\n      return false\n    }\n  }\n\n  override async isEnabled(options?: WaitOptions): Promise<boolean> {\n    this.log('isEnabled')\n    const element = await this.element(options)\n    // The DOM property accounts for an ancestor `<fieldset disabled>` where the\n    // attribute does not — see the dom driver.\n    const disabled =\n      (element as HTMLInputElement).disabled === true || element.closest(':disabled') !== null\n    return enabledFrom(disabled, element.getAttribute('aria-disabled'))\n  }\n\n  override async isChecked(options?: WaitOptions): Promise<boolean> {\n    this.log('isChecked')\n    const element = await this.element(options)\n    return checkedFrom(\n      element.getAttribute('aria-checked'),\n      Boolean((element as HTMLInputElement).checked),\n    )\n  }\n\n  override async selectedOptions(options?: WaitOptions): Promise<string[]> {\n    this.log('selectedOptions')\n    const element = (await this.element(options)) as HTMLSelectElement\n    return [...(element.selectedOptions ?? [])].map(option => option.value)\n  }\n\n  // --- waiting ------------------------------------------------------------\n\n  override async waitFor(state: WaitState, options?: WaitOptions): Promise<void> {\n    this.log('waitFor', state)\n    const timeout = timeoutFor(options?.timeout)\n    const root = this.env.document.documentElement\n    if (state === 'visible') {\n      await waitUntil(\n        async () => {\n          if (!(await this.visible({ timeout }))) throw new Error('not visible yet')\n        },\n        root,\n        timeout,\n      )\n      return\n    }\n    await waitUntil(\n      async () => {\n        if ((await this.count()) !== 0 && (await this.visible({ timeout }))) {\n          throw new Error('still visible')\n        }\n      },\n      root,\n      timeout,\n    )\n  }\n\n  override async count(): Promise<number> {\n    return countAll(this.container, this.scope, this.selector)\n  }\n}\n\n/**\n * Input types Playwright's `fill()` sets directly rather than types into: their\n * value is not text, so keystrokes into them mean nothing.\n */\nconst SET_VALUE_TYPES = ['color', 'date', 'time', 'datetime-local', 'month', 'range', 'week']\n\n/**\n * Sets the value and fires the events a person's edit ends with, as Playwright\n * does for these types. The setter is the prototype's, not the element's own:\n * React shadows `value` on the instance to track it, and a write through that\n * shadow would make the `input` event look like no change at all.\n */\nfunction setValue(input: HTMLInputElement, value: string): void {\n  const setter = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(input), 'value')?.set\n  if (setter === undefined) input.value = value\n  else setter.call(input, value)\n  if (input.value !== value) {\n    throw new Error(\n      `harnessed: \"${value}\" is not a valid value for an <input type=\"${input.type}\">.`,\n    )\n  }\n  input.dispatchEvent(new Event('input', { bubbles: true, composed: true }))\n  input.dispatchEvent(new Event('change', { bubbles: true }))\n}\n\n/**\n * Selects what the field holds and types over it, so the browser fires the\n * trusted input events a person's keystrokes would. Empty means delete. A\n * date, time, colour or range input takes no typing, so its value is set.\n */\nasync function realReplace(element: HTMLElement, value: string): Promise<void> {\n  element.focus()\n  // localName, not instanceof: the element belongs to the AUT's realm, not ours.\n  const input = element as HTMLInputElement\n  if (element.localName === 'input' && SET_VALUE_TYPES.includes(input.type)) {\n    setValue(input, value)\n    return\n  }\n  if (element.localName === 'input' || element.localName === 'textarea') {\n    ;(element as HTMLInputElement | HTMLTextAreaElement).select()\n  } else {\n    element.ownerDocument.getSelection()?.selectAllChildren(element)\n  }\n  await (value === '' ? realPress('Delete') : realInsertText(value))\n}\n\n/** A query pinned to a node `all()` already found. See `BoundDomQuery`. */\nclass BoundCypressQuery extends CypressQuery {\n  constructor(\n    env: CypressEnv,\n    scope: readonly Selector[],\n    selector: Selector,\n    private readonly bound: HTMLElement,\n  ) {\n    super(env, scope, selector)\n  }\n\n  protected override async element(options?: WaitOptions): Promise<HTMLElement> {\n    if (this.bound.isConnected) return this.bound\n    // A re-render replaced the node; the selector still carries this query's\n    // index, so ordinary resolution finds the replacement.\n    return super.element(options)\n  }\n}\n\n/**\n * Registering on import is what lets `@harnessed-ts/core` stay driver-free: core\n * holds a registry keyed by driver id and never imports a driver itself.\n */\nregisterDriver(CYPRESS_DRIVER, (env: EnvConfig, scope, selector) => {\n  return new CypressQuery(env as CypressEnv, scope, selector)\n})\n","import { registerNavigation } from '@harnessed-ts/core'\nimport type { EnvConfig } from '@harnessed-ts/core'\nimport { CYPRESS_DRIVER } from './driver-id'\nimport type { CypressEnv } from './env'\n\nconst POLL_MS = 20\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms))\n}\n\n/**\n * Where a relative URL is resolved from: Cypress's `baseUrl`, as Playwright\n * resolves against its `baseURL` — never the page the AUT happens to be on, or\n * the same `goto('step-two')` would land somewhere different from each page.\n * Without a `baseUrl`, the AUT's own URL is the only base there is; the AUT\n * starts each test on `about:blank`, which resolves nothing.\n */\nfunction baseOf(window: Window): string | undefined {\n  const baseUrl = Cypress.config('baseUrl')\n  if (baseUrl !== null && baseUrl !== '') return baseUrl\n  if (/^https?:$/.test(window.location.protocol)) return window.location.href\n  return undefined\n}\n\nfunction resolveUrl(window: Window, url: string): URL {\n  try {\n    return new URL(url, baseOf(window))\n  } catch {\n    throw new Error(\n      `harnessed: cannot resolve \"${url}\": the application under test has not loaded a ` +\n        `page yet and Cypress has no baseUrl. Set baseUrl, or pass an absolute URL.`,\n    )\n  }\n}\n\n/** Only the fragment differs, so the browser scrolls instead of loading a document. */\nfunction sameDocument(from: string, to: URL): boolean {\n  const current = new URL(from)\n  return to.hash !== '' && current.href.split('#')[0] === to.href.split('#')[0]\n}\n\n/**\n * Navigates inside the bridge's promise. Assigning `location.href` asks the AUT\n * frame to load a new document; Cypress sees the load the same way it sees a link\n * click and re-instruments the page. What the promise has to wait for is the\n * swap itself — the old document gone and the new one parsed — which is what\n * Playwright's `domcontentloaded` waits for too. Readiness beyond that is the\n * page's own `expectReady()`.\n */\nasync function goto(env: EnvConfig, url: string): Promise<void> {\n  if (Cypress.testingType === 'component') {\n    throw new Error(\n      'harnessed: goto() cannot run in component testing — the component is mounted in ' +\n        'the spec frame, so navigating it would end the test. Navigate in an e2e spec, ' +\n        'or mount the screen you want.',\n    )\n  }\n  const { window } = env as CypressEnv\n  const leaving = window.document\n  const target = resolveUrl(window, url)\n  const sameDoc =\n    window.location.protocol !== 'about:' && sameDocument(window.location.href, target)\n  window.location.href = target.href\n  if (sameDoc) return\n\n  // A first load through Vite's dev server can take a while; Cypress's own\n  // budget for a page load is the honest one to wait out.\n  const timeout = Cypress.config('pageLoadTimeout')\n  const deadline = Date.now() + timeout\n  for (;;) {\n    const document = window.document\n    if (document !== leaving && document.readyState !== 'loading') return\n    if (Date.now() > deadline) {\n      throw new Error(`harnessed: ${target.href} did not load within ${timeout}ms.`)\n    }\n    await sleep(POLL_MS)\n  }\n}\n\n/**\n * This driver can navigate, so it registers the capability a page's `goto()`\n * runs on. `currentUrl` and `waitForUrl` read the AUT's own location, which is\n * always the live one: `window` is the frame's WindowProxy.\n */\nregisterNavigation(CYPRESS_DRIVER, {\n  goto,\n  currentUrl(env) {\n    return (env as CypressEnv).window.location.href\n  },\n  async waitForUrl(env, matches, timeout) {\n    const { window } = env as CypressEnv\n    const deadline = Date.now() + timeout\n    while (!matches(new URL(window.location.href))) {\n      if (Date.now() > deadline) {\n        throw new Error(\n          `harnessed: the URL did not match within ${timeout}ms; it is ${window.location.href}.`,\n        )\n      }\n      await sleep(POLL_MS)\n    }\n  },\n})\n","import type { EnvConfig } from '@harnessed-ts/core'\nimport { CYPRESS_DRIVER } from './driver-id'\n// Imported for its side effect: constructing an env is the moment the driver has\n// to be in the registry, and a bare re-export could be tree-shaken away.\nimport './cypress-query'\nimport './navigation'\n\nexport { CYPRESS_DRIVER }\n\nexport interface CypressEnv extends EnvConfig {\n  readonly driver: typeof CYPRESS_DRIVER\n  /**\n   * The application under test's window — what `cy.window()` yields. That is the\n   * AUT frame's WindowProxy, which stays the same object when the frame\n   * navigates, so it is safe to hold across a `goto()`.\n   */\n  readonly window: Window\n  /**\n   * Where queries start. Read from `window` at every query unless it was pinned:\n   * navigation replaces the document, and a query must never search the one the\n   * frame has left.\n   */\n  readonly document: Document\n  /**\n   * Interactions go through Chrome DevTools Protocol input — trusted events from\n   * the browser itself — instead of `@testing-library/user-event`. Chromium only.\n   */\n  readonly realEvents: boolean\n  /** Whether each harness action writes an entry to Cypress's command log. */\n  readonly log: boolean\n}\n\nexport interface CypressEnvOptions {\n  /** The AUT window: `cy.window()`'s subject. */\n  window: Window\n  /** Pins queries to one document. Omit it to follow the AUT through navigation. */\n  document?: Document\n  /** Trusted CDP input instead of user-event. Chromium only. Default `false`. */\n  realEvents?: boolean\n  /** Write each harness action to the command log. Default `true`. */\n  log?: boolean\n}\n\n/**\n * Builds the env a harness is constructed with under Cypress. The commands in\n * `@harnessed-ts/cypress/support` build it for you; call this directly only when\n * you already hold the AUT window.\n */\nexport function cypress({\n  window,\n  document,\n  realEvents = false,\n  log = true,\n}: CypressEnvOptions): CypressEnv {\n  return {\n    driver: CYPRESS_DRIVER,\n    window,\n    get document(): Document {\n      return document ?? window.document\n    },\n    realEvents,\n    log,\n  }\n}\n","import { getConfig } from '@harnessed-ts/core'\nimport type { EnvConfig, WaitOptions } from '@harnessed-ts/core'\nimport { cypress } from './env'\nimport type { CypressEnv } from './env'\n\n/** What every bridge command accepts. */\nexport interface HarnessCommandOptions {\n  /**\n   * How long the whole callback may take. Defaults to four times the configured\n   * `defaultTimeout`: one harness flow is several waits in a row, and Cypress's own\n   * 4 s command timeout would otherwise cut it short.\n   */\n  timeout?: number\n  /** Trusted CDP input instead of user-event. Chromium only. */\n  realEvents?: boolean\n  /** Write each harness action to the command log. Default `true`. */\n  log?: boolean\n}\n\n/** Any harness or page class: constructed from an env, like every harness. */\nexport type HarnessClass<H> = new (env: EnvConfig) => H\n\n/** What `cy.visitPage` needs of a page — structural, so this package does not depend on `@harnessed-ts/page`. */\nexport interface VisitablePage {\n  // Method syntax on purpose: a page's `urlFor` takes its own params tuple, and\n  // only a method signature accepts every one of them.\n  urlFor(...args: unknown[]): string\n  expectReady(options?: WaitOptions): Promise<void>\n}\n\n/** The params `PageClass.urlFor` takes, then the command's options. */\nexport type VisitPageArgs<P extends VisitablePage> = [\n  ...Parameters<P['urlFor']>,\n  options?: HarnessCommandOptions,\n]\n\n/** What a callback command yields: its result, or the subject when it resolves nothing. */\nexport type Yielded<T, Subject> = T extends void | undefined ? Subject : T\n\ndeclare global {\n  // Cypress's augmentation point is this global namespace.\n  namespace Cypress {\n    // The type parameter is Cypress's, default and all; a merged declaration only\n    // has to repeat its name.\n    interface Chainable<Subject> {\n      /**\n       * Runs `fn` against the application under test with a harnessed env, and\n       * yields what it resolves to — or, like `cy.then`, passes the subject\n       * through when it resolves nothing. One command: everything inside is\n       * awaited promises, never `cy` commands.\n       */\n      harnessEnv<T>(\n        fn: (env: CypressEnv) => T | PromiseLike<T>,\n        options?: HarnessCommandOptions,\n      ): Chainable<Yielded<T, Subject>>\n      /** Yields a harness constructed against the application under test. */\n      harness<H>(Harness: HarnessClass<H>, options?: HarnessCommandOptions): Chainable<H>\n      /**\n       * Constructs a harness against the application under test and awaits `fn`\n       * with it, yielding what `fn` resolves to (or passing the subject through,\n       * when that is nothing):\n       *\n       * ```ts\n       * cy.harness(LoginFormHarness, async form => {\n       *   await form.fillIn({ email: 'ada@example.com' })\n       *   await expect(form).not.to.be.absent\n       * })\n       * ```\n       */\n      harness<H, T>(\n        Harness: HarnessClass<H>,\n        fn: (harness: H) => T | PromiseLike<T>,\n        options?: HarnessCommandOptions,\n      ): Chainable<Yielded<T, Subject>>\n      /**\n       * `cy.visit(page.urlFor(params))`, then waits for the page's `expectReady()`\n       * and yields the page. Navigation belongs to Cypress's queue, which is why\n       * this is a command and `page.goto()` is not the way in.\n       */\n      visitPage<P extends VisitablePage>(\n        Page: HarnessClass<P>,\n        ...args: VisitPageArgs<P>\n      ): Chainable<P>\n    }\n  }\n}\n\nfunction timeoutOf(options?: HarnessCommandOptions): number {\n  return options?.timeout ?? getConfig().defaultTimeout * 4\n}\n\nfunction envFor(window: Window, options?: HarnessCommandOptions): CypressEnv {\n  return cypress({\n    window,\n    realEvents: options?.realEvents ?? false,\n    log: options?.log ?? true,\n  })\n}\n\n/**\n * The bridge. Cypress commands are enqueued, not awaited, and a promise cannot\n * enqueue one — so a harness runs entirely inside a single `then`, as plain\n * promises against the AUT document. Cypress waits for the promise and fails the\n * test with whatever it rejects with.\n *\n * What it yields is `Yielded`: the result, or the subject when the result is\n * `undefined`. A `then` cannot yield `undefined` — it passes its own subject,\n * the AUT window, through instead — so the result travels boxed, and `cy.wrap`\n * yields it as is, `undefined` included.\n */\nfunction inPage<T>(\n  subject: unknown,\n  fn: (env: CypressEnv) => T | PromiseLike<T>,\n  options?: HarnessCommandOptions,\n): Cypress.Chainable<unknown> {\n  return cy\n    .window({ log: false })\n    .then({ timeout: timeoutOf(options) }, async window => ({\n      result: await fn(envFor(window, options)),\n    }))\n    .then(({ result }) => cy.wrap(result === undefined ? subject : result, { log: false }))\n}\n\n/**\n * Registers `cy.harnessEnv`, `cy.harness` and `cy.visitPage`. Importing\n * `@harnessed-ts/cypress/support` calls this; call it yourself only if you\n * register commands from your own support file instead.\n */\nexport function registerCommands(): void {\n  // 'optional': chained from anything or from nothing. The subject is only ever\n  // passed through, never acted on.\n  Cypress.Commands.add(\n    'harnessEnv',\n    { prevSubject: 'optional' },\n    <T>(\n      subject: unknown,\n      fn: (env: CypressEnv) => T | PromiseLike<T>,\n      options?: HarnessCommandOptions,\n    ) => inPage(subject, fn, options),\n  )\n\n  Cypress.Commands.add(\n    'harness',\n    { prevSubject: 'optional' },\n    <H, T>(\n      subject: unknown,\n      Harness: HarnessClass<H>,\n      fnOrOptions?: ((harness: H) => T | PromiseLike<T>) | HarnessCommandOptions,\n      maybeOptions?: HarnessCommandOptions,\n    ) => {\n      const fn = typeof fnOrOptions === 'function' ? fnOrOptions : undefined\n      const options = typeof fnOrOptions === 'function' ? maybeOptions : fnOrOptions\n      Cypress.log({ name: 'harness', message: Harness.name })\n      return inPage(\n        subject,\n        env => {\n          const harness = new Harness(env)\n          return fn === undefined ? harness : fn(harness)\n        },\n        options,\n      )\n    },\n  )\n\n  Cypress.Commands.add(\n    'visitPage',\n    (Page: HarnessClass<VisitablePage>, params?: unknown, rawOptions?: unknown) => {\n      // Cypress erases the generic signature here; the declaration above is what\n      // callers are checked against.\n      const options = rawOptions as HarnessCommandOptions | undefined\n      return cy.window({ log: false }).then(window => {\n        // urlFor needs no navigation, so the page can be built before the visit;\n        // the AUT window it holds is the same object after it.\n        const page = new Page(envFor(window, options))\n        return cy.visit(page.urlFor(params)).then({ timeout: timeoutOf(options) }, async () => {\n          await page.expectReady()\n          return page\n        })\n      })\n    },\n  )\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { cypress, CYPRESS_DRIVER } from './env';
+export type { CypressEnv, CypressEnvOptions } from './env';
+export { CypressQuery } from './cypress-query';
+export { registerCommands } from './commands';
+export type { HarnessClass, HarnessCommandOptions, VisitablePage, VisitPageArgs, Yielded, } from './commands';
+//# sourceMappingURL=index.d.ts.map