isaacscript-common 1.0.603 → 1.0.607

package/dist/functions/globals.d.ts

@@ -1,2 +1,14 @@
-export declare const DEFAULT_GLOBALS: Set<string>;
-export declare const LUA_DEBUG_ADDED_GLOBALS: Set<string>;
+/// <reference types="typescript-to-lua/language-extensions" />
+/**
+ * Helper function to get a set containing all of the global variable names that are contained
+ * within the Isaac environment by default.
+ *
+ * Returns a slightly different set depending on whether the "--luadebug" flag is enabled or not.
+ */
+export declare function getDefaultGlobals(): Set<string>;
+/**
+ * Helper function to get an array of any added global variables in the Isaac Lua environment.
+ * Returns an array of key/value tuples.
+ */
+export declare function getNewGlobals(): [AnyNotNil, unknown][];
+export declare function logNewGlobals(): void;

package/dist/functions/globals.lua

@@ -1,7 +1,20 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 require("lualib_bundle");
 local ____exports = {}
-____exports.DEFAULT_GLOBALS = __TS__New(Set, {
+local twoDimensionalSort
+local ____log = require("functions.log")
+local log = ____log.log
+local ____util = require("functions.util")
+local addSetsToSet = ____util.addSetsToSet
+local copySet = ____util.copySet
+local isLuaDebugEnabled = ____util.isLuaDebugEnabled
+function twoDimensionalSort(self, a, b)
+    if a[1] == b[1] then
+        return 0
+    end
+    return a[1] < b[1] and -1 or 1
+end
+local DEFAULT_GLOBALS = __TS__New(Set, {
     "ActionTriggers",
     "ActiveSlot",
     "BabySubType",
@@ -121,6 +134,7 @@ ____exports.DEFAULT_GLOBALS = __TS__New(Set, {
     "SeedEffect",
     "Seeds",
     "ShockwaveParams",
+    "SkinColor",
     "SortingLayer",
     "SoundEffect",
     "Sprite",
@@ -167,5 +181,41 @@ ____exports.DEFAULT_GLOBALS = __TS__New(Set, {
     "utf8",
     "xpcall"
 })
-____exports.LUA_DEBUG_ADDED_GLOBALS = __TS__New(Set, {"debug", "io", "os", "package"})
+local LUA_DEBUG_ADDED_GLOBALS = __TS__New(Set, {"debug", "io", "os", "package"})
+local RACING_PLUS_SANDBOX_ADDED_GLOBALS = __TS__New(Set, {"sandboxTraceback", "sandboxGetTraceback", "getParentFunctionDescription"})
+function ____exports.getDefaultGlobals(self)
+    local defaultGlobals = copySet(nil, DEFAULT_GLOBALS)
+    if isLuaDebugEnabled(nil) then
+        addSetsToSet(nil, defaultGlobals, LUA_DEBUG_ADDED_GLOBALS)
+    end
+    addSetsToSet(nil, defaultGlobals, RACING_PLUS_SANDBOX_ADDED_GLOBALS)
+    return defaultGlobals
+end
+function ____exports.getNewGlobals(self)
+    local defaultGlobals = ____exports.getDefaultGlobals(nil)
+    local newGlobals = {}
+    for key, value in pairs(_G) do
+        if not defaultGlobals:has(key) then
+            local keyValueTuple = {key, value}
+            __TS__ArrayPush(newGlobals, keyValueTuple)
+        end
+    end
+    __TS__ArraySort(newGlobals, twoDimensionalSort)
+    return newGlobals
+end
+function ____exports.logNewGlobals(self)
+    local newGlobals = ____exports.getNewGlobals(nil)
+    log("List of added global variables in the Isaac environment:")
+    if #newGlobals == 0 then
+        log("- n/a (no extra global variables found)")
+    end
+    do
+        local i = 0
+        while i < #newGlobals do
+            local key, value = table.unpack(newGlobals[i + 1])
+            log((((tostring(i + 1) .. ") ") .. tostring(key)) .. " - ") .. tostring(value))
+            i = i + 1
+        end
+    end
+end
 return ____exports

package/dist/functions/npc.lua

@@ -70,7 +70,9 @@ NON_ALIVE_NPCS_TYPE_VARIANT = __TS__New(
         (tostring(EntityType.ENTITY_MAMA_GURDY) .. ".") .. 1,
         (tostring(EntityType.ENTITY_MAMA_GURDY) .. ".") .. 2,
         (tostring(EntityType.ENTITY_BIG_HORN) .. ".") .. 1,
-        (tostring(EntityType.ENTITY_BIG_HORN) .. ".") .. 2
+        (tostring(EntityType.ENTITY_BIG_HORN) .. ".") .. 2,
+        (tostring(EntityType.ENTITY_DARK_ESAU) .. ".") .. 0,
+        (tostring(EntityType.ENTITY_DARK_ESAU) .. ".") .. 1
     }
 )
 NON_ALIVE_NPCS_TYPE_VARIANT_SUBTYPE = __TS__New(

package/dist/functions/util.d.ts

@@ -1,5 +1,12 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="typescript-to-lua/language-extensions" />
+/**
+ * Helper function to add all of the contents of one set to another set. The first set passed will
+ * be modified in place.
+ *
+ * This function is variadic, meaning that you can specify N sets to add to the first set.
+ */
+export declare function addSetsToSet<T>(mainSet: Set<T>, ...setsToAdd: Array<Set<T>>): void;
 /**
  * Using a Map constructor to copy a Map does not seem to work properly, so use this helper function
  * instead.
@@ -10,6 +17,11 @@ export declare function copyMap<K, V>(oldMap: Map<K, V>): Map<K, V>;
  * instead.
  */
 export declare function copySet<T>(oldSet: Set<T>): Set<T>;
+/**
+ * Helper function to create a new set that is the composition of two or more sets.
+ *
+ * This function is variadic, meaning that you can specify N sets.
+ */
 export declare function combineSets<T>(...sets: Array<Set<T>>): Set<T>;
 /**
  * Helper function to get type safety on a switch statement.

package/dist/functions/util.lua

@@ -2,6 +2,14 @@
 require("lualib_bundle");
 local ____exports = {}
 local HEX_STRING_LENGTH = 6
+function ____exports.addSetsToSet(self, mainSet, ...)
+    local setsToAdd = {...}
+    for ____, set in ipairs(setsToAdd) do
+        for ____, value in __TS__Iterator(set:values()) do
+            mainSet:add(value)
+        end
+    end
+end
 function ____exports.copyMap(self, oldMap)
     local newMap = __TS__New(Map)
     for ____, ____value in __TS__Iterator(oldMap:entries()) do

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export * from "./functions/doors";
 export * from "./functions/entity";
 export * from "./functions/familiars";
 export * from "./functions/flag";
+export * from "./functions/globals";
 export * from "./functions/gridEntity";
 export * from "./functions/input";
 export * from "./functions/json";

package/dist/index.lua

@@ -190,6 +190,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.globals")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.gridEntity")
     for ____exportKey, ____exportValue in pairs(____export) do

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.0.603",
+  "version": "1.0.607",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",