Bundle all source code modules called via require by wrapping them in functions.
git clone --recurse-submodules https://github.com/noonomyen/luaumb.git
cd luaumb
mkdir -p build && cd build
cmake .. && cmake --build . -j $(nproc)luaumb [main.luau] [out.luau]The process begins by searching for locations where the require function is called using the Luau AST (Abstract Syntax Tree). The arguments provided to these calls are then used to locate the corresponding module files. Once all module files are identified, their dependency order for loading is determined.
To create the output file, the source code of each module is wrapped in an anonymous function, with lazy initialization used for invoking these functions. In the source code of each module, instances of the require function are replaced by the corresponding wrapped function. The main file is also treated as a module to ensure that local variables declared in the main file are not accessible in other modules' local scopes once the bundle is created.
__LUAUMBis a table used to store all luaumb-related data..METATABLEis the metatable used to set for all wrapper functions..MODULESis a table that stores wrapper functions representing module files..LOADEDis a table that stores the return values of wrapper functions after they have been executed..LOADis a function used to load a module, acting similarly torequire(...).
As you know, luaumb will replace the position of the code where the require function is called. It looks for a global require function with a single argument that is a constant string. If you want luaumb to skip or ignore the require call at that position, you can use something that is not exactly a constant string, such as using require(("./module")). The parser will see that there's a group within the arguments, and the constant string is within that group, causing luaumb to ignore this position. or _G.require("./module") The parser will see that the require function is not global.