isaacscript-common 83.4.1 → 84.0.0

package/dist/classes/features/other/EdenStartingStatsHealth.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="isaac-typescript-definitions" />
+import type { CollectibleType } from "isaac-typescript-definitions";
 import type { PlayerStat } from "../../../enums/PlayerStat";
 import type { PlayerHealth } from "../../../interfaces/PlayerHealth";
 import type { PlayerStats } from "../../../interfaces/PlayerStats";
@@ -11,6 +11,34 @@ export declare class EdenStartingStatsHealth extends Feature {
     private readonly postPlayerInit;
     private getEdenStats;
     private getEdenHealth;
+    /**
+     * We must use the `POST_PLAYER_COLLECTIBLE_ADDED` callback since the collectibles are not yet
+     * granted in the `POST_PLAYER_INIT` callback.
+     */
+    private readonly postPlayerCollectibleAdded;
+    /**
+     * Helper function to get the active collectible that Eden started with at the beginning of the
+     * run.
+     *
+     * Returns undefined if passed a player that is not Eden or if the starting collectibles are not
+     * yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback has
+     * fired.)
+     *
+     * @public
+     */
+    getEdenStartingActiveCollectible(player: EntityPlayer): CollectibleType | undefined;
+    /**
+     * Helper function to get an array containing the active collectible and the passive collectible
+     * that Eden started with at the beginning of the run. The active collectible will be the first
+     * element and the passive collectible will be the second element.
+     *
+     * Returns an empty array if passed a player that is not Eden or if the starting collectibles are
+     * not yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback
+     * has fired.)
+     *
+     * @public
+     */
+    getEdenStartingCollectibles(player: EntityPlayer): CollectibleType[];
     /**
      * Helper function to get the health that Eden started with at the beginning of the run before any
      * of the random collectibles were added.
@@ -22,6 +50,17 @@ export declare class EdenStartingStatsHealth extends Feature {
      * @public
      */
     getEdenStartingHealth(player: EntityPlayer): Readonly<PlayerHealth> | undefined;
+    /**
+     * Helper function to get the passive collectible that Eden started with at the beginning of the
+     * run.
+     *
+     * Returns undefined if passed a player that is not Eden or if the starting collectibles are not
+     * yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback has
+     * fired.)
+     *
+     * @public
+     */
+    getEdenStartingPassiveCollectible(player: EntityPlayer): CollectibleType | undefined;
     /**
      * Helper function to get the value of the randomized starting stat for Eden that was assigned at
      * the beginning of the run before any of the random collectibles were added.

package/dist/classes/features/other/EdenStartingStatsHealth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EdenStartingStatsHealth.d.ts","sourceRoot":"","sources":["../../../../src/classes/features/other/EdenStartingStatsHealth.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAQ5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAShD,qBAAa,uBAAwB,SAAQ,OAAO;IAclD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAO7B;IAEF,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IAUrB;;;;;;;;;OASG;IAEI,qBAAqB,CAC1B,MAAM,EAAE,YAAY,GACnB,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS;IAIrC;;;;;;;;;OASG;IAEI,mBAAmB,CAAC,CAAC,SAAS,UAAU,EAC7C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,CAAC,GACZ,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAS7B;;;;;;;;;OASG;IAEI,oBAAoB,CACzB,MAAM,EAAE,YAAY,GACnB,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS;CAGrC"}
+{"version":3,"file":"EdenStartingStatsHealth.d.ts","sourceRoot":"","sources":["../../../../src/classes/features/other/EdenStartingStatsHealth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAU5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAWhD,qBAAa,uBAAwB,SAAQ,OAAO;IAqBlD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAO7B;IAEF,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IAUrB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAezC;IAEF;;;;;;;;;OASG;IAEI,gCAAgC,CACrC,MAAM,EAAE,YAAY,GACnB,eAAe,GAAG,SAAS;IAI9B;;;;;;;;;;OAUG;IAEI,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,EAAE;IAwB3E;;;;;;;;;OASG;IAEI,qBAAqB,CAC1B,MAAM,EAAE,YAAY,GACnB,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS;IAIrC;;;;;;;;;OASG;IAEI,iCAAiC,CACtC,MAAM,EAAE,YAAY,GACnB,eAAe,GAAG,SAAS;IAI9B;;;;;;;;;OASG;IAEI,mBAAmB,CAAC,CAAC,SAAS,UAAU,EAC7C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,CAAC,GACZ,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAS7B;;;;;;;;;OASG;IAEI,oBAAoB,CACzB,MAAM,EAAE,YAAY,GACnB,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS;CAGrC"}

package/dist/classes/features/other/EdenStartingStatsHealth.lua

@@ -9,8 +9,13 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____decorators = require("decorators")
 local Exported = ____decorators.Exported
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____collectibles = require("functions.collectibles")
+local isActiveCollectible = ____collectibles.isActiveCollectible
 local ____playerDataStructures = require("functions.playerDataStructures")
 local mapGetPlayer = ____playerDataStructures.mapGetPlayer
+local mapHasPlayer = ____playerDataStructures.mapHasPlayer
 local mapSetPlayer = ____playerDataStructures.mapSetPlayer
 local ____playerHealth = require("functions.playerHealth")
 local getPlayerHealth = ____playerHealth.getPlayerHealth
@@ -21,6 +26,8 @@ local getPlayerStats = ____stats.getPlayerStats
 local ____Feature = require("classes.private.Feature")
 local Feature = ____Feature.Feature
 local v = {run = {
+    edenActiveCollectibles = __TS__New(Map),
+    edenPassiveCollectibles = __TS__New(Map),
     edenPlayerStats = __TS__New(Map),
     edenPlayerHealth = __TS__New(Map)
 }}
@@ -38,7 +45,17 @@ function EdenStartingStatsHealth.prototype.____constructor(self)
         self:getEdenStats(player)
         self:getEdenHealth(player)
     end
+    self.postPlayerCollectibleAdded = function(____, player, collectibleType)
+        if not isEden(nil, player) then
+            return
+        end
+        local map = isActiveCollectible(nil, collectibleType) and v.run.edenActiveCollectibles or v.run.edenPassiveCollectibles
+        if not mapHasPlayer(nil, map, player) then
+            mapSetPlayer(nil, map, player, collectibleType)
+        end
+    end
     self.callbacksUsed = {{ModCallback.POST_PLAYER_INIT, self.postPlayerInit}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_PLAYER_COLLECTIBLE_ADDED, self.postPlayerCollectibleAdded}}
 end
 function EdenStartingStatsHealth.prototype.getEdenStats(self, player)
     local existingStatMap = mapGetPlayer(nil, v.run.edenPlayerStats, player)
@@ -56,10 +73,31 @@ function EdenStartingStatsHealth.prototype.getEdenHealth(self, player)
     local playerHealth = getPlayerHealth(nil, player)
     mapSetPlayer(nil, v.run.edenPlayerHealth, player, playerHealth)
 end
+function EdenStartingStatsHealth.prototype.getEdenStartingActiveCollectible(self, player)
+    return mapGetPlayer(nil, v.run.edenActiveCollectibles, player)
+end
+__TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingActiveCollectible", true)
+function EdenStartingStatsHealth.prototype.getEdenStartingCollectibles(self, player)
+    local collectibleTypes = {}
+    local activeCollectibleType = mapGetPlayer(nil, v.run.edenActiveCollectibles, player)
+    if activeCollectibleType ~= nil then
+        collectibleTypes[#collectibleTypes + 1] = activeCollectibleType
+    end
+    local passiveCollectibleType = mapGetPlayer(nil, v.run.edenPassiveCollectibles, player)
+    if passiveCollectibleType ~= nil then
+        collectibleTypes[#collectibleTypes + 1] = passiveCollectibleType
+    end
+    return collectibleTypes
+end
+__TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingCollectibles", true)
 function EdenStartingStatsHealth.prototype.getEdenStartingHealth(self, player)
     return mapGetPlayer(nil, v.run.edenPlayerHealth, player)
 end
 __TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingHealth", true)
+function EdenStartingStatsHealth.prototype.getEdenStartingPassiveCollectible(self, player)
+    return mapGetPlayer(nil, v.run.edenPassiveCollectibles, player)
+end
+__TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingPassiveCollectible", true)
 function EdenStartingStatsHealth.prototype.getEdenStartingStat(self, player, playerStat)
     local playerStats = mapGetPlayer(nil, v.run.edenPlayerStats, player)
     if playerStats == nil then

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

@@ -4260,6 +4260,34 @@ declare class EdenStartingStatsHealth extends Feature {
     private readonly postPlayerInit;
     private getEdenStats;
     private getEdenHealth;
+    /**
+     * We must use the `POST_PLAYER_COLLECTIBLE_ADDED` callback since the collectibles are not yet
+     * granted in the `POST_PLAYER_INIT` callback.
+     */
+    private readonly postPlayerCollectibleAdded;
+    /**
+     * Helper function to get the active collectible that Eden started with at the beginning of the
+     * run.
+     *
+     * Returns undefined if passed a player that is not Eden or if the starting collectibles are not
+     * yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback has
+     * fired.)
+     *
+     * @public
+     */
+    getEdenStartingActiveCollectible(player: EntityPlayer): CollectibleType | undefined;
+    /**
+     * Helper function to get an array containing the active collectible and the passive collectible
+     * that Eden started with at the beginning of the run. The active collectible will be the first
+     * element and the passive collectible will be the second element.
+     *
+     * Returns an empty array if passed a player that is not Eden or if the starting collectibles are
+     * not yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback
+     * has fired.)
+     *
+     * @public
+     */
+    getEdenStartingCollectibles(player: EntityPlayer): CollectibleType[];
     /**
      * Helper function to get the health that Eden started with at the beginning of the run before any
      * of the random collectibles were added.
@@ -4271,6 +4299,17 @@ declare class EdenStartingStatsHealth extends Feature {
      * @public
      */
     getEdenStartingHealth(player: EntityPlayer): Readonly<PlayerHealth> | undefined;
+    /**
+     * Helper function to get the passive collectible that Eden started with at the beginning of the
+     * run.
+     *
+     * Returns undefined if passed a player that is not Eden or if the starting collectibles are not
+     * yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback has
+     * fired.)
+     *
+     * @public
+     */
+    getEdenStartingPassiveCollectible(player: EntityPlayer): CollectibleType | undefined;
     /**
      * Helper function to get the value of the randomized starting stat for Eden that was assigned at
      * the beginning of the run before any of the random collectibles were added.
@@ -4348,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:
  *
@@ -4357,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
@@ -4625,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;
 
 /**
@@ -4643,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 {
@@ -6050,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.
  */
@@ -8831,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:
  *
@@ -10606,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.
@@ -10614,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.
@@ -14913,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.0
+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)
@@ -55095,8 +55087,13 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescri
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____decorators = require("decorators")
 local Exported = ____decorators.Exported
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____collectibles = require("functions.collectibles")
+local isActiveCollectible = ____collectibles.isActiveCollectible
 local ____playerDataStructures = require("functions.playerDataStructures")
 local mapGetPlayer = ____playerDataStructures.mapGetPlayer
+local mapHasPlayer = ____playerDataStructures.mapHasPlayer
 local mapSetPlayer = ____playerDataStructures.mapSetPlayer
 local ____playerHealth = require("functions.playerHealth")
 local getPlayerHealth = ____playerHealth.getPlayerHealth
@@ -55107,6 +55104,8 @@ local getPlayerStats = ____stats.getPlayerStats
 local ____Feature = require("classes.private.Feature")
 local Feature = ____Feature.Feature
 local v = {run = {
+    edenActiveCollectibles = __TS__New(Map),
+    edenPassiveCollectibles = __TS__New(Map),
     edenPlayerStats = __TS__New(Map),
     edenPlayerHealth = __TS__New(Map)
 }}
@@ -55124,7 +55123,17 @@ function EdenStartingStatsHealth.prototype.____constructor(self)
         self:getEdenStats(player)
         self:getEdenHealth(player)
     end
+    self.postPlayerCollectibleAdded = function(____, player, collectibleType)
+        if not isEden(nil, player) then
+            return
+        end
+        local map = isActiveCollectible(nil, collectibleType) and v.run.edenActiveCollectibles or v.run.edenPassiveCollectibles
+        if not mapHasPlayer(nil, map, player) then
+            mapSetPlayer(nil, map, player, collectibleType)
+        end
+    end
     self.callbacksUsed = {{ModCallback.POST_PLAYER_INIT, self.postPlayerInit}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_PLAYER_COLLECTIBLE_ADDED, self.postPlayerCollectibleAdded}}
 end
 function EdenStartingStatsHealth.prototype.getEdenStats(self, player)
     local existingStatMap = mapGetPlayer(nil, v.run.edenPlayerStats, player)
@@ -55142,10 +55151,31 @@ function EdenStartingStatsHealth.prototype.getEdenHealth(self, player)
     local playerHealth = getPlayerHealth(nil, player)
     mapSetPlayer(nil, v.run.edenPlayerHealth, player, playerHealth)
 end
+function EdenStartingStatsHealth.prototype.getEdenStartingActiveCollectible(self, player)
+    return mapGetPlayer(nil, v.run.edenActiveCollectibles, player)
+end
+__TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingActiveCollectible", true)
+function EdenStartingStatsHealth.prototype.getEdenStartingCollectibles(self, player)
+    local collectibleTypes = {}
+    local activeCollectibleType = mapGetPlayer(nil, v.run.edenActiveCollectibles, player)
+    if activeCollectibleType ~= nil then
+        collectibleTypes[#collectibleTypes + 1] = activeCollectibleType
+    end
+    local passiveCollectibleType = mapGetPlayer(nil, v.run.edenPassiveCollectibles, player)
+    if passiveCollectibleType ~= nil then
+        collectibleTypes[#collectibleTypes + 1] = passiveCollectibleType
+    end
+    return collectibleTypes
+end
+__TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingCollectibles", true)
 function EdenStartingStatsHealth.prototype.getEdenStartingHealth(self, player)
     return mapGetPlayer(nil, v.run.edenPlayerHealth, player)
 end
 __TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingHealth", true)
+function EdenStartingStatsHealth.prototype.getEdenStartingPassiveCollectible(self, player)
+    return mapGetPlayer(nil, v.run.edenPassiveCollectibles, player)
+end
+__TS__DecorateLegacy({Exported}, EdenStartingStatsHealth.prototype, "getEdenStartingPassiveCollectible", true)
 function EdenStartingStatsHealth.prototype.getEdenStartingStat(self, player, playerStat)
     local playerStats = mapGetPlayer(nil, v.run.edenPlayerStats, player)
     if playerStats == nil then

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.38.4"
+      "packageVersion": "7.38.5"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "83.4.1",
+  "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/classes/features/other/EdenStartingStatsHealth.ts

@@ -1,8 +1,12 @@
+import type { CollectibleType } from "isaac-typescript-definitions";
 import { ModCallback } from "isaac-typescript-definitions";
 import { Exported } from "../../../decorators";
+import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
 import type { PlayerStat } from "../../../enums/PlayerStat";
+import { isActiveCollectible } from "../../../functions/collectibles";
 import {
   mapGetPlayer,
+  mapHasPlayer,
   mapSetPlayer,
 } from "../../../functions/playerDataStructures";
 import { getPlayerHealth } from "../../../functions/playerHealth";
@@ -15,6 +19,8 @@ import { Feature } from "../../private/Feature";
 
 const v = {
   run: {
+    edenActiveCollectibles: new Map<PlayerIndex, CollectibleType>(),
+    edenPassiveCollectibles: new Map<PlayerIndex, CollectibleType>(),
     edenPlayerStats: new Map<PlayerIndex, PlayerStats>(),
     edenPlayerHealth: new Map<PlayerIndex, PlayerHealth>(),
   },
@@ -32,6 +38,13 @@ export class EdenStartingStatsHealth extends Feature {
       // 9
       [ModCallback.POST_PLAYER_INIT, this.postPlayerInit],
     ];
+
+    this.customCallbacksUsed = [
+      [
+        ModCallbackCustom.POST_PLAYER_COLLECTIBLE_ADDED,
+        this.postPlayerCollectibleAdded,
+      ],
+    ];
   }
 
   /**
@@ -67,6 +80,80 @@ export class EdenStartingStatsHealth extends Feature {
     mapSetPlayer(v.run.edenPlayerHealth, player, playerHealth);
   }
 
+  /**
+   * We must use the `POST_PLAYER_COLLECTIBLE_ADDED` callback since the collectibles are not yet
+   * granted in the `POST_PLAYER_INIT` callback.
+   */
+  private readonly postPlayerCollectibleAdded = (
+    player: EntityPlayer,
+    collectibleType: CollectibleType,
+  ): void => {
+    if (!isEden(player)) {
+      return;
+    }
+
+    const map = isActiveCollectible(collectibleType)
+      ? v.run.edenActiveCollectibles
+      : v.run.edenPassiveCollectibles;
+
+    if (!mapHasPlayer(map, player)) {
+      mapSetPlayer(map, player, collectibleType);
+    }
+  };
+
+  /**
+   * Helper function to get the active collectible that Eden started with at the beginning of the
+   * run.
+   *
+   * Returns undefined if passed a player that is not Eden or if the starting collectibles are not
+   * yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback has
+   * fired.)
+   *
+   * @public
+   */
+  @Exported
+  public getEdenStartingActiveCollectible(
+    player: EntityPlayer,
+  ): CollectibleType | undefined {
+    return mapGetPlayer(v.run.edenActiveCollectibles, player);
+  }
+
+  /**
+   * Helper function to get an array containing the active collectible and the passive collectible
+   * that Eden started with at the beginning of the run. The active collectible will be the first
+   * element and the passive collectible will be the second element.
+   *
+   * Returns an empty array if passed a player that is not Eden or if the starting collectibles are
+   * not yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback
+   * has fired.)
+   *
+   * @public
+   */
+  @Exported
+  public getEdenStartingCollectibles(player: EntityPlayer): CollectibleType[] {
+    const collectibleTypes: CollectibleType[] = [];
+
+    const activeCollectibleType = mapGetPlayer(
+      v.run.edenActiveCollectibles,
+      player,
+    );
+
+    if (activeCollectibleType !== undefined) {
+      collectibleTypes.push(activeCollectibleType);
+    }
+
+    const passiveCollectibleType = mapGetPlayer(
+      v.run.edenPassiveCollectibles,
+      player,
+    );
+
+    if (passiveCollectibleType !== undefined) {
+      collectibleTypes.push(passiveCollectibleType);
+    }
+
+    return collectibleTypes;
+  }
+
   /**
    * Helper function to get the health that Eden started with at the beginning of the run before any
    * of the random collectibles were added.
@@ -84,6 +171,23 @@ export class EdenStartingStatsHealth extends Feature {
     return mapGetPlayer(v.run.edenPlayerHealth, player);
   }
 
+  /**
+   * Helper function to get the passive collectible that Eden started with at the beginning of the
+   * run.
+   *
+   * Returns undefined if passed a player that is not Eden or if the starting collectibles are not
+   * yet added. (Eden's starting collectibles are added after the `POST_PLAYER_INIT` callback has
+   * fired.)
+   *
+   * @public
+   */
+  @Exported
+  public getEdenStartingPassiveCollectible(
+    player: EntityPlayer,
+  ): CollectibleType | undefined {
+    return mapGetPlayer(v.run.edenPassiveCollectibles, player);
+  }
+
   /**
    * Helper function to get the value of the randomized starting stat for Eden that was assigned at
    * the beginning of the run before any of the random collectibles were added.

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);
 }
 
 /**