warcraft-3-w3ts-utils 0.1.7 → 0.1.8

package/dist/lua_modules/w3ts/system/index.lua

@@ -0,0 +1,58 @@
+local ____exports = {}
+do
+    local ____export = require("lua_modules.w3ts.system.base64")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+do
+    local ____export = require("lua_modules.w3ts.system.binaryreader")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+do
+    local ____export = require("lua_modules.w3ts.system.binarywriter")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+do
+    local ____export = require("lua_modules.w3ts.system.file")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+do
+    local ____export = require("lua_modules.w3ts.system.gametime")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+do
+    local ____export = require("lua_modules.w3ts.system.host")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+do
+    local ____export = require("lua_modules.w3ts.system.sync")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+return ____exports

package/dist/lua_modules/w3ts/system/sync.lua

@@ -0,0 +1,239 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__StringSubstr = ____lualib.__TS__StringSubstr
+local __TS__New = ____lualib.__TS__New
+local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
+local ____exports = {}
+local ____player = require("lua_modules.w3ts.handles.player")
+local MapPlayer = ____player.MapPlayer
+local ____timer = require("lua_modules.w3ts.handles.timer")
+local Timer = ____timer.Timer
+local ____trigger = require("lua_modules.w3ts.handles.trigger")
+local Trigger = ____trigger.Trigger
+local ____base64 = require("lua_modules.w3ts.system.base64")
+local base64Decode = ____base64.base64Decode
+local base64Encode = ____base64.base64Encode
+local ____binaryreader = require("lua_modules.w3ts.system.binaryreader")
+local BinaryReader = ____binaryreader.BinaryReader
+local ____binarywriter = require("lua_modules.w3ts.system.binarywriter")
+local BinaryWriter = ____binarywriter.BinaryWriter
+local ____gametime = require("lua_modules.w3ts.system.gametime")
+local getElapsedTime = ____gametime.getElapsedTime
+local SYNC_PREFIX = "T"
+local SYNC_PREFIX_CHUNK = "S"
+local SYNC_MAX_CHUNK_SIZE = 244
+local SyncIncomingPacket = __TS__Class()
+SyncIncomingPacket.name = "SyncIncomingPacket"
+function SyncIncomingPacket.prototype.____constructor(self, prefix, data)
+    local isChunk = prefix == SYNC_PREFIX_CHUNK
+    local header = base64Decode(isChunk and __TS__StringSubstr(data, 0, 10) or __TS__StringSubstr(data, 0, 5))
+    local reader = __TS__New(BinaryReader, header)
+    local id = reader:readUInt16()
+    self.req = ____exports.SyncRequest:fromIndex(id)
+    self.chunks = isChunk and reader:readUInt16() or 0
+    self.chunk = isChunk and reader:readUInt16() or 0
+    self.data = isChunk and __TS__StringSubstr(data, 10) or __TS__StringSubstr(data, 5)
+end
+local SyncOutgoingPacket = __TS__Class()
+SyncOutgoingPacket.name = "SyncOutgoingPacket"
+function SyncOutgoingPacket.prototype.____constructor(self, req, data, chunk, totalChunks)
+    if chunk == nil then
+        chunk = -1
+    end
+    if totalChunks == nil then
+        totalChunks = 0
+    end
+    self.req = req
+    self.data = data
+    self.chunk = chunk
+    self.chunks = totalChunks
+end
+function SyncOutgoingPacket.prototype.getHeader(self)
+    local writer = __TS__New(BinaryWriter)
+    writer:writeUInt16(self.req.id)
+    if self.chunk ~= -1 then
+        writer:writeUInt16(self.chunks)
+        writer:writeUInt16(self.chunk)
+    end
+    return base64Encode(tostring(writer))
+end
+function SyncOutgoingPacket.prototype.__tostring(self)
+    local header = self:getHeader()
+    local writer = __TS__New(BinaryWriter)
+    writer:writeString(self.data)
+    return header .. tostring(writer)
+end
+--- A system which provides an easy way to synchronize data between game clients.
+-- The data will be split into chunks and sent in order until all of them are recieved by
+-- every player. Splitting the data is required as `BlzSendSyncData` only allows 255 characters
+-- per request.
+-- 
+-- @example ```ts
+-- const data = File.read("savecode.txt");
+-- 
+-- // Synchronize the contents of the file from the first player's computer.
+-- new SyncRequest(Players[0], data).then((res, req) => {
+--  print(res.data);
+-- });
+-- ```
+____exports.SyncRequest = __TS__Class()
+local SyncRequest = ____exports.SyncRequest
+SyncRequest.name = "SyncRequest"
+function SyncRequest.prototype.____constructor(self, from, data, options)
+    self._startTime = 0
+    self.chunks = {}
+    self.currentChunk = 0
+    self.destroyed = false
+    self.status = 0
+    self.options = not options and ____exports.SyncRequest.defaultOptions or options
+    self.from = from
+    self.id = ____exports.SyncRequest:allocate()
+    ____exports.SyncRequest.indicies[self.id + 1] = -1
+    ____exports.SyncRequest.cache[self.id + 1] = self
+    ____exports.SyncRequest:init()
+    if type(data) == "string" then
+        self:start(data)
+    end
+end
+__TS__SetDescriptor(
+    SyncRequest.prototype,
+    "startTime",
+    {get = function(self)
+        return self._startTime
+    end},
+    true
+)
+function SyncRequest.prototype.catch(self, callback)
+    self.onError = callback
+    return self
+end
+function SyncRequest.prototype.destroy(self)
+    ____exports.SyncRequest.indicies[self.id + 1] = ____exports.SyncRequest.index
+    ____exports.SyncRequest.index = self.id
+    self.destroyed = true
+end
+function SyncRequest.prototype.start(self, data)
+    if self.status ~= 0 or self.destroyed then
+        return false
+    end
+    self.currentChunk = 0
+    if #data <= SYNC_MAX_CHUNK_SIZE then
+        self:send(__TS__New(SyncOutgoingPacket, self, data))
+    else
+        local chunks = math.floor(#data / SYNC_MAX_CHUNK_SIZE)
+        do
+            local i = 0
+            while i <= chunks do
+                self:send(__TS__New(
+                    SyncOutgoingPacket,
+                    self,
+                    __TS__StringSubstr(data, i * SYNC_MAX_CHUNK_SIZE, SYNC_MAX_CHUNK_SIZE),
+                    i,
+                    chunks
+                ))
+                i = i + 1
+            end
+        end
+    end
+    self._startTime = getElapsedTime()
+    self.status = 1
+    if self.options.timeout > 0 then
+        Timer:create():start(
+            self.options.timeout,
+            false,
+            function()
+                local ____opt_0 = Timer:fromExpired()
+                if ____opt_0 ~= nil then
+                    ____opt_0:destroy()
+                end
+                if self.onError and self.status == 1 then
+                    self.onError({data = "Timeout", status = 3, time = self.startTime}, self)
+                end
+            end
+        )
+    end
+    return true
+end
+SyncRequest.prototype["then"] = function(self, callback)
+    self.onResponse = callback
+    return self
+end
+function SyncRequest.allocate(self)
+    if ____exports.SyncRequest.index ~= 0 then
+        local id = ____exports.SyncRequest.index
+        ____exports.SyncRequest.index = ____exports.SyncRequest.indicies[id + 1]
+        return id
+    end
+    local ____exports_SyncRequest_2, ____counter_3 = ____exports.SyncRequest, "counter"
+    ____exports_SyncRequest_2[____counter_3] = ____exports_SyncRequest_2[____counter_3] + 1
+    return ____exports.SyncRequest.counter
+end
+function SyncRequest.prototype.send(self, packet)
+    local prefix = packet.chunk == -1 and SYNC_PREFIX or SYNC_PREFIX_CHUNK
+    if self.from == MapPlayer:fromLocal() and not BlzSendSyncData(
+        prefix,
+        tostring(packet)
+    ) then
+        print("SyncData: Network Error")
+    end
+end
+function SyncRequest.fromIndex(self, index)
+    return self.cache[index + 1]
+end
+function SyncRequest.init(self)
+    if self.initialized then
+        return
+    end
+    do
+        local i = 0
+        while i < bj_MAX_PLAYER_SLOTS do
+            local p = MapPlayer:fromIndex(i)
+            if p ~= nil and p.controller == MAP_CONTROL_USER and p.slotState == PLAYER_SLOT_STATE_PLAYING then
+                self.eventTrigger:registerPlayerSyncEvent(p, SYNC_PREFIX, false)
+                self.eventTrigger:registerPlayerSyncEvent(p, SYNC_PREFIX_CHUNK, false)
+            end
+            i = i + 1
+        end
+    end
+    self.eventTrigger:addAction(function()
+        self:onSync()
+    end)
+    self.initialized = true
+end
+function SyncRequest.onSync(self)
+    local syncPrefix = BlzGetTriggerSyncPrefix()
+    local syncData = BlzGetTriggerSyncData()
+    if syncPrefix == nil or syncData == nil then
+        return
+    end
+    local packet = __TS__New(SyncIncomingPacket, syncPrefix, syncData)
+    if packet.req == nil then
+        return
+    end
+    local ____packet_req_4, ____currentChunk_5 = packet.req, "currentChunk"
+    ____packet_req_4[____currentChunk_5] = ____packet_req_4[____currentChunk_5] + 1
+    packet.req.chunks[packet.chunk + 1] = packet.data
+    if packet.chunk >= packet.chunks then
+        if packet.req.onResponse then
+            local data = table.concat(packet.req.chunks, "")
+            local status = 2
+            packet.req.status = 2
+            packet.req.onResponse(
+                {
+                    data = data,
+                    status = status,
+                    time = getElapsedTime()
+                },
+                packet.req
+            )
+        end
+    end
+end
+SyncRequest.cache = {}
+SyncRequest.counter = 0
+SyncRequest.defaultOptions = {timeout = 0}
+SyncRequest.eventTrigger = Trigger:create()
+SyncRequest.index = 0
+SyncRequest.indicies = {}
+SyncRequest.initialized = false
+return ____exports

package/dist/lua_modules/w3ts/utils/color.lua

@@ -0,0 +1,189 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
+local __TS__New = ____lualib.__TS__New
+local __TS__NumberToString = ____lualib.__TS__NumberToString
+local ____exports = {}
+local toHex, orderedPlayerColors
+function toHex(value)
+    local hex = __TS__NumberToString(value, 16)
+    if #hex < 2 then
+        hex = "0" .. hex
+    end
+    return hex
+end
+____exports.Color = __TS__Class()
+local Color = ____exports.Color
+Color.name = "Color"
+function Color.prototype.____constructor(self, red, green, blue, alpha)
+    self.red = red
+    self.green = green
+    self.blue = blue
+    if alpha then
+        self.alpha = alpha
+    else
+        self.alpha = 255
+    end
+end
+__TS__SetDescriptor(
+    Color.prototype,
+    "code",
+    {get = function(self)
+        return (("|c" .. toHex(self.alpha)) .. toHex(self.red)) .. toHex(self.green) .. toHex(self.blue)
+    end},
+    true
+)
+__TS__SetDescriptor(
+    Color.prototype,
+    "name",
+    {get = function(self)
+        local index = self:playerColorIndex()
+        if index < #____exports.playerColors then
+            return ____exports.playerColorNames[index + 1]
+        end
+        return "unknown"
+    end},
+    true
+)
+__TS__SetDescriptor(
+    Color.prototype,
+    "playerColor",
+    {get = function(self)
+        local index = self:playerColorIndex()
+        if index < #____exports.playerColors then
+            return orderedPlayerColors[index + 1]
+        end
+        return PLAYER_COLOR_RED
+    end},
+    true
+)
+function Color.prototype.equals(self, other)
+    return self.red == other.red and self.green == other.green and self.blue == other.blue and self.alpha == other.alpha
+end
+function Color.prototype.playerColorIndex(self)
+    local i = 0
+    do
+        while i < #____exports.playerColors do
+            if ____exports.playerColors[i + 1]:equals(self) then
+                break
+            end
+            i = i + 1
+        end
+    end
+    return i
+end
+function Color.prototype.lerp(self, other, factor)
+    local r = MathRound(self.red * (1 - factor) + other.red * factor)
+    local g = MathRound(self.green * (1 - factor) + other.green * factor)
+    local b = MathRound(self.blue * (1 - factor) + other.blue * factor)
+    local a = MathRound(self.alpha * (1 - factor) + other.alpha * factor)
+    return __TS__New(
+        ____exports.Color,
+        math.max(
+            0,
+            math.min(255, r)
+        ),
+        math.max(
+            0,
+            math.min(255, g)
+        ),
+        math.max(
+            0,
+            math.min(255, b)
+        ),
+        math.max(
+            0,
+            math.min(255, a)
+        )
+    )
+end
+____exports.color = function(red, green, blue, alpha) return __TS__New(
+    ____exports.Color,
+    red,
+    green,
+    blue,
+    alpha
+) end
+--- The player colors sorted by index. Does not include
+-- neutrals colors.
+____exports.playerColors = {
+    ____exports.color(255, 3, 3),
+    ____exports.color(0, 66, 255),
+    ____exports.color(28, 230, 185),
+    ____exports.color(84, 0, 129),
+    ____exports.color(255, 252, 0),
+    ____exports.color(254, 138, 14),
+    ____exports.color(32, 192, 0),
+    ____exports.color(229, 91, 176),
+    ____exports.color(149, 150, 151),
+    ____exports.color(126, 191, 241),
+    ____exports.color(16, 98, 70),
+    ____exports.color(78, 42, 3),
+    ____exports.color(155, 0, 0),
+    ____exports.color(0, 0, 195),
+    ____exports.color(0, 234, 255),
+    ____exports.color(190, 0, 254),
+    ____exports.color(235, 205, 135),
+    ____exports.color(248, 164, 139),
+    ____exports.color(191, 255, 128),
+    ____exports.color(220, 185, 235),
+    ____exports.color(80, 79, 85),
+    ____exports.color(235, 240, 255),
+    ____exports.color(0, 120, 30),
+    ____exports.color(164, 111, 51)
+}
+--- The names of players colors sorted by player index.
+____exports.playerColorNames = {
+    "red",
+    "blue",
+    "teal",
+    "purple",
+    "yellow",
+    "orange",
+    "green",
+    "pink",
+    "gray",
+    "light blue",
+    "dark green",
+    "brown",
+    "maroon",
+    "navy",
+    "turquoise",
+    "violet",
+    "wheat",
+    "peach",
+    "mint",
+    "lavender",
+    "coal",
+    "snow",
+    "emerald",
+    "peanut"
+}
+--- An ordered list of `playercolor`s, for lookup
+orderedPlayerColors = {
+    PLAYER_COLOR_RED,
+    PLAYER_COLOR_BLUE,
+    PLAYER_COLOR_CYAN,
+    PLAYER_COLOR_PURPLE,
+    PLAYER_COLOR_YELLOW,
+    PLAYER_COLOR_ORANGE,
+    PLAYER_COLOR_GREEN,
+    PLAYER_COLOR_PINK,
+    PLAYER_COLOR_LIGHT_GRAY,
+    PLAYER_COLOR_LIGHT_BLUE,
+    PLAYER_COLOR_AQUA,
+    PLAYER_COLOR_BROWN,
+    PLAYER_COLOR_MAROON,
+    PLAYER_COLOR_NAVY,
+    PLAYER_COLOR_TURQUOISE,
+    PLAYER_COLOR_VIOLET,
+    PLAYER_COLOR_WHEAT,
+    PLAYER_COLOR_PEACH,
+    PLAYER_COLOR_MINT,
+    PLAYER_COLOR_LAVENDER,
+    PLAYER_COLOR_COAL,
+    PLAYER_COLOR_SNOW,
+    PLAYER_COLOR_EMERALD,
+    PLAYER_COLOR_PEANUT
+}
+return ____exports

package/dist/lua_modules/w3ts/utils/index.lua

@@ -0,0 +1,38 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Promise = ____lualib.__TS__Promise
+local __TS__New = ____lualib.__TS__New
+local __TS__AsyncAwaiter = ____lualib.__TS__AsyncAwaiter
+local __TS__Await = ____lualib.__TS__Await
+local ____exports = {}
+local ____timer = require("lua_modules.w3ts.handles.timer")
+local Timer = ____timer.Timer
+do
+    local ____export = require("lua_modules.w3ts.utils.color")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
+function ____exports.sleep(howMuch)
+    return __TS__AsyncAwaiter(function(____awaiter_resolve)
+        return ____awaiter_resolve(
+            nil,
+            __TS__New(
+                __TS__Promise,
+                function(____, resolve, reject)
+                    local t = Timer:create()
+                    t:start(
+                        howMuch,
+                        false,
+                        function()
+                            t:destroy()
+                            resolve(nil, nil)
+                        end
+                    )
+                end
+            )
+        )
+    end)
+end
+return ____exports