atomic-fns 0.2.0 → 0.2.2

package/src/collections.ts

@@ -1,3 +1,7 @@
+/**
+ * Collections
+ * @module
+ */
 import {
   call,
   Function,
@@ -261,7 +265,7 @@ export function filter(arr, fn: Iteratee | PropertyKey | Object = isNull) {
 export function find(arr, fn: Iteratee | PropertyKey | Object) {
   if (Array.isArray(arr)) {
     if (typeof fn === 'function') return arr.find(fn as Iteratee)
-    if (typeof fn === 'string') return arr.find((x) => x && x[fn])
+    if (typeof fn === 'string') return arr.find((x) => x?.[fn])
     if (isObject(fn)) return arr.find(matches(fn))
   }
 }
@@ -273,7 +277,7 @@ export function findRight(arr, fn: Iteratee | PropertyKey | Object) {
       if (typeof fn === 'function') {
         if (fn(x)) return x
       } else if (typeof fn === 'string') {
-        if (x && x[fn]) return x
+        if (x?.[fn]) return x
       } else if (isObject(fn)) {
         if (matches(fn)(x)) return x
       }

package/src/datetime.d.ts

@@ -1 +1,5 @@
+/**
+ * Date
+ * @module
+ */
 export declare const now: number;

package/src/datetime.js

@@ -1 +1,5 @@
-export const now = new Date().getTime();
+/**
+ * Date
+ * @module
+ */
+export const now = new Date().getTime()

package/src/datetime.ts

@@ -1 +1,6 @@
+/**
+ * Date
+ * @module
+ */
+
 export const now = new Date().getTime()

package/src/functools.d.ts

@@ -1,3 +1,7 @@
+/**
+ * FP
+ * @module
+ */
 import { Function } from './globals.js';
 export declare const bind: (fn: any, self: any, ...args: any[]) => any;
 export declare const partial: (fn: any, ...args: any[]) => any;

package/src/functools.js

@@ -1,13 +1,15 @@
-export const bind = (fn, self, ...args) => fn.bind(self, ...args);
-export const partial = (fn, ...args) => bind(fn, {}, ...args);
-export const flow = (...args) => (x) => {
+export const bind = (fn, self, ...args) => fn.bind(self, ...args)
+export const partial = (fn, ...args) => bind(fn, {}, ...args)
+export const flow =
+  (...args) =>
+  (x) => {
     for (const fn of args) {
-        x = fn(x);
+      x = fn(x)
     }
-    return x;
-};
-export const pipe = flow;
-export const compose = (...args) => flow(args.reverse());
+    return x
+  }
+export const pipe = flow
+export const compose = (...args) => flow(args.reverse())
 /**
  * Creates a function that memoizes the result of `func`. If `resolver` is provided, it determines the cache key for storing the result based on the arguments provided to the memoized function. By default, the first argument provided to the memoized function is used as the map cache key.
  *
@@ -17,16 +19,15 @@ export const compose = (...args) => flow(args.reverse());
  * @return {Function} Returns the new memoized function.
  */
 export function memoize(func, resolver) {
-    const cache = new Map();
-    return (...args) => {
-        const key = resolver ? resolver(...args) : args[0];
-        const prev = cache.get(key);
-        if (prev !== undefined)
-            return prev;
-        const value = func(...args);
-        cache.set(key, value);
-        return value;
-    };
+  const cache = new Map()
+  return (...args) => {
+    const key = resolver ? resolver(...args) : args[0]
+    const prev = cache.get(key)
+    if (prev !== undefined) return prev
+    const value = func(...args)
+    cache.set(key, value)
+    return value
+  }
 }
 /**
  * Creates a debounced function that delays invoking `func` until after `wait` milliseconds have elapsed since the last time the debounced function was invoked. Subsequent calls to the debounced function return the result of the last successful invocation. Provide options to set the `maxWait` milliseconds, regardless of when the function was last invoked.
@@ -38,24 +39,23 @@ export function memoize(func, resolver) {
  * @return {Function} Returns the new debounced function.
  */
 export function debounce(func, wait, { maxWait }) {
-    let timer, maxTimer, lastResult;
-    return (...args) => {
-        if (timer)
-            clearTimeout(timer);
-        timer = setTimeout(() => {
-            clearTimeout(maxTimer);
-            maxTimer = null;
-            lastResult = func(...args);
-        }, wait);
-        if (maxWait && !maxTimer) {
-            maxTimer = setTimeout(() => {
-                clearTimeout(timer);
-                maxTimer = null;
-                lastResult = func(...args);
-            }, maxWait);
-        }
-        return lastResult;
-    };
+  let timer, maxTimer, lastResult
+  return (...args) => {
+    if (timer) clearTimeout(timer)
+    timer = setTimeout(() => {
+      clearTimeout(maxTimer)
+      maxTimer = null
+      lastResult = func(...args)
+    }, wait)
+    if (maxWait && !maxTimer) {
+      maxTimer = setTimeout(() => {
+        clearTimeout(timer)
+        maxTimer = null
+        lastResult = func(...args)
+      }, maxWait)
+    }
+    return lastResult
+  }
 }
 /**
  * Creates a throttled function that only invokes `func` at most once per every `wait` milliseconds. Subsequent calls to the throttled function return the result of the last successful invocation.
@@ -66,14 +66,13 @@ export function debounce(func, wait, { maxWait }) {
  * @return {Function} Returns the new throttled function.
  */
 export function throttle(func, time) {
-    let pending = false;
-    return (...args) => {
-        if (pending)
-            return;
-        func(...args);
-        pending = true;
-        setTimeout(() => {
-            pending = false;
-        }, time);
-    };
+  let pending = false
+  return (...args) => {
+    if (pending) return
+    func(...args)
+    pending = true
+    setTimeout(() => {
+      pending = false
+    }, time)
+  }
 }

package/src/functools.ts

@@ -1,3 +1,7 @@
+/**
+ * FP
+ * @module
+ */
 import { Function } from './globals.js'
 
 export const bind = (fn, self, ...args) => fn.bind(self, ...args)

package/src/globals.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Globals
+ * @module
+ */
 export declare type Comp = (x: any, y: any) => number;
 export declare type Function = (...args: any[]) => any;
 export declare type Iteratee = (value: any, key?: any, arr?: any) => any;
@@ -13,10 +17,10 @@ export declare const False: () => boolean;
 export declare class CustomError extends Error {
     /**
      * Returns a new CustomError with the specified message.
-     * @param message
+     * @param {string} message
      * @constructor
      */
-    constructor(message?: any);
+    constructor(message?: string);
 }
 /**
  * Custom error to signal an invalid index access.
@@ -136,7 +140,7 @@ export declare function round(x: number, digits?: number): number;
 export declare const floor: (x: number) => number;
 export declare const ceil: (x: number) => number;
 /**
- * Yields elements like [index, item] from an iterable.
+ * Yields elements like `[index, item]` from an iterable.
  *
  *
  * @template T