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

package/dist/compat/index.d.mts

@@ -95,9 +95,6 @@ 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';
@@ -164,6 +161,9 @@ 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';

package/dist/compat/index.d.ts

@@ -95,9 +95,6 @@ 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';
@@ -164,6 +161,9 @@ 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';

package/dist/compat/index.js

@@ -1060,6 +1060,72 @@ function repeat(str, n) {
     return str.repeat(n);
 }
 
+function trim(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trim();
+    }
+    switch (typeof chars) {
+        case 'string': {
+            return string_index.trim(str, chars.toString().split(''));
+        }
+        case 'object': {
+            if (Array.isArray(chars)) {
+                return string_index.trim(str, chars.map(x => x.toString()));
+            }
+            else {
+                return string_index.trim(str, chars.toString().split(''));
+            }
+        }
+    }
+}
+
+function trimStart(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trimStart();
+    }
+    switch (typeof chars) {
+        case 'string': {
+            return string_index.trimStart(str, chars.toString().split(''));
+        }
+        case 'object': {
+            if (Array.isArray(chars)) {
+                return string_index.trimStart(str, chars.map(x => x.toString()));
+            }
+            else {
+                return string_index.trimStart(str, chars.toString().split(''));
+            }
+        }
+    }
+}
+
+function trimEnd(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trimEnd();
+    }
+    switch (typeof chars) {
+        case 'string': {
+            return string_index.trimEnd(str, chars.toString().split(''));
+        }
+        case 'object': {
+            if (Array.isArray(chars)) {
+                return string_index.trimEnd(str, chars.map(x => x.toString()));
+            }
+            else {
+                return string_index.trimEnd(str, chars.toString().split(''));
+            }
+        }
+    }
+}
+
 function max(items = []) {
     let maxElement = items[0];
     let max = undefined;
@@ -1220,13 +1286,10 @@ 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;
@@ -1293,4 +1356,7 @@ exports.some = some;
 exports.sortBy = sortBy;
 exports.spread = spread;
 exports.startsWith = startsWith;
+exports.trim = trim;
+exports.trimEnd = trimEnd;
+exports.trimStart = trimStart;
 exports.zipObjectDeep = zipObjectDeep;

package/dist/compat/index.mjs

@@ -96,9 +96,6 @@ 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';
@@ -164,6 +161,9 @@ 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';

package/dist/compat/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 leading and trailing characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string. Defaults to `" "`.
+ * @returns {string} - The resulting string after the specified leading and trailing characters have been removed.
+ *
+ * @example
+ * trim("  hello  "); // "hello"
+ * trim("--hello--", "-"); // "hello"
+ * trim("##hello##", ["#", "o"]); // "hell"
+ */
+declare function trim(str: string, chars?: string | string[], guard?: unknown): string;
+
+export { trim };

package/dist/compat/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 leading and trailing characters will be trimmed.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string. Defaults to `" "`.
+ * @returns {string} - The resulting string after the specified leading and trailing characters have been removed.
+ *
+ * @example
+ * trim("  hello  "); // "hello"
+ * trim("--hello--", "-"); // "hello"
+ * trim("##hello##", ["#", "o"]); // "hell"
+ */
+declare function trim(str: string, chars?: string | string[], guard?: unknown): string;
+
+export { trim };

package/dist/compat/string/trim.mjs

@@ -0,0 +1,25 @@
+import { trim as trim$1 } from '../../string/trim.mjs';
+
+function trim(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trim();
+    }
+    switch (typeof chars) {
+        case 'string': {
+            return trim$1(str, chars.toString().split(''));
+        }
+        case 'object': {
+            if (Array.isArray(chars)) {
+                return trim$1(str, chars.map(x => x.toString()));
+            }
+            else {
+                return trim$1(str, chars.toString().split(''));
+            }
+        }
+    }
+}
+
+export { trim };

package/dist/compat/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. Defaults to `" "`.
+ * @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[], guard?: unknown): string;
+
+export { trimEnd };

package/dist/compat/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. Defaults to `" "`.
+ * @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[], guard?: unknown): string;
+
+export { trimEnd };

package/dist/compat/string/trimEnd.mjs

@@ -0,0 +1,25 @@
+import { trimEnd as trimEnd$1 } from '../../string/trimEnd.mjs';
+
+function trimEnd(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trimEnd();
+    }
+    switch (typeof chars) {
+        case 'string': {
+            return trimEnd$1(str, chars.toString().split(''));
+        }
+        case 'object': {
+            if (Array.isArray(chars)) {
+                return trimEnd$1(str, chars.map(x => x.toString()));
+            }
+            else {
+                return trimEnd$1(str, chars.toString().split(''));
+            }
+        }
+    }
+}
+
+export { trimEnd };

package/dist/{string/ltrim.d.ts → compat/string/trimStart.d.mts}

@@ -1,13 +1,8 @@
-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.
+ * Removes leading whitespace or specified characters from a string.
  *
  * @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.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string. Defaults to `" "`.
  * @returns {string} - The resulting string after the specified leading character has been removed.
  *
  * @example
@@ -16,7 +11,6 @@ import { TrimParameter } from './trim.js';
  * const trimmedStr3 = ltrim('abcabcabc', 'a') // returns 'bcabcabc'
  * const trimmedStr4 = ltrim('xxxtrimmed', 'x') // returns 'trimmed'
  */
+declare function trimStart(str: string, chars?: string | string[], guard?: unknown): string;
 
-declare const ltrim: (str: string, toTrim: TrimParameter) => string;
-
-export { ltrim };
+export { trimStart };

package/dist/{string/ltrim.d.mts → compat/string/trimStart.d.ts}

@@ -1,13 +1,8 @@
-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.
+ * Removes leading whitespace or specified characters from a string.
  *
  * @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.
+ * @param {string | string[]} chars - The character(s) to remove from the end of the string. Defaults to `" "`.
  * @returns {string} - The resulting string after the specified leading character has been removed.
  *
  * @example
@@ -16,7 +11,6 @@ import { TrimParameter } from './trim.mjs';
  * const trimmedStr3 = ltrim('abcabcabc', 'a') // returns 'bcabcabc'
  * const trimmedStr4 = ltrim('xxxtrimmed', 'x') // returns 'trimmed'
  */
+declare function trimStart(str: string, chars?: string | string[], guard?: unknown): string;
 
-declare const ltrim: (str: string, toTrim: TrimParameter) => string;
-
-export { ltrim };
+export { trimStart };

package/dist/compat/string/trimStart.mjs

@@ -0,0 +1,25 @@
+import { trimStart as trimStart$1 } from '../../string/trimStart.mjs';
+
+function trimStart(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trimStart();
+    }
+    switch (typeof chars) {
+        case 'string': {
+            return trimStart$1(str, chars.toString().split(''));
+        }
+        case 'object': {
+            if (Array.isArray(chars)) {
+                return trimStart$1(str, chars.map(x => x.toString()));
+            }
+            else {
+                return trimStart$1(str, chars.toString().split(''));
+            }
+        }
+    }
+}
+
+export { trimStart };

package/dist/index.d.mts

@@ -121,8 +121,8 @@ 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 { trimStart } from './string/trimStart.mjs';
+export { trimEnd } from './string/trimEnd.mjs';
 export { upperFirst } from './string/upperFirst.mjs';
 export { lowerFirst } from './string/lowerFirst.mjs';
 export { deburr } from './string/deburr.mjs';

package/dist/index.d.ts

@@ -121,8 +121,8 @@ 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 { trimStart } from './string/trimStart.js';
+export { trimEnd } from './string/trimEnd.js';
 export { upperFirst } from './string/upperFirst.js';
 export { lowerFirst } from './string/lowerFirst.js';
 export { deburr } from './string/deburr.js';

package/dist/index.js

@@ -141,13 +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.trimEnd = string_index.trimEnd;
+exports.trimStart = string_index.trimStart;
 exports.unescape = string_index.unescape;
 exports.upperCase = string_index.upperCase;
 exports.upperFirst = string_index.upperFirst;

package/dist/index.mjs

@@ -121,8 +121,8 @@ 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 { trimStart } from './string/trimStart.mjs';
+export { trimEnd } from './string/trimEnd.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

@@ -7,8 +7,8 @@ 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 { 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/index.d.ts

@@ -7,8 +7,8 @@ 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 { trimStart } from './trimStart.js';
+export { trimEnd } from './trimEnd.js';
 export { upperFirst } from './upperFirst.js';
 export { lowerFirst } from './lowerFirst.js';
 export { deburr } from './deburr.js';

package/dist/string/index.js

@@ -69,32 +69,54 @@ 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++;
+function trimStart(str, chars) {
+    if (chars == null) {
+        return str.trimStart();
     }
-    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();
+    let startIndex = 0;
+    switch (typeof chars) {
+        case 'string': {
+            while (startIndex < str.length && str[startIndex] === chars) {
+                startIndex++;
+            }
+            break;
         }
-        else {
+        case 'object': {
+            while (startIndex < str.length && chars.includes(str[startIndex])) {
+                startIndex++;
+            }
+        }
+    }
+    return str.substring(startIndex);
+}
+
+function trimEnd(str, chars) {
+    if (chars == null) {
+        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 chars.join('');
-};
+    return str.substring(0, endIndex);
+}
 
-const trim = (str, toTrim) => {
-    return ltrim(rtrim(str, toTrim), toTrim);
-};
+function trim(str, chars) {
+    if (chars == null) {
+        return str.trim();
+    }
+    return trimStart(trimEnd(str, chars), chars);
+}
 
 function upperFirst(str) {
     return str.substring(0, 1).toUpperCase() + str.substring(1);
@@ -186,13 +208,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.trimEnd = trimEnd;
+exports.trimStart = trimStart;
 exports.unescape = unescape;
 exports.upperCase = upperCase;
 exports.upperFirst = upperFirst;

package/dist/string/index.mjs

@@ -7,8 +7,8 @@ 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 { 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/trim.d.mts

@@ -1,4 +1,15 @@
-type TrimParameter = string | string[];
-declare const trim: (str: string, toTrim: TrimParameter) => string;
+/**
+ * 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 { type TrimParameter, trim };
+export { trim };

package/dist/string/trim.d.ts

@@ -1,4 +1,15 @@
-type TrimParameter = string | string[];
-declare const trim: (str: string, toTrim: TrimParameter) => string;
+/**
+ * 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 { type TrimParameter, trim };
+export { trim };

package/dist/string/trim.mjs

@@ -1,8 +1,11 @@
-import { ltrim } from './ltrim.mjs';
-import { rtrim } from './rtrim.mjs';
+import { trimStart } from './trimStart.mjs';
+import { trimEnd } from './trimEnd.mjs';
 
-const trim = (str, toTrim) => {
-    return ltrim(rtrim(str, toTrim), toTrim);
-};
+function trim(str, chars) {
+    if (chars == null) {
+        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 };