isaacscript-common 1.2.200 → 1.2.203

package/dist/functions/vector.d.ts

@@ -1,7 +1,20 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="typescript-to-lua/language-extensions" />
-export declare function copyVector(vector: Vector): Vector;
-export declare function deserializeVector(vectorTable: LuaTable): Vector;
+import { SerializationType } from "../enums/SerializationType";
+declare type SerializedVector = LuaTable<string, string | number>;
+interface CopyVectorReturn {
+    [SerializationType.NONE]: Vector;
+    [SerializationType.SERIALIZE]: SerializedVector;
+    [SerializationType.DESERIALIZE]: Vector;
+}
+/**
+ * Helper function to copy a `Vector` object.
+ *
+ * @param vector The vector to copy. In the case of deserialization, this will actually be a Lua
+ * table instead of an instantiated Vector class.
+ * @param serializationType Default is `SerializationType.NONE`.
+ */
+export declare function copyVector<V extends Vector | SerializedVector, S extends SerializationType>(vector: V, serializationType: S): CopyVectorReturn[S];
 export declare function directionToVector(direction: Direction): Vector;
 /**
  * Helper function to get a new vector of length 1. Using this is safer than using the `Vector.One`
@@ -13,6 +26,13 @@ export declare function getOneVector(): Vector;
  * variable because the variable can be overwritten or modified.
  */
 export declare function getZeroVector(): Vector;
-export declare function isVector(object: unknown): boolean;
+/**
+ * Used to determine is the given table is a serialized Vector created by the save data 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. */
+export declare function isVector(object: unknown): object is Vector;
 /** Helper function for finding out which way a vector is pointing. */
 export declare function vectorToDirection(vector: Vector): Direction;
+export {};

package/dist/functions/vector.lua

@@ -1,22 +1,73 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
+local OBJECT_NAME
+local ____SerializationBrand = require("enums.private.SerializationBrand")
+local SerializationBrand = ____SerializationBrand.SerializationBrand
+local ____SerializationType = require("enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
 local ____directionToVector = require("objects.directionToVector")
 local DIRECTION_TO_VECTOR = ____directionToVector.DIRECTION_TO_VECTOR
-function ____exports.copyVector(self, vector)
-    return Vector(vector.X, vector.Y)
+local ____table = require("functions.table")
+local copyValuesToTable = ____table.copyValuesToTable
+local getNumbersFromTable = ____table.getNumbersFromTable
+local tableHasKeys = ____table.tableHasKeys
+local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
+local isUserdataObject = ____utils.isUserdataObject
+function ____exports.isVector(self, object)
+    return isUserdataObject(nil, object, OBJECT_NAME)
 end
-function ____exports.deserializeVector(self, vectorTable)
-    local xString = vectorTable.X
-    local x = tonumber(xString)
-    if x == nil then
-        error("Failed to read the X value of a serialized vector.")
-    end
-    local yString = vectorTable.Y
-    local y = tonumber(yString)
-    if y == nil then
-        error("Failed to read the Y value of a serialized vector.")
+local KEYS = {"X", "Y"}
+OBJECT_NAME = "Vector"
+function ____exports.copyVector(self, vector, serializationType)
+    if serializationType == nil then
+        serializationType = SerializationType.NONE
     end
-    return Vector(x, y)
+    repeat
+        local ____switch3 = serializationType
+        local ____cond3 = ____switch3 == SerializationType.NONE
+        if ____cond3 then
+            do
+                if not ____exports.isVector(nil, vector) then
+                    error(((("Failed to copy a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
+                end
+                return Vector(vector.X, vector.Y)
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == SerializationType.SERIALIZE
+        if ____cond3 then
+            do
+                if not ____exports.isVector(nil, vector) then
+                    error(((("Failed to serialize a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
+                end
+                local vectorTable = {}
+                copyValuesToTable(nil, vector, KEYS, vectorTable)
+                vectorTable[SerializationBrand.VECTOR] = ""
+                return vectorTable
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == SerializationType.DESERIALIZE
+        if ____cond3 then
+            do
+                local vectorType = type(vector)
+                if ____exports.isVector(nil, vector) or vectorType ~= "table" then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object was not a Lua table.")
+                end
+                local x, y = table.unpack(getNumbersFromTable(
+                    nil,
+                    vector,
+                    OBJECT_NAME,
+                    table.unpack(KEYS)
+                ))
+                return Vector(x, y)
+            end
+        end
+        do
+            do
+                return ensureAllCases(nil, serializationType)
+            end
+        end
+    until true
 end
 function ____exports.directionToVector(self, direction)
     return DIRECTION_TO_VECTOR[direction]
@@ -27,17 +78,17 @@ end
 function ____exports.getZeroVector(self)
     return Vector(0, 0)
 end
-function ____exports.isVector(self, object)
+function ____exports.isSerializedVector(self, object)
     local objectType = type(object)
-    if objectType ~= "userdata" then
-        return false
-    end
-    local metatable = getmetatable(object)
-    if metatable == nil then
+    if objectType ~= "table" then
         return false
     end
-    local vectorMetatable = metatable
-    return vectorMetatable.__type == "Vector"
+    local ____table = object
+    return tableHasKeys(
+        nil,
+        ____table,
+        table.unpack(KEYS)
+    ) and ____table[SerializationBrand.VECTOR] ~= nil
 end
 function ____exports.vectorToDirection(self, vector)
     local degrees = vector:GetAngleDegrees()

package/dist/index.d.ts

@@ -69,6 +69,7 @@ export * from "./functions/pocketItems";
 export * from "./functions/positionVelocity";
 export * from "./functions/random";
 export * from "./functions/revive";
+export * from "./functions/rng";
 export * from "./functions/roomData";
 export * from "./functions/rooms";
 export * from "./functions/run";

package/dist/index.lua

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

package/dist/objects/roomShapeToDoorSlots.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare const ROOM_SHAPE_TO_DOOR_SLOTS: {
+    readonly [key in RoomShape]: ReadonlySet<DoorSlot> | undefined;
+};

package/dist/objects/roomShapeToDoorSlots.lua

@@ -0,0 +1,44 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ALL_DOOR_SLOTS_SET = __TS__New(Set, {
+    DoorSlot.LEFT0,
+    DoorSlot.UP0,
+    DoorSlot.RIGHT0,
+    DoorSlot.DOWN0,
+    DoorSlot.LEFT1,
+    DoorSlot.UP1,
+    DoorSlot.RIGHT1,
+    DoorSlot.DOWN1
+})
+____exports.ROOM_SHAPE_TO_DOOR_SLOTS = {
+    [RoomShape.ROOMSHAPE_1x1] = __TS__New(Set, {DoorSlot.LEFT0, DoorSlot.UP0, DoorSlot.RIGHT0, DoorSlot.DOWN0}),
+    [RoomShape.ROOMSHAPE_IH] = __TS__New(Set, {DoorSlot.LEFT0, DoorSlot.RIGHT0}),
+    [RoomShape.ROOMSHAPE_IV] = __TS__New(Set, {DoorSlot.UP0, DoorSlot.DOWN0}),
+    [RoomShape.ROOMSHAPE_1x2] = __TS__New(Set, {
+        DoorSlot.LEFT0,
+        DoorSlot.UP0,
+        DoorSlot.RIGHT0,
+        DoorSlot.DOWN0,
+        DoorSlot.LEFT1,
+        DoorSlot.RIGHT1
+    }),
+    [RoomShape.ROOMSHAPE_IIV] = __TS__New(Set, {DoorSlot.UP0, DoorSlot.DOWN0}),
+    [RoomShape.ROOMSHAPE_2x1] = __TS__New(Set, {
+        DoorSlot.LEFT0,
+        DoorSlot.UP0,
+        DoorSlot.RIGHT0,
+        DoorSlot.DOWN0,
+        DoorSlot.UP1,
+        DoorSlot.DOWN1
+    }),
+    [RoomShape.ROOMSHAPE_IIH] = __TS__New(Set, {DoorSlot.LEFT0, DoorSlot.RIGHT0}),
+    [RoomShape.ROOMSHAPE_2x2] = ALL_DOOR_SLOTS_SET,
+    [RoomShape.ROOMSHAPE_LTL] = ALL_DOOR_SLOTS_SET,
+    [RoomShape.ROOMSHAPE_LTR] = ALL_DOOR_SLOTS_SET,
+    [RoomShape.ROOMSHAPE_LBL] = ALL_DOOR_SLOTS_SET,
+    [RoomShape.ROOMSHAPE_LBR] = ALL_DOOR_SLOTS_SET,
+    [RoomShape.NUM_ROOMSHAPES] = nil
+}
+return ____exports

package/dist/upgradeMod.d.ts

@@ -19,8 +19,6 @@ import { ModUpgraded } from "./classes/ModUpgraded";
  * [Function Signatures](https://isaacscript.github.io/docs/function-signatures#custom-callbacks).
  *
  * @param modVanilla The mod object returned by the `RegisterMod` function.
- * @param verbose Enables verbose logging for the purposes of crash troubleshooting.
- * Defaults to false.
  * @returns The upgraded mod object.
  */
-export declare function upgradeMod(modVanilla: Mod, verbose?: boolean): ModUpgraded;
+export declare function upgradeMod(modVanilla: Mod): ModUpgraded;

package/dist/upgradeMod.lua

@@ -167,12 +167,9 @@ function initFeatures(self, mod)
     fadeInRemoverInit(nil, mod)
     characterStatsInit(nil, mod)
 end
-function ____exports.upgradeMod(self, modVanilla, verbose)
-    if verbose == nil then
-        verbose = false
-    end
+function ____exports.upgradeMod(self, modVanilla)
     patchErrorFunction(nil)
-    local mod = __TS__New(ModUpgraded, modVanilla, verbose)
+    local mod = __TS__New(ModUpgraded, modVanilla)
     if not areFeaturesInitialized(nil) then
         setFeaturesInitialized(nil)
         postNewRoomEarlyCallbackInit(nil, mod)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.200",
+  "version": "1.2.203",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,7 +25,7 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.377",
+    "isaac-typescript-definitions": "^1.0.379",
     "isaacscript-lint": "^1.0.95",
     "isaacscript-tsconfig": "^1.1.8",
     "typedoc": "^0.22.13",