rattail 1.0.0 → 1.0.2

package/README.md

@@ -1,11 +1,11 @@
 <div align="center">
-  <a href="https://rattail.pages.dev">
-    <img src="https://rattail.pages.dev/logo.svg" width="150">
+  <a href="https://rattail.varletjs.org">
+    <img src="https://rattail.varletjs.org/logo.svg" width="150">
   </a>
   <h1>Rattail</h1>
   <p>A utilities library for front-end developers, lightweight and ts-friendly.</p>
   <p>
-    <a href="https://rattail.pages.dev">Documentation</a> |
+    <a href="https://rattail.varletjs.org">Documentation</a> |
     <a href="https://github.com/varletjs/rattail/blob/main/README.zh-CN.md">中文介绍</a>
   </p>
   <p>
@@ -24,7 +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
+- 💪 &nbsp; Make sure more than 99% unit test coverage, providing stability assurance
 
 ### Installation
 

package/README.zh-CN.md

@@ -1,11 +1,11 @@
 <div align="center">
-  <a href="https://rattail.pages.dev/zh">
-    <img src="https://rattail.pages.dev/logo.svg" width="150">
+  <a href="https://rattail.varletjs.org/zh">
+    <img src="https://rattail.varletjs.org/logo.svg" width="150">
   </a>
   <h1>Rattail</h1>
   <p>面向前端开发人员的实用工具库，轻量级且 ts 友好</p>
   <p>
-    <a href="https://rattail.pages.dev/zh">文档</a> |
+    <a href="https://rattail.varletjs.org/zh">文档</a> |
     <a href="https://github.com/varletjs/rattail/blob/main/README.md">ENGLISH README</a>
   </p>
   <p>
@@ -24,7 +24,7 @@
 - 🛠️ &nbsp; 提供日常开发中经常使用的实用工具
 - 🛠️ &nbsp; 工具实现非常轻量
 - 🛠️ &nbsp; 使用 ts 编写，提供完善的类型支持
-- 💪 &nbsp; 确保 90% 以上单元测试覆盖率，提供稳定性保证
+- 💪 &nbsp; 确保 99% 以上单元测试覆盖率，提供稳定性保证
 
 ### 安装
 

package/lib/index.cjs

@@ -72,6 +72,7 @@ __export(src_exports, {
   inViewport: () => inViewport,
   isArray: () => isArray,
   isArrayBuffer: () => isArrayBuffer,
+  isBlob: () => isBlob,
   isBoolean: () => isBoolean,
   isDOMException: () => isDOMException,
   isDataView: () => isDataView,
@@ -80,6 +81,7 @@ __export(src_exports, {
   isEqual: () => isEqual,
   isEqualWith: () => isEqualWith,
   isError: () => isError,
+  isFile: () => isFile,
   isFunction: () => isFunction,
   isMap: () => isMap,
   isNonEmptyArray: () => isNonEmptyArray,
@@ -472,6 +474,16 @@ function supportTouch() {
   return inBrowser() && "ontouchstart" in window;
 }
 
+// src/general/isFile.ts
+function isFile(val) {
+  return toRawType(val) === "File";
+}
+
+// src/general/isBlob.ts
+function isBlob(val) {
+  return toRawType(val) === "Blob";
+}
+
 // src/number/toNumber.ts
 function toNumber(val) {
   if (val == null) {
@@ -1054,34 +1066,45 @@ function cloneDeep(value) {
 }
 
 // src/collection/mergeWith.ts
-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 = fn(targetValue, srcValue, key3, object, source);
-        if (customResult !== void 0) {
-          target[key3] = customResult;
-        } else if (isObject(srcValue)) {
-          if (isObject(targetValue)) {
-            target[key3] = baseMerge(targetValue, srcValue);
+function mergeWith(object, ...sources) {
+  const fn = at(sources, -1);
+  const targets = [object, ...sources.slice(0, -1)];
+  let len = targets.length - 1;
+  let result = targets[len];
+  while (len) {
+    result = baseMergeWith(targets[len - 1], result, fn);
+    len--;
+  }
+  function baseMergeWith(object2, source, fn2) {
+    function baseMerge(target, src) {
+      for (const key3 in src) {
+        if (hasOwn(src, key3)) {
+          const srcValue = src[key3];
+          const targetValue = target[key3];
+          const customResult = fn2(targetValue, srcValue, key3, object2, source);
+          if (customResult !== void 0) {
+            target[key3] = customResult;
+          } else if (isObject(srcValue)) {
+            if (isObject(targetValue)) {
+              target[key3] = baseMerge(targetValue, srcValue);
+            } else {
+              target[key3] = baseMerge(isArray(srcValue) ? [] : {}, srcValue);
+            }
           } else {
-            target[key3] = baseMerge(isArray(srcValue) ? [] : {}, srcValue);
+            target[key3] = srcValue;
           }
-        } else {
-          target[key3] = srcValue;
         }
       }
+      return target;
     }
-    return target;
+    return baseMerge(object2, source);
   }
-  return baseMerge(object, source);
+  return result;
 }
 
 // src/collection/merge.ts
-function merge(object, source) {
-  return mergeWith(object, source, () => void 0);
+function merge(object, ...sources) {
+  return mergeWith(object, ...sources, () => void 0);
 }
 
 // src/file/toArrayBuffer.ts
@@ -1233,6 +1256,7 @@ function sample(arr) {
   inViewport,
   isArray,
   isArrayBuffer,
+  isBlob,
   isBoolean,
   isDOMException,
   isDataView,
@@ -1241,6 +1265,7 @@ function sample(arr) {
   isEqual,
   isEqualWith,
   isError,
+  isFile,
   isFunction,
   isMap,
   isNonEmptyArray,

package/lib/index.d.cts

@@ -159,6 +159,10 @@ declare function toRawType(value: unknown): string;
 declare const objectToString: typeof Object.prototype.toString;
 declare function toTypeString(value: unknown): string;
 
+declare function isFile(val: unknown): val is File;
+
+declare function isBlob(val: unknown): val is Blob;
+
 declare function clamp(num: number, min: number, max: number): number;
 
 declare function clampArrayRange(index: number, arr: Array<unknown>): number;
@@ -199,9 +203,10 @@ declare function cloneDeep<T>(value: T): T;
 
 declare function cloneDeepWith<T>(value: T, fn: (value: any) => any): T;
 
-declare function merge<T extends Record<string, any>, K extends Record<string, any>>(object: T, source: K): T & K;
+declare function merge<T extends Record<string, any>, K extends Record<string, any>>(object: T, ...sources: K[]): T & K;
 
-declare function mergeWith<T extends Record<string, any>, K extends Record<string, any>>(object: T, source: K, fn: (objValue: any, srcValue: any, key: string | number | symbol, object?: T, source?: K) => any): T & K;
+type Fn = (objValue: any, srcValue: any, key: string | number | symbol, object?: any, source?: any) => any;
+declare function mergeWith<T extends Record<string, any>, K extends Record<string, any>>(object: T, ...sources: [...K[], fn: Fn]): T & K;
 
 declare function toArrayBuffer(file: File): Promise<ArrayBuffer>;
 
@@ -225,4 +230,4 @@ 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, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, doubleRaf, ensurePrefix, ensureSuffix, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isArrayBuffer, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEqual, isEqualWith, isError, 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, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sample, sessionStorage, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst };
+export { type BEM, type ClassName, type Classes, NOOP, type Storage, at, call, camelize, cancelAnimationFrame, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, doubleRaf, ensurePrefix, ensureSuffix, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEqual, isEqualWith, isError, isFile, 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, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sample, sessionStorage, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst };

package/lib/index.d.ts

@@ -159,6 +159,10 @@ declare function toRawType(value: unknown): string;
 declare const objectToString: typeof Object.prototype.toString;
 declare function toTypeString(value: unknown): string;
 
+declare function isFile(val: unknown): val is File;
+
+declare function isBlob(val: unknown): val is Blob;
+
 declare function clamp(num: number, min: number, max: number): number;
 
 declare function clampArrayRange(index: number, arr: Array<unknown>): number;
@@ -199,9 +203,10 @@ declare function cloneDeep<T>(value: T): T;
 
 declare function cloneDeepWith<T>(value: T, fn: (value: any) => any): T;
 
-declare function merge<T extends Record<string, any>, K extends Record<string, any>>(object: T, source: K): T & K;
+declare function merge<T extends Record<string, any>, K extends Record<string, any>>(object: T, ...sources: K[]): T & K;
 
-declare function mergeWith<T extends Record<string, any>, K extends Record<string, any>>(object: T, source: K, fn: (objValue: any, srcValue: any, key: string | number | symbol, object?: T, source?: K) => any): T & K;
+type Fn = (objValue: any, srcValue: any, key: string | number | symbol, object?: any, source?: any) => any;
+declare function mergeWith<T extends Record<string, any>, K extends Record<string, any>>(object: T, ...sources: [...K[], fn: Fn]): T & K;
 
 declare function toArrayBuffer(file: File): Promise<ArrayBuffer>;
 
@@ -225,4 +230,4 @@ 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, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, doubleRaf, ensurePrefix, ensureSuffix, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isArrayBuffer, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEqual, isEqualWith, isError, 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, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sample, sessionStorage, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst };
+export { type BEM, type ClassName, type Classes, NOOP, type Storage, at, call, camelize, cancelAnimationFrame, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, doubleRaf, ensurePrefix, ensureSuffix, find, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, hasOwn, inBrowser, inMobile, inViewport, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEqual, isEqualWith, isError, isFile, 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, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, sample, sessionStorage, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst };

package/lib/index.js

@@ -341,6 +341,16 @@ function supportTouch() {
   return inBrowser() && "ontouchstart" in window;
 }
 
+// src/general/isFile.ts
+function isFile(val) {
+  return toRawType(val) === "File";
+}
+
+// src/general/isBlob.ts
+function isBlob(val) {
+  return toRawType(val) === "Blob";
+}
+
 // src/number/toNumber.ts
 function toNumber(val) {
   if (val == null) {
@@ -923,34 +933,45 @@ function cloneDeep(value) {
 }
 
 // src/collection/mergeWith.ts
-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 = fn(targetValue, srcValue, key3, object, source);
-        if (customResult !== void 0) {
-          target[key3] = customResult;
-        } else if (isObject(srcValue)) {
-          if (isObject(targetValue)) {
-            target[key3] = baseMerge(targetValue, srcValue);
+function mergeWith(object, ...sources) {
+  const fn = at(sources, -1);
+  const targets = [object, ...sources.slice(0, -1)];
+  let len = targets.length - 1;
+  let result = targets[len];
+  while (len) {
+    result = baseMergeWith(targets[len - 1], result, fn);
+    len--;
+  }
+  function baseMergeWith(object2, source, fn2) {
+    function baseMerge(target, src) {
+      for (const key3 in src) {
+        if (hasOwn(src, key3)) {
+          const srcValue = src[key3];
+          const targetValue = target[key3];
+          const customResult = fn2(targetValue, srcValue, key3, object2, source);
+          if (customResult !== void 0) {
+            target[key3] = customResult;
+          } else if (isObject(srcValue)) {
+            if (isObject(targetValue)) {
+              target[key3] = baseMerge(targetValue, srcValue);
+            } else {
+              target[key3] = baseMerge(isArray(srcValue) ? [] : {}, srcValue);
+            }
           } else {
-            target[key3] = baseMerge(isArray(srcValue) ? [] : {}, srcValue);
+            target[key3] = srcValue;
           }
-        } else {
-          target[key3] = srcValue;
         }
       }
+      return target;
     }
-    return target;
+    return baseMerge(object2, source);
   }
-  return baseMerge(object, source);
+  return result;
 }
 
 // src/collection/merge.ts
-function merge(object, source) {
-  return mergeWith(object, source, () => void 0);
+function merge(object, ...sources) {
+  return mergeWith(object, ...sources, () => void 0);
 }
 
 // src/file/toArrayBuffer.ts
@@ -1101,6 +1122,7 @@ export {
   inViewport,
   isArray,
   isArrayBuffer,
+  isBlob,
   isBoolean,
   isDOMException,
   isDataView,
@@ -1109,6 +1131,7 @@ export {
   isEqual,
   isEqualWith,
   isError,
+  isFile,
   isFunction,
   isMap,
   isNonEmptyArray,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rattail",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "main": "lib/index.cjs",
   "module": "lib/index.js",