isaacscript-common 33.11.0 → 33.12.1

package/dist/index.rollup.d.ts

@@ -3558,12 +3558,29 @@ export declare function deserializeVector(vector: SerializedVector): Vector;
 /** For `EntityType.EFFECT` (1000), `EffectVariant.DICE_FLOOR` (76). */
 export declare const DICE_FLOOR_TRIGGER_SQUARE_SIZE = 75;
 
+/**
+ * Helper function to convert a direction to degrees. For example, `Direction.LEFT` (0) would return
+ * 180 and `Direction.RIGHT` (2) would return 0. (This corresponds to how the
+ * `Vector.GetAngleDegrees` method works.)
+ */
 export declare function directionToDegrees(direction: Direction): int;
 
+/**
+ * Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+ * (0) would return `ButtonAction.LEFT` (0).
+ */
 export declare function directionToMoveAction(direction: Direction): ButtonAction | undefined;
 
+/**
+ * Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+ * (0) would return `ButtonAction.SHOOT_LEFT` (4).
+ */
 export declare function directionToShootAction(direction: Direction): ButtonAction | undefined;
 
+/**
+ * Helper function to convert a direction to a `Vector`. For example, `Direction.LEFT` (0) would
+ * convert to `Vector(-1, 0).
+ */
 export declare function directionToVector(direction: Direction): Readonly<Vector>;
 
 declare class DisableAllSound extends Feature {
@@ -5105,6 +5122,10 @@ export declare function getDevilRoomOrAngelRoomDoor(): GridEntityDoor | undefine
  */
 export declare function getDimension(): Dimension;
 
+/**
+ * Helper function to get the lowercase name of a direction. For example, `Direction.LEFT` (0) would
+ * return "left".
+ */
 export declare function getDirectionName(direction: Direction): string | undefined;
 
 /**
@@ -7572,6 +7593,16 @@ export declare function hasPiercing(player: EntityPlayer): boolean;
  */
 export declare function hasSpectral(player: EntityPlayer): boolean;
 
+/**
+ * Helper function to check to see if a player has one or more trinkets.
+ *
+ * This function is variadic, meaning that you can supply as many trinket types as you want to check
+ * for. Returns true if the player has any of the supplied trinket types.
+ *
+ * This function always passes `false` to the `ignoreModifiers` argument.
+ */
+export declare function hasTrinket(player: EntityPlayer, ...trinketTypes: TrinketType[]): boolean;
+
 /**
  * Helper function to check if the current room has one or more open door slots that can be used to
  * make custom doors.
@@ -14786,8 +14817,8 @@ export declare function removeAllPlayerHealth(player: EntityPlayer): void;
 /**
  * Helper function to remove all of the held trinkets from a player.
  *
- * This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
- * they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+ * This will not remove any smelted trinkets, unless the player happens to also be holding a trinket
+ * that they have smelted. (In that case, both the held and the smelted trinket will be removed.)
  */
 export declare function removeAllPlayerTrinkets(player: EntityPlayer): void;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 33.11.0
+isaacscript-common 33.12.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -22161,6 +22161,13 @@ end
 function ____exports.hasSpectral(self, player)
     return hasFlag(nil, player.TearFlags, TearFlag.SPECTRAL)
 end
+function ____exports.hasTrinket(self, player, ...)
+    local trinketTypes = {...}
+    return __TS__ArraySome(
+        trinketTypes,
+        function(____, trinketType) return player:HasTrinket(trinketType) end
+    )
+end
 function ____exports.isActiveSlotEmpty(self, player, activeSlot)
     if activeSlot == nil then
         activeSlot = ActiveSlot.PRIMARY
@@ -22227,7 +22234,7 @@ function ____exports.removeAllActiveItems(self, player)
         do
             local collectibleType = player:GetActiveItem(activeSlot)
             if collectibleType == CollectibleType.NULL then
-                goto __continue96
+                goto __continue98
             end
             local stillHasCollectible
             repeat
@@ -22237,7 +22244,7 @@ function ____exports.removeAllActiveItems(self, player)
                 end
             until not stillHasCollectible
         end
-        ::__continue96::
+        ::__continue98::
     end
 end
 function ____exports.removeAllPlayerTrinkets(self, player)
@@ -22245,17 +22252,17 @@ function ____exports.removeAllPlayerTrinkets(self, player)
         do
             local trinketType = player:GetTrinket(trinketSlot)
             if trinketType == TrinketType.NULL then
-                goto __continue101
+                goto __continue103
             end
-            local hasTrinket
+            local alreadyHasTrinket
             repeat
                 do
                     player:TryRemoveTrinket(trinketType)
-                    hasTrinket = player:HasTrinket(trinketType)
+                    alreadyHasTrinket = player:HasTrinket(trinketType)
                 end
-            until not hasTrinket
+            until not alreadyHasTrinket
         end
-        ::__continue101::
+        ::__continue103::
     end
 end
 function ____exports.removeCollectible(self, player, ...)
@@ -22315,9 +22322,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch123 = activeSlot
-        local ____cond123 = ____switch123 == ActiveSlot.PRIMARY
-        if ____cond123 then
+        local ____switch125 = activeSlot
+        local ____cond125 = ____switch125 == ActiveSlot.PRIMARY
+        if ____cond125 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -22326,8 +22333,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond123 = ____cond123 or ____switch123 == ActiveSlot.SECONDARY
-        if ____cond123 then
+        ____cond125 = ____cond125 or ____switch125 == ActiveSlot.SECONDARY
+        if ____cond125 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -22342,16 +22349,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond123 = ____cond123 or ____switch123 == ActiveSlot.POCKET
-        if ____cond123 then
+        ____cond125 = ____cond125 or ____switch125 == ActiveSlot.POCKET
+        if ____cond125 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond123 = ____cond123 or ____switch123 == ActiveSlot.POCKET_SINGLE_USE
-        if ____cond123 then
+        ____cond125 = ____cond125 or ____switch125 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond125 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break
@@ -37325,7 +37332,7 @@ function ____exports.loadFromDisk(self, mod, oldSaveData, classConstructors)
         end,
         SAVE_DATA_MANAGER_DEBUG
     )
-    log("The save data manager loaded data from the \"save#.dat\" file.")
+    log("The save data manager loaded data from the \"save#.dat\" file for mod: " .. mod.Name)
 end
 return ____exports
  end,
@@ -37445,7 +37452,7 @@ function ____exports.saveToDisk(self, mod, saveDataMap, saveDataConditionalFuncM
     local allSaveData = getAllSaveDataToWriteToDisk(nil, saveDataMap, saveDataConditionalFuncMap)
     local jsonString = jsonEncode(nil, allSaveData)
     mod:SaveData(jsonString)
-    log("The save data manager wrote data to the \"save#.dat\" file.")
+    log("The save data manager wrote data to the \"save#.dat\" file for mod: " .. mod.Name)
 end
 return ____exports
  end,

package/dist/src/classes/features/other/saveDataManager/loadFromDisk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadFromDisk.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/saveDataManager/loadFromDisk.ts"],"names":[],"mappings":";;AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAK3D,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACrC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC1C,IAAI,CAsDN"}
+{"version":3,"file":"loadFromDisk.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/saveDataManager/loadFromDisk.ts"],"names":[],"mappings":";;AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAK3D,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACrC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC1C,IAAI,CAwDN"}

package/dist/src/classes/features/other/saveDataManager/loadFromDisk.lua

@@ -73,6 +73,6 @@ function ____exports.loadFromDisk(self, mod, oldSaveData, classConstructors)
         end,
         SAVE_DATA_MANAGER_DEBUG
     )
-    log("The save data manager loaded data from the \"save#.dat\" file.")
+    log("The save data manager loaded data from the \"save#.dat\" file for mod: " .. mod.Name)
 end
 return ____exports

package/dist/src/classes/features/other/saveDataManager/saveToDisk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveToDisk.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/saveDataManager/saveToDisk.ts"],"names":[],"mappings":";;AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE,wBAAgB,UAAU,CACxB,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACrC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GACxD,IAAI,CAQN"}
+{"version":3,"file":"saveToDisk.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/saveDataManager/saveToDisk.ts"],"names":[],"mappings":";;AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE,wBAAgB,UAAU,CACxB,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACrC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GACxD,IAAI,CAUN"}

package/dist/src/classes/features/other/saveDataManager/saveToDisk.lua

@@ -41,6 +41,6 @@ function ____exports.saveToDisk(self, mod, saveDataMap, saveDataConditionalFuncM
     local allSaveData = getAllSaveDataToWriteToDisk(nil, saveDataMap, saveDataConditionalFuncMap)
     local jsonString = jsonEncode(nil, allSaveData)
     mod:SaveData(jsonString)
-    log("The save data manager wrote data to the \"save#.dat\" file.")
+    log("The save data manager wrote data to the \"save#.dat\" file for mod: " .. mod.Name)
 end
 return ____exports

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

@@ -8,9 +8,30 @@ import { Direction } from "isaac-typescript-definitions";
  * works.)
  */
 export declare function angleToDirection(angleDegrees: int): Direction;
+/**
+ * Helper function to convert a direction to degrees. For example, `Direction.LEFT` (0) would return
+ * 180 and `Direction.RIGHT` (2) would return 0. (This corresponds to how the
+ * `Vector.GetAngleDegrees` method works.)
+ */
 export declare function directionToDegrees(direction: Direction): int;
+/**
+ * Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+ * (0) would return `ButtonAction.LEFT` (0).
+ */
 export declare function directionToMoveAction(direction: Direction): ButtonAction | undefined;
+/**
+ * Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+ * (0) would return `ButtonAction.SHOOT_LEFT` (4).
+ */
 export declare function directionToShootAction(direction: Direction): ButtonAction | undefined;
+/**
+ * Helper function to convert a direction to a `Vector`. For example, `Direction.LEFT` (0) would
+ * convert to `Vector(-1, 0).
+ */
 export declare function directionToVector(direction: Direction): Readonly<Vector>;
+/**
+ * Helper function to get the lowercase name of a direction. For example, `Direction.LEFT` (0) would
+ * return "left".
+ */
 export declare function getDirectionName(direction: Direction): string | undefined;
 //# sourceMappingURL=direction.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../../src/functions/direction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOzD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,GAAG,GAAG,SAAS,CAwB7D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,GAAG,CAE5D;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,GACnB,YAAY,GAAG,SAAS,CAE1B;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,GACnB,YAAY,GAAG,SAAS,CAE1B;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAExE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEzE"}
+{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../../src/functions/direction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOzD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,GAAG,GAAG,SAAS,CAwB7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,GAAG,CAE5D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,GACnB,YAAY,GAAG,SAAS,CAE1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,GACnB,YAAY,GAAG,SAAS,CAE1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAExE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEzE"}

package/dist/src/functions/direction.lua

@@ -36,18 +36,29 @@ function ____exports.angleToDirection(self, angleDegrees)
     end
     return Direction.RIGHT
 end
+--- Helper function to convert a direction to degrees. For example, `Direction.LEFT` (0) would return
+-- 180 and `Direction.RIGHT` (2) would return 0. (This corresponds to how the
+-- `Vector.GetAngleDegrees` method works.)
 function ____exports.directionToDegrees(self, direction)
     return DIRECTION_TO_DEGREES[direction]
 end
+--- Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+-- (0) would return `ButtonAction.LEFT` (0).
 function ____exports.directionToMoveAction(self, direction)
     return DIRECTION_TO_MOVE_ACTION[direction]
 end
+--- Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+-- (0) would return `ButtonAction.SHOOT_LEFT` (4).
 function ____exports.directionToShootAction(self, direction)
     return DIRECTION_TO_SHOOT_ACTION[direction]
 end
+--- Helper function to convert a direction to a `Vector`. For example, `Direction.LEFT` (0) would
+-- convert to `Vector(-1, 0).
 function ____exports.directionToVector(self, direction)
     return DIRECTION_TO_VECTOR[direction]
 end
+--- Helper function to get the lowercase name of a direction. For example, `Direction.LEFT` (0) would
+-- return "left".
 function ____exports.getDirectionName(self, direction)
     return DIRECTION_NAMES[direction]
 end

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

@@ -229,6 +229,15 @@ export declare function hasPiercing(player: EntityPlayer): boolean;
  * Under the hood, this checks the `EntityPlayer.TearFlags` variable.
  */
 export declare function hasSpectral(player: EntityPlayer): boolean;
+/**
+ * Helper function to check to see if a player has one or more trinkets.
+ *
+ * This function is variadic, meaning that you can supply as many trinket types as you want to check
+ * for. Returns true if the player has any of the supplied trinket types.
+ *
+ * This function always passes `false` to the `ignoreModifiers` argument.
+ */
+export declare function hasTrinket(player: EntityPlayer, ...trinketTypes: TrinketType[]): boolean;
 /**
  * Helper function to check if the active slot of a particular player is empty.
  *
@@ -293,8 +302,8 @@ export declare function removeAllActiveItems(player: EntityPlayer): void;
 /**
  * Helper function to remove all of the held trinkets from a player.
  *
- * This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
- * they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+ * This will not remove any smelted trinkets, unless the player happens to also be holding a trinket
+ * that they have smelted. (In that case, both the held and the smelted trinket will be removed.)
  */
 export declare function removeAllPlayerTrinkets(player: EntityPlayer): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"players.d.ts","sourceRoot":"","sources":["../../../src/functions/players.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"players.d.ts","sourceRoot":"","sources":["../../../src/functions/players.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/players.lua

@@ -481,6 +481,19 @@ end
 function ____exports.hasSpectral(self, player)
     return hasFlag(nil, player.TearFlags, TearFlag.SPECTRAL)
 end
+--- Helper function to check to see if a player has one or more trinkets.
+-- 
+-- This function is variadic, meaning that you can supply as many trinket types as you want to check
+-- for. Returns true if the player has any of the supplied trinket types.
+-- 
+-- This function always passes `false` to the `ignoreModifiers` argument.
+function ____exports.hasTrinket(self, player, ...)
+    local trinketTypes = {...}
+    return __TS__ArraySome(
+        trinketTypes,
+        function(____, trinketType) return player:HasTrinket(trinketType) end
+    )
+end
 --- Helper function to check if the active slot of a particular player is empty.
 -- 
 -- @param player The player to check.
@@ -571,7 +584,7 @@ function ____exports.removeAllActiveItems(self, player)
         do
             local collectibleType = player:GetActiveItem(activeSlot)
             if collectibleType == CollectibleType.NULL then
-                goto __continue96
+                goto __continue98
             end
             local stillHasCollectible
             repeat
@@ -581,29 +594,29 @@ function ____exports.removeAllActiveItems(self, player)
                 end
             until not stillHasCollectible
         end
-        ::__continue96::
+        ::__continue98::
     end
 end
 --- Helper function to remove all of the held trinkets from a player.
 -- 
--- This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
--- they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+-- This will not remove any smelted trinkets, unless the player happens to also be holding a trinket
+-- that they have smelted. (In that case, both the held and the smelted trinket will be removed.)
 function ____exports.removeAllPlayerTrinkets(self, player)
     for ____, trinketSlot in ipairs(TRINKET_SLOT_VALUES) do
         do
             local trinketType = player:GetTrinket(trinketSlot)
             if trinketType == TrinketType.NULL then
-                goto __continue101
+                goto __continue103
             end
-            local hasTrinket
+            local alreadyHasTrinket
             repeat
                 do
                     player:TryRemoveTrinket(trinketType)
-                    hasTrinket = player:HasTrinket(trinketType)
+                    alreadyHasTrinket = player:HasTrinket(trinketType)
                 end
-            until not hasTrinket
+            until not alreadyHasTrinket
         end
-        ::__continue101::
+        ::__continue103::
     end
 end
 --- Helper function to remove one or more collectibles to a player.
@@ -694,9 +707,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch123 = activeSlot
-        local ____cond123 = ____switch123 == ActiveSlot.PRIMARY
-        if ____cond123 then
+        local ____switch125 = activeSlot
+        local ____cond125 = ____switch125 == ActiveSlot.PRIMARY
+        if ____cond125 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -705,8 +718,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond123 = ____cond123 or ____switch123 == ActiveSlot.SECONDARY
-        if ____cond123 then
+        ____cond125 = ____cond125 or ____switch125 == ActiveSlot.SECONDARY
+        if ____cond125 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -721,16 +734,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond123 = ____cond123 or ____switch123 == ActiveSlot.POCKET
-        if ____cond123 then
+        ____cond125 = ____cond125 or ____switch125 == ActiveSlot.POCKET
+        if ____cond125 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond123 = ____cond123 or ____switch123 == ActiveSlot.POCKET_SINGLE_USE
-        if ____cond123 then
+        ____cond125 = ____cond125 or ____switch125 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond125 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/package.json

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

package/src/classes/features/other/SaveDataManager.ts

@@ -463,7 +463,7 @@ export class SaveDataManager extends Feature {
     for (const tstlClass of tstlClasses) {
       const { name } = tstlClass;
       assertDefined(
-        // Since we are accepting untrusted user input, this might nto be a real TSTL class.
+        // Since we are accepting untrusted user input, this might not be a real TSTL class.
         name as string | undefined,
         "Failed to register a class with the save data manager due to not being able to derive the name of the class.",
       );

package/src/classes/features/other/saveDataManager/loadFromDisk.ts

@@ -67,7 +67,9 @@ export function loadFromDisk(
     SAVE_DATA_MANAGER_DEBUG,
   );
 
-  log('The save data manager loaded data from the "save#.dat" file.');
+  log(
+    `The save data manager loaded data from the "save#.dat" file for mod: ${mod.Name}`,
+  );
 }
 
 function readSaveDatFile(mod: Mod) {

package/src/classes/features/other/saveDataManager/saveToDisk.ts

@@ -17,7 +17,9 @@ export function saveToDisk(
   );
   const jsonString = jsonEncode(allSaveData);
   mod.SaveData(jsonString);
-  log('The save data manager wrote data to the "save#.dat" file.');
+  log(
+    `The save data manager wrote data to the "save#.dat" file for mod: ${mod.Name}`,
+  );
 }
 
 function getAllSaveDataToWriteToDisk(

package/src/functions/direction.ts

@@ -39,26 +39,47 @@ export function angleToDirection(angleDegrees: int): Direction {
   return Direction.RIGHT;
 }
 
+/**
+ * Helper function to convert a direction to degrees. For example, `Direction.LEFT` (0) would return
+ * 180 and `Direction.RIGHT` (2) would return 0. (This corresponds to how the
+ * `Vector.GetAngleDegrees` method works.)
+ */
 export function directionToDegrees(direction: Direction): int {
   return DIRECTION_TO_DEGREES[direction];
 }
 
+/**
+ * Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+ * (0) would return `ButtonAction.LEFT` (0).
+ */
 export function directionToMoveAction(
   direction: Direction,
 ): ButtonAction | undefined {
   return DIRECTION_TO_MOVE_ACTION[direction];
 }
 
+/**
+ * Helper function to convert a direction to a shoot `ButtonAction`. For example, `Direction.LEFT`
+ * (0) would return `ButtonAction.SHOOT_LEFT` (4).
+ */
 export function directionToShootAction(
   direction: Direction,
 ): ButtonAction | undefined {
   return DIRECTION_TO_SHOOT_ACTION[direction];
 }
 
+/**
+ * Helper function to convert a direction to a `Vector`. For example, `Direction.LEFT` (0) would
+ * convert to `Vector(-1, 0).
+ */
 export function directionToVector(direction: Direction): Readonly<Vector> {
   return DIRECTION_TO_VECTOR[direction];
 }
 
+/**
+ * Helper function to get the lowercase name of a direction. For example, `Direction.LEFT` (0) would
+ * return "left".
+ */
 export function getDirectionName(direction: Direction): string | undefined {
   return DIRECTION_NAMES[direction];
 }

package/src/functions/players.ts

@@ -599,6 +599,21 @@ export function hasSpectral(player: EntityPlayer): boolean {
   return hasFlag(player.TearFlags, TearFlag.SPECTRAL);
 }
 
+/**
+ * Helper function to check to see if a player has one or more trinkets.
+ *
+ * This function is variadic, meaning that you can supply as many trinket types as you want to check
+ * for. Returns true if the player has any of the supplied trinket types.
+ *
+ * This function always passes `false` to the `ignoreModifiers` argument.
+ */
+export function hasTrinket(
+  player: EntityPlayer,
+  ...trinketTypes: TrinketType[]
+): boolean {
+  return trinketTypes.some((trinketType) => player.HasTrinket(trinketType));
+}
+
 /**
  * Helper function to check if the active slot of a particular player is empty.
  *
@@ -760,8 +775,8 @@ export function removeAllActiveItems(player: EntityPlayer): void {
 /**
  * Helper function to remove all of the held trinkets from a player.
  *
- * This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
- * they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+ * This will not remove any smelted trinkets, unless the player happens to also be holding a trinket
+ * that they have smelted. (In that case, both the held and the smelted trinket will be removed.)
  */
 export function removeAllPlayerTrinkets(player: EntityPlayer): void {
   for (const trinketSlot of TRINKET_SLOT_VALUES) {
@@ -770,11 +785,11 @@ export function removeAllPlayerTrinkets(player: EntityPlayer): void {
       continue;
     }
 
-    let hasTrinket: boolean;
+    let alreadyHasTrinket: boolean;
     do {
       player.TryRemoveTrinket(trinketType);
-      hasTrinket = player.HasTrinket(trinketType);
-    } while (hasTrinket);
+      alreadyHasTrinket = player.HasTrinket(trinketType);
+    } while (alreadyHasTrinket);
   }
 }