es-toolkit 1.13.1 → 1.14.0-dev.399

package/dist/function/index.js

@@ -1,103 +1,108 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+'use strict';
 
-// src/function/index.ts
-var function_exports = {};
-__export(function_exports, {
-  debounce: () => debounce,
-  negate: () => negate,
-  noop: () => noop,
-  once: () => once,
-  throttle: () => throttle
-});
-module.exports = __toCommonJS(function_exports);
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-// src/function/debounce.ts
-function debounce(func, debounceMs, { signal } = {}) {
-  let timeoutId = null;
-  const debounced = function(...args) {
-    if (timeoutId !== null) {
-      clearTimeout(timeoutId);
+const before = (n, func) => {
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error('n must be a non-negative integer.');
     }
-    if (signal == null ? void 0 : signal.aborted) {
-      return;
-    }
-    timeoutId = setTimeout(() => {
-      func(...args);
-      timeoutId = null;
-    }, debounceMs);
-  };
-  const onAbort = function() {
-    debounced.cancel();
-  };
-  debounced.cancel = function() {
-    if (timeoutId !== null) {
-      clearTimeout(timeoutId);
-      timeoutId = null;
+    let counter = 0;
+    return ((...args) => {
+        if (++counter < n) {
+            return func(...args);
+        }
+        return undefined;
+    });
+};
+
+const after = (n, func) => {
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error(`n must be a non-negative integer.`);
     }
-  };
-  signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
-  return debounced;
-}
+    let counter = 0;
+    return ((...args) => {
+        if (++counter >= n) {
+            return func(...args);
+        }
+        return undefined;
+    });
+};
 
-// src/function/noop.ts
-function noop() {
+function debounce(func, debounceMs, { signal } = {}) {
+    let timeoutId = null;
+    const debounced = function (...args) {
+        if (timeoutId !== null) {
+            clearTimeout(timeoutId);
+        }
+        if (signal?.aborted) {
+            return;
+        }
+        timeoutId = setTimeout(() => {
+            func(...args);
+            timeoutId = null;
+        }, debounceMs);
+    };
+    const onAbort = function () {
+        debounced.cancel();
+    };
+    debounced.cancel = function () {
+        if (timeoutId !== null) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+    };
+    signal?.addEventListener('abort', onAbort, { once: true });
+    return debounced;
 }
 
-// src/function/once.ts
+function noop() { }
+
 function once(func) {
-  let called = false;
-  let cache;
-  return function() {
-    if (called) {
-      return cache;
-    }
-    const result = func();
-    called = true;
-    cache = result;
-    return result;
-  };
+    let called = false;
+    let cache;
+    return function () {
+        if (called) {
+            return cache;
+        }
+        const result = func();
+        called = true;
+        cache = result;
+        return result;
+    };
 }
 
-// src/function/throttle.ts
 function throttle(func, throttleMs) {
-  let lastCallTime;
-  const throttledFunction = function(...args) {
-    const now = Date.now();
-    if (lastCallTime == null || now - lastCallTime >= throttleMs) {
-      lastCallTime = now;
-      func(...args);
-    }
-  };
-  return throttledFunction;
+    let lastCallTime;
+    const throttledFunction = function (...args) {
+        const now = Date.now();
+        if (lastCallTime == null || now - lastCallTime >= throttleMs) {
+            lastCallTime = now;
+            func(...args);
+        }
+    };
+    return throttledFunction;
 }
 
-// src/function/negate.ts
 function negate(func) {
-  return (...args) => !func(...args);
+    return ((...args) => !func(...args));
+}
+
+function ary(func, n) {
+    return function (...args) {
+        return func.apply(this, args.slice(0, n));
+    };
+}
+
+function unary(func) {
+    return ary(func, 1);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  debounce,
-  negate,
-  noop,
-  once,
-  throttle
-});
-//# sourceMappingURL=index.js.map
+
+exports.after = after;
+exports.ary = ary;
+exports.before = before;
+exports.debounce = debounce;
+exports.negate = negate;
+exports.noop = noop;
+exports.once = once;
+exports.throttle = throttle;
+exports.unary = unary;

package/dist/function/index.mjs

@@ -1,25 +1,9 @@
-import "../chunk-236H5JZJ.mjs";
-import {
-  negate
-} from "../chunk-BOOQBJN2.mjs";
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
-import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
-import {
-  debounce
-} from "../chunk-3IP4JVLL.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  debounce,
-  negate,
-  noop,
-  once,
-  throttle
-};
-//# sourceMappingURL=index.mjs.map
+export { before } from './before.mjs';
+export { after } from './after.mjs';
+export { debounce } from './debounce.mjs';
+export { noop } from './noop.mjs';
+export { once } from './once.mjs';
+export { throttle } from './throttle.mjs';
+export { negate } from './negate.mjs';
+export { ary } from './ary.mjs';
+export { unary } from './unary.mjs';

package/dist/function/negate.mjs

@@ -1,8 +1,5 @@
-import {
-  negate
-} from "../chunk-BOOQBJN2.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  negate
-};
-//# sourceMappingURL=negate.mjs.map
+function negate(func) {
+    return ((...args) => !func(...args));
+}
+
+export { negate };

package/dist/function/noop.mjs

@@ -1,8 +1,3 @@
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  noop
-};
-//# sourceMappingURL=noop.mjs.map
+function noop() { }
+
+export { noop };

package/dist/function/once.mjs

@@ -1,8 +1,15 @@
-import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  once
-};
-//# sourceMappingURL=once.mjs.map
+function once(func) {
+    let called = false;
+    let cache;
+    return function () {
+        if (called) {
+            return cache;
+        }
+        const result = func();
+        called = true;
+        cache = result;
+        return result;
+    };
+}
+
+export { once };

package/dist/function/throttle.mjs

@@ -1,8 +1,13 @@
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  throttle
-};
-//# sourceMappingURL=throttle.mjs.map
+function throttle(func, throttleMs) {
+    let lastCallTime;
+    const throttledFunction = function (...args) {
+        const now = Date.now();
+        if (lastCallTime == null || now - lastCallTime >= throttleMs) {
+            lastCallTime = now;
+            func(...args);
+        }
+    };
+    return throttledFunction;
+}
+
+export { throttle };

package/dist/function/unary.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Creates a function that accepts up to one argument, ignoring any additional arguments.
+ *
+ * @template F - The type of the function.
+ * @param {F} func - The function to cap arguments for.
+ * @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+ */
+declare function unary<F extends (...args: any[]) => any>(func: F): ((...args: any[]) => ReturnType<F>);
+
+export { unary };

package/dist/function/unary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Creates a function that accepts up to one argument, ignoring any additional arguments.
+ *
+ * @template F - The type of the function.
+ * @param {F} func - The function to cap arguments for.
+ * @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+ */
+declare function unary<F extends (...args: any[]) => any>(func: F): ((...args: any[]) => ReturnType<F>);
+
+export { unary };

package/dist/function/unary.mjs

@@ -0,0 +1,7 @@
+import { ary } from './ary.mjs';
+
+function unary(func) {
+    return ary(func, 1);
+}
+
+export { unary };

package/dist/index.d.mts

@@ -45,17 +45,22 @@ export { zipObject } from './array/zipObject.mjs';
 export { zipWith } from './array/zipWith.mjs';
 export { without } from './array/without.mjs';
 export { head } from './array/head.mjs';
+export { isSubset } from './array/isSubset.mjs';
 export { tail } from './array/tail.mjs';
 export { toFilled } from './array/toFilled.mjs';
 export { last } from './array/last.mjs';
 export { initial } from './array/initial.mjs';
 export { AbortError } from './error/AbortError.mjs';
 export { TimeoutError } from './error/TimeoutError.mjs';
+export { before } from './function/before.mjs';
+export { after } from './function/after.mjs';
 export { debounce } from './function/debounce.mjs';
 export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';
 export { throttle } from './function/throttle.mjs';
 export { negate } from './function/negate.mjs';
+export { ary } from './function/ary.mjs';
+export { unary } from './function/unary.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
 export { mean } from './math/mean.mjs';
@@ -73,6 +78,9 @@ export { pickBy } from './object/pickBy.mjs';
 export { invert } from './object/invert.mjs';
 export { clone } from './object/clone.mjs';
 export { flattenObject } from './object/flattenObject.mjs';
+export { mapKeys } from './object/mapKeys.mjs';
+export { mapValues } from './object/mapValues.mjs';
+export { cloneDeep } from './object/cloneDeep.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isNil } from './predicate/isNil.mjs';
 export { isNotNil } from './predicate/isNotNil.mjs';
@@ -80,6 +88,10 @@ export { isNull } from './predicate/isNull.mjs';
 export { isUndefined } from './predicate/isUndefined.mjs';
 export { isLength } from './predicate/isLength.mjs';
 export { isPlainObject } from './predicate/isPlainObject.mjs';
+export { isFunction } from './predicate/isFunction.mjs';
+export { isTypedArray } from './predicate/isTypedArray.mjs';
+export { isPrimitive } from './predicate/isPrimitive.mjs';
+export { isBoolean } from './predicate/isBoolean.mjs';
 export { delay } from './promise/delay.mjs';
 export { withTimeout } from './promise/withTimeout.mjs';
 export { camelCase } from './string/camelCase.mjs';

package/dist/index.d.ts

@@ -45,17 +45,22 @@ export { zipObject } from './array/zipObject.js';
 export { zipWith } from './array/zipWith.js';
 export { without } from './array/without.js';
 export { head } from './array/head.js';
+export { isSubset } from './array/isSubset.js';
 export { tail } from './array/tail.js';
 export { toFilled } from './array/toFilled.js';
 export { last } from './array/last.js';
 export { initial } from './array/initial.js';
 export { AbortError } from './error/AbortError.js';
 export { TimeoutError } from './error/TimeoutError.js';
+export { before } from './function/before.js';
+export { after } from './function/after.js';
 export { debounce } from './function/debounce.js';
 export { noop } from './function/noop.js';
 export { once } from './function/once.js';
 export { throttle } from './function/throttle.js';
 export { negate } from './function/negate.js';
+export { ary } from './function/ary.js';
+export { unary } from './function/unary.js';
 export { clamp } from './math/clamp.js';
 export { inRange } from './math/inRange.js';
 export { mean } from './math/mean.js';
@@ -73,6 +78,9 @@ export { pickBy } from './object/pickBy.js';
 export { invert } from './object/invert.js';
 export { clone } from './object/clone.js';
 export { flattenObject } from './object/flattenObject.js';
+export { mapKeys } from './object/mapKeys.js';
+export { mapValues } from './object/mapValues.js';
+export { cloneDeep } from './object/cloneDeep.js';
 export { isEqual } from './predicate/isEqual.js';
 export { isNil } from './predicate/isNil.js';
 export { isNotNil } from './predicate/isNotNil.js';
@@ -80,6 +88,10 @@ export { isNull } from './predicate/isNull.js';
 export { isUndefined } from './predicate/isUndefined.js';
 export { isLength } from './predicate/isLength.js';
 export { isPlainObject } from './predicate/isPlainObject.js';
+export { isFunction } from './predicate/isFunction.js';
+export { isTypedArray } from './predicate/isTypedArray.js';
+export { isPrimitive } from './predicate/isPrimitive.js';
+export { isBoolean } from './predicate/isBoolean.js';
 export { delay } from './promise/delay.js';
 export { withTimeout } from './promise/withTimeout.js';
 export { camelCase } from './string/camelCase.js';