isaacscript-common 6.6.0 → 6.6.1-dev.2

package/functions/stage.js

@@ -0,0 +1,172 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { ROOM_TYPE_GOTO_PREFIXES } from "../objects/roomTypeGotoPrefixes";
+import { STAGE_TYPE_SUFFIXES } from "../objects/stageTypeSuffixes";
+import { STAGE_TYPE_TO_LETTER } from "../objects/stageTypeToLetter";
+/**
+ * Helper function that calculates what the stage type should be for the provided stage. This
+ * emulates what the game's internal code does.
+ */
+export function calculateStageType(stage) {
+    // The following is the game's internal code to determine the floor type. (This came directly from
+    // Spider.)
+    /*
+      u32 Seed = g_Game->GetSeeds().GetStageSeed(NextStage);
+      if (!g_Game->IsGreedMode()) {
+        StageType = ((Seed % 2) == 0 && (
+          ((NextStage == STAGE1_1 || NextStage == STAGE1_2) && gd.Unlocked(ACHIEVEMENT_CELLAR)) ||
+          ((NextStage == STAGE2_1 || NextStage == STAGE2_2) && gd.Unlocked(ACHIEVEMENT_CATACOMBS)) ||
+          ((NextStage == STAGE3_1 || NextStage == STAGE3_2) && gd.Unlocked(ACHIEVEMENT_NECROPOLIS)) ||
+          ((NextStage == STAGE4_1 || NextStage == STAGE4_2)))
+        ) ? STAGE_TYPE_WOTL : STAGE_TYPE_ORIGINAL;
+      if (Seed % 3 == 0 && NextStage < STAGE5)
+        StageType = STAGE_TYPE_AFTERBIRTH;
+    */
+    const seeds = game.GetSeeds();
+    const stageSeed = seeds.GetStageSeed(stage);
+    if (stageSeed % 2 === 0) {
+        return StageType.WRATH_OF_THE_LAMB;
+    }
+    if (stageSeed % 3 === 0) {
+        return StageType.AFTERBIRTH;
+    }
+    return StageType.ORIGINAL;
+}
+/**
+ * Helper function that calculates what the Repentance stage type should be for the provided stage.
+ * This emulates what the game's internal code does.
+ */
+export function calculateStageTypeRepentance(stage) {
+    // There is no alternate floor for Corpse.
+    if (stage === LevelStage.WOMB_1 || stage === LevelStage.WOMB_2) {
+        return StageType.REPENTANCE;
+    }
+    // This algorithm is from Kilburn. We add one because the alt path is offset by 1 relative to the
+    // normal path.
+    const seeds = game.GetSeeds();
+    const adjustedStage = (stage + 1);
+    const stageSeed = seeds.GetStageSeed(adjustedStage);
+    // Kilburn does not know why he divided the stage seed by 2 first.
+    const halfStageSeed = Math.floor(stageSeed / 2);
+    if (halfStageSeed % 2 === 0) {
+        return StageType.REPENTANCE_B;
+    }
+    return StageType.REPENTANCE;
+}
+/**
+ * Helper function to account for Repentance floors being offset by 1. For example, Downpour 2 is
+ * the third level of the run, but the game considers it to have a stage of 2. This function will
+ * consider Downpour 2 to have a stage of 3.
+ */
+export function getEffectiveStage() {
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    if (onRepentanceStage()) {
+        return stage + 1; // eslint-disable-line isaacscript/strict-enums
+    }
+    return stage;
+}
+/**
+ * Helper function to get the corresponding "goto" console command that would correspond to the
+ * provided room type and room variant.
+ */
+export function getGotoCommand(roomType, roomVariant) {
+    const prefix = ROOM_TYPE_GOTO_PREFIXES[roomType];
+    return `goto ${prefix}.${roomVariant}`;
+}
+/** Alias for the `Level.GetStage` method. */
+export function getStage() {
+    const level = game.GetLevel();
+    return level.GetStage();
+}
+/** Alias for the `Level.GetStageType` method. */
+export function getStageType() {
+    const level = game.GetLevel();
+    return level.GetStageType();
+}
+/** Helper function to directly warp to a specific stage using the "stage" console command. */
+export function goToStage(stage, stageType) {
+    const stageTypeLetterSuffix = stageTypeToLetter(stageType);
+    const command = `stage ${stage}${stageTypeLetterSuffix}`;
+    Isaac.ExecuteCommand(command);
+}
+export function isRepentanceStage(stageType) {
+    return (stageType === StageType.REPENTANCE || stageType === StageType.REPENTANCE_B);
+}
+export function onCathedral() {
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    const stageType = level.GetStageType();
+    return (stage === LevelStage.SHEOL_CATHEDRAL &&
+        stageType === StageType.WRATH_OF_THE_LAMB);
+}
+export function onChest() {
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    const stageType = level.GetStageType();
+    return (stage === LevelStage.DARK_ROOM_CHEST &&
+        stageType === StageType.WRATH_OF_THE_LAMB);
+}
+export function onDarkRoom() {
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    const stageType = level.GetStageType();
+    return (stage === LevelStage.DARK_ROOM_CHEST && stageType === StageType.ORIGINAL);
+}
+/**
+ * Returns whether or not the player is on the "final floor" of the particular run. The final floor
+ * is defined as one that prevents the player from entering the I AM ERROR room on.
+ *
+ * For example, when using Undefined on The Chest, it has a 50% chance of teleporting the player to
+ * the Secret Room and a 50% chance of teleporting the player to the Super Secret Room, because the
+ * I AM ERROR room is never entered into the list of possibilities.
+ */
+export function onFinalFloor() {
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    return (stage === LevelStage.DARK_ROOM_CHEST ||
+        stage === LevelStage.THE_VOID ||
+        stage === LevelStage.HOME ||
+        (stage === LevelStage.WOMB_2 && onRepentanceStage()) // Corpse 2
+    );
+}
+export function onRepentanceStage() {
+    const level = game.GetLevel();
+    const stageType = level.GetStageType();
+    return isRepentanceStage(stageType);
+}
+export function onSheol() {
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    const stageType = level.GetStageType();
+    return (stage === LevelStage.SHEOL_CATHEDRAL && stageType === StageType.ORIGINAL);
+}
+/**
+ * Helper function to warp to a new stage/level.
+ *
+ * @param stage The stage number to warp to.
+ * @param stageType The stage type to warp to.
+ * @param reseed Optional. Whether or not to reseed the floor upon arrival. Default is false. Set
+ *               this to true if you are warping to the same stage but a different stage type (or
+ *               else the floor layout will be identical to the old floor).
+ */
+export function setStage(stage, stageType, reseed = false) {
+    // Build the command that will take us to the next floor.
+    const stageTypeSuffix = STAGE_TYPE_SUFFIXES[stageType];
+    const command = `stage ${stage}${stageTypeSuffix}`;
+    Isaac.ExecuteCommand(command);
+    if (reseed) {
+        // Doing a "reseed" immediately after a "stage" command won't mess anything up.
+        Isaac.ExecuteCommand("reseed");
+    }
+}
+/**
+ * Helper function to convert a numerical `StageType` into the letter suffix supplied to the "stage"
+ * console command. For example, `StageType.REPENTANCE` is the stage type for Downpour, and the
+ * console command to go to Downpour is "stage 1c", so this function converts `StageType.REPENTANCE`
+ * to "c".
+ */
+export function stageTypeToLetter(stageType) {
+    return STAGE_TYPE_TO_LETTER[stageType];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9zdGFnZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFZLFNBQVMsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQy9FLE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUN4QyxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMxRSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUNuRSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUVwRTs7O0dBR0c7QUFDSCxNQUFNLFVBQVUsa0JBQWtCLENBQUMsS0FBaUI7SUFDbEQsa0dBQWtHO0lBQ2xHLFdBQVc7SUFFWDs7Ozs7Ozs7Ozs7TUFXRTtJQUVGLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztJQUM5QixNQUFNLFNBQVMsR0FBRyxLQUFLLENBQUMsWUFBWSxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBRTVDLElBQUksU0FBUyxHQUFHLENBQUMsS0FBSyxDQUFDLEVBQUU7UUFDdkIsT0FBTyxTQUFTLENBQUMsaUJBQWlCLENBQUM7S0FDcEM7SUFFRCxJQUFJLFNBQVMsR0FBRyxDQUFDLEtBQUssQ0FBQyxFQUFFO1FBQ3ZCLE9BQU8sU0FBUyxDQUFDLFVBQVUsQ0FBQztLQUM3QjtJQUVELE9BQU8sU0FBUyxDQUFDLFFBQVEsQ0FBQztBQUM1QixDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLDRCQUE0QixDQUFDLEtBQWlCO0lBQzVELDBDQUEwQztJQUMxQyxJQUFJLEtBQUssS0FBSyxVQUFVLENBQUMsTUFBTSxJQUFJLEtBQUssS0FBSyxVQUFVLENBQUMsTUFBTSxFQUFFO1FBQzlE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

package/functions/stage.lua

@@ -140,3 +140,5 @@ function ____exports.setStage(self, stage, stageType, reseed)
     end
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3N0YWdlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQSw2Q0FBZ0Q7QUFBdkM7QUFBc0I7QUFDL0IsMEJBQXFCO0FBQVo7QUFDVCxpQ0FBd0M7QUFBL0I7QUFDVCw4QkFBb0M7QUFBM0I7QUFDVCw4QkFBcUM7QUFBNUI7QUE0R1QsNkNBQWtDO0FBQ2hDLFdBQ0UsYUFBYyx3QkFBd0IsYUFBYztBQUZ4RDtBQTBEQTtBQUNRLGtCQUFRLEtBQUs7QUFDYixzQkFBWSxNQUFNO0FBRXhCLFdBQU8sbUNBQWtCO0FBSjNCOzs7OztBQWdEQSw2Q0FBa0M7QUFDaEMsV0FBTyxxQkFBcUI7QUFEOUI7OztBQWhOQSw4Q0FBbUM7QUFpQjNCLGtCQUFRLEtBQUs7QUFDYixzQkFBWSxNQUFNLGFBQWE7T0FFakMsWUFBWSxLQUFNO0FBQ3BCLGVBQU87O09BR0wsWUFBWSxLQUFNO0FBQ3BCLGVBQU87O0FBR1QsV0FBTztBQTVCVDs7O0FBbUNBLHdEQUE2QztPQUV2QyxTQUFVLHFCQUFxQixTQUFVO0FBQzNDLGVBQU87O0FBS0gsa0JBQVEsS0FBSztBQUNiLDBCQUFpQixRQUFpQjtBQUNsQyxzQkFBWSxNQUFNLGFBQWE7QUFHL0IsMEJBQWdCLFdBQVcsWUFBWTtPQUN6QyxnQkFBZ0IsS0FBTTtBQUN4QixlQUFPOztBQUdULFdBQU87QUFsQlQ7Ozs7QUEwQkE7QUFDUSxrQkFBUSxLQUFLO0FBQ2Isa0JBQVEsTUFBTTtPQUVoQjtBQUNGLGVBQU8sUUFBUTs7QUFHakIsV0FBTztBQVJUOzs7QUFlQSwwQ0FBK0IsVUFBb0I7QUFDM0MsbUJBQVMsd0JBQXdCO0FBQ3ZDLGFBQU8sV0FBUSxXQUFNLGlCQUFJO0FBRjNCOztBQU1BO0FBQ1Esa0JBQVEsS0FBSztBQUVuQixXQUFPLE1BQU07QUFIZjs7QUFPQTtBQUNRLGtCQUFRLEtBQUs7QUFFbkIsV0FBTyxNQUFNO0FBSGY7O0FBT0EscUNBQTBCLE9BQW1CO0FBQ3JDLGtDQUF3QixtQ0FBa0I7QUFDMUMscUJBQVUscUJBQVMsV0FBUTtJQUNqQyxxQkFBcUI7QUFIdkI7QUFZQTtBQUNRLGtCQUFRLEtBQUs7QUFDYixrQkFBUSxNQUFNO0FBQ2Qsc0JBQVksTUFBTTtBQUV4QixXQUNFLFNBQVUsK0JBQ1YsYUFBYztBQVBsQjtBQVdBO0FBQ1Esa0JBQVEsS0FBSztBQUNiLGtCQUFRLE1BQU07QUFDZCxzQkFBWSxNQUFNO0FBRXhCLFdBQ0UsU0FBVSwrQkFDVixhQUFjO0FBUGxCO0FBV0E7QUFDUSxrQkFBUSxLQUFLO0FBQ2Isa0JBQVEsTUFBTTtBQUNkLHNCQUFZLE1BQU07QUFFeEIsV0FDRSxTQUFVLCtCQUE4QixhQUFjO0FBTjFEOzs7Ozs7O0FBa0JBO0FBQ1Esa0JBQVEsS0FBSztBQUNiLGtCQUFRLE1BQU07QUFFcEIsV0FDRSxTQUFVLDhCQUNWLFNBQVUsdUJBQ1YsU0FBVSxtQkFDVCxTQUFVLHNCQUFxQjtBQVJwQztBQW1CQTtBQUNRLGtCQUFRLEtBQUs7QUFDYixrQkFBUSxNQUFNO0FBQ2Qsc0JBQVksTUFBTTtBQUV4QixXQUNFLFNBQVUsK0JBQThCLGFBQWM7QUFOMUQ7Ozs7Ozs7O0FBbUJBLG9DQUNFLE9BQ0EsV0FDQTtPQUFBO1FBQUEsU0FBUzs7QUFHSCw0QkFBa0Isb0JBQW9CO0FBQ3RDLHFCQUFVLHFCQUFTLFdBQVE7SUFDakMscUJBQXFCO09BRWpCO1FBRUYscUJBQXFCOztBQVp6QiIsImZpbGUiOiJzdGFnZS5sdWEiLCJzb3VyY2VSb290IjoiIn0=

package/functions/string.js

@@ -0,0 +1,37 @@
+export function capitalizeFirstLetter(string) {
+    const firstCharacter = string.charAt(0);
+    const capitalizedFirstLetter = firstCharacter.toUpperCase();
+    const restOfString = string.slice(1);
+    return `${capitalizedFirstLetter}${restOfString}`;
+}
+export function removeAllCharacters(string, character) {
+    return string.replaceAll(character, "");
+}
+/**
+ * Helper function to remove one or more substrings from a string, if they exist. Returns the
+ * modified string.
+ *
+ * This function is variadic, meaning that you can pass as many substrings as you want to remove.
+ */
+export function removeSubstring(string, ...substrings) {
+    for (const substring of substrings) {
+        string = string.replaceAll(substring, "");
+    }
+    return string;
+}
+/** Helper function to trim a prefix from a string, if it exists. Returns the trimmed string. */
+export function trimPrefix(string, prefix) {
+    if (!string.startsWith(prefix)) {
+        return string;
+    }
+    return string.slice(prefix.length);
+}
+/** Helper function to trim a suffix from a string, if it exists. Returns the trimmed string. */
+export function trimSuffix(string, prefix) {
+    if (!string.endsWith(prefix)) {
+        return string;
+    }
+    const endCharacter = string.length - prefix.length;
+    return string.slice(0, endCharacter);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RyaW5nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvc3RyaW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE1BQU0sVUFBVSxxQkFBcUIsQ0FBQyxNQUFjO0lBQ2xELE1BQU0sY0FBYyxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDeEMsTUFBTSxzQkFBc0IsR0FBRyxjQUFjLENBQUMsV0FBVyxFQUFFLENBQUM7SUFDNUQsTUFBTSxZQUFZLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUVyQyxPQUFPLEdBQUcsc0JBQXNCLEdBQUcsWUFBWSxFQUFFLENBQUM7QUFDcEQsQ0FBQztBQUVELE1BQU0sVUFBVSxtQkFBbUIsQ0FBQyxNQUFjLEVBQUUsU0FBaUI7SUFDbkUsT0FBTyxNQUFNLENBQUMsVUFBVSxDQUFDLFNBQVMsRUFBRSxFQUFFLENBQUMsQ0FBQztBQUMxQyxDQUFDO0FBRUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLFVBQVUsZUFBZSxDQUM3QixNQUFjLEVBQ2QsR0FBRyxVQUFvQjtJQUV2QixLQUFLLE1BQU0sU0FBUyxJQUFJLFVBQVUsRUFBRTtRQUNsQyxNQUFNLEdBQUcsTUFBTSxDQUFDLFVBQVUsQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDLENBQUM7S0FDM0M7SUFFRCxPQUFPLE1BQU0sQ0FBQztBQUNoQixDQUFDO0FBRUQsZ0dBQWdHO0FBQ2hHLE1BQU0sVUFBVSxVQUFVLENBQUMsTUFBYyxFQUFFLE1BQWM7SUFDdkQsSUFBSSxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLEVBQUU7UUFDOUIsT0FBTyxNQUFNLENBQUM7S0FDZjtJQUVELE9BQU8sTUFBTSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUM7QUFDckMsQ0FBQztBQUVELGdHQUFnRztBQUNoRyxNQUFNLFVBQVUsVUFBVSxDQUFDLE1BQWMsRUFBRSxNQUFjO0lBQ3ZELElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxFQUFFO1FBQzVCLE9BQU8sTUFBTSxDQUFDO0tBQ2Y7SUFFRCxNQUFNLFlBQVksR0FBRyxNQUFNLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDbkQsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxZQUFZLENBQUMsQ0FBQztBQUN2QyxDQUFDIn0=

package/functions/string.lua

@@ -40,3 +40,5 @@ function ____exports.trimSuffix(self, ____string, prefix)
     return __TS__StringSlice(____string, 0, endCharacter)
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3N0cmluZy50cyJdLCJuYW1lcyI6WyJzdHJpbmciXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLGlEQUFzQ0E7QUFDOUIsMkJBQWlCLFdBQUFBLFlBQWM7QUFDL0IsbUNBQXlCO0FBQ3pCLHlCQUFlLFdBQUFBLFlBQWE7QUFFbEMsV0FBVSwwQkFBeUI7QUFMckM7QUFRQSwrQ0FBb0NBLFlBQWdCO0FBQ2xELFdBQU8sdUJBQUFBLFlBQWtCLFdBQVc7QUFEdEM7Ozs7O0FBVUEsMkNBQ0VBO1VBQ0c7QUFFSCxjQUFXLG9CQUFhO0FBQ3RCLFFBQUFBLGFBQVMsdUJBQUFBLFlBQWtCLFdBQVc7O0FBR3hDLFdBQU9BO0FBUlQ7O0FBWUEsc0NBQTJCQSxZQUFnQjtXQUNwQyx1QkFBQUEsWUFBa0I7QUFDckIsZUFBT0E7O0FBR1QsV0FBTyxrQkFBQUEsWUFBYTtBQUx0Qjs7QUFTQSxzQ0FBMkJBLFlBQWdCO1dBQ3BDLHFCQUFBQSxZQUFnQjtBQUNuQixlQUFPQTs7QUFHSCx5QkFBZSxDQUFBQSxhQUFnQjtBQUNyQyxXQUFPLGtCQUFBQSxZQUFhLEdBQUc7QUFOekIiLCJmaWxlIjoic3RyaW5nLmx1YSIsInNvdXJjZVJvb3QiOiIifQ==

package/functions/table.js

@@ -0,0 +1,143 @@
+import { isBoolean, isNumber, isString } from "./types";
+/**
+ * In a Map, you can use the `clear` method to delete every element. However, in a LuaTable, the
+ * `clear` method does not exist. Use this helper function as a drop-in replacement for this.
+ */
+export function clearTable(luaTable) {
+    for (const [key] of pairs(luaTable)) {
+        luaTable.delete(key);
+    }
+}
+/** Helper function to copy specific values from a object to a table. */
+export function copyValuesToTable(object, keys, luaTable) {
+    const otherTable = object;
+    for (const key of keys) {
+        const value = otherTable.get(key);
+        luaTable.set(key, value);
+    }
+}
+/**
+ * Helper function to safely get boolean values from a Lua table. Will throw an error if the
+ * specific value does not exist on the table.
+ *
+ * This function is variadic, meaning that you can specify N arguments to get N values.
+ */
+export function getBooleansFromTable(luaTable, objectName, ...keys) {
+    const booleans = [];
+    for (const key of keys) {
+        const value = luaTable.get(key);
+        if (value === undefined) {
+            error(`Failed to find a value for "${key}" in a table representing a "${objectName}" object.`);
+        }
+        if (isBoolean(value)) {
+            booleans.push(value);
+        }
+        else {
+            error(`Failed to get the boolean for the "${key}" value of a table representing a "${objectName}" object because the type was: ${typeof value}`);
+        }
+    }
+    return booleans;
+}
+/**
+ * Helper function to safely get number values from a Lua table. Will throw an error if the specific
+ * value does not exist on the table or if it cannot be converted to a number.
+ *
+ * This function is variadic, meaning that you can specify N arguments to get N values.
+ */
+export function getNumbersFromTable(luaTable, objectName, ...keys) {
+    const numbers = [];
+    for (const key of keys) {
+        const value = luaTable.get(key);
+        if (value === undefined) {
+            error(`Failed to find a value for "${key}" in a table representing a "${objectName}" object.`);
+        }
+        if (isNumber(value)) {
+            numbers.push(value);
+        }
+        else if (isString(value)) {
+            const number = tonumber(value);
+            if (number === undefined) {
+                error(`Failed to convert the "${key}" value of a table representing a "${objectName}" object to a number: ${value}`);
+            }
+            numbers.push(number);
+        }
+        else {
+            error(`Failed to get the number for the "${key}" value of a table representing a "${objectName}" object because the type was: ${typeof value}`);
+        }
+    }
+    return numbers;
+}
+/**
+ * Helper function to safely get string values from a Lua table. Will throw an error if the specific
+ * value does not exist on the table.
+ *
+ * This function is variadic, meaning that you can specify N arguments to get N values.
+ */
+export function getStringsFromTable(luaTable, objectName, ...keys) {
+    const strings = [];
+    for (const key of keys) {
+        const value = luaTable.get(key);
+        if (value === undefined) {
+            error(`Failed to find a value for "${key}" in a table representing a "${objectName}" object.`);
+        }
+        if (isString(value)) {
+            strings.push(value);
+        }
+        else {
+            const string = tostring(value);
+            strings.push(string);
+        }
+    }
+    return strings;
+}
+/**
+ * Helper function to iterate over a table deterministically. This is useful because by default, the
+ * `pairs` function will return the keys of a Lua table in a random order.
+ *
+ * This function will sort the table entries based on the value of the key.
+ *
+ * This function will only work on tables that have number keys or string keys. It will throw a
+ * runtime error if it encounters a key of another type.
+ *
+ * @param luaTable The table to iterate over.
+ * @param func The function to run for each iteration.
+ * @param inOrder Optional. Whether to iterate in order. True by default. You can dynamically set to
+ *                false in situations where iterating randomly would not matter and you need the
+ *                extra performance.
+ */
+export function iterateTableInOrder(luaTable, func, inOrder = true) {
+    // First, handle the trivial case of a non-deterministic iteration.
+    if (!inOrder) {
+        for (const [key, value] of pairs(luaTable)) {
+            func(key, value);
+        }
+        return;
+    }
+    const keys = Object.keys(luaTable);
+    const hasAllNumberKeys = keys.every((key) => isNumber(key));
+    const hasAllStringKeys = keys.every((key) => isString(key));
+    if (!hasAllNumberKeys && !hasAllStringKeys) {
+        // Since the table has non-homogenous keys, we won't be able to sort it. Revert to
+        // non-deterministic iteration in this case.
+        for (const [key, value] of pairs(luaTable)) {
+            func(key, value);
+        }
+        return;
+    }
+    keys.sort();
+    for (const key of keys) {
+        const keyIndex = key;
+        const value = luaTable.get(keyIndex);
+        func(keyIndex, value);
+    }
+}
+/**
+ * Helper function to check if a Lua table has all of the provided keys.
+ *
+ * This function is variadic, meaning that you can specify as many arguments as you want to check
+ * for.
+ */
+export function tableHasKeys(luaTable, ...keys) {
+    return keys.every((key) => luaTable.has(key));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFibGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy90YWJsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsU0FBUyxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFFeEQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLFVBQVUsQ0FBQyxRQUFrQjtJQUMzQyxLQUFLLE1BQU0sQ0FBQyxHQUFHLENBQUMsSUFBSSxLQUFLLENBQUMsUUFBUSxDQUFDLEVBQUU7UUFDbkMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztLQUN0QjtBQUNILENBQUM7QUFFRCx3RUFBd0U7QUFDeEUsTUFBTSxVQUFVLGlCQUFpQixDQUMvQixNQUFlLEVBQ2YsSUFBYyxFQUNkLFFBQW1DO0lBRW5DLE1BQU0sVUFBVSxHQUFHLE1BQTJDLENBQUM7SUFFL0QsS0FBSyxNQUFNLEdBQUcsSUFBSSxJQUFJLEVBQUU7UUFDdEIsTUFBTSxLQUFLLEdBQUcsVUFBVSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUNsQyxRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxLQUFLLENBQUMsQ0FBQztLQUMxQjtBQUNILENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSxvQkFBb0IsQ0FDbEMsUUFBbUMsRUFDbkMsVUFBa0IsRUFDbEIsR0FBRyxJQUFjO0lBRWpCLE1BQU0sUUFBUSxHQUFjLEVBQUUsQ0FBQztJQUMvQixLQUFLLE1BQU0sR0FBRyxJQUFJLElBQUksRUFBRTtRQUN0QixNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ2hDLElBQUksS0FBSyxLQUFLLFNBQVMsRUFBRTtZQUN2QixLQUFLLENBQ0gsK0JBQStCLEdBQUcsZ0NBQWdDLFVBQVUsV0FB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

package/functions/table.lua

@@ -147,3 +147,5 @@ function ____exports.tableHasKeys(self, luaTable, ...)
     )
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3RhYmxlLnRzIl0sIm5hbWVzIjpbInN0cmluZyJdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBQUEsa0JBQThDO0FBQXJDO0FBQVc7QUFBVTs7O0FBTTlCLHNDQUEyQjtBQUN6QixRQUFZLE9BQVEsTUFBTTtBQUN4QixpQkFBZ0I7O0FBRnBCOztBQU9BLDZDQUNFLFFBQ0EsTUFDQTtBQUVNLHVCQUFhO0FBRW5CLGNBQVcsY0FBTztBQUNWLHNCQUFRLFdBQWU7QUFDN0IsaUJBQWEsT0FBSzs7QUFUdEI7Ozs7O0FBbUJBLGdEQUNFLFVBQ0E7VUFDRztBQUVHLHFCQUFzQjtBQUM1QixjQUFXLGNBQU87QUFDVixzQkFBUSxTQUFhO1dBQ3ZCO1lBQ0YsU0FDRSxtQ0FBK0IsUUFBRyxzQ0FBZ0MsZUFBVTs7V0FJNUUsZUFBVTtBQUNaLHNDQUFjOztZQUVkLFVBQ0UsMENBQXNDLFFBQUcsNENBQXNDLGVBQVUsdUNBQWtDLGFBQU87OztBQUt4SSxXQUFPO0FBdkJUOzs7OztBQWdDQSwrQ0FDRSxVQUNBO1VBQ0c7QUFFRyxvQkFBb0I7QUFDMUIsY0FBVyxjQUFPO0FBQ1Ysc0JBQVEsU0FBYTtXQUN2QjtZQUNGLFNBQ0UsbUNBQStCLFFBQUcsc0NBQWdDLGVBQVU7O1dBSTVFLGNBQVM7QUFDWCxvQ0FBYTtlQUNKLGNBQVM7QUFDWiwyQkFBUyxTQUFTO2VBQ3BCO2dCQUNGLFVBQ0UsOEJBQTBCLFFBQUcsNENBQXNDLGVBQVUsOEJBQXlCOztBQUcxRyxvQ0FBYTs7WUFFYixVQUNFLHlDQUFxQyxRQUFHLDRDQUFzQyxlQUFVLHVDQUFrQyxhQUFPOzs7QUFLdkksV0FBTztBQS9CVDs7Ozs7QUF3Q0EsK0NBQ0UsVUFDQTtVQUNHO0FBRUcsb0JBQW9CO0FBQzFCLGNBQVcsY0FBTztBQUNWLHNCQUFRLFNBQWE7V0FDdkI7WUFDRixTQUNFLG1DQUErQixRQUFHLHNDQUFnQyxlQUFVOztXQUk1RSxjQUFTO0FBQ1gsb0NBQWE7O0FBRVAsa0JBQUFBLGFBQVMsU0FBUztBQUN4QixvQ0FBYUE7OztBQUlqQixXQUFPO0FBdEJUOzs7Ozs7Ozs7Ozs7OztBQXdDQSwrQ0FDRSxVQUNBLE1BQ0E7T0FBQTtRQUFBLFVBQVU7O1dBR0w7QUFDSCxZQUFZLEtBQUssU0FBVSxNQUFNO1lBQy9CLFVBQUssS0FBSzs7QUFFWjs7QUFHSSxpQkFBTyxpQkFBWTtBQUNuQiw2QkFBbUI7UUFBQTtRQUFXLGVBQUMsS0FBUSxxQkFBUyxJQUFsQjs7QUFDOUIsNkJBQW1CO1FBQUE7UUFBVyxlQUFDLEtBQVEscUJBQVMsSUFBbEI7O09BQ2hDLElBQUMseUJBQXFCO0FBR3hCLFlBQVksS0FBSyxTQUFVLE1BQU07WUFDL0IsVUFBSyxLQUFLOztBQUVaOztJQUVGO0FBRUEsY0FBVyxjQUFPO0FBQ1YseUJBQVc7QUFDWCxzQkFBUSxTQUFhO1FBQzNCLFVBQUssVUFBVTs7QUE3Qm5COzs7OztBQXVDQSx3Q0FDRTtVQUNHO0FBRUgsV0FBTztRQUFBO1FBQVcsZUFBQyxLQUFRLGdCQUFhLFdBQXRCOztBQUpwQiIsImZpbGUiOiJ0YWJsZS5sdWEiLCJzb3VyY2VSb290IjoiIn0=

package/functions/tears.js

@@ -0,0 +1,31 @@
+/**
+ * - Converts the specified amount of tears stat into MaxFireDelay and adds it to the player.
+ * - This function should only be used inside the EvaluateCache callback.
+ * - In this context, the "tears stat" represents what is shown on the in-game stat UI.
+ */
+export function addTearsStat(player, tearsStat) {
+    const existingTearsStat = getTearsStat(player.MaxFireDelay);
+    const newTearsStat = existingTearsStat + tearsStat;
+    const newMaxFireDelay = getFireDelay(newTearsStat);
+    player.MaxFireDelay = newMaxFireDelay;
+}
+/**
+ * - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` attribute. This is
+ *   equivalent to how many tears the player can shoot per frame.
+ * - If you already have a "tears" stat and you want to convert it back to MaxFireDelay, then use
+ *   this function.
+ * - In this context, the "tears stat" represents what is shown on the in-game stat UI.
+ */
+export function getFireDelay(tearsStat) {
+    return math.max(30 / tearsStat - 1, -0.9999);
+}
+/**
+ * - The `EntityPlayer` object stores a player's tear rate in the `MaxFireDelay` attribute. This is
+ *   equivalent to how many tears the player can shoot per frame.
+ * - If you want to convert this to the "tears" stat that is shown on the in-game stat UI, then use
+ *   this function.
+ */
+export function getTearsStat(fireDelay) {
+    return 30 / (fireDelay + 1);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVhcnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy90ZWFycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLFlBQVksQ0FBQyxNQUFvQixFQUFFLFNBQWdCO0lBQ2pFLE1BQU0saUJBQWlCLEdBQUcsWUFBWSxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsQ0FBQztJQUM1RCxNQUFNLFlBQVksR0FBRyxpQkFBaUIsR0FBRyxTQUFTLENBQUM7SUFDbkQsTUFBTSxlQUFlLEdBQUcsWUFBWSxDQUFDLFlBQVksQ0FBQyxDQUFDO0lBQ25ELE1BQU0sQ0FBQyxZQUFZLEdBQUcsZUFBZSxDQUFDO0FBQ3hDLENBQUM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsWUFBWSxDQUFDLFNBQWdCO0lBQzNDLE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLEdBQUcsU0FBUyxHQUFHLENBQUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQy9DLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSxZQUFZLENBQUMsU0FBZ0I7SUFDM0MsT0FBTyxFQUFFLEdBQUcsQ0FBQyxTQUFTLEdBQUcsQ0FBQyxDQUFDLENBQUM7QUFDOUIsQ0FBQyJ9

package/functions/tears.lua

@@ -24,3 +24,5 @@ function ____exports.addTearsStat(self, player, tearsStat)
     player.MaxFireDelay = newMaxFireDelay
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3RlYXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQW1CQSx3Q0FBNkI7QUFDM0IsV0FBTyxTQUFTLEtBQUssWUFBWSxJQUFJO0FBRHZDOzs7OztBQVVBLHdDQUE2QjtBQUMzQixXQUFPLEtBQU0sYUFBWTtBQUQzQjs7OztBQXhCQSx3Q0FBNkIsUUFBc0I7QUFDM0MsOEJBQW9CLDhCQUFhO0FBQ2pDLHlCQUFlLG9CQUFvQjtBQUNuQyw0QkFBa0IsOEJBQWE7QUFDckMsMEJBQXNCO0FBSnhCIiwiZmlsZSI6InRlYXJzLmx1YSIsInNvdXJjZVJvb3QiOiIifQ==

package/functions/transformations.js

@@ -0,0 +1,101 @@
+import { ItemConfigTag, PlayerForm, } from "isaac-typescript-definitions";
+import { TRANSFORMATION_NAMES } from "../objects/transformationNames";
+import { getCollectibleTags } from "./collectibles";
+import { getCollectibleTypesWithTag } from "./collectibleTag";
+import { getEnumValues } from "./enums";
+import { hasFlag } from "./flag";
+import { getPlayerCollectibleCount } from "./player";
+const TRANSFORMATION_TO_TAG_MAP = new Map([
+    [PlayerForm.GUPPY, ItemConfigTag.GUPPY],
+    [PlayerForm.BEELZEBUB, ItemConfigTag.FLY],
+    [PlayerForm.FUN_GUY, ItemConfigTag.MUSHROOM],
+    [PlayerForm.SERAPHIM, ItemConfigTag.ANGEL],
+    [PlayerForm.BOB, ItemConfigTag.BOB],
+    [PlayerForm.SPUN, ItemConfigTag.SYRINGE],
+    [PlayerForm.YES_MOTHER, ItemConfigTag.MOM],
+    [PlayerForm.CONJOINED, ItemConfigTag.BABY],
+    [PlayerForm.LEVIATHAN, ItemConfigTag.DEVIL],
+    [PlayerForm.OH_CRAP, ItemConfigTag.POOP],
+    [PlayerForm.BOOKWORM, ItemConfigTag.BOOK],
+    // PlayerForm.ADULTHOOD (11) is based on pill usage.
+    [PlayerForm.SPIDER_BABY, ItemConfigTag.SPIDER], // 12
+    // PlayerForm.STOMPY (13) is based on size.
+]);
+const TRANSFORMATIONS_THAT_GRANT_FLYING = new Set([
+    PlayerForm.GUPPY,
+    PlayerForm.BEELZEBUB,
+    PlayerForm.SERAPHIM,
+    PlayerForm.LEVIATHAN, // 8
+]);
+/**
+ * Helper function to get all of the collectible types in the game that count towards a particular
+ * transformation.
+ *
+ * For example, to get all of the collectible types that count towards Guppy:
+ *
+ * ```ts
+ * const guppyCollectibleTypes = getCollectibleTypesForTransformation(PlayerForm.GUPPY);
+ * ```
+ */
+export function getCollectibleTypesForTransformation(playerForm) {
+    const itemConfigTag = TRANSFORMATION_TO_TAG_MAP.get(playerForm);
+    if (itemConfigTag === undefined) {
+        error(`Failed to get the collectible types for the transformation of ${playerForm} because that transformation is not based on collectibles.`);
+    }
+    return getCollectibleTypesWithTag(itemConfigTag);
+}
+/** Returns the number of items that a player has towards a particular transformation. */
+export function getPlayerNumCollectiblesForTransformation(player, playerForm) {
+    const collectibleTypes = getCollectibleTypesForTransformation(playerForm);
+    return getPlayerCollectibleCount(player, ...collectibleTypes.values());
+}
+/** Returns a set of the player's current transformations. */
+export function getPlayerTransformations(player) {
+    const transformations = new Set();
+    for (const playerForm of getEnumValues(PlayerForm)) {
+        if (player.HasPlayerForm(playerForm)) {
+            transformations.add(playerForm);
+        }
+    }
+    return transformations;
+}
+/**
+ * Helper function to get a transformation name from a PlayerForm enum.
+ *
+ * For example:
+ *
+ * ```ts
+ * const transformationName = getTransformationName(PlayerForm.LORD_OF_THE_FLIES);
+ * // transformationName is "Beelzebub"
+ * ```
+ */
+export function getTransformationName(playerForm) {
+    return TRANSFORMATION_NAMES[playerForm];
+}
+export function getTransformationsForCollectibleType(collectibleType) {
+    const itemConfigTags = getCollectibleTags(collectibleType);
+    const playerForms = getEnumValues(PlayerForm);
+    const transformationSet = new Set();
+    for (const playerForm of playerForms) {
+        const itemConfigTag = TRANSFORMATION_TO_TAG_MAP.get(playerForm);
+        if (itemConfigTag === undefined) {
+            continue;
+        }
+        if (hasFlag(itemConfigTags, itemConfigTag)) {
+            transformationSet.add(playerForm);
+        }
+    }
+    return transformationSet;
+}
+export function hasFlyingTransformation(player) {
+    for (const playerForm of TRANSFORMATIONS_THAT_GRANT_FLYING.values()) {
+        if (player.HasPlayerForm(playerForm)) {
+            return true;
+        }
+    }
+    return false;
+}
+export function isTransformationFlying(playerForm) {
+    return TRANSFORMATIONS_THAT_GRANT_FLYING.has(playerForm);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJhbnNmb3JtYXRpb25zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvdHJhbnNmb3JtYXRpb25zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFFTCxhQUFhLEVBQ2IsVUFBVSxHQUNYLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDdEUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDcEQsT0FBTyxFQUFFLDBCQUEwQixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDOUQsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUN4QyxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sUUFBUSxDQUFDO0FBQ2pDLE9BQU8sRUFBRSx5QkFBeUIsRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUVyRCxNQUFNLHlCQUF5QixHQUM3QixJQUFJLEdBQUcsQ0FBQztJQUNOLENBQUMsVUFBVSxDQUFDLEtBQUssRUFBRSxhQUFhLENBQUMsS0FBSyxDQUFDO0lBQ3ZDLENBQUMsVUFBVSxDQUFDLFNBQVMsRUFBRSxhQUFhLENBQUMsR0FBRyxDQUFDO0lBQ3pDLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxhQUFhLENBQUMsUUFBUSxDQUFDO0lBQzVDLENBQUMsVUFBVSxDQUFDLFFBQVEsRUFBRSxhQUFhLENBQUMsS0FBSyxDQUFDO0lBQzFDLENBQUMsVUFBVSxDQUFDLEdBQUcsRUFBRSxhQUFhLENBQUMsR0FBRyxDQUFDO0lBQ25DLENBQUMsVUFBVSxDQUFDLElBQUksRUFBRSxhQUFhLENBQUMsT0FBTyxDQUFDO0lBQ3hDLENBQUMsVUFBVSxDQUFDLFVBQVUsRUFBRSxhQUFhLENBQUMsR0FBRyxDQUFDO0lBQzFDLENBQUMsVUFBVSxDQUFDLFNBQVMs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

package/functions/transformations.lua

@@ -110,3 +110,5 @@ function ____exports.isTransformationFlying(self, playerForm)
     return TRANSFORMATIONS_THAT_GRANT_FLYING:has(playerForm)
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3RyYW5zZm9ybWF0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7O0FBQUEsNkNBSU87QUFGTDtBQUNBO0FBRUYsZ0NBQXFDO0FBQTVCO0FBQ1QseUJBQW1DO0FBQTFCO0FBQ1QsMkJBQTJDO0FBQWxDO0FBQ1Qsa0JBQThCO0FBQXJCO0FBQ1QsaUJBQXdCO0FBQWY7QUFDVCxtQkFBMEM7QUFBakM7QUFFSCxrQ0FDSixVQUFJLEtBQUk7SUFDTixDQUFDLGtCQUFrQjtJQUNuQixDQUFDLHNCQUFzQjtJQUN2QixDQUFDLG9CQUFvQjtJQUNyQixDQUFDLHFCQUFxQjtJQUN0QixDQUFDLGdCQUFnQjtJQUNqQixDQUFDLGlCQUFpQjtJQUNsQixDQUFDLHVCQUF1QjtJQUN4QixDQUFDLHNCQUFzQjtJQUN2QixDQUFDLHNCQUFzQjtJQUN2QixDQUFDLG9CQUFvQjtJQUNyQixDQUFDLHFCQUFxQjtJQUV0QixDQUFDLHdCQUF3Qjs7QUFJdkIsMENBQTZELFVBQUksS0FBSSxDQUN6RSxrQkFDQSxzQkFDQSxxQkFDQTs7Ozs7Ozs7O0FBYUYsZ0VBQ0U7QUFFTSwwQkFBZ0IsMEJBQTBCLElBQUk7T0FDaEQ7UUFDRixPQUNFLDZFQUFpRSxnQkFBVTs7QUFJL0UsV0FBTyxnQ0FBMkI7QUFWcEM7O0FBY0EscUVBQ0UsUUFDQTtBQUVNLDZCQUFtQixzREFBcUM7QUFDOUQsV0FBTzs7UUFBMEI7UUFBUSxhQUFHLGlCQUFpQjs7QUFML0Q7O0FBU0Esb0RBQ0U7QUFFTSw0QkFBa0IsVUFBSTtBQUM1QixjQUFXLHFCQUFjLG1CQUFjO1dBQ2pDLE9BQU8sY0FBYztZQUN2QixnQkFBZ0IsSUFBSTs7O0FBSXhCLFdBQU87QUFWVDs7Ozs7Ozs7O0FBdUJBLGlEQUFzQztBQUNwQyxXQUFPLHFCQUFxQjtBQUQ5QjtBQUlBLGdFQUNFO0FBRU0sMkJBQWlCLHdCQUFtQjtBQUVwQyx3QkFBYyxtQkFBYztBQUM1Qiw4QkFBb0IsVUFBSTtBQUM5QixjQUFXLHFCQUFjOztBQUNqQixrQ0FBZ0IsMEJBQTBCLElBQUk7ZUFDaEQ7QUFDRjs7ZUFHRSxhQUFRLGdCQUFnQjtnQkFDMUIsa0JBQWtCLElBQUk7Ozs7O0FBSTFCLFdBQU87QUFsQlQ7QUFxQkEsbURBQXdDO0FBQ3RDLGNBQVcsY0FBYyxpREFBa0M7V0FDckQsT0FBTyxjQUFjO0FBQ3ZCLG1CQUFPOzs7QUFJWCxXQUFPO0FBUFQ7QUFVQSxrREFBdUM7QUFDckMsV0FBTyxrQ0FBa0MsSUFBSTtBQUQvQyIsImZpbGUiOiJ0cmFuc2Zvcm1hdGlvbnMubHVhIiwic291cmNlUm9vdCI6IiJ9

package/functions/trinketCacheFlag.js

@@ -0,0 +1,46 @@
+import { CacheFlag } from "isaac-typescript-definitions";
+import { getEnumValues } from "./enums";
+import { copySet } from "./set";
+import { getTrinketTypes, trinketHasCacheFlag } from "./trinkets";
+const CACHE_FLAG_TO_TRINKETS_MAP = new Map();
+function initCacheFlagMap() {
+    for (const cacheFlag of getEnumValues(CacheFlag)) {
+        const trinketsSet = new Set();
+        for (const trinketType of getTrinketTypes()) {
+            if (trinketHasCacheFlag(trinketType, cacheFlag)) {
+                trinketsSet.add(trinketType);
+            }
+        }
+        CACHE_FLAG_TO_TRINKETS_MAP.set(cacheFlag, trinketsSet);
+    }
+}
+/**
+ * Returns a map containing every trinket type that the player has that matches the provided
+ * CacheFlag. The values of the map correspond to the multiplier for that trinket.
+ */
+export function getPlayerTrinketsForCacheFlag(player, cacheFlag) {
+    const trinketsForCacheFlag = getTrinketsForCacheFlag(cacheFlag);
+    const playerTrinkets = new Map();
+    for (const trinketType of trinketsForCacheFlag.values()) {
+        const trinketMultiplier = player.GetTrinketMultiplier(trinketType);
+        if (trinketMultiplier > 0) {
+            playerTrinkets.set(trinketType, trinketMultiplier);
+        }
+    }
+    return playerTrinkets;
+}
+/**
+ * Returns a set containing every trinket type with the given cache flag, including modded trinkets.
+ */
+export function getTrinketsForCacheFlag(cacheFlag) {
+    // Lazy initialize the map.
+    if (CACHE_FLAG_TO_TRINKETS_MAP.size === 0) {
+        initCacheFlagMap();
+    }
+    const trinketsSet = CACHE_FLAG_TO_TRINKETS_MAP.get(cacheFlag);
+    if (trinketsSet === undefined) {
+        return new Set();
+    }
+    return copySet(trinketsSet);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJpbmtldENhY2hlRmxhZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3RyaW5rZXRDYWNoZUZsYWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFNBQVMsRUFBZSxNQUFNLDhCQUE4QixDQUFDO0FBQ3RFLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDeEMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLE9BQU8sQ0FBQztBQUNoQyxPQUFPLEVBQUUsZUFBZSxFQUFFLG1CQUFtQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRWxFLE1BQU0sMEJBQTBCLEdBQUcsSUFBSSxHQUFHLEVBQStCLENBQUM7QUFFMUUsU0FBUyxnQkFBZ0I7SUFDdkIsS0FBSyxNQUFNLFNBQVMsSUFBSSxhQUFhLENBQUMsU0FBUyxDQUFDLEVBQUU7UUFDaEQsTUFBTSxXQUFXLEdBQUcsSUFBSSxHQUFHLEVBQWUsQ0FBQztRQUUzQyxLQUFLLE1BQU0sV0FBVyxJQUFJLGVBQWUsRUFBRSxFQUFFO1lBQzNDLElBQUksbUJBQW1CLENBQUMsV0FBVyxFQUFFLFNBQVMsQ0FBQyxFQUFFO2dCQUMvQyxXQUFXLENBQUMsR0FBRyxDQUFDLFdBQVcsQ0FBQyxDQUFDO2FBQzlCO1NBQ0Y7UUFFRCwwQkFBMEIsQ0FBQyxHQUFHLENBQUMsU0FBUyxFQUFFLFdBQVcsQ0FBQyxDQUFDO0tBQ3hEO0FBQ0gsQ0FBQztBQUVEOzs7R0FHRztBQUNILE1BQU0sVUFBVSw2QkFBNkIsQ0FDM0MsTUFBb0IsRUFDcEIsU0FBb0I7SUFFcEIsTUFBTSxvQkFBb0IsR0FBRyx1QkFBdUIsQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUVoRSxNQUFNLGNBQWMsR0FBRyxJQUFJLEdBQUcsRUFBb0IsQ0FBQztJQUNuRCxLQUFLLE1BQU0sV0FBVyxJQUFJLG9CQUFvQixDQUFDLE1BQU0sRUFBRSxFQUFFO1FBQ3ZELE1BQU0saUJBQWlCLEdBQUcsTUFBTSxDQUFDLG9CQUFvQixDQUFDLFdBQVcsQ0FBQyxDQUFDO1FBQ25FLElBQUksaUJBQWlCLEdBQUcsQ0FBQyxFQUFFO1lBQ3pCLGNBQWMsQ0FBQyxHQUFHLENBQUMsV0FBVyxFQUFFLGlCQUFpQixDQUFDLENBQUM7U0FDcEQ7S0FDRjtJQUVELE9BQU8sY0FBYyxDQUFDO0FBQ3hCLENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sVUFBVSx1QkFBdUIsQ0FDckMsU0FBb0I7SUFFcEIsMkJBQTJCO0lBQzNCLElBQUksMEJBQTBCLENBQUMsSUFBSSxLQUFLLENBQUMsRUFBRTtRQUN6QyxnQkFBZ0IsRUFBRSxDQUFDO0tBQ3BCO0lBRUQsTUFBTSxXQUFXLEdBQUcsMEJBQTBCLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlELElBQUksV0FBVyxLQUFLLFNBQVMsRUFBRTtRQUM3QixPQUFPLElBQUksR0FBRyxFQUFFLENBQUM7S0FDbEI7SUFFRCxPQUFPLE9BQU8sQ0FBQyxXQUFXLENBQUMsQ0FBQztBQUM5QixDQUFDIn0=

package/functions/trinketCacheFlag.lua

@@ -51,3 +51,5 @@ function ____exports.getPlayerTrinketsForCacheFlag(self, player, cacheFlag)
     return playerTrinkets
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL3RyaW5rZXRDYWNoZUZsYWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O01BT1Msa0JBRkg7QUFMTiw2Q0FBdUM7QUFBOUI7QUFDVCxrQkFBOEI7QUFBckI7QUFDVCxnQkFBd0I7QUFBZjtBQUNULHFCQUFxRDtBQUE1QztBQUFpQjtBQUkxQixTQUFTO0FBQ1AsY0FBVyxvQkFBYSxtQkFBYztBQUM5Qiw0QkFBYyxVQUFJO0FBRXhCLGtCQUFXLHNCQUFlO2VBQ3BCLHlCQUFvQixhQUFhO2dCQUNuQyxZQUFZLElBQUk7OztRQUlwQiwyQkFBMkIsSUFBSSxXQUFXOzs7O0FBNEI5QyxtREFDRTtPQUdJLG1DQUFvQztRQUN0Qzs7QUFHSSx3QkFBYywyQkFBMkIsSUFBSTtPQUMvQztBQUNGLGVBQU8sVUFBSTs7QUFHYixXQUFPLGFBQVE7QUFiakI7QUF4Q00sNkJBQTZCLFVBQUk7OztBQW9CdkMseURBQ0UsUUFDQTtBQUVNLGlDQUF1Qix5Q0FBd0I7QUFFL0MsMkJBQWlCLFVBQUk7QUFDM0IsY0FBVyxlQUFlLG9DQUFxQjtBQUN2QyxrQ0FBb0IsT0FBTyxxQkFBcUI7V0FDbEQsb0JBQW9CO1lBQ3RCLGVBQWUsSUFBSSxhQUFhOzs7QUFJcEMsV0FBTztBQWRUIiwiZmlsZSI6InRyaW5rZXRDYWNoZUZsYWcubHVhIiwic291cmNlUm9vdCI6IiJ9