@testspectra/cli 1.0.25 → 1.0.27

package/dist/commands/init.js

@@ -415,7 +415,10 @@ export async function initCommand(options = {}) {
         for (const e2eDir of featureE2eDirs) {
             TypeGenerator.writeDeclarationFiles(e2eDir);
         }
-        // 8. Generate ARCHITECTURE.md in root documenting the exact generated layout
+        const sharedPoLine = `${sharedTestingRelPath}/page-objects`.padEnd(28, " ");
+        const sharedStepsLine = `${sharedTestingRelPath}/steps`.padEnd(28, " ");
+        const sharedActLine = `${sharedTestingRelPath}/actions`.padEnd(28, " ");
+        const sharedFixLine = `${sharedTestingRelPath}/fixtures`.padEnd(28, " ");
         const archDocContent = `# TestSpectra Enterprise Monorepo Architecture
 
 This workspace uses TestSpectra's **"Centralized Configuration, Distributed Implementation"** model for automated cross-platform testing.
@@ -431,7 +434,7 @@ This workspace uses TestSpectra's **"Centralized Configuration, Distributed Impl
 - \`./pnpm-workspace.yaml\`: Monorepo package glob definitions.
 - \`./tsconfig.json\`: Solution-style TypeScript orchestrator linking all distributed E2E projects and shared libraries.
 
-### Centralized Shared Library (\`./${sharedTestingRelPath}\`)
+### Centralized Shared Testing Library (\`./${sharedTestingRelPath}\`)
 Provides cross-feature reusable test entities with **100% zero-import global resolution**:
 - \`page-objects/\`: Shared Page Object models (e.g. NavigationBar, AppHeader).
 - \`steps/\`: Cross-feature business step flows (e.g. \`Step.loginAsAdmin()\`).
@@ -442,45 +445,109 @@ Provides cross-feature reusable test entities with **100% zero-import global res
 ${featureE2eDirs.map((d) => {
             const rel = path.relative(cwd, d);
             const name = path.basename(path.dirname(d));
-            return `- \`./${rel}\` (**${name}**):
-  - \`specs/\`: Feature test cases (\`specs/<SuiteName>/<CaseId>/\` for web, android, ios).
-  - \`page-objects/\`: Feature-specific Page Objects (e.g. LoginPage, ProductPage).
+            const e2eName = `${name}-${e2eFolderName}`;
+            return `- \`./${rel}\` (**${name}**, Nx Project: \`${e2eName}\`):
+  - \`specs/\`: Feature test cases (\`specs/<SuiteName>/<CaseId>/\` with \`web.test.ts\`, \`android.test.ts\`, \`ios.test.ts\`).
+  - \`page-objects/\`: Feature-specific Page Objects (e.g. \`LoginPage\`, \`ProductPage\`).
   - \`project.json\`: Nx targets (\`e2e\`, \`type-check\`) supporting configurations (\`--configuration=android\`, \`--configuration=ios\`, \`--configuration=headless\`).
   - \`tsconfig.json\`: Solution TypeScript config reference.`;
         }).join("\n")}
 
 ---
 
-## 2. Zero-Import Consumption Flow
+## 2. Zero-Import Consumption Flow & Mechanics
 
-\`\`\`
-  ┌──────────────────────────────┐          ┌──────────────────────────────┐
-  │ shared/testing/page-objects  │          │   modules/*/e2e/specs/       │
-  │ shared/testing/steps         │ ───────► │   (Zero-Import Test Cases)   │
-  │ shared/testing/actions       │          │   - NavigationBar.goToHome() │
-  │ shared/testing/fixtures      │          │   - Step.loginAsAdmin()      │
-  └──────────────────────────────┘          │   - Spectra.dismissBanner()  │
-                                            └──────────────────────────────┘
+TestSpectra completely eliminates boilerplate \`import\` statements across all test specs, steps, and page objects.
+
+### How It Works:
+1. **Centralized Ambient Aggregation**:  
+   TestSpectra Language Service Plugin & CLI automatically scan:
+   - **Local Feature Entities**: \`<feature>/${e2eFolderName}/page-objects/\`, \`<feature>/${e2eFolderName}/steps/\`, \`<feature>/${e2eFolderName}/actions/\`
+   - **Shared Library Entities**: \`./${sharedTestingRelPath}/page-objects/\`, \`./${sharedTestingRelPath}/steps/\`, \`./${sharedTestingRelPath}/actions/\`, \`./${sharedTestingRelPath}/fixtures/\`
+2. **Ambient Typing Generation**:  
+   These are compiled into \`.testspectra/types/web.d.ts\`, \`android.d.ts\`, \`ios.d.ts\`, \`fixtures.d.ts\`.
+3. **Instant IDE Autocomplete & Zero Clutter**:  
+   Specs consume both local feature objects and shared library utilities globally.
+
+### Code Example:
+\`\`\`typescript
+// modules/auth/e2e/specs/Auth/TC-AUTH-01/web.test.ts
+// 🌟 NOTICE: 100% Zero-Import statement! Everything resolves globally.
+
+describe("Authentication Flow", () => {
+  it("should navigate via shared header and login with local POM", async () => {
+    // 1. Consumed from Shared Library (${sharedTestingRelPath}/page-objects/NavigationBar)
+    await NavigationBar.goToLogin();
+
+    // 2. Consumed from Shared Library (${sharedTestingRelPath}/steps/loginAsAdmin)
+    await Step.loginAsAdmin();
+
+    // 3. Consumed from Local Feature POM (modules/auth/e2e/page-objects/LoginPage)
+    await LoginPage.flashAlert.shouldBeVisible();
+    await LoginPage.flashAlert.shouldContainText("Welcome");
+
+    // 4. Consumed from Shared Library Custom Action (${sharedTestingRelPath}/actions/dismissBanner)
+    await Spectra.dismissBanner();
+  });
+});
 \`\`\`
 
 ---
 
-## 3. Running Tests via Nx
+## 3. How to Run Tests
+
+You can execute tests either from the **Monorepo Root via Nx** or directly inside each **Feature Directory via CLI**:
+
+### Option A: From Root Monorepo via Nx (Recommended for CI & Team Workflows)
 
 \`\`\`bash
-# Run all feature E2E suites in parallel
+# 1. Run E2E for a SPECIFIC feature module (e.g. auth)
+pnpm nx run auth-${e2eFolderName}:e2e
+
+# 2. Run E2E for a specific feature on ANDROID or IOS
+pnpm nx run auth-${e2eFolderName}:e2e --configuration=android
+pnpm nx run auth-${e2eFolderName}:e2e --configuration=ios
+
+# 3. Run E2E for a specific feature in HEADLESS browser mode
+pnpm nx run auth-${e2eFolderName}:e2e --configuration=headless
+
+# 4. Run ALL feature E2E suites across the entire monorepo in parallel
 pnpm nx run-many -t e2e
 
-# Run only E2E tests for features changed in PR
+# 5. Run only E2E tests for features modified in current Git branch / PR
 pnpm nx affected -t e2e
+\`\`\`
 
-# Run E2E for a specific feature on Android
-pnpm nx run auth-${e2eFolderName}:e2e --configuration=android
+### Option B: From Inside the Feature Directory (Direct CLI)
+
+\`\`\`bash
+# Navigate to the feature e2e folder
+cd ${featureE2eDirs.length > 0 ? path.relative(cwd, featureE2eDirs[0]).replace(/\\/g, "/") : `modules/auth/${e2eFolderName}`}
+
+# Run all specs in this feature
+pnpm spectra run
+
+# Run a specific test case file
+pnpm spectra run specs/Auth/TC-AUTH-01/web.test.ts
+
+# Target Android device or emulator
+pnpm spectra run --target android
 
-# Run type check across all E2E projects
+# Run in headed / interactive browser mode
+pnpm spectra run --no-headless
+\`\`\`
+
+---
+
+## 4. Type Checking & Validation
+
+\`\`\`bash
+# Type check all E2E projects via Nx
 pnpm nx run-many -t type-check
-# Or standard TypeScript compilation
+
+# Or standard TypeScript project references build from root
 pnpm type-check
+# or: npx tsc -b
 \`\`\`
 `;
         fs.writeFileSync(path.join(cwd, "ARCHITECTURE.md"), archDocContent, "utf-8");

package/dist/types/generator.js

@@ -19,12 +19,38 @@ export class TypeGenerator {
         // Look for shared directories in monorepo root
         let cur = cwd;
         while (cur !== path.dirname(cur)) {
-            const sharedTestingPo = path.join(cur, "shared/testing/page-objects");
-            const sharedPo = path.join(cur, "shared/page-objects");
-            if (fs.existsSync(sharedTestingPo) && !dirs.includes(sharedTestingPo))
-                dirs.push(sharedTestingPo);
-            if (fs.existsSync(sharedPo) && !dirs.includes(sharedPo))
-                dirs.push(sharedPo);
+            const candidates = [
+                path.join(cur, "shared/testing/page-objects"),
+                path.join(cur, "shared/page-objects"),
+                path.join(cur, "packages/core/testing/page-objects"),
+                path.join(cur, "packages/shared/testing/page-objects"),
+                path.join(cur, "packages/testing/page-objects"),
+                path.join(cur, "core/testing/page-objects"),
+            ];
+            for (const cand of candidates) {
+                if (fs.existsSync(cand) && !dirs.includes(cand))
+                    dirs.push(cand);
+            }
+            // Also dynamically check tsconfig.json references if in root
+            const rootTsConfig = path.join(cur, "tsconfig.json");
+            if (fs.existsSync(rootTsConfig)) {
+                try {
+                    const parsed = JSON.parse(fs.readFileSync(rootTsConfig, "utf-8"));
+                    if (Array.isArray(parsed.references)) {
+                        for (const ref of parsed.references) {
+                            if (ref.path) {
+                                const poPath1 = path.resolve(cur, ref.path, "page-objects");
+                                const poPath2 = path.resolve(cur, ref.path, "pageobjects");
+                                if (fs.existsSync(poPath1) && !dirs.includes(poPath1))
+                                    dirs.push(poPath1);
+                                if (fs.existsSync(poPath2) && !dirs.includes(poPath2))
+                                    dirs.push(poPath2);
+                            }
+                        }
+                    }
+                }
+                catch { }
+            }
             if (fs.existsSync(path.join(cur, "pnpm-workspace.yaml")) || fs.existsSync(path.join(cur, "nx.json")))
                 break;
             cur = path.dirname(cur);
@@ -38,12 +64,35 @@ export class TypeGenerator {
             dirs.push(local);
         let cur = cwd;
         while (cur !== path.dirname(cur)) {
-            const sharedTesting = path.join(cur, "shared/testing", entityType);
-            const shared = path.join(cur, "shared", entityType);
-            if (fs.existsSync(sharedTesting) && !dirs.includes(sharedTesting))
-                dirs.push(sharedTesting);
-            if (fs.existsSync(shared) && !dirs.includes(shared))
-                dirs.push(shared);
+            const candidates = [
+                path.join(cur, "shared/testing", entityType),
+                path.join(cur, "shared", entityType),
+                path.join(cur, "packages/core/testing", entityType),
+                path.join(cur, "packages/shared/testing", entityType),
+                path.join(cur, "packages/testing", entityType),
+                path.join(cur, "core/testing", entityType),
+            ];
+            for (const cand of candidates) {
+                if (fs.existsSync(cand) && !dirs.includes(cand))
+                    dirs.push(cand);
+            }
+            // Also dynamically check tsconfig.json references
+            const rootTsConfig = path.join(cur, "tsconfig.json");
+            if (fs.existsSync(rootTsConfig)) {
+                try {
+                    const parsed = JSON.parse(fs.readFileSync(rootTsConfig, "utf-8"));
+                    if (Array.isArray(parsed.references)) {
+                        for (const ref of parsed.references) {
+                            if (ref.path) {
+                                const entPath = path.resolve(cur, ref.path, entityType);
+                                if (fs.existsSync(entPath) && !dirs.includes(entPath))
+                                    dirs.push(entPath);
+                            }
+                        }
+                    }
+                }
+                catch { }
+            }
             if (fs.existsSync(path.join(cur, "pnpm-workspace.yaml")) || fs.existsSync(path.join(cur, "nx.json")))
                 break;
             cur = path.dirname(cur);

package/package.json

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