@v12-engine/engine 0.1.0 → 0.4.0

package/dist/abilities/effectFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectFields.js","names":[],"sources":["../../src/abilities/effectFields.ts"],"sourcesContent":["import type { EffectCommon, EffectFields } from '#engine/defs'\nimport type { EditableField } from '#engine/gameData'\n\n/*\n * What the fields of the engine's effects hold, for the editor's Data panel (campaign plan RC2): an effect's type says\n * which of them it reads (`defineEffect`'s `fields`), and the panel offers those of a row of that type\n */\n\n/** The fields every effect may have, whatever its type (`EffectCommon`): offered on every row of effects */\nexport const COMMON_EFFECT_FIELDS: Readonly<Record<keyof EffectCommon, EditableField | readonly EditableField[]>> = {\n\tradius: { path: 'radius', kind: 'number', min: 0, hint: 'Hits everything this far around where it lands, not only the target' },\n\tshape: {\n\t\tpath: 'shape',\n\t\toptions: ['circle', 'cone', 'line', 'rect', 'ring', 'arc', 'cross'],\n\t\thint: 'The ground it covers, turned the way it was aimed: a cone, a line and an arc go off from the caster, the rest lie around where it landed'\n\t},\n\tlength: { path: 'length', kind: 'number', min: 0, hint: 'Of a cone, a line, a rect and a cross: how long it is, end to end' },\n\twidth: {\n\t\tpath: 'width',\n\t\tkind: 'number',\n\t\tmin: 0,\n\t\thint: 'Of a line, a rect and a cross: how far it covers on either side; of a ring and an arc, how thick it is (1 when left out)'\n\t},\n\tangle: { path: 'angle', kind: 'number', min: 0, max: 6.2832, hint: 'Of a cone and an arc: how wide it opens, in radians' },\n\taffects: {\n\t\tpath: 'affects',\n\t\toptions: ['enemies', 'allies', 'all'],\n\t\thint: 'Who an effect with a radius applies to: as its type has it when left out'\n\t},\n\ton: { path: 'on', options: ['caster'], hint: 'Applies to the caster, wherever the ability was aimed' },\n\tifBuff: { path: 'ifBuff', kind: 'id', of: 'buffs', hint: 'Only hits what carries this buff' },\n\ttags: { path: 'tags', kind: 'list', hint: 'Only hits what has one of these tags of its type (undead, mechanical): everything when left out' },\n\tchance: {\n\t\tpath: 'chance',\n\t\tkind: 'number',\n\t\tmin: 0,\n\t\tmax: 1,\n\t\thint: 'It happens by chance: this share of the times (0.25: one in four). A trigger goes off by it; an if asks it with its conditions'\n\t},\n\tlook: {\n\t\tpath: 'look',\n\t\tkind: 'text',\n\t\thint: \"Which of its ability's looks draws it (the view's AbilityLook.effects): by this name; by its place in the ability or its type when left out\"\n\t},\n\tonly: { path: 'only', options: ['heroes'], hint: 'Only hits heroes' },\n\tkinds: { path: 'kinds', kind: 'list', hint: 'Only hits these kinds of things (unit, building, …): everything but resources when left out' },\n\tlayers: { path: 'layers', kind: 'list', hint: 'Only hits what is there (ground, air): both when left out' },\n\t// from units of the caster's (AB17)\n\torigin: [\n\t\t{ path: 'origin.proxy', kind: 'id', of: 'units', hint: \"Goes off from the caster's units of this type (a shadow, a ball, a soldier), not from the caster\" },\n\t\t{ path: 'origin.pick', options: ['nearest', 'all', 'newest', 'oldest'], hint: 'Which of them: the one nearest to where it was aimed when left out' },\n\t\t{\n\t\t\tpath: 'origin.caster',\n\t\t\tkind: 'either',\n\t\t\toptions: ['otherwise'],\n\t\t\thint: 'From the caster as well (true), or from the caster where none is picked (otherwise)'\n\t\t},\n\t\t{ path: 'origin.range', kind: 'number', min: 0, hint: 'Only those within this far of the caster' },\n\t\t{ path: 'origin.near', kind: 'number', min: 0, hint: 'Only those within this far of where it was aimed' },\n\t\t{ path: 'origin.at', options: ['aim', 'proxy'], hint: 'Lands where it was aimed (when left out), or where each it goes off from stands' },\n\t\t{ path: 'origin.target', kind: 'boolean', hint: 'The one it goes off from is its target too: a swap with it, a dash to it' }\n\t],\n\t// conditions on what it hits, and a few of them (world queries)\n\twhere: conditionFields('where', 'what it hits'),\n\tsort: {\n\t\tpath: 'sort',\n\t\toptions: ['nearest', 'farthest', 'lowestHealth', 'highestHealth', 'lowestHealthShare', 'highestHealthShare', 'random'],\n\t\thint: 'Of what its area reaches, which first: the nearest to where it landed when left out, the most hurt (lowestHealthShare), at random…'\n\t},\n\tlimit: { path: 'limit', kind: 'number', min: 0, hint: 'Of what its area reaches, only this many, the first by sort' },\n\twhen: {\n\t\tpath: 'when',\n\t\toptions: ['hit', 'arrived', 'landed', 'end'],\n\t\thint: \"Not now, but at the moment of the nearest row above that comes to it: a missile's hit or end, a pull's arrival, a dash's landing, a zone's end\"\n\t}\n}\n\n/** The fields of what an `if` asks of a unit (`UnitCondition`), at `path`: the caster or the target; or an effect's `where` */\nfunction conditionFields(path: 'caster' | 'target' | 'where', who: string): EditableField[] {\n\treturn [\n\t\t{ path: `${path}.buff`, kind: 'id', of: 'buffs', hint: `Only if ${who} carries this buff` },\n\t\t{ path: `${path}.noBuff`, kind: 'id', of: 'buffs', hint: `Only if ${who} does not carry this buff` },\n\t\t{ path: `${path}.healthBelow`, kind: 'number', min: 0, max: 1, hint: `Only if ${who} has less than this share of its health (0.2: an execute)` },\n\t\t{ path: `${path}.healthAbove`, kind: 'number', min: 0, max: 1, hint: `Only if ${who} has at least this share of its health` },\n\t\t{ path: `${path}.hero`, kind: 'boolean', hint: `Only if ${who} is a hero (on) or is not (off)` },\n\t\t{ path: `${path}.structure`, kind: 'boolean', hint: `Only if ${who} is a structure (on) or is not (off): with hero off, a creep` },\n\t\t{ path: `${path}.tags`, kind: 'list', hint: `Only if ${who} has one of these tags of its type` },\n\t\t{ path: `${path}.notTags`, kind: 'list', hint: `Only if ${who} has none of these tags of its type (undead: the living)` },\n\t\t{ path: `${path}.is`, options: ['enemy', 'ally'], hint: `Only if ${who} is an enemy or an ally of the caster` }\n\t]\n}\n\n/**\n * The engine's fields of an effect by name (`EffectFields`), as the Data panel shows them; `effects`, `onEnd` and\n * `otherwise` are lists of effects. Those of a few values (a missile's `arc`) are a field for each, null for one that\n * is no single value\n */\nexport const EFFECT_FIELDS: Readonly<Record<keyof EffectFields, EditableField | readonly EditableField[] | null>> = {\n\tto: { path: 'to', options: ['home', 'point', 'target'], hint: \"Where to: the side's home, where it was aimed, or by its target\" },\n\t// the moves pack's own (`movesPack`), said in full where its effects say what they read\n\tthrough: null,\n\tcollide: null,\n\tstops: null,\n\tdirection: null,\n\trider: null,\n\t// the ground objects pack's own (`groundObjectsPack`), likewise\n\tline: null,\n\tring: null,\n\t// the resources pack's own (`resourcesPack`), likewise\n\tpool: null,\n\t// the ability changes pack's own (`abilityChangesPack`), likewise\n\tfrom: null,\n\tuses: null,\n\tatLevel: null,\n\tpick: null,\n\t// what an `if` asks (AB6), a field for each part\n\tcaster: conditionFields('caster', 'the caster'),\n\ttarget: conditionFields('target', 'the target (each within its radius, where it has one)'),\n\tamount: { path: 'amount', kind: 'number', hint: 'How much: of damage, of health, of mana' },\n\tbuff: { path: 'buff', kind: 'id', of: 'buffs', hint: 'The buff put on' },\n\towner: { path: 'owner', options: ['neutral'], hint: \"Whose it is: the caster's when left out, or the neutral player's\" },\n\tlooksLike: { path: 'looksLike', options: ['target', 'caster'], hint: 'Drawn as the target or the caster is: its model, its owner\\'s colour, its size' },\n\tdata: null,\n\tunit: { path: 'unit', kind: 'id', of: 'units', hint: 'The unit type it brings into the world' },\n\twhileBuff: { path: 'whileBuff', kind: 'id', of: 'buffs', hint: 'Only while the carrier carries this buff' },\n\tevery: { path: 'every', kind: 'integer', min: 1, hint: 'Only every so many attacks that land: 4 for the fourth shot' },\n\tconsumes: { path: 'consumes', kind: 'boolean', hint: 'The attack uses up a stack of the buff it needs (whileBuff): the next attack' },\n\tslot: { path: 'slot', kind: 'text', hint: 'The slot it takes among what attacks set off (orb, poison): of one slot only the highest priority goes off' },\n\tpriority: { path: 'priority', kind: 'number', hint: 'Of those sharing its slot, the highest goes off (0 when left out)' },\n\tcooldown: { path: 'cooldown', kind: 'number', min: 0, hint: 'Seconds before it can go off again once it did' },\n\tas: { path: 'as', options: ['themselves'], hint: 'The corpses rise as what they were, rather than as its unit' },\n\thealth: { path: 'health', kind: 'number', min: 0, max: 1, hint: 'The share of its max health it is left with rather than dying: all of it when left out' },\n\tbelow: { path: 'below', kind: 'number', min: 0, max: 1, hint: 'The part of max health the carrier falls below for it to go off (0.3: 30%)' },\n\tmelee: { path: 'melee', kind: 'boolean', hint: 'Only for an attack from up close (one with no missile)' },\n\tstacks: { path: 'stacks', kind: 'integer', min: 1, hint: 'How many stacks come off: all of the buff when left out' },\n\totherwise: { path: 'otherwise', kind: 'rows', hint: 'What happens otherwise: the ability went off not charged (charged), what it asks does not hold (if)' },\n\tblocked: { path: 'blocked', kind: 'boolean', hint: 'Buildings and trees in its way stop it' },\n\tattack: { path: 'attack', kind: 'boolean', hint: 'Only for attacks: one of the carrier that killed (onKill), one that hurt it (onDamaged)' },\n\tability: { path: 'ability', kind: 'id', of: 'abilities', hint: 'The ability ready again: the one the effect belongs to when left out' },\n\tleap: { path: 'leap', kind: 'number', min: 0, hint: 'How high it rises on the way, which makes it a leap' },\n\tclimb: { path: 'climb', kind: 'number', min: 0, hint: 'How much higher than where it takes off the ground on its way may stand' },\n\tduration: { path: 'duration', kind: 'number', min: 0, hint: 'Seconds it lasts: its usual time when left out' },\n\t// what the caster's stats add, by stat: its numbers are fields where an effect has them, none offered where it has not\n\tscaling: null,\n\tdamageType: { path: 'damageType', options: ['physical', 'magic', 'true'], hint: 'Magic when left out' },\n\thow: { path: 'how', kind: 'text', hint: 'How what it kills dies, for the screen' },\n\tdelay: { path: 'delay', kind: 'number', min: 0, hint: 'Seconds before it goes' },\n\tspeed: { path: 'speed', kind: 'number', min: 0, hint: 'Units per second' },\n\tdistance: { path: 'distance', kind: 'number', min: 0, hint: 'How far' },\n\tcount: { path: 'count', kind: 'integer', min: 1, hint: 'How many' },\n\tspread: { path: 'spread', kind: 'number', min: 0, hint: 'The angle the missiles are spread over, in radians' },\n\thoming: { path: 'homing', kind: 'boolean', hint: 'Flies after the unit it was cast on, and only hits that one' },\n\ttoPoint: {\n\t\tpath: 'toPoint',\n\t\tkind: 'boolean',\n\t\thint: 'Flies to the spot it was aimed at and stops there; a pull drags to it rather than to the caster'\n\t},\n\tsight: { path: 'sight', kind: 'number', min: 0, hint: 'How far the caster’s team sees around it' },\n\teffects: { path: 'effects', kind: 'rows', hint: 'What happens to what it reaches' },\n\tonEnd: { path: 'onEnd', kind: 'rows', hint: 'What happens where and when it ends' },\n\timpact: { path: 'impact', kind: 'text', hint: 'The name its arrival goes by, for whoever draws it' },\n\t// true or false, or how many it goes through before the next uses it up\n\tpierce: {\n\t\tpath: 'pierce',\n\t\tkind: 'either',\n\t\torNumber: 'integer',\n\t\tmin: 0,\n\t\thint: 'Goes on after it hit something (true), is used up by the first (false), or goes through so many (a number)'\n\t},\n\tfalloff: { path: 'falloff', kind: 'number', min: 0, max: 1, hint: 'What part of its amounts each one it went through takes off the next (0.3: a third)' },\n\treturns: { path: 'returns', kind: 'boolean', hint: 'Flies back to the caster once done, and what happens at its end happens there' },\n\thitsOnReturn: { path: 'hitsOnReturn', kind: 'boolean', hint: 'On its way back it hits what it passes through again' },\n\tseek: { path: 'seek', kind: 'number', min: 0, hint: 'Finds its own: flies after the nearest it may hit within this far' },\n\tonWall: { path: 'onWall', kind: 'rows', hint: 'What happens where it meets a wall (a cliff, ground nothing walks, a building, a tree), to the last it hit: it stops there' },\n\tsplit: { path: 'split', kind: 'rows', hint: 'What goes off from where it is, the way it flew, once done: missiles fly on from there at their spread' },\n\tsteer: { path: 'steer.rate', kind: 'number', min: 0, hint: 'Its owner turns it as it flies: at most so many radians a second (π when left out)' },\n\tfollow: { path: 'follow', options: ['caster', 'target'], hint: 'Goes with the caster or the target, the way it faces; ends when that one dies' },\n\tonEnter: { path: 'onEnter', kind: 'rows', hint: 'What happens to each who comes into it (its radius or shape), those inside as it is laid included' },\n\tonLeave: { path: 'onLeave', kind: 'rows', hint: 'What happens to each who goes out of it' },\n\tedge: { path: 'edge', kind: 'rows', hint: 'What happens to each who crosses its edge, in or out, once it is laid' },\n\tseconds: { path: 'seconds', kind: 'number', min: 0, hint: 'Seconds the pull takes' },\n\tarc: [\n\t\t{\n\t\t\tpath: 'arc.height',\n\t\t\tkind: 'number',\n\t\t\tmin: 0,\n\t\t\thint: 'Thrown: how high it goes in the middle of its way. It flies over everything and hits where it comes down'\n\t\t},\n\t\t{ path: 'arc.time', kind: 'number', min: 0, hint: 'Seconds it is in the air, however far it goes: its speed when left out' }\n\t],\n\tbounce: [\n\t\t{ path: 'bounce.count', kind: 'integer', min: 0, hint: 'How many times it springs on to the nearest it has not hit yet' },\n\t\t{ path: 'bounce.range', kind: 'number', min: 0, hint: 'How far away the next one it springs on to may be' },\n\t\t{ path: 'bounce.falloff', kind: 'number', min: 0, max: 1, hint: 'What part of its amounts each spring takes off (0.25: a quarter)' }\n\t],\n\tstack: { path: 'stack', kind: 'boolean', hint: 'Adds one to how many of the buff the target carries, up to what the buff allows' },\n\tsell: { path: 'sell', kind: 'text', hint: 'The resource traded away, by id' },\n\tbuy: { path: 'buy', kind: 'text', hint: 'The resource traded for, by id' },\n\trate: { path: 'rate', kind: 'number', min: 0, hint: 'How much of what is bought comes for each one sold' },\n\tbyMissingHealth: { path: 'byMissingHealth', kind: 'number', min: 0, hint: 'A part of the health the target has lost, added to the amount' },\n\tbyMaxHealth: { path: 'byMaxHealth', kind: 'number', min: 0, hint: \"A part of the target's max health, added to the amount (0.08: 8%)\" },\n\tbyCurrentHealth: { path: 'byCurrentHealth', kind: 'number', min: 0, hint: 'A part of the health the target has now, added to the amount' },\n\tbyStacks: [\n\t\t{ path: 'byStacks.buff', kind: 'id', of: 'buffs', hint: 'The buff whose stacks add to the amount' },\n\t\t{ path: 'byStacks.of', options: ['target', 'caster'], hint: 'Whose stacks: the target’s when left out' },\n\t\t{ path: 'byStacks.amount', kind: 'number', hint: 'How much each stack adds' }\n\t],\n\tbyDistance: [\n\t\t{ path: 'byDistance.per', kind: 'number', hint: 'How much more for every unit of distance it came (0.1: a tenth more)' },\n\t\t{ path: 'byDistance.most', kind: 'number', min: 1, hint: 'Times as much at the most' }\n\t],\n\t// a part of each of the target's stats: the common ones as fields, any other in the game's data\n\ttargetScaling: [\n\t\t{ path: 'targetScaling.health', kind: 'number', hint: \"A part of the target's max health, added to the amount\" },\n\t\t{ path: 'targetScaling.armor', kind: 'number', hint: \"A part of the target's armor, added to the amount\" },\n\t\t{ path: 'targetScaling.magicResist', kind: 'number', hint: \"A part of the target's magic resist, added to the amount\" }\n\t],\n\tbyDamage: { path: 'byDamage', kind: 'number', min: 0, hint: 'A part of the damage that set the trigger off, added to the amount' },\n\tinto: { path: 'into', kind: 'id', of: 'units', hint: 'The unit type the caster turns into: a form of the hero' },\n\ttoggle: { path: 'toggle', kind: 'boolean', hint: 'Lasts until the ability is cast again in the form, which turns it back' },\n\tback: {\n\t\tpath: 'back',\n\t\tkind: 'list',\n\t\thint: 'What turns it back (ability, time, death): the time and death when left out, and the ability with a toggle'\n\t}\n}\n"],"mappings":"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"}

package/dist/abilities/effectIndex.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Which effect of an ability something is, for the screen (E2E-PLAN AB19): a missile, a strike, a zone, a rush, by
+ * its place in the ability (`effectIndex`, `effectAt`), for the look of that effect (`AbilityLook.effects`)
+ */
+import { type AbilityDef, type EffectDef } from '#engine/defs';
+/**
+ * Where an effect is in its ability, as the screen is told it (`MissileState.effect`, the strike's `effect`,
+ * `AreaState.effect`): its place counting every effect of the ability first to last, each before those it holds (the
+ * first of `effects` is 0, the first it holds 1…). One a chain made (`EffectCommon.when`) counts as the one written.
+ * Undefined for one that is not in the ability (made up in code)
+ *
+ * @beta
+ */
+export declare function effectIndex(ability: AbilityDef, effect: EffectDef): number | undefined;
+/**
+ * The effect at a place in its ability (`effectIndex`): what a screen reads its type and its `look` from
+ *
+ * @beta
+ */
+export declare function effectAt(ability: AbilityDef, index: number): EffectDef | undefined;
+/**
+ * The effect a list of effects is of in its ability (a missile's `effects`, a zone's `onEnd`, a delay's `effects`):
+ * what a strike of that list is told as. Undefined for the ability's own list, or one not in it
+ *
+ * @beta
+ */
+export declare function effectOfList(ability: AbilityDef, list: readonly EffectDef[] | undefined): EffectDef | undefined;

package/dist/abilities/effectIndex.js

@@ -0,0 +1,64 @@
+import { loweredListOf, writtenEffect } from "../defs.js";
+//#region src/abilities/effectIndex.ts
+/**
+* Which effect of an ability something is, for the screen (E2E-PLAN AB19): a missile, a strike, a zone, a rush, by
+* its place in the ability (`effectIndex`, `effectAt`), for the look of that effect (`AbilityLook.effects`)
+*/
+var walked = /* @__PURE__ */ new WeakMap();
+/** Whether a value is a list of effects: objects with a `type` */
+var isEffects = (value) => Array.isArray(value) && value.length > 0 && value.every((each) => typeof each === "object" && each !== null && typeof each.type === "string");
+function walk(ability) {
+	let found = walked.get(ability);
+	if (found) return found;
+	found = {
+		effects: [],
+		index: /* @__PURE__ */ new Map(),
+		owners: /* @__PURE__ */ new Map()
+	};
+	const into = (list, owner) => {
+		if (owner) found.owners.set(list, owner);
+		for (const effect of list) {
+			if (!found.index.has(effect)) {
+				found.index.set(effect, found.effects.length);
+				found.effects.push(effect);
+			}
+			for (const value of Object.values(effect)) if (isEffects(value)) into(value, effect);
+		}
+	};
+	into(ability.effects ?? [], void 0);
+	walked.set(ability, found);
+	return found;
+}
+/**
+* Where an effect is in its ability, as the screen is told it (`MissileState.effect`, the strike's `effect`,
+* `AreaState.effect`): its place counting every effect of the ability first to last, each before those it holds (the
+* first of `effects` is 0, the first it holds 1…). One a chain made (`EffectCommon.when`) counts as the one written.
+* Undefined for one that is not in the ability (made up in code)
+*
+* @beta
+*/
+function effectIndex(ability, effect) {
+	return walk(ability).index.get(writtenEffect(effect));
+}
+/**
+* The effect at a place in its ability (`effectIndex`): what a screen reads its type and its `look` from
+*
+* @beta
+*/
+function effectAt(ability, index) {
+	return walk(ability).effects[index];
+}
+/**
+* The effect a list of effects is of in its ability (a missile's `effects`, a zone's `onEnd`, a delay's `effects`):
+* what a strike of that list is told as. Undefined for the ability's own list, or one not in it
+*
+* @beta
+*/
+function effectOfList(ability, list) {
+	if (!list) return void 0;
+	return loweredListOf(list) ?? walk(ability).owners.get(list);
+}
+//#endregion
+export { effectAt, effectIndex, effectOfList };
+
+//# sourceMappingURL=effectIndex.js.map

package/dist/abilities/effectIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectIndex.js","names":[],"sources":["../../src/abilities/effectIndex.ts"],"sourcesContent":["/**\n * Which effect of an ability something is, for the screen (E2E-PLAN AB19): a missile, a strike, a zone, a rush, by\n * its place in the ability (`effectIndex`, `effectAt`), for the look of that effect (`AbilityLook.effects`)\n */\nimport { type AbilityDef, type EffectDef, loweredListOf, writtenEffect } from '#engine/defs'\n\n/** An ability's effects as written, first to last and each before those it holds (depth first), and each list's owner */\ninterface Walked {\n\teffects: EffectDef[]\n\tindex: Map<EffectDef, number>\n\towners: Map<readonly EffectDef[], EffectDef>\n}\n\nconst walked = new WeakMap<AbilityDef, Walked>()\n\n/** Whether a value is a list of effects: objects with a `type` */\nconst isEffects = (value: unknown): value is EffectDef[] =>\n\tArray.isArray(value) &&\n\tvalue.length > 0 &&\n\tvalue.every((each) => typeof each === 'object' && each !== null && typeof (each as EffectDef).type === 'string')\n\nfunction walk(ability: AbilityDef): Walked {\n\tlet found = walked.get(ability)\n\tif (found) return found\n\tfound = { effects: [], index: new Map(), owners: new Map() }\n\tconst into = (list: readonly EffectDef[], owner: EffectDef | undefined) => {\n\t\tif (owner) found!.owners.set(list, owner)\n\t\tfor (const effect of list) {\n\t\t\tif (!found!.index.has(effect)) {\n\t\t\t\tfound!.index.set(effect, found!.effects.length)\n\t\t\t\tfound!.effects.push(effect)\n\t\t\t}\n\t\t\t// every list it holds, whatever its field: `effects`, `onEnd`, `onWall`, `split`, `otherwise`, a pack's own\n\t\t\tfor (const value of Object.values(effect)) if (isEffects(value)) into(value, effect)\n\t\t}\n\t}\n\tinto(ability.effects ?? [], undefined)\n\twalked.set(ability, found)\n\treturn found\n}\n\n/**\n * Where an effect is in its ability, as the screen is told it (`MissileState.effect`, the strike's `effect`,\n * `AreaState.effect`): its place counting every effect of the ability first to last, each before those it holds (the\n * first of `effects` is 0, the first it holds 1…). One a chain made (`EffectCommon.when`) counts as the one written.\n * Undefined for one that is not in the ability (made up in code)\n *\n * @beta\n */\nexport function effectIndex(ability: AbilityDef, effect: EffectDef): number | undefined {\n\treturn walk(ability).index.get(writtenEffect(effect))\n}\n\n/**\n * The effect at a place in its ability (`effectIndex`): what a screen reads its type and its `look` from\n *\n * @beta\n */\nexport function effectAt(ability: AbilityDef, index: number): EffectDef | undefined {\n\treturn walk(ability).effects[index]\n}\n\n/**\n * The effect a list of effects is of in its ability (a missile's `effects`, a zone's `onEnd`, a delay's `effects`):\n * what a strike of that list is told as. Undefined for the ability's own list, or one not in it\n *\n * @beta\n */\nexport function effectOfList(ability: AbilityDef, list: readonly EffectDef[] | undefined): EffectDef | undefined {\n\tif (!list) return undefined\n\treturn loweredListOf(list) ?? walk(ability).owners.get(list)\n}\n"],"mappings":";;;;;;AAaA,IAAM,yBAAS,IAAI,QAA4B;;AAG/C,IAAM,aAAa,UAClB,MAAM,QAAQ,KAAK,KACnB,MAAM,SAAS,KACf,MAAM,OAAO,SAAS,OAAO,SAAS,YAAY,SAAS,QAAQ,OAAQ,KAAmB,SAAS,QAAQ;AAEhH,SAAS,KAAK,SAA6B;CAC1C,IAAI,QAAQ,OAAO,IAAI,OAAO;CAC9B,IAAI,OAAO,OAAO;CAClB,QAAQ;EAAE,SAAS,CAAC;EAAG,uBAAO,IAAI,IAAI;EAAG,wBAAQ,IAAI,IAAI;CAAE;CAC3D,MAAM,QAAQ,MAA4B,UAAiC;EAC1E,IAAI,OAAO,MAAO,OAAO,IAAI,MAAM,KAAK;EACxC,KAAK,MAAM,UAAU,MAAM;GAC1B,IAAI,CAAC,MAAO,MAAM,IAAI,MAAM,GAAG;IAC9B,MAAO,MAAM,IAAI,QAAQ,MAAO,QAAQ,MAAM;IAC9C,MAAO,QAAQ,KAAK,MAAM;GAC3B;GAEA,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG,IAAI,UAAU,KAAK,GAAG,KAAK,OAAO,MAAM;EACpF;CACD;CACA,KAAK,QAAQ,WAAW,CAAC,GAAG,KAAA,CAAS;CACrC,OAAO,IAAI,SAAS,KAAK;CACzB,OAAO;AACR;;;;;;;;;AAUA,SAAgB,YAAY,SAAqB,QAAuC;CACvF,OAAO,KAAK,OAAO,CAAC,CAAC,MAAM,IAAI,cAAc,MAAM,CAAC;AACrD;;;;;;AAOA,SAAgB,SAAS,SAAqB,OAAsC;CACnF,OAAO,KAAK,OAAO,CAAC,CAAC,QAAQ;AAC9B;;;;;;;AAQA,SAAgB,aAAa,SAAqB,MAA+D;CAChH,IAAI,CAAC,MAAM,OAAO,KAAA;CAClB,OAAO,cAAc,IAAI,KAAK,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,IAAI;AAC5D"}

package/dist/abilities/effects/buff.d.ts

@@ -1,8 +1,14 @@
-export declare const buffEffect: import("../effects").EffectKind<"buff">;
+export declare const buffEffect: import("../effects").EffectType<"buff">;
 /**
  * Puts `buff` on the caster for as long as it likes, or takes it off when it has it: a stance, burrowing. Cast again to
  * come back out
  */
-export declare const toggleEffect: import("../effects").EffectKind<"toggle">;
+export declare const toggleEffect: import("../effects").EffectType<"toggle">;
+/**
+ * Takes off what holds them up from what it reaches (allies, when it says nothing): every harmful buff that stuns,
+ * roots, silences, disarms, takes their orders, grounds or slows them (`isCleansable`), but not a suppression and not
+ * being thrown up. Remove Scurvy, Quicksilver
+ */
+export declare const cleanseEffect: import("../effects").EffectType<"cleanse">;
 /** auras are kept up by the ability system, there is nothing to do at the moment of casting */
-export declare const auraEffect: import("../effects").EffectKind<"aura">;
+export declare const auraEffect: import("../effects").EffectType<"aura">;

package/dist/abilities/effects/buff.js

@@ -0,0 +1,84 @@
+import { applyBuff, hasBuff, isCleansable, removeBuff } from "../buffs.js";
+import { effectAmount, valueOf } from "../amounts.js";
+import { defineEffect, effectTargets } from "../effects.js";
+import { stacked } from "../triggers.js";
+//#region src/abilities/effects/buff.ts
+/**
+* Buffs: the engine's effects that put one on (`EffectTypes.buff`), switch one on and off (`toggle`), and keep one up
+* around the carrier (`aura`)
+*/
+var buffEffect = defineEffect({
+	type: "buff",
+	run: (context, effect) => {
+		if (!effect.buff) return;
+		const fallback = context.world.registry.buff(effect.buff).harmful ? "enemies" : "allies";
+		const shielded = effect.amount !== void 0 || effect.scaling !== void 0;
+		const power = shielded ? context.world.settings.combat.healPower(context.world, context.caster) : 1;
+		for (const entity of effectTargets(context, effect, fallback)) {
+			if (!entity.isUnit) continue;
+			const duration = effect.duration === void 0 ? void 0 : valueOf(context, effect.duration, entity);
+			applyBuff(context.world, entity, effect.buff, duration, context.caster, context.level, context.ability.id);
+			const instance = shielded || effect.stack ? entity.buffs.find((carried) => carried.id === effect.buff) : void 0;
+			if (instance && shielded) instance.shield = Math.max(instance.shield ?? 0, effectAmount(context, effect, entity, power));
+			if (!effect.stack) continue;
+			if (!instance) continue;
+			const before = instance.stacks ?? 0;
+			instance.stacks = Math.min(before + 1, context.world.registry.buff(effect.buff).maxStacks ?? Infinity);
+			stacked(context.world, entity, instance, before);
+		}
+	},
+	fields: [
+		"buff",
+		"duration",
+		"stack",
+		"amount",
+		"scaling",
+		"byMaxHealth",
+		"byCurrentHealth",
+		"byMissingHealth",
+		"byStacks",
+		"byDistance",
+		"targetScaling",
+		"byDamage"
+	]
+});
+/**
+* Puts `buff` on the caster for as long as it likes, or takes it off when it has it: a stance, burrowing. Cast again to
+* come back out
+*/
+var toggleEffect = defineEffect({
+	type: "toggle",
+	run: (context, effect) => {
+		const { world, caster } = context;
+		if (!effect.buff) return;
+		if (hasBuff(caster, effect.buff)) removeBuff(world, caster, effect.buff);
+		else applyBuff(world, caster, effect.buff, Infinity, caster, context.level, context.ability.id);
+	},
+	fields: ["buff"]
+});
+/**
+* Takes off what holds them up from what it reaches (allies, when it says nothing): every harmful buff that stuns,
+* roots, silences, disarms, takes their orders, grounds or slows them (`isCleansable`), but not a suppression and not
+* being thrown up. Remove Scurvy, Quicksilver
+*/
+var cleanseEffect = defineEffect({
+	type: "cleanse",
+	run: (context, effect) => {
+		const { world } = context;
+		for (const entity of effectTargets(context, effect, "allies")) for (let i = entity.buffs.length - 1; i >= 0; i--) {
+			const instance = entity.buffs[i];
+			if (instance && isCleansable(world.registry.buff(instance.id))) removeBuff(world, entity, instance.id);
+		}
+	},
+	fields: []
+});
+/** auras are kept up by the ability system, there is nothing to do at the moment of casting */
+var auraEffect = defineEffect({
+	type: "aura",
+	run: () => {},
+	fields: ["buff"]
+});
+//#endregion
+export { auraEffect, buffEffect, cleanseEffect, toggleEffect };
+
+//# sourceMappingURL=buff.js.map

package/dist/abilities/effects/buff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buff.js","names":[],"sources":["../../../src/abilities/effects/buff.ts"],"sourcesContent":["/**\n * Buffs: the engine's effects that put one on (`EffectTypes.buff`), switch one on and off (`toggle`), and keep one up\n * around the carrier (`aura`)\n */\nimport { applyBuff, hasBuff, isCleansable, removeBuff } from '../buffs'\nimport { defineEffect, effectTargets } from '../effects'\nimport { effectAmount, valueOf } from '../amounts'\nimport { stacked } from '../triggers'\n\nexport const buffEffect = defineEffect({ type: 'buff', run: (context, effect) => {\n\t\tif (!effect.buff) return\n\t\tconst fallback = context.world.registry.buff(effect.buff).harmful ? 'enemies' : 'allies'\n\t\tconst shielded = effect.amount !== undefined || effect.scaling !== undefined\n\t\tconst power = shielded ? context.world.settings.combat.healPower(context.world, context.caster) : 1\n\t\tfor (const entity of effectTargets(context, effect, fallback)) {\n\t\t\tif (!entity.isUnit) continue\n\t\t\tconst duration = effect.duration === undefined ? undefined : valueOf(context, effect.duration, entity)\n\t\t\tapplyBuff(context.world, entity, effect.buff, duration, context.caster, context.level, context.ability.id)\n\t\t\tconst instance = shielded || effect.stack ? entity.buffs.find((carried) => carried.id === effect.buff) : undefined\n\t\t\t// the shield the effect says, over the buff's own: as much as it holds now or this, whichever is more\n\t\t\tif (instance && shielded) instance.shield = Math.max(instance.shield ?? 0, effectAmount(context, effect, entity, power))\n\t\t\tif (!effect.stack) continue\n\t\t\t// one more of it, as many as the buff allows, and what it does at its most as it gets there (`onMaxStacks`)\n\t\t\tif (!instance) continue\n\t\t\tconst before = instance.stacks ?? 0\n\t\t\tinstance.stacks = Math.min(before + 1, context.world.registry.buff(effect.buff).maxStacks ?? Infinity)\n\t\t\tstacked(context.world, entity, instance, before)\n\t\t}\n\t}, fields: ['buff', 'duration', 'stack', 'amount', 'scaling', 'byMaxHealth', 'byCurrentHealth', 'byMissingHealth', 'byStacks', 'byDistance', 'targetScaling', 'byDamage'] })\n\n/**\n * Puts `buff` on the caster for as long as it likes, or takes it off when it has it: a stance, burrowing. Cast again to\n * come back out\n */\nexport const toggleEffect = defineEffect({ type: 'toggle', run: (context, effect) => {\n\t\tconst { world, caster } = context\n\t\tif (!effect.buff) return\n\t\tif (hasBuff(caster, effect.buff)) removeBuff(world, caster, effect.buff)\n\t\telse applyBuff(world, caster, effect.buff, Infinity, caster, context.level, context.ability.id)\n\t}, fields: ['buff'] })\n\n/**\n * Takes off what holds them up from what it reaches (allies, when it says nothing): every harmful buff that stuns,\n * roots, silences, disarms, takes their orders, grounds or slows them (`isCleansable`), but not a suppression and not\n * being thrown up. Remove Scurvy, Quicksilver\n */\nexport const cleanseEffect = defineEffect({ type: 'cleanse', run: (context, effect) => {\n\t\tconst { world } = context\n\t\tfor (const entity of effectTargets(context, effect, 'allies'))\n\t\t\tfor (let i = entity.buffs.length - 1; i >= 0; i--) {\n\t\t\t\tconst instance = entity.buffs[i]\n\t\t\t\tif (instance && isCleansable(world.registry.buff(instance.id))) removeBuff(world, entity, instance.id)\n\t\t\t}\n\t}, fields: [] })\n\n/** auras are kept up by the ability system, there is nothing to do at the moment of casting */\nexport const auraEffect = defineEffect({ type: 'aura', run: () => {}, fields: ['buff'] })\n"],"mappings":";;;;;;;;;AASA,IAAa,aAAa,aAAa;CAAE,MAAM;CAAQ,MAAM,SAAS,WAAW;EAC/E,IAAI,CAAC,OAAO,MAAM;EAClB,MAAM,WAAW,QAAQ,MAAM,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC,UAAU,YAAY;EAChF,MAAM,WAAW,OAAO,WAAW,KAAA,KAAa,OAAO,YAAY,KAAA;EACnE,MAAM,QAAQ,WAAW,QAAQ,MAAM,SAAS,OAAO,UAAU,QAAQ,OAAO,QAAQ,MAAM,IAAI;EAClG,KAAK,MAAM,UAAU,cAAc,SAAS,QAAQ,QAAQ,GAAG;GAC9D,IAAI,CAAC,OAAO,QAAQ;GACpB,MAAM,WAAW,OAAO,aAAa,KAAA,IAAY,KAAA,IAAY,QAAQ,SAAS,OAAO,UAAU,MAAM;GACrG,UAAU,QAAQ,OAAO,QAAQ,OAAO,MAAM,UAAU,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,EAAE;GACzG,MAAM,WAAW,YAAY,OAAO,QAAQ,OAAO,MAAM,MAAM,YAAY,QAAQ,OAAO,OAAO,IAAI,IAAI,KAAA;GAEzG,IAAI,YAAY,UAAU,SAAS,SAAS,KAAK,IAAI,SAAS,UAAU,GAAG,aAAa,SAAS,QAAQ,QAAQ,KAAK,CAAC;GACvH,IAAI,CAAC,OAAO,OAAO;GAEnB,IAAI,CAAC,UAAU;GACf,MAAM,SAAS,SAAS,UAAU;GAClC,SAAS,SAAS,KAAK,IAAI,SAAS,GAAG,QAAQ,MAAM,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC,aAAa,QAAQ;GACrG,QAAQ,QAAQ,OAAO,QAAQ,UAAU,MAAM;EAChD;CACD;CAAG,QAAQ;EAAC;EAAQ;EAAY;EAAS;EAAU;EAAW;EAAe;EAAmB;EAAmB;EAAY;EAAc;EAAiB;CAAU;AAAE,CAAC;;;;;AAM5K,IAAa,eAAe,aAAa;CAAE,MAAM;CAAU,MAAM,SAAS,WAAW;EACnF,MAAM,EAAE,OAAO,WAAW;EAC1B,IAAI,CAAC,OAAO,MAAM;EAClB,IAAI,QAAQ,QAAQ,OAAO,IAAI,GAAG,WAAW,OAAO,QAAQ,OAAO,IAAI;OAClE,UAAU,OAAO,QAAQ,OAAO,MAAM,UAAU,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,EAAE;CAC/F;CAAG,QAAQ,CAAC,MAAM;AAAE,CAAC;;;;;;AAOtB,IAAa,gBAAgB,aAAa;CAAE,MAAM;CAAW,MAAM,SAAS,WAAW;EACrF,MAAM,EAAE,UAAU;EAClB,KAAK,MAAM,UAAU,cAAc,SAAS,QAAQ,QAAQ,GAC3D,KAAK,IAAI,IAAI,OAAO,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK;GAClD,MAAM,WAAW,OAAO,MAAM;GAC9B,IAAI,YAAY,aAAa,MAAM,SAAS,KAAK,SAAS,EAAE,CAAC,GAAG,WAAW,OAAO,QAAQ,SAAS,EAAE;EACtG;CACF;CAAG,QAAQ,CAAC;AAAE,CAAC;;AAGhB,IAAa,aAAa,aAAa;CAAE,MAAM;CAAQ,WAAW,CAAC;CAAG,QAAQ,CAAC,MAAM;AAAE,CAAC"}

package/dist/abilities/effects/conditions.d.ts

@@ -0,0 +1,2 @@
+/** `effects` when what it asks holds, `otherwise` when not; with an area, for each within it, that one the target */
+export declare const ifEffect: import("../effects").EffectType<"if">;

package/dist/abilities/effects/conditions.js

@@ -0,0 +1,41 @@
+import { byChance, conditionHolds } from "../chance.js";
+import { run } from "../land.js";
+import { defineEffect, effectTargets } from "../effects.js";
+//#region src/abilities/effects/conditions.ts
+/**
+* The `if` effect (E2E-PLAN AB6): `effects` when what it asks of the caster and the target holds (and its `chance` draws
+* yes), `otherwise` when not; on the unit it was cast on, or on each within its area
+*/
+/** Whether what an `if` asks holds for one target (or none): the caster's, the target's, then the draw */
+var holds = (context, effect, target) => conditionHolds(context, effect.caster, context.caster) && conditionHolds(context, effect.target, target) && byChance(context, effect.chance, target);
+/** `effects` when what it asks holds, `otherwise` when not; with an area, for each within it, that one the target */
+var ifEffect = defineEffect({
+	type: "if",
+	run: (context, effect) => {
+		if (effect.radius === void 0 && effect.shape === void 0) {
+			run(context, holds(context, effect, context.target) ? effect.effects : effect.otherwise);
+			return;
+		}
+		for (const target of effectTargets(context, effect, "enemies")) {
+			const each = {
+				...context,
+				target,
+				point: {
+					x: target.pos.x,
+					z: target.pos.z
+				}
+			};
+			run(each, holds(each, effect, target) ? effect.effects : effect.otherwise);
+		}
+	},
+	fields: [
+		"caster",
+		"target",
+		"effects",
+		"otherwise"
+	]
+});
+//#endregion
+export { ifEffect };
+
+//# sourceMappingURL=conditions.js.map

package/dist/abilities/effects/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","names":[],"sources":["../../../src/abilities/effects/conditions.ts"],"sourcesContent":["/**\n * The `if` effect (E2E-PLAN AB6): `effects` when what it asks of the caster and the target holds (and its `chance` draws\n * yes), `otherwise` when not; on the unit it was cast on, or on each within its area\n */\nimport { byChance, conditionHolds } from '../chance'\nimport { defineEffect, type EffectContext, effectTargets } from '../effects'\nimport type { Entity } from '#engine/entity'\nimport type { EffectOf } from '#engine/defs'\nimport { run } from '../land'\n\n/** Whether what an `if` asks holds for one target (or none): the caster's, the target's, then the draw */\nconst holds = (context: EffectContext, effect: EffectOf<'if'>, target: Entity | undefined): boolean =>\n\tconditionHolds(context, effect.caster, context.caster) &&\n\tconditionHolds(context, effect.target, target) &&\n\tbyChance(context, effect.chance, target)\n\n/** `effects` when what it asks holds, `otherwise` when not; with an area, for each within it, that one the target */\nexport const ifEffect = defineEffect({\n\ttype: 'if',\n\trun: (context, effect) => {\n\t\tif (effect.radius === undefined && effect.shape === undefined) {\n\t\t\trun(context, holds(context, effect, context.target) ? effect.effects : effect.otherwise)\n\t\t\treturn\n\t\t}\n\t\tfor (const target of effectTargets(context, effect, 'enemies')) {\n\t\t\tconst each = { ...context, target, point: { x: target.pos.x, z: target.pos.z } }\n\t\t\trun(each, holds(each, effect, target) ? effect.effects : effect.otherwise)\n\t\t}\n\t},\n\tfields: ['caster', 'target', 'effects', 'otherwise']\n})\n"],"mappings":";;;;;;;;;AAWA,IAAM,SAAS,SAAwB,QAAwB,WAC9D,eAAe,SAAS,OAAO,QAAQ,QAAQ,MAAM,KACrD,eAAe,SAAS,OAAO,QAAQ,MAAM,KAC7C,SAAS,SAAS,OAAO,QAAQ,MAAM;;AAGxC,IAAa,WAAW,aAAa;CACpC,MAAM;CACN,MAAM,SAAS,WAAW;EACzB,IAAI,OAAO,WAAW,KAAA,KAAa,OAAO,UAAU,KAAA,GAAW;GAC9D,IAAI,SAAS,MAAM,SAAS,QAAQ,QAAQ,MAAM,IAAI,OAAO,UAAU,OAAO,SAAS;GACvF;EACD;EACA,KAAK,MAAM,UAAU,cAAc,SAAS,QAAQ,SAAS,GAAG;GAC/D,MAAM,OAAO;IAAE,GAAG;IAAS;IAAQ,OAAO;KAAE,GAAG,OAAO,IAAI;KAAG,GAAG,OAAO,IAAI;IAAE;GAAE;GAC/E,IAAI,MAAM,MAAM,MAAM,QAAQ,MAAM,IAAI,OAAO,UAAU,OAAO,SAAS;EAC1E;CACD;CACA,QAAQ;EAAC;EAAU;EAAU;EAAW;CAAW;AACpD,CAAC"}

package/dist/abilities/effects/core.js

@@ -0,0 +1,54 @@
+import { auraEffect, buffEffect, cleanseEffect, toggleEffect } from "./buff.js";
+import { damageEffect } from "./damage.js";
+import { ifEffect } from "./conditions.js";
+import { healEffect, manaEffect } from "./heal.js";
+import { missileEffect } from "./missile.js";
+import { morphEffect } from "./morph.js";
+import { blinkEffect, dashEffect, knockbackEffect, pullEffect, teleportEffect } from "./moves.js";
+import { chargedEffect, onAbilityHitEffect, onCastEffect, onDamagedEffect, onFatalEffect, onHitEffect, onKillEffect, onLowHealthEffect, refreshEffect, removeBuffEffect, resetAttackEffect } from "./passives.js";
+import { sendProxyEffect } from "./proxy.js";
+import { detectEffect, revealEffect } from "./sight.js";
+import { spawnEffect } from "./spawn.js";
+import { afterEffect, zoneEffect } from "./timed.js";
+import { exchangeEffect } from "./trade.js";
+//#region src/abilities/effects/core.ts
+/** @internal */
+var coreEffects = [
+	damageEffect,
+	healEffect,
+	manaEffect,
+	buffEffect,
+	missileEffect,
+	auraEffect,
+	spawnEffect,
+	toggleEffect,
+	revealEffect,
+	onHitEffect,
+	resetAttackEffect,
+	blinkEffect,
+	teleportEffect,
+	dashEffect,
+	knockbackEffect,
+	pullEffect,
+	refreshEffect,
+	onKillEffect,
+	onCastEffect,
+	chargedEffect,
+	afterEffect,
+	zoneEffect,
+	detectEffect,
+	exchangeEffect,
+	morphEffect,
+	onDamagedEffect,
+	onAbilityHitEffect,
+	onLowHealthEffect,
+	onFatalEffect,
+	removeBuffEffect,
+	cleanseEffect,
+	sendProxyEffect,
+	ifEffect
+];
+//#endregion
+export { coreEffects };
+
+//# sourceMappingURL=core.js.map

package/dist/abilities/effects/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","names":[],"sources":["../../../src/abilities/effects/core.ts"],"sourcesContent":["/**\n * The engine's kinds of effect, as the game is put together with them (`assembleGame`): a game's own of the same type\n * comes after and takes the place of one\n */\nimport type { EffectType } from '../effects'\nimport { auraEffect, buffEffect, cleanseEffect, toggleEffect } from './buff'\nimport { damageEffect } from './damage'\nimport { ifEffect } from './conditions'\nimport { healEffect, manaEffect } from './heal'\nimport { missileEffect } from './missile'\nimport { morphEffect } from './morph'\nimport { blinkEffect, dashEffect, knockbackEffect, pullEffect, teleportEffect } from './moves'\nimport {\n\tchargedEffect,\n\tonAbilityHitEffect,\n\tonCastEffect,\n\tonDamagedEffect,\n\tonHitEffect,\n\tonKillEffect,\n\tonFatalEffect,\n\tonLowHealthEffect,\n\trefreshEffect,\n\tremoveBuffEffect,\n\tresetAttackEffect\n} from './passives'\nimport { sendProxyEffect } from './proxy'\nimport { detectEffect, revealEffect } from './sight'\nimport { spawnEffect } from './spawn'\nimport { afterEffect, zoneEffect } from './timed'\nimport { exchangeEffect } from './trade'\n\n/** @internal */\nexport const coreEffects: readonly EffectType[] = [\n\tdamageEffect,\n\thealEffect,\n\tmanaEffect,\n\tbuffEffect,\n\tmissileEffect,\n\tauraEffect,\n\tspawnEffect,\n\ttoggleEffect,\n\trevealEffect,\n\tonHitEffect,\n\tresetAttackEffect,\n\tblinkEffect,\n\tteleportEffect,\n\tdashEffect,\n\tknockbackEffect,\n\tpullEffect,\n\trefreshEffect,\n\tonKillEffect,\n\tonCastEffect,\n\tchargedEffect,\n\tafterEffect,\n\tzoneEffect,\n\tdetectEffect,\n\texchangeEffect,\n\tmorphEffect,\n\tonDamagedEffect,\n\tonAbilityHitEffect,\n\tonLowHealthEffect,\n\tonFatalEffect,\n\tremoveBuffEffect,\n\tcleanseEffect,\n\tsendProxyEffect,\n\tifEffect\n]\n"],"mappings":";;;;;;;;;;;;;;;AAgCA,IAAa,cAAqC;CACjD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD"}

package/dist/abilities/effects/damage.d.ts

@@ -1 +1 @@
-export declare const damageEffect: import("../effects").EffectKind<"damage">;
+export declare const damageEffect: import("../effects").EffectType<"damage">;

package/dist/abilities/effects/damage.js

@@ -0,0 +1,43 @@
+import { effectAmount } from "../amounts.js";
+import { defineEffect, effectTargets } from "../effects.js";
+//#region src/abilities/effects/damage.ts
+/**
+* Damage: the engine's effect that hurts what it reaches (`EffectTypes.damage`)
+*/
+var damageEffect = defineEffect({
+	type: "damage",
+	run: (context, effect) => {
+		const { world, caster, level } = context;
+		const { how } = context.ability;
+		for (const entity of effectTargets(context, effect, "enemies")) {
+			const dealt = effectAmount(context, effect, entity);
+			world.damage(entity, dealt, caster, {
+				damageType: effect.damageType ?? "magic",
+				ability: context.ability.id,
+				how: effect.how ?? (typeof how === "function" ? how({
+					caster,
+					target: entity,
+					level,
+					amount: dealt
+				}) : how)
+			});
+		}
+	},
+	fields: [
+		"amount",
+		"scaling",
+		"damageType",
+		"how",
+		"byMissingHealth",
+		"byMaxHealth",
+		"byCurrentHealth",
+		"byStacks",
+		"byDistance",
+		"targetScaling",
+		"byDamage"
+	]
+});
+//#endregion
+export { damageEffect };
+
+//# sourceMappingURL=damage.js.map

package/dist/abilities/effects/damage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"damage.js","names":[],"sources":["../../../src/abilities/effects/damage.ts"],"sourcesContent":["/**\n * Damage: the engine's effect that hurts what it reaches (`EffectTypes.damage`)\n */\nimport { defineEffect, effectTargets } from '../effects'\nimport { effectAmount } from '../amounts'\n\nexport const damageEffect = defineEffect({ type: 'damage', run: (context, effect) => {\n\t\tconst { world, caster, level } = context\n\t\t// spells are magic, unless they say otherwise\n\t\t// how what it kills dies, for the screen: the effect's word, or the ability's, decided for each it hits\n\t\tconst { how } = context.ability\n\t\tfor (const entity of effectTargets(context, effect, 'enemies')) {\n\t\t\t// its amount for this one: code, the caster's stats, and what the target is (`byMissingHealth`, `byMaxHealth`...)\n\t\t\tconst dealt = effectAmount(context, effect, entity)\n\t\t\tworld.damage(entity, dealt, caster, {\n\t\t\t\tdamageType: effect.damageType ?? 'magic',\n\t\t\t\tability: context.ability.id,\n\t\t\t\thow: effect.how ?? (typeof how === 'function' ? how({ caster, target: entity, level, amount: dealt }) : how)\n\t\t\t})\n\t\t}\n\t}, fields: ['amount', 'scaling', 'damageType', 'how', 'byMissingHealth', 'byMaxHealth', 'byCurrentHealth', 'byStacks', 'byDistance', 'targetScaling', 'byDamage'] })\n"],"mappings":";;;;;;AAMA,IAAa,eAAe,aAAa;CAAE,MAAM;CAAU,MAAM,SAAS,WAAW;EACnF,MAAM,EAAE,OAAO,QAAQ,UAAU;EAGjC,MAAM,EAAE,QAAQ,QAAQ;EACxB,KAAK,MAAM,UAAU,cAAc,SAAS,QAAQ,SAAS,GAAG;GAE/D,MAAM,QAAQ,aAAa,SAAS,QAAQ,MAAM;GAClD,MAAM,OAAO,QAAQ,OAAO,QAAQ;IACnC,YAAY,OAAO,cAAc;IACjC,SAAS,QAAQ,QAAQ;IACzB,KAAK,OAAO,QAAQ,OAAO,QAAQ,aAAa,IAAI;KAAE;KAAQ,QAAQ;KAAQ;KAAO,QAAQ;IAAM,CAAC,IAAI;GACzG,CAAC;EACF;CACD;CAAG,QAAQ;EAAC;EAAU;EAAW;EAAc;EAAO;EAAmB;EAAe;EAAmB;EAAY;EAAc;EAAiB;CAAU;AAAE,CAAC"}

package/dist/abilities/effects/heal.d.ts

@@ -1,2 +1,2 @@
-export declare const healEffect: import("../effects").EffectKind<"heal">;
-export declare const manaEffect: import("../effects").EffectKind<"mana">;
+export declare const healEffect: import("../effects").EffectType<"heal">;
+export declare const manaEffect: import("../effects").EffectType<"mana">;

package/dist/abilities/effects/heal.js

@@ -0,0 +1,51 @@
+import { manaChanged } from "../../engineEvents.js";
+import { scaled } from "../scaled.js";
+import { effectAmount, valueOf } from "../amounts.js";
+import { defineEffect, effectTargets } from "../effects.js";
+//#region src/abilities/effects/heal.ts
+/**
+* Healing and mana: the engine's effects that give back (`EffectTypes.heal`, `mana`)
+*/
+var healEffect = defineEffect({
+	type: "heal",
+	run: (context, effect) => {
+		const { world, caster } = context;
+		const power = world.settings.combat.healPower(world, caster);
+		for (const entity of effectTargets(context, effect, "allies")) if (entity.isUnit && !entity.def.invulnerable && !entity.def.targetableBy) world.heal(entity, effectAmount(context, effect, entity, power), caster);
+	},
+	fields: [
+		"amount",
+		"scaling",
+		"byMissingHealth",
+		"byMaxHealth",
+		"byCurrentHealth",
+		"byStacks",
+		"byDistance",
+		"targetScaling",
+		"byDamage"
+	]
+});
+var manaEffect = defineEffect({
+	type: "mana",
+	run: (context, effect) => {
+		const { world, caster, level } = context;
+		const coded = typeof effect.amount === "function";
+		const once = coded ? 0 : scaled(world, caster, valueOf(context, effect.amount), effect.scaling, level) * (context.share ?? 1);
+		for (const entity of effectTargets(context, effect, "allies")) {
+			const amount = coded ? scaled(world, caster, valueOf(context, effect.amount, entity), effect.scaling, level) * (context.share ?? 1) : once;
+			const given = Math.min(entity.mana + amount, entity.maxMana) - entity.mana;
+			entity.mana += given;
+			if (given !== 0) world.events.emit(manaChanged, {
+				entity,
+				amount: given,
+				ability: context.ability.id,
+				source: caster
+			});
+		}
+	},
+	fields: ["amount", "scaling"]
+});
+//#endregion
+export { healEffect, manaEffect };
+
+//# sourceMappingURL=heal.js.map

package/dist/abilities/effects/heal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal.js","names":[],"sources":["../../../src/abilities/effects/heal.ts"],"sourcesContent":["/**\n * Healing and mana: the engine's effects that give back (`EffectTypes.heal`, `mana`)\n */\nimport { manaChanged } from '#engine/engineEvents'\nimport { defineEffect, effectTargets } from '../effects'\nimport { scaled } from '../scaled'\nimport { effectAmount, valueOf } from '../amounts'\n\nexport const healEffect = defineEffect({ type: 'heal', run: (context, effect) => {\n\t\tconst { world, caster } = context\n\t\tconst power = world.settings.combat.healPower(world, caster)\n\t\tfor (const entity of effectTargets(context, effect, 'allies')) {\n\t\t\tif (entity.isUnit && !entity.def.invulnerable && !entity.def.targetableBy) world.heal(entity, effectAmount(context, effect, entity, power), caster)\n\t\t}\n\t}, fields: ['amount', 'scaling', 'byMissingHealth', 'byMaxHealth', 'byCurrentHealth', 'byStacks', 'byDistance', 'targetScaling', 'byDamage'] })\n\nexport const manaEffect = defineEffect({ type: 'mana', run: (context, effect) => {\n\t\tconst { world, caster, level } = context\n\t\tconst coded = typeof effect.amount === 'function'\n\t\tconst once = coded ? 0 : scaled(world, caster, valueOf(context, effect.amount), effect.scaling, level) * (context.share ?? 1)\n\t\tfor (const entity of effectTargets(context, effect, 'allies')) {\n\t\t\tconst amount = coded ? scaled(world, caster, valueOf(context, effect.amount, entity), effect.scaling, level) * (context.share ?? 1) : once\n\t\t\tconst given = Math.min(entity.mana + amount, entity.maxMana) - entity.mana\n\t\t\tentity.mana += given\n\t\t\tif (given !== 0) world.events.emit(manaChanged, { entity, amount: given, ability: context.ability.id, source: caster })\n\t\t}\n\t}, fields: ['amount', 'scaling'] })\n"],"mappings":";;;;;;;;AAQA,IAAa,aAAa,aAAa;CAAE,MAAM;CAAQ,MAAM,SAAS,WAAW;EAC/E,MAAM,EAAE,OAAO,WAAW;EAC1B,MAAM,QAAQ,MAAM,SAAS,OAAO,UAAU,OAAO,MAAM;EAC3D,KAAK,MAAM,UAAU,cAAc,SAAS,QAAQ,QAAQ,GAC3D,IAAI,OAAO,UAAU,CAAC,OAAO,IAAI,gBAAgB,CAAC,OAAO,IAAI,cAAc,MAAM,KAAK,QAAQ,aAAa,SAAS,QAAQ,QAAQ,KAAK,GAAG,MAAM;CAEpJ;CAAG,QAAQ;EAAC;EAAU;EAAW;EAAmB;EAAe;EAAmB;EAAY;EAAc;EAAiB;CAAU;AAAE,CAAC;AAE/I,IAAa,aAAa,aAAa;CAAE,MAAM;CAAQ,MAAM,SAAS,WAAW;EAC/E,MAAM,EAAE,OAAO,QAAQ,UAAU;EACjC,MAAM,QAAQ,OAAO,OAAO,WAAW;EACvC,MAAM,OAAO,QAAQ,IAAI,OAAO,OAAO,QAAQ,QAAQ,SAAS,OAAO,MAAM,GAAG,OAAO,SAAS,KAAK,KAAK,QAAQ,SAAS;EAC3H,KAAK,MAAM,UAAU,cAAc,SAAS,QAAQ,QAAQ,GAAG;GAC9D,MAAM,SAAS,QAAQ,OAAO,OAAO,QAAQ,QAAQ,SAAS,OAAO,QAAQ,MAAM,GAAG,OAAO,SAAS,KAAK,KAAK,QAAQ,SAAS,KAAK;GACtI,MAAM,QAAQ,KAAK,IAAI,OAAO,OAAO,QAAQ,OAAO,OAAO,IAAI,OAAO;GACtE,OAAO,QAAQ;GACf,IAAI,UAAU,GAAG,MAAM,OAAO,KAAK,aAAa;IAAE;IAAQ,QAAQ;IAAO,SAAS,QAAQ,QAAQ;IAAI,QAAQ;GAAO,CAAC;EACvH;CACD;CAAG,QAAQ,CAAC,UAAU,SAAS;AAAE,CAAC"}

package/dist/abilities/effects/missile.d.ts

@@ -1 +1,13 @@
-export declare const missileEffect: import("../effects").EffectKind<"missile">;
+import { type EffectOf } from '#engine/defs';
+import type { Missile } from '#engine/world';
+import { type EffectContext } from '../effects';
+/**
+ * Sends the missiles of a missile effect (`EffectTypes.missile`) off, as the engine's `missile` effect does, and hands
+ * them back: what a game's own effect does that wraps a missile (and keeps it, to steer it, or take it out with
+ * `removeMissile`). They go off from the context's `origin` (a ball, a shadow) when it has one, the caster's place
+ * otherwise, towards its `point` (its `target`, homing); they are the caster's, and what they hit is in its name
+ *
+ * @beta
+ */
+export declare function launchMissile(context: EffectContext, effect: EffectOf<'missile'>): Missile[];
+export declare const missileEffect: import("../effects").EffectType<"missile">;

package/dist/abilities/effects/missile.js

@@ -0,0 +1,104 @@
+import { atan2, cos, hypot, sin } from "../../exactMath.js";
+import { dist } from "../../math.js";
+import { at } from "../../defs.js";
+import { missileSpawned } from "../../engineEvents.js";
+import { effectOrigin } from "../land.js";
+import { valueOf } from "../amounts.js";
+import { defineEffect } from "../effects.js";
+//#region src/abilities/effects/missile.ts
+/**
+* Missiles: the engine's effect that sends what flies (`EffectTypes.missile`), shot or thrown in an arc; what they do
+* on the way, and where they spring on to, is `updateMissiles`'
+*/
+/**
+* Sends the missiles of a missile effect (`EffectTypes.missile`) off, as the engine's `missile` effect does, and hands
+* them back: what a game's own effect does that wraps a missile (and keeps it, to steer it, or take it out with
+* `removeMissile`). They go off from the context's `origin` (a ball, a shadow) when it has one, the caster's place
+* otherwise, towards its `point` (its `target`, homing); they are the caster's, and what they hit is in its name
+*
+* @beta
+*/
+function launchMissile(context, effect) {
+	const { world, caster, ability, level, point, target } = context;
+	const from = effectOrigin(context);
+	const aim = effect.homing && target ? target.pos : point;
+	const dx = aim.x - from.x;
+	const dz = aim.z - from.z;
+	const length = hypot(dx, dz);
+	const heading = length > .01 ? atan2(dx, dz) : caster.facing;
+	const count = Math.max(Math.round(at(effect.count, level, 1)), 1);
+	const range = at(effect.distance, level, effect.toPoint ? Infinity : 10);
+	const hit = /* @__PURE__ */ new Set();
+	const homing = effect.homing && target;
+	const left = homing ? Infinity : effect.toPoint ? Math.min(length, range) : range;
+	const time = effect.arc?.time;
+	const way = homing ? dist(from, target.pos) : left;
+	const speed = time && time > 0 && Number.isFinite(way) ? way / time : effect.speed ?? 10;
+	const sent = [];
+	for (let i = 0; i < count; i++) {
+		const angle = heading + (count > 1 ? (effect.spread ?? 0) * (i / (count - 1) - .5) : 0);
+		const missile = {
+			id: world.newId(),
+			owner: caster.owner,
+			source: caster.id,
+			ability: ability.id,
+			level,
+			x: from.x,
+			z: from.z,
+			prevX: from.x,
+			prevZ: from.z,
+			dx: sin(angle),
+			dz: cos(angle),
+			speed,
+			left,
+			delay: at(effect.delay, level),
+			forms: at(effect.delay, level),
+			radius: valueOf(context, effect.radius, void 0, 1),
+			effect,
+			hit,
+			target: homing ? target.id : 0,
+			travelled: 0,
+			leg: 0,
+			height: 0,
+			bounces: 0,
+			stopped: false,
+			...effect.onWall && { floor: world.terrain.levelAt(from.x, from.z) },
+			...context.held !== void 0 && { held: context.held }
+		};
+		world.missiles.push(missile);
+		world.events.emit(missileSpawned, missile);
+		sent.push(missile);
+	}
+	return sent;
+}
+var missileEffect = defineEffect({
+	type: "missile",
+	run: (context, effect) => void launchMissile(context, effect),
+	fields: [
+		"speed",
+		"distance",
+		"count",
+		"spread",
+		"homing",
+		"toPoint",
+		"delay",
+		"sight",
+		"blocked",
+		"pierce",
+		"falloff",
+		"arc",
+		"bounce",
+		"returns",
+		"hitsOnReturn",
+		"seek",
+		"steer",
+		"effects",
+		"onEnd",
+		"onWall",
+		"split"
+	]
+});
+//#endregion
+export { launchMissile, missileEffect };
+
+//# sourceMappingURL=missile.js.map