es-toolkit 1.36.0-dev.1237 → 1.36.0-dev.1239

package/dist/compat/_internal/compareValues.mjs

@@ -15,9 +15,6 @@ function getPriority(a) {
 }
 const compareValues = (a, b, order) => {
     if (a !== b) {
-        if (typeof a === 'string' && typeof b === 'string') {
-            return order === 'desc' ? b.localeCompare(a) : a.localeCompare(b);
-        }
         const aPriority = getPriority(a);
         const bPriority = getPriority(b);
         if (aPriority === bPriority && aPriority === 0) {

package/dist/compat/compat.d.mts

@@ -206,6 +206,7 @@ export { pick } from './object/pick.mjs';
 export { pickBy } from './object/pickBy.mjs';
 export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
+export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';

package/dist/compat/compat.d.ts

@@ -206,6 +206,7 @@ export { pick } from './object/pick.js';
 export { pickBy } from './object/pickBy.js';
 export { property } from './object/property.js';
 export { propertyOf } from './object/propertyOf.js';
+export { result } from './object/result.js';
 export { set } from './object/set.js';
 export { toDefaulted } from './object/toDefaulted.js';
 export { toPairs } from './object/toPairs.js';

package/dist/compat/compat.mjs

@@ -211,6 +211,7 @@ export { pick } from './object/pick.mjs';
 export { pickBy } from './object/pickBy.mjs';
 export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
+export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';

package/dist/compat/index.d.mts

@@ -206,6 +206,7 @@ export { pick } from './object/pick.mjs';
 export { pickBy } from './object/pickBy.mjs';
 export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
+export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';

package/dist/compat/index.d.ts

@@ -206,6 +206,7 @@ export { pick } from './object/pick.js';
 export { pickBy } from './object/pickBy.js';
 export { property } from './object/property.js';
 export { propertyOf } from './object/propertyOf.js';
+export { result } from './object/result.js';
 export { set } from './object/set.js';
 export { toDefaulted } from './object/toDefaulted.js';
 export { toPairs } from './object/toPairs.js';

package/dist/compat/index.js

@@ -1107,9 +1107,6 @@ function getPriority(a) {
 }
 const compareValues = (a, b, order) => {
     if (a !== b) {
-        if (typeof a === 'string' && typeof b === 'string') {
-            return order === 'desc' ? b.localeCompare(a) : a.localeCompare(b);
-        }
         const aPriority = getPriority(a);
         const bPriority = getPriority(b);
         if (aPriority === bPriority && aPriority === 0) {
@@ -3309,6 +3306,22 @@ function propertyOf(object) {
     };
 }
 
+function result(object, path, defaultValue) {
+    const resolvedPath = Array.isArray(path) ? path : isKey(path, object) ? [path] : toPath(String(path));
+    const length = resolvedPath.length;
+    for (let index = 0; index < (length || 1); index++) {
+        const key = toKey(resolvedPath[index]);
+        const value = object == null ? undefined : object[key];
+        if (value === undefined) {
+            object =
+                typeof defaultValue === 'function' ? defaultValue.call(object) : defaultValue;
+            break;
+        }
+        object = typeof value === 'function' ? value.call(object) : value;
+    }
+    return object;
+}
+
 function toDefaulted(object, ...sources) {
     const cloned = cloneDeep(object);
     return defaults(cloned, ...sources);
@@ -4265,6 +4278,7 @@ const compat = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     repeat,
     replace,
     rest,
+    result,
     retry: unary.retry,
     reverse,
     reverseString: upperFirst$1.reverseString,
@@ -4609,6 +4623,7 @@ exports.remove = remove;
 exports.repeat = repeat;
 exports.replace = replace;
 exports.rest = rest;
+exports.result = result;
 exports.reverse = reverse;
 exports.round = round;
 exports.sample = sample;

package/dist/compat/index.mjs

@@ -211,6 +211,7 @@ export { pick } from './object/pick.mjs';
 export { pickBy } from './object/pickBy.mjs';
 export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
+export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';

package/dist/compat/object/result.d.mts

@@ -0,0 +1,34 @@
+/**
+ * Retrieves the value at a given path of an object.
+ * If the resolved value is a function, it is invoked with the object as its `this` context.
+ * If the value is `undefined`, the `defaultValue` is returned.
+ *
+ * @template T - The expected return type.
+ * @param {unknown} object - The object to query.
+ * @param {string | number | symbol | ReadonlyArray<string | number | symbol>} path - The path of the property to get.
+ * @param {T | ((...args: unknown[]) => T)} [defaultValue] - The value returned if the resolved value is `undefined`.
+ * @returns {T} - Returns the resolved value.
+ *
+ * @example
+ * const obj = { a: { b: { c: 3 } } };
+ * result(obj, 'a.b.c');
+ * // => 3
+ *
+ * @example
+ * const obj = { a: () => 5 };
+ * result(obj, 'a');
+ * // => 5 (calls the function `a` and returns its result)
+ *
+ * @example
+ * const obj = { a: { b: null } };
+ * result(obj, 'a.b.c', 'default');
+ * // => 'default'
+ *
+ * @example
+ * const obj = { a: { b: { c: 3 } } };
+ * result(obj, 'a.b.d', () => 'default');
+ * // => 'default'
+ */
+declare function result<T>(object: unknown, path: string | number | symbol | ReadonlyArray<string | number | symbol>, defaultValue?: T | ((...args: unknown[]) => T)): T;
+
+export { result };

package/dist/compat/object/result.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Retrieves the value at a given path of an object.
+ * If the resolved value is a function, it is invoked with the object as its `this` context.
+ * If the value is `undefined`, the `defaultValue` is returned.
+ *
+ * @template T - The expected return type.
+ * @param {unknown} object - The object to query.
+ * @param {string | number | symbol | ReadonlyArray<string | number | symbol>} path - The path of the property to get.
+ * @param {T | ((...args: unknown[]) => T)} [defaultValue] - The value returned if the resolved value is `undefined`.
+ * @returns {T} - Returns the resolved value.
+ *
+ * @example
+ * const obj = { a: { b: { c: 3 } } };
+ * result(obj, 'a.b.c');
+ * // => 3
+ *
+ * @example
+ * const obj = { a: () => 5 };
+ * result(obj, 'a');
+ * // => 5 (calls the function `a` and returns its result)
+ *
+ * @example
+ * const obj = { a: { b: null } };
+ * result(obj, 'a.b.c', 'default');
+ * // => 'default'
+ *
+ * @example
+ * const obj = { a: { b: { c: 3 } } };
+ * result(obj, 'a.b.d', () => 'default');
+ * // => 'default'
+ */
+declare function result<T>(object: unknown, path: string | number | symbol | ReadonlyArray<string | number | symbol>, defaultValue?: T | ((...args: unknown[]) => T)): T;
+
+export { result };

package/dist/compat/object/result.mjs

@@ -0,0 +1,21 @@
+import { isKey } from '../_internal/isKey.mjs';
+import { toKey } from '../_internal/toKey.mjs';
+import { toPath } from '../util/toPath.mjs';
+
+function result(object, path, defaultValue) {
+    const resolvedPath = Array.isArray(path) ? path : isKey(path, object) ? [path] : toPath(String(path));
+    const length = resolvedPath.length;
+    for (let index = 0; index < (length || 1); index++) {
+        const key = toKey(resolvedPath[index]);
+        const value = object == null ? undefined : object[key];
+        if (value === undefined) {
+            object =
+                typeof defaultValue === 'function' ? defaultValue.call(object) : defaultValue;
+            break;
+        }
+        object = typeof value === 'function' ? value.call(object) : value;
+    }
+    return object;
+}
+
+export { result };

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.36.0-dev.1237+cf65b69c",
+  "version": "1.36.0-dev.1239+0a3da79d",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {