isaacscript-common 1.2.247 → 1.2.250

package/dist/enums/private/CopyableIsaacAPIClassType.d.ts

@@ -0,0 +1,7 @@
+/** This must match the enumeration in the JSDoc comments for `deepCopy` and `merge`. */
+export declare enum CopyableIsaacAPIClassType {
+    COLOR = "Color",
+    KCOLOR = "KColor",
+    RNG = "RNG",
+    VECTOR = "Vector"
+}

package/dist/enums/private/CopyableIsaacAPIClassType.lua

@@ -0,0 +1,8 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+____exports.CopyableIsaacAPIClassType = CopyableIsaacAPIClassType or ({})
+____exports.CopyableIsaacAPIClassType.COLOR = "Color"
+____exports.CopyableIsaacAPIClassType.KCOLOR = "KColor"
+____exports.CopyableIsaacAPIClassType.RNG = "RNG"
+____exports.CopyableIsaacAPIClassType.VECTOR = "Vector"
+return ____exports

package/dist/enums/private/SerializationBrand.d.ts

@@ -1,18 +1,38 @@
-/// <reference types="typescript-to-lua/language-extensions" />
+/**
+ * During serialization, we write an arbitrary string key to the object with a value of an empty
+ * string. This is used during deserialization to instantiate the correct type of object.
+ *
+ * Note that we do not bother branding TSTL classes because we have no way to invoke the proper
+ * constructor during deserialization.
+ */
 export declare enum SerializationBrand {
     DEFAULT_MAP = "__TSTL_DEFAULT_MAP",
-    /**
-     * This is set to the value that represents the default value (instead of an empty string like the
-     * other brands are).
-     */
-    DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE",
     MAP = "__TSTL_MAP",
     SET = "__TSTL_SET",
-    CLASS = "__TSTL_CLASS",
-    OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS",
     COLOR = "__COLOR",
     KCOLOR = "__KCOLOR",
     RNG = "__RNG",
-    VECTOR = "__VECTOR"
+    VECTOR = "__VECTOR",
+    /**
+     * This is set to the value that represents the default value (instead of an empty string like the
+     * other brands are).
+     *
+     * Default maps that use a factory function are unserializable, but do not throw runtime errors
+     * because the merge function can derive the factory function from the already-instantiated
+     * object.
+     */
+    DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE",
+    /**
+     * The JSON library is unable to distinguish between a maps with number keys and an array. It will
+     * assume that both of these are an array. Thus, in the case of a map with number keys, it will
+     * insert null in every empty spot, leading to crashes.
+     *
+     * For example, a map with keys of 5 and 10 would be converted to the following array:
+     * `[null, null, null, null, "myValueForKey5", null, null, null, null, "myValueForKey10"]`
+     *
+     * The deep copier works around this by converting number keys to strings. It inserts this brand
+     * to keep track of the mutation.
+     */
+    OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS"
 }
-export declare function isSerializationBrand(key: AnyNotNil): boolean;
+export declare function isSerializationBrand(key: unknown): boolean;

package/dist/enums/private/SerializationBrand.lua

@@ -6,15 +6,14 @@ local ____utils = require("functions.utils")
 local getEnumValues = ____utils.getEnumValues
 ____exports.SerializationBrand = SerializationBrand or ({})
 ____exports.SerializationBrand.DEFAULT_MAP = "__TSTL_DEFAULT_MAP"
-____exports.SerializationBrand.DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE"
 ____exports.SerializationBrand.MAP = "__TSTL_MAP"
 ____exports.SerializationBrand.SET = "__TSTL_SET"
-____exports.SerializationBrand.CLASS = "__TSTL_CLASS"
-____exports.SerializationBrand.OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS"
 ____exports.SerializationBrand.COLOR = "__COLOR"
 ____exports.SerializationBrand.KCOLOR = "__KCOLOR"
 ____exports.SerializationBrand.RNG = "__RNG"
 ____exports.SerializationBrand.VECTOR = "__VECTOR"
+____exports.SerializationBrand.DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE"
+____exports.SerializationBrand.OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS"
 local SERIALIZATION_BRANDS = getEnumValues(nil, ____exports.SerializationBrand)
 local SERIALIZATION_BRAND_SET = __TS__New(Set, SERIALIZATION_BRANDS)
 function ____exports.isSerializationBrand(self, key)

package/dist/features/saveDataManager/exports.lua

@@ -32,8 +32,7 @@ function ____exports.saveDataManager(self, key, v, conditionalFunc)
         conditionalFunc = function() return false end
     end
     local saveDataTable = v
-    local saveDataTableCopy = deepCopy(nil, saveDataTable, SerializationType.NONE, key)
-    local saveDataCopy = saveDataTableCopy
+    local saveDataCopy = deepCopy(nil, saveDataTable, SerializationType.NONE, key)
     saveDataDefaultsMap[key] = saveDataCopy
     if conditionalFunc ~= nil then
         saveDataConditionalFuncMap:set(key, conditionalFunc)

package/dist/features/saveDataManager/main.lua

@@ -80,9 +80,8 @@ function restoreDefaults(self, childTableName)
                 logError(((("Failed to find the default copy of the child table \"" .. childTableName) .. "\" for subscriber \"") .. subscriberName) .. "\". This error usually means that your save data is out of date. You can try purging all of your save data by deleting the following directory: C:\\Program Files (x86)\\Steam\\steamapps\\common\\The Binding of Isaac Rebirth\\data")
                 goto __continue14
             end
-            local childTableDefaultsTable = childTableDefaults
-            local childTableDefaultsTableCopy = deepCopy(nil, childTableDefaultsTable, SerializationType.NONE, (subscriberName .. " --> ") .. childTableName)
-            clearAndCopyAllElements(nil, childTable, childTableDefaultsTableCopy)
+            local childTableDefaultsCopy = deepCopy(nil, childTableDefaults, SerializationType.NONE, (subscriberName .. " --> ") .. childTableName)
+            clearAndCopyAllElements(nil, childTable, childTableDefaultsCopy)
         end
         ::__continue14::
     end

package/dist/features/saveDataManager/merge.d.ts

@@ -21,4 +21,4 @@
  * are no longer used in the code, or copy over old variables of a different type, which can cause
  * run-time errors. In such cases, users will have to manually delete their save data.
  */
-export declare function merge(oldObject: LuaTable | Map<AnyNotNil, unknown> | Set<AnyNotNil>, newTable: LuaTable, traversalDescription: string): void;
+export declare function merge(oldObject: LuaTable<AnyNotNil, unknown> | Map<AnyNotNil, unknown> | Set<AnyNotNil>, newTable: LuaTable<AnyNotNil, unknown>, traversalDescription: string): void;

package/dist/functions/deepCopy.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="typescript-to-lua/language-extensions" />
 import { SerializationType } from "../enums/SerializationType";
 /**
  * deepCopy is a semi-generic deep cloner. It will recursively copy all of the values so that none
@@ -6,6 +5,7 @@ import { SerializationType } from "../enums/SerializationType";
  *
  * It supports the following object types:
  *
+ * - Primitives (i.e. strings, numbers, and booleans)
  * - `LuaTable` / basic TSTL objects
  * - TSTL `Map`
  * - TSTL `Set`
@@ -16,10 +16,13 @@ import { SerializationType } from "../enums/SerializationType";
  * - Isaac `RNG` objects
  * - Isaac `Vector` objects
  *
- * @param oldObject The object to copy.
- * @param serializationType Has 3 possible values. Can leave TypeScriptToLua objects as-is, or can
- * serialize objects to Lua tables, or can deserialize Lua tables to objects. Default is
- * `SerializationType.NONE`.
+ * It does not support:
+ * - objects with values of `null` (since that transpiles to `nil`)
+ * - other Isaac API objects (that have a type of "userdata")
+ *
+ * @param value The primitive or object to copy.
+ * @param serializationType Has 3 possible values. Can leave objects as-is, or can serialize objects
+ * to Lua tables, or can deserialize Lua tables to objects. Default is `SerializationType.NONE`.
  * @param traversalDescription Used to track the current key that we are operating on.
  */
-export declare function deepCopy(oldObject: LuaTable | Map<AnyNotNil, unknown> | Set<AnyNotNil>, serializationType?: SerializationType, traversalDescription?: string): LuaTable | Map<AnyNotNil, unknown> | Set<AnyNotNil>;
+export declare function deepCopy(value: unknown, serializationType?: SerializationType, traversalDescription?: string): unknown;

package/dist/functions/deepCopy.lua

@@ -1,13 +1,19 @@
 local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
-local Map = ____lualib.Map
 local __TS__InstanceOf = ____lualib.__TS__InstanceOf
+local Map = ____lualib.Map
+local WeakMap = ____lualib.WeakMap
+local WeakSet = ____lualib.WeakSet
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
-local isTSTLClass, checkMetatable, copyClass, getNewClassFromMetatable, deepCopyValue, validateValue, getNewValue, TSTL_CLASS_KEYS
+local deepCopyTable, deepCopyDefaultMap, deepCopyMap, deepCopySet, deepCopyTSTLClass, getCopiedEntries, checkMetatable, deepCopyUserdata, COPYABLE_ISAAC_API_CLASS_TYPES_SET
 local ____DefaultMap = require("classes.DefaultMap")
 local DefaultMap = ____DefaultMap.DefaultMap
+local ____CopyableIsaacAPIClassType = require("enums.private.CopyableIsaacAPIClassType")
+local CopyableIsaacAPIClassType = ____CopyableIsaacAPIClassType.CopyableIsaacAPIClassType
 local ____SerializationBrand = require("enums.private.SerializationBrand")
 local isSerializationBrand = ____SerializationBrand.isSerializationBrand
 local SerializationBrand = ____SerializationBrand.SerializationBrand
@@ -15,16 +21,22 @@ local ____SerializationType = require("enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
 local ____constants = require("features.saveDataManager.constants")
 local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local ____isaacAPIClass = require("functions.isaacAPIClass")
+local getIsaacAPIClassType = ____isaacAPIClass.getIsaacAPIClassType
 local ____log = require("functions.log")
 local log = ____log.log
 local ____serialization = require("functions.serialization")
 local copyIsaacAPIClass = ____serialization.copyIsaacAPIClass
 local deserializeIsaacAPIClass = ____serialization.deserializeIsaacAPIClass
-local isSerializableIsaacAPIClass = ____serialization.isSerializableIsaacAPIClass
 local isSerializedIsaacAPIClass = ____serialization.isSerializedIsaacAPIClass
+local ____tstlClass = require("functions.tstlClass")
+local isUserDefinedTSTLClass = ____tstlClass.isUserDefinedTSTLClass
+local newTSTLClass = ____tstlClass.newTSTLClass
 local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
+local getEnumValues = ____utils.getEnumValues
 local getTraversalDescription = ____utils.getTraversalDescription
-function ____exports.deepCopy(self, oldObject, serializationType, traversalDescription)
+function ____exports.deepCopy(self, value, serializationType, traversalDescription)
     if serializationType == nil then
         serializationType = SerializationType.NONE
     end
@@ -38,216 +50,291 @@ function ____exports.deepCopy(self, oldObject, serializationType, traversalDescr
         elseif serializationType == SerializationType.DESERIALIZE then
             logString = logString .. " (deserializing)"
         end
+        logString = logString .. ": " .. tostring(value)
         log(logString)
     end
-    local oldObjectType = type(oldObject)
-    if oldObjectType ~= "table" then
-        error(("The deepCopy function was given a " .. oldObjectType) .. " instead of a table.")
-    end
-    local oldTable = oldObject
-    local isClass = isTSTLClass(nil, oldTable)
-    local hasTSTLDefaultMapBrand = false
-    local hasTSTLMapBrand = false
-    local hasTSTLSetBrand = false
-    local hasTSTLClassBrand = false
-    if not __TS__InstanceOf(oldObject, Map) and not __TS__InstanceOf(oldObject, Set) and not isClass then
-        checkMetatable(nil, oldTable, traversalDescription)
-        hasTSTLDefaultMapBrand = oldTable[SerializationBrand.DEFAULT_MAP] ~= nil
-        hasTSTLMapBrand = oldTable[SerializationBrand.MAP] ~= nil
-        hasTSTLSetBrand = oldTable[SerializationBrand.SET] ~= nil
-        hasTSTLClassBrand = oldTable[SerializationBrand.CLASS] ~= nil
-    end
-    local newObject
-    if serializationType == SerializationType.NONE and __TS__InstanceOf(oldObject, DefaultMap) then
-        local oldDefaultMap = oldObject
-        local constructorArg = oldDefaultMap:getConstructorArg()
-        newObject = __TS__New(DefaultMap, constructorArg)
-    elseif serializationType == SerializationType.DESERIALIZE and hasTSTLDefaultMapBrand then
-        local defaultValue = oldTable[SerializationBrand.DEFAULT_MAP_VALUE]
-        if type(defaultValue) ~= "boolean" and type(defaultValue) ~= "number" and type(defaultValue) ~= "string" then
-            error("The deepCopy function failed to get a valid default value for a DefaultMap object when deserializing.")
-        else
-            newObject = __TS__New(DefaultMap, defaultValue)
-        end
-    elseif serializationType == SerializationType.NONE and __TS__InstanceOf(oldObject, Map) or serializationType == SerializationType.DESERIALIZE and hasTSTLMapBrand then
-        newObject = __TS__New(Map)
-    elseif serializationType == SerializationType.NONE and __TS__InstanceOf(oldObject, Set) or serializationType == SerializationType.DESERIALIZE and hasTSTLSetBrand then
-        newObject = __TS__New(Set)
-    elseif serializationType == SerializationType.NONE and isClass or serializationType == SerializationType.DESERIALIZE and hasTSTLClassBrand then
-        newObject = copyClass(nil, oldObject)
+    local valueType = type(value)
+    repeat
+        local ____switch6 = valueType
+        local ____cond6 = ____switch6 == "nil" or ____switch6 == "boolean" or ____switch6 == "number" or ____switch6 == "string"
+        if ____cond6 then
+            do
+                return value
+            end
+        end
+        ____cond6 = ____cond6 or (____switch6 == "function" or ____switch6 == "thread")
+        if ____cond6 then
+            do
+                if serializationType == SerializationType.SERIALIZE then
+                    error((("The deep copy function does not support serialization of \"" .. traversalDescription) .. "\", since it is type: ") .. valueType)
+                end
+                return value
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == "table"
+        if ____cond6 then
+            do
+                local valueTable = value
+                return deepCopyTable(nil, valueTable, serializationType, traversalDescription)
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == "userdata"
+        if ____cond6 then
+            do
+                return deepCopyUserdata(nil, value, serializationType, traversalDescription)
+            end
+        end
+        do
+            do
+                return ensureAllCases(nil, valueType)
+            end
+        end
+    until true
+end
+function deepCopyTable(self, ____table, serializationType, traversalDescription)
+    if __TS__InstanceOf(____table, DefaultMap) or ____table[SerializationBrand.DEFAULT_MAP] ~= nil then
+        return deepCopyDefaultMap(nil, ____table, serializationType, traversalDescription)
+    end
+    if __TS__InstanceOf(____table, Map) or ____table[SerializationBrand.MAP] ~= nil then
+        return deepCopyMap(nil, ____table, serializationType, traversalDescription)
+    end
+    if __TS__InstanceOf(____table, Set) or ____table[SerializationBrand.SET] ~= nil then
+        return deepCopySet(nil, ____table, serializationType, traversalDescription)
+    end
+    if __TS__InstanceOf(____table, WeakMap) then
+        error("The deep copy function does not support copying the \"WeakMap\" class: " .. traversalDescription)
+    end
+    if __TS__InstanceOf(____table, WeakSet) then
+        error("The deep copy function does not support copying the \"WeakSet\" class: " .. traversalDescription)
+    end
+    if isUserDefinedTSTLClass(nil, ____table) then
+        return deepCopyTSTLClass(nil, ____table, serializationType, traversalDescription)
+    end
+    checkMetatable(nil, ____table, traversalDescription)
+    if isSerializedIsaacAPIClass(nil, ____table) and serializationType == SerializationType.DESERIALIZE then
+        return deserializeIsaacAPIClass(nil, ____table)
+    end
+    local newTable = {}
+    local ____getCopiedEntries_result_0 = getCopiedEntries(nil, ____table, serializationType, traversalDescription)
+    local entries = ____getCopiedEntries_result_0.entries
+    local convertedNumberKeysToStrings = ____getCopiedEntries_result_0.convertedNumberKeysToStrings
+    if convertedNumberKeysToStrings then
+        newTable[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
+    end
+    for ____, ____value in ipairs(entries) do
+        local key = ____value[1]
+        local value = ____value[2]
+        newTable[key] = value
+    end
+    return newTable
+end
+function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescription)
+    local ____temp_1
+    if __TS__InstanceOf(defaultMap, DefaultMap) then
+        ____temp_1 = defaultMap:getConstructorArg()
     else
-        newObject = {}
+        ____temp_1 = nil
     end
-    if serializationType == SerializationType.SERIALIZE then
-        local newTable = newObject
-        if __TS__InstanceOf(oldObject, DefaultMap) then
-            newTable[SerializationBrand.DEFAULT_MAP] = ""
-            local oldDefaultMap = oldObject
-            local defaultValue = oldDefaultMap:getConstructorArg()
-            if type(defaultValue) == "boolean" or type(defaultValue) == "number" or type(defaultValue) == "string" then
-                newTable[SerializationBrand.DEFAULT_MAP_VALUE] = defaultValue
+    local constructorArg = ____temp_1
+    local newDefaultMap
+    repeat
+        local ____switch25 = serializationType
+        local ____cond25 = ____switch25 == SerializationType.NONE
+        if ____cond25 then
+            do
+                newDefaultMap = __TS__New(DefaultMap, constructorArg)
+                break
             end
-        elseif __TS__InstanceOf(oldObject, Map) then
-            newTable[SerializationBrand.MAP] = ""
-        elseif __TS__InstanceOf(oldObject, Set) then
-            newTable[SerializationBrand.SET] = ""
-        elseif isClass then
-            newTable[SerializationBrand.CLASS] = ""
         end
-    end
-    if __TS__InstanceOf(oldObject, Map) then
-        for ____, ____value in __TS__Iterator(oldObject:entries()) do
-            local key = ____value[1]
-            local value = ____value[2]
+        ____cond25 = ____cond25 or ____switch25 == SerializationType.SERIALIZE
+        if ____cond25 then
             do
-                if isSerializationBrand(nil, key) then
-                    goto __continue23
+                if type(constructorArg) ~= "boolean" and type(constructorArg) ~= "number" and type(constructorArg) ~= "string" then
+                    return deepCopyMap(nil, defaultMap, serializationType, traversalDescription)
                 end
-                deepCopyValue(
-                    nil,
-                    oldObject,
-                    newObject,
-                    key,
-                    value,
-                    traversalDescription,
-                    serializationType
-                )
+                newDefaultMap = {}
+                newDefaultMap[SerializationBrand.DEFAULT_MAP] = ""
+                newDefaultMap[SerializationBrand.DEFAULT_MAP_VALUE] = constructorArg
+                break
             end
-            ::__continue23::
         end
-    elseif __TS__InstanceOf(oldObject, Set) then
-        for ____, key in __TS__Iterator(oldObject:values()) do
+        ____cond25 = ____cond25 or ____switch25 == SerializationType.DESERIALIZE
+        if ____cond25 then
             do
-                if isSerializationBrand(nil, key) then
-                    goto __continue27
+                if __TS__InstanceOf(defaultMap, DefaultMap) then
+                    error(("The deep copy function failed to deserialize a default map of \"" .. traversalDescription) .. "\", since it was not a Lua table.")
                 end
-                local value = ""
-                deepCopyValue(
-                    nil,
-                    oldObject,
-                    newObject,
-                    key,
-                    value,
-                    traversalDescription,
-                    serializationType
-                )
+                local defaultMapValue = defaultMap[SerializationBrand.DEFAULT_MAP_VALUE]
+                if defaultMapValue == nil then
+                    error((("The deep copy function failed to deserialize a default map of \"" .. traversalDescription) .. "\", since there was no serialization brand of: ") .. SerializationBrand.DEFAULT_MAP_VALUE)
+                end
+                newDefaultMap = __TS__New(DefaultMap, defaultMapValue)
+                break
             end
-            ::__continue27::
         end
-    else
-        for key, value in pairs(oldObject) do
+        do
             do
-                if isSerializationBrand(nil, key) then
-                    goto __continue31
-                end
-                deepCopyValue(
-                    nil,
-                    oldObject,
-                    newObject,
-                    key,
-                    value,
-                    traversalDescription,
-                    serializationType
-                )
+                return ensureAllCases(nil, serializationType)
             end
-            ::__continue31::
+        end
+    until true
+    local ____getCopiedEntries_result_2 = getCopiedEntries(nil, defaultMap, serializationType, traversalDescription)
+    local entries = ____getCopiedEntries_result_2.entries
+    local convertedNumberKeysToStrings = ____getCopiedEntries_result_2.convertedNumberKeysToStrings
+    if convertedNumberKeysToStrings then
+        if __TS__InstanceOf(newDefaultMap, DefaultMap) then
+            newDefaultMap:set(SerializationBrand.OBJECT_WITH_NUMBER_KEYS, "")
+        else
+            newDefaultMap[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
         end
     end
-    return newObject
-end
-function isTSTLClass(self, object)
-    local metatable = getmetatable(object)
-    if metatable == nil then
-        return false
+    for ____, ____value in ipairs(entries) do
+        local key = ____value[1]
+        local value = ____value[2]
+        if __TS__InstanceOf(newDefaultMap, DefaultMap) then
+            newDefaultMap:set(key, value)
+        else
+            newDefaultMap[key] = value
+        end
     end
-    if __TS__InstanceOf(object, Map) or __TS__InstanceOf(object, Set) then
-        return false
+    return newDefaultMap
+end
+function deepCopyMap(self, map, serializationType, traversalDescription)
+    local newMap
+    if serializationType == SerializationType.SERIALIZE then
+        newMap = {}
+        newMap[SerializationBrand.MAP] = ""
+    else
+        newMap = __TS__New(Map)
     end
-    local numKeys = 0
-    for key in pairs(metatable) do
-        numKeys = numKeys + 1
-        if type(key) ~= "string" then
-            return false
+    local ____getCopiedEntries_result_3 = getCopiedEntries(nil, map, serializationType, traversalDescription)
+    local entries = ____getCopiedEntries_result_3.entries
+    local convertedNumberKeysToStrings = ____getCopiedEntries_result_3.convertedNumberKeysToStrings
+    if convertedNumberKeysToStrings then
+        if __TS__InstanceOf(newMap, Map) then
+            newMap:set(SerializationBrand.OBJECT_WITH_NUMBER_KEYS, "")
+        else
+            newMap[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
         end
-        if not TSTL_CLASS_KEYS:has(key) then
-            return false
+    end
+    for ____, ____value in ipairs(entries) do
+        local key = ____value[1]
+        local value = ____value[2]
+        if __TS__InstanceOf(newMap, Map) then
+            newMap:set(key, value)
+        else
+            newMap[key] = value
         end
     end
-    return numKeys == TSTL_CLASS_KEYS.size
+    return newMap
 end
-function checkMetatable(self, ____table, traversalDescription)
-    local metatable = getmetatable(____table)
-    if metatable == nil then
-        return
+function deepCopySet(self, set, serializationType, traversalDescription)
+    local newSet
+    if serializationType == SerializationType.SERIALIZE then
+        newSet = {}
+        newSet[SerializationBrand.SET] = ""
+    else
+        newSet = __TS__New(Set)
     end
-    local tableDescription = traversalDescription == "" and "the table to copy" or ("\"" .. traversalDescription) .. "\""
-    error(("The deepCopy function detected that \"" .. tableDescription) .. "\" has a metatable. Copying tables with metatables is not supported, unless they are explicitly handled by the save data manager. (e.g. Vectors, TypeScriptToLua Maps, etc.)")
+    local ____getCopiedEntries_result_4 = getCopiedEntries(nil, set, serializationType, traversalDescription)
+    local entries = ____getCopiedEntries_result_4.entries
+    local convertedNumberKeysToStrings = ____getCopiedEntries_result_4.convertedNumberKeysToStrings
+    if convertedNumberKeysToStrings then
+        if __TS__InstanceOf(newSet, Set) then
+            error("The deep copy function cannot convert number keys to strings for a Set.")
+        else
+            newSet[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
+        end
+    end
+    for ____, ____value in ipairs(entries) do
+        local key = ____value[1]
+        if __TS__InstanceOf(newSet, Set) then
+            newSet:add(key)
+        else
+            newSet[key] = ""
+        end
+    end
+    return newSet
 end
-function copyClass(self, oldClass)
-    local metatable = getmetatable(oldClass)
-    local newClass = getNewClassFromMetatable(nil, metatable)
-    for key, value in pairs(oldClass) do
+function deepCopyTSTLClass(self, tstlClass, serializationType, traversalDescription)
+    local newClass
+    if serializationType == SerializationType.SERIALIZE then
+        newClass = {}
+    else
+        newClass = newTSTLClass(nil, tstlClass)
+    end
+    local ____getCopiedEntries_result_5 = getCopiedEntries(nil, tstlClass, serializationType, traversalDescription)
+    local entries = ____getCopiedEntries_result_5.entries
+    local convertedNumberKeysToStrings = ____getCopiedEntries_result_5.convertedNumberKeysToStrings
+    if convertedNumberKeysToStrings then
+        newClass[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
+    end
+    for ____, ____value in ipairs(entries) do
+        local key = ____value[1]
+        local value = ____value[2]
         newClass[key] = value
     end
     return newClass
 end
-function getNewClassFromMetatable(self, metatable)
-    local instance = setmetatable({}, metatable.constructor.prototype)
-    local newClass = instance
-    newClass:____constructor()
-    return newClass
-end
-function deepCopyValue(self, oldObject, newObject, key, value, traversalDescription, serializationType)
-    local valueType = type(value)
-    validateValue(nil, value, valueType, traversalDescription)
-    local convertNumberKeysToString = false
-    local isTSTLObject = __TS__InstanceOf(oldObject, Map) or __TS__InstanceOf(oldObject, Set)
-    local keyType = type(key)
-    if serializationType == SerializationType.SERIALIZE and isTSTLObject and keyType == "number" then
-        convertNumberKeysToString = true
-        local newTable = newObject
-        newTable[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
-        if SAVE_DATA_MANAGER_DEBUG then
-            log("deepCopy is converting a TSTL map with number keys to strings.")
+function getCopiedEntries(self, object, serializationType, traversalDescription)
+    local entries = {}
+    if __TS__InstanceOf(object, Map) or __TS__InstanceOf(object, Set) then
+        for ____, ____value in __TS__Iterator(object:entries()) do
+            local key = ____value[1]
+            local value = ____value[2]
+            __TS__ArrayPush(entries, {key, value})
+        end
+    else
+        for key, value in pairs(object) do
+            __TS__ArrayPush(entries, {key, value})
         end
     end
-    local newValue = getNewValue(
-        nil,
-        key,
-        value,
-        traversalDescription,
-        serializationType
+    local hasNumberKeys = __TS__ArraySome(
+        entries,
+        function(____, ____bindingPattern0)
+            local key
+            key = ____bindingPattern0[1]
+            return type(key) == "number"
+        end
     )
-    if __TS__InstanceOf(newObject, Map) then
-        newObject:set(key, newValue)
-    elseif __TS__InstanceOf(newObject, Set) then
-        newObject:add(key)
-    else
-        local keyToUse = convertNumberKeysToString and tostring(key) or key
-        newObject[keyToUse] = newValue
+    local convertNumberKeysToStrings = serializationType == SerializationType.SERIALIZE and hasNumberKeys
+    local copiedEntries = {}
+    for ____, ____value in ipairs(entries) do
+        local key = ____value[1]
+        local value = ____value[2]
+        do
+            if isSerializationBrand(nil, key) then
+                goto __continue73
+            end
+            traversalDescription = getTraversalDescription(nil, key, traversalDescription)
+            local newValue = ____exports.deepCopy(nil, value, serializationType, traversalDescription)
+            local keyToUse = convertNumberKeysToStrings and tostring(key) or key
+            __TS__ArrayPush(copiedEntries, {keyToUse, newValue})
+        end
+        ::__continue73::
     end
+    return {entries = copiedEntries, convertedNumberKeysToStrings = convertNumberKeysToStrings}
 end
-function validateValue(self, value, valueType, traversalDescription)
-    if isSerializableIsaacAPIClass(nil, value) then
+function checkMetatable(self, ____table, traversalDescription)
+    local metatable = getmetatable(____table)
+    if metatable == nil then
         return
     end
-    if valueType == "function" or valueType == "nil" or valueType == "thread" or valueType == "userdata" then
-        error(((("The deepCopy function detected that \"" .. traversalDescription) .. "\" has a value of type \"") .. valueType) .. "\", which is not supported.")
-    end
+    local tableDescription = traversalDescription == "" and "the table to copy" or ("\"" .. traversalDescription) .. "\""
+    error(("The deepCopy function detected that \"" .. tableDescription) .. "\" has a metatable. Copying tables with metatables is not supported, unless they are explicitly handled by the save data manager. (e.g. TypeScriptToLua Maps, TypeScriptToLua Sets, etc.)")
 end
-function getNewValue(self, key, value, traversalDescription, serializationType)
-    if isSerializableIsaacAPIClass(nil, value) then
-        return copyIsaacAPIClass(nil, value, serializationType)
-    end
-    if isSerializedIsaacAPIClass(nil, value) and serializationType == SerializationType.DESERIALIZE then
-        return deserializeIsaacAPIClass(nil, value)
+function deepCopyUserdata(self, value, serializationType, traversalDescription)
+    local classType = getIsaacAPIClassType(nil, value)
+    if classType == nil then
+        error("The deep copy function was not able to derive the Isaac API class type for: " .. traversalDescription)
     end
-    if type(value) == "table" then
-        local ____table = value
-        traversalDescription = getTraversalDescription(nil, key, traversalDescription)
-        return ____exports.deepCopy(nil, ____table, serializationType, traversalDescription)
+    if not COPYABLE_ISAAC_API_CLASS_TYPES_SET:has(classType) then
+        error((("The deep copy function does not support copying \"" .. traversalDescription) .. "\", since it is an Isaac API class of type: ") .. classType)
     end
-    return value
+    return copyIsaacAPIClass(nil, value, serializationType)
 end
-TSTL_CLASS_KEYS = __TS__New(Set, {"____constructor", "__index", "constructor"})
+COPYABLE_ISAAC_API_CLASS_TYPES_SET = __TS__New(
+    Set,
+    getEnumValues(nil, CopyableIsaacAPIClassType)
+)
 return ____exports

package/dist/functions/easing.d.ts

@@ -0,0 +1,30 @@
+export declare function easeInSine(x: number): number;
+export declare function easeOutSine(x: number): number;
+export declare function easeInOutSine(x: number): number;
+export declare function easeInCubic(x: number): number;
+export declare function easeOutCubic(x: number): number;
+export declare function easeInOutCubic(x: number): number;
+export declare function easeInQuint(x: number): number;
+export declare function easeOutQuint(x: number): number;
+export declare function easeInOutQuint(x: number): number;
+export declare function easeInCirc(x: number): number;
+export declare function easeOutCirc(x: number): number;
+export declare function easeInOutCirc(x: number): number;
+export declare function easeInElastic(x: number): number;
+export declare function easeOutElastic(x: number): number;
+export declare function easeInOutElastic(x: number): number;
+export declare function easeInQuad(x: number): number;
+export declare function easeOutQuad(x: number): number;
+export declare function easeInOutQuad(x: number): number;
+export declare function easeInQuart(x: number): number;
+export declare function easeOutQuart(x: number): number;
+export declare function easeInOutQuart(x: number): number;
+export declare function easeInExpo(x: number): number;
+export declare function easeOutExpo(x: number): number;
+export declare function easeInOutExpo(x: number): number;
+export declare function easeInBack(x: number): number;
+export declare function easeOutBack(x: number): number;
+export declare function easeInOutBack(x: number): number;
+export declare function easeInBounce(x: number): number;
+export declare function easeOutBounce(x: number): number;
+export declare function easeInOutBounce(x: number): number;

package/dist/functions/easing.lua

@@ -0,0 +1,116 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+function ____exports.easeOutBounce(self, x)
+    local n1 = 7.5625
+    local d1 = 2.75
+    if x < 1 / d1 then
+        return n1 * x * x
+    end
+    if x < 2 / d1 then
+        x = x - 1.5 / d1
+        return n1 * x * x + 0.75
+    end
+    if x < 2.5 / d1 then
+        x = x - 2.25 / d1
+        return n1 * x * x + 0.9375
+    end
+    x = x - 2.625 / d1
+    return n1 * x * x + 0.984375
+end
+function ____exports.easeInSine(self, x)
+    return 1 - math.cos(x * math.pi / 2)
+end
+function ____exports.easeOutSine(self, x)
+    return math.sin(x * math.pi / 2)
+end
+function ____exports.easeInOutSine(self, x)
+    return -(math.cos(math.pi * x) - 1) / 2
+end
+function ____exports.easeInCubic(self, x)
+    return x * x * x
+end
+function ____exports.easeOutCubic(self, x)
+    return 1 - (1 - x) ^ 3
+end
+function ____exports.easeInOutCubic(self, x)
+    return x < 0.5 and 4 * x * x * x or 1 - (-2 * x + 2) ^ 3 / 2
+end
+function ____exports.easeInQuint(self, x)
+    return x * x * x * x * x
+end
+function ____exports.easeOutQuint(self, x)
+    return 1 - (1 - x) ^ 5
+end
+function ____exports.easeInOutQuint(self, x)
+    return x < 0.5 and 16 * x * x * x * x * x or 1 - (-2 * x + 2) ^ 5 / 2
+end
+function ____exports.easeInCirc(self, x)
+    return 1 - math.sqrt(1 - x ^ 2)
+end
+function ____exports.easeOutCirc(self, x)
+    return math.sqrt(1 - (x - 1) ^ 2)
+end
+function ____exports.easeInOutCirc(self, x)
+    return x < 0.5 and (1 - math.sqrt(1 - (2 * x) ^ 2)) / 2 or (math.sqrt(1 - (-2 * x + 2) ^ 2) + 1) / 2
+end
+function ____exports.easeInElastic(self, x)
+    local c4 = 2 * math.pi / 3
+    return x == 0 and 0 or (x == 1 and 1 or -2 ^ (10 * x - 10) * math.sin((x * 10 - 10.75) * c4))
+end
+function ____exports.easeOutElastic(self, x)
+    local c4 = 2 * math.pi / 3
+    return x == 0 and 0 or (x == 1 and 1 or 2 ^ (-10 * x) * math.sin((x * 10 - 0.75) * c4) + 1)
+end
+function ____exports.easeInOutElastic(self, x)
+    local c5 = 2 * math.pi / 4.5
+    return x == 0 and 0 or (x == 1 and 1 or (x < 0.5 and -(2 ^ (20 * x - 10) * math.sin((20 * x - 11.125) * c5)) / 2 or 2 ^ (-20 * x + 10) * math.sin((20 * x - 11.125) * c5) / 2 + 1))
+end
+function ____exports.easeInQuad(self, x)
+    return x * x
+end
+function ____exports.easeOutQuad(self, x)
+    return 1 - (1 - x) * (1 - x)
+end
+function ____exports.easeInOutQuad(self, x)
+    return x < 0.5 and 2 * x * x or 1 - (-2 * x + 2) ^ 2 / 2
+end
+function ____exports.easeInQuart(self, x)
+    return x * x * x * x
+end
+function ____exports.easeOutQuart(self, x)
+    return 1 - (1 - x) ^ 4
+end
+function ____exports.easeInOutQuart(self, x)
+    return x < 0.5 and 8 * x * x * x * x or 1 - (-2 * x + 2) ^ 4 / 2
+end
+function ____exports.easeInExpo(self, x)
+    return x == 0 and 0 or 2 ^ (10 * x - 10)
+end
+function ____exports.easeOutExpo(self, x)
+    return x == 1 and 1 or 1 - 2 ^ (-10 * x)
+end
+function ____exports.easeInOutExpo(self, x)
+    return x == 0 and 0 or (x == 1 and 1 or (x < 0.5 and 2 ^ (20 * x - 10) / 2 or (2 - 2 ^ (-20 * x + 10)) / 2))
+end
+function ____exports.easeInBack(self, x)
+    local c1 = 1.70158
+    local c3 = c1 + 1
+    return c3 * x * x * x - c1 * x * x
+end
+function ____exports.easeOutBack(self, x)
+    local c1 = 1.70158
+    local c3 = c1 + 1
+    return 1 + c3 * (x - 1) ^ 3 + c1 * (x - 1) ^ 2
+end
+function ____exports.easeInOutBack(self, x)
+    local c1 = 1.70158
+    local c2 = c1 * 1.525
+    return x < 0.5 and (2 * x) ^ 2 * ((c2 + 1) * 2 * x - c2) / 2 or ((2 * x - 2) ^ 2 * ((c2 + 1) * (x * 2 - 2) + c2) + 2) / 2
+end
+function ____exports.easeInBounce(self, x)
+    return 1 - ____exports.easeOutBounce(nil, 1 - x)
+end
+function ____exports.easeInOutBounce(self, x)
+    return x < 0.5 and (1 - ____exports.easeOutBounce(nil, 1 - 2 * x)) / 2 or (1 + ____exports.easeOutBounce(nil, 2 * x - 1)) / 2
+end
+return ____exports

package/dist/functions/log.d.ts

@@ -27,7 +27,7 @@ export declare function logEntityID(this: void, entity: Entity): void;
  */
 export declare function logError(this: void, msg: string): void;
 /** Helper function for printing out every flag that is turned on. Useful when debugging. */
-export declare function logFlags(this: void, flags: int, flagEnum?: LuaTable, description?: string): void;
+export declare function logFlags(this: void, flags: int, flagEnum?: LuaTable<AnyNotNil, unknown>, description?: string): void;
 /**
  * Helper function for printing out every game state flag that is turned on. Useful when debugging.
  */

package/dist/functions/serialization.d.ts

@@ -1,12 +1,11 @@
 import { SerializationType } from "../enums/SerializationType";
-import { SerializableIsaacAPIClass } from "../types/private/SerializableIsaacAPIClass";
 import { SerializedIsaacAPIClass } from "../types/private/SerializedIsaacAPIClass";
-export declare function copyIsaacAPIClass(isaacAPIClass: SerializableIsaacAPIClass, serializationType: SerializationType): unknown;
+export declare function copyIsaacAPIClass(isaacAPIClass: unknown, serializationType: SerializationType): unknown;
 /**
- * Deserialization is a special case, so we make a dedicated function for this. There is no need for
- * a "serializeIsaacAPIClass" function because the "copyIsaacAPIClass" function can handles all
- * serialization types.
+ * Deserialization is a special case, so we make a dedicated function for this.
+ *
+ * There is no need for a corresponding "serializeIsaacAPIClass" function because the
+ * "copyIsaacAPIClass" function can handles all serialization types.
  */
 export declare function deserializeIsaacAPIClass(serializedIsaacAPIClass: SerializedIsaacAPIClass): unknown;
-export declare function isSerializableIsaacAPIClass(object: unknown): object is SerializableIsaacAPIClass;
 export declare function isSerializedIsaacAPIClass(object: unknown): object is SerializedIsaacAPIClass;

package/dist/functions/serialization.lua

@@ -1,13 +1,9 @@
 local ____lualib = require("lualib_bundle")
-local Set = ____lualib.Set
-local __TS__New = ____lualib.__TS__New
 local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local __TS__ObjectValues = ____lualib.__TS__ObjectValues
 local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
 local getSerializedTableType
-local ____SerializableIsaacAPIClassType = require("enums.private.SerializableIsaacAPIClassType")
-local SerializableIsaacAPIClassType = ____SerializableIsaacAPIClassType.SerializableIsaacAPIClassType
 local ____SerializationType = require("enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
 local ____isaacAPIClassTypeToBrand = require("objects.isaacAPIClassTypeToBrand")
@@ -18,35 +14,29 @@ local ____serializedIsaacAPIClassTypeToIdentityFunction = require("objects.seria
 local SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION = ____serializedIsaacAPIClassTypeToIdentityFunction.SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION
 local ____isaacAPIClass = require("functions.isaacAPIClass")
 local getIsaacAPIClassType = ____isaacAPIClass.getIsaacAPIClassType
-local ____utils = require("functions.utils")
-local getEnumValues = ____utils.getEnumValues
 function getSerializedTableType(self, serializedIsaacAPIClass)
     for ____, ____value in ipairs(__TS__ObjectEntries(ISAAC_API_CLASS_TYPE_TO_BRAND)) do
-        local serializableIsaacAPIClassType = ____value[1]
+        local copyableIsaacAPIClassType = ____value[1]
         local serializationBrand = ____value[2]
         if serializedIsaacAPIClass[serializationBrand] ~= nil then
-            return serializableIsaacAPIClassType
+            return copyableIsaacAPIClassType
         end
     end
     return nil
 end
-local SERIALIZABLE_ISAAC_API_CLASS_TYPES_SET = __TS__New(
-    Set,
-    getEnumValues(nil, SerializableIsaacAPIClassType)
-)
 function ____exports.copyIsaacAPIClass(self, isaacAPIClass, serializationType)
     local objectType = type(isaacAPIClass)
     if objectType ~= "userdata" then
-        error("Failed to serialize an Isaac API class since the provided object was of type: " .. objectType)
+        error("Failed to copy an Isaac API class since the provided object was of type: " .. objectType)
     end
     local isaacAPIClassType = getIsaacAPIClassType(nil, isaacAPIClass)
     if isaacAPIClassType == nil then
-        error("Failed to serialize an Isaac API class due to it not having a class type.")
+        error("Failed to copy an Isaac API class due to it not having a class type.")
     end
-    local serializableIsaacAPIClassType = isaacAPIClassType
-    local copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[serializableIsaacAPIClassType]
+    local copyableIsaacAPIClassType = isaacAPIClassType
+    local copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[copyableIsaacAPIClassType]
     if copyFunction == nil then
-        error(("Failed to copy Isaac API class \"" .. serializableIsaacAPIClassType) .. "\" since there is not a defined copy function for this class type.")
+        error(("Failed to copy Isaac API class \"" .. copyableIsaacAPIClassType) .. "\" since there is not a defined copy function for this class type.")
     end
     return copyFunction(nil, isaacAPIClass, serializationType)
 end
@@ -55,23 +45,16 @@ function ____exports.deserializeIsaacAPIClass(self, serializedIsaacAPIClass)
     if objectType ~= "table" then
         error("Failed to deserialize an Isaac API class since the provided object was of type: " .. objectType)
     end
-    local serializableIsaacAPIClassType = getSerializedTableType(nil, serializedIsaacAPIClass)
-    if serializableIsaacAPIClassType == nil then
+    local copyableIsaacAPIClassType = getSerializedTableType(nil, serializedIsaacAPIClass)
+    if copyableIsaacAPIClassType == nil then
         error("Failed to deserialize an API class since a valid class type brand was not found.")
     end
-    local copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[serializableIsaacAPIClassType]
+    local copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[copyableIsaacAPIClassType]
     if copyFunction == nil then
-        error(("Failed to deserialize Isaac API class \"" .. serializableIsaacAPIClassType) .. "\" since there is not a defined copy function for this class type.")
+        error(("Failed to deserialize Isaac API class \"" .. copyableIsaacAPIClassType) .. "\" since there is not a defined copy function for this class type.")
     end
     return copyFunction(nil, serializedIsaacAPIClass, SerializationType.DESERIALIZE)
 end
-function ____exports.isSerializableIsaacAPIClass(self, object)
-    local classType = getIsaacAPIClassType(nil, object)
-    if classType == nil then
-        return false
-    end
-    return SERIALIZABLE_ISAAC_API_CLASS_TYPES_SET:has(classType)
-end
 function ____exports.isSerializedIsaacAPIClass(self, object)
     local identityFunctions = __TS__ObjectValues(SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION)
     return __TS__ArraySome(

package/dist/functions/table.d.ts

@@ -33,4 +33,4 @@ export declare function getStringsFromTable(table: LuaTable<string, unknown>, ob
  * This function is variadic, meaning that you can specify as many arguments as you want to check
  * for.
  */
-export declare function tableHasKeys(table: LuaTable, ...keys: string[]): boolean;
+export declare function tableHasKeys(table: LuaTable<AnyNotNil, unknown>, ...keys: string[]): boolean;

package/dist/functions/tstlClass.d.ts

@@ -0,0 +1,20 @@
+import { TSTLClass } from "../types/private/TSTLClass";
+/**
+ * Returns whether or not this is a class that is provided by the `isaacscript-common` library, such
+ * as a `DefaultMap`.
+ */
+export declare function isIsaacScriptCommonClass(object: unknown): boolean;
+/** TypeScriptToLua classes are Lua tables that have a metatable with a certain amount of keys. */
+export declare function isUserDefinedTSTLClass(object: unknown): object is TSTLClass;
+/**
+ * Returns whether or not this is a class that is provided as part of the TypeScriptToLua
+ * transpiler, such as a `Map` or a `Set`.
+ */
+export declare function isVanillaTSTLClass(object: unknown): boolean;
+/**
+ * Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
+ * it is. This function requires that you provide an instantiated class of the same type, as it will
+ * use the class constructor that is present on the other object's metatable to initialize the new
+ * class.
+ */
+export declare function newTSTLClass(oldClass: TSTLClass): TSTLClass;

package/dist/functions/tstlClass.lua

@@ -0,0 +1,56 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__InstanceOf = ____lualib.__TS__InstanceOf
+local Map = ____lualib.Map
+local WeakMap = ____lualib.WeakMap
+local WeakSet = ____lualib.WeakSet
+local ____exports = {}
+local newTSTLClassFromMetatable
+local ____DefaultMap = require("classes.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
+function ____exports.isVanillaTSTLClass(self, object)
+    return __TS__InstanceOf(object, Map) or __TS__InstanceOf(object, Set) or __TS__InstanceOf(object, WeakMap) or __TS__InstanceOf(object, WeakSet)
+end
+function newTSTLClassFromMetatable(self, metatable)
+    local newClass = {}
+    local newClassMetatable = setmetatable(newClass, metatable.constructor.prototype)
+    newClassMetatable:____constructor()
+    return newClass
+end
+local TSTL_CLASS_METATABLE_KEYS = __TS__New(Set, {"____constructor", "__index", "constructor"})
+function ____exports.isIsaacScriptCommonClass(self, object)
+    return __TS__InstanceOf(object, DefaultMap)
+end
+function ____exports.isUserDefinedTSTLClass(self, object)
+    if ____exports.isVanillaTSTLClass(nil, object) or ____exports.isIsaacScriptCommonClass(nil, object) then
+        return false
+    end
+    local objectType = type(object)
+    if objectType ~= "table" then
+        return false
+    end
+    local metatable = getmetatable(object)
+    if metatable == nil then
+        return false
+    end
+    local numKeys = 0
+    for key in pairs(metatable) do
+        numKeys = numKeys + 1
+        if type(key) ~= "string" then
+            return false
+        end
+        if not TSTL_CLASS_METATABLE_KEYS:has(key) then
+            return false
+        end
+    end
+    return numKeys == TSTL_CLASS_METATABLE_KEYS.size
+end
+function ____exports.newTSTLClass(self, oldClass)
+    local metatable = getmetatable(oldClass)
+    if metatable == nil then
+        error("Failed to instantiate a new TypeScriptToLua class since the provided old class does not have a metatable.")
+    end
+    return newTSTLClassFromMetatable(nil, metatable)
+end
+return ____exports

package/dist/functions/utils.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="isaac-typescript-definitions" />
-/// <reference types="typescript-to-lua/language-extensions" />
 /**
  * Helper function to get type safety on a switch statement.
  *
@@ -7,14 +6,14 @@
  *
  * Example:
  * ```ts
- * enum Situations {
+ * enum Situation {
  *   ONE,
  *   TWO,
  *   THREE,
  *   // FOUR, // If we uncomment this line, the program will no longer compile
  * }
  *
- * function doThingBasedOnSituation(situation: Situation) {
+ * function handleSituation(situation: Situation) {
  *   switch (situation) {
  *     case Situation.ONE: {
  *       return 41;
@@ -74,7 +73,7 @@ export declare function getEnumValues<T>(transpiledEnum: T): Array<T[keyof T]>;
  * Helper function to log what is happening in functions that recursively move through nested data
  * structures.
  */
-export declare function getTraversalDescription(key: AnyNotNil, traversalDescription: string): string;
+export declare function getTraversalDescription(key: unknown, traversalDescription: string): string;
 /**
  * Converts a hex string like "#33aa33" to a KColor object.
  *

package/dist/index.d.ts

@@ -45,6 +45,7 @@ export * from "./functions/debug";
 export { deepCopy } from "./functions/deepCopy";
 export { deepCopyTests } from "./functions/deepCopyTests";
 export * from "./functions/doors";
+export * from "./functions/easing";
 export * from "./functions/entity";
 export * from "./functions/entitySpecific";
 export * from "./functions/familiars";
@@ -94,6 +95,7 @@ export * from "./functions/trinketCacheFlag";
 export * from "./functions/trinketGive";
 export * from "./functions/trinkets";
 export * from "./functions/trinketSet";
+export * from "./functions/tstlClass";
 export * from "./functions/ui";
 export * from "./functions/utils";
 export * from "./functions/vector";

package/dist/index.lua

@@ -363,6 +363,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.easing")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.entity")
     for ____exportKey, ____exportValue in pairs(____export) do
@@ -752,6 +760,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.tstlClass")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.ui")
     for ____exportKey, ____exportValue in pairs(____export) do

package/dist/objects/isaacAPIClassTypeToBrand.d.ts

@@ -1,5 +1,5 @@
-import { SerializableIsaacAPIClassType } from "../enums/private/SerializableIsaacAPIClassType";
+import { CopyableIsaacAPIClassType } from "../enums/private/CopyableIsaacAPIClassType";
 import { SerializationBrand } from "../enums/private/SerializationBrand";
 export declare const ISAAC_API_CLASS_TYPE_TO_BRAND: {
-    readonly [key in SerializableIsaacAPIClassType]: SerializationBrand;
+    readonly [key in CopyableIsaacAPIClassType]: SerializationBrand;
 };

package/dist/objects/isaacAPIClassTypeToBrand.lua

@@ -1,8 +1,8 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-local ____SerializableIsaacAPIClassType = require("enums.private.SerializableIsaacAPIClassType")
-local SerializableIsaacAPIClassType = ____SerializableIsaacAPIClassType.SerializableIsaacAPIClassType
+local ____CopyableIsaacAPIClassType = require("enums.private.CopyableIsaacAPIClassType")
+local CopyableIsaacAPIClassType = ____CopyableIsaacAPIClassType.CopyableIsaacAPIClassType
 local ____SerializationBrand = require("enums.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
-____exports.ISAAC_API_CLASS_TYPE_TO_BRAND = {[SerializableIsaacAPIClassType.COLOR] = SerializationBrand.COLOR, [SerializableIsaacAPIClassType.KCOLOR] = SerializationBrand.KCOLOR, [SerializableIsaacAPIClassType.RNG] = SerializationBrand.RNG, [SerializableIsaacAPIClassType.VECTOR] = SerializationBrand.VECTOR}
+____exports.ISAAC_API_CLASS_TYPE_TO_BRAND = {[CopyableIsaacAPIClassType.COLOR] = SerializationBrand.COLOR, [CopyableIsaacAPIClassType.KCOLOR] = SerializationBrand.KCOLOR, [CopyableIsaacAPIClassType.RNG] = SerializationBrand.RNG, [CopyableIsaacAPIClassType.VECTOR] = SerializationBrand.VECTOR}
 return ____exports

package/dist/objects/isaacAPIClassTypeToCopyFunction.d.ts

@@ -1,5 +1,5 @@
-import { SerializableIsaacAPIClassType } from "../enums/private/SerializableIsaacAPIClassType";
+import { CopyableIsaacAPIClassType } from "../enums/private/CopyableIsaacAPIClassType";
 import { SerializationType } from "../enums/SerializationType";
 export declare const ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION: {
-    readonly [key in SerializableIsaacAPIClassType]: (object: unknown, serializationType: SerializationType) => boolean;
+    readonly [key in CopyableIsaacAPIClassType]: (object: unknown, serializationType: SerializationType) => boolean;
 };

package/dist/objects/isaacAPIClassTypeToCopyFunction.lua

@@ -1,7 +1,7 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-local ____SerializableIsaacAPIClassType = require("enums.private.SerializableIsaacAPIClassType")
-local SerializableIsaacAPIClassType = ____SerializableIsaacAPIClassType.SerializableIsaacAPIClassType
+local ____CopyableIsaacAPIClassType = require("enums.private.CopyableIsaacAPIClassType")
+local CopyableIsaacAPIClassType = ____CopyableIsaacAPIClassType.CopyableIsaacAPIClassType
 local ____color = require("functions.color")
 local copyColor = ____color.copyColor
 local ____kColor = require("functions.kColor")
@@ -10,5 +10,5 @@ local ____rng = require("functions.rng")
 local copyRNG = ____rng.copyRNG
 local ____vector = require("functions.vector")
 local copyVector = ____vector.copyVector
-____exports.ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION = {[SerializableIsaacAPIClassType.COLOR] = copyColor, [SerializableIsaacAPIClassType.KCOLOR] = copyKColor, [SerializableIsaacAPIClassType.RNG] = copyRNG, [SerializableIsaacAPIClassType.VECTOR] = copyVector}
+____exports.ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION = {[CopyableIsaacAPIClassType.COLOR] = copyColor, [CopyableIsaacAPIClassType.KCOLOR] = copyKColor, [CopyableIsaacAPIClassType.RNG] = copyRNG, [CopyableIsaacAPIClassType.VECTOR] = copyVector}
 return ____exports

package/dist/objects/serializedIsaacAPIClassTypeToIdentityFunction.d.ts

@@ -1,4 +1,4 @@
-import { SerializableIsaacAPIClassType } from "../enums/private/SerializableIsaacAPIClassType";
+import { CopyableIsaacAPIClassType } from "../enums/private/CopyableIsaacAPIClassType";
 export declare const SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION: {
-    readonly [key in SerializableIsaacAPIClassType]: (object: unknown) => boolean;
+    readonly [key in CopyableIsaacAPIClassType]: (object: unknown) => boolean;
 };

package/dist/objects/serializedIsaacAPIClassTypeToIdentityFunction.lua

@@ -1,7 +1,7 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-local ____SerializableIsaacAPIClassType = require("enums.private.SerializableIsaacAPIClassType")
-local SerializableIsaacAPIClassType = ____SerializableIsaacAPIClassType.SerializableIsaacAPIClassType
+local ____CopyableIsaacAPIClassType = require("enums.private.CopyableIsaacAPIClassType")
+local CopyableIsaacAPIClassType = ____CopyableIsaacAPIClassType.CopyableIsaacAPIClassType
 local ____color = require("functions.color")
 local isSerializedColor = ____color.isSerializedColor
 local ____kColor = require("functions.kColor")
@@ -10,5 +10,5 @@ local ____rng = require("functions.rng")
 local isSerializedRNG = ____rng.isSerializedRNG
 local ____vector = require("functions.vector")
 local isSerializedVector = ____vector.isSerializedVector
-____exports.SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION = {[SerializableIsaacAPIClassType.COLOR] = isSerializedColor, [SerializableIsaacAPIClassType.KCOLOR] = isSerializedKColor, [SerializableIsaacAPIClassType.RNG] = isSerializedRNG, [SerializableIsaacAPIClassType.VECTOR] = isSerializedVector}
+____exports.SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION = {[CopyableIsaacAPIClassType.COLOR] = isSerializedColor, [CopyableIsaacAPIClassType.KCOLOR] = isSerializedKColor, [CopyableIsaacAPIClassType.RNG] = isSerializedRNG, [CopyableIsaacAPIClassType.VECTOR] = isSerializedVector}
 return ____exports

package/dist/types/private/SaveData.d.ts

@@ -1,4 +1,8 @@
 import { Primitive } from "../Primitive";
+/**
+ * I don't know how to create a recursive type definition for only primitive values. For now, this
+ * is typed as "unknown", which provides no type safety.
+ */
 declare type Serializable = Primitive | unknown;
 /**
  * Each sub-object of save data has a string as a key, without arbitrary data as a value. However,

package/dist/types/private/TSTLClass.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="typescript-to-lua/language-extensions" />
+export declare type TSTLClass = LuaTable<AnyNotNil, unknown> & {
+    __tstlClassBrand: unknown;
+};

package/dist/types/private/TSTLClass.lua

@@ -0,0 +1,3 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+return ____exports

package/dist/types/private/TSTLClassMetatable.d.ts

@@ -1,8 +1,10 @@
+/// <reference types="lua-types/5.3" />
+/// <reference types="typescript-to-lua/language-extensions" />
 export interface TSTLClassMetatable {
     ____constructor: () => void;
     __index: unknown;
     constructor: {
-        prototype: unknown;
+        prototype: LuaMetatable<LuaTable<AnyNotNil, unknown>>;
         name: string;
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.247",
+  "version": "1.2.250",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -26,7 +26,7 @@
   ],
   "devDependencies": {
     "isaac-typescript-definitions": "^1.0.388",
-    "isaacscript-lint": "^1.0.98",
+    "isaacscript-lint": "^1.0.99",
     "isaacscript-tsconfig": "^1.1.8",
     "typedoc": "^0.22.13",
     "typescript": "4.6.3",