@harnessed-ts/vitest-browser 0.0.0-stage → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,80 @@
+# @harnessed-ts/vitest-browser
+
+## 0.7.0
+
+### 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
+
+- 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.
+
+- 9666a3d: New package `@harnessed-ts/vitest-browser`: a driver for Vitest browser mode. Harnesses resolve in the page through the shared resolver and act through the provider's `userEvent`, so clicks and typing are real browser input — including inside same-origin frames under the Playwright provider. `@harnessed-ts/vitest-browser/matchers` registers the shared matchers with Vitest's `expect`.
+
+### 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,24 @@
-# Temporary Holding Version
+# @harnessed-ts/vitest-browser
 
-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.
+Vitest browser mode driver for `@harnessed-ts/core`. The test runs in the page, so
+harnesses resolve there with the shared resolver, and every action goes through
+the provider's `userEvent` — real browser input, not synthesised DOM events.
+
+```ts
+import { vitestBrowser } from '@harnessed-ts/vitest-browser'
+import '@harnessed-ts/vitest-browser/matchers'
+import { render } from 'vitest-browser-react'
+
+await render(<LoginForm />)
+const form = new LoginFormHarness(vitestBrowser())
+```
+
+Queries start at `document.body` by default, which is where portals land. Pass
+`container` to scope a harness to one tree. Elements inside same-origin frames are
+driven through the Playwright provider; component testing has no navigation, so a
+page's `goto()` is refused.
+
+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/driver-id.d.ts

@@ -0,0 +1,3 @@
+/** Its own module so `env.ts` and `vitest-browser-query.ts` can share it without a cycle. */
+export declare const VITEST_BROWSER_DRIVER = "vitest-browser";
+//# sourceMappingURL=driver-id.d.ts.map

package/dist/driver-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-id.d.ts","sourceRoot":"","sources":["../src/driver-id.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,eAAO,MAAM,qBAAqB,mBAAmB,CAAA"}

package/dist/env.d.ts

@@ -0,0 +1,18 @@
+import type { EnvConfig } from '@harnessed-ts/core';
+import { VITEST_BROWSER_DRIVER } from './driver-id';
+import './vitest-browser-query';
+export { VITEST_BROWSER_DRIVER };
+export interface VitestBrowserEnv extends EnvConfig {
+    readonly driver: typeof VITEST_BROWSER_DRIVER;
+    /**
+     * Where queries start. Defaults to `document.body`, which is where a portal
+     * lands — scope it to a render's `container` only when the tree has none.
+     */
+    readonly container: HTMLElement;
+}
+export interface VitestBrowserEnvOptions {
+    container?: HTMLElement;
+}
+/** Builds the env a harness is constructed with under Vitest browser mode. */
+export declare function vitestBrowser({ container }?: VitestBrowserEnvOptions): VitestBrowserEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAGnD,OAAO,wBAAwB,CAAA;AAE/B,OAAO,EAAE,qBAAqB,EAAE,CAAA;AAEhC,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,QAAQ,CAAC,MAAM,EAAE,OAAO,qBAAqB,CAAA;IAC7C;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,WAAW,CAAA;CACxB;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,GAAE,uBAA4B,GAAG,gBAAgB,CAK3F"}

package/dist/index.cjs

@@ -0,0 +1,214 @@
+'use strict';
+
+var core = require('@harnessed-ts/core');
+var resolve = require('@harnessed-ts/resolve');
+var vitest = require('vitest');
+var browser = require('vitest/browser');
+
+// src/driver-id.ts
+var VITEST_BROWSER_DRIVER = "vitest-browser";
+browser.locators.extend({
+  harnessedSelector(selector) {
+    return selector;
+  }
+});
+function target(element) {
+  return element.ownerDocument === document ? element : locatorFor(element);
+}
+function locatorFor(element) {
+  if (element.ownerDocument === document) return browser.page.elementLocator(element);
+  const frame = element.ownerDocument.defaultView?.frameElement;
+  if (frame == null) {
+    throw new Error(
+      `harnessed: <${element.localName}> belongs to a document the vitest-browser driver cannot reach.`
+    );
+  }
+  return browser.page.frameLocator(locatorFor(frame)).harnessedSelector(browser.page.elementLocator(element).selector);
+}
+function actionOptions(options) {
+  return { timeout: core.timeoutFor(options?.timeout) };
+}
+function toKeyboardInput(key) {
+  return key.length === 1 ? key : `{${key}}`;
+}
+async function waitUntil(condition, timeout) {
+  let refused;
+  await vitest.vi.waitFor(
+    async () => {
+      try {
+        await condition();
+      } catch (error) {
+        if (!(error instanceof resolve.FrameEntryError || error instanceof core.StrictModeViolation)) {
+          throw error;
+        }
+        refused = error;
+      }
+    },
+    { timeout }
+  );
+  if (refused !== void 0) throw refused;
+}
+var VitestBrowserQuery = class _VitestBrowserQuery extends core.Query {
+  constructor(container, scope, selector) {
+    super(scope, selector);
+    this.container = container;
+  }
+  container;
+  clone(selector) {
+    return new _VitestBrowserQuery(this.container, this.scope, selector);
+  }
+  element(options) {
+    return resolve.resolveOne(this.container, this.scope, this.selector, options?.timeout);
+  }
+  /**
+   * Every match, resolved in one pass: the scope chain is walked once and the
+   * siblings scanned once, where the inherited default re-does both per element.
+   *
+   * Each result is bound to its already-resolved node. A callback that mutates
+   * the page can detach those nodes, so a bound query falls back to ordinary
+   * index resolution the moment its node leaves the document.
+   */
+  async all() {
+    return (await resolve.resolveAll(this.container, this.scope, this.selector)).map(
+      (element, index) => new BoundVitestBrowserQuery(
+        this.container,
+        this.scope,
+        core.nth(this.selector, index),
+        element
+      )
+    );
+  }
+  // --- interactions -------------------------------------------------------
+  async click(options) {
+    await browser.userEvent.click(target(await this.element(options)), actionOptions(options));
+  }
+  async fill(value, options) {
+    await browser.userEvent.fill(target(await this.element(options)), value, actionOptions(options));
+  }
+  async clear(options) {
+    await browser.userEvent.fill(target(await this.element(options)), "", actionOptions(options));
+  }
+  async check(options) {
+    const element = await this.element(options);
+    if (!element.checked) {
+      await browser.userEvent.click(target(element), actionOptions(options));
+    }
+  }
+  async uncheck(options) {
+    const element = await this.element(options);
+    if (element.checked) {
+      await browser.userEvent.click(target(element), actionOptions(options));
+    }
+  }
+  async selectOption(value, options) {
+    await browser.userEvent.selectOptions(
+      target(await this.element(options)),
+      value,
+      actionOptions(options)
+    );
+  }
+  async hover(options) {
+    await browser.userEvent.hover(target(await this.element(options)), actionOptions(options));
+  }
+  async focus(options) {
+    (await this.element(options)).focus();
+  }
+  async blur(options) {
+    (await this.element(options)).blur();
+  }
+  async press(key, options) {
+    const element = await this.element(options);
+    element.focus();
+    await browser.userEvent.keyboard(toKeyboardInput(key));
+  }
+  async upload(files, options) {
+    const list = Array.isArray(files) ? files : [files];
+    const input = resolve.fileInputOf(await this.element(options));
+    core.checkFileTarget(input, list.length, this.scope, this.selector);
+    await browser.userEvent.upload(target(input), list, actionOptions(options));
+  }
+  // --- observations -------------------------------------------------------
+  async text(options) {
+    return ((await this.element(options)).textContent ?? "").trim();
+  }
+  async inputValue(options) {
+    const element = await this.element(options);
+    return element.value ?? "";
+  }
+  async attribute(name, options) {
+    return (await this.element(options)).getAttribute(name);
+  }
+  async isVisible(options) {
+    try {
+      return resolve.isVisibleInLayout(await this.element(options), this.container.ownerDocument);
+    } catch (error) {
+      if (error instanceof resolve.FrameEntryError || error instanceof core.StrictModeViolation) throw error;
+      return false;
+    }
+  }
+  async isEnabled(options) {
+    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) {
+    const element = await this.element(options);
+    return core.checkedFrom(
+      element.getAttribute("aria-checked"),
+      Boolean(element.checked)
+    );
+  }
+  async selectedOptions(options) {
+    const element = await this.element(options);
+    return [...element.selectedOptions ?? []].map((option) => option.value);
+  }
+  async boundingBox(options) {
+    return resolve.boundingBoxOf(await this.element(options), this.container.ownerDocument);
+  }
+  // --- waiting ------------------------------------------------------------
+  async waitFor(state, options) {
+    const timeout = core.timeoutFor(options?.timeout);
+    if (state === "visible") {
+      await waitUntil(async () => {
+        if (!await this.isVisible({ timeout })) throw new Error("not visible yet");
+      }, timeout);
+      return;
+    }
+    await waitUntil(async () => {
+      if (await this.count() !== 0 && await this.isVisible({ timeout })) {
+        throw new Error("still visible");
+      }
+    }, timeout);
+  }
+  async count() {
+    return resolve.countAll(this.container, this.scope, this.selector);
+  }
+};
+var BoundVitestBrowserQuery = class extends VitestBrowserQuery {
+  constructor(container, scope, selector, bound) {
+    super(container, scope, selector);
+    this.bound = bound;
+  }
+  bound;
+  async element(options) {
+    if (this.bound.isConnected) return this.bound;
+    return super.element(options);
+  }
+};
+core.registerDriver(VITEST_BROWSER_DRIVER, (env, scope, selector) => {
+  return new VitestBrowserQuery(env.container, scope, selector);
+});
+
+// src/env.ts
+function vitestBrowser({ container } = {}) {
+  return {
+    driver: VITEST_BROWSER_DRIVER,
+    container: container ?? document.body
+  };
+}
+
+exports.VITEST_BROWSER_DRIVER = VITEST_BROWSER_DRIVER;
+exports.VitestBrowserQuery = VitestBrowserQuery;
+exports.vitestBrowser = vitestBrowser;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/driver-id.ts","../src/vitest-browser-query.ts","../src/env.ts"],"names":["locators","page","timeoutFor","vi","FrameEntryError","StrictModeViolation","Query","resolveOne","resolveAll","withNth","userEvent","fileInputOf","checkFileTarget","isVisibleInLayout","enabledFrom","checkedFrom","boundingBoxOf","countAll","registerDriver"],"mappings":"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","file":"index.cjs","sourcesContent":["/** Its own module so `env.ts` and `vitest-browser-query.ts` can share it without a cycle. */\nexport const VITEST_BROWSER_DRIVER = 'vitest-browser'\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  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 { vi } from 'vitest'\nimport { locators, page, userEvent } from 'vitest/browser'\nimport type { Locator } from 'vitest/browser'\nimport { VITEST_BROWSER_DRIVER } from './driver-id'\nimport type { VitestBrowserEnv } from './env'\n\ndeclare module 'vitest/browser' {\n  interface LocatorSelectors {\n    /**\n     * Chains a raw provider selector onto a locator. Registered by\n     * `@harnessed-ts/vitest-browser` to reach into frames; not for tests.\n     */\n    harnessedSelector(selector: string): Locator\n  }\n}\n\n// The only public way to chain an arbitrary selector after `frameLocator()`,\n// which otherwise offers just the getBy* family.\nlocators.extend({\n  harnessedSelector(selector: string) {\n    return selector\n  },\n})\n\n/**\n * What a provider action is handed for an element the shared resolver found.\n *\n * An element in the test's own document goes as itself. One inside an `<iframe>`\n * cannot: Vitest recognises an element with `instanceof Element`, which fails\n * across realms, and it then calls the node's own method instead — a synthetic\n * `click()`, and no `fill()` at all. So a framed element becomes a locator that\n * enters each frame on the way down, which the provider drives for real.\n */\nfunction target<E extends Element>(element: E): E | Locator {\n  return element.ownerDocument === document ? element : locatorFor(element)\n}\n\nfunction locatorFor(element: Element): Locator {\n  if (element.ownerDocument === document) return page.elementLocator(element)\n  const frame = element.ownerDocument.defaultView?.frameElement\n  if (frame == null) {\n    throw new Error(\n      `harnessed: <${element.localName}> belongs to a document the vitest-browser driver cannot reach.`,\n    )\n  }\n  // The element's own locator is generated against its own document, which is\n  // exactly the document the frame locator has entered.\n  return page\n    .frameLocator(locatorFor(frame))\n    .harnessedSelector(page.elementLocator(element).selector)\n}\n\n/**\n * The provider options an action is handed. Every provider action waits for its\n * element to be actionable, and the Playwright provider's own `actionTimeout`\n * defaults to none — so without this, an action that can never happen (a click\n * on a disabled button) hangs until the test itself times out.\n *\n * Not an object literal at the call site: the option interfaces are empty until\n * a provider augments them, and Playwright's is the one that declares `timeout`.\n */\nfunction actionOptions(options?: WaitOptions): { timeout: number } {\n  return { timeout: timeoutFor(options?.timeout) }\n}\n\n/** Playwright key names such as `Enter` map onto the user-event `{Enter}` syntax. */\nfunction toKeyboardInput(key: string): string {\n  return key.length === 1 ? key : `{${key}}`\n}\n\n/**\n * Vitest's own `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(condition: () => Promise<void>, timeout: number): Promise<void> {\n  let refused: FrameEntryError | StrictModeViolation | undefined\n  await vi.waitFor(\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    { timeout },\n  )\n  if (refused !== undefined) throw refused\n}\n\n/**\n * Vitest browser mode driver. The test runs in the page, so resolution is the\n * shared in-process resolver; only the interactions are the provider's, which\n * makes them real browser input rather than synthesised DOM events.\n */\nexport class VitestBrowserQuery extends Query {\n  constructor(\n    private readonly container: HTMLElement,\n    scope: readonly Selector[],\n    selector: Selector,\n  ) {\n    super(scope, selector)\n  }\n\n  protected override clone(selector: Selector): Query {\n    return new VitestBrowserQuery(this.container, this.scope, selector)\n  }\n\n  protected element(options?: WaitOptions): Promise<HTMLElement> {\n    return resolveOne(this.container, this.scope, this.selector, options?.timeout)\n  }\n\n  /**\n   * Every match, resolved in one pass: the scope chain is walked once and the\n   * siblings scanned once, where the inherited default re-does both per element.\n   *\n   * Each result is bound to its already-resolved node. A callback that mutates\n   * the page can detach those nodes, so a bound query falls back to ordinary\n   * index resolution the moment its node leaves 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 BoundVitestBrowserQuery(\n          this.container,\n          this.scope,\n          withNth(this.selector, index),\n          element,\n        ),\n    )\n  }\n\n  // --- interactions -------------------------------------------------------\n\n  override async click(options?: WaitOptions): Promise<void> {\n    await userEvent.click(target(await this.element(options)), actionOptions(options))\n  }\n\n  override async fill(value: string, options?: WaitOptions): Promise<void> {\n    // The provider's fill is Playwright's: it replaces the value, and '' clears.\n    await userEvent.fill(target(await this.element(options)), value, actionOptions(options))\n  }\n\n  override async clear(options?: WaitOptions): Promise<void> {\n    // The provider's clear() drops its options, so it could not be given a\n    // timeout; Playwright's clear is fill('') in any case.\n    await userEvent.fill(target(await this.element(options)), '', actionOptions(options))\n  }\n\n  override async check(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if (!(element as HTMLInputElement).checked) {\n      await userEvent.click(target(element), actionOptions(options))\n    }\n  }\n\n  override async uncheck(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if ((element as HTMLInputElement).checked) {\n      await userEvent.click(target(element), actionOptions(options))\n    }\n  }\n\n  override async selectOption(value: string | string[], options?: WaitOptions): Promise<void> {\n    // Playwright's selectOption replaces a multi-select's selection, which is the\n    // semantic the shared API promises, so there is nothing to clear first.\n    await userEvent.selectOptions(\n      target(await this.element(options)),\n      value,\n      actionOptions(options),\n    )\n  }\n\n  override async hover(options?: WaitOptions): Promise<void> {\n    await userEvent.hover(target(await this.element(options)), actionOptions(options))\n  }\n\n  override async focus(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).focus()\n  }\n\n  override async blur(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).blur()\n  }\n\n  override async press(key: string, options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    element.focus()\n    await userEvent.keyboard(toKeyboardInput(key))\n  }\n\n  override async upload(files: File | File[], options?: WaitOptions): Promise<void> {\n    const list = Array.isArray(files) ? files : [files]\n    const input = fileInputOf(await this.element(options))\n    checkFileTarget(input, list.length, this.scope, this.selector)\n    // The provider's upload: Playwright's setInputFiles, or WebdriverIO's, with the bytes.\n    await userEvent.upload(target(input), list, actionOptions(options))\n  }\n\n  // --- observations -------------------------------------------------------\n\n  override async text(options?: WaitOptions): Promise<string> {\n    return ((await this.element(options)).textContent ?? '').trim()\n  }\n\n  override async inputValue(options?: WaitOptions): Promise<string> {\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    return (await this.element(options)).getAttribute(name)\n  }\n\n  override async isVisible(options?: WaitOptions): Promise<boolean> {\n    try {\n      // A real browser lays the page out, so this is Playwright's layout check\n      // rather than the dom driver's computed-style walk.\n      return isVisibleInLayout(await this.element(options), this.container.ownerDocument)\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    const element = await this.element(options)\n    // `disabled` is inherited from an ancestor fieldset, and the DOM property\n    // already accounts for that where the attribute does not.\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    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    const element = (await this.element(options)) as HTMLSelectElement\n    return [...(element.selectedOptions ?? [])].map(option => option.value)\n  }\n\n  override async boundingBox(options?: WaitOptions): Promise<BoundingBox> {\n    return boundingBoxOf(await this.element(options), this.container.ownerDocument)\n  }\n\n  // --- waiting ------------------------------------------------------------\n\n  override async waitFor(state: WaitState, options?: WaitOptions): Promise<void> {\n    const timeout = timeoutFor(options?.timeout)\n    if (state === 'visible') {\n      await waitUntil(async () => {\n        if (!(await this.isVisible({ timeout }))) throw new Error('not visible yet')\n      }, timeout)\n      return\n    }\n    await waitUntil(async () => {\n      if ((await this.count()) !== 0 && (await this.isVisible({ timeout }))) {\n        throw new Error('still visible')\n      }\n    }, timeout)\n  }\n\n  override async count(): Promise<number> {\n    return countAll(this.container, this.scope, this.selector)\n  }\n}\n\n/** A query pinned to a node `all()` already found. See `VitestBrowserQuery.all`. */\nclass BoundVitestBrowserQuery extends VitestBrowserQuery {\n  constructor(\n    container: HTMLElement,\n    scope: readonly Selector[],\n    selector: Selector,\n    private readonly bound: HTMLElement,\n  ) {\n    super(container, 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(VITEST_BROWSER_DRIVER, (env: EnvConfig, scope, selector) => {\n  return new VitestBrowserQuery((env as VitestBrowserEnv).container, scope, selector)\n})\n","import type { EnvConfig } from '@harnessed-ts/core'\nimport { VITEST_BROWSER_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 './vitest-browser-query'\n\nexport { VITEST_BROWSER_DRIVER }\n\nexport interface VitestBrowserEnv extends EnvConfig {\n  readonly driver: typeof VITEST_BROWSER_DRIVER\n  /**\n   * Where queries start. Defaults to `document.body`, which is where a portal\n   * lands — scope it to a render's `container` only when the tree has none.\n   */\n  readonly container: HTMLElement\n}\n\nexport interface VitestBrowserEnvOptions {\n  container?: HTMLElement\n}\n\n/** Builds the env a harness is constructed with under Vitest browser mode. */\nexport function vitestBrowser({ container }: VitestBrowserEnvOptions = {}): VitestBrowserEnv {\n  return {\n    driver: VITEST_BROWSER_DRIVER,\n    container: container ?? document.body,\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { vitestBrowser, VITEST_BROWSER_DRIVER } from './env';
+export type { VitestBrowserEnv, VitestBrowserEnvOptions } from './env';
+export { VitestBrowserQuery } from './vitest-browser-query';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAA;AAC5D,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,210 @@
+import { registerDriver, Query, nth, checkFileTarget, StrictModeViolation, enabledFrom, checkedFrom, timeoutFor } from '@harnessed-ts/core';
+import { resolveOne, resolveAll, fileInputOf, isVisibleInLayout, FrameEntryError, boundingBoxOf, countAll } from '@harnessed-ts/resolve';
+import { vi } from 'vitest';
+import { locators, userEvent, page } from 'vitest/browser';
+
+// src/driver-id.ts
+var VITEST_BROWSER_DRIVER = "vitest-browser";
+locators.extend({
+  harnessedSelector(selector) {
+    return selector;
+  }
+});
+function target(element) {
+  return element.ownerDocument === document ? element : locatorFor(element);
+}
+function locatorFor(element) {
+  if (element.ownerDocument === document) return page.elementLocator(element);
+  const frame = element.ownerDocument.defaultView?.frameElement;
+  if (frame == null) {
+    throw new Error(
+      `harnessed: <${element.localName}> belongs to a document the vitest-browser driver cannot reach.`
+    );
+  }
+  return page.frameLocator(locatorFor(frame)).harnessedSelector(page.elementLocator(element).selector);
+}
+function actionOptions(options) {
+  return { timeout: timeoutFor(options?.timeout) };
+}
+function toKeyboardInput(key) {
+  return key.length === 1 ? key : `{${key}}`;
+}
+async function waitUntil(condition, timeout) {
+  let refused;
+  await vi.waitFor(
+    async () => {
+      try {
+        await condition();
+      } catch (error) {
+        if (!(error instanceof FrameEntryError || error instanceof StrictModeViolation)) {
+          throw error;
+        }
+        refused = error;
+      }
+    },
+    { timeout }
+  );
+  if (refused !== void 0) throw refused;
+}
+var VitestBrowserQuery = class _VitestBrowserQuery extends Query {
+  constructor(container, scope, selector) {
+    super(scope, selector);
+    this.container = container;
+  }
+  container;
+  clone(selector) {
+    return new _VitestBrowserQuery(this.container, this.scope, selector);
+  }
+  element(options) {
+    return resolveOne(this.container, this.scope, this.selector, options?.timeout);
+  }
+  /**
+   * Every match, resolved in one pass: the scope chain is walked once and the
+   * siblings scanned once, where the inherited default re-does both per element.
+   *
+   * Each result is bound to its already-resolved node. A callback that mutates
+   * the page can detach those nodes, so a bound query falls back to ordinary
+   * index resolution the moment its node leaves the document.
+   */
+  async all() {
+    return (await resolveAll(this.container, this.scope, this.selector)).map(
+      (element, index) => new BoundVitestBrowserQuery(
+        this.container,
+        this.scope,
+        nth(this.selector, index),
+        element
+      )
+    );
+  }
+  // --- interactions -------------------------------------------------------
+  async click(options) {
+    await userEvent.click(target(await this.element(options)), actionOptions(options));
+  }
+  async fill(value, options) {
+    await userEvent.fill(target(await this.element(options)), value, actionOptions(options));
+  }
+  async clear(options) {
+    await userEvent.fill(target(await this.element(options)), "", actionOptions(options));
+  }
+  async check(options) {
+    const element = await this.element(options);
+    if (!element.checked) {
+      await userEvent.click(target(element), actionOptions(options));
+    }
+  }
+  async uncheck(options) {
+    const element = await this.element(options);
+    if (element.checked) {
+      await userEvent.click(target(element), actionOptions(options));
+    }
+  }
+  async selectOption(value, options) {
+    await userEvent.selectOptions(
+      target(await this.element(options)),
+      value,
+      actionOptions(options)
+    );
+  }
+  async hover(options) {
+    await userEvent.hover(target(await this.element(options)), actionOptions(options));
+  }
+  async focus(options) {
+    (await this.element(options)).focus();
+  }
+  async blur(options) {
+    (await this.element(options)).blur();
+  }
+  async press(key, options) {
+    const element = await this.element(options);
+    element.focus();
+    await userEvent.keyboard(toKeyboardInput(key));
+  }
+  async upload(files, options) {
+    const list = Array.isArray(files) ? files : [files];
+    const input = fileInputOf(await this.element(options));
+    checkFileTarget(input, list.length, this.scope, this.selector);
+    await userEvent.upload(target(input), list, actionOptions(options));
+  }
+  // --- observations -------------------------------------------------------
+  async text(options) {
+    return ((await this.element(options)).textContent ?? "").trim();
+  }
+  async inputValue(options) {
+    const element = await this.element(options);
+    return element.value ?? "";
+  }
+  async attribute(name, options) {
+    return (await this.element(options)).getAttribute(name);
+  }
+  async isVisible(options) {
+    try {
+      return isVisibleInLayout(await this.element(options), this.container.ownerDocument);
+    } catch (error) {
+      if (error instanceof FrameEntryError || error instanceof StrictModeViolation) throw error;
+      return false;
+    }
+  }
+  async isEnabled(options) {
+    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) {
+    const element = await this.element(options);
+    return checkedFrom(
+      element.getAttribute("aria-checked"),
+      Boolean(element.checked)
+    );
+  }
+  async selectedOptions(options) {
+    const element = await this.element(options);
+    return [...element.selectedOptions ?? []].map((option) => option.value);
+  }
+  async boundingBox(options) {
+    return boundingBoxOf(await this.element(options), this.container.ownerDocument);
+  }
+  // --- waiting ------------------------------------------------------------
+  async waitFor(state, options) {
+    const timeout = timeoutFor(options?.timeout);
+    if (state === "visible") {
+      await waitUntil(async () => {
+        if (!await this.isVisible({ timeout })) throw new Error("not visible yet");
+      }, timeout);
+      return;
+    }
+    await waitUntil(async () => {
+      if (await this.count() !== 0 && await this.isVisible({ timeout })) {
+        throw new Error("still visible");
+      }
+    }, timeout);
+  }
+  async count() {
+    return countAll(this.container, this.scope, this.selector);
+  }
+};
+var BoundVitestBrowserQuery = class extends VitestBrowserQuery {
+  constructor(container, scope, selector, bound) {
+    super(container, scope, selector);
+    this.bound = bound;
+  }
+  bound;
+  async element(options) {
+    if (this.bound.isConnected) return this.bound;
+    return super.element(options);
+  }
+};
+registerDriver(VITEST_BROWSER_DRIVER, (env, scope, selector) => {
+  return new VitestBrowserQuery(env.container, scope, selector);
+});
+
+// src/env.ts
+function vitestBrowser({ container } = {}) {
+  return {
+    driver: VITEST_BROWSER_DRIVER,
+    container: container ?? document.body
+  };
+}
+
+export { VITEST_BROWSER_DRIVER, VitestBrowserQuery, vitestBrowser };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/driver-id.ts","../src/vitest-browser-query.ts","../src/env.ts"],"names":["withNth"],"mappings":"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","file":"index.js","sourcesContent":["/** Its own module so `env.ts` and `vitest-browser-query.ts` can share it without a cycle. */\nexport const VITEST_BROWSER_DRIVER = 'vitest-browser'\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  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 { vi } from 'vitest'\nimport { locators, page, userEvent } from 'vitest/browser'\nimport type { Locator } from 'vitest/browser'\nimport { VITEST_BROWSER_DRIVER } from './driver-id'\nimport type { VitestBrowserEnv } from './env'\n\ndeclare module 'vitest/browser' {\n  interface LocatorSelectors {\n    /**\n     * Chains a raw provider selector onto a locator. Registered by\n     * `@harnessed-ts/vitest-browser` to reach into frames; not for tests.\n     */\n    harnessedSelector(selector: string): Locator\n  }\n}\n\n// The only public way to chain an arbitrary selector after `frameLocator()`,\n// which otherwise offers just the getBy* family.\nlocators.extend({\n  harnessedSelector(selector: string) {\n    return selector\n  },\n})\n\n/**\n * What a provider action is handed for an element the shared resolver found.\n *\n * An element in the test's own document goes as itself. One inside an `<iframe>`\n * cannot: Vitest recognises an element with `instanceof Element`, which fails\n * across realms, and it then calls the node's own method instead — a synthetic\n * `click()`, and no `fill()` at all. So a framed element becomes a locator that\n * enters each frame on the way down, which the provider drives for real.\n */\nfunction target<E extends Element>(element: E): E | Locator {\n  return element.ownerDocument === document ? element : locatorFor(element)\n}\n\nfunction locatorFor(element: Element): Locator {\n  if (element.ownerDocument === document) return page.elementLocator(element)\n  const frame = element.ownerDocument.defaultView?.frameElement\n  if (frame == null) {\n    throw new Error(\n      `harnessed: <${element.localName}> belongs to a document the vitest-browser driver cannot reach.`,\n    )\n  }\n  // The element's own locator is generated against its own document, which is\n  // exactly the document the frame locator has entered.\n  return page\n    .frameLocator(locatorFor(frame))\n    .harnessedSelector(page.elementLocator(element).selector)\n}\n\n/**\n * The provider options an action is handed. Every provider action waits for its\n * element to be actionable, and the Playwright provider's own `actionTimeout`\n * defaults to none — so without this, an action that can never happen (a click\n * on a disabled button) hangs until the test itself times out.\n *\n * Not an object literal at the call site: the option interfaces are empty until\n * a provider augments them, and Playwright's is the one that declares `timeout`.\n */\nfunction actionOptions(options?: WaitOptions): { timeout: number } {\n  return { timeout: timeoutFor(options?.timeout) }\n}\n\n/** Playwright key names such as `Enter` map onto the user-event `{Enter}` syntax. */\nfunction toKeyboardInput(key: string): string {\n  return key.length === 1 ? key : `{${key}}`\n}\n\n/**\n * Vitest's own `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(condition: () => Promise<void>, timeout: number): Promise<void> {\n  let refused: FrameEntryError | StrictModeViolation | undefined\n  await vi.waitFor(\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    { timeout },\n  )\n  if (refused !== undefined) throw refused\n}\n\n/**\n * Vitest browser mode driver. The test runs in the page, so resolution is the\n * shared in-process resolver; only the interactions are the provider's, which\n * makes them real browser input rather than synthesised DOM events.\n */\nexport class VitestBrowserQuery extends Query {\n  constructor(\n    private readonly container: HTMLElement,\n    scope: readonly Selector[],\n    selector: Selector,\n  ) {\n    super(scope, selector)\n  }\n\n  protected override clone(selector: Selector): Query {\n    return new VitestBrowserQuery(this.container, this.scope, selector)\n  }\n\n  protected element(options?: WaitOptions): Promise<HTMLElement> {\n    return resolveOne(this.container, this.scope, this.selector, options?.timeout)\n  }\n\n  /**\n   * Every match, resolved in one pass: the scope chain is walked once and the\n   * siblings scanned once, where the inherited default re-does both per element.\n   *\n   * Each result is bound to its already-resolved node. A callback that mutates\n   * the page can detach those nodes, so a bound query falls back to ordinary\n   * index resolution the moment its node leaves 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 BoundVitestBrowserQuery(\n          this.container,\n          this.scope,\n          withNth(this.selector, index),\n          element,\n        ),\n    )\n  }\n\n  // --- interactions -------------------------------------------------------\n\n  override async click(options?: WaitOptions): Promise<void> {\n    await userEvent.click(target(await this.element(options)), actionOptions(options))\n  }\n\n  override async fill(value: string, options?: WaitOptions): Promise<void> {\n    // The provider's fill is Playwright's: it replaces the value, and '' clears.\n    await userEvent.fill(target(await this.element(options)), value, actionOptions(options))\n  }\n\n  override async clear(options?: WaitOptions): Promise<void> {\n    // The provider's clear() drops its options, so it could not be given a\n    // timeout; Playwright's clear is fill('') in any case.\n    await userEvent.fill(target(await this.element(options)), '', actionOptions(options))\n  }\n\n  override async check(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if (!(element as HTMLInputElement).checked) {\n      await userEvent.click(target(element), actionOptions(options))\n    }\n  }\n\n  override async uncheck(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if ((element as HTMLInputElement).checked) {\n      await userEvent.click(target(element), actionOptions(options))\n    }\n  }\n\n  override async selectOption(value: string | string[], options?: WaitOptions): Promise<void> {\n    // Playwright's selectOption replaces a multi-select's selection, which is the\n    // semantic the shared API promises, so there is nothing to clear first.\n    await userEvent.selectOptions(\n      target(await this.element(options)),\n      value,\n      actionOptions(options),\n    )\n  }\n\n  override async hover(options?: WaitOptions): Promise<void> {\n    await userEvent.hover(target(await this.element(options)), actionOptions(options))\n  }\n\n  override async focus(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).focus()\n  }\n\n  override async blur(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).blur()\n  }\n\n  override async press(key: string, options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    element.focus()\n    await userEvent.keyboard(toKeyboardInput(key))\n  }\n\n  override async upload(files: File | File[], options?: WaitOptions): Promise<void> {\n    const list = Array.isArray(files) ? files : [files]\n    const input = fileInputOf(await this.element(options))\n    checkFileTarget(input, list.length, this.scope, this.selector)\n    // The provider's upload: Playwright's setInputFiles, or WebdriverIO's, with the bytes.\n    await userEvent.upload(target(input), list, actionOptions(options))\n  }\n\n  // --- observations -------------------------------------------------------\n\n  override async text(options?: WaitOptions): Promise<string> {\n    return ((await this.element(options)).textContent ?? '').trim()\n  }\n\n  override async inputValue(options?: WaitOptions): Promise<string> {\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    return (await this.element(options)).getAttribute(name)\n  }\n\n  override async isVisible(options?: WaitOptions): Promise<boolean> {\n    try {\n      // A real browser lays the page out, so this is Playwright's layout check\n      // rather than the dom driver's computed-style walk.\n      return isVisibleInLayout(await this.element(options), this.container.ownerDocument)\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    const element = await this.element(options)\n    // `disabled` is inherited from an ancestor fieldset, and the DOM property\n    // already accounts for that where the attribute does not.\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    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    const element = (await this.element(options)) as HTMLSelectElement\n    return [...(element.selectedOptions ?? [])].map(option => option.value)\n  }\n\n  override async boundingBox(options?: WaitOptions): Promise<BoundingBox> {\n    return boundingBoxOf(await this.element(options), this.container.ownerDocument)\n  }\n\n  // --- waiting ------------------------------------------------------------\n\n  override async waitFor(state: WaitState, options?: WaitOptions): Promise<void> {\n    const timeout = timeoutFor(options?.timeout)\n    if (state === 'visible') {\n      await waitUntil(async () => {\n        if (!(await this.isVisible({ timeout }))) throw new Error('not visible yet')\n      }, timeout)\n      return\n    }\n    await waitUntil(async () => {\n      if ((await this.count()) !== 0 && (await this.isVisible({ timeout }))) {\n        throw new Error('still visible')\n      }\n    }, timeout)\n  }\n\n  override async count(): Promise<number> {\n    return countAll(this.container, this.scope, this.selector)\n  }\n}\n\n/** A query pinned to a node `all()` already found. See `VitestBrowserQuery.all`. */\nclass BoundVitestBrowserQuery extends VitestBrowserQuery {\n  constructor(\n    container: HTMLElement,\n    scope: readonly Selector[],\n    selector: Selector,\n    private readonly bound: HTMLElement,\n  ) {\n    super(container, 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(VITEST_BROWSER_DRIVER, (env: EnvConfig, scope, selector) => {\n  return new VitestBrowserQuery((env as VitestBrowserEnv).container, scope, selector)\n})\n","import type { EnvConfig } from '@harnessed-ts/core'\nimport { VITEST_BROWSER_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 './vitest-browser-query'\n\nexport { VITEST_BROWSER_DRIVER }\n\nexport interface VitestBrowserEnv extends EnvConfig {\n  readonly driver: typeof VITEST_BROWSER_DRIVER\n  /**\n   * Where queries start. Defaults to `document.body`, which is where a portal\n   * lands — scope it to a render's `container` only when the tree has none.\n   */\n  readonly container: HTMLElement\n}\n\nexport interface VitestBrowserEnvOptions {\n  container?: HTMLElement\n}\n\n/** Builds the env a harness is constructed with under Vitest browser mode. */\nexport function vitestBrowser({ container }: VitestBrowserEnvOptions = {}): VitestBrowserEnv {\n  return {\n    driver: VITEST_BROWSER_DRIVER,\n    container: container ?? document.body,\n  }\n}\n"]}

package/dist/matchers.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+var core = require('@harnessed-ts/core');
+var vitest = require('vitest');
+
+// src/matchers.ts
+vitest.expect.extend(core.harnessMatchers);
+//# sourceMappingURL=matchers.cjs.map
+//# sourceMappingURL=matchers.cjs.map

package/dist/matchers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/matchers.ts"],"names":["expect","harnessMatchers"],"mappings":";;;;;;AAOAA,aAAA,CAAO,OAAOC,oBAAe,CAAA","file":"matchers.cjs","sourcesContent":["import { harnessMatchers } from '@harnessed-ts/core'\nimport type { Assertable } from '@harnessed-ts/core'\nimport { expect } from 'vitest'\n\n// `import '@harnessed-ts/vitest-browser/matchers'` from a setup file registers all\n// three. Browser mode runs the same `expect` as Node, so this is the dom\n// driver's registration unchanged.\nexpect.extend(harnessMatchers)\n\ndeclare module 'vitest' {\n  // The parameter list must match vitest's own declaration exactly. `T` is the\n  // subject, and gating on it means calling these on something that is not a\n  // target or a harness is a type error rather than a runtime surprise.\n  interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> {\n    toBeSelected(): T extends Assertable ? R : never\n    toBeAbsent(): T extends Assertable ? R : never\n    toReadAs(expected: string | RegExp): T extends Assertable ? R : never\n  }\n}\n"]}

package/dist/matchers.d.ts

@@ -0,0 +1,9 @@
+import type { Assertable } from '@harnessed-ts/core';
+declare module 'vitest' {
+    interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> {
+        toBeSelected(): T extends Assertable ? R : never;
+        toBeAbsent(): T extends Assertable ? R : never;
+        toReadAs(expected: string | RegExp): T extends Assertable ? R : never;
+    }
+}
+//# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAQpD,OAAO,QAAQ,QAAQ,CAAC;IAItB,UAAU,QAAQ,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO;QACnF,YAAY,IAAI,CAAC,SAAS,UAAU,GAAG,CAAC,GAAG,KAAK,CAAA;QAChD,UAAU,IAAI,CAAC,SAAS,UAAU,GAAG,CAAC,GAAG,KAAK,CAAA;QAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,UAAU,GAAG,CAAC,GAAG,KAAK,CAAA;KACtE;CACF"}

package/dist/matchers.js

@@ -0,0 +1,7 @@
+import { harnessMatchers } from '@harnessed-ts/core';
+import { expect } from 'vitest';
+
+// src/matchers.ts
+expect.extend(harnessMatchers);
+//# sourceMappingURL=matchers.js.map
+//# sourceMappingURL=matchers.js.map

package/dist/matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/matchers.ts"],"names":[],"mappings":";;;;AAOA,MAAA,CAAO,OAAO,eAAe,CAAA","file":"matchers.js","sourcesContent":["import { harnessMatchers } from '@harnessed-ts/core'\nimport type { Assertable } from '@harnessed-ts/core'\nimport { expect } from 'vitest'\n\n// `import '@harnessed-ts/vitest-browser/matchers'` from a setup file registers all\n// three. Browser mode runs the same `expect` as Node, so this is the dom\n// driver's registration unchanged.\nexpect.extend(harnessMatchers)\n\ndeclare module 'vitest' {\n  // The parameter list must match vitest's own declaration exactly. `T` is the\n  // subject, and gating on it means calling these on something that is not a\n  // target or a harness is a type error rather than a runtime surprise.\n  interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> {\n    toBeSelected(): T extends Assertable ? R : never\n    toBeAbsent(): T extends Assertable ? R : never\n    toReadAs(expected: string | RegExp): T extends Assertable ? R : never\n  }\n}\n"]}

package/dist/vitest-browser-query.d.ts

@@ -0,0 +1,54 @@
+import { Query } from '@harnessed-ts/core';
+import type { BoundingBox, Selector, WaitOptions, WaitState } from '@harnessed-ts/core';
+import type { Locator } from 'vitest/browser';
+declare module 'vitest/browser' {
+    interface LocatorSelectors {
+        /**
+         * Chains a raw provider selector onto a locator. Registered by
+         * `@harnessed-ts/vitest-browser` to reach into frames; not for tests.
+         */
+        harnessedSelector(selector: string): Locator;
+    }
+}
+/**
+ * Vitest browser mode driver. The test runs in the page, so resolution is the
+ * shared in-process resolver; only the interactions are the provider's, which
+ * makes them real browser input rather than synthesised DOM events.
+ */
+export declare class VitestBrowserQuery extends Query {
+    private readonly container;
+    constructor(container: HTMLElement, scope: readonly Selector[], selector: Selector);
+    protected clone(selector: Selector): Query;
+    protected element(options?: WaitOptions): Promise<HTMLElement>;
+    /**
+     * Every match, resolved in one pass: the scope chain is walked once and the
+     * siblings scanned once, where the inherited default re-does both per element.
+     *
+     * Each result is bound to its already-resolved node. A callback that mutates
+     * the page can detach those nodes, so a bound query falls back to ordinary
+     * index resolution the moment its node leaves the document.
+     */
+    all(): Promise<Query[]>;
+    click(options?: WaitOptions): Promise<void>;
+    fill(value: string, options?: WaitOptions): Promise<void>;
+    clear(options?: WaitOptions): Promise<void>;
+    check(options?: WaitOptions): Promise<void>;
+    uncheck(options?: WaitOptions): Promise<void>;
+    selectOption(value: string | string[], options?: WaitOptions): Promise<void>;
+    hover(options?: WaitOptions): Promise<void>;
+    focus(options?: WaitOptions): Promise<void>;
+    blur(options?: WaitOptions): Promise<void>;
+    press(key: string, options?: WaitOptions): Promise<void>;
+    upload(files: File | File[], options?: WaitOptions): Promise<void>;
+    text(options?: WaitOptions): Promise<string>;
+    inputValue(options?: WaitOptions): Promise<string>;
+    attribute(name: string, options?: WaitOptions): Promise<string | null>;
+    isVisible(options?: WaitOptions): Promise<boolean>;
+    isEnabled(options?: WaitOptions): Promise<boolean>;
+    isChecked(options?: WaitOptions): Promise<boolean>;
+    selectedOptions(options?: WaitOptions): Promise<string[]>;
+    boundingBox(options?: WaitOptions): Promise<BoundingBox>;
+    waitFor(state: WaitState, options?: WaitOptions): Promise<void>;
+    count(): Promise<number>;
+}
+//# sourceMappingURL=vitest-browser-query.d.ts.map

package/dist/vitest-browser-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-browser-query.d.ts","sourceRoot":"","sources":["../src/vitest-browser-query.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "@harnessed-ts/vitest-browser",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.0",
+  "description": "Vitest browser mode driver for @harnessed-ts/core: in-page resolution, provider-native user events.",
+  "keywords": [
+    "testing",
+    "harness",
+    "vitest",
+    "browser-mode",
+    "component-testing"
+  ],
+  "license": "MIT",
+  "contributors": [
+    {
+      "name": "Joe Gaudet",
+      "url": "https://github.com/joegaudet"
+    },
+    {
+      "name": "Jay Seo",
+      "url": "https://github.com/jayseo5953"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joegaudet/harnessed.git",
+    "directory": "packages/vitest-browser"
+  },
+  "homepage": "https://github.com/joegaudet/harnessed#readme",
+  "bugs": "https://github.com/joegaudet/harnessed/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./matchers": {
+      "types": "./dist/matchers.d.ts",
+      "import": "./dist/matchers.js",
+      "require": "./dist/matchers.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "dependencies": {
+    "@harnessed-ts/core": "^0.7.0",
+    "@harnessed-ts/resolve": "^0.7.0"
+  },
+  "peerDependencies": {
+    "@testing-library/dom": ">=10",
+    "vitest": ">=4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.2",
+    "@vitest/browser": "5.0.3",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
 }