isaacscript-common 6.6.0 → 6.6.1-dev.2

package/features/saveDataManager/save.js

@@ -0,0 +1,43 @@
+import { SerializationType } from "../../enums/SerializationType";
+import { deepCopy } from "../../functions/deepCopy";
+import { jsonEncode } from "../../functions/jsonHelpers";
+import { log } from "../../functions/log";
+import { iterateTableInOrder } from "../../functions/table";
+import { SAVE_DATA_MANAGER_DEBUG, SAVE_DATA_MANAGER_FEATURE_NAME, } from "./saveDataManagerConstants";
+export function saveToDisk(mod, saveDataMap, saveDataConditionalFuncMap) {
+    const allSaveData = getAllSaveDataToWriteToDisk(saveDataMap, saveDataConditionalFuncMap);
+    const jsonString = jsonEncode(allSaveData);
+    mod.SaveData(jsonString); // Write it to the "save#.dat" file
+    log(`The ${SAVE_DATA_MANAGER_FEATURE_NAME} wrote data to the "save#.dat" file.`);
+}
+function getAllSaveDataToWriteToDisk(saveDataMap, saveDataConditionalFuncMap) {
+    const allSaveData = new LuaTable();
+    iterateTableInOrder(saveDataMap, (subscriberName, saveData) => {
+        // Handle the feature of the save data manager where certain mod features can conditionally
+        // write their data to disk.
+        const conditionalFunc = saveDataConditionalFuncMap.get(subscriberName);
+        if (conditionalFunc !== undefined) {
+            const shouldSave = conditionalFunc();
+            if (!shouldSave) {
+                return;
+            }
+        }
+        // Strip out the room part of the save data.
+        const saveDataWithoutRoom = {
+            persistent: saveData.persistent,
+            run: saveData.run,
+            level: saveData.level,
+        };
+        // If there is no data, then we can move on to the next feature.
+        if (Object.keys(saveDataWithoutRoom).length === 0) {
+            return;
+        }
+        // If we encode TypeScriptToLua Maps into JSON, it will result in a lot of extraneous data
+        // that is unnecessary. Make a copy of the data and recursively convert all TypeScriptToLua
+        // Maps into Lua tables.
+        const saveDataCopy = deepCopy(saveDataWithoutRoom, SerializationType.SERIALIZE, subscriberName);
+        allSaveData.set(subscriberName, saveDataCopy);
+    }, SAVE_DATA_MANAGER_DEBUG);
+    return allSaveData;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2F2ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL3NhdmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDbEUsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3BELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUN6RCxPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDMUMsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFNUQsT0FBTyxFQUNMLHVCQUF1QixFQUN2Qiw4QkFBOEIsR0FDL0IsTUFBTSw0QkFBNEIsQ0FBQztBQUVwQyxNQUFNLFVBQVUsVUFBVSxDQUN4QixHQUFRLEVBQ1IsV0FBdUMsRUFDdkMsMEJBQXNEO0lBRXRELE1BQU0sV0FBVyxHQUFHLDJCQUEyQixDQUM3QyxXQUFXLEVBQ1gsMEJBQTBCLENBQzNCLENBQUM7SUFDRixNQUFNLFVBQVUsR0FBRyxVQUFVLENBQUMsV0FBVyxDQUFDLENBQUM7SUFDM0MsR0FBRyxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLG1DQUFtQztJQUM3RCxHQUFHLENBQ0QsT0FBTyw4QkFBOEIsc0NBQXNDLENBQzVFLENBQUM7QUFDSixDQUFDO0FBRUQsU0FBUywyQkFBMkIsQ0FDbEMsV0FBdUMsRUFDdkMsMEJBQXNEO0lBRXRELE1BQU0sV0FBVyxHQUFHLElBQUksUUFBUSxFQUFzQixDQUFDO0lBRXZELG1CQUFtQixDQUNqQixXQUFXLEVBQ1gsQ0FBQyxjQUFjLEVBQUUsUUFBUSxFQUFFLEVBQUU7UUFDM0IsMkZBQTJGO1FBQzNGLDRCQUE0QjtRQUM1QixNQUFNLGVBQWUsR0FBRywwQkFBMEIsQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLENBQUM7UUFDdkUsSUFBSSxlQUFlLEtBQUssU0FBUyxFQUFFO1lBQ2pDLE1BQU0sVUFBVSxHQUFHLGVBQWUsRUFBRSxDQUFDO1lBQ3JDLElBQUksQ0FBQyxVQUFVLEVBQUU7Z0JBQ2YsT0FBTzthQUNSO1NBQ0Y7UUFFRCw0Q0FBNEM7UUFDNUMsTUFBTSxtQkFBbUIsR0FBYTtZQUNwQyxVQUFVLEVBQUUsUUFBUSxDQUFDLFVBQVU7WUFDL0IsR0FBRyxFQUFFLFFBQVEsQ0FBQyxHQUFHO1lBQ2pCLEtBQUssRUFBRSxRQUFRLENBQUMsS0FBSztTQUN0QixDQUFDO1FBRUYsZ0VBQWdFO1FBQ2hFLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUU7WUFDakQsT0FBTztTQUNSO1FBRUQsMEZBQTBGO1FBQzFGLDJGQUEyRjtRQUMzRix3QkFBd0I7UUFDeEIsTUFBTSxZQUFZLEdBQUcsUUFBUSxDQUMzQixtQkFBK0IsRUFDL0IsaUJBQWlCLENBQUMsU0FBUyxFQUMzQixjQUFjLENBQ2YsQ0FBQztRQUVGLFdBQVcsQ0FBQyxHQUFHLENBQUMsY0FBYyxFQUFFLFlBQVksQ0FBQyxDQUFDO0lBQ2hELENBQUMsRUFDRCx1QkFBdUIsQ0FDeEIsQ0FBQztJQUVGLE9BQU8sV0FBVyxDQUFDO0FBQ3JCLENBQUMifQ==

package/features/saveDataManager/save.lua

@@ -47,3 +47,5 @@ function ____exports.saveToDisk(self, mod, saveDataMap, saveDataConditionalFuncM
     log(("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " wrote data to the \"save#.dat\" file.")
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL3NhdmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7OztNQTJCUztBQTNCVCw4QkFBa0M7QUFBekI7QUFDVCxxQkFBeUI7QUFBaEI7QUFDVCx3QkFBMkI7QUFBbEI7QUFDVCxnQkFBb0I7QUFBWDtBQUNULGtCQUFvQztBQUEzQjtBQUVULHFDQUdPO0FBRkw7QUFDQTtBQW1CRixTQUFTLGtDQUNQLGFBQ0E7QUFFTSx3QkFBYztJQUVwQjs7UUFDRTtRQUNBLGVBQUMsZ0JBQWdCO0FBR1Qsb0NBQWtCLDJCQUEyQixJQUFJO2VBQ25EO0FBQ0ksbUNBQWE7dUJBQ2Q7QUFDSDs7O0FBS0Usd0NBQWdDLENBQ3BDLGFBQVkscUJBQ1osTUFBSyxjQUNMLFFBQU87ZUFJTCxrQkFBWSx3QkFBZ0M7QUFDOUM7O0FBTUksaUNBQWUsY0FDbkIscUJBQ0EsNkJBQ0E7QUFHRix3QkFBZ0Isa0JBQWdCO1FBaENsQztRQWtDQTs7QUFHRixXQUFPOztBQTdEVCxzQ0FDRSxLQUNBLGFBQ0E7QUFFTSx3QkFBYyxpQ0FDbEIsYUFDQTtBQUVJLHVCQUFhLGdCQUFXO0lBQzlCLElBQUksU0FBUztJQUNiLEtBQ0UsVUFBTyxtQ0FBOEI7QUFaekMiLCJmaWxlIjoic2F2ZS5sdWEiLCJzb3VyY2VSb290IjoiIn0=

package/features/saveDataManager/saveDataManagerConstants.js

@@ -0,0 +1,4 @@
+/** Set this to true to enable more verbosity in the save data manger. */
+export const SAVE_DATA_MANAGER_DEBUG = false;
+export const SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2F2ZURhdGFNYW5hZ2VyQ29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mZWF0dXJlcy9zYXZlRGF0YU1hbmFnZXIvc2F2ZURhdGFNYW5hZ2VyQ29uc3RhbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHlFQUF5RTtBQUN6RSxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyxLQUFLLENBQUM7QUFFN0MsTUFBTSxDQUFDLE1BQU0sOEJBQThCLEdBQUcsbUJBQW1CLENBQUMifQ==

package/features/saveDataManager/saveDataManagerConstants.lua

@@ -3,3 +3,5 @@ local ____exports = {}
 ____exports.SAVE_DATA_MANAGER_DEBUG = false
 ____exports.SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager"
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL3NhdmVEYXRhTWFuYWdlckNvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUNhLHNDQUEwQjtBQUUxQiw2Q0FBaUMiLCJmaWxlIjoic2F2ZURhdGFNYW5hZ2VyQ29uc3RhbnRzLmx1YSIsInNvdXJjZVJvb3QiOiIifQ==

package/features/saveDataManager/serializationBrand.js

@@ -0,0 +1,12 @@
+import { SerializationBrand } from "../../enums/private/SerializationBrand";
+import { getEnumValues } from "../../functions/enums";
+import { isString } from "../../functions/types";
+const SERIALIZATION_BRANDS = getEnumValues(SerializationBrand);
+const SERIALIZATION_BRAND_SET = new Set(SERIALIZATION_BRANDS);
+export function isSerializationBrand(key) {
+    if (!isString(key)) {
+        return false;
+    }
+    return SERIALIZATION_BRAND_SET.has(key);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VyaWFsaXphdGlvbkJyYW5kLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mZWF0dXJlcy9zYXZlRGF0YU1hbmFnZXIvc2VyaWFsaXphdGlvbkJyYW5kLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLHdDQUF3QyxDQUFDO0FBQzVFLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUN0RCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFakQsTUFBTSxvQkFBb0IsR0FBRyxhQUFhLENBQUMsa0JBQWtCLENBQUMsQ0FBQztBQUMvRCxNQUFNLHVCQUF1QixHQUF3QixJQUFJLEdBQUcsQ0FDMUQsb0JBQW9CLENBQ3JCLENBQUM7QUFFRixNQUFNLFVBQVUsb0JBQW9CLENBQUMsR0FBWTtJQUMvQyxJQUFJLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxFQUFFO1FBQ2xCLE9BQU8sS0FBSyxDQUFDO0tBQ2Q7SUFFRCxPQUFPLHVCQUF1QixDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUMxQyxDQUFDIn0=

package/features/saveDataManager/serializationBrand.lua

@@ -17,3 +17,5 @@ function ____exports.isSerializationBrand(self, key)
     return SERIALIZATION_BRAND_SET:has(key)
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL3NlcmlhbGl6YXRpb25CcmFuZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7O0FBQUEsK0JBQW1DO0FBQTFCO0FBQ1Qsa0JBQThCO0FBQXJCO0FBQ1Qsa0JBQXlCO0FBQWhCO0FBRUgsNkJBQXVCLG1CQUFjO0FBQ3JDLGdDQUErQyxVQUFJLEtBQ3ZEO0FBR0YsZ0RBQXFDO1dBQzlCLGNBQVM7QUFDWixlQUFPOztBQUdULFdBQU8sd0JBQXdCLElBQUk7QUFMckMiLCJmaWxlIjoic2VyaWFsaXphdGlvbkJyYW5kLmx1YSIsInNvdXJjZVJvb3QiOiIifQ==

package/features/sirenHelpers.js

@@ -0,0 +1,90 @@
+import { EntityType, ModCallback, } from "isaac-typescript-definitions";
+import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
+import { getEntities } from "../functions/entity";
+import { saveDataManager } from "./saveDataManager/exports";
+const FEATURE_NAME = "sirenHelpers";
+const v = {
+    run: {
+        familiarBlacklist: [],
+    },
+};
+/** @internal */
+export function sirenHelpersInit(mod) {
+    saveDataManager(FEATURE_NAME, v);
+    mod.AddCallback(ModCallback.POST_NPC_INIT, postNPCInitSirenHelper, EntityType.SIREN_HELPER);
+}
+// ModCallback.POST_NPC_INIT (27)
+// EntityType.SIREN_HELPER (966)
+function postNPCInitSirenHelper(npc) {
+    checkReturnFamiliarToPlayer(npc);
+}
+function checkReturnFamiliarToPlayer(npc) {
+    if (npc.Target === undefined) {
+        return;
+    }
+    const familiar = npc.Target.ToFamiliar();
+    if (familiar === undefined) {
+        return;
+    }
+    if (blacklistEntryExists(familiar.Variant, familiar.SubType)) {
+        npc.Remove();
+        familiar.AddToFollowers();
+    }
+}
+function blacklistEntryExists(incomingFamiliarVariant, incomingFamiliarSubType) {
+    for (const [familiarVariant, familiarSubType] of v.run.familiarBlacklist) {
+        if (incomingFamiliarVariant === familiarVariant &&
+            familiarSubType === incomingFamiliarSubType) {
+            // There is an entry that matches the variant and sub-type exactly.
+            return true;
+        }
+        if (incomingFamiliarVariant === familiarVariant &&
+            familiarSubType === undefined) {
+            // There is an entry that matches all sub-types for this variant.
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 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 function setFamiliarNoSirenSteal(familiarVariant, familiarSubType) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    if (blacklistEntryExists(familiarVariant, familiarSubType)) {
+        return;
+    }
+    v.run.familiarBlacklist.push([familiarVariant, familiarSubType]);
+}
+/**
+ * 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 function hasSirenStolenFamiliar(familiar) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    return getSirenHelper(familiar) !== undefined;
+}
+/**
+ * When The Siren boss "steals" your familiars, a hidden "Siren Helper" entity is spawned to control
+ * each familiar stolen. (Checking for this entity seems to be the only way to detect when the Siren
+ * steals a familiar.)
+ *
+ * @param familiar The familiar to be checked.
+ * @returns Returns the hidden "Siren Helper" entity corresponding to the given familiar, if it
+ *          exists. Returns undefined otherwise.
+ */
+function getSirenHelper(familiar) {
+    const familiarPtrHash = GetPtrHash(familiar);
+    const sirenHelpers = getEntities(EntityType.SIREN_HELPER);
+    return sirenHelpers.find((sirenHelper) => sirenHelper.Target !== undefined &&
+        GetPtrHash(sirenHelper.Target) === familiarPtrHash);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2lyZW5IZWxwZXJzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mZWF0dXJlcy9zaXJlbkhlbHBlcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLFVBQVUsRUFFVixXQUFXLEdBQ1osTUFBTSw4QkFBOEIsQ0FBQztBQUN0QyxPQUFPLEVBQUUsNkJBQTZCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUN2RSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDbEQsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRTVELE1BQU0sWUFBWSxHQUFHLGNBQWMsQ0FBQztBQUVwQyxNQUFNLENBQUMsR0FBRztJQUNSLEdBQUcsRUFBRTtRQUNILGlCQUFpQixFQUFFLEVBRWxCO0tBQ0Y7Q0FDRixDQUFDO0FBRUYsZ0JBQWdCO0FBQ2hCLE1BQU0sVUFBVSxnQkFBZ0IsQ0FBQyxHQUFRO0lBQ3ZDLGVBQWUsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFFakMsR0FBRyxDQUFDLFdBQVcsQ0FDYixXQUFXLENBQUMsYUFBYSxFQUN6QixzQkFBc0IsRUFDdEIsVUFBVSxDQUFDLFlBQVksQ0FDeEIsQ0FBQztBQUNKLENBQUM7QUFFRCxpQ0FBaUM7QUFDakMsZ0NBQWdDO0FBQ2hDLFNBQVMsc0JBQXNCLENBQUMsR0FBYztJQUM1QywyQkFBMkIsQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUNuQyxDQUFDO0FBRUQsU0FBUywyQkFBMkIsQ0FBQyxHQUFjO0lBQ2pELElBQUksR0FBRyxDQUFDLE1BQU0sS0FBSyxTQUFTLEVBQUU7UUFDNUIsT0FBTztLQUNSO0lBRUQsTUFBTSxRQUFRLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztJQUN6QyxJQUFJLFFBQVEsS0FBSyxTQUFTLEVBQUU7UUFDMUIsT0FBTztLQUNSO0lBRUQsSUFBSSxvQkFBb0IsQ0FBQyxRQUFRLENBQUMsT0FBTyxFQUFFLFFBQVEsQ0FBQyxPQUFPLENBQUMsRUFBRTtRQUM1RCxHQUFHLENBQUMsTUFBTSxFQUFFLENBQUM7UUFDYixRQUFRLENBQUMsY0FBYyxFQUFFLENBQUM7S0FDM0I7QUFDSCxDQUFDO0FBRUQsU0FBUyxvQkFBb0IsQ0FDM0IsdUJBQXdDLEVBQ3hDLHVCQUF3QztJQUV4QyxLQUFLLE1BQU0sQ0FBQyxlQUFlLEVBQUUsZUFBZSxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsRUFBRTtRQUN4RSxJQUNFLHVCQUF1QixLQUFLLGVBQWU7WUFDM0MsZUFBZSxLQUFLLHVCQUF1QixFQUMzQztZQUNBLG1FQUFtRTtZQUNuRSxPQUFPLElBQUksQ0FBQztTQUNiO1FBRUQsSUFDRSx1QkFBdUIsS0FBSyxlQUFlO1lBQzNDLGVBQWUsS0FBSyxTQUFTLEVBQzdCO1lBQ0EsaUVBQWlFO1lBQ2pFLE9BQU8sSUFBSSxDQUFDO1NBQ2I7S0FDRjtJQUVELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLFVBQVUsdUJBQXVCLENBQ3JDLGVBQWdDLEVBQ2hDLGVBQXFCO0lBRXJCLDZCQUE2QixDQUFDLFlBQVksQ0FBQyxDQUFDO0lBRTVDLElBQUksb0JBQW9CLENBQUMsZUFBZSxFQUFFLGVBQWUsQ0FBQyxFQUFFO1FBQzFELE9BQU87S0FDUjtJQUVELENBQUMsQ0FBQyxHQUFHLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDLENBQUMsZUFBZSxFQUFFLGVBQWUsQ0FBQyxDQUFDLENBQUM7QUFDbkUsQ0FBQztBQUVEOzs7Ozs7R0FNRztBQUNILE1BQU0sVUFBVSxzQkFBc0IsQ0FBQyxRQUF3QjtJQUM3RCw2QkFBNkIsQ0FBQyxZQUFZLENBQUMsQ0FBQztJQUM1QyxPQUFPLGNBQWMsQ0FBQyxRQUFRLENBQUMsS0FBSyxTQUFTLENBQUM7QUFDaEQsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxjQUFjLENBQUMsUUFBd0I7SUFDOUMsTUFBTSxlQUFlLEdBQUcsVUFBVSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBRTdDLE1BQU0sWUFBWSxHQUFHLFdBQVcsQ0FBQyxVQUFVLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDMUQsT0FBTyxZQUFZLENBQUMsSUFBSSxDQUN0QixDQUFDLFdBQVcsRUFBRSxFQUFFLENBQ2QsV0FBVyxDQUFDLE1BQU0sS0FBSyxTQUFTO1FBQ2hDLFVBQVUsQ0FBQyxXQUFXLENBQUMsTUFBTSxDQUFDLEtBQUssZUFBZSxDQUNyRCxDQUFDO0FBQ0osQ0FBQyJ9

package/features/sirenHelpers.lua

@@ -80,3 +80,5 @@ function ____exports.hasSirenStolenFamiliar(self, familiar)
     return getSirenHelper(nil, familiar) ~= nil
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2lyZW5IZWxwZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztNQWdDUyx3QkFJQSw2QkFnQkEsc0JBbUVBLGdCQTVHSDtBQVhOLDZDQUlPO0FBSEw7QUFFQTtBQUVGLGdDQUE4QztBQUFyQztBQUNULG1CQUE0QjtBQUFuQjtBQUNULG9CQUFnQztBQUF2QjtBQXlCVCxTQUFTLDZCQUF1QjtJQUM5QixpQ0FBNEI7O0FBRzlCLFNBQVMsa0NBQTRCO09BQy9CO0FBQ0Y7O0FBR0kscUJBQVcsV0FBVztPQUN4QjtBQUNGOztPQUdFLDBCQUFxQixrQkFBa0I7UUFDekMsSUFBSTtRQUNKLFNBQVM7OztBQUliLFNBQVMsMkJBQ1AseUJBQ0E7QUFFQSxrQ0FBaUQ7Y0FBckM7Y0FBaUI7V0FFekIsMkJBQTRCLG9CQUM1QixtQkFBb0I7QUFHcEIsbUJBQU87O1dBSVAsMkJBQTRCLG9CQUM1QjtBQUdBLG1CQUFPOzs7QUFJWCxXQUFPOztBQTZDVCxTQUFTLHFCQUFlO0FBQ2hCLDRCQUFrQixXQUFXO0FBRTdCLHlCQUFlLGlCQUFZO0FBQ2pDLFdBQU87UUFBQTtRQUNMLGVBQUMsYUFDQyxxQ0FDQSxXQUFXLHVCQUF3QixlQUZyQzs7O0FBbkhFLHFCQUFlO0FBRWYsSUFBSSxDQUNSLE1BQUssQ0FDSCxvQkFBbUI7OztBQU92Qiw0Q0FBaUM7SUFDL0IscUJBQWdCLGNBQWM7SUFFOUIsSUFBSSxZQUNGLDJCQUNBLHdCQUNBO0FBTko7Ozs7Ozs7QUFpRUEsbURBQ0UsaUJBQ0E7SUFFQSxtQ0FBOEI7T0FFMUIsMEJBQXFCLGlCQUFpQjtBQUN4Qzs7VUFHRjtBQUFBLHdFQUE2QixDQUFDLGlCQUFpQjtBQVZqRDs7Ozs7O0FBb0JBLGtEQUF1QztJQUNyQyxtQ0FBOEI7QUFDOUIsV0FBTyxvQkFBZTtBQUZ4QiIsImZpbGUiOiJzaXJlbkhlbHBlcnMubHVhIiwic291cmNlUm9vdCI6IiJ9

package/features/stageHistory.js

@@ -0,0 +1,43 @@
+import { game } from "../cachedClasses";
+import { ModCallbackCustom } from "../enums/ModCallbackCustom";
+import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
+import { saveDataManager } from "./saveDataManager/exports";
+const FEATURE_NAME = "stageHistory";
+const v = {
+    run: {
+        stageHistory: [],
+    },
+};
+/** @internal */
+export function stageHistoryInit(mod) {
+    saveDataManager(FEATURE_NAME, v);
+    mod.AddCallbackCustom(ModCallbackCustom.POST_NEW_LEVEL_REORDERED, postNewLevelReordered);
+}
+// ModCallbackCustom.POST_NEW_LEVEL_REORDERED
+function postNewLevelReordered() {
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    const stageType = level.GetStageType();
+    v.run.stageHistory.push([stage, stageType]);
+}
+/** Helper function to get all of the stages that a player has visited thus far on this run. */
+export function getStageHistory() {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    return v.run.stageHistory;
+}
+/**
+ * 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 function hasVisitedStage(stage, stageType) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    if (stageType === undefined) {
+        return v.run.stageHistory.some(([previousStage]) => previousStage === stage);
+    }
+    return v.run.stageHistory.some(([previousStage, previousStageType]) => previousStage === stage && previousStageType === stageType);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhZ2VIaXN0b3J5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mZWF0dXJlcy9zdGFnZUhpc3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXhDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQy9ELE9BQU8sRUFBRSw2QkFBNkIsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ3ZFLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUU1RCxNQUFNLFlBQVksR0FBRyxjQUFjLENBQUM7QUFFcEMsTUFBTSxDQUFDLEdBQUc7SUFDUixHQUFHLEVBQUU7UUFDSCxZQUFZLEVBQUUsRUFBc0Q7S0FDckU7Q0FDRixDQUFDO0FBRUYsZ0JBQWdCO0FBQ2hCLE1BQU0sVUFBVSxnQkFBZ0IsQ0FBQyxHQUFnQjtJQUMvQyxlQUFlLENBQUMsWUFBWSxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBRWpDLEdBQUcsQ0FBQyxpQkFBaUIsQ0FDbkIsaUJBQWlCLENBQUMsd0JBQXdCLEVBQzFDLHFCQUFxQixDQUN0QixDQUFDO0FBQ0osQ0FBQztBQUVELDZDQUE2QztBQUM3QyxTQUFTLHFCQUFxQjtJQUM1QixNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7SUFDOUIsTUFBTSxLQUFLLEdBQUcsS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDO0lBQy9CLE1BQU0sU0FBUyxHQUFHLEtBQUssQ0FBQyxZQUFZLEVBQUUsQ0FBQztJQUV2QyxDQUFDLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxJQUFJLENBQUMsQ0FBQyxLQUFLLEVBQUUsU0FBUyxDQUFDLENBQUMsQ0FBQztBQUM5QyxDQUFDO0FBRUQsK0ZBQStGO0FBQy9GLE1BQU0sVUFBVSxlQUFlO0lBRzdCLDZCQUE2QixDQUFDLFlBQVksQ0FBQyxDQUFDO0lBQzVDLE9BQU8sQ0FBQyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUM7QUFDNUIsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLFVBQVUsZUFBZSxDQUM3QixLQUFpQixFQUNqQixTQUFxQjtJQUVyQiw2QkFBNkIsQ0FBQyxZQUFZLENBQUMsQ0FBQztJQUU1QyxJQUFJLFNBQVMsS0FBSyxTQUFTLEVBQUU7UUFDM0IsT0FBTyxDQUFDLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxJQUFJLENBQzVCLENBQUMsQ0FBQyxhQUFhLENBQUMsRUFBRSxFQUFFLENBQUMsYUFBYSxLQUFLLEtBQUssQ0FDN0MsQ0FBQztLQUNIO0lBRUQsT0FBTyxDQUFDLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxJQUFJLENBQzVCLENBQUMsQ0FBQyxhQUFhLEVBQUUsaUJBQWlCLENBQUMsRUFBRSxFQUFFLENBQ3JDLGFBQWEsS0FBSyxLQUFLLElBQUksaUJBQWlCLEtBQUssU0FBUyxDQUM3RCxDQUFDO0FBQ0osQ0FBQyJ9

package/features/stageHistory.lua

@@ -60,3 +60,5 @@ function ____exports.hasVisitedStage(self, stage, stageType)
     )
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc3RhZ2VIaXN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztNQTBCUyx1QkFqQkg7QUFSTiwwQkFBcUI7QUFBWjtBQUVULDhCQUFrQztBQUF6QjtBQUNULGdDQUE4QztBQUFyQztBQUNULG9CQUFnQztBQUF2QjtBQXFCVCxTQUFTO0FBQ0Qsa0JBQVEsS0FBSztBQUNiLGtCQUFRLE1BQU07QUFDZCxzQkFBWSxNQUFNO1VBRXhCO0FBQUEsOERBQXdCLENBQUMsT0FBTzs7QUF4QjVCLHFCQUFlO0FBRWYsSUFBSSxDQUNSLE1BQUssQ0FDSCxlQUFjOzs7QUFLbEIsNENBQWlDO0lBQy9CLHFCQUFnQixjQUFjO0lBRTlCLElBQUksa0JBQ0YsNENBQ0E7QUFMSjs7QUFtQkE7SUFHRSxtQ0FBOEI7QUFDOUIsV0FBTztBQUpUOzs7Ozs7O0FBZUEsMkNBQ0UsT0FDQTtJQUVBLG1DQUE4QjtPQUUxQjtBQUNGLGVBQU87WUFBQTtZQUNMO3NCQUFFO2dCQUFBO0FBQW1CLHdDQUFrQjtZQUF2Qzs7O0FBSUosV0FBTztRQUFBO1FBQ0w7a0JBQWlCO2tCQUFmO1lBQUE7WUFBZTtBQUNmLG9DQUFrQixVQUFTLHFCQUFzQjtRQURuRDs7QUFiSiIsImZpbGUiOiJzdGFnZUhpc3RvcnkubHVhIiwic291cmNlUm9vdCI6IiJ9

package/features/taintedLazarusPlayers.js

@@ -0,0 +1,92 @@
+// This feature provides a way for end-users to get the `EntityPlayer` object for the other Tainted
+// Lazarus.
+import { ModCallback, PlayerType } from "isaac-typescript-definitions";
+import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
+import { saveDataManager } from "./saveDataManager/exports";
+const FEATURE_NAME = "taintedLazarusPlayers";
+const v = {
+    run: {
+        queuedTaintedLazarus: [],
+        queuedDeadTaintedLazarus: [],
+        /**
+         * The PostPlayerInit callback fires for Dead Tainted Lazarus at the beginning of the run.
+         * However, the player index for the Dead Tainted Lazarus player object at that time does not
+         * actually correspond to the player index for the real player once Flip has been used. Thus, we
+         * revert to using PtrHash as an index for our map, which is consistent between the Dead Tainted
+         * Lazarus object in the PostPlayerInit callback and the "real" Dead Tainted Lazarus.
+         */
+        subPlayerMap: new Map(),
+    },
+};
+/** @internal */
+export function taintedLazarusPlayersInit(mod) {
+    saveDataManager(FEATURE_NAME, v, () => false);
+    mod.AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit);
+}
+// ModCallback.POST_PLAYER_INIT (9)
+function postPlayerInit(player) {
+    const entityPtr = EntityPtr(player);
+    const character = player.GetPlayerType();
+    if (character === PlayerType.LAZARUS_B) {
+        v.run.queuedTaintedLazarus.push(entityPtr);
+    }
+    else if (character === PlayerType.LAZARUS_2_B) {
+        v.run.queuedDeadTaintedLazarus.push(entityPtr);
+    }
+    else {
+        return;
+    }
+    checkDequeue();
+}
+/**
+ * When starting a run, the PostPlayerInit callback will fire first for Dead Tainted Lazarus, then
+ * for Tainted Lazarus. When continuing a run, the PostPlayerInit callback will fire first for the
+ * character that is currently active. Thus, since the order of the characters is not certain, we
+ * insert each of their pointers into a queue, and then only populate the map when we have one
+ * Tainted Lazarus and one Dead Tainted Lazarus.
+ */
+function checkDequeue() {
+    if (v.run.queuedTaintedLazarus.length === 0 ||
+        v.run.queuedDeadTaintedLazarus.length === 0) {
+        return;
+    }
+    const taintedLazarusPtr = v.run.queuedTaintedLazarus.shift();
+    const deadTaintedLazarusPtr = v.run.queuedDeadTaintedLazarus.shift();
+    if (taintedLazarusPtr === undefined || deadTaintedLazarusPtr === undefined) {
+        return;
+    }
+    const taintedLazarus = taintedLazarusPtr.Ref;
+    const deadTaintedLazarus = deadTaintedLazarusPtr.Ref;
+    if (taintedLazarus === undefined || deadTaintedLazarus === undefined) {
+        return;
+    }
+    const taintedLazarusPtrHash = GetPtrHash(taintedLazarus);
+    const deadTaintedLazarusPtrHash = GetPtrHash(deadTaintedLazarus);
+    v.run.subPlayerMap.set(taintedLazarusPtrHash, deadTaintedLazarusPtr);
+    v.run.subPlayerMap.set(deadTaintedLazarusPtrHash, taintedLazarusPtr);
+}
+/**
+ * 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 function getTaintedLazarusSubPlayer(player) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    const ptrHash = GetPtrHash(player);
+    const entityPtr = v.run.subPlayerMap.get(ptrHash);
+    if (entityPtr === undefined) {
+        return undefined;
+    }
+    const entity = entityPtr.Ref;
+    if (entity === undefined) {
+        return undefined;
+    }
+    return entity.ToPlayer();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFpbnRlZExhemFydXNQbGF5ZXJzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mZWF0dXJlcy90YWludGVkTGF6YXJ1c1BsYXllcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsbUdBQW1HO0FBQ25HLFdBQVc7QUFFWCxPQUFPLEVBQUUsV0FBVyxFQUFFLFVBQVUsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ3ZFLE9BQU8sRUFBRSw2QkFBNkIsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ3ZFLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUU1RCxNQUFNLFlBQVksR0FBRyx1QkFBdUIsQ0FBQztBQUU3QyxNQUFNLENBQUMsR0FBRztJQUNSLEdBQUcsRUFBRTtRQUNILG9CQUFvQixFQUFFLEVBQWlCO1FBQ3ZDLHdCQUF3QixFQUFFLEVBQWlCO1FBRTNDOzs7Ozs7V0FNRztRQUNILFlBQVksRUFBRSxJQUFJLEdBQUcsRUFBc0I7S0FDNUM7Q0FDRixDQUFDO0FBRUYsZ0JBQWdCO0FBQ2hCLE1BQU0sVUFBVSx5QkFBeUIsQ0FBQyxHQUFRO0lBQ2hELGVBQWUsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBRTlDLEdBQUcsQ0FBQyxXQUFXLENBQUMsV0FBVyxDQUFDLGdCQUFnQixFQUFFLGNBQWMsQ0FBQyxDQUFDO0FBQ2hFLENBQUM7QUFFRCxtQ0FBbUM7QUFDbkMsU0FBUyxjQUFjLENBQUMsTUFBb0I7SUFDMUMsTUFBTSxTQUFTLEdBQUcsU0FBUyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3BDLE1BQU0sU0FBUyxHQUFHLE1BQU0sQ0FBQyxhQUFhLEVBQUUsQ0FBQztJQUV6QyxJQUFJLFNBQVMsS0FBSyxVQUFVLENBQUMsU0FBUyxFQUFFO1FBQ3RDLENBQUMsQ0FBQyxHQUFHLENBQUMsb0JBQW9CLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDO0tBQzVDO1NBQU0sSUFBSSxTQUFTLEtBQUssVUFBVSxDQUFDLFdBQVcsRUFBRTtRQUMvQyxDQUFDLENBQUMsR0FBRyxDQUFDLHdCQUF3QixDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQztLQUNoRDtTQUFNO1FBQ0wsT0FBTztLQUNSO0lBRUQsWUFBWSxFQUFFLENBQUM7QUFDakIsQ0FBQztBQUVEOzs7Ozs7R0FNRztBQUNILFNBQVMsWUFBWTtJQUNuQixJQUNFLENBQUMsQ0FBQyxHQUFHLENBQUMsb0JBQW9CLENBQUMsTUFBTSxLQUFLLENBQUM7UUFDdkMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyx3QkFBd0IsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUMzQztRQUNBLE9BQU87S0FDUjtJQUVELE1BQU0saUJBQWlCLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxvQkFBb0IsQ0FBQyxLQUFLLEVBQUUsQ0FBQztJQUM3RCxNQUFNLHFCQUFxQixHQUFHLENBQUMsQ0FBQyxHQUFHLENBQUMsd0JBQXdCLENBQUMsS0FBSyxFQUFFLENBQUM7SUFFckUsSUFBSSxpQkFBaUIsS0FBSyxTQUFTLElBQUkscUJBQXFCLEtBQUssU0FBUyxFQUFFO1FBQzFFLE9BQU87S0FDUjtJQUVELE1BQU0sY0FBYyxHQUFHLGlCQUFpQixDQUFDLEdBQUcsQ0FBQztJQUM3QyxNQUFNLGtCQUFrQixHQUFHLHFCQUFxQixDQUFDLEdBQUcsQ0FBQztJQUVyRCxJQUFJLGNBQWMsS0FBSyxTQUFTLElBQUksa0JBQWtCLEtBQUssU0FBUyxFQUFFO1FBQ3BFLE9BQU87S0FDUjtJQUVELE1BQU0scUJBQXFCLEdBQUcsVUFBVSxDQUFDLGNBQWMsQ0FBQyxDQUFDO0lBQ3pELE1BQU0seUJBQXlCLEdBQUcsVUFBVSxDQUFDLGtCQUFrQixDQUFDLENBQUM7SUFFakUsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsR0FBRyxDQUFDLHFCQUFxQixFQUFFLHFCQUFxQixDQUFDLENBQUM7SUFDckUsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsR0FBRyxDQUFDLHlCQUF5QixFQUFFLGlCQUFpQixDQUFDLENBQUM7QUFDdkUsQ0FBQztBQUVEOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFNLFVBQVUsMEJBQTBCLENBQ3hDLE1BQW9CO0lBRXBCLDZCQUE2QixDQUFDLFlBQVksQ0FBQyxDQUFDO0lBRTVDLE1BQU0sT0FBTyxHQUFHLFVBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNuQyxNQUFNLFNBQVMsR0FBRyxDQUFDLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDbEQsSUFBSSxTQUFTLEtBQUssU0FBUyxFQUFFO1FBQzNCLE9BQU8sU0FBUyxDQUFDO0tBQ2xCO0lBRUQsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLEdBQUcsQ0FBQztJQUM3QixJQUFJLE1BQU0sS0FBSyxTQUFTLEVBQUU7UUFDeEIsT0FBTyxTQUFTLENBQUM7S0FDbEI7SUFFRCxPQUFPLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQztBQUMzQixDQUFDIn0=

package/features/taintedLazarusPlayers.lua

@@ -83,3 +83,5 @@ function ____exports.getTaintedLazarusSubPlayer(self, player)
     return entity:ToPlayer()
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvdGFpbnRlZExhemFydXNQbGF5ZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7TUFpQ1MsZ0JBc0JBLGNBOUNIO0FBTk4sNkNBQXdDO0FBQS9CO0FBQWE7QUFDdEIsZ0NBQThDO0FBQXJDO0FBQ1Qsb0JBQWdDO0FBQXZCO0FBNEJULFNBQVMscUJBQWU7QUFDaEIsc0JBQVksVUFBVTtBQUN0QixzQkFBWSxPQUFPO09BRXJCLGFBQWM7Y0FDaEI7QUFBQSxrRkFBZ0M7V0FDdkIsYUFBYztjQUN2QjtBQUFBLDBGQUFvQzs7QUFFcEM7O0lBR0Y7O0FBVUYsU0FBUztPQUVMLCtCQUFzQyxLQUN0QyxtQ0FBMEM7QUFFMUM7O0FBR0ksOEJBQW9CO0FBQ3BCLGtDQUF3QjtPQUUxQiw0QkFBbUM7QUFDckM7O0FBR0ksMkJBQWlCO0FBQ2pCLCtCQUFxQjtPQUV2Qix5QkFBZ0M7QUFDbEM7O0FBR0ksa0NBQXdCLFdBQVc7QUFDbkMsc0NBQTRCLFdBQVc7SUFFN0MsbUJBQW1CLElBQUksdUJBQXVCO0lBQzlDLG1CQUFtQixJQUFJLDJCQUEyQjs7QUExRTlDLHFCQUFlO0FBRWYsSUFBSSxDQUNSLE1BQUs7SUFDSCx1QkFBc0I7SUFDdEIsMkJBQTBCO0lBUzFCLGVBQWMsVUFBSTs7OztBQUt0QixxREFBMEM7SUFDeEM7O1FBQWdCO1FBQWM7UUFBRyxXQUFNLFlBQU47O0lBRWpDLElBQUksWUFBWSw4QkFBOEI7QUFIaEQ7Ozs7Ozs7Ozs7QUFxRUEsc0RBQ0U7SUFFQSxtQ0FBOEI7QUFFeEIsb0JBQVUsV0FBVztBQUNyQixzQkFBWSxtQkFBbUIsSUFBSTtPQUNyQztBQUNGOztBQUdJLG1CQUFTO09BQ1g7QUFDRjs7QUFHRixXQUFPLE9BQU87QUFoQmhCIiwiZmlsZSI6InRhaW50ZWRMYXphcnVzUGxheWVycy5sdWEiLCJzb3VyY2VSb290IjoiIn0=

package/featuresInitialized.js

@@ -0,0 +1,16 @@
+let featuresInitialized = false;
+/** @internal */
+export function areFeaturesInitialized() {
+    return featuresInitialized;
+}
+/** @internal */
+export function errorIfFeaturesNotInitialized(featureName) {
+    if (!areFeaturesInitialized()) {
+        error(`The "${featureName}" feature is not initialized. You must first upgrade your mod object by calling the "upgradeMod" function.`);
+    }
+}
+/** @internal */
+export function setFeaturesInitialized() {
+    featuresInitialized = true;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZXNJbml0aWFsaXplZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXNJbml0aWFsaXplZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxJQUFJLG1CQUFtQixHQUFHLEtBQUssQ0FBQztBQUVoQyxnQkFBZ0I7QUFDaEIsTUFBTSxVQUFVLHNCQUFzQjtJQUNwQyxPQUFPLG1CQUFtQixDQUFDO0FBQzdCLENBQUM7QUFFRCxnQkFBZ0I7QUFDaEIsTUFBTSxVQUFVLDZCQUE2QixDQUFDLFdBQW1CO0lBQy9ELElBQUksQ0FBQyxzQkFBc0IsRUFBRSxFQUFFO1FBQzdCLEtBQUssQ0FDSCxRQUFRLFdBQVcsNEdBQTRHLENBQ2hJLENBQUM7S0FDSDtBQUNILENBQUM7QUFFRCxnQkFBZ0I7QUFDaEIsTUFBTSxVQUFVLHNCQUFzQjtJQUNwQyxtQkFBbUIsR0FBRyxJQUFJLENBQUM7QUFDN0IsQ0FBQyJ9

package/featuresInitialized.lua

@@ -18,3 +18,5 @@ function ____exports.setFeaturesInitialized(self)
     featuresInitialized = true
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXNJbml0aWFsaXplZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUksNEJBQXNCOzs7QUFHMUI7QUFDRSxXQUFPO0FBRFQ7OztBQUtBLHlEQUE4QztXQUN2QztRQUNILE9BQ0UsWUFBUSxnQkFBVzs7QUFIekI7OztBQVNBO0FBQ0UsMEJBQXNCO0FBRHhCIiwiZmlsZSI6ImZlYXR1cmVzSW5pdGlhbGl6ZWQubHVhIiwic291cmNlUm9vdCI6IiJ9

package/functions/ambush.js

@@ -0,0 +1,35 @@
+import { SackSubType } from "isaac-typescript-definitions";
+import { runNextGameFrame } from "../features/runInNFrames";
+import { removeEntities } from "./entity";
+import { getCoins, spawnSackWithSeed } from "./pickups";
+/** Hard-coding this makes it easier to clean up the pickups afterwards. */
+const 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.
+ */
+export function startAmbush() {
+    const player = Isaac.GetPlayer();
+    const sack = spawnSackWithSeed(SackSubType.NULL, player.Position, SACK_SEED_THAT_SPAWNS_TWO_COINS);
+    // The sack will play the "Appear" animation and the player will not be able to interact with it
+    // while this is occurring. By stopping the animation, it will transition to the "Idle" animation
+    // and be interactable on the next game frame.
+    const sprite = sack.GetSprite();
+    sprite.Stop();
+    const sackPtr = EntityPtr(sack);
+    runNextGameFrame(() => {
+        const futureSack = sackPtr.Ref;
+        if (futureSack === undefined) {
+            return;
+        }
+        futureSack.Remove();
+        const sackPtrHash = GetPtrHash(futureSack);
+        const coins = getCoins();
+        const coinsFromSack = coins.filter((pickup) => pickup.SpawnerEntity !== undefined &&
+            GetPtrHash(pickup.SpawnerEntity) === sackPtrHash);
+        removeEntities(coinsFromSack);
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYW1idXNoLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvYW1idXNoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUMzRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUM1RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQzFDLE9BQU8sRUFBRSxRQUFRLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFFeEQsMkVBQTJFO0FBQzNFLE1BQU0sK0JBQStCLEdBQUcsQ0FBUyxDQUFDO0FBRWxEOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLFdBQVc7SUFDekIsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBQ2pDLE1BQU0sSUFBSSxHQUFHLGlCQUFpQixDQUM1QixXQUFXLENBQUMsSUFBSSxFQUNoQixNQUFNLENBQUMsUUFBUSxFQUNmLCtCQUErQixDQUNoQyxDQUFDO0lBRUYsZ0dBQWdHO0lBQ2hHLGlHQUFpRztJQUNqRyw4Q0FBOEM7SUFDOUMsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBQ2hDLE1BQU0sQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNkLE1BQU0sT0FBTyxHQUFHLFNBQVMsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNoQyxnQkFBZ0IsQ0FBQyxHQUFHLEVBQUU7UUFDcEIsTUFBTSxVQUFVLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQztRQUMvQixJQUFJLFVBQVUsS0FBSyxTQUFTLEVBQUU7WUFDNUIsT0FBTztTQUNSO1FBRUQsVUFBVSxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ3BCLE1BQU0sV0FBVyxHQUFHLFVBQVUsQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUMzQyxNQUFNLEtBQUssR0FBRyxRQUFRLEVBQUUsQ0FBQztRQUN6QixNQUFNLGFBQWEsR0FBRyxLQUFLLENBQUMsTUFBTSxDQUNoQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQ1QsTUFBTSxDQUFDLGFBQWEsS0FBSyxTQUFTO1lBQ2xDLFVBQVUsQ0FBQyxNQUFNLENBQUMsYUFBYSxDQUFDLEtBQUssV0FBVyxDQUNuRCxDQUFDO1FBQ0YsY0FBYyxDQUFDLGFBQWEsQ0FBQyxDQUFDO0lBQ2hDLENBQUMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQyJ9

package/functions/ambush.lua

@@ -41,3 +41,5 @@ function ____exports.startAmbush(self)
     )
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL2FtYnVzaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSw2Q0FBNEI7QUFBbkI7QUFDVCx5QkFBaUM7QUFBeEI7QUFDVCxtQkFBK0I7QUFBdEI7QUFDVCxvQkFBNEM7QUFBbkM7QUFBVTs7QUFHYix3Q0FBa0M7Ozs7O0FBUXhDO0FBQ1EsbUJBQVM7QUFDVCxpQkFBTyx1QkFDWCxrQkFDQSxpQkFDQTtBQU1JLG1CQUFTLEtBQUs7SUFDcEIsT0FBTztBQUNELG9CQUFVLFVBQVU7SUFDMUI7O1FBQWlCO0FBQ1QsK0JBQWE7ZUFDZjtBQUNGOztZQUdGLFdBQVc7QUFDTCxnQ0FBYyxXQUFXO0FBQ3pCLDBCQUFRO0FBQ1Isa0NBQWdCO2dCQUFBO2dCQUNwQixlQUFDLFFBQ0MsdUNBQ0EsV0FBVyx5QkFBMEIsV0FGdkM7O1lBSUYsb0JBQWU7UUFkQTs7QUFkbkIiLCJmaWxlIjoiYW1idXNoLmx1YSIsInNvdXJjZVJvb3QiOiIifQ==