cypress-validate 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cypress-validate contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,302 @@
+# cypress-validate
+
+> A **Playwright-style CLI** for Cypress projects — run, open, generate, screenshot, report and more with a single unified command.
+
+[![npm version](https://img.shields.io/npm/v/cypress-validate.svg)](https://www.npmjs.com/package/cypress-validate)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D14-brightgreen.svg)](https://nodejs.org)
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# Run once without installing
+npx cypress-validate --help
+
+# Or install globally
+npm install -g cypress-validate
+cypress-validate --help
+```
+
+---
+
+## 📋 Command Reference
+
+### `run` — Run tests headlessly *(like `npx playwright test`)*
+
+```bash
+npx cypress-validate run [options]
+```
+
+| Flag | Playwright Equivalent | Description |
+|---|---|---|
+| `--spec <pattern>` | `playwright test file.spec.ts` | Spec file(s) to run |
+| `--browser <name>` | `--project=chromium` | Browser: `chrome`, `firefox`, `edge`, `electron` |
+| `--headed` | `--headed` | Run with visible browser window |
+| `--grep <pattern>` | `--grep "pattern"` | Filter tests by title/pattern |
+| `--workers <n>` | `--workers=4` | Parallel worker count (Cypress Cloud) |
+| `--timeout <ms>` | `--timeout=10000` | Default timeout per test |
+| `--retry <count>` | `--retries=2` | Number of retries on failure |
+| `--reporter <name>` | `--reporter=html` | Reporter: `spec`, `mochawesome`, `json`, `junit` |
+| `--last-failed` | `--last-failed` | Re-run only specs that failed last time |
+| `--forbid-only` | `--forbid-only` | Fail if `.only()` is used in any test |
+| `--record` | *(cloud)* | Record run to Cypress Cloud |
+| `--key <key>` | *(cloud)* | Cypress Cloud record key |
+| `--env <k=v>` | *(env vars)* | Set Cypress environment variables |
+| `--config <json>` | *(config override)* | Override cypress.config.js values |
+
+**Examples:**
+
+```bash
+# Run all tests
+npx cypress-validate run
+
+# Run specific spec file
+npx cypress-validate run --spec cypress/e2e/login.cy.js
+
+# Run in Chrome, headed, retry twice
+npx cypress-validate run --browser chrome --headed --retry 2
+
+# Filter tests by name
+npx cypress-validate run --grep "should login"
+
+# Run with HTML report
+npx cypress-validate run --reporter mochawesome
+
+# Re-run only failed tests from last run
+npx cypress-validate run --last-failed
+
+# Run all tests and forbid .only()
+npx cypress-validate run --forbid-only
+```
+
+---
+
+### `open` — Interactive Test Runner *(like `npx playwright test --ui`)*
+
+```bash
+npx cypress-validate open [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--browser <name>` | Browser to open |
+| `--spec <pattern>` | Open directly to a specific spec |
+
+```bash
+npx cypress-validate open
+npx cypress-validate open --browser chrome
+npx cypress-validate open --spec cypress/e2e/login.cy.js
+```
+
+---
+
+### `install` — Install Cypress *(like `npx playwright install`)*
+
+```bash
+npx cypress-validate install [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--version <ver>` | Install a specific Cypress version |
+| `--global` | Install globally (`-g`) |
+| `--force` | Force reinstall even if already installed |
+
+```bash
+npx cypress-validate install
+npx cypress-validate install --version 13.6.0
+npx cypress-validate install --force
+```
+
+---
+
+### `verify` — Verify installation *(like `npx playwright install --verify`)*
+
+```bash
+npx cypress-validate verify [--force]
+```
+
+---
+
+### `info` — Print system info *(like `npx playwright --version` + system info)*
+
+```bash
+npx cypress-validate info
+```
+
+Displays: Node.js version, OS, Cypress version, available browsers.
+
+---
+
+### `generate` — Scaffold test files *(like `npx playwright codegen`)*
+
+```bash
+npx cypress-validate generate [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--name <name>` | File name (without extension) |
+| `--type <type>` | `spec` \| `fixture` \| `command` \| `page` |
+| `--url <url>` | Base URL to include in the spec |
+| `--typescript` | Generate `.cy.ts` TypeScript files |
+| `--dir <dir>` | Custom output directory |
+
+```bash
+# Interactive (prompts wizard)
+npx cypress-validate generate
+
+# Non-interactive
+npx cypress-validate generate --name login --type spec --url http://localhost:3000
+npx cypress-validate generate --name user --type fixture
+npx cypress-validate generate --name auth --type command
+npx cypress-validate generate --name dashboard --type page
+```
+
+Generated file types:
+
+| Type | Output path |
+|---|---|
+| `spec` | `cypress/e2e/<name>.cy.js` |
+| `fixture` | `cypress/fixtures/<name>.json` |
+| `command` | `cypress/support/commands/<name>.js` |
+| `page` | `cypress/pages/<name>.page.js` |
+
+---
+
+### `screenshot` — Take a URL screenshot *(like `npx playwright screenshot`)*
+
+```bash
+npx cypress-validate screenshot --url <url> [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--url <url>` | **(required)** URL to screenshot |
+| `--output <path>` | Output file (default: `cypress/screenshots/screenshot.png`) |
+| `--browser <name>` | Browser to use |
+| `--full-page` | Full-page screenshot |
+| `--viewport <WxH>` | Viewport dimensions (default: `1280x720`) |
+
+```bash
+npx cypress-validate screenshot --url https://example.com
+npx cypress-validate screenshot --url https://example.com --full-page --output ./my-shot.png
+npx cypress-validate screenshot --url https://example.com --viewport 390x844
+```
+
+---
+
+### `show-report` — Open HTML report *(like `npx playwright show-report`)*
+
+```bash
+npx cypress-validate show-report [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--path <dir>` | Report directory (default: `cypress/reports`) |
+| `--serve` | Start a local HTTP server instead of opening |
+| `--port <n>` | Port for `--serve` mode (default: `9323`) |
+
+```bash
+# Open most recent report in browser
+npx cypress-validate show-report
+
+# Serve on a local port
+npx cypress-validate show-report --serve --port 8080
+
+# Point to a custom report path
+npx cypress-validate show-report --path cypress/reports/mochawesome.html
+```
+
+---
+
+### `record` — Record to Cypress Cloud
+
+```bash
+npx cypress-validate record [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--key <key>` | Record key (or set `CYPRESS_RECORD_KEY` env) |
+| `--spec <pattern>` | Spec pattern |
+| `--browser <name>` | Browser to use |
+| `--tag <tags>` | Run tags |
+| `--group <name>` | Group name |
+| `--parallel` | Enable parallel recording |
+| `--ci-build-id <id>` | CI build ID for grouping |
+
+```bash
+npx cypress-validate record --key abc123
+CYPRESS_RECORD_KEY=abc123 npx cypress-validate record --parallel --group "CI Run"
+```
+
+---
+
+## 🧪 Full Playwright → cypress-validate Mapping
+
+| Playwright CLI | cypress-validate |
+|---|---|
+| `npx playwright test` | `npx cypress-validate run` |
+| `npx playwright test file.spec.ts` | `npx cypress-validate run --spec cypress/e2e/file.cy.js` |
+| `npx playwright test --headed` | `npx cypress-validate run --headed` |
+| `npx playwright test --project=chromium` | `npx cypress-validate run --browser chrome` |
+| `npx playwright test --grep "pattern"` | `npx cypress-validate run --grep "pattern"` |
+| `npx playwright test --workers=4` | `npx cypress-validate run --workers 4` |
+| `npx playwright test --timeout=5000` | `npx cypress-validate run --timeout 5000` |
+| `npx playwright test --retries=2` | `npx cypress-validate run --retry 2` |
+| `npx playwright test --reporter=html` | `npx cypress-validate run --reporter mochawesome` |
+| `npx playwright test --last-failed` | `npx cypress-validate run --last-failed` |
+| `npx playwright test --forbid-only` | `npx cypress-validate run --forbid-only` |
+| `npx playwright test --ui` | `npx cypress-validate open` |
+| `npx playwright test --debug` | `npx cypress-validate open --spec <file>` |
+| `npx playwright install` | `npx cypress-validate install` |
+| `npx playwright show-report` | `npx cypress-validate show-report` |
+| `npx playwright screenshot [url]` | `npx cypress-validate screenshot --url [url]` |
+| `npx playwright codegen` | `npx cypress-validate generate` |
+| `npx playwright info` | `npx cypress-validate info` |
+| `npx playwright --version` | `npx cypress-validate --version` |
+
+---
+
+## ⚙️ Programmatic API
+
+```js
+const { run, open, info, generate } = require('cypress-validate');
+
+// Run tests programmatically
+await run({ browser: 'chrome', headed: true, spec: 'cypress/e2e/login.cy.js' });
+
+// Open interactive runner
+await open({ browser: 'firefox' });
+
+// Generate a spec file
+await generate({ name: 'dashboard', type: 'spec', url: 'http://localhost:3000' });
+```
+
+---
+
+## 📦 Publishing to npm
+
+```bash
+# Login to npm
+npm login
+
+# Publish publicly
+npm publish --access public
+```
+
+---
+
+## 🤝 Contributing
+
+Issues and PRs welcome at [github.com/mvsaran/cypress-validate](https://github.com/mvsaran/cypress-validate).
+
+---
+
+## 📄 License
+
+[MIT](./LICENSE) © 2026 cypress-validate contributors

package/bin/cypress-validate.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+'use strict';
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const pkg = require('../package.json');
+
+const program = new Command();
+
+// ─── Banner ───────────────────────────────────────────────────────────────────
+function printBanner() {
+  console.log(chalk.cyan.bold('\n  ██████╗██╗   ██╗██████╗ ██████╗ ███████╗███████╗███████╗'));
+  console.log(chalk.cyan.bold('  ██╔════╝╚██╗ ██╔╝██╔══██╗██╔══██╗██╔════╝██╔════╝██╔════╝'));
+  console.log(chalk.cyan.bold('  ██║      ╚████╔╝ ██████╔╝██████╔╝█████╗  ███████╗███████╗'));
+  console.log(chalk.cyan.bold('  ██║       ╚██╔╝  ██╔═══╝ ██╔══██╗██╔══╝  ╚════██║╚════██║'));
+  console.log(chalk.cyan.bold('  ╚██████╗   ██║   ██║     ██║  ██║███████╗███████║███████║'));
+  console.log(chalk.cyan.bold('   ╚═════╝   ╚═╝   ╚═╝     ╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝'));
+  console.log(chalk.gray(`\n  validate — Playwright-style CLI for Cypress  v${pkg.version}\n`));
+}
+
+// ─── Program setup ────────────────────────────────────────────────────────────
+program
+  .name('cypress-validate')
+  .description(chalk.white('A Playwright-style CLI for Cypress projects'))
+  .version(pkg.version, '-v, --version', 'Show version number')
+  .addHelpText('before', () => {
+    printBanner();
+    return '';
+  });
+
+// ─── run ──────────────────────────────────────────────────────────────────────
+program
+  .command('run')
+  .description('Run Cypress tests in headless mode (like npx playwright test)')
+  .option('-s, --spec <pattern>',      'Spec file or glob pattern to run')
+  .option('-b, --browser <name>',      'Browser to run tests in (chrome, firefox, edge, electron)', 'electron')
+  .option('--headed',                  'Run in headed (visible) browser mode')
+  .option('--headless',                'Run in headless mode (default)')
+  .option('-g, --grep <pattern>',      'Only run tests matching the grep pattern')
+  .option('-w, --workers <number>',    'Number of parallel test workers (requires Cypress Cloud)', '1')
+  .option('--timeout <ms>',            'Default timeout in milliseconds', '30000')
+  .option('--retry <count>',           'Number of times to retry a failing test', '0')
+  .option('--reporter <name>',         'Reporter to use (mochawesome, spec, json, junit)', 'spec')
+  .option('--record',                  'Record test results to Cypress Cloud')
+  .option('--key <key>',               'Cypress Cloud record key (or set CYPRESS_RECORD_KEY env)')
+  .option('--last-failed',             'Re-run only the specs that failed in the last run')
+  .option('--forbid-only',             'Fail if test.only() is used anywhere in the suite')
+  .option('--config <json>',           'Override cypress.config.js values (JSON string)')
+  .option('--env <key=value>',         'Set environment variables (e.g. --env baseUrl=http://localhost)')
+  .option('--tag <tags>',              'Associate tags with this run (Cypress Cloud)')
+  .option('-p, --port <number>',       'Override default Cypress port')
+  .action((opts) => {
+    require('../lib/commands/run')(opts);
+  });
+
+// ─── open ─────────────────────────────────────────────────────────────────────
+program
+  .command('open')
+  .description('Open Cypress interactive Test Runner (like npx playwright test --ui)')
+  .option('-b, --browser <name>',      'Browser to open (chrome, firefox, edge, electron)')
+  .option('-s, --spec <pattern>',      'Spec file to open directly')
+  .option('--config <json>',           'Override cypress.config.js values (JSON string)')
+  .option('--env <key=value>',         'Set environment variables')
+  .option('-p, --port <number>',       'Override default Cypress port')
+  .action((opts) => {
+    require('../lib/commands/open')(opts);
+  });
+
+// ─── install ──────────────────────────────────────────────────────────────────
+program
+  .command('install')
+  .description('Install Cypress in the current project (like npx playwright install)')
+  .option('--force',                   'Force re-install even if Cypress is already installed')
+  .option('--global',                  'Install Cypress globally')
+  .option('--version <version>',       'Install a specific version of Cypress')
+  .action((opts) => {
+    require('../lib/commands/install')(opts);
+  });
+
+// ─── verify ───────────────────────────────────────────────────────────────────
+program
+  .command('verify')
+  .description('Verify that Cypress is installed correctly')
+  .option('--force',                   'Force re-verification')
+  .action((opts) => {
+    require('../lib/commands/verify')(opts);
+  });
+
+// ─── info ─────────────────────────────────────────────────────────────────────
+program
+  .command('info')
+  .description('Print Cypress, system, and browser information')
+  .action(() => {
+    require('../lib/commands/info')();
+  });
+
+// ─── generate ─────────────────────────────────────────────────────────────────
+program
+  .command('generate')
+  .description('Scaffold test files interactively (like npx playwright codegen)')
+  .option('-n, --name <name>',         'Name for the generated file (without extension)')
+  .option('-t, --type <type>',         'Type to generate: spec | fixture | command | page', 'spec')
+  .option('-d, --dir <directory>',     'Target directory (defaults to Cypress convention)')
+  .option('--url <url>',               'Base URL to include in the generated spec')
+  .option('--typescript',              'Generate TypeScript (.cy.ts) files')
+  .action((opts) => {
+    require('../lib/commands/generate')(opts);
+  });
+
+// ─── screenshot ───────────────────────────────────────────────────────────────
+program
+  .command('screenshot')
+  .description('Take a screenshot of a URL (like npx playwright screenshot)')
+  .requiredOption('--url <url>',       'URL to screenshot')
+  .option('-o, --output <path>',       'Output file path', 'cypress/screenshots/screenshot.png')
+  .option('-b, --browser <name>',      'Browser to use', 'electron')
+  .option('--full-page',               'Capture full-page screenshot')
+  .option('--viewport <WxH>',          'Viewport size (e.g. 1280x720)', '1280x720')
+  .action((opts) => {
+    require('../lib/commands/screenshot')(opts);
+  });
+
+// ─── show-report ──────────────────────────────────────────────────────────────
+program
+  .command('show-report')
+  .description('Open Cypress HTML test report in the browser (like npx playwright show-report)')
+  .option('--path <path>',             'Path to the HTML report file or directory',     'cypress/reports')
+  .option('--serve',                   'Serve the report on a local HTTP server')
+  .option('--port <number>',           'Port for the local server (with --serve)',       '9323')
+  .action((opts) => {
+    require('../lib/commands/show-report')(opts);
+  });
+
+// ─── record ───────────────────────────────────────────────────────────────────
+program
+  .command('record')
+  .description('Run tests and record results to Cypress Cloud')
+  .option('-s, --spec <pattern>',      'Spec file or glob pattern')
+  .option('-b, --browser <name>',      'Browser to run tests in', 'electron')
+  .option('--key <key>',               'Cypress Cloud record key')
+  .option('--tag <tags>',              'Tags for this run')
+  .option('--group <name>',            'Group name for this run')
+  .option('--parallel',                'Run tests in parallel on Cypress Cloud')
+  .option('--ci-build-id <id>',        'CI build ID for grouping parallel runs')
+  .action((opts) => {
+    require('../lib/commands/record')(opts);
+  });
+
+// ─── Global error handler ─────────────────────────────────────────────────────
+program.parseAsync(process.argv).catch((err) => {
+  console.error(chalk.red('\n  ✖ Error: ') + err.message);
+  process.exit(1);
+});

package/lib/commands/generate.js

@@ -0,0 +1,200 @@
+'use strict';
+
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const { logger, createSpinner } = require('../utils/logger');
+const { findProjectRoot } = require('../utils/config-finder');
+
+// ─── Templates ────────────────────────────────────────────────────────────────
+
+function specTemplate({ name, url, typescript }) {
+    const ext = typescript ? 'cy.ts' : 'cy.js';
+    const baseUrl = url || 'http://localhost:3000';
+    return `/// <reference types="cypress" />
+
+describe('${name}', () => {
+  beforeEach(() => {
+    cy.visit('${baseUrl}');
+  });
+
+  it('should load the page', () => {
+    cy.title().should('not.be.empty');
+  });
+
+  it('should display the main heading', () => {
+    cy.get('h1').should('be.visible');
+  });
+
+  it('should be responsive', () => {
+    cy.viewport(375, 667); // iPhone SE
+    cy.get('body').should('be.visible');
+  });
+});
+`;
+}
+
+function fixtureTemplate({ name }) {
+    return JSON.stringify({
+        id: 1,
+        name: name,
+        email: `${name.toLowerCase()}@example.com`,
+        createdAt: new Date().toISOString(),
+    }, null, 2) + '\n';
+}
+
+function commandTemplate({ name }) {
+    return `// cypress/support/commands/${name}.js
+// Custom Cypress commands for "${name}"
+
+/**
+ * @example cy.${name}Login('user@example.com', 'password')
+ */
+Cypress.Commands.add('${name}Login', (email, password) => {
+  cy.session([email, password], () => {
+    cy.visit('/login');
+    cy.get('[data-cy="email"]').type(email);
+    cy.get('[data-cy="password"]').type(password);
+    cy.get('[data-cy="submit"]').click();
+    cy.url().should('not.include', '/login');
+  });
+});
+
+/**
+ * @example cy.${name}Api('GET', '/api/users')
+ */
+Cypress.Commands.add('${name}Api', (method, url, body) => {
+  return cy.request({ method, url, body, failOnStatusCode: false });
+});
+`;
+}
+
+function pageTemplate({ name }) {
+    const ClassName = name.charAt(0).toUpperCase() + name.slice(1) + 'Page';
+    return `// cypress/pages/${name}.page.js
+// Page Object Model for "${name}" page
+
+class ${ClassName} {
+  // ─── Selectors ───────────────────────────────────────────
+  get heading()     { return cy.get('h1'); }
+  get submitButton(){ return cy.get('[data-cy="submit"]'); }
+  get errorMessage(){ return cy.get('[data-cy="error"]'); }
+
+  // ─── Actions ─────────────────────────────────────────────
+  visit() {
+    cy.visit('/${name}');
+    return this;
+  }
+
+  clickSubmit() {
+    this.submitButton.click();
+    return this;
+  }
+
+  // ─── Assertions ──────────────────────────────────────────
+  shouldBeVisible() {
+    this.heading.should('be.visible');
+    return this;
+  }
+}
+
+module.exports = new ${ClassName}();
+`;
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+module.exports = async function generateCommand(opts) {
+    logger.title('Cypress Validate — Generate');
+    logger.divider();
+
+    const projectRoot = findProjectRoot();
+    let { name, type, dir, url, typescript } = opts;
+
+    // If not passed via flags, use interactive prompts
+    if (!name || !type) {
+        try {
+            const { prompt } = require('enquirer');
+            const answers = await prompt([
+                !name && {
+                    type: 'input',
+                    name: 'name',
+                    message: 'File name (without extension):',
+                    initial: 'example',
+                    validate: (v) => v.trim() ? true : 'Name is required',
+                },
+                !type && {
+                    type: 'select',
+                    name: 'type',
+                    message: 'What would you like to generate?',
+                    choices: [
+                        { name: 'spec', message: '📄  Spec file          (cypress/e2e/<name>.cy.js)' },
+                        { name: 'fixture', message: '📦  Fixture file       (cypress/fixtures/<name>.json)' },
+                        { name: 'command', message: '🔧  Custom command      (cypress/support/commands/<name>.js)' },
+                        { name: 'page', message: '📐  Page Object         (cypress/pages/<name>.page.js)' },
+                    ],
+                },
+                !url && type === 'spec' && {
+                    type: 'input',
+                    name: 'url',
+                    message: 'Base URL for spec (optional):',
+                    initial: 'http://localhost:3000',
+                },
+            ].filter(Boolean));
+            name = answers.name || name;
+            type = answers.type || type;
+            url = answers.url || url;
+        } catch (_) {
+            // enquirer not available or TTY not supported — use defaults
+            name = name || 'example';
+            type = type || 'spec';
+        }
+    }
+
+    // Determine output path
+    let content, outPath;
+    switch (type) {
+        case 'spec': {
+            const ext = typescript ? 'cy.ts' : 'cy.js';
+            const targetDir = dir || path.join(projectRoot, 'cypress', 'e2e');
+            outPath = path.join(targetDir, `${name}.${ext}`);
+            content = specTemplate({ name, url, typescript });
+            break;
+        }
+        case 'fixture': {
+            const targetDir = dir || path.join(projectRoot, 'cypress', 'fixtures');
+            outPath = path.join(targetDir, `${name}.json`);
+            content = fixtureTemplate({ name });
+            break;
+        }
+        case 'command': {
+            const targetDir = dir || path.join(projectRoot, 'cypress', 'support', 'commands');
+            outPath = path.join(targetDir, `${name}.js`);
+            content = commandTemplate({ name });
+            break;
+        }
+        case 'page': {
+            const targetDir = dir || path.join(projectRoot, 'cypress', 'pages');
+            outPath = path.join(targetDir, `${name}.page.js`);
+            content = pageTemplate({ name });
+            break;
+        }
+        default:
+            logger.error(`Unknown type: ${type}. Use: spec | fixture | command | page`);
+            process.exit(1);
+    }
+
+    const spinner = createSpinner(`Generating ${type} → ${path.relative(projectRoot, outPath)}`);
+    spinner.start();
+
+    await fs.ensureDir(path.dirname(outPath));
+    await fs.writeFile(outPath, content, 'utf-8');
+
+    spinner.succeed(chalk.green(`Generated: ${chalk.cyan(path.relative(process.cwd(), outPath))}`));
+    logger.blank();
+    logger.info(`Type: ${chalk.bold(type)}`);
+    logger.info(`Path: ${chalk.cyan(outPath)}`);
+    logger.blank();
+    logger.step('Next: ' + chalk.cyan(`npx cypress-validate run --spec "${path.relative(process.cwd(), outPath)}"`));
+    logger.blank();
+};