isaacscript-common 6.6.3 → 6.6.4

package/dist/features/saveDataManager/merge.lua

@@ -1,6 +1,6 @@
 local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
 local Set = ____lualib.Set
+local Map = ____lualib.Map
 local ____exports = {}
 local mergeArray, mergeTSTLObject, mergeTable
 local ____SerializationBrand = require("enums.private.SerializationBrand")
@@ -20,6 +20,7 @@ local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local iterateTableInOrder = ____table.iterateTableInOrder
 local ____tstlClass = require("functions.tstlClass")
+local isDefaultMap = ____tstlClass.isDefaultMap
 local isTSTLMap = ____tstlClass.isTSTLMap
 local isTSTLSet = ____tstlClass.isTSTLSet
 local ____types = require("functions.types")
@@ -64,7 +65,7 @@ function ____exports.merge(self, oldObject, newTable, traversalDescription)
         mergeArray(nil, oldObject, newTable)
         return
     end
-    if isTSTLMap(nil, oldObject) or isTSTLSet(nil, oldObject) then
+    if isTSTLMap(nil, oldObject) or isTSTLSet(nil, oldObject) or isDefaultMap(nil, oldObject) then
         mergeTSTLObject(nil, oldObject, newTable, traversalDescription)
     else
         mergeTable(nil, oldObject, newTable, traversalDescription)
@@ -99,7 +100,7 @@ function mergeTSTLObject(self, oldObject, newTable, traversalDescription)
                 end
                 keyToUse = numberKey
             end
-            if isTSTLMap(nil, oldObject) then
+            if isTSTLMap(nil, oldObject) or isDefaultMap(nil, oldObject) then
                 local valueCopy
                 if isTable(nil, value) then
                     valueCopy = deepCopy(nil, value, SerializationType.DESERIALIZE, traversalDescription)

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

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/functions/array.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/functions/array.ts"],"names":[],"mappings":";;;AAKA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EAC1B,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,GACzB,OAAO,CAST;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,aAAa,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EACjC,GAAG,gBAAgB,EAAE,CAAC,EAAE,GACvB,CAAC,EAAE,CAIL;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,aAAa,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EACjC,GAAG,gBAAgB,EAAE,CAAC,EAAE,GACvB,CAAC,EAAE,CAIL;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,GAAG,gBAAgB,EAAE,CAAC,EAAE,GACvB,OAAO,CAcT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EAAE,EACV,GAAG,gBAAgB,EAAE,CAAC,EAAE,GACvB,OAAO,CAWT;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,aAAa,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EACjC,GAAG,eAAe,EAAE,GAAG,EAAE,GACxB,CAAC,EAAE,CAWL;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,KAAK,EAAE,CAAC,EAAE,EACV,GAAG,eAAe,EAAE,GAAG,EAAE,GACxB,OAAO,CAeT;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAQlE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAS1E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,QAAQ,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EAC5B,WAAW,CAAC,EAAE,GAAG,GAChB,CAAC,EAAE,CAcL;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EACzB,iBAAiB,EAAE,OAAO,EAC1B,GAAG,CAAC,EAAE,GAAG,EACT,GAAG,CAAC,EAAE,GAAG,GACR,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CA0C7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,GAAG,EAAE,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EACzB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAO,GAClC,CAAC,CAiBH;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,EAC9C,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAO,GAClC,CAAC,CAQH;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EACzB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,GAAG,EAAE,GAAG,SAAS,GAAG,EAAO,GACtC,GAAG,CAQL;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,EAAE,CAO5D;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAoC5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAavD;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,CAAC,EAC9B,YAAY,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EAChC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,GACrC,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,aAAa,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,EACjC,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,CAAC,EAAE,CAKL;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,IAAI,CAWN;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAM3E"}

package/dist/functions/array.lua

@@ -437,7 +437,7 @@ function ____exports.isArray(self, object)
     if not hasAllNumberKeys then
         return false
     end
-    local tableLength = #object
+    local tableLength = #__TS__ObjectKeys(object)
     if tableLength == 0 then
         return true
     end

package/dist/functions/deepCopyTests.d.ts

@@ -1,2 +1,7 @@
-export declare function deepCopyTests(): void;
+/**
+ * Run the suite of tests that prove that the "deepCopy" helper function works properly.
+ *
+ * This function is only useful if you are troubleshooting the "deepCopy" function.
+ */
+export declare function runDeepCopyTests(): void;
 //# sourceMappingURL=deepCopyTests.d.ts.map

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

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

package/dist/functions/deepCopyTests.lua

@@ -27,7 +27,7 @@ local isString = ____types.isString
 local isTable = ____types.isTable
 function copiedObjectIsTable(self)
     local oldObject = {abc = "def"}
-    local newObject = deepCopy(nil, oldObject)
+    local newObject = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectIsTable")
     if not isTable(nil, newObject) then
         error("The copied object had a type of: " .. __TS__TypeOf(newObject))
     end
@@ -36,7 +36,7 @@ function copiedObjectHasKeyAndValueString(self)
     local keyToLookFor = "abc"
     local valueToLookFor = "def"
     local oldObject = {abc = valueToLookFor}
-    local newTable = deepCopy(nil, oldObject)
+    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasKeyAndValueString")
     local newObject = newTable
     local value = newObject[keyToLookFor]
     if value == nil then
@@ -54,7 +54,7 @@ function copiedTableHasKeyAndValueNumber(self)
     local valueToLookFor = 456
     local oldTable = {}
     oldTable[keyToLookFor] = valueToLookFor
-    local newObject = deepCopy(nil, oldTable)
+    local newObject = deepCopy(nil, oldTable, SerializationType.NONE, "copiedTableHasKeyAndValueNumber")
     local newTable = newObject
     local value = newTable[keyToLookFor]
     if value == nil then
@@ -72,7 +72,7 @@ function copiedTableDoesNotCoerceTypes(self)
     local valueToLookFor = 456
     local oldTable = {}
     oldTable[keyToLookFor] = valueToLookFor
-    local newObject = deepCopy(nil, oldTable)
+    local newObject = deepCopy(nil, oldTable, SerializationType.NONE, "copiedTableDoesNotCoerceTypes")
     local newTable = newObject
     local keyString = tostring(keyToLookFor)
     local valueString = tostring(valueToLookFor)
@@ -89,7 +89,7 @@ function copiedObjectHasNoReferencesForPrimitivesForward(self)
     local originalStringValue = "abcdef"
     local originalNumberValue = 123
     local oldObject = {abc = originalStringValue, def = originalNumberValue}
-    local newTable = deepCopy(nil, oldObject)
+    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForPrimitivesForward")
     local newObject = newTable
     oldObject.abc = "newValue"
     if oldObject.abc == newObject.abc then
@@ -104,7 +104,7 @@ function copiedObjectHasNoReferencesForPrimitivesBackward(self)
     local originalStringValue = "abcdef"
     local originalNumberValue = 123
     local oldObject = {abc = originalStringValue, def = originalNumberValue}
-    local newTable = deepCopy(nil, oldObject)
+    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForPrimitivesBackward")
     local newObject = newTable
     newObject.abc = "newValue"
     if newObject.abc == oldObject.abc then
@@ -117,7 +117,7 @@ function copiedObjectHasNoReferencesForPrimitivesBackward(self)
 end
 function copiedObjectHasNoReferencesForArray(self)
     local oldObject = {abc = {1, 2, 3}}
-    local newTable = deepCopy(nil, oldObject)
+    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForArray")
     local newObject = newTable
     if oldObject.abc == newObject.abc then
         error("The copied object has the same point to the child array.")
@@ -145,7 +145,7 @@ function copiedObjectHasChildObject(self)
     local keyToLookFor = "def"
     local valueToLookFor = "ghi"
     local oldObject = {abc = {def = valueToLookFor}}
-    local newTable = deepCopy(nil, oldObject)
+    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasChildObject")
     local newObject = newTable
     local childObject = newObject[childObjectIndex]
     if childObject == nil then
@@ -170,7 +170,7 @@ function copiedMapIsMap(self)
     local valueToLookFor = "def"
     local oldMap = __TS__New(Map)
     oldMap:set(keyToLookFor, valueToLookFor)
-    local newObject = deepCopy(nil, oldMap)
+    local newObject = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapIsMap")
     local newMap = newObject
     if not isTable(nil, newMap) then
         error("The copied Map had a type of: " .. __TS__TypeOf(newMap))
@@ -184,7 +184,7 @@ function copiedMapHasValue(self)
     local valueToLookFor = "def"
     local oldMap = __TS__New(Map)
     oldMap:set(keyToLookFor, valueToLookFor)
-    local newTable = deepCopy(nil, oldMap)
+    local newTable = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapHasValue")
     local newMap = newTable
     local value = newMap:get(keyToLookFor)
     if value == nil then
@@ -198,7 +198,7 @@ function copiedSetIsSet(self)
     local valueToLookFor = "abc"
     local oldSet = __TS__New(Set)
     oldSet:add(valueToLookFor)
-    local newTable = deepCopy(nil, oldSet)
+    local newTable = deepCopy(nil, oldSet, SerializationType.NONE, "copiedSetIsSet")
     local newSet = newTable
     if not isTable(nil, newSet) then
         error("The copied Set had a type of: " .. __TS__TypeOf(newSet))
@@ -211,7 +211,7 @@ function copiedSetHasValue(self)
     local valueToLookFor = "abc"
     local oldSet = __TS__New(Set)
     oldSet:add(valueToLookFor)
-    local newTable = deepCopy(nil, oldSet)
+    local newTable = deepCopy(nil, oldSet, SerializationType.NONE, "copiedSetHasValue")
     local newSet = newTable
     local hasValue = newSet:has(valueToLookFor)
     if not hasValue then
@@ -226,7 +226,7 @@ function copiedMapHasChildMap(self)
     local keyToLookFor = "abc"
     local oldMap = __TS__New(Map)
     oldMap:set(keyToLookFor, oldChildMap)
-    local newTable = deepCopy(nil, oldMap)
+    local newTable = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapHasChildMap")
     local newMap = newTable
     local newChildMap = newMap:get(keyToLookFor)
     if newChildMap == nil then
@@ -259,7 +259,7 @@ function copiedDefaultMapHasChildDefaultMap(self)
     local oldChildMap = oldParentMap:getAndSetDefault(parentMapKey)
     oldChildMap:getAndSetDefault(childMapKey1)
     oldChildMap:set(childMapKey2, childMapCustomValue)
-    local newTable = deepCopy(nil, oldParentMap)
+    local newTable = deepCopy(nil, oldParentMap, SerializationType.NONE, "copiedDefaultMapHasChildDefaultMap")
     local newParentMap = newTable
     local newChildMap = newParentMap:get(parentMapKey)
     if newChildMap == nil then
@@ -289,12 +289,15 @@ end
 function copiedDefaultMapHasBrand(self)
     local oldDefaultValue = "foo"
     local oldDefaultMap = __TS__New(DefaultMap, oldDefaultValue)
-    local newTable = deepCopy(nil, oldDefaultMap, SerializationType.SERIALIZE)
+    local newTable = deepCopy(nil, oldDefaultMap, SerializationType.SERIALIZE, "copiedDefaultMapHasBrand")
     if not (newTable[SerializationBrand.DEFAULT_MAP] ~= nil) then
         error("The copied DefaultMap does not have the brand: " .. SerializationBrand.DEFAULT_MAP)
     end
 end
-function ____exports.deepCopyTests(self)
+--- Run the suite of tests that prove that the "deepCopy" helper function works properly.
+-- 
+-- This function is only useful if you are troubleshooting the "deepCopy" function.
+function ____exports.runDeepCopyTests(self)
     copiedObjectIsTable(nil)
     copiedObjectHasKeyAndValueString(nil)
     copiedTableHasKeyAndValueNumber(nil)

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

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/functions/log.ts"],"names":[],"mappings":";AAAA,OAAO,EACL,UAAU,EAEV,UAAU,EACV,UAAU,EAEV,cAAc,EAGd,cAAc,EAGd,QAAQ,EACR,OAAO,EACR,MAAM,8BAA8B,CAAC;AA+BtC;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EAKX,kBAAkB,SAAI,GACrB,MAAM,CAiBR;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAGjD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAGvE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAIvD;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,GACvC,IAAI,CAEN;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0BjE;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,EACV,wBAAwB,EAAE,OAAO,EACjC,gBAAgB,CAAC,EAAE,UAAU,GAC5B,IAAI,CAyGN;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,GACvC,IAAI,CAEN;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAItD;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,UAAU,EACrD,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAC3B,WAAW,SAAK,GACf,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAiBlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,OAAO,EACrB,oBAAoB,CAAC,EAAE,cAAc,GACpC,IAAI,CA6FN;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAkBnD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,CAarE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAgBtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,GAC/C,IAAI,CAEN;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAyBxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAiB/C;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,GAC3C,IAAI,CAUN;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAQ1C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,OAAO,EACjB,YAAY,SAAI,GACf,IAAI,CA+BN;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACrB,IAAI,CA0BN;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GACnC,IAAI,CAEN;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GACjC,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAsB/D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,IAAI,CAGzE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CA8B5C"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/functions/log.ts"],"names":[],"mappings":"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"}

package/dist/functions/log.lua

@@ -478,7 +478,9 @@ function ____exports.logTable(luaTable, parentTables)
         math.floor(numSpaces)
     )
     if not isTable(nil, luaTable) then
-        ____exports.log(((indentation .. "n/a (encountered a variable of type \"") .. __TS__TypeOf(luaTable)) .. "\" instead of a table)")
+        (function()
+            ____exports.log(((indentation .. "n/a (encountered a variable of type \"") .. __TS__TypeOf(luaTable)) .. "\" instead of a table)")
+        end)(nil)
         return
     end
     iterateTableInOrder(
@@ -494,8 +496,10 @@ function ____exports.logTable(luaTable, parentTables)
                 end
             end
         end
-    )
-    ____exports.log((indentation .. "The size of the table was: ") .. tostring(#luaTable))
+    );
+    (function()
+        ____exports.log((indentation .. "The size of the table was: ") .. tostring(#luaTable))
+    end)(nil)
 end
 --- Helper function to print out the differences between the entries of two tables. Note that this
 -- will only do a shallow comparison.

package/dist/functions/mergeTests.d.ts

@@ -1,2 +1,8 @@
-export declare function mergeTests(): void;
+/**
+ * Run the suite of tests that prove that the "merge" helper function works properly. (This function
+ * is not exported but is used internally in the save data manager.)
+ *
+ * This function is only useful if you are troubleshooting the save data manager.
+ */
+export declare function runMergeTests(): void;
 //# sourceMappingURL=mergeTests.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mergeTests.d.ts","sourceRoot":"","sources":["../../src/functions/mergeTests.ts"],"names":[],"mappings":"AAQA,wBAAgB,UAAU,IAAI,IAAI,CAajC"}
+{"version":3,"file":"mergeTests.d.ts","sourceRoot":"","sources":["../../src/functions/mergeTests.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAgBpC"}

package/dist/functions/mergeTests.lua

@@ -1,5 +1,10 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local oldTableHasUpdatedValue, newTableHasSameValue, oldTableHasUpdatedValueFromNull, oldTableHasSerializedIsaacAPIClass, oldTableHasFilledInterface, oldTableHasVector, oldTableHasVectorSerialized, oldTableHasRNG, oldTableHasRNGSerialized
+local oldTableHasUpdatedValue, newTableHasSameValue, oldTableHasUpdatedValueFromNull, oldTableHasSerializedIsaacAPIClass, oldTableHasFilledChildTable, oldTableHasFilledMap, oldTableHasFilledDefaultMap, oldTableHasVector, oldTableHasVectorSerialized, oldTableHasRNG, oldTableHasRNGSerialized
+local ____DefaultMap = require("classes.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
 local ____SerializationType = require("enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
 local ____merge = require("features.saveDataManager.merge")
@@ -60,13 +65,13 @@ function oldTableHasSerializedIsaacAPIClass(self)
         error("The \"isSerializedIsaacAPIClass\" function says that a serialized vector is not serialized.")
     end
 end
-function oldTableHasFilledInterface(self)
+function oldTableHasFilledChildTable(self)
     local key = "foo"
     local newValue = "baz"
     local oldTable = {foo = nil}
     local foo = {bar = newValue}
     local newTable = {foo = foo}
-    merge(nil, oldTable, newTable, "oldTableHasFilledInterface")
+    merge(nil, oldTable, newTable, "oldTableHasFilledChildTable")
     local oldTableValue = oldTable[key]
     if oldTableValue == nil then
         error(("The old table's key of \"" .. key) .. "\" was not filled.")
@@ -75,6 +80,74 @@ function oldTableHasFilledInterface(self)
         error("The old table's key of \"bar\" was not filled.")
     end
 end
+function oldTableHasFilledMap(self)
+    local v = {run = {myMap = __TS__New(Map)}}
+    local saveData = {run = {myMap = __TS__New(Map, {{"foo1", "bar1"}, {"foo2", "bar2"}, {"foo3", "bar3"}})}}
+    local serializedSaveData = deepCopy(nil, saveData, SerializationType.SERIALIZE)
+    merge(nil, v, serializedSaveData, "oldTableHasFilledMap")
+    local expectedSize = 3
+    if v.run.myMap.size ~= expectedSize then
+        error((("The size of the merged map was equal to " .. tostring(v.run.myMap.size)) .. ", but it should be equal to: ") .. tostring(expectedSize))
+    end
+    do
+        local key = "foo1"
+        local expectedValue = "bar1"
+        local value = v.run.myMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo2"
+        local expectedValue = "bar2"
+        local value = v.run.myMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo3"
+        local expectedValue = "bar3"
+        local value = v.run.myMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+end
+function oldTableHasFilledDefaultMap(self)
+    local v = {run = {myDefaultMap = __TS__New(DefaultMap, "default")}}
+    local saveData = {run = {myDefaultMap = __TS__New(DefaultMap, "default", {{"foo1", "bar1"}, {"foo2", "bar2"}, {"foo3", "bar3"}})}}
+    local serializedSaveData = deepCopy(nil, saveData, SerializationType.SERIALIZE)
+    merge(nil, v, serializedSaveData, "oldTableHasFilledDefaultMap")
+    local expectedSize = 3
+    if v.run.myDefaultMap.size ~= expectedSize then
+        error((("The size of the merged default map was equal to " .. tostring(v.run.myDefaultMap.size)) .. ", but it should be equal to: ") .. tostring(expectedSize))
+    end
+    do
+        local key = "foo1"
+        local expectedValue = "bar1"
+        local value = v.run.myDefaultMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's default map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo2"
+        local expectedValue = "bar2"
+        local value = v.run.myDefaultMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's default map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo3"
+        local expectedValue = "bar3"
+        local value = v.run.myDefaultMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's default map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+end
 function oldTableHasVector(self)
     log("Starting test: oldTableHasVector")
     local key = "foo"
@@ -108,7 +181,7 @@ function oldTableHasVectorSerialized(self)
     local oldTable = {foo = nil}
     local foo = {bar = newValue}
     local newTable = {foo = foo}
-    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE)
+    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE, "oldTableHasVectorSerialized")
     merge(nil, oldTable, newTableSerialized, "oldTableHasVectorSerialized")
     local oldTableValue = oldTable[key]
     if oldTableValue == nil then
@@ -153,7 +226,7 @@ function oldTableHasRNGSerialized(self)
     local oldTable = {foo = nil}
     local foo = {bar = newValue}
     local newTable = {foo = foo}
-    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE)
+    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE, "oldTableHasRNGSerialized")
     merge(nil, oldTable, newTableSerialized, "oldTableHasRNGSerialized")
     local oldTableValue = oldTable[key]
     if oldTableValue == nil then
@@ -167,12 +240,18 @@ function oldTableHasRNGSerialized(self)
         error("The old table's seed not match: " .. tostring(seed))
     end
 end
-function ____exports.mergeTests(self)
+--- Run the suite of tests that prove that the "merge" helper function works properly. (This function
+-- is not exported but is used internally in the save data manager.)
+-- 
+-- This function is only useful if you are troubleshooting the save data manager.
+function ____exports.runMergeTests(self)
     oldTableHasUpdatedValue(nil)
     newTableHasSameValue(nil)
     oldTableHasUpdatedValueFromNull(nil)
     oldTableHasSerializedIsaacAPIClass(nil)
-    oldTableHasFilledInterface(nil)
+    oldTableHasFilledChildTable(nil)
+    oldTableHasFilledMap(nil)
+    oldTableHasFilledDefaultMap(nil)
     oldTableHasVector(nil)
     oldTableHasVectorSerialized(nil)
     oldTableHasRNG(nil)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "6.6.3",
+  "version": "6.6.4",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/features/saveDataManager/merge.ts

@@ -8,7 +8,7 @@ import {
   isSerializedIsaacAPIClass,
 } from "../../functions/serialization";
 import { clearTable, iterateTableInOrder } from "../../functions/table";
-import { isTSTLMap, isTSTLSet } from "../../functions/tstlClass";
+import { isDefaultMap, isTSTLMap, isTSTLSet } from "../../functions/tstlClass";
 import { isTable } from "../../functions/types";
 import { getTraversalDescription } from "../../functions/utils";
 import { SAVE_DATA_MANAGER_DEBUG } from "./saveDataManagerConstants";
@@ -65,7 +65,7 @@ export function merge(
 
   // Depending on whether we are working on a Lua table or a TypeScriptToLua object, we need to
   // iterate in a specific way.
-  if (isTSTLMap(oldObject) || isTSTLSet(oldObject)) {
+  if (isTSTLMap(oldObject) || isTSTLSet(oldObject) || isDefaultMap(oldObject)) {
     mergeTSTLObject(oldObject, newTable, traversalDescription);
   } else {
     mergeTable(oldObject, newTable, traversalDescription);
@@ -118,7 +118,7 @@ function mergeTSTLObject(
         keyToUse = numberKey;
       }
 
-      if (isTSTLMap(oldObject)) {
+      if (isTSTLMap(oldObject) || isDefaultMap(oldObject)) {
         let valueCopy: unknown;
         if (isTable(value)) {
           valueCopy = deepCopy(

package/src/functions/array.ts

@@ -443,7 +443,10 @@ export function isArray(object: unknown): object is unknown[] {
     return false;
   }
 
-  const tableLength = object.length();
+  // Third, handle the case of an "empty" table. We cannot use the "LuaTable.length" method to
+  // determine this, since that will not actually return the number of keys. (It will only work
+  // properly for tables that are being used as arrays, which is not necessarily the case here.)
+  const tableLength = Object.keys(object).length;
   if (tableLength === 0) {
     return true;
   }

package/src/functions/deepCopyTests.ts

@@ -7,7 +7,12 @@ import { log } from "./log";
 import { isDefaultMap, isTSTLMap, isTSTLSet } from "./tstlClass";
 import { isNumber, isString, isTable } from "./types";
 
-export function deepCopyTests(): void {
+/**
+ * Run the suite of tests that prove that the "deepCopy" helper function works properly.
+ *
+ * This function is only useful if you are troubleshooting the "deepCopy" function.
+ */
+export function runDeepCopyTests(): void {
   copiedObjectIsTable();
   copiedObjectHasKeyAndValueString();
   copiedTableHasKeyAndValueNumber();
@@ -34,7 +39,11 @@ function copiedObjectIsTable() {
   const oldObject = {
     abc: "def",
   };
-  const newObject = deepCopy(oldObject as unknown as LuaTable);
+  const newObject = deepCopy(
+    oldObject as unknown as LuaTable,
+    SerializationType.NONE,
+    "copiedObjectIsTable",
+  );
   if (!isTable(newObject)) {
     error(`The copied object had a type of: ${typeof newObject}`);
   }
@@ -46,7 +55,11 @@ function copiedObjectHasKeyAndValueString() {
   const oldObject = {
     abc: valueToLookFor,
   };
-  const newTable = deepCopy(oldObject as unknown as LuaTable);
+  const newTable = deepCopy(
+    oldObject as unknown as LuaTable,
+    SerializationType.NONE,
+    "copiedObjectHasKeyAndValueString",
+  );
   const newObject = newTable as typeof oldObject;
 
   const value = newObject[keyToLookFor];
@@ -69,7 +82,11 @@ function copiedTableHasKeyAndValueNumber() {
   const oldTable = new LuaTable<AnyNotNil, unknown>();
   oldTable.set(keyToLookFor, valueToLookFor);
 
-  const newObject = deepCopy(oldTable);
+  const newObject = deepCopy(
+    oldTable,
+    SerializationType.NONE,
+    "copiedTableHasKeyAndValueNumber",
+  );
   const newTable = newObject as LuaTable<AnyNotNil, unknown>;
 
   const value = newTable.get(keyToLookFor) as number | undefined;
@@ -91,7 +108,11 @@ function copiedTableDoesNotCoerceTypes() {
   const oldTable = new LuaTable<AnyNotNil, unknown>();
   oldTable.set(keyToLookFor, valueToLookFor);
 
-  const newObject = deepCopy(oldTable);
+  const newObject = deepCopy(
+    oldTable,
+    SerializationType.NONE,
+    "copiedTableDoesNotCoerceTypes",
+  );
   const newTable = newObject as LuaTable<AnyNotNil, unknown>;
 
   const keyString = tostring(keyToLookFor);
@@ -117,7 +138,11 @@ function copiedObjectHasNoReferencesForPrimitivesForward() {
     abc: originalStringValue,
     def: originalNumberValue,
   };
-  const newTable = deepCopy(oldObject as unknown as LuaTable);
+  const newTable = deepCopy(
+    oldObject as unknown as LuaTable,
+    SerializationType.NONE,
+    "copiedObjectHasNoReferencesForPrimitivesForward",
+  );
   const newObject = newTable as typeof oldObject;
 
   oldObject.abc = "newValue";
@@ -138,7 +163,11 @@ function copiedObjectHasNoReferencesForPrimitivesBackward() {
     abc: originalStringValue,
     def: originalNumberValue,
   };
-  const newTable = deepCopy(oldObject as unknown as LuaTable);
+  const newTable = deepCopy(
+    oldObject as unknown as LuaTable,
+    SerializationType.NONE,
+    "copiedObjectHasNoReferencesForPrimitivesBackward",
+  );
   const newObject = newTable as typeof oldObject;
 
   newObject.abc = "newValue";
@@ -156,7 +185,11 @@ function copiedObjectHasNoReferencesForArray() {
   const oldObject = {
     abc: [1, 2, 3],
   };
-  const newTable = deepCopy(oldObject as unknown as LuaTable);
+  const newTable = deepCopy(
+    oldObject as unknown as LuaTable,
+    SerializationType.NONE,
+    "copiedObjectHasNoReferencesForArray",
+  );
   const newObject = newTable as typeof oldObject;
 
   if (oldObject.abc === newObject.abc) {
@@ -193,7 +226,11 @@ function copiedObjectHasChildObject() {
       def: valueToLookFor,
     },
   };
-  const newTable = deepCopy(oldObject as unknown as LuaTable);
+  const newTable = deepCopy(
+    oldObject as unknown as LuaTable,
+    SerializationType.NONE,
+    "copiedObjectHasChildObject",
+  );
   const newObject = newTable as typeof oldObject;
 
   const childObject = newObject[childObjectIndex];
@@ -226,7 +263,7 @@ function copiedMapIsMap() {
   const oldMap = new Map<string, string>();
   oldMap.set(keyToLookFor, valueToLookFor);
 
-  const newObject = deepCopy(oldMap);
+  const newObject = deepCopy(oldMap, SerializationType.NONE, "copiedMapIsMap");
   const newMap = newObject as Map<string, string>;
 
   if (!isTable(newMap)) {
@@ -243,7 +280,11 @@ function copiedMapHasValue() {
   const oldMap = new Map<string, string>();
   oldMap.set(keyToLookFor, valueToLookFor);
 
-  const newTable = deepCopy(oldMap);
+  const newTable = deepCopy(
+    oldMap,
+    SerializationType.NONE,
+    "copiedMapHasValue",
+  );
   const newMap = newTable as typeof oldMap;
 
   const value = newMap.get(keyToLookFor);
@@ -260,7 +301,7 @@ function copiedSetIsSet() {
   const oldSet = new Set<string>();
   oldSet.add(valueToLookFor);
 
-  const newTable = deepCopy(oldSet);
+  const newTable = deepCopy(oldSet, SerializationType.NONE, "copiedSetIsSet");
   const newSet = newTable as Set<string>;
 
   if (!isTable(newSet)) {
@@ -276,7 +317,11 @@ function copiedSetHasValue() {
   const oldSet = new Set<string>();
   oldSet.add(valueToLookFor);
 
-  const newTable = deepCopy(oldSet);
+  const newTable = deepCopy(
+    oldSet,
+    SerializationType.NONE,
+    "copiedSetHasValue",
+  );
   const newSet = newTable as Set<string>;
 
   const hasValue = newSet.has(valueToLookFor);
@@ -295,7 +340,11 @@ function copiedMapHasChildMap() {
   const oldMap = new Map<string, Map<number, number>>();
   oldMap.set(keyToLookFor, oldChildMap);
 
-  const newTable = deepCopy(oldMap);
+  const newTable = deepCopy(
+    oldMap,
+    SerializationType.NONE,
+    "copiedMapHasChildMap",
+  );
   const newMap = newTable as typeof oldMap;
 
   const newChildMap = newMap.get(keyToLookFor);
@@ -332,7 +381,11 @@ function copiedDefaultMapHasChildDefaultMap() {
   oldChildMap.getAndSetDefault(childMapKey1);
   oldChildMap.set(childMapKey2, childMapCustomValue);
 
-  const newTable = deepCopy(oldParentMap);
+  const newTable = deepCopy(
+    oldParentMap,
+    SerializationType.NONE,
+    "copiedDefaultMapHasChildDefaultMap",
+  );
   const newParentMap = newTable as typeof oldParentMap;
 
   const newChildMap = newParentMap.get(parentMapKey);
@@ -376,6 +429,7 @@ function copiedDefaultMapHasBrand() {
   const newTable = deepCopy(
     oldDefaultMap,
     SerializationType.SERIALIZE,
+    "copiedDefaultMapHasBrand",
   ) as LuaTable<AnyNotNil, unknown>;
 
   if (!newTable.has(SerializationBrand.DEFAULT_MAP)) {

package/src/functions/log.ts

@@ -587,9 +587,14 @@ export function logTable(
   const indentation = " ".repeat(numSpaces);
 
   if (!isTable(luaTable)) {
-    log(
-      `${indentation}n/a (encountered a variable of type "${typeof luaTable}" instead of a table)`,
-    );
+    // Put it in an IIFE so that the it will show as "func" instead of "logTable" and align with the
+    // other text.
+    (() => {
+      log(
+        `${indentation}n/a (encountered a variable of type "${typeof luaTable}" instead of a table)`,
+      );
+    })();
+
     return;
   }
 
@@ -608,7 +613,11 @@ export function logTable(
     }
   });
 
-  log(`${indentation}The size of the table was: ${luaTable.length()}`);
+  // Put it in an IIFE so that the it will show as "func" instead of "logTable" and align with the
+  // other text.
+  (() => {
+    log(`${indentation}The size of the table was: ${luaTable.length()}`);
+  })();
 }
 
 /**

package/src/functions/mergeTests.ts

@@ -1,3 +1,4 @@
+import { DefaultMap } from "../classes/DefaultMap";
 import { SerializationType } from "../enums/SerializationType";
 import { merge } from "../features/saveDataManager/merge";
 import { deepCopy } from "./deepCopy";
@@ -6,13 +7,22 @@ import { isRNG, newRNG } from "./rng";
 import { isSerializedIsaacAPIClass } from "./serialization";
 import { copyVector, isVector } from "./vector";
 
-export function mergeTests(): void {
+/**
+ * Run the suite of tests that prove that the "merge" helper function works properly. (This function
+ * is not exported but is used internally in the save data manager.)
+ *
+ * This function is only useful if you are troubleshooting the save data manager.
+ */
+export function runMergeTests(): void {
   oldTableHasUpdatedValue();
   newTableHasSameValue();
   oldTableHasUpdatedValueFromNull();
   oldTableHasSerializedIsaacAPIClass();
 
-  oldTableHasFilledInterface();
+  oldTableHasFilledChildTable();
+  oldTableHasFilledMap();
+  oldTableHasFilledDefaultMap();
+
   oldTableHasVector();
   oldTableHasVectorSerialized();
   oldTableHasRNG();
@@ -90,7 +100,7 @@ function oldTableHasSerializedIsaacAPIClass() {
   }
 }
 
-function oldTableHasFilledInterface() {
+function oldTableHasFilledChildTable() {
   interface Foo {
     bar: string;
   }
@@ -107,7 +117,7 @@ function oldTableHasFilledInterface() {
     foo,
   } as unknown as LuaTable<AnyNotNil, unknown>;
 
-  merge(oldTable, newTable, "oldTableHasFilledInterface");
+  merge(oldTable, newTable, "oldTableHasFilledChildTable");
 
   const oldTableValue = oldTable.get(key) as Foo | undefined;
   if (oldTableValue === undefined) {
@@ -119,6 +129,142 @@ function oldTableHasFilledInterface() {
   }
 }
 
+function oldTableHasFilledMap() {
+  const v = {
+    run: {
+      myMap: new Map<string, string>(),
+    },
+  };
+
+  const saveData = {
+    run: {
+      myMap: new Map<string, string>([
+        ["foo1", "bar1"],
+        ["foo2", "bar2"],
+        ["foo3", "bar3"],
+      ]),
+    },
+  };
+  const serializedSaveData = deepCopy(saveData, SerializationType.SERIALIZE);
+
+  merge(
+    v as unknown as LuaTable,
+    serializedSaveData as LuaTable,
+    "oldTableHasFilledMap",
+  );
+
+  const expectedSize = 3;
+  if (v.run.myMap.size !== expectedSize) {
+    error(
+      `The size of the merged map was equal to ${v.run.myMap.size}, but it should be equal to: ${expectedSize}`,
+    );
+  }
+
+  {
+    const key = "foo1";
+    const expectedValue = "bar1";
+
+    const value = v.run.myMap.get(key);
+    if (value !== expectedValue) {
+      error(
+        `The old table's map key of "${key}" was not equal to "${expectedValue}" and was instead equal to: ${value}`,
+      );
+    }
+  }
+
+  {
+    const key = "foo2";
+    const expectedValue = "bar2";
+
+    const value = v.run.myMap.get(key);
+    if (value !== expectedValue) {
+      error(
+        `The old table's map key of "${key}" was not equal to "${expectedValue}" and was instead equal to: ${value}`,
+      );
+    }
+  }
+
+  {
+    const key = "foo3";
+    const expectedValue = "bar3";
+
+    const value = v.run.myMap.get(key);
+    if (value !== expectedValue) {
+      error(
+        `The old table's map key of "${key}" was not equal to "${expectedValue}" and was instead equal to: ${value}`,
+      );
+    }
+  }
+}
+
+function oldTableHasFilledDefaultMap() {
+  const v = {
+    run: {
+      myDefaultMap: new DefaultMap<string, string>("default"),
+    },
+  };
+
+  const saveData = {
+    run: {
+      myDefaultMap: new DefaultMap<string, string>("default", [
+        ["foo1", "bar1"],
+        ["foo2", "bar2"],
+        ["foo3", "bar3"],
+      ]),
+    },
+  };
+  const serializedSaveData = deepCopy(saveData, SerializationType.SERIALIZE);
+
+  merge(
+    v as unknown as LuaTable,
+    serializedSaveData as LuaTable,
+    "oldTableHasFilledDefaultMap",
+  );
+
+  const expectedSize = 3;
+  if (v.run.myDefaultMap.size !== expectedSize) {
+    error(
+      `The size of the merged default map was equal to ${v.run.myDefaultMap.size}, but it should be equal to: ${expectedSize}`,
+    );
+  }
+
+  {
+    const key = "foo1";
+    const expectedValue = "bar1";
+
+    const value = v.run.myDefaultMap.get(key);
+    if (value !== expectedValue) {
+      error(
+        `The old table's default map key of "${key}" was not equal to "${expectedValue}" and was instead equal to: ${value}`,
+      );
+    }
+  }
+
+  {
+    const key = "foo2";
+    const expectedValue = "bar2";
+
+    const value = v.run.myDefaultMap.get(key);
+    if (value !== expectedValue) {
+      error(
+        `The old table's default map key of "${key}" was not equal to "${expectedValue}" and was instead equal to: ${value}`,
+      );
+    }
+  }
+
+  {
+    const key = "foo3";
+    const expectedValue = "bar3";
+
+    const value = v.run.myDefaultMap.get(key);
+    if (value !== expectedValue) {
+      error(
+        `The old table's default map key of "${key}" was not equal to "${expectedValue}" and was instead equal to: ${value}`,
+      );
+    }
+  }
+}
+
 function oldTableHasVector() {
   log("Starting test: oldTableHasVector");
 
@@ -183,6 +329,7 @@ function oldTableHasVectorSerialized() {
   const newTableSerialized = deepCopy(
     newTable,
     SerializationType.SERIALIZE,
+    "oldTableHasVectorSerialized",
   ) as LuaTable<AnyNotNil, unknown>;
 
   merge(oldTable, newTableSerialized, "oldTableHasVectorSerialized");
@@ -266,6 +413,7 @@ function oldTableHasRNGSerialized() {
   const newTableSerialized = deepCopy(
     newTable,
     SerializationType.SERIALIZE,
+    "oldTableHasRNGSerialized",
   ) as LuaTable<AnyNotNil, unknown>;
 
   merge(oldTable, newTableSerialized, "oldTableHasRNGSerialized");