swipium 1.0.0

package/dist/automationGen/appiumModel.js

@@ -0,0 +1,129 @@
+// SWIPIUM-REQ-04 — Cross-platform Appium POM model. Pure transform of the canonical Swipium POM
+// (src/suite/pom.ts) into an Appium-ready, language-agnostic screen model that the JS and Python
+// emitters share. This is the "shared intermediate model" the requirement asks for so generated
+// JS/Python cannot drift from Swipium YAML semantics.
+//
+// Locator policy (REQ-04 §Generated * Suite Requirements + Appium locator-strategy guidance):
+//   accessibility id > resource-id/id > iOS predicate/class-chain/name > text > coordinate.
+//   XPath is NEVER emitted; coordinate is the explicit non-release-grade fallback.
+/** PomPage name (LoginPage) → screen class name (LoginScreen). */
+export function screenClassName(pageName) {
+    return /Page$/.test(pageName) ? pageName.replace(/Page$/, 'Screen') : `${pageName}Screen`;
+}
+function durableStrategy(s) {
+    return s === 'accessibilityId' || s === 'id';
+}
+function locator(strategy, value) {
+    const durable = durableStrategy(strategy);
+    // coordinate is never release-grade; raw text is a semi-fragile fallback but still runnable.
+    const releaseGrade = strategy !== 'coordinate';
+    return { strategy, value, durable, releaseGrade };
+}
+/**
+ * Compute the platform-specific Appium locators for one POM element selectorKind.
+ * Returns { android, ios, fallback } — any of which may be undefined.
+ */
+function locatorsFor(selectorKind, selector, coords, platforms) {
+    const value = selector ?? '';
+    switch (selectorKind) {
+        case 'accessibility_id': {
+            // accessibility id is the one strategy that is durable AND cross-platform.
+            const loc = locator('accessibilityId', value);
+            return { android: platforms.android ? loc : undefined, ios: platforms.ios ? loc : undefined };
+        }
+        case 'resource_id':
+            return { android: platforms.android ? locator('id', value) : undefined };
+        case 'name':
+            return { ios: platforms.ios ? locator('name', value) : undefined };
+        case 'predicate':
+            return { ios: platforms.ios ? locator('iosPredicate', value) : undefined };
+        case 'class_chain':
+            return { ios: platforms.ios ? locator('iosClassChain', value) : undefined };
+        case 'text': {
+            // text → Android UiAutomator text match (semi), iOS name match (semi). Both fragile.
+            const android = platforms.android ? locator('androidUiautomator', value) : undefined;
+            const ios = platforms.ios ? locator('name', value) : undefined;
+            return { android, ios, fallback: locator('androidUiautomator', value) };
+        }
+        case 'coords':
+        default: {
+            const c = coords ?? [0, 0];
+            return { fallback: locator('coordinate', `${c[0]},${c[1]}`) };
+        }
+    }
+}
+/**
+ * Build the cross-platform Appium model from a generated POM + the resolved platform support.
+ */
+export function buildAppiumModel(pom, opts) {
+    const platforms = opts.platforms;
+    const secrets = new Set();
+    const variables = new Set();
+    const screens = pom.pages.map((p) => {
+        const className = screenClassName(p.name);
+        const elements = p.elements.map((e) => {
+            const { android, ios, fallback } = locatorsFor(e.selectorKind, e.selector, e.coords, platforms);
+            return {
+                name: e.name,
+                role: undefined,
+                android,
+                ios,
+                fallback,
+                durability: e.durability,
+                required: e.required,
+                secure: e.secure,
+                remediation: e.remediation,
+                mapScreenId: p.screen,
+                sourceFile: opts.sourceFilePrefix ? `${opts.sourceFilePrefix}/pages/${kebab(p.name)}.page.yaml` : `pages/${kebab(p.name)}.page.yaml`,
+            };
+        });
+        return { className, pageName: p.name, screenSignature: p.screen, elements };
+    });
+    const steps = pom.steps.map((s) => toStep(s, secrets, variables));
+    return {
+        testName: pom.testName,
+        screens,
+        steps,
+        variables: [...variables],
+        secrets: [...secrets],
+        audit: pom.audit,
+        platforms,
+    };
+}
+function toStep(s, secrets, variables) {
+    const screen = screenClassName(s.page);
+    const base = { screen, element: s.element, action: s.action };
+    if (s.action === 'inputText') {
+        const m = (s.text ?? '').match(/^\$\{([^}]+)\}$/);
+        if (m) {
+            if (s.secret)
+                secrets.add(m[1]);
+            else
+                variables.add(m[1]);
+            return { ...base, action: 'inputText', text: s.text, secret: s.secret, varName: m[1] };
+        }
+        // literal non-secret text — also scan for embedded ${VARS}
+        for (const mm of (s.text ?? '').matchAll(/\$\{([^}]+)\}/g))
+            variables.add(mm[1]);
+        return { ...base, action: 'inputText', text: s.text ?? '', secret: s.secret };
+    }
+    if (s.action === 'tap' && !s.element && s.coords)
+        return { ...base, action: 'tapAt', coords: s.coords };
+    if (s.action === 'press')
+        return { ...base, action: 'press', key: s.key };
+    if (s.action === 'swipe')
+        return { ...base, action: 'swipe', direction: s.direction };
+    if (s.action === 'openUrl')
+        return { ...base, action: 'openUrl', url: s.url };
+    if (s.action === 'assertVisible')
+        return { ...base, action: 'assertVisible', text: s.text };
+    return base;
+}
+function kebab(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+//# sourceMappingURL=appiumModel.js.map

package/dist/automationGen/appiumModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appiumModel.js","sourceRoot":"","sources":["../../src/automationGen/appiumModel.ts"],"names":[],"mappings":"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"}

package/dist/automationGen/ciEmitter.js

@@ -0,0 +1,80 @@
+// SWIPIUM-REQ-04 — CI example emitter. Pure: produces a LOCAL-Appium CI template (GitHub Actions)
+// for the generated JS or Python suite. Per the non-goals, this is a starting example only (no cloud
+// device-farm config), and the tool writes it as `ci.example.yml` — never an active workflow.
+export function emitCiExample(language, opts = {}) {
+    if (language === 'python')
+        return pythonCi();
+    return jsCi(language);
+}
+function jsCi(language) {
+    const installTs = language === 'typescript' ? '' : '';
+    return `# Generated by Swipium — EXAMPLE local-Appium CI (rename to .github/workflows/*.yml to enable).
+# Local Appium + Android emulator only. No cloud device farm (out of scope for v1).
+name: appium-e2e (example)
+on:
+  workflow_dispatch: {}
+jobs:
+  android-e2e:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Install deps
+        run: npm install${installTs}
+      - name: Enable KVM
+        run: |
+          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+          sudo udevadm control --reload-rules && sudo udevadm trigger --name-match=kvm
+      - name: Run Appium e2e on emulator
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 34
+          arch: x86_64
+          script: |
+            npx appium &
+            sleep 8
+            ANDROID_APP_PACKAGE=\${{ env.ANDROID_APP_PACKAGE }} npm test
+        env:
+          # Provide secrets via repo/Org secrets — never commit them.
+          SWIPIUM_TEST_PASSWORD: \${{ secrets.SWIPIUM_TEST_PASSWORD }}
+`;
+}
+function pythonCi() {
+    return `# Generated by Swipium — EXAMPLE local-Appium CI (rename to .github/workflows/*.yml to enable).
+# Local Appium + Android emulator only. No cloud device farm (out of scope for v1).
+name: appium-e2e (example)
+on:
+  workflow_dispatch: {}
+jobs:
+  android-e2e:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install deps
+        run: |
+          pip install -r requirements.txt
+          npm install -g appium
+          appium driver install uiautomator2
+      - name: Enable KVM
+        run: |
+          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+          sudo udevadm control --reload-rules && sudo udevadm trigger --name-match=kvm
+      - name: Run Appium e2e on emulator
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 34
+          arch: x86_64
+          script: |
+            appium &
+            sleep 8
+            ANDROID_APP_PACKAGE=\${{ env.ANDROID_APP_PACKAGE }} pytest
+        env:
+          SWIPIUM_TEST_PASSWORD: \${{ secrets.SWIPIUM_TEST_PASSWORD }}
+`;
+}
+//# sourceMappingURL=ciEmitter.js.map

package/dist/automationGen/ciEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ciEmitter.js","sourceRoot":"","sources":["../../src/automationGen/ciEmitter.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,qGAAqG;AACrG,8FAA8F;AAI9F,MAAM,UAAU,aAAa,CAAC,QAA4B,EAAE,OAA2B,EAAE;IACvF,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,EAAE,CAAC;IAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,IAAI,CAAC,QAA4B;IACxC,MAAM,SAAS,GAAG,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,OAAO;;;;;;;;;;;;;;0BAciB,SAAS;;;;;;;;;;;;;;;;;CAiBlC,CAAC;AACF,CAAC;AAED,SAAS,QAAQ;IACf,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCR,CAAC;AACF,CAAC"}

package/dist/automationGen/jsEmitter.js

@@ -0,0 +1,440 @@
+// SWIPIUM-REQ-04 — JS/TS WebdriverIO + Appium emitter. Pure: turns the shared Appium model into a
+// runnable WebdriverIO POM suite (page/screen classes with locator getters + action methods, env-
+// driven capabilities, structured waits). No XPath is ever emitted; coordinate fallbacks are marked
+// non-release-grade. Aligns with the Appium JS quickstart (WebdriverIO) locator-strategy guidance.
+const DEFAULT_TIMEOUT = 15000;
+function pascal(s) {
+    const parts = s.replace(/[^A-Za-z0-9]+/g, ' ').trim().split(/\s+/).filter(Boolean);
+    return parts.map((p) => p[0].toUpperCase() + p.slice(1)).join('') || 'X';
+}
+/** Env var (SWIPIUM_TEST_PASSWORD) → a stable testData key (password). */
+export function varToKey(v) {
+    const stripped = v.replace(/^SWIPIUM_(TEST_)?/i, '');
+    const parts = stripped.replace(/[^A-Za-z0-9]+/g, ' ').trim().toLowerCase().split(/\s+/).filter(Boolean);
+    if (!parts.length)
+        return 'value';
+    return parts.map((p, i) => (i === 0 ? p : p[0].toUpperCase() + p.slice(1))).join('');
+}
+/** wdio selector string for a single Appium locator (no XPath, ever). */
+export function wdioSelector(loc) {
+    switch (loc.strategy) {
+        case 'accessibilityId':
+            return `~${loc.value}`;
+        case 'id':
+            return `id=${loc.value}`;
+        case 'androidUiautomator':
+            return `android=new UiSelector().text(${JSON.stringify(loc.value)})`;
+        case 'name':
+            return `-ios predicate string:name == ${JSON.stringify(loc.value)} OR label == ${JSON.stringify(loc.value)}`;
+        case 'iosPredicate':
+            return `-ios predicate string:${loc.value}`;
+        case 'iosClassChain':
+            return `-ios class chain:${loc.value}`;
+        case 'coordinate':
+            return '';
+        default:
+            return '';
+    }
+}
+function platformLocatorLiteral(el) {
+    const parts = [];
+    if (el.android)
+        parts.push(`android: ${JSON.stringify(wdioSelector(el.android))}`);
+    if (el.ios)
+        parts.push(`ios: ${JSON.stringify(wdioSelector(el.ios))}`);
+    if (el.fallback && el.fallback.strategy === 'coordinate')
+        parts.push(`coordinate: ${JSON.stringify(el.fallback.value)}`);
+    else if (el.fallback && !el.android && !el.ios)
+        parts.push(`android: ${JSON.stringify(wdioSelector(el.fallback))}`);
+    return `{ ${parts.join(', ')} }`;
+}
+export function emitJsSuite(input) {
+    const ts = input.language === 'typescript';
+    const ext = ts ? 'ts' : 'js';
+    const t = (annotation) => (ts ? annotation : '');
+    const files = [];
+    files.push({ path: 'package.json', content: packageJson(input) });
+    if (ts)
+        files.push({ path: 'tsconfig.json', content: tsconfigJson() });
+    files.push({ path: `wdio.conf.${ext}`, content: wdioConf(ts, ext) });
+    files.push({ path: `src/config/capabilities.${ext}`, content: capabilities(input, ts) });
+    files.push({ path: `src/utils/locators.${ext}`, content: locatorsUtil(ts) });
+    files.push({ path: `src/utils/waits.${ext}`, content: waitsUtil(ts) });
+    files.push({ path: `src/screens/BaseScreen.${ext}`, content: baseScreen(ts) });
+    for (const screen of input.model.screens) {
+        files.push({ path: `src/screens/${screen.className}.${ext}`, content: screenClass(screen, input.model.steps, ts, t) });
+    }
+    files.push({ path: `src/data/testData.${ext}`, content: testData(input.model, ts) });
+    files.push({ path: `test/smoke.e2e.${ext}`, content: smokeTest(input.model, ts) });
+    return files;
+}
+function packageJson(input) {
+    const ts = input.language === 'typescript';
+    const name = `${(input.appId ?? 'app').split('.').pop()}-appium-suite`;
+    const pkg = {
+        name,
+        private: true,
+        type: 'module',
+        description: 'Generated by Swipium — WebdriverIO + Appium POM suite (review before committing).',
+        scripts: {
+            test: 'wdio run ./wdio.conf.' + (ts ? 'ts' : 'js'),
+        },
+        devDependencies: {
+            '@wdio/cli': '^9.0.0',
+            '@wdio/local-runner': '^9.0.0',
+            '@wdio/mocha-framework': '^9.0.0',
+            '@wdio/appium-service': '^9.0.0',
+            '@wdio/spec-reporter': '^9.0.0',
+            appium: '^2.11.0',
+            ...(ts ? { typescript: '^5.7.0', tsx: '^4.19.0', '@types/node': '^22.0.0' } : {}),
+        },
+    };
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+function tsconfigJson() {
+    return JSON.stringify({
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'NodeNext',
+            moduleResolution: 'NodeNext',
+            types: ['node', '@wdio/globals/types', '@wdio/mocha-framework'],
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+        },
+        include: ['src/**/*.ts', 'test/**/*.ts', 'wdio.conf.ts'],
+    }, null, 2) + '\n';
+}
+function wdioConf(ts, ext) {
+    const header = '// Generated by Swipium. WebdriverIO + Appium config — capabilities come from env (see src/config/capabilities).';
+    const importLine = `import { buildCapabilities } from './src/config/capabilities.js';`;
+    const typeAnno = ts ? `\nimport type { Options } from '@wdio/types';\n` : '\n';
+    const cfgType = ts ? ': WebdriverIO.Config' : '';
+    return `${header}${typeAnno}${importLine}
+
+export const config${cfgType} = {
+  runner: 'local',
+  hostname: process.env.APPIUM_HOST || '127.0.0.1',
+  port: Number(process.env.APPIUM_PORT || 4723),
+  path: '/',
+  specs: ['./test/**/*.e2e.${ext}'],
+  maxInstances: 1,
+  capabilities: [buildCapabilities()],
+  logLevel: 'info',
+  waitforTimeout: ${DEFAULT_TIMEOUT},
+  framework: 'mocha',
+  reporters: ['spec'],
+  mochaOpts: { ui: 'bdd', timeout: 120000 },
+  services: [['appium', { args: { address: process.env.APPIUM_HOST || '127.0.0.1' } }]],
+};
+`;
+}
+function capabilities(input, ts) {
+    const android = input.model.platforms.android;
+    const ios = input.model.platforms.ios;
+    const ret = ts ? ': WebdriverIO.Capabilities' : '';
+    const appId = input.appId ?? '';
+    const lines = [];
+    lines.push('// Generated by Swipium. ALL device/app config is environment-driven — no secrets, no hardcoded paths.');
+    lines.push('// Android is the default fast-feedback backend; set SWIPIUM_PLATFORM=ios to target iOS (XCUITest).');
+    lines.push('');
+    lines.push(`export function buildCapabilities()${ret} {`);
+    lines.push(`  const platform = (process.env.SWIPIUM_PLATFORM || ${JSON.stringify(android ? 'android' : 'ios')}).toLowerCase();`);
+    lines.push('  if (platform === \'ios\') {');
+    lines.push('    return {');
+    lines.push('      platformName: \'iOS\',');
+    lines.push('      \'appium:automationName\': \'XCUITest\',');
+    lines.push('      \'appium:deviceName\': process.env.IOS_DEVICE_NAME || \'iPhone 15\',');
+    lines.push('      \'appium:platformVersion\': process.env.IOS_PLATFORM_VERSION,');
+    lines.push(`      'appium:bundleId': process.env.IOS_BUNDLE_ID${appId ? ` || ${JSON.stringify(appId)}` : ''},`);
+    lines.push('      \'appium:app\': process.env.IOS_APP_PATH,');
+    lines.push('      \'appium:udid\': process.env.IOS_UDID,');
+    lines.push('      \'appium:noReset\': process.env.SWIPIUM_NO_RESET === \'true\',');
+    lines.push('    };');
+    lines.push('  }');
+    lines.push('  // Android UiAutomator2 (default).');
+    lines.push('  return {');
+    lines.push('    platformName: \'Android\',');
+    lines.push('    \'appium:automationName\': \'UiAutomator2\',');
+    lines.push('    \'appium:deviceName\': process.env.ANDROID_DEVICE_NAME || \'Android Emulator\',');
+    lines.push(`    'appium:appPackage': process.env.ANDROID_APP_PACKAGE${appId ? ` || ${JSON.stringify(appId)}` : ''},`);
+    lines.push('    \'appium:appActivity\': process.env.ANDROID_APP_ACTIVITY,');
+    lines.push('    \'appium:app\': process.env.ANDROID_APP_PATH,');
+    lines.push('    \'appium:udid\': process.env.ANDROID_UDID,');
+    lines.push('    \'appium:noReset\': process.env.SWIPIUM_NO_RESET === \'true\',');
+    lines.push('  };');
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+function locatorsUtil(ts) {
+    const typeBlock = ts
+        ? `export interface PlatformLocator {\n  android?: string;\n  ios?: string;\n  /** "x,y" coordinate fallback — non-release-grade. */\n  coordinate?: string;\n}\n\n`
+        : '';
+    const param = ts ? 'loc: PlatformLocator' : 'loc';
+    const ret = ts ? ': string' : '';
+    return `// Generated by Swipium. Resolves a centralized cross-platform locator to a wdio selector at runtime.
+${typeBlock}export function resolveSelector(${param})${ret} {
+  // @ts-ignore wdio global
+  const android = typeof driver !== 'undefined' ? driver.isAndroid : true;
+  const selector = android ? loc.android : loc.ios;
+  if (!selector) {
+    throw new Error('No durable selector for this platform — element relies on a coordinate fallback (non-release-grade). Add an accessibility id / resource-id / testID.');
+  }
+  return selector;
+}
+
+export function coordinateOf(${param})${ts ? ': [number, number] | undefined' : ''} {
+  if (!loc.coordinate) return undefined;
+  const [x, y] = loc.coordinate.split(',').map(Number);
+  return [x, y];
+}
+`;
+}
+function waitsUtil(ts) {
+    const elAnno = ts ? ': WebdriverIO.Element' : '';
+    const numAnno = ts ? ': number' : '';
+    return `// Generated by Swipium. Structured waits — never a bare sleep. Auto-wait before interaction
+// (Playwright-style resilience, applied to mobile Appium).
+export const DEFAULT_TIMEOUT = ${DEFAULT_TIMEOUT};
+
+export async function waitVisible(el${elAnno}, timeout${numAnno} = DEFAULT_TIMEOUT) {
+  await el.waitForDisplayed({ timeout });
+  return el;
+}
+
+export async function waitEnabled(el${elAnno}, timeout${numAnno} = DEFAULT_TIMEOUT) {
+  await el.waitForEnabled({ timeout });
+  return el;
+}
+`;
+}
+function baseScreen(ts) {
+    const locImport = ts ? `import type { PlatformLocator } from '../utils/locators.js';\n` : '';
+    const p = (name, type) => (ts ? `${name}: ${type}` : name);
+    return `// Generated by Swipium. BaseScreen centralizes all element interaction so selectors are
+// resolved per-platform in ONE place and tests never touch raw selectors.
+${locImport}import { resolveSelector, coordinateOf } from '../utils/locators.js';
+import { waitVisible, waitEnabled, DEFAULT_TIMEOUT } from '../utils/waits.js';
+
+export class BaseScreen {
+  protected async element(${p('loc', 'PlatformLocator')}) {
+    // @ts-ignore wdio global
+    return $(resolveSelector(loc));
+  }
+
+  protected async tap(${p('loc', 'PlatformLocator')}) {
+    const el = await this.element(loc);
+    await waitEnabled(await waitVisible(el));
+    await el.click();
+  }
+
+  protected async type(${p('loc', 'PlatformLocator')}, ${p('value', 'string')}) {
+    const el = await this.element(loc);
+    await waitVisible(el);
+    await el.setValue(value);
+  }
+
+  protected async scrollTo(${p('loc', 'PlatformLocator')}) {
+    const el = await this.element(loc);
+    await el.scrollIntoView();
+    await waitVisible(el);
+  }
+
+  protected async isVisible(${p('loc', 'PlatformLocator')})${ts ? ': Promise<boolean>' : ''} {
+    const el = await this.element(loc);
+    return el.isDisplayed();
+  }
+
+  async assertVisible(${p('loc', 'PlatformLocator')}) {
+    const el = await this.element(loc);
+    await waitVisible(el);
+  }
+
+  async assertTextVisible(${p('text', 'string')}) {
+    // Non-release-grade text/OCR assertion — prefer a structured locator.
+    // @ts-ignore wdio global
+    const el = await $('android=new UiSelector().textContains(' + JSON.stringify(text) + ')');
+    await waitVisible(el);
+  }
+
+  // Coordinate tap — brittle, non-release-grade fallback. Only used when no durable locator exists.
+  async tapAt(${p('x', 'number')}, ${p('y', 'number')}) {
+    // @ts-ignore wdio global
+    await driver.action('pointer')
+      .move({ x, y }).down().pause(50).up().perform();
+  }
+
+  async pressKey(${p('key', 'string')}) {
+    // @ts-ignore wdio global
+    if (driver.isAndroid && key === 'back') { await driver.back(); return; }
+    // @ts-ignore wdio global
+    await driver.keys([key]);
+  }
+
+  async swipe(${p('direction', 'string')}) {
+    // @ts-ignore wdio global
+    const { width, height } = await driver.getWindowSize();
+    const cx = Math.round(width / 2), cy = Math.round(height / 2);
+    const map = {
+      up: [cx, Math.round(height * 0.8), cx, Math.round(height * 0.2)],
+      down: [cx, Math.round(height * 0.2), cx, Math.round(height * 0.8)],
+      left: [Math.round(width * 0.8), cy, Math.round(width * 0.2), cy],
+      right: [Math.round(width * 0.2), cy, Math.round(width * 0.8), cy],
+    };
+    const [x1, y1, x2, y2] = map[${ts ? 'direction as keyof typeof map' : 'direction'}] || map.up;
+    // @ts-ignore wdio global
+    await driver.action('pointer')
+      .move({ x: x1, y: y1 }).down().pause(100).move({ duration: 600, x: x2, y: y2 }).up().perform();
+  }
+
+  async openUrl(${p('url', 'string')}) {
+    // @ts-ignore wdio global
+    await driver.url(url);
+  }
+}
+`;
+}
+/** Per-screen action method name for an (element, action) pair. */
+function methodName(action, element) {
+    const E = pascal(element);
+    switch (action) {
+        case 'tap':
+            return `tap${E}`;
+        case 'inputText':
+            return `enter${E}`;
+        case 'scrollTo':
+            return `scrollTo${E}`;
+        case 'assertVisible':
+            return `assert${E}Visible`;
+        default:
+            return `act${E}`;
+    }
+}
+function screenClass(screen, steps, ts, t) {
+    const locImport = ts ? `import type { PlatformLocator } from '../utils/locators.js';\n` : '';
+    const lines = [];
+    lines.push(`// Generated by Swipium. Screen object for ${screen.pageName}${screen.screenSignature ? ` (${screen.screenSignature})` : ''}.`);
+    lines.push('// Selectors are centralized here; tests call the action methods below.');
+    lines.push(locImport.trimEnd());
+    lines.push(`import { BaseScreen } from './BaseScreen.js';`);
+    lines.push('');
+    lines.push(`export class ${screen.className} extends BaseScreen {`);
+    // Locators (centralized).
+    for (const el of screen.elements) {
+        const durabilityNote = el.durability === 'durable' ? '' : ` // ${el.durability} locator${el.remediation ? ` — ${el.remediation}` : ''}`;
+        lines.push(`  readonly ${el.name}${t(': PlatformLocator')} = ${platformLocatorLiteral(el)};${durabilityNote}`);
+    }
+    lines.push('');
+    // Action methods for each (element, action) used in steps on this screen.
+    const seen = new Set();
+    for (const s of steps) {
+        if (s.screen !== screen.className || !s.element)
+            continue;
+        const el = screen.elements.find((e) => e.name === s.element);
+        if (!el)
+            continue;
+        const name = methodName(s.action, s.element);
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        if (s.action === 'inputText') {
+            lines.push(`  async ${name}(${ts ? 'value: string' : 'value'}) {`);
+            lines.push(`    await this.type(this.${s.element}, value);`);
+            lines.push('  }');
+        }
+        else if (s.action === 'tap') {
+            lines.push(`  async ${name}() {`);
+            lines.push(`    await this.tap(this.${s.element});`);
+            lines.push('  }');
+        }
+        else if (s.action === 'scrollTo') {
+            lines.push(`  async ${name}() {`);
+            lines.push(`    await this.scrollTo(this.${s.element});`);
+            lines.push('  }');
+        }
+        else if (s.action === 'assertVisible') {
+            lines.push(`  async ${name}() {`);
+            lines.push(`    await this.assertVisible(this.${s.element});`);
+            lines.push('  }');
+        }
+    }
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+function testData(model, ts) {
+    const lines = [];
+    lines.push('// Generated by Swipium. Test data comes from the ENVIRONMENT — secrets are never inlined.');
+    lines.push('export const testData = {');
+    for (const v of model.variables) {
+        lines.push(`  ${varToKey(v)}: process.env.${v} || '',`);
+    }
+    for (const v of model.secrets) {
+        lines.push(`  ${varToKey(v)}: process.env.${v} || '', // secret — provide via environment only`);
+    }
+    lines.push('};');
+    lines.push('');
+    if (ts)
+        lines.push('export type TestData = typeof testData;');
+    lines.push('');
+    return lines.join('\n');
+}
+function smokeTest(model, ts) {
+    const classes = [...new Set(model.steps.map((s) => s.screen))];
+    const lines = [];
+    lines.push('// Generated by Swipium. Smoke test driving the recorded flow through the screen objects.');
+    for (const c of classes) {
+        lines.push(`import { ${c} } from '../src/screens/${c}.js';`);
+    }
+    lines.push(`import { testData } from '../src/data/testData.js';`);
+    lines.push('');
+    lines.push(`describe('${model.testName} smoke', () => {`);
+    // instantiate one screen object per class.
+    const inst = new Map();
+    for (const c of classes) {
+        const v = c[0].toLowerCase() + c.slice(1);
+        inst.set(c, v);
+    }
+    lines.push(`  it('completes the recorded flow', async () => {`);
+    for (const [c, v] of inst)
+        lines.push(`    const ${v} = new ${c}();`);
+    for (const s of model.steps) {
+        const v = inst.get(s.screen);
+        lines.push('    ' + stepCall(v, s));
+    }
+    lines.push('  });');
+    lines.push('});');
+    lines.push('');
+    return lines.join('\n');
+}
+function stepCall(screenVar, s) {
+    if (s.element) {
+        const name = methodName(s.action, s.element);
+        if (s.action === 'inputText') {
+            const arg = s.varName ? `testData.${varToKey(s.varName)}` : JSON.stringify(s.text ?? '');
+            return `await ${screenVar}.${name}(${arg});`;
+        }
+        return `await ${screenVar}.${name}();`;
+    }
+    // No element: generic BaseScreen helpers.
+    switch (s.action) {
+        case 'tapAt':
+            return `await ${screenVar}.tapAt(${s.coords?.[0] ?? 0}, ${s.coords?.[1] ?? 0}); // coordinate fallback — non-release-grade`;
+        case 'inputText': {
+            const arg = s.varName ? `testData.${varToKey(s.varName)}` : JSON.stringify(s.text ?? '');
+            return `await ${screenVar}.type({ android: '' }, ${arg}); // focused-field input`;
+        }
+        case 'press':
+            return `await ${screenVar}.pressKey(${JSON.stringify(s.key ?? 'back')});`;
+        case 'swipe':
+            return `await ${screenVar}.swipe(${JSON.stringify(s.direction ?? 'up')});`;
+        case 'openUrl':
+            return `await ${screenVar}.openUrl(${JSON.stringify(s.url ?? '')});`;
+        case 'assertVisible':
+            return `await ${screenVar}.assertTextVisible(${JSON.stringify(s.text ?? '')});`;
+        default:
+            return `// unsupported step: ${s.action}`;
+    }
+}
+//# sourceMappingURL=jsEmitter.js.map