@noego/wood 0.4.9 → 0.5.0

package/dist/testing/automation_assertions.js

@@ -0,0 +1,385 @@
+import {
+  evenSpacing as evenSpacingRects,
+  gaps,
+  rectsOverlap,
+  sharedEdges as sharedRectEdges
+} from "./geometry.js";
+function failure(message, details) {
+  return details ? { pass: false, message, details } : { pass: false, message };
+}
+function success(message, details) {
+  return details ? { pass: true, message, details } : { pass: true, message };
+}
+function errorDetails(error) {
+  return {
+    error: error instanceof Error ? error.message : String(error)
+  };
+}
+function locatorFor(page, target) {
+  return typeof target === "string" ? page.locator(target).first() : target.first();
+}
+function targetName(target) {
+  return typeof target === "string" ? `"${target}"` : "<locator>";
+}
+function isRectBox(target) {
+  const candidate = target;
+  return typeof candidate.top === "number" && typeof candidate.left === "number" && typeof candidate.right === "number" && typeof candidate.bottom === "number" && typeof candidate.width === "number" && typeof candidate.height === "number";
+}
+async function rectFor(page, target) {
+  if (isRectBox(target)) return target;
+  const box = await locatorFor(page, target).boundingBox();
+  if (!box) return null;
+  return {
+    top: box.y,
+    left: box.x,
+    right: box.x + box.width,
+    bottom: box.y + box.height,
+    width: box.width,
+    height: box.height
+  };
+}
+async function visible(page, target) {
+  try {
+    const pass = await locatorFor(page, target).isVisible();
+    return pass ? success(`Expected ${targetName(target)} to be visible.`) : failure(`Expected ${targetName(target)} to be visible, but it was hidden or missing.`);
+  } catch (error) {
+    return failure(
+      `Could not determine whether ${targetName(target)} is visible.`,
+      errorDetails(error)
+    );
+  }
+}
+async function hidden(page, target) {
+  try {
+    const pass = !await locatorFor(page, target).isVisible();
+    return pass ? success(`Expected ${targetName(target)} to be hidden.`) : failure(`Expected ${targetName(target)} to be hidden, but it was visible.`);
+  } catch (error) {
+    return failure(
+      `Could not determine whether ${targetName(target)} is hidden.`,
+      errorDetails(error)
+    );
+  }
+}
+async function insideViewport(page, target, options = {}) {
+  try {
+    const margin = options.margin ?? 0;
+    const rect = await rectFor(page, target);
+    if (!rect) {
+      return failure("Expected target to have a visible bounding box.", { margin });
+    }
+    const viewport = page.viewportSize() ?? await page.evaluate(() => ({
+      width: window.innerWidth,
+      height: window.innerHeight
+    }));
+    const pass = rect.left >= margin && rect.top >= margin && rect.right <= viewport.width - margin && rect.bottom <= viewport.height - margin;
+    const details = { rect, viewport, margin };
+    return pass ? success("Target is inside the viewport.", details) : failure("Target extends outside the viewport.", details);
+  } catch (error) {
+    return failure("Could not assert viewport bounds.", errorDetails(error));
+  }
+}
+async function notClipped(page, target) {
+  try {
+    const result = await locatorFor(page, target).evaluate((element) => {
+      const rect = element.getBoundingClientRect();
+      let parent = element.parentElement;
+      while (parent) {
+        const style = window.getComputedStyle(parent);
+        const clipsX = /(auto|hidden|scroll|clip)/.test(style.overflowX);
+        const clipsY = /(auto|hidden|scroll|clip)/.test(style.overflowY);
+        if (clipsX || clipsY) {
+          const parentRect = parent.getBoundingClientRect();
+          const clippedX = clipsX && (rect.left < parentRect.left || rect.right > parentRect.right);
+          const clippedY = clipsY && (rect.top < parentRect.top || rect.bottom > parentRect.bottom);
+          if (clippedX || clippedY) {
+            return {
+              pass: false,
+              ancestor: {
+                tag: parent.tagName,
+                id: parent.id || null,
+                classes: Array.from(parent.classList)
+              },
+              rect: {
+                top: rect.top,
+                left: rect.left,
+                right: rect.right,
+                bottom: rect.bottom,
+                width: rect.width,
+                height: rect.height
+              },
+              ancestorRect: {
+                top: parentRect.top,
+                left: parentRect.left,
+                right: parentRect.right,
+                bottom: parentRect.bottom,
+                width: parentRect.width,
+                height: parentRect.height
+              },
+              clippedX,
+              clippedY
+            };
+          }
+        }
+        parent = parent.parentElement;
+      }
+      return { pass: true };
+    });
+    return result.pass ? success(`Expected ${targetName(target)} not to be clipped.`) : failure(
+      `Expected ${targetName(target)} not to be clipped, but an overflow ancestor clips it.`,
+      result
+    );
+  } catch (error) {
+    return failure(
+      `Could not determine whether ${targetName(target)} is clipped.`,
+      errorDetails(error)
+    );
+  }
+}
+async function notOverlapping(page, firstTarget, secondTarget) {
+  try {
+    const [first, second] = await Promise.all([
+      rectFor(page, firstTarget),
+      rectFor(page, secondTarget)
+    ]);
+    if (!first || !second) {
+      return failure("Expected both targets to have visible bounding boxes.", {
+        first,
+        second
+      });
+    }
+    const overlap = rectsOverlap(first, second);
+    const details = { first, second };
+    return overlap ? failure("Expected targets not to overlap, but their border boxes intersect.", details) : success("Targets do not overlap.", details);
+  } catch (error) {
+    return failure("Could not compare target overlap.", errorDetails(error));
+  }
+}
+async function hitTestReachable(page, target) {
+  try {
+    const result = await locatorFor(page, target).evaluate((element) => {
+      if (typeof document.elementFromPoint !== "function") {
+        return {
+          supported: false,
+          capability: "DOM document.elementFromPoint"
+        };
+      }
+      const rect = element.getBoundingClientRect();
+      const point = {
+        x: rect.left + rect.width / 2,
+        y: rect.top + rect.height / 2
+      };
+      const hit = document.elementFromPoint(point.x, point.y);
+      const reachable = Boolean(
+        hit && (hit === element || element.contains(hit) || hit.contains(element))
+      );
+      return {
+        supported: true,
+        reachable,
+        point,
+        targetRect: {
+          top: rect.top,
+          left: rect.left,
+          right: rect.right,
+          bottom: rect.bottom,
+          width: rect.width,
+          height: rect.height
+        },
+        hit: hit ? {
+          tag: hit.tagName,
+          id: hit.id || null,
+          classes: Array.from(hit.classList)
+        } : null,
+        relationship: hit ? {
+          isTarget: hit === element,
+          isDescendant: element.contains(hit),
+          isAncestor: hit.contains(element)
+        } : null
+      };
+    });
+    if (!result.supported) {
+      return failure(
+        "Hit testing is unsupported on this page surface.",
+        { capability: result.capability }
+      );
+    }
+    return result.reachable ? success(`Center of ${targetName(target)} is hit-test reachable.`, result) : failure(
+      `Center of ${targetName(target)} is covered by a foreign element.`,
+      result
+    );
+  } catch (error) {
+    return failure(
+      `Could not hit-test ${targetName(target)}.`,
+      errorDetails(error)
+    );
+  }
+}
+async function sharedEdgesOnPage(page, targets, edge, options) {
+  try {
+    const rects = await Promise.all(targets.map((target) => rectFor(page, target)));
+    if (rects.some((rect) => rect === null)) {
+      return failure("Expected every target to have a visible bounding box.", {
+        missingIndices: rects.map((rect, index) => rect === null ? index : -1).filter((index) => index >= 0)
+      });
+    }
+    return sharedRectEdges(rects, edge, options);
+  } catch (error) {
+    return failure("Could not compare target edges.", errorDetails(error));
+  }
+}
+function sharedEdges(pageOrRects, targetsOrEdge, edgeOrOptions = {}, options = {}) {
+  if (Array.isArray(pageOrRects)) {
+    return sharedRectEdges(
+      pageOrRects,
+      targetsOrEdge,
+      edgeOrOptions
+    );
+  }
+  return sharedEdgesOnPage(
+    pageOrRects,
+    targetsOrEdge,
+    edgeOrOptions,
+    options
+  );
+}
+async function evenSpacingOnPage(page, targets, axis, options) {
+  try {
+    const rects = await Promise.all(targets.map((target) => rectFor(page, target)));
+    if (rects.some((rect) => rect === null)) {
+      return failure("Expected every target to have a visible bounding box.", {
+        missingIndices: rects.map((rect, index) => rect === null ? index : -1).filter((index) => index >= 0)
+      });
+    }
+    return evenSpacingRects(rects, axis, options);
+  } catch (error) {
+    return failure("Could not compare target spacing.", errorDetails(error));
+  }
+}
+function evenSpacing(pageOrRects, targetsOrAxis, axisOrOptions = {}, options = {}) {
+  if (Array.isArray(pageOrRects)) {
+    return evenSpacingRects(
+      pageOrRects,
+      targetsOrAxis,
+      axisOrOptions
+    );
+  }
+  return evenSpacingOnPage(
+    pageOrRects,
+    targetsOrAxis,
+    axisOrOptions,
+    options
+  );
+}
+async function stableAfterAnimation(page, target, options = {}) {
+  const frameCount = options.frameCount ?? 3;
+  const tolerance = options.tolerance ?? 0;
+  const timeoutMs = options.timeoutMs ?? 2e3;
+  if (!Number.isInteger(frameCount) || frameCount < 1) {
+    return failure("frameCount must be a positive integer.", { frameCount });
+  }
+  try {
+    const result = await locatorFor(page, target).evaluate(
+      async (element, input) => {
+        if (typeof window.requestAnimationFrame !== "function") {
+          return {
+            supported: false,
+            capability: "DOM window.requestAnimationFrame"
+          };
+        }
+        const read = () => {
+          const rect = element.getBoundingClientRect();
+          return {
+            top: rect.top,
+            left: rect.left,
+            right: rect.right,
+            bottom: rect.bottom,
+            width: rect.width,
+            height: rect.height
+          };
+        };
+        const samples = [read()];
+        let timedOut = false;
+        const timeout = window.setTimeout(() => {
+          timedOut = true;
+        }, input.timeoutMs);
+        for (let index = 0; index < input.frameCount && !timedOut; index += 1) {
+          await new Promise((resolve) => {
+            window.requestAnimationFrame(() => resolve());
+          });
+          samples.push(read());
+        }
+        window.clearTimeout(timeout);
+        if (timedOut) {
+          return { supported: true, timedOut: true, samples };
+        }
+        const first = samples[0];
+        const keys = ["top", "left", "right", "bottom", "width", "height"];
+        let maximumDelta = 0;
+        for (const sample of samples.slice(1)) {
+          for (const key of keys) {
+            maximumDelta = Math.max(maximumDelta, Math.abs(sample[key] - first[key]));
+          }
+        }
+        return {
+          supported: true,
+          timedOut: false,
+          stable: maximumDelta <= input.tolerance,
+          maximumDelta,
+          samples
+        };
+      },
+      { frameCount, tolerance, timeoutMs }
+    );
+    if (!result.supported) {
+      return failure(
+        "Animation stability sampling is unsupported on this page surface.",
+        { capability: result.capability }
+      );
+    }
+    if (result.timedOut) {
+      return failure(
+        `Animation stability sampling timed out after ${timeoutMs}ms.`,
+        result
+      );
+    }
+    return result.stable ? success(
+      `Bounding box stayed stable across ${frameCount} animation frames.`,
+      result
+    ) : failure(
+      `Bounding box changed across ${frameCount} animation frames.`,
+      result
+    );
+  } catch (error) {
+    return failure(
+      `Could not sample animation stability for ${targetName(target)}.`,
+      errorDetails(error)
+    );
+  }
+}
+const automationAssertions = {
+  visible,
+  hidden,
+  insideViewport,
+  notClipped,
+  notOverlapping,
+  hitTestReachable,
+  sharedEdges,
+  evenSpacing,
+  stableAfterAnimation
+};
+export {
+  automationAssertions,
+  evenSpacing,
+  evenSpacingRects,
+  gaps,
+  hidden,
+  hitTestReachable,
+  insideViewport,
+  notClipped,
+  notOverlapping,
+  rectsOverlap,
+  sharedEdges,
+  sharedRectEdges,
+  stableAfterAnimation,
+  visible
+};
+//# sourceMappingURL=automation_assertions.js.map

package/dist/testing/automation_assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/automation_assertions.ts"],"sourcesContent":["import type { Locator, Page } from 'playwright';\nimport {\n  evenSpacing as evenSpacingRects,\n  gaps,\n  rectsOverlap,\n  sharedEdges as sharedRectEdges,\n  type GeometryVerdict,\n  type RectAxis,\n  type RectBox,\n  type RectEdge,\n} from './geometry.js';\n\nexport {\n  gaps,\n  rectsOverlap,\n  evenSpacingRects,\n  sharedRectEdges,\n};\nexport type {\n  GeometryVerdict,\n  RectAxis,\n  RectBox,\n  RectEdge,\n};\n\nexport interface AssertionVerdict {\n  pass: boolean;\n  message: string;\n  details?: Record<string, unknown>;\n}\n\nexport type AutomationTarget = string | Locator;\nexport type AutomationRectTarget = AutomationTarget | RectBox;\n\nfunction failure(\n  message: string,\n  details?: Record<string, unknown>,\n): AssertionVerdict {\n  return details ? { pass: false, message, details } : { pass: false, message };\n}\n\nfunction success(\n  message: string,\n  details?: Record<string, unknown>,\n): AssertionVerdict {\n  return details ? { pass: true, message, details } : { pass: true, message };\n}\n\nfunction errorDetails(error: unknown): Record<string, unknown> {\n  return {\n    error: error instanceof Error ? error.message : String(error),\n  };\n}\n\nfunction locatorFor(page: Page, target: AutomationTarget): Locator {\n  return typeof target === 'string' ? page.locator(target).first() : target.first();\n}\n\nfunction targetName(target: AutomationTarget): string {\n  return typeof target === 'string' ? `\"${target}\"` : '<locator>';\n}\n\nfunction isRectBox(target: AutomationRectTarget): target is RectBox {\n  const candidate = target as Partial<RectBox>;\n  return typeof candidate.top === 'number'\n    && typeof candidate.left === 'number'\n    && typeof candidate.right === 'number'\n    && typeof candidate.bottom === 'number'\n    && typeof candidate.width === 'number'\n    && typeof candidate.height === 'number';\n}\n\nasync function rectFor(\n  page: Page,\n  target: AutomationRectTarget,\n): Promise<RectBox | null> {\n  if (isRectBox(target)) return target;\n  const box = await locatorFor(page, target).boundingBox();\n  if (!box) return null;\n  return {\n    top: box.y,\n    left: box.x,\n    right: box.x + box.width,\n    bottom: box.y + box.height,\n    width: box.width,\n    height: box.height,\n  };\n}\n\nexport async function visible(\n  page: Page,\n  target: AutomationTarget,\n): Promise<AssertionVerdict> {\n  try {\n    const pass = await locatorFor(page, target).isVisible();\n    return pass\n      ? success(`Expected ${targetName(target)} to be visible.`)\n      : failure(`Expected ${targetName(target)} to be visible, but it was hidden or missing.`);\n  } catch (error) {\n    return failure(\n      `Could not determine whether ${targetName(target)} is visible.`,\n      errorDetails(error),\n    );\n  }\n}\n\nexport async function hidden(\n  page: Page,\n  target: AutomationTarget,\n): Promise<AssertionVerdict> {\n  try {\n    const pass = !(await locatorFor(page, target).isVisible());\n    return pass\n      ? success(`Expected ${targetName(target)} to be hidden.`)\n      : failure(`Expected ${targetName(target)} to be hidden, but it was visible.`);\n  } catch (error) {\n    return failure(\n      `Could not determine whether ${targetName(target)} is hidden.`,\n      errorDetails(error),\n    );\n  }\n}\n\nexport async function insideViewport(\n  page: Page,\n  target: AutomationRectTarget,\n  options: { margin?: number } = {},\n): Promise<AssertionVerdict> {\n  try {\n    const margin = options.margin ?? 0;\n    const rect = await rectFor(page, target);\n    if (!rect) {\n      return failure('Expected target to have a visible bounding box.', { margin });\n    }\n    const viewport = page.viewportSize() ?? await page.evaluate(() => ({\n      width: window.innerWidth,\n      height: window.innerHeight,\n    }));\n    const pass = rect.left >= margin\n      && rect.top >= margin\n      && rect.right <= viewport.width - margin\n      && rect.bottom <= viewport.height - margin;\n    const details = { rect, viewport, margin };\n    return pass\n      ? success('Target is inside the viewport.', details)\n      : failure('Target extends outside the viewport.', details);\n  } catch (error) {\n    return failure('Could not assert viewport bounds.', errorDetails(error));\n  }\n}\n\nexport async function notClipped(\n  page: Page,\n  target: AutomationTarget,\n): Promise<AssertionVerdict> {\n  try {\n    const result = await locatorFor(page, target).evaluate((element: Element) => {\n      const rect = element.getBoundingClientRect();\n      let parent = element.parentElement;\n      while (parent) {\n        const style = window.getComputedStyle(parent);\n        const clipsX = /(auto|hidden|scroll|clip)/.test(style.overflowX);\n        const clipsY = /(auto|hidden|scroll|clip)/.test(style.overflowY);\n        if (clipsX || clipsY) {\n          const parentRect = parent.getBoundingClientRect();\n          const clippedX = clipsX\n            && (rect.left < parentRect.left || rect.right > parentRect.right);\n          const clippedY = clipsY\n            && (rect.top < parentRect.top || rect.bottom > parentRect.bottom);\n          if (clippedX || clippedY) {\n            return {\n              pass: false,\n              ancestor: {\n                tag: parent.tagName,\n                id: parent.id || null,\n                classes: Array.from(parent.classList),\n              },\n              rect: {\n                top: rect.top,\n                left: rect.left,\n                right: rect.right,\n                bottom: rect.bottom,\n                width: rect.width,\n                height: rect.height,\n              },\n              ancestorRect: {\n                top: parentRect.top,\n                left: parentRect.left,\n                right: parentRect.right,\n                bottom: parentRect.bottom,\n                width: parentRect.width,\n                height: parentRect.height,\n              },\n              clippedX,\n              clippedY,\n            };\n          }\n        }\n        parent = parent.parentElement;\n      }\n      return { pass: true };\n    });\n\n    return result.pass\n      ? success(`Expected ${targetName(target)} not to be clipped.`)\n      : failure(\n        `Expected ${targetName(target)} not to be clipped, but an overflow ancestor clips it.`,\n        result,\n      );\n  } catch (error) {\n    return failure(\n      `Could not determine whether ${targetName(target)} is clipped.`,\n      errorDetails(error),\n    );\n  }\n}\n\nexport async function notOverlapping(\n  page: Page,\n  firstTarget: AutomationRectTarget,\n  secondTarget: AutomationRectTarget,\n): Promise<AssertionVerdict> {\n  try {\n    const [first, second] = await Promise.all([\n      rectFor(page, firstTarget),\n      rectFor(page, secondTarget),\n    ]);\n    if (!first || !second) {\n      return failure('Expected both targets to have visible bounding boxes.', {\n        first,\n        second,\n      });\n    }\n    const overlap = rectsOverlap(first, second);\n    const details = { first, second };\n    return overlap\n      ? failure('Expected targets not to overlap, but their border boxes intersect.', details)\n      : success('Targets do not overlap.', details);\n  } catch (error) {\n    return failure('Could not compare target overlap.', errorDetails(error));\n  }\n}\n\nexport async function hitTestReachable(\n  page: Page,\n  target: AutomationTarget,\n): Promise<AssertionVerdict> {\n  try {\n    const result = await locatorFor(page, target).evaluate((element: Element) => {\n      if (typeof document.elementFromPoint !== 'function') {\n        return {\n          supported: false as const,\n          capability: 'DOM document.elementFromPoint',\n        };\n      }\n      const rect = element.getBoundingClientRect();\n      const point = {\n        x: rect.left + rect.width / 2,\n        y: rect.top + rect.height / 2,\n      };\n      const hit = document.elementFromPoint(point.x, point.y);\n      const reachable = Boolean(\n        hit\n        && (hit === element || element.contains(hit) || hit.contains(element)),\n      );\n      return {\n        supported: true as const,\n        reachable,\n        point,\n        targetRect: {\n          top: rect.top,\n          left: rect.left,\n          right: rect.right,\n          bottom: rect.bottom,\n          width: rect.width,\n          height: rect.height,\n        },\n        hit: hit ? {\n          tag: hit.tagName,\n          id: hit.id || null,\n          classes: Array.from(hit.classList),\n        } : null,\n        relationship: hit ? {\n          isTarget: hit === element,\n          isDescendant: element.contains(hit),\n          isAncestor: hit.contains(element),\n        } : null,\n      };\n    });\n\n    if (!result.supported) {\n      return failure(\n        'Hit testing is unsupported on this page surface.',\n        { capability: result.capability },\n      );\n    }\n    return result.reachable\n      ? success(`Center of ${targetName(target)} is hit-test reachable.`, result)\n      : failure(\n        `Center of ${targetName(target)} is covered by a foreign element.`,\n        result,\n      );\n  } catch (error) {\n    return failure(\n      `Could not hit-test ${targetName(target)}.`,\n      errorDetails(error),\n    );\n  }\n}\n\ntype GeometryOptions = { tolerance?: number };\n\nasync function sharedEdgesOnPage(\n  page: Page,\n  targets: readonly AutomationRectTarget[],\n  edge: RectEdge,\n  options: GeometryOptions,\n): Promise<AssertionVerdict> {\n  try {\n    const rects = await Promise.all(targets.map((target) => rectFor(page, target)));\n    if (rects.some((rect) => rect === null)) {\n      return failure('Expected every target to have a visible bounding box.', {\n        missingIndices: rects\n          .map((rect, index) => rect === null ? index : -1)\n          .filter((index) => index >= 0),\n      });\n    }\n    return sharedRectEdges(rects as RectBox[], edge, options);\n  } catch (error) {\n    return failure('Could not compare target edges.', errorDetails(error));\n  }\n}\n\nexport function sharedEdges(\n  rects: readonly RectBox[],\n  edge: RectEdge,\n  options?: GeometryOptions,\n): GeometryVerdict;\nexport function sharedEdges(\n  page: Page,\n  targets: readonly AutomationRectTarget[],\n  edge: RectEdge,\n  options?: GeometryOptions,\n): Promise<AssertionVerdict>;\nexport function sharedEdges(\n  pageOrRects: Page | readonly RectBox[],\n  targetsOrEdge: readonly AutomationRectTarget[] | RectEdge,\n  edgeOrOptions: RectEdge | GeometryOptions = {},\n  options: GeometryOptions = {},\n): GeometryVerdict | Promise<AssertionVerdict> {\n  if (Array.isArray(pageOrRects)) {\n    return sharedRectEdges(\n      pageOrRects,\n      targetsOrEdge as RectEdge,\n      edgeOrOptions as GeometryOptions,\n    );\n  }\n  return sharedEdgesOnPage(\n    pageOrRects as Page,\n    targetsOrEdge as readonly AutomationRectTarget[],\n    edgeOrOptions as RectEdge,\n    options,\n  );\n}\n\nasync function evenSpacingOnPage(\n  page: Page,\n  targets: readonly AutomationRectTarget[],\n  axis: RectAxis,\n  options: GeometryOptions,\n): Promise<AssertionVerdict> {\n  try {\n    const rects = await Promise.all(targets.map((target) => rectFor(page, target)));\n    if (rects.some((rect) => rect === null)) {\n      return failure('Expected every target to have a visible bounding box.', {\n        missingIndices: rects\n          .map((rect, index) => rect === null ? index : -1)\n          .filter((index) => index >= 0),\n      });\n    }\n    return evenSpacingRects(rects as RectBox[], axis, options);\n  } catch (error) {\n    return failure('Could not compare target spacing.', errorDetails(error));\n  }\n}\n\nexport function evenSpacing(\n  rects: readonly RectBox[],\n  axis: RectAxis,\n  options?: GeometryOptions,\n): GeometryVerdict;\nexport function evenSpacing(\n  page: Page,\n  targets: readonly AutomationRectTarget[],\n  axis: RectAxis,\n  options?: GeometryOptions,\n): Promise<AssertionVerdict>;\nexport function evenSpacing(\n  pageOrRects: Page | readonly RectBox[],\n  targetsOrAxis: readonly AutomationRectTarget[] | RectAxis,\n  axisOrOptions: RectAxis | GeometryOptions = {},\n  options: GeometryOptions = {},\n): GeometryVerdict | Promise<AssertionVerdict> {\n  if (Array.isArray(pageOrRects)) {\n    return evenSpacingRects(\n      pageOrRects,\n      targetsOrAxis as RectAxis,\n      axisOrOptions as GeometryOptions,\n    );\n  }\n  return evenSpacingOnPage(\n    pageOrRects as Page,\n    targetsOrAxis as readonly AutomationRectTarget[],\n    axisOrOptions as RectAxis,\n    options,\n  );\n}\n\nexport async function stableAfterAnimation(\n  page: Page,\n  target: AutomationTarget,\n  options: { frameCount?: number; tolerance?: number; timeoutMs?: number } = {},\n): Promise<AssertionVerdict> {\n  const frameCount = options.frameCount ?? 3;\n  const tolerance = options.tolerance ?? 0;\n  const timeoutMs = options.timeoutMs ?? 2000;\n  if (!Number.isInteger(frameCount) || frameCount < 1) {\n    return failure('frameCount must be a positive integer.', { frameCount });\n  }\n\n  try {\n    const result = await locatorFor(page, target).evaluate(\n      async (element: Element, input: {\n        frameCount: number;\n        tolerance: number;\n        timeoutMs: number;\n      }) => {\n        if (typeof window.requestAnimationFrame !== 'function') {\n          return {\n            supported: false as const,\n            capability: 'DOM window.requestAnimationFrame',\n          };\n        }\n        const read = () => {\n          const rect = element.getBoundingClientRect();\n          return {\n            top: rect.top,\n            left: rect.left,\n            right: rect.right,\n            bottom: rect.bottom,\n            width: rect.width,\n            height: rect.height,\n          };\n        };\n        const samples = [read()];\n        let timedOut = false;\n        const timeout = window.setTimeout(() => {\n          timedOut = true;\n        }, input.timeoutMs);\n        for (let index = 0; index < input.frameCount && !timedOut; index += 1) {\n          await new Promise<void>((resolve) => {\n            window.requestAnimationFrame(() => resolve());\n          });\n          samples.push(read());\n        }\n        window.clearTimeout(timeout);\n        if (timedOut) {\n          return { supported: true as const, timedOut: true, samples };\n        }\n\n        const first = samples[0];\n        const keys = ['top', 'left', 'right', 'bottom', 'width', 'height'] as const;\n        let maximumDelta = 0;\n        for (const sample of samples.slice(1)) {\n          for (const key of keys) {\n            maximumDelta = Math.max(maximumDelta, Math.abs(sample[key] - first[key]));\n          }\n        }\n        return {\n          supported: true as const,\n          timedOut: false,\n          stable: maximumDelta <= input.tolerance,\n          maximumDelta,\n          samples,\n        };\n      },\n      { frameCount, tolerance, timeoutMs },\n    );\n\n    if (!result.supported) {\n      return failure(\n        'Animation stability sampling is unsupported on this page surface.',\n        { capability: result.capability },\n      );\n    }\n    if (result.timedOut) {\n      return failure(\n        `Animation stability sampling timed out after ${timeoutMs}ms.`,\n        result,\n      );\n    }\n    return result.stable\n      ? success(\n        `Bounding box stayed stable across ${frameCount} animation frames.`,\n        result,\n      )\n      : failure(\n        `Bounding box changed across ${frameCount} animation frames.`,\n        result,\n      );\n  } catch (error) {\n    return failure(\n      `Could not sample animation stability for ${targetName(target)}.`,\n      errorDetails(error),\n    );\n  }\n}\n\nexport const automationAssertions = {\n  visible,\n  hidden,\n  insideViewport,\n  notClipped,\n  notOverlapping,\n  hitTestReachable,\n  sharedEdges,\n  evenSpacing,\n  stableAfterAnimation,\n};\n"],"mappings":"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","names":[]}