@skyramp/mcp 0.4.3 → 0.4.4-rc.2

package/build/workspace/workspace.js

@@ -61,7 +61,7 @@ export const serviceSchema = z
          *  the auth header). Literal values only — no env-var interpolation.
          *  Explicit per-request queryParams always win on a key collision
          *  (SKYR-4050). */
-        defaultQueryParams: z.record(z.string()).optional(),
+        defaultQueryParams: z.record(z.string(), z.string()).optional(),
         /** Path-scoped overrides layered on top of defaultQueryParams
          *  (SKYR-4127). For a given request, the single most-specific matching
          *  pathPattern wins and its values override the base map key by key;
@@ -84,7 +84,7 @@ export const serviceSchema = z
             .array(z
             .object({
             pathPattern: z.string().min(1),
-            values: z.record(z.string()),
+            values: z.record(z.string(), z.string()),
         })
             .strict())
             .optional(),

package/node_modules/playwright/lib/mcp/skyramp/assertOrder.js

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var assertOrder_exports = {};
+__export(assertOrder_exports, {
+  checkOrderArgs: () => checkOrderArgs,
+  containmentError: () => containmentError,
+  contains: () => contains,
+  describeOrderResult: () => describeOrderResult
+});
+module.exports = __toCommonJS(assertOrder_exports);
+var import_utils = require("playwright-core/lib/utils");
+function checkOrderArgs(params) {
+  if (!(0, import_utils.isOrderRelation)(params.expected))
+    return { error: `For "order" assertions, "expected" must be one of ${import_utils.ORDER_RELATIONS.map((r) => `"${r}"`).join(", ")}.` };
+  if (!params.otherRef?.trim())
+    return { error: 'For "order" assertions, "otherRef" (the element this one is compared with) is required.' };
+  if (params.otherRef === params.ref)
+    return { error: '"ref" and "otherRef" are the same element; an order assertion compares two different elements.' };
+  return { relation: params.expected, otherElement: params.otherElement?.trim() || `ref ${params.otherRef}` };
+}
+function contains(outer, inner) {
+  return outer.x <= inner.x && outer.y <= inner.y && outer.x + outer.width >= inner.x + inner.width && outer.y + outer.height >= inner.y + inner.height;
+}
+function containmentError(a, b, boxA, boxB) {
+  if (!contains(boxA, boxB) && !contains(boxB, boxA))
+    return void 0;
+  const [outer, inner] = contains(boxA, boxB) ? [a, b] : [b, a];
+  return `"${outer.element}" contains "${inner.element}", so they have no order. Assert the order of two sibling blocks (e.g. the two columns), not of a block and something inside it.`;
+}
+function describeOrderResult(relation, a, b, boxA, boxB) {
+  const result = (0, import_utils.orderHolds)(relation, boxA, boxB);
+  const { axis, edgeA, edgeB } = result;
+  const round = (v) => Math.round(v * 10) / 10;
+  const words = (r) => r.replace("-", " ");
+  if (result.ok)
+    return { result, details: `Order assertion passed: "${a.element}" (${axis}=${round(edgeA)}) is ${words(relation)} "${b.element}" (${axis}=${round(edgeB)}).` };
+  const actual = edgeA === edgeB ? `at the same ${axis} as` : axis === "x" ? edgeA < edgeB ? "left of" : "right of" : edgeA < edgeB ? "above" : "below";
+  const lowFirst = relation === "left-of" || relation === "above";
+  return {
+    result,
+    details: `Order assertion FAILED: "${a.element}" (${axis}=${round(edgeA)}) is ${actual} "${b.element}" (${axis}=${round(edgeB)}), expected ${words(relation)}. Nothing was recorded. If a requirement demands ${relation}, add the comparison to the generated test with these locators (JavaScript syntax; write them in the test's language): ${(0, import_utils.asLocator)("javascript", a.selector)} and ${(0, import_utils.asLocator)("javascript", b.selector)} (compare boundingBox().${axis}; the first must be ${lowFirst ? "smaller" : "greater"}).`
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkOrderArgs,
+  containmentError,
+  contains,
+  describeOrderResult
+});

package/node_modules/playwright/lib/mcp/skyramp/assertTool.js

@@ -18,11 +18,13 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var assertTool_exports = {};
 __export(assertTool_exports, {
+  ORDER_RELATIONS: () => import_utils.ORDER_RELATIONS,
   assertMcpTool: () => assertMcpTool,
   assertToolSchema: () => assertToolSchema
 });
 module.exports = __toCommonJS(assertTool_exports);
 var import_mcpBundle = require("playwright-core/lib/mcpBundle");
+var import_utils = require("playwright-core/lib/utils");
 var import_tool = require("../sdk/tool");
 const assertToolSchema = {
   name: "browser_assert",
@@ -38,17 +40,23 @@ const assertToolSchema = {
     "across the page, e.g. ref one option of an open dropdown to assert the number of options.",
     '"css" checks a computed style property (property "background-color", expected "rgb(37, 99, 235)"; a 3- or 6-digit #hex colour is accepted and recorded as the computed rgb),',
     '"class" checks the element carries a class ("expected" = one class name),',
-    '"attribute" checks an attribute value ("property" = the attribute name, "expected" = its value).',
+    '"attribute" checks an attribute value ("property" = the attribute name, "expected" = its value),',
+    '"order" checks where the element sits relative to another one; "otherRef" and "expected" are REQUIRED for it ("otherRef" = the other element, "expected" = "left-of", "right-of", "above" or "below").',
+    'It compares where the two elements START: the left edges (x) for left-of/right-of, the top edges (y) for above/below, strictly \u2014 "left-of" means "starts further left", not "wholly to the left", and equal edges fail (side-by-side columns are not "above" each other; full-width stacked blocks are not "left-of" each other).',
+    "Pick the axis the PR actually changes. Both elements must be visible, and one containing the other is refused: assert two sibling blocks.",
+    'Use "order" when the PR swaps, moves or reorders blocks (a left/right column swap, a moved sidebar): it fails when the swap is undone.',
     "Use css/class/attribute for a colour, style or class change the PR makes: a screenshot baseline created on this run cannot fail on it.",
     'css/class/attribute are read with the pointer moved OFF the element, so a value that exists only on hover is never recorded; unlike "count", they cannot be asserted on an option of a menu that closes when the pointer leaves it.',
     "To assert an element is absent or not visible, use `browser_assert_hidden`."
   ].join(" "),
   inputSchema: import_mcpBundle.z.object({
-    type: import_mcpBundle.z.enum(["text", "value", "checked", "disabled", "visible", "count", "css", "class", "attribute"]).describe(`Type of assertion: "text" for text content, "value" for input field value, "checked" for checkbox/radio state, "disabled" for disabled/enabled state ("false" asserts the element is enabled), "visible" for element visibility, "count" for the number of elements with the referenced element's role, "css" for a computed style property, "class" for a class the element carries, "attribute" for an attribute value`),
+    type: import_mcpBundle.z.enum(["text", "value", "checked", "disabled", "visible", "count", "css", "class", "attribute", "order"]).describe(`Type of assertion: "text" for text content, "value" for input field value, "checked" for checkbox/radio state, "disabled" for disabled/enabled state ("false" asserts the element is enabled), "visible" for element visibility, "count" for the number of elements with the referenced element's role, "css" for a computed style property, "class" for a class the element carries, "attribute" for an attribute value, "order" for the element's position relative to another element`),
     ref: import_mcpBundle.z.string().describe('Element reference from the latest snapshot. For "count", reference one exemplar element (e.g. one option in an open dropdown).'),
     element: import_mcpBundle.z.string().describe("Human-readable description of the element being asserted"),
+    otherRef: import_mcpBundle.z.string().optional().describe(`Required for "order": the other element's reference from the latest snapshot. Not used by other types.`),
+    otherElement: import_mcpBundle.z.string().optional().describe('For "order": human-readable description of the other element. Not used by other types.'),
     property: import_mcpBundle.z.string().optional().describe('For "css": the CSS property (e.g. "background-color", "flex-direction"). For "attribute": the attribute name (e.g. "aria-expanded", "data-state"). Not used by other types.'),
-    expected: import_mcpBundle.z.string().optional().describe('Expected text or value ("text"/"value"), "true"/"false" ("checked"/"disabled", default "true"; "disabled" with "false" asserts enabled), the expected element count ("count"), the computed style value ("css"; a 3- or 6-digit #hex colour is converted to rgb), one class name ("class"), the attribute value ("attribute"). Not used for "visible".'),
+    expected: import_mcpBundle.z.string().optional().describe('Expected text or value ("text"/"value"), "true"/"false" ("checked"/"disabled", default "true"; "disabled" with "false" asserts enabled), the expected element count ("count"), the computed style value ("css"; a 3- or 6-digit #hex colour is converted to rgb), one class name ("class"), the attribute value ("attribute"), "left-of" / "right-of" / "above" / "below" ("order"). Not used for "visible".'),
     substring: import_mcpBundle.z.boolean().optional().default(true).describe("For text assertions: match as substring (true) or exact match (false)")
   }),
   type: "readOnly"
@@ -58,6 +66,7 @@ function assertMcpTool() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ORDER_RELATIONS,
   assertMcpTool,
   assertToolSchema
 });

package/node_modules/playwright/lib/mcp/skyramp/common/liveReadError.js

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var liveReadError_exports = {};
+__export(liveReadError_exports, {
+  liveReadError: () => liveReadError
+});
+module.exports = __toCommonJS(liveReadError_exports);
+function liveReadError(e, o) {
+  const err = (text) => ({ content: [{ type: "text", text: `### Error
+${text}` }], isError: true });
+  const msg = String(e?.message ?? e);
+  if (/strict mode violation/i.test(msg))
+    return err(`Target ${o.selector} matches multiple elements, so ${o.ambiguity}${o.pinFailure ? `, and ${o.pinFailure}` : ""}. Use a more specific target (a data-testid, or role + exact name). ${msg.split("\n")[0]}`);
+  if (e?.name === "TimeoutError") {
+    if (o.timeoutMs === void 0)
+      return void 0;
+    return err(`"${o.element}" (${o.selector}) did not resolve within ${o.timeoutMs} ms. Re-snapshot and retry with a fresh ref.`);
+  }
+  return err(`Could not ${o.failedTo} "${o.element}": ${msg}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  liveReadError
+});

package/node_modules/playwright/lib/mcp/skyramp/loadTraceTool.js

@@ -113,6 +113,8 @@ function describeStep(action, index) {
     detail += ` .${a.className}`;
   else if (a.name === "assertAttribute")
     detail += ` [${a.attrName}=${JSON.stringify(a.attrValue)}]`;
+  else if (a.name === "assertOrder")
+    detail += ` ${a.relation} ${a.otherSelector}`;
   else if (a.name === "press" && a.key !== void 0)
     detail += ` ${a.key}`;
   else if (a.name === "visualSnapshot")
@@ -389,6 +391,25 @@ async function performClientAction(page, actionInContext) {
         throw new Error(`assertAttribute failed: expected ${action.attrName}=${JSON.stringify(action.attrValue)}, got ${JSON.stringify(actual)}`);
       return;
     }
+    // SKYR-4544: the comparison the recorder verified and the generated test
+    // runs — each box's origin, the left edge (x) for left-of/right-of and the
+    // top edge (y) for above/below, compared strictly — after waiting for both
+    // elements to be visible, as the generated test does.
+    case "assertOrder": {
+      const fields = (0, import_utils.parseOrderFields)(action);
+      if (!fields)
+        throw new Error(`assertOrder failed: trace line needs "otherSelector" and a relation of ${import_utils.ORDER_RELATIONS.join("/")}, got ${JSON.stringify(action.relation)}`);
+      const other = page.locator(buildFullSelector(actionInContext.frame.framePath, fields.otherSelector));
+      await locator.waitFor({ state: "visible", ...opts });
+      await other.waitFor({ state: "visible", ...opts });
+      const [boxA, boxB] = [await locator.boundingBox(opts), await other.boundingBox(opts)];
+      if (!boxA || !boxB)
+        throw new Error(`assertOrder failed: ${!boxA ? fields.selector : fields.otherSelector} has no box on the page`);
+      const { ok, axis, edgeA, edgeB } = (0, import_utils.orderHolds)(fields.relation, boxA, boxB);
+      if (!ok)
+        throw new Error(`assertOrder failed: expected ${fields.selector} ${fields.relation} ${fields.otherSelector}, got ${axis} ${edgeA} vs ${edgeB}`);
+      return;
+    }
     case "assertChecked": {
       const checked = await locator.isChecked(opts);
       if (checked !== !!action.checked)

package/node_modules/playwright/lib/mcp/skyramp/skyRampImport.js

@@ -70,6 +70,7 @@ const ACTION_NAMES = /* @__PURE__ */ new Set([
   "assertCSS",
   "assertClass",
   "assertAttribute",
+  "assertOrder",
   "dragTo",
   "dragAndDrop",
   "diagramNodeAdd",
@@ -143,7 +144,7 @@ function parseLine(line) {
   if (!entry.name || !isActionName(entry.name))
     return null;
   const { pageGuid, pageAlias, framePath, locator, ...actionFields } = entry;
-  if (entry.name === "assertHidden" && locator && typeof locator === "object")
+  if ((entry.name === "assertHidden" || entry.name === "assertOrder") && locator && typeof locator === "object")
     actionFields.locator = locator;
   const frame = {
     pageGuid: pageGuid ?? "",

package/node_modules/playwright/lib/mcp/skyramp/traceRecordingBackend.js

@@ -45,6 +45,8 @@ var import_log = require("../log");
 var import_skyRampExport = require("../test/skyRampExport");
 var import_exportTool = require("./exportTool");
 var import_assertTool = require("./assertTool");
+var import_assertOrder = require("./assertOrder");
+var import_liveReadError = require("./common/liveReadError");
 var import_assertHiddenTool = require("./assertHiddenTool");
 var import_assertApiRequestTool = require("./assertApiRequestTool");
 var import_loadTraceTool = require("./loadTraceTool");
@@ -246,7 +248,9 @@ class TraceRecordingBackend {
     }
     if (name === import_assertTool.assertToolSchema.name) {
       const parsed = import_assertTool.assertToolSchema.inputSchema.parse(args || {});
-      return this._handleAssert(parsed);
+      if (parsed.type === "order")
+        return this._handleAssertOrder(parsed);
+      return this._handleAssert({ ...parsed, type: parsed.type });
     }
     if (name === import_assertHiddenTool.assertHiddenToolSchema.name) {
       const parsed = import_assertHiddenTool.assertHiddenToolSchema.inputSchema.parse(args || {});
@@ -933,6 +937,14 @@ Continue recording with browser_* tools, then call skyramp_export_zip to write t
           return null;
         return { toolName: "browser_assert", code: `assertAttribute:${a.selector}:${a.attrName.trim()}:${a.attrValue}`, args: { type: "attribute", selector: a.selector, property: a.attrName.trim(), expected: a.attrValue } };
       }
+      // SKYR-4544: an order assertion needs both ends and its relation; a line
+      // missing one is dropped rather than seeded with a hole.
+      case "assertOrder": {
+        const fields = (0, import_utils.parseOrderFields)(a);
+        if (!fields)
+          return null;
+        return { toolName: "browser_assert", code: `assertOrder:${fields.selector}:${fields.relation}:${fields.otherSelector}`, args: { type: "order", ...fields } };
+      }
       case "assertCount":
         if (typeof a.count !== "number" || !Number.isInteger(a.count) || a.count < 0)
           return null;
@@ -1340,8 +1352,9 @@ Linked GoJS nodes ${params.fromKey} \u2192 ${params.toKey} (${params.fromPort}\u
    * proper Playwright selector (testid > role > text), then verify
    * text/value/checked/disabled/visible/count against the snapshot data, and
    * css/class/attribute against the live element (getComputedStyle / classList
-   * / getAttribute, read with the pointer moved off the element). Only passing
-   * assertions are recorded.
+   * / getAttribute, read with the pointer moved off the element). "order" is
+   * dispatched to _handleAssertOrder instead: two refs, a live boundingBox()
+   * comparison, no pointer-off read. Only passing assertions are recorded.
    */
   async _handleAssert(params) {
     const timestamp = Date.now();
@@ -1471,15 +1484,7 @@ Could not read the un-hovered state of "${params.element}": the pointer could no
           details = passed ? `Attribute assertion passed: "${params.element}" has ${name}="${actual}".` : `Attribute assertion FAILED: "${params.element}" has ${name}=${actual === null ? "(absent)" : `"${actual}"`}, expected "${params.expected}".`;
         }
       } catch (e) {
-        const msg = String(e?.message ?? e);
-        if (/strict mode violation/i.test(msg))
-          return { content: [{ type: "text", text: `### Error
-Target ${parsed.selector} matches multiple elements, so the ${kind} read is ambiguous${unique.pinFailure ? `, and ${unique.pinFailure}` : ""}. Use a more specific target (a data-testid, or role + exact name). ${msg.split("\n")[0]}` }], isError: true };
-        if (e?.name === "TimeoutError")
-          return { content: [{ type: "text", text: `### Error
-"${params.element}" (${parsed.selector}) did not resolve within ${LIVE_READ_TIMEOUT_MS} ms. Re-snapshot and retry with a fresh ref.` }], isError: true };
-        return { content: [{ type: "text", text: `### Error
-Could not read ${kind} of "${params.element}": ${msg}` }], isError: true };
+        return (0, import_liveReadError.liveReadError)(e, { selector: parsed.selector, element: params.element, ambiguity: `the ${kind} read is ambiguous`, failedTo: `read ${kind} of`, pinFailure: unique.pinFailure, timeoutMs: LIVE_READ_TIMEOUT_MS });
       }
       if (passed)
         details += unique.note;
@@ -1624,6 +1629,82 @@ Could not count "${refRole}" elements: ${e.message}` }], isError: true };
 ${details}` }]
     };
   }
+  /**
+   * browser_assert type "order" (SKYR-4544): the ref's element sits left of /
+   * right of / above / below the other ref's element. A swap or a moved block
+   * is a relation between two elements, which no single-element kind can
+   * express, so both ends are resolved through the same durable-locator path
+   * as the other kinds and their live boxes compared on the relation's axis.
+   * The comparison is the one the generated test runs: each boundingBox()'s
+   * origin — the left edge (x) for left-of/right-of, the top edge (y) for
+   * above/below — compared strictly. It says where each element STARTS, not
+   * that one lies wholly beyond the other.
+   */
+  async _handleAssertOrder(params) {
+    const timestamp = Date.now();
+    const error = (text) => ({ content: [{ type: "text", text: `### Error
+${text}` }], isError: true });
+    const failed = (text) => ({ content: [{ type: "text", text: `### Assertion Failed
+${text}` }], isError: true });
+    const checked = (0, import_assertOrder.checkOrderArgs)(params);
+    if ("error" in checked)
+      return error(checked.error);
+    const { relation, otherElement } = checked;
+    const tab = this._browserBackend.context?.currentTab();
+    if (!tab)
+      return failed("No active page.");
+    const notReady = await this._requireLoadedPage(tab, "domcontentloaded");
+    if (notReady)
+      return notReady;
+    const ends = [];
+    for (const [ref, element] of [[params.ref, params.element], [params.otherRef, otherElement]]) {
+      const resolved = await this._resolveRef(ref, element);
+      if ("error" in resolved)
+        return failed(resolved.error);
+      const lineText = (0, import_snapshotLocators.snapshotLineText)(resolved.refLine) ?? "";
+      const unique = await this._makeUnique(resolved.parsed, { snapLines: resolved.snapLines, ref, element, lineText, exact: false });
+      if (unique.refusal)
+        return unique.refusal;
+      ends.push({ parsed: unique.parsed, note: unique.note, pinFailure: unique.pinFailure, element, selector: unique.parsed.selector });
+    }
+    const [a, b] = ends;
+    if (a.selector === b.selector)
+      return error(`"${a.element}" and "${b.element}" resolve to the same locator (${a.selector}), so their order cannot be asserted. Use refs of two different elements.`);
+    const boxes = [];
+    for (const end of ends) {
+      let box;
+      try {
+        box = await tab.page.locator(end.selector).boundingBox({ timeout: LIVE_READ_TIMEOUT_MS });
+      } catch (e) {
+        return (0, import_liveReadError.liveReadError)(e, { selector: end.selector, element: end.element, ambiguity: "its position is ambiguous", failedTo: "read the position of", pinFailure: end.pinFailure, timeoutMs: LIVE_READ_TIMEOUT_MS });
+      }
+      if (!box)
+        return failed(`"${end.element}" (${end.selector}) has no box on the page (it is not visible), so its position cannot be compared.`);
+      boxes.push(box);
+    }
+    const [boxA, boxB] = boxes;
+    const nested = (0, import_assertOrder.containmentError)(a, b, boxA, boxB);
+    if (nested)
+      return error(nested);
+    const { result, details } = (0, import_assertOrder.describeOrderResult)(relation, a, b, boxA, boxB);
+    if (!result.ok)
+      return { content: [{ type: "text", text: `### Assertion Failed
+${details}` }] };
+    const args = {
+      type: "order",
+      ref: params.ref,
+      selector: a.selector,
+      locator: a.parsed.locator,
+      otherRef: params.otherRef,
+      otherSelector: b.selector,
+      otherLocator: b.parsed.locator,
+      relation
+    };
+    this._trackedActions.push({ toolName: "browser_assert", args, code: `assertOrder:${a.selector}:${relation}:${b.selector}`, timestamp, pageAlias: this._currentPageAlias });
+    traceDebug(`Assert: assertOrder ${a.selector} ${relation} ${b.selector}`);
+    return { content: [{ type: "text", text: `### Assertion Passed
+${details}${a.note}${b.note}` }] };
+  }
   /**
    * Handle browser_assert_table_cell by resolving the cell from (row, column),
    * reading its value directly from the page, and recording an assertTableCell
@@ -1838,10 +1919,9 @@ ${text}` }], isError: true });
     try {
       await tab.page.locator(selector).waitFor({ state: "hidden", timeout: TraceRecordingBackend.HIDDEN_WAIT_TIMEOUT_MS });
     } catch (e) {
-      if (/strict mode violation/i.test(String(e?.message ?? "")))
-        return err(`Target ${selector} matches multiple elements, so toBeHidden() would fail strict mode. Use a more specific target (a data-testid, or role + exact name). ${String(e.message).split("\n")[0]}`);
-      if (e?.name !== "TimeoutError")
-        return err(`Could not verify absence of "${params.element}": ${e?.message ?? e}`);
+      const error = (0, import_liveReadError.liveReadError)(e, { selector, element: params.element, ambiguity: "toBeHidden() would fail strict mode", failedTo: "verify absence of" });
+      if (error)
+        return error;
       passed = false;
     }
     let details;

package/node_modules/playwright/lib/mcp/test/skyRampExport.js

@@ -509,6 +509,16 @@ function assertActionToJsonl(action, pageGuid, timestamp) {
         return null;
       return JSON.stringify({ name: "assertAttribute", selector, attrName, attrValue: expected, locator, ...base });
     }
+    // SKYR-4544: where the element sits relative to another one — a
+    // boundingBox() comparison downstream. Both ends and the relation are
+    // needed; a line missing any of them is dropped (reported as skipped).
+    case "order": {
+      const fields = (0, import_utils.parseOrderFields)({ ...args, selector });
+      if (!fields)
+        return null;
+      const otherLocator = fields.otherLocator ?? selectorToLocator(fields.otherSelector);
+      return JSON.stringify({ name: "assertOrder", selector, otherSelector: fields.otherSelector, relation: fields.relation, locator, otherLocator, ...base });
+    }
     default:
       return null;
   }

package/node_modules/playwright/node_modules/playwright-core/lib/server/codegen/skyramp/jsonlReader.js

@@ -137,6 +137,7 @@ const _ACTION_NAMES = /* @__PURE__ */ new Set([
   "assertCSS",
   "assertClass",
   "assertAttribute",
+  "assertOrder",
   "dragTo",
   "diagramNodeAdd",
   "diagramLinkAdd",

package/node_modules/playwright/node_modules/playwright-core/lib/server/recorder/recorderRunner.js

@@ -196,6 +196,28 @@ async function performActionImpl(progress, mainFrame, actionInContext) {
     });
     return;
   }
+  if (raw.name === "assertOrder") {
+    const fields = (0, import_utils.parseOrderFields)(raw);
+    if (!fields)
+      throw new Error(`assertOrder failed: trace line needs "otherSelector" and a relation of ${import_utils.ORDER_RELATIONS.join("/")}, got ${JSON.stringify(raw.relation)}`);
+    const otherSelector = (0, import_recorderUtils.buildFullSelector)(actionInContext.frame.framePath, fields.otherSelector);
+    const box = async (s) => {
+      const handle = await mainFrame.waitForSelector(progress, s, false, { strict: true, state: "visible" });
+      try {
+        const rect = await handle?.boundingBox();
+        if (!rect)
+          throw new Error(`assertOrder: ${s} has no box on the page`);
+        return rect;
+      } finally {
+        handle?.dispose();
+      }
+    };
+    const [a, b] = [await box(selector), await box(otherSelector)];
+    const { ok, axis, edgeA, edgeB } = (0, import_utils.orderHolds)(fields.relation, a, b);
+    if (!ok)
+      throw new Error(`assertOrder failed: expected ${selector} ${fields.relation} ${otherSelector}, got ${axis} ${edgeA} vs ${edgeB}`);
+    return;
+  }
   throw new Error("Internal error: unexpected action " + action.name);
 }
 function toClickOptions(action) {

package/node_modules/playwright/node_modules/playwright-core/lib/utils/isomorphic/elementOrder.js

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var elementOrder_exports = {};
+__export(elementOrder_exports, {
+  ORDER_RELATIONS: () => ORDER_RELATIONS,
+  isOrderRelation: () => isOrderRelation,
+  orderHolds: () => orderHolds,
+  parseOrderFields: () => parseOrderFields
+});
+module.exports = __toCommonJS(elementOrder_exports);
+const ORDER_RELATIONS = ["left-of", "right-of", "above", "below"];
+function isOrderRelation(value) {
+  return typeof value === "string" && ORDER_RELATIONS.includes(value);
+}
+function orderHolds(relation, a, b) {
+  const axis = relation === "left-of" || relation === "right-of" ? "x" : "y";
+  const edgeA = a[axis];
+  const edgeB = b[axis];
+  const ok = relation === "left-of" || relation === "above" ? edgeA < edgeB : edgeA > edgeB;
+  return { ok, axis, edgeA, edgeB };
+}
+function parseOrderFields(raw) {
+  if (!raw || typeof raw !== "object")
+    return null;
+  const { selector, otherSelector, relation, locator, otherLocator } = raw;
+  if (typeof selector !== "string" || !selector || typeof otherSelector !== "string" || !otherSelector || !isOrderRelation(relation))
+    return null;
+  const fields = { selector, otherSelector, relation };
+  if (locator && typeof locator === "object")
+    fields.locator = locator;
+  if (otherLocator && typeof otherLocator === "object")
+    fields.otherLocator = otherLocator;
+  return fields;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ORDER_RELATIONS,
+  isOrderRelation,
+  orderHolds,
+  parseOrderFields
+});

package/node_modules/playwright/node_modules/playwright-core/lib/utils.js

@@ -25,6 +25,7 @@ module.exports = __toCommonJS(utils_exports);
 __reExport(utils_exports, require("./utils/isomorphic/ariaSnapshot"), module.exports);
 __reExport(utils_exports, require("./utils/isomorphic/assert"), module.exports);
 __reExport(utils_exports, require("./utils/isomorphic/colors"), module.exports);
+__reExport(utils_exports, require("./utils/isomorphic/elementOrder"), module.exports);
 __reExport(utils_exports, require("./utils/isomorphic/headers"), module.exports);
 __reExport(utils_exports, require("./utils/isomorphic/locatorGenerators"), module.exports);
 __reExport(utils_exports, require("./utils/isomorphic/locatorParser"), module.exports);
@@ -72,6 +73,7 @@ var import_utilsBundle = require("./utilsBundle");
   ...require("./utils/isomorphic/ariaSnapshot"),
   ...require("./utils/isomorphic/assert"),
   ...require("./utils/isomorphic/colors"),
+  ...require("./utils/isomorphic/elementOrder"),
   ...require("./utils/isomorphic/headers"),
   ...require("./utils/isomorphic/locatorGenerators"),
   ...require("./utils/isomorphic/locatorParser"),

package/node_modules/playwright/node_modules/playwright-core/lib/vite/traceViewer/{index.uiPTFncY.js → index.0MJW0uG7.js}

@@ -1,2 +1,2 @@
-import{T as x,r,a as C,W as F,j as e,D as z,b as I,c as P,d as A,e as O,f as V}from"./assets/defaultSettingsView-DTp2-8Si.js";const $=()=>{const[o,c]=r.useState(!1),[n,l]=r.useState(),[h,u]=r.useState(),[p,b]=r.useState(N),[f,j]=r.useState({done:0,total:0}),[k,v]=r.useState(!1),[y,m]=r.useState(null),[T,R]=r.useState(null),[U,E]=r.useState(!1),g=r.useCallback(t=>{const s=new URL(window.location.href);if(!t.length)return;const i=t.item(0),a=URL.createObjectURL(i);s.searchParams.append("trace",a);const d=s.toString();window.history.pushState({},"",d),l(a),u(i.name),v(!1),m(null)},[]);r.useEffect(()=>{const t=async s=>{var a;if(!((a=s.clipboardData)!=null&&a.files.length))return;const i=["application/zip","application/x-zip-compressed"];for(const d of s.clipboardData.files)if(!i.includes(d.type))return;s.preventDefault(),g(s.clipboardData.files)};return document.addEventListener("paste",t),()=>document.removeEventListener("paste",t)}),r.useEffect(()=>{const t=s=>{const{method:i,params:a}=s.data;if(i!=="load"||!((a==null?void 0:a.trace)instanceof Blob))return;const d=new File([a.trace],"trace.zip",{type:"application/zip"}),w=new DataTransfer;w.items.add(d),g(w.files)};return window.addEventListener("message",t),()=>window.removeEventListener("message",t)});const W=r.useCallback(t=>{t.preventDefault(),g(t.dataTransfer.files)},[g]),M=r.useCallback(t=>{t.preventDefault(),t.target.files&&g(t.target.files)},[g]);r.useEffect(()=>{const t=new URL(window.location.href).searchParams,s=t.get("trace");if(c(t.has("isServer")),s!=null&&s.startsWith("file:")){R(s||null);return}if(t.has("isServer")){const i=new URLSearchParams(window.location.search).get("ws"),a=new URL(`../${i}`,window.location.toString());a.protocol=window.location.protocol==="https:"?"wss:":"ws:";const d=new C(new F(a));d.onLoadTraceRequested(async w=>{l(w.traceUrl),v(!1),m(null)}),d.initialize({}).catch(()=>{})}else s&&!s.startsWith("blob:")&&l(s)},[]);const S=r.useCallback(async t=>{const s=new URLSearchParams;s.set("trace",t);const i=await fetch(`contexts?${s.toString()}`);if(!i.ok){const{error:w}=await i.json();return m(w),w}const a=await i.json(),d=new x(t,a);j({done:0,total:0}),m(null),b(d)},[]);r.useEffect(()=>{(async()=>{if(!n){b(N);return}const t=s=>{s.data.method==="progress"&&j(s.data.params)};try{navigator.serviceWorker.addEventListener("message",t),j({done:0,total:1});let s=await S(n);s!=null&&s.includes("please grant permission for Local Network Access")&&(await fetch(n,{method:"HEAD",headers:{"x-pw-serviceworker":"skip"}}),s=await S(n)),s&&(o||l(void 0))}finally{navigator.serviceWorker.removeEventListener("message",t)}})()},[o,n,h,S]);const D=f.done!==f.total&&f.total!==0&&!y;r.useEffect(()=>{if(D){const t=setTimeout(()=>{E(!0)},200);return()=>clearTimeout(t)}else E(!1)},[D]);const L=!!(!o&&!k&&!T&&(!n||y));return e.jsxs("div",{className:"vbox workbench-loader",onDragOver:t=>{t.preventDefault(),t.dataTransfer.types.includes("Files")&&v(!0)},children:[e.jsxs("div",{className:"hbox header",...L?{inert:!0}:{},children:[e.jsx("div",{className:"logo",children:e.jsx("img",{src:"playwright-logo.svg",alt:"Playwright logo"})}),e.jsx("div",{className:"product",children:"Playwright"}),p.title&&e.jsx("div",{className:"title",children:p.title}),e.jsx("div",{className:"spacer"}),e.jsx(z,{icon:"settings-gear",title:"Settings",dialogDataTestId:"settings-toolbar-dialog",children:e.jsx(I,{location:"trace-viewer"})})]}),e.jsx(P,{model:p,inert:L}),T&&e.jsxs("div",{className:"drop-target",children:[e.jsx("div",{children:"Trace Viewer uses Service Workers to show traces. To view trace:"}),e.jsxs("div",{style:{paddingTop:20},children:[e.jsxs("div",{children:["1. Click ",e.jsx("a",{href:T,children:"here"})," to put your trace into the download shelf"]}),e.jsxs("div",{children:["2. Go to ",e.jsx("a",{href:"https://trace.playwright.dev",children:"trace.playwright.dev"})]}),e.jsx("div",{children:"3. Drop the trace from the download shelf into the page"})]})]}),e.jsx(A,{open:U,isModal:!0,className:"progress-dialog",children:e.jsxs("div",{className:"progress-content",children:[e.jsx("div",{className:"title",role:"heading","aria-level":1,children:"Loading Playwright Trace..."}),e.jsx("div",{className:"progress-wrapper",children:e.jsx("div",{className:"inner-progress",style:{width:f.total?100*f.done/f.total+"%":0}})})]})}),L&&e.jsxs("div",{className:"drop-target",children:[e.jsx("div",{className:"processing-error",role:"alert",children:y}),e.jsx("div",{className:"title",role:"heading","aria-level":1,children:"Drop Playwright Trace to load"}),e.jsx("div",{children:"or"}),e.jsx("button",{onClick:()=>{const t=document.createElement("input");t.type="file",t.click(),t.addEventListener("change",s=>M(s))},type:"button",children:"Select file"}),e.jsx("div",{className:"info",children:"Playwright Trace Viewer is a Progressive Web App, it does not send your trace anywhere, it opens it locally."}),e.jsxs("div",{className:"version",children:["Playwright v","1.58.2-skyramp.8.14.13"]})]}),o&&!n&&e.jsx("div",{className:"drop-target",children:e.jsx("div",{className:"title",children:"Select test to see the trace"})}),k&&e.jsx("div",{className:"drop-target",onDragLeave:()=>{v(!1)},onDrop:t=>W(t),children:e.jsx("div",{className:"title",children:"Release to analyse the Playwright Trace"})})]})},N=new x("",[]),q=({traceJson:o})=>{const[c,n]=r.useState(void 0),[l,h]=r.useState(0),u=r.useRef(null);return r.useEffect(()=>(u.current&&clearTimeout(u.current),u.current=setTimeout(async()=>{try{const p=await B(o);n(p)}catch{const p=new x("",[]);n(p)}finally{h(l+1)}},500),()=>{u.current&&clearTimeout(u.current)}),[o,l]),e.jsx(P,{isLive:!0,model:c})};async function B(o){const c=new URLSearchParams;c.set("trace",o);const l=await(await fetch(`contexts?${c.toString()}`)).json();return new x(o,l)}(async()=>{const o=new URLSearchParams(window.location.search);if(O(),window.location.protocol!=="file:"){if(o.get("isUnderTest")==="true"&&await new Promise(h=>setTimeout(h,1e3)),!navigator.serviceWorker)throw new Error(`Service workers are not supported.
+import{T as x,r,a as C,W as F,j as e,D as z,b as I,c as P,d as A,e as O,f as V}from"./assets/defaultSettingsView-DTp2-8Si.js";const $=()=>{const[o,c]=r.useState(!1),[n,l]=r.useState(),[h,u]=r.useState(),[p,b]=r.useState(N),[f,j]=r.useState({done:0,total:0}),[k,v]=r.useState(!1),[y,m]=r.useState(null),[T,R]=r.useState(null),[U,E]=r.useState(!1),g=r.useCallback(t=>{const s=new URL(window.location.href);if(!t.length)return;const i=t.item(0),a=URL.createObjectURL(i);s.searchParams.append("trace",a);const d=s.toString();window.history.pushState({},"",d),l(a),u(i.name),v(!1),m(null)},[]);r.useEffect(()=>{const t=async s=>{var a;if(!((a=s.clipboardData)!=null&&a.files.length))return;const i=["application/zip","application/x-zip-compressed"];for(const d of s.clipboardData.files)if(!i.includes(d.type))return;s.preventDefault(),g(s.clipboardData.files)};return document.addEventListener("paste",t),()=>document.removeEventListener("paste",t)}),r.useEffect(()=>{const t=s=>{const{method:i,params:a}=s.data;if(i!=="load"||!((a==null?void 0:a.trace)instanceof Blob))return;const d=new File([a.trace],"trace.zip",{type:"application/zip"}),w=new DataTransfer;w.items.add(d),g(w.files)};return window.addEventListener("message",t),()=>window.removeEventListener("message",t)});const W=r.useCallback(t=>{t.preventDefault(),g(t.dataTransfer.files)},[g]),M=r.useCallback(t=>{t.preventDefault(),t.target.files&&g(t.target.files)},[g]);r.useEffect(()=>{const t=new URL(window.location.href).searchParams,s=t.get("trace");if(c(t.has("isServer")),s!=null&&s.startsWith("file:")){R(s||null);return}if(t.has("isServer")){const i=new URLSearchParams(window.location.search).get("ws"),a=new URL(`../${i}`,window.location.toString());a.protocol=window.location.protocol==="https:"?"wss:":"ws:";const d=new C(new F(a));d.onLoadTraceRequested(async w=>{l(w.traceUrl),v(!1),m(null)}),d.initialize({}).catch(()=>{})}else s&&!s.startsWith("blob:")&&l(s)},[]);const S=r.useCallback(async t=>{const s=new URLSearchParams;s.set("trace",t);const i=await fetch(`contexts?${s.toString()}`);if(!i.ok){const{error:w}=await i.json();return m(w),w}const a=await i.json(),d=new x(t,a);j({done:0,total:0}),m(null),b(d)},[]);r.useEffect(()=>{(async()=>{if(!n){b(N);return}const t=s=>{s.data.method==="progress"&&j(s.data.params)};try{navigator.serviceWorker.addEventListener("message",t),j({done:0,total:1});let s=await S(n);s!=null&&s.includes("please grant permission for Local Network Access")&&(await fetch(n,{method:"HEAD",headers:{"x-pw-serviceworker":"skip"}}),s=await S(n)),s&&(o||l(void 0))}finally{navigator.serviceWorker.removeEventListener("message",t)}})()},[o,n,h,S]);const D=f.done!==f.total&&f.total!==0&&!y;r.useEffect(()=>{if(D){const t=setTimeout(()=>{E(!0)},200);return()=>clearTimeout(t)}else E(!1)},[D]);const L=!!(!o&&!k&&!T&&(!n||y));return e.jsxs("div",{className:"vbox workbench-loader",onDragOver:t=>{t.preventDefault(),t.dataTransfer.types.includes("Files")&&v(!0)},children:[e.jsxs("div",{className:"hbox header",...L?{inert:!0}:{},children:[e.jsx("div",{className:"logo",children:e.jsx("img",{src:"playwright-logo.svg",alt:"Playwright logo"})}),e.jsx("div",{className:"product",children:"Playwright"}),p.title&&e.jsx("div",{className:"title",children:p.title}),e.jsx("div",{className:"spacer"}),e.jsx(z,{icon:"settings-gear",title:"Settings",dialogDataTestId:"settings-toolbar-dialog",children:e.jsx(I,{location:"trace-viewer"})})]}),e.jsx(P,{model:p,inert:L}),T&&e.jsxs("div",{className:"drop-target",children:[e.jsx("div",{children:"Trace Viewer uses Service Workers to show traces. To view trace:"}),e.jsxs("div",{style:{paddingTop:20},children:[e.jsxs("div",{children:["1. Click ",e.jsx("a",{href:T,children:"here"})," to put your trace into the download shelf"]}),e.jsxs("div",{children:["2. Go to ",e.jsx("a",{href:"https://trace.playwright.dev",children:"trace.playwright.dev"})]}),e.jsx("div",{children:"3. Drop the trace from the download shelf into the page"})]})]}),e.jsx(A,{open:U,isModal:!0,className:"progress-dialog",children:e.jsxs("div",{className:"progress-content",children:[e.jsx("div",{className:"title",role:"heading","aria-level":1,children:"Loading Playwright Trace..."}),e.jsx("div",{className:"progress-wrapper",children:e.jsx("div",{className:"inner-progress",style:{width:f.total?100*f.done/f.total+"%":0}})})]})}),L&&e.jsxs("div",{className:"drop-target",children:[e.jsx("div",{className:"processing-error",role:"alert",children:y}),e.jsx("div",{className:"title",role:"heading","aria-level":1,children:"Drop Playwright Trace to load"}),e.jsx("div",{children:"or"}),e.jsx("button",{onClick:()=>{const t=document.createElement("input");t.type="file",t.click(),t.addEventListener("change",s=>M(s))},type:"button",children:"Select file"}),e.jsx("div",{className:"info",children:"Playwright Trace Viewer is a Progressive Web App, it does not send your trace anywhere, it opens it locally."}),e.jsxs("div",{className:"version",children:["Playwright v","1.58.2-skyramp.8.14.14"]})]}),o&&!n&&e.jsx("div",{className:"drop-target",children:e.jsx("div",{className:"title",children:"Select test to see the trace"})}),k&&e.jsx("div",{className:"drop-target",onDragLeave:()=>{v(!1)},onDrop:t=>W(t),children:e.jsx("div",{className:"title",children:"Release to analyse the Playwright Trace"})})]})},N=new x("",[]),q=({traceJson:o})=>{const[c,n]=r.useState(void 0),[l,h]=r.useState(0),u=r.useRef(null);return r.useEffect(()=>(u.current&&clearTimeout(u.current),u.current=setTimeout(async()=>{try{const p=await B(o);n(p)}catch{const p=new x("",[]);n(p)}finally{h(l+1)}},500),()=>{u.current&&clearTimeout(u.current)}),[o,l]),e.jsx(P,{isLive:!0,model:c})};async function B(o){const c=new URLSearchParams;c.set("trace",o);const l=await(await fetch(`contexts?${c.toString()}`)).json();return new x(o,l)}(async()=>{const o=new URLSearchParams(window.location.search);if(O(),window.location.protocol!=="file:"){if(o.get("isUnderTest")==="true"&&await new Promise(h=>setTimeout(h,1e3)),!navigator.serviceWorker)throw new Error(`Service workers are not supported.
 Make sure to serve the Trace Viewer (${window.location}) via HTTPS or localhost.`);navigator.serviceWorker.register("sw.bundle.js"),navigator.serviceWorker.controller||await new Promise(h=>{navigator.serviceWorker.oncontrollerchange=()=>h()}),setInterval(function(){fetch("ping")},1e4)}const c=o.get("trace"),l=(c==null?void 0:c.endsWith(".json"))?e.jsx(q,{traceJson:c}):e.jsx($,{});V.createRoot(document.querySelector("#root")).render(l)})();

package/node_modules/playwright/node_modules/playwright-core/lib/vite/traceViewer/index.html

@@ -7,7 +7,7 @@
     <link rel="icon" href="./playwright-logo.svg" type="image/svg+xml">
     <link rel="manifest" href="./manifest.webmanifest">
     <title>Playwright Trace Viewer</title>
-    <script type="module" crossorigin src="./index.uiPTFncY.js"></script>
+    <script type="module" crossorigin src="./index.0MJW0uG7.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/defaultSettingsView-DTp2-8Si.js">
     <link rel="stylesheet" crossorigin href="./defaultSettingsView.7ch9cixO.css">
     <link rel="stylesheet" crossorigin href="./index.BVu7tZDe.css">

package/node_modules/playwright/node_modules/playwright-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright-core",
-  "version": "1.58.2-skyramp.8.14.13",
+  "version": "1.58.2-skyramp.8.14.14",
   "description": "A high-level API to automate web browsers",
   "repository": {
     "type": "git",

package/node_modules/playwright/node_modules/playwright-core/src/server/codegen/skyramp/jsonlReader.ts

@@ -118,7 +118,7 @@ const _ACTION_NAMES = new Set<string>([
   'navigate', 'openPage', 'press', 'select', 'uncheck',
   'setInputFiles', 'assertText', 'assertValue', 'assertChecked',
   'assertVisible', 'assertDisabled', 'assertCount', 'assertHidden', 'assertSnapshot', 'visualSnapshot', 'assertTableCell',
-  'assertCSS', 'assertClass', 'assertAttribute',
+  'assertCSS', 'assertClass', 'assertAttribute', 'assertOrder',
   'dragTo', 'diagramNodeAdd', 'diagramLinkAdd', 'selectArea', 'tableSnapshot', 'domSnapshot', 'fileChooser',
   'penTool', 'mouse.wheel', 'mouse.move', 'mouse.down', 'mouse.up',
   'modalOpen', 'modalClose', 'waitForTimeout', 'evaluate',

package/node_modules/playwright/node_modules/playwright-core/src/server/recorder/recorderRunner.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { escapeRegExp, serializeExpectedTextValues } from '../../utils';
+import { escapeRegExp, ORDER_RELATIONS, orderHolds, parseOrderFields, serializeExpectedTextValues } from '../../utils';
 import { toKeyboardModifiers } from '../codegen/language';
 import { buildFullSelector, mainFrameForAction } from './recorderUtils';
 import { Progress, ProgressController } from '../progress';
@@ -240,6 +240,31 @@ async function performActionImpl(progress: Progress, mainFrame: Frame, actionInC
     return;
   }
 
+  if (raw.name === 'assertOrder') {
+    // SKYR-4544: the order contract (utils/isomorphic/elementOrder) the MCP
+    // recorder and replay use too; both ends must be visible first.
+    const fields = parseOrderFields(raw);
+    if (!fields)
+      throw new Error(`assertOrder failed: trace line needs "otherSelector" and a relation of ${ORDER_RELATIONS.join('/')}, got ${JSON.stringify(raw.relation)}`);
+    const otherSelector = buildFullSelector(actionInContext.frame.framePath, fields.otherSelector);
+    const box = async (s: string) => {
+      const handle = await mainFrame.waitForSelector(progress, s, false, { strict: true, state: 'visible' });
+      try {
+        const rect = await handle?.boundingBox();
+        if (!rect)
+          throw new Error(`assertOrder: ${s} has no box on the page`);
+        return rect;
+      } finally {
+        handle?.dispose();
+      }
+    };
+    const [a, b] = [await box(selector), await box(otherSelector)];
+    const { ok, axis, edgeA, edgeB } = orderHolds(fields.relation, a, b);
+    if (!ok)
+      throw new Error(`assertOrder failed: expected ${selector} ${fields.relation} ${otherSelector}, got ${axis} ${edgeA} vs ${edgeB}`);
+    return;
+  }
+
   throw new Error('Internal error: unexpected action ' + (action as any).name);
 }