@sun-asterisk/sungen 3.2.24-beta.6 → 3.2.25

package/dist/generators/test-generator/patterns/expect-patterns.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.expectPatterns = void 0;
+exports.literalExpr = literalExpr;
 /**
  * Data-vs-data assertions — compare two runtime values directly (no UI element).
  * The primary use is asserting on an `@query`-bound result via path access, e.g.
@@ -22,6 +23,36 @@ const reExpect = new RegExp(`^\\s*(?:User\\s+)?expect\\s+(${VALUE})\\s+is\\s+(no
  *  GENERATOR gets the ORIGINAL step text, so it extracts the real `[Ref]`. */
 const reMatchesSchemaMasked = /^\s*(?:User\s+)?expect\s+\{\{~\}\}\s+matches\s+schema\s+\[~\]\s*$/i;
 const reMatchesSchema = new RegExp(`^\\s*(?:User\\s+)?expect\\s+(\\{\\{[^}]+\\}\\})\\s+matches\\s+schema\\s+\\[([A-Za-z0-9_.-]+)\\]\\s*$`, 'i');
+/**
+ * `{{var}}` EMBEDDED in a quoted literal — test-data keys and paths only
+ * (`user.name`, `q.rows[0].id`, `items[*]`, kebab flow namespaces like
+ * `password-reset.email`). `{{$...}}` dynamic tokens are excluded on purpose:
+ * they have no test-data key, so converting one to a get() call throws
+ * "Test data key not found" at runtime — they stay literal.
+ */
+const RE_EMBEDDED_VAR = /\{\{\s*([\w.[\]*-]+?)\s*\}\}/g;
+/** Escape static literal text for a template-literal context. */
+const escapeForTemplate = (s) => s.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
+/**
+ * Render a quoted literal's BODY as a JS expression. Text without vars keeps
+ * its exact JSON.stringify shape; an embedded `{{var}}` interpolates the
+ * runtime value (the literal used to ship verbatim, so the assertion compared
+ * against the raw `{{...}}` text and could never pass with correct data).
+ */
+function literalExpr(text) {
+    const vars = [...text.matchAll(RE_EMBEDDED_VAR)];
+    if (vars.length === 0)
+        return JSON.stringify(text);
+    if (vars.length === 1 && vars[0][0] === text)
+        return `testData.get(${JSON.stringify(vars[0][1])})`;
+    let out = '';
+    let last = 0;
+    for (const m of vars) {
+        out += escapeForTemplate(text.slice(last, m.index)) + `\${testData.get(${JSON.stringify(m[1])})}`;
+        last = m.index + m[0].length;
+    }
+    return `\`${out + escapeForTemplate(text.slice(last))}\``;
+}
 /** Render a value token (`{{var}}` | "literal" | 'literal' | number) as a JS expression. */
 function valueExpr(token) {
     const t = token.trim();
@@ -30,7 +61,7 @@ function valueExpr(token) {
         return `testData.get(${JSON.stringify(v[1])})`;
     const q = t.match(/^["'](.*)["']$/);
     if (q)
-        return JSON.stringify(q[1]);
+        return literalExpr(q[1]);
     if (/^-?\d+(?:\.\d+)?$/.test(t))
         return t;
     return JSON.stringify(t);
@@ -46,7 +77,10 @@ exports.expectPatterns = [
             const m = step.text.match(reMatchesSchema);
             if (!m)
                 return { code: `// TODO: malformed 'matches schema' step (expected: expect {{name.body}} matches schema [Ref]): ${step.text}`, comment: 'Unrecognized matches-schema step' };
-            const value = valueExpr(m[1]);
+            // raw(), not get(): Ajv must receive the NATIVE bound object. get() serializes
+            // to JSON text, so every schema validation failed with "(root) must be object"
+            // no matter how correct the response body was.
+            const value = `testData.raw(${JSON.stringify(m[1].replace(/^\{\{\s*|\s*\}\}$/g, ''))})`;
             const ref = m[2];
             const code = `{ const __schema = api.assertSchema(${value}, ${JSON.stringify(ref)}); expect(__schema.ok, \`matches schema [${ref}]: \${__schema.errors}\`).toBe(true); }`;
             return { code, comment: `Expect ${m[1]} matches schema [${ref}]` };

package/dist/generators/test-generator/patterns/expect-patterns.js.map

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

package/dist/generators/test-generator/patterns/index.d.ts

@@ -1,18 +1,9 @@
 import { ParsedStep } from '../../gherkin-parser';
 import { MappedStep } from '../step-mapper';
 import { StepPattern, PatternContext } from './types';
-/**
- * Mask the CONTENT of selector refs `[...]` and data placeholders `{{...}}` before verb matching,
- * keeping the delimiters. A step's verb/keywords come from the SENTENCE — never from a selector or
- * variable NAME — but matchers scan `step.text` with substring checks (e.g. `includes('click')`),
- * so a data ref like `{{double_click_guard_account.email}}` would spuriously satisfy the click
- * matcher and pre-empt fill. The content is replaced with an inert placeholder (`~` — carries no
- * verb/keyword/digit substring) rather than emptied, so structural matchers that require a NON-EMPTY
- * ref survive too — e.g. `expect {{a}} is {{b}}` matches `\{\{[^}]+\}\}`, and `in [X] table` /
- * `/\bto\s+\[/` keep their delimiters. The resolver/generator always receives the ORIGINAL step, so
- * value extraction and codegen are unaffected.
- */
-export declare function maskRefsForMatching(text: string): string;
+import { maskRefsForMatching } from '../utils/mask-refs-for-matching';
+import { unsupportedStepCode } from './unsupported-step-code';
+export { maskRefsForMatching, unsupportedStepCode };
 /**
  * `tap` is a synonym of `click` — for MATCHING only.
  *
@@ -76,6 +67,22 @@ export declare class PatternRegistry {
      * SG-W020 — the matched pattern declares `platforms` and the active one is not among them.
      */
     private static platformMiss;
+    /**
+     * SG-E021 — the step carries a trailing state clause the matched pattern does not account for.
+     *
+     * Priority decides which pattern wins, and the winner is not always the one that reads the clause:
+     * `see [X] page is hidden` matched `page-assertion` (13) ahead of `is-hidden` (11), so `is hidden`
+     * was dropped and the step compiled to `toHaveURL(...)` — asserting the page IS shown, the exact
+     * inverse of the sentence, and passing. Nothing detected it, because the clause lived only inside
+     * `step.text` and each pattern re-regexed it privately.
+     *
+     * `states` makes the claim explicit and checkable: a pattern declares what its template accounts
+     * for, and anything else lands here. Strict reading — an ABSENT `states` accounts for nothing —
+     * because the failure modes are asymmetric. Under-declaring throws on valid input, which is loud,
+     * local, and fixed by one annotation. Over-declaring restores the silent inversion this exists to
+     * close, and nothing catches it again.
+     */
+    private static stateMiss;
     /**
      * SG-E020 — the pattern is in-platform but the active adapter ships no template for it. A gap in
      * the adapter, not in the authored Gherkin: name every coordinate a reader needs to act on it.

package/dist/generators/test-generator/patterns/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAY,MAAM,SAAS,CAAC;AAIhE;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AA2BD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqB;;IAMrC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAK3C;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IAejD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI;IAsD1E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAwB3B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAmBlC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyBnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAI5B;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B;AAID,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAY,MAAM,SAAS,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAK9D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC;AASpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAUD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqB;;IAMrC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAK3C;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IAejD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI;IAmE1E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAwB3B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAwBxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAmBlC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyBnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAI5B;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B;AAID,cAAc,SAAS,CAAC"}

package/dist/generators/test-generator/patterns/index.js

@@ -14,27 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PatternRegistry = void 0;
-exports.maskRefsForMatching = maskRefsForMatching;
+exports.PatternRegistry = exports.unsupportedStepCode = exports.maskRefsForMatching = void 0;
 exports.normalizeVerbs = normalizeVerbs;
 const registry_1 = require("../../../capabilities/registry");
 const discover_1 = require("../../../capabilities/discover");
-/**
- * Mask the CONTENT of selector refs `[...]` and data placeholders `{{...}}` before verb matching,
- * keeping the delimiters. A step's verb/keywords come from the SENTENCE — never from a selector or
- * variable NAME — but matchers scan `step.text` with substring checks (e.g. `includes('click')`),
- * so a data ref like `{{double_click_guard_account.email}}` would spuriously satisfy the click
- * matcher and pre-empt fill. The content is replaced with an inert placeholder (`~` — carries no
- * verb/keyword/digit substring) rather than emptied, so structural matchers that require a NON-EMPTY
- * ref survive too — e.g. `expect {{a}} is {{b}}` matches `\{\{[^}]+\}\}`, and `in [X] table` /
- * `/\bto\s+\[/` keep their delimiters. The resolver/generator always receives the ORIGINAL step, so
- * value extraction and codegen are unaffected.
- */
-function maskRefsForMatching(text) {
-    return text
-        .replace(/\{\{[^}]*\}\}/g, '{{~}}')
-        .replace(/\[[^\]]*\]/g, '[~]');
-}
+const mask_refs_for_matching_1 = require("../utils/mask-refs-for-matching");
+Object.defineProperty(exports, "maskRefsForMatching", { enumerable: true, get: function () { return mask_refs_for_matching_1.maskRefsForMatching; } });
+const unsupported_step_code_1 = require("./unsupported-step-code");
+Object.defineProperty(exports, "unsupportedStepCode", { enumerable: true, get: function () { return unsupported_step_code_1.unsupportedStepCode; } });
 /**
  * Gesture forms that OWN the word "tap" — each has its own pattern keyed on it (`mobile-double-tap`
  * at priority 17, `tap-top-of-element` at 18) and means MORE than a click. They are the one
@@ -88,22 +75,6 @@ function normalizeVerbs(text) {
  * propagating untouched.
  */
 const TEMPLATE_NOT_FOUND = /^Template not found: (.+)\.hbs in any subfolder$/;
-/**
- * The step body emitted in place of code the active adapter cannot produce. A comment alone would
- * let the test go GREEN having asserted nothing — the silent-loss class this SPI exists to close —
- * so the step throws at run time as well as reporting at compile time.
- *
- * `JSON.stringify` does the quoting, NOT a hand-rolled `replace(/'/g, …)`. The reason string embeds
- * arbitrary author text (the step sentence), and hand-escaping only the quote character is wrong for
- * any input containing a backslash or a raw newline: a step ending `…\` would emit `'…\\'`, whose
- * trailing escaped-backslash-then-quote breaks the literal and takes the WHOLE generated spec down
- * with a syntax error — reopening, one level deeper, the exact "one bad step kills the file" failure
- * this function exists to prevent. Step text here is routinely non-ASCII (Vietnamese, Japanese),
- * which JSON.stringify also handles correctly.
- */
-function unsupportedStepCode(reason) {
-    return `throw new Error(${JSON.stringify(`[sungen] ${reason}`)});`;
-}
 /**
  * Pattern Registry - manages all step patterns
  */
@@ -140,7 +111,7 @@ class PatternRegistry {
         // THEN normalise `tap` → `click`, so the mobile phrasing reaches the whole shared vocabulary
         // instead of only the three patterns that happen to key on "tap". Masking first is what keeps a
         // `[Tap Water]` ref from being read as a verb.
-        const matchStep = { ...step, text: normalizeVerbs(maskRefsForMatching(step.text)) };
+        const matchStep = { ...step, text: normalizeVerbs((0, mask_refs_for_matching_1.maskRefsForMatching)(step.text)) };
         for (const pattern of this.patterns) {
             if (this.matchesPattern(matchStep, pattern.matcher)) {
                 return pattern;
@@ -159,7 +130,7 @@ class PatternRegistry {
         // pattern in priority order instead of crashing or silently dropping the step.
         // Matching mirrors findPattern exactly: refs masked FIRST (so `[Tap Water]` is not a
         // verb), then `tap` → `click` normalisation for the mobile vocabulary.
-        const matchStep = { ...step, text: normalizeVerbs(maskRefsForMatching(step.text)) };
+        const matchStep = { ...step, text: normalizeVerbs((0, mask_refs_for_matching_1.maskRefsForMatching)(step.text)) };
         for (const pattern of this.patterns) {
             if (!this.matchesPattern(matchStep, pattern.matcher))
                 continue;
@@ -175,6 +146,16 @@ class PatternRegistry {
                     const resolved = pattern.resolver(step, context);
                     if (!resolved)
                         continue; // resolver declined — fall through
+                    // State-clause gate. Deliberately AFTER the resolver, not before it: a resolver may return
+                    // null to say "not mine after all", and the search then continues to a lower-priority
+                    // pattern that may well be the one that asserts the state. Gating earlier judged a pattern
+                    // that had not yet claimed the step — `row-count` declines a non-numeric `{{value}}` so
+                    // `see [R] row with {{status_label}} is disabled` should reach see-with-variable-disabled,
+                    // but the gate short-circuited it into a throw. Only the pattern that actually OWNS the
+                    // step gets to be judged on what it drops.
+                    const resolverStateMiss = PatternRegistry.stateMiss(pattern, context, step);
+                    if (resolverStateMiss)
+                        return resolverStateMiss;
                     // Auto-inject parent scoping if step has parentRef
                     // Skip for table-* patterns — they resolve the table name internally from step text
                     if (step.parentRef && step.parentType && !pattern.name.startsWith('table-')) {
@@ -187,6 +168,10 @@ class PatternRegistry {
                     };
                 }
                 if (pattern.generator) {
+                    // A legacy generator has no decline path, so this pattern owns the step already.
+                    const generatorStateMiss = PatternRegistry.stateMiss(pattern, context, step);
+                    if (generatorStateMiss)
+                        return generatorStateMiss;
                     return pattern.generator(step, context);
                 }
                 return null;
@@ -220,10 +205,45 @@ class PatternRegistry {
             step: step.text,
         });
         return {
-            code: unsupportedStepCode(reason),
+            code: (0, unsupported_step_code_1.unsupportedStepCode)(reason),
             comment: `${supported}-only step on the ${adapter} adapter — see SG-W020`,
         };
     }
+    /**
+     * SG-E021 — the step carries a trailing state clause the matched pattern does not account for.
+     *
+     * Priority decides which pattern wins, and the winner is not always the one that reads the clause:
+     * `see [X] page is hidden` matched `page-assertion` (13) ahead of `is-hidden` (11), so `is hidden`
+     * was dropped and the step compiled to `toHaveURL(...)` — asserting the page IS shown, the exact
+     * inverse of the sentence, and passing. Nothing detected it, because the clause lived only inside
+     * `step.text` and each pattern re-regexed it privately.
+     *
+     * `states` makes the claim explicit and checkable: a pattern declares what its template accounts
+     * for, and anything else lands here. Strict reading — an ABSENT `states` accounts for nothing —
+     * because the failure modes are asymmetric. Under-declaring throws on valid input, which is loud,
+     * local, and fixed by one annotation. Over-declaring restores the silent inversion this exists to
+     * close, and nothing catches it again.
+     */
+    static stateMiss(pattern, context, step) {
+        const state = step.state;
+        if (!state)
+            return null;
+        if (pattern.states?.includes(state))
+            return null;
+        const reason = `step "${step.text}" carries the state clause "is ${state}", but the pattern that matched it ` +
+            `("${pattern.name}") does not assert that state — the clause would be SILENTLY DROPPED and the ` +
+            `step would check something other than what it reads as. Use a step form that owns the state ` +
+            `(e.g. "User see [Ref] <type> is ${state}" on the element itself), or drop the clause if the ` +
+            `bare assertion is what you meant. If sungen cannot express the check, tag the scenario @manual.`;
+        context.diagnostics?.add('SG-E021', reason, {
+            feature: context.featureName,
+            step: step.text,
+        });
+        return {
+            code: (0, unsupported_step_code_1.unsupportedStepCode)(reason),
+            comment: `"is ${state}" not asserted by "${pattern.name}" — see SG-E021`,
+        };
+    }
     /**
      * SG-E020 — the pattern is in-platform but the active adapter ships no template for it. A gap in
      * the adapter, not in the authored Gherkin: name every coordinate a reader needs to act on it.
@@ -238,7 +258,7 @@ class PatternRegistry {
             step: step.text,
         });
         return {
-            code: unsupportedStepCode(reason),
+            code: (0, unsupported_step_code_1.unsupportedStepCode)(reason),
             comment: `no ${adapter} template for "${templateName}" — see SG-E020`,
         };
     }

package/dist/generators/test-generator/patterns/index.js.map

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

package/dist/generators/test-generator/patterns/types.d.ts

@@ -19,6 +19,15 @@ export interface DiagnosticsSink {
  * behaviour.
  */
 export type Platform = 'web' | 'mobile';
+/**
+ * The canonical state clauses an assertion step may carry, exactly as documented for authors in
+ * `README.md` ("States") and in the `sungen-gherkin-syntax` skill. Deliberately CLOSED: real feature
+ * files carry trailing phrases like `is rejected` / `is active` / `is unchanged` that belong to other
+ * grammars or are prose, and reading those as state clauses would put valid steps in front of the
+ * SG-E021 gate. Widening this union widens that gate — add a member only alongside a pattern that
+ * asserts it.
+ */
+export type StateClause = 'hidden' | 'visible' | 'disabled' | 'enabled' | 'checked' | 'unchecked' | 'focused' | 'empty' | 'loading' | 'selected' | 'sorted ascending' | 'sorted descending';
 /**
  * Pattern matcher function or regex
  */
@@ -99,5 +108,19 @@ export interface StepPattern {
      * emitted when absent.
      */
     platformAlternative?: string;
+    /**
+     * State clauses this pattern's generated code ACTUALLY asserts. ABSENT = asserts none.
+     *
+     * The contract runs in one direction and is easy to get backwards: declaring a state is a promise
+     * that the emitted code checks it. A pattern that wins a step carrying an UNDECLARED state clause
+     * emits SG-E021 and compiles to a loud `throw`, because the alternative is what this field exists
+     * to prevent — the clause being silently dropped and the assertion reading as something it is not.
+     * (`see [X] page is hidden` matched `page-assertion` at a higher priority than `is-hidden`, so the
+     * clause vanished and the step asserted the OPPOSITE: that the page IS displayed.)
+     *
+     * So: under-declaring throws on valid input, over-declaring re-opens the silent-drop hole. Declare
+     * a state only after reading the template the resolver names.
+     */
+    states?: ReadonlyArray<StateClause>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/generators/test-generator/patterns/types.d.ts.map

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

package/dist/generators/test-generator/patterns/unsupported-step-code.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The step body emitted in place of code sungen cannot honestly produce — because the active adapter
+ * ships no template for it (SG-E020), because the pattern is off-platform (SG-W020), because the
+ * matched pattern would silently DROP the author's state clause (SG-E021), or because no pattern
+ * matched at all (SG-W001/SG-W011). A comment alone would let the test go GREEN having asserted
+ * nothing — the silent-loss class these diagnostics exist to close — so the step throws at run time
+ * as well as reporting at compile time.
+ *
+ * `JSON.stringify` does the quoting, NOT a hand-rolled `replace(/'/g, …)`. The reason string embeds
+ * arbitrary author text (the step sentence), and hand-escaping only the quote character is wrong for
+ * any input containing a backslash or a raw newline: a step ending `…\` would emit `'…\\'`, whose
+ * trailing escaped-backslash-then-quote breaks the literal and takes the WHOLE generated spec down
+ * with a syntax error — reopening, one level deeper, the exact "one bad step kills the file" failure
+ * this function exists to prevent. Step text here is routinely non-ASCII (Vietnamese, Japanese),
+ * which JSON.stringify also handles correctly.
+ */
+export declare function unsupportedStepCode(reason: string): string;
+//# sourceMappingURL=unsupported-step-code.d.ts.map

package/dist/generators/test-generator/patterns/unsupported-step-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-step-code.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/patterns/unsupported-step-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/generators/test-generator/patterns/unsupported-step-code.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unsupportedStepCode = unsupportedStepCode;
+/**
+ * The step body emitted in place of code sungen cannot honestly produce — because the active adapter
+ * ships no template for it (SG-E020), because the pattern is off-platform (SG-W020), because the
+ * matched pattern would silently DROP the author's state clause (SG-E021), or because no pattern
+ * matched at all (SG-W001/SG-W011). A comment alone would let the test go GREEN having asserted
+ * nothing — the silent-loss class these diagnostics exist to close — so the step throws at run time
+ * as well as reporting at compile time.
+ *
+ * `JSON.stringify` does the quoting, NOT a hand-rolled `replace(/'/g, …)`. The reason string embeds
+ * arbitrary author text (the step sentence), and hand-escaping only the quote character is wrong for
+ * any input containing a backslash or a raw newline: a step ending `…\` would emit `'…\\'`, whose
+ * trailing escaped-backslash-then-quote breaks the literal and takes the WHOLE generated spec down
+ * with a syntax error — reopening, one level deeper, the exact "one bad step kills the file" failure
+ * this function exists to prevent. Step text here is routinely non-ASCII (Vietnamese, Japanese),
+ * which JSON.stringify also handles correctly.
+ */
+function unsupportedStepCode(reason) {
+    return `throw new Error(${JSON.stringify(`[sungen] ${reason}`)});`;
+}
+//# sourceMappingURL=unsupported-step-code.js.map

package/dist/generators/test-generator/patterns/unsupported-step-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-step-code.js","sourceRoot":"","sources":["../../../../src/generators/test-generator/patterns/unsupported-step-code.ts"],"names":[],"mappings":";;AAgBA,kDAEC;AAlBD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,OAAO,mBAAmB,IAAI,CAAC,SAAS,CAAC,YAAY,MAAM,EAAE,CAAC,IAAI,CAAC;AACrE,CAAC"}

package/dist/generators/test-generator/recipe-expander.js

@@ -89,8 +89,16 @@ function expandPrimitive(prim, ctx, itemVar) {
             return { partial: 'recipe-click-text', targetExpr: expr };
         }
         case 'expectText': {
+            // `exact: true` asserts the element's WHOLE text (toHaveText) instead of a substring
+            // (toContainText) — same opt-in flag `clickText` carries. Substring stays the default so
+            // existing recipes keep their behavior.
             const o = (typeof arg === 'object' && arg !== null ? arg : {});
-            return { partial: 'recipe-expect-text', targetExpr: targetExpr(o.locator ?? '$trigger'), valueExpr: valueExpr(o.value ?? '$value') };
+            return {
+                partial: 'recipe-expect-text',
+                targetExpr: targetExpr(o.locator ?? '$trigger'),
+                valueExpr: valueExpr(o.value ?? '$value'),
+                exact: o.exact === true,
+            };
         }
         case 'expectValue': {
             const o = (typeof arg === 'object' && arg !== null ? arg : {});

package/dist/generators/test-generator/recipe-expander.js.map

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

package/dist/generators/test-generator/reset-tier.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Mobile reset tiers — how much state a scenario starts from.
+ *
+ * Web gets a clean slate for free: a URL reload is effectively a fresh state. Mobile does not. To save
+ * time, mobile automation keeps the app alive across a whole session, so the end state of one scenario
+ * becomes the start state of the next — which breaks test independence three ways: scenarios can no
+ * longer run in isolation or in parallel, a "nearly right" leftover state makes the FOLLOWING scenario
+ * fail for reasons that have nothing to do with it, and a scenario that dies mid-flow poisons every
+ * scenario after it.
+ *
+ * The reason nobody just reinstalls between scenarios is cost: a cold start is 5–30s, which across a
+ * large suite is the whole CI budget. So the state layers (local DB, cache, prefs, keychain, OS
+ * permissions) need a LADDER rather than one all-or-nothing switch — the same conclusion every major
+ * framework reached (Appium's `mobile: clearApp`, Detox's `device.reloadReactNative()`, the OS-level
+ * reset APIs in XCUITest/Espresso).
+ *
+ *   none — nothing is reset. State carries over BY DESIGN (a cart that accumulates across scenarios).
+ *   soft — terminateApp + activateApp. Clears in-memory state and the navigation stack. THE DEFAULT,
+ *          and exactly what the compiler emitted before tiers existed, so no existing suite changes.
+ *   data — soft + wipe the app's data layer (local DB, cache, prefs, keychain).
+ *   full — remove + reinstall. Also resets permissions and any install-time state.
+ *
+ * Declared per feature via `@reset:<tier>`; a run can RAISE the floor with SUNGEN_RESET_TIER without
+ * regenerating specs (resolved inside the generated spec, the same runtime model as test-data overlays).
+ */
+/** Ordered weakest → strongest. Index order IS the comparison, so never reorder this. */
+export declare const RESET_TIERS: readonly ["none", "soft", "data", "full"];
+export type ResetTier = (typeof RESET_TIERS)[number];
+/**
+ * `soft` — the behaviour the appium adapter emitted before tiers existed. Keeping it the default is
+ * what makes this feature additive: an untagged feature compiles to the same spec it did before.
+ */
+export declare const DEFAULT_RESET_TIER: ResetTier;
+/**
+ * Read the `@reset:<tier>` tag off a tag list.
+ *
+ * Returns `undefined` when no `@reset:` tag is present — deliberately NOT the default. Callers need to
+ * tell "absent" from "explicitly soft": a scenario with no tag must inherit its feature's tier, and
+ * collapsing absent into `soft` here would silently RAISE a `@reset:none` feature.
+ *
+ * An unrecognized value warns and yields the default rather than throwing, matching how `@cleanup:`
+ * handles an unknown key — a typo in a tag should not stop a build.
+ */
+export declare function parseResetTier(tags: string[]): ResetTier | undefined;
+/** The stronger of two tiers. Used to combine a declared tier with a run-level floor. */
+export declare function maxResetTier(a: ResetTier, b: ResetTier): ResetTier;
+/**
+ * One rung harder — what the NEXT scenario resets to after this one failed.
+ *
+ * A failed scenario left unknown state behind (a half-written local DB, an open modal) that a plain
+ * process relaunch does not undo, so the scenario after it deserves a stronger reset than it asked for.
+ *
+ * `none` is a FIXED POINT, on purpose. It is an explicit "state carries over" contract — a chain of
+ * scenarios building up one cart. Escalating it would silently break that contract, and the chain is
+ * already dead once one link fails, so the relaunch would only change how the rest fail, not whether.
+ *
+ * Applies to the next DIFFERENT scenario only — never to a RETRY of the one that just failed. The
+ * runner re-runs a failed scenario, and giving attempt 2 a stronger reset would break the guarantee
+ * `mochaOpts.retries` rests on: race victims recover on attempt 2, real failures fail both attempts.
+ * A dirty-state failure IS a real failure; if its retry silently got a wiped data layer it would pass,
+ * the reporter keeps the last attempt, and a scenario that only works after a wipe would ship as a
+ * clean `Passed`. That false pass is worse than the flakiness escalation was added to fix.
+ *
+ * The generated spec emits this same ladder inline; both exist so the compiler and the runtime cannot
+ * drift apart, and a test asserts they agree.
+ */
+export declare function escalateResetTier(tier: ResetTier): ResetTier;
+//# sourceMappingURL=reset-tier.d.ts.map

package/dist/generators/test-generator/reset-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-tier.d.ts","sourceRoot":"","sources":["../../../src/generators/test-generator/reset-tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,yFAAyF;AACzF,eAAO,MAAM,WAAW,2CAA4C,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAkB,CAAC;AAMpD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,CAOpE;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,CAElE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAO5D"}