isaacscript-common 9.19.0 → 9.19.3

package/dist/src/features/runNextRoom.lua

@@ -0,0 +1,35 @@
+local ____exports = {}
+local postNewRoomReordered, v
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____featuresInitialized = require("src.featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____array = require("src.functions.array")
+local emptyArray = ____array.emptyArray
+local ____exports = require("src.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, false)
+    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/dist/src/features/saveDataManager/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EACpD,GAAG,EAAE,MAAM,EAAE,qEAAqE;AAClF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI,CAAC;AACR,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,kEAAkE;AAC/E,CAAC,EAAE,QAAQ,EACX,eAAe,EAAE,KAAK,GACrB,IAAI,CAAC;AA+CR;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAQD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,WAAW,GAC1B,IAAI,CAiBN"}

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

@@ -0,0 +1,189 @@
+local ____lualib = require("lualib_bundle")
+local __TS__TypeOf = ____lualib.__TS__TypeOf
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
+local ____exports = {}
+local ____SerializationType = require("src.enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____featuresInitialized = require("src.featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____deepCopy = require("src.functions.deepCopy")
+local deepCopy = ____deepCopy.deepCopy
+local ____types = require("src.functions.types")
+local isString = ____types.isString
+local ____main = require("src.features.saveDataManager.main")
+local forceSaveDataManagerLoad = ____main.forceSaveDataManagerLoad
+local forceSaveDataManagerSave = ____main.forceSaveDataManagerSave
+local restoreDefaultSaveData = ____main.restoreDefaultSaveData
+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)
+-- 2. automatic saving and loading of all tracked data to the "save#.dat" file
+-- 
+-- You feed this function with an object containing your variables, and then it will automatically
+-- manage them for you. (See below for an example.)
+-- 
+-- The save data manager is meant to be called once for each feature of your mod. In other words,
+-- you should not put all of the data for your mod on the same object. Instead, scope your variables
+-- locally to a single file that contains a mod feature, and then call this function to register
+-- them. For example:
+-- 
+-- ```ts
+-- // in file: feature1.ts
+-- import { saveDataManager } from "isaacscript-common";
+-- 
+-- // Declare local variables for this file or feature.
+-- const v = {
+--   // These variables are never reset; manage them yourself at will.
+--   persistent: {
+--     foo1: 0,
+--   },
+-- 
+--   // These variables are reset at the beginning of every run.
+--   run: {
+--     foo2: 0,
+--   },
+-- 
+--   // These variables are reset at the beginning of every level.
+--   level: {
+--     foo3: 0,
+--   },
+-- 
+--   // These variables are reset at the beginning of every room.
+--   room: {
+--     foo4: 0,
+--   },
+-- };
+-- // Every child object is optional; only create the ones that you need.
+-- 
+-- // Register the variables with the save data manager. (We need to provide a string key that
+-- // matches the name of this file.)
+-- function feature1Init() {
+--   saveDataManager("feature1", v);
+-- }
+-- 
+-- // Elsewhere in the file, use your variables.
+-- function feature1Function() {
+--   if (v.run.foo1 > 0) {
+--     // Insert code here.
+--   }
+-- }
+-- ```
+-- 
+-- - Save data is loaded from disk in the `POST_PLAYER_INIT` callback (i.e. the first callback that
+--   can possibly run).
+-- - Save data is recorded to disk in the `PRE_GAME_EXIT` callback.
+-- 
+-- You can put lots of data types on your variable objects, but not everything is supported. For the
+-- specific things that are supported, see the documentation for the `deepCopy` helper function.
+-- 
+-- Note that before using the save data manager, you must call the `upgradeMod` function. (Upgrade
+-- your mod before registering any of your own callbacks so that the save data manager will run
+-- before any of your code does.)
+-- 
+-- If you want the save data manager to load data before the `POST_PLAYER_INIT` callback (i.e. in
+-- the main menu), then you should explicitly call the `saveDataManagerLoad` function. (The save
+-- 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`.
+-- 
+-- @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.
+-- @param v An object that corresponds to the `SaveData` interface. The object is conventionally
+-- called "v" for brevity. ("v" is short for "local variables").
+-- @param conditionalFunc Optional. A function to run to check if this save data should be written
+-- to disk. Default is `() => true`, meaning that this save data will always
+-- be written to disk. Use a conditional function for the situations when the
+-- local variables are for a feature that the end-user can disable. (If the
+-- feature is disabled, then there would be no point in writing any of the
+-- variables to the "save#.dat" file.) You can also specify `false` to this
+-- argument in order to completely disable saving data. (Specifying `false`
+-- will allow you to use non-serializable objects in your save data, such as
+-- `EntityPtr`.
+function ____exports.saveDataManager(self, key, v, conditionalFunc)
+    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
+    if not isString(nil, key) then
+        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " requires that keys are strings. You tried to use a key of type: ") .. __TS__TypeOf(key))
+    end
+    if saveDataMap[key] ~= nil then
+        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " is already managing save data for a key of: ") .. key)
+    end
+    saveDataMap[key] = v
+    if conditionalFunc == false then
+        conditionalFunc = function() return false end
+    end
+    local saveDataKeys = __TS__ObjectKeys(v)
+    if #saveDataKeys == 1 and saveDataKeys[1] == "room" then
+        conditionalFunc = function() return false end
+    end
+    local saveDataCopy = deepCopy(nil, v, SerializationType.NONE, key)
+    saveDataDefaultsMap[key] = saveDataCopy
+    if conditionalFunc ~= nil then
+        saveDataConditionalFuncMap[key] = conditionalFunc
+    end
+end
+--- The save data manager will automatically load variables from disk at the appropriate times (i.e.
+-- when a new run is started). Use this function to explicitly force the save data manager to load
+-- all of its variables from disk immediately.
+-- 
+-- Obviously, doing this will overwrite the current data, so using this function can potentially
+-- result in lost state.
+function ____exports.saveDataManagerLoad(self)
+    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
+    forceSaveDataManagerLoad(nil)
+end
+--- The save data manager will automatically save variables to disk at the appropriate times (i.e.
+-- when the run is exited). Use this function to explicitly force the save data manager to write all
+-- of its variables to disk immediately.
+function ____exports.saveDataManagerSave(self)
+    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
+    forceSaveDataManagerSave(nil)
+end
+--- - Sets the global variable of "g" equal to all of the save data variables for this mod.
+-- - Sets the global variable of "gd" equal to all of the save data default variables for this mod.
+-- 
+-- This can make debugging easier, as you can access the variables from the game's debug console.
+-- e.g. `l print(g.feature1.foo)`
+function ____exports.saveDataManagerSetGlobal(self)
+    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
+    g = saveDataMap
+    gd = saveDataDefaultsMap
+end
+--- The save data manager will automatically reset variables at the appropriate times (i.e. when a
+-- player enters a new room). Use this function to explicitly force the save data manager to reset a
+-- specific variable group.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const v = {
+--   room: {
+--     foo: 123,
+--   },
+-- };
+-- 
+-- saveDataManager("file1", v);
+-- 
+-- // Then, later on, to explicit reset all of the "room" variables:
+-- saveDataManagerReset("file1", "room");
+-- ```
+function ____exports.saveDataManagerReset(self, key, childObjectKey)
+    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
+    if not isString(nil, key) then
+        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " requires that keys are strings. You tried to use a key of type: ") .. __TS__TypeOf(key))
+    end
+    local saveData = saveDataMap[key]
+    if saveData == nil then
+        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " is not managing save data for a key of: ") .. key)
+    end
+    restoreDefaultSaveData(nil, key, saveData, childObjectKey)
+end
+return ____exports

package/dist/src/features/saveDataManager/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/load.ts"],"names":[],"mappings":";;AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AASrD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GACpC,IAAI,CAqDN"}

package/dist/src/features/saveDataManager/load.lua

@@ -0,0 +1,75 @@
+local ____lualib = require("lualib_bundle")
+local __TS__StringTrim = ____lualib.__TS__StringTrim
+local ____exports = {}
+local readSaveDatFile, tryLoadModData, DEFAULT_MOD_DATA
+local ____jsonHelpers = require("src.functions.jsonHelpers")
+local jsonDecode = ____jsonHelpers.jsonDecode
+local ____log = require("src.functions.log")
+local log = ____log.log
+local logError = ____log.logError
+local ____table = require("src.functions.table")
+local iterateTableInOrder = ____table.iterateTableInOrder
+local ____types = require("src.functions.types")
+local isString = ____types.isString
+local isTable = ____types.isTable
+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)
+    if not ok then
+        logError(
+            nil,
+            (("Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg
+        )
+        return DEFAULT_MOD_DATA
+    end
+    if jsonStringOrErrMsg == nil then
+        return DEFAULT_MOD_DATA
+    end
+    local jsonStringTrimmed = __TS__StringTrim(jsonStringOrErrMsg)
+    if jsonStringTrimmed == "" then
+        return DEFAULT_MOD_DATA
+    end
+    return jsonStringTrimmed
+end
+function tryLoadModData(mod)
+    return mod:LoadData()
+end
+DEFAULT_MOD_DATA = "{}"
+function ____exports.loadFromDisk(self, mod, oldSaveData)
+    if not mod:HasData() then
+        return
+    end
+    local jsonString = readSaveDatFile(nil, mod)
+    local newSaveData = jsonDecode(nil, jsonString)
+    if SAVE_DATA_MANAGER_DEBUG then
+        log(nil, "Converted data from the \"save#.dat\" to a Lua table.")
+    end
+    iterateTableInOrder(
+        nil,
+        newSaveData,
+        function(____, key, value)
+            if not isString(nil, key) then
+                return
+            end
+            if not isTable(nil, value) then
+                return
+            end
+            local oldSaveDataForSubscriber = oldSaveData[key]
+            if oldSaveDataForSubscriber == nil then
+                return
+            end
+            if SAVE_DATA_MANAGER_DEBUG then
+                log(nil, "Merging in stored data for feature: " .. key)
+            end
+            merge(nil, oldSaveDataForSubscriber, value, key)
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+    log(nil, ("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " loaded data from the \"save#.dat\" file.")
+end
+return ____exports

package/dist/src/features/saveDataManager/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAsBrD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAUlE;AAqFD,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,IAAI,CA4CN;AAiBD,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}

package/dist/src/features/saveDataManager/main.lua

@@ -0,0 +1,135 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postPlayerInit, preGameExit, postNewLevel, postNewRoomEarly, restoreDefaultsAll, restoreDefaults, clearAndCopyAllElements, RESETTABLE_SAVE_DATA_KEYS, mod, loadedDataOnThisRun
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____SaveDataKey = require("src.enums.SaveDataKey")
+local SaveDataKey = ____SaveDataKey.SaveDataKey
+local ____SerializationType = require("src.enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____deepCopy = require("src.functions.deepCopy")
+local deepCopy = ____deepCopy.deepCopy
+local ____log = require("src.functions.log")
+local logError = ____log.logError
+local ____stage = require("src.functions.stage")
+local onFirstFloor = ____stage.onFirstFloor
+local ____table = require("src.functions.table")
+local clearTable = ____table.clearTable
+local iterateTableInOrder = ____table.iterateTableInOrder
+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 saveDataMap = ____maps.saveDataMap
+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 postPlayerInit(self)
+    if mod == nil then
+        error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")
+    end
+    if loadedDataOnThisRun then
+        return
+    end
+    loadedDataOnThisRun = true
+    loadFromDisk(nil, mod, saveDataMap)
+    local gameFrameCount = game:GetFrameCount()
+    local isContinued = gameFrameCount ~= 0
+    if not isContinued then
+        restoreDefaultsAll(nil)
+    end
+end
+function preGameExit(self)
+    if mod == nil then
+        error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")
+    end
+    saveToDisk(nil, mod, saveDataMap, saveDataConditionalFuncMap)
+    restoreDefaultsAll(nil)
+    loadedDataOnThisRun = false
+end
+function postNewLevel(self)
+    if mod == nil then
+        error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")
+    end
+    restoreDefaults(nil, SaveDataKey.LEVEL)
+    if not onFirstFloor(nil) then
+        saveToDisk(nil, mod, saveDataMap, saveDataConditionalFuncMap)
+    end
+end
+function postNewRoomEarly(self)
+    restoreDefaults(nil, SaveDataKey.ROOM)
+end
+function restoreDefaultsAll(self)
+    restoreDefaults(nil, SaveDataKey.RUN)
+    restoreDefaults(nil, SaveDataKey.LEVEL)
+    restoreDefaults(nil, SaveDataKey.ROOM)
+end
+function restoreDefaults(self, saveDataKey)
+    iterateTableInOrder(
+        nil,
+        saveDataMap,
+        function(____, subscriberName, saveData)
+            ____exports.restoreDefaultSaveData(nil, subscriberName, saveData, saveDataKey)
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+end
+function ____exports.restoreDefaultSaveData(self, subscriberName, saveData, saveDataKey)
+    if not RESETTABLE_SAVE_DATA_KEYS:has(saveDataKey) then
+        error("Unknown save data key name of: " .. saveDataKey)
+    end
+    local childTable = saveData[saveDataKey]
+    if childTable == nil then
+        return
+    end
+    local saveDataDefaults = saveDataDefaultsMap[subscriberName]
+    if saveDataDefaults == nil then
+        logError(nil, "Failed to find the default copy of the save data for subscriber: " .. subscriberName)
+        return
+    end
+    local childTableDefaults = saveDataDefaults[saveDataKey]
+    if childTableDefaults == nil then
+        logError(nil, ((("Failed to find the default copy of the child table \"" .. saveDataKey) .. "\" for subscriber \"") .. subscriberName) .. "\". This error usually means that your save data is out of date. You can try purging all of your save data by deleting the following directory: C:\\Program Files (x86)\\Steam\\steamapps\\common\\The Binding of Isaac Rebirth\\data")
+        return
+    end
+    local childTableDefaultsCopy = deepCopy(nil, childTableDefaults, SerializationType.NONE, (subscriberName .. " --> ") .. saveDataKey)
+    clearAndCopyAllElements(nil, childTable, childTableDefaultsCopy)
+end
+function clearAndCopyAllElements(self, oldTable, newTable)
+    clearTable(nil, oldTable)
+    for key, value in pairs(newTable) do
+        oldTable[key] = value
+    end
+end
+RESETTABLE_SAVE_DATA_KEYS = __TS__New(Set, {SaveDataKey.RUN, SaveDataKey.LEVEL, SaveDataKey.ROOM})
+mod = nil
+loadedDataOnThisRun = false
+function ____exports.saveDataManagerInit(self, incomingMod)
+    mod = incomingMod
+    mod:AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit)
+    mod:AddCallback(ModCallback.PRE_GAME_EXIT, preGameExit)
+    mod:AddCallback(ModCallback.POST_NEW_LEVEL, postNewLevel)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_EARLY, postNewRoomEarly)
+end
+function ____exports.forceSaveDataManagerSave(self)
+    if mod == nil then
+        return
+    end
+    saveToDisk(nil, mod, saveDataMap, saveDataConditionalFuncMap)
+end
+function ____exports.forceSaveDataManagerLoad(self)
+    if mod == nil then
+        return
+    end
+    loadFromDisk(nil, mod, saveDataMap)
+end
+return ____exports

package/dist/src/features/saveDataManager/maps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/maps.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,WAAW,qDAAiC,CAAC;AAE1D,eAAO,MAAM,mBAAmB,qDAAiC,CAAC;AAClE,eAAO,MAAM,0BAA0B,uBAA4B,OAAO,CAAG,CAAC"}

package/dist/src/features/saveDataManager/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/merge.ts"],"names":[],"mappings":";AAgBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CACnB,SAAS,EACL,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAC1B,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,GACvB,GAAG,CAAC,SAAS,CAAC,EAClB,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACpC,oBAAoB,EAAE,MAAM,GAC3B,IAAI,CA2BN"}

package/dist/src/features/saveDataManager/merge.lua

@@ -0,0 +1,154 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local Map = ____lualib.Map
+local ____exports = {}
+local mergeArray, mergeTSTLObject, mergeTable
+local ____SerializationBrand = require("src.enums.private.SerializationBrand")
+local SerializationBrand = ____SerializationBrand.SerializationBrand
+local ____SerializationType = require("src.enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____array = require("src.functions.array")
+local isArray = ____array.isArray
+local ____deepCopy = require("src.functions.deepCopy")
+local deepCopy = ____deepCopy.deepCopy
+local ____log = require("src.functions.log")
+local log = ____log.log
+local ____serialization = require("src.functions.serialization")
+local deserializeIsaacAPIClass = ____serialization.deserializeIsaacAPIClass
+local isSerializedIsaacAPIClass = ____serialization.isSerializedIsaacAPIClass
+local ____table = require("src.functions.table")
+local clearTable = ____table.clearTable
+local iterateTableInOrder = ____table.iterateTableInOrder
+local ____tstlClass = require("src.functions.tstlClass")
+local isDefaultMap = ____tstlClass.isDefaultMap
+local isTSTLMap = ____tstlClass.isTSTLMap
+local isTSTLSet = ____tstlClass.isTSTLSet
+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 ____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
+-- performing appropriate deserialization).
+-- 
+-- It supports the following object types:
+-- 
+-- - Basic TSTL objects / tables
+-- - TSTL `Map`
+-- - TSTL `Set`
+-- - TSTL classes
+-- - `DefaultMap`
+-- - Isaac `BitSet128` objects
+-- - Isaac `Color` objects
+-- - Isaac `KColor` objects
+-- - Isaac `RNG` objects
+-- - Isaac `Vector` objects
+-- 
+-- Since it is common for a variable to have a type of `something | null`, we must iterate over the
+-- new object and copy over all of the values. (A value of null transpiles to nil, which means the
+-- table key does not exist.) The consequence of this is that it can copy over old variables that
+-- are no longer used in the code, or copy over old variables of a different type, which can cause
+-- run-time errors. In such cases, users will have to manually delete their save data.
+function ____exports.merge(self, oldObject, newTable, traversalDescription)
+    if SAVE_DATA_MANAGER_DEBUG then
+        log(nil, "merge is traversing: " .. traversalDescription)
+    end
+    if not isTable(nil, oldObject) then
+        error("The first argument given to the merge function is not a table.")
+    end
+    if not isTable(nil, newTable) then
+        error("The second argument given to the merge function is not a table.")
+    end
+    if isArray(nil, oldObject) and isArray(nil, newTable) then
+        mergeArray(nil, oldObject, newTable)
+        return
+    end
+    if isTSTLMap(nil, oldObject) or isTSTLSet(nil, oldObject) or isDefaultMap(nil, oldObject) then
+        mergeTSTLObject(nil, oldObject, newTable, traversalDescription)
+    else
+        mergeTable(nil, oldObject, newTable, traversalDescription)
+    end
+end
+function mergeArray(self, oldArray, newArray)
+    clearTable(nil, oldArray)
+    iterateTableInOrder(
+        nil,
+        newArray,
+        function(____, key, value)
+            oldArray[key] = value
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+end
+function mergeTSTLObject(self, oldObject, newTable, traversalDescription)
+    oldObject:clear()
+    local convertStringKeysToNumbers = newTable[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] ~= nil
+    iterateTableInOrder(
+        nil,
+        newTable,
+        function(____, key, value)
+            if isSerializationBrand(nil, key) then
+                return
+            end
+            local keyToUse = key
+            if convertStringKeysToNumbers then
+                local numberKey = tonumber(key)
+                if numberKey == nil then
+                    return
+                end
+                keyToUse = numberKey
+            end
+            if isTSTLMap(nil, oldObject) or isDefaultMap(nil, oldObject) then
+                local valueCopy
+                if isTable(nil, value) then
+                    valueCopy = deepCopy(nil, value, SerializationType.DESERIALIZE, traversalDescription)
+                else
+                    valueCopy = value
+                end
+                oldObject:set(keyToUse, valueCopy)
+            elseif isTSTLSet(nil, oldObject) then
+                oldObject:add(keyToUse)
+            end
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+end
+function mergeTable(self, oldTable, newTable, traversalDescription)
+    iterateTableInOrder(
+        nil,
+        newTable,
+        function(____, key, value)
+            if SAVE_DATA_MANAGER_DEBUG then
+                local valueToPrint = value == "" and "(empty string)" or tostring(value)
+                log(nil, (("merge is merging: " .. traversalDescription) .. " --> ") .. valueToPrint)
+            end
+            if isSerializationBrand(nil, key) then
+                return
+            end
+            if isSerializedIsaacAPIClass(nil, value) then
+                if SAVE_DATA_MANAGER_DEBUG then
+                    log(nil, "merge found a serialized Isaac API class.")
+                end
+                local deserializedObject = deserializeIsaacAPIClass(nil, value)
+                oldTable[key] = deserializedObject
+                return
+            end
+            if isTable(nil, value) then
+                local oldValue = oldTable[key]
+                if not isTable(nil, oldValue) then
+                    oldValue = {}
+                    oldTable[key] = oldValue
+                end
+                traversalDescription = getTraversalDescription(nil, key, traversalDescription)
+                ____exports.merge(nil, oldValue, value, traversalDescription)
+            else
+                oldTable[key] = value
+            end
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+end
+return ____exports

package/dist/src/features/saveDataManager/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/save.ts"],"names":[],"mappings":";;AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAMrD,wBAAgB,UAAU,CACxB,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACrC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GACxD,IAAI,CAUN"}