angular-uitest 1.0.3

package/dist/types/helpers/setup.d.ts

@@ -0,0 +1,50 @@
+import { Browser, BrowserContext, Page, APIRequestContext } from '@playwright/test';
+import { APIUser } from './api.js';
+export interface TestUser extends APIUser {
+    token?: string;
+}
+export interface IsolatedUserContext {
+    context: BrowserContext;
+    page: Page;
+    user: TestUser;
+}
+/**
+ * Create a user in an isolated browser context
+ * This provides full isolation for tests
+ */
+export declare function createUserInIsolation(browser: Browser, user?: Partial<TestUser>): Promise<IsolatedUserContext>;
+/**
+ * Create a user via API (faster, no browser context needed)
+ */
+export declare function createUserViaAPI(request: APIRequestContext, user?: Partial<TestUser>): Promise<TestUser & {
+    token: string;
+}>;
+/**
+ * Setup authenticated page with token
+ */
+export declare function setupAuthenticatedPage(page: Page, token: string): Promise<void>;
+/**
+ * Create multiple articles via API
+ */
+export declare function createManyArticles(request: APIRequestContext, token: string, count: number, baseTitle?: string): Promise<Array<{
+    slug: string;
+    title: string;
+}>>;
+/**
+ * Cleanup helper for test data
+ */
+export declare function cleanupTestData(request: APIRequestContext, token: string, articles: Array<{
+    slug: string;
+}>): Promise<void>;
+/**
+ * Wait for Angular to be stable
+ */
+export declare function waitForAngular(page: Page): Promise<void>;
+/**
+ * Safe navigation with retry
+ */
+export declare function safeGoto(page: Page, url: string, options?: {
+    timeout?: number;
+    retries?: number;
+}): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/types/helpers/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../helpers/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,EAAsB,OAAO,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,WAAW,QAAS,SAAQ,OAAO;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAa9B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GACvB,OAAO,CAAC,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CASvC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAuB,GACjC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAejD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/types/src/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SamaroUItest - Comprehensive Testing Framework for Angular
+ *
+ * @packageDocumentation
+ */
+import 'reflect-metadata';
+export { createVitestConfig, createPlaywrightConfig, createComponentConfig, mergeConfig, type SamaroVitestOptions, type SamaroPlaywrightOptions, type SamaroComponentOptions, } from '../config/index.js';
+export { setDebugInterfaceName, getDebugInterfaceName, getToken, getAuthState, getCurrentUser, waitForAuthState, isDebugInterfaceAvailable, getDebugData, type AuthState, type User, register, login, logout, generateUniqueUser, isLoggedIn, getCurrentUsername, type UserCredentials, type AuthResult, getAPIConfig, registerUserViaAPI, loginUserViaAPI, createArticleViaAPI, deleteArticleViaAPI, updateUserViaAPI, getCurrentUserViaAPI, type APIConfig, type APIUser, type APIAuthResponse, createUserInIsolation, createUserViaAPI, setupAuthenticatedPage, createManyArticles, cleanupTestData, waitForAngular, safeGoto, type TestUser, type IsolatedUserContext, getConfig, isCI, isDebug, getBrowserLaunchOptions, setTestEnv, type SamaroConfig, severity, tag, epic, feature, story, owner, description, descriptionHtml, link, issue, tms, allure, allureMeta, addLabel, addLink, addAttachment, attachScreenshot, attachJson, attachText, attachHtml, allureStep, getAllureMetadata, getAllureMetadataKeys, type Severity, type LinkType, type LabelName, type AllureMetadataOptions, type Label, type Link, type Parameter, type Attachment, type Status, type StatusDetails, type StepResult, type TestResult, type TestResultContainer, } from '../helpers/index.js';
+/**
+ * Version of SamaroUItest
+ */
+export declare const VERSION = "1.0.2";
+/**
+ * Check if the package is properly installed
+ */
+export declare function checkInstallation(): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,EACrB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,IAAI,EAGT,QAAQ,EACR,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EAGf,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,eAAe,EAGpB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,mBAAmB,EAGxB,SAAS,EACT,IAAI,EACJ,OAAO,EACP,uBAAuB,EACvB,UAAU,EACV,KAAK,YAAY,EAGjB,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,OAAO,EACP,KAAK,EACL,KAAK,EACL,WAAW,EACX,eAAe,EACf,IAAI,EACJ,KAAK,EACL,GAAG,EACH,MAAM,EACN,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "angular-uitest",
+  "version": "1.0.3",
+  "description": "Comprehensive testing framework for Angular with Vitest, Playwright, and Allure reporting",
+  "main": "./dist/cjs/src/index.js",
+  "module": "./dist/esm/src/index.mjs",
+  "types": "./dist/types/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/src/index.d.ts",
+        "default": "./dist/esm/src/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/src/index.d.ts",
+        "default": "./dist/cjs/src/index.js"
+      }
+    },
+    "./config": {
+      "import": {
+        "types": "./dist/types/config/index.d.ts",
+        "default": "./dist/esm/config/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/config/index.d.ts",
+        "default": "./dist/cjs/config/index.js"
+      }
+    },
+    "./helpers": {
+      "import": {
+        "types": "./dist/types/helpers/index.d.ts",
+        "default": "./dist/esm/helpers/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/helpers/index.d.ts",
+        "default": "./dist/cjs/helpers/index.js"
+      }
+    },
+    "./allure": {
+      "import": {
+        "types": "./dist/types/helpers/allure.d.ts",
+        "default": "./dist/esm/helpers/allure.mjs"
+      },
+      "require": {
+        "types": "./dist/types/helpers/allure.d.ts",
+        "default": "./dist/cjs/helpers/allure.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "samaro": "bin/samaro-init.mjs",
+    "samaro-init": "bin/samaro-init.mjs",
+    "samaro-test": "bin/samaro-test.mjs",
+    "samaro-allure": "bin/samaro-allure.mjs"
+  },
+  "files": [
+    "dist/**/*",
+    "bin/**/*",
+    "scripts/**/*",
+    "types/**/*",
+    "schematics/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run clean && npm run build:esm && npm run build:cjs && npm run build:types && npm run rename:esm",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "rename:esm": "node scripts/rename-esm-files.mjs",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "format": "prettier --write ."
+  },
+  "keywords": [
+    "angular",
+    "testing",
+    "vitest",
+    "playwright",
+    "allure",
+    "e2e",
+    "component-testing",
+    "test-framework",
+    "automation"
+  ],
+  "author": "Samaro",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/angular-uitest/angular-uitest.git"
+  },
+  "bugs": {
+    "url": "https://github.com/angular-uitest/angular-uitest/issues"
+  },
+  "homepage": "https://github.com/angular-uitest/angular-uitest#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=15.0.0",
+    "@angular/platform-browser-dynamic": ">=15.0.0",
+    "typescript": ">=4.8.0"
+  },
+  "dependencies": {
+    "@analogjs/vite-plugin-angular": "^2.2.2",
+    "reflect-metadata": "^0.2.2",
+    "@playwright/test": "^1.58.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "@vitest/ui": "^4.0.18",
+    "allure": "^3.14.2",
+    "allure-commandline": "^2.43.0",
+    "allure-js-commons": "^3.10.2",
+    "allure-playwright": "^3.10.2",
+    "allure-vitest": "^3.10.2",
+    "jsdom": "^27.4.0",
+    "playwright": "^1.58.0",
+    "vitest": "^4.0.18",
+    "zone.js": "^0.16.0",
+    "cross-spawn": "^7.0.3",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.6"
+  },
+  "devDependencies": {
+    "@angular-devkit/schematics": "^17.0.0",
+    "@types/cross-spawn": "^6.0.6",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.0.0",
+    "cpy-cli": "^5.0.0",
+    "prettier": "^3.0.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.0"
+  },
+  "schematics": "./schematics/collection.json",
+  "ng-add": {
+    "save": "devDependencies"
+  }
+}

package/schematics/collection.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Add SamaroUItest to the project",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json",
+      "aliases": ["install", "setup"]
+    }
+  }
+}

package/schematics/ng-add/index.js

@@ -0,0 +1,126 @@
+import { chain, schematic } from '@angular-devkit/schematics';
+import { NodePackageInstallTask } from '@angular-devkit/schematics/tasks';
+
+function ngAdd(options) {
+  return (tree, context) => {
+    context.addTask(new NodePackageInstallTask());
+    
+    context.logger.info('🚀 Installing AngularUITest...');
+    
+    return chain([
+      updatePackageJson(),
+      createConfigFiles(options),
+      createDirectories(),
+    ])(tree, context);
+  };
+}
+
+function updatePackageJson() {
+  return (tree, context) => {
+    const packageJsonPath = '/package.json';
+    const packageJsonBuffer = tree.read(packageJsonPath);
+    
+    if (!packageJsonBuffer) {
+      throw new Error('Could not read package.json');
+    }
+    
+    const packageJson = JSON.parse(packageJsonBuffer.toString());
+    
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      'test': 'samaro-test vitest',
+      'test:run': 'samaro-test "vitest --run"',
+      'test:ui': 'samaro-test "vitest --ui"',
+      'test:coverage': 'samaro-test "vitest --coverage"',
+      'test:e2e': 'samaro-test "playwright test"',
+      'test:e2e:ui': 'samaro-test "playwright test --ui"',
+      'test:e2e:headed': 'samaro-test "playwright test --headed"',
+      'test:e2e:debug': 'samaro-test "playwright test --debug"',
+      'test:ct': 'samaro-test "playwright test --config playwright.component.config.ts"',
+      'test:ct:ui': 'samaro-test "playwright test --config playwright.component.config.ts --ui"',
+      'allure:generate': 'samaro-allure generate',
+      'allure:open': 'samaro-allure open',
+      'allure:clean': 'samaro-allure clean',
+    };
+    
+    tree.overwrite(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    context.logger.info('✅ Updated package.json scripts');
+    
+    return tree;
+  };
+}
+
+function createConfigFiles(options) {
+  return (tree, context) => {
+    // Create vitest.config.ts
+    tree.create('/vitest.config.ts', `import { createVitestConfig } from 'angular-uitest/config';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export default createVitestConfig({
+  projectRoot: __dirname,
+  testGlob: 'src/**/*.spec.ts',
+  resultsDir: 'allure-unit-results',
+});
+`);
+    context.logger.info('✅ Created vitest.config.ts');
+
+    // Create playwright.config.ts
+    tree.create('/playwright.config.ts', `import { createPlaywrightConfig } from 'angular-uitest/config';
+
+export default createPlaywrightConfig({
+  baseURL: 'http://localhost:4200',
+  testDir: './e2e',
+  resultsDir: 'allure-e2e-results',
+  webServerCommand: 'npm run start',
+  webServerPort: 4200,
+});
+`);
+    context.logger.info('✅ Created playwright.config.ts');
+
+    // Create playwright.component.config.ts
+    tree.create('/playwright.component.config.ts', `import { createComponentConfig } from 'angular-uitest/config';
+
+export default createComponentConfig({
+  baseURL: 'http://localhost:4200',
+  testDir: './ct-tests',
+  resultsDir: 'allure-ct-results',
+});
+`);
+    context.logger.info('✅ Created playwright.component.config.ts');
+
+    // Create test-setup.ts in src if it exists
+    if (tree.exists('/src')) {
+      tree.create('/src/test-setup.ts', `import 'zone.js';
+import 'zone.js/testing';
+import { getTestBed } from '@angular/core/testing';
+import { BrowserDynamicTestingModule, platformBrowserDynamicTesting } from '@angular/platform-browser-dynamic/testing';
+
+getTestBed().initTestEnvironment(
+  BrowserDynamicTestingModule,
+  platformBrowserDynamicTesting()
+);
+`);
+      context.logger.info('✅ Created src/test-setup.ts');
+    }
+
+    return tree;
+  };
+}
+
+function createDirectories() {
+  return (tree, context) => {
+    tree.create('/e2e/.gitkeep', '');
+    tree.create('/e2e/helpers/.gitkeep', '');
+    tree.create('/ct-tests/.gitkeep', '');
+    
+    context.logger.info('✅ Created test directories');
+    
+    return tree;
+  };
+}
+
+export { ngAdd };

package/schematics/ng-add/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SamaroUItestNgAddSchema",
+  "title": "SamaroUItest ng-add Options Schema",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the project to add SamaroUItest to",
+      "$default": {
+        "$source": "projectName"
+      }
+    },
+    "skipInstall": {
+      "type": "boolean",
+      "default": false,
+      "description": "Skip installing dependencies"
+    },
+    "includeSampleTests": {
+      "type": "boolean",
+      "default": true,
+      "description": "Include sample test files"
+    }
+  },
+  "required": []
+}

package/scripts/check-allure-results.mjs

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-test Allure results checker
+ *
+ * This script checks for existing Allure result data and prompts the user
+ * to either clean it, keep it, or cancel the test run.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { spawn } from 'child_process';
+import readline from 'readline';
+
+/**
+ * Detect if running in a CI environment
+ * Checks for common CI environment variables
+ */
+function isCIEnvironment() {
+  const ciEnvVars = [
+    'CI',
+    'CONTINUOUS_INTEGRATION',
+    'BUILD_NUMBER',
+    'BUILD_ID',
+    'TEAMCITY_VERSION',
+    'TRAVIS',
+    'CIRCLECI',
+    'GITHUB_ACTIONS',
+    'GITLAB_CI',
+    'JENKINS_URL',
+    'JENKINS_HOME',
+    'HUDSON_URL',
+    'DRONE',
+    'APPVEYOR',
+    'CODEBUILD_BUILD_ID',
+    'TF_BUILD',
+    'BITBUCKET_PIPELINE_UUID',
+    'BAMBOO_PLAN_KEY',
+    'GOCD_SERVER_URL',
+  ];
+
+  return ciEnvVars.some((envVar) => process.env[envVar]) || process.env.SAMARO_AUTO_CLEAN;
+}
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+// Allure result directories to check
+const ALLURE_DIRS = [
+  { name: 'Unit Tests', dir: 'allure-unit-results', type: 'unit' },
+  { name: 'E2E Tests', dir: 'allure-e2e-results', type: 'e2e' },
+  { name: 'Component Tests', dir: 'allure-ct-results', type: 'ct' },
+];
+
+// Colors for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+/**
+ * Check if a directory exists and get its contents
+ */
+function checkDirectory(dirPath) {
+  const fullPath = path.join(process.cwd(), dirPath);
+  
+  if (!fs.existsSync(fullPath)) {
+    return { exists: false, count: 0, lastModified: null };
+  }
+
+  try {
+    const files = fs.readdirSync(fullPath);
+    const stats = fs.statSync(fullPath);
+    
+    return {
+      exists: true,
+      count: files.length,
+      lastModified: stats.mtime,
+    };
+  } catch (error) {
+    return { exists: false, count: 0, lastModified: null, error: error.message };
+  }
+}
+
+/**
+ * Format the last modified time
+ */
+function formatTime(date) {
+  if (!date) return '-';
+  
+  const now = new Date();
+  const diff = now - date;
+  const minutes = Math.floor(diff / 60000);
+  const hours = Math.floor(diff / 3600000);
+  const days = Math.floor(diff / 86400000);
+  
+  if (minutes < 1) return 'Just now';
+  if (minutes < 60) return `${minutes} min ago`;
+  if (hours < 24) return `${hours} hour${hours > 1 ? 's' : ''} ago`;
+  return `${days} day${days > 1 ? 's' : ''} ago`;
+}
+
+/**
+ * Clean all Allure result directories
+ */
+function cleanAllureResults() {
+  console.log(`${colors.cyan}🧹 Cleaning Allure results...${colors.reset}\n`);
+  
+  let cleanedCount = 0;
+  
+  for (const { dir } of ALLURE_DIRS) {
+    const fullPath = path.join(process.cwd(), dir);
+    if (fs.existsSync(fullPath)) {
+      try {
+        fs.rmSync(fullPath, { recursive: true, force: true });
+        console.log(`  ${colors.green}✓${colors.reset} Removed ${dir}/`);
+        cleanedCount++;
+      } catch (error) {
+        console.log(`  ${colors.red}✗${colors.reset} Failed to remove ${dir}/: ${error.message}`);
+      }
+    }
+  }
+  
+  // Also clean the reports directory
+  const reportsPath = path.join(process.cwd(), 'allure-reports');
+  if (fs.existsSync(reportsPath)) {
+    try {
+      fs.rmSync(reportsPath, { recursive: true, force: true });
+      console.log(`  ${colors.green}✓${colors.reset} Removed allure-reports/`);
+      cleanedCount++;
+    } catch (error) {
+      console.log(`  ${colors.red}✗${colors.reset} Failed to remove allure-reports/: ${error.message}`);
+    }
+  }
+  
+  console.log(`${colors.green}\n✅ Cleanup complete!${colors.reset}\n`);
+  return cleanedCount;
+}
+
+/**
+ * Run the actual test command
+ */
+function runTestCommand(command) {
+  console.log(`${colors.cyan}▶️  Running: ${command}${colors.reset}\n`);
+  
+  const parts = command.split(' ');
+  const cmd = parts[0];
+  const args = parts.slice(1);
+  
+  const isWindows = process.platform === 'win32';
+  
+  const child = spawn(cmd, args, {
+    stdio: 'inherit',
+    shell: isWindows,
+    cwd: process.cwd(),
+  });
+  
+  child.on('close', (code) => {
+    process.exit(code);
+  });
+  
+  child.on('error', (error) => {
+    console.error(`${colors.red}Failed to run command: ${error.message}${colors.reset}`);
+    process.exit(1);
+  });
+}
+
+/**
+ * Show the prompt and handle user input
+ */
+function showPrompt(hasExistingResults, testCommand) {
+  console.log(`${colors.bright}What would you like to do?${colors.reset}\n`);
+  
+  if (hasExistingResults) {
+    console.log(`   ${colors.green}[1]${colors.reset} 🧹 Clean all results and run tests (recommended)`);
+    console.log(`   ${colors.yellow}[2]${colors.reset} ▶️  Keep results and run tests (will accumulate)`);
+  } else {
+    console.log(`   ${colors.green}[1]${colors.reset} ▶️  Run tests`);
+  }
+  console.log(`   ${colors.red}[3]${colors.reset} ❌ Cancel\n`);
+  
+  const promptText = hasExistingResults 
+    ? `Select option (1-3): `
+    : `Select option (1 or 3): `;
+  
+  rl.question(promptText, (answer) => {
+    const choice = answer.trim();
+    
+    if (choice === '1') {
+      // Clean and run
+      if (hasExistingResults) {
+        cleanAllureResults();
+      }
+      rl.close();
+      runTestCommand(testCommand);
+    } else if (choice === '2' && hasExistingResults) {
+      // Keep results and run
+      console.log(`${colors.yellow}\n⚠️  Proceeding with existing results. Reports will show duplicates.${colors.reset}\n`);
+      rl.close();
+      runTestCommand(testCommand);
+    } else if (choice === '3') {
+      // Cancel
+      console.log(`${colors.gray}\n❌ Test run cancelled.${colors.reset}`);
+      rl.close();
+      process.exit(0);
+    } else {
+      // Invalid input
+      console.log(`${colors.red}\n❌ Invalid option. Please try again.${colors.reset}\n`);
+      showPrompt(hasExistingResults, testCommand);
+    }
+  });
+}
+
+/**
+ * Auto mode - clean and run without prompting (for CI)
+ */
+function autoMode(testCommand) {
+  console.log(`${colors.cyan}🧹 Auto-cleaning Allure results (CI mode)...${colors.reset}\n`);
+  cleanAllureResults();
+  runTestCommand(testCommand);
+}
+
+/**
+ * Main function
+ */
+function main() {
+  // Get the test command from arguments
+  const testCommand = process.argv.slice(2).join(' ');
+  
+  if (!testCommand) {
+    console.error(`${colors.red}Error: No test command provided${colors.reset}`);
+    console.error(`Usage: node check-allure-results.js "<test-command>"`);
+    console.error(`Example: node check-allure-results.js "vitest"`);
+    process.exit(1);
+  }
+  
+  // Check if in CI mode (auto-detect common CI environments)
+  if (isCIEnvironment()) {
+    console.log(`${colors.cyan}🤖 CI environment detected - running in auto mode${colors.reset}\n`);
+    autoMode(testCommand);
+    return;
+  }
+  
+  console.log(`\n${colors.bright}🔍 Checking for existing Allure results...${colors.reset}\n`);
+  
+  // Check all directories
+  const results = ALLURE_DIRS.map(({ name, dir }) => ({
+    name,
+    dir,
+    ...checkDirectory(dir),
+  }));
+  
+  const hasExistingResults = results.some(r => r.exists && r.count > 0);
+  
+  if (!hasExistingResults) {
+    console.log(`${colors.green}✅ No existing Allure results found.${colors.reset}`);
+    console.log(`${colors.gray}   Starting with a clean slate.${colors.reset}\n`);
+    showPrompt(false, testCommand);
+    return;
+  }
+  
+  // Show warning
+  console.log(`${colors.yellow}⚠️  WARNING: Found existing result data from previous runs:${colors.reset}\n`);
+  
+  // Print table header
+  console.log(`   ${colors.bright}Directory${colors.reset}                    Files    Last Run`);
+  console.log(`   ${colors.gray}────────────────────────────────────────────────${colors.reset}`);
+  
+  // Print results
+  results.forEach(({ name, dir, exists, count, lastModified }) => {
+    if (exists) {
+      const namePadded = name.padEnd(28);
+      const countPadded = String(count).padStart(5);
+      const time = formatTime(lastModified);
+      console.log(`   ${namePadded} ${countPadded}    ${time}`);
+    }
+  });
+  
+  console.log(`\n${colors.cyan}💡 Not cleaning will cause duplicate entries in reports.${colors.reset}\n`);
+  
+  showPrompt(true, testCommand);
+}
+
+// Handle Ctrl+C gracefully
+rl.on('SIGINT', () => {
+  console.log(`\n${colors.gray}\n❌ Cancelled by user.${colors.reset}`);
+  rl.close();
+  process.exit(0);
+});
+
+// Run the script
+main();