docs: update intersectionBy documentation to support multiple arrays

Author: wo-o29

docs/ja/reference/array/intersectionBy.md

@@ -1,16 +1,16 @@
 # intersectionBy
 
-変換関数の結果を基準に、2つの配列の交集合を求めた新しい配列を返します。
+変換関数の結果を基準に、2つ以上の配列の共通部分を返します。
 
 ```typescript
-const result = intersectionBy(firstArr, secondArr, mapper);
+const result = intersectionBy(firstArr, secondArr, ...otherArr, mapper);
 ```
 
 ## 使用法
 
-### `intersectionBy(firstArr, secondArr, mapper)`
+### `intersectionBy(firstArr, secondArr, ...otherArr?, mapper)`
 
-2つの配列で特定の属性や変換された値を基準に共通の要素を見つけたい場合は `intersectionBy` を使用してください。各要素を変換関数で処理した結果を比較して交集合を求めます。オブジェクト配列で特定のプロパティで比較したり、複雑な変換ロジックが必要な場合に便利です。
+特定のプロパティや変換された値を基準に、2つ以上の配列から共通要素を見つけたい場合は`intersectionBy`を使用してください。各要素に変換関数を適用した結果を比較して共通部分を計算します。オブジェクト配列を特定のプロパティで比較する場合や、複雑な変換ロジックが必要な場合に便利です。
 
 ```typescript
 import { intersectionBy } from 'es-toolkit/array';
@@ -56,12 +56,26 @@ intersectionBy(numbers1, numbers2, num => Math.abs(num));
 // Returns: [-2, 3, -4]
 ```
 
+3つ以上の配列も比較できます。
+
+```typescript
+import { intersectionBy } from 'es-toolkit/array';
+
+// 3つの配列すべてに存在する要素を見つける
+const arr1 = [{ id: 1 }, { id: 2 }, { id: 3 }];
+const arr2 = [{ id: 2 }, { id: 3 }];
+const arr3 = [{ id: 2 }, { id: 4 }];
+intersectionBy(arr1, arr2, arr3, item => item.id);
+// Returns: [{ id: 2 }, { id: 3 }]
+```
+
 #### パラメータ
 
 - `firstArr` (`readonly T[]`): 比較する最初の配列です。
 - `secondArr` (`readonly U[]`): 比較する2番目の配列です。
+- `...otherArr` (`readonly U[]`, オプション): 比較する追加の配列。
 - `mapper` (`(item: T | U) => unknown`): 各要素を変換して比較基準を作成する関数です。
 
 #### 戻り値
 
-(`T[]`): 変換関数の結果を基準に、両方の配列に共通して含まれる要素からなる新しい配列を返します。結果は最初の配列の要素で構成されます。
+(`T[]`): 変換された値を基準に、すべての配列に存在する最初の配列の要素を含む新しい配列を返します。結果は最初の配列の要素で構成されます。

docs/ko/reference/array/intersectionBy.md

@@ -1,16 +1,16 @@
 # intersectionBy
 
-변환 함수의 결과를 기준으로 두 배열의 교집합을 구한 새 배열을 반환해요.
+변환 함수의 결과를 기준으로 두 개 이상의 배열의 교집합을 구한 새 배열을 반환해요.
 
 ```typescript
-const result = intersectionBy(firstArr, secondArr, mapper);
+const result = intersectionBy(firstArr, secondArr, ...otherArr, mapper);
 ```
 
 ## 사용법
 
-### `intersectionBy(firstArr, secondArr, mapper)`
+### `intersectionBy(firstArr, secondArr, ...otherArr?, mapper)`
 
-두 배열에서 특정 속성이나 변환된 값을 기준으로 공통 요소를 찾고 싶을 때 `intersectionBy`를 사용하세요. 각 요소를 변환 함수로 처리한 결과를 비교해서 교집합을 구해요. 객체 배열에서 특정 속성으로 비교하거나 복잡한 변환 로직이 필요할 때 유용해요.
+두 개 이상의 배열에서 특정 속성이나 변환된 값을 기준으로 공통 요소를 찾고 싶을 때 `intersectionBy`를 사용하세요. 각 요소를 변환 함수로 처리한 결과를 비교해서 교집합을 구해요. 객체 배열에서 특정 속성으로 비교하거나 복잡한 변환 로직이 필요할 때 유용해요.
 
 ```typescript
 import { intersectionBy } from 'es-toolkit/array';
@@ -56,12 +56,26 @@ intersectionBy(numbers1, numbers2, num => Math.abs(num));
 // Returns: [-2, 3, -4]
 ```
 
+세 개 이상의 배열도 비교할 수 있어요.
+
+```typescript
+import { intersectionBy } from 'es-toolkit/array';
+
+// 세 배열 모두에 공통으로 존재하는 요소를 찾아요.
+const arr1 = [{ id: 1 }, { id: 2 }, { id: 3 }];
+const arr2 = [{ id: 2 }, { id: 3 }];
+const arr3 = [{ id: 2 }, { id: 4 }];
+intersectionBy(arr1, arr2, arr3, item => item.id);
+// Returns: [{ id: 2 }, { id: 3 }]
+```
+
 #### 파라미터
 
 - `firstArr` (`readonly T[]`): 비교할 첫 번째 배열이에요.
 - `secondArr` (`readonly U[]`): 비교할 두 번째 배열이에요.
+- `...otherArr` (`readonly U[]`, 선택): 추가로 비교할 배열이에요
 - `mapper` (`(item: T | U) => unknown`): 각 요소를 변환해서 비교 기준을 만드는 함수예요.
 
 #### 반환 값
 
-(`T[]`): 변환 함수의 결과를 기준으로 두 배열에 공통으로 포함된 요소들로 이루어진 새 배열을 반환해요. 결과는 첫 번째 배열의 요소들로 구성돼요.
+(`T[]`): 변환 함수의 결과를 기준으로 모든 배열에 공통으로 포함된 요소들로 이루어진 새 배열을 반환해요. 결과는 첫 번째 배열의 요소들로 구성돼요.

docs/reference/array/intersectionBy.md

@@ -1,16 +1,16 @@
 # intersectionBy
 
-Returns a new array containing the intersection of two arrays based on the result of a transformation function.
+Returns the intersection of two or more arrays based on a mapping function.
 
 ```typescript
-const result = intersectionBy(firstArr, secondArr, mapper);
+const result = intersectionBy(firstArr, secondArr, ...otherArr, mapper);
 ```
 
 ## Usage
 
-### `intersectionBy(firstArr, secondArr, mapper)`
+### `intersectionBy(firstArr, secondArr, ...otherArr?, mapper)`
 
-Use `intersectionBy` when you want to find common elements in two arrays based on a specific attribute or transformed value. It compares the results of processing each element with a transformation function to find the intersection. This is useful when comparing by a specific property in object arrays or when complex transformation logic is needed.
+Use `intersectionBy` when you want to find common elements across two or more arrays based on a specific property or transformed value. It compares the results of applying a transformation function to each element to compute the intersection. This is useful when comparing object arrays by a specific property or when complex transformation logic is needed.
 
 ```typescript
 import { intersectionBy } from 'es-toolkit/array';
@@ -56,12 +56,26 @@ intersectionBy(numbers1, numbers2, num => Math.abs(num));
 // Returns: [-2, 3, -4]
 ```
 
+You can also compare three or more arrays.
+
+```typescript
+import { intersectionBy } from 'es-toolkit/array';
+
+// Find elements that exist in all three arrays
+const arr1 = [{ id: 1 }, { id: 2 }, { id: 3 }];
+const arr2 = [{ id: 2 }, { id: 3 }];
+const arr3 = [{ id: 2 }, { id: 4 }];
+intersectionBy(arr1, arr2, arr3, item => item.id);
+// Returns: [{ id: 2 }, { id: 3 }]
+```
+
 #### Parameters
 
 - `firstArr` (`readonly T[]`): The first array to compare.
 - `secondArr` (`readonly U[]`): The second array to compare.
+- `...otherArr` (`readonly U[]`, optional): Additional arrays to compare.
 - `mapper` (`(item: T | U) => unknown`): A function that transforms each element to create comparison criteria.
 
 #### Returns
 
-(`T[]`): Returns a new array containing elements commonly included in both arrays based on the result of the transformation function. The result consists of elements from the first array.
+(`T[]`): Returns a new array containing elements from the first array that are present in all other arrays based on the transformed values. The result consists of elements from the first array.

docs/zh_hans/reference/array/intersectionBy.md

@@ -1,16 +1,16 @@
 # intersectionBy
 
-根据转换函数的结果为标准求两个数组的交集,返回一个新数组。
+根据映射函数返回两个或多个数组的交集。
 
 ```typescript
-const result = intersectionBy(firstArr, secondArr, mapper);
+const result = intersectionBy(firstArr, secondArr, ...otherArr, mapper);
 ```
 
 ## 用法
 
-### `intersectionBy(firstArr, secondArr, mapper)`
+### `intersectionBy(firstArr, secondArr, ...otherArr?, mapper)`
 
-当您想根据特定属性或转换后的值查找两个数组的共同元素时,请使用 `intersectionBy`。它比较用转换函数处理每个元素后的结果来求交集。在对象数组中按特定属性比较或需要复杂转换逻辑时很有用。
+当您想要根据特定属性或转换后的值在两个或多个数组中查找公共元素时,请使用 `intersectionBy`。它通过比较对每个元素应用转换函数的结果来计算交集。这在按特定属性比较对象数组或需要复杂转换逻辑时非常有用。
 
 ```typescript
 import { intersectionBy } from 'es-toolkit/array';
@@ -56,12 +56,26 @@ intersectionBy(numbers1, numbers2, num => Math.abs(num));
 // Returns: [-2, 3, -4]
 ```
 
+您也可以比较三个或更多数组。
+
+```typescript
+import { intersectionBy } from 'es-toolkit/array';
+
+// 查找在所有三个数组中都存在的元素
+const arr1 = [{ id: 1 }, { id: 2 }, { id: 3 }];
+const arr2 = [{ id: 2 }, { id: 3 }];
+const arr3 = [{ id: 2 }, { id: 4 }];
+intersectionBy(arr1, arr2, arr3, item => item.id);
+// Returns: [{ id: 2 }, { id: 3 }]
+```
+
 #### 参数
 
 - `firstArr` (`readonly T[]`): 要比较的第一个数组。
 - `secondArr` (`readonly U[]`): 要比较的第二个数组。
+- `...otherArr` (`readonly U[]`, 可选): 要比较的其他数组。
 - `mapper` (`(item: T | U) => unknown`): 转换每个元素以创建比较标准的函数。
 
 #### 返回值
 
-(`T[]`): 返回根据转换函数的结果为标准,由两个数组共同包含的元素组成的新数组。结果由第一个数组的元素组成。
+(`T[]`): 返回一个新数组,包含第一个数组中根据转换后的值在所有其他数组中都存在的元素。结果由第一个数组的元素组成。