specweave 1.0.71 → 1.0.72

package/dist/src/core/auto/e2e-coverage.d.ts

@@ -0,0 +1,248 @@
+/**
+ * E2E Coverage Manifest
+ *
+ * Tracks which routes, actions, and viewports have E2E test coverage.
+ * Auto-generates manifest from project routes (Next.js, React Router, etc.).
+ *
+ * @module e2e-coverage
+ */
+export interface RouteEntry {
+    path: string;
+    tested: boolean;
+    viewports: string[];
+    lastTested?: string;
+}
+export interface ActionEntry {
+    id: string;
+    description: string;
+    tested: boolean;
+    lastTested?: string;
+}
+export interface ViewportsCovered {
+    mobile: boolean;
+    tablet: boolean;
+    desktop: boolean;
+}
+export interface CoverageStats {
+    routes: number;
+    actions: number;
+    viewports: number;
+}
+export interface E2ECoverageManifest {
+    version: string;
+    generatedAt: string;
+    framework?: string;
+    routes: Record<string, RouteEntry>;
+    criticalActions: Record<string, ActionEntry>;
+    viewportsCovered: ViewportsCovered;
+    coverage: CoverageStats;
+}
+export type FrameworkType = 'nextjs-pages' | 'nextjs-app' | 'react-router' | 'vue-router' | 'svelte-kit' | 'remix' | 'unknown';
+/**
+ * Default viewports for responsive testing
+ */
+export declare const DEFAULT_VIEWPORTS: {
+    mobile: {
+        width: number;
+        height: number;
+    };
+    tablet: {
+        width: number;
+        height: number;
+    };
+    desktop: {
+        width: number;
+        height: number;
+    };
+};
+/**
+ * Detect which frontend framework is being used
+ *
+ * @param projectPath - Project root path
+ * @returns Detected framework type
+ */
+export declare function detectFramework(projectPath: string): FrameworkType;
+/**
+ * Extract routes from project based on detected framework
+ *
+ * @param projectPath - Project root path
+ * @param framework - Optional framework override
+ * @returns Array of route paths
+ */
+export declare function extractRoutes(projectPath: string, framework?: FrameworkType): string[];
+/**
+ * Load manual routes override from routes.json
+ */
+export declare function loadManualRoutes(projectPath: string): string[] | null;
+/**
+ * Generate E2E coverage manifest
+ *
+ * @param projectPath - Project root path
+ * @param options - Generation options
+ * @returns Generated manifest
+ *
+ * @example
+ * ```typescript
+ * const manifest = generateCoverageManifest('/path/to/project');
+ * console.log(manifest.coverage.routes); // Coverage percentage
+ * ```
+ */
+export declare function generateCoverageManifest(projectPath: string, options?: {
+    framework?: FrameworkType;
+    includeActions?: boolean;
+}): E2ECoverageManifest;
+/**
+ * Save manifest to state directory
+ */
+export declare function saveManifest(projectPath: string, manifest: E2ECoverageManifest): void;
+/**
+ * Load existing manifest from state directory
+ */
+export declare function loadManifest(projectPath: string): E2ECoverageManifest | null;
+/**
+ * Update route coverage in manifest
+ */
+export declare function updateRouteCoverage(manifest: E2ECoverageManifest, route: string, viewports?: string[]): E2ECoverageManifest;
+/**
+ * Calculate coverage statistics
+ */
+export declare function calculateCoverage(manifest: E2ECoverageManifest): CoverageStats;
+/**
+ * Get untested routes
+ */
+export declare function getUntestedRoutes(manifest: E2ECoverageManifest): string[];
+/**
+ * Get routes missing viewport coverage
+ */
+export declare function getRoutesWithMissingViewports(manifest: E2ECoverageManifest): {
+    route: string;
+    missingViewports: string[];
+}[];
+/**
+ * Route visit detected in test output
+ */
+export interface RouteVisit {
+    route: string;
+    viewport?: string;
+    timestamp?: string;
+}
+/**
+ * Result of parsing test output for route visits
+ */
+export interface RouteTrackingResult {
+    visits: RouteVisit[];
+    manifest: E2ECoverageManifest;
+    newlyTested: string[];
+    viewportUpdates: {
+        route: string;
+        viewport: string;
+    }[];
+}
+/**
+ * Parse Playwright test output to extract visited routes
+ *
+ * Looks for patterns like:
+ * - page.goto('http://localhost:3000/login')
+ * - await page.goto('/dashboard')
+ * - navigating to "http://localhost:3000/products"
+ * - → /api/users (XHR) - skip API routes
+ *
+ * @param output - Test output (stdout/stderr combined)
+ * @param baseUrl - Optional base URL to normalize routes
+ * @returns Array of route visits
+ */
+export declare function parseRouteVisits(output: string, baseUrl?: string): RouteVisit[];
+/**
+ * Match a visited route against manifest routes (handling dynamic segments)
+ *
+ * @param visitedRoute - The actual route visited (e.g., "/products/123")
+ * @param manifestRoutes - Routes in manifest (may include :params like "/products/:id")
+ * @returns Matched manifest route or null
+ */
+export declare function matchRouteToManifest(visitedRoute: string, manifestRoutes: string[]): string | null;
+/**
+ * Track route coverage from test output
+ *
+ * Parses test output, extracts route visits, and updates manifest.
+ *
+ * @param projectPath - Project root path
+ * @param testOutput - Raw test output
+ * @param options - Tracking options
+ * @returns Tracking result with updated manifest
+ *
+ * @example
+ * ```typescript
+ * const result = trackRouteCoverage('/path/to/project', testOutput);
+ * console.log(`Tested ${result.newlyTested.length} new routes`);
+ * ```
+ */
+export declare function trackRouteCoverage(projectPath: string, testOutput: string, options?: {
+    baseUrl?: string;
+    viewport?: string;
+}): RouteTrackingResult;
+/**
+ * Parse viewport from Playwright project name
+ *
+ * @param projectName - Playwright project name from config or output
+ * @returns Normalized viewport name
+ */
+export declare function parseViewportFromProject(projectName: string): string;
+/**
+ * Generate coverage report from manifest
+ *
+ * @param manifest - E2E coverage manifest
+ * @returns Formatted coverage report
+ */
+/**
+ * Playwright project/viewport configuration
+ */
+export interface PlaywrightViewportConfig {
+    projects: PlaywrightProject[];
+    viewports: {
+        mobile: boolean;
+        tablet: boolean;
+        desktop: boolean;
+    };
+    configPath?: string;
+}
+export interface PlaywrightProject {
+    name: string;
+    viewport: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * Parse Playwright config to extract viewport/project configuration
+ *
+ * @param projectPath - Project root path
+ * @returns Parsed viewport configuration
+ *
+ * @example
+ * ```typescript
+ * const config = parsePlaywrightConfig('/path/to/project');
+ * console.log(config.viewports.mobile); // true if mobile viewport configured
+ * ```
+ */
+export declare function parsePlaywrightConfig(projectPath: string): PlaywrightViewportConfig;
+/**
+ * Get required viewports from config or defaults
+ *
+ * @param projectPath - Project root path
+ * @returns Array of required viewport names
+ */
+export declare function getRequiredViewports(projectPath: string): string[];
+/**
+ * Check if viewport coverage meets requirements
+ *
+ * @param manifest - E2E coverage manifest
+ * @param projectPath - Project root path
+ * @returns Coverage check result
+ */
+export declare function checkViewportCoverage(manifest: E2ECoverageManifest, projectPath: string): {
+    complete: boolean;
+    required: string[];
+    covered: string[];
+    missing: string[];
+};
+export declare function generateCoverageReport(manifest: E2ECoverageManifest): string;
+//# sourceMappingURL=e2e-coverage.d.ts.map

package/dist/src/core/auto/e2e-coverage.d.ts.map

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