rattail 1.1.0 → 1.2.1

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,
@@ -537,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) {
@@ -1357,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();
@@ -1621,6 +1642,7 @@ function ceil(val, precision = 0) {
   at,
   baseRound,
   call,
+  callOrReturn,
   camelize,
   cancelAnimationFrame,
   ceil,
@@ -1654,6 +1676,8 @@ function ceil(val, precision = 0) {
   getScrollTop,
   getStyle,
   groupBy,
+  hasDuplicates,
+  hasDuplicatesBy,
   hasOwn,
   inBrowser,
   inMobile,

package/lib/index.d.cts

@@ -165,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;
@@ -199,7 +201,7 @@ declare function isMap(val: unknown): val is Map<any, any>;
 
 declare function isNonEmptyArray(val: unknown): val is any[];
 
-declare function isNullish<T>(val: T | null | undefined): val is NonNullable<T>;
+declare function isNullish(val: unknown): val is null | undefined;
 
 declare function isNumber(val: unknown): val is number;
 
@@ -246,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;
@@ -320,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, 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 };
+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

@@ -165,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;
@@ -199,7 +201,7 @@ declare function isMap(val: unknown): val is Map<any, any>;
 
 declare function isNonEmptyArray(val: unknown): val is any[];
 
-declare function isNullish<T>(val: T | null | undefined): val is NonNullable<T>;
+declare function isNullish(val: unknown): val is null | undefined;
 
 declare function isNumber(val: unknown): val is number;
 
@@ -246,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;
@@ -320,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, 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 };
+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,
@@ -526,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) {
@@ -1328,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,
@@ -524,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) {
@@ -1345,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();
@@ -1608,6 +1629,7 @@ export {
   at,
   baseRound,
   call,
+  callOrReturn,
   camelize,
   cancelAnimationFrame,
   ceil,
@@ -1641,6 +1663,8 @@ export {
   getScrollTop,
   getStyle,
   groupBy,
+  hasDuplicates,
+  hasDuplicatesBy,
   hasOwn,
   inBrowser,
   inMobile,

package/package.json

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