isaacscript-common 87.9.7 → 87.10.0

package/dist/functions/jsonRoom.js

@@ -1,33 +1,26 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getJSONRoomDoorSlotFlags = getJSONRoomDoorSlotFlags;
-exports.getJSONRoomOfVariant = getJSONRoomOfVariant;
-exports.getJSONRoomsOfSubType = getJSONRoomsOfSubType;
-exports.getRandomJSONEntity = getRandomJSONEntity;
-exports.getRandomJSONRoom = getRandomJSONRoom;
-const isaac_typescript_definitions_1 = require("isaac-typescript-definitions");
-const array_1 = require("./array");
-const doors_1 = require("./doors");
-const enums_1 = require("./enums");
-const flag_1 = require("./flag");
-const log_1 = require("./log");
-const random_1 = require("./random");
-const types_1 = require("./types");
-const utils_1 = require("./utils");
+import { DoorSlotFlagZero, RoomShape } from "isaac-typescript-definitions";
+import { sumArray } from "./array";
+import { doorSlotToDoorSlotFlag, getRoomShapeDoorSlot } from "./doors";
+import { isEnumValue } from "./enums";
+import { addFlag } from "./flag";
+import { log } from "./log";
+import { getRandomFloat } from "./random";
+import { parseIntSafe } from "./types";
+import { assertDefined } from "./utils";
 /**
  * Helper function to calculate what the resulting `BitFlags<DoorSlotFlag>` value would be for a
  * given JSON room.
  *
  * (A JSON room is an XML file converted to JSON so that it can be directly imported into your mod.)
  */
-function getJSONRoomDoorSlotFlags(jsonRoom) {
+export function getJSONRoomDoorSlotFlags(jsonRoom) {
     const roomShapeString = jsonRoom.$.shape;
-    const roomShape = (0, types_1.parseIntSafe)(roomShapeString);
-    (0, utils_1.assertDefined)(roomShape, `Failed to parse the "shape" field of a JSON room: ${roomShapeString}`);
-    if (!(0, enums_1.isEnumValue)(roomShape, isaac_typescript_definitions_1.RoomShape)) {
+    const roomShape = parseIntSafe(roomShapeString);
+    assertDefined(roomShape, `Failed to parse the "shape" field of a JSON room: ${roomShapeString}`);
+    if (!isEnumValue(roomShape, RoomShape)) {
         error(`Failed to parse the "shape" field of a JSON room since it was an invalid number: ${roomShape}`);
     }
-    let doorSlotFlags = isaac_typescript_definitions_1.DoorSlotFlagZero;
+    let doorSlotFlags = DoorSlotFlagZero;
     for (const door of jsonRoom.door) {
         const existsString = door.$.exists;
         if (existsString !== "True" && existsString !== "False") {
@@ -37,15 +30,15 @@ function getJSONRoomDoorSlotFlags(jsonRoom) {
             continue;
         }
         const xString = door.$.x;
-        const x = (0, types_1.parseIntSafe)(xString);
-        (0, utils_1.assertDefined)(x, `Failed to parse the "x" field of a JSON room door: ${xString}`);
+        const x = parseIntSafe(xString);
+        assertDefined(x, `Failed to parse the "x" field of a JSON room door: ${xString}`);
         const yString = door.$.y;
-        const y = (0, types_1.parseIntSafe)(yString);
-        (0, utils_1.assertDefined)(y, `Failed to parse the "y" field of a JSON room door: ${yString}`);
-        const doorSlot = (0, doors_1.getRoomShapeDoorSlot)(roomShape, x, y);
-        (0, utils_1.assertDefined)(doorSlot, `Failed to retrieve the door slot for a JSON room door at coordinates: [${x}, ${y}]`);
-        const doorSlotFlag = (0, doors_1.doorSlotToDoorSlotFlag)(doorSlot);
-        doorSlotFlags = (0, flag_1.addFlag)(doorSlotFlags, doorSlotFlag);
+        const y = parseIntSafe(yString);
+        assertDefined(y, `Failed to parse the "y" field of a JSON room door: ${yString}`);
+        const doorSlot = getRoomShapeDoorSlot(roomShape, x, y);
+        assertDefined(doorSlot, `Failed to retrieve the door slot for a JSON room door at coordinates: [${x}, ${y}]`);
+        const doorSlotFlag = doorSlotToDoorSlotFlag(doorSlot);
+        doorSlotFlags = addFlag(doorSlotFlags, doorSlotFlag);
     }
     return doorSlotFlags;
 }
@@ -58,10 +51,10 @@ function getJSONRoomDoorSlotFlags(jsonRoom) {
  * @param variant The room variant to select. (The room variant can be thought of as the ID of the
  *                room.)
  */
-function getJSONRoomOfVariant(jsonRooms, variant) {
+export function getJSONRoomOfVariant(jsonRooms, variant) {
     const jsonRoomsOfVariant = jsonRooms.filter((jsonRoom) => {
         const roomVariantString = jsonRoom.$.variant;
-        const roomVariant = (0, types_1.parseIntSafe)(roomVariantString);
+        const roomVariant = parseIntSafe(roomVariantString);
         if (roomVariant === undefined) {
             error(`Failed to convert a JSON room variant to an integer: ${roomVariantString}`);
         }
@@ -85,10 +78,10 @@ function getJSONRoomOfVariant(jsonRooms, variant) {
  * @param jsonRooms The array of rooms to search through.
  * @param subType The sub-type to match.
  */
-function getJSONRoomsOfSubType(jsonRooms, subType) {
+export function getJSONRoomsOfSubType(jsonRooms, subType) {
     return jsonRooms.filter((jsonRoom) => {
         const roomSubTypeString = jsonRoom.$.subtype;
-        const roomSubType = (0, types_1.parseIntSafe)(roomSubTypeString);
+        const roomSubType = parseIntSafe(roomSubTypeString);
         if (roomSubType === undefined) {
             error(`Failed to convert a JSON room sub-type to an integer: ${roomSubTypeString}`);
         }
@@ -115,17 +108,17 @@ function getJSONRoomsOfSubType(jsonRooms, subType) {
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  *                what the function is doing. Default is false.
  */
-function getRandomJSONEntity(jsonEntities, seedOrRNG, verbose = false) {
+export function getRandomJSONEntity(jsonEntities, seedOrRNG, verbose = false) {
     const totalWeight = getTotalWeightOfJSONObject(jsonEntities);
     if (verbose) {
-        (0, log_1.log)(`Total weight of the JSON entities provided: ${totalWeight}`);
+        log(`Total weight of the JSON entities provided: ${totalWeight}`);
     }
-    const chosenWeight = (0, random_1.getRandomFloat)(0, totalWeight, seedOrRNG);
+    const chosenWeight = getRandomFloat(0, totalWeight, seedOrRNG);
     if (verbose) {
-        (0, log_1.log)(`Randomly chose weight for JSON entity: ${chosenWeight}`);
+        log(`Randomly chose weight for JSON entity: ${chosenWeight}`);
     }
     const randomJSONEntity = getJSONObjectWithChosenWeight(jsonEntities, chosenWeight);
-    (0, utils_1.assertDefined)(randomJSONEntity, `Failed to get a JSON entity with chosen weight: ${chosenWeight}`);
+    assertDefined(randomJSONEntity, `Failed to get a JSON entity with chosen weight: ${chosenWeight}`);
     return randomJSONEntity;
 }
 /**
@@ -146,17 +139,17 @@ function getRandomJSONEntity(jsonEntities, seedOrRNG, verbose = false) {
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  *                what the function is doing. Default is false.
  */
-function getRandomJSONRoom(jsonRooms, seedOrRNG, verbose = false) {
+export function getRandomJSONRoom(jsonRooms, seedOrRNG, verbose = false) {
     const totalWeight = getTotalWeightOfJSONObject(jsonRooms);
     if (verbose) {
-        (0, log_1.log)(`Total weight of the JSON rooms provided: ${totalWeight}`);
+        log(`Total weight of the JSON rooms provided: ${totalWeight}`);
     }
-    const chosenWeight = (0, random_1.getRandomFloat)(0, totalWeight, seedOrRNG);
+    const chosenWeight = getRandomFloat(0, totalWeight, seedOrRNG);
     if (verbose) {
-        (0, log_1.log)(`Randomly chose weight for JSON room: ${chosenWeight}`);
+        log(`Randomly chose weight for JSON room: ${chosenWeight}`);
     }
     const randomJSONRoom = getJSONObjectWithChosenWeight(jsonRooms, chosenWeight);
-    (0, utils_1.assertDefined)(randomJSONRoom, `Failed to get a JSON room with chosen weight: ${chosenWeight}`);
+    assertDefined(randomJSONRoom, `Failed to get a JSON room with chosen weight: ${chosenWeight}`);
     return randomJSONRoom;
 }
 function getJSONObjectWithChosenWeight(jsonOjectArray, chosenWeight) {
@@ -164,7 +157,7 @@ function getJSONObjectWithChosenWeight(jsonOjectArray, chosenWeight) {
     for (const jsonObject of jsonOjectArray) {
         const weightString = jsonObject.$.weight;
         const weight = tonumber(weightString);
-        (0, utils_1.assertDefined)(weight, `Failed to parse the weight of a JSON object: ${weightString}`);
+        assertDefined(weight, `Failed to parse the weight of a JSON object: ${weightString}`);
         weightAccumulator += weight;
         if (weightAccumulator >= chosenWeight) {
             return jsonObject;
@@ -176,8 +169,8 @@ function getTotalWeightOfJSONObject(jsonOjectArray) {
     const weights = jsonOjectArray.map((jsonObject) => {
         const weightString = jsonObject.$.weight;
         const weight = tonumber(weightString);
-        (0, utils_1.assertDefined)(weight, `Failed to parse the weight of a JSON object: ${weightString}.`);
+        assertDefined(weight, `Failed to parse the weight of a JSON object: ${weightString}.`);
         return weight;
     });
-    return (0, array_1.sumArray)(weights);
+    return sumArray(weights);
 }

package/dist/functions/kColor.js

@@ -1,23 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.copyKColor = copyKColor;
-exports.deserializeKColor = deserializeKColor;
-exports.getRandomKColor = getRandomKColor;
-exports.isKColor = isKColor;
-exports.isSerializedKColor = isSerializedKColor;
-exports.kColorEquals = kColorEquals;
-exports.serializeKColor = serializeKColor;
-const SerializationBrand_1 = require("../enums/private/SerializationBrand");
-const isaacAPIClass_1 = require("./isaacAPIClass");
-const random_1 = require("./random");
-const rng_1 = require("./rng");
-const table_1 = require("./table");
-const types_1 = require("./types");
-const utils_1 = require("./utils");
+import { SerializationBrand } from "../enums/private/SerializationBrand";
+import { isaacAPIClassEquals, isIsaacAPIClassOfType } from "./isaacAPIClass";
+import { getRandom } from "./random";
+import { isRNG, newRNG } from "./rng";
+import { copyUserdataValuesToTable, getNumbersFromTable, tableHasKeys, } from "./table";
+import { isTable } from "./types";
+import { assertDefined } from "./utils";
 const OBJECT_NAME = "KColor";
 const KEYS = ["Red", "Green", "Blue", "Alpha"];
 /** Helper function to copy a `KColor` Isaac API class. */
-function copyKColor(kColor) {
+export function copyKColor(kColor) {
     if (!isKColor(kColor)) {
         error(`Failed to copy a ${OBJECT_NAME} object since the provided object was not a userdata ${OBJECT_NAME} class.`);
     }
@@ -27,15 +18,15 @@ function copyKColor(kColor) {
  * Helper function to convert a `SerializedKColor` object to a normal `KColor` object. (This is used
  * by the save data manager when reading data from the "save#.dat" file.)
  */
-function deserializeKColor(kColor) {
-    if (!(0, types_1.isTable)(kColor)) {
+export function deserializeKColor(kColor) {
+    if (!isTable(kColor)) {
         error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object was not a Lua table.`);
     }
-    const [r, g, b, a] = (0, table_1.getNumbersFromTable)(kColor, OBJECT_NAME, ...KEYS);
-    (0, utils_1.assertDefined)(r, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Red`);
-    (0, utils_1.assertDefined)(g, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Green`);
-    (0, utils_1.assertDefined)(b, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Blue`);
-    (0, utils_1.assertDefined)(a, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Alpha`);
+    const [r, g, b, a] = getNumbersFromTable(kColor, OBJECT_NAME, ...KEYS);
+    assertDefined(r, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Red`);
+    assertDefined(g, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Green`);
+    assertDefined(b, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Blue`);
+    assertDefined(a, `Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: Alpha`);
     return KColor(r, g, b, a);
 }
 /**
@@ -49,40 +40,40 @@ function deserializeKColor(kColor) {
  *                  a random seed.
  * @param alpha Optional. The alpha value to use. Default is 1.
  */
-function getRandomKColor(seedOrRNG, alpha = 1) {
-    const rng = (0, rng_1.isRNG)(seedOrRNG) ? seedOrRNG : (0, rng_1.newRNG)(seedOrRNG);
-    const r = (0, random_1.getRandom)(rng);
-    const g = (0, random_1.getRandom)(rng);
-    const b = (0, random_1.getRandom)(rng);
+export function getRandomKColor(seedOrRNG, alpha = 1) {
+    const rng = isRNG(seedOrRNG) ? seedOrRNG : newRNG(seedOrRNG);
+    const r = getRandom(rng);
+    const g = getRandom(rng);
+    const b = getRandom(rng);
     return KColor(r, g, b, alpha);
 }
 /** Helper function to check if something is an instantiated `KColor` object. */
-function isKColor(object) {
-    return (0, isaacAPIClass_1.isIsaacAPIClassOfType)(object, OBJECT_NAME);
+export function isKColor(object) {
+    return isIsaacAPIClassOfType(object, OBJECT_NAME);
 }
 /**
  * Used to determine is the given table is a serialized `KColor` object created by the `deepCopy`
  * function.
  */
-function isSerializedKColor(object) {
-    if (!(0, types_1.isTable)(object)) {
+export function isSerializedKColor(object) {
+    if (!isTable(object)) {
         return false;
     }
-    return ((0, table_1.tableHasKeys)(object, ...KEYS) && object.has(SerializationBrand_1.SerializationBrand.K_COLOR));
+    return (tableHasKeys(object, ...KEYS) && object.has(SerializationBrand.K_COLOR));
 }
-function kColorEquals(kColor1, kColor2) {
-    return (0, isaacAPIClass_1.isaacAPIClassEquals)(kColor1, kColor2, KEYS);
+export function kColorEquals(kColor1, kColor2) {
+    return isaacAPIClassEquals(kColor1, kColor2, KEYS);
 }
 /**
  * Helper function to convert a `KColor` object to a `SerializedKColor` object. (This is used by the
  * save data manager when writing data from the "save#.dat" file.)
  */
-function serializeKColor(kColor) {
+export function serializeKColor(kColor) {
     if (!isKColor(kColor)) {
         error(`Failed to serialize a ${OBJECT_NAME} object since the provided object was not a userdata ${OBJECT_NAME} class.`);
     }
     const kColorTable = new LuaMap();
-    (0, table_1.copyUserdataValuesToTable)(kColor, KEYS, kColorTable);
-    kColorTable.set(SerializationBrand_1.SerializationBrand.K_COLOR, "");
+    copyUserdataValuesToTable(kColor, KEYS, kColorTable);
+    kColorTable.set(SerializationBrand.K_COLOR, "");
     return kColorTable;
 }

package/dist/functions/language.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLanguageName = getLanguageName;
-const languageNames_1 = require("../objects/languageNames");
+import { LANGUAGE_NAMES } from "../objects/languageNames";
 /**
  * Helper function to convert the language abbreviation from `Options.Language` to the "full"
  * language name.
@@ -9,7 +6,7 @@ const languageNames_1 = require("../objects/languageNames");
  * For example, if the current language is set to Korean, `Options.Language` will be set to "kr",
  * and this function will return "Korean".
  */
-function getLanguageName() {
+export function getLanguageName() {
     const languageAbbreviation = Options.Language;
-    return languageNames_1.LANGUAGE_NAMES[languageAbbreviation];
+    return LANGUAGE_NAMES[languageAbbreviation];
 }

package/dist/functions/level.js

@@ -1,30 +1,24 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fillLevelWithRedRooms = fillLevelWithRedRooms;
-exports.getLevelBossIDs = getLevelBossIDs;
-exports.levelHasBossID = levelHasBossID;
-exports.levelHasRoomType = levelHasRoomType;
-const isaac_typescript_definitions_1 = require("isaac-typescript-definitions");
-const cachedEnumValues_1 = require("../cachedEnumValues");
-const cachedClasses_1 = require("../core/cachedClasses");
-const array_1 = require("./array");
-const levelGrid_1 = require("./levelGrid");
-const rooms_1 = require("./rooms");
+import { RoomType, StageID } from "isaac-typescript-definitions";
+import { DOOR_SLOT_VALUES } from "../cachedEnumValues";
+import { game } from "../core/cachedClasses";
+import { filterMap } from "./array";
+import { getRoomDescriptorsForType, isDoorSlotValidAtGridIndexForRedRoom, } from "./levelGrid";
+import { getNumRooms, getRoomsInsideGrid } from "./rooms";
 /** Helper function to fill every possible level grid square with a red room. */
-function fillLevelWithRedRooms() {
-    const level = cachedClasses_1.game.GetLevel();
+export function fillLevelWithRedRooms() {
+    const level = game.GetLevel();
     let numRoomsInGrid;
     do {
-        const roomsInGrid = (0, rooms_1.getRoomsInsideGrid)();
+        const roomsInGrid = getRoomsInsideGrid();
         numRoomsInGrid = roomsInGrid.length;
         for (const roomDescriptor of roomsInGrid) {
-            for (const doorSlot of cachedEnumValues_1.DOOR_SLOT_VALUES) {
-                if ((0, levelGrid_1.isDoorSlotValidAtGridIndexForRedRoom)(doorSlot, roomDescriptor.GridIndex)) {
+            for (const doorSlot of DOOR_SLOT_VALUES) {
+                if (isDoorSlotValidAtGridIndexForRedRoom(doorSlot, roomDescriptor.GridIndex)) {
                     level.MakeRedRoomDoor(roomDescriptor.GridIndex, doorSlot);
                 }
             }
         }
-    } while (numRoomsInGrid !== (0, rooms_1.getNumRooms)());
+    } while (numRoomsInGrid !== getNumRooms());
 }
 /**
  * Helper function to get the boss IDs of all of the Boss Rooms on this floor. (This is equivalent
@@ -33,11 +27,11 @@ function fillLevelWithRedRooms() {
  * Note that this will only look at Boss Rooms inside of the grid, so e.g. Reverse Emperor card
  * rooms will not count.
  */
-function getLevelBossIDs() {
-    const roomsInsideGrid = (0, rooms_1.getRoomsInsideGrid)();
-    return (0, array_1.filterMap)(roomsInsideGrid, (roomDescriptor) => roomDescriptor.Data !== undefined
-        && roomDescriptor.Data.Type === isaac_typescript_definitions_1.RoomType.BOSS
-        && roomDescriptor.Data.StageID === isaac_typescript_definitions_1.StageID.SPECIAL_ROOMS
+export function getLevelBossIDs() {
+    const roomsInsideGrid = getRoomsInsideGrid();
+    return filterMap(roomsInsideGrid, (roomDescriptor) => roomDescriptor.Data !== undefined
+        && roomDescriptor.Data.Type === RoomType.BOSS
+        && roomDescriptor.Data.StageID === StageID.SPECIAL_ROOMS
         ? roomDescriptor.Data.Subtype
         : undefined);
 }
@@ -47,7 +41,7 @@ function getLevelBossIDs() {
  * This function is variadic, meaning that you can pass as many boss IDs as you want to check for.
  * It will return true if one or more of the boss IDs are matched.
  */
-function levelHasBossID(...bossIDs) {
+export function levelHasBossID(...bossIDs) {
     const levelBossIDs = getLevelBossIDs();
     const levelBossIDsSet = new Set(levelBossIDs);
     return bossIDs.some((bossID) => levelBossIDsSet.has(bossID));
@@ -59,7 +53,7 @@ function levelHasBossID(...bossIDs) {
  * This function is variadic, meaning that you can pass as many room types as you want to check for.
  * This function will return true if any of the room types are found.
  */
-function levelHasRoomType(...roomTypes) {
-    const roomDescriptors = (0, levelGrid_1.getRoomDescriptorsForType)(...roomTypes);
+export function levelHasRoomType(...roomTypes) {
+    const roomDescriptors = getRoomDescriptorsForType(...roomTypes);
     return roomDescriptors.length > 0;
 }