warscript 0.0.1-dev.9cbb1ff → 0.0.1-dev.9e6f20e

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (184) hide show
  1. package/attributes.d.ts +6 -0
  2. package/attributes.lua +17 -1
  3. package/core/types/frame.d.ts +1 -0
  4. package/core/types/frame.lua +136 -58
  5. package/core/types/handle.lua +6 -9
  6. package/core/types/item.d.ts +1 -0
  7. package/core/types/item.lua +1 -0
  8. package/core/types/player.d.ts +17 -1
  9. package/core/types/player.lua +70 -24
  10. package/core/types/playerCamera.d.ts +2 -0
  11. package/core/types/playerCamera.lua +123 -5
  12. package/core/types/sound.lua +1 -1
  13. package/core/types/tileCell.d.ts +11 -1
  14. package/core/types/tileCell.lua +97 -0
  15. package/core/types/timer.d.ts +3 -1
  16. package/core/types/timer.lua +27 -2
  17. package/decl/native.d.ts +846 -790
  18. package/destroyable.d.ts +1 -0
  19. package/destroyable.lua +9 -0
  20. package/engine/behavior.d.ts +14 -1
  21. package/engine/behavior.lua +230 -70
  22. package/engine/behaviour/ability/apply-buff.lua +5 -5
  23. package/engine/behaviour/ability/damage.d.ts +9 -3
  24. package/engine/behaviour/ability/damage.lua +31 -37
  25. package/engine/behaviour/ability/emulate-impact.d.ts +1 -1
  26. package/engine/behaviour/ability/emulate-impact.lua +16 -7
  27. package/engine/behaviour/ability/remove-buffs.d.ts +9 -0
  28. package/engine/behaviour/ability/remove-buffs.lua +21 -0
  29. package/engine/behaviour/ability/restore-mana.d.ts +1 -1
  30. package/engine/behaviour/ability/restore-mana.lua +6 -6
  31. package/engine/behaviour/ability.d.ts +11 -6
  32. package/engine/behaviour/ability.lua +38 -17
  33. package/engine/behaviour/unit/stun-immunity.d.ts +12 -6
  34. package/engine/behaviour/unit/stun-immunity.lua +57 -31
  35. package/engine/behaviour/unit.d.ts +39 -3
  36. package/engine/behaviour/unit.lua +269 -6
  37. package/engine/buff.d.ts +67 -22
  38. package/engine/buff.lua +371 -182
  39. package/engine/internal/ability.d.ts +7 -1
  40. package/engine/internal/ability.lua +64 -24
  41. package/engine/internal/item/ability.lua +63 -11
  42. package/engine/internal/item/fields.d.ts +12 -0
  43. package/engine/internal/item/fields.lua +33 -0
  44. package/engine/internal/item+owner.lua +12 -6
  45. package/engine/internal/item.d.ts +16 -16
  46. package/engine/internal/item.lua +152 -69
  47. package/engine/internal/mechanics/cast-ability.lua +6 -3
  48. package/engine/internal/misc/damage-metadata-by-target.lua +5 -0
  49. package/engine/internal/misc/frame-coordinates.d.ts +2 -0
  50. package/engine/internal/misc/frame-coordinates.lua +21 -0
  51. package/engine/internal/misc/get-terrain-z.d.ts +2 -0
  52. package/engine/internal/misc/get-terrain-z.lua +11 -0
  53. package/engine/internal/misc/player-local-handle.d.ts +2 -0
  54. package/engine/internal/misc/player-local-handle.lua +5 -0
  55. package/engine/internal/object-data/armor-bonus.d.ts +2 -0
  56. package/engine/internal/object-data/attribute-bonus.lua +2 -2
  57. package/engine/internal/object-data/health-bonus.d.ts +2 -0
  58. package/engine/internal/object-data/health-bonus.lua +16 -0
  59. package/engine/internal/object-data/mana-bonus.d.ts +2 -0
  60. package/engine/internal/object-data/mana-bonus.lua +16 -0
  61. package/engine/internal/object-data/mana-regeneration-rate-increase-factor.d.ts +2 -0
  62. package/engine/internal/object-data/mana-regeneration-rate-increase-factor.lua +16 -0
  63. package/engine/internal/unit/ability.d.ts +35 -0
  64. package/engine/internal/unit/ability.lua +113 -12
  65. package/engine/internal/unit/allowed-targets.d.ts +1 -1
  66. package/engine/internal/unit/allowed-targets.lua +9 -1
  67. package/engine/internal/unit/attributes.d.ts +17 -0
  68. package/engine/internal/unit/attributes.lua +46 -0
  69. package/engine/internal/unit/bonus.d.ts +6 -0
  70. package/engine/internal/unit/bonus.lua +33 -3
  71. package/engine/internal/unit/buff.d.ts +2 -2
  72. package/engine/internal/unit/buff.lua +32 -17
  73. package/engine/internal/unit/fly-height.d.ts +7 -0
  74. package/engine/internal/unit/fly-height.lua +20 -0
  75. package/engine/internal/unit/interrupts.d.ts +12 -0
  76. package/engine/internal/unit/interrupts.lua +28 -0
  77. package/engine/internal/unit/main-selected.lua +12 -27
  78. package/engine/internal/unit/order.d.ts +20 -0
  79. package/engine/internal/unit/order.lua +136 -0
  80. package/engine/internal/unit/pseudo-passive-abilities.d.ts +2 -0
  81. package/engine/internal/unit/pseudo-passive-abilities.lua +11 -0
  82. package/engine/internal/unit/range-event.d.ts +12 -0
  83. package/engine/internal/unit/range-event.lua +90 -0
  84. package/engine/internal/unit/scale.d.ts +7 -0
  85. package/engine/internal/unit/scale.lua +20 -0
  86. package/engine/internal/unit+ability.lua +10 -1
  87. package/engine/internal/unit+bonus.lua +3 -3
  88. package/engine/internal/unit+damage.d.ts +2 -11
  89. package/engine/internal/unit+damage.lua +10 -14
  90. package/engine/internal/unit+spellSteal.lua +1 -2
  91. package/engine/internal/unit-missile-launch.lua +52 -14
  92. package/engine/internal/unit.d.ts +34 -27
  93. package/engine/internal/unit.lua +365 -273
  94. package/engine/local-client.d.ts +7 -0
  95. package/engine/local-client.lua +86 -1
  96. package/engine/object-data/auxiliary/armor-type.d.ts +11 -0
  97. package/engine/object-data/auxiliary/armor-type.lua +46 -0
  98. package/engine/object-data/auxiliary/attack-type.d.ts +7 -8
  99. package/engine/object-data/auxiliary/attack-type.lua +42 -0
  100. package/engine/object-data/auxiliary/health-regeneration-type.d.ts +8 -0
  101. package/engine/object-data/auxiliary/health-regeneration-type.lua +2 -0
  102. package/engine/object-data/auxiliary/unit-attribute.lua +1 -1
  103. package/engine/object-data/entry/ability-type/{armor-increase.d.ts → armor-bonus.d.ts} +3 -3
  104. package/engine/object-data/entry/ability-type/{armor-increase.lua → armor-bonus.lua} +9 -9
  105. package/engine/object-data/entry/ability-type/blank-configurable.d.ts +3 -0
  106. package/engine/object-data/entry/ability-type/blank-configurable.lua +30 -0
  107. package/engine/object-data/entry/ability-type/health-bonus.d.ts +8 -0
  108. package/engine/object-data/entry/ability-type/health-bonus.lua +26 -0
  109. package/engine/object-data/entry/ability-type/mana-bonus.d.ts +8 -0
  110. package/engine/object-data/entry/ability-type/mana-bonus.lua +26 -0
  111. package/engine/object-data/entry/ability-type/mana-regeneration.d.ts +8 -0
  112. package/engine/object-data/entry/ability-type/mana-regeneration.lua +26 -0
  113. package/engine/object-data/entry/ability-type/permanent-invisibility.d.ts +8 -0
  114. package/engine/object-data/entry/ability-type/permanent-invisibility.lua +26 -0
  115. package/engine/object-data/entry/ability-type/reincarnation.d.ts +8 -0
  116. package/engine/object-data/entry/ability-type/reincarnation.lua +26 -0
  117. package/engine/object-data/entry/ability-type.d.ts +2 -0
  118. package/engine/object-data/entry/ability-type.lua +89 -8
  119. package/engine/object-data/entry/buff-type/applicable.lua +113 -109
  120. package/engine/object-data/entry/destructible-type.d.ts +27 -1
  121. package/engine/object-data/entry/destructible-type.lua +155 -0
  122. package/engine/object-data/entry/unit-type.d.ts +17 -4
  123. package/engine/object-data/entry/unit-type.lua +189 -83
  124. package/engine/object-field/ability.d.ts +4 -4
  125. package/engine/object-field/ability.lua +9 -8
  126. package/engine/object-field/item.d.ts +22 -0
  127. package/engine/object-field/item.lua +118 -0
  128. package/engine/object-field/unit.d.ts +72 -3
  129. package/engine/object-field/unit.lua +268 -7
  130. package/engine/object-field.d.ts +18 -7
  131. package/engine/object-field.lua +294 -135
  132. package/engine/random.d.ts +10 -0
  133. package/engine/random.lua +21 -0
  134. package/engine/standard/fields/ability.d.ts +2 -2
  135. package/engine/standard/fields/ability.lua +2 -2
  136. package/engine/standard/fields/item.d.ts +4 -0
  137. package/engine/standard/fields/item.lua +6 -0
  138. package/engine/standard/fields/unit.d.ts +12 -0
  139. package/engine/standard/fields/unit.lua +20 -0
  140. package/engine/synchronization.d.ts +11 -0
  141. package/engine/synchronization.lua +77 -0
  142. package/engine/text-tag.d.ts +36 -2
  143. package/engine/text-tag.lua +250 -10
  144. package/engine/unit.d.ts +6 -0
  145. package/engine/unit.lua +6 -0
  146. package/event.d.ts +1 -1
  147. package/lualib_bundle.lua +1 -1
  148. package/math.d.ts +2 -0
  149. package/math.lua +14 -0
  150. package/net/socket.lua +1 -1
  151. package/network.lua +25 -1
  152. package/objutil/buff.lua +11 -10
  153. package/objutil/object.lua +1 -1
  154. package/operation.d.ts +8 -1
  155. package/operation.lua +38 -18
  156. package/package.json +5 -5
  157. package/patch-lua.lua +15 -0
  158. package/patch-lualib.lua +1 -1
  159. package/utility/arrays.d.ts +2 -0
  160. package/utility/arrays.lua +11 -0
  161. package/utility/callback-array.d.ts +17 -0
  162. package/utility/callback-array.lua +61 -0
  163. package/utility/functions.d.ts +8 -0
  164. package/utility/functions.lua +13 -0
  165. package/utility/linked-map.d.ts +35 -0
  166. package/utility/linked-map.lua +107 -0
  167. package/utility/linked-set.d.ts +4 -1
  168. package/utility/linked-set.lua +46 -1
  169. package/utility/lua-maps.d.ts +12 -2
  170. package/utility/lua-maps.lua +37 -2
  171. package/utility/lua-sets.d.ts +1 -0
  172. package/utility/lua-sets.lua +4 -0
  173. package/utility/random.d.ts +102 -0
  174. package/utility/random.lua +273 -0
  175. package/utility/records.lua +20 -1
  176. package/utility/types.d.ts +3 -0
  177. package/utility/unordered-map.d.ts +27 -0
  178. package/utility/unordered-map.lua +99 -0
  179. package/core/types/order.d.ts +0 -25
  180. package/core/types/order.lua +0 -55
  181. /package/engine/internal/{object-data/armor-increase.d.ts → misc/damage-metadata-by-target.d.ts} +0 -0
  182. /package/engine/internal/object-data/{armor-increase.lua → armor-bonus.lua} +0 -0
  183. /package/engine/object-data/entry/ability-type/{attribute-increase.d.ts → attribute-bonus.d.ts} +0 -0
  184. /package/engine/object-data/entry/ability-type/{attribute-increase.lua → attribute-bonus.lua} +0 -0
@@ -13,6 +13,8 @@ import type { UnitTypeId } from "../object-data/entry/unit-type";
13
13
  import { CombatClassification, CombatClassifications } from "../object-data/auxiliary/combat-classification";
14
14
  import { MovementType } from "../object-data/auxiliary/movement-type";
15
15
  import { UnitAttribute } from "../object-data/auxiliary/unit-attribute";
16
+ import { AttackType } from "../object-data/auxiliary/attack-type";
17
+ import { AttributesHolder } from "../../attributes";
16
18
  export type UnitClassification = junittype;
17
19
  export declare namespace UnitClassification {
18
20
  const STRUCTURE: junittype;
@@ -21,6 +23,7 @@ export declare namespace UnitClassification {
21
23
  const GROUND: junittype;
22
24
  const SUMMONED: junittype;
23
25
  const MECHANICAL: junittype;
26
+ const WORKER: junittype;
24
27
  const ANCIENT: junittype;
25
28
  const SUICIDAL: junittype;
26
29
  const TAUREN: junittype;
@@ -38,15 +41,18 @@ type AbilityDispatcherTable<T extends any[] = []> = {
38
41
  readonly [id: number]: Event<[Unit, Ability, ...T]>;
39
42
  };
40
43
  type AbilityEventDispatcher<T extends any[] = []> = Event<[Unit, Ability, ...T]> & AbilityDispatcherTable<T>;
41
- export interface DamagingEvent {
44
+ export interface DamagingEvent extends AttributesHolder {
42
45
  amount: number;
43
- attackType: jattacktype;
46
+ attackType: AttackType;
44
47
  damageType: jdamagetype;
45
48
  weaponType: jweapontype;
49
+ metadata: unknown;
46
50
  readonly isAttack: boolean;
47
51
  readonly originalAmount: number;
52
+ readonly originalMetadata: unknown;
53
+ preventRetaliation(this: DamagingEvent): void;
48
54
  }
49
- export type DamageEvent = DamagingEvent & {
55
+ export type DamageEvent = Omit<DamagingEvent, "preventRetaliation"> & {
50
56
  preventDeath<P extends any[]>(this: DamageEvent, callback: (this: void, ...parameters: P) => any, ...parameters: P): void;
51
57
  };
52
58
  export type AttackDamageEvent = DamagingEvent & {
@@ -74,10 +80,14 @@ export declare class UnitWeapon {
74
80
  readonly unit: Unit;
75
81
  readonly index: 0 | 1;
76
82
  constructor(unit: Unit, index: 0 | 1);
83
+ get isEnabled(): boolean;
84
+ set isEnabled(isEnabled: boolean);
77
85
  get cooldown(): number;
78
86
  set cooldown(cooldown: number);
79
87
  get damage(): [minimumDamage: number, maximumDamage: number];
80
88
  set damage([minimumDamage, maximumDamage]: [number, number]);
89
+ get allowedTargetCombatClassifications(): CombatClassifications;
90
+ set allowedTargetCombatClassifications(allowedTargetCombatClassifications: CombatClassifications);
81
91
  get damageBase(): number;
82
92
  set damageBase(damageBase: number);
83
93
  get damageDiceCount(): number;
@@ -99,12 +109,13 @@ declare const enum UnitPropertyKey {
99
109
  SYNC_ID = 100,
100
110
  IS_PAUSED = 101,
101
111
  STUN_COUNTER = 102,
102
- DELAY_HEALTH_CHECKS_COUNTER = 103,
103
- DELAY_HEALTH_CHECKS_HEALTH_BONUS = 104,
104
- PREVENT_DEATH_HEALTH_BONUS = 105,
105
- IS_TEAM_GLOW_HIDDEN = 106,
106
- LAST_X = 107,
107
- LAST_Y = 108
112
+ FORCE_STUN_COUNTER = 103,
113
+ DELAY_HEALTH_CHECKS_COUNTER = 104,
114
+ DELAY_HEALTH_CHECKS_HEALTH_BONUS = 105,
115
+ PREVENT_DEATH_HEALTH_BONUS = 106,
116
+ IS_TEAM_GLOW_HIDDEN = 107,
117
+ LAST_X = 108,
118
+ LAST_Y = 109
108
119
  }
109
120
  export type UnitSyncId = number & {
110
121
  readonly __unitSyncId: unique symbol;
@@ -113,6 +124,7 @@ export declare class Unit extends Handle<junit> {
113
124
  readonly syncId: UnitSyncId;
114
125
  private [UnitPropertyKey.IS_PAUSED]?;
115
126
  private [UnitPropertyKey.STUN_COUNTER]?;
127
+ private [UnitPropertyKey.FORCE_STUN_COUNTER]?;
116
128
  private [UnitPropertyKey.DELAY_HEALTH_CHECKS_COUNTER]?;
117
129
  private [UnitPropertyKey.DELAY_HEALTH_CHECKS_HEALTH_BONUS]?;
118
130
  private [UnitPropertyKey.PREVENT_DEATH_HEALTH_BONUS]?;
@@ -127,6 +139,7 @@ export declare class Unit extends Handle<junit> {
127
139
  private _fields?;
128
140
  private getEvent;
129
141
  constructor(handle: junit);
142
+ private saveData;
130
143
  protected onDestroy(): HandleDestructor;
131
144
  addAttackHandler(condition: AttackHandlerCondition, action: AttackHandlerAction): AttackHandler;
132
145
  removeAttackHandler(handler: AttackHandler): boolean;
@@ -152,29 +165,23 @@ export declare class Unit extends Handle<junit> {
152
165
  isInRangeOf(unit: Unit, range: number): boolean;
153
166
  isAllyOf(unit: Unit): boolean;
154
167
  isEnemyOf(unit: Unit): boolean;
155
- playAnimation(animation: string, rarity?: jraritycontrol): void;
156
- playAnimation(animation: number): void;
168
+ playAnimation(...parameters: [animation: number] | [animation: string, rarity?: jraritycontrol]): void;
157
169
  resetAnimation(): void;
158
170
  queueAnimation(animation: string): void;
159
171
  get weapons(): [UnitWeapon, UnitWeapon];
160
172
  get firstWeapon(): UnitWeapon;
161
173
  get secondWeapon(): UnitWeapon;
174
+ chooseWeapon(target: Unit): UnitWeapon | undefined;
162
175
  get level(): number;
163
176
  set level(v: number);
164
177
  get xp(): number;
165
178
  set xp(v: number);
166
179
  get primaryAttribute(): UnitAttribute;
167
180
  set primaryAttribute(primaryAttribute: UnitAttribute);
168
- get strengthBase(): number;
169
- set strengthBase(strengthBase: number);
170
181
  get strengthBonus(): number;
171
182
  get strength(): number;
172
- get agilityBase(): number;
173
- set agilityBase(agilityBase: number);
174
183
  get agilityBonus(): number;
175
184
  get agility(): number;
176
- get intelligenceBase(): number;
177
- set intelligenceBase(intelligenceBase: number);
178
185
  get intelligenceBonus(): number;
179
186
  get intelligence(): number;
180
187
  get name(): string;
@@ -208,8 +215,6 @@ export declare class Unit extends Handle<junit> {
208
215
  set facing(v: number);
209
216
  get speed(): number;
210
217
  set speed(v: number);
211
- get flyHeight(): number;
212
- set flyHeight(v: number);
213
218
  get x(): number;
214
219
  set x(v: number);
215
220
  get y(): number;
@@ -233,8 +238,6 @@ export declare class Unit extends Handle<junit> {
233
238
  get isInvulnerable(): boolean;
234
239
  get vertexColor(): Color;
235
240
  set vertexColor(v: Color);
236
- get scale(): number;
237
- set scale(v: number);
238
241
  get timeScale(): number;
239
242
  set timeScale(v: number);
240
243
  get collisionSize(): number;
@@ -258,18 +261,17 @@ export declare class Unit extends Handle<junit> {
258
261
  dropItemTarget(item: Item, target: Widget): boolean;
259
262
  dropItemSlot(item: Item, slot: number): boolean;
260
263
  itemInSlot(slot: number): Item | null;
261
- addAbility(abilityId: number): UnitAbility | null;
264
+ addAbility(abilityId: number): UnitAbility | undefined;
262
265
  makeAbilityPermanent(abilityId: number, permanent: true): boolean;
263
266
  setAbilityLevel(abilityId: number, level: number): number;
264
267
  getAbilityLevel(abilityId: number): number;
265
268
  hasAbility(abilityId: number): boolean;
266
- getAbilityById(abilityId: number): UnitAbility | undefined;
267
- removeAbility(abilityId: number): boolean;
269
+ getAbility(abilityId: number): UnitAbility | undefined;
270
+ removeAbility(abilityTypeId: number): boolean;
268
271
  hideAbility(abilityId: number, flag: boolean): void;
269
272
  getAbilityRemainingCooldown(abilityId: number): number;
270
273
  startAbilityCooldown(abilityId: number, cooldown: number): void;
271
274
  endAbilityCooldown(abilityId: number): void;
272
- interruptAttack(): void;
273
275
  interruptCast(abilityId: number): void;
274
276
  getDistanceTo(target: Unit | Vec2): number;
275
277
  getCollisionDistanceTo(...target: [Unit] | [targetX: number, targetY: number]): number;
@@ -283,14 +285,16 @@ export declare class Unit extends Handle<junit> {
283
285
  unpauseEx(): void;
284
286
  incrementStunCounter(): void;
285
287
  decrementStunCounter(): void;
288
+ incrementForceStunCounter(): void;
289
+ decrementForceStunCounter(): void;
286
290
  set waygateActive(v: boolean);
287
291
  get waygateActive(): boolean;
288
292
  set waygateDestination(v: Vec2);
289
293
  get waygateDestination(): Vec2;
290
294
  get abilities(): ReadonlyArray<UnitAbility>;
291
- get onUnitInRange(): Record<number, Event<[Unit]>>;
292
295
  get onManaEqual(): Record<number, Event<[Unit, number]>>;
293
296
  get manaEvent(): Record<Operator, Record<number, Event<[Unit]>>>;
297
+ get targetAcquiredEvent(): Event;
294
298
  get onSelect(): Event;
295
299
  get onDeselect(): Event;
296
300
  get onImmediateOrder(): Event<[number]>;
@@ -306,6 +310,7 @@ export declare class Unit extends Handle<junit> {
306
310
  static getInCollisionRange(x: number, y: number, range: number, predicate?: (unit: Unit) => boolean): Unit[];
307
311
  static getInSector(pos: Vec2, range: number, offsetAngle: number, centralAngle: number): Unit[];
308
312
  static getSelectionOf(player: Player, target?: Unit[]): Unit[];
313
+ static readonly levelChangedEvent: UnitTriggerEvent<[]>;
309
314
  static readonly deathEvent: UnitTriggerEvent<[Unit]>;
310
315
  static readonly onDecay: UnitTriggerEvent<[]>;
311
316
  static readonly onResurrect: InitializingEvent<[Unit], void>;
@@ -343,7 +348,8 @@ export declare class Unit extends Handle<junit> {
343
348
  static itemDroppedEvent: UnitTriggerEvent<[Item]>;
344
349
  static itemPickedUpEvent: UnitTriggerEvent<[Item]>;
345
350
  static itemUsedEvent: UnitTriggerEvent<[Item]>;
346
- static itemStackedEvent: UnitTriggerEvent<[Item]>;
351
+ static itemStackedEvent: UnitTriggerEvent<[target: Item, source: Item]>;
352
+ static get itemChargesChangedEvent(): Event<[unit: Unit, item: Item]>;
347
353
  static get itemUseOrderEvent(): Event<[unit: Unit, item: Item]>;
348
354
  static get itemMoveOrderEvent(): Event<[
349
355
  unit: Unit,
@@ -362,5 +368,6 @@ export declare class Unit extends Handle<junit> {
362
368
  setField(field: junitstringfield, value: string): boolean;
363
369
  toString(): string;
364
370
  static getBySyncId(syncId: UnitSyncId): Unit | undefined;
371
+ static synchronize: (player: Player, object: Unit | undefined) => Promise<Unit | undefined>;
365
372
  }
366
373
  export {};