feat: better Array#includes uhyo#17

Author: uinz

generated/lib.es2016.array.include.d.ts

@@ -4,17 +4,29 @@ interface Array<T> {
    * @param searchElement The element to search for.
    * @param fromIndex The position in this array at which to begin searching for searchElement.
    */
-  includes(searchElement: T, fromIndex?: number): boolean;
+  includes(searchElement: unknown, fromIndex?: number): searchElement is T;
 }
+//     /**
+//      * Determines whether an array includes a certain element, returning true or false as appropriate.
+//      * @param searchElement The element to search for.
+//      * @param fromIndex The position in this array at which to begin searching for searchElement.
+//      */
+//     includes(searchElement: T, fromIndex?: number): boolean;
 
 interface ReadonlyArray<T> {
   /**
    * Determines whether an array includes a certain element, returning true or false as appropriate.
    * @param searchElement The element to search for.
    * @param fromIndex The position in this array at which to begin searching for searchElement.
    */
-  includes(searchElement: T, fromIndex?: number): boolean;
+  includes(searchElement: unknown, fromIndex?: number): searchElement is T;
 }
+//     /**
+//      * Determines whether an array includes a certain element, returning true or false as appropriate.
+//      * @param searchElement The element to search for.
+//      * @param fromIndex The position in this array at which to begin searching for searchElement.
+//      */
+//     includes(searchElement: T, fromIndex?: number): boolean;
 
 interface Int8Array {
   /**

lib/lib.es2016.array.include.d.ts

@@ -0,0 +1,17 @@
+interface Array<T> {
+  /**
+   * Determines whether an array includes a certain element, returning true or false as appropriate.
+   * @param searchElement The element to search for.
+   * @param fromIndex The position in this array at which to begin searching for searchElement.
+   */
+  includes(searchElement: unknown, fromIndex?: number): searchElement is T;
+}
+
+interface ReadonlyArray<T> {
+  /**
+   * Determines whether an array includes a certain element, returning true or false as appropriate.
+   * @param searchElement The element to search for.
+   * @param fromIndex The position in this array at which to begin searching for searchElement.
+   */
+  includes(searchElement: unknown, fromIndex?: number): searchElement is T;
+}