isaacscript-common 6.6.1-dev.2 → 6.6.1-dev.4

package/dist/functions/jsonRoom.js

@@ -0,0 +1,132 @@
+import { DoorSlotFlagZero, } from "isaac-typescript-definitions";
+import { sumArray } from "./array";
+import { doorSlotToDoorSlotFlag, getRoomShapeDoorSlot } from "./doors";
+import { addFlag } from "./flag";
+import { log } from "./log";
+import { getRandomFloat } from "./random";
+import { getRandomSeed } from "./rng";
+/**
+ * Helper function to calculate what the resulting `BitFlags<DoorSlotFlag>` value would be for a
+ * given JSON room.
+ */
+export function getJSONRoomDoorSlotFlags(jsonRoom) {
+    const roomShapeString = jsonRoom.$.shape;
+    const roomShapeNumber = tonumber(roomShapeString);
+    if (roomShapeNumber === undefined) {
+        error(`Failed to parse the "shape" property of a JSON room: ${roomShapeString}`);
+    }
+    const roomShape = roomShapeNumber;
+    let doorSlotFlags = DoorSlotFlagZero;
+    for (const door of jsonRoom.door) {
+        const existsString = door.$.exists;
+        if (existsString !== "True" && existsString !== "False") {
+            error(`Failed to parse the "exists" property of a JSON room door: ${existsString}`);
+        }
+        if (existsString === "False") {
+            continue;
+        }
+        const xString = door.$.x;
+        const x = tonumber(xString);
+        if (x === undefined) {
+            error(`Failed to parse the "x" property of a JSON room door: ${xString}`);
+        }
+        const yString = door.$.y;
+        const y = tonumber(yString);
+        if (y === undefined) {
+            error(`Failed to parse the "y" property of a JSON room door: ${yString}`);
+        }
+        const doorSlot = getRoomShapeDoorSlot(roomShape, x, y);
+        if (doorSlot === undefined) {
+            error(`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;
+}
+/**
+ * Helper function to find a specific room from an array of JSON rooms.
+ *
+ * @param jsonRooms The array of rooms to search through.
+ * @param variant The room variant to select. (The room variant can be thought of as the ID of the
+ *                room.)
+ */
+export function getJSONRoomOfVariant(jsonRooms, variant) {
+    const jsonRoomsOfVariant = jsonRooms.filter((jsonRoom) => {
+        const roomVariantString = jsonRoom.$.variant;
+        const roomVariant = tonumber(roomVariantString);
+        return roomVariant === variant;
+    });
+    // The room variant acts as an ID for the room. We assume that there should only be a single room
+    // per variant.
+    if (jsonRoomsOfVariant.length === 0) {
+        return undefined;
+    }
+    if (jsonRoomsOfVariant.length === 1) {
+        return jsonRoomsOfVariant[0];
+    }
+    error(`Found ${jsonRoomsOfVariant.length} JSON rooms with a variant of ${variant}, when there should only be 1.`);
+}
+/**
+ * Helper function to find all of the JSON rooms that match the sub-type provided.
+ *
+ * @param jsonRooms The array of rooms to search through.
+ * @param subType The sub-type to match.
+ */
+export function getJSONRoomsOfSubType(jsonRooms, subType) {
+    return jsonRooms.filter((jsonRoom) => {
+        const roomSubTypeString = jsonRoom.$.subtype;
+        const roomSubType = tonumber(roomSubTypeString);
+        return roomSubType === subType;
+    });
+}
+/**
+ * Helper function to get a random JSON room from an array of JSON rooms.
+ *
+ * Note that this function does not simply choose a random element in the provided array; it will
+ * properly account for each room weight using the algorithm from:
+ * https://stackoverflow.com/questions/1761626/weighted-random-numbers
+ *
+ * @param jsonRooms The array of rooms to random choose between.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
+ *                what the function is doing. Default is false.
+ */
+export function getRandomJSONRoom(jsonRooms, seedOrRNG = getRandomSeed(), verbose = false) {
+    const totalWeight = getTotalWeightOfJSONRooms(jsonRooms);
+    if (verbose) {
+        log(`Total weight of the JSON rooms provided: ${totalWeight}`);
+    }
+    const chosenWeight = getRandomFloat(0, totalWeight, seedOrRNG);
+    if (verbose) {
+        log(`Randomly chose weight for JSON room: ${chosenWeight}`);
+    }
+    return getJSONRoomWithChosenWeight(jsonRooms, chosenWeight);
+}
+function getTotalWeightOfJSONRooms(jsonRooms) {
+    const weights = jsonRooms.map((jsonRoom) => {
+        const roomWeightString = jsonRoom.$.weight;
+        const roomWeight = tonumber(roomWeightString);
+        if (roomWeight === undefined) {
+            error(`Failed to parse the weight of a JSON room: ${roomWeightString}.`);
+        }
+        return roomWeight;
+    });
+    return sumArray(weights);
+}
+function getJSONRoomWithChosenWeight(jsonRooms, chosenWeight) {
+    for (const jsonRoom of jsonRooms) {
+        const roomWeightString = jsonRoom.$.weight;
+        const roomWeight = tonumber(roomWeightString);
+        if (roomWeight === undefined) {
+            error(`Failed to parse the weight of a JSON room: ${roomWeightString}`);
+        }
+        if (chosenWeight < roomWeight) {
+            return jsonRoom;
+        }
+        chosenWeight -= roomWeight;
+    }
+    error(`Failed to get a JSON room with chosen weight: ${chosenWeight}`);
+}
+//# sourceMappingURL=jsonRoom.js.map

package/dist/functions/jsonRoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonRoom.js","sourceRoot":"../src/","sources":["functions/jsonRoom.ts"],"names":[],"mappings":"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"}

package/dist/functions/jsonRoom.lua

@@ -0,0 +1,153 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local ____exports = {}
+local getTotalWeightOfJSONRooms, getJSONRoomWithChosenWeight
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DoorSlotFlagZero = ____isaac_2Dtypescript_2Ddefinitions.DoorSlotFlagZero
+local ____array = require("functions.array")
+local sumArray = ____array.sumArray
+local ____doors = require("functions.doors")
+local doorSlotToDoorSlotFlag = ____doors.doorSlotToDoorSlotFlag
+local getRoomShapeDoorSlot = ____doors.getRoomShapeDoorSlot
+local ____flag = require("functions.flag")
+local addFlag = ____flag.addFlag
+local ____log = require("functions.log")
+local log = ____log.log
+local ____random = require("functions.random")
+local getRandomFloat = ____random.getRandomFloat
+local ____rng = require("functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+function getTotalWeightOfJSONRooms(self, jsonRooms)
+    local weights = __TS__ArrayMap(
+        jsonRooms,
+        function(____, jsonRoom)
+            local roomWeightString = jsonRoom["$"].weight
+            local roomWeight = tonumber(roomWeightString)
+            if roomWeight == nil then
+                error(("Failed to parse the weight of a JSON room: " .. roomWeightString) .. ".")
+            end
+            return roomWeight
+        end
+    )
+    return sumArray(nil, weights)
+end
+function getJSONRoomWithChosenWeight(self, jsonRooms, chosenWeight)
+    for ____, jsonRoom in ipairs(jsonRooms) do
+        local roomWeightString = jsonRoom["$"].weight
+        local roomWeight = tonumber(roomWeightString)
+        if roomWeight == nil then
+            error("Failed to parse the weight of a JSON room: " .. roomWeightString)
+        end
+        if chosenWeight < roomWeight then
+            return jsonRoom
+        end
+        chosenWeight = chosenWeight - roomWeight
+    end
+    error("Failed to get a JSON room with chosen weight: " .. tostring(chosenWeight))
+end
+--- Helper function to calculate what the resulting `BitFlags<DoorSlotFlag>` value would be for a
+-- given JSON room.
+function ____exports.getJSONRoomDoorSlotFlags(self, jsonRoom)
+    local roomShapeString = jsonRoom["$"].shape
+    local roomShapeNumber = tonumber(roomShapeString)
+    if roomShapeNumber == nil then
+        error("Failed to parse the \"shape\" property of a JSON room: " .. roomShapeString)
+    end
+    local roomShape = roomShapeNumber
+    local doorSlotFlags = DoorSlotFlagZero
+    for ____, door in ipairs(jsonRoom.door) do
+        do
+            local existsString = door["$"].exists
+            if existsString ~= "True" and existsString ~= "False" then
+                error("Failed to parse the \"exists\" property of a JSON room door: " .. existsString)
+            end
+            if existsString == "False" then
+                goto __continue4
+            end
+            local xString = door["$"].x
+            local x = tonumber(xString)
+            if x == nil then
+                error("Failed to parse the \"x\" property of a JSON room door: " .. xString)
+            end
+            local yString = door["$"].y
+            local y = tonumber(yString)
+            if y == nil then
+                error("Failed to parse the \"y\" property of a JSON room door: " .. yString)
+            end
+            local doorSlot = getRoomShapeDoorSlot(nil, roomShape, x, y)
+            if doorSlot == nil then
+                error(((("Failed to retrieve the door slot for a JSON room door at coordinates: [" .. tostring(x)) .. ", ") .. tostring(y)) .. "]")
+            end
+            local doorSlotFlag = doorSlotToDoorSlotFlag(nil, doorSlot)
+            doorSlotFlags = addFlag(nil, doorSlotFlags, doorSlotFlag)
+        end
+        ::__continue4::
+    end
+    return doorSlotFlags
+end
+--- Helper function to find a specific room from an array of JSON rooms.
+-- 
+-- @param jsonRooms The array of rooms to search through.
+-- @param variant The room variant to select. (The room variant can be thought of as the ID of the
+-- room.)
+function ____exports.getJSONRoomOfVariant(self, jsonRooms, variant)
+    local jsonRoomsOfVariant = __TS__ArrayFilter(
+        jsonRooms,
+        function(____, jsonRoom)
+            local roomVariantString = jsonRoom["$"].variant
+            local roomVariant = tonumber(roomVariantString)
+            return roomVariant == variant
+        end
+    )
+    if #jsonRoomsOfVariant == 0 then
+        return nil
+    end
+    if #jsonRoomsOfVariant == 1 then
+        return jsonRoomsOfVariant[1]
+    end
+    error(((("Found " .. tostring(#jsonRoomsOfVariant)) .. " JSON rooms with a variant of ") .. tostring(variant)) .. ", when there should only be 1.")
+end
+--- Helper function to find all of the JSON rooms that match the sub-type provided.
+-- 
+-- @param jsonRooms The array of rooms to search through.
+-- @param subType The sub-type to match.
+function ____exports.getJSONRoomsOfSubType(self, jsonRooms, subType)
+    return __TS__ArrayFilter(
+        jsonRooms,
+        function(____, jsonRoom)
+            local roomSubTypeString = jsonRoom["$"].subtype
+            local roomSubType = tonumber(roomSubTypeString)
+            return roomSubType == subType
+        end
+    )
+end
+--- Helper function to get a random JSON room from an array of JSON rooms.
+-- 
+-- Note that this function does not simply choose a random element in the provided array; it will
+-- properly account for each room weight using the algorithm from:
+-- https://stackoverflow.com/questions/1761626/weighted-random-numbers
+-- 
+-- @param jsonRooms The array of rooms to random choose between.
+-- @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+-- `RNG.Next` method will be called. Default is `getRandomSeed()`.
+-- @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
+-- what the function is doing. Default is false.
+function ____exports.getRandomJSONRoom(self, jsonRooms, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if verbose == nil then
+        verbose = false
+    end
+    local totalWeight = getTotalWeightOfJSONRooms(nil, jsonRooms)
+    if verbose then
+        log("Total weight of the JSON rooms provided: " .. tostring(totalWeight))
+    end
+    local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
+    if verbose then
+        log("Randomly chose weight for JSON room: " .. tostring(chosenWeight))
+    end
+    return getJSONRoomWithChosenWeight(nil, jsonRooms, chosenWeight)
+end
+return ____exports

package/dist/functions/jsonRoom.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/jsonRoom.ts"],"names":[],"mappings":";;;;MAqJS,2BAeA;AApKT,6CAIO;AAFL;AAIF,kBAAyB;AAAhB;AACT,kBAA6D;AAApD;AAAwB;AACjC,iBAAwB;AAAf;AACT,gBAAoB;AAAX;AACT,mBAA+B;AAAtB;AACT,gBAA8B;AAArB;AA0IT,SAAS,gCACP;AAEM,oBAAU;QAAA;QAAc,eAAC;AACvB,qCAAmB;AACnB,+BAAa,SAAS;eACxB;gBACF,OAAM,iDAA8C,qBAAgB;;AAEtE,mBAAO;QANqB;;AAS9B,WAAO,cAAS;;AAGlB,SAAS,kCACP,WACA;AAEA,cAAW,mBAAY;AACf,iCAAmB;AACnB,2BAAa,SAAS;WACxB;YACF,MAAM,iDAA8C;;WAGlD,eAAe;AACjB,mBAAO;;AAGT,sCAAgB;;IAGlB,MAAM,6DAAiD;;;;AArKzD,oDACE;AAEM,4BAAkB;AAClB,4BAAkB,SAAS;OAC7B;QACF,MACE,6DAAwD;;AAGtD,sBAAY;AAEd,0BAAgB;AAEpB,cAAW,eAAQ;;AACX,iCAAe;eACjB,gBAAiB,WAAU,gBAAiB;gBAC9C,MACE,mEAA8D;;eAI9D,gBAAiB;AACnB;;AAGI,4BAAU;AACV,sBAAI,SAAS;eACf;gBACF,MAAM,8DAAyD;;AAG3D,4BAAU;AACV,sBAAI,SAAS;eACf;gBACF,MAAM,8DAAyD;;AAG3D,6BAAW,0BAAqB,WAAW,GAAG;eAChD;gBACF,SACE,sFAA0E,OAAC,kBAAK,OAAC;;AAI/E,iCAAe,4BAAuB;AAC5C,4BAAgB,aAAQ,eAAe;;;;AAGzC,WAAO;AAjDT;;;;;;AA2DA,gDACE,WACA;AAEM,+BAAqB;QAAA;QAAiB,eAAC;AACrC,sCAAoB;AACpB,gCAAc,SAAS;AAC7B,mBAAO,eAAgB;QAHmB;;OAQxC,uBAA8B;AAChC;;OAGE,uBAA8B;AAChC,eAAO,mBAAmB;;IAG5B,SACE,qBAAS,yBAAyB,8CAAiC,aAAO;AArB9E;;;;;AA+BA,iDACE,WACA;AAEA,WAAO;QAAA;QAAiB,eAAC;AACjB,sCAAoB;AACpB,gCAAc,SAAS;AAC7B,mBAAO,eAAgB;QAHD;;AAJ1B;;;;;;;;;;;;AAwBA,6CACE,WACA,WACA;OADA;QAAA,YAAwB;;OACxB;QAAA,UAAU;;AAEJ,wBAAc,+BAA0B;OAC1C;QACF,IAAI,wDAA4C;;AAG5C,yBAAe,oBAAe,GAAG,aAAa;OAChD;QACF,IAAI,oDAAwC;;AAG9C,WAAO,iCAA4B,WAAW;AAfhD","file":"jsonRoom.lua","sourceRoot":"../src/"}

package/dist/functions/kColor.js

@@ -0,0 +1,63 @@
+import { SerializationBrand } from "../enums/private/SerializationBrand";
+import { SerializationType } from "../enums/SerializationType";
+import { isaacAPIClassEquals, isIsaacAPIClassOfType } from "./isaacAPIClass";
+import { copyValuesToTable, getNumbersFromTable, tableHasKeys } from "./table";
+import { isTable } from "./types";
+const KEYS = ["Red", "Green", "Blue", "Alpha"];
+const OBJECT_NAME = "KColor";
+export function copyKColor(kColor, serializationType = SerializationType.NONE) {
+    switch (serializationType) {
+        case SerializationType.NONE: {
+            if (!isKColor(kColor)) {
+                error(`Failed to copy a ${OBJECT_NAME} object since the provided object was not a userdata ${OBJECT_NAME} class.`);
+            }
+            return KColor(kColor.Red, kColor.Green, kColor.Blue, kColor.Alpha);
+        }
+        case SerializationType.SERIALIZE: {
+            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 LuaTable();
+            copyValuesToTable(kColor, KEYS, kColorTable);
+            kColorTable.set(SerializationBrand.K_COLOR, "");
+            return kColorTable;
+        }
+        case SerializationType.DESERIALIZE: {
+            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] = getNumbersFromTable(kColor, OBJECT_NAME, ...KEYS);
+            if (r === undefined) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: r`);
+            }
+            if (g === undefined) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: g`);
+            }
+            if (b === undefined) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: b`);
+            }
+            if (a === undefined) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: a`);
+            }
+            return KColor(r, g, b, a);
+        }
+    }
+}
+/** Helper function to check if something is an instantiated KColor object. */
+export function isKColor(object) {
+    return isIsaacAPIClassOfType(object, OBJECT_NAME);
+}
+/**
+ * Used to determine is the given table is a serialized `KColor` object created by the save data
+ * manager and/or the `deepCopy` function.
+ */
+export function isSerializedKColor(object) {
+    if (!isTable(object)) {
+        return false;
+    }
+    return (tableHasKeys(object, ...KEYS) && object.has(SerializationBrand.K_COLOR));
+}
+export function kColorEquals(kColor1, kColor2) {
+    return isaacAPIClassEquals(kColor1, kColor2, KEYS);
+}
+//# sourceMappingURL=kColor.js.map

package/dist/functions/kColor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kColor.js","sourceRoot":"../src/","sources":["functions/kColor.ts"],"names":[],"mappings":"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"}

package/dist/functions/kColor.lua

@@ -0,0 +1,98 @@
+local ____exports = {}
+local OBJECT_NAME
+local ____SerializationBrand = require("enums.private.SerializationBrand")
+local SerializationBrand = ____SerializationBrand.SerializationBrand
+local ____SerializationType = require("enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____isaacAPIClass = require("functions.isaacAPIClass")
+local isaacAPIClassEquals = ____isaacAPIClass.isaacAPIClassEquals
+local isIsaacAPIClassOfType = ____isaacAPIClass.isIsaacAPIClassOfType
+local ____table = require("functions.table")
+local copyValuesToTable = ____table.copyValuesToTable
+local getNumbersFromTable = ____table.getNumbersFromTable
+local tableHasKeys = ____table.tableHasKeys
+local ____types = require("functions.types")
+local isTable = ____types.isTable
+--- Helper function to check if something is an instantiated KColor object.
+function ____exports.isKColor(self, object)
+    return isIsaacAPIClassOfType(nil, object, OBJECT_NAME)
+end
+local KEYS = {"Red", "Green", "Blue", "Alpha"}
+OBJECT_NAME = "KColor"
+--- Helper function to copy a `KColor` object.
+-- 
+-- @param kColor The KColor object to copy. In the case of deserialization, this will actually be a
+-- Lua table instead of an instantiated KColor class.
+-- @param serializationType Default is `SerializationType.NONE`.
+function ____exports.copyKColor(self, kColor, serializationType)
+    if serializationType == nil then
+        serializationType = SerializationType.NONE
+    end
+    repeat
+        local ____switch3 = serializationType
+        local ____cond3 = ____switch3 == SerializationType.NONE
+        if ____cond3 then
+            do
+                if not ____exports.isKColor(nil, kColor) then
+                    error(((("Failed to copy a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
+                end
+                return KColor(kColor.Red, kColor.Green, kColor.Blue, kColor.Alpha)
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == SerializationType.SERIALIZE
+        if ____cond3 then
+            do
+                if not ____exports.isKColor(nil, kColor) then
+                    error(((("Failed to serialize a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
+                end
+                local kColorTable = {}
+                copyValuesToTable(nil, kColor, KEYS, kColorTable)
+                kColorTable[SerializationBrand.K_COLOR] = ""
+                return kColorTable
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == SerializationType.DESERIALIZE
+        if ____cond3 then
+            do
+                if not isTable(nil, kColor) then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object was not a Lua table.")
+                end
+                local r, g, b, a = table.unpack(getNumbersFromTable(
+                    nil,
+                    kColor,
+                    OBJECT_NAME,
+                    table.unpack(KEYS)
+                ))
+                if r == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: r")
+                end
+                if g == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: g")
+                end
+                if b == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: b")
+                end
+                if a == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: a")
+                end
+                return KColor(r, g, b, a)
+            end
+        end
+    until true
+end
+--- Used to determine is the given table is a serialized `KColor` object created by the save data
+-- manager and/or the `deepCopy` function.
+function ____exports.isSerializedKColor(self, object)
+    if not isTable(nil, object) then
+        return false
+    end
+    return tableHasKeys(
+        nil,
+        object,
+        table.unpack(KEYS)
+    ) and object[SerializationBrand.K_COLOR] ~= nil
+end
+function ____exports.kColorEquals(self, kColor1, kColor2)
+    return isaacAPIClassEquals(nil, kColor1, kColor2, KEYS)
+end
+return ____exports

package/dist/functions/kColor.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/kColor.ts"],"names":[],"mappings":";MAiBM;AAjBN,+BAAmC;AAA1B;AACT,8BAAkC;AAAzB;AACT,0BAA2D;AAAlD;AAAqB;AAC9B,kBAAqE;AAA5D;AAAmB;AAAqB;AACjD,kBAAwB;AAAf;;AAiGT,oCAAyB;AACvB,WAAO,2BAAsB,QAAQ;AADvC;AArFM,aAAO,CAAC,OAAO,SAAS,QAAQ;AAChC,cAAc;;;;;;AAgBpB,sCACE,QACA;OAAA;QAAA,oBAAoB;;;4BAEZ;yCACD;;;uBACE,0BAAS;oBACZ,SACE,uBAAoB,gBAAW,4DAAwD,gBAAW;;AAItG,uBAAO,OAAO,YAAY,cAAc,aAAa;;;gDAGlD;;;uBACE,0BAAS;oBACZ,SACE,4BAAyB,gBAAW,4DAAwD,gBAAW;;AAIrG,oCAAc;gBACpB,uBAAkB,QAAQ,MAAM;AAChC,4BAAgB,8BAA4B;AAC5C,uBAAO;;;gDAGJ;;;uBACE,aAAQ;oBACX,OACE,8BAA2B,gBAAW;;AAIrB,sBAAd,GAAG,GAAG,GAAG,IAAK;;oBACnB;oBACA;oBACA,aAAG;;mBAGD;oBACF,OACE,8BAA2B,gBAAW;;mBAGtC;oBACF,OACE,8BAA2B,gBAAW;;mBAGtC;oBACF,OACE,8BAA2B,gBAAW;;mBAGtC;oBACF,OACE,8BAA2B,gBAAW;;AAI1C,uBAAO,OAAO,GAAG,GAAG,GAAG;;;;AA9D7B;;;AA4EA,8CACE;WAEK,aAAQ;AACX,eAAO;;AAGT,WACE;;QAAa;QAAQ,aAAG;UAAS,OAAW;AARhD;AAYA,wCAA6B,SAAiB;AAC5C,WAAO,yBAAoB,SAAS,SAAS;AAD/C","file":"kColor.lua","sourceRoot":"../src/"}

package/dist/functions/language.js

@@ -0,0 +1,13 @@
+import { LANGUAGE_NAMES } from "../objects/languageNames";
+/**
+ * Helper function to convert the language abbreviation from `Options.Language` to the "full"
+ * language name.
+ *
+ * For example, if the current language is set to Korean, `Options.Language` will be set to "kr",
+ * and this function will return "Korean".
+ */
+export function getLanguageName() {
+    const languageAbbreviation = Options.Language;
+    return LANGUAGE_NAMES[languageAbbreviation];
+}
+//# sourceMappingURL=language.js.map

package/dist/functions/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"../src/","sources":["functions/language.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9C,OAAO,cAAc,CAAC,oBAAoB,CAAC,CAAC;AAC9C,CAAC"}

package/dist/functions/language.lua

@@ -0,0 +1,13 @@
+local ____exports = {}
+local ____languageNames = require("objects.languageNames")
+local LANGUAGE_NAMES = ____languageNames.LANGUAGE_NAMES
+--- Helper function to convert the language abbreviation from `Options.Language` to the "full"
+-- language name.
+-- 
+-- For example, if the current language is set to Korean, `Options.Language` will be set to "kr",
+-- and this function will return "Korean".
+function ____exports.getLanguageName(self)
+    local languageAbbreviation = Options.Language
+    return LANGUAGE_NAMES[languageAbbreviation]
+end
+return ____exports

package/dist/functions/language.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/language.ts"],"names":[],"mappings":";AAAA,0BAA+B;AAAtB;;;;;;AAST;AACQ,iCAAuB;AAC7B,WAAO,eAAe;AAFxB","file":"language.lua","sourceRoot":"../src/"}

package/dist/functions/level.js

@@ -0,0 +1,20 @@
+import { DoorSlot } from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { getEnumValues } from "./enums";
+import { getNumRooms, getRooms, isDoorSlotValidAtGridIndexForRedRoom, } from "./rooms";
+export function fillLevelWithRedRooms() {
+    const level = game.GetLevel();
+    let numRooms;
+    do {
+        const rooms = getRooms();
+        numRooms = rooms.length;
+        for (const roomDescriptor of rooms) {
+            for (const doorSlot of getEnumValues(DoorSlot)) {
+                if (isDoorSlotValidAtGridIndexForRedRoom(doorSlot, roomDescriptor.GridIndex)) {
+                    level.MakeRedRoomDoor(roomDescriptor.GridIndex, doorSlot);
+                }
+            }
+        }
+    } while (numRooms !== getNumRooms());
+}
+//# sourceMappingURL=level.js.map

package/dist/functions/level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.js","sourceRoot":"../src/","sources":["functions/level.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,oCAAoC,GACrC,MAAM,SAAS,CAAC;AAEjB,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAE9B,IAAI,QAAa,CAAC;IAClB,GAAG;QACD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;QAExB,KAAK,MAAM,cAAc,IAAI,KAAK,EAAE;YAClC,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE;gBAC9C,IACE,oCAAoC,CAClC,QAAQ,EACR,cAAc,CAAC,SAAS,CACzB,EACD;oBACA,KAAK,CAAC,eAAe,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;iBAC3D;aACF;SACF;KACF,QAAQ,QAAQ,KAAK,WAAW,EAAE,EAAE;AACvC,CAAC"}

package/dist/functions/level.lua

@@ -0,0 +1,29 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DoorSlot = ____isaac_2Dtypescript_2Ddefinitions.DoorSlot
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____enums = require("functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____rooms = require("functions.rooms")
+local getNumRooms = ____rooms.getNumRooms
+local getRooms = ____rooms.getRooms
+local isDoorSlotValidAtGridIndexForRedRoom = ____rooms.isDoorSlotValidAtGridIndexForRedRoom
+function ____exports.fillLevelWithRedRooms(self)
+    local level = game:GetLevel()
+    local numRooms
+    repeat
+        do
+            local rooms = getRooms(nil)
+            numRooms = #rooms
+            for ____, roomDescriptor in ipairs(rooms) do
+                for ____, doorSlot in ipairs(getEnumValues(nil, DoorSlot)) do
+                    if isDoorSlotValidAtGridIndexForRedRoom(nil, doorSlot, roomDescriptor.GridIndex) then
+                        level:MakeRedRoomDoor(roomDescriptor.GridIndex, doorSlot)
+                    end
+                end
+            end
+        end
+    until not (numRooms ~= getNumRooms(nil))
+end
+return ____exports

package/dist/functions/level.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/level.ts"],"names":[],"mappings":";AAAA,6CAAyB;AAAhB;AACT,0BAAqB;AAAZ;AACT,kBAA8B;AAArB;AACT,kBAIO;AAHL;AACA;AACA;AAGF;AACQ,kBAAQ,KAAK;AAEf;;;AAEI,0BAAQ;AACd,uBAAW;AAEX,sBAAW,yBAAkB;AAC3B,0BAAW,mBAAY,mBAAc;uBAEjC,0CACE,UACA;wBAGF,MAAM,gBAAgB,0BAA0B;;;;;UAI/C,iBAAa;AApBxB","file":"level.lua","sourceRoot":"../src/"}