isaacscript-common 30.11.9 → 30.12.1

package/dist/index.rollup.d.ts

@@ -3342,6 +3342,32 @@ export declare class DefaultMap<Key, Value, Args extends unknown[] = []> extends
  */
 export declare function defaultMapGetHash<V, A extends unknown[]>(map: DefaultMap<PtrHash, V, A>, entity: Entity, ...extraArgs: A): V;
 
+/**
+ * Helper function to make using default maps with an index of `PtrHash` easier. Use this instead of
+ * the `DefaultMap.getAndSetDefault` method if you have a default map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new DefaultMap<PtrHash, int>(0),
+ *   },
+ * };
+ *
+ * function npcUpdate(npc: EntityNPC) {
+ *   const speedBoost = defaultMapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   // Do something with the speed boost.
+ * }
+ * ```
+ *
+ * Note that not all NPCs should be stored in a map with a `PtrHash` as an index, so only use this
+ * in the situations where that would be okay. (For example, Dark Esau should never be stored in a
+ * map like this, because the scope of `PtrHash` is per room and Dark Esau is persistent between
+ * rooms.)
+ */
+export declare function defaultMapGetNPC<V, Args extends unknown[]>(map: DefaultMap<PtrHash, V, Args>, npc: EntityNPC, ...extraArgs: Args): V;
+
 /**
  * Helper function to make using default maps with an index of `PlayerIndex` easier. Use this
  * instead of the `DefaultMap.getAndSetDefault` method if you have a default map of this type.
@@ -3360,7 +3386,7 @@ export declare function defaultMapGetHash<V, A extends unknown[]>(map: DefaultMa
  * }
  * ```
  */
-export declare function defaultMapGetPlayer<V, A extends unknown[]>(map: DefaultMap<PlayerIndex, V, A>, player: EntityPlayer, ...extraArgs: A): V;
+export declare function defaultMapGetPlayer<V, Args extends unknown[]>(map: DefaultMap<PlayerIndex, V, Args>, player: EntityPlayer, ...extraArgs: Args): V;
 
 /**
  * Helper function to set a value for a `DefaultMap` that corresponds to an entity, assuming that
@@ -3371,6 +3397,15 @@ export declare function defaultMapGetPlayer<V, A extends unknown[]>(map: Default
  */
 export declare function defaultMapSetHash<V>(map: Map<PtrHash, V>, entity: Entity, value: V): void;
 
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * Since `Map` and `DefaultMap` set values in the same way, this function is simply an alias for the
+ * `mapSetNPC` helper function.
+ */
+export declare function defaultMapSetNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC, value: V): void;
+
 /**
  * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
  * `Map.set` method if you have a map of this type.
@@ -9298,12 +9333,40 @@ export declare type LowercaseKeys<T> = StartsWithLowercase<keyof T>;
  */
 export declare function map<T, U>(array: T[], func: (value: T, index: number, array: T[]) => U): U[];
 
+/**
+ * Helper function to make using maps with an type of `PtrHash` easier. Use this instead of the
+ * `Map.delete` method if you have a set of this type.
+ */
+export declare function mapDeleteNPC(map: Map<PtrHash, unknown>, npc: EntityNPC): boolean;
+
 /**
  * Helper function to make using maps with an type of `PlayerIndex` easier. Use this instead of the
  * `Map.delete` method if you have a set of this type.
  */
 export declare function mapDeletePlayer(map: Map<PlayerIndex, unknown>, player: EntityPlayer): boolean;
 
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.get` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new Map<PtrHash, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(npc: EntityNPC) {
+ *   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetNPC(v.run.npcsSpeedBoost, npc);
+ * }
+ * ```
+ */
+export declare function mapGetNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC): V | undefined;
+
 /**
  * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
  * `Map.get` method if you have a map of this type.
@@ -9326,6 +9389,12 @@ export declare function mapDeletePlayer(map: Map<PlayerIndex, unknown>, player:
  */
 export declare function mapGetPlayer<V>(map: Map<PlayerIndex, V>, player: EntityPlayer): V | undefined;
 
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.has` method if you have a map of this type.
+ */
+export declare function mapHasNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC): boolean;
+
 /**
  * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
  * `Map.has` method if you have a map of this type.
@@ -9351,6 +9420,28 @@ export declare const MAPPING_COLLECTIBLES: readonly [CollectibleType.COMPASS, Co
  */
 export declare function mapSetHash<V>(map: Map<PtrHash, V>, entity: Entity, value: V): void;
 
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new Map<PtrHash, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(npc: EntityNPC) {
+ *   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetNPC(v.run.npcsSpeedBoost, npc);
+ * }
+ * ```
+ */
+export declare function mapSetNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC, value: V): void;
+
 /**
  * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
  * `Map.set` method if you have a map of this type.
@@ -15402,6 +15493,12 @@ export declare function setActiveItem(player: EntityPlayer, collectibleType: Col
  */
 export declare function setAdd<T>(set: Set<T>, ...elements: T[]): void;
 
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.add` method if you have a set of this type.
+ */
+export declare function setAddNPC(set: Set<PtrHash>, npc: EntityNPC): Set<PtrHash>;
+
 /**
  * Helper function to make using sets with an type of `PlayerIndex` easier. Use this instead of the
  * `Set.add` method if you have a set of this type.
@@ -15498,6 +15595,12 @@ export declare function setCollectiblesRerolledForItemTracker(): void;
  */
 export declare function setCollectibleSubType(collectible: EntityPickup, newCollectibleType: CollectibleType): void;
 
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.delete` method if you have a set of this type.
+ */
+export declare function setDeleteNPC(set: Set<PtrHash>, npc: EntityNPC): boolean;
+
 /**
  * Helper function to make using sets with an type of `PlayerIndex` easier. Use this instead of the
  * `Set.delete` method if you have a set of this type.
@@ -15582,6 +15685,12 @@ export declare function setGridEntityInvisible(gridEntity: GridEntity): void;
  */
 export declare function setHas<T>(set: Set<T> | ReadonlySet<T>, ...elements: T[]): boolean;
 
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.has` method if you have a set of this type.
+ */
+export declare function setHasNPC(set: Set<PtrHash>, npc: EntityNPC): boolean;
+
 /**
  * Helper function to make using sets with an type of `PlayerIndex` easier. Use this instead of the
  * `Set.has` method if you have a set of this type.

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 30.11.9
+isaacscript-common 30.12.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -53460,6 +53460,48 @@ function ____exports.initModFeatures(self, mod, modFeatures)
     end
     return instantiatedModFeatures
 end
+return ____exports
+ end,
+["src.functions.npcDataStructures"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local Set = ____lualib.Set
+local ____exports = {}
+function ____exports.mapSetNPC(self, map, npc, value)
+    local ptrHash = GetPtrHash(npc)
+    map:set(ptrHash, value)
+end
+function ____exports.defaultMapGetNPC(self, map, npc, ...)
+    local ptrHash = GetPtrHash(npc)
+    return map:getAndSetDefault(ptrHash, ...)
+end
+function ____exports.defaultMapSetNPC(self, map, npc, value)
+    ____exports.mapSetNPC(nil, map, npc, value)
+end
+function ____exports.mapDeleteNPC(self, map, npc)
+    local ptrHash = GetPtrHash(npc)
+    return map:delete(ptrHash)
+end
+function ____exports.mapGetNPC(self, map, npc)
+    local ptrHash = GetPtrHash(npc)
+    return map:get(ptrHash)
+end
+function ____exports.mapHasNPC(self, map, npc)
+    local ptrHash = GetPtrHash(npc)
+    return map:has(ptrHash)
+end
+function ____exports.setAddNPC(self, set, npc)
+    local ptrHash = GetPtrHash(npc)
+    return set:add(ptrHash)
+end
+function ____exports.setDeleteNPC(self, set, npc)
+    local ptrHash = GetPtrHash(npc)
+    return set:delete(ptrHash)
+end
+function ____exports.setHasNPC(self, set, npc)
+    local ptrHash = GetPtrHash(npc)
+    return set:has(ptrHash)
+end
 return ____exports
  end,
 ["src.functions.pressurePlate"] = function(...) 
@@ -54374,6 +54416,14 @@ do
         end
     end
 end
+do
+    local ____export = require("src.functions.npcDataStructures")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("src.functions.npcs")
     for ____exportKey, ____exportValue in pairs(____export) do
@@ -55482,6 +55532,14 @@ do
         end
     end
 end
+do
+    local ____export = require("src.functions.npcDataStructures")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("src.functions.npcs")
     for ____exportKey, ____exportValue in pairs(____export) do

package/dist/src/functions/npcDataStructures.d.ts

@@ -0,0 +1,104 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+import { DefaultMap } from "../classes/DefaultMap";
+/**
+ * Helper function to make using default maps with an index of `PtrHash` easier. Use this instead of
+ * the `DefaultMap.getAndSetDefault` method if you have a default map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new DefaultMap<PtrHash, int>(0),
+ *   },
+ * };
+ *
+ * function npcUpdate(npc: EntityNPC) {
+ *   const speedBoost = defaultMapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   // Do something with the speed boost.
+ * }
+ * ```
+ *
+ * Note that not all NPCs should be stored in a map with a `PtrHash` as an index, so only use this
+ * in the situations where that would be okay. (For example, Dark Esau should never be stored in a
+ * map like this, because the scope of `PtrHash` is per room and Dark Esau is persistent between
+ * rooms.)
+ */
+export declare function defaultMapGetNPC<V, Args extends unknown[]>(map: DefaultMap<PtrHash, V, Args>, npc: EntityNPC, ...extraArgs: Args): V;
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * Since `Map` and `DefaultMap` set values in the same way, this function is simply an alias for the
+ * `mapSetNPC` helper function.
+ */
+export declare function defaultMapSetNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC, value: V): void;
+/**
+ * Helper function to make using maps with an type of `PtrHash` easier. Use this instead of the
+ * `Map.delete` method if you have a set of this type.
+ */
+export declare function mapDeleteNPC(map: Map<PtrHash, unknown>, npc: EntityNPC): boolean;
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.get` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new Map<PtrHash, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(npc: EntityNPC) {
+ *   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetNPC(v.run.npcsSpeedBoost, npc);
+ * }
+ * ```
+ */
+export declare function mapGetNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC): V | undefined;
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.has` method if you have a map of this type.
+ */
+export declare function mapHasNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC): boolean;
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new Map<PtrHash, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(npc: EntityNPC) {
+ *   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetNPC(v.run.npcsSpeedBoost, npc);
+ * }
+ * ```
+ */
+export declare function mapSetNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC, value: V): void;
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.add` method if you have a set of this type.
+ */
+export declare function setAddNPC(set: Set<PtrHash>, npc: EntityNPC): Set<PtrHash>;
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.delete` method if you have a set of this type.
+ */
+export declare function setDeleteNPC(set: Set<PtrHash>, npc: EntityNPC): boolean;
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.has` method if you have a set of this type.
+ */
+export declare function setHasNPC(set: Set<PtrHash>, npc: EntityNPC): boolean;
+//# sourceMappingURL=npcDataStructures.d.ts.map

package/dist/src/functions/npcDataStructures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npcDataStructures.d.ts","sourceRoot":"","sources":["../../../src/functions/npcDataStructures.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,EACxD,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,EACjC,GAAG,EAAE,SAAS,EACd,GAAG,SAAS,EAAE,IAAI,GACjB,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1B,GAAG,EAAE,SAAS,GACb,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,GAAG,EAAE,SAAS,GACb,CAAC,GAAG,SAAS,CAGf;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAG1E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,CAGzE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAGvE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAGpE"}

package/dist/src/functions/npcDataStructures.lua

@@ -0,0 +1,113 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local Set = ____lualib.Set
+local ____exports = {}
+--- Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+-- `Map.set` method if you have a map of this type.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const v = {
+--   run: {
+--     npcsSpeedBoost: new Map<PtrHash, int>(),
+--   },
+-- };
+-- 
+-- function incrementSpeedBoost(npc: EntityNPC) {
+--   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+--   const newSpeedBoost = oldSpeedBoost + 0.1;
+--   mapSetNPC(v.run.npcsSpeedBoost, npc);
+-- }
+-- ```
+function ____exports.mapSetNPC(self, map, npc, value)
+    local ptrHash = GetPtrHash(npc)
+    map:set(ptrHash, value)
+end
+--- Helper function to make using default maps with an index of `PtrHash` easier. Use this instead of
+-- the `DefaultMap.getAndSetDefault` method if you have a default map of this type.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const v = {
+--   run: {
+--     npcsSpeedBoost: new DefaultMap<PtrHash, int>(0),
+--   },
+-- };
+-- 
+-- function npcUpdate(npc: EntityNPC) {
+--   const speedBoost = defaultMapGetNPC(v.run.npcsSpeedBoost, npc);
+--   // Do something with the speed boost.
+-- }
+-- ```
+-- 
+-- Note that not all NPCs should be stored in a map with a `PtrHash` as an index, so only use this
+-- in the situations where that would be okay. (For example, Dark Esau should never be stored in a
+-- map like this, because the scope of `PtrHash` is per room and Dark Esau is persistent between
+-- rooms.)
+function ____exports.defaultMapGetNPC(self, map, npc, ...)
+    local ptrHash = GetPtrHash(npc)
+    return map:getAndSetDefault(ptrHash, ...)
+end
+--- Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+-- `Map.set` method if you have a map of this type.
+-- 
+-- Since `Map` and `DefaultMap` set values in the same way, this function is simply an alias for the
+-- `mapSetNPC` helper function.
+function ____exports.defaultMapSetNPC(self, map, npc, value)
+    ____exports.mapSetNPC(nil, map, npc, value)
+end
+--- Helper function to make using maps with an type of `PtrHash` easier. Use this instead of the
+-- `Map.delete` method if you have a set of this type.
+function ____exports.mapDeleteNPC(self, map, npc)
+    local ptrHash = GetPtrHash(npc)
+    return map:delete(ptrHash)
+end
+--- Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+-- `Map.get` method if you have a map of this type.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const v = {
+--   run: {
+--     npcsSpeedBoost: new Map<PtrHash, int>(),
+--   },
+-- };
+-- 
+-- function incrementSpeedBoost(npc: EntityNPC) {
+--   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+--   const newSpeedBoost = oldSpeedBoost + 0.1;
+--   mapSetNPC(v.run.npcsSpeedBoost, npc);
+-- }
+-- ```
+function ____exports.mapGetNPC(self, map, npc)
+    local ptrHash = GetPtrHash(npc)
+    return map:get(ptrHash)
+end
+--- Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+-- `Map.has` method if you have a map of this type.
+function ____exports.mapHasNPC(self, map, npc)
+    local ptrHash = GetPtrHash(npc)
+    return map:has(ptrHash)
+end
+--- Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+-- `Set.add` method if you have a set of this type.
+function ____exports.setAddNPC(self, set, npc)
+    local ptrHash = GetPtrHash(npc)
+    return set:add(ptrHash)
+end
+--- Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+-- `Set.delete` method if you have a set of this type.
+function ____exports.setDeleteNPC(self, set, npc)
+    local ptrHash = GetPtrHash(npc)
+    return set:delete(ptrHash)
+end
+--- Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+-- `Set.has` method if you have a set of this type.
+function ____exports.setHasNPC(self, set, npc)
+    local ptrHash = GetPtrHash(npc)
+    return set:has(ptrHash)
+end
+return ____exports

package/dist/src/functions/playerDataStructures.d.ts

@@ -19,7 +19,7 @@ import { PlayerIndex } from "../types/PlayerIndex";
  * }
  * ```
  */
-export declare function defaultMapGetPlayer<V, A extends unknown[]>(map: DefaultMap<PlayerIndex, V, A>, player: EntityPlayer, ...extraArgs: A): V;
+export declare function defaultMapGetPlayer<V, Args extends unknown[]>(map: DefaultMap<PlayerIndex, V, Args>, player: EntityPlayer, ...extraArgs: Args): V;
 /**
  * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
  * `Map.set` method if you have a map of this type.

package/dist/src/functions/playerDataStructures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playerDataStructures.d.ts","sourceRoot":"","sources":["../../../src/functions/playerDataStructures.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,EACxD,GAAG,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,EAClC,MAAM,EAAE,YAAY,EACpB,GAAG,SAAS,EAAE,CAAC,GACd,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,GACnB,CAAC,GAAG,SAAS,CAGf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,CAAC,GACP,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,EACrB,MAAM,EAAE,YAAY,GACnB,GAAG,CAAC,WAAW,CAAC,CAGlB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,EACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,EACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT"}
+{"version":3,"file":"playerDataStructures.d.ts","sourceRoot":"","sources":["../../../src/functions/playerDataStructures.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,EAC3D,GAAG,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,EACrC,MAAM,EAAE,YAAY,EACpB,GAAG,SAAS,EAAE,IAAI,GACjB,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,GACnB,CAAC,GAAG,SAAS,CAGf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,CAAC,GACP,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,EACrB,MAAM,EAAE,YAAY,GACnB,GAAG,CAAC,WAAW,CAAC,CAGlB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,EACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,EACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAGT"}

package/dist/src/index.d.ts

@@ -77,6 +77,7 @@ export * from "./functions/mergeTests";
 export * from "./functions/minimap";
 export * from "./functions/modFeatures";
 export * from "./functions/nextStage";
+export * from "./functions/npcDataStructures";
 export * from "./functions/npcs";
 export * from "./functions/pickupVariants";
 export * from "./functions/pickups";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.lua

@@ -631,6 +631,14 @@ do
         end
     end
 end
+do
+    local ____export = require("src.functions.npcDataStructures")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("src.functions.npcs")
     for ____exportKey, ____exportValue in pairs(____export) do

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "30.11.9",
+  "version": "30.12.1",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -25,6 +25,6 @@
   "main": "dist/src/index",
   "types": "dist/index.rollup.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^13.0.14"
+    "isaac-typescript-definitions": "^13.0.15"
   }
 }

package/src/functions/npcDataStructures.ts

@@ -0,0 +1,154 @@
+import { DefaultMap } from "../classes/DefaultMap";
+
+/**
+ * Helper function to make using default maps with an index of `PtrHash` easier. Use this instead of
+ * the `DefaultMap.getAndSetDefault` method if you have a default map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new DefaultMap<PtrHash, int>(0),
+ *   },
+ * };
+ *
+ * function npcUpdate(npc: EntityNPC) {
+ *   const speedBoost = defaultMapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   // Do something with the speed boost.
+ * }
+ * ```
+ *
+ * Note that not all NPCs should be stored in a map with a `PtrHash` as an index, so only use this
+ * in the situations where that would be okay. (For example, Dark Esau should never be stored in a
+ * map like this, because the scope of `PtrHash` is per room and Dark Esau is persistent between
+ * rooms.)
+ */
+export function defaultMapGetNPC<V, Args extends unknown[]>(
+  map: DefaultMap<PtrHash, V, Args>,
+  npc: EntityNPC,
+  ...extraArgs: Args
+): V {
+  const ptrHash = GetPtrHash(npc);
+  return map.getAndSetDefault(ptrHash, ...extraArgs);
+}
+
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * Since `Map` and `DefaultMap` set values in the same way, this function is simply an alias for the
+ * `mapSetNPC` helper function.
+ */
+export function defaultMapSetNPC<V>(
+  map: Map<PtrHash, V>,
+  npc: EntityNPC,
+  value: V,
+): void {
+  mapSetNPC(map, npc, value);
+}
+
+/**
+ * Helper function to make using maps with an type of `PtrHash` easier. Use this instead of the
+ * `Map.delete` method if you have a set of this type.
+ */
+export function mapDeleteNPC(
+  map: Map<PtrHash, unknown>,
+  npc: EntityNPC,
+): boolean {
+  const ptrHash = GetPtrHash(npc);
+  return map.delete(ptrHash);
+}
+
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.get` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new Map<PtrHash, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(npc: EntityNPC) {
+ *   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetNPC(v.run.npcsSpeedBoost, npc);
+ * }
+ * ```
+ */
+export function mapGetNPC<V>(
+  map: Map<PtrHash, V>,
+  npc: EntityNPC,
+): V | undefined {
+  const ptrHash = GetPtrHash(npc);
+  return map.get(ptrHash);
+}
+
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.has` method if you have a map of this type.
+ */
+export function mapHasNPC<V>(map: Map<PtrHash, V>, npc: EntityNPC): boolean {
+  const ptrHash = GetPtrHash(npc);
+  return map.has(ptrHash);
+}
+
+/**
+ * Helper function to make using maps with an index of `PtrHash` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     npcsSpeedBoost: new Map<PtrHash, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(npc: EntityNPC) {
+ *   const oldSpeedBoost = mapGetNPC(v.run.npcsSpeedBoost, npc);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetNPC(v.run.npcsSpeedBoost, npc);
+ * }
+ * ```
+ */
+export function mapSetNPC<V>(
+  map: Map<PtrHash, V>,
+  npc: EntityNPC,
+  value: V,
+): void {
+  const ptrHash = GetPtrHash(npc);
+  map.set(ptrHash, value);
+}
+
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.add` method if you have a set of this type.
+ */
+export function setAddNPC(set: Set<PtrHash>, npc: EntityNPC): Set<PtrHash> {
+  const ptrHash = GetPtrHash(npc);
+  return set.add(ptrHash);
+}
+
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.delete` method if you have a set of this type.
+ */
+export function setDeleteNPC(set: Set<PtrHash>, npc: EntityNPC): boolean {
+  const ptrHash = GetPtrHash(npc);
+  return set.delete(ptrHash);
+}
+
+/**
+ * Helper function to make using sets with an type of `PtrHash` easier. Use this instead of the
+ * `Set.has` method if you have a set of this type.
+ */
+export function setHasNPC(set: Set<PtrHash>, npc: EntityNPC): boolean {
+  const ptrHash = GetPtrHash(npc);
+  return set.has(ptrHash);
+}

package/src/functions/playerDataStructures.ts

@@ -20,10 +20,10 @@ import { getPlayerIndex } from "./playerIndex";
  * }
  * ```
  */
-export function defaultMapGetPlayer<V, A extends unknown[]>(
-  map: DefaultMap<PlayerIndex, V, A>,
+export function defaultMapGetPlayer<V, Args extends unknown[]>(
+  map: DefaultMap<PlayerIndex, V, Args>,
   player: EntityPlayer,
-  ...extraArgs: A
+  ...extraArgs: Args
 ): V {
   const playerIndex = getPlayerIndex(player);
   return map.getAndSetDefault(playerIndex, ...extraArgs);

package/src/index.ts

@@ -77,6 +77,7 @@ export * from "./functions/mergeTests";
 export * from "./functions/minimap";
 export * from "./functions/modFeatures";
 export * from "./functions/nextStage";
+export * from "./functions/npcDataStructures";
 export * from "./functions/npcs";
 export * from "./functions/pickupVariants";
 export * from "./functions/pickups";