isaacscript-common 11.2.4 → 12.0.0

package/dist/index.d.ts

@@ -10414,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.4
+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(...) 
@@ -30051,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")
@@ -31355,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
@@ -31496,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)
@@ -31536,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
     )
@@ -31566,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(...) 
@@ -31583,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(
@@ -31623,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
@@ -31644,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)
@@ -31692,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)
@@ -31738,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)
@@ -31773,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
@@ -31781,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)
@@ -31854,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.
@@ -39625,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"
@@ -39671,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]
@@ -40164,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
@@ -40247,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()
@@ -40350,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")
@@ -40394,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
@@ -40570,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,
@@ -41087,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
@@ -41288,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)
@@ -43522,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
@@ -43764,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
@@ -44318,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)
@@ -44491,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")
@@ -46959,7 +47035,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "11.2.4",
+    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.4",
+    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"}

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

@@ -2,8 +2,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,

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

@@ -42,9 +42,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

package/dist/src/features/customTrapdoor/{customTrapdoorConstants.d.ts → constants.d.ts}

@@ -16,4 +16,4 @@ export declare const ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL: ReadonlySet<string>;
 export declare const PIXELATION_TO_BLACK_FRAMES = 52;
 export declare const OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = 6;
 export declare const OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = 5;
-//# sourceMappingURL=customTrapdoorConstants.d.ts.map
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/features/customTrapdoor/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;CAEK,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,iCAAiC,QAA+B,CAAC;AAC9E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,eAAO,MAAM,oCAAoC,EAAE,WAAW,CAAC,MAAM,CAClC,CAAC;AAEpC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,eAAO,MAAM,4CAA4C,IAAI,CAAC;AAC9D,eAAO,MAAM,+CAA+C,IAAI,CAAC"}

package/dist/src/features/customTrapdoor/exports.lua

@@ -4,8 +4,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

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

@@ -41,10 +41,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")

package/dist/src/features/customTrapdoor/openClose.lua

@@ -10,10 +10,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()