isaacscript-common 3.0.0 → 3.2.0

package/cachedClasses.d.ts

@@ -1,10 +1,12 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 /**
  * A cached version of the class returned from the `Game()` constructor.
  *
  * Use this instead of invoking the constructor again for a miniscule performance increase.
  *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+ * Caching the results of this constructor is safe, but caching other classes (like `Level` or
  * `Room`) is not safe and can lead to the game crashing in certain situations.
  */
 export declare const game: Game;
@@ -13,7 +15,7 @@ export declare const game: Game;
  *
  * Use this instead of invoking the constructor again for a miniscule performance increase.
  *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+ * Caching the results of this constructor is safe, but caching other classes (like `Level` or
  * `Room`) is not safe and can lead to the game crashing in certain situations.
  */
 export declare const itemConfig: import("isaac-typescript-definitions/types/ItemConfig").ItemConfig;
@@ -22,7 +24,7 @@ export declare const itemConfig: import("isaac-typescript-definitions/types/Item
  *
  * Use this instead of invoking the constructor again for a miniscule performance increase.
  *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+ * Caching the results of this constructor is safe, but caching other classes (like `Level` or
  * `Room`) is not safe and can lead to the game crashing in certain situations.
  */
 export declare const musicManager: MusicManager;
@@ -31,7 +33,7 @@ export declare const musicManager: MusicManager;
  *
  * Use this instead of invoking the constructor again for a miniscule performance increase.
  *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+ * Caching the results of this constructor is safe, but caching other classes (like `Level` or
  * `Room`) is not safe and can lead to the game crashing in certain situations.
  */
 export declare const sfxManager: SFXManager;

package/cachedClasses.lua

@@ -3,28 +3,28 @@ local ____exports = {}
 -- 
 -- Use this instead of invoking the constructor again for a miniscule performance increase.
 -- 
--- Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+-- Caching the results of this constructor is safe, but caching other classes (like `Level` or
 -- `Room`) is not safe and can lead to the game crashing in certain situations.
 ____exports.game = Game()
 --- A cached version of the class returned from the `Isaac.GetItemConfig()` constructor.
 -- 
 -- Use this instead of invoking the constructor again for a miniscule performance increase.
 -- 
--- Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+-- Caching the results of this constructor is safe, but caching other classes (like `Level` or
 -- `Room`) is not safe and can lead to the game crashing in certain situations.
 ____exports.itemConfig = Isaac.GetItemConfig()
 --- A cached version of the class returned from the `MusicManager()` constructor.
 -- 
 -- Use this instead of invoking the constructor again for a miniscule performance increase.
 -- 
--- Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+-- Caching the results of this constructor is safe, but caching other classes (like `Level` or
 -- `Room`) is not safe and can lead to the game crashing in certain situations.
 ____exports.musicManager = MusicManager()
 --- A cached version of the class returned from the `SFXManager()` constructor.
 -- 
 -- Use this instead of invoking the constructor again for a miniscule performance increase.
 -- 
--- Caching the results of a this constructor is safe, but caching other classes (like `Level` or
+-- Caching the results of this constructor is safe, but caching other classes (like `Level` or
 -- `Room`) is not safe and can lead to the game crashing in certain situations.
 ____exports.sfxManager = SFXManager()
 return ____exports

package/callbacks/postPickupInitFirst.d.ts

@@ -0,0 +1 @@
+export {};

package/callbacks/postPickupInitFirst.lua

@@ -0,0 +1,55 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local hasSubscriptions, postPickupInit, POST_ASCENT_ROOM_TYPES, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GameStateFlag = ____isaac_2Dtypescript_2Ddefinitions.GameStateFlag
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+local ____roomData = require("functions.roomData")
+local getRoomVisitedCount = ____roomData.getRoomVisitedCount
+local ____postPickupInitFirst = require("callbacks.subscriptions.postPickupInitFirst")
+local postPickupInitFirstFire = ____postPickupInitFirst.postPickupInitFirstFire
+local postPickupInitFirstHasSubscriptions = ____postPickupInitFirst.postPickupInitFirstHasSubscriptions
+function hasSubscriptions(self)
+    return postPickupInitFirstHasSubscriptions(nil)
+end
+function postPickupInit(self, pickup)
+    if not hasSubscriptions(nil) then
+        return
+    end
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomFrameCount = room:GetFrameCount()
+    local previouslySeen = v.run.postAscentPickupInitSeeds:has(pickup.InitSeed)
+    if POST_ASCENT_ROOM_TYPES:has(roomType) then
+        v.run.postAscentPickupInitSeeds:add(pickup.InitSeed)
+    end
+    if roomFrameCount > 0 then
+        postPickupInitFirstFire(nil, pickup)
+        return
+    end
+    local roomVisitedCount = getRoomVisitedCount(nil)
+    if roomVisitedCount > 0 then
+        return
+    end
+    local onAscent = game:GetStateFlag(GameStateFlag.BACKWARDS_PATH)
+    if onAscent and POST_ASCENT_ROOM_TYPES:has(roomType) and previouslySeen then
+        return
+    end
+    postPickupInitFirstFire(nil, pickup)
+end
+POST_ASCENT_ROOM_TYPES = __TS__New(Set, {RoomType.TREASURE, RoomType.BOSS})
+v = {run = {postAscentPickupInitSeeds = __TS__New(Set)}}
+---
+-- @internal
+function ____exports.postPickupInitFirstCallbackInit(self, mod)
+    saveDataManager(nil, "postPickupInitFirst", v, hasSubscriptions)
+    mod:AddCallback(ModCallback.POST_PICKUP_INIT, postPickupInit)
+end
+return ____exports

package/callbacks/postSlotDestroyed.d.ts

@@ -0,0 +1 @@
+export {};

package/callbacks/postSlotDestroyed.lua

@@ -0,0 +1,66 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local Map = ____lualib.Map
+local ____exports = {}
+local hasSubscriptions, postEntityRemove, postSlotAnimationChanged, BROKEN_ANIMATIONS, PRIZE_GAME_FRAME_DELAY_UNTIL_REMOVAL, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+local ____postSlotDestroyed = require("callbacks.subscriptions.postSlotDestroyed")
+local postSlotDestroyedFire = ____postSlotDestroyed.postSlotDestroyedFire
+local postSlotDestroyedHasSubscriptions = ____postSlotDestroyed.postSlotDestroyedHasSubscriptions
+function hasSubscriptions(self)
+    return postSlotDestroyedHasSubscriptions(nil)
+end
+function postEntityRemove(self, entity)
+    local slot = entity
+    local ptrHash = GetPtrHash(slot)
+    local gameFrameCount = game:GetFrameCount()
+    local prizeFrame = v.room.slotPrizeAnimationGameFrame:get(ptrHash)
+    if prizeFrame == nil then
+        return
+    end
+    if prizeFrame + PRIZE_GAME_FRAME_DELAY_UNTIL_REMOVAL == gameFrameCount then
+        postSlotDestroyedFire(nil, slot)
+    end
+end
+function postSlotAnimationChanged(self, slot)
+    local ptrHash = GetPtrHash(slot)
+    local gameFrameCount = game:GetFrameCount()
+    local alreadyBroken = v.room.brokenSlots:has(ptrHash)
+    if alreadyBroken then
+        return
+    end
+    local sprite = slot:GetSprite()
+    local animation = sprite:GetAnimation()
+    if BROKEN_ANIMATIONS:has(animation) then
+        v.room.brokenSlots:add(ptrHash)
+        postSlotDestroyedFire(nil, slot)
+    end
+    if animation == "Prize" then
+        v.room.slotPrizeAnimationGameFrame:set(ptrHash, gameFrameCount)
+    else
+        v.room.slotPrizeAnimationGameFrame:delete(ptrHash)
+    end
+end
+BROKEN_ANIMATIONS = __TS__New(Set, {"Broken", "Death"})
+PRIZE_GAME_FRAME_DELAY_UNTIL_REMOVAL = 3
+v = {room = {
+    brokenSlots = __TS__New(Set),
+    slotPrizeAnimationGameFrame = __TS__New(Map)
+}}
+---
+-- @internal
+function ____exports.postSlotDestroyedCallbacksInit(self, mod)
+    saveDataManager(nil, "postSlotDestroyed", v, hasSubscriptions)
+    mod:AddCallback(ModCallback.POST_ENTITY_REMOVE, postEntityRemove, EntityType.SLOT)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_SLOT_ANIMATION_CHANGED, postSlotAnimationChanged)
+end
+return ____exports

package/callbacks/postSlotRender.lua

@@ -1,8 +1,8 @@
 local ____lualib = require("lualib_bundle")
-local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
 local ____exports = {}
-local hasSubscriptions, postRender, checkSlotAnimationChanged, checkSlotBroken, BROKEN_ANIMATIONS, v
+local hasSubscriptions, postRender, checkSlotAnimationChanged, v
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____DefaultMap = require("classes.DefaultMap")
@@ -14,14 +14,11 @@ local getSlots = ____entitySpecific.getSlots
 local ____postSlotAnimationChanged = require("callbacks.subscriptions.postSlotAnimationChanged")
 local postSlotAnimationChangedFire = ____postSlotAnimationChanged.postSlotAnimationChangedFire
 local postSlotAnimationChangedHasSubscriptions = ____postSlotAnimationChanged.postSlotAnimationChangedHasSubscriptions
-local ____postSlotDestroyed = require("callbacks.subscriptions.postSlotDestroyed")
-local postSlotDestroyedFire = ____postSlotDestroyed.postSlotDestroyedFire
-local postSlotDestroyedHasSubscriptions = ____postSlotDestroyed.postSlotDestroyedHasSubscriptions
 local ____postSlotRender = require("callbacks.subscriptions.postSlotRender")
 local postSlotRenderFire = ____postSlotRender.postSlotRenderFire
 local postSlotRenderHasSubscriptions = ____postSlotRender.postSlotRenderHasSubscriptions
 function hasSubscriptions(self)
-    return postSlotRenderHasSubscriptions(nil) or postSlotDestroyedHasSubscriptions(nil) or postSlotAnimationChangedHasSubscriptions(nil)
+    return postSlotRenderHasSubscriptions(nil) or postSlotAnimationChangedHasSubscriptions(nil)
 end
 function postRender(self)
     if not hasSubscriptions(nil) then
@@ -30,7 +27,6 @@ function postRender(self)
     for ____, slot in ipairs(getSlots(nil)) do
         postSlotRenderFire(nil, slot)
         checkSlotAnimationChanged(nil, slot)
-        checkSlotBroken(nil, slot)
     end
 end
 function checkSlotAnimationChanged(self, slot)
@@ -43,20 +39,6 @@ function checkSlotAnimationChanged(self, slot)
         postSlotAnimationChangedFire(nil, slot, previousAnimation, currentAnimation)
     end
 end
-function checkSlotBroken(self, slot)
-    local ptrHash = GetPtrHash(slot)
-    local alreadyBroken = v.room.brokenSlots:has(ptrHash)
-    if alreadyBroken then
-        return
-    end
-    local sprite = slot:GetSprite()
-    local animation = sprite:GetAnimation()
-    if BROKEN_ANIMATIONS:has(animation) then
-        v.room.brokenSlots:add(ptrHash)
-        postSlotDestroyedFire(nil, slot)
-    end
-end
-BROKEN_ANIMATIONS = __TS__New(Set, {"Broken", "Death"})
 v = {room = {
     slotAnimations = __TS__New(
         DefaultMap,

package/callbacks/subscriptions/postCustomRevive.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostCustomReviveRegisterParameters = [
     callback: (player: EntityPlayer, revivalType: int) => void,
     revivalType?: int

package/callbacks/subscriptions/postDoorRender.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostDoorRenderRegisterParameters = [
     callback: (door: GridEntityDoor) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postDoorUpdate.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostDoorUpdateRegisterParameters = [
     callback: (door: GridEntityDoor) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postPickupCollect.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPickupCollectRegisterParameters = PickupRegisterParameters<[
     player: EntityPlayer
 ], void>;

package/callbacks/subscriptions/postPickupInitFirst.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare type PostPickupInitFirstRegisterParameters = PickupRegisterParameters<[
+], void>;

package/callbacks/subscriptions/postPickupInitFirst.lua

@@ -0,0 +1,29 @@
+local ____exports = {}
+local subscriptions = {}
+---
+-- @internal
+function ____exports.postPickupInitFirstHasSubscriptions(self)
+    return #subscriptions > 0
+end
+---
+-- @internal
+function ____exports.postPickupInitFirstRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+---
+-- @internal
+function ____exports.postPickupInitFirstFire(self, pickup)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local pickupVariant = ____value[2]
+        do
+            if pickupVariant ~= nil and pickupVariant ~= pickup.Variant then
+                goto __continue5
+            end
+            callback(nil, pickup)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postPickupStateChanged.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPickupStateChangedRegisterParameters = PickupRegisterParameters<[
     previousState: int,
     currentState: int

package/callbacks/subscriptions/postPitRender.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPitRenderRegisterParameters = [
     callback: (pit: GridEntityPit) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postPitUpdate.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPitUpdateRegisterParameters = [
     callback: (pit: GridEntityPit) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postPoopRender.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPoopRenderRegisterParameters = [
     callback: (poop: GridEntityPoop) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postPoopUpdate.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPoopUpdateRegisterParameters = [
     callback: (poop: GridEntityPoop) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postPressurePlateRender.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPressurePlateRenderRegisterParameters = [
     callback: (pressurePlate: GridEntityPressurePlate) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postPressurePlateUpdate.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostPressurePlateUpdateRegisterParameters = [
     callback: (pressurePlate: GridEntityPressurePlate) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postRockRender.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostRockRenderRegisterParameters = [
     callback: (rock: GridEntityRock) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postRockUpdate.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostRockUpdateRegisterParameters = [
     callback: (rock: GridEntityRock) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postSpikesRender.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostSpikesRenderRegisterParameters = [
     callback: (spikes: GridEntitySpikes) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postSpikesUpdate.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostSpikesUpdateRegisterParameters = [
     callback: (spikes: GridEntitySpikes) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postTNTRender.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostTNTRenderRegisterParameters = [
     callback: (tnt: GridEntityTNT) => void,
     gridEntityVariant?: int

package/callbacks/subscriptions/postTNTUpdate.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
 export declare type PostTNTUpdateRegisterParameters = [
     callback: (tnt: GridEntityTNT) => void,
     gridEntityVariant?: int

package/classes/DefaultMap.d.ts

@@ -46,7 +46,7 @@ export declare type FactoryFunction<V, Args extends unknown[]> = (...extraArgs:
  *
  * ```ts
  * // Initializes a new empty DefaultMap with a default value of a new empty array.
- * const factoryFunction = () => [] as ;
+ * const factoryFunction = () => [];
  * const defaultMapWithArray = new DefaultMap<string, string[]>(factoryFunction);
  * ```
  *
@@ -96,7 +96,6 @@ export declare class DefaultMap<Key, Value, Args extends unknown[] = []> extends
      * it will set a default value for the provided key, and then return the default value.
      */
     getAndSetDefault(key: Key, ...extraArgs: Args): Value;
-    getWithoutDefault(key: Key): Value | undefined;
     /**
      * Returns the default value to be used for a new key. (If a factory function was provided during
      * instantiation, this will execute the factory function.)

package/classes/DefaultMap.lua

@@ -46,7 +46,7 @@ local ____exports = {}
 -- 
 -- ```ts
 -- // Initializes a new empty DefaultMap with a default value of a new empty array.
--- const factoryFunction = () => [] as ;
+-- const factoryFunction = () => [];
 -- const defaultMapWithArray = new DefaultMap<string, string[]>(factoryFunction);
 -- ```
 -- 
@@ -111,9 +111,6 @@ function DefaultMap.prototype.getAndSetDefault(self, key, ...)
     self:set(key, defaultValue)
     return defaultValue
 end
-function DefaultMap.prototype.getWithoutDefault(self, key)
-    return Map.prototype.get(self, key)
-end
 function DefaultMap.prototype.getDefaultValue(self, ...)
     if self.defaultValue ~= nil then
         return self.defaultValue