warscript 0.0.1-dev.f5421e8 → 0.0.1-dev.f594e71

package/engine/local-client.d.ts

@@ -3,19 +3,46 @@ 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 and while
+     * a group selection's buttons are not registered yet (see `selectionLayoutSocket`).
+     */
     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,31 +16,179 @@ 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 ____socket = require("net.socket")
+local Socket = ____socket.Socket
+local frameGetChild = BlzFrameGetChild
+local frameGetChildrenCount = BlzFrameGetChildrenCount
+local frameGetParent = BlzFrameGetParent
+local frameGetWidth = BlzFrameGetWidth
+local frameToPixelX = BlzFrameToPixelX
+local frameToPixelY = BlzFrameToPixelY
+local getFrameByName = BlzGetFrameByName
 local getHandleId = GetHandleId
+local getLocalClientHeight = BlzGetLocalClientHeight
+local getLocalClientWidth = BlzGetLocalClientWidth
+local getLocale = BlzGetLocale
 local getMouseFocusUnit = BlzGetMouseFocusUnit
+local getMouseScreenPosX = BlzGetMouseScreenPosX
+local getMouseScreenPosY = BlzGetMouseScreenPosY
 local getUnitRealField = BlzGetUnitRealField
 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 location = Location
+local pingMinimap = PingMinimap
+local pingMinimapEx = PingMinimapEx
+local pixelToFrameX = BlzPixelToFrameX
+local pixelToFrameY = BlzPixelToFrameY
 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
-    )
+local SELECTION_DETAIL_FRAME_NAME = "SimpleInfoPanelUnitDetail"
+local SELECTION_GROUP_PANEL_INDEX = 5
+local SELECTION_BUTTON_ICON_INDEX = 1
+--- The detail panel, its parent, the group panel and the button grid.
+local SELECTION_LAYOUT_ROOT_HANDLE_COUNT = 4
+local SELECTION_LAYOUT_MAX_BUTTON_COUNT = 24
+--- The root frames plus a button and its icon per slot of the largest layout.
+local SELECTION_LAYOUT_MAX_HANDLE_COUNT = SELECTION_LAYOUT_ROOT_HANDLE_COUNT + 2 * SELECTION_LAYOUT_MAX_BUTTON_COUNT
+--- Registration requests for one local selection before giving up on its layout.
+local SELECTION_LAYOUT_MAX_REQUEST_COUNT = 8
+--- Polling ticks between two registration requests for the same selection.
+local SELECTION_LAYOUT_REQUEST_INTERVAL = 16
+local registeredSelectionGrid
+local registeredSelectionButtonCount = 0
+local registeredSelectionButtons = {}
+local registeredSelectionButtonChildCounts = {}
+local registeredSelectionIcons = {}
+--- The index of the widest (highlighted) button among the registered ones. The first value
+-- is false when the layout no longer matches the registration: the grid or a button has a
+-- different number of children, or an icon reads as zero width, which a destroyed frame does.
+local function getRegisteredMainSelectedUnitIndex()
+    local grid = registeredSelectionGrid
+    if grid == nil or frameGetChildrenCount(grid) ~= registeredSelectionButtonCount then
+        return false, 0
+    end
+    local mainSelectedUnitIndex = 0
+    local maxButtonWidth = 0
+    for i = 0, registeredSelectionButtonCount - 1 do
+        if frameGetChildrenCount(registeredSelectionButtons[i + 1]) ~= registeredSelectionButtonChildCounts[i + 1] then
+            return false, 0
+        end
+        local width = frameGetWidth(registeredSelectionIcons[i + 1])
+        if width <= 0 then
+            return false, 0
+        end
+        if width > maxButtonWidth then
+            maxButtonWidth = width
+            mainSelectedUnitIndex = i
+        end
+    end
+    return true, mainSelectedUnitIndex
+end
+local function getChildIfPresent(parent, index)
+    if parent == nil or index >= frameGetChildrenCount(parent) then
+        return nil
+    end
+    return frameGetChild(parent, index)
+end
+local function padSelectionLayoutFrames(registeredCount)
+    do
+        local i = registeredCount
+        while i < SELECTION_LAYOUT_MAX_HANDLE_COUNT do
+            location(0, 0)
+            i = i + 1
+        end
+    end
+end
+--- Wraps every frame of the group selection layout currently shown on this client, in the
+-- order `actualizeMainSelectedUnit` later walks them. Game-owned frames receive a JASS handle
+-- id the first time a script retrieves them, and the game builds the layout's buttons anew
+-- whenever the selection changes, so this must run in a tick every client shares and register
+-- the same number of handles everywhere: every frame reached for the first time counts, and
+-- the remainder up to SELECTION_LAYOUT_MAX_HANDLE_COUNT is padded with locations, the way
+-- `Frame.byOrigin` balances origin frames that appear asynchronously.
+-- 
+-- Returns the number of buttons found, or undefined when the layout was not fully reachable.
+local function registerShownSelectionLayoutFrames()
+    local registeredCount = 0
+    local function register(handle)
+        if handle == nil or getHandleId(handle) == 0 then
+            return nil
+        end
+        if not Frame:isWrapped(handle) then
+            registeredCount = registeredCount + 1
+        end
+        Frame:of(handle)
+        return handle
+    end
+    local detail = register(getFrameByName(SELECTION_DETAIL_FRAME_NAME, 0))
+    local container = register(detail ~= nil and frameGetParent(detail) or nil)
+    local groupPanel = register(getChildIfPresent(container, SELECTION_GROUP_PANEL_INDEX))
+    local grid = register(getChildIfPresent(groupPanel, 0))
+    registeredSelectionGrid = grid
+    local buttonCount
+    if grid ~= nil then
+        local count = frameGetChildrenCount(grid)
+        if count <= SELECTION_LAYOUT_MAX_BUTTON_COUNT then
+            buttonCount = count
+            for i = 0, count - 1 do
+                local button = register(getChildIfPresent(grid, i))
+                local icon = register(getChildIfPresent(button, SELECTION_BUTTON_ICON_INDEX))
+                if button == nil or icon == nil then
+                    buttonCount = nil
+                else
+                    registeredSelectionButtons[i + 1] = button
+                    registeredSelectionButtonChildCounts[i + 1] = frameGetChildrenCount(button)
+                    registeredSelectionIcons[i + 1] = icon
+                end
+            end
+        end
+    end
+    padSelectionLayoutFrames(registeredCount)
+    return buttonCount
+end
+local function getExpectedSelectionLayoutButtonCount(selectionCount)
+    return selectionCount <= 12 and 12 or SELECTION_LAYOUT_MAX_BUTTON_COUNT
+end
+local selectionLayoutSocket = __TS__New(Socket)
+local localSelectionSignature = 0
+local localSelectionEpoch = 0
+local localSelectionCount = 0
+local registeredSelectionEpoch = 0
+local selectionLayoutRequestCount = 0
+local selectionLayoutRequestPending = false
+local selectionLayoutPollTick = 0
+local selectionLayoutRequestTick = -SELECTION_LAYOUT_REQUEST_INTERVAL
+selectionLayoutSocket.onMessage:addListener(function(player)
+    if player ~= Player["local"] then
+        padSelectionLayoutFrames(0)
+        return
+    end
+    selectionLayoutRequestPending = false
+    local buttonCount = registerShownSelectionLayoutFrames()
+    if buttonCount ~= nil and localSelectionCount > 1 and buttonCount == getExpectedSelectionLayoutButtonCount(localSelectionCount) then
+        registeredSelectionEpoch = localSelectionEpoch
+        registeredSelectionButtonCount = buttonCount
+    end
 end)
 local localSelectedUnits = {}
 local indexByLocalSelectedUnit = {}
@@ -57,11 +206,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 +277,13 @@ __TS__ObjectDefineProperty(
         return getLocalClientHeight()
     end}
 )
+__TS__ObjectDefineProperty(
+    LocalClient,
+    "isSD",
+    {get = function(self)
+        return true
+    end}
+)
 __TS__ObjectDefineProperty(
     LocalClient,
     "isHD",
@@ -84,11 +291,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 +312,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 +358,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 +367,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 +388,97 @@ LocalClient.onDisconnect = __TS__New(
     end,
     function() return  end
 )
+local function actualizeMainSelectedUnit()
+    Unit:getSelectionOf(Player["local"], localSelectedUnits)
+    local selectionCount = #localSelectedUnits
+    local signature = selectionCount
+    for i = 1, selectionCount do
+        indexByLocalSelectedUnit[localSelectedUnits[i]] = i
+        signature = signature + getHandleId(localSelectedUnits[i].handle)
+    end
+    selectionLayoutPollTick = selectionLayoutPollTick + 1
+    if signature ~= localSelectionSignature then
+        localSelectionSignature = signature
+        localSelectionEpoch = localSelectionEpoch + 1
+        selectionLayoutRequestCount = 0
+        selectionLayoutRequestTick = -SELECTION_LAYOUT_REQUEST_INTERVAL
+    end
+    localSelectionCount = selectionCount
+    tableSort(localSelectedUnits, compareUnitsSelectionPriority)
+    local mainSelectedUnitIndex
+    if selectionCount > 1 then
+        local registered = registeredSelectionEpoch == localSelectionEpoch
+        if registered then
+            local intact, index = getRegisteredMainSelectedUnitIndex()
+            if intact then
+                mainSelectedUnitIndex = index
+            else
+                registered = false
+                registeredSelectionEpoch = 0
+            end
+        end
+        if not registered and not selectionLayoutRequestPending and selectionLayoutRequestCount < SELECTION_LAYOUT_MAX_REQUEST_COUNT and selectionLayoutPollTick - selectionLayoutRequestTick >= SELECTION_LAYOUT_REQUEST_INTERVAL then
+            selectionLayoutRequestPending = true
+            selectionLayoutRequestCount = selectionLayoutRequestCount + 1
+            selectionLayoutRequestTick = selectionLayoutPollTick
+            selectionLayoutSocket:send("")
+        end
+    end
+    local mainSelectedUnit
+    if selectionCount <= 1 then
+        mainSelectedUnit = localSelectedUnits[1]
+    elseif mainSelectedUnitIndex ~= nil then
+        mainSelectedUnit = localSelectedUnits[mainSelectedUnitIndex + 1]
+    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 function getTargetingModeState()
+    for i = 0, 10 do
+        if commandButtons[i + 1].visible then
+            return false
+        end
+    end
+    return commandButtons[12].visible
+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 / 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/armor-type.d.ts

@@ -0,0 +1,11 @@
+/** @noSelfInFile */
+export declare const enum ArmorType {
+    LIGHT = 0,
+    MEDIUM = 1,
+    HEAVY = 2,
+    FORTIFIED = 3,
+    NORMAL = 4,
+    HERO = 5,
+    DIVINE = 6,
+    UNARMORED = 7
+}

package/engine/object-data/auxiliary/armor-type.lua

@@ -0,0 +1,46 @@
+local ____exports = {}
+local ____records = require("utility.records")
+local invertRecord = ____records.invertRecord
+local stringByArmorType = {
+    [0] = "small",
+    [1] = "medium",
+    [2] = "large",
+    [3] = "fort",
+    [4] = "normal",
+    [5] = "hero",
+    [6] = "divine",
+    [7] = "none"
+}
+local armorTypeByString = invertRecord(stringByArmorType)
+local nativeByArmorType = {
+    [0] = DEFENSE_TYPE_LIGHT,
+    [1] = DEFENSE_TYPE_MEDIUM,
+    [2] = DEFENSE_TYPE_LARGE,
+    [3] = DEFENSE_TYPE_FORT,
+    [4] = DEFENSE_TYPE_NORMAL,
+    [5] = DEFENSE_TYPE_HERO,
+    [6] = DEFENSE_TYPE_DIVINE,
+    [7] = DEFENSE_TYPE_NONE
+}
+local armorTypeByNative = invertRecord(nativeByArmorType)
+---
+-- @internal For use by internal systems only.
+____exports.armorTypeToString = function(armorType)
+    return stringByArmorType[armorType]
+end
+---
+-- @internal For use by internal systems only.
+____exports.stringToArmorType = function(____string)
+    return armorTypeByString[____string] or 7
+end
+---
+-- @internal For use by internal systems only.
+____exports.armorTypeToNative = function(armorType)
+    return nativeByArmorType[armorType]
+end
+---
+-- @internal For use by internal systems only.
+____exports.nativeToArmorType = function(armorType)
+    return armorTypeByNative[armorType]
+end
+return ____exports

package/engine/object-data/auxiliary/attack-type.d.ts

@@ -1,11 +1,10 @@
 /** @noSelfInFile */
 export declare const enum AttackType {
-    NONE = "unknown",
-    NORMAL = "normal",
-    PIERCE = "pierce",
-    SIEGE = "siege",
-    SPELL = "spells",
-    CHAOS = "chaos",
-    MAGIC = "magic",
-    HERO = "hero"
+    SPELL = 0,
+    NORMAL = 1,
+    PIERCE = 2,
+    SIEGE = 3,
+    MAGIC = 4,
+    CHAOS = 5,
+    HERO = 6
 }

package/engine/object-data/auxiliary/attack-type.lua

@@ -1,2 +1,44 @@
 local ____exports = {}
+local ____records = require("utility.records")
+local invertRecord = ____records.invertRecord
+local stringByAttackType = {
+    [1] = "normal",
+    [2] = "pierce",
+    [3] = "siege",
+    [0] = "spells",
+    [5] = "chaos",
+    [4] = "magic",
+    [6] = "hero"
+}
+local attackTypeByString = invertRecord(stringByAttackType)
+local nativeByAttackType = {
+    [1] = ATTACK_TYPE_MELEE,
+    [2] = ATTACK_TYPE_PIERCE,
+    [3] = ATTACK_TYPE_SIEGE,
+    [0] = ATTACK_TYPE_NORMAL,
+    [5] = ATTACK_TYPE_CHAOS,
+    [4] = ATTACK_TYPE_MAGIC,
+    [6] = ATTACK_TYPE_HERO
+}
+local attackTypeByNative = invertRecord(nativeByAttackType)
+---
+-- @internal For use by internal systems only.
+____exports.attackTypeToString = function(attackType)
+    return attackType ~= nil and stringByAttackType[attackType] or "unknown"
+end
+---
+-- @internal For use by internal systems only.
+____exports.stringToAttackType = function(____string)
+    return attackTypeByString[____string]
+end
+---
+-- @internal For use by internal systems only.
+____exports.attackTypeToNative = function(attackType)
+    return nativeByAttackType[attackType]
+end
+---
+-- @internal For use by internal systems only.
+____exports.nativeToAttackType = function(attackType)
+    return attackTypeByNative[attackType]
+end
 return ____exports

package/engine/object-data/auxiliary/equipment-slot.d.ts

@@ -0,0 +1,12 @@
+/** @noSelfInFile */
+export declare const enum EquipmentSlot {
+    HEAD = 0,
+    CHEST = 1,
+    GLOVES = 2,
+    BOOTS = 3,
+    RING = 4,
+    ALTERNATE_RING = 5,
+    PRIMARY = 6,
+    OFFHAND = 7,
+    TRINKET = 8
+}

package/engine/object-data/auxiliary/equipment-slot.lua

@@ -0,0 +1,2 @@
+local ____exports = {}
+return ____exports