isaacscript-common 7.0.0 → 7.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EAEV,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAsCtC,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAOjE;AAED,wBAAgB,cAAc,IAAI,GAAG,CAAC,YAAY,CAAC,CAElD;AAED,wBAAgB,eAAe,IAAI,GAAG,CAAC,YAAY,CAAC,CAEnD;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAK7E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,GACzB,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE3D"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EAEV,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAuCtC,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAOjE;AAED,wBAAgB,cAAc,IAAI,GAAG,CAAC,YAAY,CAAC,CAElD;AAED,wBAAgB,eAAe,IAAI,GAAG,CAAC,YAAY,CAAC,CAEnD;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAK7E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,GACzB,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,SAAS,CAQpB"}

package/dist/functions/input.lua

@@ -8,6 +8,8 @@ local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
 local Controller = ____isaac_2Dtypescript_2Ddefinitions.Controller
 local ControllerIndex = ____isaac_2Dtypescript_2Ddefinitions.ControllerIndex
 local Keyboard = ____isaac_2Dtypescript_2Ddefinitions.Keyboard
+local ____keyboardToString = require("maps.keyboardToString")
+local KEYBOARD_TO_STRING = ____keyboardToString.KEYBOARD_TO_STRING
 local ____enums = require("functions.enums")
 local getEnumValues = ____enums.getEnumValues
 local ____set = require("functions.set")
@@ -109,7 +111,13 @@ function ____exports.isShootActionTriggeredOnAnyInput(self)
         function(____, shootAction) return ____exports.isActionTriggeredOnAnyInput(nil, shootAction) end
     )
 end
-function ____exports.keyboardToString(self, keyboard)
-    return Keyboard[keyboard] or "unknown"
+--- Helper function to get the string that would be typed if someone pressed the corresponding key.
+function ____exports.keyboardToString(self, keyboard, uppercase)
+    local tuple = KEYBOARD_TO_STRING:get(keyboard)
+    if tuple == nil then
+        return nil
+    end
+    local lowercaseCharacter, uppercaseCharacter = table.unpack(tuple)
+    return uppercase and uppercaseCharacter or lowercaseCharacter
 end
 return ____exports

package/dist/functions/jsonRoom.lua

@@ -52,7 +52,7 @@ function ____exports.getJSONRoomDoorSlotFlags(self, jsonRoom)
     local roomShapeString = jsonRoom["$"].shape
     local roomShapeNumber = tonumber(roomShapeString)
     if roomShapeNumber == nil then
-        error("Failed to parse the \"shape\" property of a JSON room: " .. roomShapeString)
+        error("Failed to parse the \"shape\" field of a JSON room: " .. roomShapeString)
     end
     local roomShape = roomShapeNumber
     local doorSlotFlags = DoorSlotFlagZero
@@ -60,7 +60,7 @@ function ____exports.getJSONRoomDoorSlotFlags(self, jsonRoom)
         do
             local existsString = door["$"].exists
             if existsString ~= "True" and existsString ~= "False" then
-                error("Failed to parse the \"exists\" property of a JSON room door: " .. existsString)
+                error("Failed to parse the \"exists\" field of a JSON room door: " .. existsString)
             end
             if existsString == "False" then
                 goto __continue4
@@ -68,12 +68,12 @@ function ____exports.getJSONRoomDoorSlotFlags(self, jsonRoom)
             local xString = door["$"].x
             local x = tonumber(xString)
             if x == nil then
-                error("Failed to parse the \"x\" property of a JSON room door: " .. xString)
+                error("Failed to parse the \"x\" field of a JSON room door: " .. xString)
             end
             local yString = door["$"].y
             local y = tonumber(yString)
             if y == nil then
-                error("Failed to parse the \"y\" property of a JSON room door: " .. yString)
+                error("Failed to parse the \"y\" field of a JSON room door: " .. yString)
             end
             local doorSlot = getRoomShapeDoorSlot(nil, roomShape, x, y)
             if doorSlot == nil then

package/dist/functions/kColor.d.ts

@@ -20,7 +20,7 @@ export declare function deserializeKColor(kColor: SerializedKColor): KColor;
  * @param alpha Optional. The alpha value to use. Default is 1.
  */
 export declare function getRandomKColor(seedOrRNG?: Seed | RNG, alpha?: number): KColor;
-/** Helper function to check if something is an instantiated KColor object. */
+/** Helper function to check if something is an instantiated `KColor` object. */
 export declare function isKColor(object: unknown): object is KColor;
 /**
  * Used to determine is the given table is a serialized `KColor` object created by the save data

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

@@ -1 +1 @@
-{"version":3,"file":"kColor.d.ts","sourceRoot":"","sources":["../../src/functions/kColor.ts"],"names":[],"mappings":";;;;AAOA,oBAAY,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAmClE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,KAAK,SAAI,GACR,MAAM,CAQR;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,gBAAgB,CAQ5B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhE"}
+{"version":3,"file":"kColor.d.ts","sourceRoot":"","sources":["../../src/functions/kColor.ts"],"names":[],"mappings":";;;;AAOA,oBAAY,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAmClE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,KAAK,SAAI,GACR,MAAM,CAQR;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,gBAAgB,CAQ5B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhE"}

package/dist/functions/kColor.lua

@@ -17,12 +17,12 @@ local getNumbersFromTable = ____table.getNumbersFromTable
 local tableHasKeys = ____table.tableHasKeys
 local ____types = require("functions.types")
 local isTable = ____types.isTable
---- Helper function to check if something is an instantiated KColor object.
+--- Helper function to check if something is an instantiated `KColor` object.
 function ____exports.isKColor(self, object)
     return isIsaacAPIClassOfType(nil, object, OBJECT_NAME)
 end
-local KEYS = {"Red", "Green", "Blue", "Alpha"}
 OBJECT_NAME = "KColor"
+local KEYS = {"Red", "Green", "Blue", "Alpha"}
 --- Helper function to copy a `KColor` Isaac API class.
 function ____exports.copyKColor(self, kColor)
     if not ____exports.isKColor(nil, kColor) then

package/dist/functions/log.lua

@@ -369,7 +369,7 @@ end
 --- Helper function to enumerate all of the properties of a "userdata" object (i.e. an object from
 -- the Isaac API).
 function ____exports.logUserdata(userdata)
-    if isUserdata(nil, userdata) then
+    if not isUserdata(nil, userdata) then
         ____exports.log("Userdata: [not userdata]")
         return
     end

package/dist/functions/npcs.d.ts

@@ -24,8 +24,8 @@ export declare function isAliveExceptionNPC(npc: EntityNPC): boolean;
  * that is spawned when the boss does the multi-stomp attack.
  *
  * When this attack occurs, four extra copies of Daddy Long Legs will be spawned with the same
- * entity type, variant, and sub-type. The `Entity.Parent` property will be undefined in this case,
- * so the way to tell them apart is to check for a non-undefined `Entity.SpawnerEntity` property.
+ * entity type, variant, and sub-type. The `Entity.Parent` field will be undefined in this case, so
+ * the way to tell them apart is to check for a non-undefined `Entity.SpawnerEntity` field.
  */
 export declare function isDaddyLongLegsChildStompEntity(npc: EntityNPC): boolean;
 /**

package/dist/functions/npcs.lua

@@ -50,8 +50,8 @@ end
 -- that is spawned when the boss does the multi-stomp attack.
 -- 
 -- When this attack occurs, four extra copies of Daddy Long Legs will be spawned with the same
--- entity type, variant, and sub-type. The `Entity.Parent` property will be undefined in this case,
--- so the way to tell them apart is to check for a non-undefined `Entity.SpawnerEntity` property.
+-- entity type, variant, and sub-type. The `Entity.Parent` field will be undefined in this case, so
+-- the way to tell them apart is to check for a non-undefined `Entity.SpawnerEntity` field.
 function ____exports.isDaddyLongLegsChildStompEntity(self, npc)
     return npc.Type == EntityType.DADDY_LONG_LEGS and npc.SpawnerEntity ~= nil
 end

package/dist/functions/playerIndex.d.ts

@@ -78,7 +78,7 @@ export declare function getPlayers(performCharacterExclusions?: boolean): Entity
 export declare function getSubPlayerParent(subPlayer: EntitySubPlayer): EntityPlayer | undefined;
 /**
  * Helper function to detect if a particular player is a "child" player, meaning that they have a
- * non-undefined `EntityPlayer.Parent` property. (For example, the Strawman Keeper.)
+ * non-undefined `EntityPlayer.Parent` field. (For example, the Strawman Keeper.)
  */
 export declare function isChildPlayer(player: EntityPlayer): boolean;
 //# sourceMappingURL=playerIndex.d.ts.map

package/dist/functions/playerIndex.lua

@@ -125,7 +125,7 @@ function ____exports.getSubPlayerParent(self, subPlayer)
     )
 end
 --- Helper function to detect if a particular player is a "child" player, meaning that they have a
--- non-undefined `EntityPlayer.Parent` property. (For example, the Strawman Keeper.)
+-- non-undefined `EntityPlayer.Parent` field. (For example, the Strawman Keeper.)
 function ____exports.isChildPlayer(self, player)
     return player.Parent ~= nil
 end

package/dist/functions/playerStats.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="isaac-typescript-definitions" />
+import { StatType } from "../enums/StatType";
+import { StatTypeType } from "../interfaces/StatTypeType";
+/** Helper function to get the stat for a player corresponding to the `StatType`. */
+export declare function getPlayerStat<T extends StatType>(player: EntityPlayer, statType: T): StatTypeType[T];
+//# sourceMappingURL=playerStats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"playerStats.d.ts","sourceRoot":"","sources":["../../src/functions/playerStats.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,CAAC,SAAS,QAAQ,EAC9C,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,CAAC,GACV,YAAY,CAAC,CAAC,CAAC,CAiBjB"}

package/dist/functions/playerStats.lua

@@ -0,0 +1,21 @@
+local ____exports = {}
+local ____StatType = require("enums.StatType")
+local StatType = ____StatType.StatType
+--- Helper function to get the stat for a player corresponding to the `StatType`.
+function ____exports.getPlayerStat(self, player, statType)
+    return ({
+        [StatType.DAMAGE] = player.Damage,
+        [StatType.FIRE_DELAY] = player.MaxFireDelay,
+        [StatType.SHOT_SPEED] = player.ShotSpeed,
+        [StatType.TEAR_HEIGHT] = player.TearHeight,
+        [StatType.TEAR_RANGE] = player.TearRange,
+        [StatType.TEAR_FALLING_ACCELERATION] = player.TearFallingAcceleration,
+        [StatType.TEAR_FALLING_SPEED] = player.TearFallingSpeed,
+        [StatType.MOVE_SPEED] = player.MoveSpeed,
+        [StatType.TEAR_FLAG] = player.TearFlags,
+        [StatType.TEAR_COLOR] = player.TearColor,
+        [StatType.FLYING] = player.CanFly,
+        [StatType.LUCK] = player.Luck
+    })[statType]
+end
+return ____exports

package/dist/functions/players.d.ts

@@ -3,7 +3,7 @@ import { HealthType } from "../enums/HealthType";
 export declare function addCollectibleCostume(player: EntityPlayer, collectibleType: CollectibleType): void;
 /**
  * Helper function to add a stat to a player based on the `CacheFlag` provided. Call this function
- * from the EvaluateCache callback.
+ * from the `EVALUATE_CACHE` callback.
  *
  * Note that for `CacheFlag.FIRE_DELAY`, the "amount" argument will be interpreted as the tear stat
  * to add (and not the amount to mutate `EntityPlayer.MaxFireDelay` by).

package/dist/functions/players.lua

@@ -142,7 +142,7 @@ function ____exports.addCollectibleCostume(self, player, collectibleType)
     player:AddCostume(itemConfigItem, false)
 end
 --- Helper function to add a stat to a player based on the `CacheFlag` provided. Call this function
--- from the EvaluateCache callback.
+-- from the `EVALUATE_CACHE` callback.
 -- 
 -- Note that for `CacheFlag.FIRE_DELAY`, the "amount" argument will be interpreted as the tear stat
 -- to add (and not the amount to mutate `EntityPlayer.MaxFireDelay` by).

package/dist/functions/rng.d.ts

@@ -17,7 +17,7 @@ export declare function deserializeRNG(rng: SerializedRNG): RNG;
  * the game.
  */
 export declare function getRandomSeed(): Seed;
-/** Helper function to check if something is an instantiated RNG object. */
+/** Helper function to check if something is an instantiated `RNG` object. */
 export declare function isRNG(object: unknown): object is RNG;
 /**
  * Used to determine is the given table is a serialized `RNG` object created by the save data

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

@@ -1 +1 @@
-{"version":3,"file":"rng.d.ts","sourceRoot":"","sources":["../../src/functions/rng.ts"],"names":[],"mappings":";;;AAMA,oBAAY,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACpD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC,CAAC;AAYF,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CASrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,CAatD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED,2EAA2E;AAC3E,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,GAAG,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAMxE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,OAAkB,GAAG,GAAG,CAIlD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAYpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAK1D;AAED,4FAA4F;AAC5F,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CASlD"}
+{"version":3,"file":"rng.d.ts","sourceRoot":"","sources":["../../src/functions/rng.ts"],"names":[],"mappings":";;;AAMA,oBAAY,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACpD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC,CAAC;AAYF,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CASrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,CAatD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED,6EAA6E;AAC7E,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,GAAG,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAMxE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,OAAkB,GAAG,GAAG,CAIlD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAYpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAK1D;AAED,4FAA4F;AAC5F,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CASlD"}

package/dist/functions/rng.lua

@@ -22,7 +22,7 @@ function ____exports.getRandomSeed(self)
     local safeRandomNumber = randomNumber == 0 and 1 or randomNumber
     return safeRandomNumber
 end
---- Helper function to check if something is an instantiated RNG object.
+--- Helper function to check if something is an instantiated `RNG` object.
 function ____exports.isRNG(self, object)
     return isIsaacAPIClassOfType(nil, object, OBJECT_NAME)
 end
@@ -45,8 +45,8 @@ function ____exports.setSeed(self, rng, seed)
     rng:SetSeed(seed, RECOMMENDED_SHIFT_IDX)
 end
 RECOMMENDED_SHIFT_IDX = 35
-local KEYS = {"seed"}
 OBJECT_NAME = "RNG"
+local KEYS = {"seed"}
 --- Helper function to copy an `RNG` Isaac API class.
 function ____exports.copyRNG(self, rng)
     if not ____exports.isRNG(nil, rng) then

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

@@ -1 +1 @@
-{"version":3,"file":"rockAlt.d.ts","sourceRoot":"","sources":["../../src/functions/rockAlt.ts"],"names":[],"mappings":";;;AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAgCnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,OAAO,CA4BT"}
+{"version":3,"file":"rockAlt.d.ts","sourceRoot":"","sources":["../../src/functions/rockAlt.ts"],"names":[],"mappings":";;;AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAuCnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,OAAO,CA4BT"}

package/dist/functions/rockAlt.lua

@@ -1,5 +1,5 @@
 local ____exports = {}
-local spawnRockAltRewardUrn, spawnRockAltRewardMushroom, spawnRockAltRewardSkull, spawnRockAltRewardPolyp, spawnRockAltRewardBucketDownpour, spawnRockAltRewardBucketDross, ROCK_ALT_CHANCES, COIN_VELOCITY_MULTIPLIER, POLYP_PROJECTILE_SPEED, POLYP_NUM_PROJECTILES
+local spawnRockAltRewardUrn, spawnRockAltRewardMushroom, spawnRockAltRewardSkull, spawnRockAltRewardPolyp, spawnRockAltRewardBucketDownpour, spawnRockAltRewardBucketDross, ROCK_ALT_CHANCES, COIN_VELOCITY_MULTIPLIER, FIND_FREE_INITIAL_STEP, FART_RADIUS, POLYP_PROJECTILE_SPEED, POLYP_NUM_PROJECTILES
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Card = ____isaac_2Dtypescript_2Ddefinitions.Card
 local CoinSubType = ____isaac_2Dtypescript_2Ddefinitions.CoinSubType
@@ -45,6 +45,7 @@ local ____repeat = ____utils["repeat"]
 local ____vector = require("functions.vector")
 local getRandomVector = ____vector.getRandomVector
 function spawnRockAltRewardUrn(self, position, rng)
+    local room = game:GetRoom()
     local chance = getRandom(nil, rng)
     local totalChance = 0
     totalChance = totalChance + ROCK_ALT_CHANCES.NOTHING
@@ -88,14 +89,11 @@ function spawnRockAltRewardUrn(self, position, rng)
     end
     local numEnemiesChance = getRandom(nil, rng)
     local numEnemies = numEnemiesChance < 0.5 and 1 or 2
-    local length = DISTANCE_OF_GRID_TILE * 3
     ____repeat(
         nil,
         numEnemies,
         function()
-            local randomVector = getRandomVector(nil, rng)
-            local offset = randomVector * length
-            local targetPos = position + offset
+            local targetPos = room:FindFreePickupSpawnPosition(position, FIND_FREE_INITIAL_STEP)
             EntityNPC.ThrowSpider(
                 position,
                 nil,
@@ -156,13 +154,8 @@ function spawnRockAltRewardMushroom(self, position, rng)
         end
         return false
     end
-    spawnEffectWithSeed(
-        nil,
-        EffectVariant.FART,
-        0,
-        position,
-        rng
-    )
+    game:Fart(position)
+    game:ButterBeanFart(position, FART_RADIUS, nil)
     return true
 end
 function spawnRockAltRewardSkull(self, position, rng)
@@ -266,6 +259,7 @@ function spawnRockAltRewardPolyp(self, position, rng)
     return true
 end
 function spawnRockAltRewardBucketDownpour(self, position, rng)
+    local room = game:GetRoom()
     local chance = getRandom(nil, rng)
     local totalChance = 0
     totalChance = totalChance + ROCK_ALT_CHANCES.NOTHING
@@ -311,14 +305,11 @@ function spawnRockAltRewardBucketDownpour(self, position, rng)
     local entityType = enemiesChance < 0.5 and EntityType.SPIDER or EntityType.SMALL_LEECH
     local numEnemiesChance = getRandom(nil, rng)
     local numEnemies = numEnemiesChance < 0.5 and 1 or 2
-    local jumpDistance = DISTANCE_OF_GRID_TILE * 3
     ____repeat(
         nil,
         numEnemies,
         function()
-            local randomVector = getRandomVector(nil, rng)
-            local offset = randomVector * jumpDistance
-            local targetPos = position + offset
+            local targetPos = room:FindFreePickupSpawnPosition(position, FIND_FREE_INITIAL_STEP)
             local spider = EntityNPC.ThrowSpider(
                 position,
                 nil,
@@ -334,6 +325,7 @@ function spawnRockAltRewardBucketDownpour(self, position, rng)
     return true
 end
 function spawnRockAltRewardBucketDross(self, position, rng)
+    local room = game:GetRoom()
     local chance = getRandom(nil, rng)
     local totalChance = 0
     totalChance = totalChance + ROCK_ALT_CHANCES.NOTHING
@@ -379,14 +371,11 @@ function spawnRockAltRewardBucketDross(self, position, rng)
     local entityType = enemiesChance < 0.5 and EntityType.DRIP or EntityType.SMALL_LEECH
     local numEnemiesChance = getRandom(nil, rng)
     local numEnemies = numEnemiesChance < 0.5 and 1 or 2
-    local jumpDistance = DISTANCE_OF_GRID_TILE * 3
     ____repeat(
         nil,
         numEnemies,
         function()
-            local randomVector = getRandomVector(nil, rng)
-            local offset = randomVector * jumpDistance
-            local targetPos = position + offset
+            local targetPos = room:FindFreePickupSpawnPosition(position, FIND_FREE_INITIAL_STEP)
             local spider = EntityNPC.ThrowSpider(
                 position,
                 nil,
@@ -401,6 +390,8 @@ function spawnRockAltRewardBucketDross(self, position, rng)
 end
 ROCK_ALT_CHANCES = {NOTHING = 0.68, BASIC_DROP = 0.0967, TRINKET = 0.025, COLLECTIBLE = 0.005}
 COIN_VELOCITY_MULTIPLIER = 2
+FIND_FREE_INITIAL_STEP = 70
+FART_RADIUS = DISTANCE_OF_GRID_TILE * 3
 POLYP_PROJECTILE_SPEED = 10
 POLYP_NUM_PROJECTILES = 6
 --- Helper function to get the alternate rock type (i.e. urn, mushroom, etc.) that the current room

package/dist/functions/roomTransition.d.ts

@@ -12,7 +12,7 @@ export declare function reloadRoom(): void;
  * arguments.
  *
  * Use this function instead of invoking the `Game.StartRoomTransition` method directly so that:
- * - you do not forget to set `Level.LeaveDoor` property
+ * - you do not forget to set the `Level.LeaveDoor` field
  * - to prevent crashing on invalid room grid indexes
  * - to automatically handle Curse of the Maze
  *

package/dist/functions/roomTransition.lua

@@ -18,7 +18,7 @@ local getRoomGridIndex = ____roomData.getRoomGridIndex
 -- arguments.
 -- 
 -- Use this function instead of invoking the `Game.StartRoomTransition` method directly so that:
--- - you do not forget to set `Level.LeaveDoor` property
+-- - you do not forget to set the `Level.LeaveDoor` field
 -- - to prevent crashing on invalid room grid indexes
 -- - to automatically handle Curse of the Maze
 -- 

package/dist/functions/rooms.d.ts

@@ -2,7 +2,7 @@ import { BackdropType, BossID, Dimension, ItemPoolType, MinibossID, RoomType } f
 /**
  * Helper function for quickly switching to a new room without playing a particular animation. Use
  * this helper function over invoking the `Game.ChangeRoom` method directly to ensure that you do
- * not forget to set the `LeaveDoor` property and to prevent crashing on invalid room grid indexes.
+ * not forget to set the `LeaveDoor` field and to prevent crashing on invalid room grid indexes.
  */
 export declare function changeRoom(roomGridIndex: int): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../src/functions/rooms.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACZ,MAAM,EACN,SAAS,EAKT,YAAY,EACZ,UAAU,EAGV,QAAQ,EAGT,MAAM,8BAA8B,CAAC;AAiCtC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAenD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,GAAG,CAGjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAiBlE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,GAAG,EAChB,oBAAoB,UAAO,GAC1B,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,CAUlC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,4BAA4B,UAAQ,GACnC,cAAc,EAAE,CAOlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,4BAA4B,UAAQ,GACnC,cAAc,EAAE,CAqBlB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,EAAE,CAe1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAWtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED,wBAAgB,WAAW,IAAI,OAAO,CAOrC;AAED,wBAAgB,WAAW,IAAI,OAAO,CASrC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAWpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAOtC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAWhD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAGnD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAED,+FAA+F;AAC/F,wBAAgB,OAAO,IAAI,OAAO,CAUjC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAKzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CASrC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAWhE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAKtC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAcxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAWrC;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA8BrC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}
+{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../src/functions/rooms.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACZ,MAAM,EACN,SAAS,EAKT,YAAY,EACZ,UAAU,EAGV,QAAQ,EAGT,MAAM,8BAA8B,CAAC;AAiCtC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAenD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,GAAG,CAGjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAiBlE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,GAAG,EAChB,oBAAoB,UAAO,GAC1B,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,CAUlC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,4BAA4B,UAAQ,GACnC,cAAc,EAAE,CAOlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,4BAA4B,UAAQ,GACnC,cAAc,EAAE,CAqBlB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,EAAE,CAe1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAWtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED,wBAAgB,WAAW,IAAI,OAAO,CAOrC;AAED,wBAAgB,WAAW,IAAI,OAAO,CASrC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAWpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAOtC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAWhD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAGnD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAED,+FAA+F;AAC/F,wBAAgB,OAAO,IAAI,OAAO,CAUjC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAKzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CASrC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAWhE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAKtC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAcxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAWrC;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA8BrC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/functions/rooms.lua

@@ -133,7 +133,7 @@ function ____exports.getRoomsOutsideGrid(self)
 end
 --- Helper function for quickly switching to a new room without playing a particular animation. Use
 -- this helper function over invoking the `Game.ChangeRoom` method directly to ensure that you do
--- not forget to set the `LeaveDoor` property and to prevent crashing on invalid room grid indexes.
+-- not forget to set the `LeaveDoor` field and to prevent crashing on invalid room grid indexes.
 function ____exports.changeRoom(self, roomGridIndex)
     local level = game:GetLevel()
     local roomData = getRoomData(nil, roomGridIndex)
@@ -382,6 +382,7 @@ end
 --- Helper function to set the backdrop of the current room.
 function ____exports.setBackdrop(self, backdropType)
     game:ShowHallucination(0, backdropType)
+    sfxManager:Stop(SoundEffect.DEATH_CARD)
 end
 --- Helper function to convert an uncleared room to a cleared room in the `POST_NEW_ROOM` callback.
 -- This is useful because if enemies are removed in this callback, a room drop will be awarded and

package/dist/functions/sprites.d.ts

@@ -21,9 +21,9 @@ export declare function clearSprite(sprite: Sprite, ...layerIDs: int[]): void;
  *
  * Note that this function is bugged with the Stop Watch or the Broken Watch, since using the
  * `Sprite.SetFrame` method will reset the internal accumulator used to slow down the playback speed
- * of the animation. (The `PlaybackSpeed` property of the sprite is not used.) Thus, it is only safe
- * to use this function on animations that are not slowed down by Stop Watch or Broken Watch, such
- * as player animations.
+ * of the animation. (The `PlaybackSpeed` field of the sprite is not used.) Thus, it is only safe to
+ * use this function on animations that are not slowed down by Stop Watch or Broken Watch, such as
+ * player animations.
  */
 export declare function getLastFrameOfAnimation(sprite: Sprite, animation?: string): int;
 /**

package/dist/functions/sprites.lua

@@ -39,9 +39,9 @@ end
 -- 
 -- Note that this function is bugged with the Stop Watch or the Broken Watch, since using the
 -- `Sprite.SetFrame` method will reset the internal accumulator used to slow down the playback speed
--- of the animation. (The `PlaybackSpeed` property of the sprite is not used.) Thus, it is only safe
--- to use this function on animations that are not slowed down by Stop Watch or Broken Watch, such
--- as player animations.
+-- of the animation. (The `PlaybackSpeed` field of the sprite is not used.) Thus, it is only safe to
+-- use this function on animations that are not slowed down by Stop Watch or Broken Watch, such as
+-- player animations.
 function ____exports.getLastFrameOfAnimation(self, sprite, animation)
     local currentAnimation = sprite:GetAnimation()
     local currentFrame = sprite:GetFrame()

package/dist/functions/tears.d.ts

@@ -1,13 +1,14 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
 /**
- * - Converts the specified amount of tears stat into MaxFireDelay and adds it to the player.
- * - This function should only be used inside the EvaluateCache callback.
+ * - Converts the specified amount of tears stat into the format of `EntityPlayer.MaxFireDelay` and
+ *   adds it to the player.
+ * - This function should only be used inside the `EVALUATE_CACHE` callback.
  * - In this context, the "tears stat" represents what is shown on the in-game stat UI.
  */
 export declare function addTearsStat(player: EntityPlayer, tearsStat: float): void;
 /**
- * - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` attribute. This is
+ * - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` field. This is
  *   equivalent to how many tears the player can shoot per frame.
  * - If you already have a "tears" stat and you want to convert it back to MaxFireDelay, then use
  *   this function.
@@ -15,7 +16,7 @@ export declare function addTearsStat(player: EntityPlayer, tearsStat: float): vo
  */
 export declare function getFireDelay(tearsStat: float): float;
 /**
- * - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` attribute. This is
+ * - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` field. This is
  *   equivalent to how many tears the player can shoot per frame.
  * - If you want to convert this to the "tears" stat that is shown on the in-game stat UI, then use
  *   this function.

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

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

package/dist/functions/tears.lua

@@ -1,5 +1,5 @@
 local ____exports = {}
---- - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` attribute. This is
+--- - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` field. This is
 --   equivalent to how many tears the player can shoot per frame.
 -- - If you already have a "tears" stat and you want to convert it back to MaxFireDelay, then use
 --   this function.
@@ -7,15 +7,16 @@ local ____exports = {}
 function ____exports.getFireDelay(self, tearsStat)
     return math.max(30 / tearsStat - 1, -0.9999)
 end
---- - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` attribute. This is
+--- - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` field. This is
 --   equivalent to how many tears the player can shoot per frame.
 -- - If you want to convert this to the "tears" stat that is shown on the in-game stat UI, then use
 --   this function.
 function ____exports.getTearsStat(self, fireDelay)
     return 30 / (fireDelay + 1)
 end
---- - Converts the specified amount of tears stat into MaxFireDelay and adds it to the player.
--- - This function should only be used inside the EvaluateCache callback.
+--- - Converts the specified amount of tears stat into the format of `EntityPlayer.MaxFireDelay` and
+--   adds it to the player.
+-- - This function should only be used inside the `EVALUATE_CACHE` callback.
 -- - In this context, the "tears stat" represents what is shown on the in-game stat UI.
 function ____exports.addTearsStat(self, player, tearsStat)
     local existingTearsStat = ____exports.getTearsStat(nil, player.MaxFireDelay)

package/dist/functions/utils.d.ts

@@ -85,9 +85,12 @@ export declare function repeat(n: int, func: (i: int) => void): void;
  * When you see this function, it simply means that the programmer intends to add in more code to
  * this spot later.
  *
+ * This function is variadic, meaning that you can pass as many arguments as you want. (This is
+ * useful as a means to prevent lint warnings.)
+ *
  * This function does not actually do anything. (It is an "empty" function.)
  */
-export declare function todo(): void;
+export declare function todo(...args: unknown[]): void;
 /**
  * Helper function to sort a two-dimensional array by the first element.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/functions/utils.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAYnD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAMnE;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAYnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAGxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAI3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAAG;AAE/B;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAYhE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/functions/utils.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAYnD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAMnE;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAYnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAGxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAI3D;AAED;;;;;;;;;;;;GAYG;AAEH,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAG;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAYhE"}

package/dist/functions/utils.lua

@@ -158,8 +158,11 @@ end
 -- When you see this function, it simply means that the programmer intends to add in more code to
 -- this spot later.
 -- 
+-- This function is variadic, meaning that you can pass as many arguments as you want. (This is
+-- useful as a means to prevent lint warnings.)
+-- 
 -- This function does not actually do anything. (It is an "empty" function.)
-function ____exports.todo(self)
+function ____exports.todo(self, ...)
 end
 --- Helper function to sort a two-dimensional array by the first element.
 -- 

package/dist/functions/vector.d.ts

@@ -26,7 +26,7 @@ export declare function getRandomVector(seedOrRNG?: Seed | RNG): Vector;
  * manager and/or the `deepCopy` function.
  */
 export declare function isSerializedVector(object: unknown): object is SerializedVector;
-/** Helper function to check if something is an instantiated Vector object. */
+/** Helper function to check if something is an instantiated `Vector` object. */
 export declare function isVector(object: unknown): object is Vector;
 /**
  * Helper function to convert a `Vector` object to a `SerializedVector` object. (This is used by the

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

@@ -1 +1 @@
-{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/functions/vector.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AASzD,oBAAY,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyBlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,gBAAgB,CAM5B;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAG3D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,MAAM,CAIpE"}
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/functions/vector.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AASzD,oBAAY,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyBlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,gBAAgB,CAM5B;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAG3D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,MAAM,CAIpE"}

package/dist/functions/vector.lua

@@ -19,12 +19,12 @@ local getNumbersFromTable = ____table.getNumbersFromTable
 local tableHasKeys = ____table.tableHasKeys
 local ____types = require("functions.types")
 local isTable = ____types.isTable
---- Helper function to check if something is an instantiated Vector object.
+--- Helper function to check if something is an instantiated `Vector` object.
 function ____exports.isVector(self, object)
     return isIsaacAPIClassOfType(nil, object, OBJECT_NAME)
 end
-local KEYS = {"X", "Y"}
 OBJECT_NAME = "Vector"
+local KEYS = {"X", "Y"}
 --- Helper function to copy a `Vector` Isaac API class.
 function ____exports.copyVector(self, vector)
     if not ____exports.isVector(nil, vector) then

package/dist/initCustomCallbacks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initCustomCallbacks.d.ts","sourceRoot":"","sources":["../src/initCustomCallbacks.ts"],"names":[],"mappings":"AAqEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAsE1D"}
+{"version":3,"file":"initCustomCallbacks.d.ts","sourceRoot":"","sources":["../src/initCustomCallbacks.ts"],"names":[],"mappings":"AAsEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAuE1D"}

package/dist/initCustomCallbacks.lua

@@ -77,6 +77,8 @@ local ____postPitUpdate = require("callbacks.postPitUpdate")
 local postPitUpdateInit = ____postPitUpdate.postPitUpdateInit
 local ____postPlayerChangeHealth = require("callbacks.postPlayerChangeHealth")
 local postPlayerChangeHealthInit = ____postPlayerChangeHealth.postPlayerChangeHealthInit
+local ____postPlayerChangeStat = require("callbacks.postPlayerChangeStat")
+local postPlayerChangeStatInit = ____postPlayerChangeStat.postPlayerChangeStatInit
 local ____postPlayerChangeType = require("callbacks.postPlayerChangeType")
 local postPlayerChangeTypeInit = ____postPlayerChangeType.postPlayerChangeTypeInit
 local ____postPlayerCollectible = require("callbacks.postPlayerCollectible")
@@ -177,6 +179,7 @@ function ____exports.initCustomCallbacks(self, mod)
     postPitRenderInit(nil, mod)
     postPitUpdateInit(nil, mod)
     postPlayerChangeHealthInit(nil, mod)
+    postPlayerChangeStatInit(nil, mod)
     postPlayerChangeTypeInit(nil, mod)
     postPlayerCollectibleCallbacksInit(nil, mod)
     postPlayerFatalDamageInit(nil, mod)

package/dist/interfaces/ChargeBarSprites.d.ts

@@ -3,7 +3,7 @@
 /**
  * A collection of the four sprites necessary in order to render a charge bar.
  *
- * Used in the `newChargeBarSprites` and related helper functions.
+ * This is used in the `newChargeBarSprites` and related helper functions.
  */
 export interface ChargeBarSprites {
     back: Sprite;