@sun-asterisk/sungen 3.2.0-beta.142 → 3.2.0-beta.143

package/src/generators/test-generator/adapters/appium/templates/steps/actions/frame-exit-action.hbs

@@ -0,0 +1,2 @@
+{{!-- Back to the native context. --}}
+await driver.switchContext('NATIVE_APP');

package/src/generators/test-generator/adapters/appium/templates/steps/actions/hide-keyboard-action.hbs

@@ -0,0 +1,4 @@
+// Hide the soft keyboard (best-effort — never fails if no keyboard is shown).
+// iOS XCUITest cannot dismiss the keyboard generically (WDA throws + retries, ~12s wasted),
+// and XCUITest taps/asserts work with the keyboard up — so the dismiss is Android-only.
+try { if (!driver.isIOS && await driver.isKeyboardShown()) await driver.hideKeyboard(); } catch { /* no keyboard / not supported */ }

package/src/generators/test-generator/adapters/appium/templates/steps/actions/hover-action.hbs

@@ -0,0 +1,2 @@
+{{!-- No hover on touch devices — no-op. (Hover-revealed content is normally already visible on mobile;
+      if a tap is actually required, use `User tap [X]` instead.) --}}

package/src/generators/test-generator/adapters/appium/templates/steps/actions/keyboard-global-action.hbs

@@ -0,0 +1,2 @@
+{{!-- Global key event (no target). On Android, Escape maps to the system Back button. --}}
+{{#if (eq key 'Escape')}}await driver.back();{{else}}await driver.keys('{{key}}');{{/if}}

package/src/generators/test-generator/adapters/appium/templates/steps/actions/press-action.hbs

@@ -0,0 +1,4 @@
+{{!-- Press a key on a field (e.g. Enter after filling a search box). Focus the field, then send the
+      W3C key event — UiAutomator2/XCUITest translate it to a real key press. --}}
+await {{> locator}}.click();
+await driver.keys('{{key}}');

package/src/generators/test-generator/adapters/appium/templates/steps/actions/radio-select-action.hbs

@@ -0,0 +1,4 @@
+{{!-- Mobile radios have no ARIA "radio" role to query by name, so tap the option by its
+      accessibility-id / content-desc (= the option value). If the visible label differs from the
+      element's accessibility-id, add an explicit selector for the option and reference it instead. --}}
+await $('~{{escapeQuotes selectValue}}').click();

package/src/generators/test-generator/adapters/appium/templates/steps/actions/scroll-action.hbs

@@ -0,0 +1,19 @@
+if (driver.isIOS) {
+  // iOS (XCUITest) has no UiScrollable. Swipe the screen up in bounded steps until the target is on
+  // screen (a below-fold element isn't in the XCUITest tree until scrolled, so getElementRect/tap on
+  // it would otherwise fail). Bounded so a missing target can't loop forever.
+  const __t = $({{> appium-selector-expr}});
+  for (let __i = 0; __i < 12 && !(await __t.isDisplayed().catch(() => false)); __i++) {
+    await driver.execute('mobile: swipe', { direction: 'up' });
+  }
+} else {
+{{#if (eq strategy 'accessibility-id')}}
+  // Android UiScrollable scrolls until the target's content-desc is on screen, then stops — no
+  // overshoot (which would drop a virtualized Flutter item from the a11y tree). Robust on Flutter/RN.
+  await $('android=new UiScrollable(new UiSelector().scrollable(true)).scrollIntoView(new UiSelector().descriptionContains("{{escapeQuotes value}}"))');
+{{else}}
+  // Generic fallback: framework-agnostic moderate scroll gesture (wdio .scrollIntoView() can't always
+  // find a native ScrollView on Flutter/RN). Modest percent avoids over-scrolling a virtualized list.
+  await driver.execute('mobile: scrollGesture', { left: 60, top: 420, width: 960, height: 1320, direction: 'down', percent: 0.6 });
+{{/if}}
+}

package/src/generators/test-generator/adapters/appium/templates/steps/actions/select-action.hbs

@@ -0,0 +1,5 @@
+{{!-- Native dropdown/picker: open the control, then tap the option by accessibility-id /
+      content-desc (= the option value). Two taps because there is no native <select>.selectOption
+      on mobile. If the option's accessibility-id differs from its label, add an explicit selector. --}}
+await {{> locator}}.click();
+await $('~{{escapeQuotes selectValue}}').click();

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

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

package/src/generators/test-generator/adapters/appium/templates/steps/actions/toggle-action.hbs

@@ -0,0 +1,3 @@
+{{!-- A switch/toggle flips state on tap (mirrors the web toggle pattern: unconditional click).
+      Use `check`/`uncheck` instead when you need to drive it to a specific on/off state idempotently. --}}
+await {{> locator}}.click();

package/src/generators/test-generator/adapters/appium/templates/steps/actions/uncheck-action.hbs

@@ -0,0 +1,8 @@
+{{!-- WebdriverIO/Appium has no .uncheck(). Tap only if currently on, so the step is idempotent. --}}
+{
+  const __cb = await {{> locator}};
+  let __on = false;
+  try { __on = await __cb.isSelected(); }
+  catch { try { __on = (await __cb.getAttribute('checked')) === 'true'; } catch { /* state unreadable — leave as-is */ } }
+  if (__on) await __cb.click();
+}

package/src/generators/test-generator/adapters/appium/templates/steps/actions/unknown-element-action.hbs

@@ -0,0 +1,2 @@
+{{!-- Fallback for an unrecognized action: tap an element by text / content-desc. --}}
+await $('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]').click();

package/src/generators/test-generator/adapters/appium/templates/steps/actions/upload-action.hbs

@@ -0,0 +1,3 @@
+{{!-- File upload is not auto-generatable on native mobile (no <input type=file>): it needs app-specific
+      handling (driver.pushFile + the app's own picker, or a deep link). Fail loud so it isn't a silent skip. --}}
+throw new Error("[sungen] upload step ('{{fileName}}') is not supported on the appium adapter — handle the file picker app-specifically (driver.pushFile + picker) or tag this scenario @manual.");

package/src/generators/test-generator/adapters/appium/templates/steps/actions/wait-for-page.hbs

@@ -0,0 +1,3 @@
+{{!-- No URL/page concept on mobile. Pause briefly to let the screen settle; prefer a screen-marker
+      assertion (`Then User see [X] ...`) over waiting for a "page". --}}
+await driver.pause(500);

package/src/generators/test-generator/adapters/appium/templates/steps/actions/wait-for-role-with-data.hbs

@@ -0,0 +1,2 @@
+{{!-- No ARIA role on mobile; wait for an element carrying the given text instead. --}}
+await $('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]').waitForDisplayed();

package/src/generators/test-generator/adapters/appium/templates/steps/actions/wait-for-role.hbs

@@ -0,0 +1,3 @@
+{{!-- ARIA roles don't exist on native mobile; no element to wait for from a role alone. Pause briefly.
+      Rewrite as `wait for [Element]` for a real wait. --}}
+await driver.pause(500);

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/alert-text-assertion.hbs

@@ -0,0 +1,2 @@
+{{!-- Assert the native alert's text. --}}
+expect(await driver.getAlertText()).toContain('{{escapeQuotes expectedText}}');

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/attribute-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).toHaveAttribute('{{attribute}}', '{{escapeQuotes dataValue}}');

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/checked-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).toBeSelected();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/clipboard-text-assertion.hbs

@@ -0,0 +1,2 @@
+{{!-- Assert the device clipboard content (decode the base64 Appium returns). --}}
+expect(Buffer.from(await driver.getClipboard(), 'base64').toString()).toContain(String({{#if dataRef}}testData.get('{{dataRef}}'){{else}}'{{escapeQuotes expectedValue}}'{{/if}}));

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/column-cell-assertion.hbs

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

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/contain-text-assertion.hbs

@@ -0,0 +1,14 @@
+{{!-- Partial-text assertion (mobile): same multi-source read as have-text-assertion
+      (@text / @content-desc on Android, label/value on iOS), substring match. --}}
+{
+  const __el = await {{> locator}};
+  await __el.waitForDisplayed();
+  const __expected = String('{{escapeQuotes expectedText}}').trim();
+  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.includes(__expected)) {
+    throw new Error(`[sungen] Expected text containing "${__expected}" but element reads "${__actual}"`);
+  }
+}

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/count-assertion.hbs

@@ -0,0 +1 @@
+await expect($$('{{> appium-selector}}')).toBeElementsArrayOfSize({{expectedCount}});

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/disabled-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).not.toBeEnabled();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/empty-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).toHaveText('');

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/enabled-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).toBeEnabled();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/focused-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).toBeFocused();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/have-text-assertion.hbs

@@ -0,0 +1,15 @@
+{{!-- Text assertion (mobile): native trees scatter text across @text (Android RN/native),
+      @content-desc (Android Flutter Semantics) and label/value (iOS). Read the first
+      non-empty source and compare exactly (trimmed). --}}
+{
+  const __el = await {{> locator}};
+  await __el.waitForDisplayed();
+  const __expected = String('{{escapeQuotes expectedText}}').trim();
+  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) {
+    throw new Error(`[sungen] Expected text "${__expected}" but element reads "${__actual}"`);
+  }
+}

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/have-value-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).toHaveValue('{{escapeQuotes dataValue}}');

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/is-hidden-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).not.toBeDisplayed();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/label-value-assertion.hbs

@@ -0,0 +1,12 @@
+{{!-- Label-value assertion (mobile): locate a visible text node carrying the value.
+      Android renders text into @text; iOS (RN/Flutter) into @label/@value. The web variant
+      matches "label: value" as one string — native trees keep label and value as separate
+      nodes, so only the value is matched here. The expected value must stay a standalone
+      quoted literal so the runtime-data transform can swap it for testData.get(...). --}}
+{
+  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/src/generators/test-generator/adapters/appium/templates/steps/assertions/list-item-count-assertion.hbs

@@ -0,0 +1,2 @@
+{{!-- Count the elements matching the list locator (mobile has no role="listitem"). --}}
+await expect($$('{{> appium-selector}}')).toBeElementsArrayOfSize({{expectedCount}});

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/loading-assertion.hbs

@@ -0,0 +1,2 @@
+{{!-- Mobile has no aria-busy; assert the loading indicator element itself is visible. --}}
+await expect({{> locator}}).toBeDisplayed();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/not-checked-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).not.toBeSelected();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/page-assertion.hbs

@@ -0,0 +1 @@
+// page/URL assertion is not applicable on mobile (no URL) — [{{value}}]

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/route-assertion.hbs

@@ -0,0 +1,2 @@
+{{!-- URL/route assertions have no equivalent on native mobile (no address bar). --}}
+throw new Error("[sungen] URL/route assertions are web-only — assert a screen marker (`Then User see [X] ...`) instead, or tag this scenario @manual.");

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/selected-assertion.hbs

@@ -0,0 +1 @@
+await expect({{> locator}}).toBeSelected();

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/sorted-assertion.hbs

@@ -0,0 +1,2 @@
+{{!-- aria-sort has no native-mobile equivalent. --}}
+throw new Error("[sungen] 'sorted' assertion (aria-sort) is web-only and has no native-mobile equivalent. Verify order by reading element texts and comparing, or tag this scenario @manual.");

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/table-column-exists.hbs

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

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/table-empty.hbs

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

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/table-match-data.hbs

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

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/table-row-count.hbs

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

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/table-row-exists.hbs

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

package/src/generators/test-generator/adapters/appium/templates/steps/assertions/table-row-not-exists.hbs

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

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

@@ -0,0 +1 @@
+await expect({{> locator}}).toBeDisplayed();

package/src/generators/test-generator/adapters/appium/templates/steps/gestures/background-action.hbs

@@ -0,0 +1 @@
+await driver.background({{seconds}});

package/src/generators/test-generator/adapters/appium/templates/steps/gestures/grant-permission-action.hbs

@@ -0,0 +1,11 @@
+{{!-- Grant a runtime permission to the app under test so an OS dialog can't block the flow.
+      Android: `mobile: changePermissions` (appPackage read from the running session — multi-app safe).
+      iOS (Simulator only): `mobile: setPermission` with the bundle id from the active app.
+      iOS PREREQUISITE: the `applesimutils` binary (`brew tap wix/brew && brew install applesimutils`)
+      — without it the driver fails loud with that exact install hint. --}}
+if (driver.isIOS) {
+  const __app = (await driver.execute('mobile: activeAppInfo')) as { bundleId?: string };
+  await driver.execute('mobile: setPermission', { bundleId: __app?.bundleId, access: { '{{iosService}}': 'yes' } });
+} else {
+  await driver.execute('mobile: changePermissions', { action: 'grant', appPackage: await driver.getCurrentPackage(), permissions: ['{{permission}}'] });
+}

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

@@ -0,0 +1,5 @@
+await (async () => { const e = await {{> locator}};
+  // 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/src/generators/test-generator/adapters/appium/templates/steps/gestures/open-notifications-action.hbs

@@ -0,0 +1,3 @@
+// Android-only: XCUITest has no notification-shade automation — fail loud instead of a silent no-op.
+if (driver.isIOS) { throw new Error('[sungen] "open notifications" is Android-only (no XCUITest equivalent) — keep this scenario @platform:android.'); }
+await driver.openNotifications();

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

@@ -0,0 +1,5 @@
+await (async () => { const e = await {{> locator}};
+  // 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/src/generators/test-generator/adapters/appium/templates/steps/gestures/pull-to-refresh-action.hbs

@@ -0,0 +1,5 @@
+await (async () => { const e = await {{> locator}};
+  // Pull-to-refresh = drag the content down. Platform-native swipe per OS.
+  if (driver.isIOS) { await driver.execute('mobile: swipe', { elementId: e.elementId, direction: 'down' }); }
+  else { await driver.execute('mobile: swipeGesture', { elementId: e.elementId, direction: 'down', percent: 0.9, speed: 5000 }); }
+})();

package/src/generators/test-generator/adapters/appium/templates/steps/gestures/rotate-action.hbs

@@ -0,0 +1 @@
+await driver.setOrientation('{{orientation}}');

package/src/generators/test-generator/adapters/appium/templates/steps/gestures/set-clipboard-action.hbs

@@ -0,0 +1,2 @@
+{{!-- Set the device clipboard (Appium expects base64-encoded content). --}}
+await driver.setClipboard(Buffer.from(String({{#if dataRef}}testData.get('{{dataRef}}'){{else}}'{{escapeQuotes clipboardValue}}'{{/if}})).toString('base64'), 'plaintext');

package/src/generators/test-generator/adapters/appium/templates/steps/gestures/set-geolocation-action.hbs

@@ -0,0 +1,2 @@
+{{!-- Mock the device GPS location. --}}
+await driver.setGeoLocation({ latitude: {{latitude}}, longitude: {{longitude}}, altitude: 0 });

package/src/generators/test-generator/adapters/appium/templates/steps/gestures/swipe-action.hbs

@@ -0,0 +1,5 @@
+await (async () => { const e = await {{> locator}};
+  // Platform-native swipe: XCUITest `mobile: swipe` (direction only) vs UiAutomator2 `mobile: swipeGesture`.
+  if (driver.isIOS) { await driver.execute('mobile: swipe', { elementId: e.elementId, direction: '{{direction}}' }); }
+  else { await driver.execute('mobile: swipeGesture', { elementId: e.elementId, direction: '{{direction}}', percent: 0.75 }); }
+})();

package/src/generators/test-generator/adapters/appium/templates/steps/gestures/tap-top-action.hbs

@@ -0,0 +1,24 @@
+await (async () => {
+  const e = await {{> locator}};
+  // Visible-point tap: tap near the TOP of the element (its centre may sit under a floating bottom
+  // bar). getElementRect is W3C-standard → works on BOTH Android and iOS (the old `bounds` attribute
+  // is Android-only and throws on iOS).
+  const r = await driver.getElementRect(e.elementId);
+  if (r && r.width) {
+    if (driver.isIOS) {
+      // iOS: tap near the TOP-LEFT. On shorter iOS viewports a bottom-row card peeks only a few pt
+      // above the floating bottom nav, and the nav's raised centre FAB occludes the top-CENTRE sliver
+      // — verified live on the converter: top-centre (+40pt) hit the nav/FAB, top-left (+~10pt,
+      // x inset 20%) opened the tool. Top-left is still inside the element for fully-visible ones.
+      const x = Math.round(r.x + Math.max(8, r.width * 0.2));
+      const y = Math.round(r.y + Math.min(10, r.height / 3));
+      await driver.execute('mobile: tap', { x, y });
+    } else {
+      const x = Math.round(r.x + r.width / 2);
+      const y = Math.round(r.y + Math.min(40, r.height / 3));
+      await driver.execute('mobile: clickGesture', { x, y });
+    }
+  } else {
+    await e.click();
+  }
+})();

package/src/generators/test-generator/adapters/appium/templates/steps/navigation/navigation.hbs

@@ -0,0 +1 @@
+// App launched via wdio capabilities{{#if path}} — entry: {{path}}{{/if}}

package/src/generators/test-generator/adapters/appium/templates/steps/navigation/wait-for-element-with-text.hbs

@@ -0,0 +1 @@
+{{#if (eq state 'hidden')}}await $('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]').waitForDisplayed({ reverse: true });{{else}}await $('//*[contains(@content-desc,"{{escapeQuotes dataValue}}") or contains(@text,"{{escapeQuotes dataValue}}")]').waitForDisplayed();{{/if}}

package/src/generators/test-generator/adapters/appium/templates/steps/navigation/wait-for-element.hbs

@@ -0,0 +1 @@
+{{#if (eq state 'hidden')}}await {{> locator}}.waitForDisplayed({ reverse: true });{{else}}await {{> locator}}.waitForDisplayed();{{/if}}

package/src/generators/test-generator/adapters/appium/templates/steps/navigation/wait-timeout.hbs

@@ -0,0 +1 @@
+await driver.pause({{duration}});

package/src/generators/test-generator/adapters/appium/templates/steps/partials/appium-selector-expr.hbs

@@ -0,0 +1,8 @@
+{{~!--
+  Emits a JS expression for a WDIO selector argument (note: it INCLUDES the surrounding quotes,
+  unlike appium-selector which emits the raw string). Two forms:
+   - per-platform variant (androidSelector/iosSelector set): a runtime ternary so one @platform:mobile
+     spec resolves the right native selector per OS — `(driver.isIOS ? '<ios>' : '<android>')`.
+   - normal: a single quoted literal — `'<selector>'`.
+--~}}
+{{~#if androidSelector~}}(driver.isIOS ? '{{> appium-selector iosSelector}}' : '{{> appium-selector androidSelector}}'){{~else~}}'{{> appium-selector}}'{{~/if~}}

package/src/generators/test-generator/adapters/appium/templates/steps/partials/appium-selector.hbs

@@ -0,0 +1,15 @@
+{{~#switch strategy~}}
+{{~#case 'accessibility-id'}}~{{escapeQuotes value}}{{/case~}}
+{{~#case 'testid'}}~{{escapeQuotes value}}{{/case~}}
+{{~#case 'text'}}~{{escapeQuotes value}}{{/case~}}
+{{~#case 'label'}}~{{escapeQuotes value}}{{/case~}}
+{{~#case 'placeholder'}}~{{escapeQuotes value}}{{/case~}}
+{{~#case 'role'}}~{{#if name}}{{escapeQuotes name}}{{else}}{{escapeQuotes value}}{{/if}}{{/case~}}
+{{~#case 'xpath'}}{{escapeQuotes value}}{{/case~}}
+{{~#case 'android-uiautomator'}}android={{escapeQuotes value}}{{/case~}}
+{{~#case 'ios-predicate'}}-ios predicate string:{{escapeQuotes value}}{{/case~}}
+{{~#case 'id'}}id={{escapeQuotes value}}{{/case~}}
+{{~#case 'locator'}}{{escapeQuotes value}}{{/case~}}
+{{~#case 'css'}}{{escapeQuotes value}}{{/case~}}
+{{~#default}}~{{escapeQuotes value}}{{/default~}}
+{{~/switch~}}

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

@@ -0,0 +1,8 @@
+{{!-- Parent scoping (mobile): when a step says `[Child] type in [Parent] parentType`, parentLocator
+      is the parent rendered as an Appium element ($('~parent')); we chain the child under it so WDIO
+      searches from the parent context (findElementFromElement). `scope` (a parent content-desc from
+      YAML) is the fallback parent. Note: a child xpath beginning with `//` is ABSOLUTE in Appium even
+      when chained — use accessibility-id / -android uiautomator children for true scoping, or `.//`.
+      The selector argument comes from appium-selector-expr (it carries its OWN quotes, or a per-platform
+      `driver.isIOS ? … : …` ternary), so it is NOT wrapped in quotes here. --}}
+{{~#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}}$({{> appium-selector-expr}}){{/if}}{{/if}}{{~/if~}}

package/src/generators/test-generator/adapters/appium/templates/steps/setup/application-running.hbs

@@ -0,0 +1 @@
+{{!-- The app under test is launched in the before hook (activateApp). No action needed. --}}

package/src/generators/test-generator/adapters/appium/templates/steps/setup/clear-auth.hbs

@@ -0,0 +1,2 @@
+{{!-- Mobile auth state is controlled by Appium reset capabilities (noReset/fullReset), not cookies/storage.
+      To start logged-out, run with fullReset or clear app data via caps. No per-step action. --}}

package/src/generators/test-generator/adapters/appium/templates/steps/setup/clear-browser-state.hbs

@@ -0,0 +1 @@
+{{!-- No browser on mobile; app state is governed by Appium reset capabilities. No per-step action. --}}

package/src/generators/test-generator/adapters/appium/templates/steps/setup/clear-database.hbs

@@ -0,0 +1 @@
+{{!-- TODO: reset backend state via a test API/script (same as web). No mobile-specific action. --}}

package/src/generators/test-generator/adapters/appium/templates/steps/setup/user-login-todo.hbs

@@ -0,0 +1,2 @@
+{{!-- TODO: login for user '{{userRef}}'. On mobile, prefer the @auth:<role> mechanism: declare
+      specs/.auth-mobile/{{userRef}}.json (loginSteps + authedMarker) so before(all) runs ensureAuth. --}}