es-toolkit 1.18.0 → 1.19.0

package/dist/string/index.js

@@ -30,6 +30,18 @@ function kebabCase(str) {
     return words.map(word => word.toLowerCase()).join('-');
 }
 
+function upperCase(str) {
+    const words = getWords(str);
+    let result = '';
+    for (let i = 0; i < words.length; i++) {
+        result += words[i].toUpperCase();
+        if (i < words.length - 1) {
+            result += ' ';
+        }
+    }
+    return result;
+}
+
 function lowerCase(str) {
     const words = getWords(str);
     return words.map(word => word.toLowerCase()).join(' ');
@@ -57,6 +69,55 @@ function pascalCase(str) {
     return words.map(word => capitalize(word)).join('');
 }
 
+function trimStart(str, chars) {
+    if (chars === undefined) {
+        return str.trimStart();
+    }
+    let startIndex = 0;
+    switch (typeof chars) {
+        case 'string': {
+            while (startIndex < str.length && str[startIndex] === chars) {
+                startIndex++;
+            }
+            break;
+        }
+        case 'object': {
+            while (startIndex < str.length && chars.includes(str[startIndex])) {
+                startIndex++;
+            }
+        }
+    }
+    return str.substring(startIndex);
+}
+
+function trimEnd(str, chars) {
+    if (chars === undefined) {
+        return str.trimEnd();
+    }
+    let endIndex = str.length;
+    switch (typeof chars) {
+        case 'string': {
+            while (endIndex > 0 && str[endIndex - 1] === chars) {
+                endIndex--;
+            }
+            break;
+        }
+        case 'object': {
+            while (endIndex > 0 && chars.includes(str[endIndex - 1])) {
+                endIndex--;
+            }
+        }
+    }
+    return str.substring(0, endIndex);
+}
+
+function trim(str, chars) {
+    if (chars === undefined) {
+        return str.trim();
+    }
+    return trimStart(trimEnd(str, chars), chars);
+}
+
 function upperFirst(str) {
     return str.substring(0, 1).toUpperCase() + str.substring(1);
 }
@@ -151,5 +212,9 @@ exports.pad = pad;
 exports.pascalCase = pascalCase;
 exports.snakeCase = snakeCase;
 exports.startCase = startCase;
+exports.trim = trim;
+exports.trimEnd = trimEnd;
+exports.trimStart = trimStart;
 exports.unescape = unescape;
+exports.upperCase = upperCase;
 exports.upperFirst = upperFirst;

package/dist/string/index.mjs

@@ -1,10 +1,14 @@
 export { camelCase } from './camelCase.mjs';
 export { snakeCase } from './snakeCase.mjs';
 export { kebabCase } from './kebabCase.mjs';
+export { upperCase } from './upperCase.mjs';
 export { lowerCase } from './lowerCase.mjs';
 export { startCase } from './startCase.mjs';
 export { capitalize } from './capitalize.mjs';
 export { pascalCase } from './pascalCase.mjs';
+export { trim } from './trim.mjs';
+export { trimStart } from './trimStart.mjs';
+export { trimEnd } from './trimEnd.mjs';
 export { upperFirst } from './upperFirst.mjs';
 export { lowerFirst } from './lowerFirst.mjs';
 export { deburr } from './deburr.mjs';

package/dist/string/startCase.d.mts

@@ -7,7 +7,7 @@
  *
  * @example
  * const result1 = startCase('hello world');  // result will be 'Hello World'
- * const result2 = startCase('HELLO WORLD');  // result will be 'Hello World'
+ * const result2 = startCase('HELLO WORLD');  // result will be 'HELLO WORLD'
  * const result3 = startCase('hello-world');  // result will be 'Hello World'
  * const result4 = startCase('hello_world');  // result will be 'Hello World'
  */

package/dist/string/startCase.d.ts

@@ -7,7 +7,7 @@
  *
  * @example
  * const result1 = startCase('hello world');  // result will be 'Hello World'
- * const result2 = startCase('HELLO WORLD');  // result will be 'Hello World'
+ * const result2 = startCase('HELLO WORLD');  // result will be 'HELLO WORLD'
  * const result3 = startCase('hello-world');  // result will be 'Hello World'
  * const result4 = startCase('hello_world');  // result will be 'Hello World'
  */

package/dist/string/trim.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Removes leading and trailing whitespace or specified characters from a string.
+ *
+ * @param {string} str - The string from which characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the string. Can be a single character or an array of characters.
+ * @returns {string} - The resulting string after the specified characters have been removed.
+ *
+ * @example
+ * trim("  hello  "); // "hello"
+ * trim("--hello--", "-"); // "hello"
+ * trim("##hello##", ["#", "o"]); // "hell"
+ */
+declare function trim(str: string, chars?: string | string[]): string;
+
+export { trim };

package/dist/string/trim.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Removes leading and trailing whitespace or specified characters from a string.
+ *
+ * @param {string} str - The string from which characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the string. Can be a single character or an array of characters.
+ * @returns {string} - The resulting string after the specified characters have been removed.
+ *
+ * @example
+ * trim("  hello  "); // "hello"
+ * trim("--hello--", "-"); // "hello"
+ * trim("##hello##", ["#", "o"]); // "hell"
+ */
+declare function trim(str: string, chars?: string | string[]): string;
+
+export { trim };

package/dist/string/trim.mjs

@@ -0,0 +1,11 @@
+import { trimStart } from './trimStart.mjs';
+import { trimEnd } from './trimEnd.mjs';
+
+function trim(str, chars) {
+    if (chars === undefined) {
+        return str.trim();
+    }
+    return trimStart(trimEnd(str, chars), chars);
+}
+
+export { trim };

package/dist/string/trimEnd.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Removes trailing whitespace or specified characters from a string.
+ *
+ * @param {string} str - The string from which trailing characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string.
+ * @returns {string} - The resulting string after the specified trailing character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = trimEnd('hello---', '-') // returns 'hello'
+ * const trimmedStr2 = trimEnd('123000', '0') // returns '123'
+ * const trimmedStr3 = trimEnd('abcabcabc', 'c') // returns 'abcabcab'
+ * const trimmedStr4 = trimEnd('trimmedxxx', 'x') // returns 'trimmed'
+ */
+declare function trimEnd(str: string, chars?: string | string[]): string;
+
+export { trimEnd };

package/dist/string/trimEnd.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Removes trailing whitespace or specified characters from a string.
+ *
+ * @param {string} str - The string from which trailing characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string.
+ * @returns {string} - The resulting string after the specified trailing character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = trimEnd('hello---', '-') // returns 'hello'
+ * const trimmedStr2 = trimEnd('123000', '0') // returns '123'
+ * const trimmedStr3 = trimEnd('abcabcabc', 'c') // returns 'abcabcab'
+ * const trimmedStr4 = trimEnd('trimmedxxx', 'x') // returns 'trimmed'
+ */
+declare function trimEnd(str: string, chars?: string | string[]): string;
+
+export { trimEnd };

package/dist/string/trimEnd.mjs

@@ -0,0 +1,22 @@
+function trimEnd(str, chars) {
+    if (chars === undefined) {
+        return str.trimEnd();
+    }
+    let endIndex = str.length;
+    switch (typeof chars) {
+        case 'string': {
+            while (endIndex > 0 && str[endIndex - 1] === chars) {
+                endIndex--;
+            }
+            break;
+        }
+        case 'object': {
+            while (endIndex > 0 && chars.includes(str[endIndex - 1])) {
+                endIndex--;
+            }
+        }
+    }
+    return str.substring(0, endIndex);
+}
+
+export { trimEnd };

package/dist/string/trimStart.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Removes leading whitespace or specified characters from a string.
+ *
+ * @param {string} str - The string from which leading characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string.
+ * @returns {string} - The resulting string after the specified leading character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = trimStart('---hello', '-') // returns 'hello'
+ * const trimmedStr2 = trimStart('000123', '0') // returns '123'
+ * const trimmedStr3 = trimStart('abcabcabc', 'a') // returns 'bcabcabc'
+ * const trimmedStr4 = trimStart('xxxtrimmed', 'x') // returns 'trimmed'
+ */
+declare function trimStart(str: string, chars?: string | string[]): string;
+
+export { trimStart };

package/dist/string/trimStart.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Removes leading whitespace or specified characters from a string.
+ *
+ * @param {string} str - The string from which leading characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string.
+ * @returns {string} - The resulting string after the specified leading character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = trimStart('---hello', '-') // returns 'hello'
+ * const trimmedStr2 = trimStart('000123', '0') // returns '123'
+ * const trimmedStr3 = trimStart('abcabcabc', 'a') // returns 'bcabcabc'
+ * const trimmedStr4 = trimStart('xxxtrimmed', 'x') // returns 'trimmed'
+ */
+declare function trimStart(str: string, chars?: string | string[]): string;
+
+export { trimStart };

package/dist/string/trimStart.mjs

@@ -0,0 +1,22 @@
+function trimStart(str, chars) {
+    if (chars === undefined) {
+        return str.trimStart();
+    }
+    let startIndex = 0;
+    switch (typeof chars) {
+        case 'string': {
+            while (startIndex < str.length && str[startIndex] === chars) {
+                startIndex++;
+            }
+            break;
+        }
+        case 'object': {
+            while (startIndex < str.length && chars.includes(str[startIndex])) {
+                startIndex++;
+            }
+        }
+    }
+    return str.substring(startIndex);
+}
+
+export { trimStart };

package/dist/string/upperCase.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Converts a string to upper case.
+ *
+ * Upper case is the naming convention in which each word is written in uppercase and separated by an space ( ) character.
+ *
+ * @param {string} str - The string that is to be changed to upper case.
+ * @returns {string} - The converted string to upper case.
+ *
+ * @example
+ * const convertedStr1 = upperCase('camelCase') // returns 'CAMEL CASE'
+ * const convertedStr2 = upperCase('some whitespace') // returns 'SOME WHITESPACE'
+ * const convertedStr3 = upperCase('hyphen-text') // returns 'HYPHEN TEXT'
+ * const convertedStr4 = upperCase('HTTPRequest') // returns 'HTTP REQUEST'
+ */
+declare function upperCase(str: string): string;
+
+export { upperCase };

package/dist/string/upperCase.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts a string to upper case.
+ *
+ * Upper case is the naming convention in which each word is written in uppercase and separated by an space ( ) character.
+ *
+ * @param {string} str - The string that is to be changed to upper case.
+ * @returns {string} - The converted string to upper case.
+ *
+ * @example
+ * const convertedStr1 = upperCase('camelCase') // returns 'CAMEL CASE'
+ * const convertedStr2 = upperCase('some whitespace') // returns 'SOME WHITESPACE'
+ * const convertedStr3 = upperCase('hyphen-text') // returns 'HYPHEN TEXT'
+ * const convertedStr4 = upperCase('HTTPRequest') // returns 'HTTP REQUEST'
+ */
+declare function upperCase(str: string): string;
+
+export { upperCase };

package/dist/string/upperCase.mjs

@@ -0,0 +1,15 @@
+import { getWords } from './_internal/getWords.mjs';
+
+function upperCase(str) {
+    const words = getWords(str);
+    let result = '';
+    for (let i = 0; i < words.length; i++) {
+        result += words[i].toUpperCase();
+        if (i < words.length - 1) {
+            result += ' ';
+        }
+    }
+    return result;
+}
+
+export { upperCase };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

package/dist/compat/_internal/isArrayMatch.mjs

@@ -1,24 +0,0 @@
-import { isMatch } from '../predicate/isMatch.mjs';
-
-function isArrayMatch(target, source) {
-    if (source.length === 0) {
-        return true;
-    }
-    if (!Array.isArray(target)) {
-        return false;
-    }
-    const countedIndex = new Set();
-    for (let i = 0; i < source.length; i++) {
-        const sourceItem = source[i];
-        const index = target.findIndex((targetItem, index) => {
-            return isMatch(targetItem, sourceItem) && !countedIndex.has(index);
-        });
-        if (index === -1) {
-            return false;
-        }
-        countedIndex.add(index);
-    }
-    return true;
-}
-
-export { isArrayMatch };

package/dist/compat/_internal/isMapMatch.mjs

@@ -1,18 +0,0 @@
-import { isMatch } from '../predicate/isMatch.mjs';
-
-function isMapMatch(target, source) {
-    if (source.size === 0) {
-        return true;
-    }
-    if (!(target instanceof Map)) {
-        return false;
-    }
-    for (const [key, value] of source.entries()) {
-        if (!isMatch(target.get(key), value)) {
-            return false;
-        }
-    }
-    return true;
-}
-
-export { isMapMatch };

package/dist/compat/_internal/isSetMatch.mjs

@@ -1,13 +0,0 @@
-import { isArrayMatch } from './isArrayMatch.mjs';
-
-function isSetMatch(target, source) {
-    if (source.size === 0) {
-        return true;
-    }
-    if (!(target instanceof Set)) {
-        return false;
-    }
-    return isArrayMatch([...target], [...source]);
-}
-
-export { isSetMatch };

package/dist/compat/_internal/toPath.mjs

@@ -1,40 +0,0 @@
-function toPath(deepKey) {
-    const ESCAPE_REGEXP = /\\(\\)?/g;
-    const PROPERTY_REGEXP = RegExp('[^.[\\]]+' +
-        '|' +
-        '\\[(?:' +
-        '([^"\'][^[]*)' +
-        '|' +
-        '(["\'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2' +
-        ')\\]' +
-        '|' +
-        '(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))', 'g');
-    const result = [];
-    if (deepKey[0] === '.') {
-        result.push('');
-    }
-    let match;
-    let lastIndex = 0;
-    while ((match = PROPERTY_REGEXP.exec(deepKey)) !== null) {
-        let key = match[0];
-        const expr = match[1];
-        const quote = match[2];
-        const substr = match[3];
-        if (quote) {
-            key = substr.replace(ESCAPE_REGEXP, '$1');
-        }
-        else if (expr) {
-            key = expr;
-        }
-        result.push(key);
-        if (PROPERTY_REGEXP.lastIndex === lastIndex) {
-            PROPERTY_REGEXP.lastIndex++;
-        }
-        else {
-            lastIndex = PROPERTY_REGEXP.lastIndex;
-        }
-    }
-    return result;
-}
-
-export { toPath };

package/dist/_chunk/{isTypedArray-Dsrnb1.js → isPlainObject-BIekvL.js}

@@ -1,5 +1,13 @@
 'use strict';
 
+function isTypedArray(x) {
+    return ArrayBuffer.isView(x) && !(x instanceof DataView);
+}
+
+function isPrimitive(value) {
+    return value == null || (typeof value !== 'object' && typeof value !== 'function');
+}
+
 function isPlainObject(object) {
     if (typeof object !== 'object') {
         return false;
@@ -20,14 +28,6 @@ function isPlainObject(object) {
     return Object.getPrototypeOf(object) === proto;
 }
 
-function isPrimitive(value) {
-    return value == null || (typeof value !== 'object' && typeof value !== 'function');
-}
-
-function isTypedArray(x) {
-    return ArrayBuffer.isView(x) && !(x instanceof DataView);
-}
-
 exports.isPlainObject = isPlainObject;
 exports.isPrimitive = isPrimitive;
 exports.isTypedArray = isTypedArray;