isaacscript-common 73.1.0 → 74.0.0

package/dist/functions/string.lua

@@ -0,0 +1,172 @@
+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
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__StringSlice = ____lualib.__TS__StringSlice
+local __TS__StringEndsWith = ____lualib.__TS__StringEndsWith
+local ____exports = {}
+local ____utils = require("functions.utils")
+local assertDefined = ____utils.assertDefined
+--- Helper function to get the closest value from an array of strings based on partial search text.
+-- 
+-- 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 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.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
+--- Helper function to parse a Semantic Versioning string into its individual constituents. Returns
+-- undefined if the submitted string was not a proper Semantic Version string.
+-- 
+-- https://semver.org/
+function ____exports.parseSemanticVersion(self, versionString)
+    local majorVersionString, minorVersionString, patchVersionString = string.match(versionString, "(%d+).(%d+).(%d+)")
+    if majorVersionString == nil or minorVersionString == nil or patchVersionString == nil then
+        return nil
+    end
+    local majorVersion = tonumber(majorVersionString)
+    local minorVersion = tonumber(minorVersionString)
+    local patchVersion = tonumber(patchVersionString)
+    if majorVersion == nil or minorVersion == nil or patchVersion == nil then
+        return nil
+    end
+    return {majorVersion = majorVersion, minorVersion = minorVersion, patchVersion = patchVersion}
+end
+function ____exports.removeAllCharacters(self, ____string, character)
+    return __TS__StringReplaceAll(____string, character, "")
+end
+--- Helper function to remove all of the characters in a string before a given substring. Returns the
+-- modified string.
+function ____exports.removeCharactersBefore(self, ____string, substring)
+    local index = (string.find(____string, substring, nil, true) or 0) - 1
+    return __TS__StringSlice(____string, index)
+end
+--- Helper function to remove all characters from a string that are not letters or numbers.
+function ____exports.removeNonAlphanumericCharacters(self, str)
+    local returnValue, _ = string.gsub(str, "%W", "")
+    return returnValue
+end
+--- Helper function to remove one or more substrings from a string, if they exist. Returns the
+-- modified string.
+-- 
+-- This function is variadic, meaning that you can pass as many substrings as you want to remove.
+function ____exports.removeSubstring(self, ____string, ...)
+    local substrings = {...}
+    for ____, substring in ipairs(substrings) do
+        ____string = __TS__StringReplaceAll(____string, substring, "")
+    end
+    return ____string
+end
+--- Helper function to trim a prefix from a string, if it exists. Returns the trimmed string.
+function ____exports.trimPrefix(self, ____string, prefix)
+    if not __TS__StringStartsWith(____string, prefix) then
+        return ____string
+    end
+    return __TS__StringSlice(____string, #prefix)
+end
+--- Helper function to trim a suffix from a string, if it exists. Returns the trimmed string.
+function ____exports.trimSuffix(self, ____string, prefix)
+    if not __TS__StringEndsWith(____string, prefix) then
+        return ____string
+    end
+    local endCharacter = #____string - #prefix
+    return __TS__StringSlice(____string, 0, endCharacter)
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/functions/table.ts"],"names":[],"mappings":";AAGA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,CAInE;AAED,iGAAiG;AACjG,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAgBN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,OAAO,EAAE,CAmBX;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CA2BV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CAkBV;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,OAAO,CAQxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,EACxD,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,EAChC,OAAO,UAAO,GACb,IAAI,CA6BN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAClC,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,OAAO,CAET"}

package/dist/functions/table.lua

@@ -0,0 +1,156 @@
+local ____lualib = require("lualib_bundle")
+local __TS__TypeOf = ____lualib.__TS__TypeOf
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
+local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
+local __TS__ArraySort = ____lualib.__TS__ArraySort
+local ____exports = {}
+local ____types = require("functions.types")
+local isBoolean = ____types.isBoolean
+local isNumber = ____types.isNumber
+local isString = ____types.isString
+local isUserdata = ____types.isUserdata
+local ____utils = require("functions.utils")
+local assertDefined = ____utils.assertDefined
+--- In a `Map`, you can use the `clear` method to delete every element. However, in a `LuaMap`, the
+-- `clear` method does not exist. Use this helper function as a drop-in replacement for this.
+function ____exports.clearTable(self, luaMap)
+    for key in pairs(luaMap) do
+        luaMap[key] = nil
+    end
+end
+--- Helper function to copy specific values from a userdata object (e.g. `Vector`) to a table.
+function ____exports.copyUserdataValuesToTable(self, object, keys, luaMap)
+    if not isUserdata(nil, object) then
+        error("Failed to copy an object values to a table, since the object was of type: " .. type(object))
+    end
+    local userdata = object
+    for ____, key in ipairs(keys) do
+        local value = userdata[key]
+        luaMap[key] = value
+    end
+end
+--- Helper function to safely get boolean values from a Lua table. Will throw an error if the
+-- specific value does not exist on the table.
+-- 
+-- This function is variadic, meaning that you can specify N arguments to get N values.
+function ____exports.getBooleansFromTable(self, luaMap, objectName, ...)
+    local keys = {...}
+    local booleans = {}
+    for ____, key in ipairs(keys) do
+        local value = luaMap[key]
+        assertDefined(nil, value, ((("Failed to find a value for \"" .. key) .. "\" in a table representing a \"") .. objectName) .. "\" object.")
+        if isBoolean(nil, value) then
+            booleans[#booleans + 1] = value
+        else
+            error((((("Failed to get the boolean for the \"" .. key) .. "\" value of a table representing a \"") .. objectName) .. "\" object because the type was: ") .. __TS__TypeOf(value))
+        end
+    end
+    return booleans
+end
+--- Helper function to safely get number values from specific keys on a Lua table. Will throw an
+-- error if the specific value does not exist on the table or if it cannot be converted to a number.
+-- 
+-- This function is variadic, meaning that you can specify N arguments to get N values.
+function ____exports.getNumbersFromTable(self, luaMap, objectName, ...)
+    local keys = {...}
+    local numbers = {}
+    for ____, key in ipairs(keys) do
+        local value = luaMap[key]
+        assertDefined(nil, value, ((("Failed to find a value for \"" .. key) .. "\" in a table representing a \"") .. objectName) .. "\" object.")
+        if isNumber(nil, value) then
+            numbers[#numbers + 1] = value
+        elseif isString(nil, value) then
+            local number = tonumber(value)
+            assertDefined(nil, number, (((("Failed to convert the \"" .. key) .. "\" value of a table representing a \"") .. objectName) .. "\" object to a number: ") .. value)
+            numbers[#numbers + 1] = number
+        else
+            error((((("Failed to get the number for the \"" .. key) .. "\" value of a table representing a \"") .. objectName) .. "\" object because the type was: ") .. __TS__TypeOf(value))
+        end
+    end
+    return numbers
+end
+--- Helper function to safely get string values from a Lua table. Will throw an error if the specific
+-- value does not exist on the table.
+-- 
+-- This function is variadic, meaning that you can specify N arguments to get N values.
+function ____exports.getStringsFromTable(self, luaMap, objectName, ...)
+    local keys = {...}
+    local strings = {}
+    for ____, key in ipairs(keys) do
+        local value = luaMap[key]
+        assertDefined(nil, value, ((("Failed to find a value for \"" .. key) .. "\" in a table representing a \"") .. objectName) .. "\" object.")
+        if isString(nil, value) then
+            strings[#strings + 1] = value
+        else
+            local ____string = tostring(value)
+            strings[#strings + 1] = ____string
+        end
+    end
+    return strings
+end
+--- Helper function to check if a Lua table has 0 keys.
+function ____exports.isTableEmpty(self, luaMap)
+    for _key, _value in pairs(luaMap) do
+        return false
+    end
+    return true
+end
+--- Helper function to iterate over a table deterministically. This is useful because by default, the
+-- `pairs` function will return the keys of a Lua table in a random order.
+-- 
+-- This function will sort the table entries based on the value of the key.
+-- 
+-- This function will only work on tables that have number keys or string keys. It will throw a
+-- run-time error if it encounters a key of another type.
+-- 
+-- @param luaMap The table to iterate over.
+-- @param func The function to run for each iteration.
+-- @param inOrder Optional. Whether to iterate in order. True by default. You can dynamically set to
+-- false in situations where iterating randomly would not matter and you need the
+-- extra performance.
+function ____exports.iterateTableInOrder(self, luaMap, func, inOrder)
+    if inOrder == nil then
+        inOrder = true
+    end
+    if not inOrder then
+        for key, value in pairs(luaMap) do
+            func(nil, key, value)
+        end
+        return
+    end
+    local keys = __TS__ObjectKeys(luaMap)
+    local hasAllNumberKeys = __TS__ArrayEvery(
+        keys,
+        function(____, key) return isNumber(nil, key) end
+    )
+    local hasAllStringKeys = __TS__ArrayEvery(
+        keys,
+        function(____, key) return isString(nil, key) end
+    )
+    if not hasAllNumberKeys and not hasAllStringKeys then
+        for key, value in pairs(luaMap) do
+            func(nil, key, value)
+        end
+        return
+    end
+    __TS__ArraySort(keys)
+    for ____, key in ipairs(keys) do
+        local keyIndex = key
+        local value = luaMap[keyIndex]
+        if value ~= nil then
+            func(nil, keyIndex, value)
+        end
+    end
+end
+--- Helper function to check if a Lua table has all of the provided keys.
+-- 
+-- This function is variadic, meaning that you can specify as many arguments as you want to check
+-- for.
+function ____exports.tableHasKeys(self, luaMap, ...)
+    local keys = {...}
+    return __TS__ArrayEvery(
+        keys,
+        function(____, key) return luaMap[key] ~= nil end
+    )
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../src/functions/tears.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAuBT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"transformations.d.ts","sourceRoot":"","sources":["../../src/functions/transformations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAiB,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAgCzE,6DAA6D;AAC7D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,GACnB,GAAG,CAAC,UAAU,CAAC,CASjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,eAAe,EAAE,eAAe,GAC/B,GAAG,CAAC,UAAU,CAAC,CAgBjB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAQrE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtE"}

package/dist/functions/transformations.lua

@@ -0,0 +1,87 @@
+local ____lualib = require("lualib_bundle")
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
+local __TS__Iterator = ____lualib.__TS__Iterator
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+local ____cachedEnumValues = require("arrays.cachedEnumValues")
+local PLAYER_FORM_VALUES = ____cachedEnumValues.PLAYER_FORM_VALUES
+local ____transformationNames = require("objects.transformationNames")
+local TRANSFORMATION_NAMES = ____transformationNames.TRANSFORMATION_NAMES
+local ____ReadonlyMap = require("types.ReadonlyMap")
+local ReadonlyMap = ____ReadonlyMap.ReadonlyMap
+local ____ReadonlySet = require("types.ReadonlySet")
+local ReadonlySet = ____ReadonlySet.ReadonlySet
+local ____collectibles = require("functions.collectibles")
+local getCollectibleTags = ____collectibles.getCollectibleTags
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
+local TRANSFORMATION_TO_TAG_MAP = __TS__New(ReadonlyMap, {
+    {PlayerForm.GUPPY, ItemConfigTag.GUPPY},
+    {PlayerForm.BEELZEBUB, ItemConfigTag.FLY},
+    {PlayerForm.FUN_GUY, ItemConfigTag.MUSHROOM},
+    {PlayerForm.SERAPHIM, ItemConfigTag.ANGEL},
+    {PlayerForm.BOB, ItemConfigTag.BOB},
+    {PlayerForm.SPUN, ItemConfigTag.SYRINGE},
+    {PlayerForm.YES_MOTHER, ItemConfigTag.MOM},
+    {PlayerForm.CONJOINED, ItemConfigTag.BABY},
+    {PlayerForm.LEVIATHAN, ItemConfigTag.DEVIL},
+    {PlayerForm.OH_CRAP, ItemConfigTag.POOP},
+    {PlayerForm.BOOKWORM, ItemConfigTag.BOOK},
+    {PlayerForm.SPIDER_BABY, ItemConfigTag.SPIDER}
+})
+local TRANSFORMATIONS_THAT_GRANT_FLYING = __TS__New(ReadonlySet, {PlayerForm.GUPPY, PlayerForm.BEELZEBUB, PlayerForm.SERAPHIM, PlayerForm.LEVIATHAN})
+--- Returns a set of the player's current transformations.
+function ____exports.getPlayerTransformations(self, player)
+    local transformations = __TS__New(Set)
+    for ____, playerForm in ipairs(PLAYER_FORM_VALUES) do
+        if player:HasPlayerForm(playerForm) then
+            transformations:add(playerForm)
+        end
+    end
+    return transformations
+end
+--- Helper function to get a transformation name from a PlayerForm enum.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const transformationName = getTransformationName(PlayerForm.LORD_OF_THE_FLIES);
+-- // transformationName is "Beelzebub"
+-- ```
+function ____exports.getTransformationName(self, playerForm)
+    return TRANSFORMATION_NAMES[playerForm]
+end
+--- Returns a set containing all of the transformations that the given collectible types contribute
+-- towards.
+function ____exports.getTransformationsForCollectibleType(self, collectibleType)
+    local itemConfigTags = getCollectibleTags(nil, collectibleType)
+    local transformationSet = __TS__New(Set)
+    for ____, playerForm in ipairs(PLAYER_FORM_VALUES) do
+        do
+            local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
+            if itemConfigTag == nil then
+                goto __continue8
+            end
+            if hasFlag(nil, itemConfigTags, itemConfigTag) then
+                transformationSet:add(playerForm)
+            end
+        end
+        ::__continue8::
+    end
+    return transformationSet
+end
+function ____exports.hasFlyingTransformation(self, player)
+    for ____, playerForm in __TS__Iterator(TRANSFORMATIONS_THAT_GRANT_FLYING) do
+        if player:HasPlayerForm(playerForm) then
+            return true
+        end
+    end
+    return false
+end
+function ____exports.isTransformationFlying(self, playerForm)
+    return TRANSFORMATIONS_THAT_GRANT_FLYING:has(playerForm)
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"trinketGive.d.ts","sourceRoot":"","sources":["../../src/functions/trinketGive.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAKvE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,GAC7C,IAAI,CA+BN;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,WAAW,EACxB,WAAW,SAAI,GACd,IAAI,CASN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,GAAG,YAAY,EAAE,WAAW,EAAE,GAC7B,IAAI,CAIN;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,WAAW,GACvB,gBAAgB,GAAG,SAAS,CAkC9B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,GACnB,gBAAgB,GAAG,SAAS,CAsB9B"}

package/dist/functions/trinketGive.lua

@@ -0,0 +1,130 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local TrinketSlot = ____isaac_2Dtypescript_2Ddefinitions.TrinketSlot
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
+local ____playerCollectibles = require("functions.playerCollectibles")
+local useActiveItemTemp = ____playerCollectibles.useActiveItemTemp
+local ____trinkets = require("functions.trinkets")
+local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
+local ____utils = require("functions.utils")
+local ____repeat = ____utils["repeat"]
+--- Helper function to temporarily removes a player's held trinkets, if any. This will not remove any
+-- smelted trinkets. Use this in combination with the `giveTrinketsBack` function to take away and
+-- give back trinkets on the same frame.
+-- 
+-- @returns Undefined if the player does not have any trinkets, or TrinketSituation if they do.
+function ____exports.temporarilyRemoveTrinkets(self, player)
+    local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
+    local trinketType2 = player:GetTrinket(TrinketSlot.SLOT_2)
+    if trinketType1 == TrinketType.NULL and trinketType2 == TrinketType.NULL then
+        return nil
+    end
+    if trinketType1 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType1)
+    end
+    if trinketType2 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType2)
+    end
+    return {trinketTypeRemoved = TrinketType.NULL, trinketType1 = trinketType1, trinketType2 = trinketType2, numSmeltedTrinkets = 0}
+end
+--- Helper function to restore the player's trinkets back to the way they were before the
+-- `temporarilyRemoveTrinket` function was used. It will re-smelt any smelted trinkets that were
+-- removed.
+function ____exports.giveTrinketsBack(self, player, trinketSituation)
+    if trinketSituation == nil then
+        return
+    end
+    local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
+    local trinketType2 = player:GetTrinket(TrinketSlot.SLOT_2)
+    if trinketType1 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType1)
+    end
+    if trinketType2 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType2)
+    end
+    ____repeat(
+        nil,
+        trinketSituation.numSmeltedTrinkets,
+        function()
+            player:AddTrinket(trinketSituation.trinketTypeRemoved, false)
+            useActiveItemTemp(nil, player, CollectibleType.SMELTER)
+        end
+    )
+    if trinketSituation.trinketType1 ~= TrinketType.NULL then
+        player:AddTrinket(trinketSituation.trinketType1, false)
+    end
+    if trinketSituation.trinketType2 ~= TrinketType.NULL then
+        player:AddTrinket(trinketSituation.trinketType2, false)
+    end
+end
+--- Helper function to smelt a trinket. Before smelting, this function will automatically remove the
+-- trinkets that the player is holding, if any, and then give them back after the new trinket is
+-- smelted.
+-- 
+-- @param player The player to smelt the trinkets to.
+-- @param trinketType The trinket type to smelt.
+-- @param numTrinkets Optional. If specified, will smelt the given number of trinkets. Use this to
+-- avoid calling this function multiple times. Default is 1.
+function ____exports.smeltTrinket(self, player, trinketType, numTrinkets)
+    if numTrinkets == nil then
+        numTrinkets = 1
+    end
+    local trinketSituation = ____exports.temporarilyRemoveTrinkets(nil, player)
+    ____repeat(
+        nil,
+        numTrinkets,
+        function()
+            player:AddTrinket(trinketType)
+            useActiveItemTemp(nil, player, CollectibleType.SMELTER)
+        end
+    )
+    ____exports.giveTrinketsBack(nil, player, trinketSituation)
+end
+--- Helper function to smelt two or more different trinkets. If you want to smelt one trinket (or
+-- multiple copies of one trinket), then use the `smeltTrinket` helper function instead.
+-- 
+-- This function is variadic, meaning that you can pass as many trinket types as you want to smelt.
+-- 
+-- Before smelting, this function will automatically remove the trinkets that the player is holding,
+-- if any, and then give them back after the new trinket is smelted.
+-- 
+-- @param player The player to smelt the trinkets to.
+-- @param trinketTypes The trinket types to smelt.
+function ____exports.smeltTrinkets(self, player, ...)
+    local trinketTypes = {...}
+    for ____, trinketType in ipairs(trinketTypes) do
+        ____exports.smeltTrinket(nil, player, trinketType)
+    end
+end
+--- Helper function to temporarily remove a specific kind of trinket from the player. Use this in
+-- combination with the `giveTrinketsBack` function to take away and give back a trinket on the same
+-- frame. This function correctly handles multiple trinket slots and ensures that all copies of the
+-- trinket are removed, including smelted trinkets.
+-- 
+-- Note that one smelted golden trinket is the same as two smelted normal trinkets.
+-- 
+-- @returns Undefined if the player does not have the trinket, or TrinketSituation if they do.
+function ____exports.temporarilyRemoveTrinket(self, player, trinketType)
+    if not player:HasTrinket(trinketType) then
+        return nil
+    end
+    local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
+    local trinketType2 = player:GetTrinket(TrinketSlot.SLOT_2)
+    local numTrinkets = 0
+    while player:HasTrinket(trinketType) do
+        player:TryRemoveTrinket(trinketType)
+        numTrinkets = numTrinkets + 1
+    end
+    local numSmeltedTrinkets = numTrinkets
+    local trinketWasInSlot1 = trinketType1 == trinketType or trinketType1 == getGoldenTrinketType(nil, trinketType)
+    if trinketWasInSlot1 then
+        numSmeltedTrinkets = numSmeltedTrinkets - 1
+    end
+    local trinketWasInSlot2 = trinketType2 == trinketType or trinketType2 == getGoldenTrinketType(nil, trinketType)
+    if trinketWasInSlot2 then
+        numSmeltedTrinkets = numSmeltedTrinkets - 1
+    end
+    return {trinketTypeRemoved = trinketType, trinketType1 = trinketType1, trinketType2 = trinketType2, numSmeltedTrinkets = numSmeltedTrinkets}
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"trinkets.d.ts","sourceRoot":"","sources":["../../src/functions/trinkets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AA2BvE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAI1E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,GAAG,GACf,qBAAqB,GAAG,SAAS,CAUnC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAgBtE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAOtE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAYjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAiBN;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT"}