@tayo-dev/rtl 1.0.0

package/dist/core/generator.js

@@ -0,0 +1,173 @@
+/**
+ * RTL test code generation
+ * Converts NormalizedRecording into valid React Testing Library test code.
+ *
+ * Query priority (accessibility-first):
+ *   getByRole > getByLabelText > getByText > getByPlaceholderText > getByTestId
+ */
+import { importBlock, describeBlock, stepTemplate, describeBlockMultiIt, } from '../templates/test-template.js';
+import pc from 'picocolors';
+/** Convert a CSS selector to an RTL screen query string. */
+function selectorToQuery(selector) {
+    if (!selector)
+        return 'document.body';
+    // data-testid attribute
+    const testIdMatch = selector.match(/\[data-testid=['"]?([^'"[\]]+)['"]?\]/);
+    if (testIdMatch)
+        return `screen.getByTestId('${testIdMatch[1]}')`;
+    // aria-label attribute
+    const ariaLabelMatch = selector.match(/\[aria-label=['"]?([^'"[\]]+)['"]?\]/);
+    if (ariaLabelMatch)
+        return `screen.getByLabelText('${ariaLabelMatch[1]}')`;
+    // aria-labelledby falls back to getByLabelText with regex
+    if (selector.includes('[aria-labelledby')) {
+        return `screen.getByLabelText(/* aria-labelledby */ /./)`;
+    }
+    // Element-level role inference
+    if (/(?:^|[\s>])button(?:[^a-z]|$)|\[type=['"]?(?:button|submit)['"]?\]/.test(selector)) {
+        return `screen.getByRole('button')`;
+    }
+    if (/(?:^|[\s>])a(?:[^a-z]|$)/.test(selector)) {
+        return `screen.getByRole('link')`;
+    }
+    if (/\[type=['"]?checkbox['"]?\]/.test(selector)) {
+        return `screen.getByRole('checkbox')`;
+    }
+    if (/\[type=['"]?radio['"]?\]/.test(selector)) {
+        return `screen.getByRole('radio')`;
+    }
+    if (/(?:^|[\s>])select(?:[^a-z]|$)/.test(selector)) {
+        return `screen.getByRole('combobox')`;
+    }
+    if (/(?:^|[\s>])input(?:[^a-z]|$)|\[type=['"]?(?:text|email|password|search|tel|url)['"]?\]/.test(selector)) {
+        return `screen.getByRole('textbox')`;
+    }
+    if (/(?:^|[\s>])textarea(?:[^a-z]|$)/.test(selector)) {
+        return `screen.getByRole('textbox')`;
+    }
+    if (/(?:^|[\s>])h[1-6](?:[^a-z]|$)/.test(selector)) {
+        return `screen.getByRole('heading')`;
+    }
+    if (/(?:^|[\s>])img(?:[^a-z]|$)/.test(selector)) {
+        return `screen.getByRole('img')`;
+    }
+    // Last resort: escape the selector and use as getByTestId placeholder
+    const escaped = selector.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    return `screen.getByTestId(/* TODO: replace with RTL query — CSS: '${escaped}' */ '')`;
+}
+function isQueryExpression(target) {
+    return /^(screen|document)\./.test(target);
+}
+function looksLikeCssSelector(target) {
+    return (/^[#.[]/.test(target) ||
+        /^[a-z][a-z0-9-]*(?:[.#[:\s>])/i.test(target) ||
+        /^(button|input|select|textarea|a|img|h[1-6])$/i.test(target));
+}
+function reconstructQuery(step) {
+    const target = step.target;
+    if (!target) {
+        return 'document.body';
+    }
+    if (isQueryExpression(target)) {
+        return target;
+    }
+    if (step.source === 'js' && step.action === 'assert' && step.originalType.startsWith('getBy')) {
+        const escapedTarget = target.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+        return step.originalType === 'getByRole'
+            ? `screen.getByRole('${escapedTarget}')`
+            : `screen.${step.originalType}('${escapedTarget}')`;
+    }
+    if (looksLikeCssSelector(target)) {
+        return selectorToQuery(target);
+    }
+    const escapedTarget = target.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    return `screen.getByText('${escapedTarget}')`;
+}
+function generateStepCode(step) {
+    // navigate steps use target (the URL), not the CSS-selector path
+    if (step.action === 'navigate') {
+        return stepTemplate({ action: 'navigate', query: '', value: step.target });
+    }
+    const query = selectorToQuery(step.target);
+    return stepTemplate({ action: step.action, query, value: step.value });
+}
+export function generateTest(recording, options = {}) {
+    const testName = recording.title || 'Generated Test';
+    const hasUserEvents = recording.steps.some((s) => ['click', 'fill', 'select', 'keyDown'].includes(s.action));
+    const stepLines = recording.steps.map((step) => generateStepCode(step));
+    const imports = importBlock(hasUserEvents);
+    const describe = describeBlock(testName, stepLines, hasUserEvents);
+    const code = `${imports}\n\n${describe}\n`;
+    return {
+        code,
+        testName,
+        filePath: options.outputPath,
+    };
+}
+export function emitQuerySummary(queryResults) {
+    if (queryResults.length === 0)
+        return;
+    // Group by method name
+    const grouped = new Map();
+    for (const r of queryResults) {
+        const existing = grouped.get(r.method);
+        if (existing) {
+            grouped.set(r.method, {
+                ...existing,
+                lines: [...existing.lines, ...(r.line !== undefined ? [r.line] : [])],
+            });
+        }
+        else {
+            grouped.set(r.method, {
+                quality: r.quality,
+                lines: r.line !== undefined ? [r.line] : [],
+            });
+        }
+    }
+    // Emit one line per unique query method
+    for (const [method, { quality, lines }] of grouped) {
+        const count = queryResults.filter((r) => r.method === method).length;
+        const lineInfo = quality === 'fragile' && lines.length > 0
+            ? ` — see line${lines.length > 1 ? 's' : ''} ${lines.join(', ')}`
+            : '';
+        console.log(pc.dim('[taro]') +
+            ` ${count} ${method} (${quality}${lineInfo})`);
+    }
+}
+export function generateTestFromGroups(title, itGroups, options = {}) {
+    const { conventions, queryResults = [], outputPath, dryRun } = options;
+    const importStyle = conventions?.importStyle ?? 'esm';
+    // Determine if any it block uses user events
+    const globalHasUserEvents = itGroups.some((group) => group.steps.some((s) => ['click', 'fill', 'select', 'keyDown'].includes(s.action)));
+    // Build query -> matcher map for context-aware assert matchers
+    const matcherMap = new Map();
+    for (const qr of queryResults) {
+        if (qr.matcher) {
+            matcherMap.set(qr.query, qr.matcher);
+        }
+    }
+    // Build ItBlockTemplate[] from ItGroup[]
+    const itBlocks = itGroups.map((group) => {
+        const hasUserEvents = group.steps.some((s) => ['click', 'fill', 'select', 'keyDown'].includes(s.action));
+        const stepLines = group.steps.map((step) => {
+            if (step.action === 'navigate') {
+                return stepTemplate({ action: 'navigate', query: '', value: step.target });
+            }
+            const query = reconstructQuery(step);
+            const matcher = step.action === 'assert' ? matcherMap.get(query) : undefined;
+            return stepTemplate({ action: step.action, query, value: step.value, matcher });
+        });
+        return { name: group.name, stepLines, hasUserEvents };
+    });
+    const imports = importBlock(globalHasUserEvents, importStyle);
+    const describeCode = describeBlockMultiIt(title, itBlocks);
+    const code = `${imports}\n\n${describeCode}\n`;
+    return {
+        code,
+        testName: title,
+        filePath: outputPath,
+        queryResults,
+        itGroupCount: itGroups.length,
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/core/generator.js.map

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

package/dist/core/js-parser.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Babel AST-based parser for Testing Library Recorder JS output.
+ * Parses the JavaScript recording format and produces structured NormalizedRecording.
+ */
+import type { NormalizedStep, QueryQuality, ItGroup } from '../types/recording.js';
+/**
+ * Classifies a Testing Library query method by quality tier.
+ * @param method - The RTL query method name (e.g., 'getByRole', 'getByText')
+ * @returns QueryQuality tier
+ */
+export declare function classifyQuery(method: string): QueryQuality;
+/**
+ * Extracts the environment URL from @jest-environment-options comment.
+ * @param code - The JS file content
+ * @returns The URL string or undefined if not found
+ */
+export declare function extractEnvironmentUrl(code: string): string | undefined;
+/**
+ * Segments steps into ItGroup[] based on modal boundary detection.
+ * Modal boundary: click + assert with matching target name (within 1-2 steps)
+ * @param steps - Normalized steps to segment
+ * @returns Array of ItGroup
+ */
+export declare function segmentIntoItGroups(steps: NormalizedStep[]): ItGroup[];
+/**
+ * Query selector call extracted from AST
+ */
+export interface QuerySelectorCall {
+    selector: string;
+    line: number;
+}
+/**
+ * Result of parsing a JS recording
+ */
+export interface JsParseResult {
+    title: string;
+    environmentUrl: string | undefined;
+    steps: NormalizedStep[];
+    querySelectorCalls: QuerySelectorCall[];
+    itGroups: ItGroup[];
+}
+/**
+ * Parses a Testing Library Recorder JS file into structured result.
+ * @param code - The JavaScript file content
+ * @returns Promise<JsParseResult>
+ */
+export declare function parseJsRecording(code: string): Promise<JsParseResult>;
+//# sourceMappingURL=js-parser.d.ts.map

package/dist/core/js-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-parser.d.ts","sourceRoot":"","sources":["../../src/core/js-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAoB,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAmBpG;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAetE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,CAuDtE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,kBAAkB,EAAE,iBAAiB,EAAE,CAAA;IACvC,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAiCD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiI3E"}

package/dist/core/js-parser.js

@@ -0,0 +1,244 @@
+/**
+ * Babel AST-based parser for Testing Library Recorder JS output.
+ * Parses the JavaScript recording format and produces structured NormalizedRecording.
+ */
+import * as babelParser from '@babel/parser';
+import _traverse from '@babel/traverse';
+// ESM interop for @babel/traverse
+const traverse = _traverse.default ?? _traverse;
+/**
+ * Quality classification map for RTL query methods
+ */
+const QUERY_QUALITY_MAP = {
+    getByRole: 'excellent',
+    getByLabelText: 'excellent',
+    getByAltText: 'excellent',
+    getByTitle: 'acceptable',
+    getByText: 'good',
+    getByDisplayValue: 'acceptable',
+    getByPlaceholderText: 'acceptable',
+    getByTestId: 'fragile',
+};
+/**
+ * Classifies a Testing Library query method by quality tier.
+ * @param method - The RTL query method name (e.g., 'getByRole', 'getByText')
+ * @returns QueryQuality tier
+ */
+export function classifyQuery(method) {
+    return QUERY_QUALITY_MAP[method] ?? 'fragile';
+}
+/**
+ * Extracts the environment URL from @jest-environment-options comment.
+ * @param code - The JS file content
+ * @returns The URL string or undefined if not found
+ */
+export function extractEnvironmentUrl(code) {
+    const match = code.match(/@jest-environment-options\s*(\{[^}]+\})/);
+    if (!match) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(match[1]);
+        if (typeof parsed.url === 'string') {
+            return parsed.url;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Segments steps into ItGroup[] based on modal boundary detection.
+ * Modal boundary: click + assert with matching target name (within 1-2 steps)
+ * @param steps - Normalized steps to segment
+ * @returns Array of ItGroup
+ */
+export function segmentIntoItGroups(steps) {
+    if (steps.length === 0) {
+        return [];
+    }
+    const groups = [];
+    let current = [];
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        // Check for modal boundary BEFORE adding current step
+        // Boundary: current step is click, next step is assert with matching target
+        const next = steps[i + 1];
+        const isBoundary = step.action === 'click' &&
+            step.target &&
+            next &&
+            next.action === 'assert' &&
+            next.target &&
+            next.target.toLowerCase().includes(step.target.toLowerCase());
+        if (isBoundary) {
+            // Check that there's no navigate between click and assert
+            const hasNavigateBetween = false; // immediate next step is assert
+            if (!hasNavigateBetween) {
+                // Close current group (everything before the boundary click)
+                if (current.length > 0) {
+                    groups.push({ name: current[0]?.target ?? 'flow', steps: current });
+                }
+                // Start new group with the boundary click
+                current = [step];
+                // Add the assert too
+                current.push(next);
+                i++; // Skip the assert since we added it
+                continue;
+            }
+        }
+        current.push(step);
+    }
+    // Push remaining steps as final group
+    if (current.length > 0) {
+        groups.push({ name: current[0]?.target ?? 'recorded flow', steps: current });
+    }
+    // If no boundaries found, return single group with all steps
+    if (groups.length === 0 && steps.length > 0) {
+        return [{ name: 'recorded flow', steps }];
+    }
+    return groups;
+}
+/**
+ * Extracts a string argument from a Babel AST node
+ */
+function extractStringArg(node) {
+    if (!node)
+        return undefined;
+    if (node.type === 'StringLiteral') {
+        return node.value;
+    }
+    if (node.type === 'TemplateLiteral' && node.quasis.length > 0) {
+        return node.quasis[0].value.cooked;
+    }
+    return undefined;
+}
+/**
+ * Maps userEvent method calls to NormalizedAction
+ */
+function mapUserEventCall(method) {
+    const mapping = {
+        click: 'click',
+        dblClick: 'click',
+        tripleClick: 'click',
+        type: 'fill',
+        keyboard: 'keyDown',
+        selectOptions: 'select',
+        clear: 'fill',
+    };
+    return mapping[method] ?? 'unknown';
+}
+/**
+ * Parses a Testing Library Recorder JS file into structured result.
+ * @param code - The JavaScript file content
+ * @returns Promise<JsParseResult>
+ */
+export async function parseJsRecording(code) {
+    // Validate: detect JSON input
+    const trimmed = code.trim();
+    if (trimmed.startsWith('{')) {
+        throw new Error('Expected JS file from Testing Library Recorder extension. Got JSON — use the Chrome Recorder JSON parser instead.');
+    }
+    // Extract environment URL
+    const environmentUrl = extractEnvironmentUrl(code);
+    // Extract title from file
+    let title = 'Recorded Flow';
+    const titleMatch = code.match(/\/\*\*\s*\n\s*\*\s*([^@\*]+)/);
+    if (titleMatch) {
+        title = titleMatch[1].trim();
+        // Sanitize: strip date suffix and replace hyphens
+        title = title.replace(/\s+at\s+\d{1,2}:\d{2}:\d{2}/, '').replace(/-/g, ' ');
+    }
+    // Parse with Babel
+    const ast = babelParser.parse(code, {
+        sourceType: 'commonjs',
+    });
+    const steps = [];
+    const querySelectorCalls = [];
+    // Traverse AST
+    traverse(ast, {
+        CallExpression(path) {
+            const callee = path.node.callee;
+            const line = path.node.loc?.start?.line ?? 0;
+            // Handle screen.getBy* calls
+            if (callee.type === 'MemberExpression' &&
+                callee.object.type === 'Identifier' &&
+                callee.object.name === 'screen' &&
+                callee.property.type === 'Identifier') {
+                const methodName = callee.property.name;
+                if (methodName && methodName.startsWith('getBy')) {
+                    const target = extractStringArg(path.node.arguments[0]);
+                    // All screen queries become asserts in this implementation
+                    steps.push({
+                        action: 'assert',
+                        target: target ?? methodName,
+                        value: undefined,
+                        originalType: methodName,
+                        line,
+                        source: 'js',
+                    });
+                }
+            }
+            // Handle document.querySelector calls
+            if (callee.type === 'MemberExpression' &&
+                callee.object.type === 'Identifier' &&
+                callee.object.name === 'document' &&
+                callee.property.type === 'Identifier' &&
+                callee.property.name === 'querySelector') {
+                const selector = extractStringArg(path.node.arguments[0]);
+                if (selector) {
+                    querySelectorCalls.push({ selector, line });
+                }
+            }
+            // Handle userEvent.* calls
+            if (callee.type === 'MemberExpression' &&
+                callee.object.type === 'Identifier' &&
+                callee.object.name === 'userEvent') {
+                const methodName = callee.property.name;
+                if (methodName) {
+                    const action = mapUserEventCall(methodName);
+                    // Extract target from first argument (element reference)
+                    const target = extractStringArg(path.node.arguments[0]) ?? methodName;
+                    // Extract value from second argument for type/keyboard
+                    const value = extractStringArg(path.node.arguments[1]);
+                    steps.push({
+                        action,
+                        target,
+                        value,
+                        originalType: methodName,
+                        line,
+                        source: 'js',
+                    });
+                }
+            }
+            // Handle await page.goto(url)
+            if (callee.type === 'MemberExpression' &&
+                callee.object.type === 'Identifier' &&
+                callee.object.name === 'page' &&
+                callee.property.type === 'Identifier' &&
+                callee.property.name === 'goto') {
+                const target = extractStringArg(path.node.arguments[0]);
+                if (target) {
+                    steps.push({
+                        action: 'navigate',
+                        target,
+                        value: undefined,
+                        originalType: 'goto',
+                        line,
+                        source: 'js',
+                    });
+                }
+            }
+        },
+    });
+    // Segment into ItGroups
+    const itGroups = segmentIntoItGroups(steps);
+    return {
+        title,
+        environmentUrl,
+        steps,
+        querySelectorCalls,
+        itGroups,
+    };
+}
+//# sourceMappingURL=js-parser.js.map

package/dist/core/js-parser.js.map

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

package/dist/core/mock-intelligence.d.ts

@@ -0,0 +1,14 @@
+import type { ConventionsSchema, MockInstabilityWarning, MockRecommendation, MockTargetUsage, MutationLifecyclePattern } from '../types/conventions.js';
+export interface MockAnalysis {
+    conventions: ConventionsSchema | null;
+    recommendations: MockRecommendation[];
+    repeatedTargets: MockTargetUsage[];
+    mutationLifecycles: MutationLifecyclePattern[];
+    instabilityWarnings: MockInstabilityWarning[];
+}
+export declare function deriveMockRecommendations(targets: MockTargetUsage[]): MockRecommendation[];
+export declare function scanMockTargets(projectRoot: string): Promise<MockTargetUsage[]>;
+export declare function analyzeMutationLifecycle(projectRoot: string): Promise<MutationLifecyclePattern[]>;
+export declare function detectMockInstability(projectRoot: string): Promise<MockInstabilityWarning[]>;
+export declare function analyzeMocks(projectRoot: string): Promise<MockAnalysis>;
+//# sourceMappingURL=mock-intelligence.d.ts.map

package/dist/core/mock-intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-intelligence.d.ts","sourceRoot":"","sources":["../../src/core/mock-intelligence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAElB,eAAe,EACf,wBAAwB,EAEzB,MAAM,yBAAyB,CAAA;AAGhC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACrC,eAAe,EAAE,kBAAkB,EAAE,CAAA;IACrC,eAAe,EAAE,eAAe,EAAE,CAAA;IAClC,kBAAkB,EAAE,wBAAwB,EAAE,CAAA;IAC9C,mBAAmB,EAAE,sBAAsB,EAAE,CAAA;CAC9C;AA8HD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EAAE,GACzB,kBAAkB,EAAE,CActB;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAGrF;AAED,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAGrC;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAGnC;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAc7E"}

package/dist/core/mock-intelligence.js

@@ -0,0 +1,140 @@
+import { relative } from 'node:path';
+import { readConventions, readTestFiles } from './scanner.js';
+const MOCK_TARGET_REGEX = /(?:vi|jest)\.mock\(\s*['"`]([^'"`]+)['"`]/g;
+const MUTATION_TRIGGER_REGEX = /\b(mutate|mutation|submit|save|create|update|delete)\b|mock(?:Resolved|Rejected)Value(?:Once)?\(/i;
+const TEST_BLOCK_REGEX = /\b(?:it|test)\s*\(/g;
+const TEST_SCOPED_MOCK_REGEX = /(?:vi|jest)\.mock\(/i;
+const MOCK_RESET_REGEX = /(?:vi|jest)\.(?:clearAllMocks|resetAllMocks|restoreAllMocks)\(/g;
+const MOCK_CONFIGURATION_REGEX = /\.mock(?:ResolvedValue|RejectedValue|Implementation|ReturnValue)(?:Once)?\(/g;
+const STAGE_PATTERNS = {
+    loading: [/\bisLoading\b/i, /\bloading\b/i, /\bpending\b/i, /\bsubmitting\b/i, /toBeDisabled\(/],
+    success: [
+        /mockResolvedValue(?:Once)?\(/,
+        /\b(success|saved|created|updated|submitted)\b/i,
+        /toHaveBeenCalled(?:Times|With)?\(/,
+    ],
+    error: [
+        /mockRejectedValue(?:Once)?\(/,
+        /throw new Error\(/,
+        /\b(error|failed|failure)\b/i,
+        /role:\s*['"`]alert['"`]/,
+    ],
+};
+function extractMockTargets(content) {
+    return [...content.matchAll(MOCK_TARGET_REGEX)].map((match) => match[1]);
+}
+function countMatches(content, pattern) {
+    return [...content.matchAll(new RegExp(pattern.source, pattern.flags))].length;
+}
+function findStages(content) {
+    return Object.entries(STAGE_PATTERNS)
+        .filter(([, patterns]) => patterns.some((pattern) => pattern.test(content)))
+        .map(([stage]) => stage);
+}
+function scanMockTargetsInFiles(projectRoot, testFiles) {
+    const targets = new Map();
+    for (const file of testFiles) {
+        for (const target of extractMockTargets(file.content)) {
+            const files = targets.get(target) ?? new Set();
+            files.add(relative(projectRoot, file.path));
+            targets.set(target, files);
+        }
+    }
+    return [...targets.entries()]
+        .map(([target, files]) => ({
+        target,
+        files: [...files].sort(),
+        count: files.size,
+    }))
+        .sort((left, right) => right.count - left.count || left.target.localeCompare(right.target));
+}
+function analyzeMutationLifecycleInFiles(projectRoot, testFiles) {
+    return testFiles
+        .filter((file) => MUTATION_TRIGGER_REGEX.test(file.content))
+        .map((file) => {
+        const stages = findStages(file.content);
+        if (stages.length < 2) {
+            return null;
+        }
+        return {
+            file: relative(projectRoot, file.path),
+            stages,
+            evidence: stages.map((stage) => `${stage} cues detected`),
+        };
+    })
+        .filter((entry) => entry !== null)
+        .sort((left, right) => left.file.localeCompare(right.file));
+}
+function detectMockInstabilityInFiles(projectRoot, testFiles) {
+    const warnings = [];
+    for (const file of testFiles) {
+        const relativePath = relative(projectRoot, file.path);
+        const testBodies = file.content.split(TEST_BLOCK_REGEX).slice(1);
+        const scopedMockCount = testBodies.filter((body) => TEST_SCOPED_MOCK_REGEX.test(body)).length;
+        if (scopedMockCount > 0) {
+            warnings.push({
+                file: relativePath,
+                kind: 'recreated-factory',
+                reason: 'Mocks are declared inside test bodies and may recreate factories per test run',
+                evidence: [`${scopedMockCount} test block(s) declare vi.mock/jest.mock`],
+            });
+        }
+        const resetCount = countMatches(file.content, MOCK_RESET_REGEX);
+        const configCount = countMatches(file.content, MOCK_CONFIGURATION_REGEX);
+        if (resetCount > 0 && configCount >= 2) {
+            warnings.push({
+                file: relativePath,
+                kind: 'per-test-churn',
+                reason: 'Mock configuration is reset and redefined repeatedly across tests',
+                evidence: [
+                    `${resetCount} resetAll/clearAll/restoreAll call(s)`,
+                    `${configCount} mock configuration call(s)`,
+                ],
+            });
+        }
+    }
+    return warnings.sort((left, right) => {
+        return left.file.localeCompare(right.file) || left.kind.localeCompare(right.kind);
+    });
+}
+export function deriveMockRecommendations(targets) {
+    return targets.map((target) => {
+        const kind = target.count >= 2 ? 'extract' : 'inline';
+        return {
+            count: target.count,
+            files: target.files,
+            kind,
+            reason: kind === 'extract'
+                ? 'Mock target appears in multiple tests and should be shared'
+                : 'Mock target appears in one place and can stay local to the test',
+            target: target.target,
+        };
+    });
+}
+export async function scanMockTargets(projectRoot) {
+    const testFiles = await readTestFiles(projectRoot);
+    return scanMockTargetsInFiles(projectRoot, testFiles);
+}
+export async function analyzeMutationLifecycle(projectRoot) {
+    const testFiles = await readTestFiles(projectRoot);
+    return analyzeMutationLifecycleInFiles(projectRoot, testFiles);
+}
+export async function detectMockInstability(projectRoot) {
+    const testFiles = await readTestFiles(projectRoot);
+    return detectMockInstabilityInFiles(projectRoot, testFiles);
+}
+export async function analyzeMocks(projectRoot) {
+    const testFiles = await readTestFiles(projectRoot);
+    const [conventions] = await Promise.all([readConventions(projectRoot)]);
+    const targets = scanMockTargetsInFiles(projectRoot, testFiles);
+    const mutationLifecycles = analyzeMutationLifecycleInFiles(projectRoot, testFiles);
+    const instabilityWarnings = detectMockInstabilityInFiles(projectRoot, testFiles);
+    return {
+        conventions,
+        recommendations: deriveMockRecommendations(targets),
+        repeatedTargets: targets.filter((target) => target.count > 1),
+        mutationLifecycles,
+        instabilityWarnings,
+    };
+}
+//# sourceMappingURL=mock-intelligence.js.map