@sun-asterisk/sungen 3.2.29 → 3.2.31

package/dist/generators/test-generator/utils/data-resolver.js

@@ -52,6 +52,18 @@ class DataResolver {
     clearCaptured() {
         this.capturedVars.clear();
     }
+    /** Register the head of a variable bound by the feature's `@beforeAll` hook (feature-scoped). */
+    registerFeatureCaptured(head) {
+        this.featureCaptured.add(head);
+    }
+    /** Clear feature-scoped captured vars — call at the start of each feature. */
+    clearFeatureCaptured() {
+        this.featureCaptured.clear();
+    }
+    /** Runtime-only ref (scenario-captured, or bound by the feature's `@beforeAll` hook)? */
+    isCaptured(dataRef) {
+        return this.capturedVars.has(dataRef) || this.featureCaptured.has(dataRef.split(/[.[]/)[0]);
+    }
     constructor(testDataDir, screenName, runtimeMode = false) {
         this.dataCache = new Map();
         this.flowMode = false;
@@ -59,6 +71,11 @@ class DataResolver {
         // these skip YAML validation (they don't exist in test-data.yaml) and resolve
         // to testData.get('var') — populated by the capture step's testData.set('var', …).
         this.capturedVars = new Set();
+        // Vars bound by a `@beforeAll` hook's `@api:`/`@query:` preconditions. The hook runs before every
+        // test of the feature, so its bindings are readable from EVERY scenario — they survive the
+        // per-scenario clearCaptured(). Stored by head (`login`) and matched against the ref's head
+        // (`login.body.token` → `login`), since a scenario may read any sub-path of the bound response.
+        this.featureCaptured = new Set();
         this.testDataDir = testDataDir || path.join(process.cwd(), 'qa', 'test-data');
         this.screenName = screenName;
         this.runtimeMode = runtimeMode;
@@ -78,7 +95,7 @@ class DataResolver {
     resolveData(dataRef, featureName) {
         // Captured vars exist only at runtime → emit a marker (→ testData.get) and
         // skip YAML validation. Requires runtime mode (capture writes testData.set).
-        if (this.capturedVars.has(dataRef)) {
+        if (this.isCaptured(dataRef)) {
             return DataResolver.encodeMarker(dataRef);
         }
         if (this.runtimeMode) {
@@ -98,7 +115,7 @@ class DataResolver {
      * anything said about it belongs in a warning, never a gate.
      */
     peekBaseValue(dataRef, featureName) {
-        if (this.capturedVars.has(dataRef))
+        if (this.isCaptured(dataRef))
             return undefined;
         try {
             return this.resolveValue(dataRef, featureName);

package/dist/generators/test-generator/utils/data-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-resolver.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/data-resolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-resolver.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/data-resolver.ts"],"names":[],"mappings":"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"}

package/dist/generators/test-generator/utils/dialog-scope-identity.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Identity of a locator as the `locator` partial actually renders it — issue #692.
+ *
+ * `Given User is on [X] dialog` records a scope root, and the `pageRoot` helper prefixes every
+ * locator rendered afterwards with it. That is the whole point of the scope — except when a later
+ * step names the SAME element as the scope root, where the prefix nests the dialog inside itself:
+ *
+ *     page.getByRole('dialog', { name: 'Confirm' }).getByRole('dialog', { name: 'Confirm' })
+ *
+ * A dialog cannot contain itself, so that query can never resolve. It compiles clean, emits no
+ * diagnostic, and fails as a plain timeout — which reads as "the dialog never opened" rather than
+ * "the query is impossible". Re-asserting the dialog you are scoped inside is the natural thing to
+ * write straight after the `Given`, so the scope root is made idempotent instead.
+ *
+ * The guard needs exactly one question answered: does this element render to the same locator as
+ * the active scope root? So the key carries the fields the partial reads FOR THAT STRATEGY and
+ * nothing else — two entries share a key iff they render the same expression. Comparing role+name
+ * alone (the shape the issue first suggested) would miss `type: locator` and `type: testid`
+ * dialogs, which self-nest just the same.
+ *
+ * Deliberately says nothing about a `with {{v}}` filtered root: that root is
+ * `getByRole('dialog').filter({ hasText })`, which is not expressible as the element's own
+ * locator, so an identity match there would be meaningless. The caller skips the guard in that
+ * case — see the `dialogFilterText` check in `pageRoot`.
+ */
+/** The subset of a resolved selector that the `locator` partial reads. */
+export interface LocatorIdentityFields {
+    strategy?: string;
+    value?: string;
+    role?: string;
+    name?: string;
+    exact?: boolean;
+    nth?: number;
+    scope?: string;
+}
+/**
+ * A stable key for the locator `fields` renders to, or undefined when there is no strategy to
+ * render (nothing to compare, so no guard).
+ */
+export declare function locatorIdentityKey(fields: LocatorIdentityFields | undefined): string | undefined;
+//# sourceMappingURL=dialog-scope-identity.d.ts.map

package/dist/generators/test-generator/utils/dialog-scope-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-scope-identity.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/dialog-scope-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA6BhG"}

package/dist/generators/test-generator/utils/dialog-scope-identity.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Identity of a locator as the `locator` partial actually renders it — issue #692.
+ *
+ * `Given User is on [X] dialog` records a scope root, and the `pageRoot` helper prefixes every
+ * locator rendered afterwards with it. That is the whole point of the scope — except when a later
+ * step names the SAME element as the scope root, where the prefix nests the dialog inside itself:
+ *
+ *     page.getByRole('dialog', { name: 'Confirm' }).getByRole('dialog', { name: 'Confirm' })
+ *
+ * A dialog cannot contain itself, so that query can never resolve. It compiles clean, emits no
+ * diagnostic, and fails as a plain timeout — which reads as "the dialog never opened" rather than
+ * "the query is impossible". Re-asserting the dialog you are scoped inside is the natural thing to
+ * write straight after the `Given`, so the scope root is made idempotent instead.
+ *
+ * The guard needs exactly one question answered: does this element render to the same locator as
+ * the active scope root? So the key carries the fields the partial reads FOR THAT STRATEGY and
+ * nothing else — two entries share a key iff they render the same expression. Comparing role+name
+ * alone (the shape the issue first suggested) would miss `type: locator` and `type: testid`
+ * dialogs, which self-nest just the same.
+ *
+ * Deliberately says nothing about a `with {{v}}` filtered root: that root is
+ * `getByRole('dialog').filter({ hasText })`, which is not expressible as the element's own
+ * locator, so an identity match there would be meaningless. The caller skips the guard in that
+ * case — see the `dialogFilterText` check in `pageRoot`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.locatorIdentityKey = locatorIdentityKey;
+/**
+ * A stable key for the locator `fields` renders to, or undefined when there is no strategy to
+ * render (nothing to compare, so no guard).
+ */
+function locatorIdentityKey(fields) {
+    if (!fields || !fields.strategy)
+        return undefined;
+    // `scope: dialog` is the dialog-rooting sentinel rather than part of the element's own
+    // identity — renderDialogRoot strips it before rendering the root for the same reason.
+    const scope = fields.scope && fields.scope !== 'dialog' ? fields.scope : '';
+    const nth = typeof fields.nth === 'number' && fields.nth >= 0 ? String(fields.nth) : '';
+    const exact = fields.exact ? '1' : '';
+    const parts = [];
+    switch (fields.strategy) {
+        case 'role':
+            // getByRole reads role/name/exact — never `value`.
+            parts.push('role', fields.role || '', fields.name || '', exact);
+            break;
+        case 'testid':
+            parts.push('testid', fields.value || '');
+            break;
+        case 'placeholder':
+        case 'label':
+        case 'text':
+            parts.push(fields.strategy, fields.value || '', exact);
+            break;
+        default:
+            // 'locator', 'id', 'css' and the partial's own default all render locator('<value>').
+            parts.push('locator', fields.value || '');
+    }
+    return [...parts, `nth=${nth}`, `scope=${scope}`].join('|');
+}
+//# sourceMappingURL=dialog-scope-identity.js.map

package/dist/generators/test-generator/utils/dialog-scope-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-scope-identity.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/dialog-scope-identity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;AAiBH,gDA6BC;AAjCD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAAyC;IAC1E,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAElD,uFAAuF;IACvF,uFAAuF;IACvF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,mDAAmD;YACnD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAChE,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM;QACR;YACE,sFAAsF;YACtF,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,SAAS,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9D,CAAC"}

package/dist/generators/test-generator/utils/escape-js-string.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Escape a raw string for embedding inside a SINGLE-QUOTED JS string literal.
+ *
+ * Order matters: backslash first, or the escapes added afterwards get re-escaped. Getting this
+ * half-right is worse than not doing it — a value ending in `\` turns `'…\'` into an escaped
+ * closing quote, and the string literal runs on into the rest of the file, so the generated
+ * `.spec.ts` stops parsing and EVERY scenario in it is lost rather than the one step.
+ *
+ * The line terminators are not cosmetic either: a card's accessible text is routinely a composite
+ * of several lines (a Flutter content-desc, a multi-line heading), and a literal newline inside
+ * `'…'` is a syntax error.
+ *
+ * Lives here rather than inside the Handlebars helper because the pattern layer also builds locator
+ * strings by hand — the parent-scope chain among them — and two copies of this rule drift.
+ */
+export declare function escapeSingleQuoted(text: unknown): string;
+//# sourceMappingURL=escape-js-string.d.ts.map

package/dist/generators/test-generator/utils/escape-js-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-js-string.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/escape-js-string.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQxD"}

package/dist/generators/test-generator/utils/escape-js-string.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeSingleQuoted = escapeSingleQuoted;
+/**
+ * Escape a raw string for embedding inside a SINGLE-QUOTED JS string literal.
+ *
+ * Order matters: backslash first, or the escapes added afterwards get re-escaped. Getting this
+ * half-right is worse than not doing it — a value ending in `\` turns `'…\'` into an escaped
+ * closing quote, and the string literal runs on into the rest of the file, so the generated
+ * `.spec.ts` stops parsing and EVERY scenario in it is lost rather than the one step.
+ *
+ * The line terminators are not cosmetic either: a card's accessible text is routinely a composite
+ * of several lines (a Flutter content-desc, a multi-line heading), and a literal newline inside
+ * `'…'` is a syntax error.
+ *
+ * Lives here rather than inside the Handlebars helper because the pattern layer also builds locator
+ * strings by hand — the parent-scope chain among them — and two copies of this rule drift.
+ */
+function escapeSingleQuoted(text) {
+    if (text == null)
+        return '';
+    return String(text)
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+//# sourceMappingURL=escape-js-string.js.map

package/dist/generators/test-generator/utils/escape-js-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-js-string.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/escape-js-string.ts"],"names":[],"mappings":";;AAeA,gDAQC;AAvBD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAAC,IAAa;IAC9C,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC;SAChB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/generators/test-generator/utils/nearest-match.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Nearest-known-spelling suggestion, shared by the selector-surface checks.
+ *
+ * Two checks need the same judgement about the same class of author mistake — SG-W004 on an entry
+ * FIELD nobody reads (#712) and SG-E027 on an entry `type:` VALUE nothing dispatches (#711) — so
+ * the rule lives in one place rather than being re-tuned independently in each. The tuning is the
+ * substance here, not the edit distance:
+ *
+ *   - A case-only difference is returned first and always. `testId` for `testid` and
+ *     `contentEditable` for `contenteditable` are the single likeliest way to write either
+ *     wrongly, and both surfaces are lowercase throughout, so this is a near-certainty rather
+ *     than a guess.
+ *   - Otherwise a distance of 1-2 is a typo worth naming.
+ *   - Anything further is a DIFFERENT word, and guessing at it sends the author somewhere wrong.
+ *     `selector` is not a misspelling of `locator` — it is someone reasonably assuming a field
+ *     that does not exist, and "did you mean locator?" would be a worse answer than silence.
+ *     The caller supplies its own hint for that case.
+ */
+/**
+ * The nearest candidate to `value`, when one is close enough to be a likely typo rather than a
+ * different word. Returns undefined when nothing is close enough to name honestly.
+ */
+export declare function nearestMatch(value: string, candidates: Iterable<string>, maxDistance?: number): string | undefined;
+//# sourceMappingURL=nearest-match.d.ts.map

package/dist/generators/test-generator/utils/nearest-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearest-match.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/nearest-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAoBH;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,SAAI,GAC3D,MAAM,GAAG,SAAS,CAWpB"}

package/dist/generators/test-generator/utils/nearest-match.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Nearest-known-spelling suggestion, shared by the selector-surface checks.
+ *
+ * Two checks need the same judgement about the same class of author mistake — SG-W004 on an entry
+ * FIELD nobody reads (#712) and SG-E027 on an entry `type:` VALUE nothing dispatches (#711) — so
+ * the rule lives in one place rather than being re-tuned independently in each. The tuning is the
+ * substance here, not the edit distance:
+ *
+ *   - A case-only difference is returned first and always. `testId` for `testid` and
+ *     `contentEditable` for `contenteditable` are the single likeliest way to write either
+ *     wrongly, and both surfaces are lowercase throughout, so this is a near-certainty rather
+ *     than a guess.
+ *   - Otherwise a distance of 1-2 is a typo worth naming.
+ *   - Anything further is a DIFFERENT word, and guessing at it sends the author somewhere wrong.
+ *     `selector` is not a misspelling of `locator` — it is someone reasonably assuming a field
+ *     that does not exist, and "did you mean locator?" would be a worse answer than silence.
+ *     The caller supplies its own hint for that case.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nearestMatch = nearestMatch;
+/** Levenshtein distance. Bounded use only — these are short identifiers. */
+function distance(a, b) {
+    const m = a.length, n = b.length;
+    let prev = Array.from({ length: n + 1 }, (_, j) => j);
+    for (let i = 1; i <= m; i++) {
+        const curr = [i];
+        for (let j = 1; j <= n; j++) {
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        prev = curr;
+    }
+    return prev[n];
+}
+/**
+ * The nearest candidate to `value`, when one is close enough to be a likely typo rather than a
+ * different word. Returns undefined when nothing is close enough to name honestly.
+ */
+function nearestMatch(value, candidates, maxDistance = 2) {
+    const lower = value.toLowerCase();
+    const all = [...candidates];
+    for (const c of all)
+        if (c.toLowerCase() === lower)
+            return c;
+    let best;
+    let bestDist = Infinity;
+    for (const c of all) {
+        const d = distance(lower, c.toLowerCase());
+        if (d < bestDist) {
+            bestDist = d;
+            best = c;
+        }
+    }
+    return bestDist <= maxDistance ? best : undefined;
+}
+//# sourceMappingURL=nearest-match.js.map

package/dist/generators/test-generator/utils/nearest-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearest-match.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/nearest-match.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAwBH,oCAaC;AAnCD,4EAA4E;AAC5E,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAChB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EACf,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC9C,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAC1B,KAAa,EAAE,UAA4B,EAAE,WAAW,GAAG,CAAC;IAE5D,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;YAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,IAAwB,CAAC;IAC7B,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;YAAC,QAAQ,GAAG,CAAC,CAAC;YAAC,IAAI,GAAG,CAAC,CAAC;QAAC,CAAC;IAC/C,CAAC;IACD,OAAO,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC"}

package/dist/generators/test-generator/utils/selector-entry-fields.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The selector-entry field partition, and the SG-W004 check built on it (issue #712).
+ *
+ * The root cause behind #690, #711 and #712 is one shape: `selectors.yaml` has a DOCUMENTED
+ * surface wider than the compiler's IMPLEMENTED surface, and nothing compared the two. A field
+ * could be declared on `SelectorEntry`, assigned onto `ResolvedSelector`, and printed in the
+ * public reference while no consumer ever read it back — discovered only by grepping.
+ *
+ * This module states the contract as a partition, the same way #690 answered the equivalent
+ * question for `type:` values (STRATEGY_SELECTOR_TYPES vs NON_STRATEGY_SELECTOR_TYPES). Every
+ * field an author may write belongs to exactly one set, each entry naming who reads it — so the
+ * next unconsumed field is a failing check with a name attached, not an archaeology exercise.
+ *
+ * The check is deliberately a WARNING, not an error. An unknown key is inert (the compiler simply
+ * never reads it), so refusing to compile would break projects over a stray comment-turned-key
+ * while teaching nothing extra. `--strict` already turns the whole channel non-zero for CI.
+ */
+import type { DiagnosticsCollector } from '../diagnostics';
+/**
+ * Fields a consumer actually reads. The comment on each names WHO — that is the part that rots,
+ * so it is recorded next to the claim rather than in prose elsewhere. Adding a field here without
+ * a named consumer re-opens exactly the hole #712 was filed for.
+ */
+export declare const CONSUMED_ENTRY_FIELDS: ReadonlySet<string>;
+/**
+ * Fields that are metadata by design — written for humans or for a non-codegen consumer, with no
+ * template behind them. Empty today: every field the schema accepts is now read by something.
+ *
+ * It is kept (rather than folded away) as the declared home for the NEXT such field, so that
+ * "nothing reads this" is an explicit, reviewable choice recorded here instead of an accident
+ * nobody notices for a release — which is precisely how `pagination:` and `contenteditable:`
+ * survived as documented no-ops.
+ */
+export declare const DECLARATIVE_ENTRY_FIELDS: ReadonlySet<string>;
+/** Everything an author may legitimately write on an entry. */
+export declare const KNOWN_ENTRY_FIELDS: ReadonlySet<string>;
+/** Keys of a `columns.<name>` definition — a column def is not a SelectorEntry. */
+export declare const COLUMN_DEF_FIELDS: ReadonlySet<string>;
+export interface UnknownField {
+    /** Dotted path to the offending key, e.g. `orders.pagination` or `login.anchor`. */
+    path: string;
+    field: string;
+    /** A near-miss known field, when one is close enough to be worth naming. */
+    suggestion?: string;
+}
+/** Every key in `file` that no consumer will ever read. */
+export declare function collectUnknownEntryFields(file: Record<string, unknown>): UnknownField[];
+/**
+ * SG-W004 — report every entry field nothing reads.
+ *
+ * Runs once per selector FILE (the resolver's load is cached), not once per step, so a table named
+ * by twenty row steps is reported once. Silent when there is no diagnostics channel attached.
+ */
+export declare function reportUnknownEntryFields(file: Record<string, unknown>, opts: {
+    feature?: string;
+    diagnostics?: DiagnosticsCollector;
+}): void;
+//# sourceMappingURL=selector-entry-fields.d.ts.map

package/dist/generators/test-generator/utils/selector-entry-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-entry-fields.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/selector-entry-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAI3D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CA6BpD,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAe,CAAC;AAEzE,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAGjD,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAA4C,CAAC;AAE/F,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,CAmBvF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,oBAAoB,CAAA;CAAE,GAC7D,IAAI,CAaN"}

package/dist/generators/test-generator/utils/selector-entry-fields.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * The selector-entry field partition, and the SG-W004 check built on it (issue #712).
+ *
+ * The root cause behind #690, #711 and #712 is one shape: `selectors.yaml` has a DOCUMENTED
+ * surface wider than the compiler's IMPLEMENTED surface, and nothing compared the two. A field
+ * could be declared on `SelectorEntry`, assigned onto `ResolvedSelector`, and printed in the
+ * public reference while no consumer ever read it back — discovered only by grepping.
+ *
+ * This module states the contract as a partition, the same way #690 answered the equivalent
+ * question for `type:` values (STRATEGY_SELECTOR_TYPES vs NON_STRATEGY_SELECTOR_TYPES). Every
+ * field an author may write belongs to exactly one set, each entry naming who reads it — so the
+ * next unconsumed field is a failing check with a name attached, not an archaeology exercise.
+ *
+ * The check is deliberately a WARNING, not an error. An unknown key is inert (the compiler simply
+ * never reads it), so refusing to compile would break projects over a stray comment-turned-key
+ * while teaching nothing extra. `--strict` already turns the whole channel non-zero for CI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLUMN_DEF_FIELDS = exports.KNOWN_ENTRY_FIELDS = exports.DECLARATIVE_ENTRY_FIELDS = exports.CONSUMED_ENTRY_FIELDS = void 0;
+exports.collectUnknownEntryFields = collectUnknownEntryFields;
+exports.reportUnknownEntryFields = reportUnknownEntryFields;
+const nearest_match_1 = require("./nearest-match");
+const selector_entry_walk_1 = require("./selector-entry-walk");
+/**
+ * Fields a consumer actually reads. The comment on each names WHO — that is the part that rots,
+ * so it is recorded next to the claim rather than in prose elsewhere. Adding a field here without
+ * a named consumer re-opens exactly the hole #712 was filed for.
+ */
+exports.CONSUMED_ENTRY_FIELDS = new Set([
+    'locator', // resolveFromEntry → strategy 'css'/'locator'
+    'type', // the strategy switch; also ResolvedSelector.selectorType (#690)
+    'value', // every strategy template
+    'name', // role templates; `name: null` disables the filter
+    'nth', // locator-nth partial
+    'exact', // has-text-value partial / anchored-regex assertions
+    'inputMethod', // driver-ui fill pattern → fill-editor-action
+    'scope', // dialog/landmark scoping in the locator partial
+    'match', // collapses into `exact` for getByText
+    'anchor', // page assertions — the rendered-content proof (#662)
+    'android', // appium adapter → androidSelector (#392)
+    'ios', // appium adapter → iosSelector (#392)
+    'variant', // widget recipes / native select / upload subtype
+    'trigger', // upload step — the visible button over a hidden input
+    'frame', // frame-enter/exit steps → page.frameLocator
+    'contenteditable', // resolveFromEntry → inputMethod 'pressSequentially' (#712)
+    'columns', // table column-index lookup in StepMapper
+    'pagination', // driver-ui table-paginate pattern (#712)
+    'rows', // table row templates, the row-shape universe (#688, SG-W016)
+    'attribute', // "has attribute" assertions → toHaveAttribute
+    'pattern', // regex for the attribute value
+    'expanded', // expand/collapse state signal
+    // Two spellings of ONE signal — how a control that publishes no ARIA marks its ON state, as a
+    // class or as a boolean attribute (issue #730). Normalised to `checkedClass`/`checkedAttribute`
+    // in selector-resolver, then read by setCheckedState/expectCheckedState via the checked-opts
+    // partial.
+    'checked', // checked state signal → setCheckedState/expectCheckedState
+    'selected', // alias of `checked` for card/tab pickers
+]);
+/**
+ * Fields that are metadata by design — written for humans or for a non-codegen consumer, with no
+ * template behind them. Empty today: every field the schema accepts is now read by something.
+ *
+ * It is kept (rather than folded away) as the declared home for the NEXT such field, so that
+ * "nothing reads this" is an explicit, reviewable choice recorded here instead of an accident
+ * nobody notices for a release — which is precisely how `pagination:` and `contenteditable:`
+ * survived as documented no-ops.
+ */
+exports.DECLARATIVE_ENTRY_FIELDS = new Set([]);
+/** Everything an author may legitimately write on an entry. */
+exports.KNOWN_ENTRY_FIELDS = new Set([
+    ...exports.CONSUMED_ENTRY_FIELDS,
+    ...exports.DECLARATIVE_ENTRY_FIELDS,
+]);
+/** Keys of a `columns.<name>` definition — a column def is not a SelectorEntry. */
+exports.COLUMN_DEF_FIELDS = new Set(['index', 'header', 'elements']);
+/** Every key in `file` that no consumer will ever read. */
+function collectUnknownEntryFields(file) {
+    const out = [];
+    (0, selector_entry_walk_1.walkSelectorEntries)(file, {
+        entry(entry, path) {
+            for (const field of Object.keys(entry)) {
+                if (exports.KNOWN_ENTRY_FIELDS.has(field))
+                    continue;
+                out.push({ path, field, suggestion: (0, nearest_match_1.nearestMatch)(field, exports.KNOWN_ENTRY_FIELDS) });
+            }
+        },
+        // A column DEFINITION has its own small key set — this is the one check that judges it, and
+        // the reason the walk offers the visit at all.
+        columnDef(def, path) {
+            for (const field of Object.keys(def)) {
+                if (exports.COLUMN_DEF_FIELDS.has(field))
+                    continue;
+                out.push({ path, field, suggestion: (0, nearest_match_1.nearestMatch)(field, exports.COLUMN_DEF_FIELDS) });
+            }
+        },
+    });
+    return out;
+}
+/**
+ * SG-W004 — report every entry field nothing reads.
+ *
+ * Runs once per selector FILE (the resolver's load is cached), not once per step, so a table named
+ * by twenty row steps is reported once. Silent when there is no diagnostics channel attached.
+ */
+function reportUnknownEntryFields(file, opts) {
+    const sink = opts.diagnostics;
+    if (!sink)
+        return;
+    for (const { path, field, suggestion } of collectUnknownEntryFields(file)) {
+        const hint = suggestion
+            ? ` Did you mean "${suggestion}"?`
+            : ' A locator goes in "value:" (with a "type:") or "locator:" (raw CSS).';
+        sink.add('SG-W004', `selectors.yaml entry "${path}" declares "${field}", which no consumer reads — `
+            + `writing it has no effect on the generated test and never will.${hint} `
+            + `See the selector reference for the fields an entry supports.`, { feature: opts.feature });
+    }
+}
+//# sourceMappingURL=selector-entry-fields.js.map

package/dist/generators/test-generator/utils/selector-entry-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-entry-fields.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/selector-entry-fields.ts"],"names":[],"mappings":"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"}

package/dist/generators/test-generator/utils/selector-entry-walk.d.ts

@@ -0,0 +1,25 @@
+/**
+ * One walk over the entries of a `selectors.yaml` file, shared by every per-entry check.
+ *
+ * SG-W004 (#712), SG-E027 (#711) and SG-W018 (#720) ask three different questions about the same
+ * shape — an unknown KEY, an unknown VALUE for `type:`, an out-of-contract VALUE for `nth:` — and
+ * each shipped its own copy of the same recursion. Three copies of "where do entries live" is how
+ * a check silently stops covering a nesting level: #711's gate has an explicit case for
+ * `columns.*.elements.*` precisely because that level was easy to miss. The recursion lives here
+ * once, so a new nesting level is added in one place and every check gains it at the same moment.
+ */
+/** Sub-entries that are themselves full SelectorEntry values, so they recurse. */
+export declare const NESTED_ENTRY_FIELDS: readonly ["anchor", "android", "ios"];
+export declare function isEntryObject(v: unknown): v is Record<string, unknown>;
+export interface WalkVisitors {
+    /** Every SelectorEntry in the file, with its dotted path (`save`, `greeting.ios`, …). */
+    entry(entry: Record<string, unknown>, path: string): void;
+    /**
+     * Each `columns.<name>` DEFINITION, which is not a SelectorEntry (it holds index/header/
+     * elements). Only SG-W004 has business with these; the other checks omit it.
+     */
+    columnDef?(def: Record<string, unknown>, path: string): void;
+}
+/** Visit every entry (and, on request, every column definition) in a parsed selector file. */
+export declare function walkSelectorEntries(file: Record<string, unknown>, visit: WalkVisitors): void;
+//# sourceMappingURL=selector-entry-walk.d.ts.map

package/dist/generators/test-generator/utils/selector-entry-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-entry-walk.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/selector-entry-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,uCAAwC,CAAC;AAEzE,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE;AAED,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D;;;OAGG;IACH,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9D;AA0BD,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAI5F"}

package/dist/generators/test-generator/utils/selector-entry-walk.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * One walk over the entries of a `selectors.yaml` file, shared by every per-entry check.
+ *
+ * SG-W004 (#712), SG-E027 (#711) and SG-W018 (#720) ask three different questions about the same
+ * shape — an unknown KEY, an unknown VALUE for `type:`, an out-of-contract VALUE for `nth:` — and
+ * each shipped its own copy of the same recursion. Three copies of "where do entries live" is how
+ * a check silently stops covering a nesting level: #711's gate has an explicit case for
+ * `columns.*.elements.*` precisely because that level was easy to miss. The recursion lives here
+ * once, so a new nesting level is added in one place and every check gains it at the same moment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NESTED_ENTRY_FIELDS = void 0;
+exports.isEntryObject = isEntryObject;
+exports.walkSelectorEntries = walkSelectorEntries;
+/** Sub-entries that are themselves full SelectorEntry values, so they recurse. */
+exports.NESTED_ENTRY_FIELDS = ['anchor', 'android', 'ios'];
+function isEntryObject(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+function walkEntry(entry, entryPath, visit) {
+    visit.entry(entry, entryPath);
+    for (const sub of exports.NESTED_ENTRY_FIELDS) {
+        const v = entry[sub];
+        if (isEntryObject(v))
+            walkEntry(v, `${entryPath}.${sub}`, visit);
+    }
+    // A column DEFINITION is not a SelectorEntry, but the entries under its `elements:` map are,
+    // and each carries its own `type:` / `nth:`.
+    const columns = entry.columns;
+    if (!isEntryObject(columns))
+        return;
+    for (const [colName, colDef] of Object.entries(columns)) {
+        if (!isEntryObject(colDef))
+            continue;
+        const colPath = `${entryPath}.columns.${colName}`;
+        visit.columnDef?.(colDef, colPath);
+        const elements = colDef.elements;
+        if (!isEntryObject(elements))
+            continue;
+        for (const [elName, elEntry] of Object.entries(elements)) {
+            if (isEntryObject(elEntry))
+                walkEntry(elEntry, `${colPath}.elements.${elName}`, visit);
+        }
+    }
+}
+/** Visit every entry (and, on request, every column definition) in a parsed selector file. */
+function walkSelectorEntries(file, visit) {
+    for (const [label, entry] of Object.entries(file)) {
+        if (isEntryObject(entry))
+            walkEntry(entry, label, visit);
+    }
+}
+//# sourceMappingURL=selector-entry-walk.js.map

package/dist/generators/test-generator/utils/selector-entry-walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-entry-walk.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/utils/selector-entry-walk.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAKH,sCAEC;AAqCD,kDAIC;AA9CD,kFAAkF;AACrE,QAAA,mBAAmB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC;AAEzE,SAAgB,aAAa,CAAC,CAAU;IACtC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAYD,SAAS,SAAS,CAAC,KAA8B,EAAE,SAAiB,EAAE,KAAmB;IACvF,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,2BAAmB,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,aAAa,CAAC,CAAC,CAAC;YAAE,SAAS,CAAC,CAAC,EAAE,GAAG,SAAS,IAAI,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,6FAA6F;IAC7F,6CAA6C;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO;IACpC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,MAAM,OAAO,GAAG,GAAG,SAAS,YAAY,OAAO,EAAE,CAAC;QAClD,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzD,IAAI,aAAa,CAAC,OAAO,CAAC;gBAAE,SAAS,CAAC,OAAO,EAAE,GAAG,OAAO,aAAa,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,SAAgB,mBAAmB,CAAC,IAA6B,EAAE,KAAmB;IACpF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}