fair-playwright 1.1.0 → 1.2.0

package/README.md

@@ -1,9 +1,9 @@
 <div align="center">
-  <img src="resources/fair-playwright-logo.png" alt="fair-playwright" width="200" />
+  <img src="resources/fair-playwright-logo.png" alt="fair-playwright" width="500" />
 
-  # fair-playwright
+  #
 
-  > AI-optimized Playwright test reporter with progressive terminal output and hierarchical step management
+AI-optimized Playwright test reporter with progressive terminal output and hierarchical step management
 
   [![npm version](https://img.shields.io/npm/v/fair-playwright.svg)](https://www.npmjs.com/package/fair-playwright)
   [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -39,10 +39,29 @@ export default defineConfig({
 
 ### 2. Write Tests
 
+**Quick Mode** (v1.1.0+) - Compact syntax:
+
 ```typescript
 import { test } from '@playwright/test';
 import { e2e } from 'fair-playwright';
 
+test('user login', async ({ page }) => {
+  await e2e.quick('User login flow', [
+    ['Open login page', async () => {
+      await page.goto('/login');
+    }],
+    ['Submit credentials', async () => {
+      await page.getByLabel('Email').fill('user@example.com');
+      await page.getByLabel('Password').fill('password');
+      await page.getByRole('button', { name: 'Login' }).click();
+    }]
+  ]);
+});
+```
+
+**Declarative Mode** - Full control:
+
+```typescript
 test('user login', async ({ page }) => {
   await e2e.major('User login flow', {
     success: 'User logged in successfully',

package/dist/index.cjs

@@ -925,6 +925,26 @@ var E2EHelperImpl = class {
       }
     });
   }
+  /**
+   * Execute a quick workflow with simplified tuple syntax (v1.1.0+)
+   * Converts compact syntax to declarative mode internally
+   */
+  async quick(title, steps, options) {
+    const stepDefinitions = steps.map((step) => {
+      const [stepTitle, action, stepOptions] = step;
+      return {
+        title: stepTitle,
+        action,
+        success: stepOptions?.success,
+        failure: stepOptions?.failure
+      };
+    });
+    return this.majorDeclarative(title, {
+      success: options?.success,
+      failure: options?.failure,
+      steps: stepDefinitions
+    });
+  }
   /**
    * Inline mode for major steps
    */

package/dist/index.d.cts

@@ -287,6 +287,16 @@ interface MajorStepOptions {
      */
     steps?: StepDefinition[];
 }
+/**
+ * Quick step definition - simplified tuple syntax
+ * [title, action] or [title, action, options]
+ */
+type QuickStepDefinition = [string, () => Promise<void>] | [string, () => Promise<void>, StepOptions];
+/**
+ * Options for quick mode execution
+ */
+interface QuickModeOptions extends StepOptions {
+}
 /**
  * E2E test helper interface
  */
@@ -303,6 +313,22 @@ interface E2EHelper {
      * Execute a minor step
      */
     minor(title: string, action: () => Promise<void>, options?: StepOptions): Promise<void>;
+    /**
+     * Execute a quick workflow with simplified syntax (v1.1.0+)
+     * Compact API for simple test cases
+     *
+     * @param title - Major step title
+     * @param steps - Array of [title, action] or [title, action, options] tuples
+     * @param options - Optional success/failure messages for major step
+     *
+     * @example
+     * await e2e.quick('User login', [
+     *   ['Open page', async () => { await page.goto('/login') }],
+     *   ['Fill form', async () => { await page.fill('#email', 'test@example.com') }],
+     *   ['Submit', async () => { await page.click('button[type="submit"]') }]
+     * ])
+     */
+    quick(title: string, steps: QuickStepDefinition[], options?: QuickModeOptions): Promise<void>;
 }
 
 /**

package/dist/index.d.ts

@@ -287,6 +287,16 @@ interface MajorStepOptions {
      */
     steps?: StepDefinition[];
 }
+/**
+ * Quick step definition - simplified tuple syntax
+ * [title, action] or [title, action, options]
+ */
+type QuickStepDefinition = [string, () => Promise<void>] | [string, () => Promise<void>, StepOptions];
+/**
+ * Options for quick mode execution
+ */
+interface QuickModeOptions extends StepOptions {
+}
 /**
  * E2E test helper interface
  */
@@ -303,6 +313,22 @@ interface E2EHelper {
      * Execute a minor step
      */
     minor(title: string, action: () => Promise<void>, options?: StepOptions): Promise<void>;
+    /**
+     * Execute a quick workflow with simplified syntax (v1.1.0+)
+     * Compact API for simple test cases
+     *
+     * @param title - Major step title
+     * @param steps - Array of [title, action] or [title, action, options] tuples
+     * @param options - Optional success/failure messages for major step
+     *
+     * @example
+     * await e2e.quick('User login', [
+     *   ['Open page', async () => { await page.goto('/login') }],
+     *   ['Fill form', async () => { await page.fill('#email', 'test@example.com') }],
+     *   ['Submit', async () => { await page.click('button[type="submit"]') }]
+     * ])
+     */
+    quick(title: string, steps: QuickStepDefinition[], options?: QuickModeOptions): Promise<void>;
 }
 
 /**

package/dist/index.js

@@ -885,6 +885,26 @@ var E2EHelperImpl = class {
       }
     });
   }
+  /**
+   * Execute a quick workflow with simplified tuple syntax (v1.1.0+)
+   * Converts compact syntax to declarative mode internally
+   */
+  async quick(title, steps, options) {
+    const stepDefinitions = steps.map((step) => {
+      const [stepTitle, action, stepOptions] = step;
+      return {
+        title: stepTitle,
+        action,
+        success: stepOptions?.success,
+        failure: stepOptions?.failure
+      };
+    });
+    return this.majorDeclarative(title, {
+      success: options?.success,
+      failure: options?.failure,
+      steps: stepDefinitions
+    });
+  }
   /**
    * Inline mode for major steps
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fair-playwright",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "AI-optimized Playwright test reporter with progressive terminal output and hierarchical step management",
   "type": "module",
   "main": "./dist/index.js",