@harnessed-ts/resolve 0.0.0-stage → 0.7.0

package/dist/index.cjs

@@ -0,0 +1,315 @@
+'use strict';
+
+var core = require('@harnessed-ts/core');
+var dom = require('@testing-library/dom');
+
+// src/resolve.ts
+var syncTestIdAttribute = core.testIdSync(
+  (testIdAttribute) => dom.configure({ testIdAttribute })
+);
+function queryAllByPresence(container, css) {
+  return [...container.querySelectorAll(css)];
+}
+var [, , , findAllByPresence] = dom.buildQueries(
+  queryAllByPresence,
+  (_container, css) => `Found multiple elements by: ${css}`,
+  (_container, css) => `Unable to find an element by: ${css}`
+);
+function presenceOf(selector) {
+  return core.testIdPresenceSelector(core.getConfig().testIdAttribute, selector.testId);
+}
+function queryAll(root, selector) {
+  syncTestIdAttribute();
+  const scoped = dom.within(root);
+  switch (selector.type) {
+    case "role":
+      return scoped.queryAllByRole(selector.role, selector.options);
+    case "label":
+      return scoped.queryAllByLabelText(selector.text);
+    case "testId": {
+      const css = presenceOf(selector);
+      return css === void 0 ? scoped.queryAllByTestId(selector.testId) : queryAllByPresence(root, css);
+    }
+    case "text":
+      return scoped.queryAllByText(selector.text);
+    case "placeholder":
+      return scoped.queryAllByPlaceholderText(selector.text);
+  }
+}
+async function findOne(root, scope, selector, timeout) {
+  syncTestIdAttribute();
+  const immediate = queryAll(root, selector);
+  const resolved = immediate.length > 0 ? immediate : await findAll(root, selector, timeout);
+  return pick(resolved, scope, selector);
+}
+function pick(resolved, scope, selector) {
+  if (selector.nth !== void 0) {
+    const found = resolved[selector.nth];
+    if (found === void 0) {
+      throw core.indexOutOfRange(selector.nth, resolved.length, scope, selector);
+    }
+    return found;
+  }
+  if (resolved.length > 1) throw core.strictViolation(resolved.length, scope, selector);
+  return resolved[0];
+}
+async function findAll(root, selector, timeout) {
+  syncTestIdAttribute();
+  const scoped = dom.within(root);
+  const options = { timeout: core.timeoutFor(timeout) };
+  switch (selector.type) {
+    case "role":
+      return scoped.findAllByRole(selector.role, selector.options, options);
+    case "label":
+      return scoped.findAllByLabelText(selector.text, void 0, options);
+    case "testId": {
+      const css = presenceOf(selector);
+      return css === void 0 ? scoped.findAllByTestId(selector.testId, void 0, options) : findAllByPresence(root, css, void 0, options);
+    }
+    case "text":
+      return scoped.findAllByText(selector.text, void 0, options);
+    case "placeholder":
+      return scoped.findAllByPlaceholderText(selector.text, void 0, options);
+  }
+}
+async function resolveScope(container, scope, timeout) {
+  let current = container;
+  for (const [index, step] of scope.entries()) {
+    const path = scope.slice(0, index);
+    const found = await findOne(current, path, step, timeout);
+    current = step.frame === true ? frameBody(found, path, step) : found;
+  }
+  return current;
+}
+var FrameEntryError = class extends Error {
+  name = "FrameEntryError";
+};
+function frameBody(element, scope, selector) {
+  if (element.localName !== "iframe") {
+    throw new FrameEntryError(
+      `harnessed: ${core.describeScope(scope, selector)} is marked as a frame but is a <${element.localName}>, not an <iframe>.`
+    );
+  }
+  const body = element.contentDocument?.body;
+  if (body == null) {
+    throw new FrameEntryError(
+      `harnessed: ${core.describeScope(scope, selector)} 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 body;
+}
+async function resolveOne(container, scope, selector, timeout) {
+  const root = await resolveScope(container, scope, timeout);
+  return findOne(root, scope, selector, timeout);
+}
+async function countAll(container, scope, selector, timeout) {
+  let root;
+  try {
+    root = await resolveScope(container, scope, timeout);
+  } catch (error) {
+    if (error instanceof FrameEntryError) throw error;
+    return 0;
+  }
+  const matches = queryAll(root, selector);
+  if (selector.nth === void 0) return matches.length;
+  return matches[selector.nth] === void 0 ? 0 : 1;
+}
+function resolveScopeNow(container, scope) {
+  let current = container;
+  for (const [index, step] of scope.entries()) {
+    const path = scope.slice(0, index);
+    const matches = queryAll(current, step);
+    if (matches.length === 0) return null;
+    const found = pick(matches, path, step);
+    current = step.frame === true ? frameBody(found, path, step) : found;
+  }
+  return current;
+}
+function resolveOneNow(container, scope, selector) {
+  const root = resolveScopeNow(container, scope);
+  if (root === null) return null;
+  const matches = queryAll(root, selector);
+  if (matches.length === 0) return null;
+  return pick(matches, scope, selector);
+}
+function resolveAllNow(container, scope, selector) {
+  let root;
+  try {
+    root = resolveScopeNow(container, scope);
+  } catch (error) {
+    if (error instanceof FrameEntryError) throw error;
+    return [];
+  }
+  if (root === null) return [];
+  const matches = queryAll(root, selector);
+  if (selector.nth === void 0) return matches;
+  const found = matches[selector.nth];
+  return found === void 0 ? [] : [found];
+}
+async function resolveAll(container, scope, selector, timeout) {
+  return queryAll(await resolveScope(container, scope, timeout), selector);
+}
+
+// src/visible.ts
+function isVisibleInLayout(element, home) {
+  if (!isVisibleInOwnDocument(element)) return false;
+  const document = element.ownerDocument;
+  if (document === home) return true;
+  const frame = document.defaultView?.frameElement;
+  return frame == null || isVisibleInLayout(frame, home);
+}
+function isVisibleInOwnDocument(element) {
+  const view = element.ownerDocument.defaultView;
+  if (view == null) return false;
+  const style = view.getComputedStyle(element);
+  if (style.display === "contents") {
+    return [...element.children].some((child) => isVisibleInOwnDocument(child));
+  }
+  if (style.visibility !== "visible") return false;
+  const box = element.getBoundingClientRect();
+  return box.width > 0 && box.height > 0;
+}
+
+// src/box.ts
+function boxInOwnDocument(element) {
+  if (element.getClientRects().length === 0) return null;
+  const { x, y, width, height } = element.getBoundingClientRect();
+  return { x, y, width, height };
+}
+function frameOrigin(iframe) {
+  const { x, y } = iframe.getBoundingClientRect();
+  const style = iframe.ownerDocument.defaultView?.getComputedStyle(iframe);
+  const px = (value) => Number.parseFloat(value ?? "") || 0;
+  return {
+    x: x + px(style?.borderLeftWidth) + px(style?.paddingLeft),
+    y: y + px(style?.borderTopWidth) + px(style?.paddingTop)
+  };
+}
+function boundingBoxOf(element, home) {
+  const box = boxInOwnDocument(element);
+  if (box === null) return { x: 0, y: 0, width: 0, height: 0 };
+  let document = element.ownerDocument;
+  while (document !== home) {
+    const frame = document.defaultView?.frameElement;
+    if (frame == null) break;
+    const origin = frameOrigin(frame);
+    box.x += origin.x;
+    box.y += origin.y;
+    document = frame.ownerDocument;
+  }
+  return box;
+}
+
+// src/files.ts
+function fileInputOf(element) {
+  const target = element.localName === "label" ? element.control : element;
+  if (target === null) return "<label> with no control";
+  if (target.localName !== "input") return `<${target.localName}>`;
+  const input = target;
+  return input.type === "file" ? input : `<input type="${input.type}">`;
+}
+
+// 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 isWireRegExp(value) {
+  return typeof value === "object" && value !== null && typeof value.$regexp === "string" && typeof value.flags === "string";
+}
+function decodeValue(value) {
+  if (isRegExp(value)) return new RegExp(value.source, value.flags);
+  if (isWireRegExp(value)) return new RegExp(value.$regexp, value.flags);
+  if (Array.isArray(value)) return value.map(decodeValue);
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, inner]) => [key, decodeValue(inner)])
+    );
+  }
+  return value;
+}
+function encodeSelector(selector) {
+  return encodeValue(selector);
+}
+function decodeSelector(selector) {
+  return decodeValue(selector);
+}
+
+// src/page-api.ts
+function createPageApi(document) {
+  const start = (root) => root ?? document.body;
+  const apply = (options) => core.configure({ testIdAttribute: options.testIdAttribute });
+  const decode = (scope, selector) => [
+    scope.map(decodeSelector),
+    decodeSelector(selector)
+  ];
+  return {
+    async count(root, scope, selector, options) {
+      apply(options);
+      const [steps, target] = decode(scope, selector);
+      return countAll(start(root), steps, target, options.timeout);
+    },
+    async one(root, scope, selector, options) {
+      apply(options);
+      const [steps, target] = decode(scope, selector);
+      return resolveOne(start(root), steps, target, options.timeout);
+    },
+    async all(root, scope, selector, options) {
+      apply(options);
+      const [steps, target] = decode(scope, selector);
+      return resolveAll(start(root), steps, target, options.timeout);
+    },
+    oneNow(root, scope, selector, options) {
+      apply(options);
+      const [steps, target] = decode(scope, selector);
+      return resolveOneNow(start(root), steps, target);
+    },
+    allNow(root, scope, selector, options) {
+      apply(options);
+      const [steps, target] = decode(scope, selector);
+      return resolveAllNow(start(root), steps, target);
+    },
+    visible(element) {
+      return isVisibleInLayout(element, element.ownerDocument);
+    },
+    box: boxInOwnDocument,
+    origin: frameOrigin,
+    fileTarget(element) {
+      const input = fileInputOf(element);
+      return typeof input === "string" ? input : { multiple: input.multiple };
+    }
+  };
+}
+
+exports.FrameEntryError = FrameEntryError;
+exports.PAGE_API_GLOBAL = PAGE_API_GLOBAL;
+exports.boundingBoxOf = boundingBoxOf;
+exports.boxInOwnDocument = boxInOwnDocument;
+exports.countAll = countAll;
+exports.createPageApi = createPageApi;
+exports.decodeSelector = decodeSelector;
+exports.encodeSelector = encodeSelector;
+exports.fileInputOf = fileInputOf;
+exports.frameOrigin = frameOrigin;
+exports.isVisibleInLayout = isVisibleInLayout;
+exports.queryAll = queryAll;
+exports.resolveAll = resolveAll;
+exports.resolveAllNow = resolveAllNow;
+exports.resolveOne = resolveOne;
+exports.resolveOneNow = resolveOneNow;
+exports.resolveScope = resolveScope;
+exports.resolveScopeNow = resolveScopeNow;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve.ts","../src/visible.ts","../src/box.ts","../src/files.ts","../src/global-name.ts","../src/wire.ts","../src/page-api.ts"],"names":["testIdSync","configureTestingLibrary","buildQueries","testIdPresenceSelector","getConfig","within","indexOutOfRange","strictViolation","timeoutFor","describeScope","configure"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n  describeScope,\n  getConfig,\n  indexOutOfRange,\n  strictViolation,\n  testIdPresenceSelector,\n  testIdSync,\n  timeoutFor,\n} from '@harnessed-ts/core'\nimport type { Selector } from '@harnessed-ts/core'\nimport { buildQueries, configure as configureTestingLibrary, within } from '@testing-library/dom'\nimport type { ByRoleMatcher } from '@testing-library/dom'\n\n/** `Selector` keeps `role` a plain string so it stays driver-agnostic; each driver\n *  casts it to its own role union at the boundary. */\ntype RoleName = ByRoleMatcher\n\nconst syncTestIdAttribute = testIdSync(testIdAttribute =>\n  configureTestingLibrary({ testIdAttribute }),\n)\n\n/** Descendants carrying a presence-style test id: `[data-test-x]`, any value. */\nfunction queryAllByPresence(container: HTMLElement, css: string): HTMLElement[] {\n  return [...container.querySelectorAll<HTMLElement>(css)]\n}\n\n// Built the way Testing Library builds its own queries, so a presence test id\n// waits, and reports \"Unable to find …\" when it gives up, exactly as `*ByTestId` does.\nconst [, , , findAllByPresence] = buildQueries(\n  queryAllByPresence,\n  (_container, css: string) => `Found multiple elements by: ${css}`,\n  (_container, css: string) => `Unable to find an element by: ${css}`,\n)\n\n/** The presence selector for a test id under a `data-test-*` config, if that is the mode. */\nfunction presenceOf(selector: Selector & { type: 'testId' }): string | undefined {\n  return testIdPresenceSelector(getConfig().testIdAttribute, selector.testId)\n}\n\n/** Every match for one selector, without waiting. Zero is an answer. */\nexport function queryAll(root: HTMLElement, selector: Selector): HTMLElement[] {\n  syncTestIdAttribute()\n  const scoped = within(root)\n  switch (selector.type) {\n    case 'role':\n      return scoped.queryAllByRole(selector.role as RoleName, selector.options)\n    case 'label':\n      return scoped.queryAllByLabelText(selector.text)\n    case 'testId': {\n      const css = presenceOf(selector)\n      return css === undefined\n        ? scoped.queryAllByTestId(selector.testId)\n        : queryAllByPresence(root, css)\n    }\n    case 'text':\n      return scoped.queryAllByText(selector.text)\n    case 'placeholder':\n      return scoped.queryAllByPlaceholderText(selector.text)\n  }\n}\n\n/**\n * One match, waiting for it to appear. Strict: several matches is an error.\n *\n * The non-waiting query runs first. Testing Library's `findBy*` is\n * `waitFor(getBy*)`, so a \"found multiple elements\" error is retried for the full\n * timeout before surfacing — but more than one match never becomes one by\n * waiting, and Playwright rejects at once. Checking up front keeps the two\n * drivers in step and turns a timeout into an immediate, readable failure.\n *\n * The check is applied to the waited result too. Otherwise the guarantee would\n * hold only for nodes that happened to be on screen already, and a target that\n * renders late as two nodes would still sit out the whole timeout.\n */\nasync function findOne(\n  root: HTMLElement,\n  scope: readonly Selector[],\n  selector: Selector,\n  timeout?: number,\n): Promise<HTMLElement> {\n  syncTestIdAttribute()\n\n  const immediate = queryAll(root, selector)\n  const resolved = immediate.length > 0 ? immediate : await findAll(root, selector, timeout)\n  return pick(resolved, scope, selector)\n}\n\n/** The one node a strict operation takes from a set of matches. */\nfunction pick(\n  resolved: readonly HTMLElement[],\n  scope: readonly Selector[],\n  selector: Selector,\n): HTMLElement {\n  if (selector.nth !== undefined) {\n    const found = resolved[selector.nth]\n    if (found === undefined) {\n      throw indexOutOfRange(selector.nth, resolved.length, scope, selector)\n    }\n    return found\n  }\n\n  if (resolved.length > 1) throw strictViolation(resolved.length, scope, selector)\n  return resolved[0]!\n}\n\nasync function findAll(\n  root: HTMLElement,\n  selector: Selector,\n  timeout?: number,\n): Promise<HTMLElement[]> {\n  syncTestIdAttribute()\n  const scoped = within(root)\n  const options = { timeout: timeoutFor(timeout) }\n  switch (selector.type) {\n    case 'role':\n      return scoped.findAllByRole(selector.role as RoleName, selector.options, options)\n    case 'label':\n      return scoped.findAllByLabelText(selector.text, undefined, options)\n    case 'testId': {\n      const css = presenceOf(selector)\n      return css === undefined\n        ? scoped.findAllByTestId(selector.testId, undefined, options)\n        : findAllByPresence(root, css, undefined, options)\n    }\n    case 'text':\n      return scoped.findAllByText(selector.text, undefined, options)\n    case 'placeholder':\n      return scoped.findAllByPlaceholderText(selector.text, undefined, options)\n  }\n}\n\n/**\n * Walks the scope chain down to the element the final selector is queried within.\n * Waiting is correct here: a container that has not rendered yet is not the same\n * thing as a target that is absent.\n */\nexport async function resolveScope(\n  container: HTMLElement,\n  scope: readonly Selector[],\n  timeout?: number,\n): Promise<HTMLElement> {\n  let current = container\n  for (const [index, step] of scope.entries()) {\n    // Each link is reported with the path that reached it, so an ambiguous\n    // container names the container rather than the leaf you asked for.\n    const path = scope.slice(0, index)\n    const found = await findOne(current, path, step, timeout)\n    current = step.frame === true ? frameBody(found, path, step) : found\n  }\n  return current\n}\n\n/** A frame link that cannot be entered — a wiring mistake, never \"not rendered yet\". */\nexport class FrameEntryError extends Error {\n  override name = 'FrameEntryError'\n}\n\n/**\n * The body a frame link's children are queried within. Only a same-origin frame\n * exposes one — a cross-origin document is unreachable from script by design, and\n * no amount of waiting changes that, so this refuses at once.\n */\nfunction frameBody(\n  element: HTMLElement,\n  scope: readonly Selector[],\n  selector: Selector,\n): HTMLElement {\n  // localName, not instanceof: a frame nested in a frame belongs to another realm.\n  if (element.localName !== 'iframe') {\n    throw new FrameEntryError(\n      `harnessed: ${describeScope(scope, selector)} is marked as a frame but is a <${element.localName}>, not an <iframe>.`,\n    )\n  }\n  const body = (element as HTMLIFrameElement).contentDocument?.body\n  if (body == null) {\n    throw new FrameEntryError(\n      `harnessed: ${describeScope(scope, selector)} has no reachable document: it is ` +\n        `cross-origin, or its document has no body. The dom driver enters same-origin ` +\n        `frames only; drive a cross-origin one with a browser driver.`,\n    )\n  }\n  return body\n}\n\n/** The single node a strict operation acts on. */\nexport async function resolveOne(\n  container: HTMLElement,\n  scope: readonly Selector[],\n  selector: Selector,\n  timeout?: number,\n): Promise<HTMLElement> {\n  const root = await resolveScope(container, scope, timeout)\n  // The errors already carry the scope path, so there is nothing to wrap.\n  return findOne(root, scope, selector, timeout)\n}\n\n/**\n * How many nodes match. The scope chain still waits, but the final count uses the\n * non-waiting query so that zero answers immediately rather than throwing after a\n * retry timeout. This is the behaviour Playwright already had.\n */\nexport async function countAll(\n  container: HTMLElement,\n  scope: readonly Selector[],\n  selector: Selector,\n  timeout?: number,\n): Promise<number> {\n  let root: HTMLElement\n  try {\n    root = await resolveScope(container, scope, timeout)\n  } catch (error) {\n    if (error instanceof FrameEntryError) throw error\n    // The scope itself is not on screen, so nothing inside it can be either.\n    return 0\n  }\n  const matches = queryAll(root, selector)\n  if (selector.nth === undefined) return matches.length\n  return matches[selector.nth] === undefined ? 0 : 1\n}\n\n// --- without waiting ------------------------------------------------------\n//\n// For a driver whose own runtime does the retrying — TestCafe's Selector, a\n// remote driver polling from Node — every lookup has to answer at once. These\n// apply exactly the same strictness, index, and frame rules as the waiting\n// forms above: anything those reject at once, these throw. The one difference\n// is that \"nothing matches yet\" is `null` instead of a wait.\n\n/** The scope chain's innermost element now, or `null` if a link is not on screen. */\nexport function resolveScopeNow(\n  container: HTMLElement,\n  scope: readonly Selector[],\n): HTMLElement | null {\n  let current = container\n  for (const [index, step] of scope.entries()) {\n    const path = scope.slice(0, index)\n    const matches = queryAll(current, step)\n    if (matches.length === 0) return null\n    const found = pick(matches, path, step)\n    current = step.frame === true ? frameBody(found, path, step) : found\n  }\n  return current\n}\n\n/** The single node a strict operation acts on now, or `null` if it is not on screen. */\nexport function resolveOneNow(\n  container: HTMLElement,\n  scope: readonly Selector[],\n  selector: Selector,\n): HTMLElement | null {\n  const root = resolveScopeNow(container, scope)\n  if (root === null) return null\n  const matches = queryAll(root, selector)\n  if (matches.length === 0) return null\n  return pick(matches, scope, selector)\n}\n\n/**\n * Every match now, agreeing with `countAll` on every scope it cannot resolve:\n * an absent or ambiguous scope is an empty list, and only a frame that cannot\n * be entered throws.\n */\nexport function resolveAllNow(\n  container: HTMLElement,\n  scope: readonly Selector[],\n  selector: Selector,\n): HTMLElement[] {\n  let root: HTMLElement | null\n  try {\n    root = resolveScopeNow(container, scope)\n  } catch (error) {\n    if (error instanceof FrameEntryError) throw error\n    return []\n  }\n  if (root === null) return []\n  const matches = queryAll(root, selector)\n  if (selector.nth === undefined) return matches\n  const found = matches[selector.nth]\n  return found === undefined ? [] : [found]\n}\n\n/**\n * Every match for a list operation: the scope waits, the list does not, and\n * `nth` is ignored — each result is addressed by its own index afterwards. The\n * one definition of \"the list\" for in-process and injected drivers alike.\n */\nexport async function resolveAll(\n  container: HTMLElement,\n  scope: readonly Selector[],\n  selector: Selector,\n  timeout?: number,\n): Promise<HTMLElement[]> {\n  return queryAll(await resolveScope(container, scope, timeout), selector)\n}\n","/**\n * Whether an element is visible by layout — Playwright's definition, for drivers\n * that run in a real browser beside the page (Vitest browser mode, Ember, Cypress).\n * jsdom computes no layout, so the dom driver cannot use this and reads computed\n * style instead.\n *\n * Visible means a non-empty box that `visibility` does not hide. `display: none`\n * anywhere above gives an empty box, so it needs no check of its own. Opacity\n * does not count: a transparent box is still there to click, and Playwright\n * reports it visible.\n *\n * Inside a frame, the iframe has to be visible too — a hidden frame hides its\n * content. The walk crosses frames up to `home` (by default, every reachable\n * one), so a driver passes its own document to stop at the frames its scope\n * actually entered.\n */\nexport function isVisibleInLayout(element: Element, home?: Document): boolean {\n  if (!isVisibleInOwnDocument(element)) return false\n  const document = element.ownerDocument\n  if (document === home) return true\n  // Null at the top, and for a cross-origin parent, which script cannot see into.\n  const frame = document.defaultView?.frameElement\n  return frame == null || isVisibleInLayout(frame, home)\n}\n\nfunction isVisibleInOwnDocument(element: Element): boolean {\n  const view = element.ownerDocument.defaultView\n  // A node with no window is detached from any rendering.\n  if (view == null) return false\n  const style = view.getComputedStyle(element)\n  // `display: contents` draws no box of its own, so it is as visible as what it\n  // contains.\n  if (style.display === 'contents') {\n    return [...element.children].some(child => isVisibleInOwnDocument(child))\n  }\n  if (style.visibility !== 'visible') return false\n  const box = element.getBoundingClientRect()\n  return box.width > 0 && box.height > 0\n}\n","import type { BoundingBox } from '@harnessed-ts/core'\n\n/** A point in a document's viewport, in CSS pixels. */\nexport interface Point {\n  x: number\n  y: number\n}\n\n/**\n * An element's border box in its own document's viewport, or `null` when it\n * renders no box at all (`display: none`, or anything inside it). Every driver\n * reads `null` as all zeros, which is what Playwright and Puppeteer — whose\n * native boxes are `null` there — are normalised to.\n */\nexport function boxInOwnDocument(element: Element): BoundingBox | null {\n  if (element.getClientRects().length === 0) return null\n  const { x, y, width, height } = element.getBoundingClientRect()\n  return { x, y, width, height }\n}\n\n/**\n * Where an iframe's document is drawn, in the iframe's own document: the corner\n * of its content box, inside its border and padding. The same offset Playwright\n * and Puppeteer add when they report a framed element's box.\n */\nexport function frameOrigin(iframe: Element): Point {\n  const { x, y } = iframe.getBoundingClientRect()\n  const style = iframe.ownerDocument.defaultView?.getComputedStyle(iframe)\n  const px = (value: string | undefined): number => Number.parseFloat(value ?? '') || 0\n  return {\n    x: x + px(style?.borderLeftWidth) + px(style?.paddingLeft),\n    y: y + px(style?.borderTopWidth) + px(style?.paddingTop),\n  }\n}\n\n/**\n * An element's box relative to the viewport of `home` — the document the\n * driver drives — adding the origin of every same-origin frame crossed on the\n * way up. For drivers that resolve inside the page; under jsdom everything is\n * zeros, because jsdom computes no layout.\n */\nexport function boundingBoxOf(element: Element, home?: Document): BoundingBox {\n  const box = boxInOwnDocument(element)\n  if (box === null) return { x: 0, y: 0, width: 0, height: 0 }\n  let document = element.ownerDocument\n  while (document !== home) {\n    // Null at the top, and for a cross-origin parent, which script cannot see into.\n    const frame = document.defaultView?.frameElement\n    if (frame == null) break\n    const origin = frameOrigin(frame)\n    box.x += origin.x\n    box.y += origin.y\n    document = frame.ownerDocument\n  }\n  return box\n}\n","/**\n * The file input an upload sets: the element itself, or the control of a\n * `<label>` — user-event's and Playwright's rule both. Anything else comes back\n * described as markup, for core's `checkFileTarget` to refuse in one wording.\n */\nexport function fileInputOf(element: Element): HTMLInputElement | string {\n  const target =\n    element.localName === 'label' ? (element as HTMLLabelElement).control : (element as Element)\n  if (target === null) return '<label> with no control'\n  if (target.localName !== 'input') return `<${target.localName}>`\n  const input = target as HTMLInputElement\n  return input.type === 'file' ? input : `<input type=\"${input.type}\">`\n}\n","/**\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 { configure } from '@harnessed-ts/core'\nimport type { BoundingBox, FileTarget, Selector } from '@harnessed-ts/core'\nimport { boxInOwnDocument, frameOrigin } from './box'\nimport type { Point } from './box'\nimport { fileInputOf } from './files'\nimport { PAGE_API_GLOBAL } from './global-name'\nimport { countAll, resolveAll, resolveAllNow, resolveOne, resolveOneNow } from './resolve'\nimport { isVisibleInLayout } from './visible'\nimport { decodeSelector } from './wire'\nimport type { WireSelector } from './wire'\n\nexport { PAGE_API_GLOBAL }\n\n/**\n * Settings a remote driver passes on every call. The page has no access to the\n * test process's `configure()`, so the runtime config travels with the call\n * rather than being pushed once.\n */\n/** A selector as handed over the wire, or as-is when caller and page share a realm. */\ntype Wire = Selector | WireSelector\n\nexport interface PageApiOptions {\n  testIdAttribute: string\n  timeout: number\n}\n\n/**\n * The resolver as seen from inside a page a driver does not share a realm with\n * — WebdriverIO, Puppeteer, TestCafe. Every argument is serialisable except\n * `root`, which is an element handle the driver passes back in (or `null` for\n * the document body).\n *\n * The same functions back the dom driver, so role, label, strictness, index\n * and frame semantics cannot differ between a driver resolving in-process and\n * one resolving through this.\n */\nexport interface PageApi {\n  /** How many nodes match. The scope waits; the count does not. */\n  count(\n    root: Element | null,\n    scope: Wire[],\n    selector: Wire,\n    options: PageApiOptions,\n  ): Promise<number>\n  /** The single node a strict operation acts on, waiting for it. */\n  one(\n    root: Element | null,\n    scope: Wire[],\n    selector: Wire,\n    options: PageApiOptions,\n  ): Promise<Element>\n  /** Every match, after waiting for the scope. `nth` is ignored, as for any list. */\n  all(\n    root: Element | null,\n    scope: Wire[],\n    selector: Wire,\n    options: PageApiOptions,\n  ): Promise<Element[]>\n  /** The single node now, or `null`. For runtimes that do their own retrying. */\n  oneNow(\n    root: Element | null,\n    scope: Wire[],\n    selector: Wire,\n    options: PageApiOptions,\n  ): Element | null\n  /** Every match now. */\n  allNow(root: Element | null, scope: Wire[], selector: Wire, options: PageApiOptions): Element[]\n  /**\n   * Whether an element is visible by layout, within its own document only. A\n   * driver that enters frames from outside the page asks about each iframe it\n   * crossed in that iframe's own document, which also covers a cross-origin\n   * frame no in-page walk could cross.\n   */\n  visible(element: Element): boolean\n  /**\n   * The element's box in its own document's viewport, or `null` when it draws\n   * none. A driver that enters frames from outside adds each crossed frame's\n   * `origin` itself.\n   */\n  box(element: Element): BoundingBox | null\n  /** Where an iframe's document is drawn, in the iframe's own document. */\n  origin(iframe: Element): Point\n  /** What an upload would set: the file input's `multiple`, or what the element is instead. */\n  fileTarget(element: Element): FileTarget\n}\n\nexport function createPageApi(document: Document): PageApi {\n  const start = (root: Element | null): HTMLElement => (root ?? document.body) as HTMLElement\n  // Only the test-id attribute: every waiting call passes its timeout\n  // explicitly. Note this writes the page's harnessed config, so the API belongs\n  // in a page that runs no harnesses of its own — which is every remote page.\n  const apply = (options: PageApiOptions): void =>\n    configure({ testIdAttribute: options.testIdAttribute })\n  const decode = (scope: Wire[], selector: Wire): [Selector[], Selector] => [\n    scope.map(decodeSelector),\n    decodeSelector(selector),\n  ]\n\n  return {\n    async count(root, scope, selector, options) {\n      apply(options)\n      const [steps, target] = decode(scope, selector)\n      return countAll(start(root), steps, target, options.timeout)\n    },\n    async one(root, scope, selector, options) {\n      apply(options)\n      const [steps, target] = decode(scope, selector)\n      return resolveOne(start(root), steps, target, options.timeout)\n    },\n    async all(root, scope, selector, options) {\n      apply(options)\n      const [steps, target] = decode(scope, selector)\n      return resolveAll(start(root), steps, target, options.timeout)\n    },\n    oneNow(root, scope, selector, options) {\n      apply(options)\n      const [steps, target] = decode(scope, selector)\n      return resolveOneNow(start(root), steps, target)\n    },\n    allNow(root, scope, selector, options) {\n      apply(options)\n      const [steps, target] = decode(scope, selector)\n      return resolveAllNow(start(root), steps, target)\n    },\n    visible(element) {\n      return isVisibleInLayout(element, element.ownerDocument)\n    },\n    box: boxInOwnDocument,\n    origin: frameOrigin,\n    fileTarget(element) {\n      const input = fileInputOf(element)\n      return typeof input === 'string' ? input : { multiple: input.multiple }\n    },\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { countAll, resolveAll, FrameEntryError, queryAll, resolveAllNow, resolveOne, resolveOneNow, resolveScope, resolveScopeNow, } from './resolve';
+export { isVisibleInLayout } from './visible';
+export { boundingBoxOf, boxInOwnDocument, frameOrigin } from './box';
+export type { Point } from './box';
+export { fileInputOf } from './files';
+export { createPageApi, PAGE_API_GLOBAL } from './page-api';
+export type { PageApi, PageApiOptions } from './page-api';
+export { decodeSelector, encodeSelector } from './wire';
+export type { WireRegExp, WireSelector } from './wire';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,eAAe,EACf,QAAQ,EACR,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACpE,YAAY,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC3D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AACvD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA"}