isaacscript-common 10.1.0 → 10.2.0

package/dist/index.d.ts

@@ -6438,6 +6438,32 @@ export declare function isTarotCard(cardType: CardType): boolean;
 /** Helper function to detect if a variable is of type `EntityTear`. */
 export declare function isTear(variable: unknown): variable is EntityTear;
 
+/**
+ * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
+ * is determined by looking at the parent.
+ *
+ * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+ * player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+ * and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+ * callback or on frame 2+.
+ *
+ * If this function is called on frame 0 or frame 1, it will throw a run-time error.
+ */
+export declare function isTearFromFamiliar(tear: EntityTear): boolean;
+
+/**
+ * Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
+ * is determined by looking at the parent.
+ *
+ * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+ * player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+ * and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+ * callback or on frame 2+.
+ *
+ * If this function is called on frame 0 or frame 1, it will throw a run-time error.
+ */
+export declare function isTearFromPlayer(tear: EntityTear): boolean;
+
 /** Helper function to detect if a variable is of type `GridEntityTNT`. */
 export declare function isTNT(variable: unknown): variable is GridEntityTNT;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 10.1.0
+isaacscript-common 10.2.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -22575,7 +22575,7 @@ function ____exports.getUnusedDoorSlots(self)
     local doorSlots = getEnumValues(nil, DoorSlot)
     return __TS__ArrayFilter(
         doorSlots,
-        function(____, doorSlot) return room:IsDoorSlotAllowed(doorSlot) and room:GetDoor(doorSlot) == nil end
+        function(____, doorSlot) return doorSlot ~= DoorSlot.NO_DOOR_SLOT and room:IsDoorSlotAllowed(doorSlot) and room:GetDoor(doorSlot) == nil end
     )
 end
 --- Helper function to check if the current room has one or more open door slots that can be used to
@@ -39247,6 +39247,44 @@ function ____exports.addTearsStat(self, player, tearsStat)
     local newMaxFireDelay = ____exports.getFireDelay(nil, newTearsStat)
     player.MaxFireDelay = newMaxFireDelay
 end
+--- Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
+-- is determined by looking at the parent.
+-- 
+-- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+-- player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+-- and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+-- callback or on frame 2+.
+-- 
+-- If this function is called on frame 0 or frame 1, it will throw a run-time error.
+function ____exports.isTearFromFamiliar(self, tear)
+    if tear.FrameCount == 0 or tear.FrameCount == 1 then
+        error(("Failed to check if the given tear was from a player since the tear's frame count was equal to " .. tostring(tear.FrameCount)) .. ". (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 2 and onwards.)")
+    end
+    if tear.Parent == nil then
+        return false
+    end
+    local familiar = tear.Parent:ToFamiliar()
+    return familiar ~= nil
+end
+--- Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
+-- is determined by looking at the parent.
+-- 
+-- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+-- player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+-- and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+-- callback or on frame 2+.
+-- 
+-- If this function is called on frame 0 or frame 1, it will throw a run-time error.
+function ____exports.isTearFromPlayer(self, tear)
+    if tear.FrameCount == 0 or tear.FrameCount == 1 then
+        error(("Failed to check if the given tear was from a player since the tear's frame count was equal to " .. tostring(tear.FrameCount)) .. ". (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 2 and onwards.)")
+    end
+    if tear.Parent == nil then
+        return false
+    end
+    local player = tear.Parent:ToPlayer()
+    return player ~= nil
+end
 return ____exports
  end,
 ["src.maps.defaultPlayerStatMap"] = function(...) 
@@ -46910,7 +46948,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "10.1.0",
+    version = "10.2.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/package.lua

@@ -1,6 +1,6 @@
 return {
     name = "isaacscript-common",
-    version = "10.1.0",
+    version = "10.2.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/src/functions/doors.d.ts.map

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

package/dist/src/functions/doors.lua

@@ -270,7 +270,7 @@ function ____exports.getUnusedDoorSlots(self)
     local doorSlots = getEnumValues(nil, DoorSlot)
     return __TS__ArrayFilter(
         doorSlots,
-        function(____, doorSlot) return room:IsDoorSlotAllowed(doorSlot) and room:GetDoor(doorSlot) == nil end
+        function(____, doorSlot) return doorSlot ~= DoorSlot.NO_DOOR_SLOT and room:IsDoorSlotAllowed(doorSlot) and room:GetDoor(doorSlot) == nil end
     )
 end
 --- Helper function to check if the current room has one or more open door slots that can be used to

package/dist/src/functions/tears.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 /**
  * - Converts the specified amount of tears stat into the format of `EntityPlayer.MaxFireDelay` and
  *   adds it to the player.
@@ -22,4 +23,28 @@ export declare function getFireDelay(tearsStat: float): float;
  *   this function.
  */
 export declare function getTearsStat(fireDelay: float): float;
+/**
+ * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
+ * is determined by looking at the parent.
+ *
+ * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+ * player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+ * and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+ * callback or on frame 2+.
+ *
+ * If this function is called on frame 0 or frame 1, it will throw a run-time error.
+ */
+export declare function isTearFromFamiliar(tear: EntityTear): boolean;
+/**
+ * Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
+ * is determined by looking at the parent.
+ *
+ * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+ * player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+ * and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+ * callback or on frame 2+.
+ *
+ * If this function is called on frame 0 or frame 1, it will throw a run-time error.
+ */
+export declare function isTearFromPlayer(tear: EntityTear): boolean;
 //# sourceMappingURL=tears.d.ts.map

package/dist/src/functions/tears.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD"}
+{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAc5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAc1D"}

package/dist/src/functions/tears.lua

@@ -24,4 +24,42 @@ function ____exports.addTearsStat(self, player, tearsStat)
     local newMaxFireDelay = ____exports.getFireDelay(nil, newTearsStat)
     player.MaxFireDelay = newMaxFireDelay
 end
+--- Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
+-- is determined by looking at the parent.
+-- 
+-- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+-- player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+-- and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+-- callback or on frame 2+.
+-- 
+-- If this function is called on frame 0 or frame 1, it will throw a run-time error.
+function ____exports.isTearFromFamiliar(self, tear)
+    if tear.FrameCount == 0 or tear.FrameCount == 1 then
+        error(("Failed to check if the given tear was from a player since the tear's frame count was equal to " .. tostring(tear.FrameCount)) .. ". (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 2 and onwards.)")
+    end
+    if tear.Parent == nil then
+        return false
+    end
+    local familiar = tear.Parent:ToFamiliar()
+    return familiar ~= nil
+end
+--- Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
+-- is determined by looking at the parent.
+-- 
+-- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+-- player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+-- and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+-- callback or on frame 2+.
+-- 
+-- If this function is called on frame 0 or frame 1, it will throw a run-time error.
+function ____exports.isTearFromPlayer(self, tear)
+    if tear.FrameCount == 0 or tear.FrameCount == 1 then
+        error(("Failed to check if the given tear was from a player since the tear's frame count was equal to " .. tostring(tear.FrameCount)) .. ". (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 2 and onwards.)")
+    end
+    if tear.Parent == nil then
+        return false
+    end
+    local player = tear.Parent:ToPlayer()
+    return player ~= nil
+end
 return ____exports

package/package.json

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

package/src/functions/doors.ts

@@ -268,7 +268,10 @@ export function getUnusedDoorSlots(): DoorSlot[] {
   const doorSlots = getEnumValues(DoorSlot);
   return doorSlots.filter(
     (doorSlot) =>
-      room.IsDoorSlotAllowed(doorSlot) && room.GetDoor(doorSlot) === undefined,
+      // We need to filter out the -1 value to prevent crashes.
+      doorSlot !== DoorSlot.NO_DOOR_SLOT &&
+      room.IsDoorSlotAllowed(doorSlot) &&
+      room.GetDoor(doorSlot) === undefined,
   );
 }
 

package/src/functions/tears.ts

@@ -31,3 +31,57 @@ export function getFireDelay(tearsStat: float): float {
 export function getTearsStat(fireDelay: float): float {
   return 30 / (fireDelay + 1);
 }
+
+/**
+ * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
+ * is determined by looking at the parent.
+ *
+ * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+ * player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+ * and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+ * callback or on frame 2+.
+ *
+ * If this function is called on frame 0 or frame 1, it will throw a run-time error.
+ */
+export function isTearFromFamiliar(tear: EntityTear): boolean {
+  if (tear.FrameCount === 0 || tear.FrameCount === 1) {
+    error(
+      `Failed to check if the given tear was from a player since the tear's frame count was equal to ${tear.FrameCount}. (The "isTearFromFamiliar" function must only be used in the "POST_TEAR_INIT_VERY_LATE" callback or on frame 2 and onwards.)`,
+    );
+  }
+
+  // Normally, all tears have a parent, which is either the player or the familiar.
+  if (tear.Parent === undefined) {
+    return false;
+  }
+
+  const familiar = tear.Parent.ToFamiliar();
+  return familiar !== undefined;
+}
+
+/**
+ * Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
+ * is determined by looking at the parent.
+ *
+ * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
+ * player. The parent of the tear is the player on frames 0 and 1 and it is the familiar on frames 2
+ * and onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
+ * callback or on frame 2+.
+ *
+ * If this function is called on frame 0 or frame 1, it will throw a run-time error.
+ */
+export function isTearFromPlayer(tear: EntityTear): boolean {
+  if (tear.FrameCount === 0 || tear.FrameCount === 1) {
+    error(
+      `Failed to check if the given tear was from a player since the tear's frame count was equal to ${tear.FrameCount}. (The "isTearFromPlayer" function must only be used in the "POST_TEAR_INIT_VERY_LATE" callback or on frame 2 and onwards.)`,
+    );
+  }
+
+  // Normally, all tears have a parent, which is either the player or the familiar.
+  if (tear.Parent === undefined) {
+    return false;
+  }
+
+  const player = tear.Parent.ToPlayer();
+  return player !== undefined;
+}