es-toolkit 1.27.0 → 1.28.0-dev.910

package/dist/function/throttle.d.ts

@@ -12,6 +12,11 @@ interface ThrottleOptions {
      */
     edges?: Array<'leading' | 'trailing'>;
 }
+interface ThrottledFunction<F extends (...args: any[]) => void> {
+    (...args: Parameters<F>): void;
+    cancel: () => void;
+    flush: () => void;
+}
 /**
  * Creates a throttled function that only invokes the provided function at most once
  * per every `throttleMs` milliseconds. Subsequent calls to the throttled function
@@ -38,9 +43,6 @@ interface ThrottleOptions {
  *   throttledFunction(); // Will log 'Function executed'
  * }, 1000);
  */
-declare function throttle<F extends (...args: any[]) => void>(func: F, throttleMs: number, { signal, edges }?: ThrottleOptions): ((...args: Parameters<F>) => void) & {
-    cancel: () => void;
-    flush: () => void;
-};
+declare function throttle<F extends (...args: any[]) => void>(func: F, throttleMs: number, { signal, edges }?: ThrottleOptions): ThrottledFunction<F>;
 
-export { throttle };
+export { type ThrottledFunction, throttle };

package/dist/index.d.mts

@@ -62,7 +62,7 @@ export { ary } from './function/ary.mjs';
 export { before } from './function/before.mjs';
 export { curry } from './function/curry.mjs';
 export { curryRight } from './function/curryRight.mjs';
-export { debounce } from './function/debounce.mjs';
+export { DebouncedFunction, debounce } from './function/debounce.mjs';
 export { flow } from './function/flow.mjs';
 export { flowRight } from './function/flowRight.mjs';
 export { identity } from './function/identity.mjs';
@@ -74,7 +74,7 @@ export { partial } from './function/partial.mjs';
 export { partialRight } from './function/partialRight.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';
-export { throttle } from './function/throttle.mjs';
+export { ThrottledFunction, throttle } from './function/throttle.mjs';
 export { unary } from './function/unary.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
@@ -91,6 +91,7 @@ export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { clone } from './object/clone.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { cloneDeepWith } from './object/cloneDeepWith.mjs';
 export { findKey } from './object/findKey.mjs';
 export { flattenObject } from './object/flattenObject.mjs';
 export { invert } from './object/invert.mjs';
@@ -106,6 +107,7 @@ export { toMerged } from './object/toMerged.mjs';
 export { isArrayBuffer } from './predicate/isArrayBuffer.mjs';
 export { isBlob } from './predicate/isBlob.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
+export { isBuffer } from './predicate/isBuffer.mjs';
 export { isDate } from './predicate/isDate.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isEqualWith } from './predicate/isEqualWith.mjs';

package/dist/index.d.ts

@@ -62,7 +62,7 @@ export { ary } from './function/ary.js';
 export { before } from './function/before.js';
 export { curry } from './function/curry.js';
 export { curryRight } from './function/curryRight.js';
-export { debounce } from './function/debounce.js';
+export { DebouncedFunction, debounce } from './function/debounce.js';
 export { flow } from './function/flow.js';
 export { flowRight } from './function/flowRight.js';
 export { identity } from './function/identity.js';
@@ -74,7 +74,7 @@ export { partial } from './function/partial.js';
 export { partialRight } from './function/partialRight.js';
 export { rest } from './function/rest.js';
 export { spread } from './function/spread.js';
-export { throttle } from './function/throttle.js';
+export { ThrottledFunction, throttle } from './function/throttle.js';
 export { unary } from './function/unary.js';
 export { clamp } from './math/clamp.js';
 export { inRange } from './math/inRange.js';
@@ -91,6 +91,7 @@ export { sum } from './math/sum.js';
 export { sumBy } from './math/sumBy.js';
 export { clone } from './object/clone.js';
 export { cloneDeep } from './object/cloneDeep.js';
+export { cloneDeepWith } from './object/cloneDeepWith.js';
 export { findKey } from './object/findKey.js';
 export { flattenObject } from './object/flattenObject.js';
 export { invert } from './object/invert.js';
@@ -106,6 +107,7 @@ export { toMerged } from './object/toMerged.js';
 export { isArrayBuffer } from './predicate/isArrayBuffer.js';
 export { isBlob } from './predicate/isBlob.js';
 export { isBoolean } from './predicate/isBoolean.js';
+export { isBuffer } from './predicate/isBuffer.js';
 export { isDate } from './predicate/isDate.js';
 export { isEqual } from './predicate/isEqual.js';
 export { isEqualWith } from './predicate/isEqualWith.js';

package/dist/index.js

@@ -11,12 +11,12 @@ const noop = require('./_chunk/noop-2IwLUk.js');
 const rangeRight = require('./_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
-const toMerged = require('./_chunk/toMerged-CPY8Ug.js');
+const toMerged = require('./_chunk/toMerged-AV73JV.js');
 const object_index = require('./object/index.js');
-const isWeakSet = require('./_chunk/isWeakSet-D8h8bS.js');
+const isWeakSet = require('./_chunk/isWeakSet-CvIdTA.js');
 const predicate_index = require('./predicate/index.js');
 const isPlainObject = require('./_chunk/isPlainObject-octpoD.js');
-const upperFirst = require('./_chunk/upperFirst-DK_rTF.js');
+const upperFirst = require('./_chunk/upperFirst-CorAVn.js');
 const string_index = require('./string/index.js');
 const util_index = require('./util/index.js');
 
@@ -118,6 +118,7 @@ exports.round = math_index.round;
 exports.sumBy = math_index.sumBy;
 exports.clone = toMerged.clone;
 exports.cloneDeep = toMerged.cloneDeep;
+exports.cloneDeepWith = toMerged.cloneDeepWith;
 exports.findKey = toMerged.findKey;
 exports.flattenObject = toMerged.flattenObject;
 exports.invert = toMerged.invert;
@@ -132,6 +133,7 @@ exports.omit = object_index.omit;
 exports.pick = object_index.pick;
 exports.isArrayBuffer = isWeakSet.isArrayBuffer;
 exports.isBlob = isWeakSet.isBlob;
+exports.isBuffer = isWeakSet.isBuffer;
 exports.isDate = isWeakSet.isDate;
 exports.isEqual = isWeakSet.isEqual;
 exports.isEqualWith = isWeakSet.isEqualWith;

package/dist/index.mjs

@@ -91,6 +91,7 @@ export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { clone } from './object/clone.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { cloneDeepWith } from './object/cloneDeepWith.mjs';
 export { findKey } from './object/findKey.mjs';
 export { flattenObject } from './object/flattenObject.mjs';
 export { invert } from './object/invert.mjs';
@@ -106,6 +107,7 @@ export { toMerged } from './object/toMerged.mjs';
 export { isArrayBuffer } from './predicate/isArrayBuffer.mjs';
 export { isBlob } from './predicate/isBlob.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
+export { isBuffer } from './predicate/isBuffer.mjs';
 export { isDate } from './predicate/isDate.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isEqualWith } from './predicate/isEqualWith.mjs';

package/dist/object/cloneDeep.mjs

@@ -1,114 +1,7 @@
-import { getSymbols } from '../compat/_internal/getSymbols.mjs';
-import { isPrimitive } from '../predicate/isPrimitive.mjs';
-import { isTypedArray } from '../predicate/isTypedArray.mjs';
+import { cloneDeepWithImpl } from './cloneDeepWith.mjs';
 
 function cloneDeep(obj) {
-    return cloneDeepImpl(obj);
-}
-function cloneDeepImpl(obj, stack = new Map()) {
-    if (isPrimitive(obj)) {
-        return obj;
-    }
-    if (stack.has(obj)) {
-        return stack.get(obj);
-    }
-    if (Array.isArray(obj)) {
-        const result = new Array(obj.length);
-        stack.set(obj, result);
-        for (let i = 0; i < obj.length; i++) {
-            result[i] = cloneDeepImpl(obj[i], stack);
-        }
-        if (Object.hasOwn(obj, 'index')) {
-            result.index = obj.index;
-        }
-        if (Object.hasOwn(obj, 'input')) {
-            result.input = obj.input;
-        }
-        return result;
-    }
-    if (obj instanceof Date) {
-        return new Date(obj.getTime());
-    }
-    if (obj instanceof RegExp) {
-        const result = new RegExp(obj.source, obj.flags);
-        result.lastIndex = obj.lastIndex;
-        return result;
-    }
-    if (obj instanceof Map) {
-        const result = new Map();
-        stack.set(obj, result);
-        for (const [key, value] of obj) {
-            result.set(key, cloneDeepImpl(value, stack));
-        }
-        return result;
-    }
-    if (obj instanceof Set) {
-        const result = new Set();
-        stack.set(obj, result);
-        for (const value of obj) {
-            result.add(cloneDeepImpl(value, stack));
-        }
-        return result;
-    }
-    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(obj)) {
-        return obj.subarray();
-    }
-    if (isTypedArray(obj)) {
-        const result = new (Object.getPrototypeOf(obj).constructor)(obj.length);
-        stack.set(obj, result);
-        for (let i = 0; i < obj.length; i++) {
-            result[i] = cloneDeepImpl(obj[i], stack);
-        }
-        return result;
-    }
-    if (obj instanceof ArrayBuffer || (typeof SharedArrayBuffer !== 'undefined' && obj instanceof SharedArrayBuffer)) {
-        return obj.slice(0);
-    }
-    if (obj instanceof DataView) {
-        const result = new DataView(obj.buffer.slice(0), obj.byteOffset, obj.byteLength);
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (typeof File !== 'undefined' && obj instanceof File) {
-        const result = new File([obj], obj.name, { type: obj.type });
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (obj instanceof Blob) {
-        const result = new Blob([obj], { type: obj.type });
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (obj instanceof Error) {
-        const result = new obj.constructor();
-        stack.set(obj, result);
-        result.message = obj.message;
-        result.name = obj.name;
-        result.stack = obj.stack;
-        result.cause = obj.cause;
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (typeof obj === 'object' && obj !== null) {
-        const result = Object.create(Object.getPrototypeOf(obj));
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    return obj;
-}
-function copyProperties(target, source, stack) {
-    const keys = [...Object.keys(source), ...getSymbols(source)];
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const descriptor = Object.getOwnPropertyDescriptor(target, key);
-        if (descriptor == null || descriptor.writable) {
-            target[key] = cloneDeepImpl(source[key], stack);
-        }
-    }
+    return cloneDeepWithImpl(obj, undefined, obj, new Map(), undefined);
 }
 
-export { cloneDeep, copyProperties };
+export { cloneDeep };

package/dist/object/cloneDeepWith.d.mts

@@ -0,0 +1,38 @@
+/**
+ * Creates a deep clone of the given object using a customizer function.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to clone.
+ * @param {Function} [cloneValue] - A function to customize the cloning process.
+ * @returns {T} - A deep clone of the given object.
+ *
+ * @example
+ * // Clone a primitive value
+ * const num = 29;
+ * const clonedNum = cloneDeepWith(num);
+ * console.log(clonedNum); // 29
+ * console.log(clonedNum === num); // true
+ *
+ * @example
+ * // Clone an object with a customizer
+ * const obj = { a: 1, b: 2 };
+ * const clonedObj = cloneDeepWith(obj, (value) => {
+ *   if (typeof value === 'number') {
+ *     return value * 2; // Double the number
+ *   }
+ * });
+ * console.log(clonedObj); // { a: 2, b: 4 }
+ * console.log(clonedObj === obj); // false
+ *
+ * @example
+ * // Clone an array with a customizer
+ * const arr = [1, 2, 3];
+ * const clonedArr = cloneDeepWith(arr, (value) => {
+ *   return value + 1; // Increment each value
+ * });
+ * console.log(clonedArr); // [2, 3, 4]
+ * console.log(clonedArr === arr); // false
+ */
+declare function cloneDeepWith<T>(obj: T, cloneValue: (value: any, key: PropertyKey | undefined, object: T | undefined, stack: Map<any, any>) => any): T;
+
+export { cloneDeepWith };

package/dist/object/cloneDeepWith.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Creates a deep clone of the given object using a customizer function.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to clone.
+ * @param {Function} [cloneValue] - A function to customize the cloning process.
+ * @returns {T} - A deep clone of the given object.
+ *
+ * @example
+ * // Clone a primitive value
+ * const num = 29;
+ * const clonedNum = cloneDeepWith(num);
+ * console.log(clonedNum); // 29
+ * console.log(clonedNum === num); // true
+ *
+ * @example
+ * // Clone an object with a customizer
+ * const obj = { a: 1, b: 2 };
+ * const clonedObj = cloneDeepWith(obj, (value) => {
+ *   if (typeof value === 'number') {
+ *     return value * 2; // Double the number
+ *   }
+ * });
+ * console.log(clonedObj); // { a: 2, b: 4 }
+ * console.log(clonedObj === obj); // false
+ *
+ * @example
+ * // Clone an array with a customizer
+ * const arr = [1, 2, 3];
+ * const clonedArr = cloneDeepWith(arr, (value) => {
+ *   return value + 1; // Increment each value
+ * });
+ * console.log(clonedArr); // [2, 3, 4]
+ * console.log(clonedArr === arr); // false
+ */
+declare function cloneDeepWith<T>(obj: T, cloneValue: (value: any, key: PropertyKey | undefined, object: T | undefined, stack: Map<any, any>) => any): T;
+
+export { cloneDeepWith };

package/dist/object/cloneDeepWith.mjs

@@ -0,0 +1,121 @@
+import { getSymbols } from '../compat/_internal/getSymbols.mjs';
+import { isPrimitive } from '../predicate/isPrimitive.mjs';
+import { isTypedArray } from '../predicate/isTypedArray.mjs';
+
+function cloneDeepWith(obj, cloneValue) {
+    return cloneDeepWithImpl(obj, undefined, obj, new Map(), cloneValue);
+}
+function cloneDeepWithImpl(valueToClone, keyToClone, objectToClone, stack = new Map(), cloneValue = undefined) {
+    const cloned = cloneValue?.(valueToClone, keyToClone, objectToClone, stack);
+    if (cloned != null) {
+        return cloned;
+    }
+    if (isPrimitive(valueToClone)) {
+        return valueToClone;
+    }
+    if (stack.has(valueToClone)) {
+        return stack.get(valueToClone);
+    }
+    if (Array.isArray(valueToClone)) {
+        const result = new Array(valueToClone.length);
+        stack.set(valueToClone, result);
+        for (let i = 0; i < valueToClone.length; i++) {
+            result[i] = cloneDeepWithImpl(valueToClone[i], i, objectToClone, stack, cloneValue);
+        }
+        if (Object.hasOwn(valueToClone, 'index')) {
+            result.index = valueToClone.index;
+        }
+        if (Object.hasOwn(valueToClone, 'input')) {
+            result.input = valueToClone.input;
+        }
+        return result;
+    }
+    if (valueToClone instanceof Date) {
+        return new Date(valueToClone.getTime());
+    }
+    if (valueToClone instanceof RegExp) {
+        const result = new RegExp(valueToClone.source, valueToClone.flags);
+        result.lastIndex = valueToClone.lastIndex;
+        return result;
+    }
+    if (valueToClone instanceof Map) {
+        const result = new Map();
+        stack.set(valueToClone, result);
+        for (const [key, value] of valueToClone) {
+            result.set(key, cloneDeepWithImpl(value, key, objectToClone, stack, cloneValue));
+        }
+        return result;
+    }
+    if (valueToClone instanceof Set) {
+        const result = new Set();
+        stack.set(valueToClone, result);
+        for (const value of valueToClone) {
+            result.add(cloneDeepWithImpl(value, undefined, objectToClone, stack, cloneValue));
+        }
+        return result;
+    }
+    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(valueToClone)) {
+        return valueToClone.subarray();
+    }
+    if (isTypedArray(valueToClone)) {
+        const result = new (Object.getPrototypeOf(valueToClone).constructor)(valueToClone.length);
+        stack.set(valueToClone, result);
+        for (let i = 0; i < valueToClone.length; i++) {
+            result[i] = cloneDeepWithImpl(valueToClone[i], i, objectToClone, stack, cloneValue);
+        }
+        return result;
+    }
+    if (valueToClone instanceof ArrayBuffer ||
+        (typeof SharedArrayBuffer !== 'undefined' && valueToClone instanceof SharedArrayBuffer)) {
+        return valueToClone.slice(0);
+    }
+    if (valueToClone instanceof DataView) {
+        const result = new DataView(valueToClone.buffer.slice(0), valueToClone.byteOffset, valueToClone.byteLength);
+        stack.set(valueToClone, result);
+        copyProperties(result, valueToClone, objectToClone, stack, cloneValue);
+        return result;
+    }
+    if (typeof File !== 'undefined' && valueToClone instanceof File) {
+        const result = new File([valueToClone], valueToClone.name, {
+            type: valueToClone.type,
+        });
+        stack.set(valueToClone, result);
+        copyProperties(result, valueToClone, objectToClone, stack, cloneValue);
+        return result;
+    }
+    if (valueToClone instanceof Blob) {
+        const result = new Blob([valueToClone], { type: valueToClone.type });
+        stack.set(valueToClone, result);
+        copyProperties(result, valueToClone, objectToClone, stack, cloneValue);
+        return result;
+    }
+    if (valueToClone instanceof Error) {
+        const result = new valueToClone.constructor();
+        stack.set(valueToClone, result);
+        result.message = valueToClone.message;
+        result.name = valueToClone.name;
+        result.stack = valueToClone.stack;
+        result.cause = valueToClone.cause;
+        copyProperties(result, valueToClone, objectToClone, stack, cloneValue);
+        return result;
+    }
+    if (typeof valueToClone === 'object' && valueToClone !== null) {
+        const result = Object.create(Object.getPrototypeOf(valueToClone));
+        stack.set(valueToClone, result);
+        copyProperties(result, valueToClone, objectToClone, stack, cloneValue);
+        return result;
+    }
+    return valueToClone;
+}
+function copyProperties(target, source, objectToClone = target, stack, cloneValue) {
+    const keys = [...Object.keys(source), ...getSymbols(source)];
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        const descriptor = Object.getOwnPropertyDescriptor(target, key);
+        if (descriptor == null || descriptor.writable) {
+            target[key] = cloneDeepWithImpl(source[key], key, objectToClone, stack, cloneValue);
+        }
+    }
+}
+
+export { cloneDeepWith, cloneDeepWithImpl, copyProperties };

package/dist/object/index.d.mts

@@ -1,5 +1,6 @@
 export { clone } from './clone.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
+export { cloneDeepWith } from './cloneDeepWith.mjs';
 export { findKey } from './findKey.mjs';
 export { flattenObject } from './flattenObject.mjs';
 export { invert } from './invert.mjs';

package/dist/object/index.d.ts

@@ -1,5 +1,6 @@
 export { clone } from './clone.js';
 export { cloneDeep } from './cloneDeep.js';
+export { cloneDeepWith } from './cloneDeepWith.js';
 export { findKey } from './findKey.js';
 export { flattenObject } from './flattenObject.js';
 export { invert } from './invert.js';

package/dist/object/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const toMerged = require('../_chunk/toMerged-CPY8Ug.js');
+const toMerged = require('../_chunk/toMerged-AV73JV.js');
 
 function mergeWith(target, source, merge) {
     const sourceKeys = Object.keys(source);
@@ -49,6 +49,7 @@ function pick(obj, keys) {
 
 exports.clone = toMerged.clone;
 exports.cloneDeep = toMerged.cloneDeep;
+exports.cloneDeepWith = toMerged.cloneDeepWith;
 exports.findKey = toMerged.findKey;
 exports.flattenObject = toMerged.flattenObject;
 exports.invert = toMerged.invert;

package/dist/object/index.mjs

@@ -1,5 +1,6 @@
 export { clone } from './clone.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
+export { cloneDeepWith } from './cloneDeepWith.mjs';
 export { findKey } from './findKey.mjs';
 export { flattenObject } from './flattenObject.mjs';
 export { invert } from './invert.mjs';

package/dist/predicate/index.d.mts

@@ -1,6 +1,7 @@
 export { isArrayBuffer } from './isArrayBuffer.mjs';
 export { isBlob } from './isBlob.mjs';
 export { isBoolean } from './isBoolean.mjs';
+export { isBuffer } from './isBuffer.mjs';
 export { isDate } from './isDate.mjs';
 export { isEqual } from './isEqual.mjs';
 export { isEqualWith } from './isEqualWith.mjs';

package/dist/predicate/index.d.ts

@@ -1,6 +1,7 @@
 export { isArrayBuffer } from './isArrayBuffer.js';
 export { isBlob } from './isBlob.js';
 export { isBoolean } from './isBoolean.js';
+export { isBuffer } from './isBuffer.js';
 export { isDate } from './isDate.js';
 export { isEqual } from './isEqual.js';
 export { isEqualWith } from './isEqualWith.js';

package/dist/predicate/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const isWeakSet = require('../_chunk/isWeakSet-D8h8bS.js');
+const isWeakSet = require('../_chunk/isWeakSet-CvIdTA.js');
 const isPlainObject = require('../_chunk/isPlainObject-octpoD.js');
 
 function isBoolean(x) {
@@ -23,6 +23,7 @@ function isSymbol(value) {
 
 exports.isArrayBuffer = isWeakSet.isArrayBuffer;
 exports.isBlob = isWeakSet.isBlob;
+exports.isBuffer = isWeakSet.isBuffer;
 exports.isDate = isWeakSet.isDate;
 exports.isEqual = isWeakSet.isEqual;
 exports.isEqualWith = isWeakSet.isEqualWith;

package/dist/predicate/index.mjs

@@ -1,6 +1,7 @@
 export { isArrayBuffer } from './isArrayBuffer.mjs';
 export { isBlob } from './isBlob.mjs';
 export { isBoolean } from './isBoolean.mjs';
+export { isBuffer } from './isBuffer.mjs';
 export { isDate } from './isDate.mjs';
 export { isEqual } from './isEqual.mjs';
 export { isEqualWith } from './isEqualWith.mjs';

package/dist/predicate/isBuffer.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Checks if the given value is a Buffer instance.
+ *
+ * This function tests whether the provided value is an instance of Buffer.
+ * It returns `true` if the value is a Buffer, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `Buffer`.
+ *
+ * @param {unknown} x - The value to check if it is a Buffer.
+ * @returns {boolean} Returns `true` if `x` is a Buffer, else `false`.
+ *
+ * @example
+ * const buffer = Buffer.from("test");
+ * console.log(isBuffer(buffer)); // true
+ *
+ * const notBuffer = "not a buffer";
+ * console.log(isBuffer(notBuffer)); // false
+ */
+declare function isBuffer(x: unknown): boolean;
+
+export { isBuffer };

package/dist/predicate/isBuffer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Checks if the given value is a Buffer instance.
+ *
+ * This function tests whether the provided value is an instance of Buffer.
+ * It returns `true` if the value is a Buffer, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `Buffer`.
+ *
+ * @param {unknown} x - The value to check if it is a Buffer.
+ * @returns {boolean} Returns `true` if `x` is a Buffer, else `false`.
+ *
+ * @example
+ * const buffer = Buffer.from("test");
+ * console.log(isBuffer(buffer)); // true
+ *
+ * const notBuffer = "not a buffer";
+ * console.log(isBuffer(notBuffer)); // false
+ */
+declare function isBuffer(x: unknown): boolean;
+
+export { isBuffer };

package/dist/predicate/isBuffer.mjs

@@ -0,0 +1,5 @@
+function isBuffer(x) {
+    return typeof Buffer !== 'undefined' && Buffer.isBuffer(x);
+}
+
+export { isBuffer };

package/dist/string/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const upperFirst = require('../_chunk/upperFirst-DK_rTF.js');
+const upperFirst = require('../_chunk/upperFirst-CorAVn.js');
 
 function startCase(str) {
     const words = upperFirst.words(str.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.27.0",
+  "version": "1.28.0-dev.910+66539368",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {