isaacscript-common 1.2.81 → 1.2.84

package/dist/features/isPonyActive.d.ts

@@ -0,0 +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.
+ */
+export declare function isPonyActive(player: EntityPlayer): boolean;

package/dist/features/isPonyActive.lua

@@ -0,0 +1,50 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postPEffectUpdate, FLAGS_WHEN_PONY_IS_ACTIVE, v
+local ____errors = require("errors")
+local getUpgradeErrorMsg = ____errors.getUpgradeErrorMsg
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____player = require("functions.player")
+local getPlayerIndex = ____player.getPlayerIndex
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postPEffectUpdate(self, player)
+    local effects = player:GetEffects()
+    local entityFlags = player:GetEntityFlags()
+    local hasPonyCollectibleEffect = effects:HasCollectibleEffect(CollectibleType.COLLECTIBLE_PONY) or effects:HasCollectibleEffect(CollectibleType.COLLECTIBLE_WHITE_PONY)
+    local playerIndex = getPlayerIndex(nil, player)
+    local isPonyActiveOnPreviousFrame = v.run.playersIsPonyActive:has(playerIndex)
+    local hasPonyFlags = hasFlag(
+        nil,
+        entityFlags,
+        table.unpack(FLAGS_WHEN_PONY_IS_ACTIVE)
+    )
+    local isPonyActiveNow = hasPonyCollectibleEffect or isPonyActiveOnPreviousFrame and hasPonyFlags
+    if isPonyActiveNow then
+        v.run.playersIsPonyActive:add(playerIndex)
+    else
+        v.run.playersIsPonyActive:delete(playerIndex)
+    end
+end
+local FEATURE_NAME = "pony activation detector"
+FLAGS_WHEN_PONY_IS_ACTIVE = {EntityFlag.FLAG_NO_KNOCKBACK, EntityFlag.FLAG_NO_PHYSICS_KNOCKBACK, EntityFlag.FLAG_NO_DAMAGE_BLINK}
+local initialized = false
+v = {run = {playersIsPonyActive = __TS__New(Set)}}
+function ____exports.isPonyActiveInit(self, mod)
+    initialized = true
+    saveDataManager(nil, "isPonyActive", v)
+    mod:AddCallback(ModCallbacks.MC_POST_PEFFECT_UPDATE, postPEffectUpdate)
+end
+function ____exports.isPonyActive(self, player)
+    if not initialized then
+        local msg = getUpgradeErrorMsg(nil, FEATURE_NAME)
+        error(msg)
+    end
+    local playerIndex = getPlayerIndex(nil, player)
+    return v.run.playersIsPonyActive:has(playerIndex)
+end
+return ____exports

package/dist/functions/log.lua

@@ -43,13 +43,11 @@ function ____exports.logAllFlags(flags, flagEnum, description)
     end
     ____exports.log(("Logging all " .. description) .. "flags:")
     local hasNoFlags = true
-    local i = 1
     for key, value in pairs(flagEnum) do
         if hasFlag(nil, flags, value) then
-            ____exports.log(((((("  " .. tostring(i)) .. ") Has flag: ") .. tostring(key)) .. " (") .. tostring(value)) .. ")")
+            ____exports.log(((("  Has flag: " .. tostring(key)) .. " (") .. tostring(value)) .. ")")
             hasNoFlags = false
         end
-        i = i + 1
     end
     if hasNoFlags then
         ____exports.log("  n/a (no flags)")
@@ -65,15 +63,13 @@ function ____exports.logAllGameStateFlags()
     local game = Game()
     ____exports.log("Logging all game state flags:")
     local hasNoFlags = true
-    local i = 1
     for key, value in pairs(GameStateFlag) do
         local gameStateFlag = value
         local flagValue = game:GetStateFlag(gameStateFlag)
         if flagValue then
-            ____exports.log(((((("  " .. tostring(i)) .. ") Has flag: ") .. key) .. " (") .. tostring(value)) .. ")")
+            ____exports.log(((("  Has flag: " .. key) .. " (") .. tostring(value)) .. ")")
             hasNoFlags = false
         end
-        i = i + 1
     end
     if hasNoFlags then
         ____exports.log("  n/a (no flags)")
@@ -87,14 +83,12 @@ function ____exports.logAllSeedEffects()
     local seeds = game:GetSeeds()
     ____exports.log("Logging all seed effects:")
     local hasNoSeedEffects = true
-    local i = 1
     for key, value in pairs(SeedEffect) do
         local seedEffect = value
         if seeds:HasSeedEffect(seedEffect) then
-            ____exports.log(((((("  " .. tostring(i)) .. ") ") .. key) .. " (") .. tostring(value)) .. ")")
+            ____exports.log(((("  " .. key) .. " (") .. tostring(value)) .. ")")
             hasNoSeedEffects = false
         end
-        i = i + 1
     end
     if hasNoSeedEffects then
         ____exports.log("  n/a (no seed effects)")

package/dist/functions/player.d.ts

@@ -1,18 +1,6 @@
 /// <reference types="isaac-typescript-definitions" />
 import { HealthType } from "../types/HealthType";
-/**
- * PlayerIndex is a specific type of string; see the documentation for the [[`getPlayerIndex`]]
- * function. Mods can signify that data structures handle EntityPlayers by using this type:
- *
- * ```
- * const myPlayerMap = new Map<PlayerIndex, string>();
- * ```
- *
- * This type is branded for extra type safety.
- */
-export declare type PlayerIndex = int & {
-    __playerIndexBrand: unknown;
-};
+import { PlayerIndex } from "../types/PlayerIndex";
 export declare function addCollectibleCostume(player: EntityPlayer, collectibleType: CollectibleType | int): void;
 export declare function addTrinketCostume(player: EntityPlayer, trinketType: TrinketType | int): void;
 /** Iterates over all players and checks if any player is close enough to the specified position. */
@@ -97,9 +85,9 @@ export declare function getLastHeart(player: EntityPlayer): HealthType;
  */
 export declare function getNewestPlayer(): EntityPlayer;
 /**
- * Returns the number of slots that the player has remaining for heart containers, accounting for
- * broken hearts. For example, if the player is Judas and has 1 red heart containers and 2 full soul
- * hearts and 3 broken hearts, then this function would return 6 (i.e. 12 - 1 - 2 - 3).
+ * Returns the number of slots that the player has remaining for new heart containers, accounting
+ * for broken hearts. For example, if the player is Judas and has 1 red heart containers and 2 full
+ * soul hearts and 3 broken hearts, then this function would return 6 (i.e. 12 - 1 - 2 - 3).
  */
 export declare function getPlayerAvailableHeartSlots(player: EntityPlayer): int;
 /**

package/dist/functions/revive.d.ts

@@ -5,8 +5,8 @@
  */
 export declare function isDamageToPlayerFatal(player: EntityPlayer, damageAmount: int, damageSource: EntityRef, lastDamageGameFrame: int): boolean;
 /**
- * The `EntityPlayer.WillPlayerRevive()` function does not properly account for Mysterious Paper,
- * so use this helper function instead for more robust revival detection.
+ * The `EntityPlayer.WillPlayerRevive()` function does not properly account for Mysterious Paper, so
+ * use this helper function instead for more robust revival detection.
  */
 export declare function willPlayerRevive(player: EntityPlayer): boolean;
 /**
@@ -18,6 +18,12 @@ export declare function willPlayerRevive(player: EntityPlayer): boolean;
  * Mysterious Paper be Missing Power is: `gameFrameCount % 4 === 3`
  */
 export declare function willMysteriousPaperRevive(player: EntityPlayer): boolean;
+/**
+ * Helper function to determine if the player will be revived by the Heartbreak collectible if they
+ * take fatal damage. This is contingent on the character that they are playing as and the amount of
+ * broken hearts that they already have.
+ */
+export declare function willReviveFromHeartbreak(player: EntityPlayer): boolean;
 /**
  * Helper function to determine if the Spirit Shackles item is in an enabled state. (It can be
  * either enabled or disabled.)

package/dist/functions/revive.lua

@@ -2,9 +2,10 @@
 local ____exports = {}
 local ____player = require("functions.player")
 local getDeathAnimationName = ____player.getDeathAnimationName
-local getPlayerAvailableHeartSlots = ____player.getPlayerAvailableHeartSlots
+local getPlayerMaxHeartContainers = ____player.getPlayerMaxHeartContainers
 local getPlayerNumHitsRemaining = ____player.getPlayerNumHitsRemaining
 local hasLostCurse = ____player.hasLostCurse
+local isKeeper = ____player.isKeeper
 local ____sprite = require("functions.sprite")
 local getFinalFrameOfAnimation = ____sprite.getFinalFrameOfAnimation
 local ____trinketGive = require("functions.trinketGive")
@@ -19,6 +20,16 @@ function ____exports.willMysteriousPaperRevive(self, player)
     local frameOfDeath = gameFrameCount + deathAnimationFrames + 1
     return frameOfDeath % 4 == 3
 end
+function ____exports.willReviveFromHeartbreak(self, player)
+    if not player:HasCollectible(CollectibleType.COLLECTIBLE_HEARTBREAK) then
+        return false
+    end
+    local maxHeartContainers = getPlayerMaxHeartContainers(nil, player)
+    local numBrokenHeartsThatWillBeAdded = isKeeper(nil, player) and 1 or 2
+    local brokenHearts = player:GetBrokenHearts()
+    local numBrokenHeartsAfterRevival = numBrokenHeartsThatWillBeAdded + brokenHearts
+    return maxHeartContainers > numBrokenHeartsAfterRevival
+end
 function ____exports.willReviveFromSpiritShackles(self, player)
     if not player:HasCollectible(CollectibleType.COLLECTIBLE_SPIRIT_SHACKLES) then
         return false
@@ -53,8 +64,7 @@ function ____exports.isDamageToPlayerFatal(self, player, damageAmount, damageSou
     if damageAmount < playerNumAllHearts then
         return false
     end
-    local playerAvailableHeartSlots = getPlayerAvailableHeartSlots(nil, player)
-    if player:HasCollectible(CollectibleType.COLLECTIBLE_HEARTBREAK) and playerAvailableHeartSlots >= 2 then
+    if ____exports.willReviveFromHeartbreak(nil, player) then
         return false
     end
     if player:HasCollectible(CollectibleType.COLLECTIBLE_BROKEN_GLASS_CANNON) and gameFrameCount == lastDamageGameFrame then

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { deployJSONRoom, deployRandomJSONRoom, emptyRoom, } from "./features/dep
 export { disableAllInputs, disableAllInputsExceptFor, disableMovementInputs, disableShootingInputs, enableAllInputs, enableAllInputsExceptFor, } from "./features/disableInputs";
 export { forgottenSwitch } from "./features/forgottenSwitch";
 export { getCollectibleItemPoolType } from "./features/getCollectibleItemPoolType";
+export { isPonyActive } from "./features/isPonyActive";
 export { preventCollectibleRotate } from "./features/preventCollectibleRotate";
 export { runInNGameFrames, runInNRenderFrames, runNextGameFrame, runNextRenderFrame, } from "./features/runInNFrames";
 export * from "./features/saveDataManager/exports";
@@ -92,6 +93,7 @@ export * from "./types/PickingUpItem";
 export * from "./types/PillEffectClass";
 export * from "./types/PillEffectType";
 export * from "./types/PlayerHealth";
+export * from "./types/PlayerIndex";
 export * from "./types/PocketItemDescription";
 export * from "./types/PocketItemType";
 export * from "./types/TrinketSituation";

package/dist/index.lua

@@ -49,6 +49,11 @@ do
     local getCollectibleItemPoolType = ____getCollectibleItemPoolType.getCollectibleItemPoolType
     ____exports.getCollectibleItemPoolType = getCollectibleItemPoolType
 end
+do
+    local ____isPonyActive = require("features.isPonyActive")
+    local isPonyActive = ____isPonyActive.isPonyActive
+    ____exports.isPonyActive = isPonyActive
+end
 do
     local ____preventCollectibleRotate = require("features.preventCollectibleRotate")
     local preventCollectibleRotate = ____preventCollectibleRotate.preventCollectibleRotate

package/dist/types/PlayerIndex.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * PlayerIndex is a specific type of string; see the documentation for the [[`getPlayerIndex`]]
+ * function. Mods can signify that data structures handle EntityPlayers by using this type:
+ *
+ * ```
+ * const myPlayerMap = new Map<PlayerIndex, string>();
+ * ```
+ *
+ * This type is branded for extra type safety.
+ */
+export declare type PlayerIndex = int & {
+    __playerIndexBrand: unknown;
+};

package/dist/types/PlayerIndex.lua

@@ -0,0 +1,3 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+return ____exports

package/package.json

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