es-toolkit 1.18.0-dev.580 → 1.18.0-dev.581

package/dist/compat/index.d.mts

@@ -95,6 +95,9 @@ export { lowerCase } from '../string/lowerCase.mjs';
 export { startCase } from '../string/startCase.mjs';
 export { capitalize } from '../string/capitalize.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
+export { trim } from '../string/trim.mjs';
+export { ltrim } from '../string/ltrim.mjs';
+export { rtrim } from '../string/rtrim.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
 export { lowerFirst } from '../string/lowerFirst.mjs';
 export { deburr } from '../string/deburr.mjs';

package/dist/compat/index.d.ts

@@ -95,6 +95,9 @@ export { lowerCase } from '../string/lowerCase.js';
 export { startCase } from '../string/startCase.js';
 export { capitalize } from '../string/capitalize.js';
 export { pascalCase } from '../string/pascalCase.js';
+export { trim } from '../string/trim.js';
+export { ltrim } from '../string/ltrim.js';
+export { rtrim } from '../string/rtrim.js';
 export { upperFirst } from '../string/upperFirst.js';
 export { lowerFirst } from '../string/lowerFirst.js';
 export { deburr } from '../string/deburr.js';

package/dist/compat/index.js

@@ -1220,10 +1220,13 @@ exports.escapeRegExp = string_index.escapeRegExp;
 exports.kebabCase = string_index.kebabCase;
 exports.lowerCase = string_index.lowerCase;
 exports.lowerFirst = string_index.lowerFirst;
+exports.ltrim = string_index.ltrim;
 exports.pad = string_index.pad;
 exports.pascalCase = string_index.pascalCase;
+exports.rtrim = string_index.rtrim;
 exports.snakeCase = string_index.snakeCase;
 exports.startCase = string_index.startCase;
+exports.trim = string_index.trim;
 exports.unescape = string_index.unescape;
 exports.upperCase = string_index.upperCase;
 exports.upperFirst = string_index.upperFirst;

package/dist/compat/index.mjs

@@ -96,6 +96,9 @@ export { upperCase } from '../string/upperCase.mjs';
 export { lowerCase } from '../string/lowerCase.mjs';
 export { startCase } from '../string/startCase.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
+export { trim } from '../string/trim.mjs';
+export { ltrim } from '../string/ltrim.mjs';
+export { rtrim } from '../string/rtrim.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
 export { lowerFirst } from '../string/lowerFirst.mjs';
 export { deburr } from '../string/deburr.mjs';

package/dist/index.d.mts

@@ -120,6 +120,9 @@ export { lowerCase } from './string/lowerCase.mjs';
 export { startCase } from './string/startCase.mjs';
 export { capitalize } from './string/capitalize.mjs';
 export { pascalCase } from './string/pascalCase.mjs';
+export { trim } from './string/trim.mjs';
+export { ltrim } from './string/ltrim.mjs';
+export { rtrim } from './string/rtrim.mjs';
 export { upperFirst } from './string/upperFirst.mjs';
 export { lowerFirst } from './string/lowerFirst.mjs';
 export { deburr } from './string/deburr.mjs';

package/dist/index.d.ts

@@ -120,6 +120,9 @@ export { lowerCase } from './string/lowerCase.js';
 export { startCase } from './string/startCase.js';
 export { capitalize } from './string/capitalize.js';
 export { pascalCase } from './string/pascalCase.js';
+export { trim } from './string/trim.js';
+export { ltrim } from './string/ltrim.js';
+export { rtrim } from './string/rtrim.js';
 export { upperFirst } from './string/upperFirst.js';
 export { lowerFirst } from './string/lowerFirst.js';
 export { deburr } from './string/deburr.js';

package/dist/index.js

@@ -141,10 +141,13 @@ exports.escapeRegExp = string_index.escapeRegExp;
 exports.kebabCase = string_index.kebabCase;
 exports.lowerCase = string_index.lowerCase;
 exports.lowerFirst = string_index.lowerFirst;
+exports.ltrim = string_index.ltrim;
 exports.pad = string_index.pad;
 exports.pascalCase = string_index.pascalCase;
+exports.rtrim = string_index.rtrim;
 exports.snakeCase = string_index.snakeCase;
 exports.startCase = string_index.startCase;
+exports.trim = string_index.trim;
 exports.unescape = string_index.unescape;
 exports.upperCase = string_index.upperCase;
 exports.upperFirst = string_index.upperFirst;

package/dist/index.mjs

@@ -120,6 +120,9 @@ export { lowerCase } from './string/lowerCase.mjs';
 export { startCase } from './string/startCase.mjs';
 export { capitalize } from './string/capitalize.mjs';
 export { pascalCase } from './string/pascalCase.mjs';
+export { trim } from './string/trim.mjs';
+export { ltrim } from './string/ltrim.mjs';
+export { rtrim } from './string/rtrim.mjs';
 export { upperFirst } from './string/upperFirst.mjs';
 export { lowerFirst } from './string/lowerFirst.mjs';
 export { deburr } from './string/deburr.mjs';

package/dist/string/index.d.mts

@@ -6,6 +6,9 @@ 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 { ltrim } from './ltrim.mjs';
+export { rtrim } from './rtrim.mjs';
 export { upperFirst } from './upperFirst.mjs';
 export { lowerFirst } from './lowerFirst.mjs';
 export { deburr } from './deburr.mjs';

package/dist/string/index.d.ts

@@ -6,6 +6,9 @@ export { lowerCase } from './lowerCase.js';
 export { startCase } from './startCase.js';
 export { capitalize } from './capitalize.js';
 export { pascalCase } from './pascalCase.js';
+export { trim } from './trim.js';
+export { ltrim } from './ltrim.js';
+export { rtrim } from './rtrim.js';
 export { upperFirst } from './upperFirst.js';
 export { lowerFirst } from './lowerFirst.js';
 export { deburr } from './deburr.js';

package/dist/string/index.js

@@ -69,6 +69,33 @@ function pascalCase(str) {
     return words.map(word => capitalize(word)).join('');
 }
 
+const ltrim = (str, toTrim) => {
+    const chars = str.split('');
+    let startHere = 0;
+    while ((chars[startHere] === toTrim || toTrim.includes(chars[startHere])) && startHere < chars.length) {
+        startHere++;
+    }
+    return chars.splice(startHere, chars.length).join('');
+};
+
+const rtrim = (str, toTrim) => {
+    const chars = str.split('');
+    while (chars.length > 0) {
+        const lastChar = chars[chars.length - 1];
+        if (typeof toTrim === 'string' ? lastChar === toTrim : toTrim.includes(lastChar)) {
+            chars.pop();
+        }
+        else {
+            break;
+        }
+    }
+    return chars.join('');
+};
+
+const trim = (str, toTrim) => {
+    return ltrim(rtrim(str, toTrim), toTrim);
+};
+
 function upperFirst(str) {
     return str.substring(0, 1).toUpperCase() + str.substring(1);
 }
@@ -159,10 +186,13 @@ exports.escapeRegExp = escapeRegExp;
 exports.kebabCase = kebabCase;
 exports.lowerCase = lowerCase;
 exports.lowerFirst = lowerFirst;
+exports.ltrim = ltrim;
 exports.pad = pad;
 exports.pascalCase = pascalCase;
+exports.rtrim = rtrim;
 exports.snakeCase = snakeCase;
 exports.startCase = startCase;
+exports.trim = trim;
 exports.unescape = unescape;
 exports.upperCase = upperCase;
 exports.upperFirst = upperFirst;

package/dist/string/index.mjs

@@ -6,6 +6,9 @@ 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 { ltrim } from './ltrim.mjs';
+export { rtrim } from './rtrim.mjs';
 export { upperFirst } from './upperFirst.mjs';
 export { lowerFirst } from './lowerFirst.mjs';
 export { deburr } from './deburr.mjs';

package/dist/string/ltrim.d.mts

@@ -0,0 +1,22 @@
+import { TrimParameter } from './trim.mjs';
+
+/**
+ * Trims specific characters from the start of a string.
+ *
+ * This function removes all leading occurrences of the specified character from the input string.
+ * Only the characters at the beginning of the string will be removed.
+ *
+ * @param {string} str - The string from which leading characters will be trimmed.
+ * @param {string} toTrim - The character to remove from the start of the string.
+ * @returns {string} - The resulting string after the specified leading character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = ltrim('---hello', '-') // returns 'hello'
+ * const trimmedStr2 = ltrim('000123', '0') // returns '123'
+ * const trimmedStr3 = ltrim('abcabcabc', 'a') // returns 'bcabcabc'
+ * const trimmedStr4 = ltrim('xxxtrimmed', 'x') // returns 'trimmed'
+ */
+
+declare const ltrim: (str: string, toTrim: TrimParameter) => string;
+
+export { ltrim };

package/dist/string/ltrim.d.ts

@@ -0,0 +1,22 @@
+import { TrimParameter } from './trim.js';
+
+/**
+ * Trims specific characters from the start of a string.
+ *
+ * This function removes all leading occurrences of the specified character from the input string.
+ * Only the characters at the beginning of the string will be removed.
+ *
+ * @param {string} str - The string from which leading characters will be trimmed.
+ * @param {string} toTrim - The character to remove from the start of the string.
+ * @returns {string} - The resulting string after the specified leading character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = ltrim('---hello', '-') // returns 'hello'
+ * const trimmedStr2 = ltrim('000123', '0') // returns '123'
+ * const trimmedStr3 = ltrim('abcabcabc', 'a') // returns 'bcabcabc'
+ * const trimmedStr4 = ltrim('xxxtrimmed', 'x') // returns 'trimmed'
+ */
+
+declare const ltrim: (str: string, toTrim: TrimParameter) => string;
+
+export { ltrim };

package/dist/string/ltrim.mjs

@@ -0,0 +1,10 @@
+const ltrim = (str, toTrim) => {
+    const chars = str.split('');
+    let startHere = 0;
+    while ((chars[startHere] === toTrim || toTrim.includes(chars[startHere])) && startHere < chars.length) {
+        startHere++;
+    }
+    return chars.splice(startHere, chars.length).join('');
+};
+
+export { ltrim };

package/dist/string/rtrim.d.mts

@@ -0,0 +1,22 @@
+import { TrimParameter } from './trim.mjs';
+
+/**
+ * Trims specific characters from the end of a string.
+ *
+ * This function removes all trailing occurrences of the specified character from the input string.
+ * Only the characters at the end of the string will be removed.
+ *
+ * @param {string} str - The string from which trailing characters will be trimmed.
+ * @param {string} toTrim - The character to remove from the end of the string.
+ * @returns {string} - The resulting string after the specified trailing character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = rtrim('hello---', '-') // returns 'hello'
+ * const trimmedStr2 = rtrim('123000', '0') // returns '123'
+ * const trimmedStr3 = rtrim('abcabcabc', 'c') // returns 'abcabcab'
+ * const trimmedStr4 = rtrim('trimmedxxx', 'x') // returns 'trimmed'
+ */
+
+declare const rtrim: (str: string, toTrim: TrimParameter) => string;
+
+export { rtrim };

package/dist/string/rtrim.d.ts

@@ -0,0 +1,22 @@
+import { TrimParameter } from './trim.js';
+
+/**
+ * Trims specific characters from the end of a string.
+ *
+ * This function removes all trailing occurrences of the specified character from the input string.
+ * Only the characters at the end of the string will be removed.
+ *
+ * @param {string} str - The string from which trailing characters will be trimmed.
+ * @param {string} toTrim - The character to remove from the end of the string.
+ * @returns {string} - The resulting string after the specified trailing character has been removed.
+ *
+ * @example
+ * const trimmedStr1 = rtrim('hello---', '-') // returns 'hello'
+ * const trimmedStr2 = rtrim('123000', '0') // returns '123'
+ * const trimmedStr3 = rtrim('abcabcabc', 'c') // returns 'abcabcab'
+ * const trimmedStr4 = rtrim('trimmedxxx', 'x') // returns 'trimmed'
+ */
+
+declare const rtrim: (str: string, toTrim: TrimParameter) => string;
+
+export { rtrim };

package/dist/string/rtrim.mjs

@@ -0,0 +1,15 @@
+const rtrim = (str, toTrim) => {
+    const chars = str.split('');
+    while (chars.length > 0) {
+        const lastChar = chars[chars.length - 1];
+        if (typeof toTrim === 'string' ? lastChar === toTrim : toTrim.includes(lastChar)) {
+            chars.pop();
+        }
+        else {
+            break;
+        }
+    }
+    return chars.join('');
+};
+
+export { rtrim };

package/dist/string/trim.d.mts

@@ -0,0 +1,4 @@
+type TrimParameter = string | string[];
+declare const trim: (str: string, toTrim: TrimParameter) => string;
+
+export { type TrimParameter, trim };

package/dist/string/trim.d.ts

@@ -0,0 +1,4 @@
+type TrimParameter = string | string[];
+declare const trim: (str: string, toTrim: TrimParameter) => string;
+
+export { type TrimParameter, trim };

package/dist/string/trim.mjs

@@ -0,0 +1,8 @@
+import { ltrim } from './ltrim.mjs';
+import { rtrim } from './rtrim.mjs';
+
+const trim = (str, toTrim) => {
+    return ltrim(rtrim(str, toTrim), toTrim);
+};
+
+export { trim };

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-dev.580+db82e936",
+  "version": "1.18.0-dev.581+5a7d931c",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {