isaacscript-common 20.3.1 → 20.4.0

package/dist/index.d.ts

@@ -3123,6 +3123,12 @@ export declare function deserializeRNG(rng: SerializedRNG): RNG;
  */
 export declare function deserializeVector(vector: SerializedVector): Vector;
 
+declare type DespawnedSlotTuple = [
+gameFrame: int,
+position: Vector,
+entityPtr: EntityPtr
+];
+
 /** For `EntityType.EFFECT` (1000), `EffectVariant.DICE_FLOOR` (76). */
 export declare const DICE_FLOOR_TRIGGER_SQUARE_SIZE = 75;
 
@@ -7204,49 +7210,50 @@ export declare enum ISCFeature {
     ITEM_PICKUP_DETECTION = 7,
     PLAYER_COLLECTIBLE_DETECTION = 8,
     PLAYER_REORDERED_CALLBACKS = 9,
-    SLOT_RENDER_DETECTION = 10,
-    SLOT_UPDATE_DETECTION = 11,
-    CHARACTER_HEALTH_CONVERSION = 12,
-    CHARACTER_STATS = 13,
-    COLLECTIBLE_ITEM_POOL_TYPE = 14,
-    CUSTOM_GRID_ENTITIES = 15,
-    CUSTOM_ITEM_POOLS = 16,
-    CUSTOM_HOTKEYS = 17,
-    CUSTOM_PICKUPS = 18,
-    CUSTOM_STAGES = 19,
-    CUSTOM_TRAPDOORS = 20,
-    DEBUG_DISPLAY = 21,
-    DEPLOY_JSON_ROOM = 22,
-    DISABLE_ALL_SOUND = 23,
-    DISABLE_INPUTS = 24,
-    FADE_IN_REMOVER = 25,
-    FAST_RESET = 26,
-    FLYING_DETECTION = 27,
-    FORGOTTEN_SWITCH = 28,
-    EXTRA_CONSOLE_COMMANDS = 29,
-    ITEM_POOL_DETECTION = 30,
-    MODDED_ELEMENT_DETECTION = 31,
-    MODDED_ELEMENT_SETS = 32,
-    NO_SIREN_STEAL = 33,
-    PAUSE = 34,
-    PERSISTENT_ENTITIES = 35,
-    PICKUP_INDEX_CREATION = 36,
-    PLAYER_INVENTORY = 37,
-    PONY_DETECTION = 38,
-    PRESS_INPUT = 39,
-    PREVENT_CHILD_ENTITIES = 40,
-    PREVENT_COLLECTIBLE_ROTATION = 41,
-    PREVENT_GRID_ENTITY_RESPAWN = 42,
-    ROOM_CLEAR_FRAME = 43,
-    ROOM_HISTORY = 44,
-    RUN_IN_N_FRAMES = 45,
-    RUN_NEXT_ROOM = 46,
-    SAVE_DATA_MANAGER = 47,
-    SPAWN_ALT_ROCK_REWARDS = 48,
-    SPAWN_COLLECTIBLE = 49,
-    STAGE_HISTORY = 50,
-    START_AMBUSH = 51,
-    TAINTED_LAZARUS_PLAYERS = 52
+    SLOT_DESTROYED_DETECTION = 10,
+    SLOT_RENDER_DETECTION = 11,
+    SLOT_UPDATE_DETECTION = 12,
+    CHARACTER_HEALTH_CONVERSION = 13,
+    CHARACTER_STATS = 14,
+    COLLECTIBLE_ITEM_POOL_TYPE = 15,
+    CUSTOM_GRID_ENTITIES = 16,
+    CUSTOM_ITEM_POOLS = 17,
+    CUSTOM_HOTKEYS = 18,
+    CUSTOM_PICKUPS = 19,
+    CUSTOM_STAGES = 20,
+    CUSTOM_TRAPDOORS = 21,
+    DEBUG_DISPLAY = 22,
+    DEPLOY_JSON_ROOM = 23,
+    DISABLE_ALL_SOUND = 24,
+    DISABLE_INPUTS = 25,
+    FADE_IN_REMOVER = 26,
+    FAST_RESET = 27,
+    FLYING_DETECTION = 28,
+    FORGOTTEN_SWITCH = 29,
+    EXTRA_CONSOLE_COMMANDS = 30,
+    ITEM_POOL_DETECTION = 31,
+    MODDED_ELEMENT_DETECTION = 32,
+    MODDED_ELEMENT_SETS = 33,
+    NO_SIREN_STEAL = 34,
+    PAUSE = 35,
+    PERSISTENT_ENTITIES = 36,
+    PICKUP_INDEX_CREATION = 37,
+    PLAYER_INVENTORY = 38,
+    PONY_DETECTION = 39,
+    PRESS_INPUT = 40,
+    PREVENT_CHILD_ENTITIES = 41,
+    PREVENT_COLLECTIBLE_ROTATION = 42,
+    PREVENT_GRID_ENTITY_RESPAWN = 43,
+    ROOM_CLEAR_FRAME = 44,
+    ROOM_HISTORY = 45,
+    RUN_IN_N_FRAMES = 46,
+    RUN_NEXT_ROOM = 47,
+    SAVE_DATA_MANAGER = 48,
+    SPAWN_ALT_ROCK_REWARDS = 49,
+    SPAWN_COLLECTIBLE = 50,
+    STAGE_HISTORY = 51,
+    START_AMBUSH = 52,
+    TAINTED_LAZARUS_PLAYERS = 53
 }
 
 /**
@@ -7266,6 +7273,7 @@ declare interface ISCFeatureToClass {
     [ISCFeature.ITEM_PICKUP_DETECTION]: ItemPickupDetection;
     [ISCFeature.PLAYER_COLLECTIBLE_DETECTION]: PlayerCollectibleDetection;
     [ISCFeature.PLAYER_REORDERED_CALLBACKS]: PlayerReorderedCallbacks;
+    [ISCFeature.SLOT_DESTROYED_DETECTION]: SlotDestroyedDetection;
     [ISCFeature.SLOT_RENDER_DETECTION]: SlotRenderDetection;
     [ISCFeature.SLOT_UPDATE_DETECTION]: SlotUpdateDetection;
     [ISCFeature.CHARACTER_HEALTH_CONVERSION]: CharacterHealthConversion;
@@ -7883,6 +7891,9 @@ export declare function isSingleUseCollectible(collectibleType: CollectibleType)
 /** For `EntityType.SLOT` (6). */
 export declare function isSlot(entity: Entity): entity is EntitySlot;
 
+/** Returns true for the specific variants of `EntityType.SLOT` that are machines. */
+export declare function isSlotMachine(entity: Entity): boolean;
+
 /** Returns true for cards that have `CardType.SPECIAL`. */
 export declare function isSpecialCard(cardType: CardType): boolean;
 
@@ -8374,6 +8385,12 @@ export declare function logAllEntities(includeBackgroundEffects: boolean, entity
  */
 export declare function logAllGridEntities(includeWalls?: boolean, gridEntityTypeFilter?: GridEntityType): void;
 
+/**
+ * Helper function to log a message to the "log.txt" file and to print it to the screen at the same
+ * time.
+ */
+export declare function logAndPrint(msg: string): void;
+
 /** Helper function to enumerate all of the values in an array. */
 export declare function logArray<T>(array: T[] | readonly T[]): void;
 
@@ -10161,7 +10178,11 @@ export declare enum ModCallbackCustom {
      *   matches the sub-type provided.
      *
      * ```ts
-     * function postSlotAnimationChanged(slot: Entity): void {}
+     * function postSlotAnimationChanged(
+     *   slot: Entity,
+     *   previousAnimation: string,
+     *   currentAnimation: string,
+     * ): void {}
      * ```
      */
     POST_SLOT_ANIMATION_CHANGED = 86,
@@ -12253,6 +12274,11 @@ declare class PostSlotAnimationChanged extends CustomCallback<ModCallbackCustom.
     protected shouldFire: typeof shouldFireSlot;
 }
 
+declare class PostSlotDestroyed extends CustomCallback<ModCallbackCustom.POST_SLOT_DESTROYED> {
+    constructor();
+    protected shouldFire: typeof shouldFireSlot;
+}
+
 declare class PostSlotInit extends CustomCallback<ModCallbackCustom.POST_SLOT_INIT> {
     constructor();
     protected shouldFire: typeof shouldFireSlot;
@@ -12360,13 +12386,6 @@ declare class PreventGridEntityRespawn extends Feature {
     preventGridEntityRespawn(): void;
 }
 
-/**
- * Helper function to print something to the in-game console. Use this instead of invoking the
- * `Isaac.ConsoleOutput` method directly because it will automatically insert a newline at the end
- * of the message (which `Isaac.ConsoleOutput` does not do by default).
- */
-export declare function printConsole(msg: string): void;
-
 /** Helper function to print whether something was enabled or disabled to the in-game console. */
 export declare function printEnabled(enabled: boolean, description: string): void;
 
@@ -13069,6 +13088,7 @@ declare class RoomClearFrame extends Feature {
 
 /** This is used by the room history feature of the standard library. */
 export declare interface RoomDescription {
+    startSeedString: string;
     stage: LevelStage;
     stageType: StageType;
     stageID: StageID;
@@ -13401,8 +13421,9 @@ declare class SaveDataManager extends Feature {
     /**
      * This is the entry point to the save data manager, a system which provides two major features:
      *
-     * 1. automatic resetting of variables on a new run, on a new level, or on a new room (as desired)
-     * 2. automatic saving and loading of all tracked data to the "save#.dat" file
+     * 1. Automatic resetting of variables on a new run, on a new level, or on a new room (as
+     *    desired).
+     * 2. Automatic saving and loading of all tracked data to the "save#.dat" file.
      *
      * You feed this function with an object containing your variables, and then it will automatically
      * manage them for you. (See below for an example.)
@@ -14096,9 +14117,46 @@ export declare function shuffleArrayInPlace<T>(array: T[], seedOrRNG?: Seed | RN
  */
 export declare function sign(n: number): int;
 
+declare class SlotDestroyedDetection extends Feature {
+    v: {
+        room: {
+            destroyedSlotSet: Set<PtrHash>;
+            despawnedSlots: DespawnedSlotTuple[];
+        };
+    };
+    private postSlotDestroyed;
+    private roomHistory;
+    constructor(postSlotDestroyed: PostSlotDestroyed, roomHistory: RoomHistory);
+    private postPickupInitCollectible;
+    private postEntityRemoveSlot;
+    private postEntityRemoveSlotMachine;
+    private postEntityRemoveBeggar;
+    private postSlotUpdate;
+    /**
+     * Slots normally have an entity collision class of `EntityCollisionClass.ALL` (4) and a grid
+     * collision class of `EntityGridCollisionClass.NONE` (0). When they are destroyed with a bomb,
+     * the entity collision class stays the same, but the grid collision class switches to
+     * `EntityGridCollisionClass.GROUND` (5).
+     */
+    private checkDestroyedFromCollisionClass;
+}
+
 /** This is used in the `POST_SLOT_DESTROYED` custom callback. */
 export declare enum SlotDestructionType {
+    /**
+     * When a machine or a beggar is blown up by a bomb or is otherwise removed without spawning a
+     * collectible.
+     *
+     * Note that the destruction type for a Crane Game will be `SlotDestructionType.NORMAL`, even if
+     * it destroyed via spawning three separate collectibles.
+     */
     NORMAL = 0,
+    /**
+     * When a machine or a beggar is removed while spawning a collectible reward.
+     *
+     * Note that the destruction type for a Crane Game will be `SlotDestructionType.NORMAL`, even if
+     * it destroyed via spawning three separate collectibles.
+     */
     COLLECTIBLE_PAYOUT = 1
 }