@sun-asterisk/sungen 3.2.28 → 3.2.30

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":";AAAA;;;;;;;;;;;;;GAaG;;;AAoFH,4DAgCC;AAlHD;;;;;;;;;;;;;;GAcG;AACU,QAAA,sBAAsB,GAAsB;IACvD,WAAW,EAAE,UAAU,EAAE,MAAM;IAC/B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM;IAClE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW;IAC9D,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,MAAM,SAAS,GAAG,8BAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEnD,iFAAiF;AACjF,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAAC,iCAAiC,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC;AAE5F,qEAAqE;AACrE,MAAM,YAAY,GAAG,IAAI,MAAM,CAC7B,GAAG,iBAAiB,CAAC,MAAM,uDAAuD,EAClF,GAAG,CACJ,CAAC;AAEF,uGAAuG;AACvG,MAAM,qBAAqB,GAAG,kCAAkC,CAAC;AAejE;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,QAAgB;IACnD,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CAAC,IAAY;IAInD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAChD,OAAO,KAAK,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,KAAM,CAAC;YAC/C,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE;YAC7C,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,KAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAElD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACnE,mGAAmG;IACnG,uFAAuF;IACvF,MAAM,cAAc,GAAG,aAAa;QAClC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;QACjB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEjD,MAAM,MAAM,GAAsB;QAChC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACb,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC5B,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAM,GAAG,cAAc,CAAC;KAChE,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,IAAK,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,QAAQ,GAAG,IAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;;YAC5D,MAAM,CAAC,SAAS,GAAG,IAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

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/os-support.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The per-OS axis of the step-support matrix, DERIVED from each Appium template's own body.
+ *
+ * The Web|Mobile columns answer "does a template exist". They cannot answer the question that
+ * actually bites: a template can ship, compile, and still do nothing on one of the two mobile
+ * runtimes. `hide-keyboard-action` is guarded `if (!driver.isIOS && …)` — on iOS the step compiles,
+ * runs, and silently skips. Nothing in the matrix showed that, so nobody could see iOS drifting
+ * behind Android, which is exactly what the Android-first decision needs to be able to see.
+ *
+ * Derived, never declared. A hand-written per-OS column is the same mistake the spec made when it
+ * claimed capabilities the code did not have: two sources of truth, one of them wrong, no gate to
+ * catch it. Reading the template body means the column cannot lie for longer than a regenerate.
+ *
+ * A template mentioning `driver.isIOS` in a shape this file does not recognise is a THROW, never a
+ * default. Defaulting to 'yes' would let a new one-sided template enter the matrix reported as
+ * working on both — the precise failure the axis exists to prevent.
+ */
+/**
+ * Strip handlebars comments so a body is judged by what it EXECUTES, never by prose ABOUT iOS.
+ * Several templates explain their per-OS reasoning at length in a `{{!-- … --}}` block; counting
+ * that as code would classify half the adapter wrongly.
+ */
+export declare const stripComments: (src: string) => string;
+/**
+ * How a template behaves on ONE mobile OS.
+ *   yes      — real implementation on this OS
+ *   refuses  — the OS branch throws, naming the alternative: loud, and therefore safe
+ *   noop     — the OS is guarded OUT with no throw: compiles, runs, does nothing. The dangerous one
+ *   inherit  — the template never branches on OS, so both OSes are whatever the Mobile column says
+ */
+export type OsSupport = 'yes' | 'refuses' | 'noop' | 'inherit';
+export interface OsPair {
+    android: OsSupport;
+    ios: OsSupport;
+}
+/**
+ * Per-OS support for one Appium template, read off its body.
+ *
+ * @throws when the template branches on `driver.isIOS` in an unrecognised shape — deliberately, so
+ *         the drift gate goes red and a human teaches this file the new shape, rather than the
+ *         matrix quietly claiming the step works on both.
+ */
+export declare function osSupportOf(name: string, src: string): OsPair;
+/**
+ * Per-OS support for a template BY NAME, memoized — the compile-time `@platform:ios` gate asks this
+ * once per distinct template per run.
+ *
+ * Returns null when the appium adapter ships no such template: that is a different failure (the
+ * step is not a mobile step at all) which the existing template-resolution path already reports, so
+ * answering "unsupported on iOS" here would be a second, misleading message for one cause.
+ */
+export declare function osSupportOfTemplate(name: string): OsPair | null;
+//# sourceMappingURL=os-support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"os-support.d.ts","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/appium/os-support.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAC+B,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,MAAM;IAAG,OAAO,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,SAAS,CAAA;CAAE;AAqE9D;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAqB7D;AAqBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW/D"}

package/dist/generators/test-generator/adapters/appium/os-support.js

@@ -0,0 +1,200 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripComments = void 0;
+exports.osSupportOf = osSupportOf;
+exports.osSupportOfTemplate = osSupportOfTemplate;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * The per-OS axis of the step-support matrix, DERIVED from each Appium template's own body.
+ *
+ * The Web|Mobile columns answer "does a template exist". They cannot answer the question that
+ * actually bites: a template can ship, compile, and still do nothing on one of the two mobile
+ * runtimes. `hide-keyboard-action` is guarded `if (!driver.isIOS && …)` — on iOS the step compiles,
+ * runs, and silently skips. Nothing in the matrix showed that, so nobody could see iOS drifting
+ * behind Android, which is exactly what the Android-first decision needs to be able to see.
+ *
+ * Derived, never declared. A hand-written per-OS column is the same mistake the spec made when it
+ * claimed capabilities the code did not have: two sources of truth, one of them wrong, no gate to
+ * catch it. Reading the template body means the column cannot lie for longer than a regenerate.
+ *
+ * A template mentioning `driver.isIOS` in a shape this file does not recognise is a THROW, never a
+ * default. Defaulting to 'yes' would let a new one-sided template enter the matrix reported as
+ * working on both — the precise failure the axis exists to prevent.
+ */
+/**
+ * Strip handlebars comments so a body is judged by what it EXECUTES, never by prose ABOUT iOS.
+ * Several templates explain their per-OS reasoning at length in a `{{!-- … --}}` block; counting
+ * that as code would classify half the adapter wrongly.
+ */
+const stripComments = (src) => src.replace(/\{\{!--[\s\S]*?--\}\}/g, '').replace(/\{\{![^}]*?\}\}/g, '');
+exports.stripComments = stripComments;
+/** Worse wins: a template with both a per-OS read and an iOS refusal is an iOS refusal. */
+const RANK = { inherit: 0, yes: 1, noop: 2, refuses: 3 };
+const worse = (a, b) => (RANK[b] > RANK[a] ? b : a);
+/**
+ * The statement (or block) an `if (…)` condition guards.
+ *
+ * Brace-matched rather than regex-matched because the distinction that matters is whether a `throw`
+ * sits INSIDE the OS branch. `swipe-action` throws for a not-found element and implements iOS fully;
+ * a file-level `/throw/` test would read that as an iOS refusal and put a lie in the table.
+ */
+function guardedBody(code, from) {
+    let i = from;
+    while (i < code.length && /\s/.test(code[i]))
+        i++;
+    if (code[i] !== '{') {
+        // Braceless form — `if (driver.isIOS) await x(); else await y();` (double-click-action).
+        const end = code.indexOf(';', i);
+        return code.slice(i, end === -1 ? code.length : end);
+    }
+    let depth = 0;
+    for (let j = i; j < code.length; j++) {
+        if (code[j] === '{')
+            depth++;
+        else if (code[j] === '}' && --depth === 0)
+            return code.slice(i + 1, j);
+    }
+    return code.slice(i); // unbalanced source — the caller's fail-loud path reports it
+}
+const startsWithThrow = (body) => /^\s*throw\b/.test(body);
+/**
+ * Classify one `driver.isIOS` occurrence. Returns null when the shape is unrecognised, which the
+ * caller turns into a throw.
+ */
+function classifyOccurrence(code, at) {
+    const before = code.slice(0, at).replace(/\s+$/, '');
+    const negated = before.endsWith('!');
+    const after = code.slice(at + 'driver.isIOS'.length);
+    // `driver.isIOS ? <ios> : <android>` — a per-OS read, both arms real. The `?` may sit on the
+    // NEXT line: every assertion template formats the ternary across three lines, so a same-line
+    // test would miss twenty templates and report them unrecognised.
+    if (!negated && /^\s*\?/.test(after))
+        return { android: 'yes', ios: 'yes' };
+    // Condition forms. `)` closes the `if (`, so the guarded body starts after it.
+    const closeParen = after.indexOf(')');
+    if (closeParen === -1)
+        return null;
+    // Anything other than whitespace/`&&`-chained conditions between the flag and the `)` means a
+    // shape this file has not been taught to read.
+    const between = after.slice(0, closeParen);
+    if (!/^[\s)]*$/.test(between) && !/^\s*&&/.test(between))
+        return null;
+    const body = guardedBody(after, closeParen + 1);
+    if (negated) {
+        // `!driver.isIOS` guards the ANDROID path.
+        //   with a throw  → Android refuses (the mirror case; none exists today, and if one is added
+        //                   it must not be silently reported as an iOS no-op)
+        //   without       → iOS is skipped with no signal at all: 'noop'
+        return startsWithThrow(body)
+            ? { android: 'refuses', ios: 'yes' }
+            : { android: 'yes', ios: 'noop' };
+    }
+    // `driver.isIOS` guards the iOS path: a leading throw is a refusal, anything else is real code
+    // (the `else` arm carries Android either way).
+    return startsWithThrow(body) ? { android: 'yes', ios: 'refuses' } : { android: 'yes', ios: 'yes' };
+}
+/**
+ * Per-OS support for one Appium template, read off its body.
+ *
+ * @throws when the template branches on `driver.isIOS` in an unrecognised shape — deliberately, so
+ *         the drift gate goes red and a human teaches this file the new shape, rather than the
+ *         matrix quietly claiming the step works on both.
+ */
+function osSupportOf(name, src) {
+    const code = (0, exports.stripComments)(src);
+    if (!code.includes('driver.isIOS'))
+        return { android: 'inherit', ios: 'inherit' };
+    let pair = { android: 'yes', ios: 'yes' };
+    let seen = 0;
+    for (let i = code.indexOf('driver.isIOS'); i !== -1; i = code.indexOf('driver.isIOS', i + 1)) {
+        const one = classifyOccurrence(code, i);
+        if (!one) {
+            throw new Error(`[step-support-matrix] ${name}.hbs branches on driver.isIOS in a shape os-support.ts cannot read ` +
+                `(at offset ${i}). Teach classifyOccurrence() the new shape — do NOT let it default, or the ` +
+                `matrix will report a one-sided template as working on both.\n` +
+                `  context: ${JSON.stringify(code.slice(Math.max(0, i - 40), i + 80))}`);
+        }
+        seen++;
+        pair = { android: worse(pair.android, one.android), ios: worse(pair.ios, one.ios) };
+    }
+    if (!seen)
+        throw new Error(`[step-support-matrix] ${name}.hbs mentions driver.isIOS but no occurrence classified`);
+    return pair;
+}
+/** Appium step templates, the same tree `renderStep` searches. */
+const TEMPLATES_DIR = path.join(__dirname, 'templates', 'steps');
+const cache = new Map();
+/** Locate `<name>.hbs` anywhere under the appium step tree (excluding `partials/`). */
+function findTemplate(dir, file) {
+    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (e.isDirectory()) {
+            if (e.name === 'partials')
+                continue;
+            const hit = findTemplate(path.join(dir, e.name), file);
+            if (hit)
+                return hit;
+        }
+        else if (e.name === file) {
+            return path.join(dir, e.name);
+        }
+    }
+    return null;
+}
+/**
+ * Per-OS support for a template BY NAME, memoized — the compile-time `@platform:ios` gate asks this
+ * once per distinct template per run.
+ *
+ * Returns null when the appium adapter ships no such template: that is a different failure (the
+ * step is not a mobile step at all) which the existing template-resolution path already reports, so
+ * answering "unsupported on iOS" here would be a second, misleading message for one cause.
+ */
+function osSupportOfTemplate(name) {
+    if (cache.has(name))
+        return cache.get(name) ?? null;
+    let pair = null;
+    try {
+        const file = findTemplate(TEMPLATES_DIR, `${name}.hbs`);
+        if (file)
+            pair = osSupportOf(name, fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        pair = null; // an unreadable tree must not break codegen; the matrix gate reports it instead
+    }
+    cache.set(name, pair);
+    return pair;
+}
+//# sourceMappingURL=os-support.js.map

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

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

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}}
   });