@testspectra/cli 1.0.32 → 1.0.34

package/dist/commands/init.js

@@ -345,6 +345,7 @@ export async function initCommand(options = {}) {
         const rootConfigFiles = [
             "spectra.config.ts",
             "tsconfig.spectra.json",
+            "tsconfig.spectra.shared.json",
             "tsconfig.spectra.web.json",
             "tsconfig.spectra.android.json",
             "tsconfig.spectra.ios.json",

package/dist/types/generator.d.ts

@@ -1,8 +1,17 @@
 export type PlatformTarget = "web" | "android" | "ios" | "mobile" | "common";
 export declare class TypeGenerator {
-    static getPageObjectsDirs(cwd: string): string[];
-    static getEntityDirs(cwd: string, entityType: "actions" | "steps" | "fixtures"): string[];
-    static generateAmbientDeclarations(cwd: string): Record<string, string>;
-    static generateFixturesDeclaration(cwd: string): string;
+    /**
+     * Discovers all feature directories and shared library directories.
+     * Returns a map of scope -> base directory (e.g. { "shared": ".../shared/testing", "auth": ".../packages/features/auth/e2e" })
+     */
+    static getEntityScopes(cwd: string): {
+        name: string;
+        dir: string;
+        isShared: boolean;
+    }[];
+    static getPageObjectsDirsForScope(scopeDir: string, sharedDir?: string): string[];
+    static getEntityDirsForScope(entityType: "actions" | "steps" | "fixtures", scopeDir: string, sharedDir?: string): string[];
+    static generateDeclarationsForScope(cwd: string, outputTypesDir: string, scopeDir: string, sharedDir?: string): Record<string, string>;
+    static generateFixturesDeclarationForScope(scopeDir: string, sharedDir?: string): string;
     static writeDeclarationFiles(cwd: string): void;
 }

package/dist/types/generator.js

@@ -8,82 +8,85 @@ const PLATFORM_HIERARCHY = {
     common: ["common"],
 };
 export class TypeGenerator {
-    static getPageObjectsDirs(cwd) {
-        const dirs = [];
-        function scanDir(dir, maxDepth) {
-            if (maxDepth <= 0 || !fs.existsSync(dir))
+    /**
+     * Discovers all feature directories and shared library directories.
+     * Returns a map of scope -> base directory (e.g. { "shared": ".../shared/testing", "auth": ".../packages/features/auth/e2e" })
+     */
+    static getEntityScopes(cwd) {
+        const scopes = [];
+        // 1. Scan for shared directories
+        const sharedCandidates = [
+            path.join(cwd, "shared", "testing"),
+            path.join(cwd, "shared"),
+            path.join(cwd, "testing"),
+        ];
+        for (const cand of sharedCandidates) {
+            if (fs.existsSync(cand) && (fs.existsSync(path.join(cand, "page-objects")) || fs.existsSync(path.join(cand, "steps")) || fs.existsSync(path.join(cand, "actions")))) {
+                if (!scopes.some((s) => s.dir === cand)) {
+                    scopes.push({ name: "shared", dir: cand, isShared: true });
+                }
+            }
+        }
+        // 2. Scan recursively for feature e2e directories
+        function scanForFeatures(dir, depth) {
+            if (depth <= 0 || !fs.existsSync(dir))
                 return;
             const base = path.basename(dir);
             if (base === "node_modules" || base === "dist" || base === ".git" || base === ".testspectra")
                 return;
-            if (base === "page-objects" || base === "pageobjects") {
-                if (!dirs.includes(dir))
-                    dirs.push(dir);
+            if (base === "e2e" || base === "tests" || base === "specs") {
+                const featureDir = path.dirname(dir);
+                const featureName = path.basename(featureDir);
+                if (!scopes.some((s) => s.dir === dir)) {
+                    scopes.push({ name: featureName, dir: dir, isShared: false });
+                }
                 return;
             }
             try {
                 const entries = fs.readdirSync(dir, { withFileTypes: true });
                 for (const entry of entries) {
                     if (entry.isDirectory()) {
-                        scanDir(path.join(dir, entry.name), maxDepth - 1);
+                        scanForFeatures(path.join(dir, entry.name), depth - 1);
                     }
                 }
             }
             catch { }
         }
-        // 1. Scan from cwd downwards (finds all feature page-objects and shared page-objects)
-        scanDir(cwd, 6);
-        // 2. Also look upwards to monorepo root if called from a subfolder
-        let cur = cwd;
-        while (cur !== path.dirname(cur)) {
-            if (fs.existsSync(path.join(cur, "pnpm-workspace.yaml")) || fs.existsSync(path.join(cur, "nx.json")) || fs.existsSync(path.join(cur, "spectra.config.ts"))) {
-                scanDir(cur, 6);
-                break;
-            }
-            cur = path.dirname(cur);
+        scanForFeatures(cwd, 6);
+        return scopes;
+    }
+    static getPageObjectsDirsForScope(scopeDir, sharedDir) {
+        const dirs = [];
+        const candidates = [
+            path.join(scopeDir, "page-objects"),
+            path.join(scopeDir, "pageobjects"),
+        ];
+        if (sharedDir) {
+            candidates.push(path.join(sharedDir, "page-objects"));
+            candidates.push(path.join(sharedDir, "pageobjects"));
+        }
+        for (const c of candidates) {
+            if (fs.existsSync(c) && !dirs.includes(c))
+                dirs.push(c);
         }
         return dirs;
     }
-    static getEntityDirs(cwd, entityType) {
+    static getEntityDirsForScope(entityType, scopeDir, sharedDir) {
         const dirs = [];
-        function scanDir(dir, maxDepth) {
-            if (maxDepth <= 0 || !fs.existsSync(dir))
-                return;
-            const base = path.basename(dir);
-            if (base === "node_modules" || base === "dist" || base === ".git" || base === ".testspectra")
-                return;
-            if (base === entityType) {
-                if (!dirs.includes(dir))
-                    dirs.push(dir);
-                return;
-            }
-            try {
-                const entries = fs.readdirSync(dir, { withFileTypes: true });
-                for (const entry of entries) {
-                    if (entry.isDirectory()) {
-                        scanDir(path.join(dir, entry.name), maxDepth - 1);
-                    }
-                }
-            }
-            catch { }
+        const candidates = [path.join(scopeDir, entityType)];
+        if (sharedDir) {
+            candidates.push(path.join(sharedDir, entityType));
         }
-        // 1. Scan from cwd downwards
-        scanDir(cwd, 6);
-        // 2. Look upwards to monorepo root if called from a subfolder
-        let cur = cwd;
-        while (cur !== path.dirname(cur)) {
-            if (fs.existsSync(path.join(cur, "pnpm-workspace.yaml")) || fs.existsSync(path.join(cur, "nx.json")) || fs.existsSync(path.join(cur, "spectra.config.ts"))) {
-                scanDir(cur, 6);
-                break;
-            }
-            cur = path.dirname(cur);
+        for (const c of candidates) {
+            if (fs.existsSync(c) && !dirs.includes(c))
+                dirs.push(c);
         }
         return dirs;
     }
-    static generateAmbientDeclarations(cwd) {
-        const poDirs = this.getPageObjectsDirs(cwd);
-        const actionsDirs = this.getEntityDirs(cwd, "actions");
-        const stepsDirs = this.getEntityDirs(cwd, "steps");
+    static generateDeclarationsForScope(cwd, outputTypesDir, scopeDir, sharedDir) {
+        const poDirs = this.getPageObjectsDirsForScope(scopeDir, sharedDir);
+        const actionsDirs = this.getEntityDirsForScope("actions", scopeDir, sharedDir);
+        const stepsDirs = this.getEntityDirsForScope("steps", scopeDir, sharedDir);
         const platforms = ["web", "android", "ios", "mobile", "common"];
         const results = {};
         for (const platform of platforms) {
@@ -147,7 +150,7 @@ export class TypeGenerator {
             content += `  shouldHaveClass(this: Promise<WebdriverIO.Element>, className: string): Promise<WebdriverIO.Element>;\n`;
             content += `  shouldHaveAttribute(this: Promise<WebdriverIO.Element>, attributeName: string, expectedValue?: string): Promise<WebdriverIO.Element>;\n`;
             content += `}\n\n`;
-            // 1. Page Objects Global Declarations (Local + Shared Hierarchical)
+            // 1. Page Objects Global Declarations
             const declaredPOMs = new Set();
             for (const poDir of poDirs) {
                 if (!fs.existsSync(poDir))
@@ -165,7 +168,7 @@ export class TypeGenerator {
                         for (const stem of hierarchy) {
                             const cand = path.join(classFolder, `${stem}.ts`);
                             if (fs.existsSync(cand)) {
-                                matchedFile = path.relative(path.join(cwd, ".testspectra/types"), cand).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                                matchedFile = path.relative(outputTypesDir, cand).replace(/\\/g, "/").replace(/\.ts$/, ".js");
                                 if (!matchedFile.startsWith("."))
                                     matchedFile = `./${matchedFile}`;
                                 break;
@@ -180,7 +183,7 @@ export class TypeGenerator {
                         const className = entry.name.split(".")[0];
                         if (declaredPOMs.has(className))
                             continue;
-                        let rel = path.relative(path.join(cwd, ".testspectra/types"), path.join(poDir, entry.name)).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                        let rel = path.relative(outputTypesDir, path.join(poDir, entry.name)).replace(/\\/g, "/").replace(/\.ts$/, ".js");
                         if (!rel.startsWith("."))
                             rel = `./${rel}`;
                         content += `declare const ${className}: typeof import('${rel}').default;\n`;
@@ -228,11 +231,11 @@ export class TypeGenerator {
                             const cand1 = path.join(actionFolder, `${stem}.action.ts`);
                             const cand2 = path.join(actionFolder, `${stem}.ts`);
                             if (fs.existsSync(cand1)) {
-                                matchedFile = path.relative(path.join(cwd, ".testspectra/types"), cand1).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                                matchedFile = path.relative(outputTypesDir, cand1).replace(/\\/g, "/").replace(/\.ts$/, ".js");
                                 break;
                             }
                             else if (fs.existsSync(cand2)) {
-                                matchedFile = path.relative(path.join(cwd, ".testspectra/types"), cand2).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                                matchedFile = path.relative(outputTypesDir, cand2).replace(/\\/g, "/").replace(/\.ts$/, ".js");
                                 break;
                             }
                         }
@@ -242,27 +245,27 @@ export class TypeGenerator {
                             content += `  ${actionName}: (typeof import('${matchedFile}') extends { default: infer T } ? T : typeof import('${matchedFile}'));\n`;
                             declaredActions.add(actionName);
                         }
-                        else {
-                            content += `  ${actionName}: (...args: any[]) => Promise<any>;\n`;
-                            declaredActions.add(actionName);
-                        }
                     }
                     else if (entry.isFile() && entry.name.endsWith(".ts")) {
-                        const actionName = entry.name.split(".")[0];
-                        if (declaredActions.has(actionName))
-                            continue;
-                        let rel = path.relative(path.join(cwd, ".testspectra/types"), path.join(actionsDir, entry.name)).replace(/\\/g, "/").replace(/\.ts$/, ".js");
-                        if (!rel.startsWith("."))
-                            rel = `./${rel}`;
-                        content += `  ${actionName}: (typeof import('${rel}') extends { default: infer T } ? T : typeof import('${rel}'));\n`;
-                        declaredActions.add(actionName);
+                        const parts = entry.name.split(".");
+                        const stem = parts.length > 2 ? parts[parts.length - 2] : parts[0];
+                        const actionName = parts[0];
+                        if (hierarchy.includes(stem) || hierarchy.includes(parts[1])) {
+                            if (declaredActions.has(actionName))
+                                continue;
+                            let rel = path.relative(outputTypesDir, path.join(actionsDir, entry.name)).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                            if (!rel.startsWith("."))
+                                rel = `./${rel}`;
+                            content += `  ${actionName}: (typeof import('${rel}') extends { default: infer T } ? T : typeof import('${rel}'));\n`;
+                            declaredActions.add(actionName);
+                        }
                     }
                 }
             }
             content += `}\n`;
             content += `type TestSpectraActions = SpectraStaticInstance & TestSpectraCustomActions;\n`;
             content += `declare const Spectra: TestSpectraActions;\n\n`;
-            // 3. Shared Steps Global Interface (Local + Shared)
+            // 3. Built-in Steps Declaration
             content += `interface TestSpectraSteps {\n`;
             const declaredSteps = new Set();
             for (const stepsDir of stepsDirs) {
@@ -282,11 +285,11 @@ export class TypeGenerator {
                             const cand1 = path.join(stepFolder, `${stem}.step.ts`);
                             const cand2 = path.join(stepFolder, `${stem}.ts`);
                             if (fs.existsSync(cand1)) {
-                                matchedFile = path.relative(path.join(cwd, ".testspectra/types"), cand1).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                                matchedFile = path.relative(outputTypesDir, cand1).replace(/\\/g, "/").replace(/\.ts$/, ".js");
                                 break;
                             }
                             else if (fs.existsSync(cand2)) {
-                                matchedFile = path.relative(path.join(cwd, ".testspectra/types"), cand2).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                                matchedFile = path.relative(outputTypesDir, cand2).replace(/\\/g, "/").replace(/\.ts$/, ".js");
                                 break;
                             }
                         }
@@ -296,20 +299,20 @@ export class TypeGenerator {
                             content += `  ${stepName}: (typeof import('${matchedFile}') extends { default: infer T } ? T : typeof import('${matchedFile}'));\n`;
                             declaredSteps.add(stepName);
                         }
-                        else {
-                            content += `  ${stepName}: (...args: any[]) => Promise<any>;\n`;
-                            declaredSteps.add(stepName);
-                        }
                     }
                     else if (entry.isFile() && entry.name.endsWith(".ts")) {
-                        const stepName = entry.name.split(".")[0];
-                        if (declaredSteps.has(stepName))
-                            continue;
-                        let rel = path.relative(path.join(cwd, ".testspectra/types"), path.join(stepsDir, entry.name)).replace(/\\/g, "/").replace(/\.ts$/, ".js");
-                        if (!rel.startsWith("."))
-                            rel = `./${rel}`;
-                        content += `  ${stepName}: (typeof import('${rel}') extends { default: infer T } ? T : typeof import('${rel}'));\n`;
-                        declaredSteps.add(stepName);
+                        const parts = entry.name.split(".");
+                        const stem = parts.length > 2 ? parts[parts.length - 2] : parts[0];
+                        const stepName = parts[0];
+                        if (hierarchy.includes(stem) || hierarchy.includes(parts[1])) {
+                            if (declaredSteps.has(stepName))
+                                continue;
+                            let rel = path.relative(outputTypesDir, path.join(stepsDir, entry.name)).replace(/\\/g, "/").replace(/\.ts$/, ".js");
+                            if (!rel.startsWith("."))
+                                rel = `./${rel}`;
+                            content += `  ${stepName}: (typeof import('${rel}') extends { default: infer T } ? T : typeof import('${rel}'));\n`;
+                            declaredSteps.add(stepName);
+                        }
                     }
                 }
             }
@@ -319,8 +322,8 @@ export class TypeGenerator {
         }
         return results;
     }
-    static generateFixturesDeclaration(cwd) {
-        const fixturesDirs = this.getEntityDirs(cwd, "fixtures");
+    static generateFixturesDeclarationForScope(scopeDir, sharedDir) {
+        const fixturesDirs = this.getEntityDirsForScope("fixtures", scopeDir, sharedDir);
         let content = `// Auto-generated ambient fixture declarations for TestSpectra\n`;
         content += `// Managed automatically by TestSpectra Language Service Plugin.\n\n`;
         content += `interface TestSpectraFixtures {\n`;
@@ -345,21 +348,48 @@ export class TypeGenerator {
         return content;
     }
     static writeDeclarationFiles(cwd) {
-        const typesDir = path.join(cwd, ".testspectra", "types");
-        if (!fs.existsSync(typesDir)) {
-            fs.mkdirSync(typesDir, { recursive: true });
+        const rootTypesDir = path.join(cwd, ".testspectra", "types");
+        if (!fs.existsSync(rootTypesDir)) {
+            fs.mkdirSync(rootTypesDir, { recursive: true });
+        }
+        const scopes = this.getEntityScopes(cwd);
+        const sharedScope = scopes.find((s) => s.isShared);
+        // 1. Generate Global / Standalone Root Types (or fallback)
+        const rootFixtures = this.generateFixturesDeclarationForScope(cwd);
+        fs.writeFileSync(path.join(rootTypesDir, "fixtures.d.ts"), rootFixtures, "utf-8");
+        const rootDeclarations = this.generateDeclarationsForScope(cwd, rootTypesDir, cwd);
+        for (const [platform, content] of Object.entries(rootDeclarations)) {
+            fs.writeFileSync(path.join(rootTypesDir, `${platform}.d.ts`), content, "utf-8");
         }
-        // 1. Write single platform-agnostic fixtures.d.ts
-        const fixturesContent = this.generateFixturesDeclaration(cwd);
-        fs.writeFileSync(path.join(typesDir, "fixtures.d.ts"), fixturesContent, "utf-8");
-        // 2. Write per-platform ambient types
-        const declarations = this.generateAmbientDeclarations(cwd);
-        for (const [platform, content] of Object.entries(declarations)) {
-            const filePath = path.join(typesDir, `${platform}.d.ts`);
-            fs.writeFileSync(filePath, content, "utf-8");
+        // 2. Generate Scoped Types for Shared Library: .testspectra/types/shared/
+        if (sharedScope) {
+            const sharedTypesDir = path.join(rootTypesDir, "shared");
+            if (!fs.existsSync(sharedTypesDir))
+                fs.mkdirSync(sharedTypesDir, { recursive: true });
+            const sharedFixtures = this.generateFixturesDeclarationForScope(sharedScope.dir);
+            fs.writeFileSync(path.join(sharedTypesDir, "fixtures.d.ts"), sharedFixtures, "utf-8");
+            // Shared scope has NO feature dependencies (only shared itself)
+            const sharedDeclarations = this.generateDeclarationsForScope(cwd, sharedTypesDir, sharedScope.dir);
+            for (const [platform, content] of Object.entries(sharedDeclarations)) {
+                fs.writeFileSync(path.join(sharedTypesDir, `${platform}.d.ts`), content, "utf-8");
+            }
+        }
+        // 3. Generate Scoped Types for Feature Modules: .testspectra/types/features/<featureName>/
+        const featureScopes = scopes.filter((s) => !s.isShared);
+        for (const feature of featureScopes) {
+            const featureTypesDir = path.join(rootTypesDir, "features", feature.name);
+            if (!fs.existsSync(featureTypesDir))
+                fs.mkdirSync(featureTypesDir, { recursive: true });
+            const featureFixtures = this.generateFixturesDeclarationForScope(feature.dir, sharedScope?.dir);
+            fs.writeFileSync(path.join(featureTypesDir, "fixtures.d.ts"), featureFixtures, "utf-8");
+            // Feature scope gets (feature + shared) ONLY
+            const featureDeclarations = this.generateDeclarationsForScope(cwd, featureTypesDir, feature.dir, sharedScope?.dir);
+            for (const [platform, content] of Object.entries(featureDeclarations)) {
+                fs.writeFileSync(path.join(featureTypesDir, `${platform}.d.ts`), content, "utf-8");
+            }
         }
-        // Also write a universal ambient index
-        const universalPath = path.join(typesDir, "index.d.ts");
+        // Universal ambient index
+        const universalPath = path.join(rootTypesDir, "index.d.ts");
         fs.writeFileSync(universalPath, `/// <reference path="./common.d.ts" />\n`, "utf-8");
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/cli",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "description": "TestSpectra Zero-Config Cross-Platform Test Runner CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/templates/nx/shared/testing/steps/loginAsAdmin/common.step.ts

@@ -1,3 +1,4 @@
 export default async function loginAsAdmin(): Promise<void> {
-  await Step.loginUser("admin", "SuperAdminSecretKey!");
+  // Shared business step directly interacting with shared navigation
+  await NavigationBar.goToHome();
 }

package/templates/nx/tsconfig.spectra.android.json

@@ -14,8 +14,7 @@
     ".testspectra/types/fixtures.d.ts",
     "spectra.config.ts",
     "modules/**/e2e/**/*.ts",
-    "packages/**/e2e/**/*.ts",
-    "shared/testing/**/*.ts"
+    "packages/**/e2e/**/*.ts"
   ],
   "exclude": [
     "node_modules",

package/templates/nx/tsconfig.spectra.ios.json

@@ -14,8 +14,7 @@
     ".testspectra/types/fixtures.d.ts",
     "spectra.config.ts",
     "modules/**/e2e/**/*.ts",
-    "packages/**/e2e/**/*.ts",
-    "shared/testing/**/*.ts"
+    "packages/**/e2e/**/*.ts"
   ],
   "exclude": [
     "node_modules",

package/templates/nx/tsconfig.spectra.json

@@ -12,6 +12,7 @@
   },
   "files": [],
   "references": [
+    { "path": "./tsconfig.spectra.shared.json" },
     { "path": "./tsconfig.spectra.web.json" },
     { "path": "./tsconfig.spectra.android.json" },
     { "path": "./tsconfig.spectra.ios.json" }

package/templates/nx/tsconfig.spectra.shared.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "composite": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+  },
+  "include": [
+    ".testspectra/types/shared/common.d.ts",
+    ".testspectra/types/shared/fixtures.d.ts",
+    "shared/testing/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/templates/nx/tsconfig.spectra.web.json

@@ -14,8 +14,7 @@
     ".testspectra/types/fixtures.d.ts",
     "spectra.config.ts",
     "modules/**/e2e/**/*.ts",
-    "packages/**/e2e/**/*.ts",
-    "shared/testing/**/*.ts"
+    "packages/**/e2e/**/*.ts"
   ],
   "exclude": [
     "node_modules",

package/templates/nx/modules/auth/e2e/actions/applyDiscount/mobile.action.ts

@@ -1,6 +0,0 @@
-export default async function applyDiscount(couponCode: string): Promise<void> {
-  const couponInput = await $('~coupon_input');
-  await couponInput.setValue(couponCode);
-  const applyBtn = await $('~btn_apply');
-  await applyBtn.click();
-}

package/templates/nx/modules/auth/e2e/actions/applyDiscount/web.action.ts

@@ -1,6 +0,0 @@
-export default async function applyDiscount(couponCode: string): Promise<void> {
-  const couponInput = await $('#coupon-code');
-  await couponInput.setValue(couponCode);
-  const applyBtn = await $('#apply-coupon-btn');
-  await applyBtn.click();
-}

package/templates/nx/modules/auth/e2e/fixtures/couponCode.json

@@ -1 +0,0 @@
-"DISCOUNT50"

package/templates/nx/modules/auth/e2e/fixtures/searchQuery.json

@@ -1 +0,0 @@
-"Laptop Gaming"

package/templates/nx/modules/auth/e2e/page-objects/ProductPage/mobile.ts

@@ -1,39 +0,0 @@
-export default class ProductPage {
-  static get searchInput(): ChainablePromiseElement {
-    return $('~search_input');
-  }
-
-  static get categorySelect(): ChainablePromiseElement {
-    return $('~category_picker');
-  }
-
-  static get productList(): ChainablePromiseElement {
-    return $('~product_list');
-  }
-
-  static get firstProductCard(): ChainablePromiseElement {
-    return $('~product_item_0');
-  }
-
-  static get addToCartButton(): ChainablePromiseElement {
-    return $('~btn_add_to_cart');
-  }
-
-  static get cartBadge(): ChainablePromiseElement {
-    return $('~cart_badge');
-  }
-
-  static async open() {
-    // Mobile in-app navigation to products tab
-  }
-
-  static async filterByCategory(category: string) {
-    await Spectra.click(this.categorySelect);
-    await Spectra.click(`~option_${category}`);
-  }
-
-  static async addFirstProductToCart() {
-    await Spectra.swipe({ direction: "down", distance: 400 });
-    await Spectra.click(this.addToCartButton);
-  }
-}

package/templates/nx/modules/auth/e2e/page-objects/ProductPage/web.ts

@@ -1,38 +0,0 @@
-export default class ProductPage {
-  static get searchInput(): ChainablePromiseElement {
-    return $('#search-input');
-  }
-
-  static get categorySelect(): ChainablePromiseElement {
-    return $('#category-select');
-  }
-
-  static get productList(): ChainablePromiseElement {
-    return $('#product-grid');
-  }
-
-  static get firstProductCard(): ChainablePromiseElement {
-    return $('.product-card');
-  }
-
-  static get addToCartButton(): ChainablePromiseElement {
-    return $('#add-to-cart');
-  }
-
-  static get cartBadge(): ChainablePromiseElement {
-    return $('#cart-count');
-  }
-
-  static async open() {
-    await Spectra.navigate('/products');
-  }
-
-  static async filterByCategory(category: string) {
-    await Spectra.select(this.categorySelect, category);
-  }
-
-  static async addFirstProductToCart() {
-    await Spectra.scroll({ selector: this.firstProductCard });
-    await Spectra.click(this.addToCartButton);
-  }
-}

package/templates/nx/modules/auth/e2e/specs/Product/TC-PROD-01/mobile.test.ts

@@ -1,8 +0,0 @@
-it("should filter products by category and add to cart on Mobile (Android & iOS)", async () => {
-  await ProductPage.open();
-  await ProductPage.filterByCategory("Electronics");
-  await ProductPage.addFirstProductToCart();
-
-  await ProductPage.cartBadge.shouldBeVisible();
-  await ProductPage.cartBadge.shouldHaveText("1");
-});

package/templates/nx/modules/auth/e2e/specs/Product/TC-PROD-01/web.test.ts

@@ -1,8 +0,0 @@
-it("should filter products by category and add to cart on Web", async () => {
-  await ProductPage.open();
-  await ProductPage.filterByCategory("Electronics");
-  await ProductPage.addFirstProductToCart();
-
-  await ProductPage.cartBadge.shouldBeVisible();
-  await ProductPage.cartBadge.shouldHaveText("1");
-});

package/templates/nx/modules/auth/e2e/specs/Product/TC-PROD-02/mobile.test.ts

@@ -1,6 +0,0 @@
-it("should search products and apply promotional discount coupon on Mobile", async () => {
-  await Step.searchProduct(Fixture.searchQuery);
-  await Spectra.applyDiscount(Fixture.couponCode);
-
-  await ProductPage.firstProductCard.shouldBeVisible();
-});

package/templates/nx/modules/auth/e2e/specs/Product/TC-PROD-02/web.test.ts

@@ -1,6 +0,0 @@
-it("should search products and apply promotional discount coupon on Web", async () => {
-  await Step.searchProduct(Fixture.searchQuery);
-  await Spectra.applyDiscount(Fixture.couponCode);
-
-  await ProductPage.firstProductCard.shouldBeVisible();
-});

package/templates/nx/modules/auth/e2e/specs/Product/hooks/before.web.hook.ts

@@ -1,3 +0,0 @@
-export default async function (): Promise<void> {
-  // Suite-specific setup for Product catalog suite
-}

package/templates/nx/modules/auth/e2e/steps/searchProduct/mobile.step.ts

@@ -1,5 +0,0 @@
-export default async function searchProduct(query: string): Promise<void> {
-  await ProductPage.open();
-  await Spectra.type(ProductPage.searchInput, query);
-  await Spectra.pressKey("Enter");
-}

package/templates/nx/modules/auth/e2e/steps/searchProduct/web.step.ts

@@ -1,5 +0,0 @@
-export default async function searchProduct(query: string): Promise<void> {
-  await ProductPage.open();
-  await Spectra.type(ProductPage.searchInput, query);
-  await Spectra.pressKey("Enter");
-}

package/templates/nx/modules/catalog/e2e/actions/applyDiscount/mobile.action.ts

@@ -1,6 +0,0 @@
-export default async function applyDiscount(couponCode: string): Promise<void> {
-  const couponInput = await $('~coupon_input');
-  await couponInput.setValue(couponCode);
-  const applyBtn = await $('~btn_apply');
-  await applyBtn.click();
-}

package/templates/nx/modules/catalog/e2e/actions/applyDiscount/web.action.ts

@@ -1,6 +0,0 @@
-export default async function applyDiscount(couponCode: string): Promise<void> {
-  const couponInput = await $('#coupon-code');
-  await couponInput.setValue(couponCode);
-  const applyBtn = await $('#apply-coupon-btn');
-  await applyBtn.click();
-}

package/templates/nx/modules/catalog/e2e/actions/verifyOtp/mobile.action.ts

@@ -1,6 +0,0 @@
-export default async function verifyOtp(otp: string): Promise<void> {
-  const otpInput = await $('~otp_input');
-  await otpInput.setValue(otp);
-  const verifyBtn = await $('~verify_btn');
-  await verifyBtn.click();
-}

package/templates/nx/modules/catalog/e2e/actions/verifyOtp/web.action.ts

@@ -1,6 +0,0 @@
-export default async function verifyOtp(otp: string): Promise<void> {
-  const otpInput = await $('#otp');
-  await otpInput.setValue(otp);
-  const verifyBtn = await $('#verify-btn');
-  await verifyBtn.click();
-}

package/templates/nx/modules/catalog/e2e/fixtures/couponCode.json

@@ -1 +0,0 @@
-"DISCOUNT50"

package/templates/nx/modules/catalog/e2e/fixtures/searchQuery.json

@@ -1 +0,0 @@
-"Laptop Gaming"

package/templates/nx/modules/catalog/e2e/fixtures/userData.json

@@ -1 +0,0 @@
-{"username": "tomsmith", "role": "admin"}

package/templates/nx/modules/catalog/e2e/global-hooks/before.web.hook.ts

@@ -1,4 +0,0 @@
-export default async function (): Promise<void> {
-  // Global before setup (executed once before all suites)
-  await browser.maximizeWindow();
-}

package/templates/nx/modules/catalog/e2e/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "catalog-e2e",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "test": "spectra run",
-    "type-check": "tsc -b"
-  },
-  "devDependencies": {
-    "@testspectra/cli": "workspace:*",
-    "@types/node": "^20.14.0",
-    "@wdio/globals": "^9.2.8",
-    "@wdio/mocha-framework": "^9.2.8",
-    "webdriverio": "^9.2.8",
-    "typescript": "^5.4.5"
-  }
-}

package/templates/nx/modules/catalog/e2e/page-objects/LoginPage/mobile.ts

@@ -1,32 +0,0 @@
-export default class LoginPage {
-  static get usernameInput(): ChainablePromiseElement {
-    return $('~username_input');
-  }
-
-  static get passwordInput(): ChainablePromiseElement {
-    return $('~password_input');
-  }
-
-  static get rememberMeCheckbox(): ChainablePromiseElement {
-    return $('~remember_me_checkbox');
-  }
-
-  static get submitButton(): ChainablePromiseElement {
-    return $('~login_button');
-  }
-
-  static get welcomeText(): ChainablePromiseElement {
-    return $('~welcome_text');
-  }
-
-  static async open() {
-    // Mobile app launch handled by Appium capabilities
-  }
-
-  static async login(username: string, pass: string) {
-    await Spectra.waitForElement(this.usernameInput);
-    await Spectra.type(this.usernameInput, username, { clearFirst: true });
-    await Spectra.type(this.passwordInput, pass, { clearFirst: true });
-    await Spectra.click(this.submitButton);
-  }
-}

package/templates/nx/modules/catalog/e2e/page-objects/LoginPage/web.ts

@@ -1,32 +0,0 @@
-export default class LoginPage {
-  static get usernameInput(): ChainablePromiseElement {
-    return $('#username');
-  }
-
-  static get passwordInput(): ChainablePromiseElement {
-    return $('#password');
-  }
-
-  static get rememberMeCheckbox(): ChainablePromiseElement {
-    return $('#remember-me');
-  }
-
-  static get submitButton(): ChainablePromiseElement {
-    return $('button[type="submit"]');
-  }
-
-  static get flashAlert(): ChainablePromiseElement {
-    return $('#flash');
-  }
-
-  static async open() {
-    await Spectra.navigate('/login');
-  }
-
-  static async login(username: string, pass: string) {
-    await Spectra.waitForElement(this.usernameInput);
-    await Spectra.type(this.usernameInput, username, { clearFirst: true });
-    await Spectra.type(this.passwordInput, pass, { clearFirst: true });
-    await Spectra.click(this.submitButton);
-  }
-}

package/templates/nx/modules/catalog/e2e/page-objects/ProductPage/mobile.ts

@@ -1,39 +0,0 @@
-export default class ProductPage {
-  static get searchInput(): ChainablePromiseElement {
-    return $('~search_input');
-  }
-
-  static get categorySelect(): ChainablePromiseElement {
-    return $('~category_picker');
-  }
-
-  static get productList(): ChainablePromiseElement {
-    return $('~product_list');
-  }
-
-  static get firstProductCard(): ChainablePromiseElement {
-    return $('~product_item_0');
-  }
-
-  static get addToCartButton(): ChainablePromiseElement {
-    return $('~btn_add_to_cart');
-  }
-
-  static get cartBadge(): ChainablePromiseElement {
-    return $('~cart_badge');
-  }
-
-  static async open() {
-    // Mobile in-app navigation to products tab
-  }
-
-  static async filterByCategory(category: string) {
-    await Spectra.click(this.categorySelect);
-    await Spectra.click(`~option_${category}`);
-  }
-
-  static async addFirstProductToCart() {
-    await Spectra.swipe({ direction: "down", distance: 400 });
-    await Spectra.click(this.addToCartButton);
-  }
-}

package/templates/nx/modules/catalog/e2e/page-objects/ProductPage/web.ts

@@ -1,38 +0,0 @@
-export default class ProductPage {
-  static get searchInput(): ChainablePromiseElement {
-    return $('#search-input');
-  }
-
-  static get categorySelect(): ChainablePromiseElement {
-    return $('#category-select');
-  }
-
-  static get productList(): ChainablePromiseElement {
-    return $('#product-grid');
-  }
-
-  static get firstProductCard(): ChainablePromiseElement {
-    return $('.product-card');
-  }
-
-  static get addToCartButton(): ChainablePromiseElement {
-    return $('#add-to-cart');
-  }
-
-  static get cartBadge(): ChainablePromiseElement {
-    return $('#cart-count');
-  }
-
-  static async open() {
-    await Spectra.navigate('/products');
-  }
-
-  static async filterByCategory(category: string) {
-    await Spectra.select(this.categorySelect, category);
-  }
-
-  static async addFirstProductToCart() {
-    await Spectra.scroll({ selector: this.firstProductCard });
-    await Spectra.click(this.addToCartButton);
-  }
-}

package/templates/nx/modules/catalog/e2e/page-objects/SettingsPage/common.ts

@@ -1,26 +0,0 @@
-export default class SettingsPage {
-  static get darkModeToggle(): ChainablePromiseElement {
-    return $('[data-testid="dark-mode-toggle"]');
-  }
-
-  static get languageDropdown(): ChainablePromiseElement {
-    return $('[data-testid="language-select"]');
-  }
-
-  static get saveButton(): ChainablePromiseElement {
-    return $('[data-testid="save-settings"]');
-  }
-
-  static get statusMessage(): ChainablePromiseElement {
-    return $('[data-testid="status-message"]');
-  }
-
-  static async open() {
-    await Spectra.navigate('/settings');
-  }
-
-  static async toggleDarkMode() {
-    await Spectra.click(this.darkModeToggle);
-    await Spectra.click(this.saveButton);
-  }
-}

package/templates/nx/modules/catalog/e2e/project.json

@@ -1,34 +0,0 @@
-{
-  "name": "catalog-e2e",
-  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
-  "projectType": "application",
-  "sourceRoot": "modules/catalog/e2e",
-  "targets": {
-    "e2e": {
-      "executor": "nx:run-commands",
-      "options": {
-        "command": "spectra run",
-        "cwd": "modules/catalog/e2e"
-      },
-      "configurations": {
-        "android": {
-          "command": "spectra run --target android"
-        },
-        "ios": {
-          "command": "spectra run --target ios"
-        },
-        "headless": {
-          "command": "spectra run --headless"
-        }
-      }
-    },
-    "type-check": {
-      "executor": "nx:run-commands",
-      "options": {
-        "command": "tsc -b tsconfig.spectra.json",
-        "cwd": "."
-      }
-    }
-  },
-  "tags": ["scope:catalog", "type:e2e"]
-}

package/templates/nx/modules/catalog/e2e/specs/Auth/TC-AUTH-01/android.test.ts

@@ -1,6 +0,0 @@
-it("should authenticate user on Android Appium device", async () => {
-  await Step.loginUser("tomsmith", "SuperSecretPassword!");
-
-  await LoginPage.welcomeText.shouldBeVisible();
-  await LoginPage.welcomeText.shouldContainText("Welcome");
-});

package/templates/nx/modules/catalog/e2e/specs/Auth/TC-AUTH-01/ios.test.ts

@@ -1,6 +0,0 @@
-it("should authenticate user on iOS Appium device", async () => {
-  await Step.loginUser("tomsmith", "SuperSecretPassword!");
-
-  await LoginPage.welcomeText.shouldBeVisible();
-  await LoginPage.welcomeText.shouldContainText("Welcome");
-});

package/templates/nx/modules/catalog/e2e/specs/Auth/TC-AUTH-01/web.test.ts

@@ -1,13 +0,0 @@
-it("should authenticate user and verify flash message across specific platforms", async () => {
-  await browser.intercept("/api/status", "GET", Fixture.userData);
-
-  // 1. Navigation via Page Object
-  await LoginPage.open();
-
-  // 2. High-level business flow via Shared Step & Page Object
-  await Step.loginUser("tomsmith", "SuperSecretPassword!");
-
-  // 3. Direct callable assertion on Page Object element
-  await LoginPage.flashAlert.shouldBeVisible();
-  await LoginPage.flashAlert.shouldContainText("You logged into a secure area!");
-});

package/templates/nx/modules/catalog/e2e/specs/Auth/TC-AUTH-02/android.test.ts

@@ -1,5 +0,0 @@
-it("should toggle remember me checkbox on Android", async () => {
-  await LoginPage.open();
-  await LoginPage.rememberMeCheckbox.shouldBeVisible();
-  await Spectra.click(LoginPage.rememberMeCheckbox);
-});

package/templates/nx/modules/catalog/e2e/specs/Auth/TC-AUTH-02/web.test.ts

@@ -1,5 +0,0 @@
-it("should toggle remember me checkbox on Web", async () => {
-  await LoginPage.open();
-  await LoginPage.rememberMeCheckbox.shouldBeVisible();
-  await Spectra.click(LoginPage.rememberMeCheckbox);
-});

package/templates/nx/modules/catalog/e2e/specs/Auth/hooks/before.android.hook.ts

@@ -1,3 +0,0 @@
-export default async function (): Promise<void> {
-  // Setup Android Appium capabilities
-}

package/templates/nx/modules/catalog/e2e/specs/Auth/hooks/before.ios.hook.ts

@@ -1,3 +0,0 @@
-export default async function (): Promise<void> {
-  // Setup iOS Appium capabilities
-}

package/templates/nx/modules/catalog/e2e/specs/Auth/hooks/before.web.hook.ts

@@ -1,3 +0,0 @@
-export default async function (): Promise<void> {
-  // Suite-specific setup before test cases in Auth suite run
-}

package/templates/nx/modules/catalog/e2e/specs/Product/TC-PROD-01/mobile.test.ts

@@ -1,8 +0,0 @@
-it("should filter products by category and add to cart on Mobile (Android & iOS)", async () => {
-  await ProductPage.open();
-  await ProductPage.filterByCategory("Electronics");
-  await ProductPage.addFirstProductToCart();
-
-  await ProductPage.cartBadge.shouldBeVisible();
-  await ProductPage.cartBadge.shouldHaveText("1");
-});

package/templates/nx/modules/catalog/e2e/specs/Product/TC-PROD-01/web.test.ts

@@ -1,8 +0,0 @@
-it("should filter products by category and add to cart on Web", async () => {
-  await ProductPage.open();
-  await ProductPage.filterByCategory("Electronics");
-  await ProductPage.addFirstProductToCart();
-
-  await ProductPage.cartBadge.shouldBeVisible();
-  await ProductPage.cartBadge.shouldHaveText("1");
-});

package/templates/nx/modules/catalog/e2e/specs/Product/TC-PROD-02/mobile.test.ts

@@ -1,6 +0,0 @@
-it("should search products and apply promotional discount coupon on Mobile", async () => {
-  await Step.searchProduct(Fixture.searchQuery);
-  await Spectra.applyDiscount(Fixture.couponCode);
-
-  await ProductPage.firstProductCard.shouldBeVisible();
-});

package/templates/nx/modules/catalog/e2e/specs/Product/TC-PROD-02/web.test.ts

@@ -1,6 +0,0 @@
-it("should search products and apply promotional discount coupon on Web", async () => {
-  await Step.searchProduct(Fixture.searchQuery);
-  await Spectra.applyDiscount(Fixture.couponCode);
-
-  await ProductPage.firstProductCard.shouldBeVisible();
-});

package/templates/nx/modules/catalog/e2e/specs/Product/hooks/before.web.hook.ts

@@ -1,3 +0,0 @@
-export default async function (): Promise<void> {
-  // Suite-specific setup for Product catalog suite
-}

package/templates/nx/modules/catalog/e2e/specs/Settings/TC-SET-01/common.test.ts

@@ -1,8 +0,0 @@
-it("should toggle dark mode setting across all platforms (Common)", async () => {
-  await SettingsPage.open();
-  await SettingsPage.darkModeToggle.shouldBeVisible();
-  await SettingsPage.toggleDarkMode();
-
-  await SettingsPage.statusMessage.shouldBeVisible();
-  await SettingsPage.statusMessage.shouldContainText("Settings saved");
-});

package/templates/nx/modules/catalog/e2e/steps/loginUser/mobile.step.ts

@@ -1,4 +0,0 @@
-export default async function loginUser(u: string, p: string): Promise<void> {
-  await LoginPage.open();
-  await LoginPage.login(u, p);
-}

package/templates/nx/modules/catalog/e2e/steps/loginUser/web.step.ts

@@ -1,4 +0,0 @@
-export default async function loginUser(u: string, p: string): Promise<void> {
-  await LoginPage.open();
-  await LoginPage.login(u, p);
-}

package/templates/nx/modules/catalog/e2e/steps/searchProduct/mobile.step.ts

@@ -1,5 +0,0 @@
-export default async function searchProduct(query: string): Promise<void> {
-  await ProductPage.open();
-  await Spectra.type(ProductPage.searchInput, query);
-  await Spectra.pressKey("Enter");
-}

package/templates/nx/modules/catalog/e2e/steps/searchProduct/web.step.ts

@@ -1,5 +0,0 @@
-export default async function searchProduct(query: string): Promise<void> {
-  await ProductPage.open();
-  await Spectra.type(ProductPage.searchInput, query);
-  await Spectra.pressKey("Enter");
-}