@discordjs/collection 2.0.0-dev.1690416583-8f4256d.0 → 2.0.0-dev.1699445028-2bda883a0

package/README.md

@@ -23,7 +23,7 @@
 
 ## Installation
 
-**Node.js 16.9.0 or newer is required.**
+**Node.js 18 or newer is required.**
 
 ```sh
 npm install @discordjs/collection

package/dist/index.d.mts

@@ -132,8 +132,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * should use the `get` method. See
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/get | MDN} for details.
      *
-     * @param fn - The function to test with (should return boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.find(user => user.username === 'Bob');
@@ -148,8 +148,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex | Array.findIndex()},
      * but returns the key rather than the positional index.
      *
-     * @param fn - The function to test with (should return boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.findKey(user => user.username === 'Bob');
@@ -159,11 +159,34 @@ declare class Collection<K, V> extends Map<K, V> {
     findKey(fn: (value: V, key: K, collection: this) => unknown): K | undefined;
     findKey<This, K2 extends K>(fn: (this: This, value: V, key: K, collection: this) => key is K2, thisArg: This): K2 | undefined;
     findKey<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): K | undefined;
+    /**
+     * Searches for a last item where the given function returns a truthy value. This behaves like
+     * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findLast | Array.findLast()}.
+     *
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
+     */
+    findLast<V2 extends V>(fn: (value: V, key: K, collection: this) => value is V2): V2 | undefined;
+    findLast(fn: (value: V, key: K, collection: this) => unknown): V | undefined;
+    findLast<This, V2 extends V>(fn: (this: This, value: V, key: K, collection: this) => value is V2, thisArg: This): V2 | undefined;
+    findLast<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): V | undefined;
+    /**
+     * Searches for the key of a last item where the given function returns a truthy value. This behaves like
+     * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findLastIndex | Array.findLastIndex()},
+     * but returns the key rather than the positional index.
+     *
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
+     */
+    findLastKey<K2 extends K>(fn: (value: V, key: K, collection: this) => key is K2): K2 | undefined;
+    findLastKey(fn: (value: V, key: K, collection: this) => unknown): K | undefined;
+    findLastKey<This, K2 extends K>(fn: (this: This, value: V, key: K, collection: this) => key is K2, thisArg: This): K2 | undefined;
+    findLastKey<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): K | undefined;
     /**
      * Removes items that satisfy the provided filter function.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @returns The number of removed entries
      */
     sweep(fn: (value: V, key: K, collection: this) => unknown): number;
@@ -173,8 +196,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter | Array.filter()},
      * but returns a Collection instead of an Array.
      *
-     * @param fn - The function to test with (should return boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.filter(user => user.username === 'Bob');
@@ -191,7 +214,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * contains the items that passed and the second contains the items that failed.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * const [big, small] = collection.partition(guild => guild.memberCount > 250);
@@ -208,7 +231,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap | Array.flatMap()}.
      *
      * @param fn - Function that produces a new Collection
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.flatMap(guild => guild.members.cache);
@@ -221,7 +244,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map()}.
      *
      * @param fn - Function that produces an element of the new array, taking three arguments
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.map(user => user.tag);
@@ -234,7 +257,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map()}.
      *
      * @param fn - Function that produces an element of the new collection, taking three arguments
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.mapValues(user => user.tag);
@@ -247,7 +270,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/some | Array.some()}.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.some(user => user.discriminator === '0000');
@@ -260,7 +283,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/every | Array.every()}.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.every(user => !user.bot);
@@ -285,13 +308,21 @@ declare class Collection<K, V> extends Map<K, V> {
      * ```
      */
     reduce<T = V>(fn: (accumulator: T, value: V, key: K, collection: this) => T, initialValue?: T): T;
+    /**
+     * Applies a function to produce a single value. Identical in behavior to
+     * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduceRight | Array.reduceRight()}.
+     *
+     * @param fn - Function used to reduce, taking four arguments; `accumulator`, `value`, `key`, and `collection`
+     * @param initialValue - Starting value for the accumulator
+     */
+    reduceRight<T>(fn: (accumulator: T, value: V, key: K, collection: this) => T, initialValue?: T): T;
     /**
      * Identical to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach | Map.forEach()},
      * but returns the collection instead of undefined.
      *
      * @param fn - Function to execute for each element
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection
@@ -306,7 +337,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * Runs a function on the collection and returns the collection.
      *
      * @param fn - Function to execute
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection
@@ -359,23 +390,65 @@ declare class Collection<K, V> extends Map<K, V> {
      */
     sort(compareFunction?: Comparator<K, V>): this;
     /**
-     * The intersect method returns a new structure containing items where the keys and values are present in both original structures.
+     * The intersection method returns a new collection containing the items where the key is present in both collections.
+     *
+     * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['c', 3]]);
+     * const intersection = col1.intersection(col2);
+     * console.log(col1.intersection(col2));
+     * // => Collection { 'a' => 1 }
+     * ```
+     */
+    intersection<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
+    /**
+     * Returns a new collection containing the items where the key is present in either of the collections.
+     *
+     * @remarks
      *
+     * If the collections have any items with the same key, the value from the first collection will be used.
      * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['b', 3], ['c', 3]]);
+     * const union = col1.union(col2);
+     * console.log(union);
+     * // => Collection { 'a' => 1, 'b' => 2, 'c' => 3 }
+     * ```
      */
-    intersect<T>(other: ReadonlyCollection<K, T>): Collection<K, T>;
+    union<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
     /**
-     * The subtract method returns a new structure containing items where the keys and values of the original structure are not present in the other.
+     * Returns a new collection containing the items where the key is present in this collection but not the other.
      *
      * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['c', 3]]);
+     * console.log(col1.difference(col2));
+     * // => Collection { 'b' => 2 }
+     * console.log(col2.difference(col1));
+     * // => Collection { 'c' => 3 }
+     * ```
      */
-    subtract<T>(other: ReadonlyCollection<K, T>): Collection<K, V>;
+    difference<T>(other: ReadonlyCollection<K, T>): Collection<K, V>;
     /**
-     * The difference method returns a new structure containing items where the key is present in one of the original structures but not the other.
+     * Returns a new collection containing only the items where the keys are present in either collection, but not both.
      *
      * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['c', 3]]);
+     * const symmetricDifference = col1.symmetricDifference(col2);
+     * console.log(col1.symmetricDifference(col2));
+     * // => Collection { 'b' => 2, 'c' => 3 }
+     * ```
      */
-    difference<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
+    symmetricDifference<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
     /**
      * Merges two Collections together into a new Collection.
      *
@@ -405,6 +478,11 @@ declare class Collection<K, V> extends Map<K, V> {
      * ```
      */
     merge<T, R>(other: ReadonlyCollection<K, T>, whenInSelf: (value: V, key: K) => Keep<R>, whenInOther: (valueOther: T, key: K) => Keep<R>, whenInBoth: (value: V, valueOther: T, key: K) => Keep<R>): Collection<K, R>;
+    /**
+     * Identical to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toReversed | Array.toReversed()}
+     * but returns a Collection instead of an Array.
+     */
+    toReversed(): Collection<K, V>;
     /**
      * The sorted method sorts the items of a collection and returns it.
      * The sort is not necessarily stable in Node 10 or older.
@@ -418,8 +496,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.sorted((userA, userB) => userA.createdTimestamp - userB.createdTimestamp);
      * ```
      */
-    sorted(compareFunction?: Comparator<K, V>): Collection<K, V>;
-    toJSON(): V[];
+    toSorted(compareFunction?: Comparator<K, V>): Collection<K, V>;
+    toJSON(): [K, V][];
     private static defaultSort;
     /**
      * Creates a Collection from a list of entries.

package/dist/index.d.ts

@@ -132,8 +132,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * should use the `get` method. See
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/get | MDN} for details.
      *
-     * @param fn - The function to test with (should return boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.find(user => user.username === 'Bob');
@@ -148,8 +148,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex | Array.findIndex()},
      * but returns the key rather than the positional index.
      *
-     * @param fn - The function to test with (should return boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.findKey(user => user.username === 'Bob');
@@ -159,11 +159,34 @@ declare class Collection<K, V> extends Map<K, V> {
     findKey(fn: (value: V, key: K, collection: this) => unknown): K | undefined;
     findKey<This, K2 extends K>(fn: (this: This, value: V, key: K, collection: this) => key is K2, thisArg: This): K2 | undefined;
     findKey<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): K | undefined;
+    /**
+     * Searches for a last item where the given function returns a truthy value. This behaves like
+     * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findLast | Array.findLast()}.
+     *
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
+     */
+    findLast<V2 extends V>(fn: (value: V, key: K, collection: this) => value is V2): V2 | undefined;
+    findLast(fn: (value: V, key: K, collection: this) => unknown): V | undefined;
+    findLast<This, V2 extends V>(fn: (this: This, value: V, key: K, collection: this) => value is V2, thisArg: This): V2 | undefined;
+    findLast<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): V | undefined;
+    /**
+     * Searches for the key of a last item where the given function returns a truthy value. This behaves like
+     * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findLastIndex | Array.findLastIndex()},
+     * but returns the key rather than the positional index.
+     *
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
+     */
+    findLastKey<K2 extends K>(fn: (value: V, key: K, collection: this) => key is K2): K2 | undefined;
+    findLastKey(fn: (value: V, key: K, collection: this) => unknown): K | undefined;
+    findLastKey<This, K2 extends K>(fn: (this: This, value: V, key: K, collection: this) => key is K2, thisArg: This): K2 | undefined;
+    findLastKey<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): K | undefined;
     /**
      * Removes items that satisfy the provided filter function.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @returns The number of removed entries
      */
     sweep(fn: (value: V, key: K, collection: this) => unknown): number;
@@ -173,8 +196,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter | Array.filter()},
      * but returns a Collection instead of an Array.
      *
-     * @param fn - The function to test with (should return boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param fn - The function to test with (should return a boolean)
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.filter(user => user.username === 'Bob');
@@ -191,7 +214,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * contains the items that passed and the second contains the items that failed.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * const [big, small] = collection.partition(guild => guild.memberCount > 250);
@@ -208,7 +231,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap | Array.flatMap()}.
      *
      * @param fn - Function that produces a new Collection
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.flatMap(guild => guild.members.cache);
@@ -221,7 +244,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map()}.
      *
      * @param fn - Function that produces an element of the new array, taking three arguments
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.map(user => user.tag);
@@ -234,7 +257,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map()}.
      *
      * @param fn - Function that produces an element of the new collection, taking three arguments
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.mapValues(user => user.tag);
@@ -247,7 +270,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/some | Array.some()}.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.some(user => user.discriminator === '0000');
@@ -260,7 +283,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/every | Array.every()}.
      *
      * @param fn - Function used to test (should return a boolean)
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection.every(user => !user.bot);
@@ -285,13 +308,21 @@ declare class Collection<K, V> extends Map<K, V> {
      * ```
      */
     reduce<T = V>(fn: (accumulator: T, value: V, key: K, collection: this) => T, initialValue?: T): T;
+    /**
+     * Applies a function to produce a single value. Identical in behavior to
+     * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduceRight | Array.reduceRight()}.
+     *
+     * @param fn - Function used to reduce, taking four arguments; `accumulator`, `value`, `key`, and `collection`
+     * @param initialValue - Starting value for the accumulator
+     */
+    reduceRight<T>(fn: (accumulator: T, value: V, key: K, collection: this) => T, initialValue?: T): T;
     /**
      * Identical to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach | Map.forEach()},
      * but returns the collection instead of undefined.
      *
      * @param fn - Function to execute for each element
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection
@@ -306,7 +337,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * Runs a function on the collection and returns the collection.
      *
      * @param fn - Function to execute
-     * @param thisArg - Value to use as `this` when executing function
+     * @param thisArg - Value to use as `this` when executing the function
      * @example
      * ```ts
      * collection
@@ -359,23 +390,65 @@ declare class Collection<K, V> extends Map<K, V> {
      */
     sort(compareFunction?: Comparator<K, V>): this;
     /**
-     * The intersect method returns a new structure containing items where the keys and values are present in both original structures.
+     * The intersection method returns a new collection containing the items where the key is present in both collections.
+     *
+     * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['c', 3]]);
+     * const intersection = col1.intersection(col2);
+     * console.log(col1.intersection(col2));
+     * // => Collection { 'a' => 1 }
+     * ```
+     */
+    intersection<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
+    /**
+     * Returns a new collection containing the items where the key is present in either of the collections.
+     *
+     * @remarks
      *
+     * If the collections have any items with the same key, the value from the first collection will be used.
      * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['b', 3], ['c', 3]]);
+     * const union = col1.union(col2);
+     * console.log(union);
+     * // => Collection { 'a' => 1, 'b' => 2, 'c' => 3 }
+     * ```
      */
-    intersect<T>(other: ReadonlyCollection<K, T>): Collection<K, T>;
+    union<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
     /**
-     * The subtract method returns a new structure containing items where the keys and values of the original structure are not present in the other.
+     * Returns a new collection containing the items where the key is present in this collection but not the other.
      *
      * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['c', 3]]);
+     * console.log(col1.difference(col2));
+     * // => Collection { 'b' => 2 }
+     * console.log(col2.difference(col1));
+     * // => Collection { 'c' => 3 }
+     * ```
      */
-    subtract<T>(other: ReadonlyCollection<K, T>): Collection<K, V>;
+    difference<T>(other: ReadonlyCollection<K, T>): Collection<K, V>;
     /**
-     * The difference method returns a new structure containing items where the key is present in one of the original structures but not the other.
+     * Returns a new collection containing only the items where the keys are present in either collection, but not both.
      *
      * @param other - The other Collection to filter against
+     * @example
+     * ```ts
+     * const col1 = new Collection([['a', 1], ['b', 2]]);
+     * const col2 = new Collection([['a', 1], ['c', 3]]);
+     * const symmetricDifference = col1.symmetricDifference(col2);
+     * console.log(col1.symmetricDifference(col2));
+     * // => Collection { 'b' => 2, 'c' => 3 }
+     * ```
      */
-    difference<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
+    symmetricDifference<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
     /**
      * Merges two Collections together into a new Collection.
      *
@@ -405,6 +478,11 @@ declare class Collection<K, V> extends Map<K, V> {
      * ```
      */
     merge<T, R>(other: ReadonlyCollection<K, T>, whenInSelf: (value: V, key: K) => Keep<R>, whenInOther: (valueOther: T, key: K) => Keep<R>, whenInBoth: (value: V, valueOther: T, key: K) => Keep<R>): Collection<K, R>;
+    /**
+     * Identical to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toReversed | Array.toReversed()}
+     * but returns a Collection instead of an Array.
+     */
+    toReversed(): Collection<K, V>;
     /**
      * The sorted method sorts the items of a collection and returns it.
      * The sort is not necessarily stable in Node 10 or older.
@@ -418,8 +496,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.sorted((userA, userB) => userA.createdTimestamp - userB.createdTimestamp);
      * ```
      */
-    sorted(compareFunction?: Comparator<K, V>): Collection<K, V>;
-    toJSON(): V[];
+    toSorted(compareFunction?: Comparator<K, V>): Collection<K, V>;
+    toJSON(): [K, V][];
     private static defaultSort;
     /**
      * Creates a Collection from a list of entries.