Finalize simplification of Jest namespace

Author: dprevost-LMI

jest.d.ts

@@ -1,5 +1,10 @@
 /// <reference types="./types/expect-webdriverio.d.ts"/>
 
+/**
+ * Augment the Jest namespace to include the matchers from expect-webdriverio.
+ * When Jest Library is used, it specifies `expect-webdriverio/jest` for this file in the tsconfig.json's types.
+ */
+
 declare namespace jest {
 
     interface Matchers<R, T> extends ExpectWebdriverIO.Matchers<R, T> {

types/expect-webdriverio.d.ts

@@ -377,11 +377,13 @@ interface WdioElementArrayOnlyMatchers<R, ActualT = unknown> {
 
 /**
  * Matchers supporting basic snapshot tests as well as DOM snapshot testing.
- * Warning: these matchers overload the similar matchers from jest-expect library.
  * When the actual is a WebdriverIO.Element, we need to await the `outerHTML` therefore the return type is a Promise.
- * TODO dprevost: Review for better typings...
  *
- * Those need to be also duplicated in jest.d.ts in order for the typing to correctly overload the matchers (we cannot just extend the Matchers interface)
+ * ⚠️ these matchers overload the similar matchers from jest-expect library.
+ * Therefore, they also need to be redefined in the jest.d.ts file so correctly overload the matchers from the Jest namespace.
+ * @see jest.d.ts
+ *
+ * TODO dprevost: Review for better typings...
  */
 interface WdioJestOverloadedMatchers<R, ActualT> {
     /**