isaacscript-common 2.3.0 → 2.3.1

package/callbacks/subscriptions/postSlotAnimationChanged.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSlotAnimationChangedHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSlotAnimationChangedRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postSlotAnimationChangedFire(self, slot, previousAnimation, currentAnimation)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local slotVariant = ____value[2]
+        do
+            if slotVariant ~= nil and slotVariant ~= slot.Variant then
+                goto __continue5
+            end
+            callback(nil, slot, previousAnimation, currentAnimation)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postSlotDestroyed.d.ts

@@ -0,0 +1,5 @@
+import { SlotVariant } from "isaac-typescript-definitions";
+export declare type PostSlotDestroyedRegisterParameters = [
+    callback: (slot: EntitySlot) => void,
+    slotVariant?: SlotVariant
+];

package/callbacks/subscriptions/postSlotDestroyed.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSlotDestroyedHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSlotDestroyedRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postSlotDestroyedFire(self, slot)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local slotVariant = ____value[2]
+        do
+            if slotVariant ~= nil and slotVariant ~= slot.Variant then
+                goto __continue5
+            end
+            callback(nil, slot)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postSlotInit.d.ts

@@ -0,0 +1,5 @@
+import { SlotVariant } from "isaac-typescript-definitions";
+export declare type PostSlotInitRegisterParameters = [
+    callback: (slot: EntitySlot) => void,
+    slotVariant?: SlotVariant
+];

package/callbacks/subscriptions/postSlotInit.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSlotInitHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSlotInitRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postSlotInitFire(self, slot)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local slotVariant = ____value[2]
+        do
+            if slotVariant ~= nil and slotVariant ~= slot.Variant then
+                goto __continue5
+            end
+            callback(nil, slot)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postSlotRender.d.ts

@@ -0,0 +1,5 @@
+import { SlotVariant } from "isaac-typescript-definitions";
+export declare type PostSlotRenderRegisterParameters = [
+    callback: (slot: EntitySlot) => void,
+    slotVariant?: SlotVariant
+];

package/callbacks/subscriptions/postSlotRender.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSlotRenderHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSlotRenderRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postSlotRenderFire(self, slot)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local slotVariant = ____value[2]
+        do
+            if slotVariant ~= nil and slotVariant ~= slot.Variant then
+                goto __continue5
+            end
+            callback(nil, slot)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postSlotUpdate.d.ts

@@ -0,0 +1,5 @@
+import { SlotVariant } from "isaac-typescript-definitions";
+export declare type PostSlotUpdateRegisterParameters = [
+    callback: (slot: EntitySlot) => void,
+    slotVariant?: SlotVariant
+];

package/callbacks/subscriptions/postSlotUpdate.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSlotUpdateHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSlotUpdateRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postSlotUpdateFire(self, slot)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local slotVariant = ____value[2]
+        do
+            if slotVariant ~= nil and slotVariant ~= slot.Variant then
+                goto __continue5
+            end
+            callback(nil, slot)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postSpikesRender.d.ts

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

package/callbacks/subscriptions/postSpikesRender.lua

@@ -0,0 +1,24 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSpikesRenderHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSpikesRenderRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postSpikesRenderFire(self, spikes)
+    local gridEntityVariant = spikes:GetVariant()
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local callbackGridEntityVariant = ____value[2]
+        do
+            if callbackGridEntityVariant ~= nil and callbackGridEntityVariant ~= gridEntityVariant then
+                goto __continue5
+            end
+            callback(nil, spikes)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postSpikesUpdate.d.ts

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

package/callbacks/subscriptions/postSpikesUpdate.lua

@@ -0,0 +1,24 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSpikesUpdateHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSpikesUpdateRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postSpikesUpdateFire(self, spikes)
+    local gridEntityVariant = spikes:GetVariant()
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local callbackGridEntityVariant = ____value[2]
+        do
+            if callbackGridEntityVariant ~= nil and callbackGridEntityVariant ~= gridEntityVariant then
+                goto __continue5
+            end
+            callback(nil, spikes)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postTNTRender.d.ts

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

package/callbacks/subscriptions/postTNTRender.lua

@@ -0,0 +1,24 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postTNTRenderHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postTNTRenderRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postTNTRenderFire(self, tnt)
+    local gridEntityVariant = tnt:GetVariant()
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local callbackGridEntityVariant = ____value[2]
+        do
+            if callbackGridEntityVariant ~= nil and callbackGridEntityVariant ~= gridEntityVariant then
+                goto __continue5
+            end
+            callback(nil, tnt)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postTNTUpdate.d.ts

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

package/callbacks/subscriptions/postTNTUpdate.lua

@@ -0,0 +1,24 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postTNTUpdateHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postTNTUpdateRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postTNTUpdateFire(self, tnt)
+    local gridEntityVariant = tnt:GetVariant()
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local callbackGridEntityVariant = ____value[2]
+        do
+            if callbackGridEntityVariant ~= nil and callbackGridEntityVariant ~= gridEntityVariant then
+                goto __continue5
+            end
+            callback(nil, tnt)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postTearInitLate.d.ts

@@ -0,0 +1,5 @@
+import { TearVariant } from "isaac-typescript-definitions";
+export declare type PostTearInitLateRegisterParameters = [
+    callback: (tear: EntityTear) => void,
+    tearVariant?: TearVariant
+];

package/callbacks/subscriptions/postTearInitLate.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postTearInitLateHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postTearInitLateRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postTearInitLateFire(self, tear)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local tearVariant = ____value[2]
+        do
+            if tearVariant ~= nil and tearVariant ~= tear.Variant then
+                goto __continue5
+            end
+            callback(nil, tear)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postTearInitVeryLate.d.ts

@@ -0,0 +1,5 @@
+import { TearVariant } from "isaac-typescript-definitions";
+export declare type PostTearInitVeryLateRegisterParameters = [
+    callback: (tear: EntityTear) => void,
+    tearVariant?: TearVariant
+];

package/callbacks/subscriptions/postTearInitVeryLate.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postTearInitVeryLateHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postTearInitVeryLateRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postTearInitVeryLateFire(self, tear)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local tearVariant = ____value[2]
+        do
+            if tearVariant ~= nil and tearVariant ~= tear.Variant then
+                goto __continue5
+            end
+            callback(nil, tear)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postTransformation.d.ts

@@ -0,0 +1,5 @@
+import { PlayerForm } from "isaac-typescript-definitions";
+export declare type PostTransformationRegisterParameters = [
+    callback: (player: EntityPlayer, playerForm: PlayerForm, hasForm: boolean) => void,
+    playerForm?: PlayerForm
+];

package/callbacks/subscriptions/postTransformation.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postTransformationHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postTransformationRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postTransformationFire(self, player, playerForm, hasForm)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local callbackPlayerForm = ____value[2]
+        do
+            if callbackPlayerForm ~= nil and callbackPlayerForm ~= playerForm then
+                goto __continue5
+            end
+            callback(nil, player, playerForm, hasForm)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/postTrinketBreak.d.ts

@@ -0,0 +1,5 @@
+import { TrinketType } from "isaac-typescript-definitions";
+export declare type PostTrinketBreakRegisterParameters = [
+    callback: (player: EntityPlayer, trinketType: TrinketType) => void,
+    trinketType?: TrinketType
+];

package/callbacks/subscriptions/postTrinketBreak.lua

@@ -0,0 +1,23 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postTrinketBreakHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postTrinketBreakRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.postTrinketBreakFire(self, player, trinketType)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local callbackTrinketType = ____value[2]
+        do
+            if callbackTrinketType ~= nil and callbackTrinketType ~= trinketType then
+                goto __continue5
+            end
+            callback(nil, player, trinketType)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/preBerserkDeath.d.ts

@@ -0,0 +1,6 @@
+import { PlayerType, PlayerVariant } from "isaac-typescript-definitions";
+export declare type PreBerserkDeathRegisterParameters = [
+    callback: (player: EntityPlayer) => boolean | void,
+    playerVariant?: PlayerVariant,
+    character?: PlayerType
+];

package/callbacks/subscriptions/preBerserkDeath.lua

@@ -0,0 +1,29 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.preBerserkDeathHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.preBerserkDeathRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.preBerserkDeathFire(self, player)
+    local character = player:GetPlayerType()
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local playerVariant = ____value[2]
+        local callbackCharacter = ____value[3]
+        do
+            if playerVariant ~= nil and playerVariant ~= player.Variant then
+                goto __continue5
+            end
+            if callbackCharacter ~= nil and callbackCharacter ~= character then
+                goto __continue5
+            end
+            callback(nil, player)
+        end
+        ::__continue5::
+    end
+    return nil
+end
+return ____exports

package/callbacks/subscriptions/preCustomRevive.d.ts

@@ -0,0 +1,6 @@
+import { PlayerType, PlayerVariant } from "isaac-typescript-definitions";
+export declare type PreCustomReviveRegisterParameters = [
+    callback: (player: EntityPlayer) => int | void,
+    playerVariant?: PlayerVariant,
+    character?: PlayerType
+];

package/callbacks/subscriptions/preCustomRevive.lua

@@ -0,0 +1,32 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.preCustomReviveHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.preCustomReviveRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.preCustomReviveFire(self, player)
+    local character = player:GetPlayerType()
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local playerVariant = ____value[2]
+        local callbackCharacter = ____value[3]
+        do
+            if playerVariant ~= nil and playerVariant ~= player.Variant then
+                goto __continue5
+            end
+            if callbackCharacter ~= nil and callbackCharacter ~= character then
+                goto __continue5
+            end
+            local revivalType = callback(nil, player)
+            if revivalType ~= nil then
+                return revivalType
+            end
+        end
+        ::__continue5::
+    end
+    return nil
+end
+return ____exports

package/callbacks/subscriptions/preItemPickup.d.ts

@@ -0,0 +1,11 @@
+import { CollectibleType, ItemType, TrinketType } from "isaac-typescript-definitions";
+import { PickingUpItem, PickingUpItemCollectible, PickingUpItemTrinket } from "../../types/PickingUpItem";
+export declare type PreItemPickupRegisterParameters = [callback: (player: EntityPlayer, pickingUpItem: PickingUpItem) => void] | [
+    callback: (player: EntityPlayer, pickingUpItem: PickingUpItemCollectible) => void,
+    itemType: ItemType.PASSIVE | ItemType.ACTIVE | ItemType.FAMILIAR,
+    collectibleType?: CollectibleType
+] | [
+    callback: (player: EntityPlayer, pickingUpItem: PickingUpItemTrinket) => void,
+    itemType: ItemType.TRINKET,
+    trinketType?: TrinketType
+];

package/callbacks/subscriptions/preItemPickup.lua

@@ -0,0 +1,27 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.preItemPickupHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.preItemPickupRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.preItemPickupFire(self, player, pickingUpItem)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local itemType = ____value[2]
+        local subType = ____value[3]
+        do
+            if itemType ~= nil and itemType ~= pickingUpItem.itemType then
+                goto __continue5
+            end
+            if subType ~= nil and subType ~= pickingUpItem.subType then
+                goto __continue5
+            end
+            callback(nil, player, pickingUpItem)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/callbacks/subscriptions/preNewLevel.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare type PreNewLevelRegisterParameters = [
+    callback: (player: EntityPlayer) => void
+];

package/callbacks/subscriptions/preNewLevel.lua

@@ -0,0 +1,16 @@
+local ____exports = {}
+local subscriptions = {}
+function ____exports.preNewLevelHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.preNewLevelRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+function ____exports.preNewLevelFire(self, player)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        callback(nil, player)
+    end
+end
+return ____exports

package/classes/DefaultMap.d.ts

@@ -0,0 +1,79 @@
+/**
+ * A function that creates the value for your default map. For example, if it was a default map
+ * containing maps, the factory function would be: `() => new Map()`
+ */
+export declare type FactoryFunction<V, Args extends unknown[]> = (...extraArgs: Args) => V;
+declare type FirstArg<K, V, Args extends unknown[]> = Iterable<[K, V]> | V | FactoryFunction<V, Args>;
+declare type SecondArg<V, Args extends unknown[]> = V | FactoryFunction<V, Args>;
+/**
+ * An extended `Map` with some new methods:
+ *
+ * - `getAndSetDefault` - If the key exists, this will return the same thing as the `get` method.
+ *   Otherwise, it will set a default value to the key, and then return the default value.
+ * - `getDefaultValue` - 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.)
+ * - `getConstructorArg` - Helper method for cloning the map. Returns either the default value or
+ *   the reference to the factory function.
+ *
+ * When instantiating a new DefaultMap, you must specify either a default value or a function that
+ * returns a default value.
+ *
+ * For example:
+ *
+ * ```ts
+ * // Initializes a new empty DefaultMap with a default value of "foo".
+ * const defaultMapWithPrimitive = new DefaultMap<string, string>("foo");
+ *
+ * // Initializes a new empty DefaultMap with a default value of a new Map.
+ * const defaultMapWithFactory = new DefaultMap<string, Map<string, string>>(() => {
+ *   return new Map();
+ * })
+ *
+ * // Initializes a DefaultMap with some initial values and a default value of "bar".
+ * const defaultMapWithInitialValues = new DefaultMap<string, string>([
+ *   ["a1", "a2"],
+ *   ["b1", "b2"],
+ * ], "bar");
+ * ```
+ *
+ * If specified, the first argument of a factory function must always be equal to the key:
+ *
+ * ```ts
+ * const defaultMapWithConditionalDefaultValue = new DefaultMap<number, number>((key: number) => {
+ *   return isOdd(key) ? 0 : 1;
+ * });
+ * ```
+ *
+ * You can also specify a factory function that takes a generic amount of arguments beyond the
+ * first:
+ *
+ * ```ts
+ * const factoryFunction = (arg: boolean) => arg ? 0 : 1;
+ * const defaultMapWithExtraArgs = new DefaultMap<string, string, [arg: boolean]>(factoryFunction);
+ * ```
+ */
+export declare class DefaultMap<K, V, Args extends unknown[] = []> extends Map<K, V> {
+    private defaultValue;
+    private defaultValueFactory;
+    /**
+     * See the main `DefaultMap` documentation:
+     * https://isaacscript.github.io/isaacscript-common/classes/classes_DefaultMap.DefaultMap
+     */
+    constructor(iterableOrDefaultValueOrDefaultValueFactory: FirstArg<K, V, Args>, defaultValueOrDefaultValueFactory?: SecondArg<V, Args>);
+    /**
+     * If the key exists, this will return the same thing as the `get` method. Otherwise, it will set
+     * a default value to the key, and then return the default value.
+     */
+    getAndSetDefault(key: K, ...extraArgs: Args): V;
+    /**
+     * 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.)
+     */
+    getDefaultValue(...extraArgs: Args): V;
+    /**
+     * Helper method for cloning the map. Returns either the default value or a reference to the
+     * factory function.
+     */
+    getConstructorArg(): V | FactoryFunction<V, Args>;
+}
+export {};