@sun-asterisk/sungen 3.2.29 → 3.2.31

package/dist/generators/gherkin-parser/parent-scope-clause.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The trailing scope clause — `… in [Parent] <containerType>` and its optional `with <value>` tail.
+ *
+ * Lifted out of `parseStep` because the clause failed SILENTLY (#667): the container whitelist held
+ * five types, anything else fell through, and the unmatched words stayed inline in the sentence
+ * where the first-match extractors below simply ignored them. The step compiled clean
+ * and the assertion ran against the WHOLE page instead of the named container — a test that passes
+ * for the wrong reason, findable only by diffing the generated spec against the Gherkin.
+ *
+ * So this module answers two questions, not one:
+ *   - what the clause MEANS when it is recognized (`parentRef` / `parentType` / the value tail), and
+ *   - what was DISCARDED when it is not (`unsupportedType`), so the compiler can say so (SG-W028)
+ *     instead of quietly truncating the sentence.
+ */
+/**
+ * Container types a step may scope into. Every one of these is something that HOLDS other elements
+ * on a page; `button`, `field`, `badge` and friends are deliberately absent — a leaf cannot be a
+ * parent, and admitting one would turn a typo into a silently wrong locator rather than a report.
+ *
+ * Ordered longest-first where one type is a prefix of another (`list-item` before `list`), because
+ * the alternation is matched left-to-right: `in [X] list-item` must not resolve as `list` with a
+ * stray `-item` left behind.
+ *
+ * `header` and `footer` are NOT here, though both hold elements. The auto-inferred fallback role
+ * for them would be the page landmarks `banner`/`contentinfo`, and a `<header>` nested inside an
+ * `<article>`/`<section>` — which is exactly how a repeating card is marked up — carries neither.
+ * That fallback would match nothing and fail for a reason unreadable from the Gherkin, so the
+ * clause is refused (SG-W028) and the author is pointed at a container type that resolves.
+ */
+export declare const PARENT_CONTAINER_TYPES: readonly string[];
+export interface ParentScopeClause {
+    /** The `[Parent]` reference — a selectors.yaml key, or `{{var}}` naming the container's text. */
+    ref: string;
+    /** The container type, lowercased. */
+    type: string;
+    /** `{{var}}` name when the value tail scopes the parent BY CONTENT. */
+    valueRef?: string;
+    /** Quoted literal when the value tail scopes the parent by content without a variable. */
+    valueText?: string;
+    /** The sentence with the clause removed, so the target extractors never see the parent's tokens. */
+    remainingText: string;
+}
+/**
+ * Extract the scope clause from a step sentence.
+ *
+ * Returns `{ clause }` when a container type was recognized, `{ unsupportedType }` when the
+ * sentence carries an `in [X] <word>` clause whose `<word>` is not a container (it is dropped, and
+ * the caller reports it), or an empty object when there is no scope clause at all.
+ */
+export declare function extractParentScopeClause(text: string): {
+    clause?: ParentScopeClause;
+    unsupportedType?: string;
+};
+//# sourceMappingURL=parent-scope-clause.d.ts.map

package/dist/generators/gherkin-parser/parent-scope-clause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-scope-clause.d.ts","sourceRoot":"","sources":["../../../src/generators/gherkin-parser/parent-scope-clause.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAKnD,CAAC;AAgBF,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,aAAa,EAAE,MAAM,CAAC;CACvB;AA4BD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CA6BA"}

package/dist/generators/gherkin-parser/parent-scope-clause.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * The trailing scope clause — `… in [Parent] <containerType>` and its optional `with <value>` tail.
+ *
+ * Lifted out of `parseStep` because the clause failed SILENTLY (#667): the container whitelist held
+ * five types, anything else fell through, and the unmatched words stayed inline in the sentence
+ * where the first-match extractors below simply ignored them. The step compiled clean
+ * and the assertion ran against the WHOLE page instead of the named container — a test that passes
+ * for the wrong reason, findable only by diffing the generated spec against the Gherkin.
+ *
+ * So this module answers two questions, not one:
+ *   - what the clause MEANS when it is recognized (`parentRef` / `parentType` / the value tail), and
+ *   - what was DISCARDED when it is not (`unsupportedType`), so the compiler can say so (SG-W028)
+ *     instead of quietly truncating the sentence.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARENT_CONTAINER_TYPES = void 0;
+exports.extractParentScopeClause = extractParentScopeClause;
+/**
+ * Container types a step may scope into. Every one of these is something that HOLDS other elements
+ * on a page; `button`, `field`, `badge` and friends are deliberately absent — a leaf cannot be a
+ * parent, and admitting one would turn a typo into a silently wrong locator rather than a report.
+ *
+ * Ordered longest-first where one type is a prefix of another (`list-item` before `list`), because
+ * the alternation is matched left-to-right: `in [X] list-item` must not resolve as `list` with a
+ * stray `-item` left behind.
+ *
+ * `header` and `footer` are NOT here, though both hold elements. The auto-inferred fallback role
+ * for them would be the page landmarks `banner`/`contentinfo`, and a `<header>` nested inside an
+ * `<article>`/`<section>` — which is exactly how a repeating card is marked up — carries neither.
+ * That fallback would match nothing and fail for a reason unreadable from the Gherkin, so the
+ * clause is refused (SG-W028) and the author is pointed at a container type that resolves.
+ */
+exports.PARENT_CONTAINER_TYPES = [
+    'list-item', 'listitem', 'list',
+    'table', 'section', 'dialog', 'modal', 'drawer', 'overlay', 'form',
+    'card', 'item', 'row', 'group', 'panel', 'region', 'container',
+    'tab', 'menu',
+];
+const TYPES_ALT = exports.PARENT_CONTAINER_TYPES.join('|');
+/** `in [Parent] <containerType>` — the clause proper, without any value tail. */
+const SCOPE_CLAUSE_BASE = new RegExp(`\\s+in\\s+\\[([^\\]]+)\\]\\s+(${TYPES_ALT})\\b`, 'i');
+/** The same, plus the optional `with {{v}}` / `with "text"` tail. */
+const SCOPE_CLAUSE = new RegExp(`${SCOPE_CLAUSE_BASE.source}(?:\\s+with\\s+(\\{\\{[a-z0-9\\-._]+\\}\\}|"[^"]*"))?`, 'i');
+/** The same shape with ANY word where a container type belongs — used only to report what was lost. */
+const SCOPE_CLAUSE_ANY_TYPE = /\s+in\s+\[([^\]]+)\]\s+([\w-]+)/i;
+/**
+ * Is the `[…]` at `clauseAt` a CONTAINER, or is it the step's own target?
+ *
+ * A scope clause narrows a target, so the target's bracket must already have appeared. Without this
+ * test, `User select {{country}} in [Country Picker] dropdown` reads its one and only target as a
+ * parent — the bracket is what the step acts ON, and the `in` is English, not grammar.
+ */
+function scopesATarget(text, clauseAt) {
+    return /\[[^\]]*\]/.test(text.slice(0, clauseAt));
+}
+/**
+ * Does the segment before the scope clause already carry its own `with`?
+ *
+ * This is what keeps the value tail backward compatible. The documented grammar
+ * (`see [first] row in [apply list] table with {{job_name}}`) spends its single `with` on the
+ * TARGET, and re-reading that as a parent filter would silently invert the meaning of every such
+ * step already written. A SECOND `with` — `see [Tag] header with {{label}} in [Job Card] card with
+ * {{title}}` — cannot belong to the target, which already has one; only then does the tail bind to
+ * the parent. `[Ref]` contents are blanked first so a bracket like `[Filter With Tags]` is not
+ * mistaken for the keyword.
+ */
+function targetAlreadyHasValue(head) {
+    return /\s+with\s+/i.test(head.replace(/\[[^\]]*\]/g, ''));
+}
+/**
+ * Extract the scope clause from a step sentence.
+ *
+ * Returns `{ clause }` when a container type was recognized, `{ unsupportedType }` when the
+ * sentence carries an `in [X] <word>` clause whose `<word>` is not a container (it is dropped, and
+ * the caller reports it), or an empty object when there is no scope clause at all.
+ */
+function extractParentScopeClause(text) {
+    const match = text.match(SCOPE_CLAUSE);
+    if (!match) {
+        const loose = text.match(SCOPE_CLAUSE_ANY_TYPE);
+        return loose && scopesATarget(text, loose.index)
+            ? { unsupportedType: loose[2].toLowerCase() }
+            : {};
+    }
+    if (!scopesATarget(text, match.index))
+        return {};
+    const head = text.slice(0, match.index);
+    const tail = match[3];
+    const bindsToParent = Boolean(tail) && targetAlreadyHasValue(head);
+    // A value tail the target has already claimed stays in the sentence, exactly where it was, for the
+    // target extractors to pick up — what gets consumed is then only `in [Parent] <type>`.
+    const consumedLength = bindsToParent
+        ? match[0].length
+        : match[0].match(SCOPE_CLAUSE_BASE)[0].length;
+    const clause = {
+        ref: match[1],
+        type: match[2].toLowerCase(),
+        remainingText: head + text.slice(match.index + consumedLength),
+    };
+    if (bindsToParent) {
+        if (tail.startsWith('{{'))
+            clause.valueRef = tail.slice(2, -2);
+        else
+            clause.valueText = tail.slice(1, -1);
+    }
+    return { clause };
+}
+//# sourceMappingURL=parent-scope-clause.js.map

package/dist/generators/gherkin-parser/parent-scope-clause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-scope-clause.js","sourceRoot":"","sources":["../../../src/generators/gherkin-parser/parent-scope-clause.ts"],"names":[],"mappings":"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"}

package/dist/generators/test-generator/adapters/adapter-interface.d.ts

@@ -6,6 +6,25 @@ export interface AuthGroup {
     authRole?: string;
     scenarios: string[];
 }
+/**
+ * One statement of a hook block (`@beforeAll` / `@afterEach` / `@afterAll`). `wrap` → the template
+ * guards the statement with try/catch and records a failure under `label` (a JSON string literal,
+ * safe to paste into code); `stopOnFailure` → a failure also ends the hook right there (action
+ * steps: later steps would run on state the failed action never produced). A plain step runs
+ * unwrapped and throws as before.
+ */
+export interface HookStep {
+    comment?: string;
+    code: string;
+    wrap?: boolean;
+    stopOnFailure?: boolean;
+    label?: string;
+}
+/** Hook block render input. `collect` → declare the failure list and end with the fail-once guard. */
+export interface HookRenderData {
+    steps: HookStep[];
+    collect?: boolean;
+}
 export interface TestFileData {
     imports: string;
     featureName: string;
@@ -82,6 +101,7 @@ export interface RenderImportsOptions {
     needsMock?: boolean;
     urlAssertImports?: string;
     regexEscapeImport?: boolean;
+    checkedStateImports?: string;
 }
 export interface TestGeneratorAdapter {
     readonly frameworkName: string;
@@ -96,24 +116,9 @@ export interface TestGeneratorAdapter {
             code: string;
         }>;
     }): string;
-    renderBeforeAll(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
-    renderAfterEach(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
-    renderAfterAll(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
+    renderBeforeAll(data: HookRenderData): string;
+    renderAfterEach(data: HookRenderData): string;
+    renderAfterAll(data: HookRenderData): string;
     renderStep(templateName: string, data: any): string;
 }
 //# sourceMappingURL=adapter-interface.d.ts.map

package/dist/generators/test-generator/adapters/adapter-interface.d.ts.map

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

package/dist/generators/test-generator/adapters/appium/appium-adapter.d.ts

@@ -1,4 +1,4 @@
-import { TestGeneratorAdapter, TestFileData, ScenarioData, RenderImportsOptions } from '../adapter-interface';
+import { TestGeneratorAdapter, TestFileData, ScenarioData, RenderImportsOptions, HookRenderData } from '../adapter-interface';
 /**
  * AppiumAdapter
  * Generates WebdriverIO + Appium (Mocha) test code using Handlebars templates.
@@ -24,24 +24,9 @@ export declare class AppiumAdapter implements TestGeneratorAdapter {
             code: string;
         }>;
     }): string;
-    renderBeforeAll(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
-    renderAfterEach(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
-    renderAfterAll(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
+    renderBeforeAll(data: HookRenderData): string;
+    renderAfterEach(data: HookRenderData): string;
+    renderAfterAll(data: HookRenderData): string;
     renderStep(templateName: string, data: any): string;
 }
 //# sourceMappingURL=appium-adapter.d.ts.map

package/dist/generators/test-generator/adapters/appium/appium-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appium-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/appium/appium-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG9G;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,oBAAoB;IACxD,QAAQ,CAAC,aAAa,YAAY;IAClC,QAAQ,CAAC,aAAa,cAAc;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,cAAc,CAAiB;;IAOvC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAIrD,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAIpF,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAInF,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAInF,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAIlF,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM;CAGpD"}
+{"version":3,"file":"appium-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/appium/appium-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG9H;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,oBAAoB;IACxD,QAAQ,CAAC,aAAa,YAAY;IAClC,QAAQ,CAAC,aAAa,cAAc;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,cAAc,CAAiB;;IAOvC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAIrD,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAIpF,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAI7C,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAI7C,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAI5C,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM;CAGpD"}

package/dist/generators/test-generator/adapters/appium/appium-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"appium-adapter.js","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/appium/appium-adapter.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAExB,2DAAuD;AAEvD;;;;;;;;;GASG;AACH,MAAa,aAAa;IAMxB;QALS,kBAAa,GAAG,QAAQ,CAAC;QACzB,kBAAa,GAAG,UAAU,CAAC;QAKlC,IAAI,CAAC,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,aAAa,CAAC,OAA8B;QAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB,CAAC,IAA0D;QACzE,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,eAAe,CAAC,IAA0D;QACxE,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,eAAe,CAAC,IAA0D;QACxE,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,cAAc,CAAC,IAA0D;QACvE,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,YAAoB,EAAE,IAAS;QACxC,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF;AA1CD,sCA0CC"}
+{"version":3,"file":"appium-adapter.js","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/appium/appium-adapter.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAExB,2DAAuD;AAEvD;;;;;;;;;GASG;AACH,MAAa,aAAa;IAMxB;QALS,kBAAa,GAAG,QAAQ,CAAC;QACzB,kBAAa,GAAG,UAAU,CAAC;QAKlC,IAAI,CAAC,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,aAAa,CAAC,OAA8B;QAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB,CAAC,IAA0D;QACzE,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,eAAe,CAAC,IAAoB;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,eAAe,CAAC,IAAoB;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,cAAc,CAAC,IAAoB;QACjC,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,YAAoB,EAAE,IAAS;QACxC,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF;AA1CD,sCA0CC"}

package/dist/generators/test-generator/adapters/appium/templates/after-all.hbs

@@ -1,8 +1,26 @@
   after(async () => {
+{{#if collect}}
+    // Hook checks are collected: every failed step is recorded and the hook fails ONCE with the full list
+    const __hookFailures: string[] = [];
+{{/if}}
 {{#each steps}}
 {{#if comment}}
     // {{comment}}
 {{/if}}
+{{#if wrap}}
+    try {
+{{code}}
+    } catch (e) {
+      __hookFailures.push({{label}} + ': ' + String((e as Error).message).split('\n')[0]);
+{{#if stopOnFailure}}
+      if (__hookFailures.length) throw new Error('[sungen] hook preconditions not met:\n' + __hookFailures.join('\n'));
+{{/if}}
+    }
+{{else}}
 {{code}}
+{{/if}}
 {{/each}}
+{{#if collect}}
+    if (__hookFailures.length) throw new Error('[sungen] hook preconditions not met:\n' + __hookFailures.join('\n'));
+{{/if}}
   });

package/dist/generators/test-generator/adapters/appium/templates/after-each.hbs

@@ -1,8 +1,26 @@
   afterEach(async () => {
+{{#if collect}}
+    // Hook checks are collected: every failed step is recorded and the hook fails ONCE with the full list
+    const __hookFailures: string[] = [];
+{{/if}}
 {{#each steps}}
 {{#if comment}}
     // {{comment}}
 {{/if}}
+{{#if wrap}}
+    try {
+{{code}}
+    } catch (e) {
+      __hookFailures.push({{label}} + ': ' + String((e as Error).message).split('\n')[0]);
+{{#if stopOnFailure}}
+      if (__hookFailures.length) throw new Error('[sungen] hook preconditions not met:\n' + __hookFailures.join('\n'));
+{{/if}}
+    }
+{{else}}
 {{code}}
+{{/if}}
 {{/each}}
+{{#if collect}}
+    if (__hookFailures.length) throw new Error('[sungen] hook preconditions not met:\n' + __hookFailures.join('\n'));
+{{/if}}
   });

package/dist/generators/test-generator/adapters/appium/templates/before-all.hbs

@@ -1,8 +1,26 @@
   before(async () => {
+{{#if collect}}
+    // Hook checks are collected: every failed step is recorded and the hook fails ONCE with the full list
+    const __hookFailures: string[] = [];
+{{/if}}
 {{#each steps}}
 {{#if comment}}
     // {{comment}}
 {{/if}}
+{{#if wrap}}
+    try {
+{{code}}
+    } catch (e) {
+      __hookFailures.push({{label}} + ': ' + String((e as Error).message).split('\n')[0]);
+{{#if stopOnFailure}}
+      if (__hookFailures.length) throw new Error('[sungen] hook preconditions not met:\n' + __hookFailures.join('\n'));
+{{/if}}
+    }
+{{else}}
 {{code}}
+{{/if}}
 {{/each}}
+{{#if collect}}
+    if (__hookFailures.length) throw new Error('[sungen] hook preconditions not met:\n' + __hookFailures.join('\n'));
+{{/if}}
   });

package/dist/generators/test-generator/adapters/appium/templates/steps/actions/click-at-position-action.hbs

@@ -0,0 +1 @@
+throw new Error('[sungen] "click … at position/offset" is web-only — tap the control the position targets directly ("User tap [X] button"), or tag the scenario @manual');

package/dist/generators/test-generator/adapters/appium/templates/steps/actions/click-element-with-text.hbs

@@ -1,2 +1,2 @@
 {{!-- Tap an element by its visible text / content-desc (dynamic text match). --}}
-{{#if nth}}await $$('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]')[{{nth}}].click();{{else}}await $('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]').click();{{/if}}
+{{#if (gte nth -1)}}await (await $$('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]')).at({{nth}}).click();{{else}}await $('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]').click();{{/if}}

package/dist/generators/test-generator/adapters/appium/templates/steps/actions/double-click-action.hbs

@@ -1,6 +1,13 @@
 {{!-- Double-tap. Use the platform gesture (element.doubleClick is web-oriented). --}}
 {
   const __el = await {{> locator}};
+  // Fail loud with the REAL cause when the element never resolved. `driver.execute` does NOT do
+  // WDIO's implicit existence wait (every other action template gets that for free by going
+  // through .click()/.setValue()/expect), and the locator partial returns $(selector) even for a
+  // never-found element by design. So an undefined elementId reaches Appium, which falls through
+  // to its coordinates branch and reports "Double click offset coordinates must be provided if
+  // element is not set" — a message about offsets for what is really a not-found element (#668).
+  if (!__el.elementId) throw new Error((__el as any).error?.message || `Element not found: ${__el.selector}`);
   if (driver.isIOS) await driver.execute('mobile: doubleTap', { elementId: __el.elementId });
   else await driver.execute('mobile: doubleClickGesture', { elementId: __el.elementId });
 }

package/dist/generators/test-generator/adapters/appium/templates/steps/actions/frame-enter-action.hbs

@@ -1,6 +1,3 @@
-{{!-- Hybrid app: switch into the webview context (mobile equivalent of entering an iframe). --}}
-{
-  const __ctxs = await driver.getContexts();
-  const __web = __ctxs.find(c => /WEBVIEW|CHROMIUM/i.test(typeof c === 'string' ? c : c.id));
-  if (__web) await driver.switchContext(typeof __web === 'string' ? __web : __web.id);
-}
+{{!-- Hybrid app: switch into the webview context (mobile equivalent of entering an iframe).
+      Polls for the context and throws when it never appears — see __enterWebContext (#705). --}}
+await __enterWebContext('{{escapeQuotes frameRef}}');

package/dist/generators/test-generator/adapters/appium/templates/steps/actions/table-paginate-action.hbs

@@ -0,0 +1,3 @@
+{{!-- An HTML paginator is a web control: a native list pages by scrolling, not by a next/prev
+      button pair, so there is nothing honest to emit here. --}}
+throw new Error("[sungen] 'go to next/prev page in table' drives an HTML paginator and is not supported on the appium adapter. Scroll the list instead, tap the pager control as a plain tap step, or tag this scenario @manual.");

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/visible-assertion.hbs

@@ -8,7 +8,7 @@
 await expect({{> locator}}).toBeDisplayed();
 {{~else if scope~}}
 await expect({{> locator}}).toBeDisplayed();
-{{~else if nth~}}
+{{~else if (gte nth -1)~}}
 await expect({{> locator}}).toBeDisplayed();
 {{~else~}}
 await __assertVisible({{> appium-selector-expr}});

package/dist/generators/test-generator/adapters/appium/templates/steps/gestures/long-press-action.hbs

@@ -1,4 +1,8 @@
 await (async () => { const e = await {{> locator}};
+  // Fail loud on a missing target — `driver.execute` skips WDIO's implicit existence wait, so an
+  // undefined elementId surfaces as an opaque coordinates/offset error instead of the not-found
+  // that actually happened (#668).
+  if (!e.elementId) throw new Error((e as any).error?.message || `Element not found: ${e.selector}`);
   // XCUITest `mobile: touchAndHold` takes SECONDS; UiAutomator2 `mobile: longClickGesture` takes ms.
   if (driver.isIOS) { await driver.execute('mobile: touchAndHold', { elementId: e.elementId, duration: {{durationMs}} / 1000 }); }
   else { await driver.execute('mobile: longClickGesture', { elementId: e.elementId, duration: {{durationMs}} }); }

package/dist/generators/test-generator/adapters/appium/templates/steps/gestures/pinch-zoom-action.hbs

@@ -1,4 +1,8 @@
 await (async () => { const e = await {{> locator}};
+  // Fail loud on a missing target — `driver.execute` skips WDIO's implicit existence wait, so an
+  // undefined elementId surfaces as an opaque coordinates/offset error instead of the not-found
+  // that actually happened (#668).
+  if (!e.elementId) throw new Error((e as any).error?.message || `Element not found: ${e.selector}`);
   // XCUITest `mobile: pinch`: scale >1 zooms in, <1 zooms out (velocity sign must match).
   if (driver.isIOS) { await driver.execute('mobile: pinch', { elementId: e.elementId, scale: {{#if zoomOut}}0.5{{else}}2{{/if}}, velocity: {{#if zoomOut}}-1{{else}}1{{/if}} }); }
   else { await driver.execute('mobile: {{#if zoomOut}}pinchCloseGesture{{else}}pinchOpenGesture{{/if}}', { elementId: e.elementId, percent: 0.75 }); }

package/dist/generators/test-generator/adapters/appium/templates/steps/partials/locator.hbs

@@ -9,7 +9,15 @@
       scroll-into-view, so a below-fold / nav-occluded element is scrolled into the safe band before any
       find/tap/assert (Appium has no auto-scroll). Parent/scope/nth chains keep the plain `$()` — those
       resolve within a container / by index where a blind scroll doesn't apply.
+      `nth` is an INDEX, gated numerically (`gte nth -1`), not on truthiness (#720): `{{#if nth}}` read
+      `nth: 0` — the index every doc page uses as its example — as "no index declared" and sent it down
+      the __ensureVisible branch, while the web adapter indexed it, so the two adapters disagreed on the
+      one value authors actually write. It renders `(await $$(expr)).at(n)`: `$$` is a
+      ChainablePromiseArray in WDIO v9, so the old `$$(expr)[n]` indexed a promise and was `undefined`
+      for EVERY n (the awaited form is what the mobile helpers elsewhere in the emitted spec already
+      use), and `.at()` carries `-1` = last match with no second branch. The resolver has already
+      normalised anything outside `>= -1` to undefined and reported it as SG-W018.
       `plain=true` (passed by is-hidden-assertion) also forces the bare `$()`: an element asserted HIDDEN
       is expected to be absent, so scroll-hunting for it is both pointless and harmful — the 12x down-scroll
       would drag the screen to the bottom and strand later same-scenario steps that sit above. --}}
-{{~#if parentLocator~}}{{parentLocator}}.{{#if nth}}$$({{> appium-selector-expr}})[{{nth}}]{{else}}$({{> appium-selector-expr}}){{/if}}{{~else~}}{{#if scope}}$('~{{escapeQuotes scope}}').{{#if nth}}$$({{> appium-selector-expr}})[{{nth}}]{{else}}$({{> appium-selector-expr}}){{/if}}{{else}}{{#if nth}}$$({{> appium-selector-expr}})[{{nth}}]{{else}}{{#if plain}}$({{> appium-selector-expr}}){{else}}(await __ensureVisible({{> appium-selector-expr}})){{/if}}{{/if}}{{/if}}{{~/if~}}
+{{~#if parentLocator~}}{{#if (gte nth -1)}}(await {{parentLocator}}.$$({{> appium-selector-expr}})).at({{nth}}){{else}}{{parentLocator}}.$({{> appium-selector-expr}}){{/if}}{{~else~}}{{#if scope}}{{#if (gte nth -1)}}(await $('~{{escapeQuotes scope}}').$$({{> appium-selector-expr}})).at({{nth}}){{else}}$('~{{escapeQuotes scope}}').$({{> appium-selector-expr}}){{/if}}{{else}}{{#if (gte nth -1)}}(await $$({{> appium-selector-expr}})).at({{nth}}){{else}}{{#if plain}}$({{> appium-selector-expr}}){{else}}(await __ensureVisible({{> appium-selector-expr}})){{/if}}{{/if}}{{/if}}{{~/if~}}

package/dist/generators/test-generator/adapters/appium/templates/test-file.hbs

@@ -210,6 +210,36 @@ async function __assertCheckedState(el: WebdriverIO.Element, expected: boolean,
   }
   throw new Error(`Expect ${label} to be ${want} — read [${signals.map(s => `${s.source} → ${s.value}`).join(', ')}]`);
 }
+
+// Entering a "frame" on a native driver means switching into the WebView CONTEXT — there is no
+// iframe to locate. That context does not exist until the WebView runtime has created it, and the
+// tap that kicks off the navigation returns long before that, so a ONE-SHOT getContexts() reads a
+// list that holds only NATIVE_APP. Skipping the switch on that reading is the worst possible
+// answer: every later step then searches the native tree, where a hybrid WebView is a SINGLE
+// opaque leaf with no children — the target can never appear there, so no downstream wait can
+// recover it and the run dies with a misleading "element still not displayed" (#705). Poll for the
+// context instead, and throw when it never arrives: a step that reads "switch to X frame" must
+// never quietly not switch.
+async function __enterWebContext(label: string): Promise<void> {
+  const budget = Number((driver as any)?.options?.waitforTimeout) || 30000;
+  const deadline = Date.now() + budget;
+  let seen: any[] = [];
+  for (;;) {
+    seen = await driver.getContexts();
+    const web = seen.find(c => /WEBVIEW|CHROMIUM/i.test(typeof c === 'string' ? c : c.id));
+    if (web) { await driver.switchContext(typeof web === 'string' ? web : web.id); return; }
+    if (Date.now() >= deadline) break;
+    await driver.pause(500);
+  }
+  throw new Error(
+    `[sungen] "switch to ${label} frame" — no WEBVIEW/CHROMIUM context appeared within ${budget}ms ` +
+    `(contexts seen: ${JSON.stringify(seen)}). The driver is still in NATIVE_APP, where a hybrid WebView ` +
+    `is one opaque node with no children, so every later step would fail as "element not displayed" ` +
+    `while the real cause is this switch. If the transition is genuinely slower than ${budget}ms, raise ` +
+    `waitforTimeout in wdio.conf.ts; if the screen has no WebView, drop the frame step and assert the ` +
+    `native markers instead.`,
+  );
+}
 {{#if singleAuthRole}}
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -340,23 +370,25 @@ describe('{{featureName}}', () => {
   // @auth:{{singleAuthRole}} — authenticate ONCE before any scenario; the session persists across
   // the per-scenario relaunch below (noReset:true). Throws (blocks the spec) if login can't be done.
   before(async () => {
-{{#if appPackage}}
     // Relaunch to a known launch screen first — the session may attach to the app in any state.
     // Platform-aware id (NOT the Android literal): on iOS a @platform:mobile feature's app is the
     // dual-id bundle id — a literal appPackage here would throw and block the whole spec.
-    // (__resolveAppId is a hoisted function declaration in this describe scope.)
+    // (__resolveAppId is a hoisted function declaration in this describe scope. It is no longer
+    // gated on a `Path:`-derived package (#669): it resolves the session capability too, and throws
+    // a named error when nothing supplies an id at all.)
     const __AUTH_APP__ = __resolveAppId();
     try { await driver.terminateApp(__AUTH_APP__); } catch { /* not running */ }
     await driver.activateApp(__AUTH_APP__);
-{{/if}}
     await __ensureAuth('{{singleAuthRole}}');
   });
 
 {{/if}}
-{{#if appPackage}}
   // Multi-app: this feature's app (from the `Path:` line). Reset to its launch screen before each
   // scenario so one `wdio run` can host screens from different apps — each spec launches its own.
   // The `Path:` holds the ANDROID package (or, for an @platform:ios feature, the iOS bundle id).
+  // EMPTY when the feature declared no usable `Path:` (#669) — the session capability then supplies
+  // the id (see __resolveAppId). Emitted unconditionally so that a feature without a `Path:` still
+  // gets per-scenario reset + Background instead of silently dropping to a once-per-file before().
   const __APP_PKG_DEFAULT__ = '{{appPackage}}';
 {{#if iosBundleId}}
   // Per-feature iOS bundle id from the dual-id `Path: <androidPkg>/<activity> | <iosBundleId>` —
@@ -366,13 +398,26 @@ describe('{{featureName}}', () => {
 {{/if}}
   // Platform-aware app id: an @platform:mobile spec runs on BOTH OSes. On iOS prefer the feature's own
   // bundle id (dual-id Path), then the session cap (IOS_BUNDLE_ID in wdio.conf), then the Path value;
-  // on Android (or any non-iOS session) use the Path package unchanged.
+  // on Android (or any non-iOS session) prefer the Path package, then the session cap.
+  // The session-capability fallback (#669) is what lets a feature with no app-package `Path:` keep a
+  // real per-scenario reset: wdio.conf sets `appium:appPackage` for the run, so the id the compiler
+  // could not read off the feature file is almost always present here. Throwing when NOTHING supplies
+  // it is deliberate — the alternative was the silent once-per-file before() this issue is about,
+  // where scenarios leak tab/scroll/login state into each other and the suite lies about why it
+  // failed. SG-W029 already named this at compile time, so this throw is never the first warning.
   function __resolveAppId(): string {
-    if (typeof driver !== 'undefined' && driver.isIOS) {
-      const caps = (driver.requestedCapabilities || {}) as Record<string, string>;
-      return {{#if iosBundleId}}__IOS_BUNDLE__ || {{/if}}caps['appium:bundleId'] || caps['bundleId'] || __APP_PKG_DEFAULT__;
+    const caps = (typeof driver !== 'undefined' ? (driver.requestedCapabilities || {}) : {}) as Record<string, string>;
+    const resolved = (typeof driver !== 'undefined' && driver.isIOS)
+      ? ({{#if iosBundleId}}__IOS_BUNDLE__ || {{/if}}caps['appium:bundleId'] || caps['bundleId'] || __APP_PKG_DEFAULT__ || caps['appium:appPackage'] || caps['appPackage'])
+      : (__APP_PKG_DEFAULT__ || caps['appium:appPackage'] || caps['appPackage'] || caps['appium:bundleId'] || caps['bundleId']);
+    if (!resolved) {
+      throw new Error(
+        `[sungen] cannot resolve this app's id, so no per-scenario reset is possible (SG-W029). ` +
+        `Add an app-package \`Path:\` to the feature — \`Path: com.example.app/.MainActivity\` — ` +
+        `or set APP_PACKAGE (Android) / IOS_BUNDLE_ID (iOS) so wdio.conf puts it on the session.`,
+      );
     }
-    return __APP_PKG_DEFAULT__;
+    return resolved;
   }
   // ── Reset tier ────────────────────────────────────────────────────────────────────────────────
   // How much state each scenario starts from (`@reset:` on the Feature; default `soft`):
@@ -583,20 +628,6 @@ describe('{{featureName}}', () => {
 {{/if}}
   });
 
-{{/if}}
-{{#unless appPackage}}
-{{#if backgroundSteps}}
-  before(async () => {
-{{#each backgroundSteps}}
-{{#if comment}}
-    // {{comment}}
-{{/if}}
-{{code}}
-{{/each}}
-  });
-
-{{/if}}
-{{/unless}}
 {{#if beforeAll}}
 {{beforeAll}}
 

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

@@ -1,4 +1,4 @@
-export { TestGeneratorAdapter, TestFileData, ScenarioData, StepTemplateData, LocatorExpression } from './adapter-interface';
+export { TestGeneratorAdapter, TestFileData, ScenarioData, StepTemplateData, LocatorExpression, HookStep, HookRenderData } from './adapter-interface';
 export { AdapterRegistry, adapterRegistry, DriverNotInstalledError } from './adapter-registry';
 export { PlaywrightAdapter } from './playwright/playwright-adapter';
 export { AppiumAdapter } from './appium/appium-adapter';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5H,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/test-generator/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtJ,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}