isaacscript-common 3.17.0 → 4.0.2

package/objects/roomShapeLayoutSizes.ts

@@ -0,0 +1,45 @@
+import { RoomShape } from "isaac-typescript-definitions";
+import {
+  ONE_BY_ONE_CONTENTS_HEIGHT,
+  ONE_BY_ONE_CONTENTS_WIDTH,
+} from "./roomShapeVolumes";
+
+const ONE_BY_ONE_LAYOUT_SIZE = Vector(
+  ONE_BY_ONE_CONTENTS_WIDTH,
+  ONE_BY_ONE_CONTENTS_HEIGHT,
+);
+const TWO_BY_ONE_VERTICAL_LAYOUT_SIZE = Vector(
+  ONE_BY_ONE_CONTENTS_WIDTH,
+  ONE_BY_ONE_CONTENTS_HEIGHT * 2,
+);
+const TWO_BY_ONE_HORIZONTAL_LAYOUT_SIZE = Vector(
+  ONE_BY_ONE_CONTENTS_WIDTH * 2,
+  ONE_BY_ONE_CONTENTS_HEIGHT,
+);
+const TWO_BY_TWO_LAYOUT_SIZE = Vector(
+  ONE_BY_ONE_CONTENTS_WIDTH * 2,
+  ONE_BY_ONE_CONTENTS_HEIGHT * 2,
+);
+
+/**
+ * The dimensions of a room shape's layout. This is NOT the size of the room's actual contents! For
+ * that, use `ROOM_SHAPE_BOUNDS`.
+ *
+ * For example, a horizontal narrow room has a layout size of equal to that of a 1x1 room.
+ */
+export const ROOM_SHAPE_LAYOUT_SIZES: {
+  readonly [key in RoomShape]: Vector;
+} = {
+  [RoomShape.SHAPE_1x1]: ONE_BY_ONE_LAYOUT_SIZE, // 1
+  [RoomShape.IH]: ONE_BY_ONE_LAYOUT_SIZE, // 2
+  [RoomShape.IV]: ONE_BY_ONE_LAYOUT_SIZE, // 3
+  [RoomShape.SHAPE_1x2]: TWO_BY_ONE_VERTICAL_LAYOUT_SIZE, // 4
+  [RoomShape.IIV]: TWO_BY_ONE_VERTICAL_LAYOUT_SIZE, // 5
+  [RoomShape.SHAPE_2x1]: TWO_BY_ONE_HORIZONTAL_LAYOUT_SIZE, // 6
+  [RoomShape.IIH]: TWO_BY_ONE_HORIZONTAL_LAYOUT_SIZE, // 7
+  [RoomShape.SHAPE_2x2]: TWO_BY_TWO_LAYOUT_SIZE, // 8
+  [RoomShape.LTL]: TWO_BY_TWO_LAYOUT_SIZE, // 9
+  [RoomShape.LTR]: TWO_BY_TWO_LAYOUT_SIZE, // 10
+  [RoomShape.LBL]: TWO_BY_TWO_LAYOUT_SIZE, // 11
+  [RoomShape.LBR]: TWO_BY_TWO_LAYOUT_SIZE, // 12
+} as const;

package/objects/roomShapeToBottomRightPosition.ts

@@ -0,0 +1,25 @@
+import { RoomShape } from "isaac-typescript-definitions";
+
+const TWO_BY_TWO_BOTTOM_RIGHT_POSITION = Vector(25, 13);
+const ONE_BY_TWO_VERTICAL_BOTTOM_RIGHT_POSITION = Vector(12, 13);
+
+/**
+ * "Vector(0, 0)" corresponds to the top left tile of a room, not including the walls. (The top-left
+ * wall would be at "Vector(-1, -1)".)
+ */
+export const ROOM_SHAPE_TO_BOTTOM_RIGHT_POSITION: {
+  readonly [key in RoomShape]: Vector;
+} = {
+  [RoomShape.SHAPE_1x1]: Vector(12, 6), // 1
+  [RoomShape.IH]: Vector(12, 4), // 2
+  [RoomShape.IV]: Vector(8, 6), // 3
+  [RoomShape.SHAPE_1x2]: ONE_BY_TWO_VERTICAL_BOTTOM_RIGHT_POSITION, // 4
+  [RoomShape.IIV]: Vector(8, 13), // 5
+  [RoomShape.SHAPE_2x1]: Vector(25, 6), // 6
+  [RoomShape.IIH]: Vector(25, 4), // 7
+  [RoomShape.SHAPE_2x2]: TWO_BY_TWO_BOTTOM_RIGHT_POSITION, // 8
+  [RoomShape.LTL]: TWO_BY_TWO_BOTTOM_RIGHT_POSITION, // 9
+  [RoomShape.LTR]: TWO_BY_TWO_BOTTOM_RIGHT_POSITION, // 10
+  [RoomShape.LBL]: TWO_BY_TWO_BOTTOM_RIGHT_POSITION, // 11
+  [RoomShape.LBR]: ONE_BY_TWO_VERTICAL_BOTTOM_RIGHT_POSITION, // 12
+} as const;

package/objects/roomShapeToDoorSlots.ts

@@ -0,0 +1,83 @@
+import { DoorSlot, RoomShape } from "isaac-typescript-definitions";
+
+const ALL_DOOR_SLOTS_SET: ReadonlySet<DoorSlot> = new Set([
+  DoorSlot.LEFT_0, // 0
+  DoorSlot.UP_0, // 1
+  DoorSlot.RIGHT_0, // 2
+  DoorSlot.DOWN_0, // 3
+  DoorSlot.LEFT_1, // 4
+  DoorSlot.UP_1, // 5
+  DoorSlot.RIGHT_1, // 6
+  DoorSlot.DOWN_1, // 7
+]);
+
+export const ROOM_SHAPE_TO_DOOR_SLOTS: {
+  readonly [key in RoomShape]: ReadonlySet<DoorSlot>;
+} = {
+  // 1
+  [RoomShape.SHAPE_1x1]: new Set([
+    DoorSlot.LEFT_0, // 0
+    DoorSlot.UP_0, // 1
+    DoorSlot.RIGHT_0, // 2
+    DoorSlot.DOWN_0, // 3
+  ]),
+
+  // 2
+  [RoomShape.IH]: new Set([
+    DoorSlot.LEFT_0, // 0
+    DoorSlot.RIGHT_0, // 2
+  ]),
+
+  // 3
+  [RoomShape.IV]: new Set([
+    DoorSlot.UP_0, // 1
+    DoorSlot.DOWN_0, // 3
+  ]),
+
+  // 4
+  [RoomShape.SHAPE_1x2]: new Set([
+    DoorSlot.LEFT_0, // 0
+    DoorSlot.UP_0, // 1
+    DoorSlot.RIGHT_0, // 2
+    DoorSlot.DOWN_0, // 3
+    DoorSlot.LEFT_1, // 4
+    DoorSlot.RIGHT_1, // 6
+  ]),
+
+  // 5
+  [RoomShape.IIV]: new Set([
+    DoorSlot.UP_0, // 1
+    DoorSlot.DOWN_0, // 3
+  ]),
+
+  // 6
+  [RoomShape.SHAPE_2x1]: new Set([
+    DoorSlot.LEFT_0, // 0
+    DoorSlot.UP_0, // 1
+    DoorSlot.RIGHT_0, // 2
+    DoorSlot.DOWN_0, // 3
+    DoorSlot.UP_1, // 5
+    DoorSlot.DOWN_1, // 7
+  ]),
+
+  // 7
+  [RoomShape.IIH]: new Set([
+    DoorSlot.LEFT_0, // 0
+    DoorSlot.RIGHT_0, // 2
+  ]),
+
+  // 8
+  [RoomShape.SHAPE_2x2]: ALL_DOOR_SLOTS_SET,
+
+  // 9
+  [RoomShape.LTL]: ALL_DOOR_SLOTS_SET,
+
+  // 10
+  [RoomShape.LTR]: ALL_DOOR_SLOTS_SET,
+
+  // 11
+  [RoomShape.LBL]: ALL_DOOR_SLOTS_SET,
+
+  // 12
+  [RoomShape.LBR]: ALL_DOOR_SLOTS_SET,
+} as const;

package/objects/roomShapeToDoorSlotsToGridIndexDelta.ts

@@ -0,0 +1,127 @@
+import { DoorSlot, RoomShape } from "isaac-typescript-definitions";
+import { LEVEL_GRID_ROW_WIDTH } from "../constants";
+
+const LEFT = -1;
+const UP = -LEVEL_GRID_ROW_WIDTH;
+const RIGHT = 1;
+const DOWN = LEVEL_GRID_ROW_WIDTH;
+
+/**
+ * Deltas are considered to be from the safe grid index of the room (i.e. the top left corner, or
+ * top right corner in the case of `RoomShape.LTL`).
+ */
+export const ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA: {
+  readonly [key in RoomShape]: Map<DoorSlot, int>;
+} = {
+  // 1
+  [RoomShape.SHAPE_1x1]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN], // 3
+  ]),
+
+  // 2
+  [RoomShape.IH]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.RIGHT_0, RIGHT], // 2
+  ]),
+
+  // 3
+  [RoomShape.IV]: new Map([
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.DOWN_0, DOWN], // 3
+  ]),
+
+  // 4
+  [RoomShape.SHAPE_1x2]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN + DOWN], // 3
+    [DoorSlot.LEFT_1, DOWN + LEFT], // 4
+    [DoorSlot.RIGHT_1, DOWN + RIGHT], // 6
+  ]),
+
+  // 5
+  [RoomShape.IIV]: new Map([
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.DOWN_0, DOWN + DOWN], // 3
+  ]),
+
+  // 6
+  [RoomShape.SHAPE_2x1]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT + RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN], // 3
+    [DoorSlot.UP_1, RIGHT + UP], // 5
+    [DoorSlot.DOWN_1, RIGHT + DOWN], // 7
+  ]),
+
+  // 7
+  [RoomShape.IIH]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.RIGHT_0, RIGHT + RIGHT], // 2
+  ]),
+
+  // 8
+  [RoomShape.SHAPE_2x2]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT + RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN + DOWN], // 3
+    [DoorSlot.LEFT_1, DOWN + LEFT], // 4
+    [DoorSlot.UP_1, RIGHT + UP], // 5
+    [DoorSlot.RIGHT_1, RIGHT + DOWN + RIGHT], // 6
+    [DoorSlot.DOWN_1, RIGHT + DOWN + DOWN], // 7
+  ]),
+
+  // 9
+  [RoomShape.LTL]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, DOWN + LEFT + UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN + LEFT + DOWN], // 3
+    [DoorSlot.LEFT_1, DOWN + LEFT + LEFT], // 4
+    [DoorSlot.UP_1, UP], // 5
+    [DoorSlot.RIGHT_1, DOWN + RIGHT], // 6
+    [DoorSlot.DOWN_1, DOWN + DOWN], // 7
+  ]),
+
+  // 10
+  [RoomShape.LTR]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN + DOWN], // 3
+    [DoorSlot.LEFT_1, DOWN + LEFT], // 4
+    [DoorSlot.UP_1, DOWN + RIGHT + UP], // 5
+    [DoorSlot.RIGHT_1, DOWN + RIGHT + RIGHT], // 6
+    [DoorSlot.DOWN_1, DOWN + RIGHT + DOWN], // 7
+  ]),
+
+  // 11
+  [RoomShape.LBL]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT + RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN], // 3
+    [DoorSlot.LEFT_1, RIGHT + DOWN + LEFT], // 4
+    [DoorSlot.UP_1, RIGHT + UP], // 5
+    [DoorSlot.RIGHT_1, RIGHT + DOWN + RIGHT], // 6
+    [DoorSlot.DOWN_1, RIGHT + DOWN + DOWN], // 7
+  ]),
+
+  // 12
+  [RoomShape.LBR]: new Map([
+    [DoorSlot.LEFT_0, LEFT], // 0
+    [DoorSlot.UP_0, UP], // 1
+    [DoorSlot.RIGHT_0, RIGHT + RIGHT], // 2
+    [DoorSlot.DOWN_0, DOWN + DOWN], // 3
+    [DoorSlot.LEFT_1, DOWN + LEFT], // 4
+    [DoorSlot.UP_1, RIGHT + UP], // 5
+    [DoorSlot.RIGHT_1, DOWN + RIGHT], // 6
+    [DoorSlot.DOWN_1, RIGHT + DOWN], // 7
+  ]),
+} as const;

package/objects/roomShapeToGridWidth.ts

@@ -0,0 +1,21 @@
+import { RoomShape } from "isaac-typescript-definitions";
+
+const ONE_BY_ONE_WIDTH = 15;
+const TWO_BY_ONE_WIDTH = 28;
+
+export const ROOM_SHAPE_TO_GRID_WIDTH: {
+  readonly [key in RoomShape]: int;
+} = {
+  [RoomShape.SHAPE_1x1]: ONE_BY_ONE_WIDTH, // 1
+  [RoomShape.IH]: ONE_BY_ONE_WIDTH, // 2
+  [RoomShape.IV]: ONE_BY_ONE_WIDTH, // 3
+  [RoomShape.SHAPE_1x2]: ONE_BY_ONE_WIDTH, // 4
+  [RoomShape.IIV]: ONE_BY_ONE_WIDTH, // 5
+  [RoomShape.SHAPE_2x1]: TWO_BY_ONE_WIDTH, // 6
+  [RoomShape.IIH]: TWO_BY_ONE_WIDTH, // 7
+  [RoomShape.SHAPE_2x2]: TWO_BY_ONE_WIDTH, // 8
+  [RoomShape.LTL]: TWO_BY_ONE_WIDTH, // 9
+  [RoomShape.LTR]: TWO_BY_ONE_WIDTH, // 10
+  [RoomShape.LBL]: TWO_BY_ONE_WIDTH, // 11
+  [RoomShape.LBR]: TWO_BY_ONE_WIDTH, // 12
+} as const;

package/objects/roomShapeToTopLeftPosition.ts

@@ -0,0 +1,26 @@
+import { RoomShape } from "isaac-typescript-definitions";
+import { VectorZero } from "../constants";
+
+const NARROW_HORIZONTAL_TOP_LEFT_POSITION = Vector(0, 2);
+const NARROW_VERTICAL_TOP_LEFT_POSITION = Vector(4, 0);
+
+/**
+ * "Vector(0, 0)" corresponds to the top left tile of a room, not including the walls. (The top-left
+ * wall would be at "Vector(-1, -1)".)
+ */
+export const ROOM_SHAPE_TO_TOP_LEFT_POSITION: {
+  readonly [key in RoomShape]: Vector;
+} = {
+  [RoomShape.SHAPE_1x1]: VectorZero, // 1
+  [RoomShape.IH]: NARROW_HORIZONTAL_TOP_LEFT_POSITION, // 2
+  [RoomShape.IV]: NARROW_VERTICAL_TOP_LEFT_POSITION, // 3
+  [RoomShape.SHAPE_1x2]: VectorZero, // 4
+  [RoomShape.IIV]: NARROW_VERTICAL_TOP_LEFT_POSITION, // 5
+  [RoomShape.SHAPE_2x1]: VectorZero, // 6
+  [RoomShape.IIH]: NARROW_HORIZONTAL_TOP_LEFT_POSITION, // 7
+  [RoomShape.SHAPE_2x2]: VectorZero, // 8
+  [RoomShape.LTL]: Vector(13, 0), // 9
+  [RoomShape.LTR]: VectorZero, // 10
+  [RoomShape.LBL]: VectorZero, // 11
+  [RoomShape.LBR]: VectorZero, // 12
+} as const;

package/objects/roomShapeVolumes.ts

@@ -0,0 +1,38 @@
+import { RoomShape } from "isaac-typescript-definitions";
+
+export const ONE_BY_ONE_CONTENTS_WIDTH = 13;
+export const ONE_BY_ONE_CONTENTS_HEIGHT = 7;
+const ONE_BY_ONE_VOLUME =
+  ONE_BY_ONE_CONTENTS_HEIGHT * ONE_BY_ONE_CONTENTS_WIDTH;
+
+export const NARROW_CONTENTS_WIDTH = 5;
+export const NARROW_CONTENTS_HEIGHT = 3;
+const NARROW_HORIZONTAL_VOLUME =
+  ONE_BY_ONE_CONTENTS_WIDTH * NARROW_CONTENTS_HEIGHT;
+const NARROW_VERTICAL_VOLUME =
+  NARROW_CONTENTS_WIDTH * ONE_BY_ONE_CONTENTS_HEIGHT;
+
+const ONE_BY_TWO_VOLUME = ONE_BY_ONE_VOLUME * 2;
+const L_ROOM_VOLUME = ONE_BY_ONE_VOLUME * 3;
+
+/**
+ * Volume is the amount of tiles that are inside the room shape.
+ *
+ * (This cannot be directly calculated from the bounds since L rooms are a special case.)
+ */
+export const ROOM_SHAPE_VOLUMES: {
+  readonly [key in RoomShape]: int;
+} = {
+  [RoomShape.SHAPE_1x1]: ONE_BY_ONE_VOLUME, // 1
+  [RoomShape.IH]: NARROW_HORIZONTAL_VOLUME, // 2
+  [RoomShape.IV]: NARROW_VERTICAL_VOLUME, // 3
+  [RoomShape.SHAPE_1x2]: ONE_BY_TWO_VOLUME, // 4
+  [RoomShape.IIV]: NARROW_VERTICAL_VOLUME * 2, // 5
+  [RoomShape.SHAPE_2x1]: ONE_BY_TWO_VOLUME, // 6
+  [RoomShape.IIH]: NARROW_HORIZONTAL_VOLUME * 2, // 7
+  [RoomShape.SHAPE_2x2]: ONE_BY_ONE_VOLUME * 4, // 8
+  [RoomShape.LTL]: L_ROOM_VOLUME, // 9
+  [RoomShape.LTR]: L_ROOM_VOLUME, // 10
+  [RoomShape.LBL]: L_ROOM_VOLUME, // 11
+  [RoomShape.LBR]: L_ROOM_VOLUME, // 12
+} as const;

package/objects/roomTypeNames.ts

@@ -0,0 +1,36 @@
+import { RoomType } from "isaac-typescript-definitions";
+
+export const DEFAULT_ROOM_TYPE_NAME = "Unknown";
+
+export const ROOM_TYPE_NAMES: { readonly [key in RoomType]: string } = {
+  [RoomType.NULL]: "null room", // 0
+  [RoomType.DEFAULT]: "default room", // 1
+  [RoomType.SHOP]: "shop", // 2
+  [RoomType.ERROR]: "I AM ERROR Room", // 3
+  [RoomType.TREASURE]: "Treasure Room", // 4
+  [RoomType.BOSS]: "Boss Room", // 5
+  [RoomType.MINI_BOSS]: "Miniboss Room", // 6
+  [RoomType.SECRET]: "Secret Room", // 7
+  [RoomType.SUPER_SECRET]: "Super Secret Room", // 8
+  [RoomType.ARCADE]: "Arcade", // 9
+  [RoomType.CURSE]: "Curse Room", // 10
+  [RoomType.CHALLENGE]: "Challenge Room", // 11
+  [RoomType.LIBRARY]: "Library", // 12
+  [RoomType.SACRIFICE]: "Sacrifice Room", // 13
+  [RoomType.DEVIL]: "Devil Room", // 14
+  [RoomType.ANGEL]: "Angel Room", // 15
+  [RoomType.DUNGEON]: "Crawlspace", // 16
+  [RoomType.BOSS_RUSH]: "Boss Rush", // 17
+  [RoomType.CLEAN_BEDROOM]: "Clean Bedroom", // 18
+  [RoomType.DIRTY_BEDROOM]: "Dirty Bedroom", // 19
+  [RoomType.CHEST]: "Chest Room", // 20
+  [RoomType.DICE]: "Dice Room", // 21
+  [RoomType.BLACK_MARKET]: "Black Market", // 22
+  [RoomType.GREED_EXIT]: "Greed Exit Room", // 23
+  [RoomType.PLANETARIUM]: "Planetarium", // 24
+  [RoomType.TELEPORTER]: "Teleporter Room", // 25
+  [RoomType.TELEPORTER_EXIT]: "Teleporter Exit Room", // 26
+  [RoomType.SECRET_EXIT]: "Secret Exit", // 27
+  [RoomType.BLUE]: "Blue Room", // 28
+  [RoomType.ULTRA_SECRET]: "Ultra Secret Room", // 29
+} as const;

package/objects/serializedIsaacAPIClassTypeToIdentityFunction.ts

@@ -0,0 +1,14 @@
+import { CopyableIsaacAPIClassType } from "../enums/private/CopyableIsaacAPIClassType";
+import { isSerializedColor } from "../functions/color";
+import { isSerializedKColor } from "../functions/kColor";
+import { isSerializedRNG } from "../functions/rng";
+import { isSerializedVector } from "../functions/vector";
+
+export const SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION: {
+  readonly [key in CopyableIsaacAPIClassType]: (object: unknown) => boolean;
+} = {
+  [CopyableIsaacAPIClassType.COLOR]: isSerializedColor,
+  [CopyableIsaacAPIClassType.K_COLOR]: isSerializedKColor,
+  [CopyableIsaacAPIClassType.RNG]: isSerializedRNG,
+  [CopyableIsaacAPIClassType.VECTOR]: isSerializedVector,
+} as const;

package/objects/stageTypeToLetter.ts

@@ -0,0 +1,15 @@
+import { StageType } from "isaac-typescript-definitions";
+
+export const STAGE_TYPE_TO_LETTER: { readonly [key in StageType]: string } = {
+  // For example, to go to Basement 2, the command is simply "stage 2" without a letter suffix.
+  [StageType.ORIGINAL]: "", // 0
+
+  [StageType.WRATH_OF_THE_LAMB]: "a", // 1
+  [StageType.AFTERBIRTH]: "b", // 2
+
+  // There is no corresponding suffix for Greed Mode.
+  [StageType.GREED_MODE]: "", // 3
+
+  [StageType.REPENTANCE]: "c", // 4
+  [StageType.REPENTANCE_B]: "d", // 5
+} as const;

package/objects/transformationNames.d.ts

@@ -1,5 +1,4 @@
 import { PlayerForm } from "isaac-typescript-definitions";
-export declare const DEFAULT_TRANSFORMATION_NAME = "Unknown";
 export declare const TRANSFORMATION_NAMES: {
     readonly [key in PlayerForm]: string;
 };

package/objects/transformationNames.lua

@@ -1,7 +1,6 @@
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
-____exports.DEFAULT_TRANSFORMATION_NAME = "Unknown"
 ____exports.TRANSFORMATION_NAMES = {
     [PlayerForm.GUPPY] = "Guppy",
     [PlayerForm.BEELZEBUB] = "Beelzebub",

package/objects/transformationNames.ts

@@ -0,0 +1,18 @@
+import { PlayerForm } from "isaac-typescript-definitions";
+
+export const TRANSFORMATION_NAMES: { readonly [key in PlayerForm]: string } = {
+  [PlayerForm.GUPPY]: "Guppy", // 0
+  [PlayerForm.BEELZEBUB]: "Beelzebub", // 1
+  [PlayerForm.FUN_GUY]: "Fun Guy", // 2
+  [PlayerForm.SERAPHIM]: "Seraphim", // 3
+  [PlayerForm.BOB]: "Bob", // 4
+  [PlayerForm.SPUN]: "Spun", // 5
+  [PlayerForm.YES_MOTHER]: "Yes Mother?", // 6
+  [PlayerForm.CONJOINED]: "Conjoined", // 7
+  [PlayerForm.LEVIATHAN]: "Leviathan", // 8
+  [PlayerForm.OH_CRAP]: "Oh Crap", // 9
+  [PlayerForm.BOOKWORM]: "Bookworm", // 10
+  [PlayerForm.ADULT]: "Adult", // 11
+  [PlayerForm.SPIDER_BABY]: "Spider Baby", // 12
+  [PlayerForm.STOMPY]: "Stompy", // 13
+} as const;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "3.17.0",
+  "version": "4.0.2",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "index",
   "types": "index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^2.2.3"
+    "isaac-typescript-definitions": "^3.0.5"
   }
 }

package/patchErrorFunctions.ts

@@ -0,0 +1,92 @@
+import { getTraceback, isLuaDebugEnabled } from "./functions/debug";
+
+declare let error: ErrorFunction;
+declare let __PATCHED_ERROR: boolean | undefined; // eslint-disable-line
+
+type ErrorFunction = (this: void, message: string, level?: number) => never;
+
+const LINE_SEPARATOR = "\n";
+
+/**
+ * These must be listed in order from how they appear in the traceback from top to bottom, or they
+ * won't be properly removed.
+ */
+const USELESS_TRACEBACK_MESSAGES: readonly string[] = [
+  // The second line of the traceback will always be the "getTraceback" function.
+  "in upvalue 'getTraceback'",
+  "in function 'sandbox.GetTraceback'",
+
+  // The third line of the traceback will always be a line within the "errorWithTraceback" function.
+  "in function 'error'",
+];
+
+let vanillaError: ErrorFunction | undefined;
+
+/**
+ * In Lua, the `error` function will tell you the line number of the error, but not give you a full
+ * traceback of the parent functions, which is unlike how JavaScript works. This function monkey
+ * patches the `error` function to add this functionality.
+ *
+ * Traceback functionality can only be added if the "--luadebug" flag is turned on, so this function
+ * does nothing if the "--luadebug" flag is disabled.
+ *
+ * @internal
+ */
+export function patchErrorFunction(): void {
+  // Only replace the function if the "--luadebug" launch flag is enabled.
+  if (!isLuaDebugEnabled()) {
+    return;
+  }
+
+  // Do nothing if the function was already patched.
+  if (__PATCHED_ERROR !== undefined) {
+    return;
+  }
+  __PATCHED_ERROR = true;
+
+  vanillaError = error;
+  error = errorWithTraceback;
+}
+
+function errorWithTraceback(
+  this: void,
+  message: string,
+  level?: number,
+): never {
+  if (vanillaError === undefined) {
+    error(message, level);
+  }
+
+  if (level === undefined) {
+    level = 1;
+  }
+
+  const tracebackOutput = getTraceback();
+  const slimmedTracebackOutput = slimTracebackOutput(tracebackOutput);
+  message += "\n";
+  message += slimmedTracebackOutput;
+
+  // We add one to the level so that the error message appears to originate at the parent function.
+  return vanillaError(message, level + 1);
+}
+
+/**
+ * Some lines of the traceback output will not be relevant to the error that just occurred. Thus, to
+ * reduce noise, we can always remove these lines.
+ */
+function slimTracebackOutput(tracebackOutput: string) {
+  for (const msg of USELESS_TRACEBACK_MESSAGES) {
+    tracebackOutput = removeLinesContaining(tracebackOutput, msg);
+  }
+
+  return tracebackOutput;
+}
+
+function removeLinesContaining(msg: string, containsMsg: string) {
+  const lines = msg.split(LINE_SEPARATOR);
+  const linesThatDontContain = lines.filter(
+    (line) => !line.includes(containsMsg),
+  );
+
+  return linesThatDontContain.join(LINE_SEPARATOR);
+}

package/sets/LRoomShapesSet.ts

@@ -0,0 +1,8 @@
+import { RoomShape } from "isaac-typescript-definitions";
+
+export const L_ROOM_SHAPES_SET: ReadonlySet<RoomShape> = new Set([
+  RoomShape.LTL, // 9
+  RoomShape.LTR, // 10
+  RoomShape.LBL, // 11
+  RoomShape.LBR, // 12
+]);