isaacscript-common 6.6.1-dev.1 → 6.6.1-dev.2

package/functions/collectibles.js

@@ -0,0 +1,469 @@
+import { CollectibleType, EntityType, ItemConfigTagZero, ItemType, PickupPrice, PickupVariant, RoomType, } from "isaac-typescript-definitions";
+import { game, itemConfig } from "../cachedClasses";
+import { BLIND_ITEM_PNG_PATH, DEFAULT_ITEM_POOL_TYPE } from "../constants";
+import { FIRST_COLLECTIBLE_TYPE, FIRST_MODDED_COLLECTIBLE_TYPE, LAST_COLLECTIBLE_TYPE, LAST_VANILLA_COLLECTIBLE_TYPE, } from "../constantsFirstLast";
+import { COLLECTIBLE_DESCRIPTION_MAP, DEFAULT_COLLECTIBLE_DESCRIPTION, } from "../maps/collectibleDescriptionMap";
+import { COLLECTIBLE_NAME_MAP, DEFAULT_COLLECTIBLE_NAME, } from "../maps/collectibleNameMap";
+import { SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES_SET } from "../sets/singleUseActiveCollectibleTypesSet";
+import { getEntityID } from "./entity";
+import { isCollectible } from "./pickupVariants";
+import { getRoomListIndex } from "./roomData";
+import { clearSprite, spriteEquals } from "./sprite";
+import { irange } from "./utils";
+const COLLECTIBLE_SPRITE_LAYER = 1;
+const COLLECTIBLE_SHADOW_LAYER = 4;
+// Glitched items start at id 4294967295 (the final 32-bit integer) and increment backwards.
+const GLITCHED_ITEM_THRESHOLD = 4000000000;
+// The `isBlindCollectible` function needs a reference sprite to work properly.
+const questionMarkSprite = initQuestionMarkSprite();
+function initQuestionMarkSprite() {
+    const sprite = Sprite();
+    sprite.Load("gfx/005.100_collectible.anm2", false);
+    sprite.ReplaceSpritesheet(1, "gfx/items/collectibles/questionmark.png");
+    sprite.LoadGraphics();
+    return sprite;
+}
+export function clearCollectibleSprite(collectible) {
+    setCollectibleSprite(collectible, undefined);
+}
+/** Helper function to check if two collectible sprites have the same sprite sheet loaded. */
+export function collectibleSpriteEquals(sprite1, sprite2) {
+    // We start at negative 40 texels upwards, as by default we assume a collectible that is sitting
+    // on a pedestal. We finish at positive 10 texels downwards, in order to make comparing shop items
+    // more accurate.
+    const xStart = -1;
+    const xFinish = 1;
+    const xIncrement = 1;
+    const yStart = -40;
+    const yFinish = 10;
+    const yIncrement = 3;
+    return spriteEquals(sprite1, sprite2, COLLECTIBLE_SPRITE_LAYER, xStart, xFinish, xIncrement, yStart, yFinish, yIncrement);
+}
+/**
+ * Helper function to get the in-game description for a collectible. Returns "Unknown" if the
+ * provided collectible type was not valid.
+ */
+export function getCollectibleDescription(collectibleType) {
+    // "ItemConfigItem.Description" is bugged with vanilla items on patch v1.7.6, so we use a
+    // hard-coded map as a workaround.
+    const collectibleDescription = COLLECTIBLE_DESCRIPTION_MAP.get(collectibleType);
+    if (collectibleDescription !== undefined) {
+        return collectibleDescription;
+    }
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem !== undefined) {
+        return itemConfigItem.Description;
+    }
+    return DEFAULT_COLLECTIBLE_DESCRIPTION;
+}
+/**
+ * Helper function to get the coin cost that a collectible item would be if it were being offered in
+ * a Devil Room deal. Returns 0 if passed `CollectibleType.NULL`.
+ */
+export function getCollectibleDevilCoinPrice(collectibleType) {
+    if (collectibleType === CollectibleType.NULL) {
+        return 0;
+    }
+    const defaultCollectiblePrice = 15;
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return defaultCollectiblePrice;
+    }
+    return itemConfigItem.DevilPrice * defaultCollectiblePrice;
+}
+/**
+ * Helper function to get the heart cost that a collectible item would be if it were being offered
+ * in a Devil Room deal. Returns 0 if passed `CollectibleType.NULL`.
+ */
+export function getCollectibleDevilHeartPrice(collectibleType, player) {
+    const maxHearts = player.GetMaxHearts();
+    if (collectibleType === CollectibleType.NULL) {
+        return 0;
+    }
+    if (maxHearts === 0) {
+        return PickupPrice.THREE_SOUL_HEARTS;
+    }
+    const defaultCollectiblePrice = PickupPrice.ONE_HEART;
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return defaultCollectiblePrice;
+    }
+    const twoHeartPrice = maxHearts === 2
+        ? PickupPrice.ONE_HEART_AND_TWO_SOUL_HEARTS
+        : PickupPrice.TWO_HEARTS;
+    return itemConfigItem.DevilPrice === 2
+        ? twoHeartPrice
+        : PickupPrice.ONE_HEART;
+}
+/**
+ * Helper function to get the path to a collectible's sprite. Returns the path to the question mark
+ * sprite (i.e. from Curse of the Blind) if the provided collectible type was not valid.
+ */
+export function getCollectibleGfxFilename(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return BLIND_ITEM_PNG_PATH;
+    }
+    return itemConfigItem.GfxFileName;
+}
+/**
+ * Mods often have to track variables relating to a collectible. Finding an index for these kinds of
+ * data structures is difficult, since collectibles are respawned every time a player re-enters a
+ * room, so the `PtrHash` will change. Instead, we use a 4-tuple of the room list index, the grid
+ * index of the collectible in the room, the collectible's SubType, and the collectible's InitSeed.
+ *
+ * Collectibles that are shifted by Tainted Isaac's mechanic will have unique collectible indexes
+ * because the SubType is different. (The collectible entities share the same InitSeed.)
+ *
+ * Collectibles that are rolled (with e.g. a D6) will have unique collectible indexes because the
+ * SubType and InitSeed are different. If you want to track collectibles independently of any
+ * rerolls, then you can use the `PtrHash` as an index instead. (The `PtrHash` will not persist
+ * between rooms, however.)
+ *
+ * Note that:
+ * - The grid index is a necessary part of the collectible index because Diplopia and Crooked Penny
+ *   can cause two or more collectibles with the same SubType and InitSeed to exist in the same
+ *   room.
+ * - This index will fail in the case where the player uses Diplopia or a successful Crooked Penny
+ *   seven or more times in the same room, since that will cause two or more collectibles with the
+ *   same grid index, SubType, and InitSeed to exist.
+ * - The SubType is a necessary part of the collectible index because Tainted Isaac will
+ *   continuously cause collectibles to morph into new sub-types with the same InitSeed.
+ * - Using a collectible's position as part of the index is problematic, since players can push a
+ *   pedestal. (Even using the grid index does not solve this problem, since it is possible in
+ *   certain cases for collectibles to be spawned at a position that is not aligned with the grid,
+ *   and the pedestal pushed to an adjacent tile, but this case should be extremely rare.)
+ * - Mega Chests spawn two collectibles on the exact same position. However, both of them will have
+ *   different InitSeeds, so this is not a problem for this indexing scheme.
+ * - The indexing scheme used is different for collectibles that are inside of a Treasure Room or
+ *   Boss Room, in order to handle the case of the player seeing the same collectible again in a
+ *   post-Ascent Treasure Room or Boss Room. A 5-tuple of stage, stage type, grid index, SubType,
+ *   and InitSeed is used in this case. (Using the room list index or the room grid index is not
+ *   suitable for this purpose, since both of these values can change in the post-Ascent rooms.)
+ *   Even though Treasure Rooms and Boss Rooms are grouped together in this scheme, there probably
+ *   will not be collectibles with the same grid index, SubType, and InitSeed.
+ */
+export function getCollectibleIndex(collectible) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "getCollectibleIndex" function was given a non-collectible: ${entityID}`);
+    }
+    const level = game.GetLevel();
+    const stage = level.GetStage();
+    const stageType = level.GetStageType();
+    const room = game.GetRoom();
+    const roomType = room.GetType();
+    const gridIndex = room.GetGridIndex(collectible.Position);
+    const roomListIndex = getRoomListIndex();
+    // Handle the special case of being in a Treasure Room or Boss Room.
+    if (roomType === RoomType.TREASURE || roomType === RoomType.BOSS) {
+        return `${stage},${stageType},${gridIndex},${collectible.SubType},${collectible.InitSeed}`;
+    }
+    return `${roomListIndex},${gridIndex},${collectible.SubType},${collectible.InitSeed}`;
+}
+/**
+ * Helper function to get the initial amount of charges that a collectible has. Returns 0 if the
+ * provided collectible type was not valid.
+ */
+export function getCollectibleInitCharge(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return 0;
+    }
+    return itemConfigItem.InitCharge;
+}
+/**
+ * Helper function to get the `ItemType` of a collectible. Returns `ItemType.ITEM_NULL` if the
+ * provided collectible type was not valid.
+ */
+export function getCollectibleItemType(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return ItemType.NULL;
+    }
+    return itemConfigItem.Type;
+}
+/**
+ * Helper function to get the maximum amount of charges that a collectible has. Returns 0 if the
+ * provided collectible type was not valid.
+ */
+export function getCollectibleMaxCharges(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return 0;
+    }
+    return itemConfigItem.MaxCharges;
+}
+/**
+ * Helper function to get the name of a collectible. Returns "Unknown" if the provided collectible
+ * type is not valid.
+ *
+ * For example:
+ *
+ * ```ts
+ * const collectibleType = CollectibleType.SAD_ONION;
+ * const collectibleName = getCollectibleName(collectibleType); // collectibleName is "Sad Onion"
+ * ```
+ */
+export function getCollectibleName(collectibleType) {
+    // "ItemConfigItem.Name" is bugged with vanilla items on patch v1.7.6, so we use a hard-coded map
+    // as a workaround.
+    const collectibleName = COLLECTIBLE_NAME_MAP.get(collectibleType);
+    if (collectibleName !== undefined) {
+        return collectibleName;
+    }
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem !== undefined) {
+        return itemConfigItem.Name;
+    }
+    return DEFAULT_COLLECTIBLE_NAME;
+}
+export function getCollectiblePedestalType(collectible) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "getCollectiblePedestalType" function was given a non-collectible: ${entityID}`);
+    }
+    const sprite = collectible.GetSprite();
+    return sprite.GetOverlayFrame();
+}
+/**
+ * Helper function to get the path to a collectible's quality. Returns 0 if the provided collectible
+ * type was not valid.
+ */
+export function getCollectibleQuality(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    if (itemConfigItem === undefined) {
+        return 0;
+    }
+    return itemConfigItem.Quality;
+}
+/**
+ * Helper function to get the tags of a collectible (which is the composition of zero or more
+ * `ItemConfigTag`). Returns 0 if the provided collectible type is not valid.
+ *
+ * For example:
+ *
+ * ```ts
+ * const collectibleType = CollectibleType.SAD_ONION;
+ * const itemConfigTags = getCollectibleTags(collectibleType); // itemConfigTags is "18350080"
+ * ```
+ */
+export function getCollectibleTags(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    return itemConfigItem === undefined ? ItemConfigTagZero : itemConfigItem.Tags;
+}
+/**
+ * Helper function to get an array that represents the all modded collectible types.
+ *
+ * This function is only useful when building collectible type objects. For most purposes, you
+ * should use the `getModdedCollectibleSet` helper function instead.
+ *
+ * Returns an empty array if there are no modded collectible types.
+ *
+ * (This function is named differently from the `getVanillaCollectibleTypeRange` function because
+ * all modded collectible types are contiguous. Thus, each value represents a real
+ * `CollectibleType`.)
+ */
+export function getModdedCollectibleTypes() {
+    if (LAST_VANILLA_COLLECTIBLE_TYPE === LAST_COLLECTIBLE_TYPE) {
+        return [];
+    }
+    return irange(FIRST_MODDED_COLLECTIBLE_TYPE, LAST_COLLECTIBLE_TYPE);
+}
+/**
+ * Helper function to get an array that represents the range from the first collectible type to the
+ * last vanilla collectible type. This will include integers that do not represent any valid
+ * collectible types.
+ *
+ * This function is only useful when building collectible type objects. For most purposes, you
+ * should use the `getVanillaCollectibleSet` helper function instead.
+ */
+export function getVanillaCollectibleTypeRange() {
+    return irange(FIRST_COLLECTIBLE_TYPE, LAST_VANILLA_COLLECTIBLE_TYPE);
+}
+/** Returns true if the item type in the item config is equal to `ItemType.ITEM_ACTIVE`. */
+export function isActiveCollectible(collectibleType) {
+    const itemType = getCollectibleItemType(collectibleType);
+    return itemType === ItemType.ACTIVE;
+}
+/** Returns true if the collectible has a red question mark sprite. */
+export function isBlindCollectible(collectible) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "isBlindCollectible" function was given a non-collectible: ${entityID}`);
+    }
+    const sprite = collectible.GetSprite();
+    const animation = sprite.GetAnimation();
+    const frame = sprite.GetFrame();
+    questionMarkSprite.SetFrame(animation, frame);
+    return collectibleSpriteEquals(sprite, questionMarkSprite);
+}
+/**
+ * Returns whether or not the given collectible is a "glitched" item. All items are replaced by
+ * glitched items once a player has TMTRAINER. However, glitched items can also "naturally" appear
+ * in secret rooms and I AM ERROR rooms if the "Corrupted Data" achievement is unlocked.
+ */
+export function isGlitchedCollectible(pickup) {
+    return (pickup.Variant === PickupVariant.COLLECTIBLE &&
+        pickup.SubType > GLITCHED_ITEM_THRESHOLD);
+}
+/**
+ * Returns true if the collectible has the "Hidden" attribute in the item config.
+ *
+ * Hidden collectibles will not show up in any pools and Eden will not start with them.
+ */
+export function isHiddenCollectible(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    return itemConfigItem !== undefined && itemConfigItem.Hidden;
+}
+/**
+ * Returns true if the item type in the item config is equal to `ItemType.ITEM_PASSIVE` or
+ * `ItemType.ITEM_FAMILIAR`.
+ */
+export function isPassiveCollectible(collectibleType) {
+    const itemType = getCollectibleItemType(collectibleType);
+    return itemType === ItemType.PASSIVE || itemType === ItemType.FAMILIAR;
+}
+/**
+ * Helper function to determine if a particular collectible will disappear from the player's
+ * inventory upon use. Note that this will not work will modded items, as there is no way to
+ * dynamically know if a modded item will disappear.
+ */
+export function isSingleUseCollectible(collectibleType) {
+    return SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES_SET.has(collectibleType);
+}
+export function isValidCollectibleType(collectibleType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    return itemConfigItem !== undefined;
+}
+/**
+ * Helper function to put a message in the log.txt file to let the Rebirth Item Tracker know that it
+ * should remove an item.
+ *
+ * The "item tracker" in this function does not refer to the in-game item tracker, but rather to the
+ * Python program located at: https://github.com/Rchardon/RebirthItemTracker
+ */
+export function removeCollectibleFromItemTracker(collectibleType) {
+    const collectibleName = getCollectibleName(collectibleType);
+    // This cannot use the "log" function since the prefix will prevent the Rebirth Item Tracker from
+    // recognizing the message.
+    Isaac.DebugString(`Removing collectible ${collectibleType} (${collectibleName}) on player 0 (Player)`);
+}
+/**
+ * Helper function to remove all pickup delay on a collectible. By default, collectibles have a 20
+ * frame delay before they can be picked up by a player.
+ */
+export function removeCollectiblePickupDelay(collectible) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "removeCollectiblePickupDelay" function was given a non-collectible: ${entityID}`);
+    }
+    collectible.Wait = 0;
+}
+/**
+ * Helper function to set a collectible sprite to a question mark (i.e. how collectibles look when
+ * the player has Curse of the Blind).
+ */
+export function setCollectibleBlind(collectible) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "setCollectibleBlind" function was given a non-collectible: ${entityID}`);
+    }
+    setCollectibleSprite(collectible, BLIND_ITEM_PNG_PATH);
+}
+/**
+ * Helper function to remove the collectible from a collectible pedestal and make it appear as if a
+ * player has already taken the item. This is accomplished by changing the sub-type to
+ * `CollectibleType.NULL` and then setting the sprite to an empty/missing PNG file.
+ *
+ * For more information, see the documentation for the "clearSprite" helper function.
+ */
+export function setCollectibleEmpty(collectible) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "setCollectibleEmpty" function was given a non-collectible: ${entityID}`);
+    }
+    collectible.SubType = CollectibleType.NULL;
+    clearCollectibleSprite(collectible);
+}
+/**
+ * Helper function to change a collectible into a "glitched" item (like the ones that appear when
+ * the player has TMTRAINER).
+ */
+export function setCollectibleGlitched(collectible) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "setCollectibleGlitched" function was given a non-collectible: ${entityID}`);
+    }
+    // We need to generate a new glitched item. Thus, we temporarily give the player TMTRAINER, if
+    // necessary.
+    const player = Isaac.GetPlayer();
+    const hasTMTRAINER = player.HasCollectible(CollectibleType.TMTRAINER);
+    if (!hasTMTRAINER) {
+        player.AddCollectible(CollectibleType.TMTRAINER, 0, false);
+    }
+    const itemPool = game.GetItemPool();
+    const collectibleType = itemPool.GetCollectible(DEFAULT_ITEM_POOL_TYPE);
+    setCollectibleSubType(collectible, collectibleType);
+    if (!hasTMTRAINER) {
+        player.RemoveCollectible(CollectibleType.TMTRAINER);
+    }
+}
+/**
+ * Helper function to change the sprite of a collectible pedestal entity.
+ *
+ * For more information about removing the collectible sprite, see the documentation for the
+ * "clearSprite" helper function.
+ *
+ * @param collectible The collectible whose sprite you want to modify.
+ * @param pngPath Equal to either the spritesheet path to load (e.g.
+ *                "gfx/items/collectibles/collectibles_001_thesadonion.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 setCollectibleSprite(collectible, pngPath) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "setCollectibleSprite" function was given a non-collectible: ${entityID}`);
+    }
+    const sprite = collectible.GetSprite();
+    if (pngPath === undefined) {
+        clearSprite(sprite, COLLECTIBLE_SPRITE_LAYER, COLLECTIBLE_SHADOW_LAYER);
+    }
+    else {
+        sprite.ReplaceSpritesheet(COLLECTIBLE_SPRITE_LAYER, pngPath);
+        sprite.LoadGraphics();
+    }
+}
+/**
+ * Helper function to change the collectible on a pedestal. Simply updating the `SubType` property
+ * is not sufficient because the sprite will not change.
+ */
+export function setCollectibleSubType(collectible, newCollectibleType) {
+    if (!isCollectible(collectible)) {
+        const entityID = getEntityID(collectible);
+        error(`The "setCollectibleSubType" function was given a non-collectible: ${entityID}`);
+    }
+    // You cannot morph a pedestal to "CollectibleType.NULL"; it would instead create a new random
+    // collectible item.
+    if (newCollectibleType === CollectibleType.NULL) {
+        setCollectibleEmpty(collectible);
+        return;
+    }
+    // The naive way to change a collectible's sub-type is to set it directly. However, doing this
+    // will not update the sprite. Manually updating the sprite works in most situations, but does not
+    // work when the pedestal is empty. Instead, we can simply morph the collectible, which seems to
+    // work in all situations.
+    collectible.Morph(EntityType.PICKUP, PickupVariant.COLLECTIBLE, newCollectibleType, true, true, true);
+}
+/**
+ * Helper function to put a message in the log.txt file to let the Rebirth Item Tracker know that
+ * the build has been rerolled.
+ */
+export function setCollectiblesRerolledForItemTracker() {
+    // This cannot use the "log" function since the prefix will prevent the Rebirth Item Tracker from
+    // recognizing the message. The number here does not matter since the tracker does not check for a
+    // specific number.
+    Isaac.DebugString("Added 3 Collectibles");
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29sbGVjdGlibGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvY29sbGVjdGlibGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFFTCxlQUFlLEVBQ2YsVUFBVSxFQUVWLGlCQUFpQixFQUNqQixRQUFRLEVBQ1IsV0FBVyxFQUNYLGFBQWEsRUFDYixRQUFRLEdBQ1QsTUFBTSw4QkFBOEIsQ0FBQztBQUN0QyxPQUFPLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ3BELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxzQkFBc0IsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUMzRSxPQUFPLEVBQ0wsc0JBQXNCLEVBQ3RCLDZCQUE2QixFQUM3QixxQkFBcUIsRUFDckIsNkJBQTZCLEdBQzlCLE1BQU0sdUJBQXVCLENBQUM7QUFDL0IsT0FBTyxFQUNMLDJCQUEyQixFQUMzQiwrQkFBK0IsR0FDaEMsTUFBTSxtQ0FBbUMsQ0FBQztBQUMzQyxPQUFPLEVBQ0wsb0JBQW9CLEVBQ3BCLHdCQUF3QixHQUN6QixNQUFNLDRCQUE0QixDQUFDO0FBQ3BDLE9BQU8sRUFBRSx1Q0FBdUMsRUFBRSxNQUFNLDRDQUE0QyxDQUFDO0FBRXJHLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFDdkMsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2pELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUM5QyxPQUFPLEVBQUUsV0FBVyxFQUFFLFlBQVksRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUNyRCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBRWpDLE1BQU0sd0JBQXdCLEdBQUcsQ0FBQyxDQUFDO0FBQ25DLE1BQU0sd0JBQXdCLEdBQUcsQ0FB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

package/functions/color.d.ts

@@ -1,5 +1,5 @@
-/// <reference types="typescript-to-lua/language-extensions" />
 /// <reference types="isaac-typescript-definitions" />
+/// <reference types="typescript-to-lua/language-extensions" />
 import { SerializationType } from "../enums/SerializationType";
 declare type SerializedColor = LuaTable<string, unknown> & {
     readonly __serializedColorBrand: symbol;

package/functions/color.js

@@ -0,0 +1,60 @@
+import { SerializationBrand } from "../enums/private/SerializationBrand";
+import { SerializationType } from "../enums/SerializationType";
+import { isaacAPIClassEquals, isIsaacAPIClassOfType } from "./isaacAPIClass";
+import { copyValuesToTable, getNumbersFromTable, tableHasKeys } from "./table";
+import { isTable } from "./types";
+const KEYS = ["R", "G", "B", "A", "RO", "GO", "BO"];
+const OBJECT_NAME = "Color";
+export function colorEquals(color1, color2) {
+    return isaacAPIClassEquals(color1, color2, KEYS);
+}
+export function copyColor(color, serializationType = SerializationType.NONE) {
+    switch (serializationType) {
+        case SerializationType.NONE: {
+            if (!isColor(color)) {
+                error(`Failed to copy a ${OBJECT_NAME} object since the provided object was not a userdata ${OBJECT_NAME} class.`);
+            }
+            return Color(color.R, color.G, color.B, color.A, color.RO, color.GO, color.BO);
+        }
+        case SerializationType.SERIALIZE: {
+            if (!isColor(color)) {
+                error(`Failed to serialize a ${OBJECT_NAME} object since the provided object was not a userdata ${OBJECT_NAME} class.`);
+            }
+            const colorTable = new LuaTable();
+            copyValuesToTable(color, KEYS, colorTable);
+            colorTable.set(SerializationBrand.COLOR, "");
+            return colorTable;
+        }
+        case SerializationType.DESERIALIZE: {
+            if (!isTable(color)) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object was not a Lua table.`);
+            }
+            const [r, g, b, a, ro, go, bo] = getNumbersFromTable(color, OBJECT_NAME, ...KEYS);
+            if (r === undefined) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: r`);
+            }
+            if (g === undefined) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: g`);
+            }
+            if (b === undefined) {
+                error(`Failed to deserialize a ${OBJECT_NAME} object since the provided object did not have a value for: b`);
+            }
+            return Color(r, g, b, a, ro, go, bo);
+        }
+    }
+}
+/** Helper function to check if something is an instantiated Color object. */
+export function isColor(object) {
+    return isIsaacAPIClassOfType(object, OBJECT_NAME);
+}
+/**
+ * Used to determine is the given table is a serialized `Color` object created by the save data
+ * manager and/or the `deepCopy` function.
+ */
+export function isSerializedColor(object) {
+    if (!isTable(object)) {
+        return false;
+    }
+    return tableHasKeys(object, ...KEYS) && object.has(SerializationBrand.COLOR);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29sb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9jb2xvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUN6RSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUMvRCxPQUFPLEVBQUUsbUJBQW1CLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUM3RSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsbUJBQW1CLEVBQUUsWUFBWSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQy9FLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFZbEMsTUFBTSxJQUFJLEdBQUcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLENBQUMsQ0FBQztBQUNwRCxNQUFNLFdBQVcsR0FBRyxPQUFPLENBQUM7QUFFNUIsTUFBTSxVQUFVLFdBQVcsQ0FBQyxNQUFhLEVBQUUsTUFBYTtJQUN0RCxPQUFPLG1CQUFtQixDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLENBQUM7QUFDbkQsQ0FBQztBQWdCRCxNQUFNLFVBQVUsU0FBUyxDQUN2QixLQUE4QixFQUM5QixpQkFBaUIsR0FBRyxpQkFBaUIsQ0FBQyxJQUFJO0lBRTFDLFFBQVEsaUJBQWlCLEVBQUU7UUFDekIsS0FBSyxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUMzQixJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFO2dCQUNuQixLQUFLLENBQ0gsb0JBQW9CLFdBQVcsd0RBQXdELFdBQVcsU0FBUyxDQUM1RyxDQUFDO2FBQ0g7WUFFRCxPQUFPLEtBQUssQ0FDVixLQUFLLENBQUMsQ0FBQyxFQUNQLEtBQUssQ0FBQyxDQUFDLEVBQ1AsS0FBSyxDQUFDLENBQUMsRUFDUCxLQUFLLENBQUMsQ0FBQyxFQUNQLEtBQUssQ0FBQyxFQUFFLEVBQ1IsS0FBSyxDQUFDLEVBQUUsRUFDUixLQUFLLENBQUMsRUFBRSxDQUNULENBQUM7U0FDSDtRQUVELEtBQUssaUJBQWlCLENBQUMsU0FBUyxDQUFDLENBQUM7WUFDaEMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsRUFBRTtnQkFDbkIsS0FBSyxDQUNILHlCQUF5QixXQUFXLHdEQUF3RCxXQUFXLFNBQVMsQ0FDakgsQ0FBQzthQUNIO1lBRUQsTUFBTSxVQUFVLEdBQUcsSUFBSSxRQUFRLEVBQW1CLENBQUM7WUFDbkQsaUJBQWlCLENBQUMsS0FBSyxFQUFFLElBQUksRUFBRSxVQUFVLENBQUMsQ0FBQztZQUMzQyxVQUFVLENBQUMsR0FBRyxDQUFDLGtCQUFrQixDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsQ0FBQztZQUM3QyxPQUFPLFVBQTZCLENBQUM7U0FDdEM7UUFFRCxLQUFLLGlCQUFpQixDQUFDLFdBQVcsQ0FBQyxDQUFDO1lBQ2xDLElBQUksQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEVBQUU7Z0JBQ25CLEtBQUssQ0FDSCwyQkFBMkIsV0FBVyx3REFBd0QsQ0FDL0YsQ0FBQzthQUNIO1lBRUQsTUFBTSxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsQ0FBQyxHQUFHLG1CQUFtQixDQUNsRCxLQUFrQyxFQUNsQyxXQUFXLEVBQ1gsR0FBRyxJQUFJLENBQ1IsQ0FBQztZQUVGLElBQUksQ0FBQyxLQUFLLFNBQVMsRUFBRTtnQkFDbkIsS0FBSyxDQUNILDJCQUEyQixXQUFXLCtEQUErRCxDQUN0RyxDQUFDO2FBQ0g7WUFDRCxJQUFJLENBQUMsS0FBSyxTQUFTLEVBQUU7Z0JBQ25CLEtBQUssQ0FDSCwyQkFBMkIsV0FBVywrREFBK0QsQ0FDdEcsQ0FBQzthQUNIO1lBQ0QsSUFBSSxDQUFDLEtBQUssU0FBUyxFQUFFO2dCQUNuQixLQUFLLENBQ0gsMkJBQTJCLFdBQVcsK0RBQStELENBQ3RHLENBQUM7YUFDSDtZQUVELE9BQU8sS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsQ0FBQyxDQUFDO1NBQ3RDO0tBQ0Y7QUFDSCxDQUFDO0FBRUQsNkVBQTZFO0FBQzdFLE1BQU0sVUFBVSxPQUFPLENBQUMsTUFBZTtJQUNyQyxPQUFPLHFCQUFxQixDQUFDLE1BQU0sRUFBRSxXQUFXLENBQUMsQ0FBQztBQUNwRCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLGlCQUFpQixDQUFDLE1BQWU7SUFDL0MsSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsRUFBRTtRQUNwQixPQUFPLEtBQUssQ0FBQztLQUNkO0lBRUQsT0FBTyxZQUFZLENBQUMsTUFBTSxFQUFFLEdBQUcsSUFBSSxDQUFDLElBQUksTUFBTSxDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUMvRSxDQUFDIn0=

package/functions/debug.js

@@ -0,0 +1,60 @@
+import { log } from "./log";
+/**
+ * Helper function to get a stack trace.
+ *
+ * This will only work if the `--luadebug` launch option is enabled or the Racing+ sandbox is
+ * enabled.
+ */
+export function getTraceback() {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (debug !== undefined) {
+        // The --luadebug launch flag is enabled.
+        return debug.traceback();
+    }
+    if (sandboxGetTraceback !== undefined) {
+        return sandboxGetTraceback();
+    }
+    return 'stack traceback:\n(the "--luadebug" flag is not enabled)';
+}
+/**
+ * Players can boot the game with an launch option called "--luadebug", which will enable additional
+ * functionality that is considered to be unsafe. For more information about this flag, see the
+ * wiki: https://bindingofisaacrebirth.fandom.com/wiki/Launch_Options
+ *
+ * When this flag is enabled, the global environment will be slightly different. The differences are
+ * documented here: https://wofsauge.github.io/IsaacDocs/rep/Globals.html
+ *
+ * This function uses the `package` global variable as a proxy to determine if the "--luadebug" flag
+ * is enabled or not.
+ */
+export function isLuaDebugEnabled() {
+    // "package" is not always defined like the Lua definitions imply.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    return _G.package !== undefined;
+}
+/**
+ * Helper function to print a stack trace to the "log.txt" file, similar to JavaScript's
+ * `console.trace` function.
+ *
+ * This will only work if the `--luadebug` launch option is enabled or the Racing+ sandbox is
+ * enabled.
+ */
+export function traceback() {
+    const tracebackOutput = getTraceback();
+    log(tracebackOutput);
+}
+function setDebugFunctionsGlobal() {
+    // "debug" is not always defined like the Lua definitions imply.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (_G.debug === undefined && sandboxGetTraceback === undefined) {
+        return;
+    }
+    const globals = _G;
+    globals["getTraceback"] = getTraceback;
+    globals["traceback"] = traceback;
+}
+// If the debug functions will provide useful output, make them global by default.
+if (isLuaDebugEnabled() || sandboxGetTraceback !== undefined) {
+    setDebugFunctionsGlobal();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9kZWJ1Zy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0sT0FBTyxDQUFDO0FBRTVCOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLFlBQVk7SUFDMUIsdUVBQXVFO0lBQ3ZFLElBQUksS0FBSyxLQUFLLFNBQVMsRUFBRTtRQUN2Qix5Q0FBeUM7UUFDekMsT0FBTyxLQUFLLENBQUMsU0FBUyxFQUFFLENBQUM7S0FDMUI7SUFFRCxJQUFJLG1CQUFtQixLQUFLLFNBQVMsRUFBRTtRQUNyQyxPQUFPLG1CQUFtQixFQUFFLENBQUM7S0FDOUI7SUFFRCxPQUFPLDBEQUEwRCxDQUFDO0FBQ3BFLENBQUM7QUFFRDs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxVQUFVLGlCQUFpQjtJQUMvQixrRUFBa0U7SUFDbEUsdUVBQXVFO0lBQ3ZFLE9BQU8sRUFBRSxDQUFDLE9BQU8sS0FBSyxTQUFTLENBQUM7QUFDbEMsQ0FBQztBQUVEOzs7Ozs7R0FNRztBQUNILE1BQU0sVUFBVSxTQUFTO0lBQ3ZCLE1BQU0sZUFBZSxHQUFHLFlBQVksRUFBRSxDQUFDO0lBQ3ZDLEdBQUcsQ0FBQyxlQUFlLENBQUMsQ0FBQztBQUN2QixDQUFDO0FBRUQsU0FBUyx1QkFBdUI7SUFDOUIsZ0VBQWdFO0lBQ2hFLHVFQUF1RTtJQUN2RSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEtBQUssU0FBUyxJQUFJLG1CQUFtQixLQUFLLFNBQVMsRUFBRTtRQUMvRCxPQUFPO0tBQ1I7SUFFRCxNQUFNLE9BQU8sR0FBRyxFQUE2QixDQUFDO0lBRTlDLE9BQU8sQ0FBQyxjQUFjLENBQUMsR0FBRyxZQUFZLENBQUM7SUFDdkMsT0FBTyxDQUFDLFdBQVcsQ0FBQyxHQUFHLFNBQVMsQ0FBQztBQUNuQyxDQUFDO0FBRUQsa0ZBQWtGO0FBQ2xGLElBQUksaUJBQWlCLEVBQUUsSUFBSSxtQkFBbUIsS0FBSyxTQUFTLEVBQUU7SUFDNUQsdUJBQXVCLEVBQUUsQ0FBQztDQUMzQiJ9