isaacscript-common 1.0.569 → 1.0.570

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/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/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.569",
+  "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",