@riddledc/riddle-proof 0.7.34 → 0.7.36

package/dist/index.cjs

@@ -8728,6 +8728,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "selector_visible",
   "selector_count_at_least",
+  "selector_text_order",
   "text_visible",
   "text_absent",
   "route_inventory",
@@ -9007,6 +9008,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 (!isRecord2(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue5(input.type);
@@ -9023,6 +9033,11 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue3(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 (!stringValue5(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.`);
@@ -9033,6 +9048,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue5(input.expected_path),
     expected_routes: expectedRoutes,
     selector: stringValue5(input.selector),
+    expected_texts: expectedTexts,
     link_selector: stringValue5(input.link_selector) || stringValue5(input.linkSelector),
     source_selector: stringValue5(input.source_selector) || stringValue5(input.sourceSelector),
     route_path_prefix: stringValue5(input.route_path_prefix) || stringValue5(input.routePathPrefix),
@@ -9048,6 +9064,7 @@ function normalizeCheck(input, index) {
     timeout_ms: numberValue3(input.timeout_ms) ?? numberValue3(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
@@ -9138,6 +9155,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 (isRecord2(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 = numberValue3(inventory.source_link_count) ?? numberValue3(inventory.home_game_link_count) ?? null;
+  const sourceUniqueLinkCount = numberValue3(inventory.source_unique_link_count) ?? numberValue3(inventory.home_unique_game_link_count) ?? null;
+  const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path6) => String(path6)) : [];
+  const duplicateSourceLinkCount = numberValue3(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 {
@@ -9257,6 +9315,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";
@@ -9288,6 +9372,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 : [];
@@ -9311,6 +9396,8 @@ function assessCheckFromEvidence(check, evidence) {
         homepage_unique_link_count: numberValue3(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
@@ -9607,6 +9694,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;
 }
@@ -9811,6 +9939,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";
@@ -9839,6 +9990,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 : []) {
@@ -9867,6 +10019,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,
@@ -10184,6 +10338,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);
@@ -10581,11 +10756,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);
     }
@@ -10599,7 +10779,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) {
@@ -10649,6 +10829,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/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-PWGJQLOS.js";
+} from "./chunk-VEK6QHPE.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -57,6 +57,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "selector_visible",
   "selector_count_at_least",
+  "selector_text_order",
   "text_visible",
   "text_absent",
   "route_inventory",
@@ -336,6 +337,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);
@@ -352,6 +362,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.`);
@@ -362,6 +377,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),
@@ -377,6 +393,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
@@ -467,6 +484,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 {
@@ -586,6 +644,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";
@@ -617,6 +701,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 : [];
@@ -640,6 +725,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
@@ -936,6 +1023,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;
 }
@@ -1140,6 +1268,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";
@@ -1168,6 +1319,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 : []) {
@@ -1196,6 +1348,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,
@@ -1513,6 +1667,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);
@@ -1910,11 +2085,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);
     }
@@ -1928,7 +2108,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) {
@@ -1978,6 +2158,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/profile.d.cts

@@ -4,7 +4,7 @@ declare const RIDDLE_PROOF_PROFILE_VERSION: "riddle-proof.profile.v1";
 declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evidence.v1";
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
-declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_count_at_least", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
+declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_count_at_least", "selector_text_order", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
 declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
@@ -66,6 +66,7 @@ interface RiddleProofProfileCheck {
     expected_path?: string;
     expected_routes?: RiddleProofProfileRouteInventoryRoute[];
     selector?: string;
+    expected_texts?: string[];
     link_selector?: string;
     source_selector?: string;
     route_path_prefix?: string;
@@ -81,6 +82,7 @@ interface RiddleProofProfileCheck {
     timeout_ms?: number;
     run_direct_routes?: boolean;
     run_clickthroughs?: boolean;
+    run_all_viewports?: boolean;
     require_unique_routes?: boolean;
     allow_unexpected_routes?: boolean;
     save_route_screenshots?: boolean;
@@ -137,6 +139,7 @@ interface RiddleProofProfileViewportEvidence {
         count: number;
         visible_count: number;
     }>;
+    text_sequences?: Record<string, Record<string, JsonValue>>;
     text_matches?: Record<string, boolean>;
     route_inventory?: Record<string, JsonValue>;
     setup_action_results?: Array<Record<string, JsonValue>>;