index.d.ts

/*!
 * V4Fire Core
 * https://github.com/V4Fire/Core
 *
 * Released under the MIT license
 * https://github.com/V4Fire/Core/blob/master/LICENSE
 */

/* eslint-disable max-lines, @typescript-eslint/unified-signatures */

/**
 * [[include:core/prelude/README.md]]
 * @packageDocumentation
 */

declare namespace TB {
	type Cast<X, Y> = X extends Y ? X : Y;

	type Type<A extends any, ID extends string> = A & {
		[K in 'symbol']: ID;
	};

	type Length<T extends any[]> = T['length'];

	type Head<T extends any[]> = T extends [infer H, ...any[]] ?
		H : never;

	type Tail<T extends any[]> = T extends [any, ...infer TT] ?
		TT : [];

	type HasTail<T extends any[]> = Length<T> extends 0 | 1 ?
		false : true;

	type Last<T extends any[]> = HasTail<T> extends true ?
		Last<Tail<T>> : Head<T>;

	type Prepend<E, T extends any[]> = [E, ...T];

	type Drop<N extends number, T extends any[], I extends any[] = []> = Length<I> extends N ?
		T : Drop<N, Tail<T>, Prepend<any, I>>;

	type Pos<I extends any[]> = Length<I>;

	type Next<I extends any[]> = Prepend<any, I>;
	type Prev<I extends any[]> = Tail<I>;

	type Reverse<T extends any[], R extends any[] = [], I extends any[] = []> = Pos<I> extends Length<T> ?
		R : Reverse<T, Prepend<T[Pos<I>], R>, Next<I>>;

	type Concat<T1 extends any[], T2 extends any[]> = Reverse<Cast<Reverse<T1>, any[]>, T2>;

	type Append<E, T extends any[]> = Concat<T, [E]>;

	type __ = Type<{}, 'x'>;

	type GapOf<T1 extends any[], T2 extends any[], TN extends any[], I extends any[]> =
		T1[Pos<I>] extends __ ? Append<T2[Pos<I>], TN> : TN;

	type GapsOf<T1 extends any[], T2 extends any[], TN extends any[] = [], I extends any[] = []> =
		Pos<I> extends Length<T1> ?
			Concat<TN, Cast<Drop<Pos<I>, T2>, any[]>> :
			GapsOf<T1, T2, Cast<GapOf<T1, T2, TN, I>, any[]>, Next<I>>;

	type PartialGaps<T extends any[]> = {
		[K in keyof T]?: T[K] | __;
	};

	type CleanedGaps<T extends any[]> = {
		[K in keyof T]: NonNullable<T[K]>;
	};

	type Gaps<T extends any[]> = CleanedGaps<PartialGaps<T>> extends [...infer A] ?
		A : never;

	type Curry<F extends ((...args: any) => any)> =
		<T extends any[]>(...args: Cast<T, Gaps<Parameters<F>>>) =>
			GapsOf<T, Parameters<F>> extends [any, ...any[]] ?
				Curry<(...args: Cast<GapsOf<T, Parameters<F>>, any[]>) => ReturnType<F>> :
				ReturnType<F>;
}

declare const DEBUG: boolean;
declare const IS_PROD: boolean;

declare const APP_NAME: string;
declare const API_URL: CanUndef<string>;
declare const LOCALE: Language;
declare const REGION: CanUndef<Region>;

type Language =
	'be' | 'en' | 'kk' |
	'ru' | 'tr' | 'tt' |
	'uk' | 'id' | 'uz' |
	'es' | 'de' | 'hy' |
	'ka' | 'ky' | 'sr' |
	'fr' | 'lv' | 'lt' |
	'ro' | 'fi' | 'az' |
	'zh' | 'he' | 'et' |
	'no' | 'sv' | 'pt' |
	'ar' | 'sw';

/**
 * ISO 3166-1
 * @see https://en.wikipedia.org/wiki/ISO_3166-1
 */
type Region =
	'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' |
	'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' |
	'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' |
	'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' |
	'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' |
	'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' |
	'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' |
	'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' |
	'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' |
	'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' |
	'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' |
	'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' |
	'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' |
	'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' |
	'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' |
	'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' |
	'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' |
	'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' |
	'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' |
	'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' |
	'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' |
	'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' |
	'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' |
	'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' |
	'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' |
	'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' |
	'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' |
	'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' |
	'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' |
	'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' |
	'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' |
	'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' |
	'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' |
	'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' |
	'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' |
	'YT' | 'ZA' | 'ZM' | 'ZW';

/**
 * Converts the specified unknown value to any
 * @param obj
 */
declare function Any(obj: any): any;

/**
 * STDERR wrapper
 * @param err
 */
declare function stderr(err: any): void;

/**
 * Creates a function to internationalize strings in an application based on the given locale and keyset.
 * Keyset allows you to share the same keys in different contexts.
 * For example, the key "Next" may have a different value in different components of the application, therefore,
 * we can use the name of the component as a keyset value.
 *
 * @param keysetNameOrNames - the name of keyset or array with names of keysets to use.
 *   If passed as an array, the priority of the cases will be arranged in the order of the elements,
 *   the first one will have the highest priority.
 *
 * @param [customLocale] - the locale used to search for translations (the default is taken from
 *   the application settings)
 */
declare function i18n(
	keysetNameOrNames: CanArray<string>, customLocale?: Language
): (key: string | TemplateStringsArray, params?: I18nParams) => string;

/**
 * Parameters for the internationalization function
 */
type I18nParams = {count?: number | StringPluralizationForms} & {
	[key: string]: string | number;
};

/**
 * String pluralization constants that can be used instead of numbers
 */
type StringPluralizationForms = 'one' | 'some' | 'many' | 'none';

declare function setImmediate(fn: AnyFunction): number;
declare function clearImmediate(id: number): void;

declare function structuredClone<T>(obj: T): T;

interface Headers {
	keys(): IterableIterator<string>;
	values(): IterableIterator<string>;
	entries(): IterableIterator<[string, string]>;
	[Symbol.iterator]: IterableIterator<[string, string]>;
}

type Primitive =
	string |
	symbol |
	number |
	bigint |
	boolean |
	undefined |
	null;

type JSONLikeValue =
	string |
	number |
	boolean |
	null |
	JSONLikeValue[] |
	Dictionary<JSONLikeValue>;

type CanPromise<T> = T | Promise<T>;
type CanPromiseLike<T> = T | PromiseLike<T>;
type CanArray<T> = T | T[];

type CanUndef<T> = T | undefined;
type Nullable<T> = T | null | undefined;

// eslint-disable-next-line @typescript-eslint/no-invalid-void-type
type CanVoid<T> = T | void;

type AnyToIgnore = any;
type AnyToBoolean = any;
interface AnyFunction<ARGS extends any[] = any[], R = any> extends Function {
	(...args: ARGS): R;
}

interface AnyOneArgFunction<ARG = any, R = any> extends Function {
	(arg: ARG): R;
}

type ClassConstructor<ARGS extends any[] = any[], R = any> = new (...args: ARGS) => R;

interface StrictDictionary<T = unknown> {
	[key: PropertyKey]: T;
}

interface Dictionary<T = unknown> {
	[key: PropertyKey]: CanUndef<T>;
}

interface Maybe<T = unknown> extends Promise<T> {
	readonly type: 'Maybe';
}

interface Either<T = unknown> extends Promise<T> {
	readonly type: 'Either';
}

type NewPromise<K, V> = K extends Maybe ?
	Maybe<V> : K extends Either ?
		Either<V> : Promise<V>;

type PromiseType<T> =
	T extends Maybe<infer V> ?
		NonNullable<V> : T extends Promise<infer V> ? V : T;

/**
 * Wraps the specified function to return a value as Promise
 *
 * @typeparam T - any function
 *
 * @example
 * ```typescript
 * type A = typeof () => null;
 *
 * // () => Promise<null>
 * type B = ReturnPromise<A>;
 * ```
 */
type ReturnPromise<T extends AnyFunction<any[], unknown>> = (...args: Parameters<T>) => Promise<ReturnType<T>>;

type DictionaryType<T extends Dictionary> = T extends Dictionary<infer V> ? NonNullable<V> : T;

type AnyIterable<T = unknown> = Iterable<T> | AsyncIterable<T>;

type IterableType<T extends Iterable<any> | AsyncIterable<any>> =
	T extends Iterable<infer V> ?
		V :
		T extends AsyncIterable<infer V> ? V : T;

/**
 * Creates an interface based on the specified type or interface but every property can be edited
 */
type Writable<T> = {
	-readonly [K in keyof T]: T[K];
};

/**
 * Overrides properties of the specified type or interface.
 * Don't use this helper if you simply extend one type from another, i.e. without overriding properties.
 *
 * @template T - original type
 * @template U - type with the overridden properties
 *
 * @example
 * ```typescript
 * type A = {
 *   x: number;
 *   y: number;
 * };
 *
 * // {x:number; y: string}
 * type B = Overwrite<A, {y: string}>;
 * ```
 */
type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;

/**
 * Returns a new non-abstract class from the specified abstract class where methods can have the default implementation.
 * The default implementations are taken from the static methods that match by names with the class's methods.
 *
 * @example
 * ```typescript
 * abstract class iFoo {
 *   static bar(self: object): string {
 *     return self.bla.toString();
 *   }
 *
 *   bar(): string {
 *     return Object.throw();
 *   }
 *
 *   abstract bar(): number;
 * }
 *
 * // class { bar(): string; }
 * Trait<typeof bFoo>
 * ```
 */
type Trait<C extends Function, I extends C['prototype'] = C['prototype']> = {
	[K in Extract<keyof C, keyof I>]: I[K];
};

/**
 * Returns a new function based on the specified with adding as the first parameter the passed object
 *
 * @example
 * ```typescript
 * // (self: bFoo, a: number) => string
 * AddSelf<(a: number) => string, bFoo>
 * ```
 */
type AddSelf<M extends Function, S extends object> = M extends (...args: infer A) => infer R ?
	(self: S, ...args: A) => R :
	never;

interface JSONCb {
	(key: string, value: unknown): unknown;
}

interface FastCloneOptions {
	/**
	 * Replacer function for `JSON.stringify`
	 * @see [[JSON.stringify]]
	 */
	replacer?: JSONCb;

	/**
	 * Reviver function for `JSON.parse`
	 * @see [[JSON.parse]]
	 */
	reviver?: JSONCb;

	/**
	 * If false the object freeze/seal state won't be copy
	 * @default `true`
	 */
	freezable?: boolean;
}

interface ObjectMixinOptions<V = unknown, K = unknown, D = unknown> {
	/**
	 * If true, then object properties are copied recursively.
	 * Also, this mode enables copying properties from a prototype.
	 *
	 * @default `false`
	 * @example
	 * ```js
	 * // {a: {c: 2}}
	 * Object.mixin({deep: false}, {a: {b: 1}}, {a: {c: 2}});
	 *
	 * // {a: {b: 1, c: 2}}
	 * Object.mixin({deep: true}, {a: {b: 1}}, {a: {c: 2}});
	 *
	 * // {a: {c: 2}}
	 * Object.mixin({deep: true}, {}, {__proto__: {a: {c: 2}}});
	 * ```
	 */
	deep?: boolean;

	/**
	 * Strategy to resolve collisions of properties when merging:
	 *   1. `'all'` - all properties are merged in spite of possible collisions (by default)
	 *   2. `'new'` - properties with collisions aren't merged
	 *   3. `'exist'` - properties without collisions aren't merged
	 *
	 * @default `'all'`
	 * @example
	 * ```js
	 * // {a: 2, b: 3}
	 * Object.mixin({propsToCopy: 'all'}, {a: 1}, {a: 2, b: 3});
	 *
	 * // {a: 1, b: 3}
	 * Object.mixin({propsToCopy: 'new'}, {a: 1}, {a: 2, b: 3});
	 *
	 * // {a: 2}
	 * Object.mixin({propsToCopy: 'exist'}, {a: 1}, {a: 2, b: 3});
	 * ```
	 */
	propsToCopy?: 'new' | 'exist' | 'all';

	/**
	 * Function to filter values that shouldn't be copied
	 *
	 * @param el - element value
	 * @param key - element key
	 * @param data - element container
	 *
	 * @example
	 * ```js
	 * // {a: 1, b: 2}
	 * Object.mixin({deep: true}, {a: 1}, {b: 2});
	 *
	 * // {a: 1}
	 * Object.mixin({deep: true, filter: (el, key) => key !== 'b'}, {a: 1}, {b: 2});
	 * ```
	 */
	filter?(el: V, key: K, data: D): AnyToBoolean;

	/**
	 * Function to filter values that support deep extending
	 * (works only with the `deep` mode)
	 *
	 * @param el - element value
	 * @param key - element key
	 * @param data - element container
	 *
	 * @example
	 * ```js
	 * // {a: {a: 1, b: 2}}
	 * Object.mixin({deep: true}, {a: {a: 1}}, {a: {b: 2}});
	 *
	 * // {a: {b: 2}}
	 * Object.mixin({deep: true, extendFilter: (el) => !el.b}, {a: {a: 1}}, {a: {b: 2}});
	 * ```
	 */
	extendFilter?(el: unknown, key: K, data: V): AnyToBoolean;

	/**
	 * If true, all properties with undefined value aren't copied
	 *
	 * @default `true`
	 * @example
	 * ```js
	 * // {a: 1}
	 * Object.mixin({skipUndefs: true}, {a: 1}, {a: undefined});
	 *
	 * // {a: undefined}
	 * Object.mixin({skipUndefs: false}, {a: 1}, {a: undefined});
	 * ```
	 */
	skipUndefs?: boolean;

	/**
	 * If true, the function will merge all object properties, but not only enumerable.
	 * Non-enumerable properties from a prototype are ignored.
	 *
	 * @default `false`
	 * @example
	 * ```js
	 * const obj = {a: 1};
	 *
	 * Object.defineProperty(obj, 'b', {value: 2});
	 *
	 * // {a: 1, b: 2}
	 * Object.mixin({withNonEnumerables: true}, {}, obj);
	 * ```
	 */
	withNonEnumerables?: boolean;

	/**
	 * Should or shouldn't copy property descriptors too.
	 * If passed `onlyAccessors`, the descriptor properties like `enumerable` or `configurable` are ignored.
	 *
	 * @default `false`
	 */
	withDescriptors?: boolean | 'onlyAccessors';

	/**
	 * If true, then merging preserve prototypes of properties
	 * (works only with the `deep` mode)
	 *
	 * @default `false`
	 * @example
	 * ```js
	 * const proto = {
	 *   a: {
	 *     b: 2
	 *   },
	 *
	 *   c: 3
	 * };
	 *
	 * const obj = Object.create(proto);
	 * Object.mixin({deep: true, withProto: false}, obj, {c: 2, a: {d: 4}});
	 *
	 * // 2
	 * // 4
	 * // 2
	 * // true
	 * // true
	 * console.log(
	 *   obj.c,
	 *   obj.a.d,
	 *   obj.a.b,
	 *   obj.a.hasOwnProperty('d'),
	 *   obj.a.hasOwnProperty('b')
	 * );
	 *
	 * const obj2 = Object.create(proto);
	 * Object.mixin({deep: true, withProto: true}, obj2, {c: 2, a: {d: 4}});
	 *
	 * // 2
	 * // 4
	 * // 2
	 * // true
	 * // false
	 * console.log(
	 *   obj2.c,
	 *   obj2.a.d,
	 *   obj2.a.b,
	 *   obj2.a.hasOwnProperty('d'),
	 *   obj2.a.hasOwnProperty('b')
	 * );
	 * ```
	 */
	withProto?: boolean;

	/**
	 * If true, then to merge two arrays will be used a concatenation strategy (works only with the `deep` mode).
	 * Also, the parameter can be passed as a function to concatenate arrays.
	 *
	 * @default `false`
	 * @example
	 * ```js
	 * // {a: [2]}
	 * Object.mixin({deep: true, concatArrays: false}, {a: [1]}, {a: [2]});
	 *
	 * // {a: [1, 2]}
	 * Object.mixin({deep: true, concatArrays: true}, {a: [1]}, {a: [2]});
	 *
	 * // {a: [1, 1, 2]}
	 * Object.mixin({deep: true, concatArrays: true}, {a: [1]}, {a: [1, 2]});
	 *
	 * // {a: [1, 2]}
	 * Object.mixin({deep: true, concatArrays: (a, b) => a.union(b)}, {a: [1]}, {a: [1, 2]});
	 * ```
	 */
	concatArrays?: boolean | ((a: unknown[], b: unknown[], key: K) => unknown[]);

	/**
	 * @deprecated
	 * @see [[ObjectMixinOptions.concatArrays]]
	 */
	concatArray?: boolean;

	/**
	 * @deprecated
	 * @see [[ObjectMixinOptions.concatArrays]]
	 */
	concatFn?(a: unknown[], b: unknown[], key: K): unknown[];

	/**
	 * @deprecated
	 * @see [[ObjectMixinOptions.propsToCopy]]
	 */
	onlyNew?: boolean | -1;

	/**
	 * @deprecated
	 * @see [[ObjectMixinOptions.propsToCopy]]
	 */
	traits?: boolean | -1;

	/**
	 * @deprecated
	 * @see [[ObjectMixinOptions.skipUndefs]]
	 */
	withUndef?: boolean;

	/**
	 * @deprecated
	 * @see [[ObjectMixinOptions.withDescriptors]]
	 */
	withDescriptor?: boolean;

	/**
	 * @deprecated
	 * @see [[ObjectMixinOptions.withDescriptors]]
	 */
	withAccessors?: boolean;
}

interface ObjectGetOptions {
	/**
	 * Character to declare the path
	 *
	 * @example
	 * ```js
	 * Object.get({a: {b: 1}}, 'a:b', {separator: ':'})
	 * ```
	 */
	separator?: string;
}

interface ObjectSetOptions extends ObjectGetOptions {
	/**
	 * If true, then a new value will be concatenated with the old
	 *
	 * @example
	 * ```js
	 * const obj = {a: {b: 1}};
	 * Object.set(obj, 'a.b', 2, {concat: true})
	 * console.log(obj); // [1, 2]
	 * ```
	 */
	concat?: boolean;

	/**
	 * Function to set a value
	 *
	 * @param obj
	 * @param key
	 * @param value
	 */
	setter?(obj: unknown, key: unknown, value: unknown);
}

interface ObjectForEachOptions {
	/**
	 * If true, then the callback function takes an element descriptor instead of a value
	 *
	 * @default `false`
	 * @example
	 * ```js
	 * Object.forEach({a: 1}, {showDescriptor: true}, (el) => {
	 *   // {configurable: true, enumerable: true, writable: true, value: 1}
	 *   console.log(el);
	 * });
	 * ```
	 */
	passDescriptor?: boolean;

	/**
	 * Strategy to iterate object properties:
	 *   1. `'own'` - the object iterates only own properties (by default)
	 *   2. `'inherited'` - the object iterates only inherited properties
	 *     (for-in with the negative `hasOwnProperty` check)
	 *
	 *   3. `'all'` - the object iterates inherited properties too (for-in without the `hasOwnProperty` check)
	 *
	 * @example
	 * ```js
	 * const obj = {a: 1, __proto__: {b: 2}};
	 *
	 * Object.forEach(obj, (el) => {
	 *   console.log(el); // 1
	 * });
	 *
	 * Object.forEach(obj, {propsToIterate: 'all'}, (el) => {
	 *   console.log(el); // 1 2
	 * });
	 *
	 * Object.forEach(obj, {propsToIterate: 'inherited'}, (el) => {
	 *   console.log(el); // 2
	 * });
	 * ```
	 */
	propsToIterate?: 'own' | 'inherited' | 'all';

	/**
	 * If true, the function will iterate all object properties, but not only enumerable.
	 * Non-enumerable properties from a prototype are ignored.
	 *
	 * @default `false`
	 * @example
	 * ```js
	 * const obj = {a: 1};
	 *
	 * Object.defineProperty(obj, 'b', {value: 2});
	 *
	 * // 1
	 * // 2
	 * Object.forEach(obj, {withNonEnumerables: true}, (el) => {
	 *   console.log(el);
	 * });
	 * ```
	 */
	withNonEnumerables?: boolean;

	/**
	 * @deprecated
	 * @see [[ObjectForEachOptions.passDescriptor]]
	 */
	withDescriptor?: boolean;

	/**
	 * @deprecated
	 * @see [[ObjectForEachOptions.propsToIterate]]
	 */
	notOwn?: boolean | -1;
}

interface ObjectForEachPropertyDescriptor<V = unknown> {
	configurable?: boolean;
	enumerable?: boolean;
	value?: V;
	writable?: boolean;
	get?(): unknown;
	set?(v: unknown): void;
}

interface ObjectFromArrayOptions<T = boolean> {
	/**
	 * Function that returns a key value
	 *
	 * @param el - element value
	 * @param i - element index
	 */
	key?(el: unknown, i: number): PropertyKey;

	/**
	 * @deprecated
	 * @see [[ObjectFromArrayOptions.key]]
	 */
	keyConverter?(i: number, el: unknown): PropertyKey;

	/**
	 * Function that returns an element value
	 *
	 * @param el - element value
	 * @param i - element index
	 */
	value?(el: unknown, i: number): T;

	/**
	 * @deprecated
	 * @see [[ObjectFromArrayOptions.value]]
	 */
	valueConverter?(el: unknown, i: number): T;
}

type ObjectPropertyPath =
	string |
	any[];

interface ObjectPropertyFilter<K = string, V = unknown> {
	(key: K, el: V): AnyToBoolean;
}

interface ObjectConstructor {
	/**
	 * Returns a value from the passed object by the specified path.
	 * Returns undefined if the specified path doesn't exist in the object.
	 * The method can access properties through promises.
	 *
	 * @param obj
	 * @param path
	 * @param [opts] - additional options
	 */
	get<T = unknown>(obj: any, path: ObjectPropertyPath, opts?: ObjectGetOptions): CanUndef<T>;

	/**
	 * Returns a function that returns a value from the passed object, which the function takes, by the specified path.
	 * The function returns undefined if the specified path doesn't exist in the object.
	 *
	 * @param path
	 * @param [opts] - additional options
	 */
	get<T = unknown>(path: ObjectPropertyPath, opts?: ObjectGetOptions): (obj: any) => CanUndef<T>;

	/**
	 * Returns a function that returns a value from the specified object by a path that the function takes.
	 * The function returns undefined if the specified path doesn't exist in the object.
	 *
	 * @param obj
	 * @param [opts] - additional options
	 */
	get<T = unknown>(obj: any, opts?: ObjectGetOptions): (path: ObjectPropertyPath) => CanUndef<T>;

	/**
	 * Returns true if an object has a property by the specified path
	 *
	 * @param obj
	 * @param path
	 * @param [opts] - additional options
	 */
	has(obj: any, path: ObjectPropertyPath, opts?: ObjectGetOptions): boolean;

	/**
	 * Returns a function that returns true if an object, which the function takes, has a value by the specified path
	 *
	 * @param path
	 * @param [opts] - additional options
	 */
	has(path: ObjectPropertyPath, opts?: ObjectGetOptions): (obj: any) => boolean;

	/**
	 * Returns a function that returns true if the specified object has a value by a path that the function takes
	 *
	 * @param obj
	 * @param [opts] - additional options
	 */
	has(obj: any, opts?: ObjectGetOptions): (path: ObjectPropertyPath) => boolean;

	/**
	 * Returns a function that returns true if the passed object, which the function takes,
	 * has own property by the specified key
	 *
	 * @param key
	 */
	hasOwnProperty(key: PropertyKey): (obj: any) => boolean;

	/**
	 * Returns a function that returns true if the specified object has own property by a key that the function takes
	 * @param obj
	 */
	hasOwnProperty(obj: any): (key: PropertyKey) => boolean;

	/**
	 * Returns true if the passed object has an own property by the specified key
	 *
	 * @param obj
	 * @param key
	 */
	hasOwnProperty(obj: any, key: PropertyKey): boolean;

	/**
	 * Sets the passed symbol property to the given object.
	 * The character is set as non-enumerable to avoid implicit copying when using the spread operation.
	 *
	 * @param obj
	 * @param symbol
	 * @param value
	 * */
	defineSymbol<T>(obj: T, symbol: symbol, value: any): T;

	/**
	 * Sets a value to the passed object by the specified path.
	 * The final function returns a value that was added.
	 *
	 * @param obj
	 * @param path
	 * @param value
	 * @param [opts] - additional options
	 */
	set<T>(obj: any, path: ObjectPropertyPath, value: T, opts?: ObjectSetOptions): CanUndef<T>;

	/**
	 * Returns a function that sets a value to an object, which the function takes, by the specified path.
	 * The final function returns a link to the object.
	 *
	 * @param path
	 * @param [opts] - additional options
	 * @param [value]
	 */
	set(path: ObjectPropertyPath, opts?: ObjectSetOptions, value?: any): <T>(obj: T, value?: any) => CanUndef<T>;

	/**
	 * Returns a function that sets a value to the specified object by a path that the function takes.
	 * The final function returns a link to the object.
	 *
	 * @param obj
	 * @param [opts] - additional options
	 * @param [value]
	 */
	set<T>(obj: T, opts?: ObjectSetOptions, value?: any): (path: ObjectPropertyPath, value?: any) => CanUndef<T>;

	/**
	 * Deletes a value from an object by the specified path
	 *
	 * @param obj
	 * @param path
	 * @param [opts] - additional options
	 */
	delete(obj: any, path: ObjectPropertyPath, opts?: ObjectGetOptions): boolean;

	/**
	 * Returns a function that deletes a value from an object, which the function takes, by the specified path
	 *
	 * @param path
	 * @param [opts] - additional options
	 */
	delete(path: ObjectPropertyPath, opts?: ObjectGetOptions): (obj: any) => boolean;

	/**
	 * Returns a function that deletes a value from the specified object by a path that the function takes
	 *
	 * @param obj
	 * @param [opts] - additional options
	 */
	delete(obj: any, opts?: ObjectGetOptions): (path: ObjectPropertyPath) => boolean;

	/**
	 * Returns size/length of the specified object
	 *
	 * @param obj
	 *
	 * @example
	 * ```js
	 * // 1
	 * Object.size({a: 1});
	 *
	 * // 2
	 * Object.size([1, 2]);
	 *
	 * // 2
	 * Object.size(new Set([1, 2]));
	 *
	 * // 2
	 * Object.size((a, b) => a + b));
	 *
	 * // 1
	 * Object.size(1);
	 *
	 * // 0
	 * Object.size(NaN);
	 * Object.size(null);
	 * Object.size(undefined);
	 * ```
	 */
	size(obj: any): number;

	/**
	 * Returns true if size/length of the specified entity is 0.
	 * The algorithm for determining whether the entity is empty depends on the type of the entity.
	 *  - For Objects: The method counts the number of enumerable properties in the object. If the count is 0, the method considers the object as empty.
	 *  - For Arrays and Strings: The method uses the length property of the array or string. If the length is 0, the method considers the array or string as empty.
	 *  - For Maps and Sets: The method uses the size property of the map or set. If the size is 0, the method considers the map or set as empty.
	 *  - For Numbers: The method uses the value of the number. If the value is 0, the method considers the number as empty.
	 *
	 * @param obj
	 *
	 * @example
	 * ```js
	 * // true
	 * Object.isEmpty({});
	 *
	 * // false
	 * Object.isEmpty({a: 1});
	 *
	 * // true
	 * Object.isEmpty(new Set());
	 *
	 * // false
	 * Object.isEmpty(new Set([1, 2]));
	 *
	 * // false
	 * Object.isEmpty(1);
	 *
	 * // true
	 * Object.isEmpty(0);
	 * Object.isEmpty(NaN);
	 * Object.isEmpty(null);
	 * Object.isEmpty(undefined);
	 * ```
	 */
	isEmpty(obj: any): boolean;

	/**
	 * Iterates over the specified dictionary
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V>(
		obj: Dictionary<V>,
		opts: ObjectForEachOptions & {withDescriptors: true},
		cb: (el: ObjectForEachPropertyDescriptor<V>, key: string, data: Dictionary<V>) => any
	): void;

	/**
	 * Iterates over the specified dictionary
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V>(
		obj: Dictionary<V>,
		opts: ObjectForEachOptions & ({propsToIterate: 'all' | 'notOwn'} | {withDescriptors: false}),
		cb: (el: V, key: string, data: Dictionary<V>) => any
	): void;

	/**
	 * Iterates over the specified Map object
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V, K>(
		obj: Map<K, V>,
		opts: ObjectForEachOptions,
		cb: (el: V, key: K, data: Map<K, V>) => any
	): void;

	/**
	 * Iterates over the specified Map object
	 *
	 * @param obj - object to iterate
	 * @param cb - callback function that is called on each of object elements
	 * @param [opts] - additional options
	 */
	forEach<V, K>(
		obj: Map<K, V>,
		cb: (el: V, key: K, data: Map<K, V>) => any,
		opts?: ObjectForEachOptions
	): void;

	/**
	 * Iterates over the specified Set object
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V>(
		obj: Set<V>,
		opts: ObjectForEachOptions,
		cb: (el: V, i: V, data: Set<V>) => any
	): void;

	/**
	 * Iterates over the specified Set object
	 *
	 * @param obj - object to iterate
	 * @param cb - callback function that is called on each of object elements
	 * @param [opts] - additional options
	 */
	forEach<V>(
		obj: Set<V>,
		cb: (el: V, i: V, data: Set<V>) => any,
		opts?: ObjectForEachOptions
	): void;

	/**
	 * Iterates over the specified array
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V>(
		obj: V[],
		opts: ObjectForEachOptions,
		cb: (el: V, i: number, data: V[]) => any
	): void;

	/**
	 * Iterates over the specified array
	 *
	 * @param obj - object to iterate
	 * @param cb - callback function that is called on each of object elements
	 * @param [opts] - additional options
	 */
	forEach<V>(
		obj: V[],
		cb: (el: V, i: number, data: V[]) => any,
		opts?: ObjectForEachOptions
	): void;

	/**
	 * Iterates over the specified array-like object
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V>(
		obj: ArrayLike<V>,
		opts: ObjectForEachOptions,
		cb: (el: V, i: number, data: ArrayLike<V>) => any,
	): void;

	/**
	 * Iterates over the specified array-like object
	 *
	 * @param obj - object to iterate
	 * @param cb - callback function that is called on each of object elements
	 * @param [opts] - additional options
	 */
	forEach<V>(
		obj: ArrayLike<V>,
		cb: (el: V, i: number, data: ArrayLike<V>) => any,
		opts?: ObjectForEachOptions
	): void;

	/**
	 * Iterates over the specified iterable object
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V>(
		obj: Iterable<V>,
		opts: ObjectForEachOptions,
		cb: (el: V, key: null, data: Iterable<V>) => any
	): void;

	/**
	 * Iterates over the specified iterable object
	 *
	 * @param obj - object to iterate
	 * @param cb - callback function that is called on each of object elements
	 * @param [opts] - additional options
	 */
	forEach<V>(
		obj: Iterable<V>,
		cb: (el: V, key: null, data: Iterable<V>) => any,
		opts?: ObjectForEachOptions
	): void;

	/**
	 * Iterates over the specified object
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V>(
		obj: Dictionary<V>,
		opts: ObjectForEachOptions,
		cb: (el: V, key: string, data: Dictionary<V>) => any
	): void;

	/**
	 * Iterates over the specified object
	 *
	 * @param obj - object to iterate
	 * @param cb - callback function that is called on each of object elements
	 * @param [opts] - additional options
	 */
	forEach<V>(
		obj: Dictionary<V>,
		cb: (el: V, key: string, data: Dictionary<V>) => any,
		opts?: ObjectForEachOptions
	): void;

	/**
	 * Iterates over the specified object
	 *
	 * @param obj - object to iterate
	 * @param opts - additional options
	 * @param cb - callback function that is called on each of object elements
	 */
	forEach<V = unknown, K = unknown, D = any>(
		obj: D,
		opts: ObjectForEachOptions,
		cb: (el: V, key: K, data: D) => any
	): void;

	/**
	 * Iterates over the specified object
	 *
	 * @param obj - object to iterate
	 * @param cb - callback function that is called on each of object elements
	 * @param [opts] - additional options
	 */
	forEach<V = unknown, K = unknown, D = any>(
		obj: D,
		cb: (el: V, key: K, data: D) => any,
		opts?: ObjectForEachOptions
	): void;

	/**
	 * Returns a curried version of `Object.fastCompare` for one argument
	 * @param a
	 */
	fastCompare(a: any): (b: any) => boolean;

	/**
	 * Compares two specified objects by using a naive but fast `JSON.stringify/parse` strategy and
	 * returns true if they are equal.
	 *
	 * Mind, that this method uses non-stable version `JSON.stringify`, i.e.,
	 * it can work incorrectly with object like `{a: 1, b: 2}` and `{b: 2, a: 1}`.
	 *
	 * Be careful with comparing `undefined` and `NaN` values, as they can be converted to `null` due to
	 * the nature of `JSON.stringify`.
	 *
	 * @param a
	 * @param b
	 */
	fastCompare<T>(a: any, b: T): a is T;

	/**
	 * Returns a curried version of `Object.fastClone`
	 *
	 * @param obj
	 * @param opts - additional options
	 */
	fastClone(obj: undefined, opts: FastCloneOptions): <T>(obj: T) => T;

	/**
	 * Clones the specified object using the `structuredClone` method if possible and returns a new object.
	 * Otherwise, the method will use a naive but fast `JSON.stringify/parse` strategy.
	 *
	 * Be careful with cloning `undefined` and `NaN` values, as they can be converted to `null` due to
	 * the nature of `JSON.stringify/parse`.
	 *
	 * @param obj
	 * @param [opts] - additional options
	 */
	fastClone<T>(obj: T, opts?: FastCloneOptions): T;

	/**
	 * Returns a string representation of the specified object by using a naive but fast `JSON.stringify/parse` strategy.
	 *
	 * Mind, that this method uses non-stable version `JSON.stringify`, i.e.,
	 * it can work incorrectly with object like `{a: 1, b: 2}` and `{b: 2, a: 1}`.
	 *
	 * Be careful with comparing `undefined` and `NaN` values, as they can be converted to `null` due to
	 * the nature of `JSON.stringify`.
	 *
	 * @param obj
	 */
	fastHash(obj: any): string;

	/**
	 * Returns a curried version of `Object.mixin` for one argument
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 */
	mixin(opts: ObjectMixinOptions | boolean): <B, O1>(base: B, obj1: O1) => B & O1;

	/**
	 * Returns a curried version of `Object.mixin` for one argument
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 */
	mixin(opts: ObjectMixinOptions | boolean): <R = unknown>(...objects: any[]) => R;

	/**
	 * Returns a curried version of `Object.mixin` for two arguments
	 *
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 * @param target - target object
	 */
	mixin<B>(opts: ObjectMixinOptions | boolean, target: B): <O1>(obj1: O1) => B & O1;

	/**
	 * Returns a curried version of `Object.mixin` for two arguments
	 *
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 * @param target - target object
	 */
	mixin(opts: ObjectMixinOptions | boolean, target: any): <R = unknown>(...objects: any[]) => R;

	/**
	 * Extends the specified object by another objects.
	 * If the base value is not an object, a new object will be created with a type similar to the first extension object.
	 *
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 * @param target - target object
	 * @param obj1 - object for extending
	 */
	mixin<B, O1>(opts: ObjectMixinOptions | boolean, target: B, obj1: O1): B & O1;

	/**
	 * Extends the specified object by another objects.
	 * If the base value is not an object, a new object will be created with a type similar to the first extension object.
	 *
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 * @param target - target object
	 * @param obj1 - object for extending
	 * @param obj2 - object for extending
	 */
	mixin<B, O1, O2>(opts: ObjectMixinOptions | boolean, target: B, obj1: O1, obj2: O2): B & O1 & O2;

	/**
	 * Extends the specified object by another objects.
	 * If the base value is not an object, a new object will be created with a type similar to the first extension object.
	 *
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 * @param target - target object
	 * @param obj1 - object for extending
	 * @param obj2 - object for extending
	 * @param obj3 - object for extending
	 */
	mixin<B, O1, O2, O3>(opts: ObjectMixinOptions | boolean, target: B, obj1: O1, obj2: O2, obj3: O3): B & O1 & O2 & O3;

	/**
	 * Extends the specified object by another objects.
	 * If the base value is not an object, a new object will be created with a type similar to the first extension object.
	 *
	 * @param opts - if true, then properties will be copied recursively, or additional options to extend
	 * @param target - target object
	 * @param objects - objects for extending
	 */
	mixin<R = unknown>(opts: ObjectMixinOptions | boolean, target?: any, ...objects: any[]): R;

	/**
	 * Returns a curried version of `Object.serialize`
	 * @param replacer - replacer function to serialize
	 */
	trySerialize(replacer?: JSONCb): <V>(value: V) => string | V;

	/**
	 * Tries to serialize the specified value into a string.
	 *
	 * If the value is an array, dictionary, or string or has the predefined `toJSON` method, it is serialized using
	 * `JSON.stringify`. In other cases, the value isn't serialized and will be returned by the function.
	 * Also, in the case of error during serialization, the function returns the original value.
	 *
	 * @param value
	 * @param [replacer] - replacer function to serialize
	 */
	trySerialize<V>(value: V, replacer?: JSONCb): string | V;

	/**
	 * Returns a curried version of `Object.parse`
	 * @param reviver - reviver function to parse
	 */
	parse(reviver?: JSONCb): <V, R = unknown>(value: V) => V extends string ? R : V;

	/**
	 * Parses the specified value as a JSON/JS object and returns the result of parsing.
	 * If the value isn't a string or can't be parsed, the function returns the original value.
	 *
	 * @param value
	 * @param [reviver] - reviver function to parse
	 */
	parse<V, R = unknown>(value: V, reviver?: JSONCb): V extends string ? R : V;

	/**
	 * Creates a hash table without any prototype and returns it
	 *
	 * @example
	 * ```js
	 * Object.createDict() // {__proto__: null}
	 * ```
	 */
	createDict<V = unknown>(): Dictionary<V>;

	/**
	 * Creates a hash table without any prototype and returns it
	 *
	 * @param objects - extension objects:
	 *   all keys from these objects are merged to the target
	 *
	 * @example
	 * ```js
	 * Object.createDict({a: 1}, {b: 2}) // {a: 1, b: 2, __proto__: null}
	 * ```
	 */
	createDict<D extends object>(...objects: Array<Nullable<D>>): Pick<D, keyof D>;

	/**
	 * Takes the enum-like object and converts it to a dictionary:
	 * number values from the object are skipped
	 *
	 * @param obj
	 */
	convertEnumToDict<D extends object>(obj: Nullable<D>): {[K in keyof D]: K};

	/**
	 * Creates an object which has the similar structure to the TS enum and returns it
	 *
	 * @param obj - base object: it can be a dictionary or an array
	 * @example
	 * ```js
	 * Object.createEnumLike({a: 1}) // {a: 1, 1: 'a', __proto__: null}
	 * ```
	 */
	createEnumLike<D extends object, K extends keyof D>(obj: Nullable<D>):
		D extends Array<infer E> ? Dictionary<E | number> : D & {[I: string]: K};

	/**
	 * @deprecated
	 * @see ObjectConstructor.createEnumLike
	 */
	createMap<D extends object, K extends keyof D>(obj: Nullable<D>):
		D extends Array<infer E> ? Dictionary<E | number> : D & {[I: string]: K};

	/**
	 * Creates an object from the specified array
	 *
	 * @param arr
	 * @param [opts] - additional options
	 *
	 * @example
	 * ```js
	 * // {foo: true, bar: true}
	 * Object.fromArray(['foo', 'bar']);
	 *
	 * // {foo: 0, bar: 1}
	 * Object.fromArray(['foo', 'bar'], {value: (val, i) => i});
	 * ```
	 */
	fromArray<T>(arr: Nullable<any[]>, opts?: ObjectFromArrayOptions<T>): Dictionary<T>;

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - regular expression to filter by keys
	 */
	select(condition: RegExp | ObjectPropertyFilter): <D extends object>(obj: Nullable<D>) => {[K in keyof D]?: D[K]};

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - whitelist of keys to filter
	 */
	select(condition: []): <D extends object>(obj: D) => D;

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - whitelist of keys to filter
	 */
	select<C extends string>(condition: C | [C]): <D extends object>(obj: Nullable<D>) => Pick<D, Extract<keyof D, C>>;

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - whitelist of keys to filter
	 */
	select<
		C1 extends string,
		C2 extends string
	>(condition: [C1, C2]): <D extends object>(obj: Nullable<D>) => Pick<D, Extract<keyof D, C1 | C2>>;

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - whitelist of keys to filter
	 */
	select<
		C1 extends string,
		C2 extends string,
		C3 extends string,
	>(condition: [C1, C2, C3]): <D extends object>(obj: Nullable<D>) => Pick<D, Extract<keyof D, C1 | C2 | C3>>;

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - whitelist of keys to filter
	 */
	select<
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string
	>(condition: [C1, C2, C3, C4]): <D extends object>(obj: Nullable<D>) => Pick<D, Extract<keyof D, C1 | C2 | C3 | C4>>;

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - whitelist of keys to filter
	 */
	select<
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string,
		C5 extends string
	>(condition: [C1, C2, C3, C4, C5]): <D extends object>(obj: Nullable<D>) =>
		Pick<D, Extract<keyof D, C1 | C2 | C3 | C4 | C5>>;

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - whitelist of keys to filter
	 */
	select(condition: Iterable<any>): <D extends object>(obj: Nullable<D>) => {[K in keyof D]?: D[K]};

	/**
	 * Returns a curried version of `Object.select`
	 * @param condition - map of keys to filter
	 */
	select<C extends object>(condition: C): <D extends object>(obj: Nullable<D>) => Pick<D, Extract<keyof D, keyof C>>;

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - regular expression to filter by keys
	 */
	select<D extends object>(obj: Nullable<D>, condition: RegExp | ObjectPropertyFilter): {[K in keyof D]?: D[K]};

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	select<D extends object>(obj: Nullable<D>, condition: []): D;

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	select<D extends object, C extends string>(obj: Nullable<D>, condition: C | [C]): Pick<D, Extract<keyof D, C>>;

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	select<
		D extends object,
		C1 extends string,
		C2 extends string
	>(obj: Nullable<D>, condition: [C1, C2]): Pick<D, Extract<keyof D, C1 | C2>>;

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	select<
		D extends object,
		C1 extends string,
		C2 extends string,
		C3 extends string
	>(obj: Nullable<D>, condition: [C1, C2, C3]): Pick<D, Extract<keyof D, C1 | C2 | C3>>;

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	select<
		D extends object,
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string
	>(obj: Nullable<D>, condition: [C1, C2, C3, C4]): Pick<D, Extract<keyof D, C1 | C2 | C3 | C4>>;

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	select<
		D extends object,
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string,
		C5 extends string,
	>(obj: Nullable<D>, condition: [C1, C2, C3, C4, C5]): Pick<D, Extract<keyof D, C1 | C2 | C3 | C4 | C5>>;

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	select<D extends object>(obj: Nullable<D>, condition: Iterable<any>): {[K in keyof D]?: D[K]};

	/**
	 * Returns a new object based on the specified, but only with fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - map of keys to filter
	 */
	select<D extends object, C extends object>(obj: Nullable<D>, condition: C): Pick<D, Extract<keyof D, keyof C>>;

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - regular expression to filter by keys
	 */
	reject(condition: RegExp | ObjectPropertyFilter): <D extends object>(obj: Nullable<D>) => {[K in keyof D]?: D[K]};

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - whitelist of keys to filter
	 */
	reject<C>(condition: []): <D extends object>(obj: Nullable<D>) => D;

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - whitelist of keys to filter
	 */
	reject<C extends string>(condition: C | [C]): <D extends object>(obj: Nullable<D>) => Omit<D, C>;

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		C1 extends string,
		C2 extends string
	>(condition: [C1, C2]): <D extends object>(obj: Nullable<D>) => Omit<D, C1 | C2>;

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		C1 extends string,
		C2 extends string,
		C3 extends string
	>(condition: [C1, C2, C3]): <D extends object>(obj: Nullable<D>) => Omit<D, C1 | C2 | C3>;

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string
	>(condition: [C1, C2, C3, C4]): <D extends object>(obj: Nullable<D>) => Omit<D, C1 | C2 | C3 | C4>;

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string,
		C5 extends string
	>(condition: [C1, C2, C3, C4, C5]): <D extends object>(obj: Nullable<D>) => Omit<D, C1 | C2 | C3 | C4 | C5>;

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - whitelist of keys to filter
	 */
	reject(condition: Iterable<any>): <D extends object>(obj: Nullable<D>) => {[K in keyof D]?: D[K]};

	/**
	 * Returns a curried version of `Object.reject`
	 * @param condition - map of keys to filter
	 */
	reject<C extends object>(condition: C): <D extends object>(obj: Nullable<D>) => Omit<D, keyof C>;

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - regular expression to filter by keys
	 */
	reject<D extends object>(obj: Nullable<D>, condition: RegExp | ObjectPropertyFilter): {[K in keyof D]?: D[K]};

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	reject<D extends object>(obj: Nullable<D>, condition: []): D;

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	reject<D extends object, C extends string>(obj: Nullable<D>, condition: C | [C]): Omit<D, C>;

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		D extends object,
		C1 extends string,
		C2 extends string
	>(obj: Nullable<D>, condition: [C1, C2]): Omit<D, C1 | C2>;

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		D extends object,
		C1 extends string,
		C2 extends string,
		C3 extends string
	>(obj: Nullable<D>, condition: [C1, C2, C3]): Omit<D, C1 | C2 | C3>;

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		D extends object,
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string
	>(obj: Nullable<D>, condition: [C1, C2, C3, C4]): Omit<D, C1 | C2 | C3 | C4>;

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	reject<
		D extends object,
		C1 extends string,
		C2 extends string,
		C3 extends string,
		C4 extends string,
		C5 extends string
	>(obj: Nullable<D>, condition: [C1, C2, C3, C4, C5]): Omit<D, C1 | C2 | C3 | C4 | C5>;

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - whitelist of keys to filter
	 */
	reject<D extends object>(obj: Nullable<D>, condition: Iterable<any>): {[K in keyof D]?: D[K]};

	/**
	 * Returns a new object based on the specified, but without fields that match to the specified condition
	 *
	 * @param obj
	 * @param condition - map of keys to filter
	 */
	reject<D extends object, C extends object>(obj: Nullable<D>, condition: C): Omit<D, keyof C>;

	/**
	 * Wraps the specified value into the Either structure.
	 * If the value is equal to null or undefined, the value is rejected.
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * Object.Option(toLowerCase)(null).catch((err) => err === null);
	 * Object.Option(null).catch((err) => err === null);
	 *
	 * Object.Option(toLowerCase)('FOO').then((value) => value === 'foo');
	 * Object.Option('foo').then((value) => value === 'foo');
	 * ```
	 */
	Option<R>(value: () => R): AnyFunction<any[], Maybe<R>>;

	/**
	 * Wraps the specified value into the Either structure.
	 * If the value is equal to null or undefined, the value is rejected.
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * Object.Option(toLowerCase)(null).catch((err) => err === null);
	 * Object.Option(null).catch((err) => err === null);
	 *
	 * Object.Option(toLowerCase)('FOO').then((value) => value === 'foo');
	 * Object.Option('foo').then((value) => value === 'foo');
	 * ```
	 */
	Option<A1, A extends any[], R>(value: (a1: A1, ...rest: A) => R):
		(a1: Maybe<Nullable<A1>> | Either<A1> | Nullable<A1>, ...rest: A) => Maybe<R>;

	/**
	 * Wraps the specified value into the Either structure.
	 * If the value is equal to null or undefined, the value is rejected.
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * Object.Option(toLowerCase)(null).catch((err) => err === null);
	 * Object.Option(null).catch((err) => err === null);
	 *
	 * Object.Option(toLowerCase)('FOO').then((value) => value === 'foo');
	 * Object.Option('foo').then((value) => value === 'foo');
	 * ```
	 */
	Option<T = unknown>(value: T): Maybe<T>;

	/**
	 * Wraps the specified value into the Either structure
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * Object.Result(toLowerCase)(null).catch((err) => err.message === 'str is null');
	 * Object.Result(Object.result(toLowerCase)(null)).catch((err) => err.message === 'str is null');
	 *
	 * Object.Result(toLowerCase)('FOO').then((value) => value === 'foo');
	 * Object.Result('foo').then((value) => value === 'foo');
	 * ```
	 */
	Result<R>(value: () => R): AnyFunction<any[], Either<R>>;

	/**
	 * Wraps the specified value into the Either structure
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * Object.Result(toLowerCase)(null).catch((err) => err.message === 'str is null');
	 * Object.Result(Object.result(toLowerCase)(null)).catch((err) => err.message === 'str is null');
	 *
	 * Object.Result(toLowerCase)('FOO').then((value) => value === 'foo');
	 * Object.Result('foo').then((value) => value === 'foo');
	 * ```
	 */
	Result<A1, A extends any[], R>(value: (a1: A1, ...a: A) => R):
		(a1: Maybe<A1> | Either<A1>, ...rest: A) => Either<R>;

	/**
	 * Wraps the specified value into the Either structure
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * Object.Result(toLowerCase)(null).catch((err) => err.message === 'str is null');
	 * Object.Result(Object.result(toLowerCase)(null)).catch((err) => err.message === 'str is null');
	 *
	 * Object.Result(toLowerCase)('FOO').then((value) => value === 'foo');
	 * Object.Result('foo').then((value) => value === 'foo');
	 * ```
	 */
	Result<T = unknown>(value: T): Either<T>;

	/**
	 * Casts any value to the specified type
	 * @param value
	 */
	cast<T = unknown>(value: any): T;

	/**
	 * Throws an error.
	 * This method is useful because the `throw` operator can't be used within expressions.
	 *
	 * @param [err]
	 */
	throw(err?: string | Error): any;

	/**
	 * Returns true if the specified value can be interpreted as true
	 * @param value
	 */
	isTruly(value: any): boolean;

	/**
	 * Returns true if the specified value has a primitive type
	 * @param value
	 */
	isPrimitive(value: any): value is Primitive;

	/**
	 * Returns true if the specified value is undefined
	 * @param value
	 */
	isUndef(value: any): value is undefined;

	/**
	 * Returns true if the specified value is null
	 * @param value
	 */
	isNull(value: any): value is null;

	/**
	 * Returns true if the specified value is null or undefined
	 * @param value
	 */
	isNullable(value: any): value is null | undefined;

	/**
	 * Returns true if the specified value is a string
	 * @param value
	 */
	isString(value: any): value is string;

	/**
	 * Returns true if the specified value is a number
	 * @param value
	 */
	isNumber(value: any): value is number;

	/**
	 * Returns true if the specified value is a boolean
	 * @param value
	 */
	isBoolean(value: any): value is boolean;

	/**
	 * Returns true if the specified value is a symbol
	 * @param value
	 */
	isSymbol(value: any): value is symbol;

	/**
	 * Returns true if the specified value is a regular expression
	 * @param value
	 */
	isRegExp(value: any): value is RegExp;

	/**
	 * Returns true if the specified value is a date
	 * @param value
	 */
	isDate(value: any): value is Date;

	/**
	 * Returns true if the specified value is an array
	 * @param value
	 */
	isArray(value: any): value is unknown[];

	/**
	 * Returns true if the specified value is looks like an array
	 * @param value
	 */
	isArrayLike(value: any): value is ArrayLike<any>;

	/**
	 * Returns true if the specified value is a map
	 * @param value
	 */
	isMap(value: any): value is Map<unknown, unknown>;

	/**
	 * Returns true if the specified value is a weak map
	 * @param value
	 */
	isWeakMap(value: any): value is WeakMap<object, unknown>;

	/**
	 * Returns true if the specified value is a set
	 * @param value
	 */
	isSet(value: any): value is Set<unknown>;

	/**
	 * Returns true if the specified value is a weak set
	 * @param value
	 */
	isWeakSet(value: any): value is WeakSet<object>;

	/**
	 * Returns true if the specified value is a dictionary.
	 * This method is similar to "isPlainObject", but it has another output TS type:
	 * instead of inferring of an output type the method always cast the type to a dictionary.
	 *
	 * @param value
	 *
	 * @example
	 * ```typescript
	 * interface Foo {
	 *   bar(): number;
	 * }
	 *
	 * function foo(val: number | Foo) {
	 *   if (Object.isPlainObject(val)) {
	 *     val.bar(); // All fine
	 *   }
	 *
	 *   if (Object.isDictionary(val)) {
	 *     val.bar(); // Warning: object is of type unknown
	 *   }
	 * }
	 * ```
	 */
	isDictionary(value: any): value is Dictionary;

	/**
	 * Returns true if the specified value is a plain object,
	 * i.e. it has `null` prototype or was constructed via `Object`
	 *
	 * @param obj
	 */
	isPlainObject<T>(obj: T): obj is
		// @ts-ignore (unsafe type cast)
		T extends
			any[] |

			Int8Array |
			Int16Array |
			Int32Array |

			Uint8Array |
			Uint8ClampedArray |
			Uint16Array |
			Uint32Array |

			Float32Array |
			Float64Array |

			ArrayBuffer |
			SharedArrayBuffer |
			DataView |
			FormData |
			Blob |

			Date |
			RegExp |
			Map<any, any> |
			WeakMap<any, any> |
			Set<any> |
			WeakSet<any> |
			Promise<any> |

			Generator |
			AnyFunction |

			/* eslint-disable @typescript-eslint/ban-types */

			Number |
			String |
			Symbol |
			Boolean |

			/* eslint-enable @typescript-eslint/ban-types */

			Node |
			Document |
			Window |
			Navigator |
			Error |

			Intl.Collator |
			Intl.DateTimeFormat |
			Intl.NumberFormat

		? Dictionary : T extends object ? NonNullable<T> : Dictionary;

	/**
	 * Returns true if the specified value is a custom (not native) object or function
	 * @param value
	 */
	isCustomObject(value: any): boolean;

	/**
	 * Returns true if the specified value is a simple object (without a string type tag)
	 * @param value
	 */
	isSimpleObject<T extends object = object>(value: any): value is T;

	/**
	 * Returns true if the specified value is a function
	 * @param value
	 */
	isFunction(value: any): value is AnyFunction;

	/**
	 * Returns true if the specified value is a simple function.
	 * This method is similar to "isFunction", but it has another output TS type.
	 *
	 * @param value
	 */
	isSimpleFunction(value: any): value is Function;

	/**
	 * Returns true if the specified value is a generator function
	 * @param value
	 */
	isGenerator(value: any): value is GeneratorFunction;

	/**
	 * Returns true if the specified value is an async generator function
	 * @param value
	 */
	isAsyncGenerator(value: any): value is AsyncGeneratorFunction;

	/**
	 * Returns true if the specified value is an iterable structure
	 * @param value
	 */
	isIterable(value: any): value is Iterable<unknown>;

	/**
	 * Returns true if the specified value is an async iterable structure
	 * @param value
	 */
	isAsyncIterable(value: any): value is AsyncIterable<unknown>;

	/**
	 * Returns true if the specified value is an iterator
	 * @param value
	 */
	isIterator(value: any): value is Iterator<unknown>;

	/**
	 * Returns true if the specified value is an async iterator
	 * @param value
	 */
	isAsyncIterator(value: any): value is AsyncIterator<unknown>;

	/**
	 * Returns true if the specified value is a promise
	 * @param value
	 */
	isPromise(value: any): value is Promise<unknown>;

	/**
	 * Returns true if the specified value is looks like a promise
	 * @param value
	 */
	isPromiseLike(value: any): value is PromiseLike<unknown>;

	/**
	 * Returns true if the specified value is looks like a proxy
	 * @param value
	 */
	isProxy<T>(value: T): T extends Primitive ? false : boolean;

	/**
	 * If the passed value is a proxy object, the method returns an original object.
	 * Otherwise, the passed object itself.
	 *
	 * @param value
	 */
	unwrapProxy<T>(value: T): T;

	/**
	 * @deprecated
	 * @see [[ObjectConstructor.isPlainObject]]
	 * @see [[ObjectConstructor.isDictionary]]
	 */
	isObject(value: any): value is Dictionary;
}

interface ArrayConstructor {
	/**
	 * Returns a curried version of `Array.union`
	 * @param arr
	 */
	union<T extends Nullable<any[]>>(arr: T): <A extends Iterable<any> | any>(
		...args: Array<Iterable<A> | A>
	) => A extends Iterable<infer V> ?
		Array<IterableType<NonNullable<T>> | V> :
		Array<IterableType<NonNullable<T>> | NonNullable<A>>;

	/**
	 * Returns a new array containing elements from all specified non-primitive iterable values with duplicates removed.
	 * You can also pass non-iterable values, and they will be added to the final array,
	 * except values with `null` or `undefined`.
	 *
	 * @param arr
	 * @param args
	 */
	union<T extends Nullable<any[]>, A extends Iterable<any> | any>(
		arr: T,
		...args: Array<Iterable<A> | A>
	): A extends Iterable<infer V> ?
		Array<IterableType<NonNullable<T>> | V> :
		Array<IterableType<NonNullable<T>> | NonNullable<A>>;

	/**
	 * Returns a curried version of `Array.concat`
	 * @param arr
	 */
	concat<T extends Nullable<any[]>>(arr: T): <A extends CanArray<any>>(...args: Array<CanArray<A>>) =>
		A extends Array<infer V> ?
			Array<IterableType<NonNullable<T>> | V> :
			Array<IterableType<NonNullable<T>> | NonNullable<A>>;

	/**
	 * Returns a new array containing elements from all specified arrays.
	 * You can also pass non-iterable values, and they will be added to the final array,
	 * except values with `null` or `undefined`.
	 *
	 * @param arr
	 * @param args
	 */
	concat<T extends Nullable<any[]>, A extends CanArray<any>>(
		arr: T,
		...args: Array<CanArray<A>>
	): A extends Array<infer V> ?
		Array<IterableType<NonNullable<T>> | V> :
		Array<IterableType<NonNullable<T>> | NonNullable<A>>;
}

interface Array<T> {
	/**
	 * Returns a new array containing elements from all specified non-primitive iterable values with duplicates removed.
	 * You can also pass non-iterable values, and they will be added to the final array,
	 * except values with `null` or `undefined`.
	 *
	 * @param args
	 */
	union<A extends Iterable<any> | any>(
		...args: Array<Iterable<A> | A>
	): A extends Iterable<infer V> ? Array<T | V> : Array<T | NonNullable<A>>;
}

interface StringCapitalizeOptions {
	/**
	 * If true, then remainder of the string will be transformed to lower case
	 * @default `false`
	 */
	lower?: boolean;

	/**
	 * If true, all words in the string will be capitalized
	 * @default `false`
	 */
	all?: boolean;

	/**
	 * If false, then the operation isn't cached
	 * @default `true`
	 */
	cache?: boolean;
}

interface StringCamelizeOptions {
	/**
	 * If false, then the first character of the string will be transformed to the lower case
	 * @default `true`
	 */
	upper?: boolean;

	/**
	 * If false, then the result string won't be cached
	 * @default `true`
	 */
	cache?: boolean;
}

interface StringDasherizeOptions {
	/**
	 * If true, then the operation can be reverted
	 * @default `false`
	 */
	stable?: boolean;

	/**
	 * If false, then the operation isn't cached
	 * @default `true`
	 */
	cache?: boolean;
}

interface StringUnderscoreOptions extends StringDasherizeOptions {

}

interface StringConstructor {
	/**
	 * Returns an iterator over the string letters.
	 * The method understands the composition of multiple Unicode symbols that produce one visual symbol.
	 *
	 * @example
	 * ```
	 * [...String.letters('12🇷🇺👩')] // ['1', '2', '🇷🇺', '👩']
	 * ```
	 */
	letters(str: string): IterableIterator<string>;

	/**
	 * Returns a curried version of `String.capitalize`
	 * @param opts - additional options
	 */
	capitalize(opts: StringCapitalizeOptions): (str: string) => string;

	/**
	 * Capitalizes the first character of the string and returns it
	 *
	 * @param str
	 * @param [opts] - additional options
	 */
	capitalize(str: string, opts?: StringCapitalizeOptions): string;

	/**
	 * Returns a curried version of `String.camelize`
	 * @param upper - if false, then the first character of a value is transformed to the lower case
	 */
	camelize(upper: boolean): (str: string) => string;

	/**
	 * Returns a curried version of `String.camelize`
	 * @param opts - additional options
	 */
	camelize(opts: StringCamelizeOptions): (str: string) => string;

	/**
	 * Returns a CamelCaseStyle version of the specified string
	 *
	 * @param str
	 * @param [upper] - if false, then the first character of a value is transformed to the lower case
	 */
	camelize(str: string, upper?: boolean): string;

	/**
	 * Returns a CamelCaseStyle version of the specified string
	 *
	 * @param str
	 * @param [opts] - additional options
	 */
	camelize(str: string, opts?: StringCamelizeOptions): string;

	/**
	 * Returns a curried version of `String.dasherize`
	 * @param stable - if true, then the operation can be reverted
	 */
	dasherize(stable: boolean): (str: string) => string;

	/**
	 * Returns a curried version of `String.dasherize`
	 * @param opts - additional options
	 */
	dasherize(opts: StringDasherizeOptions): (str: string) => string;

	/**
	 * Returns a dash-style version of the specified string
	 *
	 * @param str
	 * @param [stable] - if true, then the operation can be reverted
	 */
	dasherize(str: string, stable?: boolean): string;

	/**
	 * Returns a dash-style version of the specified string
	 *
	 * @param str
	 * @param [opts] - additional options
	 */
	dasherize(str: string, opts?: StringDasherizeOptions): string;

	/**
	 * Returns a curried version of `String.underscore`
	 * @param stable - if true, then the operation can be reverted
	 */
	underscore(stable: boolean): (str: string) => string;

	/**
	 * Returns a curried version of `String.underscore`
	 * @param opts - additional options
	 */
	underscore(opts: StringUnderscoreOptions): (str: string) => string;

	/**
	 * Returns an underscore_style version of the specified string
	 *
	 * @param str
	 * @param [stable] - if true, then the operation can be reverted
	 */
	underscore(str: string, stable?: boolean): string;

	/**
	 * Returns an underscore_style version of the specified string
	 *
	 * @param str
	 * @param [opts] - additional options
	 */
	underscore(str: string, opts?: StringUnderscoreOptions): string;
}

interface String {
	/**
	 * Returns an iterator over the string letters.
	 * The method understands the composition of multiple Unicode symbols that produce one visual symbol.
	 *
	 * @example
	 * ```
	 * [...'12🇷🇺👩'.letters()] // ['1', '2', '🇷🇺', '👩']
	 * ```
	 */
	letters(): IterableIterator<string>;

	/**
	 * Capitalizes the first character of a string and returns it
	 * @param [opts] - additional options
	 */
	capitalize(opts?: StringCapitalizeOptions): string;

	/**
	 * Returns a CamelCaseStyle version of the specified string
	 * @param [upper] - if false, then the first character of the string is transformed to the lower case
	 */
	camelize(upper?: boolean): string;

	/**
	 * Returns a CamelCaseStyle version of the specified string
	 * @param [opts] - additional options
	 */
	camelize(opts?: StringCamelizeOptions): string;

	/**
	 * Returns a dash-style version of the specified string
	 * @param [stable] - if true, then the operation can be reverted
	 */
	dasherize(stable?: boolean): string;

	/**
	 * Returns a dash-style version of the specified string
	 * @param [opts] - additional options
	 */
	dasherize(opts?: StringDasherizeOptions): string;

	/**
	 * Returns an underscore_style version of the specified string
	 * @param [stable] - if true, then the operation can be reverted
	 */
	underscore(stable?: boolean): string;

	/**
	 * Returns an underscore_style version of the specified string
	 * @param [opts] - additional options
	 */
	underscore(opts?: StringUnderscoreOptions): string;
}

type NumberOption =
	'decimal' |
	'thousands';

interface NumberConstructor {
	/**
	 * Returns an option value by the specified key
	 *
	 * @deprecated
	 * @param key
	 */
	getOption(key: NumberOption): string;

	/**
	 * Sets a new option value by the specified key
	 *
	 * @deprecated
	 * @param key
	 * @param value
	 */
	setOption(key: NumberOption, value: string): string;

	/**
	 * Returns true if the specified value is a safe number
	 * @param value
	 */
	isSafe(value: any): boolean;

	/**
	 * Returns true if the specified value is an integer number
	 * @param value
	 */
	isInteger(value: any): boolean;

	/**
	 * Returns true if the specified value is a float number
	 * @param value
	 */
	isFloat(value: any): boolean;

	/**
	 * Returns true if the specified value is an even number
	 * @param value
	 */
	isEven(value: any): boolean;

	/**
	 * Returns true if the specified value is an odd number
	 * @param value
	 */
	isOdd(value: any): boolean;

	/**
	 * Returns true if the specified value is a natural number
	 * @param value
	 */
	isNatural(value: any): boolean;

	/**
	 * Returns true if the specified value is a positive number
	 * @param value
	 */
	isPositive(value: any): boolean;

	/**
	 * Returns true if the specified value is a negative number
	 * @param value
	 */
	isNegative(value: any): boolean;

	/**
	 * Returns true if the specified value is a non-negative number
	 * @param value
	 */
	isNonNegative(value: any): boolean;

	/**
	 * Returns true if the specified value is a number and is more or equal than 0 and less or equal than 1
	 * @param value
	 */
	isBetweenZeroAndOne(value: any): boolean;

	/**
	 * Returns true if the specified value is a number and is more than 0 and less or equal than 1
	 * @param value
	 */
	isPositiveBetweenZeroAndOne(value: any): boolean;

	/**
	 * Returns a value of milliseconds from the seconds
	 */
	seconds(value: number): number;

	/**
	 * Returns a value of milliseconds from the minutes
	 */
	minutes(value: number): number;

	/**
	 * Returns a value of milliseconds from the hours
	 */
	hours(value: number): number;

	/**
	 * Returns a value of milliseconds from the days
	 */
	days(value: number): number;

	/**
	 * Returns a value of milliseconds from the weeks
	 */
	weeks(value: number): number;

	/**
	 * Returns a curried version of `Number.floor`
	 * @param precision
	 */
	floor(precision: number): (value: number) => number;

	/**
	 * Shortcut for Math.floor that also allows a precision
	 *
	 * @param value
	 * @param precision
	 */
	floor(value: number, precision: number): number;

	/**
	 * Returns a curried version of `Number.round`
	 * @param precision
	 */
	round(precision: number): (value: number) => number;

	/**
	 * Shortcut for Math.round that also allows a precision
	 *
	 * @param value
	 * @param precision
	 */
	round(value: number, precision: number): number;

	/**
	 * Returns a curried version of `Number.ceil`
	 * @param precision
	 */
	ceil(precision: number): (value: number) => number;

	/**
	 * Shortcut for Math.ceil that also allows a precision
	 *
	 * @param value
	 * @param precision
	 */
	ceil(value: number, precision: number): number;

	/**
	 * Returns a curried version of `Number.pad`
	 * @param opts - additional options
	 */
	pad(opts: NumberPadOptions): (value: string) => string;

	/**
	 * Returns a string from a number with adding extra zeros to the start, if necessary
	 *
	 * @param num
	 * @param targetLength - length of the resulting string once the current string has been padded
	 */
	pad(num: number, targetLength?: number): string;

	/**
	 * Returns a string from a number with adding extra zeros to the start, if necessary
	 *
	 * @param num
	 * @param opts - additional options
	 */
	pad(num: number, opts: NumberPadOptions): string;

	/**
	 * Returns a curried version of `Number.format`
	 *
	 * @param pattern
	 * @param locale
	 */
	format(pattern: string, locale?: CanArray<string>): (value: number) => string;

	/**
	 * Returns a curried version of `Number.format`
	 *
	 * @param opts
	 * @param locale
	 */
	format(opts: Intl.NumberFormatOptions, locale?: CanArray<string>): (value: number) => string;

	/**
	 * Returns a string representation of a number by the specified pattern.
	 * All pattern directives are based on the native `Intl.NumberFormat` options:
	 *
	 *   1. `'style'`
	 *   2. `'currency'`
	 *   3. `'currencyDisplay'`
	 *
	 * There are aliases for all directives:
	 *
	 *   1. `'$'` - `{style: 'currency', currency: 'USD'}`
	 *   2. `'$:${currency}'` - `{style: 'currency', currency}`
	 *   3. `'$d:${currencyDisplay}'` - `{currencyDisplay}`
	 *   4. `'%'` - `{style: 'percent'}`
	 *   5. `'.'` - `{style: 'decimal'}`
	 *
	 * @param num
	 * @param pattern - format string pattern:
	 *   1. symbol `';'` is used as a separator character for the pattern directives, for example: `'$;$d:code'`
	 *   2. symbol `':'` is used for specifying a custom value for a pattern directive, for example:
	 *    `'$:RUB;$d:code'`
	 *
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 *  100.50.format('$', 'en-us') // '$100.50'
	 *  100.50.format('$:EUR;$d:code', 'en-us') // 'EUR 100.50'
	 * ```
	 */
	format(num: number, pattern?: string, locale?: CanArray<string>): string;

	/**
	 * Returns a string representation of a number by the specified options
	 *
	 * @param num
	 * @param opts - formatting options
	 * @param [locale] - locale for internalizing
	 */
	format(num: number, opts: Intl.NumberFormatOptions, locale?: CanArray<string>): string;
}

interface NumberPadOptions {
	/**
	 * Length of the resulting string once the current string has been padded
	 */
	length?: number;

	/**
	 * Value of the base to convert in a string
	 * @default `10`
	 */
	base?: number;

	/**
	 * If true, then a sign of the number will be written anyway
	 * @default `false`
	 */
	sign?: boolean;
}

interface Number {
	/**
	 * Returns a string: the value + 'em'
	 */
	em: string;

	/**
	 * Returns a string: the value + 'rem'
	 */
	rem: string;

	/**
	 * Returns a string: the value + 'px'
	 */
	px: string;

	/**
	 * Returns a string: the value + 'per'
	 */
	per: string;

	/**
	 * Returns a string: the value + 'vh'
	 */
	vh: string;

	/**
	 * Returns a string: the value + 'vw'
	 */
	vw: string;

	/**
	 * Returns a string: the value + 'vmin'
	 */
	vmin: string;

	/**
	 * Returns a string: the value + 'vmax'
	 */
	vmax: string;

	/**
	 * Returns a value of milliseconds from the seconds
	 */
	second(): number;

	/**
	 * Returns a value of milliseconds from the seconds
	 */
	seconds(): number;

	/**
	 * Returns a value of milliseconds from the minutes
	 */
	minute(): number;

	/**
	 * Returns a value of milliseconds from the minutes
	 */
	minutes(): number;

	/**
	 * Returns a value of milliseconds from the hours
	 */
	hour(): number;

	/**
	 * Returns a value of milliseconds from the hours
	 */
	hours(): number;

	/**
	 * Returns a value of milliseconds from the days
	 */
	day(): number;

	/**
	 * Returns a value of milliseconds from the days
	 */
	days(): number;

	/**
	 * Returns a value of milliseconds from the weeks
	 */
	week(): number;

	/**
	 * Returns a value of milliseconds from the weeks
	 */
	weeks(): number;

	/**
	 * Returns true if the number is safe
	 */
	isSafe(): boolean;

	/**
	 * Returns true if the number is an integer
	 */
	isInteger(): boolean;

	/**
	 * Returns true if the number is a float
	 */
	isFloat(): boolean;

	/**
	 * Returns true if the number is even
	 */
	isEven(): boolean;

	/**
	 * Returns true if the number is odd
	 */
	isOdd(): boolean;

	/**
	 * Returns true if the number is natural
	 */
	isNatural(): boolean;

	/**
	 * Returns true if the number is positive
	 */
	isPositive(): boolean;

	/**
	 * Returns true if the number is negative
	 */
	isNegative(): boolean;

	/**
	 * Returns true if the number is non-negative
	 */
	isNonNegative(): boolean;

	/**
	 * Returns true if the number is more or equal than 0 and less or equal than 1
	 */
	isBetweenZeroAndOne(): boolean;

	/**
	 * Returns true if the number is more than 0 and less or equal than 1
	 */
	isPositiveBetweenZeroAndOne(): boolean;

	/**
	 * Returns a string from the number with adding extra zeros to the start, if necessary
	 *
	 * @param targetLength - length of the resulting string once the current string has been padded
	 * @param [opts] - additional options
	 */
	pad(targetLength?: number, opts?: NumberPadOptions): string;

	/**
	 * Returns a string representation of the number by the specified pattern.
	 * All pattern directives are based on the native `Intl.NumberFormat` options:
	 *
	 *   1. `'style'`
	 *   1. `'currency'`
	 *   1. `'currencyDisplay'`
	 *
	 * There are aliases for all directives:
	 *
	 *   1. `'$'` - `{style: 'currency', currency: 'USD'}`
	 *   1. `'$:${currency}'` - `{style: 'currency', currency}`
	 *   1. `'$d:${currencyDisplay}'` - `{currencyDisplay}`
	 *   1. `'%'` - `{style: 'percent'}`
	 *   1. `'.'` - `{style: 'decimal'}`
	 *
	 * @param pattern - string pattern of the format:
	 *   1. symbol `';'` is used as a separator character for pattern directives, for example: `'$;$d:code'`
	 *   1. symbol `':'` is used for specifying a custom value for a pattern directive, for example:
	 *    `'$:RUB;$d:code'`
	 *
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * 100.50.format('$', 'en-us') // '$100.50'
	 * 100.50.format('$:EUR;$d:code', 'en-us') // 'EUR 100.50'
	 * ```
	 */
	format(pattern?: string, locale?: CanArray<string>): string;

	/**
	 * Returns a string representation of the number by the specified options
	 *
	 * @param opts - formatting options
	 * @param [locale] - locale for internalizing
	 */
	format(opts: Intl.NumberFormatOptions, locale?: CanArray<string>): string;

	/**
	 * Returns a string representation of the number with adding some extra formatting
	 *
	 * @deprecated
	 * @param [length] - length of the decimal part
	 */
	format(length: number): string;

	/**
	 * Shortcut for Math.floor that also allows a precision
	 * @param [precision]
	 */
	floor(precision?: number): number;

	/**
	 * Shortcut for Math.round that also allows a precision
	 * @param [precision]
	 */
	round(precision?: number): number;

	/**
	 * Shortcut for Math.ceil that also allows a precision
	 * @param [precision]
	 */
	ceil(precision?: number): number;
}

type RegExpFlag = '' | 'g' | 'i' | 'm' | 'u' | 'y' | 's';

interface RegExp {
	/**
	 * Returns a new RegExp based on the source with adding the specified flags
	 * @param flags
	 */
	addFlags(...flags: RegExpFlag[]): RegExp;

	/**
	 * Returns a new RegExp based on the source with removing the specified flags
	 * @param flags
	 */
	removeFlags(...flags: RegExpFlag[]): RegExp;

	/**
	 * Returns a new RegExp based on the source with setting the specified flags
	 * @param flags
	 */
	setFlags(...flags: RegExpFlag[]): RegExp;
}

interface RegExpConstructor {
	/**
	 * Returns the specified value as a string with escaping of all RegExp specific characters
	 * @param value
	 */
	escape(value: string): string;

	/**
	 * Returns true if the specified string is matched with a RegExp.
	 * If the RegExp has the global flag, it will be ignored.
	 *
	 * @param rgxp
	 * @param str
	 */
	test(rgxp: RegExp, str: string): boolean;

	/**
	 * Returns a curried version of `RegExp.test`
	 * @param rgxp
	 */
	test(rgxp: RegExp): (str: string) => boolean;

	/**
	 * Returns a curried version of `inverted` `RegExp.test`
	 * @param str
	 */
	test(str: string): (rgxp: RegExp) => boolean;

	/**
	 * Returns a new RegExp based on the source with adding the specified flags
	 *
	 * @param rgxp
	 * @param flags
	 */
	addFlags(rgxp: RegExp, ...flags: RegExpFlag[]): RegExp;

	/**
	 * Returns a curried version of `RegExp.addFlags`
	 * @param rgxp
	 */
	addFlags(rgxp: RegExp): (...flags: RegExpFlag[]) => RegExp;

	/**
	 * Returns a curried version of `inverted` RegExp.addFlags
	 * @param flags
	 */
	addFlags(flags: RegExpFlag): (rgxp: RegExp) => RegExp;

	/**
	 * Returns a new RegExp based on the source with removing the specified flags
	 *
	 * @param rgxp
	 * @param flags
	 */
	removeFlags(rgxp: RegExp, ...flags: RegExpFlag[]): RegExp;

	/**
	 * Returns a curried version of `RegExp.removeFlags`
	 * @param rgxp
	 */
	removeFlags(rgxp: RegExp): (...flags: RegExpFlag[]) => RegExp;

	/**
	 * Returns a curried version of `inverted` RegExp.removeFlags
	 * @param flags
	 */
	removeFlags(flags: RegExpFlag): (rgxp: RegExp) => RegExp;

	/**
	 * Returns a new RegExp based on the source with setting the specified flags
	 *
	 * @param rgxp
	 * @param flags
	 */
	setFlags(rgxp: RegExp, ...flags: RegExpFlag[]): RegExp;

	/**
	 * Returns a curried version of `RegExp.setFlags`
	 * @param rgxp
	 */
	setFlags(rgxp: RegExp): (...flags: RegExpFlag[]) => RegExp;

	/**
	 * Returns a curried version of `inverted` RegExp.setFlags
	 * @param flags
	 */
	setFlags(flags: RegExpFlag): (rgxp: RegExp) => RegExp;
}

type DateCreateValue =
	number |
	string |
	Date;

interface DateCreateOptions {

}

interface DateConstructor {
	/**
	 * Creates a date from the specified pattern.
	 * This method can create a new date object from:
	 *
	 *  1. another date object
	 *  1. number of milliseconds (if the number is integer)
	 *  1. number of seconds (if the number is float)
	 *  1. string pattern by using the native `Date.parse` with some polyfills
	 *  1. string aliases:
	 *     1. `'now'` - is an alias for the now date
	 *     1. `'today'` - is an alias for the beginning of the today
	 *     1. `'yesterday'` - is an alias for the beginning of the yesterday
	 *     1. `'tomorrow'` - is an alias for the beginning of the tomorrow
	 *
	 * @param [pattern]
	 * @param [opts]
	 *
	 * @example
	 * ```js
	 * Date.create('now'); // new Date(Date.now())
	 * Date.create(Date.now()); // new Date(Date.now())
	 * ```
	 */
	create(pattern?: DateCreateValue, opts?: DateCreateOptions): Date;

	/**
	 * Returns a list of week days
	 * @deprecated
	 */
	getWeekDays(): string[];

	/**
	 * Returns a curried version of `Date.is`
	 *
	 * @param margin - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 *
	 * @param date1 - date to compare
	 */
	is(margin: number, date1: DateCreateValue): (date2: DateCreateValue) => boolean;

	/**
	 * Returns a curried version of `Date.is`
	 * @param date1 - date to compare
	 */
	is(date1: DateCreateValue): (date2: DateCreateValue, margin?: number) => boolean;

	/**
	 * Returns true if the one date is equals to another
	 *
	 * @param date1 - date to compare
	 * @param date2 - another date to compare
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	is(date1: DateCreateValue, date2: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns a curried version of `Date.isAfter`
	 *
	 * @param margin - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 *
	 * @param date1 - date to compare
	 */
	isAfter(margin: number, date1: DateCreateValue): (date2: DateCreateValue) => boolean;

	/**
	 * Returns a curried version of `Date.isAfter`
	 * @param date1 - date to compare
	 */
	isAfter(date1: DateCreateValue): (date2: DateCreateValue, margin?: number) => boolean;

	/**
	 * Returns true if the one date is greater than another
	 *
	 * @param date1 - date to compare
	 * @param date2 - another date to compare
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	isAfter(date1: DateCreateValue, date2: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns a curried version of `Date.isBefore`
	 *
	 * @param margin - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 *
	 * @param date1 - date to compare
	 */
	isBefore(margin: number, date1: DateCreateValue): (date2: DateCreateValue) => boolean;

	/**
	 * Returns a curried version of `Date.isBefore`
	 * @param date1 - date to compare
	 */
	isBefore(date1: DateCreateValue): (date2: DateCreateValue, margin?: number) => boolean;

	/**
	 * Returns true if the one date is less than another
	 *
	 * @param date1 - date to compare
	 * @param date2 - another date to compare
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	isBefore(date1: DateCreateValue, date2: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns a curried version of `Date.isBetween`
	 *
	 * @param margin - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	isBetween(margin: number): (date: Date, left?: Date, right?: Date) => boolean;

	/**
	 * Returns a curried version of `Date.isBetween`
	 *
	 * @param [left] - date of the beginning
	 * @param [right] - date of the ending
	 */
	isBetween(left?: DateCreateValue, right?: DateCreateValue):
		(date: Date, left?: Date, right?: Date, margin?: number) => boolean;

	/**
	 * Returns true if the date is between of two other (including the bounding dates)
	 *
	 * @param date - date to check
	 * @param left - date of the beginning
	 * @param right - date of the ending
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	isBetween(date: Date, left: DateCreateValue, right: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a day
	 * @param date
	 */
	beginningOfDay(date: Date): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a day
	 * @param date
	 */
	endOfDay(date: Date): Date;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a week
	 * @param date
	 */
	beginningOfWeek(date: Date): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a week
	 * @param date
	 */
	endOfWeek(date: Date): Date;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a month
	 * @param date
	 */
	beginningOfMonth(date: Date): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a month
	 * @param date
	 */
	endOfMonth(date: Date): Date;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a year
	 * @param date
	 */
	beginningOfYear(date: Date): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a year
	 * @param date
	 */
	endOfYear(date: Date): Date;

	/**
	 * Returns a curried version of `Date.short`
	 * @param locale - locale for internalizing
	 */
	short(locale: CanArray<string>): (date: Date) => string;

	/**
	 * Returns a short string representation of the date.
	 * This method is based on the native Intl API.
	 *
	 * @param date
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').short('en-us') // '12/28/2019'
	 * ```
	 */
	short(date: Date, locale?: CanArray<string>): string;

	/**
	 * Returns a curried version of `Date.medium`
	 * @param locale - locale for internalizing
	 */
	medium(locale: CanArray<string>): (date: Date) => string;

	/**
	 * Returns a medium string representation of the date.
	 * This method is based on the native Intl API.
	 *
	 * @param date
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').medium('en-us') // 'December 28, 2019'
	 * ```
	 */
	medium(date: Date, locale?: CanArray<string>): string;

	/**
	 * Returns a curried version of `Date.long`
	 * @param locale - locale for internalizing
	 */
	long(locale: CanArray<string>): (date: Date) => string;

	/**
	 * Returns a long string representation of the date.
	 * This method is based on the native Intl API.
	 *
	 * @param date
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').long('en-us') // '12/28/2019, 12:00:00 AM'
	 * ```
	 */
	long(date: Date, locale?: CanArray<string>): string;

	/**
	 * Returns a curried version of `Date.format`
	 *
	 * @param pattern
	 * @param locale
	 */
	format(pattern: string, locale?: CanArray<string>): (date: Date) => string;

	/**
	 * Returns a curried version of `Date.format`
	 *
	 * @param opts
	 * @param locale
	 */
	format(opts: Intl.NumberFormatOptions, locale?: CanArray<string>): (date: Date) => string;

	/**
	 * Returns a string representation of the date by the specified pattern.
	 * All pattern directives are based on the native `Intl.DateTimeFormat` options:
	 *
	 *   1. `'era'`
	 *   1. `'year'`
	 *   1. `'month'`
	 *   1. `'day'`
	 *   1. `'weekday'`
	 *   1. `'hour'`
	 *   1. `'minute'`
	 *   1. `'second'`
	 *   1. `'timeZoneName'`
	 *
	 * There are aliases for all directives:
	 *
	 *   1. `'e'` - era
	 *   1. `'Y'` - year
	 *   1. `'M'` - month
	 *   1. `'d'` - day
	 *   1. `'w'` - weekday
	 *   1. `'h'` - hour
	 *   1. `'m'` - minute
	 *   1. `'s'` - second
	 *   1. `'z'` - timeZoneName
	 *
	 * Also, some directives support optional use.
	 * To mark a directive as optional, add the special `?` character after the name or alias.
	 *
	 * ```js
	 * // Will be shown only the day value,
	 * // because the rest values are equal with `Date.now()`
	 * new Date().format('year?;month?:short;day', 'en-us');
	 *
	 * // Will be shown all values that are declared in the pattern
	 * new Date('12/28/2019').format('year?:2-digit;month?;day', 'en-us');
	 * ```
	 *
	 * @param date
	 * @param pattern - string pattern of the format:
	 *
	 *   1. symbol `';'` is used as a separator character for pattern directives, for example: `'year;month'`
	 *   1. symbol `':'` is used for specifying a custom value for a pattern directive, for example:
	 *    `'year:2-digit;month:short'`
	 *
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').format('year', 'en-us') // '2019'
	 * new Date('12/28/2019').format('year:2-digit', 'en-us') // '19'
	 * new Date('12/28/2019').format('year:2-digit;month', 'en-us') // 'Dec 19'
	 *
	 * // Formatting a date by using short aliases
	 * new Date('12/28/2019').format('Y:2-digit;M:long;d', 'en-us') // 'December 28, 19'
	 * ```
	 */
	format(date: Date, pattern: string, locale?: CanArray<string>): string;

	/**
	 * Returns a string representation of the date by the specified options
	 *
	 * @param date
	 * @param opts - formatting options
	 * @param [locale] - locale for internalizing
	 */
	format(date: Date, opts: Intl.DateTimeFormatOptions, locale?: CanArray<string>): string;

	/**
	 * Returns a curried version of `Date.toHTMLDateString`
	 * @param opts - additional options
	 */
	toHTMLDateString(opts: DateHTMLDateStringOptions): (date: Date) => string;

	/**
	 * Returns an HTML string representation of the date (without time).
	 * This method is useful for providing date values within HTML tag attributes.
	 *
	 * @param date
	 * @param [opts] - additional options
	 */
	toHTMLDateString(date: Date, opts?: DateHTMLDateStringOptions): string;

	/**
	 * Returns a curried version of `Date.toHTMLTimeString`
	 * @param opts - additional options
	 */
	toHTMLTimeString(opts: DateHTMLDateStringOptions): (date: Date) => string;

	/**
	 * Returns an HTML string representation of a timestamp from the date.
	 * This method is useful for providing timestamp values within HTML tag attributes.
	 *
	 * @param date
	 * @param [opts] - additional options
	 */
	toHTMLTimeString(date: Date, opts?: DateHTMLTimeStringOptions): string;

	/**
	 * Returns a curried version of `Date.toHTMLString`
	 * @param opts - additional options
	 */
	toHTMLString(opts: DateHTMLDateStringOptions): (date: Date) => string;

	/**
	 * Returns an HTML string representation of a datetime from the date.
	 * This method is useful for providing datetime values within HTML tag attributes.
	 *
	 * @param date
	 * @param [opts] - additional options
	 */
	toHTMLString(date: Date, opts?: DateHTMLStringOptions): string;

	/**
	 * Returns a curried version of ``Date.add``
	 *
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	add(units: DateSetParams, reset?: boolean): (date: Date) => Date;

	/**
	 * Modifies the date with adding time units
	 *
	 * @param date
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	add(date: Date, units: DateSetParams, reset?: boolean): Date;

	/**
	 * Returns a curried version of `Date.set`
	 *
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	set(units: DateSetParams, reset?: boolean): (date: Date) => Date;

	/**
	 * Modifies the date with setting time units
	 *
	 * @param date
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	set(date: Date, units: DateSetParams, reset?: boolean): Date;

	/**
	 * Returns a curried version of `Date.rewind`
	 *
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	rewind(units: DateSetParams, reset?: boolean): (date: Date) => Date;

	/**
	 * Modifies the date with subtracting time units
	 *
	 * @param date
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	rewind(date: Date, units: DateSetParams, reset?: boolean): Date;

	/**
	 * Maps the specified date to the current (Date.now()) date and returns difference
	 * @param date
	 */
	relative(date: DateCreateValue): DateRelative;

	/**
	 * Returns a curried version of `Date.relativeTo`
	 * @param from
	 */
	relativeTo(from: DateCreateValue): (to: DateCreateValue) => DateRelative;

	/**
	 * Maps the one date to another and returns difference
	 *
	 * @param from
	 * @param to
	 */
	relativeTo(from: DateCreateValue, to: DateCreateValue): DateRelative;
}

interface DateSetParams {
	millisecond?: number;
	milliseconds?: number;
	second?: number;
	seconds?: number;
	minute?: number;
	minutes?: number;
	hour?: number;
	hours?: number;
	day?: number;
	days?: number;
	month?: number;
	months?: number;
	year?: number;
	years?: number;
}

interface DateHTMLDateStringOptions {
	/**
	 * If false, then a date month is taken from the beginning of the now year
	 * @default `true`
	 */
	month?: boolean;

	/**
	 * If false, then a date day is taken from the beginning of the now month
	 * @default `true`
	 */
	date?: boolean;
}

interface DateHTMLTimeStringOptions {
	/**
	 * If false, then a date month is taken from the beginning of the now hour
	 * @default `true`
	 */
	minutes?: boolean;

	/**
	 * If false, then a date second is taken from the beginning of the now minute
	 * @default `true`
	 */
	seconds?: boolean;

	/**
	 * If false, then a date millisecond is taken from the beginning of the now second
	 * @default `true`
	 */
	milliseconds?: boolean;
}

type DateHTMLStringOptions =
	DateHTMLTimeStringOptions &
	DateHTMLDateStringOptions;

type DateRelativeType =
	'milliseconds' |
	'seconds' |
	'minutes' |
	'hours' |
	'days' |
	'weeks' |
	'months' |
	'years';

interface DateRelative {
	type: DateRelativeType;
	value: number;
	diff: number;
}

interface Date {
	/**
	 * Clones the date object and returns a new object
	 */
	clone(): Date;

	/**
	 * Returns true if the date is equals to another
	 *
	 * @param date - another date to compare
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	is(date: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns true if the date is greater than another
	 *
	 * @param date - another date to compare
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	isAfter(date: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns true if the date is less than another
	 *
	 * @param date - another date to compare
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	isBefore(date: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns true if the date is between of two other (including the bounding dates)
	 *
	 * @param left - date of the beginning
	 * @param right - date of the ending
	 * @param [margin] - value of the maximum difference between two dates at which they are considered equal
	 *   (in milliseconds)
	 */
	isBetween(left: DateCreateValue, right: DateCreateValue, margin?: number): boolean;

	/**
	 * Returns true if the date is less than the now date
	 */
	isPast(): boolean;

	/**
	 * Returns true if the date is greater than the now date
	 */
	isFuture(): boolean;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a day
	 */
	beginningOfDay(): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a day
	 */
	endOfDay(): Date;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a week
	 */
	beginningOfWeek(): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a week
	 */
	endOfWeek(): Date;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a month
	 */
	beginningOfMonth(): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a month
	 */
	endOfMonth(): Date;

	/**
	 * Returns a new date based on the current so that it starts at the beginning of a year
	 */
	beginningOfYear(): Date;

	/**
	 * Returns a new date based on the current so that it starts at the ending of a year
	 */
	endOfYear(): Date;

	/**
	 * Returns a short string representation of the date.
	 * This method is based on the native Intl API.
	 *
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').short('en-us') // '12/28/2019'
	 * ```
	 */
	short(locale?: CanArray<string>): string;

	/**
	 * Returns a medium string representation of the date.
	 * This method is based on the native Intl API.
	 *
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').medium('en-us') // 'December 28, 2019'
	 * ```
	 */
	medium(locale?: CanArray<string>): string;

	/**
	 * Returns a long string representation of the date.
	 * This method is based on the native Intl API.
	 *
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').long('en-us') // '12/28/2019, 12:00:00 A'
	 * ```
	 */
	long(locale?: CanArray<string>): string;

	/**
	 * Returns a string representation of the date by the specified pattern.
	 * All pattern directives are based on the native `Intl.DateTimeFormat` options:
	 *
	 *   1. `'era'`
	 *   1. `'year'`
	 *   1. `'month'`
	 *   1. `'day'`
	 *   1. `'weekday'`
	 *   1. `'hour'`
	 *   1. `'minute'`
	 *   1. `'second'`
	 *   1. `'timeZoneName'`
	 *
	 * There are aliases for all directives:
	 *
	 *   1. `'e'` - era
	 *   1. `'Y'` - year
	 *   1. `'M'` - month
	 *   1. `'d'` - day
	 *   1. `'w'` - weekday
	 *   1. `'h'` - hour
	 *   1. `'m'` - minute
	 *   1. `'s'` - second
	 *   1. `'z'` - timeZoneName
	 *
	 * Also, some directives support optional use.
	 * To mark a directive as optional, add the special `?` character after the name or alias.
	 *
	 * ```js
	 * // Will be shown only the day value,
	 * // because the rest values are equal with `Date.now()`
	 * new Date().format('year?;month?:short;day', 'en-us');
	 *
	 * // Will be shown all values that are declared in the pattern
	 * new Date('12/28/2019').format('year?:2-digit;month?;day', 'en-us');
	 * ```
	 *
	 * @param pattern - string pattern of the format:
	 *
	 *   1. symbol `';'` is used as a separator character for pattern directives, for example: `'year;month'`
	 *   1. symbol `':'` is used for specifying a custom value for a pattern directive, for example:
	 *    `'year:2-digit;month:short'`
	 *
	 * @param [locale] - locale for internalizing
	 *
	 * @example
	 * ```js
	 * new Date('12/28/2019').format('year', 'en-us') // '2019'
	 * new Date('12/28/2019').format('year:2-digit', 'en-us') // '19'
	 * new Date('12/28/2019').format('year:2-digit;month', 'en-us') // 'Dec 19'
	 *
	 * // Formatting a date by using short aliases
	 * new Date('12/28/2019').format('Y:2-digit;M:long;d', 'en-us') // 'December 28, 19'
	 * ```
	 */
	format(pattern: string, locale?: CanArray<string>): string;

	/**
	 * Returns a string representation of the date by the specified options
	 *
	 * @param opts - formatting options
	 * @param [locale] - locale for internalizing
	 */
	format(opts: Intl.DateTimeFormatOptions, locale?: CanArray<string>): string;

	/**
	 * Returns an HTML string representation of the date (without time).
	 * This method is useful for providing date values within HTML tag attributes.
	 *
	 * @param [opts] - additional options
	 */
	toHTMLDateString(opts?: DateHTMLDateStringOptions): string;

	/**
	 * Returns an HTML string representation of a timestamp from the date.
	 * This method is useful for providing timestamp values within HTML tag attributes.
	 *
	 * @param [opts] - additional options
	 */
	toHTMLTimeString(opts?: DateHTMLTimeStringOptions): string;

	/**
	 * Returns an HTML string representation of a datetime from the date.
	 * This method is useful for providing datetime values within HTML tag attributes.
	 *
	 * @param [opts] - additional options
	 */
	toHTMLString(opts?: DateHTMLStringOptions): string;

	/**
	 * Modifies the date with adding time units.
	 * The method mutates the original date.
	 *
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	add(units: DateSetParams, reset?: boolean): Date;

	/**
	 * Modifies the date with setting time units.
	 * The method mutates the original date.
	 *
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	set(units: DateSetParams, reset?: boolean): Date;

	/**
	 * Modifies the date with subtracting time units.
	 * The method mutates the original date.
	 *
	 * @param units
	 * @param reset - if true, then all lower units will be reset to zero
	 */
	rewind(units: DateSetParams, reset?: boolean): Date;

	/**
	 * Returns a relative value of the date for the now date
	 */
	relative(): DateRelative;

	/**
	 * Returns a relative value of the date for another date
	 * @param date - another date to compare
	 */
	relativeTo(date: DateCreateValue): DateRelative;

	/**
	 * Returns a number of days in the date month
	 */
	daysInMonth(): number;
}

interface ThrottleOptions {
	/**
	 * Delay to wait in milliseconds
	 * @default `250`
	 */
	delay?: number;

	/**
	 * If true, then all rest invokes that caught in the sleep span are ignored
	 * @default `false`
	 */
	single?: boolean;
}

interface FunctionConstructor {
	/**
	 * Link to the special functional placeholder that can be used with curried functions
	 *
	 * @example
	 * ```js
	 * function sum(a, b) {
	 *   return a + b;
	 * }
	 *
	 * sum.curry()(Function.__, 2)(5)
	 * ```
	 */
	__: TB.__;

	/**
	 * Returns a new function that allows to invoke the specified function only once
	 * @param fn
	 */
	once<T extends AnyFunction>(fn: T): T;

	/**
	 * Returns a new function that allows to invoke a function, which it takes, only with the specified delay.
	 * The next invocation of the function will cancel the previous.
	 *
	 * @param delay
	 */
	debounce(delay: number): <A extends any[]>(fn: AnyFunction<A>) => AnyFunction<A, void>;

	/**
	 * Returns a new function that allows to invoke the function only with the specified delay.
	 * The next invocation of the function will cancel the previous.
	 *
	 * @param fn
	 * @param [delay]
	 */
	debounce<A extends any[]>(fn: AnyFunction<A>, delay?: number): AnyFunction<A, void>;

	/**
	 * Returns a new function that allows to invoke a function, which it takes, not more often than the specified delay.
	 * The first invoking of a function will run immediately, but all rest invokes will be merged to one and
	 * executes after the specified delay.
	 *
	 * @param delay
	 */
	throttle(delay: number): <A extends any[]>(fn: AnyFunction<A>) => AnyFunction<A, void>;

	/**
	 * Returns a new function that allows to invoke a function, which it takes, not more often than the specified delay.
	 * The first invoking of a function will run immediately, but all rest invokes will be merged to one and
	 * executes after the specified delay.
	 *
	 * @param opts - options for the operation
	 */
	throttle(opts: ThrottleOptions): <A extends any[]>(fn: AnyFunction<A>) => AnyFunction<A, void>;

	/**
	 * Returns a new function that allows to invoke the function not more often than the specified delay.
	 * The first invoking of a function will run immediately, but all rest invokes will be merged to one and
	 * executes after the specified delay.
	 *
	 * @param fn
	 * @param [delay]
	 */
	throttle<A extends any[]>(fn: AnyFunction<A>, delay?: number): AnyFunction<A, void>;

	/**
	 * Returns a new function that allows to invoke the function not more often than the specified delay.
	 * The first invoking of a function will run immediately, but all rest invokes will be merged to one and
	 * executes after the specified delay.
	 *
	 * @param fn
	 * @param opts - options for the operation
	 */
	throttle<A extends any[]>(fn: AnyFunction<A>, opts: ThrottleOptions): AnyFunction<A, void>;

	/**
	 * Returns a curried equivalent of the provided function.
	 *
	 * The curried function has two unusual capabilities.
	 * First, its arguments needn't be provided one at a time.
	 * If f is a ternary function and g is Function.curry(f), the following are equivalent:
	 *
	 * ```js
	 * g(1)(2)(3)
	 * g(1)(2, 3)
	 * g(1, 2)(3)
	 * g(1, 2, 3)
	 * ```
	 *
	 * Secondly, the special placeholder value Function.__ may be used to specify "gaps", allowing partial application
	 * of any combination of arguments, regardless of their positions. If g is as above and _ is Function.__,
	 * the following are equivalent:
	 *
	 * ```js
	 * g(1, 2, 3)
	 * g(_, 2, 3)(1)
	 * g(_, _, 3)(1)(2)
	 * g(_, _, 3)(1, 2)
	 * g(_, 2)(1)(3)
	 * g(_, 2)(1, 3)
	 * g(_, 2)(_, 3)(1)
	 * ```
	 */
	curry<T extends AnyFunction>(f: T): TB.Curry<T>;

	/**
	 * Performs right-to-left function composition.
	 * The last argument may have any arity; the remaining arguments must be unary.
	 *
	 * If any function from parameters returns a Promise, the next function from the parameters
	 * will take the resolved value of that promise,
	 * the final result of calling the composition function is also a promise.
	 *
	 * @param fn0
	 */
	compose<A extends any[], T1>(fn0: AnyFunction<A, T1>): AnyFunction<A, T1>;

	compose<A extends any[], T1, T2>(
		fn1: AnyOneArgFunction<PromiseType<T1>, T2>,
		fn0: AnyFunction<A, T1>
	): AnyFunction<A, T1 extends Promise<any> ? NewPromise<T1, T2> : T2>;

	compose<A extends any[], T1, T2, T3>(
		fn2: AnyOneArgFunction<PromiseType<T2>, T3>,
		fn1: AnyOneArgFunction<PromiseType<T1>, T2>,
		fn0: AnyFunction<A, T1>
	): AnyFunction<A, T2 extends Promise<any> ? Promise<T3> : T1 extends Promise<any> ? Promise<T3> : T3>;

	compose<A extends any[], T1, T2, T3, T4>(
		fn3: AnyOneArgFunction<PromiseType<T3>, T4>,
		fn2: AnyOneArgFunction<PromiseType<T2>, T3>,
		fn1: AnyOneArgFunction<PromiseType<T1>, T2>,
		fn0: AnyFunction<A, T1>
	): AnyFunction<
		A,
		T3 extends Promise<any> ?
			Promise<T4> : T2 extends Promise<any> ?
				Promise<T4> : T1 extends Promise<any> ?
					Promise<T4> : T4
	>;

	compose<A extends any[], T1, T2, T3, T4, T5>(
		fn4: AnyOneArgFunction<PromiseType<T4>, T5>,
		fn3: AnyOneArgFunction<PromiseType<T3>, T4>,
		fn2: AnyOneArgFunction<PromiseType<T2>, T3>,
		fn1: AnyOneArgFunction<PromiseType<T1>, T2>,
		fn0: AnyFunction<A, T1>
	): AnyFunction<
		A,
		T4 extends Promise<any> ?
			Promise<T5> : T3 extends Promise<any> ?
				Promise<T5> : T2 extends Promise<any> ?
					Promise<T5> : T1 extends Promise<any> ?
						Promise<T5> : T5
	>;

	compose<A extends any[], T1, T2, T3, T4, T5, T6>(
		fn5: AnyOneArgFunction<PromiseType<T5>, T6>,
		fn4: AnyOneArgFunction<PromiseType<T4>, T5>,
		fn3: AnyOneArgFunction<PromiseType<T3>, T4>,
		fn2: AnyOneArgFunction<PromiseType<T2>, T3>,
		fn1: AnyOneArgFunction<PromiseType<T1>, T2>,
		fn0: AnyFunction<A, T1>
	): AnyFunction<
		A,
		T5 extends Promise<any> ?
			Promise<T6> : T4 extends Promise<any> ?
				Promise<T6> : T3 extends Promise<any> ?
					Promise<T6> : T2 extends Promise<any> ?
						Promise<T6> : T1 extends Promise<any> ?
							Promise<T6> : T6
		>;
}

interface Function {
	/**
	 * Returns a new function that allows to invoke the target function only once
	 */
	once<T>(this: T): T;

	/**
	 * Returns a new function that allows to invoke the target function only with the specified delay.
	 * The next invocation of the function will cancel the previous.
	 *
	 * @param [delay]
	 */
	debounce<T extends AnyFunction>(this: T, delay?: number): AnyFunction<Parameters<T>, void>;

	/**
	 * Returns a new function that allows to invoke the target function not more often than the specified delay.
	 * The first invoking of a function will run immediately, but all rest invokes will be merged to one and
	 * executes after the specified delay.
	 *
	 * @param [delay]
	 */
	throttle<T extends AnyFunction>(this: T, delay?: number): AnyFunction<Parameters<T>, void>;

	/**
	 * Returns a new function that allows to invoke the target function not more often than the specified delay.
	 * The first invoking of a function will run immediately, but all rest invokes will be merged to one and
	 * executes after the specified delay.
	 *
	 * @param opts - options for the operation
	 */
	throttle<T extends AnyFunction>(this: T, opts: ThrottleOptions): AnyFunction<Parameters<T>, void>;

	/**
	 * Returns a new function based on the target that wraps the returning value into the Either structure.
	 * If the first argument of the created function is taken null or undefined, the function returns the rejected value.
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * toLowerCase.option()(null).catch((err) => err === null);
	 * toLowerCase.option()(1).catch((err) => err.message === 'str.toLowerCase is not a function');
	 *
	 * toLowerCase.option()('FOO').then((value) => value === 'foo');
	 * toLowerCase.option()(toLowerCase.option()('FOO')).then((value) => value === 'foo');
	 * ```
	 */
	option<R>(this: () => R): AnyFunction<any[], Maybe<R>>;

	/**
	 * Returns a new function based on the target that wraps the returning value into the Either structure.
	 * If the first argument of the created function is taken null or undefined, the function returns the rejected value.
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * toLowerCase.option()(null).catch((err) => err === null);
	 * toLowerCase.option()(1).catch((err) => err.message === 'str.toLowerCase is not a function');
	 *
	 * toLowerCase.option()('FOO').then((value) => value === 'foo');
	 * toLowerCase.option()(toLowerCase.option()('FOO')).then((value) => value === 'foo');
	 * ```
	 */
	option<A1, A extends any[], R>(this: (a1: A1, ...rest: A) => R):
		(a1: Maybe<Nullable<A1>> | Either<A1> | Nullable<A1>, ...rest: A) => Maybe<R>;

	/**
	 * Returns a new function based on the target that wraps the returning value into the Either structure
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * toLowerCase.result()(1).catch((err) => err.message === 'str.toLowerCase is not a function');
	 * toLowerCase.result()('FOO').then((value) => value === 'foo');
	 * toLowerCase.result()(toLowerCase.result()('FOO')).then((value) => value === 'foo');
	 * ```
	 */
	result<R>(this: () => R): AnyFunction<any[], Either<R>>;

	/**
	 * Returns a new function based on the target that wraps the returning value into the Either structure
	 *
	 * @example
	 * ```typescript
	 * function toLowerCase(str: string): string {
	 *   return str.toLowerCase();
	 * }
	 *
	 * toLowerCase.result()(1).catch((err) => err.message === 'str.toLowerCase is not a function');
	 * toLowerCase.result()('FOO').then((value) => value === 'foo');
	 * toLowerCase.result()(toLowerCase.result()('FOO')).then((value) => value === 'foo');
	 * ```
	 */
	result<A1, A extends any[], R>(this: (a1: A1, ...rest: A) => R):
		(a1: Maybe<A1> | Either<A1>, ...rest: A) => Either<R>;

	/**
	 * Returns a curried equivalent of the function.
	 *
	 * The curried function has two unusual capabilities.
	 * First, its arguments needn't be provided one at a time.
	 * If f is a ternary function and g is f.curry(), the following are equivalent:
	 *
	 * ```js
	 * g(1)(2)(3)
	 * g(1)(2, 3)
	 * g(1, 2)(3)
	 * g(1, 2, 3)
	 * ```
	 *
	 * Secondly, the special placeholder value Function.__ may be used to specify "gaps", allowing partial application
	 * of any combination of arguments, regardless of their positions. If g is as above and _ is Function.__,
	 * the following are equivalent:
	 *
	 * ```js
	 * g(1, 2, 3)
	 * g(_, 2, 3)(1)
	 * g(_, _, 3)(1)(2)
	 * g(_, _, 3)(1, 2)
	 * g(_, 2)(1)(3)
	 * g(_, 2)(1, 3)
	 * g(_, 2)(_, 3)(1)
	 * ```
	 */
	curry<T extends AnyFunction>(this: T): TB.Curry<T>;

	/**
	 * Performs left-to-right function composition.
	 * The first argument may have any arity; the remaining arguments must be unary.
	 *
	 * If any function from parameters returns a Promise, the next function from the parameters
	 * will take the resolved value of that promise,
	 * the final result of calling the composition function is also a promise.
	 */
	compose<T>(this: T): T;

	compose<A extends any[], T1, T2>(
		this: AnyFunction<A, T1>,
		fn1: AnyOneArgFunction<T1, T2>
	): AnyFunction<A, T1 extends Promise<any> ? Promise<T2> : T2>;

	compose<A extends any[], T1, T2, T3>(
		this: AnyFunction<A, T1>,
		fn1: AnyOneArgFunction<T1, T2>,
		fn2: AnyOneArgFunction<T2, T3>
	): AnyFunction<A, T2 extends Promise<any> ? Promise<T3> : T1 extends Promise<any> ? Promise<T3> : T3>;

	compose<A extends any[], T1, T2, T3, T4>(
		this: AnyFunction<A, T1>,
		fn1: AnyOneArgFunction<T1, T2>,
		fn2: AnyOneArgFunction<T2, T3>,
		fn3: AnyOneArgFunction<T3, T4>
	): AnyFunction<
		A,
		T3 extends Promise<any> ?
			Promise<T4> : T2 extends Promise<any> ?
				Promise<T4> : T1 extends Promise<any> ?
					Promise<T4> : T4
	>;

	compose<A extends any[], T1, T2, T3, T4, T5>(
		this: AnyFunction<A, T1>,
		fn1: AnyOneArgFunction<T1, T2>,
		fn2: AnyOneArgFunction<T2, T3>,
		fn3: AnyOneArgFunction<T3, T4>,
		fn4: AnyOneArgFunction<T4, T5>
	): AnyFunction<
		A,
		T4 extends Promise<any> ?
			Promise<T5> : T3 extends Promise<any> ?
				Promise<T5> : T2 extends Promise<any> ?
					Promise<T5> : T1 extends Promise<any> ?
						Promise<T5> : T5
	>;

	compose<A extends any[], T1, T2, T3, T4, T5, T6>(
		this: AnyFunction<A, T1>,
		fn1: AnyOneArgFunction<T1, T2>,
		fn2: AnyOneArgFunction<T2, T3>,
		fn3: AnyOneArgFunction<T3, T4>,
		fn4: AnyOneArgFunction<T4, T5>,
		fn5: AnyOneArgFunction<T5, T6>
	): AnyFunction<
		A,
		T5 extends Promise<any> ?
			Promise<T6> : T4 extends Promise<any> ?
				Promise<T6> : T3 extends Promise<any> ?
					Promise<T6> : T2 extends Promise<any> ?
						Promise<T6> : T1 extends Promise<any> ?
							Promise<T6> : T6
		>;
}