@sungen/driver-ui 3.2.27 → 3.2.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sungen/driver-ui",
-  "version": "3.2.27",
+  "version": "3.2.28",
   "description": "Sungen UI capability (Playwright) — step patterns, viewpoint gate, and phase hooks. Plugs into @sun-asterisk/sungen via the capability SPI.",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -13,7 +13,7 @@
   "author": "eqe team (engineer & quality) — Sun Asterisk",
   "license": "MIT",
   "dependencies": {
-    "@sun-asterisk/sungen": "3.2.27"
+    "@sun-asterisk/sungen": "3.2.28"
   },
   "peerDependencies": {
     "@playwright/test": "^1.57.0"

package/src/patterns/assertion-patterns.ts

@@ -112,6 +112,10 @@ export const assertionPatterns: StepPattern[] = [
       // `step.featurePath` is never populated by the parser, so it always degraded to '/'.
       const fallbackPath = context.featurePath || '/';
       let path = fallbackPath;
+      // The page's declared `anchor:` — the element that proves the page rendered. Without it the
+      // step is a URL-only oracle, which a client-side router can satisfy for a few hundred
+      // milliseconds before a guard bounces the user away (#662).
+      let anchor: Record<string, unknown> | undefined;
 
       // If selector is present, extract path from selector's value attribute
       if (step.selectorRef) {
@@ -128,6 +132,7 @@ export const assertionPatterns: StepPattern[] = [
           // URL. Guard on the entry kind: use `value` only for a page selector, else fall back to
           // the feature path rather than compiling `toHaveURL(/button/)`.
           path = resolved.selectorType === 'page' ? (resolved.value || fallbackPath) : fallbackPath;
+          if (resolved.selectorType === 'page' && resolved.anchor) anchor = { ...resolved.anchor };
         } catch (error) {
           // Fallback to feature path if selector not found
           path = fallbackPath;
@@ -153,7 +158,7 @@ export const assertionPatterns: StepPattern[] = [
         templateName: 'page-assertion',
         // `dataRef` rides along so a runtime failure can name the test-data key an author must go
         // fix — an empty/absent value is otherwise the hardest kind of red to trace.
-        data: { pathRegex, query, dataRef: step.dataRef || '' },
+        data: { pathRegex, query, dataRef: step.dataRef || '', anchor },
         comment: step.selectorRef ? `Assert on ${step.selectorRef} page${withSuffix}` : `Assert on page${withSuffix}`,
       };
     },