isaacscript-common 6.6.1-dev.0 → 6.6.1-dev.4

package/dist/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=save.js.map

package/dist/features/saveDataManager/save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"../src/","sources":["features/saveDataManager/save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EACL,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAEpC,MAAM,UAAU,UAAU,CACxB,GAAQ,EACR,WAAuC,EACvC,0BAAsD;IAEtD,MAAM,WAAW,GAAG,2BAA2B,CAC7C,WAAW,EACX,0BAA0B,CAC3B,CAAC;IACF,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3C,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,mCAAmC;IAC7D,GAAG,CACD,OAAO,8BAA8B,sCAAsC,CAC5E,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,WAAuC,EACvC,0BAAsD;IAEtD,MAAM,WAAW,GAAG,IAAI,QAAQ,EAAsB,CAAC;IAEvD,mBAAmB,CACjB,WAAW,EACX,CAAC,cAAc,EAAE,QAAQ,EAAE,EAAE;QAC3B,2FAA2F;QAC3F,4BAA4B;QAC5B,MAAM,eAAe,GAAG,0BAA0B,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACvE,IAAI,eAAe,KAAK,SAAS,EAAE;YACjC,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,EAAE;gBACf,OAAO;aACR;SACF;QAED,4CAA4C;QAC5C,MAAM,mBAAmB,GAAa;YACpC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;QAEF,gEAAgE;QAChE,IAAI,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;YACjD,OAAO;SACR;QAED,0FAA0F;QAC1F,2FAA2F;QAC3F,wBAAwB;QACxB,MAAM,YAAY,GAAG,QAAQ,CAC3B,mBAA+B,EAC/B,iBAAiB,CAAC,SAAS,EAC3B,cAAc,CACf,CAAC;QAEF,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC,EACD,uBAAuB,CACxB,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/features/saveDataManager/save.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/save.ts"],"names":[],"mappings":";;;;MA2BS;AA3BT,8BAAkC;AAAzB;AACT,qBAAyB;AAAhB;AACT,wBAA2B;AAAlB;AACT,gBAAoB;AAAX;AACT,kBAAoC;AAA3B;AAET,qCAGO;AAFL;AACA;AAmBF,SAAS,kCACP,aACA;AAEM,wBAAc;IAEpB;;QACE;QACA,eAAC,gBAAgB;AAGT,oCAAkB,2BAA2B,IAAI;eACnD;AACI,mCAAa;uBACd;AACH;;;AAKE,wCAAgC,CACpC,aAAY,qBACZ,MAAK,cACL,QAAO;eAIL,kBAAY,wBAAgC;AAC9C;;AAMI,iCAAe,cACnB,qBACA,6BACA;AAGF,wBAAgB,kBAAgB;QAhClC;QAkCA;;AAGF,WAAO;;AA7DT,sCACE,KACA,aACA;AAEM,wBAAc,iCAClB,aACA;AAEI,uBAAa,gBAAW;IAC9B,IAAI,SAAS;IACb,KACE,UAAO,mCAA8B;AAZzC","file":"save.lua","sourceRoot":"../src/"}

package/dist/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=saveDataManagerConstants.js.map

package/dist/features/saveDataManager/saveDataManagerConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveDataManagerConstants.js","sourceRoot":"../src/","sources":["features/saveDataManager/saveDataManagerConstants.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,MAAM,CAAC,MAAM,8BAA8B,GAAG,mBAAmB,CAAC"}

package/dist/features/saveDataManager/saveDataManagerConstants.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/saveDataManagerConstants.ts"],"names":[],"mappings":";;AACa,sCAA0B;AAE1B,6CAAiC","file":"saveDataManagerConstants.lua","sourceRoot":"../src/"}

package/dist/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=serializationBrand.js.map

package/dist/features/saveDataManager/serializationBrand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializationBrand.js","sourceRoot":"../src/","sources":["features/saveDataManager/serializationBrand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,oBAAoB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;AAC/D,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAC1D,oBAAoB,CACrB,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QAClB,OAAO,KAAK,CAAC;KACd;IAED,OAAO,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/features/saveDataManager/serializationBrand.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/serializationBrand.ts"],"names":[],"mappings":";;;;AAAA,+BAAmC;AAA1B;AACT,kBAA8B;AAArB;AACT,kBAAyB;AAAhB;AAEH,6BAAuB,mBAAc;AACrC,gCAA+C,UAAI,KACvD;AAGF,gDAAqC;WAC9B,cAAS;AACZ,eAAO;;AAGT,WAAO,wBAAwB,IAAI;AALrC","file":"serializationBrand.lua","sourceRoot":"../src/"}

package/dist/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=sirenHelpers.js.map

package/dist/features/sirenHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sirenHelpers.js","sourceRoot":"../src/","sources":["features/sirenHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,WAAW,GACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,MAAM,CAAC,GAAG;IACR,GAAG,EAAE;QACH,iBAAiB,EAAE,EAElB;KACF;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,eAAe,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAEjC,GAAG,CAAC,WAAW,CACb,WAAW,CAAC,aAAa,EACzB,sBAAsB,EACtB,UAAU,CAAC,YAAY,CACxB,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,gCAAgC;AAChC,SAAS,sBAAsB,CAAC,GAAc;IAC5C,2BAA2B,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAc;IACjD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE;QAC5B,OAAO;KACR;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS,EAAE;QAC1B,OAAO;KACR;IAED,IAAI,oBAAoB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAC5D,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,QAAQ,CAAC,cAAc,EAAE,CAAC;KAC3B;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,uBAAwC,EACxC,uBAAwC;IAExC,KAAK,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,iBAAiB,EAAE;QACxE,IACE,uBAAuB,KAAK,eAAe;YAC3C,eAAe,KAAK,uBAAuB,EAC3C;YACA,mEAAmE;YACnE,OAAO,IAAI,CAAC;SACb;QAED,IACE,uBAAuB,KAAK,eAAe;YAC3C,eAAe,KAAK,SAAS,EAC7B;YACA,iEAAiE;YACjE,OAAO,IAAI,CAAC;SACb;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,eAAgC,EAChC,eAAqB;IAErB,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,oBAAoB,CAAC,eAAe,EAAE,eAAe,CAAC,EAAE;QAC1D,OAAO;KACR;IAED,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAwB;IAC7D,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,cAAc,CAAC,QAAwB;IAC9C,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE7C,MAAM,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC1D,OAAO,YAAY,CAAC,IAAI,CACtB,CAAC,WAAW,EAAE,EAAE,CACd,WAAW,CAAC,MAAM,KAAK,SAAS;QAChC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,eAAe,CACrD,CAAC;AACJ,CAAC"}

package/dist/features/sirenHelpers.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/features/sirenHelpers.ts"],"names":[],"mappings":";;;MAgCS,wBAIA,6BAgBA,sBAmEA,gBA5GH;AAXN,6CAIO;AAHL;AAEA;AAEF,gCAA8C;AAArC;AACT,mBAA4B;AAAnB;AACT,oBAAgC;AAAvB;AAyBT,SAAS,6BAAuB;IAC9B,iCAA4B;;AAG9B,SAAS,kCAA4B;OAC/B;AACF;;AAGI,qBAAW,WAAW;OACxB;AACF;;OAGE,0BAAqB,kBAAkB;QACzC,IAAI;QACJ,SAAS;;;AAIb,SAAS,2BACP,yBACA;AAEA,kCAAiD;cAArC;cAAiB;WAEzB,2BAA4B,oBAC5B,mBAAoB;AAGpB,mBAAO;;WAIP,2BAA4B,oBAC5B;AAGA,mBAAO;;;AAIX,WAAO;;AA6CT,SAAS,qBAAe;AAChB,4BAAkB,WAAW;AAE7B,yBAAe,iBAAY;AACjC,WAAO;QAAA;QACL,eAAC,aACC,qCACA,WAAW,uBAAwB,eAFrC;;;AAnHE,qBAAe;AAEf,IAAI,CACR,MAAK,CACH,oBAAmB;;;AAOvB,4CAAiC;IAC/B,qBAAgB,cAAc;IAE9B,IAAI,YACF,2BACA,wBACA;AANJ;;;;;;;AAiEA,mDACE,iBACA;IAEA,mCAA8B;OAE1B,0BAAqB,iBAAiB;AACxC;;UAGF;AAAA,wEAA6B,CAAC,iBAAiB;AAVjD;;;;;;AAoBA,kDAAuC;IACrC,mCAA8B;AAC9B,WAAO,oBAAe;AAFxB","file":"sirenHelpers.lua","sourceRoot":"../src/"}

package/dist/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=stageHistory.js.map

package/dist/features/stageHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stageHistory.js","sourceRoot":"../src/","sources":["features/stageHistory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,MAAM,CAAC,GAAG;IACR,GAAG,EAAE;QACH,YAAY,EAAE,EAAsD;KACrE;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,eAAe,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAEjC,GAAG,CAAC,iBAAiB,CACnB,iBAAiB,CAAC,wBAAwB,EAC1C,qBAAqB,CACtB,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,SAAS,qBAAqB;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IAEvC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,eAAe;IAG7B,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAiB,EACjB,SAAqB;IAErB,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,SAAS,KAAK,SAAS,EAAE;QAC3B,OAAO,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAC5B,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,aAAa,KAAK,KAAK,CAC7C,CAAC;KACH;IAED,OAAO,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAC5B,CAAC,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAAE,EAAE,CACrC,aAAa,KAAK,KAAK,IAAI,iBAAiB,KAAK,SAAS,CAC7D,CAAC;AACJ,CAAC"}

package/dist/features/stageHistory.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/features/stageHistory.ts"],"names":[],"mappings":";;;MA0BS,uBAjBH;AARN,0BAAqB;AAAZ;AAET,8BAAkC;AAAzB;AACT,gCAA8C;AAArC;AACT,oBAAgC;AAAvB;AAqBT,SAAS;AACD,kBAAQ,KAAK;AACb,kBAAQ,MAAM;AACd,sBAAY,MAAM;UAExB;AAAA,8DAAwB,CAAC,OAAO;;AAxB5B,qBAAe;AAEf,IAAI,CACR,MAAK,CACH,eAAc;;;AAKlB,4CAAiC;IAC/B,qBAAgB,cAAc;IAE9B,IAAI,kBACF,4CACA;AALJ;;AAmBA;IAGE,mCAA8B;AAC9B,WAAO;AAJT;;;;;;;AAeA,2CACE,OACA;IAEA,mCAA8B;OAE1B;AACF,eAAO;YAAA;YACL;sBAAE;gBAAA;AAAmB,wCAAkB;YAAvC;;;AAIJ,WAAO;QAAA;QACL;kBAAiB;kBAAf;YAAA;YAAe;AACf,oCAAkB,UAAS,qBAAsB;QADnD;;AAbJ","file":"stageHistory.lua","sourceRoot":"../src/"}

package/dist/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=taintedLazarusPlayers.js.map

package/dist/features/taintedLazarusPlayers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taintedLazarusPlayers.js","sourceRoot":"../src/","sources":["features/taintedLazarusPlayers.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,WAAW;AAEX,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C,MAAM,CAAC,GAAG;IACR,GAAG,EAAE;QACH,oBAAoB,EAAE,EAAiB;QACvC,wBAAwB,EAAE,EAAiB;QAE3C;;;;;;WAMG;QACH,YAAY,EAAE,IAAI,GAAG,EAAsB;KAC5C;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,UAAU,yBAAyB,CAAC,GAAQ;IAChD,eAAe,CAAC,YAAY,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAE9C,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,mCAAmC;AACnC,SAAS,cAAc,CAAC,MAAoB;IAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IAEzC,IAAI,SAAS,KAAK,UAAU,CAAC,SAAS,EAAE;QACtC,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAC5C;SAAM,IAAI,SAAS,KAAK,UAAU,CAAC,WAAW,EAAE;QAC/C,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAChD;SAAM;QACL,OAAO;KACR;IAED,YAAY,EAAE,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY;IACnB,IACE,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC;QACvC,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC,MAAM,KAAK,CAAC,EAC3C;QACA,OAAO;KACR;IAED,MAAM,iBAAiB,GAAG,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,EAAE,CAAC;IAC7D,MAAM,qBAAqB,GAAG,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,EAAE,CAAC;IAErE,IAAI,iBAAiB,KAAK,SAAS,IAAI,qBAAqB,KAAK,SAAS,EAAE;QAC1E,OAAO;KACR;IAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC;IAC7C,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,GAAG,CAAC;IAErD,IAAI,cAAc,KAAK,SAAS,IAAI,kBAAkB,KAAK,SAAS,EAAE;QACpE,OAAO;KACR;IAED,MAAM,qBAAqB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IACzD,MAAM,yBAAyB,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEjE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAC;IACrE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAoB;IAEpB,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,SAAS,KAAK,SAAS,EAAE;QAC3B,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,EAAE;QACxB,OAAO,SAAS,CAAC;KAClB;IAED,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/dist/features/taintedLazarusPlayers.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/features/taintedLazarusPlayers.ts"],"names":[],"mappings":";;;;MAiCS,gBAsBA,cA9CH;AANN,6CAAwC;AAA/B;AAAa;AACtB,gCAA8C;AAArC;AACT,oBAAgC;AAAvB;AA4BT,SAAS,qBAAe;AAChB,sBAAY,UAAU;AACtB,sBAAY,OAAO;OAErB,aAAc;cAChB;AAAA,kFAAgC;WACvB,aAAc;cACvB;AAAA,0FAAoC;;AAEpC;;IAGF;;AAUF,SAAS;OAEL,+BAAsC,KACtC,mCAA0C;AAE1C;;AAGI,8BAAoB;AACpB,kCAAwB;OAE1B,4BAAmC;AACrC;;AAGI,2BAAiB;AACjB,+BAAqB;OAEvB,yBAAgC;AAClC;;AAGI,kCAAwB,WAAW;AACnC,sCAA4B,WAAW;IAE7C,mBAAmB,IAAI,uBAAuB;IAC9C,mBAAmB,IAAI,2BAA2B;;AA1E9C,qBAAe;AAEf,IAAI,CACR,MAAK;IACH,uBAAsB;IACtB,2BAA0B;IAS1B,eAAc,UAAI;;;;AAKtB,qDAA0C;IACxC;;QAAgB;QAAc;QAAG,WAAM,YAAN;;IAEjC,IAAI,YAAY,8BAA8B;AAHhD;;;;;;;;;;AAqEA,sDACE;IAEA,mCAA8B;AAExB,oBAAU,WAAW;AACrB,sBAAY,mBAAmB,IAAI;OACrC;AACF;;AAGI,mBAAS;OACX;AACF;;AAGF,WAAO,OAAO;AAhBhB","file":"taintedLazarusPlayers.lua","sourceRoot":"../src/"}

package/dist/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=featuresInitialized.js.map

package/dist/featuresInitialized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featuresInitialized.js","sourceRoot":"../src/","sources":["featuresInitialized.ts"],"names":[],"mappings":"AAAA,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAEhC,gBAAgB;AAChB,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAC/D,IAAI,CAAC,sBAAsB,EAAE,EAAE;QAC7B,KAAK,CACH,QAAQ,WAAW,4GAA4G,CAChI,CAAC;KACH;AACH,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,sBAAsB;IACpC,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC"}

package/dist/featuresInitialized.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../packages/isaacscript-common/src/featuresInitialized.ts"],"names":[],"mappings":";AAAI,4BAAsB;;;AAG1B;AACE,WAAO;AADT;;;AAKA,yDAA8C;WACvC;QACH,OACE,YAAQ,gBAAW;;AAHzB;;;AASA;AACE,0BAAsB;AADxB","file":"featuresInitialized.lua","sourceRoot":"../src/"}

package/dist/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=ambush.js.map

package/dist/functions/ambush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambush.js","sourceRoot":"../src/","sources":["functions/ambush.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAExD,2EAA2E;AAC3E,MAAM,+BAA+B,GAAG,CAAS,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,iBAAiB,CAC5B,WAAW,CAAC,IAAI,EAChB,MAAM,CAAC,QAAQ,EACf,+BAA+B,CAChC,CAAC;IAEF,gGAAgG;IAChG,iGAAiG;IACjG,8CAA8C;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,gBAAgB,CAAC,GAAG,EAAE;QACpB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;QAC/B,IAAI,UAAU,KAAK,SAAS,EAAE;YAC5B,OAAO;SACR;QAED,UAAU,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAChC,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,aAAa,KAAK,SAAS;YAClC,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,WAAW,CACnD,CAAC;QACF,cAAc,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/functions/ambush.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/ambush.ts"],"names":[],"mappings":";;;AAAA,6CAA4B;AAAnB;AACT,yBAAiC;AAAxB;AACT,mBAA+B;AAAtB;AACT,oBAA4C;AAAnC;AAAU;;AAGb,wCAAkC;;;;;AAQxC;AACQ,mBAAS;AACT,iBAAO,uBACX,kBACA,iBACA;AAMI,mBAAS,KAAK;IACpB,OAAO;AACD,oBAAU,UAAU;IAC1B;;QAAiB;AACT,+BAAa;eACf;AACF;;YAGF,WAAW;AACL,gCAAc,WAAW;AACzB,0BAAQ;AACR,kCAAgB;gBAAA;gBACpB,eAAC,QACC,uCACA,WAAW,yBAA0B,WAFvC;;YAIF,oBAAe;QAdA;;AAdnB","file":"ambush.lua","sourceRoot":"../src/"}