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

package/dist/functions/entitySpecific.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/entitySpecific.ts"],"names":[],"mappings":";AAAA,6CAYO;AATL;AAUF,sBAA2B;AAAlB;AACT,mBAKO;AAJL;AACA;AACA;AACA;;;;;;;;;;;AAeF,oCACE,aACA;OADA;QAAA,eAA4B;;OAC5B;QAAA,WAAW;;AAEL,qBAAW,iBAAY,iBAAiB,aAAa;AAErD,kBAAsB;AAC5B,cAAW,iBAAU;AACb,qBAAO,OAAO;WAChB;AACF,gCAAW;;;AAIf,WAAO;AAdT;;;;;;;;;;;AA6BA,sCACE,eACA;OADA;QAAA,iBAAgC;;OAChC;QAAA,WAAW;;AAEL,qBAAW,iBAAY,mBAAmB,eAAe;AAEzD,oBAA0B;AAChC,cAAW,iBAAU;AACb,uBAAS,OAAO;WAClB;AACF,oCAAa;;;AAIjB,WAAO;AAdT;;;;;;;;;;;AA6BA,wCACE,iBACA;OADA;QAAA,mBAAoC;;OACpC;QAAA,WAAW;;AAEL,qBAAW,iBAAY,qBAAqB,iBAAiB;AAE7D,sBAA8B;AACpC,cAAW,iBAAU;AACb,yBAAW,OAAO;WACpB;AACF,wCAAe;;;AAInB,WAAO;AAdT;;;;;;;;;;;AA6BA,qCACE,cACA;OADA;QAAA,gBAA8B;;OAC9B;QAAA,WAAW;;AAEL,qBAAW,iBAAY,kBAAkB,cAAc;AAEvD,mBAAwB;AAC9B,cAAW,iBAAU;AACb,sBAAQ,OAAO;WACjB;AACF,kCAAY;;;AAIhB,WAAO;AAdT;;;;;;;;;;;AA6BA,qCACE,cACA;OADA;QAAA,gBAA8B;;OAC9B;QAAA,WAAW;;AAEL,qBAAW,iBAAY,kBAAkB,cAAc;AAEvD,mBAAwB;AAC9B,cAAW,iBAAU;AACb,sBAAQ,OAAO;WACjB;AACF,kCAAY;;;AAIhB,WAAO;AAdT;;AAkBA,mCACE,YACA,SACA,SACA;OAAA;QAAA,iBAAiB;;AAEX,qBAAW;;QAAY;QAAY;QAAS;QAAS;;AAErD,iBAAoB;AAC1B,cAAW,iBAAU;AACb,oBAAM,OAAO;WACf;AACF,8BAAU;;;AAId,WAAO;AAhBT;;;;;;;;;;;AA+BA,sCACE,eACA;OADA;QAAA,iBAAgC;;OAChC;QAAA,WAAW;;AAEL,qBAAW,iBAAY,mBAAmB,eAAe;AAEzD,oBAA0B;AAChC,cAAW,iBAAU;AACb,uBAAS,OAAO;WAClB;AACF,oCAAa;;;AAIjB,WAAO;AAdT;;;;;;;;;;;AA6BA,0CACE,mBACA;OADA;QAAA,qBAAwC;;OACxC;QAAA,WAAW;;AAEL,qBAAW,iBACf,uBACA,mBACA;AAGI,wBAAkC;AACxC,cAAW,iBAAU;AACb,2BAAa,OAAO;WACtB;AACF,4CAAiB;;;AAIrB,WAAO;AAlBT;;;;;;;;;;;AAiCA,oCACE,aACA;OADA;QAAA,eAA4B;;OAC5B;QAAA,WAAW;;AAEL,kBAAQ,iBAAY,iBAAiB,aAAa;AAExD,WAAO;AANT;;;;;;;;;;;AAqBA,oCACE,aACA;OADA;QAAA,eAA4B;;OAC5B;QAAA,WAAW;;AAEL,qBAAW,iBAAY,iBAAiB,aAAa;AAErD,kBAAsB;AAC5B,cAAW,iBAAU;AACb,qBAAO,OAAO;WAChB;AACF,gCAAW;;;AAIf,WAAO;AAdT;;;;;;;;;;;;AA8BA,8CACE,KACA,UACA,UACA,iBACA;AAEM,wBAAc;IACpB,IAAI,gBAAgB,UAAU,UAAU,iBAAiB;AACnD,wBAAc;AACd,gCAAsB,4BAAuB,aAAa;AAEhE,WAAO;AAZT;;;;;;;AAuBA,0CACE,aACA,SACA;AAEM,kBAAQ,0BAAS,aAAa;AACpC,WAAO,oBAAe,OAAO;AAN/B;;;;;;;AAiBA,4CACE,eACA,SACA;AAEM,oBAAU,4BAAW,eAAe;AAC1C,WAAO,oBAAe,SAAS;AANjC;;;;;;;;AAkBA,8CACE,iBACA,SACA;AAEM,sBAAY,8BAAa,iBAAiB;AAChD,WAAO,oBAAe,WAAW;AANnC;;;;;;;AAiBA,2CACE,cACA,SACA;AAEM,mBAAS,2BAAU,cAAc;AACvC,WAAO,oBAAe,QAAQ;AANhC;;;;;;;AAiBA,2CACE,cACA,SACA;AAEM,mBAAS,2BAAU,cAAc;AACvC,WAAO,oBAAe,QAAQ;AANhC;;;;;AAeA,yCAA8B;AACtB,iBAAO;AACb,WAAO,oBAAe,MAAM;AAF9B;;;;;;;AAaA,4CACE,eACA,SACA;AAEM,oBAAU,4BAAW,eAAe;AAC1C,WAAO,oBAAe,SAAS;AANjC;;;;;;;;AAkBA,gDACE,mBACA,SACA;AAEM,wBAAc,gCAAe,mBAAmB;AACtD,WAAO,oBAAe,aAAa;AANrC;;;;;;;AAiBA,0CACE,aACA,SACA;AAEM,kBAAQ,0BAAS,aAAa;AACpC,WAAO,oBAAe,OAAO;AAN/B;;;;;;;AAiBA,0CACE,aACA,SACA;AAEM,kBAAQ,0BAAS,aAAa;AACpC,WAAO,oBAAe,OAAO;AAN/B;;AAUA,qCACE,aACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,iBAAO,OAAO;OAChB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,6CACE,aACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,uCACE,eACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,mBAAS,OAAO;OAClB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,+CACE,eACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,yCACE,iBACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,qBAAW,OAAO;OACpB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,iDACE,iBACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,sCACE,cACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,kBAAQ,OAAO;OACjB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,8CACE,cACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,sCACE,cACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,kBAAQ,OAAO;OACjB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,8CACE,cACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,oCACE,YACA,SACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,gBAAM,OAAO;OACf;QACF,MAAM;;AAER,WAAO;AAvBT;;AA2BA,4CACE,YACA,SACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;QACA;;AAhBJ;;AAqBA,uCACE,eACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,mBAAS,OAAO;OAClB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,+CACE,eACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,2CACE,mBACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,uBAAa,OAAO;OACtB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,mDACE,mBACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,qCACE,aACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;QACA;;AAfJ;;AAoBA,6CACE,aACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ;;AAmBA,qCACE,aACA,SACA,UACA,UACA,SACA;OAFA;QAAA,WAAmB;;OACnB;QAAA;;OACA;QAAA;;AAEM,mBAAS;;QACb;QACA;QACA;QACA;QACA;QACA;QACA;;AAGI,iBAAO,OAAO;OAChB;QACF,MAAM;;AAER,WAAO;AAtBT;;AA0BA,6CACE,aACA,SACA,UACA,WACA,UACA;OADA;QAAA,WAAmB;;OACnB;QAAA;;AAEA,WAAO;;QACL;QACA;QACA;QACA;QACA;QACA;;AAdJ","file":"entitySpecific.lua","sourceRoot":"../src/"}

package/dist/functions/entityTypes.js

@@ -0,0 +1,6 @@
+import { EntityType } from "isaac-typescript-definitions";
+/** For `EntityType.SLOT` (6) */
+export function isSlot(entity) {
+    return entity.Type === EntityType.SLOT;
+}
+//# sourceMappingURL=entityTypes.js.map

package/dist/functions/entityTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityTypes.js","sourceRoot":"../src/","sources":["functions/entityTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,gCAAgC;AAChC,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC;AACzC,CAAC"}

package/dist/functions/entityTypes.lua

@@ -0,0 +1,8 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+--- For `EntityType.SLOT` (6)
+function ____exports.isSlot(self, entity)
+    return entity.Type == EntityType.SLOT
+end
+return ____exports

package/dist/functions/entityTypes.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/entityTypes.ts"],"names":[],"mappings":";AAAA,6CAA2B;AAAlB;;AAGT,kCAAuB;AACrB,WAAO,eAAgB;AADzB","file":"entityTypes.lua","sourceRoot":"../src/"}

package/dist/functions/enums.js

@@ -0,0 +1,151 @@
+import { getRandomArrayElement } from "./array";
+import { getRandomSeed } from "./rng";
+import { isString } from "./types";
+import { irange } from "./utils";
+/**
+ * TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
+ * when you iterate over them, you will get both the names of the enums and the values of the enums,
+ * in a random order. Use this helper function to get the entries of the enum with the reverse
+ * mappings filtered out.
+ *
+ * This function will return the enum values in a sorted order, which may not necessarily be the
+ * same order as which they were declared in.
+ *
+ * This function will work properly for both number enums and string enums. (Reverse mappings are
+ * not created for string enums.)
+ *
+ * Also see the `getEnumKeys` and `getEnumValues` helper functions.
+ *
+ * For a more in depth explanation, see:
+ * https://isaacscript.github.io/gotchas#iterating-over-enums
+ */
+export function getEnumEntries(transpiledEnum) {
+    // The values cannot simply be type `T` due to the special construction of bit flag enums.
+    const enumEntries = [];
+    for (const [key, value] of pairs(transpiledEnum)) {
+        // Ignore the reverse mappings created by TypeScriptToLua. Note that reverse mappings are not
+        // created for string enums.
+        if (isString(key)) {
+            enumEntries.push([key, value]);
+        }
+    }
+    // The enums will be in a random order (because of "pairs"), so sort them based on the values.
+    // https://stackoverflow.com/questions/5199901/how-to-sort-an-associative-array-by-its-values-in-javascript
+    enumEntries.sort(([_key1, value1], [_key2, value2]) => value1 < value2 ? -1 : value1 > value2 ? 1 : 0);
+    return enumEntries;
+}
+/**
+ * TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
+ * when you iterate over them, you will get both the names of the enums and the values of the enums,
+ * in a random order. If all you need are the keys of an enum, use this helper function.
+ *
+ * This function will return the enum keys in a sorted order, which may not necessarily be the same
+ * order as which they were declared in.
+ *
+ * This function will work properly for both number enums and string enums. (Reverse mappings are
+ * not created for string enums.)
+ *
+ * Also see the `getEnumEntries` and `getEnumValues` helper functions.
+ *
+ * For a more in depth explanation, see:
+ * https://isaacscript.github.io/gotchas#iterating-over-enums
+ */
+export function getEnumKeys(transpiledEnum) {
+    const enumEntries = getEnumEntries(transpiledEnum);
+    return enumEntries.map(([key, _value]) => key);
+}
+/** Helper function to get the amount of entries inside of an enum. */
+export function getEnumLength(transpiledEnum) {
+    const enumEntries = getEnumEntries(transpiledEnum);
+    return enumEntries.length;
+}
+/**
+ * TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
+ * when you iterate over them, you will get both the names of the enums and the values of the enums,
+ * in a random order. If all you need are the values of an enum, use this helper function.
+ *
+ * This function will return the enum values in a sorted order, which may not necessarily be the
+ * same order as which they were declared in.
+ *
+ * This function will work properly for both number enums and string enums. (Reverse mappings are
+ * not created for string enums.)
+ *
+ * Also see the `getEnumEntries` and `getEnumKeys` helper functions.
+ *
+ * For a more in depth explanation, see:
+ * https://isaacscript.github.io/gotchas#iterating-over-enums
+ */
+export function getEnumValues(transpiledEnum) {
+    const enumEntries = getEnumEntries(transpiledEnum);
+    return enumEntries.map(([_key, value]) => value);
+}
+/**
+ * Helper function to get the enum value with the highest value.
+ *
+ * Note that this is not necessarily the enum value that is declared last, since there is no way to
+ * infer that at run-time.
+ */
+export function getLastEnumValue(transpiledEnum) {
+    const enumValues = getEnumValues(transpiledEnum);
+    const lastElement = enumValues[enumValues.length - 1];
+    if (lastElement === undefined) {
+        error("Failed to get the last value from an enum since the enum was empty.");
+    }
+    return lastElement;
+}
+/**
+ * Helper function to get a random value from the provided enum.
+ *
+ * @param transpiledEnum The enum to get the value from.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param exceptions Optional. An array of elements to skip over if selected.
+ */
+export function getRandomEnumValue(transpiledEnum, seedOrRNG = getRandomSeed(), exceptions = []) {
+    const enumValues = getEnumValues(transpiledEnum);
+    return getRandomArrayElement(enumValues, seedOrRNG, exceptions);
+}
+/**
+ * Helper function to check every value of a custom enum for -1. Will throw an run-time error if any
+ * -1 values are found. This is helpful because many methods of the Isaac class return -1 if they
+ * fail.
+ *
+ * For example:
+ *
+ * ```ts
+ * enum EntityTypeCustom {
+ *   FOO = Isaac.GetEntityTypeByName("Foo"),
+ * }
+ *
+ * validateCustomEnum("EntityTypeCustom", EntityTypeCustom);
+ * ```
+ */
+export function validateCustomEnum(transpiledEnumName, transpiledEnum) {
+    for (const [key, value] of getEnumEntries(transpiledEnum)) {
+        if (value === -1) {
+            error(`Failed to find the custom enum value: ${transpiledEnumName}.${key}`);
+        }
+    }
+}
+/**
+ * Helper function to validate if every value in an enum is contiguous, starting at 0.
+ *
+ * This is useful to automate checking large enums for typos.
+ */
+export function validateEnumContiguous(transpiledEnumName, transpiledEnum) {
+    const values = getEnumValues(transpiledEnum);
+    const valuesSet = new Set(values);
+    const lastValue = values[values.length - 1];
+    if (lastValue === undefined) {
+        error("Failed to validate that an enum was contiguous, since the last value was undefined.");
+    }
+    if (typeof lastValue !== "number") {
+        error("Failed to validate that an enum was contiguous, since the last value was not a number.");
+    }
+    for (const value of irange(lastValue)) {
+        if (!valuesSet.has(value)) {
+            error(`Failed to find a custom enum value of ${value} for: ${transpiledEnumName}`);
+        }
+    }
+}
+//# sourceMappingURL=enums.js.map

package/dist/functions/enums.js.map

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

package/dist/functions/enums.lua

@@ -0,0 +1,177 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArraySort = ____lualib.__TS__ArraySort
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____array = require("functions.array")
+local getRandomArrayElement = ____array.getRandomArrayElement
+local ____rng = require("functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+local ____types = require("functions.types")
+local isString = ____types.isString
+local ____utils = require("functions.utils")
+local irange = ____utils.irange
+--- TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
+-- when you iterate over them, you will get both the names of the enums and the values of the enums,
+-- in a random order. Use this helper function to get the entries of the enum with the reverse
+-- mappings filtered out.
+-- 
+-- This function will return the enum values in a sorted order, which may not necessarily be the
+-- same order as which they were declared in.
+-- 
+-- This function will work properly for both number enums and string enums. (Reverse mappings are
+-- not created for string enums.)
+-- 
+-- Also see the `getEnumKeys` and `getEnumValues` helper functions.
+-- 
+-- For a more in depth explanation, see:
+-- https://isaacscript.github.io/gotchas#iterating-over-enums
+function ____exports.getEnumEntries(self, transpiledEnum)
+    local enumEntries = {}
+    for key, value in pairs(transpiledEnum) do
+        if isString(nil, key) then
+            enumEntries[#enumEntries + 1] = {key, value}
+        end
+    end
+    __TS__ArraySort(
+        enumEntries,
+        function(____, ____bindingPattern0, ____bindingPattern1)
+            local value1
+            local _key1 = ____bindingPattern0[1]
+            value1 = ____bindingPattern0[2]
+            local value2
+            local _key2 = ____bindingPattern1[1]
+            value2 = ____bindingPattern1[2]
+            return value1 < value2 and -1 or (value1 > value2 and 1 or 0)
+        end
+    )
+    return enumEntries
+end
+--- TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
+-- when you iterate over them, you will get both the names of the enums and the values of the enums,
+-- in a random order. If all you need are the keys of an enum, use this helper function.
+-- 
+-- This function will return the enum keys in a sorted order, which may not necessarily be the same
+-- order as which they were declared in.
+-- 
+-- This function will work properly for both number enums and string enums. (Reverse mappings are
+-- not created for string enums.)
+-- 
+-- Also see the `getEnumEntries` and `getEnumValues` helper functions.
+-- 
+-- For a more in depth explanation, see:
+-- https://isaacscript.github.io/gotchas#iterating-over-enums
+function ____exports.getEnumKeys(self, transpiledEnum)
+    local enumEntries = ____exports.getEnumEntries(nil, transpiledEnum)
+    return __TS__ArrayMap(
+        enumEntries,
+        function(____, ____bindingPattern0)
+            local key
+            key = ____bindingPattern0[1]
+            local _value = ____bindingPattern0[2]
+            return key
+        end
+    )
+end
+--- Helper function to get the amount of entries inside of an enum.
+function ____exports.getEnumLength(self, transpiledEnum)
+    local enumEntries = ____exports.getEnumEntries(nil, transpiledEnum)
+    return #enumEntries
+end
+--- TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
+-- when you iterate over them, you will get both the names of the enums and the values of the enums,
+-- in a random order. If all you need are the values of an enum, use this helper function.
+-- 
+-- This function will return the enum values in a sorted order, which may not necessarily be the
+-- same order as which they were declared in.
+-- 
+-- This function will work properly for both number enums and string enums. (Reverse mappings are
+-- not created for string enums.)
+-- 
+-- Also see the `getEnumEntries` and `getEnumKeys` helper functions.
+-- 
+-- For a more in depth explanation, see:
+-- https://isaacscript.github.io/gotchas#iterating-over-enums
+function ____exports.getEnumValues(self, transpiledEnum)
+    local enumEntries = ____exports.getEnumEntries(nil, transpiledEnum)
+    return __TS__ArrayMap(
+        enumEntries,
+        function(____, ____bindingPattern0)
+            local value
+            local _key = ____bindingPattern0[1]
+            value = ____bindingPattern0[2]
+            return value
+        end
+    )
+end
+--- Helper function to get the enum value with the highest value.
+-- 
+-- Note that this is not necessarily the enum value that is declared last, since there is no way to
+-- infer that at run-time.
+function ____exports.getLastEnumValue(self, transpiledEnum)
+    local enumValues = ____exports.getEnumValues(nil, transpiledEnum)
+    local lastElement = enumValues[#enumValues]
+    if lastElement == nil then
+        error("Failed to get the last value from an enum since the enum was empty.")
+    end
+    return lastElement
+end
+--- Helper function to get a random value from the provided enum.
+-- 
+-- @param transpiledEnum The enum to get the value from.
+-- @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+-- `RNG.Next` method will be called. Default is `getRandomSeed()`.
+-- @param exceptions Optional. An array of elements to skip over if selected.
+function ____exports.getRandomEnumValue(self, transpiledEnum, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if exceptions == nil then
+        exceptions = {}
+    end
+    local enumValues = ____exports.getEnumValues(nil, transpiledEnum)
+    return getRandomArrayElement(nil, enumValues, seedOrRNG, exceptions)
+end
+--- Helper function to check every value of a custom enum for -1. Will throw an run-time error if any
+-- -1 values are found. This is helpful because many methods of the Isaac class return -1 if they
+-- fail.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- enum EntityTypeCustom {
+--   FOO = Isaac.GetEntityTypeByName("Foo"),
+-- }
+-- 
+-- validateCustomEnum("EntityTypeCustom", EntityTypeCustom);
+-- ```
+function ____exports.validateCustomEnum(self, transpiledEnumName, transpiledEnum)
+    for ____, ____value in ipairs(____exports.getEnumEntries(nil, transpiledEnum)) do
+        local key = ____value[1]
+        local value = ____value[2]
+        if value == -1 then
+            error((("Failed to find the custom enum value: " .. transpiledEnumName) .. ".") .. key)
+        end
+    end
+end
+--- Helper function to validate if every value in an enum is contiguous, starting at 0.
+-- 
+-- This is useful to automate checking large enums for typos.
+function ____exports.validateEnumContiguous(self, transpiledEnumName, transpiledEnum)
+    local values = ____exports.getEnumValues(nil, transpiledEnum)
+    local valuesSet = __TS__New(Set, values)
+    local lastValue = values[#values]
+    if lastValue == nil then
+        error("Failed to validate that an enum was contiguous, since the last value was undefined.")
+    end
+    if type(lastValue) ~= "number" then
+        error("Failed to validate that an enum was contiguous, since the last value was not a number.")
+    end
+    for ____, value in ipairs(irange(nil, lastValue)) do
+        if not valuesSet:has(value) then
+            error((("Failed to find a custom enum value of " .. tostring(value)) .. " for: ") .. transpiledEnumName)
+        end
+    end
+end
+return ____exports

package/dist/functions/enums.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/enums.ts"],"names":[],"mappings":";;;;;;AAAA,kBAAsC;AAA7B;AACT,gBAA8B;AAArB;AACT,kBAAyB;AAAhB;AACT,kBAAuB;AAAd;;;;;;;;;;;;;;;;AAmBT,0CACE;AAGM,wBAAuD;AAC7D,QAAY,KAAK,SAAU,MAAM;WAG3B,cAAS;AACX,4CAAiB,CAAC,KAAK;;;IAM3B;QAAA;QACE;kBAAS;kBAAP;YAAO;kBAAiB;kBAAP;YAAO;AACxB,4BAAS,YAAU,KAAI,UAAS,WAAS,KAAI;QAD/C;;AAIF,WAAO;AApBT;;;;;;;;;;;;;;;AAuCA,uCAA+B;AACvB,wBAAc,gCAAe;AACnC,WAAO;QAAA;QAAgB;kBAAE;YAAA;kBAAK;AAAY;QAAnB;;AAFzB;;AAMA,yCAAiC;AACzB,wBAAc,gCAAe;AACnC,WAAO;AAFT;;;;;;;;;;;;;;;AAqBA,yCAAiC;AACzB,wBAAc,gCAAe;AACnC,WAAO;QAAA;QAAgB;kBAAQ;kBAAN;YAAM;AAAW;QAAnB;;AAFzB;;;;;AAWA,4CAAoC;AAC5B,uBAAa,+BAAc;AAE3B,wBAAc,WAAW;OAC3B;QACF,MACE;;AAIJ,WAAO;AAVT;;;;;;;AAqBA,8CACE,gBACA,WACA;OADA;QAAA,YAAwB;;OACxB;QAAA,aAA4D;;AAEtD,uBAAa,+BAAc;AACjC,WAAO,2BAAsB,YAAY,WAAW;AANtD;;;;;;;;;;;;;;AAwBA,8CACE,oBACA;AAEA,kCAA2B,gCAAe;cAA9B;cAAK;WACX,UAAW;YACb,QACE,4CAAyC,uBAAkB,QAAI;;;AAPvE;;;;AAkBA,kDACE,oBACA;AAEM,mBAAS,+BAAc;AACvB,sBAAY,UAAI,KAAI;AACpB,sBAAY,OAAO;OACrB;QACF,MACE;;OAGA,KAAO,cAAc;QACvB,MACE;;AAGJ,cAAW,gBAAS,YAAO;eACpB,UAAU,IAAI;YACjB,QACE,qDAAyC,WAAK,aAAS;;;AApB/D","file":"enums.lua","sourceRoot":"../src/"}

package/dist/functions/familiars.js

@@ -0,0 +1,85 @@
+import { itemConfig } from "../cachedClasses";
+import { FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET } from "../sets/familiarsThatShootPlayerTearsSet";
+import { getFamiliars } from "./entitySpecific";
+/**
+ * Helper function to add and remove familiars based on a target amount that you specify.
+ *
+ * This is a convenience wrapper around the `EntityPlayer.CheckFamiliar` method. Use this helper
+ * function instead so that you do not have to retrieve the `ItemConfigItem` and so that you do not
+ * specify an incorrect RNG object. (The vanilla method is bugged in that it does not increment the
+ * RNG object; see the documentation of the method for more details.)
+ *
+ * This function is meant to be called in the EvaluateCache callback (when the cache flag is equal
+ * to `CacheFlag.FAMILIARS`).
+ *
+ * Note that this function is only meant to be used in special circumstances where the familiar
+ * count is completely custom and does not correspond to the amount of collectibles. For the general
+ * case, use the `checkFamiliarFromCollectibles` helper function instead.
+ *
+ * Note that this will spawn familiars with a completely random `InitSeed`. When calculating random
+ * events for this familiar, you should use a data structure that maps familiar `InitSeed` to RNG
+ * objects that are initialized based on the seed from
+ * `EntityPlayer.GetCollectibleRNG(collectibleType)`.
+ *
+ * @param player The player that owns the familiars.
+ * @param collectibleType The collectible type of the collectible associated with this familiar.
+ * @param targetCount The number of familiars that should exist. This function will add or remove
+ *                    familiars until it matches the target count.
+ * @param familiarVariant The variant of the familiar to spawn or remove.
+ * @param familiarSubType Optional. The sub-type of the familiar to spawn or remove. If not
+ *                        specified, it will search for existing familiars of all sub-types, and
+ *                        spawn new familiars with a sub-type of 0.
+ */
+export function checkFamiliar(player, collectibleType, targetCount, familiarVariant, familiarSubType) {
+    const itemConfigItem = itemConfig.GetCollectible(collectibleType);
+    player.CheckFamiliar(familiarVariant, targetCount, RNG(), itemConfigItem, familiarSubType);
+}
+/**
+ * Helper function to add and remove familiars based on the amount of associated collectibles that a
+ * player has.
+ *
+ * Use this helper function instead of invoking the `EntityPlayer.CheckFamiliar` method directly so
+ * that the target count is handled automatically.
+ *
+ * This function is meant to be called in the EvaluateCache callback (when the cache flag is equal
+ * to `CacheFlag.FAMILIARS`).
+ *
+ * Use this function when the amount of familiars should be equal to the amount of associated
+ * collectibles that the player has (plus any extras from having used Box of Friends or Monster
+ * Manual). If you instead need to have a custom amount of familiars, use the `checkFamiliars`
+ * function instead.
+ *
+ * Note that this will spawn familiars with a completely random `InitSeed`. When calculating random
+ * events for this familiar, you should use a data structure that maps familiar `InitSeed` to RNG
+ * objects that are initialized based on the seed from
+ * `EntityPlayer.GetCollectibleRNG(collectibleType)`.
+ *
+ * @param player The player that owns the familiars and collectibles.
+ * @param collectibleType The collectible type of the collectible associated with this familiar.
+ * @param familiarVariant The variant of the familiar to spawn or remove.
+ * @param familiarSubType Optional. The sub-type of the familiar to spawn or remove. If not
+ *                        specified, it will search for existing familiars of all sub-types, and
+ *                        spawn new familiars with a sub-type of 0.
+ */
+export function checkFamiliarFromCollectibles(player, collectibleType, familiarVariant, familiarSubType) {
+    const numCollectibles = player.GetCollectibleNum(collectibleType);
+    const effects = player.GetEffects();
+    // Whenever Box of Friends or Monster Manual is used, it will automatically increment the number
+    // of collectible effects for this familiar.
+    const numCollectibleEffects = effects.GetCollectibleEffectNum(collectibleType);
+    const targetCount = numCollectibles + numCollectibleEffects;
+    checkFamiliar(player, collectibleType, targetCount, familiarVariant, familiarSubType);
+}
+/** Helper function to get only the familiars that belong to a specific player. */
+export function getPlayerFamiliars(player) {
+    const playerPtrHash = GetPtrHash(player);
+    const familiars = getFamiliars();
+    return familiars.filter((familiar) => {
+        const familiarPlayerPtrHash = GetPtrHash(familiar.Player);
+        return familiarPlayerPtrHash === playerPtrHash;
+    });
+}
+export function isFamiliarThatShootsPlayerTears(familiar) {
+    return FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET.has(familiar.Variant);
+}
+//# sourceMappingURL=familiars.js.map

package/dist/functions/familiars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"familiars.js","sourceRoot":"../src/","sources":["functions/familiars.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qCAAqC,EAAE,MAAM,0CAA0C,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,eAAgC,EAChC,WAAgB,EAChB,eAAgC,EAChC,eAAqB;IAErB,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;IAClE,MAAM,CAAC,aAAa,CAClB,eAAe,EACf,WAAW,EACX,GAAG,EAAE,EACL,cAAc,EACd,eAAe,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAoB,EACpB,eAAgC,EAChC,eAAgC,EAChC,eAAqB;IAErB,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEpC,gGAAgG;IAChG,4CAA4C;IAC5C,MAAM,qBAAqB,GACzB,OAAO,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,eAAe,GAAG,qBAAqB,CAAC;IAE5D,aAAa,CACX,MAAM,EACN,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnC,MAAM,qBAAqB,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,qBAAqB,KAAK,aAAa,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,QAAwB;IAExB,OAAO,qCAAqC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC"}

package/dist/functions/familiars.lua

@@ -0,0 +1,101 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local ____exports = {}
+local ____cachedClasses = require("cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____familiarsThatShootPlayerTearsSet = require("sets.familiarsThatShootPlayerTearsSet")
+local FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET = ____familiarsThatShootPlayerTearsSet.FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET
+local ____entitySpecific = require("functions.entitySpecific")
+local getFamiliars = ____entitySpecific.getFamiliars
+--- Helper function to add and remove familiars based on a target amount that you specify.
+-- 
+-- This is a convenience wrapper around the `EntityPlayer.CheckFamiliar` method. Use this helper
+-- function instead so that you do not have to retrieve the `ItemConfigItem` and so that you do not
+-- specify an incorrect RNG object. (The vanilla method is bugged in that it does not increment the
+-- RNG object; see the documentation of the method for more details.)
+-- 
+-- This function is meant to be called in the EvaluateCache callback (when the cache flag is equal
+-- to `CacheFlag.FAMILIARS`).
+-- 
+-- Note that this function is only meant to be used in special circumstances where the familiar
+-- count is completely custom and does not correspond to the amount of collectibles. For the general
+-- case, use the `checkFamiliarFromCollectibles` helper function instead.
+-- 
+-- Note that this will spawn familiars with a completely random `InitSeed`. When calculating random
+-- events for this familiar, you should use a data structure that maps familiar `InitSeed` to RNG
+-- objects that are initialized based on the seed from
+-- `EntityPlayer.GetCollectibleRNG(collectibleType)`.
+-- 
+-- @param player The player that owns the familiars.
+-- @param collectibleType The collectible type of the collectible associated with this familiar.
+-- @param targetCount The number of familiars that should exist. This function will add or remove
+-- familiars until it matches the target count.
+-- @param familiarVariant The variant of the familiar to spawn or remove.
+-- @param familiarSubType Optional. The sub-type of the familiar to spawn or remove. If not
+-- specified, it will search for existing familiars of all sub-types, and
+-- spawn new familiars with a sub-type of 0.
+function ____exports.checkFamiliar(self, player, collectibleType, targetCount, familiarVariant, familiarSubType)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    player:CheckFamiliar(
+        familiarVariant,
+        targetCount,
+        RNG(),
+        itemConfigItem,
+        familiarSubType
+    )
+end
+--- Helper function to add and remove familiars based on the amount of associated collectibles that a
+-- player has.
+-- 
+-- Use this helper function instead of invoking the `EntityPlayer.CheckFamiliar` method directly so
+-- that the target count is handled automatically.
+-- 
+-- This function is meant to be called in the EvaluateCache callback (when the cache flag is equal
+-- to `CacheFlag.FAMILIARS`).
+-- 
+-- Use this function when the amount of familiars should be equal to the amount of associated
+-- collectibles that the player has (plus any extras from having used Box of Friends or Monster
+-- Manual). If you instead need to have a custom amount of familiars, use the `checkFamiliars`
+-- function instead.
+-- 
+-- Note that this will spawn familiars with a completely random `InitSeed`. When calculating random
+-- events for this familiar, you should use a data structure that maps familiar `InitSeed` to RNG
+-- objects that are initialized based on the seed from
+-- `EntityPlayer.GetCollectibleRNG(collectibleType)`.
+-- 
+-- @param player The player that owns the familiars and collectibles.
+-- @param collectibleType The collectible type of the collectible associated with this familiar.
+-- @param familiarVariant The variant of the familiar to spawn or remove.
+-- @param familiarSubType Optional. The sub-type of the familiar to spawn or remove. If not
+-- specified, it will search for existing familiars of all sub-types, and
+-- spawn new familiars with a sub-type of 0.
+function ____exports.checkFamiliarFromCollectibles(self, player, collectibleType, familiarVariant, familiarSubType)
+    local numCollectibles = player:GetCollectibleNum(collectibleType)
+    local effects = player:GetEffects()
+    local numCollectibleEffects = effects:GetCollectibleEffectNum(collectibleType)
+    local targetCount = numCollectibles + numCollectibleEffects
+    ____exports.checkFamiliar(
+        nil,
+        player,
+        collectibleType,
+        targetCount,
+        familiarVariant,
+        familiarSubType
+    )
+end
+--- Helper function to get only the familiars that belong to a specific player.
+function ____exports.getPlayerFamiliars(self, player)
+    local playerPtrHash = GetPtrHash(player)
+    local familiars = getFamiliars(nil)
+    return __TS__ArrayFilter(
+        familiars,
+        function(____, familiar)
+            local familiarPlayerPtrHash = GetPtrHash(familiar.Player)
+            return familiarPlayerPtrHash == playerPtrHash
+        end
+    )
+end
+function ____exports.isFamiliarThatShootsPlayerTears(self, familiar)
+    return FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET:has(familiar.Variant)
+end
+return ____exports

package/dist/functions/familiars.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/isaacscript-common/src/functions/familiars.ts"],"names":[],"mappings":";;;AACA,0BAA2B;AAAlB;AACT,6CAAsD;AAA7C;AACT,2BAA6B;AAApB;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BT,yCACE,QACA,iBACA,aACA,iBACA;AAEM,2BAAiB,WAAW,eAAe;IACjD,OAAO;QACL;QACA;QACA;QACA;QACA;;AAbJ;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,yDACE,QACA,iBACA,iBACA;AAEM,4BAAkB,OAAO,kBAAkB;AAC3C,oBAAU,OAAO;AAIjB,kCACJ,QAAQ,wBAAwB;AAC5B,wBAAc,kBAAkB;IAEtC;;QACE;QACA;QACA;QACA;QACA;;AApBJ;;AAyBA,8CAAmC;AAC3B,0BAAgB,WAAW;AAC3B,sBAAY;AAClB,WAAO;QAAA;QAAiB,eAAC;AACjB,0CAAwB,WAAW;AACzC,mBAAO,yBAA0B;QAFX;;AAH1B;AASA,2DACE;AAEA,WAAO,sCAAsC,IAAI;AAHnD","file":"familiars.lua","sourceRoot":"../src/"}