isaacscript-common 9.8.4 → 9.9.0

package/dist/functions/entities.d.ts

@@ -71,6 +71,12 @@ export declare function getEntities(entityType?: EntityType, variant?: number, s
  * as comparing other types is non-trivial.
  */
 export declare function getEntityFields(entity: Entity): LuaMap<string, boolean | number | string>;
+/**
+ * Helper function to get an entity from a `PtrHash`. Note that doing this is very expensive, so you
+ * should only use this function when debugging. (Normally, if you need to work backwards from a
+ * reference, you would use an `EntityPtr` instead of a `PtrHash`.
+ */
+export declare function getEntityFromPtrHash(ptrHash: PtrHash): Entity | undefined;
 /** Helper function to return a string containing the entity's type, variant, and sub-type. */
 export declare function getEntityID(entity: Entity): string;
 /**

package/dist/functions/entities.d.ts.map

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

package/dist/functions/entities.lua

@@ -1,4 +1,5 @@
 local ____lualib = require("lualib_bundle")
+local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
@@ -208,6 +209,16 @@ function ____exports.getEntityFields(self, entity)
     setPrimitiveEntityFields(nil, entity, parentTable, entityFields)
     return entityFields
 end
+--- Helper function to get an entity from a `PtrHash`. Note that doing this is very expensive, so you
+-- should only use this function when debugging. (Normally, if you need to work backwards from a
+-- reference, you would use an `EntityPtr` instead of a `PtrHash`.
+function ____exports.getEntityFromPtrHash(self, ptrHash)
+    local entities = ____exports.getEntities(nil)
+    return __TS__ArrayFind(
+        entities,
+        function(____, entity) return GetPtrHash(entity) == ptrHash end
+    )
+end
 --- Helper function to return a string containing the entity's type, variant, and sub-type.
 function ____exports.getEntityID(self, entity)
     return (((tostring(entity.Type) .. ".") .. tostring(entity.Variant)) .. ".") .. tostring(entity.SubType)

package/dist/functions/logEntities.d.ts

@@ -13,4 +13,14 @@ export declare function logEntity(this: void, entity: Entity): void;
 export declare function logGridEntities(this: void, gridEntities: GridEntity[]): void;
 /** Helper function for log information about a specific grid entity. */
 export declare function logGridEntity(this: void, gridEntity: GridEntity): void;
+/**
+ * Helper function to log information about the entity that corresponding to a pointer hash. (Only
+ * use this when debugging, since retrieving the corresponding entity is expensive.)
+ */
+export declare function logPtrHash(this: void, ptrHash: PtrHash): void;
+/**
+ * Helper function to log information about the entity that corresponding to one or more pointer
+ * hashes. (Only use this when debugging, since retrieving the corresponding entity is expensive.)
+ */
+export declare function logPtrHashes(this: void, ptrHashes: PtrHash[]): void;
 //# sourceMappingURL=logEntities.d.ts.map

package/dist/functions/logEntities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logEntities.d.ts","sourceRoot":"","sources":["../../src/functions/logEntities.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,cAAc,EACf,MAAM,8BAA8B,CAAC;AAiBtC,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,wBAAwB,EAAE,OAAO,EACjC,gBAAgB,CAAC,EAAE,UAAU,GAC5B,IAAI,CAuCN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,OAAO,EACrB,oBAAoB,CAAC,EAAE,cAAc,GACpC,IAAI,CA6CN;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAIhE;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG1D;AA2ED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAI5E;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAGtE"}
+{"version":3,"file":"logEntities.d.ts","sourceRoot":"","sources":["../../src/functions/logEntities.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,cAAc,EACf,MAAM,8BAA8B,CAAC;AAiBtC,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,wBAAwB,EAAE,OAAO,EACjC,gBAAgB,CAAC,EAAE,UAAU,GAC5B,IAAI,CAuCN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,OAAO,EACrB,oBAAoB,CAAC,EAAE,cAAc,GACpC,IAAI,CA6CN;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAIhE;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG1D;AA2ED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAI5E;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAGtE;AA2DD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAInE"}

package/dist/functions/logEntities.lua

@@ -9,6 +9,7 @@ local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local ____entities = require("functions.entities")
 local getEntities = ____entities.getEntities
+local getEntityFromPtrHash = ____entities.getEntityFromPtrHash
 local getEntityID = ____entities.getEntityID
 local ____gridEntities = require("functions.gridEntities")
 local getGridEntities = ____gridEntities.getGridEntities
@@ -217,4 +218,22 @@ function ____exports.logGridEntities(gridEntities)
         ____exports.logGridEntity(gridEntity)
     end
 end
+--- Helper function to log information about the entity that corresponding to a pointer hash. (Only
+-- use this when debugging, since retrieving the corresponding entity is expensive.)
+function ____exports.logPtrHash(ptrHash)
+    log("PtrHash: " .. tostring(ptrHash))
+    local entity = getEntityFromPtrHash(nil, ptrHash)
+    if entity == nil then
+        log("No corresponding entity found.")
+    else
+        ____exports.logEntity(entity)
+    end
+end
+--- Helper function to log information about the entity that corresponding to one or more pointer
+-- hashes. (Only use this when debugging, since retrieving the corresponding entity is expensive.)
+function ____exports.logPtrHashes(ptrHashes)
+    for ____, ptrHash in ipairs(ptrHashes) do
+        ____exports.logPtrHash(ptrHash)
+    end
+end
 return ____exports

package/dist/functions/minimap.d.ts

@@ -33,6 +33,9 @@ export declare function setFloorDisplayFlags(displayFlagsMap: Map<int, BitFlags<
  * Helper function to set a particular room's minimap display flags (e.g. whether or not it is
  * visible and so on).
  *
+ * You must call the `Level.UpdateVisibility` method after using this function for the changes to
+ * take effect.
+ *
  * @param roomGridIndex Set to undefined to use the current room index.
  * @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
  */

package/dist/functions/minimap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,8BAA8B,CAAC;AAK5E;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAS7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAYtE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,GAClB,QAAQ,CAAC,WAAW,CAAC,CAGvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAgBN;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,GAClC,IAAI,CAGN"}
+{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,8BAA8B,CAAC;AAK5E;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAS7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAYtE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,GAClB,QAAQ,CAAC,WAAW,CAAC,CAGvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAgBN;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAEN;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,GAClC,IAAI,CAGN"}

package/dist/functions/minimap.lua

@@ -14,6 +14,9 @@ local getRoomsInsideGrid = ____rooms.getRoomsInsideGrid
 --- Helper function to set a particular room's minimap display flags (e.g. whether or not it is
 -- visible and so on).
 -- 
+-- You must call the `Level.UpdateVisibility` method after using this function for the changes to
+-- take effect.
+-- 
 -- @param roomGridIndex Set to undefined to use the current room index.
 -- @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
 function ____exports.setRoomDisplayFlags(self, roomGridIndex, displayFlags)

package/dist/index.d.ts

@@ -2983,6 +2983,13 @@ export declare function getEntities(entityType?: EntityType, variant?: number, s
  */
 export declare function getEntityFields(entity: Entity): LuaMap<string, boolean | number | string>;
 
+/**
+ * Helper function to get an entity from a `PtrHash`. Note that doing this is very expensive, so you
+ * should only use this function when debugging. (Normally, if you need to work backwards from a
+ * reference, you would use an `EntityPtr` instead of a `PtrHash`.
+ */
+export declare function getEntityFromPtrHash(ptrHash: PtrHash): Entity | undefined;
+
 /** Helper function to return a string containing the entity's type, variant, and sub-type. */
 export declare function getEntityID(entity: Entity): string;
 
@@ -6588,6 +6595,18 @@ export declare function logPlayerHealth(this: void, player: EntityPlayer): void;
  */
 export declare function logProjectileFlags(this: void, flags: ProjectileFlag | BitFlags<ProjectileFlag>): void;
 
+/**
+ * Helper function to log information about the entity that corresponding to a pointer hash. (Only
+ * use this when debugging, since retrieving the corresponding entity is expensive.)
+ */
+export declare function logPtrHash(this: void, ptrHash: PtrHash): void;
+
+/**
+ * Helper function to log information about the entity that corresponding to one or more pointer
+ * hashes. (Only use this when debugging, since retrieving the corresponding entity is expensive.)
+ */
+export declare function logPtrHashes(this: void, ptrHashes: PtrHash[]): void;
+
 /** Helper function for logging information about the current room. */
 export declare function logRoom(this: void): void;
 
@@ -10630,6 +10649,9 @@ export declare function setRoomData(roomGridIndex: int, roomData: Readonly<RoomC
  * Helper function to set a particular room's minimap display flags (e.g. whether or not it is
  * visible and so on).
  *
+ * You must call the `Level.UpdateVisibility` method after using this function for the changes to
+ * take effect.
+ *
  * @param roomGridIndex Set to undefined to use the current room index.
  * @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
  */

package/dist/maps/cardMap.lua

@@ -73,8 +73,8 @@ ____exports.CARD_MAP = __TS__New(Map, {
     {"algiz", CardType.RUNE_ALGIZ},
     {"resistance", CardType.RUNE_ALGIZ},
     {"shield", CardType.RUNE_ALGIZ},
-    {"blank", CardType.RUNE_BLANK},
-    {"black", CardType.RUNE_BLACK},
+    {"blankRune", CardType.RUNE_BLANK},
+    {"blackRune", CardType.RUNE_BLACK},
     {"chaos", CardType.CHAOS},
     {"credit", CardType.CREDIT},
     {"rules", CardType.RULES},

package/package.json

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

package/src/functions/entities.ts

@@ -194,6 +194,16 @@ function setPrimitiveEntityFields(
   }
 }
 
+/**
+ * Helper function to get an entity from a `PtrHash`. Note that doing this is very expensive, so you
+ * should only use this function when debugging. (Normally, if you need to work backwards from a
+ * reference, you would use an `EntityPtr` instead of a `PtrHash`.
+ */
+export function getEntityFromPtrHash(ptrHash: PtrHash): Entity | undefined {
+  const entities = getEntities();
+  return entities.find((entity) => GetPtrHash(entity) === ptrHash);
+}
+
 /** Helper function to return a string containing the entity's type, variant, and sub-type. */
 export function getEntityID(entity: Entity): string {
   return `${entity.Type}.${entity.Variant}.${entity.SubType}`;

package/src/functions/logEntities.ts

@@ -3,7 +3,7 @@ import {
   EntityType,
   GridEntityType,
 } from "isaac-typescript-definitions";
-import { getEntities, getEntityID } from "./entities";
+import { getEntities, getEntityFromPtrHash, getEntityID } from "./entities";
 import { getGridEntities, getGridEntityID } from "./gridEntities";
 import { log } from "./log";
 
@@ -274,3 +274,27 @@ function getGridEntityLogLine(gridEntity: GridEntity, num?: int): string {
 
   return msg;
 }
+
+/**
+ * Helper function to log information about the entity that corresponding to a pointer hash. (Only
+ * use this when debugging, since retrieving the corresponding entity is expensive.)
+ */
+export function logPtrHash(this: void, ptrHash: PtrHash): void {
+  log(`PtrHash: ${ptrHash}`);
+  const entity = getEntityFromPtrHash(ptrHash);
+  if (entity === undefined) {
+    log("No corresponding entity found.");
+  } else {
+    logEntity(entity);
+  }
+}
+
+/**
+ * Helper function to log information about the entity that corresponding to one or more pointer
+ * hashes. (Only use this when debugging, since retrieving the corresponding entity is expensive.)
+ */
+export function logPtrHashes(this: void, ptrHashes: PtrHash[]): void {
+  for (const ptrHash of ptrHashes) {
+    logPtrHash(ptrHash);
+  }
+}

package/src/functions/minimap.ts

@@ -90,6 +90,9 @@ export function setFloorDisplayFlags(
  * Helper function to set a particular room's minimap display flags (e.g. whether or not it is
  * visible and so on).
  *
+ * You must call the `Level.UpdateVisibility` method after using this function for the changes to
+ * take effect.
+ *
  * @param roomGridIndex Set to undefined to use the current room index.
  * @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
  */

package/src/maps/cardMap.ts

@@ -71,8 +71,8 @@ export const CARD_MAP: ReadonlyMap<string, CardType> = new Map([
   ["algiz", CardType.RUNE_ALGIZ], // 39
   ["resistance", CardType.RUNE_ALGIZ], // 39
   ["shield", CardType.RUNE_ALGIZ], // 39
-  ["blank", CardType.RUNE_BLANK], // 40
-  ["black", CardType.RUNE_BLACK], // 41
+  ["blankRune", CardType.RUNE_BLANK], // 40
+  ["blackRune", CardType.RUNE_BLACK], // 41
   ["chaos", CardType.CHAOS], // 42
   ["credit", CardType.CREDIT], // 43
   ["rules", CardType.RULES], // 44