@riddledc/riddle-proof 0.7.33 → 0.7.35

package/dist/cli.js

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

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),
@@ -9138,6 +9154,28 @@ 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 matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -9257,6 +9295,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";
@@ -9292,14 +9356,23 @@ function assessCheckFromEvidence(check, evidence) {
     const first = inventories[0]?.inventory;
     const directRoutes = Array.isArray(first?.direct_routes) ? first.direct_routes : [];
     const clickthroughs = Array.isArray(first?.clickthroughs) ? first.clickthroughs : [];
+    const sourceLinkCount = numberValue3(first?.source_link_count) ?? numberValue3(first?.home_game_link_count) ?? null;
+    const sourceUniqueLinkCount = numberValue3(first?.source_unique_link_count) ?? numberValue3(first?.home_unique_game_link_count) ?? null;
+    const duplicateSourceLinks = Array.isArray(first?.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path6) => String(path6)) : [];
+    const duplicateSourceLinkCount = numberValue3(first?.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
-        homepage_link_count: numberValue3(first?.home_game_link_count) ?? null,
-        homepage_unique_link_count: numberValue3(first?.home_unique_game_link_count) ?? null,
+        source_link_count: sourceLinkCount,
+        source_unique_link_count: sourceUniqueLinkCount,
+        duplicate_source_link_count: duplicateSourceLinkCount,
+        duplicate_source_links: duplicateSourceLinks,
+        duplicates_allowed: check.require_unique_routes === false,
+        homepage_link_count: numberValue3(first?.home_game_link_count) ?? sourceLinkCount,
+        homepage_unique_link_count: numberValue3(first?.home_unique_game_link_count) ?? sourceUniqueLinkCount,
         direct_route_count: directRoutes.length,
         clickthrough_count: clickthroughs.length,
         failures
@@ -9598,6 +9671,28 @@ 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 numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -9802,6 +9897,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,14 +9957,23 @@ function assessProfile(profile, evidence) {
       const first = inventories[0].inventory || {};
       const directRoutes = Array.isArray(first.direct_routes) ? first.direct_routes : [];
       const clickthroughs = Array.isArray(first.clickthroughs) ? first.clickthroughs : [];
+      const sourceLinkCount = typeof first.source_link_count === "number" ? first.source_link_count : typeof first.home_game_link_count === "number" ? first.home_game_link_count : null;
+      const sourceUniqueLinkCount = typeof first.source_unique_link_count === "number" ? first.source_unique_link_count : typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null;
+      const duplicateSourceLinks = Array.isArray(first.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
+      const duplicateSourceLinkCount = typeof first.duplicate_source_link_count === "number" ? first.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
-          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : null,
-          homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null,
+          source_link_count: sourceLinkCount,
+          source_unique_link_count: sourceUniqueLinkCount,
+          duplicate_source_link_count: duplicateSourceLinkCount,
+          duplicate_source_links: duplicateSourceLinks,
+          duplicates_allowed: check.require_unique_routes === false,
+          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : sourceLinkCount,
+          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,
           failures,
@@ -10166,6 +10293,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);
@@ -10365,8 +10513,9 @@ async function collectRouteInventory(check, viewport) {
   const homeLinkPaths = homeLinks.map((link) => link.app_path);
   const uniqueHomeLinkPaths = Array.from(new Set(homeLinkPaths));
   const duplicateHomeLinkPaths = homeLinkPaths.filter((path, index) => homeLinkPaths.indexOf(path) !== index);
+  const duplicateHomeLinkPathSet = Array.from(new Set(duplicateHomeLinkPaths));
   if (check.require_unique_routes !== false && duplicateHomeLinkPaths.length) {
-    failures.push({ code: "duplicate_source_links", paths: Array.from(new Set(duplicateHomeLinkPaths)) });
+    failures.push({ code: "duplicate_source_links", paths: duplicateHomeLinkPathSet });
   }
   for (const route of expectedRoutes) {
     if (!homeLinkPaths.includes(normalizeRoutePath(route.path))) {
@@ -10442,6 +10591,11 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_count: homeLinkPaths.length,
+    source_unique_link_count: uniqueHomeLinkPaths.length,
+    duplicate_source_link_count: duplicateHomeLinkPaths.length,
+    duplicate_source_link_paths: duplicateHomeLinkPathSet,
+    duplicates_allowed: check.require_unique_routes === false,
     home_game_link_count: homeLinkPaths.length,
     home_unique_game_link_count: uniqueHomeLinkPaths.length,
     home_links: homeLinks,
@@ -10557,11 +10711,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);
     }
@@ -10585,6 +10744,11 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_count: 0,
+        source_unique_link_count: 0,
+        duplicate_source_link_count: 0,
+        duplicate_source_link_paths: [],
+        duplicates_allowed: routeInventoryCheck.require_unique_routes === false,
         home_game_link_count: 0,
         home_unique_game_link_count: 0,
         home_links: [],
@@ -10620,6 +10784,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,
@@ -10659,6 +10824,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          source_link_count: viewport.route_inventory.source_link_count == null ? viewport.route_inventory.home_game_link_count : viewport.route_inventory.source_link_count,
+          source_unique_link_count: viewport.route_inventory.source_unique_link_count == null ? viewport.route_inventory.home_unique_game_link_count : viewport.route_inventory.source_unique_link_count,
+          duplicate_source_link_count: viewport.route_inventory.duplicate_source_link_count,
           home_unique_game_link_count: viewport.route_inventory.home_unique_game_link_count,
           direct_route_count: (viewport.route_inventory.direct_routes || []).length,
           clickthrough_count: (viewport.route_inventory.clickthroughs || []).length,

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-COUZXKGM.js";
+} from "./chunk-VCINQE5O.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),
@@ -467,6 +483,28 @@ 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 matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -586,6 +624,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";
@@ -621,14 +685,23 @@ function assessCheckFromEvidence(check, evidence) {
     const first = inventories[0]?.inventory;
     const directRoutes = Array.isArray(first?.direct_routes) ? first.direct_routes : [];
     const clickthroughs = Array.isArray(first?.clickthroughs) ? first.clickthroughs : [];
+    const sourceLinkCount = numberValue(first?.source_link_count) ?? numberValue(first?.home_game_link_count) ?? null;
+    const sourceUniqueLinkCount = numberValue(first?.source_unique_link_count) ?? numberValue(first?.home_unique_game_link_count) ?? null;
+    const duplicateSourceLinks = Array.isArray(first?.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
+    const duplicateSourceLinkCount = numberValue(first?.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
-        homepage_link_count: numberValue(first?.home_game_link_count) ?? null,
-        homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? null,
+        source_link_count: sourceLinkCount,
+        source_unique_link_count: sourceUniqueLinkCount,
+        duplicate_source_link_count: duplicateSourceLinkCount,
+        duplicate_source_links: duplicateSourceLinks,
+        duplicates_allowed: check.require_unique_routes === false,
+        homepage_link_count: numberValue(first?.home_game_link_count) ?? sourceLinkCount,
+        homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? sourceUniqueLinkCount,
         direct_route_count: directRoutes.length,
         clickthrough_count: clickthroughs.length,
         failures
@@ -927,6 +1000,28 @@ 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 numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -1131,6 +1226,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,14 +1286,23 @@ function assessProfile(profile, evidence) {
       const first = inventories[0].inventory || {};
       const directRoutes = Array.isArray(first.direct_routes) ? first.direct_routes : [];
       const clickthroughs = Array.isArray(first.clickthroughs) ? first.clickthroughs : [];
+      const sourceLinkCount = typeof first.source_link_count === "number" ? first.source_link_count : typeof first.home_game_link_count === "number" ? first.home_game_link_count : null;
+      const sourceUniqueLinkCount = typeof first.source_unique_link_count === "number" ? first.source_unique_link_count : typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null;
+      const duplicateSourceLinks = Array.isArray(first.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
+      const duplicateSourceLinkCount = typeof first.duplicate_source_link_count === "number" ? first.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
-          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : null,
-          homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null,
+          source_link_count: sourceLinkCount,
+          source_unique_link_count: sourceUniqueLinkCount,
+          duplicate_source_link_count: duplicateSourceLinkCount,
+          duplicate_source_links: duplicateSourceLinks,
+          duplicates_allowed: check.require_unique_routes === false,
+          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : sourceLinkCount,
+          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,
           failures,
@@ -1495,6 +1622,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);
@@ -1694,8 +1842,9 @@ async function collectRouteInventory(check, viewport) {
   const homeLinkPaths = homeLinks.map((link) => link.app_path);
   const uniqueHomeLinkPaths = Array.from(new Set(homeLinkPaths));
   const duplicateHomeLinkPaths = homeLinkPaths.filter((path, index) => homeLinkPaths.indexOf(path) !== index);
+  const duplicateHomeLinkPathSet = Array.from(new Set(duplicateHomeLinkPaths));
   if (check.require_unique_routes !== false && duplicateHomeLinkPaths.length) {
-    failures.push({ code: "duplicate_source_links", paths: Array.from(new Set(duplicateHomeLinkPaths)) });
+    failures.push({ code: "duplicate_source_links", paths: duplicateHomeLinkPathSet });
   }
   for (const route of expectedRoutes) {
     if (!homeLinkPaths.includes(normalizeRoutePath(route.path))) {
@@ -1771,6 +1920,11 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_count: homeLinkPaths.length,
+    source_unique_link_count: uniqueHomeLinkPaths.length,
+    duplicate_source_link_count: duplicateHomeLinkPaths.length,
+    duplicate_source_link_paths: duplicateHomeLinkPathSet,
+    duplicates_allowed: check.require_unique_routes === false,
     home_game_link_count: homeLinkPaths.length,
     home_unique_game_link_count: uniqueHomeLinkPaths.length,
     home_links: homeLinks,
@@ -1886,11 +2040,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);
     }
@@ -1914,6 +2073,11 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_count: 0,
+        source_unique_link_count: 0,
+        duplicate_source_link_count: 0,
+        duplicate_source_link_paths: [],
+        duplicates_allowed: routeInventoryCheck.require_unique_routes === false,
         home_game_link_count: 0,
         home_unique_game_link_count: 0,
         home_links: [],
@@ -1949,6 +2113,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,
@@ -1988,6 +2153,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          source_link_count: viewport.route_inventory.source_link_count == null ? viewport.route_inventory.home_game_link_count : viewport.route_inventory.source_link_count,
+          source_unique_link_count: viewport.route_inventory.source_unique_link_count == null ? viewport.route_inventory.home_unique_game_link_count : viewport.route_inventory.source_unique_link_count,
+          duplicate_source_link_count: viewport.route_inventory.duplicate_source_link_count,
           home_unique_game_link_count: viewport.route_inventory.home_unique_game_link_count,
           direct_route_count: (viewport.route_inventory.direct_routes || []).length,
           clickthrough_count: (viewport.route_inventory.clickthroughs || []).length,

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;
@@ -137,6 +138,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>>;