warscript 0.0.1-dev.459629d → 0.0.1-dev.45a73a4

package/engine/ability-type-extended-tooltip.d.ts

@@ -0,0 +1,8 @@
+/** @noSelfInFile */
+import { AbilityTypeId } from "./object-data/entry/ability-type";
+/**
+ * The ability type's own extended tooltip for the level, unaffected by local display
+ * overrides (see {@link overrideAbilityTypeExtendedTooltipLocally}). Use it instead of
+ * `BlzGetAbilityExtendedTooltip` wherever the type's tooltip serves as a template.
+ */
+export declare const getAbilityTypeExtendedTooltip: (abilityTypeId: AbilityTypeId, level: number) => string;

package/engine/ability-type-extended-tooltip.lua

@@ -0,0 +1,44 @@
+local ____exports = {}
+local getAbilityExtendedTooltip = BlzGetAbilityExtendedTooltip
+local setAbilityExtendedTooltip = BlzSetAbilityExtendedTooltip
+local originalTooltipByLevelByAbilityTypeId = {}
+local overriddenTooltipByLevelByAbilityTypeId = {}
+--- The ability type's own extended tooltip for the level, unaffected by local display
+-- overrides (see {@link overrideAbilityTypeExtendedTooltipLocally}). Use it instead of
+-- `BlzGetAbilityExtendedTooltip` wherever the type's tooltip serves as a template.
+____exports.getAbilityTypeExtendedTooltip = function(abilityTypeId, level)
+    local ____opt_0 = originalTooltipByLevelByAbilityTypeId[abilityTypeId]
+    return ____opt_0 and ____opt_0[level] or getAbilityExtendedTooltip(abilityTypeId, level)
+end
+--- Replaces the displayed extended tooltip of every ability of the type for the local
+-- player only; `undefined` restores the type's own tooltip. The value is async: never
+-- feed it back into synchronous logic.
+-- 
+-- @internal For use by internal systems only.
+____exports.overrideAbilityTypeExtendedTooltipLocally = function(abilityTypeId, level, tooltip)
+    local overriddenTooltipByLevel = overriddenTooltipByLevelByAbilityTypeId[abilityTypeId]
+    if (overriddenTooltipByLevel and overriddenTooltipByLevel[level]) == tooltip then
+        return
+    end
+    local originalTooltipByLevel = originalTooltipByLevelByAbilityTypeId[abilityTypeId]
+    if originalTooltipByLevel == nil then
+        originalTooltipByLevel = {}
+        originalTooltipByLevelByAbilityTypeId[abilityTypeId] = originalTooltipByLevel
+    end
+    local originalTooltip = originalTooltipByLevel[level]
+    if originalTooltip == nil then
+        originalTooltip = getAbilityExtendedTooltip(abilityTypeId, level)
+        originalTooltipByLevel[level] = originalTooltip
+    end
+    if overriddenTooltipByLevel == nil then
+        overriddenTooltipByLevel = {}
+        overriddenTooltipByLevelByAbilityTypeId[abilityTypeId] = overriddenTooltipByLevel
+    end
+    if tooltip == nil then
+        overriddenTooltipByLevel[level] = nil
+    else
+        overriddenTooltipByLevel[level] = tooltip
+    end
+    setAbilityExtendedTooltip(abilityTypeId, tooltip or originalTooltip, level)
+end
+return ____exports

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

@@ -7,6 +7,8 @@ local __TS__New = ____lualib.__TS__New
 local ____exports = {}
 local ____ability = require("engine.behaviour.ability")
 local AbilityBehavior = ____ability.AbilityBehavior
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
 local ____ability = require("engine.object-field.ability")
 local AbilityField = ____ability.AbilityField
 local AbilityLevelField = ____ability.AbilityLevelField
@@ -56,4 +58,7 @@ end)
 AbilityLevelField.valueChangeEvent:addListener(function(ability)
     ____exports.ApplyUnitBehaviorAbilityBehavior:forAll(ability, "update")
 end)
+Unit.abilityLevelChangedEvent:addListener(function(_, ability)
+    ____exports.ApplyUnitBehaviorAbilityBehavior:forAll(ability, "update")
+end)
 return ____exports

package/engine/behaviour/ability/damage.d.ts

@@ -5,6 +5,7 @@ import { Unit } from "../../internal/unit";
 import { AbilityDependentValue } from "../../object-field/ability";
 import { Widget } from "../../../core/types/widget";
 import { DamageType, WeaponType } from "../../internal/unit+damage";
+import "../../internal/unit+damage";
 import { CombatClassifications } from "../../object-data/auxiliary/combat-classification";
 import { AttackType } from "../../object-data/auxiliary/attack-type";
 export type DamageAbilityBehaviorParameters = {

package/engine/behaviour/ability/damage.lua

@@ -4,11 +4,10 @@ local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
 local ____ability = require("engine.behaviour.ability")
 local AbilityBehavior = ____ability.AbilityBehavior
-local ____unit = require("engine.internal.unit")
-local Unit = ____unit.Unit
 local ____ability = require("engine.standard.fields.ability")
 local ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD = ____ability.ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD
 local AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD = ____ability.AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD
+require("engine.internal.unit+damage")
 ____exports.DamageAbilityBehavior = __TS__Class()
 local DamageAbilityBehavior = ____exports.DamageAbilityBehavior
 DamageAbilityBehavior.name = "DamageAbilityBehavior"
@@ -82,21 +81,20 @@ function DamageAreaAbilityBehavior.prototype.____constructor(self, ability, dama
 end
 function DamageAreaAbilityBehavior.prototype.damageArea(self, caster, x, y)
     local parameters = self.parameters
-    local targets = Unit.getAllowedTargetsInCollisionRange(
-        caster,
-        self:resolveCurrentAbilityDependentValue(parameters and parameters.allowedTargetCombatClassifications or ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD),
+    caster:damageArea(
         x,
         y,
-        self:resolveCurrentAbilityDependentValue(parameters and parameters.areaOfEffect or AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD)
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.areaOfEffect or AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD),
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.allowedTargetCombatClassifications or ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD),
+        self.precalculatedDamage or self:calculateDamage(caster),
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.maximumDamage or 0),
+        nil,
+        nil,
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.attackType),
+        parameters and parameters.damageType,
+        parameters and parameters.weaponType,
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.metadata)
     )
-    local damage = self.precalculatedDamage or self:calculateDamage(caster)
-    local maximumDamage = self:resolveCurrentAbilityDependentValue(parameters and parameters.maximumDamage or 0)
-    if maximumDamage ~= 0 and damage > maximumDamage then
-        damage = maximumDamage / #targets
-    end
-    for ____, target in ipairs(targets) do
-        self:damageTarget(caster, target, damage)
-    end
 end
 ____exports.DamageSelfAreaAbilityBehavior = __TS__Class()
 local DamageSelfAreaAbilityBehavior = ____exports.DamageSelfAreaAbilityBehavior

package/engine/behaviour/ability/emulate-impact.lua

@@ -31,7 +31,7 @@ function EmulateImpactAbilityBehavior.prototype.emulateImpact(self, caster)
     if cooldown == 0 then
         self.ability:interruptCast()
     else
-        self.ability.cooldownRemaining = cooldown
+        self.ability:startCooldown(cooldown)
     end
     self:flashCasterEffect(caster)
     local soundPresetId = self.ability:getField(ABILITY_SF_EFFECT_SOUND)

package/engine/behaviour/ability/on-command-impact.d.ts

@@ -1,5 +1,6 @@
 /** @noSelfInFile */
 import { Unit } from "../../internal/unit";
+import "../../internal/unit/item-order-events";
 import { EmulateImpactAbilityBehavior } from "./emulate-impact";
 import { Ability } from "../../internal/ability";
 export declare class OnCommandImpactAbilityBehavior extends EmulateImpactAbilityBehavior {

package/engine/behaviour/ability/on-command-impact.lua

@@ -4,6 +4,7 @@ local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+require("engine.internal.unit.item-order-events")
 local ____emulate_2Dimpact = require("engine.behaviour.ability.emulate-impact")
 local EmulateImpactAbilityBehavior = ____emulate_2Dimpact.EmulateImpactAbilityBehavior
 ____exports.OnCommandImpactAbilityBehavior = __TS__Class()

package/engine/behaviour/ability.d.ts

@@ -2,6 +2,7 @@
 import { Behavior } from "../behavior";
 import { Unit } from "../internal/unit";
 import "../internal/unit/ability";
+import "../internal/unit+ability";
 import { Ability } from "../internal/ability";
 import { AbilityTypeId } from "../object-data/entry/ability-type";
 import { Widget } from "../../core/types/widget";
@@ -26,6 +27,7 @@ export declare abstract class AbilityBehavior<Parameters extends {
     get unit(): Unit | undefined;
     protected resolveCurrentAbilityDependentValue<T extends boolean | number | string>(value: AbilityDependentValue<T>): T;
     protected resolveCurrentAbilityDependentValue<T extends boolean | number | string>(value?: AbilityDependentValue<T>): T | undefined;
+    protected getDuration(widget: Widget): number;
     flashCasterEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
     flashTargetEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
     flashAreaEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;

package/engine/behaviour/ability.lua

@@ -9,7 +9,9 @@ local ____behavior = require("engine.behavior")
 local Behavior = ____behavior.Behavior
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+local UnitClassification = ____unit.UnitClassification
 require("engine.internal.unit.ability")
+require("engine.internal.unit+ability")
 local ____ability = require("engine.internal.ability")
 local Ability = ____ability.Ability
 local ____effect = require("core.types.effect")
@@ -18,6 +20,8 @@ local ____ability = require("engine.standard.fields.ability")
 local AREA_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.AREA_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
 local CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD = ____ability.CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD
 local CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
+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
 local EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
 local MISSILE_ARC_ABILITY_FLOAT_FIELD = ____ability.MISSILE_ARC_ABILITY_FLOAT_FIELD
 local MISSILE_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.MISSILE_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
@@ -113,6 +117,14 @@ end
 function AbilityBehavior.prototype.resolveCurrentAbilityDependentValue(self, value)
     return resolveCurrentAbilityDependentValue(self.ability, value)
 end
+function AbilityBehavior.prototype.getDuration(self, widget)
+    if __TS__InstanceOf(widget, Unit) then
+        if widget.isHero or widget:getField(UNIT_IF_LEVEL) >= 6 or widget:hasClassification(UnitClassification.RESISTANT) then
+            return self:resolveCurrentAbilityDependentValue(DURATION_HERO_ABILITY_FLOAT_LEVEL_FIELD)
+        end
+    end
+    return self:resolveCurrentAbilityDependentValue(DURATION_NORMAL_ABILITY_FLOAT_LEVEL_FIELD)
+end
 function AbilityBehavior.prototype.flashCasterEffect(self, widget, ...)
     local attachmentPoint = CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD:getValue(self.ability)
     Effect:flash(
@@ -317,6 +329,19 @@ end)
 AbilityLevelField.valueChangeEvent:addListener(function(ability, field)
     ____exports.AbilityBehavior:forAll(ability, checkBehaviorOnValueChange, field)
 end)
+local function checkBehaviorOnLevelChange(behavior)
+    local subscribedValues = subscribedValuesByAbilityBehavior[behavior]
+    if subscribedValues ~= nil then
+        for value in pairs(subscribedValues) do
+            if __TS__InstanceOf(value, AbilityLevelField) then
+                behavior:onValueChange(value)
+            end
+        end
+    end
+end
+Unit.abilityLevelChangedEvent:addListener(function(_, ability)
+    ____exports.AbilityBehavior:forAll(ability, checkBehaviorOnLevelChange)
+end)
 Ability.onCreate:addListener(function(ability)
     local createBehaviorFunctions = createBehaviorFunctionsByAbilityTypeId[ability.typeId]
     if createBehaviorFunctions ~= nil then

package/engine/behaviour/unit.d.ts

@@ -2,6 +2,7 @@
 import { Behavior, BehaviorPriority } from "../behavior";
 import { Ability } from "../internal/ability";
 import { DamageEvent, DamagingEvent, Unit } from "../internal/unit";
+import "../internal/unit/equipment-inventory";
 import "../internal/unit+ability";
 import "../internal/unit-missile-launch";
 import { Item } from "../internal/item";

package/engine/behaviour/unit.lua

@@ -8,6 +8,7 @@ local ____behavior = require("engine.behavior")
 local Behavior = ____behavior.Behavior
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+require("engine.internal.unit.equipment-inventory")
 require("engine.internal.unit+ability")
 require("engine.internal.unit-missile-launch")
 local ____linked_2Dset = require("utility.linked-set")

package/engine/buff.d.ts

@@ -23,6 +23,13 @@ export type BuffPolarityParameterType = EnumParameterValueType<BuffPolarity>;
 export type BuffResistanceTypeParameterType = EnumParameterValueType<BuffResistanceType>;
 export declare class BuffUniqueGroup {
 }
+export type BuffAbilityParameters = {
+    readonly fields?: [AbilityNumberField | AbilityNumberLevelField, NumberParameterValueType][];
+    /** Default `true`. */
+    readonly isButtonVisible?: boolean;
+    /** Default is the level of the source ability or 0 if it is absent. */
+    readonly level?: number;
+};
 export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     spellStealPriority?: number;
     level?: number;
@@ -30,16 +37,7 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     learnLevelMinimum?: number;
     source?: Unit;
     behaviorConstructors?: (new (unit: Unit) => UnitBehavior)[];
-    abilityTypeIds?: Record<AbilityTypeId, {
-        readonly fields?: [
-            AbilityNumberField | AbilityNumberLevelField,
-            NumberParameterValueType
-        ][];
-        /** Default `true`. */
-        readonly isButtonVisible?: boolean;
-        /** Default is the level of the source ability or 0 if it is absent. */
-        readonly level?: number;
-    }>;
+    abilityTypeIds?: Partial<Record<AbilityTypeId, BuffAbilityParameters>>;
     damageUponDeathAllowedTargetCombatClassifications?: CombatClassifications | AbilityCombatClassificationsLevelField;
     damageUponDeath?: NumberParameterValueType;
     damageUponDeathRange?: NumberParameterValueType;
@@ -314,10 +312,14 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     ]): void;
     private flash;
     expire(): void;
+    /** Dispels this buff, invoking onDispel before removing it. */
+    dispel(source?: Unit): void;
     protected onCreate(): void;
     protected onDestroy(): Destructor;
     static apply<T extends Buff<any>, Args extends any[]>(this: BuffConstructor<T, Args>, ...args: Args): T | undefined;
     static getByTypeId<T extends Buff<any>, Args extends any[]>(this: BuffConstructor<T, Args>, unit: Unit, typeId: ApplicableBuffTypeId): T | undefined;
+    /** Called for dispelling, never for a direct destroy() or replacement. */
+    onDispel(source: Unit | undefined): void;
     onExpiration(): void;
     onDeath(source: Unit | undefined): void;
     onDamageDealt(target: Unit, event: DamageEvent): void;

package/engine/buff.lua

@@ -254,6 +254,10 @@ local function destroyBuff(buff)
     buff:destroy()
 end
 local function expireBuff(buff)
+    if buff.isDestroyed or buff[100] ~= 1 then
+        return
+    end
+    buff[100] = 2
     local remainingDamageOverDuration = buff[113] or 0
     local remainingHealingOverDuration = buff[113] or 0
     if remainingDamageOverDuration ~= 0 or remainingHealingOverDuration ~= 0 then
@@ -482,7 +486,7 @@ function Buff.prototype.____constructor(self, _unit, typeIdOrTypeIds, polarityOr
                 self._abilityTypeIds = abilityTypeIds
             end
             for ____, abilityTypeId in ipairs(sortedKeysUnnested(parametersAbilityTypeIds)) do
-                local abilityParameters = parametersAbilityTypeIds[abilityTypeId]
+                local abilityParameters = checkNotNull(parametersAbilityTypeIds[abilityTypeId])
                 local addedAbility = _unit:addAbility(abilityTypeId)
                 if addedAbility ~= nil then
                     _unit:makeAbilityPermanent(abilityTypeId, true)
@@ -591,6 +595,20 @@ end
 function Buff.prototype.expire(self)
     expireBuff(self)
 end
+function Buff.prototype.dispel(self, source)
+    if self.isDestroyed or self[100] ~= 1 then
+        return
+    end
+    self[100] = 2
+    do
+        pcall(function()
+            self:onDispel(source)
+        end)
+        do
+            self:destroy()
+        end
+    end
+end
 function Buff.prototype.onCreate(self)
 end
 function Buff.prototype.onDestroy(self)
@@ -681,6 +699,8 @@ function Buff.getByTypeId(self, unit, typeId)
     end
     return nil
 end
+function Buff.prototype.onDispel(self, source)
+end
 function Buff.prototype.onExpiration(self)
     local unit = self.unit
     if self[120] ~= nil then
@@ -1473,35 +1493,40 @@ __TS__SetDescriptor(
 Buff.createdEvent = buffCreatedEvent
 Buff.beingDestroyedEvent = buffBeingDestroyedEvent;
 (function(self)
-    local function destroyBuffIfNeeded(buff)
-        if getUnitAbility(buff[101].handle, buff.typeId) ~= buff.handle and buff[100] == 1 then
-            buff:destroy()
+    local function destroyBuffIfNeeded(buff, isDispel, source)
+        local currentHandle = getUnitAbility(buff[101].handle, buff.typeId)
+        if currentHandle ~= buff.handle and buff[100] == 1 then
+            if isDispel and currentHandle == nil and buff.unit.isAlive and buff.resistanceType == 1 and (buff._timer == nil or buff.remainingDuration > 0) then
+                buff:dispel(source)
+            else
+                buff:destroy()
+            end
         end
     end
-    ____exports.checkBuff = function(unit, buffTypeId)
+    ____exports.checkBuff = function(unit, buffTypeId, isDispel, source)
         local buffByTypeId = buffByTypeIdByUnit[unit]
         if buffByTypeId ~= nil then
             local buff = buffByTypeId[buffTypeId]
             if buff ~= nil then
-                destroyBuffIfNeeded(buff)
+                destroyBuffIfNeeded(buff, isDispel, source)
             end
         end
     end
-    ____exports.checkBuffs = function(unit)
-        ____exports.Buff:forAll(unit, destroyBuffIfNeeded)
+    ____exports.checkBuffs = function(unit, isDispel, source)
+        ____exports.Buff:forAll(unit, destroyBuffIfNeeded, isDispel, source)
     end
     Unit.abilityChannelingStartEvent:addListener(
         0,
         function(caster)
-            ____exports.checkBuffs(caster)
-            Timer:run(____exports.checkBuffs, caster)
+            ____exports.checkBuffs(caster, true, caster)
+            Timer:run(____exports.checkBuffs, caster, true, caster)
         end
     )
     Unit.abilityUnitTargetChannelingStartEvent:addListener(
         0,
         function(caster, ability, target)
-            ____exports.checkBuffs(target)
-            Timer:run(____exports.checkBuffs, target)
+            ____exports.checkBuffs(target, true, caster)
+            Timer:run(____exports.checkBuffs, target, true, caster)
         end
     )
     Unit.abilityPointTargetChannelingStartEvent:addListener(
@@ -1512,17 +1537,40 @@ Buff.beingDestroyedEvent = buffBeingDestroyedEvent;
                 y,
                 ability:getField(ABILITY_RLF_AREA_OF_EFFECT)
             )
-            forEach(units, ____exports.checkBuffs)
-            Timer:run(forEach, units, ____exports.checkBuffs)
+            forEach(units, ____exports.checkBuffs, true, caster)
+            Timer:run(
+                forEach,
+                units,
+                ____exports.checkBuffs,
+                true,
+                caster
+            )
+        end
+    )
+    Unit.abilityNoTargetChannelingStartEvent:addListener(
+        0,
+        function(caster, ability)
+            local radius = ability:getField(ABILITY_RLF_AREA_OF_EFFECT)
+            if radius > 0 then
+                local units = Unit:getInCollisionRange(caster.x, caster.y, radius)
+                forEach(units, ____exports.checkBuffs, true, caster)
+                Timer:run(
+                    forEach,
+                    units,
+                    ____exports.checkBuffs,
+                    true,
+                    caster
+                )
+            end
         end
     )
     Unit.onDamage:addListener(
         0,
         function(source, target)
             if source ~= nil then
-                ____exports.checkBuffs(source)
+                Timer:run(____exports.checkBuffs, source, false)
             end
-            ____exports.checkBuffs(target)
+            Timer:run(____exports.checkBuffs, target, false)
         end
     )
     buffCreatedEvent:addListener(function(buff)

package/engine/index.d.ts

@@ -1,5 +1,6 @@
 /** @noSelfInFile */
 export declare const enum GraphicsMode {
     SD = 0,
-    HD = 1
+    HD = 1,
+    DE = 2
 }

package/engine/internal/ability.d.ts

@@ -37,6 +37,7 @@ export declare abstract class Ability extends Handle<jability> {
     abstract get level(): number;
     abstract get cooldownRemaining(): number;
     abstract set cooldownRemaining(cooldownRemaining: number);
+    abstract startCooldown(cooldown: number): void;
     abstract interruptCast(): void;
     static get onCreate(): Event<[Ability]>;
     static get destroyEvent(): Event<[Ability]>;
@@ -50,6 +51,7 @@ export declare class UnrecognizedAbility extends Ability {
     get level(): number;
     get cooldownRemaining(): number;
     set cooldownRemaining(_: number);
+    startCooldown(_: number): void;
     interruptCast(): void;
 }
 export declare class UnitAbility extends Ability {
@@ -64,8 +66,12 @@ export declare class UnitAbility extends Ability {
     get isDisabled(): boolean;
     get level(): number;
     set level(v: number);
+    /** Uses the native percentage scale. */
+    get cooldownRemainingPercent(): number;
+    set cooldownRemainingPercent(percent: number);
     get cooldownRemaining(): number;
     set cooldownRemaining(cooldownRemaining: number);
+    startCooldown(cooldown: number): void;
     interruptCast(): void;
     protected onDestroy(): HandleDestructor;
     static get onCreate(): Event<[UnitAbility]>;
@@ -93,6 +99,7 @@ export declare class ItemAbility extends Ability {
     get level(): number;
     get cooldownRemaining(): number;
     set cooldownRemaining(cooldownRemaining: number);
+    startCooldown(cooldown: number): void;
     interruptCast(): void;
     protected onDestroy(): HandleDestructor;
     static get onCreate(): Event<[ItemAbility]>;

package/engine/internal/ability.lua

@@ -14,29 +14,34 @@ local abilityActionDummy = ____ability.abilityActionDummy
 local doAbilityAction = ____ability.doAbilityAction
 local doAbilityActionForceDummy = ____ability.doAbilityActionForceDummy
 local startItemCooldown = ____ability.startItemCooldown
-local getUnitAbilityLevel = GetUnitAbilityLevel
-local setUnitAbilityLevel = SetUnitAbilityLevel
-local setAbilityIntegerField = BlzSetAbilityIntegerField
-local setAbilityRealField = BlzSetAbilityRealField
-local setAbilityBooleanField = BlzSetAbilityBooleanField
-local setAbilityStringField = BlzSetAbilityStringField
-local setAbilityIntegerLevelField = BlzSetAbilityIntegerLevelField
-local setAbilityRealLevelField = BlzSetAbilityRealLevelField
-local setAbilityBooleanLevelField = BlzSetAbilityBooleanLevelField
-local setAbilityStringLevelField = BlzSetAbilityStringLevelField
-local getAbilityIntegerField = BlzGetAbilityIntegerField
-local getAbilityRealField = BlzGetAbilityRealField
+local ____unit_2Dability_2Dlevel_2Dnatives = require("engine.internal.misc.unit-ability-level-natives")
+local rawSetUnitAbilityLevel = ____unit_2Dability_2Dlevel_2Dnatives.rawSetUnitAbilityLevel
 local getAbilityBooleanField = BlzGetAbilityBooleanField
-local getAbilityStringField = BlzGetAbilityStringField
+local getAbilityBooleanLevelField = BlzGetAbilityBooleanLevelField
+local getAbilityIntegerField = BlzGetAbilityIntegerField
 local getAbilityIntegerLevelField = BlzGetAbilityIntegerLevelField
+local getAbilityRealField = BlzGetAbilityRealField
 local getAbilityRealLevelField = BlzGetAbilityRealLevelField
-local getAbilityBooleanLevelField = BlzGetAbilityBooleanLevelField
+local getAbilityStringField = BlzGetAbilityStringField
 local getAbilityStringLevelField = BlzGetAbilityStringLevelField
+local getHandleId = GetHandleId
+local getUnitAbilityCooldownPercent = BlzGetUnitAbilityCooldownPercent
 local getUnitAbilityCooldownRemaining = BlzGetUnitAbilityCooldownRemaining
+local getUnitAbilityLevel = GetUnitAbilityLevel
+local order2orderId = _G.OrderId
+local setAbilityBooleanField = BlzSetAbilityBooleanField
+local setAbilityBooleanLevelField = BlzSetAbilityBooleanLevelField
+local setAbilityIntegerField = BlzSetAbilityIntegerField
+local setAbilityIntegerLevelField = BlzSetAbilityIntegerLevelField
+local setAbilityRealField = BlzSetAbilityRealField
+local setAbilityRealLevelField = BlzSetAbilityRealLevelField
+local setAbilityStringField = BlzSetAbilityStringField
+local setAbilityStringLevelField = BlzSetAbilityStringLevelField
+local setUnitAbilityCooldownPercent = BlzSetUnitAbilityCooldownPercent
+local setUnitAbilityCooldownRemaining = BlzSetUnitAbilityCooldownRemaining
 local startUnitAbilityCooldown = BlzStartUnitAbilityCooldown
-local getHandleId = GetHandleId
-local unitHideAbility = BlzUnitHideAbility
 local unitDisableAbility = BlzUnitDisableAbility
+local unitHideAbility = BlzUnitHideAbility
 local match = string.match
 local ____type = _G.type
 local ____tostring = _G.tostring
@@ -213,7 +218,6 @@ local levelRefreshFields = {
     [fourCC("Neg1")] = true
 }
 local levelsField = ABILITY_IF_LEVELS
-local order2orderId = _G.OrderId
 local orderIdFieldByParentTypeId = {
     [fourCC("ANcl")] = ABILITY_SLF_BASE_ORDER_ID_NCL6,
     [fourCC("Aspb")] = ABILITY_SLF_BASE_ORDER_ID_SPB5,
@@ -286,8 +290,8 @@ function Ability.prototype.setField(self, field, levelOrValue, value)
         local levels = getAbilityIntegerField(ability, levelsField)
         setAbilityIntegerField(ability, levelsField, levels + 1)
         local level = getUnitAbilityLevel(unit, typeId)
-        setUnitAbilityLevel(unit, typeId, levels + 1)
-        setUnitAbilityLevel(unit, typeId, level)
+        rawSetUnitAbilityLevel(unit, typeId, levels + 1)
+        rawSetUnitAbilityLevel(unit, typeId, level)
         setAbilityIntegerField(ability, levelsField, levels)
     end
     return success
@@ -369,6 +373,8 @@ function UnrecognizedAbility.prototype.____constructor(self, typeId, owner)
     UnrecognizedAbility.____super.prototype.____constructor(self, nil, typeId)
     self.owner = owner
 end
+function UnrecognizedAbility.prototype.startCooldown(self, _)
+end
 function UnrecognizedAbility.prototype.interruptCast(self)
 end
 __TS__SetDescriptor(
@@ -420,6 +426,9 @@ function UnitAbility.prototype.decrementDisableCounter(self)
     unitHideAbility(unit, typeId, true)
     self.d = (self.d or 0) - 1
 end
+function UnitAbility.prototype.startCooldown(self, cooldown)
+    startUnitAbilityCooldown(self.u, self.typeId, cooldown)
+end
 function UnitAbility.prototype.interruptCast(self)
     self.owner:interruptCast(self.typeId)
 end
@@ -445,7 +454,20 @@ __TS__SetDescriptor(
             return getUnitAbilityLevel(self.u, self.typeId) - 1
         end,
         set = function(self, v)
-            setUnitAbilityLevel(self.u, self.typeId, v + 1)
+            SetUnitAbilityLevel(self.u, self.typeId, v + 1)
+        end
+    },
+    true
+)
+__TS__SetDescriptor(
+    UnitAbility.prototype,
+    "cooldownRemainingPercent",
+    {
+        get = function(self)
+            return getUnitAbilityCooldownPercent(self.u, self.typeId)
+        end,
+        set = function(self, percent)
+            setUnitAbilityCooldownPercent(self.u, self.typeId, percent)
         end
     },
     true
@@ -458,7 +480,7 @@ __TS__SetDescriptor(
             return getUnitAbilityCooldownRemaining(self.u, self.typeId)
         end,
         set = function(self, cooldownRemaining)
-            startUnitAbilityCooldown(self.u, self.typeId, cooldownRemaining)
+            setUnitAbilityCooldownRemaining(self.u, self.typeId, cooldownRemaining)
         end
     },
     true
@@ -513,11 +535,18 @@ function ItemAbility.prototype.setField(self, field, levelOrValue, value)
         value
     )
 end
+function ItemAbility.prototype.startCooldown(self, cooldown)
+    local item = self.owner
+    local ____startItemCooldown_4 = startItemCooldown
+    local ____item_handle_3 = item.handle
+    local ____opt_1 = item.owner
+    ____startItemCooldown_4(____item_handle_3, ____opt_1 and ____opt_1.handle, cooldown)
+end
 function ItemAbility.prototype.interruptCast(self)
     local item = self.owner
     local itemHandle = item.handle
-    local ____opt_1 = item.owner
-    local itemOwnerHandle = ____opt_1 and ____opt_1.handle
+    local ____opt_5 = item.owner
+    local itemOwnerHandle = ____opt_5 and ____opt_5.handle
     local cooldownRemaining = doAbilityActionForceDummy(itemHandle, itemOwnerHandle, getAbilityCooldown, self.typeId)
     if cooldownRemaining == 0 then
         startItemCooldown(itemHandle, itemOwnerHandle, 0.015625)
@@ -543,17 +572,17 @@ __TS__SetDescriptor(
     {
         get = function(self)
             local item = self.owner
-            local ____doAbilityActionForceDummy_6 = doAbilityActionForceDummy
-            local ____item_handle_5 = item.handle
-            local ____opt_3 = item.owner
-            return ____doAbilityActionForceDummy_6(____item_handle_5, ____opt_3 and ____opt_3.handle, getAbilityCooldown, self.typeId)
+            local ____doAbilityActionForceDummy_10 = doAbilityActionForceDummy
+            local ____item_handle_9 = item.handle
+            local ____opt_7 = item.owner
+            return ____doAbilityActionForceDummy_10(____item_handle_9, ____opt_7 and ____opt_7.handle, getAbilityCooldown, self.typeId)
         end,
         set = function(self, cooldownRemaining)
             local item = self.owner
-            local ____startItemCooldown_10 = startItemCooldown
-            local ____item_handle_9 = item.handle
-            local ____opt_7 = item.owner
-            ____startItemCooldown_10(____item_handle_9, ____opt_7 and ____opt_7.handle, cooldownRemaining)
+            local ____startItemCooldown_14 = startItemCooldown
+            local ____item_handle_13 = item.handle
+            local ____opt_11 = item.owner
+            ____startItemCooldown_14(____item_handle_13, ____opt_11 and ____opt_11.handle, cooldownRemaining)
         end
     },
     true

package/engine/internal/item/owner-cache.d.ts

@@ -0,0 +1,5 @@
+/** @noSelfInFile */
+import type { Item } from "../item";
+import type { Unit } from "../unit";
+/** The last unit known (from item events) to carry each item; validated against the engine on read. */
+export declare const ownerByItem: LuaMap<Item, Unit>;

package/engine/internal/item/owner-cache.lua

@@ -0,0 +1,4 @@
+local ____exports = {}
+--- The last unit known (from item events) to carry each item; validated against the engine on read.
+____exports.ownerByItem = setmetatable({}, {__mode = "kv"})
+return ____exports