isaacscript-common 6.6.2 → 6.6.5

package/dist/callbacks/postCustomDoorEnter.d.ts

@@ -39,7 +39,7 @@ export declare function initCustomDoor(mod: ModUpgraded, effectVariant: EffectVa
  * The custom door is an `EntityEffect`. You can manually open or close the door by modifying its
  * state. (The values to use correspond to the `DoorState` enum.)
  *
- * This function will throw a runtime error if:
+ * This function will throw a run-time error if:
  * - the door slot already has a vanilla door
  * - the door slot already has a custom door
  * - the tile at the door slot does not have a wall

package/dist/callbacks/postCustomDoorEnter.lua

@@ -199,7 +199,7 @@ end
 -- The custom door is an `EntityEffect`. You can manually open or close the door by modifying its
 -- state. (The values to use correspond to the `DoorState` enum.)
 -- 
--- This function will throw a runtime error if:
+-- This function will throw a run-time error if:
 -- - the door slot already has a vanilla door
 -- - the door slot already has a custom door
 -- - the tile at the door slot does not have a wall

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

@@ -16,10 +16,6 @@ export declare enum SerializationBrand {
     /**
      * 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",
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"SerializationBrand.d.ts","sourceRoot":"","sources":["../../../src/enums/private/SerializationBrand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,kBAAkB;IAE5B,WAAW,uBAAuB;IAClC,GAAG,eAAe;IAClB,GAAG,eAAe;IAGlB,KAAK,YAAY;IACjB,OAAO,cAAc;IACrB,GAAG,UAAU;IACb,MAAM,aAAa;IAEnB;;;;;;;OAOG;IACH,iBAAiB,6BAA6B;IAE9C;;;;;;;;;;OAUG;IACH,uBAAuB,mCAAmC;CAC3D"}
+{"version":3,"file":"SerializationBrand.d.ts","sourceRoot":"","sources":["../../../src/enums/private/SerializationBrand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,kBAAkB;IAE5B,WAAW,uBAAuB;IAClC,GAAG,eAAe;IAClB,GAAG,eAAe;IAGlB,KAAK,YAAY;IACjB,OAAO,cAAc;IACrB,GAAG,UAAU;IACb,MAAM,aAAa;IAEnB;;;OAGG;IACH,iBAAiB,6BAA6B;IAE9C;;;;;;;;;;OAUG;IACH,uBAAuB,mCAAmC;CAC3D"}

package/dist/features/customStage/shadows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/shadows.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA0C3D,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAqCzD"}
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/shadows.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAoC3D,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAqCzD"}

package/dist/features/customStage/shadows.lua

@@ -35,8 +35,6 @@ local ROOM_SHAPE_TO_SHADOW_ANIMATION = {
     [RoomShape.LBR] = "2x2"
 }
 local FADED_BLACK = Color(0, 0, 0, 0.25)
-local shadowSprite = Sprite()
-shadowSprite:Load(ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/stage-shadow.anm2", true)
 function ____exports.setShadows(self, customStage)
     if customStage.shadows == nil then
         return

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":"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"}

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/deepCopy.d.ts

@@ -21,10 +21,13 @@ import { SerializationType } from "../enums/SerializationType";
  * - other Isaac API objects such as `EntityPtr` (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.
+ * @param serializationType Optional. Has 3 possible values. Can copy objects as-is, or can
+ *                          serialize objects to Lua tables, or can deserialize Lua tables to
+ *                          objects. Default is `SerializationType.NONE`.
+ * @param traversalDescription Optional. Used to track the current key that we are operating on.
+ *                             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.
  */
-export declare function deepCopy(value: unknown, serializationType?: SerializationType, traversalDescription?: string): unknown;
+export declare function deepCopy(value: unknown, serializationType?: SerializationType, traversalDescription?: string, insideMap?: boolean): unknown;
 //# sourceMappingURL=deepCopy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deepCopy.d.ts","sourceRoot":"","sources":["../../src/functions/deepCopy.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AA4B/D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,EACd,iBAAiB,oBAAyB,EAC1C,oBAAoB,SAAK,GACxB,OAAO,CA6CT"}
+{"version":3,"file":"deepCopy.d.ts","sourceRoot":"","sources":["../../src/functions/deepCopy.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AA4B/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,EACd,iBAAiB,oBAAyB,EAC1C,oBAAoB,SAAK,EACzB,SAAS,UAAQ,GAChB,OAAO,CAkDT"}

package/dist/functions/deepCopy.lua

@@ -66,17 +66,23 @@ local twoDimensionalSort = ____utils.twoDimensionalSort
 -- - other Isaac API objects such as `EntityPtr` (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.
-function ____exports.deepCopy(self, value, serializationType, traversalDescription)
+-- @param serializationType Optional. Has 3 possible values. Can copy objects as-is, or can
+-- serialize objects to Lua tables, or can deserialize Lua tables to
+-- objects. Default is `SerializationType.NONE`.
+-- @param traversalDescription Optional. Used to track the current key that we are operating on.
+-- 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(self, value, serializationType, traversalDescription, insideMap)
     if serializationType == nil then
         serializationType = SerializationType.NONE
     end
     if traversalDescription == nil then
         traversalDescription = ""
     end
+    if insideMap == nil then
+        insideMap = false
+    end
     if SAVE_DATA_MANAGER_DEBUG then
         local logString = "deepCopy is operating on: " .. traversalDescription
         if serializationType == SerializationType.SERIALIZE then
@@ -109,7 +115,13 @@ function ____exports.deepCopy(self, value, serializationType, traversalDescripti
         if ____cond6 then
             do
                 local luaTable = value
-                return deepCopyTable(nil, luaTable, serializationType, traversalDescription)
+                return deepCopyTable(
+                    nil,
+                    luaTable,
+                    serializationType,
+                    traversalDescription,
+                    insideMap
+                )
             end
         end
         ____cond6 = ____cond6 or ____switch6 == "userdata"
@@ -120,15 +132,33 @@ function ____exports.deepCopy(self, value, serializationType, traversalDescripti
         end
     until true
 end
-function deepCopyTable(self, luaTable, serializationType, traversalDescription)
+function deepCopyTable(self, luaTable, serializationType, traversalDescription, insideMap)
     if isDefaultMap(nil, luaTable) or luaTable[SerializationBrand.DEFAULT_MAP] ~= nil then
-        return deepCopyDefaultMap(nil, luaTable, serializationType, traversalDescription)
+        return deepCopyDefaultMap(
+            nil,
+            luaTable,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
     end
     if isTSTLMap(nil, luaTable) or luaTable[SerializationBrand.MAP] ~= nil then
-        return deepCopyMap(nil, luaTable, serializationType, traversalDescription)
+        return deepCopyMap(
+            nil,
+            luaTable,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
     end
     if isTSTLSet(nil, luaTable) or luaTable[SerializationBrand.SET] ~= nil then
-        return deepCopySet(nil, luaTable, serializationType, traversalDescription)
+        return deepCopySet(
+            nil,
+            luaTable,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
     end
     local className = getTSTLClassName(nil, luaTable)
     if className == "WeakMap" then
@@ -138,18 +168,36 @@ function deepCopyTable(self, luaTable, serializationType, traversalDescription)
         error("The deep copy function does not support copying the \"WeakSet\" class for: " .. traversalDescription)
     end
     if isUserDefinedTSTLClass(nil, luaTable) then
-        return deepCopyTSTLClass(nil, luaTable, serializationType, traversalDescription)
+        return deepCopyTSTLClass(
+            nil,
+            luaTable,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
     end
     checkMetatable(nil, luaTable, traversalDescription)
     if isSerializedIsaacAPIClass(nil, luaTable) and serializationType == SerializationType.DESERIALIZE then
         return deserializeIsaacAPIClass(nil, luaTable)
     end
     if isArray(nil, luaTable) then
-        return deepCopyArray(nil, luaTable, serializationType, traversalDescription)
-    end
-    return deepCopyNormalLuaTable(nil, luaTable, serializationType, traversalDescription)
+        return deepCopyArray(
+            nil,
+            luaTable,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
+    end
+    return deepCopyNormalLuaTable(
+        nil,
+        luaTable,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
 end
-function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescription)
+function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescription, insideMap)
     local ____isDefaultMap_result_0
     if isDefaultMap(nil, defaultMap) then
         ____isDefaultMap_result_0 = defaultMap:getConstructorArg()
@@ -158,7 +206,17 @@ function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescri
     end
     local constructorArg = ____isDefaultMap_result_0
     if serializationType == SerializationType.SERIALIZE and not isPrimitive(nil, constructorArg) then
-        return deepCopyMap(nil, defaultMap, serializationType, traversalDescription)
+        if insideMap then
+            error("Failed to deep copy a DefaultMap because it was instantiated with a factory function and was also inside of another map. You cannot use a nested DefaultMap in this way because factory functions are not serializable. (In other words, there is no way to copy the function that you are using for the DefaultMap into the \"save#.dat\" file.) Instead, refactor your data structure so that the DefaultMap is not nested.")
+        else
+            return deepCopyMap(
+                nil,
+                defaultMap,
+                serializationType,
+                traversalDescription,
+                insideMap
+            )
+        end
     end
     local newDefaultMap = getNewDefaultMap(
         nil,
@@ -167,7 +225,14 @@ function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescri
         traversalDescription,
         constructorArg
     )
-    local ____getCopiedEntries_result_1 = getCopiedEntries(nil, defaultMap, serializationType, traversalDescription)
+    insideMap = true
+    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
@@ -186,19 +251,20 @@ function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescri
             newDefaultMap[key] = value
         end
     end
+    insideMap = false
     return newDefaultMap
 end
 function getNewDefaultMap(self, defaultMap, serializationType, traversalDescription, constructorArg)
     repeat
-        local ____switch31 = serializationType
-        local ____cond31 = ____switch31 == SerializationType.NONE
-        if ____cond31 then
+        local ____switch33 = serializationType
+        local ____cond33 = ____switch33 == SerializationType.NONE
+        if ____cond33 then
             do
                 return __TS__New(DefaultMap, constructorArg)
             end
         end
-        ____cond31 = ____cond31 or ____switch31 == SerializationType.SERIALIZE
-        if ____cond31 then
+        ____cond33 = ____cond33 or ____switch33 == SerializationType.SERIALIZE
+        if ____cond33 then
             do
                 local newDefaultMap = {}
                 newDefaultMap[SerializationBrand.DEFAULT_MAP] = ""
@@ -206,8 +272,8 @@ function getNewDefaultMap(self, defaultMap, serializationType, traversalDescript
                 return newDefaultMap
             end
         end
-        ____cond31 = ____cond31 or ____switch31 == SerializationType.DESERIALIZE
-        if ____cond31 then
+        ____cond33 = ____cond33 or ____switch33 == SerializationType.DESERIALIZE
+        if ____cond33 then
             do
                 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.")
@@ -221,7 +287,7 @@ function getNewDefaultMap(self, defaultMap, serializationType, traversalDescript
         end
     until true
 end
-function deepCopyMap(self, map, serializationType, traversalDescription)
+function deepCopyMap(self, map, serializationType, traversalDescription, insideMap)
     local newMap
     if serializationType == SerializationType.SERIALIZE then
         newMap = {}
@@ -229,7 +295,14 @@ function deepCopyMap(self, map, serializationType, traversalDescription)
     else
         newMap = __TS__New(Map)
     end
-    local ____getCopiedEntries_result_2 = getCopiedEntries(nil, map, serializationType, traversalDescription)
+    insideMap = true
+    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
@@ -248,9 +321,10 @@ function deepCopyMap(self, map, serializationType, traversalDescription)
             newMap[key] = value
         end
     end
+    insideMap = false
     return newMap
 end
-function deepCopySet(self, set, serializationType, traversalDescription)
+function deepCopySet(self, set, serializationType, traversalDescription, insideMap)
     local newSet
     if serializationType == SerializationType.SERIALIZE then
         newSet = {}
@@ -258,7 +332,13 @@ function deepCopySet(self, set, serializationType, traversalDescription)
     else
         newSet = __TS__New(Set)
     end
-    local ____getCopiedEntries_result_3 = getCopiedEntries(nil, set, serializationType, traversalDescription)
+    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
@@ -278,14 +358,20 @@ function deepCopySet(self, set, serializationType, traversalDescription)
     end
     return newSet
 end
-function deepCopyTSTLClass(self, tstlClass, serializationType, traversalDescription)
+function deepCopyTSTLClass(self, tstlClass, serializationType, traversalDescription, insideMap)
     local newClass
     if serializationType == SerializationType.SERIALIZE then
         newClass = {}
     else
         newClass = newTSTLClass(nil, tstlClass)
     end
-    local ____getCopiedEntries_result_4 = getCopiedEntries(nil, tstlClass, serializationType, traversalDescription)
+    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
@@ -298,17 +384,29 @@ function deepCopyTSTLClass(self, tstlClass, serializationType, traversalDescript
     end
     return newClass
 end
-function deepCopyArray(self, array, serializationType, traversalDescription)
+function deepCopyArray(self, array, serializationType, traversalDescription, insideMap)
     local newArray = {}
     for ____, value in ipairs(array) do
-        local newValue = ____exports.deepCopy(nil, value, serializationType, traversalDescription)
+        local newValue = ____exports.deepCopy(
+            nil,
+            value,
+            serializationType,
+            traversalDescription,
+            insideMap
+        )
         newArray[#newArray + 1] = newValue
     end
     return newArray
 end
-function deepCopyNormalLuaTable(self, luaTable, serializationType, traversalDescription)
+function deepCopyNormalLuaTable(self, luaTable, serializationType, traversalDescription, insideMap)
     local newTable = {}
-    local ____getCopiedEntries_result_5 = getCopiedEntries(nil, luaTable, serializationType, traversalDescription)
+    local ____getCopiedEntries_result_5 = getCopiedEntries(
+        nil,
+        luaTable,
+        serializationType,
+        traversalDescription,
+        insideMap
+    )
     local entries = ____getCopiedEntries_result_5.entries
     local convertedNumberKeysToStrings = ____getCopiedEntries_result_5.convertedNumberKeysToStrings
     if convertedNumberKeysToStrings then
@@ -321,7 +419,7 @@ function deepCopyNormalLuaTable(self, luaTable, serializationType, traversalDesc
     end
     return newTable
 end
-function getCopiedEntries(self, object, serializationType, traversalDescription)
+function getCopiedEntries(self, object, serializationType, traversalDescription, insideMap)
     local entries = {}
     if isTSTLMap(nil, object) or isTSTLSet(nil, object) or isDefaultMap(nil, object) then
         for ____, ____value in __TS__Iterator(object:entries()) do
@@ -353,14 +451,20 @@ function getCopiedEntries(self, object, serializationType, traversalDescription)
         local value = ____value[2]
         do
             if isSerializationBrand(nil, key) then
-                goto __continue78
+                goto __continue80
             end
             traversalDescription = getTraversalDescription(nil, key, traversalDescription)
-            local newValue = ____exports.deepCopy(nil, value, serializationType, traversalDescription)
+            local newValue = ____exports.deepCopy(
+                nil,
+                value,
+                serializationType,
+                traversalDescription,
+                insideMap
+            )
             local keyToUse = convertNumberKeysToStrings and tostring(key) or key
             copiedEntries[#copiedEntries + 1] = {keyToUse, newValue}
         end
-        ::__continue78::
+        ::__continue80::
     end
     return {entries = copiedEntries, convertedNumberKeysToStrings = convertNumberKeysToStrings}
 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

@@ -64,7 +64,7 @@ export declare function logSounds(this: void): void;
  * recursively call itself if it counters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
- * instead of randomly). It will throw a runtime error if it encounters a non-string key.
+ * instead of randomly). It will throw a run-time error if it encounters a non-string key.
  */
 export declare function logTable(this: void, luaTable: unknown, parentTables?: number): void;
 /**