warscript 0.0.1-dev.3eed609 → 0.0.1-dev.3f0a5ea

package/destroyable.d.ts

@@ -10,6 +10,7 @@ export interface Destroyable {
     destroy(): void;
 }
 export declare abstract class AbstractDestroyable implements Destroyable {
+    get isDestroyed(): boolean;
     /**
      * An overriding function should always call the super one at the end of it,
      * in the following manner: `return super.onDestroy()`.

package/destroyable.lua

@@ -1,6 +1,7 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__New = ____lualib.__TS__New
+local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
 local ____exports = {}
 local ____exception = require("exception")
 local IllegalStateException = ____exception.IllegalStateException
@@ -28,4 +29,12 @@ function AbstractDestroyable.prototype.destroy(self)
     end
     return true
 end
+__TS__SetDescriptor(
+    AbstractDestroyable.prototype,
+    "isDestroyed",
+    {get = function(self)
+        return stateByDestroyable[self] ~= nil
+    end},
+    true
+)
 return ____exports

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/behavior.d.ts

@@ -18,9 +18,11 @@ export declare abstract class Behavior<T extends AnyNotNil, PeriodicActionParame
     private [BehaviorPropertyKey.PREVIOUS_BEHAVIOR]?;
     private [BehaviorPropertyKey.NEXT_BEHAVIOR]?;
     private [BehaviorPropertyKey.TIMER]?;
-    protected constructor(object: T, priority?: BehaviorPriority);
+    constructor(object: T, priority?: BehaviorPriority);
     protected onDestroy(): Destructor;
-    protected registerEvent<K extends string, Args extends any[]>(this: Behavior<any, PeriodicActionParameters> & Record<K, (this: this, ...args: Args) => unknown>, event: Event<[...Args]>, listener: K): void;
+    protected registerGlobalEvent<K extends string, Args extends any[]>(this: Behavior<any, PeriodicActionParameters> & Record<K, (this: this, ...args: Args) => unknown>, event: Event<[...Args]>, listener: K): void;
+    protected deregisterGlobalEvent(event: Event<any>): boolean;
+    protected registerEvent<K extends string, Args extends any[]>(this: Behavior<any, PeriodicActionParameters> & Record<K, (this: this, ...args: Args) => unknown>, event: Event<[...Args]>, extractObject: (...args: Args) => T | undefined, listener: K): void;
     protected deregisterEvent(event: Event<any>): boolean;
     protected onPeriod(...parameters: PeriodicActionParameters): void;
     protected startPeriodicAction(interval: number, ...parameters: PeriodicActionParameters): void;

package/engine/behavior.lua

@@ -57,9 +57,17 @@ local function reduceBehaviors(behaviorConstructor, object, operation, initial,
     end
     return accumulator
 end
+local behaviorsByGlobalEvent = {}
+local listenerByBehaviorByGlobalEvent = {}
+local globalEventsByBehavior = {}
 local behaviorsByEvent = {}
 local listenerByBehaviorByEvent = {}
 local eventsByBehavior = {}
+local function safeCallBehaviorListener(behavior, behaviors, listenerByBehavior, ...)
+    if behaviors[behavior] ~= nil then
+        safeCall(behavior[listenerByBehavior[behavior]], behavior, ...)
+    end
+end
 ____exports.Behavior = __TS__Class()
 local Behavior = ____exports.Behavior
 Behavior.name = "Behavior"
@@ -87,18 +95,32 @@ function Behavior.prototype.onDestroy(self)
     if ____opt_0 ~= nil then
         ____opt_0:destroy()
     end
-    local events = eventsByBehavior[self]
-    if events ~= nil then
-        for event in pairs(events) do
-            local ____opt_2 = behaviorsByEvent[event]
+    local globalEvents = globalEventsByBehavior[self]
+    if globalEvents ~= nil then
+        for event in pairs(globalEvents) do
+            local ____opt_2 = behaviorsByGlobalEvent[event]
             if ____opt_2 ~= nil then
                 ____opt_2:remove(self)
             end
-            local ____opt_4 = listenerByBehaviorByEvent[event]
+            local ____opt_4 = listenerByBehaviorByGlobalEvent[event]
             if ____opt_4 ~= nil then
                 ____opt_4[self] = nil
             end
         end
+        globalEventsByBehavior[self] = nil
+    end
+    local events = eventsByBehavior[self]
+    if events ~= nil then
+        for event in pairs(events) do
+            local ____opt_6 = behaviorsByEvent[event]
+            if ____opt_6 ~= nil then
+                ____opt_6[self] = nil
+            end
+            local ____opt_8 = listenerByBehaviorByEvent[event]
+            if ____opt_8 ~= nil then
+                ____opt_8[self] = nil
+            end
+        end
         eventsByBehavior[self] = nil
     end
     local previousBehavior = self[0]
@@ -115,7 +137,35 @@ function Behavior.prototype.onDestroy(self)
     end
     return AbstractDestroyable.prototype.onDestroy(self)
 end
-function Behavior.prototype.registerEvent(self, event, listener)
+function Behavior.prototype.registerGlobalEvent(self, event, listener)
+    local listenerByBehavior = getOrPut(listenerByBehaviorByGlobalEvent, event, mutableLuaMap)
+    listenerByBehavior[self] = listener
+    getOrPut(globalEventsByBehavior, self, mutableLuaSet)[event] = true
+    local behaviors = behaviorsByGlobalEvent[event]
+    if behaviors == nil then
+        event:addListener(function(...)
+            local behaviors = behaviorsByGlobalEvent[event]
+            if behaviors ~= nil then
+                for behavior in pairs(behaviors) do
+                    safeCall(behavior[listenerByBehavior[behavior]], behavior, ...)
+                end
+            end
+        end)
+        behaviors = __TS__New(LinkedSet)
+        behaviorsByGlobalEvent[event] = behaviors
+    end
+    behaviors:add(self)
+end
+function Behavior.prototype.deregisterGlobalEvent(self, event)
+    local behaviors = behaviorsByGlobalEvent[event]
+    if behaviors ~= nil and behaviors:remove(self) then
+        globalEventsByBehavior[self][event] = nil
+        listenerByBehaviorByGlobalEvent[event][self] = nil
+        return true
+    end
+    return false
+end
+function Behavior.prototype.registerEvent(self, event, extractObject, listener)
     local listenerByBehavior = getOrPut(listenerByBehaviorByEvent, event, mutableLuaMap)
     listenerByBehavior[self] = listener
     getOrPut(eventsByBehavior, self, mutableLuaSet)[event] = true
@@ -124,19 +174,27 @@ function Behavior.prototype.registerEvent(self, event, listener)
         event:addListener(function(...)
             local behaviors = behaviorsByEvent[event]
             if behaviors ~= nil then
-                for behavior in pairs(behaviors) do
-                    safeCall(behavior[listenerByBehavior[behavior]], behavior, ...)
+                local object = extractObject(...)
+                if object ~= nil then
+                    ____exports.Behavior:forAll(
+                        object,
+                        safeCallBehaviorListener,
+                        behaviors,
+                        listenerByBehavior,
+                        ...
+                    )
                 end
             end
         end)
-        behaviors = __TS__New(LinkedSet)
+        behaviors = {}
         behaviorsByEvent[event] = behaviors
     end
-    behaviors:add(self)
+    behaviors[self] = true
 end
 function Behavior.prototype.deregisterEvent(self, event)
     local behaviors = behaviorsByEvent[event]
-    if behaviors ~= nil and behaviors:remove(self) then
+    if behaviors ~= nil and behaviors[self] ~= nil then
+        behaviors[self] = nil
         eventsByBehavior[self][event] = nil
         listenerByBehaviorByEvent[event][self] = nil
         return true

package/engine/behaviour/ability/apply-buff.lua

@@ -27,7 +27,7 @@ function ApplyBuffAbilityBehavior.prototype.____constructor(self, ability, const
                 constructorOrTypeIdOrTypeIds,
                 typeIdOrTypeIdsOrPolarityOrTypeIdSelectionPolicy,
                 polarityOrTypeIdSelectionPolicyOrResistanceType,
-                ability,
+                self,
                 resistanceTypeOrPolarityOrParameters
             )
         end
@@ -39,7 +39,7 @@ function ApplyBuffAbilityBehavior.prototype.____constructor(self, ability, const
                 typeIdOrTypeIdsOrPolarityOrTypeIdSelectionPolicy,
                 polarityOrTypeIdSelectionPolicyOrResistanceType,
                 resistanceTypeOrPolarityOrParameters,
-                ability,
+                self,
                 parametersOrResistanceType
             )
         end
@@ -50,7 +50,7 @@ function ApplyBuffAbilityBehavior.prototype.____constructor(self, ability, const
                 typeIdOrTypeIdsOrPolarityOrTypeIdSelectionPolicy,
                 polarityOrTypeIdSelectionPolicyOrResistanceType,
                 resistanceTypeOrPolarityOrParameters,
-                ability,
+                self,
                 parametersOrResistanceType
             )
         end
@@ -62,7 +62,7 @@ function ApplyBuffAbilityBehavior.prototype.____constructor(self, ability, const
                 polarityOrTypeIdSelectionPolicyOrResistanceType,
                 resistanceTypeOrPolarityOrParameters,
                 parametersOrResistanceType,
-                ability,
+                self,
                 parameters
             )
         end

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 = {
@@ -25,8 +26,11 @@ export declare abstract class DamageAbilityBehavior<T extends DamageAbilityBehav
     protected readonly damage: AbilityDependentValue<number>;
     protected readonly parameters?: T | undefined;
     protected constructor(ability: Ability, damage: AbilityDependentValue<number>, parameters?: T | undefined);
+    protected precalculatedDamage?: number;
     protected calculateDamage(caster: Unit): number;
     protected damageTarget(caster: Unit, target: Widget, damage?: number): void;
+    onChannelingStart(caster: Unit): void;
+    onStop(): void;
 }
 export declare class DamageSelfAbilityBehavior extends DamageAbilityBehavior {
     constructor(ability: Ability, damage: AbilityDependentValue<number>, parameters?: 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"
@@ -39,7 +38,7 @@ function DamageAbilityBehavior.prototype.damageTarget(self, caster, target, dama
     local parameters = self.parameters
     caster:damageTarget(
         target,
-        damage or self:calculateDamage(caster),
+        damage or self.precalculatedDamage or self:calculateDamage(caster),
         nil,
         nil,
         self:resolveCurrentAbilityDependentValue(parameters and parameters.attackType),
@@ -48,6 +47,12 @@ function DamageAbilityBehavior.prototype.damageTarget(self, caster, target, dama
         self:resolveCurrentAbilityDependentValue(parameters and parameters.metadata)
     )
 end
+function DamageAbilityBehavior.prototype.onChannelingStart(self, caster)
+    self.precalculatedDamage = self:calculateDamage(caster)
+end
+function DamageAbilityBehavior.prototype.onStop(self)
+    self.precalculatedDamage = nil
+end
 ____exports.DamageSelfAbilityBehavior = __TS__Class()
 local DamageSelfAbilityBehavior = ____exports.DamageSelfAbilityBehavior
 DamageSelfAbilityBehavior.name = "DamageSelfAbilityBehavior"
@@ -76,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: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.d.ts

@@ -1,6 +1,20 @@
 /** @noSelfInFile */
 import { AbilityBehavior } from "../ability";
 import { Unit } from "../../internal/unit";
+import { Item } from "../../internal/item";
+import { Destructable } from "../../../core/types/destructable";
 export declare abstract class EmulateImpactAbilityBehavior extends AbilityBehavior {
+    /**
+     * Pays the cost of the cast and invokes only the common impact event: for impacts
+     * that have no cast target to report, such as ones triggered by a command.
+     */
     protected emulateImpact(caster: Unit): boolean;
+    protected emulateUnitTargetImpact(caster: Unit, target: Unit): boolean;
+    protected emulateItemTargetImpact(caster: Unit, target: Item): boolean;
+    protected emulateDestructibleTargetImpact(caster: Unit, target: Destructable): boolean;
+    protected emulatePointTargetImpact(caster: Unit, x: number, y: number): boolean;
+    protected emulateNoTargetImpact(caster: Unit): boolean;
+    /** Invokes the common impact event and the one matching the target, as a real impact. */
+    private emulateTargetImpact;
+    private payEmulatedImpact;
 }

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

@@ -10,9 +10,6 @@ local Unit = ____unit.Unit
 local ____ability = require("engine.standard.fields.ability")
 local COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD = ____ability.COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD
 local MANA_COST_ABILITY_INTEGER_LEVEL_FIELD = ____ability.MANA_COST_ABILITY_INTEGER_LEVEL_FIELD
-local ____math = require("math")
-local max = ____math.max
-local MINIMUM_POSITIVE_NORMALIZED_FLOAT = ____math.MINIMUM_POSITIVE_NORMALIZED_FLOAT
 local ____sound = require("core.types.sound")
 local Sound3D = ____sound.Sound3D
 local SoundSettings = ____sound.SoundSettings
@@ -20,24 +17,101 @@ local ____ability = require("engine.internal.ability")
 local UnitAbility = ____ability.UnitAbility
 local ____event = require("event")
 local Event = ____event.Event
+local ____ability = require("engine.internal.unit.ability")
+local emulateAbilityImpactEvent = ____ability.emulateAbilityImpactEvent
 ____exports.EmulateImpactAbilityBehavior = __TS__Class()
 local EmulateImpactAbilityBehavior = ____exports.EmulateImpactAbilityBehavior
 EmulateImpactAbilityBehavior.name = "EmulateImpactAbilityBehavior"
 __TS__ClassExtends(EmulateImpactAbilityBehavior, AbilityBehavior)
 function EmulateImpactAbilityBehavior.prototype.emulateImpact(self, caster)
+    if not self:payEmulatedImpact(caster) then
+        return false
+    end
+    Event.invoke(Unit.abilityImpactEvent, caster, self.ability)
+    return true
+end
+function EmulateImpactAbilityBehavior.prototype.emulateUnitTargetImpact(self, caster, target)
+    return self:emulateTargetImpact(
+        caster,
+        target,
+        nil,
+        nil,
+        target.x,
+        target.y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateItemTargetImpact(self, caster, target)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        target,
+        nil,
+        target.x,
+        target.y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateDestructibleTargetImpact(self, caster, target)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        nil,
+        target,
+        target.x,
+        target.y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulatePointTargetImpact(self, caster, x, y)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        nil,
+        nil,
+        x,
+        y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateNoTargetImpact(self, caster)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        nil,
+        nil,
+        0,
+        0
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateTargetImpact(self, caster, targetUnit, targetItem, targetDestructible, x, y)
+    if not self:payEmulatedImpact(caster) then
+        return false
+    end
+    emulateAbilityImpactEvent(
+        caster,
+        self.ability,
+        targetUnit,
+        targetItem,
+        targetDestructible,
+        x,
+        y
+    )
+    return true
+end
+function EmulateImpactAbilityBehavior.prototype.payEmulatedImpact(self, caster)
     local manaCost = self:resolveCurrentAbilityDependentValue(MANA_COST_ABILITY_INTEGER_LEVEL_FIELD)
     local cooldown = self:resolveCurrentAbilityDependentValue(COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD)
     if self.ability.cooldownRemaining ~= 0 or caster.mana < manaCost or __TS__InstanceOf(self.ability, UnitAbility) and self.ability.isDisabled then
         return false
     end
     caster.mana = caster.mana - manaCost
-    self.ability.cooldownRemaining = max(cooldown, MINIMUM_POSITIVE_NORMALIZED_FLOAT)
+    if cooldown == 0 then
+        self.ability:interruptCast()
+    else
+        self.ability:startCooldown(cooldown)
+    end
     self:flashCasterEffect(caster)
     local soundPresetId = self.ability:getField(ABILITY_SF_EFFECT_SOUND)
     if soundPresetId ~= "" then
         Sound3D:playFromLabel(soundPresetId, SoundSettings.Ability, caster)
     end
-    Event.invoke(Unit.abilityImpactEvent, caster, self.ability)
     return true
 end
 return ____exports

package/engine/behaviour/ability/instant-impact.d.ts

@@ -1,6 +1,17 @@
 /** @noSelfInFile */
 import { Unit } from "../../internal/unit";
+import { Item } from "../../internal/item";
+import { Destructable } from "../../../core/types/destructable";
 import { EmulateImpactAbilityBehavior } from "./emulate-impact";
+/**
+ * Makes the ability take effect as soon as its cast starts, skipping the cast animation:
+ * the impact events fire with the cast's target, so target-specific impact handlers
+ * (`onPointTargetImpact`, `onUnitTargetImpact`, ...) work as with a native impact.
+ */
 export declare class InstantImpactAbilityBehavior extends EmulateImpactAbilityBehavior {
-    onCastingStart(caster: Unit): void;
+    onUnitTargetCastingStart(caster: Unit, target: Unit): void;
+    onItemTargetCastingStart(caster: Unit, target: Item): void;
+    onDestructibleTargetCastingStart(caster: Unit, target: Destructable): void;
+    onPointTargetCastingStart(caster: Unit, x: number, y: number): void;
+    onNoTargetCastingStart(caster: Unit): void;
 }

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

@@ -4,11 +4,26 @@ local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
 local ____emulate_2Dimpact = require("engine.behaviour.ability.emulate-impact")
 local EmulateImpactAbilityBehavior = ____emulate_2Dimpact.EmulateImpactAbilityBehavior
+--- Makes the ability take effect as soon as its cast starts, skipping the cast animation:
+-- the impact events fire with the cast's target, so target-specific impact handlers
+-- (`onPointTargetImpact`, `onUnitTargetImpact`, ...) work as with a native impact.
 ____exports.InstantImpactAbilityBehavior = __TS__Class()
 local InstantImpactAbilityBehavior = ____exports.InstantImpactAbilityBehavior
 InstantImpactAbilityBehavior.name = "InstantImpactAbilityBehavior"
 __TS__ClassExtends(InstantImpactAbilityBehavior, EmulateImpactAbilityBehavior)
-function InstantImpactAbilityBehavior.prototype.onCastingStart(self, caster)
-    self:emulateImpact(caster)
+function InstantImpactAbilityBehavior.prototype.onUnitTargetCastingStart(self, caster, target)
+    self:emulateUnitTargetImpact(caster, target)
+end
+function InstantImpactAbilityBehavior.prototype.onItemTargetCastingStart(self, caster, target)
+    self:emulateItemTargetImpact(caster, target)
+end
+function InstantImpactAbilityBehavior.prototype.onDestructibleTargetCastingStart(self, caster, target)
+    self:emulateDestructibleTargetImpact(caster, target)
+end
+function InstantImpactAbilityBehavior.prototype.onPointTargetCastingStart(self, caster, x, y)
+    self:emulatePointTargetImpact(caster, x, y)
+end
+function InstantImpactAbilityBehavior.prototype.onNoTargetCastingStart(self, caster)
+    self:emulateNoTargetImpact(caster)
 end
 return ____exports

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

@@ -1,6 +1,8 @@
 /** @noSelfInFile */
 import { Behavior } from "../behavior";
-import { Unit } from "../unit";
+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";
@@ -25,16 +27,21 @@ 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 flashCasterEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashTargetEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashAreaEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashSpecialEffect(...args: [
+    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;
+    flashEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    flashSpecialEffect(...args: [
         ...pointOrWidget: [x: number, y: number] | [widget: Widget],
         ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]
     ]): void;
     private static MissileLaunchConfig;
     private get missileLaunchConfig();
+    protected launchMissile(source: Unit, ...args: [
+        ...pointOrWidget: [x: number, y: number] | [widget: Unit /** TODO: support Widget */],
+        ...parameters: NonNullable<Parameters["missileParameters"]>
+    ]): void;
     protected onCreate(): void;
     onValueChange(_value: ReadonlySubscribableAbilityDependentValue<string | number | boolean>): void;
     onMissileArrival(...parameters: NonNullable<Parameters["missileParameters"]>): void;
@@ -42,6 +49,12 @@ export declare abstract class AbilityBehavior<Parameters extends {
     onUnitLoseAbility(_unit: Unit): void;
     onCommand(caster: Unit, orderTypeStringId: string): void;
     onCastingStart(caster: Unit): void;
+    onWidgetTargetCastingStart(caster: Unit, target: Widget): void;
+    onUnitTargetCastingStart(caster: Unit, target: Unit): void;
+    onItemTargetCastingStart(caster: Unit, target: Item): void;
+    onDestructibleTargetCastingStart(caster: Unit, target: Destructable): void;
+    onPointTargetCastingStart(caster: Unit, x: number, y: number): void;
+    onNoTargetCastingStart(caster: Unit): void;
     onCastingFinish(caster: Unit): void;
     onChannelingStart(caster: Unit): void;
     onWidgetTargetChannelingStart(caster: Unit, target: Widget): void;