isaacscript-common 13.1.1 → 13.3.0

package/dist/src/callbacks/customRevive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customRevive.d.ts","sourceRoot":"","sources":["../../../src/callbacks/customRevive.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA0CrD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBhE"}
+{"version":3,"file":"customRevive.d.ts","sourceRoot":"","sources":["../../../src/callbacks/customRevive.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA2CrD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBhE"}

package/dist/src/callbacks/customRevive.lua

@@ -20,7 +20,8 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local removeAllFamiliars = ____entitiesSpecific.removeAllFamiliars
 local ____log = require("src.functions.log")
 local log = ____log.log
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local ____playerIndex = require("src.functions.playerIndex")
 local getPlayerFromIndex = ____playerIndex.getPlayerFromIndex
 local getPlayerIndex = ____playerIndex.getPlayerIndex

package/dist/src/callbacks/postNewRoomEarly.lua

@@ -8,8 +8,8 @@ local game = ____cachedClasses.game
 local ____gridEntities = require("src.functions.gridEntities")
 local getTopLeftWallGridIndex = ____gridEntities.getTopLeftWallGridIndex
 local spawnGridEntity = ____gridEntities.spawnGridEntity
-local ____log = require("src.functions.log")
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local ____postNewRoomEarly = require("src.callbacks.subscriptions.postNewRoomEarly")
 local postNewRoomEarlyFire = ____postNewRoomEarly.postNewRoomEarlyFire
 local postNewRoomEarlyHasSubscriptions = ____postNewRoomEarly.postNewRoomEarlyHasSubscriptions

package/dist/src/classes/ModUpgraded.d.ts

@@ -4,7 +4,8 @@ import { AddCallbackParameterCustom } from "../interfaces/private/AddCallbackPar
 /**
  * `isaacscript-common` has many custom callbacks that you can use in your mods. Instead of
  * hijacking the vanilla `Mod` object, we provide a `ModUpgraded` object for you to use, which
- * extends the base class and adds a new method of `AddCallbackCustom`.
+ * extends the base class and adds a new method of `AddCallbackCustom`. (There is no corresponding
+ * `RemoveCallbackCustom`.)
  *
  * To upgrade your mod, use the `upgradeMod` helper function.
  */
@@ -16,7 +17,9 @@ export declare class ModUpgraded implements Mod {
     Name: string;
     /** We store a copy of the original mod object so that we can re-implement its functions. */
     Mod: Mod;
-    constructor(mod: Mod);
+    Debug: boolean;
+    TimeThreshold: float | undefined;
+    constructor(mod: Mod, debug: boolean, timeThreshold?: float);
     AddCallback<T extends ModCallback>(modCallback: T, ...args: AddCallbackParameter[T]): void;
     HasData(): boolean;
     LoadData(): string;

package/dist/src/classes/ModUpgraded.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModUpgraded.d.ts","sourceRoot":"","sources":["../../../src/classes/ModUpgraded.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAG9F;;;;;;GAMG;AACH,qBAAa,WAAY,YAAW,GAAG;IAKrC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAMb,4FAA4F;IAC5F,GAAG,EAAE,GAAG,CAAC;gBAEG,GAAG,EAAE,GAAG;IAUpB,WAAW,CAAC,CAAC,SAAS,WAAW,EAC/B,WAAW,EAAE,CAAC,EACd,GAAG,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,IAAI;IAIP,OAAO,IAAI,OAAO;IAIlB,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,cAAc,CAAC,CAAC,SAAS,WAAW,EAClC,WAAW,EAAE,CAAC,EACd,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAIP,UAAU,IAAI,IAAI;IAIlB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS5B,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,EAC3C,iBAAiB,EAAE,CAAC,EACpB,GAAG,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,GACrC,IAAI;CAKR"}
+{"version":3,"file":"ModUpgraded.d.ts","sourceRoot":"","sources":["../../../src/classes/ModUpgraded.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAG9F;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,GAAG;IAKrC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAMb,4FAA4F;IAC5F,GAAG,EAAE,GAAG,CAAC;IAET,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC;gBAErB,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,KAAK;IAW3D,WAAW,CAAC,CAAC,SAAS,WAAW,EAC/B,WAAW,EAAE,CAAC,EACd,GAAG,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,IAAI;IAoCP,OAAO,IAAI,OAAO;IAIlB,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,cAAc,CAAC,CAAC,SAAS,WAAW,EAClC,WAAW,EAAE,CAAC,EACd,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAIP,UAAU,IAAI,IAAI;IAIlB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS5B,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,EAC3C,iBAAiB,EAAE,CAAC,EACpB,GAAG,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,GACrC,IAAI;CAKR"}

package/dist/src/classes/ModUpgraded.lua

@@ -1,22 +1,58 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
+local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____benchmark = require("src.functions.benchmark")
+local getTime = ____benchmark.getTime
+local ____log = require("src.functions.log")
+local log = ____log.log
 local ____callbackRegisterFunctions = require("src.objects.callbackRegisterFunctions")
 local CALLBACK_REGISTER_FUNCTIONS = ____callbackRegisterFunctions.CALLBACK_REGISTER_FUNCTIONS
 --- `isaacscript-common` has many custom callbacks that you can use in your mods. Instead of
 -- hijacking the vanilla `Mod` object, we provide a `ModUpgraded` object for you to use, which
--- extends the base class and adds a new method of `AddCallbackCustom`.
+-- extends the base class and adds a new method of `AddCallbackCustom`. (There is no corresponding
+-- `RemoveCallbackCustom`.)
 -- 
 -- To upgrade your mod, use the `upgradeMod` helper function.
 ____exports.ModUpgraded = __TS__Class()
 local ModUpgraded = ____exports.ModUpgraded
 ModUpgraded.name = "ModUpgraded"
-function ModUpgraded.prototype.____constructor(self, mod)
+function ModUpgraded.prototype.____constructor(self, mod, ____debug, timeThreshold)
     self.Name = mod.Name
     self.Mod = mod
+    self.Debug = ____debug
+    self.TimeThreshold = timeThreshold
 end
 function ModUpgraded.prototype.AddCallback(self, modCallback, ...)
-    self.Mod:AddCallback(modCallback, ...)
+    local args = {...}
+    if self.Debug then
+        local callback = args[1]
+        local optionalArg = args[2]
+        local callbackName = "ModCallback." .. tostring(ModCallback[modCallback])
+        local function callbackWithLogger(____, ...)
+            local startTime = getTime(nil)
+            log(nil, callbackName .. " - START")
+            callback(nil, ...)
+            local endTime = getTime(nil)
+            local elapsedTime = endTime - startTime
+            if self.TimeThreshold == nil or self.TimeThreshold >= elapsedTime then
+                log(
+                    nil,
+                    (callbackName .. " - END - time: ") .. tostring(elapsedTime)
+                )
+            else
+                log(nil, callbackName .. " - END")
+            end
+        end
+        self.Mod:AddCallback(modCallback, callbackWithLogger, optionalArg)
+    else
+        self.Mod:AddCallback(
+            modCallback,
+            __TS__Spread(args)
+        )
+    end
 end
 function ModUpgraded.prototype.HasData(self)
     return self.Mod:HasData()

package/dist/src/core/upgradeMod.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 import { ModUpgraded } from "../classes/ModUpgraded";
 /**
  * Use this function to enable the custom callbacks and other optional features provided by
@@ -18,7 +19,11 @@ import { ModUpgraded } from "../classes/ModUpgraded";
  * ```
  *
  * @param modVanilla The mod object returned by the `RegisterMod` function.
+ * @param debug Optional. Whether to log additional output when a callback is fired. Default is
+ *              false.
+ * @param timeThreshold Optional. If provided, will only log callbacks that take longer than the
+ *                      specified number of seconds.
  * @returns The upgraded mod object.
  */
-export declare function upgradeMod(modVanilla: Mod): ModUpgraded;
+export declare function upgradeMod(modVanilla: Mod, debug?: boolean, timeThreshold?: float): ModUpgraded;
 //# sourceMappingURL=upgradeMod.d.ts.map

package/dist/src/core/upgradeMod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgradeMod.d.ts","sourceRoot":"","sources":["../../../src/core/upgradeMod.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,GAAG,GAAG,WAAW,CAwBvD"}
+{"version":3,"file":"upgradeMod.d.ts","sourceRoot":"","sources":["../../../src/core/upgradeMod.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,GAAG,EACf,KAAK,UAAQ,EACb,aAAa,CAAC,EAAE,KAAK,GACpB,WAAW,CAwBb"}

package/dist/src/core/upgradeMod.lua

@@ -35,9 +35,16 @@ local loadShaderCrashFix = ____shaderCrashFix.loadShaderCrashFix
 -- ```
 -- 
 -- @param modVanilla The mod object returned by the `RegisterMod` function.
+-- @param debug Optional. Whether to log additional output when a callback is fired. Default is
+-- false.
+-- @param timeThreshold Optional. If provided, will only log callbacks that take longer than the
+-- specified number of seconds.
 -- @returns The upgraded mod object.
-function ____exports.upgradeMod(self, modVanilla)
-    local mod = __TS__New(ModUpgraded, modVanilla)
+function ____exports.upgradeMod(self, modVanilla, ____debug, timeThreshold)
+    if ____debug == nil then
+        ____debug = false
+    end
+    local mod = __TS__New(ModUpgraded, modVanilla, ____debug, timeThreshold)
     if not areFeaturesInitialized(nil) then
         setFeaturesInitialized(nil)
         patchErrorFunction(nil)

package/dist/src/features/customStage/exports.lua

@@ -15,8 +15,8 @@ local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
 local ____doors = require("src.functions.doors")
 local doorSlotFlagsToDoorSlots = ____doors.doorSlotFlagsToDoorSlots
-local ____log = require("src.functions.log")
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local ____rng = require("src.functions.rng")
 local newRNG = ____rng.newRNG
 local ____rooms = require("src.functions.rooms")

package/dist/src/features/deployJSONRoom.d.ts

@@ -63,4 +63,25 @@ export declare function deployJSONRoom(jsonRoom: JSONRoom | Readonly<JSONRoom>,
  *                what the function is doing. Default is false.
  */
 export declare function deployRandomJSONRoom(jsonRooms: JSONRoom[], seedOrRNG?: Seed | RNG, verbose?: boolean): void;
+/**
+ * Helper function to prevent any removed grid entities from respawning if the player re-enters the
+ * room.
+ *
+ * This is accomplished by spawning a new grid entity on every tile that does not already have a
+ * grid entity. This will force the game to spawn the new grid entity instead of the old one. The
+ * natural grid entity to choose for this purpose is a decoration, since it is non-interacting.
+ * Then, the decorations are made invisible and any shovel uses are intercepted to avoid creating a
+ * crawl space (instead of a trapdoor).
+ *
+ * Another option besides decorations would be to use a pressure plates with a state of 1, which is
+ * a state that is normally unused by the game and makes it invisible & persistent. However, pickups
+ * will not be able to spawn on pressure plates, which lead to various bugs (e.g. pickups spawning
+ * on top of pits). Thus, using a decoration is preferable.
+ *
+ * Yet another option to accomplish this would be to replace the room data with that of an empty
+ * room. However, the room data must exactly match the room type, the room shape, and the doors, so
+ * this is not possible to do in a robust way without adding empty rooms to the mod's `content`
+ * folder to draw the data from.
+ */
+export declare function preventGridEntityRespawn(): void;
 //# sourceMappingURL=deployJSONRoom.d.ts.map

package/dist/src/features/deployJSONRoom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployJSONRoom.d.ts","sourceRoot":"","sources":["../../../src/features/deployJSONRoom.ts"],"names":[],"mappings":";;AAgDA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAwKvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,EACvC,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,IAAI,CA4BN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,EAAE,EACrB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,IAAI,CAaN"}
+{"version":3,"file":"deployJSONRoom.d.ts","sourceRoot":"","sources":["../../../src/features/deployJSONRoom.ts"],"names":[],"mappings":";;AAiDA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AA6KvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,EACvC,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,IAAI,CA4BN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,EAAE,EACrB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CA0B/C"}

package/dist/src/features/deployJSONRoom.lua

@@ -4,7 +4,7 @@ local __TS__New = ____lualib.__TS__New
 local Map = ____lualib.Map
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
-local preUseItemWeNeedToGoDeeper, postNewRoomReordered, setDecorationsInvisible, respawnPersistentEntities, fillRoomWithDecorations, spawnAllEntities, spawnGridEntityForJSONRoom, spawnNormalEntityForJSONRoom, storePersistentEntity, fixPitGraphics, getPitMap, getPitFrame, PERSISTENT_ENTITY_TYPES, GRID_ENTITY_XML_TYPE_SET, v
+local preUseItemWeNeedToGoDeeper, postNewRoomReordered, setDecorationsInvisible, respawnPersistentEntities, spawnAllEntities, spawnGridEntityForJSONRoom, spawnNormalEntityForJSONRoom, storePersistentEntity, fixPitGraphics, getPitMap, getPitFrame, FEATURE_NAME, PERSISTENT_ENTITY_TYPES, GRID_ENTITY_XML_TYPE_SET, v
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local EntityCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.EntityCollisionClass
@@ -40,6 +40,7 @@ local getAllGridIndexes = ____gridEntities.getAllGridIndexes
 local getGridEntities = ____gridEntities.getGridEntities
 local removeGridEntity = ____gridEntities.removeGridEntity
 local setGridEntityInvisible = ____gridEntities.setGridEntityInvisible
+local spawnGridEntity = ____gridEntities.spawnGridEntity
 local spawnGridEntityWithVariant = ____gridEntities.spawnGridEntityWithVariant
 local ____jsonRoom = require("src.functions.jsonRoom")
 local getRandomJSONEntity = ____jsonRoom.getRandomJSONEntity
@@ -90,12 +91,16 @@ function preUseItemWeNeedToGoDeeper(self, _collectibleType, _rng, player, _useFl
             if futurePlayer == nil then
                 return
             end
+            local futureRoomListIndex = getRoomListIndex(nil)
+            if futureRoomListIndex ~= roomListIndex then
+                return
+            end
             v.room.manuallyUsingShovel = true
             futurePlayer:UseActiveItem(CollectibleType.WE_NEED_TO_GO_DEEPER)
             v.room.manuallyUsingShovel = false
             local decorationGridIndexes = v.level.roomToDecorationGridIndexesMap:getAndSetDefault(roomListIndex)
             emptyArray(nil, decorationGridIndexes)
-            fillRoomWithDecorations(nil)
+            ____exports.preventGridEntityRespawn(nil)
         end
     )
     return true
@@ -137,24 +142,43 @@ function respawnPersistentEntities(self)
         )
     end
 end
-function fillRoomWithDecorations(self)
+--- Helper function to prevent any removed grid entities from respawning if the player re-enters the
+-- room.
+-- 
+-- This is accomplished by spawning a new grid entity on every tile that does not already have a
+-- grid entity. This will force the game to spawn the new grid entity instead of the old one. The
+-- natural grid entity to choose for this purpose is a decoration, since it is non-interacting.
+-- Then, the decorations are made invisible and any shovel uses are intercepted to avoid creating a
+-- crawl space (instead of a trapdoor).
+-- 
+-- Another option besides decorations would be to use a pressure plates with a state of 1, which is
+-- a state that is normally unused by the game and makes it invisible & persistent. However, pickups
+-- will not be able to spawn on pressure plates, which lead to various bugs (e.g. pickups spawning
+-- on top of pits). Thus, using a decoration is preferable.
+-- 
+-- Yet another option to accomplish this would be to replace the room data with that of an empty
+-- room. However, the room data must exactly match the room type, the room shape, and the doors, so
+-- this is not possible to do in a robust way without adding empty rooms to the mod's `content`
+-- folder to draw the data from.
+function ____exports.preventGridEntityRespawn(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
     local room = game:GetRoom()
     local roomListIndex = getRoomListIndex(nil)
+    v.level.deployedRoomListIndexes:add(roomListIndex)
     local decorationGridIndexes = v.level.roomToDecorationGridIndexesMap:getAndSetDefault(roomListIndex)
     for ____, gridIndex in ipairs(getAllGridIndexes(nil)) do
         do
             local existingGridEntity = room:GetGridEntity(gridIndex)
             if existingGridEntity ~= nil then
-                goto __continue31
+                goto __continue32
             end
-            local position = room:GetGridPosition(gridIndex)
-            local decoration = Isaac.GridSpawn(GridEntityType.DECORATION, 0, position)
+            local decoration = spawnGridEntity(nil, GridEntityType.DECORATION, gridIndex)
             if decoration ~= nil then
                 setGridEntityInvisible(nil, decoration)
             end
             decorationGridIndexes[#decorationGridIndexes + 1] = gridIndex
         end
-        ::__continue31::
+        ::__continue32::
     end
 end
 function spawnAllEntities(self, jsonRoom, rng, verbose)
@@ -411,7 +435,7 @@ function getPitFrame(self, L, R, U, D, UL, UR, DL, DR)
     end
     return F
 end
-local FEATURE_NAME = "deployJSONRoom"
+FEATURE_NAME = "deployJSONRoom"
 PERSISTENT_ENTITY_TYPES = __TS__New(Set, {EntityType.WALL_HUGGER})
 local gridEntityXMLTypes = getEnumValues(nil, GridEntityXMLType)
 GRID_ENTITY_XML_TYPE_SET = __TS__New(Set, gridEntityXMLTypes)
@@ -489,7 +513,7 @@ function ____exports.deployJSONRoom(self, jsonRoom, seedOrRNG, verbose)
         log(nil, "Finished spawning all of the new entities and grid entities.")
     end
     fixPitGraphics(nil)
-    fillRoomWithDecorations(nil)
+    ____exports.preventGridEntityRespawn(nil)
 end
 --- Helper function to deconstruct a vanilla room and set up a custom room in its place.
 -- Specifically, this will clear the current room of all entities and grid entities, and then spawn

package/dist/src/features/extraConsoleCommands/listCommands.lua

@@ -59,11 +59,11 @@ local ____gridEntities = require("src.functions.gridEntities")
 local spawnGridEntity = ____gridEntities.spawnGridEntity
 local ____levelGrid = require("src.functions.levelGrid")
 local getRoomGridIndexesForType = ____levelGrid.getRoomGridIndexesForType
-local ____log = require("src.functions.log")
-local logPlayerEffects = ____log.logPlayerEffects
-local logRoom = ____log.logRoom
-local logSeedEffects = ____log.logSeedEffects
-local logSounds = ____log.logSounds
+local ____logMisc = require("src.functions.logMisc")
+local logPlayerEffects = ____logMisc.logPlayerEffects
+local logRoom = ____logMisc.logRoom
+local logSeedEffects = ____logMisc.logSeedEffects
+local logSounds = ____logMisc.logSounds
 local ____map = require("src.functions.map")
 local getMapPartialMatch = ____map.getMapPartialMatch
 local ____mergeTests = require("src.functions.mergeTests")

package/dist/src/features/pause.lua

@@ -21,8 +21,8 @@ local removeAllProjectiles = ____entitiesSpecific.removeAllProjectiles
 local removeAllTears = ____entitiesSpecific.removeAllTears
 local ____isaacAPIClass = require("src.functions.isaacAPIClass")
 local isTear = ____isaacAPIClass.isTear
-local ____log = require("src.functions.log")
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local ____playerIndex = require("src.functions.playerIndex")
 local getAllPlayers = ____playerIndex.getAllPlayers
 local ____players = require("src.functions.players")

package/dist/src/features/saveDataManager/load.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/load.ts"],"names":[],"mappings":";;AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AASrD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GACpC,IAAI,CAuDN"}
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/load.ts"],"names":[],"mappings":";;AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AASrD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GACpC,IAAI,CAuDN"}

package/dist/src/features/saveDataManager/load.lua

@@ -6,7 +6,8 @@ local ____jsonHelpers = require("src.functions.jsonHelpers")
 local jsonDecode = ____jsonHelpers.jsonDecode
 local ____log = require("src.functions.log")
 local log = ____log.log
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local ____table = require("src.functions.table")
 local iterateTableInOrder = ____table.iterateTableInOrder
 local ____types = require("src.functions.types")

package/dist/src/features/saveDataManager/main.lua

@@ -16,8 +16,8 @@ local ____SerializationType = require("src.enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
 local ____deepCopy = require("src.functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
-local ____log = require("src.functions.log")
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local ____stage = require("src.functions.stage")
 local onFirstFloor = ____stage.onFirstFloor
 local ____table = require("src.functions.table")

package/dist/src/features/taintedLazarusPlayers.lua

@@ -8,8 +8,8 @@ local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local ____featuresInitialized = require("src.featuresInitialized")
 local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____log = require("src.functions.log")
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local ____exports = require("src.features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 function postPlayerInit(self, player)

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

@@ -13,4 +13,16 @@
  *          be printed to the log.)
  */
 export declare function benchmark(numTrials: int, ...functions: Array<() => void>): int[];
+/**
+ * Helper function to get the current time in seconds for benchmarking / profiling purposes.
+ *
+ * - If the "--luadebug" flag is enabled, then this function will use the `socket.gettime` method,
+ *   which returns the epoch timestamp in seconds (e.g. "1640320492.5779"). This is preferable over
+ *   the `Isaac.GetTime` method, since it has one extra decimal point of precision.
+ * - If the "--luadebug" flag is disabled, then this function will use the `Isaac.GetTime` method,
+ *   which returns the number of seconds since the computer's operating system was started (e.g.
+ *   "739454.963"). (The milliseconds return value of `Isaac.GetTime` is converted to seconds to
+ *   align with the return value of `socket.gettime`.)
+ */
+export declare function getTime(): float;
 //# sourceMappingURL=benchmark.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../../src/functions/benchmark.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,GAAG,EACd,GAAG,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,GAC9B,GAAG,EAAE,CAsBP"}
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../../src/functions/benchmark.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,GAAG,EACd,GAAG,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,GAC9B,GAAG,EAAE,CAsBP;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,IAAI,KAAK,CAS/B"}

package/dist/src/functions/benchmark.lua

@@ -1,6 +1,8 @@
 local ____lualib = require("lualib_bundle")
 local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local ____exports = {}
+local ____constants = require("src.core.constants")
+local SECOND_IN_MILLISECONDS = ____constants.SECOND_IN_MILLISECONDS
 local ____log = require("src.functions.log")
 local log = ____log.log
 --- Helper function to benchmark the performance of a function.
@@ -46,4 +48,21 @@ function ____exports.benchmark(self, numTrials, ...)
     )
     return averages
 end
+--- Helper function to get the current time in seconds for benchmarking / profiling purposes.
+-- 
+-- - If the "--luadebug" flag is enabled, then this function will use the `socket.gettime` method,
+--   which returns the epoch timestamp in seconds (e.g. "1640320492.5779"). This is preferable over
+--   the `Isaac.GetTime` method, since it has one extra decimal point of precision.
+-- - If the "--luadebug" flag is disabled, then this function will use the `Isaac.GetTime` method,
+--   which returns the number of seconds since the computer's operating system was started (e.g.
+--   "739454.963"). (The milliseconds return value of `Isaac.GetTime` is converted to seconds to
+--   align with the return value of `socket.gettime`.)
+function ____exports.getTime(self)
+    local ok, requiredSocket = pcall(require, "socket")
+    if ok then
+        local socket = requiredSocket
+        return socket.gettime()
+    end
+    return Isaac.GetTime() / SECOND_IN_MILLISECONDS
+end
 return ____exports

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

@@ -46,6 +46,7 @@ export declare function isLuaDebugEnabled(): boolean;
  * This is useful when printing out variables from the in-game debug console.
  */
 export declare function setLogFunctionsGlobal(): void;
+export declare function setTracebackFunctionsGlobal(): void;
 /**
  * Helper function to print a stack trace to the "log.txt" file, similar to JavaScript's
  * `console.trace` function.

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

@@ -1 +1 @@
-{"version":3,"file":"debugFunctions.d.ts","sourceRoot":"","sources":["../../../src/functions/debugFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AASrD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAMxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAU5C;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAGhC"}
+{"version":3,"file":"debugFunctions.d.ts","sourceRoot":"","sources":["../../../src/functions/debugFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAUrD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAS5C;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAGhC"}

package/dist/src/functions/debugFunctions.lua

@@ -1,7 +1,6 @@
 local ____lualib = require("lualib_bundle")
 local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local ____exports = {}
-local setDebugFunctionsGlobal
 local ____exports = require("src.features.extraConsoleCommands.exports")
 local enableExtraConsoleCommands = ____exports.enableExtraConsoleCommands
 local ____fadeInRemover = require("src.features.fadeInRemover")
@@ -14,6 +13,7 @@ local logExports = require("src.functions.log")
 local ____log = require("src.functions.log")
 local log = ____log.log
 local logEntitiesExports = require("src.functions.logEntities")
+local logMiscExports = require("src.functions.logMisc")
 --- Helper function to get a stack trace.
 -- 
 -- This will only work if the `--luadebug` launch option is enabled or the Racing+ sandbox is
@@ -22,8 +22,8 @@ function ____exports.getTraceback(self)
     if debug ~= nil then
         return debug.traceback()
     end
-    if sandboxGetTraceback ~= nil then
-        return sandboxGetTraceback()
+    if SandboxGetTraceback ~= nil then
+        return SandboxGetTraceback()
     end
     return "stack traceback:\n(the \"--luadebug\" flag is not enabled)"
 end
@@ -32,17 +32,19 @@ end
 -- This is useful when printing out variables from the in-game debug console.
 function ____exports.setLogFunctionsGlobal(self)
     local globals = _G
-    for ____, ____value in ipairs(__TS__ObjectEntries(logExports)) do
-        local logFuncName = ____value[1]
-        local logFunc = ____value[2]
-        globals[logFuncName] = logFunc
-    end
-    for ____, ____value in ipairs(__TS__ObjectEntries(logEntitiesExports)) do
-        local logFuncName = ____value[1]
-        local logFunc = ____value[2]
-        globals[logFuncName] = logFunc
+    for ____, exports in ipairs({logExports, logMiscExports, logEntitiesExports}) do
+        for ____, ____value in ipairs(__TS__ObjectEntries(exports)) do
+            local logFuncName = ____value[1]
+            local logFunc = ____value[2]
+            globals[logFuncName] = logFunc
+        end
     end
 end
+function ____exports.setTracebackFunctionsGlobal(self)
+    local globals = _G
+    globals.getTraceback = ____exports.getTraceback
+    globals.traceback = ____exports.traceback
+end
 --- Helper function to print a stack trace to the "log.txt" file, similar to JavaScript's
 -- `console.trace` function.
 -- 
@@ -52,14 +54,6 @@ function ____exports.traceback(self)
     local tracebackOutput = ____exports.getTraceback(nil)
     log(nil, tracebackOutput)
 end
-function setDebugFunctionsGlobal(self)
-    if _G.debug == nil and sandboxGetTraceback == nil then
-        return
-    end
-    local globals = _G
-    globals.getTraceback = ____exports.getTraceback
-    globals.traceback = ____exports.traceback
-end
 --- Helper function to enable some IsaacScript features that are useful when developing a mod. They
 -- should not be enabled when your mod goes to production (i.e. when it is uploaded to the Steam
 -- Workshop).
@@ -78,6 +72,7 @@ end
 function ____exports.enableDevFeatures(self, mod)
     saveDataManagerSetGlobal(nil)
     ____exports.setLogFunctionsGlobal(nil)
+    ____exports.setTracebackFunctionsGlobal(nil)
     enableExtraConsoleCommands(nil, mod)
     enableFastReset(nil)
     removeFadeIn(nil)
@@ -98,7 +93,4 @@ end
 function ____exports.isLuaDebugEnabled(self)
     return _G.package ~= nil
 end
-if ____exports.isLuaDebugEnabled(nil) or sandboxGetTraceback ~= nil then
-    setDebugFunctionsGlobal(nil)
-end
 return ____exports

package/dist/src/functions/globals.lua

@@ -15,7 +15,7 @@ local copySet = ____set.copySet
 local ____utils = require("src.functions.utils")
 local twoDimensionalSort = ____utils.twoDimensionalSort
 function isRacingPlusSandboxEnabled(self)
-    return getParentFunctionDescription ~= nil
+    return SandboxGetParentFunctionDescription ~= nil
 end
 local DEFAULT_GLOBALS = __TS__New(Set, {
     "ActionTriggers",

package/dist/src/functions/hex.lua

@@ -3,8 +3,8 @@ local __TS__StringReplace = ____lualib.__TS__StringReplace
 local __TS__StringSubstring = ____lualib.__TS__StringSubstring
 local ____exports = {}
 local hexToRGB, HEX_STRING_LENGTH
-local ____log = require("src.functions.log")
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 function hexToRGB(self, hexString)
     hexString = __TS__StringReplace(hexString, "#", "")
     if #hexString ~= HEX_STRING_LENGTH then

package/dist/src/functions/jsonHelpers.lua

@@ -1,7 +1,7 @@
 local ____exports = {}
 local jsonLua = require("src.lib.jsonLua")
-local ____log = require("src.functions.log")
-local logError = ____log.logError
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
 local function tryDecode(jsonString)
     return jsonLua.decode(jsonString)
 end