isaacscript-common 80.0.0 → 80.2.0

package/dist/functions/set.d.ts

@@ -58,10 +58,46 @@ export declare function getSetCombinations<T>(set: Set<T> | ReadonlySet<T>, incl
 /**
  * Helper function to get a sorted array based on the contents of a set.
  *
- * Normally, set values are returned in a random order, so use this function when the ordering of
+ * 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: Set<T> | ReadonlySet<T>): T[];
+/**
+ * Helper function to convert the keys of an object to a read-only set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectKeysToSet` function.
+ */
+export declare function objectKeysToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<K>;
+/**
+ * Helper function to convert the keys of an object to a set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectKeysToReadonlySet` function.
+ */
+export declare function objectKeysToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<K>;
+/**
+ * Helper function to convert the values of an object to a read-only set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectValuesToSet` function.
+ */
+export declare function objectValuesToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<V>;
+/**
+ * Helper function to convert the values of an object to a set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectValuesToReadonlySet` function.
+ */
+export declare function objectValuesToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<V>;
 /**
  * Helper function to add one or more elements to a set at once without having to repeatedly call
  * the `Set.add` method.

package/dist/functions/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/functions/set.ts"],"names":[],"mappings":";;AAIA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EACf,GAAG,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAC3C,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GACtC,GAAG,CAAC,CAAC,CAAC,CASR;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EACf,GAAG,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAC9C,IAAI,CAMN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAC5B,SAAS,EAAE,IAAI,GAAG,GAAG,GAAG,SAAS,EACjC,UAAU,GAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAO,GAClC,CAAC,CAGH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAC5B,iBAAiB,EAAE,OAAO,GACzB,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAK/B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAkBvE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,EAAE,GAAG,IAAI,CAI7D;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAC5B,GAAG,QAAQ,EAAE,CAAC,EAAE,GACf,OAAO,CAET;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAGrE"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/functions/set.ts"],"names":[],"mappings":"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"}

package/dist/functions/set.lua

@@ -5,6 +5,8 @@ local __TS__New = ____lualib.__TS__New
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local __TS__Spread = ____lualib.__TS__Spread
 local __TS__ArraySort = ____lualib.__TS__ArraySort
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
+local __TS__ObjectValues = ____lualib.__TS__ObjectValues
 local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
 local ____ReadonlySet = require("types.ReadonlySet")
@@ -17,20 +19,45 @@ local ____types = require("functions.types")
 local isPrimitive = ____types.isPrimitive
 --- Helper function to get a sorted array based on the contents of a set.
 -- 
--- Normally, set values are returned in a random order, so use this function when the ordering of
+-- Normally, set values are returned in insertion order, so use this function when the ordering of
 -- the contents is important.
 function ____exports.getSortedSetValues(self, set)
-    local values = set:values()
-    local array = {__TS__Spread(values)}
-    local firstElement = array[1]
+    local values = {__TS__Spread(set)}
+    local firstElement = values[1]
     if firstElement ~= nil then
         local arrayType = type(firstElement)
         if not isPrimitive(nil, arrayType) then
             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(array)
-    return array
+    __TS__ArraySort(values)
+    return values
+end
+--- Helper function to convert the keys of an object to a set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectKeysToReadonlySet` function.
+function ____exports.objectKeysToSet(self, object)
+    local set = __TS__New(Set)
+    for ____, key in ipairs(__TS__ObjectKeys(object)) do
+        set:add(key)
+    end
+    return set
+end
+--- Helper function to convert the values of an object to a set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectValuesToReadonlySet` function.
+function ____exports.objectValuesToSet(self, object)
+    local set = __TS__New(Set)
+    for ____, key in ipairs(__TS__ObjectValues(object)) do
+        set:add(key)
+    end
+    return set
 end
 --- Helper function to add all of the values in one set to another set. The first set passed will be
 -- modified in place.
@@ -39,7 +66,7 @@ end
 function ____exports.addSetsToSet(self, mainSet, ...)
     local setsToAdd = {...}
     for ____, set in ipairs(setsToAdd) do
-        for ____, value in __TS__Iterator(set:values()) do
+        for ____, value in __TS__Iterator(set) do
             mainSet:add(value)
         end
     end
@@ -51,7 +78,7 @@ function ____exports.combineSets(self, ...)
     local sets = {...}
     local newSet = __TS__New(Set)
     for ____, set in ipairs(sets) do
-        for ____, value in __TS__Iterator(set:values()) do
+        for ____, value in __TS__Iterator(set) do
             newSet:add(value)
         end
     end
@@ -60,7 +87,7 @@ end
 --- Helper function to copy a set. (You can also use a Set constructor to accomplish this task.)
 function ____exports.copySet(self, oldSet)
     local newSet = __TS__New(Set)
-    for ____, value in __TS__Iterator(oldSet:values()) do
+    for ____, value in __TS__Iterator(oldSet) do
         newSet:add(value)
     end
     return newSet
@@ -72,7 +99,7 @@ end
 function ____exports.deleteSetsFromSet(self, mainSet, ...)
     local setsToRemove = {...}
     for ____, set in ipairs(setsToRemove) do
-        for ____, value in __TS__Iterator(set:values()) do
+        for ____, value in __TS__Iterator(set) do
             mainSet:delete(value)
         end
     end
@@ -119,6 +146,24 @@ function ____exports.getSetCombinations(self, set, includeEmptyArray)
         function(____, array) return __TS__New(ReadonlySet, array) end
     )
 end
+--- Helper function to convert the keys of an object to a read-only set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectKeysToSet` function.
+function ____exports.objectKeysToReadonlySet(self, object)
+    return ____exports.objectKeysToSet(nil, object)
+end
+--- Helper function to convert the values of an object to a read-only set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectValuesToSet` function.
+function ____exports.objectValuesToReadonlySet(self, object)
+    return ____exports.objectValuesToSet(nil, object)
+end
 --- Helper function to add one or more elements to a set at once without having to repeatedly call
 -- the `Set.add` method.
 -- 
@@ -143,7 +188,7 @@ function ____exports.setHas(self, set, ...)
 end
 --- Helper function to sum every value in a set together.
 function ____exports.sumSet(self, set)
-    local values = {__TS__Spread(set:values())}
+    local values = {__TS__Spread(set)}
     return sumArray(nil, values)
 end
 return ____exports

package/dist/functions/string.d.ts

@@ -98,4 +98,5 @@ export declare function removeSubstring(string: string, ...substrings: string[])
 export declare function trimPrefix(string: string, prefix: string): string;
 /** Helper function to trim a suffix from a string, if it exists. Returns the trimmed string. */
 export declare function trimSuffix(string: string, prefix: string): string;
+export declare function uncapitalizeFirstLetter(string: string): string;
 //# sourceMappingURL=string.d.ts.map

package/dist/functions/string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/functions/string.ts"],"names":[],"mappings":";AAEA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAC1B,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAezB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GACxB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAezB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GACtD;IACE,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC;CACnB,GACD,SAAS,CAyBZ;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED,8FAA8F;AAC9F,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,GAAG,UAAU,EAAE,MAAM,EAAE,GACtB,MAAM,CAMR;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjE"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/functions/string.ts"],"names":[],"mappings":";AAEA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAC1B,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAezB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GACxB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAezB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GACtD;IACE,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC;CACnB,GACD,SAAS,CAyBZ;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED,8FAA8F;AAC9F,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,GAAG,UAAU,EAAE,MAAM,EAAE,GACtB,MAAM,CAMR;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU9D"}

package/dist/functions/string.lua

@@ -169,4 +169,13 @@ function ____exports.trimSuffix(self, ____string, prefix)
     local endCharacter = #____string - #prefix
     return __TS__StringSlice(____string, 0, endCharacter)
 end
+function ____exports.uncapitalizeFirstLetter(self, ____string)
+    if ____string == "" then
+        return ____string
+    end
+    local firstCharacter = string.sub(____string, 1, 1)
+    local uncapitalizedFirstLetter = string.lower(firstCharacter)
+    local restOfString = string.sub(____string, 2)
+    return uncapitalizedFirstLetter .. restOfString
+end
 return ____exports

package/dist/index.rollup.d.ts

@@ -7874,7 +7874,7 @@ export declare function getSlots(slotVariant?: SlotVariant | -1, subType?: numbe
 /**
  * Helper function to get a sorted array based on the contents of a set.
  *
- * Normally, set values are returned in a random order, so use this function when the ordering of
+ * 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: Set<T> | ReadonlySet<T>): T[];
@@ -14889,6 +14889,26 @@ export declare const NUM_VANILLA_PILL_EFFECTS: int;
 /** Calculated from the `TrinketType` enum. (`TrinketType.NULL` is not included.) */
 export declare const NUM_VANILLA_TRINKET_TYPES: number;
 
+/**
+ * Helper function to convert the keys of an object to a read-only set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectKeysToSet` function.
+ */
+export declare function objectKeysToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<K>;
+
+/**
+ * Helper function to convert the keys of an object to a set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectKeysToReadonlySet` function.
+ */
+export declare function objectKeysToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<K>;
+
 /**
  * Helper function to convert an object to a map.
  *
@@ -14919,6 +14939,26 @@ export declare function objectToMap<K extends string | number | symbol, V>(objec
  */
 export declare function objectToReadonlyMap<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlyMap<K, V>;
 
+/**
+ * Helper function to convert the values of an object to a read-only set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectValuesToSet` function.
+ */
+export declare function objectValuesToReadonlySet<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlySet<V>;
+
+/**
+ * Helper function to convert the values of an object to a set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectValuesToReadonlySet` function.
+ */
+export declare function objectValuesToSet<K extends string | number | symbol, V>(object: Record<K, V>): Set<V>;
+
 /** Helper function to see if the player is playing any challenge. */
 export declare function onAnyChallenge(): boolean;
 
@@ -18970,6 +19010,8 @@ export declare type TupleWithMaxLength<T, MaxLength extends number> = (T[] | rea
  */
 export declare const UI_HEART_WIDTH = 12;
 
+export declare function uncapitalizeFirstLetter(string: string): string;
+
 /** Helper type to convert a union to an intersection. */
 export declare type UnionToIntersection<U> = (U extends U ? (u: U) => 0 : never) extends (i: infer I) => 0 ? Extract<I, U> : never;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 79.3.0
+isaacscript-common 80.1.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -18095,6 +18095,15 @@ function ____exports.trimSuffix(self, ____string, prefix)
     local endCharacter = #____string - #prefix
     return __TS__StringSlice(____string, 0, endCharacter)
 end
+function ____exports.uncapitalizeFirstLetter(self, ____string)
+    if ____string == "" then
+        return ____string
+    end
+    local firstCharacter = string.sub(____string, 1, 1)
+    local uncapitalizedFirstLetter = string.lower(firstCharacter)
+    local restOfString = string.sub(____string, 2)
+    return uncapitalizedFirstLetter .. restOfString
+end
 return ____exports
  end,
 ["functions.isaacAPIClass"] = function(...) 
@@ -44239,6 +44248,8 @@ local __TS__New = ____lualib.__TS__New
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local __TS__Spread = ____lualib.__TS__Spread
 local __TS__ArraySort = ____lualib.__TS__ArraySort
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
+local __TS__ObjectValues = ____lualib.__TS__ObjectValues
 local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
 local ____ReadonlySet = require("types.ReadonlySet")
@@ -44251,20 +44262,45 @@ local ____types = require("functions.types")
 local isPrimitive = ____types.isPrimitive
 --- Helper function to get a sorted array based on the contents of a set.
 -- 
--- Normally, set values are returned in a random order, so use this function when the ordering of
+-- Normally, set values are returned in insertion order, so use this function when the ordering of
 -- the contents is important.
 function ____exports.getSortedSetValues(self, set)
-    local values = set:values()
-    local array = {__TS__Spread(values)}
-    local firstElement = array[1]
+    local values = {__TS__Spread(set)}
+    local firstElement = values[1]
     if firstElement ~= nil then
         local arrayType = type(firstElement)
         if not isPrimitive(nil, arrayType) then
             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(array)
-    return array
+    __TS__ArraySort(values)
+    return values
+end
+--- Helper function to convert the keys of an object to a set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectKeysToReadonlySet` function.
+function ____exports.objectKeysToSet(self, object)
+    local set = __TS__New(Set)
+    for ____, key in ipairs(__TS__ObjectKeys(object)) do
+        set:add(key)
+    end
+    return set
+end
+--- Helper function to convert the values of an object to a set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectValuesToReadonlySet` function.
+function ____exports.objectValuesToSet(self, object)
+    local set = __TS__New(Set)
+    for ____, key in ipairs(__TS__ObjectValues(object)) do
+        set:add(key)
+    end
+    return set
 end
 --- Helper function to add all of the values in one set to another set. The first set passed will be
 -- modified in place.
@@ -44273,7 +44309,7 @@ end
 function ____exports.addSetsToSet(self, mainSet, ...)
     local setsToAdd = {...}
     for ____, set in ipairs(setsToAdd) do
-        for ____, value in __TS__Iterator(set:values()) do
+        for ____, value in __TS__Iterator(set) do
             mainSet:add(value)
         end
     end
@@ -44285,7 +44321,7 @@ function ____exports.combineSets(self, ...)
     local sets = {...}
     local newSet = __TS__New(Set)
     for ____, set in ipairs(sets) do
-        for ____, value in __TS__Iterator(set:values()) do
+        for ____, value in __TS__Iterator(set) do
             newSet:add(value)
         end
     end
@@ -44294,7 +44330,7 @@ end
 --- Helper function to copy a set. (You can also use a Set constructor to accomplish this task.)
 function ____exports.copySet(self, oldSet)
     local newSet = __TS__New(Set)
-    for ____, value in __TS__Iterator(oldSet:values()) do
+    for ____, value in __TS__Iterator(oldSet) do
         newSet:add(value)
     end
     return newSet
@@ -44306,7 +44342,7 @@ end
 function ____exports.deleteSetsFromSet(self, mainSet, ...)
     local setsToRemove = {...}
     for ____, set in ipairs(setsToRemove) do
-        for ____, value in __TS__Iterator(set:values()) do
+        for ____, value in __TS__Iterator(set) do
             mainSet:delete(value)
         end
     end
@@ -44353,6 +44389,24 @@ function ____exports.getSetCombinations(self, set, includeEmptyArray)
         function(____, array) return __TS__New(ReadonlySet, array) end
     )
 end
+--- Helper function to convert the keys of an object to a read-only set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectKeysToSet` function.
+function ____exports.objectKeysToReadonlySet(self, object)
+    return ____exports.objectKeysToSet(nil, object)
+end
+--- Helper function to convert the values of an object to a read-only set.
+-- 
+-- Note that the set values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectValuesToSet` function.
+function ____exports.objectValuesToReadonlySet(self, object)
+    return ____exports.objectValuesToSet(nil, object)
+end
 --- Helper function to add one or more elements to a set at once without having to repeatedly call
 -- the `Set.add` method.
 -- 
@@ -44377,7 +44431,7 @@ function ____exports.setHas(self, set, ...)
 end
 --- Helper function to sum every value in a set together.
 function ____exports.sumSet(self, set)
-    local values = {__TS__Spread(set:values())}
+    local values = {__TS__Spread(set)}
     return sumArray(nil, values)
 end
 return ____exports

package/package.json

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

package/src/functions/set.ts

@@ -13,7 +13,7 @@ export function addSetsToSet<T>(
   ...setsToAdd: Array<Set<T> | ReadonlySet<T>>
 ): void {
   for (const set of setsToAdd) {
-    for (const value of set.values()) {
+    for (const value of set) {
       mainSet.add(value);
     }
   }
@@ -29,7 +29,7 @@ export function combineSets<T>(
 ): Set<T> {
   const newSet = new Set<T>();
   for (const set of sets) {
-    for (const value of set.values()) {
+    for (const value of set) {
       newSet.add(value);
     }
   }
@@ -40,7 +40,7 @@ export function combineSets<T>(
 /** Helper function to copy a set. (You can also use a Set constructor to accomplish this task.) */
 export function copySet<T>(oldSet: Set<T> | ReadonlySet<T>): Set<T> {
   const newSet = new Set<T>();
-  for (const value of oldSet.values()) {
+  for (const value of oldSet) {
     newSet.add(value);
   }
 
@@ -58,7 +58,7 @@ export function deleteSetsFromSet<T>(
   ...setsToRemove: Array<Set<T> | ReadonlySet<T>>
 ): void {
   for (const set of setsToRemove) {
-    for (const value of set.values()) {
+    for (const value of set) {
       mainSet.delete(value);
     }
   }
@@ -117,15 +117,14 @@ export function getSetCombinations<T>(
 /**
  * Helper function to get a sorted array based on the contents of a set.
  *
- * Normally, set values are returned in a random order, so use this function when the ordering of
+ * Normally, set values are returned in insertion order, so use this function when the ordering of
  * the contents is important.
  */
 export function getSortedSetValues<T>(set: Set<T> | ReadonlySet<T>): T[] {
-  const values = set.values();
-  const array = [...values];
+  const values = [...set];
 
   // Check for problematic types in order to throw a helpful error message.
-  const firstElement = array[0];
+  const firstElement = values[0];
   if (firstElement !== undefined) {
     const arrayType = type(firstElement);
     if (!isPrimitive(arrayType)) {
@@ -135,9 +134,78 @@ export function getSortedSetValues<T>(set: Set<T> | ReadonlySet<T>): T[] {
     }
   }
 
-  array.sort();
+  values.sort();
 
-  return array;
+  return values;
+}
+
+/**
+ * Helper function to convert the keys of an object to a read-only set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectKeysToSet` function.
+ */
+export function objectKeysToReadonlySet<K extends string | number | symbol, V>(
+  object: Record<K, V>,
+): ReadonlySet<K> {
+  return objectKeysToSet(object);
+}
+
+/**
+ * Helper function to convert the keys of an object to a set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectKeysToReadonlySet` function.
+ */
+export function objectKeysToSet<K extends string | number | symbol, V>(
+  object: Record<K, V>,
+): Set<K> {
+  const set = new Set<K>();
+
+  for (const key of Object.keys(object)) {
+    set.add(key as K);
+  }
+
+  return set;
+}
+
+/**
+ * Helper function to convert the values of an object to a read-only set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectValuesToSet` function.
+ */
+export function objectValuesToReadonlySet<
+  K extends string | number | symbol,
+  V,
+>(object: Record<K, V>): ReadonlySet<V> {
+  return objectValuesToSet(object);
+}
+
+/**
+ * Helper function to convert the values of an object to a set.
+ *
+ * Note that the set values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectValuesToReadonlySet` function.
+ */
+export function objectValuesToSet<K extends string | number | symbol, V>(
+  object: Record<K, V>,
+): Set<V> {
+  const set = new Set<V>();
+
+  for (const key of Object.values(object)) {
+    set.add(key as V);
+  }
+
+  return set;
 }
 
 /**
@@ -168,6 +236,6 @@ export function setHas<T>(
 
 /** Helper function to sum every value in a set together. */
 export function sumSet(set: Set<number> | ReadonlySet<number>): number {
-  const values = [...set.values()];
+  const values = [...set];
   return sumArray(values);
 }

package/src/functions/string.ts

@@ -230,3 +230,15 @@ export function trimSuffix(string: string, prefix: string): string {
   const endCharacter = string.length - prefix.length;
   return string.slice(0, endCharacter);
 }
+
+export function uncapitalizeFirstLetter(string: string): string {
+  if (string === "") {
+    return string;
+  }
+
+  const firstCharacter = string.charAt(0);
+  const uncapitalizedFirstLetter = firstCharacter.toLowerCase();
+  const restOfString = string.slice(1);
+
+  return `${uncapitalizedFirstLetter}${restOfString}`;
+}