atomic-fns 1.1.6 → 1.2.0

package/dist/i18n/format.js

@@ -1,15 +1,33 @@
 const NATIVE_DATE = /^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[Tt\s]*(\d{1,2})?:?(\d{1,2})?:?(\d{1,2})?[.:]?(\d+)?$/;
-const REGEX_PARSE = /^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[Tt\s]*(\d{1,2})?:?(\d{1,2})?:?(\d{1,2})?[.:]?(\d+)?$/;
-const REGEX_FORMAT = /\[([^\]]+)]|Y{1,4}|M{1,4}|Q|D{1,2}|d{1,4}|H{1,2}|h{1,2}|a|A|m{1,2}|s{1,2}|Z{1,2}|z{1,4}|N{1,4}|LTS?|L{1,4}|l{1,4}|x|X|SSS/g;
+const REGEX_FORMAT = /\[([^\]]+)]|Y{1,4}|M{1,4}|Q|Do|D{1,2}|d{1,4}|H{1,2}|h{1,2}|a|A|m{1,2}|s{1,2}|Z{1,2}|z{1,4}|N{1,4}|LTS?|L{1,4}|l{1,4}|x|X|SSS/g;
 const FORMAT_DEFAULT = 'YYYY-MM-DDTHH:mm:ssZ';
-const padStart = (string, length, pad) => String(string).padStart(length, pad);
-const padZoneStr = (instance) => {
+const INVALID_DATE_STRING = 'Invalid Date';
+const ORDINAL_SUFFIXES = { one: 'st', two: 'nd', few: 'rd', other: 'th' };
+function padStart(string, length, pad) {
+    return String(string).padStart(length, pad);
+}
+function padYear(year) {
+    return `${year < 0 ? '-' : ''}${padStart(Math.abs(year), 4, '0')}`;
+}
+function padZoneStr(instance) {
     const negMinutes = -instance.getTimezoneOffset();
     const minutes = Math.abs(negMinutes);
     const hourOffset = Math.floor(minutes / 60);
     const minuteOffset = minutes % 60;
-    return `${negMinutes <= 0 ? '+' : '-'}${padStart(hourOffset, 2, '0')}:${padStart(minuteOffset, 2, '0')}`;
-};
+    return `${negMinutes >= 0 ? '+' : '-'}${padStart(hourOffset, 2, '0')}:${padStart(minuteOffset, 2, '0')}`;
+}
+export function fromFields(utc, year, month, day, hour, minute, second, ms) {
+    // Date reads the years 0 to 99 as 1900 to 1999, 400 years later the leap years still match
+    const shift = year >= 0 && year < 100 ? 400 : 0;
+    if (utc) {
+        const date = new Date(Date.UTC(year + shift, month, day, hour, minute, second, ms));
+        date.setUTCFullYear(date.getUTCFullYear() - shift);
+        return date;
+    }
+    const date = new Date(year + shift, month, day, hour, minute, second, ms);
+    date.setFullYear(date.getFullYear() - shift);
+    return date;
+}
 /**
  * Returns a new Date from the given arguments.
  * @param {string | number | Date} date The date value
@@ -27,22 +45,13 @@ export function asDate(date, utc = false) {
         const d = date.match(NATIVE_DATE);
         if (d) {
             const m = d[2] - 1 || 0;
-            const ms = (d[7] || '0').slice(0, 3);
-            if (utc) {
-                return new Date(Date.UTC(d[1], m, d[3] || 1, d[4] || 0, d[5] || 0, d[6] || 0, ms));
-            }
-            return new Date(d[1], m, d[3] || 1, d[4] || 0, d[5] || 0, d[6] || 0, ms);
+            const ms = (d[7] || '').padEnd(3, '0').slice(0, 3);
+            return fromFields(utc, Number(d[1]), m, d[3] || 1, d[4] || 0, d[5] || 0, d[6] || 0, ms);
         }
     }
     const fromDate = new Date(date);
     if (utc) {
-        fromDate.setFullYear(fromDate.getUTCFullYear());
-        fromDate.setMonth(fromDate.getUTCMonth());
-        fromDate.setDate(fromDate.getUTCDate());
-        fromDate.setHours(fromDate.getUTCHours());
-        fromDate.setMinutes(fromDate.getUTCMinutes());
-        fromDate.setSeconds(fromDate.getUTCSeconds());
-        fromDate.setMilliseconds(fromDate.getUTCMilliseconds());
+        return fromFields(false, fromDate.getUTCFullYear(), fromDate.getUTCMonth(), fromDate.getUTCDate(), fromDate.getUTCHours(), fromDate.getUTCMinutes(), fromDate.getUTCSeconds(), fromDate.getUTCMilliseconds());
     }
     return fromDate;
 }
@@ -54,7 +63,6 @@ const STRFTIME = {
     // weekday
     '%A': { weekday: l },
     '%a': { weekday: s },
-    '%aa': { weekday: n },
     // day
     '%d': { day: dd },
     '%-d': { day: n },
@@ -87,7 +95,6 @@ const STRFTIME = {
     // era
     '%N': { era: l, year: dd },
     '%n': { era: s, year: dd },
-    '%nn': { era: n, year: 'narrow' },
     // timeZoneName
     // '%Z': { timeZoneName: 'longGeneric', year: dd },
     // '%-Z': { timeZoneName: 'shortGeneric', year: dd },
@@ -134,34 +141,46 @@ const TOKENS = {
     NNN: { era: s, year: dd },
     NNNN: { era: l, year: dd },
     // timeZoneName
-    ZZ: { timeZoneName: 'longOffset', year: dd },
-    Z: { timeZoneName: 'shortOffset', year: dd },
     zzz: { timeZoneName: l, year: dd },
     z: { timeZoneName: s, year: dd }
 };
 const HOUR_PARTS = { '%I': 1, '%-I': 1, '%K': 1, '%k': 1 };
-const ERA_PARTS = { '%n': 1, '%N': 1, '%nn': 1 };
-const TZ_PARTS = { '%ZZ': 1, '%-ZZ': 1, '%-z': 1, '%z': 1, '%-Z': 1, '%Z': 1 };
-const formatter = (locale, opts) => new Intl.DateTimeFormat(locale, opts);
-const formatHour = (h, maxLength) => String(h % 12 || 12).padStart(maxLength, '0');
-const formatMeridiem = (hour, isLowercase) => {
+const ERA_PARTS = { '%n': 1, '%N': 1 };
+const TZ_PARTS = { '%-z': 1, '%z': 1, '%-Z': 1, '%Z': 1 };
+function formatter(locale, opts) {
+    return new Intl.DateTimeFormat(locale, opts);
+}
+function formatHour(h, maxLength) {
+    return String(h % 12 || 12).padStart(maxLength, '0');
+}
+function formatMeridiem(hour, isLowercase) {
     const m = hour < 12 ? 'AM' : 'PM';
     return isLowercase ? m.toLowerCase() : m;
-};
-const formatPart = (locale, t, date) => {
-    const value = formatter(locale, TOKENS[t]).format(date);
-    return value.split(/\s+/g).slice(1).join(' ');
-};
+}
+function formatOrdinal(day, locale) {
+    const rules = new Intl.PluralRules(locale, { type: 'ordinal' });
+    const isEnglish = rules.resolvedOptions().locale.split('-')[0] === 'en';
+    return isEnglish ? `${day}${ORDINAL_SUFFIXES[rules.select(day)]}` : String(day);
+}
+function formatPart(locale, opts, date, type) {
+    return (formatter(locale, opts)
+        .formatToParts(date)
+        .find((part) => part.type === type)?.value ?? '');
+}
 /**
  * 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
+ * @param {string} formatStr The format string to use
+ * @param {Date} date The date value
+ * @param {?string} locale The locale to use when formatting (default is system locale).
  * @see {@link https://momentjs.com/docs/#/displaying/format/ List of formats}
  * @example
 ```js
-formatDate(new Date(), 'MM/DD/YYYY') // '10/31/2022'
+formatDate('MM/DD/YYYY', new Date()) // '10/31/2022'
 ```
   */
 export function formatDate(formatStr, date, locale) {
+    if (Number.isNaN(date.getTime()))
+        return INVALID_DATE_STRING;
     const str = formatStr || FORMAT_DEFAULT;
     const zoneStr = padZoneStr(date);
     const time = {
@@ -181,12 +200,12 @@ export function formatDate(formatStr, date, locale) {
     };
     const matches = {
         ...time,
-        N: formatPart(locale, 'N', date),
-        NN: formatPart(locale, 'NN', date),
-        NNN: formatPart(locale, 'NNN', date),
-        NNNN: formatPart(locale, 'NNNN', date),
-        YY: String(date.getFullYear()).slice(-2),
-        YYYY: date.getFullYear(),
+        N: formatPart(locale, TOKENS.N, date, 'era'),
+        NN: formatPart(locale, TOKENS.NN, date, 'era'),
+        NNN: formatPart(locale, TOKENS.NNN, date, 'era'),
+        NNNN: formatPart(locale, TOKENS.NNNN, date, 'era'),
+        YY: padStart(Math.abs(date.getFullYear()) % 100, 2, '0'),
+        YYYY: padYear(date.getFullYear()),
         M: date.getMonth() + 1,
         MM: padStart(date.getMonth() + 1, 2, '0'),
         MMM: formatter(locale, TOKENS.MMM).format(date),
@@ -194,13 +213,14 @@ export function formatDate(formatStr, date, locale) {
         Q: Math.ceil((date.getMonth() + 1) / 3),
         D: date.getDate(),
         DD: padStart(date.getDate(), 2, '0'),
+        Do: formatOrdinal(date.getDate(), locale),
         d: date.getDay(),
         ddd: formatter(locale, TOKENS.ddd).format(date),
         dddd: formatter(locale, TOKENS.dddd).format(date),
-        Z: formatPart(locale, 'Z', date),
-        ZZ: formatPart(locale, 'ZZ', date),
-        z: formatPart(locale, 'z', date),
-        zzz: formatPart(locale, 'zzz', date),
+        Z: zoneStr,
+        ZZ: zoneStr.replace(':', ''),
+        z: formatPart(locale, TOKENS.z, date, 'timeZoneName'),
+        zzz: formatPart(locale, TOKENS.zzz, date, 'timeZoneName'),
         LT: `${time.h}:${time.mm} ${time.A}`,
         LTS: `${time.h}:${time.mm}:${time.ss} ${time.A}`,
         L: formatter(locale, DATE_SHORT_DD).format(date),
@@ -212,7 +232,7 @@ export function formatDate(formatStr, date, locale) {
         lll: formatter(locale, DATE_MED_TIME).format(date),
         llll: formatter(locale, DATE_MED_WITH_WEEKDAY).format(date)
     };
-    return str.replace(REGEX_FORMAT, (match, $1) => $1 || matches[match] || zoneStr.replace(':', '')); // 'ZZ'
+    return str.replace(REGEX_FORMAT, (match, $1) => $1 ?? matches[match] ?? match);
 }
 /**
  * Formats a date using a formatting string in the {@link https://strftime.org/ strftime} format, in any given locale.
@@ -221,11 +241,18 @@ export function formatDate(formatStr, date, locale) {
  * @param {?string} locale The locale to use when formatting (default is system locale).
  * @returns {string} The string representation of date
  * @see {@link https://strftime.org/ strftime format}
+ * @example
+```js
+strftime('%A, %d/%m/%y', new Date())
+// 'Saturday, 01/02/2020'
+```
  */
 export function strftime(fmt, date, locale) {
+    if (date != null && Number.isNaN(+date))
+        return INVALID_DATE_STRING;
     const results = [];
     let dayPeriod = '';
-    let dayPeriodIndex = -1;
+    const dayPeriodIndexes = [];
     for (let i = 0; i < fmt.length; i++) {
         let part = fmt[i];
         if (part === '%') {
@@ -237,37 +264,43 @@ export function strftime(fmt, date, locale) {
             if (fmt[i] === '-') {
                 part += fmt[i++];
             }
-            part += fmt[i];
-            // add any repeated characters that come after
-            while (i < fmt.length - 1 && fmt[i + 1] === fmt[i])
+            part += fmt[i] ?? '';
+            // a doubled letter is a directive of its own only when the table lists it
+            if (fmt[i + 1] === fmt[i] && STRFTIME[part + fmt[i]])
                 part += fmt[++i];
+            if (!STRFTIME[part]) {
+                results.push(part);
+                continue;
+            }
             if (HOUR_PARTS[part]) {
-                const res = formatter(locale, STRFTIME[part]).format(date).split(/\s+/g);
+                results.push(formatPart(locale, STRFTIME[part], date, 'hour'));
                 // save the AM/PM for the correct spot
-                results.push(res[0]);
-                dayPeriod = res[1];
+                dayPeriod = formatPart(locale, STRFTIME[part], date, 'dayPeriod');
                 continue;
             }
             if (part === '%P' || part === '%p') {
                 // leave this flag in place for later
-                dayPeriodIndex = results.length;
-                if (part === '%p' && dayPeriod) {
-                    dayPeriod = dayPeriod.toLowerCase();
-                }
+                dayPeriodIndexes.push(results.length);
                 results.push(part);
                 continue;
             }
             if (ERA_PARTS[part] || TZ_PARTS[part]) {
-                // the formatting includes the date/year so we take what comes after
-                const res = formatter(locale, STRFTIME[part]).format(date).split(/\s+/g);
-                results.push(res.slice(1).join(' '));
+                const type = ERA_PARTS[part] ? 'era' : 'timeZoneName';
+                results.push(formatPart(locale, STRFTIME[part], date, type));
                 continue;
             }
-            // format any other parts
-            let res = formatter(locale, STRFTIME[part]).format(date);
+            // format any other parts, numbers without the unit text of the locale
+            const [type, style] = Object.entries(STRFTIME[part]).at(-1);
+            let res = style === n || style === dd
+                ? formatPart(locale, STRFTIME[part], date, type)
+                : formatter(locale, STRFTIME[part]).format(date);
             // fix bugs in time formatter
             if ((part === '%S' || part === '%M') && res.length === 1)
-                res = '0' + res;
+                res = `0${res}`;
+            if (part === '%-H') {
+                const hours = (date === undefined ? new Date() : new Date(date)).getHours();
+                res = new Intl.NumberFormat(locale).format(hours);
+            }
             results.push(res);
         }
         else {
@@ -275,12 +308,12 @@ export function strftime(fmt, date, locale) {
             results.push(part);
         }
     }
-    // insert the AM/PM at the correct spot
-    if (dayPeriodIndex >= 0)
-        results[dayPeriodIndex] = dayPeriod || '';
+    // insert the AM/PM at the correct spots
+    for (const index of dayPeriodIndexes) {
+        results[index] = results[index] === '%p' ? dayPeriod.toLowerCase() : dayPeriod;
+    }
     return results.join('').trim();
 }
-const DATETIME_DEFAULT = {};
 /** L: 09/04/1983 */
 const DATE_SHORT_DD = {
     year: n,
@@ -333,7 +366,7 @@ const DATE_MED_WITH_WEEKDAY = {
     minute: n,
     hourCycle: 'h12'
 };
-/** LLLL: Tuesday, October 14, 1983, 8:30 PM */
+/** LLLL: Friday, October 14, 1983, 8:30 PM */
 const DATE_HUGE = {
     year: n,
     month: l,
@@ -343,153 +376,3 @@ const DATE_HUGE = {
     minute: n,
     hourCycle: 'h12'
 };
-/** LT: 09:30 AM */
-const TIME_SIMPLE = {
-    hour: n,
-    minute: n,
-    hourCycle: 'h12'
-};
-/** LTS: 09:30:23 AM */
-const TIME_WITH_SECONDS = {
-    hour: n,
-    minute: n,
-    second: n,
-    hourCycle: 'h12'
-};
-/** 09:30:23 AM EDT */
-const TIME_WITH_SHORT_OFFSET = {
-    hour: n,
-    minute: n,
-    second: n,
-    timeZoneName: s,
-    hourCycle: 'h12'
-};
-/** 09:30:23 AM Eastern Daylight Time */
-const TIME_WITH_LONG_OFFSET = {
-    hour: n,
-    minute: n,
-    second: n,
-    timeZoneName: l,
-    hourCycle: 'h12'
-};
-/** 09:30 */
-const TIME_24_SIMPLE = {
-    hour: n,
-    minute: n,
-    hourCycle: 'h23'
-};
-/** 09:30:23 */
-const TIME_24_WITH_SECONDS = {
-    hour: n,
-    minute: n,
-    second: n,
-    hourCycle: 'h23'
-};
-/** 09:30:23 EDT */
-const TIME_24_WITH_SHORT_OFFSET = {
-    hour: n,
-    minute: n,
-    second: n,
-    hourCycle: 'h23',
-    timeZoneName: s
-};
-/** 09:30:23 Eastern Daylight Time */
-const TIME_24_WITH_LONG_OFFSET = {
-    hour: n,
-    minute: n,
-    second: n,
-    hourCycle: 'h23',
-    timeZoneName: l
-};
-/** 10/14/1983, 9:30 AM */
-const DATETIME_SHORT = {
-    year: n,
-    month: n,
-    day: n,
-    hour: n,
-    minute: n,
-    hourCycle: 'h12'
-};
-/** 10/14/1983, 9:30:33 AM */
-const DATETIME_SHORT_WITH_SECONDS = {
-    year: n,
-    month: n,
-    day: n,
-    hour: n,
-    minute: n,
-    second: n,
-    hourCycle: 'h12'
-};
-/** Oct 14, 1983, 9:30 AM */
-const DATETIME_MED = {
-    year: n,
-    month: s,
-    day: n,
-    hour: n,
-    minute: n,
-    hourCycle: 'h12'
-};
-/** Oct 14, 1983, 9:30:33 AM */
-const DATETIME_MED_WITH_SECONDS = {
-    year: n,
-    month: s,
-    day: n,
-    hour: n,
-    minute: n,
-    second: n,
-    hourCycle: 'h12'
-};
-/** Fri, 14 Oct 1983, 9:30 AM */
-const DATETIME_MED_WITH_WEEKDAY = {
-    year: n,
-    month: s,
-    day: n,
-    weekday: s,
-    hour: n,
-    minute: n,
-    hourCycle: 'h12'
-};
-/** October 14, 1983, 9:30 AM EDT */
-const DATETIME_FULL = {
-    year: n,
-    month: l,
-    day: n,
-    hour: n,
-    minute: n,
-    timeZoneName: s,
-    hourCycle: 'h12'
-};
-/** October 14, 1983, 9:30:33 AM EDT */
-const DATETIME_FULL_WITH_SECONDS = {
-    year: n,
-    month: l,
-    day: n,
-    hour: n,
-    minute: n,
-    second: n,
-    timeZoneName: s,
-    hourCycle: 'h12'
-};
-/** Friday, October 14, 1983, 9:30 AM Eastern Daylight Time */
-const DATETIME_HUGE = {
-    year: n,
-    month: l,
-    day: n,
-    weekday: l,
-    hour: n,
-    minute: n,
-    timeZoneName: l,
-    hourCycle: 'h12'
-};
-/** Friday, October 14, 1983, 9:30:33 AM Eastern Daylight Time */
-const DATETIME_HUGE_WITH_SECONDS = {
-    year: n,
-    month: l,
-    day: n,
-    weekday: l,
-    hour: n,
-    minute: n,
-    second: n,
-    timeZoneName: l,
-    hourCycle: 'h12'
-};

package/dist/i18n/index.d.ts

@@ -5,4 +5,5 @@
  */
 export * from './currency.js';
 export * from './date/index.js';
-export { Duration, TDuration, DurationUnit } from './duration.js';
+export { Duration } from './duration.js';
+export type { DurationUnit, TDuration } from './duration.js';

package/dist/itertools/index.d.ts

@@ -3,8 +3,8 @@
  *
  * @module itertools
  */
-import { add, Comparer } from '../operators/index.js';
-import { Function, Iteratee, Predicate } from '../types';
+import { add, type Comparer } from '../operators/index.js';
+import type { Function, Iteratee, Predicate } from '../types.js';
 /**
  * Make an iterator that returns accumulated sums, or accumulated results of other binary functions (specified via the optional `func` argument).
  * @param iterable The iterable to accumulate
@@ -12,7 +12,7 @@ import { Function, Iteratee, Predicate } from '../types';
  * @param initial Optional initial value (defaults to the first element in iterable)
  * @returns A sequence of accumulated values
  */
-export declare function accumulate<T>(iterable: Iterable<T>, func?: typeof add, initial?: any): Generator<any, void, unknown>;
+export declare function accumulate<T>(iterable: Iterable<T>, func?: typeof add, initial?: any): Generator<T>;
 /**
  * Returns `true` when all of the items in iterable are truthy. An optional predicate function can be used to define what truthiness means for this specific collection.
  * @param iterable
@@ -21,12 +21,12 @@ export declare function accumulate<T>(iterable: Iterable<T>, func?: typeof add,
  * @example
 ```js
 all([0])
-// true
+// false
 
 all([1, 2, 3])
 // true
 
-all([2, 4, 6] => (n) => n > 1)
+all([2, 4, 6], n => n > 1)
 // true
 ```
 @see {@link any}
@@ -45,7 +45,7 @@ any([0])
 any([0, 1, null, undefined])
 // true
 
-any([1, 4, 5] => (n) => n % 2 === 0)
+any([1, 4, 5], n => n % 2 === 0)
 // true
 ```
 @see {@link all}
@@ -62,9 +62,6 @@ export declare function chain<T>(...iterables: Array<Iterable<T>>): Generator<T,
 contains([1, 2, 3], 1)
 // true
 
-contains([1, 2, 3], 1, 2)
-// false
-
 contains({ 'a': 1, 'b': 2 }, 1)
 // true
 
@@ -74,7 +71,7 @@ contains('abcd', 'bc')
  *
  * @see {@link collections.find}
  */
-export declare function contains(collection: Iterable<any>, value: any): any;
+export declare function contains(collection: Iterable<any>, value: any): boolean;
 /**
  * Returns a generator that drops elements from the iterable as long as the predicate is `true`; afterwards, returns every remaining element. Note, the generator does not produce any output until the predicate first becomes `false`.
  * @param iterable The iterable to inspect.
@@ -83,7 +80,6 @@ export declare function contains(collection: Iterable<any>, value: any): any;
  */
 export declare function dropWhile<T>(iterable: Iterable<T>, predicate: Predicate<T>): Generator<T, T, unknown>;
 export declare function iforEach<T>(iterable: Iterable<T>, fun: Iteratee<T>): void;
-export declare function IterableIterator<T = any>(next: Iterator<T>['next']): Iterable<T> & Iterator<T>;
 /**
  * Yields elements like `[index, item]` from an iterable. Index starts at zero by default.
  * @template T
@@ -109,11 +105,11 @@ export declare function enumerate<T>(iterable: Iterable<T>, start?: number): Gen
 export declare function first<T>(iterable: Iterable<T>): T;
 /**
  * Creates a new generator that filters all falsy and empty values from iterable.
- * @param arr The array to compact
- * @returns A new array with the filtered values.
+ * @param iterable The iterable to compact
+ * @returns A generator with the filtered values.
  * @example
 ```js
-compact([0, 1, false, 2, '', 3])
+[...icompact([0, 1, false, 2, '', 3])]
 // [1, 2, 3]
 ```
  */
@@ -134,7 +130,7 @@ export declare function imap<T, TReturn = any>(iterable: Iterable<T>, mapFn: Pre
  */
 export declare function iflatten<T = any>(iterables: Iterable<Iterable<T>>): Generator<T, void, unknown>;
 export declare function flatMap<T>(iterable: Iterable<T>, mapFn?: (x: T) => any): Generator<T, void, unknown>;
-export declare function islice<T>(iterable: Iterable<T>, start: number, stop?: number, step?: number): Generator<T, T, unknown>;
+export declare function islice<T>(iterable: Iterable<T>, start: number, stop?: number, step?: number): Generator<T, void, unknown>;
 export declare function itake<T>(n: number, iterable: Iterable<T>): Generator<T, void, unknown>;
 /**
  * Returns an Iterator from the elements of a collection or the object keys.
@@ -146,7 +142,7 @@ export declare function partition<T>(iterable: Iterable<T>, predicate: Predicate
 /**
  * Returns a generator for a sequence of numbers in the given range, starting from `start` (default 0) to `stop` (not-inclusive) in increments of `step` (default 1).
  *
- * `range(x)` is a shorthand for `range(0, x, 1)`.
+ * `range(x)` is a shorthand for `range(0, x, 1)`, or `range(0, x, -1)` when `x` is negative.
  * @param args When called with a single argument, it is assigned to `stop` param. If two arguments are given, it will assign them to `(start, stop)`. When three arguments, it means `(start, stop, step)`.
  * @example
 ```js
@@ -163,7 +159,7 @@ range(5, 0, -1)
 // [5, 4, 3, 2, 1]
 
 range(-3)
-// []
+// [0, -1, -2]
 ```
  */
 export declare function range(...args: number[]): Generator<number, void, unknown>;
@@ -189,11 +185,11 @@ export declare function reduce<T>(iterable: Iterable<T>, reducer: (prev: T, valu
 export declare function reversed<T>(iterable: Iterable<T>): T[];
 /**
  * Creates a new sorted list from the elements in the array. This can be called many ways:
- *   - sorted([...], true) => reverse order
- *   - sorted([...], fn = (x) => any) => using a key fn
- *   - sorted([...], fn = (x) => any, true) => reverse order using key
- *   - sorted([...], false, (x, y) => number) => using custom compare
- *   - sorted([...], fn = (x) => any, true, (x, y) => number) => custom key, reverse and compare
+ *   - sorted([...], true) - reverse order
+ *   - sorted([...], fn = x => any) - using a key fn
+ *   - sorted([...], fn = x => any, true) - reverse order using key
+ *   - sorted([...], false, (x, y) => number) - using custom compare
+ *   - sorted([...], fn = x => any, true, (x, y) => number) - custom key, reverse and compare
  *
  * If `args` is an Object, returns the sorted keys.
  *
@@ -211,9 +207,9 @@ export declare function sorted<T>(args: T[], key: Function): T[];
 export declare function sorted<T>(args: T[], key: Function, reverse: boolean): T[];
 /**
  * Sort `args` in place. Can be called like this:
- *   - sort([...], true) => reverse order
- *   - sort([...], (x, y) => number) => using custom compare
- *   - sort([...], true, (x, y) => number) => reverse and using custom compare
+ *   - sort([...], true) - reverse order
+ *   - sort([...], (x, y) => number) - using custom compare
+ *   - sort([...], true, (x, y) => number) - reverse and using custom compare
  *
  * @param {any[]} args
  * @param {(boolean | Comparer)} [reverse]