isaacscript-common 6.6.1-dev.2 → 6.6.1

package/dist/features/saveDataManager/merge.lua

@@ -0,0 +1,152 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local Set = ____lualib.Set
+local ____exports = {}
+local mergeArray, mergeTSTLObject, mergeTable
+local ____SerializationBrand = require("enums.private.SerializationBrand")
+local SerializationBrand = ____SerializationBrand.SerializationBrand
+local ____SerializationType = require("enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____array = require("functions.array")
+local isArray = ____array.isArray
+local ____deepCopy = require("functions.deepCopy")
+local deepCopy = ____deepCopy.deepCopy
+local ____log = require("functions.log")
+local log = ____log.log
+local ____serialization = require("functions.serialization")
+local deserializeIsaacAPIClass = ____serialization.deserializeIsaacAPIClass
+local isSerializedIsaacAPIClass = ____serialization.isSerializedIsaacAPIClass
+local ____table = require("functions.table")
+local clearTable = ____table.clearTable
+local iterateTableInOrder = ____table.iterateTableInOrder
+local ____tstlClass = require("functions.tstlClass")
+local isTSTLMap = ____tstlClass.isTSTLMap
+local isTSTLSet = ____tstlClass.isTSTLSet
+local ____types = require("functions.types")
+local isTable = ____types.isTable
+local ____utils = require("functions.utils")
+local getTraversalDescription = ____utils.getTraversalDescription
+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
+-- performing appropriate deserialization).
+-- 
+-- It supports the following object types:
+-- 
+-- - `LuaTable` / basic TSTL objects
+-- - TSTL `Map`
+-- - TSTL `Set`
+-- - TSTL classes
+-- - `DefaultMap`
+-- - 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("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) 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) 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((("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("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/features/saveDataManager/save.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="typescript-to-lua/language-extensions" />
+import { SaveData } from "../../interfaces/SaveData";
+export declare function saveToDisk(mod: Mod, saveDataMap: LuaTable<string, SaveData>, saveDataConditionalFuncMap: Map<string, () => boolean>): void;
+//# sourceMappingURL=save.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/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,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,EACvC,0BAA0B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GACrD,IAAI,CAUN"}

package/dist/features/saveDataManager/save.lua

@@ -0,0 +1,49 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
+local ____exports = {}
+local getAllSaveDataToWriteToDisk
+local ____SerializationType = require("enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____deepCopy = require("functions.deepCopy")
+local deepCopy = ____deepCopy.deepCopy
+local ____jsonHelpers = require("functions.jsonHelpers")
+local jsonEncode = ____jsonHelpers.jsonEncode
+local ____log = require("functions.log")
+local log = ____log.log
+local ____table = require("functions.table")
+local iterateTableInOrder = ____table.iterateTableInOrder
+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(
+        nil,
+        saveDataMap,
+        function(____, subscriberName, saveData)
+            local conditionalFunc = saveDataConditionalFuncMap:get(subscriberName)
+            if conditionalFunc ~= nil then
+                local shouldSave = conditionalFunc(nil)
+                if not shouldSave then
+                    return
+                end
+            end
+            local saveDataWithoutRoom = {persistent = saveData.persistent, run = saveData.run, level = saveData.level}
+            if #__TS__ObjectKeys(saveDataWithoutRoom) == 0 then
+                return
+            end
+            local saveDataCopy = deepCopy(nil, saveDataWithoutRoom, SerializationType.SERIALIZE, subscriberName)
+            allSaveData[subscriberName] = saveDataCopy
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+    return allSaveData
+end
+function ____exports.saveToDisk(self, mod, saveDataMap, saveDataConditionalFuncMap)
+    local allSaveData = getAllSaveDataToWriteToDisk(nil, saveDataMap, saveDataConditionalFuncMap)
+    local jsonString = jsonEncode(nil, allSaveData)
+    mod:SaveData(jsonString)
+    log(("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " wrote data to the \"save#.dat\" file.")
+end
+return ____exports

package/dist/features/saveDataManager/saveDataManagerConstants.d.ts

@@ -0,0 +1,4 @@
+/** Set this to true to enable more verbosity in the save data manger. */
+export declare const SAVE_DATA_MANAGER_DEBUG = false;
+export declare const SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager";
+//# sourceMappingURL=saveDataManagerConstants.d.ts.map

package/dist/features/saveDataManager/saveDataManagerConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveDataManagerConstants.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/saveDataManagerConstants.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C,eAAO,MAAM,8BAA8B,sBAAsB,CAAC"}

package/dist/features/saveDataManager/saveDataManagerConstants.lua

@@ -0,0 +1,5 @@
+local ____exports = {}
+--- 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"
+return ____exports

package/dist/features/saveDataManager/serializationBrand.d.ts

@@ -0,0 +1,2 @@
+export declare function isSerializationBrand(key: unknown): boolean;
+//# sourceMappingURL=serializationBrand.d.ts.map

package/dist/features/saveDataManager/serializationBrand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializationBrand.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/serializationBrand.ts"],"names":[],"mappings":"AASA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAM1D"}

package/dist/features/saveDataManager/serializationBrand.lua

@@ -0,0 +1,19 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____SerializationBrand = require("enums.private.SerializationBrand")
+local SerializationBrand = ____SerializationBrand.SerializationBrand
+local ____enums = require("functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____types = require("functions.types")
+local isString = ____types.isString
+local SERIALIZATION_BRANDS = getEnumValues(nil, SerializationBrand)
+local SERIALIZATION_BRAND_SET = __TS__New(Set, SERIALIZATION_BRANDS)
+function ____exports.isSerializationBrand(self, key)
+    if not isString(nil, key) then
+        return false
+    end
+    return SERIALIZATION_BRAND_SET:has(key)
+end
+return ____exports

package/dist/features/sirenHelpers.d.ts

@@ -0,0 +1,19 @@
+import { FamiliarVariant } from "isaac-typescript-definitions";
+/**
+ * Blacklists a familiar from being stolen by The Siren boss. This should be called once at the
+ * beginning of every run.
+ *
+ * @param familiarVariant The familiar variant to blacklist.
+ * @param familiarSubType The sub-type to blacklist. Optional. The default is to blacklist all
+ *                        sub-types of the given variant.
+ */
+export declare function setFamiliarNoSirenSteal(familiarVariant: FamiliarVariant, familiarSubType?: int): void;
+/**
+ * Helper function to check if the Siren boss has stolen a familiar. Some familiars may need to
+ * behave differently when under The Siren's control (e.g. if they auto-target enemies).
+ *
+ * @param familiar The familiar to be checked.
+ * @returns Returns whether the familiar has been stolen by The Siren.
+ */
+export declare function hasSirenStolenFamiliar(familiar: EntityFamiliar): boolean;
+//# sourceMappingURL=sirenHelpers.d.ts.map

package/dist/features/sirenHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sirenHelpers.d.ts","sourceRoot":"","sources":["../../../../../packages/isaacscript-common/src/features/sirenHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEhB,MAAM,8BAA8B,CAAC;AAyEtC;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,EAChC,eAAe,CAAC,EAAE,GAAG,GACpB,IAAI,CAQN;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAGxE"}

package/dist/features/sirenHelpers.lua

@@ -0,0 +1,82 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFind = ____lualib.__TS__ArrayFind
+local ____exports = {}
+local postNPCInitSirenHelper, checkReturnFamiliarToPlayer, blacklistEntryExists, getSirenHelper, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____entity = require("functions.entity")
+local getEntities = ____entity.getEntities
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postNPCInitSirenHelper(self, npc)
+    checkReturnFamiliarToPlayer(nil, npc)
+end
+function checkReturnFamiliarToPlayer(self, npc)
+    if npc.Target == nil then
+        return
+    end
+    local familiar = npc.Target:ToFamiliar()
+    if familiar == nil then
+        return
+    end
+    if blacklistEntryExists(nil, familiar.Variant, familiar.SubType) then
+        npc:Remove()
+        familiar:AddToFollowers()
+    end
+end
+function blacklistEntryExists(self, incomingFamiliarVariant, incomingFamiliarSubType)
+    for ____, ____value in ipairs(v.run.familiarBlacklist) do
+        local familiarVariant = ____value[1]
+        local familiarSubType = ____value[2]
+        if incomingFamiliarVariant == familiarVariant and familiarSubType == incomingFamiliarSubType then
+            return true
+        end
+        if incomingFamiliarVariant == familiarVariant and familiarSubType == nil then
+            return true
+        end
+    end
+    return false
+end
+function getSirenHelper(self, familiar)
+    local familiarPtrHash = GetPtrHash(familiar)
+    local sirenHelpers = getEntities(nil, EntityType.SIREN_HELPER)
+    return __TS__ArrayFind(
+        sirenHelpers,
+        function(____, sirenHelper) return sirenHelper.Target ~= nil and GetPtrHash(sirenHelper.Target) == familiarPtrHash end
+    )
+end
+local FEATURE_NAME = "sirenHelpers"
+v = {run = {familiarBlacklist = {}}}
+---
+-- @internal
+function ____exports.sirenHelpersInit(self, mod)
+    saveDataManager(nil, FEATURE_NAME, v)
+    mod:AddCallback(ModCallback.POST_NPC_INIT, postNPCInitSirenHelper, EntityType.SIREN_HELPER)
+end
+--- Blacklists a familiar from being stolen by The Siren boss. This should be called once at the
+-- beginning of every run.
+-- 
+-- @param familiarVariant The familiar variant to blacklist.
+-- @param familiarSubType The sub-type to blacklist. Optional. The default is to blacklist all
+-- sub-types of the given variant.
+function ____exports.setFamiliarNoSirenSteal(self, familiarVariant, familiarSubType)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    if blacklistEntryExists(nil, familiarVariant, familiarSubType) then
+        return
+    end
+    local ____v_run_familiarBlacklist_0 = v.run.familiarBlacklist
+    ____v_run_familiarBlacklist_0[#____v_run_familiarBlacklist_0 + 1] = {familiarVariant, familiarSubType}
+end
+--- Helper function to check if the Siren boss has stolen a familiar. Some familiars may need to
+-- behave differently when under The Siren's control (e.g. if they auto-target enemies).
+-- 
+-- @param familiar The familiar to be checked.
+-- @returns Returns whether the familiar has been stolen by The Siren.
+function ____exports.hasSirenStolenFamiliar(self, familiar)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    return getSirenHelper(nil, familiar) ~= nil
+end
+return ____exports

package/dist/features/stageHistory.d.ts

@@ -0,0 +1,16 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
+/** Helper function to get all of the stages that a player has visited thus far on this run. */
+export declare function getStageHistory(): ReadonlyArray<[
+    stage: LevelStage,
+    stageType: StageType
+]>;
+/**
+ * Helper function to check if a player has previous visited a particular stage (or stage + stage
+ * type combination) on this run.
+ *
+ * @param stage The stage to check for.
+ * @param stageType Optional. If provided, will check for a specific stage and stage type
+ *                  combination.
+ */
+export declare function hasVisitedStage(stage: LevelStage, stageType?: StageType): boolean;
+//# sourceMappingURL=stageHistory.d.ts.map

package/dist/features/stageHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stageHistory.d.ts","sourceRoot":"","sources":["../../../../../packages/isaacscript-common/src/features/stageHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAkCrE,+FAA+F;AAC/F,wBAAgB,eAAe,IAAI,aAAa,CAC9C;IAAC,KAAK,EAAE,UAAU;IAAE,SAAS,EAAE,SAAS;CAAC,CAC1C,CAGA;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAaT"}

package/dist/features/stageHistory.lua

@@ -0,0 +1,62 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArraySome = ____lualib.__TS__ArraySome
+local ____exports = {}
+local postNewLevelReordered, v
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postNewLevelReordered(self)
+    local level = game:GetLevel()
+    local stage = level:GetStage()
+    local stageType = level:GetStageType()
+    local ____v_run_stageHistory_0 = v.run.stageHistory
+    ____v_run_stageHistory_0[#____v_run_stageHistory_0 + 1] = {stage, stageType}
+end
+local FEATURE_NAME = "stageHistory"
+v = {run = {stageHistory = {}}}
+---
+-- @internal
+function ____exports.stageHistoryInit(self, mod)
+    saveDataManager(nil, FEATURE_NAME, v)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_LEVEL_REORDERED, postNewLevelReordered)
+end
+--- Helper function to get all of the stages that a player has visited thus far on this run.
+function ____exports.getStageHistory(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    return v.run.stageHistory
+end
+--- Helper function to check if a player has previous visited a particular stage (or stage + stage
+-- type combination) on this run.
+-- 
+-- @param stage The stage to check for.
+-- @param stageType Optional. If provided, will check for a specific stage and stage type
+-- combination.
+function ____exports.hasVisitedStage(self, stage, stageType)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    if stageType == nil then
+        return __TS__ArraySome(
+            v.run.stageHistory,
+            function(____, ____bindingPattern0)
+                local previousStage
+                previousStage = ____bindingPattern0[1]
+                return previousStage == stage
+            end
+        )
+    end
+    return __TS__ArraySome(
+        v.run.stageHistory,
+        function(____, ____bindingPattern0)
+            local previousStageType
+            local previousStage
+            previousStage = ____bindingPattern0[1]
+            previousStageType = ____bindingPattern0[2]
+            return previousStage == stage and previousStageType == stageType
+        end
+    )
+end
+return ____exports

package/dist/features/taintedLazarusPlayers.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to get the other version of Tainted Lazarus.
+ *
+ * - On Tainted Lazarus, returns the player object for Dead Tainted Lazarus.
+ * - On Dead Tainted Lazarus, returns the player object for Tainted Lazarus.
+ * - Returns undefined if player object retrieval failed for any reason.
+ *
+ * If you call the `EntityPlayer.Exists` method on the returned object, it will return false.
+ * However, you can still call the other methods like you normally would (e.g.
+ * `EntityPlayer.AddCollectible`).
+ */
+export declare function getTaintedLazarusSubPlayer(player: EntityPlayer): EntityPlayer | undefined;
+//# sourceMappingURL=taintedLazarusPlayers.d.ts.map

package/dist/features/taintedLazarusPlayers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taintedLazarusPlayers.d.ts","sourceRoot":"","sources":["../../../../../packages/isaacscript-common/src/features/taintedLazarusPlayers.ts"],"names":[],"mappings":";AAoFA;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,GACnB,YAAY,GAAG,SAAS,CAe1B"}

package/dist/features/taintedLazarusPlayers.lua

@@ -0,0 +1,85 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postPlayerInit, checkDequeue, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postPlayerInit(self, player)
+    local entityPtr = EntityPtr(player)
+    local character = player:GetPlayerType()
+    if character == PlayerType.LAZARUS_B then
+        local ____v_run_queuedTaintedLazarus_0 = v.run.queuedTaintedLazarus
+        ____v_run_queuedTaintedLazarus_0[#____v_run_queuedTaintedLazarus_0 + 1] = entityPtr
+    elseif character == PlayerType.LAZARUS_2_B then
+        local ____v_run_queuedDeadTaintedLazarus_1 = v.run.queuedDeadTaintedLazarus
+        ____v_run_queuedDeadTaintedLazarus_1[#____v_run_queuedDeadTaintedLazarus_1 + 1] = entityPtr
+    else
+        return
+    end
+    checkDequeue(nil)
+end
+function checkDequeue(self)
+    if #v.run.queuedTaintedLazarus == 0 or #v.run.queuedDeadTaintedLazarus == 0 then
+        return
+    end
+    local taintedLazarusPtr = table.remove(v.run.queuedTaintedLazarus, 1)
+    local deadTaintedLazarusPtr = table.remove(v.run.queuedDeadTaintedLazarus, 1)
+    if taintedLazarusPtr == nil or deadTaintedLazarusPtr == nil then
+        return
+    end
+    local taintedLazarus = taintedLazarusPtr.Ref
+    local deadTaintedLazarus = deadTaintedLazarusPtr.Ref
+    if taintedLazarus == nil or deadTaintedLazarus == nil then
+        return
+    end
+    local taintedLazarusPtrHash = GetPtrHash(taintedLazarus)
+    local deadTaintedLazarusPtrHash = GetPtrHash(deadTaintedLazarus)
+    v.run.subPlayerMap:set(taintedLazarusPtrHash, deadTaintedLazarusPtr)
+    v.run.subPlayerMap:set(deadTaintedLazarusPtrHash, taintedLazarusPtr)
+end
+local FEATURE_NAME = "taintedLazarusPlayers"
+v = {run = {
+    queuedTaintedLazarus = {},
+    queuedDeadTaintedLazarus = {},
+    subPlayerMap = __TS__New(Map)
+}}
+---
+-- @internal
+function ____exports.taintedLazarusPlayersInit(self, mod)
+    saveDataManager(
+        nil,
+        FEATURE_NAME,
+        v,
+        function() return false end
+    )
+    mod:AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit)
+end
+--- Helper function to get the other version of Tainted Lazarus.
+-- 
+-- - On Tainted Lazarus, returns the player object for Dead Tainted Lazarus.
+-- - On Dead Tainted Lazarus, returns the player object for Tainted Lazarus.
+-- - Returns undefined if player object retrieval failed for any reason.
+-- 
+-- If you call the `EntityPlayer.Exists` method on the returned object, it will return false.
+-- However, you can still call the other methods like you normally would (e.g.
+-- `EntityPlayer.AddCollectible`).
+function ____exports.getTaintedLazarusSubPlayer(self, player)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local ptrHash = GetPtrHash(player)
+    local entityPtr = v.run.subPlayerMap:get(ptrHash)
+    if entityPtr == nil then
+        return nil
+    end
+    local entity = entityPtr.Ref
+    if entity == nil then
+        return nil
+    end
+    return entity:ToPlayer()
+end
+return ____exports

package/dist/featuresInitialized.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=featuresInitialized.d.ts.map

package/dist/featuresInitialized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featuresInitialized.d.ts","sourceRoot":"","sources":["../../../../packages/isaacscript-common/src/featuresInitialized.ts"],"names":[],"mappings":""}

package/dist/featuresInitialized.lua

@@ -0,0 +1,20 @@
+local ____exports = {}
+local featuresInitialized = false
+---
+-- @internal
+function ____exports.areFeaturesInitialized(self)
+    return featuresInitialized
+end
+---
+-- @internal
+function ____exports.errorIfFeaturesNotInitialized(self, featureName)
+    if not ____exports.areFeaturesInitialized(nil) then
+        error(("The \"" .. featureName) .. "\" feature is not initialized. You must first upgrade your mod object by calling the \"upgradeMod\" function.")
+    end
+end
+---
+-- @internal
+function ____exports.setFeaturesInitialized(self)
+    featuresInitialized = true
+end
+return ____exports

package/dist/functions/ambush.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Helper function to start a Challenge Room or the Boss Rush.
+ *
+ * Specifically, this is performed by spawning a sack on top of the player, waiting a game frame,
+ * and then removing the sack and the pickups that the sack dropped.
+ */
+export declare function startAmbush(): void;
+//# sourceMappingURL=ambush.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ambush.d.ts","sourceRoot":"","sources":["../../../../../packages/isaacscript-common/src/functions/ambush.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CA8BlC"}

package/dist/functions/ambush.lua

@@ -0,0 +1,43 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local SackSubType = ____isaac_2Dtypescript_2Ddefinitions.SackSubType
+local ____runInNFrames = require("features.runInNFrames")
+local runNextGameFrame = ____runInNFrames.runNextGameFrame
+local ____entity = require("functions.entity")
+local removeEntities = ____entity.removeEntities
+local ____pickups = require("functions.pickups")
+local getCoins = ____pickups.getCoins
+local spawnSackWithSeed = ____pickups.spawnSackWithSeed
+--- Hard-coding this makes it easier to clean up the pickups afterwards.
+local SACK_SEED_THAT_SPAWNS_TWO_COINS = 6
+--- Helper function to start a Challenge Room or the Boss Rush.
+-- 
+-- Specifically, this is performed by spawning a sack on top of the player, waiting a game frame,
+-- and then removing the sack and the pickups that the sack dropped.
+function ____exports.startAmbush(self)
+    local player = Isaac.GetPlayer()
+    local sack = spawnSackWithSeed(nil, SackSubType.NULL, player.Position, SACK_SEED_THAT_SPAWNS_TWO_COINS)
+    local sprite = sack:GetSprite()
+    sprite:Stop()
+    local sackPtr = EntityPtr(sack)
+    runNextGameFrame(
+        nil,
+        function()
+            local futureSack = sackPtr.Ref
+            if futureSack == nil then
+                return
+            end
+            futureSack:Remove()
+            local sackPtrHash = GetPtrHash(futureSack)
+            local coins = getCoins(nil)
+            local coinsFromSack = __TS__ArrayFilter(
+                coins,
+                function(____, pickup) return pickup.SpawnerEntity ~= nil and GetPtrHash(pickup.SpawnerEntity) == sackPtrHash end
+            )
+            removeEntities(nil, coinsFromSack)
+        end
+    )
+end
+return ____exports