@testspectra/cli 1.0.26 → 1.0.28

package/dist/commands/add.js

@@ -362,8 +362,8 @@ export async function addCommand(moduleNameArg, options = {}) {
     // Create starter page object
     const poContent = `class ${targetModule}Page {\n  get mainTitle() {\n    return $("h1");\n  }\n\n  async open() {\n    await Spectra.navigate("/${targetModule.toLowerCase()}");\n  }\n}\n\nexport default new ${targetModule}Page();\n`;
     fs.writeFileSync(path.join(poDir, "common.ts"), poContent, "utf-8");
-    // Create starter test spec
-    const specContent = `describe("${targetModule} Test Suite", () => {\n  it("should verify ${targetModule} page components", async () => {\n    await ${targetModule}Page.open();\n    await ${targetModule}Page.mainTitle.shouldBeVisible();\n  });\n});\n`;
+    // Create starter test spec (Zero-import, flat it() block)
+    const specContent = `it("should verify ${targetModule} page components", async () => {\n  await ${targetModule}Page.open();\n  await ${targetModule}Page.mainTitle.shouldBeVisible();\n});\n`;
     fs.writeFileSync(path.join(specDir, "web.test.ts"), specContent, "utf-8");
     TypeGenerator.writeDeclarationFiles(cwd);
     p.log.success(chalk.green(`Created Page Object: ./page-objects/${targetModule}Page/common.ts`));

package/dist/commands/init.js

@@ -434,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()\`).
@@ -445,45 +445,107 @@ 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
 
-\`\`\`
-  ┌──────────────────────────────┐          ┌──────────────────────────────┐
-  │ ${sharedPoLine} │          │   packages/*/e2e/specs/      │
-  │ ${sharedStepsLine} │ ───────► │   (Zero-Import Test Cases)   │
-  │ ${sharedActLine} │          │   - NavigationBar.goToHome() │
-  │ ${sharedFixLine} │          │   - 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
+// packages/features/auth/e2e/specs/Auth/TC-AUTH-01/web.test.ts
+// 🌟 NOTICE: 100% Zero-Import & Flat Execution! (No import statement, no describe wrapper)
+
+it("should navigate via shared header and login with local POM", async () => {
+  // 1. Consumed from Shared Testing Library (${sharedTestingRelPath}/page-objects/NavigationBar)
+  await NavigationBar.goToLogin();
+
+  // 2. Consumed from Shared Testing Library (${sharedTestingRelPath}/steps/loginAsAdmin)
+  await Step.loginAsAdmin();
+
+  // 3. Consumed from Local Feature POM (page-objects/LoginPage)
+  await LoginPage.flashAlert.shouldBeVisible();
+  await LoginPage.flashAlert.shouldContainText("Welcome");
+
+  // 4. Consumed from Shared Testing 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/package.json

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