@testspectra/cli 1.0.62 → 1.0.63

package/README.md

@@ -179,35 +179,36 @@ export default defineConfig({
 ├── tsconfig.android.json        # Android platform TypeScript scope
 ├── tsconfig.ios.json            # iOS platform TypeScript scope
 ├── page-objects/                # Page Object Model folders
-│   └── LoginPage/
+│   └── PlaygroundPage/
 │         ├── web.ts
 │         └── mobile.ts
-├── actions/                     # Reusable atomic actions
-│   └── verifyOtp/
-│         ├── web.action.ts
-│         └── mobile.action.ts
-├── steps/                       # High-level business flows
-│   └── loginUser/
-│         ├── web.step.ts
-│         └── mobile.step.ts
+├── support/
+│   ├── actions/                 # Reusable atomic actions
+│   │   └── fillCredentials/
+│   │         ├── web.action.ts
+│   │         └── mobile.action.ts
+│   └── steps/                   # High-level business flows
+│       └── verifyPlaygroundState/
+│             ├── web.step.ts
+│             └── mobile.step.ts
 ├── global-hooks/                # Global lifecycle hooks
-│   └── before.web.hook.ts
+│   └── before/
+│         └── web.hook.ts
 ├── specs/                       # Layered zero-import test cases
-│   └── Auth/
-│         └── TC-AUTH-01/
+│   └── Playground/
+│         └── TC-0001-form-controls/
 │               ├── web.test.ts
-│               ├── android.test.ts
-│               └── ios.test.ts
+│               └── mobile.test.ts
 ├── fixtures/                    # Platform-agnostic test data
-│   └── userData.json
-└── .testspectra/                # Auto-generated ambient typings & cache
-    └── types/
-          ├── fixtures.d.ts
-          ├── web.d.ts
-          ├── android.d.ts
-          ├── ios.d.ts
-          ├── mobile.d.ts
-          └── common.d.ts
+│   └── playgroundData.json
+├── .testspectra/                # Auto-generated ambient typings & cache
+│     └── types/
+│           ├── fixtures.d.ts
+│           ├── web.d.ts
+│           ├── android.d.ts
+│           ├── ios.d.ts
+│           ├── mobile.d.ts
+│           └── common.d.ts
 ```
 
 ---
@@ -230,19 +231,19 @@ TestSpectra features an enterprise-grade architecture for large monorepos: **"Ce
                  ┌──────────────────────────────┴──────────────────────────────┐
                  ▼                                                             ▼
   ┌───────────────────────────────┐                             ┌───────────────────────────────┐
-  │   shared/testing/ (Library)   │                             │  packages/features/auth/e2e/  │
+  │   shared/testing/ (Library)   │                             │    packages/playground/e2e/   │
   ├───────────────────────────────┤                             ├───────────────────────────────┤
   │ - Shared Page Objects         │ ◄─── Auto-Scanned Globals ──│ - Feature Specs (specs/)      │
-  │ - Shared Steps (loginAsAdmin) │     (100% Zero-Import!)     │ - Feature Page Objects (POMs) │
-  │ - Shared Actions (dismissBtn) │                             │ - project.json (Nx Target)    │
-  │ - Shared Fixtures (appConfig) │                             │ - tsconfig.web/android/ios    │
+  │ - Shared Steps (verifyState)  │     (100% Zero-Import!)     │ - Feature Page Objects (POMs) │
+  │ - Shared Actions (fillCreds)  │                             │ - project.json (Nx Target)    │
+  │ - Shared Fixtures (playData)  │                             │ - tsconfig.web/android/ios    │
   └───────────────────────────────┘                             └───────────────────────────────┘
 ```
 
 ### Key Pillars of Monorepo Integration:
 
 1. **Interactive Workspace Auto-Discovery (`spectra init`)**:
-   - Parses `pnpm-workspace.yaml` (e.g. `packages/features/*`, `modules/**`).
+   - Parses `pnpm-workspace.yaml` (e.g. `packages/*`, `modules/**`).
    - Scans sub-directories for existing `project.json` or `package.json`.
    - Prompts the user with an interactive multi-select checkbox to choose which features will receive E2E testing.
    - Prompts for customizable E2E folder names (e.g. `e2e`, `test/e2e`) and the shared testing library path (`shared/testing`).
@@ -253,18 +254,18 @@ TestSpectra features an enterprise-grade architecture for large monorepos: **"Ce
    - Driver caches, binaries, and logs reside in `<root>/.testspectra/`, preventing repository clutter across individual feature folders.
 
 3. **Global Zero-Import Consumption of Shared Library**:
-   - Entities placed inside `shared/testing/page-objects/`, `shared/testing/steps/`, `shared/testing/actions/`, and `shared/testing/fixtures/` are automatically aggregated into ambient declarations.
-   - Feature test specs consume shared Page Objects (`NavigationBar.goToHome()`), steps (`Step.loginAsAdmin()`), actions (`Spectra.dismissBanner()`), and fixtures (`Fixture.appConfig`) **without a single line of `import` statement**.
+   - Entities placed inside `shared/testing/page-objects/`, `shared/testing/support/steps/`, `shared/testing/support/actions/`, and `shared/testing/fixtures/` are automatically aggregated into ambient declarations.
+   - Feature test specs consume shared Page Objects (`PlaygroundPage.open()`), steps (`Step.verifyPlaygroundState()`), actions (`Spectra.fillCredentials()`), and fixtures (`Fixture.playgroundData`) **without a single line of `import` statement**.
 
 4. **Nx Target Execution & Affected Caching**:
    - Each feature E2E folder includes an Nx `project.json`:
      ```json
      {
-       "name": "auth-e2e",
+       "name": "playground-e2e",
        "targets": {
          "e2e": {
            "executor": "nx:run-commands",
-           "options": { "command": "spectra run", "cwd": "modules/auth/e2e" },
+           "options": { "command": "spectra run", "cwd": "packages/playground/e2e" },
            "configurations": {
              "android": { "command": "spectra run --target android" },
              "ios": { "command": "spectra run --target ios" },

package/dist/commands/add.js

@@ -130,7 +130,7 @@ export async function addCommand(moduleNameArg, options = {}) {
     if (!fs.existsSync(templateDir)) {
         templateDir = path.resolve(__dirname, "../../../templates/nx");
     }
-    const sampleE2eSrc = path.join(templateDir, "modules/auth/e2e");
+    const sampleE2eSrc = path.join(templateDir, "packages/playground/e2e");
     if (!fs.existsSync(sampleE2eSrc)) {
         p.cancel(chalk.red(`Template directory not found at: ${sampleE2eSrc}`));
         return;
@@ -283,9 +283,9 @@ export async function addCommand(moduleNameArg, options = {}) {
         const s = p.spinner();
         s.start(`Scaffolding ${e2eProjectName} in ./${path.relative(rootDir, targetE2eDir)}...`);
         copyRecursive(sampleE2eSrc, targetE2eDir, {
-            "auth-e2e": e2eProjectName,
-            "modules/auth/e2e": path.relative(rootDir, targetE2eDir).replace(/\\/g, "/"),
-            "scope:auth": `scope:${featureName}`,
+            "playground-e2e": e2eProjectName,
+            "packages/playground/e2e": path.relative(rootDir, targetE2eDir).replace(/\\/g, "/"),
+            "scope:playground": `scope:${featureName}`,
         });
         // Adjust project.json
         const projJsonPath = path.join(targetE2eDir, "project.json");

package/dist/commands/init.js

@@ -338,7 +338,7 @@ export async function initCommand(options = {}) {
             p.log.warn(chalk.yellow("No feature packages found in workspace. You can enter feature names to scaffold."));
             const featureNamesInput = await p.text({
                 message: "Enter feature module names (comma-separated), or leave blank to skip:",
-                placeholder: "auth, catalog, payment",
+                placeholder: "playground, matchers, navigation",
                 defaultValue: "",
             });
             if (p.isCancel(featureNamesInput)) {
@@ -350,14 +350,14 @@ export async function initCommand(options = {}) {
                 // Build relPaths from feature names using a sensible default location
                 const featureBaseInput = await p.text({
                     message: "Enter base directory for feature modules:",
-                    placeholder: "packages/features",
-                    defaultValue: "packages/features",
+                    placeholder: "packages",
+                    defaultValue: "packages",
                 });
                 if (p.isCancel(featureBaseInput)) {
                     p.cancel("Setup cancelled.");
                     return;
                 }
-                const featureBase = featureBaseInput.trim() || "packages/features";
+                const featureBase = featureBaseInput.trim() || "packages";
                 chosenProjects = raw.split(",").map((n) => `${featureBase}/${n.trim()}`).filter(Boolean);
             }
         }
@@ -467,16 +467,16 @@ export async function initCommand(options = {}) {
             copyRecursive(sharedTestingSrc, sharedTestingAbsPath);
         }
         // 4. Distribute E2E Folders to Selected Feature Modules
-        const sampleE2eSrc = path.join(templateDir, "modules/auth/e2e");
+        const sampleE2eSrc = path.join(templateDir, "packages/playground/e2e");
         const featureE2eDirs = [];
         for (const projRel of chosenProjects) {
             const targetE2eDir = path.join(cwd, projRel, e2eFolderName);
             const featureName = path.basename(projRel);
             const e2eProjectName = `${featureName}-${e2eFolderName}`;
             copyRecursive(sampleE2eSrc, targetE2eDir, {
-                "auth-e2e": e2eProjectName,
-                "modules/auth/e2e": path.relative(cwd, targetE2eDir).replace(/\\/g, "/"),
-                "scope:auth": `scope:${featureName}`,
+                "playground-e2e": e2eProjectName,
+                "packages/playground/e2e": path.relative(cwd, targetE2eDir).replace(/\\/g, "/"),
+                "scope:playground": `scope:${featureName}`,
             });
             // Adjust project.json
             const projJsonPath = path.join(targetE2eDir, "project.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/cli",
-  "version": "1.0.62",
+  "version": "1.0.63",
   "description": "TestSpectra Zero-Config Cross-Platform Test Runner CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,7 +29,7 @@
   ],
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@testspectra/matchers": "^1.0.62",
+    "@testspectra/matchers": "^1.0.63",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.5",

package/templates/default/CLAUDE.md

@@ -1,9 +1,8 @@
 # CLAUDE.md - TestSpectra Framework Conventions
 
 ## Commands
-- Run all Web tests against live demo app: `pnpm spectra run --demo`
-- Run specific spec with demo app: `pnpm spectra run --spec specs/authentication/TC-0001-valid-login/web.test.ts --demo`
-- Run Web tests: `pnpm test`
+- Run all Web tests: `pnpm spectra run -t web`
+- Run specific spec: `pnpm spectra run "specs/Playground/TC-0001-form-controls/web.test.ts" -t web`
 - Run Mobile tests: `pnpm spectra run --target android` or `pnpm spectra run --target ios`
 - Type checking: `pnpm type-check` (or `tsc -b`)
 - Preflight doctor: `pnpm spectra doctor`

package/templates/default/package.json

@@ -9,7 +9,7 @@
   },
   "devDependencies": {
     "@testspectra/cli": "workspace:*",
-    "@testspectra/matchers": "^1.0.62",
+    "@testspectra/matchers": "workspace:*",
     "@types/node": "^20.14.0",
     "@wdio/cli": "^9.2.8",
     "@wdio/local-runner": "^9.2.8",

package/templates/nx/CLAUDE.md

@@ -1,10 +1,10 @@
 # CLAUDE.md - TestSpectra Framework Conventions
 
 ## Commands
-- Run all Web tests against live demo app: `pnpm spectra run --demo`
-- Run specific spec with demo app: `pnpm spectra run --spec specs/authentication/TC-0001-valid-login/web.test.ts --demo`
-- Run Web tests: `pnpm test`
+- Run all Web tests: `pnpm spectra run -t web`
+- Run specific spec: `pnpm spectra run "specs/Playground/TC-0001-form-controls/web.test.ts" -t web`
+- Run Nx monorepo E2E targets: `pnpm nx run-many -t e2e`
 - Run Mobile tests: `pnpm spectra run --target android` or `pnpm spectra run --target ios`
-- Type checking: `pnpm type-check` (or `tsc -b`)
+- Type checking: `pnpm type-check` (or `tsc -b tsconfig.spectra.json`)
 - Preflight doctor: `pnpm spectra doctor`
 - List devices: `pnpm spectra devices`

package/templates/nx/package.json

@@ -11,7 +11,7 @@
   },
   "devDependencies": {
     "@testspectra/cli": "workspace:*",
-    "@testspectra/matchers": "^1.0.62",
+    "@testspectra/matchers": "workspace:*",
     "@types/node": "^20.14.0",
     "@wdio/globals": "^9.2.8",
     "@wdio/mocha-framework": "^9.2.8",

package/templates/nx/packages/matchers/e2e/project.json

@@ -0,0 +1,37 @@
+{
+  "name": "matchers-e2e",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "application",
+  "sourceRoot": "packages/matchers/e2e",
+  "targets": {
+    "e2e": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "spectra run",
+        "cwd": "packages/matchers/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",
+        "cwd": "."
+      }
+    }
+  },
+  "tags": [
+    "scope:matchers",
+    "type:e2e"
+  ]
+}

package/templates/nx/packages/playground/e2e/project.json

@@ -0,0 +1,37 @@
+{
+  "name": "playground-e2e",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "application",
+  "sourceRoot": "packages/playground/e2e",
+  "targets": {
+    "e2e": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "spectra run",
+        "cwd": "packages/playground/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",
+        "cwd": "."
+      }
+    }
+  },
+  "tags": [
+    "scope:playground",
+    "type:e2e"
+  ]
+}