isaacscript-common 84.1.1 → 84.2.0

package/dist/index.rollup.d.ts

@@ -5047,7 +5047,7 @@ export declare function getArrayCombinations<T>(array: readonly T[], includeEmpt
  * Helper function to get the duplicate elements in an array. Only one element for each value will
  * be returned. The elements will be sorted before they are returned.
  */
-export declare function getArrayDuplicateElements<T>(array: readonly T[]): readonly T[];
+export declare function getArrayDuplicateElements<T extends number | string>(array: readonly T[]): readonly T[];
 
 /**
  * Helper function to get an array containing the indexes of an array.
@@ -7261,7 +7261,7 @@ export declare function getRandomSeed(): Seed;
  *                  a random seed.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
-export declare function getRandomSetElement<T>(set: ReadonlySet<T>, seedOrRNG: Seed | RNG | undefined, exceptions?: readonly T[]): T;
+export declare function getRandomSetElement<T extends number | string>(set: ReadonlySet<T>, seedOrRNG: Seed | RNG | undefined, exceptions?: readonly T[]): T;
 
 /**
  * Helper function to get a random vector between (-1, -1) and (1, 1).
@@ -7876,7 +7876,7 @@ export declare function getSeedEffects(): readonly SeedEffect[];
  * @param set The set to get the combinations of.
  * @param includeEmptyArray Whether to include an empty array in the combinations.
  */
-export declare function getSetCombinations<T>(set: ReadonlySet<T>, includeEmptyArray: boolean): ReadonlyArray<ReadonlySet<T>>;
+export declare function getSetCombinations<T extends number | string>(set: ReadonlySet<T>, includeEmptyArray: boolean): ReadonlyArray<ReadonlySet<T>>;
 
 /**
  * Helper function to get the shooting actions that the specified `ControllerIndex` is currently
@@ -7934,7 +7934,7 @@ export declare function getSlots(slotVariant?: SlotVariant | -1, subType?: numbe
  * Normally, set values are returned in insertion order, so use this function when the ordering of
  * the contents is important.
  */
-export declare function getSortedSetValues<T>(set: ReadonlySet<T>): T[];
+export declare function getSortedSetValues<T extends number | string>(set: ReadonlySet<T>): T[];
 
 /** Helper function to get all of the `GridEntitySpikes` in the room. */
 export declare function getSpikes(variant?: number): readonly GridEntitySpikes[];
@@ -10860,7 +10860,7 @@ export declare function logLevelStateFlags(this: void): void;
  * @param map The TSTL `Map` to log.
  * @param name Optional. The name of the map, which will be logged before the elements.
  */
-export declare function logMap(this: void, map: ReadonlyMap<AnyNotNil, unknown>, name?: string): void;
+export declare function logMap(this: void, map: ReadonlyMap<number | string, unknown>, name?: string): void;
 
 export declare function logMusic(this: void): void;
 
@@ -10901,7 +10901,7 @@ export declare function logSeedEffects(this: void): void;
  * @param set The TSTL `Set` to log.
  * @param name Optional. The name of the set, which will be logged before the elements.
  */
-export declare function logSet(this: void, set: ReadonlySet<AnyNotNil>, name?: string): void;
+export declare function logSet(this: void, set: ReadonlySet<number | string>, name?: string): void;
 
 /** Helper function for logging every sound effect that is currently playing. */
 export declare function logSounds(this: void): void;
@@ -18189,6 +18189,8 @@ export declare function smeltTrinkets(player: EntityPlayer, ...trinketTypes: rea
  */
 export declare function some<T>(array: readonly T[], func: (value: T, index: number, array: readonly T[]) => boolean): boolean;
 
+export declare function sortNormal(a: unknown, b: unknown): -1 | 0 | 1;
+
 /**
  * Helper function to sort an array of objects by one of the object keys.
  *
@@ -18217,7 +18219,7 @@ export declare function sortObjectArrayByKey(key: string): (a: unknown, b: unkno
  *
  * ```ts
  * const myArray = [[1, 2], [2, 3], [3, 4]];
- * myArray.sort(twoDimensionalSort);
+ * myArray.sort(sortTwoDimensionalArray);
  * ```
  *
  * This function also properly handles when the array elements are strings or numbers (instead of

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 84.1.0
+isaacscript-common 84.1.2
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -17055,6 +17055,8 @@ end
 return ____exports
  end,
 ["functions.types"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__TypeOf = ____lualib.__TS__TypeOf
 local ____exports = {}
 function ____exports.isNumber(self, variable)
     return type(variable) == "number"
@@ -17164,7 +17166,7 @@ function ____exports.isInteger(self, variable)
 end
 --- Helper function to detect if a variable is a boolean, number, or string.
 function ____exports.isPrimitive(self, variable)
-    local variableType = type(variable)
+    local variableType = __TS__TypeOf(variable)
     return variableType == "boolean" or variableType == "number" or variableType == "string"
 end
 function ____exports.isString(self, variable)
@@ -17203,7 +17205,7 @@ local ____types = require("functions.types")
 local isNumber = ____types.isNumber
 local isString = ____types.isString
 local isTable = ____types.isTable
-local function sortNormal(self, a, b)
+function ____exports.sortNormal(self, a, b)
     if not isNumber(nil, a) and not isString(nil, a) then
         error("Failed to normal sort since the first value was not a number or string and was instead: " .. type(a))
     end
@@ -17245,7 +17247,7 @@ function ____exports.sortObjectArrayByKey(self, key)
         end
         local aValue = a[key]
         local bValue = b[key]
-        return sortNormal(nil, aValue, bValue)
+        return ____exports.sortNormal(nil, aValue, bValue)
     end
 end
 --- Helper function to sort a two-dimensional array by the first element.
@@ -17254,7 +17256,7 @@ end
 -- 
 -- ```ts
 -- const myArray = [[1, 2], [2, 3], [3, 4]];
--- myArray.sort(twoDimensionalSort);
+-- myArray.sort(sortTwoDimensionalArray);
 -- ```
 -- 
 -- This function also properly handles when the array elements are strings or numbers (instead of
@@ -17269,7 +17271,7 @@ function ____exports.sortTwoDimensionalArray(self, a, b)
         error(((((((("Failed to two-dimensional sort since the two elements were disparate types: " .. tostring(a)) .. " & ") .. tostring(b)) .. " (") .. aType) .. " & ") .. bType) .. ")")
     end
     if aType == "string" or aType == "number" then
-        return sortNormal(nil, a, b)
+        return ____exports.sortNormal(nil, a, b)
     end
     if aType ~= "table" then
         error("Failed to two-dimensional sort since the first element was not a string, number, or table.")
@@ -17290,7 +17292,7 @@ function ____exports.sortTwoDimensionalArray(self, a, b)
     if elementType1 ~= elementType2 then
         error(((((((("Failed to two-dimensional sort since the first element of each array were disparate types: " .. tostring(firstElement1)) .. " & ") .. tostring(firstElement2)) .. " (") .. elementType1) .. " & ") .. elementType2) .. ")")
     end
-    return sortNormal(nil, firstElement1, firstElement2)
+    return ____exports.sortNormal(nil, firstElement1, firstElement2)
 end
 --- Helper function to sort an array in a stable way.
 -- 
@@ -17299,7 +17301,7 @@ end
 -- Under the hood, this uses the merge sort algorithm.
 function ____exports.stableSort(self, array, sortFunc)
     if sortFunc == nil then
-        sortFunc = sortNormal
+        sortFunc = ____exports.sortNormal
     end
     if #array <= 1 then
         return array
@@ -18702,6 +18704,8 @@ local getRandomInt = ____random.getRandomInt
 local ____rng = require("functions.rng")
 local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
+local ____sort = require("functions.sort")
+local sortNormal = ____sort.sortNormal
 local ____types = require("functions.types")
 local isNumber = ____types.isNumber
 local isTable = ____types.isTable
@@ -19060,7 +19064,7 @@ function ____exports.getArrayDuplicateElements(self, array)
         set:add(element)
     end
     local values = {__TS__Spread(duplicateElements)}
-    return __TS__ArraySort(values)
+    return __TS__ArraySort(values, sortNormal)
 end
 --- Helper function to get an array containing the indexes of an array.
 -- 
@@ -19272,6 +19276,7 @@ return ____exports
 local ____lualib = require("lualib_bundle")
 local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayToSorted = ____lualib.__TS__ArrayToSorted
 local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local __TS__ArrayIncludes = ____lualib.__TS__ArrayIncludes
 local __TS__New = ____lualib.__TS__New
@@ -19280,6 +19285,8 @@ local ____ReadonlySet = require("types.ReadonlySet")
 local ReadonlySet = ____ReadonlySet.ReadonlySet
 local ____array = require("functions.array")
 local getRandomArrayElement = ____array.getRandomArrayElement
+local ____sort = require("functions.sort")
+local sortNormal = ____sort.sortNormal
 local ____types = require("functions.types")
 local isNumber = ____types.isNumber
 local isString = ____types.isString
@@ -19415,8 +19422,9 @@ end
 -- Throws an error if the provided enum is empty.
 function ____exports.getHighestEnumValue(self, transpiledEnum)
     local enumValues = ____exports.getEnumValues(nil, transpiledEnum)
-    local lastElement = __TS__ArrayAt(enumValues, -1)
-    assertDefined(nil, lastElement, "Failed to get the last value from an enum since the enum was empty.")
+    local sortedValues = __TS__ArrayToSorted(enumValues, sortNormal)
+    local lastElement = __TS__ArrayAt(sortedValues, -1)
+    assertDefined(nil, lastElement, "Failed to get the highest value from an enum since the enum was empty.")
     return lastElement
 end
 --- Helper function to get the enum value with the lowest value.
@@ -19427,8 +19435,9 @@ end
 -- 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.")
+    local sortedValues = __TS__ArrayToSorted(enumValues, sortNormal)
+    local firstElement = sortedValues[1]
+    assertDefined(nil, firstElement, "Failed to get the lowest value from an enum since the enum was empty.")
     return firstElement
 end
 --- Helper function to get a random value from the provided enum.
@@ -44332,6 +44341,8 @@ local ____array = require("functions.array")
 local getArrayCombinations = ____array.getArrayCombinations
 local getRandomArrayElement = ____array.getRandomArrayElement
 local sumArray = ____array.sumArray
+local ____sort = require("functions.sort")
+local sortNormal = ____sort.sortNormal
 local ____types = require("functions.types")
 local isPrimitive = ____types.isPrimitive
 --- Helper function to get a sorted array based on the contents of a set.
@@ -44347,7 +44358,7 @@ function ____exports.getSortedSetValues(self, set)
             error(("Failed to get the sorted set values because the provided set was of type \"" .. tostring(arrayType)) .. "\". Having sets with non-primitive types doesn't make much sense in general, so you might need to rethink what you are doing.")
         end
     end
-    __TS__ArraySort(values)
+    __TS__ArraySort(values, sortNormal)
     return values
 end
 --- Helper function to convert the keys of an object to a set.
@@ -45388,6 +45399,8 @@ local defaultMapGetPlayer = ____playerDataStructures.defaultMapGetPlayer
 local mapSetPlayer = ____playerDataStructures.mapSetPlayer
 local ____players = require("functions.players")
 local getPlayerFromPtr = ____players.getPlayerFromPtr
+local ____sort = require("functions.sort")
+local sortNormal = ____sort.sortNormal
 local ____utils = require("functions.utils")
 local ____repeat = ____utils["repeat"]
 local ____DefaultMap = require("classes.DefaultMap")
@@ -45511,8 +45524,8 @@ function PlayerCollectibleDetection.prototype.checkActiveItemsChanged(self, play
         oldCollectibleTypes[#oldCollectibleTypes + 1] = oldCollectibleType
         newCollectibleTypes[#newCollectibleTypes + 1] = newCollectibleType
     end
-    __TS__ArraySort(oldCollectibleTypes)
-    __TS__ArraySort(newCollectibleTypes)
+    __TS__ArraySort(oldCollectibleTypes, sortNormal)
+    __TS__ArraySort(newCollectibleTypes, sortNormal)
     if not arrayEquals(nil, oldCollectibleTypes, newCollectibleTypes) then
         self:updateCollectibleMapAndFire(player, nil)
     end
@@ -58456,15 +58469,14 @@ return ____exports
  end,
 ["functions.logMisc"] = function(...) 
 local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
 local __TS__Spread = ____lualib.__TS__Spread
 local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__ArrayEntries = ____lualib.__TS__ArrayEntries
 local __TS__Iterator = ____lualib.__TS__Iterator
-local Set = ____lualib.Set
 local __TS__TypeOf = ____lualib.__TS__TypeOf
 local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
 local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.index")
 local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
@@ -58521,6 +58533,8 @@ local getRoomListIndex = ____roomData.getRoomListIndex
 local ____set = require("functions.set")
 local combineSets = ____set.combineSets
 local getSortedSetValues = ____set.getSortedSetValues
+local ____sort = require("functions.sort")
+local sortNormal = ____sort.sortNormal
 local ____table = require("functions.table")
 local iterateTableInOrder = ____table.iterateTableInOrder
 local ____trinkets = require("functions.trinkets")
@@ -58689,7 +58703,7 @@ function ____exports.logMap(map, name)
     local suffix = name == nil and "" or (" \"" .. name) .. "\""
     log(("Logging a TSTL map" .. suffix) .. ":")
     local mapKeys = {__TS__Spread(map:keys())}
-    __TS__ArraySort(mapKeys)
+    __TS__ArraySort(mapKeys, sortNormal)
     for ____, key in ipairs(mapKeys) do
         local value = map:get(key)
         log((("  " .. tostring(key)) .. " --> ") .. tostring(value))

package/dist/lib/jsonLua.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This is the custom JSON parser library called "json.lua". It is located at:
+ * https://github.com/rxi/json.lua
+ *
+ * This parser was measured to be 11.8 times faster than the vanilla parser at decoding a sample
+ * "save1.dat" file.
+ *
+ * @noSelfInFile
+ */
+
+export function encode(data: unknown): string;
+export function decode(data: string): unknown;