isaacscript-common 14.2.0 → 15.0.0

package/dist/src/features/customGridEntity.lua

@@ -1,323 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
-local __TS__New = ____lualib.__TS__New
-local Set = ____lualib.Set
-local __TS__Iterator = ____lualib.__TS__Iterator
-local ____exports = {}
-local preUseItemWeNeedToGoDeeper, postNewRoomReordered, v
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
-local GridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.GridCollisionClass
-local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
-local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
-local ____DefaultMap = require("src.classes.DefaultMap")
-local DefaultMap = ____DefaultMap.DefaultMap
-local ____cachedClasses = require("src.core.cachedClasses")
-local game = ____cachedClasses.game
-local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
-local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
-local ____featuresInitialized = require("src.featuresInitialized")
-local areFeaturesInitialized = ____featuresInitialized.areFeaturesInitialized
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____gridEntities = require("src.functions.gridEntities")
-local removeGridEntity = ____gridEntities.removeGridEntity
-local spawnGridEntityWithVariant = ____gridEntities.spawnGridEntityWithVariant
-local ____players = require("src.functions.players")
-local getPlayerFromPtr = ____players.getPlayerFromPtr
-local ____roomData = require("src.functions.roomData")
-local getRoomListIndex = ____roomData.getRoomListIndex
-local ____types = require("src.functions.types")
-local isNumber = ____types.isNumber
-local ____vector = require("src.functions.vector")
-local isVector = ____vector.isVector
-local ____runInNFrames = require("src.features.runInNFrames")
-local runNextGameFrame = ____runInNFrames.runNextGameFrame
-local ____exports = require("src.features.saveDataManager.exports")
-local saveDataManager = ____exports.saveDataManager
-function preUseItemWeNeedToGoDeeper(self, _collectibleType, _rng, player, _useFlags, _activeSlot, _customVarData)
-    local room = game:GetRoom()
-    local roomListIndex = getRoomListIndex(nil)
-    local roomCustomGridEntities = v.level.customGridEntities:get(roomListIndex)
-    if roomCustomGridEntities == nil then
-        return nil
-    end
-    local gridIndex = room:GetGridIndex(player.Position)
-    local customGridEntity = roomCustomGridEntities:get(gridIndex)
-    if customGridEntity == nil then
-        return nil
-    end
-    if customGridEntity.gridCollisionClass ~= GridCollisionClass.NONE then
-        return nil
-    end
-    removeGridEntity(nil, customGridEntity.gridIndex, false)
-    local entityPtr = EntityPtr(player)
-    runNextGameFrame(
-        nil,
-        function()
-            local futurePlayer = getPlayerFromPtr(nil, entityPtr)
-            if futurePlayer == nil then
-                return
-            end
-            v.room.manuallyUsingShovel = true
-            futurePlayer:UseActiveItem(CollectibleType.WE_NEED_TO_GO_DEEPER)
-            v.room.manuallyUsingShovel = false
-        end
-    )
-    return true
-end
-function postNewRoomReordered(self)
-    local roomListIndex = getRoomListIndex(nil)
-    local roomCustomGridEntities = v.level.customGridEntities:get(roomListIndex)
-    if roomCustomGridEntities == nil then
-        return
-    end
-    local room = game:GetRoom()
-    for ____, ____value in __TS__Iterator(roomCustomGridEntities:entries()) do
-        local gridIndex = ____value[1]
-        local data = ____value[2]
-        do
-            local decoration = room:GetGridEntity(gridIndex)
-            if decoration == nil then
-                roomCustomGridEntities:delete(gridIndex)
-                goto __continue12
-            end
-            if data.anm2Path ~= nil then
-                local sprite = decoration:GetSprite()
-                sprite:Load(data.anm2Path, true)
-                local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
-                sprite:Play(animationToPlay, true)
-            end
-        end
-        ::__continue12::
-    end
-end
-local FEATURE_NAME = "customGridEntity"
-v = {
-    level = {customGridEntities = __TS__New(
-        DefaultMap,
-        function() return __TS__New(Map) end
-    )},
-    room = {
-        genericPropPtrHashes = __TS__New(Set),
-        manuallyUsingShovel = false
-    }
-}
----
--- @internal
-function ____exports.customGridEntityInit(self, mod)
-    saveDataManager(nil, FEATURE_NAME, v)
-    mod:AddCallback(ModCallback.PRE_USE_ITEM, preUseItemWeNeedToGoDeeper, CollectibleType.WE_NEED_TO_GO_DEEPER)
-    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
-end
---- Helper function to spawn a custom grid entity. Custom grid entities are persistent in that they
--- will reappear if the player leaves and re-enters the room. (It will be manually respawned in the
--- `POST_NEW_ROOM` callback.)
--- 
--- Custom grid entities are built on top of real grid entities. You can use any existing grid entity
--- type as a base. For example, if you want to create a custom rock that would be breakable like a
--- normal rock, then you should specify `GridEntityType.ROCK` as the base grid entity type.
--- 
--- Once a custom grid entity is spawned, you can take advantage of the custom grid callbacks such as
--- `POST_GRID_ENTITY_CUSTOM_UPDATE`. Note that the "normal" grid entities callbacks will not fire
--- for custom entities. For example, if you had a custom grid entity based on `GridEntityType.ROCK`,
--- and you also had a subscription to the `POST_GRID_ENTITY_UPDATE` callback, the callback would
--- only fire for normal rocks and not the custom entity.
--- 
--- Custom grid entities are an IsaacScript feature because the vanilla game does not support any
--- custom grid entities.
--- 
--- For example, this would be code to create a custom rock called a "Silver Rock" that produces a
--- dime when destroyed:
--- 
--- ```ts
--- // This is local to the mod and can safely overlap with the values of `GridEntityType`.
--- const GridEntityTypeCustom = {
---   SILVER_ROCK: 0 as GridEntityType,
--- } as const;
--- 
--- // This is copied from "gfx/grid/grid_rock.anm2" with some tweaks to make it look special.
--- const SILVER_ROCK_ANM2_PATH = "gfx/grid/grid_rock_silver.anm2";
--- 
--- export function silverRockInit(mod: ModUpgraded): void {
---   mod.AddCallbackCustom(
---     ModCallbackCustom.POST_GRID_ENTITY_CUSTOM_BROKEN,
---     postGridEntityCustomBrokenSilverRock,
---     GridEntityTypeCustom.SILVER_ROCK,
---   );
--- }
--- 
--- function postGridEntityCustomBrokenSilverRock(gridEntity: GridEntity) {
---   spawnCoin(CoinSubType.DIME, gridEntity.Position);
--- }
--- 
--- export function spawnSilverRock(gridIndex: int): GridEntity {
---   return spawnCustomGridEntity(
---     GridEntityTypeCustom.SILVER_ROCK,
---     gridIndex,
---     undefined,
---     SILVER_ROCK_ANM2_PATH,
---     undefined,
---     GridEntityType.ROCK,
---   );
--- }
--- ```
--- 
--- @param gridEntityTypeCustom An integer that identifies what kind of grid entity you are creating.
--- It should correspond to a local enum value created in your mod. The
--- integer can be any unique value and will not correspond to the actual
--- grid entity type used. (This integer is used in the various custom
--- grid entity callbacks.)
--- @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
--- entity at. If a position is specified, the closest grid index will be
--- used.
--- @param gridCollisionClass Optional. The collision class that you want the custom grid entity to
--- have. If not specified, the grid collision class from the base grid
--- entity will be used.
--- @param anm2Path Optional. The path to the ANM2 file to use for the sprite. If not specified, the
--- normal sprite from the base grid entity will be used.
--- @param defaultAnimation Optional. The name of the animation to play after the sprite is
--- initialized and after the player re-enters a room with this grid entity
--- in it. If not specified, the default animation in the anm2 will be used.
--- @param baseGridEntityType Optional. The type of the grid entity to use as a "base" for this
--- custom grid entity. Default is `GridEntityType.DECORATION`.
--- @param baseGridEntityVariant Optional. The variant of the grid entity to use as a "base" for this
--- custom grid entity. Default is 0.
-function ____exports.spawnCustomGridEntity(self, gridEntityTypeCustom, gridIndexOrPosition, gridCollisionClass, anm2Path, defaultAnimation, baseGridEntityType, baseGridEntityVariant)
-    if baseGridEntityType == nil then
-        baseGridEntityType = GridEntityType.DECORATION
-    end
-    if baseGridEntityVariant == nil then
-        baseGridEntityVariant = 0
-    end
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local room = game:GetRoom()
-    local roomListIndex = getRoomListIndex(nil)
-    local gridIndex = isVector(nil, gridIndexOrPosition) and room:GetGridIndex(gridIndexOrPosition) or gridIndexOrPosition
-    local customGridEntity = spawnGridEntityWithVariant(nil, baseGridEntityType, baseGridEntityVariant, gridIndexOrPosition)
-    if customGridEntity == nil then
-        error("Failed to spawn a custom grid entity.")
-    end
-    if gridCollisionClass ~= nil then
-        customGridEntity.CollisionClass = gridCollisionClass
-    end
-    if anm2Path ~= nil then
-        local sprite = customGridEntity:GetSprite()
-        sprite:Load(anm2Path, true)
-        local animationToPlay = defaultAnimation == nil and sprite:GetDefaultAnimation() or defaultAnimation
-        sprite:Play(animationToPlay, true)
-    end
-    local customGridEntityData = {
-        gridEntityTypeCustom = gridEntityTypeCustom,
-        roomListIndex = roomListIndex,
-        gridIndex = gridIndex,
-        anm2Path = anm2Path,
-        defaultAnimation = defaultAnimation,
-        gridCollisionClass = gridCollisionClass
-    }
-    local roomCustomGridEntities = v.level.customGridEntities:getAndSetDefault(roomListIndex)
-    roomCustomGridEntities:set(gridIndex, customGridEntityData)
-    return customGridEntity
-end
---- Helper function to remove a custom grid entity created by the `spawnCustomGrid` function.
--- 
--- @param gridIndexOrPositionOrGridEntity You can specify the custom grid entity to remove by
--- providing the grid index, the room position, or the grid entity
--- itself.
--- @param updateRoom Optional. Whether or not to update the room after the grid entity is removed.
--- Default is true. This is generally a good idea because if the room is not
--- updated, you will be unable to spawn another grid entity on the same tile until
--- a frame has passed. However, doing this is expensive, since it involves a call
--- to `Isaac.GetRoomEntities`, so set it to false if you need to run this function
--- multiple times.
--- @returns The grid entity that was removed. Returns undefined if no grid entity was found at the
--- given location or if the given grid entity was not a custom grid entity.
-function ____exports.removeCustomGridEntity(self, gridIndexOrPositionOrGridEntity, updateRoom)
-    if updateRoom == nil then
-        updateRoom = true
-    end
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local room = game:GetRoom()
-    local roomListIndex = getRoomListIndex(nil)
-    local decoration
-    if type(gridIndexOrPositionOrGridEntity) == "number" then
-        local gridIndex = gridIndexOrPositionOrGridEntity
-        local gridEntity = room:GetGridEntity(gridIndex)
-        if gridEntity == nil then
-            return nil
-        end
-        decoration = gridEntity
-    elseif isVector(nil, gridIndexOrPositionOrGridEntity) then
-        local position = gridIndexOrPositionOrGridEntity
-        local gridEntity = room:GetGridEntityFromPos(position)
-        if gridEntity == nil then
-            return nil
-        end
-        decoration = gridEntity
-    else
-        decoration = gridIndexOrPositionOrGridEntity
-    end
-    local gridIndex = decoration:GetGridIndex()
-    local roomCustomGridEntities = v.level.customGridEntities:getAndSetDefault(roomListIndex)
-    local exists = roomCustomGridEntities:has(gridIndex)
-    if not exists then
-        return nil
-    end
-    roomCustomGridEntities:delete(gridIndex)
-    removeGridEntity(nil, decoration, updateRoom)
-    return decoration
-end
---- Helper function to get the custom grid entities in the current room. Returns an array of tuples
--- containing the raw decoration grid entity and the associated entity data.
-function ____exports.getCustomGridEntities(self)
-    if not areFeaturesInitialized(nil) then
-        return {}
-    end
-    local roomListIndex = getRoomListIndex(nil)
-    local roomCustomGridEntities = v.level.customGridEntities:get(roomListIndex)
-    if roomCustomGridEntities == nil then
-        return {}
-    end
-    local room = game:GetRoom()
-    local customGridEntities = {}
-    for ____, ____value in __TS__Iterator(roomCustomGridEntities:entries()) do
-        local gridIndex = ____value[1]
-        local data = ____value[2]
-        local gridEntity = room:GetGridEntity(gridIndex)
-        if gridEntity ~= nil then
-            customGridEntities[#customGridEntities + 1] = {gridEntity, data}
-        end
-    end
-    return customGridEntities
-end
---- Helper function to get the custom `GridEntityType` from a `GridEntity` or grid index. Returns
--- undefined if the provided `GridEntity` is not a custom grid entity, or if there was not a grid
--- entity on the provided grid index.
-function ____exports.getCustomGridEntityType(self, gridEntityOrGridIndex)
-    if not areFeaturesInitialized(nil) then
-        return nil
-    end
-    local gridIndex = isNumber(nil, gridEntityOrGridIndex) and gridEntityOrGridIndex or gridEntityOrGridIndex:GetGridIndex()
-    local roomListIndex = getRoomListIndex(nil)
-    local roomCustomGridEntities = v.level.customGridEntities:get(roomListIndex)
-    if roomCustomGridEntities == nil then
-        return nil
-    end
-    for ____, ____value in __TS__Iterator(roomCustomGridEntities:entries()) do
-        local _gridIndex = ____value[1]
-        local data = ____value[2]
-        if data.gridIndex == gridIndex then
-            return data.gridEntityTypeCustom
-        end
-    end
-    return nil
-end
---- Helper function to check if a `GridEntity` is a custom grid entity or if a grid index has a
--- custom grid entity.
-function ____exports.isCustomGridEntity(self, gridEntityOrGridIndex)
-    if not areFeaturesInitialized(nil) then
-        return false
-    end
-    local gridEntityTypeCustom = ____exports.getCustomGridEntityType(nil, gridEntityOrGridIndex)
-    return gridEntityTypeCustom ~= nil
-end
-return ____exports

package/dist/src/features/customHotkeys.d.ts

@@ -1,42 +0,0 @@
-import { Keyboard } from "isaac-typescript-definitions";
-/**
- * Helper function to run arbitrary code when you press and release a specific keyboard key.
- *
- * This can be used to easily set up custom hotkeys to facilitate custom game features or to assist
- * in debugging.
- *
- * This is different from the `setHotkey` function in that the keyboard activation key is not
- * hardcoded and is instead the return value of a provided function. This is useful for situations
- * where the key can change (like if end-users can specify a custom hotkey using Mod Config Menu).
- *
- * @param getKeyFunc The function that returns the key that will trigger the hotkey.
- * @param triggerFunc A function containing the arbitrary code that you want to execute when the
- *                    hotkey is triggered.
- */
-export declare function setConditionalHotkey(getKeyFunc: () => Keyboard | undefined, triggerFunc: () => void): void;
-/**
- * Helper function to run arbitrary code when you press and release a specific keyboard key.
- *
- * This can be used to easily set up custom hotkeys to facilitate custom game features or to assist
- * in debugging.
- *
- * @param keyboard The key that you want to trigger the hotkey.
- * @param triggerFunc A function containing the arbitrary code that you want to execute when the
- *                    hotkey is triggered.
- */
-export declare function setHotkey(keyboard: Keyboard, triggerFunc: () => void): void;
-/**
- * Helper function to remove a hotkey created with the `setConditionalHotkey` function.
- *
- * @param getKeyFunc Equal to the `getKeyFunc` that you passed when initially registering the
- *                   hotkey.
- */
-export declare function unsetConditionalHotkey(getKeyFunc: () => Keyboard | undefined): void;
-/**
- * Helper function to remove a hotkey created with the `setHotkey` function.
- *
- * @param keyboard Equal to the keyboard value that you passed when initially registering the
- *                 hotkey.
- */
-export declare function unsetHotkey(keyboard: Keyboard): void;
-//# sourceMappingURL=customHotkeys.d.ts.map

package/dist/src/features/customHotkeys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"customHotkeys.d.ts","sourceRoot":"","sources":["../../../src/features/customHotkeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,MAAM,8BAA8B,CAAC;AAwDrE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,QAAQ,GAAG,SAAS,EACtC,WAAW,EAAE,MAAM,IAAI,GACtB,IAAI,CAUN;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,IAAI,GAAG,IAAI,CAU3E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,QAAQ,GAAG,SAAS,GACrC,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAUpD"}

package/dist/src/features/customHotkeys.lua

@@ -1,104 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
-local __TS__New = ____lualib.__TS__New
-local __TS__Iterator = ____lualib.__TS__Iterator
-local ____exports = {}
-local postRender, checkIfTriggered, staticHotkeyFunctionMap, dynamicHotkeyFunctionMap, keyPressedMap
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local Keyboard = ____isaac_2Dtypescript_2Ddefinitions.Keyboard
-local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
-local ____DefaultMap = require("src.classes.DefaultMap")
-local DefaultMap = ____DefaultMap.DefaultMap
-local ____featuresInitialized = require("src.featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____input = require("src.functions.input")
-local isKeyboardPressed = ____input.isKeyboardPressed
-function postRender(self)
-    for ____, ____value in __TS__Iterator(staticHotkeyFunctionMap:entries()) do
-        local keyboard = ____value[1]
-        local triggerFunc = ____value[2]
-        checkIfTriggered(nil, keyboard, triggerFunc)
-    end
-    for ____, ____value in __TS__Iterator(dynamicHotkeyFunctionMap:entries()) do
-        local keyboardFunc = ____value[1]
-        local triggerFunc = ____value[2]
-        local keyboard = keyboardFunc(nil)
-        if keyboard ~= nil then
-            checkIfTriggered(nil, keyboard, triggerFunc)
-        end
-    end
-end
-function checkIfTriggered(self, keyboard, triggerFunc)
-    local isPressed = isKeyboardPressed(nil, keyboard)
-    local wasPreviouslyPressed = keyPressedMap:getAndSetDefault(keyboard)
-    keyPressedMap:set(keyboard, isPressed)
-    if isPressed and not wasPreviouslyPressed then
-        triggerFunc(nil)
-    end
-end
-local FEATURE_NAME = "customHotkeys"
-staticHotkeyFunctionMap = __TS__New(Map)
-dynamicHotkeyFunctionMap = __TS__New(Map)
-keyPressedMap = __TS__New(DefaultMap, false)
----
--- @internal
-function ____exports.customHotkeysInit(self, mod)
-    mod:AddCallback(ModCallback.POST_RENDER, postRender)
-end
---- Helper function to run arbitrary code when you press and release a specific keyboard key.
--- 
--- This can be used to easily set up custom hotkeys to facilitate custom game features or to assist
--- in debugging.
--- 
--- This is different from the `setHotkey` function in that the keyboard activation key is not
--- hardcoded and is instead the return value of a provided function. This is useful for situations
--- where the key can change (like if end-users can specify a custom hotkey using Mod Config Menu).
--- 
--- @param getKeyFunc The function that returns the key that will trigger the hotkey.
--- @param triggerFunc A function containing the arbitrary code that you want to execute when the
--- hotkey is triggered.
-function ____exports.setConditionalHotkey(self, getKeyFunc, triggerFunc)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    if dynamicHotkeyFunctionMap:has(getKeyFunc) then
-        error("Failed to register a hotkey due to a custom hotkey already being defined for the submitted function.")
-    end
-    dynamicHotkeyFunctionMap:set(getKeyFunc, triggerFunc)
-end
---- Helper function to run arbitrary code when you press and release a specific keyboard key.
--- 
--- This can be used to easily set up custom hotkeys to facilitate custom game features or to assist
--- in debugging.
--- 
--- @param keyboard The key that you want to trigger the hotkey.
--- @param triggerFunc A function containing the arbitrary code that you want to execute when the
--- hotkey is triggered.
-function ____exports.setHotkey(self, keyboard, triggerFunc)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    if staticHotkeyFunctionMap:has(keyboard) then
-        error(((("Failed to register a hotkey due to a hotkey already being defined for: Keyboard." .. tostring(Keyboard[keyboard])) .. " (") .. tostring(keyboard)) .. ")")
-    end
-    staticHotkeyFunctionMap:set(keyboard, triggerFunc)
-end
---- Helper function to remove a hotkey created with the `setConditionalHotkey` function.
--- 
--- @param getKeyFunc Equal to the `getKeyFunc` that you passed when initially registering the
--- hotkey.
-function ____exports.unsetConditionalHotkey(self, getKeyFunc)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    if not dynamicHotkeyFunctionMap:has(getKeyFunc) then
-        error("Failed to unregister a hotkey since there is no existing hotkey defined for the submitted function.")
-    end
-    dynamicHotkeyFunctionMap:delete(getKeyFunc)
-end
---- Helper function to remove a hotkey created with the `setHotkey` function.
--- 
--- @param keyboard Equal to the keyboard value that you passed when initially registering the
--- hotkey.
-function ____exports.unsetHotkey(self, keyboard)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    if not staticHotkeyFunctionMap:has(keyboard) then
-        error(((("Failed to unregister a hotkey since there is no existing hotkey defined for: Keyboard." .. tostring(Keyboard[keyboard])) .. " (") .. tostring(keyboard)) .. ")")
-    end
-    staticHotkeyFunctionMap:delete(keyboard)
-end
-return ____exports

package/dist/src/features/customItemPool.d.ts

@@ -1,52 +0,0 @@
-import { CollectibleType, ItemPoolType } from "isaac-typescript-definitions";
-import { WeightedArray } from "../types/WeightedArray";
-/**
- * Helper function to register a custom item pool. Use this function once when your mod first loads
- * to declare the items that you want to be in the item pools. Then, in the middle of a run, you can
- * use `getCustomItemPoolCollectible`.
- *
- * For example:
- *
- * ```ts
- * const ItemPoolTypeCustom = {
- *   FOO = 0 as ItemPoolType,
- * } as const;
- *
- * const FOO_ITEM_POOL = [
- *   [CollectibleType.SAD_ONION, 1],
- *   [CollectibleType.INNER_EYE, 0.5],
- * ];
- *
- * registerCustomItemPool(ItemPoolTypeCustom.FOO, FOO_ITEM_POOL);
- * ```
- *
- * Note that custom item pools do not currently support partial weight decrementation on sight.
- *
- * @param itemPoolTypeCustom An integer that identifies what kind of item pool you are creating. It
- *                           should correspond to a local enum value created in your mod. The
- *                           integer can be any unique value and can safely overlap with the vanilla
- *                           item pool type values.
- * @param collectibles An array of weighted collectible tuples that represent the item pool that you
- *                     are creating. The first element in he tuple is the `CollectibleType`, and the
- *                     second element in the tuple is the float that represents the weight of the
- *                     collectible.
- */
-export declare function registerCustomItemPool(itemPoolTypeCustom: ItemPoolType, collectibles: WeightedArray<CollectibleType>): void;
-/**
- * Helper function to get a new collectible from a custom item pool created with the
- * `registerCustomItemPool` function. This function has the same format as the
- * `ItemPool.GetCollectible` method.
- *
- * By default, a collectible will not be removed from the pool once it is selected, unless the
- * `decrease` argument is set to true (similar to how a vanilla item pool works).
- *
- * @param itemPoolTypeCustom An integer representing the custom item pool to use.
- * @param decrease Optional. Whether or not to remove the selected collectible from the item pool.
- *                 Default is true.
- * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
- *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
- * @param defaultItem Optional. The collectible to return if the item pool is depleted. Default is
- *                    `CollectibleType.NULL`.
- */
-export declare function getCustomItemPoolCollectible(itemPoolTypeCustom: ItemPoolType, decrease?: boolean, seedOrRNG?: Seed | RNG, defaultItem?: CollectibleType): CollectibleType;
-//# sourceMappingURL=customItemPool.d.ts.map

package/dist/src/features/customItemPool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"customItemPool.d.ts","sourceRoot":"","sources":["../../../src/features/customItemPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAQ7E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAmCvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sBAAsB,CACpC,kBAAkB,EAAE,YAAY,EAChC,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC,GAC3C,IAAI,CAUN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAC1C,kBAAkB,EAAE,YAAY,EAChC,QAAQ,UAAQ,EAChB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,WAAW,kBAAuB,GACjC,eAAe,CAsBjB"}

package/dist/src/features/customItemPool.lua

@@ -1,111 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
-local __TS__New = ____lualib.__TS__New
-local ____exports = {}
-local postGameStartedReordered, customItemPoolMap, v
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
-local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
-local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
-local ____featuresInitialized = require("src.featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____array = require("src.functions.array")
-local arrayRemoveIndexInPlace = ____array.arrayRemoveIndexInPlace
-local ____map = require("src.functions.map")
-local copyMap = ____map.copyMap
-local ____rng = require("src.functions.rng")
-local getRandomSeed = ____rng.getRandomSeed
-local ____weighted = require("src.functions.weighted")
-local getRandomIndexFromWeightedArray = ____weighted.getRandomIndexFromWeightedArray
-local ____exports = require("src.features.saveDataManager.exports")
-local saveDataManager = ____exports.saveDataManager
-function postGameStartedReordered(self, isContinued)
-    if isContinued then
-        return
-    end
-    v.run.customItemPools = copyMap(nil, customItemPoolMap)
-end
-local FEATURE_NAME = "customItemPool"
-customItemPoolMap = __TS__New(Map)
-v = {run = {customItemPools = __TS__New(Map)}}
----
--- @internal
-function ____exports.customItemPoolsInit(self, mod)
-    saveDataManager(nil, FEATURE_NAME, v)
-    mod:AddCallbackCustom(ModCallbackCustom.POST_GAME_STARTED_REORDERED, postGameStartedReordered)
-end
---- Helper function to register a custom item pool. Use this function once when your mod first loads
--- to declare the items that you want to be in the item pools. Then, in the middle of a run, you can
--- use `getCustomItemPoolCollectible`.
--- 
--- For example:
--- 
--- ```ts
--- const ItemPoolTypeCustom = {
---   FOO = 0 as ItemPoolType,
--- } as const;
--- 
--- const FOO_ITEM_POOL = [
---   [CollectibleType.SAD_ONION, 1],
---   [CollectibleType.INNER_EYE, 0.5],
--- ];
--- 
--- registerCustomItemPool(ItemPoolTypeCustom.FOO, FOO_ITEM_POOL);
--- ```
--- 
--- Note that custom item pools do not currently support partial weight decrementation on sight.
--- 
--- @param itemPoolTypeCustom An integer that identifies what kind of item pool you are creating. It
--- should correspond to a local enum value created in your mod. The
--- integer can be any unique value and can safely overlap with the vanilla
--- item pool type values.
--- @param collectibles An array of weighted collectible tuples that represent the item pool that you
--- are creating. The first element in he tuple is the `CollectibleType`, and the
--- second element in the tuple is the float that represents the weight of the
--- collectible.
-function ____exports.registerCustomItemPool(self, itemPoolTypeCustom, collectibles)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    if customItemPoolMap:has(itemPoolTypeCustom) then
-        error(("Failed to register a custom item pool since the provided type of " .. tostring(itemPoolTypeCustom)) .. " was already registered.")
-    end
-    customItemPoolMap:set(itemPoolTypeCustom, collectibles)
-end
---- Helper function to get a new collectible from a custom item pool created with the
--- `registerCustomItemPool` function. This function has the same format as the
--- `ItemPool.GetCollectible` method.
--- 
--- By default, a collectible will not be removed from the pool once it is selected, unless the
--- `decrease` argument is set to true (similar to how a vanilla item pool works).
--- 
--- @param itemPoolTypeCustom An integer representing the custom item pool to use.
--- @param decrease Optional. Whether or not to remove the selected collectible from the item pool.
--- Default is true.
--- @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
--- `RNG.Next` method will be called. Default is `getRandomSeed()`.
--- @param defaultItem Optional. The collectible to return if the item pool is depleted. Default is
--- `CollectibleType.NULL`.
-function ____exports.getCustomItemPoolCollectible(self, itemPoolTypeCustom, decrease, seedOrRNG, defaultItem)
-    if decrease == nil then
-        decrease = false
-    end
-    if seedOrRNG == nil then
-        seedOrRNG = getRandomSeed(nil)
-    end
-    if defaultItem == nil then
-        defaultItem = CollectibleType.NULL
-    end
-    local customItemPool = v.run.customItemPools:get(itemPoolTypeCustom)
-    if customItemPool == nil then
-        error("Failed to find the custom item pool of: " .. tostring(itemPoolTypeCustom))
-    end
-    if #customItemPool == 0 then
-        return defaultItem
-    end
-    local randomIndex = getRandomIndexFromWeightedArray(nil, customItemPool, seedOrRNG)
-    local tuple = customItemPool[randomIndex + 1]
-    if decrease then
-        arrayRemoveIndexInPlace(nil, customItemPool, randomIndex)
-    end
-    return tuple[1]
-end
-return ____exports

package/dist/src/features/customPickup.d.ts

@@ -1,26 +0,0 @@
-import { PickupVariant } from "isaac-typescript-definitions";
-/**
- * Helper function to register a custom pickup with the IsaacScript standard library. Use this
- * feature for custom pickups that are intended to be picked up by the player, like bombs and keys.
- *
- * When IsaacScript detects that a player should be collecting the custom pickup, then the pickup
- * will be immediately removed, and an effect showing the pickup's respective `Collect` animation
- * will be spawned. (This emulates how a normal vanilla pickup would work.) After that, the provided
- * `collectFunc` will be fired. In this function, you will probably want to play a sound
- * corresponding to what kind of pickup it is (e.g. `SoundEffect.KEY_PICKUP_GAUNTLET`), as well as
- * do things like adding something to the player's inventory.
- *
- * Note that when you specify your custom pickup in the "entities2.xml" file, it should have a type
- * of "5" and be associated with an anm2 file that has a "Collect" animation.
- *
- * @param pickupVariantCustom The variant for the corresponding custom pickup.
- * @param subType The sub-type for the corresponding custom pickup.
- * @param collectFunc The function to run when the player collects this pickup.
- * @param collisionFunc Optional. The function to run when a player collides with the pickup.
- *                      Default is a function that always returns true, meaning that the player will
- *                      always immediately collect the pickup when they collide with it. Specify
- *                      this function if your pickup should only be able to be collected under
- *                      certain conditions.
- */
-export declare function registerCustomPickup(pickupVariantCustom: PickupVariant, subType: int, collectFunc: (this: void, player: EntityPlayer) => void, collisionFunc?: (this: void, player: EntityPlayer) => boolean): void;
-//# sourceMappingURL=customPickup.d.ts.map

package/dist/src/features/customPickup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"customPickup.d.ts","sourceRoot":"","sources":["../../../src/features/customPickup.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EACd,MAAM,8BAA8B,CAAC;AA8FtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,mBAAmB,EAAE,aAAa,EAClC,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EACvD,aAAa,GAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,OAAoB,GACxE,IAAI,CAaN"}