es-toolkit 1.45.1-dev.1776 → 1.45.1-dev.1777

package/dist/map/index.d.mts

@@ -3,6 +3,7 @@ export { filter } from './filter.mjs';
 export { findKey } from './findKey.mjs';
 export { findValue } from './findValue.mjs';
 export { hasValue } from './hasValue.mjs';
+export { keyBy } from './keyBy.mjs';
 export { mapKeys } from './mapKeys.mjs';
 export { mapValues } from './mapValues.mjs';
 export { reduce } from './reduce.mjs';

package/dist/map/index.d.ts

@@ -3,6 +3,7 @@ export { filter } from './filter.js';
 export { findKey } from './findKey.js';
 export { findValue } from './findValue.js';
 export { hasValue } from './hasValue.js';
+export { keyBy } from './keyBy.js';
 export { mapKeys } from './mapKeys.js';
 export { mapValues } from './mapValues.js';
 export { reduce } from './reduce.js';

package/dist/map/index.js

@@ -7,6 +7,7 @@ const filter = require('./filter.js');
 const findKey = require('./findKey.js');
 const findValue = require('./findValue.js');
 const hasValue = require('./hasValue.js');
+const keyBy = require('./keyBy.js');
 const mapKeys = require('./mapKeys.js');
 const mapValues = require('./mapValues.js');
 const reduce = require('./reduce.js');
@@ -19,6 +20,7 @@ exports.filter = filter.filter;
 exports.findKey = findKey.findKey;
 exports.findValue = findValue.findValue;
 exports.hasValue = hasValue.hasValue;
+exports.keyBy = keyBy.keyBy;
 exports.mapKeys = mapKeys.mapKeys;
 exports.mapValues = mapValues.mapValues;
 exports.reduce = reduce.reduce;

package/dist/map/index.mjs

@@ -3,6 +3,7 @@ export { filter } from './filter.mjs';
 export { findKey } from './findKey.mjs';
 export { findValue } from './findValue.mjs';
 export { hasValue } from './hasValue.mjs';
+export { keyBy } from './keyBy.mjs';
 export { mapKeys } from './mapKeys.mjs';
 export { mapValues } from './mapValues.mjs';
 export { reduce } from './reduce.mjs';

package/dist/map/keyBy.d.mts

@@ -0,0 +1,31 @@
+/**
+ * Maps each entry of a Map based on a provided key-generating function.
+ *
+ * This function takes a Map and a function that generates a key from each value-key pair.
+ * It returns a new Map where the keys are generated by the key function and the values are
+ * the corresponding values from the original map. If multiple entries produce the same key,
+ * the last value encountered will be used.
+ *
+ * @template K - The type of keys in the original Map.
+ * @template V - The type of values in the original Map.
+ * @template K2 - The type of keys to produce in the returned Map.
+ * @param {Map<K, V>} map - The map of entries to be mapped.
+ * @param {(value: V, key: K, object: Map<K, V>) => K2} getKeyFromEntry - A function that generates a key from a value-key pair.
+ * @returns {Map<K2, V>} A Map where the generated keys are mapped to each entry's value.
+ *
+ * @example
+ * const map = new Map([
+ *   ['x', { type: 'fruit', name: 'apple' }],
+ *   ['y', { type: 'fruit', name: 'banana' }],
+ *   ['z', { type: 'vegetable', name: 'carrot' }]
+ * ]);
+ * const result = keyBy(map, item => item.type);
+ * // result will be:
+ * // Map(2) {
+ * //   'fruit' => { type: 'fruit', name: 'banana' },
+ * //   'vegetable' => { type: 'vegetable', name: 'carrot' }
+ * // }
+ */
+declare function keyBy<K, V, K2>(map: Map<K, V>, getKeyFromEntry: (value: V, key: K, object: Map<K, V>) => K2): Map<K2, V>;
+
+export { keyBy };

package/dist/map/keyBy.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Maps each entry of a Map based on a provided key-generating function.
+ *
+ * This function takes a Map and a function that generates a key from each value-key pair.
+ * It returns a new Map where the keys are generated by the key function and the values are
+ * the corresponding values from the original map. If multiple entries produce the same key,
+ * the last value encountered will be used.
+ *
+ * @template K - The type of keys in the original Map.
+ * @template V - The type of values in the original Map.
+ * @template K2 - The type of keys to produce in the returned Map.
+ * @param {Map<K, V>} map - The map of entries to be mapped.
+ * @param {(value: V, key: K, object: Map<K, V>) => K2} getKeyFromEntry - A function that generates a key from a value-key pair.
+ * @returns {Map<K2, V>} A Map where the generated keys are mapped to each entry's value.
+ *
+ * @example
+ * const map = new Map([
+ *   ['x', { type: 'fruit', name: 'apple' }],
+ *   ['y', { type: 'fruit', name: 'banana' }],
+ *   ['z', { type: 'vegetable', name: 'carrot' }]
+ * ]);
+ * const result = keyBy(map, item => item.type);
+ * // result will be:
+ * // Map(2) {
+ * //   'fruit' => { type: 'fruit', name: 'banana' },
+ * //   'vegetable' => { type: 'vegetable', name: 'carrot' }
+ * // }
+ */
+declare function keyBy<K, V, K2>(map: Map<K, V>, getKeyFromEntry: (value: V, key: K, object: Map<K, V>) => K2): Map<K2, V>;
+
+export { keyBy };

package/dist/map/keyBy.js

@@ -0,0 +1,14 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+function keyBy(map, getKeyFromEntry) {
+    const result = new Map();
+    for (const [key, value] of map) {
+        const newKey = getKeyFromEntry(value, key, map);
+        result.set(newKey, value);
+    }
+    return result;
+}
+
+exports.keyBy = keyBy;

package/dist/map/keyBy.mjs

@@ -0,0 +1,10 @@
+function keyBy(map, getKeyFromEntry) {
+    const result = new Map();
+    for (const [key, value] of map) {
+        const newKey = getKeyFromEntry(value, key, map);
+        result.set(newKey, value);
+    }
+    return result;
+}
+
+export { keyBy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.45.1-dev.1776+d7851489",
+  "version": "1.45.1-dev.1777+b4c3cb45",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",