isaacscript-common 7.17.4 → 8.0.0

package/dist/functions/collectibleSet.d.ts

@@ -5,6 +5,9 @@ import { CollectibleType } from "isaac-typescript-definitions";
  *
  * Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
  * then use the `getCollectibleSet` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all collectibles will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getCollectibleArray(): readonly CollectibleType[];
 /**
@@ -12,6 +15,9 @@ export declare function getCollectibleArray(): readonly CollectibleType[];
  *
  * Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
  * then use the `getCollectibleArray` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all collectibles will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getCollectibleSet(): ReadonlySet<CollectibleType>;
 /**
@@ -19,6 +25,9 @@ export declare function getCollectibleSet(): ReadonlySet<CollectibleType>;
  *
  * Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
  * then use the `getModdedCollectibleSet` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all collectibles will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getModdedCollectibleArray(): readonly CollectibleType[];
 /**
@@ -26,6 +35,9 @@ export declare function getModdedCollectibleArray(): readonly CollectibleType[];
  *
  * Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
  * then use the `getModdedCollectibleArray` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all collectibles will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getModdedCollectibleSet(): ReadonlySet<CollectibleType>;
 /**
@@ -33,6 +45,9 @@ export declare function getModdedCollectibleSet(): ReadonlySet<CollectibleType>;
  *
  * Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
  * then use the `getVanillaCollectibleSet` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all collectibles will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getVanillaCollectibleArray(): readonly CollectibleType[];
 /**
@@ -40,6 +55,9 @@ export declare function getVanillaCollectibleArray(): readonly CollectibleType[]
  *
  * Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
  * then use the `getVanillaCollectibleArray` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all collectibles will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getVanillaCollectibleSet(): ReadonlySet<CollectibleType>;
 //# sourceMappingURL=collectibleSet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"collectibleSet.d.ts","sourceRoot":"","sources":["../../src/functions/collectibleSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAwD/D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,eAAe,EAAE,CAKhE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,eAAe,CAAC,CAKhE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,SAAS,eAAe,EAAE,CAKtE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAAC,eAAe,CAAC,CAKtE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,SAAS,eAAe,EAAE,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAAC,eAAe,CAAC,CAKvE"}
+{"version":3,"file":"collectibleSet.d.ts","sourceRoot":"","sources":["../../src/functions/collectibleSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAyD/D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,eAAe,EAAE,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,eAAe,CAAC,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,IAAI,SAAS,eAAe,EAAE,CAGtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAAC,eAAe,CAAC,CAGtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,IAAI,SAAS,eAAe,EAAE,CAGvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAAC,eAAe,CAAC,CAGvE"}

package/dist/functions/collectibleSet.lua

@@ -7,8 +7,9 @@ local ____cachedClasses = require("core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constantsFirstLast = require("core.constantsFirstLast")
 local FIRST_COLLECTIBLE_TYPE = ____constantsFirstLast.FIRST_COLLECTIBLE_TYPE
-local LAST_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_COLLECTIBLE_TYPE
 local LAST_VANILLA_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_VANILLA_COLLECTIBLE_TYPE
+local ____firstLast = require("features.firstLast")
+local getLastCollectibleType = ____firstLast.getLastCollectibleType
 local ____utils = require("functions.utils")
 local irange = ____utils.irange
 local ALL_COLLECTIBLES_ARRAY = {}
@@ -17,11 +18,12 @@ local MODDED_COLLECTIBLES_ARRAY = {}
 local ALL_COLLECTIBLES_SET = __TS__New(Set)
 local VANILLA_COLLECTIBLES_SET = __TS__New(Set)
 local MODDED_COLLECTIBLES_SET = __TS__New(Set)
-local function initCollectibleArraysAndSets(self)
+local function lazyInitCollectibleArraysAndSets(self)
     if #ALL_COLLECTIBLES_ARRAY ~= 0 then
         return
     end
-    local collectibleTypeRange = irange(nil, FIRST_COLLECTIBLE_TYPE, LAST_COLLECTIBLE_TYPE)
+    local lastCollectibleType = getLastCollectibleType(nil)
+    local collectibleTypeRange = irange(nil, FIRST_COLLECTIBLE_TYPE, lastCollectibleType)
     for ____, collectibleType in ipairs(collectibleTypeRange) do
         do
             local itemConfigItem = itemConfig:GetCollectible(collectibleType)
@@ -55,48 +57,66 @@ end
 -- 
 -- Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
 -- then use the `getCollectibleSet` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getCollectibleArray(self)
-    initCollectibleArraysAndSets(nil)
+    lazyInitCollectibleArraysAndSets(nil)
     return ALL_COLLECTIBLES_ARRAY
 end
 --- Returns a set containing every valid collectible type in the game, including modded collectibles.
 -- 
 -- Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
 -- then use the `getCollectibleArray` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getCollectibleSet(self)
-    initCollectibleArraysAndSets(nil)
+    lazyInitCollectibleArraysAndSets(nil)
     return ALL_COLLECTIBLES_SET
 end
 --- Returns an array containing every modded collectible type in the game.
 -- 
 -- Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
 -- then use the `getModdedCollectibleSet` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getModdedCollectibleArray(self)
-    initCollectibleArraysAndSets(nil)
+    lazyInitCollectibleArraysAndSets(nil)
     return MODDED_COLLECTIBLES_ARRAY
 end
 --- Returns a set containing every modded collectible type in the game.
 -- 
 -- Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
 -- then use the `getModdedCollectibleArray` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getModdedCollectibleSet(self)
-    initCollectibleArraysAndSets(nil)
+    lazyInitCollectibleArraysAndSets(nil)
     return MODDED_COLLECTIBLES_SET
 end
 --- Returns an array containing every valid vanilla collectible type in the game.
 -- 
 -- Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
 -- then use the `getVanillaCollectibleSet` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getVanillaCollectibleArray(self)
-    initCollectibleArraysAndSets(nil)
+    lazyInitCollectibleArraysAndSets(nil)
     return VANILLA_COLLECTIBLES_ARRAY
 end
 --- Returns a set containing every valid vanilla collectible type in the game.
 -- 
 -- Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
 -- then use the `getVanillaCollectibleArray` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getVanillaCollectibleSet(self)
-    initCollectibleArraysAndSets(nil)
+    lazyInitCollectibleArraysAndSets(nil)
     return VANILLA_COLLECTIBLES_SET
 end
 return ____exports

package/dist/functions/collectibles.d.ts

@@ -123,19 +123,6 @@ export declare function getCollectibleQuality(collectibleType: CollectibleType):
  * ```
  */
 export declare function getCollectibleTags(collectibleType: CollectibleType): BitFlags<ItemConfigTag>;
-/**
- * Helper function to get an array that represents the all modded collectible types.
- *
- * This function is only useful when building collectible type objects. For most purposes, you
- * should use the `getModdedCollectibleSet` helper function instead.
- *
- * Returns an empty array if there are no modded collectible types.
- *
- * (This function is named differently from the `getVanillaCollectibleTypeRange` function because
- * all modded collectible types are contiguous. Thus, each value represents a real
- * `CollectibleType`.)
- */
-export declare function getModdedCollectibleTypes(): CollectibleType[];
 /**
  * Helper function to get an array that represents the range from the first collectible type to the
  * last vanilla collectible type. This will include integers that do not represent any valid

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

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

package/dist/functions/collectibles.lua

@@ -16,8 +16,6 @@ local BLIND_ITEM_PNG_PATH = ____constants.BLIND_ITEM_PNG_PATH
 local DEFAULT_ITEM_POOL_TYPE = ____constants.DEFAULT_ITEM_POOL_TYPE
 local ____constantsFirstLast = require("core.constantsFirstLast")
 local FIRST_COLLECTIBLE_TYPE = ____constantsFirstLast.FIRST_COLLECTIBLE_TYPE
-local FIRST_MODDED_COLLECTIBLE_TYPE = ____constantsFirstLast.FIRST_MODDED_COLLECTIBLE_TYPE
-local LAST_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_COLLECTIBLE_TYPE
 local LAST_VANILLA_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_VANILLA_COLLECTIBLE_TYPE
 local ____collectibleDescriptionMap = require("maps.collectibleDescriptionMap")
 local COLLECTIBLE_DESCRIPTION_MAP = ____collectibleDescriptionMap.COLLECTIBLE_DESCRIPTION_MAP
@@ -326,22 +324,6 @@ function ____exports.getCollectibleTags(self, collectibleType)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     return itemConfigItem == nil and ItemConfigTagZero or itemConfigItem.Tags
 end
---- Helper function to get an array that represents the all modded collectible types.
--- 
--- This function is only useful when building collectible type objects. For most purposes, you
--- should use the `getModdedCollectibleSet` helper function instead.
--- 
--- Returns an empty array if there are no modded collectible types.
--- 
--- (This function is named differently from the `getVanillaCollectibleTypeRange` function because
--- all modded collectible types are contiguous. Thus, each value represents a real
--- `CollectibleType`.)
-function ____exports.getModdedCollectibleTypes(self)
-    if LAST_VANILLA_COLLECTIBLE_TYPE == LAST_COLLECTIBLE_TYPE then
-        return {}
-    end
-    return irange(nil, FIRST_MODDED_COLLECTIBLE_TYPE, LAST_COLLECTIBLE_TYPE)
-end
 --- Helper function to get an array that represents the range from the first collectible type to the
 -- last vanilla collectible type. This will include integers that do not represent any valid
 -- collectible types.

package/dist/functions/flying.lua

@@ -9,8 +9,8 @@ local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
-local ____cacheFlag = require("functions.cacheFlag")
-local getCollectiblesForCacheFlag = ____cacheFlag.getCollectiblesForCacheFlag
+local ____collectibleCacheFlag = require("functions.collectibleCacheFlag")
+local getCollectiblesForCacheFlag = ____collectibleCacheFlag.getCollectiblesForCacheFlag
 local ____set = require("functions.set")
 local copySet = ____set.copySet
 local deleteSetsFromSet = ____set.deleteSetsFromSet

package/dist/functions/pills.d.ts

@@ -4,10 +4,6 @@ import { ItemConfigPillEffectClass, ItemConfigPillEffectType, PillColor, PillEff
  * all horse colors.
  */
 export declare function getAllPillColors(): PillColor[];
-/**
- * Helper function to get an array with every valid pill effect. This includes modded pill effects.
- */
-export declare function getAllPillEffects(): PillEffect[];
 /**
  * Helper function to get the associated pill effect after False PHD is acquired. If a pill effect
  * is not altered by False PHD, then the same pill effect will be returned.
@@ -22,12 +18,6 @@ export declare function getFalsePHDPillEffect(pillEffect: PillEffect): PillEffec
 export declare function getHorsePillColor(pillColor: PillColor): PillColor;
 /** Helper function to get an array with every non-gold horse pill color. */
 export declare function getHorsePillColors(): PillColor[];
-/**
- * Helper function to get an array with every modded pill effect.
- *
- * Returns an empty array if there are no modded pill effects.
- */
-export declare function getModdedPillEffects(): PillEffect[];
 /**
  * Helper function to get the corresponding normal pill color from a horse pill color.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"pills.d.ts","sourceRoot":"","sources":["../../src/functions/pills.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,SAAS,EACT,UAAU,EACX,MAAM,8BAA8B,CAAC;AAuCtC;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAI9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAEhD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAEjE;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,SAAS,EAAE,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,EAAE,CAMnD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAM3E;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,SAAS,EAAE,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAGnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,GACrB,yBAAyB,CAS3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAgBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GACrB,wBAAwB,CAS1B;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,IAAI,UAAU,EAAE,CAEpD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"pills.d.ts","sourceRoot":"","sources":["../../src/functions/pills.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,SAAS,EACT,UAAU,EACX,MAAM,8BAA8B,CAAC;AAqCtC;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAI9C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAEjE;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,SAAS,EAAE,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAM3E;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,SAAS,EAAE,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAGnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,GACrB,yBAAyB,CAS3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAgBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GACrB,wBAAwB,CAS1B;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,IAAI,UAAU,EAAE,CAEpD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAEzD"}

package/dist/functions/pills.lua

@@ -7,12 +7,10 @@ local ____cachedClasses = require("core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constantsFirstLast = require("core.constantsFirstLast")
 local FIRST_HORSE_PILL_COLOR = ____constantsFirstLast.FIRST_HORSE_PILL_COLOR
-local FIRST_MODDED_PILL_EFFECT = ____constantsFirstLast.FIRST_MODDED_PILL_EFFECT
 local FIRST_PILL_COLOR = ____constantsFirstLast.FIRST_PILL_COLOR
 local FIRST_PILL_EFFECT = ____constantsFirstLast.FIRST_PILL_EFFECT
 local LAST_HORSE_PILL_COLOR = ____constantsFirstLast.LAST_HORSE_PILL_COLOR
 local LAST_NORMAL_PILL_COLOR = ____constantsFirstLast.LAST_NORMAL_PILL_COLOR
-local LAST_PILL_EFFECT = ____constantsFirstLast.LAST_PILL_EFFECT
 local LAST_VANILLA_PILL_EFFECT = ____constantsFirstLast.LAST_VANILLA_PILL_EFFECT
 local ____falsePHDPillConversions = require("maps.falsePHDPillConversions")
 local FALSE_PHD_PILL_CONVERSIONS = ____falsePHDPillConversions.FALSE_PHD_PILL_CONVERSIONS
@@ -47,10 +45,6 @@ function ____exports.getAllPillColors(self)
     __TS__ArraySlice(pillColors)
     return pillColors
 end
---- Helper function to get an array with every valid pill effect. This includes modded pill effects.
-function ____exports.getAllPillEffects(self)
-    return irange(nil, FIRST_PILL_EFFECT, LAST_PILL_EFFECT)
-end
 --- Helper function to get the associated pill effect after False PHD is acquired. If a pill effect
 -- is not altered by False PHD, then the same pill effect will be returned.
 function ____exports.getFalsePHDPillEffect(self, pillEffect)
@@ -68,15 +62,6 @@ end
 function ____exports.getHorsePillColors(self)
     return irange(nil, FIRST_HORSE_PILL_COLOR, LAST_HORSE_PILL_COLOR)
 end
---- Helper function to get an array with every modded pill effect.
--- 
--- Returns an empty array if there are no modded pill effects.
-function ____exports.getModdedPillEffects(self)
-    if LAST_VANILLA_PILL_EFFECT == LAST_PILL_EFFECT then
-        return {}
-    end
-    return irange(nil, FIRST_MODDED_PILL_EFFECT, LAST_PILL_EFFECT)
-end
 --- Helper function to get the corresponding normal pill color from a horse pill color.
 -- 
 -- For example, passing 2049 would result in `PillColor.BLUE_BLUE`.

package/dist/functions/players.lua

@@ -304,7 +304,7 @@ function ____exports.getAzazelBrimstoneDistance(self, playerOrTearHeight)
     return 32 - 2.5 * tearHeight
 end
 function ____exports.getClosestPlayer(self, position)
-    local closestPlayer = nil
+    local closestPlayer
     local closestDistance = math.huge
     for ____, player in ipairs(getPlayers(nil)) do
         local distance = position:Distance(player.Position)

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

@@ -1 +1 @@
-{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/functions/random.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,GAAE,IAAI,GAAG,GAAqB,GAAG,KAAK,CAGxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,KAAK,CAUP;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,GAAG,EAAE,GAAG,SAAS,GAAG,EAAO,GACtC,GAAG,CAkBL"}
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/functions/random.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,GAAE,IAAI,GAAG,GAAqB,GAAG,KAAK,CAGxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,KAAK,CAUP;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,GAAG,EAAE,GAAG,SAAS,GAAG,EAAO,GACtC,GAAG,CAqBL"}

package/dist/functions/random.lua

@@ -69,6 +69,8 @@ function ____exports.getRandomInt(self, min, max, seedOrRNG, exceptions)
         exceptions = {}
     end
     local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
+    min = math.ceil(min)
+    max = math.floor(max)
     if min > max then
         local oldMin = min
         local oldMax = max

package/dist/functions/run.d.ts

@@ -1,4 +1,9 @@
 import { PlayerType } from "isaac-typescript-definitions";
+/**
+ * Helper function to see if the current run can unlock achievements. For example, if playing on a
+ * set seed or in a victory lap, achievements are disabled.
+ */
+export declare function canRunUnlockAchievements(): boolean;
 /**
  * Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
  * pressing tab on the character selection screen). When the player resets the game on a set seed,

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAMrE;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAiBpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAQtC;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAiBpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/functions/run.lua

@@ -2,14 +2,27 @@ local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local SlotVariant = ____isaac_2Dtypescript_2Ddefinitions.SlotVariant
 local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
+local ____constants = require("core.constants")
+local VectorZero = ____constants.VectorZero
 local ____constantsFirstLast = require("core.constantsFirstLast")
 local FIRST_CHARACTER = ____constantsFirstLast.FIRST_CHARACTER
 local ____runInNFrames = require("features.runInNFrames")
 local runNextRenderFrame = ____runInNFrames.runNextRenderFrame
+local ____entitiesSpecific = require("functions.entitiesSpecific")
+local spawnSlot = ____entitiesSpecific.spawnSlot
 local ____log = require("functions.log")
 local log = ____log.log
+--- Helper function to see if the current run can unlock achievements. For example, if playing on a
+-- set seed or in a victory lap, achievements are disabled.
+function ____exports.canRunUnlockAchievements(self)
+    local greedDonationMachine = spawnSlot(nil, SlotVariant.GREED_DONATION_MACHINE, 0, VectorZero)
+    local canUnlockAchievements = greedDonationMachine:Exists()
+    greedDonationMachine:Remove()
+    return canUnlockAchievements
+end
 --- Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
 -- pressing tab on the character selection screen). When the player resets the game on a set seed,
 -- the game will not switch to a different seed.

package/dist/functions/stats.d.ts

@@ -0,0 +1,9 @@
+import { CacheFlag } from "isaac-typescript-definitions";
+/**
+ * Returns the starting stat that Isaac (the default character) starts with. For example, if you
+ * pass this function `CacheFlag.DAMAGE`, it will return 3.5.
+ *
+ * Note that the default fire delay is represented in the tear stat, not the `MaxFireDelay` value.
+ */
+export declare function getDefaultPlayerStat(cacheFlag: CacheFlag): number | undefined;
+//# sourceMappingURL=stats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/functions/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7E"}

package/dist/functions/stats.lua

@@ -0,0 +1,11 @@
+local ____exports = {}
+local ____defaultPlayerStatMap = require("maps.defaultPlayerStatMap")
+local DEFAULT_PLAYER_STAT_MAP = ____defaultPlayerStatMap.DEFAULT_PLAYER_STAT_MAP
+--- Returns the starting stat that Isaac (the default character) starts with. For example, if you
+-- pass this function `CacheFlag.DAMAGE`, it will return 3.5.
+-- 
+-- Note that the default fire delay is represented in the tear stat, not the `MaxFireDelay` value.
+function ____exports.getDefaultPlayerStat(self, cacheFlag)
+    return DEFAULT_PLAYER_STAT_MAP:get(cacheFlag)
+end
+return ____exports

package/dist/functions/trinketCacheFlag.d.ts

@@ -1,11 +1,19 @@
 import { CacheFlag, TrinketType } from "isaac-typescript-definitions";
 /**
  * Returns a map containing every trinket type that the player has that matches the provided
- * CacheFlag. The values of the map correspond to the multiplier for that trinket.
+ * `CacheFlag`. The values of the map correspond to the multiplier for that trinket.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getPlayerTrinketsForCacheFlag(player: EntityPlayer, cacheFlag: CacheFlag): Map<TrinketType, int>;
 /**
  * Returns a set containing every trinket type with the given cache flag, including modded trinkets.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getTrinketsForCacheFlag(cacheFlag: CacheFlag): Set<TrinketType>;
+/** Helper function to check in the item config if a given trinket has a given cache flag. */
+export declare function trinketHasCacheFlag(trinketType: TrinketType, cacheFlag: CacheFlag): boolean;
 //# sourceMappingURL=trinketCacheFlag.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"trinketCacheFlag.d.ts","sourceRoot":"","sources":["../../src/functions/trinketCacheFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAqBtE;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAYvB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,CAAC,CAYlB"}
+{"version":3,"file":"trinketCacheFlag.d.ts","sourceRoot":"","sources":["../../src/functions/trinketCacheFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA2BtE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAYvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,CAAC,CASlB;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT"}

package/dist/functions/trinketCacheFlag.lua

@@ -4,21 +4,27 @@ local __TS__New = ____lualib.__TS__New
 local Set = ____lualib.Set
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
-local initCacheFlagMap, CACHE_FLAG_TO_TRINKETS_MAP
+local lazyInitCacheFlagMap, CACHE_FLAG_TO_TRINKETS_MAP
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
+local ____cachedClasses = require("core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____firstLast = require("features.firstLast")
+local getTrinketTypes = ____firstLast.getTrinketTypes
 local ____enums = require("functions.enums")
 local getEnumValues = ____enums.getEnumValues
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
 local ____set = require("functions.set")
 local copySet = ____set.copySet
-local ____trinkets = require("functions.trinkets")
-local getTrinketTypes = ____trinkets.getTrinketTypes
-local trinketHasCacheFlag = ____trinkets.trinketHasCacheFlag
-function initCacheFlagMap(self)
+function lazyInitCacheFlagMap(self)
+    if CACHE_FLAG_TO_TRINKETS_MAP.size > 0 then
+        return
+    end
     for ____, cacheFlag in ipairs(getEnumValues(nil, CacheFlag)) do
         local trinketsSet = __TS__New(Set)
         for ____, trinketType in ipairs(getTrinketTypes(nil)) do
-            if trinketHasCacheFlag(nil, trinketType, cacheFlag) then
+            if ____exports.trinketHasCacheFlag(nil, trinketType, cacheFlag) then
                 trinketsSet:add(trinketType)
             end
         end
@@ -26,19 +32,31 @@ function initCacheFlagMap(self)
     end
 end
 --- Returns a set containing every trinket type with the given cache flag, including modded trinkets.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all trinkets will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getTrinketsForCacheFlag(self, cacheFlag)
-    if CACHE_FLAG_TO_TRINKETS_MAP.size == 0 then
-        initCacheFlagMap(nil)
-    end
+    lazyInitCacheFlagMap(nil)
     local trinketsSet = CACHE_FLAG_TO_TRINKETS_MAP:get(cacheFlag)
     if trinketsSet == nil then
         return __TS__New(Set)
     end
     return copySet(nil, trinketsSet)
 end
+--- Helper function to check in the item config if a given trinket has a given cache flag.
+function ____exports.trinketHasCacheFlag(self, trinketType, cacheFlag)
+    local itemConfigItem = itemConfig:GetTrinket(trinketType)
+    if itemConfigItem == nil then
+        return false
+    end
+    return hasFlag(nil, itemConfigItem.CacheFlags, cacheFlag)
+end
 CACHE_FLAG_TO_TRINKETS_MAP = __TS__New(Map)
 --- Returns a map containing every trinket type that the player has that matches the provided
--- CacheFlag. The values of the map correspond to the multiplier for that trinket.
+-- `CacheFlag`. The values of the map correspond to the multiplier for that trinket.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all trinkets will necessarily be present when a mod first loads (due to mod load order).
 function ____exports.getPlayerTrinketsForCacheFlag(self, player, cacheFlag)
     local trinketsForCacheFlag = ____exports.getTrinketsForCacheFlag(nil, cacheFlag)
     local playerTrinkets = __TS__New(Map)

package/dist/functions/trinketSet.d.ts

@@ -4,6 +4,9 @@ import { TrinketType } from "isaac-typescript-definitions";
  *
  * Use this if you need to iterate over the trinkets in order. If you need to do O(1) lookups, then
  * use the `getTrinketSet` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getModdedTrinketArray(): readonly TrinketType[];
 /**
@@ -11,6 +14,9 @@ export declare function getModdedTrinketArray(): readonly TrinketType[];
  *
  * Use this if you need to do O(1) lookups. If you need to iterate over the trinkets in order, then
  * use the `getTrinketArray` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getModdedTrinketSet(): ReadonlySet<TrinketType>;
 /**
@@ -18,6 +24,9 @@ export declare function getModdedTrinketSet(): ReadonlySet<TrinketType>;
  *
  * Use this if you need to iterate over the trinkets in order. If you need to do O(1) lookups, then
  * use the `getModdedTrinketSet` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getTrinketArray(): readonly TrinketType[];
 /**
@@ -25,6 +34,9 @@ export declare function getTrinketArray(): readonly TrinketType[];
  *
  * Use this if you need to do O(1) lookups. If you need to iterate over the trinkets in order, then
  * use the `getModdedTrinketArray` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getTrinketSet(): ReadonlySet<TrinketType>;
 /**
@@ -32,6 +44,9 @@ export declare function getTrinketSet(): ReadonlySet<TrinketType>;
  *
  * Use this if you need to iterate over the trinkets in order. If you need to do O(1) lookups, then
  * use the `getVanillaTrinketSet` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getVanillaTrinketArray(): readonly TrinketType[];
 /**
@@ -39,6 +54,9 @@ export declare function getVanillaTrinketArray(): readonly TrinketType[];
  *
  * Use this if you need to do O(1) lookups. If you need to iterate over the trinkets in order, then
  * use the `getVanillaTrinketArray` helper function instead.
+ *
+ * This function can only be called if at least one callback has been executed. This is because not
+ * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
 export declare function getVanillaTrinketSet(): ReadonlySet<TrinketType>;
 //# sourceMappingURL=trinketSet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"trinketSet.d.ts","sourceRoot":"","sources":["../../src/functions/trinketSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAwD3D;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,WAAW,EAAE,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,WAAW,CAAC,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,SAAS,WAAW,EAAE,CAKxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAAC,WAAW,CAAC,CAKxD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,WAAW,EAAE,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAAC,WAAW,CAAC,CAK/D"}
+{"version":3,"file":"trinketSet.d.ts","sourceRoot":"","sources":["../../src/functions/trinketSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAyD3D;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,WAAW,EAAE,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,WAAW,CAAC,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,SAAS,WAAW,EAAE,CAGxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAAC,WAAW,CAAC,CAGxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,WAAW,EAAE,CAG/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAAC,WAAW,CAAC,CAG/D"}