@testspectra/cli 1.0.43 → 1.0.45

package/dist/plugin.js

@@ -1,4 +1,23 @@
+import fs from "fs";
+import path from "path";
 import { TypeGenerator } from "./types/generator.js";
+/**
+ * Traverses upwards from `startDir` to locate the TestSpectra workspace root.
+ * Looks for indicators: `spectra.config.ts`, `.testspectra`, `pnpm-workspace.yaml`, or `nx.json`.
+ */
+function findWorkspaceRoot(startDir) {
+    let cur = path.resolve(startDir);
+    while (cur !== path.dirname(cur)) {
+        if (fs.existsSync(path.join(cur, "spectra.config.ts")) ||
+            fs.existsSync(path.join(cur, ".testspectra")) ||
+            fs.existsSync(path.join(cur, "pnpm-workspace.yaml")) ||
+            fs.existsSync(path.join(cur, "nx.json"))) {
+            return cur;
+        }
+        cur = path.dirname(cur);
+    }
+    return startDir;
+}
 /**
  * TypeScript Language Service Plugin Factory for TestSpectra.
  * Runs silently inside TSServer (VS Code, Cursor, WebStorm, Neovim, etc.).
@@ -11,31 +30,74 @@ function init(modules) {
     function create(info) {
         const project = info.project;
         const projectDir = project.getCurrentDirectory();
+        const workspaceRoot = findWorkspaceRoot(projectDir);
+        const log = (msg) => {
+            try {
+                info.project.projectService.logger.info(`[TestSpectra TS Plugin] ${msg}`);
+            }
+            catch { }
+        };
         // 1. Initial Generation on project load
         try {
-            TypeGenerator.writeDeclarationFiles(projectDir);
-            info.project.projectService.logger.info(`[TestSpectra TS Plugin] Initialized ambient declarations in ${projectDir}`);
+            TypeGenerator.writeDeclarationFiles(workspaceRoot);
+            log(`Initialized ambient declarations in workspace root: ${workspaceRoot}`);
         }
         catch (err) {
-            info.project.projectService.logger.info(`[TestSpectra TS Plugin] Failed initial type generation: ${err?.message}`);
+            log(`Failed initial type generation: ${err?.message}`);
         }
-        // 2. Watch for entity file changes inside TSServer
-        const watchedFolders = ["page-objects", "pageobjects", "actions", "steps", "fixtures", "hooks"];
-        // Debounce type regeneration
+        // Debounced regeneration handler
         let debounceTimer = null;
-        const triggerRegeneration = (pathChanged) => {
-            if (debounceTimer)
-                clearTimeout(debounceTimer);
-            debounceTimer = setTimeout(() => {
+        const triggerRegeneration = (reason, sync = false) => {
+            const doRegen = () => {
                 try {
-                    TypeGenerator.writeDeclarationFiles(projectDir);
-                    info.project.projectService.logger.info(`[TestSpectra TS Plugin] Regenerated ambient declarations after change in ${pathChanged}`);
+                    TypeGenerator.writeDeclarationFiles(workspaceRoot);
+                    log(`Regenerated ambient declarations (${reason})`);
                 }
                 catch (err) {
-                    info.project.projectService.logger.info(`[TestSpectra TS Plugin] Error during regeneration: ${err?.message}`);
+                    log(`Error during regeneration: ${err?.message}`);
                 }
-            }, 200);
+            };
+            if (sync) {
+                doRegen();
+            }
+            else {
+                if (debounceTimer)
+                    clearTimeout(debounceTimer);
+                debounceTimer = setTimeout(doRegen, 80);
+            }
         };
+        // 2. Active File System Watcher on the entire workspace
+        try {
+            if (fs.existsSync(workspaceRoot)) {
+                const watcher = fs.watch(workspaceRoot, { recursive: true }, (eventType, filename) => {
+                    if (!filename)
+                        return;
+                    const fn = filename.toString();
+                    // Skip internal and build directories
+                    if (fn.includes(".testspectra") ||
+                        fn.includes("node_modules") ||
+                        fn.includes(".git") ||
+                        fn.includes("dist") ||
+                        fn.includes(".nx")) {
+                        return;
+                    }
+                    // Match relevant entity files
+                    if (fn.includes("fixtures") ||
+                        fn.includes("page-objects") ||
+                        fn.includes("pageobjects") ||
+                        fn.includes("actions") ||
+                        fn.includes("steps") ||
+                        fn.includes("hooks") ||
+                        fn.includes("spectra.config")) {
+                        triggerRegeneration(`fs.watch '${eventType}' on ${fn}`);
+                    }
+                });
+                watcher.on("error", () => { });
+            }
+        }
+        catch (err) {
+            log(`Note: Recursive fs.watch not supported or failed: ${err?.message}`);
+        }
         // 3. Proxy language service methods to detect file modifications / completions
         const proxy = Object.create(null);
         for (const k of Object.keys(info.languageService)) {
@@ -46,9 +108,9 @@ function init(modules) {
         // Intercept getCompletionsAtPosition to ensure fresh types
         const originalGetCompletions = info.languageService.getCompletionsAtPosition;
         proxy.getCompletionsAtPosition = (fileName, position, options, formattingSettings) => {
-            const isEntity = watchedFolders.some((f) => fileName.includes(f));
-            if (isEntity) {
-                triggerRegeneration(fileName);
+            const ext = path.extname(fileName);
+            if (ext === ".ts" || ext === ".tsx" || ext === ".js" || ext === ".mjs") {
+                triggerRegeneration(`completions at ${path.basename(fileName)}`, false);
             }
             return originalGetCompletions.apply(info.languageService, [
                 fileName,
@@ -57,6 +119,11 @@ function init(modules) {
                 formattingSettings,
             ]);
         };
+        // Intercept getQuickInfoAtPosition for fresh hover info
+        const originalGetQuickInfo = info.languageService.getQuickInfoAtPosition;
+        proxy.getQuickInfoAtPosition = (fileName, position) => {
+            return originalGetQuickInfo.apply(info.languageService, [fileName, position]);
+        };
         return proxy;
     }
     return { create };

package/dist/types/generator.js

@@ -191,26 +191,6 @@ export class TypeGenerator {
                 }
             }
             // 2. Built-in Spectra Static Methods & Custom Actions
-            content += `\ninterface SpectraStaticInstance {\n`;
-            content += `  get(target: any): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  getAll(selector: string): import('@testspectra/matchers').MultiElementRunner;\n`;
-            content += `  navigate(url: string): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  back(): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  refresh(): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  click(target: any, textOrOptions?: string | import('@testspectra/matchers').ClickOptions): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  doubleClick(target: any, textOrOptions?: string | import('@testspectra/matchers').ClickOptions): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  longPress(target: any, options?: import('@testspectra/matchers').LongPressOptions | number): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  type(target: any, value: string, options?: import('@testspectra/matchers').TypeOptions): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  clear(target: any): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  select(target: any, value: string): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  hover(target: any): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  pressKey(key: import('@testspectra/matchers').KeyOption | string): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  dragDrop(sourceTarget: any, destTarget: any): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  scroll(options?: import('@testspectra/matchers').ScrollOptions): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  swipe(options: import('@testspectra/matchers').SwipeOptions): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  wait(durationMs: number): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `  waitForElement(target: any, timeoutMs?: number): import('@testspectra/matchers').SingleElementRunner;\n`;
-            content += `}\n\n`;
             content += `interface TestSpectraCustomActions {\n`;
             const declaredActions = new Set();
             for (const actionsDir of actionsDirs) {
@@ -262,7 +242,7 @@ export class TypeGenerator {
                 }
             }
             content += `}\n`;
-            content += `type TestSpectraActions = SpectraStaticInstance & TestSpectraCustomActions;\n`;
+            content += `type TestSpectraActions = import('@testspectra/matchers').SpectraStatic & TestSpectraCustomActions;\n`;
             content += `declare const Spectra: TestSpectraActions;\n\n`;
             // 3. Built-in Steps Declaration
             content += `interface TestSpectraSteps {\n`;
@@ -327,20 +307,31 @@ export class TypeGenerator {
         content += `// Managed automatically by TestSpectra Language Service Plugin.\n\n`;
         content += `interface TestSpectraFixtures {\n`;
         const declaredFixtures = new Set();
-        for (const fixturesDir of fixturesDirs) {
-            if (!fs.existsSync(fixturesDir))
-                continue;
-            const fixtureFiles = fs.readdirSync(fixturesDir);
-            for (const file of fixtureFiles) {
-                if (file.startsWith("."))
-                    continue;
-                const parsed = path.parse(file);
-                const varName = parsed.name.replace(/[^a-zA-Z0-9_$]/g, "_");
-                if (declaredFixtures.has(varName))
-                    continue;
-                content += `  readonly ${varName}: string;\n`;
-                declaredFixtures.add(varName);
+        function scanFixtureDir(dir) {
+            if (!fs.existsSync(dir))
+                return;
+            try {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.name.startsWith("."))
+                        continue;
+                    if (entry.isDirectory()) {
+                        scanFixtureDir(path.join(dir, entry.name));
+                    }
+                    else if (entry.isFile()) {
+                        const parsed = path.parse(entry.name);
+                        const varName = parsed.name.replace(/[^a-zA-Z0-9_$]/g, "_");
+                        if (declaredFixtures.has(varName))
+                            continue;
+                        content += `  readonly ${varName}: string;\n`;
+                        declaredFixtures.add(varName);
+                    }
+                }
             }
+            catch { }
+        }
+        for (const fixturesDir of fixturesDirs) {
+            scanFixtureDir(fixturesDir);
         }
         content += `}\n`;
         content += `declare const Fixture: TestSpectraFixtures;\n`;

package/package.json

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

package/templates/default/package.json

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

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

@@ -7,7 +7,10 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"],
+    "plugins": [
+      { "name": "@testspectra/cli" }
+    ]
   },
   "include": [
     ".testspectra/types/android.d.ts",

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

@@ -7,7 +7,10 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"],
+    "plugins": [
+      { "name": "@testspectra/cli" }
+    ]
   },
   "include": [
     ".testspectra/types/ios.d.ts",

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

@@ -7,7 +7,10 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"],
+    "plugins": [
+      { "name": "@testspectra/cli" }
+    ]
   },
   "include": [
     ".testspectra/types/web.d.ts",

package/templates/nx/package.json

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

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

@@ -7,7 +7,10 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"],
+    "plugins": [
+      { "name": "@testspectra/cli" }
+    ]
   },
   "include": [
     ".testspectra/types/android.d.ts",

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

@@ -7,7 +7,10 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"],
+    "plugins": [
+      { "name": "@testspectra/cli" }
+    ]
   },
   "include": [
     ".testspectra/types/ios.d.ts",

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

@@ -7,7 +7,10 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"],
+    "plugins": [
+      { "name": "@testspectra/cli" }
+    ]
   },
   "include": [
     ".testspectra/types/shared/common.d.ts",

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

@@ -7,7 +7,10 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"]
+    "types": ["node", "@wdio/globals/types", "@wdio/mocha-framework"],
+    "plugins": [
+      { "name": "@testspectra/cli" }
+    ]
   },
   "include": [
     ".testspectra/types/web.d.ts",