isaacscript-common 10.1.1 → 10.2.1

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.1
+isaacscript-common 10.2.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -26070,7 +26070,6 @@ local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local ControllerIndex = ____isaac_2Dtypescript_2Ddefinitions.ControllerIndex
-local FamiliarVariant = ____isaac_2Dtypescript_2Ddefinitions.FamiliarVariant
 local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
 local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
@@ -26309,7 +26308,7 @@ function ____exports.getPlayerFromTear(self, entity)
             return player
         end
         local familiar = entity.Parent:ToFamiliar()
-        if familiar ~= nil and familiar.Variant == FamiliarVariant.INCUBUS then
+        if familiar ~= nil then
             return familiar.Player
         end
     end
@@ -26319,7 +26318,7 @@ function ____exports.getPlayerFromTear(self, entity)
             return player
         end
         local familiar = entity.SpawnerEntity:ToFamiliar()
-        if familiar ~= nil and familiar.Variant == FamiliarVariant.INCUBUS then
+        if familiar ~= nil then
             return familiar.Player
         end
     end
@@ -39247,6 +39246,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 +46947,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "10.1.1",
+    version = "10.2.1",
     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.1",
+    version = "10.2.1",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

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

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

package/dist/src/functions/players.lua

@@ -14,7 +14,6 @@ local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local ControllerIndex = ____isaac_2Dtypescript_2Ddefinitions.ControllerIndex
-local FamiliarVariant = ____isaac_2Dtypescript_2Ddefinitions.FamiliarVariant
 local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
 local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
@@ -253,7 +252,7 @@ function ____exports.getPlayerFromTear(self, entity)
             return player
         end
         local familiar = entity.Parent:ToFamiliar()
-        if familiar ~= nil and familiar.Variant == FamiliarVariant.INCUBUS then
+        if familiar ~= nil then
             return familiar.Player
         end
     end
@@ -263,7 +262,7 @@ function ____exports.getPlayerFromTear(self, entity)
             return player
         end
         local familiar = entity.SpawnerEntity:ToFamiliar()
-        if familiar ~= nil and familiar.Variant == FamiliarVariant.INCUBUS then
+        if familiar ~= nil then
             return familiar.Player
         end
     end

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.1",
+  "version": "10.2.1",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/functions/players.ts

@@ -3,7 +3,6 @@ import {
   Challenge,
   CollectibleType,
   ControllerIndex,
-  FamiliarVariant,
   NullItemID,
   PlayerForm,
   PlayerType,
@@ -274,10 +273,7 @@ export function getPlayerFromTear(entity: Entity): EntityPlayer | undefined {
     }
 
     const familiar = entity.Parent.ToFamiliar();
-    if (
-      familiar !== undefined &&
-      familiar.Variant === FamiliarVariant.INCUBUS
-    ) {
+    if (familiar !== undefined) {
       return familiar.Player;
     }
   }
@@ -289,10 +285,7 @@ export function getPlayerFromTear(entity: Entity): EntityPlayer | undefined {
     }
 
     const familiar = entity.SpawnerEntity.ToFamiliar();
-    if (
-      familiar !== undefined &&
-      familiar.Variant === FamiliarVariant.INCUBUS
-    ) {
+    if (familiar !== undefined) {
       return familiar.Player;
     }
   }

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;
+}