es-toolkit 1.46.0-dev.1789 → 1.46.0-dev.1791

package/dist/map/countBy.d.mts

@@ -0,0 +1,35 @@
+/**
+ * Counts the occurrences of items in a Map based on a transformation function.
+ *
+ * This function takes a Map and a function that generates a key from each value-key pair.
+ * It returns an object with the generated keys as properties and their counts as values.
+ * The count is incremented for each entry for which the transformation produces the same key.
+ *
+ * @template K - The type of the Map's keys.
+ * @template V - The type of the Map's values.
+ * @template K2 - The type of keys produced by the transformation function.
+ * @param {Map<K, V>} map - The Map to count occurrences from.
+ * @param {(value: V, key: K, object: Map<K, V>) => K2} mapper - The function to produce a key for counting.
+ * @returns {Record<K2, number>} An object containing the mapped keys and their counts.
+ *
+ * @example
+ * const map = new Map([
+ *   ['a', 1],
+ *   ['b', 2],
+ *   ['c', 1]
+ * ]);
+ * const result = countBy(map, (value) => value);
+ * // result will be { 1: 2, 2: 1 }
+ *
+ * @example
+ * const map = new Map([
+ *   ['alice', 20],
+ *   ['bob', 30],
+ *   ['carol', 20]
+ * ]);
+ * const result = countBy(map, (value, key) => key[0]);
+ * // result will be { a: 1, b: 1, c: 1 }
+ */
+declare function countBy<K, V, K2 extends PropertyKey>(map: Map<K, V>, mapper: (value: V, key: K, object: Map<K, V>) => K2): Map<K2, number>;
+
+export { countBy };

package/dist/map/countBy.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Counts the occurrences of items in a Map based on a transformation function.
+ *
+ * This function takes a Map and a function that generates a key from each value-key pair.
+ * It returns an object with the generated keys as properties and their counts as values.
+ * The count is incremented for each entry for which the transformation produces the same key.
+ *
+ * @template K - The type of the Map's keys.
+ * @template V - The type of the Map's values.
+ * @template K2 - The type of keys produced by the transformation function.
+ * @param {Map<K, V>} map - The Map to count occurrences from.
+ * @param {(value: V, key: K, object: Map<K, V>) => K2} mapper - The function to produce a key for counting.
+ * @returns {Record<K2, number>} An object containing the mapped keys and their counts.
+ *
+ * @example
+ * const map = new Map([
+ *   ['a', 1],
+ *   ['b', 2],
+ *   ['c', 1]
+ * ]);
+ * const result = countBy(map, (value) => value);
+ * // result will be { 1: 2, 2: 1 }
+ *
+ * @example
+ * const map = new Map([
+ *   ['alice', 20],
+ *   ['bob', 30],
+ *   ['carol', 20]
+ * ]);
+ * const result = countBy(map, (value, key) => key[0]);
+ * // result will be { a: 1, b: 1, c: 1 }
+ */
+declare function countBy<K, V, K2 extends PropertyKey>(map: Map<K, V>, mapper: (value: V, key: K, object: Map<K, V>) => K2): Map<K2, number>;
+
+export { countBy };

package/dist/map/countBy.js

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

package/dist/map/countBy.mjs

@@ -0,0 +1,10 @@
+function countBy(map, mapper) {
+    const result = new Map();
+    for (const [key, value] of map) {
+        const mappedKey = mapper(value, key, map);
+        result.set(mappedKey, (result.get(mappedKey) ?? 0) + 1);
+    }
+    return result;
+}
+
+export { countBy };

package/dist/map/forEach.d.mts

@@ -0,0 +1,29 @@
+/**
+ * Executes a provided function once for each entry in a Map.
+ *
+ * This function iterates through all entries of the Map and executes the callback function
+ * for each entry. The callback receives the value, key, and the Map itself as arguments.
+ *
+ * @template K - The type of keys in the Map.
+ * @template V - The type of values in the Map.
+ * @param {Map<K, V>} map - The Map to iterate over.
+ * @param {(value: V, key: K, map: Map<K, V>) => void} callback - A function to execute for each entry.
+ * @returns {void}
+ *
+ * @example
+ * const map = new Map([
+ *   ['a', 1],
+ *   ['b', 2],
+ *   ['c', 3]
+ * ]);
+ * forEach(map, (value, key) => {
+ *   console.log(`${key}: ${value}`);
+ * });
+ * // Output:
+ * // a: 1
+ * // b: 2
+ * // c: 3
+ */
+declare function forEach<K, V>(map: Map<K, V>, callback: (value: V, key: K, map: Map<K, V>) => void): void;
+
+export { forEach };

package/dist/map/forEach.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Executes a provided function once for each entry in a Map.
+ *
+ * This function iterates through all entries of the Map and executes the callback function
+ * for each entry. The callback receives the value, key, and the Map itself as arguments.
+ *
+ * @template K - The type of keys in the Map.
+ * @template V - The type of values in the Map.
+ * @param {Map<K, V>} map - The Map to iterate over.
+ * @param {(value: V, key: K, map: Map<K, V>) => void} callback - A function to execute for each entry.
+ * @returns {void}
+ *
+ * @example
+ * const map = new Map([
+ *   ['a', 1],
+ *   ['b', 2],
+ *   ['c', 3]
+ * ]);
+ * forEach(map, (value, key) => {
+ *   console.log(`${key}: ${value}`);
+ * });
+ * // Output:
+ * // a: 1
+ * // b: 2
+ * // c: 3
+ */
+declare function forEach<K, V>(map: Map<K, V>, callback: (value: V, key: K, map: Map<K, V>) => void): void;
+
+export { forEach };

package/dist/map/forEach.js

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+function forEach(map, callback) {
+    for (const [key, value] of map) {
+        callback(value, key, map);
+    }
+}
+
+exports.forEach = forEach;

package/dist/map/forEach.mjs

@@ -0,0 +1,7 @@
+function forEach(map, callback) {
+    for (const [key, value] of map) {
+        callback(value, key, map);
+    }
+}
+
+export { forEach };

package/dist/map/index.d.mts

@@ -1,7 +1,9 @@
+export { countBy } from './countBy.mjs';
 export { every } from './every.mjs';
 export { filter } from './filter.mjs';
 export { findKey } from './findKey.mjs';
 export { findValue } from './findValue.mjs';
+export { forEach } from './forEach.mjs';
 export { hasValue } from './hasValue.mjs';
 export { keyBy } from './keyBy.mjs';
 export { mapKeys } from './mapKeys.mjs';

package/dist/map/index.d.ts

@@ -1,7 +1,9 @@
+export { countBy } from './countBy.js';
 export { every } from './every.js';
 export { filter } from './filter.js';
 export { findKey } from './findKey.js';
 export { findValue } from './findValue.js';
+export { forEach } from './forEach.js';
 export { hasValue } from './hasValue.js';
 export { keyBy } from './keyBy.js';
 export { mapKeys } from './mapKeys.js';

package/dist/map/index.js

@@ -2,10 +2,12 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
+const countBy = require('./countBy.js');
 const every = require('./every.js');
 const filter = require('./filter.js');
 const findKey = require('./findKey.js');
 const findValue = require('./findValue.js');
+const forEach = require('./forEach.js');
 const hasValue = require('./hasValue.js');
 const keyBy = require('./keyBy.js');
 const mapKeys = require('./mapKeys.js');
@@ -15,10 +17,12 @@ const some = require('./some.js');
 
 
 
+exports.countBy = countBy.countBy;
 exports.every = every.every;
 exports.filter = filter.filter;
 exports.findKey = findKey.findKey;
 exports.findValue = findValue.findValue;
+exports.forEach = forEach.forEach;
 exports.hasValue = hasValue.hasValue;
 exports.keyBy = keyBy.keyBy;
 exports.mapKeys = mapKeys.mapKeys;

package/dist/map/index.mjs

@@ -1,7 +1,9 @@
+export { countBy } from './countBy.mjs';
 export { every } from './every.mjs';
 export { filter } from './filter.mjs';
 export { findKey } from './findKey.mjs';
 export { findValue } from './findValue.mjs';
+export { forEach } from './forEach.mjs';
 export { hasValue } from './hasValue.mjs';
 export { keyBy } from './keyBy.mjs';
 export { mapKeys } from './mapKeys.mjs';

package/dist/set/forEach.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Executes a provided function once for each element in a Set.
+ *
+ * This function iterates through all elements of the Set and executes the callback function
+ * for each element. The callback receives the value twice (for consistency with Map.forEach)
+ * and the Set itself as arguments.
+ *
+ * @template T - The type of elements in the Set.
+ * @param {Set<T>} set - The Set to iterate over.
+ * @param {(value: T, value2: T, set: Set<T>) => void} callback - A function to execute for each element.
+ * @returns {void}
+ *
+ * @example
+ * const set = new Set([1, 2, 3]);
+ * forEach(set, (value) => {
+ *   console.log(value * 2);
+ * });
+ * // Output:
+ * // 2
+ * // 4
+ * // 6
+ */
+declare function forEach<T>(set: Set<T>, callback: (value: T, value2: T, set: Set<T>) => void): void;
+
+export { forEach };

package/dist/set/forEach.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Executes a provided function once for each element in a Set.
+ *
+ * This function iterates through all elements of the Set and executes the callback function
+ * for each element. The callback receives the value twice (for consistency with Map.forEach)
+ * and the Set itself as arguments.
+ *
+ * @template T - The type of elements in the Set.
+ * @param {Set<T>} set - The Set to iterate over.
+ * @param {(value: T, value2: T, set: Set<T>) => void} callback - A function to execute for each element.
+ * @returns {void}
+ *
+ * @example
+ * const set = new Set([1, 2, 3]);
+ * forEach(set, (value) => {
+ *   console.log(value * 2);
+ * });
+ * // Output:
+ * // 2
+ * // 4
+ * // 6
+ */
+declare function forEach<T>(set: Set<T>, callback: (value: T, value2: T, set: Set<T>) => void): void;
+
+export { forEach };

package/dist/set/forEach.js

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+function forEach(set, callback) {
+    for (const value of set) {
+        callback(value, value, set);
+    }
+}
+
+exports.forEach = forEach;

package/dist/set/forEach.mjs

@@ -0,0 +1,7 @@
+function forEach(set, callback) {
+    for (const value of set) {
+        callback(value, value, set);
+    }
+}
+
+export { forEach };

package/dist/set/index.d.mts

@@ -2,6 +2,7 @@ export { countBy } from './countBy.mjs';
 export { every } from './every.mjs';
 export { filter } from './filter.mjs';
 export { find } from './find.mjs';
+export { forEach } from './forEach.mjs';
 export { keyBy } from './keyBy.mjs';
 export { map } from './map.mjs';
 export { reduce } from './reduce.mjs';

package/dist/set/index.d.ts

@@ -2,6 +2,7 @@ export { countBy } from './countBy.js';
 export { every } from './every.js';
 export { filter } from './filter.js';
 export { find } from './find.js';
+export { forEach } from './forEach.js';
 export { keyBy } from './keyBy.js';
 export { map } from './map.js';
 export { reduce } from './reduce.js';

package/dist/set/index.js

@@ -6,6 +6,7 @@ const countBy = require('./countBy.js');
 const every = require('./every.js');
 const filter = require('./filter.js');
 const find = require('./find.js');
+const forEach = require('./forEach.js');
 const keyBy = require('./keyBy.js');
 const map = require('./map.js');
 const reduce = require('./reduce.js');
@@ -17,6 +18,7 @@ exports.countBy = countBy.countBy;
 exports.every = every.every;
 exports.filter = filter.filter;
 exports.find = find.find;
+exports.forEach = forEach.forEach;
 exports.keyBy = keyBy.keyBy;
 exports.map = map.map;
 exports.reduce = reduce.reduce;

package/dist/set/index.mjs

@@ -2,6 +2,7 @@ export { countBy } from './countBy.mjs';
 export { every } from './every.mjs';
 export { filter } from './filter.mjs';
 export { find } from './find.mjs';
+export { forEach } from './forEach.mjs';
 export { keyBy } from './keyBy.mjs';
 export { map } from './map.mjs';
 export { reduce } from './reduce.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.46.0-dev.1789+a1c32498",
+  "version": "1.46.0-dev.1791+50d799e5",
   "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",