isaacscript-common 1.0.567 → 1.0.571

package/dist/constants.d.ts

@@ -12,6 +12,7 @@ export declare const BLIND_ITEM_PNG_PATH = "gfx/items/collectibles/questionmark.
 /** Bombs explode when their frame count is equal to this value. */
 export declare const BOMB_EXPLODE_FRAME = 45;
 export declare const CHARACTERS_WITH_AN_ACTIVE_ITEM: Set<PlayerType>;
+export declare const CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART: Set<PlayerType>;
 /**
  * The set of characters where red heart containers will be turned into soul hearts (e.g. Blue
  * Baby). This includes The Lost and Tainted Lost. This does not include Keeper or Tainted Keeper.
@@ -60,8 +61,8 @@ export declare const FINAL_STAGE: number;
  * second TMTRAINER item subtracts one from that, and so on.
  */
 export declare const FIRST_GLITCHED_COLLECTIBLE_TYPE: number;
-export declare const GENESIS_ROOM_VARIANT = 1000;
-export declare const GENESIS_ROOM_SUBTYPE = 99;
+export declare const GENESIS_ROOM_VARIANT = -1;
+export declare const GENESIS_ROOM_SUBTYPE = -1;
 export declare const GOLDEN_TRINKET_SHIFT: number;
 export declare const GRID_INDEX_CENTER_OF_1X1_ROOM = 67;
 export declare const GAME_FRAMES_PER_SECOND = 30;

package/dist/constants.lua

@@ -5,6 +5,7 @@ ____exports.AZAZEL_DEFAULT_BRIMSTONE_DISTANCE = 75.125
 ____exports.BLIND_ITEM_PNG_PATH = "gfx/items/collectibles/questionmark.png"
 ____exports.BOMB_EXPLODE_FRAME = 45
 ____exports.CHARACTERS_WITH_AN_ACTIVE_ITEM = __TS__New(Set, {PlayerType.PLAYER_ISAAC, PlayerType.PLAYER_MAGDALENE, PlayerType.PLAYER_JUDAS, PlayerType.PLAYER_BLUEBABY, PlayerType.PLAYER_EVE, PlayerType.PLAYER_EDEN, PlayerType.PLAYER_THELOST, PlayerType.PLAYER_LILITH, PlayerType.PLAYER_KEEPER, PlayerType.PLAYER_APOLLYON, PlayerType.PLAYER_EDEN_B})
+____exports.CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART = __TS__New(Set, {PlayerType.PLAYER_BLACKJUDAS, PlayerType.PLAYER_JUDAS_B})
 ____exports.CHARACTERS_WITH_NO_RED_HEARTS = __TS__New(Set, {PlayerType.PLAYER_BLUEBABY, PlayerType.PLAYER_THELOST, PlayerType.PLAYER_BLACKJUDAS, PlayerType.PLAYER_JUDAS_B, PlayerType.PLAYER_BLUEBABY_B, PlayerType.PLAYER_THELOST_B, PlayerType.PLAYER_THEFORGOTTEN_B, PlayerType.PLAYER_BETHANY_B})
 ____exports.CHARACTERS_WITH_NO_SOUL_HEARTS = __TS__New(Set, {PlayerType.PLAYER_THELOST, PlayerType.PLAYER_KEEPER, PlayerType.PLAYER_BETHANY, PlayerType.PLAYER_THELOST_B, PlayerType.PLAYER_KEEPER_B})
 ____exports.COLORS = {
@@ -25,8 +26,8 @@ ____exports.EMPTY_PNG_PATH = "gfx/none.png"
 ____exports.FAMILIARS_THAT_SHOOT_PLAYER_TEARS = __TS__New(Set, {FamiliarVariant.SCISSORS, FamiliarVariant.INCUBUS, FamiliarVariant.FATES_REWARD, FamiliarVariant.SPRINKLER, FamiliarVariant.LOST_SOUL, FamiliarVariant.TWISTED_BABY, FamiliarVariant.BLOOD_BABY, FamiliarVariant.DECAP_ATTACK})
 ____exports.FINAL_STAGE = LevelStage.NUM_STAGES - 1
 ____exports.FIRST_GLITCHED_COLLECTIBLE_TYPE = (1 << 32) - 1
-____exports.GENESIS_ROOM_VARIANT = 1000
-____exports.GENESIS_ROOM_SUBTYPE = 99
+____exports.GENESIS_ROOM_VARIANT = -1
+____exports.GENESIS_ROOM_SUBTYPE = -1
 ____exports.GOLDEN_TRINKET_SHIFT = 1 << 15
 ____exports.GRID_INDEX_CENTER_OF_1X1_ROOM = 67
 ____exports.GAME_FRAMES_PER_SECOND = 30

package/dist/functions/entity.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+import { AnyEntity } from "../types/AnyEntity";
 export declare function anyEntityCloserThan(entities: Entity[], position: Vector, distance: int): boolean;
 /**
  * Helper function to get all of the bombs in the room.
@@ -24,6 +25,11 @@ export declare function getBombs(matchingVariant?: number, matchingSubType?: num
  * ```
  */
 export declare function getClosestEntityTo(referenceEntity: Entity, entities: Entity[]): Entity;
+/**
+ * Helper function to compare two different arrays of entities. Returns the entities that are in the
+ * second array but not in the first array.
+ */
+export declare function getFilteredNewEntities<T extends AnyEntity>(oldEntities: T[], newEntities: T[]): T[];
 /**
  * Helper function to get all of the effects in the room.
  *
@@ -251,6 +257,15 @@ export declare function removeAllProjectiles(variant?: ProjectileVariant | int,
  * @returns True if one or more tears was removed, false otherwise.
  */
 export declare function removeAllTears(variant?: TearVariant | int, subType?: int, cap?: int): boolean;
+/**
+ * Game().RerollEnemy rerolls a boolean of whether or not the enemy was rerolled. However, you
+ * cannot use the same entity object after a reroll. This function calls game.RerollEnemy and
+ * returns the new entity object.
+ *
+ * @param entity The entity to reroll
+ * @returns If the entity was not rerolled, returns the original entity. otherwise, returns the resulting entity from the reroll
+ */
+export declare function rerollEnemy(entity: Entity): Entity;
 /**
  * Helper function to set the position of every entity in the room based on a map of positions. If
  * an entity is found that does not have matching element in the provided map, then that entity will

package/dist/functions/entity.lua

@@ -44,6 +44,20 @@ function ____exports.getClosestEntityTo(self, referenceEntity, entities)
     end
     return closestEntity
 end
+function ____exports.getFilteredNewEntities(self, oldEntities, newEntities)
+    local oldEntitiesSet = __TS__New(Set)
+    for ____, entity in ipairs(oldEntities) do
+        local ptrHash = GetPtrHash(entity)
+        oldEntitiesSet:add(ptrHash)
+    end
+    return __TS__ArrayFilter(
+        newEntities,
+        function(____, entity)
+            local ptrHash = GetPtrHash(entity)
+            return not oldEntitiesSet:has(ptrHash)
+        end
+    )
+end
 function ____exports.getEffects(self, matchingVariant, matchingSubType)
     if matchingVariant == nil then
         matchingVariant = -1
@@ -280,6 +294,20 @@ function ____exports.removeAllTears(self, variant, subType, cap)
     local tears = ____exports.getTears(nil, variant, subType)
     return ____exports.removeEntities(nil, tears, cap)
 end
+function ____exports.rerollEnemy(self, entity)
+    local game = Game()
+    local oldEntities = ____exports.getEntities(nil)
+    local wasRerolled = game:RerollEnemy(entity)
+    if not wasRerolled then
+        return entity
+    end
+    local newEntities = ____exports.getEntities(nil)
+    local filteredNewEntities = ____exports.getFilteredNewEntities(nil, oldEntities, newEntities)
+    if #filteredNewEntities ~= 0 then
+        error("Failed to find the new entity generated by the \"RerollEnemy\" method.")
+    end
+    return filteredNewEntities[1]
+end
 function ____exports.setEntityPositions(self, entityPositions, entities)
     if entities == nil then
         entities = ____exports.getEntities(nil)

package/dist/functions/log.d.ts

@@ -39,6 +39,7 @@ export declare function logEntity(this: void, entity: Entity): void;
 export declare function logKColor(this: void, kColor: KColor): void;
 export declare function logMap(this: void, map: Map<AnyNotNil, unknown>): void;
 export declare function logTable(this: void, table: unknown): void;
+export declare function logTemporaryEffects(this: void, player: EntityPlayer): void;
 export declare function logSet(this: void, set: Set<AnyNotNil>): void;
 export declare function logVector(this: void, vector: Vector): void;
 /**

package/dist/functions/log.lua

@@ -3,8 +3,12 @@ require("lualib_bundle");
 local ____exports = {}
 local ____array = require("functions.array")
 local arrayToString = ____array.arrayToString
+local ____collectibles = require("functions.collectibles")
+local getCollectibleName = ____collectibles.getCollectibleName
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
+local ____trinkets = require("functions.trinkets")
+local getTrinketName = ____trinkets.getTrinketName
 function ____exports.getDebugPrependString(self, msg, numParentFunctions)
     if numParentFunctions == nil then
         numParentFunctions = 3
@@ -166,6 +170,47 @@ function ____exports.logTable(____table)
         )
     end
 end
+function ____exports.logTemporaryEffects(player)
+    local effects = player:GetEffects()
+    local effectsList = effects:GetEffectsList()
+    ____exports.log("Logging all player temporary effects:")
+    if effectsList.Size == 0 then
+        ____exports.log("  n/a (no temporary effects)")
+        return
+    end
+    do
+        local i = 0
+        while i < effectsList.Size do
+            do
+                local effect = effectsList:Get(i)
+                if effect == nil then
+                    goto __continue35
+                end
+                if effect.Item:IsCollectible() then
+                    local collectibleName = getCollectibleName(nil, effect.Item.ID)
+                    ____exports.log(
+                        (("  " .. tostring(i + 1)) .. ") ") .. collectibleName
+                    )
+                elseif effect.Item:IsTrinket() then
+                    local trinketName = getTrinketName(nil, effect.Item.ID)
+                    ____exports.log(
+                        (("  " .. tostring(i + 1)) .. ") ") .. trinketName
+                    )
+                elseif effect.Item:IsNull() then
+                    ____exports.log(
+                        (("  " .. tostring(i + 1)) .. ") Null item: ") .. tostring(effect.Item.ID)
+                    )
+                else
+                    ____exports.log(
+                        (("  " .. tostring(i + 1)) .. ") Unknown type of temporary effect: ") .. tostring(effect.Item.ID)
+                    )
+                end
+            end
+            ::__continue35::
+            i = i + 1
+        end
+    end
+end
 function ____exports.logSet(set)
     ____exports.log("Printing out a TSTL Set:")
     for ____, value in __TS__Iterator(

package/dist/functions/npc.d.ts

@@ -1,4 +1,18 @@
 /// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to make an NPC fire a projectile. Returns the fired projectile. Use this function
+ * instead of `EntityNPC.FireProjectiles()`, since that returns void.
+ *
+ * @param npc The NPC to fire the projectile from.
+ * @param position The staring position of the projectile.
+ * @param velocity The starting velocity of the projectile.
+ * @param projectilesMode The mode of the projectile. Optional. Equal to
+ * `ProjectilesMode.ONE_PROJECTILE` by default.
+ * @param projectileParams The parameters of the projectile. Optional. Equal to `ProjectileParams()`
+ * by default.
+ * @returns The fired projectile.
+ */
+export declare function fireProjectiles(npc: EntityNPC, position: Vector, velocity: Vector, projectilesMode?: ProjectilesMode, projectileParams?: ProjectileParams): EntityProjectile[];
 /**
  * Helper function to get all of the non-dead bosses in the room.
  *

package/dist/functions/npc.lua

@@ -6,6 +6,8 @@ local ____constants = require("constants")
 local EGGY_STATE_FRAME_OF_FINAL_SPIDER = ____constants.EGGY_STATE_FRAME_OF_FINAL_SPIDER
 local ____entity = require("functions.entity")
 local getEntities = ____entity.getEntities
+local getFilteredNewEntities = ____entity.getFilteredNewEntities
+local getProjectiles = ____entity.getProjectiles
 local removeEntities = ____entity.removeEntities
 function ____exports.getBosses(self)
     local bosses = {}
@@ -75,6 +77,18 @@ NON_ALIVE_NPCS_TYPE_VARIANT_SUBTYPE = __TS__New(
         (((tostring(EntityType.ENTITY_CHARGER) .. ".") .. 0) .. ".") .. 1
     }
 )
+function ____exports.fireProjectiles(self, npc, position, velocity, projectilesMode, projectileParams)
+    if projectilesMode == nil then
+        projectilesMode = 0
+    end
+    if projectileParams == nil then
+        projectileParams = ProjectileParams()
+    end
+    local oldProjectiles = getProjectiles(nil, projectileParams.Variant)
+    npc:FireProjectiles(position, velocity, projectilesMode, projectileParams)
+    local newProjectiles = getProjectiles(nil, projectileParams.Variant)
+    return getFilteredNewEntities(nil, oldProjectiles, newProjectiles)
+end
 function ____exports.getAliveBosses(self)
     local aliveBosses = {}
     for ____, boss in ipairs(

package/dist/functions/player.d.ts

@@ -39,6 +39,12 @@ export declare function characterCanHaveRedHearts(character: PlayerType): boolea
  * false for The Lost and Tainted Lost.
  */
 export declare function characterCanHaveSoulHearts(character: PlayerType): boolean;
+/**
+ * Normally, characters get a red heart container upon reaching a new floor with an eternal heart,
+ * but some characters grant a black heart instead. Returns true for Dark Judas and Tainted Judas.
+ * Otherwise, returns false.
+ */
+export declare function characterGetsBlackHeartFromEternalHeart(character: PlayerType): boolean;
 /**
  * Helper function to get how long Azazel's Brimstone laser should be. You can pass either an
  * `EntityPlayer` object or a tear height stat.

package/dist/functions/player.lua

@@ -3,6 +3,7 @@ require("lualib_bundle");
 local ____exports = {}
 local EXCLUDED_CHARACTERS
 local ____constants = require("constants")
+local CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART = ____constants.CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART
 local CHARACTERS_WITH_NO_RED_HEARTS = ____constants.CHARACTERS_WITH_NO_RED_HEARTS
 local CHARACTERS_WITH_NO_SOUL_HEARTS = ____constants.CHARACTERS_WITH_NO_SOUL_HEARTS
 local LOST_STYLE_PLAYER_TYPES = ____constants.LOST_STYLE_PLAYER_TYPES
@@ -59,18 +60,18 @@ function ____exports.getPlayers(self, performExclusions)
             do
                 local player = Isaac.GetPlayer(i)
                 if player == nil then
-                    goto __continue66
+                    goto __continue67
                 end
                 if ____exports.isChildPlayer(nil, player) then
-                    goto __continue66
+                    goto __continue67
                 end
                 local character = player:GetPlayerType()
                 if performExclusions and EXCLUDED_CHARACTERS:has(character) then
-                    goto __continue66
+                    goto __continue67
                 end
                 __TS__ArrayPush(players, player)
             end
-            ::__continue66::
+            ::__continue67::
             i = i + 1
         end
     end
@@ -145,6 +146,9 @@ end
 function ____exports.characterCanHaveSoulHearts(self, character)
     return not CHARACTERS_WITH_NO_SOUL_HEARTS:has(character)
 end
+function ____exports.characterGetsBlackHeartFromEternalHeart(self, character)
+    return CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART:has(character)
+end
 function ____exports.getAzazelBrimstoneDistance(self, playerOrTearHeight)
     local tearHeight = tonumber(playerOrTearHeight)
     if tearHeight == nil then
@@ -295,14 +299,14 @@ function ____exports.getPlayerIndexVanilla(self, playerToFind)
             do
                 local player = Isaac.GetPlayer(i)
                 if player == nil then
-                    goto __continue58
+                    goto __continue59
                 end
                 local playerHash = GetPtrHash(player)
                 if playerHash == playerToFindHash then
                     return i
                 end
             end
-            ::__continue58::
+            ::__continue59::
             i = i + 1
         end
     end
@@ -423,9 +427,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch96 = activeSlot
-        local ____cond96 = ____switch96 == ActiveSlot.SLOT_PRIMARY
-        if ____cond96 then
+        local ____switch97 = activeSlot
+        local ____cond97 = ____switch97 == ActiveSlot.SLOT_PRIMARY
+        if ____cond97 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -434,8 +438,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond96 = ____cond96 or (____switch96 == ActiveSlot.SLOT_SECONDARY)
-        if ____cond96 then
+        ____cond97 = ____cond97 or (____switch97 == ActiveSlot.SLOT_SECONDARY)
+        if ____cond97 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -450,16 +454,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond96 = ____cond96 or (____switch96 == ActiveSlot.SLOT_POCKET)
-        if ____cond96 then
+        ____cond97 = ____cond97 or (____switch97 == ActiveSlot.SLOT_POCKET)
+        if ____cond97 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond96 = ____cond96 or (____switch96 == ActiveSlot.SLOT_POCKET2)
-        if ____cond96 then
+        ____cond97 = ____cond97 or (____switch97 == ActiveSlot.SLOT_POCKET2)
+        if ____cond97 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/dist/index.d.ts

@@ -61,6 +61,7 @@ export * from "./maps/transformationMaps";
 export * from "./maps/transformationNameMap";
 export * from "./maps/trinketNameMap";
 export * from "./sets/cards";
+export * from "./types/AnyEntity";
 export * from "./types/CallbackParametersCustom";
 export * from "./types/HealthType";
 export * from "./types/JSONDoor";

package/dist/types/AnyEntity.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare type AnyEntity = Entity | EntityBomb | EntityEffect | EntityFamiliar | EntityKnife | EntityLaser | EntityNPC | EntityPickup | EntityPlayer | EntityProjectile | EntityTear;

package/dist/types/AnyEntity.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.0.567",
+  "version": "1.0.571",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,7 +25,7 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.313",
+    "isaac-typescript-definitions": "^1.0.315",
     "isaacscript-lint": "^1.0.74",
     "typedoc": "^0.22.10",
     "typescript": "4.4.4",