warscript 0.0.1-dev.d750e38 → 0.0.1-dev.d77b529

package/engine/lightning.d.ts

@@ -1,7 +1,7 @@
 /** @noSelfInFile */
 import { LightningTypeId } from "./object-data/entry/lightning-type";
-import { Handle, HandleDestructor } from "../core/types/handle";
 import { Unit } from "../core/types/unit";
+import { AbstractDestroyable, Destructor } from "../destroyable";
 declare const enum LightningPropertyKey {
     CHECK_VISIBILITY = 100,
     SOURCE_UNIT = 101,
@@ -16,7 +16,8 @@ declare const enum LightningPropertyKey {
     FADING = 110
 }
 export type LightningConstructor<T extends Lightning> = typeof Lightning & (new (handle: jlightning, typeId: LightningTypeId) => T);
-export declare class Lightning extends Handle<jlightning> {
+export declare class Lightning extends AbstractDestroyable {
+    readonly handle: jlightning;
     readonly typeId: LightningTypeId;
     private [LightningPropertyKey.CHECK_VISIBILITY]?;
     private [LightningPropertyKey.SOURCE_UNIT]?;
@@ -30,7 +31,7 @@ export declare class Lightning extends Handle<jlightning> {
     private [LightningPropertyKey.DURATION]?;
     private [LightningPropertyKey.FADING]?;
     constructor(handle: jlightning, typeId: LightningTypeId);
-    protected onDestroy(): HandleDestructor;
+    protected onDestroy(): Destructor;
     static create<T extends Lightning>(this: LightningConstructor<T>, typeId: LightningTypeId, ...parameters: [
         ...checkVisibility: [boolean] | [],
         ...sourceAndTarget: [sourceX: number, sourceY: number, targetX: number, targetY: number] | [

package/engine/lightning.lua

@@ -1,17 +1,16 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local ____handle = require("core.types.handle")
-local Handle = ____handle.Handle
 local ____timer = require("core.types.timer")
 local Timer = ____timer.Timer
 local ____functions = require("utility.functions")
 local forwardByN = ____functions.forwardByN
 local ____unit_2Dmissile_2Ddata = require("engine.internal.unit-missile-data")
 local MISSILE_DATA_BY_UNIT_TYPE_ID = ____unit_2Dmissile_2Ddata.MISSILE_DATA_BY_UNIT_TYPE_ID
-local ____math = require("math")
-local ceil = ____math.ceil
+local ____destroyable = require("destroyable")
+local AbstractDestroyable = ____destroyable.AbstractDestroyable
 local ____type = _G.type
 local select = _G.select
 local cos = math.cos
@@ -43,9 +42,10 @@ local temporaryLightningsCount = 0
 ____exports.Lightning = __TS__Class()
 local Lightning = ____exports.Lightning
 Lightning.name = "Lightning"
-__TS__ClassExtends(Lightning, Handle)
+__TS__ClassExtends(Lightning, AbstractDestroyable)
 function Lightning.prototype.____constructor(self, handle, typeId)
-    Handle.prototype.____constructor(self, handle)
+    AbstractDestroyable.prototype.____constructor(self)
+    self.handle = handle
     self.typeId = typeId
 end
 function Lightning.prototype.onDestroy(self)
@@ -53,7 +53,7 @@ function Lightning.prototype.onDestroy(self)
     unitToPointLightnings[self] = nil
     pointToUnitLightnings[self] = nil
     destroyLightning(self.handle)
-    return Handle.prototype.onDestroy(self)
+    return AbstractDestroyable.prototype.onDestroy(self)
 end
 function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, sourceYOrTargetXOrTargetUnit, sourceZOrTargetXOrTargetUnitOrTargetY, targetXOrTargetUnitOrTargetYOrTargetZ, targetY, targetZ)
     if type(checkVisibility) ~= "boolean" then
@@ -69,7 +69,8 @@ function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, so
         )
     end
     if targetZ ~= nil then
-        return self:of(
+        return __TS__New(
+            self,
             addLightningEx(
                 util.id2s(typeId),
                 checkVisibility,
@@ -86,7 +87,8 @@ function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, so
     if targetXOrTargetUnitOrTargetYOrTargetZ ~= nil then
         if ____type(targetXOrTargetUnitOrTargetYOrTargetZ) == "number" then
             if ____type(sourceXOrSourceUnit) == "number" then
-                return self:of(
+                return __TS__New(
+                    self,
                     addLightning(
                         util.id2s(typeId),
                         checkVisibility,
@@ -99,7 +101,8 @@ function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, so
                 )
             end
             local unit = sourceXOrSourceUnit.handle
-            local lightning = self:of(
+            local lightning = __TS__New(
+                self,
                 addLightningEx(
                     util.id2s(typeId),
                     checkVisibility,
@@ -124,7 +127,8 @@ function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, so
             return lightning
         end
         local unit = targetXOrTargetUnitOrTargetYOrTargetZ.handle
-        local lightning = self:of(
+        local lightning = __TS__New(
+            self,
             addLightningEx(
                 util.id2s(typeId),
                 checkVisibility,
@@ -153,7 +157,8 @@ function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, so
             local unit = sourceXOrSourceUnit.handle
             moveLocation(location, sourceYOrTargetXOrTargetUnit, sourceZOrTargetXOrTargetUnitOrTargetY)
             local z = getLocationZ(location)
-            local lightning = self:of(
+            local lightning = __TS__New(
+                self,
                 addLightningEx(
                     util.id2s(typeId),
                     checkVisibility,
@@ -180,7 +185,8 @@ function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, so
         local unit = sourceZOrTargetXOrTargetUnitOrTargetY.handle
         moveLocation(location, sourceXOrSourceUnit, sourceYOrTargetXOrTargetUnit)
         local z = getLocationZ(location)
-        local lightning = self:of(
+        local lightning = __TS__New(
+            self,
             addLightningEx(
                 util.id2s(typeId),
                 checkVisibility,
@@ -206,7 +212,8 @@ function Lightning.create(self, typeId, checkVisibility, sourceXOrSourceUnit, so
     end
     local sourceUnit = sourceXOrSourceUnit.handle
     local targetUnit = sourceYOrTargetXOrTargetUnit.handle
-    local lightning = self:of(
+    local lightning = __TS__New(
+        self,
         addLightningEx(
             util.id2s(typeId),
             checkVisibility,
@@ -319,7 +326,7 @@ Timer.onPeriod[UPDATE_PERIOD]:addListener(function()
                     getLightningColorR(handle),
                     getLightningColorG(handle),
                     getLightningColorB(handle),
-                    ceil(getLightningColorA(handle) * (1 - UPDATE_PERIOD / duration))
+                    getLightningColorA(handle) * (1 - UPDATE_PERIOD / duration)
                 )
             end
             lightning[109] = duration - UPDATE_PERIOD

package/engine/local-client.d.ts

@@ -3,19 +3,47 @@ import { Unit } from "../core/types/unit";
 import { Async } from "../core/types/async";
 import { Event, TriggerEvent } from "../event";
 import { GraphicsMode } from "./index";
+import { Color } from "../core/types/color";
 export declare class LocalClient {
     private constructor();
     static readonly locale: string;
     static get width(): number;
     static get height(): number;
+    static get isSD(): boolean;
     static get isHD(): boolean;
+    static get isDE(): boolean;
     static get graphicsMode(): GraphicsMode;
     static get isActive(): boolean;
+    static get isMinimized(): boolean;
+    static pingMinimap(x: number, y: number, duration: number, ...parameters: [] | [red: number, green: number, blue: number, flashy?: boolean] | [color: Color, flashy?: boolean]): void;
+    /** Local input state; do not use to branch synchronized game logic. */
+    static isKeyPressed(key: joskeytype): boolean;
+    /** Local input state. Uses the same modifier mask as Player key events. */
+    static isMetaKeyPressed(key: oskeymeta): boolean;
+    /** Local input state. */
+    static isMouseButtonPressed(button: jmousebuttontype): boolean;
+    static get mouseScreenX(): number;
+    static get mouseScreenY(): number;
+    static screenToFrameX(x: number): number;
+    static screenToFrameY(y: number): number;
+    static frameToScreenX(x: number): number;
+    static frameToScreenY(y: number): number;
+    static get mouseFrameX(): number;
+    static get mouseFrameY(): number;
     static get mouseFocusUnit(): Async<Unit> | undefined;
+    /**
+     * Local selection sampled every 1/64 second; undefined before the first tick. Among
+     * several selected units, the one the portrait shows, identified by its health and
+     * mana; units with identical values cannot be told apart.
+     */
     static get mainSelectedUnit(): Async<Unit> | undefined;
     static get mainSelectedUnitChangeEvent(): Event<[
         previousMainSelectedUnit: Unit | undefined,
         newMainSelectedUnit: Unit | undefined
     ]>;
+    static get isInTargetingMode(): boolean;
+    static readonly targetingModeEnterEvent: Event<[]>;
+    static readonly targetingModeLeaveEvent: Event<[]>;
+    static readonly targetingModeStateChangeEvent: Event<[]>;
     static readonly onDisconnect: TriggerEvent<[]>;
 }

package/engine/local-client.lua

@@ -1,9 +1,10 @@
 local ____lualib = require("lualib_bundle")
-local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__New = ____lualib.__TS__New
 local __TS__Class = ____lualib.__TS__Class
+local __TS__InstanceOf = ____lualib.__TS__InstanceOf
 local __TS__ObjectDefineProperty = ____lualib.__TS__ObjectDefineProperty
-local __TS__New = ____lualib.__TS__New
 local ____exports = {}
+local actualizeTargetingModeState
 local ____unit = require("core.types.unit")
 local Unit = ____unit.Unit
 local ____event = require("event")
@@ -15,32 +16,99 @@ local ____player = require("core.types.player")
 local Player = ____player.Player
 local ____timer = require("core.types.timer")
 local Timer = ____timer.Timer
-local loadTOCFile = BlzLoadTOCFile
-local getLocalClientWidth = BlzGetLocalClientWidth
-local getLocalClientHeight = BlzGetLocalClientHeight
-local isLocalClientActive = BlzIsLocalClientActive
-local isHeroUnitId = IsHeroUnitId
+local ____color = require("core.types.color")
+local Color = ____color.Color
+local ____arrays = require("utility.arrays")
+local array = ____arrays.array
+local frameToPixelX = BlzFrameToPixelX
+local frameToPixelY = BlzFrameToPixelY
 local getHandleId = GetHandleId
+local getLocalClientHeight = BlzGetLocalClientHeight
+local getLocalClientWidth = BlzGetLocalClientWidth
+local getLocale = BlzGetLocale
 local getMouseFocusUnit = BlzGetMouseFocusUnit
+local getMouseScreenPosX = BlzGetMouseScreenPosX
+local getMouseScreenPosY = BlzGetMouseScreenPosY
+local frameGetText = BlzFrameGetText
 local getUnitRealField = BlzGetUnitRealField
+local getUnitState = GetUnitState
 local getUnitTypeId = GetUnitTypeId
-local getLocale = BlzGetLocale
+local isHeroUnitId = IsHeroUnitId
+local isKeyPressed = BlzIsKeyPressed
+local isLocalClientActive = BlzIsLocalClientActive
+local isMetaKeyPressed = BlzIsMetaKeyPressed
+local isMouseButtonPressed = BlzIsMouseButtonPressed
+local loadTOCFile = BlzLoadTOCFile
+local pingMinimap = PingMinimap
+local pingMinimapEx = PingMinimapEx
+local pixelToFrameX = BlzPixelToFrameX
+local pixelToFrameY = BlzPixelToFrameY
+local setFrameVisible = BlzFrameSetVisible
 local tableSort = table.sort
-local tocPath = "_warscript\\IsHD.toc"
+local hdTocPath = "_warscript\\IsHD.toc"
+local deTocPath = "_warscript\\IsDE.toc"
 compiletime(function()
     if currentMap then
-        local fdfPath = "_warscript\\IsHD.fdf"
-        currentMap:addFileString("_HD.w3mod\\" .. fdfPath, "\r\n")
-        currentMap:addFileString("_HD.w3mod\\" .. tocPath, fdfPath .. "\r\n")
+        local hdFdfPath = "_warscript\\IsHD.fdf"
+        currentMap:addFileString("_HD.w3mod\\" .. hdFdfPath, "\r\n")
+        currentMap:addFileString("_HD.w3mod\\" .. hdTocPath, hdFdfPath .. "\r\n")
+        local deFdfPath = "_warscript\\IsDE.fdf"
+        currentMap:addFileString("_DE.w3mod\\" .. deFdfPath, "\r\n")
+        currentMap:addFileString("_DE.w3mod\\" .. deTocPath, deFdfPath .. "\r\n")
     end
 end)
-local selectionButtons
-Timer:run(function()
-    selectionButtons = __TS__ArrayMap(
-        Frame:byName("SimpleInfoPanelUnitDetail").parent:getChild(5):getChild(0).children,
-        function(____, frame) return frame:getChild(1) end
+--- The portrait's health and mana texts show the focused unit's current and maximum values
+-- as "current / maximum". Once they exist, these origin frames live for the whole game, so
+-- the polling may read them every tick; the group panel's buttons, by contrast, are rebuilt
+-- at any selection change and a retained button handle crashes the game on the first native
+-- called with it. The frames are not there at map load, though, and appear at different
+-- times on different clients: `Frame.byOrigin` returns undefined until then and balances
+-- the handle allocation across clients, so it is asked again once a second.
+local portraitHpText
+local portraitManaText
+local function actualizePortraitFrames()
+    portraitHpText = Frame:byOrigin(ORIGIN_FRAME_PORTRAIT_HP_TEXT)
+    portraitManaText = Frame:byOrigin(ORIGIN_FRAME_PORTRAIT_MANA_TEXT)
+end
+--- Finds "current / maximum" in the text, which may also carry color codes and other
+-- decoration; returns -1 for both when there is no such pair.
+local function parsePortraitValues(frame)
+    if frame == nil then
+        return -1, -1
+    end
+    local text = frameGetText(frame.handle)
+    local current, maximum = string.match(text, "(%d+)%s*/%s*(%d+)")
+    if current == nil or maximum == nil then
+        return -1, -1
+    end
+    return tonumber(current), tonumber(maximum)
+end
+--- Whether a unit value can be what the portrait shows as `shown`; the rounding rule is unknown.
+local function matchesPortraitValue(value, shown)
+    return math.abs(value - shown) < 1
+end
+--- Whether the unit's health matches what the portrait shows; the health text is required.
+local function matchesPortraitHealth(unit, hp, maxHp)
+    local handle = unit.handle
+    return maxHp >= 0 and matchesPortraitValue(
+        getUnitState(handle, UNIT_STATE_LIFE),
+        hp
+    ) and matchesPortraitValue(
+        getUnitState(handle, UNIT_STATE_MAX_LIFE),
+        maxHp
     )
-end)
+end
+--- Whether the unit has mana and it matches what the portrait shows. The mana text is not
+-- redrawn for a unit without mana (it keeps the previously focused unit's values), so a
+-- mana match is evidence for a unit, but a mismatch is no evidence against one without mana.
+local function matchesPortraitMana(unit, mana, maxMana)
+    local handle = unit.handle
+    local unitMaxMana = getUnitState(handle, UNIT_STATE_MAX_MANA)
+    return maxMana >= 0 and unitMaxMana > 0 and matchesPortraitValue(
+        getUnitState(handle, UNIT_STATE_MANA),
+        mana
+    ) and matchesPortraitValue(unitMaxMana, maxMana)
+end
 local localSelectedUnits = {}
 local indexByLocalSelectedUnit = {}
 local function compareUnitsSelectionPriority(a, b)
@@ -57,11 +125,62 @@ local function compareUnitsSelectionPriority(a, b)
 end
 local mainSelectedUnitChangeEvent
 local previousMainSelectedUnit
+local currentMainSelectedUnit
+local lastTargetingModeState = false
+local targetingModeEnterEvent = __TS__New(Event)
+local targetingModeLeaveEvent = __TS__New(Event)
+local targetingModeStateChangeEvent = __TS__New(Event)
 ____exports.LocalClient = __TS__Class()
 local LocalClient = ____exports.LocalClient
 LocalClient.name = "LocalClient"
 function LocalClient.prototype.____constructor(self)
 end
+function LocalClient.pingMinimap(self, x, y, duration, redOrColor, greenOrFlashy, blue, flashy)
+    if redOrColor == nil then
+        pingMinimap(x, y, duration)
+    elseif __TS__InstanceOf(redOrColor, Color) then
+        pingMinimapEx(
+            x,
+            y,
+            duration,
+            redOrColor.r,
+            redOrColor.g,
+            redOrColor.b,
+            greenOrFlashy or false
+        )
+    else
+        pingMinimapEx(
+            x,
+            y,
+            duration,
+            redOrColor,
+            greenOrFlashy,
+            blue,
+            flashy or false
+        )
+    end
+end
+function LocalClient.isKeyPressed(self, key)
+    return isKeyPressed(key)
+end
+function LocalClient.isMetaKeyPressed(self, key)
+    return isMetaKeyPressed(key)
+end
+function LocalClient.isMouseButtonPressed(self, button)
+    return isMouseButtonPressed(button)
+end
+function LocalClient.screenToFrameX(self, x)
+    return pixelToFrameX(x)
+end
+function LocalClient.screenToFrameY(self, y)
+    return pixelToFrameY(y)
+end
+function LocalClient.frameToScreenX(self, x)
+    return frameToPixelX(x)
+end
+function LocalClient.frameToScreenY(self, y)
+    return frameToPixelY(y)
+end
 LocalClient.locale = getLocale()
 __TS__ObjectDefineProperty(
     LocalClient,
@@ -77,6 +196,13 @@ __TS__ObjectDefineProperty(
         return getLocalClientHeight()
     end}
 )
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "isSD",
+    {get = function(self)
+        return true
+    end}
+)
 __TS__ObjectDefineProperty(
     LocalClient,
     "isHD",
@@ -84,11 +210,18 @@ __TS__ObjectDefineProperty(
         return false
     end}
 )
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "isDE",
+    {get = function(self)
+        return false
+    end}
+)
 __TS__ObjectDefineProperty(
     LocalClient,
     "graphicsMode",
     {get = function(self)
-        return self.isHD and 1 or 0
+        return 0
     end}
 )
 __TS__ObjectDefineProperty(
@@ -98,6 +231,41 @@ __TS__ObjectDefineProperty(
         return isLocalClientActive()
     end}
 )
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "isMinimized",
+    {get = function(self)
+        return getLocalClientHeight() == 0
+    end}
+)
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "mouseScreenX",
+    {get = function(self)
+        return getMouseScreenPosX()
+    end}
+)
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "mouseScreenY",
+    {get = function(self)
+        return getMouseScreenPosY()
+    end}
+)
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "mouseFrameX",
+    {get = function(self)
+        return pixelToFrameX(getMouseScreenPosX())
+    end}
+)
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "mouseFrameY",
+    {get = function(self)
+        return pixelToFrameY(getMouseScreenPosY())
+    end}
+)
 __TS__ObjectDefineProperty(
     LocalClient,
     "mouseFocusUnit",
@@ -109,33 +277,7 @@ __TS__ObjectDefineProperty(
     LocalClient,
     "mainSelectedUnit",
     {get = function(self)
-        Unit:getSelectionOf(Player["local"], localSelectedUnits)
-        for i = 1, #localSelectedUnits do
-            indexByLocalSelectedUnit[localSelectedUnits[i]] = i
-        end
-        tableSort(localSelectedUnits, compareUnitsSelectionPriority)
-        local mainSelectedUnitIndex
-        if selectionButtons and #localSelectedUnits > 1 then
-            local maxButtonWidth = 0
-            for i = 0, #selectionButtons - 1 do
-                local width = selectionButtons[i + 1].width
-                if width > maxButtonWidth then
-                    maxButtonWidth = width
-                    mainSelectedUnitIndex = i
-                end
-            end
-        end
-        local mainSelectedUnit = localSelectedUnits[(mainSelectedUnitIndex or 0) + 1]
-        for i = 1, #localSelectedUnits do
-            indexByLocalSelectedUnit[localSelectedUnits[i]] = nil
-            localSelectedUnits[i] = nil
-        end
-        if mainSelectedUnitChangeEvent ~= nil and mainSelectedUnit ~= previousMainSelectedUnit then
-            local previousPreviousMainSelectedUnit = previousMainSelectedUnit
-            previousMainSelectedUnit = mainSelectedUnit
-            Event.invoke(mainSelectedUnitChangeEvent, previousPreviousMainSelectedUnit, previousMainSelectedUnit)
-        end
-        return mainSelectedUnit
+        return currentMainSelectedUnit
     end}
 )
 __TS__ObjectDefineProperty(
@@ -144,13 +286,20 @@ __TS__ObjectDefineProperty(
     {get = function(self)
         if mainSelectedUnitChangeEvent == nil then
             mainSelectedUnitChangeEvent = __TS__New(Event)
-            Timer.onPeriod[1 / 64]:addListener(function()
-                local _ = ____exports.LocalClient.mainSelectedUnit
-            end)
         end
         return mainSelectedUnitChangeEvent
     end}
 )
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "isInTargetingMode",
+    {get = function(self)
+        return actualizeTargetingModeState()
+    end}
+)
+LocalClient.targetingModeEnterEvent = targetingModeEnterEvent
+LocalClient.targetingModeLeaveEvent = targetingModeLeaveEvent
+LocalClient.targetingModeStateChangeEvent = targetingModeStateChangeEvent
 LocalClient.onDisconnect = __TS__New(
     TriggerEvent,
     function(trigger)
@@ -158,11 +307,132 @@ LocalClient.onDisconnect = __TS__New(
     end,
     function() return  end
 )
+local function actualizeMainSelectedUnit()
+    Unit:getSelectionOf(Player["local"], localSelectedUnits)
+    local selectionCount = #localSelectedUnits
+    for i = 1, selectionCount do
+        indexByLocalSelectedUnit[localSelectedUnits[i]] = i
+    end
+    tableSort(localSelectedUnits, compareUnitsSelectionPriority)
+    local mainSelectedUnit
+    if selectionCount <= 1 then
+        mainSelectedUnit = localSelectedUnits[1]
+    else
+        local hp, maxHp = parsePortraitValues(portraitHpText)
+        local mana, maxMana = parsePortraitValues(portraitManaText)
+        if maxHp >= 0 then
+            local healthMatch
+            for i = 1, selectionCount do
+                local unit = localSelectedUnits[i]
+                if matchesPortraitHealth(unit, hp, maxHp) then
+                    if matchesPortraitMana(unit, mana, maxMana) then
+                        mainSelectedUnit = unit
+                        break
+                    end
+                    if healthMatch == nil then
+                        healthMatch = unit
+                    end
+                end
+            end
+            if mainSelectedUnit == nil then
+                mainSelectedUnit = healthMatch
+            end
+        end
+        if mainSelectedUnit == nil and previousMainSelectedUnit ~= nil then
+            for i = 1, selectionCount do
+                if localSelectedUnits[i] == previousMainSelectedUnit then
+                    mainSelectedUnit = previousMainSelectedUnit
+                    break
+                end
+            end
+        end
+        if mainSelectedUnit == nil then
+            mainSelectedUnit = localSelectedUnits[1]
+        end
+    end
+    for i = 1, selectionCount do
+        indexByLocalSelectedUnit[localSelectedUnits[i]] = nil
+        localSelectedUnits[i] = nil
+    end
+    currentMainSelectedUnit = mainSelectedUnit
+    if mainSelectedUnitChangeEvent ~= nil and mainSelectedUnit ~= previousMainSelectedUnit then
+        local previousPreviousMainSelectedUnit = previousMainSelectedUnit
+        previousMainSelectedUnit = mainSelectedUnit
+        Event.invoke(mainSelectedUnitChangeEvent, previousPreviousMainSelectedUnit, previousMainSelectedUnit)
+    end
+end
+local commandButtons = array(
+    12,
+    function(i) return Frame:byOrigin(ORIGIN_FRAME_COMMAND_BUTTON, i) end
+)
+local commandButtonContainers = array(
+    12,
+    function(i) return Frame:byName("CommandButton_" .. tostring(i)) end
+)
+local function getTargetingModeState()
+    for ____, container in ipairs(commandButtonContainers) do
+        if container.hideCounter > 0 then
+            setFrameVisible(container.handle, true)
+        end
+    end
+    local targeting = false
+    local failed = false
+    local failure
+    do
+        local function ____catch(____error)
+            failed = true
+            failure = ____error
+        end
+        local ____try, ____hasReturned = pcall(function()
+            targeting = commandButtons[12].visible
+            for i = 0, 10 do
+                if commandButtons[i + 1].visible then
+                    targeting = false
+                    break
+                end
+            end
+        end)
+        if not ____try then
+            ____catch(____hasReturned)
+        end
+    end
+    for ____, container in ipairs(commandButtonContainers) do
+        if container.hideCounter > 0 then
+            setFrameVisible(container.handle, false)
+        end
+    end
+    if failed then
+        error(failure, 0)
+    end
+    return targeting
+end
+actualizeTargetingModeState = function()
+    if getTargetingModeState() then
+        if not lastTargetingModeState then
+            lastTargetingModeState = true
+            Event.invoke(targetingModeEnterEvent)
+            Event.invoke(targetingModeStateChangeEvent)
+        end
+        return true
+    end
+    if lastTargetingModeState then
+        lastTargetingModeState = false
+        Event.invoke(targetingModeLeaveEvent)
+        Event.invoke(targetingModeStateChangeEvent)
+    end
+    return false
+end
+Timer.onPeriod[1]:addListener(actualizePortraitFrames)
+Timer.onPeriod[1 / 64]:addListener(function()
+    actualizeMainSelectedUnit()
+    actualizeTargetingModeState()
+end)
 warpack.afterMapInit(function()
-    rawset(
-        ____exports.LocalClient,
-        "isHD",
-        loadTOCFile(tocPath)
-    )
+    local isDE = loadTOCFile(deTocPath)
+    local isHD = not isDE and loadTOCFile(hdTocPath)
+    rawset(____exports.LocalClient, "isDE", isDE)
+    rawset(____exports.LocalClient, "isHD", isHD)
+    rawset(____exports.LocalClient, "isSD", not isDE and not isHD)
+    rawset(____exports.LocalClient, "graphicsMode", isDE and 2 or (isHD and 1 or 0))
 end)
 return ____exports

package/engine/object-data/auxiliary/animation-name.d.ts

@@ -12,3 +12,4 @@ export declare const enum AnimationName {
     STAND = "stand",
     WALK = "walk"
 }
+export declare const isAnimationName: (value: string) => value is AnimationName;

package/engine/object-data/auxiliary/animation-name.lua

@@ -1,2 +1,18 @@
 local ____exports = {}
+local animationNames = {
+    attack = true,
+    birth = true,
+    death = true,
+    decay = true,
+    dissipate = true,
+    morph = true,
+    portrait = true,
+    sleep = true,
+    spell = true,
+    stand = true,
+    walk = true
+}
+____exports.isAnimationName = function(value)
+    return animationNames[value] ~= nil
+end
 return ____exports