isaacscript-common 1.0.566 → 1.0.570

package/dist/constants.d.ts

@@ -60,8 +60,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

@@ -25,8 +25,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/rooms.d.ts

@@ -6,6 +6,13 @@
  */
 export declare function changeRoom(roomGridIndex: int): void;
 export declare function getAllRoomGridIndexes(): int[];
+/**
+ * Helper function to get the current dimension. Most of the time, this will be `Dimension.MAIN`,
+ * but it can change if e.g. the player is in the mirror world of Downpour/Dross.
+ *
+ * Note that this function does correctly handle detecting the Death Certificate dimension, which is
+ * tricky to properly detect.
+ */
 export declare function getCurrentDimension(): Dimension;
 /** An alias to the `Level.GetCurrentRoomDesc()` method. */
 export declare function getCurrentRoomDescReadOnly(): RoomDescriptorReadOnly;

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.566",
+  "version": "1.0.570",
   "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",