es-toolkit 1.18.0-dev.584 → 1.18.0-dev.585

package/dist/compat/index.d.mts

@@ -161,6 +161,7 @@ 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 { toString } from './string/toString.mjs';
 export { trim } from './string/trim.mjs';
 export { trimStart } from './string/trimStart.mjs';
 export { trimEnd } from './string/trimEnd.mjs';

package/dist/compat/index.d.ts

@@ -161,6 +161,7 @@ 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 { toString } from './string/toString.js';
 export { trim } from './string/trim.js';
 export { trimStart } from './string/trimStart.js';
 export { trimEnd } from './string/trimEnd.js';

package/dist/compat/index.js

@@ -1076,6 +1076,20 @@ function repeat(str, n) {
     return str.repeat(n);
 }
 
+function toString(value) {
+    if (value == null) {
+        return '';
+    }
+    if (Array.isArray(value)) {
+        return value.map(toString).join(',');
+    }
+    const result = String(value);
+    if (result === '0' && Object.is(Number(value), -0)) {
+        return '-0';
+    }
+    return result;
+}
+
 function trim(str, chars, guard) {
     if (str == null) {
         return '';
@@ -1372,6 +1386,7 @@ exports.sortBy = sortBy;
 exports.spread = spread;
 exports.startCase = startCase;
 exports.startsWith = startsWith;
+exports.toString = toString;
 exports.trim = trim;
 exports.trimEnd = trimEnd;
 exports.trimStart = trimStart;

package/dist/compat/index.mjs

@@ -161,6 +161,7 @@ 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 { toString } from './string/toString.mjs';
 export { trim } from './string/trim.mjs';
 export { trimStart } from './string/trimStart.mjs';
 export { trimEnd } from './string/trimEnd.mjs';

package/dist/compat/string/toString.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Converts `value` to a string.
+ *
+ * An empty string is returned for `null` and `undefined` values.
+ * The sign of `-0` is preserved.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {string} Returns the converted string.
+ *
+ * @example
+ * toString(null) // returns ''
+ * toString(undefined) // returns ''
+ * toString(-0) // returns '-0'
+ * toString([1, 2, -0]) // returns '1,2,-0'
+ * toString([Symbol('a'), Symbol('b')]) // returns 'Symbol(a),Symbol(b)'
+ */
+declare function toString(value?: unknown): string;
+
+export { toString };

package/dist/compat/string/toString.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Converts `value` to a string.
+ *
+ * An empty string is returned for `null` and `undefined` values.
+ * The sign of `-0` is preserved.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {string} Returns the converted string.
+ *
+ * @example
+ * toString(null) // returns ''
+ * toString(undefined) // returns ''
+ * toString(-0) // returns '-0'
+ * toString([1, 2, -0]) // returns '1,2,-0'
+ * toString([Symbol('a'), Symbol('b')]) // returns 'Symbol(a),Symbol(b)'
+ */
+declare function toString(value?: unknown): string;
+
+export { toString };

package/dist/compat/string/toString.mjs

@@ -0,0 +1,15 @@
+function toString(value) {
+    if (value == null) {
+        return '';
+    }
+    if (Array.isArray(value)) {
+        return value.map(toString).join(',');
+    }
+    const result = String(value);
+    if (result === '0' && Object.is(Number(value), -0)) {
+        return '-0';
+    }
+    return result;
+}
+
+export { toString };

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.584+31769810",
+  "version": "1.18.0-dev.585+993b77f9",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {