isaacscript-common 6.6.1-dev.2 → 6.6.1

package/dist/features/debugDisplay/exports.lua

@@ -0,0 +1,368 @@
+local ____exports = {}
+local ____utils = require("functions.utils")
+local printEnabled = ____utils.printEnabled
+local ____v = require("features.debugDisplay.v")
+local v = ____v.default
+local debugDisplayTextCallbacks = ____v.debugDisplayTextCallbacks
+local errorIfDebugDisplayNotInitialized = ____v.errorIfDebugDisplayNotInitialized
+--- After using the "playerDisplay" console command, text will be drawn on each player for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setPlayerDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.player = textCallback
+end
+--- After using the "tearDisplay" console command, text will be drawn on each tear for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setTearDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.tear = textCallback
+end
+--- After using the "familiarDisplay" console command, text will be drawn on each familiar for
+-- debugging purposes. Use this function to specify a callback function that will returns the string
+-- that should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setFamiliarDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.familiar = textCallback
+end
+--- After using the "bombDisplay" console command, text will be drawn on each bomb for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setBombDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.bomb = textCallback
+end
+--- After using the "pickupDisplay" console command, text will be drawn on each pickup for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setPickupDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.pickup = textCallback
+end
+--- After using the "slotDisplay" console command, text will be drawn on each slot for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setSlotDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.slot = textCallback
+end
+--- After using the "laserDisplay" console command, text will be drawn on each laser for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setLaserDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.laser = textCallback
+end
+--- After using the "knifeDisplay" console command, text will be drawn on each knife for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setKnifeDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.knife = textCallback
+end
+--- After using the "projectileDisplay" console command, text will be drawn on each projectile for
+-- debugging purposes. Use this function to specify a callback function that will returns the string
+-- that should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setProjectileDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.projectile = textCallback
+end
+--- After using the "effectDisplay" console command, text will be drawn on each effect for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setEffectDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.effect = textCallback
+end
+--- After using the "npcDisplay" console command, text will be drawn on each NPC for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setNPCDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.npc = textCallback
+end
+--- After using the "rockDisplay" console command, text will be drawn on each rock for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setRockDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.rock = textCallback
+end
+--- After using the "pitDisplay" console command, text will be drawn on each pit for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setPitDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.pit = textCallback
+end
+--- After using the "spikesDisplay" console command, text will be drawn on each spikes for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setSpikesDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.spikes = textCallback
+end
+--- After using the "tntDisplay" console command, text will be drawn on each TNT for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setTNTDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.tnt = textCallback
+end
+--- After using the "poopDisplay" console command, text will be drawn on each poop for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setPoopDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.poop = textCallback
+end
+--- After using the "poopDisplay" console command, text will be drawn on each poop for debugging
+-- purposes. Use this function to specify a callback function that will returns the string that
+-- should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setDoorDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.door = textCallback
+end
+--- After using the "pressurePlateDisplay" console command, text will be drawn on each pressure plate
+-- for debugging purposes. Use this function to specify a callback function that will returns the
+-- string that should be drawn.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this console command to work.
+function ____exports.setPressurePlateDisplay(self, textCallback)
+    errorIfDebugDisplayNotInitialized(nil)
+    debugDisplayTextCallbacks.pressurePlate = textCallback
+end
+--- Toggles the debug display for players. This is the function that runs when you use the
+-- "playerDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.togglePlayerDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.player = not v.run.player
+    printEnabled(nil, v.run.player, "player display")
+end
+--- Toggles the debug display for tears. This is the function that runs when you use the
+-- "tearDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleTearDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.tear = not v.run.tear
+    printEnabled(nil, v.run.tear, "tear display")
+end
+--- Toggles the debug display for familiars. This is the function that runs when you use the
+-- "familiarDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleFamiliarDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.familiar = not v.run.familiar
+    printEnabled(nil, v.run.familiar, "familiar display")
+end
+--- Toggles the debug display for bombs. This is the function that runs when you use the
+-- "bombDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleBombDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.bomb = not v.run.bomb
+    printEnabled(nil, v.run.bomb, "bomb display")
+end
+--- Toggles the debug display for pickups. This is the function that runs when you use the
+-- "pickupDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.togglePickupDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.pickup = not v.run.pickup
+    printEnabled(nil, v.run.pickup, "pickup display")
+end
+--- Toggles the debug display for slots. This is the function that runs when you use the
+-- "slotDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleSlotDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.slot = not v.run.slot
+    printEnabled(nil, v.run.slot, "slot display")
+end
+--- Toggles the debug display for lasers. This is the function that runs when you use the
+-- "laserDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleLaserDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.laser = not v.run.laser
+    printEnabled(nil, v.run.laser, "laser display")
+end
+--- Toggles the debug display for knives. This is the function that runs when you use the
+-- "knifeDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleKnifeDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.knife = not v.run.knife
+    printEnabled(nil, v.run.knife, "knife display")
+end
+--- Toggles the debug display for projectiles. This is the function that runs when you use the
+-- "projectileDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleProjectileDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.projectile = not v.run.projectile
+    printEnabled(nil, v.run.projectile, "projectile display")
+end
+--- Toggles the debug display for effects. This is the function that runs when you use the
+-- "effectDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleEffectDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.effect = not v.run.effect
+    printEnabled(nil, v.run.effect, "effect display")
+end
+--- Toggles the debug display for NPCs. This is the function that runs when you use the "npcDisplay"
+-- custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleNPCDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.npc = not v.run.npc
+    printEnabled(nil, v.run.npc, "NPC display")
+end
+--- Toggles the debug display for rocks. This is the function that runs when you use the
+-- "rockDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleRockDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.rock = not v.run.rock
+    printEnabled(nil, v.run.rock, "rock display")
+end
+--- Toggles the debug display for pits. This is the function that runs when you use the "pitDisplay"
+-- custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.togglePitDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.pit = not v.run.pit
+    printEnabled(nil, v.run.pit, "pit display")
+end
+--- Toggles the debug display for spikes. This is the function that runs when you use the
+-- "spikesDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleSpikesDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.spikes = not v.run.spikes
+    printEnabled(nil, v.run.spikes, "spikes display")
+end
+--- Toggles the debug display for TNT. This is the function that runs when you use the "tntDisplay"
+-- custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleTNTDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.tnt = not v.run.tnt
+    printEnabled(nil, v.run.tnt, "TNT display")
+end
+--- Toggles the debug display for poop. This is the function that runs when you use the "poopDisplay"
+-- custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.togglePoopDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.poop = not v.run.poop
+    printEnabled(nil, v.run.poop, "poop display")
+end
+--- Toggles the debug display for doors. This is the function that runs when you use the
+-- "doorDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.toggleDoorDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.door = not v.run.door
+    printEnabled(nil, v.run.door, "door display")
+end
+--- Toggles the debug display for pressure plates. This is the function that runs when you use the
+-- "pressurePlateDisplay" custom console command.
+-- 
+-- Note that you have to run the `enableExtraConsoleCommands` function once at the beginning of your
+-- mod in order for this feature to work.
+function ____exports.togglePressurePlateDisplay(self)
+    errorIfDebugDisplayNotInitialized(nil)
+    v.run.pressurePlate = not v.run.pressurePlate
+    printEnabled(nil, v.run.pressurePlate, "pressure plate display")
+end
+return ____exports

package/dist/features/debugDisplay/v.d.ts

@@ -0,0 +1,46 @@
+export declare function setDebugDisplayEnabled(): void;
+export declare function errorIfDebugDisplayNotInitialized(): void;
+declare const v: {
+    run: {
+        player: boolean;
+        tear: boolean;
+        familiar: boolean;
+        bomb: boolean;
+        pickup: boolean;
+        slot: boolean;
+        laser: boolean;
+        knife: boolean;
+        projectile: boolean;
+        effect: boolean;
+        npc: boolean;
+        rock: boolean;
+        pit: boolean;
+        spikes: boolean;
+        tnt: boolean;
+        poop: boolean;
+        door: boolean;
+        pressurePlate: boolean;
+    };
+};
+export default v;
+export declare const debugDisplayTextCallbacks: {
+    player: (player: EntityPlayer) => string;
+    tear: (tear: EntityTear) => string;
+    familiar: (familiar: EntityFamiliar) => string;
+    bomb: (bomb: EntityBomb) => string;
+    pickup: (pickup: EntityPickup) => string;
+    slot: (familiar: Entity) => string;
+    laser: (laser: EntityLaser) => string;
+    knife: (knife: EntityKnife) => string;
+    projectile: (projectile: EntityProjectile) => string;
+    effect: (effect: EntityEffect) => string;
+    npc: (effect: EntityNPC) => string;
+    rock: (rock: GridEntityRock) => string;
+    pit: (pit: GridEntityPit) => string;
+    spikes: (spikes: GridEntitySpikes) => string;
+    tnt: (tnt: GridEntityTNT) => string;
+    poop: (poop: GridEntityPoop) => string;
+    door: (door: GridEntityDoor) => string;
+    pressurePlate: (pressurePlate: GridEntityPressurePlate) => string;
+};
+//# sourceMappingURL=v.d.ts.map

package/dist/features/debugDisplay/v.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/src/features/debugDisplay/v.ts"],"names":[],"mappings":"AAKA,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CAMxD;AAED,QAAA,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;CAsBN,CAAC;AACF,eAAe,CAAC,CAAC;AAEjB,eAAO,MAAM,yBAAyB;qBACa,YAAY,KAAK,MAAM;iBAC3B,UAAU,KAAK,MAAM;yBAEtD,cAAc,KACrB,MAAM;iBACkC,UAAU,KAAK,MAAM;qBACjB,YAAY,KAAK,MAAM;qBACvB,MAAM,KAAK,MAAM;mBACnB,WAAW,KAAK,MAAM;mBACtB,WAAW,KAAK,MAAM;6BAEvD,gBAAgB,KACzB,MAAM;qBACsC,YAAY,KAAK,MAAM;kBAC1B,SAAS,KAAK,MAAM;iBAEjB,cAAc,KAAK,MAAM;eAC3B,aAAa,KAAK,MAAM;qBAE7D,gBAAgB,KACrB,MAAM;eACoC,aAAa,KAAK,MAAM;iBACtB,cAAc,KAAK,MAAM;iBACzB,cAAc,KAAK,MAAM;mCAEzD,uBAAuB,KACnC,MAAM;CACZ,CAAC"}

package/dist/features/debugDisplay/v.lua

@@ -0,0 +1,63 @@
+local ____exports = {}
+local defaultEntityDisplayCallback, defaultGridEntityDisplayCallback
+local ____entity = require("functions.entity")
+local getEntityID = ____entity.getEntityID
+local ____gridEntity = require("functions.gridEntity")
+local getGridEntityID = ____gridEntity.getGridEntityID
+function defaultEntityDisplayCallback(self, entity)
+    return getEntityID(nil, entity)
+end
+function defaultGridEntityDisplayCallback(self, gridEntity)
+    return getGridEntityID(nil, gridEntity)
+end
+local debugDisplayEnabled = false
+function ____exports.setDebugDisplayEnabled(self)
+    debugDisplayEnabled = true
+end
+function ____exports.errorIfDebugDisplayNotInitialized(self)
+    if not debugDisplayEnabled then
+        error("The \"debugDisplay\" feature is not initialized. You must run the \"enableExtraConsoleCommands\" function once at the beginning of your mod in order for this feature to work.")
+    end
+end
+local v = {run = {
+    player = false,
+    tear = false,
+    familiar = false,
+    bomb = false,
+    pickup = false,
+    slot = false,
+    laser = false,
+    knife = false,
+    projectile = false,
+    effect = false,
+    npc = false,
+    rock = false,
+    pit = false,
+    spikes = false,
+    tnt = false,
+    poop = false,
+    door = false,
+    pressurePlate = false
+}}
+____exports.default = v
+____exports.debugDisplayTextCallbacks = {
+    player = defaultEntityDisplayCallback,
+    tear = defaultEntityDisplayCallback,
+    familiar = defaultEntityDisplayCallback,
+    bomb = defaultEntityDisplayCallback,
+    pickup = defaultEntityDisplayCallback,
+    slot = defaultEntityDisplayCallback,
+    laser = defaultEntityDisplayCallback,
+    knife = defaultEntityDisplayCallback,
+    projectile = defaultEntityDisplayCallback,
+    effect = defaultEntityDisplayCallback,
+    npc = defaultEntityDisplayCallback,
+    rock = defaultGridEntityDisplayCallback,
+    pit = defaultGridEntityDisplayCallback,
+    spikes = defaultGridEntityDisplayCallback,
+    tnt = defaultGridEntityDisplayCallback,
+    poop = defaultGridEntityDisplayCallback,
+    door = defaultGridEntityDisplayCallback,
+    pressurePlate = defaultGridEntityDisplayCallback
+}
+return ____exports

package/dist/features/deployJSONRoom.d.ts

@@ -0,0 +1,67 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+import { JSONRoom } from "../interfaces/JSONRoomsFile";
+/**
+ * Helper function to deconstruct a vanilla room and set up a custom room in its place.
+ * Specifically, this will clear the current room of all entities and grid entities, and then spawn
+ * all of the entries and grid entities in the provided JSON room.
+ *
+ * This function is meant to be used in the PostNewRoom callback.
+ *
+ * For example:
+ *
+ * ```ts
+ *
+ * import customRooms from "./customRooms";
+ *
+ * const firstJSONRoom = customRooms.rooms.room[0];
+ * deployJSONRoom(firstJSONRoom);
+ * ```
+ *
+ * @param jsonRoom The JSON room to deploy. *
+ * @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 declare function deployJSONRoom(jsonRoom: JSONRoom | Readonly<JSONRoom>, seedOrRNG?: Seed | RNG, verbose?: boolean): void;
+/**
+ * Helper function to deconstruct a vanilla room and set up a custom room in its place.
+ * Specifically, this will clear the current room of all entities and grid entities, and then spawn
+ * all of the entries and grid entities in one of the provided JSON rooms.
+ *
+ * This function is meant to be used in the PostNewRoom callback.
+ *
+ * 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
+ *
+ * For example:
+ *
+ * ```ts
+ * import customRooms from "./customRooms";
+ *
+ * const jsonRooms = customRooms.rooms.room;
+ * deployRandomJSONRoom(jsonRooms);
+ * ```
+ *
+ * @param jsonRooms An array of JSON rooms to randomly select from. In practice, this will be
+ *                  something like.
+ * @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 declare function deployRandomJSONRoom(jsonRooms: JSONRoom[] | readonly JSONRoom[], seedOrRNG?: Seed | RNG, verbose?: boolean): void;
+/**
+ * Helper function to remove all naturally spawning entities and grid entities from a room. Notably,
+ * this will not remove players (1), tears (2), familiars (3), lasers (7), knives (8), projectiles
+ * (9), blacklisted NPCs such as Dark Esau, charmed NPCs, friendly NPCs, persistent NPCs, most
+ * effects (1000), doors, and walls.
+ *
+ * @param fillWithDecorations Optional. Set to true to fill every grid tile with an invisible
+ *                            decoration, which prevents vanilla entities in the room from
+ *                            respawning the next time that the player enters. Default is false.
+ */
+export declare function emptyRoom(fillWithDecorations: boolean): void;
+//# sourceMappingURL=deployJSONRoom.d.ts.map

package/dist/features/deployJSONRoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployJSONRoom.d.ts","sourceRoot":"","sources":["../../../../../packages/isaacscript-common/src/features/deployJSONRoom.ts"],"names":[],"mappings":";;AAqDA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAoKvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,EACvC,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,IAAI,CAuBN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,QAAQ,EAAE,EAC3C,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,IAAI,CAaN;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,mBAAmB,EAAE,OAAO,GAAG,IAAI,CAwB5D"}