es-toolkit 1.46.1 → 1.47.0-dev.1821

package/dist/index.mjs

@@ -1,180 +1,195 @@
-export { at } from './array/at.mjs';
-export { chunk } from './array/chunk.mjs';
-export { compact } from './array/compact.mjs';
-export { countBy } from './array/countBy.mjs';
-export { difference } from './array/difference.mjs';
-export { differenceBy } from './array/differenceBy.mjs';
-export { differenceWith } from './array/differenceWith.mjs';
-export { drop } from './array/drop.mjs';
-export { dropRight } from './array/dropRight.mjs';
-export { dropRightWhile } from './array/dropRightWhile.mjs';
-export { dropWhile } from './array/dropWhile.mjs';
-export { fill } from './array/fill.mjs';
-export { filterAsync } from './array/filterAsync.mjs';
-export { flatMap } from './array/flatMap.mjs';
-export { flatMapAsync } from './array/flatMapAsync.mjs';
-export { flatMapDeep } from './array/flatMapDeep.mjs';
-export { flatten } from './array/flatten.mjs';
-export { flattenDeep } from './array/flattenDeep.mjs';
-export { forEachAsync } from './array/forEachAsync.mjs';
-export { forEachRight } from './array/forEachRight.mjs';
-export { groupBy } from './array/groupBy.mjs';
-export { head } from './array/head.mjs';
-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 { isSubset } from './array/isSubset.mjs';
-export { isSubsetWith } from './array/isSubsetWith.mjs';
-export { keyBy } from './array/keyBy.mjs';
-export { last } from './array/last.mjs';
-export { limitAsync } from './array/limitAsync.mjs';
-export { mapAsync } from './array/mapAsync.mjs';
-export { maxBy } from './array/maxBy.mjs';
-export { minBy } from './array/minBy.mjs';
-export { orderBy } from './array/orderBy.mjs';
-export { partition } from './array/partition.mjs';
-export { pull } from './array/pull.mjs';
-export { pullAt } from './array/pullAt.mjs';
-export { reduceAsync } from './array/reduceAsync.mjs';
-export { remove } from './array/remove.mjs';
-export { sample } from './array/sample.mjs';
-export { sampleSize } from './array/sampleSize.mjs';
-export { shuffle } from './array/shuffle.mjs';
-export { sortBy } from './array/sortBy.mjs';
-export { tail } from './array/tail.mjs';
-export { take } from './array/take.mjs';
-export { takeRight } from './array/takeRight.mjs';
-export { takeRightWhile } from './array/takeRightWhile.mjs';
-export { takeWhile } from './array/takeWhile.mjs';
-export { toFilled } from './array/toFilled.mjs';
-export { union } from './array/union.mjs';
-export { unionBy } from './array/unionBy.mjs';
-export { unionWith } from './array/unionWith.mjs';
-export { uniq } from './array/uniq.mjs';
-export { uniqBy } from './array/uniqBy.mjs';
-export { uniqWith } from './array/uniqWith.mjs';
-export { unzip } from './array/unzip.mjs';
-export { unzipWith } from './array/unzipWith.mjs';
-export { windowed } from './array/windowed.mjs';
-export { without } from './array/without.mjs';
-export { xor } from './array/xor.mjs';
-export { xorBy } from './array/xorBy.mjs';
-export { xorWith } from './array/xorWith.mjs';
-export { zip } from './array/zip.mjs';
-export { zipObject } from './array/zipObject.mjs';
-export { zipWith } from './array/zipWith.mjs';
-export { AbortError } from './error/AbortError.mjs';
-export { TimeoutError } from './error/TimeoutError.mjs';
-export { after } from './function/after.mjs';
-export { ary } from './function/ary.mjs';
-export { asyncNoop } from './function/asyncNoop.mjs';
-export { before } from './function/before.mjs';
-export { curry } from './function/curry.mjs';
-export { curryRight } from './function/curryRight.mjs';
-export { debounce } from './function/debounce.mjs';
-export { flow } from './function/flow.mjs';
-export { flowRight } from './function/flowRight.mjs';
-export { identity } from './function/identity.mjs';
-export { memoize } from './function/memoize.mjs';
-export { negate } from './function/negate.mjs';
-export { noop } from './function/noop.mjs';
-export { once } from './function/once.mjs';
-export { partial } from './function/partial.mjs';
-export { partialRight } from './function/partialRight.mjs';
-export { rest } from './function/rest.mjs';
-export { retry } from './function/retry.mjs';
-export { spread } from './function/spread.mjs';
-export { throttle } from './function/throttle.mjs';
-export { unary } from './function/unary.mjs';
-export { clamp } from './math/clamp.mjs';
-export { inRange } from './math/inRange.mjs';
-export { mean } from './math/mean.mjs';
-export { meanBy } from './math/meanBy.mjs';
-export { median } from './math/median.mjs';
-export { medianBy } from './math/medianBy.mjs';
-export { random } from './math/random.mjs';
-export { randomInt } from './math/randomInt.mjs';
-export { range } from './math/range.mjs';
-export { rangeRight } from './math/rangeRight.mjs';
-export { round } from './math/round.mjs';
-export { sum } from './math/sum.mjs';
-export { sumBy } from './math/sumBy.mjs';
-export { clone } from './object/clone.mjs';
-export { cloneDeep } from './object/cloneDeep.mjs';
-export { cloneDeepWith } from './object/cloneDeepWith.mjs';
-export { findKey } from './object/findKey.mjs';
-export { flattenObject } from './object/flattenObject.mjs';
-export { invert } from './object/invert.mjs';
-export { mapKeys } from './object/mapKeys.mjs';
-export { mapValues } from './object/mapValues.mjs';
-export { merge } from './object/merge.mjs';
-export { mergeWith } from './object/mergeWith.mjs';
-export { omit } from './object/omit.mjs';
-export { omitBy } from './object/omitBy.mjs';
-export { pick } from './object/pick.mjs';
-export { pickBy } from './object/pickBy.mjs';
-export { toCamelCaseKeys } from './object/toCamelCaseKeys.mjs';
-export { toMerged } from './object/toMerged.mjs';
-export { toSnakeCaseKeys } from './object/toSnakeCaseKeys.mjs';
-export { isArrayBuffer } from './predicate/isArrayBuffer.mjs';
-export { isBlob } from './predicate/isBlob.mjs';
-export { isBoolean } from './predicate/isBoolean.mjs';
-export { isBrowser } from './predicate/isBrowser.mjs';
-export { isBuffer } from './predicate/isBuffer.mjs';
-export { isDate } from './predicate/isDate.mjs';
-export { isEmptyObject } from './predicate/isEmptyObject.mjs';
-export { isEqual } from './predicate/isEqual.mjs';
-export { isEqualWith } from './predicate/isEqualWith.mjs';
-export { isError } from './predicate/isError.mjs';
-export { isFile } from './predicate/isFile.mjs';
-export { isFunction } from './predicate/isFunction.mjs';
-export { isJSON } from './predicate/isJSON.mjs';
-export { isJSONArray, isJSONObject, isJSONValue } from './predicate/isJSONValue.mjs';
-export { isLength } from './predicate/isLength.mjs';
-export { isMap } from './predicate/isMap.mjs';
-export { isNil } from './predicate/isNil.mjs';
-export { isNode } from './predicate/isNode.mjs';
-export { isNotNil } from './predicate/isNotNil.mjs';
-export { isNull } from './predicate/isNull.mjs';
-export { isNumber } from './predicate/isNumber.mjs';
-export { isPlainObject } from './predicate/isPlainObject.mjs';
-export { isPrimitive } from './predicate/isPrimitive.mjs';
-export { isPromise } from './predicate/isPromise.mjs';
-export { isRegExp } from './predicate/isRegExp.mjs';
-export { isSet } from './predicate/isSet.mjs';
-export { isString } from './predicate/isString.mjs';
-export { isSymbol } from './predicate/isSymbol.mjs';
-export { isTypedArray } from './predicate/isTypedArray.mjs';
-export { isUndefined } from './predicate/isUndefined.mjs';
-export { isWeakMap } from './predicate/isWeakMap.mjs';
-export { isWeakSet } from './predicate/isWeakSet.mjs';
-export { delay } from './promise/delay.mjs';
-export { Mutex } from './promise/mutex.mjs';
-export { Semaphore } from './promise/semaphore.mjs';
-export { timeout } from './promise/timeout.mjs';
-export { withTimeout } from './promise/withTimeout.mjs';
-export { camelCase } from './string/camelCase.mjs';
-export { capitalize } from './string/capitalize.mjs';
-export { constantCase } from './string/constantCase.mjs';
-export { deburr } from './string/deburr.mjs';
-export { escape } from './string/escape.mjs';
-export { escapeRegExp } from './string/escapeRegExp.mjs';
-export { kebabCase } from './string/kebabCase.mjs';
-export { lowerCase } from './string/lowerCase.mjs';
-export { lowerFirst } from './string/lowerFirst.mjs';
-export { pad } from './string/pad.mjs';
-export { pascalCase } from './string/pascalCase.mjs';
-export { reverseString } from './string/reverseString.mjs';
-export { snakeCase } from './string/snakeCase.mjs';
-export { startCase } from './string/startCase.mjs';
-export { trim } from './string/trim.mjs';
-export { trimEnd } from './string/trimEnd.mjs';
-export { trimStart } from './string/trimStart.mjs';
-export { unescape } from './string/unescape.mjs';
-export { upperCase } from './string/upperCase.mjs';
-export { upperFirst } from './string/upperFirst.mjs';
-export { words } from './string/words.mjs';
-export { attempt } from './util/attempt.mjs';
-export { attemptAsync } from './util/attemptAsync.mjs';
-export { invariant as assert, invariant } from './util/invariant.mjs';
+import { at } from "./array/at.mjs";
+import { cartesianProduct } from "./array/cartesianProduct.mjs";
+import { chunk } from "./array/chunk.mjs";
+import { combinations } from "./array/combinations.mjs";
+import { compact } from "./array/compact.mjs";
+import { countBy } from "./array/countBy.mjs";
+import { difference } from "./array/difference.mjs";
+import { differenceBy } from "./array/differenceBy.mjs";
+import { differenceWith } from "./array/differenceWith.mjs";
+import { drop } from "./array/drop.mjs";
+import { dropRight } from "./array/dropRight.mjs";
+import { dropRightWhile } from "./array/dropRightWhile.mjs";
+import { dropWhile } from "./array/dropWhile.mjs";
+import { fill } from "./array/fill.mjs";
+import { Semaphore } from "./promise/semaphore.mjs";
+import { limitAsync } from "./array/limitAsync.mjs";
+import { filterAsync } from "./array/filterAsync.mjs";
+import { flatten } from "./array/flatten.mjs";
+import { flatMap } from "./array/flatMap.mjs";
+import { flatMapAsync } from "./array/flatMapAsync.mjs";
+import { flattenDeep } from "./array/flattenDeep.mjs";
+import { flatMapDeep } from "./array/flatMapDeep.mjs";
+import { forEachAsync } from "./array/forEachAsync.mjs";
+import { forEachRight } from "./array/forEachRight.mjs";
+import { groupBy } from "./array/groupBy.mjs";
+import { head } from "./array/head.mjs";
+import { initial } from "./array/initial.mjs";
+import { intersection } from "./array/intersection.mjs";
+import { intersectionBy } from "./array/intersectionBy.mjs";
+import { intersectionWith } from "./array/intersectionWith.mjs";
+import { isSubset } from "./array/isSubset.mjs";
+import { isSubsetWith } from "./array/isSubsetWith.mjs";
+import { keyBy } from "./array/keyBy.mjs";
+import { last } from "./array/last.mjs";
+import { mapAsync } from "./array/mapAsync.mjs";
+import { maxBy } from "./array/maxBy.mjs";
+import { minBy } from "./array/minBy.mjs";
+import { orderBy } from "./array/orderBy.mjs";
+import { partition } from "./array/partition.mjs";
+import { pull } from "./array/pull.mjs";
+import { pullAt } from "./array/pullAt.mjs";
+import { reduceAsync } from "./array/reduceAsync.mjs";
+import { remove } from "./array/remove.mjs";
+import { sample } from "./array/sample.mjs";
+import { random } from "./math/random.mjs";
+import { randomInt } from "./math/randomInt.mjs";
+import { sampleSize } from "./array/sampleSize.mjs";
+import { shuffle } from "./array/shuffle.mjs";
+import { sortBy } from "./array/sortBy.mjs";
+import { tail } from "./array/tail.mjs";
+import { take } from "./array/take.mjs";
+import { takeRight } from "./array/takeRight.mjs";
+import { takeRightWhile } from "./array/takeRightWhile.mjs";
+import { takeWhile } from "./array/takeWhile.mjs";
+import { toFilled } from "./array/toFilled.mjs";
+import { uniq } from "./array/uniq.mjs";
+import { union } from "./array/union.mjs";
+import { uniqBy } from "./array/uniqBy.mjs";
+import { unionBy } from "./array/unionBy.mjs";
+import { uniqWith } from "./array/uniqWith.mjs";
+import { unionWith } from "./array/unionWith.mjs";
+import { unzip } from "./array/unzip.mjs";
+import { unzipWith } from "./array/unzipWith.mjs";
+import { windowed } from "./array/windowed.mjs";
+import { without } from "./array/without.mjs";
+import { xor } from "./array/xor.mjs";
+import { xorBy } from "./array/xorBy.mjs";
+import { xorWith } from "./array/xorWith.mjs";
+import { zip } from "./array/zip.mjs";
+import { zipObject } from "./array/zipObject.mjs";
+import { zipWith } from "./array/zipWith.mjs";
+import "./array/index.mjs";
+import { AbortError } from "./error/AbortError.mjs";
+import { TimeoutError } from "./error/TimeoutError.mjs";
+import "./error/index.mjs";
+import { after } from "./function/after.mjs";
+import { ary } from "./function/ary.mjs";
+import { asyncNoop } from "./function/asyncNoop.mjs";
+import { before } from "./function/before.mjs";
+import { curry } from "./function/curry.mjs";
+import { curryRight } from "./function/curryRight.mjs";
+import { debounce } from "./function/debounce.mjs";
+import { flow } from "./function/flow.mjs";
+import { flowRight } from "./function/flowRight.mjs";
+import { identity } from "./function/identity.mjs";
+import { memoize } from "./function/memoize.mjs";
+import { negate } from "./function/negate.mjs";
+import { noop } from "./function/noop.mjs";
+import { once } from "./function/once.mjs";
+import { partial } from "./function/partial.mjs";
+import { partialRight } from "./function/partialRight.mjs";
+import { rest } from "./function/rest.mjs";
+import { delay } from "./promise/delay.mjs";
+import { retry } from "./function/retry.mjs";
+import { spread } from "./function/spread.mjs";
+import { throttle } from "./function/throttle.mjs";
+import { unary } from "./function/unary.mjs";
+import "./function/index.mjs";
+import { clamp } from "./math/clamp.mjs";
+import { inRange } from "./math/inRange.mjs";
+import { sum } from "./math/sum.mjs";
+import { mean } from "./math/mean.mjs";
+import { sumBy } from "./math/sumBy.mjs";
+import { meanBy } from "./math/meanBy.mjs";
+import { median } from "./math/median.mjs";
+import { medianBy } from "./math/medianBy.mjs";
+import { percentile } from "./math/percentile.mjs";
+import { range } from "./math/range.mjs";
+import { rangeRight } from "./math/rangeRight.mjs";
+import { round } from "./math/round.mjs";
+import "./math/index.mjs";
+import { isPrimitive } from "./predicate/isPrimitive.mjs";
+import { isTypedArray } from "./predicate/isTypedArray.mjs";
+import { clone } from "./object/clone.mjs";
+import { isBuffer } from "./predicate/isBuffer.mjs";
+import { cloneDeepWith } from "./object/cloneDeepWith.mjs";
+import { cloneDeep } from "./object/cloneDeep.mjs";
+import { findKey } from "./object/findKey.mjs";
+import { isPlainObject } from "./predicate/isPlainObject.mjs";
+import { flattenObject } from "./object/flattenObject.mjs";
+import { invert } from "./object/invert.mjs";
+import { mapKeys } from "./object/mapKeys.mjs";
+import { mapValues } from "./object/mapValues.mjs";
+import { merge } from "./object/merge.mjs";
+import { mergeWith } from "./object/mergeWith.mjs";
+import { omit } from "./object/omit.mjs";
+import { omitBy } from "./object/omitBy.mjs";
+import { pick } from "./object/pick.mjs";
+import { pickBy } from "./object/pickBy.mjs";
+import { sortKeys } from "./object/sortKeys.mjs";
+import { capitalize } from "./string/capitalize.mjs";
+import { words } from "./string/words.mjs";
+import { camelCase } from "./string/camelCase.mjs";
+import { toCamelCaseKeys } from "./object/toCamelCaseKeys.mjs";
+import { toMerged } from "./object/toMerged.mjs";
+import { snakeCase } from "./string/snakeCase.mjs";
+import { toSnakeCaseKeys } from "./object/toSnakeCaseKeys.mjs";
+import "./object/index.mjs";
+import { isArrayBuffer } from "./predicate/isArrayBuffer.mjs";
+import { isBlob } from "./predicate/isBlob.mjs";
+import { isBoolean } from "./predicate/isBoolean.mjs";
+import { isBrowser } from "./predicate/isBrowser.mjs";
+import { isDate } from "./predicate/isDate.mjs";
+import { isEmptyObject } from "./predicate/isEmptyObject.mjs";
+import { isEqualWith } from "./predicate/isEqualWith.mjs";
+import { isEqual } from "./predicate/isEqual.mjs";
+import { isError } from "./predicate/isError.mjs";
+import { isFile } from "./predicate/isFile.mjs";
+import { isFunction } from "./predicate/isFunction.mjs";
+import { isJSON } from "./predicate/isJSON.mjs";
+import { isJSONArray, isJSONObject, isJSONValue } from "./predicate/isJSONValue.mjs";
+import { isLength } from "./predicate/isLength.mjs";
+import { isMap } from "./predicate/isMap.mjs";
+import { isNil } from "./predicate/isNil.mjs";
+import { isNode } from "./predicate/isNode.mjs";
+import { isNotNil } from "./predicate/isNotNil.mjs";
+import { isNull } from "./predicate/isNull.mjs";
+import { isNumber } from "./predicate/isNumber.mjs";
+import { isPromise } from "./predicate/isPromise.mjs";
+import { isRegExp } from "./predicate/isRegExp.mjs";
+import { isSet } from "./predicate/isSet.mjs";
+import { isString } from "./predicate/isString.mjs";
+import { isSymbol } from "./predicate/isSymbol.mjs";
+import { isUndefined } from "./predicate/isUndefined.mjs";
+import { isWeakMap } from "./predicate/isWeakMap.mjs";
+import { isWeakSet } from "./predicate/isWeakSet.mjs";
+import "./predicate/index.mjs";
+import { allKeyed } from "./promise/allKeyed.mjs";
+import { Mutex } from "./promise/mutex.mjs";
+import { timeout } from "./promise/timeout.mjs";
+import { withTimeout } from "./promise/withTimeout.mjs";
+import "./promise/index.mjs";
+import { constantCase } from "./string/constantCase.mjs";
+import { deburr } from "./string/deburr.mjs";
+import { escape } from "./string/escape.mjs";
+import { escapeRegExp } from "./string/escapeRegExp.mjs";
+import { kebabCase } from "./string/kebabCase.mjs";
+import { lowerCase } from "./string/lowerCase.mjs";
+import { lowerFirst } from "./string/lowerFirst.mjs";
+import { pad } from "./string/pad.mjs";
+import { pascalCase } from "./string/pascalCase.mjs";
+import { reverseString } from "./string/reverseString.mjs";
+import { startCase } from "./string/startCase.mjs";
+import { trimEnd } from "./string/trimEnd.mjs";
+import { trimStart } from "./string/trimStart.mjs";
+import { trim } from "./string/trim.mjs";
+import { unescape } from "./string/unescape.mjs";
+import { upperCase } from "./string/upperCase.mjs";
+import { upperFirst } from "./string/upperFirst.mjs";
+import "./string/index.mjs";
+import { attempt } from "./util/attempt.mjs";
+import { attemptAsync } from "./util/attemptAsync.mjs";
+import { invariant } from "./util/invariant.mjs";
+import "./util/index.mjs";
+export { AbortError, Mutex, Semaphore, TimeoutError, after, allKeyed, ary, invariant as assert, asyncNoop, at, attempt, attemptAsync, before, camelCase, capitalize, cartesianProduct, chunk, clamp, clone, cloneDeep, cloneDeepWith, combinations, compact, constantCase, countBy, curry, curryRight, debounce, deburr, delay, difference, differenceBy, differenceWith, drop, dropRight, dropRightWhile, dropWhile, escape, escapeRegExp, fill, filterAsync, findKey, flatMap, flatMapAsync, flatMapDeep, flatten, flattenDeep, flattenObject, flow, flowRight, forEachAsync, forEachRight, groupBy, head, identity, inRange, initial, intersection, intersectionBy, intersectionWith, invariant, invert, isArrayBuffer, isBlob, isBoolean, isBrowser, isBuffer, isDate, isEmptyObject, isEqual, isEqualWith, isError, isFile, isFunction, isJSON, isJSONArray, isJSONObject, isJSONValue, isLength, isMap, isNil, isNode, isNotNil, isNull, isNumber, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSubset, isSubsetWith, isSymbol, isTypedArray, isUndefined, isWeakMap, isWeakSet, kebabCase, keyBy, last, limitAsync, lowerCase, lowerFirst, mapAsync, mapKeys, mapValues, maxBy, mean, meanBy, median, medianBy, memoize, merge, mergeWith, minBy, negate, noop, omit, omitBy, once, orderBy, pad, partial, partialRight, partition, pascalCase, percentile, pick, pickBy, pull, pullAt, random, randomInt, range, rangeRight, reduceAsync, remove, rest, retry, reverseString, round, sample, sampleSize, shuffle, snakeCase, sortBy, sortKeys, spread, startCase, sum, sumBy, tail, take, takeRight, takeRightWhile, takeWhile, throttle, timeout, toCamelCaseKeys, toFilled, toMerged, toSnakeCaseKeys, trim, trimEnd, trimStart, unary, unescape, union, unionBy, unionWith, uniq, uniqBy, uniqWith, unzip, unzipWith, upperCase, upperFirst, windowed, withTimeout, without, words, xor, xorBy, xorWith, zip, zipObject, zipWith };

package/dist/map/countBy.d.mts

@@ -1,3 +1,4 @@
+//#region src/map/countBy.d.ts
 /**
  * Counts the occurrences of items in a Map based on a transformation function.
  *
@@ -31,5 +32,5 @@
  * // 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 };
+//#endregion
+export { countBy };

package/dist/map/countBy.d.ts

@@ -1,3 +1,4 @@
+//#region src/map/countBy.d.ts
 /**
  * Counts the occurrences of items in a Map based on a transformation function.
  *
@@ -31,5 +32,5 @@
  * // 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 };
+//#endregion
+export { countBy };

package/dist/map/countBy.js

@@ -1,14 +1,43 @@
-'use strict';
-
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+//#region src/map/countBy.ts
+/**
+* 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 }
+*/
 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;
+	const result = /* @__PURE__ */ new Map();
+	for (const [key, value] of map) {
+		const mappedKey = mapper(value, key, map);
+		result.set(mappedKey, (result.get(mappedKey) ?? 0) + 1);
+	}
+	return result;
 }
-
+//#endregion
 exports.countBy = countBy;

package/dist/map/countBy.mjs

@@ -1,10 +1,43 @@
+//#region src/map/countBy.ts
+/**
+* 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 }
+*/
 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;
+	const result = /* @__PURE__ */ new Map();
+	for (const [key, value] of map) {
+		const mappedKey = mapper(value, key, map);
+		result.set(mappedKey, (result.get(mappedKey) ?? 0) + 1);
+	}
+	return result;
 }
-
+//#endregion
 export { countBy };

package/dist/map/every.d.mts

@@ -1,3 +1,4 @@
+//#region src/map/every.d.ts
 /**
  * Tests whether all entries in a Map satisfy the provided predicate function.
  *
@@ -24,5 +25,5 @@
  * // result2 will be: false
  */
 declare function every<K, V>(map: Map<K, V>, doesMatch: (value: V, key: K, map: Map<K, V>) => boolean): boolean;
-
-export { every };
+//#endregion
+export { every };

package/dist/map/every.d.ts

@@ -1,3 +1,4 @@
+//#region src/map/every.d.ts
 /**
  * Tests whether all entries in a Map satisfy the provided predicate function.
  *
@@ -24,5 +25,5 @@
  * // result2 will be: false
  */
 declare function every<K, V>(map: Map<K, V>, doesMatch: (value: V, key: K, map: Map<K, V>) => boolean): boolean;
-
-export { every };
+//#endregion
+export { every };

package/dist/map/every.js

@@ -1,14 +1,32 @@
-'use strict';
-
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+//#region src/map/every.ts
+/**
+* Tests whether all entries in a Map satisfy the provided predicate function.
+*
+* This function iterates through all entries of the Map and checks if the predicate function
+* returns true for every entry. It returns true if the predicate is satisfied for all entries,
+* and false otherwise.
+*
+* @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 test.
+* @param {(value: V, key: K, map: Map<K, V>) => boolean} doesMatch - A predicate function that tests each entry.
+* @returns {boolean} true if all entries satisfy the predicate, false otherwise.
+*
+* @example
+* const map = new Map([
+*   ['a', 10],
+*   ['b', 20],
+*   ['c', 30]
+* ]);
+* const result = every(map, (value) => value > 5);
+* // result will be: true
+*
+* const result2 = every(map, (value) => value > 15);
+* // result2 will be: false
+*/
 function every(map, doesMatch) {
-    for (const [key, value] of map) {
-        if (!doesMatch(value, key, map)) {
-            return false;
-        }
-    }
-    return true;
+	for (const [key, value] of map) if (!doesMatch(value, key, map)) return false;
+	return true;
 }
-
+//#endregion
 exports.every = every;