@probolabs/playwright 1.5.0-rc.7 → 1.5.0-rc.9

package/dist/index.d.ts

@@ -432,6 +432,8 @@ interface CodeGenOptions {
         width: number;
         height: number;
     };
+    /** Test suite names for Playwright tags (from api/scenarios/light/) */
+    testSuiteTags?: string[];
 }
 /**
  * Result of generating code for a test suite
@@ -455,6 +457,7 @@ interface ProjectCodeGenResult {
         scenarioId: number;
         scenarioName: string;
         code: string;
+        testSuiteTags?: string[];
     }>;
 }
 /**
@@ -479,7 +482,7 @@ declare class ProboCodeGenerator {
      */
     private static fetchProjectData;
     /**
-     * Fetch all scenarios for a project from the backend API
+     * Fetch all scenarios for a project from the backend API (light endpoint includes test_suite_tags)
      */
     private static fetchProjectScenarios;
     /**
@@ -558,6 +561,11 @@ interface TestSuiteRunOptions {
     onStderr?: (chunk: string) => void | Promise<void>;
     onReporterEvent?: (event: any) => void | Promise<void>;
 }
+/**
+ * Gets the project directory path (unified for test suite runs and export).
+ * Path: ~/.probium/projects/{projectId}-{projectName-slugified}/
+ */
+declare function getProjectDir(projectId: number, projectName?: string): string;
 /**
  * TestSuiteRunner - Handles test suite file generation and execution
  */
@@ -571,9 +579,18 @@ declare class TestSuiteRunner {
      */
     static lookupTestSuiteByName(testSuiteName: string, projectName: string, apiToken: string, apiUrl: string): Promise<number>;
     /**
-     * Generate all files for a test suite
+     * Fetch test suite details (project id, project name, test suite name)
+     */
+    private static fetchTestSuiteDetails;
+    /**
+     * Generate all files for a test suite (writes to project-level directory)
      */
     static generateTestSuiteFiles(testSuiteId: number, apiToken: string, apiUrl: string, outputDir?: string, testSuiteName?: string, includeReporter?: boolean, runId?: number): Promise<void>;
+    /**
+     * Generate files only for the scenarios that participate in the test suite.
+     * Used by the recorder app test-suite runner so only suite specs are written; then we run npx playwright test normally.
+     */
+    static generateTestSuiteOnlyFiles(testSuiteId: number, apiToken: string, apiUrl: string, outputDir: string, testSuiteName?: string, includeReporter?: boolean, runId?: number): Promise<void>;
     /**
      * Generate package.json file
      */
@@ -595,6 +612,12 @@ declare class TestSuiteRunner {
      * Generate all files for a project (all scenarios)
      */
     static generateProjectFiles(projectId: number, apiToken: string, apiUrl: string, outputDir?: string, projectName?: string, includeReporter?: boolean): Promise<void>;
+    /**
+     * Export project code to a directory.
+     * If outputDir is provided, creates a subfolder {outputDir}/{projectId}-{projectNameSlug}/ and writes there.
+     * Otherwise writes to the default project dir (~/.probium/projects/...).
+     */
+    static exportProjectCode(projectId: number, apiToken: string, apiUrl: string, outputDir?: string, projectName?: string, includeReporter?: boolean): Promise<string>;
     /**
      * Run all scenarios in a project
      * Generates files, installs dependencies, and executes tests
@@ -674,5 +697,5 @@ declare class Probo {
     askAIHelper(page: Page, question: string, options: AskAIOptions, assertAnswer?: string): Promise<ServerResponse>;
 }
 
-export { Highlighter, NavTracker, OTP, Probo, ProboCodeGenerator, ProboPlaywright, TestSuiteRunner, buildInterpolationContext, findClosestVisibleElement, interpolateWithParams };
+export { Highlighter, NavTracker, OTP, Probo, ProboCodeGenerator, ProboPlaywright, TestSuiteRunner, buildInterpolationContext, findClosestVisibleElement, getProjectDir, interpolateWithParams };
 export type { AskAIOptions, CodeGenOptions, ElementTagType, MailinatorMessage, RunStepOptions, TestStatistics, TestSuiteCodeGenResult, TestSuiteRunOptions, TestSuiteRunResult };

package/dist/index.js

@@ -1296,6 +1296,16 @@ const DEFAULT_RECORDER_SETTINGS = {
 };
 
 // --- Code generation utilities for Probo Labs Playwright scripts ---
+/**
+ * Converts a test suite name to a Playwright tag (slugify + @ prefix).
+ * Playwright tags must start with @.
+ */
+function slugifyTag(tag) {
+    if (!tag || typeof tag !== 'string')
+        return '@untagged';
+    const slug = slugify(tag);
+    return slug ? `@${slug}` : '@untagged';
+}
 /**
  * Extracts environment variable names from parameter table rows
  * by parsing ${process.env.VAR_NAME} patterns from parameter values
@@ -1604,6 +1614,13 @@ function scriptTemplate(options, settings, viewPort) {
     }).join(',\n    ')}
   ];
   ` : '';
+    // Playwright tags for test suite filtering (e.g. npx playwright test --grep @sanity)
+    const playwrightTags = options.testSuiteTags && options.testSuiteTags.length > 0
+        ? options.testSuiteTags.map(slugifyTag).filter((t) => t !== '@untagged')
+        : [];
+    const describeTagOption = playwrightTags.length > 0
+        ? `{ tag: [${playwrightTags.map((t) => `'${t}'`).join(', ')}] }, `
+        : '';
     const proboConstructor = hasAiInteractions ? `
   const probo = new Probo({
     scenarioName: '${options.scenarioName}',
@@ -1680,7 +1697,7 @@ ${hasSecrets ? `import { config } from 'dotenv';
         }
     });
 
-  test.describe('${options.scenarioName}', () => {
+  test.describe('${options.scenarioName}', ${describeTagOption}() => {
     test.beforeEach(async ({ page }) => {
       // set the ProboPlaywright instance to the current page
       ppw.setPage(page);
@@ -1756,7 +1773,7 @@ const DEFAULT_PLAYWRIGHT_TEST_VERSION = '^1.57.0';
  * Generate package.json content for a Playwright test project
  */
 function generatePackageJson(options) {
-    const { name, hasSecrets = false, testScript = 'npx playwright test', playwrightTestVersion = DEFAULT_PLAYWRIGHT_TEST_VERSION } = options;
+    const { name, hasSecrets = false, testScript = 'npx playwright test', playwrightTestVersion = DEFAULT_PLAYWRIGHT_TEST_VERSION, probolabsPlaywrightVersion = 'latest' } = options;
     return `{
   "name": "${name}",
   "version": "1.0.0",
@@ -1767,7 +1784,7 @@ function generatePackageJson(options) {
   },
   "dependencies": {
     "@playwright/test": "${playwrightTestVersion}",
-    "@probolabs/playwright": "latest"${hasSecrets ? ',\n    "dotenv": "latest"' : ''}
+    "@probolabs/playwright": "${probolabsPlaywrightVersion}"${hasSecrets ? ',\n    "dotenv": "latest"' : ''}
   }
 }`;
 }
@@ -5106,16 +5123,21 @@ class ProboPlaywright {
         this.nextTabIndex = 1;
         this.params = {};
         this.isCanceled = null;
+        proboLogger.setLogLevel(debugLevel);
         this.enableSmartSelectors = enableSmartSelectors;
         this.timeoutConfig = mergeTimeoutConfigWithEnv({
             ...DEFAULT_PLAYWRIGHT_TIMEOUT_CONFIG,
             ...timeoutConfig
         });
+        proboLogger.debug(`ProboPlaywright timeout config: playwrightActionTimeout=${this.timeoutConfig.playwrightActionTimeout}ms, ` +
+            `playwrightNavigationTimeout=${this.timeoutConfig.playwrightNavigationTimeout}ms, ` +
+            `playwrightLocatorTimeout=${this.timeoutConfig.playwrightLocatorTimeout}ms, ` +
+            `waitForStabilityQuietTimeout=${this.timeoutConfig.waitForStabilityQuietTimeout}ms, ` +
+            `waitForStabilityGlobalTimeout=${this.timeoutConfig.waitForStabilityGlobalTimeout}ms`);
         this.isCanceled = isCanceled || null;
         this.highlighter = new Highlighter(enableSmartSelectors, false, debugLevel);
         this.context = context !== null && context !== void 0 ? context : null;
         this.setPage(page);
-        proboLogger.setLogLevel(debugLevel);
     }
     /**
     * Sets the Playwright page instance for this ProboPlaywright instance.
@@ -6106,12 +6128,12 @@ class ProboCodeGenerator {
         return response.json();
     }
     /**
-     * Fetch all scenarios for a project from the backend API
+     * Fetch all scenarios for a project from the backend API (light endpoint includes test_suite_tags)
      */
     static async fetchProjectScenarios(projectId, apiToken, apiUrl) {
         const normalizedUrl = this.normalizeApiUrl(apiUrl);
-        // Scenarios endpoint is at root level, not under /api/
-        const url = `${normalizedUrl}/scenarios/?project_id=${projectId}`;
+        // Use api/scenarios/light/ to get test_suite_tags for Playwright tagging
+        const url = `${normalizedUrl}/api/scenarios/light/?project_id=${projectId}`;
         const response = await fetch(url, {
             method: 'GET',
             headers: {
@@ -6249,6 +6271,7 @@ class ProboCodeGenerator {
             scenarioName: scenarioData.name,
             interactions: interactions,
             rows: rows,
+            ...((options === null || options === void 0 ? void 0 : options.testSuiteTags) && options.testSuiteTags.length > 0 ? { testSuiteTags: options.testSuiteTags } : {}),
         };
         return generateCode(codeOptions, settings, viewPort);
     }
@@ -6308,14 +6331,15 @@ class ProboCodeGenerator {
         if (scenarios.length === 0) {
             throw new Error(`No scenarios found in project "${projectData.name}" (ID: ${projectId})`);
         }
-        // Generate code for each scenario
+        // Generate code for each scenario (with test_suite_tags for Playwright tagging)
         const scenarioResults = await Promise.all(scenarios.map(async (scenario) => {
             try {
-                const code = await this.generateCodeForScenario(scenario.id, apiToken, apiUrl, options);
+                const code = await this.generateCodeForScenario(scenario.id, apiToken, apiUrl, { ...options, testSuiteTags: scenario.test_suite_tags });
                 return {
                     scenarioId: scenario.id,
                     scenarioName: scenario.name,
                     code: code,
+                    testSuiteTags: scenario.test_suite_tags,
                 };
             }
             catch (error) {
@@ -6342,15 +6366,13 @@ function ensureDirectoryExists(dir) {
     }
 }
 /**
- * Gets the default test suite directory path
+ * Gets the project directory path (unified for test suite runs and export).
+ * Path: ~/.probium/projects/{projectId}-{projectName-slugified}/
  */
-function getDefaultTestSuiteDir(testSuiteId, testSuiteName) {
-    const baseDir = path.join(os.homedir(), '.probium', 'test-suites');
-    if (testSuiteName) {
-        const sanitizedName = slugify(testSuiteName);
-        return path.join(baseDir, `${testSuiteId}-${sanitizedName}`);
-    }
-    return path.join(baseDir, testSuiteId.toString());
+function getProjectDir(projectId, projectName) {
+    const baseDir = path.join(os.homedir(), '.probium', 'projects');
+    const sanitizedName = projectName ? slugify(projectName) : `project-${projectId}`;
+    return path.join(baseDir, `${projectId}-${sanitizedName}`);
 }
 /**
  * Count total tests by scanning spec files
@@ -6545,36 +6567,67 @@ class TestSuiteRunner {
         throw new Error(`Test suite "${testSuiteName}" not found in project "${projectName}"`);
     }
     /**
-     * Generate all files for a test suite
+     * Fetch test suite details (project id, project name, test suite name)
+     */
+    static async fetchTestSuiteDetails(testSuiteId, apiToken, apiUrl) {
+        var _a, _b, _c;
+        const baseUrl = apiUrl.endsWith('/') ? apiUrl.slice(0, -1) : apiUrl;
+        const response = await fetch$1(`${baseUrl}/test-suites/${testSuiteId}/`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Token ${apiToken}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to fetch test suite ${testSuiteId}: ${response.status} ${errorText}`);
+        }
+        const data = await response.json();
+        const projectId = (_a = data.project) !== null && _a !== void 0 ? _a : data.project_id;
+        const projectName = (_b = data.project_name) !== null && _b !== void 0 ? _b : `project-${projectId}`;
+        const testSuiteName = (_c = data.name) !== null && _c !== void 0 ? _c : `suite-${testSuiteId}`;
+        if (!projectId) {
+            throw new Error(`Test suite ${testSuiteId} has no project`);
+        }
+        return { projectId, projectName, testSuiteName };
+    }
+    /**
+     * Generate all files for a test suite (writes to project-level directory)
      */
     static async generateTestSuiteFiles(testSuiteId, apiToken, apiUrl, outputDir, testSuiteName, includeReporter = true, runId) {
-        const testSuiteDir = outputDir || getDefaultTestSuiteDir(testSuiteId, testSuiteName);
-        // Generate code for all scenarios
+        const { projectId, projectName, testSuiteName: resolvedSuiteName } = await this.fetchTestSuiteDetails(testSuiteId, apiToken, apiUrl);
+        const projectDir = outputDir || getProjectDir(projectId, projectName);
+        await this.generateTestSuiteOnlyFiles(testSuiteId, apiToken, apiUrl, projectDir, testSuiteName !== null && testSuiteName !== void 0 ? testSuiteName : resolvedSuiteName, includeReporter, runId);
+    }
+    /**
+     * Generate files only for the scenarios that participate in the test suite.
+     * Used by the recorder app test-suite runner so only suite specs are written; then we run npx playwright test normally.
+     */
+    static async generateTestSuiteOnlyFiles(testSuiteId, apiToken, apiUrl, outputDir, testSuiteName, includeReporter = true, runId) {
+        var _a;
+        const { projectId } = await this.fetchTestSuiteDetails(testSuiteId, apiToken, apiUrl);
         const codeGenResult = await ProboCodeGenerator.generateCodeForTestSuite(testSuiteId, apiToken, apiUrl);
         if (codeGenResult.scenarios.length === 0) {
-            throw new Error(`No scenarios found in test suite ${testSuiteId}. Cannot generate test files.`);
+            throw new Error(`No scenarios found in test suite "${codeGenResult.testSuiteName}" (ID: ${testSuiteId}). Cannot generate test files.`);
         }
-        // Delete everything in the test suite directory except node_modules
-        // This ensures a clean state while preserving dependencies for faster subsequent runs
-        if (fs.existsSync(testSuiteDir)) {
+        const projectDir = outputDir;
+        if (fs.existsSync(projectDir)) {
             try {
-                const nodeModulesPath = path.join(testSuiteDir, 'node_modules');
+                const nodeModulesPath = path.join(projectDir, 'node_modules');
                 const hasNodeModules = fs.existsSync(nodeModulesPath);
-                // Temporarily move node_modules out of the way if it exists
                 let tempNodeModulesPath = null;
                 if (hasNodeModules) {
-                    tempNodeModulesPath = path.join(testSuiteDir, '..', `node_modules.temp.${testSuiteId}`);
-                    // Remove temp directory if it exists from a previous failed run
+                    tempNodeModulesPath = path.join(projectDir, '..', `node_modules.temp.${projectId}`);
                     if (fs.existsSync(tempNodeModulesPath)) {
                         fs.rmSync(tempNodeModulesPath, { recursive: true, force: true });
                     }
                     fs.renameSync(nodeModulesPath, tempNodeModulesPath);
                     console.log(`📦 Preserved node_modules temporarily`);
                 }
-                // Delete everything in the directory
-                const entries = fs.readdirSync(testSuiteDir, { withFileTypes: true });
+                const entries = fs.readdirSync(projectDir, { withFileTypes: true });
                 for (const entry of entries) {
-                    const entryPath = path.join(testSuiteDir, entry.name);
+                    const entryPath = path.join(projectDir, entry.name);
                     try {
                         if (entry.isDirectory()) {
                             fs.rmSync(entryPath, { recursive: true, force: true });
@@ -6587,36 +6640,33 @@ class TestSuiteRunner {
                         console.warn(`⚠️  Failed to delete ${entry.name}:`, error);
                     }
                 }
-                console.log(`🗑️  Cleaned test suite directory (preserved node_modules)`);
-                // Move node_modules back
+                console.log(`🗑️  Cleaned project directory (preserved node_modules)`);
                 if (hasNodeModules && tempNodeModulesPath) {
                     fs.renameSync(tempNodeModulesPath, nodeModulesPath);
                     console.log(`📦 Restored node_modules`);
                 }
             }
             catch (error) {
-                console.warn(`⚠️  Failed to clean test suite directory ${testSuiteDir}:`, error);
-                // Continue anyway - we'll overwrite files as needed
+                console.warn(`⚠️  Failed to clean project directory ${projectDir}:`, error);
             }
         }
-        // Ensure directories exist (will recreate after deletion)
-        ensureDirectoryExists(testSuiteDir);
-        const testsDir = path.join(testSuiteDir, 'tests');
+        ensureDirectoryExists(projectDir);
+        const testsDir = path.join(projectDir, 'tests');
         ensureDirectoryExists(testsDir);
-        // Save each scenario's code to a .spec.ts file
+        const seenSlugs = new Map();
         for (const scenario of codeGenResult.scenarios) {
-            const fileName = `${slugify(scenario.scenarioName)}.spec.ts`;
+            const slug = slugify(scenario.scenarioName);
+            const count = (_a = seenSlugs.get(slug)) !== null && _a !== void 0 ? _a : 0;
+            seenSlugs.set(slug, count + 1);
+            const fileName = count > 0 ? `${slug}-${scenario.scenarioId}.spec.ts` : `${slug}.spec.ts`;
             const filePath = path.join(testsDir, fileName);
             fs.writeFileSync(filePath, scenario.code, 'utf-8');
             console.log(`✅ Generated test file: ${filePath}`);
         }
-        // Generate package.json
-        await this.generatePackageJson(testSuiteDir, codeGenResult);
-        // Generate playwright.config.ts with runId if available
-        await this.generatePlaywrightConfig(testSuiteDir, includeReporter, runId);
-        // Generate custom reporter file for live progress streaming (only if requested)
+        await this.generatePackageJson(projectDir, codeGenResult);
+        await this.generatePlaywrightConfig(projectDir, includeReporter, runId);
         if (includeReporter) {
-            await this.generateProboReporter(testSuiteDir);
+            await this.generateProboReporter(projectDir);
         }
     }
     /**
@@ -6660,7 +6710,8 @@ class TestSuiteRunner {
         const packageJsonContent = generatePackageJson({
             name: sanitizedName,
             hasSecrets: hasSecrets,
-            testScript: 'npx playwright test'
+            testScript: 'npx playwright test',
+            probolabsPlaywrightVersion: process.env.PROBO_PLAYWRIGHT_VERSION || 'latest',
         });
         const filePath = path.join(outputDir, 'package.json');
         fs.writeFileSync(filePath, packageJsonContent, 'utf-8');
@@ -6690,7 +6741,8 @@ class TestSuiteRunner {
      */
     static async runTestSuite(testSuiteId, apiToken, apiUrl, testSuiteName, runId, options = {}) {
         const { outputDir, includeReporter = true, playwrightArgs = [], skipRunCreation = false, onStatusUpdate, onStdout, onStderr, onReporterEvent, } = options;
-        const testSuiteDir = outputDir || getDefaultTestSuiteDir(testSuiteId, testSuiteName);
+        const details = await this.fetchTestSuiteDetails(testSuiteId, apiToken, apiUrl);
+        const projectDir = outputDir || getProjectDir(details.projectId, details.projectName);
         let currentRunId = runId;
         try {
             // Create run record if not provided and not skipping run creation
@@ -6718,9 +6770,9 @@ class TestSuiteRunner {
             }
             // Generate all files (with runId if available for run-specific report directories)
             console.log(`📝 Generating test suite files for test suite ${testSuiteId}...`);
-            await this.generateTestSuiteFiles(testSuiteId, apiToken, apiUrl, testSuiteDir, testSuiteName, includeReporter, currentRunId);
+            await this.generateTestSuiteFiles(testSuiteId, apiToken, apiUrl, projectDir, testSuiteName, includeReporter, currentRunId);
             // Count total tests
-            const testsTotal = countTotalTests(testSuiteDir);
+            const testsTotal = countTotalTests(projectDir);
             if (currentRunId && testsTotal > 0) {
                 await updateRunStatus(currentRunId, testSuiteId, { tests_total: testsTotal }, apiToken, apiUrl);
                 if (onStatusUpdate) {
@@ -6728,10 +6780,10 @@ class TestSuiteRunner {
                 }
             }
             // Install dependencies
-            console.log(`📦 Installing dependencies in ${testSuiteDir}...`);
+            console.log(`📦 Installing dependencies in ${projectDir}...`);
             try {
                 const npmExecutable = findNpmExecutable();
-                const { stdout: installStdout, stderr: installStderr } = await execAsync(`${npmExecutable} install`, { cwd: testSuiteDir, timeout: 300000 } // 5 minute timeout for install
+                const { stdout: installStdout, stderr: installStderr } = await execAsync(`${npmExecutable} install`, { cwd: projectDir, timeout: 300000 } // 5 minute timeout for install
                 );
                 console.log('✅ Dependencies installed successfully');
                 if (installStdout)
@@ -6771,7 +6823,7 @@ class TestSuiteRunner {
             console.log(`🌐 Installing Playwright Chromium browser...`);
             try {
                 const npxExecutable = findNpxExecutable();
-                const { stdout: browserStdout, stderr: browserStderr } = await execAsync(`${npxExecutable} playwright install chromium`, { cwd: testSuiteDir, timeout: 300000 } // 5 minute timeout for browser install
+                const { stdout: browserStdout, stderr: browserStderr } = await execAsync(`${npxExecutable} playwright install chromium`, { cwd: projectDir, timeout: 300000 } // 5 minute timeout for browser install
                 );
                 console.log('✅ Playwright Chromium browser installed successfully');
                 if (browserStdout)
@@ -6785,7 +6837,7 @@ class TestSuiteRunner {
                 // or the error will be caught when trying to run tests
             }
             // Run Playwright tests with streaming output
-            console.log(`🚀 Running Playwright tests in ${testSuiteDir}...`);
+            console.log(`🚀 Running Playwright tests in ${projectDir}...`);
             if (playwrightArgs.length > 0) {
                 console.log(`🧪 Playwright extra args: ${playwrightArgs.join(' ')}`);
             }
@@ -6807,7 +6859,7 @@ class TestSuiteRunner {
                 // Use spawn for streaming output
                 const npxExecutable = findNpxExecutable();
                 const testProcess = spawn(npxExecutable, ['playwright', 'test', ...playwrightArgs], {
-                    cwd: testSuiteDir,
+                    cwd: projectDir,
                     shell: true,
                     stdio: ['ignore', 'pipe', 'pipe'],
                     env: {
@@ -6993,8 +7045,8 @@ class TestSuiteRunner {
                     console.log(success ? '✅ Tests completed successfully' : (isTestFailure ? '⚠️ Tests completed with failures' : '❌ Test execution failed'));
                     // Parse final statistics from metadata/stdout as fallback
                     let parsedStats = null;
-                    if (fs.existsSync(path.join(testSuiteDir, 'playwright-report'))) {
-                        parsedStats = parseStatisticsFromMetadata(testSuiteDir);
+                    if (fs.existsSync(path.join(projectDir, 'playwright-report'))) {
+                        parsedStats = parseStatisticsFromMetadata(projectDir);
                     }
                     if (!parsedStats) {
                         parsedStats = parsePlaywrightStatistics(stdout);
@@ -7196,7 +7248,8 @@ class TestSuiteRunner {
      * Generate all files for a project (all scenarios)
      */
     static async generateProjectFiles(projectId, apiToken, apiUrl, outputDir, projectName, includeReporter = true) {
-        const projectDir = outputDir || getDefaultTestSuiteDir(projectId, projectName || `project-${projectId}`);
+        var _a;
+        const projectDir = outputDir || getProjectDir(projectId, projectName || `project-${projectId}`);
         // Generate code for all scenarios
         const codeGenResult = await ProboCodeGenerator.generateCodeForProject(projectId, apiToken, apiUrl);
         if (codeGenResult.scenarios.length === 0) {
@@ -7250,9 +7303,12 @@ class TestSuiteRunner {
         ensureDirectoryExists(projectDir);
         const testsDir = path.join(projectDir, 'tests');
         ensureDirectoryExists(testsDir);
-        // Save each scenario's code to a .spec.ts file
+        const seenSlugs = new Map();
         for (const scenario of codeGenResult.scenarios) {
-            const fileName = `${slugify(scenario.scenarioName)}.spec.ts`;
+            const slug = slugify(scenario.scenarioName);
+            const count = (_a = seenSlugs.get(slug)) !== null && _a !== void 0 ? _a : 0;
+            seenSlugs.set(slug, count + 1);
+            const fileName = count > 0 ? `${slug}-${scenario.scenarioId}.spec.ts` : `${slug}.spec.ts`;
             const filePath = path.join(testsDir, fileName);
             fs.writeFileSync(filePath, scenario.code, 'utf-8');
             console.log(`✅ Generated test file: ${filePath}`);
@@ -7266,6 +7322,18 @@ class TestSuiteRunner {
             await this.generateProboReporter(projectDir);
         }
     }
+    /**
+     * Export project code to a directory.
+     * If outputDir is provided, creates a subfolder {outputDir}/{projectId}-{projectNameSlug}/ and writes there.
+     * Otherwise writes to the default project dir (~/.probium/projects/...).
+     */
+    static async exportProjectCode(projectId, apiToken, apiUrl, outputDir, projectName, includeReporter = false) {
+        const targetDir = outputDir
+            ? path.join(outputDir, `${projectId}-${slugify(projectName || `project-${projectId}`)}`)
+            : getProjectDir(projectId, projectName);
+        await this.generateProjectFiles(projectId, apiToken, apiUrl, targetDir, projectName, includeReporter);
+        return targetDir;
+    }
     /**
      * Run all scenarios in a project
      * Generates files, installs dependencies, and executes tests
@@ -7274,7 +7342,7 @@ class TestSuiteRunner {
     static async runProjectScenarios(projectId, apiToken, apiUrl, projectName, options = {}) {
         const { outputDir, includeReporter = false, // CLI mode - no custom reporter
         playwrightArgs = [], onStdout, onStderr, } = options;
-        const projectDir = outputDir || getDefaultTestSuiteDir(projectId, projectName || `project-${projectId}`);
+        const projectDir = outputDir || getProjectDir(projectId, projectName || `project-${projectId}`);
         try {
             // Generate all files
             console.log(`📝 Generating test files for project ${projectId}...`);
@@ -7513,6 +7581,11 @@ class Probo {
         this.timeoutConfig = mergeTimeoutConfigWithEnv({ ...DEFAULT_PLAYWRIGHT_TIMEOUT_CONFIG, ...timeoutConfig });
         // set the log level for the api client
         apiLogger.setLogLevel(this.debugLevel);
+        proboLogger.debug(`Timeout config: playwrightActionTimeout=${this.timeoutConfig.playwrightActionTimeout}ms, ` +
+            `playwrightNavigationTimeout=${this.timeoutConfig.playwrightNavigationTimeout}ms, ` +
+            `playwrightLocatorTimeout=${this.timeoutConfig.playwrightLocatorTimeout}ms, ` +
+            `waitForStabilityQuietTimeout=${this.timeoutConfig.waitForStabilityQuietTimeout}ms, ` +
+            `waitForStabilityGlobalTimeout=${this.timeoutConfig.waitForStabilityGlobalTimeout}ms`);
         proboLogger.info(`Initializing: scenario=${scenarioName}, apiUrl=${apiEndPoint}, ` +
             `enableConsoleLogs=${enableConsoleLogs}, debugLevel=${debugLevel}, aiModel=${aiModel}`);
     }
@@ -7849,5 +7922,5 @@ class Probo {
     }
 }
 
-export { AIModel, Highlighter, NavTracker, OTP, PlaywrightAction, Probo, ProboCodeGenerator, ProboLogLevel, ProboPlaywright, TestSuiteRunner, buildInterpolationContext, createUrlSlug, extractRequiredEnvVars, findClosestVisibleElement, generateCode, getRequiredEnvVars, interpolateWithParams };
+export { AIModel, Highlighter, NavTracker, OTP, PlaywrightAction, Probo, ProboCodeGenerator, ProboLogLevel, ProboPlaywright, TestSuiteRunner, buildInterpolationContext, createUrlSlug, extractRequiredEnvVars, findClosestVisibleElement, generateCode, getProjectDir, getRequiredEnvVars, interpolateWithParams };
 //# sourceMappingURL=index.js.map