isaacscript-common 17.7.2 → 17.7.3

package/dist/index.d.ts

@@ -9463,6 +9463,9 @@ export declare enum ModCallbackCustom {
      *
      * Use this callback to know when a pickup is added to the player's inventory or health.
      *
+     * Note that this will not fire when the player takes a collectible; use either the
+     * `POST_PLAYER_COLLECTIBLE_ADDED` or the `PRE_ITEM_PICKUP` callback for that.
+     *
      * When registering the callback with the `ModUpgraded.AddCallbackCustom` method:
      * - You can provide an optional third argument that will make the callback only fire if it
      *   matches the `PickupVariant` provided.
@@ -11549,6 +11552,7 @@ export declare type PickupIndex = int & {
 
 declare class PickupIndexCreation extends Feature {
     private roomHistory;
+    private saveDataManager;
     private postPickupInit;
     private setPickupIndex;
     private getPickupIndexFromPreviousData;
@@ -11559,6 +11563,12 @@ declare class PickupIndexCreation extends Feature {
      * Keep track of the metadata for later.
      */
     private trackDespawningPickupMetadata;
+    /**
+     * If the despawning pickup was in a Treasure Room or Boss Room, then it is possible that the
+     * pickup could re-appear during The Ascent. If this is the case, we store the metadata on a
+     * separate map to reference later.
+     */
+    private getPickupDataMapForCurrentRoom;
     private getPostAscentPickupIndex;
     /**
      * Mods often have to track variables relating to a pickups. Finding an index for these kinds of
@@ -13239,6 +13249,20 @@ declare class SaveDataManager extends Feature {
      * In order to use this function, you must upgrade your mod with `ISCFeature.SAVE_DATA_MANAGER`.
      */
     saveDataManagerReset(key: string, childObjectKey: SaveDataKey): void;
+    /**
+     * Helper function to check to see if the game is in the menu, as far as the save data manager is
+     * concerned. This function will return true when the game is first opened until the
+     * `POST_PLAYER_INIT` callback fires. It will also return true in between the `PRE_GAME_EXIT`
+     * callback firing and the `POST_PLAYER_INIT` callback firing.
+     *
+     * This function is useful because the `POST_ENTITY_REMOVE` callback fires after the
+     * `PRE_GAME_EXIT` callback. Thus, if save data needs to be updated from the `POST_ENTITY_REMOVE`
+     * callback and the player is in the process of saving and quitting, the feature will have to
+     * explicitly call the `saveDataManagerSave` function.
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.SAVE_DATA_MANAGER`.
+     */
+    saveDataManagerInMenu(): boolean;
 }
 
 export declare const SECOND_IN_MILLISECONDS = 1000;