isaacscript-common 1.0.478 → 1.0.479

package/dist/functions/cards.d.ts

@@ -0,0 +1,45 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * This is a helper function to get a card name from a Card.
+ *
+ * Example:
+ * ```
+ * const card = Card.CARD_FOOL;
+ * const cardName = getCardName(card); // cardName is "0 - The Fool"
+ * ```
+ */
+export declare function getCardDescription(card: Card | int): string;
+/**
+ * This is a helper function to get a card name from a Card.
+ *
+ * Example:
+ * ```
+ * const card = Card.CARD_FOOL;
+ * const cardName = getCardName(card); // cardName is "0 - The Fool"
+ * ```
+ */
+export declare function getCardName(card: Card | int): string;
+/**
+ * Has an equal chance of returning any card (e.g. Fool, Reverse Fool, Wild Card, etc.). This will
+ * not return any runes or objects.
+ */
+export declare function getRandomCard(seed?: number): Card;
+/**
+ * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul of
+ * Isaac, etc.). This will never return a Rune Shard.
+ */
+export declare function getRandomRune(seed?: number): Card;
+/**
+ * Returns true for entries in the Card enum that are not a rune or an object (e.g. Fool, Reverse
+ * Fool, Wild Card, etc.).
+ */
+export declare function isCard(card: Card): boolean;
+/**
+ * Returns true for entries in the Card enum that are not a card and not a rune (like Dice Shard).
+ */
+export declare function isNotCardOrRune(card: Card): boolean;
+/**
+ * Returns true for entries in the Card enum that are a rune. (e.g. Rune of Hagalaz, Blank Rune,
+ * Black Rune, Rune Shard, Soul of Isaac, etc.)
+ */
+export declare function isRune(card: Card): boolean;

package/dist/functions/cards.lua

@@ -0,0 +1,77 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____cardDescriptionMap = require("maps.cardDescriptionMap")
+local CARD_DESCRIPTION_MAP = ____cardDescriptionMap.CARD_DESCRIPTION_MAP
+local ____cardNameMap = require("maps.cardNameMap")
+local CARD_NAME_MAP = ____cardNameMap.CARD_NAME_MAP
+local ____random = require("functions.random")
+local getRandomInt = ____random.getRandomInt
+local nextSeed = ____random.nextSeed
+function ____exports.isCard(self, card)
+    return ____exports.isNotCardOrRune(nil, card) and (not ____exports.isRune(nil, card))
+end
+function ____exports.isNotCardOrRune(self, card)
+    return ((card == Card.CARD_DICE_SHARD) or (card == Card.CARD_EMERGENCY_CONTACT)) or (card == Card.CARD_CRACKED_KEY)
+end
+function ____exports.isRune(self, card)
+    return (((card >= Card.RUNE_HAGALAZ) and (card <= Card.RUNE_BLACK)) or (card == Card.RUNE_SHARD)) or ((card >= Card.CARD_SOUL_ISAAC) and (card <= Card.CARD_SOUL_JACOB))
+end
+function ____exports.getCardDescription(self, card)
+    local itemConfig = Isaac.GetItemConfig()
+    local defaultDescription = "Unknown"
+    if type(card) ~= "number" then
+        return defaultDescription
+    end
+    local cardDescription = CARD_DESCRIPTION_MAP:get(card)
+    if cardDescription ~= nil then
+        return cardDescription
+    end
+    local itemConfigCard = itemConfig:GetCard(card)
+    if itemConfigCard == nil then
+        return defaultDescription
+    end
+    return itemConfigCard.Description
+end
+function ____exports.getCardName(self, card)
+    local itemConfig = Isaac.GetItemConfig()
+    local defaultName = "Unknown"
+    if type(card) ~= "number" then
+        return defaultName
+    end
+    local cardName = CARD_NAME_MAP:get(card)
+    if cardName ~= nil then
+        return cardName
+    end
+    local itemConfigCard = itemConfig:GetCard(card)
+    if itemConfigCard == nil then
+        return defaultName
+    end
+    return itemConfigCard.Name
+end
+function ____exports.getRandomCard(self, seed)
+    if seed == nil then
+        seed = Random()
+    end
+    local card
+    repeat
+        do
+            seed = nextSeed(nil, seed)
+            card = getRandomInt(nil, 1, Card.NUM_CARDS - 1)
+        end
+    until ____exports.isCard(nil, card)
+    return card
+end
+function ____exports.getRandomRune(self, seed)
+    if seed == nil then
+        seed = Random()
+    end
+    local card
+    repeat
+        do
+            seed = nextSeed(nil, seed)
+            card = getRandomInt(nil, 1, Card.NUM_CARDS - 1)
+        end
+    until not ((not ____exports.isRune(nil, card)) or (card == Card.RUNE_SHARD))
+    return card
+end
+return ____exports

package/dist/functions/pills.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * This is a helper function to get a pill effect name from a PillEffect.
+ *
+ * Example:
+ * ```
+ * const pillEffect = PillEffect.PILLEFFECT_BAD_GAS;
+ * const pillEffectName = getPillEffectName(pillEffect); // trinketName is "Bad Gas"
+ * ```
+ */
+export declare function getPillEffectName(pillEffect: PillEffect | int): string;

package/dist/functions/pills.lua

@@ -0,0 +1,21 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____pillEffectNameMap = require("maps.pillEffectNameMap")
+local PILL_EFFECT_NAME_MAP = ____pillEffectNameMap.PILL_EFFECT_NAME_MAP
+function ____exports.getPillEffectName(self, pillEffect)
+    local itemConfig = Isaac.GetItemConfig()
+    local defaultName = "Unknown"
+    if type(pillEffect) ~= "number" then
+        return defaultName
+    end
+    local pillEffectName = PILL_EFFECT_NAME_MAP:get(pillEffect)
+    if pillEffectName ~= nil then
+        return pillEffectName
+    end
+    local itemConfigPillEffect = itemConfig:GetPillEffect(pillEffect)
+    if itemConfigPillEffect == nil then
+        return defaultName
+    end
+    return itemConfigPillEffect.Name
+end
+return ____exports

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export * from "./features/saveDataManager/exports";
 export { hasSirenStolenFamiliar, setFamiliarNoSirenSteal, } from "./features/sirenHelpers";
 export * from "./functions/array";
 export * from "./functions/bitwise";
-export * from "./functions/card";
+export * from "./functions/cards";
 export * from "./functions/charge";
 export * from "./functions/collectibles";
 export * from "./functions/collectibleSet";
@@ -29,9 +29,9 @@ export * from "./functions/log";
 export * from "./functions/math";
 export * from "./functions/npc";
 export * from "./functions/pickups";
+export * from "./functions/pills";
 export * from "./functions/player";
 export * from "./functions/playerHealth";
-export * from "./functions/pocketItems";
 export * from "./functions/position";
 export * from "./functions/random";
 export * from "./functions/revive";

package/dist/index.lua

@@ -93,7 +93,7 @@ do
     end
 end
 do
-    local ____export = require("functions.card")
+    local ____export = require("functions.cards")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -239,7 +239,7 @@ do
     end
 end
 do
-    local ____export = require("functions.player")
+    local ____export = require("functions.pills")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -247,7 +247,7 @@ do
     end
 end
 do
-    local ____export = require("functions.playerHealth")
+    local ____export = require("functions.player")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -255,7 +255,7 @@ do
     end
 end
 do
-    local ____export = require("functions.pocketItems")
+    local ____export = require("functions.playerHealth")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue

package/dist/maps/cardDescriptionMap.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare const CARD_DESCRIPTION_MAP: Map<Card, string>;

package/dist/maps/cardDescriptionMap.lua

@@ -0,0 +1,5 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+require("lualib_bundle");
+local ____exports = {}
+____exports.CARD_DESCRIPTION_MAP = __TS__New(Map, {{1, "Where journey begins"}, {2, "May you never miss your goal"}, {3, "Mother is watching you"}, {4, "May your rage bring power"}, {5, "Challenge me!"}, {6, "Two prayers for the lost"}, {7, "May you prosper and be in good health"}, {8, "May nothing stand before you"}, {9, "May your future become balanced"}, {10, "May you see what life has to offer"}, {11, "Spin the wheel of destiny"}, {12, "May your power bring rage"}, {13, "May you find enlightenment "}, {14, "Lay waste to all that oppose you "}, {15, "May you be pure in heart"}, {16, "Revel in the power of darkness"}, {17, "Destruction brings creation"}, {18, "May you find what you desire "}, {19, "May you find all you have lost"}, {20, "May the light heal and enlighten you"}, {21, "Judge lest ye be judged"}, {22, "Open your eyes and see"}, {23, "Item multiplier"}, {24, "Item multiplier"}, {25, "Item multiplier"}, {26, "Item multiplier"}, {27, "Convert all"}, {28, "Convert all"}, {29, "Convert all"}, {30, "Convert all"}, {31, "???"}, {32, "Destruction"}, {33, "Abundance"}, {34, "Passage"}, {35, "Purity"}, {36, "Vision"}, {37, "Change"}, {38, "Companionship"}, {39, "Resistance"}, {40, "???"}, {41, "Void"}, {42, "???"}, {43, "Charge it!"}, {44, "???"}, {45, "Something stinks..."}, {46, "A true ending?"}, {47, "Open Sesame"}, {48, "Double active"}, {49, "D6 + D20"}, {50, "Help from above"}, {51, "You feel protected"}, {52, "Become immense!"}, {53, "Draw 3 cards"}, {54, "Savor the moment"}, {55, "It still glows faintly"}, {56, "Let go and move on"}, {57, "May no harm come to you"}, {58, "Run"}, {59, "May your love bring protection"}, {60, "May you find a worthy opponent"}, {61, "Two prayers for the forgotten"}, {62, "May your heart shatter into pieces"}, {63, "May nothing walk past you"}, {64, "May your sins come back to torment you"}, {65, "May you see the value of all things in life"}, {66, "Throw the dice of fate"}, {67, "May you break their resolve"}, {68, "May your greed know no bounds"}, {69, "May life spring forth from the fallen"}, {70, "May your hunger be satiated"}, {71, "Bask in the light of your mercy"}, {72, "Creation brings destruction"}, {73, "May your loss bring fortune"}, {74, "May you remember lost memories"}, {75, "May the darkness swallow all around you"}, {76, "May you redeem those found wanting"}, {77, "Step into the abyss"}, {78, "???"}, {79, "<3"}, {80, "Again"}, {81, "Reroll... or not"}, {82, "Give me your love!"}, {83, "Opens the unopenable"}, {84, "Right behind you"}, {85, "Chemical warfare"}, {86, "Your very own murder"}, {87, "Slay a thousand"}, {88, "Demon rage!"}, {89, "Life after death"}, {90, "Embrace chaos"}, {91, "Leave your body behind"}, {92, "Motherhood"}, {93, "$$$"}, {94, "Bringer of calamity"}, {95, "Skeletal protector"}, {96, "Friends from beyond"}, {97, "Bound by blood"}})
+return ____exports

package/dist/maps/trinketDescriptionMap.d.ts

@@ -1,2 +1,2 @@
 /// <reference types="isaac-typescript-definitions" />
-export declare const TRINKET_DESCRIPTION_MAP: Map<CollectibleType, string>;
+export declare const TRINKET_DESCRIPTION_MAP: Map<TrinketType, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.0.478",
+  "version": "1.0.479",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",