isaacscript-common 1.2.191 → 1.2.194

package/dist/functions/player.d.ts

@@ -46,6 +46,11 @@ export declare function characterCanHaveSoulHearts(character: PlayerType | int):
  * Otherwise, returns false.
  */
 export declare function characterGetsBlackHeartFromEternalHeart(character: PlayerType | int): boolean;
+/**
+ * Helper function to find the active slot that the player has the corresponding collectible type
+ * in. Returns undefined if the player does not have the collectible in any active slot.
+ */
+export declare function getActiveItemSlot(player: EntityPlayer, collectibleType: CollectibleType | int): ActiveSlot | undefined;
 /**
  * Helper function to get every player with no restrictions, by using `Game.GetNumPlayers` and
  * `Isaac.GetPlayer`.

package/dist/functions/player.lua

@@ -2,9 +2,9 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArraySome = ____lualib.__TS__ArraySome
+local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
-local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local Map = ____lualib.Map
 local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
@@ -39,6 +39,7 @@ local ____collectibleSet = require("functions.collectibleSet")
 local getCollectibleSet = ____collectibleSet.getCollectibleSet
 local ____utils = require("functions.utils")
 local ensureAllCases = ____utils.ensureAllCases
+local getEnumValues = ____utils.getEnumValues
 local ____repeat = ____utils["repeat"]
 function ____exports.getAllPlayers(self)
     local numPlayers = game:GetNumPlayers()
@@ -95,15 +96,15 @@ end
 function getPlayerIndexCollectibleType(self, player, differentiateForgottenAndSoul)
     local character = player:GetPlayerType()
     repeat
-        local ____switch71 = character
-        local ____cond71 = ____switch71 == PlayerType.PLAYER_THESOUL
-        if ____cond71 then
+        local ____switch73 = character
+        local ____cond73 = ____switch73 == PlayerType.PLAYER_THESOUL
+        if ____cond73 then
             do
                 return differentiateForgottenAndSoul and CollectibleType.COLLECTIBLE_SPOON_BENDER or DEFAULT_COLLECTIBLE_TYPE
             end
         end
-        ____cond71 = ____cond71 or ____switch71 == PlayerType.PLAYER_LAZARUS2_B
-        if ____cond71 then
+        ____cond73 = ____cond73 or ____switch73 == PlayerType.PLAYER_LAZARUS2_B
+        if ____cond73 then
             do
                 return CollectibleType.COLLECTIBLE_INNER_EYE
             end
@@ -240,6 +241,16 @@ end
 function ____exports.characterGetsBlackHeartFromEternalHeart(self, character)
     return CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART:has(character)
 end
+function ____exports.getActiveItemSlot(self, player, collectibleType)
+    local activeSlots = getEnumValues(nil, ActiveSlot)
+    return __TS__ArrayFind(
+        activeSlots,
+        function(____, activeSlot)
+            local activeItem = player:GetActiveItem(activeSlot)
+            return activeItem == collectibleType
+        end
+    )
+end
 function ____exports.getAzazelBrimstoneDistance(self, playerOrTearHeight)
     local tearHeight = tonumber(playerOrTearHeight)
     if tearHeight == nil then
@@ -563,9 +574,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch124 = activeSlot
-        local ____cond124 = ____switch124 == ActiveSlot.SLOT_PRIMARY
-        if ____cond124 then
+        local ____switch126 = activeSlot
+        local ____cond126 = ____switch126 == ActiveSlot.SLOT_PRIMARY
+        if ____cond126 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -574,8 +585,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond124 = ____cond124 or ____switch124 == ActiveSlot.SLOT_SECONDARY
-        if ____cond124 then
+        ____cond126 = ____cond126 or ____switch126 == ActiveSlot.SLOT_SECONDARY
+        if ____cond126 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -590,16 +601,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond124 = ____cond124 or ____switch124 == ActiveSlot.SLOT_POCKET
-        if ____cond124 then
+        ____cond126 = ____cond126 or ____switch126 == ActiveSlot.SLOT_POCKET
+        if ____cond126 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond124 = ____cond124 or ____switch124 == ActiveSlot.SLOT_POCKET2
-        if ____cond124 then
+        ____cond126 = ____cond126 or ____switch126 == ActiveSlot.SLOT_POCKET2
+        if ____cond126 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/dist/functions/pocketItems.d.ts

@@ -21,3 +21,8 @@ export declare function getPocketItems(player: EntityPlayer): PocketItemDescript
  * items. (Only Tainted Forgotten can pick up items.)
  */
 export declare function hasOpenPocketItemSlot(player: EntityPlayer): boolean;
+/**
+ * Helper function to determine whether or not the player's "active" pocket item slot is set to
+ * their pocket active item.
+ */
+export declare function isFirstSlotPocketActiveItem(player: EntityPlayer): boolean;

package/dist/functions/pocketItems.lua

@@ -60,4 +60,9 @@ function ____exports.hasOpenPocketItemSlot(self, player)
         function(____, pocketItem) return pocketItem.type == PocketItemType.EMPTY end
     )
 end
+function ____exports.isFirstSlotPocketActiveItem(self, player)
+    local pocketItems = ____exports.getPocketItems(nil, player)
+    local firstPocketItem = pocketItems[1]
+    return firstPocketItem.type == PocketItemType.ACTIVE_ITEM
+end
 return ____exports

package/dist/functions/utils.d.ts

@@ -36,6 +36,21 @@
  * ```
  */
 export declare const ensureAllCases: (obj: never) => never;
+/**
+ * TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
+ * when you iterate over them, you will get both the names of the enums and the values of the enums,
+ * in a random order. If all you need are the keys of an enum, use this helper function.
+ *
+ * This function will return the enum keys in a sorted order, which may not necessarily be the same
+ * order as which they were declared in.
+ *
+ * This function will work properly for both number enums and string enums. (Reverse mappings are
+ * not created for string enums.)
+ *
+ * For a more in depth explanation, see:
+ * https://isaacscript.github.io/docs/gotchas#iterating-over-enums
+ */
+export declare function getEnumKeys<T>(transpiledEnum: T): string[];
 /**
  * TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
  * when you iterate over them, you will get both the names of the enums and the values of the enums,

package/dist/functions/utils.lua

@@ -6,6 +6,16 @@ local __TS__StringSubstr = ____lualib.__TS__StringSubstr
 local ____exports = {}
 local HEX_STRING_LENGTH = 6
 ____exports.ensureAllCases = function(____, obj) return obj end
+function ____exports.getEnumKeys(self, transpiledEnum)
+    local enumKeys = {}
+    for key in pairs(transpiledEnum) do
+        if type(key) == "string" then
+            __TS__ArrayPush(enumKeys, key)
+        end
+    end
+    __TS__ArraySort(enumKeys)
+    return enumKeys
+end
 function ____exports.getEnumValues(self, transpiledEnum)
     local enumValues = {}
     for key, value in pairs(transpiledEnum) do

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.191",
+  "version": "1.2.194",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,11 +25,11 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.372",
+    "isaac-typescript-definitions": "^1.0.373",
     "isaacscript-lint": "^1.0.93",
     "isaacscript-tsconfig": "^1.1.8",
     "typedoc": "^0.22.13",
     "typescript": "4.6.2",
-    "typescript-to-lua": "^1.4.1"
+    "typescript-to-lua": "^1.4.2"
   }
 }