rlint 0.4.0

package/dist/cli.js

@@ -0,0 +1,270 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import chalk from 'chalk';
+import { launchBrowser } from './browser.js';
+import { runChecks } from './runner.js';
+import { formatResults } from './reporter.js';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import { startDevServer, waitForHydration, getFrameworkInfo, needsHydration, } from './frameworks/index.js';
+program
+    .name('rlint')
+    .description('Catch rendered layout bugs automatically - no screenshots needed')
+    .version('0.4.0');
+// Check command - check URLs directly
+program
+    .command('check')
+    .description('Check a URL for CSS health issues')
+    .argument('<urls...>', 'URLs to check')
+    .option('-c, --config <path>', 'Path to config file')
+    .option('-f, --format <format>', 'Output format: text, json, junit', 'text')
+    .option('-o, --only <checks>', 'Only run specific checks (comma-separated)')
+    .option('-i, --ignore <selectors>', 'Ignore elements matching selectors (comma-separated)')
+    .option('-v, --viewport <size>', 'Viewport size (e.g., 1920x1080 or 375x667,1920x1080 for multiple)')
+    .option('--fail-on <severity>', 'Exit with error if issues of this severity found: error, warning', 'error')
+    .option('--headed', 'Run browser in headed mode (visible)')
+    .option('--wait-for-hydration', 'Wait for SPA hydration before checking', false)
+    .option('--framework <framework>', 'Specify framework for hydration detection')
+    .action(async (urls, options) => {
+    // Load config file if specified
+    let config = {};
+    if (options.config) {
+        const configPath = resolve(process.cwd(), options.config);
+        if (existsSync(configPath)) {
+            const configModule = await import(configPath);
+            config = configModule.default || configModule;
+        }
+        else {
+            console.error(`Config file not found: ${configPath}`);
+            process.exit(1);
+        }
+    }
+    // Apply CLI options to config
+    if (options.ignore) {
+        config.ignore = [
+            ...(config.ignore || []),
+            ...options.ignore.split(',').map((s) => s.trim()),
+        ];
+    }
+    // Parse viewports
+    const viewports = options.viewport
+        ? options.viewport.split(',').map((v) => {
+            const [width, height] = v.split('x').map(Number);
+            return { width, height };
+        })
+        : [{ width: 1280, height: 720 }];
+    // Parse checks to run
+    const checksToRun = options.only
+        ? options.only.split(',').map((s) => s.trim())
+        : undefined;
+    // Launch browser (auto-installs Chromium if needed)
+    const browser = await launchBrowser({
+        headless: !options.headed,
+    });
+    let hasFailures = false;
+    try {
+        for (const url of urls) {
+            for (const viewport of viewports) {
+                const page = await browser.newPage();
+                await page.setViewport(viewport);
+                try {
+                    // Navigate to URL
+                    const fullUrl = url.startsWith('http') || url.startsWith('file://') ? url : `https://${url}`;
+                    await page.goto(fullUrl, { waitUntil: 'networkidle0' });
+                    // Wait for hydration if requested
+                    if (options.waitForHydration) {
+                        console.log(chalk.dim('Waiting for hydration...'));
+                        const framework = options.framework;
+                        await waitForHydration(page, framework);
+                    }
+                    // Wait a bit for any animations/transitions
+                    await new Promise(r => setTimeout(r, 500));
+                    // Run checks
+                    const results = await runChecks(page, {
+                        config,
+                        checks: checksToRun,
+                    });
+                    // Output results
+                    console.log(formatResults(results, options.format));
+                    // Check for failures based on fail-on option
+                    if (options.failOn === 'error' && results.summary.errors > 0) {
+                        hasFailures = true;
+                    }
+                    else if (options.failOn === 'warning' && (results.summary.errors > 0 || results.summary.warnings > 0)) {
+                        hasFailures = true;
+                    }
+                }
+                catch (error) {
+                    console.error(`Error checking ${url}:`, error);
+                    hasFailures = true;
+                }
+                finally {
+                    await page.close();
+                }
+            }
+        }
+    }
+    finally {
+        await browser.close();
+    }
+    process.exit(hasFailures ? 1 : 0);
+});
+// Dev command - auto-detect framework and start dev server
+program
+    .command('dev')
+    .description('Auto-detect framework, start dev server, and check routes')
+    .option('-r, --routes <routes>', 'Comma-separated routes to check (default: /)', '/')
+    .option('-p, --port <port>', 'Dev server port (uses framework default if not specified)')
+    .option('-f, --format <format>', 'Output format: text, json, junit', 'text')
+    .option('-o, --only <checks>', 'Only run specific checks (comma-separated)')
+    .option('-i, --ignore <selectors>', 'Ignore elements matching selectors (comma-separated)')
+    .option('-v, --viewport <size>', 'Viewport size (e.g., 1920x1080)', '1280x720')
+    .option('--framework <framework>', 'Specify framework manually (nextjs, sveltekit, vite, etc.)')
+    .option('--wait-for-hydration', 'Wait for SPA hydration (default: auto-detect based on framework)')
+    .option('--no-wait-for-hydration', 'Skip waiting for hydration')
+    .option('--no-start-server', 'Skip starting dev server (assume it\'s already running)')
+    .option('--fail-on <severity>', 'Exit with error if issues found: error, warning', 'error')
+    .option('--headed', 'Run browser in headed mode (visible)')
+    .action(async (options) => {
+    await runDevCheck(options);
+});
+async function runDevCheck(options) {
+    // Detect or use specified framework
+    const frameworkInfo = getFrameworkInfo();
+    const framework = options.framework || frameworkInfo.name;
+    if (framework === 'unknown') {
+        console.error(chalk.red('Error:'), 'Could not detect framework. Please specify with --framework flag.');
+        console.error(chalk.dim('Supported frameworks: nextjs, sveltekit, vite, create-react-app, remix, astro, nuxt'));
+        process.exit(1);
+    }
+    console.log(chalk.bold(`\nrlint dev`));
+    console.log(chalk.dim(`Framework: ${frameworkInfo.displayName}${frameworkInfo.version ? ` v${frameworkInfo.version}` : ''}`));
+    let server = null;
+    let baseUrl;
+    try {
+        // Start dev server if needed
+        if (options.startServer !== false) {
+            console.log(chalk.dim('Starting dev server...'));
+            const port = options.port ? parseInt(options.port, 10) : undefined;
+            server = await startDevServer({ framework, port });
+            baseUrl = server.baseUrl;
+            console.log(chalk.green(`Dev server running at ${baseUrl}`));
+        }
+        else {
+            const port = options.port || frameworkInfo.defaultPort.toString();
+            baseUrl = `http://localhost:${port}`;
+            console.log(chalk.dim(`Using existing server at ${baseUrl}`));
+        }
+        // Parse routes
+        const routes = options.routes?.split(',').map((r) => r.trim()) || ['/'];
+        // Parse viewport
+        const [width, height] = (options.viewport || '1280x720').split('x').map(Number);
+        const viewport = { width, height };
+        // Launch browser (auto-installs Chromium if needed)
+        const browser = await launchBrowser({
+            headless: !options.headed,
+        });
+        try {
+            // Determine if we should wait for hydration
+            const shouldWaitForHydration = options.waitForHydration !== undefined
+                ? options.waitForHydration
+                : needsHydration(framework);
+            // Build config
+            const config = {};
+            if (options.ignore) {
+                config.ignore = options.ignore.split(',').map((s) => s.trim());
+            }
+            const checksToRun = options.only?.split(',').map((s) => s.trim());
+            let hasErrors = false;
+            let hasWarnings = false;
+            const allResults = [];
+            // Check each route
+            for (const route of routes) {
+                const url = `${baseUrl}${route.startsWith('/') ? route : '/' + route}`;
+                console.log(chalk.dim(`\nChecking ${route}...`));
+                const page = await browser.newPage();
+                await page.setViewport(viewport);
+                try {
+                    await page.goto(url, { waitUntil: 'domcontentloaded' });
+                    // Wait for hydration if needed
+                    if (shouldWaitForHydration) {
+                        console.log(chalk.dim('Waiting for hydration...'));
+                        await waitForHydration(page, framework);
+                    }
+                    // Wait a bit for any animations/transitions
+                    await new Promise(r => setTimeout(r, 500));
+                    // Run checks
+                    const results = await runChecks(page, {
+                        config,
+                        checks: checksToRun,
+                    });
+                    const output = formatResults(results, options.format);
+                    allResults.push({
+                        route,
+                        output,
+                        errors: results.summary.errors,
+                        warnings: results.summary.warnings,
+                    });
+                    if (results.summary.errors > 0) {
+                        hasErrors = true;
+                    }
+                    if (results.summary.warnings > 0) {
+                        hasWarnings = true;
+                    }
+                }
+                finally {
+                    await page.close();
+                }
+            }
+            // Output all results
+            console.log(chalk.bold('\n' + '='.repeat(60)));
+            console.log(chalk.bold('Results'));
+            console.log('='.repeat(60));
+            for (const { route, output } of allResults) {
+                console.log(chalk.bold(`\nRoute: ${route}`));
+                console.log(output);
+            }
+            // Summary
+            const totalErrors = allResults.reduce((sum, r) => sum + r.errors, 0);
+            const totalWarnings = allResults.reduce((sum, r) => sum + r.warnings, 0);
+            console.log(chalk.bold('\nSummary:'));
+            console.log(`  Routes checked: ${allResults.length}`);
+            if (totalErrors > 0) {
+                console.log(chalk.red(`  Total errors: ${totalErrors}`));
+            }
+            if (totalWarnings > 0) {
+                console.log(chalk.yellow(`  Total warnings: ${totalWarnings}`));
+            }
+            if (totalErrors === 0 && totalWarnings === 0) {
+                console.log(chalk.green('  All checks passed!'));
+            }
+            // Determine exit code based on fail-on option
+            let shouldFail = false;
+            if (options.failOn === 'error' && hasErrors) {
+                shouldFail = true;
+            }
+            else if (options.failOn === 'warning' && (hasErrors || hasWarnings)) {
+                shouldFail = true;
+            }
+            if (shouldFail) {
+                process.exit(1);
+            }
+        }
+        finally {
+            await browser.close();
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+    finally {
+        // Stop dev server if we started it
+        if (server) {
+            console.log(chalk.dim('\nStopping dev server...'));
+            await server.stop();
+        }
+    }
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/frameworks/detector.d.ts

@@ -0,0 +1,19 @@
+export type FrameworkName = 'nextjs' | 'sveltekit' | 'vite' | 'create-react-app' | 'remix' | 'astro' | 'nuxt' | 'unknown';
+export interface DetectedFramework {
+    name: FrameworkName;
+    version: string | null;
+    configFile: string | null;
+}
+/**
+ * Auto-detect the framework from package.json or config files
+ */
+export declare function detectFramework(projectPath?: string): DetectedFramework;
+/**
+ * Check if a framework uses SPA hydration (needs to wait for JS)
+ */
+export declare function needsHydration(framework: FrameworkName): boolean;
+/**
+ * Get the default port for a framework's dev server
+ */
+export declare function getDefaultPort(framework: FrameworkName): number;
+//# sourceMappingURL=detector.d.ts.map

package/dist/frameworks/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/frameworks/detector.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,WAAW,GACX,MAAM,GACN,kBAAkB,GAClB,OAAO,GACP,OAAO,GACP,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAOD;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,GAAE,MAAsB,GAAG,iBAAiB,CAsFtF;AAuBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAmB/D"}

package/dist/frameworks/detector.js

@@ -0,0 +1,132 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Auto-detect the framework from package.json or config files
+ */
+export function detectFramework(projectPath = process.cwd()) {
+    const packageJsonPath = join(projectPath, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return { name: 'unknown', version: null, configFile: null };
+    }
+    let packageJson;
+    try {
+        packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    }
+    catch {
+        return { name: 'unknown', version: null, configFile: null };
+    }
+    const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+    // Check for Next.js
+    if (deps['next']) {
+        const configFile = findConfigFile(projectPath, ['next.config.js', 'next.config.mjs', 'next.config.ts']);
+        return {
+            name: 'nextjs',
+            version: cleanVersion(deps['next']),
+            configFile,
+        };
+    }
+    // Check for SvelteKit
+    if (deps['@sveltejs/kit']) {
+        const configFile = findConfigFile(projectPath, ['svelte.config.js', 'svelte.config.ts']);
+        return {
+            name: 'sveltekit',
+            version: cleanVersion(deps['@sveltejs/kit']),
+            configFile,
+        };
+    }
+    // Check for Nuxt
+    if (deps['nuxt'] || deps['nuxt3']) {
+        const configFile = findConfigFile(projectPath, ['nuxt.config.js', 'nuxt.config.ts']);
+        return {
+            name: 'nuxt',
+            version: cleanVersion(deps['nuxt'] || deps['nuxt3']),
+            configFile,
+        };
+    }
+    // Check for Remix
+    if (deps['@remix-run/react'] || deps['remix']) {
+        const configFile = findConfigFile(projectPath, ['remix.config.js', 'remix.config.ts']);
+        return {
+            name: 'remix',
+            version: cleanVersion(deps['@remix-run/react'] || deps['remix']),
+            configFile,
+        };
+    }
+    // Check for Astro
+    if (deps['astro']) {
+        const configFile = findConfigFile(projectPath, ['astro.config.mjs', 'astro.config.ts', 'astro.config.js']);
+        return {
+            name: 'astro',
+            version: cleanVersion(deps['astro']),
+            configFile,
+        };
+    }
+    // Check for Create React App (react-scripts)
+    if (deps['react-scripts']) {
+        return {
+            name: 'create-react-app',
+            version: cleanVersion(deps['react-scripts']),
+            configFile: null,
+        };
+    }
+    // Check for Vite (generic)
+    if (deps['vite']) {
+        const configFile = findConfigFile(projectPath, ['vite.config.js', 'vite.config.ts', 'vite.config.mjs']);
+        return {
+            name: 'vite',
+            version: cleanVersion(deps['vite']),
+            configFile,
+        };
+    }
+    return { name: 'unknown', version: null, configFile: null };
+}
+/**
+ * Find the first existing config file from a list of possible names
+ */
+function findConfigFile(projectPath, possibleNames) {
+    for (const name of possibleNames) {
+        const filePath = join(projectPath, name);
+        if (existsSync(filePath)) {
+            return filePath;
+        }
+    }
+    return null;
+}
+/**
+ * Clean version string (remove ^ ~ etc.)
+ */
+function cleanVersion(version) {
+    if (!version)
+        return null;
+    return version.replace(/^[\^~>=<]+/, '');
+}
+/**
+ * Check if a framework uses SPA hydration (needs to wait for JS)
+ */
+export function needsHydration(framework) {
+    return ['nextjs', 'sveltekit', 'remix', 'nuxt', 'create-react-app', 'astro'].includes(framework);
+}
+/**
+ * Get the default port for a framework's dev server
+ */
+export function getDefaultPort(framework) {
+    switch (framework) {
+        case 'nextjs':
+            return 3000;
+        case 'sveltekit':
+            return 5173;
+        case 'vite':
+            return 5173;
+        case 'create-react-app':
+            return 3000;
+        case 'remix':
+            return 3000;
+        case 'astro':
+            return 4321;
+        case 'nuxt':
+            return 3000;
+        default:
+            return 3000;
+    }
+}
+//# sourceMappingURL=detector.js.map

package/dist/frameworks/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/frameworks/detector.ts"],"names":[],"mappings":"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"}

package/dist/frameworks/index.d.ts

@@ -0,0 +1,44 @@
+import type { Page } from 'puppeteer-core';
+import type { ChildProcess } from 'node:child_process';
+export { detectFramework, needsHydration, getDefaultPort } from './detector.js';
+export type { FrameworkName, DetectedFramework } from './detector.js';
+export * as next from './next.js';
+export * as sveltekit from './sveltekit.js';
+export * as vite from './vite.js';
+import { type FrameworkName } from './detector.js';
+export interface DevServerOptions {
+    framework?: FrameworkName;
+    port?: number;
+    projectPath?: string;
+    host?: string;
+}
+export interface DevServer {
+    framework: FrameworkName;
+    process: ChildProcess | null;
+    port: number;
+    baseUrl: string;
+    stop: () => Promise<void>;
+}
+/**
+ * Unified interface to start any framework's dev server
+ */
+export declare function startDevServer(options?: DevServerOptions): Promise<DevServer>;
+/**
+ * Unified interface to wait for hydration
+ */
+export declare function waitForHydration(page: Page, framework?: FrameworkName, timeout?: number): Promise<void>;
+/**
+ * Get routes for the detected framework
+ */
+export declare function getRoutes(framework?: FrameworkName, projectPath?: string): string[];
+/**
+ * Framework information for display
+ */
+export declare function getFrameworkInfo(projectPath?: string): {
+    name: FrameworkName;
+    version: string | null;
+    displayName: string;
+    needsHydration: boolean;
+    defaultPort: number;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/frameworks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/frameworks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAmD,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAKpG,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAwDvF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,SAAS,CAAC,EAAE,aAAa,EACzB,OAAO,SAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAenF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACtD,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAsBA"}

package/dist/frameworks/index.js

@@ -0,0 +1,138 @@
+// Re-export all framework utilities
+export { detectFramework, needsHydration, getDefaultPort } from './detector.js';
+export * as next from './next.js';
+export * as sveltekit from './sveltekit.js';
+export * as vite from './vite.js';
+// Import for unified interface
+import { detectFramework, getDefaultPort, needsHydration } from './detector.js';
+import * as next from './next.js';
+import * as sveltekit from './sveltekit.js';
+import * as vite from './vite.js';
+/**
+ * Unified interface to start any framework's dev server
+ */
+export async function startDevServer(options = {}) {
+    const projectPath = options.projectPath || process.cwd();
+    const detected = detectFramework(projectPath);
+    const framework = options.framework || detected.name;
+    const port = options.port || getDefaultPort(framework);
+    switch (framework) {
+        case 'nextjs': {
+            const server = await next.startNextServer({ port, projectPath });
+            return {
+                framework,
+                process: server.process,
+                port: server.port,
+                baseUrl: server.baseUrl,
+                stop: server.stop,
+            };
+        }
+        case 'sveltekit': {
+            const server = await sveltekit.startSvelteKitServer({
+                port,
+                projectPath,
+                host: options.host,
+            });
+            return {
+                framework,
+                process: server.process,
+                port: server.port,
+                baseUrl: server.baseUrl,
+                stop: server.stop,
+            };
+        }
+        case 'vite':
+        case 'create-react-app':
+        case 'remix':
+        case 'astro':
+        case 'nuxt': {
+            // These all use Vite or similar dev servers
+            const server = await vite.startViteServer({
+                port,
+                projectPath,
+                host: options.host,
+            });
+            return {
+                framework,
+                process: server.process,
+                port: server.port,
+                baseUrl: server.baseUrl,
+                stop: server.stop,
+            };
+        }
+        default:
+            throw new Error(`Unknown framework: ${framework}. Cannot start dev server.`);
+    }
+}
+/**
+ * Unified interface to wait for hydration
+ */
+export async function waitForHydration(page, framework, timeout = 10000) {
+    const projectPath = process.cwd();
+    const detected = detectFramework(projectPath);
+    const fw = framework || detected.name;
+    if (!needsHydration(fw)) {
+        // For static sites or unknown frameworks, just wait for load
+        await page.waitForFunction(() => document.readyState === 'complete' || document.readyState === 'interactive');
+        return;
+    }
+    switch (fw) {
+        case 'nextjs':
+            await next.waitForHydration(page, timeout);
+            break;
+        case 'sveltekit':
+            await sveltekit.waitForHydration(page, timeout);
+            break;
+        case 'vite':
+        case 'create-react-app':
+        case 'remix':
+        case 'astro':
+        case 'nuxt':
+            await vite.waitForHydration(page, timeout);
+            break;
+        default:
+            // Fallback: wait for document ready
+            await page.waitForFunction(() => document.readyState === 'complete' || document.readyState === 'interactive');
+    }
+}
+/**
+ * Get routes for the detected framework
+ */
+export function getRoutes(framework, projectPath) {
+    const path = projectPath || process.cwd();
+    const detected = detectFramework(path);
+    const fw = framework || detected.name;
+    switch (fw) {
+        case 'nextjs':
+            return next.getRoutes(path);
+        case 'sveltekit':
+            return sveltekit.getRoutes(path);
+        default:
+            return ['/'];
+    }
+}
+/**
+ * Framework information for display
+ */
+export function getFrameworkInfo(projectPath) {
+    const path = projectPath || process.cwd();
+    const detected = detectFramework(path);
+    const displayNames = {
+        nextjs: 'Next.js',
+        sveltekit: 'SvelteKit',
+        vite: 'Vite',
+        'create-react-app': 'Create React App',
+        remix: 'Remix',
+        astro: 'Astro',
+        nuxt: 'Nuxt',
+        unknown: 'Unknown',
+    };
+    return {
+        name: detected.name,
+        version: detected.version,
+        displayName: displayNames[detected.name],
+        needsHydration: needsHydration(detected.name),
+        defaultPort: getDefaultPort(detected.name),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/frameworks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/frameworks/index.ts"],"names":[],"mappings":"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"}