isaacscript-common 14.1.1 → 14.1.3

package/dist/index.d.ts

@@ -79,6 +79,10 @@ import { TrapdoorVariant } from 'isaac-typescript-definitions';
 import { TrinketType } from 'isaac-typescript-definitions';
 import { UseFlag } from 'isaac-typescript-definitions';
 
+export declare const ADD_CALLBACK_ARGS_KEY = "__addCallbackArgs";
+
+export declare const ADD_CALLBACK_CUSTOM_ARGS_KEY = "__addCallbackCustomArgs";
+
 declare interface AddCallbackParametersCustom {
     [ModCallbackCustom.POST_AMBUSH_FINISHED]: PostAmbushFinishedRegisterParameters;
     [ModCallbackCustom.POST_AMBUSH_STARTED]: PostAmbushStartedRegisterParameters;
@@ -827,16 +831,18 @@ export declare function calculateStageTypeRepentance(stage: LevelStage): StageTy
 /**
  * A decorator function that signifies that the decorated class method should be automatically
  * registered with `Mod.AddCallback`.
+ *
+ * @ignore
  */
 export declare function Callback<T extends ModCallback>(modCallback: T, ...optionalArgs: AllButFirst<AddCallbackParameters[T]>): <Class extends ModFeature, Fn extends AddCallbackParameters[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
 
 /**
  * A decorator function that signifies that the decorated class method should be automatically
  * registered with `ModUpgraded.AddCallbackCustom`.
+ *
+ * @ignore
  */
-export declare function CallbackCustom<T extends ModCallbackCustom2>(modCallbackCustom: T, ...optionalArgs: AllButFirst<AddCallbackParametersCustom2[T]>): <Class extends {
-    mod: ModUpgraded;
-}>(target: Class, propertyKey: string) => void;
+export declare function CallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Class extends ModFeature, Fn extends AddCallbackParametersCustom[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
 
 declare type CallbackSignatureGridEntity = ((gridEntity: GridEntity) => void) | ((gridEntity: GridEntity, oldState: int, newState: int) => void);
 
@@ -2651,7 +2657,6 @@ declare class Feature {
     featuresUsed?: ISCFeature[];
     callbacksUsed?: CallbackTuple[];
     customCallbacksUsed?: CustomCallbackTuple[];
-    exportedMethods: string[];
 }
 
 export declare function fillLevelWithRedRooms(): void;
@@ -5911,8 +5916,6 @@ export declare function getTrinketTypes(): TrinketType[];
  */
 export declare function getTSTLClassConstructor(object: unknown): TSTLClassMetatable["constructor"] | undefined;
 
-export declare function getTSTLClassMethods(object: unknown): FunctionTuple[];
-
 /**
  * Helper function to get the name of a TypeScriptToLua class from the instantiated class object.
  *
@@ -7522,8 +7525,6 @@ export declare function kColorEquals(kColor1: KColor, kColor2: KColor): boolean;
  */
 export declare function keyboardToString(keyboard: Keyboard, uppercase: boolean): string | undefined;
 
-declare type KeysToScrubFromModClass = keyof Feature | LowercaseKeys<ModUpgraded>;
-
 /**
  * For `EntityType.EFFECT` (1000), `EffectVariant.LADDER` (8).
  *
@@ -7713,8 +7714,8 @@ export declare function logSet(set: Set<AnyNotNil> | ReadonlySet<AnyNotNil>): vo
 export declare function logSounds(): void;
 
 /**
- * Helper function for logging every key and value of a table. This is a deep log; the function will
- * recursively call itself if it counters a table within a table.
+ * Helper function for logging every key and value of a Lua table. This is a deep log; the function
+ * will recursively call itself if it counters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
  * instead of randomly). It will throw a run-time error if it encounters a non-string key.
@@ -7727,6 +7728,14 @@ export declare function logTable(luaTable: unknown, parentTables?: number): void
  */
 export declare function logTableDifferences<K extends AnyNotNil, V>(table1: LuaMap<K, V>, table2: LuaMap<K, V>): void;
 
+/**
+ * Helper function to log the keys of a Lua table. This is not a deep log; only the keys of the
+ * top-most table will be logged.
+ *
+ * This function is useful for tables that have recursive references.
+ */
+export declare function logTableKeys(luaTable: unknown): void;
+
 /** Helper function for printing out every tear flag that is turned on. Useful when debugging. */
 export declare function logTearFlags(flags: TearFlag | BitFlags<TearFlag>): void;
 
@@ -9450,12 +9459,22 @@ declare type ModCallbackCustomPlayer = MatchingCallbackCustom<CallbackSignatureP
 declare type ModCallbackCustomRevive = MatchingCallbackCustom<CallbackSignatureRevive>;
 
 /**
- * A helper class for a mod that wants to represent its individual features as classes. This is
- * useful if you are using decorators to represent class methods that should be automatically
- * subscribed to callbacks.
+ * A helper class for mods that wants to represent their individual features as classes. Extend your
+ * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
+ * that automatically subscribe to callbacks.
+ *
+ * For example:
+ *
+ * ```ts
+ * export class MyFeature extends ModFeature {
+ *   @Callback(ModCallback.POST_GAME_STARTED)
+ *   postGameStarted(isContinued: boolean): void {
+ *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
+ *   }
+ * }
+ * ```
  */
 export declare class ModFeature {
-    private mod;
     constructor(mod: ModUpgraded);
 }
 
@@ -9519,24 +9538,20 @@ export declare class ModUpgraded implements Mod {
      * conditions of how you registered the callback, it will be removed.
      */
     RemoveCallbackCustom<T extends ModCallbackCustom2>(modCallbackCustom: T, callback: AddCallbackParametersCustom2[T][0]): void;
-    /**
-     * This method should only be used by the `upgradeMod` function. Returns the class methods from
-     * the features that were added.
-     */
-    initOptionalFeature(feature: ISCFeature): FunctionTuple[];
     /** This is used to initialize both custom callbacks and "extra features". */
     private initFeature;
     private uninitFeature;
+    /** Returns the names of the exported class methods from the features that were added. */
+    private initOptionalFeature;
 }
 
 /**
  * By specifying one or more optional features, end-users will get a version of `ModUpgraded` that
  * has extra methods corresponding to the features.
  *
- * We have to explicitly account for the empty array case, since `never` will cause mess up the
- * union.
+ * We have to explicitly account for the empty array case, since the `never` will mess up the union.
  */
-declare type ModUpgradedWithFeatures<T extends ISCFeature> = [T] extends [never] ? ModUpgraded : Omit<ModUpgraded & UnionToIntersection<ISCFeatureToClass[T]>, KeysToScrubFromModClass>;
+declare type ModUpgradedWithFeatures<T extends ISCFeature> = [T] extends [never] ? ModUpgraded : ModUpgraded & Omit<UnionToIntersection<ISCFeatureToClass[T]>, keyof Feature>;
 
 /**
  * Helper function to move all of the players to where they would normally go when arriving at a new

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 14.1.1
+isaacscript-common 14.1.3
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -16939,18 +16939,12 @@ return ____exports
  end,
 ["src.interfaces.TSTLClassMetatable"] = function(...) 
 local ____exports = {}
-return ____exports
- end,
-["src.types.FunctionTuple"] = function(...) 
-local ____exports = {}
 return ____exports
  end,
 ["src.functions.tstlClass"] = function(...) 
 local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
-local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
-local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local VANILLA_TSTL_CLASSES
 local ____types = require("src.functions.types")
@@ -16982,23 +16976,6 @@ function ____exports.isVanillaTSTLClass(self, object)
 end
 VANILLA_TSTL_CLASSES = __TS__New(Set, {"Map", "Set", "WeakMap", "WeakSet"})
 local TSTL_CLASS_METATABLE_KEYS = __TS__New(Set, {"____constructor", "__index", "constructor"})
-function ____exports.getTSTLClassMethods(self, object)
-    local constructor = ____exports.getTSTLClassConstructor(nil, object)
-    if constructor == nil then
-        return {}
-    end
-    local classEntries = __TS__ObjectEntries(constructor.prototype)
-    return __TS__ArrayFilter(
-        classEntries,
-        function(____, ____bindingPattern0)
-            local value
-            local key
-            key = ____bindingPattern0[1]
-            value = ____bindingPattern0[2]
-            return not TSTL_CLASS_METATABLE_KEYS:has(key) and type(value) == "function"
-        end
-    )
-end
 function ____exports.isDefaultMap(self, object)
     local className = ____exports.getTSTLClassName(nil, object)
     return className == "DefaultMap"
@@ -24506,6 +24483,32 @@ function ____exports.logTableDifferences(self, table1, table2)
         end
     end
 end
+function ____exports.logTableKeys(self, luaTable)
+    log(nil, "Printing out the keys of a Lua table:")
+    if not isTable(nil, luaTable) then
+        log(
+            nil,
+            ("  n/a (encountered a variable of type \"" .. __TS__TypeOf(luaTable)) .. "\" instead of a table)"
+        )
+        return
+    end
+    local numElements = 0
+    iterateTableInOrder(
+        nil,
+        luaTable,
+        function(____, key)
+            log(
+                nil,
+                tostring(key)
+            )
+            numElements = numElements + 1
+        end
+    )
+    log(
+        nil,
+        "  The size of the table was: " .. tostring(numElements)
+    )
+end
 function ____exports.logTearFlags(self, flags)
     ____exports.logFlags(nil, flags, TearFlag, "tear")
 end
@@ -27124,7 +27127,6 @@ local Feature = ____exports.Feature
 Feature.name = "Feature"
 function Feature.prototype.____constructor(self)
     self.initialized = false
-    self.exportedMethods = {}
 end
 return ____exports
  end,
@@ -30763,9 +30765,7 @@ return ____exports
  end,
 ["src.callbacks"] = function(...) 
 local ____lualib = require("lualib_bundle")
-local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local __TS__New = ____lualib.__TS__New
-local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local ____exports = {}
 local ____PostAmbushFinished = require("src.classes.callbacks.PostAmbushFinished")
 local PostAmbushFinished = ____PostAmbushFinished.PostAmbushFinished
@@ -30867,6 +30867,8 @@ local ____PreCustomRevive = require("src.classes.callbacks.PreCustomRevive")
 local PreCustomRevive = ____PreCustomRevive.PreCustomRevive
 local ____ModCallbackCustom2 = require("src.enums.ModCallbackCustom2")
 local ModCallbackCustom2 = ____ModCallbackCustom2.ModCallbackCustom2
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
 local ____utils = require("src.functions.utils")
 local newObjectWithEnumKeys = ____utils.newObjectWithEnumKeys
 local MOD_CALLBACK_CUSTOM_TO_CLASS = newObjectWithEnumKeys(nil, ModCallbackCustom2, {
@@ -30921,28 +30923,26 @@ local MOD_CALLBACK_CUSTOM_TO_CLASS = newObjectWithEnumKeys(nil, ModCallbackCusto
     [ModCallbackCustom2.PRE_CUSTOM_REVIVE] = PreCustomRevive
 })
 function ____exports.getCallbacks(self)
-    local entries = __TS__ObjectEntries(MOD_CALLBACK_CUSTOM_TO_CLASS)
-    local instantiatedClasses = __TS__ArrayMap(
-        entries,
-        function(____, ____bindingPattern0)
-            local constructor
-            local modCallbackCustom
-            modCallbackCustom = ____bindingPattern0[1]
-            constructor = ____bindingPattern0[2]
-            return {
-                modCallbackCustom,
-                __TS__New(constructor)
-            }
-        end
-    )
+    local instantiatedClasses = {}
+    for ____, modCallbackCustom in ipairs(getEnumValues(nil, ModCallbackCustom2)) do
+        local constructor = MOD_CALLBACK_CUSTOM_TO_CLASS[modCallbackCustom]
+        instantiatedClasses[modCallbackCustom] = __TS__New(constructor)
+    end
     return instantiatedClasses
 end
 return ____exports
  end,
 ["src.decorators"] = function(...) 
 local ____exports = {}
+____exports.EXPORTED_METHOD_NAMES_KEY = "__exportedMethodNames"
 function ____exports.Exported(self)
-    return function(____, _target, _propertyKey)
+    return function(____, target, propertyKey)
+        local constructor = target.constructor
+        if not (constructor[____exports.EXPORTED_METHOD_NAMES_KEY] ~= nil) then
+            constructor[____exports.EXPORTED_METHOD_NAMES_KEY] = {}
+        end
+        local exportedMethodNames = constructor[____exports.EXPORTED_METHOD_NAMES_KEY]
+        exportedMethodNames[#exportedMethodNames + 1] = propertyKey
     end
 end
 return ____exports
@@ -34847,17 +34847,25 @@ ____exports.CALLBACK_REGISTER_FUNCTIONS = {
     [ModCallbackCustom.PRE_ITEM_PICKUP] = preItemPickupRegister,
     [ModCallbackCustom.PRE_NEW_LEVEL] = preNewLevelRegister
 }
+return ____exports
+ end,
+["src.types.FunctionTuple"] = function(...) 
+local ____exports = {}
 return ____exports
  end,
 ["src.classes.ModUpgraded"] = function(...) 
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local ____exports = {}
+local getExportedMethodsFromFeature
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____callbacks = require("src.callbacks")
 local getCallbacks = ____callbacks.getCallbacks
+local ____decorators = require("src.decorators")
+local EXPORTED_METHOD_NAMES_KEY = ____decorators.EXPORTED_METHOD_NAMES_KEY
 local ____features = require("src.features")
 local getFeatures = ____features.getFeatures
 local ____exports = require("src.features.saveDataManager.exports")
@@ -34868,10 +34876,28 @@ local getTime = ____debugFunctions.getTime
 local ____log = require("src.functions.log")
 local getParentFunctionDescription = ____log.getParentFunctionDescription
 local ____tstlClass = require("src.functions.tstlClass")
-local getTSTLClassMethods = ____tstlClass.getTSTLClassMethods
+local getTSTLClassConstructor = ____tstlClass.getTSTLClassConstructor
 local getTSTLClassName = ____tstlClass.getTSTLClassName
 local ____callbackRegisterFunctions = require("src.objects.callbackRegisterFunctions")
 local CALLBACK_REGISTER_FUNCTIONS = ____callbackRegisterFunctions.CALLBACK_REGISTER_FUNCTIONS
+function getExportedMethodsFromFeature(self, featureClass)
+    local constructor = getTSTLClassConstructor(nil, featureClass)
+    local exportedMethodNames = constructor[EXPORTED_METHOD_NAMES_KEY]
+    return __TS__ArrayMap(
+        exportedMethodNames,
+        function(____, name)
+            local featureClassRecord = featureClass
+            local method = featureClassRecord[name]
+            if method == nil then
+                error("Failed to find a decorated exported method: " .. name)
+            end
+            local function wrappedMethod(____, ...)
+                return featureClassRecord[name](featureClassRecord, ...)
+            end
+            return {name, wrappedMethod}
+        end
+    )
+end
 ____exports.ModUpgraded = __TS__Class()
 local ModUpgraded = ____exports.ModUpgraded
 ModUpgraded.name = "ModUpgraded"
@@ -34947,11 +34973,6 @@ function ModUpgraded.prototype.RemoveCallbackCustom(self, modCallbackCustom, cal
         self:uninitFeature(callbackClass)
     end
 end
-function ModUpgraded.prototype.initOptionalFeature(self, feature)
-    local featureClass = self.features[feature]
-    self:initFeature(featureClass)
-    return getTSTLClassMethods(nil, featureClass)
-end
 function ModUpgraded.prototype.initFeature(self, feature)
     if feature.initialized then
         return
@@ -35022,17 +35043,52 @@ function ModUpgraded.prototype.uninitFeature(self, feature)
         saveDataManagerRemove(nil, className)
     end
 end
+function ModUpgraded.prototype.initOptionalFeature(self, feature)
+    local featureClass = self.features[feature]
+    self:initFeature(featureClass)
+    return getExportedMethodsFromFeature(nil, featureClass)
+end
 return ____exports
  end,
 ["src.classes.ModFeature"] = function(...) 
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
+local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
+local addDecoratedCallbacks, addDecoratedCallbacksCustom
+local ____tstlClass = require("src.functions.tstlClass")
+local getTSTLClassConstructor = ____tstlClass.getTSTLClassConstructor
+function addDecoratedCallbacks(self, mod, modFeatureConstructor)
+    local addCallbackArgs = modFeatureConstructor[____exports.ADD_CALLBACK_ARGS_KEY]
+    if addCallbackArgs == nil then
+        return
+    end
+    for ____, args in ipairs(addCallbackArgs) do
+        mod:AddCallback(__TS__Spread(args))
+    end
+end
+function addDecoratedCallbacksCustom(self, mod, modFeatureConstructor)
+    local addCallbackCustomArgs = modFeatureConstructor[____exports.ADD_CALLBACK_CUSTOM_ARGS_KEY]
+    if addCallbackCustomArgs == nil then
+        return
+    end
+    for ____, args in ipairs(addCallbackCustomArgs) do
+        mod:AddCallbackCustom(__TS__Spread(args))
+    end
+end
+____exports.ADD_CALLBACK_ARGS_KEY = "__addCallbackArgs"
+____exports.ADD_CALLBACK_CUSTOM_ARGS_KEY = "__addCallbackCustomArgs"
 ____exports.ModFeature = __TS__Class()
 local ModFeature = ____exports.ModFeature
 ModFeature.name = "ModFeature"
 function ModFeature.prototype.____constructor(self, mod)
-    self.mod = mod
+    local constructor = getTSTLClassConstructor(nil, self)
+    if constructor == nil then
+        error("Failed to get the TSTL class constructor for a mod feature.")
+    end
+    local modFeatureConstructor = constructor
+    addDecoratedCallbacks(nil, mod, modFeatureConstructor)
+    addDecoratedCallbacksCustom(nil, mod, modFeatureConstructor)
 end
 return ____exports
  end,
@@ -46641,14 +46697,6 @@ end
 function ____exports.loadShaderCrashFix(self, mod)
     mod:AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit)
 end
-return ____exports
- end,
-["src.types.StartsWithLowercase"] = function(...) 
-local ____exports = {}
-return ____exports
- end,
-["src.types.LowercaseKeys"] = function(...) 
-local ____exports = {}
 return ____exports
  end,
 ["src.types.UnionToIntersection"] = function(...) 
@@ -46715,9 +46763,9 @@ function ____exports.upgradeMod(self, modVanilla, features, ____debug, timeThres
     loadShaderCrashFix(nil, modVanilla)
     legacyInit(nil, mod)
     for ____, feature in ipairs(features) do
-        local tstlClassMethods = mod:initOptionalFeature(feature)
+        local exportedMethodTuples = mod:initOptionalFeature(feature)
         local modRecord = mod
-        for ____, ____value in ipairs(tstlClassMethods) do
+        for ____, ____value in ipairs(exportedMethodTuples) do
             local funcName = ____value[1]
             local func = ____value[2]
             modRecord[funcName] = func
@@ -51839,28 +51887,43 @@ return ____exports
 local ____lualib = require("lualib_bundle")
 local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
+local ____ModFeature = require("src.classes.ModFeature")
+local ADD_CALLBACK_ARGS_KEY = ____ModFeature.ADD_CALLBACK_ARGS_KEY
+local ADD_CALLBACK_CUSTOM_ARGS_KEY = ____ModFeature.ADD_CALLBACK_CUSTOM_ARGS_KEY
 function ____exports.Callback(self, modCallback, ...)
     local optionalArgs = {...}
     return function(____, target, propertyKey, _descriptor)
         local methodName = propertyKey
         local method = target[methodName]
-        target.mod:AddCallback(
+        local addCallbackArgs = {
             modCallback,
             method,
             __TS__Spread(optionalArgs)
-        )
+        }
+        local constructor = target.constructor
+        if not (constructor[ADD_CALLBACK_ARGS_KEY] ~= nil) then
+            constructor[ADD_CALLBACK_ARGS_KEY] = {}
+        end
+        local callbackTuples = constructor[ADD_CALLBACK_ARGS_KEY]
+        callbackTuples[#callbackTuples + 1] = addCallbackArgs
     end
 end
 function ____exports.CallbackCustom(self, modCallbackCustom, ...)
     local optionalArgs = {...}
-    return function(____, target, propertyKey)
+    return function(____, target, propertyKey, _descriptor)
         local methodName = propertyKey
         local method = target[methodName]
-        target.mod:AddCallbackCustom2(
+        local addCallbackArgs = {
             modCallbackCustom,
             method,
             __TS__Spread(optionalArgs)
-        )
+        }
+        local constructor = target.constructor
+        if not (constructor[ADD_CALLBACK_CUSTOM_ARGS_KEY] ~= nil) then
+            constructor[ADD_CALLBACK_CUSTOM_ARGS_KEY] = {}
+        end
+        local callbackTuples = constructor[ADD_CALLBACK_CUSTOM_ARGS_KEY]
+        callbackTuples[#callbackTuples + 1] = addCallbackArgs
     end
 end
 return ____exports
@@ -53583,6 +53646,14 @@ return ____exports
  end,
 ["src.types.HasAllEnumKeys"] = function(...) 
 local ____exports = {}
+return ____exports
+ end,
+["src.types.StartsWithLowercase"] = function(...) 
+local ____exports = {}
+return ____exports
+ end,
+["src.types.LowercaseKeys"] = function(...) 
+local ____exports = {}
 return ____exports
  end,
 ["src.types.StartsWithUppercase"] = function(...) 

package/dist/src/callbacks.d.ts

@@ -99,7 +99,7 @@ declare const MOD_CALLBACK_CUSTOM_TO_CLASS: {
     readonly 48: typeof PreCustomRevive;
 };
 export declare type ModCallbackCustomToClass = {
-    [Property in keyof typeof MOD_CALLBACK_CUSTOM_TO_CLASS]: InstanceType<typeof MOD_CALLBACK_CUSTOM_TO_CLASS[Property]>;
+    readonly [key in keyof typeof MOD_CALLBACK_CUSTOM_TO_CLASS]: InstanceType<typeof MOD_CALLBACK_CUSTOM_TO_CLASS[key]>;
 };
 export declare function getCallbacks(): ModCallbackCustomToClass;
 export {};

package/dist/src/callbacks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../src/callbacks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../src/callbacks.ts"],"names":[],"mappings":"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"}

package/dist/src/callbacks.lua

@@ -1,7 +1,5 @@
 local ____lualib = require("lualib_bundle")
-local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local __TS__New = ____lualib.__TS__New
-local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local ____exports = {}
 local ____PostAmbushFinished = require("src.classes.callbacks.PostAmbushFinished")
 local PostAmbushFinished = ____PostAmbushFinished.PostAmbushFinished
@@ -103,6 +101,8 @@ local ____PreCustomRevive = require("src.classes.callbacks.PreCustomRevive")
 local PreCustomRevive = ____PreCustomRevive.PreCustomRevive
 local ____ModCallbackCustom2 = require("src.enums.ModCallbackCustom2")
 local ModCallbackCustom2 = ____ModCallbackCustom2.ModCallbackCustom2
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
 local ____utils = require("src.functions.utils")
 local newObjectWithEnumKeys = ____utils.newObjectWithEnumKeys
 local MOD_CALLBACK_CUSTOM_TO_CLASS = newObjectWithEnumKeys(nil, ModCallbackCustom2, {
@@ -157,20 +157,11 @@ local MOD_CALLBACK_CUSTOM_TO_CLASS = newObjectWithEnumKeys(nil, ModCallbackCusto
     [ModCallbackCustom2.PRE_CUSTOM_REVIVE] = PreCustomRevive
 })
 function ____exports.getCallbacks(self)
-    local entries = __TS__ObjectEntries(MOD_CALLBACK_CUSTOM_TO_CLASS)
-    local instantiatedClasses = __TS__ArrayMap(
-        entries,
-        function(____, ____bindingPattern0)
-            local constructor
-            local modCallbackCustom
-            modCallbackCustom = ____bindingPattern0[1]
-            constructor = ____bindingPattern0[2]
-            return {
-                modCallbackCustom,
-                __TS__New(constructor)
-            }
-        end
-    )
+    local instantiatedClasses = {}
+    for ____, modCallbackCustom in ipairs(getEnumValues(nil, ModCallbackCustom2)) do
+        local constructor = MOD_CALLBACK_CUSTOM_TO_CLASS[modCallbackCustom]
+        instantiatedClasses[modCallbackCustom] = __TS__New(constructor)
+    end
     return instantiatedClasses
 end
 return ____exports

package/dist/src/classes/ModFeature.d.ts

@@ -1,11 +1,23 @@
 import { ModUpgraded } from "./ModUpgraded";
+export declare const ADD_CALLBACK_ARGS_KEY = "__addCallbackArgs";
+export declare const ADD_CALLBACK_CUSTOM_ARGS_KEY = "__addCallbackCustomArgs";
 /**
- * A helper class for a mod that wants to represent its individual features as classes. This is
- * useful if you are using decorators to represent class methods that should be automatically
- * subscribed to callbacks.
+ * A helper class for mods that wants to represent their individual features as classes. Extend your
+ * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
+ * that automatically subscribe to callbacks.
+ *
+ * For example:
+ *
+ * ```ts
+ * export class MyFeature extends ModFeature {
+ *   @Callback(ModCallback.POST_GAME_STARTED)
+ *   postGameStarted(isContinued: boolean): void {
+ *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
+ *   }
+ * }
+ * ```
  */
 export declare class ModFeature {
-    private mod;
     constructor(mod: ModUpgraded);
 }
 //# sourceMappingURL=ModFeature.d.ts.map

package/dist/src/classes/ModFeature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAc;gBAEb,GAAG,EAAE,WAAW;CAG7B"}
+{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAOtE;;;;;;;;;;;;;;;GAeG;AAEH,qBAAa,UAAU;gBACT,GAAG,EAAE,WAAW;CAU7B"}

package/dist/src/classes/ModFeature.lua

@@ -1,13 +1,55 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
+local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
---- A helper class for a mod that wants to represent its individual features as classes. This is
--- useful if you are using decorators to represent class methods that should be automatically
--- subscribed to callbacks.
+local addDecoratedCallbacks, addDecoratedCallbacksCustom
+local ____tstlClass = require("src.functions.tstlClass")
+local getTSTLClassConstructor = ____tstlClass.getTSTLClassConstructor
+function addDecoratedCallbacks(self, mod, modFeatureConstructor)
+    local addCallbackArgs = modFeatureConstructor[____exports.ADD_CALLBACK_ARGS_KEY]
+    if addCallbackArgs == nil then
+        return
+    end
+    for ____, args in ipairs(addCallbackArgs) do
+        mod:AddCallback(__TS__Spread(args))
+    end
+end
+function addDecoratedCallbacksCustom(self, mod, modFeatureConstructor)
+    local addCallbackCustomArgs = modFeatureConstructor[____exports.ADD_CALLBACK_CUSTOM_ARGS_KEY]
+    if addCallbackCustomArgs == nil then
+        return
+    end
+    for ____, args in ipairs(addCallbackCustomArgs) do
+        mod:AddCallbackCustom(__TS__Spread(args))
+    end
+end
+____exports.ADD_CALLBACK_ARGS_KEY = "__addCallbackArgs"
+____exports.ADD_CALLBACK_CUSTOM_ARGS_KEY = "__addCallbackCustomArgs"
+--- A helper class for mods that wants to represent their individual features as classes. Extend your
+-- mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
+-- that automatically subscribe to callbacks.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- export class MyFeature extends ModFeature {
+-- 
+-- @Callback (ModCallback.POST_GAME_STARTED)
+-- postGameStarted(isContinued: boolean): void {
+-- Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
+-- }
+-- }
+-- ```
 ____exports.ModFeature = __TS__Class()
 local ModFeature = ____exports.ModFeature
 ModFeature.name = "ModFeature"
 function ModFeature.prototype.____constructor(self, mod)
-    self.mod = mod
+    local constructor = getTSTLClassConstructor(nil, self)
+    if constructor == nil then
+        error("Failed to get the TSTL class constructor for a mod feature.")
+    end
+    local modFeatureConstructor = constructor
+    addDecoratedCallbacks(nil, mod, modFeatureConstructor)
+    addDecoratedCallbacksCustom(nil, mod, modFeatureConstructor)
 end
 return ____exports