@discordjs/collection 2.0.0-dev.1699704219-5b0aa92c8 → 2.0.0

package/dist/index.d.mts

@@ -3,31 +3,31 @@
  */
 interface CollectionConstructor {
     new (): Collection<unknown, unknown>;
-    new <K, V>(entries?: readonly (readonly [K, V])[] | null): Collection<K, V>;
-    new <K, V>(iterable: Iterable<readonly [K, V]>): Collection<K, V>;
+    new <Key, Value>(entries?: readonly (readonly [Key, Value])[] | null): Collection<Key, Value>;
+    new <Key, Value>(iterable: Iterable<readonly [Key, Value]>): Collection<Key, Value>;
     readonly prototype: Collection<unknown, unknown>;
     readonly [Symbol.species]: CollectionConstructor;
 }
 /**
  * Represents an immutable version of a collection
  */
-type ReadonlyCollection<K, V> = Omit<Collection<K, V>, 'delete' | 'ensure' | 'forEach' | 'get' | 'reverse' | 'set' | 'sort' | 'sweep'> & ReadonlyMap<K, V>;
+type ReadonlyCollection<Key, Value> = Omit<Collection<Key, Value>, 'delete' | 'ensure' | 'forEach' | 'get' | 'reverse' | 'set' | 'sort' | 'sweep'> & ReadonlyMap<Key, Value>;
 /**
  * Separate interface for the constructor so that emitted js does not have a constructor that overwrites itself
  *
  * @internal
  */
-interface Collection<K, V> extends Map<K, V> {
+interface Collection<Key, Value> extends Map<Key, Value> {
     constructor: CollectionConstructor;
 }
 /**
  * A Map with additional utility methods. This is used throughout discord.js rather than Arrays for anything that has
  * an ID, for significantly improved performance and ease-of-use.
  *
- * @typeParam K - The key type this collection holds
- * @typeParam V - The value type this collection holds
+ * @typeParam Key - The key type this collection holds
+ * @typeParam Value - The value type this collection holds
  */
-declare class Collection<K, V> extends Map<K, V> {
+declare class Collection<Key, Value> extends Map<Key, Value> {
     /**
      * Obtains the value of the given key if it exists, otherwise sets and returns the value provided by the default value generator.
      *
@@ -38,29 +38,29 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.ensure(guildId, () => defaultGuildConfig);
      * ```
      */
-    ensure(key: K, defaultValueGenerator: (key: K, collection: this) => V): V;
+    ensure(key: Key, defaultValueGenerator: (key: Key, collection: this) => Value): Value;
     /**
      * Checks if all of the elements exist in the collection.
      *
      * @param keys - The keys of the elements to check for
      * @returns `true` if all of the elements exist, `false` if at least one does not exist.
      */
-    hasAll(...keys: K[]): boolean;
+    hasAll(...keys: Key[]): boolean;
     /**
      * Checks if any of the elements exist in the collection.
      *
      * @param keys - The keys of the elements to check for
      * @returns `true` if any of the elements exist, `false` if none exist.
      */
-    hasAny(...keys: K[]): boolean;
+    hasAny(...keys: Key[]): boolean;
     /**
      * Obtains the first value(s) in this collection.
      *
      * @param amount - Amount of values to obtain from the beginning
      * @returns A single value if no amount is provided or an array of values, starting from the end if amount is negative
      */
-    first(): V | undefined;
-    first(amount: number): V[];
+    first(): Value | undefined;
+    first(amount: number): Value[];
     /**
      * Obtains the first key(s) in this collection.
      *
@@ -68,8 +68,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * @returns A single key if no amount is provided or an array of keys, starting from the end if
      * amount is negative
      */
-    firstKey(): K | undefined;
-    firstKey(amount: number): K[];
+    firstKey(): Key | undefined;
+    firstKey(amount: number): Key[];
     /**
      * Obtains the last value(s) in this collection.
      *
@@ -77,8 +77,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * @returns A single value if no amount is provided or an array of values, starting from the start if
      * amount is negative
      */
-    last(): V | undefined;
-    last(amount: number): V[];
+    last(): Value | undefined;
+    last(amount: number): Value[];
     /**
      * Obtains the last key(s) in this collection.
      *
@@ -86,8 +86,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * @returns A single key if no amount is provided or an array of keys, starting from the start if
      * amount is negative
      */
-    lastKey(): K | undefined;
-    lastKey(amount: number): K[];
+    lastKey(): Key | undefined;
+    lastKey(amount: number): Key[];
     /**
      * Identical to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/at | Array.at()}.
      * Returns the item at a given index, allowing for positive and negative integers.
@@ -95,7 +95,7 @@ declare class Collection<K, V> extends Map<K, V> {
      *
      * @param index - The index of the element to obtain
      */
-    at(index: number): V | undefined;
+    at(index: number): Value | undefined;
     /**
      * Identical to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/at | Array.at()}.
      * Returns the key at a given index, allowing for positive and negative integers.
@@ -103,23 +103,23 @@ declare class Collection<K, V> extends Map<K, V> {
      *
      * @param index - The index of the key to obtain
      */
-    keyAt(index: number): K | undefined;
+    keyAt(index: number): Key | undefined;
     /**
      * Obtains unique random value(s) from this collection.
      *
      * @param amount - Amount of values to obtain randomly
      * @returns A single value if no amount is provided or an array of values
      */
-    random(): V | undefined;
-    random(amount: number): V[];
+    random(): Value | undefined;
+    random(amount: number): Value[];
     /**
      * Obtains unique random key(s) from this collection.
      *
      * @param amount - Amount of keys to obtain randomly
      * @returns A single key if no amount is provided or an array
      */
-    randomKey(): K | undefined;
-    randomKey(amount: number): K[];
+    randomKey(): Key | undefined;
+    randomKey(amount: number): Key[];
     /**
      * Identical to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse | Array.reverse()}
      * but returns a Collection instead of an Array.
@@ -139,10 +139,10 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.find(user => user.username === 'Bob');
      * ```
      */
-    find<V2 extends V>(fn: (value: V, key: K, collection: this) => value is V2): V2 | undefined;
-    find(fn: (value: V, key: K, collection: this) => unknown): V | undefined;
-    find<This, V2 extends V>(fn: (this: This, value: V, key: K, collection: this) => value is V2, thisArg: This): V2 | undefined;
-    find<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): V | undefined;
+    find<NewValue extends Value>(fn: (value: Value, key: Key, collection: this) => value is NewValue): NewValue | undefined;
+    find(fn: (value: Value, key: Key, collection: this) => unknown): Value | undefined;
+    find<This, NewValue extends Value>(fn: (this: This, value: Value, key: Key, collection: this) => value is NewValue, thisArg: This): NewValue | undefined;
+    find<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): Value | undefined;
     /**
      * Searches for the key of a single 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/findIndex | Array.findIndex()},
@@ -155,10 +155,10 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.findKey(user => user.username === 'Bob');
      * ```
      */
-    findKey<K2 extends K>(fn: (value: V, key: K, collection: this) => key is K2): K2 | undefined;
-    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;
+    findKey<NewKey extends Key>(fn: (value: Value, key: Key, collection: this) => key is NewKey): NewKey | undefined;
+    findKey(fn: (value: Value, key: Key, collection: this) => unknown): Key | undefined;
+    findKey<This, NewKey extends Key>(fn: (this: This, value: Value, key: Key, collection: this) => key is NewKey, thisArg: This): NewKey | undefined;
+    findKey<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): Key | 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()}.
@@ -166,10 +166,10 @@ declare class Collection<K, V> extends Map<K, V> {
      * @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;
+    findLast<NewValue extends Value>(fn: (value: Value, key: Key, collection: this) => value is NewValue): NewValue | undefined;
+    findLast(fn: (value: Value, key: Key, collection: this) => unknown): Value | undefined;
+    findLast<This, NewValue extends Value>(fn: (this: This, value: Value, key: Key, collection: this) => value is NewValue, thisArg: This): NewValue | undefined;
+    findLast<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): Value | 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()},
@@ -178,10 +178,10 @@ declare class Collection<K, V> extends Map<K, V> {
      * @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;
+    findLastKey<NewKey extends Key>(fn: (value: Value, key: Key, collection: this) => key is NewKey): NewKey | undefined;
+    findLastKey(fn: (value: Value, key: Key, collection: this) => unknown): Key | undefined;
+    findLastKey<This, NewKey extends Key>(fn: (this: This, value: Value, key: Key, collection: this) => key is NewKey, thisArg: This): NewKey | undefined;
+    findLastKey<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): Key | undefined;
     /**
      * Removes items that satisfy the provided filter function.
      *
@@ -189,8 +189,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * @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;
-    sweep<T>(fn: (this: T, value: V, key: K, collection: this) => unknown, thisArg: T): number;
+    sweep(fn: (value: Value, key: Key, collection: this) => unknown): number;
+    sweep<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): number;
     /**
      * Identical to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter | Array.filter()},
@@ -203,12 +203,12 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.filter(user => user.username === 'Bob');
      * ```
      */
-    filter<K2 extends K>(fn: (value: V, key: K, collection: this) => key is K2): Collection<K2, V>;
-    filter<V2 extends V>(fn: (value: V, key: K, collection: this) => value is V2): Collection<K, V2>;
-    filter(fn: (value: V, key: K, collection: this) => unknown): Collection<K, V>;
-    filter<This, K2 extends K>(fn: (this: This, value: V, key: K, collection: this) => key is K2, thisArg: This): Collection<K2, V>;
-    filter<This, V2 extends V>(fn: (this: This, value: V, key: K, collection: this) => value is V2, thisArg: This): Collection<K, V2>;
-    filter<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): Collection<K, V>;
+    filter<NewKey extends Key>(fn: (value: Value, key: Key, collection: this) => key is NewKey): Collection<NewKey, Value>;
+    filter<NewValue extends Value>(fn: (value: Value, key: Key, collection: this) => value is NewValue): Collection<Key, NewValue>;
+    filter(fn: (value: Value, key: Key, collection: this) => unknown): Collection<Key, Value>;
+    filter<This, NewKey extends Key>(fn: (this: This, value: Value, key: Key, collection: this) => key is NewKey, thisArg: This): Collection<NewKey, Value>;
+    filter<This, NewValue extends Value>(fn: (this: This, value: Value, key: Key, collection: this) => value is NewValue, thisArg: This): Collection<Key, NewValue>;
+    filter<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): Collection<Key, Value>;
     /**
      * Partitions the collection into two collections where the first collection
      * contains the items that passed and the second contains the items that failed.
@@ -220,12 +220,12 @@ declare class Collection<K, V> extends Map<K, V> {
      * const [big, small] = collection.partition(guild => guild.memberCount > 250);
      * ```
      */
-    partition<K2 extends K>(fn: (value: V, key: K, collection: this) => key is K2): [Collection<K2, V>, Collection<Exclude<K, K2>, V>];
-    partition<V2 extends V>(fn: (value: V, key: K, collection: this) => value is V2): [Collection<K, V2>, Collection<K, Exclude<V, V2>>];
-    partition(fn: (value: V, key: K, collection: this) => unknown): [Collection<K, V>, Collection<K, V>];
-    partition<This, K2 extends K>(fn: (this: This, value: V, key: K, collection: this) => key is K2, thisArg: This): [Collection<K2, V>, Collection<Exclude<K, K2>, V>];
-    partition<This, V2 extends V>(fn: (this: This, value: V, key: K, collection: this) => value is V2, thisArg: This): [Collection<K, V2>, Collection<K, Exclude<V, V2>>];
-    partition<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): [Collection<K, V>, Collection<K, V>];
+    partition<NewKey extends Key>(fn: (value: Value, key: Key, collection: this) => key is NewKey): [Collection<NewKey, Value>, Collection<Exclude<Key, NewKey>, Value>];
+    partition<NewValue extends Value>(fn: (value: Value, key: Key, collection: this) => value is NewValue): [Collection<Key, NewValue>, Collection<Key, Exclude<Value, NewValue>>];
+    partition(fn: (value: Value, key: Key, collection: this) => unknown): [Collection<Key, Value>, Collection<Key, Value>];
+    partition<This, NewKey extends Key>(fn: (this: This, value: Value, key: Key, collection: this) => key is NewKey, thisArg: This): [Collection<NewKey, Value>, Collection<Exclude<Key, NewKey>, Value>];
+    partition<This, NewValue extends Value>(fn: (this: This, value: Value, key: Key, collection: this) => value is NewValue, thisArg: This): [Collection<Key, NewValue>, Collection<Key, Exclude<Value, NewValue>>];
+    partition<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): [Collection<Key, Value>, Collection<Key, Value>];
     /**
      * Maps each item into a Collection, then joins the results into a single Collection. Identical in behavior to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap | Array.flatMap()}.
@@ -237,8 +237,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.flatMap(guild => guild.members.cache);
      * ```
      */
-    flatMap<T>(fn: (value: V, key: K, collection: this) => Collection<K, T>): Collection<K, T>;
-    flatMap<T, This>(fn: (this: This, value: V, key: K, collection: this) => Collection<K, T>, thisArg: This): Collection<K, T>;
+    flatMap<NewValue>(fn: (value: Value, key: Key, collection: this) => Collection<Key, NewValue>): Collection<Key, NewValue>;
+    flatMap<NewValue, This>(fn: (this: This, value: Value, key: Key, collection: this) => Collection<Key, NewValue>, thisArg: This): Collection<Key, NewValue>;
     /**
      * Maps each item to another value into an array. Identical in behavior to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map()}.
@@ -250,8 +250,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.map(user => user.tag);
      * ```
      */
-    map<T>(fn: (value: V, key: K, collection: this) => T): T[];
-    map<This, T>(fn: (this: This, value: V, key: K, collection: this) => T, thisArg: This): T[];
+    map<NewValue>(fn: (value: Value, key: Key, collection: this) => NewValue): NewValue[];
+    map<This, NewValue>(fn: (this: This, value: Value, key: Key, collection: this) => NewValue, thisArg: This): NewValue[];
     /**
      * Maps each item to another value into a collection. Identical in behavior to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map | Array.map()}.
@@ -263,8 +263,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.mapValues(user => user.tag);
      * ```
      */
-    mapValues<T>(fn: (value: V, key: K, collection: this) => T): Collection<K, T>;
-    mapValues<This, T>(fn: (this: This, value: V, key: K, collection: this) => T, thisArg: This): Collection<K, T>;
+    mapValues<NewValue>(fn: (value: Value, key: Key, collection: this) => NewValue): Collection<Key, NewValue>;
+    mapValues<This, NewValue>(fn: (this: This, value: Value, key: Key, collection: this) => NewValue, thisArg: This): Collection<Key, NewValue>;
     /**
      * Checks if there exists an item that passes a test. Identical in behavior to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/some | Array.some()}.
@@ -276,8 +276,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.some(user => user.discriminator === '0000');
      * ```
      */
-    some(fn: (value: V, key: K, collection: this) => unknown): boolean;
-    some<T>(fn: (this: T, value: V, key: K, collection: this) => unknown, thisArg: T): boolean;
+    some(fn: (value: Value, key: Key, collection: this) => unknown): boolean;
+    some<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): boolean;
     /**
      * Checks if all items passes a test. Identical in behavior to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/every | Array.every()}.
@@ -289,12 +289,12 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.every(user => !user.bot);
      * ```
      */
-    every<K2 extends K>(fn: (value: V, key: K, collection: this) => key is K2): this is Collection<K2, V>;
-    every<V2 extends V>(fn: (value: V, key: K, collection: this) => value is V2): this is Collection<K, V2>;
-    every(fn: (value: V, key: K, collection: this) => unknown): boolean;
-    every<This, K2 extends K>(fn: (this: This, value: V, key: K, collection: this) => key is K2, thisArg: This): this is Collection<K2, V>;
-    every<This, V2 extends V>(fn: (this: This, value: V, key: K, collection: this) => value is V2, thisArg: This): this is Collection<K, V2>;
-    every<This>(fn: (this: This, value: V, key: K, collection: this) => unknown, thisArg: This): boolean;
+    every<NewKey extends Key>(fn: (value: Value, key: Key, collection: this) => key is NewKey): this is Collection<NewKey, Value>;
+    every<NewValue extends Value>(fn: (value: Value, key: Key, collection: this) => value is NewValue): this is Collection<Key, NewValue>;
+    every(fn: (value: Value, key: Key, collection: this) => unknown): boolean;
+    every<This, NewKey extends Key>(fn: (this: This, value: Value, key: Key, collection: this) => key is NewKey, thisArg: This): this is Collection<NewKey, Value>;
+    every<This, NewValue extends Value>(fn: (this: This, value: Value, key: Key, collection: this) => value is NewValue, thisArg: This): this is Collection<Key, NewValue>;
+    every<This>(fn: (this: This, value: Value, key: Key, collection: this) => unknown, thisArg: This): boolean;
     /**
      * 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/reduce | Array.reduce()}.
@@ -307,7 +307,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.reduce((acc, guild) => acc + guild.memberCount, 0);
      * ```
      */
-    reduce<T = V>(fn: (accumulator: T, value: V, key: K, collection: this) => T, initialValue?: T): T;
+    reduce<InitialValue = Value>(fn: (accumulator: InitialValue, value: Value, key: Key, collection: this) => InitialValue, initialValue?: InitialValue): InitialValue;
     /**
      * 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()}.
@@ -315,7 +315,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * @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;
+    reduceRight<InitialValue>(fn: (accumulator: InitialValue, value: Value, key: Key, collection: this) => InitialValue, initialValue?: InitialValue): InitialValue;
     /**
      * Identical to
      * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach | Map.forEach()},
@@ -331,8 +331,8 @@ declare class Collection<K, V> extends Map<K, V> {
      *  .each(user => console.log(user.username));
      * ```
      */
-    each(fn: (value: V, key: K, collection: this) => void): this;
-    each<T>(fn: (this: T, value: V, key: K, collection: this) => void, thisArg: T): this;
+    each(fn: (value: Value, key: Key, collection: this) => void): this;
+    each<This>(fn: (this: This, value: Value, key: Key, collection: this) => void, thisArg: This): this;
     /**
      * Runs a function on the collection and returns the collection.
      *
@@ -347,7 +347,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * ```
      */
     tap(fn: (collection: this) => void): this;
-    tap<T>(fn: (this: T, collection: this) => void, thisArg: T): this;
+    tap<This>(fn: (this: This, collection: this) => void, thisArg: This): this;
     /**
      * Creates an identical shallow copy of this collection.
      *
@@ -356,7 +356,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * const newColl = someColl.clone();
      * ```
      */
-    clone(): Collection<K, V>;
+    clone(): Collection<Key, Value>;
     /**
      * Combines this collection with others into a new collection. None of the source collections are modified.
      *
@@ -366,7 +366,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * const newColl = someColl.concat(someOtherColl, anotherColl, ohBoyAColl);
      * ```
      */
-    concat(...collections: ReadonlyCollection<K, V>[]): Collection<K, V>;
+    concat(...collections: ReadonlyCollection<Key, Value>[]): Collection<Key, Value>;
     /**
      * Checks if this collection shares identical items with another.
      * This is different to checking for equality using equal-signs, because
@@ -375,7 +375,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * @param collection - Collection to compare with
      * @returns Whether the collections have identical contents
      */
-    equals(collection: ReadonlyCollection<K, V>): boolean;
+    equals(collection: ReadonlyCollection<Key, Value>): boolean;
     /**
      * The sort method sorts the items of a collection in place and returns it.
      * The sort is not necessarily stable in Node 10 or older.
@@ -388,7 +388,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.sort((userA, userB) => userA.createdTimestamp - userB.createdTimestamp);
      * ```
      */
-    sort(compareFunction?: Comparator<K, V>): this;
+    sort(compareFunction?: Comparator<Key, Value>): this;
     /**
      * The intersection method returns a new collection containing the items where the key is present in both collections.
      *
@@ -402,7 +402,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * // => Collection { 'a' => 1 }
      * ```
      */
-    intersection<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
+    intersection(other: ReadonlyCollection<Key, any>): Collection<Key, Value>;
     /**
      * Returns a new collection containing the items where the key is present in either of the collections.
      *
@@ -419,7 +419,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * // => Collection { 'a' => 1, 'b' => 2, 'c' => 3 }
      * ```
      */
-    union<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
+    union<OtherValue>(other: ReadonlyCollection<Key, OtherValue>): Collection<Key, OtherValue | Value>;
     /**
      * Returns a new collection containing the items where the key is present in this collection but not the other.
      *
@@ -434,7 +434,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * // => Collection { 'c' => 3 }
      * ```
      */
-    difference<T>(other: ReadonlyCollection<K, T>): Collection<K, V>;
+    difference(other: ReadonlyCollection<Key, any>): Collection<Key, Value>;
     /**
      * Returns a new collection containing only the items where the keys are present in either collection, but not both.
      *
@@ -448,7 +448,7 @@ declare class Collection<K, V> extends Map<K, V> {
      * // => Collection { 'b' => 2, 'c' => 3 }
      * ```
      */
-    symmetricDifference<T>(other: ReadonlyCollection<K, T>): Collection<K, T | V>;
+    symmetricDifference<OtherValue>(other: ReadonlyCollection<Key, OtherValue>): Collection<Key, OtherValue | Value>;
     /**
      * Merges two Collections together into a new Collection.
      *
@@ -477,12 +477,12 @@ 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>;
+    merge<OtherValue, ResultValue>(other: ReadonlyCollection<Key, OtherValue>, whenInSelf: (value: Value, key: Key) => Keep<ResultValue>, whenInOther: (valueOther: OtherValue, key: Key) => Keep<ResultValue>, whenInBoth: (value: Value, valueOther: OtherValue, key: Key) => Keep<ResultValue>): Collection<Key, ResultValue>;
     /**
      * 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>;
+    toReversed(): Collection<Key, Value>;
     /**
      * The sorted method sorts the items of a collection and returns it.
      * The sort is not necessarily stable in Node 10 or older.
@@ -496,8 +496,8 @@ declare class Collection<K, V> extends Map<K, V> {
      * collection.sorted((userA, userB) => userA.createdTimestamp - userB.createdTimestamp);
      * ```
      */
-    toSorted(compareFunction?: Comparator<K, V>): Collection<K, V>;
-    toJSON(): [K, V][];
+    toSorted(compareFunction?: Comparator<Key, Value>): Collection<Key, Value>;
+    toJSON(): [Key, Value][];
     private static defaultSort;
     /**
      * Creates a Collection from a list of entries.
@@ -510,21 +510,21 @@ declare class Collection<K, V> extends Map<K, V> {
      * // returns Collection { "a" => 3, "b" => 2 }
      * ```
      */
-    static combineEntries<K, V>(entries: Iterable<[K, V]>, combine: (firstValue: V, secondValue: V, key: K) => V): Collection<K, V>;
+    static combineEntries<Key, Value>(entries: Iterable<[Key, Value]>, combine: (firstValue: Value, secondValue: Value, key: Key) => Value): Collection<Key, Value>;
 }
 /**
  * @internal
  */
-type Keep<V> = {
+type Keep<Value> = {
     keep: false;
 } | {
     keep: true;
-    value: V;
+    value: Value;
 };
 /**
  * @internal
  */
-type Comparator<K, V> = (firstValue: V, secondValue: V, firstKey: K, secondKey: K) => number;
+type Comparator<Key, Value> = (firstValue: Value, secondValue: Value, firstKey: Key, secondKey: Key) => number;
 
 /**
  * The {@link https://github.com/discordjs/discord.js/blob/main/packages/collection/#readme | @discordjs/collection} version