warscript 0.0.1-dev.2af030d → 0.0.1-dev.2b3f95e

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

@@ -1,6 +1,17 @@
 /** @noSelfInFile */
-import { AbilityBehavior } from "../ability";
 import { Unit } from "../../internal/unit";
-export declare class InstantImpactAbilityBehavior extends AbilityBehavior {
-    onCastingStart(caster: Unit): void;
+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 {
+    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

@@ -2,24 +2,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
-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
+--- 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, AbilityBehavior)
-function InstantImpactAbilityBehavior.prototype.onCastingStart(self, caster)
-    local manaCost = self:resolveCurrentAbilityDependentValue(MANA_COST_ABILITY_INTEGER_LEVEL_FIELD)
-    local cooldown = self:resolveCurrentAbilityDependentValue(COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD)
-    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)
+__TS__ClassExtends(InstantImpactAbilityBehavior, EmulateImpactAbilityBehavior)
+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

@@ -0,0 +1,9 @@
+/** @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 {
+    constructor(ability: Ability);
+    onCommand(caster: Unit): void;
+}

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

@@ -0,0 +1,26 @@
+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
+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()
+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,25 @@
+/** @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;
+}
+export declare class RemoveBuffsTargetAbilityBehavior 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);
+    onUnitTargetImpact(_: Unit, target: Unit): void;
+}

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

@@ -0,0 +1,49 @@
+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
+____exports.RemoveBuffsTargetAbilityBehavior = __TS__Class()
+local RemoveBuffsTargetAbilityBehavior = ____exports.RemoveBuffsTargetAbilityBehavior
+RemoveBuffsTargetAbilityBehavior.name = "RemoveBuffsTargetAbilityBehavior"
+__TS__ClassExtends(RemoveBuffsTargetAbilityBehavior, AbilityBehavior)
+function RemoveBuffsTargetAbilityBehavior.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 RemoveBuffsTargetAbilityBehavior.prototype.onUnitTargetImpact(self, _, target)
+    target: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/restore-mana.d.ts

@@ -0,0 +1,15 @@
+/** @noSelfInFile */
+import { Ability } from "../../internal/ability";
+import { Unit } from "../../internal/unit";
+import { AbilityDependentValue } from "../../object-field/ability";
+import { AbilityBehavior } from "../ability";
+export declare class RestoreManaSelfAbilityBehavior extends AbilityBehavior {
+    private readonly mana;
+    constructor(ability: Ability, mana: AbilityDependentValue<number>);
+    onImpact(caster: Unit): void;
+}
+export declare class RestoreManaTargetAbilityBehavior extends AbilityBehavior {
+    private readonly mana;
+    constructor(ability: Ability, mana: AbilityDependentValue<number>);
+    onUnitTargetImpact(caster: Unit, target: Unit): void;
+}

package/engine/behaviour/ability/restore-mana.lua

@@ -0,0 +1,29 @@
+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.RestoreManaSelfAbilityBehavior = __TS__Class()
+local RestoreManaSelfAbilityBehavior = ____exports.RestoreManaSelfAbilityBehavior
+RestoreManaSelfAbilityBehavior.name = "RestoreManaSelfAbilityBehavior"
+__TS__ClassExtends(RestoreManaSelfAbilityBehavior, AbilityBehavior)
+function RestoreManaSelfAbilityBehavior.prototype.____constructor(self, ability, mana)
+    AbilityBehavior.prototype.____constructor(self, ability)
+    self.mana = mana
+end
+function RestoreManaSelfAbilityBehavior.prototype.onImpact(self, caster)
+    caster.mana = caster.mana + self:resolveCurrentAbilityDependentValue(self.mana)
+end
+____exports.RestoreManaTargetAbilityBehavior = __TS__Class()
+local RestoreManaTargetAbilityBehavior = ____exports.RestoreManaTargetAbilityBehavior
+RestoreManaTargetAbilityBehavior.name = "RestoreManaTargetAbilityBehavior"
+__TS__ClassExtends(RestoreManaTargetAbilityBehavior, AbilityBehavior)
+function RestoreManaTargetAbilityBehavior.prototype.____constructor(self, ability, mana)
+    AbilityBehavior.prototype.____constructor(self, ability)
+    self.mana = mana
+end
+function RestoreManaTargetAbilityBehavior.prototype.onUnitTargetImpact(self, caster, target)
+    target.mana = target.mana + self:resolveCurrentAbilityDependentValue(self.mana)
+end
+return ____exports

package/engine/behaviour/ability.d.ts

@@ -1,24 +1,60 @@
 /** @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";
 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 declare abstract class AbilityBehavior<PeriodicActionParameters extends any[] = any[]> extends Behavior<Ability, PeriodicActionParameters> {
-    constructor(ability: Ability);
+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, parameters?: AbilityBehaviorParameters);
+    protected onDestroy(): Destructor;
+    protected subscribe<T extends boolean | number | string>(value: SubscribableAbilityDependentValue<T>): void;
+    protected registerCommandEvent(orderTypeStringId?: string): void;
     get ability(): Ability;
+    get unit(): Unit | undefined;
     protected resolveCurrentAbilityDependentValue<T extends boolean | number | string>(value: AbilityDependentValue<T>): T;
-    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;
+    protected resolveCurrentAbilityDependentValue<T extends boolean | number | string>(value?: AbilityDependentValue<T>): T | undefined;
+    protected getDuration(widget: Widget): number;
+    flashCasterEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    flashTargetEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    flashAreaEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    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;
     onUnitGainAbility(_unit: Unit): void;
     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;