warscript 0.0.1-dev.0ad346c → 0.0.1-dev.0d18530

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.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
@@ -31,7 +28,11 @@ function EmulateImpactAbilityBehavior.prototype.emulateImpact(self, caster)
         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

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,11 +27,12 @@ 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;

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;
@@ -56,7 +54,8 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     damageIncrease?: NumberParameterValueType;
     damageIncreaseFactor?: NumberParameterValueType;
     armorIncrease?: NumberParameterValueType;
-    armorIncreaseFactor?: NumberParameterValueType;
+    maxHealthIncrease?: NumberParameterValueType;
+    maxManaIncrease?: NumberParameterValueType;
     attackSpeedIncreaseFactor?: NumberParameterValueType;
     movementSpeedIncreaseFactor?: NumberParameterValueType;
     manaRegenerationRateIncreaseFactor?: NumberParameterValueType;
@@ -79,6 +78,9 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     maximumAutoAttackCount?: IntegerParameterValueType;
     maximumDamageDealtEventCount?: IntegerParameterValueType;
     maximumDamageReceivedEventCount?: IntegerParameterValueType;
+    absorbedDamageFactor?: NumberParameterValueType;
+    maximumDamageAbsorbed?: NumberParameterValueType;
+    destroysOnMaximumDamageAbsorbed?: BooleanParameterValueType;
     damageOnExpiration?: NumberParameterValueType;
     healingOnExpiration?: NumberParameterValueType;
     killsOnExpiration?: BooleanParameterValueType;
@@ -122,16 +124,20 @@ declare const enum BuffPropertyKey {
     MAXIMUM_DAMAGE_DEALT_EVENT_COUNT = 132,
     DAMAGE_RECEIVED_EVENT_COUNT = 133,
     MAXIMUM_DAMAGE_RECEIVED_EVENT_COUNT = 134,
-    TURNS_INTO_GHOST = 135,
-    STUNS = 136,
-    IGNORES_STUN_IMMUNITY = 137,
-    DISABLES_AUTO_ATTACK = 138,
-    PROVIDES_INVULNERABILITY = 139,
-    KILLS_ON_EXPIRATION = 140,
-    EXPLODES_ON_EXPIRATION = 141,
-    MISS_PROBABILITY = 142,
-    ABILITY_COOLDOWN_FACTOR = 143,
-    ABILITY_COOLDOWN_MODIFIER = 144
+    ABSORBED_DAMAGE_FACTOR = 135,
+    MAXIMUM_DAMAGE_ABSORBED = 136,
+    DAMAGE_ABSORBED = 137,
+    DESTROYS_ON_MAXIMUM_DAMAGE_ABSORBED = 138,
+    TURNS_INTO_GHOST = 139,
+    STUNS = 140,
+    IGNORES_STUN_IMMUNITY = 141,
+    DISABLES_AUTO_ATTACK = 142,
+    PROVIDES_INVULNERABILITY = 143,
+    KILLS_ON_EXPIRATION = 144,
+    EXPLODES_ON_EXPIRATION = 145,
+    MISS_PROBABILITY = 146,
+    ABILITY_COOLDOWN_FACTOR = 147,
+    ABILITY_COOLDOWN_MODIFIER = 148
 }
 export declare const enum BuffTypeIdSelectionPolicy {
     LEAST_DURATION = 0
@@ -189,6 +195,10 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     private [BuffPropertyKey.DAMAGE_DEALT_EVENT_COUNT]?;
     private [BuffPropertyKey.MAXIMUM_DAMAGE_RECEIVED_EVENT_COUNT]?;
     private [BuffPropertyKey.DAMAGE_RECEIVED_EVENT_COUNT]?;
+    private [BuffPropertyKey.ABSORBED_DAMAGE_FACTOR]?;
+    private [BuffPropertyKey.MAXIMUM_DAMAGE_ABSORBED]?;
+    private [BuffPropertyKey.DAMAGE_ABSORBED]?;
+    private [BuffPropertyKey.DESTROYS_ON_MAXIMUM_DAMAGE_ABSORBED]?;
     private [BuffPropertyKey.TURNS_INTO_GHOST]?;
     private [BuffPropertyKey.STUNS]?;
     private [BuffPropertyKey.IGNORES_STUN_IMMUNITY]?;
@@ -203,10 +213,11 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     readonly typeId: ApplicableBuffTypeId;
     readonly polarity: BuffPolarity;
     readonly resistanceType: BuffResistanceType;
-    readonly parameters: IsExactlyAny<AdditionalParameters> extends true ? any : keyof AdditionalParameters extends never ? undefined : {
+    readonly parameters: IsExactlyAny<AdditionalParameters> extends true ? any : AdditionalParameters extends Record<PropertyKey, never> ? undefined : {
         [K in keyof Omit<AdditionalParameters, keyof BuffParameters>]: AdditionalParameters[K] extends AbilityDependentValue<infer T> ? T : AdditionalParameters[K];
     };
     private readonly handle;
+    readonly previousBuff?: Buff;
     private _timer?;
     private readonly _level?;
     private readonly _spellStealPriority?;
@@ -242,6 +253,10 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set receivedDamageFactor(receivedDamageFactor: number);
     get armorIncrease(): number;
     set armorIncrease(armorIncrease: number);
+    get maxHealthIncrease(): number;
+    set maxHealthIncrease(maxHealthIncrease: number);
+    get maxManaIncrease(): number;
+    set maxManaIncrease(maxManaIncrease: number);
     get turnsIntoGhost(): boolean;
     set turnsIntoGhost(turnsIntoGhost: boolean);
     get stuns(): boolean;
@@ -276,6 +291,13 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set duration(duration: number);
     get remainingDuration(): number;
     set remainingDuration(remainingDuration: number);
+    get absorbedDamageFactor(): number;
+    set absorbedDamageFactor(absorbedDamageFactor: number);
+    get maximumDamageAbsorbed(): number;
+    set maximumDamageAbsorbed(maximumDamageAbsorbed: number);
+    get damageAbsorbed(): number;
+    get destroysOnMaximumDamageAbsorbed(): boolean;
+    set destroysOnMaximumDamageAbsorbed(destroysOnMaximumDamageAbsorbed: boolean);
     get abilityCooldownFactor(): number;
     set abilityCooldownFactor(abilityCooldownFactor: number);
     onAbilityGained(ability: Ability): void;
@@ -284,12 +306,20 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
         ...widgetOrXY: [] | [Widget] | [x: number, x: number],
         ...parametersOrDuration: [] | [EffectParameters] | [number]
     ]): void;
-    flashSpecialEffect(...parameters: [...widget: [] | [Widget], ...duration: [] | [number]]): void;
+    flashSpecialEffect(...parameters: [
+        ...widgetOrXY: [] | [Widget] | [x: number, x: number],
+        ...parametersOrDuration: [] | [EffectParameters] | [number]
+    ]): 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;