Test File Conventions

References

Load these on demand based on what you're working on:

• If working with negative type tests (@ts-expect-error, bun:test type strategy, no as any), read references/type-testing.md
• If working with test setup architecture (setup() patterns, composable setup, beforeEach avoidance, shared schemas), read references/setup-pattern.md
• If working with test organization structure (flat tests, describe() boundaries, helper-over-nesting), read references/test-structure.md
• If auditing existing tests for hedged assertions, pass-through getters, stalled fakes, dead fake surface, or docstrings that contradict the code, read references/honest-tests.md
• If deleting or pruning tests that may not earn their keep, read references/test-deletion-grill.md

External reading:

• Kent C. Dodds, "Avoid Nesting When You're Testing" : setup functions over beforeEach, flat tests
• Kent C. Dodds, "AHA Testing" : avoid hasty abstractions in tests
• Kent C. Dodds, Testing JavaScript : Test Object Factory Pattern
• Matt Pocock, "How to test your types" : vitest expectTypeOf for type testing
• Matt Pocock, shoehorn : partial mocks for test ergonomics