mobile-wdio-kit 0.1.0

package/template/src/specs/app.login.spec.ts

@@ -0,0 +1,20 @@
+import { env } from "../env.ts";
+import { loginPage } from "../pages/Login.page.ts";
+import { nativeAlertPage } from "../pages/NativeAlert.page.ts";
+import { tabBarPage } from "../pages/TabBar.page.ts";
+
+describe("WebdriverIO demo app (native)", () => {
+  it("shows the tab bar after launch", async () => {
+    await tabBarPage.waitForDisplay();
+  });
+
+  it("logs in and dismisses the success alert", async () => {
+    await tabBarPage.waitForDisplay();
+    await tabBarPage.openLogin();
+    await loginPage.openLoginForm();
+    await loginPage.login(env.mobileUsername, env.mobilePassword);
+    await nativeAlertPage.waitForDisplay();
+    await nativeAlertPage.expectSuccessMessage();
+    await nativeAlertPage.confirm();
+  });
+});

package/template/src/test-utils/wdioTestGlobals.ts

@@ -0,0 +1,82 @@
+import { vi, type Mock } from "vitest";
+
+export type ElementChain = {
+  waitForDisplayed: Mock;
+  waitForExist: Mock;
+  click: Mock;
+  setValue: Mock;
+  getText: Mock;
+  scrollIntoView: Mock;
+};
+
+/** Minimal WDIO-style globals for unit-testing page objects. */
+export function setupWdioTestContext(options: {
+  isIOS?: boolean;
+  isAndroid?: boolean;
+  keyboardShown?: boolean;
+}): { $: Mock; chainFor: (selector: string) => ElementChain } {
+  const { isIOS = false, isAndroid = true, keyboardShown = false } = options;
+  const chains = new Map<string, ElementChain>();
+
+  const makeChain = (): ElementChain => ({
+    waitForDisplayed: vi.fn().mockResolvedValue(undefined),
+    waitForExist: vi.fn().mockResolvedValue(undefined),
+    click: vi.fn().mockResolvedValue(undefined),
+    setValue: vi.fn().mockResolvedValue(undefined),
+    getText: vi.fn(),
+    scrollIntoView: vi.fn().mockResolvedValue(undefined),
+  });
+
+  const $ = vi.fn((selector: string) => {
+    if (!chains.has(selector)) chains.set(selector, makeChain());
+    return chains.get(selector)!;
+  });
+
+  vi.stubGlobal("driver", {
+    isIOS,
+    isAndroid,
+    isKeyboardShown: vi.fn().mockResolvedValue(keyboardShown),
+  });
+  vi.stubGlobal("$", $);
+
+  return {
+    $,
+    chainFor: (selector: string) => {
+      const c = chains.get(selector);
+      if (!c) throw new Error(`No element chain for selector: ${selector}`);
+      return c;
+    },
+  };
+}
+
+/**
+ * Matches WebdriverIO-style usage in page objects:
+ * - expect("a\\nb").toContain("x")
+ * - expect($(loc)).toHaveText(expect.stringContaining("x"))
+ */
+export function stubExpectWebdriverStyle(): {
+  toHaveText: Mock;
+} {
+  const toHaveText = vi.fn().mockResolvedValue(undefined);
+  const expectFn = Object.assign(
+    (actual: unknown) => {
+      if (typeof actual === "string") {
+        return {
+          toContain: (sub: string) => {
+            if (!actual.includes(sub)) {
+              throw new Error(
+                `Expected string to contain ${JSON.stringify(sub)}`,
+              );
+            }
+          },
+        };
+      }
+      return { toHaveText };
+    },
+    {
+      stringContaining: (s: string) => s,
+    },
+  );
+  vi.stubGlobal("expect", expectFn);
+  return { toHaveText };
+}

package/template/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": [
+      "node",
+      "mocha",
+      "@wdio/globals/types",
+      "@wdio/mocha-framework",
+      "expect-webdriverio"
+    ]
+  },
+  "include": ["configs/**/*.ts", "src/**/*.ts"]
+}

package/template/vitest.config.ts

@@ -0,0 +1,25 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    include: ["src/**/*.test.ts"],
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "json-summary"],
+      include: ["src/**/*.ts"],
+      exclude: [
+        "src/specs/**",
+        "src/**/*.test.ts",
+        "src/env.ts",
+        "src/test-utils/**",
+      ],
+      thresholds: {
+        lines: 90,
+        functions: 90,
+        branches: 90,
+        statements: 90,
+      },
+    },
+  },
+});