Merge branch 'special-array' into enhancer-callback-2

Author: ben.durrant

docs/usage/usage-with-typescript.md

@@ -136,7 +136,7 @@ export default store
 
 #### Using `Tuple` without `getDefaultMiddleware`
 
-If you want to skip the usage of `getDefaultMiddleware` altogether, you are requred to use `Tuple` for type-safe creation of your `middleware` array. This class extends the default JavaScript `Array` type, only with modified typings for `.concat(...)` and the additional `.prepend(...)` method.
+If you want to skip the usage of `getDefaultMiddleware` altogether, you are required to use `Tuple` for type-safe creation of your `middleware` array. This class extends the default JavaScript `Array` type, only with modified typings for `.concat(...)` and the additional `.prepend(...)` method.
 
 For example:
 

packages/toolkit/src/tests/Tuple.typetest.ts

@@ -14,7 +14,7 @@ import { expectType } from './helpers'
   // @ts-expect-error
   expectType<Tuple<[string, string]>>(stringTuple)
 
-  const numberTuple = new Tuple(0)
+  const numberTuple = new Tuple(0, 1)
   // @ts-expect-error
   expectType<Tuple<string[]>>(numberTuple)
 }
@@ -63,19 +63,19 @@ import { expectType } from './helpers'
 {
   const stringTuple = new Tuple('')
 
-  const numberTuple = new Tuple(0)
+  const numberTuple = new Tuple(0, 1)
 
-  expectType<Tuple<[string, number]>>(stringTuple.concat(numberTuple))
+  expectType<Tuple<[string, number, number]>>(stringTuple.concat(numberTuple))
 
-  expectType<Tuple<[number, string]>>(stringTuple.prepend(numberTuple))
+  expectType<Tuple<[number, number, string]>>(stringTuple.prepend(numberTuple))
 
-  expectType<Tuple<[number, string]>>(numberTuple.concat(stringTuple))
+  expectType<Tuple<[number, number, string]>>(numberTuple.concat(stringTuple))
 
-  expectType<Tuple<[string, number]>>(numberTuple.prepend(stringTuple))
+  expectType<Tuple<[string, number, number]>>(numberTuple.prepend(stringTuple))
 
   // @ts-expect-error
-  expectType<Tuple<[string, number]>>(stringTuple.prepend(numberTuple))
+  expectType<Tuple<[string, number, number]>>(stringTuple.prepend(numberTuple))
 
   // @ts-expect-error
-  expectType<Tuple<[number, string]>>(stringTuple.concat(numberTuple))
+  expectType<Tuple<[number, number, string]>>(stringTuple.concat(numberTuple))
 }

packages/toolkit/src/utils.ts

@@ -40,10 +40,12 @@ export function find<T>(
   return undefined
 }
 
-export class Tuple<Items extends ReadonlyArray<unknown>> extends Array<
+export class Tuple<Items extends ReadonlyArray<unknown> = []> extends Array<
   Items[number]
 > {
-  constructor(...items: Items) {
+  constructor(length: number)
+  constructor(...items: Items)
+  constructor(...items: any[]) {
     super(...items)
     Object.setPrototypeOf(this, Tuple.prototype)
   }