isaacscript-common 11.0.1 → 11.1.0

package/dist/index.d.ts

@@ -3611,7 +3611,7 @@ export declare function getLatestRoomDescription(): RoomDescription;
  *   ["bar", 456],
  * ]);
  * const searchText = "f";
- * const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
  *
  * @returns If a match was found, returns a tuple of the map key and value. If a match was not
  * found, returns undefined.
@@ -6453,6 +6453,9 @@ export declare function isTear(variable: unknown): variable is EntityTear;
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export declare function isTearFromFamiliar(tear: EntityTear): boolean;
 
@@ -6466,6 +6469,9 @@ export declare function isTearFromFamiliar(tear: EntityTear): boolean;
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export declare function isTearFromPlayer(tear: EntityTear): boolean;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 11.0.1
+isaacscript-common 11.1.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -39258,6 +39258,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
@@ -39277,6 +39280,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
@@ -46950,7 +46956,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "11.0.1",
+    version = "11.1.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",
@@ -46997,7 +47003,7 @@ end
 --   ["bar", 456],
 -- ]);
 -- const searchText = "f";
--- const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+-- const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
 -- 
 -- @returns If a match was found, returns a tuple of the map key and value. If a match was not
 -- found, returns undefined.
@@ -49818,6 +49824,142 @@ end
 function ____exports.isModdedPillEffect(self, pillEffect)
     return not ____exports.isVanillaPillEffect(nil, pillEffect)
 end
+return ____exports
+ end,
+["src.objects.transformationNames"] = function(...) 
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+____exports.TRANSFORMATION_NAMES = {
+    [PlayerForm.GUPPY] = "Guppy",
+    [PlayerForm.BEELZEBUB] = "Beelzebub",
+    [PlayerForm.FUN_GUY] = "Fun Guy",
+    [PlayerForm.SERAPHIM] = "Seraphim",
+    [PlayerForm.BOB] = "Bob",
+    [PlayerForm.SPUN] = "Spun",
+    [PlayerForm.YES_MOTHER] = "Yes Mother?",
+    [PlayerForm.CONJOINED] = "Conjoined",
+    [PlayerForm.LEVIATHAN] = "Leviathan",
+    [PlayerForm.OH_CRAP] = "Oh Crap",
+    [PlayerForm.BOOKWORM] = "Bookworm",
+    [PlayerForm.ADULT] = "Adult",
+    [PlayerForm.SPIDER_BABY] = "Spider Baby",
+    [PlayerForm.STOMPY] = "Stompy"
+}
+return ____exports
+ end,
+["src.functions.transformations"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__Iterator = ____lualib.__TS__Iterator
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+local ____transformationNames = require("src.objects.transformationNames")
+local TRANSFORMATION_NAMES = ____transformationNames.TRANSFORMATION_NAMES
+local ____collectibles = require("src.functions.collectibles")
+local getCollectibleTags = ____collectibles.getCollectibleTags
+local ____collectibleTag = require("src.functions.collectibleTag")
+local getCollectibleTypesWithTag = ____collectibleTag.getCollectibleTypesWithTag
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____flag = require("src.functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____players = require("src.functions.players")
+local getPlayerCollectibleCount = ____players.getPlayerCollectibleCount
+local TRANSFORMATION_TO_TAG_MAP = __TS__New(Map, {
+    {PlayerForm.GUPPY, ItemConfigTag.GUPPY},
+    {PlayerForm.BEELZEBUB, ItemConfigTag.FLY},
+    {PlayerForm.FUN_GUY, ItemConfigTag.MUSHROOM},
+    {PlayerForm.SERAPHIM, ItemConfigTag.ANGEL},
+    {PlayerForm.BOB, ItemConfigTag.BOB},
+    {PlayerForm.SPUN, ItemConfigTag.SYRINGE},
+    {PlayerForm.YES_MOTHER, ItemConfigTag.MOM},
+    {PlayerForm.CONJOINED, ItemConfigTag.BABY},
+    {PlayerForm.LEVIATHAN, ItemConfigTag.DEVIL},
+    {PlayerForm.OH_CRAP, ItemConfigTag.POOP},
+    {PlayerForm.BOOKWORM, ItemConfigTag.BOOK},
+    {PlayerForm.SPIDER_BABY, ItemConfigTag.SPIDER}
+})
+local TRANSFORMATIONS_THAT_GRANT_FLYING = __TS__New(Set, {PlayerForm.GUPPY, PlayerForm.BEELZEBUB, PlayerForm.SERAPHIM, PlayerForm.LEVIATHAN})
+--- Helper function to get all of the collectible types in the game that count towards a particular
+-- transformation.
+-- 
+-- For example, to get all of the collectible types that count towards Guppy:
+-- 
+-- ```ts
+-- const guppyCollectibleTypes = getCollectibleTypesForTransformation(PlayerForm.GUPPY);
+-- ```
+function ____exports.getCollectibleTypesForTransformation(self, playerForm)
+    local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
+    if itemConfigTag == nil then
+        error(("Failed to get the collectible types for the transformation of " .. tostring(playerForm)) .. " because that transformation is not based on collectibles.")
+    end
+    return getCollectibleTypesWithTag(nil, itemConfigTag)
+end
+--- Returns the number of items that a player has towards a particular transformation.
+function ____exports.getPlayerNumCollectiblesForTransformation(self, player, playerForm)
+    local collectibleTypes = ____exports.getCollectibleTypesForTransformation(nil, playerForm)
+    return getPlayerCollectibleCount(
+        nil,
+        player,
+        __TS__Spread(collectibleTypes:values())
+    )
+end
+--- Returns a set of the player's current transformations.
+function ____exports.getPlayerTransformations(self, player)
+    local transformations = __TS__New(Set)
+    for ____, playerForm in ipairs(getEnumValues(nil, PlayerForm)) do
+        if player:HasPlayerForm(playerForm) then
+            transformations:add(playerForm)
+        end
+    end
+    return transformations
+end
+--- Helper function to get a transformation name from a PlayerForm enum.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const transformationName = getTransformationName(PlayerForm.LORD_OF_THE_FLIES);
+-- // transformationName is "Beelzebub"
+-- ```
+function ____exports.getTransformationName(self, playerForm)
+    return TRANSFORMATION_NAMES[playerForm]
+end
+function ____exports.getTransformationsForCollectibleType(self, collectibleType)
+    local itemConfigTags = getCollectibleTags(nil, collectibleType)
+    local playerForms = getEnumValues(nil, PlayerForm)
+    local transformationSet = __TS__New(Set)
+    for ____, playerForm in ipairs(playerForms) do
+        do
+            local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
+            if itemConfigTag == nil then
+                goto __continue11
+            end
+            if hasFlag(nil, itemConfigTags, itemConfigTag) then
+                transformationSet:add(playerForm)
+            end
+        end
+        ::__continue11::
+    end
+    return transformationSet
+end
+function ____exports.hasFlyingTransformation(self, player)
+    for ____, playerForm in __TS__Iterator(TRANSFORMATIONS_THAT_GRANT_FLYING:values()) do
+        if player:HasPlayerForm(playerForm) then
+            return true
+        end
+    end
+    return false
+end
+function ____exports.isTransformationFlying(self, playerForm)
+    return TRANSFORMATIONS_THAT_GRANT_FLYING:has(playerForm)
+end
 return ____exports
  end,
 ["src.maps.cardNameToTypeMap"] = function(...) 
@@ -50287,6 +50429,45 @@ ____exports.ROOM_NAME_TO_TYPE_MAP = __TS__New(Map, {
     {"blue", RoomType.BLUE},
     {"ultraSecret", RoomType.ULTRA_SECRET}
 })
+return ____exports
+ end,
+["src.maps.transformationNameToPlayerForm"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+--- Maps transformation names to the values of the `PlayerForm` enum.
+____exports.TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP = __TS__New(Map, {
+    {"guppy", PlayerForm.GUPPY},
+    {"cat", PlayerForm.GUPPY},
+    {"beelzebub", PlayerForm.BEELZEBUB},
+    {"fly", PlayerForm.BEELZEBUB},
+    {"funGuy", PlayerForm.FUN_GUY},
+    {"mushroom", PlayerForm.FUN_GUY},
+    {"seraphim", PlayerForm.SERAPHIM},
+    {"angel", PlayerForm.SERAPHIM},
+    {"bob", PlayerForm.BOB},
+    {"poison", PlayerForm.BOB},
+    {"spun", PlayerForm.SPUN},
+    {"drugs", PlayerForm.SPUN},
+    {"needles", PlayerForm.SPUN},
+    {"yesMother", PlayerForm.YES_MOTHER},
+    {"mother", PlayerForm.YES_MOTHER},
+    {"mom", PlayerForm.YES_MOTHER},
+    {"conjoined", PlayerForm.CONJOINED},
+    {"triple", PlayerForm.CONJOINED},
+    {"leviathan", PlayerForm.LEVIATHAN},
+    {"devil", PlayerForm.LEVIATHAN},
+    {"ohCrap", PlayerForm.OH_CRAP},
+    {"crap", PlayerForm.OH_CRAP},
+    {"poop", PlayerForm.OH_CRAP},
+    {"bookWorm", PlayerForm.BOOKWORM},
+    {"adult", PlayerForm.ADULT},
+    {"spiderBaby", PlayerForm.SPIDER_BABY},
+    {"stompy", PlayerForm.STOMPY}
+})
 return ____exports
  end,
 ["src.maps.trinketNameToTypeMap"] = function(...) 
@@ -50766,6 +50947,7 @@ local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local GridRoom = ____isaac_2Dtypescript_2Ddefinitions.GridRoom
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
 local PillColor = ____isaac_2Dtypescript_2Ddefinitions.PillColor
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
 local ____cachedClasses = require("src.core.cachedClasses")
@@ -50798,6 +50980,7 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local getNPCs = ____entitiesSpecific.getNPCs
 local ____enums = require("src.functions.enums")
 local getEnumValues = ____enums.getEnumValues
+local getLastEnumValue = ____enums.getLastEnumValue
 local ____flag = require("src.functions.flag")
 local addFlag = ____flag.addFlag
 local ____gridEntities = require("src.functions.gridEntities")
@@ -50836,10 +51019,15 @@ local ____run = require("src.functions.run")
 local onSetSeed = ____run.onSetSeed
 local restart = ____run.restart
 local setUnseeded = ____run.setUnseeded
+local ____set = require("src.functions.set")
+local getSortedSetValues = ____set.getSortedSetValues
 local ____spawnCollectible = require("src.functions.spawnCollectible")
 local spawnCollectibleFunction = ____spawnCollectible.spawnCollectible
 local ____stage = require("src.functions.stage")
 local setStage = ____stage.setStage
+local ____transformations = require("src.functions.transformations")
+local getCollectibleTypesForTransformation = ____transformations.getCollectibleTypesForTransformation
+local getTransformationName = ____transformations.getTransformationName
 local ____trinkets = require("src.functions.trinkets")
 local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
 local ____types = require("src.functions.types")
@@ -50860,6 +51048,8 @@ local ____pillNameToEffectMap = require("src.maps.pillNameToEffectMap")
 local PILL_NAME_TO_EFFECT_MAP = ____pillNameToEffectMap.PILL_NAME_TO_EFFECT_MAP
 local ____roomNameToTypeMap = require("src.maps.roomNameToTypeMap")
 local ROOM_NAME_TO_TYPE_MAP = ____roomNameToTypeMap.ROOM_NAME_TO_TYPE_MAP
+local ____transformationNameToPlayerForm = require("src.maps.transformationNameToPlayerForm")
+local TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP = ____transformationNameToPlayerForm.TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP
 local ____trinketNameToTypeMap = require("src.maps.trinketNameToTypeMap")
 local TRINKET_NAME_TO_TYPE_MAP = ____trinketNameToTypeMap.TRINKET_NAME_TO_TYPE_MAP
 local ____firstLast = require("src.features.firstLast")
@@ -50954,6 +51144,56 @@ function ____exports.startingRoom(self)
     local startingRoomIndex = level:GetStartingRoomIndex()
     changeRoom(nil, startingRoomIndex)
 end
+--- Gives the specified transformation. Accepts either the transformation number or the partial name
+-- of the transformation.
+-- 
+-- For example:
+-- - transformation 1 - Gives the Beelzebub transformation.
+-- - transformation gup - Gives the Guppy transformation.
+function ____exports.transformation(self, params)
+    if params == "" then
+        printConsole(nil, "You must specify a transformation name or number.")
+        return
+    end
+    local targetPlayerForm
+    local num = tonumber(params)
+    if num == nil then
+        local match = getMapPartialMatch(nil, params, TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP)
+        if match == nil then
+            printConsole(nil, "Unknown transformation: " .. params)
+            return
+        end
+        targetPlayerForm = match[2]
+    else
+        local lastPlayerForm = getLastEnumValue(nil, PlayerForm)
+        if num < PlayerForm.GUPPY or num > lastPlayerForm then
+            printConsole(
+                nil,
+                "Invalid transformation number: " .. tostring(num)
+            )
+            return
+        end
+        targetPlayerForm = num
+    end
+    local transformationName = getTransformationName(nil, targetPlayerForm)
+    local player = Isaac.GetPlayer()
+    local collectibleTypesSet = getCollectibleTypesForTransformation(nil, targetPlayerForm)
+    local collectiblesTypes = getSortedSetValues(nil, collectibleTypesSet)
+    do
+        local i = 0
+        while i < 3 do
+            local collectibleType = collectiblesTypes[i + 1]
+            if collectibleType ~= nil then
+                player:AddCollectible(collectibleType)
+            end
+            i = i + 1
+        end
+    end
+    printConsole(
+        nil,
+        ((("Gave transformation: " .. transformationName) .. " (") .. tostring(targetPlayerForm)) .. ")"
+    )
+end
 --- Adds a single charge to the player's specified active item. You must provide the active slot
 -- number. Provide a second number to give a custom amount of charges. (You can use negative numbers
 -- to remove charge.)
@@ -51626,6 +51866,10 @@ end
 function ____exports.playSound(self, params)
     ____exports.sound(nil, params)
 end
+--- Alias for the "transformation" command.
+function ____exports.playerForm(self, params)
+    ____exports.transformation(nil, params)
+end
 --- Sets the player's pocket item to the specified collectible type.
 function ____exports.pocket(self, params)
     if params == "" then
@@ -54605,142 +54849,6 @@ function ____exports.nextSeed(self, seed)
     rng:Next()
     return rng:GetSeed()
 end
-return ____exports
- end,
-["src.objects.transformationNames"] = function(...) 
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
-local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
-____exports.TRANSFORMATION_NAMES = {
-    [PlayerForm.GUPPY] = "Guppy",
-    [PlayerForm.BEELZEBUB] = "Beelzebub",
-    [PlayerForm.FUN_GUY] = "Fun Guy",
-    [PlayerForm.SERAPHIM] = "Seraphim",
-    [PlayerForm.BOB] = "Bob",
-    [PlayerForm.SPUN] = "Spun",
-    [PlayerForm.YES_MOTHER] = "Yes Mother?",
-    [PlayerForm.CONJOINED] = "Conjoined",
-    [PlayerForm.LEVIATHAN] = "Leviathan",
-    [PlayerForm.OH_CRAP] = "Oh Crap",
-    [PlayerForm.BOOKWORM] = "Bookworm",
-    [PlayerForm.ADULT] = "Adult",
-    [PlayerForm.SPIDER_BABY] = "Spider Baby",
-    [PlayerForm.STOMPY] = "Stompy"
-}
-return ____exports
- end,
-["src.functions.transformations"] = function(...) 
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
-local __TS__New = ____lualib.__TS__New
-local Set = ____lualib.Set
-local __TS__Spread = ____lualib.__TS__Spread
-local __TS__Iterator = ____lualib.__TS__Iterator
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
-local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
-local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
-local ____transformationNames = require("src.objects.transformationNames")
-local TRANSFORMATION_NAMES = ____transformationNames.TRANSFORMATION_NAMES
-local ____collectibles = require("src.functions.collectibles")
-local getCollectibleTags = ____collectibles.getCollectibleTags
-local ____collectibleTag = require("src.functions.collectibleTag")
-local getCollectibleTypesWithTag = ____collectibleTag.getCollectibleTypesWithTag
-local ____enums = require("src.functions.enums")
-local getEnumValues = ____enums.getEnumValues
-local ____flag = require("src.functions.flag")
-local hasFlag = ____flag.hasFlag
-local ____players = require("src.functions.players")
-local getPlayerCollectibleCount = ____players.getPlayerCollectibleCount
-local TRANSFORMATION_TO_TAG_MAP = __TS__New(Map, {
-    {PlayerForm.GUPPY, ItemConfigTag.GUPPY},
-    {PlayerForm.BEELZEBUB, ItemConfigTag.FLY},
-    {PlayerForm.FUN_GUY, ItemConfigTag.MUSHROOM},
-    {PlayerForm.SERAPHIM, ItemConfigTag.ANGEL},
-    {PlayerForm.BOB, ItemConfigTag.BOB},
-    {PlayerForm.SPUN, ItemConfigTag.SYRINGE},
-    {PlayerForm.YES_MOTHER, ItemConfigTag.MOM},
-    {PlayerForm.CONJOINED, ItemConfigTag.BABY},
-    {PlayerForm.LEVIATHAN, ItemConfigTag.DEVIL},
-    {PlayerForm.OH_CRAP, ItemConfigTag.POOP},
-    {PlayerForm.BOOKWORM, ItemConfigTag.BOOK},
-    {PlayerForm.SPIDER_BABY, ItemConfigTag.SPIDER}
-})
-local TRANSFORMATIONS_THAT_GRANT_FLYING = __TS__New(Set, {PlayerForm.GUPPY, PlayerForm.BEELZEBUB, PlayerForm.SERAPHIM, PlayerForm.LEVIATHAN})
---- Helper function to get all of the collectible types in the game that count towards a particular
--- transformation.
--- 
--- For example, to get all of the collectible types that count towards Guppy:
--- 
--- ```ts
--- const guppyCollectibleTypes = getCollectibleTypesForTransformation(PlayerForm.GUPPY);
--- ```
-function ____exports.getCollectibleTypesForTransformation(self, playerForm)
-    local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
-    if itemConfigTag == nil then
-        error(("Failed to get the collectible types for the transformation of " .. tostring(playerForm)) .. " because that transformation is not based on collectibles.")
-    end
-    return getCollectibleTypesWithTag(nil, itemConfigTag)
-end
---- Returns the number of items that a player has towards a particular transformation.
-function ____exports.getPlayerNumCollectiblesForTransformation(self, player, playerForm)
-    local collectibleTypes = ____exports.getCollectibleTypesForTransformation(nil, playerForm)
-    return getPlayerCollectibleCount(
-        nil,
-        player,
-        __TS__Spread(collectibleTypes:values())
-    )
-end
---- Returns a set of the player's current transformations.
-function ____exports.getPlayerTransformations(self, player)
-    local transformations = __TS__New(Set)
-    for ____, playerForm in ipairs(getEnumValues(nil, PlayerForm)) do
-        if player:HasPlayerForm(playerForm) then
-            transformations:add(playerForm)
-        end
-    end
-    return transformations
-end
---- Helper function to get a transformation name from a PlayerForm enum.
--- 
--- For example:
--- 
--- ```ts
--- const transformationName = getTransformationName(PlayerForm.LORD_OF_THE_FLIES);
--- // transformationName is "Beelzebub"
--- ```
-function ____exports.getTransformationName(self, playerForm)
-    return TRANSFORMATION_NAMES[playerForm]
-end
-function ____exports.getTransformationsForCollectibleType(self, collectibleType)
-    local itemConfigTags = getCollectibleTags(nil, collectibleType)
-    local playerForms = getEnumValues(nil, PlayerForm)
-    local transformationSet = __TS__New(Set)
-    for ____, playerForm in ipairs(playerForms) do
-        do
-            local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
-            if itemConfigTag == nil then
-                goto __continue11
-            end
-            if hasFlag(nil, itemConfigTags, itemConfigTag) then
-                transformationSet:add(playerForm)
-            end
-        end
-        ::__continue11::
-    end
-    return transformationSet
-end
-function ____exports.hasFlyingTransformation(self, player)
-    for ____, playerForm in __TS__Iterator(TRANSFORMATIONS_THAT_GRANT_FLYING:values()) do
-        if player:HasPlayerForm(playerForm) then
-            return true
-        end
-    end
-    return false
-end
-function ____exports.isTransformationFlying(self, playerForm)
-    return TRANSFORMATIONS_THAT_GRANT_FLYING:has(playerForm)
-end
 return ____exports
  end,
 ["src.functions.trinketCacheFlag"] = function(...) 

package/dist/package.lua

@@ -1,6 +1,6 @@
 return {
     name = "isaacscript-common",
-    version = "11.0.1",
+    version = "11.1.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/src/features/extraConsoleCommands/listCommands.d.ts

@@ -268,6 +268,8 @@ export declare function pills(): void;
 export declare function planetarium(): void;
 /** Alias for the "sound" command. */
 export declare function playSound(params: string): void;
+/** Alias for the "transformation" command. */
+export declare function playerForm(params: string): void;
 /** Sets the player's pocket item to the specified collectible type. */
 export declare function pocket(params: string): void;
 /**
@@ -373,6 +375,15 @@ export declare function superSecretRoom(): void;
 export declare function tears(): void;
 /** Alias for the "runTests" command. */
 export declare function tests(): void;
+/**
+ * Gives the specified transformation. Accepts either the transformation number or the partial name
+ * of the transformation.
+ *
+ * For example:
+ * - transformation 1 - Gives the Beelzebub transformation.
+ * - transformation gup - Gives the Guppy transformation.
+ */
+export declare function transformation(params: string): void;
 /** Creates a trapdoor next to the player. */
 export declare function trapdoor(): void;
 /** Warps to the first Treasure Room on the floor. */

package/dist/src/features/extraConsoleCommands/listCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listCommands.d.ts","sourceRoot":"","sources":["../../../../src/features/extraConsoleCommands/listCommands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"listCommands.d.ts","sourceRoot":"","sources":["../../../../src/features/extraConsoleCommands/listCommands.ts"],"names":[],"mappings":"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"}

package/dist/src/features/extraConsoleCommands/listCommands.lua

@@ -17,6 +17,7 @@ local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local GridRoom = ____isaac_2Dtypescript_2Ddefinitions.GridRoom
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
 local PillColor = ____isaac_2Dtypescript_2Ddefinitions.PillColor
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
 local ____cachedClasses = require("src.core.cachedClasses")
@@ -49,6 +50,7 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local getNPCs = ____entitiesSpecific.getNPCs
 local ____enums = require("src.functions.enums")
 local getEnumValues = ____enums.getEnumValues
+local getLastEnumValue = ____enums.getLastEnumValue
 local ____flag = require("src.functions.flag")
 local addFlag = ____flag.addFlag
 local ____gridEntities = require("src.functions.gridEntities")
@@ -87,10 +89,15 @@ local ____run = require("src.functions.run")
 local onSetSeed = ____run.onSetSeed
 local restart = ____run.restart
 local setUnseeded = ____run.setUnseeded
+local ____set = require("src.functions.set")
+local getSortedSetValues = ____set.getSortedSetValues
 local ____spawnCollectible = require("src.functions.spawnCollectible")
 local spawnCollectibleFunction = ____spawnCollectible.spawnCollectible
 local ____stage = require("src.functions.stage")
 local setStage = ____stage.setStage
+local ____transformations = require("src.functions.transformations")
+local getCollectibleTypesForTransformation = ____transformations.getCollectibleTypesForTransformation
+local getTransformationName = ____transformations.getTransformationName
 local ____trinkets = require("src.functions.trinkets")
 local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
 local ____types = require("src.functions.types")
@@ -111,6 +118,8 @@ local ____pillNameToEffectMap = require("src.maps.pillNameToEffectMap")
 local PILL_NAME_TO_EFFECT_MAP = ____pillNameToEffectMap.PILL_NAME_TO_EFFECT_MAP
 local ____roomNameToTypeMap = require("src.maps.roomNameToTypeMap")
 local ROOM_NAME_TO_TYPE_MAP = ____roomNameToTypeMap.ROOM_NAME_TO_TYPE_MAP
+local ____transformationNameToPlayerForm = require("src.maps.transformationNameToPlayerForm")
+local TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP = ____transformationNameToPlayerForm.TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP
 local ____trinketNameToTypeMap = require("src.maps.trinketNameToTypeMap")
 local TRINKET_NAME_TO_TYPE_MAP = ____trinketNameToTypeMap.TRINKET_NAME_TO_TYPE_MAP
 local ____firstLast = require("src.features.firstLast")
@@ -205,6 +214,56 @@ function ____exports.startingRoom(self)
     local startingRoomIndex = level:GetStartingRoomIndex()
     changeRoom(nil, startingRoomIndex)
 end
+--- Gives the specified transformation. Accepts either the transformation number or the partial name
+-- of the transformation.
+-- 
+-- For example:
+-- - transformation 1 - Gives the Beelzebub transformation.
+-- - transformation gup - Gives the Guppy transformation.
+function ____exports.transformation(self, params)
+    if params == "" then
+        printConsole(nil, "You must specify a transformation name or number.")
+        return
+    end
+    local targetPlayerForm
+    local num = tonumber(params)
+    if num == nil then
+        local match = getMapPartialMatch(nil, params, TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP)
+        if match == nil then
+            printConsole(nil, "Unknown transformation: " .. params)
+            return
+        end
+        targetPlayerForm = match[2]
+    else
+        local lastPlayerForm = getLastEnumValue(nil, PlayerForm)
+        if num < PlayerForm.GUPPY or num > lastPlayerForm then
+            printConsole(
+                nil,
+                "Invalid transformation number: " .. tostring(num)
+            )
+            return
+        end
+        targetPlayerForm = num
+    end
+    local transformationName = getTransformationName(nil, targetPlayerForm)
+    local player = Isaac.GetPlayer()
+    local collectibleTypesSet = getCollectibleTypesForTransformation(nil, targetPlayerForm)
+    local collectiblesTypes = getSortedSetValues(nil, collectibleTypesSet)
+    do
+        local i = 0
+        while i < 3 do
+            local collectibleType = collectiblesTypes[i + 1]
+            if collectibleType ~= nil then
+                player:AddCollectible(collectibleType)
+            end
+            i = i + 1
+        end
+    end
+    printConsole(
+        nil,
+        ((("Gave transformation: " .. transformationName) .. " (") .. tostring(targetPlayerForm)) .. ")"
+    )
+end
 --- Adds a single charge to the player's specified active item. You must provide the active slot
 -- number. Provide a second number to give a custom amount of charges. (You can use negative numbers
 -- to remove charge.)
@@ -877,6 +936,10 @@ end
 function ____exports.playSound(self, params)
     ____exports.sound(nil, params)
 end
+--- Alias for the "transformation" command.
+function ____exports.playerForm(self, params)
+    ____exports.transformation(nil, params)
+end
 --- Sets the player's pocket item to the specified collectible type.
 function ____exports.pocket(self, params)
     if params == "" then

package/dist/src/functions/map.d.ts

@@ -13,7 +13,7 @@ export declare function copyMap<K, V>(oldMap: Map<K, V>): Map<K, V>;
  *   ["bar", 456],
  * ]);
  * const searchText = "f";
- * const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
  *
  * @returns If a match was found, returns a tuple of the map key and value. If a match was not
  * found, returns undefined.

package/dist/src/functions/map.lua

@@ -30,7 +30,7 @@ end
 --   ["bar", 456],
 -- ]);
 -- const searchText = "f";
--- const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+-- const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
 -- 
 -- @returns If a match was found, returns a tuple of the map key and value. If a match was not
 -- found, returns undefined.

package/dist/src/functions/tears.d.ts

@@ -33,6 +33,9 @@ export declare function getTearsStat(fireDelay: float): float;
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export declare function isTearFromFamiliar(tear: EntityTear): boolean;
 /**
@@ -45,6 +48,9 @@ export declare function isTearFromFamiliar(tear: EntityTear): boolean;
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export declare function isTearFromPlayer(tear: EntityTear): boolean;
 //# sourceMappingURL=tears.d.ts.map

package/dist/src/functions/tears.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}
+{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}

package/dist/src/functions/tears.lua

@@ -33,6 +33,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
@@ -52,6 +55,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")

package/dist/src/maps/transformationNameToPlayerForm.d.ts

@@ -0,0 +1,4 @@
+import { PlayerForm } from "isaac-typescript-definitions";
+/** Maps transformation names to the values of the `PlayerForm` enum. */
+export declare const TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP: ReadonlyMap<string, PlayerForm>;
+//# sourceMappingURL=transformationNameToPlayerForm.d.ts.map

package/dist/src/maps/transformationNameToPlayerForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformationNameToPlayerForm.d.ts","sourceRoot":"","sources":["../../../src/maps/transformationNameToPlayerForm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,wEAAwE;AACxE,eAAO,MAAM,sCAAsC,EAAE,WAAW,CAC9D,MAAM,EACN,UAAU,CA6BV,CAAC"}

package/dist/src/maps/transformationNameToPlayerForm.lua

@@ -0,0 +1,37 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+--- Maps transformation names to the values of the `PlayerForm` enum.
+____exports.TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP = __TS__New(Map, {
+    {"guppy", PlayerForm.GUPPY},
+    {"cat", PlayerForm.GUPPY},
+    {"beelzebub", PlayerForm.BEELZEBUB},
+    {"fly", PlayerForm.BEELZEBUB},
+    {"funGuy", PlayerForm.FUN_GUY},
+    {"mushroom", PlayerForm.FUN_GUY},
+    {"seraphim", PlayerForm.SERAPHIM},
+    {"angel", PlayerForm.SERAPHIM},
+    {"bob", PlayerForm.BOB},
+    {"poison", PlayerForm.BOB},
+    {"spun", PlayerForm.SPUN},
+    {"drugs", PlayerForm.SPUN},
+    {"needles", PlayerForm.SPUN},
+    {"yesMother", PlayerForm.YES_MOTHER},
+    {"mother", PlayerForm.YES_MOTHER},
+    {"mom", PlayerForm.YES_MOTHER},
+    {"conjoined", PlayerForm.CONJOINED},
+    {"triple", PlayerForm.CONJOINED},
+    {"leviathan", PlayerForm.LEVIATHAN},
+    {"devil", PlayerForm.LEVIATHAN},
+    {"ohCrap", PlayerForm.OH_CRAP},
+    {"crap", PlayerForm.OH_CRAP},
+    {"poop", PlayerForm.OH_CRAP},
+    {"bookWorm", PlayerForm.BOOKWORM},
+    {"adult", PlayerForm.ADULT},
+    {"spiderBaby", PlayerForm.SPIDER_BABY},
+    {"stompy", PlayerForm.STOMPY}
+})
+return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "11.0.1",
+  "version": "11.1.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/features/extraConsoleCommands/listCommands.ts

@@ -45,6 +45,7 @@ import {
   LevelStage,
   PillColor,
   PillEffect,
+  PlayerForm,
   PlayerType,
   RoomType,
   SoundEffect,
@@ -70,7 +71,7 @@ import { addCharge } from "../../functions/charge";
 import { isValidCollectibleType } from "../../functions/collectibles";
 import { runDeepCopyTests } from "../../functions/deepCopyTests";
 import { getNPCs } from "../../functions/entitiesSpecific";
-import { getEnumValues } from "../../functions/enums";
+import { getEnumValues, getLastEnumValue } from "../../functions/enums";
 import { addFlag } from "../../functions/flag";
 import { spawnGridEntity } from "../../functions/gridEntities";
 import { getRoomGridIndexesForType } from "../../functions/levelGrid";
@@ -99,8 +100,13 @@ import { gridCoordinatesToWorldPosition } from "../../functions/roomGrid";
 import { changeRoom } from "../../functions/rooms";
 import { reloadRoom as reloadRoomFunction } from "../../functions/roomTransition";
 import { onSetSeed, restart, setUnseeded } from "../../functions/run";
+import { getSortedSetValues } from "../../functions/set";
 import { spawnCollectible as spawnCollectibleFunction } from "../../functions/spawnCollectible";
 import { setStage } from "../../functions/stage";
+import {
+  getCollectibleTypesForTransformation,
+  getTransformationName,
+} from "../../functions/transformations";
 import { getGoldenTrinketType } from "../../functions/trinkets";
 import {
   asCardType,
@@ -113,6 +119,7 @@ import { CHARACTER_NAME_TO_TYPE_MAP } from "../../maps/characterNameToTypeMap";
 import { COLLECTIBLE_NAME_TO_TYPE_MAP } from "../../maps/collectibleNameToTypeMap";
 import { PILL_NAME_TO_EFFECT_MAP } from "../../maps/pillNameToEffectMap";
 import { ROOM_NAME_TO_TYPE_MAP } from "../../maps/roomNameToTypeMap";
+import { TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP } from "../../maps/transformationNameToPlayerForm";
 import { TRINKET_NAME_TO_TYPE_MAP } from "../../maps/trinketNameToTypeMap";
 import { getLastCardType, getLastPillEffect } from "../firstLast";
 import {
@@ -1000,6 +1007,11 @@ export function playSound(params: string): void {
   sound(params);
 }
 
+/** Alias for the "transformation" command. */
+export function playerForm(params: string): void {
+  transformation(params);
+}
+
 /** Sets the player's pocket item to the specified collectible type. */
 export function pocket(params: string): void {
   if (params === "") {
@@ -1456,6 +1468,60 @@ export function tests(): void {
   runTests();
 }
 
+/**
+ * Gives the specified transformation. Accepts either the transformation number or the partial name
+ * of the transformation.
+ *
+ * For example:
+ * - transformation 1 - Gives the Beelzebub transformation.
+ * - transformation gup - Gives the Guppy transformation.
+ */
+export function transformation(params: string): void {
+  if (params === "") {
+    printConsole("You must specify a transformation name or number.");
+    return;
+  }
+
+  let targetPlayerForm: PlayerForm;
+  const num = tonumber(params) as PlayerForm | undefined;
+  if (num === undefined) {
+    const match = getMapPartialMatch(
+      params,
+      TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP,
+    );
+    if (match === undefined) {
+      printConsole(`Unknown transformation: ${params}`);
+      return;
+    }
+
+    targetPlayerForm = match[1];
+  } else {
+    const lastPlayerForm = getLastEnumValue(PlayerForm);
+    if (num < PlayerForm.GUPPY || num > lastPlayerForm) {
+      printConsole(`Invalid transformation number: ${num}`);
+      return;
+    }
+
+    targetPlayerForm = num;
+  }
+
+  const transformationName = getTransformationName(targetPlayerForm);
+  const player = Isaac.GetPlayer();
+  const collectibleTypesSet =
+    getCollectibleTypesForTransformation(targetPlayerForm);
+  const collectiblesTypes = getSortedSetValues(collectibleTypesSet);
+  for (let i = 0; i < 3; i++) {
+    const collectibleType = collectiblesTypes[i];
+    if (collectibleType !== undefined) {
+      player.AddCollectible(collectibleType);
+    }
+  }
+
+  printConsole(
+    `Gave transformation: ${transformationName} (${targetPlayerForm})`,
+  );
+}
+
 /** Creates a trapdoor next to the player. */
 export function trapdoor(): void {
   spawnTrapdoorOrCrawlSpace(true);

package/src/functions/map.ts

@@ -24,7 +24,7 @@ export function copyMap<K, V>(oldMap: Map<K, V>): Map<K, V> {
  *   ["bar", 456],
  * ]);
  * const searchText = "f";
- * const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
  *
  * @returns If a match was found, returns a tuple of the map key and value. If a match was not
  * found, returns undefined.

package/src/functions/tears.ts

@@ -42,6 +42,9 @@ export function getTearsStat(fireDelay: float): float {
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export function isTearFromFamiliar(tear: EntityTear): boolean {
   if (tear.FrameCount === 0) {
@@ -71,6 +74,9 @@ export function isTearFromFamiliar(tear: EntityTear): boolean {
  * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
+ *
+ * Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+ * this case, it will always appear as if the tear is coming from a player.
  */
 export function isTearFromPlayer(tear: EntityTear): boolean {
   if (tear.FrameCount === 0) {

package/src/maps/transformationNameToPlayerForm.ts

@@ -0,0 +1,35 @@
+import { PlayerForm } from "isaac-typescript-definitions";
+
+/** Maps transformation names to the values of the `PlayerForm` enum. */
+export const TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP: ReadonlyMap<
+  string,
+  PlayerForm
+> = new Map([
+  ["guppy", PlayerForm.GUPPY], // 0
+  ["cat", PlayerForm.GUPPY], // 0
+  ["beelzebub", PlayerForm.BEELZEBUB], // 1
+  ["fly", PlayerForm.BEELZEBUB], // 1
+  ["funGuy", PlayerForm.FUN_GUY], // 2
+  ["mushroom", PlayerForm.FUN_GUY], // 2
+  ["seraphim", PlayerForm.SERAPHIM], // 3
+  ["angel", PlayerForm.SERAPHIM], // 3
+  ["bob", PlayerForm.BOB], // 4
+  ["poison", PlayerForm.BOB], // 4
+  ["spun", PlayerForm.SPUN], // 5
+  ["drugs", PlayerForm.SPUN], // 5
+  ["needles", PlayerForm.SPUN], // 5
+  ["yesMother", PlayerForm.YES_MOTHER], // 6
+  ["mother", PlayerForm.YES_MOTHER], // 6
+  ["mom", PlayerForm.YES_MOTHER], // 6
+  ["conjoined", PlayerForm.CONJOINED], // 7
+  ["triple", PlayerForm.CONJOINED], // 7
+  ["leviathan", PlayerForm.LEVIATHAN], // 8
+  ["devil", PlayerForm.LEVIATHAN], // 8
+  ["ohCrap", PlayerForm.OH_CRAP], // 9
+  ["crap", PlayerForm.OH_CRAP], // 9
+  ["poop", PlayerForm.OH_CRAP], // 9
+  ["bookWorm", PlayerForm.BOOKWORM], // 10
+  ["adult", PlayerForm.ADULT], // 11
+  ["spiderBaby", PlayerForm.SPIDER_BABY], // 12
+  ["stompy", PlayerForm.STOMPY], // 13
+]);