isaacscript-common 7.17.4 → 8.0.0

package/dist/features/firstLast.lua

@@ -0,0 +1,341 @@
+local ____exports = {}
+local postNewRoomEarly, errorIfNoCallbacksFired, FEATURE_NAME, atLeastOneCallbackFired
+local ____cachedClasses = require("core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____constantsFirstLast = require("core.constantsFirstLast")
+local FIRST_CARD = ____constantsFirstLast.FIRST_CARD
+local FIRST_PILL_EFFECT = ____constantsFirstLast.FIRST_PILL_EFFECT
+local FIRST_TRINKET_TYPE = ____constantsFirstLast.FIRST_TRINKET_TYPE
+local LAST_VANILLA_CARD = ____constantsFirstLast.LAST_VANILLA_CARD
+local LAST_VANILLA_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_VANILLA_COLLECTIBLE_TYPE
+local LAST_VANILLA_PILL_EFFECT = ____constantsFirstLast.LAST_VANILLA_PILL_EFFECT
+local LAST_VANILLA_TRINKET_TYPE = ____constantsFirstLast.LAST_VANILLA_TRINKET_TYPE
+local NUM_VANILLA_CARDS = ____constantsFirstLast.NUM_VANILLA_CARDS
+local NUM_VANILLA_COLLECTIBLE_TYPES = ____constantsFirstLast.NUM_VANILLA_COLLECTIBLE_TYPES
+local NUM_VANILLA_PILL_EFFECTS = ____constantsFirstLast.NUM_VANILLA_PILL_EFFECTS
+local NUM_VANILLA_TRINKET_TYPES = ____constantsFirstLast.NUM_VANILLA_TRINKET_TYPES
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____types = require("functions.types")
+local asCard = ____types.asCard
+local asCollectibleType = ____types.asCollectibleType
+local asNumber = ____types.asNumber
+local asPillEffect = ____types.asPillEffect
+local asTrinketType = ____types.asTrinketType
+local ____utils = require("functions.utils")
+local irange = ____utils.irange
+function postNewRoomEarly(self)
+    atLeastOneCallbackFired = true
+end
+function errorIfNoCallbacksFired(self, constantType)
+    if not atLeastOneCallbackFired then
+        error(("Failed to retrieve a " .. constantType) .. " constant. Since not all mods have been loaded yet, any constants of this type will be inaccurate. Thus, you must wait until at least one callback fires before retrieving these types of constants.")
+    end
+end
+--- Will change depending on how many modded collectibles there are.
+-- 
+-- Equal to `itemConfig.GetCollectibles().Size - 1`. (`Size` includes invalid collectibles, like
+-- 666. We subtract one to account for `CollectibleType.NULL`.)
+-- 
+-- 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.getLastCollectibleType(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "collectible")
+    return itemConfig:GetCollectibles().Size - 1
+end
+--- Unlike vanilla collectible types, modded collectible types are always contiguous.
+-- 
+-- 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.getNumModdedCollectibleTypes(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "collectible")
+    local lastCollectibleType = ____exports.getLastCollectibleType(nil)
+    return lastCollectibleType - LAST_VANILLA_COLLECTIBLE_TYPE
+end
+--- Will change depending on how many modded cards there are.
+-- 
+-- Equal to `itemConfig.GetTrinkets().Size - 1`. (We subtract one to account for
+-- `TrinketType.NULL`.)
+-- 
+-- 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.getNumTrinketTypes(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "trinket")
+    return itemConfig:GetTrinkets().Size - 1
+end
+--- Will change depending on how many modded cards there are.
+-- 
+-- This is equal to the number of cards, since all card sub-types are contiguous (unlike
+-- collectibles).
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all cards will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getLastCard(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "card")
+    local numCards = ____exports.getNumCards(nil)
+    return asCard(nil, numCards)
+end
+--- Will change depending on how many modded cards there are.
+-- 
+-- Equal to `itemConfig.GetCards().Size - 1`. (We subtract one to account for `Card.NULL`.)
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all cards will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getNumCards(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "card")
+    return itemConfig:GetCards().Size - 1
+end
+--- Will change depending on how many modded pill effects there are.
+-- 
+-- This is equal to the number of pill effects, since all pill effects are contiguous (unlike
+-- collectibles).
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all pill effects will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getLastPillEffect(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "pill")
+    local numPillEffects = ____exports.getNumPillEffects(nil)
+    return asPillEffect(nil, numPillEffects)
+end
+--- Will change depending on how many modded pill effects there are.
+-- 
+-- Equal to `itemConfig.GetPillEffects().Size`. (We do not have to subtract one, because the first
+-- pill effect has an ID of 0 and there is no `PillEffect.NULL`.)
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all pill effects will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getNumPillEffects(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "pill")
+    return itemConfig:GetPillEffects().Size
+end
+FEATURE_NAME = "firstLast"
+atLeastOneCallbackFired = false
+---
+-- @internal
+function ____exports.firstLastInit(self, mod)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_EARLY, postNewRoomEarly)
+end
+--- Returns the first modded collectible type, or undefined if there are no modded collectibles.
+-- 
+-- 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.getFirstModdedCollectibleType(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "collectible")
+    local firstModdedCollectibleType = asCollectibleType(
+        nil,
+        asNumber(nil, LAST_VANILLA_COLLECTIBLE_TYPE) + 1
+    )
+    local itemConfigItem = itemConfig:GetCollectible(firstModdedCollectibleType)
+    local ____temp_0
+    if itemConfigItem == nil then
+        ____temp_0 = nil
+    else
+        ____temp_0 = firstModdedCollectibleType
+    end
+    return ____temp_0
+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`.)
+-- 
+-- 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.getModdedCollectibleTypes(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "collectible")
+    local firstModdedCollectibleType = ____exports.getFirstModdedCollectibleType(nil)
+    if firstModdedCollectibleType == nil then
+        return {}
+    end
+    local lastCollectibleType = ____exports.getLastCollectibleType(nil)
+    return irange(nil, firstModdedCollectibleType, lastCollectibleType)
+end
+--- 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.getNumCollectibleTypes(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "collectible")
+    local numModdedCollectibleTypes = ____exports.getNumModdedCollectibleTypes(nil)
+    return NUM_VANILLA_COLLECTIBLE_TYPES + numModdedCollectibleTypes
+end
+--- Returns the first modded trinket type, or undefined if there are no 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.getFirstModdedTrinketType(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "trinket")
+    local firstModdedTrinketType = asTrinketType(
+        nil,
+        asNumber(nil, LAST_VANILLA_TRINKET_TYPE) + 1
+    )
+    local itemConfigItem = itemConfig:GetTrinket(firstModdedTrinketType)
+    local ____temp_1
+    if itemConfigItem == nil then
+        ____temp_1 = nil
+    else
+        ____temp_1 = firstModdedTrinketType
+    end
+    return ____temp_1
+end
+--- Will change depending on how many modded cards there are.
+-- 
+-- This is equal to the number of trinket types, since all trinket types are contiguous (unlike
+-- collectibles).
+-- 
+-- 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.getLastTrinketType(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "trinket")
+    local numTrinketTypes = ____exports.getNumTrinketTypes(nil)
+    return asTrinketType(nil, numTrinketTypes)
+end
+--- Helper function to get an array that represents every modded trinket type.
+-- 
+-- Returns an empty array if there are no modded trinket types.
+-- 
+-- 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.getModdedTrinketTypes(self)
+    local firstModdedTrinketType = ____exports.getFirstModdedTrinketType(nil)
+    if firstModdedTrinketType == nil then
+        return {}
+    end
+    local lastTrinketType = ____exports.getLastTrinketType(nil)
+    return irange(nil, firstModdedTrinketType, lastTrinketType)
+end
+--- 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.getNumModdedTrinketTypes(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "trinket")
+    local numTrinketTypes = ____exports.getNumTrinketTypes(nil)
+    return numTrinketTypes - NUM_VANILLA_TRINKET_TYPES
+end
+--- Helper function to get an array that contains every trinket type.
+-- 
+-- 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.getTrinketTypes(self)
+    local lastTrinketType = ____exports.getLastTrinketType(nil)
+    return irange(nil, FIRST_TRINKET_TYPE, lastTrinketType)
+end
+--- Helper function to get an array with every valid card sub-type. This includes modded cards.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all cards will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getAllCards(self)
+    local lastCard = ____exports.getLastCard(nil)
+    return irange(nil, FIRST_CARD, lastCard)
+end
+--- Returns the first modded card sub-type, or undefined if there are no modded cards.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all cards will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getFirstModdedCard(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "card")
+    local firstModdedCard = asCard(
+        nil,
+        asNumber(nil, LAST_VANILLA_CARD) + 1
+    )
+    local itemConfigCard = itemConfig:GetCard(firstModdedCard)
+    local ____temp_2
+    if itemConfigCard == nil then
+        ____temp_2 = nil
+    else
+        ____temp_2 = firstModdedCard
+    end
+    return ____temp_2
+end
+--- Helper function to get an array with every modded card sub-type.
+-- 
+-- Returns an empty array if there are no modded cards.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all cards will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getModdedCards(self)
+    local firstModdedCard = ____exports.getFirstModdedCard(nil)
+    if firstModdedCard == nil then
+        return {}
+    end
+    local lastCard = ____exports.getLastCard(nil)
+    return irange(nil, firstModdedCard, lastCard)
+end
+--- 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.getNumModdedCards(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "card")
+    local numCards = ____exports.getNumCards(nil)
+    return numCards - NUM_VANILLA_CARDS
+end
+--- Helper function to get an array with every valid pill effect. This includes modded pill effects.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all pill effects will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getAllPillEffects(self)
+    local lastPillEffect = ____exports.getLastPillEffect(nil)
+    return irange(nil, FIRST_PILL_EFFECT, lastPillEffect)
+end
+--- Returns the first modded pill effect, or undefined if there are no modded pill effects.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all pill effects will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getFirstModdedPillEffect(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "pill")
+    local firstModdedPillEffect = asPillEffect(
+        nil,
+        asNumber(nil, LAST_VANILLA_PILL_EFFECT) + 1
+    )
+    local itemConfigPillEffect = itemConfig:GetPillEffect(firstModdedPillEffect)
+    local ____temp_3
+    if itemConfigPillEffect == nil then
+        ____temp_3 = nil
+    else
+        ____temp_3 = firstModdedPillEffect
+    end
+    return ____temp_3
+end
+--- Helper function to get an array with every modded pill effect.
+-- 
+-- Returns an empty array if there are no modded pill effects.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all pill effects will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getModdedPillEffects(self)
+    local firstModdedPillEffect = ____exports.getFirstModdedPillEffect(nil)
+    if firstModdedPillEffect == nil then
+        return {}
+    end
+    local lastPillEffect = ____exports.getLastPillEffect(nil)
+    return irange(nil, firstModdedPillEffect, lastPillEffect)
+end
+--- This function can only be called if at least one callback has been executed. This is because not
+-- all pill effects will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getNumModdedPillEffects(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    errorIfNoCallbacksFired(nil, "pill")
+    local numPillEffects = ____exports.getNumPillEffects(nil)
+    return numPillEffects - NUM_VANILLA_PILL_EFFECTS
+end
+return ____exports

package/dist/functions/array.d.ts

@@ -159,15 +159,7 @@ export declare function getRandomArrayElementAndRemove<T>(array: T[], seedOrRNG?
  *                   index. Default is an empty array.
  */
 export declare function getRandomArrayIndex<T>(array: T[] | readonly T[], seedOrRNG?: Seed | RNG, exceptions?: int[] | readonly int[]): int;
-/**
- * Initializes an array with all elements containing the specified default value.
- *
- * For example:
- *
- * ```ts
- * const playerTransformations = initArray(false, PlayerForm.NUM_PLAYER_FORMS - 1);
- * ```
- */
+/** Initializes an array with all elements containing the specified default value. */
 export declare function initArray<T>(defaultValue: T, size: int): T[];
 /**
  * Since Lua uses tables for every non-primitive data structure, it is non-trivial to determine if a

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

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

package/dist/functions/array.lua

@@ -399,12 +399,6 @@ function ____exports.getRandomArrayElementAndRemove(self, array, seedOrRNG, exce
     return randomArrayElement
 end
 --- Initializes an array with all elements containing the specified default value.
--- 
--- For example:
--- 
--- ```ts
--- const playerTransformations = initArray(false, PlayerForm.NUM_PLAYER_FORMS - 1);
--- ```
 function ____exports.initArray(self, defaultValue, size)
     local array = {}
     ____repeat(

package/dist/functions/cards.d.ts

@@ -1,6 +1,4 @@
 import { Card, ItemConfigCardType } from "isaac-typescript-definitions";
-/** Helper function to get an array with every valid card sub-type. This includes modded cards. */
-export declare function getAllCards(): Card[];
 /**
  * Helper function to get a card description from a Card enum value.
  *
@@ -31,12 +29,6 @@ export declare function getCardType(card: Card): ItemConfigCardType;
  * containing cards that match any of the specified types.
  */
 export declare function getCardsOfType(...cardTypes: ItemConfigCardType[]): Set<Card>;
-/**
- * Helper function to get an array with every modded card sub-type.
- *
- * Returns an empty array if there are no modded cards.
- */
-export declare function getModdedCards(): Card[];
 /**
  * Has an equal chance of returning any card (e.g. Fool, Reverse Fool, Wild Card, etc.).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/functions/cards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AA2DxE,kGAAkG;AAClG,wBAAgB,WAAW,IAAI,IAAI,EAAE,CAEpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAerD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAe9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,kBAAkB,CAK1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,EAAE,kBAAkB,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAkB5E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,EAAE,CAMvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,IAAI,EAAO,GACtB,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,IAAI,EAAO,GACtB,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,IAAI,EAAO,GACtB,IAAI,CAIN;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,IAAI,IAAI,EAAE,CAExC;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE1C;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAE5E;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEhD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEtD;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEtD;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE1C;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE9C;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE/C"}
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/functions/cards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAsDxE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAerD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAe9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,kBAAkB,CAK1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,EAAE,kBAAkB,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAkB5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,IAAI,EAAO,GACtB,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,IAAI,EAAO,GACtB,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,IAAI,EAAO,GACtB,IAAI,CAIN;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,IAAI,IAAI,EAAE,CAExC;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE1C;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAE5E;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEhD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEtD;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEtD;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE1C;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE9C;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE/C"}

package/dist/functions/cards.lua

@@ -4,7 +4,7 @@ local __TS__New = ____lualib.__TS__New
 local Set = ____lualib.Set
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
-local initCardObjects, CARD_TYPE_TO_CARDS_MAP, CARD_SET
+local lazyInitCardMapsSets, CARD_TYPE_TO_CARDS_MAP, CARD_SET
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Card = ____isaac_2Dtypescript_2Ddefinitions.Card
 local ItemConfigCardType = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigCardType
@@ -12,9 +12,7 @@ local ____cachedClasses = require("core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constantsFirstLast = require("core.constantsFirstLast")
 local FIRST_CARD = ____constantsFirstLast.FIRST_CARD
-local FIRST_MODDED_CARD = ____constantsFirstLast.FIRST_MODDED_CARD
-local LAST_CARD = ____constantsFirstLast.LAST_CARD
-local MAX_VANILLA_CARD = ____constantsFirstLast.MAX_VANILLA_CARD
+local LAST_VANILLA_CARD = ____constantsFirstLast.LAST_VANILLA_CARD
 local ____cardDescriptions = require("objects.cardDescriptions")
 local CARD_DESCRIPTIONS = ____cardDescriptions.CARD_DESCRIPTIONS
 local DEFAULT_CARD_DESCRIPTION = ____cardDescriptions.DEFAULT_CARD_DESCRIPTION
@@ -33,14 +31,14 @@ local addSetsToSet = ____set.addSetsToSet
 local getRandomSetElement = ____set.getRandomSetElement
 local ____utils = require("functions.utils")
 local irange = ____utils.irange
-function initCardObjects(self)
+function lazyInitCardMapsSets(self)
     for ____, cardType in ipairs(getEnumValues(nil, ItemConfigCardType)) do
         CARD_TYPE_TO_CARDS_MAP:set(
             cardType,
             __TS__New(Set)
         )
     end
-    for ____, card in ipairs(____exports.getAllCards(nil)) do
+    for ____, card in ipairs(____exports.getVanillaCards(nil)) do
         local cardType = ____exports.getCardType(nil, card)
         local cardTypeSet = CARD_TYPE_TO_CARDS_MAP:get(cardType)
         if cardTypeSet == nil then
@@ -57,10 +55,6 @@ function initCardObjects(self)
     )
     addSetsToSet(nil, CARD_SET, cards)
 end
---- Helper function to get an array with every valid card sub-type. This includes modded cards.
-function ____exports.getAllCards(self)
-    return irange(nil, FIRST_CARD, LAST_CARD)
-end
 function ____exports.getCardType(self, card)
     local cardType = CARD_TYPES[card]
     return cardType == nil and DEFAULT_CARD_TYPE or cardType
@@ -72,7 +66,7 @@ end
 function ____exports.getCardsOfType(self, ...)
     local cardTypes = {...}
     if CARD_TYPE_TO_CARDS_MAP.size == 0 then
-        initCardObjects(nil)
+        lazyInitCardMapsSets(nil)
     end
     local matchingCards = __TS__New(Set)
     for ____, cardType in ipairs(cardTypes) do
@@ -86,6 +80,10 @@ function ____exports.getCardsOfType(self, ...)
     end
     return matchingCards
 end
+--- Helper function to get an array with every valid vanilla card sub-type.
+function ____exports.getVanillaCards(self)
+    return irange(nil, FIRST_CARD, LAST_VANILLA_CARD)
+end
 CARD_TYPE_TO_CARDS_MAP = __TS__New(Map)
 CARD_SET = __TS__New(Set)
 --- Helper function to get a card description from a Card enum value.
@@ -126,15 +124,6 @@ function ____exports.getCardName(self, card)
     end
     return DEFAULT_CARD_NAME
 end
---- Helper function to get an array with every modded card sub-type.
--- 
--- Returns an empty array if there are no modded cards.
-function ____exports.getModdedCards(self)
-    if MAX_VANILLA_CARD == LAST_CARD then
-        return {}
-    end
-    return irange(nil, FIRST_MODDED_CARD, LAST_CARD)
-end
 --- Has an equal chance of returning any card (e.g. Fool, Reverse Fool, Wild Card, etc.).
 -- 
 -- This will not return:
@@ -187,10 +176,6 @@ function ____exports.getRandomRune(self, seedOrRNG, exceptions)
     runesSet:delete(Card.RUNE_SHARD)
     return getRandomSetElement(nil, runesSet, seedOrRNG, exceptions)
 end
---- Helper function to get an array with every valid vanilla card sub-type.
-function ____exports.getVanillaCards(self)
-    return irange(nil, FIRST_CARD, MAX_VANILLA_CARD)
-end
 --- Returns true for cards that have the following card type:
 -- - CardType.TAROT
 -- - CardType.SUIT

package/dist/functions/{cacheFlag.d.ts → collectibleCacheFlag.d.ts}

@@ -1,17 +1,14 @@
 import { CacheFlag, CollectibleType } from "isaac-typescript-definitions";
+/** Helper function to check in the item config if a given collectible has a given cache flag. */
 export declare function collectibleHasCacheFlag(collectibleType: CollectibleType, cacheFlag: CacheFlag): boolean;
 /**
  * Returns a set containing every collectible type with the given cache flag, including modded
  * collectibles.
- */
-export declare function getCollectiblesForCacheFlag(cacheFlag: CacheFlag): Set<CollectibleType>;
-/**
- * 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.
+ * 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 getDefaultPlayerStat(cacheFlag: CacheFlag): number | undefined;
+export declare function getCollectiblesForCacheFlag(cacheFlag: CacheFlag): Set<CollectibleType>;
 /**
  * Returns an array containing every collectible type that the player has that matches the provided
  * CacheFlag.
@@ -26,6 +23,9 @@ export declare function getDefaultPlayerStat(cacheFlag: CacheFlag): number | und
  *   CollectibleType.DEAD_DOVE,
  * ]
  * ```
+ *
+ * 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 getPlayerCollectiblesForCacheFlag(player: EntityPlayer, cacheFlag: CacheFlag): CollectibleType[];
-//# sourceMappingURL=cacheFlag.d.ts.map
+//# sourceMappingURL=collectibleCacheFlag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collectibleCacheFlag.d.ts","sourceRoot":"","sources":["../../src/functions/collectibleCacheFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA+B1E,iGAAiG;AACjG,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,eAAe,CAAC,CAStB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,eAAe,EAAE,CAYnB"}

package/dist/functions/{cacheFlag.lua → collectibleCacheFlag.lua}

@@ -7,8 +7,6 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
 local ____cachedClasses = require("core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
-local ____defaultPlayerStatMap = require("maps.defaultPlayerStatMap")
-local DEFAULT_PLAYER_STAT_MAP = ____defaultPlayerStatMap.DEFAULT_PLAYER_STAT_MAP
 local ____collectibleSet = require("functions.collectibleSet")
 local getCollectibleArray = ____collectibleSet.getCollectibleArray
 local ____enums = require("functions.enums")
@@ -20,6 +18,7 @@ local copySet = ____set.copySet
 local getSortedSetValues = ____set.getSortedSetValues
 local ____utils = require("functions.utils")
 local ____repeat = ____utils["repeat"]
+--- Helper function to check in the item config if a given collectible has a given cache flag.
 function ____exports.collectibleHasCacheFlag(self, collectibleType, cacheFlag)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     if itemConfigItem == nil then
@@ -28,7 +27,10 @@ function ____exports.collectibleHasCacheFlag(self, collectibleType, cacheFlag)
     return hasFlag(nil, itemConfigItem.CacheFlags, cacheFlag)
 end
 local CACHE_FLAG_TO_COLLECTIBLES_MAP = __TS__New(Map)
-local function initCacheFlagMap(self)
+local function lazyInitCacheFlagMap(self)
+    if CACHE_FLAG_TO_COLLECTIBLES_MAP.size > 0 then
+        return
+    end
     for ____, cacheFlag in ipairs(getEnumValues(nil, CacheFlag)) do
         local collectiblesSet = __TS__New(Set)
         for ____, collectibleType in ipairs(getCollectibleArray(nil)) do
@@ -41,23 +43,17 @@ local function initCacheFlagMap(self)
 end
 --- Returns a set containing every collectible type with the given cache flag, including modded
 -- collectibles.
+-- 
+-- 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.getCollectiblesForCacheFlag(self, cacheFlag)
-    if CACHE_FLAG_TO_COLLECTIBLES_MAP.size == 0 then
-        initCacheFlagMap(nil)
-    end
+    lazyInitCacheFlagMap(nil)
     local collectiblesSet = CACHE_FLAG_TO_COLLECTIBLES_MAP:get(cacheFlag)
     if collectiblesSet == nil then
         return __TS__New(Set)
     end
     return copySet(nil, collectiblesSet)
 end
---- 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
 --- Returns an array containing every collectible type that the player has that matches the provided
 -- CacheFlag.
 -- 
@@ -71,6 +67,9 @@ end
 --   CollectibleType.DEAD_DOVE,
 -- ]
 -- ```
+-- 
+-- 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.getPlayerCollectiblesForCacheFlag(self, player, cacheFlag)
     local collectiblesForCacheFlag = ____exports.getCollectiblesForCacheFlag(nil, cacheFlag)
     local playerCollectibles = {}