atomic-fns 0.3.5 → 0.4.3

package/{core → dist}/globals/index.d.ts

@@ -3,12 +3,13 @@
  *
  * @module Globals
  */
+export * from './decimal.js';
 /** This is just a noop function. */
 export declare const noop: () => void;
 /**
  * A generic function type with arbitrary arguments and return.
  */
-export declare type Function<T = any> = (...args: any) => T;
+export declare type Function<TReturn = any> = (...args: any) => TReturn;
 /**
  * An iteratee function used for collection methods.
  * @see {@link Collections.filter}
@@ -22,8 +23,8 @@ export declare type Function<T = any> = (...args: any) => T;
  * @see {@link Collections.sortedUniq}
  * @see {@link Collections.groupBy}
  */
-export declare type Iteratee<T = any, K = any> = (value: T, key?: K, arr?: any) => any;
-export declare type Predicate<T = any> = (value: T) => any;
+export declare type Iteratee<T = any, K = any, TResult = any> = (value: T, key?: K, arr?: any) => TResult;
+export declare type Predicate<T = any, TReturn = any> = (value: T) => TReturn;
 /** A function that always returns `true`. */
 export declare const True: () => boolean;
 /** A function that always returns `false`. */
@@ -79,12 +80,12 @@ export declare class ValueError extends CustomError {
 export declare class ZeroDivisionError extends CustomError {
 }
 /**
- * Returns the true type of any value with correct detection for null, Array,
- * Object, Promise, Symbol, and NaN. The correct values are inferred from {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag | Symbol.toStringTag} and the value's prototype.
+ * Returns the true type of any value with correct detection for `null`, `Array`,
+ * `Object`, `Promise`, `Symbol`, and `NaN`. The correct values are inferred from {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag | Symbol.toStringTag} and the value's prototype.
  * @param value
  * @returns The value type.
  */
-export declare function type(value: any): any;
+export declare function type(value: any): string;
 /**
  * Returns a string representing the object.
  * @param obj
@@ -92,7 +93,6 @@ export declare function type(value: any): any;
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString | Object.toString }
  */
 export declare const str: (obj: any) => any;
-export declare function hasOwnProperty(obj: any, prop: any): boolean;
 /** Check if value is a boolean type. */
 export declare const isBool: (x: any) => x is boolean;
 /** Check if value is an `Error` type. */
@@ -118,8 +118,6 @@ export declare const isNumber: (x: any) => x is number;
 export declare const isInteger: (x: any) => x is number;
 /** Check if value is a bigint type. */
 export declare const isBigint: (x: any) => x is BigInt;
-/** Check if value is NaN based on `Number.isNaN`. */
-export declare const isNaN: (x: any) => x is number;
 /** Check if value is a Promise type. */
 export declare const isPromise: (x: any) => x is Promise<any>;
 /** Check if value is a function type. */
@@ -129,9 +127,9 @@ export declare const isAsyncFunction: (x: any) => boolean;
 /** Check if value is a generator function type. */
 export declare const isGenerator: (x: any) => x is Generator<unknown, any, unknown>;
 /** Check if value is `null` or `undefined`. */
-export declare const isNull: (x: any) => x is null | undefined;
+export declare const isNull: (x: any) => x is null;
 /** Check if value === `undefined`. */
-export declare function isUndefined(o: any): boolean;
+export declare const isUndefined: (x: any) => x is undefined;
 /** Check if value is not `null` or `undefined`. */
 export declare const notNull: (x: any) => boolean;
 /** Returns `true` for objects without length or falsy values. */
@@ -156,7 +154,7 @@ export declare const isWeakMap: <K extends object, V>(x: any) => x is WeakMap<K,
  * @param value
  * @returns The number of elements in the collection or `undefined`.
  */
-export declare function len(value: any): any;
+export declare function len(value: any): number;
 /**
  * Generates a unique ID using random numbers. If a prefix is given, the ID is appended to it and returned as a string.
  * @param {string} [pre=''] The id prefix.
@@ -164,20 +162,20 @@ export declare function len(value: any): any;
  * @example
 ```js
 uniqueId()
-// => 3445556877
+// 3445556877
 
 uniqueId('user_')
-// => 'user_1033763188'
+// 'user_1033763188'
 ```
  */
-export declare const uniqueId: (pre?: string) => any;
+export declare const uniqueId: (pre?: string) => string;
 /**
  * Generates a monotonically increasing, pseudo-random based uuid-v4 string. These are sortable, url-friendly and are 100% unique if the IDs are generated more than 1 millisecond apart. If two IDs are generated at the same millisecond, the chance of collision is still pretty low (1 in 10^15).
  * @returns Returns a GUID formatted string.
  * @example
 ```js
 uuid()
-// => '183f8ef3-b8f0-4000-81f5-89234c836d00'
+// '183f8ef3-b8f0-4000-81f5-89234c836d00'
 ```
  */
 export declare const uuid: () => string;
@@ -213,7 +211,7 @@ export declare const values: (object: any) => unknown[];
  * @param attr A property key name.
  * @returns `true` if the object has the property name.
  */
-export declare const has: (obj: any, attr: PropertyKey) => any;
+export declare const has: (obj: any, attr: PropertyKey) => boolean;
 /**
  * Check if the attribute is present in the object or return a default value instead.
  * @param {PropertyKey} key
@@ -221,14 +219,15 @@ export declare const has: (obj: any, attr: PropertyKey) => any;
  * @param {*} [value=undefined]
  * @return The property value or default value.
  */
-export declare function get(key: PropertyKey | PropertyKey[], obj: any, value?: any): any;
+export declare function get<T>(key: PropertyKey, obj: T, value?: any): any;
+export declare function get<T>(key: PropertyKey[], obj: T, value?: any): any;
 /**
  * Deletes a given property key from an object.
  * @param attr The property name.
  * @param x The given object.
  * @returns The modified object.
  */
-export declare function del(attr: PropertyKey, x: any): any;
+export declare function del<T>(attr: PropertyKey, x: T): T;
 /**
  * Adds a property to an object, or modifies the existing value.
  * @param attr The name or Symbol of the property to be defined or modified.
@@ -245,7 +244,8 @@ export declare const HASH_KEY: unique symbol;
  * @param obj The given object.
  * @returns The hash value.
  */
-export declare function hash(obj: any): any;
+export declare function hash(obj: string): number;
+export declare function hash<T>(obj: T): T;
 /**
  * A hash value generator for strings.
  * @param {string} str The given string.
@@ -277,24 +277,25 @@ export declare const oct: (n: number) => string;
  * @returns A floating point number parsed from the given value or `NaN`.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseFloat parseFloat}
  */
-export declare const float: (x: any) => number;
+export declare const float: (x: string) => number;
 /**
  * Returns an integer number constructed from a number or string `x`.
  * @param x The number or string.
  * @returns An integer number parsed from the given value or `NaN`.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseInt parseInt}
  */
-export declare const int: (x: any, base?: number) => number;
+export declare const int: (x: string, base?: number) => number;
 /**
  * Converts the value to an array using `Array.from()`.
  * @param value
  * @returns A new array value.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/from Array.from()}
  */
-export declare const list: (value?: any) => unknown[];
+export declare const list: <T>(value?: any) => T[];
 /**
- * Retrieve the next item from the iterator by calling it's `next()` method.
+ * Retrieve the next item from the iterator by calling its `next()` method.
  * @param iter The iterator.
  * @returns The next value from the iterator.
  */
-export declare const next: (iter: Iterator<any> | Generator) => any;
+export declare function next<T>(iter: Iterator<T>): T | undefined;
+export declare function next<T>(iter: Generator<any, T>): T | undefined;

package/{core → dist}/globals/index.js

@@ -3,6 +3,7 @@
  *
  * @module Globals
  */
+export * from './decimal.js';
 /** This is just a noop function. */
 export const noop = () => { };
 /** A function that always returns `true`. */
@@ -69,8 +70,8 @@ export class ValueError extends CustomError {
 export class ZeroDivisionError extends CustomError {
 }
 /**
- * Returns the true type of any value with correct detection for null, Array,
- * Object, Promise, Symbol, and NaN. The correct values are inferred from {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag | Symbol.toStringTag} and the value's prototype.
+ * Returns the true type of any value with correct detection for `null`, `Array`,
+ * `Object`, `Promise`, `Symbol`, and `NaN`. The correct values are inferred from {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag | Symbol.toStringTag} and the value's prototype.
  * @param value
  * @returns The value type.
  */
@@ -122,9 +123,6 @@ export function type(value) {
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString | Object.toString }
  */
 export const str = (obj) => (obj != null ? obj.toString() : '');
-export function hasOwnProperty(obj, prop) {
-    return Object.prototype.hasOwnProperty.call(obj, prop);
-}
 /** Check if value is a boolean type. */
 export const isBool = (x) => type(x) === 'boolean';
 /** Check if value is an `Error` type. */
@@ -138,7 +136,7 @@ export const isIterable = (x) => {
 /** Check if value is a native `Date` type. */
 export const isDate = (x) => x instanceof Date;
 /** Check if value is an object type. */
-export const isObject = (x) => typeof x === 'object' && type(x) === 'object';
+export const isObject = (x) => type(x) === 'object';
 /** Check if value is a string type. */
 export const isString = (x) => type(x) === 'string';
 /** Check if value is an Array type. */
@@ -154,11 +152,9 @@ export const isArrayLike = (x) => {
 /** Check if value is a number type. */
 export const isNumber = (x) => type(x) === 'number';
 /** Check if value is an integer number type. */
-export const isInteger = (x) => type(x) === 'number' && Math.floor(x) === x;
+export const isInteger = (x) => type(x) === 'number' && Math.trunc(x) === x;
 /** Check if value is a bigint type. */
 export const isBigint = (x) => type(x) === 'bigint';
-/** Check if value is NaN based on `Number.isNaN`. */
-export const isNaN = (x) => Number.isNaN(x);
 /** Check if value is a Promise type. */
 export const isPromise = (x) => type(x) === 'Promise';
 /** Check if value is a function type. */
@@ -172,9 +168,7 @@ export const isGenerator = (x) => {
 /** Check if value is `null` or `undefined`. */
 export const isNull = (x) => x == null;
 /** Check if value === `undefined`. */
-export function isUndefined(o) {
-    return typeof o === 'undefined';
-}
+export const isUndefined = (x) => x === undefined;
 /** Check if value is not `null` or `undefined`. */
 export const notNull = (x) => x != null;
 /** Returns `true` for objects without length or falsy values. */
@@ -205,12 +199,12 @@ export function len(value) {
     if (isNumber(value.length)) {
         return value.length;
     }
-    if (isFunction(value.size)) {
-        return value.size();
-    }
     if (isNumber(value.size)) {
         return value.size;
     }
+    if (isFunction(value.size)) {
+        return value.size();
+    }
     if (isObject(value)) {
         return Object.keys(value).length;
     }
@@ -222,10 +216,10 @@ export function len(value) {
  * @example
 ```js
 uniqueId()
-// => 3445556877
+// 3445556877
 
 uniqueId('user_')
-// => 'user_1033763188'
+// 'user_1033763188'
 ```
  */
 export const uniqueId = (pre = '') => 
@@ -237,7 +231,7 @@ export const uniqueId = (pre = '') =>
  * @example
 ```js
 uuid()
-// => '183f8ef3-b8f0-4000-81f5-89234c836d00'
+// '183f8ef3-b8f0-4000-81f5-89234c836d00'
 ```
  */
 export const uuid = () => {
@@ -281,14 +275,7 @@ export const values = (object) => Object.values(object);
  * @returns `true` if the object has the property name.
  */
 export const has = (obj, attr) => obj && attr in obj;
-/**
- * Check if the attribute is present in the object or return a default value instead.
- * @param {PropertyKey} key
- * @param {*} obj
- * @param {*} [value=undefined]
- * @return The property value or default value.
- */
-export function get(key, obj, value = undefined) {
+export function get(key, obj, value) {
     if (obj == null)
         return value;
     let paths = Array.isArray(key) ? key : [key];
@@ -334,11 +321,6 @@ export function set(attr, obj, value, writable = false, enumerable = false) {
     });
 }
 export const HASH_KEY = Symbol.for('HASH_KEY');
-/**
- * Return a hash value for a given object. The hash will be the same for subsequent invocations.
- * @param obj The given object.
- * @returns The hash value.
- */
 export function hash(obj) {
     if (typeof obj === 'string') {
         return hashCode(obj);
@@ -406,9 +388,6 @@ export const int = (x, base = 10) => parseInt(x, base);
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/from Array.from()}
  */
 export const list = (value) => (value ? Array.from(value) : []);
-/**
- * Retrieve the next item from the iterator by calling it's `next()` method.
- * @param iter The iterator.
- * @returns The next value from the iterator.
- */
-export const next = (iter) => iter.next().value;
+export function next(iter) {
+    return iter.next().value;
+}

package/dist/i18n/currency.d.ts

@@ -0,0 +1,24 @@
+import { Decimal } from '../globals/decimal.js';
+/**
+ * Currency represents a local currency amount that can be formatted using the `Intl` apis.
+ */
+export declare class Currency extends Decimal {
+    locale: string;
+    currency: string;
+    numberFormat: Intl.NumberFormat;
+    options: Intl.NumberFormatOptions;
+    constructor(amount: any, currency: string, locale?: string, opts?: Intl.NumberFormatOptions);
+    clone(n: any): Currency;
+    negated(): Currency;
+    add(x: any): Currency;
+    sub(x: any): Currency;
+    div(x: any): Currency;
+    mul(x: any): Currency;
+    toDecimal(): any;
+    toString(): string;
+    format(opts?: Intl.NumberFormatOptions, locale?: string): string;
+    displayName(): string;
+    accounting(): string;
+    precision(digits?: number): string;
+    eq(x: any): any;
+}

package/dist/i18n/currency.js

@@ -0,0 +1,85 @@
+import { defaults } from '../collections/index.js';
+import { isObject } from '../globals/index.js';
+import { Decimal } from '../globals/decimal.js';
+/**
+ * Currency represents a local currency amount that can be formatted using the `Intl` apis.
+ */
+export class Currency extends Decimal {
+    locale;
+    currency;
+    numberFormat;
+    options = {
+        style: 'currency',
+        currencyDisplay: 'symbol',
+        maximumFractionDigits: 20
+    };
+    constructor(amount, currency, locale, opts = {}) {
+        super(amount);
+        if (isObject(locale)) {
+            opts = locale;
+            locale = undefined;
+        }
+        const systemLocale = new Intl.NumberFormat(locale, defaults(opts, { currency }, this.options));
+        const resolved = systemLocale.resolvedOptions();
+        this.numberFormat = systemLocale;
+        this.options.currency = currency;
+        this.currency = resolved.currency;
+        this.locale = resolved.locale;
+    }
+    // @ts-expect-error overrides
+    clone(n) {
+        return new Currency(n, this.currency, this.locale, this.options);
+    }
+    // @ts-expect-error overrides
+    negated() {
+        const n = super.negated.call(this);
+        return this.clone(n);
+    }
+    // @ts-expect-error overrides
+    add(x) {
+        const n = super.add.call(this.toDecimal(), x);
+        return this.clone(n);
+    }
+    // @ts-expect-error overrides
+    sub(x) {
+        const n = super.sub.call(this.toDecimal(), x);
+        return this.clone(n);
+    }
+    // @ts-expect-error overrides
+    div(x) {
+        const n = super.div.call(this.toDecimal(), x);
+        return this.clone(n);
+    }
+    // @ts-expect-error overrides
+    mul(x) {
+        const n = super.mul.call(this.toDecimal(), x);
+        return this.clone(n);
+    }
+    toDecimal() {
+        return super.clone.call(this);
+    }
+    toString() {
+        const number = this.toNumber();
+        return this.numberFormat.format(number);
+    }
+    format(opts = {}, locale) {
+        const number = this.toNumber();
+        opts = defaults(opts, this.options);
+        return new Intl.NumberFormat(locale ?? this.locale, opts).format(number);
+    }
+    displayName() {
+        return this.format({ currencyDisplay: 'name' });
+    }
+    accounting() {
+        return this.format({ currencySign: 'accounting' });
+    }
+    precision(digits) {
+        return this.format({ maximumFractionDigits: digits });
+    }
+    eq(x) {
+        if (x?.currency && x.currency !== this.currency) {
+            return false;
+        }
+        return super.eq.call(this, x);
+    }
+}

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

@@ -0,0 +1,204 @@
+import { Duration, DurationUnit, TDuration } from '../duration.js';
+import { asDate, formatDate, strftime } from '../format.js';
+import { DateObject, daysInMonth, daysInYear, isLeapYear, maxDate, minDate, weeksInYear } from './utils.js';
+export { asDate, daysInMonth, daysInYear, formatDate, isLeapYear, maxDate, minDate, strftime, weeksInYear };
+export { DateObject };
+export declare type DateInput = number | string | Date;
+export declare type DateLike = DateInput | IntlDate | DateObject;
+/**
+ * Creates a date tied to a given locale (default system locale) which can be formatted in that locale's language using the native {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl Intl Apis} directly or using a formatting string.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl Intl Apis}
+ */
+export declare class IntlDate {
+    private _date;
+    readonly locale?: string;
+    intlRelativeFormat: Intl.RelativeTimeFormat;
+    /** Parses the provided value as UTC date or returns the current UTC date. */
+    static UTC(value?: DateLike, locale?: string): IntlDate;
+    /** Returns the current local date and time.*/
+    static now(): IntlDate;
+    /** Creates a new date from a Unix timestamp (seconds since the unix epoch) */
+    static unix(seconds: number): IntlDate;
+    /**
+     * Creates a new `IntlDate` in local time and specified locale (default is system locale).
+     * **Note:** The allowed values for `month` start at 1, which is different from legacy `Date`
+     * @param {DateLike} obj The date value (default is current local time)
+     * @param {Object} opts The options for this date
+     * @param {boolean?} opts.utc Converts input or current time to UTC
+     * @param {string?} opts.locale A locale string to use for this date
+     * @returns
+     */
+    constructor(obj?: DateLike, { locale, utc }?: any);
+    /** Get the date's year. */
+    get year(): number;
+    /** Get the this date's month as a number from 1 to 12, inclusive. */
+    get month(): number;
+    /** Returns the weekday as a number between 1 and 7, inclusive, where Monday is 1 and Sunday is 7. */
+    get dayOfWeek(): number;
+    /** Get the this date's current day of the month. */
+    get day(): number;
+    /** Get the this date's current hour. */
+    get hour(): number;
+    /** Get the this date's current minute. */
+    get minute(): number;
+    /** Get the this date's current second. */
+    get second(): number;
+    /** Get the this date's current millisecond. */
+    get millisecond(): number;
+    isValid(): boolean;
+    /** Get the number of days in this date's month. */
+    daysInMonth(): number;
+    /** Get the number of days in this date's year. */
+    daysInYear(): number;
+    dayOfYear(): number;
+    /** Returns `true` if this date's year is a leap year. */
+    isLeapYear(): boolean;
+    /** Gets the number of weeks according to locale in the current year. */
+    weeksInYear(): number;
+    /** Gets the number of weeks in the current year, according to ISO weeks. */
+    isoWeeksInYear(): number;
+    /** Returns the current week of the year. */
+    week(): any;
+    /** Returns the ISO week of the year. */
+    isoWeek(): any;
+    /**
+     * Returns a localized string representation of this date.
+     * @param {Intl.DateTimeFormatOptions} opts The options to use for the format
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat Intl.DateTimeFormat()}
+     */
+    toString(opts?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Returns a localized string representation of this date, according to the given format string. Format codes use the same specification as {@link https://momentjs.com/docs/#/displaying/format/ moment}.
+     * @param {string} str The format string to use
+     * @see {@link https://momentjs.com/docs/#/displaying/format/ List of formats}
+     * @example
+  ```js
+  new IntlDate().format('MM/DD/YYYY') // '10/31/2022'
+  ```
+     */
+    format(str: string): string;
+    /**
+     * Returns a new copy of the native `Date` object used by this instance.
+     * @returns {Date} A new `Date` object
+     */
+    toDate(): Date;
+    /**
+     * Returns the number of seconds since the Unix Epoch (January 1, 1970 UTC).
+     * @see {@link IntlDate.timestamp}
+     * @see {@link IntlDate.unix}
+     * @example
+  ```js
+  new IntlDate().toSeconds() // 1318874398
+  ```
+     */
+    toSeconds(): number;
+    /**
+     * Returns the number of seconds since the Unix Epoch (January 1, 1970 UTC).
+     * @see {@link IntlDate.toSeconds}
+     * @see {@link IntlDate.unix}
+     * @example
+  ```js
+  new IntlDate().timestamp() // 1318874398
+  ```
+     */
+    timestamp(): number;
+    /**
+     * Returns the number of seconds since the Unix Epoch (January 1, 1970 UTC).
+     * @see {@link IntlDate.toSeconds}
+     * @see {@link IntlDate.timestamp}
+     * @example
+  ```js
+  new IntlDate().unix() // 1318874398
+  ```
+     */
+    unix(): number;
+    /** Formats a string to the ISO8601 standard.
+     * @example
+  ```js
+  new IntlDate().toISOString() // '2022-10-31T22:44:30.652Z'
+  ```
+     */
+    toISOString(): string;
+    /** Returns the date part formatted as ISO8601.
+     * @example
+  ```js
+  new IntlDate().toISODate() // '2022-10-31'
+  ```
+     */
+    toISODate(): string;
+    /** Returns the time part formatted as ISO8601.
+     * @example
+  ```js
+  new IntlDate().toISOTime() // 'T22:44:30.652Z'
+  ```
+     */
+    toISOTime(): string;
+    /**
+     * Returns an object containing year, month, day-of-month, hours, minutes, seconds, milliseconds.
+     * @returns {Object} An object like `{year, month, date, hours, minutes, seconds, ms}`
+     */
+    toObject(): DateObject;
+    /** Returns the number of milliseconds since the Unix Epoch (January 1, 1970 UTC)  */
+    getTime(): number;
+    /** Alias of {@link IntlDate.getTime}  */
+    valueOf(): number;
+    /** Returns the timezone string name  */
+    zoneName(): string;
+    /** Returns the timezone GMT offset as a string  */
+    zone(): string;
+    /** Returns the difference in `minutes` between this date and UTC  */
+    utcOffset(): number;
+    /**
+     * Check if this date is before another date. The other value will be parsed as an `IntlDate` if not already so.
+     * @param {DateLike} other Another date or date like object
+     * @returns {boolean} Returns `true` if this date is before the given value
+     */
+    isBefore(other: DateLike): boolean;
+    /**
+     * Check if this date is strictly after the given `start` and before `stop` dates. The values will be parsed as an `IntlDate` if not already so.
+     * @param {DateLike} start The smaller date
+     * @param {DateLike} stop The larger date
+     * @returns {boolean} Returns `true` if this date is greater than `start` and less than `stop`.
+     */
+    isBetween(start: DateLike, stop: DateLike): boolean;
+    /**
+     * Check if this date is after another date. The other value will be parsed as an `IntlDate` if not already so.
+     * @param {DateLike} other Another date or date like object
+     * @returns {boolean} Returns `true` if this date is after the given value
+     */
+    isAfter(other: DateLike): boolean;
+    /**
+     * Check if this date is the same as `other`.
+     * @param other Another date object
+     * @returns {boolean} Returns `true` if this date is the same as other
+     */
+    isSame(other: Date | IntlDate): boolean;
+    lt(other: Date | IntlDate): boolean;
+    eq(other: Date | IntlDate): boolean;
+    compare(other: Date | IntlDate): number;
+    set(values: DateObject): IntlDate;
+    get relativeFormat(): Intl.RelativeTimeFormat;
+    relativeTime(n: number, unit?: Intl.RelativeTimeFormatUnit): string;
+    fromNow(unit?: Intl.RelativeTimeFormatUnit): string;
+    from(other: DateLike, unit?: Intl.RelativeTimeFormatUnit): string;
+    toNow(unit?: Intl.RelativeTimeFormatUnit): string;
+    to(other: DateLike, unit?: Intl.RelativeTimeFormatUnit): string;
+    diff(other: DateLike, unit?: DurationUnit, exact?: boolean): number;
+    add(duration: TDuration, exact?: boolean): IntlDate;
+    subtract(duration: TDuration, exact?: boolean): IntlDate;
+    startOf(unit: DurationUnit): IntlDate;
+    endOf(unit: DurationUnit): IntlDate;
+    clone(date?: DateLike): IntlDate;
+    static max(...args: any[]): any;
+    static min(...args: any[]): any;
+    inspect(): string;
+}
+export declare function addDuration(date: DateInput, duration: number | Duration | TDuration, exact?: boolean): Date;
+/**
+ * Subtract the specified years, months, weeks, days, hours, minutes and seconds from the given date.
+ * @param date
+ * @param duration
+ * @param exact
+ * @returns
+ */
+export declare function subDuration(date: DateInput, duration: number | Duration | TDuration, exact?: boolean): Date;