@riddledc/riddle-proof 0.7.34 → 0.7.36

package/README.md

@@ -202,6 +202,21 @@ clears `local`, `session`, or `both` browser storage scopes, defaults to
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`
 still overrides the profile value for one-off runs.
 
+Use `selector_text_order` when a table, list, or card group must show visible
+items in a specific order after setup actions such as sorting or filtering:
+
+```json
+{
+  "type": "selector_text_order",
+  "selector": ".game-table tbody tr",
+  "expected_texts": ["AAA Alpha", "MMM Middle", "ZZZ Omega"]
+}
+```
+
+The check records the visible text sequence for the selector and passes when
+the expected texts appear in that order as a subsequence. This is less brittle
+than matching one large body-text regex when only row or card order matters.
+
 Use the `route_inventory` check for source-page route coverage audits where a
 navigation surface must expose a known set of routes and each route must load
 both directly and through real link clicks:
@@ -225,7 +240,9 @@ source-link counts, missing/unexpected routes, direct route health, real
 clickthrough health, wrong-path failures, and stale source-surface failures. It
 runs direct/clickthrough sweeps on the first viewport by default and leaves
 ordinary profile overflow checks to cover the source page across all configured
-viewports. Set `run_direct_routes: false`, `run_clickthroughs: false`,
+viewports. Set `run_all_viewports: true` when desktop and mobile navigation
+surfaces both need direct/clickthrough inventory evidence in one profile result.
+Set `run_direct_routes: false`, `run_clickthroughs: false`,
 `allow_unexpected_routes: true`, `require_unique_routes: false`, or
 `save_route_screenshots: true` when a profile needs a narrower or more
 artifact-heavy audit. `require_unique_routes: false` is useful when a navigation

package/dist/{chunk-PWGJQLOS.js → chunk-VEK6QHPE.js}

@@ -14,6 +14,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "selector_visible",
   "selector_count_at_least",
+  "selector_text_order",
   "text_visible",
   "text_absent",
   "route_inventory",
@@ -293,6 +294,15 @@ function normalizeRouteInventoryRoutes(value, index) {
   }
   return routes;
 }
+function normalizeExpectedTexts(value, index) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error(`checks[${index}] selector_text_order expected_texts must be a non-empty array.`);
+  }
+  const texts = value.map((item) => String(item).replace(/\s+/g, " ").trim()).filter(Boolean);
+  if (!texts.length) throw new Error(`checks[${index}] selector_text_order expected_texts must contain non-empty strings.`);
+  return texts;
+}
 function normalizeCheck(input, index) {
   if (!isRecord(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue(input.type);
@@ -309,6 +319,11 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
+  if (type === "selector_text_order") {
+    if (!stringValue(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
+    if (!expectedTexts?.length) throw new Error(`checks[${index}] selector_text_order requires expected_texts.`);
+  }
   const expectedRoutes = normalizeRouteInventoryRoutes(input.expected_routes ?? input.expectedRoutes, index);
   if (type === "route_inventory" && !expectedRoutes?.length) {
     throw new Error(`checks[${index}] route_inventory requires expected_routes.`);
@@ -319,6 +334,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue(input.expected_path),
     expected_routes: expectedRoutes,
     selector: stringValue(input.selector),
+    expected_texts: expectedTexts,
     link_selector: stringValue(input.link_selector) || stringValue(input.linkSelector),
     source_selector: stringValue(input.source_selector) || stringValue(input.sourceSelector),
     route_path_prefix: stringValue(input.route_path_prefix) || stringValue(input.routePathPrefix),
@@ -334,6 +350,7 @@ function normalizeCheck(input, index) {
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
     run_clickthroughs: input.run_clickthroughs === false || input.runClickthroughs === false ? false : true,
+    run_all_viewports: input.run_all_viewports === true || input.runAllViewports === true,
     require_unique_routes: input.require_unique_routes === false || input.requireUniqueRoutes === false ? false : true,
     allow_unexpected_routes: input.allow_unexpected_routes === true || input.allowUnexpectedRoutes === true,
     save_route_screenshots: input.save_route_screenshots === true || input.saveRouteScreenshots === true
@@ -424,6 +441,47 @@ function selectorKey(check) {
 function textKey(check) {
   return check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : `text:${check.text || ""}`;
 }
+function textSequenceForCheck(viewport, check) {
+  const key = selectorKey(check);
+  const sequence = viewport.text_sequences?.[key];
+  if (isRecord(sequence)) {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text).replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
+function summarizeRouteInventory(viewport, inventory) {
+  const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
+  const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
+  const sourceLinkCount = numberValue(inventory.source_link_count) ?? numberValue(inventory.home_game_link_count) ?? null;
+  const sourceUniqueLinkCount = numberValue(inventory.source_unique_link_count) ?? numberValue(inventory.home_unique_game_link_count) ?? null;
+  const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
+  const duplicateSourceLinkCount = numberValue(inventory.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
+  const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
+  return {
+    viewport,
+    source_link_count: sourceLinkCount,
+    source_unique_link_count: sourceUniqueLinkCount,
+    duplicate_source_link_count: duplicateSourceLinkCount,
+    duplicate_source_links: duplicateSourceLinks,
+    direct_route_count: directRoutes.length,
+    clickthrough_count: clickthroughs.length,
+    failure_count: failures.length
+  };
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -543,6 +601,32 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_text_order") {
+    const key = selectorKey(check);
+    const expectedTexts = check.expected_texts || [];
+    const results = viewports.map((viewport) => {
+      const texts = textSequenceForCheck(viewport, check);
+      const match = textOrderMatch(texts, expectedTexts);
+      return {
+        viewport: viewport.name,
+        matched: match.matched,
+        matched_positions: match.positions,
+        visible_texts: texts.slice(0, 20)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_texts: expectedTexts,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Selector ${key} text order failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
@@ -574,6 +658,7 @@ function assessCheckFromEvidence(check, evidence) {
         message: "No route inventory evidence was captured."
       };
     }
+    const viewportSummaries = inventories.map((item) => summarizeRouteInventory(item.viewport, item.inventory));
     const failures = inventories.flatMap((item) => Array.isArray(item.inventory?.failures) ? item.inventory.failures.map((failure) => toJsonValue({ viewport: item.viewport, failure })) : []);
     const first = inventories[0]?.inventory;
     const directRoutes = Array.isArray(first?.direct_routes) ? first.direct_routes : [];
@@ -597,6 +682,8 @@ function assessCheckFromEvidence(check, evidence) {
         homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? sourceUniqueLinkCount,
         direct_route_count: directRoutes.length,
         clickthrough_count: clickthroughs.length,
+        viewport_count: inventories.length,
+        viewports: viewportSummaries.map((summary) => toJsonValue(summary)),
         failures
       },
       message: failures.length ? `Route inventory failed with ${failures.length} issue(s).` : void 0
@@ -893,6 +980,47 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function textSequenceForCheck(viewport, check) {
+  const key = check.selector || "";
+  const sequence = viewport.text_sequences && viewport.text_sequences[key];
+  if (sequence && typeof sequence === "object") {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text || "").replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts || []) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
+function summarizeRouteInventory(viewport, inventory) {
+  const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
+  const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
+  const sourceLinkCount = typeof inventory.source_link_count === "number" ? inventory.source_link_count : typeof inventory.home_game_link_count === "number" ? inventory.home_game_link_count : null;
+  const sourceUniqueLinkCount = typeof inventory.source_unique_link_count === "number" ? inventory.source_unique_link_count : typeof inventory.home_unique_game_link_count === "number" ? inventory.home_unique_game_link_count : null;
+  const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
+  const duplicateSourceLinkCount = typeof inventory.duplicate_source_link_count === "number" ? inventory.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
+  const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
+  return {
+    viewport,
+    source_link_count: sourceLinkCount,
+    source_unique_link_count: sourceUniqueLinkCount,
+    duplicate_source_link_count: duplicateSourceLinkCount,
+    duplicate_source_links: duplicateSourceLinks,
+    direct_route_count: directRoutes.length,
+    clickthrough_count: clickthroughs.length,
+    failure_count: failures.length,
+  };
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -1097,6 +1225,29 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_text_order") {
+      const selector = check.selector || "";
+      const expectedTexts = check.expected_texts || [];
+      const results = viewports.map((viewport) => {
+        const texts = textSequenceForCheck(viewport, check);
+        const match = textOrderMatch(texts, expectedTexts);
+        return {
+          viewport: viewport.name,
+          matched: match.matched,
+          matched_positions: match.positions,
+          visible_texts: texts.slice(0, 20),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: { selector, expected_texts: expectedTexts, viewports: results },
+        message: failed ? "Selector " + selector + " text order failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "text_visible" || check.type === "text_absent") {
       const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
       const expectedVisible = check.type === "text_visible";
@@ -1125,6 +1276,7 @@ function assessProfile(profile, evidence) {
         });
         continue;
       }
+      const viewportSummaries = inventories.map((item) => summarizeRouteInventory(item.viewport, item.inventory || {}));
       const failures = [];
       for (const item of inventories) {
         for (const failure of Array.isArray(item.inventory.failures) ? item.inventory.failures : []) {
@@ -1153,6 +1305,8 @@ function assessProfile(profile, evidence) {
           homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : sourceUniqueLinkCount,
           direct_route_count: directRoutes.length,
           clickthrough_count: clickthroughs.length,
+          viewport_count: inventories.length,
+          viewports: viewportSummaries,
           failures,
         },
         message: failures.length ? "Route inventory failed with " + failures.length + " issue(s)." : undefined,
@@ -1470,6 +1624,27 @@ async function selectorStats(selector) {
     return { count: elements.length, visible_count: elements.filter(isVisible).length };
   }).catch((error) => ({ count: 0, visible_count: 0, error: String(error && error.message ? error.message : error).slice(0, 500) }));
 }
+async function selectorTextSequence(selector) {
+  return page.locator(selector).evaluateAll((elements) => {
+    const compact = (value) => String(value || "").replace(/\s+/g, " ").trim().slice(0, 240);
+    const isVisible = (element) => {
+      const style = window.getComputedStyle(element);
+      const rect = element.getBoundingClientRect();
+      return style && style.visibility !== "hidden" && style.display !== "none" && rect.width > 0 && rect.height > 0;
+    };
+    const rows = elements.map((element, index) => ({
+      index,
+      text: compact(element.innerText || element.textContent || ""),
+      visible: isVisible(element),
+    }));
+    return {
+      count: rows.length,
+      visible_count: rows.filter((row) => row.visible).length,
+      texts: rows.map((row) => row.text).filter(Boolean).slice(0, 40),
+      visible_texts: rows.filter((row) => row.visible).map((row) => row.text).filter(Boolean).slice(0, 40),
+    };
+  }).catch((error) => ({ count: 0, visible_count: 0, texts: [], visible_texts: [], error: String(error && error.message ? error.message : error).slice(0, 500) }));
+}
 function inventoryAppPathFromUrl(urlLike) {
   const url = new URL(String(urlLike), targetUrl);
   const mountPrefix = previewMountPrefix(new URL(targetUrl).pathname);
@@ -1867,11 +2042,16 @@ async function captureViewport(viewport) {
     evaluation_error: String(error && error.message ? error.message : error).slice(0, 1000),
   }));
   const selectors = {};
+  const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
     if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
+    if (check.type === "selector_text_order" && check.selector) {
+      selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
+      text_sequences[check.selector] = await selectorTextSequence(check.selector);
+    }
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       text_matches[textKey(check)] = textMatches(dom.body_text || dom.body_text_sample || "", check);
     }
@@ -1885,7 +2065,7 @@ async function captureViewport(viewport) {
   let routeInventory;
   const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory");
   const firstViewportName = (profile.target.viewports || [])[0] && (profile.target.viewports || [])[0].name;
-  if (routeInventoryCheck && (!firstViewportName || viewport.name === firstViewportName)) {
+  if (routeInventoryCheck && (routeInventoryCheck.run_all_viewports || !firstViewportName || viewport.name === firstViewportName)) {
     try {
       routeInventory = await collectRouteInventory(routeInventoryCheck, viewport);
     } catch (error) {
@@ -1935,6 +2115,7 @@ async function captureViewport(viewport) {
     bounds_overflow_px: dom.bounds_overflow_px,
     overflow_offenders: dom.overflow_offenders || [],
     selectors,
+    text_sequences,
     text_matches,
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,

package/dist/cli.cjs

@@ -6887,6 +6887,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "selector_visible",
   "selector_count_at_least",
+  "selector_text_order",
   "text_visible",
   "text_absent",
   "route_inventory",
@@ -7166,6 +7167,15 @@ function normalizeRouteInventoryRoutes(value, index) {
   }
   return routes;
 }
+function normalizeExpectedTexts(value, index) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error(`checks[${index}] selector_text_order expected_texts must be a non-empty array.`);
+  }
+  const texts = value.map((item) => String(item).replace(/\s+/g, " ").trim()).filter(Boolean);
+  if (!texts.length) throw new Error(`checks[${index}] selector_text_order expected_texts must contain non-empty strings.`);
+  return texts;
+}
 function normalizeCheck(input, index) {
   if (!isRecord(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue2(input.type);
@@ -7182,6 +7192,11 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
+  if (type === "selector_text_order") {
+    if (!stringValue2(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
+    if (!expectedTexts?.length) throw new Error(`checks[${index}] selector_text_order requires expected_texts.`);
+  }
   const expectedRoutes = normalizeRouteInventoryRoutes(input.expected_routes ?? input.expectedRoutes, index);
   if (type === "route_inventory" && !expectedRoutes?.length) {
     throw new Error(`checks[${index}] route_inventory requires expected_routes.`);
@@ -7192,6 +7207,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue2(input.expected_path),
     expected_routes: expectedRoutes,
     selector: stringValue2(input.selector),
+    expected_texts: expectedTexts,
     link_selector: stringValue2(input.link_selector) || stringValue2(input.linkSelector),
     source_selector: stringValue2(input.source_selector) || stringValue2(input.sourceSelector),
     route_path_prefix: stringValue2(input.route_path_prefix) || stringValue2(input.routePathPrefix),
@@ -7207,6 +7223,7 @@ function normalizeCheck(input, index) {
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
     run_clickthroughs: input.run_clickthroughs === false || input.runClickthroughs === false ? false : true,
+    run_all_viewports: input.run_all_viewports === true || input.runAllViewports === true,
     require_unique_routes: input.require_unique_routes === false || input.requireUniqueRoutes === false ? false : true,
     allow_unexpected_routes: input.allow_unexpected_routes === true || input.allowUnexpectedRoutes === true,
     save_route_screenshots: input.save_route_screenshots === true || input.saveRouteScreenshots === true
@@ -7297,6 +7314,47 @@ function selectorKey(check) {
 function textKey(check) {
   return check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : `text:${check.text || ""}`;
 }
+function textSequenceForCheck(viewport, check) {
+  const key = selectorKey(check);
+  const sequence = viewport.text_sequences?.[key];
+  if (isRecord(sequence)) {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text).replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
+function summarizeRouteInventory(viewport, inventory) {
+  const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
+  const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
+  const sourceLinkCount = numberValue(inventory.source_link_count) ?? numberValue(inventory.home_game_link_count) ?? null;
+  const sourceUniqueLinkCount = numberValue(inventory.source_unique_link_count) ?? numberValue(inventory.home_unique_game_link_count) ?? null;
+  const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path7) => String(path7)) : [];
+  const duplicateSourceLinkCount = numberValue(inventory.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
+  const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
+  return {
+    viewport,
+    source_link_count: sourceLinkCount,
+    source_unique_link_count: sourceUniqueLinkCount,
+    duplicate_source_link_count: duplicateSourceLinkCount,
+    duplicate_source_links: duplicateSourceLinks,
+    direct_route_count: directRoutes.length,
+    clickthrough_count: clickthroughs.length,
+    failure_count: failures.length
+  };
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -7416,6 +7474,32 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_text_order") {
+    const key = selectorKey(check);
+    const expectedTexts = check.expected_texts || [];
+    const results = viewports.map((viewport) => {
+      const texts = textSequenceForCheck(viewport, check);
+      const match = textOrderMatch(texts, expectedTexts);
+      return {
+        viewport: viewport.name,
+        matched: match.matched,
+        matched_positions: match.positions,
+        visible_texts: texts.slice(0, 20)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_texts: expectedTexts,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Selector ${key} text order failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
@@ -7447,6 +7531,7 @@ function assessCheckFromEvidence(check, evidence) {
         message: "No route inventory evidence was captured."
       };
     }
+    const viewportSummaries = inventories.map((item) => summarizeRouteInventory(item.viewport, item.inventory));
     const failures = inventories.flatMap((item) => Array.isArray(item.inventory?.failures) ? item.inventory.failures.map((failure) => toJsonValue({ viewport: item.viewport, failure })) : []);
     const first = inventories[0]?.inventory;
     const directRoutes = Array.isArray(first?.direct_routes) ? first.direct_routes : [];
@@ -7470,6 +7555,8 @@ function assessCheckFromEvidence(check, evidence) {
         homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? sourceUniqueLinkCount,
         direct_route_count: directRoutes.length,
         clickthrough_count: clickthroughs.length,
+        viewport_count: inventories.length,
+        viewports: viewportSummaries.map((summary) => toJsonValue(summary)),
         failures
       },
       message: failures.length ? `Route inventory failed with ${failures.length} issue(s).` : void 0
@@ -7750,6 +7837,47 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function textSequenceForCheck(viewport, check) {
+  const key = check.selector || "";
+  const sequence = viewport.text_sequences && viewport.text_sequences[key];
+  if (sequence && typeof sequence === "object") {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text || "").replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts || []) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
+function summarizeRouteInventory(viewport, inventory) {
+  const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
+  const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
+  const sourceLinkCount = typeof inventory.source_link_count === "number" ? inventory.source_link_count : typeof inventory.home_game_link_count === "number" ? inventory.home_game_link_count : null;
+  const sourceUniqueLinkCount = typeof inventory.source_unique_link_count === "number" ? inventory.source_unique_link_count : typeof inventory.home_unique_game_link_count === "number" ? inventory.home_unique_game_link_count : null;
+  const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
+  const duplicateSourceLinkCount = typeof inventory.duplicate_source_link_count === "number" ? inventory.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
+  const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
+  return {
+    viewport,
+    source_link_count: sourceLinkCount,
+    source_unique_link_count: sourceUniqueLinkCount,
+    duplicate_source_link_count: duplicateSourceLinkCount,
+    duplicate_source_links: duplicateSourceLinks,
+    direct_route_count: directRoutes.length,
+    clickthrough_count: clickthroughs.length,
+    failure_count: failures.length,
+  };
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -7954,6 +8082,29 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_text_order") {
+      const selector = check.selector || "";
+      const expectedTexts = check.expected_texts || [];
+      const results = viewports.map((viewport) => {
+        const texts = textSequenceForCheck(viewport, check);
+        const match = textOrderMatch(texts, expectedTexts);
+        return {
+          viewport: viewport.name,
+          matched: match.matched,
+          matched_positions: match.positions,
+          visible_texts: texts.slice(0, 20),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: { selector, expected_texts: expectedTexts, viewports: results },
+        message: failed ? "Selector " + selector + " text order failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "text_visible" || check.type === "text_absent") {
       const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
       const expectedVisible = check.type === "text_visible";
@@ -7982,6 +8133,7 @@ function assessProfile(profile, evidence) {
         });
         continue;
       }
+      const viewportSummaries = inventories.map((item) => summarizeRouteInventory(item.viewport, item.inventory || {}));
       const failures = [];
       for (const item of inventories) {
         for (const failure of Array.isArray(item.inventory.failures) ? item.inventory.failures : []) {
@@ -8010,6 +8162,8 @@ function assessProfile(profile, evidence) {
           homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : sourceUniqueLinkCount,
           direct_route_count: directRoutes.length,
           clickthrough_count: clickthroughs.length,
+          viewport_count: inventories.length,
+          viewports: viewportSummaries,
           failures,
         },
         message: failures.length ? "Route inventory failed with " + failures.length + " issue(s)." : undefined,
@@ -8327,6 +8481,27 @@ async function selectorStats(selector) {
     return { count: elements.length, visible_count: elements.filter(isVisible).length };
   }).catch((error) => ({ count: 0, visible_count: 0, error: String(error && error.message ? error.message : error).slice(0, 500) }));
 }
+async function selectorTextSequence(selector) {
+  return page.locator(selector).evaluateAll((elements) => {
+    const compact = (value) => String(value || "").replace(/\s+/g, " ").trim().slice(0, 240);
+    const isVisible = (element) => {
+      const style = window.getComputedStyle(element);
+      const rect = element.getBoundingClientRect();
+      return style && style.visibility !== "hidden" && style.display !== "none" && rect.width > 0 && rect.height > 0;
+    };
+    const rows = elements.map((element, index) => ({
+      index,
+      text: compact(element.innerText || element.textContent || ""),
+      visible: isVisible(element),
+    }));
+    return {
+      count: rows.length,
+      visible_count: rows.filter((row) => row.visible).length,
+      texts: rows.map((row) => row.text).filter(Boolean).slice(0, 40),
+      visible_texts: rows.filter((row) => row.visible).map((row) => row.text).filter(Boolean).slice(0, 40),
+    };
+  }).catch((error) => ({ count: 0, visible_count: 0, texts: [], visible_texts: [], error: String(error && error.message ? error.message : error).slice(0, 500) }));
+}
 function inventoryAppPathFromUrl(urlLike) {
   const url = new URL(String(urlLike), targetUrl);
   const mountPrefix = previewMountPrefix(new URL(targetUrl).pathname);
@@ -8724,11 +8899,16 @@ async function captureViewport(viewport) {
     evaluation_error: String(error && error.message ? error.message : error).slice(0, 1000),
   }));
   const selectors = {};
+  const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
     if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
+    if (check.type === "selector_text_order" && check.selector) {
+      selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
+      text_sequences[check.selector] = await selectorTextSequence(check.selector);
+    }
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       text_matches[textKey(check)] = textMatches(dom.body_text || dom.body_text_sample || "", check);
     }
@@ -8742,7 +8922,7 @@ async function captureViewport(viewport) {
   let routeInventory;
   const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory");
   const firstViewportName = (profile.target.viewports || [])[0] && (profile.target.viewports || [])[0].name;
-  if (routeInventoryCheck && (!firstViewportName || viewport.name === firstViewportName)) {
+  if (routeInventoryCheck && (routeInventoryCheck.run_all_viewports || !firstViewportName || viewport.name === firstViewportName)) {
     try {
       routeInventory = await collectRouteInventory(routeInventoryCheck, viewport);
     } catch (error) {
@@ -8792,6 +8972,7 @@ async function captureViewport(viewport) {
     bounds_overflow_px: dom.bounds_overflow_px,
     overflow_offenders: dom.overflow_offenders || [],
     selectors,
+    text_sequences,
     text_matches,
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-PWGJQLOS.js";
+} from "./chunk-VEK6QHPE.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport