es-toolkit 1.25.2-dev.807 → 1.25.2-dev.808

package/dist/compat/array/orderBy.d.mts

@@ -7,9 +7,10 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
  * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @param {unknown | unknown[]} orders - An array of order directions ('asc' for ascending or 'desc' for descending).
+ * @param {unknown} [guard] Enables use as an iteratee for methods like `_.reduce`.
  * @returns {T[]} - The sorted array.
  *
  * @example
@@ -29,6 +30,6 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T = any>(collection: ArrayLike<T> | object | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[], guard?: unknown): T[];
 
 export { type Criterion, orderBy };

package/dist/compat/array/orderBy.d.ts

@@ -7,9 +7,10 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
  * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @param {unknown | unknown[]} orders - An array of order directions ('asc' for ascending or 'desc' for descending).
+ * @param {unknown} [guard] Enables use as an iteratee for methods like `_.reduce`.
  * @returns {T[]} - The sorted array.
  *
  * @example
@@ -29,6 +30,6 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T = any>(collection: ArrayLike<T> | object | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[], guard?: unknown): T[];
 
 export { type Criterion, orderBy };

package/dist/compat/array/orderBy.mjs

@@ -2,16 +2,20 @@ import { compareValues } from '../_internal/compareValues.mjs';
 import { isKey } from '../_internal/isKey.mjs';
 import { toPath } from '../util/toPath.mjs';
 
-function orderBy(collection, criteria, orders) {
-    if (collection == null || typeof collection === 'number') {
+function orderBy(collection, criteria, orders, guard) {
+    if (collection == null) {
         return [];
     }
-    if (typeof collection === 'object' && !Array.isArray(collection)) {
+    orders = guard ? undefined : orders;
+    if (!Array.isArray(collection)) {
         collection = Object.values(collection);
     }
     if (!Array.isArray(criteria)) {
         criteria = criteria == null ? [null] : [criteria];
     }
+    if (criteria.length === 0) {
+        criteria = [null];
+    }
     if (!Array.isArray(orders)) {
         orders = orders == null ? [] : [orders];
     }

package/dist/compat/array/sortBy.d.mts

@@ -8,8 +8,8 @@ import { Criterion } from './orderBy.mjs';
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
- * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {Array<Array<Criterion<T> | Criterion<T>>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @returns {T[]} - The ascending sorted array.
  *
  * @example
@@ -29,6 +29,6 @@ import { Criterion } from './orderBy.mjs';
  * //   { user: 'fred', age: 48 },
  * // ]
  */
-declare function sortBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
+declare function sortBy<T = any>(collection: ArrayLike<T> | object | null | undefined, ...criteria: Array<Criterion<T> | Array<Criterion<T>>>): T[];
 
 export { sortBy };

package/dist/compat/array/sortBy.d.ts

@@ -8,8 +8,8 @@ import { Criterion } from './orderBy.js';
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
- * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {Array<Array<Criterion<T> | Criterion<T>>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @returns {T[]} - The ascending sorted array.
  *
  * @example
@@ -29,6 +29,6 @@ import { Criterion } from './orderBy.js';
  * //   { user: 'fred', age: 48 },
  * // ]
  */
-declare function sortBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
+declare function sortBy<T = any>(collection: ArrayLike<T> | object | null | undefined, ...criteria: Array<Criterion<T> | Array<Criterion<T>>>): T[];
 
 export { sortBy };

package/dist/compat/array/sortBy.mjs

@@ -1,7 +1,16 @@
 import { orderBy } from './orderBy.mjs';
+import { flatten } from '../../array/flatten.mjs';
+import { isIterateeCall } from '../_internal/isIterateeCall.mjs';
 
-function sortBy(collection, criteria) {
-    return orderBy(collection, criteria, ['asc']);
+function sortBy(collection, ...criteria) {
+    const length = criteria.length;
+    if (length > 1 && isIterateeCall(collection, criteria[0], criteria[1])) {
+        criteria = [];
+    }
+    else if (length > 2 && isIterateeCall(criteria[0], criteria[1], criteria[2])) {
+        criteria = [criteria[0]];
+    }
+    return orderBy(collection, flatten(criteria), ['asc']);
 }
 
 export { sortBy };

package/dist/compat/index.js

@@ -886,16 +886,20 @@ function isKey(value, object) {
         (object != null));
 }
 
-function orderBy(collection, criteria, orders) {
-    if (collection == null || typeof collection === 'number') {
+function orderBy(collection, criteria, orders, guard) {
+    if (collection == null) {
         return [];
     }
-    if (typeof collection === 'object' && !Array.isArray(collection)) {
+    orders = guard ? undefined : orders;
+    if (!Array.isArray(collection)) {
         collection = Object.values(collection);
     }
     if (!Array.isArray(criteria)) {
         criteria = criteria == null ? [null] : [criteria];
     }
+    if (criteria.length === 0) {
+        criteria = [null];
+    }
     if (!Array.isArray(orders)) {
         orders = orders == null ? [] : [orders];
     }
@@ -1051,8 +1055,15 @@ function some(source, predicate, guard) {
     }
 }
 
-function sortBy(collection, criteria) {
-    return orderBy(collection, criteria, ['asc']);
+function sortBy(collection, ...criteria) {
+    const length = criteria.length;
+    if (length > 1 && isIterateeCall(collection, criteria[0], criteria[1])) {
+        criteria = [];
+    }
+    else if (length > 2 && isIterateeCall(criteria[0], criteria[1], criteria[2])) {
+        criteria = [criteria[0]];
+    }
+    return orderBy(collection, zipWith.flatten(criteria), ['asc']);
 }
 
 function tail(arr) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.25.2-dev.807+4b74386c",
+  "version": "1.25.2-dev.808+402f604b",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {