warscript 0.0.1-dev.ea69747 → 0.0.1-dev.ee2345e

package/attributes.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="@typescript-to-lua/language-extensions" />
+/** @noSelfInFile */
+export type Attribute<T> = {
+    readonly __attribute: unique symbol;
+    readonly __type: T;
+} & symbol;
+export declare namespace Attribute {
+    const create: <T>() => Attribute<T>;
+}
+export declare class AttributesHolder {
+    readonly get: (<T>(attribute: Attribute<T>) => T | undefined) & LuaExtension<"TableGetMethod">;
+    readonly set: (<T>(attribute: Attribute<T>, value: T | undefined) => void) & LuaExtension<"TableSetMethod">;
+}

package/attributes.lua

@@ -0,0 +1,16 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local ____exports = {}
+____exports.Attribute = {}
+local Attribute = ____exports.Attribute
+do
+    Attribute.create = function()
+        return {}
+    end
+end
+____exports.AttributesHolder = __TS__Class()
+local AttributesHolder = ____exports.AttributesHolder
+AttributesHolder.name = "AttributesHolder"
+function AttributesHolder.prototype.____constructor(self)
+end
+return ____exports

package/core/types/handle.d.ts

@@ -1,5 +1,6 @@
 /** @noSelfInFile */
 import { Event } from "../../event";
+import { AttributesHolder } from "../../attributes";
 export type HandleConstructor<H extends jhandle, T extends Handle<H>, Args extends any[]> = new (handle: H, ...args: Args) => T;
 export type HandleDestructor = {
     readonly __handleDestructor: unique symbol;
@@ -11,7 +12,7 @@ type NoOverride = {
 declare const enum HandlePropertyKey {
     STATE = 0
 }
-export declare class Handle<H extends jhandle, DestroyParameters extends any[] = []> implements Destroyable {
+export declare class Handle<H extends jhandle, DestroyParameters extends any[] = []> extends AttributesHolder implements Destroyable {
     readonly handle: H;
     private [HandlePropertyKey.STATE]?;
     private onDestroyEvent?;

package/core/types/handle.lua

@@ -1,5 +1,6 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local __TS__New = ____lualib.__TS__New
 local __TS__Delete = ____lualib.__TS__Delete
 local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
@@ -12,13 +13,17 @@ local getClass = ____reflection.getClass
 local getSuperclass = ____reflection.getSuperclass
 local ____exception = require("exception")
 local IllegalStateException = ____exception.IllegalStateException
+local ____attributes = require("attributes")
+local AttributesHolder = ____attributes.AttributesHolder
 local getHandleId = GetHandleId
 local onCreateEventByHandleConstructor = {}
 local onDestroyEventByHandleConstructor = {}
 ____exports.Handle = __TS__Class()
 local Handle = ____exports.Handle
 Handle.name = "Handle"
+__TS__ClassExtends(Handle, AttributesHolder)
 function Handle.prototype.____constructor(self, handle)
+    AttributesHolder.prototype.____constructor(self)
     self[0] = 0
     local id = getHandleId(handle)
     local clazz = self.constructor

package/engine/behaviour/ability/apply-unit-behavior.d.ts

@@ -1,12 +1,16 @@
 /** @noSelfInFile */
 import { AbilityBehavior } from "../ability";
 import { Ability } from "../../internal/ability";
-import { UnitBehaviorConstructor } from "../unit";
+import { UnitBehavior } from "../unit";
 import { Unit } from "../../internal/unit";
-export declare class ApplyUnitBehaviorAbilityBehavior<Args extends any[]> extends AbilityBehavior {
-    private readonly createUnitBehavior;
+import { AbilityDependentValue } from "../../object-field/ability";
+export declare class ApplyUnitBehaviorAbilityBehavior<T extends UnitBehavior> extends AbilityBehavior {
+    private readonly unitBehaviorConstructor;
+    private readonly parameters?;
+    private readonly keys?;
     private unitBehavior?;
-    constructor(ability: Ability, unitBehaviorConstructor: UnitBehaviorConstructor<Args>, ...args: Args);
+    constructor(ability: Ability, unitBehaviorConstructor: new (unit: Unit) => T, parameters?: Partial<{ [K in keyof T & { [P in keyof T]-?: (<T_1>() => T_1 extends { [Q in P]: T[P]; } ? 1 : 2) extends <T_2>() => T_2 extends { -readonly [Q_1 in P]: T[P]; } ? 1 : 2 ? P : never; }[keyof T] & KeysOfType<T, string | number | boolean>]: T[K] extends string | number | boolean ? AbilityDependentValue<T[K]> : never; }> | undefined);
+    update(): void;
     onUnitGainAbility(unit: Unit): void;
     onUnitLoseAbility(): void;
 }

package/engine/behaviour/ability/apply-unit-behavior.lua

@@ -1,23 +1,38 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
+local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
 local ____ability = require("engine.behaviour.ability")
 local AbilityBehavior = ____ability.AbilityBehavior
+local ____ability = require("engine.object-field.ability")
+local AbilityField = ____ability.AbilityField
+local AbilityLevelField = ____ability.AbilityLevelField
 ____exports.ApplyUnitBehaviorAbilityBehavior = __TS__Class()
 local ApplyUnitBehaviorAbilityBehavior = ____exports.ApplyUnitBehaviorAbilityBehavior
 ApplyUnitBehaviorAbilityBehavior.name = "ApplyUnitBehaviorAbilityBehavior"
 __TS__ClassExtends(ApplyUnitBehaviorAbilityBehavior, AbilityBehavior)
-function ApplyUnitBehaviorAbilityBehavior.prototype.____constructor(self, ability, unitBehaviorConstructor, ...)
-    local args = {...}
+function ApplyUnitBehaviorAbilityBehavior.prototype.____constructor(self, ability, unitBehaviorConstructor, parameters)
     AbilityBehavior.prototype.____constructor(self, ability)
-    self.createUnitBehavior = function(____, unit)
-        return __TS__New(
-            unitBehaviorConstructor,
-            unit,
-            table.unpack(args)
-        )
+    self.unitBehaviorConstructor = unitBehaviorConstructor
+    self.parameters = parameters
+    if parameters ~= nil then
+        self.keys = __TS__ArraySort(__TS__ObjectKeys(parameters))
+    end
+end
+function ApplyUnitBehaviorAbilityBehavior.prototype.update(self)
+    local unitBehavior = self.unitBehavior
+    local parameters = self.parameters
+    local keys = self.keys
+    if unitBehavior ~= nil and parameters ~= nil and keys ~= nil then
+        for ____, key in ipairs(keys) do
+            local value = parameters[key]
+            if value ~= nil then
+                unitBehavior[key] = self:resolveCurrentAbilityDependentValue(value)
+            end
+        end
     end
 end
 function ApplyUnitBehaviorAbilityBehavior.prototype.onUnitGainAbility(self, unit)
@@ -25,7 +40,8 @@ function ApplyUnitBehaviorAbilityBehavior.prototype.onUnitGainAbility(self, unit
     if ____opt_0 ~= nil then
         ____opt_0:destroy()
     end
-    self.unitBehavior = self:createUnitBehavior(unit)
+    self.unitBehavior = __TS__New(self.unitBehaviorConstructor, unit)
+    self:update()
 end
 function ApplyUnitBehaviorAbilityBehavior.prototype.onUnitLoseAbility(self)
     local ____opt_2 = self.unitBehavior
@@ -33,4 +49,10 @@ function ApplyUnitBehaviorAbilityBehavior.prototype.onUnitLoseAbility(self)
         ____opt_2:destroy()
     end
 end
+AbilityField.valueChangeEvent:addListener(function(ability)
+    ____exports.ApplyUnitBehaviorAbilityBehavior:forAll(ability, "update")
+end)
+AbilityLevelField.valueChangeEvent:addListener(function(ability)
+    ____exports.ApplyUnitBehaviorAbilityBehavior:forAll(ability, "update")
+end)
 return ____exports

package/engine/internal/ability.d.ts

@@ -12,7 +12,7 @@ interface Fields<K, V> {
 interface AbilityLevel {
     realFields: Fields<jabilityreallevelfield, number>;
 }
-type jabilityfield = jabilityintegerfield | jabilityrealfield | jabilitybooleanfield | jabilitystringfield | jabilityintegerlevelfield | jabilityreallevelfield | jabilitybooleanlevelfield | jabilitystringlevelfield;
+export type jabilityfield = jabilityintegerfield | jabilityrealfield | jabilitybooleanfield | jabilitystringfield | jabilityintegerlevelfield | jabilityreallevelfield | jabilitybooleanlevelfield | jabilitystringlevelfield;
 export declare class AbilitySnapshot {
 }
 export declare abstract class Ability extends Handle<jability> {

package/engine/internal/mechanics/ability-duration.d.ts

@@ -1,4 +1,2 @@
 /** @noSelfInFile */
-import { Ability } from "../ability";
-import { Unit } from "../unit";
-export declare const getAbilityDuration: (ability: Ability, target?: Unit) => number;
+export {};

package/engine/internal/mechanics/ability-duration.lua

@@ -4,6 +4,8 @@ local UnitClassification = ____unit.UnitClassification
 local ____ability = require("engine.standard.fields.ability")
 local DURATION_HERO_ABILITY_FLOAT_LEVEL_FIELD = ____ability.DURATION_HERO_ABILITY_FLOAT_LEVEL_FIELD
 local DURATION_NORMAL_ABILITY_FLOAT_LEVEL_FIELD = ____ability.DURATION_NORMAL_ABILITY_FLOAT_LEVEL_FIELD
+---
+-- @internal For use by internal systems only.
 ____exports.getAbilityDuration = function(ability, target)
     local level = ability.level
     return target ~= nil and target:hasClassification(UnitClassification.RESISTANT) and DURATION_HERO_ABILITY_FLOAT_LEVEL_FIELD:getValue(ability, level) or DURATION_NORMAL_ABILITY_FLOAT_LEVEL_FIELD:getValue(ability, level)

package/engine/internal/mechanics/cast-ability.d.ts

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

package/engine/internal/mechanics/cast-ability.lua

@@ -0,0 +1,86 @@
+local ____exports = {}
+local ____ability_2Dtype = require("engine.object-data.entry.ability-type")
+local AbilityType = ____ability_2Dtype.AbilityType
+local ____dummy_2Ditem = require("engine.internal.object-data.dummy-item")
+local DUMMY_ITEM_ID = ____dummy_2Ditem.DUMMY_ITEM_ID
+local ____dummy_2Dunits = require("engine.internal.misc.dummy-units")
+local INVENTORY_DUMMY_NATIVE_UNIT = ____dummy_2Dunits.INVENTORY_DUMMY_NATIVE_UNIT
+local ____preconditions = require("utility.preconditions")
+local checkNotNull = ____preconditions.checkNotNull
+local ____dummy_2Dinventory = require("engine.internal.object-data.dummy-inventory")
+local INVENTORY_ABILITY_TYPE_ID = ____dummy_2Dinventory.INVENTORY_ABILITY_TYPE_ID
+local ____arrays = require("utility.arrays")
+local map = ____arrays.map
+local toLuaSet = ____arrays.toLuaSet
+local createItem = CreateItem
+local getAbilityId = BlzGetAbilityId
+local getItemAbility = BlzGetItemAbility
+local getUnitAbilityByIndex = BlzGetUnitAbilityByIndex
+local itemAddAbility = BlzItemAddAbility
+local setItemBooleanField = BlzSetItemBooleanField
+local removeItem = RemoveItem
+local unitAddAbility = UnitAddAbility
+local unitAddItem = UnitAddItem
+local unitDropItemSlot = UnitDropItemSlot
+local unitInventorySize = UnitInventorySize
+local unitRemoveAbility = UnitRemoveAbility
+local unitRemoveItemFromSlot = UnitRemoveItemFromSlot
+local INVENTORY_ABILITY_TYPE_IDS = postcompile(function()
+    return toLuaSet(AbilityType:getAllIdsByBaseIds(map({
+        "AInv",
+        "Aihn",
+        "Aien",
+        "Aion",
+        "Aiun"
+    }, fourCC)))
+end)
+---
+-- @internal For use by internal systems only.
+____exports.castAbility = function(nativeUnit, abilityTypeId, prepareAbility, ...)
+    local nativeItem = createItem(DUMMY_ITEM_ID, 0, 0)
+    unitAddItem(INVENTORY_DUMMY_NATIVE_UNIT, nativeItem)
+    itemAddAbility(nativeItem, abilityTypeId)
+    local nativeAbility = checkNotNull(getItemAbility(nativeItem, abilityTypeId))
+    if prepareAbility ~= nil then
+        prepareAbility(nativeAbility, ...)
+    end
+    setItemBooleanField(nativeItem, ITEM_BF_ACTIVELY_USED, true)
+    setItemBooleanField(nativeItem, ITEM_BF_USE_AUTOMATICALLY_WHEN_ACQUIRED, true)
+    local success
+    if unitAddItem(nativeUnit, nativeItem) then
+        success = true
+    else
+        local latestInventoryAbilityTypeId = 0
+        local nativeItemBySlot = {}
+        local inventorySize = unitInventorySize(nativeUnit)
+        if inventorySize ~= 0 then
+            for slot = 0, inventorySize - 1 do
+                nativeItemBySlot[slot] = unitRemoveItemFromSlot(nativeUnit, slot)
+            end
+            local unitNativeAbility = getUnitAbilityByIndex(nativeUnit, 0)
+            local i = 1
+            while unitNativeAbility ~= nil do
+                local abilityTypeId = getAbilityId(unitNativeAbility)
+                if INVENTORY_ABILITY_TYPE_IDS[abilityTypeId] ~= nil then
+                    latestInventoryAbilityTypeId = abilityTypeId
+                end
+                unitNativeAbility = getUnitAbilityByIndex(nativeUnit, i)
+                i = i + 1
+            end
+            unitRemoveAbility(nativeUnit, latestInventoryAbilityTypeId)
+        end
+        unitAddAbility(nativeUnit, INVENTORY_ABILITY_TYPE_ID)
+        success = unitAddItem(nativeUnit, nativeItem)
+        unitRemoveAbility(nativeUnit, INVENTORY_ABILITY_TYPE_ID)
+        if latestInventoryAbilityTypeId ~= 0 then
+            unitAddAbility(nativeUnit, latestInventoryAbilityTypeId)
+            for slot, nativeItem in pairs(nativeItemBySlot) do
+                unitAddItem(nativeUnit, nativeItem)
+                unitDropItemSlot(nativeUnit, nativeItem, slot)
+            end
+        end
+    end
+    removeItem(nativeItem)
+    return success
+end
+return ____exports

package/engine/internal/unit/detach-missiles.d.ts

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

package/engine/internal/unit/detach-missiles.lua

@@ -0,0 +1,30 @@
+local ____exports = {}
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local ____cast_2Dability = require("engine.internal.mechanics.cast-ability")
+local castAbility = ____cast_2Dability.castAbility
+local ____blink = require("engine.object-data.entry.ability-type.blink")
+local BlinkAbilityType = ____blink.BlinkAbilityType
+local ____math = require("math")
+local MAXIMUM_INTEGER = ____math.MAXIMUM_INTEGER
+local getUnitX = GetUnitX
+local getUnitY = GetUnitY
+local setUnitX = SetUnitX
+local setUnitY = SetUnitY
+local BLINK_ABILITY_TYPE_ID = compiletime(function()
+    local abilityType = BlinkAbilityType:create()
+    abilityType.minimumRange = 0
+    abilityType.maximumRange = MAXIMUM_INTEGER
+    abilityType.manaCost = 0
+    abilityType.cooldown = 0
+    return abilityType.id
+end)
+Unit.prototype.detachMissiles = function(self)
+    local nativeUnit = self.handle
+    local x = getUnitX(nativeUnit)
+    local y = getUnitY(nativeUnit)
+    castAbility(nativeUnit, BLINK_ABILITY_TYPE_ID)
+    setUnitX(nativeUnit, x)
+    setUnitY(nativeUnit, y)
+end
+return ____exports

package/engine/object-data/entry/ability-type/blink.d.ts

@@ -0,0 +1,10 @@
+/** @noSelfInFile */
+import { AbilityType, AbilityTypeId } from "../ability-type";
+import { ObjectDataEntryLevelFieldValueSupplier } from "../../entry";
+export declare class BlinkAbilityType extends AbilityType {
+    static readonly BASE_ID: AbilityTypeId;
+    get maximumRange(): number[];
+    set maximumRange(maximumRange: ObjectDataEntryLevelFieldValueSupplier<number>);
+    get minimumRange(): number[];
+    set minimumRange(minimumRange: ObjectDataEntryLevelFieldValueSupplier<number>);
+}

package/engine/object-data/entry/ability-type/blink.lua

@@ -0,0 +1,39 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
+local ____exports = {}
+local ____ability_2Dtype = require("engine.object-data.entry.ability-type")
+local AbilityType = ____ability_2Dtype.AbilityType
+____exports.BlinkAbilityType = __TS__Class()
+local BlinkAbilityType = ____exports.BlinkAbilityType
+BlinkAbilityType.name = "BlinkAbilityType"
+__TS__ClassExtends(BlinkAbilityType, AbilityType)
+BlinkAbilityType.BASE_ID = fourCC("AEbl")
+__TS__SetDescriptor(
+    BlinkAbilityType.prototype,
+    "maximumRange",
+    {
+        get = function(self)
+            return self:getNumberLevelField("Ebl1")
+        end,
+        set = function(self, maximumRange)
+            self:setNumberLevelField("Ebl1", maximumRange)
+        end
+    },
+    true
+)
+__TS__SetDescriptor(
+    BlinkAbilityType.prototype,
+    "minimumRange",
+    {
+        get = function(self)
+            return self:getNumberLevelField("Ebl2")
+        end,
+        set = function(self, minimumRange)
+            self:setNumberLevelField("Ebl2", minimumRange)
+        end
+    },
+    true
+)
+return ____exports

package/engine/object-data/entry/ability-type/engineering-upgrade.lua

@@ -7,7 +7,7 @@ local ____exports = {}
 local ____ability_2Dtype = require("engine.object-data.entry.ability-type")
 local AbilityType = ____ability_2Dtype.AbilityType
 local ____arrays = require("utility.arrays")
-local EMPTY_ARRAY = ____arrays.EMPTY_ARRAY
+local emptyArray = ____arrays.emptyArray
 local map = ____arrays.map
 local ____buff_2Dtype = require("engine.object-data.entry.buff-type")
 local BuffType = ____buff_2Dtype.BuffType
@@ -78,7 +78,7 @@ __TS__SetDescriptor(
                         function(levelAbilityUpgrades)
                             return levelAbilityUpgrades[i + 1]
                         end
-                    ) or (abilityUpgrades[i + 1] or EMPTY_ARRAY)
+                    ) or (abilityUpgrades[i + 1] or emptyArray())
                 )
             end
         end

package/engine/object-data/entry/ability-type.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="warpack-types/warpack" />
 /** @noSelfInFile */
+import "../../internal/unit/ability";
 import { TupleOf } from "../../../utility/types";
 import { AnimationName } from "../auxiliary/animation-name";
 import { AnimationQualifier } from "../auxiliary/animation-qualifier";

package/engine/object-data/entry/ability-type.lua

@@ -6,6 +6,7 @@ local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
 local ____exports = {}
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+require("engine.internal.unit.ability")
 local ____timer = require("core.types.timer")
 local Timer = ____timer.Timer
 local ____effect = require("core.types.effect")

package/engine/object-data/entry/buff-type/applicable.lua

@@ -7,6 +7,7 @@ local __TS__SparseArrayNew = ____lualib.__TS__SparseArrayNew
 local __TS__SparseArrayPush = ____lualib.__TS__SparseArrayPush
 local __TS__SparseArraySpread = ____lualib.__TS__SparseArraySpread
 local ____exports = {}
+local preparePhysicalPositiveApplicatorAbility
 local ____ability_2Dtype = require("engine.object-data.entry.ability-type")
 local AbilityType = ____ability_2Dtype.AbilityType
 local ____cripple = require("engine.object-data.entry.ability-type.cripple")
@@ -34,20 +35,14 @@ local ____blood_2Dlust = require("engine.object-data.entry.ability-type.blood-lu
 local BloodLustAbilityType = ____blood_2Dlust.BloodLustAbilityType
 local ____berserk = require("engine.object-data.entry.ability-type.berserk")
 local BerserkAbilityType = ____berserk.BerserkAbilityType
-local ____dummy_2Ditem = require("engine.internal.object-data.dummy-item")
-local DUMMY_ITEM_ID = ____dummy_2Ditem.DUMMY_ITEM_ID
-local ____dummy_2Dinventory = require("engine.internal.object-data.dummy-inventory")
-local INVENTORY_ABILITY_TYPE_ID = ____dummy_2Dinventory.INVENTORY_ABILITY_TYPE_ID
 local ____blank = require("engine.object-data.entry.upgrade.blank")
 local BlankUpgrade = ____blank.BlankUpgrade
-local ____dummy_2Dunits = require("engine.internal.misc.dummy-units")
-local INVENTORY_DUMMY_NATIVE_UNIT = ____dummy_2Dunits.INVENTORY_DUMMY_NATIVE_UNIT
-local ____preconditions = require("utility.preconditions")
-local checkNotNull = ____preconditions.checkNotNull
 local ____unit_2Dtype = require("engine.object-data.entry.unit-type")
 local UnitType = ____unit_2Dtype.UnitType
 local ____permanent_2Dimmolation = require("engine.object-data.entry.ability-type.permanent-immolation")
 local PermanentImmolationAbilityType = ____permanent_2Dimmolation.PermanentImmolationAbilityType
+local ____cast_2Dability = require("engine.internal.mechanics.cast-ability")
+local castAbility = ____cast_2Dability.castAbility
 local createItem = CreateItem
 local getAbilityId = BlzGetAbilityId
 local getItemAbility = BlzGetItemAbility
@@ -260,75 +255,25 @@ ____exports.internalApplyBuff = function(unit, applicableBuffTypeId, polarity, r
         return unitAddAbility(unit.handle, applicatorAbilityTypeId)
     end
     if applicatorType == 852100 then
-        local success
-        local nativeUnit = unit.handle
-        local nativeItem = createItem(DUMMY_ITEM_ID, 0, 0)
-        unitAddItem(INVENTORY_DUMMY_NATIVE_UNIT, nativeItem)
-        itemAddAbility(nativeItem, applicatorAbilityTypeId)
-        local applicatorAbility = checkNotNull(getItemAbility(nativeItem, applicatorAbilityTypeId))
-        if level == nil then
-            level = 0
-            setAbilityIntegerField(applicatorAbility, ABILITY_IF_LEVELS, 1)
-        end
-        setAbilityRealLevelField(applicatorAbility, ABILITY_RLF_DURATION_NORMAL, level, duration or 0)
-        setAbilityRealLevelField(applicatorAbility, ABILITY_RLF_DURATION_HERO, level, duration or 0)
-        if movementSpeedIncreaseFactor ~= nil then
-            setAbilityRealLevelField(applicatorAbility, ABILITY_RLF_MOVEMENT_SPEED_INCREASE_BSK1, level, movementSpeedIncreaseFactor)
-        end
-        setItemBooleanField(nativeItem, ITEM_BF_ACTIVELY_USED, true)
-        setItemBooleanField(nativeItem, ITEM_BF_USE_AUTOMATICALLY_WHEN_ACQUIRED, true)
-        if level > 0 then
+        local nativePlayer = unit.owner.handle
+        if level ~= nil and level > 0 then
             local upgradeId = applicatorUpgradeIdByApplicatorAbilityTypeId[applicatorAbilityTypeId]
             if upgradeId ~= nil then
-                setPlayerTechResearched(
-                    getOwningPlayer(nativeUnit),
-                    upgradeId,
-                    level
-                )
-            end
-        end
-        if not unitAddItem(nativeUnit, nativeItem) then
-            local latestInventoryAbilityTypeId = 0
-            local nativeItemBySlot = {}
-            local inventorySize = unitInventorySize(nativeUnit)
-            if inventorySize ~= 0 then
-                for slot = 0, inventorySize - 1 do
-                    nativeItemBySlot[slot] = UnitRemoveItemFromSlot(nativeUnit, slot)
-                end
-                local unitNativeAbility = getUnitAbilityByIndex(nativeUnit, 0)
-                local i = 1
-                while unitNativeAbility ~= nil do
-                    local abilityTypeId = getAbilityId(unitNativeAbility)
-                    if INVENTORY_ABILITY_TYPE_IDS[abilityTypeId] ~= nil then
-                        latestInventoryAbilityTypeId = abilityTypeId
-                    end
-                    unitNativeAbility = getUnitAbilityByIndex(nativeUnit, i)
-                    i = i + 1
-                end
-                unitRemoveAbility(nativeUnit, latestInventoryAbilityTypeId)
+                setPlayerTechResearched(nativePlayer, upgradeId, level)
             end
-            unitAddAbility(nativeUnit, INVENTORY_ABILITY_TYPE_ID)
-            success = unitAddItem(nativeUnit, nativeItem)
-            unitRemoveAbility(nativeUnit, INVENTORY_ABILITY_TYPE_ID)
-            if latestInventoryAbilityTypeId ~= 0 then
-                unitAddAbility(nativeUnit, latestInventoryAbilityTypeId)
-                for slot, nativeItem in pairs(nativeItemBySlot) do
-                    unitAddItem(nativeUnit, nativeItem)
-                    unitDropItemSlot(nativeUnit, nativeItem, slot)
-                end
-            end
-        else
-            success = true
         end
-        removeItem(nativeItem)
-        if level ~= nil and level > 1 then
+        local success = castAbility(
+            unit.handle,
+            applicatorAbilityTypeId,
+            preparePhysicalPositiveApplicatorAbility,
+            level,
+            duration or 0,
+            movementSpeedIncreaseFactor
+        )
+        if level ~= nil and level > 0 then
             local upgradeId = applicatorUpgradeIdByApplicatorAbilityTypeId[applicatorAbilityTypeId]
             if upgradeId ~= nil then
-                setPlayerTechResearched(
-                    getOwningPlayer(nativeUnit),
-                    upgradeId,
-                    0
-                )
+                setPlayerTechResearched(nativePlayer, upgradeId, 0)
             end
         end
         return success
@@ -364,6 +309,17 @@ ____exports.internalApplyBuff = function(unit, applicableBuffTypeId, polarity, r
     end
     return success
 end
+preparePhysicalPositiveApplicatorAbility = function(ability, level, duration, movementSpeedIncreaseFactor)
+    if level == nil then
+        setAbilityIntegerField(ability, ABILITY_IF_LEVELS, 1)
+        level = 1
+    end
+    setAbilityRealLevelField(ability, ABILITY_RLF_DURATION_NORMAL, level, duration)
+    setAbilityRealLevelField(ability, ABILITY_RLF_DURATION_HERO, level, duration)
+    if movementSpeedIncreaseFactor ~= nil then
+        setAbilityRealLevelField(ability, ABILITY_RLF_MOVEMENT_SPEED_INCREASE_BSK1, level, movementSpeedIncreaseFactor)
+    end
+end
 ---
 -- @internal For use by internal systems only.
 ____exports.removeBuff = function(unit, applicableBuffTypeId)

package/engine/object-data/entry/unit-type.d.ts

@@ -13,6 +13,7 @@ import { ObjectDataEntryIdGenerator } from "../utility/object-data-entry-id-gene
 import type { AbilityTypeId } from "./ability-type";
 import type { UpgradeId } from "./upgrade";
 import { AnimationQualifier } from "../auxiliary/animation-qualifier";
+import { AttackType } from "../auxiliary/attack-type";
 export type UnitTypeId = ObjectDataEntryId & {
     readonly __unitTypeId: unique symbol;
 };
@@ -23,12 +24,16 @@ export declare class UnitTypeWeapon {
     private readonly unitType;
     private readonly index;
     private constructor();
+    get attackType(): AttackType;
+    set attackType(attackType: AttackType);
     get backSwingDuration(): number;
     set backSwingDuration(backSwingDuration: number);
     get impactDelay(): number;
     set impactDelay(impactDelay: number);
     get missileModelPath(): string;
     set missileModelPath(missileModelPath: string);
+    get range(): number;
+    set range(range: number);
     get soundType(): WeaponSoundType;
     set soundType(soundType: WeaponSoundType);
     get soundTypeSD(): WeaponSoundType;

package/engine/object-data/entry/unit-type.lua

@@ -28,21 +28,21 @@ function UnitTypeWeapon.prototype.____constructor(self, unitType, index)
 end
 __TS__SetDescriptor(
     UnitTypeWeapon.prototype,
-    "backSwingDuration",
+    "attackType",
     {
         get = function(self)
             local ____self_0 = self.unitType
-            return ____self_0.getNumberField(
+            return ____self_0.getStringField(
                 ____self_0,
-                "ubs" .. tostring(self.index)
+                ("ua" .. tostring(self.index)) .. "t"
             )
         end,
-        set = function(self, backSwingDuration)
+        set = function(self, attackType)
             local ____self_1 = self.unitType
-            ____self_1.setNumberField(
+            ____self_1.setStringField(
                 ____self_1,
-                "ubs" .. tostring(self.index),
-                backSwingDuration
+                ("ua" .. tostring(self.index)) .. "t",
+                attackType
             )
         end
     },
@@ -50,21 +50,21 @@ __TS__SetDescriptor(
 )
 __TS__SetDescriptor(
     UnitTypeWeapon.prototype,
-    "impactDelay",
+    "backSwingDuration",
     {
         get = function(self)
             local ____self_2 = self.unitType
             return ____self_2.getNumberField(
                 ____self_2,
-                "udp" .. tostring(self.index)
+                "ubs" .. tostring(self.index)
             )
         end,
-        set = function(self, impactDelay)
+        set = function(self, backSwingDuration)
             local ____self_3 = self.unitType
             ____self_3.setNumberField(
                 ____self_3,
-                "udp" .. tostring(self.index),
-                impactDelay
+                "ubs" .. tostring(self.index),
+                backSwingDuration
             )
         end
     },
@@ -72,21 +72,21 @@ __TS__SetDescriptor(
 )
 __TS__SetDescriptor(
     UnitTypeWeapon.prototype,
-    "missileModelPath",
+    "impactDelay",
     {
         get = function(self)
             local ____self_4 = self.unitType
-            return ____self_4.getStringField(
+            return ____self_4.getNumberField(
                 ____self_4,
-                ("ua" .. tostring(self.index)) .. "m"
+                "udp" .. tostring(self.index)
             )
         end,
-        set = function(self, missileModelPath)
+        set = function(self, impactDelay)
             local ____self_5 = self.unitType
-            ____self_5.setStringField(
+            ____self_5.setNumberField(
                 ____self_5,
-                ("ua" .. tostring(self.index)) .. "m",
-                missileModelPath
+                "udp" .. tostring(self.index),
+                impactDelay
             )
         end
     },
@@ -94,21 +94,21 @@ __TS__SetDescriptor(
 )
 __TS__SetDescriptor(
     UnitTypeWeapon.prototype,
-    "soundType",
+    "missileModelPath",
     {
         get = function(self)
             local ____self_6 = self.unitType
             return ____self_6.getStringField(
                 ____self_6,
-                "ucs" .. tostring(self.index)
+                ("ua" .. tostring(self.index)) .. "m"
             )
         end,
-        set = function(self, soundType)
+        set = function(self, missileModelPath)
             local ____self_7 = self.unitType
             ____self_7.setStringField(
                 ____self_7,
-                "ucs" .. tostring(self.index),
-                soundType
+                ("ua" .. tostring(self.index)) .. "m",
+                missileModelPath
             )
         end
     },
@@ -116,21 +116,21 @@ __TS__SetDescriptor(
 )
 __TS__SetDescriptor(
     UnitTypeWeapon.prototype,
-    "soundTypeSD",
+    "range",
     {
         get = function(self)
             local ____self_8 = self.unitType
-            return ____self_8.getStringField(
+            return ____self_8.getNumberField(
                 ____self_8,
-                ("ucs" .. tostring(self.index)) .. ":sd"
+                ("ua" .. tostring(self.index)) .. "r"
             )
         end,
-        set = function(self, soundTypeSD)
+        set = function(self, range)
             local ____self_9 = self.unitType
-            ____self_9.setStringField(
+            ____self_9.setNumberField(
                 ____self_9,
-                ("ucs" .. tostring(self.index)) .. ":sd",
-                soundTypeSD
+                ("ua" .. tostring(self.index)) .. "r",
+                range
             )
         end
     },
@@ -138,19 +138,63 @@ __TS__SetDescriptor(
 )
 __TS__SetDescriptor(
     UnitTypeWeapon.prototype,
-    "soundTypeHD",
+    "soundType",
     {
         get = function(self)
             local ____self_10 = self.unitType
             return ____self_10.getStringField(
                 ____self_10,
-                ("ucs" .. tostring(self.index)) .. ":hd"
+                "ucs" .. tostring(self.index)
             )
         end,
-        set = function(self, soundTypeHD)
+        set = function(self, soundType)
             local ____self_11 = self.unitType
             ____self_11.setStringField(
                 ____self_11,
+                "ucs" .. tostring(self.index),
+                soundType
+            )
+        end
+    },
+    true
+)
+__TS__SetDescriptor(
+    UnitTypeWeapon.prototype,
+    "soundTypeSD",
+    {
+        get = function(self)
+            local ____self_12 = self.unitType
+            return ____self_12.getStringField(
+                ____self_12,
+                ("ucs" .. tostring(self.index)) .. ":sd"
+            )
+        end,
+        set = function(self, soundTypeSD)
+            local ____self_13 = self.unitType
+            ____self_13.setStringField(
+                ____self_13,
+                ("ucs" .. tostring(self.index)) .. ":sd",
+                soundTypeSD
+            )
+        end
+    },
+    true
+)
+__TS__SetDescriptor(
+    UnitTypeWeapon.prototype,
+    "soundTypeHD",
+    {
+        get = function(self)
+            local ____self_14 = self.unitType
+            return ____self_14.getStringField(
+                ____self_14,
+                ("ucs" .. tostring(self.index)) .. ":hd"
+            )
+        end,
+        set = function(self, soundTypeHD)
+            local ____self_15 = self.unitType
+            ____self_15.setStringField(
+                ____self_15,
                 ("ucs" .. tostring(self.index)) .. ":hd",
                 soundTypeHD
             )
@@ -1262,11 +1306,11 @@ __TS__SetDescriptor(
 implementReadonlyNumberIndexSupplier(
     ____exports.UnitType,
     function(id)
-        local ____class_12 = __TS__Class()
-        ____class_12.name = ____class_12.name
-        __TS__ClassExtends(____class_12, ____exports.UnitType)
-        ____class_12.BASE_ID = id
-        return ____class_12
+        local ____class_16 = __TS__Class()
+        ____class_16.name = ____class_16.name
+        __TS__ClassExtends(____class_16, ____exports.UnitType)
+        ____class_16.BASE_ID = id
+        return ____class_16
     end
 )
 ____exports.HeroUnitType = __TS__Class()
@@ -1296,11 +1340,11 @@ __TS__SetDescriptor(
 implementReadonlyNumberIndexSupplier(
     ____exports.HeroUnitType,
     function(id)
-        local ____class_13 = __TS__Class()
-        ____class_13.name = ____class_13.name
-        __TS__ClassExtends(____class_13, ____exports.HeroUnitType)
-        ____class_13.BASE_ID = id
-        return ____class_13
+        local ____class_17 = __TS__Class()
+        ____class_17.name = ____class_17.name
+        __TS__ClassExtends(____class_17, ____exports.HeroUnitType)
+        ____class_17.BASE_ID = id
+        return ____class_17
     end
 )
 return ____exports

package/engine/object-field/ability.d.ts

@@ -1,14 +1,15 @@
 /** @noSelfInFile */
-import { Ability } from "../internal/ability";
+import { Ability, jabilityfield } from "../internal/ability";
 import { ObjectArrayField, ObjectField, ObjectFieldValueChangeEvent, ObjectLevelField, ObjectLevelFieldValueChangeEvent, ReadonlyObjectFieldType, ReadonlyObjectLevelFieldType } from "../object-field";
 import { AbilityType, AbilityTypeId } from "../object-data/entry/ability-type";
 import { ObjectDataEntryId } from "../object-data/entry";
 import { LightningTypeId } from "../object-data/entry/lightning-type";
 import { CombatClassifications } from "../object-data/auxiliary/combat-classification";
 import { UnitTypeId } from "../object-data/entry/unit-type";
-export declare abstract class AbilityField<ValueType extends number | string | boolean = number | string | boolean, NativeFieldType = unknown> extends ObjectField<AbilityType, Ability, ValueType, NativeFieldType> {
+export declare abstract class AbilityField<ValueType extends number | string | boolean = number | string | boolean, NativeFieldType extends jabilityfield = jabilityfield> extends ObjectField<AbilityType, Ability, ValueType, NativeFieldType> {
     protected get instanceClass(): typeof Ability;
     protected getObjectDataEntryId(instance: Ability): AbilityTypeId;
+    protected hasNativeFieldValue(instance: Ability): boolean;
     static get valueChangeEvent(): ObjectFieldValueChangeEvent<ReadonlyObjectFieldType<AbilityField>>;
 }
 export declare class AbilityBooleanField extends AbilityField<boolean, jabilitybooleanfield> {
@@ -18,7 +19,7 @@ export declare class AbilityBooleanField extends AbilityField<boolean, jabilityb
     protected setNativeFieldValue(instance: Ability, value: boolean): boolean;
     static get valueChangeEvent(): ObjectFieldValueChangeEvent<AbilityBooleanField>;
 }
-export declare abstract class AbilityNumberField<NativeFieldType = unknown> extends AbilityField<number, NativeFieldType> {
+export declare abstract class AbilityNumberField<NativeFieldType extends jabilityfield = jabilityfield> extends AbilityField<number, NativeFieldType> {
     protected get defaultValue(): number;
     static get valueChangeEvent(): ObjectFieldValueChangeEvent<AbilityNumberField>;
 }
@@ -59,10 +60,11 @@ export declare abstract class AbilityObjectDataEntryIdArrayField<T extends Objec
 }
 export declare class AbilityLightningTypeIdArrayField extends AbilityObjectDataEntryIdArrayField<LightningTypeId> {
 }
-export declare abstract class AbilityLevelField<ValueType extends number | string | boolean = number | string | boolean, InputValueType extends ValueType = never, NativeFieldType = unknown> extends ObjectLevelField<AbilityType, Ability, ValueType, InputValueType, NativeFieldType> {
+export declare abstract class AbilityLevelField<ValueType extends number | string | boolean = number | string | boolean, InputValueType extends ValueType = never, NativeFieldType extends jabilityfield = jabilityfield> extends ObjectLevelField<AbilityType, Ability, ValueType, InputValueType, NativeFieldType> {
     protected get instanceClass(): typeof Ability;
     protected getLevelCount(entry: AbilityType | Ability): number;
     protected getObjectDataEntryId(instance: Ability): AbilityTypeId;
+    protected hasNativeFieldValue(instance: Ability): boolean;
     static get valueChangeEvent(): ObjectLevelFieldValueChangeEvent<ReadonlyObjectLevelFieldType<AbilityLevelField>>;
 }
 export declare class AbilityBooleanLevelField extends AbilityLevelField<boolean, boolean, jabilityintegerlevelfield> {
@@ -72,7 +74,7 @@ export declare class AbilityBooleanLevelField extends AbilityLevelField<boolean,
     protected setNativeFieldValue(instance: Ability, level: number, value: boolean): boolean;
     static get valueChangeEvent(): ObjectLevelFieldValueChangeEvent<AbilityBooleanLevelField>;
 }
-export declare abstract class AbilityNumberLevelField<NativeFieldType = unknown> extends AbilityLevelField<number, number, NativeFieldType> {
+export declare abstract class AbilityNumberLevelField<NativeFieldType extends jabilityfield = jabilityfield> extends AbilityLevelField<number, number, NativeFieldType> {
     protected get defaultValue(): number;
     static get valueChangeEvent(): ObjectLevelFieldValueChangeEvent<AbilityNumberLevelField>;
 }

package/engine/object-field/ability.lua

@@ -27,6 +27,9 @@ __TS__ClassExtends(AbilityField, ObjectField)
 function AbilityField.prototype.getObjectDataEntryId(self, instance)
     return instance.typeId
 end
+function AbilityField.prototype.hasNativeFieldValue(self, instance)
+    return instance:hasField(self.nativeField)
+end
 __TS__SetDescriptor(
     AbilityField.prototype,
     "instanceClass",
@@ -261,6 +264,9 @@ end
 function AbilityLevelField.prototype.getObjectDataEntryId(self, instance)
     return instance.typeId
 end
+function AbilityLevelField.prototype.hasNativeFieldValue(self, instance)
+    return instance:hasField(self.nativeField)
+end
 __TS__SetDescriptor(
     AbilityLevelField.prototype,
     "instanceClass",

package/engine/object-field/unit.d.ts

@@ -9,6 +9,7 @@ export declare abstract class UnitField<ValueType extends number | string | bool
 export declare class UnitStringField extends UnitField<string, junitstringfield> {
     protected get defaultValue(): string;
     protected getNativeFieldById(id: number): junitstringfield;
+    protected hasNativeFieldValue(): boolean;
     protected getNativeFieldValue(instance: Unit): string;
     protected getObjectDataEntryId(instance: Unit): UnitTypeId;
     protected setNativeFieldValue(instance: Unit, value: string): boolean;

package/engine/object-field/unit.lua

@@ -29,6 +29,9 @@ __TS__ClassExtends(UnitStringField, ____exports.UnitField)
 function UnitStringField.prototype.getNativeFieldById(self, id)
     return ConvertUnitStringField(id)
 end
+function UnitStringField.prototype.hasNativeFieldValue(self)
+    return true
+end
 function UnitStringField.prototype.getNativeFieldValue(self, instance)
     return instance:getField(self.nativeField)
 end

package/engine/object-field.d.ts

@@ -9,7 +9,6 @@ export type ObjectFieldId = number & {
 export type ObjectFieldConstructor<T extends ObjectFieldBase<any, any, any, any>> = OmitConstructor<typeof ObjectFieldBase> & (new (id: number) => T);
 export type ObjectFieldAbstractConstructor<T extends ObjectFieldBase<any, any, any, any>> = OmitConstructor<typeof ObjectFieldBase> & (abstract new (id: number) => T);
 declare abstract class ObjectFieldBase<ObjectDataEntryType extends ObjectDataEntry, InstanceType extends AnyNotNil, ValueType, NativeFieldType> {
-    protected readonly valueByInstance: LuaMap<InstanceType, ValueType>;
     protected abstract readonly instanceClass: AbstractConstructor<InstanceType> | Function;
     supports(instance: AnyNotNil): instance is InstanceType & {
         readonly __oneSidedTypeGuard: unique symbol;
@@ -33,21 +32,23 @@ export type ObjectFieldValueChangeEvent<T extends ObjectField<any, any, any, any
     previousValue: ValueType,
     newValue: ValueType
 ]> : never;
-export type ReadonlyObjectFieldType<T extends ObjectField<any, any, any, any>> = Omit<T, "setValue" | "removeValue">;
+export type ReadonlyObjectFieldType<T extends ObjectField<any, any, any, any>> = Omit<T, "setValue" | "removeValue" | "trySetValue">;
 type ReadonlyObjectFieldConstructor<T extends ObjectField> = OmitConstructor<typeof ObjectField> & (abstract new (...args: any[]) => ReadonlyObjectFieldType<T>);
 export declare abstract class ObjectField<ObjectDataEntryType extends ObjectDataEntry = ObjectDataEntry, InstanceType extends AnyNotNil = AnyNotNil, ValueType extends number | string | boolean = number | string | boolean, NativeFieldType = unknown> extends ObjectFieldBase<ObjectDataEntryType, InstanceType, ValueType, NativeFieldType> {
     protected abstract readonly defaultValue: ValueType;
+    protected abstract hasNativeFieldValue(instance: InstanceType): boolean;
     protected abstract getNativeFieldValue(instance: InstanceType): ValueType;
     protected abstract setNativeFieldValue(instance: InstanceType, value: ValueType): boolean;
     getValue(entry: ObjectDataEntryType | InstanceType): ValueType;
     setValue(entry: ObjectDataEntryType | InstanceType, value: ValueType): boolean;
     removeValue(entry: ObjectDataEntryType): boolean;
+    trySetValue(entry: ObjectDataEntryType | InstanceType, value: unknown): boolean;
     private invokeValueChangeEvent;
     private invokeValueChangeEventRecursive;
     protected static getOrCreateValueChangeEvent<T extends ObjectField, R extends ReadonlyObjectFieldType<T>>(this: ReadonlyObjectFieldConstructor<T>): ObjectFieldValueChangeEvent<R>;
     static get valueChangeEvent(): ObjectFieldValueChangeEvent<ReadonlyObjectFieldType<ObjectField>>;
 }
-export type ReadonlyObjectLevelFieldType<T extends ObjectLevelField<any, any, any, any>> = Omit<T, "setValue">;
+export type ReadonlyObjectLevelFieldType<T extends ObjectLevelField<any, any, any, any>> = Omit<T, "setValue" | "trySetValue">;
 export type ObjectLevelFieldValueChangeEvent<T extends ObjectLevelField<any, any, any, any> | ReadonlyObjectLevelFieldType<ObjectLevelField<any, any, any, any>>> = T extends ObjectLevelField<any, infer InstanceType, infer ValueType, any, any> ? DispatchingEvent<[
     instance: InstanceType,
     field: T,
@@ -71,11 +72,13 @@ export declare abstract class ObjectArrayField<ObjectDataEntryType extends Objec
 }
 export declare abstract class ObjectLevelField<ObjectDataEntryType extends ObjectDataEntry = ObjectDataEntry, InstanceType extends AnyNotNil = AnyNotNil, ValueType extends number | string | boolean = number | string | boolean, InputValueType extends ValueType = never, NativeFieldType = unknown> extends ObjectFieldBase<ObjectDataEntryType, InstanceType, ValueType[], NativeFieldType> {
     protected abstract readonly defaultValue: ValueType;
+    protected abstract hasNativeFieldValue(instance: InstanceType): boolean;
     protected abstract getNativeFieldValue(instance: InstanceType, level: number): ValueType;
     protected abstract setNativeFieldValue(instance: InstanceType, level: number, value: ValueType): boolean;
     protected abstract getLevelCount(entry: ObjectDataEntryType | InstanceType): number;
     getValue<LevelType extends [number] | []>(entry: ObjectDataEntryType | InstanceType, ...[level]: LevelType): LevelType extends [number] ? ValueType : ValueType[];
     setValue(entry: ObjectDataEntryType | InstanceType, ...[levelOrValue, value]: [value: ObjectDataEntryLevelFieldValueSupplier<InputValueType, ValueType>] | [level: number, value: InputValueType]): boolean;
+    trySetValue(entry: ObjectDataEntryType | InstanceType, levelOrValue: number | unknown, value?: unknown): boolean;
     private invokeValueChangeEvent;
     private invokeValueChangeEventRecursive;
     protected static getOrCreateValueChangeEvent<T extends ObjectLevelField, R extends ReadonlyObjectLevelFieldType<T>>(this: ReadonlyObjectLevelFieldConstructor<T>): ObjectLevelFieldValueChangeEvent<R>;

package/engine/object-field.lua

@@ -4,6 +4,7 @@ local __TS__Class = ____lualib.__TS__Class
 local __TS__InstanceOf = ____lualib.__TS__InstanceOf
 local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__TypeOf = ____lualib.__TS__TypeOf
 local __TS__ObjectDefineProperty = ____lualib.__TS__ObjectDefineProperty
 local ____exports = {}
 local ____event = require("event")
@@ -131,13 +132,15 @@ function ObjectField.prototype.setValue(self, entry, value)
             return true
         end
     end
+    if not self:hasNativeFieldValue(entry) then
+        return false
+    end
     local previousValue = self:getNativeFieldValue(entry)
     if value ~= previousValue then
-        if self:setNativeFieldValue(entry, value) then
-            self:invokeValueChangeEvent(entry, self, previousValue, value)
-        else
+        if not self:setNativeFieldValue(entry, value) then
             return false
         end
+        self:invokeValueChangeEvent(entry, self, previousValue, value)
     end
     return true
 end
@@ -155,6 +158,12 @@ function ObjectField.prototype.removeValue(self, entry)
     end
     return false
 end
+function ObjectField.prototype.trySetValue(self, entry, value)
+    if __TS__TypeOf(value) ~= __TS__TypeOf(self.defaultValue) then
+        return false
+    end
+    return self:setValue(entry, value)
+end
 function ObjectField.prototype.invokeValueChangeEvent(self, ...)
     self:invokeValueChangeEventRecursive(
         getClass(self),
@@ -383,22 +392,39 @@ function ObjectLevelField.prototype.setValue(self, entry, levelOrValue, value)
             return true
         end
     end
+    if not self:hasNativeFieldValue(entry) then
+        return false
+    end
     local previousValue = self:getNativeFieldValue(entry, level)
     if value ~= previousValue then
-        if self:setNativeFieldValue(entry, level, value) then
-            self:invokeValueChangeEvent(
-                entry,
-                self,
-                level,
-                previousValue,
-                value
-            )
-        else
+        if not self:setNativeFieldValue(entry, level, value) then
             return false
         end
+        self:invokeValueChangeEvent(
+            entry,
+            self,
+            level,
+            previousValue,
+            value
+        )
     end
     return true
 end
+function ObjectLevelField.prototype.trySetValue(self, entry, levelOrValue, value)
+    if value ~= nil then
+        if __TS__TypeOf(value) ~= __TS__TypeOf(self.defaultValue) then
+            return false
+        end
+        if type(levelOrValue) ~= "number" then
+            return false
+        end
+        return self:setValue(entry, levelOrValue, value)
+    end
+    if __TS__TypeOf(levelOrValue) ~= __TS__TypeOf(self.defaultValue) then
+        return false
+    end
+    return self:setValue(entry, levelOrValue)
+end
 function ObjectLevelField.prototype.invokeValueChangeEvent(self, ...)
     self:invokeValueChangeEventRecursive(
         getClass(self),

package/engine/standard/entries/unit-type.d.ts

@@ -30,6 +30,9 @@ export declare const DEMON_HUNTER_DEMON_FORM_HERO_UNIT_TYPE_ID: StandardHeroUnit
 export declare const ABOMINATION_UNIT_TYPE_ID: StandardUnitTypeId;
 export declare const GHOUL_UNIT_TYPE_ID: StandardUnitTypeId;
 export declare const DEATH_KNIGHT_HERO_UNIT_TYPE_ID: StandardHeroUnitTypeId;
+export declare const ZOMBIE_UNIT_TYPE_ID: StandardUnitTypeId;
+export declare const ZOMBIE_FEMALE_UNIT_TYPE_ID: StandardUnitTypeId;
+export declare const ARTHAS_EVIL_HERO_UNIT_TYPE_ID: StandardHeroUnitTypeId;
 export declare const DIRE_MAMMOTH_UNIT_TYPE_ID: StandardUnitTypeId;
 export declare const ELDER_JUNGLE_STALKER_UNIT_TYPE_ID: StandardUnitTypeId;
 export declare const ENRAGED_ELEMENTAL_UNIT_TYPE_ID: StandardUnitTypeId;

package/engine/standard/entries/unit-type.lua

@@ -29,6 +29,9 @@ ____exports.DEMON_HUNTER_DEMON_FORM_HERO_UNIT_TYPE_ID = fourCC("Edmm")
 ____exports.ABOMINATION_UNIT_TYPE_ID = fourCC("uabo")
 ____exports.GHOUL_UNIT_TYPE_ID = fourCC("ugho")
 ____exports.DEATH_KNIGHT_HERO_UNIT_TYPE_ID = fourCC("Udea")
+____exports.ZOMBIE_UNIT_TYPE_ID = fourCC("nzom")
+____exports.ZOMBIE_FEMALE_UNIT_TYPE_ID = fourCC("nzof")
+____exports.ARTHAS_EVIL_HERO_UNIT_TYPE_ID = fourCC("Uear")
 ____exports.DIRE_MAMMOTH_UNIT_TYPE_ID = fourCC("nmdr")
 ____exports.ELDER_JUNGLE_STALKER_UNIT_TYPE_ID = fourCC("njga")
 ____exports.ENRAGED_ELEMENTAL_UNIT_TYPE_ID = fourCC("nele")

package/engine/unit.d.ts

@@ -14,6 +14,7 @@ import "./internal/unit/missile";
 import "./internal/unit-missile-launch";
 import "./internal/unit/ghost-counter";
 import "./internal/unit/invulnerability-counter";
+import "./internal/unit/detach-missiles";
 import "./internal/unit/band-aids/ancestral-spirit-cannibalize";
 export { Unit, DamagingEvent, DamageEvent } from "./internal/unit";
 export * from "./internal/unit+damage";

package/engine/unit.lua

@@ -14,6 +14,7 @@ require("engine.internal.unit.missile")
 require("engine.internal.unit-missile-launch")
 require("engine.internal.unit.ghost-counter")
 require("engine.internal.unit.invulnerability-counter")
+require("engine.internal.unit.detach-missiles")
 require("engine.internal.unit.band-aids.ancestral-spirit-cannibalize")
 do
     local ____unit = require("engine.internal.unit")

package/exception.d.ts

@@ -15,3 +15,5 @@ export declare class IllegalStateException extends Exception {
 }
 export declare class CancellationException extends Exception {
 }
+export declare class UnsupportedOperationException extends Exception {
+}

package/exception.lua

@@ -50,4 +50,8 @@ ____exports.CancellationException = __TS__Class()
 local CancellationException = ____exports.CancellationException
 CancellationException.name = "CancellationException"
 __TS__ClassExtends(CancellationException, ____exports.Exception)
+____exports.UnsupportedOperationException = __TS__Class()
+local UnsupportedOperationException = ____exports.UnsupportedOperationException
+UnsupportedOperationException.name = "UnsupportedOperationException"
+__TS__ClassExtends(UnsupportedOperationException, ____exports.Exception)
 return ____exports

package/global/vec2.lua

@@ -15,6 +15,7 @@ local abs = math.abs
 
 local location = Location and Location(0, 0)
 local moveLocation = MoveLocation
+local getLocationZ = GetLocationZ
 
 local vec2 = {}
 

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package",
     "name": "warscript",
-    "version": "0.0.1-dev.ea69747",
+    "version": "0.0.1-dev.ee2345e",
     "description": "A typescript library for Warcraft III using Warpack.",
     "keywords": [
         "warcraft",
@@ -22,7 +22,7 @@
     },
     "peerDependencies": {
         "@warscript/language-extensions": "^0.0.1",
-        "@warscript/tstl-plugin": "^0.0.1",
+        "@warscript/tstl-plugin": "^0.0.2",
         "typescript-to-lua": "^1.24.1",
         "lua-types": "^2.13.1",
         "warpack": "0.0.1-dev.5bdabe5"

package/utility/arrays.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="@typescript-to-lua/language-extensions" />
 /** @noSelfInFile */
 import { TupleOf } from "./types";
-export declare const EMPTY_ARRAY: readonly any[];
+export declare const emptyArray: <T>() => readonly T[];
 export declare const joinToString: <T>(array: readonly T[], separator: string, transform?: (element: T) => string) => string;
 export declare const arrayOfNotNull: <T>(...elements: readonly (T | null | undefined)[]) => T[];
 export declare const array: <T, N extends number>(length: N, initialize: (index: number) => T) => TupleOf<T, N>;

package/utility/arrays.lua

@@ -8,7 +8,10 @@ local mathMin = math.min
 local select = _G.select
 local tableConcat = table.concat
 local tableSort = table.sort
-____exports.EMPTY_ARRAY = {}
+local EMPTY_ARRAY = {}
+____exports.emptyArray = function()
+    return EMPTY_ARRAY
+end
 ____exports.joinToString = function(array, separator, transform)
     if transform == nil then
         transform = tostring

package/utility/linked-set.d.ts

@@ -4,10 +4,25 @@ type IteratorState<T extends AnyNotNil> = {
     t: LuaMap<T, T>;
     n?: T;
 };
-export interface LinkedSet<T> extends LuaPairsKeyIterable<T> {
-    readonly __linkedHashSet: unique symbol;
+type OneSidedTypeGuard = {
+    readonly __oneSidedTypeGuard: unique symbol;
+};
+export interface ReadonlyLinkedSet<T extends AnyNotNil> extends LuaPairsKeyIterable<T> {
+    copyOf(): LinkedSet<T>;
+    first(): T | undefined;
+    last(): T | undefined;
+    next(key: T): T | undefined;
+    previous(key: T): T | undefined;
+    contains(key: AnyNotNil): key is T & OneSidedTypeGuard;
+    size: number;
+    forEach<Args extends any[]>(action: (value: T, ...args: Args) => void, ...args: Args): void;
+    toArray(): T[];
+    sumOf(selector: ((value: T) => number) | KeysOfType<T, number>): number;
+}
+export interface LinkedSet<T extends AnyNotNil> extends LuaPairsKeyIterable<T> {
+    readonly __linkedSet: unique symbol;
 }
-export declare class LinkedSet<T extends AnyNotNil> {
+export declare class LinkedSet<T extends AnyNotNil> implements ReadonlyLinkedSet<T> {
     private n;
     private p;
     private f?;
@@ -20,9 +35,7 @@ export declare class LinkedSet<T extends AnyNotNil> {
     previous(key: T): T | undefined;
     add(key: T): boolean;
     remove(key: T): boolean;
-    contains(key: AnyNotNil): key is T & {
-        readonly __oneSidedTypeGuard: unique symbol;
-    };
+    contains(key: AnyNotNil): key is T & OneSidedTypeGuard;
     clear(): void;
     get size(): number;
     forEach<Args extends any[]>(action: (value: T, ...args: Args) => void, ...args: Args): void;
@@ -31,6 +44,7 @@ export declare class LinkedSet<T extends AnyNotNil> {
     sortBy<R>(selector: ((value: T) => R) | KeysOfType<T, R>): void;
     protected __pairs(this: LinkedSet<T>): LuaIterator<T | undefined, IteratorState<T>>;
 }
+export declare const emptyLinkedSet: <T extends AnyNotNil>() => ReadonlyLinkedSet<T>;
 export declare const linkedSetOf: <T extends AnyNotNil>(...elements: readonly T[]) => LinkedSet<T>;
 export declare const linkedSetOfNotNull: <T extends AnyNotNil>(...elements: readonly (T | null | undefined)[]) => LinkedSet<T>;
 export {};

package/utility/linked-set.lua

@@ -2,9 +2,12 @@ local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__New = ____lualib.__TS__New
 local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
 local ____arrays = require("utility.arrays")
 local sortBy = ____arrays.sortBy
+local ____exception = require("exception")
+local UnsupportedOperationException = ____exception.UnsupportedOperationException
 local function linkedSetNext(state)
     local n = state.n
     state.n = state.t[n]
@@ -161,6 +164,19 @@ __TS__SetDescriptor(
     end},
     true
 )
+local EmptyLinkedSet = __TS__Class()
+EmptyLinkedSet.name = "EmptyLinkedSet"
+__TS__ClassExtends(EmptyLinkedSet, ____exports.LinkedSet)
+function EmptyLinkedSet.prototype.add(self)
+    error(
+        __TS__New(UnsupportedOperationException),
+        0
+    )
+end
+local EMPTY_LINKED_SET = __TS__New(EmptyLinkedSet)
+____exports.emptyLinkedSet = function()
+    return EMPTY_LINKED_SET
+end
 ____exports.linkedSetOf = function(...)
     local linkedSet = __TS__New(____exports.LinkedSet)
     for i = 1, select("#", ...) do

package/utility/types.d.ts

@@ -12,14 +12,14 @@ export type ValueOf<T> = T[keyof T];
 export type EntryOf<T> = ValueOf<{
     [K in keyof T]: [K, T[K]];
 }>;
-export type MutableKeys<T extends object> = {
+export type MutableKeys<T extends object> = keyof T & {
     [P in keyof T]-?: IfEquals<{
         [Q in P]: T[P];
     }, {
         -readonly [Q in P]: T[P];
     }, P>;
 }[keyof T];
-export type ReadonlyKeys<T extends object> = {
+export type ReadonlyKeys<T extends object> = keyof T & {
     [P in keyof T]-?: IfEquals<{
         [Q in P]: T[P];
     }, {