isaacscript-common 6.6.0 → 6.6.1-dev.2

package/functions/pickups.js

@@ -0,0 +1,219 @@
+import { PickupVariant, } from "isaac-typescript-definitions";
+import { VectorZero } from "../constants";
+import { COIN_SUBTYPE_TO_VALUE, DEFAULT_COIN_VALUE, } from "../objects/coinSubTypeToValue";
+import { CHEST_PICKUP_VARIANTS } from "../sets/chestPickupVariantsSet";
+import { RED_HEART_SUB_TYPES_SET } from "../sets/redHeartSubTypesSet";
+import { getPickups, removeAllPickups, spawnPickup } from "./entitySpecific";
+import { isHeart } from "./pickupVariants";
+/** Helper function to get all of the battery entities in the room. */
+export function getBatteries(matchingSubType = -1) {
+    return getPickups(PickupVariant.LIL_BATTERY, matchingSubType);
+}
+/** Helper function to get all of the card entities in the room. */
+export function getCards(matchingSubType = -1) {
+    return getPickups(PickupVariant.TAROT_CARD, matchingSubType);
+}
+/**
+ * Helper function to get the corresponding coin amount from a `CoinSubType`. Returns 1 for modded
+ * sub-types.
+ */
+export function getCoinValue(coinSubType) {
+    const value = COIN_SUBTYPE_TO_VALUE[coinSubType];
+    // Handle modded coin sub-types.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    return value === undefined ? DEFAULT_COIN_VALUE : value;
+}
+/** Helper function to get all of the coin pickup entities in the room. */
+export function getCoins(matchingSubType = -1) {
+    return getPickups(PickupVariant.COIN, matchingSubType);
+}
+/** Helper function to get all of the collectible entities in the room. */
+export function getCollectibles(matchingSubType = -1) {
+    return getPickups(PickupVariant.COLLECTIBLE, matchingSubType);
+}
+/** Helper function to get all of the heart pickup entities in the room. */
+export function getHearts(matchingSubType = -1) {
+    return getPickups(PickupVariant.HEART, matchingSubType);
+}
+/** Helper function to get all of the key pickup entities in the room. */
+export function getKeys(matchingSubType = -1) {
+    return getPickups(PickupVariant.KEY, matchingSubType);
+}
+/** Helper function to get all of the pill entities in the room. */
+export function getPills(matchingSubType = -1) {
+    return getPickups(PickupVariant.PILL, matchingSubType);
+}
+/** Helper function to get all of the red heart pickup entities in the room. */
+export function getRedHearts() {
+    const hearts = getHearts();
+    return hearts.filter((heart) => RED_HEART_SUB_TYPES_SET.has(heart.SubType));
+}
+/** Helper function to get all of the sack (i.e. grab bag) entities in the room. */
+export function getSacks(matchingSubType = -1) {
+    return getPickups(PickupVariant.SACK, matchingSubType);
+}
+/** Helper function to get all of the trinket entities in the room. */
+export function getTrinkets(matchingSubType = -1) {
+    return getPickups(PickupVariant.TRINKET, matchingSubType);
+}
+export function isChest(pickup) {
+    return CHEST_PICKUP_VARIANTS.has(pickup.Variant);
+}
+export function isRedHeart(pickup) {
+    return isHeart(pickup) && RED_HEART_SUB_TYPES_SET.has(pickup.SubType);
+}
+/**
+ * Helper function to remove all of the batteries in the room.
+ *
+ * @param batterySubType Optional. If specified, will only remove cards that match this sub-type.
+ * @param cap Optional. If specified, will only remove the given amount of cards.
+ * @returns True if one or more cards were removed, false otherwise.
+ */
+export function removeAllBatteries(batterySubType, cap) {
+    return removeAllPickups(PickupVariant.LIL_BATTERY, batterySubType, cap);
+}
+/**
+ * Helper function to remove all of the cards in the room.
+ *
+ * @param card Optional. If specified, will only remove cards that match this sub-type.
+ * @param cap Optional. If specified, will only remove the given amount of cards.
+ * @returns True if one or more cards were removed, false otherwise.
+ */
+export function removeAllCards(card, cap) {
+    return removeAllPickups(PickupVariant.TAROT_CARD, card, cap);
+}
+/**
+ * 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.
+ * @param cap Optional. If specified, will only remove the given amount of coins.
+ * @returns True if one or more coins were removed, false otherwise.
+ */
+export function removeAllCoins(coinSubType, cap) {
+    return removeAllPickups(PickupVariant.COIN, coinSubType, cap);
+}
+/**
+ * Helper function to remove all of the collectibles in the room.
+ *
+ * @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 were removed, false otherwise.
+ */
+export function removeAllCollectibles(collectibleType, cap) {
+    return removeAllPickups(PickupVariant.COLLECTIBLE, collectibleType, cap);
+}
+/**
+ * Helper function to remove all of the hearts in the room.
+ *
+ * @param heartSubType Optional. If specified, will only remove hearts that match this sub-type.
+ * @param cap Optional. If specified, will only remove the given amount of hearts.
+ * @returns True if one or more hearts were removed, false otherwise.
+ */
+export function removeAllHearts(heartSubType, cap) {
+    return removeAllPickups(PickupVariant.HEART, heartSubType, cap);
+}
+/**
+ * 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.
+ * @param cap Optional. If specified, will only remove the given amount of keys.
+ * @returns True if one or more keys were removed, false otherwise.
+ */
+export function removeAllKeys(keySubType, cap) {
+    return removeAllPickups(PickupVariant.KEY, keySubType, cap);
+}
+/**
+ * Helper function to remove all of the pills in the room.
+ *
+ * @param pillColor Optional. If specified, will only remove pills that match this color.
+ * @param cap Optional. If specified, will only remove the given amount of pills.
+ * @returns True if one or more pills were removed, false otherwise.
+ */
+export function removeAllPills(pillColor, cap) {
+    return removeAllPickups(PickupVariant.PILL, pillColor, cap);
+}
+/**
+ * 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.
+ * @param cap Optional. If specified, will only remove the given amount of trinkets.
+ * @returns True if one or more trinkets were removed, false otherwise.
+ */
+export function removeAllSacks(sackSubType, cap) {
+    return removeAllPickups(PickupVariant.TRINKET, sackSubType, cap);
+}
+/**
+ * Helper function to remove all of the trinkets in the room.
+ *
+ * @param trinketType Optional. If specified, will only remove trinkets that match this trinket
+ *                    type.
+ * @param cap Optional. If specified, will only remove the given amount of trinkets.
+ * @returns True if one or more trinkets were removed, false otherwise.
+ */
+export function removeAllTrinkets(trinketType, cap) {
+    return removeAllPickups(PickupVariant.TRINKET, trinketType, cap);
+}
+/**
+ * Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.LIL_BATTERY` (90).
+ */
+export function spawnBattery(subType, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.LIL_BATTERY, subType, position, velocity, spawner, seedOrRNG);
+}
+export function spawnBatteryWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnBattery(subType, position, velocity, spawner, seedOrRNG);
+}
+/**
+ * Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TAROT_CARD` (300).
+ */
+export function spawnCard(subType, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.TAROT_CARD, subType, position, velocity, spawner, seedOrRNG);
+}
+export function spawnCardWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnCard(subType, position, velocity, spawner, seedOrRNG);
+}
+/** Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.COIN` (20). */
+export function spawnCoin(subType, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.COIN, subType, position, velocity, spawner, seedOrRNG);
+}
+export function spawnCoinWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnCoin(subType, position, velocity, spawner, seedOrRNG);
+}
+/** Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.HEART` (10). */
+export function spawnHeart(subType, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.HEART, subType, position, velocity, spawner, seedOrRNG);
+}
+export function spawnHeartWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnHeart(subType, position, velocity, spawner, seedOrRNG);
+}
+/** Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.KEY` (30). */
+export function spawnKey(subType, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.KEY, subType, position, velocity, spawner, seedOrRNG);
+}
+export function spawnKeyWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnKey(subType, position, velocity, spawner, seedOrRNG);
+}
+/** Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.PILL` (70). */
+export function spawnPill(pillColor, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.PILL, pillColor, position, velocity, spawner, seedOrRNG);
+}
+export function spawnPillWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnPill(subType, position, velocity, spawner, seedOrRNG);
+}
+/** Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.SACK` (69). */
+export function spawnSack(subType, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.SACK, subType, position, velocity, spawner, seedOrRNG);
+}
+export function spawnSackWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnSack(subType, position, velocity, spawner, seedOrRNG);
+}
+/**
+ * Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TRINKET` (350).
+ */
+export function spawnTrinket(subType, position, velocity = VectorZero, spawner = undefined, seedOrRNG = undefined) {
+    return spawnPickup(PickupVariant.TRINKET, subType, position, velocity, spawner, seedOrRNG);
+}
+export function spawnTrinketWithSeed(subType, position, seedOrRNG, velocity = VectorZero, spawner = undefined) {
+    return spawnTrinket(subType, position, velocity, spawner, seedOrRNG);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGlja3Vwcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3BpY2t1cHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQU9MLGFBQWEsR0FJZCxNQUFNLDhCQUE4QixDQUFDO0FBQ3RDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDMUMsT0FBTyxFQUNMLHFCQUFxQixFQUNyQixrQkFBa0IsR0FDbkIsTUFBTSwrQkFBK0IsQ0FBQztBQUN2QyxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN2RSxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUN0RSxPQUFPLEVBQUUsVUFBVSxFQUFFLGdCQUFnQixFQUFFLFdBQVcsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQzdFLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUUzQyxzRUFBc0U7QUFDdEUsTUFBTSxVQUFVLFlBQVksQ0FDMUIsa0JBQXVDLENBQUMsQ0FBQztJQUV6QyxPQUFPLFVBQVUsQ0FDZixhQUFhLENBQUMsV0FBVyxFQUN6QixlQUFlLENBQ1MsQ0FBQztBQUM3QixDQUFDO0FBRUQsbUVBQW1FO0FBQ25FLE1BQU0sVUFBVSxRQUFRLENBQUMsa0JBQTZCLENBQUMsQ0FBQztJQUN0RCxPQUFPLFVBQVUsQ0FDZixhQUFhLENBQUMsVUFBVSxFQUN4QixlQUFlLENBQ00sQ0FBQztBQUMxQixDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLFlBQVksQ0FBQyxXQUF3QjtJQUNuRCxNQUFNLEtBQUssR0FBRyxxQkFBcUIsQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUNqRCxnQ0FBZ0M7SUFDaEMsdUVBQXVFO0lBQ3ZFLE9BQU8sS0FBSyxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsa0JB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

package/functions/pickups.lua

@@ -472,3 +472,5 @@ function ____exports.spawnTrinketWithSeed(self, subType, position, seedOrRNG, ve
     )
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3BpY2t1cHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsNkNBV087QUFKTDtBQUtGLHNCQUEyQjtBQUFsQjtBQUNULCtCQUdPO0FBRkw7QUFDQTtBQUVGLG1DQUFzQztBQUE3QjtBQUNULGdDQUF3QztBQUEvQjtBQUNULDJCQUEwRDtBQUFqRDtBQUFZO0FBQWtCO0FBQ3ZDLDJCQUF3QjtBQUFmOztBQUdULHdDQUNFO09BQUE7UUFBQSxtQkFBd0M7O0FBRXhDLFdBQU8sZ0JBQ0wsMkJBQ0E7QUFMSjs7QUFVQSxvQ0FBeUI7T0FBQTtRQUFBLG1CQUE4Qjs7QUFDckQsV0FBTyxnQkFDTCwwQkFDQTtBQUhKOzs7QUFXQSx3Q0FBNkI7QUFDckIsa0JBQVEsc0JBQXNCO0FBR3BDLFdBQU8saUJBQXNCLHNCQUFxQjtBQUpwRDs7QUFRQSxvQ0FDRTtPQUFBO1FBQUEsbUJBQXFDOztBQUVyQyxXQUFPLGdCQUFXLG9CQUFvQjtBQUh4Qzs7QUFPQSwyQ0FDRTtPQUFBO1FBQUEsbUJBQXlDOztBQUV6QyxXQUFPLGdCQUNMLDJCQUNBO0FBTEo7O0FBVUEscUNBQ0U7T0FBQTtRQUFBLG1CQUFzQzs7QUFFdEMsV0FBTyxnQkFDTCxxQkFDQTtBQUxKOztBQVVBLG1DQUNFO09BQUE7UUFBQSxtQkFBb0M7O0FBRXBDLFdBQU8sZ0JBQVcsbUJBQW1CO0FBSHZDOztBQU9BLG9DQUNFO09BQUE7UUFBQSxtQkFBbUM7O0FBRW5DLFdBQU8sZ0JBQVcsb0JBQW9CO0FBSHhDOztBQU9BO0FBQ1EsbUJBQVM7QUFDZixXQUFPO1FBQUE7UUFBYyxlQUFDLE9BQVUsK0JBQXdCLElBQUksY0FBdkM7O0FBRnZCOztBQU1BLG9DQUNFO09BQUE7UUFBQSxtQkFBcUM7O0FBRXJDLFdBQU8sZ0JBQVcsb0JBQW9CO0FBSHhDOztBQU9BLHVDQUNFO09BQUE7UUFBQSxtQkFBcUM7O0FBRXJD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

package/functions/pills.js

@@ -0,0 +1,160 @@
+import { PillColor, } from "isaac-typescript-definitions";
+import { itemConfig } from "../cachedClasses";
+import { FIRST_HORSE_PILL_COLOR, FIRST_MODDED_PILL_EFFECT, FIRST_PILL_COLOR, FIRST_PILL_EFFECT, LAST_HORSE_PILL_COLOR, LAST_NORMAL_PILL_COLOR, LAST_PILL_EFFECT, LAST_VANILLA_PILL_EFFECT, } from "../constantsFirstLast";
+import { FALSE_PHD_PILL_CONVERSIONS } from "../maps/falsePHDPillConversions";
+import { PHD_PILL_CONVERSIONS } from "../maps/PHDPillConversions";
+import { DEFAULT_PILL_EFFECT_CLASS, PILL_EFFECT_CLASSES, } from "../objects/pillEffectClasses";
+import { DEFAULT_PILL_EFFECT_NAME, PILL_EFFECT_NAMES, } from "../objects/pillEffectNames";
+import { DEFAULT_PILL_EFFECT_TYPE, PILL_EFFECT_TYPES, } from "../objects/pillEffectTypes";
+import { getEnumValues } from "./enums";
+import { irange } from "./utils";
+/**
+ * Add this to a `PillColor` to get the corresponding giant pill color.
+ *
+ * Corresponds to the vanilla `PillColor.GIANT_FLAG` value.
+ *
+ * 1 << 11
+ */
+const 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.
+ */
+export function getAllPillColors() {
+    const pillColors = getEnumValues(PillColor);
+    pillColors.slice(); // Remove `PillColor.NULL`
+    return pillColors;
+}
+/**
+ * Helper function to get an array with every valid pill effect. This includes modded pill effects.
+ */
+export function getAllPillEffects() {
+    return irange(FIRST_PILL_EFFECT, LAST_PILL_EFFECT);
+}
+/**
+ * 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.
+ */
+export function getFalsePHDPillEffect(pillEffect) {
+    const convertedPillEffect = FALSE_PHD_PILL_CONVERSIONS.get(pillEffect);
+    return convertedPillEffect === undefined ? pillEffect : convertedPillEffect;
+}
+/**
+ * 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.
+ */
+export function getHorsePillColor(pillColor) {
+    return pillColor + HORSE_PILL_ADJUSTMENT; // eslint-disable-line isaacscript/strict-enums
+}
+/** Helper function to get an array with every non-gold horse pill color. */
+export function getHorsePillColors() {
+    return irange(FIRST_HORSE_PILL_COLOR, LAST_HORSE_PILL_COLOR);
+}
+/**
+ * Helper function to get an array with every modded pill effect.
+ *
+ * Returns an empty array if there are no modded pill effects.
+ */
+export function getModdedPillEffects() {
+    if (LAST_VANILLA_PILL_EFFECT === LAST_PILL_EFFECT) {
+        return [];
+    }
+    return irange(FIRST_MODDED_PILL_EFFECT, LAST_PILL_EFFECT);
+}
+/**
+ * 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.
+ */
+export function getNormalPillColorFromHorse(pillColor) {
+    // eslint-disable-next-line isaacscript/strict-enums
+    const normalPillColor = (pillColor - HORSE_PILL_ADJUSTMENT);
+    return normalPillColor > PillColor.NULL ? normalPillColor : pillColor;
+}
+/** Helper function to get an array with every non-gold and non-horse pill color. */
+export function getNormalPillColors() {
+    return irange(FIRST_PILL_COLOR, LAST_NORMAL_PILL_COLOR);
+}
+/**
+ * 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.
+ */
+export function getPHDPillEffect(pillEffect) {
+    const convertedPillEffect = PHD_PILL_CONVERSIONS.get(pillEffect);
+    return convertedPillEffect === undefined ? pillEffect : convertedPillEffect;
+}
+/**
+ * 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.
+ */
+export function getPillEffectClass(pillEffect) {
+    // `ItemConfigPillEffect` does not contain the "class" tag, so we must manually compile a map of
+    // pill effect classes. Modded pill effects are not included in the map.
+    const pillEffectClass = PILL_EFFECT_CLASSES[pillEffect];
+    // Handle modded pill effects.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    return pillEffectClass === undefined
+        ? DEFAULT_PILL_EFFECT_CLASS
+        : pillEffectClass;
+}
+/**
+ * Helper function to get a pill effect name from a PillEffect enum value.
+ *
+ * For example:
+ *
+ * ```ts
+ * const pillEffect = PillEffect.BAD_GAS;
+ * const pillEffectName = getPillEffectName(pillEffect); // trinketName is "Bad Gas"
+ * ```
+ */
+export function getPillEffectName(pillEffect) {
+    // `ItemConfigPillEffect.Name` is bugged with vanilla pill effects on patch v1.7.6, so we use a
+    // hard-coded map as a workaround.
+    const pillEffectName = PILL_EFFECT_NAMES[pillEffect];
+    // Handle modded pill effects.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (pillEffectName !== undefined) {
+        return pillEffectName;
+    }
+    const itemConfigPillEffect = itemConfig.GetPillEffect(pillEffect);
+    if (itemConfigPillEffect !== undefined) {
+        return itemConfigPillEffect.Name;
+    }
+    return DEFAULT_PILL_EFFECT_NAME;
+}
+/**
+ * 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.
+ */
+export function getPillEffectType(pillEffect) {
+    // `ItemConfigPillEffect` does not contain the "class" tag, so we must manually compile a map of
+    // pill effect classes. Modded pill effects are not included in the map.
+    const pillEffectClass = PILL_EFFECT_TYPES[pillEffect];
+    // Handle modded pill effects.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    return pillEffectClass === undefined
+        ? DEFAULT_PILL_EFFECT_TYPE
+        : pillEffectClass;
+}
+/** Helper function to get an array with every vanilla pill effect. */
+export function getVanillaPillEffects() {
+    return irange(FIRST_PILL_EFFECT, LAST_VANILLA_PILL_EFFECT);
+}
+export function isHorsePill(pillColor) {
+    return pillColor > HORSE_PILL_ADJUSTMENT;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGlsbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9waWxscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBR0wsU0FBUyxHQUVWLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQzlDLE9BQU8sRUFDTCxzQkFBc0IsRUFDdEIsd0JBQXdCLEVBQ3hCLGdCQUFnQixFQUNoQixpQkFBaUIsRUFDakIscUJBQXFCLEVBQ3JCLHNCQUFzQixFQUN0QixnQkFBZ0IsRUFDaEIsd0JBQXdCLEdBQ3pCLE1BQU0sdUJBQXVCLENBQUM7QUFDL0IsT0FBTyxFQUFFLDBCQUEwQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDN0UsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDbEUsT0FBTyxFQUNMLHlCQUF5QixFQUN6QixtQkFBbUIsR0FDcEIsTUFBTSw4QkFBOEIsQ0FBQztBQUN0QyxPQUFPLEVBQ0wsd0JBQXdCLEVBQ3hCLGlCQUFpQixHQUNsQixNQUFNLDRCQUE0QixDQUFDO0FBQ3BDLE9BQU8sRUFDTCx3QkFBd0IsRUFDeEIsaUJBQWlCLEdBQ2xCLE1BQU0sNEJBQTRCLENBQUM7QUFDcEMsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUN4QyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBRWpDOzs7Ozs7R0FNRztBQUNILE1BQU0scUJBQXFCLEdBQUcsSUFBSSxDQUFDO0FBRW5DOzs7R0FHRztBQUNILE1BQU0sVUFBVSxnQkFBZ0I7SUFDOUIsTUFBTSxVQUFVLEdBQUcsYUFBYSxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzVDLFVBQVUsQ0FBQyxLQUFLLEVBQUUsQ0FBQyxDQUFDLDBCQUEwQjtJQUM5QyxPQUFP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

package/functions/pills.lua

@@ -142,3 +142,5 @@ function ____exports.isHorsePill(self, pillColor)
     return pillColor > HORSE_PILL_ADJUSTMENT
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3BpbGxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDZDQUtPO0FBRkw7QUFHRiwwQkFBMkI7QUFBbEI7QUFDVCwrQkFTTztBQVJMO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFFRixvQ0FBMkM7QUFBbEM7QUFDVCwrQkFBcUM7QUFBNUI7QUFDVCw4QkFHTztBQUZMO0FBQ0E7QUFFRiw0QkFHTztBQUZMO0FBQ0E7QUFFRiw0QkFHTztBQUZMO0FBQ0E7QUFFRixrQkFBOEI7QUFBckI7QUFDVCxrQkFBdUI7QUFBZDs7Ozs7O0FBU0gsOEJBQXdCOzs7QUFNOUI7QUFDUSx1QkFBYSxtQkFBYztJQUNqQztBQUNBLFdBQU87QUFIVDs7QUFTQTtBQUNFLFdBQU8sWUFBTyxtQkFBbUI7QUFEbkM7OztBQVFBLGlEQUFzQztBQUM5QixnQ0FBc0IsMkJBQTJCLElBQUk7QUFDM0QsV0FBTywrQkFBb0MsY0FBYTtBQUYxRDs7Ozs7QUFXQSw2Q0FBa0M7QUFDaEMsV0FBTyxZQUFZO0FBRHJCOztBQUtBO0FBQ0UsV0FBTyxZQUFPLHdCQUF3QjtBQUR4Qzs7OztBQVNBO09BQ00sNEJBQTZCO0FBQy9CLGVBQU87O0FBR1QsV0FBTyxZQUFPLDBCQUEwQjtBQUwxQzs7Ozs7O0FBZUEsdURBQTRDO0FBRXBDLDRCQUFtQixZQUFZO0FBRXJDLFdBQU8sa0JBQWtCLG1CQUFpQixtQkFBa0I7QUFKOUQ7O0FBUUE7QUFDRSxXQUFPLFlBQU8sa0JBQWtCO0FBRGxDOzs7QUFRQSw0Q0FBaUM7QUFDekIsZ0NBQXNCLHFCQUFxQixJQUFJO0FBQ3JELFdBQU8sK0JBQW9DLGNBQWE7QUFGMUQ7Ozs7Ozs7O0FBY0EsOENBQ0U7QUFJTSw0QkFBa0Isb0JBQW9CO0FBRzVDLFdBQU8sMkJBQ0gsNkJBQ0E7QUFWTjs7Ozs7Ozs7O0FBdUJBLDZDQUFrQztBQUcxQiwyQkFBaUIsa0JBQWtCO09BR3JDO0FBQ0YsZUFBTzs7QUFHSCxpQ0FBdUIsV0FBVyxjQUFjO09BQ2xEO0FBQ0YsZUFBTzs7QUFHVCxXQUFPO0FBZlQ7Ozs7Ozs7O0FBMkJBLDZDQUNFO0FBSU0sNEJBQWtCLGtCQUFrQjtBQUcxQyxXQUFPLDJCQUNILDRCQUNBO0FBVk47O0FBY0E7QUFDRSxXQUFPLFlBQU8sbUJBQW1CO0FBRG5DO0FBSUEsdUNBQTRCO0FBQzFCLFdBQU8sWUFBYTtBQUR0QiIsImZpbGUiOiJwaWxscy5sdWEiLCJzb3VyY2VSb290IjoiIn0=