isaacscript-common 6.2.1 → 6.5.0

package/features/debugDisplay/v.lua

@@ -10,6 +10,15 @@ end
 function defaultGridEntityDisplayCallback(self, gridEntity)
     return getGridEntityID(nil, gridEntity)
 end
+local debugDisplayEnabled = false
+function ____exports.setDebugDisplayEnabled(self)
+    debugDisplayEnabled = true
+end
+function ____exports.errorIfDebugDisplayNotInitialized(self)
+    if not debugDisplayEnabled then
+        error("The \"debugDisplay\" feature is not initialized. You must run the \"enableExtraConsoleCommands\" function once at the beginning of your mod in order for this feature to work.")
+    end
+end
 local v = {run = {
     player = false,
     tear = false,

package/features/deployJSONRoom.lua

@@ -28,6 +28,7 @@ local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNot
 local ____array = require("functions.array")
 local emptyArray = ____array.emptyArray
 local ____entity = require("functions.entity")
+local getEntityIDFromConstituents = ____entity.getEntityIDFromConstituents
 local removeAllMatchingEntities = ____entity.removeAllMatchingEntities
 local spawn = ____entity.spawn
 local spawnWithSeed = ____entity.spawnWithSeed
@@ -39,6 +40,7 @@ local ____gridEntity = require("functions.gridEntity")
 local convertXMLGridEntityType = ____gridEntity.convertXMLGridEntityType
 local getAllGridIndexes = ____gridEntity.getAllGridIndexes
 local getGridEntities = ____gridEntity.getGridEntities
+local getGridEntityIDFromConstituents = ____gridEntity.getGridEntityIDFromConstituents
 local removeAllGridExcept = ____gridEntity.removeAllGridExcept
 local removeGrid = ____gridEntity.removeGrid
 local setGridEntityInvisible = ____gridEntity.setGridEntityInvisible
@@ -239,7 +241,8 @@ function spawnAllEntities(self, jsonRoom, rng, verbose)
         end
         if entityType >= 1000 then
             if verbose then
-                log(((((((("Spawning grid entity " .. tostring(entityType)) .. ".") .. tostring(variant)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
+                local gridEntityID = getGridEntityIDFromConstituents(nil, entityType, variant)
+                log(((((("Spawning grid entity " .. gridEntityID) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
             end
             spawnGridEntityForJSONRoom(
                 nil,
@@ -250,7 +253,8 @@ function spawnAllEntities(self, jsonRoom, rng, verbose)
             )
         else
             if verbose then
-                log(((((((((("Spawning normal entity " .. tostring(entityType)) .. ".") .. tostring(variant)) .. ".") .. tostring(subType)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
+                local entityID = getEntityIDFromConstituents(nil, entityType, variant, subType)
+                log(((((("Spawning normal entity " .. entityID) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
             end
             local entity = spawnNormalEntityForJSONRoom(
                 nil,

package/features/extraConsoleCommands/init.lua

@@ -1,7 +1,7 @@
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local ____exports = {}
-local initMap, initCallbacks, postUpdate, evaluateCacheFireDelay, evaluateCacheSpeed, entityTakeDmgPlayer, postCurseEval, executeCmd, postFireTear
+local initMap, initCallbacks, postUpdate, evaluateCacheFireDelay, evaluateCacheSpeed, evaluateCacheFlying, entityTakeDmgPlayer, postCurseEval, executeCmd, postFireTear
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
@@ -72,6 +72,7 @@ function initMap(self)
     extraConsoleCommandsFunctionMap:set("eternalHearts", commands.eternalHearts)
     extraConsoleCommandsFunctionMap:set("familiarDisplay", commandsDisplay.familiarDisplay)
     extraConsoleCommandsFunctionMap:set("familiarsDisplay", commandsDisplay.familiarsDisplay)
+    extraConsoleCommandsFunctionMap:set("flight", commands.flight)
     extraConsoleCommandsFunctionMap:set("fool", commands.fool)
     extraConsoleCommandsFunctionMap:set("getPosition", commands.getPosition)
     extraConsoleCommandsFunctionMap:set("gigaBomb", commands.gigaBomb)
@@ -83,6 +84,7 @@ function initMap(self)
     extraConsoleCommandsFunctionMap:set("goldenKey", commands.goldenKey)
     extraConsoleCommandsFunctionMap:set("grid", commands.grid)
     extraConsoleCommandsFunctionMap:set("grid2", commands.grid2)
+    extraConsoleCommandsFunctionMap:set("gridCosts", commands.gridCosts)
     extraConsoleCommandsFunctionMap:set("gridEntities", commands.gridEntities)
     extraConsoleCommandsFunctionMap:set("h", commands.h)
     extraConsoleCommandsFunctionMap:set("hearts", commands.hearts)
@@ -167,6 +169,7 @@ function initMap(self)
     extraConsoleCommandsFunctionMap:set("trapdoor", commands.trapdoorCommand)
     extraConsoleCommandsFunctionMap:set("treasure", commands.treasure)
     extraConsoleCommandsFunctionMap:set("ultraSecret", commands.ultraSecret)
+    extraConsoleCommandsFunctionMap:set("unseed", commands.unseed)
     extraConsoleCommandsFunctionMap:set("up", commands.up)
     extraConsoleCommandsFunctionMap:set("warp", commands.warp)
 end
@@ -174,6 +177,7 @@ function initCallbacks(self, mod)
     mod:AddCallback(ModCallback.POST_UPDATE, postUpdate)
     mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheFireDelay, CacheFlag.FIRE_DELAY)
     mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheSpeed, CacheFlag.SPEED)
+    mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheFlying, CacheFlag.FLYING)
     mod:AddCallback(ModCallback.ENTITY_TAKE_DMG, entityTakeDmgPlayer, EntityType.PLAYER)
     mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)
     mod:AddCallback(ModCallback.EXECUTE_CMD, executeCmd)
@@ -195,6 +199,11 @@ function evaluateCacheSpeed(self, player)
         player.MoveSpeed = MAX_SPEED_STAT
     end
 end
+function evaluateCacheFlying(self, player)
+    if v.run.flight then
+        player.CanFly = true
+    end
+end
 function entityTakeDmgPlayer(self)
     if v.run.spamBloodRights then
         return false

package/features/extraConsoleCommands/listCommands.d.ts

@@ -65,7 +65,10 @@ export declare function card(params: string): void;
 export declare function cards(): void;
 /** Alias for the "chaosCardTears" command. */
 export declare function cc(): void;
-/** Toggles Chaos Card tears. Useful for killing enemies very fast without using "debug 10". */
+/**
+ * Toggles Chaos Card tears for the player. Useful for killing enemies very fast without using
+ * "debug 10".
+ */
 export declare function chaosCardTears(): void;
 /**
  * Restart as the specified character. Accepts either the character sub-type or the partial name of
@@ -96,7 +99,7 @@ export declare function crawlSpace(): void;
 export declare function d20(): void;
 /** Uses the D6. */
 export declare function d6(): void;
-/** Toggles extremely high-damage tears. */
+/** Toggles extremely high-damage tears for the player. */
 export declare function damage(): void;
 /** Alias for the "devil" command. */
 export declare function dd(): void;
@@ -124,6 +127,8 @@ export declare function error(): void;
  * numbers to remove hearts.)
  */
 export declare function eternalHearts(params: string): void;
+/** Toggles flight for the player. */
+export declare function flight(params: string): void;
 /** Alias for the "startingRoom" command. */
 export declare function fool(): void;
 /** Prints the current position of all players. */
@@ -148,10 +153,15 @@ export declare function goldenBomb(): void;
 export declare function goldenHearts(params: string): void;
 /** Gives the player a golden key. */
 export declare function goldenKey(): void;
-/** Alias for the "debug 2" command. */
+/**
+ * Alias for the "debug 11" command. Useful for seeing the coordinates and grid index of each tile
+ * in the room.
+ */
 export declare function grid(): void;
-/** Alias for the "debug 11" command. */
+/** Alias for the "gridCosts" command. */
 export declare function grid2(): void;
+/** Alias for the "debug 2" command. Useful for seeing the grid costs of each tile in the room. */
+export declare function gridCosts(): void;
 /** Spawns every grid entity, starting at the top-left-most tile. */
 export declare function gridEntities(): void;
 /** Alias for the "hearts" command. */
@@ -324,13 +334,16 @@ export declare function sounds(): void;
 export declare function spam(): void;
 /** Spawns a golden version of the specified trinket type. */
 export declare function spawnGoldenTrinket(params: string): void;
-/** Toggles maximum movement speed and flight. */
+/** Toggles maximum movement speed and flight for the player. */
 export declare function speed(): void;
 /** Warps to the starting room of the floor. */
 export declare function startingRoom(): void;
 /** Warps to the first Super Secret Room on the floor. */
 export declare function superSecret(): void;
-/** Toggles extremely high tears stat (e.g. fire rate), equivalent of that to soy milk. */
+/**
+ * Toggles an extremely high tears stat (e.g. fire rate) for the player, equivalent of that to soy
+ * milk.
+ */
 export declare function tears(): void;
 /** Creates a trapdoor next to the player. */
 export declare function trapdoorCommand(): void;
@@ -338,6 +351,8 @@ export declare function trapdoorCommand(): void;
 export declare function treasure(): void;
 /** Warps to the first Ultra Secret Room on the floor. */
 export declare function ultraSecret(): void;
+/** If currently on a set seed, changes to an unseeded state and restarts the game. */
+export declare function unseed(): void;
 /** Moves the player 0.5 units up. Provide a number to move a custom amount of units. */
 export declare function up(params: string): void;
 /**

package/features/extraConsoleCommands/listCommands.lua

@@ -64,7 +64,9 @@ local spawnTrinket = ____pickups.spawnTrinket
 local ____pills = require("functions.pills")
 local getPillEffectName = ____pills.getPillEffectName
 local ____player = require("functions.player")
+local addCollectibleCostume = ____player.addCollectibleCostume
 local getPlayerName = ____player.getPlayerName
+local removeCollectibleCostume = ____player.removeCollectibleCostume
 local useActiveItemTemp = ____player.useActiveItemTemp
 local ____playerIndex = require("functions.playerIndex")
 local getPlayers = ____playerIndex.getPlayers
@@ -74,7 +76,9 @@ local ____rooms = require("functions.rooms")
 local changeRoom = ____rooms.changeRoom
 local getRoomGridIndexesForType = ____rooms.getRoomGridIndexesForType
 local ____run = require("functions.run")
+local onSetSeed = ____run.onSetSeed
 local restart = ____run.restart
+local setUnseeded = ____run.setUnseeded
 local ____trinkets = require("functions.trinkets")
 local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
 local ____utils = require("functions.utils")
@@ -104,7 +108,8 @@ local v = ____v.default
 function ____exports.blackHearts(self, params)
     addHeart(nil, params, HealthType.BLACK)
 end
---- Toggles Chaos Card tears. Useful for killing enemies very fast without using "debug 10".
+--- Toggles Chaos Card tears for the player. Useful for killing enemies very fast without using
+-- "debug 10".
 function ____exports.chaosCardTears(self)
     v.run.chaosCardTears = not v.run.chaosCardTears
     printEnabled(nil, v.run.chaosCardTears, "Chaos Card tears")
@@ -134,6 +139,10 @@ function ____exports.goldenKey(self)
     local player = Isaac.GetPlayer()
     player:AddGoldenKey()
 end
+--- Alias for the "debug 2" command. Useful for seeing the grid costs of each tile in the room.
+function ____exports.gridCosts(self)
+    Isaac.ExecuteCommand("debug 2")
+end
 --- Gives a half red heart. Provide a number to give a custom amount of hearts. (You can use negative
 -- numbers to remove hearts.)
 function ____exports.hearts(self, params)
@@ -480,7 +489,7 @@ function ____exports.d6(self)
     local player = Isaac.GetPlayer()
     useActiveItemTemp(nil, player, CollectibleType.D6)
 end
---- Toggles extremely high-damage tears.
+--- Toggles extremely high-damage tears for the player.
 function ____exports.damage(self)
     v.run.maxDamage = not v.run.maxDamage
     printEnabled(nil, v.run.maxDamage, "debug damage")
@@ -520,6 +529,25 @@ end
 function ____exports.error(self)
     ____exports.iAmError(nil)
 end
+--- Toggles flight for the player.
+function ____exports.flight(self, params)
+    local player = Isaac.GetPlayer()
+    v.run.flight = not v.run.flight
+    if params == "true" then
+        v.run.flight = true
+    elseif params == "false" then
+        v.run.flight = false
+    end
+    player:AddCacheFlags(CacheFlag.FLYING)
+    player:EvaluateItems()
+    local collectibleUsedToShowFlight = CollectibleType.FATE
+    if v.run.flight then
+        addCollectibleCostume(nil, player, collectibleUsedToShowFlight)
+    else
+        removeCollectibleCostume(nil, player, collectibleUsedToShowFlight)
+    end
+    printEnabled(nil, v.run.maxSpeed, "max speed")
+end
 --- Alias for the "startingRoom" command.
 function ____exports.fool(self)
     ____exports.startingRoom(nil)
@@ -561,13 +589,14 @@ end
 function ____exports.goldKey(self)
     ____exports.goldenKey(nil)
 end
---- Alias for the "debug 2" command.
+--- Alias for the "debug 11" command. Useful for seeing the coordinates and grid index of each tile
+-- in the room.
 function ____exports.grid(self)
-    Isaac.ExecuteCommand("debug 2")
+    Isaac.ExecuteCommand("debug 11")
 end
---- Alias for the "debug 11" command.
+--- Alias for the "gridCosts" command.
 function ____exports.grid2(self)
-    Isaac.ExecuteCommand("debug 11")
+    ____exports.gridCosts(nil)
 end
 --- Spawns every grid entity, starting at the top-left-most tile.
 function ____exports.gridEntities(self)
@@ -1018,29 +1047,22 @@ function ____exports.spawnGoldenTrinket(self, params)
     local centerPos = room:GetCenterPos()
     spawnTrinket(nil, goldenTrinketType, centerPos)
 end
---- Toggles maximum movement speed and flight.
+--- Toggles maximum movement speed and flight for the player.
 function ____exports.speed(self)
     local player = Isaac.GetPlayer()
     v.run.maxSpeed = not v.run.maxSpeed
-    if v.run.maxSpeed and not player.CanFly then
-        local numEternalHearts = player:GetEternalHearts()
-        if numEternalHearts == 0 then
-            player:AddCollectible(CollectibleType.FATE)
-            player:AddEternalHearts(-1)
-        else
-            player:AddEternalHearts(-1)
-            player:AddCollectible(CollectibleType.FATE)
-        end
-    end
     player:AddCacheFlags(CacheFlag.SPEED)
     player:EvaluateItems()
-    printEnabled(nil, v.run.maxSpeed, "max speed")
+    local value = tostring(v.run.maxSpeed)
+    ____exports.flight(nil, value)
+    printEnabled(nil, v.run.maxSpeed, "max speed and flight")
 end
 --- Warps to the first Super Secret Room on the floor.
 function ____exports.superSecret(self)
     warpToRoomType(nil, RoomType.SUPER_SECRET)
 end
---- Toggles extremely high tears stat (e.g. fire rate), equivalent of that to soy milk.
+--- Toggles an extremely high tears stat (e.g. fire rate) for the player, equivalent of that to soy
+-- milk.
 function ____exports.tears(self)
     v.run.maxTears = not v.run.maxTears
     local player = Isaac.GetPlayer()
@@ -1060,6 +1082,15 @@ end
 function ____exports.ultraSecret(self)
     warpToRoomType(nil, RoomType.ULTRA_SECRET)
 end
+--- If currently on a set seed, changes to an unseeded state and restarts the game.
+function ____exports.unseed(self)
+    if not onSetSeed(nil) then
+        printConsole(nil, "You are not on a set seed, so you cannot unseed the run.")
+        return
+    end
+    setUnseeded(nil)
+    restart(nil)
+end
 --- Moves the player 0.5 units up. Provide a number to move a custom amount of units.
 function ____exports.up(self, params)
     movePlayer(nil, params, Direction.UP)

package/features/extraConsoleCommands/v.d.ts

@@ -8,6 +8,7 @@ declare const v: {
         maxDamage: boolean;
         maxSpeed: boolean;
         maxTears: boolean;
+        flight: boolean;
     };
 };
 export default v;

package/features/extraConsoleCommands/v.lua

@@ -7,7 +7,8 @@ local v = {persistent = {disableCurses = false}, run = {
     spamBloodRights = false,
     maxDamage = false,
     maxSpeed = false,
-    maxTears = false
+    maxTears = false,
+    flight = false
 }}
 ____exports.default = v
 --- The contents of the map are initialized in the "init.ts" file.

package/features/pause.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Helper function to emulate what happens when the player pauses the game. Use the `unpause`
+ * function to return things back to normal.
+ *
+ * Under the hood, this function:
+ * - uses the Pause collectible on every game frame
+ * - disables any player inputs (except for `ButtonAction.MENU_CONFIRM`)
+ */
+export declare function pause(): void;
+/** Helper function to put things back to normal after the `pause` function was used. */
+export declare function unpause(): void;

package/features/pause.lua

@@ -0,0 +1,71 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postUpdate, inputActionGetActionValue, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local InputHook = ____isaac_2Dtypescript_2Ddefinitions.InputHook
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____log = require("functions.log")
+local logError = ____log.logError
+local ____player = require("functions.player")
+local useActiveItemTemp = ____player.useActiveItemTemp
+local ____disableInputs = require("features.disableInputs")
+local disableAllInputsExceptFor = ____disableInputs.disableAllInputsExceptFor
+local enableAllInputs = ____disableInputs.enableAllInputs
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postUpdate(self)
+    if not v.run.isPseudoPaused then
+        return
+    end
+    local player = Isaac.GetPlayer()
+    useActiveItemTemp(nil, player, CollectibleType.PAUSE)
+end
+function inputActionGetActionValue(self, _entity, _inputHook, buttonAction)
+    if buttonAction ~= ButtonAction.SHOOT_RIGHT then
+        return
+    end
+    if not v.run.shouldUnpause then
+        return
+    end
+    v.run.shouldUnpause = false
+    return 1
+end
+local FEATURE_NAME = "pause"
+v = {run = {isPseudoPaused = false, shouldUnpause = false}}
+---
+-- @internal
+function ____exports.pauseInit(self, mod)
+    saveDataManager(nil, FEATURE_NAME, v)
+    mod:AddCallback(ModCallback.POST_UPDATE, postUpdate)
+    mod:AddCallback(ModCallback.INPUT_ACTION, inputActionGetActionValue, InputHook.GET_ACTION_VALUE)
+end
+--- Helper function to emulate what happens when the player pauses the game. Use the `unpause`
+-- function to return things back to normal.
+-- 
+-- Under the hood, this function:
+-- - uses the Pause collectible on every game frame
+-- - disables any player inputs (except for `ButtonAction.MENU_CONFIRM`)
+function ____exports.pause(self)
+    if v.run.isPseudoPaused then
+        logError("Failed to pseudo-pause the game, since it was already pseudo-paused.")
+        return
+    end
+    v.run.isPseudoPaused = true
+    local whitelist = __TS__New(Set, {ButtonAction.MENU_CONFIRM})
+    disableAllInputsExceptFor(nil, FEATURE_NAME, whitelist)
+end
+--- Helper function to put things back to normal after the `pause` function was used.
+function ____exports.unpause(self)
+    if not v.run.isPseudoPaused then
+        logError("Failed to pseudo-unpause the game, since it was not already pseudo-paused.")
+        return
+    end
+    v.run.isPseudoPaused = false
+    enableAllInputs(nil, FEATURE_NAME)
+    v.run.shouldUnpause = true
+end
+return ____exports

package/features/runNextRoom.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Supply a function to run on the next `POST_NEW_ROOM` callback.
+ *
+ * Note that this function will not handle saving and quitting. If a player saving and quitting
+ * before the deferred function fires would cause a bug in your mod, then you should handle deferred
+ * functions manually using serializable data.
+ */
+export declare function runNextRoom(func: () => void): void;

package/features/runNextRoom.lua

@@ -0,0 +1,40 @@
+local ____exports = {}
+local postNewRoomReordered, v
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____array = require("functions.array")
+local emptyArray = ____array.emptyArray
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postNewRoomReordered(self)
+    for ____, func in ipairs(v.run.queuedFunctions) do
+        func(nil)
+    end
+    emptyArray(nil, v.run.queuedFunctions)
+end
+local FEATURE_NAME = "runNextRoom"
+v = {run = {queuedFunctions = {}}}
+---
+-- @internal
+function ____exports.runNextRoomInit(self, mod)
+    saveDataManager(
+        nil,
+        FEATURE_NAME,
+        v,
+        function() return false end
+    )
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
+end
+--- Supply a function to run on the next `POST_NEW_ROOM` callback.
+-- 
+-- Note that this function will not handle saving and quitting. If a player saving and quitting
+-- before the deferred function fires would cause a bug in your mod, then you should handle deferred
+-- functions manually using serializable data.
+function ____exports.runNextRoom(self, func)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local ____v_run_queuedFunctions_0 = v.run.queuedFunctions
+    ____v_run_queuedFunctions_0[#____v_run_queuedFunctions_0 + 1] = func
+end
+return ____exports

package/features/saveDataManager/exports.lua

@@ -11,8 +11,6 @@ local ____deepCopy = require("functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
 local ____types = require("functions.types")
 local isString = ____types.isString
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local ____main = require("features.saveDataManager.main")
 local forceSaveDataManagerLoad = ____main.forceSaveDataManagerLoad
 local forceSaveDataManagerSave = ____main.forceSaveDataManagerSave
@@ -21,6 +19,8 @@ local ____maps = require("features.saveDataManager.maps")
 local saveDataConditionalFuncMap = ____maps.saveDataConditionalFuncMap
 local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
 local saveDataMap = ____maps.saveDataMap
+local ____saveDataManagerConstants = require("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)

package/features/saveDataManager/load.lua

@@ -12,11 +12,11 @@ local iterateTableInOrder = ____table.iterateTableInOrder
 local ____types = require("functions.types")
 local isString = ____types.isString
 local isTable = ____types.isTable
-local ____constants = require("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("features.saveDataManager.merge")
 local merge = ____merge.merge
+local ____saveDataManagerConstants = require("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)

package/features/saveDataManager/main.lua

@@ -21,9 +21,6 @@ local logError = ____log.logError
 local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local iterateTableInOrder = ____table.iterateTableInOrder
-local ____constants = require("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 ____load = require("features.saveDataManager.load")
 local loadFromDisk = ____load.loadFromDisk
 local ____maps = require("features.saveDataManager.maps")
@@ -32,6 +29,9 @@ local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
 local saveDataMap = ____maps.saveDataMap
 local ____save = require("features.saveDataManager.save")
 local saveToDisk = ____save.saveToDisk
+local ____saveDataManagerConstants = require("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 postPlayerInit(self)
     if mod == nil then
         error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")

package/features/saveDataManager/merge.lua

@@ -26,8 +26,8 @@ local ____types = require("functions.types")
 local isTable = ____types.isTable
 local ____utils = require("functions.utils")
 local getTraversalDescription = ____utils.getTraversalDescription
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
 local ____serializationBrand = require("features.saveDataManager.serializationBrand")
 local isSerializationBrand = ____serializationBrand.isSerializationBrand
 --- `merge` takes the values from a new table and recursively merges them into an old object (while

package/features/saveDataManager/save.lua

@@ -13,9 +13,9 @@ local ____log = require("functions.log")
 local log = ____log.log
 local ____table = require("functions.table")
 local iterateTableInOrder = ____table.iterateTableInOrder
-local ____constants = require("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 ____saveDataManagerConstants = require("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 getAllSaveDataToWriteToDisk(self, saveDataMap, saveDataConditionalFuncMap)
     local allSaveData = {}
     iterateTableInOrder(

package/functions/chargeBar.lua

@@ -1,7 +1,5 @@
 local ____exports = {}
 local getChargeBarClamp
-local ____constants = require("constants")
-local VectorZero = ____constants.VectorZero
 function getChargeBarClamp(self, charges, maxCharges)
     local meterMultiplier = 24 / maxCharges
     local meterClip = 26 - charges * meterMultiplier
@@ -37,11 +35,11 @@ end
 --- Helper function to render a charge bar on the screen. First, call the `newChargeBarSprites`
 -- function to initialize the sprites, and then call this function on every render frame.
 function ____exports.renderChargeBar(self, sprites, position, normalCharges, batteryCharges)
-    sprites.back:Render(position, VectorZero, VectorZero)
+    sprites.back:Render(position)
     local normalChargesClamp = getChargeBarClamp(nil, normalCharges, sprites.maxCharges)
-    sprites.meter:Render(position, normalChargesClamp, VectorZero)
+    sprites.meter:Render(position, normalChargesClamp)
     local batteryChargesClamp = getChargeBarClamp(nil, batteryCharges, sprites.maxCharges)
-    sprites.meterBattery:Render(position, batteryChargesClamp, VectorZero)
-    sprites.lines:Render(position, VectorZero, VectorZero)
+    sprites.meterBattery:Render(position, batteryChargesClamp)
+    sprites.lines:Render(position)
 end
 return ____exports

package/functions/color.d.ts

@@ -19,8 +19,6 @@ export declare function colorEquals(color1: Color, color2: Color): boolean;
  */
 export declare function copyColor<C extends Color | SerializedColor, S extends SerializationType>(color: C, serializationType: S): CopyColorReturn[S];
 export declare function copyColor<C extends Color | SerializedColor>(color: C): CopyColorReturn[SerializationType.NONE];
-/** Returns `Color(1, 1, 1)`. */
-export declare function getDefaultColor(): Color;
 /** Helper function to check if something is an instantiated Color object. */
 export declare function isColor(object: unknown): object is Color;
 /**

package/functions/color.lua

@@ -104,10 +104,6 @@ function ____exports.copyColor(self, color, serializationType)
         end
     until true
 end
---- Returns `Color(1, 1, 1)`.
-function ____exports.getDefaultColor(self)
-    return Color(1, 1, 1)
-end
 --- Used to determine is the given table is a serialized `Color` object created by the save data
 -- manager and/or the `deepCopy` function.
 function ____exports.isSerializedColor(self, object)

package/functions/deepCopy.lua

@@ -15,8 +15,8 @@ local ____SerializationBrand = require("enums.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____SerializationType = require("enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
 local ____serializationBrand = require("features.saveDataManager.serializationBrand")
 local isSerializationBrand = ____serializationBrand.isSerializationBrand
 local ____array = require("functions.array")

package/functions/direction.d.ts

@@ -8,5 +8,5 @@ import { Direction } from "isaac-typescript-definitions";
  */
 export declare function angleToDirection(angleDegrees: int): Direction;
 export declare function directionToDegrees(direction: Direction): int;
-export declare function directionToVector(direction: Direction): Vector;
+export declare function directionToVector(direction: Direction): Readonly<Vector>;
 export declare function getDirectionName(direction: Direction): string | undefined;