isaacscript-common 44.0.0 → 44.1.0

package/dist/src/classes/features/other/ItemPoolDetection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ItemPoolDetection.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/ItemPoolDetection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,eAAe,EAIhB,MAAM,8BAA8B,CAAC;AAgBtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAahD,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IAWtD;;;;;OAKG;IAEI,yBAAyB,CAC9B,YAAY,EAAE,YAAY,GACzB,eAAe,EAAE;IAOpB;;;;;;;;;;;OAWG;IAEI,uBAAuB,CAC5B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,GACzB,OAAO;IA+DV;;;;;;;;;;;;;;;OAeG;IAEI,qBAAqB,CAC1B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,GACzB,OAAO;CAOX"}
+{"version":3,"file":"ItemPoolDetection.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/ItemPoolDetection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,eAAe,EAIhB,MAAM,8BAA8B,CAAC;AActC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAahD,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IAWtD;;;;;OAKG;IAEI,yBAAyB,CAC9B,YAAY,EAAE,YAAY,GACzB,eAAe,EAAE;IAOpB;;;;;;;;;;;OAWG;IAEI,uBAAuB,CAC5B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,GACzB,OAAO;IA+DV;;;;;;;;;;;;;;;OAeG;IAEI,qBAAqB,CAC1B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,GACzB,OAAO;CAOX"}

package/dist/src/classes/features/other/ItemPoolDetection.lua

@@ -20,13 +20,14 @@ local ____ISCFeature = require("src.enums.ISCFeature")
 local ISCFeature = ____ISCFeature.ISCFeature
 local ____collectibleTag = require("src.functions.collectibleTag")
 local collectibleHasTag = ____collectibleTag.collectibleHasTag
+local ____playerCollectibles = require("src.functions.playerCollectibles")
+local anyPlayerHasCollectible = ____playerCollectibles.anyPlayerHasCollectible
 local ____playerDataStructures = require("src.functions.playerDataStructures")
 local mapGetPlayer = ____playerDataStructures.mapGetPlayer
 local mapSetPlayer = ____playerDataStructures.mapSetPlayer
 local ____playerIndex = require("src.functions.playerIndex")
 local getAllPlayers = ____playerIndex.getAllPlayers
 local ____players = require("src.functions.players")
-local anyPlayerHasCollectible = ____players.anyPlayerHasCollectible
 local getPlayersOfType = ____players.getPlayersOfType
 local ____utils = require("src.functions.utils")
 local ____repeat = ____utils["repeat"]

package/dist/src/classes/features/other/Pause.lua

@@ -26,10 +26,10 @@ local ____isaacAPIClass = require("src.functions.isaacAPIClass")
 local isTear = ____isaacAPIClass.isTear
 local ____logMisc = require("src.functions.logMisc")
 local logError = ____logMisc.logError
+local ____playerCollectibles = require("src.functions.playerCollectibles")
+local useActiveItemTemp = ____playerCollectibles.useActiveItemTemp
 local ____playerIndex = require("src.functions.playerIndex")
 local getAllPlayers = ____playerIndex.getAllPlayers
-local ____players = require("src.functions.players")
-local useActiveItemTemp = ____players.useActiveItemTemp
 local ____tstlClass = require("src.functions.tstlClass")
 local getTSTLClassName = ____tstlClass.getTSTLClassName
 local ____utils = require("src.functions.utils")

package/dist/src/classes/features/other/extraConsoleCommands/commands.lua

@@ -76,13 +76,14 @@ local spawnPill = ____pickupsSpecific.spawnPill
 local spawnTrinketFunction = ____pickupsSpecific.spawnTrinket
 local ____pills = require("src.functions.pills")
 local getPillEffectName = ____pills.getPillEffectName
+local ____playerCollectibles = require("src.functions.playerCollectibles")
+local addCollectibleCostume = ____playerCollectibles.addCollectibleCostume
+local removeCollectibleCostume = ____playerCollectibles.removeCollectibleCostume
+local useActiveItemTemp = ____playerCollectibles.useActiveItemTemp
 local ____playerIndex = require("src.functions.playerIndex")
 local getPlayers = ____playerIndex.getPlayers
 local ____players = require("src.functions.players")
-local addCollectibleCostume = ____players.addCollectibleCostume
 local getPlayerName = ____players.getPlayerName
-local removeCollectibleCostume = ____players.removeCollectibleCostume
-local useActiveItemTemp = ____players.useActiveItemTemp
 local ____roomGrid = require("src.functions.roomGrid")
 local gridCoordinatesToWorldPosition = ____roomGrid.gridCoordinatesToWorldPosition
 local ____roomTransition = require("src.functions.roomTransition")

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

@@ -1,4 +1,4 @@
-import type { CollectibleType } from "isaac-typescript-definitions";
+import type { CollectibleType, TrinketType } from "isaac-typescript-definitions";
 import { PlayerType } from "isaac-typescript-definitions";
 /**
  * Helper function to determine if the given character can have red heart containers. Returns true
@@ -53,7 +53,14 @@ export declare function getCharacterName(character: PlayerType): string;
  *
  * Note that this will return an empty array for Eden and Tainted Eden.
  */
-export declare function getCharacterStartingCollectibles(character: PlayerType): readonly CollectibleType[];
+export declare function getCharacterStartingCollectibleTypes(character: PlayerType): readonly CollectibleType[];
+/**
+ * Helper function to get the trinket that is granted to a particular character at the beginning of
+ * a run. Returns undefined if the character does not start with a trinket.
+ *
+ * Note that this will return undefined for Eden and Tainted Eden.
+ */
+export declare function getCharacterStartingTrinketType(character: PlayerType): TrinketType | undefined;
 export declare function isFlyingCharacter(character: PlayerType): boolean;
 /**
  * Helper function to check if the provided character is one of the characters that are selectable

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

@@ -1 +1 @@
-{"version":3,"file":"characters.d.ts","sourceRoot":"","sources":["../../../src/functions/characters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAiB1D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,UAAU,GACpB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE5E;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,UAAU,EACrB,iBAAiB,UAAQ,GACxB,KAAK,CAMP;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAU5E;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CAsBzE;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAM9D;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,UAAU,GACpB,SAAS,eAAe,EAAE,CAE5B;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEjE"}
+{"version":3,"file":"characters.d.ts","sourceRoot":"","sources":["../../../src/functions/characters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAkB1D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,UAAU,GACpB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE5E;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,UAAU,EACrB,iBAAiB,UAAQ,GACxB,KAAK,CAMP;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAU5E;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CAsBzE;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAM9D;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,UAAU,GACpB,SAAS,eAAe,EAAE,CAE5B;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,UAAU,GACpB,WAAW,GAAG,SAAS,CAEzB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEjE"}

package/dist/src/functions/characters.lua

@@ -12,8 +12,10 @@ local ____characterDamageMultipliers = require("src.objects.characterDamageMulti
 local CHARACTER_DAMAGE_MULTIPLIERS = ____characterDamageMultipliers.CHARACTER_DAMAGE_MULTIPLIERS
 local ____characterNames = require("src.objects.characterNames")
 local CHARACTER_NAMES = ____characterNames.CHARACTER_NAMES
-local ____characterStartingCollectibles = require("src.objects.characterStartingCollectibles")
-local CHARACTER_STARTING_COLLECTIBLES = ____characterStartingCollectibles.CHARACTER_STARTING_COLLECTIBLES
+local ____characterStartingCollectibleTypes = require("src.objects.characterStartingCollectibleTypes")
+local CHARACTER_STARTING_COLLECTIBLE_TYPES = ____characterStartingCollectibleTypes.CHARACTER_STARTING_COLLECTIBLE_TYPES
+local ____characterStartingTrinketTypes = require("src.objects.characterStartingTrinketTypes")
+local CHARACTER_STARTING_TRINKET_TYPE = ____characterStartingTrinketTypes.CHARACTER_STARTING_TRINKET_TYPE
 local ____charactersThatStartWithAnActiveItemSet = require("src.sets.charactersThatStartWithAnActiveItemSet")
 local CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET = ____charactersThatStartWithAnActiveItemSet.CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET
 local ____charactersWithBlackHeartFromEternalHeartSet = require("src.sets.charactersWithBlackHeartFromEternalHeartSet")
@@ -118,8 +120,15 @@ end
 -- beginning of a run.
 -- 
 -- Note that this will return an empty array for Eden and Tainted Eden.
-function ____exports.getCharacterStartingCollectibles(self, character)
-    return CHARACTER_STARTING_COLLECTIBLES[character]
+function ____exports.getCharacterStartingCollectibleTypes(self, character)
+    return CHARACTER_STARTING_COLLECTIBLE_TYPES[character]
+end
+--- Helper function to get the trinket that is granted to a particular character at the beginning of
+-- a run. Returns undefined if the character does not start with a trinket.
+-- 
+-- Note that this will return undefined for Eden and Tainted Eden.
+function ____exports.getCharacterStartingTrinketType(self, character)
+    return CHARACTER_STARTING_TRINKET_TYPE[character]
 end
 function ____exports.isFlyingCharacter(self, character)
     return FLYING_CHARACTERS_SET:has(character)

package/dist/src/functions/charge.lua

@@ -14,10 +14,10 @@ local sfxManager = ____cachedClasses.sfxManager
 local ____collectibles = require("src.functions.collectibles")
 local getCollectibleChargeType = ____collectibles.getCollectibleChargeType
 local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
+local ____playerCollectibles = require("src.functions.playerCollectibles")
+local getActiveItemSlots = ____playerCollectibles.getActiveItemSlots
 local ____playerIndex = require("src.functions.playerIndex")
 local getPlayers = ____playerIndex.getPlayers
-local ____players = require("src.functions.players")
-local getActiveItemSlots = ____players.getActiveItemSlots
 local ____roomShape = require("src.functions.roomShape")
 local getRoomShapeCharges = ____roomShape.getRoomShapeCharges
 --- Helper function to add a charge to the player's active item. Will flash the HUD and play the

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

@@ -0,0 +1,127 @@
+import { ActiveSlot, CollectibleType } from "isaac-typescript-definitions";
+/**
+ * Helper function to add one or more collectibles to a player.
+ *
+ * This function is variadic, meaning that you can supply as many collectible types as you want to
+ * add.
+ */
+export declare function addCollectible(player: EntityPlayer, ...collectibleTypes: CollectibleType[]): void;
+export declare function addCollectibleCostume(player: EntityPlayer, collectibleType: CollectibleType): void;
+/**
+ * Helper function to check to see if any player has a particular collectible.
+ *
+ * @param collectibleType The collectible type to check for.
+ * @param ignoreModifiers If set to true, only counts collectibles the player actually owns and
+ *                        ignores effects granted by items like Zodiac, 3 Dollar Bill and Lemegeton.
+ *                        Default is false.
+ */
+export declare function anyPlayerHasCollectible(collectibleType: CollectibleType, ignoreModifiers?: boolean): boolean;
+/**
+ * Helper function to find the active slots that the player has the corresponding collectible type
+ * in. Returns an empty array if the player does not have the collectible in any active slot.
+ */
+export declare function getActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): ActiveSlot[];
+/**
+ * Helper function to return the total amount of collectibles that a player has that match the
+ * collectible type(s) provided.
+ *
+ * This function is variadic, meaning that you can specify N collectible types.
+ *
+ * Note that this will filter out non-real collectibles like Lilith's Incubus.
+ */
+export declare function getPlayerCollectibleCount(player: EntityPlayer, ...collectibleTypes: CollectibleType[]): int;
+/**
+ * Helper function to get only the players that have a certain collectible.
+ *
+ * This function is variadic, meaning that you can supply as many collectible types as you want to
+ * check for. It only returns the players that have all of the collectibles.
+ */
+export declare function getPlayersWithCollectible(...collectibleTypes: CollectibleType[]): EntityPlayer[];
+/**
+ * Returns the total number of collectibles amongst all players. For example, if player 1 has 1 Sad
+ * Onion and player 2 has 2 Sad Onions, then this function would return 3.
+ *
+ * Note that this will filter out non-real collectibles like Lilith's Incubus.
+ */
+export declare function getTotalPlayerCollectibles(collectibleType: CollectibleType): int;
+/**
+ * Helper function to check to see if a player has one or more collectibles.
+ *
+ * This function is variadic, meaning that you can supply as many collectible types as you want to
+ * check for. Returns true if the player has any of the supplied collectible types.
+ *
+ * This function always passes `false` to the `ignoreModifiers` argument.
+ */
+export declare function hasCollectible(player: EntityPlayer, ...collectibleTypes: CollectibleType[]): boolean;
+/**
+ * Helper function to check to see if a player has a specific collectible in one or more active
+ * slots.
+ *
+ * This function is variadic, meaning that you can specify as many active slots as you want to check
+ * for. This function will return true if the collectible type is located in any of the active slots
+ * provided.
+ */
+export declare function hasCollectibleInActiveSlot(player: EntityPlayer, collectibleType: CollectibleType, ...activeSlots: ActiveSlot[]): boolean;
+/**
+ * Returns whether the player can hold an additional active item, beyond what they are currently
+ * carrying. This takes the Schoolbag into account.
+ *
+ * If the player is the Tainted Soul, this always returns false, since that character cannot pick up
+ * items. (Only Tainted Forgotten can pick up items.)
+ */
+export declare function hasOpenActiveItemSlot(player: EntityPlayer): boolean;
+/**
+ * Helper function to check if the active slot of a particular player is empty.
+ *
+ * @param player The player to check.
+ * @param activeSlot Optional. The active slot to check. Default is `ActiveSlot.PRIMARY`.
+ */
+export declare function isActiveSlotEmpty(player: EntityPlayer, activeSlot?: ActiveSlot): boolean;
+/**
+ * Helper function to remove all of the active items from a player. This includes the Schoolbag item
+ * and any pocket actives.
+ */
+export declare function removeAllActiveItems(player: EntityPlayer): void;
+/**
+ * Helper function to remove one or more collectibles to a player.
+ *
+ * This function is variadic, meaning that you can supply as many collectible types as you want to
+ * remove.
+ */
+export declare function removeCollectible(player: EntityPlayer, ...collectibleTypes: CollectibleType[]): void;
+/**
+ * Helper function to remove a collectible costume from a player. Use this helper function to avoid
+ * having to request the collectible from the item config.
+ */
+export declare function removeCollectibleCostume(player: EntityPlayer, collectibleType: CollectibleType): void;
+/**
+ * Helper function to remove one or more collectibles from all players. If any player has more than
+ * one copy of the item, then all copies of it will be removed.
+ *
+ * This function is variadic, meaning that you can specify as many collectibles as you want to
+ * remove.
+ */
+export declare function removeCollectibleFromAllPlayers(...collectibleTypes: CollectibleType[]): void;
+/**
+ * Helper function to set an active collectible to a particular slot. This has different behavior
+ * than calling the `player.AddCollectible` method with the `activeSlot` argument, because this
+ * function will not shift existing items into the Schoolbag and it handles
+ * `ActiveSlot.SLOT_POCKET2`.
+ *
+ * Note that if an item is set to `ActiveSlot.SLOT_POCKET2`, it will disappear after being used and
+ * will be automatically removed upon entering a new room.
+ *
+ * @param player The player to give the item to.
+ * @param collectibleType The collectible type of the item to give.
+ * @param activeSlot Optional. The slot to set. Default is `ActiveSlot.PRIMARY`.
+ * @param charge Optional. The argument of charges to set. If not specified, the item will be set
+ *               with maximum charges.
+ * @param keepInPools Optional. Whether to remove the item from pools. Default is false.
+ */
+export declare function setActiveItem(player: EntityPlayer, collectibleType: CollectibleType, activeSlot?: ActiveSlot, charge?: int, keepInPools?: boolean): void;
+/**
+ * Helper function to use an active item without showing an animation, keeping the item, or adding
+ * any costumes.
+ */
+export declare function useActiveItemTemp(player: EntityPlayer, collectibleType: CollectibleType): void;
+//# sourceMappingURL=playerCollectibles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"playerCollectibles.d.ts","sourceRoot":"","sources":["../../../src/functions/playerCollectibles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EAEhB,MAAM,8BAA8B,CAAC;AAStC;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,GAAG,gBAAgB,EAAE,eAAe,EAAE,GACrC,IAAI,CAIN;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,eAAe,GAC/B,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,EAChC,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,eAAe,GAC/B,UAAU,EAAE,CAKd;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,GAAG,gBAAgB,EAAE,eAAe,EAAE,GACrC,GAAG,CAQL;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,gBAAgB,EAAE,eAAe,EAAE,GACrC,YAAY,EAAE,CAQhB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,eAAe,GAC/B,GAAG,CAQL;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,GAAG,gBAAgB,EAAE,eAAe,EAAE,GACrC,OAAO,CAIT;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,eAAe,EAChC,GAAG,WAAW,EAAE,UAAU,EAAE,GAC3B,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAiBnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAa/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,GAAG,gBAAgB,EAAE,eAAe,EAAE,GACrC,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,eAAe,GAC/B,IAAI,CAON;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,gBAAgB,EAAE,eAAe,EAAE,GACrC,IAAI,CAQN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,eAAe,EAChC,UAAU,aAAqB,EAC/B,MAAM,CAAC,EAAE,GAAG,EACZ,WAAW,UAAQ,GAClB,IAAI,CA6DN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,eAAe,GAC/B,IAAI,CAEN"}

package/dist/src/functions/playerCollectibles.lua

@@ -0,0 +1,308 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArraySome = ____lualib.__TS__ArraySome
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local ____cachedEnumValues = require("src.arrays.cachedEnumValues")
+local ACTIVE_SLOT_VALUES = ____cachedEnumValues.ACTIVE_SLOT_VALUES
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local itemConfig = ____cachedClasses.itemConfig
+local ____ReadonlySet = require("src.types.ReadonlySet")
+local ReadonlySet = ____ReadonlySet.ReadonlySet
+local ____array = require("src.functions.array")
+local sumArray = ____array.sumArray
+local ____collectibles = require("src.functions.collectibles")
+local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
+local ____playerIndex = require("src.functions.playerIndex")
+local getAllPlayers = ____playerIndex.getAllPlayers
+local getPlayers = ____playerIndex.getPlayers
+local ____players = require("src.functions.players")
+local isCharacter = ____players.isCharacter
+--- Helper function to add one or more collectibles to a player.
+-- 
+-- This function is variadic, meaning that you can supply as many collectible types as you want to
+-- add.
+function ____exports.addCollectible(self, player, ...)
+    local collectibleTypes = {...}
+    for ____, collectibleType in ipairs(collectibleTypes) do
+        player:AddCollectible(collectibleType)
+    end
+end
+function ____exports.addCollectibleCostume(self, player, collectibleType)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return
+    end
+    player:AddCostume(itemConfigItem, false)
+end
+--- Helper function to check to see if any player has a particular collectible.
+-- 
+-- @param collectibleType The collectible type to check for.
+-- @param ignoreModifiers If set to true, only counts collectibles the player actually owns and
+-- ignores effects granted by items like Zodiac, 3 Dollar Bill and Lemegeton.
+-- Default is false.
+function ____exports.anyPlayerHasCollectible(self, collectibleType, ignoreModifiers)
+    local players = getAllPlayers(nil)
+    return __TS__ArraySome(
+        players,
+        function(____, player) return player:HasCollectible(collectibleType, ignoreModifiers) end
+    )
+end
+--- Helper function to find the active slots that the player has the corresponding collectible type
+-- in. Returns an empty array if the player does not have the collectible in any active slot.
+function ____exports.getActiveItemSlots(self, player, collectibleType)
+    return __TS__ArrayFilter(
+        ACTIVE_SLOT_VALUES,
+        function(____, activeSlot)
+            local activeItem = player:GetActiveItem(activeSlot)
+            return activeItem == collectibleType
+        end
+    )
+end
+--- Helper function to return the total amount of collectibles that a player has that match the
+-- collectible type(s) provided.
+-- 
+-- This function is variadic, meaning that you can specify N collectible types.
+-- 
+-- Note that this will filter out non-real collectibles like Lilith's Incubus.
+function ____exports.getPlayerCollectibleCount(self, player, ...)
+    local collectibleTypes = {...}
+    local numCollectibles = 0
+    for ____, collectibleType in ipairs(collectibleTypes) do
+        numCollectibles = numCollectibles + player:GetCollectibleNum(collectibleType, true)
+    end
+    return numCollectibles
+end
+--- Helper function to get only the players that have a certain collectible.
+-- 
+-- This function is variadic, meaning that you can supply as many collectible types as you want to
+-- check for. It only returns the players that have all of the collectibles.
+function ____exports.getPlayersWithCollectible(self, ...)
+    local collectibleTypes = {...}
+    local players = getPlayers(nil)
+    return __TS__ArrayFilter(
+        players,
+        function(____, player) return __TS__ArrayEvery(
+            collectibleTypes,
+            function(____, collectibleType) return player:HasCollectible(collectibleType) end
+        ) end
+    )
+end
+--- Returns the total number of collectibles amongst all players. For example, if player 1 has 1 Sad
+-- Onion and player 2 has 2 Sad Onions, then this function would return 3.
+-- 
+-- Note that this will filter out non-real collectibles like Lilith's Incubus.
+function ____exports.getTotalPlayerCollectibles(self, collectibleType)
+    local players = getPlayers(nil)
+    local numCollectiblesArray = __TS__ArrayMap(
+        players,
+        function(____, player) return player:GetCollectibleNum(collectibleType, true) end
+    )
+    return sumArray(nil, numCollectiblesArray)
+end
+--- Helper function to check to see if a player has one or more collectibles.
+-- 
+-- This function is variadic, meaning that you can supply as many collectible types as you want to
+-- check for. Returns true if the player has any of the supplied collectible types.
+-- 
+-- This function always passes `false` to the `ignoreModifiers` argument.
+function ____exports.hasCollectible(self, player, ...)
+    local collectibleTypes = {...}
+    return __TS__ArraySome(
+        collectibleTypes,
+        function(____, collectibleType) return player:HasCollectible(collectibleType) end
+    )
+end
+--- Helper function to check to see if a player has a specific collectible in one or more active
+-- slots.
+-- 
+-- This function is variadic, meaning that you can specify as many active slots as you want to check
+-- for. This function will return true if the collectible type is located in any of the active slots
+-- provided.
+function ____exports.hasCollectibleInActiveSlot(self, player, collectibleType, ...)
+    local activeSlots = {...}
+    local matchingActiveSlotsSet = __TS__New(ReadonlySet, activeSlots)
+    local activeItemSlots = ____exports.getActiveItemSlots(nil, player, collectibleType)
+    return __TS__ArraySome(
+        activeItemSlots,
+        function(____, activeSlot) return matchingActiveSlotsSet:has(activeSlot) end
+    )
+end
+--- Returns whether the player can hold an additional active item, beyond what they are currently
+-- carrying. This takes the Schoolbag into account.
+-- 
+-- If the player is the Tainted Soul, this always returns false, since that character cannot pick up
+-- items. (Only Tainted Forgotten can pick up items.)
+function ____exports.hasOpenActiveItemSlot(self, player)
+    if isCharacter(nil, player, PlayerType.SOUL_B) then
+        return false
+    end
+    local activeItemPrimary = player:GetActiveItem(ActiveSlot.PRIMARY)
+    local activeItemSecondary = player:GetActiveItem(ActiveSlot.SECONDARY)
+    local hasSchoolbag = player:HasCollectible(CollectibleType.SCHOOLBAG)
+    if hasSchoolbag then
+        return activeItemPrimary == CollectibleType.NULL or activeItemSecondary == CollectibleType.NULL
+    end
+    return activeItemPrimary == CollectibleType.NULL
+end
+--- Helper function to check if the active slot of a particular player is empty.
+-- 
+-- @param player The player to check.
+-- @param activeSlot Optional. The active slot to check. Default is `ActiveSlot.PRIMARY`.
+function ____exports.isActiveSlotEmpty(self, player, activeSlot)
+    if activeSlot == nil then
+        activeSlot = ActiveSlot.PRIMARY
+    end
+    local activeCollectibleType = player:GetActiveItem(activeSlot)
+    return activeCollectibleType == CollectibleType.NULL
+end
+--- Helper function to remove all of the active items from a player. This includes the Schoolbag item
+-- and any pocket actives.
+function ____exports.removeAllActiveItems(self, player)
+    for ____, activeSlot in ipairs(ACTIVE_SLOT_VALUES) do
+        do
+            local collectibleType = player:GetActiveItem(activeSlot)
+            if collectibleType == CollectibleType.NULL then
+                goto __continue28
+            end
+            local stillHasCollectible
+            repeat
+                do
+                    player:RemoveCollectible(collectibleType)
+                    stillHasCollectible = player:HasCollectible(collectibleType)
+                end
+            until not stillHasCollectible
+        end
+        ::__continue28::
+    end
+end
+--- Helper function to remove one or more collectibles to a player.
+-- 
+-- This function is variadic, meaning that you can supply as many collectible types as you want to
+-- remove.
+function ____exports.removeCollectible(self, player, ...)
+    local collectibleTypes = {...}
+    for ____, collectibleType in ipairs(collectibleTypes) do
+        player:RemoveCollectible(collectibleType)
+    end
+end
+--- Helper function to remove a collectible costume from a player. Use this helper function to avoid
+-- having to request the collectible from the item config.
+function ____exports.removeCollectibleCostume(self, player, collectibleType)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return
+    end
+    player:RemoveCostume(itemConfigItem)
+end
+--- Helper function to remove one or more collectibles from all players. If any player has more than
+-- one copy of the item, then all copies of it will be removed.
+-- 
+-- This function is variadic, meaning that you can specify as many collectibles as you want to
+-- remove.
+function ____exports.removeCollectibleFromAllPlayers(self, ...)
+    local collectibleTypes = {...}
+    for ____, player in ipairs(getAllPlayers(nil)) do
+        for ____, collectibleType in ipairs(collectibleTypes) do
+            while player:HasCollectible(collectibleType, true) do
+                player:RemoveCollectible(collectibleType)
+            end
+        end
+    end
+end
+--- Helper function to set an active collectible to a particular slot. This has different behavior
+-- than calling the `player.AddCollectible` method with the `activeSlot` argument, because this
+-- function will not shift existing items into the Schoolbag and it handles
+-- `ActiveSlot.SLOT_POCKET2`.
+-- 
+-- Note that if an item is set to `ActiveSlot.SLOT_POCKET2`, it will disappear after being used and
+-- will be automatically removed upon entering a new room.
+-- 
+-- @param player The player to give the item to.
+-- @param collectibleType The collectible type of the item to give.
+-- @param activeSlot Optional. The slot to set. Default is `ActiveSlot.PRIMARY`.
+-- @param charge Optional. The argument of charges to set. If not specified, the item will be set
+-- with maximum charges.
+-- @param keepInPools Optional. Whether to remove the item from pools. Default is false.
+function ____exports.setActiveItem(self, player, collectibleType, activeSlot, charge, keepInPools)
+    if activeSlot == nil then
+        activeSlot = ActiveSlot.PRIMARY
+    end
+    if keepInPools == nil then
+        keepInPools = false
+    end
+    local itemPool = game:GetItemPool()
+    local primaryCollectibleType = player:GetActiveItem(ActiveSlot.PRIMARY)
+    local primaryCharge = player:GetActiveCharge(ActiveSlot.PRIMARY)
+    local secondaryCollectibleType = player:GetActiveItem(ActiveSlot.SECONDARY)
+    if charge == nil then
+        charge = getCollectibleMaxCharges(nil, collectibleType)
+    end
+    if not keepInPools then
+        itemPool:RemoveCollectible(collectibleType)
+    end
+    repeat
+        local ____switch46 = activeSlot
+        local ____cond46 = ____switch46 == ActiveSlot.PRIMARY
+        if ____cond46 then
+            do
+                if primaryCollectibleType ~= CollectibleType.NULL then
+                    player:RemoveCollectible(primaryCollectibleType)
+                end
+                player:AddCollectible(collectibleType, charge, false)
+                break
+            end
+        end
+        ____cond46 = ____cond46 or ____switch46 == ActiveSlot.SECONDARY
+        if ____cond46 then
+            do
+                if primaryCollectibleType ~= CollectibleType.NULL then
+                    player:RemoveCollectible(primaryCollectibleType)
+                end
+                if secondaryCollectibleType ~= CollectibleType.NULL then
+                    player:RemoveCollectible(secondaryCollectibleType)
+                end
+                player:AddCollectible(secondaryCollectibleType, charge, false)
+                if primaryCollectibleType ~= CollectibleType.NULL then
+                    player:AddCollectible(primaryCollectibleType, primaryCharge, false)
+                end
+                break
+            end
+        end
+        ____cond46 = ____cond46 or ____switch46 == ActiveSlot.POCKET
+        if ____cond46 then
+            do
+                player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
+                player:SetActiveCharge(charge, activeSlot)
+                break
+            end
+        end
+        ____cond46 = ____cond46 or ____switch46 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond46 then
+            do
+                player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
+                break
+            end
+        end
+    until true
+end
+--- Helper function to use an active item without showing an animation, keeping the item, or adding
+-- any costumes.
+function ____exports.useActiveItemTemp(self, player, collectibleType)
+    player:UseActiveItem(
+        collectibleType,
+        false,
+        false,
+        true,
+        false,
+        -1
+    )
+end
+return ____exports

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

@@ -1 +1 @@
-{"version":3,"file":"playerHealth.d.ts","sourceRoot":"","sources":["../../../src/functions/playerHealth.ts"],"names":[],"mappings":";;AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,4BAA4B,CAAC;AAY9E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,GAAG,GACb,IAAI,CA+CN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA2ElE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAmDL;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAKzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAoDnE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAqCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,YAAY,GACnB,GAAG,CAML;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,GACzB,IAAI,CAyHN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sDAAsD,CACpE,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,KAAK,GAClB,OAAO,CAyBT"}
+{"version":3,"file":"playerHealth.d.ts","sourceRoot":"","sources":["../../../src/functions/playerHealth.ts"],"names":[],"mappings":";;AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,4BAA4B,CAAC;AAQ9E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,GAAG,GACb,IAAI,CA+CN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA2ElE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAmDL;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAKzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAoDnE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAqCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,YAAY,GACnB,GAAG,CAML;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,GACzB,IAAI,CAyHN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sDAAsD,CACpE,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,KAAK,GAClB,OAAO,CAyBT"}

package/dist/src/functions/playerHealth.lua

@@ -20,11 +20,12 @@ local ____characters = require("src.functions.characters")
 local getCharacterMaxHeartContainers = ____characters.getCharacterMaxHeartContainers
 local ____charge = require("src.functions.charge")
 local getTotalCharge = ____charge.getTotalCharge
+local ____playerCollectibles = require("src.functions.playerCollectibles")
+local getActiveItemSlots = ____playerCollectibles.getActiveItemSlots
+local setActiveItem = ____playerCollectibles.setActiveItem
 local ____players = require("src.functions.players")
-local getActiveItemSlots = ____players.getActiveItemSlots
 local isCharacter = ____players.isCharacter
 local isKeeper = ____players.isKeeper
-local setActiveItem = ____players.setActiveItem
 local ____utils = require("src.functions.utils")
 local ____repeat = ____utils["repeat"]
 --- Returns the number of black hearts that the player has, excluding any soul hearts. For example,