warscript 0.0.1-dev.e1acea3 → 0.0.1-dev.e27e5b1

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

@@ -0,0 +1,18 @@
+/** @noSelfInFile */
+import { Item } from "../item";
+export interface UnitBag extends ReadonlyArray<Item | undefined> {
+}
+/** A live, zero-based view of a unit's bag. The engine does not expose bag-slot assignment. */
+export declare class UnitBag {
+    constructor(handle: junit);
+    has(item: Item): boolean;
+    findSlot(item: Item): number | undefined;
+    protected __index(key: string | number): unknown;
+    protected __len(): number;
+    protected __ipairs(): LuaIterator<LuaMultiReturn<[number, Item | undefined]>, junit>;
+}
+declare module "../unit" {
+    interface Unit {
+        readonly bag: UnitBag;
+    }
+}

package/engine/internal/unit/bag.lua

@@ -0,0 +1,63 @@
+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 ____item = require("engine.internal.item")
+local Item = ____item.Item
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local unitExtendedInventorySize = UnitExtendedInventorySize
+local unitHasItemBagged = UnitHasItemBagged
+local unitItemInBagSlot = UnitItemInBagSlot
+local ____rawget = _G.rawget
+local rawset = _G.rawset
+local ____type = _G.type
+local handleByUnitBag = setmetatable({}, {__mode = "k"})
+local function unitBagNext(handle, slot)
+    if slot >= unitExtendedInventorySize(handle) then
+        return nil, nil
+    end
+    return slot + 1, Item:of(unitItemInBagSlot(handle, slot))
+end
+--- A live, zero-based view of a unit's bag. The engine does not expose bag-slot assignment.
+____exports.UnitBag = __TS__Class()
+local UnitBag = ____exports.UnitBag
+UnitBag.name = "UnitBag"
+function UnitBag.prototype.____constructor(self, handle)
+    handleByUnitBag[self] = handle
+end
+function UnitBag.prototype.has(self, item)
+    return unitHasItemBagged(handleByUnitBag[self], item.handle)
+end
+function UnitBag.prototype.findSlot(self, item)
+    local handle = handleByUnitBag[self]
+    for slot = 0, unitExtendedInventorySize(handle) - 1 do
+        if unitItemInBagSlot(handle, slot) == item.handle then
+            return slot
+        end
+    end
+    return nil
+end
+function UnitBag.prototype.__index(self, key)
+    if ____type(key) == "number" then
+        return Item:of(unitItemInBagSlot(handleByUnitBag[self], key - 1))
+    end
+    return ____rawget(____exports.UnitBag.prototype, key)
+end
+function UnitBag.prototype.__len(self)
+    return unitExtendedInventorySize(handleByUnitBag[self])
+end
+function UnitBag.prototype.__ipairs(self)
+    return unitBagNext, handleByUnitBag[self], 0
+end
+__TS__ObjectDefineProperty(
+    Unit.prototype,
+    "bag",
+    {get = function(self)
+        local bag = __TS__New(____exports.UnitBag, self.handle)
+        rawset(self, "bag", bag)
+        return bag
+    end}
+)
+return ____exports

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

@@ -5,12 +5,16 @@ export type UnitBonusId<Brand extends string = any> = number & {
     readonly __unitBonusId: unique symbol;
     readonly __unitBonusIdBrand: Brand;
 };
+export type UnitMaxHealthBonusId = UnitBonusId<"maxHealth">;
+export type UnitMaxManaBonusId = UnitBonusId<"maxMana">;
 export type UnitArmorBonusId = UnitBonusId<"armor">;
 export type UnitAttackSpeedFactorBonusId = UnitBonusId<"attackSpeedFactor">;
 export type UnitMovementSpeedFactorBonusId = UnitBonusId<"movementSpeedFactor">;
 export type UnitAutoAttackDamageBonusId = UnitBonusId<"autoAttackDamage">;
 export type UnitDamageFactorBonusId = UnitBonusId<"damageFactor">;
 export type UnitReceivedDamageFactorBonusId = UnitBonusId<"receivedDamageFactor">;
+export type UnitEvasionProbabilityBonusId = UnitBonusId<"evasionProbability">;
+export type UnitManaRegenerationRateFactorBonusId = UnitBonusId<"manaRegenerationRateFactor">;
 export type UnitBonusType<Id extends UnitBonusId = UnitBonusId> = ({
     abilityTypeId: AbilityTypeId;
     field: jabilityintegerlevelfield;
@@ -28,12 +32,16 @@ export type UnitBonusType<Id extends UnitBonusId = UnitBonusId> = ({
     readonly __unitBonusTypeId?: Id;
 };
 export declare namespace UnitBonusType {
+    const HEALTH: UnitBonusType<UnitMaxHealthBonusId>;
+    const MANA: UnitBonusType<UnitMaxManaBonusId>;
     const ARMOR: UnitBonusType<UnitArmorBonusId>;
     const ATTACK_SPEED_FACTOR: UnitBonusType<UnitAttackSpeedFactorBonusId>;
     const MOVEMENT_SPEED_FACTOR: UnitBonusType<UnitAttackSpeedFactorBonusId>;
     const AUTO_ATTACK_DAMAGE: UnitBonusType<UnitAutoAttackDamageBonusId>;
     const DAMAGE_FACTOR: UnitBonusType<UnitReceivedDamageFactorBonusId>;
     const RECEIVED_DAMAGE_FACTOR: UnitBonusType<UnitReceivedDamageFactorBonusId>;
+    const EVASION_PROBABILITY: UnitBonusType<UnitEvasionProbabilityBonusId>;
+    const MANA_REGENERATION_RATE_FACTOR: UnitBonusType<UnitManaRegenerationRateFactorBonusId>;
 }
 export declare const addUnitBonus: <Id extends UnitBonusId>(unit: Unit, bonusType: UnitBonusType<Id>, value: number) => Id;
 export declare const removeUnitBonus: <Id extends UnitBonusId>(unit: Unit, bonusType: UnitBonusType<Id>, id: Id) => boolean;

package/engine/internal/unit/bonus.lua

@@ -1,9 +1,9 @@
 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 ____utility = require("engine.internal.utility")
 local addInternalAbility = ____utility.addInternalAbility
 local ____arrays = require("utility.arrays")
@@ -21,11 +21,44 @@ local AUTO_ATTACK_DAMAGE_INCREASE_DUMMY_ABILITY_TYPE_ID = ____auto_2Dattack_2Dda
 local ____movement_2Dspeed_2Dincrease_2Dfactor = require("engine.internal.object-data.movement-speed-increase-factor")
 local MOVEMENT_SPEED_INCREASE_FACTOR_ABILITY_FIELD = ____movement_2Dspeed_2Dincrease_2Dfactor.MOVEMENT_SPEED_INCREASE_FACTOR_ABILITY_FIELD
 local MOVEMENT_SPEED_INCREASE_FACTOR_DUMMY_ABILITY_TYPE_ID = ____movement_2Dspeed_2Dincrease_2Dfactor.MOVEMENT_SPEED_INCREASE_FACTOR_DUMMY_ABILITY_TYPE_ID
+local ____evasion_2Dprobability = require("engine.internal.object-data.evasion-probability")
+local EVASION_PROBABILITY_ABILITY_FIELD = ____evasion_2Dprobability.EVASION_PROBABILITY_ABILITY_FIELD
+local EVASION_PROBABILITY_DUMMY_ABILITY_TYPE_ID = ____evasion_2Dprobability.EVASION_PROBABILITY_DUMMY_ABILITY_TYPE_ID
+local ____health_2Dbonus = require("engine.internal.object-data.health-bonus")
+local HEALTH_BONUS_DUMMY_ABILITY_FIELD = ____health_2Dbonus.HEALTH_BONUS_DUMMY_ABILITY_FIELD
+local HEALTH_BONUS_DUMMY_ABILITY_TYPE_ID = ____health_2Dbonus.HEALTH_BONUS_DUMMY_ABILITY_TYPE_ID
+local ____mana_2Dbonus = require("engine.internal.object-data.mana-bonus")
+local MANA_BONUS_DUMMY_ABILITY_FIELD = ____mana_2Dbonus.MANA_BONUS_DUMMY_ABILITY_FIELD
+local MANA_BONUS_DUMMY_ABILITY_TYPE_ID = ____mana_2Dbonus.MANA_BONUS_DUMMY_ABILITY_TYPE_ID
+local ____mana_2Dregeneration_2Drate_2Dincrease_2Dfactor = require("engine.internal.object-data.mana-regeneration-rate-increase-factor")
+local MANA_REGENERATION_RATE_INCREASE_FACTOR_ABILITY_FIELD = ____mana_2Dregeneration_2Drate_2Dincrease_2Dfactor.MANA_REGENERATION_RATE_INCREASE_FACTOR_ABILITY_FIELD
+local MANA_REGENERATION_RATE_INCREASE_FACTOR_DUMMY_ABILITY_TYPE_ID = ____mana_2Dregeneration_2Drate_2Dincrease_2Dfactor.MANA_REGENERATION_RATE_INCREASE_FACTOR_DUMMY_ABILITY_TYPE_ID
 local damageFactorByUnit = {}
 local receivedDamageFactorByUnit = {}
+local function atLeastOnceProbability(array)
+    local oppositeEventProbability = 1
+    for i = 1, #array do
+        oppositeEventProbability = oppositeEventProbability * (1 - array[i])
+    end
+    return 1 - oppositeEventProbability
+end
 ____exports.UnitBonusType = {}
 local UnitBonusType = ____exports.UnitBonusType
 do
+    UnitBonusType.HEALTH = {
+        abilityTypeId = HEALTH_BONUS_DUMMY_ABILITY_TYPE_ID,
+        field = HEALTH_BONUS_DUMMY_ABILITY_FIELD,
+        integer = true,
+        reduce = sum,
+        initialValue = 0
+    }
+    UnitBonusType.MANA = {
+        abilityTypeId = MANA_BONUS_DUMMY_ABILITY_TYPE_ID,
+        field = MANA_BONUS_DUMMY_ABILITY_FIELD,
+        integer = true,
+        reduce = sum,
+        initialValue = 0
+    }
     UnitBonusType.ARMOR = {
         abilityTypeId = ARMOR_BONUS_DUMMY_ABILITY_TYPE_ID,
         field = ARMOR_BONUS_DUMMY_ABILITY_FIELD,
@@ -56,6 +89,20 @@ do
     }
     UnitBonusType.DAMAGE_FACTOR = {reduce = product, valueByUnit = damageFactorByUnit, initialValue = 1}
     UnitBonusType.RECEIVED_DAMAGE_FACTOR = {reduce = product, valueByUnit = receivedDamageFactorByUnit, initialValue = 1}
+    UnitBonusType.EVASION_PROBABILITY = {
+        abilityTypeId = EVASION_PROBABILITY_DUMMY_ABILITY_TYPE_ID,
+        field = EVASION_PROBABILITY_ABILITY_FIELD,
+        integer = false,
+        reduce = atLeastOnceProbability,
+        initialValue = 0
+    }
+    UnitBonusType.MANA_REGENERATION_RATE_FACTOR = {
+        abilityTypeId = MANA_REGENERATION_RATE_INCREASE_FACTOR_DUMMY_ABILITY_TYPE_ID,
+        field = MANA_REGENERATION_RATE_INCREASE_FACTOR_ABILITY_FIELD,
+        integer = false,
+        reduce = sum,
+        initialValue = 0
+    }
 end
 local bonusesByUnitByBonusType = {}
 local nextId = 1

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

@@ -32,7 +32,7 @@ declare module "../unit" {
          * @param includeAuras Whether to remove aura buffs. Default `true`.
          * @param autoDispel Unknown. Default `false`.
          */
-        removeBuffs(polarity?: BuffPolarity, resistanceType?: BuffResistanceType, includeExpirationTimers?: boolean, includeAuras?: boolean, autoDispel?: boolean): void;
-        removeBuffs(buffTypeIds: number[]): void;
+        removeBuffs(polarity?: BuffPolarity, resistanceType?: BuffResistanceType, includeExpirationTimers?: boolean, includeAuras?: boolean, autoDispel?: boolean): number;
+        removeBuffs(buffTypeIds: number[]): number;
     }
 }

package/engine/internal/unit/buff.lua

@@ -1,7 +1,3 @@
-local ____lualib = require("lualib_bundle")
-local __TS__SparseArrayNew = ____lualib.__TS__SparseArrayNew
-local __TS__SparseArrayPush = ____lualib.__TS__SparseArrayPush
-local __TS__SparseArraySpread = ____lualib.__TS__SparseArraySpread
 local ____exports = {}
 local ____buff = require("engine.buff")
 local checkBuff = ____buff.checkBuff
@@ -46,36 +42,55 @@ Unit.prototype.countBuffs = function(self, polarity, resistanceType, includeExpi
     )
 end
 Unit.prototype.removeBuffs = function(self, polarityOrBuffTypeIds, resistanceType, includeExpirationTimers, includeAuras, autoDispel)
+    local handle = self.handle
+    local cnt
     if type(polarityOrBuffTypeIds) == "table" then
-        local handle = self.handle
+        cnt = 0
         for i = 1, #polarityOrBuffTypeIds do
-            unitRemoveAbility(handle, polarityOrBuffTypeIds[i])
+            cnt = cnt + (unitRemoveAbility(handle, polarityOrBuffTypeIds[i]) and 1 or 0)
         end
     else
-        local ____array_3 = __TS__SparseArrayNew(
-            self.handle,
-            (polarityOrBuffTypeIds or 3) & 1 ~= 0,
-            (polarityOrBuffTypeIds or 3) & 2 ~= 0,
-            (resistanceType or 0) & 1 ~= 0,
-            (resistanceType or 0) & 2 ~= 0
-        )
+        local positive = (polarityOrBuffTypeIds or 3) & 1 ~= 0
+        local negative = (polarityOrBuffTypeIds or 3) & 2 ~= 0
+        local magic = (resistanceType or 0) & 1 ~= 0
+        local physical = (resistanceType or 0) & 2 ~= 0
         local ____includeExpirationTimers_0 = includeExpirationTimers
         if ____includeExpirationTimers_0 == nil then
             ____includeExpirationTimers_0 = true
         end
-        __TS__SparseArrayPush(____array_3, ____includeExpirationTimers_0)
+        includeExpirationTimers = ____includeExpirationTimers_0
         local ____includeAuras_1 = includeAuras
         if ____includeAuras_1 == nil then
             ____includeAuras_1 = true
         end
-        __TS__SparseArrayPush(____array_3, ____includeAuras_1)
+        includeAuras = ____includeAuras_1
         local ____autoDispel_2 = autoDispel
         if ____autoDispel_2 == nil then
             ____autoDispel_2 = false
         end
-        __TS__SparseArrayPush(____array_3, ____autoDispel_2)
-        unitRemoveBuffsEx(__TS__SparseArraySpread(____array_3))
+        autoDispel = ____autoDispel_2
+        cnt = unitCountBuffsEx(
+            handle,
+            positive,
+            negative,
+            magic,
+            physical,
+            includeExpirationTimers,
+            includeAuras,
+            autoDispel
+        )
+        unitRemoveBuffsEx(
+            handle,
+            positive,
+            negative,
+            magic,
+            physical,
+            includeExpirationTimers,
+            includeAuras,
+            autoDispel
+        )
     end
     checkBuffs(self)
+    return cnt
 end
 return ____exports

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

@@ -0,0 +1,36 @@
+/** @noSelfInFile */
+import { Item } from "../item";
+import { EquipmentSlot } from "../../object-data/auxiliary/equipment-slot";
+import { EquipmentType } from "../../object-data/auxiliary/equipment-type";
+export interface UnitEquipment extends ReadonlyArray<Item | undefined> {
+}
+/** A live view indexed by EquipmentSlot. Equip operations let the engine choose the slot. */
+export declare class UnitEquipment {
+    constructor(handle: junit);
+    equip(item: Item): boolean;
+    unequip(item: Item): void;
+    unequipSlot(slot: EquipmentSlot): Item | undefined;
+    has(item: Item): boolean;
+    hasAny(): boolean;
+    isSlotEmpty(slot: EquipmentSlot): boolean;
+    hasType(type: EquipmentType): boolean;
+    canEquipType(type: EquipmentType): boolean;
+    findSlot(item: Item): EquipmentSlot | undefined;
+    protected __index(key: string | number): unknown;
+    protected __len(): number;
+    protected __ipairs(): LuaIterator<LuaMultiReturn<[number, Item | undefined]>, junit>;
+}
+declare module "../unit" {
+    interface Unit {
+        readonly equipment: UnitEquipment;
+    }
+    namespace Unit {
+        const itemEquippedEvent: UnitTriggerEvent<[item: Item]>;
+        const itemUnequippedEvent: UnitTriggerEvent<[item: Item]>;
+        let itemStackedEvent: UnitTriggerEvent<[
+            target: Item,
+            source: Item,
+            previousTargetCharges: number
+        ]>;
+    }
+}

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/ignore-events-items.d.ts

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

package/engine/internal/unit/ignore-events-items.lua

@@ -0,0 +1,5 @@
+local ____exports = {}
+---
+-- @internal For use by internal systems only.
+____exports.ignoreEventsItems = {}
+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/inventory.lua

@@ -0,0 +1,77 @@
+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 ____item = require("engine.internal.item")
+local Item = ____item.Item
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local ____utility = require("engine.internal.utility")
+local findUnitItemSlot = ____utility.findUnitItemSlot
+local ____add_2Ditem_2Dto_2Dslot = require("engine.internal.unit.add-item-to-slot")
+local unitAddItemToSlot = ____add_2Ditem_2Dto_2Dslot.unitAddItemToSlot
+local rawset = _G.rawset
+local ____type = _G.type
+local isItemPowerup = IsItemPowerup
+local setItemBooleanField = BlzSetItemBooleanField
+local unitInventorySize = UnitInventorySize
+local unitItemInSlot = UnitItemInSlot
+local unitRemoveItemFromSlot = UnitRemoveItemFromSlot
+local handleByUnitInventory = setmetatable({}, {__mode = "k"})
+local function unitInventoryNext(handle, slot)
+    if slot >= unitInventorySize(handle) then
+        return nil, nil
+    end
+    return slot + 1, Item:of(unitItemInSlot(handle, slot))
+end
+____exports.UnitInventory = __TS__Class()
+local UnitInventory = ____exports.UnitInventory
+UnitInventory.name = "UnitInventory"
+function UnitInventory.prototype.____constructor(self, handle)
+    handleByUnitInventory[self] = handle
+end
+function UnitInventory.prototype.findSlot(self, item)
+    return findUnitItemSlot(handleByUnitInventory[self], item.handle)
+end
+function UnitInventory.prototype.__newindex(self, slot, item)
+    local handle = handleByUnitInventory[self]
+    if slot < 1 or slot > unitInventorySize(handle) then
+        return
+    end
+    unitRemoveItemFromSlot(handle, slot - 1)
+    if item ~= nil then
+        local itemHandle = item.handle
+        local isPowerup = isItemPowerup(itemHandle)
+        if isPowerup then
+            setItemBooleanField(itemHandle, ITEM_BF_USE_AUTOMATICALLY_WHEN_ACQUIRED, false)
+        end
+        unitAddItemToSlot(handle, itemHandle, slot - 1)
+        if isPowerup then
+            setItemBooleanField(itemHandle, ITEM_BF_USE_AUTOMATICALLY_WHEN_ACQUIRED, true)
+        end
+    end
+end
+function UnitInventory.prototype.__index(self, key)
+    if ____type(key) == "number" then
+        return Item:of(unitItemInSlot(handleByUnitInventory[self], key - 1))
+    end
+    return rawget(____exports.UnitInventory.prototype, key)
+end
+function UnitInventory.prototype.__len(self)
+    return unitInventorySize(handleByUnitInventory[self])
+end
+function UnitInventory.prototype.__ipairs(self)
+    local handle = handleByUnitInventory[self]
+    return unitInventoryNext, handle, 0
+end
+__TS__ObjectDefineProperty(
+    Unit.prototype,
+    "inventory",
+    {get = function(self)
+        local inventory = __TS__New(____exports.UnitInventory, self.handle)
+        rawset(self, "inventory", inventory)
+        return inventory
+    end}
+)
+return ____exports