es-toolkit 1.26.1 → 1.27.0-dev.874

package/dist/compat/util/iteratee.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Returns a `identity` function when `value` is `null` or `undefined`.
+ *
+ * @param {null} [value] - The value to convert to an iteratee.
+ * @returns {<T>(value: T) => T} - Returns a `identity` function.
+ *
+ * @example
+ * const func = iteratee();
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [{ a: 1 }, { a: 2 }, { a: 3 }]
+ */
+declare function iteratee(value?: null): <T>(value: T) => T;
+/**
+ * Returns a given `func` function when `value` is a `function`.
+ *
+ * @template {(...args: any[]) => unknown} F - The function type.
+ * @param {F} func - The function to return.
+ * @returns {F} - Returns the given function.
+ *
+ * @example
+ * const func = iteratee((object) => object.a);
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [1, 2, 3]
+ */
+declare function iteratee<F extends (...args: any[]) => unknown>(func: F): F;
+/**
+ * Creates a function that invokes `value` with the arguments of the created function.
+ *
+ * The created function returns the property value for a given element.
+ *
+ * @param {symbol | number | string | object} value - The value to convert to an iteratee.
+ * @returns {(...args: any[]) => any} - Returns the new iteratee function.
+ *
+ * @example
+ * const func = iteratee('a');
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [1, 2, 3]
+ *
+ * const func = iteratee({ a: 1 });
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].find(func) // => { a: 1 }
+ *
+ * const func = iteratee(['a', 1]);
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].find(func) // => { a: 1 }
+ */
+declare function iteratee(value: symbol | number | string | object): (...args: any[]) => any;
+
+export { iteratee };

package/dist/compat/util/iteratee.mjs

@@ -0,0 +1,28 @@
+import { identity } from '../../function/identity.mjs';
+import { property } from '../object/property.mjs';
+import { matches } from '../predicate/matches.mjs';
+import { matchesProperty } from '../predicate/matchesProperty.mjs';
+
+function iteratee(value) {
+    if (value == null) {
+        return identity;
+    }
+    switch (typeof value) {
+        case 'function': {
+            return value;
+        }
+        case 'object': {
+            if (Array.isArray(value) && value.length === 2) {
+                return matchesProperty(value[0], value[1]);
+            }
+            return matches(value);
+        }
+        case 'string':
+        case 'symbol':
+        case 'number': {
+            return property(value);
+        }
+    }
+}
+
+export { iteratee };

package/dist/compat/util/toPath.mjs

@@ -1,34 +1,65 @@
-const DOTS_KEY = /^[\w.]+$/g;
-const ESCAPE_REGEXP = /\\(\\)?/g;
-const PROPERTY_REGEXP = RegExp('[^.[\\]]+' +
-    '|' +
-    '\\[(?:' +
-    '([^"\'][^[]*)' +
-    '|' +
-    '(["\'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2' +
-    ')\\]' +
-    '|' +
-    '(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))', 'g');
 function toPath(deepKey) {
-    if (DOTS_KEY.test(deepKey)) {
-        return deepKey.split('.');
-    }
     const result = [];
-    if (deepKey[0] === '.') {
+    const length = deepKey.length;
+    if (length === 0) {
+        return result;
+    }
+    let index = 0;
+    let key = '';
+    let quoteChar = '';
+    let bracket = false;
+    if (deepKey.charCodeAt(0) === 46) {
         result.push('');
+        index++;
     }
-    const matches = deepKey.matchAll(PROPERTY_REGEXP);
-    for (const match of matches) {
-        let key = match[0];
-        const expr = match[1];
-        const quote = match[2];
-        const substr = match[3];
-        if (quote) {
-            key = substr.replace(ESCAPE_REGEXP, '$1');
+    while (index < length) {
+        const char = deepKey[index];
+        if (quoteChar) {
+            if (char === '\\' && index + 1 < length) {
+                index++;
+                key += deepKey[index];
+            }
+            else if (char === quoteChar) {
+                quoteChar = '';
+            }
+            else {
+                key += char;
+            }
         }
-        else if (expr) {
-            key = expr;
+        else if (bracket) {
+            if (char === '"' || char === "'") {
+                quoteChar = char;
+            }
+            else if (char === ']') {
+                bracket = false;
+                result.push(key);
+                key = '';
+            }
+            else {
+                key += char;
+            }
         }
+        else {
+            if (char === '[') {
+                bracket = true;
+                if (key) {
+                    result.push(key);
+                    key = '';
+                }
+            }
+            else if (char === '.') {
+                if (key) {
+                    result.push(key);
+                    key = '';
+                }
+            }
+            else {
+                key += char;
+            }
+        }
+        index++;
+    }
+    if (key) {
         result.push(key);
     }
     return result;

package/dist/index.d.mts

@@ -22,6 +22,7 @@ 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 { maxBy } from './array/maxBy.mjs';
@@ -90,6 +91,7 @@ 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 { findKey } from './object/findKey.mjs';
 export { flattenObject } from './object/flattenObject.mjs';
 export { invert } from './object/invert.mjs';
 export { mapKeys } from './object/mapKeys.mjs';
@@ -148,4 +150,5 @@ 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 { invariant } from './util/invariant.mjs';

package/dist/index.d.ts

@@ -22,6 +22,7 @@ export { intersection } from './array/intersection.js';
 export { intersectionBy } from './array/intersectionBy.js';
 export { intersectionWith } from './array/intersectionWith.js';
 export { isSubset } from './array/isSubset.js';
+export { isSubsetWith } from './array/isSubsetWith.js';
 export { keyBy } from './array/keyBy.js';
 export { last } from './array/last.js';
 export { maxBy } from './array/maxBy.js';
@@ -90,6 +91,7 @@ export { sum } from './math/sum.js';
 export { sumBy } from './math/sumBy.js';
 export { clone } from './object/clone.js';
 export { cloneDeep } from './object/cloneDeep.js';
+export { findKey } from './object/findKey.js';
 export { flattenObject } from './object/flattenObject.js';
 export { invert } from './object/invert.js';
 export { mapKeys } from './object/mapKeys.js';
@@ -148,4 +150,5 @@ export { trimStart } from './string/trimStart.js';
 export { unescape } from './string/unescape.js';
 export { upperCase } from './string/upperCase.js';
 export { upperFirst } from './string/upperFirst.js';
+export { words } from './string/words.js';
 export { invariant } from './util/invariant.js';

package/dist/index.js

@@ -2,21 +2,21 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('./_chunk/zipWith-Dkv3D1.js');
+const zipWith = require('./_chunk/zipWith-Bb2eZI.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
 const unary = require('./_chunk/unary-CcTNuC.js');
 const function_index = require('./function/index.js');
 const noop = require('./_chunk/noop-2IwLUk.js');
-const sumBy = require('./_chunk/sumBy-RVppiV.js');
+const rangeRight = require('./_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
-const toMerged = require('./_chunk/toMerged-wNz52b.js');
+const toMerged = require('./_chunk/toMerged-CPY8Ug.js');
 const object_index = require('./object/index.js');
 const isWeakSet = require('./_chunk/isWeakSet-D8h8bS.js');
 const predicate_index = require('./predicate/index.js');
 const isPlainObject = require('./_chunk/isPlainObject-octpoD.js');
-const upperFirst = require('./_chunk/upperFirst-BUECmK.js');
+const upperFirst = require('./_chunk/upperFirst-DK_rTF.js');
 const string_index = require('./string/index.js');
 const util_index = require('./util/index.js');
 
@@ -46,6 +46,7 @@ exports.intersection = zipWith.intersection;
 exports.intersectionBy = zipWith.intersectionBy;
 exports.intersectionWith = zipWith.intersectionWith;
 exports.isSubset = zipWith.isSubset;
+exports.isSubsetWith = zipWith.isSubsetWith;
 exports.keyBy = zipWith.keyBy;
 exports.last = zipWith.last;
 exports.maxBy = zipWith.maxBy;
@@ -102,21 +103,22 @@ exports.curryRight = function_index.curryRight;
 exports.spread = function_index.spread;
 exports.throttle = function_index.throttle;
 exports.noop = noop.noop;
-exports.clamp = sumBy.clamp;
-exports.inRange = sumBy.inRange;
-exports.mean = sumBy.mean;
-exports.meanBy = sumBy.meanBy;
-exports.median = sumBy.median;
-exports.medianBy = sumBy.medianBy;
-exports.range = sumBy.range;
-exports.rangeRight = sumBy.rangeRight;
-exports.sum = sumBy.sum;
-exports.sumBy = sumBy.sumBy;
+exports.clamp = rangeRight.clamp;
+exports.inRange = rangeRight.inRange;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.median = rangeRight.median;
+exports.medianBy = rangeRight.medianBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
+exports.sum = rangeRight.sum;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
 exports.round = math_index.round;
+exports.sumBy = math_index.sumBy;
 exports.clone = toMerged.clone;
 exports.cloneDeep = toMerged.cloneDeep;
+exports.findKey = toMerged.findKey;
 exports.flattenObject = toMerged.flattenObject;
 exports.invert = toMerged.invert;
 exports.mapKeys = toMerged.mapKeys;
@@ -173,5 +175,6 @@ exports.trimStart = upperFirst.trimStart;
 exports.unescape = upperFirst.unescape;
 exports.upperCase = upperFirst.upperCase;
 exports.upperFirst = upperFirst.upperFirst;
+exports.words = upperFirst.words;
 exports.startCase = string_index.startCase;
 exports.invariant = util_index.invariant;

package/dist/index.mjs

@@ -22,6 +22,7 @@ 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 { maxBy } from './array/maxBy.mjs';
@@ -90,6 +91,7 @@ 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 { findKey } from './object/findKey.mjs';
 export { flattenObject } from './object/flattenObject.mjs';
 export { invert } from './object/invert.mjs';
 export { mapKeys } from './object/mapKeys.mjs';
@@ -148,4 +150,5 @@ 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 { invariant } from './util/invariant.mjs';

package/dist/math/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const sumBy = require('../_chunk/sumBy-RVppiV.js');
+const rangeRight = require('../_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 
 function round(value, precision = 0) {
@@ -13,16 +13,24 @@ function round(value, precision = 0) {
     return Math.round(value * multiplier) / multiplier;
 }
 
-exports.clamp = sumBy.clamp;
-exports.inRange = sumBy.inRange;
-exports.mean = sumBy.mean;
-exports.meanBy = sumBy.meanBy;
-exports.median = sumBy.median;
-exports.medianBy = sumBy.medianBy;
-exports.range = sumBy.range;
-exports.rangeRight = sumBy.rangeRight;
-exports.sum = sumBy.sum;
-exports.sumBy = sumBy.sumBy;
+function sumBy(items, getValue) {
+    let result = 0;
+    for (let i = 0; i < items.length; i++) {
+        result += getValue(items[i]);
+    }
+    return result;
+}
+
+exports.clamp = rangeRight.clamp;
+exports.inRange = rangeRight.inRange;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.median = rangeRight.median;
+exports.medianBy = rangeRight.medianBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
+exports.sum = rangeRight.sum;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
 exports.round = round;
+exports.sumBy = sumBy;

package/dist/math/range.mjs

@@ -1,11 +1,8 @@
-function range(start, end, step) {
+function range(start, end, step = 1) {
     if (end == null) {
         end = start;
         start = 0;
     }
-    if (step == null) {
-        step = 1;
-    }
     if (!Number.isInteger(step) || step === 0) {
         throw new Error(`The step value must be a non-zero integer.`);
     }

package/dist/math/rangeRight.mjs

@@ -1,11 +1,8 @@
-function rangeRight(start, end, step) {
+function rangeRight(start, end, step = 1) {
     if (end == null) {
         end = start;
         start = 0;
     }
-    if (step == null) {
-        step = 1;
-    }
     if (!Number.isInteger(step) || step === 0) {
         throw new Error(`The step value must be a non-zero integer.`);
     }

package/dist/math/sumBy.mjs

@@ -1,8 +1,9 @@
-import { sum } from './sum.mjs';
-
 function sumBy(items, getValue) {
-    const nums = items.map(x => getValue(x));
-    return sum(nums);
+    let result = 0;
+    for (let i = 0; i < items.length; i++) {
+        result += getValue(items[i]);
+    }
+    return result;
 }
 
 export { sumBy };

package/dist/object/cloneDeep.mjs

@@ -93,7 +93,7 @@ function cloneDeepImpl(obj, stack = new Map()) {
         return result;
     }
     if (typeof obj === 'object' && obj !== null) {
-        const result = {};
+        const result = Object.create(Object.getPrototypeOf(obj));
         stack.set(obj, result);
         copyProperties(result, obj, stack);
         return result;

package/dist/object/findKey.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Finds the key of the first element in the object that satisfies the provided testing function.
+ *
+ * @param {T} obj - The object to search.
+ * @param {(value: T[keyof T], key: keyof T, obj: T) => boolean} predicate - The function to execute on each value in the object. It takes three arguments:
+ *   - value: The current value being processed in the object.
+ *   - key: The key of the current value being processed in the object.
+ *   - obj: The object that findKey was called upon.
+ * @returns {keyof T | undefined} The key of the first element in the object that passes the test, or undefined if no element passes.
+ *
+ * @example
+ * const users = {
+ *   'barney':  { 'age': 36, 'active': true },
+ *   'fred':    { 'age': 40, 'active': false },
+ *   'pebbles': { 'age': 1,  'active': true }
+ * };
+ * findKey(users, function(o) { return o.age < 40; }); => 'barney'
+ */
+declare function findKey<T extends Record<any, any>>(obj: T, predicate: (value: T[keyof T], key: keyof T, obj: T) => boolean): keyof T | undefined;
+
+export { findKey };

package/dist/object/findKey.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Finds the key of the first element in the object that satisfies the provided testing function.
+ *
+ * @param {T} obj - The object to search.
+ * @param {(value: T[keyof T], key: keyof T, obj: T) => boolean} predicate - The function to execute on each value in the object. It takes three arguments:
+ *   - value: The current value being processed in the object.
+ *   - key: The key of the current value being processed in the object.
+ *   - obj: The object that findKey was called upon.
+ * @returns {keyof T | undefined} The key of the first element in the object that passes the test, or undefined if no element passes.
+ *
+ * @example
+ * const users = {
+ *   'barney':  { 'age': 36, 'active': true },
+ *   'fred':    { 'age': 40, 'active': false },
+ *   'pebbles': { 'age': 1,  'active': true }
+ * };
+ * findKey(users, function(o) { return o.age < 40; }); => 'barney'
+ */
+declare function findKey<T extends Record<any, any>>(obj: T, predicate: (value: T[keyof T], key: keyof T, obj: T) => boolean): keyof T | undefined;
+
+export { findKey };

package/dist/object/findKey.mjs

@@ -0,0 +1,6 @@
+function findKey(obj, predicate) {
+    const keys = Object.keys(obj);
+    return keys.find(key => predicate(obj[key], key, obj));
+}
+
+export { findKey };

package/dist/object/index.d.mts

@@ -1,5 +1,6 @@
 export { clone } from './clone.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
+export { findKey } from './findKey.mjs';
 export { flattenObject } from './flattenObject.mjs';
 export { invert } from './invert.mjs';
 export { mapKeys } from './mapKeys.mjs';

package/dist/object/index.d.ts

@@ -1,5 +1,6 @@
 export { clone } from './clone.js';
 export { cloneDeep } from './cloneDeep.js';
+export { findKey } from './findKey.js';
 export { flattenObject } from './flattenObject.js';
 export { invert } from './invert.js';
 export { mapKeys } from './mapKeys.js';

package/dist/object/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const toMerged = require('../_chunk/toMerged-wNz52b.js');
+const toMerged = require('../_chunk/toMerged-CPY8Ug.js');
 
 function mergeWith(target, source, merge) {
     const sourceKeys = Object.keys(source);
@@ -49,6 +49,7 @@ function pick(obj, keys) {
 
 exports.clone = toMerged.clone;
 exports.cloneDeep = toMerged.cloneDeep;
+exports.findKey = toMerged.findKey;
 exports.flattenObject = toMerged.flattenObject;
 exports.invert = toMerged.invert;
 exports.mapKeys = toMerged.mapKeys;

package/dist/object/index.mjs

@@ -1,5 +1,6 @@
 export { clone } from './clone.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
+export { findKey } from './findKey.mjs';
 export { flattenObject } from './flattenObject.mjs';
 export { invert } from './invert.mjs';
 export { mapKeys } from './mapKeys.mjs';

package/dist/object/mapKeys.d.mts

@@ -3,12 +3,11 @@
  * by running each own enumerable property of the object through the iteratee function.
  *
  * @template T - The type of the object.
- * @template K1 - The type of the keys in the object.
- * @template K2 - The type of the new keys generated by the iteratee function.
+ * @template K - The type of the new keys generated by the iteratee function.
  *
  * @param {T} object - The object to iterate over.
- * @param {(value: T[K1], key: K1, object: T) => K2} getNewKey - The function invoked per own enumerable property.
- * @returns {Record<K2, T[K1]>} - Returns the new mapped object.
+ * @param {(value: T[keyof T], key: keyof T, object: T) => K} getNewKey - The function invoked per own enumerable property.
+ * @returns {Record<K, T[keyof T]>} - Returns the new mapped object.
  *
  * @example
  * // Example usage:
@@ -16,6 +15,6 @@
  * const result = mapKeys(obj, (value, key) => key + value);
  * console.log(result); // { a1: 1, b2: 2 }
  */
-declare function mapKeys<T extends object, K1 extends keyof T, K2 extends PropertyKey>(object: T, getNewKey: (value: T[K1], key: K1, object: T) => K2): Record<K2, T[K1]>;
+declare function mapKeys<T extends Record<PropertyKey, any>, K extends PropertyKey>(object: T, getNewKey: (value: T[keyof T], key: keyof T, object: T) => K): Record<K, T[keyof T]>;
 
 export { mapKeys };

package/dist/object/mapKeys.d.ts

@@ -3,12 +3,11 @@
  * by running each own enumerable property of the object through the iteratee function.
  *
  * @template T - The type of the object.
- * @template K1 - The type of the keys in the object.
- * @template K2 - The type of the new keys generated by the iteratee function.
+ * @template K - The type of the new keys generated by the iteratee function.
  *
  * @param {T} object - The object to iterate over.
- * @param {(value: T[K1], key: K1, object: T) => K2} getNewKey - The function invoked per own enumerable property.
- * @returns {Record<K2, T[K1]>} - Returns the new mapped object.
+ * @param {(value: T[keyof T], key: keyof T, object: T) => K} getNewKey - The function invoked per own enumerable property.
+ * @returns {Record<K, T[keyof T]>} - Returns the new mapped object.
  *
  * @example
  * // Example usage:
@@ -16,6 +15,6 @@
  * const result = mapKeys(obj, (value, key) => key + value);
  * console.log(result); // { a1: 1, b2: 2 }
  */
-declare function mapKeys<T extends object, K1 extends keyof T, K2 extends PropertyKey>(object: T, getNewKey: (value: T[K1], key: K1, object: T) => K2): Record<K2, T[K1]>;
+declare function mapKeys<T extends Record<PropertyKey, any>, K extends PropertyKey>(object: T, getNewKey: (value: T[keyof T], key: keyof T, object: T) => K): Record<K, T[keyof T]>;
 
 export { mapKeys };

package/dist/object/mergeWith.d.mts

@@ -46,6 +46,6 @@
  *
  * expect(result).toEqual({ a: [1, 3], b: [2, 4] });
  */
-declare function mergeWith<T, S>(target: T, source: S, merge: (targetValue: any, sourceValue: any, key: string, target: T, source: S) => any): T & S;
+declare function mergeWith<T extends Record<PropertyKey, any>, S extends Record<PropertyKey, any>>(target: T, source: S, merge: (targetValue: any, sourceValue: any, key: string, target: T, source: S) => any): T & S;
 
 export { mergeWith };

package/dist/object/mergeWith.d.ts

@@ -46,6 +46,6 @@
  *
  * expect(result).toEqual({ a: [1, 3], b: [2, 4] });
  */
-declare function mergeWith<T, S>(target: T, source: S, merge: (targetValue: any, sourceValue: any, key: string, target: T, source: S) => any): T & S;
+declare function mergeWith<T extends Record<PropertyKey, any>, S extends Record<PropertyKey, any>>(target: T, source: S, merge: (targetValue: any, sourceValue: any, key: string, target: T, source: S) => any): T & S;
 
 export { mergeWith };

package/dist/object/toMerged.d.mts

@@ -40,6 +40,6 @@
  * console.log(result);
  * // Output: { a: [1, 2, 3] }
  */
-declare function toMerged<T, S>(target: T, source: S): T & S;
+declare function toMerged<T extends Record<PropertyKey, any>, S extends Record<PropertyKey, any>>(target: T, source: S): T & S;
 
 export { toMerged };

package/dist/object/toMerged.d.ts

@@ -40,6 +40,6 @@
  * console.log(result);
  * // Output: { a: [1, 2, 3] }
  */
-declare function toMerged<T, S>(target: T, source: S): T & S;
+declare function toMerged<T extends Record<PropertyKey, any>, S extends Record<PropertyKey, any>>(target: T, source: S): T & S;
 
 export { toMerged };

package/dist/string/camelCase.mjs

@@ -1,12 +1,12 @@
-import { getWords } from './_internal/getWords.mjs';
 import { capitalize } from './capitalize.mjs';
+import { words } from './words.mjs';
 
 function camelCase(str) {
-    const words = getWords(str);
-    if (words.length === 0) {
+    const words$1 = words(str);
+    if (words$1.length === 0) {
         return '';
     }
-    const [first, ...rest] = words;
+    const [first, ...rest] = words$1;
     return `${first.toLowerCase()}${rest.map(word => capitalize(word)).join('')}`;
 }
 

package/dist/string/constantCase.mjs

@@ -1,8 +1,8 @@
-import { getWords } from './_internal/getWords.mjs';
+import { words } from './words.mjs';
 
 function constantCase(str) {
-    const words = getWords(str);
-    return words.map(word => word.toUpperCase()).join('_');
+    const words$1 = words(str);
+    return words$1.map(word => word.toUpperCase()).join('_');
 }
 
 export { constantCase };

package/dist/string/index.d.mts

@@ -17,3 +17,4 @@ export { trimStart } from './trimStart.mjs';
 export { unescape } from './unescape.mjs';
 export { upperCase } from './upperCase.mjs';
 export { upperFirst } from './upperFirst.mjs';
+export { words } from './words.mjs';

package/dist/string/index.d.ts

@@ -17,3 +17,4 @@ export { trimStart } from './trimStart.js';
 export { unescape } from './unescape.js';
 export { upperCase } from './upperCase.js';
 export { upperFirst } from './upperFirst.js';
+export { words } from './words.js';

package/dist/string/index.js

@@ -2,10 +2,10 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const upperFirst = require('../_chunk/upperFirst-BUECmK.js');
+const upperFirst = require('../_chunk/upperFirst-DK_rTF.js');
 
 function startCase(str) {
-    const words = upperFirst.getWords(str.trim());
+    const words = upperFirst.words(str.trim());
     let result = '';
     for (let i = 0; i < words.length; i++) {
         const word = words[i];
@@ -35,4 +35,5 @@ exports.trimStart = upperFirst.trimStart;
 exports.unescape = upperFirst.unescape;
 exports.upperCase = upperFirst.upperCase;
 exports.upperFirst = upperFirst.upperFirst;
+exports.words = upperFirst.words;
 exports.startCase = startCase;