rattail 1.0.24 → 1.2.0

package/lib/index.cjs

@@ -53,6 +53,7 @@ __export(src_exports, {
   at: () => at,
   baseRound: () => baseRound,
   call: () => call,
+  callOrReturn: () => callOrReturn,
   camelize: () => camelize,
   cancelAnimationFrame: () => cancelAnimationFrame,
   ceil: () => ceil,
@@ -86,6 +87,8 @@ __export(src_exports, {
   getScrollTop: () => getScrollTop,
   getStyle: () => getStyle,
   groupBy: () => groupBy,
+  hasDuplicates: () => hasDuplicates,
+  hasDuplicatesBy: () => hasDuplicatesBy,
   hasOwn: () => hasOwn,
   inBrowser: () => inBrowser,
   inMobile: () => inMobile,
@@ -156,6 +159,8 @@ __export(src_exports, {
   removeArrayBlank: () => removeArrayBlank,
   removeArrayEmpty: () => removeArrayEmpty,
   removeItem: () => removeItem,
+  removeItemBy: () => removeItemBy,
+  removeItemsBy: () => removeItemsBy,
   requestAnimationFrame: () => requestAnimationFrame,
   round: () => round,
   sample: () => sample,
@@ -535,6 +540,16 @@ function assert(condition, message) {
   }
 }
 
+// src/general/hasDuplicates.ts
+function hasDuplicates(arr) {
+  return uniq(arr).length !== arr.length;
+}
+
+// src/general/hasDuplicatesBy.ts
+function hasDuplicatesBy(arr, fn) {
+  return uniqBy(arr, fn).length !== arr.length;
+}
+
 // src/number/toNumber.ts
 function toNumber(val) {
   if (val == null) {
@@ -579,6 +594,30 @@ function removeItem(arr, item) {
   }
 }
 
+// src/array/removeItemBy.ts
+function removeItemBy(arr, fn) {
+  if (arr.length) {
+    const index = arr.findIndex((v) => fn(v));
+    if (index > -1) {
+      return arr.splice(index, 1);
+    }
+  }
+}
+
+// src/array/removeItemsBy.ts
+function removeItemsBy(arr, fn) {
+  let i = 0;
+  const removedItems = [];
+  while (i < arr.length) {
+    if (fn(arr[i])) {
+      removedItems.push(...arr.splice(i, 1));
+    } else {
+      i++;
+    }
+  }
+  return removedItems;
+}
+
 // src/array/toggleItem.ts
 function toggleItem(arr, item) {
   arr.includes(item) ? removeItem(arr, item) : arr.push(item);
@@ -1331,6 +1370,14 @@ function throttle(fn, delay2 = 200) {
 function NOOP() {
 }
 
+// src/function/callOrReturn.ts
+function callOrReturn(fnOrValue, ...args) {
+  if (isFunction(fnOrValue)) {
+    return fnOrValue(...args);
+  }
+  return fnOrValue;
+}
+
 // src/collection/cloneDeepWith.ts
 function cloneDeepWith(value, fn) {
   const cache = /* @__PURE__ */ new WeakMap();
@@ -1595,6 +1642,7 @@ function ceil(val, precision = 0) {
   at,
   baseRound,
   call,
+  callOrReturn,
   camelize,
   cancelAnimationFrame,
   ceil,
@@ -1628,6 +1676,8 @@ function ceil(val, precision = 0) {
   getScrollTop,
   getStyle,
   groupBy,
+  hasDuplicates,
+  hasDuplicatesBy,
   hasOwn,
   inBrowser,
   inMobile,
@@ -1698,6 +1748,8 @@ function ceil(val, precision = 0) {
   removeArrayBlank,
   removeArrayEmpty,
   removeItem,
+  removeItemBy,
+  removeItemsBy,
   requestAnimationFrame,
   round,
   sample,

package/lib/index.d.cts

@@ -7,6 +7,10 @@ declare function chunk<T>(arr: T[], size?: number): T[][];
 
 declare function removeItem<T>(arr: T[], item: T): T[] | undefined;
 
+declare function removeItemBy<T>(arr: T[], fn: (v: T) => any): T[] | undefined;
+
+declare function removeItemsBy<T>(arr: T[], fn: (v: T) => any): T[];
+
 declare function toggleItem<T>(arr: T[], item: T): T[];
 
 declare function uniq<T>(arr: T[]): T[];
@@ -161,6 +165,8 @@ declare function throttle<F extends (...args: any[]) => any>(fn: F, delay?: numb
 
 declare function NOOP(): void;
 
+declare function callOrReturn<T, A extends any[]>(fnOrValue: T | ((...args: A) => T), ...args: A): T;
+
 declare function getGlobalThis(): typeof globalThis;
 
 declare function hasOwn<T extends object>(val: T, key: PropertyKey): key is keyof T;
@@ -242,6 +248,10 @@ declare function isEmptyPlainObject(val: unknown): val is Record<string, any>;
 
 declare function assert(condition: boolean, message: string): asserts condition;
 
+declare function hasDuplicates<T>(arr: T[]): boolean;
+
+declare function hasDuplicatesBy<T>(arr: T[], fn: (a: T, b: T) => any): boolean;
+
 declare function clamp(num: number, min: number, max: number): number;
 
 declare function clampArrayRange(index: number, arr: unknown[]): number;
@@ -316,4 +326,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.d.ts

@@ -7,6 +7,10 @@ declare function chunk<T>(arr: T[], size?: number): T[][];
 
 declare function removeItem<T>(arr: T[], item: T): T[] | undefined;
 
+declare function removeItemBy<T>(arr: T[], fn: (v: T) => any): T[] | undefined;
+
+declare function removeItemsBy<T>(arr: T[], fn: (v: T) => any): T[];
+
 declare function toggleItem<T>(arr: T[], item: T): T[];
 
 declare function uniq<T>(arr: T[]): T[];
@@ -161,6 +165,8 @@ declare function throttle<F extends (...args: any[]) => any>(fn: F, delay?: numb
 
 declare function NOOP(): void;
 
+declare function callOrReturn<T, A extends any[]>(fnOrValue: T | ((...args: A) => T), ...args: A): T;
+
 declare function getGlobalThis(): typeof globalThis;
 
 declare function hasOwn<T extends object>(val: T, key: PropertyKey): key is keyof T;
@@ -242,6 +248,10 @@ declare function isEmptyPlainObject(val: unknown): val is Record<string, any>;
 
 declare function assert(condition: boolean, message: string): asserts condition;
 
+declare function hasDuplicates<T>(arr: T[]): boolean;
+
+declare function hasDuplicatesBy<T>(arr: T[], fn: (a: T, b: T) => any): boolean;
+
 declare function clamp(num: number, min: number, max: number): number;
 
 declare function clampArrayRange(index: number, arr: unknown[]): number;
@@ -316,4 +326,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.global.js

@@ -43,6 +43,7 @@ var Rattail = (() => {
     at: () => at,
     baseRound: () => baseRound,
     call: () => call,
+    callOrReturn: () => callOrReturn,
     camelize: () => camelize,
     cancelAnimationFrame: () => cancelAnimationFrame,
     ceil: () => ceil,
@@ -76,6 +77,8 @@ var Rattail = (() => {
     getScrollTop: () => getScrollTop,
     getStyle: () => getStyle,
     groupBy: () => groupBy,
+    hasDuplicates: () => hasDuplicates,
+    hasDuplicatesBy: () => hasDuplicatesBy,
     hasOwn: () => hasOwn,
     inBrowser: () => inBrowser,
     inMobile: () => inMobile,
@@ -146,6 +149,8 @@ var Rattail = (() => {
     removeArrayBlank: () => removeArrayBlank,
     removeArrayEmpty: () => removeArrayEmpty,
     removeItem: () => removeItem,
+    removeItemBy: () => removeItemBy,
+    removeItemsBy: () => removeItemsBy,
     requestAnimationFrame: () => requestAnimationFrame,
     round: () => round,
     sample: () => sample,
@@ -524,6 +529,16 @@ var Rattail = (() => {
     }
   }
 
+  // src/general/hasDuplicates.ts
+  function hasDuplicates(arr) {
+    return uniq(arr).length !== arr.length;
+  }
+
+  // src/general/hasDuplicatesBy.ts
+  function hasDuplicatesBy(arr, fn) {
+    return uniqBy(arr, fn).length !== arr.length;
+  }
+
   // src/number/toNumber.ts
   function toNumber(val) {
     if (val == null) {
@@ -568,6 +583,30 @@ var Rattail = (() => {
     }
   }
 
+  // src/array/removeItemBy.ts
+  function removeItemBy(arr, fn) {
+    if (arr.length) {
+      const index = arr.findIndex((v) => fn(v));
+      if (index > -1) {
+        return arr.splice(index, 1);
+      }
+    }
+  }
+
+  // src/array/removeItemsBy.ts
+  function removeItemsBy(arr, fn) {
+    let i = 0;
+    const removedItems = [];
+    while (i < arr.length) {
+      if (fn(arr[i])) {
+        removedItems.push(...arr.splice(i, 1));
+      } else {
+        i++;
+      }
+    }
+    return removedItems;
+  }
+
   // src/array/toggleItem.ts
   function toggleItem(arr, item) {
     arr.includes(item) ? removeItem(arr, item) : arr.push(item);
@@ -1302,6 +1341,14 @@ var Rattail = (() => {
   function NOOP() {
   }
 
+  // src/function/callOrReturn.ts
+  function callOrReturn(fnOrValue, ...args) {
+    if (isFunction(fnOrValue)) {
+      return fnOrValue(...args);
+    }
+    return fnOrValue;
+  }
+
   // src/collection/cloneDeepWith.ts
   function cloneDeepWith(value, fn) {
     const cache = /* @__PURE__ */ new WeakMap();

package/lib/index.js

@@ -41,6 +41,7 @@ __export(src_exports, {
   at: () => at,
   baseRound: () => baseRound,
   call: () => call,
+  callOrReturn: () => callOrReturn,
   camelize: () => camelize,
   cancelAnimationFrame: () => cancelAnimationFrame,
   ceil: () => ceil,
@@ -74,6 +75,8 @@ __export(src_exports, {
   getScrollTop: () => getScrollTop,
   getStyle: () => getStyle,
   groupBy: () => groupBy,
+  hasDuplicates: () => hasDuplicates,
+  hasDuplicatesBy: () => hasDuplicatesBy,
   hasOwn: () => hasOwn,
   inBrowser: () => inBrowser,
   inMobile: () => inMobile,
@@ -144,6 +147,8 @@ __export(src_exports, {
   removeArrayBlank: () => removeArrayBlank,
   removeArrayEmpty: () => removeArrayEmpty,
   removeItem: () => removeItem,
+  removeItemBy: () => removeItemBy,
+  removeItemsBy: () => removeItemsBy,
   requestAnimationFrame: () => requestAnimationFrame,
   round: () => round,
   sample: () => sample,
@@ -522,6 +527,16 @@ function assert(condition, message) {
   }
 }
 
+// src/general/hasDuplicates.ts
+function hasDuplicates(arr) {
+  return uniq(arr).length !== arr.length;
+}
+
+// src/general/hasDuplicatesBy.ts
+function hasDuplicatesBy(arr, fn) {
+  return uniqBy(arr, fn).length !== arr.length;
+}
+
 // src/number/toNumber.ts
 function toNumber(val) {
   if (val == null) {
@@ -566,6 +581,30 @@ function removeItem(arr, item) {
   }
 }
 
+// src/array/removeItemBy.ts
+function removeItemBy(arr, fn) {
+  if (arr.length) {
+    const index = arr.findIndex((v) => fn(v));
+    if (index > -1) {
+      return arr.splice(index, 1);
+    }
+  }
+}
+
+// src/array/removeItemsBy.ts
+function removeItemsBy(arr, fn) {
+  let i = 0;
+  const removedItems = [];
+  while (i < arr.length) {
+    if (fn(arr[i])) {
+      removedItems.push(...arr.splice(i, 1));
+    } else {
+      i++;
+    }
+  }
+  return removedItems;
+}
+
 // src/array/toggleItem.ts
 function toggleItem(arr, item) {
   arr.includes(item) ? removeItem(arr, item) : arr.push(item);
@@ -1319,6 +1358,14 @@ function throttle(fn, delay2 = 200) {
 function NOOP() {
 }
 
+// src/function/callOrReturn.ts
+function callOrReturn(fnOrValue, ...args) {
+  if (isFunction(fnOrValue)) {
+    return fnOrValue(...args);
+  }
+  return fnOrValue;
+}
+
 // src/collection/cloneDeepWith.ts
 function cloneDeepWith(value, fn) {
   const cache = /* @__PURE__ */ new WeakMap();
@@ -1582,6 +1629,7 @@ export {
   at,
   baseRound,
   call,
+  callOrReturn,
   camelize,
   cancelAnimationFrame,
   ceil,
@@ -1615,6 +1663,8 @@ export {
   getScrollTop,
   getStyle,
   groupBy,
+  hasDuplicates,
+  hasDuplicatesBy,
   hasOwn,
   inBrowser,
   inMobile,
@@ -1685,6 +1735,8 @@ export {
   removeArrayBlank,
   removeArrayEmpty,
   removeItem,
+  removeItemBy,
+  removeItemsBy,
   requestAnimationFrame,
   round,
   sample,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rattail",
-  "version": "1.0.24",
+  "version": "1.2.0",
   "description": "A utilities library for front-end developers, lightweight and ts-friendly",
   "keywords": [
     "utilities library",