isaacscript-common 33.15.0 → 34.1.0

package/dist/index.rollup.d.ts

@@ -5581,6 +5581,8 @@ export declare function getHighestArrayElement(array: number[]): number | undefi
  *
  * Note that this is not necessarily the enum value that is declared last in the code, since there
  * is no way to infer that at run-time.
+ *
+ * Throws an error if the provided enum is empty.
  */
 export declare function getHighestEnumValue<T>(transpiledEnum: T): T[keyof T];
 
@@ -5717,16 +5719,6 @@ export declare function getLanguageName(): string;
  */
 export declare function getLasers(laserVariant?: LaserVariant | -1, subType?: number): EntityLaser[];
 
-/**
- * Helper function to return the last element of an array.
- *
- * If the array is empty, this will return undefined.
- *
- * (Note that TSTL does not support `Array.at(-1)`, which would make this helper function largely
- * unnecessary.)
- */
-export declare function getLastElement<T>(array: T[]): T | undefined;
-
 /**
  * Helper function that returns the number of the final frame in a particular animation for a
  * sprite. By default, it will use the currently playing animation, but you can also specify a
@@ -5755,6 +5747,16 @@ export declare function getLevelBossIDs(): BossID[];
  */
 export declare function getLowestArrayElement(array: number[]): number | undefined;
 
+/**
+ * Helper function to get the enum value with the lowest value.
+ *
+ * Note that this is not necessarily the enum value that is declared first in the code, since there
+ * is no way to infer that at run-time.
+ *
+ * Throws an error if the provided enum is empty.
+ */
+export declare function getLowestEnumValue<T>(transpiledEnum: T): T[keyof T];
+
 /**
  * Helper function to get the closest value from a map based on partial search text. For the
  * purposes of this function, both search text and map keys are converted to lowercase before

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 33.15.0
+isaacscript-common 34.1.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -17090,9 +17090,6 @@ function ____exports.getHighestArrayElement(self, array)
     end
     return highestValue
 end
-function ____exports.getLastElement(self, array)
-    return array[#array]
-end
 function ____exports.getLowestArrayElement(self, array)
     if #array == 0 then
         return nil
@@ -17224,6 +17221,7 @@ return ____exports
 local ____lualib = require("lualib_bundle")
 local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local __TS__ArrayIncludes = ____lualib.__TS__ArrayIncludes
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
@@ -17290,10 +17288,16 @@ function ____exports.getEnumValues(self, transpiledEnum)
 end
 function ____exports.getHighestEnumValue(self, transpiledEnum)
     local enumValues = ____exports.getEnumValues(nil, transpiledEnum)
-    local lastElement = enumValues[#enumValues]
+    local lastElement = __TS__ArrayAt(enumValues, -1)
     assertDefined(nil, lastElement, "Failed to get the last value from an enum since the enum was empty.")
     return lastElement
 end
+function ____exports.getLowestEnumValue(self, transpiledEnum)
+    local enumValues = ____exports.getEnumValues(nil, transpiledEnum)
+    local firstElement = enumValues[1]
+    assertDefined(nil, firstElement, "Failed to get the first value from an enum since the enum was empty.")
+    return firstElement
+end
 function ____exports.getRandomEnumValue(self, transpiledEnum, seedOrRNG, exceptions)
     if seedOrRNG == nil then
         seedOrRNG = getRandomSeed(nil)
@@ -17319,7 +17323,7 @@ function ____exports.validateCustomEnum(self, transpiledEnumName, transpiledEnum
 end
 function ____exports.validateEnumContiguous(self, transpiledEnumName, transpiledEnum)
     local values = ____exports.getEnumValues(nil, transpiledEnum)
-    local lastValue = values[#values]
+    local lastValue = __TS__ArrayAt(values, -1)
     assertDefined(nil, lastValue, "Failed to validate that an enum was contiguous, since the last value was undefined.")
     if not isNumber(nil, lastValue) then
         error("Failed to validate that an enum was contiguous, since the last value was not a number.")
@@ -21835,6 +21839,7 @@ local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
 local ____exports = {}
@@ -21857,7 +21862,6 @@ local itemConfig = ____cachedClasses.itemConfig
 local ____ReadonlySet = require("src.types.ReadonlySet")
 local ReadonlySet = ____ReadonlySet.ReadonlySet
 local ____array = require("src.functions.array")
-local getLastElement = ____array.getLastElement
 local sumArray = ____array.sumArray
 local ____characters = require("src.functions.characters")
 local getCharacterName = ____characters.getCharacterName
@@ -22002,7 +22006,7 @@ function ____exports.getEffectsList(self, player)
 end
 function ____exports.getFinalPlayer(self)
     local players = getPlayers(nil)
-    local lastPlayer = getLastElement(nil, players)
+    local lastPlayer = __TS__ArrayAt(players, -1)
     assertDefined(nil, lastPlayer, "Failed to get the final player since there were 0 players.")
     return lastPlayer
 end
@@ -34607,6 +34611,7 @@ local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local ____exports = {}
 local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
@@ -34614,8 +34619,6 @@ local ____decorators = require("src.decorators")
 local Exported = ____decorators.Exported
 local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
-local ____array = require("src.functions.array")
-local getLastElement = ____array.getLastElement
 local ____dimensions = require("src.functions.dimensions")
 local getDimension = ____dimensions.getDimension
 local ____roomData = require("src.functions.roomData")
@@ -34684,7 +34687,7 @@ function RoomHistory.prototype.getRoomHistory(self)
 end
 __TS__DecorateLegacy({Exported}, RoomHistory.prototype, "getRoomHistory", true)
 function RoomHistory.prototype.getPreviousRoomDescription(self)
-    local previousRoomDescription = v.run.roomHistory[#v.run.roomHistory - 2 + 1]
+    local previousRoomDescription = __TS__ArrayAt(v.run.roomHistory, -2)
     if previousRoomDescription ~= nil then
         return previousRoomDescription
     end
@@ -34696,7 +34699,7 @@ function RoomHistory.prototype.getPreviousRoomDescription(self)
 end
 __TS__DecorateLegacy({Exported}, RoomHistory.prototype, "getPreviousRoomDescription", true)
 function RoomHistory.prototype.getLatestRoomDescription(self)
-    return getLastElement(nil, v.run.roomHistory)
+    return __TS__ArrayAt(v.run.roomHistory, -1)
 end
 __TS__DecorateLegacy({Exported}, RoomHistory.prototype, "getLatestRoomDescription", true)
 function RoomHistory.prototype.inFirstRoom(self)
@@ -51495,6 +51498,7 @@ local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local ____exports = {}
 local ____decorators = require("src.decorators")
 local Exported = ____decorators.Exported
@@ -51503,7 +51507,6 @@ local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____array = require("src.functions.array")
 local arrayRemoveInPlace = ____array.arrayRemoveInPlace
 local copyArray = ____array.copyArray
-local getLastElement = ____array.getLastElement
 local ____collectibles = require("src.functions.collectibles")
 local isActiveCollectible = ____collectibles.isActiveCollectible
 local ____playerDataStructures = require("src.functions.playerDataStructures")
@@ -51549,7 +51552,7 @@ end
 __TS__DecorateLegacy({Exported}, PlayerInventory.prototype, "getPlayerInventory", true)
 function PlayerInventory.prototype.getPlayerLastPassiveCollectible(self, player)
     local inventory = self:getPlayerInventory(player, false)
-    return getLastElement(nil, inventory)
+    return __TS__ArrayAt(inventory, -1)
 end
 __TS__DecorateLegacy({Exported}, PlayerInventory.prototype, "getPlayerLastPassiveCollectible", true)
 return ____exports

package/dist/src/classes/features/other/PlayerInventory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerInventory.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/PlayerInventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAYpE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAYhD,qBAAa,eAAgB,SAAQ,OAAO;IAqB1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAUnC;IAGF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAUrC;IAEF;;;;;;;;;;;;;;;;;;;;;OAqBG;IAEI,kBAAkB,CACvB,MAAM,EAAE,YAAY,EACpB,yBAAyB,UAAO,GAC/B,eAAe,EAAE;IAgBpB;;;;;;;OAOG;IAEI,+BAA+B,CACpC,MAAM,EAAE,YAAY,GACnB,eAAe,GAAG,SAAS;CAI/B"}
+{"version":3,"file":"PlayerInventory.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/PlayerInventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAYhD,qBAAa,eAAgB,SAAQ,OAAO;IAqB1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAUnC;IAGF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAUrC;IAEF;;;;;;;;;;;;;;;;;;;;;OAqBG;IAEI,kBAAkB,CACvB,MAAM,EAAE,YAAY,EACpB,yBAAyB,UAAO,GAC/B,eAAe,EAAE;IAgBpB;;;;;;;OAOG;IAEI,+BAA+B,CACpC,MAAM,EAAE,YAAY,GACnB,eAAe,GAAG,SAAS;CAI/B"}

package/dist/src/classes/features/other/PlayerInventory.lua

@@ -4,6 +4,7 @@ local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local ____exports = {}
 local ____decorators = require("src.decorators")
 local Exported = ____decorators.Exported
@@ -12,7 +13,6 @@ local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____array = require("src.functions.array")
 local arrayRemoveInPlace = ____array.arrayRemoveInPlace
 local copyArray = ____array.copyArray
-local getLastElement = ____array.getLastElement
 local ____collectibles = require("src.functions.collectibles")
 local isActiveCollectible = ____collectibles.isActiveCollectible
 local ____playerDataStructures = require("src.functions.playerDataStructures")
@@ -58,7 +58,7 @@ end
 __TS__DecorateLegacy({Exported}, PlayerInventory.prototype, "getPlayerInventory", true)
 function PlayerInventory.prototype.getPlayerLastPassiveCollectible(self, player)
     local inventory = self:getPlayerInventory(player, false)
-    return getLastElement(nil, inventory)
+    return __TS__ArrayAt(inventory, -1)
 end
 __TS__DecorateLegacy({Exported}, PlayerInventory.prototype, "getPlayerLastPassiveCollectible", true)
 return ____exports

package/dist/src/classes/features/other/RoomHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RoomHistory.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/RoomHistory.ts"],"names":[],"mappings":";AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,qBAAa,WAAY,SAAQ,OAAO;IActC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAgC/B;IAEF;;;;OAIG;IAEI,yBAAyB,IAAI,IAAI;IAIxC;;;;;OAKG;IAEI,kBAAkB,IAAI,GAAG;IAIhC;;;;;OAKG;IAEI,cAAc,IAAI,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAIjE;;;;;;;OAOG;IAEI,0BAA0B,IAAI,QAAQ,CAAC,eAAe,CAAC;IAiB9D;;;;;;;;;;OAUG;IAEI,wBAAwB,IAAI,QAAQ,CAAC,eAAe,CAAC,GAAG,SAAS;IAIxE,gFAAgF;IAEzE,WAAW,IAAI,OAAO;IAI7B;;;;;;;;;;OAUG;IAEI,aAAa,IAAI,OAAO;CAwBhC"}
+{"version":3,"file":"RoomHistory.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/RoomHistory.ts"],"names":[],"mappings":";AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,qBAAa,WAAY,SAAQ,OAAO;IActC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAgC/B;IAEF;;;;OAIG;IAEI,yBAAyB,IAAI,IAAI;IAIxC;;;;;OAKG;IAEI,kBAAkB,IAAI,GAAG;IAIhC;;;;;OAKG;IAEI,cAAc,IAAI,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAIjE;;;;;;;OAOG;IAEI,0BAA0B,IAAI,QAAQ,CAAC,eAAe,CAAC;IAgB9D;;;;;;;;;;OAUG;IAEI,wBAAwB,IAAI,QAAQ,CAAC,eAAe,CAAC,GAAG,SAAS;IAIxE,gFAAgF;IAEzE,WAAW,IAAI,OAAO;IAI7B;;;;;;;;;;OAUG;IAEI,aAAa,IAAI,OAAO;CAwBhC"}

package/dist/src/classes/features/other/RoomHistory.lua

@@ -2,6 +2,7 @@ local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local ____exports = {}
 local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
@@ -9,8 +10,6 @@ local ____decorators = require("src.decorators")
 local Exported = ____decorators.Exported
 local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
-local ____array = require("src.functions.array")
-local getLastElement = ____array.getLastElement
 local ____dimensions = require("src.functions.dimensions")
 local getDimension = ____dimensions.getDimension
 local ____roomData = require("src.functions.roomData")
@@ -79,7 +78,7 @@ function RoomHistory.prototype.getRoomHistory(self)
 end
 __TS__DecorateLegacy({Exported}, RoomHistory.prototype, "getRoomHistory", true)
 function RoomHistory.prototype.getPreviousRoomDescription(self)
-    local previousRoomDescription = v.run.roomHistory[#v.run.roomHistory - 2 + 1]
+    local previousRoomDescription = __TS__ArrayAt(v.run.roomHistory, -2)
     if previousRoomDescription ~= nil then
         return previousRoomDescription
     end
@@ -91,7 +90,7 @@ function RoomHistory.prototype.getPreviousRoomDescription(self)
 end
 __TS__DecorateLegacy({Exported}, RoomHistory.prototype, "getPreviousRoomDescription", true)
 function RoomHistory.prototype.getLatestRoomDescription(self)
-    return getLastElement(nil, v.run.roomHistory)
+    return __TS__ArrayAt(v.run.roomHistory, -1)
 end
 __TS__DecorateLegacy({Exported}, RoomHistory.prototype, "getLatestRoomDescription", true)
 function RoomHistory.prototype.inFirstRoom(self)

package/dist/src/functions/array.d.ts

@@ -141,15 +141,6 @@ export declare function getArrayIndexes<T>(array: T[] | readonly T[]): int[];
  * in the array.
  */
 export declare function getHighestArrayElement(array: number[]): number | undefined;
-/**
- * Helper function to return the last element of an array.
- *
- * If the array is empty, this will return undefined.
- *
- * (Note that TSTL does not support `Array.at(-1)`, which would make this helper function largely
- * unnecessary.)
- */
-export declare function getLastElement<T>(array: T[]): T | undefined;
 /**
  * Helper function to get the lowest value in an array. Returns undefined if there were no elements
  * in the array.

package/dist/src/functions/array.d.ts.map

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

package/dist/src/functions/array.lua

@@ -381,15 +381,6 @@ function ____exports.getHighestArrayElement(self, array)
     end
     return highestValue
 end
---- Helper function to return the last element of an array.
--- 
--- If the array is empty, this will return undefined.
--- 
--- (Note that TSTL does not support `Array.at(-1)`, which would make this helper function largely
--- unnecessary.)
-function ____exports.getLastElement(self, array)
-    return array[#array]
-end
 --- Helper function to get the lowest value in an array. Returns undefined if there were no elements
 -- in the array.
 function ____exports.getLowestArrayElement(self, array)

package/dist/src/functions/enums.d.ts

@@ -60,8 +60,19 @@ export declare function getEnumValues<T>(transpiledEnum: T): Array<T[keyof T]>;
  *
  * Note that this is not necessarily the enum value that is declared last in the code, since there
  * is no way to infer that at run-time.
+ *
+ * Throws an error if the provided enum is empty.
  */
 export declare function getHighestEnumValue<T>(transpiledEnum: T): T[keyof T];
+/**
+ * Helper function to get the enum value with the lowest value.
+ *
+ * Note that this is not necessarily the enum value that is declared first in the code, since there
+ * is no way to infer that at run-time.
+ *
+ * Throws an error if the provided enum is empty.
+ */
+export declare function getLowestEnumValue<T>(transpiledEnum: T): T[keyof T];
 /**
  * Helper function to get a random value from the provided enum.
  *

package/dist/src/functions/enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../src/functions/enums.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,GAChB,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAmBzC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvD,MAAM,EAAE,CAGV;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvD,GAAG,CAGL;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAGrE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAUpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,cAAc,EAAE,CAAC,EACjB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,GAC7D,CAAC,CAAC,MAAM,CAAC,CAAC,CAGZ;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvD,OAAO,CAGT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,OAAO,GACtB,IAAI,CAQN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,CAAC,GAChB,IAAI,CAsBN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,4BAA4B,CAE1C,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAC/B,IAAI,SAAS,MAAM,GAAG,MAAM,KACzB,IAAI,CAAG"}
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../src/functions/enums.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,GAChB,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAmBzC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvD,MAAM,EAAE,CAGV;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvD,GAAG,CAGL;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAGrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAUpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAUnE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,cAAc,EAAE,CAAC,EACjB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,GAC7D,CAAC,CAAC,MAAM,CAAC,CAAC,CAGZ;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvD,OAAO,CAGT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,OAAO,GACtB,IAAI,CAQN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,CAAC,GAChB,IAAI,CAsBN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,4BAA4B,CAE1C,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAC/B,IAAI,SAAS,MAAM,GAAG,MAAM,KACzB,IAAI,CAAG"}

package/dist/src/functions/enums.lua

@@ -1,6 +1,7 @@
 local ____lualib = require("lualib_bundle")
 local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local __TS__ArrayIncludes = ____lualib.__TS__ArrayIncludes
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
@@ -113,12 +114,26 @@ end
 -- 
 -- Note that this is not necessarily the enum value that is declared last in the code, since there
 -- is no way to infer that at run-time.
+-- 
+-- Throws an error if the provided enum is empty.
 function ____exports.getHighestEnumValue(self, transpiledEnum)
     local enumValues = ____exports.getEnumValues(nil, transpiledEnum)
-    local lastElement = enumValues[#enumValues]
+    local lastElement = __TS__ArrayAt(enumValues, -1)
     assertDefined(nil, lastElement, "Failed to get the last value from an enum since the enum was empty.")
     return lastElement
 end
+--- Helper function to get the enum value with the lowest value.
+-- 
+-- Note that this is not necessarily the enum value that is declared first in the code, since there
+-- is no way to infer that at run-time.
+-- 
+-- Throws an error if the provided enum is empty.
+function ____exports.getLowestEnumValue(self, transpiledEnum)
+    local enumValues = ____exports.getEnumValues(nil, transpiledEnum)
+    local firstElement = enumValues[1]
+    assertDefined(nil, firstElement, "Failed to get the first value from an enum since the enum was empty.")
+    return firstElement
+end
 --- Helper function to get a random value from the provided enum.
 -- 
 -- @param transpiledEnum The enum to get the value from.
@@ -167,7 +182,7 @@ end
 -- This is useful to automate checking large enums for typos.
 function ____exports.validateEnumContiguous(self, transpiledEnumName, transpiledEnum)
     local values = ____exports.getEnumValues(nil, transpiledEnum)
-    local lastValue = values[#values]
+    local lastValue = __TS__ArrayAt(values, -1)
     assertDefined(nil, lastValue, "Failed to validate that an enum was contiguous, since the last value was undefined.")
     if not isNumber(nil, lastValue) then
         error("Failed to validate that an enum was contiguous, since the last value was not a number.")

package/dist/src/functions/players.lua

@@ -3,6 +3,7 @@ local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
 local ____exports = {}
@@ -25,7 +26,6 @@ local itemConfig = ____cachedClasses.itemConfig
 local ____ReadonlySet = require("src.types.ReadonlySet")
 local ReadonlySet = ____ReadonlySet.ReadonlySet
 local ____array = require("src.functions.array")
-local getLastElement = ____array.getLastElement
 local sumArray = ____array.sumArray
 local ____characters = require("src.functions.characters")
 local getCharacterName = ____characters.getCharacterName
@@ -222,7 +222,7 @@ end
 -- method.
 function ____exports.getFinalPlayer(self)
     local players = getPlayers(nil)
-    local lastPlayer = getLastElement(nil, players)
+    local lastPlayer = __TS__ArrayAt(players, -1)
     assertDefined(nil, lastPlayer, "Failed to get the final player since there were 0 players.")
     return lastPlayer
 end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "33.15.0",
+  "version": "34.1.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/classes/features/other/PlayerInventory.ts

@@ -1,11 +1,7 @@
 import type { CollectibleType } from "isaac-typescript-definitions";
 import { Exported } from "../../../decorators";
 import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
-import {
-  arrayRemoveInPlace,
-  copyArray,
-  getLastElement,
-} from "../../../functions/array";
+import { arrayRemoveInPlace, copyArray } from "../../../functions/array";
 import { isActiveCollectible } from "../../../functions/collectibles";
 import { defaultMapGetPlayer } from "../../../functions/playerDataStructures";
 import type { PlayerIndex } from "../../../types/PlayerIndex";
@@ -123,6 +119,6 @@ export class PlayerInventory extends Feature {
     player: EntityPlayer,
   ): CollectibleType | undefined {
     const inventory = this.getPlayerInventory(player, false);
-    return getLastElement(inventory);
+    return inventory.at(-1);
   }
 }

package/src/classes/features/other/RoomHistory.ts

@@ -1,7 +1,6 @@
 import { game } from "../../../core/cachedClasses";
 import { Exported } from "../../../decorators";
 import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
-import { getLastElement } from "../../../functions/array";
 import { getDimension } from "../../../functions/dimensions";
 import {
   getRoomGridIndex,
@@ -111,8 +110,7 @@ export class RoomHistory extends Feature {
    */
   @Exported
   public getPreviousRoomDescription(): Readonly<RoomDescription> {
-    const previousRoomDescription =
-      v.run.roomHistory[v.run.roomHistory.length - 2];
+    const previousRoomDescription = v.run.roomHistory.at(-2);
     if (previousRoomDescription !== undefined) {
       return previousRoomDescription;
     }
@@ -140,7 +138,7 @@ export class RoomHistory extends Feature {
    */
   @Exported
   public getLatestRoomDescription(): Readonly<RoomDescription> | undefined {
-    return getLastElement(v.run.roomHistory);
+    return v.run.roomHistory.at(-1);
   }
 
   /** Helper function to detect if the player is on the first room of the room. */

package/src/functions/array.ts

@@ -360,18 +360,6 @@ export function getHighestArrayElement(array: number[]): number | undefined {
   return highestValue;
 }
 
-/**
- * Helper function to return the last element of an array.
- *
- * If the array is empty, this will return undefined.
- *
- * (Note that TSTL does not support `Array.at(-1)`, which would make this helper function largely
- * unnecessary.)
- */
-export function getLastElement<T>(array: T[]): T | undefined {
-  return array[array.length - 1];
-}
-
 /**
  * Helper function to get the lowest value in an array. Returns undefined if there were no elements
  * in the array.

package/src/functions/enums.ts

@@ -101,11 +101,13 @@ export function getEnumValues<T>(transpiledEnum: T): Array<T[keyof T]> {
  *
  * Note that this is not necessarily the enum value that is declared last in the code, since there
  * is no way to infer that at run-time.
+ *
+ * Throws an error if the provided enum is empty.
  */
 export function getHighestEnumValue<T>(transpiledEnum: T): T[keyof T] {
   const enumValues = getEnumValues(transpiledEnum);
 
-  const lastElement = enumValues[enumValues.length - 1];
+  const lastElement = enumValues.at(-1);
   assertDefined(
     lastElement,
     "Failed to get the last value from an enum since the enum was empty.",
@@ -114,6 +116,26 @@ export function getHighestEnumValue<T>(transpiledEnum: T): T[keyof T] {
   return lastElement;
 }
 
+/**
+ * Helper function to get the enum value with the lowest value.
+ *
+ * Note that this is not necessarily the enum value that is declared first in the code, since there
+ * is no way to infer that at run-time.
+ *
+ * Throws an error if the provided enum is empty.
+ */
+export function getLowestEnumValue<T>(transpiledEnum: T): T[keyof T] {
+  const enumValues = getEnumValues(transpiledEnum);
+
+  const firstElement = enumValues[0];
+  assertDefined(
+    firstElement,
+    "Failed to get the first value from an enum since the enum was empty.",
+  );
+
+  return firstElement;
+}
+
 /**
  * Helper function to get a random value from the provided enum.
  *
@@ -178,7 +200,7 @@ export function validateEnumContiguous<T>(
   transpiledEnum: T,
 ): void {
   const values = getEnumValues(transpiledEnum);
-  const lastValue = values[values.length - 1];
+  const lastValue = values.at(-1);
   assertDefined(
     lastValue,
     "Failed to validate that an enum was contiguous, since the last value was undefined.",

package/src/functions/players.ts

@@ -15,7 +15,7 @@ import {
 } from "../arrays/cachedEnumValues";
 import { game, itemConfig } from "../core/cachedClasses";
 import { ReadonlySet } from "../types/ReadonlySet";
-import { getLastElement, sumArray } from "./array";
+import { sumArray } from "./array";
 import { getCharacterName, isVanillaCharacter } from "./characters";
 import { getCollectibleMaxCharges } from "./collectibles";
 import { hasFlag } from "./flag";
@@ -250,7 +250,7 @@ export function getEffectsList(player: EntityPlayer): TemporaryEffect[] {
 export function getFinalPlayer(): EntityPlayer {
   const players = getPlayers();
 
-  const lastPlayer = getLastElement(players);
+  const lastPlayer = players.at(-1);
   assertDefined(
     lastPlayer,
     "Failed to get the final player since there were 0 players.",