isaacscript-common 76.0.0 → 76.1.0

package/dist/functions/cards.d.ts

@@ -25,6 +25,14 @@ export declare function getCardName(cardType: CardType): string;
  * Returns undefined if the provided card type was not valid.
  */
 export declare function getItemConfigCardType(cardType: CardType): ItemConfigCardType | undefined;
+/**
+ * Helper function to check if a player is holding a specific card in one of their pocket item
+ * slots.
+ *
+ * This function is variadic, meaning that you can pass as many cards as you want to check for. The
+ * function will return true if the player has any of the cards.
+ */
+export declare function hasCard(player: EntityPlayer, ...cardTypes: CardType[]): boolean;
 /**
  * Returns true for card types that have the following item config card type:
  *

package/dist/functions/cards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/functions/cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAW,MAAM,8BAA8B,CAAC;AAW3E;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAgB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAgBtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,GACjB,kBAAkB,GAAG,SAAS,CAOhC;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAOlD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAET;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE5D;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAElD;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAG1E"}
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/functions/cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAW,MAAM,8BAA8B,CAAC;AAY3E;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAgB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAgBtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,GACjB,kBAAkB,GAAG,SAAS,CAOhC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,YAAY,EACpB,GAAG,SAAS,EAAE,QAAQ,EAAE,GACvB,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAOlD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAET;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE5D;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAElD;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAG1E"}

package/dist/functions/cards.lua

@@ -1,7 +1,13 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local ItemConfigCardType = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigCardType
 local UseFlag = ____isaac_2Dtypescript_2Ddefinitions.UseFlag
+local ____cachedEnumValues = require("arrays.cachedEnumValues")
+local POCKET_ITEM_SLOT_VALUES = ____cachedEnumValues.POCKET_ITEM_SLOT_VALUES
 local ____cachedClasses = require("core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constantsFirstLast = require("core.constantsFirstLast")
@@ -64,6 +70,22 @@ function ____exports.getItemConfigCardType(self, cardType)
     end
     return itemConfigCard.CardType
 end
+--- Helper function to check if a player is holding a specific card in one of their pocket item
+-- slots.
+-- 
+-- This function is variadic, meaning that you can pass as many cards as you want to check for. The
+-- function will return true if the player has any of the cards.
+function ____exports.hasCard(self, player, ...)
+    local cardTypes = {...}
+    local cardTypesSet = __TS__New(Set, cardTypes)
+    return __TS__ArraySome(
+        POCKET_ITEM_SLOT_VALUES,
+        function(____, pocketItemSlot)
+            local cardType = player:GetCard(pocketItemSlot)
+            return cardTypesSet:has(cardType)
+        end
+    )
+end
 --- Returns true for card types that have the following item config card type:
 -- 
 -- - `ItemConfigCardType.TAROT` (0)

package/dist/functions/tears.d.ts

@@ -35,8 +35,12 @@ export declare function getTearsStat(fireDelay: float): float;
  * Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
  * ground, a wall, or a grid entity.
  *
- * Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
- * die if they hit an enemy, but they will die if they hit a wall or object.)
+ * Note that tears are still considered to be missed if they hit a poop or fire, so you may want to
+ * handle those separately using the `POST_GRID_ENTITY_COLLISION` and `POST_ENTITY_COLLISION`
+ * callbacks, respectively.
+ *
+ * Under the hood, this function uses the `Entity.IsDead` method. (Tears will not die if they hit an
+ * enemy, but they will die if they hit a wall or object.)
  */
 export declare function isMissedTear(tear: EntityTear): boolean;
 /**

package/dist/functions/tears.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../src/functions/tears.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAuBT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}
+{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../src/functions/tears.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAuBT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}

package/dist/functions/tears.lua

@@ -37,8 +37,12 @@ end
 --- Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
 -- ground, a wall, or a grid entity.
 -- 
--- Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
--- die if they hit an enemy, but they will die if they hit a wall or object.)
+-- Note that tears are still considered to be missed if they hit a poop or fire, so you may want to
+-- handle those separately using the `POST_GRID_ENTITY_COLLISION` and `POST_ENTITY_COLLISION`
+-- callbacks, respectively.
+-- 
+-- Under the hood, this function uses the `Entity.IsDead` method. (Tears will not die if they hit an
+-- enemy, but they will die if they hit a wall or object.)
 function ____exports.isMissedTear(self, tear)
     return tear:IsDead()
 end

package/dist/index.rollup.d.ts

@@ -8189,6 +8189,15 @@ export declare function hasAnyTrinket(player: EntityPlayer): boolean;
  */
 export declare function hasArmor(entity: Entity): boolean;
 
+/**
+ * Helper function to check if a player is holding a specific card in one of their pocket item
+ * slots.
+ *
+ * This function is variadic, meaning that you can pass as many cards as you want to check for. The
+ * function will return true if the player has any of the cards.
+ */
+export declare function hasCard(player: EntityPlayer, ...cardTypes: CardType[]): boolean;
+
 /**
  * Helper function to check to see if a player has one or more collectibles.
  *
@@ -9564,8 +9573,12 @@ export declare function isMirrorRoom(roomData: RoomConfig): boolean;
  * Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
  * ground, a wall, or a grid entity.
  *
- * Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
- * die if they hit an enemy, but they will die if they hit a wall or object.)
+ * Note that tears are still considered to be missed if they hit a poop or fire, so you may want to
+ * handle those separately using the `POST_GRID_ENTITY_COLLISION` and `POST_ENTITY_COLLISION`
+ * callbacks, respectively.
+ *
+ * Under the hood, this function uses the `Entity.IsDead` method. (Tears will not die if they hit an
+ * enemy, but they will die if they hit a wall or object.)
  */
 export declare function isMissedTear(tear: EntityTear): boolean;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 75.2.1
+isaacscript-common 76.0.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -34799,8 +34799,12 @@ end
 --- Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
 -- ground, a wall, or a grid entity.
 -- 
--- Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
--- die if they hit an enemy, but they will die if they hit a wall or object.)
+-- Note that tears are still considered to be missed if they hit a poop or fire, so you may want to
+-- handle those separately using the `POST_GRID_ENTITY_COLLISION` and `POST_ENTITY_COLLISION`
+-- callbacks, respectively.
+-- 
+-- Under the hood, this function uses the `Entity.IsDead` method. (Tears will not die if they hit an
+-- enemy, but they will die if they hit a wall or object.)
 function ____exports.isMissedTear(self, tear)
     return tear:IsDead()
 end
@@ -43160,10 +43164,16 @@ ____exports.ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET = __TS__New(ReadonlySet, {ItemC
 return ____exports
  end,
 ["functions.cards"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.index")
 local ItemConfigCardType = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigCardType
 local UseFlag = ____isaac_2Dtypescript_2Ddefinitions.UseFlag
+local ____cachedEnumValues = require("arrays.cachedEnumValues")
+local POCKET_ITEM_SLOT_VALUES = ____cachedEnumValues.POCKET_ITEM_SLOT_VALUES
 local ____cachedClasses = require("core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constantsFirstLast = require("core.constantsFirstLast")
@@ -43226,6 +43236,22 @@ function ____exports.getItemConfigCardType(self, cardType)
     end
     return itemConfigCard.CardType
 end
+--- Helper function to check if a player is holding a specific card in one of their pocket item
+-- slots.
+-- 
+-- This function is variadic, meaning that you can pass as many cards as you want to check for. The
+-- function will return true if the player has any of the cards.
+function ____exports.hasCard(self, player, ...)
+    local cardTypes = {...}
+    local cardTypesSet = __TS__New(Set, cardTypes)
+    return __TS__ArraySome(
+        POCKET_ITEM_SLOT_VALUES,
+        function(____, pocketItemSlot)
+            local cardType = player:GetCard(pocketItemSlot)
+            return cardTypesSet:has(cardType)
+        end
+    )
+end
 --- Returns true for card types that have the following item config card type:
 -- 
 -- - `ItemConfigCardType.TAROT` (0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "76.0.0",
+  "version": "76.1.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/functions/cards.ts

@@ -1,5 +1,6 @@
 import type { CardType } from "isaac-typescript-definitions";
 import { ItemConfigCardType, UseFlag } from "isaac-typescript-definitions";
+import { POCKET_ITEM_SLOT_VALUES } from "../arrays/cachedEnumValues";
 import { itemConfig } from "../core/cachedClasses";
 import { LAST_VANILLA_CARD_TYPE } from "../core/constantsFirstLast";
 import {
@@ -79,6 +80,24 @@ export function getItemConfigCardType(
   return itemConfigCard.CardType;
 }
 
+/**
+ * Helper function to check if a player is holding a specific card in one of their pocket item
+ * slots.
+ *
+ * This function is variadic, meaning that you can pass as many cards as you want to check for. The
+ * function will return true if the player has any of the cards.
+ */
+export function hasCard(
+  player: EntityPlayer,
+  ...cardTypes: CardType[]
+): boolean {
+  const cardTypesSet = new Set(cardTypes);
+  return POCKET_ITEM_SLOT_VALUES.some((pocketItemSlot) => {
+    const cardType = player.GetCard(pocketItemSlot);
+    return cardTypesSet.has(cardType);
+  });
+}
+
 /**
  * Returns true for card types that have the following item config card type:
  *

package/src/functions/tears.ts

@@ -48,8 +48,12 @@ export function getTearsStat(fireDelay: float): float {
  * Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
  * ground, a wall, or a grid entity.
  *
- * Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
- * die if they hit an enemy, but they will die if they hit a wall or object.)
+ * Note that tears are still considered to be missed if they hit a poop or fire, so you may want to
+ * handle those separately using the `POST_GRID_ENTITY_COLLISION` and `POST_ENTITY_COLLISION`
+ * callbacks, respectively.
+ *
+ * Under the hood, this function uses the `Entity.IsDead` method. (Tears will not die if they hit an
+ * enemy, but they will die if they hit a wall or object.)
  */
 export function isMissedTear(tear: EntityTear): boolean {
   return tear.IsDead();