isaacscript-common 1.0.504 → 1.0.508

package/dist/functions/debug.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 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.
+ */
+export declare function traceback(): void;

package/dist/functions/debug.lua

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

package/dist/functions/doors.d.ts

@@ -44,6 +44,15 @@ export declare function isDoorToMines(door: GridEntityDoor): boolean;
 export declare function isDoorToMomsHeart(door: GridEntityDoor): boolean;
 export declare function isRepentanceDoor(door: GridEntityDoor): boolean;
 export declare function isSecretRoomDoor(door: GridEntityDoor): boolean;
+/**
+ * Helper function to reset an unlocked door back to a locked state. Doing this is non-trivial
+ * because in addition to calling the `SetLocked()` method, you must also:
+ *
+ * - Modify the `VisitedCount` of the room's `RoomDescription` to be set to 0.
+ * - Set the variant to `DoorVariant.DOOR_LOCKED`.
+ * - Close the door.
+ */
+export declare function lockDoor(door: GridEntityDoor): void;
 /**
  * For the purposes of this function, doors to Secret Rooms or Super Secret Rooms that have not been
  * discovered yet will not be opened.

package/dist/functions/doors.lua

@@ -125,6 +125,15 @@ function ____exports.isDoorToMomsHeart(self, door)
     local filename = sprite:GetFilename()
     return filename == "gfx/grid/Door_MomsHeart.anm2"
 end
+function ____exports.lockDoor(self, door)
+    local game = Game()
+    local level = game:GetLevel()
+    local roomDesc = level:GetRoomByIdx(door.TargetRoomIndex)
+    roomDesc.VisitedCount = 0
+    door:SetVariant(DoorVariant.DOOR_LOCKED)
+    door:SetLocked(true)
+    door:Close(true)
+end
 function ____exports.openAllDoors(self)
     for ____, door in ipairs(____exports.getDoors(nil)) do
         door:Open()

package/dist/functions/log.d.ts

@@ -41,8 +41,3 @@ export declare function logVector(this: void, vector: Vector): void;
  * This is useful for printing out variables from the in-game debug console.
  */
 export declare function setLogFunctionsGlobal(): void;
-/**
- * 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.
- */
-export declare function traceback(): void;

package/dist/functions/log.lua

@@ -126,16 +126,4 @@ function ____exports.setLogFunctionsGlobal(self)
     globals.logSet = ____exports.logSet
     globals.logVector = ____exports.logVector
 end
-function ____exports.traceback(self)
-    if debug ~= nil then
-        local tracebackMsg = debug.traceback()
-        Isaac.DebugString(tracebackMsg)
-        return
-    end
-    if sandboxTraceback ~= nil then
-        sandboxTraceback()
-        return
-    end
-    Isaac.DebugString("Error: Cannot perform a traceback since --luadebug is not enabled.")
-end
 return ____exports

package/dist/functions/random.lua

@@ -1,11 +1,14 @@
 --[[ 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/index.d.ts

@@ -15,6 +15,7 @@ export * from "./functions/charge";
 export * from "./functions/collectibles";
 export * from "./functions/collectibleSet";
 export * from "./functions/color";
+export * from "./functions/debug";
 export { deepCopy } from "./functions/deepCopy";
 export { deepCopyTests } from "./functions/deepCopyTests";
 export * from "./functions/doors";

package/dist/index.lua

@@ -132,6 +132,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.debug")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____deepCopy = require("functions.deepCopy")
     local deepCopy = ____deepCopy.deepCopy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.0.504",
+  "version": "1.0.508",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -26,7 +26,7 @@
   ],
   "devDependencies": {
     "isaac-typescript-definitions": "^1.0.292",
-    "isaacscript-lint": "^1.0.68",
+    "isaacscript-lint": "^1.0.69",
     "typedoc": "^0.22.10",
     "typescript": "4.5.2",
     "typescript-to-lua": "^1.2.0"