@testspectra/cli 1.0.70 → 1.1.0-rc.1

package/dist/step/runner/single.js

@@ -1,138 +0,0 @@
-import { executeSingleMatcher, resolveElement } from "../matchers.js";
-export class SingleElementRunner {
-    _target;
-    _action = null;
-    _assertions = [];
-    constructor(target, action) {
-        this._target = target;
-        this._action = action || null;
-    }
-    // --- Chained Actions on current target ---
-    click() {
-        const target = this.requireTarget("click");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            await el.click();
-        };
-        return this;
-    }
-    doubleClick() {
-        const target = this.requireTarget("doubleClick");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            await el.doubleClick();
-        };
-        return this;
-    }
-    longPress(durationMs = 1000) {
-        const target = this.requireTarget("longPress");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            if (typeof el.touchAction === "function") {
-                await el.touchAction([
-                    { action: "longPress", ms: durationMs },
-                    { action: "release" },
-                ]);
-            }
-            else {
-                await el.click();
-            }
-        };
-        return this;
-    }
-    type(value, options) {
-        const target = this.requireTarget("type");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            if (options?.clearFirst) {
-                await el.clearValue();
-            }
-            await el.setValue(value);
-        };
-        return this;
-    }
-    clear() {
-        const target = this.requireTarget("clear");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            await el.clearValue();
-        };
-        return this;
-    }
-    select(value) {
-        const target = this.requireTarget("select");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            await el.selectByVisibleText(value);
-        };
-        return this;
-    }
-    hover() {
-        const target = this.requireTarget("hover");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            await el.moveTo();
-        };
-        return this;
-    }
-    waitForElement(timeoutMs = 10000) {
-        const target = this.requireTarget("waitForElement");
-        this._action = async () => {
-            const el = await resolveElement(target);
-            await el.waitForDisplayed({ timeout: timeoutMs });
-        };
-        return this;
-    }
-    should(a, b, ...rest) {
-        const isFirstArgMatcher = typeof a === "string" &&
-            (a.includes(".") ||
-                a.includes("exist") ||
-                a.includes("visible") ||
-                a.includes("enabled") ||
-                a.includes("disabled") ||
-                a.includes("selected") ||
-                a.includes("checked"));
-        if (b !== undefined && !isFirstArgMatcher) {
-            // Form: should(target, matcher, ...args)
-            this._assertions.push({
-                target: a,
-                matcher: b,
-                args: rest,
-            });
-        }
-        else {
-            // Form: should(matcher, ...args) -> on current target
-            this._assertions.push({
-                target: this._target,
-                matcher: a,
-                args: b !== undefined ? [b, ...rest] : rest,
-            });
-        }
-        return this;
-    }
-    // --- Execution when awaited ---
-    async then(onfulfilled, onrejected) {
-        try {
-            if (this._action) {
-                await this._action();
-            }
-            for (const assert of this._assertions) {
-                await executeSingleMatcher(assert.target, assert.matcher, assert.args);
-            }
-            const res = (onfulfilled ? await onfulfilled() : undefined);
-            return res;
-        }
-        catch (err) {
-            if (onrejected) {
-                return onrejected(err);
-            }
-            throw err;
-        }
-    }
-    requireTarget(actionName) {
-        if (!this._target) {
-            throw new Error(`Cannot execute '${actionName}' without specifying an element target.`);
-        }
-        return this._target;
-    }
-}

package/dist/step/spectra.d.ts

@@ -1,34 +0,0 @@
-import { ClickOptions, ElementTarget, KeyOption, LongPressOptions, ScrollOptions, SwipeOptions, TypeOptions } from "./types.js";
-import { SingleElementRunner } from "./runner/single.js";
-import { MultiElementRunner } from "./runner/collection.js";
-/**
- * Main Spectra testing API orchestrator.
- * Combines direct actions, single element queries (get), and collections (getAll).
- */
-export declare class SpectraStatic {
-    /**
-     * Targets a single element by selector or Page Object element.
-     */
-    get(target: ElementTarget): SingleElementRunner;
-    /**
-     * Targets multiple elements / collections by selector.
-     */
-    getAll(selector: string): MultiElementRunner;
-    navigate(url: string): SingleElementRunner;
-    back(): SingleElementRunner;
-    refresh(): SingleElementRunner;
-    click(target: ElementTarget, textOrOptions?: string | ClickOptions): SingleElementRunner;
-    doubleClick(target: ElementTarget, textOrOptions?: string | ClickOptions): SingleElementRunner;
-    longPress(target: ElementTarget, options?: LongPressOptions | number): SingleElementRunner;
-    type(target: ElementTarget, value: string, options?: TypeOptions): SingleElementRunner;
-    clear(target: ElementTarget): SingleElementRunner;
-    select(target: ElementTarget, value: string): SingleElementRunner;
-    hover(target: ElementTarget): SingleElementRunner;
-    pressKey(key: KeyOption | string): SingleElementRunner;
-    dragDrop(sourceTarget: ElementTarget, destTarget: ElementTarget): SingleElementRunner;
-    scroll(options?: ScrollOptions): SingleElementRunner;
-    swipe(options: SwipeOptions): SingleElementRunner;
-    wait(durationMs: number): SingleElementRunner;
-    waitForElement(target: ElementTarget, timeoutMs?: number): SingleElementRunner;
-}
-export declare const Spectra: SpectraStatic;

package/dist/step/spectra.js

@@ -1,156 +0,0 @@
-import { SingleElementRunner } from "./runner/single.js";
-import { MultiElementRunner } from "./runner/collection.js";
-import { resolveElement } from "./matchers.js";
-/**
- * Main Spectra testing API orchestrator.
- * Combines direct actions, single element queries (get), and collections (getAll).
- */
-export class SpectraStatic {
-    /**
-     * Targets a single element by selector or Page Object element.
-     */
-    get(target) {
-        return new SingleElementRunner(target);
-    }
-    /**
-     * Targets multiple elements / collections by selector.
-     */
-    getAll(selector) {
-        return new MultiElementRunner(selector);
-    }
-    // --- Browser & Navigation Actions ---
-    navigate(url) {
-        return new SingleElementRunner(undefined, async () => {
-            await browser.url(url);
-        });
-    }
-    back() {
-        return new SingleElementRunner(undefined, async () => {
-            await browser.back();
-        });
-    }
-    refresh() {
-        return new SingleElementRunner(undefined, async () => {
-            await browser.refresh();
-        });
-    }
-    // --- Direct Interaction Actions ---
-    click(target, textOrOptions) {
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            await el.click();
-        });
-    }
-    doubleClick(target, textOrOptions) {
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            await el.doubleClick();
-        });
-    }
-    longPress(target, options) {
-        const duration = typeof options === "number" ? options : options?.duration || 1000;
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            if (typeof el.touchAction === "function") {
-                await el.touchAction([
-                    { action: "longPress", ms: duration },
-                    { action: "release" },
-                ]);
-            }
-            else {
-                await el.click();
-            }
-        });
-    }
-    type(target, value, options) {
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            if (options?.clearFirst) {
-                await el.clearValue();
-            }
-            await el.setValue(value);
-        });
-    }
-    clear(target) {
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            await el.clearValue();
-        });
-    }
-    select(target, value) {
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            await el.selectByVisibleText(value);
-        });
-    }
-    hover(target) {
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            await el.moveTo();
-        });
-    }
-    pressKey(key) {
-        return new SingleElementRunner(undefined, async () => {
-            await browser.keys(key);
-        });
-    }
-    dragDrop(sourceTarget, destTarget) {
-        return new SingleElementRunner(sourceTarget, async () => {
-            const source = await resolveElement(sourceTarget);
-            const target = await resolveElement(destTarget);
-            await source.dragAndDrop(target);
-        });
-    }
-    // --- Gesture Actions ---
-    scroll(options) {
-        return new SingleElementRunner(options?.selector, async () => {
-            if (options?.selector) {
-                const el = await resolveElement(options.selector);
-                await el.scrollIntoView();
-            }
-            else {
-                await browser.execute((direction, pixels) => {
-                    const delta = pixels || 500;
-                    window.scrollBy({
-                        top: direction === "up" ? -delta : direction === "down" ? delta : 0,
-                        left: direction === "left" ? -delta : direction === "right" ? delta : 0,
-                        behavior: "smooth",
-                    });
-                }, options?.direction || "down", options?.pixels || 500);
-            }
-        });
-    }
-    swipe(options) {
-        return new SingleElementRunner(options.selector, async () => {
-            if (typeof browser.touchAction === "function") {
-                const distance = options.distance || 300;
-                await browser.touchAction([
-                    { action: "press", x: 200, y: 500 },
-                    {
-                        action: "moveTo",
-                        x: options.direction === "right" ? 200 + distance : options.direction === "left" ? 200 - distance : 200,
-                        y: options.direction === "down" ? 500 + distance : options.direction === "up" ? 500 - distance : 500,
-                    },
-                    { action: "release" },
-                ]);
-            }
-            else {
-                // Fallback to web scroll
-                await this.scroll({ direction: options.direction, pixels: options.distance });
-            }
-        });
-    }
-    // --- Timing Actions ---
-    wait(durationMs) {
-        return new SingleElementRunner(undefined, async () => {
-            await browser.pause(durationMs);
-        });
-    }
-    waitForElement(target, timeoutMs = 10000) {
-        return new SingleElementRunner(target, async () => {
-            const el = await resolveElement(target);
-            await el.waitForDisplayed({ timeout: timeoutMs });
-        });
-    }
-}
-export const Spectra = new SpectraStatic();

package/dist/step/types.d.ts

@@ -1,32 +0,0 @@
-/**
- * Database Canonical Action and Assertion Types
- * Matches backend/src/models/test_step.rs
- */
-export type ActionKey = "navigate" | "click" | "type" | "clear" | "select" | "scroll" | "swipe" | "wait" | "waitForElement" | "pressKey" | "longPress" | "doubleClick" | "hover" | "dragDrop" | "back" | "refresh";
-export type AssertionKey = "elementDisplayed" | "elementNotDisplayed" | "elementExists" | "elementEnabled" | "elementDisabled" | "textContains" | "textEquals" | "textNotContains" | "urlContains" | "urlEquals" | "valueEquals" | "valueContains" | "attributeEquals" | "attributeContains" | "hasClass" | "hasAttribute" | "isSelected" | "elementCount" | "elementCountGreaterThan" | "pageLoaded" | "noErrors";
-export type KeyOption = "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Space";
-export type Direction = "up" | "down" | "left" | "right";
-export type ElementTarget = string | WebdriverIO.Element | ChainablePromiseElement;
-export interface ScrollOptions {
-    direction?: Direction;
-    pixels?: number;
-    selector?: ElementTarget;
-}
-export interface SwipeOptions {
-    direction: Direction;
-    distance?: number;
-    selector?: ElementTarget;
-}
-export interface LongPressOptions {
-    text?: string;
-    duration?: number;
-}
-export interface ClickOptions {
-    text?: string;
-    clickType?: "single" | "double";
-}
-export interface TypeOptions {
-    clearFirst?: boolean;
-}
-export type SingleElementMatcher = "be.visible" | "not.be.visible" | "exist" | "not.exist" | "be.enabled" | "be.disabled" | "be.checked" | "be.selected" | "have.value" | "contain.value" | "have.text" | "contain.text" | "have.class" | "have.attr" | "have.url" | "contain.url" | "have.title" | "contain.title";
-export type MultiElementMatcher = "have.length" | "have.length.greaterThan" | "be.empty" | "exist";

package/dist/step/types.js

@@ -1,5 +0,0 @@
-/**
- * Database Canonical Action and Assertion Types
- * Matches backend/src/models/test_step.rs
- */
-export {};

package/templates/default/specs/ContentMatchers/TC-0005-text-and-values/mobile.test.ts

@@ -1,3 +0,0 @@
-it("should verify text on Mobile", async () => {
-  await MatchersPage.open("text");
-});

package/templates/default/specs/ContentMatchers/TC-0005-text-and-values/web.test.ts

@@ -1,7 +0,0 @@
-it("should verify text and value matchers on Web", async () => {
-  await MatchersPage.open("text");
-  await MatchersPage.exactText.should("have.text", Fixture.playgroundData.welcomeText);
-  await MatchersPage.partialText.should("contain.text", "Welcome");
-  await MatchersPage.emailInput.should("have.value", Fixture.playgroundData.defaultEmail);
-  await MatchersPage.tokenInput.should("contain.value", "JWT_");
-});

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

@@ -1,46 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "composite": true,
-    "noEmit": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "types": [
-      "node",
-      "@wdio/globals/types",
-      "@wdio/mocha-framework"
-    ]
-  },
-  "include": [
-    ".testspectra/types/android.d.ts",
-    ".testspectra/types/fixtures.d.ts",
-    "page-objects/**/*.ts",
-    "support/**/*.ts",
-    "steps/**/*.ts",
-    "actions/**/*.ts",
-    "global-hooks/**/*.ts",
-    "specs/**/hooks/**/*.ts",
-    "specs/**/*.ts",
-    "spectra.config.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist",
-    "page-objects/**/web.ts",
-    "page-objects/**/ios.ts",
-    "support/**/web.*",
-    "support/**/ios.*",
-    "steps/**/web.step.ts",
-    "steps/**/ios.step.ts",
-    "actions/**/web.action.ts",
-    "actions/**/ios.action.ts",
-    "global-hooks/**/web.*",
-    "global-hooks/**/ios.*",
-    "specs/**/hooks/**/web.*",
-    "specs/**/hooks/**/ios.*",
-    "specs/**/web.test.ts",
-    "specs/**/ios.test.ts"
-  ]
-}

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

@@ -1,46 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "composite": true,
-    "noEmit": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "types": [
-      "node",
-      "@wdio/globals/types",
-      "@wdio/mocha-framework"
-    ]
-  },
-  "include": [
-    ".testspectra/types/ios.d.ts",
-    ".testspectra/types/fixtures.d.ts",
-    "page-objects/**/*.ts",
-    "support/**/*.ts",
-    "steps/**/*.ts",
-    "actions/**/*.ts",
-    "global-hooks/**/*.ts",
-    "specs/**/hooks/**/*.ts",
-    "specs/**/*.ts",
-    "spectra.config.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist",
-    "page-objects/**/web.ts",
-    "page-objects/**/android.ts",
-    "support/**/web.*",
-    "support/**/android.*",
-    "steps/**/web.step.ts",
-    "steps/**/android.step.ts",
-    "actions/**/web.action.ts",
-    "actions/**/android.action.ts",
-    "global-hooks/**/web.*",
-    "global-hooks/**/android.*",
-    "specs/**/hooks/**/web.*",
-    "specs/**/hooks/**/android.*",
-    "specs/**/web.test.ts",
-    "specs/**/android.test.ts"
-  ]
-}

package/templates/default/tsconfig.spectra.json

@@ -1,22 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "skipLibCheck": true,
-    "strict": true,
-    "noEmit": true
-  },
-  "files": [],
-  "references": [
-    {
-      "path": "./tsconfig.spectra.web.json"
-    },
-    {
-      "path": "./tsconfig.spectra.android.json"
-    },
-    {
-      "path": "./tsconfig.spectra.ios.json"
-    }
-  ]
-}

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

@@ -1,53 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "composite": true,
-    "noEmit": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "types": [
-      "node",
-      "@wdio/globals/types",
-      "@wdio/mocha-framework"
-    ]
-  },
-  "include": [
-    ".testspectra/types/web.d.ts",
-    ".testspectra/types/fixtures.d.ts",
-    "page-objects/**/*.ts",
-    "support/**/*.ts",
-    "steps/**/*.ts",
-    "actions/**/*.ts",
-    "global-hooks/**/*.ts",
-    "specs/**/hooks/**/*.ts",
-    "specs/**/*.ts",
-    "spectra.config.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist",
-    "page-objects/**/android.ts",
-    "page-objects/**/ios.ts",
-    "page-objects/**/mobile.ts",
-    "support/**/android.*",
-    "support/**/ios.*",
-    "support/**/mobile.*",
-    "steps/**/android.step.ts",
-    "steps/**/ios.step.ts",
-    "steps/**/mobile.step.ts",
-    "actions/**/android.action.ts",
-    "actions/**/ios.action.ts",
-    "actions/**/mobile.action.ts",
-    "global-hooks/**/android.*",
-    "global-hooks/**/ios.*",
-    "global-hooks/**/mobile.*",
-    "specs/**/hooks/**/android.*",
-    "specs/**/hooks/**/ios.*",
-    "specs/**/hooks/**/mobile.*",
-    "specs/**/android.test.ts",
-    "specs/**/ios.test.ts",
-    "specs/**/mobile.test.ts"
-  ]
-}

package/templates/nx/fixtures/playgroundData.json

@@ -1,7 +0,0 @@
-{
-  "defaultEmail": "admin@testspectra.dev",
-  "defaultToken": "JWT_abc123xyz",
-  "pageTitle": "TestSpectra — Matchers API Reference",
-  "welcomeText": "Welcome to TestSpectra",
-  "dashboardHref": "/dashboard"
-}

package/templates/nx/global-hooks/after/mobile.hook.ts

@@ -1,3 +0,0 @@
-export default async function () {
-  // Global mobile teardown
-}

package/templates/nx/global-hooks/after/web.hook.ts

@@ -1,3 +0,0 @@
-export default async function () {
-  // Global web teardown
-}

package/templates/nx/global-hooks/before/mobile.hook.ts

@@ -1,3 +0,0 @@
-export default async function () {
-  // Global mobile initialization
-}

package/templates/nx/global-hooks/before/web.hook.ts

@@ -1,3 +0,0 @@
-export default async function () {
-  // Global web initialization
-}

package/templates/nx/page-objects/MatchersPage/mobile.ts

@@ -1,21 +0,0 @@
-export class MatchersPage {
-  get visibleElement() { return Spectra.get("~visible_element"); }
-  get hiddenElement() { return Spectra.get("~hidden_element"); }
-  get existingElement() { return Spectra.get("~existing_element"); }
-  get submitButton() { return Spectra.get("~submit_button"); }
-  get disabledButton() { return Spectra.get("~disabled_button"); }
-  get checkbox() { return Spectra.get("~checkbox"); }
-  get radio() { return Spectra.get("~radio"); }
-  get emailInput() { return Spectra.get("~email_input"); }
-  get tokenInput() { return Spectra.get("~token_input"); }
-  get exactText() { return Spectra.get("~exact_text"); }
-  get partialText() { return Spectra.get("~partial_text"); }
-  get activeTab() { return Spectra.get("~active_tab"); }
-  get navLink() { return Spectra.get("~nav_link"); }
-  get productCards() { return Spectra.getAll("~product_card"); }
-  get emptyList() { return Spectra.getAll("~empty_list"); }
-
-  async open(_section = "") {}
-}
-
-export default new MatchersPage();

package/templates/nx/page-objects/MatchersPage/web.ts

@@ -1,23 +0,0 @@
-export class MatchersPage {
-  get visibleElement() { return Spectra.get("#demo-visible-el"); }
-  get hiddenElement() { return Spectra.get("#demo-hidden-el"); }
-  get existingElement() { return Spectra.get("#demo-existing-el"); }
-  get submitButton() { return Spectra.get("#demo-submit-btn"); }
-  get disabledButton() { return Spectra.get("#demo-disabled-btn"); }
-  get checkbox() { return Spectra.get("#demo-checkbox"); }
-  get radio() { return Spectra.get("#demo-radio"); }
-  get emailInput() { return Spectra.get("#demo-email-input"); }
-  get tokenInput() { return Spectra.get("#demo-token-input"); }
-  get exactText() { return Spectra.get("#demo-exact-text"); }
-  get partialText() { return Spectra.get("#demo-partial-text"); }
-  get activeTab() { return Spectra.get("#demo-active-tab"); }
-  get navLink() { return Spectra.get("#demo-nav-link"); }
-  get productCards() { return Spectra.getAll(".demo-product-card"); }
-  get emptyList() { return Spectra.getAll("#demo-empty-list > *"); }
-
-  async open(section = "") {
-    await browser.url("/" + (section ? "#" + section : ""));
-  }
-}
-
-export default new MatchersPage();

package/templates/nx/page-objects/NavigationPage/mobile.ts

@@ -1,5 +0,0 @@
-export class NavigationPage {
-  get sidebarLinks() { return Spectra.getAll("~sidebar_link"); }
-}
-
-export default new NavigationPage();

package/templates/nx/page-objects/NavigationPage/web.ts

@@ -1,8 +0,0 @@
-export class NavigationPage {
-  get sidebarLinks() { return Spectra.getAll("aside a"); }
-  get overviewLink() { return Spectra.get("aside a[href='#overview']"); }
-  get visibilityLink() { return Spectra.get("aside a[href='#visibility']"); }
-  get playgroundLink() { return Spectra.get("aside a[href='#playground']"); }
-}
-
-export default new NavigationPage();

package/templates/nx/page-objects/PlaygroundPage/mobile.ts

@@ -1,26 +0,0 @@
-export class PlaygroundPage {
-  get visibleElement() { return Spectra.get("~visible_element"); }
-  get hiddenElement() { return Spectra.get("~hidden_element"); }
-  get existingElement() { return Spectra.get("~existing_element"); }
-  get removedElement() { return Spectra.get("~removed_element"); }
-  get enabledButton() { return Spectra.get("~enabled_button"); }
-  get disabledButton() { return Spectra.get("~disabled_button"); }
-  get termsCheckbox() { return Spectra.get("~terms_checkbox"); }
-  get modeRadio() { return Spectra.get("~mode_radio"); }
-  get emailInput() { return Spectra.get("~email_input"); }
-  get tokenInput() { return Spectra.get("~token_input"); }
-  get exactText() { return Spectra.get("~exact_text"); }
-  get partialText() { return Spectra.get("~partial_text"); }
-  get activeTab() { return Spectra.get("~active_tab"); }
-  get navLink() { return Spectra.get("~nav_link"); }
-  get productItems() { return Spectra.getAll("~product_item"); }
-  get emptyList() { return Spectra.getAll("~empty_list"); }
-
-  async open() {}
-  async fillCredentials(email = Fixture.playgroundData.defaultEmail, token = Fixture.playgroundData.defaultToken) {
-    await this.emailInput.type(email);
-    await this.tokenInput.type(token);
-  }
-}
-
-export default new PlaygroundPage();