isaacscript-common 6.23.0 → 7.0.0

package/dist/classes/DefaultMap.d.ts

@@ -2,7 +2,7 @@
  * A function that creates the default value for your `DefaultMap`. For example, if it was a
  * `DefaultMap` containing maps, the factory function would be: `() => new Map()`
  */
-export declare type FactoryFunction<V, Args extends unknown[]> = (...extraArgs: Args) => V;
+export declare type FactoryFunction<V, Args extends unknown[]> = (...args: Args) => V;
 /**
  * `DefaultMap` is a data structure that makes working with default values easier.
  *
@@ -95,12 +95,12 @@ export declare class DefaultMap<Key, Value, Args extends unknown[] = []> extends
      * If the key exists, this will return the same thing as the normal `Map.get` method. Otherwise,
      * it will set a default value for the provided key, and then return the default value.
      */
-    getAndSetDefault(key: Key, ...extraArgs: Args): Value;
+    getAndSetDefault(key: Key, ...args: Args): Value;
     /**
      * 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): Value;
+    getDefaultValue(...args: Args): Value;
     /**
      * Helper method for cloning the map. Returns either the default value or a reference to the
      * factory function.

package/dist/classes/DefaultMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultMap.d.ts","sourceRoot":"","sources":["../../src/classes/DefaultMap.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,oBAAY,eAAe,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,IAAI,CACvD,GAAG,SAAS,EAAE,IAAI,KACf,CAAC,CAAC;AAEP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,qBAAa,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,CAAE,SAAQ,GAAG,CAC1E,GAAG,EACH,KAAK,CACN;IACC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,mBAAmB,CAA2C;IAEtE;;;OAGG;gBAED,6BAA6B,EAAE,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,EACnE,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAqB3C;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,IAAI,GAAG,KAAK;IAWrD;;;OAGG;IACH,eAAe,CAAC,GAAG,SAAS,EAAE,IAAI,GAAG,KAAK;IAY1C;;;OAGG;IACH,iBAAiB,IAAI,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC;CAW1D"}
+{"version":3,"file":"DefaultMap.d.ts","sourceRoot":"","sources":["../../src/classes/DefaultMap.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,oBAAY,eAAe,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,qBAAa,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,CAAE,SAAQ,GAAG,CAC1E,GAAG,EACH,KAAK,CACN;IACC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,mBAAmB,CAA2C;IAEtE;;;OAGG;gBAED,6BAA6B,EAAE,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,EACnE,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAqB3C;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK;IAWhD;;;OAGG;IACH,eAAe,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK;IAYrC;;;OAGG;IACH,iBAAiB,IAAI,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC;CAW1D"}

package/dist/classes/DefaultMap.lua

@@ -3,6 +3,7 @@ local __TS__Class = ____lualib.__TS__Class
 local Map = ____lualib.Map
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local __TS__TypeOf = ____lualib.__TS__TypeOf
+local __TS__New = ____lualib.__TS__New
 local ____exports = {}
 local ____types = require("functions.types")
 local isFunction = ____types.isFunction
@@ -131,4 +132,40 @@ function DefaultMap.prototype.getConstructorArg(self)
     end
     error("A DefaultMap was incorrectly instantiated.")
 end
+local function test(self)
+    local myDefaultMapBoolean = __TS__New(____exports.DefaultMap, false)
+    local myDefaultMapBooleanFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return false end
+    )
+    local myDefaultMapBooleanWithoutParams = __TS__New(____exports.DefaultMap, false)
+    local myDefaultMapNumber = __TS__New(____exports.DefaultMap, 123)
+    local myDefaultMapNumberFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return 123 end
+    )
+    local myDefaultMapNumberWithoutParams = __TS__New(____exports.DefaultMap, 123)
+    local myDefaultMapString = __TS__New(____exports.DefaultMap, "foo")
+    local myDefaultMapStringFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return "foo" end
+    )
+    local myDefaultMapStringWithoutParams = __TS__New(____exports.DefaultMap, "foo")
+    local myDefaultMapArray = __TS__New(
+        ____exports.DefaultMap,
+        function() return {} end
+    )
+    local myDefaultMapArrayWithoutParams = __TS__New(
+        ____exports.DefaultMap,
+        function() return {} end
+    )
+    local myDefaultMapMap = __TS__New(
+        ____exports.DefaultMap,
+        function() return __TS__New(Map) end
+    )
+    local myDefaultMapMapWithoutParams = __TS__New(
+        ____exports.DefaultMap,
+        function() return __TS__New(Map) end
+    )
+end
 return ____exports

package/dist/features/disableInputs.d.ts

@@ -39,7 +39,7 @@ export declare function enableAllInputsExceptFor(key: string, blacklist: Set<But
  *            that multiple mod features can work in tandem.
  * @param whitelist A set of ButtonActions to allow.
  */
-export declare function disableAllInputsExceptFor(key: string, whitelist: Set<ButtonAction>): void;
+export declare function disableAllInputsExceptFor(key: string, whitelist: Set<ButtonAction> | ReadonlySet<ButtonAction>): void;
 /**
  * Helper function to disable only the inputs used for moving the character (or moving the cursor in
  * the UI). This is useful because `EntityPlayer.ControlsEnabled` can be changed by the game under

package/dist/features/disableInputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disableInputs.d.ts","sourceRoot":"","sources":["../../src/features/disableInputs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAuBtC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAoBhD;AA+CD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,GACvD,IAAI,CAKN;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAC3B,IAAI,CAKN;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGvD"}
+{"version":3,"file":"disableInputs.d.ts","sourceRoot":"","sources":["../../src/features/disableInputs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAiBtC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAoBhD;AA+CD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,GACvD,IAAI,CAKN;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,GACvD,IAAI,CAKN;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGvD"}

package/dist/features/runInNFrames.lua

@@ -60,12 +60,7 @@ end
 local FEATURE_NAME = "runInNFrames"
 v = {run = {queuedGameFunctionTuples = {}, queuedRenderFunctionTuples = {}, intervalGameFunctionTuples = {}, intervalRenderFunctionTuples = {}}}
 function ____exports.runInNFramesInit(self, mod)
-    saveDataManager(
-        nil,
-        FEATURE_NAME,
-        v,
-        function() return false end
-    )
+    saveDataManager(nil, FEATURE_NAME, v, false)
     mod:AddCallback(ModCallback.POST_UPDATE, postUpdate)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
 end

package/dist/features/runNextRoom.lua

@@ -17,12 +17,7 @@ end
 local FEATURE_NAME = "runNextRoom"
 v = {run = {queuedFunctions = {}}}
 function ____exports.runNextRoomInit(self, mod)
-    saveDataManager(
-        nil,
-        FEATURE_NAME,
-        v,
-        function() return false end
-    )
+    saveDataManager(nil, FEATURE_NAME, v, false)
     mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
 end
 --- Supply a function to run on the next `POST_NEW_ROOM` callback.

package/dist/features/saveDataManager/exports.d.ts

@@ -92,7 +92,7 @@ import { SaveData } from "../../interfaces/SaveData";
 export declare function saveDataManager<Persistent, Run, Level>(key: string, // This is the overload for the standard case with serializable data.
 v: SaveData<Persistent, Run, Level>, conditionalFunc?: () => boolean): void;
 export declare function saveDataManager(key: string, // This is the overload for the case when saving data is disabled.
-v: SaveData<unknown, unknown, unknown>, conditionalFunc: false): void;
+v: SaveData, conditionalFunc: false): void;
 /**
  * The save data manager will automatically load variables from disk at the appropriate times (i.e.
  * when a new run is started). Use this function to explicitly force the save data manager to load

package/dist/features/saveDataManager/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/saveDataManager/exports.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EACpD,GAAG,EAAE,MAAM,EAAE,qEAAqE;AAClF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI,CAAC;AACR,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,kEAAkE;AAC/E,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EACtC,eAAe,EAAE,KAAK,GACrB,IAAI,CAAC;AA+CR;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAQD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GACrB,IAAI,CAiBN"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/saveDataManager/exports.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EACpD,GAAG,EAAE,MAAM,EAAE,qEAAqE;AAClF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI,CAAC;AACR,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,kEAAkE;AAC/E,CAAC,EAAE,QAAQ,EACX,eAAe,EAAE,KAAK,GACrB,IAAI,CAAC;AA+CR;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAQD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GACrB,IAAI,CAiBN"}

package/dist/functions/deepCopy.lua

@@ -210,7 +210,7 @@ function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescri
     local constructorArg = ____isDefaultMap_result_0
     if serializationType == SerializationType.SERIALIZE and not isPrimitive(nil, constructorArg) then
         if insideMap then
-            error("Failed to deep copy a DefaultMap because it was instantiated with a factory function and was also inside of another map. You cannot use a nested DefaultMap in this way because factory functions are not serializable. (In other words, there is no way to copy the function that you are using for the DefaultMap into the \"save#.dat\" file.) Instead, refactor your data structure so that the DefaultMap is not nested.")
+            error("Failed to deep copy a DefaultMap because it was instantiated with a factory function and was also inside of an array, map, or set. For more information, see: https://isaacscript.github.io/main/gotchas#failed-to-deep-copy-a-defaultmap")
         else
             return deepCopyMap(
                 nil,

package/dist/interfaces/SaveData.d.ts

@@ -3,7 +3,6 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
-import { AnyClass } from "../types";
 /**
  * This is the format of the object that you give to the save data manager. It will contains all of
  * the variables for the particular mod feature.
@@ -43,17 +42,28 @@ export interface SaveData<Persistent = unknown, Run = unknown, Level = unknown>
  * The recursive nature of this type is based on the `Immutable` type:
  * https://stackoverflow.com/questions/41879327/deepreadonly-object-typescript
  */
-declare type Serializable<T> = T extends SerializableIsaacAPIClass ? T : T extends IsaacAPIClass ? IsaacAPIClassIsNotSerializable : T extends SerializablePrimitive ? T : T extends Array<infer U> ? SerializableArray<U> : T extends Map<infer K, infer V> ? SerializableMap<K, V> : T extends Set<infer M> ? SerializableSet<M> : SerializableObject<T>;
-declare type SerializableInsideArrayOrMap<T> = T extends AnyClass ? CustomClassIsNotSerializable : Serializable<T>;
+declare type Serializable<T> = T extends SerializablePrimitive ? T : T extends SerializableIsaacAPIClass ? T : T extends IsaacAPIClass ? ErrorIsaacAPIClassIsNotSerializable : T extends Array<infer U> ? SerializableArray<U> : T extends ReadonlyArray<infer U> ? SerializableReadonlyArray<U> : T extends Map<infer K, infer V> ? SerializableMap<K, V> : T extends ReadonlyMap<infer K, infer V> ? SerializableReadonlyMap<K, V> : T extends Set<infer V> ? SerializableSet<V> : T extends ReadonlySet<infer V> ? SerializableReadonlySet<V> : SerializableObject<T>;
+/**
+ * This is mostly copied from the `Serializable` type. The difference is that we want to disallow
+ * classes with methods.
+ */
+declare type SerializableInsideArrayOrMap<T> = T extends SerializablePrimitive ? T : T extends SerializableIsaacAPIClass ? T : T extends IsaacAPIClass ? ErrorIsaacAPIClassIsNotSerializable : T extends Array<infer U> ? SerializableArray<U> : T extends ReadonlyArray<infer U> ? SerializableReadonlyArray<U> : T extends Map<infer K, infer V> ? SerializableMap<K, V> : T extends ReadonlyMap<infer K, infer V> ? SerializableReadonlyMap<K, V> : T extends Set<infer V> ? SerializableSet<V> : T extends ReadonlySet<infer V> ? SerializableReadonlySet<V> : T extends HasMethods<T> ? ErrorCustomClassNotSerializable : T extends Function ? FunctionIsNotSerializable : SerializableObject<T>;
 declare type SerializablePrimitive = boolean | string | number | undefined | null;
 declare type SerializableArray<T> = Array<SerializableInsideArrayOrMap<T>>;
+declare type SerializableReadonlyArray<T> = ReadonlyArray<SerializableInsideArrayOrMap<T>>;
 declare type SerializableMap<K, V> = Map<SerializableInsideArrayOrMap<K>, SerializableInsideArrayOrMap<V>>;
+declare type SerializableReadonlyMap<K, V> = ReadonlyMap<SerializableInsideArrayOrMap<K>, SerializableInsideArrayOrMap<V>>;
 declare type SerializableSet<T> = Set<SerializableInsideArrayOrMap<T>>;
+declare type SerializableReadonlySet<T> = ReadonlySet<SerializableInsideArrayOrMap<T>>;
 declare type SerializableObject<T> = {
     [K in keyof T]: Serializable<T[K]>;
 };
 declare type SerializableIsaacAPIClass = Color | KColor | RNG | Vector;
-declare type IsaacAPIClassIsNotSerializable = "Error: Isaac API classes (such as e.g. `Entity` or `RoomConfig`) are not serializable. For more information, see: https://isaacscript.github.io/main/gotchas#isaac-api-classes-are-not-serializable";
-declare type CustomClassIsNotSerializable = 'Error: The "DefaultMap" class and other custom classes are not serializable when they are placed inside of an array, map, or set. For more information, see: https://isaacscript.github.io/main/gotchas#defaultmap-and-other-custom-classes-are-not-serializable';
+declare type HasMethods<T> = {} extends {
+    [K in keyof T as T[K] extends Function ? K : never]-?: 1;
+} ? never : T;
+declare type FunctionIsNotSerializable = "Error: Functions are not serializable. For more information, see: https://isaacscript.github.io/main/gotchas#functions-are-not-serializable";
+declare type ErrorIsaacAPIClassIsNotSerializable = "Error: Isaac API classes (such as e.g. `Entity` or `RoomConfig`) are not serializable. For more information, see: https://isaacscript.github.io/main/gotchas#isaac-api-classes-are-not-serializable";
+declare type ErrorCustomClassNotSerializable = "Error: Custom classes with one or more methods are not serializable when inside of an array, map, or set. For more information, see: https://isaacscript.github.io/main/gotchas#custom-classes-are-not-serializable";
 export {};
 //# sourceMappingURL=SaveData.d.ts.map

package/dist/interfaces/SaveData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SaveData.d.ts","sourceRoot":"","sources":["../../src/interfaces/SaveData.ts"],"names":[],"mappings":";;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,QAAQ,CACvB,UAAU,GAAG,OAAO,EACpB,GAAG,GAAG,OAAO,EACb,KAAK,GAAG,OAAO;IAEf,UAAU,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,aAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,yBAAyB,GACtD,CAAC,GACD,CAAC,SAAS,aAAa,GACvB,8BAA8B,GAC9B,CAAC,SAAS,qBAAqB,GAC/B,CAAC,GACD,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACxB,iBAAiB,CAAC,CAAC,CAAC,GACpB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC/B,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GACrB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACtB,eAAe,CAAC,CAAC,CAAC,GAClB,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAE1B,aAAK,4BAA4B,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,GACrD,4BAA4B,GAC5B,YAAY,CAAC,CAAC,CAAC,CAAC;AAEpB,aAAK,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;AAC1E,aAAK,iBAAiB,CAAC,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,aAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAC9B,4BAA4B,CAAC,CAAC,CAAC,EAC/B,4BAA4B,CAAC,CAAC,CAAC,CAChC,CAAC;AACF,aAAK,eAAe,CAAC,CAAC,IAAI,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,aAAK,kBAAkB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AACpE,aAAK,yBAAyB,GAAG,KAAK,GAAG,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC;AAE/D,aAAK,8BAA8B,GACjC,qMAAqM,CAAC;AAExM,aAAK,4BAA4B,GAC/B,kQAAkQ,CAAC"}
+{"version":3,"file":"SaveData.d.ts","sourceRoot":"","sources":["../../src/interfaces/SaveData.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/SaveData.lua

@@ -1,2 +1,68 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__Class = ____lualib.__TS__Class
 local ____exports = {}
+local function test(self, _saveData)
+end
+do
+    local saveDataWithPrimitives = {run = {foo = 123, bar = "bar", baz = true, nested = {foo = 123, bar = "bar", baz = true}}}
+    test(nil, saveDataWithPrimitives)
+end
+do
+    local saveDataWithEntity = {run = {foo = {}}}
+    test(nil, saveDataWithEntity)
+end
+do
+    local saveDataWithMap = {run = {foo = __TS__New(Map)}}
+    test(nil, saveDataWithMap)
+end
+do
+    local saveDataWithMap = {run = {foo = __TS__New(Map)}}
+    test(nil, saveDataWithMap)
+end
+do
+    local saveDataWithMap = {run = {foo = __TS__New(Map)}}
+    test(nil, saveDataWithMap)
+end
+do
+    local Foo = __TS__Class()
+    Foo.name = "Foo"
+    function Foo.prototype.____constructor(self)
+        self.someField = 123
+    end
+    local saveDataWithClass = {run = {foo = __TS__New(Foo)}}
+    test(nil, saveDataWithClass)
+end
+do
+    local Foo = __TS__Class()
+    Foo.name = "Foo"
+    function Foo.prototype.____constructor(self)
+        self.someField = 123
+    end
+    function Foo.prototype.someMethod(self)
+    end
+    local saveDataWithClassWithMethod = {run = {foo = __TS__New(Foo)}}
+    test(nil, saveDataWithClassWithMethod)
+end
+do
+    local Foo = __TS__Class()
+    Foo.name = "Foo"
+    function Foo.prototype.____constructor(self)
+        self.someField = 123
+    end
+    local saveDataWithNestedClass = {run = {fooMap = __TS__New(Map)}}
+    test(nil, saveDataWithNestedClass)
+end
+do
+    local Foo = __TS__Class()
+    Foo.name = "Foo"
+    function Foo.prototype.____constructor(self)
+        self.someField = 123
+    end
+    function Foo.prototype.someMethod(self)
+    end
+    local saveDataWithNestedClass = {run = {fooMap = __TS__New(Map)}}
+    test(nil, saveDataWithNestedClass)
+end
 return ____exports

package/dist/types/index.d.ts

@@ -1,4 +1,3 @@
-export * from "./AnyClass";
 export * from "./AnyEntity";
 export * from "./AnyGridEntity";
 export * from "./CollectibleIndex";

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "6.23.0",
+  "version": "7.0.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/classes/DefaultMap.ts

@@ -5,9 +5,7 @@ import { isFunction, isPrimitive } from "../functions/types";
  * A function that creates the default value for your `DefaultMap`. For example, if it was a
  * `DefaultMap` containing maps, the factory function would be: `() => new Map()`
  */
-export type FactoryFunction<V, Args extends unknown[]> = (
-  ...extraArgs: Args
-) => V;
+export type FactoryFunction<V, Args extends unknown[]> = (...args: Args) => V;
 
 /**
  * `DefaultMap` is a data structure that makes working with default values easier.
@@ -127,13 +125,13 @@ export class DefaultMap<Key, Value, Args extends unknown[] = []> extends Map<
    * If the key exists, this will return the same thing as the normal `Map.get` method. Otherwise,
    * it will set a default value for the provided key, and then return the default value.
    */
-  getAndSetDefault(key: Key, ...extraArgs: Args): Value {
+  getAndSetDefault(key: Key, ...args: Args): Value {
     const value = super.get(key);
     if (value !== undefined) {
       return value;
     }
 
-    const defaultValue = this.getDefaultValue(...extraArgs);
+    const defaultValue = this.getDefaultValue(...args);
     this.set(key, defaultValue);
     return defaultValue;
   }
@@ -142,13 +140,13 @@ export class DefaultMap<Key, Value, Args extends unknown[] = []> extends Map<
    * 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): Value {
+  getDefaultValue(...args: Args): Value {
     if (this.defaultValue !== undefined) {
       return this.defaultValue;
     }
 
     if (this.defaultValueFactory !== undefined) {
-      return this.defaultValueFactory(...extraArgs);
+      return this.defaultValueFactory(...args);
     }
 
     error("A DefaultMap was incorrectly instantiated.");
@@ -170,3 +168,34 @@ export class DefaultMap<Key, Value, Args extends unknown[] = []> extends Map<
     error("A DefaultMap was incorrectly instantiated.");
   }
 }
+
+/* eslint-disable @typescript-eslint/no-unused-vars */
+function test() {
+  // Boolean
+  const myDefaultMapBoolean = new DefaultMap<string, boolean>(false);
+  const myDefaultMapBooleanFactory = new DefaultMap<string, boolean>(
+    () => false,
+  );
+  const myDefaultMapBooleanWithoutParams = new DefaultMap(false);
+
+  // Number
+  const myDefaultMapNumber = new DefaultMap<string, number>(123);
+  const myDefaultMapNumberFactory = new DefaultMap<string, number>(() => 123);
+  const myDefaultMapNumberWithoutParams = new DefaultMap(123);
+
+  // String
+  const myDefaultMapString = new DefaultMap<string, string>("foo");
+  const myDefaultMapStringFactory = new DefaultMap<string, string>(() => "foo");
+  const myDefaultMapStringWithoutParams = new DefaultMap("foo");
+
+  // Array
+  const myDefaultMapArray = new DefaultMap<string, string[]>(() => []);
+  const myDefaultMapArrayWithoutParams = new DefaultMap(() => []);
+
+  // Map
+  const myDefaultMapMap = new DefaultMap<string, Map<string, string>>(
+    () => new Map(),
+  );
+  const myDefaultMapMapWithoutParams = new DefaultMap(() => new Map());
+}
+/* eslint-enable @typescript-eslint/no-unused-vars */

package/src/features/disableInputs.ts

@@ -12,16 +12,10 @@ const FEATURE_NAME = "disableInputs";
 const v = {
   run: {
     /** Indexed by the requesting feature key. */
-    disableInputsWithWhitelistMap: new Map<
-      string,
-      Set<ButtonAction> | ReadonlySet<ButtonAction>
-    >(),
+    disableInputsWithWhitelistMap: new Map<string, ReadonlySet<ButtonAction>>(),
 
     /** Indexed by the requesting feature key. */
-    enableInputsWithBlacklistMap: new Map<
-      string,
-      Set<ButtonAction> | ReadonlySet<ButtonAction>
-    >(),
+    enableInputsWithBlacklistMap: new Map<string, ReadonlySet<ButtonAction>>(),
   },
 };
 
@@ -154,7 +148,7 @@ export function enableAllInputsExceptFor(
  */
 export function disableAllInputsExceptFor(
   key: string,
-  whitelist: Set<ButtonAction>,
+  whitelist: Set<ButtonAction> | ReadonlySet<ButtonAction>,
 ): void {
   errorIfFeaturesNotInitialized(FEATURE_NAME);
 

package/src/features/runInNFrames.ts

@@ -31,7 +31,7 @@ const v = {
 };
 
 export function runInNFramesInit(mod: Mod): void {
-  saveDataManager(FEATURE_NAME, v, () => false); // Functions are not serializable.
+  saveDataManager(FEATURE_NAME, v, false); // Functions are not serializable.
 
   mod.AddCallback(ModCallback.POST_UPDATE, postUpdate); // 1
   mod.AddCallback(ModCallback.POST_RENDER, postRender); // 2

package/src/features/runNextRoom.ts

@@ -13,7 +13,7 @@ const v = {
 };
 
 export function runNextRoomInit(mod: ModUpgraded): void {
-  saveDataManager(FEATURE_NAME, v, () => false); // Functions are not serializable.
+  saveDataManager(FEATURE_NAME, v, false); // Functions are not serializable.
 
   mod.AddCallbackCustom(
     ModCallbackCustom.POST_NEW_ROOM_REORDERED,

package/src/features/saveDataManager/exports.ts

@@ -113,7 +113,7 @@ export function saveDataManager<Persistent, Run, Level>(
 ): void;
 export function saveDataManager(
   key: string, // This is the overload for the case when saving data is disabled.
-  v: SaveData<unknown, unknown, unknown>,
+  v: SaveData,
   conditionalFunc: false,
 ): void;
 export function saveDataManager<Persistent, Run, Level>(

package/src/functions/deepCopy.ts

@@ -233,7 +233,7 @@ function deepCopyDefaultMap(
       // throw a run-time error to immediately alert the end-user that their data structure is
       // invalid.
       error(
-        'Failed to deep copy a DefaultMap because it was instantiated with a factory function and was also inside of another map. You cannot use a nested DefaultMap in this way because factory functions are not serializable. (In other words, there is no way to copy the function that you are using for the DefaultMap into the "save#.dat" file.) Instead, refactor your data structure so that the DefaultMap is not nested.',
+        "Failed to deep copy a DefaultMap because it was instantiated with a factory function and was also inside of an array, map, or set. For more information, see: https://isaacscript.github.io/main/gotchas#failed-to-deep-copy-a-defaultmap",
       );
     } else {
       // In most cases, the DefaultMap will be attached to a normal table element. In this case, if

package/src/interfaces/SaveData.ts

@@ -1,4 +1,4 @@
-import { AnyClass } from "../types";
+/* eslint-disable max-classes-per-file */
 
 /**
  * This is the format of the object that you give to the save data manager. It will contains all of
@@ -44,36 +44,238 @@ export interface SaveData<
  * The recursive nature of this type is based on the `Immutable` type:
  * https://stackoverflow.com/questions/41879327/deepreadonly-object-typescript
  */
-type Serializable<T> = T extends SerializableIsaacAPIClass
-  ? T
-  : T extends IsaacAPIClass
-  ? IsaacAPIClassIsNotSerializable
-  : T extends SerializablePrimitive
-  ? T
-  : T extends Array<infer U>
-  ? SerializableArray<U>
-  : T extends Map<infer K, infer V>
-  ? SerializableMap<K, V>
-  : T extends Set<infer M>
-  ? SerializableSet<M>
-  : SerializableObject<T>;
-
-type SerializableInsideArrayOrMap<T> = T extends AnyClass
-  ? CustomClassIsNotSerializable
-  : Serializable<T>;
+type Serializable<T> =
+  // Allow the trivial case of primitives.
+  T extends SerializablePrimitive
+    ? T
+    : // Allow a specific subset of Isaac API classes that are copyable / serializable.
+    T extends SerializableIsaacAPIClass
+    ? T
+    : // Disallow all other Isaac API classes.
+    T extends IsaacAPIClass
+    ? ErrorIsaacAPIClassIsNotSerializable
+    : // Allow some specific "container" objects.
+    // These container objects are explicitly handled by the save data manager, but there are
+    // restrictions on the things inside of them.
+    T extends Array<infer U>
+    ? SerializableArray<U>
+    : T extends ReadonlyArray<infer U>
+    ? SerializableReadonlyArray<U>
+    : T extends Map<infer K, infer V>
+    ? SerializableMap<K, V>
+    : T extends ReadonlyMap<infer K, infer V>
+    ? SerializableReadonlyMap<K, V>
+    : T extends Set<infer V>
+    ? SerializableSet<V>
+    : T extends ReadonlySet<infer V>
+    ? SerializableReadonlySet<V>
+    : // Allow any other object, as long as the values are themselves serializable.
+      SerializableObject<T>;
+
+/**
+ * This is mostly copied from the `Serializable` type. The difference is that we want to disallow
+ * classes with methods.
+ */
+type SerializableInsideArrayOrMap<T> =
+  // Allow the trivial case of primitives.
+  T extends SerializablePrimitive
+    ? T
+    : // Allow a specific subset of Isaac API classes that are copyable / serializable.
+    T extends SerializableIsaacAPIClass
+    ? T
+    : // Disallow all other Isaac API classes.
+    T extends IsaacAPIClass
+    ? ErrorIsaacAPIClassIsNotSerializable
+    : // Allow some specific "container" objects.
+    // These container objects are explicitly handled by the save data manager, but there are
+    // restrictions on the things inside of them.
+    T extends Array<infer U>
+    ? SerializableArray<U>
+    : T extends ReadonlyArray<infer U>
+    ? SerializableReadonlyArray<U>
+    : T extends Map<infer K, infer V>
+    ? SerializableMap<K, V>
+    : T extends ReadonlyMap<infer K, infer V>
+    ? SerializableReadonlyMap<K, V>
+    : T extends Set<infer V>
+    ? SerializableSet<V>
+    : T extends ReadonlySet<infer V>
+    ? SerializableReadonlySet<V>
+    : // Disallow objects with functions on them (i.e. classes with methods).
+    // (This has to be after allowing maps and sets, because those have functions inside of them.)
+    T extends HasMethods<T>
+    ? ErrorCustomClassNotSerializable
+    : // Disallow functions.
+    // (We can only disallow functions when inside of containers, because we want to allow classes
+    // with methods attached to normal objects.)
+    T extends Function // eslint-disable-line @typescript-eslint/ban-types
+    ? FunctionIsNotSerializable
+    : // Finally, allow any other object, as long as the values are themselves serializable.
+      SerializableObject<T>;
 
 type SerializablePrimitive = boolean | string | number | undefined | null;
 type SerializableArray<T> = Array<SerializableInsideArrayOrMap<T>>;
+type SerializableReadonlyArray<T> = ReadonlyArray<
+  SerializableInsideArrayOrMap<T>
+>;
 type SerializableMap<K, V> = Map<
   SerializableInsideArrayOrMap<K>,
   SerializableInsideArrayOrMap<V>
 >;
+type SerializableReadonlyMap<K, V> = ReadonlyMap<
+  SerializableInsideArrayOrMap<K>,
+  SerializableInsideArrayOrMap<V>
+>;
 type SerializableSet<T> = Set<SerializableInsideArrayOrMap<T>>;
+type SerializableReadonlySet<T> = ReadonlySet<SerializableInsideArrayOrMap<T>>;
 type SerializableObject<T> = { [K in keyof T]: Serializable<T[K]> };
 type SerializableIsaacAPIClass = Color | KColor | RNG | Vector;
 
-type IsaacAPIClassIsNotSerializable =
+// eslint-disable-next-line @typescript-eslint/ban-types
+type HasMethods<T> = {} extends {
+  // eslint-disable-next-line @typescript-eslint/ban-types
+  [K in keyof T as T[K] extends Function ? K : never]-?: 1;
+}
+  ? never
+  : T;
+
+type FunctionIsNotSerializable =
+  "Error: Functions are not serializable. For more information, see: https://isaacscript.github.io/main/gotchas#functions-are-not-serializable";
+
+type ErrorIsaacAPIClassIsNotSerializable =
   "Error: Isaac API classes (such as e.g. `Entity` or `RoomConfig`) are not serializable. For more information, see: https://isaacscript.github.io/main/gotchas#isaac-api-classes-are-not-serializable";
 
-type CustomClassIsNotSerializable =
-  'Error: The "DefaultMap" class and other custom classes are not serializable when they are placed inside of an array, map, or set. For more information, see: https://isaacscript.github.io/main/gotchas#defaultmap-and-other-custom-classes-are-not-serializable';
+type ErrorCustomClassNotSerializable =
+  "Error: Custom classes with one or more methods are not serializable when inside of an array, map, or set. For more information, see: https://isaacscript.github.io/main/gotchas#custom-classes-are-not-serializable";
+
+// -----
+// Tests
+// -----
+
+function test<Persistent, Run, Level>(
+  _saveData: SaveData<Persistent, Run, Level>,
+) {}
+
+{
+  const saveDataWithPrimitives = {
+    run: {
+      foo: 123,
+      bar: "bar",
+      baz: true,
+      nested: {
+        foo: 123,
+        bar: "bar",
+        baz: true,
+      },
+    },
+  };
+
+  // Primitives and nested primitives are allowed.
+  test(saveDataWithPrimitives);
+}
+
+{
+  const saveDataWithEntity = {
+    run: {
+      foo: {} as Entity,
+    },
+  };
+
+  // @ts-expect-error Isaac API classes are not serializable.
+  test(saveDataWithEntity);
+}
+
+{
+  const saveDataWithMap = {
+    run: {
+      foo: new Map<string, string>(),
+    },
+  };
+
+  // Maps with primitive values are allowed.
+  test(saveDataWithMap);
+}
+
+{
+  const saveDataWithMap = {
+    run: {
+      foo: new Map<string, () => void>(),
+    },
+  };
+
+  // @ts-expect-error Maps with function values are not serializable.
+  test(saveDataWithMap);
+}
+
+{
+  const saveDataWithMap = {
+    run: {
+      foo: new Map<string, Map<string, string>>(),
+    },
+  };
+
+  // Nested maps are allowed.
+  test(saveDataWithMap);
+}
+
+{
+  class Foo {
+    someField = 123;
+  }
+
+  const saveDataWithClass = {
+    run: {
+      foo: new Foo(),
+    },
+  };
+
+  // Custom classes without methods are allowed.
+  test(saveDataWithClass);
+}
+
+{
+  class Foo {
+    someField = 123;
+    someMethod() {} // eslint-disable-line class-methods-use-this
+  }
+
+  const saveDataWithClassWithMethod = {
+    run: {
+      foo: new Foo(),
+    },
+  };
+
+  // Custom classes with methods are allowed.
+  test(saveDataWithClassWithMethod);
+}
+
+{
+  class Foo {
+    someField = 123;
+  }
+
+  const saveDataWithNestedClass = {
+    run: {
+      fooMap: new Map<string, Foo>(),
+    },
+  };
+
+  // Nested custom classes without methods are allowed.
+  test(saveDataWithNestedClass);
+}
+
+{
+  class Foo {
+    someField = 123;
+    someMethod() {} // eslint-disable-line class-methods-use-this
+  }
+
+  const saveDataWithNestedClass = {
+    run: {
+      fooMap: new Map<string, Foo>(),
+    },
+  };
+
+  // @ts-expect-error Nested custom classes with methods are not serializable.
+  test(saveDataWithNestedClass);
+}

package/src/types/index.ts

@@ -1,4 +1,3 @@
-export * from "./AnyClass";
 export * from "./AnyEntity";
 export * from "./AnyGridEntity";
 export * from "./CollectibleIndex";

package/src/types/indexTypeDoc.ts

@@ -1,4 +1,3 @@
-export * as AnyClass from "./AnyClass";
 export * as AnyEntity from "./AnyEntity";
 export * as AnyGridEntity from "./AnyGridEntity";
 export * as CollectibleIndex from "./CollectibleIndex";

package/dist/types/AnyClass.d.ts

@@ -1,2 +0,0 @@
-export declare type AnyClass = new (...args: readonly unknown[]) => unknown;
-//# sourceMappingURL=AnyClass.d.ts.map

package/dist/types/AnyClass.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AnyClass.d.ts","sourceRoot":"","sources":["../../src/types/AnyClass.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ,GAAG,KAAK,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,CAAC"}

package/dist/types/AnyClass.lua

@@ -1,2 +0,0 @@
-local ____exports = {}
-return ____exports

package/src/types/AnyClass.ts

@@ -1 +0,0 @@
-export type AnyClass = new (...args: readonly unknown[]) => unknown;