gen-test

name	gen-test
description	Generate unit tests following project conventions. Use when the user asks to create, generate, or write tests for a file or component.

Generate unit tests for the specified file or component.

Input: A file path, component name, or utility function to test. If omitted, infer from conversation context.

Steps

1. Read the source file to understand exports, types, and behavior
2. Check for an existing test file co-located next to the source (e.g., foo.ts → foo.test.ts)
   • If it exists, read it and add new tests rather than replacing
3. Generate tests following project conventions (see below)
4. Run the new tests to verify they pass: npx vitest run <test-file>

Project Conventions

• Test files are co-located: src/lib/foo.ts → src/lib/foo.test.ts, src/components/app/bar.tsx → src/components/app/bar.test.tsx
• Framework: Vitest + React Testing Library (jsdom environment)
• Import from vitest: describe, it, expect, vi, beforeEach, afterEach
• For React components, import render, screen, fireEvent, within from @/test/test-utils (NOT directly from @testing-library/react)
• Query priority: getByRole → getByLabelText → getByText. Avoid getByTestId unless semantic queries fail. Never use snapshots.
• Use @/ path alias for imports (maps to ./src/)
• framer-motion is auto-mocked in vitest.setup.ts — no special handling needed
• localStorage is auto-mocked — use helpers from @/test/localStorage-helpers if needed
• For Tauri bridge mocking, use @/test/tauri-bridge-mock
• Group related tests in describe blocks
• Test names should describe behavior, not implementation

Example Structure

import { describe, it, expect, vi, beforeEach } from 'vitest';
import { render, screen, fireEvent } from '@/test/test-utils';
import { MyComponent } from './my-component';

describe('MyComponent', () => {
  it('renders the primary action button', () => {
    render(<MyComponent />);
    expect(screen.getByRole('button', { name: /action/i })).toBeInTheDocument();
  });

  it('calls onSubmit when clicked', async () => {
    const onSubmit = vi.fn();
    render(<MyComponent onSubmit={onSubmit} />);
    fireEvent.click(screen.getByRole('button', { name: /submit/i }));
    expect(onSubmit).toHaveBeenCalledOnce();
  });
});

Guardrails

• Keep tests focused on behavior, not implementation details
• Don't mock what you don't have to
• Don't add tests for trivial pass-through props
• If the source file uses shadcn/ui components, query by role (they use Radix primitives with proper ARIA)