diff --git a/src/types/jest-dom.d.ts b/src/types/jest-dom.d.ts
new file mode 100644
index 000000000..a03cb84d6
--- /dev/null
+++ b/src/types/jest-dom.d.ts
@@ -0,0 +1,10 @@
+// Registra os matchers do @testing-library/jest-dom nos tipos do vitest.
+//
+// O import de runtime fica em tests/setup.ts (import '@testing-library/jest-dom'),
+// mas tests/setup.ts esta FORA de 'src' e o tsconfig.app.json (usado pelo gate de
+// typecheck e pelo build) so inclui 'src'. Sem este arquivo dentro de 'src', os
+// testes em src/**/__tests__ nao enxergam os tipos dos matchers (toBeInTheDocument,
+// toHaveAttribute, toHaveClass, ...), gerando TS2339 em massa.
+//
+// Reaproveita o augment oficial publicado pelo proprio pacote.
+import '@testing-library/jest-dom/vitest';