isaacscript-common 83.5.0 → 84.0.0

package/dist/core/constantsFirstLast.d.ts

@@ -4,7 +4,7 @@
  * @module
  */
 import { CardType, CollectibleType, PillColor, PillEffect, PlayerType, TrinketType } from "isaac-typescript-definitions";
-/** Equal to `CollectibleType.SAD_ONION`. */
+/** Equal to `CollectibleType.SAD_ONION` (1). */
 export declare const FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION;
 /**
  * Calculated from the `CollectibleType` enum.
@@ -15,7 +15,7 @@ export declare const FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION;
 export declare const LAST_VANILLA_COLLECTIBLE_TYPE: CollectibleType;
 /** Calculated from the `CollectibleType` enum. (`CollectibleType.NULL` is not included.) */
 export declare const NUM_VANILLA_COLLECTIBLE_TYPES: number;
-/** Equal to `TrinketType.SWALLOWED_PENNY`. */
+/** Equal to `TrinketType.SWALLOWED_PENNY` (1). */
 export declare const FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY;
 /**
  * Calculated from the `TrinketType` enum.
@@ -26,13 +26,13 @@ export declare const FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY;
 export declare const LAST_VANILLA_TRINKET_TYPE: TrinketType;
 /** Calculated from the `TrinketType` enum. (`TrinketType.NULL` is not included.) */
 export declare const NUM_VANILLA_TRINKET_TYPES: number;
-/** Equal to `Card.FOOL`. */
+/** Equal to `Card.FOOL` (1). */
 export declare const FIRST_CARD_TYPE = CardType.FOOL;
 /** Calculated from the `CardType` enum. */
 export declare const LAST_VANILLA_CARD_TYPE: CardType;
 /** Calculated from the `Card` enum. `Card.NULL` is not included. */
 export declare const NUM_VANILLA_CARD_TYPES: number;
-/** Equal to `PillEffect.BAD_GAS`. */
+/** Equal to `PillEffect.BAD_GAS` (0). */
 export declare const FIRST_PILL_EFFECT = PillEffect.BAD_GAS;
 /** Calculated from the `PillEffect` enum. */
 export declare const LAST_VANILLA_PILL_EFFECT: PillEffect;
@@ -41,26 +41,30 @@ export declare const LAST_VANILLA_PILL_EFFECT: PillEffect;
  * do not have to subtract one here.)
  */
 export declare const NUM_VANILLA_PILL_EFFECTS: int;
-/** Equal to `PillColor.BLUE_BLUE`. */
+/** Equal to `PillColor.BLUE_BLUE` (1). */
 export declare const FIRST_PILL_COLOR = PillColor.BLUE_BLUE;
 /**
- * Equal to `PillColor.WHITE_YELLOW`.
+ * Equal to `PillColor.WHITE_YELLOW` (13).
  *
  * Note that `PillColor.GOLD` is technically higher, but that is not considered for the purposes of
  * this constant.
  */
 export declare const LAST_NORMAL_PILL_COLOR = PillColor.WHITE_YELLOW;
-/** Equal to `PillColor.HORSE_BLUE_BLUE`. */
+/** Equal to `PillColor.HORSE_BLUE_BLUE` (2049). */
 export declare const FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE;
 /**
- * Equal to `PillColor.HORSE_WHITE_YELLOW`.
+ * Equal to `PillColor.HORSE_WHITE_YELLOW` (2061).
  *
  * Note that `PillColor.HORSE_GOLD` is technically higher, but that is not considered for the
  * purposes of this constant.
  */
 export declare const LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW;
+/**
+ * Calculated from the difference between the first pill color and the last pill color. This does
+ * not include Gold Pills. In Repentance, this should be equal to 13.
+ */
 export declare const NUM_NORMAL_PILL_COLORS: number;
-/** Equal to `PlayerType.ISAAC`. */
+/** Equal to `PlayerType.ISAAC` (0). */
 export declare const FIRST_CHARACTER = PlayerType.ISAAC;
 /** Calculated from the `PlayerType` enum. */
 export declare const LAST_VANILLA_CHARACTER: PlayerType;

package/dist/core/constantsFirstLast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constantsFirstLast.d.ts","sourceRoot":"","sources":["../../src/core/constantsFirstLast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EAER,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAQtC,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,iBACJ,CAAC;AAEvC,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAAqC,CAAC;AAMhF,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,aAAmC,CAAC;AAE1E,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,QAAiC,CAAC;AAMxE,4BAA4B;AAC5B,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,UAAgC,CAAC;AAEpE,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAMlE,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,YAAkC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAA4B,CAAC;AAMlE,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAElE,eAAO,MAAM,sBAAsB,QAG3B,CAAC;AAMT,mCAAmC;AACnC,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAIhD,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,YAAkC,CAAC;AAMtE,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,QAA+B,CAAC"}
+{"version":3,"file":"constantsFirstLast.d.ts","sourceRoot":"","sources":["../../src/core/constantsFirstLast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EAER,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAOtC,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,iBACJ,CAAC;AAEvC,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAAqC,CAAC;AAMhF,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,aAAmC,CAAC;AAE1E,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,QAAiC,CAAC;AAMxE,gCAAgC;AAChC,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,UAAgC,CAAC;AAEpE,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAMlE,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,YAAkC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAA4B,CAAC;AAMlE,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QACY,CAAC;AAMhD,uCAAuC;AACvC,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAIhD,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,YAAkC,CAAC;AAMtE,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,QAA+B,CAAC"}

package/dist/core/constantsFirstLast.lua

@@ -10,9 +10,7 @@ local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____enums = require("functions.enums")
 local getEnumLength = ____enums.getEnumLength
 local getHighestEnumValue = ____enums.getHighestEnumValue
-local ____utils = require("functions.utils")
-local iRange = ____utils.iRange
---- Equal to `CollectibleType.SAD_ONION`.
+--- Equal to `CollectibleType.SAD_ONION` (1).
 ____exports.FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION
 --- Calculated from the `CollectibleType` enum.
 -- 
@@ -21,7 +19,7 @@ ____exports.FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION
 ____exports.LAST_VANILLA_COLLECTIBLE_TYPE = getHighestEnumValue(nil, CollectibleType)
 --- Calculated from the `CollectibleType` enum. (`CollectibleType.NULL` is not included.)
 ____exports.NUM_VANILLA_COLLECTIBLE_TYPES = getEnumLength(nil, CollectibleType) - 1
---- Equal to `TrinketType.SWALLOWED_PENNY`.
+--- Equal to `TrinketType.SWALLOWED_PENNY` (1).
 ____exports.FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY
 --- Calculated from the `TrinketType` enum.
 -- 
@@ -30,35 +28,37 @@ ____exports.FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY
 ____exports.LAST_VANILLA_TRINKET_TYPE = getHighestEnumValue(nil, TrinketType)
 --- Calculated from the `TrinketType` enum. (`TrinketType.NULL` is not included.)
 ____exports.NUM_VANILLA_TRINKET_TYPES = getEnumLength(nil, TrinketType) - 1
---- Equal to `Card.FOOL`.
+--- Equal to `Card.FOOL` (1).
 ____exports.FIRST_CARD_TYPE = CardType.FOOL
 --- Calculated from the `CardType` enum.
 ____exports.LAST_VANILLA_CARD_TYPE = getHighestEnumValue(nil, CardType)
 --- Calculated from the `Card` enum. `Card.NULL` is not included.
 ____exports.NUM_VANILLA_CARD_TYPES = getEnumLength(nil, CardType) - 1
---- Equal to `PillEffect.BAD_GAS`.
+--- Equal to `PillEffect.BAD_GAS` (0).
 ____exports.FIRST_PILL_EFFECT = PillEffect.BAD_GAS
 --- Calculated from the `PillEffect` enum.
 ____exports.LAST_VANILLA_PILL_EFFECT = getHighestEnumValue(nil, PillEffect)
 --- Calculated from the `PillEffect` enum. (There is no `PillEffect.NULL` in the custom enum, so we
 -- do not have to subtract one here.)
 ____exports.NUM_VANILLA_PILL_EFFECTS = getEnumLength(nil, PillEffect)
---- Equal to `PillColor.BLUE_BLUE`.
+--- Equal to `PillColor.BLUE_BLUE` (1).
 ____exports.FIRST_PILL_COLOR = PillColor.BLUE_BLUE
---- Equal to `PillColor.WHITE_YELLOW`.
+--- Equal to `PillColor.WHITE_YELLOW` (13).
 -- 
 -- Note that `PillColor.GOLD` is technically higher, but that is not considered for the purposes of
 -- this constant.
 ____exports.LAST_NORMAL_PILL_COLOR = PillColor.WHITE_YELLOW
---- Equal to `PillColor.HORSE_BLUE_BLUE`.
+--- Equal to `PillColor.HORSE_BLUE_BLUE` (2049).
 ____exports.FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE
---- Equal to `PillColor.HORSE_WHITE_YELLOW`.
+--- Equal to `PillColor.HORSE_WHITE_YELLOW` (2061).
 -- 
 -- Note that `PillColor.HORSE_GOLD` is technically higher, but that is not considered for the
 -- purposes of this constant.
 ____exports.LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW
-____exports.NUM_NORMAL_PILL_COLORS = #iRange(nil, ____exports.FIRST_PILL_COLOR, ____exports.LAST_NORMAL_PILL_COLOR)
---- Equal to `PlayerType.ISAAC`.
+--- Calculated from the difference between the first pill color and the last pill color. This does
+-- not include Gold Pills. In Repentance, this should be equal to 13.
+____exports.NUM_NORMAL_PILL_COLORS = ____exports.LAST_NORMAL_PILL_COLOR - ____exports.FIRST_PILL_COLOR + 1
+--- Equal to `PlayerType.ISAAC` (0).
 ____exports.FIRST_CHARACTER = PlayerType.ISAAC
 --- Calculated from the `PlayerType` enum.
 ____exports.LAST_VANILLA_CHARACTER = getHighestEnumValue(nil, PlayerType)

package/dist/functions/gridIndex.d.ts

@@ -3,6 +3,8 @@ import { RoomShape } from "isaac-typescript-definitions";
  * Helper function to get all of the grid indexes between two grid indexes on either a horizontal or
  * vertical line, inclusive on both ends.
  *
+ * If the first grid index is greater than the second grid index, the two will be swapped.
+ *
  * This function will throw a run-time error if the two provided grid indexes are not on the same
  * horizontal or vertical line.
  */

package/dist/functions/gridIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gridIndex.d.ts","sourceRoot":"","sources":["../../src/functions/gridIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAIzD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,SAAS,GACnB,SAAS,GAAG,EAAE,CAwBhB"}
+{"version":3,"file":"gridIndex.d.ts","sourceRoot":"","sources":["../../src/functions/gridIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAIzD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,SAAS,GACnB,SAAS,GAAG,EAAE,CAwBhB"}

package/dist/functions/gridIndex.lua

@@ -8,6 +8,8 @@ local iRange = ____utils.iRange
 --- Helper function to get all of the grid indexes between two grid indexes on either a horizontal or
 -- vertical line, inclusive on both ends.
 -- 
+-- If the first grid index is greater than the second grid index, the two will be swapped.
+-- 
 -- This function will throw a run-time error if the two provided grid indexes are not on the same
 -- horizontal or vertical line.
 function ____exports.getGridIndexesBetween(self, gridIndex1, gridIndex2, roomShape)

package/dist/functions/utils.d.ts

@@ -22,7 +22,7 @@ export declare function assertNotNull<T>(value: T, ...[msg]: [null] extends [T]
  * end and exclusive on the high end. (The "e" in the function name stands for exclusive.) Thus,
  * this function works in a similar way as the built-in `range` function from Python.
  *
- * If the end is lower than the start, then the range will be reversed.
+ * If the end is lower than the start, an empty array will be returned.
  *
  * For example:
  *
@@ -31,7 +31,6 @@ export declare function assertNotNull<T>(value: T, ...[msg]: [null] extends [T]
  * - `eRange(-3)` returns `[0, -1, -2]`.
  * - `eRange(1, 3)` returns `[1, 2]`.
  * - `eRange(2, 5)` returns `[2, 3, 4]`.
- * - `eRange(5, 2)` returns `[5, 4, 3]`.
  *
  * @param start The integer to start at.
  * @param end Optional. The integer to end at. If not specified, then the start will be 0 and the
@@ -48,7 +47,7 @@ export declare function getTraversalDescription(key: unknown, traversalDescripti
  * Helper function to return an array of integers with the specified range, inclusive on both ends.
  * (The "i" in the function name stands for inclusive.)
  *
- * If the end is lower than the start, then the range will be reversed.
+ * If the end is lower than the start, an empty array will be returned.
  *
  * For example:
  *

package/dist/functions/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/functions/utils.ts"],"names":[],"mappings":";AAIA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,GAC7B,CAAC,MAAM,CAAC,GACR;IACE,iFAAiF;CAClF,GACJ,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAIxC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GACxB,CAAC,MAAM,CAAC,GACR;IACE,4EAA4E;CAC7E,GACJ,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAInC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,SAAS,SAAI,GAAG,SAAS,GAAG,EAAE,CAkB3E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,SAAS,SAAI,GAAG,SAAS,GAAG,EAAE,CAQ3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAMvC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAiBtC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAI7D;AAED;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAG"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/functions/utils.ts"],"names":[],"mappings":";AAIA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,GAC7B,CAAC,MAAM,CAAC,GACR;IACE,iFAAiF;CAClF,GACJ,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAIxC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GACxB,CAAC,MAAM,CAAC,GACR;IACE,4EAA4E;CAC7E,GACJ,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAInC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,SAAS,SAAI,GAAG,SAAS,GAAG,EAAE,CAY3E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,SAAS,SAAI,GAAG,SAAS,GAAG,EAAE,CAM3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAMvC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAiBtC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAI7D;AAED;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAG"}

package/dist/functions/utils.lua

@@ -36,7 +36,7 @@ end
 -- end and exclusive on the high end. (The "e" in the function name stands for exclusive.) Thus,
 -- this function works in a similar way as the built-in `range` function from Python.
 -- 
--- If the end is lower than the start, then the range will be reversed.
+-- If the end is lower than the start, an empty array will be returned.
 -- 
 -- For example:
 -- 
@@ -45,7 +45,6 @@ end
 -- - `eRange(-3)` returns `[0, -1, -2]`.
 -- - `eRange(1, 3)` returns `[1, 2]`.
 -- - `eRange(2, 5)` returns `[2, 3, 4]`.
--- - `eRange(5, 2)` returns `[5, 4, 3]`.
 -- 
 -- @param start The integer to start at.
 -- @param end Optional. The integer to end at. If not specified, then the start will be 0 and the
@@ -59,21 +58,11 @@ function ____exports.eRange(self, start, ____end, increment)
         return ____exports.eRange(nil, 0, start, increment)
     end
     local array = {}
-    if start < ____end then
-        do
-            local i = start
-            while i < ____end do
-                array[#array + 1] = i
-                i = i + increment
-            end
-        end
-    else
-        do
-            local i = start
-            while i > ____end do
-                array[#array + 1] = i
-                i = i - increment
-            end
+    do
+        local i = start
+        while i < ____end do
+            array[#array + 1] = i
+            i = i + increment
         end
     end
     return array
@@ -90,7 +79,7 @@ end
 --- Helper function to return an array of integers with the specified range, inclusive on both ends.
 -- (The "i" in the function name stands for inclusive.)
 -- 
--- If the end is lower than the start, then the range will be reversed.
+-- If the end is lower than the start, an empty array will be returned.
 -- 
 -- For example:
 -- 
@@ -112,9 +101,7 @@ function ____exports.iRange(self, start, ____end, increment)
     if ____end == nil then
         return ____exports.iRange(nil, 0, start, increment)
     end
-    local rangeIncreasing = start <= ____end
-    local exclusiveEnd = rangeIncreasing and ____end + 1 or ____end - 1
-    return ____exports.eRange(nil, start, exclusiveEnd, increment)
+    return ____exports.eRange(nil, start, ____end + 1, increment)
 end
 --- Helper function to check if a variable is within a certain range, inclusive on both ends.
 -- 

package/dist/index.rollup.d.ts

@@ -4387,7 +4387,7 @@ export declare type ERange<Low extends number, High extends number> = Exclude<Na
  * end and exclusive on the high end. (The "e" in the function name stands for exclusive.) Thus,
  * this function works in a similar way as the built-in `range` function from Python.
  *
- * If the end is lower than the start, then the range will be reversed.
+ * If the end is lower than the start, an empty array will be returned.
  *
  * For example:
  *
@@ -4396,7 +4396,6 @@ export declare type ERange<Low extends number, High extends number> = Exclude<Na
  * - `eRange(-3)` returns `[0, -1, -2]`.
  * - `eRange(1, 3)` returns `[1, 2]`.
  * - `eRange(2, 5)` returns `[2, 3, 4]`.
- * - `eRange(5, 2)` returns `[5, 4, 3]`.
  *
  * @param start The integer to start at.
  * @param end Optional. The integer to end at. If not specified, then the start will be 0 and the
@@ -4664,13 +4663,13 @@ export declare function fireProjectiles(npc: EntityNPC | undefined, position: Ve
  */
 export declare function fireProjectilesInCircle(npc: EntityNPC | undefined, position: Vector, speed: float, numProjectiles: int): readonly EntityProjectile[];
 
-/** Equal to `Card.FOOL`. */
+/** Equal to `Card.FOOL` (1). */
 export declare const FIRST_CARD_TYPE = CardType.FOOL;
 
-/** Equal to `PlayerType.ISAAC`. */
+/** Equal to `PlayerType.ISAAC` (0). */
 export declare const FIRST_CHARACTER = PlayerType.ISAAC;
 
-/** Equal to `CollectibleType.SAD_ONION`. */
+/** Equal to `CollectibleType.SAD_ONION` (1). */
 export declare const FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION;
 
 /**
@@ -4682,16 +4681,16 @@ export declare const FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION;
  */
 export declare const FIRST_GLITCHED_COLLECTIBLE_TYPE: CollectibleType;
 
-/** Equal to `PillColor.HORSE_BLUE_BLUE`. */
+/** Equal to `PillColor.HORSE_BLUE_BLUE` (2049). */
 export declare const FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE;
 
-/** Equal to `PillColor.BLUE_BLUE`. */
+/** Equal to `PillColor.BLUE_BLUE` (1). */
 export declare const FIRST_PILL_COLOR = PillColor.BLUE_BLUE;
 
-/** Equal to `PillEffect.BAD_GAS`. */
+/** Equal to `PillEffect.BAD_GAS` (0). */
 export declare const FIRST_PILL_EFFECT = PillEffect.BAD_GAS;
 
-/** Equal to `TrinketType.SWALLOWED_PENNY`. */
+/** Equal to `TrinketType.SWALLOWED_PENNY` (1). */
 export declare const FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY;
 
 declare class FlipDetection extends Feature {
@@ -6089,6 +6088,8 @@ export declare function getGridIndexDelta(roomShape: RoomShape, doorSlot: DoorSl
  * Helper function to get all of the grid indexes between two grid indexes on either a horizontal or
  * vertical line, inclusive on both ends.
  *
+ * If the first grid index is greater than the second grid index, the two will be swapped.
+ *
  * This function will throw a run-time error if the two provided grid indexes are not on the same
  * horizontal or vertical line.
  */
@@ -8870,7 +8871,7 @@ export declare type IRange<Low extends number, High extends number> = Exclude<Na
  * Helper function to return an array of integers with the specified range, inclusive on both ends.
  * (The "i" in the function name stands for inclusive.)
  *
- * If the end is lower than the start, then the range will be reversed.
+ * If the end is lower than the start, an empty array will be returned.
  *
  * For example:
  *
@@ -10645,7 +10646,7 @@ export declare enum LadderSubTypeCustom {
 }
 
 /**
- * Equal to `PillColor.HORSE_WHITE_YELLOW`.
+ * Equal to `PillColor.HORSE_WHITE_YELLOW` (2061).
  *
  * Note that `PillColor.HORSE_GOLD` is technically higher, but that is not considered for the
  * purposes of this constant.
@@ -10653,7 +10654,7 @@ export declare enum LadderSubTypeCustom {
 export declare const LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW;
 
 /**
- * Equal to `PillColor.WHITE_YELLOW`.
+ * Equal to `PillColor.WHITE_YELLOW` (13).
  *
  * Note that `PillColor.GOLD` is technically higher, but that is not considered for the purposes of
  * this constant.
@@ -14952,6 +14953,10 @@ declare class NoSirenSteal extends Feature {
  */
 export declare const NUM_DIMENSIONS: number;
 
+/**
+ * Calculated from the difference between the first pill color and the last pill color. This does
+ * not include Gold Pills. In Repentance, this should be equal to 13.
+ */
 export declare const NUM_NORMAL_PILL_COLORS: number;
 
 /**

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 83.4.1
+isaacscript-common 83.5.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -13067,6 +13067,9 @@ return ____exports
 ["lua_modules.isaac-typescript-definitions.dist.enums.PillEffect"] = function(...) 
 local ____exports = {}
 --- This enum is contiguous. (Every value is satisfied between 0 and 49, inclusive.)
+-- 
+-- Note that the vanilla enum includes `NULL` (-1). Since it should be impossible to ever retrieve
+-- this value from the API, it is removed from the IsaacScript enum.
 ____exports.PillEffect = {}
 ____exports.PillEffect.BAD_GAS = 0
 ____exports.PillEffect[____exports.PillEffect.BAD_GAS] = "BAD_GAS"
@@ -17807,7 +17810,7 @@ end
 -- end and exclusive on the high end. (The "e" in the function name stands for exclusive.) Thus,
 -- this function works in a similar way as the built-in `range` function from Python.
 -- 
--- If the end is lower than the start, then the range will be reversed.
+-- If the end is lower than the start, an empty array will be returned.
 -- 
 -- For example:
 -- 
@@ -17816,7 +17819,6 @@ end
 -- - `eRange(-3)` returns `[0, -1, -2]`.
 -- - `eRange(1, 3)` returns `[1, 2]`.
 -- - `eRange(2, 5)` returns `[2, 3, 4]`.
--- - `eRange(5, 2)` returns `[5, 4, 3]`.
 -- 
 -- @param start The integer to start at.
 -- @param end Optional. The integer to end at. If not specified, then the start will be 0 and the
@@ -17830,21 +17832,11 @@ function ____exports.eRange(self, start, ____end, increment)
         return ____exports.eRange(nil, 0, start, increment)
     end
     local array = {}
-    if start < ____end then
-        do
-            local i = start
-            while i < ____end do
-                array[#array + 1] = i
-                i = i + increment
-            end
-        end
-    else
-        do
-            local i = start
-            while i > ____end do
-                array[#array + 1] = i
-                i = i - increment
-            end
+    do
+        local i = start
+        while i < ____end do
+            array[#array + 1] = i
+            i = i + increment
         end
     end
     return array
@@ -17861,7 +17853,7 @@ end
 --- Helper function to return an array of integers with the specified range, inclusive on both ends.
 -- (The "i" in the function name stands for inclusive.)
 -- 
--- If the end is lower than the start, then the range will be reversed.
+-- If the end is lower than the start, an empty array will be returned.
 -- 
 -- For example:
 -- 
@@ -17883,9 +17875,7 @@ function ____exports.iRange(self, start, ____end, increment)
     if ____end == nil then
         return ____exports.iRange(nil, 0, start, increment)
     end
-    local rangeIncreasing = start <= ____end
-    local exclusiveEnd = rangeIncreasing and ____end + 1 or ____end - 1
-    return ____exports.eRange(nil, start, exclusiveEnd, increment)
+    return ____exports.eRange(nil, start, ____end + 1, increment)
 end
 --- Helper function to check if a variable is within a certain range, inclusive on both ends.
 -- 
@@ -20189,9 +20179,7 @@ local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____enums = require("functions.enums")
 local getEnumLength = ____enums.getEnumLength
 local getHighestEnumValue = ____enums.getHighestEnumValue
-local ____utils = require("functions.utils")
-local iRange = ____utils.iRange
---- Equal to `CollectibleType.SAD_ONION`.
+--- Equal to `CollectibleType.SAD_ONION` (1).
 ____exports.FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION
 --- Calculated from the `CollectibleType` enum.
 -- 
@@ -20200,7 +20188,7 @@ ____exports.FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION
 ____exports.LAST_VANILLA_COLLECTIBLE_TYPE = getHighestEnumValue(nil, CollectibleType)
 --- Calculated from the `CollectibleType` enum. (`CollectibleType.NULL` is not included.)
 ____exports.NUM_VANILLA_COLLECTIBLE_TYPES = getEnumLength(nil, CollectibleType) - 1
---- Equal to `TrinketType.SWALLOWED_PENNY`.
+--- Equal to `TrinketType.SWALLOWED_PENNY` (1).
 ____exports.FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY
 --- Calculated from the `TrinketType` enum.
 -- 
@@ -20209,35 +20197,37 @@ ____exports.FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY
 ____exports.LAST_VANILLA_TRINKET_TYPE = getHighestEnumValue(nil, TrinketType)
 --- Calculated from the `TrinketType` enum. (`TrinketType.NULL` is not included.)
 ____exports.NUM_VANILLA_TRINKET_TYPES = getEnumLength(nil, TrinketType) - 1
---- Equal to `Card.FOOL`.
+--- Equal to `Card.FOOL` (1).
 ____exports.FIRST_CARD_TYPE = CardType.FOOL
 --- Calculated from the `CardType` enum.
 ____exports.LAST_VANILLA_CARD_TYPE = getHighestEnumValue(nil, CardType)
 --- Calculated from the `Card` enum. `Card.NULL` is not included.
 ____exports.NUM_VANILLA_CARD_TYPES = getEnumLength(nil, CardType) - 1
---- Equal to `PillEffect.BAD_GAS`.
+--- Equal to `PillEffect.BAD_GAS` (0).
 ____exports.FIRST_PILL_EFFECT = PillEffect.BAD_GAS
 --- Calculated from the `PillEffect` enum.
 ____exports.LAST_VANILLA_PILL_EFFECT = getHighestEnumValue(nil, PillEffect)
 --- Calculated from the `PillEffect` enum. (There is no `PillEffect.NULL` in the custom enum, so we
 -- do not have to subtract one here.)
 ____exports.NUM_VANILLA_PILL_EFFECTS = getEnumLength(nil, PillEffect)
---- Equal to `PillColor.BLUE_BLUE`.
+--- Equal to `PillColor.BLUE_BLUE` (1).
 ____exports.FIRST_PILL_COLOR = PillColor.BLUE_BLUE
---- Equal to `PillColor.WHITE_YELLOW`.
+--- Equal to `PillColor.WHITE_YELLOW` (13).
 -- 
 -- Note that `PillColor.GOLD` is technically higher, but that is not considered for the purposes of
 -- this constant.
 ____exports.LAST_NORMAL_PILL_COLOR = PillColor.WHITE_YELLOW
---- Equal to `PillColor.HORSE_BLUE_BLUE`.
+--- Equal to `PillColor.HORSE_BLUE_BLUE` (2049).
 ____exports.FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE
---- Equal to `PillColor.HORSE_WHITE_YELLOW`.
+--- Equal to `PillColor.HORSE_WHITE_YELLOW` (2061).
 -- 
 -- Note that `PillColor.HORSE_GOLD` is technically higher, but that is not considered for the
 -- purposes of this constant.
 ____exports.LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW
-____exports.NUM_NORMAL_PILL_COLORS = #iRange(nil, ____exports.FIRST_PILL_COLOR, ____exports.LAST_NORMAL_PILL_COLOR)
---- Equal to `PlayerType.ISAAC`.
+--- Calculated from the difference between the first pill color and the last pill color. This does
+-- not include Gold Pills. In Repentance, this should be equal to 13.
+____exports.NUM_NORMAL_PILL_COLORS = ____exports.LAST_NORMAL_PILL_COLOR - ____exports.FIRST_PILL_COLOR + 1
+--- Equal to `PlayerType.ISAAC` (0).
 ____exports.FIRST_CHARACTER = PlayerType.ISAAC
 --- Calculated from the `PlayerType` enum.
 ____exports.LAST_VANILLA_CHARACTER = getHighestEnumValue(nil, PlayerType)
@@ -53742,6 +53732,8 @@ local iRange = ____utils.iRange
 --- Helper function to get all of the grid indexes between two grid indexes on either a horizontal or
 -- vertical line, inclusive on both ends.
 -- 
+-- If the first grid index is greater than the second grid index, the two will be swapped.
+-- 
 -- This function will throw a run-time error if the two provided grid indexes are not on the same
 -- horizontal or vertical line.
 function ____exports.getGridIndexesBetween(self, gridIndex1, gridIndex2, roomShape)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "83.5.0",
+  "version": "84.0.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -37,6 +37,6 @@
     "lint": "tsx --tsconfig ./scripts/tsconfig.json ./scripts/lint.mts"
   },
   "dependencies": {
-    "isaac-typescript-definitions": "^40.0.1"
+    "isaac-typescript-definitions": "^40.0.2"
   }
 }

package/src/core/constantsFirstLast.ts

@@ -14,13 +14,12 @@ import {
   TrinketType,
 } from "isaac-typescript-definitions";
 import { getEnumLength, getHighestEnumValue } from "../functions/enums";
-import { iRange } from "../functions/utils";
 
 // ------------
 // Collectibles
 // ------------
 
-/** Equal to `CollectibleType.SAD_ONION`. */
+/** Equal to `CollectibleType.SAD_ONION` (1). */
 export const FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION;
 
 /**
@@ -39,7 +38,7 @@ export const NUM_VANILLA_COLLECTIBLE_TYPES = getEnumLength(CollectibleType) - 1;
 // Trinkets
 // --------
 
-/** Equal to `TrinketType.SWALLOWED_PENNY`. */
+/** Equal to `TrinketType.SWALLOWED_PENNY` (1). */
 export const FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY;
 
 /**
@@ -57,7 +56,7 @@ export const NUM_VANILLA_TRINKET_TYPES = getEnumLength(TrinketType) - 1;
 // Cards
 // -----
 
-/** Equal to `Card.FOOL`. */
+/** Equal to `Card.FOOL` (1). */
 export const FIRST_CARD_TYPE = CardType.FOOL;
 
 /** Calculated from the `CardType` enum. */
@@ -70,7 +69,7 @@ export const NUM_VANILLA_CARD_TYPES = getEnumLength(CardType) - 1;
 // Pill Effects
 // ------------
 
-/** Equal to `PillEffect.BAD_GAS`. */
+/** Equal to `PillEffect.BAD_GAS` (0). */
 export const FIRST_PILL_EFFECT = PillEffect.BAD_GAS;
 
 /** Calculated from the `PillEffect` enum. */
@@ -86,38 +85,40 @@ export const NUM_VANILLA_PILL_EFFECTS = getEnumLength(PillEffect);
 // Pill Colors
 // -----------
 
-/** Equal to `PillColor.BLUE_BLUE`. */
+/** Equal to `PillColor.BLUE_BLUE` (1). */
 export const FIRST_PILL_COLOR = PillColor.BLUE_BLUE;
 
 /**
- * Equal to `PillColor.WHITE_YELLOW`.
+ * Equal to `PillColor.WHITE_YELLOW` (13).
  *
  * Note that `PillColor.GOLD` is technically higher, but that is not considered for the purposes of
  * this constant.
  */
 export const LAST_NORMAL_PILL_COLOR = PillColor.WHITE_YELLOW;
 
-/** Equal to `PillColor.HORSE_BLUE_BLUE`. */
+/** Equal to `PillColor.HORSE_BLUE_BLUE` (2049). */
 export const FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE;
 
 /**
- * Equal to `PillColor.HORSE_WHITE_YELLOW`.
+ * Equal to `PillColor.HORSE_WHITE_YELLOW` (2061).
  *
  * Note that `PillColor.HORSE_GOLD` is technically higher, but that is not considered for the
  * purposes of this constant.
  */
 export const LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW;
 
-export const NUM_NORMAL_PILL_COLORS = iRange(
-  FIRST_PILL_COLOR,
-  LAST_NORMAL_PILL_COLOR,
-).length;
+/**
+ * Calculated from the difference between the first pill color and the last pill color. This does
+ * not include Gold Pills. In Repentance, this should be equal to 13.
+ */
+export const NUM_NORMAL_PILL_COLORS =
+  LAST_NORMAL_PILL_COLOR - FIRST_PILL_COLOR + 1;
 
 // -------
 // Players
 // -------
 
-/** Equal to `PlayerType.ISAAC`. */
+/** Equal to `PlayerType.ISAAC` (0). */
 export const FIRST_CHARACTER = PlayerType.ISAAC;
 
 // It is not possible to determine "LAST_PLAYER_TYPE", since there is no associated config.

package/src/functions/gridIndex.ts

@@ -6,6 +6,8 @@ import { iRange } from "./utils";
  * Helper function to get all of the grid indexes between two grid indexes on either a horizontal or
  * vertical line, inclusive on both ends.
  *
+ * If the first grid index is greater than the second grid index, the two will be swapped.
+ *
  * This function will throw a run-time error if the two provided grid indexes are not on the same
  * horizontal or vertical line.
  */

package/src/functions/utils.ts

@@ -45,7 +45,7 @@ export function assertNotNull<T>(
  * end and exclusive on the high end. (The "e" in the function name stands for exclusive.) Thus,
  * this function works in a similar way as the built-in `range` function from Python.
  *
- * If the end is lower than the start, then the range will be reversed.
+ * If the end is lower than the start, an empty array will be returned.
  *
  * For example:
  *
@@ -54,7 +54,6 @@ export function assertNotNull<T>(
  * - `eRange(-3)` returns `[0, -1, -2]`.
  * - `eRange(1, 3)` returns `[1, 2]`.
  * - `eRange(2, 5)` returns `[2, 3, 4]`.
- * - `eRange(5, 2)` returns `[5, 4, 3]`.
  *
  * @param start The integer to start at.
  * @param end Optional. The integer to end at. If not specified, then the start will be 0 and the
@@ -68,14 +67,8 @@ export function eRange(start: int, end?: int, increment = 1): readonly int[] {
 
   const array: int[] = [];
 
-  if (start < end) {
-    for (let i = start; i < end; i += increment) {
-      array.push(i);
-    }
-  } else {
-    for (let i = start; i > end; i -= increment) {
-      array.push(i);
-    }
+  for (let i = start; i < end; i += increment) {
+    array.push(i);
   }
 
   return array;
@@ -102,7 +95,7 @@ export function getTraversalDescription(
  * Helper function to return an array of integers with the specified range, inclusive on both ends.
  * (The "i" in the function name stands for inclusive.)
  *
- * If the end is lower than the start, then the range will be reversed.
+ * If the end is lower than the start, an empty array will be returned.
  *
  * For example:
  *
@@ -123,9 +116,7 @@ export function iRange(start: int, end?: int, increment = 1): readonly int[] {
     return iRange(0, start, increment);
   }
 
-  const rangeIncreasing = start <= end;
-  const exclusiveEnd = rangeIncreasing ? end + 1 : end - 1;
-  return eRange(start, exclusiveEnd, increment);
+  return eRange(start, end + 1, increment);
 }
 
 /**