@harnessed-ts/cypress 0.0.0-stage → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,97 @@
+# @harnessed-ts/cypress
+
+## 0.7.0
+
+### Minor Changes
+
+- ec06bdf: Vue, Solid, Svelte and Angular join React and Ember as conformance-tested UI frameworks, and node:test, Bun and Nightwatch join the runners.
+
+  New packages: `@harnessed-ts/nightwatch` drives Nightwatch 3 through the injected resolver, under Nightwatch's own runner and its Mocha runner, in end-to-end and component tests (`@nightwatch/react`, `@nightwatch/vue`), with cross-origin frames. `@harnessed-ts/angular` drives zoneless Angular 21+: every action settles at `fixture.whenStable()`, or at the `ApplicationRef`'s for an app bootstrapped without TestBed, and `goto()` drives a provided router.
+
+  `@harnessed-ts/core/register` loads TypeScript harnesses under `node --import`: esbuild strips the types, lowers standard decorators and `accessor`, and compiles JSX. `@harnessed-ts/core/bun` does the same as a `bun test` preload, so harnesses keep the standard decorator protocol whatever `experimentalDecorators` the tsconfig sets.
+
+  `@harnessed-ts/dom/matchers/bun` registers the matchers with `bun:test`. The dom driver runs on happy-dom too: it focuses the frames leading to an interaction's target, finds a frame's `<iframe>` where `frameElement` is unset, and reads a select's selection off `options`.
+
+  `@harnessed-ts/resolve/webdriver` holds the WebDriver half of injected resolution, shared by the WebdriverIO and Nightwatch drivers. `@harnessed-ts/gherkin/nightwatch` adapts the cucumber-js world to Nightwatch's Cucumber runner.
+
+  `@harnessed-ts/playwright`, and `@harnessed-ts/cypress` under `realEvents`, give the page a task after every action, so a read straight after it sees what a framework that renders on a timer (zoneless Angular) has rendered. The injectable resolver installs on the page's `window` rather than the script's global, which under Firefox's WebDriver is a sandbox in front of it.
+
+  `@harnessed-ts/conformance` exports `fixtureParity()`, the per-view parity check a port of the fixture to another framework runs, naming the first place its markup parts from the React original; it detects a simulated DOM from the DOM's own window.
+
+  `@harnessed-ts/eslint-plugin` recognises Nightwatch's, Angular's and Vue Test Utils' raw queries, and looks in `nightwatch/` by default. `npx @harnessed-ts/claude install` detects Angular, Nightwatch, node:test and Bun.
+
+### Patch Changes
+
+- Updated dependencies [ec06bdf]
+  - @harnessed-ts/core@0.7.0
+  - @harnessed-ts/resolve@0.7.0
+
+## 0.6.0
+
+### Minor Changes
+
+- e324e94: ember-test-selectors style test ids: `configure({ testIdAttribute: 'data-test-*' })` makes `testId('x')` match any element that has the attribute `data-test-x`, whatever its value, with the same scoping, strictness, `{ global: true }`, frame and absence rules as before under every driver. A plain attribute name keeps matching by value. A presence id is held to letters, digits, `-`, `_`, `.` and `:`, and anything else (or a `RegExp`) is refused rather than spliced into a selector.
+
+  `Query.boundingBox()` resolves to `{ x, y, width, height }`: the target's border box in CSS pixels, relative to the top-level viewport, offset by every frame crossed. Strict, and on an absent target it rejects after the timeout, as `text()` does. A node that draws no box reads as all zeros, and so does every node under the dom driver: jsdom computes no layout.
+
+  `Query.upload(files)` sets the files of an `<input type="file">`, or of the input a `<label>` is for, and fires `input` and `change`, replacing any earlier selection. It refuses any other element, and several files for an input that is not `multiple`. Puppeteer, WebdriverIO and TestCafe take only paths, so there each `File` is written to a temporary directory first: its name and bytes arrive, and the browser infers its type from the extension.
+
+  `Query` gains two abstract members, so a driver outside this repo implements both to keep compiling; the conformance catalog pins all three changes.
+
+  `@harnessed-ts/eslint-plugin` supports ESLint 8.57 and legacy `.eslintrc`: the peer range is now `>=8.57`, `legacy-recommended` and `legacy-strict` name the rules under `@harnessed-ts/`, and the CJS build exposes `rules` and `configs` at the top level, where eslintrc reads them.
+
+  `npx @harnessed-ts/claude install` detects ember-test-selectors attributes (in `.gts`, `.gjs` and `.hbs` files too) and writes `testIdAttribute: 'data-test-*'`.
+
+  `@harnessed-ts/storybook` writes and finds its story-ready marker under a `data-test-*` config, where `StoryPage` waits for it.
+
+### Patch Changes
+
+- Updated dependencies [e324e94]
+  - @harnessed-ts/core@0.6.0
+  - @harnessed-ts/resolve@0.6.0
+
+## 0.5.0
+
+### Patch Changes
+
+- @harnessed-ts/core@0.5.0
+  - @harnessed-ts/resolve@0.5.0
+
+## 0.4.0
+
+### Minor Changes
+
+- 9666a3d: A new Cypress driver for e2e and component tests: `cy.harness(Cls, async h => …)` runs a harness inside one command against the application under test, `cy.visitPage(Page, params)` visits a page's `urlFor()` and waits for it to be ready, and `goto()` works inside the bridge in e2e tests. Interactions use user-event by default, or trusted Chrome DevTools Protocol input with `realEvents: true` on Chromium.
+- 1823546: `isVisible()`, `waitFor('visible')` and `waitFor('hidden')` on a target matching
+  several nodes now reject with the shared strict-mode violation, at once, under
+  every driver. The dom, Ember, Vitest browser mode and Cypress drivers answered
+  `false` from `isVisible()`, waited out the timeout in `waitFor('visible')`, and —
+  worse — resolved `waitFor('hidden')` at once, passing a wait for three rendered
+  nodes to disappear; Playwright's waits raised its own wording instead of the
+  shared one. An `nth()`
+  past the last match answers `false` from `isVisible()` and counts as hidden, as it
+  does under Playwright — Puppeteer and TestCafe used to reject it as an index out
+  of range.
+
+  Core exports `StrictModeViolation`, the class `strictViolation()` now returns, so a
+  driver can tell ambiguity apart from absence. It is the class a caller catches
+  under every driver: core also exports `reviveStrictViolation()`, which the
+  Puppeteer, WebdriverIO and TestCafe drivers apply to what the page throws, so
+  a violation raised in the page arrives as core's class, worded exactly as an
+  in-process driver words it. `instanceof StrictModeViolation` checks a brand
+  rather than the prototype, so it holds across two copies of core in one page —
+  Cypress bundles the support file and each spec separately.
+
+  `WaitState` now documents the rule it is held to: a state joins only when every
+  driver honours it with the same meaning, so a runner's own states — Playwright's
+  `attached` and `detached` — stay out of the shared interface.
+
+### Patch Changes
+
+- Updated dependencies [9666a3d]
+- Updated dependencies [9666a3d]
+- Updated dependencies [9666a3d]
+- Updated dependencies [9666a3d]
+- Updated dependencies [1823546]
+  - @harnessed-ts/core@0.4.0
+  - @harnessed-ts/resolve@0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joe Gaudet, Jay Seo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# @harnessed-ts/cypress
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Cypress driver for `@harnessed-ts/core`, for e2e and component tests. Cypress
+commands are enqueued rather than awaited, so a harness runs inside one command —
+`cy.harness` — as plain promises against the application under test.
+
+```ts
+// cypress/support/e2e.ts (or component.ts)
+import '@harnessed-ts/cypress/support'
+import { harnessedChai } from '@harnessed-ts/chai'
+chai.use(harnessedChai)
+```
+
+```ts
+cy.visitPage(LoginPage)
+cy.harness(LoginFormHarness, async form => {
+  await form.fillIn({ email: 'ada@example.com' })
+  await expect(form).not.to.be.absent
+})
+```
+
+Interactions go through `@testing-library/user-event` bound to the AUT document;
+pass `{ realEvents: true }` for trusted Chrome DevTools Protocol input on
+Chromium-family browsers. Never call `cy` commands inside the callback.
+
+Full guide, the cross-driver guarantees, and the API: the
+[harnessed README](https://github.com/joegaudet/harnessed#readme).
+
+MIT © Joe Gaudet, Jay Seo

package/dist/chunk-CGA7IP66.js

@@ -0,0 +1,526 @@
+import { registerDriver, registerNavigation, Query, describeScope, nth, checkFileTarget, StrictModeViolation, enabledFrom, checkedFrom, timeoutFor, getConfig } from '@harnessed-ts/core';
+import { resolveOne, resolveAll, fileInputOf, boundingBoxOf, isVisibleInLayout, FrameEntryError, countAll } from '@harnessed-ts/resolve';
+import { waitFor } from '@testing-library/dom';
+import userEvent from '@testing-library/user-event';
+
+// 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.setup({ document });
+  users.set(env, { document, user });
+  return user;
+}
+async function waitUntil(condition, container, timeout) {
+  let refused;
+  await waitFor(
+    async () => {
+      try {
+        await condition();
+      } catch (error) {
+        if (!(error instanceof FrameEntryError || error instanceof 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 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 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 = 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 resolveAll(this.container, this.scope, this.selector)).map(
+      (element, index) => new BoundCypressQuery(this.env, this.scope, 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 = fileInputOf(await this.element(options));
+    checkFileTarget(input, list.length, this.scope, this.selector);
+    await this.user.upload(input, list);
+  }
+  async boundingBox(options) {
+    this.log("boundingBox");
+    return 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 isVisibleInLayout(await this.element(options), this.env.document);
+    } catch (error) {
+      if (error instanceof FrameEntryError || error instanceof 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 enabledFrom(disabled, element.getAttribute("aria-disabled"));
+  }
+  async isChecked(options) {
+    this.log("isChecked");
+    const element = await this.element(options);
+    return 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 = 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 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);
+  }
+};
+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);
+  }
+}
+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 ?? 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;
+        });
+      });
+    }
+  );
+}
+
+export { CYPRESS_DRIVER, CypressQuery, cypress, registerCommands };
+//# sourceMappingURL=chunk-CGA7IP66.js.map
+//# sourceMappingURL=chunk-CGA7IP66.js.map