es-toolkit 1.18.0 → 1.19.0-dev.605

package/dist/compat/_internal/decimalAdjust.mjs

@@ -0,0 +1,19 @@
+function decimalAdjust(type, number, precision = 0) {
+    number = Number(number);
+    if (Object.is(number, -0)) {
+        number = '-0';
+    }
+    precision = Math.min(Number.parseInt(precision, 10), 292);
+    if (precision) {
+        const [magnitude, exponent = 0] = number.toString().split('e');
+        let adjustedValue = Math[type](Number(`${magnitude}e${Number(exponent) + precision}`));
+        if (Object.is(adjustedValue, -0)) {
+            adjustedValue = '-0';
+        }
+        const [newMagnitude, newExponent = 0] = adjustedValue.toString().split('e');
+        return Number(`${newMagnitude}e${Number(newExponent) - precision}`);
+    }
+    return Math[type](Number(number));
+}
+
+export { decimalAdjust };

package/dist/compat/_internal/isDeepKey.mjs

@@ -1,5 +1,3 @@
-const IS_PLAIN = /^\w*$/;
-const IS_DEEP = /\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/;
 function isDeepKey(key) {
     switch (typeof key) {
         case 'number':
@@ -7,7 +5,7 @@ function isDeepKey(key) {
             return false;
         }
         case 'string': {
-            return !IS_PLAIN.test(key) && IS_DEEP.test(key);
+            return key.includes('.') || key.includes('[') || key.includes(']');
         }
     }
 }

package/dist/compat/_internal/normalizeForCase.mjs

@@ -1,9 +1,10 @@
+import { toString } from '../util/toString.mjs';
+
 function normalizeForCase(str) {
-    if (typeof str === 'object') {
-        str = str.toString();
+    if (typeof str !== 'string') {
+        str = toString(str);
     }
-    str = str.replace(/['\u2019]/g, '');
-    return str;
+    return str.replace(/['\u2019]/g, '');
 }
 
 export { normalizeForCase };

package/dist/compat/_internal/toKey.mjs

@@ -1,13 +1,8 @@
-import { isSymbol } from '../predicate/isSymbol.mjs';
-
 function toKey(value) {
-    if (typeof value === 'string' || isSymbol(value)) {
-        return value;
-    }
-    if (Object.is(value?.valueOf(), -0)) {
+    if (Object.is(value, -0)) {
         return '-0';
     }
-    return `${value}`;
+    return value.toString();
 }
 
 export { toKey };

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

@@ -14,6 +14,6 @@
  * const arr = flatten([1, [2, 3], [4, [5, 6]]], 2);
  * // Returns: [1, 2, 3, 4, 5, 6]
  */
-declare function flatten<T, D extends number = 1>(value: T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
+declare function flatten<T, D extends number = 1>(value: readonly T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
 
 export { flatten };

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

@@ -14,6 +14,6 @@
  * const arr = flatten([1, [2, 3], [4, [5, 6]]], 2);
  * // Returns: [1, 2, 3, 4, 5, 6]
  */
-declare function flatten<T, D extends number = 1>(value: T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
+declare function flatten<T, D extends number = 1>(value: readonly T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
 
 export { flatten };

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

@@ -14,6 +14,6 @@
  * const arr = flatten([1, [2, 3], [4, [5, 6]]], 2);
  * // Returns: [1, 2, 3, 4, 5, 6]
  */
-declare function flattenDepth<T, D extends number = 1>(value: T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
+declare function flattenDepth<T, D extends number = 1>(value: readonly T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
 
 export { flattenDepth };

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

@@ -14,6 +14,6 @@
  * const arr = flatten([1, [2, 3], [4, [5, 6]]], 2);
  * // Returns: [1, 2, 3, 4, 5, 6]
  */
-declare function flattenDepth<T, D extends number = 1>(value: T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
+declare function flattenDepth<T, D extends number = 1>(value: readonly T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
 
 export { flattenDepth };

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

@@ -16,6 +16,6 @@
  * indexOf(array, 3); // => 2
  * indexOf(array, NaN); // => 3
  */
-declare function indexOf<T>(array: T[] | null | undefined, searchElement: T, fromIndex?: number): number;
+declare function indexOf<T>(array: readonly T[] | null | undefined, searchElement: T, fromIndex?: number): number;
 
 export { indexOf };

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

@@ -16,6 +16,6 @@
  * indexOf(array, 3); // => 2
  * indexOf(array, NaN); // => 3
  */
-declare function indexOf<T>(array: T[] | null | undefined, searchElement: T, fromIndex?: number): number;
+declare function indexOf<T>(array: readonly T[] | null | undefined, searchElement: T, fromIndex?: number): number;
 
 export { indexOf };

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

@@ -29,6 +29,6 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T>(collection: T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
 
 export { type Criterion, orderBy };

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

@@ -29,6 +29,6 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T>(collection: T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
 
 export { type Criterion, orderBy };

package/dist/compat/array/orderBy.mjs

@@ -1,6 +1,6 @@
 import { compareValues } from '../_internal/compareValues.mjs';
 import { isKey } from '../_internal/isKey.mjs';
-import { toPath } from '../_internal/toPath.mjs';
+import { toPath } from '../util/toPath.mjs';
 
 function orderBy(collection, criteria, orders) {
     if (collection == null || typeof collection === 'number') {

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

@@ -34,6 +34,6 @@
  * const emptyObjSize = size(emptyObj);
  * // emptyObjSize will be 0
  */
-declare function size<T>(target: T[] | object | string | Map<unknown, T> | Set<T> | null | undefined): number;
+declare function size<T>(target: readonly T[] | object | string | Map<unknown, T> | Set<T> | null | undefined): number;
 
 export { size };

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

@@ -34,6 +34,6 @@
  * const emptyObjSize = size(emptyObj);
  * // emptyObjSize will be 0
  */
-declare function size<T>(target: T[] | object | string | Map<unknown, T> | Set<T> | null | undefined): number;
+declare function size<T>(target: readonly T[] | object | string | Map<unknown, T> | Set<T> | null | undefined): number;
 
 export { size };

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

@@ -29,6 +29,6 @@ import { Criterion } from './orderBy.mjs';
  * //   { user: 'fred', age: 48 },
  * // ]
  */
-declare function sortBy<T>(collection: T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
+declare function sortBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
 
 export { sortBy };

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

@@ -29,6 +29,6 @@ import { Criterion } from './orderBy.js';
  * //   { user: 'fred', age: 48 },
  * // ]
  */
-declare function sortBy<T>(collection: T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
+declare function sortBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
 
 export { sortBy };

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

@@ -31,7 +31,7 @@
  * const result = zipObjectDeep(paths, values);
  * // result will be { 'a': { 'b': [{ 'c': 1 }, { 'd': 2 }] } }
  */
-declare function zipObjectDeep<P extends PropertyKey, V>(keys: P[] | P[][], values: V[]): {
+declare function zipObjectDeep<P extends PropertyKey, V>(keys: readonly P[] | readonly P[][], values: readonly V[]): {
     [K in P]: V;
 };
 

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

@@ -31,7 +31,7 @@
  * const result = zipObjectDeep(paths, values);
  * // result will be { 'a': { 'b': [{ 'c': 1 }, { 'd': 2 }] } }
  */
-declare function zipObjectDeep<P extends PropertyKey, V>(keys: P[] | P[][], values: V[]): {
+declare function zipObjectDeep<P extends PropertyKey, V>(keys: readonly P[] | readonly P[][], values: readonly V[]): {
     [K in P]: V;
 };
 

package/dist/compat/index.d.mts

@@ -60,25 +60,24 @@ export { MemoizeCache, memoize } from '../function/memoize.mjs';
 export { unary } from '../function/unary.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
+export { curry } from '../function/curry.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 { random } from '../math/random.mjs';
 export { randomInt } from '../math/randomInt.mjs';
-export { round } from '../math/round.mjs';
 export { sum } from '../math/sum.mjs';
 export { sumBy } from '../math/sumBy.mjs';
 export { range } from '../math/range.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 { invert } from '../object/invert.mjs';
 export { clone } from '../object/clone.mjs';
 export { flattenObject } from '../object/flattenObject.mjs';
 export { cloneDeep } from '../object/cloneDeep.mjs';
 export { toMerged } from '../object/toMerged.mjs';
+export { isDate } from '../predicate/isDate.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
 export { isNil } from '../predicate/isNil.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
@@ -90,10 +89,7 @@ export { isPrimitive } from '../predicate/isPrimitive.mjs';
 export { delay } from '../promise/delay.mjs';
 export { withTimeout } from '../promise/withTimeout.mjs';
 export { timeout } from '../promise/timeout.mjs';
-export { snakeCase } from '../string/snakeCase.mjs';
-export { kebabCase } from '../string/kebabCase.mjs';
-export { lowerCase } from '../string/lowerCase.mjs';
-export { startCase } from '../string/startCase.mjs';
+export { upperCase } from '../string/upperCase.mjs';
 export { capitalize } from '../string/capitalize.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
@@ -130,6 +126,8 @@ export { attempt } from './function/attempt.mjs';
 export { rearg } from './function/rearg.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';
+export { pick } from './object/pick.mjs';
+export { omit } from './object/omit.mjs';
 export { has } from './object/has.mjs';
 export { property } from './object/property.mjs';
 export { mapKeys } from './object/mapKeys.mjs';
@@ -137,6 +135,7 @@ export { mapValues } from './object/mapValues.mjs';
 export { merge } from './object/merge.mjs';
 export { mergeWith } from './object/mergeWith.mjs';
 export { fromPairs } from './object/fromPairs.mjs';
+export { unset } from './object/unset.mjs';
 export { isPlainObject } from './predicate/isPlainObject.mjs';
 export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';
@@ -155,12 +154,26 @@ export { isWeakMap } from './predicate/isWeakMap.mjs';
 export { isWeakSet } from './predicate/isWeakSet.mjs';
 export { conforms } from './predicate/conforms.mjs';
 export { conformsTo } from './predicate/conformsTo.mjs';
+export { isInteger } from './predicate/isInteger.mjs';
+export { isSafeInteger } from './predicate/isSafeInteger.mjs';
 export { camelCase } from './string/camelCase.mjs';
+export { kebabCase } from './string/kebabCase.mjs';
+export { snakeCase } from './string/snakeCase.mjs';
+export { startCase } from './string/startCase.mjs';
+export { lowerCase } from './string/lowerCase.mjs';
 export { startsWith } from './string/startsWith.mjs';
 export { endsWith } from './string/endsWith.mjs';
 export { padStart } from './string/padStart.mjs';
 export { padEnd } from './string/padEnd.mjs';
 export { repeat } from './string/repeat.mjs';
+export { trim } from './string/trim.mjs';
+export { trimStart } from './string/trimStart.mjs';
+export { trimEnd } from './string/trimEnd.mjs';
 export { max } from './math/max.mjs';
 export { min } from './math/min.mjs';
+export { ceil } from './math/ceil.mjs';
+export { floor } from './math/floor.mjs';
+export { round } from './math/round.mjs';
 export { parseInt } from './math/parseInt.mjs';
+export { toPath } from './util/toPath.mjs';
+export { toString } from './util/toString.mjs';

package/dist/compat/index.d.ts

@@ -60,25 +60,24 @@ export { MemoizeCache, memoize } from '../function/memoize.js';
 export { unary } from '../function/unary.js';
 export { partial } from '../function/partial.js';
 export { partialRight } from '../function/partialRight.js';
+export { curry } from '../function/curry.js';
 export { clamp } from '../math/clamp.js';
 export { inRange } from '../math/inRange.js';
 export { mean } from '../math/mean.js';
 export { meanBy } from '../math/meanBy.js';
 export { random } from '../math/random.js';
 export { randomInt } from '../math/randomInt.js';
-export { round } from '../math/round.js';
 export { sum } from '../math/sum.js';
 export { sumBy } from '../math/sumBy.js';
 export { range } from '../math/range.js';
-export { omit } from '../object/omit.js';
 export { omitBy } from '../object/omitBy.js';
-export { pick } from '../object/pick.js';
 export { pickBy } from '../object/pickBy.js';
 export { invert } from '../object/invert.js';
 export { clone } from '../object/clone.js';
 export { flattenObject } from '../object/flattenObject.js';
 export { cloneDeep } from '../object/cloneDeep.js';
 export { toMerged } from '../object/toMerged.js';
+export { isDate } from '../predicate/isDate.js';
 export { isEqual } from '../predicate/isEqual.js';
 export { isNil } from '../predicate/isNil.js';
 export { isNotNil } from '../predicate/isNotNil.js';
@@ -90,10 +89,7 @@ export { isPrimitive } from '../predicate/isPrimitive.js';
 export { delay } from '../promise/delay.js';
 export { withTimeout } from '../promise/withTimeout.js';
 export { timeout } from '../promise/timeout.js';
-export { snakeCase } from '../string/snakeCase.js';
-export { kebabCase } from '../string/kebabCase.js';
-export { lowerCase } from '../string/lowerCase.js';
-export { startCase } from '../string/startCase.js';
+export { upperCase } from '../string/upperCase.js';
 export { capitalize } from '../string/capitalize.js';
 export { pascalCase } from '../string/pascalCase.js';
 export { upperFirst } from '../string/upperFirst.js';
@@ -130,6 +126,8 @@ export { attempt } from './function/attempt.js';
 export { rearg } from './function/rearg.js';
 export { get } from './object/get.js';
 export { set } from './object/set.js';
+export { pick } from './object/pick.js';
+export { omit } from './object/omit.js';
 export { has } from './object/has.js';
 export { property } from './object/property.js';
 export { mapKeys } from './object/mapKeys.js';
@@ -137,6 +135,7 @@ export { mapValues } from './object/mapValues.js';
 export { merge } from './object/merge.js';
 export { mergeWith } from './object/mergeWith.js';
 export { fromPairs } from './object/fromPairs.js';
+export { unset } from './object/unset.js';
 export { isPlainObject } from './predicate/isPlainObject.js';
 export { isArray } from './predicate/isArray.js';
 export { isArguments } from './predicate/isArguments.js';
@@ -155,12 +154,26 @@ export { isWeakMap } from './predicate/isWeakMap.js';
 export { isWeakSet } from './predicate/isWeakSet.js';
 export { conforms } from './predicate/conforms.js';
 export { conformsTo } from './predicate/conformsTo.js';
+export { isInteger } from './predicate/isInteger.js';
+export { isSafeInteger } from './predicate/isSafeInteger.js';
 export { camelCase } from './string/camelCase.js';
+export { kebabCase } from './string/kebabCase.js';
+export { snakeCase } from './string/snakeCase.js';
+export { startCase } from './string/startCase.js';
+export { lowerCase } from './string/lowerCase.js';
 export { startsWith } from './string/startsWith.js';
 export { endsWith } from './string/endsWith.js';
 export { padStart } from './string/padStart.js';
 export { padEnd } from './string/padEnd.js';
 export { repeat } from './string/repeat.js';
+export { trim } from './string/trim.js';
+export { trimStart } from './string/trimStart.js';
+export { trimEnd } from './string/trimEnd.js';
 export { max } from './math/max.js';
 export { min } from './math/min.js';
+export { ceil } from './math/ceil.js';
+export { floor } from './math/floor.js';
+export { round } from './math/round.js';
 export { parseInt } from './math/parseInt.js';
+export { toPath } from './util/toPath.js';
+export { toString } from './util/toString.js';