isaacscript-common 11.2.3 → 12.0.0

package/dist/index.d.ts

@@ -2627,6 +2627,16 @@ export declare function getCharacterName(character: PlayerType): string;
 /** Helper function to get an array containing the characters of all of the current players. */
 export declare function getCharacters(): PlayerType[];
 
+/**
+ * Helper function to get the amount of charges away from the maximum charge that a particular
+ * player is.
+ *
+ * This function accounts for The Battery. For example, if the player has 2/6 charges on a D6, this
+ * function will return 10 (because there are 4 charges remaining on the base charge and 6 charges
+ * remaining on The Battery charge).
+ */
+export declare function getChargesAwayFromMax(player: EntityPlayer, activeSlot: ActiveSlot): int;
+
 /**
  * Helper function to get an array of equidistant points on the circumference around a circle.
  * Useful for equally distributing things in a circle pattern.
@@ -10404,9 +10414,14 @@ export declare enum SaveDataKey {
  * data manager cannot do this on its own because it cannot know when your mod features are finished
  * initializing.)
  *
- * Finally, some features may have variables that need to be automatically reset per run/level, but
- * not saved to disk on game exit. (For example, if they contain functions or other non-serializable
- * data.) For these cases, set the second argument to `() => false`.
+ * Some features may have variables that need to be automatically reset per run/level, but not saved
+ * to disk on game exit. (For example, if they contain functions or other non-serializable data.)
+ * For these cases, set the second argument to `() => false`.
+ *
+ * Note that when the player uses Glowing Hour Glass, the save data manager will automatically
+ * restore any variables on a "run" or "level" object with a backup that was created when the room
+ * was entered. Thus, you should not have to explicitly program support for Glowing Hour Glass into
+ * your mod features that use the save data manager.
  *
  * @param key The name of the file or feature that is submitting data to be managed by the save data
  *            manager. The save data manager will throw an error if the key is already registered.

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 11.2.3
+isaacscript-common 12.0.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -26923,11 +26923,16 @@ ____exports.SerializationType.DESERIALIZE = 2
 ____exports.SerializationType[____exports.SerializationType.DESERIALIZE] = "DESERIALIZE"
 return ____exports
  end,
-["src.features.saveDataManager.saveDataManagerConstants"] = function(...) 
+["src.features.saveDataManager.constants"] = function(...) 
 local ____exports = {}
+local ____SaveDataKey = require("src.enums.SaveDataKey")
+local SaveDataKey = ____SaveDataKey.SaveDataKey
 --- Set this to true to enable more verbosity in the save data manger.
 ____exports.SAVE_DATA_MANAGER_DEBUG = false
 ____exports.SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager"
+--- When the Glowing Hour Glass is used, certain save data keys will automatically be restored to a
+-- backup.
+____exports.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS = {SaveDataKey.RUN, SaveDataKey.LEVEL}
 return ____exports
  end,
 ["src.features.saveDataManager.serializationBrands"] = function(...) 
@@ -27608,7 +27613,7 @@ return ____exports
  end,
 ["src.functions.charge"] = function(...) 
 local ____exports = {}
-local getClampedChargesToAdd, getChargesToAddWithAAAModifier, shouldPlayFullRechargeSound
+local getChargesToAddWithAAAModifier, shouldPlayFullRechargeSound
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
 local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
@@ -27650,7 +27655,8 @@ function ____exports.addCharge(self, player, activeSlot, numCharges, playSoundEf
         playSoundEffect = true
     end
     local hud = game:GetHUD()
-    local chargesToAdd = getClampedChargesToAdd(nil, player, activeSlot, numCharges)
+    local chargesAwayFromMax = ____exports.getChargesAwayFromMax(nil, player, activeSlot)
+    local chargesToAdd = numCharges > chargesAwayFromMax and chargesAwayFromMax or numCharges
     local modifiedChargesToAdd = getChargesToAddWithAAAModifier(nil, player, activeSlot, chargesToAdd)
     local totalCharge = ____exports.getTotalCharge(nil, player, activeSlot)
     local newCharge = totalCharge + modifiedChargesToAdd
@@ -27697,6 +27703,9 @@ function ____exports.addRoomClearChargeToSlot(self, player, activeSlot, bigRoomD
     local room = game:GetRoom()
     local roomShape = room:GetRoomShape()
     local numCharges = bigRoomDoubleCharge and getRoomShapeCharges(nil, roomShape) or 1
+    if chargeType == ItemConfigChargeType.TIMED then
+        numCharges = getCollectibleMaxCharges(nil, activeItem)
+    end
     ____exports.addCharge(
         nil,
         player,
@@ -27705,43 +27714,28 @@ function ____exports.addRoomClearChargeToSlot(self, player, activeSlot, bigRoomD
         playSoundEffect
     )
 end
-function getClampedChargesToAdd(self, player, activeSlot, numCharges)
-    local activeItem = player:GetActiveItem(activeSlot)
-    local activeCharge = player:GetActiveCharge(activeSlot)
-    local batteryCharge = player:GetBatteryCharge(activeSlot)
-    local hasBattery = player:HasCollectible(CollectibleType.BATTERY)
-    local maxCharges = getCollectibleMaxCharges(nil, activeItem)
-    if not hasBattery and activeCharge == maxCharges then
-        return 0
-    end
-    if hasBattery and batteryCharge == maxCharges then
-        return 0
-    end
-    if not hasBattery and activeCharge + 1 == maxCharges then
-        return 1
-    end
-    if hasBattery and batteryCharge + 1 == maxCharges then
-        return 1
-    end
-    return numCharges
-end
 function getChargesToAddWithAAAModifier(self, player, activeSlot, chargesToAdd)
-    local activeItem = player:GetActiveItem(activeSlot)
-    local activeCharge = player:GetActiveCharge(activeSlot)
-    local batteryCharge = player:GetBatteryCharge(activeSlot)
-    local hasBattery = player:HasCollectible(CollectibleType.BATTERY)
     local hasAAABattery = player:HasTrinket(TrinketType.AAA_BATTERY)
-    local maxCharges = getCollectibleMaxCharges(nil, activeItem)
     if not hasAAABattery then
         return chargesToAdd
     end
-    if not hasBattery and activeCharge + chargesToAdd == maxCharges - 1 then
-        return chargesToAdd + 1
-    end
-    if hasBattery and batteryCharge + chargesToAdd == maxCharges - 1 then
-        return chargesToAdd + 1
-    end
-    return chargesToAdd
+    local chargesAwayFromMax = ____exports.getChargesAwayFromMax(nil, player, activeSlot)
+    local AAABatteryShouldApply = chargesToAdd == chargesAwayFromMax - 1
+    return AAABatteryShouldApply and chargesToAdd + 1 or chargesToAdd
+end
+--- Helper function to get the amount of charges away from the maximum charge that a particular
+-- player is.
+-- 
+-- This function accounts for The Battery. For example, if the player has 2/6 charges on a D6, this
+-- function will return 10 (because there are 4 charges remaining on the base charge and 6 charges
+-- remaining on The Battery charge).
+function ____exports.getChargesAwayFromMax(self, player, activeSlot)
+    local totalCharge = ____exports.getTotalCharge(nil, player, activeSlot)
+    local activeItem = player:GetActiveItem(activeSlot)
+    local hasBattery = player:HasCollectible(CollectibleType.BATTERY)
+    local maxCharges = getCollectibleMaxCharges(nil, activeItem)
+    local effectiveMaxCharges = hasBattery and maxCharges * 2 or maxCharges
+    return effectiveMaxCharges - totalCharge
 end
 --- Helper function to get the combined normal charge and the battery charge for the player's active
 -- item. This is useful because you have to add these two values together when setting the active
@@ -30062,8 +30056,8 @@ local ____SerializationBrand = require("src.enums.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____SerializationType = require("src.enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
-local ____saveDataManagerConstants = require("src.features.saveDataManager.saveDataManagerConstants")
-local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
+local ____constants = require("src.features.saveDataManager.constants")
+local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 local ____serializationBrands = require("src.features.saveDataManager.serializationBrands")
 local isSerializationBrand = ____serializationBrands.isSerializationBrand
 local ____array = require("src.functions.array")
@@ -31366,8 +31360,8 @@ local ____types = require("src.functions.types")
 local isTable = ____types.isTable
 local ____utils = require("src.functions.utils")
 local getTraversalDescription = ____utils.getTraversalDescription
-local ____saveDataManagerConstants = require("src.features.saveDataManager.saveDataManagerConstants")
-local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
+local ____constants = require("src.features.saveDataManager.constants")
+local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 local ____serializationBrands = require("src.features.saveDataManager.serializationBrands")
 local isSerializationBrand = ____serializationBrands.isSerializationBrand
 --- `merge` takes the values from a new table and recursively merges them into an old object (while
@@ -31507,11 +31501,11 @@ local iterateTableInOrder = ____table.iterateTableInOrder
 local ____types = require("src.functions.types")
 local isString = ____types.isString
 local isTable = ____types.isTable
+local ____constants = require("src.features.saveDataManager.constants")
+local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local ____merge = require("src.features.saveDataManager.merge")
 local merge = ____merge.merge
-local ____saveDataManagerConstants = require("src.features.saveDataManager.saveDataManagerConstants")
-local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
 function readSaveDatFile(self, mod)
     local renderFrameCount = Isaac.GetFrameCount()
     local ok, jsonStringOrErrMsg = pcall(tryLoadModData, mod)
@@ -31547,21 +31541,21 @@ function ____exports.loadFromDisk(self, mod, oldSaveData)
     iterateTableInOrder(
         nil,
         newSaveData,
-        function(____, key, value)
-            if not isString(nil, key) then
+        function(____, subscriberName, saveData)
+            if not isString(nil, subscriberName) then
                 return
             end
-            if not isTable(nil, value) then
+            if not isTable(nil, saveData) then
                 return
             end
-            local oldSaveDataForSubscriber = oldSaveData[key]
+            local oldSaveDataForSubscriber = oldSaveData[subscriberName]
             if oldSaveDataForSubscriber == nil then
                 return
             end
             if SAVE_DATA_MANAGER_DEBUG then
-                log(nil, "Merging in stored data for feature: " .. key)
+                log(nil, "Merging in stored data for feature: " .. subscriberName)
             end
-            merge(nil, oldSaveDataForSubscriber, value, key)
+            merge(nil, oldSaveDataForSubscriber, saveData, subscriberName)
         end,
         SAVE_DATA_MANAGER_DEBUG
     )
@@ -31577,6 +31571,9 @@ local ____exports = {}
 ____exports.saveDataMap = {}
 ____exports.saveDataDefaultsMap = {}
 ____exports.saveDataConditionalFuncMap = {}
+--- We backup some save data keys on every new room for the purposes of restoring it when Glowing
+-- Hour Glass is used.
+____exports.saveDataGlowingHourGlassMap = {}
 return ____exports
  end,
 ["src.features.saveDataManager.save"] = function(...) 
@@ -31594,9 +31591,9 @@ local ____log = require("src.functions.log")
 local log = ____log.log
 local ____table = require("src.functions.table")
 local iterateTableInOrder = ____table.iterateTableInOrder
-local ____saveDataManagerConstants = require("src.features.saveDataManager.saveDataManagerConstants")
-local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
+local ____constants = require("src.features.saveDataManager.constants")
+local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 function getAllSaveDataToWriteToDisk(self, saveDataMap, saveDataConditionalFuncMap)
     local allSaveData = {}
     iterateTableInOrder(
@@ -31634,7 +31631,7 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local postUseItemGlowingHourGlass, postPlayerInit, preGameExit, postNewLevel, postNewRoomEarly, restoreDefaultsAll, restoreDefaults, clearAndCopyAllElements, RESETTABLE_SAVE_DATA_KEYS, mod, loadedDataOnThisRun
+local postUseItemGlowingHourGlass, postPlayerInit, preGameExit, postNewLevel, postNewRoomEarly, makeGlowingHourGlassBackup, restoreGlowingHourGlassBackup, restoreDefaultsAll, restoreDefaults, clearAndCopyAllElements, RESETTABLE_SAVE_DATA_KEYS, mod, loadedDataOnThisRun, restoreGlowingHourGlassDataOnNextRoom
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
@@ -31655,18 +31652,23 @@ local onFirstFloor = ____stage.onFirstFloor
 local ____table = require("src.functions.table")
 local clearTable = ____table.clearTable
 local iterateTableInOrder = ____table.iterateTableInOrder
+local ____constants = require("src.features.saveDataManager.constants")
+local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
+local SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS = ____constants.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS
 local ____load = require("src.features.saveDataManager.load")
 local loadFromDisk = ____load.loadFromDisk
 local ____maps = require("src.features.saveDataManager.maps")
 local saveDataConditionalFuncMap = ____maps.saveDataConditionalFuncMap
 local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
+local saveDataGlowingHourGlassMap = ____maps.saveDataGlowingHourGlassMap
 local saveDataMap = ____maps.saveDataMap
+local ____merge = require("src.features.saveDataManager.merge")
+local merge = ____merge.merge
 local ____save = require("src.features.saveDataManager.save")
 local saveToDisk = ____save.saveToDisk
-local ____saveDataManagerConstants = require("src.features.saveDataManager.saveDataManagerConstants")
-local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
 function postUseItemGlowingHourGlass(self)
+    restoreGlowingHourGlassDataOnNextRoom = true
     return nil
 end
 function postPlayerInit(self)
@@ -31703,6 +31705,63 @@ function postNewLevel(self)
 end
 function postNewRoomEarly(self)
     restoreDefaults(nil, SaveDataKey.ROOM)
+    if restoreGlowingHourGlassDataOnNextRoom then
+        restoreGlowingHourGlassDataOnNextRoom = false
+        restoreGlowingHourGlassBackup(nil)
+    else
+        makeGlowingHourGlassBackup(nil)
+    end
+end
+function makeGlowingHourGlassBackup(self)
+    iterateTableInOrder(
+        nil,
+        saveDataMap,
+        function(____, subscriberName, saveData)
+            for ____, saveDataKey in ipairs(SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) do
+                do
+                    local childTable = saveData[saveDataKey]
+                    if childTable == nil then
+                        goto __continue18
+                    end
+                    local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
+                    if saveDataGlowingHourGlass == nil then
+                        saveDataGlowingHourGlass = {}
+                    end
+                    local copiedChildTable = deepCopy(nil, childTable)
+                    saveDataGlowingHourGlass[saveDataKey] = copiedChildTable
+                end
+                ::__continue18::
+            end
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+end
+function restoreGlowingHourGlassBackup(self)
+    iterateTableInOrder(
+        nil,
+        saveDataMap,
+        function(____, subscriberName, saveData)
+            for ____, saveDataKey in ipairs(SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) do
+                do
+                    local childTable = saveData[saveDataKey]
+                    if childTable == nil then
+                        goto __continue24
+                    end
+                    local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
+                    if saveDataGlowingHourGlass == nil then
+                        goto __continue24
+                    end
+                    local childTableBackup = saveDataGlowingHourGlass[saveDataKey]
+                    if childTableBackup == nil then
+                        goto __continue24
+                    end
+                    merge(nil, childTable, childTableBackup, subscriberName .. "__glowingHourGlass")
+                end
+                ::__continue24::
+            end
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
 end
 function restoreDefaultsAll(self)
     restoreDefaults(nil, SaveDataKey.RUN)
@@ -31749,6 +31808,7 @@ end
 RESETTABLE_SAVE_DATA_KEYS = __TS__New(Set, {SaveDataKey.RUN, SaveDataKey.LEVEL, SaveDataKey.ROOM})
 mod = nil
 loadedDataOnThisRun = false
+restoreGlowingHourGlassDataOnNextRoom = false
 function ____exports.saveDataManagerInit(self, incomingMod)
     mod = incomingMod
     mod:AddCallback(ModCallback.POST_USE_ITEM, postUseItemGlowingHourGlass, CollectibleType.GLOWING_HOUR_GLASS)
@@ -31784,6 +31844,8 @@ local ____deepCopy = require("src.functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
 local ____types = require("src.functions.types")
 local isString = ____types.isString
+local ____constants = require("src.features.saveDataManager.constants")
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local ____main = require("src.features.saveDataManager.main")
 local forceSaveDataManagerLoad = ____main.forceSaveDataManagerLoad
 local forceSaveDataManagerSave = ____main.forceSaveDataManagerSave
@@ -31792,8 +31854,6 @@ local ____maps = require("src.features.saveDataManager.maps")
 local saveDataConditionalFuncMap = ____maps.saveDataConditionalFuncMap
 local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
 local saveDataMap = ____maps.saveDataMap
-local ____saveDataManagerConstants = require("src.features.saveDataManager.saveDataManagerConstants")
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
 --- This is the entry point to the save data manager, a system which provides two major features:
 -- 
 -- 1. automatic resetting of variables on a new run, on a new level, or on a new room (as desired)
@@ -31865,9 +31925,14 @@ local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MA
 -- data manager cannot do this on its own because it cannot know when your mod features are finished
 -- initializing.)
 -- 
--- Finally, some features may have variables that need to be automatically reset per run/level, but
--- not saved to disk on game exit. (For example, if they contain functions or other non-serializable
--- data.) For these cases, set the second argument to `() => false`.
+-- Some features may have variables that need to be automatically reset per run/level, but not saved
+-- to disk on game exit. (For example, if they contain functions or other non-serializable data.)
+-- For these cases, set the second argument to `() => false`.
+-- 
+-- Note that when the player uses Glowing Hour Glass, the save data manager will automatically
+-- restore any variables on a "run" or "level" object with a backup that was created when the room
+-- was entered. Thus, you should not have to explicitly program support for Glowing Hour Glass into
+-- your mod features that use the save data manager.
 -- 
 -- @param key The name of the file or feature that is submitting data to be managed by the save data
 -- manager. The save data manager will throw an error if the key is already registered.
@@ -39636,7 +39701,7 @@ return ____exports
 local ____exports = {}
 return ____exports
  end,
-["src.features.customStage.customStageConstants"] = function(...) 
+["src.features.customStage.constants"] = function(...) 
 local ____exports = {}
 ____exports.CUSTOM_STAGE_FEATURE_NAME = "customStage"
 ____exports.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage"
@@ -39682,8 +39747,8 @@ local trimPrefix = ____string.trimPrefix
 local ____utils = require("src.functions.utils")
 local erange = ____utils.erange
 local irange = ____utils.irange
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____constants = require("src.features.customStage.constants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____constants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
 function getBackdropPNGPath(self, customStage, backdropKind, rng)
     local backdrop = customStage.backdropPNGPaths == nil and DEFAULT_BACKDROP or customStage.backdropPNGPaths
     local pathArray = backdrop[backdropKind]
@@ -40175,7 +40240,7 @@ return ____exports
 local ____exports = {}
 return ____exports
  end,
-["src.features.customTrapdoor.customTrapdoorConstants"] = function(...) 
+["src.features.customTrapdoor.constants"] = function(...) 
 local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
@@ -40258,10 +40323,10 @@ local ____positionVelocity = require("src.functions.positionVelocity")
 local anyPlayerCloserThan = ____positionVelocity.anyPlayerCloserThan
 local ____roomClearFrame = require("src.features.roomClearFrame")
 local getRoomClearGameFrame = ____roomClearFrame.getRoomClearGameFrame
-local ____customTrapdoorConstants = require("src.features.customTrapdoor.customTrapdoorConstants")
-local TRAPDOOR_BOSS_REACTION_FRAMES = ____customTrapdoorConstants.TRAPDOOR_BOSS_REACTION_FRAMES
-local TRAPDOOR_OPEN_DISTANCE = ____customTrapdoorConstants.TRAPDOOR_OPEN_DISTANCE
-local TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS = ____customTrapdoorConstants.TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS
+local ____constants = require("src.features.customTrapdoor.constants")
+local TRAPDOOR_BOSS_REACTION_FRAMES = ____constants.TRAPDOOR_BOSS_REACTION_FRAMES
+local TRAPDOOR_OPEN_DISTANCE = ____constants.TRAPDOOR_OPEN_DISTANCE
+local TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS = ____constants.TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS
 function shouldTrapdoorOpen(self, gridEntity, firstSpawn)
     local room = game:GetRoom()
     local roomClear = room:IsClear()
@@ -40361,8 +40426,8 @@ local ____vector = require("src.functions.vector")
 local isVector = ____vector.isVector
 local ____customGridEntity = require("src.features.customGridEntity")
 local spawnCustomGridEntity = ____customGridEntity.spawnCustomGridEntity
-local ____customTrapdoorConstants = require("src.features.customTrapdoor.customTrapdoorConstants")
-local GridEntityTypeCustom = ____customTrapdoorConstants.GridEntityTypeCustom
+local ____constants = require("src.features.customTrapdoor.constants")
+local GridEntityTypeCustom = ____constants.GridEntityTypeCustom
 local ____openClose = require("src.features.customTrapdoor.openClose")
 local shouldTrapdoorSpawnOpen = ____openClose.shouldTrapdoorSpawnOpen
 local ____v = require("src.features.customTrapdoor.v")
@@ -40405,8 +40470,8 @@ local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNot
 local ____nextStage = require("src.functions.nextStage")
 local getNextStage = ____nextStage.getNextStage
 local getNextStageType = ____nextStage.getNextStageType
-local ____customTrapdoorConstants = require("src.features.customTrapdoor.customTrapdoorConstants")
-local CUSTOM_TRAPDOOR_FEATURE_NAME = ____customTrapdoorConstants.CUSTOM_TRAPDOOR_FEATURE_NAME
+local ____constants = require("src.features.customTrapdoor.constants")
+local CUSTOM_TRAPDOOR_FEATURE_NAME = ____constants.CUSTOM_TRAPDOOR_FEATURE_NAME
 local ____spawn = require("src.features.customTrapdoor.spawn")
 local spawnCustomTrapdoorToDestination = ____spawn.spawnCustomTrapdoorToDestination
 --- Helper function to spawn a trapdoor grid entity that will take a player to a custom stage. If you
@@ -40581,8 +40646,8 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local UIStreakAnimation = ____customStageConstants.UIStreakAnimation
+local ____constants = require("src.features.customStage.constants")
+local UIStreakAnimation = ____constants.UIStreakAnimation
 local v = {
     run = {
         currentCustomStage = nil,
@@ -41098,8 +41163,8 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local spawnEffectWithSeed = ____entitiesSpecific.spawnEffectWithSeed
 local ____string = require("src.functions.string")
 local removeCharactersBefore = ____string.removeCharactersBefore
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____constants = require("src.features.customStage.constants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____constants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
 local ____v = require("src.features.customStage.v")
 local v = ____v.default
 --- Normally, we would make a custom entity to represent a shadow effect, but we don't want to
@@ -41299,9 +41364,9 @@ local getEnumValues = ____enums.getEnumValues
 local ____ui = require("src.functions.ui")
 local getScreenBottomCenterPos = ____ui.getScreenBottomCenterPos
 local getScreenTopCenterPos = ____ui.getScreenTopCenterPos
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local UIStreakAnimation = ____customStageConstants.UIStreakAnimation
-local UI_STREAK_ANIMATION_END_FRAMES = ____customStageConstants.UI_STREAK_ANIMATION_END_FRAMES
+local ____constants = require("src.features.customStage.constants")
+local UIStreakAnimation = ____constants.UIStreakAnimation
+local UI_STREAK_ANIMATION_END_FRAMES = ____constants.UI_STREAK_ANIMATION_END_FRAMES
 local ____v = require("src.features.customStage.v")
 local v = ____v.default
 function checkEndTopStreakText(self)
@@ -43533,9 +43598,9 @@ local pause = ____pause.pause
 local unpause = ____pause.unpause
 local ____runInNFrames = require("src.features.runInNFrames")
 local runNextGameFrame = ____runInNFrames.runNextGameFrame
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local CUSTOM_STAGE_FEATURE_NAME = ____customStageConstants.CUSTOM_STAGE_FEATURE_NAME
-local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____constants = require("src.features.customStage.constants")
+local CUSTOM_STAGE_FEATURE_NAME = ____constants.CUSTOM_STAGE_FEATURE_NAME
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____constants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
 local ____exports = require("src.features.customStage.exports")
 local CUSTOM_FLOOR_STAGE = ____exports.CUSTOM_FLOOR_STAGE
 local CUSTOM_FLOOR_STAGE_TYPE = ____exports.CUSTOM_FLOOR_STAGE_TYPE
@@ -43775,8 +43840,8 @@ local ____exports = require("src.features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("src.features.customStage.backdrop")
 local setCustomStageBackdrop = ____backdrop.setCustomStageBackdrop
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local CUSTOM_STAGE_FEATURE_NAME = ____customStageConstants.CUSTOM_STAGE_FEATURE_NAME
+local ____constants = require("src.features.customStage.constants")
+local CUSTOM_STAGE_FEATURE_NAME = ____constants.CUSTOM_STAGE_FEATURE_NAME
 local ____customStageGridEntities = require("src.features.customStage.customStageGridEntities")
 local convertVanillaTrapdoors = ____customStageGridEntities.convertVanillaTrapdoors
 local removeUrnRewards = ____customStageGridEntities.removeUrnRewards
@@ -44329,12 +44394,12 @@ local isPlayerUsingPony = ____ponyDetection.isPlayerUsingPony
 local ____runInNFrames = require("src.features.runInNFrames")
 local runInNGameFrames = ____runInNFrames.runInNGameFrames
 local runNextRenderFrame = ____runInNFrames.runNextRenderFrame
-local ____customTrapdoorConstants = require("src.features.customTrapdoor.customTrapdoorConstants")
-local ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL = ____customTrapdoorConstants.ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL
-local CUSTOM_TRAPDOOR_FEATURE_NAME = ____customTrapdoorConstants.CUSTOM_TRAPDOOR_FEATURE_NAME
-local OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = ____customTrapdoorConstants.OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES
-local OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = ____customTrapdoorConstants.OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES
-local TRAPDOOR_TOUCH_DISTANCE = ____customTrapdoorConstants.TRAPDOOR_TOUCH_DISTANCE
+local ____constants = require("src.features.customTrapdoor.constants")
+local ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL = ____constants.ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL
+local CUSTOM_TRAPDOOR_FEATURE_NAME = ____constants.CUSTOM_TRAPDOOR_FEATURE_NAME
+local OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = ____constants.OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES
+local OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = ____constants.OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES
+local TRAPDOOR_TOUCH_DISTANCE = ____constants.TRAPDOOR_TOUCH_DISTANCE
 local ____v = require("src.features.customTrapdoor.v")
 local v = ____v.default
 function canPlayerInteractWithTrapdoor(self, player)
@@ -44502,10 +44567,10 @@ local ____exports = require("src.features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____blackSprite = require("src.features.customTrapdoor.blackSprite")
 local drawBlackSprite = ____blackSprite.drawBlackSprite
-local ____customTrapdoorConstants = require("src.features.customTrapdoor.customTrapdoorConstants")
-local CUSTOM_TRAPDOOR_FEATURE_NAME = ____customTrapdoorConstants.CUSTOM_TRAPDOOR_FEATURE_NAME
-local GridEntityTypeCustom = ____customTrapdoorConstants.GridEntityTypeCustom
-local PIXELATION_TO_BLACK_FRAMES = ____customTrapdoorConstants.PIXELATION_TO_BLACK_FRAMES
+local ____constants = require("src.features.customTrapdoor.constants")
+local CUSTOM_TRAPDOOR_FEATURE_NAME = ____constants.CUSTOM_TRAPDOOR_FEATURE_NAME
+local GridEntityTypeCustom = ____constants.GridEntityTypeCustom
+local PIXELATION_TO_BLACK_FRAMES = ____constants.PIXELATION_TO_BLACK_FRAMES
 local ____openClose = require("src.features.customTrapdoor.openClose")
 local checkCustomTrapdoorOpenClose = ____openClose.checkCustomTrapdoorOpenClose
 local ____touched = require("src.features.customTrapdoor.touched")
@@ -46970,7 +47035,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "11.2.3",
+    version = "12.0.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/package.lua

@@ -1,6 +1,6 @@
 return {
     name = "isaacscript-common",
-    version = "11.2.3",
+    version = "12.0.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/src/features/customStage/backdrop.lua

@@ -27,8 +27,8 @@ local trimPrefix = ____string.trimPrefix
 local ____utils = require("src.functions.utils")
 local erange = ____utils.erange
 local irange = ____utils.irange
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____constants = require("src.features.customStage.constants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____constants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
 function getBackdropPNGPath(self, customStage, backdropKind, rng)
     local backdrop = customStage.backdropPNGPaths == nil and DEFAULT_BACKDROP or customStage.backdropPNGPaths
     local pathArray = backdrop[backdropKind]

package/dist/src/features/customStage/{customStageConstants.d.ts → constants.d.ts}

@@ -11,4 +11,4 @@ export declare enum UIStreakAnimation {
 export declare const UI_STREAK_ANIMATION_END_FRAMES: {
     readonly [key in UIStreakAnimation]: int;
 };
-//# sourceMappingURL=customStageConstants.d.ts.map
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/features/customStage/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/constants.ts"],"names":[],"mappings":";AAAA,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,uCAAuC;AACvC,oBAAY,iBAAiB;IAC3B,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,SAAS,IAAA;CACV;AAED,uCAAuC;AACvC,eAAO,MAAM,8BAA8B,EAAE;IAC3C,QAAQ,EAAE,GAAG,IAAI,iBAAiB,GAAG,GAAG;CAKhC,CAAC"}

package/dist/src/features/customStage/init.lua

@@ -19,8 +19,8 @@ local ____exports = require("src.features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("src.features.customStage.backdrop")
 local setCustomStageBackdrop = ____backdrop.setCustomStageBackdrop
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local CUSTOM_STAGE_FEATURE_NAME = ____customStageConstants.CUSTOM_STAGE_FEATURE_NAME
+local ____constants = require("src.features.customStage.constants")
+local CUSTOM_STAGE_FEATURE_NAME = ____constants.CUSTOM_STAGE_FEATURE_NAME
 local ____customStageGridEntities = require("src.features.customStage.customStageGridEntities")
 local convertVanillaTrapdoors = ____customStageGridEntities.convertVanillaTrapdoors
 local removeUrnRewards = ____customStageGridEntities.removeUrnRewards

package/dist/src/features/customStage/shadows.lua

@@ -10,8 +10,8 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local spawnEffectWithSeed = ____entitiesSpecific.spawnEffectWithSeed
 local ____string = require("src.functions.string")
 local removeCharactersBefore = ____string.removeCharactersBefore
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____constants = require("src.features.customStage.constants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____constants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
 local ____v = require("src.features.customStage.v")
 local v = ____v.default
 --- Normally, we would make a custom entity to represent a shadow effect, but we don't want to

package/dist/src/features/customStage/streakText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streakText.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/streakText.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAuEnE,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AA0FD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAYN;AA0ED,wBAAgB,kBAAkB,IAAI,IAAI,CAWzC"}
+{"version":3,"file":"streakText.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/streakText.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAoEnE,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AA0FD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAYN;AA0ED,wBAAgB,kBAAkB,IAAI,IAAI,CAWzC"}

package/dist/src/features/customStage/streakText.lua

@@ -16,9 +16,9 @@ local getEnumValues = ____enums.getEnumValues
 local ____ui = require("src.functions.ui")
 local getScreenBottomCenterPos = ____ui.getScreenBottomCenterPos
 local getScreenTopCenterPos = ____ui.getScreenTopCenterPos
-local ____customStageConstants = require("src.features.customStage.customStageConstants")
-local UIStreakAnimation = ____customStageConstants.UIStreakAnimation
-local UI_STREAK_ANIMATION_END_FRAMES = ____customStageConstants.UI_STREAK_ANIMATION_END_FRAMES
+local ____constants = require("src.features.customStage.constants")
+local UIStreakAnimation = ____constants.UIStreakAnimation
+local UI_STREAK_ANIMATION_END_FRAMES = ____constants.UI_STREAK_ANIMATION_END_FRAMES
 local ____v = require("src.features.customStage.v")
 local v = ____v.default
 function checkEndTopStreakText(self)

package/dist/src/features/customStage/v.d.ts

@@ -1,6 +1,6 @@
 import { ControllerIndex } from "isaac-typescript-definitions";
 import { CustomStage } from "../../interfaces/private/CustomStage";
-import { UIStreakAnimation } from "./customStageConstants";
+import { UIStreakAnimation } from "./constants";
 declare const v: {
     run: {
         currentCustomStage: CustomStage | null;

package/dist/src/features/customStage/v.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/v.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,QAAA,MAAM,CAAC;;;QAIH,iDAAiD;;;QAKjD,oFAAoF;;;;;;;;;;;;;;;;;CAqBvF,CAAC;AACF,eAAe,CAAC,CAAC;AAEjB,oCAAoC;AACpC,eAAO,MAAM,eAAe,0BAAiC,CAAC;AAE9D,+BAA+B;AAC/B,eAAO,MAAM,yBAAyB,mCAAuC,CAAC"}
+{"version":3,"file":"v.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/v.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,QAAA,MAAM,CAAC;;;QAIH,iDAAiD;;;QAKjD,oFAAoF;;;;;;;;;;;;;;;;;CAqBvF,CAAC;AACF,eAAe,CAAC,CAAC;AAEjB,oCAAoC;AACpC,eAAO,MAAM,eAAe,0BAAiC,CAAC;AAE9D,+BAA+B;AAC/B,eAAO,MAAM,yBAAyB,mCAAuC,CAAC"}