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

package/dist/functions/run.js

@@ -0,0 +1,53 @@
+import { Challenge, PlayerType } from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { FIRST_CHARACTER } from "../constantsFirstLast";
+import { log } from "./log";
+/**
+ * Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
+ * pressing tab on the character selection screen). When the player resets the game on a set seed,
+ * the game will not switch to a different seed.
+ */
+export function onSetSeed() {
+    const seeds = game.GetSeeds();
+    const customRun = seeds.IsCustomRun();
+    const challenge = Isaac.GetChallenge();
+    return challenge === Challenge.NULL && customRun;
+}
+/**
+ * Helper function to restart the run using the console command of "restart". If the player is
+ * playing a seeded run, then it will restart the game to the beginning of the seed. Otherwise, it
+ * will put the player on a run with an entirely new seed.
+ *
+ * You can optionally specify a `PlayerType` to restart the game as that character.
+ */
+export function restart(character) {
+    if (character === undefined) {
+        const command = "restart";
+        log(`Restarting the run with a console command of: ${command}`);
+        Isaac.ExecuteCommand(command);
+        return;
+    }
+    if (character < FIRST_CHARACTER) {
+        error(`Restarting as a character of ${character} would crash the game.`);
+    }
+    const command = `restart ${character}`;
+    log(`Restarting the run as PlayerType.${PlayerType[character]} (${character}) with a console command of: ${command}`);
+    Isaac.ExecuteCommand(command);
+}
+/**
+ * Helper function to change the run status to that of an unseeded run with a new random seed.
+ *
+ * This is useful to revert the behavior where playing on a set and restarting the game will not
+ * take you to a new seed.
+ */
+export function setUnseeded() {
+    const seeds = game.GetSeeds();
+    // Invoking the `Seeds.Reset` method will cause the start seed to be set to 0. Subsequently, the
+    // `Seeds.GetStartSeed` method will return 0, and can cause crashes (due to RNG objects not being
+    // able to handle a seed of 0). It also causes the log to be spammed with: "[ASSERT] - Error: Game
+    // Start Seed was not set." Thus, we must immediately re-initialize the game start seed by using
+    // the `Seeds.Restart` method.
+    seeds.Reset();
+    seeds.Restart(Challenge.NULL);
+}
+//# sourceMappingURL=run.js.map

package/dist/functions/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"../src/","sources":["functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IAEvC,OAAO,SAAS,KAAK,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,SAAsB;IAC5C,IAAI,SAAS,KAAK,SAAS,EAAE;QAC3B,MAAM,OAAO,GAAG,SAAS,CAAC;QAC1B,GAAG,CAAC,iDAAiD,OAAO,EAAE,CAAC,CAAC;QAChE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO;KACR;IAED,IAAI,SAAS,GAAG,eAAe,EAAE;QAC/B,KAAK,CAAC,gCAAgC,SAAS,wBAAwB,CAAC,CAAC;KAC1E;IAED,MAAM,OAAO,GAAG,WAAW,SAAS,EAAE,CAAC;IACvC,GAAG,CACD,oCAAoC,UAAU,CAAC,SAAS,CAAC,KAAK,SAAS,gCAAgC,OAAO,EAAE,CACjH,CAAC;IACF,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAE9B,gGAAgG;IAChG,iGAAiG;IACjG,kGAAkG;IAClG,gGAAgG;IAChG,8BAA8B;IAC9B,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/functions/run.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/run.ts"],"names":[],"mappings":";AAAA,6CAAsC;AAA7B;AAAW;AACpB,0BAAqB;AAAZ;AACT,+BAAgC;AAAvB;AACT,gBAAoB;AAAX;;;;AAOT;AACQ,kBAAQ,KAAK;AACb,sBAAY,MAAM;AAClB,sBAAY;AAElB,WAAO,aAAc,mBAAkB;AALzC;;;;;;AAeA,mCAAwB;OAClB;AACI,wBAAU;QAChB,IAAI,oDAAiD;QACrD,qBAAqB;AACrB;;OAGE,YAAY;QACd,OAAM,4CAAgC,eAAS;;AAG3C,oBAAU,uBAAW;IAC3B,QACE,gDAAoC,WAAW,gBAAU,kBAAK,eAAS,oCAAgC;IAEzG,qBAAqB;AAhBvB;;;;;AAyBA;AACQ,kBAAQ,KAAK;IAOnB,MAAM;IACN,MAAM,QAAQ;AAThB","file":"run.lua","sourceRoot":"../src/"}

package/dist/functions/saveFile.js

@@ -0,0 +1,104 @@
+import { CollectibleType, PlayerType, TrinketType, } from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { getCollectibleSet } from "./collectibleSet";
+import { anyPlayerHasCollectible, getPlayersOfType } from "./player";
+import { mapGetPlayer, mapSetPlayer } from "./playerDataStructures";
+import { getPlayers } from "./playerIndex";
+import { repeat } from "./utils";
+const COLLECTIBLES_THAT_AFFECT_ITEM_POOLS = [
+    CollectibleType.CHAOS,
+    CollectibleType.SACRED_ORB,
+    CollectibleType.TMTRAINER, // 721
+];
+const TRINKETS_THAT_AFFECT_ITEM_POOLS = [
+    TrinketType.NO,
+];
+/**
+ * Helper function to see if the given collectible is unlocked on the player's save file. This
+ * requires providing the corresponding item pool that the collectible is located in.
+ *
+ * - If any player currently has the item, then it is assumed to be unlocked. (This is because Eden
+ *   may have randomly started with the provided collectible, and it will be subsequently removed
+ *   from all pools.)
+ * - If the collectible is located in more than one item pool, then any item pool can be provided.
+ * - If the collectible is not located in any item pools, then this function will always return
+ *   false.
+ * - If any player is Tainted Lost, they will be temporarily changed to Isaac and then temporarily
+ *   changed back (because Tainted Lost is not able to retrieve some collectibles from item pools).
+ */
+export function isCollectibleUnlocked(collectibleTypeToCheckFor, itemPoolToCheckFor) {
+    // If Eden is holding this collectible, then it is obviously unlocked (and it will also be removed
+    // from pools, so the below check won't work).
+    if (anyPlayerHasCollectible(collectibleTypeToCheckFor)) {
+        return true;
+    }
+    // On Tainted Lost, it is impossible to retrieve non-offensive collectibles from pools, so we
+    // temporarily change the character to Isaac.
+    const taintedLosts = getPlayersOfType(PlayerType.THE_LOST_B);
+    for (const player of taintedLosts) {
+        player.ChangePlayerType(PlayerType.ISAAC);
+    }
+    // Before checking the item pools, remove any collectibles or trinkets that affect retrieved
+    // collectible types.
+    const removedItemsMap = new Map();
+    const removedTrinketsMap = new Map();
+    for (const player of getPlayers()) {
+        const removedItems = [];
+        for (const itemToRemove of COLLECTIBLES_THAT_AFFECT_ITEM_POOLS) {
+            if (player.HasCollectible(itemToRemove)) {
+                const numCollectibles = player.GetCollectibleNum(itemToRemove);
+                repeat(numCollectibles, () => {
+                    player.RemoveCollectible(itemToRemove);
+                    removedItems.push(itemToRemove);
+                });
+            }
+        }
+        mapSetPlayer(removedItemsMap, player, removedItems);
+        const removedTrinkets = [];
+        for (const trinketToRemove of TRINKETS_THAT_AFFECT_ITEM_POOLS) {
+            if (player.HasTrinket(trinketToRemove)) {
+                const numTrinkets = player.GetTrinketMultiplier(trinketToRemove);
+                repeat(numTrinkets, () => {
+                    player.TryRemoveTrinket(trinketToRemove);
+                    removedTrinkets.push(trinketToRemove);
+                });
+            }
+        }
+        mapSetPlayer(removedTrinketsMap, player, removedTrinkets);
+    }
+    // Blacklist every collectible in the game except for the provided collectible.
+    const itemPool = game.GetItemPool();
+    const collectibleSet = getCollectibleSet();
+    for (const collectibleType of collectibleSet.values()) {
+        if (collectibleType !== collectibleTypeToCheckFor) {
+            itemPool.AddRoomBlacklist(collectibleType);
+        }
+    }
+    // Get a collectible from the pool and see if it is the intended collectible. (We can use any
+    // arbitrary value as the seed since it should not influence the result.)
+    const retrievedCollectibleType = itemPool.GetCollectible(itemPoolToCheckFor, false, 1);
+    const collectibleUnlocked = retrievedCollectibleType === collectibleTypeToCheckFor;
+    // Reset the blacklist
+    itemPool.ResetRoomBlacklist();
+    // Give back items/trinkets, if necessary.
+    for (const player of getPlayers()) {
+        const removedItems = mapGetPlayer(removedItemsMap, player);
+        if (removedItems !== undefined) {
+            for (const collectibleType of removedItems) {
+                player.AddCollectible(collectibleType, 0, false); // Prevent Chaos from spawning pickups
+            }
+        }
+        const removedTrinkets = mapGetPlayer(removedTrinketsMap, player);
+        if (removedTrinkets !== undefined) {
+            for (const trinketType of removedTrinkets) {
+                player.AddTrinket(trinketType, false);
+            }
+        }
+    }
+    // Change any players back to Tainted Lost, if necessary.
+    for (const player of taintedLosts) {
+        player.ChangePlayerType(PlayerType.THE_LOST_B);
+    }
+    return collectibleUnlocked;
+}
+//# sourceMappingURL=saveFile.js.map

package/dist/functions/saveFile.js.map

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

package/dist/functions/saveFile.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/saveFile.ts"],"names":["repeat"],"mappings":";;;;;AAAA,6CAKO;AAJL;AAEA;AACA;AAEF,0BAAqB;AAAZ;AAET,2BAAkC;AAAzB;AACT,mBAA0D;AAAjD;AAAyB;AAClC,iCAA2C;AAAlC;AAAc;AACvB,wBAA2B;AAAlB;AACT,kBAAuB;AAAd,MAAAA;AAEH,4CAAkE,CACtE,uBACA,4BACA;AAGI,wCAA0D,CAC9D;;;;;;;;;;;;AAgBF,iDACE,2BACA;OAII,6BAAwB;AAC1B,eAAO;;AAKH,yBAAe,sBAAiB;AACtC,cAAW,iBAAU;QACnB,OAAO,iBAAiB;;AAKpB,4BAAkB,UAAI;AACtB,+BAAqB,UAAI;AAC/B,cAAW,iBAAU;AACb,6BAAkC;AACxC,kBAAW,uBAAgB;eACrB,OAAO,eAAe;AAClB,wCAAkB,OAAO,kBAAkB;gBACjD,AAAAA;;oBAAO;oBAAiB;wBACtB,OAAO,kBAAkB;AACzB,0DAAkB;oBAFI;;;;QAO5B,kBAAa,iBAAiB,QAAQ;AAEhC,gCAAiC;AACvC,kBAAW,0BAAmB;eACxB,OAAO,WAAW;AACd,oCAAc,OAAO,qBAAqB;gBAChD,AAAAA;;oBAAO;oBAAa;wBAClB,OAAO,iBAAiB;AACxB,gEAAqB;oBAFH;;;;QAOxB,kBAAa,oBAAoB,QAAQ;;AAIrC,qBAAW,KAAK;AAChB,2BAAiB;AACvB,cAAW,mBAAmB,8BAAe;WACvC,mBAAoB;YACtB,SAAS,iBAAiB;;;AAMxB,qCAA2B,SAAS,eACxC,oBACA,OACA;AAGI,gCACJ,4BAA6B;IAG/B,SAAS;AAGT,cAAW,iBAAU;AACb,6BAAe,kBAAa,iBAAiB;WAC/C;AACF,sBAAW,0BAAmB;gBAC5B,OAAO,eAAe,iBAAiB,GAAG;;;AAIxC,gCAAkB,kBAAa,oBAAoB;WACrD;AACF,sBAAW,sBAAe;gBACxB,OAAO,WAAW,aAAa;;;;AAMrC,cAAW,iBAAU;QACnB,OAAO,iBAAiB;;AAG1B,WAAO;AA9FT","file":"saveFile.lua","sourceRoot":"../src/"}

package/dist/functions/seeds.js

@@ -0,0 +1,18 @@
+import { game } from "../cachedClasses";
+import { newRNG } from "./rng";
+/** Alias for the `Seeds.GetStartSeedString` method. */
+export function getStartSeedString() {
+    const seeds = game.GetSeeds();
+    return seeds.GetStartSeedString();
+}
+/**
+ * Helper function to get the next seed value.
+ *
+ * This function is useful when you are working with seed values directly over RNG objects.
+ */
+export function nextSeed(seed) {
+    const rng = newRNG(seed);
+    rng.Next();
+    return rng.GetSeed();
+}
+//# sourceMappingURL=seeds.js.map

package/dist/functions/seeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.js","sourceRoot":"../src/","sources":["functions/seeds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,uDAAuD;AACvD,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,OAAO,KAAK,CAAC,kBAAkB,EAAE,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAU;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;AACvB,CAAC"}

package/dist/functions/seeds.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/seeds.ts"],"names":[],"mappings":";AAAA,0BAAqB;AAAZ;AACT,gBAAuB;AAAd;;AAGT;AACQ,kBAAQ,KAAK;AACnB,WAAO,MAAM;AAFf;;;;AAUA,oCAAyB;AACjB,gBAAM,YAAO;IACnB,IAAI;AACJ,WAAO,IAAI;AAHb","file":"seeds.lua","sourceRoot":"../src/"}

package/dist/functions/serialization.js

@@ -0,0 +1,52 @@
+import { SerializationType } from "../enums/SerializationType";
+import { ISAAC_API_CLASS_TYPE_TO_BRAND } from "../objects/isaacAPIClassTypeToBrand";
+import { ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION } from "../objects/isaacAPIClassTypeToCopyFunction";
+import { SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION } from "../objects/serializedIsaacAPIClassTypeToIdentityFunction";
+import { getIsaacAPIClassName } from "./isaacAPIClass";
+import { isTable, isUserdata } from "./types";
+export function copyIsaacAPIClass(isaacAPIClass, serializationType) {
+    if (!isUserdata(isaacAPIClass)) {
+        error(`Failed to copy an Isaac API class since the provided object was of type: ${typeof isaacAPIClass}`);
+    }
+    const isaacAPIClassType = getIsaacAPIClassName(isaacAPIClass);
+    if (isaacAPIClassType === undefined) {
+        error("Failed to copy an Isaac API class since it does not have a class type.");
+    }
+    const copyableIsaacAPIClassType = isaacAPIClassType;
+    const copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[copyableIsaacAPIClassType];
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (copyFunction === undefined) {
+        error(`Failed to copy Isaac API class "${copyableIsaacAPIClassType}" since there is not a defined copy function for this class type.`);
+    }
+    return copyFunction(isaacAPIClass, serializationType);
+}
+/**
+ * Deserialization is a special case, so we make a dedicated function for this.
+ *
+ * There is no need for a corresponding "serializeIsaacAPIClass" function because the
+ * "copyIsaacAPIClass" function can handle all serialization types.
+ */
+export function deserializeIsaacAPIClass(serializedIsaacAPIClass) {
+    if (!isTable(serializedIsaacAPIClass)) {
+        error(`Failed to deserialize an Isaac API class since the provided object was of type: ${typeof serializedIsaacAPIClass}`);
+    }
+    const copyableIsaacAPIClassType = getSerializedTableType(serializedIsaacAPIClass);
+    if (copyableIsaacAPIClassType === undefined) {
+        error("Failed to deserialize an API class since a valid class type brand was not found.");
+    }
+    const copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[copyableIsaacAPIClassType];
+    return copyFunction(serializedIsaacAPIClass, SerializationType.DESERIALIZE);
+}
+function getSerializedTableType(serializedIsaacAPIClass) {
+    for (const [copyableIsaacAPIClassType, serializationBrand] of Object.entries(ISAAC_API_CLASS_TYPE_TO_BRAND)) {
+        if (serializedIsaacAPIClass.has(serializationBrand)) {
+            return copyableIsaacAPIClassType;
+        }
+    }
+    return undefined;
+}
+export function isSerializedIsaacAPIClass(object) {
+    const identityFunctions = Object.values(SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION);
+    return identityFunctions.some((identityFunction) => identityFunction(object));
+}
+//# sourceMappingURL=serialization.js.map

package/dist/functions/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"../src/","sources":["functions/serialization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,qCAAqC,EAAE,MAAM,4CAA4C,CAAC;AACnG,OAAO,EAAE,oDAAoD,EAAE,MAAM,0DAA0D,CAAC;AAEhI,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,UAAU,iBAAiB,CAC/B,aAAsB,EACtB,iBAAoC;IAEpC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;QAC9B,KAAK,CACH,4EAA4E,OAAO,aAAa,EAAE,CACnG,CAAC;KACH;IAED,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,iBAAiB,KAAK,SAAS,EAAE;QACnC,KAAK,CACH,wEAAwE,CACzE,CAAC;KACH;IAED,MAAM,yBAAyB,GAC7B,iBAA8C,CAAC;IACjD,MAAM,YAAY,GAChB,qCAAqC,CAAC,yBAAyB,CAAC,CAAC;IACnE,uEAAuE;IACvE,IAAI,YAAY,KAAK,SAAS,EAAE;QAC9B,KAAK,CACH,mCAAmC,yBAAyB,mEAAmE,CAChI,CAAC;KACH;IAED,OAAO,YAAY,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,uBAAgD;IAEhD,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE;QACrC,KAAK,CACH,mFAAmF,OAAO,uBAAuB,EAAE,CACpH,CAAC;KACH;IAED,MAAM,yBAAyB,GAAG,sBAAsB,CACtD,uBAAuB,CACxB,CAAC;IACF,IAAI,yBAAyB,KAAK,SAAS,EAAE;QAC3C,KAAK,CACH,kFAAkF,CACnF,CAAC;KACH;IAED,MAAM,YAAY,GAChB,qCAAqC,CAAC,yBAAyB,CAAC,CAAC;IACnE,OAAO,YAAY,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,sBAAsB,CAC7B,uBAAgD;IAEhD,KAAK,MAAM,CAAC,yBAAyB,EAAE,kBAAkB,CAAC,IAAI,MAAM,CAAC,OAAO,CAC1E,6BAA6B,CAC9B,EAAE;QACD,IAAI,uBAAuB,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE;YACnD,OAAO,yBAAsD,CAAC;SAC/D;KACF;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAAe;IAEf,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CACrC,oDAAoD,CACrD,CAAC;IACF,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/functions/serialization.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/serialization.ts"],"names":[],"mappings":";;;;;;MAqES;AApET,8BAAkC;AAAzB;AACT,qCAA8C;AAArC;AACT,4CAAsD;AAA7C;AACT,0DAAqE;AAA5D;AAET,0BAAqC;AAA5B;AACT,kBAAoC;AAA3B;AAAS;AA8DlB,SAAS,6BACP;AAEA,kCAA8D,oBAC5D;cADU;cAA2B;WAGjC,wBAA4B;AAC9B,mBAAO;;;AAIX;;AAvEF,6CACE,eACA;WAEK,gBAAW;QACd,MACE,+EAA4E,aAAO;;AAIjF,8BAAoB,0BAAqB;OAC3C;QACF,MACE;;AAIE,sCACJ;AACI,yBACJ,sCAAsC;OAEpC;QACF,OACE,uCAAmC,8BAAyB;;AAIhE,WAAO,kBAAa,eAAe;AA5BrC;;;;;AAqCA,oDACE;WAEK,aAAQ;QACX,MACE,sFAAmF,aAAO;;AAIxF,sCAA4B,4BAChC;OAEE;QACF,MACE;;AAIE,yBACJ,sCAAsC;AACxC,WAAO,kBAAa,yBAAyB;AApB/C;AAqCA,qDACE;AAEM,8BAAoB,mBACxB;AAEF,WAAO;QAAA;QAAuB,eAAC,kBAAqB,6BAAiB,OAAvC;;AANhC","file":"serialization.lua","sourceRoot":"../src/"}

package/dist/functions/set.js

@@ -0,0 +1,99 @@
+import { getArrayCombinations, getRandomArrayElement } from "./array";
+import { getRandomSeed } from "./rng";
+/**
+ * Helper function to add all of the values in one set to another set. The first set passed will be
+ * modified in place.
+ *
+ * This function is variadic, meaning that you can specify N sets to add to the first set.
+ */
+export function addSetsToSet(mainSet, ...setsToAdd) {
+    for (const set of setsToAdd) {
+        for (const value of set.values()) {
+            mainSet.add(value);
+        }
+    }
+}
+/**
+ * Helper function to create a new set that is the composition of two or more sets.
+ *
+ * This function is variadic, meaning that you can specify N sets.
+ */
+export function combineSets(...sets) {
+    const newSet = new Set();
+    for (const set of sets) {
+        for (const value of set.values()) {
+            newSet.add(value);
+        }
+    }
+    return newSet;
+}
+/** Helper function to copy a set. (You can also use a Set constructor to accomplish this task.) */
+export function copySet(oldSet) {
+    const newSet = new Set();
+    for (const value of oldSet.values()) {
+        newSet.add(value);
+    }
+    return newSet;
+}
+/**
+ * Helper function to delete all of the values in one set from another set. The first set passed
+ * will be modified in place.
+ *
+ * This function is variadic, meaning that you can specify N sets to remove from the first set.
+ */
+export function deleteSetsFromSet(mainSet, ...setsToRemove) {
+    for (const set of setsToRemove) {
+        for (const value of set.values()) {
+            mainSet.delete(value);
+        }
+    }
+}
+/**
+ * Helper function to get a random element from the provided set.
+ *
+ * @param set The set to get an element from.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param exceptions Optional. An array of elements to skip over if selected.
+ */
+export function getRandomSetElement(set, seedOrRNG = getRandomSeed(), exceptions = []) {
+    const array = getSortedSetValues(set);
+    return getRandomArrayElement(array, seedOrRNG, exceptions);
+}
+/**
+ * Helper function to get all possible combinations of the given set. This includes the combination
+ * of an empty set.
+ *
+ * For example, if this function is provided a set containing 1, 2, and 3, then it will return an
+ * array containing the following sets:
+ *
+ * - [] (if `includeEmptyArray` is set to true)
+ * - [1]
+ * - [2]
+ * - [3]
+ * - [1, 2]
+ * - [1, 3]
+ * - [2, 3]
+ * - [1, 2, 3]
+ *
+ * @param set The set to get the combinations of.
+ * @param includeEmptyArray Whether or not to include an empty array in the combinations.
+ */
+export function getSetCombinations(set, includeEmptyArray) {
+    const values = getSortedSetValues(set);
+    const combinations = getArrayCombinations(values, includeEmptyArray);
+    return combinations.map((array) => new Set(array));
+}
+/**
+ * Helper function to get a sorted array based on the contents of a set.
+ *
+ * Normally, set values are returned in a random order, so use this function when the ordering of
+ * the contents is important.
+ */
+export function getSortedSetValues(set) {
+    const values = set.values();
+    const array = [...values];
+    array.sort();
+    return array;
+}
+//# sourceMappingURL=set.js.map

package/dist/functions/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"../src/","sources":["functions/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,GAAG,SAAyC;IAE5C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE;QAC3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SACpB;KACF;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,GAAG,IAAoC;IAEvC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAK,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;QACtB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE;YAChC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SACnB;KACF;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,OAAO,CAAI,MAA+B;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAK,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;KACnB;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,GAAG,YAA4C;IAE/C,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE;QAC9B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SACvB;KACF;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAA4B,EAC5B,YAAwB,aAAa,EAAE,EACvC,aAAiC,EAAE;IAEnC,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAA4B,EAC5B,iBAA0B;IAE1B,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAErE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAI,GAA4B;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,EAAE,CAAC;IAEb,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/functions/set.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/set.ts"],"names":[],"mappings":";;;;;;;;AAAA,kBAA4D;AAAnD;AAAsB;AAC/B,gBAA8B;AAArB;;;;;AAoHT,8CAAsC;AAC9B,mBAAS,IAAI;AACb,kBAAQ,CAAC,aAAG;IAClB;AAEA,WAAO;AALT;;;;;AA5GA,wCACE;UACG;AAEH,cAAW,cAAO;AAChB,kBAAW,SAAS,mBAAI;YACtB,QAAQ,IAAI;;;AANlB;;;;AAgBA;UACK;AAEG,mBAAS,UAAI;AACnB,cAAW,cAAO;AAChB,kBAAW,SAAS,mBAAI;YACtB,OAAO,IAAI;;;AAIf,WAAO;AAVT;;AAcA,mCAA2B;AACnB,mBAAS,UAAI;AACnB,cAAW,SAAS,sBAAO;QACzB,OAAO,IAAI;;AAGb,WAAO;AANT;;;;;AAeA,6CACE;UACG;AAEH,cAAW,cAAO;AAChB,kBAAW,SAAS,mBAAI;YACtB,QAAQ,OAAO;;;AANrB;;;;;;;AAmBA,+CACE,KACA,WACA;OADA;QAAA,YAAwB;;OACxB;QAAA,aAAiC;;AAE3B,kBAAQ,oCAAmB;AACjC,WAAO,2BAAsB,OAAO,WAAW;AANjD;;;;;;;;;;;;;;;;;;AA4BA,8CACE,KACA;AAEM,mBAAS,oCAAmB;AAC5B,yBAAe,0BAAqB,QAAQ;AAElD,WAAO;QAAA;QAAiB,eAAC,OAAU,iBAAI,KAAI,MAAnB;;AAP1B","file":"set.lua","sourceRoot":"../src/"}

package/dist/functions/sound.js

@@ -0,0 +1,9 @@
+import { SoundEffect } from "isaac-typescript-definitions";
+import { sfxManager } from "../cachedClasses";
+import { getEnumValues } from "./enums";
+export function stopAllSoundEffects() {
+    for (const soundEffect of getEnumValues(SoundEffect)) {
+        sfxManager.Stop(soundEffect);
+    }
+}
+//# sourceMappingURL=sound.js.map

package/dist/functions/sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound.js","sourceRoot":"../src/","sources":["functions/sound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,UAAU,mBAAmB;IACjC,KAAK,MAAM,WAAW,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE;QACpD,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;KAC9B;AACH,CAAC"}

package/dist/functions/sound.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/sound.ts"],"names":[],"mappings":";AAAA,6CAA4B;AAAnB;AACT,0BAA2B;AAAlB;AACT,kBAA8B;AAArB;AAET;AACE,cAAW,sBAAe,mBAAc;QACtC,WAAW,KAAK;;AAFpB","file":"sound.lua","sourceRoot":"../src/"}

package/dist/functions/spawnCollectible.js

@@ -0,0 +1,66 @@
+import { CollectibleType, PickupVariant, PlayerType, } from "isaac-typescript-definitions";
+import { VectorZero } from "../constants";
+import { preventCollectibleRotation } from "../features/preventCollectibleRotation";
+import { areFeaturesInitialized } from "../featuresInitialized";
+import { setCollectibleEmpty } from "./collectibles";
+import { isQuestCollectible } from "./collectibleTag";
+import { spawnPickupWithSeed } from "./entitySpecific";
+import { anyPlayerIs } from "./player";
+import { getRandomSeed, isRNG } from "./rng";
+/**
+ * Helper function to spawn a collectible. Use this instead of the `Game.Spawn` method because it
+ * handles the cases of Tainted Keeper collectibles costing coins and preventing quest items from
+ * being rotated by Tainted Isaac's rotation mechanic. (Rotation prevention will only occur in
+ * upgraded mods.)
+ *
+ * @param collectibleType The collectible type to spawn.
+ * @param position The position to spawn the collectible at.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param options Optional. Set to true to make the collectible a "There's Options" style
+ *                collectible. Default is false.
+ * @param forceFreeItem Optional. Set to true to disable the logic that gives the item a price for
+ *                      Tainted Keeper. Default is false.
+ * @param spawner Optional.
+ */
+export function spawnCollectible(collectibleType, position, seedOrRNG = getRandomSeed(), options = false, forceFreeItem = false, spawner) {
+    const seed = isRNG(seedOrRNG) ? seedOrRNG.Next() : seedOrRNG;
+    const collectible = spawnPickupWithSeed(PickupVariant.COLLECTIBLE, collectibleType, position, seed, VectorZero, spawner);
+    if (options) {
+        collectible.OptionsPickupIndex = 1;
+    }
+    if (anyPlayerIs(PlayerType.KEEPER_B) &&
+        !isQuestCollectible(collectibleType) &&
+        !forceFreeItem) {
+        // When playing Tainted Keeper, collectibles are supposed to have a price, and manually spawned
+        // items will not have a price, so we have to set it manually.
+        // Setting the shop item ID in this way prevents the bug where the item will sometimes change to
+        // 99 cents.
+        collectible.ShopItemId = -1;
+        // We can set the price to any arbitrary value; it will auto-update to the true price on the
+        // next frame.
+        collectible.Price = 15;
+    }
+    if (isQuestCollectible(collectibleType) && areFeaturesInitialized()) {
+        preventCollectibleRotation(collectible, collectibleType);
+    }
+    return collectible;
+}
+/**
+ * Helper function to spawn an empty collectible. Doing this is tricky since spawning a collectible
+ * with `CollectibleType.NULL` will result in spawning a collectible with a random type from the
+ * current room's item pool.
+ *
+ * Instead, this function arbitrarily spawns a collectible with `CollectibleType.SAD_ONION`, and
+ * then converts it to an empty pedestal afterward.
+ *
+ * @param position The position to spawn the empty collectible at.
+ * @param seedOrRNG The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ */
+export function spawnEmptyCollectible(position, seedOrRNG = getRandomSeed()) {
+    const collectible = spawnCollectible(CollectibleType.SAD_ONION, position, seedOrRNG, false, true);
+    setCollectibleEmpty(collectible);
+    return collectible;
+}
+//# sourceMappingURL=spawnCollectible.js.map

package/dist/functions/spawnCollectible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnCollectible.js","sourceRoot":"../src/","sources":["functions/spawnCollectible.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,aAAa,EACb,UAAU,GACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAC9B,eAAgC,EAChC,QAAgB,EAChB,YAAwB,aAAa,EAAE,EACvC,OAAO,GAAG,KAAK,EACf,aAAa,GAAG,KAAK,EACrB,OAAgB;IAEhB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,MAAM,WAAW,GAAG,mBAAmB,CACrC,aAAa,CAAC,WAAW,EACzB,eAAe,EACf,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,OAAO,CACmB,CAAC;IAE7B,IAAI,OAAO,EAAE;QACX,WAAW,CAAC,kBAAkB,GAAG,CAAC,CAAC;KACpC;IAED,IACE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC;QAChC,CAAC,kBAAkB,CAAC,eAAe,CAAC;QACpC,CAAC,aAAa,EACd;QACA,+FAA+F;QAC/F,8DAA8D;QAE9D,gGAAgG;QAChG,YAAY;QACZ,WAAW,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAE5B,4FAA4F;QAC5F,cAAc;QACd,WAAW,CAAC,KAAK,GAAG,EAAiB,CAAC;KACvC;IAED,IAAI,kBAAkB,CAAC,eAAe,CAAC,IAAI,sBAAsB,EAAE,EAAE;QACnE,0BAA0B,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;KAC1D;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,YAAwB,aAAa,EAAE;IAEvC,MAAM,WAAW,GAAG,gBAAgB,CAClC,eAAe,CAAC,SAAS,EACzB,QAAQ,EACR,SAAS,EACT,KAAK,EACL,IAAI,CACL,CAAC;IACF,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEjC,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/functions/spawnCollectible.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/spawnCollectible.ts"],"names":[],"mappings":";AAAA,6CAKO;AAJL;AAEA;AACA;AAEF,sBAA2B;AAAlB;AACT,uCAA2C;AAAlC;AACT,gCAAuC;AAA9B;AACT,yBAAoC;AAA3B;AACT,2BAAmC;AAA1B;AACT,2BAAoC;AAA3B;AACT,mBAA4B;AAAnB;AACT,gBAAqC;AAA5B;AAAe;;;;;;;;;;;;;;;AAkBxB,4CACE,iBACA,UACA,WACA,SACA,eACA;OAHA;QAAA,YAAwB;;OACxB;QAAA,UAAU;;OACV;QAAA,gBAAgB;;AAGV,iBAAO,WAAM,eAAa,UAAU,UAAS;AAC7C,wBAAc;;QAClB;QACA;QACA;QACA;QACA;QACA;;OAGE;AACF,yCAAiC;;OAIjC,iBAAY,6BACX,wBAAmB,yBACnB;AAOD,kCAA0B;AAI1B,4BAAoB;;OAGlB,wBAAmB,qBAAoB;QACzC,gCAA2B,aAAa;;AAG1C,WAAO;AA3CT;;;;;;;;;;;AA0DA,iDACE,UACA;OAAA;QAAA,YAAwB;;AAElB,wBAAc;;QAClB;QACA;QACA;QACA;QACA;;IAEF,yBAAoB;AAEpB,WAAO;AAbT","file":"spawnCollectible.lua","sourceRoot":"../src/"}

package/dist/functions/sprite.js

@@ -0,0 +1,80 @@
+import { EMPTY_PNG_PATH, VectorZero } from "../constants";
+import { kColorEquals } from "./kColor";
+import { erange } from "./utils";
+/**
+ * Helper function to clear all layers or specific layers from a sprite.
+ *
+ * This function is variadic, so pass as many layer IDs as you want to clear. If no specific layers
+ * are passed, it will clear every layer.
+ *
+ * Since there is no official API method to "clear" a sprite, we can work around it by setting the
+ * spritesheet to a non-existent or completely transparent file. If the path to the spritesheet does
+ * not exist, then this function might cause spurious errors to appear in the "log.txt file". To
+ * silence these errors, create a transparent 1 pixel PNG file in your mod's resources folder at the
+ * path corresponding to the "EMPTY_PNG_PATH" constant.
+ */
+export function clearSprite(sprite, ...layerIDs) {
+    if (layerIDs.length === 0) {
+        const numLayers = sprite.GetLayerCount();
+        layerIDs = erange(numLayers);
+    }
+    for (const layerID of layerIDs) {
+        sprite.ReplaceSpritesheet(layerID, EMPTY_PNG_PATH);
+    }
+    sprite.LoadGraphics();
+}
+/**
+ * Helper function that returns the number of the final frame in a particular animation for a
+ * sprite. By default, it will use the currently playing animation, but you can also specify a
+ * specific animation to check.
+ *
+ * Note that this function is bugged with the Stop Watch or the Broken Watch, since using the
+ * `Sprite.SetFrame` method will reset the internal accumulator used to slow down the playback speed
+ * of the animation. (The `PlaybackSpeed` property of the sprite is not used.) Thus, it is only safe
+ * to use this function on animations that are not slowed down by Stop Watch or Broken Watch, such
+ * as player animations.
+ */
+export function getLastFrameOfAnimation(sprite, animation) {
+    // Record the current sprite status.
+    const currentAnimation = sprite.GetAnimation();
+    const currentFrame = sprite.GetFrame();
+    // Get the final frame.
+    if (animation !== undefined && animation !== currentAnimation) {
+        sprite.SetAnimation(animation);
+    }
+    sprite.SetLastFrame();
+    const finalFrame = sprite.GetFrame();
+    // Set the sprite back to the way it was.
+    if (animation !== undefined && animation !== currentAnimation) {
+        sprite.Play(currentAnimation, true);
+    }
+    sprite.SetFrame(currentFrame);
+    return finalFrame;
+}
+/**
+ * Helper function to check if two sprite layers have the same sprite sheet by using the
+ * `Sprite.GetTexel` method.
+ *
+ * Since checking every single texel in the entire sprite is very expensive, this function requires
+ * that you provide a range of specific texels to check.
+ */
+export function spriteEquals(sprite1, sprite2, layerID, xStart, xFinish, xIncrement, yStart, yFinish, yIncrement) {
+    // Iterate over N texels, checking for equality at each step. The center of the sprite is equal to
+    // the "pivot" point in the anm2 file.
+    for (let x = xStart; x <= xFinish; x += xIncrement) {
+        for (let y = yStart; y <= yFinish; y += yIncrement) {
+            const position = Vector(x, y);
+            if (!texelEquals(sprite1, sprite2, position, layerID)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+/** Helper function to check if two texels on a sprite are equivalent to each other. */
+export function texelEquals(sprite1, sprite2, position, layerID) {
+    const kColor1 = sprite1.GetTexel(position, VectorZero, 1, layerID);
+    const kColor2 = sprite2.GetTexel(position, VectorZero, 1, layerID);
+    return kColorEquals(kColor1, kColor2);
+}
+//# sourceMappingURL=sprite.js.map

package/dist/functions/sprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite.js","sourceRoot":"../src/","sources":["functions/sprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,GAAG,QAAe;IAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QACzC,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;KAC9B;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;QAC9B,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;KACpD;IAED,MAAM,CAAC,YAAY,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,SAAkB;IAElB,oCAAoC;IACpC,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEvC,uBAAuB;IACvB,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,gBAAgB,EAAE;QAC7D,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;KAChC;IACD,MAAM,CAAC,YAAY,EAAE,CAAC;IACtB,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAErC,yCAAyC;IACzC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,gBAAgB,EAAE;QAC7D,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;KACrC;IACD,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE9B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,OAAe,EACf,OAAY,EACZ,MAAW,EACX,OAAY,EACZ,UAAe,EACf,MAAW,EACX,OAAY,EACZ,UAAe;IAEf,kGAAkG;IAClG,sCAAsC;IACtC,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,IAAI,UAAU,EAAE;QAClD,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,IAAI,UAAU,EAAE;YAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;gBACrD,OAAO,KAAK,CAAC;aACd;SACF;KACF;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,OAAe,EACf,QAAgB,EAChB,OAAY;IAEZ,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/functions/sprite.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/sprite.ts"],"names":[],"mappings":";AAAA,sBAA2C;AAAlC;AAAgB;AACzB,mBAA6B;AAApB;AACT,kBAAuB;AAAd;;AA+FT,uCACE,SACA,SACA,UACA;AAEM,oBAAU,QAAQ,SAAS,UAAU,YAAY,GAAG;AACpD,oBAAU,QAAQ,SAAS,UAAU,YAAY,GAAG;AAC1D,WAAO,kBAAa,SAAS;AAR/B;;;;;;;;;;;AAjFA,uCAA4B;UAAmB;OACzC,aAAoB;AAChB,0BAAY,OAAO;AACzB,mBAAW,YAAO;;AAGpB,cAAW,kBAAW;QACpB,OAAO,mBAAmB,SAAS;;IAGrC,OAAO;AAVT;;;;;;;;;;AAwBA,mDACE,QACA;AAGM,6BAAmB,OAAO;AAC1B,yBAAe,OAAO;OAGxB,qBAA2B,aAAc;QAC3C,OAAO,aAAa;;IAEtB,OAAO;AACD,uBAAa,OAAO;OAGtB,qBAA2B,aAAc;QAC3C,OAAO,KAAK,kBAAkB;;IAEhC,OAAO,SAAS;AAEhB,WAAO;AArBT;;;;;;AA+BA,wCACE,SACA,SACA,SACA,QACA,SACA,YACA,QACA,SACA;;AAIS,kBAAI;cAAQ,KAAK;;AACf,0BAAI;sBAAQ,KAAK;AAClB,qCAAW,OAAO,GAAG;2BACtB;;wBAAY;wBAAS;wBAAS;wBAAU;;AAC3C,+BAAO;;AAHwB,4BAAK;;;AADP,oBAAK;;;AASxC,WAAO;AAtBT","file":"sprite.lua","sourceRoot":"../src/"}