fix: Mark deprecated methods as @deprecated (#771)

Author: Semigradsky

types/wait-for-dom-change.d.ts

@@ -1,3 +1,7 @@
 import { waitForOptions } from "./wait-for";
 
+/**
+ * @deprecated `waitForDomChange` has been deprecated.
+ * Use `waitFor` instead: https://testing-library.com/docs/dom-testing-library/api-async#waitfor.
+ */
 export function waitForDomChange(options?: waitForOptions): Promise<any>;

types/wait-for-element.d.ts

@@ -1,3 +1,8 @@
 import { waitForOptions } from "./wait-for";
 
+/**
+ * @deprecated `waitForElement` has been deprecated.
+ * Use a `find*` query (preferred: https://testing-library.com/docs/dom-testing-library/api-queries#findby)
+ * or use `waitFor` instead: https://testing-library.com/docs/dom-testing-library/api-async#waitfor
+ */
 export function waitForElement<T>(callback: () => T, options?: waitForOptions): Promise<T>;

types/wait.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @deprecated `wait` has been deprecated and replaced by `waitFor` instead.
+ * In most cases you should be able to find/replace `wait` with `waitFor`.
+ * Learn more: https://testing-library.com/docs/dom-testing-library/api-async#waitfor.
+ */
 export function wait(
     callback?: () => void,
     options?: {