isaacscript-common 1.0.603 → 1.0.604

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,12 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 require("lualib_bundle");
 local ____exports = {}
-____exports.DEFAULT_GLOBALS = __TS__New(Set, {
+local ____log = require("functions.log")
+local log = ____log.log
+local ____util = require("functions.util")
+local combineSets = ____util.combineSets
+local isLuaDebugEnabled = ____util.isLuaDebugEnabled
+local DEFAULT_GLOBALS = __TS__New(Set, {
     "ActionTriggers",
     "ActiveSlot",
     "BabySubType",
@@ -167,5 +172,34 @@ ____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"})
+function ____exports.getDefaultGlobals(self)
+    return isLuaDebugEnabled(nil) and combineSets(nil, DEFAULT_GLOBALS, LUA_DEBUG_ADDED_GLOBALS) or DEFAULT_GLOBALS
+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
+    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/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.604",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",