isaacscript-common 6.6.1-dev.0 → 6.6.1-dev.4

package/dist/enums/ModCallbackCustom.js.map

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

package/dist/enums/ModCallbackCustom.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/enums/ModCallbackCustom.ts"],"names":[],"mappings":";;;;;;;AAiBA;AAYE;AAAA;AAaA;AAAA;AAYA;AAAA;AAeA;AAAA;AASA;AAAA;AAgBA;AAAA;AAkBA;AAAA;AAWA;AAAA;AAkBA;AAAA;AAkBA;AAAA;AAgBA;AAAA;AAYA;AAAA;AAYA;AAAA;AAeA;AAAA;AAiBA;AAAA;AAUA;AAAA;AAeA;AAAA;AAiBA;AAAA;AAaA;AAAA;AAcA;AAAA;AAcA;AAAA;AAYA;AAAA;AASA;AAAA;AAaA;AAAA;AAeA;AAAA;AAiBA;AAAA;AAgBA;AAAA;AAcA;AAAA;AAgBA;AAAA;AAcA;AAAA;AAuBA;AAAA;AAuBA;AAAA;AAqBA;AAAA;AAeA;AAAA;AAeA;AAAA;AAkBA;AAAA;AAYA;AAAA;AAkBA;AAAA;AAeA;AAAA;AAmBA;AAAA;AAwBA;AAAA;AAcA;AAAA;AAuBA;AAAA;AAeA;AAAA;AAiBA;AAAA;AAYA;AAAA;AAYA;AAAA;AAmBA;AAAA;AAmBA;AAAA;AAgBA;AAAA;AAgBA;AAAA;AAkBA;AAAA;AAiBA;AAAA;AAuBA;AAAA;AAwBA;AAAA;AAwBA;AAAA;AAYA;AAAA;AAYA;AAAA;AAYA;AAAA;AAYA;AAAA;AAeA;AAAA;AAeA;AAAA;AAYA;AAAA;AAYA;AAAA;AAYA;AAAA;AAeA;AAAA;AAYA;AAAA;AAeA;AAAA;AAiBA;AAAA;AAYA;AAAA;AAYA;AAAA;AAYA;AAAA;AAYA;AAAA;AAgBA;AAAA;AAeA;AAAA;AAYA;AAAA;AAYA;AAAA;AAmBA;AAAA;AAeA;AAAA;AAgBA;AAAA;AAmBA;AAAA;AAoBA;AAAA;AAeA;AAAA","file":"ModCallbackCustom.lua","sourceRoot":"../src/"}

package/dist/enums/PocketItemType.js

@@ -0,0 +1,10 @@
+export var PocketItemType;
+(function (PocketItemType) {
+    PocketItemType[PocketItemType["EMPTY"] = 0] = "EMPTY";
+    PocketItemType[PocketItemType["CARD"] = 1] = "CARD";
+    PocketItemType[PocketItemType["PILL"] = 2] = "PILL";
+    PocketItemType[PocketItemType["ACTIVE_ITEM"] = 3] = "ACTIVE_ITEM";
+    PocketItemType[PocketItemType["DICE_BAG_DICE"] = 4] = "DICE_BAG_DICE";
+    PocketItemType[PocketItemType["UNDETERMINABLE"] = 5] = "UNDETERMINABLE";
+})(PocketItemType || (PocketItemType = {}));
+//# sourceMappingURL=PocketItemType.js.map

package/dist/enums/PocketItemType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PocketItemType.js","sourceRoot":"../src/","sources":["enums/PocketItemType.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,qDAAK,CAAA;IACL,mDAAI,CAAA;IACJ,mDAAI,CAAA;IACJ,iEAAW,CAAA;IACX,qEAAa,CAAA;IACb,uEAAc,CAAA;AAChB,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB"}

package/dist/enums/PocketItemType.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/enums/PocketItemType.ts"],"names":[],"mappings":";AAAA;AACE;AAAA;AACA;AAAA;AACA;AAAA;AACA;AAAA;AACA;AAAA;AACA;AAAA","file":"PocketItemType.lua","sourceRoot":"../src/"}

package/dist/enums/RockAltType.js

@@ -0,0 +1,9 @@
+export var RockAltType;
+(function (RockAltType) {
+    RockAltType[RockAltType["URN"] = 0] = "URN";
+    RockAltType[RockAltType["MUSHROOM"] = 1] = "MUSHROOM";
+    RockAltType[RockAltType["SKULL"] = 2] = "SKULL";
+    RockAltType[RockAltType["POLYP"] = 3] = "POLYP";
+    RockAltType[RockAltType["BUCKET"] = 4] = "BUCKET";
+})(RockAltType || (RockAltType = {}));
+//# sourceMappingURL=RockAltType.js.map

package/dist/enums/RockAltType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RockAltType.js","sourceRoot":"../src/","sources":["enums/RockAltType.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,2CAAG,CAAA;IACH,qDAAQ,CAAA;IACR,+CAAK,CAAA;IACL,+CAAK,CAAA;IACL,iDAAM,CAAA;AACR,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB"}

package/dist/enums/RockAltType.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/enums/RockAltType.ts"],"names":[],"mappings":";AAAA;AACE;AAAA;AACA;AAAA;AACA;AAAA;AACA;AAAA;AACA;AAAA","file":"RockAltType.lua","sourceRoot":"../src/"}

package/dist/enums/SerializationType.js

@@ -0,0 +1,7 @@
+export var SerializationType;
+(function (SerializationType) {
+    SerializationType[SerializationType["NONE"] = 0] = "NONE";
+    SerializationType[SerializationType["SERIALIZE"] = 1] = "SERIALIZE";
+    SerializationType[SerializationType["DESERIALIZE"] = 2] = "DESERIALIZE";
+})(SerializationType || (SerializationType = {}));
+//# sourceMappingURL=SerializationType.js.map

package/dist/enums/SerializationType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializationType.js","sourceRoot":"../src/","sources":["enums/SerializationType.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,yDAAI,CAAA;IACJ,mEAAS,CAAA;IACT,uEAAW,CAAA;AACb,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B"}

package/dist/enums/SerializationType.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/enums/SerializationType.ts"],"names":[],"mappings":";AAAA;AACE;AAAA;AACA;AAAA;AACA;AAAA","file":"SerializationType.lua","sourceRoot":"../src/"}

package/dist/enums/SlotDestructionType.js

@@ -0,0 +1,6 @@
+export var SlotDestructionType;
+(function (SlotDestructionType) {
+    SlotDestructionType[SlotDestructionType["NORMAL"] = 0] = "NORMAL";
+    SlotDestructionType[SlotDestructionType["COLLECTIBLE_PAYOUT"] = 1] = "COLLECTIBLE_PAYOUT";
+})(SlotDestructionType || (SlotDestructionType = {}));
+//# sourceMappingURL=SlotDestructionType.js.map

package/dist/enums/SlotDestructionType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlotDestructionType.js","sourceRoot":"../src/","sources":["enums/SlotDestructionType.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,iEAAM,CAAA;IACN,yFAAkB,CAAA;AACpB,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B"}

package/dist/enums/SlotDestructionType.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/enums/SlotDestructionType.ts"],"names":[],"mappings":";AAAA;AACE;AAAA;AACA;AAAA","file":"SlotDestructionType.lua","sourceRoot":"../src/"}

package/dist/enums/private/CopyableIsaacAPIClassType.js

@@ -0,0 +1,9 @@
+/** This must match the enumeration in the JSDoc comments for `deepCopy` and `merge`. */
+export var CopyableIsaacAPIClassType;
+(function (CopyableIsaacAPIClassType) {
+    CopyableIsaacAPIClassType["COLOR"] = "Color";
+    CopyableIsaacAPIClassType["K_COLOR"] = "KColor";
+    CopyableIsaacAPIClassType["RNG"] = "RNG";
+    CopyableIsaacAPIClassType["VECTOR"] = "Vector";
+})(CopyableIsaacAPIClassType || (CopyableIsaacAPIClassType = {}));
+//# sourceMappingURL=CopyableIsaacAPIClassType.js.map

package/dist/enums/private/CopyableIsaacAPIClassType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyableIsaacAPIClassType.js","sourceRoot":"../src/","sources":["enums/private/CopyableIsaacAPIClassType.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,CAAN,IAAY,yBAKX;AALD,WAAY,yBAAyB;IACnC,4CAAe,CAAA;IACf,+CAAkB,CAAA;IAClB,wCAAW,CAAA;IACX,8CAAiB,CAAA;AACnB,CAAC,EALW,yBAAyB,KAAzB,yBAAyB,QAKpC"}

package/dist/enums/private/CopyableIsaacAPIClassType.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/enums/private/CopyableIsaacAPIClassType.ts"],"names":[],"mappings":";;AACA;AACE;AACA;AACA;AACA","file":"CopyableIsaacAPIClassType.lua","sourceRoot":"../src/"}

package/dist/enums/private/SaveDataKey.js

@@ -0,0 +1,8 @@
+export var SaveDataKey;
+(function (SaveDataKey) {
+    SaveDataKey["PERSISTENT"] = "persistent";
+    SaveDataKey["RUN"] = "run";
+    SaveDataKey["LEVEL"] = "level";
+    SaveDataKey["ROOM"] = "room";
+})(SaveDataKey || (SaveDataKey = {}));
+//# sourceMappingURL=SaveDataKey.js.map

package/dist/enums/private/SaveDataKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SaveDataKey.js","sourceRoot":"../src/","sources":["enums/private/SaveDataKey.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,0BAAW,CAAA;IACX,8BAAe,CAAA;IACf,4BAAa,CAAA;AACf,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}

package/dist/enums/private/SaveDataKey.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/enums/private/SaveDataKey.ts"],"names":[],"mappings":";AAAA;AACE;AACA;AACA;AACA","file":"SaveDataKey.lua","sourceRoot":"../src/"}

package/dist/enums/private/SerializationBrand.js

@@ -0,0 +1,41 @@
+/**
+ * During serialization, we write an arbitrary string key to the object with a value of an empty
+ * string. This is used during deserialization to instantiate the correct type of object.
+ *
+ * Note that we do not bother branding TSTL classes because we have no way to invoke the proper
+ * constructor during deserialization.
+ */
+export var SerializationBrand;
+(function (SerializationBrand) {
+    // Specific TSTL class brands:
+    SerializationBrand["DEFAULT_MAP"] = "__TSTL_DEFAULT_MAP";
+    SerializationBrand["MAP"] = "__TSTL_MAP";
+    SerializationBrand["SET"] = "__TSTL_SET";
+    // Specific Isaac API class brands:
+    SerializationBrand["COLOR"] = "__COLOR";
+    SerializationBrand["K_COLOR"] = "__K_COLOR";
+    SerializationBrand["RNG"] = "__RNG";
+    SerializationBrand["VECTOR"] = "__VECTOR";
+    /**
+     * This is set to the value that represents the default value (instead of an empty string like the
+     * other brands are).
+     *
+     * Default maps that use a factory function are unserializable, but do not throw runtime errors
+     * because the merge function can derive the factory function from the already-instantiated
+     * object.
+     */
+    SerializationBrand["DEFAULT_MAP_VALUE"] = "__TSTL_DEFAULT_MAP_VALUE";
+    /**
+     * The JSON library is unable to distinguish between a maps with number keys and an array. It will
+     * assume that both of these are an array. Thus, in the case of a map with number keys, it will
+     * insert null in every empty spot, leading to crashes.
+     *
+     * For example, a map with keys of 5 and 10 would be converted to the following array: `[null,
+     * null, null, null, "myValueForKey5", null, null, null, null, "myValueForKey10"]`
+     *
+     * The deep copier works around this by converting number keys to strings. It inserts this brand
+     * to keep track of the mutation.
+     */
+    SerializationBrand["OBJECT_WITH_NUMBER_KEYS"] = "__TSTL_OBJECT_WITH_NUMBER_KEYS";
+})(SerializationBrand || (SerializationBrand = {}));
+//# sourceMappingURL=SerializationBrand.js.map

package/dist/enums/private/SerializationBrand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializationBrand.js","sourceRoot":"../src/","sources":["enums/private/SerializationBrand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,kBAkCX;AAlCD,WAAY,kBAAkB;IAC5B,8BAA8B;IAC9B,wDAAkC,CAAA;IAClC,wCAAkB,CAAA;IAClB,wCAAkB,CAAA;IAElB,mCAAmC;IACnC,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;IACrB,mCAAa,CAAA;IACb,yCAAmB,CAAA;IAEnB;;;;;;;OAOG;IACH,oEAA8C,CAAA;IAE9C;;;;;;;;;;OAUG;IACH,gFAA0D,CAAA;AAC5D,CAAC,EAlCW,kBAAkB,KAAlB,kBAAkB,QAkC7B"}

package/dist/enums/private/SerializationBrand.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/enums/private/SerializationBrand.ts"],"names":[],"mappings":";;;;;;AAOA;AAEE;AACA;AACA;AAGA;AACA;AACA;AACA;AAUA;AAaA","file":"SerializationBrand.lua","sourceRoot":"../src/"}

package/dist/features/characterHealthConversion.js

@@ -0,0 +1,86 @@
+/**
+ * Easily create custom characters that have the same health mechanic as Blue Baby (red heart
+ * containers --> soul hearts) or Black Judas (red heart containers --> black hearts).
+ *
+ * @module
+ */
+import { HeartSubType, ModCallback, PickupVariant, } from "isaac-typescript-definitions";
+import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
+import { isRedHeart } from "../functions/pickups";
+const FEATURE_NAME = "characterHealthConversion";
+const characterHealthReplacementMap = new Map();
+/** @internal */
+export function characterHealthConversionInit(mod) {
+    mod.AddCallback(ModCallback.POST_PEFFECT_UPDATE, postPEffectUpdate); // 4
+    mod.AddCallback(ModCallback.PRE_PICKUP_COLLISION, prePickupCollisionHeart, PickupVariant.HEART); // 38
+}
+// ModCallback.POST_PEFFECT_UPDATE (4)
+function postPEffectUpdate(player) {
+    const character = player.GetPlayerType();
+    const conversionHeartSubType = characterHealthReplacementMap.get(character);
+    if (conversionHeartSubType === undefined) {
+        return;
+    }
+    convertRedHeartContainers(player, conversionHeartSubType);
+    removeRedHearts(player);
+}
+function convertRedHeartContainers(player, heartSubType) {
+    const maxHearts = player.GetMaxHearts();
+    if (maxHearts === 0) {
+        return;
+    }
+    player.AddMaxHearts(maxHearts * -1, false);
+    switch (heartSubType) {
+        case HeartSubType.SOUL: {
+            player.AddSoulHearts(maxHearts);
+            break;
+        }
+        case HeartSubType.BLACK: {
+            player.AddBlackHearts(maxHearts);
+            break;
+        }
+    }
+}
+/**
+ * We also have to check for normal red hearts, so that the player is not able to fill bone hearts
+ * (by e.g. picking up a healing item like Breakfast).
+ */
+function removeRedHearts(player) {
+    const hearts = player.GetHearts();
+    if (hearts > 0) {
+        player.AddHearts(hearts * -1);
+    }
+}
+// ModCallback.PRE_PICKUP_COLLISION (38)
+// PickupVariant.HEART (10)
+function prePickupCollisionHeart(pickup, collider) {
+    if (!isRedHeart(pickup)) {
+        return undefined;
+    }
+    const player = collider.ToPlayer();
+    if (player === undefined) {
+        return undefined;
+    }
+    const character = player.GetPlayerType();
+    const conversionHeartSubType = characterHealthReplacementMap.get(character);
+    if (conversionHeartSubType === undefined) {
+        return undefined;
+    }
+    // Prevent internal code from running, which will prevent the player from picking up the heart,
+    // but will still allow the heart to bounce off of the player.
+    return false;
+}
+/**
+ * Helper function to make a character that has the same health mechanic as Blue Baby (red heart
+ * containers --> soul hearts) or Dark Judas (red heart containers --> black hearts).
+ *
+ * Call this function once at the beginning of your mod to declare the health conversion type.
+ */
+export function registerCharacterHealthConversion(playerType, conversionHeartSubType) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    if (characterHealthReplacementMap.has(playerType)) {
+        error(`Failed to register a character of type ${playerType} because there is already an existing registered character with that type.`);
+    }
+    characterHealthReplacementMap.set(playerType, conversionHeartSubType);
+}
+//# sourceMappingURL=characterHealthConversion.js.map

package/dist/features/characterHealthConversion.js.map

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

package/dist/features/characterHealthConversion.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/features/characterHealthConversion.ts"],"names":[],"mappings":";;;;MAoCS,mBAWA,2BA4BA,iBASA,yBAhEH;AAbN,6CAKO;AAJL;AACA;AACA;AAGF,gCAA8C;AAArC;AACT,oBAA2B;AAAlB;AAsBT,SAAS,wBAAkB;AACnB,sBAAY,OAAO;AACnB,mCAAyB,8BAA8B,IAAI;OAC7D;AACF;;IAGF,+BAA0B,QAAQ;IAClC,qBAAgB;;AAGlB,SAAS,gCACP,QACA;AAEM,sBAAY,OAAO;OACrB,aAAc;AAChB;;IAGF,OAAO,aAAa,aAAa,GAAG;;4BAE5B;yCACD;;;gBACH,OAAO,cAAc;AACrB;;;gDAGG;;;gBACH,OAAO,eAAe;AACtB;;;;;AASN,SAAS,sBAAgB;AACjB,mBAAS,OAAO;OAClB,SAAS;QACX,OAAO,UAAU,UAAU;;;AAM/B,SAAS,8BAAwB,QAAsB;WAChD,gBAAW;AACd;;AAGI,mBAAS,SAAS;OACpB;AACF;;AAGI,sBAAY,OAAO;AACnB,mCAAyB,8BAA8B,IAAI;OAC7D;AACF;;AAKF,WAAO;;AAtFH,qBAAe;AAIf,gCAAgC,UAAI;;;AAM1C,yDAA8C;IAC5C,IAAI,YAAY,iCAAiC;IACjD,IAAI,YACF,kCACA,yBACA;AALJ;;;;;AAqFA,6DACE,YACA;IAEA,mCAA8B;OAE1B,8BAA8B,IAAI;QACpC,OACE,sDAA0C,gBAAU;;IAIxD,8BAA8B,IAAI,YAAY;AAZhD","file":"characterHealthConversion.lua","sourceRoot":"../src/"}

package/dist/features/characterStats.js

@@ -0,0 +1,52 @@
+/**
+ * Easily create custom characters that have base stats different from that of Isaac.
+ *
+ * @module
+ */
+import { ModCallback, } from "isaac-typescript-definitions";
+import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
+import { getDefaultPlayerStat } from "../functions/cacheFlag";
+import { addStat } from "../functions/player";
+const FEATURE_NAME = "characterStats";
+const charactersStatMap = new Map();
+/** @internal */
+export function characterStatsInit(mod) {
+    mod.AddCallback(ModCallback.EVALUATE_CACHE, evaluateCache); // 8
+}
+// ModCallback.EVALUATE_CACHE (8)
+function evaluateCache(player, cacheFlag) {
+    const character = player.GetPlayerType();
+    const statMap = charactersStatMap.get(character);
+    if (statMap === undefined) {
+        return;
+    }
+    const stat = statMap.get(cacheFlag);
+    const defaultStat = getDefaultPlayerStat(cacheFlag);
+    if (stat === undefined || defaultStat === undefined) {
+        return;
+    }
+    const delta = stat - defaultStat;
+    addStat(player, cacheFlag, delta);
+}
+/**
+ * Helper function to manage the stats for a vanilla or custom character. Call this function once at
+ * the beginning of your mod to declare the starting stats.
+ *
+ * You must provide this function with a map of CacheFlag to the default stat amount. For example,
+ * the default amount of damage is 3.5. To make a custom character start with 4.5 damage:
+ *
+ * ```ts
+ * const fooDefaultStats = new Map<CacheFlag, number>([
+ *   [CacheFlag.DAMAGE, 4.5],
+ * ])
+ * registerCharacterStats(PlayerTypeCustom.FOO, fooDefaultStats);
+ * ```
+ *
+ * Note that the format for the `CacheFlag.FIRE_DELAY` value should be in the tears stat format, not
+ * the `MaxFireDelay` format.
+ */
+export function registerCharacterStats(playerType, statMap) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    charactersStatMap.set(playerType, statMap);
+}
+//# sourceMappingURL=characterStats.js.map

package/dist/features/characterStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterStats.js","sourceRoot":"../src/","sources":["features/characterStats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,WAAW,GAEZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAGtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEzD,gBAAgB;AAChB,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IACzC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI;AAClE,CAAC;AAED,iCAAiC;AACjC,SAAS,aAAa,CAAC,MAAoB,EAAE,SAAoB;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,SAAS,EAAE;QACzB,OAAO;KACR;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE;QACnD,OAAO;KACR;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,WAAW,CAAC;IAEjC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAsB,EACtB,OAAgE;IAEhE,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC5C,iBAAiB,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/features/characterStats.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/features/characterStats.ts"],"names":[],"mappings":";;;;MA0BS,eARH;AAZN,6CAIO;AAFL;AAGF,gCAA8C;AAArC;AACT,sBAAqC;AAA5B;AACT,mBAAwB;AAAf;AAaT,SAAS,oBAAc,QAAsB;AACrC,sBAAY,OAAO;AACnB,oBAAU,kBAAkB,IAAI;OAClC;AACF;;AAGI,iBAAO,QAAQ,IAAI;AACnB,wBAAc,0BAAqB;OACrC,eAAsB;AACxB;;AAEI,kBAAQ,OAAO;IAErB,aAAQ,QAAQ,WAAW;;AAzBvB,qBAAe;AAGf,oBAAoB,UAAI;;;AAG9B,8CAAmC;IACjC,IAAI,YAAY,4BAA4B;AAD9C;;;;;;;;;;;;;;;;AAuCA,kDACE,YACA;IAEA,mCAA8B;IAC9B,kBAAkB,IAAI,YAAY;AALpC","file":"characterStats.lua","sourceRoot":"../src/"}

package/dist/features/collectibleItemPoolType.js

@@ -0,0 +1,45 @@
+// The item pool type of a collectible is not stored on the collectible. Thus, we scan for incoming
+// item pool types in the PreGetCollectible callback, and then assume that the next spawned
+// collectible has this item pool type.
+import { ModCallback, PickupVariant, } from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
+import { getEntityID } from "../functions/entity";
+import { isCollectible } from "../functions/pickupVariants";
+import { getRoomItemPoolType } from "../functions/rooms";
+import { saveDataManager } from "./saveDataManager/exports";
+const FEATURE_NAME = "collectibleItemPoolType";
+const v = {
+    run: {
+        collectibleItemPoolTypeMap: new Map(),
+    },
+};
+/** @internal */
+export function collectibleItemPoolTypeInit(mod) {
+    saveDataManager(FEATURE_NAME, v);
+    mod.AddCallback(ModCallback.POST_PICKUP_INIT, postPickupInitCollectible, PickupVariant.COLLECTIBLE); // 34
+}
+// ModCallback.POST_PICKUP_INIT (34)
+// PickupVariant.COLLECTIBLE (100)
+function postPickupInitCollectible(pickup) {
+    const itemPool = game.GetItemPool();
+    const ptrHash = GetPtrHash(pickup);
+    const lastItemPoolType = itemPool.GetLastPool();
+    v.run.collectibleItemPoolTypeMap.set(ptrHash, lastItemPoolType);
+}
+/**
+ * Helper function to get the item pool type that a given collectible came from. Since there is no
+ * native method in the API to get this, we listen in the PreGetCollectible callback for item pool
+ * types, and then assume that the next spawned collectible will match.
+ */
+export function getCollectibleItemPoolType(collectible) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "getCollectibleItemPoolType" function was given a non-collectible: ${entityID}`);
+    }
+    const ptrHash = GetPtrHash(collectible);
+    const itemPoolType = v.run.collectibleItemPoolTypeMap.get(ptrHash);
+    return itemPoolType === undefined ? getRoomItemPoolType() : itemPoolType;
+}
+//# sourceMappingURL=collectibleItemPoolType.js.map

package/dist/features/collectibleItemPoolType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectibleItemPoolType.js","sourceRoot":"../src/","sources":["features/collectibleItemPoolType.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,2FAA2F;AAC3F,uCAAuC;AAEvC,OAAO,EAEL,WAAW,EACX,aAAa,GACd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C,MAAM,CAAC,GAAG;IACR,GAAG,EAAE;QACH,0BAA0B,EAAE,IAAI,GAAG,EAAyB;KAC7D;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,UAAU,2BAA2B,CAAC,GAAQ;IAClD,eAAe,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAEjC,GAAG,CAAC,WAAW,CACb,WAAW,CAAC,gBAAgB,EAC5B,yBAAyB,EACzB,aAAa,CAAC,WAAW,CAC1B,CAAC,CAAC,KAAK;AACV,CAAC;AAED,oCAAoC;AACpC,kCAAkC;AAClC,SAAS,yBAAyB,CAAC,MAAoB;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEhD,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,WAAyB;IAEzB,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE;QAC/B,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QAC1C,KAAK,CACH,0EAA0E,QAAQ,EAAE,CACrF,CAAC;KACH;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,OAAO,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;AAC3E,CAAC"}

package/dist/features/collectibleItemPoolType.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/features/collectibleItemPoolType.ts"],"names":[],"mappings":";;;;MAqCS,2BAnBH;AAdN,6CAIO;AAFL;AACA;AAEF,0BAAqB;AAAZ;AACT,gCAA8C;AAArC;AACT,mBAA4B;AAAnB;AACT,2BAA8B;AAArB;AACT,kBAAoC;AAA3B;AACT,oBAAgC;AAAvB;AAuBT,SAAS,gCAA0B;AAC3B,qBAAW,KAAK;AAChB,oBAAU,WAAW;AACrB,6BAAmB,SAAS;IAElC,iCAAiC,IAAI,SAAS;;AA1B1C,qBAAe;AAEf,IAAI,CACR,MAAK,CACH,6BAA4B,UAAI;;;AAKpC,uDAA4C;IAC1C,qBAAgB,cAAc;IAE9B,IAAI,YACF,8BACA,2BACA;AANJ;;;;AAyBA,sDACE;IAEA,mCAA8B;WAEzB,mBAAc;AACX,yBAAW,iBAAY;QAC7B,MACE,+EAA0E;;AAIxE,oBAAU,WAAW;AACrB,yBAAe,iCAAiC,IAAI;AAC1D,WAAO,wBAA6B,4BAAwB;AAd9D","file":"collectibleItemPoolType.lua","sourceRoot":"../src/"}

package/dist/features/customGridEntity.js

@@ -0,0 +1,148 @@
+import { GridEntityType, } from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { DefaultMap } from "../classes/DefaultMap";
+import { DecorationVariant } from "../enums/DecorationVariant";
+import { ModCallbackCustom } from "../enums/ModCallbackCustom";
+import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
+import { removeGrid, spawnGridWithVariant } from "../functions/gridEntity";
+import { getRoomListIndex } from "../functions/roomData";
+import { isVector } from "../functions/vector";
+import { saveDataManager } from "./saveDataManager/exports";
+const FEATURE_NAME = "customGridEntity";
+const v = {
+    level: {
+        /** Indexed by room list index and grid index. */
+        customGridEntities: new DefaultMap(() => new Map()),
+    },
+};
+/** @internal */
+export function customGridEntityInit(mod) {
+    saveDataManager(FEATURE_NAME, v);
+    mod.AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered);
+}
+// ModCallbackCustom.POST_NEW_ROOM_REORDERED
+function postNewRoomReordered() {
+    // When we re-enter a room, the graphics for any custom entities will be reverted back to that of
+    // a normal decoration. Thus, we must re-apply the anm2.
+    const roomListIndex = getRoomListIndex();
+    const roomCustomGridEntities = v.level.customGridEntities.get(roomListIndex);
+    if (roomCustomGridEntities === undefined) {
+        return;
+    }
+    const room = game.GetRoom();
+    for (const [gridIndex, data] of roomCustomGridEntities.entries()) {
+        const decoration = room.GetGridEntity(gridIndex);
+        if (decoration === undefined) {
+            roomCustomGridEntities.delete(gridIndex);
+            continue;
+        }
+        const sprite = decoration.GetSprite();
+        sprite.Load(data.anm2, true);
+        sprite.Play(data.defaultAnimation, true);
+    }
+}
+/**
+ * Helper function to spawn a custom grid entity.
+ *
+ * This is an IsaacScript feature because the vanilla game does not support any custom grid
+ * entities. Under the hood, IsaacScript accomplishes this by using decorations with an arbitrary
+ * non-zero variant to represent custom grid entities.
+ *
+ * Once a custom grid entity is spawned, you can take advantage of the custom grid callbacks such as
+ * `POST_GRID_ENTITY_CUSTOM_UPDATE`.
+ *
+ * @param gridEntityTypeCustom An integer that identifies what kind of grid entity you are creating.
+ *                             It should correspond to a local enum value in your mod. The integer
+ *                             can be any unique value and will not correspond to the actual grid
+ *                             entity type used. (This integer is used in the various custom grid
+ *                             entity callbacks.)
+ * @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
+ *                            entity at. If a position is specified, the closest grid index will be
+ *                            used.
+ * @param anm2 The path to the ANM2 file to use for the sprite.
+ * @param defaultAnimation The name of the animation to play after the sprite is initialized and
+ *                         after the player re-enters a room with this grid entity in it.
+ * @param gridCollisionClass The collision class that you want the custom grid entity to have.
+ */
+export function spawnCustomGrid(gridEntityTypeCustom, gridIndexOrPosition, anm2, defaultAnimation, gridCollisionClass) {
+    errorIfFeaturesNotInitialized(FEATURE_NAME);
+    const room = game.GetRoom();
+    const roomListIndex = getRoomListIndex();
+    const gridIndex = isVector(gridIndexOrPosition)
+        ? room.GetGridIndex(gridIndexOrPosition)
+        : gridIndexOrPosition;
+    const existingGridEntity = room.GetGridEntity(gridIndex);
+    const isExistingDecoration = existingGridEntity !== undefined &&
+        existingGridEntity.GetType() === GridEntityType.DECORATION &&
+        existingGridEntity.GetVariant() ===
+            DecorationVariant.CUSTOM_GRID_ENTITY;
+    const decoration = isExistingDecoration
+        ? existingGridEntity
+        : spawnGridWithVariant(GridEntityType.DECORATION, DecorationVariant.CUSTOM_GRID_ENTITY, gridIndexOrPosition);
+    if (decoration === undefined) {
+        error("Failed to spawn a decoration for a custom grid entity.");
+    }
+    const sprite = decoration.GetSprite();
+    sprite.Load(anm2, true);
+    sprite.Play(defaultAnimation, true);
+    const customGridEntityData = {
+        gridEntityTypeCustom,
+        roomListIndex,
+        gridIndex,
+        anm2,
+        defaultAnimation,
+        gridCollisionClass,
+    };
+    const roomCustomGridEntities = v.level.customGridEntities.getAndSetDefault(roomListIndex);
+    roomCustomGridEntities.set(gridIndex, customGridEntityData);
+    return decoration;
+}
+/**
+ * Helper function to remove a custom grid entity created by the `spawnCustomGrid` function.
+ *
+ * @param gridIndexOrPositionOrGridEntity You can specify the custom grid entity to remove by
+ *                                 providing the grid index, the room position, or the grid entity
+ *                                 itself.
+ * @param updateRoom Optional. Whether or not to update the room after the grid entity is removed.
+ *                   Default is true. This is generally a good idea because if the room is not
+ *                   updated, you will be unable to spawn another grid entity on the same tile until
+ *                   a frame has passed. However, doing this is expensive, since it involves a call
+ *                   to `Isaac.GetRoomEntities`, so set it to false if you need to invoke this
+ *                   function multiple times.
+ * @returns The grid entity that was removed. Returns undefined if no grid entity was found at the
+ *          given location or if the given grid entity was not a custom grid entity.
+ */
+export function removeCustomGrid(gridIndexOrPositionOrGridEntity, updateRoom = true) {
+    const room = game.GetRoom();
+    const roomListIndex = getRoomListIndex();
+    let decoration;
+    if (typeof gridIndexOrPositionOrGridEntity === "number") {
+        const gridIndex = gridIndexOrPositionOrGridEntity;
+        const gridEntity = room.GetGridEntity(gridIndex);
+        if (gridEntity === undefined) {
+            return undefined;
+        }
+        decoration = gridEntity;
+    }
+    else if (isVector(gridIndexOrPositionOrGridEntity)) {
+        const position = gridIndexOrPositionOrGridEntity;
+        const gridEntity = room.GetGridEntityFromPos(position);
+        if (gridEntity === undefined) {
+            return undefined;
+        }
+        decoration = gridEntity;
+    }
+    else {
+        decoration = gridIndexOrPositionOrGridEntity;
+    }
+    const gridIndex = decoration.GetGridIndex();
+    const roomCustomGridEntities = v.level.customGridEntities.getAndSetDefault(roomListIndex);
+    const exists = roomCustomGridEntities.has(gridIndex);
+    if (!exists) {
+        return undefined;
+    }
+    roomCustomGridEntities.delete(gridIndex);
+    removeGrid(decoration, updateRoom);
+    return decoration;
+}
+//# sourceMappingURL=customGridEntity.js.map

package/dist/features/customGridEntity.js.map

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

package/dist/features/customGridEntity.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/features/customGridEntity.ts"],"names":[],"mappings":";;;;;MAsCS,sBApBH;AAlBN,6CAGO;AADL;AAEF,0BAAqB;AAAZ;AACT,uBAA2B;AAAlB;AAET,8BAAkC;AAAzB;AACT,8BAAkC;AAAzB;AACT,gCAA8C;AAArC;AACT,uBAAiD;AAAxC;AAAY;AACrB,qBAAiC;AAAxB;AACT,mBAAyB;AAAhB;AAET,oBAAgC;AAAvB;AAwBT,SAAS;AAGD,0BAAgB;AAChB,mCAAyB,2BAA2B,IAAI;OAC1D;AACF;;AAGI,iBAAO,KAAK;AAClB,2BAAgC,sCAAuB;cAA3C;cAAW;;AACf,+BAAa,KAAK,cAAc;eAClC;gBACF,uBAAuB,OAAO;AAC9B;;AAGI,2BAAS,WAAW;YAC1B,OAAO,KAAK,WAAW;YACvB,OAAO,KAAK,uBAAuB;;;;;AAzCjC,qBAAe;AAEf,IAAI,CACR,QAAO,CAEL,qBAAoB;IAAI;IACtB,WAAM,iBAAI,IAAV;;;;AAMN,gDAAqC;IACnC,qBAAgB,cAAc;IAE9B,IAAI,kBACF,2CACA;AALJ;;;;;;;;;;;;;;;;;;;;;;AAwDA,2CACE,sBACA,qBACA,MACA,kBACA;IAEA,mCAA8B;AAExB,iBAAO,KAAK;AACZ,0BAAgB;AAChB,sBAAY,cAAS,yBACvB,KAAK,aAAa,wBAClB;AAEE,+BAAqB,KAAK,cAAc;AACxC,iCACJ,8BACA,mBAAmB,aAAc,8BACjC,mBAAmB,gBAChB;AACC,uBAAa,yBACf,sBACA,0BACE,2BACA,sCACA;OAEF;QACF,MAAM;;AAGF,mBAAS,WAAW;IAC1B,OAAO,KAAK,MAAM;IAClB,OAAO,KAAK,kBAAkB;AAExB,iCAA6C;QACjD;QACA;QACA;QACA;QACA;QACA;;AAGI,mCACJ,2BAA2B,iBAAiB;IAC9C,uBAAuB,IAAI,WAAW;AAEtC,WAAO;AAjDT;;;;;;;;;;;;;;AAmEA,4CACE,iCACA;OAAA;QAAA,aAAa;;AAEP,iBAAO,KAAK;AACZ,0BAAgB;AAElB;OACA,KAAO,oCAAoC;AACvC,0BAAY;AACZ,2BAAa,KAAK,cAAc;WAClC;AACF;;AAGF,qBAAa;WACJ,cAAS;AACZ,yBAAW;AACX,2BAAa,KAAK,qBAAqB;WACzC;AACF;;AAGF,qBAAa;;AAEb,qBAAa;;AAGT,sBAAY,WAAW;AACvB,mCACJ,2BAA2B,iBAAiB;AACxC,mBAAS,uBAAuB,IAAI;WACrC;AACH;;IAGF,uBAAuB,OAAO;IAC9B,gBAAW,YAAY;AAEvB,WAAO;AAvCT","file":"customGridEntity.lua","sourceRoot":"../src/"}