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

package/dist/functions/trinketGive.js

@@ -0,0 +1,121 @@
+import { CollectibleType, TrinketSlot, TrinketType, } from "isaac-typescript-definitions";
+import { useActiveItemTemp } from "./player";
+import { getGoldenTrinketType } from "./trinkets";
+import { repeat } from "./utils";
+/**
+ * Helper function to restore the player's trinkets back to the way they were before the
+ * `temporarilyRemoveTrinket` function was used. It will re-smelt any smelted trinkets that were
+ * removed.
+ */
+export function giveTrinketsBack(player, trinketSituation) {
+    // A trinket situation of undefined signifies that we did not have to remove the trinket. If this
+    // is the case, we do not have to give anything back.
+    if (trinketSituation === undefined) {
+        return;
+    }
+    const trinketType1 = player.GetTrinket(TrinketSlot.SLOT_1);
+    const trinketType2 = player.GetTrinket(TrinketSlot.SLOT_2);
+    // Remove any existing trinkets.
+    if (trinketType1 !== TrinketType.NULL) {
+        player.TryRemoveTrinket(trinketType1);
+    }
+    if (trinketType2 !== TrinketType.NULL) {
+        player.TryRemoveTrinket(trinketType2);
+    }
+    // First, add the smelted trinkets back.
+    repeat(trinketSituation.numSmeltedTrinkets, () => {
+        player.AddTrinket(trinketSituation.trinketTypeRemoved, false);
+        useActiveItemTemp(player, CollectibleType.SMELTER);
+    });
+    // Second, add back the stored trinkets.
+    if (trinketSituation.trinketType1 !== TrinketType.NULL) {
+        player.AddTrinket(trinketSituation.trinketType1, false);
+    }
+    if (trinketSituation.trinketType2 !== TrinketType.NULL) {
+        player.AddTrinket(trinketSituation.trinketType2, false);
+    }
+}
+/**
+ * Helper function to smelt a trinket. Before smelting, this function will automatically remove the
+ * trinkets that the player is holding, if any, and then give them back after the new trinket is
+ * smelted.
+ *
+ * @param player The player to smelt the trinkets to.
+ * @param trinketType The trinket type to smelt.
+ * @param numTrinkets Optional. If specified, will smelt the given number of trinkets. Use this to
+ *                    avoid calling this function multiple times. Default is 1.
+ */
+export function smeltTrinket(player, trinketType, numTrinkets = 1) {
+    const trinketSituation = temporarilyRemoveTrinkets(player);
+    repeat(numTrinkets, () => {
+        player.AddTrinket(trinketType);
+        useActiveItemTemp(player, CollectibleType.SMELTER);
+    });
+    giveTrinketsBack(player, trinketSituation);
+}
+/**
+ * Helper function to temporarily remove a specific kind of trinket from the player. Use this in
+ * combination with the `giveTrinketsBack` function to take away and give back a trinket on the same
+ * frame. This function correctly handles multiple trinket slots and ensures that all copies of the
+ * trinket are removed, including smelted trinkets.
+ *
+ * Note that one smelted golden trinket is the same as two smelted normal trinkets.
+ *
+ * @returns Undefined if the player does not have the trinket, or TrinketSituation if they do.
+ */
+export function temporarilyRemoveTrinket(player, trinketType) {
+    if (!player.HasTrinket(trinketType)) {
+        return undefined;
+    }
+    const trinketType1 = player.GetTrinket(TrinketSlot.SLOT_1);
+    const trinketType2 = player.GetTrinket(TrinketSlot.SLOT_2);
+    let numTrinkets = 0;
+    while (player.HasTrinket(trinketType)) {
+        player.TryRemoveTrinket(trinketType);
+        numTrinkets += 1;
+    }
+    let numSmeltedTrinkets = numTrinkets;
+    const trinketWasInSlot1 = trinketType1 === trinketType ||
+        trinketType1 === getGoldenTrinketType(trinketType);
+    if (trinketWasInSlot1) {
+        numSmeltedTrinkets -= 1;
+    }
+    const trinketWasInSlot2 = trinketType2 === trinketType ||
+        trinketType2 === getGoldenTrinketType(trinketType);
+    if (trinketWasInSlot2) {
+        numSmeltedTrinkets -= 1;
+    }
+    return {
+        trinketTypeRemoved: trinketType,
+        trinketType1,
+        trinketType2,
+        numSmeltedTrinkets,
+    };
+}
+/**
+ * Helper function to temporarily removes a player's held trinkets, if any. This will not remove any
+ * smelted trinkets. Use this in combination with the `giveTrinketsBack` function to take away and
+ * give back trinkets on the same frame.
+ *
+ * @returns Undefined if the player does not have any trinkets, or TrinketSituation if they do.
+ */
+export function temporarilyRemoveTrinkets(player) {
+    const trinketType1 = player.GetTrinket(TrinketSlot.SLOT_1);
+    const trinketType2 = player.GetTrinket(TrinketSlot.SLOT_2);
+    if (trinketType1 === TrinketType.NULL && trinketType2 === TrinketType.NULL) {
+        return undefined;
+    }
+    if (trinketType1 !== TrinketType.NULL) {
+        player.TryRemoveTrinket(trinketType1);
+    }
+    if (trinketType2 !== TrinketType.NULL) {
+        player.TryRemoveTrinket(trinketType2);
+    }
+    return {
+        trinketTypeRemoved: TrinketType.NULL,
+        trinketType1,
+        trinketType2,
+        numSmeltedTrinkets: 0,
+    };
+}
+//# sourceMappingURL=trinketGive.js.map

package/dist/functions/trinketGive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trinketGive.js","sourceRoot":"../src/","sources":["functions/trinketGive.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,WAAW,EACX,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAoB,EACpB,gBAA8C;IAE9C,iGAAiG;IACjG,qDAAqD;IACrD,IAAI,gBAAgB,KAAK,SAAS,EAAE;QAClC,OAAO;KACR;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3D,gCAAgC;IAChC,IAAI,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE;QACrC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;KACvC;IACD,IAAI,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE;QACrC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;KACvC;IAED,wCAAwC;IACxC,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC9D,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,wCAAwC;IACxC,IAAI,gBAAgB,CAAC,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE;QACtD,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;KACzD;IACD,IAAI,gBAAgB,CAAC,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE;QACtD,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;KACzD;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAoB,EACpB,WAAwB,EACxB,WAAW,GAAG,CAAC;IAEf,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAE3D,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE;QACvB,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC/B,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAoB,EACpB,WAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;QACnC,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3D,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;QACrC,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACrC,WAAW,IAAI,CAAC,CAAC;KAClB;IAED,IAAI,kBAAkB,GAAG,WAAW,CAAC;IACrC,MAAM,iBAAiB,GACrB,YAAY,KAAK,WAAW;QAC5B,YAAY,KAAK,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,iBAAiB,EAAE;QACrB,kBAAkB,IAAI,CAAC,CAAC;KACzB;IACD,MAAM,iBAAiB,GACrB,YAAY,KAAK,WAAW;QAC5B,YAAY,KAAK,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,iBAAiB,EAAE;QACrB,kBAAkB,IAAI,CAAC,CAAC;KACzB;IAED,OAAO;QACL,kBAAkB,EAAE,WAAW;QAC/B,YAAY;QACZ,YAAY;QACZ,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAoB;IAEpB,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3D,IAAI,YAAY,KAAK,WAAW,CAAC,IAAI,IAAI,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE;QAC1E,OAAO,SAAS,CAAC;KAClB;IAED,IAAI,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE;QACrC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;KACvC;IAED,IAAI,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE;QACrC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;KACvC;IAED,OAAO;QACL,kBAAkB,EAAE,WAAW,CAAC,IAAI;QACpC,YAAY;QACZ,YAAY;QACZ,kBAAkB,EAAE,CAAC;KACtB,CAAC;AACJ,CAAC"}

package/dist/functions/trinketGive.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/trinketGive.ts"],"names":["repeat"],"mappings":";AAAA,6CAIO;AAHL;AACA;AACA;AAGF,mBAAkC;AAAzB;AACT,qBAAqC;AAA5B;AACT,kBAAuB;AAAd,MAAAA;;;;;;AA4HT,qDACE;AAEM,yBAAe,OAAO,WAAW;AACjC,yBAAe,OAAO,WAAW;OAEnC,gBAAiB,qBAAoB,gBAAiB;AACxD;;OAGE,gBAAiB;QACnB,OAAO,iBAAiB;;OAGtB,gBAAiB;QACnB,OAAO,iBAAiB;;AAG1B,WAAO,CACL,qBAAoB,kBACpB,6BACA,6BACA,qBAAoB;AAtBxB;;;;AArHA,4CACE,QACA;OAII;AACF;;AAGI,yBAAe,OAAO,WAAW;AACjC,yBAAe,OAAO,WAAW;OAGnC,gBAAiB;QACnB,OAAO,iBAAiB;;OAEtB,gBAAiB;QACnB,OAAO,iBAAiB;;IAI1B,AAAAA;;QAAO;QAAqC;YAC1C,OAAO,WAAW,qCAAqC;YACvD,uBAAkB,QAAQ;QAFgB;;OAMxC,iCAAkC;QACpC,OAAO,WAAW,+BAA+B;;OAE/C,iCAAkC;QACpC,OAAO,WAAW,+BAA+B;;AAhCrD;;;;;;;;;AA8CA,wCACE,QACA,aACA;OAAA;QAAA,cAAc;;AAER,6BAAmB,2CAA0B;IAEnD,AAAAA;;QAAO;QAAa;YAClB,OAAO,WAAW;YAClB,uBAAkB,QAAQ;QAFR;;IAKpB,kCAAiB,QAAQ;AAZ3B;;;;;;;;;AAyBA,oDACE,QACA;WAEK,OAAO,WAAW;AACrB;;AAGI,yBAAe,OAAO,WAAW;AACjC,yBAAe,OAAO,WAAW;AAEnC,wBAAc;UACX,OAAO,WAAW;QACvB,OAAO,iBAAiB;AACxB,oCAAe;;AAGb,+BAAqB;AACnB,8BACJ,gBAAiB,eACjB,gBAAiB,0BAAqB;OACpC;AACF,kDAAsB;;AAElB,8BACJ,gBAAiB,eACjB,gBAAiB,0BAAqB;OACpC;AACF,kDAAsB;;AAGxB,WAAO,CACL,qBAAoB,aACpB,6BACA,6BACA;AAnCJ","file":"trinketGive.lua","sourceRoot":"../src/"}

package/dist/functions/trinkets.js

@@ -0,0 +1,169 @@
+import { PlayerType, TrinketSlot, TrinketType, } from "isaac-typescript-definitions";
+import { itemConfig } from "../cachedClasses";
+import { FIRST_MODDED_TRINKET_TYPE, FIRST_TRINKET_TYPE, LAST_TRINKET_TYPE, LAST_VANILLA_TRINKET_TYPE, } from "../constantsFirstLast";
+import { DEFAULT_TRINKET_DESCRIPTION, TRINKET_DESCRIPTION_MAP, } from "../maps/trinketDescriptionMap";
+import { DEFAULT_TRINKET_NAME, TRINKET_NAME_MAP } from "../maps/trinketNameMap";
+import { getEntityID } from "./entity";
+import { hasFlag } from "./flag";
+import { isTrinket } from "./pickupVariants";
+import { isCharacter } from "./player";
+import { clearSprite } from "./sprite";
+import { irange } from "./utils";
+/**
+ * Add this to a `TrinketType` to get the corresponding golden trinket type.
+ *
+ * Corresponds to the vanilla `PillColor.TRINKET_GOLDEN_FLAG` value.
+ *
+ * 1 << 15
+ */
+const GOLDEN_TRINKET_ADJUSTMENT = 32768;
+const TRINKET_SPRITE_LAYER = 0;
+/**
+ * Helper function to get the corresponding golden trinket type from a normal trinket type.
+ *
+ * For example, passing `TrinketType.SWALLOWED_PENNY` would result in 32769, which is the value that
+ * corresponds to the golden trinket sub-type for Swallowed Penny.
+ */
+export function getGoldenTrinketType(trinketType) {
+    return trinketType + GOLDEN_TRINKET_ADJUSTMENT; // eslint-disable-line isaacscript/strict-enums
+}
+/**
+ * Helper function to get an array that represents every modded trinket type.
+ *
+ * Returns an empty array if there are no modded trinket types.
+ */
+export function getModdedTrinketTypes() {
+    if (LAST_VANILLA_TRINKET_TYPE === LAST_TRINKET_TYPE) {
+        return [];
+    }
+    return irange(FIRST_MODDED_TRINKET_TYPE, LAST_TRINKET_TYPE);
+}
+/**
+ * Returns the slot number corresponding to where a trinket can be safely inserted.
+ *
+ * For example:
+ *
+ * ```ts
+ * const player = Isaac.GetPlayer();
+ * const trinketSlot = getOpenTrinketSlotNum(player);
+ * if (trinketSlot !== undefined) {
+ *   // They have one or more open trinket slots
+ *   player.AddTrinket(TrinketType.SWALLOWED_PENNY);
+ * }
+ * ```
+ */
+export function getOpenTrinketSlot(player) {
+    const maxTrinkets = player.GetMaxTrinkets();
+    const trinketType1 = player.GetTrinket(TrinketSlot.SLOT_1);
+    const trinketType2 = player.GetTrinket(TrinketSlot.SLOT_2);
+    if (maxTrinkets === 1) {
+        return trinketType1 === TrinketType.NULL ? 0 : undefined;
+    }
+    if (maxTrinkets === 2) {
+        if (trinketType1 === TrinketType.NULL) {
+            return 0;
+        }
+        return trinketType2 === TrinketType.NULL ? 1 : undefined;
+    }
+    error(`The player has an unknown number of trinket slots: ${maxTrinkets}`);
+}
+/**
+ * Helper function to get the in-game description for a trinket. Returns "Unknown" if the provided
+ * trinket type was not valid.
+ */
+export function getTrinketDescription(trinketType) {
+    // "ItemConfigItem.Description" is bugged with vanilla items on patch v1.7.6, so we use a
+    // hard-coded map as a workaround.
+    const trinketDescription = TRINKET_DESCRIPTION_MAP.get(trinketType);
+    if (trinketDescription !== undefined) {
+        return trinketDescription;
+    }
+    const itemConfigItem = itemConfig.GetTrinket(trinketType);
+    if (itemConfigItem !== undefined) {
+        return itemConfigItem.Description;
+    }
+    return DEFAULT_TRINKET_DESCRIPTION;
+}
+/**
+ * Helper function to get the name of a trinket. Returns "Unknown" if the provided trinket type is
+ * not valid.
+ *
+ * For example:
+ *
+ * ```ts
+ * const trinketType = TrinketType.SWALLOWED_PENNY;
+ * const trinketName = getTrinketName(trinketType); // trinketName is "Swallowed Penny"
+ * ```
+ */
+export function getTrinketName(trinketType) {
+    // "ItemConfigItem.Name" is bugged with vanilla items on patch v1.7.6, so we use a hard-coded map
+    // as a workaround.
+    const trinketName = TRINKET_NAME_MAP.get(trinketType);
+    if (trinketName !== undefined) {
+        return trinketName;
+    }
+    const itemConfigItem = itemConfig.GetTrinket(trinketType);
+    if (itemConfigItem !== undefined) {
+        return itemConfigItem.Name;
+    }
+    return DEFAULT_TRINKET_NAME;
+}
+/** Helper function to get an array that contains every trinket type. */
+export function getTrinketTypes() {
+    return irange(FIRST_TRINKET_TYPE, LAST_TRINKET_TYPE);
+}
+/** Helper function to get an array that represents every vanilla trinket type. */
+export function getVanillaTrinketTypes() {
+    return irange(FIRST_TRINKET_TYPE, LAST_VANILLA_TRINKET_TYPE);
+}
+/**
+ * Returns whether or not the player can hold an additional trinket, beyond what they are currently
+ * carrying. This takes into account items that modify the max number of trinkets, like Mom's Purse.
+ *
+ * If the player is the Tainted Soul, this always returns false, since that character cannot pick up
+ * items. (Only Tainted Forgotten can pick up items.)
+ */
+export function hasOpenTrinketSlot(player) {
+    if (isCharacter(player, PlayerType.THE_SOUL_B)) {
+        return false;
+    }
+    const openTrinketSlot = getOpenTrinketSlot(player);
+    return openTrinketSlot !== undefined;
+}
+export function isGoldenTrinket(trinketType) {
+    return trinketType > GOLDEN_TRINKET_ADJUSTMENT;
+}
+/**
+ * Helper function to change the sprite of a trinket entity.
+ *
+ * For more information about removing the trinket sprite, see the documentation for the
+ * "clearSprite" helper function.
+ *
+ * @param trinket The trinket whose sprite you want to modify.
+ * @param pngPath Equal to either the spritesheet path to load (e.g.
+ *                "gfx/items/trinkets/trinket_001_swallowedpenny.png") or undefined. If undefined,
+ *                the sprite will be removed, making it appear like the collectible has already been
+ *                taken by the player.
+ */
+export function setTrinketSprite(trinket, pngPath) {
+    if (!isTrinket(trinket)) {
+        const entityID = getEntityID(trinket);
+        error(`The "setTrinketSprite" function was given a non-trinket: ${entityID}`);
+    }
+    const sprite = trinket.GetSprite();
+    if (pngPath === undefined) {
+        clearSprite(sprite, TRINKET_SPRITE_LAYER);
+    }
+    else {
+        sprite.ReplaceSpritesheet(TRINKET_SPRITE_LAYER, pngPath);
+        sprite.LoadGraphics();
+    }
+}
+export function trinketHasCacheFlag(trinketType, cacheFlag) {
+    const itemConfigItem = itemConfig.GetTrinket(trinketType);
+    if (itemConfigItem === undefined) {
+        return false;
+    }
+    return hasFlag(itemConfigItem.CacheFlags, cacheFlag);
+}
+//# sourceMappingURL=trinkets.js.map

package/dist/functions/trinkets.js.map

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

package/dist/functions/trinkets.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/trinkets.ts"],"names":[],"mappings":";AAAA,6CAKO;AAHL;AACA;AACA;AAEF,0BAA2B;AAAlB;AACT,+BAKO;AAJL;AACA;AACA;AACA;AAEF,kCAGO;AAFL;AACA;AAEF,2BAAuD;AAA9C;AAAsB;AAC/B,mBAA4B;AAAnB;AACT,iBAAwB;AAAf;AACT,2BAA0B;AAAjB;AACT,mBAA4B;AAAnB;AACT,mBAA4B;AAAnB;AACT,kBAAuB;AAAd;;;;;;AASH,kCAA4B;AAE5B,6BAAuB;;;;;AAQ7B,gDAAqC;AACnC,WAAO,cAAc;AADvB;;;;AASA;OACM,6BAA8B;AAChC,eAAO;;AAGT,WAAO,YAAO,2BAA2B;AAL3C;;;;;;;;;;;;;AAsBA,8CAAmC;AAC3B,wBAAc,OAAO;AACrB,yBAAe,OAAO,WAAW;AACjC,yBAAe,OAAO,WAAW;OAEnC,eAAgB;AAClB,eAAO,gBAAiB,qBAAmB;;OAGzC,eAAgB;WACd,gBAAiB;AACnB,mBAAO;;AAGT,eAAO,gBAAiB,qBAAmB;;IAG7C,MAAM,kEAAsD;AAjB9D;;;AAwBA,iDAAsC;AAG9B,+BAAqB,wBAAwB,IAAI;OACnD;AACF,eAAO;;AAGH,2BAAiB,WAAW,WAAW;OACzC;AACF,eAAO;;AAGT,WAAO;AAbT;;;;;;;;;;AA2BA,0CAA+B;AAGvB,wBAAc,iBAAiB,IAAI;OACrC;AACF,eAAO;;AAGH,2BAAiB,WAAW,WAAW;OACzC;AACF,eAAO;;AAGT,WAAO;AAbT;;AAiBA;AACE,WAAO,YAAO,oBAAoB;AADpC;;AAKA;AACE,WAAO,YAAO,oBAAoB;AADpC;;;;;;AAWA,8CAAmC;OAC7B,iBAAY,QAAQ;AACtB,eAAO;;AAGH,4BAAkB,oCAAmB;AAC3C,WAAO;AANT;AASA,2CAAgC;AAC9B,WAAO,cAAe;AADxB;;;;;;;;;;;AAgBA,4CACE,SACA;WAEK,eAAU;AACP,yBAAW,iBAAY;QAC7B,MACE,iEAA4D;;AAI1D,mBAAS,QAAQ;OACnB;QACF,iBAAY,QAAQ;;QAEpB,OAAO,mBAAmB,sBAAsB;QAChD,OAAO;;AAhBX;AAoBA,+CACE,aACA;AAEM,2BAAiB,WAAW,WAAW;OACzC;AACF,eAAO;;AAGT,WAAO,aAAQ,2BAA2B;AAT5C","file":"trinkets.lua","sourceRoot":"../src/"}

package/dist/functions/tstlClass.js

@@ -0,0 +1,125 @@
+import { isString, isTable } from "./types";
+const VANILLA_TSTL_CLASSES = new Set(["Map", "Set", "WeakMap", "WeakSet"]);
+const TSTL_CLASS_METATABLE_KEYS = new Set([
+    "____constructor",
+    "__index",
+    "constructor",
+]);
+/**
+ * Helper function to get the name of a TypeScriptToLua class. TSTL classes are Lua tables created
+ * with the `__TS__Class` Lua function from the TSTL lualib. Their name is contained within
+ * "constructor.name" metatable key.
+ *
+ * For example, a `Map` class is has a name of "Map".
+ *
+ * Returns undefined if the object is not a table or if the aforementioned metatable key does not
+ * exist.
+ */
+export function getTSTLClassName(object) {
+    if (!isTable(object)) {
+        return undefined;
+    }
+    const metatable = getmetatable(object);
+    if (metatable === undefined) {
+        return undefined;
+    }
+    const { constructor } = metatable;
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (constructor === undefined) {
+        return undefined;
+    }
+    return constructor.name;
+}
+/**
+ * Helper function to determine if a given object is a TypeScriptToLua `Map`.
+ *
+ * It is not reliable to use the `instanceof` operator to determine this because each Lua module has
+ * their own copies of the entire lualib and thus their own instantiated version of a `Map`.
+ */
+export function isDefaultMap(object) {
+    const className = getTSTLClassName(object);
+    return className === "DefaultMap";
+}
+/**
+ * Returns whether or not this is a class that is provided by the `isaacscript-common` library, such
+ * as a `DefaultMap`.
+ */
+export function isIsaacScriptCommonClass(object) {
+    return isDefaultMap(object);
+}
+/**
+ * Helper function to determine if a given object is a TypeScriptToLua `Map`.
+ *
+ * It is not reliable to use the `instanceof` operator to determine this because each Lua module has
+ * their own copies of the entire lualib and thus their own instantiated version of a `Map`.
+ */
+export function isTSTLMap(object) {
+    const className = getTSTLClassName(object);
+    return className === "Map";
+}
+/**
+ * Helper function to determine if a given object is a TypeScriptToLua `Set`.
+ *
+ * It is not reliable to use the `instanceof` operator to determine this because each Lua module has
+ * their own copies of the entire lualib and thus their own instantiated version of a `Set`.
+ */
+export function isTSTLSet(object) {
+    const className = getTSTLClassName(object);
+    return className === "Set";
+}
+/** TypeScriptToLua classes are Lua tables that have a metatable with a certain amount of keys. */
+export function isUserDefinedTSTLClass(object) {
+    if (isVanillaTSTLClass(object) || isIsaacScriptCommonClass(object)) {
+        return false;
+    }
+    if (!isTable(object)) {
+        return false;
+    }
+    const metatable = getmetatable(object);
+    if (metatable === undefined) {
+        return false;
+    }
+    let numKeys = 0;
+    for (const [key] of pairs(metatable)) {
+        numKeys += 1;
+        if (!isString(key)) {
+            return false;
+        }
+        if (!TSTL_CLASS_METATABLE_KEYS.has(key)) {
+            return false;
+        }
+    }
+    return numKeys === TSTL_CLASS_METATABLE_KEYS.size;
+}
+/**
+ * Returns whether or not this is a class that is provided as part of the TypeScriptToLua
+ * transpiler, such as a `Map` or a `Set`.
+ */
+export function isVanillaTSTLClass(object) {
+    const className = getTSTLClassName(object);
+    if (className === undefined) {
+        return false;
+    }
+    return VANILLA_TSTL_CLASSES.has(className);
+}
+/**
+ * Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
+ * it is. This function requires that you provide an instantiated class of the same type, as it will
+ * use the class constructor that is present on the other object's metatable to initialize the new
+ * class.
+ */
+export function newTSTLClass(oldClass) {
+    const metatable = getmetatable(oldClass);
+    if (metatable === undefined) {
+        error("Failed to instantiate a new TypeScriptToLua class since the provided old class does not have a metatable.");
+    }
+    return newTSTLClassFromMetatable(metatable);
+}
+/** This is a re-implementation of the transpiled "__TS__New" function. */
+function newTSTLClassFromMetatable(metatable) {
+    const newClass = new LuaTable();
+    const newClassMetatable = setmetatable(newClass, metatable.constructor.prototype);
+    newClassMetatable.____constructor(); // eslint-disable-line no-underscore-dangle
+    return newClass;
+}
+//# sourceMappingURL=tstlClass.js.map

package/dist/functions/tstlClass.js.map

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

package/dist/functions/tstlClass.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/tstlClass.ts"],"names":[],"mappings":";;;;MAmJS,2BA9IH;AAFN,kBAAkC;AAAzB;AAAU;;;;;;;;;AAoBnB,4CAAiC;WAC1B,aAAQ;AACX;;AAGI,sBAAY,aAAa;OAC3B;AACF;;UAGM,cAAgB;OAEpB;AACF;;AAGF,WAAO;AAhBT;;;AAiGA,8CAAmC;AAC3B,sBAAY,kCAAiB;OAC/B;AACF,eAAO;;AAGT,WAAO,qBAAqB,IAAI;AANlC;AA2BA,SAAS,gCAA0B;AAC3B,qBAAW;AACX,8BAAoB,aACxB,UACA;IAEF,kBAAkB;AAElB,WAAO;;AAtJH,uBAAuB,UAAI,KAAI,CAAC,OAAO,OAAO,WAAW;AAEzD,kCAAiD,UAAI,KAAI,CAC7D,mBACA,WACA;;;;;AAsCF,wCACE;AAEM,sBAAY,kCAAiB;AACnC,WAAO,aAAc;AAJvB;;;AAWA,oDAAyC;AACvC,WAAO,8BAAa;AADtB;;;;;AAUA,qCAA0B;AAClB,sBAAY,kCAAiB;AACnC,WAAO,aAAc;AAFvB;;;;;AAWA,qCAA0B;AAClB,sBAAY,kCAAiB;AACnC,WAAO,aAAc;AAFvB;;AAMA,kDAAuC;OACjC,oCAAmB,WAAW,0CAAyB;AACzD,eAAO;;WAGJ,aAAQ;AACX,eAAO;;AAGH,sBAAY,aAAa;OAC3B;AACF,eAAO;;AAGL,oBAAU;AACd,QAAY,OAAQ,MAAM;AACxB,4BAAW;eAEN,cAAS;AACZ,mBAAO;;eAGJ,0BAA0B,IAAI;AACjC,mBAAO;;;AAIX,WAAO,WAAY;AA3BrB;;;;;AAiDA,wCAA6B;AACrB,sBAAY,aAAa;OAC3B;QACF,MACE;;AAIJ,WAAO,+BAA0B;AARnC","file":"tstlClass.lua","sourceRoot":"../src/"}

package/dist/functions/types.js

@@ -0,0 +1,27 @@
+export function isBoolean(variable) {
+    return type(variable) === "boolean";
+}
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function isFunction(variable) {
+    return type(variable) === "function";
+}
+export function isNumber(variable) {
+    return type(variable) === "number";
+}
+/** Helper function to detect if a variable is a boolean, number, or string. */
+export function isPrimitive(variable) {
+    const variableType = type(variable);
+    return (variableType === "boolean" ||
+        variableType === "number" ||
+        variableType === "string");
+}
+export function isString(variable) {
+    return type(variable) === "string";
+}
+export function isTable(variable) {
+    return type(variable) === "table";
+}
+export function isUserdata(variable) {
+    return type(variable) === "userdata";
+}
+//# sourceMappingURL=types.js.map

package/dist/functions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"../src/","sources":["functions/types.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,QAAiB;IACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;AACtC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,QAAiB;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,UAAU,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAiB;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;AACrC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CACzB,QAAiB;IAEjB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,CACL,YAAY,KAAK,SAAS;QAC1B,YAAY,KAAK,QAAQ;QACzB,YAAY,KAAK,QAAQ,CAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAiB;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAAiB;IACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAiB;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,UAAU,CAAC;AACvC,CAAC"}

package/dist/functions/types.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/types.ts"],"names":[],"mappings":";AAAA,qCAA0B;AACxB,WAAO,KAAK,aAAc;AAD5B;AAKA,sCAA2B;AACzB,WAAO,KAAK,aAAc;AAD5B;AAIA,oCAAyB;AACvB,WAAO,KAAK,aAAc;AAD5B;;AAKA,uCACE;AAEM,yBAAe,KAAK;AAC1B,WACE,gBAAiB,aACjB,gBAAiB,YACjB,gBAAiB;AAPrB;AAWA,oCAAyB;AACvB,WAAO,KAAK,aAAc;AAD5B;AAIA,mCAAwB;AACtB,WAAO,KAAK,aAAc;AAD5B;AAIA,sCAA2B;AACzB,WAAO,KAAK,aAAc;AAD5B","file":"types.lua","sourceRoot":"../src/"}

package/dist/functions/ui.js

@@ -0,0 +1,124 @@
+import { CollectibleType, LevelCurse } from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { UI_HEART_WIDTH, VectorZero } from "../constants";
+import { copyVector } from "./vector";
+/**
+ * In the options menu, players have the ability to set a HUD offset. However, mods do not have
+ * access to this value. To get around this, Mod Config Menu provides a separate HUD offset setting
+ * on the first page of the menu. This is intended to be set by end-users to match their vanilla HUD
+ * offset setting so that mods can render UI elements to the screen in the correct position.
+ *
+ * @returns If the user does not have Mod Config Menu enabled, or does not have this option set,
+ *          then this function will return `Vector.Zero.` Otherwise, it will return a Vector that
+ *          represents a HUD offset that should be added to the position of a UI element.
+ */
+export function getHUDOffsetVector() {
+    const defaultVector = copyVector(VectorZero);
+    // Convert e.g. 0.4 to 4.
+    const hudOffset = math.floor(Options.HUDOffset * 10);
+    // Expected values are integers between 1 and 10.
+    if (hudOffset < 1 || hudOffset > 10) {
+        return defaultVector;
+    }
+    const x = hudOffset * 2;
+    let y = hudOffset;
+    if (y >= 4) {
+        y += 1;
+    }
+    if (y >= 9) {
+        y += 1;
+    }
+    return Vector(x, y);
+}
+/**
+ * Returns how many hearts are in the heart UI row. If the player has more than 6 hearts, this
+ * function will return 6.
+ */
+export function getHeartRowLength(player) {
+    const maxHearts = player.GetMaxHearts();
+    const soulHearts = player.GetSoulHearts();
+    const boneHearts = player.GetBoneHearts();
+    const combinedHearts = maxHearts + soulHearts + boneHearts * 2; // There are no half bone hearts
+    const heartRowLength = combinedHearts / 2;
+    // After 6 hearts, the hearts wrap to a second row.
+    return Math.min(heartRowLength, 6);
+}
+/**
+ * Helper function to get the width of the first player's hearts on the UI. This is useful for
+ * drawing UI elements to the right of where the player's hearts are. Make sure to use this in
+ * combination with the the `getHUDOffsetVector` helper function.
+ */
+export function getHeartsUIWidth() {
+    const level = game.GetLevel();
+    const curses = level.GetCurses();
+    const player = Isaac.GetPlayer();
+    const extraLives = player.GetExtraLives();
+    const effects = player.GetEffects();
+    const hasHolyMantleEffect = effects.HasCollectibleEffect(CollectibleType.HOLY_MANTLE);
+    let heartRowLength = getHeartRowLength(player);
+    if (hasHolyMantleEffect) {
+        heartRowLength += 1;
+    }
+    if (curses === LevelCurse.UNKNOWN) {
+        heartRowLength = 1;
+    }
+    let width = heartRowLength * UI_HEART_WIDTH;
+    if (extraLives > 9) {
+        width += 20;
+        if (player.HasCollectible(CollectibleType.GUPPYS_COLLAR)) {
+            width += 6;
+        }
+    }
+    else if (extraLives > 0) {
+        width += 16;
+        if (player.HasCollectible(CollectibleType.GUPPYS_COLLAR)) {
+            width += 4;
+        }
+    }
+    return width;
+}
+export function getScreenBottomCenterPos() {
+    const bottomRight = getScreenBottomRightPos();
+    return Vector(bottomRight.X / 2, bottomRight.Y);
+}
+export function getScreenBottomLeftPos() {
+    const bottomRight = getScreenBottomRightPos();
+    return Vector(0, bottomRight.Y);
+}
+export function getScreenBottomRightPos() {
+    const screenWidth = Isaac.GetScreenWidth();
+    const screenHeight = Isaac.GetScreenHeight();
+    return Vector(screenWidth, screenHeight);
+}
+export function getScreenCenterPos() {
+    const bottomRight = getScreenBottomRightPos();
+    return bottomRight.div(2);
+}
+export function getScreenTopCenterPos() {
+    const bottomRight = getScreenBottomRightPos();
+    return Vector(bottomRight.X / 2, 0);
+}
+export function getScreenTopLeftPos() {
+    return copyVector(VectorZero);
+}
+export function getScreenTopRightPos() {
+    const bottomRight = getScreenBottomRightPos();
+    return Vector(bottomRight.X, 0);
+}
+/**
+ * Get how many hearts are currently being shown on the hearts UI.
+ *
+ * This function is originally from piber20 Helper.
+ */
+export function getVisibleHearts(player) {
+    const effectiveMaxHearts = player.GetEffectiveMaxHearts();
+    const soulHearts = player.GetSoulHearts();
+    const boneHearts = player.GetBoneHearts();
+    const maxHearts = math.max(effectiveMaxHearts, boneHearts * 2);
+    let visibleHearts = math.ceil((maxHearts + soulHearts) / 2);
+    if (visibleHearts < 1) {
+        visibleHearts = 1;
+    }
+    return visibleHearts;
+}
+//# sourceMappingURL=ui.js.map

package/dist/functions/ui.js.map

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

package/dist/functions/ui.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/ui.ts"],"names":[],"mappings":";AAAA,6CAA4C;AAAnC;AAAiB;AAC1B,0BAAqB;AAAZ;AACT,sBAA2C;AAAlC;AAAgB;AACzB,mBAA2B;AAAlB;AAoGT;AACQ,wBAAc;AACd,yBAAe;AAErB,WAAO,OAAO,aAAa;AAJ7B;;;;;;;;;AAxFA;AACQ,0BAAgB,gBAAW;AAG3B,sBAAY,WAAW,oBAAoB;OAG7C,YAAY,KAAK,YAAY;AAC/B,eAAO;;AAGH,cAAI,YAAY;AAClB,cAAI;OACJ,KAAK;AACP,gBAAK;;OAEH,KAAK;AACP,gBAAK;;AAGP,WAAO,OAAO,GAAG;AApBnB;;;AA2BA,6CAAkC;AAC1B,sBAAY,OAAO;AACnB,uBAAa,OAAO;AACpB,uBAAa,OAAO;AAEpB,2BAAiB,YAAY,aAAa,aAAa;AACvD,2BAAiB,iBAAiB;AAGxC,WAAO,SAAS,gBAAgB;AATlC;;;;AAiBA;AACQ,kBAAQ,KAAK;AACb,mBAAS,MAAM;AACf,mBAAS;AACT,uBAAa,OAAO;AACpB,oBAAU,OAAO;AACjB,gCAAsB,QAAQ,qBAClC;AAGE,2BAAiB,mCAAkB;OACnC;AACF,0CAAkB;;OAEhB,UAAW;AACb,yBAAiB;;AAGf,kBAAQ,iBAAiB;OACzB,aAAa;AACf,wBAAS;WACL,OAAO,eAAe;AACxB,4BAAS;;WAEF,aAAa;AACtB,wBAAS;WACL,OAAO,eAAe;AACxB,4BAAS;;;AAIb,WAAO;AA/BT;AAkCA;AACQ,wBAAc;AACpB,WAAO,OAAO,gBAAgB,GAAG;AAFnC;AAKA;AACQ,wBAAc;AACpB,WAAO,OAAO,GAAG;AAFnB;AAYA;AACQ,wBAAc;AACpB,WAAO,cAAgB;AAFzB;AAKA;AACQ,wBAAc;AACpB,WAAO,OAAO,gBAAgB,GAAG;AAFnC;AAKA;AACE,WAAO,gBAAW;AADpB;AAIA;AACQ,wBAAc;AACpB,WAAO,OAAO,eAAe;AAF/B;;;;AAUA,4CAAiC;AACzB,+BAAqB,OAAO;AAC5B,uBAAa,OAAO;AACpB,uBAAa,OAAO;AAEpB,sBAAY,SAAS,oBAAoB,aAAa;AAExD,0BAAgB,UAAU,CAAC,YAAY,cAAc;OACrD,gBAAgB;AAClB,wBAAgB;;AAGlB,WAAO;AAZT","file":"ui.lua","sourceRoot":"../src/"}