isaacscript-common 31.2.1 → 31.2.4

package/dist/index.rollup.d.ts

@@ -1035,6 +1035,10 @@ export declare function anyPlayerHoldingItem(): boolean;
  */
 export declare function anyPlayerIs(...matchingCharacters: PlayerType[]): boolean;
 
+declare type Arr<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Arr<N, [...T, unknown]>;
+
+declare type Arr_2<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Arr_2<N, [...T, unknown]>;
+
 /**
  * Helper function for determining if two arrays contain the exact same elements. Note that this
  * only performs a shallow comparison.
@@ -3196,7 +3200,7 @@ declare class DebugDisplay extends Feature {
  *
  * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
  */
-export declare type Decrement<N extends number> = Tuple<N> extends [unknown, ...infer U] ? U["length"] : never;
+export declare type Decrement<N extends number> = Arr<N> extends [unknown, ...infer U] ? U["length"] : never;
 
 /**
  * `deepCopy` is a semi-generic deep cloner. It will recursively copy all of the values so that none
@@ -4221,7 +4225,7 @@ export declare function filter<T>(array: T[], func: (value: T, index: number, ar
  * This is named `filterMap` after the Rust function:
  * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
  */
-export declare function filterMap<OldT, NewT>(array: OldT[], func: (element: OldT) => NewT | undefined): NewT[];
+export declare function filterMap<OldT, NewT>(array: OldT[] | readonly OldT[], func: (element: OldT) => NewT | undefined): NewT[];
 
 /**
  * Helper function for non-TypeScript users to find an element in an array.
@@ -7548,7 +7552,7 @@ export declare function inCrawlSpace(): boolean;
  *
  * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
  */
-export declare type Increment<N extends number> = [...Tuple<N>, unknown]["length"] & number;
+export declare type Increment<N extends number> = [...Arr_2<N>, unknown]["length"] & number;
 
 /**
  * Helper function to detect if the current room is one of the rooms in the Death Certificate area.
@@ -16965,11 +16969,12 @@ export declare interface TSTLClassMetatable {
 /**
  * Helper type to represent a tuple of length N.
  *
- * This is used by the `Increment` and `Decrement` helper types.
- *
- * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
+ * From:
+ * https://stackoverflow.com/questions/52489261/typescript-can-i-define-an-n-length-tuple-type/52490977#52490977
  */
-export declare type Tuple<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Tuple<N, [...T, unknown]>;
+export declare type Tuple<T, N extends number> = N extends N ? number extends N ? T[] : _TupleOf<T, N, []> : never;
+
+declare type _TupleOf<T, N extends number, R extends unknown[]> = R["length"] extends N ? R : _TupleOf<T, N, [T, ...R]>;
 
 export declare type TupleToIntersection<T extends unknown[]> = T extends [
 infer F,

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 31.2.1
+isaacscript-common 31.2.4
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -53818,10 +53818,6 @@ return ____exports
  end,
 ["src.types.AllButLast"] = function(...) 
 local ____exports = {}
-return ____exports
- end,
-["src.types.Tuple"] = function(...) 
-local ____exports = {}
 return ____exports
  end,
 ["src.types.Decrement"] = function(...) 
@@ -53858,6 +53854,10 @@ return ____exports
  end,
 ["src.types.StartsWithUppercase"] = function(...) 
 local ____exports = {}
+return ____exports
+ end,
+["src.types.Tuple"] = function(...) 
+local ____exports = {}
 return ____exports
  end,
 ["src.types.TupleToUnion"] = function(...) 
@@ -53866,10 +53866,23 @@ return ____exports
  end,
 ["src.types.TupleWithLengthBetween"] = function(...) 
 local ____exports = {}
+local zeroOneTwo = {}
+local oneOneTwo = {"1"}
+local twoOneTwo = {"1", "2"}
+local threeOneTwo = {"1", "2", "3"}
 return ____exports
  end,
 ["src.types.TupleWithMaxLength"] = function(...) 
 local ____exports = {}
+local zeroZero = {}
+local oneZero = {"1"}
+local zeroOne = {}
+local oneOne = {"1"}
+local twoOne = {"1", "2"}
+local zeroTwo = {}
+local oneTwo = {"1"}
+local twoTwo = {"1", "2"}
+local threeTwo = {"1", "2", "3"}
 return ____exports
  end,
 ["src.types.UnionToIntersection"] = function(...) 

package/dist/src/functions/array.d.ts

@@ -104,7 +104,7 @@ export declare function emptyArray<T>(array: T[]): void;
  * This is named `filterMap` after the Rust function:
  * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
  */
-export declare function filterMap<OldT, NewT>(array: OldT[], func: (element: OldT) => NewT | undefined): NewT[];
+export declare function filterMap<OldT, NewT>(array: OldT[] | readonly OldT[], func: (element: OldT) => NewT | undefined): NewT[];
 /**
  * Helper function to get all possible combinations of the given array. This includes the
  * combination of an empty array.

package/dist/src/functions/array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/functions/array.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/functions/array.ts"],"names":[],"mappings":"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"}

package/dist/src/types/Decrement.d.ts

@@ -1,8 +1,9 @@
-import type { Tuple } from "./Tuple";
 /**
  * Helper type to subtract one from a number type.
  *
  * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
  */
-export type Decrement<N extends number> = Tuple<N> extends [unknown, ...infer U] ? U["length"] : never;
+export type Decrement<N extends number> = Arr<N> extends [unknown, ...infer U] ? U["length"] : never;
+type Arr<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Arr<N, [...T, unknown]>;
+export {};
 //# sourceMappingURL=Decrement.d.ts.map

package/dist/src/types/Decrement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Decrement.d.ts","sourceRoot":"","sources":["../../../src/types/Decrement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,GAC5E,CAAC,CAAC,QAAQ,CAAC,GACX,KAAK,CAAC"}
+{"version":3,"file":"Decrement.d.ts","sourceRoot":"","sources":["../../../src/types/Decrement.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,GAC1E,CAAC,CAAC,QAAQ,CAAC,GACX,KAAK,CAAC;AAEV,KAAK,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GACxE,CAAC,GACD,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/src/types/Increment.d.ts

@@ -1,8 +1,9 @@
-import type { Tuple } from "./Tuple";
 /**
  * Helper type to add one to a number type.
  *
  * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
  */
-export type Increment<N extends number> = [...Tuple<N>, unknown]["length"] & number;
+export type Increment<N extends number> = [...Arr<N>, unknown]["length"] & number;
+type Arr<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Arr<N, [...T, unknown]>;
+export {};
 //# sourceMappingURL=Increment.d.ts.map

package/dist/src/types/Increment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Increment.d.ts","sourceRoot":"","sources":["../../../src/types/Increment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GACxE,MAAM,CAAC"}
+{"version":3,"file":"Increment.d.ts","sourceRoot":"","sources":["../../../src/types/Increment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GACtE,MAAM,CAAC;AAET,KAAK,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GACxE,CAAC,GACD,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/src/types/Tuple.d.ts

@@ -1,9 +1,10 @@
 /**
  * Helper type to represent a tuple of length N.
  *
- * This is used by the `Increment` and `Decrement` helper types.
- *
- * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
+ * From:
+ * https://stackoverflow.com/questions/52489261/typescript-can-i-define-an-n-length-tuple-type/52490977#52490977
  */
-export type Tuple<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Tuple<N, [...T, unknown]>;
+export type Tuple<T, N extends number> = N extends N ? number extends N ? T[] : _TupleOf<T, N, []> : never;
+type _TupleOf<T, N extends number, R extends unknown[]> = R["length"] extends N ? R : _TupleOf<T, N, [T, ...R]>;
+export {};
 //# sourceMappingURL=Tuple.d.ts.map

package/dist/src/types/Tuple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tuple.d.ts","sourceRoot":"","sources":["../../../src/types/Tuple.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,CACf,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,IACtB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Tuple.d.ts","sourceRoot":"","sources":["../../../src/types/Tuple.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GAChD,MAAM,SAAS,CAAC,GACd,CAAC,EAAE,GACH,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GACpB,KAAK,CAAC;AACV,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAC3E,CAAC,GACD,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/dist/src/types/TupleWithLengthBetween.lua

@@ -1,2 +1,6 @@
 local ____exports = {}
+local zeroOneTwo = {}
+local oneOneTwo = {"1"}
+local twoOneTwo = {"1", "2"}
+local threeOneTwo = {"1", "2", "3"}
 return ____exports

package/dist/src/types/TupleWithMaxLength.lua

@@ -1,2 +1,11 @@
 local ____exports = {}
+local zeroZero = {}
+local oneZero = {"1"}
+local zeroOne = {}
+local oneOne = {"1"}
+local twoOne = {"1", "2"}
+local zeroTwo = {}
+local oneTwo = {"1"}
+local twoTwo = {"1", "2"}
+local threeTwo = {"1", "2", "3"}
 return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "31.2.1",
+  "version": "31.2.4",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/functions/array.ts

@@ -244,7 +244,7 @@ export function emptyArray<T>(array: T[]): void {
  * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
  */
 export function filterMap<OldT, NewT>(
-  array: OldT[],
+  array: OldT[] | readonly OldT[],
   func: (element: OldT) => NewT | undefined,
 ): NewT[] {
   const newArray: NewT[] = [];

package/src/types/Decrement.ts

@@ -1,10 +1,12 @@
-import type { Tuple } from "./Tuple";
-
 /**
  * Helper type to subtract one from a number type.
  *
  * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
  */
-export type Decrement<N extends number> = Tuple<N> extends [unknown, ...infer U]
+export type Decrement<N extends number> = Arr<N> extends [unknown, ...infer U]
   ? U["length"]
   : never;
+
+type Arr<N extends number, T extends unknown[] = []> = T["length"] extends N
+  ? T
+  : Arr<N, [...T, unknown]>;

package/src/types/Increment.ts

@@ -1,9 +1,11 @@
-import type { Tuple } from "./Tuple";
-
 /**
  * Helper type to add one to a number type.
  *
  * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
  */
-export type Increment<N extends number> = [...Tuple<N>, unknown]["length"] &
+export type Increment<N extends number> = [...Arr<N>, unknown]["length"] &
   number;
+
+type Arr<N extends number, T extends unknown[] = []> = T["length"] extends N
+  ? T
+  : Arr<N, [...T, unknown]>;

package/src/types/Tuple.ts

@@ -1,11 +1,14 @@
 /**
  * Helper type to represent a tuple of length N.
  *
- * This is used by the `Increment` and `Decrement` helper types.
- *
- * From: https://stackoverflow.com/questions/54243431/typescript-increment-number-type
+ * From:
+ * https://stackoverflow.com/questions/52489261/typescript-can-i-define-an-n-length-tuple-type/52490977#52490977
  */
-export type Tuple<
-  N extends number,
-  T extends unknown[] = [],
-> = T["length"] extends N ? T : Tuple<N, [...T, unknown]>;
+export type Tuple<T, N extends number> = N extends N
+  ? number extends N
+    ? T[]
+    : _TupleOf<T, N, []>
+  : never;
+type _TupleOf<T, N extends number, R extends unknown[]> = R["length"] extends N
+  ? R
+  : _TupleOf<T, N, [T, ...R]>;

package/src/types/TupleWithLengthBetween.ts

@@ -13,3 +13,31 @@ export type TupleWithLengthBetween<
 > = (T[] | readonly T[]) & {
   length: Range<MinLength, MaxLength>;
 };
+
+// -----
+// Tests
+// -----
+
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/* eslint-disable isaacscript/require-unannotated-const-assertions */
+
+// @ts-expect-error Tuple of length 0 with min length 1 and max length 2.
+const zeroOneTwo: TupleWithLengthBetween<string, 1, 2> = [] as const;
+
+// Tuple of length 1 with min length 1 and max length 2.
+const oneOneTwo: TupleWithLengthBetween<string, 1, 2> = ["1"] as const;
+
+// Tuple of length 2 with min length 1 and max length 2.
+const twoOneTwo: TupleWithLengthBetween<string, 1, 2> = ["1", "2"] as const;
+
+// @ts-expect-error Tuple of length 3 with min length 1 and max length 2.
+const threeOneTwo: TupleWithLengthBetween<string, 1, 2> = [
+  "1",
+  "2",
+  "3",
+] as const;
+
+/* eslint-enable @typescript-eslint/no-unused-vars */
+/* eslint-enable isaacscript/require-unannotated-const-assertions */
+
+// See "TupleWithMaxLength.ts" for more tests.

package/src/types/TupleWithMaxLength.ts

@@ -11,3 +11,40 @@ export type TupleWithMaxLength<T, MaxLength extends number> = (
 ) & {
   length: Range<0, MaxLength>;
 };
+
+// -----
+// Tests
+// -----
+
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/* eslint-disable isaacscript/require-unannotated-const-assertions */
+
+// Tuple of length 0 with max length 0.
+const zeroZero: TupleWithMaxLength<string, 0> = [] as const;
+
+// @ts-expect-error Tuple of length 1 with max length 0.
+const oneZero: TupleWithMaxLength<string, 0> = ["1"] as const;
+
+// Tuple of length 0 with max length 1.
+const zeroOne: TupleWithMaxLength<string, 1> = [] as const;
+
+// Tuple of length 1 with max length 1.
+const oneOne: TupleWithMaxLength<string, 1> = ["1"] as const;
+
+// @ts-expect-error Tuple of length 2 with max length 1.
+const twoOne: TupleWithMaxLength<string, 1> = ["1", "2"] as const;
+
+// Tuple of length 0 with max length 2.
+const zeroTwo: TupleWithMaxLength<string, 2> = [] as const;
+
+// Tuple of length 1 with max length 2.
+const oneTwo: TupleWithMaxLength<string, 2> = ["1"] as const;
+
+// Tuple of length 2 with max length 2.
+const twoTwo: TupleWithMaxLength<string, 2> = ["1", "2"] as const;
+
+// @ts-expect-error Tuple of length 3 with max length 2.
+const threeTwo: TupleWithMaxLength<string, 2> = ["1", "2", "3"] as const;
+
+/* eslint-enable @typescript-eslint/no-unused-vars */
+/* eslint-enable isaacscript/require-unannotated-const-assertions */