rattail 0.0.3 → 0.0.5

package/README.md

@@ -8,6 +8,13 @@
     <a href="https://rattail.pages.dev">Documentation</a> |
     <a href="https://github.com/varletjs/rattail/blob/main/README.zh-CN.md">中文介绍</a>
   </p>
+  <p>
+    <img src="https://img.shields.io/npm/v/rattail?style=flat-square" alt="version">
+    <img src="https://img.shields.io/github/stars/varletjs/rattail" alt="stars">
+    <img src="https://img.shields.io/npm/l/rattail.svg" alt="license">
+    <img src="https://img.shields.io/codecov/c/github/varletjs/rattail" alt="coverage">
+    <img src="https://github.com/varletjs/varlet/workflows/CI/badge.svg" alt="ci">
+  </p>
 </div>
 
 ---
@@ -17,6 +24,7 @@
 - 🛠️ &nbsp; Provide utilities frequently used in daily development
 - 🛠️ &nbsp; Utilities implementation is very lightweight
 - 🛠️ &nbsp; Written based on ts, providing complete ts types
+- 💪 &nbsp; Make sure more than 90% unit test coverage, providing stability assurance
 
 ### Installation
 

package/README.zh-CN.md

@@ -8,6 +8,13 @@
     <a href="https://rattail.pages.dev/zh">文档</a> |
     <a href="https://github.com/varletjs/rattail/blob/main/README.md">ENGLISH README</a>
   </p>
+  <p>
+    <img src="https://img.shields.io/npm/v/rattail?style=flat-square" alt="version">
+    <img src="https://img.shields.io/github/stars/varletjs/rattail" alt="stars">
+    <img src="https://img.shields.io/npm/l/rattail.svg" alt="license">
+    <img src="https://img.shields.io/codecov/c/github/varletjs/rattail" alt="coverage">
+    <img src="https://github.com/varletjs/varlet/workflows/CI/badge.svg" alt="ci">
+  </p>
 </div>
 
 ---
@@ -17,6 +24,7 @@
 - 🛠️ &nbsp; 提供日常开发中经常使用的实用工具
 - 🛠️ &nbsp; 工具实现非常轻量
 - 🛠️ &nbsp; 使用 ts 编写，提供完善的类型支持
+- 💪 &nbsp; 确保 90% 以上单元测试覆盖率，提供稳定性保证
 
 ### 安装
 

package/lib/index.cjs

@@ -42,13 +42,15 @@ __export(src_exports, {
   call: () => call,
   camelize: () => camelize,
   cancelAnimationFrame: () => cancelAnimationFrame,
-  capitalizeFirstLetter: () => capitalizeFirstLetter,
   clamp: () => clamp,
   clampArrayRange: () => clampArrayRange,
   classes: () => classes,
+  cloneDeep: () => cloneDeep,
+  cloneDeepWith: () => cloneDeepWith,
   createNamespaceFn: () => createNamespaceFn,
   createStorage: () => createStorage,
   debounce: () => debounce,
+  delay: () => delay,
   doubleRaf: () => doubleRaf,
   find: () => find,
   genNumberKey: () => genNumberKey,
@@ -65,7 +67,9 @@ __export(src_exports, {
   inMobile: () => inMobile,
   inViewport: () => inViewport,
   isArray: () => isArray,
+  isArrayBuffer: () => isArrayBuffer,
   isBoolean: () => isBoolean,
+  isDataView: () => isDataView,
   isDate: () => isDate,
   isEmpty: () => isEmpty,
   isFunction: () => isFunction,
@@ -82,10 +86,19 @@ __export(src_exports, {
   isString: () => isString,
   isSymbol: () => isSymbol,
   isTruthy: () => isTruthy,
+  isTypedArray: () => isTypedArray,
+  isWeakMap: () => isWeakMap,
+  isWeakSet: () => isWeakSet,
   isWindow: () => isWindow,
   kebabCase: () => kebabCase,
   localStorage: () => localStorage,
+  lowerFirst: () => lowerFirst,
+  maxBy: () => maxBy,
+  mean: () => mean,
+  meanBy: () => meanBy,
+  merge: () => merge,
   mergeWith: () => mergeWith,
+  minBy: () => minBy,
   normalizeToArray: () => normalizeToArray,
   objectToString: () => objectToString,
   pascalCase: () => pascalCase,
@@ -97,6 +110,7 @@ __export(src_exports, {
   removeArrayEmpty: () => removeArrayEmpty,
   removeItem: () => removeItem,
   requestAnimationFrame: () => requestAnimationFrame,
+  sample: () => sample,
   sessionStorage: () => sessionStorage,
   shuffle: () => shuffle,
   slash: () => slash,
@@ -104,6 +118,7 @@ __export(src_exports, {
   sumBy: () => sumBy,
   supportTouch: () => supportTouch,
   throttle: () => throttle,
+  times: () => times,
   toArrayBuffer: () => toArrayBuffer,
   toDataURL: () => toDataURL,
   toNumber: () => toNumber,
@@ -113,7 +128,8 @@ __export(src_exports, {
   toggleItem: () => toggleItem,
   tryParseJSON: () => tryParseJSON,
   uniq: () => uniq,
-  uniqBy: () => uniqBy
+  uniqBy: () => uniqBy,
+  upperFirst: () => upperFirst
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -147,16 +163,43 @@ function isPromise(val) {
   return isObject(val) && isFunction(val.then) && isFunction(val.catch);
 }
 function isMap(val) {
-  return toTypeString(val) === "[object Map]";
+  return toRawType(val) === "Map";
 }
 function isSet(val) {
-  return toTypeString(val) === "[object Set]";
+  return toRawType(val) === "Set";
 }
 function isDate(val) {
-  return toTypeString(val) === "[object Date]";
+  return toRawType(val) === "Date";
 }
 function isRegExp(val) {
-  return toTypeString(val) === "[object RegExp]";
+  return toRawType(val) === "RegExp";
+}
+function isWeakMap(val) {
+  return toRawType(val) === "WeakMap";
+}
+function isWeakSet(val) {
+  return toRawType(val) === "WeakSet";
+}
+function isArrayBuffer(val) {
+  return toRawType(val) === "ArrayBuffer";
+}
+function isTypedArray(val) {
+  return [
+    "Int8Array",
+    "Uint8Array",
+    "Uint8ClampedArray",
+    "Int16Array",
+    "Uint16Array",
+    "Int32Array",
+    "Uint32Array",
+    "Float32Array",
+    "Float64Array",
+    "BigInt64Array",
+    "BigUint64Array"
+  ].includes(toRawType(val));
+}
+function isDataView(val) {
+  return toRawType(val) === "DataView";
 }
 function toRawType(value) {
   return toTypeString(value).slice(8, -1);
@@ -264,12 +307,6 @@ function shuffle(arr) {
   }
   return arr;
 }
-function sum(arr) {
-  return arr.reduce((ret, val) => ret + val, 0);
-}
-function sumBy(arr, fn) {
-  return arr.reduce((ret, val) => ret + fn(val), 0);
-}
 
 // src/string.ts
 function pascalCase(s) {
@@ -294,9 +331,12 @@ var key = 0;
 function genStringKey() {
   return `generated-key-${key++}`;
 }
-function capitalizeFirstLetter(s) {
+function upperFirst(s) {
   return s.charAt(0).toUpperCase() + s.slice(1);
 }
+function lowerFirst(s) {
+  return s.charAt(0).toLowerCase() + s.slice(1);
+}
 
 // src/element.ts
 function requestAnimationFrame(fn) {
@@ -422,7 +462,7 @@ function createNamespaceFn(namespace) {
 // src/function.ts
 function NOOP() {
 }
-function debounce(fn, delay = 0) {
+function debounce(fn, delay2 = 0) {
   let timer;
   return function(...args) {
     if (timer) {
@@ -430,14 +470,14 @@ function debounce(fn, delay = 0) {
     }
     timer = setTimeout(() => {
       fn.apply(this, args);
-    }, delay);
+    }, delay2);
   };
 }
-function throttle(fn, delay = 200) {
+function throttle(fn, delay2 = 200) {
   let timer;
   let start = 0;
   return function loop(...args) {
-    const now = Date.now();
+    const now = performance.now();
     const elapsed = now - start;
     if (!start) {
       start = now;
@@ -445,13 +485,13 @@ function throttle(fn, delay = 200) {
     if (timer) {
       clearTimeout(timer);
     }
-    if (elapsed >= delay) {
+    if (elapsed >= delay2) {
       fn.apply(this, args);
       start = now;
     } else {
       timer = setTimeout(() => {
         loop.apply(this, args);
-      }, delay - elapsed);
+      }, delay2 - elapsed);
     }
   };
 }
@@ -492,15 +532,24 @@ function genNumberKey() {
 function randomNumber(min = 0, max = 100) {
   return Math.floor(Math.random() * (max - min + 1)) + min;
 }
+function times(num, fn) {
+  return Array.from({ length: num }, (_, index) => fn(index));
+}
+function delay(time) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, time);
+  });
+}
 
 // src/collection.ts
-function mergeWith(object, source, callback) {
+var import_types = require("util/types");
+function mergeWith(object, source, fn) {
   function baseMerge(target, src) {
     for (const key3 in src) {
       if (hasOwn(src, key3)) {
         const srcValue = src[key3];
         const targetValue = target[key3];
-        const customResult = callback == null ? void 0 : callback(targetValue, srcValue, key3, object, source);
+        const customResult = fn(targetValue, srcValue, key3, object, source);
         if (customResult !== void 0) {
           target[key3] = customResult;
         } else if (isObject(srcValue)) {
@@ -518,6 +567,92 @@ function mergeWith(object, source, callback) {
   }
   return baseMerge(object, source);
 }
+function merge(object, source) {
+  return mergeWith(object, source, () => void 0);
+}
+function cloneDeep(value) {
+  return cloneDeepWith(value, () => void 0);
+}
+function cloneDeepWith(value, fn) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  function baseCloneDeep(value2, cache2) {
+    const customResult = fn(value2);
+    if (customResult !== void 0) {
+      return customResult;
+    }
+    if (!isObject(value2)) {
+      return value2;
+    }
+    if (cache2.has(value2)) {
+      return cache2.get(value2);
+    }
+    if (isDate(value2)) {
+      return new Date(value2);
+    }
+    if ((0, import_types.isRegExp)(value2)) {
+      return new RegExp(value2);
+    }
+    if (isMap(value2)) {
+      const result = /* @__PURE__ */ new Map();
+      cache2.set(value2, result);
+      value2.forEach((val, key3) => {
+        result.set(baseCloneDeep(key3, cache2), baseCloneDeep(val, cache2));
+      });
+      return result;
+    }
+    if (isSet(value2)) {
+      const result = /* @__PURE__ */ new Set();
+      cache2.set(value2, result);
+      value2.forEach((val) => {
+        result.add(baseCloneDeep(val, cache2));
+      });
+      return result;
+    }
+    if (toRawType(value2) === "String" || toRawType(value2) === "Number" || toRawType(value2) === "Boolean") {
+      return newConstructor(value2, value2.valueOf());
+    }
+    if ((0, import_types.isWeakMap)(value2) || isWeakSet(value2)) {
+      return {};
+    }
+    if ((0, import_types.isTypedArray)(value2)) {
+      return newConstructor(value2, baseCloneArrayBuffer(value2.buffer), value2.byteOffset, value2.length);
+    }
+    if ((0, import_types.isDataView)(value2)) {
+      return newConstructor(value2, baseCloneArrayBuffer(value2.buffer), value2.byteOffset, value2.byteLength);
+    }
+    if ((0, import_types.isArrayBuffer)(value2)) {
+      return baseCloneArrayBuffer(value2);
+    }
+    if (isArray(value2)) {
+      const result = [];
+      cache2.set(value2, result);
+      value2.forEach((value3, index) => {
+        result[index] = baseCloneDeep(value3, cache2);
+      });
+      return result;
+    }
+    if (isPlainObject(value2)) {
+      const result = Object.create(Reflect.getPrototypeOf(value2));
+      cache2.set(value2, result);
+      for (const key3 in value2) {
+        if (hasOwn(value2, key3)) {
+          result[key3] = baseCloneDeep(value2[key3], cache2);
+        }
+      }
+      return result;
+    }
+    return value2;
+  }
+  function baseCloneArrayBuffer(value2) {
+    const result = new ArrayBuffer(value2.byteLength);
+    new Uint8Array(result).set(new Uint8Array(value2));
+    return result;
+  }
+  function newConstructor(value2, ...args) {
+    return new value2.constructor(...args);
+  }
+  return baseCloneDeep(value, cache);
+}
 
 // src/json.ts
 function tryParseJSON(json) {
@@ -587,6 +722,38 @@ function createStorage(storage) {
 }
 var sessionStorage = createStorage(globalThis.sessionStorage);
 var localStorage = createStorage(globalThis.localStorage);
+
+// src/math.ts
+function sum(arr) {
+  return arr.reduce((ret, val) => ret + val, 0);
+}
+function sumBy(arr, fn) {
+  return arr.reduce((ret, val) => ret + fn(val), 0);
+}
+function minBy(arr, fn) {
+  if (!arr.length) {
+    return;
+  }
+  return arr.reduce((result, item) => fn(result) < fn(item) ? result : item, arr[0]);
+}
+function maxBy(arr, fn) {
+  if (!arr.length) {
+    return;
+  }
+  return arr.reduce((result, item) => fn(result) > fn(item) ? result : item, arr[0]);
+}
+function mean(arr) {
+  return sum(arr) / arr.length;
+}
+function meanBy(arr, fn) {
+  return sumBy(arr, fn) / arr.length;
+}
+function sample(arr) {
+  if (!arr.length) {
+    return;
+  }
+  return arr[randomNumber(0, arr.length - 1)];
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   NOOP,
@@ -594,13 +761,15 @@ var localStorage = createStorage(globalThis.localStorage);
   call,
   camelize,
   cancelAnimationFrame,
-  capitalizeFirstLetter,
   clamp,
   clampArrayRange,
   classes,
+  cloneDeep,
+  cloneDeepWith,
   createNamespaceFn,
   createStorage,
   debounce,
+  delay,
   doubleRaf,
   find,
   genNumberKey,
@@ -617,7 +786,9 @@ var localStorage = createStorage(globalThis.localStorage);
   inMobile,
   inViewport,
   isArray,
+  isArrayBuffer,
   isBoolean,
+  isDataView,
   isDate,
   isEmpty,
   isFunction,
@@ -634,10 +805,19 @@ var localStorage = createStorage(globalThis.localStorage);
   isString,
   isSymbol,
   isTruthy,
+  isTypedArray,
+  isWeakMap,
+  isWeakSet,
   isWindow,
   kebabCase,
   localStorage,
+  lowerFirst,
+  maxBy,
+  mean,
+  meanBy,
+  merge,
   mergeWith,
+  minBy,
   normalizeToArray,
   objectToString,
   pascalCase,
@@ -649,6 +829,7 @@ var localStorage = createStorage(globalThis.localStorage);
   removeArrayEmpty,
   removeItem,
   requestAnimationFrame,
+  sample,
   sessionStorage,
   shuffle,
   slash,
@@ -656,6 +837,7 @@ var localStorage = createStorage(globalThis.localStorage);
   sumBy,
   supportTouch,
   throttle,
+  times,
   toArrayBuffer,
   toDataURL,
   toNumber,
@@ -665,5 +847,6 @@ var localStorage = createStorage(globalThis.localStorage);
   toggleItem,
   tryParseJSON,
   uniq,
-  uniqBy
+  uniqBy,
+  upperFirst
 });

package/lib/index.d.cts

@@ -8,8 +8,6 @@ declare const removeArrayEmpty: <T>(arr: Array<T | null | undefined | "">) => T[
 declare function find<T>(arr: Array<T>, fn: (item: T, index: number, array: Array<T>) => any, from?: 'start' | 'end'): [T, number] | [null, -1];
 declare function at<T>(arr: T[], index: number): T | undefined;
 declare function shuffle<T>(arr: T[]): T[];
-declare function sum(arr: number[]): number;
-declare function sumBy<T>(arr: T[], fn: (val: T) => number): number;
 
 declare function requestAnimationFrame(fn: FrameRequestCallback): number;
 declare function cancelAnimationFrame(handle: number): void;
@@ -34,8 +32,8 @@ declare function createNamespaceFn<N extends string>(namespace: N): <C extends s
 };
 
 declare function NOOP(): void;
-declare function debounce(fn: any, delay?: number): (this: unknown, ...args: any[]) => void;
-declare function throttle(fn: any, delay?: number): () => void;
+declare function debounce<F extends (...args: any[]) => any>(fn: F, delay?: number): (this: unknown, ...args: Parameters<F>) => void;
+declare function throttle<F extends (...args: any[]) => any>(fn: F, delay?: number): (this: unknown, ...args: Parameters<F>) => void;
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
 declare const objectToString: typeof Object.prototype.toString;
@@ -52,6 +50,11 @@ declare function isMap(val: unknown): val is Map<any, any>;
 declare function isSet(val: unknown): val is Set<any>;
 declare function isDate(val: unknown): val is Date;
 declare function isRegExp(val: unknown): val is RegExp;
+declare function isWeakMap(val: unknown): val is WeakMap<any, any>;
+declare function isWeakSet(val: unknown): val is WeakSet<any>;
+declare function isArrayBuffer(val: unknown): val is ArrayBuffer;
+declare function isTypedArray(val: unknown): boolean;
+declare function isDataView(val: unknown): val is DataView;
 declare function toRawType(value: unknown): string;
 declare function isFunction(val: unknown): val is Function;
 declare function isArray(val: unknown): val is Array<any>;
@@ -71,15 +74,21 @@ declare function clamp(num: number, min: number, max: number): number;
 declare function clampArrayRange(index: number, arr: Array<unknown>): number;
 declare function genNumberKey(): number;
 declare function randomNumber(min?: number, max?: number): number;
+declare function times<T>(num: number, fn: (index: number) => T): T[];
+declare function delay(time: number): Promise<void>;
 
 declare function pascalCase(s: string): string;
 declare function camelize(s: string): string;
 declare function kebabCase(s: string): string;
 declare function slash(path: string): string;
 declare function genStringKey(): string;
-declare function capitalizeFirstLetter(s: string): string;
+declare function upperFirst(s: string): string;
+declare function lowerFirst(s: string): string;
 
-declare function mergeWith<TObject extends Record<string, any>, TSource extends Record<string, any>>(object: TObject, source: TSource, callback?: (objValue: any, srcValue: any, key: string | number | symbol, object?: TObject, source?: TSource) => any | void): TObject & TSource;
+declare function mergeWith<TObject extends Record<string, any>, TSource extends Record<string, any>>(object: TObject, source: TSource, fn: (objValue: any, srcValue: any, key: string | number | symbol, object?: TObject, source?: TSource) => any): TObject & TSource;
+declare function merge<TObject extends Record<string, any>, TSource extends Record<string, any>>(object: TObject, source: TSource): TObject & TSource;
+declare function cloneDeep<T>(value: T): T;
+declare function cloneDeepWith<T>(value: T, fn: (value: any) => any): T;
 
 declare function tryParseJSON<T>(json: string): T | undefined;
 declare function prettyJSONObject(jsonObject: Record<string, any>): string;
@@ -97,4 +106,12 @@ declare function createStorage(storage: globalThis.Storage): Storage;
 declare const sessionStorage: Storage;
 declare const localStorage: Storage;
 
-export { type BEM, type ClassName, type Classes, NOOP, type Storage, at, call, camelize, cancelAnimationFrame, capitalizeFirstLetter, clamp, clampArrayRange, classes, createNamespaceFn, createStorage, debounce, doubleRaf, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isBoolean, isDate, isEmpty, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isWindow, kebabCase, localStorage, mergeWith, normalizeToArray, objectToString, pascalCase, prettyJSONObject, preventDefault, raf, randomNumber, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sessionStorage, shuffle, slash, sum, sumBy, supportTouch, throttle, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy };
+declare function sum(arr: number[]): number;
+declare function sumBy<T>(arr: T[], fn: (val: T) => number): number;
+declare function minBy<T>(arr: T[], fn: (val: T) => number): T | undefined;
+declare function maxBy<T>(arr: T[], fn: (val: T) => number): T | undefined;
+declare function mean(arr: number[]): number;
+declare function meanBy<T>(arr: T[], fn: (val: T) => number): number;
+declare function sample<T>(arr: T[]): T | undefined;
+
+export { type BEM, type ClassName, type Classes, NOOP, type Storage, at, call, camelize, cancelAnimationFrame, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, createNamespaceFn, createStorage, debounce, delay, doubleRaf, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isArrayBuffer, isBoolean, isDataView, isDate, isEmpty, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, maxBy, mean, meanBy, merge, mergeWith, minBy, normalizeToArray, objectToString, pascalCase, prettyJSONObject, preventDefault, raf, randomNumber, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sample, sessionStorage, shuffle, slash, sum, sumBy, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst };

package/lib/index.d.ts

@@ -8,8 +8,6 @@ declare const removeArrayEmpty: <T>(arr: Array<T | null | undefined | "">) => T[
 declare function find<T>(arr: Array<T>, fn: (item: T, index: number, array: Array<T>) => any, from?: 'start' | 'end'): [T, number] | [null, -1];
 declare function at<T>(arr: T[], index: number): T | undefined;
 declare function shuffle<T>(arr: T[]): T[];
-declare function sum(arr: number[]): number;
-declare function sumBy<T>(arr: T[], fn: (val: T) => number): number;
 
 declare function requestAnimationFrame(fn: FrameRequestCallback): number;
 declare function cancelAnimationFrame(handle: number): void;
@@ -34,8 +32,8 @@ declare function createNamespaceFn<N extends string>(namespace: N): <C extends s
 };
 
 declare function NOOP(): void;
-declare function debounce(fn: any, delay?: number): (this: unknown, ...args: any[]) => void;
-declare function throttle(fn: any, delay?: number): () => void;
+declare function debounce<F extends (...args: any[]) => any>(fn: F, delay?: number): (this: unknown, ...args: Parameters<F>) => void;
+declare function throttle<F extends (...args: any[]) => any>(fn: F, delay?: number): (this: unknown, ...args: Parameters<F>) => void;
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
 declare const objectToString: typeof Object.prototype.toString;
@@ -52,6 +50,11 @@ declare function isMap(val: unknown): val is Map<any, any>;
 declare function isSet(val: unknown): val is Set<any>;
 declare function isDate(val: unknown): val is Date;
 declare function isRegExp(val: unknown): val is RegExp;
+declare function isWeakMap(val: unknown): val is WeakMap<any, any>;
+declare function isWeakSet(val: unknown): val is WeakSet<any>;
+declare function isArrayBuffer(val: unknown): val is ArrayBuffer;
+declare function isTypedArray(val: unknown): boolean;
+declare function isDataView(val: unknown): val is DataView;
 declare function toRawType(value: unknown): string;
 declare function isFunction(val: unknown): val is Function;
 declare function isArray(val: unknown): val is Array<any>;
@@ -71,15 +74,21 @@ declare function clamp(num: number, min: number, max: number): number;
 declare function clampArrayRange(index: number, arr: Array<unknown>): number;
 declare function genNumberKey(): number;
 declare function randomNumber(min?: number, max?: number): number;
+declare function times<T>(num: number, fn: (index: number) => T): T[];
+declare function delay(time: number): Promise<void>;
 
 declare function pascalCase(s: string): string;
 declare function camelize(s: string): string;
 declare function kebabCase(s: string): string;
 declare function slash(path: string): string;
 declare function genStringKey(): string;
-declare function capitalizeFirstLetter(s: string): string;
+declare function upperFirst(s: string): string;
+declare function lowerFirst(s: string): string;
 
-declare function mergeWith<TObject extends Record<string, any>, TSource extends Record<string, any>>(object: TObject, source: TSource, callback?: (objValue: any, srcValue: any, key: string | number | symbol, object?: TObject, source?: TSource) => any | void): TObject & TSource;
+declare function mergeWith<TObject extends Record<string, any>, TSource extends Record<string, any>>(object: TObject, source: TSource, fn: (objValue: any, srcValue: any, key: string | number | symbol, object?: TObject, source?: TSource) => any): TObject & TSource;
+declare function merge<TObject extends Record<string, any>, TSource extends Record<string, any>>(object: TObject, source: TSource): TObject & TSource;
+declare function cloneDeep<T>(value: T): T;
+declare function cloneDeepWith<T>(value: T, fn: (value: any) => any): T;
 
 declare function tryParseJSON<T>(json: string): T | undefined;
 declare function prettyJSONObject(jsonObject: Record<string, any>): string;
@@ -97,4 +106,12 @@ declare function createStorage(storage: globalThis.Storage): Storage;
 declare const sessionStorage: Storage;
 declare const localStorage: Storage;
 
-export { type BEM, type ClassName, type Classes, NOOP, type Storage, at, call, camelize, cancelAnimationFrame, capitalizeFirstLetter, clamp, clampArrayRange, classes, createNamespaceFn, createStorage, debounce, doubleRaf, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isBoolean, isDate, isEmpty, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isWindow, kebabCase, localStorage, mergeWith, normalizeToArray, objectToString, pascalCase, prettyJSONObject, preventDefault, raf, randomNumber, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sessionStorage, shuffle, slash, sum, sumBy, supportTouch, throttle, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy };
+declare function sum(arr: number[]): number;
+declare function sumBy<T>(arr: T[], fn: (val: T) => number): number;
+declare function minBy<T>(arr: T[], fn: (val: T) => number): T | undefined;
+declare function maxBy<T>(arr: T[], fn: (val: T) => number): T | undefined;
+declare function mean(arr: number[]): number;
+declare function meanBy<T>(arr: T[], fn: (val: T) => number): number;
+declare function sample<T>(arr: T[]): T | undefined;
+
+export { type BEM, type ClassName, type Classes, NOOP, type Storage, at, call, camelize, cancelAnimationFrame, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, createNamespaceFn, createStorage, debounce, delay, doubleRaf, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isArrayBuffer, isBoolean, isDataView, isDate, isEmpty, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, maxBy, mean, meanBy, merge, mergeWith, minBy, normalizeToArray, objectToString, pascalCase, prettyJSONObject, preventDefault, raf, randomNumber, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sample, sessionStorage, shuffle, slash, sum, sumBy, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst };

package/lib/index.js

@@ -48,16 +48,43 @@ function isPromise(val) {
   return isObject(val) && isFunction(val.then) && isFunction(val.catch);
 }
 function isMap(val) {
-  return toTypeString(val) === "[object Map]";
+  return toRawType(val) === "Map";
 }
 function isSet(val) {
-  return toTypeString(val) === "[object Set]";
+  return toRawType(val) === "Set";
 }
 function isDate(val) {
-  return toTypeString(val) === "[object Date]";
+  return toRawType(val) === "Date";
 }
 function isRegExp(val) {
-  return toTypeString(val) === "[object RegExp]";
+  return toRawType(val) === "RegExp";
+}
+function isWeakMap(val) {
+  return toRawType(val) === "WeakMap";
+}
+function isWeakSet(val) {
+  return toRawType(val) === "WeakSet";
+}
+function isArrayBuffer(val) {
+  return toRawType(val) === "ArrayBuffer";
+}
+function isTypedArray(val) {
+  return [
+    "Int8Array",
+    "Uint8Array",
+    "Uint8ClampedArray",
+    "Int16Array",
+    "Uint16Array",
+    "Int32Array",
+    "Uint32Array",
+    "Float32Array",
+    "Float64Array",
+    "BigInt64Array",
+    "BigUint64Array"
+  ].includes(toRawType(val));
+}
+function isDataView(val) {
+  return toRawType(val) === "DataView";
 }
 function toRawType(value) {
   return toTypeString(value).slice(8, -1);
@@ -165,12 +192,6 @@ function shuffle(arr) {
   }
   return arr;
 }
-function sum(arr) {
-  return arr.reduce((ret, val) => ret + val, 0);
-}
-function sumBy(arr, fn) {
-  return arr.reduce((ret, val) => ret + fn(val), 0);
-}
 
 // src/string.ts
 function pascalCase(s) {
@@ -195,9 +216,12 @@ var key = 0;
 function genStringKey() {
   return `generated-key-${key++}`;
 }
-function capitalizeFirstLetter(s) {
+function upperFirst(s) {
   return s.charAt(0).toUpperCase() + s.slice(1);
 }
+function lowerFirst(s) {
+  return s.charAt(0).toLowerCase() + s.slice(1);
+}
 
 // src/element.ts
 function requestAnimationFrame(fn) {
@@ -323,7 +347,7 @@ function createNamespaceFn(namespace) {
 // src/function.ts
 function NOOP() {
 }
-function debounce(fn, delay = 0) {
+function debounce(fn, delay2 = 0) {
   let timer;
   return function(...args) {
     if (timer) {
@@ -331,14 +355,14 @@ function debounce(fn, delay = 0) {
     }
     timer = setTimeout(() => {
       fn.apply(this, args);
-    }, delay);
+    }, delay2);
   };
 }
-function throttle(fn, delay = 200) {
+function throttle(fn, delay2 = 200) {
   let timer;
   let start = 0;
   return function loop(...args) {
-    const now = Date.now();
+    const now = performance.now();
     const elapsed = now - start;
     if (!start) {
       start = now;
@@ -346,13 +370,13 @@ function throttle(fn, delay = 200) {
     if (timer) {
       clearTimeout(timer);
     }
-    if (elapsed >= delay) {
+    if (elapsed >= delay2) {
       fn.apply(this, args);
       start = now;
     } else {
       timer = setTimeout(() => {
         loop.apply(this, args);
-      }, delay - elapsed);
+      }, delay2 - elapsed);
     }
   };
 }
@@ -393,15 +417,24 @@ function genNumberKey() {
 function randomNumber(min = 0, max = 100) {
   return Math.floor(Math.random() * (max - min + 1)) + min;
 }
+function times(num, fn) {
+  return Array.from({ length: num }, (_, index) => fn(index));
+}
+function delay(time) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, time);
+  });
+}
 
 // src/collection.ts
-function mergeWith(object, source, callback) {
+import { isArrayBuffer as isArrayBuffer2, isDataView as isDataView2, isRegExp as isRegExp2, isTypedArray as isTypedArray2, isWeakMap as isWeakMap2 } from "util/types";
+function mergeWith(object, source, fn) {
   function baseMerge(target, src) {
     for (const key3 in src) {
       if (hasOwn(src, key3)) {
         const srcValue = src[key3];
         const targetValue = target[key3];
-        const customResult = callback == null ? void 0 : callback(targetValue, srcValue, key3, object, source);
+        const customResult = fn(targetValue, srcValue, key3, object, source);
         if (customResult !== void 0) {
           target[key3] = customResult;
         } else if (isObject(srcValue)) {
@@ -419,6 +452,92 @@ function mergeWith(object, source, callback) {
   }
   return baseMerge(object, source);
 }
+function merge(object, source) {
+  return mergeWith(object, source, () => void 0);
+}
+function cloneDeep(value) {
+  return cloneDeepWith(value, () => void 0);
+}
+function cloneDeepWith(value, fn) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  function baseCloneDeep(value2, cache2) {
+    const customResult = fn(value2);
+    if (customResult !== void 0) {
+      return customResult;
+    }
+    if (!isObject(value2)) {
+      return value2;
+    }
+    if (cache2.has(value2)) {
+      return cache2.get(value2);
+    }
+    if (isDate(value2)) {
+      return new Date(value2);
+    }
+    if (isRegExp2(value2)) {
+      return new RegExp(value2);
+    }
+    if (isMap(value2)) {
+      const result = /* @__PURE__ */ new Map();
+      cache2.set(value2, result);
+      value2.forEach((val, key3) => {
+        result.set(baseCloneDeep(key3, cache2), baseCloneDeep(val, cache2));
+      });
+      return result;
+    }
+    if (isSet(value2)) {
+      const result = /* @__PURE__ */ new Set();
+      cache2.set(value2, result);
+      value2.forEach((val) => {
+        result.add(baseCloneDeep(val, cache2));
+      });
+      return result;
+    }
+    if (toRawType(value2) === "String" || toRawType(value2) === "Number" || toRawType(value2) === "Boolean") {
+      return newConstructor(value2, value2.valueOf());
+    }
+    if (isWeakMap2(value2) || isWeakSet(value2)) {
+      return {};
+    }
+    if (isTypedArray2(value2)) {
+      return newConstructor(value2, baseCloneArrayBuffer(value2.buffer), value2.byteOffset, value2.length);
+    }
+    if (isDataView2(value2)) {
+      return newConstructor(value2, baseCloneArrayBuffer(value2.buffer), value2.byteOffset, value2.byteLength);
+    }
+    if (isArrayBuffer2(value2)) {
+      return baseCloneArrayBuffer(value2);
+    }
+    if (isArray(value2)) {
+      const result = [];
+      cache2.set(value2, result);
+      value2.forEach((value3, index) => {
+        result[index] = baseCloneDeep(value3, cache2);
+      });
+      return result;
+    }
+    if (isPlainObject(value2)) {
+      const result = Object.create(Reflect.getPrototypeOf(value2));
+      cache2.set(value2, result);
+      for (const key3 in value2) {
+        if (hasOwn(value2, key3)) {
+          result[key3] = baseCloneDeep(value2[key3], cache2);
+        }
+      }
+      return result;
+    }
+    return value2;
+  }
+  function baseCloneArrayBuffer(value2) {
+    const result = new ArrayBuffer(value2.byteLength);
+    new Uint8Array(result).set(new Uint8Array(value2));
+    return result;
+  }
+  function newConstructor(value2, ...args) {
+    return new value2.constructor(...args);
+  }
+  return baseCloneDeep(value, cache);
+}
 
 // src/json.ts
 function tryParseJSON(json) {
@@ -488,19 +607,53 @@ function createStorage(storage) {
 }
 var sessionStorage = createStorage(globalThis.sessionStorage);
 var localStorage = createStorage(globalThis.localStorage);
+
+// src/math.ts
+function sum(arr) {
+  return arr.reduce((ret, val) => ret + val, 0);
+}
+function sumBy(arr, fn) {
+  return arr.reduce((ret, val) => ret + fn(val), 0);
+}
+function minBy(arr, fn) {
+  if (!arr.length) {
+    return;
+  }
+  return arr.reduce((result, item) => fn(result) < fn(item) ? result : item, arr[0]);
+}
+function maxBy(arr, fn) {
+  if (!arr.length) {
+    return;
+  }
+  return arr.reduce((result, item) => fn(result) > fn(item) ? result : item, arr[0]);
+}
+function mean(arr) {
+  return sum(arr) / arr.length;
+}
+function meanBy(arr, fn) {
+  return sumBy(arr, fn) / arr.length;
+}
+function sample(arr) {
+  if (!arr.length) {
+    return;
+  }
+  return arr[randomNumber(0, arr.length - 1)];
+}
 export {
   NOOP,
   at,
   call,
   camelize,
   cancelAnimationFrame,
-  capitalizeFirstLetter,
   clamp,
   clampArrayRange,
   classes,
+  cloneDeep,
+  cloneDeepWith,
   createNamespaceFn,
   createStorage,
   debounce,
+  delay,
   doubleRaf,
   find,
   genNumberKey,
@@ -517,7 +670,9 @@ export {
   inMobile,
   inViewport,
   isArray,
+  isArrayBuffer,
   isBoolean,
+  isDataView,
   isDate,
   isEmpty,
   isFunction,
@@ -534,10 +689,19 @@ export {
   isString,
   isSymbol,
   isTruthy,
+  isTypedArray,
+  isWeakMap,
+  isWeakSet,
   isWindow,
   kebabCase,
   localStorage,
+  lowerFirst,
+  maxBy,
+  mean,
+  meanBy,
+  merge,
   mergeWith,
+  minBy,
   normalizeToArray,
   objectToString,
   pascalCase,
@@ -549,6 +713,7 @@ export {
   removeArrayEmpty,
   removeItem,
   requestAnimationFrame,
+  sample,
   sessionStorage,
   shuffle,
   slash,
@@ -556,6 +721,7 @@ export {
   sumBy,
   supportTouch,
   throttle,
+  times,
   toArrayBuffer,
   toDataURL,
   toNumber,
@@ -565,5 +731,6 @@ export {
   toggleItem,
   tryParseJSON,
   uniq,
-  uniqBy
+  uniqBy,
+  upperFirst
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rattail",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "main": "lib/index.cjs",
   "module": "lib/index.js",
@@ -51,7 +51,7 @@
   "scripts": {
     "dev": "tsup src/index.ts --format esm --out-dir=lib --watch --dts",
     "build": "tsup src/index.ts --format esm,cjs --out-dir=lib --dts --clean",
-    "lint": "eslint --ext .ts,.js",
+    "lint": "eslint . --fix --ext .ts,.js",
     "format": "prettier --write .",
     "clean": "rimraf node_modules lib",
     "test:watch": "vitest --coverage",