es-toolkit 1.17.0-dev.549 → 1.17.0-dev.551

package/dist/compat/array/castArray.d.mts

@@ -0,0 +1,29 @@
+/**
+ * Casts value as an array if it's not one.
+ *
+ * @template T The type of elements in the array.
+ * @param {T | readonly T[]} value The value to be cast to an array.
+ * @returns {T[]} An array containing the input value if it wasn't an array, or the original array if it was.
+ *
+ * @example
+ * const arr1 = castArray(1);
+ * // Returns: [1]
+ *
+ * const arr2 = castArray([1]);
+ * // Returns: [1]
+ *
+ * const arr3 = castArray({'a': 1});
+ * // Returns: [{'a': 1}]
+ *
+ * const arr4 =  castArray(null);
+ * // Returns: [null]
+ *
+ * const arr5 = castArray(undefined);
+ * // Returns: [undefined]
+ *
+ * const arr6 = castArray();
+ * // Returns: []
+ */
+declare function castArray<T>(value?: T | readonly T[]): T[];
+
+export { castArray };

package/dist/compat/array/castArray.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Casts value as an array if it's not one.
+ *
+ * @template T The type of elements in the array.
+ * @param {T | readonly T[]} value The value to be cast to an array.
+ * @returns {T[]} An array containing the input value if it wasn't an array, or the original array if it was.
+ *
+ * @example
+ * const arr1 = castArray(1);
+ * // Returns: [1]
+ *
+ * const arr2 = castArray([1]);
+ * // Returns: [1]
+ *
+ * const arr3 = castArray({'a': 1});
+ * // Returns: [{'a': 1}]
+ *
+ * const arr4 =  castArray(null);
+ * // Returns: [null]
+ *
+ * const arr5 = castArray(undefined);
+ * // Returns: [undefined]
+ *
+ * const arr6 = castArray();
+ * // Returns: []
+ */
+declare function castArray<T>(value?: T | readonly T[]): T[];
+
+export { castArray };

package/dist/compat/array/castArray.mjs

@@ -0,0 +1,8 @@
+function castArray(value) {
+    if (arguments.length === 0) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+
+export { castArray };

package/dist/compat/index.d.mts

@@ -105,6 +105,7 @@ export { escape } from '../string/escape.mjs';
 export { escapeRegExp } from '../string/escapeRegExp.mjs';
 export { unescape } from '../string/unescape.mjs';
 export { pad } from '../string/pad.mjs';
+export { castArray } from './array/castArray.mjs';
 export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';

package/dist/compat/index.d.ts

@@ -105,6 +105,7 @@ export { escape } from '../string/escape.js';
 export { escapeRegExp } from '../string/escapeRegExp.js';
 export { unescape } from '../string/unescape.js';
 export { pad } from '../string/pad.js';
+export { castArray } from './array/castArray.js';
 export { chunk } from './array/chunk.js';
 export { concat } from './array/concat.js';
 export { difference } from './array/difference.js';

package/dist/compat/index.js

@@ -12,6 +12,13 @@ const isWeakSet$1 = require('../_chunk/isWeakSet-CogETi.js');
 const isTypedArray$1 = require('../_chunk/isTypedArray-Dsrnb1.js');
 const string_index = require('../string/index.js');
 
+function castArray(value) {
+    if (arguments.length === 0) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+
 function chunk(arr, size = 1) {
     size = Math.max(Math.floor(size), 0);
     if (size === 0) {
@@ -1094,6 +1101,7 @@ exports.ary = ary;
 exports.attempt = attempt;
 exports.bind = bind;
 exports.bindKey = bindKey;
+exports.castArray = castArray;
 exports.chunk = chunk;
 exports.concat = concat;
 exports.conforms = conforms;

package/dist/compat/index.mjs

@@ -106,6 +106,7 @@ export { escape } from '../string/escape.mjs';
 export { escapeRegExp } from '../string/escapeRegExp.mjs';
 export { unescape } from '../string/unescape.mjs';
 export { pad } from '../string/pad.mjs';
+export { castArray } from './array/castArray.mjs';
 export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';

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.17.0-dev.549+22b8a800",
+  "version": "1.17.0-dev.551+887aa4d4",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {