isaacscript-common 87.6.2 → 87.8.0

package/dist/maps/entityTypeVariantToBossIDMap.lua

@@ -17,7 +17,7 @@ ____exports.ENTITY_TYPE_VARIANT_TO_BOSS_ID_MAP = __TS__New(
             bossIDRaw = ____bindingPattern0[1]
             entityTypeVariant = ____bindingPattern0[2]
             local bossID = bossIDRaw
-            local entityType, variant = table.unpack(entityTypeVariant)
+            local entityType, variant = table.unpack(entityTypeVariant, 1, 2)
             local entityTypeVariantString = (tostring(entityType) .. ".") .. tostring(variant)
             return {entityTypeVariantString, bossID}
         end

package/dist/shouldFire.lua

@@ -1,153 +1,153 @@
 local ____exports = {}
 function ____exports.shouldFireAmbush(self, fireArgs, optionalArgs)
-    local ambushType = table.unpack(fireArgs)
-    local callbackAmbushType = table.unpack(optionalArgs)
+    local ambushType = table.unpack(fireArgs, 1, 1)
+    local callbackAmbushType = table.unpack(optionalArgs, 1, 1)
     return callbackAmbushType == nil or callbackAmbushType == ambushType
 end
 function ____exports.shouldFireBomb(self, fireArgs, optionalArgs)
-    local bomb = table.unpack(fireArgs)
-    local callbackBombVariant, callbackSubType = table.unpack(optionalArgs)
+    local bomb = table.unpack(fireArgs, 1, 1)
+    local callbackBombVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackBombVariant == nil or callbackBombVariant == bomb.Variant) and (callbackSubType == nil or callbackSubType == bomb.SubType)
 end
 function ____exports.shouldFireBoolean(self, fireArgs, optionalArgs)
-    local fireArg = table.unpack(fireArgs)
-    local optionalArg = table.unpack(optionalArgs)
+    local fireArg = table.unpack(fireArgs, 1, 1)
+    local optionalArg = table.unpack(optionalArgs, 1, 1)
     return optionalArg == nil or optionalArg == fireArg
 end
 function ____exports.shouldFireCollectibleType(self, fireArgs, optionalArgs)
-    local _player, collectibleType = table.unpack(fireArgs)
-    local callbackCollectibleType = table.unpack(optionalArgs)
+    local _player, collectibleType = table.unpack(fireArgs, 1, 2)
+    local callbackCollectibleType = table.unpack(optionalArgs, 1, 1)
     return callbackCollectibleType == nil or callbackCollectibleType == collectibleType
 end
 function ____exports.shouldFireDoor(self, fireArgs, optionalArgs)
-    local door = table.unpack(fireArgs)
-    local callbackDoorVariant = table.unpack(optionalArgs)
+    local door = table.unpack(fireArgs, 1, 1)
+    local callbackDoorVariant = table.unpack(optionalArgs, 1, 1)
     local doorVariant = door:GetVariant()
     return callbackDoorVariant == nil or callbackDoorVariant == doorVariant
 end
 function ____exports.shouldFireEffect(self, fireArgs, optionalArgs)
-    local effect = table.unpack(fireArgs)
-    local callbackEffectVariant, callbackSubType = table.unpack(optionalArgs)
+    local effect = table.unpack(fireArgs, 1, 1)
+    local callbackEffectVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackEffectVariant == nil or callbackEffectVariant == effect.Variant) and (callbackSubType == nil or callbackSubType == effect.SubType)
 end
 function ____exports.shouldFireEntity(self, fireArgs, optionalArgs)
-    local entity = table.unpack(fireArgs)
-    local callbackEntityType, callbackVariant, callbackSubType = table.unpack(optionalArgs)
+    local entity = table.unpack(fireArgs, 1, 1)
+    local callbackEntityType, callbackVariant, callbackSubType = table.unpack(optionalArgs, 1, 3)
     return (callbackEntityType == nil or callbackEntityType == entity.Type) and (callbackVariant == nil or callbackVariant == entity.Variant) and (callbackSubType == nil or callbackSubType == entity.SubType)
 end
 function ____exports.shouldFireFamiliar(self, fireArgs, optionalArgs)
-    local familiar = table.unpack(fireArgs)
-    local callbackFamiliarVariant, callbackSubType = table.unpack(optionalArgs)
+    local familiar = table.unpack(fireArgs, 1, 1)
+    local callbackFamiliarVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackFamiliarVariant == nil or callbackFamiliarVariant == familiar.Variant) and (callbackSubType == nil or callbackSubType == familiar.SubType)
 end
 function ____exports.shouldFireGridEntity(self, fireArgs, optionalArgs)
-    local gridEntity = table.unpack(fireArgs)
-    local callbackGridEntityType, callbackVariant = table.unpack(optionalArgs)
+    local gridEntity = table.unpack(fireArgs, 1, 1)
+    local callbackGridEntityType, callbackVariant = table.unpack(optionalArgs, 1, 2)
     local gridEntityType = gridEntity:GetType()
     local variant = gridEntity:GetVariant()
     return (callbackGridEntityType == nil or callbackGridEntityType == gridEntityType) and (callbackVariant == nil or callbackVariant == variant)
 end
 function ____exports.shouldFireGridEntityCustom(self, fireArgs, optionalArgs)
-    local _gridEntity, gridEntityTypeCustom = table.unpack(fireArgs)
-    local callbackGridEntityTypeCustom = table.unpack(optionalArgs)
+    local _gridEntity, gridEntityTypeCustom = table.unpack(fireArgs, 1, 2)
+    local callbackGridEntityTypeCustom = table.unpack(optionalArgs, 1, 1)
     return callbackGridEntityTypeCustom == nil or callbackGridEntityTypeCustom == gridEntityTypeCustom
 end
 function ____exports.shouldFireItemPickup(self, fireArgs, optionalArgs)
-    local _player, pickingUpItem = table.unpack(fireArgs)
-    local callbackItemType, callbackSubtype = table.unpack(optionalArgs)
+    local _player, pickingUpItem = table.unpack(fireArgs, 1, 2)
+    local callbackItemType, callbackSubtype = table.unpack(optionalArgs, 1, 2)
     return (callbackItemType == nil or callbackItemType == pickingUpItem.itemType) and (callbackSubtype == nil or callbackSubtype == pickingUpItem.subType)
 end
 function ____exports.shouldFireKnife(self, fireArgs, optionalArgs)
-    local knife = table.unpack(fireArgs)
-    local callbackKnifeVariant, callbackSubType = table.unpack(optionalArgs)
+    local knife = table.unpack(fireArgs, 1, 1)
+    local callbackKnifeVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackKnifeVariant == nil or callbackKnifeVariant == knife.Variant) and (callbackSubType == nil or callbackSubType == knife.SubType)
 end
 function ____exports.shouldFireLaser(self, fireArgs, optionalArgs)
-    local laser = table.unpack(fireArgs)
-    local callbackLaserVariant, callbackSubType = table.unpack(optionalArgs)
+    local laser = table.unpack(fireArgs, 1, 1)
+    local callbackLaserVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackLaserVariant == nil or callbackLaserVariant == laser.Variant) and (callbackSubType == nil or callbackSubType == laser.SubType)
 end
 function ____exports.shouldFireLevel(self, fireArgs, optionalArgs)
-    local stage, stageType = table.unpack(fireArgs)
-    local callbackStage, callbackStageType = table.unpack(optionalArgs)
+    local stage, stageType = table.unpack(fireArgs, 1, 2)
+    local callbackStage, callbackStageType = table.unpack(optionalArgs, 1, 2)
     return (callbackStage == nil or callbackStage == stage) and (callbackStageType == nil or callbackStageType == stageType)
 end
 function ____exports.shouldFireNPC(self, fireArgs, optionalArgs)
-    local npc = table.unpack(fireArgs)
-    local callbackEntityType, callbackVariant, callbackSubType = table.unpack(optionalArgs)
+    local npc = table.unpack(fireArgs, 1, 1)
+    local callbackEntityType, callbackVariant, callbackSubType = table.unpack(optionalArgs, 1, 3)
     return (callbackEntityType == nil or callbackEntityType == npc.Type) and (callbackVariant == nil or callbackVariant == npc.Variant) and (callbackSubType == nil or callbackSubType == npc.SubType)
 end
 function ____exports.shouldFirePickup(self, fireArgs, optionalArgs)
-    local pickup = table.unpack(fireArgs)
-    local callbackPickupVariant, callbackPickupSubType = table.unpack(optionalArgs)
+    local pickup = table.unpack(fireArgs, 1, 1)
+    local callbackPickupVariant, callbackPickupSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackPickupVariant == nil or callbackPickupVariant == pickup.Variant) and (callbackPickupSubType == nil or callbackPickupSubType == pickup.SubType)
 end
 function ____exports.shouldFirePit(self, fireArgs, optionalArgs)
-    local pit = table.unpack(fireArgs)
-    local callbackPitVariant = table.unpack(optionalArgs)
+    local pit = table.unpack(fireArgs, 1, 1)
+    local callbackPitVariant = table.unpack(optionalArgs, 1, 1)
     local pitVariant = pit:GetVariant()
     return callbackPitVariant == nil or callbackPitVariant == pitVariant
 end
 function ____exports.shouldFirePlayer(self, fireArgs, optionalArgs)
-    local player = table.unpack(fireArgs)
-    local callbackPlayerVariant, callbackCharacter = table.unpack(optionalArgs)
+    local player = table.unpack(fireArgs, 1, 1)
+    local callbackPlayerVariant, callbackCharacter = table.unpack(optionalArgs, 1, 2)
     local character = player:GetPlayerType()
     return (callbackPlayerVariant == nil or callbackPlayerVariant == player.Variant) and (callbackCharacter == nil or callbackCharacter == character)
 end
 function ____exports.shouldFirePoop(self, fireArgs, optionalArgs)
-    local poop = table.unpack(fireArgs)
-    local callbackPoopGridEntityVariant = table.unpack(optionalArgs)
+    local poop = table.unpack(fireArgs, 1, 1)
+    local callbackPoopGridEntityVariant = table.unpack(optionalArgs, 1, 1)
     local poopGridEntityVariant = poop:GetVariant()
     return callbackPoopGridEntityVariant == nil or callbackPoopGridEntityVariant == poopGridEntityVariant
 end
 function ____exports.shouldFirePressurePlate(self, fireArgs, optionalArgs)
-    local pressurePlate = table.unpack(fireArgs)
-    local callbackPressurePlateVariant = table.unpack(optionalArgs)
+    local pressurePlate = table.unpack(fireArgs, 1, 1)
+    local callbackPressurePlateVariant = table.unpack(optionalArgs, 1, 1)
     local pressurePlateVariant = pressurePlate:GetVariant()
     return callbackPressurePlateVariant == nil or callbackPressurePlateVariant == pressurePlateVariant
 end
 function ____exports.shouldFireProjectile(self, fireArgs, optionalArgs)
-    local projectile = table.unpack(fireArgs)
-    local callbackProjectileVariant, callbackSubType = table.unpack(optionalArgs)
+    local projectile = table.unpack(fireArgs, 1, 1)
+    local callbackProjectileVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackProjectileVariant == nil or callbackProjectileVariant == projectile.Variant) and (callbackSubType == nil or callbackSubType == projectile.SubType)
 end
 function ____exports.shouldFireRock(self, fireArgs, optionalArgs)
-    local rock = table.unpack(fireArgs)
-    local callbackGridEntity, callbackVariant = table.unpack(optionalArgs)
+    local rock = table.unpack(fireArgs, 1, 1)
+    local callbackGridEntity, callbackVariant = table.unpack(optionalArgs, 1, 2)
     local gridEntityType = rock:GetType()
     local variant = rock:GetVariant()
     return (callbackGridEntity == nil or callbackGridEntity == gridEntityType) and (callbackVariant == nil or callbackVariant == variant)
 end
 function ____exports.shouldFireRoom(self, fireArgs, optionalArgs)
-    local roomType = table.unpack(fireArgs)
-    local callbackRoomType = table.unpack(optionalArgs)
+    local roomType = table.unpack(fireArgs, 1, 1)
+    local callbackRoomType = table.unpack(optionalArgs, 1, 1)
     return callbackRoomType == nil or callbackRoomType == roomType
 end
 function ____exports.shouldFireSlot(self, fireArgs, optionalArgs)
-    local slot = table.unpack(fireArgs)
-    local callbackSlotVariant, callbackSubType = table.unpack(optionalArgs)
+    local slot = table.unpack(fireArgs, 1, 1)
+    local callbackSlotVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackSlotVariant == nil or callbackSlotVariant == slot.Variant) and (callbackSubType == nil or callbackSubType == slot.SubType)
 end
 function ____exports.shouldFireSpikes(self, fireArgs, optionalArgs)
-    local spikes = table.unpack(fireArgs)
-    local callbackVariant = table.unpack(optionalArgs)
+    local spikes = table.unpack(fireArgs, 1, 1)
+    local callbackVariant = table.unpack(optionalArgs, 1, 1)
     local variant = spikes:GetVariant()
     return callbackVariant == nil or callbackVariant == variant
 end
 function ____exports.shouldFireTNT(self, fireArgs, optionalArgs)
-    local tnt = table.unpack(fireArgs)
-    local callbackVariant = table.unpack(optionalArgs)
+    local tnt = table.unpack(fireArgs, 1, 1)
+    local callbackVariant = table.unpack(optionalArgs, 1, 1)
     local variant = tnt:GetVariant()
     return callbackVariant == nil or callbackVariant == variant
 end
 function ____exports.shouldFireTear(self, fireArgs, optionalArgs)
-    local tear = table.unpack(fireArgs)
-    local callbackTearVariant, callbackSubType = table.unpack(optionalArgs)
+    local tear = table.unpack(fireArgs, 1, 1)
+    local callbackTearVariant, callbackSubType = table.unpack(optionalArgs, 1, 2)
     return (callbackTearVariant == nil or callbackTearVariant == tear.Variant) and (callbackSubType == nil or callbackSubType == tear.SubType)
 end
 function ____exports.shouldFireTrinketType(self, fireArgs, optionalArgs)
-    local _player, trinketType = table.unpack(fireArgs)
-    local callbackTrinketType = table.unpack(optionalArgs)
+    local _player, trinketType = table.unpack(fireArgs, 1, 2)
+    local callbackTrinketType = table.unpack(optionalArgs, 1, 1)
     return callbackTrinketType == nil or callbackTrinketType == trinketType
 end
 return ____exports

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.52.9"
+      "packageVersion": "7.52.13"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "87.6.2",
+  "version": "87.8.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -26,10 +26,7 @@
   "types": "./dist/index.rollup.d.ts",
   "files": [
     "dist",
-    "src",
-    "LICENSE",
-    "package.json",
-    "README.md"
+    "src"
   ],
   "scripts": {
     "build": "tsx --tsconfig ./scripts/tsconfig.json ./scripts/build.mts",
@@ -37,13 +34,13 @@
     "lint": "tsx --tsconfig ./scripts/tsconfig.json ./scripts/lint.mts"
   },
   "dependencies": {
-    "isaac-typescript-definitions": "42.2.1"
+    "isaac-typescript-definitions": "42.3.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "7.52.9",
-    "complete-node": "7.4.3",
+    "@microsoft/api-extractor": "7.52.13",
+    "complete-node": "12.0.0",
     "eslint-plugin-sort-exports": "0.9.1",
-    "typescript-eslint": "8.38.0",
-    "typescript-to-lua": "1.31.4"
+    "typescript-eslint": "8.43.0",
+    "typescript-to-lua": "1.32.0"
   }
 }

package/src/functions/array.ts

@@ -29,16 +29,14 @@ export function arrayEquals<T>(
  * array. If the specified element(s) are not found in the array, it will simply return a shallow
  * copy of the array.
  *
- * This function is variadic, meaning that you can specify N arguments to remove N elements.
+ * If there is more than one matching element in the array, this function will remove all of them.
  *
- * If there is more than one matching element in the array, this function will only remove the first
- * matching element. If you want to remove all of the elements, use the `arrayRemoveAll` function
- * instead.
+ * This function is variadic, meaning that you can specify N arguments to remove N elements.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function arrayRemove<T>(
   originalArray: readonly T[],
   ...elementsToRemove: readonly T[]
+  // eslint-disable-next-line complete/no-mutable-return
 ): T[] {
   const elementsToRemoveSet = new ReadonlySet(elementsToRemove);
 
@@ -52,27 +50,6 @@ export function arrayRemove<T>(
   return array;
 }
 
-/**
- * Shallow copies and removes the specified element(s) from the array. Returns the copied array. If
- * the specified element(s) are not found in the array, it will simply return a shallow copy of the
- * array.
- *
- * This function is variadic, meaning that you can specify N arguments to remove N elements.
- *
- * If there is more than one matching element in the array, this function will remove every matching
- * element. If you want to only remove the first matching element, use the `arrayRemove` function
- * instead.
- */
-// eslint-disable-next-line complete/no-mutable-return
-export function arrayRemoveAll<T>(
-  originalArray: readonly T[],
-  ...elementsToRemove: readonly T[]
-): T[] {
-  const array = copyArray(originalArray);
-  arrayRemoveAllInPlace(array, ...elementsToRemove);
-  return array;
-}
-
 /**
  * Removes all of the specified element(s) from the array. If the specified element(s) are not found
  * in the array, this function will do nothing.
@@ -118,11 +95,11 @@ export function arrayRemoveAllInPlace<T>(
  *
  * @returns The removed elements. This will be an empty array if no elements were removed.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function arrayRemoveInPlace<T>(
   // eslint-disable-next-line complete/prefer-readonly-parameter-types
   array: T[],
   ...elementsToRemove: readonly T[]
+  // eslint-disable-next-line complete/no-mutable-return
 ): T[] {
   const removedElements: T[] = [];
 
@@ -144,10 +121,10 @@ export function arrayRemoveInPlace<T>(
  *
  * This function is variadic, meaning that you can specify N arguments to remove N elements.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function arrayRemoveIndex<T>(
   originalArray: readonly T[],
   ...indexesToRemove: readonly int[]
+  // eslint-disable-next-line complete/no-mutable-return
 ): T[] {
   const indexesToRemoveSet = new ReadonlySet(indexesToRemove);
 
@@ -169,11 +146,11 @@ export function arrayRemoveIndex<T>(
  *
  * @returns The removed elements. This will be an empty array if no elements were removed.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function arrayRemoveIndexInPlace<T>(
   // eslint-disable-next-line complete/prefer-readonly-parameter-types
   array: T[],
   ...indexesToRemove: readonly int[]
+  // eslint-disable-next-line complete/no-mutable-return
 ): T[] {
   const legalIndexes = indexesToRemove.filter(
     (i) => i >= 0 && i < array.length,
@@ -266,11 +243,10 @@ export function emptyArray(array: unknown[]): void {
  * This is named `filterMap` after the Rust function:
  * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function filterMap<OldT, NewT>(
   array: readonly OldT[],
   func: (element: OldT) => NewT | undefined,
-): NewT[] {
+): readonly NewT[] {
   const filteredArray: NewT[] = [];
 
   for (const element of array) {
@@ -375,7 +351,7 @@ export function getArrayDuplicateElements<T extends number | string>(
   }
 
   const values = [...duplicateElements];
-  return values.sort(sortNormal);
+  return values.toSorted(sortNormal);
 }
 
 /**
@@ -647,10 +623,10 @@ export function setAllArrayElements<T>(array: T[], value: T): void {
  *                  `RNG.Next` method will be called. If `undefined` is provided, it will default to
  *                  a random seed.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function shuffleArray<T>(
   originalArray: readonly T[],
   seedOrRNG: Seed | RNG | undefined,
+  // eslint-disable-next-line complete/no-mutable-return
 ): T[] {
   const array = copyArray(originalArray);
   shuffleArrayInPlace(array, seedOrRNG);

package/src/functions/debugFunctions.ts

@@ -42,7 +42,6 @@ export function getTime(useSocketIfAvailable = true): int | float {
     }
 
     if (isLuaDebugEnabled()) {
-      // eslint-disable-next-line unicorn/prefer-module
       const [ok, requiredSocket] = pcall(require, "socket");
       if (ok) {
         const socket = requiredSocket as Socket;

package/src/functions/map.ts

@@ -101,10 +101,9 @@ export function mapSetHash<V>(
  *
  * Also see the `objectToReadonlyMap` function.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function objectToMap<K extends string | number | symbol, V>(
   object: Record<K, V>,
-): Map<K, V> {
+): ReadonlyMap<K, V> {
   const map = new Map<K, V>();
 
   for (const [key, value] of Object.entries(object)) {

package/src/functions/set.ts

@@ -26,8 +26,9 @@ export function addSetsToSet<T>(
  *
  * This function is variadic, meaning that you can specify N sets.
  */
-// eslint-disable-next-line complete/no-mutable-return
-export function combineSets<T>(...sets: ReadonlyArray<ReadonlySet<T>>): Set<T> {
+export function combineSets<T>(
+  ...sets: ReadonlyArray<ReadonlySet<T>>
+): ReadonlySet<T> {
   const newSet = new Set<T>();
   for (const set of sets) {
     for (const value of set) {
@@ -123,9 +124,9 @@ export function getSetCombinations<T extends number | string>(
  * Normally, set values are returned in insertion order, so use this function when the ordering of
  * the contents is important.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function getSortedSetValues<T extends number | string>(
   set: ReadonlySet<T>,
+  // eslint-disable-next-line complete/no-mutable-return
 ): T[] {
   const values = [...set];
 
@@ -167,9 +168,9 @@ export function objectKeysToReadonlySet<K extends string | number | symbol, V>(
  *
  * Also see the `objectKeysToReadonlySet` function.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function objectKeysToSet<K extends string | number | symbol, V>(
   object: Record<K, V>,
+  // eslint-disable-next-line complete/no-mutable-return
 ): Set<K> {
   const set = new Set<K>();
 
@@ -203,9 +204,9 @@ export function objectValuesToReadonlySet<
  *
  * Also see the `objectValuesToReadonlySet` function.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function objectValuesToSet<K extends string | number | symbol, V>(
   object: Record<K, V>,
+  // eslint-disable-next-line complete/no-mutable-return
 ): Set<V> {
   const set = new Set<V>();
 

package/src/functions/sort.ts

@@ -149,11 +149,11 @@ export function sortTwoDimensionalArray<T>(
  *
  * Under the hood, this uses the merge sort algorithm.
  */
-// eslint-disable-next-line complete/no-mutable-return
 export function stableSort<T>(
   // eslint-disable-next-line complete/prefer-readonly-parameter-types
   array: T[],
   sortFunc: (a: T, b: T) => -1 | 0 | 1 = sortNormal,
+  // eslint-disable-next-line complete/no-mutable-return
 ): T[] {
   // Base case: an array of zero or one elements is already sorted
   if (array.length <= 1) {

package/src/functions/utils.ts

@@ -1,3 +1,4 @@
+import { game } from "../core/cachedClasses";
 import { ReadonlySet } from "../types/ReadonlySet";
 import { getAllPlayers } from "./playerIndex";
 import { isFunction } from "./types";
@@ -155,7 +156,7 @@ export function isMultiplayer(): boolean {
 }
 
 /**
- * Helper function to check if the player is using Afterbirth+ or Repentance.
+ * Helper function to check if the player has the Repentance DLC installed.
  *
  * This function should always be used over the `REPENTANCE` constant, since the latter is not safe.
  *
@@ -181,6 +182,23 @@ export function isRepentance(): boolean {
   return isFunction(getAnimation);
 }
 
+/**
+ * Helper function to check if the player has the Repentance+ DLC installed.
+ *
+ * This function should always be used over the `REPENTANCE_PLUS` constant, since the latter is not
+ * safe.
+ *
+ * Specifically, this function checks for `Room:DamageGridWithSource` method:
+ * https://bindingofisaacrebirth.wiki.gg/wiki/The_Binding_of_Isaac:_Repentance%2B#Modding_Changes
+ */
+export function isRepentancePlus(): boolean {
+  const room = game.GetRoom();
+  const metatable = getmetatable(room) as LuaMap<string, unknown> | undefined;
+  assertDefined(metatable, "Failed to get the metatable of the room class.");
+  const damageGridWithSource = metatable.get("DamageGridWithSource");
+  return isFunction(damageGridWithSource);
+}
+
 /**
  * Helper function to check if the player is using REPENTOGON, an exe-hack which expands the modding
  * API.