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

package/engine/behaviour/ability.lua

@@ -7,29 +7,77 @@ local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
 local ____exports = {}
 local ____behavior = require("engine.behavior")
 local Behavior = ____behavior.Behavior
-local ____unit = require("engine.unit")
+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")
 local Effect = ____effect.Effect
 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_COUNT_ABILITY_INTEGER_FIELD = ____ability.CASTER_EFFECT_COUNT_ABILITY_INTEGER_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 CASTER_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD = ____ability.CASTER_EFFECT_SECOND_ATTACHMENT_POINT_STRING_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
 local MISSILE_SPEED_ABILITY_INTEGER_FIELD = ____ability.MISSILE_SPEED_ABILITY_INTEGER_FIELD
 local SPECIAL_EFFECT_ATTACHMENT_POINT_STRING_FIELD = ____ability.SPECIAL_EFFECT_ATTACHMENT_POINT_STRING_FIELD
 local SPECIAL_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.SPECIAL_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
+local TARGET_EFFECT_COUNT_ABILITY_INTEGER_FIELD = ____ability.TARGET_EFFECT_COUNT_ABILITY_INTEGER_FIELD
+local TARGET_EFFECT_FIFTH_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_FIFTH_ATTACHMENT_POINT_STRING_FIELD
 local TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD
+local TARGET_EFFECT_FOURTH_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_FOURTH_ATTACHMENT_POINT_STRING_FIELD
 local TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
+local TARGET_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD
+local TARGET_EFFECT_SIXTH_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_SIXTH_ATTACHMENT_POINT_STRING_FIELD
+local TARGET_EFFECT_THIRD_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_THIRD_ATTACHMENT_POINT_STRING_FIELD
 local ____ability = require("engine.object-field.ability")
 local AbilityField = ____ability.AbilityField
 local AbilityLevelField = ____ability.AbilityLevelField
 local resolveCurrentAbilityDependentValue = ____ability.resolveCurrentAbilityDependentValue
+local ____missile = require("core.types.missile")
+local Missile = ____missile.Missile
+local CASTER_EFFECT_ATTACHMENT_POINT_STRING_FIELDS = {CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD, CASTER_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD}
+local TARGET_EFFECT_ATTACHMENT_POINT_STRING_FIELDS = {
+    TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_THIRD_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_FOURTH_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_FIFTH_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_SIXTH_ATTACHMENT_POINT_STRING_FIELD
+}
+--- Flashes every preset of an effect preset list (caster/target effects): each model at
+-- its own attachment point. The effect count field limits the list; at least the first
+-- model is always flashed, as abilities without the count set expect.
+local function flashEffectPresets(ability, modelPathsField, attachmentPointFields, effectCountField, widget, ...)
+    local count = math.min(
+        math.max(
+            effectCountField:getValue(ability),
+            1
+        ),
+        #attachmentPointFields
+    )
+    for i = 0, count - 1 do
+        local modelPath = modelPathsField:getValue(ability, i)
+        if modelPath ~= "" then
+            local attachmentPoint = attachmentPointFields[i + 1]:getValue(ability)
+            Effect:flash(modelPath, widget, attachmentPoint ~= "" and attachmentPoint or "origin", ...)
+        end
+    end
+end
 local createBehaviorFunctionsByAbilityTypeId = {}
+local function invokeOnMissileArrival(_missile, success, abilityBehavior, ...)
+    if success then
+        abilityBehavior:onMissileArrival(...)
+    end
+end
 local exclusiveOnImpactHandlerAbilityBehaviorByAbility = setmetatable({}, {__mode = "k"})
 local function createUnitEventListener(key)
     return function(unit, ability, ...)
@@ -105,21 +153,31 @@ 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(
-        CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD:getValue(self.ability, 0),
+    flashEffectPresets(
+        self.ability,
+        CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD,
+        CASTER_EFFECT_ATTACHMENT_POINT_STRING_FIELDS,
+        CASTER_EFFECT_COUNT_ABILITY_INTEGER_FIELD,
         widget,
-        attachmentPoint ~= "" and attachmentPoint or "origin",
         ...
     )
 end
 function AbilityBehavior.prototype.flashTargetEffect(self, widget, ...)
-    local attachmentPoint = TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD:getValue(self.ability)
-    Effect:flash(
-        TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD:getValue(self.ability, 0),
+    flashEffectPresets(
+        self.ability,
+        TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD,
+        TARGET_EFFECT_ATTACHMENT_POINT_STRING_FIELDS,
+        TARGET_EFFECT_COUNT_ABILITY_INTEGER_FIELD,
         widget,
-        attachmentPoint ~= "" and attachmentPoint or "origin",
         ...
     )
 end
@@ -159,6 +217,28 @@ function AbilityBehavior.prototype.flashSpecialEffect(self, xOrWidget, yOrParame
         )
     end
 end
+function AbilityBehavior.prototype.launchMissile(self, source, xOrWidget, yOrParameter, ...)
+    if type(xOrWidget) ~= "number" then
+        Missile:launch(
+            self.missileLaunchConfig,
+            source,
+            xOrWidget,
+            invokeOnMissileArrival,
+            self,
+            yOrParameter,
+            ...
+        )
+    else
+        Missile:launch(
+            self.missileLaunchConfig,
+            source,
+            vec2(xOrWidget, yOrParameter),
+            invokeOnMissileArrival,
+            self,
+            ...
+        )
+    end
+end
 function AbilityBehavior.prototype.onCreate(self)
 end
 function AbilityBehavior.prototype.onValueChange(self, _value)
@@ -173,6 +253,18 @@ function AbilityBehavior.prototype.onCommand(self, caster, orderTypeStringId)
 end
 function AbilityBehavior.prototype.onCastingStart(self, caster)
 end
+function AbilityBehavior.prototype.onWidgetTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onUnitTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onItemTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onDestructibleTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onPointTargetCastingStart(self, caster, x, y)
+end
+function AbilityBehavior.prototype.onNoTargetCastingStart(self, caster)
+end
 function AbilityBehavior.prototype.onCastingFinish(self, caster)
 end
 function AbilityBehavior.prototype.onChannelingStart(self, caster)
@@ -257,6 +349,12 @@ __TS__SetDescriptor(
     Unit.abilityGainedEvent:addListener(createUnitEventListener("onUnitGainAbility"))
     Unit.abilityLostEvent:addListener(createUnitEventListener("onUnitLoseAbility"))
     Unit.abilityCastingStartEvent:addListener(createUnitEventListener("onCastingStart"))
+    Unit.abilityWidgetTargetCastingStartEvent:addListener(createUnitEventListener("onWidgetTargetCastingStart"))
+    Unit.abilityUnitTargetCastingStartEvent:addListener(createUnitEventListener("onUnitTargetCastingStart"))
+    Unit.abilityItemTargetCastingStartEvent:addListener(createUnitEventListener("onItemTargetCastingStart"))
+    Unit.abilityDestructibleTargetCastingStartEvent:addListener(createUnitEventListener("onDestructibleTargetCastingStart"))
+    Unit.abilityPointTargetCastingStartEvent:addListener(createUnitEventListener("onPointTargetCastingStart"))
+    Unit.abilityNoTargetCastingStartEvent:addListener(createUnitEventListener("onNoTargetCastingStart"))
     Unit.abilityCastingFinishEvent:addListener(createUnitEventListener("onCastingFinish"))
     Unit.abilityChannelingStartEvent:addListener(createUnitEventListener("onChannelingStart"))
     Unit.abilityWidgetTargetChannelingStartEvent:addListener(createUnitEventListener("onWidgetTargetChannelingStart"))
@@ -287,6 +385,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/stun-immunity.d.ts

@@ -7,7 +7,7 @@ import { Destructor } from "../../../destroyable";
 import { BehaviorPriority } from "../../behavior";
 export type StunImmunityUnitBehaviorParameters = {
     readonly priority?: BehaviorPriority;
-    buffTypeIds?: LuaSet<BuffTypeId>;
+    buffTypeIds?: readonly BuffTypeId[];
     textTagPreset?: TextTagPreset;
     textTagText?: string;
     additionalAction?: (this: void, unit: Unit) => void;

package/engine/behaviour/unit/stun-immunity.lua

@@ -8,14 +8,15 @@ local UnitBehavior = ____unit.UnitBehavior
 local ____ability_2Dtype = require("engine.object-data.entry.ability-type")
 local AbilityType = ____ability_2Dtype.AbilityType
 local ____arrays = require("utility.arrays")
-local flatMapToLuaSet = ____arrays.flatMapToLuaSet
+local distinct = ____arrays.distinct
+local flatMap = ____arrays.flatMap
 local map = ____arrays.map
 local ____text_2Dtag = require("engine.text-tag")
 local TextTag = ____text_2Dtag.TextTag
 local ____timer = require("core.types.timer")
 local Timer = ____timer.Timer
 local DEFAULT_BUFF_TYPE_IDS = postcompile(function()
-    return flatMapToLuaSet(
+    return distinct(flatMap(
         AbilityType:getAllByBaseIds(map({
             "AHtb",
             "AHbh",
@@ -41,11 +42,11 @@ local DEFAULT_BUFF_TYPE_IDS = postcompile(function()
             "ACcb"
         }, fourCC)),
         function(abilityType) return __TS__ArrayFlat(abilityType.buffTypeIds) end
-    )
+    ))
 end)
 local function process(behavior)
     local hasRemovedBuffs = false
-    for buffTypeId in pairs(behavior.parameters.buffTypeIds or DEFAULT_BUFF_TYPE_IDS) do
+    for ____, buffTypeId in ipairs(behavior.parameters.buffTypeIds or DEFAULT_BUFF_TYPE_IDS) do
         hasRemovedBuffs = hasRemovedBuffs or behavior.unit:removeBuff(buffTypeId)
     end
     if hasRemovedBuffs 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")
@@ -21,6 +22,8 @@ local ____bonus = require("engine.internal.unit.bonus")
 local addOrUpdateOrRemoveUnitBonus = ____bonus.addOrUpdateOrRemoveUnitBonus
 local getUnitBonus = ____bonus.getUnitBonus
 local removeUnitBonus = ____bonus.removeUnitBonus
+local ____linked_2Dmap = require("utility.linked-map")
+local LinkedMap = ____linked_2Dmap.LinkedMap
 local safeCall = warpack.safeCall
 local createBehaviorFunctionsByUnitTypeId = {}
 local behaviorsByOwningPlayerEvent = {}
@@ -79,16 +82,24 @@ function UnitBehavior.prototype.onDestroy(self)
 end
 function UnitBehavior.prototype.getUnitBonus(self, bonusType)
     local ____opt_10 = self._bonusIdByBonusType
-    local bonusId = ____opt_10 and ____opt_10[bonusType]
+    local bonusId = ____opt_10 and ____opt_10:get(bonusType)
     return bonusId == nil and 0 or getUnitBonus(self.object, bonusType, bonusId)
 end
 function UnitBehavior.prototype.addOrUpdateOrRemoveUnitBonus(self, bonusType, value)
     local bonusIdByBonusType = self._bonusIdByBonusType
     if bonusIdByBonusType == nil then
-        bonusIdByBonusType = {}
+        bonusIdByBonusType = __TS__New(LinkedMap)
         self._bonusIdByBonusType = bonusIdByBonusType
     end
-    bonusIdByBonusType[bonusType] = addOrUpdateOrRemoveUnitBonus(self.object, bonusType, bonusIdByBonusType[bonusType], value)
+    bonusIdByBonusType:put(
+        bonusType,
+        addOrUpdateOrRemoveUnitBonus(
+            self.object,
+            bonusType,
+            bonusIdByBonusType:get(bonusType),
+            value
+        )
+    )
 end
 function UnitBehavior.prototype.registerOwningPlayerEvent(self, event, extractPlayer, listener)
     local listenerByBehavior = getOrPut(listenerByBehaviorByOwningPlayerEvent, event, mutableLuaMap)

package/engine/buff.d.ts

@@ -14,6 +14,7 @@ import type { Widget } from "../core/types/widget";
 import { Destructor } from "../destroyable";
 import { Event } from "../event";
 import { AbilityBehavior } from "./behaviour/ability";
+import { SoundPresetId } from "./object-data/entry/sound-preset";
 export type BuffConstructor<T extends Buff<any> = Buff<any>, Args extends any[] = any> = OmitConstructor<typeof Buff<any>> & (new (...args: Args) => T);
 type EnumParameterValueType<T extends number> = T | AbilityEnumLevelField<T>;
 type NumberParameterValueType = number | AbilityNumberField | AbilityNumberLevelField;
@@ -23,6 +24,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,14 +38,7 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     learnLevelMinimum?: number;
     source?: Unit;
     behaviorConstructors?: (new (unit: Unit) => UnitBehavior)[];
-    abilityTypeIds?: Record<AbilityTypeId, {
-        [numberField: (AbilityNumberField | AbilityNumberLevelField) & symbol]: 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;
@@ -54,13 +55,17 @@ 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;
     evasionProbability?: NumberParameterValueType;
     missProbability?: NumberParameterValueType;
     damageFactor?: NumberParameterValueType;
     receivedDamageFactor?: NumberParameterValueType;
+    /** The factor of melee attack damage returned to the attacker, as Spiked Carapace. */
+    returnedMeleeDamageFactor?: NumberParameterValueType;
     receivedMagicDamageFactor?: NumberParameterValueType;
     durationIncreaseOnAutoAttack?: NumberParameterValueType;
     maximumRemainingDuration?: NumberParameterValueType;
@@ -76,12 +81,17 @@ 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;
     explodesOnExpiration?: BooleanParameterValueType;
     abilityCooldownFactor?: NumberParameterValueType;
     uniqueGroup?: BuffUniqueGroup;
+    /** Played on the unit whenever the buff is destroyed, whatever the reason. */
+    destructionSoundPresetId?: SoundPresetId;
 } : BuffParameters & (T extends Buff<infer AdditionalParameters> ? AdditionalParameters : object);
 declare const enum BuffPropertyKey {
     STATE = 100,
@@ -89,52 +99,57 @@ declare const enum BuffPropertyKey {
     SOURCE = 102,
     DURATION = 103,
     UNIQUE_GROUP = 104,
-    EFFECT_MODEL_PATH = 105,
-    SPECIAL_EFFECT_MODEL_PATH = 106,
-    DURATION_INCREASE_ON_AUTO_ATTACK = 107,
-    MAXIMUM_DURATION = 108,
-    MAXIMUM_REMAINING_DURATION = 109,
-    DAMAGE_OVER_DURATION = 110,
-    DAMAGE_PER_INTERVAL = 111,
-    DAMAGE_INTERVAL = 112,
-    REMAINING_DAMAGE_OVER_DURATION = 113,
-    DAMAGE_INTERVAL_TIMER = 114,
-    HEALING_OVER_DURATION = 115,
-    HEALING_PER_INTERVAL = 116,
-    HEALING_INTERVAL = 117,
-    REMAINING_HEALING_OVER_DURATION = 118,
-    HEALING_INTERVAL_TIMER = 119,
-    DAMAGE_ON_EXPIRATION = 120,
-    HEALING_ON_EXPIRATION = 121,
-    DAMAGE_UPON_DEATH_ALLOWED_TARGET_CLASSIFICATIONS = 122,
-    DAMAGE_UPON_DEATH = 123,
-    DAMAGE_UPON_DEATH_RANGE = 124,
-    MEDIUM_DAMAGE_UPON_DEATH = 125,
-    MEDIUM_DAMAGE_UPON_DEATH_RANGE = 126,
-    SMALL_DAMAGE_UPON_DEATH = 127,
-    SMALL_DAMAGE_UPON_DEATH_RANGE = 128,
-    AUTO_ATTACK_COUNT = 129,
-    MAXIMUM_AUTO_ATTACK_COUNT = 130,
-    DAMAGE_DEALT_EVENT_COUNT = 131,
-    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
+    DESTRUCTION_SOUND_PRESET_ID = 105,
+    EFFECT_MODEL_PATH = 106,
+    SPECIAL_EFFECT_MODEL_PATH = 107,
+    DURATION_INCREASE_ON_AUTO_ATTACK = 108,
+    MAXIMUM_DURATION = 109,
+    MAXIMUM_REMAINING_DURATION = 110,
+    DAMAGE_OVER_DURATION = 111,
+    DAMAGE_PER_INTERVAL = 112,
+    DAMAGE_INTERVAL = 113,
+    REMAINING_DAMAGE_OVER_DURATION = 114,
+    DAMAGE_INTERVAL_TIMER = 115,
+    HEALING_OVER_DURATION = 116,
+    HEALING_PER_INTERVAL = 117,
+    HEALING_INTERVAL = 118,
+    REMAINING_HEALING_OVER_DURATION = 119,
+    HEALING_INTERVAL_TIMER = 120,
+    DAMAGE_ON_EXPIRATION = 121,
+    HEALING_ON_EXPIRATION = 122,
+    DAMAGE_UPON_DEATH_ALLOWED_TARGET_CLASSIFICATIONS = 123,
+    DAMAGE_UPON_DEATH = 124,
+    DAMAGE_UPON_DEATH_RANGE = 125,
+    MEDIUM_DAMAGE_UPON_DEATH = 126,
+    MEDIUM_DAMAGE_UPON_DEATH_RANGE = 127,
+    SMALL_DAMAGE_UPON_DEATH = 128,
+    SMALL_DAMAGE_UPON_DEATH_RANGE = 129,
+    AUTO_ATTACK_COUNT = 130,
+    MAXIMUM_AUTO_ATTACK_COUNT = 131,
+    DAMAGE_DEALT_EVENT_COUNT = 132,
+    MAXIMUM_DAMAGE_DEALT_EVENT_COUNT = 133,
+    DAMAGE_RECEIVED_EVENT_COUNT = 134,
+    MAXIMUM_DAMAGE_RECEIVED_EVENT_COUNT = 135,
+    ABSORBED_DAMAGE_FACTOR = 136,
+    MAXIMUM_DAMAGE_ABSORBED = 137,
+    DAMAGE_ABSORBED = 138,
+    DESTROYS_ON_MAXIMUM_DAMAGE_ABSORBED = 139,
+    TURNS_INTO_GHOST = 140,
+    STUNS = 141,
+    IGNORES_STUN_IMMUNITY = 142,
+    DISABLES_AUTO_ATTACK = 143,
+    PROVIDES_INVULNERABILITY = 144,
+    KILLS_ON_EXPIRATION = 145,
+    EXPLODES_ON_EXPIRATION = 146,
+    MISS_PROBABILITY = 147,
+    ABILITY_COOLDOWN_FACTOR = 148,
+    ABILITY_COOLDOWN_MODIFIER = 149
 }
 export declare const enum BuffTypeIdSelectionPolicy {
     LEAST_DURATION = 0
 }
 export type BuffAdditionalParameters = Prohibit<Record<string, any>, keyof BuffParameters>;
-export type BuffConstructorParameters<AdditionalParameters extends BuffAdditionalParameters> = [
+export type BuffConstructorParameters<T extends Buff<BuffAdditionalParameters>> = T extends Buff<infer AdditionalParameters> ? [
     ...typeId: [ApplicableBuffTypeId] | [
         typeIds: ReadonlyNonEmptyArray<ApplicableBuffTypeId>,
         typeIdSelectionPolicy: BuffTypeIdSelectionPolicy
@@ -144,8 +159,10 @@ export type BuffConstructorParameters<AdditionalParameters extends BuffAdditiona
     ...abilityOrParameters: [
         ability?: Ability | AbilityBehavior,
         parameters?: BuffParameters & Omit<AdditionalParameters, keyof BuffParameters>
-    ] | [parameters?: BuffParameters & Omit<AdditionalParameters, keyof BuffParameters>]
-];
+    ] | [
+        parameters?: BuffParameters & Omit<AdditionalParameters, keyof BuffParameters>
+    ]
+] : never;
 export declare class Buff<AdditionalParameters extends Prohibit<Record<string, any>, keyof BuffParameters> = object> extends UnitBehavior {
     private _unit;
     protected readonly __additionalParametersBrand?: AdditionalParameters;
@@ -154,6 +171,7 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     private [BuffPropertyKey.SOURCE]?;
     private [BuffPropertyKey.DURATION];
     private [BuffPropertyKey.UNIQUE_GROUP]?;
+    private [BuffPropertyKey.DESTRUCTION_SOUND_PRESET_ID]?;
     private [BuffPropertyKey.EFFECT_MODEL_PATH];
     private [BuffPropertyKey.SPECIAL_EFFECT_MODEL_PATH];
     private [BuffPropertyKey.DURATION_INCREASE_ON_AUTO_ATTACK]?;
@@ -184,6 +202,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]?;
@@ -198,10 +220,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?;
@@ -209,7 +232,7 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     private readonly [BuffPropertyKey.MISS_PROBABILITY]?;
     private readonly _abilityTypeIds?;
     private _behaviors?;
-    constructor(target: Unit, ...parameters: BuffConstructorParameters<AdditionalParameters>);
+    constructor(target: Unit, ...parameters: BuffConstructorParameters<Buff<AdditionalParameters>>);
     get level(): number;
     get remainingDamageOverDuration(): number;
     set remainingDamageOverDuration(remainingDamageOverDuration: number);
@@ -235,8 +258,14 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set damageFactor(damageFactor: number);
     get receivedDamageFactor(): number;
     set receivedDamageFactor(receivedDamageFactor: number);
+    get returnedMeleeDamageFactor(): number;
+    set returnedMeleeDamageFactor(returnedMeleeDamageFactor: 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;
@@ -265,9 +294,19 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set movementSpeedIncreaseFactor(movementSpeedIncreaseFactor: number);
     get evasionProbability(): number;
     set evasionProbability(evasionProbability: number);
+    get manaRegenerationRateIncreaseFactor(): number;
+    set manaRegenerationRateIncreaseFactor(manaRegenerationRateIncreaseFactor: number);
     get duration(): number;
+    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;
@@ -276,11 +315,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;