@harnessed-ts/resolve 0.0.0-stage → 0.7.0

package/dist/webdriver.js

@@ -0,0 +1,226 @@
+import { PAGE_API_GLOBAL, encodeSelector, injectSource } from './chunk-BYG4HMLR.js';
+import { checkTestIds, getConfig, reviveStrictViolation } from '@harnessed-ts/core';
+
+// src/webdriver-page-script.ts
+var PageError = class extends Error {
+  constructor(name, message) {
+    super(message);
+    this.name = name;
+  }
+};
+function isFrameEntryError(error) {
+  return error instanceof PageError && error.name === "FrameEntryError";
+}
+async function pageScript(name, op, scope, selector, options, arg) {
+  const api = window[name];
+  if (api === void 0) return { kind: "missing" };
+  const one = () => api.one(null, scope, selector, options);
+  const iframe = async (found) => {
+    if (found !== null && found.localName !== "iframe") {
+      await api.count(null, [...scope, selector], selector, options);
+    }
+    return {
+      element: found,
+      origin: found === null ? { x: 0, y: 0 } : api.origin(found),
+      // Whether the iframe is visible in its own document: content in a hidden
+      // frame is hidden, whatever its own style says.
+      visible: found !== null && api.visible(found)
+    };
+  };
+  try {
+    let value;
+    switch (op) {
+      case "frame":
+        value = await iframe(await one());
+        break;
+      case "frameNow":
+        value = await iframe(api.oneNow(null, scope, selector, options));
+        break;
+      case "element":
+        value = { element: await one() };
+        break;
+      case "probe": {
+        const matches = api.allNow(null, scope, selector, options);
+        value = { count: matches.length, element: matches.length === 1 ? matches[0] : null };
+        break;
+      }
+      case "visible": {
+        const matches = api.allNow(null, scope, selector, options);
+        value = {
+          count: matches.length,
+          visible: matches.length === 1 && api.visible(matches[0])
+        };
+        break;
+      }
+      case "count":
+        value = await api.count(null, scope, selector, options);
+        break;
+      case "texts": {
+        const matches = await api.all(null, scope, selector, options);
+        const index = selector.nth;
+        const listed = index === void 0 ? matches : matches.slice(index, index + 1);
+        value = listed.map((element) => element.textContent ?? "");
+        break;
+      }
+      case "text":
+        value = (await one()).textContent ?? "";
+        break;
+      case "value":
+        value = (await one()).value ?? "";
+        break;
+      case "attribute":
+        value = (await one()).getAttribute(arg ?? "");
+        break;
+      case "enabled": {
+        const element = await one();
+        value = {
+          disabled: element.disabled === true || element.closest(":disabled") !== null,
+          aria: element.getAttribute("aria-disabled")
+        };
+        break;
+      }
+      case "checked": {
+        const element = await one();
+        value = {
+          element,
+          aria: element.getAttribute("aria-checked"),
+          native: Boolean(element.checked)
+        };
+        break;
+      }
+      case "selected": {
+        const element = await one();
+        value = [...element.selectedOptions ?? []].map((option) => option.value);
+        break;
+      }
+      case "select": {
+        const element = await one();
+        value = {
+          element,
+          multiple: element.multiple,
+          selected: [...element.selectedOptions ?? []].map((option) => option.value),
+          // What each option can be chosen by: its value, or the label it shows.
+          options: [...element.options ?? []].map((option) => ({
+            value: option.value,
+            label: option.label.trim()
+          }))
+        };
+        break;
+      }
+      case "clear": {
+        const element = await one();
+        const direct = ["range", "date", "datetime-local", "month", "week", "time", "color"];
+        element.focus();
+        if (typeof element.select === "function") element.select();
+        else window.getSelection()?.selectAllChildren(element);
+        value = {
+          element,
+          direct: element.localName === "input" && direct.includes(element.type),
+          filled: (element.value ?? element.textContent ?? "") !== ""
+        };
+        break;
+      }
+      case "box":
+        value = api.box(await one());
+        break;
+      case "upload": {
+        const element = await one();
+        const control = element.localName === "label" ? element.control : null;
+        const input = control ?? element;
+        value = {
+          element: input,
+          target: api.fileTarget(element),
+          filled: (input.files?.length ?? 0) > 0
+        };
+        break;
+      }
+      case "focus":
+        ;
+        (await one()).focus();
+        value = null;
+        break;
+      case "blur":
+        ;
+        (await one()).blur();
+        value = null;
+        break;
+    }
+    return { kind: "ok", value, url: location.href };
+  } catch (error) {
+    const { name: name2 = "Error", message = String(error) } = error ?? {};
+    return { kind: "error", name: name2, message };
+  }
+}
+
+// src/webdriver.ts
+var classic;
+function classicScript() {
+  if (classic === void 0) classic = `return (${pageScript.toString()}).apply(null, arguments)`;
+  return classic;
+}
+async function callPage(driver, site, op, scope, selector, timeout, arg = null) {
+  checkTestIds(scope, selector);
+  const args = [
+    PAGE_API_GLOBAL,
+    op,
+    scope.map(encodeSelector),
+    encodeSelector(selector),
+    // The page cannot see this process's configure(), so the settings travel.
+    { testIdAttribute: getConfig().testIdAttribute, timeout },
+    arg
+  ];
+  const ask = async () => await driver.run(site, args);
+  let reply = await ask();
+  if (reply.kind === "missing") {
+    await driver.inject(site, injectSource());
+    reply = await ask();
+  }
+  if (reply.kind === "missing") {
+    throw new Error("harnessed: the resolver could not be injected into the page.");
+  }
+  if (reply.kind === "error") throw reviveStrictViolation(new PageError(reply.name, reply.message));
+  if (site.top) driver.sawUrl?.(reply.url);
+  return reply.value;
+}
+function splitAtFrames(scope) {
+  const hops = [];
+  let current = [];
+  for (const link of scope) {
+    if (link.frame === true) {
+      hops.push({ scope: current, link });
+      current = [];
+    } else {
+      current.push(link);
+    }
+  }
+  return { hops, rest: current };
+}
+var FrameAbsent = class extends Error {
+  name = "FrameAbsent";
+};
+async function walk(driver, scope, options, operation) {
+  const deadline = Date.now() + options.timeout;
+  const remaining = () => Math.max(0, deadline - Date.now());
+  const { hops, rest } = splitAtFrames(scope);
+  let site = driver.top();
+  let entered = false;
+  try {
+    for (const hop of hops) {
+      const op = options.waiting ? "frame" : "frameNow";
+      const found = await callPage(driver, site, op, hop.scope, hop.link, remaining());
+      if (found.element === null) throw new FrameAbsent();
+      const iframe = await driver.element(site, found.element);
+      await options.onFrame?.(iframe, { visible: found.visible });
+      const origin = { x: site.origin.x + found.origin.x, y: site.origin.y + found.origin.y };
+      site = await driver.enterFrame(site, iframe, origin);
+      entered = true;
+    }
+    return await operation(site, rest, remaining);
+  } finally {
+    if (entered) await driver.leaveFrames();
+  }
+}
+
+export { FrameAbsent, PageError, callPage, classicScript, isFrameEntryError, pageScript, walk };
+//# sourceMappingURL=webdriver.js.map
+//# sourceMappingURL=webdriver.js.map

package/dist/webdriver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/webdriver-page-script.ts","../src/webdriver.ts"],"names":["name"],"mappings":"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","file":"webdriver.js","sourcesContent":["import type { PageApi, PageApiOptions } from './page-api'\nimport type { WireSelector } from './wire'\n\n/**\n * What the in-page script does with the target it resolves. Reads happen in the\n * page, in the same round-trip as the resolution: a WebDriver command costs a\n * few milliseconds each way, and a read that first fetched an element reference\n * and then asked about it would pay that twice.\n */\nexport type PageOp =\n  | 'frame'\n  | 'frameNow'\n  | 'element'\n  | 'probe'\n  | 'visible'\n  | 'count'\n  | 'texts'\n  | 'text'\n  | 'value'\n  | 'attribute'\n  | 'enabled'\n  | 'checked'\n  | 'selected'\n  | 'select'\n  | 'clear'\n  | 'focus'\n  | 'blur'\n  | 'box'\n  | 'upload'\n\n/**\n * The script's answer. A page error comes back as a value rather than a thrown\n * script error, so its name and message arrive intact — a thrown one reaches the\n * test wrapped in protocol noise, and under WebDriver Classic is logged as a\n * driver failure as well.\n */\nexport type PageReply =\n  | { kind: 'missing' }\n  | { kind: 'ok'; value: unknown; url: string }\n  | { kind: 'error'; name: string; message: string }\n\n/** Raised in the page by the shared resolver: strictness, index and frame rules. */\nexport class PageError extends Error {\n  constructor(name: string, message: string) {\n    super(message)\n    this.name = name\n  }\n}\n\n/** The shared resolver's refusal of a frame it cannot enter. Never \"not there yet\". */\nexport function isFrameEntryError(error: unknown): boolean {\n  return error instanceof PageError && error.name === 'FrameEntryError'\n}\n\n/**\n * An element as WebDriver returns it from a script, before the driver's client\n * wraps it (WebdriverIO's `$()`; selenium-webdriver hands back a `WebElement`\n * already).\n */\nexport type ElementRef = { 'element-6066-11e4-a52e-4f735466cecf': string }\n\n/**\n * Runs IN THE PAGE, serialised with `Function.prototype.toString`, so it must\n * close over nothing: every input arrives as an argument. Elements are\n * only ever returned as object properties, each at most once — WebDriver BiDi\n * serialises an element repeated in a result, or one inside an array, as `{}`.\n */\nexport async function pageScript(\n  name: string,\n  op: PageOp,\n  scope: WireSelector[],\n  selector: WireSelector,\n  options: PageApiOptions,\n  arg: string | null,\n): Promise<PageReply> {\n  const api = (window as unknown as Record<string, PageApi | undefined>)[name]\n  // Navigation replaces the window, and the resolver with it.\n  if (api === undefined) return { kind: 'missing' }\n  const one = () => api.one(null, scope, selector, options)\n  /**\n   * A frame link must land on an iframe. When it does not, walking through the\n   * same link with the shared resolver raises its FrameEntryError, so the\n   * refusal and its wording stay the resolver's rather than a copy kept here.\n   */\n  const iframe = async (found: Element | null) => {\n    if (found !== null && found.localName !== 'iframe') {\n      await api.count(null, [...scope, selector], selector, options)\n    }\n    return {\n      element: found,\n      origin: found === null ? { x: 0, y: 0 } : api.origin(found),\n      // Whether the iframe is visible in its own document: content in a hidden\n      // frame is hidden, whatever its own style says.\n      visible: found !== null && api.visible(found),\n    }\n  }\n  try {\n    let value: unknown\n    switch (op) {\n      case 'frame':\n        value = await iframe(await one())\n        break\n      case 'frameNow':\n        value = await iframe(api.oneNow(null, scope, selector, options))\n        break\n      case 'element':\n        value = { element: await one() }\n        break\n      case 'probe': {\n        // `allNow` applies `nth` and answers at once; the caller decides what\n        // more than one match means, with the whole scope chain in hand.\n        const matches = api.allNow(null, scope, selector, options)\n        value = { count: matches.length, element: matches.length === 1 ? matches[0] : null }\n        break\n      }\n      case 'visible': {\n        // `probe`'s answer, with the layout check made in the same round-trip.\n        const matches = api.allNow(null, scope, selector, options)\n        value = {\n          count: matches.length,\n          visible: matches.length === 1 && api.visible(matches[0] as Element),\n        }\n        break\n      }\n      case 'count':\n        value = await api.count(null, scope, selector, options)\n        break\n      case 'texts': {\n        const matches = await api.all(null, scope, selector, options)\n        const index = (selector as { nth?: number }).nth\n        const listed = index === undefined ? matches : matches.slice(index, index + 1)\n        value = listed.map(element => element.textContent ?? '')\n        break\n      }\n      case 'text':\n        value = (await one()).textContent ?? ''\n        break\n      case 'value':\n        value = ((await one()) as HTMLInputElement).value ?? ''\n        break\n      case 'attribute':\n        value = (await one()).getAttribute(arg ?? '')\n        break\n      case 'enabled': {\n        const element = (await one()) as HTMLInputElement\n        // The property, and the closest `:disabled`, both see an ancestor\n        // fieldset's `disabled`; the element's own attribute does not.\n        value = {\n          disabled: element.disabled === true || element.closest(':disabled') !== null,\n          aria: element.getAttribute('aria-disabled'),\n        }\n        break\n      }\n      case 'checked': {\n        const element = (await one()) as HTMLInputElement\n        value = {\n          element,\n          aria: element.getAttribute('aria-checked'),\n          native: Boolean(element.checked),\n        }\n        break\n      }\n      case 'selected': {\n        const element = (await one()) as HTMLSelectElement\n        value = [...(element.selectedOptions ?? [])].map(option => option.value)\n        break\n      }\n      case 'select': {\n        const element = (await one()) as HTMLSelectElement\n        value = {\n          element,\n          multiple: element.multiple,\n          selected: [...(element.selectedOptions ?? [])].map(option => option.value),\n          // What each option can be chosen by: its value, or the label it shows.\n          options: [...(element.options ?? [])].map(option => ({\n            value: option.value,\n            label: option.label.trim(),\n          })),\n        }\n        break\n      }\n      case 'clear': {\n        const element = (await one()) as HTMLInputElement\n        // WebDriver sets these input types' values directly: they take no typing.\n        const direct = ['range', 'date', 'datetime-local', 'month', 'week', 'time', 'color']\n        element.focus()\n        // Selected, so one Backspace deletes it all: a real edit, which fires the\n        // input events a controlled component listens for.\n        if (typeof element.select === 'function') element.select()\n        else window.getSelection()?.selectAllChildren(element)\n        value = {\n          element,\n          direct: element.localName === 'input' && direct.includes(element.type),\n          filled: (element.value ?? element.textContent ?? '') !== '',\n        }\n        break\n      }\n      case 'box':\n        // In this document's viewport; the driver adds the frames' origins.\n        value = api.box(await one())\n        break\n      case 'upload': {\n        const element = await one()\n        const control = element.localName === 'label' ? (element as HTMLLabelElement).control : null\n        // The input itself, where a label is the target: WebDriver types paths into the input.\n        const input = (control ?? element) as HTMLInputElement\n        value = {\n          element: input,\n          target: api.fileTarget(element),\n          filled: (input.files?.length ?? 0) > 0,\n        }\n        break\n      }\n      case 'focus':\n        ;((await one()) as HTMLElement).focus()\n        value = null\n        break\n      case 'blur':\n        ;((await one()) as HTMLElement).blur()\n        value = null\n        break\n    }\n    return { kind: 'ok', value, url: location.href }\n  } catch (error) {\n    const { name = 'Error', message = String(error) } = (error ?? {}) as Partial<Error>\n    return { kind: 'error', name, message }\n  }\n}\n","import { checkTestIds, getConfig, reviveStrictViolation } from '@harnessed-ts/core'\nimport type { Selector } from '@harnessed-ts/core'\nimport type { Point } from './box'\nimport { injectSource } from './inject'\nimport { PAGE_API_GLOBAL } from './global-name'\nimport { encodeSelector } from './wire'\nimport { PageError, pageScript } from './webdriver-page-script'\nimport type { ElementRef, PageOp, PageReply } from './webdriver-page-script'\n\nexport { isFrameEntryError, PageError, pageScript } from './webdriver-page-script'\nexport type { ElementRef, PageOp, PageReply } from './webdriver-page-script'\nexport type { Point } from './box'\n\n/** What `pageScript` takes, in order: what every `WebDriverLike.run` passes it. */\nexport type PageScriptArgs = Parameters<typeof pageScript>\n\n/**\n * A document a WebDriver client is working in: the top-level one, or a frame's\n * a walk entered. A driver extends it with whatever it needs to address that\n * document (a BiDi browsing context, say).\n */\nexport interface WebDriverSite {\n  /** The top-level document, whose URL is the page's URL. */\n  readonly top: boolean\n  /** Where this document's viewport starts in the top-level one, in CSS pixels. */\n  readonly origin: Point\n}\n\n/**\n * What the shared WebDriver code needs from a client — WebdriverIO,\n * selenium-webdriver under Nightwatch — and nothing more: running a script in a\n * document, and crossing into a frame. `S` is the client's site, `E` its element.\n */\nexport interface WebDriverLike<S extends WebDriverSite, E> {\n  /** The top-level document. */\n  top(): S\n  /**\n   * Runs `pageScript` in the site's document with these arguments and returns\n   * its reply. Under WebDriver Classic, `classicScript()` is the body to send.\n   */\n  run(site: S, args: PageScriptArgs): Promise<unknown>\n  /** Evaluates the resolver's injectable source in the site's document. */\n  inject(site: S, source: string): Promise<void>\n  /** An element the page script returned, as the client's own element. */\n  element(site: S, ref: ElementRef): Promise<E>\n  /**\n   * Enters `iframe`, an element of `site`'s document, and returns the site for\n   * the frame's document, at `origin` in the top-level viewport.\n   */\n  enterFrame(site: S, iframe: E, origin: Point): Promise<S>\n  /**\n   * Undoes what entering frames changed in the session — under Classic, switches\n   * back to the top-level document. Called once after a walk that entered any.\n   */\n  leaveFrames(): Promise<void>\n  /** Hears the top-level document's URL, which every call there brings back. */\n  sawUrl?(url: string): void\n}\n\nlet classic: string | undefined\n\n/**\n * The page script as a classic Execute Script body, which awaits the promise\n * the script returns.\n */\nexport function classicScript(): string {\n  if (classic === undefined) classic = `return (${pageScript.toString()}).apply(null, arguments)`\n  return classic\n}\n\n/**\n * Runs one operation of the shared resolver in a document, injecting the\n * resolver first if the document does not have it yet.\n *\n * The presence check rides along with the call itself, so a document that\n * already has the resolver pays one round-trip, not two. Injecting happens once\n * per document: navigation replaces the window, and the resolver with it.\n */\nexport async function callPage<S extends WebDriverSite, E>(\n  driver: WebDriverLike<S, E>,\n  site: S,\n  op: PageOp,\n  scope: readonly Selector[],\n  selector: Selector,\n  timeout: number,\n  arg: string | null = null,\n): Promise<unknown> {\n  checkTestIds(scope, selector)\n  const args: PageScriptArgs = [\n    PAGE_API_GLOBAL,\n    op,\n    scope.map(encodeSelector),\n    encodeSelector(selector),\n    // The page cannot see this process's configure(), so the settings travel.\n    { testIdAttribute: getConfig().testIdAttribute, timeout },\n    arg,\n  ]\n  const ask = async () => (await driver.run(site, args)) as PageReply\n  let reply = await ask()\n  if (reply.kind === 'missing') {\n    await driver.inject(site, injectSource())\n    reply = await ask()\n  }\n  if (reply.kind === 'missing') {\n    throw new Error('harnessed: the resolver could not be injected into the page.')\n  }\n  // A strict violation comes back as core's own class, as under every driver.\n  if (reply.kind === 'error') throw reviveStrictViolation(new PageError(reply.name, reply.message))\n  if (site.top) driver.sawUrl?.(reply.url)\n  return reply.value\n}\n\n/** A scope chain cut at a frame link: the links before it, and the link itself. */\ninterface Hop {\n  scope: Selector[]\n  link: Selector\n}\n\nfunction splitAtFrames(scope: readonly Selector[]): { hops: Hop[]; rest: Selector[] } {\n  const hops: Hop[] = []\n  let current: Selector[] = []\n  for (const link of scope) {\n    if (link.frame === true) {\n      hops.push({ scope: current, link })\n      current = []\n    } else {\n      current.push(link)\n    }\n  }\n  return { hops, rest: current }\n}\n\n/** A non-waiting walk found a frame link that is not on screen. */\nexport class FrameAbsent extends Error {\n  override name = 'FrameAbsent'\n}\n\n/** What the page reports about an iframe a walk is about to enter. */\nexport interface FrameInfo {\n  /** Whether the iframe is visible by layout in its own document. */\n  readonly visible: boolean\n}\n\nexport interface WalkOptions<E> {\n  /** Wait for each frame link, or answer at once by throwing FrameAbsent. */\n  waiting: boolean\n  /** The budget for every hop and the operation together. */\n  timeout: number\n  /** Called with each iframe element, from its own document, before entering it. */\n  onFrame?: (iframe: E, info: FrameInfo) => Promise<void>\n}\n\n/**\n * Walks the scope chain's frame links, entering each frame, then runs the\n * operation in the innermost document with the links that remain.\n *\n * A WebDriver element belongs to one document: an element inside a frame cannot\n * be acted on from the top-level one, even where the page's own script could\n * reach it. So the shared resolver runs once per document — up to the iframe,\n * then inside it — and WebDriver does the crossing. That is also why\n * cross-origin frames work here, where an in-page resolver cannot enter them.\n *\n * Whatever entering changed in the session is undone afterwards, whatever\n * happened (`leaveFrames`).\n */\nexport async function walk<S extends WebDriverSite, E, T>(\n  driver: WebDriverLike<S, E>,\n  scope: readonly Selector[],\n  options: WalkOptions<E>,\n  operation: (site: S, scope: Selector[], remaining: () => number) => Promise<T>,\n): Promise<T> {\n  const deadline = Date.now() + options.timeout\n  const remaining = () => Math.max(0, deadline - Date.now())\n  const { hops, rest } = splitAtFrames(scope)\n  let site = driver.top()\n  let entered = false\n  try {\n    for (const hop of hops) {\n      const op = options.waiting ? 'frame' : 'frameNow'\n      const found = (await callPage(driver, site, op, hop.scope, hop.link, remaining())) as {\n        element: ElementRef | null\n        origin: Point\n        visible: boolean\n      }\n      if (found.element === null) throw new FrameAbsent()\n      const iframe = await driver.element(site, found.element)\n      await options.onFrame?.(iframe, { visible: found.visible })\n      // The frame's document starts where its content box does, in the document around it.\n      const origin = { x: site.origin.x + found.origin.x, y: site.origin.y + found.origin.y }\n      site = await driver.enterFrame(site, iframe, origin)\n      entered = true\n    }\n    return await operation(site, rest, remaining)\n  } finally {\n    if (entered) await driver.leaveFrames()\n  }\n}\n"]}

package/dist/wire.d.ts

@@ -0,0 +1,16 @@
+import type { Selector } from '@harnessed-ts/core';
+/**
+ * A `Selector` as it crosses into a remote page. Everything in one is JSON-safe
+ * except a RegExp — `role('button', { name: /save/i })` — which WebDriver,
+ * CDP and TestCafe all serialise to `{}`. This encodes them as tagged objects
+ * on the way out, and the page API decodes them on the way in.
+ */
+export interface WireRegExp {
+    $regexp: string;
+    flags: string;
+}
+export type WireSelector = Record<string, unknown>;
+export declare function encodeSelector(selector: Selector): WireSelector;
+/** Idempotent: a selector that never left the process decodes to itself. */
+export declare function decodeSelector(selector: Selector | WireSelector): Selector;
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AA2ClD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAE/D;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAE1E"}

package/package.json

@@ -1,6 +1,82 @@
 {
   "name": "@harnessed-ts/resolve",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.0",
+  "description": "The shared selector resolver behind the Testing Library-family drivers, plus an injectable build for drivers that resolve inside a remote page.",
+  "keywords": [
+    "testing",
+    "harness",
+    "testing-library",
+    "resolver"
+  ],
+  "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/resolve"
+  },
+  "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"
+    },
+    "./inject": {
+      "types": "./dist/inject.d.ts",
+      "import": "./dist/inject.js",
+      "require": "./dist/inject.cjs"
+    },
+    "./webdriver": {
+      "types": "./dist/webdriver.d.ts",
+      "import": "./dist/webdriver.js",
+      "require": "./dist/webdriver.cjs"
+    },
+    "./inject.global.js": "./dist/inject.global.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "dependencies": {
+    "@harnessed-ts/core": "^0.7.0"
+  },
+  "peerDependencies": {
+    "@testing-library/dom": ">=10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.2",
+    "@types/jsdom": "^30.0.0",
+    "@types/node": "^26.6.5",
+    "jsdom": "^30.1.1",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "vitest run"
+  }
 }