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

package/engine/buff.d.ts

@@ -5,18 +5,32 @@ 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";
+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;
 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 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;
@@ -24,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;
@@ -48,14 +55,22 @@ 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;
     maximumDuration?: NumberParameterValueType;
+    turnsIntoGhost?: BooleanParameterValueType;
     stuns?: BooleanParameterValueType;
     ignoresStunImmunity?: BooleanParameterValueType;
     providesStunImmunity?: BooleanParameterValueType;
@@ -64,65 +79,107 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     disablesAutoAttack?: BooleanParameterValueType;
     destroysOnDamage?: BooleanParameterValueType;
     maximumAutoAttackCount?: IntegerParameterValueType;
+    maximumDamageDealtEventCount?: IntegerParameterValueType;
+    maximumDamageReceivedEventCount?: IntegerParameterValueType;
+    absorbedDamageFactor?: NumberParameterValueType;
+    maximumDamageAbsorbed?: NumberParameterValueType;
+    destroysOnMaximumDamageAbsorbed?: BooleanParameterValueType;
+    damageOnExpiration?: NumberParameterValueType;
+    healingOnExpiration?: NumberParameterValueType;
+    killsOnExpiration?: BooleanParameterValueType;
+    explodesOnExpiration?: BooleanParameterValueType;
+    abilityCooldownFactor?: NumberParameterValueType;
+    /**
+     * Makes the unit visible to the owner of the source, and through the engine to the
+     * players that owner shares vision with (`UnitShareVision`). Only the unit itself
+     * becomes visible, not the area it sees. The owner is taken when the buff is applied.
+     */
+    sharesVisionWithSource?: BooleanParameterValueType;
     uniqueGroup?: BuffUniqueGroup;
-} : BuffParameters & (T extends Buff<infer AdditionalParameters> ? AdditionalParameters : {});
+    /** 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 {
-    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_UPON_DEATH_ALLOWED_TARGET_CLASSIFICATIONS = 119,
-    DAMAGE_UPON_DEATH = 120,
-    DAMAGE_UPON_DEATH_RANGE = 121,
-    MEDIUM_DAMAGE_UPON_DEATH = 122,
-    MEDIUM_DAMAGE_UPON_DEATH_RANGE = 123,
-    SMALL_DAMAGE_UPON_DEATH = 124,
-    SMALL_DAMAGE_UPON_DEATH_RANGE = 125,
-    AUTO_ATTACK_COUNT = 126,
-    MAXIMUM_AUTO_ATTACK_COUNT = 127,
-    STUNS = 128,
-    IGNORES_STUN_IMMUNITY = 129,
-    DISABLES_AUTO_ATTACK = 130,
-    PROVIDES_INVULNERABILITY = 131
+    STATE = 100,
+    UNIT = 101,
+    SOURCE = 102,
+    DURATION = 103,
+    UNIQUE_GROUP = 104,
+    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,
+    SHARES_VISION_WITH_SOURCE = 150,
+    VISION_PLAYER = 151
 }
 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: NonEmptyArray<ApplicableBuffTypeId>,
+        typeIds: ReadonlyNonEmptyArray<ApplicableBuffTypeId>,
         typeIdSelectionPolicy: BuffTypeIdSelectionPolicy
     ],
-    polarity: BuffPolarity,
-    resistanceType: BuffResistanceType,
+    polarity: BuffPolarityParameterType,
+    resistanceType: BuffResistanceTypeParameterType,
     ...abilityOrParameters: [
-        ability: Ability,
+        ability?: Ability | AbilityBehavior,
         parameters?: BuffParameters & Omit<AdditionalParameters, keyof BuffParameters>
-    ] | [parameters?: BuffParameters & Omit<AdditionalParameters, keyof BuffParameters>]
-];
-export declare class Buff<AdditionalParameters extends Prohibit<Record<string, any>, keyof BuffParameters> = {}> extends UnitBehavior {
+    ] | [
+        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;
+    private [BuffPropertyKey.STATE];
     private [BuffPropertyKey.UNIT];
     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]?;
@@ -138,6 +195,8 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     private [BuffPropertyKey.HEALING_INTERVAL]?;
     private [BuffPropertyKey.REMAINING_HEALING_OVER_DURATION]?;
     private [BuffPropertyKey.HEALING_INTERVAL_TIMER]?;
+    private [BuffPropertyKey.DAMAGE_ON_EXPIRATION]?;
+    private [BuffPropertyKey.HEALING_ON_EXPIRATION]?;
     private [BuffPropertyKey.DAMAGE_UPON_DEATH_ALLOWED_TARGET_CLASSIFICATIONS]?;
     private [BuffPropertyKey.DAMAGE_UPON_DEATH]?;
     private [BuffPropertyKey.DAMAGE_UPON_DEATH_RANGE]?;
@@ -147,29 +206,43 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     private [BuffPropertyKey.SMALL_DAMAGE_UPON_DEATH_RANGE]?;
     private [BuffPropertyKey.MAXIMUM_AUTO_ATTACK_COUNT]?;
     private [BuffPropertyKey.AUTO_ATTACK_COUNT]?;
+    private [BuffPropertyKey.MAXIMUM_DAMAGE_DEALT_EVENT_COUNT]?;
+    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]?;
     private [BuffPropertyKey.DISABLES_AUTO_ATTACK]?;
     private [BuffPropertyKey.PROVIDES_INVULNERABILITY]?;
+    private [BuffPropertyKey.KILLS_ON_EXPIRATION]?;
+    private [BuffPropertyKey.EXPLODES_ON_EXPIRATION]?;
+    private [BuffPropertyKey.ABILITY_COOLDOWN_FACTOR]?;
+    private [BuffPropertyKey.ABILITY_COOLDOWN_MODIFIER]?;
+    private [BuffPropertyKey.SHARES_VISION_WITH_SOURCE]?;
+    private [BuffPropertyKey.VISION_PLAYER]?;
     protected static readonly defaultParameters: BuffParameters;
     get source(): Unit;
     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?;
     private readonly _learnLevelMinimum?;
-    private _bonusIdByBonusType?;
+    private readonly [BuffPropertyKey.MISS_PROBABILITY]?;
     private readonly _abilityTypeIds?;
     private _behaviors?;
-    private getUnitBonus;
-    private addOrUpdateOrRemoveUnitBonus;
-    constructor(target: Unit, ...parameters: BuffConstructorParameters<AdditionalParameters>);
+    constructor(target: Unit, ...parameters: BuffConstructorParameters<Buff<AdditionalParameters>>);
     get level(): number;
     get remainingDamageOverDuration(): number;
     set remainingDamageOverDuration(remainingDamageOverDuration: number);
@@ -187,10 +260,24 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set healingPerInterval(healingPerInterval: number);
     get healingInterval(): number;
     set healingInterval(healingInterval: number);
+    get damageOnExpiration(): number;
+    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 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;
     set stuns(stuns: boolean);
     get ignoresStunImmunity(): boolean;
@@ -199,6 +286,16 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set disablesAutoAttack(disablesAutoAttack: boolean);
     get providesInvulnerability(): boolean;
     set providesInvulnerability(providesInvulnerability: boolean);
+    get killsOnExpiration(): boolean;
+    set killsOnExpiration(killsOnExpiration: boolean);
+    get explodesOnExpiration(): boolean;
+    set explodesOnExpiration(killsOnExpiration: boolean);
+    get sharesVisionWithSource(): boolean;
+    set sharesVisionWithSource(sharesVisionWithSource: boolean);
+    get maximumDamageDealtEventCount(): number;
+    set maximumDamageDealtEventCount(maximumDamageDealtEventCount: number);
+    get maximumDamageReceivedEventCount(): number;
+    set maximumDamageReceivedEventCount(maximumDamageReceivedEventCount: number);
     get maximumAutoAttackCount(): number;
     set maximumAutoAttackCount(maximumAutoAttackCount: number);
     get durationIncreaseOnAutoAttack(): number;
@@ -207,15 +304,48 @@ 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 manaRegenerationRateIncreaseFactor(): number;
+    set manaRegenerationRateIncreaseFactor(manaRegenerationRateIncreaseFactor: number);
     get duration(): number;
+    set duration(duration: number);
     get remainingDuration(): number;
     set remainingDuration(remainingDuration: number);
-    flashEffect(...parameters: [...widget: [] | [Widget], ...duration: [] | [number]]): void;
-    flashSpecialEffect(...parameters: [...widget: [] | [Widget], ...duration: [] | [number]]): void;
+    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;
+    onAbilityLost(ability: Ability): void;
+    flashEffect(...parameters: [
+        ...widgetOrXY: [] | [Widget] | [x: number, x: number],
+        ...parametersOrDuration: [] | [EffectParameters] | [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;
+    onDamageReceived(source: Unit | undefined, event: DamageEvent): void;
+    static readonly createdEvent: Event<[Buff<object>]>;
+    static readonly beingDestroyedEvent: Event<[Buff<object>]>;
 }
 export {};