es-toolkit 1.16.0-dev.496 → 1.16.0-dev.499

package/dist/compat/_internal/compareValues.mjs

@@ -0,0 +1,11 @@
+const compareValues = (a, b, order) => {
+    if ((a != null && b == null) || a < b) {
+        return order === 'desc' ? 1 : -1;
+    }
+    if ((a == null && b != null) || a > b) {
+        return order === 'desc' ? -1 : 1;
+    }
+    return 0;
+};
+
+export { compareValues };

package/dist/compat/_internal/isKey.mjs

@@ -10,7 +10,7 @@ function isKey(value, object) {
         return true;
     }
     return ((typeof value === 'string' && (regexIsPlainProp.test(value) || !regexIsDeepProp.test(value))) ||
-        (object != null && Object.hasOwn(object, value)));
+        (object != null));
 }
 
 export { isKey };

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

@@ -1,14 +1,14 @@
 /**
  * Sorts an array of objects based on multiple properties and their corresponding order directions.
  *
- * This function takes an array of objects, an array of keys to sort by, and an array of order directions.
+ * This function takes an array of objects, an array of criteria to sort by, and an array of order directions.
  * It returns the sorted array, ordering by each key according to its corresponding direction
  * ('asc' for ascending or 'desc' for descending). If values for a key are equal,string
  * it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param {T[] | null} collection - The array of objects to be sorted.
- * @param {((item: T) => unknown) | string | Array<((item: T) => unknown) | string | string[]>} keys - An array of keys (property names or property paths or custom key functions) to sort by.
+ * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {((item: T) => unknown) | PropertyKey | Array<((item: T) => unknown) | PropertyKey | PropertyKey[]>} 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).
  * @returns {T[]} - The sorted array.
  *
@@ -29,6 +29,6 @@
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T extends object>(collection: T[] | null | undefined, keys?: ((item: T) => unknown) | string | Array<((item: T) => unknown) | string | string[]>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T>(collection: T[] | object | null | undefined, criteria?: ((item: T) => unknown) | PropertyKey | Array<((item: T) => unknown) | PropertyKey | PropertyKey[]>, orders?: unknown | unknown[]): T[];
 
 export { orderBy };

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

@@ -1,14 +1,14 @@
 /**
  * Sorts an array of objects based on multiple properties and their corresponding order directions.
  *
- * This function takes an array of objects, an array of keys to sort by, and an array of order directions.
+ * This function takes an array of objects, an array of criteria to sort by, and an array of order directions.
  * It returns the sorted array, ordering by each key according to its corresponding direction
  * ('asc' for ascending or 'desc' for descending). If values for a key are equal,string
  * it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param {T[] | null} collection - The array of objects to be sorted.
- * @param {((item: T) => unknown) | string | Array<((item: T) => unknown) | string | string[]>} keys - An array of keys (property names or property paths or custom key functions) to sort by.
+ * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {((item: T) => unknown) | PropertyKey | Array<((item: T) => unknown) | PropertyKey | PropertyKey[]>} 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).
  * @returns {T[]} - The sorted array.
  *
@@ -29,6 +29,6 @@
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T extends object>(collection: T[] | null | undefined, keys?: ((item: T) => unknown) | string | Array<((item: T) => unknown) | string | string[]>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T>(collection: T[] | object | null | undefined, criteria?: ((item: T) => unknown) | PropertyKey | Array<((item: T) => unknown) | PropertyKey | PropertyKey[]>, orders?: unknown | unknown[]): T[];
 
 export { orderBy };

package/dist/compat/array/orderBy.mjs

@@ -1,44 +1,59 @@
-import { getPath } from '../_internal/getPath.mjs';
+import { compareValues } from '../_internal/compareValues.mjs';
+import { isKey } from '../_internal/isKey.mjs';
+import { toPath } from '../_internal/toPath.mjs';
 
-function orderBy(collection, keys, orders) {
+function orderBy(collection, criteria, orders) {
     if (collection == null) {
         return [];
     }
-    if (!Array.isArray(keys)) {
-        keys = keys == null ? [] : [keys];
+    if (!Array.isArray(collection) && typeof collection === 'object') {
+        collection = Object.values(collection);
+    }
+    if (!Array.isArray(criteria)) {
+        criteria = criteria == null ? [] : [criteria];
     }
     if (!Array.isArray(orders)) {
         orders = orders == null ? [] : [orders];
     }
-    const compareValues = (a, b, order) => {
-        if (a < b) {
-            return order === 'desc' ? 1 : -1;
-        }
-        if (a > b) {
-            return order === 'desc' ? -1 : 1;
+    const getValueByNestedPath = (object, path) => {
+        let target = object;
+        for (let i = 0; i < path.length && target != null; i++) {
+            target = target[path[i]];
         }
-        return 0;
+        return target;
     };
-    const getValueByPath = (path, obj) => {
-        if (Array.isArray(path)) {
-            let value = obj;
-            for (let i = 0; i < path.length; i++) {
-                value = value[path[i]];
-            }
-            return value;
+    const getValueByCriterion = (criterion, object) => {
+        if (object == null) {
+            return object;
+        }
+        if (typeof criterion === 'function') {
+            return criterion(object);
         }
-        if (typeof path === 'function') {
-            return path(obj);
+        if (Array.isArray(criterion)) {
+            return getValueByNestedPath(object, criterion);
         }
-        return obj[path];
+        if (typeof criterion !== 'object') {
+            return object[criterion];
+        }
+        if (Object.hasOwn(object, criterion.key)) {
+            return object[criterion.key];
+        }
+        return getValueByNestedPath(object, criterion.path);
     };
-    keys = keys.map(key => getPath(key, collection[0]));
+    const preparedCriteria = criteria.map(criterion => {
+        if (Array.isArray(criterion) && criterion.length === 1) {
+            criterion = criterion[0];
+        }
+        if (typeof criterion === 'function' || Array.isArray(criterion) || isKey(criterion)) {
+            return criterion;
+        }
+        return { key: criterion, path: toPath(criterion) };
+    });
     return collection.slice().sort((a, b) => {
-        for (let i = 0; i < keys.length; i++) {
-            const path = keys[i];
-            const valueA = getValueByPath(path, a);
-            const valueB = getValueByPath(path, b);
+        for (let i = 0; i < criteria.length; i++) {
             const order = String(orders[i]);
+            const valueA = getValueByCriterion(preparedCriteria[i], a);
+            const valueB = getValueByCriterion(preparedCriteria[i], b);
             const comparedResult = compareValues(valueA, valueB, order);
             if (comparedResult !== 0) {
                 return comparedResult;

package/dist/compat/index.d.mts

@@ -1,3 +1,4 @@
+export { at } from '../array/at.mjs';
 export { compact } from '../array/compact.mjs';
 export { countBy } from '../array/countBy.mjs';
 export { differenceBy } from '../array/differenceBy.mjs';

package/dist/compat/index.d.ts

@@ -1,3 +1,4 @@
+export { at } from '../array/at.js';
 export { compact } from '../array/compact.js';
 export { countBy } from '../array/countBy.js';
 export { differenceBy } from '../array/differenceBy.js';

package/dist/compat/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const initial = require('../_chunk/initial-DHQAoT.js');
+const initial = require('../_chunk/initial-Ci2bn_.js');
 const promise_index = require('../_chunk/index-CoqN5B.js');
 const function_index = require('../function/index.js');
 const math_index = require('../math/index.js');
@@ -426,6 +426,16 @@ function flattenDepth(value, depth = 1) {
     return flatten(value, depth);
 }
 
+const compareValues = (a, b, order) => {
+    if ((a != null && b == null) || a < b) {
+        return order === 'desc' ? 1 : -1;
+    }
+    if ((a == null && b != null) || a > b) {
+        return order === 'desc' ? -1 : 1;
+    }
+    return 0;
+};
+
 const regexIsDeepProp = /\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/;
 const regexIsPlainProp = /^\w*$/;
 function isKey(value, object) {
@@ -436,74 +446,61 @@ function isKey(value, object) {
         return true;
     }
     return ((typeof value === 'string' && (regexIsPlainProp.test(value) || !regexIsDeepProp.test(value))) ||
-        (object != null && Object.hasOwn(object, value)));
-}
-
-function getPath(key, object) {
-    if (Array.isArray(key)) {
-        const path = [];
-        let target = object;
-        for (let i = 0; i < key.length; i++) {
-            const k = key[i];
-            if (isKey(k, target)) {
-                target = target[k];
-                path.push(k);
-            }
-            else {
-                const keys = toPath(k);
-                for (let i = 0; i < keys.length; i++) {
-                    target = target[keys[i]];
-                    path.push(keys[i]);
-                }
-            }
-        }
-        return path;
-    }
-    if (typeof key === 'function' || isKey(key, object)) {
-        return key;
-    }
-    return toPath(key);
+        (object != null));
 }
 
-function orderBy(collection, keys, orders) {
+function orderBy(collection, criteria, orders) {
     if (collection == null) {
         return [];
     }
-    if (!Array.isArray(keys)) {
-        keys = keys == null ? [] : [keys];
+    if (!Array.isArray(collection) && typeof collection === 'object') {
+        collection = Object.values(collection);
+    }
+    if (!Array.isArray(criteria)) {
+        criteria = criteria == null ? [] : [criteria];
     }
     if (!Array.isArray(orders)) {
         orders = orders == null ? [] : [orders];
     }
-    const compareValues = (a, b, order) => {
-        if (a < b) {
-            return order === 'desc' ? 1 : -1;
-        }
-        if (a > b) {
-            return order === 'desc' ? -1 : 1;
+    const getValueByNestedPath = (object, path) => {
+        let target = object;
+        for (let i = 0; i < path.length && target != null; i++) {
+            target = target[path[i]];
         }
-        return 0;
+        return target;
     };
-    const getValueByPath = (path, obj) => {
-        if (Array.isArray(path)) {
-            let value = obj;
-            for (let i = 0; i < path.length; i++) {
-                value = value[path[i]];
-            }
-            return value;
+    const getValueByCriterion = (criterion, object) => {
+        if (object == null) {
+            return object;
         }
-        if (typeof path === 'function') {
-            return path(obj);
+        if (typeof criterion === 'function') {
+            return criterion(object);
         }
-        return obj[path];
+        if (Array.isArray(criterion)) {
+            return getValueByNestedPath(object, criterion);
+        }
+        if (typeof criterion !== 'object') {
+            return object[criterion];
+        }
+        if (Object.hasOwn(object, criterion.key)) {
+            return object[criterion.key];
+        }
+        return getValueByNestedPath(object, criterion.path);
     };
-    keys = keys.map(key => getPath(key, collection[0]));
+    const preparedCriteria = criteria.map(criterion => {
+        if (Array.isArray(criterion) && criterion.length === 1) {
+            criterion = criterion[0];
+        }
+        if (typeof criterion === 'function' || Array.isArray(criterion) || isKey(criterion)) {
+            return criterion;
+        }
+        return { key: criterion, path: toPath(criterion) };
+    });
     return collection.slice().sort((a, b) => {
-        for (let i = 0; i < keys.length; i++) {
-            const path = keys[i];
-            const valueA = getValueByPath(path, a);
-            const valueB = getValueByPath(path, b);
+        for (let i = 0; i < criteria.length; i++) {
             const order = String(orders[i]);
+            const valueA = getValueByCriterion(preparedCriteria[i], a);
+            const valueB = getValueByCriterion(preparedCriteria[i], b);
             const comparedResult = compareValues(valueA, valueB, order);
             if (comparedResult !== 0) {
                 return comparedResult;
@@ -820,6 +817,7 @@ function min(items = []) {
     return minElement;
 }
 
+exports.at = initial.at;
 exports.compact = initial.compact;
 exports.countBy = initial.countBy;
 exports.differenceBy = initial.differenceBy;

package/dist/compat/index.mjs

@@ -1,3 +1,4 @@
+export { at } from '../array/at.mjs';
 export { compact } from '../array/compact.mjs';
 export { countBy } from '../array/countBy.mjs';
 export { differenceBy } from '../array/differenceBy.mjs';

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+export { at } from './array/at.mjs';
 export { chunk } from './array/chunk.mjs';
 export { compact } from './array/compact.mjs';
 export { countBy } from './array/countBy.mjs';

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { at } from './array/at.js';
 export { chunk } from './array/chunk.js';
 export { compact } from './array/compact.js';
 export { countBy } from './array/countBy.js';

package/dist/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const initial = require('./_chunk/initial-DHQAoT.js');
+const initial = require('./_chunk/initial-Ci2bn_.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-CoqN5B.js');
 const function_index = require('./function/index.js');
@@ -17,6 +17,7 @@ const string_index = require('./string/index.js');
 
 
 
+exports.at = initial.at;
 exports.chunk = initial.chunk;
 exports.compact = initial.compact;
 exports.countBy = initial.countBy;

package/dist/index.mjs

@@ -1,3 +1,4 @@
+export { at } from './array/at.mjs';
 export { chunk } from './array/chunk.mjs';
 export { compact } from './array/compact.mjs';
 export { countBy } from './array/countBy.mjs';

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.16.0-dev.496+58393854",
+  "version": "1.16.0-dev.499+f3620d76",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

package/dist/compat/_internal/getPath.mjs

@@ -1,30 +0,0 @@
-import { isKey } from './isKey.mjs';
-import { toPath } from './toPath.mjs';
-
-function getPath(key, object) {
-    if (Array.isArray(key)) {
-        const path = [];
-        let target = object;
-        for (let i = 0; i < key.length; i++) {
-            const k = key[i];
-            if (isKey(k, target)) {
-                target = target[k];
-                path.push(k);
-            }
-            else {
-                const keys = toPath(k);
-                for (let i = 0; i < keys.length; i++) {
-                    target = target[keys[i]];
-                    path.push(keys[i]);
-                }
-            }
-        }
-        return path;
-    }
-    if (typeof key === 'function' || isKey(key, object)) {
-        return key;
-    }
-    return toPath(key);
-}
-
-export { getPath };