isaacscript-common 9.18.4 → 9.19.2

package/dist/src/functions/pickupsSpecific.lua

@@ -0,0 +1,560 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
+local ____constants = require("src.core.constants")
+local VectorZero = ____constants.VectorZero
+local ____entitiesSpecific = require("src.functions.entitiesSpecific")
+local getPickups = ____entitiesSpecific.getPickups
+local removeAllPickups = ____entitiesSpecific.removeAllPickups
+local spawnPickup = ____entitiesSpecific.spawnPickup
+--- Helper function to get all of the battery entities in the room.
+-- 
+-- @param batterySubType Optional. If specified, will only get the batteries that match the
+-- sub-type. Default is -1, which matches every sub-type.
+function ____exports.getBatteries(self, batterySubType)
+    if batterySubType == nil then
+        batterySubType = -1
+    end
+    return getPickups(nil, PickupVariant.LIL_BATTERY, batterySubType)
+end
+--- Helper function to get all of the bomb entities in the room. (Specifically, this refers to bomb
+-- pickups, not the `EntityBomb` class.)
+-- 
+-- @param bombSubType Optional. If specified, will only get the bombs that match the sub-type.
+-- Default is -1, which matches every sub-type.
+function ____exports.getBombPickups(self, bombSubType)
+    if bombSubType == nil then
+        bombSubType = -1
+    end
+    return getPickups(nil, PickupVariant.BOMB, bombSubType)
+end
+--- Helper function to get all of the card entities in the room.
+-- 
+-- @param cardType Optional. If specified, will only get the cards that match the sub-type. Default
+-- is -1, which matches every sub-type.
+function ____exports.getCards(self, cardType)
+    if cardType == nil then
+        cardType = -1
+    end
+    return getPickups(nil, PickupVariant.TAROT_CARD, cardType)
+end
+--- Helper function to get all of the coin pickup entities in the room.
+-- 
+-- @param coinSubType Optional. If specified, will only get the coins that match the sub-type.
+-- Default is -1, which matches every sub-type.
+function ____exports.getCoins(self, coinSubType)
+    if coinSubType == nil then
+        coinSubType = -1
+    end
+    return getPickups(nil, PickupVariant.COIN, coinSubType)
+end
+--- Helper function to get all of the collectible entities in the room.
+-- 
+-- @param collectibleType Optional. If specified, will only get the collectibles that match the
+-- sub-type. Default is -1, which matches every sub-type.
+function ____exports.getCollectibles(self, collectibleType)
+    if collectibleType == nil then
+        collectibleType = -1
+    end
+    return getPickups(nil, PickupVariant.COLLECTIBLE, collectibleType)
+end
+--- Helper function to get all of the heart pickup entities in the room.
+-- 
+-- @param heartSubType Optional. If specified, will only get the hearts that match the sub-type.
+-- Default is -1, which matches every sub-type.
+function ____exports.getHearts(self, heartSubType)
+    if heartSubType == nil then
+        heartSubType = -1
+    end
+    return getPickups(nil, PickupVariant.HEART, heartSubType)
+end
+--- Helper function to get all of the key pickup entities in the room.
+-- 
+-- @param keySubType Optional. If specified, will only get the keys that match the sub-type. Default
+-- is -1, which matches every sub-type.
+function ____exports.getKeys(self, keySubType)
+    if keySubType == nil then
+        keySubType = -1
+    end
+    return getPickups(nil, PickupVariant.KEY, keySubType)
+end
+--- Helper function to get all of the pill entities in the room.
+-- 
+-- @param pillColor Optional. If specified, will only get the pills that match the sub-type. Default
+-- is -1, which matches every sub-type.
+function ____exports.getPills(self, pillColor)
+    if pillColor == nil then
+        pillColor = -1
+    end
+    return getPickups(nil, PickupVariant.PILL, pillColor)
+end
+--- Helper function to get all of the sack (i.e. grab bag) entities in the room.
+-- 
+-- @param sackSubType Optional. If specified, will only get the sacks that match the sub-type.
+-- Default is -1, which matches every sub-type.
+function ____exports.getSacks(self, sackSubType)
+    if sackSubType == nil then
+        sackSubType = -1
+    end
+    return getPickups(nil, PickupVariant.SACK, sackSubType)
+end
+--- Helper function to get all of the trinket entities in the room.
+-- 
+-- @param trinketType Optional. If specified, will only get the trinkets that match the sub-type.
+-- Default is -1, which matches every sub-type.
+function ____exports.getTrinkets(self, trinketType)
+    if trinketType == nil then
+        trinketType = -1
+    end
+    return getPickups(nil, PickupVariant.TRINKET, trinketType)
+end
+--- Helper function to remove all of the batteries in the room.
+-- 
+-- @param batterySubType Optional. If specified, will only remove the batteries that match this
+-- sub-type. Default is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of cards.
+-- @returns The batteries that were removed.
+function ____exports.removeAllBatteries(self, batterySubType, cap)
+    if batterySubType == nil then
+        batterySubType = -1
+    end
+    return removeAllPickups(nil, PickupVariant.LIL_BATTERY, batterySubType, cap)
+end
+--- Helper function to remove all of the bomb pickups in the room. (Specifically, this refers to bomb
+-- pickups, not the `EntityBomb` class.)
+-- 
+-- @param bombSubType Optional. If specified, will only remove bombs that match this sub-type.
+-- Default is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of bombs.
+-- @returns The bombs that were removed.
+function ____exports.removeAllBombPickups(self, bombSubType, cap)
+    if bombSubType == nil then
+        bombSubType = -1
+    end
+    return removeAllPickups(nil, PickupVariant.BOMB, bombSubType, cap)
+end
+--- Helper function to remove all of the cards in the room.
+-- 
+-- @param cardType Optional. If specified, will only remove cards that match this sub-type. Default
+-- is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of cards.
+-- @returns The cards that were removed.
+function ____exports.removeAllCards(self, cardType, cap)
+    if cardType == nil then
+        cardType = -1
+    end
+    return removeAllPickups(nil, PickupVariant.TAROT_CARD, cardType, cap)
+end
+--- Helper function to remove all of the coins in the room.
+-- 
+-- @param coinSubType Optional. If specified, will only remove coins that match this sub-type.
+-- Default is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of coins.
+-- @returns The coins that were removed.
+function ____exports.removeAllCoins(self, coinSubType, cap)
+    return removeAllPickups(nil, PickupVariant.COIN, coinSubType, cap)
+end
+--- Helper function to remove all of the collectibles in the room.
+-- 
+-- @param collectibleType Optional. If specified, will only remove collectibles that match this
+-- sub-type. Default is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of collectibles.
+-- @returns The collectibles that were removed.
+function ____exports.removeAllCollectibles(self, collectibleType, cap)
+    return removeAllPickups(nil, PickupVariant.COLLECTIBLE, collectibleType, cap)
+end
+--- Helper function to remove all of the heart pickup entities in the room.
+-- 
+-- @param heartSubType Optional. If specified, will only remove hearts that match this sub-type.
+-- Default is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of hearts.
+-- @returns The hearts that were removed.
+function ____exports.removeAllHearts(self, heartSubType, cap)
+    return removeAllPickups(nil, PickupVariant.HEART, heartSubType, cap)
+end
+--- Helper function to remove all of the keys in the room.
+-- 
+-- @param keySubType Optional. If specified, will only remove keys that match this sub-type. Default
+-- is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of keys.
+-- @returns The keys that were removed.
+function ____exports.removeAllKeys(self, keySubType, cap)
+    return removeAllPickups(nil, PickupVariant.KEY, keySubType, cap)
+end
+--- Helper function to remove all of the pills in the room.
+-- 
+-- @param pillColor Optional. If specified, will only remove pills that match this sub-type. Default
+-- is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of pills.
+-- @returns The pills that were removed.
+function ____exports.removeAllPills(self, pillColor, cap)
+    return removeAllPickups(nil, PickupVariant.PILL, pillColor, cap)
+end
+--- Helper function to remove all of the sacks (i.e. grab bags) in the room.
+-- 
+-- @param sackSubType Optional. If specified, will only remove sacks that match this sub-type.
+-- Default is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of sacks.
+-- @returns The sacks that were removed.
+function ____exports.removeAllSacks(self, sackSubType, cap)
+    return removeAllPickups(nil, PickupVariant.TRINKET, sackSubType, cap)
+end
+--- Helper function to remove all of the trinkets in the room.
+-- 
+-- @param trinketType Optional. If specified, will only remove trinkets that match this sub-type.
+-- Default is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of trinkets.
+-- @returns The trinkets that were removed.
+function ____exports.removeAllTrinkets(self, trinketType, cap)
+    return removeAllPickups(nil, PickupVariant.TRINKET, trinketType, cap)
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.LIL_BATTERY` (90).
+function ____exports.spawnBattery(self, batterySubType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.LIL_BATTERY,
+        batterySubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.LIL_BATTERY` (90)
+-- and a specific seed.
+function ____exports.spawnBatteryWithSeed(self, batterySubType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnBattery(
+        nil,
+        batterySubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.BOMB` (40).
+function ____exports.spawnBombPickup(self, bombSubType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.BOMB,
+        bombSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.BOMB` (40) and a
+-- specific seed.
+function ____exports.spawnBombPickupWithSeed(self, bombSubType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnBombPickup(
+        nil,
+        bombSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TAROT_CARD` (300).
+function ____exports.spawnCard(self, cardType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.TAROT_CARD,
+        cardType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TAROT_CARD` (300)
+-- and a specific seed.
+function ____exports.spawnCardWithSeed(self, cardType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnCard(
+        nil,
+        cardType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.COIN` (20).
+function ____exports.spawnCoin(self, coinSubType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.COIN,
+        coinSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.COIN` (20) and a
+-- specific seed.
+function ____exports.spawnCoinWithSeed(self, coinSubType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnCoin(
+        nil,
+        coinSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.HEART` (10).
+function ____exports.spawnHeart(self, heartSubType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.HEART,
+        heartSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+function ____exports.spawnHeartWithSeed(self, heartSubType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnHeart(
+        nil,
+        heartSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.KEY` (30).
+function ____exports.spawnKey(self, keySubType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.KEY,
+        keySubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.KEY` (30) and a
+-- specific seed.
+function ____exports.spawnKeyWithSeed(self, keySubType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnKey(
+        nil,
+        keySubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.PILL` (70).
+function ____exports.spawnPill(self, pillColor, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.PILL,
+        pillColor,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.PILL` (70) and a
+-- specific seed.
+function ____exports.spawnPillWithSeed(self, pillColor, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnPill(
+        nil,
+        pillColor,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.SACK` (69).
+function ____exports.spawnSack(self, sackSubType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.SACK,
+        sackSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.SACK` (69) and a
+-- specific seed.
+function ____exports.spawnSackWithSeed(self, sackSubType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnSack(
+        nil,
+        sackSubType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TRINKET` (350).
+function ____exports.spawnTrinket(self, trinketType, position, velocity, spawner, seedOrRNG)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = nil
+    end
+    return spawnPickup(
+        nil,
+        PickupVariant.TRINKET,
+        trinketType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+--- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TRINKET` (350) and
+-- a specific seed.
+function ____exports.spawnTrinketWithSeed(self, trinketType, position, seedOrRNG, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnTrinket(
+        nil,
+        trinketType,
+        position,
+        velocity,
+        spawner,
+        seedOrRNG
+    )
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"pills.d.ts","sourceRoot":"","sources":["../../../src/functions/pills.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,SAAS,EACT,UAAU,EACX,MAAM,8BAA8B,CAAC;AAqCtC;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAI9C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAEjE;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,SAAS,EAAE,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAM3E;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,SAAS,EAAE,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAGnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,GACrB,yBAAyB,CAS3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAgBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GACrB,wBAAwB,CAS1B;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,IAAI,UAAU,EAAE,CAEpD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAElE;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEnE"}

package/dist/src/functions/pills.lua

@@ -0,0 +1,136 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArraySlice = ____lualib.__TS__ArraySlice
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PillColor = ____isaac_2Dtypescript_2Ddefinitions.PillColor
+local ____cachedClasses = require("src.core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____constantsFirstLast = require("src.core.constantsFirstLast")
+local FIRST_HORSE_PILL_COLOR = ____constantsFirstLast.FIRST_HORSE_PILL_COLOR
+local FIRST_PILL_COLOR = ____constantsFirstLast.FIRST_PILL_COLOR
+local FIRST_PILL_EFFECT = ____constantsFirstLast.FIRST_PILL_EFFECT
+local LAST_HORSE_PILL_COLOR = ____constantsFirstLast.LAST_HORSE_PILL_COLOR
+local LAST_NORMAL_PILL_COLOR = ____constantsFirstLast.LAST_NORMAL_PILL_COLOR
+local LAST_VANILLA_PILL_EFFECT = ____constantsFirstLast.LAST_VANILLA_PILL_EFFECT
+local ____falsePHDPillConversions = require("src.maps.falsePHDPillConversions")
+local FALSE_PHD_PILL_CONVERSIONS = ____falsePHDPillConversions.FALSE_PHD_PILL_CONVERSIONS
+local ____PHDPillConversions = require("src.maps.PHDPillConversions")
+local PHD_PILL_CONVERSIONS = ____PHDPillConversions.PHD_PILL_CONVERSIONS
+local ____pillEffectClasses = require("src.objects.pillEffectClasses")
+local DEFAULT_PILL_EFFECT_CLASS = ____pillEffectClasses.DEFAULT_PILL_EFFECT_CLASS
+local PILL_EFFECT_CLASSES = ____pillEffectClasses.PILL_EFFECT_CLASSES
+local ____pillEffectNames = require("src.objects.pillEffectNames")
+local DEFAULT_PILL_EFFECT_NAME = ____pillEffectNames.DEFAULT_PILL_EFFECT_NAME
+local PILL_EFFECT_NAMES = ____pillEffectNames.PILL_EFFECT_NAMES
+local ____pillEffectTypes = require("src.objects.pillEffectTypes")
+local DEFAULT_PILL_EFFECT_TYPE = ____pillEffectTypes.DEFAULT_PILL_EFFECT_TYPE
+local PILL_EFFECT_TYPES = ____pillEffectTypes.PILL_EFFECT_TYPES
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____types = require("src.functions.types")
+local asNumber = ____types.asNumber
+local asPillColor = ____types.asPillColor
+local ____utils = require("src.functions.utils")
+local irange = ____utils.irange
+function ____exports.isVanillaPillEffect(self, pillEffect)
+    return pillEffect <= LAST_VANILLA_PILL_EFFECT
+end
+--- Add this to a `PillColor` to get the corresponding giant pill color.
+-- 
+-- Corresponds to the vanilla `PillColor.GIANT_FLAG` value.
+-- 
+-- 1 << 11
+local HORSE_PILL_ADJUSTMENT = 2048
+--- Helper function to get an array with every non-null pill color. This includes all gold colors and
+-- all horse colors.
+function ____exports.getAllPillColors(self)
+    local pillColors = getEnumValues(nil, PillColor)
+    __TS__ArraySlice(pillColors)
+    return pillColors
+end
+--- Helper function to get the associated pill effect after False PHD is acquired. If a pill effect
+-- is not altered by False PHD, then the same pill effect will be returned.
+function ____exports.getFalsePHDPillEffect(self, pillEffect)
+    local convertedPillEffect = FALSE_PHD_PILL_CONVERSIONS:get(pillEffect)
+    return convertedPillEffect == nil and pillEffect or convertedPillEffect
+end
+--- Helper function to get the corresponding horse pill color from a normal pill color.
+-- 
+-- For example, passing `PillColor.BLUE_BLUE` would result in 2049, which is the value that
+-- corresponds to the horse pill color for blue/blue.
+function ____exports.getHorsePillColor(self, pillColor)
+    return asNumber(nil, pillColor) + HORSE_PILL_ADJUSTMENT
+end
+--- Helper function to get an array with every non-gold horse pill color.
+function ____exports.getHorsePillColors(self)
+    return irange(nil, FIRST_HORSE_PILL_COLOR, LAST_HORSE_PILL_COLOR)
+end
+--- Helper function to get the corresponding normal pill color from a horse pill color.
+-- 
+-- For example, passing 2049 would result in `PillColor.BLUE_BLUE`.
+-- 
+-- If called with a non-horse pill color, this function will return back the same color.
+function ____exports.getNormalPillColorFromHorse(self, pillColor)
+    local normalPillColor = asPillColor(
+        nil,
+        asNumber(nil, pillColor) - HORSE_PILL_ADJUSTMENT
+    )
+    return normalPillColor > PillColor.NULL and normalPillColor or pillColor
+end
+--- Helper function to get an array with every non-gold and non-horse pill color.
+function ____exports.getNormalPillColors(self)
+    return irange(nil, FIRST_PILL_COLOR, LAST_NORMAL_PILL_COLOR)
+end
+--- Helper function to get the associated pill effect after PHD is acquired. If a pill effect is not
+-- altered by PHD, then the same pill effect will be returned.
+function ____exports.getPHDPillEffect(self, pillEffect)
+    local convertedPillEffect = PHD_PILL_CONVERSIONS:get(pillEffect)
+    return convertedPillEffect == nil and pillEffect or convertedPillEffect
+end
+--- Helper function to get a pill effect class from a PillEffect enum value. In this context, the
+-- class is equal to the numerical prefix in the "class" tag in the "pocketitems.xml" file. Use the
+-- `getPillEffectType` helper function to determine whether or not the pill effect is positive,
+-- negative, or neutral.
+-- 
+-- Due to limitations in the API, this function will not work properly for modded pill effects, and
+-- will always return `DEFAULT_PILL_EFFECT_CLASS` in those cases.
+function ____exports.getPillEffectClass(self, pillEffect)
+    local pillEffectClass = PILL_EFFECT_CLASSES[pillEffect]
+    return pillEffectClass == nil and DEFAULT_PILL_EFFECT_CLASS or pillEffectClass
+end
+--- Helper function to get a pill effect name from a PillEffect enum value.
+-- 
+-- For example, `getPillEffectName(PillEffect.BAD_GAS)` would return "Bad Gas".
+function ____exports.getPillEffectName(self, pillEffect)
+    local pillEffectName = PILL_EFFECT_NAMES[pillEffect]
+    if pillEffectName ~= nil then
+        return pillEffectName
+    end
+    local itemConfigPillEffect = itemConfig:GetPillEffect(pillEffect)
+    if itemConfigPillEffect ~= nil then
+        return itemConfigPillEffect.Name
+    end
+    return DEFAULT_PILL_EFFECT_NAME
+end
+--- Helper function to get a pill effect type from a PillEffect enum value. In this context, the type
+-- is equal to positive, negative, or neutral. This is derived from the suffix of the the "class"
+-- tag in the "pocketitems.xml" file. Use the `getPillEffectClass` helper function to determine the
+-- "power" of the pill.
+-- 
+-- Due to limitations in the API, this function will not work properly for modded pill effects, and
+-- will always return `DEFAULT_PILL_EFFECT_TYPE` in those cases.
+function ____exports.getPillEffectType(self, pillEffect)
+    local pillEffectClass = PILL_EFFECT_TYPES[pillEffect]
+    return pillEffectClass == nil and DEFAULT_PILL_EFFECT_TYPE or pillEffectClass
+end
+--- Helper function to get an array with every vanilla pill effect.
+function ____exports.getVanillaPillEffects(self)
+    return irange(nil, FIRST_PILL_EFFECT, LAST_VANILLA_PILL_EFFECT)
+end
+function ____exports.isHorsePill(self, pillColor)
+    return asNumber(nil, pillColor) > HORSE_PILL_ADJUSTMENT
+end
+function ____exports.isModdedPillEffect(self, pillEffect)
+    return not ____exports.isVanillaPillEffect(nil, pillEffect)
+end
+return ____exports