isaacscript-common 11.0.0 → 11.0.1

package/dist/index.d.ts

@@ -6447,10 +6447,10 @@ 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 frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -6460,10 +6460,10 @@ 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 frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 11.0.0
+isaacscript-common 11.0.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -39252,39 +39252,39 @@ 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 frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local familiar = tear.Parent:ToFamiliar()
+    local familiar = tear.SpawnerEntity: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 frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local player = tear.Parent:ToPlayer()
+    local player = tear.SpawnerEntity:ToPlayer()
     return player ~= nil
 end
 return ____exports
@@ -46950,7 +46950,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "11.0.0",
+    version = "11.0.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 = "11.0.0",
+    version = "11.0.1",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

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

@@ -27,10 +27,10 @@ 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 frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -39,10 +39,10 @@ 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 frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */

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;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAc5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAc1D"}
+{"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,CAgB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}

package/dist/src/functions/tears.lua

@@ -27,39 +27,39 @@ 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 frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local familiar = tear.Parent:ToFamiliar()
+    local familiar = tear.SpawnerEntity: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 frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local player = tear.Parent:ToPlayer()
+    local player = tear.SpawnerEntity:ToPlayer()
     return player ~= nil
 end
 return ____exports

package/package.json

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

package/src/functions/tears.ts

@@ -36,10 +36,10 @@ export 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 frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -50,12 +50,14 @@ export function isTearFromFamiliar(tear: EntityTear): boolean {
     );
   }
 
-  // Normally, all tears have a parent, which is either the player or the familiar.
-  if (tear.Parent === undefined) {
+  // Normally, all tears have a spawner entity, which is either the player or the familiar.
+  if (tear.SpawnerEntity === undefined) {
     return false;
   }
 
-  const familiar = tear.Parent.ToFamiliar();
+  // We cannot use `tear.SpawnerType` to determine this, since it is baked in to be equal to
+  // `EntityType.PLAYER` regardless of whether the tear is from a player or familiar.
+  const familiar = tear.SpawnerEntity.ToFamiliar();
   return familiar !== undefined;
 }
 
@@ -63,10 +65,10 @@ export 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 frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -77,11 +79,13 @@ export function isTearFromPlayer(tear: EntityTear): boolean {
     );
   }
 
-  // Normally, all tears have a parent, which is either the player or the familiar.
-  if (tear.Parent === undefined) {
+  // Normally, all tears have a spawner entity, which is either the player or the familiar.
+  if (tear.SpawnerEntity === undefined) {
     return false;
   }
 
-  const player = tear.Parent.ToPlayer();
+  // We cannot use `tear.SpawnerType` to determine this, since it is baked in to be equal to
+  // `EntityType.PLAYER` regardless of whether the tear is from a player or familiar.
+  const player = tear.SpawnerEntity.ToPlayer();
   return player !== undefined;
 }