@harnessed-ts/resolve 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @harnessed-ts/resolve
 
+## 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
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -68,6 +68,40 @@ from `@harnessed-ts/core` so a strict-mode violation is `StrictModeViolation`
 again, worded exactly as an in-process driver words it — that is how a caller
 tells ambiguity apart from absence.
 
+## WebDriver drivers
+
+A WebDriver client (WebdriverIO, selenium-webdriver under Nightwatch) shares more
+than injection: the page script that resolves and reads in one round-trip, and
+the walk that enters each frame of a scope chain from outside the page.
+`@harnessed-ts/resolve/webdriver` holds both, behind a small `WebDriverLike`
+adapter — run the page script in a document, inject the resolver, wrap an
+element, enter a frame, leave frames:
+
+```ts
+import { callPage, classicScript, walk } from '@harnessed-ts/resolve/webdriver'
+import type { WebDriverLike, WebDriverSite } from '@harnessed-ts/resolve/webdriver'
+
+const client: WebDriverLike<WebDriverSite, WebElement> = {
+  top: () => ({ top: true, origin: { x: 0, y: 0 } }),
+  run: (_site, args) => driver.executeScript(classicScript(), ...args),
+  inject: async (_site, source) => void (await driver.executeScript(source)),
+  element: async (_site, ref) => ref as unknown as WebElement,
+  async enterFrame(_site, iframe, origin) {
+    await driver.switchTo().frame(iframe)
+    return { top: false, origin }
+  },
+  leaveFrames: () => driver.switchTo().defaultContent(),
+}
+
+const text = await walk(client, scope, { waiting: true, timeout }, (site, rest, remaining) =>
+  callPage(client, site, 'text', rest, selector, remaining()),
+)
+```
+
+Errors the page raises come back as values, so a strict violation arrives as
+core's `StrictModeViolation` and a frame that cannot be entered as a
+`PageError` (`isFrameEntryError`).
+
 Full guide: the [harnessed README](https://github.com/joegaudet/harnessed#readme).
 
 MIT © Joe Gaudet, Jay Seo

package/dist/chunk-BYG4HMLR.js

@@ -0,0 +1,61 @@
+import { readFileSync, mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+
+// src/inject.ts
+
+// src/global-name.ts
+var PAGE_API_GLOBAL = "__harnessedResolve";
+
+// src/wire.ts
+function isRegExp(value) {
+  return Object.prototype.toString.call(value) === "[object RegExp]";
+}
+function encodeValue(value) {
+  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags };
+  if (Array.isArray(value)) return value.map(encodeValue);
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)])
+    );
+  }
+  return value;
+}
+function encodeSelector(selector) {
+  return encodeValue(selector);
+}
+
+// src/inject.ts
+function injectPath() {
+  if (typeof __filename === "string") return join(dirname(__filename), "inject.global.js");
+  return fileURLToPath(new URL("./inject.global.js", import.meta.url));
+}
+var cached;
+function injectSource() {
+  if (cached === void 0) cached = readFileSync(injectPath(), "utf8");
+  return cached;
+}
+var uploads;
+var written = 0;
+async function filesOnDisk(files) {
+  if (uploads === void 0) {
+    const root2 = mkdtempSync(join(tmpdir(), "harnessed-uploads-"));
+    uploads = root2;
+    process.once("exit", () => rmSync(root2, { recursive: true, force: true }));
+  }
+  const root = uploads;
+  return Promise.all(
+    files.map(async (file) => {
+      const dir = join(root, String(written++));
+      mkdirSync(dir);
+      const path = join(dir, basename(file.name) || "upload");
+      writeFileSync(path, new Uint8Array(await file.arrayBuffer()));
+      return path;
+    })
+  );
+}
+
+export { PAGE_API_GLOBAL, encodeSelector, filesOnDisk, injectPath, injectSource };
+//# sourceMappingURL=chunk-BYG4HMLR.js.map
+//# sourceMappingURL=chunk-BYG4HMLR.js.map

package/dist/chunk-BYG4HMLR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/global-name.ts","../src/wire.ts","../src/inject.ts"],"names":["root"],"mappings":";;;;;;;;AAKO,IAAM,eAAA,GAAkB;;;ACe/B,SAAS,SAAS,KAAA,EAAiC;AACjD,EAAA,OAAO,MAAA,CAAO,SAAA,CAAU,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA,KAAM,iBAAA;AACnD;AAEA,SAAS,YAAY,KAAA,EAAyB;AAC5C,EAAA,IAAI,QAAA,CAAS,KAAK,CAAA,EAAG,OAAO,EAAE,SAAS,KAAA,CAAM,MAAA,EAAQ,KAAA,EAAO,KAAA,CAAM,KAAA,EAAM;AACxE,EAAA,IAAI,MAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,KAAA,CAAM,IAAI,WAAW,CAAA;AACtD,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,EAAM;AAC/C,IAAA,OAAO,MAAA,CAAO,WAAA;AAAA,MACZ,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,MAAM,CAAC,GAAA,EAAK,WAAA,CAAY,KAAK,CAAC,CAAC;AAAA,KACvE;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAuBO,SAAS,eAAe,QAAA,EAAkC;AAC/D,EAAA,OAAO,YAAY,QAAQ,CAAA;AAC7B;;;ACxCO,SAAS,UAAA,GAAqB;AAGnC,EAAA,IAAI,OAAO,eAAe,QAAA,EAAU,OAAO,KAAK,OAAA,CAAQ,UAAU,GAAG,kBAAkB,CAAA;AACvF,EAAA,OAAO,cAAc,IAAI,GAAA,CAAI,oBAAA,EAAsB,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AACrE;AAEA,IAAI,MAAA;AAMG,SAAS,YAAA,GAAuB;AACrC,EAAA,IAAI,WAAW,MAAA,EAAW,MAAA,GAAS,YAAA,CAAa,UAAA,IAAc,MAAM,CAAA;AACpE,EAAA,OAAO,MAAA;AACT;AAEA,IAAI,OAAA;AACJ,IAAI,OAAA,GAAU,CAAA;AAad,eAAsB,YAAY,KAAA,EAA2C;AAC3E,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAMA,QAAO,WAAA,CAAY,IAAA,CAAK,MAAA,EAAO,EAAG,oBAAoB,CAAC,CAAA;AAC7D,IAAA,OAAA,GAAUA,KAAAA;AACV,IAAA,OAAA,CAAQ,IAAA,CAAK,MAAA,EAAQ,MAAM,MAAA,CAAOA,KAAAA,EAAM,EAAE,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,MAAM,IAAA,GAAO,OAAA;AACb,EAAA,OAAO,OAAA,CAAQ,GAAA;AAAA,IACb,KAAA,CAAM,GAAA,CAAI,OAAM,IAAA,KAAQ;AACtB,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,EAAM,MAAA,CAAO,SAAS,CAAC,CAAA;AACxC,MAAA,SAAA,CAAU,GAAG,CAAA;AAEb,MAAA,MAAM,OAAO,IAAA,CAAK,GAAA,EAAK,SAAS,IAAA,CAAK,IAAI,KAAK,QAAQ,CAAA;AACtD,MAAA,aAAA,CAAc,MAAM,IAAI,UAAA,CAAW,MAAM,IAAA,CAAK,WAAA,EAAa,CAAC,CAAA;AAC5D,MAAA,OAAO,IAAA;AAAA,IACT,CAAC;AAAA,GACH;AACF","file":"chunk-BYG4HMLR.js","sourcesContent":["/**\n * Where the injected build installs itself on the page's `window`. A leaf\n * module with no imports, so the Node-side `inject` entry can name it without\n * pulling in the resolver and Testing Library, which only run in the page.\n */\nexport const PAGE_API_GLOBAL = '__harnessedResolve'\n","import type { Selector } from '@harnessed-ts/core'\n\n/**\n * A `Selector` as it crosses into a remote page. Everything in one is JSON-safe\n * except a RegExp — `role('button', { name: /save/i })` — which WebDriver,\n * CDP and TestCafe all serialise to `{}`. This encodes them as tagged objects\n * on the way out, and the page API decodes them on the way in.\n */\nexport interface WireRegExp {\n  $regexp: string\n  flags: string\n}\n\nexport type WireSelector = Record<string, unknown>\n\n/**\n * Not `instanceof`: a selector built in the test process and handed to a page\n * in the same JS engine (jsdom, a same-origin frame) carries the other realm's\n * RegExp, which `instanceof` does not recognise.\n */\nfunction isRegExp(value: unknown): value is RegExp {\n  return Object.prototype.toString.call(value) === '[object RegExp]'\n}\n\nfunction encodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags }\n  if (Array.isArray(value)) return value.map(encodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nfunction isWireRegExp(value: unknown): value is WireRegExp {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as WireRegExp).$regexp === 'string' &&\n    typeof (value as WireRegExp).flags === 'string'\n  )\n}\n\nfunction decodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return new RegExp(value.source, value.flags)\n  if (isWireRegExp(value)) return new RegExp(value.$regexp, value.flags)\n  if (Array.isArray(value)) return value.map(decodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, decodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nexport function encodeSelector(selector: Selector): WireSelector {\n  return encodeValue(selector) as WireSelector\n}\n\n/** Idempotent: a selector that never left the process decodes to itself. */\nexport function decodeSelector(selector: Selector | WireSelector): Selector {\n  return decodeValue(selector) as Selector\n}\n","import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n// Leaf modules only: this entry runs in the test process, where the resolver\n// and Testing Library have no business loading.\nexport { PAGE_API_GLOBAL } from './global-name'\nexport { encodeSelector } from './wire'\nexport type { WireSelector } from './wire'\nexport type { PageApi, PageApiOptions } from './page-api'\n\ndeclare const __filename: string | undefined\n\n/**\n * Absolute path to the injectable build, for drivers that inject by path\n * (TestCafe's `clientScripts`, Puppeteer's `addScriptTag`).\n */\nexport function injectPath(): string {\n  // A sibling in dist/. The CJS build has __filename; the ESM build has\n  // import.meta.url and no __filename, so each takes its own branch.\n  if (typeof __filename === 'string') return join(dirname(__filename), 'inject.global.js')\n  return fileURLToPath(new URL('./inject.global.js', import.meta.url))\n}\n\nlet cached: string | undefined\n\n/**\n * The injectable build's source, for drivers that inject by evaluating a string\n * (WebdriverIO's `execute`, Puppeteer's `evaluate`). Read once per process.\n */\nexport function injectSource(): string {\n  if (cached === undefined) cached = readFileSync(injectPath(), 'utf8')\n  return cached\n}\n\nlet uploads: string | undefined\nlet written = 0\n\n/**\n * Writes files to disk for a driver whose browser only takes file paths\n * (Puppeteer's `uploadFile`, WebDriver's file input, TestCafe's\n * `setFilesToUpload`), and returns the paths in order.\n *\n * Each file gets a directory of its own, so its name survives as the path's\n * last segment even when two files share one. The browser reads the file when\n * the page does — after the upload resolves — so nothing is deleted until the\n * process exits. What travels is the name and the bytes: the browser infers\n * `type` from the extension, and `lastModified` is the time of writing.\n */\nexport async function filesOnDisk(files: readonly File[]): Promise<string[]> {\n  if (uploads === undefined) {\n    const root = mkdtempSync(join(tmpdir(), 'harnessed-uploads-'))\n    uploads = root\n    process.once('exit', () => rmSync(root, { recursive: true, force: true }))\n  }\n  const root = uploads\n  return Promise.all(\n    files.map(async file => {\n      const dir = join(root, String(written++))\n      mkdirSync(dir)\n      // basename: a name is a name, never a path out of the directory.\n      const path = join(dir, basename(file.name) || 'upload')\n      writeFileSync(path, new Uint8Array(await file.arrayBuffer()))\n      return path\n    }),\n  )\n}\n"]}

package/dist/inject.global.js

@@ -55,7 +55,7 @@ Unable to find an `+(l===!1?"accessible ":"")+'element with the role "'+t+'"'+c+
 `+u).trim()},PC=W(Co,Co.name,"queryAll"),dt=ee(Co,RC,CC),wC=dt[0],xC=dt[1],TC=dt[2],OC=dt[3],AC=dt[4],Mo=()=>A().testIdAttribute,Po=function(){for(var e=arguments.length,t=new Array(e),r=0;r<e;r++)t[r]=arguments[r];return Z(t[0]),Ma(Mo(),...t)},SC=(e,t)=>"Found multiple elements by: ["+Mo()+'="'+t+'"]',MC=(e,t)=>"Unable to find an element by: ["+Mo()+'="'+t+'"]',IC=W(Po,Po.name,"queryAll"),ct=ee(Po,SC,MC),NC=ct[0],BC=ct[1],LC=ct[2],jC=ct[3],FC=ct[4],wo=Object.freeze({__proto__:null,queryAllByLabelText:IR,queryByLabelText:TR,getAllByLabelText:SR,getByLabelText:MR,findAllByLabelText:OR,findByLabelText:AR,queryByPlaceholderText:jR,queryAllByPlaceholderText:LR,getByPlaceholderText:kR,getAllByPlaceholderText:FR,findAllByPlaceholderText:HR,findByPlaceholderText:DR,queryByText:WR,queryAllByText:VR,getByText:GR,getAllByText:zR,findAllByText:QR,findByText:XR,queryByDisplayValue:ZR,queryAllByDisplayValue:YR,getByDisplayValue:tC,getAllByDisplayValue:eC,findAllByDisplayValue:rC,findByDisplayValue:nC,queryByAltText:sC,queryAllByAltText:iC,getByAltText:dC,getAllByAltText:uC,findAllByAltText:cC,findByAltText:pC,queryByTitle:yC,queryAllByTitle:vC,getByTitle:gC,getAllByTitle:hC,findAllByTitle:qC,findByTitle:_C,queryByRole:wC,queryAllByRole:PC,getAllByRole:xC,getByRole:TC,findAllByRole:OC,findByRole:AC,queryByTestId:NC,queryAllByTestId:IC,getByTestId:LC,getAllByTestId:BC,findAllByTestId:jC,findByTestId:FC});function Ia(e,t,r){return t===void 0&&(t=wo),r===void 0&&(r={}),Object.keys(t).reduce((n,a)=>{let l=t[a];return n[a]=l.bind(null,e),n},r)}var $d={copy:{EventType:"ClipboardEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},cut:{EventType:"ClipboardEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},paste:{EventType:"ClipboardEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},compositionEnd:{EventType:"CompositionEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},compositionStart:{EventType:"CompositionEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},compositionUpdate:{EventType:"CompositionEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},keyDown:{EventType:"KeyboardEvent",defaultInit:{bubbles:!0,cancelable:!0,charCode:0,composed:!0}},keyPress:{EventType:"KeyboardEvent",defaultInit:{bubbles:!0,cancelable:!0,charCode:0,composed:!0}},keyUp:{EventType:"KeyboardEvent",defaultInit:{bubbles:!0,cancelable:!0,charCode:0,composed:!0}},focus:{EventType:"FocusEvent",defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},blur:{EventType:"FocusEvent",defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},focusIn:{EventType:"FocusEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},focusOut:{EventType:"FocusEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},change:{EventType:"Event",defaultInit:{bubbles:!0,cancelable:!1}},input:{EventType:"InputEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},invalid:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!0}},submit:{EventType:"Event",defaultInit:{bubbles:!0,cancelable:!0}},reset:{EventType:"Event",defaultInit:{bubbles:!0,cancelable:!0}},click:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,button:0,composed:!0}},contextMenu:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dblClick:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},drag:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dragEnd:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},dragEnter:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dragExit:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},dragLeave:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},dragOver:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dragStart:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},drop:{EventType:"DragEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseDown:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseEnter:{EventType:"MouseEvent",defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},mouseLeave:{EventType:"MouseEvent",defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},mouseMove:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseOut:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseOver:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseUp:{EventType:"MouseEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},select:{EventType:"Event",defaultInit:{bubbles:!0,cancelable:!1}},touchCancel:{EventType:"TouchEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},touchEnd:{EventType:"TouchEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},touchMove:{EventType:"TouchEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},touchStart:{EventType:"TouchEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},resize:{EventType:"UIEvent",defaultInit:{bubbles:!1,cancelable:!1}},scroll:{EventType:"UIEvent",defaultInit:{bubbles:!1,cancelable:!1}},wheel:{EventType:"WheelEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},abort:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},canPlay:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},canPlayThrough:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},durationChange:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},emptied:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},encrypted:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},ended:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},loadedData:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},loadedMetadata:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},loadStart:{EventType:"ProgressEvent",defaultInit:{bubbles:!1,cancelable:!1}},pause:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},play:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},playing:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},progress:{EventType:"ProgressEvent",defaultInit:{bubbles:!1,cancelable:!1}},rateChange:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},seeked:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},seeking:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},stalled:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},suspend:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},timeUpdate:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},volumeChange:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},waiting:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},load:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},error:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},animationStart:{EventType:"AnimationEvent",defaultInit:{bubbles:!0,cancelable:!1}},animationEnd:{EventType:"AnimationEvent",defaultInit:{bubbles:!0,cancelable:!1}},animationIteration:{EventType:"AnimationEvent",defaultInit:{bubbles:!0,cancelable:!1}},transitionCancel:{EventType:"TransitionEvent",defaultInit:{bubbles:!0,cancelable:!1}},transitionEnd:{EventType:"TransitionEvent",defaultInit:{bubbles:!0,cancelable:!0}},transitionRun:{EventType:"TransitionEvent",defaultInit:{bubbles:!0,cancelable:!1}},transitionStart:{EventType:"TransitionEvent",defaultInit:{bubbles:!0,cancelable:!1}},pointerOver:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerEnter:{EventType:"PointerEvent",defaultInit:{bubbles:!1,cancelable:!1}},pointerDown:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerMove:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerUp:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerCancel:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},pointerOut:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerLeave:{EventType:"PointerEvent",defaultInit:{bubbles:!1,cancelable:!1}},gotPointerCapture:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},lostPointerCapture:{EventType:"PointerEvent",defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},popState:{EventType:"PopStateEvent",defaultInit:{bubbles:!0,cancelable:!1}},offline:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},online:{EventType:"Event",defaultInit:{bubbles:!1,cancelable:!1}},pageHide:{EventType:"PageTransitionEvent",defaultInit:{bubbles:!0,cancelable:!0}},pageShow:{EventType:"PageTransitionEvent",defaultInit:{bubbles:!0,cancelable:!0}}},Ud={doubleClick:"dblClick"},kC=["value","files"],HC=["bubbles","cancelable","detail"];function Oa(e,t){return A().eventWrapper(()=>{if(!t)throw new Error("Unable to fire an event - please provide an event object.");if(!e)throw new Error('Unable to fire a "'+t.type+'" event - please provide a DOM element.');return e.dispatchEvent(t)})}function vo(e,t,r,n){let a=n===void 0?{}:n,l=a.EventType,o=l===void 0?"Event":l,i=a.defaultInit,s=i===void 0?{}:i;if(!t)throw new Error('Unable to fire a "'+e+'" event - please provide a DOM element.');let u={...s,...r},c=u.target,f=c===void 0?{}:c,h=f.value,_=f.files,C=bt(f,kC);h!==void 0&&DC(t,h),_!==void 0&&Object.defineProperty(t,"files",{configurable:!0,enumerable:!0,writable:!0,value:_}),Object.assign(t,C);let E=ec(t),R=E[o]||E.Event,p;if(typeof R=="function")p=new R(e,u);else{p=E.document.createEvent(o);let g=u.bubbles,m=u.cancelable,b=u.detail,w=bt(u,HC);p.initEvent(e,g,m,b),Object.keys(w).forEach(q=>{p[q]=w[q]})}return["dataTransfer","clipboardData"].forEach(g=>{let m=u[g];typeof m=="object"&&(typeof E.DataTransfer=="function"?Object.defineProperty(p,g,{value:Object.getOwnPropertyNames(m).reduce((b,w)=>(Object.defineProperty(b,w,{value:m[w]}),b),new E.DataTransfer)}):Object.defineProperty(p,g,{value:m}))}),p}Object.keys($d).forEach(e=>{let t=$d[e],r=t.EventType,n=t.defaultInit,a=e.toLowerCase();vo[e]=(l,o)=>vo(a,l,o,{EventType:r,defaultInit:n}),Oa[e]=(l,o)=>Oa(l,vo[e](l,o))});function DC(e,t){let r=Object.getOwnPropertyDescriptor(e,"value")||{},n=r.set,a=Object.getPrototypeOf(e),l=Object.getOwnPropertyDescriptor(a,"value")||{},o=l.set;if(o&&n!==o)o.call(e,t);else if(n)n.call(e,t);else throw new Error("The given element does not have a value setter")}Object.keys(Ud).forEach(e=>{let t=Ud[e];Oa[e]=function(){return Oa[t](...arguments)}});function $C(e){return e.replace(/[ \t]*[\n][ \t]*/g,`
 `)}function UC(e){return Wd.default.compressToEncodedURIComponent($C(e))}function VC(e){return"https://testing-playground.com/#markup="+UC(e)}var WC=(e,t,r)=>Array.isArray(e)?e.forEach(n=>kd(n,t,r)):kd(e,t,r),zC=function(e){if(e===void 0&&(e=Oo().body),!e||!("innerHTML"in e)){console.log("The element you're providing isn't a valid DOM element.");return}if(!e.innerHTML){console.log("The provided element doesn't have any children.");return}let t=VC(e.innerHTML);return console.log(`Open this URL in your browser
 
-`+t),t},Vd={debug:WC,logTestingPlaygroundURL:zC},NT=typeof document<"u"&&document.body?Ia(document.body,wo,Vd):Object.keys(wo).reduce((e,t)=>(e[t]=()=>{throw new TypeError("For queries bound to document.body a global document has to be available... Learn more: https://testing-library.com/s/screen-global-error")},e),Vd);var Io=Xo(e=>tc({testIdAttribute:e}));function mc(e,t){return[...e.querySelectorAll(t)]}var[,,,GC]=ee(mc,(e,t)=>`Found multiple elements by: ${t}`,(e,t)=>`Unable to find an element by: ${t}`);function bc(e){return Qo(mt().testIdAttribute,e.testId)}function Me(e,t){Io();let r=Ia(e);switch(t.type){case"role":return r.queryAllByRole(t.role,t.options);case"label":return r.queryAllByLabelText(t.text);case"testId":{let n=bc(t);return n===void 0?r.queryAllByTestId(t.testId):mc(e,n)}case"text":return r.queryAllByText(t.text);case"placeholder":return r.queryAllByPlaceholderText(t.text)}}async function vc(e,t,r,n){Io();let a=Me(e,r),l=a.length>0?a:await QC(e,r,n);return No(l,t,r)}function No(e,t,r){if(r.nth!==void 0){let n=e[r.nth];if(n===void 0)throw Uo(r.nth,e.length,t,r);return n}if(e.length>1)throw $o(e.length,t,r);return e[0]}async function QC(e,t,r){Io();let n=Ia(e),a={timeout:Go(r)};switch(t.type){case"role":return n.findAllByRole(t.role,t.options,a);case"label":return n.findAllByLabelText(t.text,void 0,a);case"testId":{let l=bc(t);return l===void 0?n.findAllByTestId(t.testId,void 0,a):GC(e,l,void 0,a)}case"text":return n.findAllByText(t.text,void 0,a);case"placeholder":return n.findAllByPlaceholderText(t.text,void 0,a)}}async function Bo(e,t,r){let n=e;for(let[a,l]of t.entries()){let o=t.slice(0,a),i=await vc(n,o,l,r);n=l.frame===!0?yc(i,o,l):i}return n}var Se=class extends Error{constructor(){super(...arguments);pt(this,"name","FrameEntryError")}};function yc(e,t,r){if(e.localName!=="iframe")throw new Se(`harnessed: ${Le(t,r)} is marked as a frame but is a <${e.localName}>, not an <iframe>.`);let n=e.contentDocument?.body;if(n==null)throw new Se(`harnessed: ${Le(t,r)} has no reachable document: it is cross-origin, or its document has no body. The dom driver enters same-origin frames only; drive a cross-origin one with a browser driver.`);return n}async function hc(e,t,r,n){let a=await Bo(e,t,n);return vc(a,t,r,n)}async function gc(e,t,r,n){let a;try{a=await Bo(e,t,n)}catch(o){if(o instanceof Se)throw o;return 0}let l=Me(a,r);return r.nth===void 0?l.length:l[r.nth]===void 0?0:1}function qc(e,t){let r=e;for(let[n,a]of t.entries()){let l=t.slice(0,n),o=Me(r,a);if(o.length===0)return null;let i=No(o,l,a);r=a.frame===!0?yc(i,l,a):i}return r}function _c(e,t,r){let n=qc(e,t);if(n===null)return null;let a=Me(n,r);return a.length===0?null:No(a,t,r)}function Ec(e,t,r){let n;try{n=qc(e,t)}catch(o){if(o instanceof Se)throw o;return[]}if(n===null)return[];let a=Me(n,r);if(r.nth===void 0)return a;let l=a[r.nth];return l===void 0?[]:[l]}async function Rc(e,t,r,n){return Me(await Bo(e,t,n),r)}function Lo(e,t){if(!Cc(e))return!1;let r=e.ownerDocument;if(r===t)return!0;let n=r.defaultView?.frameElement;return n==null||Lo(n,t)}function Cc(e){let t=e.ownerDocument.defaultView;if(t==null)return!1;let r=t.getComputedStyle(e);if(r.display==="contents")return[...e.children].some(a=>Cc(a));if(r.visibility!=="visible")return!1;let n=e.getBoundingClientRect();return n.width>0&&n.height>0}function XC(e){return Object.prototype.toString.call(e)==="[object RegExp]"}function KC(e){return typeof e=="object"&&e!==null&&typeof e.$regexp=="string"&&typeof e.flags=="string"}function jo(e){return XC(e)?new RegExp(e.source,e.flags):KC(e)?new RegExp(e.$regexp,e.flags):Array.isArray(e)?e.map(jo):typeof e=="object"&&e!==null?Object.fromEntries(Object.entries(e).map(([t,r])=>[t,jo(r)])):e}function Fo(e){return jo(e)}function Pc(e){let t=a=>a??e.body,r=a=>zo({testIdAttribute:a.testIdAttribute}),n=(a,l)=>[a.map(Fo),Fo(l)];return{async count(a,l,o,i){r(i);let[s,u]=n(l,o);return gc(t(a),s,u,i.timeout)},async one(a,l,o,i){r(i);let[s,u]=n(l,o);return hc(t(a),s,u,i.timeout)},async all(a,l,o,i){r(i);let[s,u]=n(l,o);return Rc(t(a),s,u,i.timeout)},oneNow(a,l,o,i){r(i);let[s,u]=n(l,o);return _c(t(a),s,u)},allNow(a,l,o,i){r(i);let[s,u]=n(l,o);return Ec(t(a),s,u)},visible(a){return Lo(a,a.ownerDocument)},box:Ko,origin:Jo,fileTarget(a){let l=Yo(a);return typeof l=="string"?l:{multiple:l.multiple}}}}var wc=globalThis;ft in wc||(wc[ft]=Pc(document));})();
+`+t),t},Vd={debug:WC,logTestingPlaygroundURL:zC},NT=typeof document<"u"&&document.body?Ia(document.body,wo,Vd):Object.keys(wo).reduce((e,t)=>(e[t]=()=>{throw new TypeError("For queries bound to document.body a global document has to be available... Learn more: https://testing-library.com/s/screen-global-error")},e),Vd);var Io=Xo(e=>tc({testIdAttribute:e}));function mc(e,t){return[...e.querySelectorAll(t)]}var[,,,GC]=ee(mc,(e,t)=>`Found multiple elements by: ${t}`,(e,t)=>`Unable to find an element by: ${t}`);function bc(e){return Qo(mt().testIdAttribute,e.testId)}function Me(e,t){Io();let r=Ia(e);switch(t.type){case"role":return r.queryAllByRole(t.role,t.options);case"label":return r.queryAllByLabelText(t.text);case"testId":{let n=bc(t);return n===void 0?r.queryAllByTestId(t.testId):mc(e,n)}case"text":return r.queryAllByText(t.text);case"placeholder":return r.queryAllByPlaceholderText(t.text)}}async function vc(e,t,r,n){Io();let a=Me(e,r),l=a.length>0?a:await QC(e,r,n);return No(l,t,r)}function No(e,t,r){if(r.nth!==void 0){let n=e[r.nth];if(n===void 0)throw Uo(r.nth,e.length,t,r);return n}if(e.length>1)throw $o(e.length,t,r);return e[0]}async function QC(e,t,r){Io();let n=Ia(e),a={timeout:Go(r)};switch(t.type){case"role":return n.findAllByRole(t.role,t.options,a);case"label":return n.findAllByLabelText(t.text,void 0,a);case"testId":{let l=bc(t);return l===void 0?n.findAllByTestId(t.testId,void 0,a):GC(e,l,void 0,a)}case"text":return n.findAllByText(t.text,void 0,a);case"placeholder":return n.findAllByPlaceholderText(t.text,void 0,a)}}async function Bo(e,t,r){let n=e;for(let[a,l]of t.entries()){let o=t.slice(0,a),i=await vc(n,o,l,r);n=l.frame===!0?yc(i,o,l):i}return n}var Se=class extends Error{constructor(){super(...arguments);pt(this,"name","FrameEntryError")}};function yc(e,t,r){if(e.localName!=="iframe")throw new Se(`harnessed: ${Le(t,r)} is marked as a frame but is a <${e.localName}>, not an <iframe>.`);let n=e.contentDocument?.body;if(n==null)throw new Se(`harnessed: ${Le(t,r)} has no reachable document: it is cross-origin, or its document has no body. The dom driver enters same-origin frames only; drive a cross-origin one with a browser driver.`);return n}async function hc(e,t,r,n){let a=await Bo(e,t,n);return vc(a,t,r,n)}async function gc(e,t,r,n){let a;try{a=await Bo(e,t,n)}catch(o){if(o instanceof Se)throw o;return 0}let l=Me(a,r);return r.nth===void 0?l.length:l[r.nth]===void 0?0:1}function qc(e,t){let r=e;for(let[n,a]of t.entries()){let l=t.slice(0,n),o=Me(r,a);if(o.length===0)return null;let i=No(o,l,a);r=a.frame===!0?yc(i,l,a):i}return r}function _c(e,t,r){let n=qc(e,t);if(n===null)return null;let a=Me(n,r);return a.length===0?null:No(a,t,r)}function Ec(e,t,r){let n;try{n=qc(e,t)}catch(o){if(o instanceof Se)throw o;return[]}if(n===null)return[];let a=Me(n,r);if(r.nth===void 0)return a;let l=a[r.nth];return l===void 0?[]:[l]}async function Rc(e,t,r,n){return Me(await Bo(e,t,n),r)}function Lo(e,t){if(!Cc(e))return!1;let r=e.ownerDocument;if(r===t)return!0;let n=r.defaultView?.frameElement;return n==null||Lo(n,t)}function Cc(e){let t=e.ownerDocument.defaultView;if(t==null)return!1;let r=t.getComputedStyle(e);if(r.display==="contents")return[...e.children].some(a=>Cc(a));if(r.visibility!=="visible")return!1;let n=e.getBoundingClientRect();return n.width>0&&n.height>0}function XC(e){return Object.prototype.toString.call(e)==="[object RegExp]"}function KC(e){return typeof e=="object"&&e!==null&&typeof e.$regexp=="string"&&typeof e.flags=="string"}function jo(e){return XC(e)?new RegExp(e.source,e.flags):KC(e)?new RegExp(e.$regexp,e.flags):Array.isArray(e)?e.map(jo):typeof e=="object"&&e!==null?Object.fromEntries(Object.entries(e).map(([t,r])=>[t,jo(r)])):e}function Fo(e){return jo(e)}function Pc(e){let t=a=>a??e.body,r=a=>zo({testIdAttribute:a.testIdAttribute}),n=(a,l)=>[a.map(Fo),Fo(l)];return{async count(a,l,o,i){r(i);let[s,u]=n(l,o);return gc(t(a),s,u,i.timeout)},async one(a,l,o,i){r(i);let[s,u]=n(l,o);return hc(t(a),s,u,i.timeout)},async all(a,l,o,i){r(i);let[s,u]=n(l,o);return Rc(t(a),s,u,i.timeout)},oneNow(a,l,o,i){r(i);let[s,u]=n(l,o);return _c(t(a),s,u)},allNow(a,l,o,i){r(i);let[s,u]=n(l,o);return Ec(t(a),s,u)},visible(a){return Lo(a,a.ownerDocument)},box:Ko,origin:Jo,fileTarget(a){let l=Yo(a);return typeof l=="string"?l:{multiple:l.multiple}}}}var wc=typeof window>"u"?globalThis:window;ft in wc||(wc[ft]=Pc(document));})();
 /*! Bundled license information:
 
 react-is/cjs/react-is.production.min.js:

package/dist/inject.js

@@ -1,61 +1,3 @@
-import { readFileSync, mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'fs';
-import { tmpdir } from 'os';
-import { join, dirname, basename } from 'path';
-import { fileURLToPath } from 'url';
-
-// src/inject.ts
-
-// src/global-name.ts
-var PAGE_API_GLOBAL = "__harnessedResolve";
-
-// src/wire.ts
-function isRegExp(value) {
-  return Object.prototype.toString.call(value) === "[object RegExp]";
-}
-function encodeValue(value) {
-  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags };
-  if (Array.isArray(value)) return value.map(encodeValue);
-  if (typeof value === "object" && value !== null) {
-    return Object.fromEntries(
-      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)])
-    );
-  }
-  return value;
-}
-function encodeSelector(selector) {
-  return encodeValue(selector);
-}
-
-// src/inject.ts
-function injectPath() {
-  if (typeof __filename === "string") return join(dirname(__filename), "inject.global.js");
-  return fileURLToPath(new URL("./inject.global.js", import.meta.url));
-}
-var cached;
-function injectSource() {
-  if (cached === void 0) cached = readFileSync(injectPath(), "utf8");
-  return cached;
-}
-var uploads;
-var written = 0;
-async function filesOnDisk(files) {
-  if (uploads === void 0) {
-    const root2 = mkdtempSync(join(tmpdir(), "harnessed-uploads-"));
-    uploads = root2;
-    process.once("exit", () => rmSync(root2, { recursive: true, force: true }));
-  }
-  const root = uploads;
-  return Promise.all(
-    files.map(async (file) => {
-      const dir = join(root, String(written++));
-      mkdirSync(dir);
-      const path = join(dir, basename(file.name) || "upload");
-      writeFileSync(path, new Uint8Array(await file.arrayBuffer()));
-      return path;
-    })
-  );
-}
-
-export { PAGE_API_GLOBAL, encodeSelector, filesOnDisk, injectPath, injectSource };
+export { PAGE_API_GLOBAL, encodeSelector, filesOnDisk, injectPath, injectSource } from './chunk-BYG4HMLR.js';
 //# sourceMappingURL=inject.js.map
 //# sourceMappingURL=inject.js.map

package/dist/inject.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/global-name.ts","../src/wire.ts","../src/inject.ts"],"names":["root"],"mappings":";;;;;;;;AAKO,IAAM,eAAA,GAAkB;;;ACe/B,SAAS,SAAS,KAAA,EAAiC;AACjD,EAAA,OAAO,MAAA,CAAO,SAAA,CAAU,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA,KAAM,iBAAA;AACnD;AAEA,SAAS,YAAY,KAAA,EAAyB;AAC5C,EAAA,IAAI,QAAA,CAAS,KAAK,CAAA,EAAG,OAAO,EAAE,SAAS,KAAA,CAAM,MAAA,EAAQ,KAAA,EAAO,KAAA,CAAM,KAAA,EAAM;AACxE,EAAA,IAAI,MAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,KAAA,CAAM,IAAI,WAAW,CAAA;AACtD,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,EAAM;AAC/C,IAAA,OAAO,MAAA,CAAO,WAAA;AAAA,MACZ,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,MAAM,CAAC,GAAA,EAAK,WAAA,CAAY,KAAK,CAAC,CAAC;AAAA,KACvE;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAuBO,SAAS,eAAe,QAAA,EAAkC;AAC/D,EAAA,OAAO,YAAY,QAAQ,CAAA;AAC7B;;;ACxCO,SAAS,UAAA,GAAqB;AAGnC,EAAA,IAAI,OAAO,eAAe,QAAA,EAAU,OAAO,KAAK,OAAA,CAAQ,UAAU,GAAG,kBAAkB,CAAA;AACvF,EAAA,OAAO,cAAc,IAAI,GAAA,CAAI,oBAAA,EAAsB,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AACrE;AAEA,IAAI,MAAA;AAMG,SAAS,YAAA,GAAuB;AACrC,EAAA,IAAI,WAAW,MAAA,EAAW,MAAA,GAAS,YAAA,CAAa,UAAA,IAAc,MAAM,CAAA;AACpE,EAAA,OAAO,MAAA;AACT;AAEA,IAAI,OAAA;AACJ,IAAI,OAAA,GAAU,CAAA;AAad,eAAsB,YAAY,KAAA,EAA2C;AAC3E,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAMA,QAAO,WAAA,CAAY,IAAA,CAAK,MAAA,EAAO,EAAG,oBAAoB,CAAC,CAAA;AAC7D,IAAA,OAAA,GAAUA,KAAAA;AACV,IAAA,OAAA,CAAQ,IAAA,CAAK,MAAA,EAAQ,MAAM,MAAA,CAAOA,KAAAA,EAAM,EAAE,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,MAAM,IAAA,GAAO,OAAA;AACb,EAAA,OAAO,OAAA,CAAQ,GAAA;AAAA,IACb,KAAA,CAAM,GAAA,CAAI,OAAM,IAAA,KAAQ;AACtB,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,EAAM,MAAA,CAAO,SAAS,CAAC,CAAA;AACxC,MAAA,SAAA,CAAU,GAAG,CAAA;AAEb,MAAA,MAAM,OAAO,IAAA,CAAK,GAAA,EAAK,SAAS,IAAA,CAAK,IAAI,KAAK,QAAQ,CAAA;AACtD,MAAA,aAAA,CAAc,MAAM,IAAI,UAAA,CAAW,MAAM,IAAA,CAAK,WAAA,EAAa,CAAC,CAAA;AAC5D,MAAA,OAAO,IAAA;AAAA,IACT,CAAC;AAAA,GACH;AACF","file":"inject.js","sourcesContent":["/**\n * Where the injected build installs itself on the page's `window`. A leaf\n * module with no imports, so the Node-side `inject` entry can name it without\n * pulling in the resolver and Testing Library, which only run in the page.\n */\nexport const PAGE_API_GLOBAL = '__harnessedResolve'\n","import type { Selector } from '@harnessed-ts/core'\n\n/**\n * A `Selector` as it crosses into a remote page. Everything in one is JSON-safe\n * except a RegExp — `role('button', { name: /save/i })` — which WebDriver,\n * CDP and TestCafe all serialise to `{}`. This encodes them as tagged objects\n * on the way out, and the page API decodes them on the way in.\n */\nexport interface WireRegExp {\n  $regexp: string\n  flags: string\n}\n\nexport type WireSelector = Record<string, unknown>\n\n/**\n * Not `instanceof`: a selector built in the test process and handed to a page\n * in the same JS engine (jsdom, a same-origin frame) carries the other realm's\n * RegExp, which `instanceof` does not recognise.\n */\nfunction isRegExp(value: unknown): value is RegExp {\n  return Object.prototype.toString.call(value) === '[object RegExp]'\n}\n\nfunction encodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags }\n  if (Array.isArray(value)) return value.map(encodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nfunction isWireRegExp(value: unknown): value is WireRegExp {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as WireRegExp).$regexp === 'string' &&\n    typeof (value as WireRegExp).flags === 'string'\n  )\n}\n\nfunction decodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return new RegExp(value.source, value.flags)\n  if (isWireRegExp(value)) return new RegExp(value.$regexp, value.flags)\n  if (Array.isArray(value)) return value.map(decodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, decodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nexport function encodeSelector(selector: Selector): WireSelector {\n  return encodeValue(selector) as WireSelector\n}\n\n/** Idempotent: a selector that never left the process decodes to itself. */\nexport function decodeSelector(selector: Selector | WireSelector): Selector {\n  return decodeValue(selector) as Selector\n}\n","import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n// Leaf modules only: this entry runs in the test process, where the resolver\n// and Testing Library have no business loading.\nexport { PAGE_API_GLOBAL } from './global-name'\nexport { encodeSelector } from './wire'\nexport type { WireSelector } from './wire'\nexport type { PageApi, PageApiOptions } from './page-api'\n\ndeclare const __filename: string | undefined\n\n/**\n * Absolute path to the injectable build, for drivers that inject by path\n * (TestCafe's `clientScripts`, Puppeteer's `addScriptTag`).\n */\nexport function injectPath(): string {\n  // A sibling in dist/. The CJS build has __filename; the ESM build has\n  // import.meta.url and no __filename, so each takes its own branch.\n  if (typeof __filename === 'string') return join(dirname(__filename), 'inject.global.js')\n  return fileURLToPath(new URL('./inject.global.js', import.meta.url))\n}\n\nlet cached: string | undefined\n\n/**\n * The injectable build's source, for drivers that inject by evaluating a string\n * (WebdriverIO's `execute`, Puppeteer's `evaluate`). Read once per process.\n */\nexport function injectSource(): string {\n  if (cached === undefined) cached = readFileSync(injectPath(), 'utf8')\n  return cached\n}\n\nlet uploads: string | undefined\nlet written = 0\n\n/**\n * Writes files to disk for a driver whose browser only takes file paths\n * (Puppeteer's `uploadFile`, WebDriver's file input, TestCafe's\n * `setFilesToUpload`), and returns the paths in order.\n *\n * Each file gets a directory of its own, so its name survives as the path's\n * last segment even when two files share one. The browser reads the file when\n * the page does — after the upload resolves — so nothing is deleted until the\n * process exits. What travels is the name and the bytes: the browser infers\n * `type` from the extension, and `lastModified` is the time of writing.\n */\nexport async function filesOnDisk(files: readonly File[]): Promise<string[]> {\n  if (uploads === undefined) {\n    const root = mkdtempSync(join(tmpdir(), 'harnessed-uploads-'))\n    uploads = root\n    process.once('exit', () => rmSync(root, { recursive: true, force: true }))\n  }\n  const root = uploads\n  return Promise.all(\n    files.map(async file => {\n      const dir = join(root, String(written++))\n      mkdirSync(dir)\n      // basename: a name is a name, never a path out of the directory.\n      const path = join(dir, basename(file.name) || 'upload')\n      writeFileSync(path, new Uint8Array(await file.arrayBuffer()))\n      return path\n    }),\n  )\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"inject.js"}

package/dist/webdriver-page-script.d.ts

@@ -0,0 +1,48 @@
+import type { PageApiOptions } from './page-api';
+import type { WireSelector } from './wire';
+/**
+ * What the in-page script does with the target it resolves. Reads happen in the
+ * page, in the same round-trip as the resolution: a WebDriver command costs a
+ * few milliseconds each way, and a read that first fetched an element reference
+ * and then asked about it would pay that twice.
+ */
+export type PageOp = 'frame' | 'frameNow' | 'element' | 'probe' | 'visible' | 'count' | 'texts' | 'text' | 'value' | 'attribute' | 'enabled' | 'checked' | 'selected' | 'select' | 'clear' | 'focus' | 'blur' | 'box' | 'upload';
+/**
+ * The script's answer. A page error comes back as a value rather than a thrown
+ * script error, so its name and message arrive intact — a thrown one reaches the
+ * test wrapped in protocol noise, and under WebDriver Classic is logged as a
+ * driver failure as well.
+ */
+export type PageReply = {
+    kind: 'missing';
+} | {
+    kind: 'ok';
+    value: unknown;
+    url: string;
+} | {
+    kind: 'error';
+    name: string;
+    message: string;
+};
+/** Raised in the page by the shared resolver: strictness, index and frame rules. */
+export declare class PageError extends Error {
+    constructor(name: string, message: string);
+}
+/** The shared resolver's refusal of a frame it cannot enter. Never "not there yet". */
+export declare function isFrameEntryError(error: unknown): boolean;
+/**
+ * An element as WebDriver returns it from a script, before the driver's client
+ * wraps it (WebdriverIO's `$()`; selenium-webdriver hands back a `WebElement`
+ * already).
+ */
+export type ElementRef = {
+    'element-6066-11e4-a52e-4f735466cecf': string;
+};
+/**
+ * Runs IN THE PAGE, serialised with `Function.prototype.toString`, so it must
+ * close over nothing: every input arrives as an argument. Elements are
+ * only ever returned as object properties, each at most once — WebDriver BiDi
+ * serialises an element repeated in a result, or one inside an array, as `{}`.
+ */
+export declare function pageScript(name: string, op: PageOp, scope: WireSelector[], selector: WireSelector, options: PageApiOptions, arg: string | null): Promise<PageReply>;
+//# sourceMappingURL=webdriver-page-script.d.ts.map

package/dist/webdriver-page-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webdriver-page-script.d.ts","sourceRoot":"","sources":["../src/webdriver-page-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GACd,OAAO,GACP,UAAU,GACV,SAAS,GACT,OAAO,GACP,SAAS,GACT,OAAO,GACP,OAAO,GACP,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,SAAS,GACT,UAAU,GACV,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,KAAK,GACL,QAAQ,CAAA;AAEZ;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,oFAAoF;AACpF,qBAAa,SAAU,SAAQ,KAAK;gBACtB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1C;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,qCAAqC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1E;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,OAAO,CAAC,SAAS,CAAC,CAyJpB"}

package/dist/webdriver.cjs

@@ -0,0 +1,272 @@
+'use strict';
+
+var core = require('@harnessed-ts/core');
+var fs = require('fs');
+require('os');
+var path = require('path');
+var url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/webdriver.ts
+
+// src/global-name.ts
+var PAGE_API_GLOBAL = "__harnessedResolve";
+
+// src/wire.ts
+function isRegExp(value) {
+  return Object.prototype.toString.call(value) === "[object RegExp]";
+}
+function encodeValue(value) {
+  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags };
+  if (Array.isArray(value)) return value.map(encodeValue);
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)])
+    );
+  }
+  return value;
+}
+function encodeSelector(selector) {
+  return encodeValue(selector);
+}
+
+// src/inject.ts
+function injectPath() {
+  if (typeof __filename === "string") return path.join(path.dirname(__filename), "inject.global.js");
+  return url.fileURLToPath(new URL("./inject.global.js", (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('webdriver.cjs', document.baseURI).href))));
+}
+var cached;
+function injectSource() {
+  if (cached === void 0) cached = fs.readFileSync(injectPath(), "utf8");
+  return cached;
+}
+
+// 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) {
+  core.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: core.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 core.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();
+  }
+}
+
+exports.FrameAbsent = FrameAbsent;
+exports.PageError = PageError;
+exports.callPage = callPage;
+exports.classicScript = classicScript;
+exports.isFrameEntryError = isFrameEntryError;
+exports.pageScript = pageScript;
+exports.walk = walk;
+//# sourceMappingURL=webdriver.cjs.map
+//# sourceMappingURL=webdriver.cjs.map

package/dist/webdriver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/global-name.ts","../src/wire.ts","../src/inject.ts","../src/webdriver-page-script.ts","../src/webdriver.ts"],"names":["join","dirname","fileURLToPath","readFileSync","name","checkTestIds","getConfig","reviveStrictViolation"],"mappings":"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","file":"webdriver.cjs","sourcesContent":["/**\n * Where the injected build installs itself on the page's `window`. A leaf\n * module with no imports, so the Node-side `inject` entry can name it without\n * pulling in the resolver and Testing Library, which only run in the page.\n */\nexport const PAGE_API_GLOBAL = '__harnessedResolve'\n","import type { Selector } from '@harnessed-ts/core'\n\n/**\n * A `Selector` as it crosses into a remote page. Everything in one is JSON-safe\n * except a RegExp — `role('button', { name: /save/i })` — which WebDriver,\n * CDP and TestCafe all serialise to `{}`. This encodes them as tagged objects\n * on the way out, and the page API decodes them on the way in.\n */\nexport interface WireRegExp {\n  $regexp: string\n  flags: string\n}\n\nexport type WireSelector = Record<string, unknown>\n\n/**\n * Not `instanceof`: a selector built in the test process and handed to a page\n * in the same JS engine (jsdom, a same-origin frame) carries the other realm's\n * RegExp, which `instanceof` does not recognise.\n */\nfunction isRegExp(value: unknown): value is RegExp {\n  return Object.prototype.toString.call(value) === '[object RegExp]'\n}\n\nfunction encodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return { $regexp: value.source, flags: value.flags }\n  if (Array.isArray(value)) return value.map(encodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, encodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nfunction isWireRegExp(value: unknown): value is WireRegExp {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as WireRegExp).$regexp === 'string' &&\n    typeof (value as WireRegExp).flags === 'string'\n  )\n}\n\nfunction decodeValue(value: unknown): unknown {\n  if (isRegExp(value)) return new RegExp(value.source, value.flags)\n  if (isWireRegExp(value)) return new RegExp(value.$regexp, value.flags)\n  if (Array.isArray(value)) return value.map(decodeValue)\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, inner]) => [key, decodeValue(inner)]),\n    )\n  }\n  return value\n}\n\nexport function encodeSelector(selector: Selector): WireSelector {\n  return encodeValue(selector) as WireSelector\n}\n\n/** Idempotent: a selector that never left the process decodes to itself. */\nexport function decodeSelector(selector: Selector | WireSelector): Selector {\n  return decodeValue(selector) as Selector\n}\n","import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n// Leaf modules only: this entry runs in the test process, where the resolver\n// and Testing Library have no business loading.\nexport { PAGE_API_GLOBAL } from './global-name'\nexport { encodeSelector } from './wire'\nexport type { WireSelector } from './wire'\nexport type { PageApi, PageApiOptions } from './page-api'\n\ndeclare const __filename: string | undefined\n\n/**\n * Absolute path to the injectable build, for drivers that inject by path\n * (TestCafe's `clientScripts`, Puppeteer's `addScriptTag`).\n */\nexport function injectPath(): string {\n  // A sibling in dist/. The CJS build has __filename; the ESM build has\n  // import.meta.url and no __filename, so each takes its own branch.\n  if (typeof __filename === 'string') return join(dirname(__filename), 'inject.global.js')\n  return fileURLToPath(new URL('./inject.global.js', import.meta.url))\n}\n\nlet cached: string | undefined\n\n/**\n * The injectable build's source, for drivers that inject by evaluating a string\n * (WebdriverIO's `execute`, Puppeteer's `evaluate`). Read once per process.\n */\nexport function injectSource(): string {\n  if (cached === undefined) cached = readFileSync(injectPath(), 'utf8')\n  return cached\n}\n\nlet uploads: string | undefined\nlet written = 0\n\n/**\n * Writes files to disk for a driver whose browser only takes file paths\n * (Puppeteer's `uploadFile`, WebDriver's file input, TestCafe's\n * `setFilesToUpload`), and returns the paths in order.\n *\n * Each file gets a directory of its own, so its name survives as the path's\n * last segment even when two files share one. The browser reads the file when\n * the page does — after the upload resolves — so nothing is deleted until the\n * process exits. What travels is the name and the bytes: the browser infers\n * `type` from the extension, and `lastModified` is the time of writing.\n */\nexport async function filesOnDisk(files: readonly File[]): Promise<string[]> {\n  if (uploads === undefined) {\n    const root = mkdtempSync(join(tmpdir(), 'harnessed-uploads-'))\n    uploads = root\n    process.once('exit', () => rmSync(root, { recursive: true, force: true }))\n  }\n  const root = uploads\n  return Promise.all(\n    files.map(async file => {\n      const dir = join(root, String(written++))\n      mkdirSync(dir)\n      // basename: a name is a name, never a path out of the directory.\n      const path = join(dir, basename(file.name) || 'upload')\n      writeFileSync(path, new Uint8Array(await file.arrayBuffer()))\n      return path\n    }),\n  )\n}\n","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/webdriver.d.ts

@@ -0,0 +1,96 @@
+import type { Selector } from '@harnessed-ts/core';
+import type { Point } from './box';
+import { pageScript } from './webdriver-page-script';
+import type { ElementRef, PageOp } from './webdriver-page-script';
+export { isFrameEntryError, PageError, pageScript } from './webdriver-page-script';
+export type { ElementRef, PageOp, PageReply } from './webdriver-page-script';
+export type { Point } from './box';
+/** What `pageScript` takes, in order: what every `WebDriverLike.run` passes it. */
+export type PageScriptArgs = Parameters<typeof pageScript>;
+/**
+ * A document a WebDriver client is working in: the top-level one, or a frame's
+ * a walk entered. A driver extends it with whatever it needs to address that
+ * document (a BiDi browsing context, say).
+ */
+export interface WebDriverSite {
+    /** The top-level document, whose URL is the page's URL. */
+    readonly top: boolean;
+    /** Where this document's viewport starts in the top-level one, in CSS pixels. */
+    readonly origin: Point;
+}
+/**
+ * What the shared WebDriver code needs from a client — WebdriverIO,
+ * selenium-webdriver under Nightwatch — and nothing more: running a script in a
+ * document, and crossing into a frame. `S` is the client's site, `E` its element.
+ */
+export interface WebDriverLike<S extends WebDriverSite, E> {
+    /** The top-level document. */
+    top(): S;
+    /**
+     * Runs `pageScript` in the site's document with these arguments and returns
+     * its reply. Under WebDriver Classic, `classicScript()` is the body to send.
+     */
+    run(site: S, args: PageScriptArgs): Promise<unknown>;
+    /** Evaluates the resolver's injectable source in the site's document. */
+    inject(site: S, source: string): Promise<void>;
+    /** An element the page script returned, as the client's own element. */
+    element(site: S, ref: ElementRef): Promise<E>;
+    /**
+     * Enters `iframe`, an element of `site`'s document, and returns the site for
+     * the frame's document, at `origin` in the top-level viewport.
+     */
+    enterFrame(site: S, iframe: E, origin: Point): Promise<S>;
+    /**
+     * Undoes what entering frames changed in the session — under Classic, switches
+     * back to the top-level document. Called once after a walk that entered any.
+     */
+    leaveFrames(): Promise<void>;
+    /** Hears the top-level document's URL, which every call there brings back. */
+    sawUrl?(url: string): void;
+}
+/**
+ * The page script as a classic Execute Script body, which awaits the promise
+ * the script returns.
+ */
+export declare function classicScript(): string;
+/**
+ * Runs one operation of the shared resolver in a document, injecting the
+ * resolver first if the document does not have it yet.
+ *
+ * The presence check rides along with the call itself, so a document that
+ * already has the resolver pays one round-trip, not two. Injecting happens once
+ * per document: navigation replaces the window, and the resolver with it.
+ */
+export declare function callPage<S extends WebDriverSite, E>(driver: WebDriverLike<S, E>, site: S, op: PageOp, scope: readonly Selector[], selector: Selector, timeout: number, arg?: string | null): Promise<unknown>;
+/** A non-waiting walk found a frame link that is not on screen. */
+export declare class FrameAbsent extends Error {
+    name: string;
+}
+/** What the page reports about an iframe a walk is about to enter. */
+export interface FrameInfo {
+    /** Whether the iframe is visible by layout in its own document. */
+    readonly visible: boolean;
+}
+export interface WalkOptions<E> {
+    /** Wait for each frame link, or answer at once by throwing FrameAbsent. */
+    waiting: boolean;
+    /** The budget for every hop and the operation together. */
+    timeout: number;
+    /** Called with each iframe element, from its own document, before entering it. */
+    onFrame?: (iframe: E, info: FrameInfo) => Promise<void>;
+}
+/**
+ * Walks the scope chain's frame links, entering each frame, then runs the
+ * operation in the innermost document with the links that remain.
+ *
+ * A WebDriver element belongs to one document: an element inside a frame cannot
+ * be acted on from the top-level one, even where the page's own script could
+ * reach it. So the shared resolver runs once per document — up to the iframe,
+ * then inside it — and WebDriver does the crossing. That is also why
+ * cross-origin frames work here, where an in-page resolver cannot enter them.
+ *
+ * Whatever entering changed in the session is undone afterwards, whatever
+ * happened (`leaveFrames`).
+ */
+export declare function walk<S extends WebDriverSite, E, T>(driver: WebDriverLike<S, E>, scope: readonly Selector[], options: WalkOptions<E>, operation: (site: S, scope: Selector[], remaining: () => number) => Promise<T>): Promise<T>;
+//# sourceMappingURL=webdriver.d.ts.map

package/dist/webdriver.d.ts.map

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

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harnessed-ts/resolve",
-  "version": "0.6.0",
+  "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",
@@ -41,6 +41,11 @@
       "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"
   },
@@ -54,7 +59,7 @@
     "node": ">=22.12.0"
   },
   "dependencies": {
-    "@harnessed-ts/core": "^0.6.0"
+    "@harnessed-ts/core": "^0.7.0"
   },
   "peerDependencies": {
     "@testing-library/dom": ">=10"
@@ -65,7 +70,7 @@
   "devDependencies": {
     "@testing-library/dom": "^10.4.2",
     "@types/jsdom": "^30.0.0",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.5",
     "jsdom": "^30.1.1",
     "vitest": "^5.0.3"
   },