Hi,

In the WarCraft 3 environment, we start with a preexisting war3map.lua file (containing information about preplaced units and other GUI elements), and we also do not have access to the debug library. With the help of the WarCraft 3 community, this exists as a decent enough manual implementation of debug.traceback:

local tracebackHeader = 'stack traceback:'
local infoObject = {short_src = 'war3map.lua'}
local _
debug = {
    traceback = function(message, lineNumber)
        message = message and message .. '\n' .. tracebackHeader
        lineNumber = lineNumber or 1
        local traceback = {message or tracebackHeader}
        local lineError, lastError = '', ''
        repeat
            _, lineError = pcall(error, '', lineNumber)
            if lineError ~= '' and lineError ~= lastError then
                traceback[#traceback + 1] = lineError
                lastError = lineError
            end
            lineNumber = lineNumber + 1
        until lineNumber >= 200
        return table.concat(traceback, '\n\t')
    end,
    getinfo = function(whatInfo)
        return (whatInfo == 1) and infoObject or nil
    end
}

I've tailored this with a custom getinfo that taps into the positions used by TypeScript2Lua to get the name of the current map file.

WarCraft 3 doesn't allow the require syntax either, so we are stuck with just one finalized war3map.lua output file. Therefore, being able to have full control over how the compiled output is framed, prior to source map finalization, would allow extremely powerful source mapping in the WarCraft 3 environment (as we've been restricted to hunting through a tens-of-thousands-of-lines-long Lua file for years).

The problem is, that both war3map.lua AND this custom debug library, need to be placed ABOVE the emitted TypeScript2Lua compiled file. This interferes with the ability to properly use source maps. Therefore, I'd ask if it's possible (or if it can be made possible) to perhaps include a table structure for the compilation, and the output will be merged all into one blob, prior to the source mapping being finalized.

e.g. adding something like this to the TSTL config:

'prepended-files': ['custom-debug.lua', 'war3map.lua']

I am not sure if I can use something like the afterPrint Plugin - does this run before or after the source maps were resolved? Would I be able to prepend my own files to the ProcessedFile array passed as the 4th parameter to afterPrint?