warscript 0.0.1-dev.4363c65 → 0.0.1-dev.46a1ede

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

@@ -2,28 +2,13 @@ local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
-local ____ability = require("engine.behaviour.ability")
-local AbilityBehavior = ____ability.AbilityBehavior
-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 ____emulate_2Dimpact = require("engine.behaviour.ability.emulate-impact")
+local EmulateImpactAbilityBehavior = ____emulate_2Dimpact.EmulateImpactAbilityBehavior
 ____exports.InstantImpactAbilityBehavior = __TS__Class()
 local InstantImpactAbilityBehavior = ____exports.InstantImpactAbilityBehavior
 InstantImpactAbilityBehavior.name = "InstantImpactAbilityBehavior"
-__TS__ClassExtends(InstantImpactAbilityBehavior, AbilityBehavior)
+__TS__ClassExtends(InstantImpactAbilityBehavior, EmulateImpactAbilityBehavior)
 function InstantImpactAbilityBehavior.prototype.onCastingStart(self, caster)
-    local abilityTypeId = self.ability.typeId
-    local manaCost = self:resolveCurrentAbilityDependentValue(MANA_COST_ABILITY_INTEGER_LEVEL_FIELD)
-    local cooldown = self:resolveCurrentAbilityDependentValue(COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD)
-    if caster:getAbilityRemainingCooldown(abilityTypeId) ~= 0 or caster.mana < manaCost then
-        return
-    end
-    caster.mana = caster.mana - manaCost
-    if cooldown == 0 then
-        caster:interruptCast(self.ability.typeId)
-    else
-        caster:startAbilityCooldown(self.ability.typeId, cooldown)
-    end
-    AbilityBehavior:forAll(self.ability, "onImpact", caster)
+    self:emulateImpact(caster)
 end
 return ____exports

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

@@ -0,0 +1,8 @@
+/** @noSelfInFile */
+import { Unit } from "../../internal/unit";
+import { EmulateImpactAbilityBehavior } from "./emulate-impact";
+import { Ability } from "../../internal/ability";
+export declare class OnCommandImpactAbilityBehavior extends EmulateImpactAbilityBehavior {
+    constructor(ability: Ability);
+    onCommand(caster: Unit): void;
+}

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

@@ -0,0 +1,25 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local ____exports = {}
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
+local ____emulate_2Dimpact = require("engine.behaviour.ability.emulate-impact")
+local EmulateImpactAbilityBehavior = ____emulate_2Dimpact.EmulateImpactAbilityBehavior
+____exports.OnCommandImpactAbilityBehavior = __TS__Class()
+local OnCommandImpactAbilityBehavior = ____exports.OnCommandImpactAbilityBehavior
+OnCommandImpactAbilityBehavior.name = "OnCommandImpactAbilityBehavior"
+__TS__ClassExtends(OnCommandImpactAbilityBehavior, EmulateImpactAbilityBehavior)
+function OnCommandImpactAbilityBehavior.prototype.____constructor(self, ability)
+    EmulateImpactAbilityBehavior.prototype.____constructor(self, ability)
+    self:registerCommandEvent()
+end
+function OnCommandImpactAbilityBehavior.prototype.onCommand(self, caster)
+    self:emulateImpact(caster)
+end
+Unit.itemUseOrderEvent:addListener(function(unit, item)
+    for ____, ability in ipairs(item.abilities) do
+        ____exports.OnCommandImpactAbilityBehavior:forAll(ability, "onCommand", unit)
+    end
+end)
+return ____exports

package/engine/behaviour/ability/remove-buffs.d.ts

@@ -0,0 +1,16 @@
+/** @noSelfInFile */
+import { AbilityBehavior } from "../ability";
+import { Unit } from "../../internal/unit";
+import { Ability } from "../../internal/ability";
+import { AbilityDependentValue } from "../../object-field/ability";
+import { BuffPolarity } from "../../object-data/auxiliary/buff-polarity";
+import { BuffResistanceType } from "../../object-data/auxiliary/buff-resistance-type";
+export declare class RemoveBuffsSelfAbilityBehavior extends AbilityBehavior {
+    private readonly polarity?;
+    private readonly resistanceType?;
+    private readonly includeExpirationTimers?;
+    private readonly includeAuras?;
+    private readonly autoDispel?;
+    constructor(ability: Ability, polarity?: AbilityDependentValue<BuffPolarity> | undefined, resistanceType?: AbilityDependentValue<BuffResistanceType> | undefined, includeExpirationTimers?: AbilityDependentValue<boolean> | undefined, includeAuras?: AbilityDependentValue<boolean> | undefined, autoDispel?: AbilityDependentValue<boolean> | undefined);
+    onImpact(caster: Unit): void;
+}

package/engine/behaviour/ability/remove-buffs.lua

@@ -0,0 +1,28 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local ____exports = {}
+local ____ability = require("engine.behaviour.ability")
+local AbilityBehavior = ____ability.AbilityBehavior
+____exports.RemoveBuffsSelfAbilityBehavior = __TS__Class()
+local RemoveBuffsSelfAbilityBehavior = ____exports.RemoveBuffsSelfAbilityBehavior
+RemoveBuffsSelfAbilityBehavior.name = "RemoveBuffsSelfAbilityBehavior"
+__TS__ClassExtends(RemoveBuffsSelfAbilityBehavior, AbilityBehavior)
+function RemoveBuffsSelfAbilityBehavior.prototype.____constructor(self, ability, polarity, resistanceType, includeExpirationTimers, includeAuras, autoDispel)
+    AbilityBehavior.prototype.____constructor(self, ability)
+    self.polarity = polarity
+    self.resistanceType = resistanceType
+    self.includeExpirationTimers = includeExpirationTimers
+    self.includeAuras = includeAuras
+    self.autoDispel = autoDispel
+end
+function RemoveBuffsSelfAbilityBehavior.prototype.onImpact(self, caster)
+    caster:removeBuffs(
+        self:resolveCurrentAbilityDependentValue(self.polarity),
+        self:resolveCurrentAbilityDependentValue(self.resistanceType),
+        self:resolveCurrentAbilityDependentValue(self.includeExpirationTimers),
+        self:resolveCurrentAbilityDependentValue(self.includeAuras),
+        self:resolveCurrentAbilityDependentValue(self.autoDispel)
+    )
+end
+return ____exports

package/engine/behaviour/ability.d.ts

@@ -7,24 +7,36 @@ import { Widget } from "../../core/types/widget";
 import { Item } from "../internal/item";
 import { Destructable } from "../../core/types/destructable";
 import { EffectParameters } from "../../core/types/effect";
-import { AbilityDependentValue } from "../object-field/ability";
+import { AbilityDependentValue, ReadonlySubscribableAbilityDependentValue, SubscribableAbilityDependentValue } from "../object-field/ability";
+import { Destructor } from "../../destroyable";
 export type AbilityBehaviorConstructor<Args extends any[]> = new (ability: Ability, ...args: Args) => AbilityBehavior;
+export type AbilityBehaviorParameters = {
+    isExclusiveOnImpactHandler?: boolean;
+};
 export declare abstract class AbilityBehavior<Parameters extends {
     periodicActionParameters?: any[];
     missileParameters?: any[];
 } = {}> extends Behavior<Ability, NonNullable<Parameters["periodicActionParameters"]>> {
-    constructor(ability: Ability);
+    constructor(ability: Ability, parameters?: AbilityBehaviorParameters);
+    protected onDestroy(): Destructor;
+    protected subscribe<T extends boolean | number | string>(value: SubscribableAbilityDependentValue<T>): void;
+    protected registerCommandEvent(orderTypeStringId?: string): void;
     get ability(): Ability;
     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: [...pointOrWidget: [x: number, y: number] | [widget: Widget], duration?: number]): void;
     private static MissileLaunchConfig;
     private get missileLaunchConfig();
-    protected launchMissile(source: Unit, target: Unit, ...parameters: NonNullable<Parameters["missileParameters"]>): void;
+    protected onCreate(): void;
+    onValueChange(_value: ReadonlySubscribableAbilityDependentValue<string | number | boolean>): void;
     onMissileArrival(...parameters: NonNullable<Parameters["missileParameters"]>): void;
     onUnitGainAbility(_unit: Unit): void;
     onUnitLoseAbility(_unit: Unit): void;
+    onCommand(caster: Unit, orderTypeStringId: string): void;
     onCastingStart(caster: Unit): void;
     onCastingFinish(caster: Unit): void;
     onChannelingStart(caster: Unit): void;

package/engine/behaviour/ability.lua

@@ -1,9 +1,11 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__InstanceOf = ____lualib.__TS__InstanceOf
 local __TS__New = ____lualib.__TS__New
 local __TS__SetDescriptor = ____lualib.__TS__SetDescriptor
 local ____exports = {}
+local createUnitEventListener
 local ____behavior = require("engine.behavior")
 local Behavior = ____behavior.Behavior
 local ____unit = require("engine.unit")
@@ -14,31 +16,44 @@ 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_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 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_FIRST_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD
+local TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
 local ____ability = require("engine.object-field.ability")
+local AbilityField = ____ability.AbilityField
+local AbilityLevelField = ____ability.AbilityLevelField
 local resolveCurrentAbilityDependentValue = ____ability.resolveCurrentAbilityDependentValue
 local ____timer = require("core.types.timer")
 local Timer = ____timer.Timer
-local ____missile = require("core.types.missile")
-local Missile = ____missile.Missile
 local createBehaviorFunctionsByAbilityTypeId = {}
-local function invokeOnMissileArrival(_missile, success, abilityBehavior, ...)
-    if success then
-        abilityBehavior:onMissileArrival(...)
+local exclusiveOnImpactHandlerAbilityBehaviorByAbility = setmetatable({}, {__mode = "k"})
+local function createZeroTimerUnitEventListener(key)
+    local unitEventListener = createUnitEventListener(key)
+    return function(unit, ability, ...)
+        Timer:run(unitEventListener, unit, ability, ...)
     end
 end
-local ____class_0 = __TS__Class()
-____class_0.name = ""
-function ____class_0.prototype.____constructor(self, abilityBehavior)
+createUnitEventListener = function(key)
+    return function(unit, ability, ...)
+        ____exports.AbilityBehavior:forAll(ability, key, unit, ...)
+    end
+end
+local registeredCommandEventIds = {}
+local subscribedValuesByAbilityBehavior = {}
+local ____class_2 = __TS__Class()
+____class_2.name = ""
+function ____class_2.prototype.____constructor(self, abilityBehavior)
     self.abilityBehavior = abilityBehavior
 end
 __TS__SetDescriptor(
-    ____class_0.prototype,
+    ____class_2.prototype,
     "art",
     {get = function(self)
         return MISSILE_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD:getValue(self.abilityBehavior.ability, 0)
@@ -46,7 +61,7 @@ __TS__SetDescriptor(
     true
 )
 __TS__SetDescriptor(
-    ____class_0.prototype,
+    ____class_2.prototype,
     "arc",
     {get = function(self)
         return MISSILE_ARC_ABILITY_FLOAT_FIELD:getValue(self.abilityBehavior.ability)
@@ -54,7 +69,7 @@ __TS__SetDescriptor(
     true
 )
 __TS__SetDescriptor(
-    ____class_0.prototype,
+    ____class_2.prototype,
     "speed",
     {get = function(self)
         return MISSILE_SPEED_ABILITY_INTEGER_FIELD:getValue(self.abilityBehavior.ability)
@@ -65,12 +80,58 @@ ____exports.AbilityBehavior = __TS__Class()
 local AbilityBehavior = ____exports.AbilityBehavior
 AbilityBehavior.name = "AbilityBehavior"
 __TS__ClassExtends(AbilityBehavior, Behavior)
-function AbilityBehavior.prototype.____constructor(self, ability)
+function AbilityBehavior.prototype.____constructor(self, ability, parameters)
     Behavior.prototype.____constructor(self, ability)
+    if parameters and parameters.isExclusiveOnImpactHandler then
+        exclusiveOnImpactHandlerAbilityBehaviorByAbility[ability] = self
+    end
+    self:onCreate()
+end
+function AbilityBehavior.prototype.onDestroy(self)
+    subscribedValuesByAbilityBehavior[self] = nil
+    return Behavior.prototype.onDestroy(self)
+end
+function AbilityBehavior.prototype.subscribe(self, value)
+    if __TS__InstanceOf(value, AbilityField) or __TS__InstanceOf(value, AbilityLevelField) then
+        local subscribedValues = subscribedValuesByAbilityBehavior[self]
+        if subscribedValues == nil then
+            subscribedValues = {}
+            subscribedValuesByAbilityBehavior[self] = subscribedValues
+        end
+        subscribedValues[value] = true
+    end
+end
+function AbilityBehavior.prototype.registerCommandEvent(self, orderTypeStringId)
+    if orderTypeStringId == nil then
+        orderTypeStringId = self.ability.orderTypeStringId
+    end
+    local commandEventId = (tostring(self.ability.typeId) .. "#") .. orderTypeStringId
+    if not (registeredCommandEventIds[commandEventId] ~= nil) then
+        registeredCommandEventIds[commandEventId] = true
+        Unit.abilityCommandEvent[self.ability.typeId][orderTypeStringId]:addListener(createUnitEventListener("onCommand"))
+    end
 end
 function AbilityBehavior.prototype.resolveCurrentAbilityDependentValue(self, value)
     return resolveCurrentAbilityDependentValue(self.ability, value)
 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),
+        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),
+        widget,
+        attachmentPoint ~= "" and attachmentPoint or "origin",
+        ...
+    )
+end
 function AbilityBehavior.prototype.flashAreaEffect(self, x, y, ...)
     Effect:flash(
         AREA_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD:getValue(self.ability, 0),
@@ -96,23 +157,18 @@ function AbilityBehavior.prototype.flashSpecialEffect(self, xOrWidget, yOrDurati
             duration
         )
     else
+        local attachmentPoint = SPECIAL_EFFECT_ATTACHMENT_POINT_STRING_FIELD:getValue(self.ability)
         Effect:flash(
             SPECIAL_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD:getValue(self.ability, 0),
             xOrWidget,
-            SPECIAL_EFFECT_ATTACHMENT_POINT_STRING_FIELD:getValue(self.ability),
+            attachmentPoint ~= "" and attachmentPoint or "origin",
             yOrDuration
         )
     end
 end
-function AbilityBehavior.prototype.launchMissile(self, source, target, ...)
-    Missile:launch(
-        self.missileLaunchConfig,
-        source,
-        target,
-        invokeOnMissileArrival,
-        self,
-        ...
-    )
+function AbilityBehavior.prototype.onCreate(self)
+end
+function AbilityBehavior.prototype.onValueChange(self, _value)
 end
 function AbilityBehavior.prototype.onMissileArrival(self, ...)
 end
@@ -120,6 +176,8 @@ function AbilityBehavior.prototype.onUnitGainAbility(self, _unit)
 end
 function AbilityBehavior.prototype.onUnitLoseAbility(self, _unit)
 end
+function AbilityBehavior.prototype.onCommand(self, caster, orderTypeStringId)
+end
 function AbilityBehavior.prototype.onCastingStart(self, caster)
 end
 function AbilityBehavior.prototype.onCastingFinish(self, caster)
@@ -179,7 +237,7 @@ __TS__SetDescriptor(
     end},
     true
 )
-AbilityBehavior.MissileLaunchConfig = ____class_0
+AbilityBehavior.MissileLaunchConfig = ____class_2
 __TS__SetDescriptor(
     AbilityBehavior.prototype,
     "missileLaunchConfig",
@@ -191,17 +249,6 @@ __TS__SetDescriptor(
     true
 );
 (function(self)
-    local function createUnitEventListener(key)
-        return function(unit, ability, ...)
-            ____exports.AbilityBehavior:forAll(ability, key, unit, ...)
-        end
-    end
-    local function createZeroTimerUnitEventListener(key)
-        local unitEventListener = createUnitEventListener(key)
-        return function(unit, ability, ...)
-            Timer:run(unitEventListener, unit, ability, ...)
-        end
-    end
     Unit.abilityGainedEvent:addListener(createUnitEventListener("onUnitGainAbility"))
     Unit.abilityLostEvent:addListener(createUnitEventListener("onUnitLoseAbility"))
     Unit.abilityCastingStartEvent:addListener(createUnitEventListener("onCastingStart"))
@@ -223,6 +270,18 @@ __TS__SetDescriptor(
     Unit.abilityChannelingFinishEvent:addListener(createUnitEventListener("onChannelingFinish"))
     Unit.abilityStopEvent:addListener(createUnitEventListener("onStop"))
 end)(AbilityBehavior)
+local function checkBehaviorOnValueChange(behavior, field)
+    local subscribedValues = subscribedValuesByAbilityBehavior[behavior]
+    if subscribedValues ~= nil and subscribedValues[field] ~= nil then
+        behavior:onValueChange(field)
+    end
+end
+AbilityField.valueChangeEvent:addListener(function(ability, field)
+    ____exports.AbilityBehavior:forAll(ability, checkBehaviorOnValueChange, field)
+end)
+AbilityLevelField.valueChangeEvent:addListener(function(ability, field)
+    ____exports.AbilityBehavior:forAll(ability, checkBehaviorOnValueChange, field)
+end)
 Ability.onCreate:addListener(function(ability)
     local createBehaviorFunctions = createBehaviorFunctionsByAbilityTypeId[ability.typeId]
     if createBehaviorFunctions ~= nil then

package/engine/behaviour/unit.d.ts

@@ -4,6 +4,7 @@ import { Ability } from "../internal/ability";
 import { DamageEvent, DamagingEvent, Unit } from "../internal/unit";
 import "../internal/unit+ability";
 import "../internal/unit-missile-launch";
+import { Item } from "../internal/item";
 export type UnitBehaviorConstructor<Args extends any[]> = new (unit: Unit, ...args: Args) => UnitBehavior;
 export declare abstract class UnitBehavior<PeriodicActionParameters extends any[] = any[]> extends Behavior<Unit, PeriodicActionParameters> {
     constructor(unit: Unit);
@@ -16,6 +17,10 @@ export declare abstract class UnitBehavior<PeriodicActionParameters extends any[
     onDamageReceived(source: Unit | undefined, event: DamageEvent): void;
     onAbilityGained(ability: Ability): void;
     onAbilityLost(ability: Ability): void;
+    onItemDropped(item: Item): void;
+    onItemPickedUp(item: Item): void;
+    onItemUsed(item: Item): void;
+    onItemStacked(item: Item): void;
     onKill(target: Unit): void;
     onDeath(source: Unit | undefined): void;
 }

package/engine/behaviour/unit.lua

@@ -32,6 +32,14 @@ function UnitBehavior.prototype.onAbilityGained(self, ability)
 end
 function UnitBehavior.prototype.onAbilityLost(self, ability)
 end
+function UnitBehavior.prototype.onItemDropped(self, item)
+end
+function UnitBehavior.prototype.onItemPickedUp(self, item)
+end
+function UnitBehavior.prototype.onItemUsed(self, item)
+end
+function UnitBehavior.prototype.onItemStacked(self, item)
+end
 function UnitBehavior.prototype.onKill(self, target)
 end
 function UnitBehavior.prototype.onDeath(self, source)
@@ -75,6 +83,18 @@ __TS__SetDescriptor(
         end
         ____exports.UnitBehavior:forAll(target, "onDeath", source)
     end)
+    Unit.itemDroppedEvent:addListener(function(unit, item)
+        ____exports.UnitBehavior:forAll(unit, "onItemDropped", item)
+    end)
+    Unit.itemPickedUpEvent:addListener(function(unit, item)
+        ____exports.UnitBehavior:forAll(unit, "onItemPickedUp", item)
+    end)
+    Unit.itemUsedEvent:addListener(function(unit, item)
+        ____exports.UnitBehavior:forAll(unit, "onItemUsed", item)
+    end)
+    Unit.itemStackedEvent:addListener(function(unit, item)
+        ____exports.UnitBehavior:forAll(unit, "onItemStacked", item)
+    end)
 end)(UnitBehavior)
 Unit.destroyEvent:addListener(function(unit)
     ____exports.UnitBehavior:forAll(unit, "destroy")

package/engine/buff.d.ts

@@ -5,16 +5,21 @@ import { Ability } from "./internal/ability";
 import { AbilityTypeId } from "./object-data/entry/ability-type";
 import { BuffPolarity } from "./object-data/auxiliary/buff-polarity";
 import { BuffResistanceType } from "./object-data/auxiliary/buff-resistance-type";
-import { AbilityBooleanField, AbilityBooleanLevelField, AbilityCombatClassificationsLevelField, AbilityDependentValue, AbilityIntegerField, AbilityIntegerLevelField, AbilityNumberField, AbilityNumberLevelField } from "./object-field/ability";
+import { AbilityBooleanField, AbilityBooleanLevelField, AbilityCombatClassificationsLevelField, AbilityDependentValue, AbilityEnumLevelField, AbilityIntegerField, AbilityIntegerLevelField, AbilityNumberField, AbilityNumberLevelField } from "./object-field/ability";
 import { CombatClassifications } from "./object-data/auxiliary/combat-classification";
-import { IsExactlyAny, NonEmptyArray, Prohibit } from "../utility/types";
+import { IsExactlyAny, Prohibit, ReadonlyNonEmptyArray } from "../utility/types";
+import { EffectParameters } from "../core/types/effect";
 import { UnitBehavior } from "./behaviour/unit";
 import type { Widget } from "../core/types/widget";
 import { Destructor } from "../destroyable";
+import { Event } from "../event";
 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;
 type IntegerParameterValueType = number | AbilityIntegerField | AbilityIntegerLevelField;
 type BooleanParameterValueType = boolean | AbilityBooleanField | AbilityBooleanLevelField;
+export type BuffPolarityParameterType = EnumParameterValueType<BuffPolarity>;
+export type BuffResistanceTypeParameterType = EnumParameterValueType<BuffResistanceType>;
 export declare class BuffUniqueGroup {
 }
 export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
@@ -51,6 +56,8 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     armorIncreaseFactor?: NumberParameterValueType;
     attackSpeedIncreaseFactor?: NumberParameterValueType;
     movementSpeedIncreaseFactor?: NumberParameterValueType;
+    evasionProbability?: NumberParameterValueType;
+    damageFactor?: NumberParameterValueType;
     receivedDamageFactor?: NumberParameterValueType;
     receivedMagicDamageFactor?: NumberParameterValueType;
     durationIncreaseOnAutoAttack?: NumberParameterValueType;
@@ -73,46 +80,47 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     uniqueGroup?: BuffUniqueGroup;
 } : BuffParameters & (T extends Buff<infer AdditionalParameters> ? AdditionalParameters : object);
 declare const enum BuffPropertyKey {
-    UNIT = 100,
-    SOURCE = 101,
-    DURATION = 102,
-    UNIQUE_GROUP = 103,
-    EFFECT_MODEL_PATH = 104,
-    SPECIAL_EFFECT_MODEL_PATH = 105,
-    DURATION_INCREASE_ON_AUTO_ATTACK = 106,
-    MAXIMUM_DURATION = 107,
-    MAXIMUM_REMAINING_DURATION = 108,
-    DAMAGE_OVER_DURATION = 109,
-    DAMAGE_PER_INTERVAL = 110,
-    DAMAGE_INTERVAL = 111,
-    REMAINING_DAMAGE_OVER_DURATION = 112,
-    DAMAGE_INTERVAL_TIMER = 113,
-    HEALING_OVER_DURATION = 114,
-    HEALING_PER_INTERVAL = 115,
-    HEALING_INTERVAL = 116,
-    REMAINING_HEALING_OVER_DURATION = 117,
-    HEALING_INTERVAL_TIMER = 118,
-    DAMAGE_ON_EXPIRATION = 119,
-    HEALING_ON_EXPIRATION = 120,
-    DAMAGE_UPON_DEATH_ALLOWED_TARGET_CLASSIFICATIONS = 121,
-    DAMAGE_UPON_DEATH = 122,
-    DAMAGE_UPON_DEATH_RANGE = 123,
-    MEDIUM_DAMAGE_UPON_DEATH = 124,
-    MEDIUM_DAMAGE_UPON_DEATH_RANGE = 125,
-    SMALL_DAMAGE_UPON_DEATH = 126,
-    SMALL_DAMAGE_UPON_DEATH_RANGE = 127,
-    AUTO_ATTACK_COUNT = 128,
-    MAXIMUM_AUTO_ATTACK_COUNT = 129,
-    DAMAGE_DEALT_EVENT_COUNT = 130,
-    MAXIMUM_DAMAGE_DEALT_EVENT_COUNT = 131,
-    DAMAGE_RECEIVED_EVENT_COUNT = 132,
-    MAXIMUM_DAMAGE_RECEIVED_EVENT_COUNT = 133,
-    STUNS = 134,
-    IGNORES_STUN_IMMUNITY = 135,
-    DISABLES_AUTO_ATTACK = 136,
-    PROVIDES_INVULNERABILITY = 137,
-    KILLS_ON_EXPIRATION = 138,
-    EXPLODES_ON_EXPIRATION = 139
+    STATE = 100,
+    UNIT = 101,
+    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,
+    STUNS = 135,
+    IGNORES_STUN_IMMUNITY = 136,
+    DISABLES_AUTO_ATTACK = 137,
+    PROVIDES_INVULNERABILITY = 138,
+    KILLS_ON_EXPIRATION = 139,
+    EXPLODES_ON_EXPIRATION = 140
 }
 export declare const enum BuffTypeIdSelectionPolicy {
     LEAST_DURATION = 0
@@ -120,11 +128,11 @@ export declare const enum BuffTypeIdSelectionPolicy {
 export type BuffAdditionalParameters = Prohibit<Record<string, any>, keyof BuffParameters>;
 export type BuffConstructorParameters<AdditionalParameters extends BuffAdditionalParameters> = [
     ...typeId: [ApplicableBuffTypeId] | [
-        typeIds: NonEmptyArray<ApplicableBuffTypeId>,
+        typeIds: ReadonlyNonEmptyArray<ApplicableBuffTypeId>,
         typeIdSelectionPolicy: BuffTypeIdSelectionPolicy
     ],
-    polarity: BuffPolarity,
-    resistanceType: BuffResistanceType,
+    polarity: BuffPolarityParameterType,
+    resistanceType: BuffResistanceTypeParameterType,
     ...abilityOrParameters: [
         ability: Ability,
         parameters?: BuffParameters & Omit<AdditionalParameters, keyof BuffParameters>
@@ -133,6 +141,7 @@ export type BuffConstructorParameters<AdditionalParameters extends BuffAdditiona
 export declare class Buff<AdditionalParameters extends Prohibit<Record<string, any>, keyof BuffParameters> = object> extends UnitBehavior {
     private _unit;
     protected readonly __additionalParametersBrand?: AdditionalParameters;
+    private [BuffPropertyKey.STATE];
     private [BuffPropertyKey.UNIT];
     private [BuffPropertyKey.SOURCE]?;
     private [BuffPropertyKey.DURATION];
@@ -213,6 +222,8 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set damageOnExpiration(damageOnExpiration: number);
     get healingOnExpiration(): number;
     set healingOnExpiration(healingOnExpiration: number);
+    get damageFactor(): number;
+    set damageFactor(damageFactor: number);
     get receivedDamageFactor(): number;
     set receivedDamageFactor(receivedDamageFactor: number);
     get armorIncrease(): number;
@@ -241,11 +252,17 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set attackSpeedIncreaseFactor(attackSpeedIncreaseFactor: number);
     get movementSpeedIncreaseFactor(): number;
     set movementSpeedIncreaseFactor(movementSpeedIncreaseFactor: number);
+    get evasionProbability(): number;
+    set evasionProbability(evasionProbability: number);
     get duration(): number;
     get remainingDuration(): number;
     set remainingDuration(remainingDuration: number);
-    flashEffect(...parameters: [...widget: [] | [Widget], ...duration: [] | [number]]): void;
+    flashEffect(...parameters: [
+        ...widgetOrXY: [] | [Widget] | [x: number, x: number],
+        ...parametersOrDuration: [] | [EffectParameters] | [number]
+    ]): void;
     flashSpecialEffect(...parameters: [...widget: [] | [Widget], ...duration: [] | [number]]): 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;
@@ -253,5 +270,6 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     onDeath(source: Unit | undefined): void;
     onDamageDealt(target: Unit, event: DamageEvent): void;
     onDamageReceived(source: Unit | undefined, event: DamageEvent): void;
+    static readonly destroyEvent: Event<[Buff<object>]>;
 }
 export {};