isaacscript-common 1.0.541 → 1.0.545

package/dist/functions/cards.d.ts

@@ -1,11 +1,11 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
- * Helper function to get a card name from a Card.
+ * Helper function to get a card description from a Card enum value.
  *
  * Example:
  * ```
  * const card = Card.CARD_FOOL;
- * const cardName = getCardName(card); // cardName is "0 - The Fool"
+ * const cardDescription = getCardDescription(card); // cardDescription is "Where journey begins"
  * ```
  */
 export declare function getCardDescription(card: Card | int): string;

package/dist/functions/collectibles.d.ts

@@ -68,8 +68,9 @@ export declare function isSingleUseCollectible(collectibleType: CollectibleType
  * @param collectibleType Optional. If specified, will only remove collectibles that match this
  * collectible type.
  * @param cap Optional. If specified, will only remove the given amount of collectibles.
+ * @returns True if one or more collectibles was removed, false otherwise.
  */
-export declare function removeAllCollectibles(collectibleType?: CollectibleType | int, cap?: int): void;
+export declare function removeAllCollectibles(collectibleType?: CollectibleType | int, cap?: int): boolean;
 /**
  * Helper function to remove all pickup delay on a collectible. By default, collectibles have a 20
  * frame delay before they can be picked up by a player.

package/dist/functions/collectibles.lua

@@ -151,7 +151,7 @@ function ____exports.isSingleUseCollectible(self, collectibleType)
     return SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES:has(collectibleType)
 end
 function ____exports.removeAllCollectibles(self, collectibleType, cap)
-    removeAllPickups(nil, PickupVariant.PICKUP_COLLECTIBLE, collectibleType, cap)
+    return removeAllPickups(nil, PickupVariant.PICKUP_COLLECTIBLE, collectibleType, cap)
 end
 function ____exports.removeCollectiblePickupDelay(self, collectible)
     if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then

package/dist/functions/entity.d.ts

@@ -152,53 +152,66 @@ export declare function getSlots(matchingVariant?: number, matchingSubType?: num
  * ```
  */
 export declare function getTears(matchingVariant?: number, matchingSubType?: number): EntityTear[];
+/**
+ * Helper function to measure an entity's velocity to see if it is moving.
+ *
+ * @param entity The entity whose velocity to measure.
+ * @param threshold Optional. The threshold from 0 to consider to be moving. 0.01 by default.
+ */
+export declare function isEntityMoving(entity: Entity, threshold?: number): boolean;
 /**
  * Helper function to remove all of the entities in the supplied array.
  *
  * @param entities The array of entities to remove.
  * @param cap Optional. If specified, will only remove the given amount of entities.
+ * @returns True if one or more entities was removed, false otherwise.
  */
-export declare function removeEntities(entities: Entity[], cap?: int): void;
+export declare function removeEntities(entities: Entity[], cap?: int): boolean;
 /**
  * Helper function to remove all of the bombs in the room.
  *
  * @param variant Optional. If specified, will only remove bombs that match this variant.
  * @param subType Optional. If specified, will only remove bombs that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of bombs.
+ * @returns True if one or more bombs was removed, false otherwise.
  */
-export declare function removeAllBombs(variant?: BombVariant | int, subType?: int, cap?: int): void;
+export declare function removeAllBombs(variant?: BombVariant | int, subType?: int, cap?: int): boolean;
 /**
  * Helper function to remove all of the effects in the room.
  *
  * @param variant Optional. If specified, will only remove effects that match this variant.
  * @param subType Optional. If specified, will only remove effects that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of effects.
+ * @returns True if one or more effects was removed, false otherwise.
  */
-export declare function removeAllEffects(variant?: EffectVariant, subType?: int, cap?: int): void;
+export declare function removeAllEffects(variant?: EffectVariant, subType?: int, cap?: int): boolean;
 /**
  * Helper function to remove all of the familiars in the room.
  *
  * @param variant Optional. If specified, will only remove familiars that match this variant.
  * @param subType Optional. If specified, will only remove familiars that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of familiars.
+ * @returns True if one or more familiars was removed, false otherwise.
  */
-export declare function removeAllFamiliars(variant?: FamiliarVariant | int, subType?: int, cap?: int): void;
+export declare function removeAllFamiliars(variant?: FamiliarVariant | int, subType?: int, cap?: int): boolean;
 /**
  * Helper function to remove all of the knives in the room.
  *
  * @param variant Optional. If specified, will only remove knives that match this variant.
  * @param subType Optional. If specified, will only remove knives that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of knives.
+ * @returns True if one or more knives was removed, false otherwise.
  */
-export declare function removeAllKnives(variant?: KnifeVariant | int, subType?: int, cap?: int): void;
+export declare function removeAllKnives(variant?: KnifeVariant | int, subType?: int, cap?: int): boolean;
 /**
  * Helper function to remove all of the lasers in the room.
  *
  * @param variant Optional. If specified, will only remove lasers that match this variant.
  * @param subType Optional. If specified, will only remove lasers that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of lasers.
+ * @returns True if one or more lasers was removed, false otherwise.
  */
-export declare function removeAllLasers(variant?: LaserVariant | int, subType?: int, cap?: int): void;
+export declare function removeAllLasers(variant?: LaserVariant | int, subType?: int, cap?: int): boolean;
 /**
  * Helper function to remove all of the matching entities in the room.
  *
@@ -208,32 +221,36 @@ export declare function removeAllLasers(variant?: LaserVariant | int, subType?:
  * @param entitySubType Optional. The sub-type to match. -1 by default (which will match every
  * sub-type).
  * @param cap Optional. If specified, will only remove the given amount of collectibles.
+ * @returns True if one or more entities was removed, false otherwise.
  */
-export declare function removeAllMatchingEntities(entityType: int, entityVariant?: number, entitySubType?: number, cap?: int | undefined): void;
+export declare function removeAllMatchingEntities(entityType: int, entityVariant?: number, entitySubType?: number, cap?: int | undefined): boolean;
 /**
  * Helper function to remove all of the pickups in the room.
  *
  * @param variant Optional. If specified, will only remove pickups that match this variant.
  * @param subType Optional. If specified, will only remove pickups that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of pickups.
+ * @returns True if one or more pickups was removed, false otherwise.
  */
-export declare function removeAllPickups(variant?: PickupVariant | int, subType?: int, cap?: int): void;
+export declare function removeAllPickups(variant?: PickupVariant | int, subType?: int, cap?: int): boolean;
 /**
  * Helper function to remove all of the projectiles in the room.
  *
  * @param variant Optional. If specified, will only remove projectiles that match this variant.
  * @param subType Optional. If specified, will only remove projectiles that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of projectiles.
+ * @returns True if one or more projectiles was removed, false otherwise.
  */
-export declare function removeAllProjectiles(variant?: ProjectileVariant | int, subType?: int, cap?: int): void;
+export declare function removeAllProjectiles(variant?: ProjectileVariant | int, subType?: int, cap?: int): boolean;
 /**
  * Helper function to remove all of the tears in the room.
  *
  * @param variant Optional. If specified, will only remove tears that match this variant.
  * @param subType Optional. If specified, will only remove tears that match this sub-type.
  * @param cap Optional. If specified, will only remove the given amount of tears.
+ * @returns True if one or more tears was removed, false otherwise.
  */
-export declare function removeAllTears(variant?: TearVariant | int, subType?: int, cap?: int): void;
+export declare function removeAllTears(variant?: TearVariant | int, subType?: int, cap?: int): boolean;
 /**
  * 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

@@ -210,7 +210,16 @@ function ____exports.getTears(self, matchingVariant, matchingSubType)
     end
     return tears
 end
+function ____exports.isEntityMoving(self, entity, threshold)
+    if threshold == nil then
+        threshold = 0.01
+    end
+    return entity.Velocity:Length() >= threshold
+end
 function ____exports.removeEntities(self, entities, cap)
+    if #entities == 0 then
+        return false
+    end
     local numEntitiesRemoved = 0
     do
         local i = 0
@@ -219,31 +228,32 @@ function ____exports.removeEntities(self, entities, cap)
             entity:Remove()
             numEntitiesRemoved = numEntitiesRemoved + 1
             if (cap ~= nil) and (numEntitiesRemoved >= cap) then
-                return
+                return true
             end
             i = i + 1
         end
     end
+    return true
 end
 function ____exports.removeAllBombs(self, variant, subType, cap)
     local bombs = ____exports.getBombs(nil, variant, subType)
-    ____exports.removeEntities(nil, bombs, cap)
+    return ____exports.removeEntities(nil, bombs, cap)
 end
 function ____exports.removeAllEffects(self, variant, subType, cap)
     local effects = ____exports.getEffects(nil, variant, subType)
-    ____exports.removeEntities(nil, effects, cap)
+    return ____exports.removeEntities(nil, effects, cap)
 end
 function ____exports.removeAllFamiliars(self, variant, subType, cap)
     local familiars = ____exports.getFamiliars(nil, variant, subType)
-    ____exports.removeEntities(nil, familiars, cap)
+    return ____exports.removeEntities(nil, familiars, cap)
 end
 function ____exports.removeAllKnives(self, variant, subType, cap)
     local knives = ____exports.getKnives(nil, variant, subType)
-    ____exports.removeEntities(nil, knives, cap)
+    return ____exports.removeEntities(nil, knives, cap)
 end
 function ____exports.removeAllLasers(self, variant, subType, cap)
     local lasers = ____exports.getLasers(nil, variant, subType)
-    ____exports.removeEntities(nil, lasers, cap)
+    return ____exports.removeEntities(nil, lasers, cap)
 end
 function ____exports.removeAllMatchingEntities(self, entityType, entityVariant, entitySubType, cap)
     if entityVariant == nil then
@@ -256,19 +266,19 @@ function ____exports.removeAllMatchingEntities(self, entityType, entityVariant,
         cap = nil
     end
     local entities = Isaac.FindByType(entityType, entityVariant, entitySubType)
-    ____exports.removeEntities(nil, entities, cap)
+    return ____exports.removeEntities(nil, entities, cap)
 end
 function ____exports.removeAllPickups(self, variant, subType, cap)
     local pickups = ____exports.getPickups(nil, variant, subType)
-    ____exports.removeEntities(nil, pickups, cap)
+    return ____exports.removeEntities(nil, pickups, cap)
 end
 function ____exports.removeAllProjectiles(self, variant, subType, cap)
     local projectiles = ____exports.getProjectiles(nil, variant, subType)
-    ____exports.removeEntities(nil, projectiles, cap)
+    return ____exports.removeEntities(nil, projectiles, cap)
 end
 function ____exports.removeAllTears(self, variant, subType, cap)
     local tears = ____exports.getTears(nil, variant, subType)
-    ____exports.removeEntities(nil, tears, cap)
+    return ____exports.removeEntities(nil, tears, cap)
 end
 function ____exports.setEntityPositions(self, entityPositions, entities)
     if entities == nil then

package/dist/functions/gridEntity.d.ts

@@ -55,8 +55,10 @@ export declare function isPostBossVoidPortal(gridEntity: GridEntity): boolean;
  *   GridEntityType.GRID_DOOR,
  * );
  * ```
+ *
+ * @returns True if one or more grid entities was removed, false otherwise.
  */
-export declare function removeAllGridEntitiesExceptFor(...gridEntityTypes: GridEntityType[]): void;
+export declare function removeAllGridEntitiesExceptFor(...gridEntityTypes: GridEntityType[]): boolean;
 /**
  * Helper function to remove all of the grid entities in the room that match the grid entity types
  * provided.
@@ -69,8 +71,10 @@ export declare function removeAllGridEntitiesExceptFor(...gridEntityTypes: GridE
  *   GridEntityType.GRID_ROCKT,
  * );
  * ```
+ *
+ * @returns True if one or more grid entities was removed, false otherwise.
  */
-export declare function removeAllMatchingGridEntities(...gridEntityType: GridEntityType[]): void;
+export declare function removeAllMatchingGridEntities(...gridEntityType: GridEntityType[]): boolean;
 /**
  * Helper function to remove a grid entity simply by providing the grid entity object.
  *

package/dist/functions/gridEntity.lua

@@ -135,20 +135,29 @@ function ____exports.removeAllGridEntitiesExceptFor(self, ...)
     local gridEntityTypes = {...}
     local gridEntityTypeExceptions = __TS__New(Set, gridEntityTypes)
     local gridEntities = ____exports.getGridEntities(nil)
+    local removedOneOrMoreGridEntities = false
     for ____, gridEntity in ipairs(gridEntities) do
         local gridEntityType = gridEntity:GetType()
         if not gridEntityTypeExceptions:has(gridEntityType) then
             ____exports.removeGridEntity(nil, gridEntity, false)
+            removedOneOrMoreGridEntities = true
         end
     end
-    roomUpdateSafe(nil)
+    if removedOneOrMoreGridEntities then
+        roomUpdateSafe(nil)
+    end
+    return removedOneOrMoreGridEntities
 end
 function ____exports.removeAllMatchingGridEntities(self, ...)
     local gridEntities = ____exports.getGridEntities(nil, ...)
+    if #gridEntities == 0 then
+        return false
+    end
     for ____, gridEntity in ipairs(gridEntities) do
         ____exports.removeGridEntity(nil, gridEntity, false)
     end
     roomUpdateSafe(nil)
+    return true
 end
 function ____exports.setGridEntityInvisible(self, gridEntity)
     local sprite = gridEntity:GetSprite()

package/dist/functions/npc.d.ts

@@ -39,5 +39,6 @@ export declare function isRaglingDeathPatch(npc: EntityNPC): boolean;
  * Helper function to remove all NPCs in the room.
  *
  * @param cap Optional. If specified, will only remove the given amount of NPCs.
+ * @returns True if one or more NPCs was removed, false otherwise.
  */
-export declare function removeAllNPCs(cap?: int): void;
+export declare function removeAllNPCs(cap?: int): boolean;

package/dist/functions/npc.lua

@@ -99,6 +99,6 @@ function ____exports.getAliveNPCs(self)
 end
 function ____exports.removeAllNPCs(self, cap)
     local npcs = ____exports.getNPCs(nil)
-    removeEntities(nil, npcs, cap)
+    return removeEntities(nil, npcs, cap)
 end
 return ____exports

package/dist/functions/pills.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
- * Helper function to get a pill effect name from a PillEffect.
+ * Helper function to get a pill effect name from a PillEffect enum value.
  *
  * Example:
  * ```

package/dist/functions/revive.lua

@@ -6,7 +6,7 @@ local ____sprite = require("functions.sprite")
 local getFinalFrameOfAnimation = ____sprite.getFinalFrameOfAnimation
 local ____trinketGive = require("functions.trinketGive")
 local giveTrinketsBack = ____trinketGive.giveTrinketsBack
-local temporarilyRemoveTrinkets = ____trinketGive.temporarilyRemoveTrinkets
+local temporarilyRemoveTrinket = ____trinketGive.temporarilyRemoveTrinket
 function ____exports.willMysteriousPaperRevive(self, player)
     local game = Game()
     local gameFrameCount = game:GetFrameCount()
@@ -17,7 +17,7 @@ function ____exports.willMysteriousPaperRevive(self, player)
     return (frameOfDeath % 4) == 3
 end
 function ____exports.willPlayerRevive(self, player)
-    local trinketSituation = temporarilyRemoveTrinkets(nil, player, TrinketType.TRINKET_MYSTERIOUS_PAPER)
+    local trinketSituation = temporarilyRemoveTrinket(nil, player, TrinketType.TRINKET_MYSTERIOUS_PAPER)
     local willRevive = player:WillPlayerRevive() or ((trinketSituation ~= nil) and ____exports.willMysteriousPaperRevive(nil, player))
     giveTrinketsBack(nil, player, trinketSituation)
     return willRevive

package/dist/functions/transformations.d.ts

@@ -2,3 +2,13 @@
 /** Returns the number of items that a player has towards a particular transformation. */
 export declare function getPlayerNumTransformationCollectibles(player: EntityPlayer, playerForm: PlayerForm): int;
 export declare function getTransformationsForItem(collectibleType: CollectibleType | int): Set<PlayerForm>;
+/**
+ * Helper function to get a transformation name from a PlayerForm enum.
+ *
+ * Example:
+ * ```
+ * const transformationName = getTransformationName(PlayerForm.PLAYERFORM_LORD_OF_THE_FLIES);
+ * // transformationName is "Beelzebub"
+ * ```
+ */
+export declare function getTransformationName(transformation: PlayerForm): string;

package/dist/functions/transformations.lua

@@ -1,10 +1,12 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 require("lualib_bundle");
 local ____exports = {}
-local ____transformationMap = require("maps.transformationMap")
-local ITEM_TO_TRANSFORMATION_MAP = ____transformationMap.ITEM_TO_TRANSFORMATION_MAP
-local TRANSFORMATIONS_NOT_BASED_ON_ITEMS = ____transformationMap.TRANSFORMATIONS_NOT_BASED_ON_ITEMS
-local TRANSFORMATION_TO_ITEMS_MAP = ____transformationMap.TRANSFORMATION_TO_ITEMS_MAP
+local ____transformationMaps = require("maps.transformationMaps")
+local ITEM_TO_TRANSFORMATION_MAP = ____transformationMaps.ITEM_TO_TRANSFORMATION_MAP
+local TRANSFORMATIONS_NOT_BASED_ON_ITEMS = ____transformationMaps.TRANSFORMATIONS_NOT_BASED_ON_ITEMS
+local TRANSFORMATION_TO_ITEMS_MAP = ____transformationMaps.TRANSFORMATION_TO_ITEMS_MAP
+local ____transformationNameMap = require("maps.transformationNameMap")
+local TRANSFORMATION_NAME_MAP = ____transformationNameMap.TRANSFORMATION_NAME_MAP
 local ____util = require("functions.util")
 local copySet = ____util.copySet
 function ____exports.getPlayerNumTransformationCollectibles(self, player, playerForm)
@@ -31,4 +33,9 @@ function ____exports.getTransformationsForItem(self, collectibleType)
     local transformations = ITEM_TO_TRANSFORMATION_MAP:get(collectibleType)
     return ((transformations == nil) and __TS__New(Set)) or copySet(nil, transformations)
 end
+function ____exports.getTransformationName(self, transformation)
+    local defaultName = "Unknown"
+    local transformationName = TRANSFORMATION_NAME_MAP:get(transformation)
+    return ((transformationName == nil) and defaultName) or transformationName
+end
 return ____exports

package/dist/functions/trinketGive.d.ts

@@ -1,21 +1,24 @@
 /// <reference types="isaac-typescript-definitions" />
-export interface TrinketSituation {
-    trinketTypeRemoved: TrinketType | int;
-    trinket1: TrinketType | int;
-    trinket2: TrinketType | int;
-    numSmeltedTrinkets: int;
-}
+import { TrinketSituation } from "../types/TrinketSituation";
 /**
- * Helper function to temporarily remove a trinket from the player. Use this in combination with the
- * `giveTrinketBack` function to take away and give back a trinket on the same frame. This function
- * correctly handles multiple trinket slots and ensures that all copies of the trinket are removed,
- * including smelted trinkets.
+ * Helper function to temporarily remove a specific kind of trinket from the player. Use this in
+ * combination with the `giveTrinketBack` function to take away and give back a trinket on the same
+ * frame. This function correctly handles multiple trinket slots and ensures that all copies of the
+ * trinket are removed, including smelted trinkets.
  *
  * Note that for simplicity, this function assumes that all smelted trinkets are non-golden.
  *
- * @returns Null if the player does not have the trinket, or TrinketSituation if they do.
+ * @returns Undefined if the player does not have the trinket, or TrinketSituation if they do.
  */
-export declare function temporarilyRemoveTrinkets(player: EntityPlayer, trinketType: TrinketType | int): TrinketSituation | undefined;
+export declare function temporarilyRemoveTrinket(player: EntityPlayer, trinketType: TrinketType | int): TrinketSituation | undefined;
+/**
+ * Helper function to temporarily removes a player's held trinkets, if any. This will not remove any
+ * smelted trinkets. Use this in combination with the `giveTrinketBack` function to take away and
+ * give back trinkets on the same frame.
+ *
+ * @returns Undefined if the player does not have any trinkets, or TrinketSituation if they do.
+ */
+export declare function temporarilyRemoveTrinkets(player: EntityPlayer): TrinketSituation | undefined;
 /**
  * Helper function to restore the player's trinkets back to the way they were before the
  * `temporarilyRemoveTrinket` function was used. It will re-smelt any smelted trinkets that were

package/dist/functions/trinketGive.lua

@@ -2,7 +2,7 @@
 local ____exports = {}
 local ____constants = require("constants")
 local GOLDEN_TRINKET_SHIFT = ____constants.GOLDEN_TRINKET_SHIFT
-function ____exports.temporarilyRemoveTrinkets(self, player, trinketType)
+function ____exports.temporarilyRemoveTrinket(self, player, trinketType)
     if not player:HasTrinket(trinketType) then
         return nil
     end
@@ -24,6 +24,20 @@ function ____exports.temporarilyRemoveTrinkets(self, player, trinketType)
     end
     return {trinketTypeRemoved = trinketType, trinket1 = trinket1, trinket2 = trinket2, numSmeltedTrinkets = numSmeltedTrinkets}
 end
+function ____exports.temporarilyRemoveTrinkets(self, player)
+    local trinket1 = player:GetTrinket(0)
+    local trinket2 = player:GetTrinket(1)
+    if (trinket1 == TrinketType.TRINKET_NULL) and (trinket2 == TrinketType.TRINKET_NULL) then
+        return nil
+    end
+    if trinket1 ~= TrinketType.TRINKET_NULL then
+        player:TryRemoveTrinket(trinket1)
+    end
+    if trinket2 ~= TrinketType.TRINKET_NULL then
+        player:TryRemoveTrinket(trinket2)
+    end
+    return {trinketTypeRemoved = TrinketType.TRINKET_NULL, trinket1 = trinket1, trinket2 = trinket2, numSmeltedTrinkets = 0}
+end
 function ____exports.giveTrinketsBack(self, player, trinketSituation)
     if trinketSituation == nil then
         return

package/dist/functions/trinkets.d.ts

@@ -41,3 +41,14 @@ export declare function getTrinketName(trinketType: TrinketType | int): string;
  */
 export declare function hasOpenTrinketSlot(player: EntityPlayer): boolean;
 export declare function isGoldenTrinket(trinketType: TrinketType | int): boolean;
+/**
+ * Helper function to smelt a trinket. Before smelting, this function will automatically remove the
+ * trinkets that the player is holding, if any, and then give them back after the new trinket is
+ * smelted.
+ *
+ * @param player The player to smelt the trinkets to.
+ * @param trinketType The trinket type to smelt.
+ * @param numTrinkets Optional. If specified, will smelt the given number of trinkets. Use this to
+ * avoid calling this function multiple times. 1 by default.
+ */
+export declare function smeltTrinket(player: EntityPlayer, trinketType: TrinketType | int, numTrinkets?: number): void;

package/dist/functions/trinkets.lua

@@ -7,6 +7,9 @@ local ____trinketDescriptionMap = require("maps.trinketDescriptionMap")
 local TRINKET_DESCRIPTION_MAP = ____trinketDescriptionMap.TRINKET_DESCRIPTION_MAP
 local ____trinketNameMap = require("maps.trinketNameMap")
 local TRINKET_NAME_MAP = ____trinketNameMap.TRINKET_NAME_MAP
+local ____trinketGive = require("functions.trinketGive")
+local giveTrinketsBack = ____trinketGive.giveTrinketsBack
+local temporarilyRemoveTrinkets = ____trinketGive.temporarilyRemoveTrinkets
 function ____exports.getMaxTrinketID(self)
     local itemConfig = Isaac.GetItemConfig()
     return itemConfig:GetTrinkets().Size - 1
@@ -86,4 +89,19 @@ end
 function ____exports.isGoldenTrinket(self, trinketType)
     return trinketType > GOLDEN_TRINKET_SHIFT
 end
+function ____exports.smeltTrinket(self, player, trinketType, numTrinkets)
+    if numTrinkets == nil then
+        numTrinkets = 1
+    end
+    local trinketSituation = temporarilyRemoveTrinkets(nil, player)
+    do
+        local i = 0
+        while i < numTrinkets do
+            player:AddTrinket(trinketType)
+            player:UseActiveItem(CollectibleType.COLLECTIBLE_SMELTER, false, false, true, false)
+            i = i + 1
+        end
+    end
+    giveTrinketsBack(nil, player, trinketSituation)
+end
 return ____exports

package/dist/index.d.ts

@@ -56,7 +56,8 @@ export * from "./maps/collectibleNameMap";
 export * from "./maps/gridEntityXMLMap";
 export * from "./maps/pillEffectNameMap";
 export * from "./maps/roomShapeToTopLeftWallGridIndexMap";
-export * from "./maps/transformationMap";
+export * from "./maps/transformationMaps";
+export * from "./maps/transformationNameMap";
 export * from "./maps/trinketNameMap";
 export * from "./sets/cards";
 export * from "./types/CallbackParametersCustom";
@@ -72,4 +73,5 @@ export * from "./types/PickingUpItem";
 export * from "./types/PlayerHealth";
 export * from "./types/PocketItemDescription";
 export * from "./types/PocketItemType";
+export * from "./types/TrinketSituation";
 export * from "./upgradeMod";

package/dist/index.lua

@@ -455,7 +455,15 @@ do
     end
 end
 do
-    local ____export = require("maps.transformationMap")
+    local ____export = require("maps.transformationMaps")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+do
+    local ____export = require("maps.transformationNameMap")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue

package/dist/maps/transformationMaps.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare const TRANSFORMATION_TO_TAG_MAP: Map<PlayerForm, ItemConfigTag>;
+export declare const TRANSFORMATIONS_NOT_BASED_ON_ITEMS: Set<PlayerForm>;
+export declare const TRANSFORMATION_TO_ITEMS_MAP: Map<PlayerForm, Set<number>>;
+export declare const ITEM_TO_TRANSFORMATION_MAP: Map<number, Set<PlayerForm>>;

package/dist/maps/transformationMaps.lua

@@ -0,0 +1,56 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+require("lualib_bundle");
+local ____exports = {}
+local initMaps
+local ____collectibles = require("functions.collectibles")
+local collectibleHasTag = ____collectibles.collectibleHasTag
+local getMaxCollectibleID = ____collectibles.getMaxCollectibleID
+function initMaps(self)
+    for ____, playerForm in __TS__Iterator(
+        ____exports.TRANSFORMATION_TO_TAG_MAP:keys()
+    ) do
+        ____exports.TRANSFORMATION_TO_ITEMS_MAP:set(
+            playerForm,
+            __TS__New(Set)
+        )
+    end
+    do
+        local collectibleType = 1
+        while collectibleType <= getMaxCollectibleID(nil) do
+            for ____, ____value in __TS__Iterator(
+                ____exports.TRANSFORMATION_TO_TAG_MAP:entries()
+            ) do
+                local playerForm
+                playerForm = ____value[1]
+                local tag
+                tag = ____value[2]
+                do
+                    if not collectibleHasTag(nil, collectibleType, tag) then
+                        goto __continue5
+                    end
+                    local items = ____exports.TRANSFORMATION_TO_ITEMS_MAP:get(playerForm)
+                    if items == nil then
+                        error(
+                            "Failed to get the items for transformation: " .. tostring(playerForm)
+                        )
+                    end
+                    items:add(collectibleType)
+                    local transformations = ____exports.ITEM_TO_TRANSFORMATION_MAP:get(collectibleType)
+                    if transformations == nil then
+                        transformations = __TS__New(Set)
+                        ____exports.ITEM_TO_TRANSFORMATION_MAP:set(collectibleType, transformations)
+                    end
+                    transformations:add(playerForm)
+                end
+                ::__continue5::
+            end
+            collectibleType = collectibleType + 1
+        end
+    end
+end
+____exports.TRANSFORMATION_TO_TAG_MAP = __TS__New(Map, {{PlayerForm.PLAYERFORM_GUPPY, 32}, {PlayerForm.PLAYERFORM_LORD_OF_THE_FLIES, 64}, {PlayerForm.PLAYERFORM_MUSHROOM, 256}, {PlayerForm.PLAYERFORM_ANGEL, 1024}, {PlayerForm.PLAYERFORM_BOB, 128}, {PlayerForm.PLAYERFORM_DRUGS, 2}, {PlayerForm.PLAYERFORM_MOM, 4}, {PlayerForm.PLAYERFORM_BABY, 512}, {PlayerForm.PLAYERFORM_EVIL_ANGEL, 2048}, {PlayerForm.PLAYERFORM_POOP, 4096}, {PlayerForm.PLAYERFORM_BOOK_WORM, 8192}, {PlayerForm.PLAYERFORM_SPIDERBABY, 16384}})
+____exports.TRANSFORMATIONS_NOT_BASED_ON_ITEMS = __TS__New(Set, {PlayerForm.PLAYERFORM_ADULTHOOD, PlayerForm.PLAYERFORM_STOMPY, PlayerForm.PLAYERFORM_FLIGHT})
+____exports.TRANSFORMATION_TO_ITEMS_MAP = __TS__New(Map)
+____exports.ITEM_TO_TRANSFORMATION_MAP = __TS__New(Map)
+initMaps(nil)
+return ____exports

package/dist/maps/transformationNameMap.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare const TRANSFORMATION_NAME_MAP: Map<PlayerForm, string>;

package/dist/maps/transformationNameMap.lua

@@ -0,0 +1,5 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+require("lualib_bundle");
+local ____exports = {}
+____exports.TRANSFORMATION_NAME_MAP = __TS__New(Map, {{PlayerForm.PLAYERFORM_GUPPY, "Guppy"}, {PlayerForm.PLAYERFORM_LORD_OF_THE_FLIES, "Beelzebub"}, {PlayerForm.PLAYERFORM_MUSHROOM, "Fun Guy"}, {PlayerForm.PLAYERFORM_ANGEL, "Seraphim"}, {PlayerForm.PLAYERFORM_BOB, "Bob"}, {PlayerForm.PLAYERFORM_DRUGS, "Spun"}, {PlayerForm.PLAYERFORM_MOM, "Yes Mother?"}, {PlayerForm.PLAYERFORM_BABY, "Conjoined"}, {PlayerForm.PLAYERFORM_EVIL_ANGEL, "Leviathan"}, {PlayerForm.PLAYERFORM_POOP, "Oh Crap"}, {PlayerForm.PLAYERFORM_BOOK_WORM, "Bookworm"}, {PlayerForm.PLAYERFORM_ADULTHOOD, "Adult"}, {PlayerForm.PLAYERFORM_SPIDERBABY, "Spider Baby"}, {PlayerForm.PLAYERFORM_STOMPY, "Stompy"}, {PlayerForm.PLAYERFORM_FLIGHT, "Flight"}})
+return ____exports

package/dist/types/TrinketSituation.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="isaac-typescript-definitions" />
+export interface TrinketSituation {
+    trinketTypeRemoved: TrinketType | int;
+    trinket1: TrinketType | int;
+    trinket2: TrinketType | int;
+    numSmeltedTrinkets: int;
+}

package/dist/types/TrinketSituation.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.541",
+  "version": "1.0.545",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,8 +25,8 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.302",
-    "isaacscript-lint": "^1.0.72",
+    "isaac-typescript-definitions": "^1.0.306",
+    "isaacscript-lint": "^1.0.73",
     "typedoc": "^0.22.10",
     "typescript": "4.4.4",
     "typescript-to-lua": "1.1.1"