fix(pull): enhance pull function type definition

Author: ssi02014

docs/ja/reference/array/pull.md

@@ -8,7 +8,7 @@
 ## インターフェース
 
 ```typescript
-function pull<T>(arr: T[], valuesToRemove: unknown[]): T[];
+function pull<T, U extends T>(arr: T[], valuesToRemove: readonly U[]): T[];
 ```
 
 ### パラメータ

docs/ko/reference/array/pull.md

@@ -8,13 +8,13 @@
 ## 인터페이스
 
 ```typescript
-function pull<T>(arr: T[], valuesToRemove: unknown[]): T[];
+function pull<T, U extends T>(arr: T[], valuesToRemove: readonly U[]): T[];
 ```
 
 ### 파라미터
 
 - `arr` (`T[]`): 수정할 배열.
-- `valuesToRemove` (`unknown[]`): 배열에서 제거할 값들.
+- `valuesToRemove` (`T[]`): 배열에서 제거할 값들.
 
 ### 반환 값
 

docs/reference/array/pull.md

@@ -8,13 +8,13 @@ If you want to remove values without modifying the original array, use [differen
 ## Signature
 
 ```typescript
-function pull<T>(arr: T[], valuesToRemove: unknown[]): T[];
+function pull<T, U extends T>(arr: T[], valuesToRemove: readonly U[]): T[];
 ```
 
 ### Parameters
 
 - `arr` (`T[]`): The array to modify.
-- `valuesToRemove` (`unknown[]`): The values to remove from the array.
+- `valuesToRemove` (`T[]`): The values to remove from the array.
 
 ### Returns
 

docs/zh_hans/reference/array/pull.md

@@ -8,13 +8,13 @@
 ## 签名
 
 ```typescript
-function pull<T>(arr: T[], valuesToRemove: unknown[]): T[];
+function pull<T, U extends T>(arr: T[], valuesToRemove: readonly U[]): T[];
 ```
 
 ### 参数
 
 - `arr` (`T[]`): 要修改的数组。
-- `valuesToRemove` (`unknown[]`): 要从数组中移除的值。
+- `valuesToRemove` (`T[]`): 要从数组中移除的值。
 
 ### 返回值
 

src/array/pull.ts

@@ -4,22 +4,23 @@
  * This function changes `arr` in place.
  * If you want to remove values without modifying the original array, use `difference`.
  *
- * @template T, U
+ * @template T - The type of elements in the array.
+ * @template U - The type of values to remove from the array.
  * @param {T[]} arr - The array to modify.
- * @param {unknown[]} valuesToRemove - The values to remove from the array.
+ * @param {U[]} valuesToRemove - The values to remove from the array.
  * @returns {T[]} The modified array with the specified values removed.
  *
  * @example
  * const numbers = [1, 2, 3, 4, 5, 2, 4];
  * pull(numbers, [2, 4]);
  * console.log(numbers); // [1, 3, 5]
  */
-export function pull<T>(arr: T[], valuesToRemove: readonly unknown[]): T[] {
+export function pull<T, U extends T>(arr: T[], valuesToRemove: readonly U[]): T[] {
   const valuesSet = new Set(valuesToRemove);
   let resultIndex = 0;
 
   for (let i = 0; i < arr.length; i++) {
-    if (valuesSet.has(arr[i])) {
+    if (valuesSet.has(arr[i] as U)) {
       continue;
     }
 

src/compat/array/pull.ts

@@ -5,9 +5,10 @@ import { pull as pullToolkit } from '../../array/pull.ts';
  *
  * **Note:** Unlike `_.without`, this method mutates `array`.
  *
- * @template T
+ * @template T - The type of elements in the array.
+ * @template U - The type of values to remove from the array.
  * @param {T[]} array - The array to modify.
- * @param {...T[]} values - The values to remove.
+ * @param {...U[]} values - The values to remove.
  * @returns {T[]} Returns `array`.
  *
  * @example
@@ -17,14 +18,14 @@ import { pull as pullToolkit } from '../../array/pull.ts';
  * console.log(array);
  * // => [1, 1]
  */
-export function pull<T>(array: T[], ...values: T[]): T[];
+export function pull<T, U extends T>(array: T[], ...values: U[]): T[];
 
 /**
  * Removes all provided values from array using SameValueZero for equality comparisons.
  *
  * **Note:** Unlike `_.without`, this method mutates `array`.
  *
- * @template L
+ * @template L - The type of elements in the array-like object.
  * @param {L} array - The array to modify.
  * @param {...L[0][]} values - The values to remove.
  * @returns {L} Returns `array`.
@@ -44,16 +45,17 @@ export function pull<L extends ArrayLike<any>>(array: L extends readonly any[] ?
  * This function changes `arr` in place.
  * If you want to remove values without modifying the original array, use `difference`.
  *
- * @template T, U
+ * @template T - The type of elements in the array.
+ * @template U - The type of values to remove from the array.
  * @param {T[]} arr - The array to modify.
- * @param {...unknown[]} valuesToRemove - The values to remove from the array.
+ * @param {U[]} valuesToRemove - The values to remove from the array.
  * @returns {T[]} The modified array with the specified values removed.
  *
  * @example
  * const numbers = [1, 2, 3, 4, 5, 2, 4];
  * pull(numbers, [2, 4]);
  * console.log(numbers); // [1, 3, 5]
  */
-export function pull<T>(arr: T[], ...valuesToRemove: readonly unknown[]): T[] {
+export function pull<T, U extends T>(arr: T[], ...valuesToRemove: readonly U[]): T[] {
   return pullToolkit(arr, valuesToRemove);
 }