isaacscript-common 39.4.4 → 39.4.7

package/dist/index.rollup.d.ts

@@ -5773,9 +5773,13 @@ export declare function getLowestArrayElement(array: number[]): number | undefin
 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
- * attempting to find a match.
+ * Helper function to get the closest key from a map based on partial search text. (It only searches
+ * through the keys, not the values.)
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
  *
  * For example:
  *
@@ -5977,6 +5981,31 @@ export declare function getNumBitsOfN(n: int): int;
  */
 export declare function getNumRooms(): int;
 
+/**
+ * Helper function to get the closest key from an object based on partial search text. (It only
+ * searches through the keys, not the values.)
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
+ *
+ * For example:
+ *
+ * ```ts
+ * const object = {
+ *   foo: 123,
+ *   bar: 456,
+ * };
+ * const searchText = "f";
+ * const match = getObjectPartialMatch(object, searchText); // match is now equal to ["foo", 123]
+ * ```
+ *
+ * @returns If a match was found, returns a tuple of the map key and value. If a match was not
+ *          found, returns undefined.
+ */
+export declare function getObjectPartialMatch<T>(searchText: string, object: Record<string, T>): [string, T] | undefined;
+
 /**
  * Returns the slot number corresponding to where a trinket can be safely inserted.
  *
@@ -6015,8 +6044,11 @@ export declare function getParentFunctionDescription(this: void, levels?: number
 
 /**
  * Helper function to get the closest value from an array of strings based on partial search text.
- * For the purposes of this function, both search text and the array are converted to lowercase
- * before attempting to find a match.
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
  *
  * For example:
  *
@@ -13908,6 +13940,9 @@ export declare function onRepentanceStage(): boolean;
  * Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
  * pressing tab on the character selection screen). When the player resets the game on a set seed,
  * the game will not switch to a different seed.
+ *
+ * Under the hood, this checks if the current challenge is `Challenge.NULL` and the
+ * `Seeds.IsCustomRun` method.
  */
 export declare function onSetSeed(): boolean;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 39.4.4
+isaacscript-common 39.4.7
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -16369,6 +16369,8 @@ return ____exports
  end,
 ["src.functions.string"] = function(...) 
 local ____lualib = require("lualib_bundle")
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
 local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__StringReplaceAll = ____lualib.__TS__StringReplaceAll
 local __TS__StringStartsWith = ____lualib.__TS__StringStartsWith
@@ -16376,15 +16378,8 @@ local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__StringSlice = ____lualib.__TS__StringSlice
 local __TS__StringEndsWith = ____lualib.__TS__StringEndsWith
 local ____exports = {}
-function ____exports.capitalizeFirstLetter(self, ____string)
-    if ____string == "" then
-        return ____string
-    end
-    local firstCharacter = string.sub(____string, 1, 1)
-    local capitalizedFirstLetter = string.upper(firstCharacter)
-    local restOfString = string.sub(____string, 2)
-    return capitalizedFirstLetter .. restOfString
-end
+local ____utils = require("src.functions.utils")
+local assertDefined = ____utils.assertDefined
 function ____exports.getPartialMatch(self, searchText, array)
     __TS__ArraySort(array)
     searchText = string.lower(searchText)
@@ -16399,6 +16394,35 @@ function ____exports.getPartialMatch(self, searchText, array)
     __TS__ArraySort(matchingElements)
     return matchingElements[1]
 end
+function ____exports.capitalizeFirstLetter(self, ____string)
+    if ____string == "" then
+        return ____string
+    end
+    local firstCharacter = string.sub(____string, 1, 1)
+    local capitalizedFirstLetter = string.upper(firstCharacter)
+    local restOfString = string.sub(____string, 2)
+    return capitalizedFirstLetter .. restOfString
+end
+function ____exports.getMapPartialMatch(self, searchText, map)
+    local keys = {__TS__Spread(map:keys())}
+    local matchingKey = ____exports.getPartialMatch(nil, searchText, keys)
+    if matchingKey == nil then
+        return nil
+    end
+    local value = map:get(matchingKey)
+    assertDefined(nil, value, "Failed to get the map value corresponding to the partial match of: " .. matchingKey)
+    return {matchingKey, value}
+end
+function ____exports.getObjectPartialMatch(self, searchText, object)
+    local keys = __TS__ObjectKeys(object)
+    local matchingKey = ____exports.getPartialMatch(nil, searchText, keys)
+    if matchingKey == nil then
+        return nil
+    end
+    local value = object[matchingKey]
+    assertDefined(nil, value, "Failed to get the object value corresponding to the partial match of: " .. matchingKey)
+    return {matchingKey, value}
+end
 function ____exports.removeAllCharacters(self, ____string, character)
     return __TS__StringReplaceAll(____string, character, "")
 end
@@ -40434,10 +40458,6 @@ local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
 local ____array = require("src.functions.array")
 local sumArray = ____array.sumArray
-local ____string = require("src.functions.string")
-local getPartialMatch = ____string.getPartialMatch
-local ____utils = require("src.functions.utils")
-local assertDefined = ____utils.assertDefined
 function ____exports.mapSetHash(self, map, entity, value)
     local hash = GetPtrHash(entity)
     map:set(hash, value)
@@ -40458,16 +40478,6 @@ end
 function ____exports.defaultMapSetHash(self, map, entity, value)
     ____exports.mapSetHash(nil, map, entity, value)
 end
-function ____exports.getMapPartialMatch(self, searchText, map)
-    local keys = {__TS__Spread(map:keys())}
-    local matchingKey = getPartialMatch(nil, searchText, keys)
-    if matchingKey == nil then
-        return nil
-    end
-    local value = map:get(matchingKey)
-    assertDefined(nil, value, "Failed to get the map value corresponding to the partial match of: " .. matchingKey)
-    return {matchingKey, value}
-end
 function ____exports.getReversedMap(self, map)
     local reverseMap = __TS__New(Map)
     for ____, ____value in __TS__Iterator(map) do
@@ -49674,8 +49684,6 @@ local logPlayerEffects = ____logMisc.logPlayerEffects
 local logRoom = ____logMisc.logRoom
 local logSeedEffects = ____logMisc.logSeedEffects
 local logSounds = ____logMisc.logSounds
-local ____map = require("src.functions.map")
-local getMapPartialMatch = ____map.getMapPartialMatch
 local ____mergeTests = require("src.functions.mergeTests")
 local runMergeTests = ____mergeTests.runMergeTests
 local ____pickupsSpecific = require("src.functions.pickupsSpecific")
@@ -49705,6 +49713,8 @@ local ____spawnCollectible = require("src.functions.spawnCollectible")
 local spawnCollectibleUnsafe = ____spawnCollectible.spawnCollectibleUnsafe
 local ____stage = require("src.functions.stage")
 local setStage = ____stage.setStage
+local ____string = require("src.functions.string")
+local getMapPartialMatch = ____string.getMapPartialMatch
 local ____trinkets = require("src.functions.trinkets")
 local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
 local ____types = require("src.functions.types")
@@ -50786,8 +50796,8 @@ local isVanillaConsoleCommand = ____console.isVanillaConsoleCommand
 local ____flag = require("src.functions.flag")
 local addFlag = ____flag.addFlag
 local bitFlags = ____flag.bitFlags
-local ____map = require("src.functions.map")
-local getMapPartialMatch = ____map.getMapPartialMatch
+local ____string = require("src.functions.string")
+local getMapPartialMatch = ____string.getMapPartialMatch
 local ____utils = require("src.functions.utils")
 local assertDefined = ____utils.assertDefined
 local ____Feature = require("src.classes.private.Feature")

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

@@ -21,8 +21,8 @@ local isVanillaConsoleCommand = ____console.isVanillaConsoleCommand
 local ____flag = require("src.functions.flag")
 local addFlag = ____flag.addFlag
 local bitFlags = ____flag.bitFlags
-local ____map = require("src.functions.map")
-local getMapPartialMatch = ____map.getMapPartialMatch
+local ____string = require("src.functions.string")
+local getMapPartialMatch = ____string.getMapPartialMatch
 local ____utils = require("src.functions.utils")
 local assertDefined = ____utils.assertDefined
 local ____Feature = require("src.classes.private.Feature")

package/dist/src/classes/features/other/extraConsoleCommands/commands.lua

@@ -68,8 +68,6 @@ local logPlayerEffects = ____logMisc.logPlayerEffects
 local logRoom = ____logMisc.logRoom
 local logSeedEffects = ____logMisc.logSeedEffects
 local logSounds = ____logMisc.logSounds
-local ____map = require("src.functions.map")
-local getMapPartialMatch = ____map.getMapPartialMatch
 local ____mergeTests = require("src.functions.mergeTests")
 local runMergeTests = ____mergeTests.runMergeTests
 local ____pickupsSpecific = require("src.functions.pickupsSpecific")
@@ -99,6 +97,8 @@ local ____spawnCollectible = require("src.functions.spawnCollectible")
 local spawnCollectibleUnsafe = ____spawnCollectible.spawnCollectibleUnsafe
 local ____stage = require("src.functions.stage")
 local setStage = ____stage.setStage
+local ____string = require("src.functions.string")
+local getMapPartialMatch = ____string.getMapPartialMatch
 local ____trinkets = require("src.functions.trinkets")
 local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
 local ____types = require("src.functions.types")

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

@@ -16,26 +16,6 @@ export declare function defaultMapGetHash<V, A extends unknown[]>(map: DefaultMa
  * `mapSetHash` helper function.
  */
 export declare function defaultMapSetHash<V>(map: Map<PtrHash, V>, entity: Entity, value: V): void;
-/**
- * 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
- * attempting to find a match.
- *
- * For example:
- *
- * ```ts
- * const map = new <string, number>Map([
- *   ["foo", 123],
- *   ["bar", 456],
- * ]);
- * const searchText = "f";
- * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
- * ```
- *
- * @returns If a match was found, returns a tuple of the map key and value. If a match was not
- *          found, returns undefined.
- */
-export declare function getMapPartialMatch<T>(searchText: string, map: ReadonlyMap<string, T>): [string, T] | undefined;
 /**
  * Helper function to get a copy of a map with the keys and the values reversed.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/functions/map.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAOX;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,EACtD,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,GAAG,SAAS,EAAE,CAAC,GACd,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;GAkBG;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChE,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAahF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAGN;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CACpB,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACvD,MAAM,CAGR"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/functions/map.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAOX;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,EACtD,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,GAAG,SAAS,EAAE,CAAC,GACd,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChE,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAahF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAGN;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CACpB,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACvD,MAAM,CAGR"}

package/dist/src/functions/map.lua

@@ -6,10 +6,6 @@ local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
 local ____array = require("src.functions.array")
 local sumArray = ____array.sumArray
-local ____string = require("src.functions.string")
-local getPartialMatch = ____string.getPartialMatch
-local ____utils = require("src.functions.utils")
-local assertDefined = ____utils.assertDefined
 --- Helper function to set a value for a `DefaultMap` that corresponds to an entity, assuming that
 -- the map uses `PtrHash` as an index.
 function ____exports.mapSetHash(self, map, entity, value)
@@ -40,33 +36,6 @@ end
 function ____exports.defaultMapSetHash(self, map, entity, value)
     ____exports.mapSetHash(nil, map, entity, value)
 end
---- 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
--- attempting to find a match.
--- 
--- For example:
--- 
--- ```ts
--- const map = new <string, number>Map([
---   ["foo", 123],
---   ["bar", 456],
--- ]);
--- const searchText = "f";
--- const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
--- ```
--- 
--- @returns If a match was found, returns a tuple of the map key and value. If a match was not
--- found, returns undefined.
-function ____exports.getMapPartialMatch(self, searchText, map)
-    local keys = {__TS__Spread(map:keys())}
-    local matchingKey = getPartialMatch(nil, searchText, keys)
-    if matchingKey == nil then
-        return nil
-    end
-    local value = map:get(matchingKey)
-    assertDefined(nil, value, "Failed to get the map value corresponding to the partial match of: " .. matchingKey)
-    return {matchingKey, value}
-end
 --- Helper function to get a copy of a map with the keys and the values reversed.
 -- 
 -- For example:

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

@@ -13,6 +13,9 @@ export declare function isGreedMode(): boolean;
  * Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
  * pressing tab on the character selection screen). When the player resets the game on a set seed,
  * the game will not switch to a different seed.
+ *
+ * Under the hood, this checks if the current challenge is `Challenge.NULL` and the
+ * `Seeds.IsCustomRun` method.
  */
 export declare function onSetSeed(): boolean;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAa/D;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAkBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAa/D;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAkBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/src/functions/run.lua

@@ -31,6 +31,9 @@ end
 --- Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
 -- pressing tab on the character selection screen). When the player resets the game on a set seed,
 -- the game will not switch to a different seed.
+-- 
+-- Under the hood, this checks if the current challenge is `Challenge.NULL` and the
+-- `Seeds.IsCustomRun` method.
 function ____exports.onSetSeed(self)
     local seeds = game:GetSeeds()
     local customRun = seeds:IsCustomRun()

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

@@ -1,8 +1,59 @@
 export declare function capitalizeFirstLetter(string: string): string;
+/**
+ * Helper function to get the closest key from a map based on partial search text. (It only searches
+ * through the keys, not the values.)
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
+ *
+ * For example:
+ *
+ * ```ts
+ * const map = new <string, number>Map([
+ *   ["foo", 123],
+ *   ["bar", 456],
+ * ]);
+ * const searchText = "f";
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
+ * ```
+ *
+ * @returns If a match was found, returns a tuple of the map key and value. If a match was not
+ *          found, returns undefined.
+ */
+export declare function getMapPartialMatch<T>(searchText: string, map: ReadonlyMap<string, T>): [string, T] | undefined;
+/**
+ * Helper function to get the closest key from an object based on partial search text. (It only
+ * searches through the keys, not the values.)
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
+ *
+ * For example:
+ *
+ * ```ts
+ * const object = {
+ *   foo: 123,
+ *   bar: 456,
+ * };
+ * const searchText = "f";
+ * const match = getObjectPartialMatch(object, searchText); // match is now equal to ["foo", 123]
+ * ```
+ *
+ * @returns If a match was found, returns a tuple of the map key and value. If a match was not
+ *          found, returns undefined.
+ */
+export declare function getObjectPartialMatch<T>(searchText: string, object: Record<string, T>): [string, T] | undefined;
 /**
  * Helper function to get the closest value from an array of strings based on partial search text.
- * For the purposes of this function, both search text and the array are converted to lowercase
- * before attempting to find a match.
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
  *
  * For example:
  *

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

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/functions/string.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,GAAG,SAAS,CAYpB;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,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"}

package/dist/src/functions/string.lua

@@ -1,4 +1,6 @@
 local ____lualib = require("lualib_bundle")
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
 local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__StringReplaceAll = ____lualib.__TS__StringReplaceAll
 local __TS__StringStartsWith = ____lualib.__TS__StringStartsWith
@@ -6,18 +8,14 @@ local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__StringSlice = ____lualib.__TS__StringSlice
 local __TS__StringEndsWith = ____lualib.__TS__StringEndsWith
 local ____exports = {}
-function ____exports.capitalizeFirstLetter(self, ____string)
-    if ____string == "" then
-        return ____string
-    end
-    local firstCharacter = string.sub(____string, 1, 1)
-    local capitalizedFirstLetter = string.upper(firstCharacter)
-    local restOfString = string.sub(____string, 2)
-    return capitalizedFirstLetter .. restOfString
-end
+local ____utils = require("src.functions.utils")
+local assertDefined = ____utils.assertDefined
 --- Helper function to get the closest value from an array of strings based on partial search text.
--- For the purposes of this function, both search text and the array are converted to lowercase
--- before attempting to find a match.
+-- 
+-- Note that:
+-- - Spaces are automatically removed from the search text.
+-- - Both the search text and the strings to search through are converted to lowercase before
+--   attempting to find a match.
 -- 
 -- For example:
 -- 
@@ -43,6 +41,77 @@ function ____exports.getPartialMatch(self, searchText, array)
     __TS__ArraySort(matchingElements)
     return matchingElements[1]
 end
+function ____exports.capitalizeFirstLetter(self, ____string)
+    if ____string == "" then
+        return ____string
+    end
+    local firstCharacter = string.sub(____string, 1, 1)
+    local capitalizedFirstLetter = string.upper(firstCharacter)
+    local restOfString = string.sub(____string, 2)
+    return capitalizedFirstLetter .. restOfString
+end
+--- Helper function to get the closest key from a map based on partial search text. (It only searches
+-- through the keys, not the values.)
+-- 
+-- Note that:
+-- - Spaces are automatically removed from the search text.
+-- - Both the search text and the strings to search through are converted to lowercase before
+--   attempting to find a match.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const map = new <string, number>Map([
+--   ["foo", 123],
+--   ["bar", 456],
+-- ]);
+-- const searchText = "f";
+-- const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
+-- ```
+-- 
+-- @returns If a match was found, returns a tuple of the map key and value. If a match was not
+-- found, returns undefined.
+function ____exports.getMapPartialMatch(self, searchText, map)
+    local keys = {__TS__Spread(map:keys())}
+    local matchingKey = ____exports.getPartialMatch(nil, searchText, keys)
+    if matchingKey == nil then
+        return nil
+    end
+    local value = map:get(matchingKey)
+    assertDefined(nil, value, "Failed to get the map value corresponding to the partial match of: " .. matchingKey)
+    return {matchingKey, value}
+end
+--- Helper function to get the closest key from an object based on partial search text. (It only
+-- searches through the keys, not the values.)
+-- 
+-- Note that:
+-- - Spaces are automatically removed from the search text.
+-- - Both the search text and the strings to search through are converted to lowercase before
+--   attempting to find a match.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const object = {
+--   foo: 123,
+--   bar: 456,
+-- };
+-- const searchText = "f";
+-- const match = getObjectPartialMatch(object, searchText); // match is now equal to ["foo", 123]
+-- ```
+-- 
+-- @returns If a match was found, returns a tuple of the map key and value. If a match was not
+-- found, returns undefined.
+function ____exports.getObjectPartialMatch(self, searchText, object)
+    local keys = __TS__ObjectKeys(object)
+    local matchingKey = ____exports.getPartialMatch(nil, searchText, keys)
+    if matchingKey == nil then
+        return nil
+    end
+    local value = object[matchingKey]
+    assertDefined(nil, value, "Failed to get the object value corresponding to the partial match of: " .. matchingKey)
+    return {matchingKey, value}
+end
 function ____exports.removeAllCharacters(self, ____string, character)
     return __TS__StringReplaceAll(____string, character, "")
 end

package/package.json

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

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

@@ -10,7 +10,7 @@ import { Exported } from "../../../decorators";
 import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
 import { isVanillaConsoleCommand } from "../../../functions/console";
 import { addFlag, bitFlags } from "../../../functions/flag";
-import { getMapPartialMatch } from "../../../functions/map";
+import { getMapPartialMatch } from "../../../functions/string";
 import { assertDefined } from "../../../functions/utils";
 import { Feature } from "../../private/Feature";
 import * as commands from "./extraConsoleCommands/commands";

package/src/classes/features/other/extraConsoleCommands/commands.ts

@@ -100,7 +100,6 @@ import {
   logSeedEffects,
   logSounds,
 } from "../../../../functions/logMisc";
-import { getMapPartialMatch } from "../../../../functions/map";
 import { runMergeTests } from "../../../../functions/mergeTests";
 import {
   spawnCard,
@@ -121,6 +120,7 @@ import { changeRoom } from "../../../../functions/rooms";
 import { onSetSeed, restart, setUnseeded } from "../../../../functions/run";
 import { spawnCollectibleUnsafe } from "../../../../functions/spawnCollectible";
 import { setStage } from "../../../../functions/stage";
+import { getMapPartialMatch } from "../../../../functions/string";
 import { getGoldenTrinketType } from "../../../../functions/trinkets";
 import {
   asCardType,

package/src/functions/map.ts

@@ -1,7 +1,5 @@
 import type { DefaultMap } from "../classes/DefaultMap";
 import { sumArray } from "./array";
-import { getPartialMatch } from "./string";
-import { assertDefined } from "./utils";
 
 /** Helper function to copy a map. (You can also use a Map constructor to accomplish this task.) */
 export function copyMap<K, V>(
@@ -43,45 +41,6 @@ export function defaultMapSetHash<V>(
   mapSetHash(map, entity, value);
 }
 
-/**
- * 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
- * attempting to find a match.
- *
- * For example:
- *
- * ```ts
- * const map = new <string, number>Map([
- *   ["foo", 123],
- *   ["bar", 456],
- * ]);
- * const searchText = "f";
- * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
- * ```
- *
- * @returns If a match was found, returns a tuple of the map key and value. If a match was not
- *          found, returns undefined.
- */
-export function getMapPartialMatch<T>(
-  searchText: string,
-  map: ReadonlyMap<string, T>,
-): [string, T] | undefined {
-  const keys = [...map.keys()];
-
-  const matchingKey = getPartialMatch(searchText, keys);
-  if (matchingKey === undefined) {
-    return undefined;
-  }
-
-  const value = map.get(matchingKey);
-  assertDefined(
-    value,
-    `Failed to get the map value corresponding to the partial match of: ${matchingKey}`,
-  );
-
-  return [matchingKey, value];
-}
-
 /**
  * Helper function to get a copy of a map with the keys and the values reversed.
  *

package/src/functions/run.ts

@@ -42,6 +42,9 @@ export function isGreedMode(): boolean {
  * Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
  * pressing tab on the character selection screen). When the player resets the game on a set seed,
  * the game will not switch to a different seed.
+ *
+ * Under the hood, this checks if the current challenge is `Challenge.NULL` and the
+ * `Seeds.IsCustomRun` method.
  */
 export function onSetSeed(): boolean {
   const seeds = game.GetSeeds();

package/src/functions/string.ts

@@ -1,3 +1,5 @@
+import { assertDefined } from "./utils";
+
 export function capitalizeFirstLetter(string: string): string {
   if (string === "") {
     return string;
@@ -10,10 +12,99 @@ export function capitalizeFirstLetter(string: string): string {
   return `${capitalizedFirstLetter}${restOfString}`;
 }
 
+/**
+ * Helper function to get the closest key from a map based on partial search text. (It only searches
+ * through the keys, not the values.)
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
+ *
+ * For example:
+ *
+ * ```ts
+ * const map = new <string, number>Map([
+ *   ["foo", 123],
+ *   ["bar", 456],
+ * ]);
+ * const searchText = "f";
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
+ * ```
+ *
+ * @returns If a match was found, returns a tuple of the map key and value. If a match was not
+ *          found, returns undefined.
+ */
+export function getMapPartialMatch<T>(
+  searchText: string,
+  map: ReadonlyMap<string, T>,
+): [string, T] | undefined {
+  const keys = [...map.keys()];
+
+  const matchingKey = getPartialMatch(searchText, keys);
+  if (matchingKey === undefined) {
+    return undefined;
+  }
+
+  const value = map.get(matchingKey);
+  assertDefined(
+    value,
+    `Failed to get the map value corresponding to the partial match of: ${matchingKey}`,
+  );
+
+  return [matchingKey, value];
+}
+
+/**
+ * Helper function to get the closest key from an object based on partial search text. (It only
+ * searches through the keys, not the values.)
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
+ *
+ * For example:
+ *
+ * ```ts
+ * const object = {
+ *   foo: 123,
+ *   bar: 456,
+ * };
+ * const searchText = "f";
+ * const match = getObjectPartialMatch(object, searchText); // match is now equal to ["foo", 123]
+ * ```
+ *
+ * @returns If a match was found, returns a tuple of the map key and value. If a match was not
+ *          found, returns undefined.
+ */
+export function getObjectPartialMatch<T>(
+  searchText: string,
+  object: Record<string, T>,
+): [string, T] | undefined {
+  const keys = Object.keys(object);
+
+  const matchingKey = getPartialMatch(searchText, keys);
+  if (matchingKey === undefined) {
+    return undefined;
+  }
+
+  const value = object[matchingKey];
+  assertDefined(
+    value,
+    `Failed to get the object value corresponding to the partial match of: ${matchingKey}`,
+  );
+
+  return [matchingKey, value];
+}
+
 /**
  * Helper function to get the closest value from an array of strings based on partial search text.
- * For the purposes of this function, both search text and the array are converted to lowercase
- * before attempting to find a match.
+ *
+ * Note that:
+ * - Spaces are automatically removed from the search text.
+ * - Both the search text and the strings to search through are converted to lowercase before
+ *   attempting to find a match.
  *
  * For example:
  *