isaacscript-common 6.6.1-dev.2 → 6.6.1

package/functions/character.js

@@ -1,102 +0,0 @@
-import { PlayerType } from "isaac-typescript-definitions";
-import { LAST_VANILLA_CHARACTER } from "../constantsFirstLast";
-import { CHARACTER_NAMES } from "../objects/characterNames";
-import { CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET } from "../sets/charactersThatStartWithAnActiveItemSet";
-import { CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET } from "../sets/charactersWithBlackHeartFromEternalHeartSet";
-import { CHARACTERS_WITH_FREE_DEVIL_DEALS_SET } from "../sets/charactersWithFreeDevilDealsSet";
-import { CHARACTERS_WITH_NO_RED_HEARTS_SET } from "../sets/charactersWithNoRedHeartsSet";
-import { CHARACTERS_WITH_NO_SOUL_HEARTS_SET } from "../sets/charactersWithNoSoulHeartsSet";
-import { LOST_STYLE_CHARACTERS_SET } from "../sets/lostStyleCharactersSet";
-/**
- * Helper function to determine if the given character can have red heart containers. Returns true
- * for characters like Isaac, Magdalene, or Cain. Returns true for Keeper and Tainted Keeper, even
- * though coin containers are not technically the same as red heart containers. Returns false for
- * characters like Blue Baby. Returns false for The Lost and Tainted Lost.
- */
-export function characterCanHaveRedHearts(character) {
-    return !CHARACTERS_WITH_NO_RED_HEARTS_SET.has(character);
-}
-/**
- * Helper function to determine if the given character can have soul hearts. Returns true for
- * characters like Isaac, Magdalene, or Cain. Returns false for characters like Bethany. Returns
- * false for The Lost and Tainted Lost.
- */
-export function characterCanHaveSoulHearts(character) {
-    return !CHARACTERS_WITH_NO_SOUL_HEARTS_SET.has(character);
-}
-/**
- * Helper function for determining whether the given character can take free Devil Deals. (e.g. The
- * Lost, Tainted Lost, etc.)
- */
-export function characterCanTakeFreeDevilDeals(character) {
-    return CHARACTERS_WITH_FREE_DEVIL_DEALS_SET.has(character);
-}
-/**
- * Normally, characters get a red heart container upon reaching a new floor with an eternal heart,
- * but some characters grant a black heart instead. Returns true for Dark Judas and Tainted Judas.
- * Otherwise, returns false.
- */
-export function characterGetsBlackHeartFromEternalHeart(character) {
-    return CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET.has(character);
-}
-/**
- * Helper function to determine if the specified character starts with an active item.
- *
- * For the purposes of this function, the save file is considered to be fully unlocked (e.g. Isaac
- * is considered to starts with the D6, but this is not the case on a brand new save file).
- */
-export function characterStartsWithActiveItem(character) {
-    return CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET.has(character);
-}
-/**
- * - Most characters have a 56 frame death animation (i.e. the "Death" animation).
- * - The Lost and Tainted Lost have a 38 frame death animation (i.e. the "LostDeath" animation).
- * - Tainted Forgotten have a 20 frame death animation (i.e. the "ForgottenDeath" animation).
- */
-export function getCharacterDeathAnimationName(character) {
-    if (LOST_STYLE_CHARACTERS_SET.has(character)) {
-        return "LostDeath";
-    }
-    if (character === PlayerType.THE_FORGOTTEN_B) {
-        return "ForgottenDeath";
-    }
-    return "Death";
-}
-/**
- * Returns the maximum heart containers that the provided character can have. Normally, this is 12,
- * but with Keeper it is 3, and with Tainted Keeper it is 2. This does not account for Birthright or
- * Mother's Kiss; use the `getPlayerMaxHeartContainers` helper function for that.
- */
-export function getCharacterMaxHeartContainers(character) {
-    // 14
-    if (character === PlayerType.KEEPER) {
-        return 3;
-    }
-    // 16
-    if (character === PlayerType.THE_FORGOTTEN) {
-        return 6;
-    }
-    // 17
-    if (character === PlayerType.THE_SOUL) {
-        return 6;
-    }
-    // 33
-    if (character === PlayerType.KEEPER_B) {
-        return 2;
-    }
-    return 12;
-}
-/** Helper function to get the name of a character. Returns "Unknown" for modded characters. */
-export function getCharacterName(character) {
-    if (isModdedCharacter(character)) {
-        return "Unknown";
-    }
-    return CHARACTER_NAMES[character];
-}
-export function isModdedCharacter(character) {
-    return !isVanillaCharacter(character);
-}
-export function isVanillaCharacter(character) {
-    return character <= LAST_VANILLA_CHARACTER;
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhcmFjdGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvY2hhcmFjdGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUMxRCxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUMvRCxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDNUQsT0FBTyxFQUFFLDZDQUE2QyxFQUFFLE1BQU0sZ0RBQWdELENBQUM7QUFDL0csT0FBTyxFQUFFLGtEQUFrRCxFQUFFLE1BQU0scURBQXFELENBQUM7QUFDekgsT0FBTyxFQUFFLG9DQUFvQyxFQUFFLE1BQU0seUNBQXlDLENBQUM7QUFDL0YsT0FBTyxFQUFFLGlDQUFpQyxFQUFFLE1BQU0sc0NBQXNDLENBQUM7QUFDekYsT0FBTyxFQUFFLGtDQUFrQyxFQUFFLE1BQU0sdUNBQXVDLENBQUM7QUFDM0YsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFM0U7Ozs7O0dBS0c7QUFDSCxNQUFNLFVBQVUseUJBQXlCLENBQUMsU0FBcUI7SUFDN0QsT0FBTyxDQUFDLGlDQUFpQyxDQUFDLEdBQUcsQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUMzRCxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSwwQkFBMEIsQ0FBQyxTQUFxQjtJQUM5RCxPQUFPLENBQUMsa0NBQWtDLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0FBQzVELENBQUM7QUFFRDs7O0dBR0c7QUFDSCxNQUFNLFVBQVUsOEJBQThCLENBQUMsU0FBcUI7SUFDbEUsT0FBTyxvQ0FBb0MsQ0FBQyxHQUFHLENBQUMsU0FBUyxDQUFDLENBQUM7QUFDN0QsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsdUNBQXVDLENBQ3JELFNBQXFCO0lBRXJCLE9BQU8sa0RBQWtELENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0FBQzNFLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSw2QkFBNkIsQ0FBQyxTQUFxQjtJQUNqRSxPQUFPLDZDQUE2QyxDQUFDLEdBQUcsQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUN0RSxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSw4QkFBOEIsQ0FBQyxTQUFxQjtJQUNsRSxJQUFJLHlCQUF5QixDQUFDLEdBQUcsQ0FBQyxTQUFTLENBQUMsRUFBRTtRQUM1QyxPQUFPLFdBQVcsQ0FBQztLQUNwQjtJQUVELElBQUksU0FBUyxLQUFLLFVBQVUsQ0FBQyxlQUFlLEVBQUU7UUFDNUMsT0FBTyxnQkFBZ0IsQ0FBQztLQUN6QjtJQUVELE9BQU8sT0FBTyxDQUFDO0FBQ2pCLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLDhCQUE4QixDQUFDLFNBQXFCO0lBQ2xFLEtBQUs7SUFDTCxJQUFJLFNBQVMsS0FBSyxVQUFVLENBQUMsTUFBTSxFQUFFO1FBQ25DLE9BQU8sQ0FBQyxDQUFDO0tBQ1Y7SUFFRCxLQUFLO0lBQ0wsSUFBSSxTQUFTLEtBQUssVUFBVSxDQUFDLGFBQWEsRUFBRTtRQUMxQyxPQUFPLENBQUMsQ0FBQztLQUNWO0lBRUQsS0FBSztJQUNMLElBQUksU0FBUyxLQUFLLFVBQVUsQ0FBQyxRQUFRLEVBQUU7UUFDckMsT0FBTyxDQUFDLENBQUM7S0FDVjtJQUVELEtBQUs7SUFDTCxJQUFJLFNBQVMsS0FBSyxVQUFVLENBQUMsUUFBUSxFQUFFO1FBQ3JDLE9BQU8sQ0FBQyxDQUFDO0tBQ1Y7SUFFRCxPQUFPLEVBQUUsQ0FBQztBQUNaLENBQUM7QUFFRCwrRkFBK0Y7QUFDL0YsTUFBTSxVQUFVLGdCQUFnQixDQUFDLFNBQXFCO0lBQ3BELElBQUksaUJBQWlCLENBQUMsU0FBUyxDQUFDLEVBQUU7UUFDaEMsT0FBTyxTQUFTLENBQUM7S0FDbEI7SUFFRCxPQUFPLGVBQWUsQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUNwQyxDQUFDO0FBRUQsTUFBTSxVQUFVLGlCQUFpQixDQUFDLFNBQXFCO0lBQ3JELE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUN4QyxDQUFDO0FBRUQsTUFBTSxVQUFVLGtCQUFrQixDQUFDLFNBQXFCO0lBQ3RELE9BQU8sU0FBUyxJQUFJLHNCQUFzQixDQUFDO0FBQzdDLENBQUMifQ==

package/functions/character.lua

@@ -1,96 +0,0 @@
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
-local ____constantsFirstLast = require("constantsFirstLast")
-local LAST_VANILLA_CHARACTER = ____constantsFirstLast.LAST_VANILLA_CHARACTER
-local ____characterNames = require("objects.characterNames")
-local CHARACTER_NAMES = ____characterNames.CHARACTER_NAMES
-local ____charactersThatStartWithAnActiveItemSet = require("sets.charactersThatStartWithAnActiveItemSet")
-local CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET = ____charactersThatStartWithAnActiveItemSet.CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET
-local ____charactersWithBlackHeartFromEternalHeartSet = require("sets.charactersWithBlackHeartFromEternalHeartSet")
-local CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET = ____charactersWithBlackHeartFromEternalHeartSet.CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET
-local ____charactersWithFreeDevilDealsSet = require("sets.charactersWithFreeDevilDealsSet")
-local CHARACTERS_WITH_FREE_DEVIL_DEALS_SET = ____charactersWithFreeDevilDealsSet.CHARACTERS_WITH_FREE_DEVIL_DEALS_SET
-local ____charactersWithNoRedHeartsSet = require("sets.charactersWithNoRedHeartsSet")
-local CHARACTERS_WITH_NO_RED_HEARTS_SET = ____charactersWithNoRedHeartsSet.CHARACTERS_WITH_NO_RED_HEARTS_SET
-local ____charactersWithNoSoulHeartsSet = require("sets.charactersWithNoSoulHeartsSet")
-local CHARACTERS_WITH_NO_SOUL_HEARTS_SET = ____charactersWithNoSoulHeartsSet.CHARACTERS_WITH_NO_SOUL_HEARTS_SET
-local ____lostStyleCharactersSet = require("sets.lostStyleCharactersSet")
-local LOST_STYLE_CHARACTERS_SET = ____lostStyleCharactersSet.LOST_STYLE_CHARACTERS_SET
-function ____exports.isModdedCharacter(self, character)
-    return not ____exports.isVanillaCharacter(nil, character)
-end
-function ____exports.isVanillaCharacter(self, character)
-    return character <= LAST_VANILLA_CHARACTER
-end
---- Helper function to determine if the given character can have red heart containers. Returns true
--- for characters like Isaac, Magdalene, or Cain. Returns true for Keeper and Tainted Keeper, even
--- though coin containers are not technically the same as red heart containers. Returns false for
--- characters like Blue Baby. Returns false for The Lost and Tainted Lost.
-function ____exports.characterCanHaveRedHearts(self, character)
-    return not CHARACTERS_WITH_NO_RED_HEARTS_SET:has(character)
-end
---- Helper function to determine if the given character can have soul hearts. Returns true for
--- characters like Isaac, Magdalene, or Cain. Returns false for characters like Bethany. Returns
--- false for The Lost and Tainted Lost.
-function ____exports.characterCanHaveSoulHearts(self, character)
-    return not CHARACTERS_WITH_NO_SOUL_HEARTS_SET:has(character)
-end
---- Helper function for determining whether the given character can take free Devil Deals. (e.g. The
--- Lost, Tainted Lost, etc.)
-function ____exports.characterCanTakeFreeDevilDeals(self, character)
-    return CHARACTERS_WITH_FREE_DEVIL_DEALS_SET:has(character)
-end
---- Normally, characters get a red heart container upon reaching a new floor with an eternal heart,
--- but some characters grant a black heart instead. Returns true for Dark Judas and Tainted Judas.
--- Otherwise, returns false.
-function ____exports.characterGetsBlackHeartFromEternalHeart(self, character)
-    return CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET:has(character)
-end
---- Helper function to determine if the specified character starts with an active item.
--- 
--- For the purposes of this function, the save file is considered to be fully unlocked (e.g. Isaac
--- is considered to starts with the D6, but this is not the case on a brand new save file).
-function ____exports.characterStartsWithActiveItem(self, character)
-    return CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET:has(character)
-end
---- - Most characters have a 56 frame death animation (i.e. the "Death" animation).
--- - The Lost and Tainted Lost have a 38 frame death animation (i.e. the "LostDeath" animation).
--- - Tainted Forgotten have a 20 frame death animation (i.e. the "ForgottenDeath" animation).
-function ____exports.getCharacterDeathAnimationName(self, character)
-    if LOST_STYLE_CHARACTERS_SET:has(character) then
-        return "LostDeath"
-    end
-    if character == PlayerType.THE_FORGOTTEN_B then
-        return "ForgottenDeath"
-    end
-    return "Death"
-end
---- Returns the maximum heart containers that the provided character can have. Normally, this is 12,
--- but with Keeper it is 3, and with Tainted Keeper it is 2. This does not account for Birthright or
--- Mother's Kiss; use the `getPlayerMaxHeartContainers` helper function for that.
-function ____exports.getCharacterMaxHeartContainers(self, character)
-    if character == PlayerType.KEEPER then
-        return 3
-    end
-    if character == PlayerType.THE_FORGOTTEN then
-        return 6
-    end
-    if character == PlayerType.THE_SOUL then
-        return 6
-    end
-    if character == PlayerType.KEEPER_B then
-        return 2
-    end
-    return 12
-end
---- Helper function to get the name of a character. Returns "Unknown" for modded characters.
-function ____exports.getCharacterName(self, character)
-    if ____exports.isModdedCharacter(nil, character) then
-        return "Unknown"
-    end
-    return CHARACTER_NAMES[character]
-end
-return ____exports
-
---# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL2NoYXJhY3Rlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsNkNBQTJCO0FBQWxCO0FBQ1QsK0JBQXVDO0FBQTlCO0FBQ1QsMkJBQWdDO0FBQXZCO0FBQ1QsbURBQThEO0FBQXJEO0FBQ1Qsd0RBQW1FO0FBQTFEO0FBQ1QsNENBQXFEO0FBQTVDO0FBQ1QseUNBQWtEO0FBQXpDO0FBQ1QsMENBQW1EO0FBQTFDO0FBQ1QsbUNBQTBDO0FBQWpDO0FBeUdULDZDQUFrQztBQUNoQyxlQUFRLG9DQUFtQjtBQUQ3QjtBQUlBLDhDQUFtQztBQUNqQyxXQUFPLGFBQWE7QUFEdEI7Ozs7O0FBckdBLHFEQUEwQztBQUN4QyxlQUFRLGtDQUFrQyxJQUFJO0FBRGhEOzs7O0FBU0Esc0RBQTJDO0FBQ3pDLGVBQVEsbUNBQW1DLElBQUk7QUFEakQ7OztBQVFBLDBEQUErQztBQUM3QyxXQUFPLHFDQUFxQyxJQUFJO0FBRGxEOzs7O0FBU0EsbUVBQ0U7QUFFQSxXQUFPLG1EQUFtRCxJQUFJO0FBSGhFOzs7OztBQVlBLHlEQUE4QztBQUM1QyxXQUFPLDhDQUE4QyxJQUFJO0FBRDNEOzs7O0FBU0EsMERBQStDO09BQ3pDLDBCQUEwQixJQUFJO0FBQ2hDLGVBQU87O09BR0wsYUFBYztBQUNoQixlQUFPOztBQUdULFdBQU87QUFUVDs7OztBQWlCQSwwREFBK0M7T0FFekMsYUFBYztBQUNoQixlQUFPOztPQUlMLGFBQWM7QUFDaEIsZUFBTzs7T0FJTCxhQUFjO0FBQ2hCLGVBQU87O09BSUwsYUFBYztBQUNoQixlQUFPOztBQUdULFdBQU87QUFyQlQ7O0FBeUJBLDRDQUFpQztPQUMzQixtQ0FBa0I7QUFDcEIsZUFBTzs7QUFHVCxXQUFPLGdCQUFnQjtBQUx6QiIsImZpbGUiOiJjaGFyYWN0ZXIubHVhIiwic291cmNlUm9vdCI6IiJ9

package/functions/charge.d.ts

@@ -1,76 +0,0 @@
-import { ActiveSlot } from "isaac-typescript-definitions";
-/**
- * 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 declare function addCharge(player: EntityPlayer, activeSlot: ActiveSlot, numCharges?: number, playSoundEffect?: boolean): int;
-/**
- * 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 declare function addRoomClearCharge(player: EntityPlayer, bigRoomDoubleCharge?: boolean, playSoundEffect?: boolean): void;
-/**
- * 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 declare function addRoomClearChargeToSlot(player: EntityPlayer, activeSlot: ActiveSlot, bigRoomDoubleCharge?: boolean, playSoundEffect?: boolean): void;
-/**
- * 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 declare function addRoomClearCharges(ignoreBigRoomDoubleCharge?: boolean): void;
-/**
- * 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 declare function getTotalCharge(player: EntityPlayer, activeSlot: ActiveSlot): int;
-export declare function isActiveSlotDoubleCharged(player: EntityPlayer, activeSlot: ActiveSlot): boolean;
-export declare function playChargeSoundEffect(player: EntityPlayer, activeSlot: ActiveSlot): void;

package/functions/charge.js

@@ -1,202 +0,0 @@
-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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