atomic-fns 0.3.3-beta → 0.3.4

package/core/collections/index.js

@@ -4,7 +4,7 @@
  * @module Collections
  */
 import { partial } from '../functools/index.js';
-import { call, get, isArray, isArrayLike, isBool, isEmpty, isFunc, isIterable, isNull, isNumber, isObject, isString, isSymbol, keys, set } from '../globals/index.js';
+import { call, get, isArray, isArrayLike, isBool, isEmpty, isFunction, isIterable, isNull, isNumber, isObject, isString, isSymbol, keys, set } from '../globals/index.js';
 import { enumerate } from '../itertools/index.js';
 import { compare, eq, id } from '../operators/index.js';
 export * from './abc.js';
@@ -81,7 +81,7 @@ filter(users, 'active')
  */
 export function filter(arr, fn = isNull) {
     if (Array.isArray(arr)) {
-        if (isFunc(fn))
+        if (isFunction(fn))
             return arr.filter(fn);
         if (isNumber(fn) || isString(fn) || isSymbol(fn))
             return arr.filter((x) => get(fn, x));
@@ -117,7 +117,7 @@ find(users, 'active')
  */
 export function find(arr, fn) {
     if (Array.isArray(arr)) {
-        if (isFunc(fn))
+        if (isFunction(fn))
             return arr.find(fn);
         if (isNumber(fn) || isString(fn) || isSymbol(fn))
             return arr.find((x) => x?.[fn]);
@@ -644,7 +644,7 @@ export function clone(value, deep = false) {
         return cloneArray(value, deep);
     }
     if (isObject(value)) {
-        if (isFunc(value.clone)) {
+        if (isFunction(value.clone)) {
             return value.clone();
         }
         const copy = {};
@@ -976,7 +976,7 @@ export function remove(arr, func) {
     return arr.filter((x, i) => {
         if (isArray(func))
             return !func.includes(x);
-        else if (isFunc(func))
+        else if (isFunction(func))
             return !func(x, i, arr);
         return x !== func;
     });

package/core/collections/index.ts

@@ -12,7 +12,7 @@ import {
   isArrayLike,
   isBool,
   isEmpty,
-  isFunc,
+  isFunction,
   isIterable,
   isNull,
   isNumber,
@@ -114,7 +114,7 @@ filter(users, 'active')
  */
 export function filter(arr, fn: Iteratee | PropertyKey | Object = isNull) {
   if (Array.isArray(arr)) {
-    if (isFunc(fn)) return arr.filter(fn)
+    if (isFunction(fn)) return arr.filter(fn)
     if (isNumber(fn) || isString(fn) || isSymbol(fn)) return arr.filter((x) => get(fn, x))
     if (isObject(fn)) return arr.filter(matches(fn))
   }
@@ -148,7 +148,7 @@ find(users, 'active')
  */
 export function find(arr, fn: Iteratee | PropertyKey | Object) {
   if (Array.isArray(arr)) {
-    if (isFunc(fn)) return arr.find(fn)
+    if (isFunction(fn)) return arr.find(fn)
     if (isNumber(fn) || isString(fn) || isSymbol(fn)) return arr.find((x) => x?.[fn])
     if (isObject(fn)) return arr.find(matches(fn))
   }
@@ -672,7 +672,7 @@ export function clone(value, deep = false) {
     return cloneArray(value, deep)
   }
   if (isObject(value)) {
-    if (isFunc(value.clone)) {
+    if (isFunction(value.clone)) {
       return value.clone()
     }
     const copy = {}
@@ -1015,7 +1015,7 @@ export function groupByMap<K = any, V = any>(
 export function remove<T>(arr: T[], func: any) {
   return arr.filter((x, i) => {
     if (isArray(func)) return !func.includes(x)
-    else if (isFunc(func)) return !func(x, i, arr)
+    else if (isFunction(func)) return !func(x, i, arr)
     return x !== func
   })
 }

package/core/functools/index.d.ts

@@ -47,7 +47,7 @@ export declare const compose: (...args: any[]) => (x: any) => any;
  * @param {Function} [resolver] The function to resolve the cache key.
  * @return {Function} Returns the new memoized function.
  */
-export declare function memoize(func: Function, resolver?: Function): Function;
+export declare function memoize<T>(func: Function<T>, resolver?: Function): Function<ReturnType<typeof func>>;
 export declare function cache(target: any, name: any, descriptor: any): any;
 /**
  * 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.
@@ -84,7 +84,7 @@ single(3) // => 1
 // => `func` is invoked only once.
 ```
  */
-export declare function once(func: Function): (...args: any[]) => any;
+export declare function once<T>(func: Function<T>): (...args: any[]) => T;
 export declare type Maybe<T> = T | undefined;
 export declare type Result<T, E = any> = [Maybe<T>, Maybe<E>];
 /**

package/core/functools/index.ts

@@ -98,7 +98,10 @@ export const compose = (...args) => flow(args.reverse())
  * @param {Function} [resolver] The function to resolve the cache key.
  * @return {Function} Returns the new memoized function.
  */
-export function memoize(func: Function, resolver?: Function): Function {
+export function memoize<T>(
+  func: Function<T>,
+  resolver?: Function
+): Function<ReturnType<typeof func>> {
   const cache = new Map()
   return (...args) => {
     const key = resolver ? resolver(...args) : args[0]
@@ -188,14 +191,14 @@ single(3) // => 1
 // => `func` is invoked only once.
 ```
  */
-export function once(func: Function) {
+export function once<T>(func: Function<T>) {
   let result, isCalled
   return (...args) => {
     if (!isCalled) {
       result = func(...args)
       isCalled = true
     }
-    return result
+    return result as T
   }
 }
 

package/core/globals/index.d.ts

@@ -92,10 +92,15 @@ export declare function type(value: any): any;
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString | Object.toString }
  */
 export declare const str: (obj: any) => any;
+export declare function hasOwnProperty(obj: any, prop: any): boolean;
 /** Check if value is a boolean type. */
 export declare const isBool: (x: any) => x is boolean;
+/** Check if value is an `Error` type. */
+export declare const isError: (x: any) => x is Error;
 /** Check if value is an iterable type. */
 export declare const isIterable: (x: any) => x is IterableIterator<any>;
+/** Check if value is a native `Date` type. */
+export declare const isDate: (x: any) => x is Date;
 /** Check if value is an object type. */
 export declare const isObject: (x: any) => x is Object;
 /** Check if value is a string type. */
@@ -107,28 +112,42 @@ export declare const isArray: (x: any) => x is any[];
  * A value is considered array-like if it's not a function and has a `.length` number property.
  */
 export declare const isArrayLike: (x: any) => boolean;
-/** Check if value is a function type. */
-export declare const isFunc: (x: any) => x is Function<any>;
 /** Check if value is a number type. */
 export declare const isNumber: (x: any) => x is number;
+/** Check if value is an integer number type. */
+export declare const isInteger: (x: any) => x is number;
 /** Check if value is a bigint type. */
 export declare const isBigint: (x: any) => x is BigInt;
 /** Check if value is NaN based on `Number.isNaN`. */
 export declare const isNaN: (x: any) => x is number;
 /** Check if value is a Promise type. */
 export declare const isPromise: (x: any) => x is Promise<any>;
+/** Check if value is a function type. */
+export declare const isFunction: (x: any) => x is Function<any>;
 /** Check if value is an async function type. */
-export declare const isAsync: (x: any) => boolean;
+export declare const isAsyncFunction: (x: any) => boolean;
 /** Check if value is a generator function type. */
 export declare const isGenerator: (x: any) => x is Generator<unknown, any, unknown>;
 /** Check if value is `null` or `undefined`. */
 export declare const isNull: (x: any) => x is null | undefined;
+/** Check if value === `undefined`. */
+export declare function isUndefined(o: any): boolean;
 /** Check if value is not `null` or `undefined`. */
 export declare const notNull: (x: any) => boolean;
 /** Returns `true` for objects without length or falsy values. */
 export declare const isEmpty: (x: any) => boolean;
+/** Check if value is a `RegExp` type */
+export declare const isRegExp: (x: any) => x is RegExp;
 /** Check if value is a `Symbol` type */
 export declare const isSymbol: (x: any) => x is symbol;
+/** Check if value is a `Set` type. */
+export declare const isSet: <T>(x: any) => x is Set<T>;
+/** Check if value is a `Map` type. */
+export declare const isMap: <K, V>(x: any) => x is Map<K, V>;
+/** Check if value is a `WeakSet` type. */
+export declare const isWeakSet: <T extends object>(x: any) => x is WeakSet<T>;
+/** Check if value is a `WeakMap` type. */
+export declare const isWeakMap: <K extends object, V>(x: any) => x is WeakMap<K, V>;
 /**
  * Returns the number of elements in a collection type.
  *

package/core/globals/index.js

@@ -122,14 +122,21 @@ export function type(value) {
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString | Object.toString }
  */
 export const str = (obj) => (obj != null ? obj.toString() : '');
+export function hasOwnProperty(obj, prop) {
+    return Object.prototype.hasOwnProperty.call(obj, prop);
+}
 /** Check if value is a boolean type. */
 export const isBool = (x) => type(x) === 'boolean';
+/** Check if value is an `Error` type. */
+export const isError = (x) => x instanceof Error;
 /** Check if value is an iterable type. */
 export const isIterable = (x) => {
     if (x == null)
         return false;
     return typeof x[Symbol.iterator] === 'function';
 };
+/** Check if value is a native `Date` type. */
+export const isDate = (x) => x instanceof Date;
 /** Check if value is an object type. */
 export const isObject = (x) => typeof x === 'object' && type(x) === 'object';
 /** Check if value is a string type. */
@@ -144,30 +151,46 @@ export const isArrayLike = (x) => {
     const T = type(x);
     return T === 'array' || (T === 'object' && isNumber(x.length));
 };
-/** Check if value is a function type. */
-export const isFunc = (x) => x?.constructor === Function;
 /** Check if value is a number type. */
 export const isNumber = (x) => type(x) === 'number';
+/** Check if value is an integer number type. */
+export const isInteger = (x) => type(x) === 'number' && Math.floor(x) === x;
 /** Check if value is a bigint type. */
 export const isBigint = (x) => type(x) === 'bigint';
 /** Check if value is NaN based on `Number.isNaN`. */
 export const isNaN = (x) => Number.isNaN(x);
 /** Check if value is a Promise type. */
 export const isPromise = (x) => type(x) === 'Promise';
+/** Check if value is a function type. */
+export const isFunction = (x) => x?.constructor === Function;
 /** Check if value is an async function type. */
-export const isAsync = (x) => x?.constructor.name === 'AsyncFunction';
+export const isAsyncFunction = (x) => x?.constructor.name === 'AsyncFunction';
 /** Check if value is a generator function type. */
 export const isGenerator = (x) => {
     return x?.constructor.constructor?.name === 'GeneratorFunction';
 };
 /** Check if value is `null` or `undefined`. */
 export const isNull = (x) => x == null;
+/** Check if value === `undefined`. */
+export function isUndefined(o) {
+    return typeof o === 'undefined';
+}
 /** Check if value is not `null` or `undefined`. */
 export const notNull = (x) => x != null;
 /** Returns `true` for objects without length or falsy values. */
 export const isEmpty = (x) => (len(x) === 0 ? true : !x);
+/** Check if value is a `RegExp` type */
+export const isRegExp = (x) => x instanceof RegExp;
 /** Check if value is a `Symbol` type */
 export const isSymbol = (x) => type(x) === 'symbol';
+/** Check if value is a `Set` type. */
+export const isSet = (x) => x instanceof Set;
+/** Check if value is a `Map` type. */
+export const isMap = (x) => x instanceof Map;
+/** Check if value is a `WeakSet` type. */
+export const isWeakSet = (x) => x instanceof WeakSet;
+/** Check if value is a `WeakMap` type. */
+export const isWeakMap = (x) => x instanceof WeakMap;
 /**
  * Returns the number of elements in a collection type.
  *
@@ -182,7 +205,7 @@ export function len(value) {
     if (isNumber(value.length)) {
         return value.length;
     }
-    if (isFunc(value.size)) {
+    if (isFunction(value.size)) {
         return value.size();
     }
     if (isNumber(value.size)) {
@@ -229,7 +252,7 @@ export const uuid = () => {
  * @return `obj.key(...args)` or `undefined`.
  */
 export function call(obj, key, ...args) {
-    if (isFunc(get(key, obj))) {
+    if (isFunction(get(key, obj))) {
         return obj[key](...args);
     }
 }

package/core/globals/index.ts

@@ -142,15 +142,25 @@ export function type(value) {
  */
 export const str = (obj) => (obj != null ? obj.toString() : '')
 
+export function hasOwnProperty(obj, prop) {
+  return Object.prototype.hasOwnProperty.call(obj, prop)
+}
+
 /** Check if value is a boolean type. */
 export const isBool = (x): x is boolean => type(x) === 'boolean'
 
+/** Check if value is an `Error` type. */
+export const isError = (x): x is Error => x instanceof Error
+
 /** Check if value is an iterable type. */
 export const isIterable = (x): x is IterableIterator<any> => {
   if (x == null) return false
   return typeof x[Symbol.iterator] === 'function'
 }
 
+/** Check if value is a native `Date` type. */
+export const isDate = (x): x is Date => x instanceof Date
+
 /** Check if value is an object type. */
 export const isObject = (x): x is Object => typeof x === 'object' && type(x) === 'object'
 
@@ -169,12 +179,12 @@ export const isArrayLike = (x) => {
   return T === 'array' || (T === 'object' && isNumber(x.length))
 }
 
-/** Check if value is a function type. */
-export const isFunc = (x): x is Function => x?.constructor === Function
-
 /** Check if value is a number type. */
 export const isNumber = (x): x is number => type(x) === 'number'
 
+/** Check if value is an integer number type. */
+export const isInteger = (x): x is number => type(x) === 'number' && Math.floor(x) === x
+
 /** Check if value is a bigint type. */
 export const isBigint = (x): x is BigInt => type(x) === 'bigint'
 
@@ -184,8 +194,11 @@ export const isNaN = (x): x is typeof NaN => Number.isNaN(x)
 /** Check if value is a Promise type. */
 export const isPromise = (x): x is Promise<any> => type(x) === 'Promise'
 
+/** Check if value is a function type. */
+export const isFunction = (x): x is Function => x?.constructor === Function
+
 /** Check if value is an async function type. */
-export const isAsync = (x) => x?.constructor.name === 'AsyncFunction'
+export const isAsyncFunction = (x) => x?.constructor.name === 'AsyncFunction'
 
 /** Check if value is a generator function type. */
 export const isGenerator = (x): x is Generator => {
@@ -195,15 +208,35 @@ export const isGenerator = (x): x is Generator => {
 /** Check if value is `null` or `undefined`. */
 export const isNull = (x): x is null | undefined => x == null
 
+/** Check if value === `undefined`. */
+export function isUndefined(o) {
+  return typeof o === 'undefined'
+}
+
 /** Check if value is not `null` or `undefined`. */
 export const notNull = (x) => x != null
 
 /** Returns `true` for objects without length or falsy values. */
 export const isEmpty = (x) => (len(x) === 0 ? true : !x)
 
+/** Check if value is a `RegExp` type */
+export const isRegExp = (x): x is RegExp => x instanceof RegExp
+
 /** Check if value is a `Symbol` type */
 export const isSymbol = (x): x is symbol => type(x) === 'symbol'
 
+/** Check if value is a `Set` type. */
+export const isSet = <T>(x): x is Set<T> => x instanceof Set
+
+/** Check if value is a `Map` type. */
+export const isMap = <K, V>(x): x is Map<K, V> => x instanceof Map
+
+/** Check if value is a `WeakSet` type. */
+export const isWeakSet = <T extends object>(x): x is WeakSet<T> => x instanceof WeakSet
+
+/** Check if value is a `WeakMap` type. */
+export const isWeakMap = <K extends object, V>(x): x is WeakMap<K, V> => x instanceof WeakMap
+
 /**
  * Returns the number of elements in a collection type.
  *
@@ -217,7 +250,7 @@ export function len(value) {
   if (isNumber(value.length)) {
     return value.length
   }
-  if (isFunc(value.size)) {
+  if (isFunction(value.size)) {
     return value.size()
   }
   if (isNumber(value.size)) {
@@ -267,7 +300,7 @@ export const uuid = () => {
  * @return `obj.key(...args)` or `undefined`.
  */
 export function call(obj: any, key: PropertyKey, ...args: any[]) {
-  if (isFunc(get(key, obj))) {
+  if (isFunction(get(key, obj))) {
     return obj[key](...args)
   }
 }

package/core/i18n/date/format.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns a new Date from the given arguments.
+ * @param {string | number | Date} date The date value
+ * @param {?boolean} [utc=false] Interprets the given value as a UTC date
+ * @returns {Date} The new date object
+ */
+export declare function getDate(date: string | number | Date, utc?: boolean): Date;
+/**
+ * Formats a date using a formatting string in the {@link https://strftime.org/ strftime} format, in any given locale.
+ * @param {string} fmt The format string to apply
+ * @param {number | Date} date The date value
+ * @param {?string} locale The locale to use when formatting (default is system locale).
+ * @returns {string} The string representation of date
+ * @see {@link https://strftime.org/ strftime format}
+ */
+export declare function format(fmt: string, date: number | Date, locale?: any): string;