isaacscript-common 9.13.5-dev.2 → 9.14.0

package/dist/functions/deepCopy.lua

@@ -78,7 +78,7 @@ local twoDimensionalSort = ____utils.twoDimensionalSort
 -- Default is an empty string.
 -- @param insideMap Optional. Tracks whether or not the deep copy function is in the process of
 -- recursively copying a TSTL Map. Default is false.
-function ____exports.deepCopy(value, serializationType, traversalDescription, insideMap)
+function ____exports.deepCopy(self, value, serializationType, traversalDescription, insideMap)
     if serializationType == nil then
         serializationType = SerializationType.NONE
     end
@@ -96,7 +96,7 @@ function ____exports.deepCopy(value, serializationType, traversalDescription, in
             logString = logString .. " (deserializing)"
         end
         logString = logString .. ": " .. tostring(value)
-        log(logString)
+        log(nil, logString)
     end
     local valueType = type(value)
     repeat
@@ -120,71 +120,131 @@ function ____exports.deepCopy(value, serializationType, traversalDescription, in
         if ____cond6 then
             do
                 local luaMap = value
-                return deepCopyTable(luaMap, serializationType, traversalDescription, insideMap)
+                return deepCopyTable(
+                    nil,
+                    luaMap,
+                    serializationType,
+                    traversalDescription,
+                    insideMap
+                )
             end
         end
         ____cond6 = ____cond6 or ____switch6 == "userdata"
         if ____cond6 then
             do
-                return deepCopyUserdata(value, serializationType, traversalDescription)
+                return deepCopyUserdata(nil, value, serializationType, traversalDescription)
             end
         end
     until true
 end
-function deepCopyTable(luaMap, serializationType, traversalDescription, insideMap)
-    if isDefaultMap(luaMap) or luaMap[SerializationBrand.DEFAULT_MAP] ~= nil then
-        return deepCopyDefaultMap(luaMap, serializationType, traversalDescription, insideMap)
-    end
-    if isTSTLMap(luaMap) or luaMap[SerializationBrand.MAP] ~= nil then
-        return deepCopyMap(luaMap, serializationType, traversalDescription, insideMap)
-    end
-    if isTSTLSet(luaMap) or luaMap[SerializationBrand.SET] ~= nil then
-        return deepCopySet(luaMap, serializationType, traversalDescription, insideMap)
-    end
-    local className = getTSTLClassName(luaMap)
+function deepCopyTable(self, luaMap, serializationType, traversalDescription, insideMap)
+    if isDefaultMap(nil, luaMap) or luaMap[SerializationBrand.DEFAULT_MAP] ~= nil then
+        return deepCopyDefaultMap(
+            nil,
+            luaMap,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
+    end
+    if isTSTLMap(nil, luaMap) or luaMap[SerializationBrand.MAP] ~= nil then
+        return deepCopyMap(
+            nil,
+            luaMap,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
+    end
+    if isTSTLSet(nil, luaMap) or luaMap[SerializationBrand.SET] ~= nil then
+        return deepCopySet(
+            nil,
+            luaMap,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
+    end
+    local className = getTSTLClassName(nil, luaMap)
     if className == "WeakMap" then
         error("The deep copy function does not support copying the \"WeakMap\" class for: " .. traversalDescription)
     end
     if className == "WeakSet" then
         error("The deep copy function does not support copying the \"WeakSet\" class for: " .. traversalDescription)
     end
-    if isUserDefinedTSTLClass(luaMap) then
-        return deepCopyTSTLClass(luaMap, serializationType, traversalDescription, insideMap)
-    end
-    checkMetatable(luaMap, traversalDescription)
-    if isSerializedIsaacAPIClass(luaMap) and serializationType == SerializationType.DESERIALIZE then
-        return deserializeIsaacAPIClass(luaMap)
-    end
-    if isArray(luaMap) then
-        return deepCopyArray(luaMap, serializationType, traversalDescription, insideMap)
-    end
-    return deepCopyNormalLuaTable(luaMap, serializationType, traversalDescription, insideMap)
+    if isUserDefinedTSTLClass(nil, luaMap) then
+        return deepCopyTSTLClass(
+            nil,
+            luaMap,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
+    end
+    checkMetatable(nil, luaMap, traversalDescription)
+    if isSerializedIsaacAPIClass(nil, luaMap) and serializationType == SerializationType.DESERIALIZE then
+        return deserializeIsaacAPIClass(nil, luaMap)
+    end
+    if isArray(nil, luaMap) then
+        return deepCopyArray(
+            nil,
+            luaMap,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
+    end
+    return deepCopyNormalLuaTable(
+        nil,
+        luaMap,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
 end
-function deepCopyDefaultMap(defaultMap, serializationType, traversalDescription, insideMap)
+function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a DefaultMap.")
+        log(nil, "deepCopy is copying a DefaultMap.")
     end
     local ____isDefaultMap_result_0
-    if isDefaultMap(defaultMap) then
+    if isDefaultMap(nil, defaultMap) then
         ____isDefaultMap_result_0 = defaultMap:getConstructorArg()
     else
         ____isDefaultMap_result_0 = nil
     end
     local constructorArg = ____isDefaultMap_result_0
-    if serializationType == SerializationType.SERIALIZE and not isPrimitive(constructorArg) then
+    if serializationType == SerializationType.SERIALIZE and not isPrimitive(nil, constructorArg) then
         if insideMap then
             error("Failed to deep copy a DefaultMap because it was instantiated with a factory function and was also inside of an array, map, or set. For more information, see: https://isaacscript.github.io/main/gotchas#failed-to-deep-copy-a-defaultmap")
         else
-            return deepCopyMap(defaultMap, serializationType, traversalDescription, insideMap)
+            return deepCopyMap(
+                nil,
+                defaultMap,
+                serializationType,
+                traversalDescription,
+                insideMap
+            )
         end
     end
-    local newDefaultMap = getNewDefaultMap(defaultMap, serializationType, traversalDescription, constructorArg)
+    local newDefaultMap = getNewDefaultMap(
+        nil,
+        defaultMap,
+        serializationType,
+        traversalDescription,
+        constructorArg
+    )
     insideMap = true
-    local ____getCopiedEntries_result_1 = getCopiedEntries(defaultMap, serializationType, traversalDescription, insideMap)
+    local ____getCopiedEntries_result_1 = getCopiedEntries(
+        nil,
+        defaultMap,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
     local entries = ____getCopiedEntries_result_1.entries
     local convertedNumberKeysToStrings = ____getCopiedEntries_result_1.convertedNumberKeysToStrings
     if convertedNumberKeysToStrings then
-        if isDefaultMap(newDefaultMap) then
+        if isDefaultMap(nil, newDefaultMap) then
             newDefaultMap:set(SerializationBrand.OBJECT_WITH_NUMBER_KEYS, "")
         else
             newDefaultMap[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
@@ -193,7 +253,7 @@ function deepCopyDefaultMap(defaultMap, serializationType, traversalDescription,
     for ____, ____value in ipairs(entries) do
         local key = ____value[1]
         local value = ____value[2]
-        if isDefaultMap(newDefaultMap) then
+        if isDefaultMap(nil, newDefaultMap) then
             newDefaultMap:set(key, value)
         else
             newDefaultMap[key] = value
@@ -202,7 +262,7 @@ function deepCopyDefaultMap(defaultMap, serializationType, traversalDescription,
     insideMap = false
     return newDefaultMap
 end
-function getNewDefaultMap(defaultMap, serializationType, traversalDescription, constructorArg)
+function getNewDefaultMap(self, defaultMap, serializationType, traversalDescription, constructorArg)
     repeat
         local ____switch34 = serializationType
         local ____cond34 = ____switch34 == SerializationType.NONE
@@ -223,7 +283,7 @@ function getNewDefaultMap(defaultMap, serializationType, traversalDescription, c
         ____cond34 = ____cond34 or ____switch34 == SerializationType.DESERIALIZE
         if ____cond34 then
             do
-                if isDefaultMap(defaultMap) then
+                if isDefaultMap(nil, defaultMap) then
                     error(("The deep copy function failed to deserialize a default map of \"" .. traversalDescription) .. "\", since it was not a Lua table.")
                 end
                 local defaultMapValue = defaultMap[SerializationBrand.DEFAULT_MAP_VALUE]
@@ -235,9 +295,9 @@ function getNewDefaultMap(defaultMap, serializationType, traversalDescription, c
         end
     until true
 end
-function deepCopyMap(map, serializationType, traversalDescription, insideMap)
+function deepCopyMap(self, map, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a Map.")
+        log(nil, "deepCopy is copying a Map.")
     end
     local newMap
     if serializationType == SerializationType.SERIALIZE then
@@ -247,11 +307,17 @@ function deepCopyMap(map, serializationType, traversalDescription, insideMap)
         newMap = __TS__New(Map)
     end
     insideMap = true
-    local ____getCopiedEntries_result_2 = getCopiedEntries(map, serializationType, traversalDescription, insideMap)
+    local ____getCopiedEntries_result_2 = getCopiedEntries(
+        nil,
+        map,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
     local entries = ____getCopiedEntries_result_2.entries
     local convertedNumberKeysToStrings = ____getCopiedEntries_result_2.convertedNumberKeysToStrings
     if convertedNumberKeysToStrings then
-        if isTSTLMap(newMap) then
+        if isTSTLMap(nil, newMap) then
             newMap:set(SerializationBrand.OBJECT_WITH_NUMBER_KEYS, "")
         else
             newMap[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
@@ -260,7 +326,7 @@ function deepCopyMap(map, serializationType, traversalDescription, insideMap)
     for ____, ____value in ipairs(entries) do
         local key = ____value[1]
         local value = ____value[2]
-        if isTSTLMap(newMap) then
+        if isTSTLMap(nil, newMap) then
             newMap:set(key, value)
         else
             newMap[key] = value
@@ -269,9 +335,9 @@ function deepCopyMap(map, serializationType, traversalDescription, insideMap)
     insideMap = false
     return newMap
 end
-function deepCopySet(set, serializationType, traversalDescription, insideMap)
+function deepCopySet(self, set, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a Set.")
+        log(nil, "deepCopy is copying a Set.")
     end
     local newSet
     if serializationType == SerializationType.SERIALIZE then
@@ -280,11 +346,17 @@ function deepCopySet(set, serializationType, traversalDescription, insideMap)
     else
         newSet = __TS__New(Set)
     end
-    local ____getCopiedEntries_result_3 = getCopiedEntries(set, serializationType, traversalDescription, insideMap)
+    local ____getCopiedEntries_result_3 = getCopiedEntries(
+        nil,
+        set,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
     local entries = ____getCopiedEntries_result_3.entries
     local convertedNumberKeysToStrings = ____getCopiedEntries_result_3.convertedNumberKeysToStrings
     if convertedNumberKeysToStrings then
-        if isTSTLSet(newSet) then
+        if isTSTLSet(nil, newSet) then
             error("The deep copy function cannot convert number keys to strings for a Set.")
         else
             newSet[SerializationBrand.OBJECT_WITH_NUMBER_KEYS] = ""
@@ -292,7 +364,7 @@ function deepCopySet(set, serializationType, traversalDescription, insideMap)
     end
     for ____, ____value in ipairs(entries) do
         local key = ____value[1]
-        if isTSTLSet(newSet) then
+        if isTSTLSet(nil, newSet) then
             newSet:add(key)
         else
             newSet[key] = ""
@@ -300,17 +372,23 @@ function deepCopySet(set, serializationType, traversalDescription, insideMap)
     end
     return newSet
 end
-function deepCopyTSTLClass(tstlClass, serializationType, traversalDescription, insideMap)
+function deepCopyTSTLClass(self, tstlClass, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a TSTL class.")
+        log(nil, "deepCopy is copying a TSTL class.")
     end
     local newClass
     if serializationType == SerializationType.SERIALIZE then
         newClass = {}
     else
-        newClass = newTSTLClass(tstlClass)
-    end
-    local ____getCopiedEntries_result_4 = getCopiedEntries(tstlClass, serializationType, traversalDescription, insideMap)
+        newClass = newTSTLClass(nil, tstlClass)
+    end
+    local ____getCopiedEntries_result_4 = getCopiedEntries(
+        nil,
+        tstlClass,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
     local entries = ____getCopiedEntries_result_4.entries
     local convertedNumberKeysToStrings = ____getCopiedEntries_result_4.convertedNumberKeysToStrings
     if convertedNumberKeysToStrings then
@@ -323,23 +401,35 @@ function deepCopyTSTLClass(tstlClass, serializationType, traversalDescription, i
     end
     return newClass
 end
-function deepCopyArray(array, serializationType, traversalDescription, insideMap)
+function deepCopyArray(self, array, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying an array.")
+        log(nil, "deepCopy is copying an array.")
     end
     local newArray = {}
     for ____, value in ipairs(array) do
-        local newValue = ____exports.deepCopy(value, serializationType, traversalDescription, insideMap)
+        local newValue = ____exports.deepCopy(
+            nil,
+            value,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
         newArray[#newArray + 1] = newValue
     end
     return newArray
 end
-function deepCopyNormalLuaTable(luaMap, serializationType, traversalDescription, insideMap)
+function deepCopyNormalLuaTable(self, luaMap, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a normal Lua table.")
+        log(nil, "deepCopy is copying a normal Lua table.")
     end
     local newTable = {}
-    local ____getCopiedEntries_result_5 = getCopiedEntries(luaMap, serializationType, traversalDescription, insideMap)
+    local ____getCopiedEntries_result_5 = getCopiedEntries(
+        nil,
+        luaMap,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
     local entries = ____getCopiedEntries_result_5.entries
     local convertedNumberKeysToStrings = ____getCopiedEntries_result_5.convertedNumberKeysToStrings
     if convertedNumberKeysToStrings then
@@ -352,9 +442,9 @@ function deepCopyNormalLuaTable(luaMap, serializationType, traversalDescription,
     end
     return newTable
 end
-function getCopiedEntries(object, serializationType, traversalDescription, insideMap)
+function getCopiedEntries(self, object, serializationType, traversalDescription, insideMap)
     local entries = {}
-    if isTSTLMap(object) or isTSTLSet(object) or isDefaultMap(object) then
+    if isTSTLMap(nil, object) or isTSTLSet(nil, object) or isDefaultMap(nil, object) then
         for ____, ____value in __TS__Iterator(object:entries()) do
             local key = ____value[1]
             local value = ____value[2]
@@ -373,7 +463,7 @@ function getCopiedEntries(object, serializationType, traversalDescription, insid
         function(____, ____bindingPattern0)
             local key
             key = ____bindingPattern0[1]
-            return key == asString(SerializationBrand.OBJECT_WITH_NUMBER_KEYS)
+            return key == asString(nil, SerializationBrand.OBJECT_WITH_NUMBER_KEYS)
         end
     )
     local hasNumberKeys = __TS__ArraySome(
@@ -381,7 +471,7 @@ function getCopiedEntries(object, serializationType, traversalDescription, insid
         function(____, ____bindingPattern0)
             local key
             key = ____bindingPattern0[1]
-            return isNumber(key)
+            return isNumber(nil, key)
         end
     )
     local convertNumberKeysToStrings = serializationType == SerializationType.SERIALIZE and hasNumberKeys
@@ -390,11 +480,17 @@ function getCopiedEntries(object, serializationType, traversalDescription, insid
         local key = ____value[1]
         local value = ____value[2]
         do
-            if isSerializationBrand(key) then
+            if isSerializationBrand(nil, key) then
                 goto __continue87
             end
-            traversalDescription = getTraversalDescription(key, traversalDescription)
-            local newValue = ____exports.deepCopy(value, serializationType, traversalDescription, insideMap)
+            traversalDescription = getTraversalDescription(nil, key, traversalDescription)
+            local newValue = ____exports.deepCopy(
+                nil,
+                value,
+                serializationType,
+                traversalDescription,
+                insideMap
+            )
             local keyToUse = key
             if convertStringKeysToNumbers then
                 local numberKey = tonumber(key)
@@ -411,7 +507,7 @@ function getCopiedEntries(object, serializationType, traversalDescription, insid
     end
     return {entries = copiedEntries, convertedNumberKeysToStrings = convertNumberKeysToStrings}
 end
-function checkMetatable(luaMap, traversalDescription)
+function checkMetatable(self, luaMap, traversalDescription)
     local metatable = getmetatable(luaMap)
     if metatable == nil then
         return
@@ -419,11 +515,11 @@ function checkMetatable(luaMap, traversalDescription)
     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 deepCopyUserdata(value, serializationType, traversalDescription)
+function deepCopyUserdata(self, value, serializationType, traversalDescription)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying userdata.")
+        log(nil, "deepCopy is copying userdata.")
     end
-    local classType = getIsaacAPIClassName(value)
+    local classType = getIsaacAPIClassName(nil, value)
     if classType == nil then
         error("The deep copy function was not able to derive the Isaac API class type for: " .. traversalDescription)
     end
@@ -435,25 +531,25 @@ function deepCopyUserdata(value, serializationType, traversalDescription)
         local ____cond99 = ____switch99 == SerializationType.NONE
         if ____cond99 then
             do
-                return copyIsaacAPIClass(value)
+                return copyIsaacAPIClass(nil, value)
             end
         end
         ____cond99 = ____cond99 or ____switch99 == SerializationType.SERIALIZE
         if ____cond99 then
             do
-                return serializeIsaacAPIClass(value)
+                return serializeIsaacAPIClass(nil, value)
             end
         end
         ____cond99 = ____cond99 or ____switch99 == SerializationType.DESERIALIZE
         if ____cond99 then
             do
-                return deserializeIsaacAPIClass(value)
+                return deserializeIsaacAPIClass(nil, value)
             end
         end
     until true
 end
 COPYABLE_ISAAC_API_CLASS_TYPES_SET = __TS__New(
     Set,
-    getEnumValues(CopyableIsaacAPIClassType)
+    getEnumValues(nil, CopyableIsaacAPIClassType)
 )
 return ____exports

package/dist/functions/deepCopyTests.d.ts

@@ -1,4 +1,3 @@
-/** @noSelfInFile */
 /**
  * Run the suite of tests that prove that the "deepCopy" helper function works properly.
  *

package/dist/functions/deepCopyTests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepCopyTests.d.ts","sourceRoot":"","sources":["../../src/functions/deepCopyTests.ts"],"names":[],"mappings":";AAUA;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CA6BvC"}
+{"version":3,"file":"deepCopyTests.d.ts","sourceRoot":"","sources":["../../src/functions/deepCopyTests.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CA6BvC"}