isaacscript-common 13.2.0 → 13.3.1

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;IA2CP,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 getParentFunctionDescription = ____log.getParentFunctionDescription
 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 parentFunctionDescription = getParentFunctionDescription(nil)
+        local callbackName = "ModCallback." .. tostring(ModCallback[modCallback])
+        local signature = parentFunctionDescription == nil and callbackName or (parentFunctionDescription .. " - ") .. callbackName
+        --- We don't use the "log" helper function since it will always show the same "unknown" prefix.
+        local function callbackWithLogger(____, ...)
+            local startTime = getTime(nil)
+            Isaac.DebugString(signature .. " - START")
+            callback(nil, ...)
+            local endTime = getTime(nil)
+            local elapsedTime = endTime - startTime
+            if self.TimeThreshold == nil or self.TimeThreshold >= elapsedTime then
+                Isaac.DebugString((signature .. " - END - time: ") .. tostring(elapsedTime))
+            else
+                Isaac.DebugString(signature .. " - 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/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

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

@@ -1,9 +1,14 @@
-/// <reference types="@typescript-to-lua/language-extensions" />
-import { CollectibleType, DamageFlag, EntityFlag, ProjectileFlag, TearFlag, UseFlag } from "isaac-typescript-definitions";
 /**
- * Helper function to prefix the name of the function and the line number before a debug message.
+ * Helper function to get the name and the line number of the current calling function.
+ *
+ * For this function to work properly, the "--luadebug" flag must be enabled. Otherwise, it will
+ * always return undefined.
+ *
+ * @param levels Optional. The amount of levels to look backwards in the call stack. Default is 3
+ *               (because the first level is this function, the second level is the calling
+ *               function, and the third level is the parent of the calling function).
  */
-export declare function getDebugPrependString(msg: string, numParentFunctions?: number): string;
+export declare function getParentFunctionDescription(levels?: number): string | undefined;
 /**
  * Helper function to avoid typing out `Isaac.DebugString()`.
  *
@@ -11,70 +16,4 @@ export declare function getDebugPrependString(msg: string, numParentFunctions?:
  * function will also prepend the function name and the line number before the string.
  */
 export declare function log(msg: string): void;
-export declare function logArray<T>(array: T[] | readonly T[]): void;
-export declare function logCollectibleTypes(collectibleTypes: CollectibleType[]): void;
-export declare function logColor(color: Color): void;
-/** Helper function for printing out every damage flag that is turned on. Useful when debugging. */
-export declare function logDamageFlags(flags: DamageFlag | BitFlags<DamageFlag>): void;
-/** Helper function for printing out every entity flag that is turned on. Useful when debugging. */
-export declare function logEntityFlags(flags: EntityFlag | BitFlags<EntityFlag>): void;
-export declare function logEntityID(entity: Entity): void;
-/**
- * Helper function to log an error message and also print it to the console for better visibility.
- *
- * This is useful in situations where using the `error` function would be dangerous (since it
- * prevents all of the subsequent code in the callback from running).
- */
-export declare function logError(msg: string): void;
-/** Helper function for printing out every flag that is turned on. Useful when debugging. */
-export declare function logFlags<T extends BitFlag | BitFlag128>(flags: T | BitFlags<T>, flagEnum: Record<string, T>, description?: string): void;
-/**
- * Helper function for printing out every game state flag that is turned on. Useful when debugging.
- */
-export declare function logGameStateFlags(): void;
-export declare function logKColor(kColor: KColor): void;
-/**
- * Helper function for printing out every level state flag that is turned on. Useful when debugging.
- */
-export declare function logLevelStateFlags(): void;
-export declare function logMap(map: Map<AnyNotNil, unknown>): void;
-export declare function logPlayerEffects(player: EntityPlayer): void;
-export declare function logPlayerHealth(player: EntityPlayer): void;
-/**
- * Helper function for printing out every projectile flag that is turned on. Useful when debugging.
- */
-export declare function logProjectileFlags(flags: ProjectileFlag | BitFlags<ProjectileFlag>): void;
-/** Helper function for logging information about the current room. */
-export declare function logRoom(): void;
-/**
- * Helper function for printing out every seed effect (i.e. Easter Egg) that is turned on for the
- * particular run.
- */
-export declare function logSeedEffects(): void;
-export declare function logSet(set: Set<AnyNotNil> | ReadonlySet<AnyNotNil>): void;
-/** Helper function for logging every sound effect that is currently playing. */
-export declare function logSounds(): void;
-/**
- * Helper function for logging every key and value of a table. This is a deep log; the function will
- * recursively call itself if it counters a table within a table.
- *
- * This function will only work on tables that have string keys (because it logs the keys in order,
- * instead of randomly). It will throw a run-time error if it encounters a non-string key.
- */
-export declare function logTable(luaTable: unknown, parentTables?: number): void;
-/**
- * Helper function to print out the differences between the entries of two tables. Note that this
- * will only do a shallow comparison.
- */
-export declare function logTableDifferences<K extends AnyNotNil, V>(table1: LuaMap<K, V>, table2: LuaMap<K, V>): void;
-/** Helper function for printing out every tear flag that is turned on. Useful when debugging. */
-export declare function logTearFlags(flags: TearFlag | BitFlags<TearFlag>): void;
-/** Helper function for printing out every use flag that is turned on. Useful when debugging. */
-export declare function logUseFlags(flags: UseFlag | BitFlags<UseFlag>): void;
-/**
- * Helper function to enumerate all of the properties of a "userdata" object (i.e. an object from
- * the Isaac API).
- */
-export declare function logUserdata(userdata: unknown): void;
-export declare function logVector(vector: Vector, round?: boolean): void;
 //# sourceMappingURL=log.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/functions/log.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/functions/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAK1C,MAAM,SAAI,GACT,MAAM,GAAG,SAAS,CAiBpB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOrC"}