isaacscript-common 1.0.515 → 1.0.516

package/dist/functions/debug.d.ts

@@ -1,5 +1,9 @@
 /**
  * Helper function to print a stack trace to the "log.txt" file, similar to JavaScript's
- * `console.trace()` function. This will only work if the `--luadebug` launch option is enabled.
+ * `console.trace()` function. This will only work if the `--luadebug` launch option is enabled or
+ * the Racing+ sandbox is enabled.
+ *
+ * @param silent Optional. Whether or not to print an error message if the `--luadebug` launch
+ * option is not turned on. False by default.
  */
-export declare function traceback(): void;
+export declare function traceback(silent?: boolean): void;

package/dist/functions/debug.lua

@@ -1,6 +1,9 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-function ____exports.traceback(self)
+function ____exports.traceback(self, silent)
+    if silent == nil then
+        silent = false
+    end
     if debug ~= nil then
         local tracebackMsg = debug.traceback()
         Isaac.DebugString(tracebackMsg)
@@ -10,6 +13,8 @@ function ____exports.traceback(self)
         sandboxTraceback()
         return
     end
-    Isaac.DebugString("Error: Cannot perform a traceback since --luadebug is not enabled.")
+    if not silent then
+        Isaac.DebugString("Error: Cannot perform a traceback since --luadebug is not enabled.")
+    end
 end
 return ____exports

package/dist/functions/random.lua

@@ -1,14 +1,11 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
 local RECOMMENDED_SHIFT_IDX
-local ____debug = require("functions.debug")
-local traceback = ____debug.traceback
 function ____exports.initRNG(self, seed)
     if seed == nil then
         seed = Random()
     end
     if seed == 0 then
-        traceback(nil)
         error("You cannot initialize an RNG object with a seed of 0, or the game will crash.")
     end
     local rng = RNG()

package/dist/functions/rooms.d.ts

@@ -136,8 +136,9 @@ export declare function inStartingRoom(): boolean;
 /**
  * Helper function to loop through every room on the floor and see if it has been cleared.
  *
- * @param onlyCheckRoomTypes Optional. A whitelist of room types. Room types not in the provided
- * array will be ignored. If not specified, then all rooms will be checked. Undefined by default.
+ * @param onlyCheckRoomTypes Optional. A whitelist of room types. If specified, room types not in
+ * the array will be ignored. If not specified, then all rooms will be checked. Undefined by
+ * default.
  */
 export declare function isAllRoomsClear(onlyCheckRoomTypes?: RoomType[]): boolean;
 /**

package/dist/functions/util.d.ts

@@ -57,6 +57,18 @@ export declare function getEnumValues(transpiledEnum: unknown): int[];
  */
 export declare function hexToKColor(hexString: string, alpha: float): KColor;
 export declare function isGreedMode(): boolean;
+/**
+ * Players can boot the game with an launch option called "--luadebug", which will enable additional
+ * functionality that is considered to be unsafe. For more information about this flag, see the
+ * wiki: https://bindingofisaacrebirth.fandom.com/wiki/Launch_Options
+ *
+ * When this flag is enabled, the global environment will be slightly different. The differences are
+ * documented here: https://wofsauge.github.io/IsaacDocs/rep/Globals.html
+ *
+ * This function uses the `package` global variable as a proxy to determine if the "--luadebug" flag
+ * is enabled or not.
+ */
+export declare function isLuaDebugEnabled(): boolean;
 /**
  * Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
  * pressing tab on the character selection screen). When the player resets the game on a set seed,

package/dist/functions/util.lua

@@ -51,6 +51,9 @@ function ____exports.isGreedMode(self)
     local game = Game()
     return (game.Difficulty == Difficulty.DIFFICULTY_GREED) or (game.Difficulty == Difficulty.DIFFICULTY_GREEDIER)
 end
+function ____exports.isLuaDebugEnabled(self)
+    return package ~= nil
+end
 function ____exports.onSetSeed(self)
     local game = Game()
     local seeds = game:GetSeeds()

package/dist/patchErrorFunctions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * In Lua, the `error` function will tell you the line number of the error, but not give you a full
+ * traceback of the parent functions, which is unlike how JavaScript works. This function monkey
+ * patches the `error` function to add this functionality.
+ *
+ * Traceback functionality can only be added if the "--luadebug" flag is turned on, so this function
+ * does nothing if the "--luadebug" flag is disabled.
+ */
+export declare function patchErrorFunction(): void;

package/dist/patchErrorFunctions.lua

@@ -0,0 +1,26 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local errorWithTraceback, vanillaError
+local ____debug = require("functions.debug")
+local traceback = ____debug.traceback
+local ____util = require("functions.util")
+local isLuaDebugEnabled = ____util.isLuaDebugEnabled
+function errorWithTraceback(message, level)
+    if vanillaError == nil then
+        error(message, level)
+    end
+    traceback(nil)
+    vanillaError(message, level)
+end
+function ____exports.patchErrorFunction(self)
+    if not isLuaDebugEnabled(nil) then
+        return
+    end
+    if __PATCHED_ERROR ~= nil then
+        return
+    end
+    __PATCHED_ERROR = true
+    vanillaError = error
+    error = errorWithTraceback
+end
+return ____exports

package/dist/patchPrintFunction.d.ts

@@ -0,0 +1,8 @@
+/**
+ * When the "--luadebug" flag is enabled, the `print` function will no longer print messages to the
+ * "log.txt" file or the in-game console. This function monkey patches the `print` function to
+ * restore this functionality.
+ *
+ * If the "--luadebug" flag is disabled, this function will do nothing.
+ */
+export declare function patchPrintFunction(): void;

package/dist/patchPrintFunction.lua

@@ -0,0 +1,45 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local printForLuaDebug, getPrintMsg, getValueToPrint
+local ____util = require("functions.util")
+local isLuaDebugEnabled = ____util.isLuaDebugEnabled
+local ____vector = require("functions.vector")
+local isVector = ____vector.isVector
+function printForLuaDebug(...)
+    local args = {...}
+    local msg = getPrintMsg(nil, args)
+    Isaac.DebugString(msg)
+    local msgWithNewline = msg .. "\n"
+    Isaac.ConsoleOutput(msgWithNewline)
+end
+function getPrintMsg(self, args)
+    if #args == 0 then
+        return tostring(nil)
+    end
+    local msg = ""
+    for ____, arg in ipairs(args) do
+        if msg ~= "" then
+            msg = msg .. " "
+        end
+        msg = msg .. getValueToPrint(nil, arg)
+    end
+    return msg
+end
+function getValueToPrint(self, arg)
+    if isVector(nil, arg) then
+        local vector = arg
+        return ((("Vector(" .. tostring(vector.X)) .. ", ") .. tostring(vector.Y)) .. ")"
+    end
+    return tostring(arg)
+end
+function ____exports.patchPrintFunction(self)
+    if not isLuaDebugEnabled(nil) then
+        return
+    end
+    if __PATCHED_PRINT ~= nil then
+        return
+    end
+    __PATCHED_PRINT = true
+    print = printForLuaDebug
+end
+return ____exports

package/dist/upgradeMod.lua

@@ -77,6 +77,10 @@ local sirenHelpersInit = ____sirenHelpers.sirenHelpersInit
 local ____initialized = require("initialized")
 local areFeaturesInitialized = ____initialized.areFeaturesInitialized
 local setFeaturesInitialized = ____initialized.setFeaturesInitialized
+local ____patchErrorFunctions = require("patchErrorFunctions")
+local patchErrorFunction = ____patchErrorFunctions.patchErrorFunction
+local ____patchPrintFunction = require("patchPrintFunction")
+local patchPrintFunction = ____patchPrintFunction.patchPrintFunction
 local ____ModUpgraded = require("types.ModUpgraded")
 local ModUpgraded = ____ModUpgraded.ModUpgraded
 function initCustomCallbacks(self, mod)
@@ -121,6 +125,8 @@ function ____exports.upgradeMod(self, modVanilla, verbose)
     if verbose == nil then
         verbose = false
     end
+    patchErrorFunction(nil)
+    patchPrintFunction(nil)
     local mod = __TS__New(ModUpgraded, modVanilla, verbose)
     if not areFeaturesInitialized(nil) then
         setFeaturesInitialized(nil)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.0.515",
+  "version": "1.0.516",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",