isaacscript-common 8.0.0 → 8.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/functions/map.ts"],"names":[],"mappings":"AAEA,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAO1D;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,CAuBzB;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":"AAGA,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAO1D;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,CAgBzB;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/functions/map.lua

@@ -3,13 +3,11 @@ local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__Spread = ____lualib.__TS__Spread
-local __TS__ArraySort = ____lualib.__TS__ArraySort
-local __TS__StringReplaceAll = ____lualib.__TS__StringReplaceAll
-local __TS__StringStartsWith = ____lualib.__TS__StringStartsWith
-local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local ____array = require("functions.array")
 local sumArray = ____array.sumArray
+local ____string = require("functions.string")
+local getPartialMatch = ____string.getPartialMatch
 --- Helper function to copy a map. (You can also use a Map constructor to accomplish this task.)
 function ____exports.copyMap(self, oldMap)
     local newMap = __TS__New(Map)
@@ -39,24 +37,13 @@ end
 -- ```
 function ____exports.getMapPartialMatch(self, searchText, map)
     local keys = {__TS__Spread(map:keys())}
-    __TS__ArraySort(keys)
-    searchText = string.lower(searchText)
-    searchText = __TS__StringReplaceAll(searchText, " ", "")
-    local matchingKeys = __TS__ArrayFilter(
-        keys,
-        function(____, key) return __TS__StringStartsWith(
-            string.lower(key),
-            searchText
-        ) end
-    )
-    __TS__ArraySort(matchingKeys)
-    local matchingKey = matchingKeys[1]
+    local matchingKey = getPartialMatch(nil, searchText, keys)
     if matchingKey == nil then
         return nil
     end
     local value = map:get(matchingKey)
     if value == nil then
-        return nil
+        error("Failed to get the map value corresponding to the partial match of: " .. matchingKey)
     end
     return {matchingKey, value}
 end

package/dist/functions/players.d.ts

@@ -279,6 +279,18 @@ export declare function playerAddCollectible(player: EntityPlayer, ...collectibl
  * check for. Returns true if the player has any of the supplied collectible types.
  */
 export declare function playerHasCollectible(player: EntityPlayer, ...collectibleTypes: CollectibleType[]): boolean;
+/**
+ * Helper function to remove all of the active items from a player. This includes the Schoolbag item
+ * and any pocket actives.
+ */
+export declare function removeAllActiveItems(player: EntityPlayer): void;
+/**
+ * Helper function to remove all of the held trinkets from a player.
+ *
+ * This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
+ * they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+ */
+export declare function removeAllPlayerTrinkets(player: EntityPlayer): void;
 /**
  * Helper function to remove a collectible costume from a player. Use this helper function to avoid
  * having to request the collectible from the item config.

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

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

package/dist/functions/players.lua

@@ -18,6 +18,7 @@ local FamiliarVariant = ____isaac_2Dtypescript_2Ddefinitions.FamiliarVariant
 local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
 local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local TrinketSlot = ____isaac_2Dtypescript_2Ddefinitions.TrinketSlot
 local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
@@ -682,6 +683,48 @@ function ____exports.playerHasCollectible(self, player, ...)
         function(____, collectibleType) return player:HasCollectible(collectibleType) end
     )
 end
+--- Helper function to remove all of the active items from a player. This includes the Schoolbag item
+-- and any pocket actives.
+function ____exports.removeAllActiveItems(self, player)
+    for ____, activeSlot in ipairs(getEnumValues(nil, ActiveSlot)) do
+        do
+            local collectibleType = player:GetActiveItem(activeSlot)
+            if collectibleType == CollectibleType.NULL then
+                goto __continue114
+            end
+            local hasCollectible
+            repeat
+                do
+                    player:RemoveCollectible(collectibleType)
+                    hasCollectible = player:HasCollectible(collectibleType)
+                end
+            until not hasCollectible
+        end
+        ::__continue114::
+    end
+end
+--- Helper function to remove all of the held trinkets from a player.
+-- 
+-- This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
+-- they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+function ____exports.removeAllPlayerTrinkets(self, player)
+    for ____, trinketSlot in ipairs(getEnumValues(nil, TrinketSlot)) do
+        do
+            local trinketType = player:GetTrinket(trinketSlot)
+            if trinketType == TrinketType.NULL then
+                goto __continue119
+            end
+            local hasTrinket
+            repeat
+                do
+                    player:TryRemoveTrinket(trinketType)
+                    hasTrinket = player:HasTrinket(trinketType)
+                end
+            until not hasTrinket
+        end
+        ::__continue119::
+    end
+end
 --- Helper function to remove a collectible costume from a player. Use this helper function to avoid
 -- having to request the collectible from the item config.
 function ____exports.removeCollectibleCostume(self, player, collectibleType)
@@ -742,9 +785,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch122 = activeSlot
-        local ____cond122 = ____switch122 == ActiveSlot.PRIMARY
-        if ____cond122 then
+        local ____switch132 = activeSlot
+        local ____cond132 = ____switch132 == ActiveSlot.PRIMARY
+        if ____cond132 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -753,8 +796,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond122 = ____cond122 or ____switch122 == ActiveSlot.SECONDARY
-        if ____cond122 then
+        ____cond132 = ____cond132 or ____switch132 == ActiveSlot.SECONDARY
+        if ____cond132 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -769,16 +812,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond122 = ____cond122 or ____switch122 == ActiveSlot.POCKET
-        if ____cond122 then
+        ____cond132 = ____cond132 or ____switch132 == ActiveSlot.POCKET
+        if ____cond132 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond122 = ____cond122 or ____switch122 == ActiveSlot.POCKET_SINGLE_USE
-        if ____cond122 then
+        ____cond132 = ____cond132 or ____switch132 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond132 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/dist/functions/string.d.ts

@@ -1,4 +1,21 @@
 export declare function capitalizeFirstLetter(string: string): string;
+/**
+ * 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.
+ *
+ * For example:
+ *
+ * ```ts
+ * const array = ["foo", "bar"];
+ * const searchText = "f";
+ * const match = getPartialMatch(array, searchText); // match is now equal to "foo"
+ *
+ * @returns If a match was found, returns the array element. If a match was not
+ * found, returns undefined.
+ * ```
+ */
+export declare function getPartialMatch(searchText: string, array: string[]): string | undefined;
 export declare function removeAllCharacters(string: string, character: string): string;
 /**
  * Helper function to remove all of the characters in a string before a given substring. Returns the

package/dist/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,CAM5D;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;;;;;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":"AAAA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM5D;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;;;;;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/functions/string.lua

@@ -1,7 +1,9 @@
 local ____lualib = require("lualib_bundle")
+local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__StringReplaceAll = ____lualib.__TS__StringReplaceAll
-local __TS__StringSlice = ____lualib.__TS__StringSlice
 local __TS__StringStartsWith = ____lualib.__TS__StringStartsWith
+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)
@@ -10,6 +12,34 @@ function ____exports.capitalizeFirstLetter(self, ____string)
     local restOfString = string.sub(____string, 2)
     return capitalizedFirstLetter .. restOfString
 end
+--- 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.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const array = ["foo", "bar"];
+-- const searchText = "f";
+-- const match = getPartialMatch(array, searchText); // match is now equal to "foo"
+-- 
+-- @returns If a match was found, returns the array element. If a match was not
+-- found, returns undefined.
+-- ```
+function ____exports.getPartialMatch(self, searchText, array)
+    __TS__ArraySort(array)
+    searchText = string.lower(searchText)
+    searchText = __TS__StringReplaceAll(searchText, " ", "")
+    local matchingElements = __TS__ArrayFilter(
+        array,
+        function(____, element) return __TS__StringStartsWith(
+            string.lower(element),
+            searchText
+        ) end
+    )
+    __TS__ArraySort(matchingElements)
+    return matchingElements[1]
+end
 function ____exports.removeAllCharacters(self, ____string, character)
     return __TS__StringReplaceAll(____string, character, "")
 end

package/dist/functions/utils.d.ts

@@ -80,13 +80,13 @@ export declare function repeat(n: int, func: (i: int) => void): void;
 /**
  * Helper function to signify that the enclosing code block is not yet complete. Using this function
  * is similar to writing a "TODO" comment, but it has the benefit of preventing ESLint errors due to
- * early returns.
+ * unused variables or early returns.
  *
  * When you see this function, it simply means that the programmer intends to add in more code to
  * this spot later.
  *
  * This function is variadic, meaning that you can pass as many arguments as you want. (This is
- * useful as a means to prevent lint warnings.)
+ * useful as a means to prevent unused variables.)
  *
  * This function does not actually do anything. (It is an "empty" function.)
  */

package/dist/functions/utils.lua

@@ -153,13 +153,13 @@ ____exports["repeat"] = function(self, n, func)
 end
 --- Helper function to signify that the enclosing code block is not yet complete. Using this function
 -- is similar to writing a "TODO" comment, but it has the benefit of preventing ESLint errors due to
--- early returns.
+-- unused variables or early returns.
 -- 
 -- When you see this function, it simply means that the programmer intends to add in more code to
 -- this spot later.
 -- 
 -- This function is variadic, meaning that you can pass as many arguments as you want. (This is
--- useful as a means to prevent lint warnings.)
+-- useful as a means to prevent unused variables.)
 -- 
 -- This function does not actually do anything. (It is an "empty" function.)
 function ____exports.todo(self, ...)

package/dist/index.d.ts

@@ -3790,6 +3790,24 @@ export declare function getOppositeDoorSlot(doorSlot: DoorSlot): DoorSlot | unde
  */
 export declare function getOtherPlayers(player: EntityPlayer): EntityPlayer[];
 
+/**
+ * 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.
+ *
+ * For example:
+ *
+ * ```ts
+ * const array = ["foo", "bar"];
+ * const searchText = "f";
+ * const match = getPartialMatch(array, searchText); // match is now equal to "foo"
+ *
+ * @returns If a match was found, returns the array element. If a match was not
+ * found, returns undefined.
+ * ```
+ */
+export declare function getPartialMatch(searchText: string, array: string[]): string | undefined;
+
 /**
  * Helper function to get the associated pill effect after PHD is acquired. If a pill effect is not
  * altered by PHD, then the same pill effect will be returned.
@@ -8968,6 +8986,12 @@ export declare function registerHotkey(keyboardOrFunc: Keyboard | (() => Keyboar
  */
 export declare function reloadRoom(): void;
 
+/**
+ * Helper function to remove all of the active items from a player. This includes the Schoolbag item
+ * and any pocket actives.
+ */
+export declare function removeAllActiveItems(player: EntityPlayer): void;
+
 /**
  * Helper function to remove all of the batteries in the room.
  *
@@ -9215,6 +9239,14 @@ export declare function removeAllPits(pitVariant?: PitVariant, updateRoom?: bool
 
 export declare function removeAllPlayerHealth(player: EntityPlayer): void;
 
+/**
+ * Helper function to remove all of the held trinkets from a player.
+ *
+ * This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
+ * they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+ */
+export declare function removeAllPlayerTrinkets(player: EntityPlayer): void;
+
 /**
  * Helper function to remove all of the `GridEntityPoop` in the room.
  *
@@ -11198,13 +11230,13 @@ export declare function texelEquals(sprite1: Sprite, sprite2: Sprite, position:
 /**
  * Helper function to signify that the enclosing code block is not yet complete. Using this function
  * is similar to writing a "TODO" comment, but it has the benefit of preventing ESLint errors due to
- * early returns.
+ * unused variables or early returns.
  *
  * When you see this function, it simply means that the programmer intends to add in more code to
  * this spot later.
  *
  * This function is variadic, meaning that you can pass as many arguments as you want. (This is
- * useful as a means to prevent lint warnings.)
+ * useful as a means to prevent unused variables.)
  *
  * This function does not actually do anything. (It is an "empty" function.)
  */

package/dist/initFeatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initFeatures.d.ts","sourceRoot":"","sources":["../src/initFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA8BpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAGnD"}
+{"version":3,"file":"initFeatures.d.ts","sourceRoot":"","sources":["../src/initFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA+BpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAGnD"}

package/dist/initFeatures.lua

@@ -24,6 +24,8 @@ local ____fadeInRemover = require("features.fadeInRemover")
 local fadeInRemoverInit = ____fadeInRemover.fadeInRemoverInit
 local ____fastReset = require("features.fastReset")
 local fastResetInit = ____fastReset.fastResetInit
+local ____firstLast = require("features.firstLast")
+local firstLastInit = ____firstLast.firstLastInit
 local ____forgottenSwitch = require("features.forgottenSwitch")
 local forgottenSwitchInit = ____forgottenSwitch.forgottenSwitchInit
 local ____pause = require("features.pause")
@@ -71,6 +73,7 @@ function initFeaturesMinor(self, mod)
     disableInputsInit(nil, mod)
     fadeInRemoverInit(nil, mod)
     fastResetInit(nil, mod)
+    firstLastInit(nil, mod)
     forgottenSwitchInit(nil, mod)
     collectibleItemPoolTypeInit(nil, mod)
     pauseInit(nil, mod)

package/package.json

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

package/src/functions/map.ts

@@ -1,4 +1,5 @@
 import { sumArray } from "./array";
+import { getPartialMatch } from "./string";
 
 /** Helper function to copy a map. (You can also use a Map constructor to accomplish this task.) */
 export function copyMap<K, V>(oldMap: Map<K, V>): Map<K, V> {
@@ -34,24 +35,17 @@ export function getMapPartialMatch<T>(
   map: ReadonlyMap<string, T>,
 ): [string, T] | undefined {
   const keys = [...map.keys()];
-  keys.sort();
 
-  searchText = searchText.toLowerCase();
-  searchText = searchText.replaceAll(" ", "");
-
-  const matchingKeys = keys.filter((key) =>
-    key.toLowerCase().startsWith(searchText),
-  );
-  matchingKeys.sort();
-
-  const matchingKey = matchingKeys[0];
+  const matchingKey = getPartialMatch(searchText, keys);
   if (matchingKey === undefined) {
     return undefined;
   }
 
   const value = map.get(matchingKey);
   if (value === undefined) {
-    return undefined;
+    error(
+      `Failed to get the map value corresponding to the partial match of: ${matchingKey}`,
+    );
   }
 
   return [matchingKey, value];

package/src/functions/players.ts

@@ -7,6 +7,7 @@ import {
   NullItemID,
   PlayerForm,
   PlayerType,
+  TrinketSlot,
   TrinketType,
 } from "isaac-typescript-definitions";
 import { game, itemConfig } from "../core/cachedClasses";
@@ -882,6 +883,46 @@ export function playerHasCollectible(
   );
 }
 
+/**
+ * Helper function to remove all of the active items from a player. This includes the Schoolbag item
+ * and any pocket actives.
+ */
+export function removeAllActiveItems(player: EntityPlayer): void {
+  for (const activeSlot of getEnumValues(ActiveSlot)) {
+    const collectibleType = player.GetActiveItem(activeSlot);
+    if (collectibleType === CollectibleType.NULL) {
+      continue;
+    }
+
+    let hasCollectible: boolean;
+    do {
+      player.RemoveCollectible(collectibleType);
+      hasCollectible = player.HasCollectible(collectibleType);
+    } while (hasCollectible);
+  }
+}
+
+/**
+ * Helper function to remove all of the held trinkets from a player.
+ *
+ * This will not remove any smelted trinkets, unless the player happens to be holding a trinket that
+ * they also have smelted. (In that case, both the held and the smelted trinket will be removed.)
+ */
+export function removeAllPlayerTrinkets(player: EntityPlayer): void {
+  for (const trinketSlot of getEnumValues(TrinketSlot)) {
+    const trinketType = player.GetTrinket(trinketSlot);
+    if (trinketType === TrinketType.NULL) {
+      continue;
+    }
+
+    let hasTrinket: boolean;
+    do {
+      player.TryRemoveTrinket(trinketType);
+      hasTrinket = player.HasTrinket(trinketType);
+    } while (hasTrinket);
+  }
+}
+
 /**
  * Helper function to remove a collectible costume from a player. Use this helper function to avoid
  * having to request the collectible from the item config.

package/src/functions/string.ts

@@ -6,6 +6,39 @@ export function capitalizeFirstLetter(string: string): string {
   return `${capitalizedFirstLetter}${restOfString}`;
 }
 
+/**
+ * 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.
+ *
+ * For example:
+ *
+ * ```ts
+ * const array = ["foo", "bar"];
+ * const searchText = "f";
+ * const match = getPartialMatch(array, searchText); // match is now equal to "foo"
+ *
+ * @returns If a match was found, returns the array element. If a match was not
+ * found, returns undefined.
+ * ```
+ */
+export function getPartialMatch(
+  searchText: string,
+  array: string[],
+): string | undefined {
+  array.sort();
+
+  searchText = searchText.toLowerCase();
+  searchText = searchText.replaceAll(" ", "");
+
+  const matchingElements = array.filter((element) =>
+    element.toLowerCase().startsWith(searchText),
+  );
+  matchingElements.sort();
+
+  return matchingElements[0];
+}
+
 export function removeAllCharacters(string: string, character: string): string {
   return string.replaceAll(character, "");
 }

package/src/functions/utils.ts

@@ -182,13 +182,13 @@ export function repeat(n: int, func: (i: int) => void): void {
 /**
  * Helper function to signify that the enclosing code block is not yet complete. Using this function
  * is similar to writing a "TODO" comment, but it has the benefit of preventing ESLint errors due to
- * early returns.
+ * unused variables or early returns.
  *
  * When you see this function, it simply means that the programmer intends to add in more code to
  * this spot later.
  *
  * This function is variadic, meaning that you can pass as many arguments as you want. (This is
- * useful as a means to prevent lint warnings.)
+ * useful as a means to prevent unused variables.)
  *
  * This function does not actually do anything. (It is an "empty" function.)
  */

package/src/initFeatures.ts

@@ -11,6 +11,7 @@ import { disableAllSoundInit } from "./features/disableAllSound";
 import { disableInputsInit } from "./features/disableInputs";
 import { fadeInRemoverInit } from "./features/fadeInRemover";
 import { fastResetInit } from "./features/fastReset";
+import { firstLastInit } from "./features/firstLast";
 import { forgottenSwitchInit } from "./features/forgottenSwitch";
 import { pauseInit } from "./features/pause";
 import { persistentEntitiesInit } from "./features/persistentEntities";
@@ -49,6 +50,7 @@ function initFeaturesMinor(mod: ModUpgraded) {
   disableInputsInit(mod);
   fadeInRemoverInit(mod);
   fastResetInit(mod);
+  firstLastInit(mod);
   forgottenSwitchInit(mod);
   collectibleItemPoolTypeInit(mod);
   pauseInit(mod);