isaacscript-common 7.1.1 → 7.2.2

package/dist/interfaces/TrinketSituation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrinketSituation.d.ts","sourceRoot":"","sources":["../../src/interfaces/TrinketSituation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,WAAW,CAAC;IAChC,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B,kBAAkB,EAAE,GAAG,CAAC;CACzB"}
+{"version":3,"file":"TrinketSituation.d.ts","sourceRoot":"","sources":["../../src/interfaces/TrinketSituation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,WAAW,CAAC;IAChC,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B,kBAAkB,EAAE,GAAG,CAAC;CACzB"}

package/dist/maps/keyboardToString.d.ts

@@ -0,0 +1,4 @@
+import { Keyboard } from "isaac-typescript-definitions";
+/** Maps each keyboard enum member to its corresponding lowercase and uppercase characters. */
+export declare const KEYBOARD_TO_STRING: ReadonlyMap<Keyboard, readonly [lowercaseCharacter: string, uppercaseCharacter: string]>;
+//# sourceMappingURL=keyboardToString.d.ts.map

package/dist/maps/keyboardToString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboardToString.d.ts","sourceRoot":"","sources":["../../src/maps/keyboardToString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAC1C,QAAQ,EACR,SAAS,CAAC,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAuEjE,CAAC"}

package/dist/maps/keyboardToString.lua

@@ -0,0 +1,73 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local Keyboard = ____isaac_2Dtypescript_2Ddefinitions.Keyboard
+--- Maps each keyboard enum member to its corresponding lowercase and uppercase characters.
+____exports.KEYBOARD_TO_STRING = __TS__New(Map, {
+    {Keyboard.SPACE, {" ", " "}},
+    {Keyboard.APOSTROPHE, {"'", "\""}},
+    {Keyboard.COMMA, {",", "<"}},
+    {Keyboard.MINUS, {"-", "_"}},
+    {Keyboard.PERIOD, {".", ">"}},
+    {Keyboard.SLASH, {"/", "?"}},
+    {Keyboard.ZERO, {"0", ")"}},
+    {Keyboard.ONE, {"1", "!"}},
+    {Keyboard.TWO, {"2", "@"}},
+    {Keyboard.THREE, {"3", "#"}},
+    {Keyboard.FOUR, {"4", "$"}},
+    {Keyboard.FIVE, {"5", "%"}},
+    {Keyboard.SIX, {"6", "^"}},
+    {Keyboard.SEVEN, {"7", "&"}},
+    {Keyboard.EIGHT, {"8", "*"}},
+    {Keyboard.NINE, {"9", "("}},
+    {Keyboard.SEMICOLON, {";", ":"}},
+    {Keyboard.EQUAL, {"=", "+"}},
+    {Keyboard.A, {"a", "A"}},
+    {Keyboard.B, {"b", "B"}},
+    {Keyboard.C, {"c", "C"}},
+    {Keyboard.D, {"d", "D"}},
+    {Keyboard.E, {"e", "E"}},
+    {Keyboard.F, {"f", "F"}},
+    {Keyboard.G, {"g", "G"}},
+    {Keyboard.H, {"h", "H"}},
+    {Keyboard.I, {"i", "I"}},
+    {Keyboard.J, {"j", "J"}},
+    {Keyboard.K, {"k", "K"}},
+    {Keyboard.L, {"l", "L"}},
+    {Keyboard.M, {"m", "M"}},
+    {Keyboard.N, {"n", "N"}},
+    {Keyboard.O, {"o", "O"}},
+    {Keyboard.P, {"p", "P"}},
+    {Keyboard.Q, {"q", "Q"}},
+    {Keyboard.R, {"r", "R"}},
+    {Keyboard.S, {"s", "S"}},
+    {Keyboard.T, {"t", "T"}},
+    {Keyboard.U, {"u", "U"}},
+    {Keyboard.V, {"v", "V"}},
+    {Keyboard.W, {"w", "W"}},
+    {Keyboard.X, {"x", "X"}},
+    {Keyboard.Y, {"y", "Y"}},
+    {Keyboard.Z, {"z", "Z"}},
+    {Keyboard.KP_0, {"0", "0"}},
+    {Keyboard.KP_1, {"1", "1"}},
+    {Keyboard.KP_2, {"2", "2"}},
+    {Keyboard.KP_3, {"3", "3"}},
+    {Keyboard.KP_4, {"4", "4"}},
+    {Keyboard.KP_5, {"5", "5"}},
+    {Keyboard.KP_6, {"6", "6"}},
+    {Keyboard.KP_7, {"7", "7"}},
+    {Keyboard.KP_8, {"8", "8"}},
+    {Keyboard.KP_9, {"9", "9"}},
+    {Keyboard.KP_DECIMAL, {".", "."}},
+    {Keyboard.KP_DIVIDE, {"/", "/"}},
+    {Keyboard.KP_MULTIPLY, {"*", "*"}},
+    {Keyboard.KP_SUBTRACT, {"-", "-"}},
+    {Keyboard.KP_ADD, {"+", "+"}},
+    {Keyboard.LEFT_BRACKET, {"[", "{"}},
+    {Keyboard.BACKSLASH, {"\\", "|"}},
+    {Keyboard.RIGHT_BRACKET, {"]", "}"}},
+    {Keyboard.GRAVE_ACCENT, {"`", "~"}}
+})
+return ____exports

package/dist/types/AnyEntity.d.ts

@@ -9,5 +9,10 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
+/**
+ * A type union that matches `Entity`, `EntityBomb`, `EntityEffect`, and so on.
+ *
+ * This is useful for building generic functions that should accept any kind of entity.
+ */
 export declare type AnyEntity = Entity | EntityBomb | EntityEffect | EntityFamiliar | EntityKnife | EntityLaser | EntityNPC | EntityPickup | EntityPlayer | EntityProjectile | EntityTear;
 //# sourceMappingURL=AnyEntity.d.ts.map

package/dist/types/AnyEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnyEntity.d.ts","sourceRoot":"","sources":["../../src/types/AnyEntity.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,oBAAY,SAAS,GACjB,MAAM,GACN,UAAU,GACV,YAAY,GACZ,cAAc,GACd,WAAW,GACX,WAAW,GACX,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,UAAU,CAAC"}
+{"version":3,"file":"AnyEntity.d.ts","sourceRoot":"","sources":["../../src/types/AnyEntity.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA;;;;GAIG;AACH,oBAAY,SAAS,GACjB,MAAM,GACN,UAAU,GACV,YAAY,GACZ,cAAc,GACd,WAAW,GACX,WAAW,GACX,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,UAAU,CAAC"}

package/dist/types/AnyGridEntity.d.ts

@@ -6,5 +6,10 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
+/**
+ * A type union that matches `GridEntity`, `GridEntityDoor`, `GridEntityPit`, and so on.
+ *
+ * This is useful for building generic functions that should accept any kind of grid entity.
+ */
 export declare type AnyGridEntity = GridEntity | GridEntityDoor | GridEntityPit | GridEntityPoop | GridEntityPressurePlate | GridEntityRock | GridEntitySpikes | GridEntityTNT;
 //# sourceMappingURL=AnyGridEntity.d.ts.map

package/dist/types/AnyGridEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnyGridEntity.d.ts","sourceRoot":"","sources":["../../src/types/AnyGridEntity.ts"],"names":[],"mappings":";;;;;;;;AAAA,oBAAY,aAAa,GACrB,UAAU,GACV,cAAc,GACd,aAAa,GACb,cAAc,GACd,uBAAuB,GACvB,cAAc,GACd,gBAAgB,GAChB,aAAa,CAAC"}
+{"version":3,"file":"AnyGridEntity.d.ts","sourceRoot":"","sources":["../../src/types/AnyGridEntity.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;;GAIG;AACH,oBAAY,aAAa,GACrB,UAAU,GACV,cAAc,GACd,aAAa,GACb,cAAc,GACd,uBAAuB,GACvB,cAAc,GACd,gBAAgB,GAChB,aAAa,CAAC"}

package/dist/types/CollectibleIndex.d.ts

@@ -1,7 +1,8 @@
 /**
- * `CollectibleIndex` is a specific type of string; see the documentation for the
- * `getCollectibleIndex` function. Mods can signify that data structures handle collectibles by
- * using this type.
+ * `CollectibleIndex` is a specific type of string that represents a unique identifier for a
+ * collectible. Mods can signify that data structures handle collectibles by using this type.
+ *
+ * For more information, see the documentation for the `getCollectibleIndex` function.
  *
  * For example:
  *

package/dist/types/CollectibleIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollectibleIndex.d.ts","sourceRoot":"","sources":["../../src/types/CollectibleIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,oBAAY,gBAAgB,GAAG,MAAM,GAAG;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"CollectibleIndex.d.ts","sourceRoot":"","sources":["../../src/types/CollectibleIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,oBAAY,gBAAgB,GAAG,MAAM,GAAG;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C,CAAC"}

package/dist/types/Immutable.d.ts

@@ -1,5 +1,7 @@
 /**
- * Immutable is a type that will make the given array/map/set/object recursively read-only.
+ * Immutable is a utility type that will make the given array/map/set/object recursively read-only.
+ *
+ * You can use this type to easily build safe data structures.
  *
  * From: https://stackoverflow.com/questions/41879327/deepreadonly-object-typescript
  */

package/dist/types/Immutable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Immutable.d.ts","sourceRoot":"","sources":["../../src/types/Immutable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,kBAAkB,GACnD,CAAC,GACD,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACxB,cAAc,CAAC,CAAC,CAAC,GACjB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC/B,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACtB,YAAY,CAAC,CAAC,CAAC,GACf,eAAe,CAAC,CAAC,CAAC,CAAC;AAEvB,aAAK,kBAAkB,GACnB,SAAS,GACT,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,QAAQ,CAAC;AACb,aAAK,cAAc,CAAC,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,aAAK,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,aAAK,YAAY,CAAC,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,aAAK,eAAe,CAAC,CAAC,IAAI;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}
+{"version":3,"file":"Immutable.d.ts","sourceRoot":"","sources":["../../src/types/Immutable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,kBAAkB,GACnD,CAAC,GACD,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACxB,cAAc,CAAC,CAAC,CAAC,GACjB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC/B,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACtB,YAAY,CAAC,CAAC,CAAC,GACf,eAAe,CAAC,CAAC,CAAC,CAAC;AAEvB,aAAK,kBAAkB,GACnB,SAAS,GACT,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,QAAQ,CAAC;AACb,aAAK,cAAc,CAAC,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,aAAK,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,aAAK,YAAY,CAAC,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,aAAK,eAAe,CAAC,CAAC,IAAI;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}

package/dist/types/PickupIndex.d.ts

@@ -1,7 +1,9 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
- * `PickupIndex` is a specific type of string; see the documentation for the `getPickupIndex`
- * function. Mods can signify that data structures handle collectibles by using this type.
+ * `PickupIndex` is a specific type of number that represents a unique identifier for a pickup. Mods
+ * can signify that data structures handle collectibles by using this type.
+ *
+ * For more information, see the documentation for the `getPickupIndex` function.
  *
  * For example:
  *

package/dist/types/PickupIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PickupIndex.d.ts","sourceRoot":"","sources":["../../src/types/PickupIndex.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;AACH,oBAAY,WAAW,GAAG,GAAG,GAAG;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC"}
+{"version":3,"file":"PickupIndex.d.ts","sourceRoot":"","sources":["../../src/types/PickupIndex.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AACH,oBAAY,WAAW,GAAG,GAAG,GAAG;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC"}

package/dist/types/PlayerIndex.d.ts

@@ -1,8 +1,9 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
  * `PlayerIndex` is a specific type of number that represents a unique identifier for a player. Mods
- * can signify that data structures handle `EntityPlayer` by using this type. For more information,
- * see the documentation for the `getPlayerIndex` function.
+ * can signify that data structures handle `EntityPlayer` by using this type.
+ *
+ * For more information, see the documentation for the `getPlayerIndex` function.
  *
  * For example:
  *

package/dist/types/PlayerIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerIndex.d.ts","sourceRoot":"","sources":["../../src/types/PlayerIndex.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AACH,oBAAY,WAAW,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"PlayerIndex.d.ts","sourceRoot":"","sources":["../../src/types/PlayerIndex.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AACH,oBAAY,WAAW,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/SerializedIsaacAPIClass.d.ts

@@ -1,4 +1,10 @@
 /// <reference types="typescript-to-lua/language-extensions" />
+/**
+ * This is a type representing an Isaac API class like `Color` or `RNG` that has been written to the
+ * "save#.dat" file. It is used by the save data manager when reading and writing to that file.
+ *
+ * For the list of supported classes, see the `CopyableIsaacAPIClassType` enum.
+ */
 export declare type SerializedIsaacAPIClass = LuaMap<string, unknown> & {
     readonly __serializedIsaacAPIClassBrand: symbol;
 };

package/dist/types/SerializedIsaacAPIClass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SerializedIsaacAPIClass.d.ts","sourceRoot":"","sources":["../../src/types/SerializedIsaacAPIClass.ts"],"names":[],"mappings":";AAAA,oBAAY,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC9D,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAC;CACjD,CAAC"}
+{"version":3,"file":"SerializedIsaacAPIClass.d.ts","sourceRoot":"","sources":["../../src/types/SerializedIsaacAPIClass.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,oBAAY,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC9D,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAC;CACjD,CAAC"}

package/dist/types/TSTLClass.d.ts

@@ -1,4 +1,9 @@
 /// <reference types="typescript-to-lua/language-extensions" />
+/**
+ * This is a type representing a user-created class from TypeScript code.
+ *
+ * This type is used by the save data manager to when copying, serializing, and deserializing.
+ */
 export declare type TSTLClass = LuaMap<AnyNotNil, unknown> & {
     readonly __tstlClassBrand: symbol;
 };

package/dist/types/TSTLClass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TSTLClass.d.ts","sourceRoot":"","sources":["../../src/types/TSTLClass.ts"],"names":[],"mappings":";AAAA,oBAAY,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,CAAC"}
+{"version":3,"file":"TSTLClass.d.ts","sourceRoot":"","sources":["../../src/types/TSTLClass.ts"],"names":[],"mappings":";AAAA;;;;GAIG;AACH,oBAAY,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,CAAC"}

package/dist/types/TrapdoorDestination.d.ts

@@ -1,3 +1,6 @@
 import { LevelStage, StageType } from "isaac-typescript-definitions";
+/**
+ * This is the type that you need to specify when using the `spawnCustomTrapdoor` helper function.
+ */
 export declare type TrapdoorDestination = [stage: LevelStage, stageType: StageType] | [customStageName: string, floorNum: int];
 //# sourceMappingURL=TrapdoorDestination.d.ts.map

package/dist/types/TrapdoorDestination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrapdoorDestination.d.ts","sourceRoot":"","sources":["../../src/types/TrapdoorDestination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAErE,oBAAY,mBAAmB,GAC3B,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,GACzC,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC"}
+{"version":3,"file":"TrapdoorDestination.d.ts","sourceRoot":"","sources":["../../src/types/TrapdoorDestination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,oBAAY,mBAAmB,GAC3B,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,GACzC,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "7.1.1",
+  "version": "7.2.2",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "dist/index",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^3.2.3"
+    "isaac-typescript-definitions": "^3.5.0"
   }
 }

package/src/callbacks/itemPickup.ts

@@ -12,6 +12,7 @@ import { ModUpgraded } from "../classes/ModUpgraded";
 import { ModCallbackCustom } from "../enums/ModCallbackCustom";
 import { saveDataManager } from "../features/saveDataManager/exports";
 import { defaultMapGetPlayer } from "../functions/playerDataStructures";
+import { asNumber } from "../functions/types";
 import {
   newPickingUpItem,
   PickingUpItem,
@@ -71,8 +72,10 @@ function postPEffectUpdateReordered(player: EntityPlayer) {
 }
 
 function queueEmpty(player: EntityPlayer, pickingUpItem: PickingUpItem) {
-  // eslint-disable-next-line isaacscript/strict-enums
-  if (pickingUpItem.itemType === ItemType.NULL || pickingUpItem.subType === 0) {
+  if (
+    pickingUpItem.itemType === ItemType.NULL ||
+    asNumber(pickingUpItem.subType) === 0
+  ) {
     return;
   }
 

package/src/callbacks/postCustomDoorEnter.ts

@@ -15,11 +15,16 @@ import { directionToVector } from "../functions/direction";
 import { doorSlotToDirection } from "../functions/doors";
 import { getEffects, spawnEffect } from "../functions/entitiesSpecific";
 import { getClosestPlayer } from "../functions/players";
+import { asNumber } from "../functions/types";
 import {
   postCustomDoorEnterFire,
   postCustomDoorEnterHasSubscriptions,
 } from "./subscriptions/postCustomDoorEnter";
 
+interface EntityEffectCustomDoor extends EntityEffect {
+  State: DoorState;
+}
+
 interface CustomDoorData {
   slot: DoorSlot;
   state: DoorState;
@@ -72,41 +77,43 @@ export function initCustomDoorInternal(
 
 // ModCallback.POST_EFFECT_UPDATE (55)
 function postEffectUpdaterCustomEntity(effect: EntityEffect) {
+  const customDoor = effect as EntityEffectCustomDoor;
+
   const ptrHash = GetPtrHash(effect);
   const doorData = v.room.customDoors.get(ptrHash);
   if (doorData === undefined) {
     return;
   }
 
-  if (doorData.state === (effect.State as DoorState)) {
+  if (doorData.state === customDoor.State) {
     return;
   }
-  doorData.state = effect.State as DoorState;
+  doorData.state = customDoor.State;
 
   doorChangedState(effect);
 }
 
-function doorChangedState(effect: EntityEffect) {
+function doorChangedState(door: EntityEffectCustomDoor) {
   const room = game.GetRoom();
 
-  const sprite = effect.GetSprite();
-  const animation = getAnimationForCustomDoor(effect);
+  const sprite = door.GetSprite();
+  const animation = getAnimationForCustomDoor(door);
   sprite.Play(animation, true);
 
-  const gridIndex = room.GetGridIndex(effect.Position);
+  const gridIndex = room.GetGridIndex(door.Position);
   const wall = room.GetGridEntity(gridIndex);
   if (wall !== undefined) {
     wall.CollisionClass =
-      (effect.State as DoorState) === DoorState.OPEN
+      door.State === DoorState.OPEN
         ? GridCollisionClass.WALL_EXCEPT_PLAYER
         : GridCollisionClass.WALL;
   }
 }
 
-function getAnimationForCustomDoor(effect: EntityEffect): string {
-  const freshlySpawned = effect.FrameCount === 0;
+function getAnimationForCustomDoor(door: EntityEffectCustomDoor): string {
+  const freshlySpawned = door.FrameCount === 0;
 
-  switch (effect.State as DoorState) {
+  switch (door.State) {
     case DoorState.OPEN: {
       return freshlySpawned ? "Opened" : "Open";
     }
@@ -220,7 +227,7 @@ export function spawnCustomDoorInternal(
   effect.RenderZOffset = -10000;
   effect.PositionOffset = getPositionOffset(doorSlot);
   const sprite = effect.GetSprite();
-  sprite.Rotation = (doorSlot as int) * 90 - 90;
+  sprite.Rotation = asNumber(doorSlot) * 90 - 90;
 
   // Keep track of metadata about this door.
   const ptrHash = GetPtrHash(effect);

package/src/callbacks/postDiceRoomActivated.ts

@@ -1,8 +1,4 @@
-import {
-  DiceFloorSubType,
-  EffectVariant,
-  ModCallback,
-} from "isaac-typescript-definitions";
+import { EffectVariant, ModCallback } from "isaac-typescript-definitions";
 import { saveDataManager } from "../features/saveDataManager/exports";
 import { isCloseEnoughToTriggerDiceFloor } from "../functions/effects";
 import { getClosestPlayer } from "../functions/players";
@@ -34,6 +30,8 @@ function hasSubscriptions() {
 // ModCallback.POST_EFFECT_UPDATE (55)
 // EffectVariant.DICE_FLOOR (76)
 function postEffectUpdateDiceFloor(effect: EntityEffect) {
+  const diceFloor = effect as EntityEffectDiceFloor;
+
   if (!hasSubscriptions()) {
     return;
   }
@@ -44,16 +42,13 @@ function postEffectUpdateDiceFloor(effect: EntityEffect) {
 
   // When using the debug console to go to a dice room, the player can appear on top of the dice
   // floor before they snap to the door.
-  if (effect.FrameCount === 0) {
+  if (diceFloor.FrameCount === 0) {
     return;
   }
 
-  const closestPlayer = getClosestPlayer(effect.Position);
-  if (isCloseEnoughToTriggerDiceFloor(closestPlayer, effect)) {
+  const closestPlayer = getClosestPlayer(diceFloor.Position);
+  if (isCloseEnoughToTriggerDiceFloor(closestPlayer, diceFloor)) {
     v.room.diceRoomActivated = true;
-    postDiceRoomActivatedFire(
-      closestPlayer,
-      effect.SubType as DiceFloorSubType,
-    );
+    postDiceRoomActivatedFire(closestPlayer, diceFloor.SubType);
   }
 }

package/src/callbacks/postItemDischarged.ts

@@ -131,11 +131,13 @@ function preNPCCollisionSucker(
   npc: EntityNPC,
   collider: Entity,
 ): boolean | undefined {
+  const sucker = npc as EntityNPCSucker;
+
   if (!hasSubscriptions()) {
     return undefined;
   }
 
-  if (npc.Variant !== (SuckerVariant.BULB as int)) {
+  if (sucker.Variant !== SuckerVariant.BULB) {
     return undefined;
   }
 

package/src/callbacks/postSlotDestroyed.ts

@@ -36,7 +36,7 @@ export function postSlotDestroyedInit(mod: ModUpgraded): void {
 
   mod.AddCallback(
     ModCallback.POST_ENTITY_REMOVE,
-    postEntityRemove,
+    postEntityRemoveSlot,
     EntityType.SLOT,
   ); // 67
 
@@ -51,7 +51,8 @@ function hasSubscriptions() {
 }
 
 // ModCallback.POST_ENTITY_REMOVE (67)
-function postEntityRemove(entity: Entity) {
+// EntityType.SLOT (6)
+function postEntityRemoveSlot(entity: Entity) {
   const slot = entity as EntitySlot;
   const ptrHash = GetPtrHash(slot);
   const gameFrameCount = game.GetFrameCount();

package/src/callbacks/reorderedCallbacks.ts

@@ -31,8 +31,8 @@ import {
   postNewRoomReorderedHasSubscriptions,
 } from "./subscriptions/postNewRoomReordered";
 
-let currentStage = null as int | null;
-let currentStageType = null as int | null;
+let currentStage: int | null = null;
+let currentStageType: int | null = null;
 let usedGlowingHourGlass = false;
 let forceNewLevel = false;
 let forceNewRoom = false;

package/src/classes/DefaultMap.ts

@@ -1,12 +1,5 @@
 import { isFunction, isPrimitive } from "../functions/types";
 
-// eslint-disable-next-line isaacscript/complete-sentences-jsdoc
-/**
- * A function that creates the default value for your `DefaultMap`. For example, if it was a
- * `DefaultMap` containing maps, the factory function would be: `() => new Map()`
- */
-export type FactoryFunction<V, Args extends unknown[]> = (...args: Args) => V;
-
 /**
  * `DefaultMap` is a data structure that makes working with default values easier.
  *
@@ -116,7 +109,7 @@ export class DefaultMap<Key, Value, Args extends unknown[] = []> extends Map<
       this.defaultValue = undefined;
       this.defaultValueFactory = defaultValueOrFactoryFunction;
     } else {
-      this.defaultValue = defaultValueOrFactoryFunction as Value;
+      this.defaultValue = defaultValueOrFactoryFunction;
       this.defaultValueFactory = undefined;
     }
   }
@@ -169,6 +162,13 @@ export class DefaultMap<Key, Value, Args extends unknown[] = []> extends Map<
   }
 }
 
+// eslint-disable-next-line isaacscript/complete-sentences-jsdoc
+/**
+ * A function that creates the default value for your `DefaultMap`. For example, if it was a
+ * `DefaultMap` containing maps, the factory function would be: `() => new Map()`
+ */
+export type FactoryFunction<V, Args extends unknown[]> = (...args: Args) => V;
+
 /* eslint-disable @typescript-eslint/no-unused-vars */
 function test() {
   // Boolean

package/src/core/constants.ts

@@ -1,5 +1,4 @@
 import {
-  CollectibleType,
   Dimension,
   DisplayFlag,
   ItemPoolType,
@@ -7,6 +6,7 @@ import {
 } from "isaac-typescript-definitions";
 import { getEnumLength } from "../functions/enums";
 import { addFlag } from "../functions/flag";
+import { asCollectibleType } from "../functions/types";
 import { NUM_NORMAL_PILL_COLORS } from "./constantsFirstLast";
 
 /**
@@ -64,8 +64,8 @@ export const EMPTY_PNG_PATH = "gfx/none.png";
  * encountered by the player. The first TMTRAINER item takes the final possible 32 bit number. The
  * second TMTRAINER item subtracts one from that, and so on.
  */
-export const FIRST_GLITCHED_COLLECTIBLE_TYPE = ((1 << 32) -
-  1) as CollectibleType;
+
+export const FIRST_GLITCHED_COLLECTIBLE_TYPE = asCollectibleType((1 << 32) - 1);
 
 /** Game frames are what is returned by the `Game.GetFrameCount` method. */
 export const GAME_FRAMES_PER_SECOND = 30;

package/src/core/constantsFirstLast.ts

@@ -9,6 +9,14 @@ import {
   TrinketType,
 } from "isaac-typescript-definitions";
 import { getEnumLength, getLastEnumValue } from "../functions/enums";
+import {
+  asCard,
+  asCollectibleType,
+  asNumber,
+  asPillEffect,
+  asPlayerType,
+  asTrinketType,
+} from "../functions/types";
 import { itemConfig } from "./cachedClasses";
 
 // ------------
@@ -24,8 +32,9 @@ export const FIRST_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION;
  * Equal to `itemConfig.GetCollectibles().Size - 1`. (`Size` includes invalid collectibles, like
  * 666. We subtract one to account for `CollectibleType.NULL`.)
  */
-export const LAST_COLLECTIBLE_TYPE = (itemConfig.GetCollectibles().Size -
-  1) as CollectibleType;
+export const LAST_COLLECTIBLE_TYPE = asCollectibleType(
+  itemConfig.GetCollectibles().Size - 1,
+);
 
 /**
  * Calculated from the `CollectibleType` enum.
@@ -39,8 +48,9 @@ export const LAST_VANILLA_COLLECTIBLE_TYPE = getLastEnumValue(CollectibleType);
  * If there are no modded collectibles, this constant will represent a collectible type that does
  * not exist.
  */
-export const FIRST_MODDED_COLLECTIBLE_TYPE =
-  ((LAST_VANILLA_COLLECTIBLE_TYPE as int) + 1) as CollectibleType;
+export const FIRST_MODDED_COLLECTIBLE_TYPE = asCollectibleType(
+  asNumber(LAST_VANILLA_COLLECTIBLE_TYPE) + 1,
+);
 
 /** Calculated from the `CollectibleType` enum. `CollectibleType.NULL` is not included. */
 export const NUM_VANILLA_COLLECTIBLE_TYPES = getEnumLength(CollectibleType) - 1;
@@ -79,7 +89,7 @@ export const FIRST_TRINKET_TYPE = TrinketType.SWALLOWED_PENNY;
  * Equal to `itemConfig.GetTrinkets().Size - 1`. (We subtract one to account for
  * `TrinketType.NULL`.)
  */
-export const LAST_TRINKET_TYPE = NUM_TRINKET_TYPES as TrinketType;
+export const LAST_TRINKET_TYPE = asTrinketType(NUM_TRINKET_TYPES);
 
 /** Calculated from the `TrinketType` enum. */
 export const LAST_VANILLA_TRINKET_TYPE = getLastEnumValue(TrinketType);
@@ -87,8 +97,9 @@ export const LAST_VANILLA_TRINKET_TYPE = getLastEnumValue(TrinketType);
 /**
  * If there are no modded trinkets, this constant will represent a trinket type that does not exist.
  */
-export const FIRST_MODDED_TRINKET_TYPE = ((LAST_VANILLA_TRINKET_TYPE as int) +
-  1) as TrinketType;
+export const FIRST_MODDED_TRINKET_TYPE = asTrinketType(
+  asNumber(LAST_VANILLA_TRINKET_TYPE) + 1,
+);
 
 // -----
 // Cards
@@ -114,13 +125,13 @@ export const FIRST_CARD = Card.FOOL;
  *
  * Equal to `itemConfig.GetCards().Size - 1`. (We subtract one to account for `Card.NULL`.)
  */
-export const LAST_CARD = NUM_CARDS as Card;
+export const LAST_CARD = asCard(NUM_CARDS);
 
 /** Calculated from the `Card` enum. */
 export const MAX_VANILLA_CARD = getLastEnumValue(Card);
 
 /** If there are no modded cards, this constant will represent a card that does not exist. */
-export const FIRST_MODDED_CARD = ((MAX_VANILLA_CARD as int) + 1) as Card;
+export const FIRST_MODDED_CARD = asCard(asNumber(MAX_VANILLA_CARD) + 1);
 
 // ------------
 // Pill Effects
@@ -153,7 +164,7 @@ export const FIRST_PILL_EFFECT = PillEffect.BAD_GAS;
  * Equal to `itemConfig.GetPillEffects().Size - 1`. (We subtract one to account for
  * `PillEffect.NULL`.)
  */
-export const LAST_PILL_EFFECT = NUM_PILL_EFFECTS as PillEffect;
+export const LAST_PILL_EFFECT = asPillEffect(NUM_PILL_EFFECTS);
 
 /** Calculated from the `PillEffect` enum. */
 export const LAST_VANILLA_PILL_EFFECT = getLastEnumValue(PillEffect);
@@ -162,8 +173,9 @@ export const LAST_VANILLA_PILL_EFFECT = getLastEnumValue(PillEffect);
  * If there are no modded pill effects, this constant will represent a pill effect that does not
  * exist.
  */
-export const FIRST_MODDED_PILL_EFFECT = ((LAST_VANILLA_PILL_EFFECT as int) +
-  1) as PillEffect;
+export const FIRST_MODDED_PILL_EFFECT = asPillEffect(
+  asNumber(LAST_VANILLA_PILL_EFFECT) + 1,
+);
 
 // -----------
 // Pill Colors
@@ -207,9 +219,12 @@ export const LAST_VANILLA_CHARACTER = getLastEnumValue(PlayerType);
 
 /**
  * If there are no modded characters, this constant will represent a character that does not exist.
+ * (There is no way to determine the amount of modded characters at run-time, since there is no
+ * exposed player config.)
  */
-export const FIRST_MODDED_CHARACTER = ((LAST_VANILLA_CHARACTER as int) +
-  1) as PlayerType;
+export const FIRST_MODDED_CHARACTER = asPlayerType(
+  asNumber(LAST_VANILLA_CHARACTER) + 1,
+);
 
 // ----------
 // Room Types

package/src/enums/AmbushType.ts

@@ -1,3 +1,4 @@
+/** This is used by the `POST_AMBUSH_STARTED` and `POST_AMBUSH_FINISHED` custom callbacks. */
 export enum AmbushType {
   CHALLENGE_ROOM,
   BOSS_RUSH,

package/src/enums/CornerType.ts

@@ -1,3 +1,4 @@
+/** This is used by the `getRoomShapeCorners` helper function. */
 export enum CornerType {
   TOP_LEFT,
   TOP_RIGHT,

package/src/enums/PocketItemType.ts

@@ -1,3 +1,4 @@
+/** This is used in the various pocket item helper functions. */
 export enum PocketItemType {
   EMPTY,
   CARD,