atomic-fns 1.1.5 → 1.1.7

package/README.md

@@ -17,7 +17,7 @@ You may prefer this library because:
 
 ## Docs
 
-📖 Available at [atomic-fns](atomic-stack.github.io/atomic-fns)
+📖 Available at [atomic-fns](https://atomic-stack.github.io/atomic-fns/)
 
 ## Get Started
 

package/dist/collections/Heap.d.ts

@@ -25,11 +25,11 @@ export declare class Heap<T> extends Collection {
     /**
      * Removes the top element.
      */
-    pop(): T;
+    pop(): T | undefined;
     /**
      * Accesses the top element.
      */
-    top(): T;
+    top(): T | undefined;
     /**
      * Check if element is in heap.
      * @param item The item want to find.

package/dist/collections/LRUCache.d.ts

@@ -35,7 +35,7 @@ export declare class LRUCache<K = any, V = any> extends Mapping<K, V> {
      * @param {K} key
      * @returns {?V} The associated value or `undefined`
      */
-    get(key: K): V;
+    get(key: K): V | undefined;
     /**
      * Removes all keys and values from the cache.
      * @returns {this}
@@ -52,7 +52,7 @@ export declare class LRUCache<K = any, V = any> extends Mapping<K, V> {
      * @param {K} key
      * @returns {?V} The value if it was removed or `undefined`.
      */
-    remove(key: K): V;
+    remove(key: K): V | undefined;
     /**
      * Returns the total number of elements in the cache.
      */

package/dist/collections/SortedMap.d.ts

@@ -24,24 +24,24 @@ export declare class SortedMap<K, V> extends Mapping<K, V> {
      * @param {K} key
      * @returns {?V} The key value or `undefined`.
      */
-    get(key: K): any;
+    get(key: K): V | undefined;
     /**
      * Sets the value for the given `key`.
      * @param {K} key
      * @param {V} value
      * @returns {this} Returns the Map object.
      */
-    set(key: K, value: V): void;
+    set(key: K, value: V): this;
     /**
      * Returns the smallest key in the tree.
      * @returns {?K}
      */
-    min(): K;
+    min(): K | undefined;
     /**
      * Returns the largest key in the tree.
      * @returns {?K}
      */
-    max(): K;
+    max(): K | undefined;
     /**
      * Returns `true` if the `key` existed in the map and was removed.
      * @param {K} key

package/dist/collections/SortedMap.js

@@ -46,7 +46,8 @@ export class SortedMap extends Mapping {
      * @returns {this} Returns the Map object.
      */
     set(key, value) {
-        return this.store.set(key, value);
+        this.store.set(key, value);
+        return this;
     }
     /**
      * Returns the smallest key in the tree.

package/dist/collections/SortedSet.d.ts

@@ -23,12 +23,12 @@ export declare class SortedSet<T> extends Collection {
      * Returns the smallest value in the set.
      * @returns {?T}
      */
-    min(): T;
+    min(): T | undefined;
     /**
      * Returns the largest value in the set.
      * @returns {?T}
      */
-    max(): T;
+    max(): T | undefined;
     /**
      * Removes the value from the set and returns `true` if the value was found and removed.
      * @param {T} value

package/dist/collections/SortedTree.d.ts

@@ -25,7 +25,7 @@ export declare class SortedTree<K, V> extends Mapping<K, V> {
      * @param {K} key
      * @returns {?V} The key value or `undefined`.
      */
-    get(key: K): V;
+    get(key: K): V | undefined;
     /**
      * Sets the value for the given `key`.
      * @param {K} key
@@ -37,12 +37,12 @@ export declare class SortedTree<K, V> extends Mapping<K, V> {
      * Returns the smallest key in the tree.
      * @returns {?K}
      */
-    min(): K;
+    min(): K | undefined;
     /**
      * Returns the largest key in the tree.
      * @returns {?K}
      */
-    max(): K;
+    max(): K | undefined;
     /**
      * Returns `true` if the `key` existed in the tree and was removed.
      * @param {K} key
@@ -60,7 +60,7 @@ export declare class SortedTree<K, V> extends Mapping<K, V> {
     freeze(): this;
     /**
      * Returns a new iterator of `[K, V]` pairs in reverse order of keys.
-     * @returns {Iterable<[K, V]>}
+     * @returns {IterableIterator<[K, V]>}
      */
     reversed(): IterableIterator<[K, V]>;
     /**
@@ -87,17 +87,17 @@ export declare class SortedTree<K, V> extends Mapping<K, V> {
     has(key: K): boolean;
     /**
      * Returns a new iterator of all **ordered** keys in the tree.
-     * @returns {Iterable<K>}
+     * @returns {IterableIterator<K>}
      */
     keys(): IterableIterator<K>;
     /**
      * Returns a new iterator of all values **ordered** by their keys.
-     * @returns {Iterable<V>}
+     * @returns {IterableIterator<V>}
      */
     values(): IterableIterator<V>;
     /**
      * Returns a new iterator of all key value pairs **ordered** by their keys.
-     * @returns {Iterable<[K, V]>}
+     * @returns {IterableIterator<[K, V]>}
      */
     entries(): IterableIterator<[K, V]>;
 }

package/dist/collections/SortedTree.js

@@ -82,7 +82,7 @@ export class SortedTree extends Mapping {
     }
     /**
      * Returns a new iterator of `[K, V]` pairs in reverse order of keys.
-     * @returns {Iterable<[K, V]>}
+     * @returns {IterableIterator<[K, V]>}
      */
     reversed() {
         return this.store.reversed();
@@ -119,21 +119,21 @@ export class SortedTree extends Mapping {
     }
     /**
      * Returns a new iterator of all **ordered** keys in the tree.
-     * @returns {Iterable<K>}
+     * @returns {IterableIterator<K>}
      */
     keys() {
         return this.store.keys();
     }
     /**
      * Returns a new iterator of all values **ordered** by their keys.
-     * @returns {Iterable<V>}
+     * @returns {IterableIterator<V>}
      */
     values() {
         return this.store.values();
     }
     /**
      * Returns a new iterator of all key value pairs **ordered** by their keys.
-     * @returns {Iterable<[K, V]>}
+     * @returns {IterableIterator<[K, V]>}
      */
     entries() {
         return this.store.entries();

package/dist/collections/SplayTree.d.ts

@@ -10,7 +10,7 @@ declare class Node<K = any, V = any> {
     left?: Node<K, V>;
     right?: Node<K, V>;
     constructor(key: K, value: V);
-    get height(): any;
+    get height(): number;
 }
 /**
  * A splay tree is a *self-balancing binary* search tree with the additional property that recently accessed elements are quick to access again.
@@ -31,16 +31,16 @@ export declare class SplayTree<K, V = any> extends Mapping<K, V> {
      * @param p When an element is accessed, with probability `p` splay the tree. With probability `1 - p`, leave the tree as it is.
      */
     constructor(compareFn?: any, p?: number);
-    top(): K;
+    top(): K | undefined;
     get size(): number;
     empty(): boolean;
-    get height(): any;
+    get height(): number;
     /**
      *  Returns the value for `key` or `undefined` if the key is not found.
      * @param key The key to find.
      * @returns {?V} The value for the key or `undefined`.
      */
-    get(key: K): any;
+    get(key: K): V | undefined;
     /**
      * Inserts the `key` and `value` in the tree if the `key` does not exist.
      * @param {K} key A key which can be any comparable value
@@ -51,25 +51,25 @@ export declare class SplayTree<K, V = any> extends Mapping<K, V> {
     /**
      * Removes a specified key if it exists in the tree. The removed value is returned or `undefined` if not found.
      * @param {K} key The key to remove.
-     * @returns {V} The removed value associated with `key`.
+     * @returns {?V} The removed value associated with `key`.
      */
-    remove(key: K): V;
+    remove(key: K): V | undefined;
     /**
      * Returns the minimum key in the tree or subtree.
      * @returns The minimum key.
      */
-    min(root?: Node<K, V>): K;
+    min(root?: Node<K, V>): K | undefined;
     /**
      * Returns the maximum key in the tree or subtree.
      * @returns The maximum key.
      */
-    max(root?: Node<K, V>): K;
+    max(root?: Node<K, V>): K | undefined;
     /**
      * Returns the largest key that is less than a given key.
      * @param key The given key
-     * @returns The largest key found or `undefined`.
+     * @returns {?K} The largest key found or `undefined`.
      */
-    lowerBound(key: any): K | Node<K, V>;
+    lowerBound(key: any): K | undefined;
     /**
      * This is the simplified top-down splaying method proposed by Sleator and Tarjan in {@link https://doi.org/10.1145%2F3828.3835 Self-Adjusting Binary Search Trees}.
      * @param key

package/dist/collections/SplayTree.js

@@ -140,7 +140,7 @@ export class SplayTree extends Mapping {
     /**
      * Removes a specified key if it exists in the tree. The removed value is returned or `undefined` if not found.
      * @param {K} key The key to remove.
-     * @returns {V} The removed value associated with `key`.
+     * @returns {?V} The removed value associated with `key`.
      */
     remove(key) {
         if (!this.root) {
@@ -203,7 +203,7 @@ export class SplayTree extends Mapping {
     /**
      * Returns the largest key that is less than a given key.
      * @param key The given key
-     * @returns The largest key found or `undefined`.
+     * @returns {?K} The largest key found or `undefined`.
      */
     lowerBound(key) {
         if (!this.root)
@@ -214,7 +214,7 @@ export class SplayTree extends Mapping {
         // Now the result is either the root node or the greatest node in
         // the left subtree.
         if (this.cmp(this.root.key, key) < 0) {
-            return this.root;
+            return this.root.key;
         }
         else if (this.root.left) {
             return this.max(this.root.left);

package/dist/collections/Trie.d.ts

@@ -25,7 +25,7 @@ export declare class Trie extends Collection {
      * @param word A prefix string
      * @param {number} [limit=20] The number of results to return.
      */
-    matches: (word: string, limit?: number) => Generator<any, void, any>;
+    matches: (word: string, limit?: number) => Generator<string>;
     /**
      * Returns `true` if the given string is found in the tree.
      * @param {string} word

package/dist/collections/deque.d.ts

@@ -44,28 +44,28 @@ export declare class Deque<T = any> extends Sequence<T> {
      * Removes and returns the element at the end of the deque.
      * @returns {?T} Returns the popped item.
      */
-    pop(): T;
+    pop(): T | undefined;
     /**
      * Alias of {@link Deque.pop}
      * @returns {?T} Returns the popped item.
      */
-    remove(): T;
+    remove(): T | undefined;
     /**
      * Removes and returns the element at the beginning of the deque.
      * @returns {?T} Returns the removed deque element.
      */
-    popleft(): T;
+    popleft(): T | undefined;
     /**
      * Returns the element at the beginning of the deque.
      * @returns {?T} The element if exists
      */
-    first(): T;
+    first(): T | undefined;
     /**
      * Returns the element at a specified index position in the deque.
      * @param {number} index The given index
      * @returns {?T} The element if exists
      */
-    get(index: any): T;
+    get(index: any): T | undefined;
     /**
      * Update the element at a given `index`.
      * @param {number} index The given index
@@ -82,7 +82,7 @@ export declare class Deque<T = any> extends Sequence<T> {
      * @param {Iteratee<T>} iteratee A function that will be invoked per element
      * @returns {?T} The element if exists
      */
-    find(iteratee: Iteratee<T>): T;
+    find(iteratee: Iteratee<T>): T | undefined;
     /**
      * Calls `iteratee` function for every element in the deque.
      * @param {Iteratee<T>} iteratee A function that will be invoked per element
@@ -92,12 +92,12 @@ export declare class Deque<T = any> extends Sequence<T> {
      * Returns a new array with all the elements in reverse order.
      * @returns {Array<T>} The elements reversed
      */
-    reversed(): any;
+    reversed(): T[];
     /**
      * Returns a new array with all the elements in the order they were added to the deque.
      * @returns {Array<T>} The elements array
      */
-    toArray(): any;
+    toArray(): T[];
     /**
      * Returns an iterator over the deque's values.
      * @returns {Iterator}
@@ -111,7 +111,7 @@ export declare class Deque<T = any> extends Sequence<T> {
      * Creates an iterator of `[index, value]` pairs for all elements in the deque.
      * @returns {Iterator}
      */
-    entries(): Iterable<[number, T]> & Iterator<[number, T], any, undefined>;
+    entries(): Iterable<[number, T]>;
     [Symbol.iterator](): Iterable<T>;
-    inspect(): any;
+    inspect(): T[];
 }

package/dist/collections/index.d.ts

@@ -86,7 +86,7 @@ let users = [
   { 'user': 'pebbles', 'age': 1,  'active': true }
 ]
 
-find(users, (o) => o.age < 40)
+find(users, o => o.age < 40)
 // object for 'barney'
 
 // The shape iteratee shorthand.
@@ -142,12 +142,14 @@ export declare function matches(shape: any): (obj: any) => boolean;
 forEach([1, 2], (value) => {
   console.log(value)
 })
-// Logs `1` then `2`.
+// 1
+// 2
 
 forEach({ 'a': 1, 'b': 2 }, (value, key) => {
   console.log(key)
 })
-// Logs 'a' then 'b' (iteration order is not guaranteed).
+// 'a'
+// 'b'
 ```
  * @param {Array|Object} collection The collection to iterate over.
  * @param {Iteratee} fn The function invoked per iteration.
@@ -162,8 +164,8 @@ export declare function forEach<T>(collection: Object, fn: Iteratee<T>): void;
  * This method is like {@link find} except that it iterates from right to left.
  * @example
 ```js
-findLast([1, 2, 3, 4], (n) => n % 2 === 1)
-//  => 3
+findLast([1, 2, 3, 4], n => n % 2 === 1)
+//  3
 ```
  * @param {Array} arr The collection to iterate over.
  * @param {Function} fn The function invoked per iteration.
@@ -179,10 +181,9 @@ export declare function findLast<T>(arr: Object, fn: Object): T | undefined;
 
  * @example
 ```js
-forEachRight([1, 2], (value) => {
-  console.log(value)
-})
-// Logs `2` then `1`.
+forEachRight([1, 2], console.log)
+// 2
+// 1
 ```
  * @param {Array|Object} collection The collection to iterate over.
  * @param {Iteratee} fn The function invoked per iteration.
@@ -276,7 +277,7 @@ let object = { a: 1, b: '2', c: 3 }
 pick(object, ['a', 'c'])
 // { a: 1, c: 3 }
 
-pick(object, (x) => isNumber(x))
+pick(object, x => isNumber(x))
 // { a: 1, c: 3 }
 ```
  *
@@ -293,7 +294,7 @@ let object = { 'a': 1, 'b': '2', 'c': 3 }
 omit(object, ['a', 'c'])
 // { 'b': '2' }
 
-omit(object, (x) => isNumber(x))
+omit(object, x => isNumber(x))
 // { 'b': '2' }
 ```
  * @param {Object} obj The source object.
@@ -317,7 +318,7 @@ let users = [
   { 'user': 'pebbles', 'active': true }
 ]
 
-findIndex(users, (o) => o.user == 'barney')
+findIndex(users, o => o.user == 'barney')
 // 0
 
 // The `shape` iteratee shorthand.
@@ -368,7 +369,7 @@ let users = [
   { 'user': 'pebbles', 'active': false }
 ]
 
-findLastIndex(users, (o) => o.user == 'pebbles')
+findLastIndex(users, o => o.user == 'pebbles')
 // 2
 
 // The `shape` iteratee shorthand.
@@ -512,7 +513,7 @@ export declare function defaults(object: Object, ...sources: Object[]): Object;
  * @see {@link union}
  * @see {@link intersection}
  */
-export declare function difference<T>(...args: Array<Iterable<T>>): Generator<T, void, unknown>;
+export declare function difference<T>(...args: Array<Iterable<T>>): Generator<T>;
 /**
  * Creates a generator of unique values that are included in all given arrays.
  * @param args The arrays to inspect
@@ -524,7 +525,7 @@ export declare function difference<T>(...args: Array<Iterable<T>>): Generator<T,
 * @see {@link difference}
  * @see {@link union}
  */
-export declare function intersection<T>(...args: Array<Iterable<T>>): Generator<T, void, unknown>;
+export declare function intersection<T>(...args: Array<Iterable<T>>): Generator<T>;
 /**
  * Creates a generator of unique values from all given arrays using `Set` for equality comparisons.
  * @param args The arrays to perform union on.
@@ -536,7 +537,7 @@ export declare function intersection<T>(...args: Array<Iterable<T>>): Generator<
  * @see {@link difference}
  * @see {@link intersection}
  */
-export declare function union<T>(...args: Array<Iterable<T>>): Generator<T, void, unknown>;
+export declare function union<T>(...args: Array<Iterable<T>>): Generator<T>;
 /**
  * Creates an object composed of keys generated from the results of running each element of `arr` thru `func`. The order of grouped values is determined by the order they occur in `arr`. The corresponding value of each key is an array of elements responsible for generating the key.
  *

package/dist/decimal/index.d.ts

@@ -79,7 +79,7 @@ export declare class Decimal {
   ```
      * @returns {Decimal}
      */
-    div(x: any): Decimal;
+    div(x: Decimal | string | number): Decimal;
     /**
      * Returns the square root of this `Decimal`.
      * @returns {TDecimal}
@@ -97,7 +97,6 @@ export declare class Decimal {
     private _truncate;
     /**
      * Returns a string representation of this decimal.
-     * @returns {Decimal}
      */
     toString(): string;
     /**
@@ -127,7 +126,7 @@ export declare class Decimal {
      * @param {*} x
      * @returns {number}
      */
-    compare(x: any): 1 | -1 | 0;
+    compare(x: any): 0 | 1 | -1;
     /**
      * Returns `true` if this value is greater than the value of `x`, otherwise `false`.
      * @param {*} x

package/dist/decimal/index.js

@@ -264,7 +264,6 @@ export class Decimal {
     }
     /**
      * Returns a string representation of this decimal.
-     * @returns {Decimal}
      */
     toString() {
         let s = this.i.toString();

package/dist/functools/index.d.ts

@@ -12,13 +12,13 @@ import { Function } from '../globals/index.js';
  * @returns {Function} Returns the new bound function.
  * @see {@link partial}
  */
-export declare function bind(fn: Function, thisArg: any, ...partials: any[]): any;
+export declare function bind(fn: Function, thisArg: any, ...partials: any[]): Function;
 /**
  * Creates a function that accepts arguments of `func` and either invokes `func` returning its result, if at least arity number of arguments have been provided, or returns a function that accepts the remaining `func` arguments, and so on. The arity of `func` may be specified if `func.length` is not sufficient.
  * @param {Function} func The function to curry.
  * @returns Returns the new curried function.
  */
-export declare function curry(func: Function): (...args: any[]) => any;
+export declare function curry(func: Function): Function<ReturnType<typeof func>>;
 /**
  * Creates a function that invokes `fn` with partials prepended to the arguments it receives.
  * **Note:** The given function will have `this` bound to `undefined`. If using `this` inside `fn`, consider {@link bind} instead.
@@ -26,13 +26,13 @@ export declare function curry(func: Function): (...args: any[]) => any;
  * @param {...*} [args] The arguments to apply to `fn`.
  * @returns {Function} Returns the new partially applied function
  */
-export declare function partial(fn: any, ...args: any[]): any;
+export declare function partial(fn: Function, ...args: any[]): Function<ReturnType<typeof fn>>;
 /**
  * Creates a function composition from a given set of functions that will be each applied on the result of the previous one from left to right.
  * @param {...*} [args] The set of functions to apply.
  * @returns {Function} A new function that applies each given function on the result of the previous one.
  */
-export declare function flow(...args: any[]): (x: any) => any;
+export declare function flow(...args: Function[]): Function;
 /**
  * This is just an alias for the {@link flow} function.
  * @see {@link flow}
@@ -43,7 +43,7 @@ export declare const pipe: typeof flow;
  * @param {...*} [args] The set of functions to apply.
  * @returns {Function} A new function that applies each given function on the result of the previous step.
  */
-export declare function compose(...args: any[]): (x: any) => any;
+export declare function compose(...args: Function[]): Function;
 /**
  * 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.
  *

package/dist/functools/index.js

@@ -63,7 +63,7 @@ export const pipe = flow;
  * @returns {Function} A new function that applies each given function on the result of the previous step.
  */
 export function compose(...args) {
-    return flow(args.reverse());
+    return 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.

package/dist/globals/index.d.ts

@@ -76,7 +76,7 @@ export declare function type(value: any): string;
  * @returns `obj.toString()` or `''` if `obj` is `null` or `undefined`.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString | Object.toString }
  */
-export declare function str(obj: any): any;
+export declare function str(obj: any): string;
 /** Check if value is a boolean type. */
 export declare function isBool(x: any): x is boolean;
 /** Check if value is an `Error` type. */
@@ -170,7 +170,7 @@ export declare function uuid(): string;
  * @param {...any[]} args
  * @return `obj.key(...args)` or `undefined`.
  */
-export declare function call(obj: any, key: PropertyKey, ...args: any[]): any;
+export declare function call<T = any>(obj: any, key: PropertyKey, ...args: any[]): T;
 /** Convert number to unicode character */
 export declare function chr(x: number): string;
 /** Convert character to Unicode code point */
@@ -181,14 +181,14 @@ export declare function ord(x: string): number;
  * @returns The array of object keys.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/keys Object.keys()}
  */
-export declare function keys<T>(object: T): (keyof T)[];
+export declare function keys<T>(object: T): Array<keyof T>;
 /**
  * Returns an array of the own enumerable property values of `object`.
  * @param object The given object.
  * @returns The array of object keys.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/values Object.values()}
  */
-export declare function values(object: any): unknown[];
+export declare function values<T = any>(object: any): T[];
 /**
  * Check if a given property is present in a given object.
  * @param obj The object to check.

package/dist/globals/index.js

@@ -382,7 +382,7 @@ export function hash(obj) {
         return hashCode(obj);
     }
     if (typeof obj === 'object') {
-        if (get(HASH_KEY, obj) == null) {
+        if (get(HASH_KEY, obj) != null) {
             return obj[HASH_KEY];
         }
         obj[HASH_KEY] = uniqueId();

package/dist/i18n/currency.d.ts

@@ -8,17 +8,17 @@ export declare class Currency extends Decimal {
     private readonly numberFormat;
     private readonly options;
     constructor(amount: any, currency: string, locale?: string, opts?: Intl.NumberFormatOptions);
-    clone(n: any): Currency;
+    clone(n: Currency): Currency;
     negated(): Currency;
-    add(x: any): Currency;
-    sub(x: any): Currency;
-    div(x: any): Currency;
-    mul(x: any): Currency;
-    toDecimal(): any;
+    add(x: Currency | string): Currency;
+    sub(x: Currency | string): Currency;
+    div(x: Currency | Decimal | string | number): Currency;
+    mul(x: Currency | Decimal): Currency;
+    toDecimal(): Decimal;
     toString(): string;
     format(opts?: Intl.NumberFormatOptions, locale?: string): string;
     displayName(): string;
     accounting(): string;
     precision(digits?: number): string;
-    eq(x: any): any;
+    eq(x: any): boolean;
 }

package/dist/i18n/date/index.d.ts

@@ -3,8 +3,7 @@ import { asDate, formatDate, strftime } from '../format.js';
 import { DateObject, daysInMonth, daysInYear, isLeapYear, maxDate, minDate, weeksInYear } from './utils.js';
 export { asDate, daysInMonth, daysInYear, formatDate, isLeapYear, maxDate, minDate, strftime, weeksInYear };
 export { DateObject };
-export declare type DateInput = number | string | Date;
-export declare type DateLike = DateInput | IntlDate | DateObject;
+export declare type DateLike = number | string | Date | IntlDate | DateObject;
 /**
  * Creates a date tied to a given locale (default system locale) which can be formatted in that locale's language using the native {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl Intl Apis} directly or using a formatting string.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl Intl Apis}
@@ -15,7 +14,7 @@ export declare class IntlDate {
     intlRelativeFormat: Intl.RelativeTimeFormat;
     /** Parses the provided value as UTC date or returns the current UTC date. */
     static UTC(value?: DateLike, locale?: string): IntlDate;
-    /** Returns the current local date and time.*/
+    /** Returns the current local date and time. */
     static now(): IntlDate;
     /** Creates a new date from a Unix timestamp (seconds since the unix epoch) */
     static unix(seconds: number): IntlDate;
@@ -58,9 +57,9 @@ export declare class IntlDate {
     /** Gets the number of weeks in the current year, according to ISO weeks. */
     isoWeeksInYear(): number;
     /** Returns the current week of the year. */
-    week(): any;
+    week(): number;
     /** Returns the ISO week of the year. */
-    isoWeek(): any;
+    isoWeek(): number;
     /**
      * Returns a localized string representation of this date.
      * @param {Intl.DateTimeFormatOptions} opts The options to use for the format
@@ -193,7 +192,7 @@ export declare class IntlDate {
     static min(...args: any[]): any;
     inspect(): string;
 }
-export declare function addDuration(date: DateInput, duration: number | Duration | TDuration, exact?: boolean): Date;
+export declare function addDuration(date: number | string | Date, duration: number | Duration | TDuration, exact?: boolean): Date;
 /**
  * Subtract the specified years, months, weeks, days, hours, minutes and seconds from the given date.
  * @param date
@@ -201,4 +200,4 @@ export declare function addDuration(date: DateInput, duration: number | Duration
  * @param exact
  * @returns
  */
-export declare function subDuration(date: DateInput, duration: number | Duration | TDuration, exact?: boolean): Date;
+export declare function subDuration(date: number | string | Date, duration: number | Duration | TDuration, exact?: boolean): Date;

package/dist/i18n/date/index.js

@@ -17,7 +17,7 @@ export class IntlDate {
     static UTC(value, locale) {
         return new IntlDate(value, { utc: true, locale });
     }
-    /** Returns the current local date and time.*/
+    /** Returns the current local date and time. */
     static now() {
         return new IntlDate();
     }
@@ -308,7 +308,7 @@ export class IntlDate {
     compare(other) {
         if (!this.isValid())
             return 1;
-        let dt = new IntlDate(other);
+        const dt = new IntlDate(other);
         if (!dt.isValid())
             return -1;
         return this.getTime() - dt.getTime();
@@ -317,7 +317,7 @@ export class IntlDate {
         if (!this.isValid())
             return this;
         const normalized = normalizeObject(values, normalizeUnit);
-        let mixed = { ...this.toObject(), ...normalized };
+        const mixed = { ...this.toObject(), ...normalized };
         // if we didn't set the day but we ended up on an overflow date,
         // use the last day of the right month
         if (normalized.day === undefined) {
@@ -335,24 +335,24 @@ export class IntlDate {
         return this.relativeFormat.format(n, unit);
     }
     fromNow(unit = 'seconds') {
-        let diff = this.diff(new Date(), unit);
+        const diff = this.diff(new Date(), unit);
         return this.relativeTime(diff, unit);
     }
     from(other, unit = 'seconds') {
-        let diff = this.diff(other, unit);
+        const diff = this.diff(other, unit);
         return this.relativeTime(diff, unit);
     }
     toNow(unit = 'seconds') {
-        let diff = this.diff(new Date(), unit);
+        const diff = this.diff(new Date(), unit);
         return this.relativeTime(-diff, unit);
     }
     to(other, unit = 'seconds') {
-        let diff = this.diff(other, unit);
+        const diff = this.diff(other, unit);
         return this.relativeTime(-diff, unit);
     }
     diff(other, unit = 'milliseconds', exact = false) {
-        let dt = new IntlDate(other);
-        let dur = new Duration(this.getTime() - dt.getTime(), exact);
+        const dt = new IntlDate(other);
+        const dur = new Duration(this.getTime() - dt.getTime(), exact);
         let total = dur.total(unit);
         if (!exact)
             total = Math.trunc(total);
@@ -367,7 +367,8 @@ export class IntlDate {
     startOf(unit) {
         if (!this.isValid())
             return this;
-        const obj = {}, normalizedUnit = UNITS_PLURAL[unit.toLowerCase()];
+        const obj = {};
+        const normalizedUnit = UNITS_PLURAL[unit.toLowerCase()];
         switch (normalizedUnit) {
             case 'years':
                 obj.month = 1;
@@ -424,18 +425,18 @@ export class IntlDate {
 }
 // Check if the new offset is different because we crossed to DST
 function fixOffset(startDate, endDate) {
-    let startOffset = startDate.getTimezoneOffset();
-    let endOffset = endDate.getTimezoneOffset();
+    const startOffset = startDate.getTimezoneOffset();
+    const endOffset = endDate.getTimezoneOffset();
     if (startOffset === endOffset)
         return new Date(endDate);
-    let postoffset = (startOffset - endOffset) * 60 * 1000;
+    const postoffset = (startOffset - endOffset) * 60 * 1000;
     return new Date(+endDate + postoffset);
 }
 export function addDuration(date, duration, exact = false) {
     // Get the current offset of this date timezone
-    let newDate = new Date(date);
+    const newDate = new Date(date);
     // Get the number of ticks forward
-    let { values } = new Duration(duration, exact).normalize();
+    const { values } = new Duration(duration, exact).normalize();
     // Apply any time changes that may have happened
     for (const unit in values) {
         setDateUnit(newDate, unit, Math.floor(values[unit]));

package/dist/i18n/date/utils.d.ts

@@ -1,4 +1,4 @@
-export declare type DateObject = {
+export interface DateObject {
     year?: number;
     month?: number;
     day?: number;
@@ -7,7 +7,7 @@ export declare type DateObject = {
     minute?: number;
     second?: number;
     millisecond?: number;
-};
+}
 /**
  * Returns the minimum (most distant past) of the given date values.
  * @template T

package/dist/i18n/duration.d.ts

@@ -38,14 +38,14 @@ export declare class Duration {
      * @example Duration.fromObject({years: 2, days: 3}).get('days') // 3
      * @return {number}
      */
-    get(unit: any): any;
+    get(unit: string): number;
     add(duration: TDuration): Duration;
     /**
      * Make this Duration shorter by the specified amount. Return a newly-constructed Duration.
      * @param {Duration|Object|number} duration - The amount to subtract.
      * @return {Duration}
      */
-    subtract(duration: any): Duration;
+    subtract(duration: Duration | TDuration | number): Duration;
     /**
      * Return the negative of this Duration.
      * @example

package/dist/i18n/format.d.ts

@@ -22,5 +22,10 @@ export declare function formatDate(formatStr: string, date: Date, locale?: strin
  * @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}
+ * @example
+```js
+strftime('%A, %d/%m/%y', new Date())
+// 'Saturday, 01/02/2020'
+```
  */
 export declare function strftime(fmt: string, date: Date, locale?: string): string;

package/dist/i18n/format.js

@@ -2,14 +2,16 @@ const NATIVE_DATE = /^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[Tt\s]*(\d{1,2})?:?(\d
 const REGEX_PARSE = /^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[Tt\s]*(\d{1,2})?:?(\d{1,2})?:?(\d{1,2})?[.:]?(\d+)?$/;
 const REGEX_FORMAT = /\[([^\]]+)]|Y{1,4}|M{1,4}|Q|D{1,2}|d{1,4}|H{1,2}|h{1,2}|a|A|m{1,2}|s{1,2}|Z{1,2}|z{1,4}|N{1,4}|LTS?|L{1,4}|l{1,4}|x|X|SSS/g;
 const FORMAT_DEFAULT = 'YYYY-MM-DDTHH:mm:ssZ';
-const padStart = (string, length, pad) => String(string).padStart(length, pad);
-const padZoneStr = (instance) => {
+function padStart(string, length, pad) {
+    return String(string).padStart(length, pad);
+}
+function padZoneStr(instance) {
     const negMinutes = -instance.getTimezoneOffset();
     const minutes = Math.abs(negMinutes);
     const hourOffset = Math.floor(minutes / 60);
     const minuteOffset = minutes % 60;
     return `${negMinutes <= 0 ? '+' : '-'}${padStart(hourOffset, 2, '0')}:${padStart(minuteOffset, 2, '0')}`;
-};
+}
 /**
  * Returns a new Date from the given arguments.
  * @param {string | number | Date} date The date value
@@ -142,16 +144,20 @@ const TOKENS = {
 const HOUR_PARTS = { '%I': 1, '%-I': 1, '%K': 1, '%k': 1 };
 const ERA_PARTS = { '%n': 1, '%N': 1, '%nn': 1 };
 const TZ_PARTS = { '%ZZ': 1, '%-ZZ': 1, '%-z': 1, '%z': 1, '%-Z': 1, '%Z': 1 };
-const formatter = (locale, opts) => new Intl.DateTimeFormat(locale, opts);
-const formatHour = (h, maxLength) => String(h % 12 || 12).padStart(maxLength, '0');
-const formatMeridiem = (hour, isLowercase) => {
+function formatter(locale, opts) {
+    return new Intl.DateTimeFormat(locale, opts);
+}
+function formatHour(h, maxLength) {
+    return String(h % 12 || 12).padStart(maxLength, '0');
+}
+function formatMeridiem(hour, isLowercase) {
     const m = hour < 12 ? 'AM' : 'PM';
     return isLowercase ? m.toLowerCase() : m;
-};
-const formatPart = (locale, t, date) => {
+}
+function formatPart(locale, t, date) {
     const value = formatter(locale, TOKENS[t]).format(date);
     return value.split(/\s+/g).slice(1).join(' ');
-};
+}
 /**
  * Returns a localized string representation of this date, according to the given format string. Format codes use the same specification as {@link https://momentjs.com/docs/#/displaying/format/ moment}.
  * @param {string} str The format string to use
@@ -221,6 +227,11 @@ export function formatDate(formatStr, date, locale) {
  * @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}
+ * @example
+```js
+strftime('%A, %d/%m/%y', new Date())
+// 'Saturday, 01/02/2020'
+```
  */
 export function strftime(fmt, date, locale) {
     const results = [];

package/dist/itertools/index.d.ts

@@ -12,7 +12,7 @@ import { Function, Iteratee, Predicate } from '../types';
  * @param initial Optional initial value (defaults to the first element in iterable)
  * @returns A sequence of accumulated values
  */
-export declare function accumulate<T>(iterable: Iterable<T>, func?: typeof add, initial?: any): Generator<any, void, unknown>;
+export declare function accumulate<T>(iterable: Iterable<T>, func?: typeof add, initial?: any): Generator<T>;
 /**
  * Returns `true` when all of the items in iterable are truthy. An optional predicate function can be used to define what truthiness means for this specific collection.
  * @param iterable
@@ -26,7 +26,7 @@ all([0])
 all([1, 2, 3])
 // true
 
-all([2, 4, 6] => (n) => n > 1)
+all([2, 4, 6], n => n > 1)
 // true
 ```
 @see {@link any}
@@ -45,7 +45,7 @@ any([0])
 any([0, 1, null, undefined])
 // true
 
-any([1, 4, 5] => (n) => n % 2 === 0)
+any([1, 4, 5], n => n % 2 === 0)
 // true
 ```
 @see {@link all}
@@ -74,7 +74,7 @@ contains('abcd', 'bc')
  *
  * @see {@link collections.find}
  */
-export declare function contains(collection: Iterable<any>, value: any): any;
+export declare function contains(collection: Iterable<any>, value: any): boolean;
 /**
  * Returns a generator that drops elements from the iterable as long as the predicate is `true`; afterwards, returns every remaining element. Note, the generator does not produce any output until the predicate first becomes `false`.
  * @param iterable The iterable to inspect.
@@ -189,11 +189,11 @@ export declare function reduce<T>(iterable: Iterable<T>, reducer: (prev: T, valu
 export declare function reversed<T>(iterable: Iterable<T>): T[];
 /**
  * Creates a new sorted list from the elements in the array. This can be called many ways:
- *   - sorted([...], true) => reverse order
- *   - sorted([...], fn = (x) => any) => using a key fn
- *   - sorted([...], fn = (x) => any, true) => reverse order using key
- *   - sorted([...], false, (x, y) => number) => using custom compare
- *   - sorted([...], fn = (x) => any, true, (x, y) => number) => custom key, reverse and compare
+ *   - sorted([...], true) - reverse order
+ *   - sorted([...], fn = x => any) - using a key fn
+ *   - sorted([...], fn = x => any, true) - reverse order using key
+ *   - sorted([...], false, (x, y) => number) - using custom compare
+ *   - sorted([...], fn = x => any, true, (x, y) => number) - custom key, reverse and compare
  *
  * If `args` is an Object, returns the sorted keys.
  *
@@ -211,9 +211,9 @@ export declare function sorted<T>(args: T[], key: Function): T[];
 export declare function sorted<T>(args: T[], key: Function, reverse: boolean): T[];
 /**
  * Sort `args` in place. Can be called like this:
- *   - sort([...], true) => reverse order
- *   - sort([...], (x, y) => number) => using custom compare
- *   - sort([...], true, (x, y) => number) => reverse and using custom compare
+ *   - sort([...], true) - reverse order
+ *   - sort([...], (x, y) => number) - using custom compare
+ *   - sort([...], true, (x, y) => number) - reverse and using custom compare
  *
  * @param {any[]} args
  * @param {(boolean | Comparer)} [reverse]

package/dist/itertools/index.js

@@ -15,15 +15,15 @@ import { add, bool, compare, eq, id } from '../operators/index.js';
 export function* accumulate(iterable, func = add, initial) {
     const it = iter(iterable);
     let total = initial;
-    let head = it.next();
+    let current = it.next();
     if (initial == null)
-        total = head.value;
-    while (!head.done) {
+        total = current.value;
+    while (!current.done) {
         yield total;
-        head = it.next();
-        if (head.done)
+        current = it.next();
+        if (current.done)
             return;
-        total = func(total, head.value);
+        total = func(total, current.value);
     }
 }
 /**
@@ -39,7 +39,7 @@ all([0])
 all([1, 2, 3])
 // true
 
-all([2, 4, 6] => (n) => n > 1)
+all([2, 4, 6], n => n > 1)
 // true
 ```
 @see {@link any}
@@ -64,7 +64,7 @@ any([0])
 any([0, 1, null, undefined])
 // true
 
-any([1, 4, 5] => (n) => n % 2 === 0)
+any([1, 4, 5], n => n % 2 === 0)
 // true
 ```
 @see {@link all}

package/dist/math/index.d.ts

@@ -44,8 +44,8 @@ export declare function ceil(x: number): number;
  * @returns
  */
 export declare function divmod(x: number, y: number): [number, number];
-export declare function log2(x: any): number;
-export declare function logBase(x: any, y: any): number;
+export declare function log2(x: number): number;
+export declare function logBase(x: number, y: number): number;
 /**
  * Returns the smallest element in an iterable. The optional `key` argument specifies a transform on the elements before comparing them. If the elements in the iterable are objects that implement a custom `lt` method, this will be called to compare.
  * @param iterable The iterable to inspect.
@@ -72,7 +72,7 @@ export declare function max<T>(iterable: Iterable<T>, key?: Predicate<T>): T;
 ```js
 let objects = [{ 'n': 4 }, { 'n': 2 }, { 'n': 8 }, { 'n': 6 }]
 
-mean(objects, (o) => o.n)
+mean(objects, o => o.n)
 // 5
 ```
  */

package/dist/mod.d.ts

@@ -0,0 +1 @@
+export * from './index.js';

package/dist/mod.js

@@ -0,0 +1 @@
+export * from './index.js';

package/dist/operators/index.d.ts

@@ -3,8 +3,12 @@
  *
  * @module operators
  */
-/** This is the identity function. It always returns the same value that was passed in */
+/** @deprecated Use the `identity` function instead.
+ * @see {@link identity}
+ */
 export declare function id(x: any): any;
+/** This is the identity function. It always returns the same value that was passed in. */
+export declare const identity: <T>(x: T) => T;
 /**
  * Called to implement truth value testing.
  * @param x

package/dist/operators/index.js

@@ -4,10 +4,14 @@
  * @module operators
  */
 import { call, isObject } from '../globals/index.js';
-/** This is the identity function. It always returns the same value that was passed in */
+/** @deprecated Use the `identity` function instead.
+ * @see {@link identity}
+ */
 export function id(x) {
     return x;
 }
+/** This is the identity function. It always returns the same value that was passed in. */
+export const identity = (x) => x;
 /**
  * Called to implement truth value testing.
  * @param x

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomic-fns",
   "description": "Like Lodash, but for ESNext and with types. Stop shipping code built for browsers from 2015.",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "files": [
     "dist/*"
   ],