flowstride 1.0.17 → 1.0.19

package/dist/adapters/web/playwright.d.ts

@@ -25,6 +25,8 @@ export declare class WebAdapter {
     synthesizeCurl(method: string, url: string, headers: Record<string, string>, postData: string | null): string;
     private checkAmbiguity;
     close(targetText: string): Promise<void>;
+    extractText(selector: string, elementType?: string): Promise<string>;
+    extractValue(selector: string, elementType?: string): Promise<string>;
     click(selector: string, elementType?: string): Promise<void>;
     hover(selector: string, elementType?: string): Promise<void>;
     type(selector: string, value: string, elementType?: string): Promise<void>;
@@ -43,6 +45,7 @@ export declare class WebAdapter {
     expectValue(selector: string, val: string, elementType?: string): Promise<void>;
     expectTranscript(expectedText: string): Promise<void>;
     getAttribute(selector: string, attr: string, elementType?: string): Promise<string | null>;
+    private translateCoordinateSelector;
     private isRawCssSelector;
     private buildHeuristicSelector;
     private getLocator;

package/dist/adapters/web/playwright.js

@@ -62,13 +62,13 @@ class WebAdapter {
             ? [
                 "--use-fake-ui-for-media-stream",
                 "--use-fake-device-for-media-stream",
-                "--disable-blink-features=AutomationControlled", // Cloudflare Mask
+                "--disable-blink-features=AutomationControlled",
             ]
             : [
                 "--window-size=1280,800",
                 "--use-fake-ui-for-media-stream",
                 "--use-fake-device-for-media-stream",
-                "--disable-blink-features=AutomationControlled", // Cloudflare Mask
+                "--disable-blink-features=AutomationControlled",
             ];
         if (audioInjectionPath) {
             launchArgs.push(`--use-file-for-fake-audio-capture=${audioInjectionPath}`);
@@ -390,6 +390,18 @@ class WebAdapter {
         await this.page.mouse.up();
         await this.page.waitForTimeout(300);
     }
+    async extractText(selector, elementType) {
+        const loc = await this.getLocator(selector, elementType, false, false);
+        const targetLoc = await this.checkAmbiguity(loc, selector);
+        await targetLoc.waitFor({ state: "visible" });
+        return (await targetLoc.innerText()) || "";
+    }
+    async extractValue(selector, elementType) {
+        const loc = await this.getLocator(selector, elementType, false, false);
+        const targetLoc = await this.checkAmbiguity(loc, selector);
+        await targetLoc.waitFor({ state: "visible" });
+        return (await targetLoc.inputValue()) || "";
+    }
     async click(selector, elementType) {
         const loc = await this.getLocator(selector, elementType, false, false);
         const targetLoc = await this.checkAmbiguity(loc, selector);
@@ -402,7 +414,6 @@ class WebAdapter {
         const targetLoc = await this.checkAmbiguity(loc, selector);
         await targetLoc.waitFor({ state: "visible" });
         await targetLoc.scrollIntoViewIfNeeded();
-        // 1. Accessibility WAI-ARIA Hack (Focus)
         await targetLoc.focus({ timeout: 3000 }).catch(() => { });
         await targetLoc
             .evaluate((node) => {
@@ -410,21 +421,17 @@ class WebAdapter {
                 node.focus();
         })
             .catch(() => { });
-        // 2. Get Exact Center Coordinates for Physical Move
         let box = null;
         try {
             box = await targetLoc.boundingBox({ timeout: 3000 });
         }
-        catch (e) { } // Catch in case it mutated instantly during focus
+        catch (e) { }
         if (box) {
             const centerX = box.x + box.width / 2;
             const centerY = box.y + box.height / 2;
-            // Physically drag the mouse to the element to satisfy Hover Intent APIs
             await this.page.mouse.move(centerX, centerY, { steps: 5 });
         }
-        // 3. Playwright Native Hover Backup (Caught to prevent mutation crashes)
         await targetLoc.hover({ force: true, timeout: 3000 }).catch(() => { });
-        // 4. The Ultimate Wakeup Call: Synthesize Full Coordinate-Loaded Events
         await targetLoc
             .evaluate((node) => {
             const rect = node.getBoundingClientRect();
@@ -450,11 +457,9 @@ class WebAdapter {
             });
         })
             .catch(() => { });
-        // 5. We perform a programmatic click that won't trigger W3C navigation if handled by React toggles
         await targetLoc
             .click({ delay: 50, force: true, timeout: 3000 })
             .catch(() => { });
-        // 6. The Paint Buffer
         await this.page.waitForTimeout(600);
     }
     async type(selector, value, elementType) {
@@ -902,7 +907,7 @@ class WebAdapter {
                 .replace(/[^\w\s]/g, "")
                 .replace(/\s+/g, " ");
             if (cleanBody.includes(cleanExpected)) {
-                return; // Assertion passed!
+                return;
             }
             await this.page.waitForTimeout(500);
         }
@@ -912,9 +917,32 @@ class WebAdapter {
         const loc = await this.getLocator(selector, elementType, true, true);
         return await loc.first().getAttribute(attr);
     }
+    translateCoordinateSelector(selector) {
+        const cleanSelector = selector.replace(/^['"]|['"]$/g, "").trim();
+        if (!cleanSelector)
+            return null;
+        const parts = cleanSelector.split(/\s+/);
+        const validTags = ["table", "tr", "th", "td"];
+        const isCoordinatePath = parts.every((part) => validTags.some((tag) => part.toLowerCase().startsWith(tag)));
+        if (!isCoordinatePath)
+            return null;
+        let translated = "";
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const match = part.match(/^([a-z]+)(?:\[(\d+)\])?$/i);
+            if (!match)
+                return null;
+            const tag = match[1];
+            const index = match[2] ? ` >> nth=${match[2]}` : "";
+            translated += (i > 0 ? " >> " : "") + tag + index;
+        }
+        return translated;
+    }
     isRawCssSelector(selector) {
         if (/\b(near|above|under|below|leftOf|rightOf|inside|in)\s+['"]/i.test(selector))
             return false;
+        if (selector.includes(">> nth="))
+            return true;
         if (/^[#\.\[]/.test(selector))
             return true;
         if (/^[a-zA-Z0-9]+\s*[\.\#:][a-zA-Z0-9_\-]+/.test(selector))
@@ -954,6 +982,9 @@ class WebAdapter {
             "iframe",
             "img",
             "svg",
+            "tr",
+            "th",
+            "td",
         ];
         if (htmlTags.includes(selector.toLowerCase()))
             return true;
@@ -995,27 +1026,35 @@ class WebAdapter {
         return `:is(${attributes}, ${partialActionable})`;
     }
     async getLocator(rawSelector, elementType, isForceAction = false, isAssertionOrAnchor = false, fuzzy = false) {
-        if (this.isRawCssSelector(rawSelector.trim())) {
-            let loc = this.page.locator(rawSelector);
+        const translatedRaw = this.translateCoordinateSelector(rawSelector);
+        const processingSelector = translatedRaw || rawSelector;
+        if (this.isRawCssSelector(processingSelector.trim())) {
+            let loc = this.page.locator(processingSelector);
             if (!isForceAction)
                 loc = loc.filter({ visible: true });
             return loc;
         }
-        let target = rawSelector;
+        let target = processingSelector;
         let relation = "";
         let anchor = "";
         const spatialRegex = /\b(near|above|under|below|leftOf|rightOf|inside|in)\s+(['"].*?['"])/i;
-        const match = rawSelector.match(spatialRegex);
+        const match = processingSelector.match(spatialRegex);
         if (match) {
-            target = rawSelector.substring(0, match.index).trim();
+            target = processingSelector.substring(0, match.index).trim();
             relation = match[1].toLowerCase();
             anchor = match[2];
         }
+        const translatedTarget = this.translateCoordinateSelector(target);
+        if (translatedTarget) {
+            target = translatedTarget;
+        }
         let arrayIndex = null;
-        const indexMatch = target.match(/\[(\d+)\]/);
-        if (indexMatch) {
-            arrayIndex = parseInt(indexMatch[1], 10);
-            target = target.replace(indexMatch[0], "").trim();
+        if (!translatedTarget) {
+            const indexMatch = target.match(/\[(\d+)\]/);
+            if (indexMatch) {
+                arrayIndex = parseInt(indexMatch[1], 10);
+                target = target.replace(indexMatch[0], "").trim();
+            }
         }
         const targetClean = target.replace(/^['"]|['"]$/g, "");
         const targetIsRaw = this.isRawCssSelector(targetClean);
@@ -1025,10 +1064,12 @@ class WebAdapter {
         let alternativeSelector = "";
         if (relation && anchor) {
             const anchorClean = anchor.replace(/^['"]|['"]$/g, "");
-            const anchorIsRaw = this.isRawCssSelector(anchorClean);
+            const translatedAnchor = this.translateCoordinateSelector(anchorClean);
+            const finalAnchorClean = translatedAnchor || anchorClean;
+            const anchorIsRaw = this.isRawCssSelector(finalAnchorClean);
             const anchorSelector = anchorIsRaw
-                ? anchorClean
-                : this.buildHeuristicSelector(anchorClean, undefined, true, fuzzy);
+                ? finalAnchorClean
+                : this.buildHeuristicSelector(finalAnchorClean, undefined, true, fuzzy);
             const anchorLoc = this.page.locator(anchorSelector).first();
             try {
                 if ((await anchorLoc.count()) > 0) {
@@ -1055,7 +1096,9 @@ class WebAdapter {
                     break;
                 case "inside":
                 case "in":
-                    alternativeSelector = `${anchorSelector}:has-text("${targetClean}")`;
+                    if (!anchorSelector.includes("nth=")) {
+                        alternativeSelector = `${anchorSelector}:has-text("${targetClean}")`;
+                    }
                     finalSelector = `${anchorSelector} >> ${finalSelector}`;
                     break;
             }

package/dist/cli/commands/init.js

@@ -46,17 +46,22 @@ const ora_1 = __importDefault(require("ora"));
 const execAsync = (0, util_1.promisify)(child_process_1.exec);
 async function initAction() {
     const root = process.cwd();
-    const folders = ["flows", "reports", "plugins", "fixtures"];
+    // Added 'manual_flows' to strictly isolate manual test designs
+    const folders = ["flows", "manual_flows", "reports", "plugins", "fixtures"];
     const sampleFlowPath = path.join(root, "flows", "example.flow");
     const fixturesReadmePath = path.join(root, "fixtures", "README.md");
     const gitignorePath = path.join(root, ".gitignore");
-    console.log("\n[Info] Initializing new workspace...");
+    console.log("\n[Info] Initialising new workspace...");
     // 1. Create Directories
     folders.forEach((folder) => {
         const dirPath = path.join(root, folder);
         if (!fs.existsSync(dirPath)) {
             fs.mkdirSync(dirPath);
             console.log(`[OK] Created directory: ${folder}/`);
+            // Securely ensure the manual_flows directory is strictly tracked by Git even when empty
+            if (folder === "manual_flows") {
+                fs.writeFileSync(path.join(dirPath, ".gitkeep"), "");
+            }
         }
         else {
             console.log(`[Info] Directory already exists: ${folder}/`);

package/dist/cli/commands/open.d.ts

@@ -0,0 +1 @@
+export declare function openAction(): Promise<void>;

package/dist/cli/commands/open.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAction = openAction;
+const chalk_1 = __importDefault(require("chalk"));
+const workspace_server_1 = require("../manual_server/workspace_server");
+async function openAction() {
+    console.log(chalk_1.default.cyan("\n🎨 Flowstride: Launching Local Manual Test Design Workspace..."));
+    await (0, workspace_server_1.startManualWorkspaceServer)();
+}

package/dist/cli/index.js

@@ -41,6 +41,7 @@ const commander_1 = require("commander");
 const run_1 = require("./commands/run");
 const report_1 = require("./commands/report");
 const init_1 = require("./commands/init");
+const open_1 = require("./commands/open");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
@@ -53,7 +54,7 @@ const API_BASE = process.env.FLOWSTRIDE_API_URL || "https://cloud.flowstride.io"
 program
     .name("flowstride")
     .description("Flowstride: The Enterprise Flow-First Automation CLI")
-    .version("1.0.17");
+    .version("1.0.19");
 program
     .command("init")
     .description("Initialise a new Flowstride workspace in the current directory")
@@ -374,4 +375,10 @@ program
     .action(async () => {
     await (0, report_1.reportAction)();
 });
+program
+    .command("open")
+    .description("Launch the local manual QA UI Workspace")
+    .action(async () => {
+    await (0, open_1.openAction)();
+});
 program.parse(process.argv);

package/dist/cli/manual_server/workspace_server.d.ts

@@ -0,0 +1 @@
+export declare function startManualWorkspaceServer(): Promise<void>;