isaacscript-common 80.2.4 → 81.0.0

package/dist/index.rollup.d.ts

@@ -990,7 +990,7 @@ export declare function anyEasterEggEnabled(exceptions?: SeedEffect[]): boolean;
  */
 export declare type AnyEntity = Entity | EntityBomb | EntityEffect | EntityFamiliar | EntityKnife | EntityLaser | EntityNPC | EntityPickup | EntityPlayer | EntityProjectile | EntityTear;
 
-export declare function anyEntityCloserThan(entities: Entity[], position: Vector, distance: int): boolean;
+export declare function anyEntityCloserThan(entities: Entity[] | readonly Entity[], position: Vector, distance: int): boolean;
 
 /**
  * Helper type to represent any function. This is safer than using the built-in `Function` type, as
@@ -1293,7 +1293,7 @@ export declare const AZAZEL_DEFAULT_BRIMSTONE_DISTANCE = 75.125;
  * @returns An array containing the average time in milliseconds for each function. (This will also
  *          be printed to the log.)
  */
-export declare function benchmark(numTrials: int, ...functions: Array<() => void>): int[];
+export declare function benchmark(numTrials: int, ...functions: Array<() => void>): readonly int[];
 
 /**
  * Helper function for casting a flag enum value to a `BitFlags` object.
@@ -1611,7 +1611,7 @@ export declare function clearRoomDisplayFlags(roomGridIndex: int): void;
  *
  * @allowEmptyVariadic
  */
-export declare function clearSprite(sprite: Sprite, ...layerIDs: int[]): void;
+export declare function clearSprite(sprite: Sprite, ...layerIDs: readonly int[]): void;
 
 /**
  * In a `Map`, you can use the `clear` method to delete every element. However, in a `LuaMap`, the
@@ -1774,7 +1774,7 @@ export declare function convertBinaryToDecimal(bits: int[]): number;
  *                  side until the minimum length is met. Default is undefined (which will not cause
  *                  any padding).
  */
-export declare function convertDecimalToBinary(num: number, minLength?: int): int[];
+export declare function convertDecimalToBinary(num: number, minLength?: int): readonly int[];
 
 /**
  * Helper function to convert the grid entity type found in a room XML file to the corresponding
@@ -4028,7 +4028,7 @@ export declare const DOGMA_ROOM_GRID_INDEX = 109;
 
 export declare const DOOR_HITBOX_RADIUS = 11;
 
-export declare function doorSlotFlagsToDoorSlots(doorSlotFlags: BitFlags<DoorSlotFlag>): DoorSlot[];
+export declare function doorSlotFlagsToDoorSlots(doorSlotFlags: BitFlags<DoorSlotFlag>): readonly DoorSlot[];
 
 export declare function doorSlotFlagToDoorSlot(doorSlotFlag: DoorSlotFlag): DoorSlot;
 
@@ -4364,7 +4364,7 @@ export declare type ERange<Low extends number, High extends number> = Exclude<Na
  *            first argument will be the end.
  * @param increment Optional. The increment to use. Default is 1.
  */
-export declare function eRange(start: int, end?: int, increment?: number): int[];
+export declare function eRange(start: int, end?: int, increment?: number): readonly int[];
 
 declare type ErrorIsaacAPIClassIsNotSerializable = "Error: Isaac API classes (such as e.g. `Entity` or `RoomConfig`) are not serializable. For more information, see: https://isaacscript.github.io/main/gotchas#isaac-api-classes-are-not-serializable";
 
@@ -4554,7 +4554,7 @@ export declare function fillLevelWithRedRooms(): void;
  *
  * Internally, this just calls `array.filter`.
  */
-export declare function filter<T>(array: T[], func: (value: T, index: number, array: T[]) => boolean): T[];
+export declare function filter<T>(array: T[], func: (value: T, index: number, array: T[]) => boolean): readonly T[];
 
 /**
  * Helper function to perform a map and a filter at the same time. Similar to `Array.map`, provide a
@@ -4610,7 +4610,7 @@ declare type FireArgs<T extends ModCallbackCustom> = Parameters<AddCallbackParam
  *                         `ProjectileParams()`.
  * @returns The fired projectile(s).
  */
-export declare function fireProjectiles(npc: EntityNPC | undefined, position: Vector, velocity: Vector, projectilesMode?: ProjectilesMode, projectileParams?: ProjectileParams): EntityProjectile[];
+export declare function fireProjectiles(npc: EntityNPC | undefined, position: Vector, velocity: Vector, projectilesMode?: ProjectilesMode, projectileParams?: ProjectileParams): readonly EntityProjectile[];
 
 /**
  * Helper function to spawn projectiles in a circle around a position. Under the hood, this
@@ -4623,7 +4623,7 @@ export declare function fireProjectiles(npc: EntityNPC | undefined, position: Ve
  * @param numProjectiles The amount of projectiles to spawn.
  * @returns The fired projectile(s).
  */
-export declare function fireProjectilesInCircle(npc: EntityNPC | undefined, position: Vector, speed: float, numProjectiles: int): EntityProjectile[];
+export declare function fireProjectilesInCircle(npc: EntityNPC | undefined, position: Vector, speed: float, numProjectiles: int): readonly EntityProjectile[];
 
 /** Equal to `Card.FOOL`. */
 export declare const FIRST_CARD_TYPE = CardType.FOOL;
@@ -4828,7 +4828,7 @@ declare class GameReorderedCallbacks extends Feature {
  * Helper function to find the active slots that the player has the corresponding collectible type
  * in. Returns an empty array if the player does not have the collectible in any active slot.
  */
-export declare function getActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): ActiveSlot[];
+export declare function getActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): readonly ActiveSlot[];
 
 /**
  * Helper function to get the `PocketItemSlot` that the player's pocket active collectible item is
@@ -4893,7 +4893,7 @@ export declare function getAdjustedPrice(basePrice: int): int;
  *                is -1, which matches every sub-type.
  * @param ignoreFriendly Optional. Default is false.
  */
-export declare function getAliveBosses(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): EntityNPC[];
+export declare function getAliveBosses(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): readonly EntityNPC[];
 
 /**
  * Helper function to get all of the non-dead NPCs in the room.
@@ -4909,7 +4909,7 @@ export declare function getAliveBosses(entityType?: EntityType | -1, variant?: n
  *                -1, which matches every sub-type.
  * @param ignoreFriendly Optional. Default is false.
  */
-export declare function getAliveNPCs(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): EntityNPC[];
+export declare function getAliveNPCs(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): readonly EntityNPC[];
 
 /**
  * Helper function to get the set of every boss in the game (which is derived from the `BossID`
@@ -4938,7 +4938,7 @@ export declare function getAllBossesSet(includeStoryBosses?: boolean): ReadonlyS
  *
  * Under the hood, this uses the `Room.GetGridSize` method.
  */
-export declare function getAllGridIndexes(): int[];
+export declare function getAllGridIndexes(): readonly int[];
 
 /**
  * Helper function to get an array with every non-null pill color. This includes all gold colors and
@@ -4953,7 +4953,7 @@ export declare function getAllPillColors(): readonly PillColor[];
  * This function is almost never what you want to use. For most purposes, use the `getPlayers`
  * helper function instead to get a filtered list of players.
  */
-export declare function getAllPlayers(): EntityPlayer[];
+export declare function getAllPlayers(): readonly EntityPlayer[];
 
 /**
  * Helper function to get the room safe grid index for every room on the entire floor. This includes
@@ -5008,7 +5008,7 @@ export declare function getArrayCombinations<T>(array: T[] | readonly T[], inclu
  * due to implementation details of TypeScriptToLua, this results in an array of 1 through N
  * (instead of an array of 0 through N -1).
  */
-export declare function getArrayIndexes<T>(array: T[] | readonly T[]): int[];
+export declare function getArrayIndexes<T>(array: T[] | readonly T[]): readonly int[];
 
 /**
  * Helper function to get how long Azazel's Brimstone laser should be. You can pass either an
@@ -5024,7 +5024,7 @@ export declare function getAzazelBrimstoneDistance(playerOrTearHeight: EntityPla
  * @param batterySubType Optional. If specified, will only get the batteries that match the
  *                       sub-type. Default is -1, which matches every sub-type.
  */
-export declare function getBatteries(batterySubType?: BatterySubType | -1): EntityPickupBattery[];
+export declare function getBatteries(batterySubType?: BatterySubType | -1): readonly EntityPickupBattery[];
 
 /**
  * Helper function to get the name of a battery, as listed in the "entities2.xml" file. Returns
@@ -5061,7 +5061,7 @@ export declare function getBombName(bombSubType: BombSubType): string;
  * @param bombSubType Optional. If specified, will only get the bombs that match the sub-type.
  *                    Default is -1, which matches every sub-type.
  */
-export declare function getBombPickups(bombSubType?: BombSubType | -1): EntityPickupBomb[];
+export declare function getBombPickups(bombSubType?: BombSubType | -1): readonly EntityPickupBomb[];
 
 /** Helper function to find out how large a bomb explosion is based on the damage inflicted. */
 export declare function getBombRadiusFromDamage(damage: float): float;
@@ -5084,7 +5084,7 @@ export declare function getBombRadiusFromDamage(damage: float): float;
  * @param subType Optional. If specified, will only get the bombs that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getBombs(bombVariant?: BombVariant | -1, subType?: number): EntityBomb[];
+export declare function getBombs(bombVariant?: BombVariant | -1, subType?: number): readonly EntityBomb[];
 
 /**
  * Helper function to safely get boolean values from a Lua table. Will throw an error if the
@@ -5092,7 +5092,7 @@ export declare function getBombs(bombVariant?: BombVariant | -1, subType?: numbe
  *
  * This function is variadic, meaning that you can specify N arguments to get N values.
  */
-export declare function getBooleansFromTable(luaMap: LuaMap<string, unknown>, objectName: string, ...keys: string[]): boolean[];
+export declare function getBooleansFromTable(luaMap: LuaMap<string, unknown>, objectName: string, ...keys: string[]): readonly boolean[];
 
 /**
  * Helper function to get all of the bosses in the room.
@@ -5105,7 +5105,7 @@ export declare function getBooleansFromTable(luaMap: LuaMap<string, unknown>, ob
  *                is -1, which matches every sub-type.
  * @param ignoreFriendly Optional. Default is false.
  */
-export declare function getBosses(entityType?: EntityType, variant?: int, subType?: int, ignoreFriendly?: boolean): EntityNPC[];
+export declare function getBosses(entityType?: EntityType, variant?: int, subType?: int, ignoreFriendly?: boolean): readonly EntityNPC[];
 
 /**
  * Helper function to get the boss ID corresponding to the current room. Returns undefined if the
@@ -5182,7 +5182,7 @@ export declare function getCardName(cardType: CardType): string;
  * @param cardType Optional. If specified, will only get the cards that match the sub-type. Default
  *                 is -1, which matches every sub-type.
  */
-export declare function getCards(cardType?: CardType | -1): EntityPickupCard[];
+export declare function getCards(cardType?: CardType | -1): readonly EntityPickupCard[];
 
 /**
  * Get the final boss of a challenge. This will only work for vanilla challenges.
@@ -5269,7 +5269,7 @@ export declare function getCharacterNamePNGFilePath(character: PlayerType): stri
 export declare function getCharacterPortraitPNGFilePath(character: PlayerType): string;
 
 /** Helper function to get an array containing the characters of all of the current players. */
-export declare function getCharacters(): PlayerType[];
+export declare function getCharacters(): readonly PlayerType[];
 
 /**
  * Helper function to get the path to the sprite for a particular character.
@@ -5325,7 +5325,7 @@ export declare function getChestName(pickupVariant: PickupVariant): string;
  * @param subType Optional. If specified, will only get the chests that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getChests(subType?: number): EntityPickup[];
+export declare function getChests(subType?: number): readonly EntityPickup[];
 
 /**
  * Helper function to get an array of equidistant points on the circumference around a circle.
@@ -5339,7 +5339,7 @@ export declare function getChests(subType?: number): EntityPickup[];
  * @param initialDirection By default, the first point on the circle will be on the top center, but
  *                         this can be optionally changed by specifying this argument.
  */
-export declare function getCircleDiscretizedPoints(centerPos: Vector, radius: float, numPoints: int, xMultiplier?: number, yMultiplier?: number, initialDirection?: Direction): Vector[];
+export declare function getCircleDiscretizedPoints(centerPos: Vector, radius: float, numPoints: int, xMultiplier?: number, yMultiplier?: number, initialDirection?: Direction): ReadonlyArray<Readonly<Vector>>;
 
 /**
  * Given an array of entities, this helper function returns the closest one to a provided reference
@@ -5392,7 +5392,7 @@ export declare function getCoinName(coinSubType: CoinSubType): string;
  * @param coinSubType Optional. If specified, will only get the coins that match the sub-type.
  *                    Default is -1, which matches every sub-type.
  */
-export declare function getCoins(coinSubType?: CoinSubType | -1): EntityPickupCoin[];
+export declare function getCoins(coinSubType?: CoinSubType | -1): readonly EntityPickupCoin[];
 
 /**
  * Helper function to get the corresponding coin amount from a `CoinSubType`. Returns 1 for modded
@@ -5444,7 +5444,8 @@ export declare function getCollectibleGfxFilename(collectibleOrCollectibleType:
  * to an `InitCharge` value of -1. However, in some cases, this may be different. For example,
  * Eden's Soul starts without any charges, so it has an `InitCharge` value of 0.
  *
- * This function returns 0 if the provided collectible type was not valid.
+ * This function returns 0 if the provided collectible type was not valid. This function returns -1
+ * if the provided collectible type was not an active collectible.
  */
 export declare function getCollectibleInitCharge(collectibleOrCollectibleType: EntityPickup | CollectibleType): int;
 
@@ -5489,7 +5490,7 @@ export declare function getCollectibleQuality(collectibleOrCollectibleType: Enti
  * @param collectibleType Optional. If specified, will only get the collectibles that match the
  *                        sub-type. Default is -1, which matches every sub-type.
  */
-export declare function getCollectibles(collectibleType?: CollectibleType | -1): EntityPickupCollectible[];
+export declare function getCollectibles(collectibleType?: CollectibleType | -1): readonly EntityPickupCollectible[];
 
 /**
  * Helper function to get the tags of a collectible (which is the composition of zero or more
@@ -5514,7 +5515,7 @@ export declare function getCollectibleTags(collectibleOrCollectibleType: EntityP
  * Note that this function will not work properly in the `POST_NEW_ROOM` callback since entities do
  * not have collision yet in that callback.
  */
-export declare function getCollidingEntitiesWithGridEntity(gridEntity: GridEntity): Entity[];
+export declare function getCollidingEntitiesWithGridEntity(gridEntity: GridEntity): readonly Entity[];
 
 /**
  * Helper function to get the set of vanilla bosses for a particular stage across all of the stage
@@ -5538,7 +5539,7 @@ export declare function getConstituentsFromGridEntityID(gridEntityID: GridEntity
  * @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
  *                          variant. Default is -1, which matches every variant.
  */
-export declare function getCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant | -1): GridEntity[];
+export declare function getCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant | -1): readonly GridEntity[];
 
 /**
  * Helper function to get the actual bit flag for modded curses.
@@ -5571,7 +5572,7 @@ export declare function getDefaultGlobals(): ReadonlySet<string>;
  * This function will automatically account for Greed Mode. In other words, it will not return the
  * "normal" item pools when playing in Greed Mode.
  */
-export declare function getDefaultItemPoolsForCollectibleType(collectibleType: CollectibleType): ItemPoolType[];
+export declare function getDefaultItemPoolsForCollectibleType(collectibleType: CollectibleType): readonly ItemPoolType[];
 
 /**
  * Returns the starting stat that Isaac (the default character) starts with. For example, if you
@@ -5618,7 +5619,7 @@ export declare function getDoorEnterPosition(door: GridEntityDoor): Readonly<Vec
  *
  * @allowEmptyVariadic
  */
-export declare function getDoors(...roomTypes: RoomType[]): GridEntityDoor[];
+export declare function getDoors(...roomTypes: RoomType[]): readonly GridEntityDoor[];
 
 /**
  * Helper function to get the position that a player will enter a room at corresponding to a door
@@ -5648,7 +5649,7 @@ export declare function getDoorSlotsForRoomShape(roomShape: RoomShape): Readonly
  * This function is variadic, meaning that you can specify N arguments to return all of the doors
  * that match any of the N room grid indexes.
  */
-export declare function getDoorsToRoomIndex(...roomGridIndex: int[]): GridEntityDoor[];
+export declare function getDoorsToRoomIndex(...roomGridIndex: int[]): readonly GridEntityDoor[];
 
 /**
  * Helper function to account for Repentance floors being offset by 1. For example, Downpour 2 is
@@ -5674,13 +5675,13 @@ export declare function getEffectiveStage(): LevelStage;
  * @param subType Optional. If specified, will only get the effects that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getEffects(effectVariant?: EffectVariant | -1, subType?: number): EntityEffect[];
+export declare function getEffects(effectVariant?: EffectVariant | -1, subType?: number): readonly EntityEffect[];
 
 /**
  * Helper function to get an array of temporary effects for a player. This is helpful so that you
  * don't have to manually create an array from an `EffectsList` object.
  */
-export declare function getEffectsList(player: EntityPlayer): TemporaryEffect[];
+export declare function getEffectsList(player: EntityPlayer): readonly TemporaryEffect[];
 
 export declare function getElapsedGameFramesSince(gameFrameCount: int): int;
 
@@ -5727,7 +5728,7 @@ export declare function getElapsedTimeSince(time: int | float, useSocketIfAvaila
  *                       returned. Default is false. Will only be taken into account if the
  *                       `entityType` is specified.
  */
-export declare function getEntities(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): Entity[];
+export declare function getEntities(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): readonly Entity[];
 
 /**
  * Helper function to get all the fields on an entity. For example, this is useful for comparing it
@@ -5762,7 +5763,7 @@ export declare function getEntityIDFromConstituents(entityType: EntityType, vari
  *                 this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
  *                 multiple times.
  */
-export declare function getEntityPositions(entities?: Entity[]): Map<PtrHash, Vector>;
+export declare function getEntityPositions(entities?: Entity[] | readonly Entity[]): Map<PtrHash, Vector>;
 
 export declare function getEntityTypeVariantFromBossID(bossID: BossID): readonly [EntityType, int];
 
@@ -5775,7 +5776,7 @@ export declare function getEntityTypeVariantFromBossID(bossID: BossID): readonly
  *                 this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
  *                 multiple times.
  */
-export declare function getEntityVelocities(entities?: Entity[]): Map<PtrHash, Vector>;
+export declare function getEntityVelocities(entities?: Entity[] | readonly Entity[]): Map<PtrHash, Vector>;
 
 /**
  * TypeScriptToLua will transpile TypeScript number enums to Lua tables that have a double mapping.
@@ -5795,7 +5796,7 @@ export declare function getEntityVelocities(entities?: Entity[]): Map<PtrHash, V
  * For a more in depth explanation, see:
  * https://isaacscript.github.io/main/gotchas#iterating-over-enums
  */
-export declare function getEnumEntries<T extends TranspiledEnum>(transpiledEnum: T): Array<[key: string, value: T[keyof T]]>;
+export declare function getEnumEntries<T extends TranspiledEnum>(transpiledEnum: T): ReadonlyArray<[key: string, value: T[keyof T]]>;
 
 /**
  * TypeScriptToLua will transpile TypeScript number enums to Lua tables that have a double mapping.
@@ -5814,7 +5815,7 @@ export declare function getEnumEntries<T extends TranspiledEnum>(transpiledEnum:
  * For a more in depth explanation, see:
  * https://isaacscript.github.io/main/gotchas#iterating-over-enums
  */
-export declare function getEnumKeys(transpiledEnum: TranspiledEnum): string[];
+export declare function getEnumKeys(transpiledEnum: TranspiledEnum): readonly string[];
 
 /** Helper function to get the amount of entries inside of an enum. */
 export declare function getEnumLength(transpiledEnum: TranspiledEnum): int;
@@ -5836,7 +5837,7 @@ export declare function getEnumLength(transpiledEnum: TranspiledEnum): int;
  * For a more in depth explanation, see:
  * https://isaacscript.github.io/main/gotchas#iterating-over-enums
  */
-export declare function getEnumNames(transpiledEnum: TranspiledEnum): string[];
+export declare function getEnumNames(transpiledEnum: TranspiledEnum): readonly string[];
 
 /**
  * TypeScriptToLua will transpile TypeScript number enums to Lua tables that have a double mapping.
@@ -5855,7 +5856,7 @@ export declare function getEnumNames(transpiledEnum: TranspiledEnum): string[];
  * For a more in depth explanation, see:
  * https://isaacscript.github.io/main/gotchas#iterating-over-enums
  */
-export declare function getEnumValues<T extends TranspiledEnum>(transpiledEnum: T): Array<T[keyof T]>;
+export declare function getEnumValues<T extends TranspiledEnum>(transpiledEnum: T): ReadonlyArray<T[keyof T]>;
 
 /**
  * Helper function to get the associated pill effect after False PHD is acquired. If a pill effect
@@ -5880,13 +5881,13 @@ export declare function getFalsePHDPillEffect(pillEffect: PillEffect): PillEffec
  * @param subType Optional. If specified, will only get the familiars that match the sub-type.
  *                Default is -1, which matches every sub-type.
  */
-export declare function getFamiliars(familiarVariant?: FamiliarVariant | -1, subType?: number): EntityFamiliar[];
+export declare function getFamiliars(familiarVariant?: FamiliarVariant | -1, subType?: number): readonly EntityFamiliar[];
 
 /**
  * Helper function to compare two different arrays of entities. Returns the entities that are in the
  * second array but not in the first array.
  */
-export declare function getFilteredNewEntities<T extends AnyEntity>(oldEntities: T[], newEntities: T[]): T[];
+export declare function getFilteredNewEntities<T extends AnyEntity>(oldEntities: T[] | readonly T[], newEntities: T[] | readonly T[]): readonly T[];
 
 /**
  * Helper function to return the player with the highest ID, according to the `Isaac.GetPlayer`
@@ -5982,7 +5983,7 @@ export declare function getGotoCommand(roomType: RoomType, roomVariant: int, use
  *
  * @allowEmptyVariadic
  */
-export declare function getGridEntities(...gridEntityTypes: GridEntityType[]): GridEntity[];
+export declare function getGridEntities(...gridEntityTypes: GridEntityType[]): readonly GridEntity[];
 
 /**
  * Helper function to get every grid entity in the current room except for certain specific types.
@@ -5990,10 +5991,10 @@ export declare function getGridEntities(...gridEntityTypes: GridEntityType[]): G
  * This function is variadic, meaning that you can specify as many grid entity types as you want to
  * exclude.
  */
-export declare function getGridEntitiesExcept(...gridEntityTypes: GridEntityType[]): GridEntity[];
+export declare function getGridEntitiesExcept(...gridEntityTypes: GridEntityType[]): readonly GridEntity[];
 
 /** Helper function to get all grid entities in a given radius around a given point. */
-export declare function getGridEntitiesInRadius(targetPosition: Vector, radius: number): GridEntity[];
+export declare function getGridEntitiesInRadius(targetPosition: Vector, radius: number): readonly GridEntity[];
 
 /**
  * Helper function to get a map of every grid entity in the current room. The indexes of the map are
@@ -6039,7 +6040,7 @@ export declare function getGridIndexDelta(roomShape: RoomShape, doorSlot: DoorSl
  * This function will throw a run-time error if the two provided grid indexes are not on the same
  * horizontal or vertical line.
  */
-export declare function getGridIndexesBetween(gridIndex1: int, gridIndex2: int, roomShape: RoomShape): int[];
+export declare function getGridIndexesBetween(gridIndex1: int, gridIndex2: int, roomShape: RoomShape): readonly int[];
 
 /**
  * Helper function to get the name of a heart, as listed in the "entities2.xml" file. Returns
@@ -6063,7 +6064,7 @@ export declare function getHeartRowLength(player: EntityPlayer): int;
  * @param heartSubType Optional. If specified, will only get the hearts that match the sub-type.
  *                     Default is -1, which matches every sub-type.
  */
-export declare function getHearts(heartSubType?: HeartSubType | -1): EntityPickupHeart[];
+export declare function getHearts(heartSubType?: HeartSubType | -1): readonly EntityPickupHeart[];
 
 /**
  * Helper function to get the width of the first player's hearts on the UI. This is useful for
@@ -6166,7 +6167,7 @@ export declare function getJSONRoomOfVariant(jsonRooms: JSONRoom[] | readonly JS
  * @param jsonRooms The array of rooms to search through.
  * @param subType The sub-type to match.
  */
-export declare function getJSONRoomsOfSubType(jsonRooms: JSONRoom[] | readonly JSONRoom[], subType: int): JSONRoom[];
+export declare function getJSONRoomsOfSubType(jsonRooms: JSONRoom[] | readonly JSONRoom[], subType: int): readonly JSONRoom[];
 
 /** Helper function to get the value of a specific but in a binary representation of a number. */
 export declare function getKBitOfN(k: int, n: int): int;
@@ -6187,7 +6188,7 @@ export declare function getKeyName(keySubType: KeySubType): string;
  * @param keySubType Optional. If specified, will only get the keys that match the sub-type. Default
  *                   is -1, which matches every sub-type.
  */
-export declare function getKeys(keySubType?: KeySubType | -1): EntityPickupKey[];
+export declare function getKeys(keySubType?: KeySubType | -1): readonly EntityPickupKey[];
 
 /**
  * Helper function to get all of the knives in the room.
@@ -6206,7 +6207,7 @@ export declare function getKeys(keySubType?: KeySubType | -1): EntityPickupKey[]
  * @param subType Optional. If specified, will only get the knives that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getKnives(knifeVariant?: KnifeVariant | -1, subType?: number): EntityKnife[];
+export declare function getKnives(knifeVariant?: KnifeVariant | -1, subType?: number): readonly EntityKnife[];
 
 /**
  * Helper function to convert the language abbreviation from `Options.Language` to the "full"
@@ -6234,7 +6235,7 @@ export declare function getLanguageName(): string;
  * @param subType Optional. If specified, will only get the lasers that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getLasers(laserVariant?: LaserVariant | -1, subType?: number): EntityLaser[];
+export declare function getLasers(laserVariant?: LaserVariant | -1, subType?: number): readonly EntityLaser[];
 
 /**
  * Helper function that returns the number of the final frame in a particular animation for a
@@ -6256,7 +6257,7 @@ export declare function getLastFrameOfAnimation(sprite: Sprite, animation?: stri
  * Note that this will only look at Boss Rooms inside of the grid, so e.g. Reverse Emperor card
  * rooms will not count.
  */
-export declare function getLevelBossIDs(): BossID[];
+export declare function getLevelBossIDs(): readonly BossID[];
 
 /**
  * Helper function to get the English name of the level. For example, "Caves 1".
@@ -6318,7 +6319,7 @@ export declare function getMapPartialMatch<T>(searchText: string, map: ReadonlyM
  *
  * If you want to match every variant, use the `getGridEntities` function instead.
  */
-export declare function getMatchingGridEntities(gridEntityType: GridEntityType, variant: int): GridEntity[];
+export declare function getMatchingGridEntities(gridEntityType: GridEntityType, variant: int): readonly GridEntity[];
 
 /**
  * Helper function to get the door that leads to the Mega Satan Boss Room. (In vanilla, the door
@@ -6333,7 +6334,7 @@ export declare function getMegaSatanDoor(): GridEntityDoor | undefined;
  * pressing down. This returns an array because a player can be holding down more than one movement
  * key at a time.
  */
-export declare function getMoveButtonActions(controllerIndex: ControllerIndex): ButtonAction[];
+export declare function getMoveButtonActions(controllerIndex: ControllerIndex): readonly ButtonAction[];
 
 /**
  * Helper function to get the corresponding music value for a stage and stage type combination.
@@ -6489,7 +6490,7 @@ export declare function getNormalTrinketType(trinketType: TrinketType): TrinketT
  *                       returned. Default is false. Will only be taken into account if the
  *                       `entityType` is specified.
  */
-export declare function getNPCs(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): EntityNPC[];
+export declare function getNPCs(entityType?: EntityType | -1, variant?: number, subType?: number, ignoreFriendly?: boolean): readonly EntityNPC[];
 
 /**
  * Helper function to safely get number values from specific keys on a Lua table. If the values are
@@ -6498,7 +6499,7 @@ export declare function getNPCs(entityType?: EntityType | -1, variant?: number,
  *
  * This function is variadic, meaning that you can specify N arguments to get N values.
  */
-export declare function getNumbersFromTable(luaMap: LuaMap<string, unknown>, objectName: string, ...keys: string[]): number[];
+export declare function getNumbersFromTable(luaMap: LuaMap<string, unknown>, objectName: string, ...keys: string[]): readonly number[];
 
 /** Helper function to get the number of bits in a binary representation of a number. */
 export declare function getNumBitsOfN(n: int): int;
@@ -6556,7 +6557,7 @@ export declare function getOppositeDoorSlot(doorSlot: DoorSlot): DoorSlot | unde
  * Helper function to get all of the other players in the room besides the one provided. (This
  * includes "child" players.)
  */
-export declare function getOtherPlayers(player: EntityPlayer): EntityPlayer[];
+export declare function getOtherPlayers(player: EntityPlayer): readonly EntityPlayer[];
 
 /**
  * Helper function to get the name and the line number of the current calling function.
@@ -6614,7 +6615,7 @@ export declare function getPHDPillEffect(pillEffect: PillEffect): PillEffect;
  * @param subType Optional. If specified, will only get the pickups that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getPickups(pickupVariant?: PickupVariant | -1, subType?: number): EntityPickup[];
+export declare function getPickups(pickupVariant?: PickupVariant | -1, subType?: number): readonly EntityPickup[];
 
 /**
  * Helper function to get the corresponding pill color from an effect by repeatedly using the
@@ -6670,7 +6671,7 @@ export declare function getPillEffectType(pillEffect: PillEffect): ItemConfigPil
  * @param pillColor Optional. If specified, will only get the pills that match the sub-type. Default
  *                  is -1, which matches every sub-type.
  */
-export declare function getPills(pillColor?: PillColor | -1): EntityPickupPill[];
+export declare function getPills(pillColor?: PillColor | -1): readonly EntityPickupPill[];
 
 /**
  * Helper function to get all of the `GridEntityPit` in the room.
@@ -6678,7 +6679,7 @@ export declare function getPills(pillColor?: PillColor | -1): EntityPickupPill[]
  * @param pitVariant Optional. If specified, will only get the pits that match the variant. Default
  *                   is -1, which matches every variant.
  */
-export declare function getPits(pitVariant?: PitVariant | -1): GridEntityPit[];
+export declare function getPits(pitVariant?: PitVariant | -1): readonly GridEntityPit[];
 
 /**
  * Returns the number of slots that the player has remaining for new heart containers, accounting
@@ -6714,7 +6715,7 @@ export declare function getPlayerCloserThan(position: Vector, distance: float):
 export declare function getPlayerCollectibleCount(player: EntityPlayer, ...collectibleTypes: CollectibleType[]): int;
 
 /** Helper function to get only the familiars that belong to a specific player. */
-export declare function getPlayerFamiliars(player: EntityPlayer): EntityFamiliar[];
+export declare function getPlayerFamiliars(player: EntityPlayer): readonly EntityFamiliar[];
 
 /**
  * Helper function to get the player from a tear, laser, bomb, etc. Returns undefined if the entity
@@ -6840,7 +6841,7 @@ export declare function getPlayerNumHitsRemaining(player: EntityPlayer): int;
  * @param performCharacterExclusions Whether to exclude characters that are not directly controlled
  *                                 by the player (i.e. Esau & Tainted Soul). Default is false.
  */
-export declare function getPlayers(performCharacterExclusions?: boolean): EntityPlayer[];
+export declare function getPlayers(performCharacterExclusions?: boolean): readonly EntityPlayer[];
 
 /**
  * Helper function to get all of the players that are a certain character.
@@ -6848,7 +6849,7 @@ export declare function getPlayers(performCharacterExclusions?: boolean): Entity
  * This function is variadic, meaning that you can supply as many characters as you want to check
  * for. Returns true if any of the characters supplied are present.
  */
-export declare function getPlayersOfType(...characters: PlayerType[]): EntityPlayer[];
+export declare function getPlayersOfType(...characters: PlayerType[]): readonly EntityPlayer[];
 
 /**
  * Helper function to get all of the players that are using keyboard (i.e.
@@ -6858,7 +6859,7 @@ export declare function getPlayersOfType(...characters: PlayerType[]): EntityPla
  * Note that this function includes players with a non-undefined parent like e.g. the Strawman
  * Keeper.
  */
-export declare function getPlayersOnKeyboard(): EntityPlayer[];
+export declare function getPlayersOnKeyboard(): readonly EntityPlayer[];
 
 /**
  * Returns the number of soul hearts that the player has, excluding any black hearts. For example,
@@ -6882,7 +6883,7 @@ export declare function getPlayerStats(player: EntityPlayer): PlayerStats;
  * This function is variadic, meaning that you can supply as many collectible types as you want to
  * check for. It only returns the players that have all of the collectibles.
  */
-export declare function getPlayersWithCollectible(...collectibleTypes: CollectibleType[]): EntityPlayer[];
+export declare function getPlayersWithCollectible(...collectibleTypes: CollectibleType[]): readonly EntityPlayer[];
 
 /**
  * Helper function to get all of the players that match the provided controller index. This function
@@ -6892,7 +6893,7 @@ export declare function getPlayersWithCollectible(...collectibleTypes: Collectib
  * Note that this function includes players with a non-undefined parent like e.g. the Strawman
  * Keeper.
  */
-export declare function getPlayersWithControllerIndex(controllerIndex: ControllerIndex): EntityPlayer[];
+export declare function getPlayersWithControllerIndex(controllerIndex: ControllerIndex): readonly EntityPlayer[];
 
 /**
  * Helper function to get only the players that have a certain trinket.
@@ -6900,7 +6901,7 @@ export declare function getPlayersWithControllerIndex(controllerIndex: Controlle
  * This function is variadic, meaning that you can supply as many trinket types as you want to check
  * for. It only returns the players that have all of the trinkets.
  */
-export declare function getPlayersWithTrinket(...trinketTypes: TrinketType[]): EntityPlayer[];
+export declare function getPlayersWithTrinket(...trinketTypes: TrinketType[]): readonly EntityPlayer[];
 
 /** Returns a set of the player's current transformations. */
 export declare function getPlayerTransformations(player: EntityPlayer): Set<PlayerForm>;
@@ -6921,7 +6922,7 @@ export declare function getPlayerTrinkets(player: EntityPlayer): readonly Trinke
  * cannot determine the identity of a particular slot, it will mark the type of the slot as
  * `PocketItemType.UNDETERMINABLE`.
  */
-export declare function getPocketItems(player: EntityPlayer): PocketItemDescription[];
+export declare function getPocketItems(player: EntityPlayer): readonly PocketItemDescription[];
 
 /**
  * Helper function to get all of the `GridEntityPoop` in the room.
@@ -6929,7 +6930,7 @@ export declare function getPocketItems(player: EntityPlayer): PocketItemDescript
  * @param poopVariant Optional. If specified, will only get the poops that match the variant.
  *                    Default is -1, which matches every variant.
  */
-export declare function getPoops(poopVariant?: PoopGridEntityVariant | -1): GridEntityPoop[];
+export declare function getPoops(poopVariant?: PoopGridEntityVariant | -1): readonly GridEntityPoop[];
 
 /**
  * Helper function to get all of the `GridEntityPressurePlate` in the room.
@@ -6937,7 +6938,7 @@ export declare function getPoops(poopVariant?: PoopGridEntityVariant | -1): Grid
  * @param pressurePlateVariant Optional. If specified, will only get the pressure plates that match
  *                             the variant. Default is -1, which matches every variant.
  */
-export declare function getPressurePlates(pressurePlateVariant?: PressurePlateVariant | -1): GridEntityPressurePlate[];
+export declare function getPressurePlates(pressurePlateVariant?: PressurePlateVariant | -1): readonly GridEntityPressurePlate[];
 
 /**
  * Helper function to get all of the projectiles in the room.
@@ -6956,7 +6957,7 @@ export declare function getPressurePlates(pressurePlateVariant?: PressurePlateVa
  * @param subType Optional. If specified, will only get the projectiles that match the sub-type.
  *                Default is -1, which matches every sub-type.
  */
-export declare function getProjectiles(projectileVariant?: ProjectileVariant | -1, subType?: number): EntityProjectile[];
+export declare function getProjectiles(projectileVariant?: ProjectileVariant | -1, subType?: number): readonly EntityProjectile[];
 
 /**
  * Returns a random float between 0 and 1. It is inclusive on the low end, but exclusive on the high
@@ -7232,10 +7233,10 @@ export declare function getRandomVector(seedOrRNG: Seed | RNG | undefined): Read
  * method. This is the best way to see if off-grid rooms have been initialized, since it is possible
  * for mods to insert room data at non-official negative room grid indexes.
  */
-export declare function getReadOnlyRooms(): Array<Readonly<RoomDescriptor>>;
+export declare function getReadOnlyRooms(): ReadonlyArray<Readonly<RoomDescriptor>>;
 
 /** Helper function to get all of the red heart pickup entities in the room. */
-export declare function getRedHearts(): EntityPickupHeart[];
+export declare function getRedHearts(): readonly EntityPickupHeart[];
 
 /**
  * Helper function to get the door that leads to the "secret exit" off-grid room that takes you to
@@ -7302,7 +7303,7 @@ export declare function getRockPNGPath(): string;
  *                `RockVariant` enum, since that only applies to `GridEntityType.ROCK`, and other
  *                types of grid entities can be the `GridEntityRock` class.
  */
-export declare function getRocks(variant?: number): GridEntityRock[];
+export declare function getRocks(variant?: number): readonly GridEntityRock[];
 
 /**
  * Helper function to get the grid indexes of all the rooms connected to the given room index,
@@ -7389,7 +7390,7 @@ export declare function getRoomDescriptorReadOnly(): Readonly<RoomDescriptor>;
  * This function is variadic, meaning that you can specify N arguments to get the combined room
  * descriptors for N room types.
  */
-export declare function getRoomDescriptorsForType(...roomTypes: RoomType[]): RoomDescriptor[];
+export declare function getRoomDescriptorsForType(...roomTypes: RoomType[]): readonly RoomDescriptor[];
 
 /**
  * Helper function to get a particular room's minimap display flags (e.g. whether it is visible and
@@ -7488,7 +7489,7 @@ export declare function getRoomName(roomGridIndex?: int): string | undefined;
  *                                 extra-dimensional rooms are automatically generated. Default is
  *                                 false.
  */
-export declare function getRooms(includeExtraDimensionalRooms?: boolean): RoomDescriptor[];
+export declare function getRooms(includeExtraDimensionalRooms?: boolean): readonly RoomDescriptor[];
 
 /**
  * Helper function to get the shape of the current room as it appears in the STB/XML data.
@@ -7627,7 +7628,7 @@ export declare function getRoomShapeWidth(roomShape: RoomShape): int;
  *                                 extra-dimensional rooms are automatically be generated. Default
  *                                 is false.
  */
-export declare function getRoomsInsideGrid(includeExtraDimensionalRooms?: boolean): RoomDescriptor[];
+export declare function getRoomsInsideGrid(includeExtraDimensionalRooms?: boolean): readonly RoomDescriptor[];
 
 /**
  * Helper function to get the room descriptor for every room on the level in a specific dimension.
@@ -7635,7 +7636,7 @@ export declare function getRoomsInsideGrid(includeExtraDimensionalRooms?: boolea
  *
  * Room descriptors without any data are assumed to be non-existent and are not included.
  */
-export declare function getRoomsOfDimension(dimension: Dimension): RoomDescriptor[];
+export declare function getRoomsOfDimension(dimension: Dimension): readonly RoomDescriptor[];
 
 /**
  * Helper function to get the room descriptor for every room on the level that is outside of the
@@ -7643,7 +7644,7 @@ export declare function getRoomsOfDimension(dimension: Dimension): RoomDescripto
  *
  * Room descriptors without any data are assumed to be non-existent and are not included.
  */
-export declare function getRoomsOutsideGrid(): RoomDescriptor[];
+export declare function getRoomsOutsideGrid(): readonly RoomDescriptor[];
 
 /**
  * Helper function to get the stage ID for the current room as it appears in the STB/XML data.
@@ -7776,7 +7777,7 @@ export declare function getSackName(sackSubType: SackSubType): string;
  * @param sackSubType Optional. If specified, will only get the sacks that match the sub-type.
  *                    Default is -1, which matches every sub-type.
  */
-export declare function getSacks(sackSubType?: SackSubType | -1): EntityPickupSack[];
+export declare function getSacks(sackSubType?: SackSubType | -1): readonly EntityPickupSack[];
 
 export declare function getScreenBottomCenterPos(): Readonly<Vector>;
 
@@ -7799,7 +7800,7 @@ export declare function getScreenTopRightPos(): Readonly<Vector>;
 /**
  * Helper function to get the seed effects (i.e. Easter Eggs) that are enabled for the current run.
  */
-export declare function getSeedEffects(): SeedEffect[];
+export declare function getSeedEffects(): readonly SeedEffect[];
 
 /**
  * Helper function to get all possible combinations of the given set. This includes the combination
@@ -7827,7 +7828,7 @@ export declare function getSetCombinations<T>(set: Set<T> | ReadonlySet<T>, incl
  * pressing down. This returns an array because a player can be holding down more than one shooting
  * key at a time.
  */
-export declare function getShootButtonActions(controllerIndex: ControllerIndex): ButtonAction[];
+export declare function getShootButtonActions(controllerIndex: ControllerIndex): readonly ButtonAction[];
 
 /**
  * Helper function to get the corresponding "Siren Helper" entity for a stolen familiar.
@@ -7870,7 +7871,7 @@ export declare function getSlotName(slotVariant: SlotVariant): string;
  * @param subType Optional. If specified, will only get the slots that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getSlots(slotVariant?: SlotVariant | -1, subType?: number): EntitySlot[];
+export declare function getSlots(slotVariant?: SlotVariant | -1, subType?: number): readonly EntitySlot[];
 
 /**
  * Helper function to get a sorted array based on the contents of a set.
@@ -7881,7 +7882,7 @@ export declare function getSlots(slotVariant?: SlotVariant | -1, subType?: numbe
 export declare function getSortedSetValues<T>(set: Set<T> | ReadonlySet<T>): T[];
 
 /** Helper function to get all of the `GridEntitySpikes` in the room. */
-export declare function getSpikes(variant?: number): GridEntitySpikes[];
+export declare function getSpikes(variant?: number): readonly GridEntitySpikes[];
 
 /** Alias for the `Level.GetStage` method. */
 export declare function getStage(): LevelStage;
@@ -7918,7 +7919,7 @@ export declare function getStartSeedString(): string;
  *
  * This function is variadic, meaning that you can specify N arguments to get N values.
  */
-export declare function getStringsFromTable(luaMap: LuaMap<string, unknown>, objectName: string, ...keys: string[]): string[];
+export declare function getStringsFromTable(luaMap: LuaMap<string, unknown>, objectName: string, ...keys: string[]): readonly string[];
 
 /**
  * Helper function to get a parent `EntityPlayer` object for a given `EntitySubPlayer` object. This
@@ -7933,7 +7934,7 @@ export declare function getSubPlayerParent(subPlayer: EntitySubPlayer): EntityPl
  * For example, if a rock was surrounded by rocks on all sides, this would return an array of 8
  * rocks (e.g. top-left + top + top-right + left + right + bottom-left + bottom + right).
  */
-export declare function getSurroundingGridEntities(gridEntity: GridEntity): GridEntity[];
+export declare function getSurroundingGridEntities(gridEntity: GridEntity): readonly GridEntity[];
 
 /**
  * Helper function to get the grid indexes on the surrounding tiles from the provided grid index.
@@ -7982,7 +7983,7 @@ export declare function getTaintedMagdaleneNonTemporaryMaxHearts(player: EntityP
  * @param subType Optional. If specified, will only get the tears that match the sub-type. Default
  *                is -1, which matches every sub-type.
  */
-export declare function getTears(tearVariant?: TearVariant | -1, subType?: number): EntityTear[];
+export declare function getTears(tearVariant?: TearVariant | -1, subType?: number): readonly EntityTear[];
 
 /**
  * - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` field. This is
@@ -7999,7 +8000,7 @@ export declare function getTearsStat(fireDelay: float): float;
  * @param variant Optional. If specified, will only get the teleporters that match the variant.
  *                Default is -1, which matches every variant.
  */
-export declare function getTeleporters(variant?: number): GridEntity[];
+export declare function getTeleporters(variant?: number): readonly GridEntity[];
 
 /**
  * Helper function to get the current time for benchmarking / profiling purposes.
@@ -8022,7 +8023,7 @@ export declare function getTeleporters(variant?: number): GridEntity[];
 export declare function getTime(useSocketIfAvailable?: boolean): int | float;
 
 /** Helper function to get all of the `GridEntityTNT` in the room. */
-export declare function getTNT(variant?: number): GridEntityTNT[];
+export declare function getTNT(variant?: number): readonly GridEntityTNT[];
 
 /**
  * Helper function to get the top left wall in the current room.
@@ -8090,7 +8091,7 @@ export declare function getTransformationsForCollectibleType(collectibleType: Co
  * @param trapdoorVariant Optional. If specified, will only get the trapdoors that match the
  *                        variant. Default is -1, which matches every variant.
  */
-export declare function getTrapdoors(trapdoorVariant?: TrapdoorVariant | -1): GridEntity[];
+export declare function getTrapdoors(trapdoorVariant?: TrapdoorVariant | -1): readonly GridEntity[];
 
 /**
  * Helper function to log what is happening in functions that recursively move through nested data
@@ -8132,7 +8133,7 @@ export declare function getTrinketName(trinketType: TrinketType): string;
  * @param trinketType Optional. If specified, will only get the trinkets that match the sub-type.
  *                    Default is -1, which matches every sub-type.
  */
-export declare function getTrinkets(trinketType?: TrinketType | -1): EntityPickupTrinket[];
+export declare function getTrinkets(trinketType?: TrinketType | -1): readonly EntityPickupTrinket[];
 
 /**
  * Helper function to get the constructor from an instantiated TypeScriptToLua class, which is
@@ -8158,14 +8159,14 @@ export declare function getTSTLClassName(object: unknown): string | undefined;
  * Helper function to find unused door slots in the current room that can be used to make custom
  * doors.
  */
-export declare function getUnusedDoorSlots(): DoorSlot[];
+export declare function getUnusedDoorSlots(): readonly DoorSlot[];
 
 /**
  * Helper function to find the active slots that the player has the corresponding collectible type
  * in and have enough charge to be used. Returns an empty array if the player does not have the
  * collectible in any active slot or does not have enough charges.
  */
-export declare function getUsableActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): ActiveSlot[];
+export declare function getUsableActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): readonly ActiveSlot[];
 
 /**
  * Returns an array containing every vanilla collectible type with the given quality.
@@ -8819,7 +8820,7 @@ export declare type IRange<Low extends number, High extends number> = Exclude<Na
  *            first argument will be the end.
  * @param increment Optional. The increment to use. Default is 1.
  */
-export declare function iRange(start: int, end?: int, increment?: number): int[];
+export declare function iRange(start: int, end?: int, increment?: number): readonly int[];
 
 /**
  * Helper function to determine if the provided room is equal to `RoomShape.1x2` or `RoomShape.2x1`.
@@ -10900,7 +10901,7 @@ export declare const MAIN_CHARACTERS: readonly [PlayerType.ISAAC, PlayerType.MAG
  *
  * Internally, this just calls `array.map`.
  */
-export declare function map<T, U>(array: T[], func: (value: T, index: number, array: T[]) => U): U[];
+export declare function map<T, U>(array: T[], func: (value: T, index: number, array: T[]) => U): readonly U[];
 
 /**
  * Helper function to make using maps with an type of `PtrHash` easier. Use this instead of the
@@ -15655,7 +15656,7 @@ export declare interface PocketItemDescription {
 }
 
 /** Helper function to see if two sets of pocket item descriptions are identical. */
-export declare function pocketItemsEquals(pocketItems1: PocketItemDescription[], pocketItems2: PocketItemDescription[]): boolean;
+export declare function pocketItemsEquals(pocketItems1: PocketItemDescription[] | readonly PocketItemDescription[], pocketItems2: PocketItemDescription[] | readonly PocketItemDescription[]): boolean;
 
 /** This is used in the various pocket item helper functions. */
 export declare enum PocketItemType {
@@ -16043,7 +16044,7 @@ export declare function removeAllActiveItems(player: EntityPlayer): void;
  * @param cap Optional. If specified, will only remove the given amount of cards.
  * @returns The batteries that were removed.
  */
-export declare function removeAllBatteries(batterySubType?: BatterySubType | -1, cap?: int): EntityPickupBattery[];
+export declare function removeAllBatteries(batterySubType?: BatterySubType | -1, cap?: int): readonly EntityPickupBattery[];
 
 /**
  * Helper function to remove all of the bomb pickups in the room. (Specifically, this refers to bomb
@@ -16054,7 +16055,7 @@ export declare function removeAllBatteries(batterySubType?: BatterySubType | -1,
  * @param cap Optional. If specified, will only remove the given amount of bombs.
  * @returns The bombs that were removed.
  */
-export declare function removeAllBombPickups(bombSubType?: BombSubType | -1, cap?: int): EntityPickupBomb[];
+export declare function removeAllBombPickups(bombSubType?: BombSubType | -1, cap?: int): readonly EntityPickupBomb[];
 
 /**
  * Helper function to remove all of the bombs in the room. (Specifically, this refers to the
@@ -16067,7 +16068,7 @@ export declare function removeAllBombPickups(bombSubType?: BombSubType | -1, cap
  * @param cap Optional. If specified, will only remove the given amount of bombs.
  * @returns An array of the bombs that were removed.
  */
-export declare function removeAllBombs(bombVariant?: BombVariant | -1, subType?: number, cap?: int): EntityBomb[];
+export declare function removeAllBombs(bombVariant?: BombVariant | -1, subType?: number, cap?: int): readonly EntityBomb[];
 
 /**
  * Helper function to remove all of the cards in the room.
@@ -16077,7 +16078,7 @@ export declare function removeAllBombs(bombVariant?: BombVariant | -1, subType?:
  * @param cap Optional. If specified, will only remove the given amount of cards.
  * @returns The cards that were removed.
  */
-export declare function removeAllCards(cardType?: CardType | -1, cap?: int): EntityPickupCard[];
+export declare function removeAllCards(cardType?: CardType | -1, cap?: int): readonly EntityPickupCard[];
 
 export declare function removeAllCharacters(string: string, character: string): string;
 
@@ -16090,7 +16091,7 @@ export declare function removeAllCharacters(string: string, character: string):
  * @param cap Optional. If specified, will only remove the given amount of chests.
  * @returns The chests that were removed.
  */
-export declare function removeAllChests(subType?: number, cap?: int): EntityPickup[];
+export declare function removeAllChests(subType?: number, cap?: int): readonly EntityPickup[];
 
 /**
  * Helper function to remove all of the coins in the room.
@@ -16100,7 +16101,7 @@ export declare function removeAllChests(subType?: number, cap?: int): EntityPick
  * @param cap Optional. If specified, will only remove the given amount of coins.
  * @returns The coins that were removed.
  */
-export declare function removeAllCoins(coinSubType?: CoinSubType, cap?: int): EntityPickupCoin[];
+export declare function removeAllCoins(coinSubType?: CoinSubType, cap?: int): readonly EntityPickupCoin[];
 
 /**
  * Helper function to remove all of the collectibles in the room.
@@ -16110,7 +16111,7 @@ export declare function removeAllCoins(coinSubType?: CoinSubType, cap?: int): En
  * @param cap Optional. If specified, will only remove the given amount of collectibles.
  * @returns The collectibles that were removed.
  */
-export declare function removeAllCollectibles(collectibleType?: CollectibleType, cap?: int): EntityPickupCollectible[];
+export declare function removeAllCollectibles(collectibleType?: CollectibleType, cap?: int): readonly EntityPickupCollectible[];
 
 /**
  * Helper function to remove all of the `GridEntityType.CRAWL_SPACE` (18) in the room.
@@ -16123,7 +16124,7 @@ export declare function removeAllCollectibles(collectibleType?: CollectibleType,
  * @param cap Optional. If specified, will only remove the given amount of crawl spaces.
  * @returns The crawl spaces that were removed.
  */
-export declare function removeAllCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant | -1, updateRoom?: boolean, cap?: int): GridEntity[];
+export declare function removeAllCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant | -1, updateRoom?: boolean, cap?: int): readonly GridEntity[];
 
 /**
  * Helper function to remove all of the doors in the room. By default, it will remove every door.
@@ -16145,7 +16146,7 @@ export declare function removeAllDoors(...roomTypes: RoomType[]): int;
  * @param cap Optional. If specified, will only remove the given amount of effects.
  * @returns An array of the effects that were removed.
  */
-export declare function removeAllEffects(effectVariant?: EffectVariant | -1, subType?: number, cap?: int): EntityEffect[];
+export declare function removeAllEffects(effectVariant?: EffectVariant | -1, subType?: number, cap?: int): readonly EntityEffect[];
 
 /**
  * Helper function to remove all of the familiars in the room.
@@ -16157,7 +16158,7 @@ export declare function removeAllEffects(effectVariant?: EffectVariant | -1, sub
  * @param cap Optional. If specified, will only remove the given amount of familiars.
  * @returns An array of the familiars that were removed.
  */
-export declare function removeAllFamiliars(familiarVariant?: FamiliarVariant | -1, subType?: number, cap?: int): EntityFamiliar[];
+export declare function removeAllFamiliars(familiarVariant?: FamiliarVariant | -1, subType?: number, cap?: int): readonly EntityFamiliar[];
 
 /**
  * Helper function to all grid entities in the room except for ones matching the grid entity types
@@ -16177,7 +16178,7 @@ export declare function removeAllFamiliars(familiarVariant?: FamiliarVariant | -
  *
  * @returns The grid entities that were removed.
  */
-export declare function removeAllGridEntitiesExcept(...gridEntityTypes: GridEntityType[]): GridEntity[];
+export declare function removeAllGridEntitiesExcept(...gridEntityTypes: GridEntityType[]): readonly GridEntity[];
 
 /**
  * Helper function to remove all of the heart pickup entities in the room.
@@ -16187,7 +16188,7 @@ export declare function removeAllGridEntitiesExcept(...gridEntityTypes: GridEnti
  * @param cap Optional. If specified, will only remove the given amount of hearts.
  * @returns The hearts that were removed.
  */
-export declare function removeAllHearts(heartSubType?: HeartSubType, cap?: int): EntityPickupHeart[];
+export declare function removeAllHearts(heartSubType?: HeartSubType, cap?: int): readonly EntityPickupHeart[];
 
 /**
  * Helper function to remove all of the keys in the room.
@@ -16197,7 +16198,7 @@ export declare function removeAllHearts(heartSubType?: HeartSubType, cap?: int):
  * @param cap Optional. If specified, will only remove the given amount of keys.
  * @returns The keys that were removed.
  */
-export declare function removeAllKeys(keySubType?: KeySubType, cap?: int): EntityPickupKey[];
+export declare function removeAllKeys(keySubType?: KeySubType, cap?: int): readonly EntityPickupKey[];
 
 /**
  * Helper function to remove all of the knives in the room.
@@ -16209,7 +16210,7 @@ export declare function removeAllKeys(keySubType?: KeySubType, cap?: int): Entit
  * @param cap Optional. If specified, will only remove the given amount of knives.
  * @returns An array of the knives that were removed.
  */
-export declare function removeAllKnives(knifeVariant?: KnifeVariant | -1, subType?: number, cap?: int): EntityKnife[];
+export declare function removeAllKnives(knifeVariant?: KnifeVariant | -1, subType?: number, cap?: int): readonly EntityKnife[];
 
 /**
  * Helper function to remove all of the lasers in the room.
@@ -16221,7 +16222,7 @@ export declare function removeAllKnives(knifeVariant?: KnifeVariant | -1, subTyp
  * @param cap Optional. If specified, will only remove the given amount of lasers.
  * @returns An array of the lasers that were removed.
  */
-export declare function removeAllLasers(laserVariant?: LaserVariant | -1, subType?: number, cap?: int): EntityLaser[];
+export declare function removeAllLasers(laserVariant?: LaserVariant | -1, subType?: number, cap?: int): readonly EntityLaser[];
 
 /**
  * Helper function to remove all of the matching entities in the room.
@@ -16233,7 +16234,7 @@ export declare function removeAllLasers(laserVariant?: LaserVariant | -1, subTyp
  * @param cap Optional. If specified, will only remove the given amount of collectibles.
  * @returns An array of the entities that were removed.
  */
-export declare function removeAllMatchingEntities(entityType: EntityType, entityVariant?: number, entitySubType?: number, cap?: int | undefined): Entity[];
+export declare function removeAllMatchingEntities(entityType: EntityType, entityVariant?: number, entitySubType?: number, cap?: int | undefined): readonly Entity[];
 
 /**
  * Helper function to remove all of the grid entities in the room that match the grid entity types
@@ -16254,7 +16255,7 @@ export declare function removeAllMatchingEntities(entityType: EntityType, entity
  *
  * @returns An array of the grid entities removed.
  */
-export declare function removeAllMatchingGridEntities(...gridEntityType: GridEntityType[]): GridEntity[];
+export declare function removeAllMatchingGridEntities(...gridEntityType: GridEntityType[]): readonly GridEntity[];
 
 /**
  * Helper function to remove all of the NPCs in the room.
@@ -16268,7 +16269,7 @@ export declare function removeAllMatchingGridEntities(...gridEntityType: GridEnt
  * @param cap Optional. If specified, will only remove the given amount of NPCs.
  * @returns An array of the NPCs that were removed.
  */
-export declare function removeAllNPCs(entityType?: EntityType | -1, variant?: number, subType?: number, cap?: int): EntityNPC[];
+export declare function removeAllNPCs(entityType?: EntityType | -1, variant?: number, subType?: number, cap?: int): readonly EntityNPC[];
 
 /**
  * Helper function to remove all of the pickups in the room.
@@ -16280,7 +16281,7 @@ export declare function removeAllNPCs(entityType?: EntityType | -1, variant?: nu
  * @param cap Optional. If specified, will only remove the given amount of pickups.
  * @returns An array of the pickups that were removed.
  */
-export declare function removeAllPickups(pickupVariant?: PickupVariant | -1, subType?: number, cap?: int): EntityPickup[];
+export declare function removeAllPickups(pickupVariant?: PickupVariant | -1, subType?: number, cap?: int): readonly EntityPickup[];
 
 /**
  * Helper function to remove all of the pills in the room.
@@ -16290,7 +16291,7 @@ export declare function removeAllPickups(pickupVariant?: PickupVariant | -1, sub
  * @param cap Optional. If specified, will only remove the given amount of pills.
  * @returns The pills that were removed.
  */
-export declare function removeAllPills(pillColor?: PillColor, cap?: int): EntityPickupPill[];
+export declare function removeAllPills(pillColor?: PillColor, cap?: int): readonly EntityPickupPill[];
 
 /**
  * Helper function to remove all of the `GridEntityPit` in the room.
@@ -16303,7 +16304,7 @@ export declare function removeAllPills(pillColor?: PillColor, cap?: int): Entity
  * @param cap Optional. If specified, will only remove the given amount of pits.
  * @returns The pits that were removed.
  */
-export declare function removeAllPits(pitVariant?: PitVariant | -1, updateRoom?: boolean, cap?: int): GridEntityPit[];
+export declare function removeAllPits(pitVariant?: PitVariant | -1, updateRoom?: boolean, cap?: int): readonly GridEntityPit[];
 
 export declare function removeAllPlayerHealth(player: EntityPlayer): void;
 
@@ -16329,7 +16330,7 @@ export declare function removeAllPlayerTrinkets(player: EntityPlayer): void;
  * @param cap Optional. If specified, will only remove the given amount of poops.
  * @returns The poops that were removed.
  */
-export declare function removeAllPoops(poopVariant?: PoopGridEntityVariant | -1, updateRoom?: boolean, cap?: int): GridEntityPoop[];
+export declare function removeAllPoops(poopVariant?: PoopGridEntityVariant | -1, updateRoom?: boolean, cap?: int): readonly GridEntityPoop[];
 
 /**
  * Helper function to remove all of the `GridEntityPressurePlate` in the room.
@@ -16342,7 +16343,7 @@ export declare function removeAllPoops(poopVariant?: PoopGridEntityVariant | -1,
  * @param cap Optional. If specified, will only remove the given amount of pressure plates.
  * @returns The pressure plates that were removed.
  */
-export declare function removeAllPressurePlates(pressurePlateVariant?: PressurePlateVariant | -1, updateRoom?: boolean, cap?: int): GridEntityPressurePlate[];
+export declare function removeAllPressurePlates(pressurePlateVariant?: PressurePlateVariant | -1, updateRoom?: boolean, cap?: int): readonly GridEntityPressurePlate[];
 
 /**
  * Helper function to remove all of the projectiles in the room.
@@ -16354,7 +16355,7 @@ export declare function removeAllPressurePlates(pressurePlateVariant?: PressureP
  * @param cap Optional. If specified, will only remove the given amount of projectiles.
  * @returns An array of the projectiles that were removed.
  */
-export declare function removeAllProjectiles(projectileVariant?: ProjectileVariant | -1, subType?: number, cap?: int): EntityProjectile[];
+export declare function removeAllProjectiles(projectileVariant?: ProjectileVariant | -1, subType?: number, cap?: int): readonly EntityProjectile[];
 
 /**
  * Helper function to remove all of the red heart pickup entities in the room.
@@ -16362,7 +16363,7 @@ export declare function removeAllProjectiles(projectileVariant?: ProjectileVaria
  * @param cap Optional. If specified, will only remove the given amount of hearts.
  * @returns The red hearts that were removed.
  */
-export declare function removeAllRedHearts(cap?: int): EntityPickupHeart[];
+export declare function removeAllRedHearts(cap?: int): readonly EntityPickupHeart[];
 
 /**
  * Helper function to remove all of the `GridEntityRock` in the room.
@@ -16377,7 +16378,7 @@ export declare function removeAllRedHearts(cap?: int): EntityPickupHeart[];
  * @param cap Optional. If specified, will only remove the given amount of rocks.
  * @returns The rocks that were removed.
  */
-export declare function removeAllRocks(variant?: number, updateRoom?: boolean, cap?: int): GridEntityRock[];
+export declare function removeAllRocks(variant?: number, updateRoom?: boolean, cap?: int): readonly GridEntityRock[];
 
 /**
  * Helper function to remove all of the sacks (i.e. grab bags) in the room.
@@ -16387,7 +16388,7 @@ export declare function removeAllRocks(variant?: number, updateRoom?: boolean, c
  * @param cap Optional. If specified, will only remove the given amount of sacks.
  * @returns The sacks that were removed.
  */
-export declare function removeAllSacks(sackSubType?: SackSubType, cap?: int): EntityPickupSack[];
+export declare function removeAllSacks(sackSubType?: SackSubType, cap?: int): readonly EntityPickupSack[];
 
 /**
  * Helper function to remove all of the slots in the room.
@@ -16399,7 +16400,7 @@ export declare function removeAllSacks(sackSubType?: SackSubType, cap?: int): En
  * @param cap Optional. If specified, will only remove the given amount of slots.
  * @returns An array of the slots that were removed.
  */
-export declare function removeAllSlots(slotVariant?: SlotVariant | -1, subType?: number, cap?: int): Entity[];
+export declare function removeAllSlots(slotVariant?: SlotVariant | -1, subType?: number, cap?: int): readonly Entity[];
 
 /**
  * Helper function to remove all of the `GridEntitySpikes` in the room.
@@ -16412,7 +16413,7 @@ export declare function removeAllSlots(slotVariant?: SlotVariant | -1, subType?:
  * @param cap Optional. If specified, will only remove the given amount of spikes.
  * @returns The spikes that were removed.
  */
-export declare function removeAllSpikes(variant?: number, updateRoom?: boolean, cap?: int): GridEntitySpikes[];
+export declare function removeAllSpikes(variant?: number, updateRoom?: boolean, cap?: int): readonly GridEntitySpikes[];
 
 /**
  * Helper function to remove all of the tears in the room.
@@ -16424,7 +16425,7 @@ export declare function removeAllSpikes(variant?: number, updateRoom?: boolean,
  * @param cap Optional. If specified, will only remove the given amount of tears.
  * @returns An array of the tears that were removed.
  */
-export declare function removeAllTears(tearVariant?: TearVariant | -1, subType?: number, cap?: int): EntityTear[];
+export declare function removeAllTears(tearVariant?: TearVariant | -1, subType?: number, cap?: int): readonly EntityTear[];
 
 /**
  * Helper function to remove all of the `GridEntityType.TELEPORTER` (23) in the room.
@@ -16437,7 +16438,7 @@ export declare function removeAllTears(tearVariant?: TearVariant | -1, subType?:
  * @param cap Optional. If specified, will only remove the given amount of teleporters.
  * @returns The teleporters that were removed.
  */
-export declare function removeAllTeleporters(variant?: number, updateRoom?: boolean, cap?: int): GridEntity[];
+export declare function removeAllTeleporters(variant?: number, updateRoom?: boolean, cap?: int): readonly GridEntity[];
 
 /**
  * Helper function to remove all of the `GridEntityTNT` in the room.
@@ -16450,7 +16451,7 @@ export declare function removeAllTeleporters(variant?: number, updateRoom?: bool
  * @param cap Optional. If specified, will only remove the given amount of TNTs.
  * @returns The TNTs that were removed.
  */
-export declare function removeAllTNT(variant?: number, updateRoom?: boolean, cap?: int): GridEntityTNT[];
+export declare function removeAllTNT(variant?: number, updateRoom?: boolean, cap?: int): readonly GridEntityTNT[];
 
 /**
  * Helper function to remove all of the `GridEntityType.TRAPDOOR` (17) in the room.
@@ -16463,7 +16464,7 @@ export declare function removeAllTNT(variant?: number, updateRoom?: boolean, cap
  * @param cap Optional. If specified, will only remove the given amount of trapdoors.
  * @returns The trapdoors that were removed.
  */
-export declare function removeAllTrapdoors(trapdoorVariant?: TrapdoorVariant | -1, updateRoom?: boolean, cap?: int): GridEntity[];
+export declare function removeAllTrapdoors(trapdoorVariant?: TrapdoorVariant | -1, updateRoom?: boolean, cap?: int): readonly GridEntity[];
 
 /**
  * Helper function to remove all of the trinkets in the room.
@@ -16473,7 +16474,7 @@ export declare function removeAllTrapdoors(trapdoorVariant?: TrapdoorVariant | -
  * @param cap Optional. If specified, will only remove the given amount of trinkets.
  * @returns The trinkets that were removed.
  */
-export declare function removeAllTrinkets(trinketType?: TrinketType, cap?: int): EntityPickupTrinket[];
+export declare function removeAllTrinkets(trinketType?: TrinketType, cap?: int): readonly EntityPickupTrinket[];
 
 /**
  * Helper function to remove all of the characters in a string before a given substring. Returns the
@@ -16542,7 +16543,7 @@ export declare function removeDoors(...doors: GridEntityDoor[]): void;
  * @param cap Optional. If specified, will only remove the given amount of entities.
  * @returns An array of the entities that were removed.
  */
-export declare function removeEntities<T extends AnyEntity>(entities: T[], cap?: int): T[];
+export declare function removeEntities<T extends AnyEntity>(entities: T[] | readonly T[], cap?: int): readonly T[];
 
 /**
  * Helper function to remove all entities that just spawned from a grid entity breaking.
@@ -16551,7 +16552,7 @@ export declare function removeEntities<T extends AnyEntity>(entities: T[], cap?:
  *
  * You must specify an array of entities to look through.
  */
-export declare function removeEntitiesSpawnedFromGridEntity(entities: Entity[], gridEntity: GridEntity): void;
+export declare function removeEntitiesSpawnedFromGridEntity(entities: Entity[] | readonly Entity[], gridEntity: GridEntity): void;
 
 /**
  * Helper function to remove a bit flag from an existing set of bit flags.
@@ -16584,7 +16585,7 @@ export declare function removeFlag<T extends BitFlag | BitFlag128>(flags: T | Bi
  * @param cap Optional. If specified, will only remove the given amount of entities.
  * @returns An array of the entities that were removed.
  */
-export declare function removeGridEntities<T extends AnyGridEntity>(gridEntities: T[], updateRoom: boolean, cap?: int): T[];
+export declare function removeGridEntities<T extends AnyGridEntity>(gridEntities: T[] | readonly T[], updateRoom: boolean, cap?: int): readonly T[];
 
 /**
  * Helper function to remove a grid entity by providing the grid entity object or the grid index
@@ -17707,7 +17708,7 @@ export declare function setEntityOpacity(entity: Entity, alpha: float): void;
  *                 this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
  *                 multiple times.
  */
-export declare function setEntityPositions(entityPositions: Map<PtrHash, Vector>, entities?: Entity[]): void;
+export declare function setEntityPositions(entityPositions: Map<PtrHash, Vector>, entities?: Entity[] | readonly Entity[]): void;
 
 export declare function setEntityRandomColor(entity: Entity): void;
 
@@ -17724,7 +17725,7 @@ export declare function setEntityRandomColor(entity: Entity): void;
  *                 this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
  *                 multiple times.
  */
-export declare function setEntityVelocities(entityVelocities: Map<PtrHash, Vector>, entities?: Entity[]): void;
+export declare function setEntityVelocities(entityVelocities: Map<PtrHash, Vector>, entities?: Entity[] | readonly Entity[]): void;
 
 /**
  * Helper function to set the minimap `DisplayFlag` value for multiple rooms at once.
@@ -18660,7 +18661,7 @@ export declare function spawnWithSeed(entityType: EntityType, variant: int, subT
  * @param startAtZero Whether to start at 0. Defaults to false. If true, the chunks will start at 0
  *                    instead of 1.
  */
-export declare function splitNumber(num: int, size: int, startAtZero?: boolean): Array<[min: int, max: int]>;
+export declare function splitNumber(num: int, size: int, startAtZero?: boolean): ReadonlyArray<readonly [min: int, max: int]>;
 
 /**
  * Helper function to check if two sprite layers have the same sprite sheet by using the