@tayo-dev/rtl 1.0.0

package/README.md

@@ -0,0 +1,250 @@
+# Taro
+
+Generate React Testing Library tests from Chrome Recorder recordings — automatically.
+
+## Introduction
+
+Taro is a CLI tool that reads Chrome DevTools Recorder exports (JSON) and Testing Library Recorder JS files and generates RTL test files. It scores its own output, learns your project's test conventions from existing files, and stores per-project state in a local `.taro/` directory. No server, no cloud — just files.
+
+### Who it is for
+
+- React developers who write tests with `@testing-library/react`
+- Developers who use Chrome DevTools Recorder to capture user flows
+- Teams that want test coverage without spending hours writing boilerplate
+
+### The problem it solves
+
+Recording a user flow in Chrome takes 30 seconds. Translating that recording into a well-structured RTL test takes 20–40 minutes and requires knowing which queries to use, how to assert, and how to match your project's test conventions. Taro closes that gap.
+
+### How it works
+
+1. Record a user flow in Chrome DevTools → Recorder panel.
+2. Export via the Testing Library Recorder extension (`.js`) or as native Chrome Recorder JSON (`.json`).
+3. Run `taro generate ./recording.js`.
+4. Taro writes a `.test.tsx` file next to your recording, scored and convention-aware.
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 18 or later
+- A React project using `@testing-library/react`
+- Chrome DevTools Recorder (built into Chrome — no extension needed for JSON exports)
+
+### Step 1 — Install
+
+```bash
+npm install --save-dev @tayo-dev/rtl
+# or use npx to skip install entirely
+npx @tayo-dev/rtl generate ./my-recording.js
+```
+
+### Step 2 — Record a user flow
+
+Open Chrome DevTools → Recorder panel → click "Start new recording" → perform your user flow (clicks, form fills, navigation) → click "End recording". Then either:
+
+- Export as JSON: click the export button → "JSON" → save as `recording.json`
+- Export via Testing Library Recorder extension: install the extension, click its export button, save as `recording.js`
+
+### Step 3 — Generate the test
+
+```bash
+# Using npx (no install required)
+npx @tayo-dev/rtl generate ./recording.js
+
+# Or if installed globally
+taro generate ./recording.js
+```
+
+Expected output:
+
+```
+Parsed: my user flow — 8 steps
+[taro] Score: 78/100 (B) — query: 80, assertions: 70, structure: 85
+Created: src/components/MyComponent.test.tsx
+[taro] ✓ post-write verified
+```
+
+### What happens next
+
+Taro writes a `.test.tsx` file. On subsequent runs in the same project, it reads `.taro/conventions.json` to match your test style (import style, mock pattern, folder structure) automatically.
+
+## CLI Reference
+
+### `taro generate <file>`
+
+Generates a React Testing Library test from a Chrome Recorder export.
+
+**Arguments:**
+
+| Argument | Description |
+|----------|-------------|
+| `<file>` | Path to the recording file. Accepts Chrome Recorder JSON exports (`.json`) or Testing Library Recorder JS files (`.js`). |
+
+**Options:**
+
+| Flag | Short | Default | Description |
+|------|-------|---------|-------------|
+| `--output <path>` | `-o` | Same directory as input, `{name}.test.tsx` | Override the output file path for the generated test. |
+| `--dry-run` | `-d` | `false` | Print the generated test to stdout and show the score without writing to disk. Useful for previewing output before committing. |
+| `--force` | `-f` | `false` | Overwrite an existing test file. Without this flag, Taro exits with an error if the output file already exists. |
+| `--version` | `-v` | — | Print the installed version and exit. |
+| `--help` | `-h` | — | Display command help and exit. |
+
+**Examples:**
+
+```bash
+# Generate and write a test next to the recording
+taro generate ./recordings/checkout-flow.json
+
+# Preview without writing (dry run)
+taro generate --dry-run ./recordings/checkout-flow.json
+
+# Write to a specific path
+taro generate --output src/__tests__/checkout.test.tsx ./recordings/checkout-flow.json
+
+# Overwrite an existing test
+taro generate --force ./recordings/checkout-flow.json
+```
+
+**Output file naming:**
+If `--output` is not provided, Taro derives the output path from the input file: `{input-dir}/{input-basename}.test.tsx`. For example, `./recordings/login.json` → `./recordings/login.test.tsx`.
+
+**Supported input formats:**
+- Chrome Recorder JSON (`.json`) — exported directly from Chrome DevTools Recorder
+- Testing Library Recorder JS (`.js`) — exported via the Testing Library Recorder Chrome extension; detected by `.js` extension or `@jest-environment-options` header
+
+## Worked Example
+
+### Input: Chrome Recorder export (`login-flow.json`)
+
+Here is a typical Chrome Recorder JSON export capturing a login flow.
+
+```json
+{
+  "title": "login flow",
+  "steps": [
+    { "type": "navigate", "url": "http://localhost:3000/login" },
+    { "type": "click", "selectors": [["aria/Email address"]] },
+    { "type": "change", "value": "user@example.com", "selectors": [["#email"]] },
+    { "type": "click", "selectors": [["aria/Password"]] },
+    { "type": "change", "value": "secret123", "selectors": [["#password"]] },
+    { "type": "click", "selectors": [["aria/Sign in[role=\"button\"]"]] },
+    { "type": "waitForElement", "selectors": [["aria/Welcome back"]] }
+  ]
+}
+```
+
+### Command
+
+```bash
+taro generate ./login-flow.json
+```
+
+### Terminal output
+
+```
+Parsed: login flow — 7 steps
+[taro] Score: 82/100 (B) — query: 90, assertions: 75, structure: 80
+Created: login-flow.test.tsx
+[taro] ✓ post-write verified
+```
+
+### Output: Generated test (`login-flow.test.tsx`)
+
+Taro generates a convention-aware RTL test with accessible queries:
+
+```typescript
+import { render, screen } from '@testing-library/react'
+import userEvent from '@testing-library/user-event'
+import { LoginPage } from '../LoginPage'
+
+describe('login flow', () => {
+  it('should complete login flow', async () => {
+    const user = userEvent.setup()
+    render(<LoginPage />)
+
+    await user.click(screen.getByRole('textbox', { name: /email address/i }))
+    await user.type(screen.getByRole('textbox', { name: /email address/i }), 'user@example.com')
+    await user.click(screen.getByRole('textbox', { name: /password/i }))
+    await user.type(screen.getByRole('textbox', { name: /password/i }), 'secret123')
+    await user.click(screen.getByRole('button', { name: /sign in/i }))
+
+    expect(screen.getByText(/welcome back/i)).toBeInTheDocument()
+  })
+})
+```
+
+### What Taro did here
+
+- Parsed the navigate step and inferred the component under test
+- Upgraded CSS selectors (`#email`, `#password`) to accessible `getByRole` queries using aria attributes from the recording
+- Inferred `userEvent.type()` from change steps and `userEvent.click()` from click steps
+- Mapped the `waitForElement` step to a `toBeInTheDocument()` assertion
+- Scored the output (82/100) and emitted no blocking errors
+
+> **Note:** The component import path (`../LoginPage`) is a placeholder. Taro generates a comment in the file indicating where to update it.
+
+## Using Taro as a Claude Code Skill
+
+### Overview
+
+Taro works naturally as a Claude Code skill. You can instruct Claude to run `taro generate` on a recording file and it will generate the test, report the score, and surface any quality hints — all in a single agent turn.
+
+### Option A: Direct invocation (no setup required)
+
+Claude Code can invoke Taro directly using the Bash tool. No skill configuration is needed — Claude calls npx inline. Simply give Claude a prompt like:
+
+```
+Run: npx @tayo-dev/rtl generate ./recordings/checkout-flow.js
+Then report the score and the path of the generated file.
+```
+
+### Option B: Register as a Claude Code skill
+
+Registering Taro as a skill lets Claude invoke it by name without knowing the full command.
+
+**Step 1** — Create the skill file at `.claude/skills/taro/SKILL.md` in your project:
+
+```markdown
+# Taro — RTL Test Generator
+
+## Purpose
+Generate a React Testing Library test from a Chrome Recorder export.
+
+## Invocation
+Run: taro generate <recording-file>
+
+## Flags
+- `--dry-run` (-d): Preview the generated test without writing to disk
+- `--output <path>` (-o): Override the output file path
+- `--force` (-f): Overwrite an existing test file
+
+## Output
+Writes `{recording-name}.test.tsx` next to the recording file.
+Reports score (0-100) and any quality hints.
+```
+
+**Step 2** — Ensure Taro is installed in the project:
+
+```bash
+npm install --save-dev @tayo-dev/rtl
+```
+
+**Step 3** — Ask Claude to use the skill:
+
+```
+Use the taro skill to generate a test from ./recordings/login-flow.js
+```
+
+### Tips for agent use
+
+- Use `--dry-run` first to preview output before committing generated files
+- If you record multiple flows, run Taro on each to build up convention state in `.taro/conventions.json` — later runs benefit from earlier ones
+- Pass `--force` when re-recording an updated flow to overwrite the old test
+- The `.taro/` directory should be committed to your repo so convention learning persists across team members
+
+### Notes
+
+- Taro does not require network access at generation time (DOM inspection via Playwright is optional and only runs when a live URL is in the recording)
+- All state is local to `.taro/` — no external service is contacted

package/dist/analyzer/mocks/detector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * API Call Detector - Identifies API calls in recordings and codebase
+ *
+ * Detects fetch, XMLHttpRequest, and common API patterns to determine
+ * which network calls need mocking in tests.
+ */
+import type { NormalizedRecording } from '../../types/recording.js';
+/**
+ * Information about a detected API call
+ */
+export interface ApiCallInfo {
+    /** Unique identifier for this API call */
+    id: string;
+    /** Type of API call detected */
+    method: 'fetch' | 'XMLHttpRequest' | 'axios' | 'fetch-jsonp' | 'unknown';
+    /** The URL or endpoint being called */
+    url?: string;
+    /** HTTP method if detectable */
+    httpMethod?: string;
+    /** Whether this is an external API (not same origin) */
+    isExternal: boolean;
+    /** Source where this was detected */
+    source: 'recording' | 'codebase' | 'both';
+    /** The step in recording where this appears (if applicable) */
+    recordingStepId?: string;
+    /** File and line where this appears in codebase (if applicable) */
+    codebaseLocation?: {
+        file: string;
+        line: number;
+    };
+}
+/**
+ * Detect API calls from a normalized recording
+ * Looks for network-related actions or URLs in step data
+ */
+export declare function detectApiCallsFromRecording(recording: NormalizedRecording): ApiCallInfo[];
+/**
+ * Scan source code files for API calls
+ */
+export declare function detectApiCallsFromCodebase(files: {
+    path: string;
+    content: string;
+}[]): ApiCallInfo[];
+/**
+ * Main detection function - combines recording and codebase analysis
+ */
+export declare function detectApiCalls(recording?: NormalizedRecording, codebaseFiles?: {
+    path: string;
+    content: string;
+}[]): ApiCallInfo[];
+/**
+ * Filter API calls that need mocking (external only)
+ */
+export declare function filterMockableCalls(apiCalls: ApiCallInfo[]): ApiCallInfo[];
+/**
+ * Group API calls by domain for organized mocking
+ */
+export declare function groupApiCallsByDomain(apiCalls: ApiCallInfo[]): Map<string, ApiCallInfo[]>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/analyzer/mocks/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/analyzer/mocks/detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;IACzE,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,UAAU,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1C,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAkDD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAoCzF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,WAAW,EAAE,CA0DpG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,CAAC,EAAE,mBAAmB,EAC/B,aAAa,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,GAClD,WAAW,EAAE,CA6Bf;AAkED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAE1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAuBzF"}

package/dist/analyzer/mocks/detector.js

@@ -0,0 +1,264 @@
+/**
+ * API Call Detector - Identifies API calls in recordings and codebase
+ *
+ * Detects fetch, XMLHttpRequest, and common API patterns to determine
+ * which network calls need mocking in tests.
+ */
+/**
+ * Patterns that indicate an API call in code
+ */
+const API_PATTERNS = {
+    fetch: [
+        /\bfetch\s*\(\s*['"`]/i,
+        /await\s+fetch\s*\(/i,
+        /window\.fetch\s*\(/i,
+    ],
+    xmlHttpRequest: [
+        /new\s+XMLHttpRequest\s*\(\s*\)/i,
+        /xhr\s*\.\s*open\s*\(/i,
+    ],
+    axios: [
+        /axios\.(get|post|put|patch|delete|request)\s*\(/i,
+        /await\s+axios\s*\(/i,
+    ],
+    fetchJsonp: [
+        /jsonp\s*\(/i,
+        /\.jsonp\s*\(/i,
+    ],
+};
+/**
+ * Common API endpoint patterns
+ */
+const API_ENDPOINT_PATTERNS = [
+    /\/api\//i,
+    /\/v\d+\//i,
+    /\/graphql/i,
+    /\/rest\//i,
+    /\/rpc\//i,
+    /\.(json|xml)\s*$/i,
+    /\?.*=/i, // Query string
+];
+/**
+ * External API domains (common third-party services)
+ */
+const EXTERNAL_API_DOMAINS = [
+    'api.',
+    '://',
+    '.com/',
+    '.io/',
+    '.net/',
+    'localhost:', // Treat localhost as external for testing
+];
+/**
+ * Detect API calls from a normalized recording
+ * Looks for network-related actions or URLs in step data
+ */
+export function detectApiCallsFromRecording(recording) {
+    const apiCalls = [];
+    for (const step of recording.steps) {
+        // Look for URL in step metadata or value
+        const potentialUrl = step.metadata?.url
+            || step.value
+            || step.selector;
+        if (potentialUrl && isApiUrl(potentialUrl)) {
+            const method = detectMethodFromUrl(potentialUrl);
+            apiCalls.push({
+                id: `recording-${step.id}`,
+                method: method || 'unknown',
+                url: potentialUrl,
+                isExternal: isExternalUrl(potentialUrl),
+                source: 'recording',
+                recordingStepId: step.id,
+            });
+        }
+        // Check for network-related actions in metadata
+        if (step.metadata?.networkCall) {
+            apiCalls.push({
+                id: `recording-network-${step.id}`,
+                method: step.metadata.networkMethod || 'unknown',
+                url: step.metadata.networkUrl,
+                isExternal: isExternalUrl(step.metadata.networkUrl),
+                source: 'recording',
+                recordingStepId: step.id,
+            });
+        }
+    }
+    return apiCalls;
+}
+/**
+ * Scan source code files for API calls
+ */
+export function detectApiCallsFromCodebase(files) {
+    const apiCalls = [];
+    for (const file of files) {
+        const lines = file.content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNumber = i + 1;
+            // Check for fetch
+            for (const pattern of API_PATTERNS.fetch) {
+                if (pattern.test(line)) {
+                    const url = extractUrlFromLine(line, 'fetch');
+                    apiCalls.push({
+                        id: `codebase-${file.path}-${lineNumber}`,
+                        method: 'fetch',
+                        url,
+                        httpMethod: extractHttpMethod(line),
+                        isExternal: url ? isExternalUrl(url) : true,
+                        source: 'codebase',
+                        codebaseLocation: { file: file.path, line: lineNumber },
+                    });
+                }
+            }
+            // Check for XMLHttpRequest
+            for (const pattern of API_PATTERNS.xmlHttpRequest) {
+                if (pattern.test(line)) {
+                    apiCalls.push({
+                        id: `codebase-${file.path}-${lineNumber}`,
+                        method: 'XMLHttpRequest',
+                        isExternal: true,
+                        source: 'codebase',
+                        codebaseLocation: { file: file.path, line: lineNumber },
+                    });
+                }
+            }
+            // Check for axios
+            for (const pattern of API_PATTERNS.axios) {
+                if (pattern.test(line)) {
+                    const url = extractUrlFromLine(line, 'axios');
+                    apiCalls.push({
+                        id: `codebase-${file.path}-${lineNumber}`,
+                        method: 'axios',
+                        httpMethod: extractAxiosMethod(line),
+                        url,
+                        isExternal: url ? isExternalUrl(url) : true,
+                        source: 'codebase',
+                        codebaseLocation: { file: file.path, line: lineNumber },
+                    });
+                }
+            }
+        }
+    }
+    return apiCalls;
+}
+/**
+ * Main detection function - combines recording and codebase analysis
+ */
+export function detectApiCalls(recording, codebaseFiles) {
+    const results = [];
+    // Detect from recording
+    if (recording) {
+        const recordingCalls = detectApiCallsFromRecording(recording);
+        results.push(...recordingCalls);
+    }
+    // Detect from codebase
+    if (codebaseFiles) {
+        const codebaseCalls = detectApiCallsFromCodebase(codebaseFiles);
+        results.push(...codebaseCalls);
+    }
+    // Deduplicate by URL
+    const uniqueByUrl = new Map();
+    for (const call of results) {
+        if (call.url) {
+            const key = `${call.method}:${call.url}`;
+            if (!uniqueByUrl.has(key)) {
+                uniqueByUrl.set(key, { ...call, source: 'both' });
+            }
+        }
+        else {
+            uniqueByUrl.set(call.id, call);
+        }
+    }
+    return Array.from(uniqueByUrl.values());
+}
+/**
+ * Check if a string looks like an API URL
+ */
+function isApiUrl(str) {
+    if (!str || typeof str !== 'string')
+        return false;
+    // Must be a URL-like string
+    return API_ENDPOINT_PATTERNS.some(pattern => pattern.test(str));
+}
+/**
+ * Detect HTTP method from URL patterns
+ */
+function detectMethodFromUrl(url) {
+    if (url.includes('.json'))
+        return 'fetch';
+    if (url.includes('graphql'))
+        return 'fetch';
+    if (url.includes('jsonp'))
+        return 'fetch-jsonp';
+    return 'fetch'; // Default to fetch for modern apps
+}
+/**
+ * Check if URL is external (different origin)
+ */
+function isExternalUrl(url) {
+    if (!url)
+        return true;
+    return EXTERNAL_API_DOMAINS.some(domain => url.includes(domain));
+}
+/**
+ * Extract URL from a fetch/axios line
+ */
+function extractUrlFromLine(line, type) {
+    // Match quoted strings (single or double quotes, or backticks)
+    const urlMatch = line.match(/['"`(](https?:\/\/[^'")`]+)['"`)]/);
+    if (urlMatch) {
+        return urlMatch[1];
+    }
+    // For dynamic URLs, try to find variable names
+    const dynamicMatch = line.match(new RegExp(`${type}\\s*\\(\\s*(\\w+)`));
+    if (dynamicMatch) {
+        return `[dynamic - \${${dynamicMatch[1]}}]`;
+    }
+    return undefined;
+}
+/**
+ * Extract HTTP method from fetch options
+ */
+function extractHttpMethod(line) {
+    const methodMatch = line.match(/method:\s*['"](\w+)['"]/i);
+    return methodMatch ? methodMatch[1].toUpperCase() : undefined;
+}
+/**
+ * Extract axios method (get, post, etc.)
+ */
+function extractAxiosMethod(line) {
+    const methodMatch = line.match(/axios\.(get|post|put|patch|delete|request)\s*\(/i);
+    return methodMatch ? methodMatch[1].toUpperCase() : undefined;
+}
+/**
+ * Filter API calls that need mocking (external only)
+ */
+export function filterMockableCalls(apiCalls) {
+    return apiCalls.filter(call => call.isExternal);
+}
+/**
+ * Group API calls by domain for organized mocking
+ */
+export function groupApiCallsByDomain(apiCalls) {
+    const groups = new Map();
+    for (const call of apiCalls) {
+        if (!call.url) {
+            const unknown = 'unknown';
+            const existing = groups.get(unknown) || [];
+            groups.set(unknown, [...existing, call]);
+            continue;
+        }
+        try {
+            const url = new URL(call.url);
+            const domain = url.hostname;
+            const existing = groups.get(domain) || [];
+            groups.set(domain, [...existing, call]);
+        }
+        catch {
+            const existing = groups.get('unknown') || [];
+            groups.set('unknown', [...existing, call]);
+        }
+    }
+    return groups;
+}
+//# sourceMappingURL=detector.js.map

package/dist/analyzer/mocks/detector.js.map

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

package/dist/analyzer/mocks/target-analyzer.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Mock Target Analyzer - Identifies appropriate mock targets from codebase
+ *
+ * Analyzes the codebase to determine which mock libraries are available
+ * (msw, jest.fn, sinon) and suggests appropriate mock targets based
+ * on the detected API calls.
+ */
+import type { ApiCallInfo } from './detector.js';
+/**
+ * Information about a mock target
+ */
+export interface MockTarget {
+    /** Unique identifier */
+    id: string;
+    /** The API call this mock targets */
+    apiCallId: string;
+    /** URL or endpoint to mock */
+    url: string;
+    /** HTTP method */
+    method: string;
+    /** Recommended mock library */
+    mockLibrary: 'msw' | 'jest.fn' | 'sinon' | 'fetch-mock' | 'undici' | 'nock';
+    /** Whether to inline the mock or extract to separate file */
+    extractionRecommendation: 'inline' | 'extracted' | 'shared';
+    /** Rationale for recommendations */
+    rationale: string;
+    /** Suggested mock file path (if extracted) */
+    suggestedFilePath?: string;
+}
+/**
+ * Mock library detected in the codebase
+ */
+export interface MockLibrary {
+    /** Library name */
+    name: 'msw' | 'jest.fn' | 'sinon' | 'fetch-mock' | 'undici' | 'nock';
+    /** Version if detectable */
+    version?: string;
+    /** File where it was detected */
+    sourceFile?: string;
+    /** Whether it's configured/initialized */
+    isConfigured: boolean;
+}
+/**
+ * Configuration for mock target analysis
+ */
+export interface MockTargetAnalysisConfig {
+    /** Preferred mock library (if multiple available) */
+    preferredLibrary?: MockLibrary['name'];
+    /** Maximum inline mock complexity */
+    maxInlineComplexity?: number;
+    /** Shared mocks directory */
+    sharedMocksDir?: string;
+}
+/**
+ * Detect available mock libraries from package.json dependencies
+ */
+export declare function detectMockLibraries(packageJson: Record<string, unknown>): MockLibrary[];
+/**
+ * Analyze code files to see which mock libraries are actually used
+ */
+export declare function analyzeMockLibraryUsage(files: {
+    path: string;
+    content: string;
+}[]): MockLibrary[];
+/**
+ * Determine the best mock library for a given API call
+ */
+export declare function selectMockLibrary(apiCall: ApiCallInfo, availableLibraries: MockLibrary[], config?: MockTargetAnalysisConfig): MockLibrary['name'];
+/**
+ * Decide whether to inline or extract a mock
+ */
+export declare function decideMockExtraction(apiCall: ApiCallInfo, existingMocks: string[]): 'inline' | 'extracted' | 'shared';
+/**
+ * Generate suggested file path for extracted mock
+ */
+export declare function suggestMockFilePath(apiCall: ApiCallInfo, baseDir?: string): string;
+/**
+ * Main function to analyze mock targets
+ */
+export declare function analyzeMockTargets(apiCalls: ApiCallInfo[], options?: {
+    packageJson?: Record<string, unknown>;
+    codebaseFiles?: {
+        path: string;
+        content: string;
+    }[];
+    config?: MockTargetAnalysisConfig;
+}): MockTarget[];
+/**
+ * Group mock targets by recommended approach
+ */
+export declare function groupMockTargetsByApproach(targets: MockTarget[]): Map<string, MockTarget[]>;
+//# sourceMappingURL=target-analyzer.d.ts.map