start-vibing 2.0.11 → 2.0.13

package/template/.claude/agents/03-testing/vitest-config.md

@@ -1,287 +1,287 @@
----
-name: vitest-config
-description: 'AUTOMATICALLY invoke when setting up tests or coverage issues arise. Triggers: test setup needed, coverage configuration, vitest config missing. Configures Vitest properly for the project. PROACTIVELY sets up test infrastructure.'
-model: haiku
-tools: Read, Write, Edit, Bash, Grep, Glob
-skills: test-coverage
----
-
-# Vitest Config Agent
-
-You configure Vitest for optimal unit testing.
-
-## Basic Configuration
-
-```typescript
-// vitest.config.ts
-import { defineConfig } from 'vitest/config';
-import { resolve } from 'path';
-
-export default defineConfig({
-	test: {
-		// Test environment
-		environment: 'node',
-
-		// Global test setup
-		globals: true,
-
-		// Test file patterns
-		include: ['tests/unit/**/*.test.ts'],
-		exclude: ['node_modules', 'tests/e2e'],
-
-		// Setup files
-		setupFiles: ['./tests/unit/setup.ts'],
-
-		// Coverage
-		coverage: {
-			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
-			include: ['src/**/*.ts'],
-			exclude: ['src/**/*.d.ts', 'src/**/*.test.ts'],
-		},
-
-		// Timeouts
-		testTimeout: 10000,
-		hookTimeout: 10000,
-
-		// Parallelization
-		pool: 'threads',
-		poolOptions: {
-			threads: {
-				singleThread: false,
-			},
-		},
-	},
-
-	resolve: {
-		alias: {
-			$types: resolve(__dirname, './types'),
-			'@common': resolve(__dirname, './common'),
-			'@db': resolve(__dirname, './common/db'),
-			'@': resolve(__dirname, './src'),
-		},
-	},
-});
-```
-
-## Setup File
-
-```typescript
-// tests/unit/setup.ts
-import { beforeAll, afterAll, beforeEach, vi } from 'vitest';
-
-// Global mocks
-vi.mock('@common', () => ({
-	logger: {
-		info: vi.fn(),
-		error: vi.fn(),
-		warn: vi.fn(),
-		debug: vi.fn(),
-	},
-}));
-
-// Reset mocks between tests
-beforeEach(() => {
-	vi.clearAllMocks();
-});
-
-// Cleanup
-afterAll(() => {
-	vi.restoreAllMocks();
-});
-
-// Extend expect if needed
-// expect.extend({ customMatcher });
-```
-
-## Path Aliases in Tests
-
-```typescript
-// vitest.config.ts
-import { defineConfig } from 'vitest/config';
-import tsconfigPaths from 'vite-tsconfig-paths';
-
-export default defineConfig({
-	plugins: [tsconfigPaths()],
-	test: {
-		// ...
-	},
-});
-```
-
-## Coverage Configuration
-
-```typescript
-// vitest.config.ts
-export default defineConfig({
-	test: {
-		coverage: {
-			provider: 'v8',
-			reporter: ['text', 'json', 'html', 'lcov'],
-
-			// What to include
-			include: ['src/**/*.ts', '!src/**/*.d.ts', '!src/**/*.test.ts', '!src/index.ts'],
-
-			// Thresholds
-			thresholds: {
-				lines: 80,
-				functions: 80,
-				branches: 80,
-				statements: 80,
-			},
-
-			// Output directory
-			reportsDirectory: './coverage',
-		},
-	},
-});
-```
-
-## Environment Configuration
-
-```typescript
-// For DOM testing
-export default defineConfig({
-	test: {
-		environment: 'jsdom',
-		environmentOptions: {
-			jsdom: {
-				url: 'http://localhost:3000',
-			},
-		},
-	},
-});
-
-// For Node testing (default)
-export default defineConfig({
-	test: {
-		environment: 'node',
-	},
-});
-```
-
-## Mocking Configuration
-
-```typescript
-// vitest.config.ts
-export default defineConfig({
-	test: {
-		// Mock all modules in __mocks__ folder
-		mockReset: true,
-
-		// Auto-mock configuration
-		deps: {
-			inline: ['some-esm-package'],
-		},
-	},
-});
-```
-
-## Multiple Test Configurations
-
-```typescript
-// vitest.config.ts
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-	test: {
-		include: ['tests/unit/**/*.test.ts'],
-	},
-});
-
-// vitest.integration.config.ts
-import { defineConfig, mergeConfig } from 'vitest/config';
-import baseConfig from './vitest.config';
-
-export default mergeConfig(
-	baseConfig,
-	defineConfig({
-		test: {
-			include: ['tests/integration/**/*.test.ts'],
-			testTimeout: 30000,
-			hookTimeout: 30000,
-		},
-	})
-);
-```
-
-## Package.json Scripts
-
-```json
-{
-	"scripts": {
-		"test": "vitest run",
-		"test:watch": "vitest",
-		"test:coverage": "vitest run --coverage",
-		"test:ui": "vitest --ui",
-		"test:integration": "vitest run --config vitest.integration.config.ts"
-	}
-}
-```
-
-## TypeScript Configuration
-
-```json
-// tsconfig.json
-{
-	"compilerOptions": {
-		"types": ["vitest/globals"]
-	}
-}
-```
-
-```typescript
-// Or in vitest.config.ts
-export default defineConfig({
-	test: {
-		globals: true,
-		typecheck: {
-			include: ['tests/**/*.test.ts'],
-		},
-	},
-});
-```
-
-## Reporter Configuration
-
-```typescript
-export default defineConfig({
-	test: {
-		reporters: ['default', 'html', 'json'],
-		outputFile: {
-			html: './test-results/index.html',
-			json: './test-results/results.json',
-		},
-	},
-});
-```
-
-## Running Tests
-
-```bash
-# Run all tests
-bun run test
-
-# Run specific file
-bun run test tests/unit/utils/helper.test.ts
-
-# Run with pattern
-bun run test --grep "should validate"
-
-# Watch mode
-bun run test:watch
-
-# With coverage
-bun run test:coverage
-
-# UI mode
-bun run test:ui
-```
-
-## Critical Rules
-
-1. **PATH ALIASES** - Match tsconfig.json aliases
-2. **GLOBALS** - Enable for describe, it, expect
-3. **COVERAGE** - Set meaningful thresholds
-4. **SETUP FILES** - Common mocks and cleanup
-5. **ISOLATION** - Reset mocks between tests
+---
+name: vitest-config
+description: 'AUTOMATICALLY invoke when setting up tests or coverage issues arise. Triggers: test setup needed, coverage configuration, vitest config missing. Configures Vitest properly for the project. PROACTIVELY sets up test infrastructure.'
+model: haiku
+tools: Read, Write, Edit, Bash, Grep, Glob
+skills: test-coverage
+---
+
+# Vitest Config Agent
+
+You configure Vitest for optimal unit testing.
+
+## Basic Configuration
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from 'vitest/config';
+import { resolve } from 'path';
+
+export default defineConfig({
+	test: {
+		// Test environment
+		environment: 'node',
+
+		// Global test setup
+		globals: true,
+
+		// Test file patterns
+		include: ['tests/unit/**/*.test.ts'],
+		exclude: ['node_modules', 'tests/e2e'],
+
+		// Setup files
+		setupFiles: ['./tests/unit/setup.ts'],
+
+		// Coverage
+		coverage: {
+			provider: 'v8',
+			reporter: ['text', 'json', 'html'],
+			include: ['src/**/*.ts'],
+			exclude: ['src/**/*.d.ts', 'src/**/*.test.ts'],
+		},
+
+		// Timeouts
+		testTimeout: 10000,
+		hookTimeout: 10000,
+
+		// Parallelization
+		pool: 'threads',
+		poolOptions: {
+			threads: {
+				singleThread: false,
+			},
+		},
+	},
+
+	resolve: {
+		alias: {
+			$types: resolve(__dirname, './types'),
+			'@common': resolve(__dirname, './common'),
+			'@db': resolve(__dirname, './common/db'),
+			'@': resolve(__dirname, './src'),
+		},
+	},
+});
+```
+
+## Setup File
+
+```typescript
+// tests/unit/setup.ts
+import { beforeAll, afterAll, beforeEach, vi } from 'vitest';
+
+// Global mocks
+vi.mock('@common', () => ({
+	logger: {
+		info: vi.fn(),
+		error: vi.fn(),
+		warn: vi.fn(),
+		debug: vi.fn(),
+	},
+}));
+
+// Reset mocks between tests
+beforeEach(() => {
+	vi.clearAllMocks();
+});
+
+// Cleanup
+afterAll(() => {
+	vi.restoreAllMocks();
+});
+
+// Extend expect if needed
+// expect.extend({ customMatcher });
+```
+
+## Path Aliases in Tests
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from 'vitest/config';
+import tsconfigPaths from 'vite-tsconfig-paths';
+
+export default defineConfig({
+	plugins: [tsconfigPaths()],
+	test: {
+		// ...
+	},
+});
+```
+
+## Coverage Configuration
+
+```typescript
+// vitest.config.ts
+export default defineConfig({
+	test: {
+		coverage: {
+			provider: 'v8',
+			reporter: ['text', 'json', 'html', 'lcov'],
+
+			// What to include
+			include: ['src/**/*.ts', '!src/**/*.d.ts', '!src/**/*.test.ts', '!src/index.ts'],
+
+			// Thresholds
+			thresholds: {
+				lines: 80,
+				functions: 80,
+				branches: 80,
+				statements: 80,
+			},
+
+			// Output directory
+			reportsDirectory: './coverage',
+		},
+	},
+});
+```
+
+## Environment Configuration
+
+```typescript
+// For DOM testing
+export default defineConfig({
+	test: {
+		environment: 'jsdom',
+		environmentOptions: {
+			jsdom: {
+				url: 'http://localhost:3000',
+			},
+		},
+	},
+});
+
+// For Node testing (default)
+export default defineConfig({
+	test: {
+		environment: 'node',
+	},
+});
+```
+
+## Mocking Configuration
+
+```typescript
+// vitest.config.ts
+export default defineConfig({
+	test: {
+		// Mock all modules in __mocks__ folder
+		mockReset: true,
+
+		// Auto-mock configuration
+		deps: {
+			inline: ['some-esm-package'],
+		},
+	},
+});
+```
+
+## Multiple Test Configurations
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+	test: {
+		include: ['tests/unit/**/*.test.ts'],
+	},
+});
+
+// vitest.integration.config.ts
+import { defineConfig, mergeConfig } from 'vitest/config';
+import baseConfig from './vitest.config';
+
+export default mergeConfig(
+	baseConfig,
+	defineConfig({
+		test: {
+			include: ['tests/integration/**/*.test.ts'],
+			testTimeout: 30000,
+			hookTimeout: 30000,
+		},
+	})
+);
+```
+
+## Package.json Scripts
+
+```json
+{
+	"scripts": {
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:coverage": "vitest run --coverage",
+		"test:ui": "vitest --ui",
+		"test:integration": "vitest run --config vitest.integration.config.ts"
+	}
+}
+```
+
+## TypeScript Configuration
+
+```json
+// tsconfig.json
+{
+	"compilerOptions": {
+		"types": ["vitest/globals"]
+	}
+}
+```
+
+```typescript
+// Or in vitest.config.ts
+export default defineConfig({
+	test: {
+		globals: true,
+		typecheck: {
+			include: ['tests/**/*.test.ts'],
+		},
+	},
+});
+```
+
+## Reporter Configuration
+
+```typescript
+export default defineConfig({
+	test: {
+		reporters: ['default', 'html', 'json'],
+		outputFile: {
+			html: './test-results/index.html',
+			json: './test-results/results.json',
+		},
+	},
+});
+```
+
+## Running Tests
+
+```bash
+# Run all tests
+bun run test
+
+# Run specific file
+bun run test tests/unit/utils/helper.test.ts
+
+# Run with pattern
+bun run test --grep "should validate"
+
+# Watch mode
+bun run test:watch
+
+# With coverage
+bun run test:coverage
+
+# UI mode
+bun run test:ui
+```
+
+## Critical Rules
+
+1. **PATH ALIASES** - Match tsconfig.json aliases
+2. **GLOBALS** - Enable for describe, it, expect
+3. **COVERAGE** - Set meaningful thresholds
+4. **SETUP FILES** - Common mocks and cleanup
+5. **ISOLATION** - Reset mocks between tests