es-toolkit 1.37.2-dev.1256 → 1.37.2-dev.1257

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

@@ -0,0 +1,43 @@
+/**
+ * Invokes the method at `path` of each element in `collection`, returning
+ * an array of the results of each invoked method. Any additional arguments
+ * are provided to each invoked method. If `path` is a function, it's invoked
+ * for, and `this` bound to, each element in `collection`.
+ *
+ * @template T The type of the elements in the collection.
+ * @template R The type of the resolved values from the invoked methods.
+ * @param {T[] | Record<string, T> | null | undefined} collection The collection to iterate over.
+ * @param {PropertyKey | PropertyKey[] | ((this: T, ...args: unknown[]) => R)} path The path of the method to invoke (string, number, symbol, or an array of these) or the function to invoke.
+ * @param {...unknown} [args] The arguments to invoke each method with.
+ * @returns {Array<R | undefined>} Returns the array of results. Elements are `undefined` if the path is not found or the method invocation results in `undefined`.
+ *
+ * @example
+ * // Invoke a method on each element
+ * invokeMap(['a', 'b', 'c'], 'toUpperCase');
+ * // => ['A', 'B', 'C']
+ *
+ * // Invoke a method with arguments
+ * invokeMap([[5, 1, 7], [3, 2, 1]], 'sort');
+ * // => [[1, 5, 7], [1, 2, 3]]
+ *
+ * // Invoke a method on each value in an object
+ * invokeMap({ a: 1, b: 2, c: 3 }, 'toFixed', 1);
+ * // => ['1.0', '2.0', '3.0']
+ *
+ * // Use a function instead of a method name
+ * invokeMap(
+ *   ['a', 'b', 'c'],
+ *   function(this: string, prefix: string, suffix: string) {
+ *     return prefix + this.toUpperCase() + suffix;
+ *   },
+ *   '(',
+ *   ')'
+ * );
+ * // => ['(A)', '(B)', '(C)']
+ *
+ * invokeMap([123, 456], String.prototype.split, '');
+ * // => [['1', '2', '3'], ['4', '5', '6']]
+ */
+declare function invokeMap<T, R>(collection: T[] | Record<string, T> | null | undefined, path: PropertyKey | PropertyKey[] | ((this: T, ...args: any[]) => R), ...args: unknown[]): Array<R | undefined>;
+
+export { invokeMap };

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

@@ -0,0 +1,43 @@
+/**
+ * Invokes the method at `path` of each element in `collection`, returning
+ * an array of the results of each invoked method. Any additional arguments
+ * are provided to each invoked method. If `path` is a function, it's invoked
+ * for, and `this` bound to, each element in `collection`.
+ *
+ * @template T The type of the elements in the collection.
+ * @template R The type of the resolved values from the invoked methods.
+ * @param {T[] | Record<string, T> | null | undefined} collection The collection to iterate over.
+ * @param {PropertyKey | PropertyKey[] | ((this: T, ...args: unknown[]) => R)} path The path of the method to invoke (string, number, symbol, or an array of these) or the function to invoke.
+ * @param {...unknown} [args] The arguments to invoke each method with.
+ * @returns {Array<R | undefined>} Returns the array of results. Elements are `undefined` if the path is not found or the method invocation results in `undefined`.
+ *
+ * @example
+ * // Invoke a method on each element
+ * invokeMap(['a', 'b', 'c'], 'toUpperCase');
+ * // => ['A', 'B', 'C']
+ *
+ * // Invoke a method with arguments
+ * invokeMap([[5, 1, 7], [3, 2, 1]], 'sort');
+ * // => [[1, 5, 7], [1, 2, 3]]
+ *
+ * // Invoke a method on each value in an object
+ * invokeMap({ a: 1, b: 2, c: 3 }, 'toFixed', 1);
+ * // => ['1.0', '2.0', '3.0']
+ *
+ * // Use a function instead of a method name
+ * invokeMap(
+ *   ['a', 'b', 'c'],
+ *   function(this: string, prefix: string, suffix: string) {
+ *     return prefix + this.toUpperCase() + suffix;
+ *   },
+ *   '(',
+ *   ')'
+ * );
+ * // => ['(A)', '(B)', '(C)']
+ *
+ * invokeMap([123, 456], String.prototype.split, '');
+ * // => [['1', '2', '3'], ['4', '5', '6']]
+ */
+declare function invokeMap<T, R>(collection: T[] | Record<string, T> | null | undefined, path: PropertyKey | PropertyKey[] | ((this: T, ...args: any[]) => R), ...args: unknown[]): Array<R | undefined>;
+
+export { invokeMap };

package/dist/compat/array/invokeMap.mjs

@@ -0,0 +1,36 @@
+import { isFunction } from '../../predicate/isFunction.mjs';
+import { isNil } from '../../predicate/isNil.mjs';
+import { get } from '../object/get.mjs';
+import { isArrayLike } from '../predicate/isArrayLike.mjs';
+
+function invokeMap(collection, path, ...args) {
+    if (isNil(collection)) {
+        return [];
+    }
+    const values = isArrayLike(collection) ? Array.from(collection) : Object.values(collection);
+    const result = [];
+    for (let i = 0; i < values.length; i++) {
+        const value = values[i];
+        if (isFunction(path)) {
+            result.push(path.apply(value, args));
+            continue;
+        }
+        const method = get(value, path);
+        let thisContext = value;
+        if (Array.isArray(path)) {
+            const pathExceptLast = path.slice(0, -1);
+            if (pathExceptLast.length > 0) {
+                thisContext = get(value, pathExceptLast);
+            }
+        }
+        else if (typeof path === 'string' && path.includes('.')) {
+            const parts = path.split('.');
+            const pathExceptLast = parts.slice(0, -1).join('.');
+            thisContext = get(value, pathExceptLast);
+        }
+        result.push(method == null ? undefined : method.apply(thisContext, args));
+    }
+    return result;
+}
+
+export { invokeMap };

package/dist/compat/compat.d.mts

@@ -30,6 +30,7 @@ export { initial } from './array/initial.mjs';
 export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { intersectionWith } from './array/intersectionWith.mjs';
+export { invokeMap } from './array/invokeMap.mjs';
 export { join } from './array/join.mjs';
 export { keyBy } from './array/keyBy.mjs';
 export { last } from './array/last.mjs';

package/dist/compat/compat.d.ts

@@ -30,6 +30,7 @@ export { initial } from './array/initial.js';
 export { intersection } from './array/intersection.js';
 export { intersectionBy } from './array/intersectionBy.js';
 export { intersectionWith } from './array/intersectionWith.js';
+export { invokeMap } from './array/invokeMap.js';
 export { join } from './array/join.js';
 export { keyBy } from './array/keyBy.js';
 export { last } from './array/last.js';

package/dist/compat/compat.mjs

@@ -30,6 +30,7 @@ export { initial } from './array/initial.mjs';
 export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { intersectionWith } from './array/intersectionWith.mjs';
+export { invokeMap } from './array/invokeMap.mjs';
 export { join } from './array/join.mjs';
 export { keyBy } from './array/keyBy.mjs';
 export { last } from './array/last.mjs';

package/dist/compat/index.d.mts

@@ -30,6 +30,7 @@ export { initial } from './array/initial.mjs';
 export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { intersectionWith } from './array/intersectionWith.mjs';
+export { invokeMap } from './array/invokeMap.mjs';
 export { join } from './array/join.mjs';
 export { keyBy } from './array/keyBy.mjs';
 export { last } from './array/last.mjs';

package/dist/compat/index.d.ts

@@ -30,6 +30,7 @@ export { initial } from './array/initial.js';
 export { intersection } from './array/intersection.js';
 export { intersectionBy } from './array/intersectionBy.js';
 export { intersectionWith } from './array/intersectionWith.js';
+export { invokeMap } from './array/invokeMap.js';
 export { join } from './array/join.js';
 export { keyBy } from './array/keyBy.js';
 export { last } from './array/last.js';

package/dist/compat/index.js

@@ -1056,6 +1056,36 @@ function uniqPreserve0(arr) {
     return result;
 }
 
+function invokeMap(collection, path, ...args) {
+    if (isWeakSet$1.isNil(collection)) {
+        return [];
+    }
+    const values = isArrayLike(collection) ? Array.from(collection) : Object.values(collection);
+    const result = [];
+    for (let i = 0; i < values.length; i++) {
+        const value = values[i];
+        if (isWeakSet$1.isFunction(path)) {
+            result.push(path.apply(value, args));
+            continue;
+        }
+        const method = get(value, path);
+        let thisContext = value;
+        if (Array.isArray(path)) {
+            const pathExceptLast = path.slice(0, -1);
+            if (pathExceptLast.length > 0) {
+                thisContext = get(value, pathExceptLast);
+            }
+        }
+        else if (typeof path === 'string' && path.includes('.')) {
+            const parts = path.split('.');
+            const pathExceptLast = parts.slice(0, -1).join('.');
+            thisContext = get(value, pathExceptLast);
+        }
+        result.push(method == null ? undefined : method.apply(thisContext, args));
+    }
+    return result;
+}
+
 function join(array, separator = ',') {
     if (!isArrayLike(array)) {
         return '';
@@ -4251,6 +4281,7 @@ const compat = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     invert: isPlainObject.invert,
     invertBy,
     invoke,
+    invokeMap,
     isArguments,
     isArray: isPlainObject.isArray,
     isArrayBuffer,
@@ -4561,6 +4592,7 @@ exports.intersectionBy = intersectionBy;
 exports.intersectionWith = intersectionWith;
 exports.invertBy = invertBy;
 exports.invoke = invoke;
+exports.invokeMap = invokeMap;
 exports.isArguments = isArguments;
 exports.isArrayBuffer = isArrayBuffer;
 exports.isArrayLike = isArrayLike;

package/dist/compat/index.mjs

@@ -30,6 +30,7 @@ export { initial } from './array/initial.mjs';
 export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { intersectionWith } from './array/intersectionWith.mjs';
+export { invokeMap } from './array/invokeMap.mjs';
 export { join } from './array/join.mjs';
 export { keyBy } from './array/keyBy.mjs';
 export { last } from './array/last.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.37.2-dev.1256+5f76be6a",
+  "version": "1.37.2-dev.1257+d4eeda38",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {