mcp-ide 0.1.0

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/toLower.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Converts the given value to a string and transforms it to lower case.
+ * The function can handle various input types by first converting them to strings.
+ *
+ * @param {unknown} [value=''] The value to convert.
+ * @returns {string} Returns the lower cased string.
+ * @example
+ *
+ * toLower('--FOO-BAR--');
+ * // => '--foo-bar--'
+ *
+ * toLower(null);
+ * // => ''
+ *
+ * toLower([1, 2, 3]);
+ * // => '1,2,3'
+ */
+declare function toLower<T extends string = string>(value?: T): Lowercase<T>;
+
+export { toLower };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/toLower.js

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const toString = require('../util/toString.js');
+
+function toLower(value) {
+    return toString.toString(value).toLowerCase();
+}
+
+exports.toLower = toLower;

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/toLower.mjs

@@ -0,0 +1,7 @@
+import { toString } from '../util/toString.mjs';
+
+function toLower(value) {
+    return toString(value).toLowerCase();
+}
+
+export { toLower };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/toUpper.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Converts `string`, as a whole, to upper case just like
+ * [String#toUpperCase](https://mdn.io/toUpperCase).
+ *
+ * @param {unknown} [value=''] The value to convert.
+ * @returns {string} Returns the upper cased string.
+ * @example
+ *
+ * toUpper('--foo-bar--');
+ * // => '--FOO-BAR--'
+ *
+ * toUpper(null);
+ * // => ''
+ *
+ * toUpper([1, 2, 3]);
+ * // => '1,2,3'
+ */
+declare function toUpper<T extends string = string>(value?: T): Uppercase<T>;
+
+export { toUpper };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/toUpper.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Converts `string`, as a whole, to upper case just like
+ * [String#toUpperCase](https://mdn.io/toUpperCase).
+ *
+ * @param {unknown} [value=''] The value to convert.
+ * @returns {string} Returns the upper cased string.
+ * @example
+ *
+ * toUpper('--foo-bar--');
+ * // => '--FOO-BAR--'
+ *
+ * toUpper(null);
+ * // => ''
+ *
+ * toUpper([1, 2, 3]);
+ * // => '1,2,3'
+ */
+declare function toUpper<T extends string = string>(value?: T): Uppercase<T>;
+
+export { toUpper };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/toUpper.js

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const toString = require('../util/toString.js');
+
+function toUpper(value) {
+    return toString.toString(value).toUpperCase();
+}
+
+exports.toUpper = toUpper;

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/toUpper.mjs

@@ -0,0 +1,7 @@
+import { toString } from '../util/toString.mjs';
+
+function toUpper(value) {
+    return toString(value).toUpperCase();
+}
+
+export { toUpper };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trim.d.mts

@@ -0,0 +1,28 @@
+/**
+ * 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(string?: string, chars?: string): string;
+/**
+ * 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(string: string, index: string | number, guard: object): string;
+
+export { trim };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trim.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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(string?: string, chars?: string): string;
+/**
+ * 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(string: string, index: string | number, guard: object): string;
+
+export { trim };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trim.js

@@ -0,0 +1,29 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const trim$1 = require('../../string/trim.js');
+
+function trim(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trim();
+    }
+    switch (typeof chars) {
+        case 'object': {
+            if (Array.isArray(chars)) {
+                return trim$1.trim(str, chars.flatMap(x => x.toString().split('')));
+            }
+            else {
+                return trim$1.trim(str, chars.toString().split(''));
+            }
+        }
+        default: {
+            return trim$1.trim(str, chars.toString().split(''));
+        }
+    }
+}
+
+exports.trim = trim;

package/dist/ink-runner/node_modules/es-toolkit/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 'object': {
+            if (Array.isArray(chars)) {
+                return trim$1(str, chars.flatMap(x => x.toString().split('')));
+            }
+            else {
+                return trim$1(str, chars.toString().split(''));
+            }
+        }
+        default: {
+            return trim$1(str, chars.toString().split(''));
+        }
+    }
+}
+
+export { trim };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimEnd.d.mts

@@ -0,0 +1,30 @@
+/**
+ * Removes trailing whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string} chars - The characters to trim from the end of the string.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimEnd('  abc  ');
+ * // => '  abc'
+ *
+ * trimEnd('-_-abc-_-', '_-');
+ * // => '-_-abc'
+ */
+declare function trimEnd(string?: string, chars?: string): string;
+/**
+ * Removes trailing whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string | number} index - The index parameter (used with guard).
+ * @param {object} guard - Enables use as an iteratee for methods like `map`.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimEnd('  abc  ', 0, {});
+ * // => '  abc'
+ */
+declare function trimEnd(string: string, index: string | number, guard: object): string;
+
+export { trimEnd };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimEnd.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Removes trailing whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string} chars - The characters to trim from the end of the string.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimEnd('  abc  ');
+ * // => '  abc'
+ *
+ * trimEnd('-_-abc-_-', '_-');
+ * // => '-_-abc'
+ */
+declare function trimEnd(string?: string, chars?: string): string;
+/**
+ * Removes trailing whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string | number} index - The index parameter (used with guard).
+ * @param {object} guard - Enables use as an iteratee for methods like `map`.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimEnd('  abc  ', 0, {});
+ * // => '  abc'
+ */
+declare function trimEnd(string: string, index: string | number, guard: object): string;
+
+export { trimEnd };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimEnd.js

@@ -0,0 +1,17 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const trimEnd$1 = require('../../string/trimEnd.js');
+
+function trimEnd(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trimEnd();
+    }
+    return trimEnd$1.trimEnd(str, chars.toString().split(''));
+}
+
+exports.trimEnd = trimEnd;

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimEnd.mjs

@@ -0,0 +1,13 @@
+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();
+    }
+    return trimEnd$1(str, chars.toString().split(''));
+}
+
+export { trimEnd };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimStart.d.mts

@@ -0,0 +1,30 @@
+/**
+ * Removes leading whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string} chars - The characters to trim from the start of the string.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimStart('  abc  ');
+ * // => 'abc  '
+ *
+ * trimStart('-_-abc-_-', '_-');
+ * // => 'abc-_-'
+ */
+declare function trimStart(string?: string, chars?: string): string;
+/**
+ * Removes leading whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string | number} index - The index parameter (used with guard).
+ * @param {object} guard - Enables use as an iteratee for methods like `map`.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimStart('  abc  ', 0, {});
+ * // => 'abc  '
+ */
+declare function trimStart(string: string, index: string | number, guard: object): string;
+
+export { trimStart };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimStart.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Removes leading whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string} chars - The characters to trim from the start of the string.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimStart('  abc  ');
+ * // => 'abc  '
+ *
+ * trimStart('-_-abc-_-', '_-');
+ * // => 'abc-_-'
+ */
+declare function trimStart(string?: string, chars?: string): string;
+/**
+ * Removes leading whitespace or specified characters from a string.
+ *
+ * @param {string} string - The string to trim.
+ * @param {string | number} index - The index parameter (used with guard).
+ * @param {object} guard - Enables use as an iteratee for methods like `map`.
+ * @returns {string} Returns the trimmed string.
+ *
+ * @example
+ * trimStart('  abc  ', 0, {});
+ * // => 'abc  '
+ */
+declare function trimStart(string: string, index: string | number, guard: object): string;
+
+export { trimStart };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimStart.js

@@ -0,0 +1,17 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const trimStart$1 = require('../../string/trimStart.js');
+
+function trimStart(str, chars, guard) {
+    if (str == null) {
+        return '';
+    }
+    if (guard != null || chars == null) {
+        return str.toString().trimStart();
+    }
+    return trimStart$1.trimStart(str, chars.toString().split(''));
+}
+
+exports.trimStart = trimStart;

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/trimStart.mjs

@@ -0,0 +1,13 @@
+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();
+    }
+    return trimStart$1(str, chars.toString().split(''));
+}
+
+export { trimStart };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/truncate.d.mts

@@ -0,0 +1,34 @@
+type TruncateOptions = {
+    length?: number;
+    separator?: string | RegExp;
+    omission?: string;
+};
+/**
+ * This regex might more completely detect unicode, but it is slower and this project
+ * desires to mimic the behavior of lodash.
+ */
+/**
+ * Truncates `string` if it's longer than the given maximum string length.
+ * The last characters of the truncated string are replaced with the omission
+ * string which defaults to "...".
+ *
+ * @param {string} [string=''] The string to truncate.
+ * @param {Object} [options={}] The options object.
+ * @param {number} [options.length=30] The maximum string length.
+ * @param {string} [options.omission='...'] The string to indicate text is omitted.
+ * @param {RegExp|string} [options.separator] The separator pattern to truncate to.
+ *
+ * @example
+ * const test = 'hi-diddly-ho there, neighborino';
+ * const truncatedStr1 = truncate(test) // returns 'hi-diddly-ho there, neighbo...'
+ * const truncatedStr2 = truncate(test, { length: 24, separator: ' ' }) // returns 'hi-diddly-ho there,...'
+ * const truncatedStr3 = truncate(test, { length: 24, separator: /,? +/ }) // returns 'hi-diddly-ho there...'
+ * const truncatedStr4 = truncate(test, { omission: ' [...]' }) // returns 'hi-diddly-ho there, neig [...]'
+ * const truncatedStr5 = truncate('ABC', { length: 3 }) // returns 'ABC'
+ * const truncatedStr6 = truncate('ABC', { length: 2 }) // returns '...'
+ * const truncatedStr7 = truncate('¥§✈✉🤓', { length: 5 }) // returns '¥§✈✉🤓'
+ * const truncatedStr8 = truncate('¥§✈✉🤓', { length: 4, omission: '…' }) // returns '¥§✈…'
+ */
+declare function truncate(string?: string, options?: TruncateOptions): string;
+
+export { truncate };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/truncate.d.ts

@@ -0,0 +1,34 @@
+type TruncateOptions = {
+    length?: number;
+    separator?: string | RegExp;
+    omission?: string;
+};
+/**
+ * This regex might more completely detect unicode, but it is slower and this project
+ * desires to mimic the behavior of lodash.
+ */
+/**
+ * Truncates `string` if it's longer than the given maximum string length.
+ * The last characters of the truncated string are replaced with the omission
+ * string which defaults to "...".
+ *
+ * @param {string} [string=''] The string to truncate.
+ * @param {Object} [options={}] The options object.
+ * @param {number} [options.length=30] The maximum string length.
+ * @param {string} [options.omission='...'] The string to indicate text is omitted.
+ * @param {RegExp|string} [options.separator] The separator pattern to truncate to.
+ *
+ * @example
+ * const test = 'hi-diddly-ho there, neighborino';
+ * const truncatedStr1 = truncate(test) // returns 'hi-diddly-ho there, neighbo...'
+ * const truncatedStr2 = truncate(test, { length: 24, separator: ' ' }) // returns 'hi-diddly-ho there,...'
+ * const truncatedStr3 = truncate(test, { length: 24, separator: /,? +/ }) // returns 'hi-diddly-ho there...'
+ * const truncatedStr4 = truncate(test, { omission: ' [...]' }) // returns 'hi-diddly-ho there, neig [...]'
+ * const truncatedStr5 = truncate('ABC', { length: 3 }) // returns 'ABC'
+ * const truncatedStr6 = truncate('ABC', { length: 2 }) // returns '...'
+ * const truncatedStr7 = truncate('¥§✈✉🤓', { length: 5 }) // returns '¥§✈✉🤓'
+ * const truncatedStr8 = truncate('¥§✈✉🤓', { length: 4, omission: '…' }) // returns '¥§✈…'
+ */
+declare function truncate(string?: string, options?: TruncateOptions): string;
+
+export { truncate };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/truncate.js

@@ -0,0 +1,52 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const isObject = require('../predicate/isObject.js');
+
+const regexMultiByte = /[\u200d\ud800-\udfff\u0300-\u036f\ufe20-\ufe2f\u20d0-\u20ff\ufe0e\ufe0f]/;
+function truncate(string, options) {
+    string = string != null ? `${string}` : '';
+    let length = 30;
+    let omission = '...';
+    if (isObject.isObject(options)) {
+        length = parseLength(options.length);
+        omission = 'omission' in options ? `${options.omission}` : '...';
+    }
+    let i = string.length;
+    const lengthOmission = Array.from(omission).length;
+    const lengthBase = Math.max(length - lengthOmission, 0);
+    let strArray = undefined;
+    const unicode = regexMultiByte.test(string);
+    if (unicode) {
+        strArray = Array.from(string);
+        i = strArray.length;
+    }
+    if (length >= i) {
+        return string;
+    }
+    if (i <= lengthOmission) {
+        return omission;
+    }
+    let base = strArray === undefined ? string.slice(0, lengthBase) : strArray?.slice(0, lengthBase).join('');
+    const separator = options?.separator;
+    if (!separator) {
+        base += omission;
+        return base;
+    }
+    const search = separator instanceof RegExp ? separator.source : separator;
+    const flags = 'u' + (separator instanceof RegExp ? separator.flags.replace('u', '') : '');
+    const withoutSeparator = new RegExp(`(?<result>.*(?:(?!${search}).))(?:${search})`, flags).exec(base);
+    return (!withoutSeparator?.groups ? base : withoutSeparator.groups.result) + omission;
+}
+function parseLength(length) {
+    if (length == null) {
+        return 30;
+    }
+    if (length <= 0) {
+        return 0;
+    }
+    return length;
+}
+
+exports.truncate = truncate;

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/truncate.mjs

@@ -0,0 +1,48 @@
+import { isObject } from '../predicate/isObject.mjs';
+
+const regexMultiByte = /[\u200d\ud800-\udfff\u0300-\u036f\ufe20-\ufe2f\u20d0-\u20ff\ufe0e\ufe0f]/;
+function truncate(string, options) {
+    string = string != null ? `${string}` : '';
+    let length = 30;
+    let omission = '...';
+    if (isObject(options)) {
+        length = parseLength(options.length);
+        omission = 'omission' in options ? `${options.omission}` : '...';
+    }
+    let i = string.length;
+    const lengthOmission = Array.from(omission).length;
+    const lengthBase = Math.max(length - lengthOmission, 0);
+    let strArray = undefined;
+    const unicode = regexMultiByte.test(string);
+    if (unicode) {
+        strArray = Array.from(string);
+        i = strArray.length;
+    }
+    if (length >= i) {
+        return string;
+    }
+    if (i <= lengthOmission) {
+        return omission;
+    }
+    let base = strArray === undefined ? string.slice(0, lengthBase) : strArray?.slice(0, lengthBase).join('');
+    const separator = options?.separator;
+    if (!separator) {
+        base += omission;
+        return base;
+    }
+    const search = separator instanceof RegExp ? separator.source : separator;
+    const flags = 'u' + (separator instanceof RegExp ? separator.flags.replace('u', '') : '');
+    const withoutSeparator = new RegExp(`(?<result>.*(?:(?!${search}).))(?:${search})`, flags).exec(base);
+    return (!withoutSeparator?.groups ? base : withoutSeparator.groups.result) + omission;
+}
+function parseLength(length) {
+    if (length == null) {
+        return 30;
+    }
+    if (length <= 0) {
+        return 0;
+    }
+    return length;
+}
+
+export { truncate };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/unescape.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Converts the HTML entities `&`, `<`, `>`, `"`, and `'` in `str` to their corresponding characters.
+ * It is the inverse of `escape`.
+ *
+ * @param {string} str The string to unescape.
+ * @returns {string} Returns the unescaped string.
+ *
+ * @example
+ * unescape('This is a &lt;div&gt; element.'); // returns 'This is a <div> element.'
+ * unescape('This is a &quot;quote&quot;'); // returns 'This is a "quote"'
+ * unescape('This is a &#39;quote&#39;'); // returns 'This is a 'quote''
+ * unescape('This is a &amp; symbol'); // returns 'This is a & symbol'
+ */
+declare function unescape(str?: string): string;
+
+export { unescape };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/unescape.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts the HTML entities `&`, `<`, `>`, `"`, and `'` in `str` to their corresponding characters.
+ * It is the inverse of `escape`.
+ *
+ * @param {string} str The string to unescape.
+ * @returns {string} Returns the unescaped string.
+ *
+ * @example
+ * unescape('This is a &lt;div&gt; element.'); // returns 'This is a <div> element.'
+ * unescape('This is a &quot;quote&quot;'); // returns 'This is a "quote"'
+ * unescape('This is a &#39;quote&#39;'); // returns 'This is a 'quote''
+ * unescape('This is a &amp; symbol'); // returns 'This is a & symbol'
+ */
+declare function unescape(str?: string): string;
+
+export { unescape };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/unescape.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const unescape$1 = require('../../string/unescape.js');
+const toString = require('../util/toString.js');
+
+function unescape(str) {
+    return unescape$1.unescape(toString.toString(str));
+}
+
+exports.unescape = unescape;

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/string/unescape.mjs

@@ -0,0 +1,8 @@
+import { unescape as unescape$1 } from '../../string/unescape.mjs';
+import { toString } from '../util/toString.mjs';
+
+function unescape(str) {
+    return unescape$1(toString(str));
+}
+
+export { unescape };

package/dist/ink-runner/node_modules/es-toolkit/dist/compat/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 | object} 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 };