isaacscript-common 24.0.0 → 24.1.1

package/dist/index.rollup.d.ts

@@ -6465,8 +6465,12 @@ export declare function getScreenBottomLeftPos(): Readonly<Vector>;
 
 export declare function getScreenBottomRightPos(): Readonly<Vector>;
 
+export declare function getScreenBottomY(): float;
+
 export declare function getScreenCenterPos(): Readonly<Vector>;
 
+export declare function getScreenRightX(): float;
+
 export declare function getScreenTopCenterPos(): Readonly<Vector>;
 
 export declare function getScreenTopLeftPos(): Readonly<Vector>;
@@ -12026,9 +12030,8 @@ export declare const NUM_VANILLA_CARD_TYPES: number;
 export declare const NUM_VANILLA_COLLECTIBLE_TYPES: number;
 
 /**
- * Calculated from the `PillEffect` enum.
- *
- * (There is no `PillEffect.NULL` in the custom enum, so we do not have to subtract one here.)
+ * Calculated from the `PillEffect` enum. (There is no `PillEffect.NULL` in the custom enum, so we
+ * do not have to subtract one here.)
  */
 export declare const NUM_VANILLA_PILL_EFFECTS: number;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 24.0.0
+isaacscript-common 24.1.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -17314,6 +17314,8 @@ local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____enums = require("src.functions.enums")
 local getEnumLength = ____enums.getEnumLength
 local getLastEnumValue = ____enums.getLastEnumValue
+local ____utils = require("src.functions.utils")
+local iRange = ____utils.iRange
 ____exports.FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION
 ____exports.LAST_VANILLA_COLLECTIBLE_TYPE = getLastEnumValue(nil, CollectibleType)
 ____exports.NUM_VANILLA_COLLECTIBLE_TYPES = getEnumLength(nil, CollectibleType) - 1
@@ -17330,7 +17332,7 @@ ____exports.FIRST_PILL_COLOR = PillColor.BLUE_BLUE
 ____exports.LAST_NORMAL_PILL_COLOR = PillColor.WHITE_YELLOW
 ____exports.FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE
 ____exports.LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW
-____exports.NUM_NORMAL_PILL_COLORS = ____exports.LAST_NORMAL_PILL_COLOR - ____exports.FIRST_PILL_COLOR
+____exports.NUM_NORMAL_PILL_COLORS = #iRange(nil, ____exports.FIRST_PILL_COLOR, ____exports.LAST_NORMAL_PILL_COLOR)
 ____exports.FIRST_CHARACTER = PlayerType.ISAAC
 ____exports.LAST_VANILLA_CHARACTER = getLastEnumValue(nil, PlayerType)
 ____exports.FIRST_ROOM_TYPE = RoomType.DEFAULT
@@ -40587,27 +40589,35 @@ function ____exports.getHeartsUIWidth(self)
     return width
 end
 function ____exports.getScreenBottomCenterPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(bottomRight.X / 2, bottomRight.Y)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRightPos.X / 2, bottomRightPos.Y)
 end
 function ____exports.getScreenBottomLeftPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(0, bottomRight.Y)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(0, bottomRightPos.Y)
+end
+function ____exports.getScreenBottomY(self)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return bottomRightPos.Y
 end
 function ____exports.getScreenCenterPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return bottomRight / 2
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return bottomRightPos / 2
+end
+function ____exports.getScreenRightX(self)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return bottomRightPos.X
 end
 function ____exports.getScreenTopCenterPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(bottomRight.X / 2, 0)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRightPos.X / 2, 0)
 end
 function ____exports.getScreenTopLeftPos(self)
     return copyVector(nil, VectorZero)
 end
 function ____exports.getScreenTopRightPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(bottomRight.X, 0)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRightPos.X, 0)
 end
 function ____exports.getVisibleHearts(self, player)
     local effectiveMaxHearts = player:GetEffectiveMaxHearts()

package/dist/src/core/constantsFirstLast.d.ts

@@ -27,9 +27,8 @@ export declare const FIRST_PILL_EFFECT = PillEffect.BAD_GAS;
 /** Calculated from the `PillEffect` enum. */
 export declare const LAST_VANILLA_PILL_EFFECT: PillEffect;
 /**
- * Calculated from the `PillEffect` enum.
- *
- * (There is no `PillEffect.NULL` in the custom enum, so we do not have to subtract one here.)
+ * Calculated from the `PillEffect` enum. (There is no `PillEffect.NULL` in the custom enum, so we
+ * do not have to subtract one here.)
  */
 export declare const NUM_VANILLA_PILL_EFFECTS: number;
 /** Equal to `PillColor.BLUE_BLUE`. */

package/dist/src/core/constantsFirstLast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constantsFirstLast.d.ts","sourceRoot":"","sources":["../../../src/core/constantsFirstLast.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,UAAU,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAOtC,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,iBAAoC,CAAC;AAE/E,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAAqC,CAAC;AAMhF,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,aAAgC,CAAC;AAEvE,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,QAAiC,CAAC;AAMxE,4BAA4B;AAC5B,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,UAA6B,CAAC;AAEjE,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAMlE,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,YAA+B,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAA4B,CAAC;AAMlE,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAElE,eAAO,MAAM,sBAAsB,QAA4C,CAAC;AAMhF,mCAAmC;AACnC,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAIhD,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,YAA+B,CAAC;AAMnE,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,cAAc,UAA6B,CAAC;AAMzD,eAAO,MAAM,WAAW,wBAAwB,CAAC;AACjD,eAAO,MAAM,UAAU,YAA+B,CAAC"}
+{"version":3,"file":"constantsFirstLast.d.ts","sourceRoot":"","sources":["../../../src/core/constantsFirstLast.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,UAAU,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAQtC,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,iBAAoC,CAAC;AAE/E,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAAqC,CAAC;AAMhF,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,aAAgC,CAAC;AAEvE,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,QAAiC,CAAC;AAMxE,4BAA4B;AAC5B,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,UAA6B,CAAC;AAEjE,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAMlE,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,YAA+B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAA4B,CAAC;AAMlE,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAElE,eAAO,MAAM,sBAAsB,QAG3B,CAAC;AAMT,mCAAmC;AACnC,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAIhD,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,YAA+B,CAAC;AAMnE,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,cAAc,UAA6B,CAAC;AAMzD,eAAO,MAAM,WAAW,wBAAwB,CAAC;AACjD,eAAO,MAAM,UAAU,YAA+B,CAAC"}

package/dist/src/core/constantsFirstLast.lua

@@ -11,6 +11,8 @@ local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____enums = require("src.functions.enums")
 local getEnumLength = ____enums.getEnumLength
 local getLastEnumValue = ____enums.getLastEnumValue
+local ____utils = require("src.functions.utils")
+local iRange = ____utils.iRange
 --- Equal to `CollectibleType.SAD_ONION`.
 ____exports.FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION
 --- Calculated from the `CollectibleType` enum.
@@ -36,9 +38,8 @@ ____exports.NUM_VANILLA_CARD_TYPES = getEnumLength(nil, CardType) - 1
 ____exports.FIRST_PILL_EFFECT = PillEffect.BAD_GAS
 --- Calculated from the `PillEffect` enum.
 ____exports.LAST_VANILLA_PILL_EFFECT = getLastEnumValue(nil, PillEffect)
---- Calculated from the `PillEffect` enum.
--- 
--- (There is no `PillEffect.NULL` in the custom enum, so we do not have to subtract one here.)
+--- Calculated from the `PillEffect` enum. (There is no `PillEffect.NULL` in the custom enum, so we
+-- do not have to subtract one here.)
 ____exports.NUM_VANILLA_PILL_EFFECTS = getEnumLength(nil, PillEffect)
 --- Equal to `PillColor.BLUE_BLUE`.
 ____exports.FIRST_PILL_COLOR = PillColor.BLUE_BLUE
@@ -54,7 +55,7 @@ ____exports.FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE
 -- Note that `PillColor.HORSE_GOLD` is technically higher, but that is not considered for the
 -- purposes of this constant.
 ____exports.LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW
-____exports.NUM_NORMAL_PILL_COLORS = ____exports.LAST_NORMAL_PILL_COLOR - ____exports.FIRST_PILL_COLOR
+____exports.NUM_NORMAL_PILL_COLORS = #iRange(nil, ____exports.FIRST_PILL_COLOR, ____exports.LAST_NORMAL_PILL_COLOR)
 --- Equal to `PlayerType.ISAAC`.
 ____exports.FIRST_CHARACTER = PlayerType.ISAAC
 --- Calculated from the `PlayerType` enum.

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

@@ -26,7 +26,9 @@ export declare function getHeartsUIWidth(): int;
 export declare function getScreenBottomCenterPos(): Readonly<Vector>;
 export declare function getScreenBottomLeftPos(): Readonly<Vector>;
 export declare function getScreenBottomRightPos(): Readonly<Vector>;
+export declare function getScreenBottomY(): float;
 export declare function getScreenCenterPos(): Readonly<Vector>;
+export declare function getScreenRightX(): float;
 export declare function getScreenTopCenterPos(): Readonly<Vector>;
 export declare function getScreenTopLeftPos(): Readonly<Vector>;
 export declare function getScreenTopRightPos(): Readonly<Vector>;

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

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/functions/ui.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAmBrD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAU3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAgCtC;AAED,wBAAgB,wBAAwB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAG3D;AAED,wBAAgB,sBAAsB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGzD;AAED,wBAAgB,uBAAuB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAK1D;AAED,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGrD;AAED,wBAAgB,qBAAqB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGxD;AAED,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAEtD;AAED,wBAAgB,oBAAoB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAa1D"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/functions/ui.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAmBrD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAU3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAgCtC;AAED,wBAAgB,wBAAwB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAG3D;AAED,wBAAgB,sBAAsB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGzD;AAED,wBAAgB,uBAAuB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAK1D;AAED,wBAAgB,gBAAgB,IAAI,KAAK,CAGxC;AAED,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGrD;AAED,wBAAgB,eAAe,IAAI,KAAK,CAGvC;AAED,wBAAgB,qBAAqB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGxD;AAED,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAEtD;AAED,wBAAgB,oBAAoB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAa1D"}

package/dist/src/functions/ui.lua

@@ -79,27 +79,35 @@ function ____exports.getHeartsUIWidth(self)
     return width
 end
 function ____exports.getScreenBottomCenterPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(bottomRight.X / 2, bottomRight.Y)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRightPos.X / 2, bottomRightPos.Y)
 end
 function ____exports.getScreenBottomLeftPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(0, bottomRight.Y)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(0, bottomRightPos.Y)
+end
+function ____exports.getScreenBottomY(self)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return bottomRightPos.Y
 end
 function ____exports.getScreenCenterPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return bottomRight / 2
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return bottomRightPos / 2
+end
+function ____exports.getScreenRightX(self)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return bottomRightPos.X
 end
 function ____exports.getScreenTopCenterPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(bottomRight.X / 2, 0)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRightPos.X / 2, 0)
 end
 function ____exports.getScreenTopLeftPos(self)
     return copyVector(nil, VectorZero)
 end
 function ____exports.getScreenTopRightPos(self)
-    local bottomRight = ____exports.getScreenBottomRightPos(nil)
-    return Vector(bottomRight.X, 0)
+    local bottomRightPos = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRightPos.X, 0)
 end
 --- Get how many hearts are currently being shown on the hearts UI.
 -- 

package/package.json

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

package/src/core/constantsFirstLast.ts

@@ -11,6 +11,7 @@ import {
   TrinketType,
 } from "isaac-typescript-definitions";
 import { getEnumLength, getLastEnumValue } from "../functions/enums";
+import { iRange } from "../functions/utils";
 
 // ------------
 // Collectibles
@@ -67,9 +68,8 @@ export const FIRST_PILL_EFFECT = PillEffect.BAD_GAS;
 export const LAST_VANILLA_PILL_EFFECT = getLastEnumValue(PillEffect);
 
 /**
- * Calculated from the `PillEffect` enum.
- *
- * (There is no `PillEffect.NULL` in the custom enum, so we do not have to subtract one here.)
+ * Calculated from the `PillEffect` enum. (There is no `PillEffect.NULL` in the custom enum, so we
+ * do not have to subtract one here.)
  */
 export const NUM_VANILLA_PILL_EFFECTS = getEnumLength(PillEffect);
 
@@ -99,7 +99,10 @@ export const FIRST_HORSE_PILL_COLOR = PillColor.HORSE_BLUE_BLUE;
  */
 export const LAST_HORSE_PILL_COLOR = PillColor.HORSE_WHITE_YELLOW;
 
-export const NUM_NORMAL_PILL_COLORS = LAST_NORMAL_PILL_COLOR - FIRST_PILL_COLOR;
+export const NUM_NORMAL_PILL_COLORS = iRange(
+  FIRST_PILL_COLOR,
+  LAST_NORMAL_PILL_COLOR,
+).length;
 
 // -------
 // Players

package/src/functions/ui.ts

@@ -90,13 +90,13 @@ export function getHeartsUIWidth(): int {
 }
 
 export function getScreenBottomCenterPos(): Readonly<Vector> {
-  const bottomRight = getScreenBottomRightPos();
-  return Vector(bottomRight.X / 2, bottomRight.Y);
+  const bottomRightPos = getScreenBottomRightPos();
+  return Vector(bottomRightPos.X / 2, bottomRightPos.Y);
 }
 
 export function getScreenBottomLeftPos(): Readonly<Vector> {
-  const bottomRight = getScreenBottomRightPos();
-  return Vector(0, bottomRight.Y);
+  const bottomRightPos = getScreenBottomRightPos();
+  return Vector(0, bottomRightPos.Y);
 }
 
 export function getScreenBottomRightPos(): Readonly<Vector> {
@@ -106,14 +106,24 @@ export function getScreenBottomRightPos(): Readonly<Vector> {
   return Vector(screenWidth, screenHeight);
 }
 
+export function getScreenBottomY(): float {
+  const bottomRightPos = getScreenBottomRightPos();
+  return bottomRightPos.Y;
+}
+
 export function getScreenCenterPos(): Readonly<Vector> {
-  const bottomRight = getScreenBottomRightPos();
-  return bottomRight.div(2);
+  const bottomRightPos = getScreenBottomRightPos();
+  return bottomRightPos.div(2);
+}
+
+export function getScreenRightX(): float {
+  const bottomRightPos = getScreenBottomRightPos();
+  return bottomRightPos.X;
 }
 
 export function getScreenTopCenterPos(): Readonly<Vector> {
-  const bottomRight = getScreenBottomRightPos();
-  return Vector(bottomRight.X / 2, 0);
+  const bottomRightPos = getScreenBottomRightPos();
+  return Vector(bottomRightPos.X / 2, 0);
 }
 
 export function getScreenTopLeftPos(): Readonly<Vector> {
@@ -121,8 +131,8 @@ export function getScreenTopLeftPos(): Readonly<Vector> {
 }
 
 export function getScreenTopRightPos(): Readonly<Vector> {
-  const bottomRight = getScreenBottomRightPos();
-  return Vector(bottomRight.X, 0);
+  const bottomRightPos = getScreenBottomRightPos();
+  return Vector(bottomRightPos.X, 0);
 }
 
 /**