isaacscript-common 6.6.1-dev.1 → 6.6.1-dev.2

package/functions/charge.js

@@ -0,0 +1,202 @@
+import { ActiveSlot, CollectibleType, SoundEffect, TrinketType, } from "isaac-typescript-definitions";
+import { game, sfxManager } from "../cachedClasses";
+import { getCollectibleMaxCharges } from "./collectibles";
+import { getPlayers } from "./playerIndex";
+import { getRoomShapeCharges } from "./roomShape";
+/**
+ * Helper function to add a charge to the player's active item. Will flash the HUD and play the
+ * appropriate sound effect, depending on whether the charge is partially full or completely full.
+ *
+ * If the player's active item is already fully charged, then this function will return 0 and not
+ * flash the HUD or play a sound effect.
+ *
+ * This function will take the following things into account:
+ * - The Battery
+ * - AAA Battery
+ *
+ * @param player The player to grant the charges to.
+ * @param activeSlot The slot to grant the charges to.
+ * @param numCharges Optional. The amount of charges to grant. Default is 1.
+ * @param playSoundEffect Optional. Whether to play a charge-related sound effect. Default is true.
+ * @returns The amount of charges that were actually granted. For example, if the active item was
+ *          only one away from a full charge, but the `numCharges` provided to this function was 2,
+ *          then this function would return 1.
+ */
+export function addCharge(player, activeSlot, numCharges = 1, playSoundEffect = true) {
+    const hud = game.GetHUD();
+    // Ensure that there is enough space on the active item to store these amount of charges.
+    const chargesToAdd = getClampedChargesToAdd(player, activeSlot, numCharges);
+    // The AAA Battery trinket might grant an additional charge.
+    const modifiedChargesToAdd = getChargesToAddWithAAAModifier(player, activeSlot, chargesToAdd);
+    const totalCharge = getTotalCharge(player, activeSlot);
+    const newCharge = totalCharge + modifiedChargesToAdd;
+    if (newCharge === totalCharge) {
+        return 0;
+    }
+    player.SetActiveCharge(newCharge, activeSlot);
+    hud.FlashChargeBar(player, activeSlot);
+    if (playSoundEffect) {
+        playChargeSoundEffect(player, activeSlot);
+    }
+    return modifiedChargesToAdd;
+}
+/**
+ * Helper function to add a charge to a player's active item(s), emulating what happens when a room
+ * is cleared.
+ *
+ * This function will take the following things into account:
+ * - 2x2 rooms and L rooms granting a double charge
+ * - The Battery
+ * - AAA Battery
+ *
+ * @param player The player to grant the charges to.
+ * @param bigRoomDoubleCharge Optional. If set to false, it will treat the current room as a 1x1
+ *                            room for the purposes of calculating how much charge to grant. Default
+ *                            is true.
+ * @param playSoundEffect Optional. Whether to play a charge-related sound effect. Default is true.
+ */
+export function addRoomClearCharge(player, bigRoomDoubleCharge = true, playSoundEffect = true) {
+    for (const activeSlot of [
+        ActiveSlot.PRIMARY,
+        ActiveSlot.SECONDARY,
+        ActiveSlot.POCKET,
+    ]) {
+        addRoomClearChargeToSlot(player, activeSlot, bigRoomDoubleCharge, playSoundEffect);
+    }
+}
+/**
+ * Helper function to add a charge to one of a player's active items, emulating what happens when a
+ * room is cleared.
+ *
+ * This function will take the following things into account:
+ * - L rooms and 2x2 rooms granting a double charge
+ * - The Battery
+ * - AAA Battery
+ *
+ * @param player The player to grant the charges to.
+ * @param activeSlot The active item slot to grant the charges to.
+ * @param bigRoomDoubleCharge Optional. If set to false, it will treat the current room as a 1x1
+ *                            room for the purposes of calculating how much charge to grant. Default
+ *                            is true.
+ * @param playSoundEffect Optional. Whether to play a charge-related sound effect. Default is true.
+ */
+export function addRoomClearChargeToSlot(player, activeSlot, bigRoomDoubleCharge = true, playSoundEffect = true) {
+    const room = game.GetRoom();
+    const roomShape = room.GetRoomShape();
+    const numCharges = bigRoomDoubleCharge ? getRoomShapeCharges(roomShape) : 1;
+    addCharge(player, activeSlot, numCharges, playSoundEffect);
+}
+/**
+ * We don't want to add more charges than is normally possible, so we must check to see if the
+ * player can hold the specified amount of charges in the given slot.
+ */
+function getClampedChargesToAdd(player, activeSlot, numCharges) {
+    const activeItem = player.GetActiveItem(activeSlot);
+    const activeCharge = player.GetActiveCharge(activeSlot);
+    const batteryCharge = player.GetBatteryCharge(activeSlot);
+    const hasBattery = player.HasCollectible(CollectibleType.BATTERY);
+    const maxCharges = getCollectibleMaxCharges(activeItem);
+    if (!hasBattery && activeCharge === maxCharges) {
+        return 0;
+    }
+    if (hasBattery && batteryCharge === maxCharges) {
+        return 0;
+    }
+    if (!hasBattery && activeCharge + 1 === maxCharges) {
+        // We are only 1 charge away from a full charge, so only add one charge to avoid an overcharge.
+        // (It is possible to set orange charges without the player actually having The Battery.)
+        return 1;
+    }
+    if (hasBattery && batteryCharge + 1 === maxCharges) {
+        // We are only 1 charge away from a full double-charge, so only add one charge to avoid an
+        // overcharge.
+        return 1;
+    }
+    return numCharges;
+}
+/**
+ * The AAA Battery should grant an extra charge when the active item is one away from being fully
+ * charged.
+ */
+function getChargesToAddWithAAAModifier(player, activeSlot, chargesToAdd) {
+    const activeItem = player.GetActiveItem(activeSlot);
+    const activeCharge = player.GetActiveCharge(activeSlot);
+    const batteryCharge = player.GetBatteryCharge(activeSlot);
+    const hasBattery = player.HasCollectible(CollectibleType.BATTERY);
+    const hasAAABattery = player.HasTrinket(TrinketType.AAA_BATTERY);
+    const maxCharges = getCollectibleMaxCharges(activeItem);
+    if (!hasAAABattery) {
+        return chargesToAdd;
+    }
+    if (!hasBattery && activeCharge + chargesToAdd === maxCharges - 1) {
+        return chargesToAdd + 1;
+    }
+    if (hasBattery && batteryCharge + chargesToAdd === maxCharges - 1) {
+        return chargesToAdd + 1;
+    }
+    return chargesToAdd;
+}
+/**
+ * Helper function to add a charge to every player's active item, emulating what happens when a room
+ * is cleared.
+ *
+ * This function will take the following things into account:
+ * - L rooms and 2x2 rooms granting a double charge
+ * - The Battery
+ * - AAA Battery
+ *
+ * @param ignoreBigRoomDoubleCharge Optional. If set to true, it will treat the current room as a
+ *                                 1x1 room for the purposes of calculating how much charge to
+ *                                 grant. Default is false.
+ */
+export function addRoomClearCharges(ignoreBigRoomDoubleCharge = false) {
+    for (const player of getPlayers()) {
+        addRoomClearCharge(player, ignoreBigRoomDoubleCharge);
+    }
+}
+/**
+ * Helper function to get the combined normal charge and the battery charge for the player's active
+ * item. This is useful because you have to add these two values together when setting the active
+ * charge.
+ */
+export function getTotalCharge(player, activeSlot) {
+    const activeCharge = player.GetActiveCharge(activeSlot);
+    const batteryCharge = player.GetBatteryCharge(activeSlot);
+    return activeCharge + batteryCharge;
+}
+export function isActiveSlotDoubleCharged(player, activeSlot) {
+    const collectibleType = player.GetActiveItem(activeSlot);
+    const batteryCharge = player.GetBatteryCharge(activeSlot);
+    const maxCharges = getCollectibleMaxCharges(collectibleType);
+    return batteryCharge >= maxCharges;
+}
+export function playChargeSoundEffect(player, activeSlot) {
+    for (const soundEffect of [
+        SoundEffect.BATTERY_CHARGE,
+        SoundEffect.BEEP, // 171
+    ]) {
+        sfxManager.Stop(soundEffect);
+    }
+    const chargeSoundEffect = shouldPlayFullRechargeSound(player, activeSlot)
+        ? SoundEffect.BATTERY_CHARGE
+        : SoundEffect.BEEP;
+    sfxManager.Play(chargeSoundEffect);
+}
+function shouldPlayFullRechargeSound(player, activeSlot) {
+    const activeItem = player.GetActiveItem(activeSlot);
+    const activeCharge = player.GetActiveCharge(activeSlot);
+    const batteryCharge = player.GetBatteryCharge(activeSlot);
+    const hasBattery = player.HasCollectible(CollectibleType.BATTERY);
+    const maxCharges = getCollectibleMaxCharges(activeItem);
+    // If we do not have The Battery, play the full recharge sound if we are now fully charged.
+    if (!hasBattery) {
+        // We cannot use the `EntityPlayer.NeedsCharge` method because it does not work properly for
+        // items with `chargetype="special"`.
+        return activeCharge === maxCharges;
+    }
+    // If we do have The Battery, play the full recharge sound if we are exactly double charged or
+    // exactly single charged.
+    return (batteryCharge === maxCharges ||
+        (activeCharge === maxCharges && batteryCharge === 0));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhcmdlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvY2hhcmdlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCxVQUFVLEVBQ1YsZUFBZSxFQUNmLFdBQVcsRUFDWCxXQUFXLEdBQ1osTUFBTSw4QkFBOEIsQ0FBQztBQUN0QyxPQUFPLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ3BELE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzFELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDM0MsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRWxEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FrQkc7QUFDSCxNQUFNLFVBQVUsU0FBUyxDQUN2QixNQUFvQixFQUNwQixVQUFzQixFQUN0QixVQUFVLEdBQUcsQ0FBQyxFQUNkLGVBQWUsR0FBRyxJQUFJO0lBRXRCLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztJQUUxQix5RkFBeUY7SUFDekYsTUFBTSxZQUFZLEdBQUcsc0JBQXNCLENBQUMsTUFBTSxFQUFFLFVBQVUsRUFBRSxVQUFVLENBQUMsQ0FBQztJQUU1RSw0REFBNEQ7SUFDNUQsTUFBTSxvQkFBb0IsR0FBRyw4QkFBOEIsQ0FDekQsTUFBTSxFQUNOLFVBQVUsRUFDVixZQUFZLENBQ2IsQ0FBQztJQUVGLE1BQU0sV0FBVyxHQUFHLGNBQWMsQ0FBQyxNQUFNLEVBQUUsVUFBVSxDQUFDLENBQUM7SUFDdkQsTUFBTSxTQUFTLEdBQUcsV0FBVyxHQUFHLG9CQUFvQixDQUFDO0lBQ3JELElBQUksU0FBUyxLQUFLLFdBQVcsRUFBRTtRQUM3QixPQUFPLENBQUMsQ0FBQztLQUNWO0lBRUQsTUFBTSxDQUFDLGVB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

package/functions/chargeBar.js

@@ -0,0 +1,44 @@
+const CHARGE_BAR_ANM2 = "gfx/ui/ui_chargebar.anm2";
+/**
+ * Constructor for a `ChargeBarSprites` object. For more information, see the `renderChargeBar`
+ * helper function.
+ */
+export function newChargeBarSprites(maxCharges) {
+    const back = Sprite();
+    back.Load(CHARGE_BAR_ANM2, true);
+    back.Play("BarEmpty", true);
+    const meter = Sprite();
+    meter.Load(CHARGE_BAR_ANM2, true);
+    meter.Play("BarFull", true);
+    const meterBattery = Sprite();
+    meterBattery.Load(CHARGE_BAR_ANM2, true);
+    meterBattery.Play("BarFull", true);
+    const lines = Sprite();
+    lines.Load(CHARGE_BAR_ANM2, true);
+    lines.Play(`BarOverlay${maxCharges}`, true);
+    return {
+        back,
+        meter,
+        meterBattery,
+        lines,
+        maxCharges,
+    };
+}
+/**
+ * Helper function to render a charge bar on the screen. First, call the `newChargeBarSprites`
+ * function to initialize the sprites, and then call this function on every render frame.
+ */
+export function renderChargeBar(sprites, position, normalCharges, batteryCharges) {
+    sprites.back.Render(position);
+    const normalChargesClamp = getChargeBarClamp(normalCharges, sprites.maxCharges);
+    sprites.meter.Render(position, normalChargesClamp);
+    const batteryChargesClamp = getChargeBarClamp(batteryCharges, sprites.maxCharges);
+    sprites.meterBattery.Render(position, batteryChargesClamp);
+    sprites.lines.Render(position);
+}
+function getChargeBarClamp(charges, maxCharges) {
+    const meterMultiplier = 24 / maxCharges;
+    const meterClip = 26 - charges * meterMultiplier;
+    return Vector(0, meterClip);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhcmdlQmFyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvY2hhcmdlQmFyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE1BQU0sZUFBZSxHQUFHLDBCQUEwQixDQUFDO0FBRW5EOzs7R0FHRztBQUNILE1BQU0sVUFBVSxtQkFBbUIsQ0FBQyxVQUFlO0lBQ2pELE1BQU0sSUFBSSxHQUFHLE1BQU0sRUFBRSxDQUFDO0lBQ3RCLElBQUksQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ2pDLElBQUksQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLElBQUksQ0FBQyxDQUFDO0lBRTVCLE1BQU0sS0FBSyxHQUFHLE1BQU0sRUFBRSxDQUFDO0lBQ3ZCLEtBQUssQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ2xDLEtBQUssQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLElBQUksQ0FBQyxDQUFDO0lBRTVCLE1BQU0sWUFBWSxHQUFHLE1BQU0sRUFBRSxDQUFDO0lBQzlCLFlBQVksQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ3pDLFlBQVksQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLElBQUksQ0FBQyxDQUFDO0lBRW5DLE1BQU0sS0FBSyxHQUFHLE1BQU0sRUFBRSxDQUFDO0lBQ3ZCLEtBQUssQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ2xDLEtBQUssQ0FBQyxJQUFJLENBQUMsYUFBYSxVQUFVLEVBQUUsRUFBRSxJQUFJLENBQUMsQ0FBQztJQUU1QyxPQUFPO1FBQ0wsSUFBSTtRQUNKLEtBQUs7UUFDTCxZQUFZO1FBQ1osS0FBSztRQUNMLFVBQVU7S0FDWCxDQUFDO0FBQ0osQ0FBQztBQUVEOzs7R0FHRztBQUNILE1BQU0sVUFBVSxlQUFlLENBQzdCLE9BQXlCLEVBQ3pCLFFBQWdCLEVBQ2hCLGFBQWtCLEVBQ2xCLGNBQW1CO0lBRW5CLE9BQU8sQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBRTlCLE1BQU0sa0JBQWtCLEdBQUcsaUJBQWlCLENBQzFDLGFBQWEsRUFDYixPQUFPLENBQUMsVUFBVSxDQUNuQixDQUFDO0lBQ0YsT0FBTyxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsUUFBUSxFQUFFLGtCQUFrQixDQUFDLENBQUM7SUFFbkQsTUFBTSxtQkFBbUIsR0FBRyxpQkFBaUIsQ0FDM0MsY0FBYyxFQUNkLE9BQU8sQ0FBQyxVQUFVLENBQ25CLENBQUM7SUFDRixPQUFPLENBQUMsWUFBWSxDQUFDLE1BQU0sQ0FBQyxRQUFRLEVBQUUsbUJBQW1CLENBQUMsQ0FBQztJQUUzRCxPQUFPLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztBQUNqQyxDQUFDO0FBRUQsU0FBUyxpQkFBaUIsQ0FBQyxPQUFZLEVBQUUsVUFBZTtJQUN0RCxNQUFNLGVBQWUsR0FBRyxFQUFFLEdBQUcsVUFBVSxDQUFDO0lBQ3hDLE1BQU0sU0FBUyxHQUFHLEVBQUUsR0FBRyxPQUFPLEdBQUcsZUFBZSxDQUFDO0lBQ2pELE9BQU8sTUFBTSxDQUFDLENBQUMsRUFBRSxTQUFTLENBQUMsQ0FBQztBQUM5QixDQUFDIn0=

package/functions/collectibleCacheFlag.js

@@ -0,0 +1,68 @@
+import { CacheFlag } from "isaac-typescript-definitions";
+import { itemConfig } from "../cachedClasses";
+import { getCollectibleArray } from "./collectibleSet";
+import { getEnumValues } from "./enums";
+import { hasFlag } from "./flag";
+import { copySet, getSortedSetValues } from "./set";
+import { repeat } from "./utils";
+const CACHE_FLAG_TO_COLLECTIBLES_MAP = new Map();
+function initCacheFlagMap() {
+    for (const cacheFlag of getEnumValues(CacheFlag)) {
+        const collectiblesSet = new Set();
+        for (const collectibleType of getCollectibleArray()) {
+            if (collectibleHasCacheFlag(collectibleType, cacheFlag)) {
+                collectiblesSet.add(collectibleType);
+            }
+        }
+        CACHE_FLAG_TO_COLLECTIBLES_MAP.set(cacheFlag, collectiblesSet);
+    }
+}
+export function collectibleHasCacheFlag(collectibleType, cacheFlag) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return false;
+    }
+    return hasFlag(itemConfigItem.CacheFlags, cacheFlag);
+}
+/**
+ * Returns a set containing every collectible type with the given cache flag, including modded
+ * collectibles.
+ */
+export function getCollectiblesForCacheFlag(cacheFlag) {
+    // Lazy initialize the map.
+    if (CACHE_FLAG_TO_COLLECTIBLES_MAP.size === 0) {
+        initCacheFlagMap();
+    }
+    const collectiblesSet = CACHE_FLAG_TO_COLLECTIBLES_MAP.get(cacheFlag);
+    if (collectiblesSet === undefined) {
+        return new Set();
+    }
+    return copySet(collectiblesSet);
+}
+/**
+ * Returns an array containing every collectible type that the player has that matches the provided
+ * CacheFlag.
+ *
+ * For example, if the cache flag is `CacheFlag.FLYING`, and the player has one Lord of the Pit and
+ * two Dead Doves, then this function would return:
+ *
+ * ```ts
+ * [
+ *   CollectibleType.LORD_OF_THE_PIT,
+ *   CollectibleType.DEAD_DOVE,
+ *   CollectibleType.DEAD_DOVE,
+ * ]
+ * ```
+ */
+export function getPlayerCollectiblesForCacheFlag(player, cacheFlag) {
+    const collectiblesForCacheFlag = getCollectiblesForCacheFlag(cacheFlag);
+    const playerCollectibles = [];
+    for (const collectibleType of getSortedSetValues(collectiblesForCacheFlag)) {
+        const numCollectibles = player.GetCollectibleNum(collectibleType);
+        repeat(numCollectibles, () => {
+            playerCollectibles.push(collectibleType);
+        });
+    }
+    return playerCollectibles;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29sbGVjdGlibGVDYWNoZUZsYWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9jb2xsZWN0aWJsZUNhY2hlRmxhZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsU0FBUyxFQUFtQixNQUFNLDhCQUE4QixDQUFDO0FBQzFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUN2RCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFDakMsT0FBTyxFQUFFLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLE9BQU8sQ0FBQztBQUNwRCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBRWpDLE1BQU0sOEJBQThCLEdBQUcsSUFBSSxHQUFHLEVBRzNDLENBQUM7QUFFSixTQUFTLGdCQUFnQjtJQUN2QixLQUFLLE1BQU0sU0FBUyxJQUFJLGFBQWEsQ0FBQyxTQUFTLENBQUMsRUFBRTtRQUNoRCxNQUFNLGVBQWUsR0FBRyxJQUFJLEdBQUcsRUFBbUIsQ0FBQztRQUVuRCxLQUFLLE1BQU0sZUFBZSxJQUFJLG1CQUFtQixFQUFFLEVBQUU7WUFDbkQsSUFBSSx1QkFBdUIsQ0FBQyxlQUFlLEVBQUUsU0FBUyxDQUFDLEVBQUU7Z0JBQ3ZELGVBQWUsQ0FBQyxHQUFHLENBQUMsZUFBZSxDQUFDLENBQUM7YUFDdEM7U0FDRjtRQUVELDhCQUE4QixDQUFDLEdBQUcsQ0FBQyxTQUFTLEVBQUUsZUFBZSxDQUFDLENBQUM7S0FDaEU7QUFDSCxDQUFDO0FBRUQsTUFBTSxVQUFVLHVCQUF1QixDQUNyQyxlQUFnQyxFQUNoQyxTQUFvQjtJQUVwQixNQUFNLGNBQWMsR0FBRyxVQUFVLENBQUMsY0FBYyxDQUFDLGVBQWUsQ0FBQyxDQUFDO0lBQ2xFLElBQUksY0FBYyxLQUFLLFNBQVMsRUFBRTtRQUNoQyxPQUFPLEtBQUssQ0FBQztLQUNkO0lBRUQsT0FBTyxPQUFPLENBQUMsY0FBYyxDQUFDLFVBQVUsRUFBRSxTQUFTLENBQUMsQ0FBQztBQUN2RCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLDJCQUEyQixDQUN6QyxTQUFvQjtJQUVwQiwyQkFBMkI7SUFDM0IsSUFBSSw4QkFBOEIsQ0FBQyxJQUFJLEtBQUssQ0FBQyxFQUFFO1FBQzdDLGdCQUFnQixFQUFFLENBQUM7S0FDcEI7SUFFRCxNQUFNLGVBQWUsR0FBRyw4QkFBOEIsQ0FBQyxHQUFHLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDdEUsSUFBSSxlQUFlLEtBQUssU0FBUyxFQUFFO1FBQ2pDLE9BQU8sSUFBSSxHQUFHLEVBQUUsQ0FBQztLQUNsQjtJQUVELE9BQU8sT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFDO0FBQ2xDLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILE1BQU0sVUFBVSxpQ0FBaUMsQ0FDL0MsTUFBb0IsRUFDcEIsU0FBb0I7SUFFcEIsTUFBTSx3QkFBd0IsR0FBRywyQkFBMkIsQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUV4RSxNQUFNLGtCQUFrQixHQUFzQixFQUFFLENBQUM7SUFDakQsS0FBSyxNQUFNLGVBQWUsSUFBSSxrQkFBa0IsQ0FBQyx3QkFBd0IsQ0FBQyxFQUFFO1FBQzFFLE1BQU0sZUFBZSxHQUFHLE1BQU0sQ0FBQyxpQkFBaUIsQ0FBQyxlQUFlLENBQUMsQ0FBQztRQUNsRSxNQUFNLENBQUMsZUFBZSxFQUFFLEdBQUcsRUFBRTtZQUMzQixrQkFBa0IsQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLENBQUM7UUFDM0MsQ0FBQyxDQUFDLENBQUM7S0FDSjtJQUVELE9BQU8sa0JBQWtCLENBQUM7QUFDNUIsQ0FBQyJ9

package/functions/collectibleSet.js

@@ -0,0 +1,108 @@
+import { itemConfig } from "../cachedClasses";
+import { FIRST_COLLECTIBLE_TYPE, LAST_COLLECTIBLE_TYPE, LAST_VANILLA_COLLECTIBLE_TYPE, } from "../constantsFirstLast";
+import { irange } from "./utils";
+const ALL_COLLECTIBLES_ARRAY = [];
+const VANILLA_COLLECTIBLES_ARRAY = [];
+const MODDED_COLLECTIBLES_ARRAY = [];
+const ALL_COLLECTIBLES_SET = new Set();
+const VANILLA_COLLECTIBLES_SET = new Set();
+const MODDED_COLLECTIBLES_SET = new Set();
+function initCollectibleArraysAndSets() {
+    if (ALL_COLLECTIBLES_ARRAY.length !== 0) {
+        return;
+    }
+    const collectibleTypeRange = irange(FIRST_COLLECTIBLE_TYPE, LAST_COLLECTIBLE_TYPE);
+    for (const collectibleType of collectibleTypeRange) {
+        const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+        if (itemConfigItem === undefined) {
+            continue;
+        }
+        ALL_COLLECTIBLES_ARRAY.push(collectibleType);
+        if (collectibleType <= LAST_VANILLA_COLLECTIBLE_TYPE) {
+            VANILLA_COLLECTIBLES_ARRAY.push(collectibleType);
+        }
+        else {
+            MODDED_COLLECTIBLES_ARRAY.push(collectibleType);
+        }
+    }
+    ALL_COLLECTIBLES_ARRAY.sort();
+    VANILLA_COLLECTIBLES_ARRAY.sort();
+    MODDED_COLLECTIBLES_ARRAY.sort();
+    for (const collectibleType of ALL_COLLECTIBLES_ARRAY) {
+        ALL_COLLECTIBLES_SET.add(collectibleType);
+    }
+    for (const collectibleType of VANILLA_COLLECTIBLES_ARRAY) {
+        VANILLA_COLLECTIBLES_SET.add(collectibleType);
+    }
+    for (const collectibleType of MODDED_COLLECTIBLES_ARRAY) {
+        MODDED_COLLECTIBLES_SET.add(collectibleType);
+    }
+}
+/**
+ * Returns an array containing every valid collectible type in the game, including modded
+ * collectibles.
+ *
+ * Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
+ * then use the `getCollectibleArray` helper function instead.
+ */
+export function getCollectibleArray() {
+    // Lazy initialize the arrays/sets.
+    initCollectibleArraysAndSets();
+    return ALL_COLLECTIBLES_ARRAY;
+}
+/**
+ * Returns a set containing every valid collectible type in the game, including modded collectibles.
+ *
+ * Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
+ * then use the `getCollectibleArray` helper function instead.
+ */
+export function getCollectibleSet() {
+    // Lazy initialize the arrays/sets.
+    initCollectibleArraysAndSets();
+    return ALL_COLLECTIBLES_SET;
+}
+/**
+ * Returns an array containing every modded collectible type in the game.
+ *
+ * Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
+ * then use the `getModdedCollectibleSet` helper function instead.
+ */
+export function getModdedCollectibleArray() {
+    // Lazy initialize the arrays/sets.
+    initCollectibleArraysAndSets();
+    return MODDED_COLLECTIBLES_ARRAY;
+}
+/**
+ * Returns a set containing every modded collectible type in the game.
+ *
+ * Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
+ * then use the `getModdedCollectibleArray` helper function instead.
+ */
+export function getModdedCollectibleSet() {
+    // Lazy initialize the arrays/sets.
+    initCollectibleArraysAndSets();
+    return MODDED_COLLECTIBLES_SET;
+}
+/**
+ * Returns an array containing every valid vanilla collectible type in the game.
+ *
+ * Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
+ * then use the `getVanillaCollectibleSet` helper function instead.
+ */
+export function getVanillaCollectibleArray() {
+    // Lazy initialize the arrays/sets.
+    initCollectibleArraysAndSets();
+    return VANILLA_COLLECTIBLES_ARRAY;
+}
+/**
+ * Returns a set containing every valid vanilla collectible type in the game.
+ *
+ * Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
+ * then use the `getVanillaCollectibleArray` helper function instead.
+ */
+export function getVanillaCollectibleSet() {
+    // Lazy initialize the arrays/sets.
+    initCollectibleArraysAndSets();
+    return VANILLA_COLLECTIBLES_SET;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29sbGVjdGlibGVTZXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9jb2xsZWN0aWJsZVNldC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDOUMsT0FBTyxFQUNMLHNCQUFzQixFQUN0QixxQkFBcUIsRUFDckIsNkJBQTZCLEdBQzlCLE1BQU0sdUJBQXVCLENBQUM7QUFDL0IsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUVqQyxNQUFNLHNCQUFzQixHQUFzQixFQUFFLENBQUM7QUFDckQsTUFBTSwwQkFBMEIsR0FBc0IsRUFBRSxDQUFDO0FBQ3pELE1BQU0seUJBQXlCLEdBQXNCLEVBQUUsQ0FBQztBQUV4RCxNQUFNLG9CQUFvQixHQUFHLElBQUksR0FBRyxFQUFtQixDQUFDO0FBQ3hELE1BQU0sd0JBQXdCLEdBQUcsSUFBSSxHQUFHLEVBQW1CLENBQUM7QUFDNUQsTUFBTSx1QkFBdUIsR0FBRyxJQUFJLEdBQUcsRUFBbUIsQ0FBQztBQUUzRCxTQUFTLDRCQUE0QjtJQUNuQyxJQUFJLHNCQUFzQixDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUU7UUFDdkMsT0FBTztLQUNSO0lBRUQsTUFBTSxvQkFBb0IsR0FBRyxNQUFNLENBQ2pDLHNCQUFzQixFQUN0QixxQkFBcUIsQ0FDRCxDQUFDO0lBQ3ZCLEtBQUssTUFBTSxlQUFlLElBQUksb0JBQW9CLEVBQUU7UUFDbEQsTUFBTSxjQUFjLEdBQUcsVUFBVSxDQUFDLGNBQWMsQ0FBQyxlQUFlLENBQUMsQ0FBQztRQUNsRSxJQUFJLGNBQWMsS0FBSyxTQUFTLEVBQUU7WUFDaEMsU0FBUztTQUNWO1FBRUQsc0JBQXNCLENBQUMsSUFBSSxDQUFDLGVBQWUsQ0FBQyxDQUFDO1FBQzdDLElBQUksZUFBZSxJQUFJLDZCQUE2QixFQUFFO1lBQ3BELDBCQUEwQixDQUFDLElBQUksQ0FBQyxlQUFlLENBQUMsQ0FBQztTQUNsRDthQUFNO1lBQ0wseUJBQXlCLENBQUMsSUFBSSxDQUFDLGVBQWUsQ0FBQyxDQUFDO1NBQ2pEO0tBQ0Y7SUFFRCxzQkFBc0IsQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUM5QiwwQkFBMEIsQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNsQyx5QkFBeUIsQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUVqQyxLQUFLLE1BQU0sZUFBZSxJQUFJLHNCQUFzQixFQUFFO1FBQ3BELG9CQUFvQixDQUFDLEdBQUcsQ0FBQyxlQUFlLENBQUMsQ0FBQztLQUMzQztJQUNELEtBQUssTUFBTSxlQUFlLElBQUksMEJBQTBCLEVBQUU7UUFDeEQsd0JBQXdCLENBQUMsR0FBRyxDQUFDLGVBQWUsQ0FBQyxDQUFDO0tBQy9DO0lBQ0QsS0FBSyxNQUFNLGVBQWUsSUFBSSx5QkFBeUIsRUFBRTtRQUN2RCx1QkFBdUIsQ0FBQyxHQUFHLENBQUMsZUFBZSxDQUFDLENBQUM7S0FDOUM7QUFDSCxDQUFDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLG1CQUFtQjtJQUNqQyxtQ0FBbUM7SUFDbkMsNEJBQTRCLEVBQUUsQ0FBQztJQUUvQixPQUFPLHNCQUFzQixDQUFDO0FBQ2hDLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSxpQkFBaUI7SUFDL0IsbUNBQW1DO0lBQ25DLDRCQUE0QixFQUFFLENBQUM7SUFFL0IsT0FBTyxvQkFBb0IsQ0FBQztBQUM5QixDQUFDO0FBRUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLFVBQVUseUJBQXlCO0lBQ3ZDLG1DQUFtQztJQUNuQyw0QkFBNEIsRUFBRSxDQUFDO0lBRS9CLE9BQU8seUJBQXlCLENBQUM7QUFDbkMsQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLHVCQUF1QjtJQUNyQyxtQ0FBbUM7SUFDbkMsNEJBQTRCLEVBQUUsQ0FBQztJQUUvQixPQUFPLHVCQUF1QixDQUFDO0FBQ2pDLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSwwQkFBMEI7SUFDeEMsbUNBQW1DO0lBQ25DLDRCQUE0QixFQUFFLENBQUM7SUFFL0IsT0FBTywwQkFBMEIsQ0FBQztBQUNwQyxDQUFDO0FBRUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLFVBQVUsd0JBQXdCO0lBQ3RDLG1DQUFtQztJQUNuQyw0QkFBNEIsRUFBRSxDQUFDO0lBRS9CLE9BQU8sd0JBQXdCLENBQUM7QUFDbEMsQ0FBQyJ9

package/functions/collectibleTag.js

@@ -0,0 +1,65 @@
+import { ItemConfigTag } from "isaac-typescript-definitions";
+import { itemConfig } from "../cachedClasses";
+import { getCollectibleArray } from "./collectibleSet";
+import { getEnumValues } from "./enums";
+import { getFlagName } from "./flag";
+import { getPlayerCollectibleCount } from "./player";
+import { copySet } from "./set";
+const TAG_TO_COLLECTIBLE_TYPES_MAP = new Map();
+function initTagMap() {
+    // The tag to collectible types map should be valid for every tag, so we initialize it with empty
+    // sets.
+    for (const itemConfigTag of getEnumValues(ItemConfigTag)) {
+        TAG_TO_COLLECTIBLE_TYPES_MAP.set(itemConfigTag, new Set());
+    }
+    for (const collectibleType of getCollectibleArray()) {
+        for (const itemConfigTag of getEnumValues(ItemConfigTag)) {
+            if (!collectibleHasTag(collectibleType, itemConfigTag)) {
+                continue;
+            }
+            const collectibleTypesSet = TAG_TO_COLLECTIBLE_TYPES_MAP.get(itemConfigTag);
+            if (collectibleTypesSet === undefined) {
+                const flagName = getFlagName(itemConfigTag, ItemConfigTag);
+                error(`Failed to get the collectible types for item tag: ${flagName}`);
+            }
+            collectibleTypesSet.add(collectibleType);
+        }
+    }
+}
+export function collectibleHasTag(collectibleType, tag) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return false;
+    }
+    return itemConfigItem.HasTags(tag);
+}
+/**
+ * Helper function to get all of the collectible types in the game that have a certain tag.
+ *
+ * For example, to get all of the collectible types that count as offensive for the purposes of
+ * Tainted Lost:
+ *
+ * ```ts
+ * const offensiveCollectibleTypes = getCollectibleTypesWithTag(ItemConfigTag.OFFENSIVE);
+ * ```
+ */
+export function getCollectibleTypesWithTag(itemConfigTag) {
+    // Lazy initialize the map.
+    if (TAG_TO_COLLECTIBLE_TYPES_MAP.size === 0) {
+        initTagMap();
+    }
+    const collectibleTypes = TAG_TO_COLLECTIBLE_TYPES_MAP.get(itemConfigTag);
+    if (collectibleTypes === undefined) {
+        error(`The item config tag of ${itemConfigTag} is not a valid value of the ItemConfigTag enum.`);
+    }
+    return copySet(collectibleTypes);
+}
+/** Returns the number of items that a player has towards a particular transformation. */
+export function getPlayerNumCollectiblesWithTag(player, itemConfigTag) {
+    const collectibleTypesSet = getCollectibleTypesWithTag(itemConfigTag);
+    return getPlayerCollectibleCount(player, ...collectibleTypesSet.values());
+}
+export function isQuestCollectible(collectibleType) {
+    return collectibleHasTag(collectibleType, ItemConfigTag.QUEST);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29sbGVjdGlibGVUYWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9jb2xsZWN0aWJsZVRhZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQW1CLGFBQWEsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQzlFLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUN2RCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFDckMsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQ3JELE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxPQUFPLENBQUM7QUFFaEMsTUFBTSw0QkFBNEIsR0FBRyxJQUFJLEdBQUcsRUFHekMsQ0FBQztBQUVKLFNBQVMsVUFBVTtJQUNqQixpR0FBaUc7SUFDakcsUUFBUTtJQUNSLEtBQUssTUFBTSxhQUFhLElBQUksYUFBYSxDQUFDLGFBQWEsQ0FBQyxFQUFFO1FBQ3hELDRCQUE0QixDQUFDLEdBQUcsQ0FBQyxhQUFhLEVBQUUsSUFBSSxHQUFHLEVBQUUsQ0FBQyxDQUFDO0tBQzVEO0lBRUQsS0FBSyxNQUFNLGVBQWUsSUFBSSxtQkFBbUIsRUFBRSxFQUFFO1FBQ25ELEtBQUssTUFBTSxhQUFhLElBQUksYUFBYSxDQUFDLGFBQWEsQ0FBQyxFQUFFO1lBQ3hELElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxlQUFlLEVBQUUsYUFBYSxDQUFDLEVBQUU7Z0JBQ3RELFNBQVM7YUFDVjtZQUVELE1BQU0sbUJBQW1CLEdBQ3ZCLDRCQUE0QixDQUFDLEdBQUcsQ0FBQyxhQUFhLENBQUMsQ0FBQztZQUNsRCxJQUFJLG1CQUFtQixLQUFLLFNBQVMsRUFBRTtnQkFDckMsTUFBTSxRQUFRLEdBQUcsV0FBVyxDQUFDLGFBQWEsRUFBRSxhQUFhLENBQUMsQ0FBQztnQkFDM0QsS0FBSyxDQUFDLHFEQUFxRCxRQUFRLEVBQUUsQ0FBQyxDQUFDO2FBQ3hFO1lBQ0QsbUJBQW1CLENBQUMsR0FBRyxDQUFDLGVBQWUsQ0FBQyxDQUFDO1NBQzFDO0tBQ0Y7QUFDSCxDQUFDO0FBRUQsTUFBTSxVQUFVLGlCQUFpQixDQUMvQixlQUFnQyxFQUNoQyxHQUFrQjtJQUVsQixNQUFNLGNBQWMsR0FBRyxVQUFVLENBQUMsY0FBYyxDQUFDLGVBQWUsQ0FBQyxDQUFDO0lBQ2xFLElBQUksY0FBYyxLQUFLLFNBQVMsRUFBRTtRQUNoQyxPQUFPLEtBQUssQ0FBQztLQUNkO0lBRUQsT0FBTyxjQUFjLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0FBQ3JDLENBQUM7QUFFRDs7Ozs7Ozs7O0dBU0c7QUFDSCxNQUFNLFVBQVUsMEJBQTBCLENBQ3hDLGFBQTRCO0lBRTVCLDJCQUEyQjtJQUMzQixJQUFJLDRCQUE0QixDQUFDLElBQUksS0FBSyxDQUFDLEVBQUU7UUFDM0MsVUFBVSxFQUFFLENBQUM7S0FDZDtJQUVELE1BQU0sZ0JBQWdCLEdBQUcsNEJBQTRCLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxDQUFDO0lBQ3pFLElBQUksZ0JBQWdCLEtBQUssU0FBUyxFQUFFO1FBQ2xDLEtBQUssQ0FDSCwwQkFBMEIsYUFBYSxrREFBa0QsQ0FDMUYsQ0FBQztLQUNIO0lBRUQsT0FBTyxPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztBQUNuQyxDQUFDO0FBRUQseUZBQXlGO0FBQ3pGLE1BQU0sVUFBVSwrQkFBK0IsQ0FDN0MsTUFBb0IsRUFDcEIsYUFBNEI7SUFFNUIsTUFBTSxtQkFBbUIsR0FBRywwQkFBMEIsQ0FBQyxhQUFhLENBQUMsQ0FBQztJQUN0RSxPQUFPLHlCQUF5QixDQUFDLE1BQU0sRUFBRSxHQUFHLG1CQUFtQixDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUM7QUFDNUUsQ0FBQztBQUVELE1BQU0sVUFBVSxrQkFBa0IsQ0FBQyxlQUFnQztJQUNqRSxPQUFPLGlCQUFpQixDQUFDLGVBQWUsRUFBRSxhQUFhLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDakUsQ0FBQyJ9