isaacscript-common 1.2.157 → 1.2.160

package/dist/features/isPonyActive.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
- * When used on The Forgotten, switches to The Soul. When used on The Soul, switches to The
- * Forgotten. This takes 1 game frame to take effect.
+ * Helper function to see if the player is under the effects of A Pony or White Pony charge.
+ * Detecting this is difficult, as the temporary effect will disappear upon entering a new room.
  */
 export declare function isPonyActive(player: EntityPlayer): boolean;

package/dist/features/runInNFrames.lua

@@ -40,9 +40,14 @@ function checkExecuteQueuedFunctions(self, frameCount, functionTuples)
     end
 end
 local FEATURE_NAME = "run in N frames"
-v = {dontSave = true, run = {queuedGameFunctionTuples = {}, queuedRenderFunctionTuples = {}}}
+v = {run = {queuedGameFunctionTuples = {}, queuedRenderFunctionTuples = {}}}
 function ____exports.runInNFramesInit(self, mod)
-    saveDataManager(nil, "runInNFrames", v)
+    saveDataManager(
+        nil,
+        "runInNFrames",
+        v,
+        function() return false end
+    )
     mod:AddCallback(ModCallbacks.MC_POST_UPDATE, postUpdate)
     mod:AddCallback(ModCallbacks.MC_POST_RENDER, postRender)
 end

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

@@ -69,9 +69,11 @@ import { SaveData } from "../../types/private/SaveData";
  * manager. The save data manager will throw an error if the key is already registered.
  * @param saveData An object that corresponds to the `SaveData` interface. The object is
  * conventionally called "v" for brevity (which is short for "local variables").
- * @param conditionalFunc An optional function to run upon saving this key to disk. If the function
- * returns false, the key will not be written to disk. This allows mod features to avoid cluttering
- * the "save#.dat" file with unnecessary keys.
+ * @param conditionalFunc An optional function to run upon saving this key to disk. For example,
+ * this allows features to only save data to disk if the feature is enabled. Specify a value of
+ * `() => false` to completely disable saving this feature to disk. This is useful if you are using
+ * data that is not serializable, or you want to use the save data manager to automatically reset
+ * variables on run/level/room, but not clutter the the "save#.dat" file with unnecessary keys.
  */
 export declare function saveDataManager(key: string, saveData: SaveData, conditionalFunc?: () => boolean): void;
 /**

package/dist/features/saveDataManager/exports.lua

@@ -29,7 +29,7 @@ function ____exports.saveDataManager(self, key, saveData, conditionalFunc)
     saveDataMap[key] = saveData
     local saveDataKeys = __TS__ObjectKeys(saveData)
     if #saveDataKeys == 1 and saveDataKeys[1] == "room" then
-        saveData.dontSave = true
+        conditionalFunc = function() return false end
     end
     local saveDataTable = saveData
     local saveDataTableCopy = deepCopy(nil, saveDataTable, SerializationType.NONE, key)

package/dist/features/saveDataManager/save.lua

@@ -17,9 +17,6 @@ function getAllSaveDataToWriteToDisk(self, saveDataMap, saveDataConditionalFuncM
     local allSaveData = {}
     for subscriberName, saveData in pairs(saveDataMap) do
         do
-            if saveData.dontSave ~= nil then
-                goto __continue4
-            end
             local conditionalFunc = saveDataConditionalFuncMap:get(subscriberName)
             if conditionalFunc ~= nil then
                 local shouldSave = conditionalFunc(nil)

package/dist/features/taintedLazarusPlayers.d.ts

@@ -0,0 +1,13 @@
+/// <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;

package/dist/features/taintedLazarusPlayers.lua

@@ -0,0 +1,72 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
+local __TS__ArrayShift = ____lualib.__TS__ArrayShift
+local ____exports = {}
+local postPlayerInit, checkDequeue, v
+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.PLAYER_LAZARUS_B then
+        __TS__ArrayPush(v.run.queuedTaintedLazarus, entityPtr)
+    elseif character == PlayerType.PLAYER_LAZARUS2_B then
+        __TS__ArrayPush(v.run.queuedDeadTaintedLazarus, 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 = __TS__ArrayShift(v.run.queuedTaintedLazarus)
+    local deadTaintedLazarusPtr = __TS__ArrayShift(v.run.queuedDeadTaintedLazarus)
+    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 = "Tainted Lazarus entity finder"
+v = {run = {
+    queuedTaintedLazarus = {},
+    queuedDeadTaintedLazarus = {},
+    subPlayerMap = __TS__New(Map)
+}}
+function ____exports.taintedLazarusPlayersInit(self, mod)
+    saveDataManager(
+        nil,
+        "taintedLazarusPlayers",
+        v,
+        function() return false end
+    )
+    mod:AddCallback(ModCallbacks.MC_POST_PLAYER_INIT, postPlayerInit)
+end
+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/functions/log.d.ts

@@ -15,7 +15,7 @@ export declare function logAllDamageFlags(this: void, flags: int): void;
 /** Helper function for printing out every entity flag that is turned on. Useful when debugging. */
 export declare function logAllEntityFlags(this: void, flags: int): void;
 /** Helper function for printing out every flag that is turned on. Useful when debugging. */
-export declare function logAllFlags(this: void, flags: int, flagEnum: LuaTable, description?: string): void;
+export declare function logAllFlags(this: void, flags: int, flagEnum?: LuaTable, description?: string): void;
 /**
  * Helper function for printing out every game state flag that is turned on. Useful when debugging.
  */

package/dist/functions/log.lua

@@ -62,13 +62,29 @@ function ____exports.logAllFlags(flags, flagEnum, description)
     if description ~= "" then
         description = description .. " "
     end
-    ____exports.log(("Logging all " .. description) .. "flags:")
+    if flagEnum == nil then
+        flagEnum = {}
+        do
+            local i = 0
+            while i <= 62 do
+                flagEnum["1 << " .. tostring(i)] = 1 << i
+                i = i + 1
+            end
+        end
+    end
+    ____exports.log(((("Logging all " .. description) .. "flags for value ") .. tostring(flags)) .. ":")
     local hasNoFlags = true
     for key, value in pairs(flagEnum) do
-        if hasFlag(nil, flags, value) then
-            ____exports.log(((("  Has flag: " .. tostring(key)) .. " (") .. tostring(value)) .. ")")
-            hasNoFlags = false
+        do
+            if type(value) ~= "number" then
+                goto __continue13
+            end
+            if hasFlag(nil, flags, value) then
+                ____exports.log(((("  Has flag: " .. tostring(key)) .. " (") .. tostring(value)) .. ")")
+                hasNoFlags = false
+            end
         end
+        ::__continue13::
     end
     if hasNoFlags then
         ____exports.log("  n/a (no flags)")

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export { preventCollectibleRotate } from "./features/preventCollectibleRotate";
 export { runInNGameFrames, runInNRenderFrames, runNextGameFrame, runNextRenderFrame, } from "./features/runInNFrames";
 export * from "./features/saveDataManager/exports";
 export { hasSirenStolenFamiliar, setFamiliarNoSirenSteal, } from "./features/sirenHelpers";
+export { getTaintedLazarusSubPlayer } from "./features/taintedLazarusPlayers";
 export * from "./functions/array";
 export * from "./functions/bitwise";
 export * from "./functions/cards";

package/dist/index.lua

@@ -126,6 +126,11 @@ do
     ____exports.hasSirenStolenFamiliar = hasSirenStolenFamiliar
     ____exports.setFamiliarNoSirenSteal = setFamiliarNoSirenSteal
 end
+do
+    local ____taintedLazarusPlayers = require("features.taintedLazarusPlayers")
+    local getTaintedLazarusSubPlayer = ____taintedLazarusPlayers.getTaintedLazarusSubPlayer
+    ____exports.getTaintedLazarusSubPlayer = getTaintedLazarusSubPlayer
+end
 do
     local ____export = require("functions.array")
     for ____exportKey, ____exportValue in pairs(____export) do

package/dist/types/private/SaveData.d.ts

@@ -3,7 +3,6 @@ export interface SaveData {
     run?: Record<string, unknown>;
     level?: Record<string, unknown>;
     room?: Record<string, unknown>;
-    dontSave?: boolean;
 }
 export interface SaveDataWithoutRoom {
     persistent?: Record<string, unknown>;

package/dist/upgradeMod.lua

@@ -95,6 +95,8 @@ local ____main = require("features.saveDataManager.main")
 local saveDataManagerInit = ____main.saveDataManagerInit
 local ____sirenHelpers = require("features.sirenHelpers")
 local sirenHelpersInit = ____sirenHelpers.sirenHelpersInit
+local ____taintedLazarusPlayers = require("features.taintedLazarusPlayers")
+local taintedLazarusPlayersInit = ____taintedLazarusPlayers.taintedLazarusPlayersInit
 local ____featuresInitialized = require("featuresInitialized")
 local areFeaturesInitialized = ____featuresInitialized.areFeaturesInitialized
 local setFeaturesInitialized = ____featuresInitialized.setFeaturesInitialized
@@ -149,6 +151,7 @@ function initFeatures(self, mod)
     sirenHelpersInit(nil, mod)
     isPonyActiveInit(nil, mod)
     playerInventoryInit(nil, mod)
+    taintedLazarusPlayersInit(nil, mod)
 end
 function ____exports.upgradeMod(self, modVanilla, verbose)
     if verbose == nil then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.157",
+  "version": "1.2.160",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",