isaacscript-common 6.6.2 → 6.6.5

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

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/functions/log.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/functions/log.ts"],"names":[],"mappings":"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"}

package/dist/functions/log.lua

@@ -464,7 +464,7 @@ end
 -- 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.
 function ____exports.logTable(luaTable, parentTables)
     if parentTables == nil then
         parentTables = 0
@@ -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/dist/functions/playerIndex.d.ts

@@ -39,6 +39,10 @@ export declare function getPlayerFromIndex(playerIndex: PlayerIndex): EntityPlay
  * though they are technically different characters, they share the same inventory and InitSeed.) If
  * this is not desired, pass true for the `differentiateForgottenAndSoul` argument, and the RNG of
  * Spoon Bender (3) will be used for The Soul.
+ *
+ * Also note that this index doesn't work in the `POST_PLAYER_INIT` function for players 2 through
+ * 4. With that said, in almost all cases, you should be lazy-initializing your data structures in
+ * other callbacks, so this should not be an issue.
  */
 export declare function getPlayerIndex(player: EntityPlayer, differentiateForgottenAndSoul?: boolean): PlayerIndex;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"playerIndex.d.ts","sourceRoot":"","sources":["../../src/functions/playerIndex.ts"],"names":[],"mappings":";;;AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASnD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAU9C;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,GACvB,YAAY,GAAG,SAAS,CAG1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,6BAA6B,UAAQ,GACpC,WAAW,CA4Bb;AA2BD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,GACzB,GAAG,GAAG,SAAS,CAajB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,0BAA0B,UAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,GACzB,YAAY,GAAG,SAAS,CAa1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"playerIndex.d.ts","sourceRoot":"","sources":["../../src/functions/playerIndex.ts"],"names":[],"mappings":";;;AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASnD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAU9C;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,GACvB,YAAY,GAAG,SAAS,CAG1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,6BAA6B,UAAQ,GACpC,WAAW,CA4Bb;AA2BD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,GACzB,GAAG,GAAG,SAAS,CAajB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,0BAA0B,UAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,GACzB,YAAY,GAAG,SAAS,CAa1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE3D"}

package/dist/functions/playerIndex.lua

@@ -55,6 +55,10 @@ end
 -- though they are technically different characters, they share the same inventory and InitSeed.) If
 -- this is not desired, pass true for the `differentiateForgottenAndSoul` argument, and the RNG of
 -- Spoon Bender (3) will be used for The Soul.
+-- 
+-- Also note that this index doesn't work in the `POST_PLAYER_INIT` function for players 2 through
+-- 4. With that said, in almost all cases, you should be lazy-initializing your data structures in
+-- other callbacks, so this should not be an issue.
 function ____exports.getPlayerIndex(self, player, differentiateForgottenAndSoul)
     if differentiateForgottenAndSoul == nil then
         differentiateForgottenAndSoul = false

package/dist/functions/table.d.ts

@@ -34,7 +34,7 @@ export declare function getStringsFromTable(luaTable: LuaTable<string, unknown>,
  * This function will sort the table entries based on the value of the key.
  *
  * This function will only work on tables that have number keys or string keys. It will throw a
- * runtime error if it encounters a key of another type.
+ * run-time error if it encounters a key of another type.
  *
  * @param luaTable The table to iterate over.
  * @param func The function to run for each iteration.

package/dist/functions/table.lua

@@ -96,7 +96,7 @@ end
 -- This function will sort the table entries based on the value of the key.
 -- 
 -- This function will only work on tables that have number keys or string keys. It will throw a
--- runtime error if it encounters a key of another type.
+-- run-time error if it encounters a key of another type.
 -- 
 -- @param luaTable The table to iterate over.
 -- @param func The function to run for each iteration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "6.6.2",
+  "version": "6.6.5",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "dist/index",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^3.0.26"
+    "isaac-typescript-definitions": "^3.0.27"
   }
 }

package/src/callbacks/postCursedTeleport.ts

@@ -119,7 +119,7 @@ function incrementNumSacrifices(damageFlags: BitFlags<DamageFlag>) {
   const isSpikeDamage = hasFlag(damageFlags, DamageFlag.SPIKES);
 
   if (roomType === RoomType.SACRIFICE && isSpikeDamage) {
-    v.level.numSacrifices += 1;
+    v.level.numSacrifices++;
   }
 }
 

package/src/callbacks/postCustomDoorEnter.ts

@@ -219,7 +219,7 @@ function postRoomClearChanged(
  * 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/src/callbacks/postPlayerCollectible.ts

@@ -102,7 +102,7 @@ function collectibleCountChanged(
       } else {
         postPlayerCollectibleRemovedFire(player, collectibleType);
       }
-      numFired += 1;
+      numFired++;
     });
 
     if (numFired === numCollectiblesChanged) {

package/src/callbacks/postSacrifice.ts

@@ -56,7 +56,7 @@ function entityTakeDmgPlayer(
   const isSpikeDamage = hasFlag(damageFlags, DamageFlag.SPIKES);
 
   if (roomType === RoomType.SACRIFICE && isSpikeDamage) {
-    v.level.numSacrifices += 1;
+    v.level.numSacrifices++;
     postSacrificeFire(player, v.level.numSacrifices);
   }
 

package/src/enums/private/SerializationBrand.ts

@@ -20,10 +20,6 @@ export 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/src/features/customStage/shadows.ts

@@ -38,12 +38,6 @@ const ROOM_SHAPE_TO_SHADOW_ANIMATION: {
 
 const FADED_BLACK = Color(0, 0, 0, 0.25);
 
-const shadowSprite = Sprite();
-shadowSprite.Load(
-  `${ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH}/stage-shadow.anm2`,
-  true,
-);
-
 export function setShadows(customStage: CustomStage): void {
   if (customStage.shadows === undefined) {
     return;

package/src/features/extraConsoleCommands/listCommands.ts

@@ -337,7 +337,7 @@ export function cards(): void {
 
       const position = gridCoordinatesToWorldPosition(x, y);
       spawnCard(cardType as Card, position);
-      cardType += 1;
+      cardType++;
     }
   }
 }
@@ -647,7 +647,7 @@ export function gridEntities(): void {
   let gridEntityTypeIndex = -1;
   for (let y = 0; y <= 6; y++) {
     for (let x = 0; x <= 12; x++) {
-      gridEntityTypeIndex += 1;
+      gridEntityTypeIndex++;
       const gridEntityType = gridEntityTypes[gridEntityTypeIndex];
       if (gridEntityType === undefined) {
         return;
@@ -884,7 +884,7 @@ export function pills(): void {
   let pillColorIndex = -1;
   for (let y = 0; y <= 6; y++) {
     for (let x = 0; x <= 12; x++) {
-      pillColorIndex += 1;
+      pillColorIndex++;
       const pillColor = pillColors[pillColorIndex];
       if (pillColor === undefined) {
         return;

package/src/features/persistentEntities.ts

@@ -123,7 +123,7 @@ export function spawnPersistentEntity(
 ): [Entity, int] {
   errorIfFeaturesNotInitialized(FEATURE_NAME);
 
-  persistentEntityIndexCounter += 1;
+  persistentEntityIndexCounter++;
 
   const entity = spawnAndTrack(
     entityType,

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;
   }
@@ -524,7 +527,7 @@ export function shuffleArrayInPlace<T>(
   const rng = isRNG(seedOrRNG) ? seedOrRNG : newRNG(seedOrRNG);
 
   while (currentIndex > 0) {
-    currentIndex -= 1;
+    currentIndex--;
 
     const randomIndex = getRandomArrayIndex(array, rng);
     swapArrayElements(array, currentIndex, randomIndex);

package/src/functions/bitwise.ts

@@ -57,7 +57,7 @@ export function countSetBits(n: int): int {
 
   while (n > 0) {
     n &= n - 1;
-    count += 1;
+    count++;
   }
 
   return count;
@@ -72,7 +72,7 @@ export function getKBitOfN(k: int, n: int): int {
 export function getNumBitsOfN(n: int): int {
   let numBits = 0;
   while (n > 0) {
-    numBits += 1;
+    numBits++;
     n >>>= 1;
   }