@sun-asterisk/sungen 3.2.22-beta.1 → 3.2.22

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

@@ -2,6 +2,15 @@ import { $, $$, expect, driver, browser } from '@wdio/globals';
 {{#if runtimeData}}
 import { TestDataLoader } from '{{basePath}}/test-data';
 {{/if}}
+{{#if needsDb}}
+import { db } from '{{basePath}}/db';
+{{/if}}
+{{#if needsApi}}
+import { api } from '{{basePath}}/api';
+{{/if}}
+{{#if needsMock}}
+import { mock } from '{{basePath}}/mock';
+{{/if}}
 
 // This file is auto-generated from Gherkin feature files
 // DO NOT EDIT MANUALLY - changes will be overwritten

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

@@ -1,8 +1,30 @@
+{{#if casesDataset}}
+  for (const __row of testData.cases('{{casesDataset}}')) {
+{{#if tags}}
+  it('{{escapeQuotes scenarioName}} — ' + __row.__label + ' [{{{tags}}}]', async () => {
+{{else}}
+  it('{{escapeQuotes scenarioName}} — ' + __row.__label, async () => {
+{{/if}}
+    const rowData = testData.withRow(__row);
+{{#each steps}}
+{{#if comment}}
+    // {{comment}}
+{{/if}}
+{{code}}
+{{/each}}
+  });
+  }
+{{else}}
+{{#if tags}}
+  it('{{escapeQuotes scenarioName}} [{{{tags}}}]', async () => {
+{{else}}
   it('{{escapeQuotes scenarioName}}', async () => {
+{{/if}}
 {{#each steps}}
 {{#if comment}}
     // {{comment}}
 {{/if}}
 {{code}}
 {{/each}}
-  });
+  });
+{{/if}}

package/dist/generators/test-generator/adapters/appium/templates/steps/actions/capture-row-column.hbs

@@ -0,0 +1,2 @@
+{{!-- Table row/column capture targets HTML <table> roles — not available on native mobile. --}}
+throw new Error("[sungen] 'remember column in table row' targets HTML table roles and is not supported on the appium adapter. Use a list / accessibility-id read instead, or tag this scenario @manual.");

package/dist/generators/test-generator/adapters/appium/templates/steps/actions/capture-variable.hbs

@@ -0,0 +1,10 @@
+{{!-- Capture (mobile): multi-source read mirrors contain-text-assertion (Android @text /
+      @content-desc, iOS label/value). capture: 'inputValue' means the input's OWN value —
+      prioritize iOS `value` and Android's raw `text` attribute over the label/content-desc. --}}
+{
+  const __el = await {{> locator}};
+  const __sources = driver.isIOS
+    ? {{#if (eq capture 'inputValue')}}[await __el.getAttribute('value'), await __el.getAttribute('label')]{{else}}[await __el.getAttribute('label'), await __el.getAttribute('value')]{{/if}}
+    : [await __el.getText(), await __el.getAttribute('content-desc')];
+  testData.set('{{escapeQuotes varName}}', String(__sources.find(s => s && String(s).trim() !== '') ?? '').trim());
+}

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

@@ -0,0 +1,7 @@
+{{!-- Native alert (mobile): unlike web (handler set BEFORE the trigger), mobile alerts appear
+      AFTER the triggering action — click first, then best-effort accept/dismiss (ignore if no
+      alert appears; mirrors alert-accept-action.hbs / alert-dismiss-action.hbs). --}}
+{
+  await {{> locator}}.click();
+  try { await driver.{{#if (eq dialogAction 'dismiss')}}dismissAlert{{else}}acceptAlert{{/if}}(); } catch { /* no native alert present */ }
+}

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

@@ -1,2 +1,14 @@
-{{!-- Drag the source element onto the target. WebdriverIO dragAndDrop drives W3C touch actions. --}}
-await (await {{> locator}}).dragAndDrop(await $('{{#switch targetStrategy}}{{#case 'accessibility-id'}}~{{escapeQuotes targetValue}}{{/case}}{{#case 'testid'}}~{{escapeQuotes targetValue}}{{/case}}{{#case 'xpath'}}{{escapeQuotes targetValue}}{{/case}}{{#case 'android-uiautomator'}}android={{escapeQuotes targetValue}}{{/case}}{{#case 'id'}}id={{escapeQuotes targetValue}}{{/case}}{{#default}}~{{#if targetValue}}{{escapeQuotes targetValue}}{{else}}{{escapeQuotes targetName}}{{/if}}{{/default}}{{/switch}}'));
+{{!-- Drag the source element onto the target. WebdriverIO dragAndDrop drives W3C touch actions.
+
+      The TARGET selector is rendered by the canonical `appium-selector` partial, NOT by a switch
+      of its own. This file used to hand-roll one covering 5 of the 13 strategies that partial
+      knows, and its default branch preferred `targetValue` over `targetName` — backwards for the
+      `role` strategy, where the resolver puts the generic role type in `value` ('button') and the
+      real accessible label in `name` ('Submit'). Since `role` is the DEFAULT strategy for buttons,
+      links and headings, a drag onto a role-resolved target aimed at `~button`.
+      It was invisible until C3: before that, the target FIELDS were never passed at all (only a
+      pre-built Playwright locator string), so the switch fell through with everything undefined
+      and emitted `$('~')` — broken, but obviously so. C3 populated the fields and turned an
+      obvious break into a plausible-looking wrong one. Delegating removes the second copy of a
+      mapping that only ever needed one. --}}
+await (await {{> locator}}).dragAndDrop(await $('{{> appium-selector strategy=targetStrategy value=targetValue name=targetName}}'));

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

@@ -0,0 +1,3 @@
+{{!-- No hover on touch devices — no-op, mirrors hover-action.hbs. (A text-filtered hover target
+      is normally already visible on mobile; if a tap on the matching element is actually
+      required, use `User tap [X] item with {{value}}` instead.) --}}

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

@@ -0,0 +1,2 @@
+{{!-- Positional table row actions target HTML <table> roles — not available on native mobile. --}}
+throw new Error("[sungen] 'table action in row (nth)' targets HTML table roles and is not supported on the appium adapter. Use list / accessibility-id steps, or tag this scenario @manual.");

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

@@ -0,0 +1,17 @@
+{{!-- All-contain (mobile): $$ over the base selector, per-OS multi-source text read (same idiom
+      as contain-text-assertion), substring check on every match — no CSS filter() combinator
+      exists on Appium, so this loop replaces it. --}}
+{
+  const __items_{{stepCounter}} = await $$({{> appium-selector-expr}});
+  if (__items_{{stepCounter}}.length === 0) throw new Error('[sungen] Expected at least one [{{escapeQuotes selectorRef}}]');
+  const __expected_{{stepCounter}} = String('{{escapeQuotes expectedText}}').trim();
+  for (const __el_{{stepCounter}} of __items_{{stepCounter}}) {
+    const __sources_{{stepCounter}} = driver.isIOS
+      ? [await __el_{{stepCounter}}.getAttribute('label'), await __el_{{stepCounter}}.getAttribute('value')]
+      : [await __el_{{stepCounter}}.getText(), await __el_{{stepCounter}}.getAttribute('content-desc')];
+    const __actual_{{stepCounter}} = String(__sources_{{stepCounter}}.find(s => s && String(s).trim() !== '') ?? '').trim();
+    if (!__actual_{{stepCounter}}.includes(__expected_{{stepCounter}})) {
+      throw new Error(`[sungen] Expected [{{escapeQuotes selectorRef}}] text containing "${__expected_{{stepCounter}} }" but found "${__actual_{{stepCounter}} }"`);
+    }
+  }
+}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/all-contain-element.hbs

@@ -0,0 +1,13 @@
+{{!-- Q2 all-card structural assertion (mobile): every container element must hold the child.
+      WebdriverIO's $$() returns a live element ARRAY, not a lazy Locator — there is no `.nth()`
+      (that is Playwright's API). Enumerate by index and chain off the array element itself via
+      `.$()` (WDIO findElementFromElement). --}}
+{
+  const {{containerVar}} = await $$('{{> appium-selector}}');
+  if ({{containerVar}}.length === 0) {
+    throw new Error('[sungen] Expected at least one [{{escapeQuotes selectorRef}}]');
+  }
+  for (let {{containerIndexVar}} = 0; {{containerIndexVar}} < {{containerVar}}.length; {{containerIndexVar}}++) {
+    await expect({{#with child}}{{> locator parentLocator=(add (add (add ../containerVar "[") ../containerIndexVar) "]")}}{{/with}}).toBeDisplayed();
+  }
+}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/disabled-with-filter-assertion.hbs

@@ -0,0 +1,26 @@
+{{!-- Filtered disabled (mobile): $$ over the base selector, per-OS text read matched against
+      dataValue — no CSS filter() combinator exists on Appium, so the match is hand-rolled.
+      Assert the matching element is not enabled.
+
+      The `__found` guard is load-bearing, NOT defensive noise. Playwright's twin
+      (`expect(locator.filter(...)).toBeDisabled()`) FAILS when the filtered locator matches
+      nothing, because a Playwright locator re-queries and times out. WDIO's `$$()` returns an
+      already-resolved ARRAY, so an assertion placed only inside the match branch simply never
+      runs when nothing matches — the scenario then passes having asserted NOTHING. That safety
+      property comes free on web and has to be reproduced by hand here.
+      (`hidden-with-filter-assertion` deliberately has no such guard: Playwright's `toBeHidden()`
+      also passes on a zero-match locator, since "not attached" counts as hidden. `toBeDisabled()`
+      has no such exemption — absent is not disabled.) --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __items = await $$({{> appium-selector-expr}});
+  let __found = false;
+  for (const __el of __items) {
+    const __sources = driver.isIOS
+      ? [await __el.getAttribute('label'), await __el.getAttribute('value')]
+      : [await __el.getText(), await __el.getAttribute('content-desc')];
+    const __actual = String(__sources.find(s => s && String(s).trim() !== '') ?? '').trim();
+    if (__actual === __expected) { __found = true; await expect(__el).not.toBeEnabled(); }
+  }
+  if (!__found) throw new Error(`[sungen] No element with text "${__expected}" to assert disabled — the assertion never ran`);
+}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/disabled-with-role-variable-assertion.hbs

@@ -0,0 +1,24 @@
+{{!-- Role variable, disabled (mobile best-effort): mirrors hidden-with-role-variable-assertion —
+      a static name scopes the search via the role→accessibility-id mapping in
+      appium-selector.hbs, then dataValue filters by per-OS text within that scope; with no name,
+      search directly by dataValue text. Assert the matching element(s) are not enabled. --}}
+{{#if name}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __items = await $$('~{{escapeQuotes name}}');
+  let __found = false;
+  for (const __el of __items) {
+    const __s = driver.isIOS ? [await __el.getAttribute('label'), await __el.getAttribute('value')] : [await __el.getText(), await __el.getAttribute('content-desc')];
+    if (String(__s.find(s => s && String(s).trim() !== '') ?? '').trim() === __expected) { __found = true; await expect(__el).not.toBeEnabled(); }
+  }
+  {{!-- Guard: with no match the loop body never runs, so the step would pass having asserted
+        nothing. See disabled-with-filter-assertion for why `disabled` needs this and `hidden` does not. --}}
+  if (!__found) throw new Error(`[sungen] No element with text "${__expected}" to assert disabled — the assertion never ran`);
+}
+{{else}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __sel = driver.isIOS ? `-ios predicate string:label == "${__expected}" OR value == "${__expected}"` : `android=new UiSelector().text("${__expected}")`;
+  await expect($(__sel)).not.toBeEnabled();
+}
+{{/if}}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/disabled-with-variable-assertion.hbs

@@ -0,0 +1,9 @@
+{{!-- Disabled by value (mobile): search directly for an element whose text/label/value equals
+      dataValue (same idiom as label-value-assertion) and assert it is not enabled. --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __sel = driver.isIOS
+    ? `-ios predicate string:label == "${__expected}" OR value == "${__expected}"`
+    : `android=new UiSelector().text("${__expected}")`;
+  await expect($(__sel)).not.toBeEnabled();
+}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/hidden-dialog-heading-assertion.hbs

@@ -0,0 +1,10 @@
+{{!-- Dialog heading, hidden (mobile best-effort): mirrors visible-dialog-heading-assertion —
+      search for the heading text directly (no native "dialog" role to scope to) and assert it
+      is not displayed. --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __sel = driver.isIOS
+    ? `-ios predicate string:label == "${__expected}" OR value == "${__expected}"`
+    : `android=new UiSelector().text("${__expected}")`;
+  await expect($(__sel)).not.toBeDisplayed();
+}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/hidden-with-filter-assertion.hbs

@@ -0,0 +1,14 @@
+{{!-- Filtered hidden (mobile): $$ over the base selector, per-OS text read (contain-text-assertion
+      idiom) matched against dataValue — no CSS filter() combinator exists on Appium, so the match
+      is hand-rolled. Assert none of the matching elements is displayed. --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __items = await $$({{> appium-selector-expr}});
+  for (const __el of __items) {
+    const __sources = driver.isIOS
+      ? [await __el.getAttribute('label'), await __el.getAttribute('value')]
+      : [await __el.getText(), await __el.getAttribute('content-desc')];
+    const __actual = String(__sources.find(s => s && String(s).trim() !== '') ?? '').trim();
+    if (__actual === __expected) await expect(__el).not.toBeDisplayed();
+  }
+}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/hidden-with-role-variable-assertion.hbs

@@ -0,0 +1,21 @@
+{{!-- Role variable, hidden (mobile best-effort): role has no native-mobile analog. A static name
+      scopes the search via the role→accessibility-id mapping in appium-selector.hbs, then
+      dataValue filters by per-OS text within that scope; with no name, search directly by
+      dataValue text like hidden-with-variable-assertion. Assert none of the matches is
+      displayed. --}}
+{{#if name}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __items = await $$('~{{escapeQuotes name}}');
+  for (const __el of __items) {
+    const __s = driver.isIOS ? [await __el.getAttribute('label'), await __el.getAttribute('value')] : [await __el.getText(), await __el.getAttribute('content-desc')];
+    if (String(__s.find(s => s && String(s).trim() !== '') ?? '').trim() === __expected) await expect(__el).not.toBeDisplayed();
+  }
+}
+{{else}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __sel = driver.isIOS ? `-ios predicate string:label == "${__expected}" OR value == "${__expected}"` : `android=new UiSelector().text("${__expected}")`;
+  await expect($(__sel)).not.toBeDisplayed();
+}
+{{/if}}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/hidden-with-variable-assertion.hbs

@@ -0,0 +1,10 @@
+{{!-- Hidden by value (mobile): no base selector to filter — search directly for an element
+      whose text/label/value equals dataValue (same idiom as label-value-assertion) and assert
+      it is not displayed. --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __sel = driver.isIOS
+    ? `-ios predicate string:label == "${__expected}" OR value == "${__expected}"`
+    : `android=new UiSelector().text("${__expected}")`;
+  await expect($(__sel)).not.toBeDisplayed();
+}

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/row-scoped-column-assertion.hbs

@@ -0,0 +1,2 @@
+{{!-- Row-scoped column assertions target HTML <table> ARIA roles — not available on native mobile. --}}
+throw new Error("[sungen] row-scoped column assertion targets HTML table roles and is not supported on the appium adapter. Use list / accessibility-id assertions, or tag this scenario @manual.");

package/dist/generators/test-generator/adapters/appium/templates/steps/assertions/state-with-filter-assertion.hbs

@@ -0,0 +1,23 @@
+{{!-- State-with-filter (mobile): $$ over the base selector, per-OS text read (hand-rolled — no
+      CSS filter() combinator on Appium) matched against dataValue, then assert the state on the
+      match. checked/selected map to the composite-row attribute (mirrors checked-assertion);
+      empty is a text read; enabled/focused use direct WDIO matchers. A state with no
+      native-mobile analog (sorted*, aria-busy loading) fails loud, matching sorted-assertion's
+      house style. --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __items = await $$({{> appium-selector-expr}});
+  let __el: WebdriverIO.Element | undefined;
+  for (const __c of __items) {
+    const __s = driver.isIOS ? [await __c.getAttribute('label'), await __c.getAttribute('value')] : [await __c.getText(), await __c.getAttribute('content-desc')];
+    if (String(__s.find(s => s && String(s).trim() !== '') ?? '').trim() === __expected) { __el = __c; break; }
+  }
+  if (!__el) throw new Error(`[sungen] No match with text "${__expected}" to assert state on`);
+  {{#if (or selectedProbe (eq stateAssertion "toBeChecked()"))}}await expect(__el).toHaveAttribute(driver.isIOS ? 'value' : 'checked', driver.isIOS ? '1' : 'true');
+  {{else if (eq stateAssertion "toBeChecked({ checked: false })")}}await expect(__el).not.toHaveAttribute(driver.isIOS ? 'value' : 'checked', driver.isIOS ? '1' : 'true');
+  {{else if (eq stateAssertion "toBeEnabled()")}}await expect(__el).toBeEnabled();
+  {{else if (eq stateAssertion "toBeFocused()")}}await expect(__el).toBeFocused();
+  {{else if (eq stateAssertion "toBeEmpty()")}}await expect(__el).toHaveText('');
+  {{else}}throw new Error('[sungen] state qualifier has no native-mobile equivalent — tag this scenario @manual.');
+  {{/if}}
+}

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

@@ -0,0 +1,2 @@
+{{!-- Browser localStorage/sessionStorage has no native-mobile equivalent. --}}
+throw new Error("[sungen] browser local/session storage is web-only and has no native-mobile equivalent. Assert the equivalent app state via a UI element, or via @api/@query against the backend, or tag this scenario @manual.");

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

@@ -0,0 +1,3 @@
+{{!-- Keyboard tab order is a web-only accessibility concern — no keyboard focus traversal on
+      native touch input. --}}
+throw new Error("[sungen] tab order assertions are web-only (keyboard focus traversal) and have no native-mobile equivalent. Run a keyboard/accessibility audit manually and tag this scenario @manual.");

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

@@ -0,0 +1,10 @@
+{{!-- Dialog heading, visible (mobile best-effort): no native "dialog" role — a native alert and
+      an in-app modal both render their heading as ordinary text, so search for it directly (same
+      idiom as label-value-assertion) and assert displayed. --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __sel = driver.isIOS
+    ? `-ios predicate string:label == "${__expected}" OR value == "${__expected}"`
+    : `android=new UiSelector().text("${__expected}")`;
+  await expect($(__sel)).toBeDisplayed();
+}

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

@@ -0,0 +1,17 @@
+{{!-- Filtered visible (mobile): $$ over the base selector, per-OS text read matched against
+      dataValue — no CSS filter() combinator exists on Appium, so the match is hand-rolled
+      (covers both the locator- and role-strategy call sites, since both resolve through
+      appium-selector-expr). Assert at least one match is displayed. --}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __items = await $$({{> appium-selector-expr}});
+  let __found = false;
+  for (const __el of __items) {
+    const __sources = driver.isIOS
+      ? [await __el.getAttribute('label'), await __el.getAttribute('value')]
+      : [await __el.getText(), await __el.getAttribute('content-desc')];
+    const __actual = String(__sources.find(s => s && String(s).trim() !== '') ?? '').trim();
+    if (__actual === __expected && await __el.isDisplayed()) { __found = true; break; }
+  }
+  if (!__found) throw new Error(`[sungen] Expected a visible match with text "${__expected}"`);
+}

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

@@ -0,0 +1,13 @@
+{{!-- Role variable, visible (mobile best-effort): ARIA role has no native-mobile analog — reuse
+      the role→accessibility-id mapping in appium-selector.hbs (`~name`) when a static name
+      exists; the resolver already folds dataValue into name when there is none, so this is only
+      the fallback for a caller that omits both. --}}
+{{#if name}}
+await expect($('~{{escapeQuotes name}}')).toBeDisplayed();
+{{else}}
+{
+  const __expected = String('{{escapeQuotes dataValue}}').trim();
+  const __sel = driver.isIOS ? `-ios predicate string:label == "${__expected}" OR value == "${__expected}"` : `android=new UiSelector().text("${__expected}")`;
+  await expect($(__sel)).toBeDisplayed();
+}
+{{/if}}

package/dist/generators/test-generator/adapters/appium/templates/steps/navigation/wait-table-refresh.hbs

@@ -0,0 +1,13 @@
+{{!-- Table refresh (mobile): no aria-busy analog — `indicator` is a raw WDIO selector string
+      from qa/app.yaml. Soft-wait for it to appear (it may already be gone), hard-wait for it to
+      clear; if it never appears within the soft window, fall back to a short settle pause
+      instead of hanging on an indicator this app never shows. --}}
+{
+  const __indicator = $('{{escapeQuotes indicator}}');
+  const __appeared = await __indicator.waitForDisplayed({ timeout: 1500 }).catch(() => false);
+  if (__appeared) {
+    await __indicator.waitForDisplayed({ reverse: true, timeout: 15000 });
+  } else {
+    await driver.pause(500);
+  }
+}

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/drag-action.hbs

@@ -1 +1 @@
-await {{> locator}}.dragTo({{targetLocator}});
+await {{> locator}}.dragTo({{#switch targetStrategy}}{{#case 'role'}}{{#if targetName}}page.getByRole('{{targetRole}}', { name: '{{escapeQuotes targetName}}' }){{else}}page.getByRole('{{targetRole}}'){{/if}}{{/case}}{{#case 'testid'}}page.getByTestId('{{escapeQuotes targetValue}}'){{/case}}{{#case 'text'}}page.getByText('{{escapeQuotes targetValue}}'){{/case}}{{#case 'locator'}}page.locator('{{escapeQuotes targetValue}}'){{/case}}{{#default}}page.getByText('{{escapeQuotes targetRef}}'){{/default}}{{/switch}});

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

@@ -1 +1 @@
-const frame = page.frameLocator('{{value}}');
+const frame = page.frameLocator('{{escapeQuotes frameSelector}}');

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/all-contain-element.hbs

@@ -1,8 +1,8 @@
 {
-    const __cards_{{stepCounter}} = {{> locator}};
-    const __n_{{stepCounter}} = await __cards_{{stepCounter}}.count();
-    expect(__n_{{stepCounter}}, 'Expected at least one [{{selectorRef}}]').toBeGreaterThan(0);
-    for (let __i_{{stepCounter}} = 0; __i_{{stepCounter}} < __n_{{stepCounter}}; __i_{{stepCounter}}++) {
-      await expect({{#with child}}{{> locator}}{{/with}}, 'Every [{{selectorRef}}] must contain [{{childRef}}]').toBeVisible();
+    const {{containerVar}} = {{> locator}};
+    const __n_{{stepCounter}} = await {{containerVar}}.count();
+    expect(__n_{{stepCounter}}, 'Expected at least one [{{escapeQuotes selectorRef}}]').toBeGreaterThan(0);
+    for (let {{containerIndexVar}} = 0; {{containerIndexVar}} < __n_{{stepCounter}}; {{containerIndexVar}}++) {
+      await expect({{#with child}}{{> locator parentLocator=(add (add (add ../containerVar ".nth(") ../containerIndexVar) ")")}}{{/with}}, 'Every [{{escapeQuotes selectorRef}}] must contain [{{escapeQuotes childRef}}]').toBeVisible();
     }
   }

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/row-scoped-column-assertion.hbs

@@ -0,0 +1 @@
+{{!-- Column assertion scoped to the current row (`tableRow`, bound by the row-in-table entry step that ran before this one). columnIndex uses `isDefined` rather than a bare truthy check: column 0 is a valid index. --}}{{#if (isDefined columnIndex)}}await expect(tableRow.getByRole('cell', { includeHidden: true }).filter({ visible: true }).nth({{columnIndex}})).toHaveText('{{escapeQuotes cellValue}}');{{else if isGiven}}await tableRow.getByRole('cell', { includeHidden: true }).filter({ hasText: '{{escapeQuotes cellValue}}' }).filter({ visible: true }).waitFor();{{else}}await expect(tableRow.getByRole('cell', { includeHidden: true }).filter({ hasText: '{{escapeQuotes cellValue}}' }).filter({ visible: true })).toBeVisible();{{/if}}

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

@@ -1 +1 @@
-{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../../../src/generators/test-generator/code-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA8B,MAAM,mBAAmB,CAAC;AAI9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA0NrD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAM;IAErB,OAAO,CAAC,eAAe,CAAc;IAErC,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAiBtK,oFAAoF;IACpF,cAAc,IAAI,oBAAoB;IAItC;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IA0EzB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAS7C;;OAEG;IACH;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;YASzB,gBAAgB;YA6ShB,uBAAuB;YAYvB,kBAAkB;YAoBlB,YAAY;IAqB1B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;YASlB,gBAAgB;IAmJ9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB;IAyBpB,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC;CA+D5B"}
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../../../src/generators/test-generator/code-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA8B,MAAM,mBAAmB,CAAC;AAI9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAqOrD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAM;IAErB,OAAO,CAAC,eAAe,CAAc;IAErC,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAiBtK,oFAAoF;IACpF,cAAc,IAAI,oBAAoB;IAItC;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IA0EzB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAS7C;;OAEG;IACH;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;YASzB,gBAAgB;YA0ThB,uBAAuB;YAYvB,kBAAkB;YAoBlB,YAAY;IAqB1B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;YASlB,gBAAgB;IAoJ9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB;IAyBpB,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC;CA+D5B"}

package/dist/generators/test-generator/code-generator.js

@@ -74,21 +74,31 @@ function extractCleanupFlags(tags) {
     return found ? flags : undefined;
 }
 /**
- * Extract pass-through tags (non-functional) for Playwright { tag: [...] }.
- * Any tag not recognized by sungen as functional → pass through.
+ * Extract pass-through tags (non-functional) — the unique, unformatted tag tokens (e.g. `@smoke`).
+ * Any tag not recognized by sungen as functional → pass through. Formatting is adapter-specific
+ * (Playwright wants a quoted `{ tag: [...] }` array; Appium/mocha has no such option and instead
+ * appends the tags to the `it()` title — see `formatPassThroughTags`).
  */
 const FUNCTIONAL_TAG_PREFIXES = [
     '@parallel', '@serial', '@cleanup:', '@auth:', '@manual', '@no-auth',
     '@steps:', '@extend:', '@screenshot:', '@beforeAll', '@afterEach', '@afterAll',
-    '@flow', '@cases:', '@deferred:', '@owned-by:',
+    '@flow', '@cases:', '@deferred:', '@owned-by:', '@platform:',
 ];
 function extractPassThroughTags(scenarioTags, featureTags) {
     const allTags = [...featureTags, ...scenarioTags];
     const passThrough = allTags.filter(tag => !FUNCTIONAL_TAG_PREFIXES.some(prefix => tag.startsWith(prefix)));
-    const unique = [...new Set(passThrough)];
-    if (unique.length === 0)
+    return [...new Set(passThrough)];
+}
+/**
+ * Format the unique pass-through tags for the active adapter's `ScenarioData.tags` field:
+ *   - Playwright: `'@smoke', '@high'` — spliced verbatim into `{ tag: [...] }` (see scenario.hbs).
+ *   - Appium: `@smoke @high` — appended to the mocha `it()` title (D5) so `--grep` still filters,
+ *     since mocha has no per-test tag/annotation option like Playwright's.
+ */
+function formatPassThroughTags(tags, frameworkName) {
+    if (tags.length === 0)
         return undefined;
-    return unique.map(t => `'${t}'`).join(', ');
+    return frameworkName === 'appium' ? tags.join(' ') : tags.map(t => `'${t}'`).join(', ');
 }
 /**
  * Derive a feature's unit from its source path: the catalog-resolution id (relative to qa/), the
@@ -651,6 +661,16 @@ class CodeGenerator {
         // - Single group: flat structure (test.use at describe level if auth)
         // - Multiple groups: nested describes per auth role
         const needsGrouping = authGroups.length > 1;
+        // D6 — the Appium test-file template has no per-group before-hook (only `singleAuthRole` runs
+        // `__ensureAuth`); >1 auth group would render every group's scenarios with NO authentication at
+        // all, silently. Mirrors the web `@parallel` guard below, but unconditional (isParallel has no
+        // per-group meaning on mobile — the template never branches on it).
+        if (needsGrouping && this.adapter.frameworkName === 'appium') {
+            const roles = groupOrder.map(k => k || '(no @auth)').join(', ');
+            throw new Error(`Feature "${feature.name}" has multiple auth groups (${roles}) but the Appium adapter only ` +
+                `supports a single shared auth role per feature — the other groups would run unauthenticated.\n` +
+                `Fix: split "${feature.name}" into one feature file per @auth role.`);
+        }
         if (needsGrouping && !isParallel) {
             throw new Error(`Feature "${feature.name}" has multiple auth groups but no @parallel tag.\n` +
                 `Serial mode uses a shared browser context — it cannot mix different auth roles.\n` +
@@ -874,8 +894,9 @@ class CodeGenerator {
                 });
             }
         }
-        // Extract pass-through tags (feature + scenario, excluding functional tags)
-        const tags = extractPassThroughTags(scenario.tags, featureTags);
+        // Extract pass-through tags (feature + scenario, excluding functional tags), formatted for
+        // the active adapter (Playwright `{ tag: [...] }` vs. Appium's mocha-title suffix — D5).
+        const tags = formatPassThroughTags(extractPassThroughTags(scenario.tags, featureTags), this.adapter.frameworkName);
         // Use adapter to render scenario
         const rendered = this.adapter.renderScenario({
             scenarioName: scenario.name,