isaacscript-common 31.3.1 → 31.5.0

package/src/classes/features/other/debugDisplay/DebugDisplayProjectile.ts

@@ -1,6 +1,7 @@
 import { ModCallback } from "isaac-typescript-definitions";
+import { renderTextOnEntity } from "../../../../functions/render";
 import { Feature } from "../../../private/Feature";
-import { defaultEntityDisplayCallback, renderTextOnEntity } from "./utils";
+import { defaultEntityDisplayCallback } from "./utils";
 
 export class DebugDisplayProjectile extends Feature {
   public textCallback: (projectile: EntityProjectile) => string =

package/src/classes/features/other/debugDisplay/DebugDisplayRock.ts

@@ -1,6 +1,7 @@
 import { ModCallbackCustom } from "../../../../enums/ModCallbackCustom";
+import { renderTextOnEntity } from "../../../../functions/render";
 import { Feature } from "../../../private/Feature";
-import { defaultGridEntityDisplayCallback, renderTextOnEntity } from "./utils";
+import { defaultGridEntityDisplayCallback } from "./utils";
 
 export class DebugDisplayRock extends Feature {
   public textCallback: (rock: GridEntityRock) => string =

package/src/classes/features/other/debugDisplay/DebugDisplaySlot.ts

@@ -1,6 +1,7 @@
 import { ModCallbackCustom } from "../../../../enums/ModCallbackCustom";
+import { renderTextOnEntity } from "../../../../functions/render";
 import { Feature } from "../../../private/Feature";
-import { defaultEntityDisplayCallback, renderTextOnEntity } from "./utils";
+import { defaultEntityDisplayCallback } from "./utils";
 
 export class DebugDisplaySlot extends Feature {
   public textCallback: (slot: EntitySlot) => string =

package/src/classes/features/other/debugDisplay/DebugDisplaySpikes.ts

@@ -1,6 +1,7 @@
 import { ModCallbackCustom } from "../../../../enums/ModCallbackCustom";
+import { renderTextOnEntity } from "../../../../functions/render";
 import { Feature } from "../../../private/Feature";
-import { defaultGridEntityDisplayCallback, renderTextOnEntity } from "./utils";
+import { defaultGridEntityDisplayCallback } from "./utils";
 
 export class DebugDisplaySpikes extends Feature {
   public textCallback: (spikes: GridEntitySpikes) => string =

package/src/classes/features/other/debugDisplay/DebugDisplayTNT.ts

@@ -1,6 +1,7 @@
 import { ModCallbackCustom } from "../../../../enums/ModCallbackCustom";
+import { renderTextOnEntity } from "../../../../functions/render";
 import { Feature } from "../../../private/Feature";
-import { defaultGridEntityDisplayCallback, renderTextOnEntity } from "./utils";
+import { defaultGridEntityDisplayCallback } from "./utils";
 
 export class DebugDisplayTNT extends Feature {
   public textCallback: (tnt: GridEntityTNT) => string =

package/src/classes/features/other/debugDisplay/DebugDisplayTear.ts

@@ -1,6 +1,7 @@
 import { ModCallback } from "isaac-typescript-definitions";
+import { renderTextOnEntity } from "../../../../functions/render";
 import { Feature } from "../../../private/Feature";
-import { defaultEntityDisplayCallback, renderTextOnEntity } from "./utils";
+import { defaultEntityDisplayCallback } from "./utils";
 
 export class DebugDisplayTear extends Feature {
   public textCallback: (tear: EntityTear) => string =

package/src/classes/features/other/debugDisplay/utils.ts

@@ -1,6 +1,5 @@
 import { getEntityID } from "../../../../functions/entities";
 import { getGridEntityID } from "../../../../functions/gridEntities";
-import { isReflectionRender } from "../../../../functions/utils";
 
 export function defaultEntityDisplayCallback(entity: Entity): string {
   return getEntityID(entity);
@@ -11,15 +10,3 @@ export function defaultGridEntityDisplayCallback(
 ): string {
   return getGridEntityID(gridEntity);
 }
-
-export function renderTextOnEntity(
-  entity: Entity | GridEntity,
-  text: string,
-): void {
-  if (isReflectionRender()) {
-    return;
-  }
-
-  const position = Isaac.WorldToScreen(entity.Position);
-  Isaac.RenderText(text, position.X, position.Y, 1, 1, 1, 1);
-}

package/src/functions/render.ts

@@ -0,0 +1,53 @@
+import { RenderMode } from "isaac-typescript-definitions";
+import { game } from "../core/cachedClasses";
+
+/**
+ * Helper function to see if the current render callback is rendering a water reflection.
+ *
+ * When the player is in a room with water, things will be rendered twice: once for the normal
+ * rendering, and once for the reflecting rendering. Thus, any mod code in a render callback will
+ * run twice per frame in these situations, which may be unexpected or cause bugs.
+ *
+ * This function is typically used to early return from a render function if it returns true.
+ */
+export function isReflectionRender(): boolean {
+  const room = game.GetRoom();
+  const renderMode = room.GetRenderMode();
+  return renderMode === RenderMode.WATER_REFLECT;
+}
+
+export function renderScaledTextOnEntity(
+  entity: Entity | GridEntity,
+  text: string,
+  scaleX: float,
+  scaleY: float,
+): void {
+  if (isReflectionRender()) {
+    return;
+  }
+
+  const position = Isaac.WorldToScreen(entity.Position);
+  Isaac.RenderScaledText(
+    text,
+    position.X,
+    position.Y,
+    scaleX,
+    scaleY,
+    1,
+    1,
+    1,
+    1,
+  );
+}
+
+export function renderTextOnEntity(
+  entity: Entity | GridEntity,
+  text: string,
+): void {
+  if (isReflectionRender()) {
+    return;
+  }
+
+  const position = Isaac.WorldToScreen(entity.Position);
+  Isaac.RenderText(text, position.X, position.Y, 1, 1, 1, 1);
+}

package/src/functions/utils.ts

@@ -1,5 +1,3 @@
-import { RenderMode } from "isaac-typescript-definitions";
-import { game } from "../core/cachedClasses";
 import { ReadonlySet } from "../types/ReadonlySet";
 import { getAllPlayers } from "./playerIndex";
 import { isFunction } from "./types";
@@ -123,21 +121,6 @@ export function isMultiplayer(): boolean {
   return controllerIndexesSet.size > 1;
 }
 
-/**
- * Helper function to see if the current render callback is rendering a water reflection.
- *
- * When the player is in a room with water, things will be rendered twice: once for the normal
- * rendering, and once for the reflecting rendering. Thus, any mod code in a render callback will
- * run twice per frame in these situations, which may be unexpected or cause bugs.
- *
- * This function is typically used to early return from a render function if it returns true.
- */
-export function isReflectionRender(): boolean {
-  const room = game.GetRoom();
-  const renderMode = room.GetRenderMode();
-  return renderMode === RenderMode.WATER_REFLECT;
-}
-
 /**
  * Helper function to check if the player is using Afterbirth+ or Repentance.
  *

package/src/index.ts

@@ -95,6 +95,7 @@ export * from "./functions/pressurePlate";
 export * from "./functions/projectiles";
 export * from "./functions/random";
 export * from "./functions/readOnly";
+export * from "./functions/render";
 export * from "./functions/revive";
 export * from "./functions/rng";
 export * from "./functions/rockAlt";
@@ -147,6 +148,7 @@ export * from "./maps/roomNameToTypeMap";
 export * from "./maps/transformationNameToPlayerFormMap";
 export * from "./objects/colors";
 export * from "./objects/kColors";
+export * from "./types/AddSubtract";
 export * from "./types/AllButFirst";
 export * from "./types/AllButLast";
 export * from "./types/AnyClass";
@@ -156,6 +158,7 @@ export * from "./types/AnyGridEntity";
 export * from "./types/ConversionHeartSubType";
 export * from "./types/Decrement";
 export * from "./types/EntityID";
+export * from "./types/Expand";
 export * from "./types/FunctionTuple";
 export * from "./types/GridEntityID";
 export * from "./types/HasFunction";

package/src/types/AddSubtract.ts

@@ -0,0 +1,19 @@
+/** From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468 */
+export type Add<A extends number, B extends number> = Length<
+  [...BuildTuple<A>, ...BuildTuple<B>]
+>;
+
+/** From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468 */
+export type Subtract<A extends number, B extends number> = A extends A
+  ? BuildTuple<A> extends [...infer U, ...BuildTuple<B>]
+    ? Length<U>
+    : never
+  : never;
+
+type BuildTuple<L extends number, T extends unknown[] = []> = T extends {
+  length: L;
+}
+  ? T
+  : BuildTuple<L, [...T, unknown]>;
+
+type Length<T extends unknown[]> = T extends { length: infer L } ? L : never;

package/src/types/Expand.ts

@@ -0,0 +1,5 @@
+/**
+ * From:
+ * https://stackoverflow.com/questions/57683303/how-can-i-see-the-full-expanded-contract-of-a-typescript-type
+ */
+export type Expand<T> = T extends infer O ? { [K in keyof O]: O[K] } : never;