warscript 0.0.1-dev.e0e46c4 → 0.0.1-dev.e147c49

package/engine/internal/unit/equipment.lua

@@ -0,0 +1,169 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__New = ____lualib.__TS__New
+local __TS__ObjectDefineProperty = ____lualib.__TS__ObjectDefineProperty
+local ____exports = {}
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local UnitTriggerEvent = ____unit.UnitTriggerEvent
+local ____item = require("engine.internal.item")
+local Item = ____item.Item
+local ____event = require("event")
+local IgnoreEvent = ____event.IgnoreEvent
+local ____dummy = require("objutil.dummy")
+local dummyUnitId = ____dummy.dummyUnitId
+local ____ignore_2Devents_2Ditems = require("engine.internal.unit.ignore-events-items")
+local ignoreEventsItems = ____ignore_2Devents_2Ditems.ignoreEventsItems
+local convertEquipmentType = ConvertEquipmentType
+local convertLoadoutSlot = ConvertLoadoutSlot
+local getEquippedItem = GetEquippedItem
+local getStackingItemSource = BlzGetStackingItemSource
+local getStackingItemTarget = BlzGetStackingItemTarget
+local getStackingItemTargetPreviousCharges = BlzGetStackingItemTargetPreviousCharges
+local getTriggerUnit = GetTriggerUnit
+local getUnequippedItem = GetUnequippedItem
+local getUnitTypeId = GetUnitTypeId
+local unitCanEquipItemOfEquipmentType = UnitCanEquipItemOfEquipmentType
+local unitEquipItem = UnitEquipItem
+local unitHasAnyItemEquiped = UnitHasAnyItemEquiped
+local unitHasItemEquipmentOfType = UnitHasItemEquipmentOfType
+local unitHasItemEquipped = UnitHasItemEquipped
+local unitHasLoadoutSlotEmpty = UnitHasLoadoutSlotEmpty
+local unitItemInEquipmentSlot = UnitItemInEquipmentSlot
+local unitUnequipItem = UnitUnequipItem
+local unitUnequipItemFromSlot = UnitUnequipItemFromSlot
+local ____rawget = _G.rawget
+local rawset = _G.rawset
+local ____type = _G.type
+local EQUIPMENT_SLOT_COUNT = bj_MAX_EQUIPMENT_INVENTORY
+local handleByUnitEquipment = setmetatable({}, {__mode = "k"})
+local function unitEquipmentNext(handle, slot)
+    if slot >= EQUIPMENT_SLOT_COUNT then
+        return nil, nil
+    end
+    return slot + 1, Item:of(unitItemInEquipmentSlot(
+        handle,
+        convertLoadoutSlot(slot)
+    ))
+end
+--- A live view indexed by EquipmentSlot. Equip operations let the engine choose the slot.
+____exports.UnitEquipment = __TS__Class()
+local UnitEquipment = ____exports.UnitEquipment
+UnitEquipment.name = "UnitEquipment"
+function UnitEquipment.prototype.____constructor(self, handle)
+    handleByUnitEquipment[self] = handle
+end
+function UnitEquipment.prototype.equip(self, item)
+    return unitEquipItem(handleByUnitEquipment[self], item.handle)
+end
+function UnitEquipment.prototype.unequip(self, item)
+    unitUnequipItem(handleByUnitEquipment[self], item.handle)
+end
+function UnitEquipment.prototype.unequipSlot(self, slot)
+    return Item:of(unitUnequipItemFromSlot(
+        handleByUnitEquipment[self],
+        convertLoadoutSlot(slot)
+    ))
+end
+function UnitEquipment.prototype.has(self, item)
+    return unitHasItemEquipped(handleByUnitEquipment[self], item.handle)
+end
+function UnitEquipment.prototype.hasAny(self)
+    return unitHasAnyItemEquiped(handleByUnitEquipment[self])
+end
+function UnitEquipment.prototype.isSlotEmpty(self, slot)
+    return unitHasLoadoutSlotEmpty(
+        handleByUnitEquipment[self],
+        convertLoadoutSlot(slot)
+    )
+end
+function UnitEquipment.prototype.hasType(self, ____type)
+    return unitHasItemEquipmentOfType(
+        handleByUnitEquipment[self],
+        convertEquipmentType(____type)
+    )
+end
+function UnitEquipment.prototype.canEquipType(self, ____type)
+    return unitCanEquipItemOfEquipmentType(
+        handleByUnitEquipment[self],
+        convertEquipmentType(____type)
+    )
+end
+function UnitEquipment.prototype.findSlot(self, item)
+    local handle = handleByUnitEquipment[self]
+    for slot = 0, EQUIPMENT_SLOT_COUNT - 1 do
+        if unitItemInEquipmentSlot(
+            handle,
+            convertLoadoutSlot(slot)
+        ) == item.handle then
+            return slot
+        end
+    end
+    return nil
+end
+function UnitEquipment.prototype.__index(self, key)
+    if ____type(key) == "number" then
+        return Item:of(unitItemInEquipmentSlot(
+            handleByUnitEquipment[self],
+            convertLoadoutSlot(key - 1)
+        ))
+    end
+    return ____rawget(____exports.UnitEquipment.prototype, key)
+end
+function UnitEquipment.prototype.__len(self)
+    return EQUIPMENT_SLOT_COUNT
+end
+function UnitEquipment.prototype.__ipairs(self)
+    return unitEquipmentNext, handleByUnitEquipment[self], 0
+end
+__TS__ObjectDefineProperty(
+    Unit.prototype,
+    "equipment",
+    {get = function(self)
+        local equipment = __TS__New(____exports.UnitEquipment, self.handle)
+        rawset(self, "equipment", equipment)
+        return equipment
+    end}
+)
+rawset(
+    Unit,
+    "itemEquippedEvent",
+    __TS__New(
+        UnitTriggerEvent,
+        EVENT_PLAYER_UNIT_EQUIP_ITEM,
+        function()
+            local unit = getTriggerUnit()
+            local item = getEquippedItem()
+            if getUnitTypeId(unit) ~= dummyUnitId and not (ignoreEventsItems[item] ~= nil) then
+                return Unit:of(unit), Item:of(item)
+            end
+            return IgnoreEvent
+        end
+    )
+)
+rawset(
+    Unit,
+    "itemUnequippedEvent",
+    __TS__New(
+        UnitTriggerEvent,
+        EVENT_PLAYER_UNIT_UNEQUIP_ITEM,
+        function()
+            local unit = getTriggerUnit()
+            local item = getUnequippedItem()
+            if getUnitTypeId(unit) ~= dummyUnitId and not (ignoreEventsItems[item] ~= nil) then
+                return Unit:of(unit), Item:of(item)
+            end
+            return IgnoreEvent
+        end
+    )
+)
+rawset(
+    Unit,
+    "itemStackedEvent",
+    __TS__New(
+        UnitTriggerEvent,
+        EVENT_PLAYER_UNIT_STACK_ITEM,
+        function() return Unit:of(getTriggerUnit()), Item:of(getStackingItemTarget()), Item:of(getStackingItemSource()), getStackingItemTargetPreviousCharges() end
+    )
+)
+return ____exports

package/engine/internal/unit/fly-height.d.ts

@@ -0,0 +1,7 @@
+/** @noSelfInFile */
+declare module "../unit" {
+    interface Unit {
+        flyHeight: number;
+    }
+}
+export {};

package/engine/internal/unit/fly-height.lua

@@ -0,0 +1,20 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ObjectDefineProperty = ____lualib.__TS__ObjectDefineProperty
+local ____exports = {}
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local ____unit = require("engine.standard.fields.unit")
+local FLY_HEIGHT_UNIT_FIELD = ____unit.FLY_HEIGHT_UNIT_FIELD
+__TS__ObjectDefineProperty(
+    Unit.prototype,
+    "flyHeight",
+    {
+        get = function(self)
+            return FLY_HEIGHT_UNIT_FIELD:getValue(self)
+        end,
+        set = function(self, value)
+            FLY_HEIGHT_UNIT_FIELD:setValue(self, value)
+        end
+    }
+)
+return ____exports

package/engine/internal/unit/interrupts.d.ts

@@ -0,0 +1,12 @@
+/** @noSelfInFile */
+declare module "../unit" {
+    interface Unit {
+        interruptAttack(this: Unit): void;
+    }
+}
+declare module "../unit" {
+    interface Unit {
+        interruptMovement(this: Unit): void;
+    }
+}
+export {};

package/engine/internal/unit/interrupts.lua

@@ -0,0 +1,28 @@
+local ____exports = {}
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local ____unit_2Dmissile_2Dlaunch = require("engine.internal.unit-missile-launch")
+local resetAutoAttackTimer = ____unit_2Dmissile_2Dlaunch.resetAutoAttackTimer
+local unitDisableAbility = BlzUnitDisableAbility
+local unitInterruptAttack = BlzUnitInterruptAttack
+Unit.prototype.interruptAttack = function(self)
+    unitInterruptAttack(self.handle)
+    resetAutoAttackTimer(self)
+end
+Unit.prototype.interruptMovement = function(self)
+    local handle = self.handle
+    unitDisableAbility(
+        handle,
+        fourCC("Amov"),
+        true,
+        false
+    )
+    unitDisableAbility(
+        handle,
+        fourCC("Amov"),
+        false,
+        false
+    )
+    resetAutoAttackTimer(self)
+end
+return ____exports

package/engine/internal/unit/{item.d.ts → inventory.d.ts}

@@ -1,6 +1,6 @@
 /** @noSelfInFile */
 import { Item } from "../item";
-export interface UnitItems extends ReadonlyArray<Item | undefined> {
+export interface UnitInventory extends ReadonlyArray<Item | undefined> {
     readonly length: 0 | 1 | 2 | 3 | 4 | 5 | 6;
     [0]: Item | undefined;
     [1]: Item | undefined;
@@ -9,7 +9,7 @@ export interface UnitItems extends ReadonlyArray<Item | undefined> {
     [4]: Item | undefined;
     [5]: Item | undefined;
 }
-export declare class UnitItems {
+export declare class UnitInventory {
     constructor(handle: junit);
     findSlot(item: Item): 0 | 1 | 2 | 3 | 4 | 5 | undefined;
     protected __newindex(slot: number, item: Item | undefined): void;
@@ -19,6 +19,6 @@ export declare class UnitItems {
 }
 declare module "../unit" {
     interface Unit {
-        readonly items: UnitItems;
+        readonly inventory: UnitInventory;
     }
 }

package/engine/internal/unit/{item.lua → inventory.lua}

@@ -18,25 +18,24 @@ local setItemBooleanField = BlzSetItemBooleanField
 local unitInventorySize = UnitInventorySize
 local unitItemInSlot = UnitItemInSlot
 local unitRemoveItemFromSlot = UnitRemoveItemFromSlot
-local handleByUnitItems = setmetatable({}, {__mode = "k"})
-local function unitItemsNext(handle, index)
-    local slot = index & 7
-    if index >> 3 == slot then
+local handleByUnitInventory = setmetatable({}, {__mode = "k"})
+local function unitInventoryNext(handle, slot)
+    if slot >= unitInventorySize(handle) then
         return nil, nil
     end
-    return index + 1, Item:of(unitItemInSlot(handle, slot))
+    return slot + 1, Item:of(unitItemInSlot(handle, slot))
 end
-____exports.UnitItems = __TS__Class()
-local UnitItems = ____exports.UnitItems
-UnitItems.name = "UnitItems"
-function UnitItems.prototype.____constructor(self, handle)
-    handleByUnitItems[self] = handle
+____exports.UnitInventory = __TS__Class()
+local UnitInventory = ____exports.UnitInventory
+UnitInventory.name = "UnitInventory"
+function UnitInventory.prototype.____constructor(self, handle)
+    handleByUnitInventory[self] = handle
 end
-function UnitItems.prototype.findSlot(self, item)
-    return findUnitItemSlot(handleByUnitItems[self], item.handle)
+function UnitInventory.prototype.findSlot(self, item)
+    return findUnitItemSlot(handleByUnitInventory[self], item.handle)
 end
-function UnitItems.prototype.__newindex(self, slot, item)
-    local handle = handleByUnitItems[self]
+function UnitInventory.prototype.__newindex(self, slot, item)
+    local handle = handleByUnitInventory[self]
     if slot < 1 or slot > unitInventorySize(handle) then
         return
     end
@@ -53,26 +52,26 @@ function UnitItems.prototype.__newindex(self, slot, item)
         end
     end
 end
-function UnitItems.prototype.__index(self, key)
+function UnitInventory.prototype.__index(self, key)
     if ____type(key) == "number" then
-        return Item:of(unitItemInSlot(handleByUnitItems[self], key - 1))
+        return Item:of(unitItemInSlot(handleByUnitInventory[self], key - 1))
     end
-    return rawget(____exports.UnitItems.prototype, key)
+    return rawget(____exports.UnitInventory.prototype, key)
 end
-function UnitItems.prototype.__len(self)
-    return unitInventorySize(handleByUnitItems[self])
+function UnitInventory.prototype.__len(self)
+    return unitInventorySize(handleByUnitInventory[self])
 end
-function UnitItems.prototype.__ipairs(self)
-    local handle = handleByUnitItems[self]
-    return unitItemsNext, handle, unitInventorySize(handle) << 3
+function UnitInventory.prototype.__ipairs(self)
+    local handle = handleByUnitInventory[self]
+    return unitInventoryNext, handle, 0
 end
 __TS__ObjectDefineProperty(
     Unit.prototype,
-    "items",
+    "inventory",
     {get = function(self)
-        local items = __TS__New(____exports.UnitItems, self.handle)
-        rawset(self, "items", items)
-        return items
+        local inventory = __TS__New(____exports.UnitInventory, self.handle)
+        rawset(self, "inventory", inventory)
+        return inventory
     end}
 )
 return ____exports

package/engine/internal/unit/main-selected.lua

@@ -1,46 +1,31 @@
 local ____lualib = require("lualib_bundle")
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local ____player = require("core.types.player")
-local Player = ____player.Player
-local ____math = require("math")
-local MAXIMUM_INTEGER = ____math.MAXIMUM_INTEGER
-local MINIMUM_INTEGER = ____math.MINIMUM_INTEGER
 local ____local_2Dclient = require("engine.local-client")
 local LocalClient = ____local_2Dclient.LocalClient
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
 local ____event = require("event")
 local Event = ____event.Event
+local ____synchronization = require("engine.synchronization")
+local ObjectBus = ____synchronization.ObjectBus
 local mainSelectedUnitChangeEvent = __TS__New(Event)
 rawset(Unit, "mainSelectedUnitChangeEvent", mainSelectedUnitChangeEvent)
 local mainSelectedUnitByPlayer = {}
-local syncSlider = BlzCreateFrameByType(
-    "SLIDER",
-    "UnitSyncId",
-    BlzGetOriginFrame(ORIGIN_FRAME_WORLD_FRAME, 0),
-    "",
-    0
+local unitBus = __TS__New(
+    ObjectBus,
+    function(unit) return unit.syncId end,
+    function(syncId) return Unit:getBySyncId(syncId) end
 )
-BlzFrameSetMinMaxValue(syncSlider, MINIMUM_INTEGER, MAXIMUM_INTEGER)
 LocalClient.mainSelectedUnitChangeEvent:addListener(function()
-    local ____opt_0 = LocalClient.mainSelectedUnit
-    local syncId = ____opt_0 and ____opt_0.syncId
-    BlzFrameSetValue(syncSlider, syncId or 0)
+    unitBus:send(LocalClient.mainSelectedUnit)
 end)
-local trg = CreateTrigger()
-BlzTriggerRegisterFrameEvent(trg, syncSlider, FRAMEEVENT_SLIDER_VALUE_CHANGED)
-TriggerAddAction(
-    trg,
-    function()
-        local player = Player:of(GetTriggerPlayer())
-        local mainSelectedUnit = Unit:getBySyncId(BlzGetTriggerFrameValue())
-        if mainSelectedUnit ~= mainSelectedUnitByPlayer[player] then
-            mainSelectedUnitByPlayer[player] = mainSelectedUnit
-            Event.invoke(mainSelectedUnitChangeEvent, player)
-        end
+unitBus.event:addListener(function(player, unit)
+    if unit ~= mainSelectedUnitByPlayer[player] then
+        mainSelectedUnitByPlayer[player] = unit
+        Event.invoke(mainSelectedUnitChangeEvent, player)
     end
-)
+end)
 rawset(
     Unit,
     "getMainSelectedOf",

package/engine/internal/unit/pseudo-passive-abilities.d.ts

@@ -0,0 +1,2 @@
+/** @noSelfInFile */
+export {};

package/engine/internal/unit/pseudo-passive-abilities.lua

@@ -0,0 +1,11 @@
+local ____exports = {}
+---
+-- @internal For use by internal systems only.
+____exports.compiletimePseudoPassiveAbilityTypeIds = {}
+---
+-- @internal For use by internal systems only.
+____exports.pseudoPassiveAbilityTypeIds = postcompile(function() return ____exports.compiletimePseudoPassiveAbilityTypeIds end)
+---
+-- @internal For use by internal systems only.
+____exports.pseudoPassiveAbilityOrderTypeStringId = "channel"
+return ____exports

package/engine/internal/unit/range-event.d.ts

@@ -0,0 +1,12 @@
+/** @noSelfInFile */
+import { Event } from "../../../event";
+declare module "../unit" {
+    interface Unit {
+        readonly unitInRangeEvent: Record<number, Event<[unit: Unit, range: number, unitInRange: Unit]>>;
+    }
+}
+declare module "../unit" {
+    interface Unit {
+        readonly unitOutOfRangeEvent: Record<number, Event<[unit: Unit, range: number, unitOutOfRange: Unit]>>;
+    }
+}

package/engine/internal/unit/range-event.lua

@@ -0,0 +1,90 @@
+local ____lualib = require("lualib_bundle")
+local __TS__New = ____lualib.__TS__New
+local __TS__ObjectDefineProperty = ____lualib.__TS__ObjectDefineProperty
+local ____exports = {}
+local ____event = require("event")
+local Event = ____event.Event
+local InitializingEvent = ____event.InitializingEvent
+local TriggerEvent = ____event.TriggerEvent
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local ____timer = require("core.types.timer")
+local Timer = ____timer.Timer
+local ____attributes = require("attributes")
+local attribute = ____attributes.attribute
+local ____linked_2Dmap = require("utility.linked-map")
+local mutableLinkedMap = ____linked_2Dmap.mutableLinkedMap
+local ____linked_2Dset = require("utility.linked-set")
+local LinkedSet = ____linked_2Dset.LinkedSet
+local mutableLinkedSet = ____linked_2Dset.mutableLinkedSet
+local getTriggerUnit = GetTriggerUnit
+local triggerRegisterUnitInRange = TriggerRegisterUnitInRange
+local eventInvoke = Event.invoke
+__TS__ObjectDefineProperty(
+    Unit.prototype,
+    "unitInRangeEvent",
+    {get = function(self)
+        local unit = self
+        local handle = self.handle
+        local unitInRangeEvent = setmetatable(
+            {},
+            {__index = function(self, value)
+                local event = __TS__New(
+                    TriggerEvent,
+                    function(trigger)
+                        triggerRegisterUnitInRange(trigger, handle, value, nil)
+                    end,
+                    function() return unit, value, Unit:of(getTriggerUnit()) end
+                )
+                rawset(self, value, event)
+                return event
+            end}
+        )
+        rawset(self, "unitInRangeEvent", unitInRangeEvent)
+        return unitInRangeEvent
+    end}
+)
+local units = __TS__New(LinkedSet)
+local unitsInRangeByRangeAttribute = attribute()
+local function registerUnitOfRangeEvent(unit, range, unitInRange)
+    units:add(unit)
+    unit:getOrPut(unitsInRangeByRangeAttribute, mutableLinkedMap):getOrPut(range, mutableLinkedSet):add(unitInRange)
+end
+__TS__ObjectDefineProperty(
+    Unit.prototype,
+    "unitOutOfRangeEvent",
+    {get = function(self)
+        local unit = self
+        local unitOutOfRangeEvent = setmetatable(
+            {},
+            {__index = function(self, value)
+                local event = __TS__New(
+                    InitializingEvent,
+                    function()
+                        unit.unitInRangeEvent[value]:addListener(999999, registerUnitOfRangeEvent)
+                    end
+                )
+                rawset(self, value, event)
+                return event
+            end}
+        )
+        rawset(self, "unitOutOfRangeEvent", unitOutOfRangeEvent)
+        return unitOutOfRangeEvent
+    end}
+)
+Timer.onPeriod[1]:addListener(function()
+    for unit in pairs(units) do
+        local unitsInRangeByRange = unit[unitsInRangeByRangeAttribute]
+        if unitsInRangeByRange ~= nil then
+            for range, unitsInRange in pairs(unitsInRangeByRange) do
+                for unitInRange in pairs(unitsInRange) do
+                    if unit:getDistanceTo(unitInRange) > range then
+                        unitsInRange:remove(unitInRange)
+                        eventInvoke(unit.unitOutOfRangeEvent[range], unit, range, unitInRange)
+                    end
+                end
+            end
+        end
+    end
+end)
+return ____exports

package/engine/internal/unit/scale.d.ts

@@ -0,0 +1,7 @@
+/** @noSelfInFile */
+declare module "../unit" {
+    interface Unit {
+        scale: number;
+    }
+}
+export {};

package/engine/internal/unit/scale.lua

@@ -0,0 +1,20 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ObjectDefineProperty = ____lualib.__TS__ObjectDefineProperty
+local ____exports = {}
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local ____unit = require("engine.standard.fields.unit")
+local SCALING_VALUE_UNIT_FIELD = ____unit.SCALING_VALUE_UNIT_FIELD
+__TS__ObjectDefineProperty(
+    Unit.prototype,
+    "scale",
+    {
+        get = function(self)
+            return SCALING_VALUE_UNIT_FIELD:getValue(self)
+        end,
+        set = function(self, value)
+            SCALING_VALUE_UNIT_FIELD:setValue(self, value)
+        end
+    }
+)
+return ____exports

package/engine/internal/unit+ability.lua

@@ -7,8 +7,8 @@ local UnitAbility = ____ability.UnitAbility
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
 local ____event = require("event")
-local Event = ____event.Event
 local createDispatchingEvent = ____event.createDispatchingEvent
+local Event = ____event.Event
 local abilityGainedEvent = createDispatchingEvent(
     __TS__New(Event),
     function(unit, ability) return ability.typeId end
@@ -40,6 +40,15 @@ ItemAbility.onCreate:addListener(
         end
     end
 )
+ItemAbility.destroyEvent:addListener(
+    4,
+    function(ability)
+        local unit = ability.owner.owner
+        if unit ~= nil then
+            Event.invoke(abilityLostEvent, unit, ability)
+        end
+    end
+)
 Unit.itemPickedUpEvent:addListener(
     0,
     function(unit, item)

package/engine/internal/unit+bonus.lua

@@ -3,9 +3,9 @@ local __TS__ObjectDefineProperty = ____lualib.__TS__ObjectDefineProperty
 local ____exports = {}
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
-local ____armor_2Dincrease = require("engine.internal.object-data.armor-increase")
-local ARMOR_BONUS_DUMMY_ABILITY_FIELD = ____armor_2Dincrease.ARMOR_BONUS_DUMMY_ABILITY_FIELD
-local ARMOR_BONUS_DUMMY_ABILITY_TYPE_ID = ____armor_2Dincrease.ARMOR_BONUS_DUMMY_ABILITY_TYPE_ID
+local ____armor_2Dbonus = require("engine.internal.object-data.armor-bonus")
+local ARMOR_BONUS_DUMMY_ABILITY_FIELD = ____armor_2Dbonus.ARMOR_BONUS_DUMMY_ABILITY_FIELD
+local ARMOR_BONUS_DUMMY_ABILITY_TYPE_ID = ____armor_2Dbonus.ARMOR_BONUS_DUMMY_ABILITY_TYPE_ID
 local getUnitAbility = BlzGetUnitAbility
 local setAbilityRealLevelField = BlzSetAbilityRealLevelField
 local unitAddAbility = UnitAddAbility

package/engine/internal/unit+damage.d.ts

@@ -1,6 +1,8 @@
 /** @noSelfInFile */
+import "./unit/allowed-targets";
 import { Widget } from "../../core/types/widget";
 import { AttackType } from "../object-data/auxiliary/attack-type";
+import { CombatClassifications } from "../object-data/auxiliary/combat-classification";
 export type DamageType = jdamagetype;
 export declare namespace DamageType {
     const UNKNOWN: jdamagetype;
@@ -56,5 +58,12 @@ export declare namespace WeaponType {
 declare module "./unit" {
     interface Unit {
         damageTarget(target: Widget, amount: number, attack?: boolean, ranged?: boolean, attackType?: AttackType, damageType?: DamageType, weaponType?: WeaponType, metadata?: unknown): boolean;
+        /**
+         * Deals amount to each allowed unit in collision range of (x, y).
+         * A positive maximumDamage caps the total requested damage, shared equally
+         * between the targets. Zero or omitted means unlimited; damage mitigation
+         * and damage-event modifiers are applied afterward by damageTarget.
+         */
+        damageArea(x: number, y: number, range: number, allowedTargetCombatClassifications: CombatClassifications, amount: number, maximumDamage?: number, attack?: boolean, ranged?: boolean, attackType?: AttackType, damageType?: DamageType, weaponType?: WeaponType, metadata?: unknown): void;
     }
 }

package/engine/internal/unit+damage.lua

@@ -3,6 +3,7 @@ local __TS__InstanceOf = ____lualib.__TS__InstanceOf
 local ____exports = {}
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+require("engine.internal.unit.allowed-targets")
 local ____player = require("core.types.player")
 local Player = ____player.Player
 local ____dummy = require("objutil.dummy")
@@ -11,6 +12,8 @@ local ____attack_2Dtype = require("engine.object-data.auxiliary.attack-type")
 local attackTypeToNative = ____attack_2Dtype.attackTypeToNative
 local ____damage_2Dmetadata_2Dby_2Dtarget = require("engine.internal.misc.damage-metadata-by-target")
 local damageMetadataByTarget = ____damage_2Dmetadata_2Dby_2Dtarget.damageMetadataByTarget
+local ____math = require("math")
+local min = ____math.min
 local createUnit = CreateUnit
 local getOwningPlayer = GetOwningPlayer
 local showUnit = ShowUnit
@@ -116,4 +119,34 @@ Unit.prototype.damageTarget = function(self, target, amount, attack, ranged, att
         weaponType
     )
 end
+Unit.prototype.damageArea = function(self, x, y, range, allowedTargetCombatClassifications, amount, maximumDamage, attack, ranged, attackType, damageType, weaponType, metadata)
+    if maximumDamage == nil then
+        maximumDamage = 0
+    end
+    local targets = Unit.getAllowedTargetsInCollisionRange(
+        self,
+        allowedTargetCombatClassifications,
+        x,
+        y,
+        range
+    )
+    if #targets == 0 then
+        return
+    end
+    if maximumDamage > 0 then
+        amount = min(amount, maximumDamage / #targets)
+    end
+    for ____, target in ipairs(targets) do
+        self:damageTarget(
+            target,
+            amount,
+            attack,
+            ranged,
+            attackType,
+            damageType,
+            weaponType,
+            metadata
+        )
+    end
+end
 return ____exports