@v12-engine/engine 0.1.1 → 0.4.0

package/dist/summons.js

@@ -0,0 +1,271 @@
+import { cos, hypot, sin } from "./exactMath.js";
+import { at } from "./defs.js";
+import { defineComponent } from "./components.js";
+import { refreshVitals } from "./stats.js";
+import { snapshotField } from "./replication.js";
+import { heroOf } from "./hero.js";
+import { defineHook } from "./hooks.js";
+import { summoned } from "./summoned.js";
+import { valueOf } from "./abilities/amounts.js";
+import { defineEffect, mayReach } from "./abilities/effects.js";
+//#region src/summons.ts
+/**
+* The corpses of a world. Saved with it
+*
+* @beta
+*/
+var corpses = defineComponent({
+	id: "core.corpses",
+	default: () => []
+});
+/**
+* On an illusion: whose copy it is, the part of its damage it deals, and how much more it takes. Told to its side
+* only: to everyone else it is the real one
+*
+* @beta
+*/
+var illusion = defineComponent({
+	id: "core.illusion",
+	replicate: "allies"
+});
+/** Whether a unit leaves a corpse: one of flesh (`UnitTypeDef.corpse`), and not one a spell brought */
+/**
+* How long a unit's corpse lies, in seconds, or nothing for none: a unit of flesh does, for the game's time, unless a
+* spell brought it; its type may say no, or decide for this death (`UnitTypeDef.corpse`)
+*/
+function corpseTime(world, entity) {
+	if (!entity.isUnit || entity.has(summoned) || entity.has(illusion)) return void 0;
+	const declared = entity.def.corpse;
+	const decided = typeof declared === "function" ? declared(world, entity) : declared ?? true;
+	if (decided === false) return void 0;
+	const seconds = decided === true ? world.settings.combat.corpseTime : decided;
+	return seconds > 0 ? seconds : void 0;
+}
+/**
+* Takes up to `most` corpses nearest a point, within `radius`, out of the world, and gives them; `which`, those of them
+* it may take (the caster's allies', for a resurrection)
+*
+* @beta
+*/
+function takeCorpses(world, point, radius, most, which) {
+	const all = world.state(corpses);
+	const near = all.filter((corpse) => hypot(corpse.x - point.x, corpse.z - point.z) <= radius && (!which || which(corpse))).sort((a, b) => hypot(a.x - point.x, a.z - point.z) - hypot(b.x - point.x, b.z - point.z)).slice(0, most);
+	world.setState(corpses, all.filter((corpse) => !near.includes(corpse)));
+	return near;
+}
+/**
+* Corpses rot away in their time. Once a second
+*
+* @internal
+*/
+var corpseSystem = {
+	name: "corpses",
+	phase: "cleanup",
+	every: 30,
+	update(world) {
+		const all = world.state(corpses);
+		if (all.some((corpse) => corpse.until <= world.time)) world.setState(corpses, all.filter((corpse) => corpse.until > world.time));
+	}
+};
+/**
+* What happens around the dead, and what illusions do: a corpse where a unit of flesh fell; nothing to gain for killing
+* an illusion (see the core hooks of `features.ts`); and an illusion's blows and the blows it takes, changed
+*
+* @internal
+*/
+var summonHooks = [defineHook({
+	hook: "death",
+	id: "corpse",
+	run(world, { entity }) {
+		const seconds = corpseTime(world, entity);
+		if (seconds === void 0) return;
+		world.state(corpses).push({
+			id: entity.id,
+			type: entity.def.id,
+			owner: entity.owner,
+			x: entity.pos.x,
+			z: entity.pos.z,
+			until: world.time + seconds
+		});
+	}
+}), defineHook({
+	hook: "beforeDamage",
+	id: "illusions",
+	run(_world, event) {
+		const dealt = event.source?.get(illusion)?.dealt;
+		const taken = event.target.get(illusion)?.taken;
+		if (dealt !== void 0) event.amount *= dealt;
+		if (taken !== void 0) event.amount *= taken;
+	}
+})];
+/**
+* Whether killing an entity gains its killer nothing: an illusion
+*
+* @beta
+*/
+var worthless = (entity) => entity.has(illusion);
+/**
+* The effect types that bring units in: `summon`, `raiseDead` and `illusion`, registered with the engine's effects
+*
+* @internal
+*/
+var summonEffects = [
+	defineEffect({
+		type: "summon",
+		run: (context, effect) => {
+			const { world, caster, point, level } = context;
+			if (!effect.unit) return;
+			const count = Math.max(Math.round(at(effect.count, level, 1)), 1);
+			const lifetime = effect.lifetime === void 0 ? void 0 : at(effect.lifetime, level);
+			const around = count > 1 ? effect.spread ?? 1.5 : 0;
+			for (let i = 0; i < count; i++) {
+				const angle = i / count * Math.PI * 2;
+				const where = {
+					x: point.x + sin(angle) * around,
+					z: point.z + cos(angle) * around
+				};
+				world.spawn(effect.unit, caster.owner, where, {
+					facing: caster.facing,
+					lifetime
+				}).set(summoned, {
+					by: caster.id,
+					follow: effect.follow ?? true,
+					aggro: effect.aggro ?? "mastersAttacker",
+					diesWithMaster: effect.diesWithMaster ?? true,
+					at: world.time
+				});
+			}
+		},
+		fields: [
+			"unit",
+			"count",
+			{
+				path: "lifetime",
+				kind: "number",
+				min: 0,
+				hint: "Seconds they stay: for good when left out"
+			},
+			{
+				path: "spread",
+				kind: "number",
+				min: 0,
+				hint: "How many cells around where it landed they appear"
+			},
+			{
+				path: "follow",
+				kind: "boolean",
+				hint: "Walk with the caster when there is nothing to attack: yes when left out"
+			},
+			{
+				path: "aggro",
+				options: [
+					"nearest",
+					"mastersAttacker",
+					"none"
+				],
+				hint: "Whom they go for: whoever hits the caster first when left out"
+			},
+			{
+				path: "diesWithMaster",
+				kind: "boolean",
+				hint: "Die when the caster does: yes when left out"
+			}
+		]
+	}),
+	defineEffect({
+		type: "raiseDead",
+		run: (context, effect) => {
+			const { world, caster, point, level } = context;
+			const themselves = effect.as === "themselves";
+			if (!effect.unit && !themselves) return;
+			const lifetime = effect.duration === void 0 ? void 0 : valueOf(context, effect.duration);
+			const which = themselves ? (corpse) => world.registry.units.has(corpse.type) : void 0;
+			for (const corpse of takeCorpses(world, point, valueOf(context, effect.radius, void 0, 6), Math.round(at(effect.count, level, 2)), which)) world.spawn(themselves ? corpse.type : effect.unit, caster.owner, corpse, {
+				facing: caster.facing,
+				lifetime
+			}).set(summoned, { by: caster.id });
+		},
+		fields: [
+			"unit",
+			"as",
+			"duration",
+			"count"
+		]
+	}),
+	defineEffect({
+		type: "revive",
+		run: (context, effect) => {
+			const { world, caster, point, level } = context;
+			const most = effect.count === void 0 ? Infinity : Math.round(at(effect.count, level));
+			const which = (corpse) => world.registry.units.has(corpse.type) && world.areAllies(caster.owner, corpse.owner) && world.players.has(corpse.owner);
+			for (const corpse of takeCorpses(world, point, valueOf(context, effect.radius, void 0, 6), most, which)) world.spawn(corpse.type, corpse.owner, corpse, { facing: caster.facing });
+		},
+		fields: ["count"]
+	}),
+	defineEffect({
+		type: "illusion",
+		run: (context, effect) => {
+			const { world, caster, level } = context;
+			const original = context.target ?? caster;
+			if (original !== caster && !mayReach(context, effect, original)) return;
+			const count = Math.round(at(effect.count, level, 1));
+			const lifetime = valueOf(context, effect.duration, original, 30);
+			for (let i = 0; i < count; i++) {
+				const angle = i / count * Math.PI * 2 + world.rng.next();
+				const at2 = {
+					x: original.pos.x + sin(angle) * 1.5,
+					z: original.pos.z + cos(angle) * 1.5
+				};
+				const copy = world.spawn(original.def.id, caster.owner, at2, {
+					facing: original.facing,
+					lifetime
+				});
+				copy.set(illusion, {
+					of: original.id,
+					dealt: effect.dealt ?? 1 / 3,
+					taken: effect.taken ?? 2
+				});
+				const was = heroOf(original);
+				const hero = heroOf(copy);
+				if (was && hero) {
+					hero.level = was.level;
+					hero.xp = was.xp;
+					refreshVitals(world, copy);
+				}
+				copy.health = copy.maxHealth * (original.health / original.maxHealth);
+				copy.mana = Math.min(original.mana, copy.maxMana);
+			}
+		},
+		fields: [
+			"count",
+			"duration",
+			{
+				path: "dealt",
+				kind: "number",
+				min: 0,
+				hint: "What of its damage the copies deal: a third when left out"
+			},
+			{
+				path: "taken",
+				kind: "number",
+				min: 0,
+				hint: "Times what they are dealt the copies take: twice when left out"
+			}
+		]
+	})
+];
+/** The corpses where the player sees (`Snapshot.corpses`): none to a computer, and left out where there are none */
+var corpsesPart = snapshotField("corpses", (view) => {
+	if (view.forComputer) return void 0;
+	const seen = view.world.state(corpses).filter((corpse) => view.sees(corpse.x, corpse.z)).map(({ id, type, x, z }) => ({
+		id,
+		type,
+		x,
+		z
+	}));
+	return seen.length ? seen : void 0;
+});
+//#endregion
+export { corpseSystem, corpses, corpsesPart, illusion, summonEffects, summonHooks, summoned, takeCorpses, worthless };
+
+//# sourceMappingURL=summons.js.map

package/dist/summons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summons.js","names":[],"sources":["../src/summons.ts"],"sourcesContent":["import { at } from './defs'\nimport { defineComponent } from './components'\nimport type { Entity, PlayerId } from './entity'\nimport { defineHook, type HookDef } from './hooks'\nimport type { Vec2 } from './math'\nimport { refreshVitals } from './stats'\nimport { defineEffect, type EffectType, mayReach } from './abilities/effects'\nimport { valueOf } from './abilities/amounts'\nimport type { World } from './world'\nimport { cos, hypot, sin } from './exactMath'\nimport { heroOf } from './hero'\nimport { snapshotField } from './replication'\nimport { summoned } from './summoned'\n\nexport { summoned }\n\n/*\n * Corpses, and what is brought into the world by a spell: units raised from the dead, and illusions. What dies of flesh\n * leaves a corpse for a while, which spells use up (`raiseDead`); what a spell brings is `summoned`, which dispelling\n * hurts; an illusion is a copy of a unit that deals a part of its damage and takes more, that its side can tell from\n * the real one and nobody else can\n */\n\n/**\n * What is left of a unit that died, for a while (see `corpses`)\n *\n * @beta\n */\nexport interface Corpse {\n\t/** The id the unit had: the screen keeps its body lying for as long as the corpse is there */\n\tid: number\n\t/** The unit type the dead unit was */\n\ttype: string\n\t/** The player who owned the dead unit */\n\towner: PlayerId\n\t/** Where the corpse lies, east-west */\n\tx: number\n\t/** Where the corpse lies, north-south */\n\tz: number\n\t/** When it is gone, in seconds of the game */\n\tuntil: number\n}\n\n/**\n * The corpses of a world. Saved with it\n *\n * @beta\n */\nexport const corpses = defineComponent<Corpse[]>({ id: 'core.corpses', default: () => [] })\n\n/**\n * On an illusion: whose copy it is, the part of its damage it deals, and how much more it takes. Told to its side\n * only: to everyone else it is the real one\n *\n * @beta\n */\nexport const illusion = defineComponent<{ of: number; dealt: number; taken: number }>({ id: 'core.illusion', replicate: 'allies' })\n\n/** Whether a unit leaves a corpse: one of flesh (`UnitTypeDef.corpse`), and not one a spell brought */\n/**\n * How long a unit's corpse lies, in seconds, or nothing for none: a unit of flesh does, for the game's time, unless a\n * spell brought it; its type may say no, or decide for this death (`UnitTypeDef.corpse`)\n */\nfunction corpseTime(world: World, entity: Entity): number | undefined {\n\tif (!entity.isUnit || entity.has(summoned) || entity.has(illusion)) return undefined\n\tconst declared = entity.def.corpse\n\tconst decided = typeof declared === 'function' ? declared(world, entity) : (declared ?? true)\n\tif (decided === false) return undefined\n\tconst seconds = decided === true ? world.settings.combat.corpseTime : decided\n\treturn seconds > 0 ? seconds : undefined\n}\n\n/**\n * Takes up to `most` corpses nearest a point, within `radius`, out of the world, and gives them; `which`, those of them\n * it may take (the caster's allies', for a resurrection)\n *\n * @beta\n */\nexport function takeCorpses(world: World, point: Vec2, radius: number, most: number, which?: (corpse: Corpse) => boolean): Corpse[] {\n\tconst all = world.state(corpses)\n\tconst near = all\n\t\t.filter((corpse) => hypot(corpse.x - point.x, corpse.z - point.z) <= radius && (!which || which(corpse)))\n\t\t.sort((a, b) => hypot(a.x - point.x, a.z - point.z) - hypot(b.x - point.x, b.z - point.z))\n\t\t.slice(0, most)\n\tworld.setState(\n\t\tcorpses,\n\t\tall.filter((corpse) => !near.includes(corpse))\n\t)\n\treturn near\n}\n\n/**\n * Corpses rot away in their time. Once a second\n *\n * @internal\n */\nexport const corpseSystem = {\n\tname: 'corpses',\n\tphase: 'cleanup' as const,\n\tevery: 30,\n\tupdate(world: World): void {\n\t\tconst all = world.state(corpses)\n\t\tif (all.some((corpse) => corpse.until <= world.time))\n\t\t\tworld.setState(\n\t\t\t\tcorpses,\n\t\t\t\tall.filter((corpse) => corpse.until > world.time)\n\t\t\t)\n\t}\n}\n\n/**\n * What happens around the dead, and what illusions do: a corpse where a unit of flesh fell; nothing to gain for killing\n * an illusion (see the core hooks of `features.ts`); and an illusion's blows and the blows it takes, changed\n *\n * @internal\n */\nexport const summonHooks: HookDef[] = [\n\tdefineHook({\n\t\thook: 'death',\n\t\tid: 'corpse',\n\t\trun(world, { entity }) {\n\t\t\tconst seconds = corpseTime(world, entity)\n\t\t\tif (seconds === undefined) return\n\t\t\tworld\n\t\t\t\t.state(corpses)\n\t\t\t\t.push({ id: entity.id, type: entity.def.id, owner: entity.owner, x: entity.pos.x, z: entity.pos.z, until: world.time + seconds })\n\t\t}\n\t}),\n\tdefineHook({\n\t\thook: 'beforeDamage',\n\t\tid: 'illusions',\n\t\trun(_world, event) {\n\t\t\tconst dealt = event.source?.get(illusion)?.dealt\n\t\t\tconst taken = event.target.get(illusion)?.taken\n\t\t\tif (dealt !== undefined) event.amount *= dealt\n\t\t\tif (taken !== undefined) event.amount *= taken\n\t\t}\n\t})\n]\n\n/**\n * Whether killing an entity gains its killer nothing: an illusion\n *\n * @beta\n */\nexport const worthless = (entity: Entity) => entity.has(illusion)\n\n/**\n * The effect types that bring units in: `summon`, `raiseDead` and `illusion`, registered with the engine's effects\n *\n * @internal\n */\nexport const summonEffects: EffectType[] = [\n\t/**\n\t * Brings `count` (1) units of `unit` into the world around where it landed, `spread` cells from it (1.5), for\n\t * `lifetime` seconds (for good when left out), the caster's owner's, its summons (`summoned`): with nothing to do\n\t * they walk with the caster when `follow` (true), they go for what an idle unit finds, and with `aggro` (default\n\t * `mastersAttacker`) for whoever hits the caster first; they die with the caster unless `diesWithMaster` is false\n\t *\n\t * @beta\n\t */\n\tdefineEffect({ type: 'summon', run: (context, effect) => {\n\t\t\tconst { world, caster, point, level } = context\n\t\t\tif (!effect.unit) return\n\t\t\tconst count = Math.max(Math.round(at(effect.count, level, 1)), 1)\n\t\t\tconst lifetime = effect.lifetime === undefined ? undefined : at(effect.lifetime, level)\n\t\t\tconst around = count > 1 ? (effect.spread ?? 1.5) : 0\n\t\t\tfor (let i = 0; i < count; i++) {\n\t\t\t\tconst angle = (i / count) * Math.PI * 2\n\t\t\t\tconst where = { x: point.x + sin(angle) * around, z: point.z + cos(angle) * around }\n\t\t\t\tconst brought = world.spawn(effect.unit, caster.owner, where, { facing: caster.facing, lifetime })\n\t\t\t\tbrought.set(summoned, {\n\t\t\t\t\tby: caster.id,\n\t\t\t\t\tfollow: effect.follow ?? true,\n\t\t\t\t\taggro: effect.aggro ?? 'mastersAttacker',\n\t\t\t\t\tdiesWithMaster: effect.diesWithMaster ?? true,\n\t\t\t\t\tat: world.time\n\t\t\t\t})\n\t\t\t}\n\t\t}, fields: [\n\t\t\t\t'unit',\n\t\t\t\t'count',\n\t\t\t\t{ path: 'lifetime', kind: 'number', min: 0, hint: 'Seconds they stay: for good when left out' },\n\t\t\t\t{ path: 'spread', kind: 'number', min: 0, hint: 'How many cells around where it landed they appear' },\n\t\t\t\t{ path: 'follow', kind: 'boolean', hint: 'Walk with the caster when there is nothing to attack: yes when left out' },\n\t\t\t\t{ path: 'aggro', options: ['nearest', 'mastersAttacker', 'none'], hint: 'Whom they go for: whoever hits the caster first when left out' },\n\t\t\t\t{ path: 'diesWithMaster', kind: 'boolean', hint: 'Die when the caster does: yes when left out' }\n\t\t\t] }),\n\t/**\n\t * Corpses near where it landed rise as `unit`s of the caster's, or as what they were (`as: 'themselves'`: Animate\n\t * Dead), for `duration` seconds: `count` of them at most (2 when left out), within `radius` (6)\n\t */\n\tdefineEffect({ type: 'raiseDead', run: (context, effect) => {\n\t\t\tconst { world, caster, point, level } = context\n\t\t\tconst themselves = effect.as === 'themselves'\n\t\t\tif (!effect.unit && !themselves) return\n\t\t\tconst lifetime = effect.duration === undefined ? undefined : valueOf(context, effect.duration)\n\t\t\tconst which = themselves ? (corpse: Corpse) => world.registry.units.has(corpse.type) : undefined\n\t\t\tfor (const corpse of takeCorpses(world, point, valueOf(context, effect.radius, undefined, 6), Math.round(at(effect.count, level, 2)), which)) {\n\t\t\t\tconst risen = world.spawn(themselves ? corpse.type : effect.unit!, caster.owner, corpse, { facing: caster.facing, lifetime })\n\t\t\t\trisen.set(summoned, { by: caster.id })\n\t\t\t}\n\t\t}, fields: ['unit', 'as', 'duration', 'count'] }),\n\n\t/**\n\t * The corpses of the caster's side near where it landed (within `radius`, 6) come back as what they were, their own\n\t * owners' again, whole: `count` of them at most, all when left out (Resurrection). Not summoned: they stay\n\t *\n\t * @beta\n\t */\n\tdefineEffect({ type: 'revive', run: (context, effect) => {\n\t\t\tconst { world, caster, point, level } = context\n\t\t\tconst most = effect.count === undefined ? Infinity : Math.round(at(effect.count, level))\n\t\t\tconst which = (corpse: Corpse) => world.registry.units.has(corpse.type) && world.areAllies(caster.owner, corpse.owner) && world.players.has(corpse.owner)\n\t\t\tfor (const corpse of takeCorpses(world, point, valueOf(context, effect.radius, undefined, 6), most, which))\n\t\t\t\tworld.spawn(corpse.type, corpse.owner, corpse, { facing: caster.facing })\n\t\t}, fields: ['count'] }),\n\n\t/**\n\t * Copies of the unit it was cast on (the caster, when none) appear around it, `count` of them (1), for `duration`\n\t * seconds (30): they deal `dealt` of its damage (a third) and take `taken` times as much (twice). A hero's\n\t * copies are of its level, with its health and mana as they are\n\t */\n\tdefineEffect({ type: 'illusion', run: (context, effect) => {\n\t\t\tconst { world, caster, level } = context\n\t\t\tconst original = context.target ?? caster\n\t\t\t// the game's say, as for any effect that reaches a unit (`beforeEffect`)\n\t\t\tif (original !== caster && !mayReach(context, effect, original)) return\n\t\t\tconst count = Math.round(at(effect.count, level, 1))\n\t\t\tconst lifetime = valueOf(context, effect.duration, original, 30)\n\t\t\tfor (let i = 0; i < count; i++) {\n\t\t\t\tconst angle = (i / count) * Math.PI * 2 + world.rng.next()\n\t\t\t\tconst at2 = { x: original.pos.x + sin(angle) * 1.5, z: original.pos.z + cos(angle) * 1.5 }\n\t\t\t\tconst copy = world.spawn(original.def.id, caster.owner, at2, { facing: original.facing, lifetime })\n\t\t\t\tcopy.set(illusion, { of: original.id, dealt: effect.dealt ?? 1 / 3, taken: effect.taken ?? 2 })\n\t\t\t\tconst was = heroOf(original)\n\t\t\t\tconst hero = heroOf(copy)\n\t\t\t\tif (was && hero) {\n\t\t\t\t\thero.level = was.level\n\t\t\t\t\thero.xp = was.xp\n\t\t\t\t\trefreshVitals(world, copy)\n\t\t\t\t}\n\t\t\t\tcopy.health = copy.maxHealth * (original.health / original.maxHealth)\n\t\t\t\tcopy.mana = Math.min(original.mana, copy.maxMana)\n\t\t\t}\n\t\t}, fields: [\n\t\t\t\t'count',\n\t\t\t\t'duration',\n\t\t\t\t{ path: 'dealt', kind: 'number', min: 0, hint: 'What of its damage the copies deal: a third when left out' },\n\t\t\t\t{ path: 'taken', kind: 'number', min: 0, hint: 'Times what they are dealt the copies take: twice when left out' }\n\t\t\t] })\n]\n\n/** The corpses where the player sees (`Snapshot.corpses`): none to a computer, and left out where there are none */\nexport const corpsesPart = snapshotField('corpses', (view) => {\n\tif (view.forComputer) return undefined\n\tconst seen = view.world\n\t\t.state(corpses)\n\t\t.filter((corpse) => view.sees(corpse.x, corpse.z))\n\t\t.map(({ id, type, x, z }) => ({ id, type, x, z }))\n\treturn seen.length ? seen : undefined\n})\n"],"mappings":"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"}

package/dist/systems/abilities.js

@@ -0,0 +1,224 @@
+import { at, declaredAt, lowerChain, passiveEffects } from "../defs.js";
+import { carriedPassives, inventorySlots, slotsOf } from "../inventory.js";
+import { refreshVitals, statsOf } from "../stats.js";
+import { buffRemoved } from "../engineEvents.js";
+import { constructionSite } from "./construction.js";
+import { edgeDistance, fighting, moving } from "../entity.js";
+import { refillUses } from "../abilities/charges.js";
+import { heroState } from "../hero.js";
+import { hasTag } from "../abilities/chance.js";
+import { buffEffects, buffEnded } from "../abilities/land.js";
+import { AURA_LINGER, applyBuff, fullShield, hasBuff, isControlled, isRooted, isStunned } from "../abilities/buffs.js";
+import { canSee } from "./combat.js";
+import { valueOf } from "../abilities/amounts.js";
+import { updateDashes, updateLingering, updateMissiles } from "../abilities/effects.js";
+import { expirePurchases, refillItems, shopStock } from "../items.js";
+import { createOrder, giveOrder } from "../orders/queue.js";
+import { tickRecast } from "../abilities/recast.js";
+import { castRange, notReady, validTarget } from "../orders/cast.js";
+//#region src/systems/abilities.ts
+/** Ticks between two rounds of upkeep: auras and autocast do not need to run every tick */
+var UPKEEP_INTERVAL = 6;
+/** How far beyond the reach of an ability a unit looks for something to autocast on */
+var AUTOCAST_SEARCH = 3;
+var found = [];
+/** Marks the buff a unit's ability keeps up on another (or itself) as kept, not timed: what a plate shows of it */
+function keptUp(target, buff, source) {
+	for (const instance of target.buffs) if (instance.id === buff && instance.source === source.id && !instance.kept) instance.kept = true;
+}
+/** What one ability does all the time, for one round */
+function upkeep(world, entity, ability, level, lasting) {
+	for (const effect of lowerChain(passiveEffects(ability))) {
+		if (effect.type === "buff") {
+			if (effect.buff) {
+				applyBuff(world, entity, effect.buff, lasting ? Infinity : AURA_LINGER, entity, level);
+				if (!lasting) keptUp(entity, effect.buff, entity);
+			}
+			continue;
+		}
+		if (effect.type !== "aura") {
+			const point = {
+				x: entity.pos.x,
+				z: entity.pos.z
+			};
+			world.registry.effect(effect.type)({
+				world,
+				caster: entity,
+				ability,
+				level,
+				point,
+				interval: UPKEEP_INTERVAL * world.dt
+			}, effect);
+			continue;
+		}
+		const radius = typeof effect.radius === "function" ? valueOf({
+			world,
+			caster: entity,
+			ability,
+			level,
+			point: entity.pos
+		}, effect.radius) : at(effect.radius, level);
+		if (!effect.buff || !radius) continue;
+		const affects = effect.affects ?? (world.registry.buff(effect.buff).harmful ? "enemies" : "allies");
+		for (const other of world.spatial.query(entity.pos.x, entity.pos.z, radius, found)) {
+			if (!other.alive || other.hidden || !other.isUnit) continue;
+			if (other !== entity && edgeDistance(entity, other) > radius) continue;
+			if (affects === "enemies" && !world.areEnemies(entity.owner, other.owner)) continue;
+			if (affects === "allies" && !world.areAllies(entity.owner, other.owner)) continue;
+			if (effect.only === "heroes" && !other.has(heroState)) continue;
+			if (effect.kinds && !effect.kinds.includes(other.def.kind) || effect.tags && !hasTag(other, effect.tags)) continue;
+			applyBuff(world, other, effect.buff, AURA_LINGER, entity, level);
+			keptUp(other, effect.buff, entity);
+		}
+	}
+}
+function upkeepPassives(world, entity) {
+	for (const state of entity.abilities) if (state.level > 0) upkeep(world, entity, world.registry.ability(state.id), state.level, true);
+	for (const passive of carriedPassives(world, entity)) upkeep(world, entity, world.registry.ability(passive), 1, false);
+}
+/** Whether casting the ability on the target would do it any good */
+function useful(ability, level, target) {
+	for (const effect of lowerChain(ability.effects)) {
+		if (effect.type === "heal" && target.health <= target.maxHealth - Math.min(declaredAt(effect.amount, level), target.maxHealth * .1)) return true;
+		if (effect.type === "buff" && effect.buff && !hasBuff(target, effect.buff)) return true;
+		if (effect.type === "damage") return true;
+	}
+	return false;
+}
+function autocast(world, entity) {
+	if (entity.orders.length > 0 || entity.hidden || entity.get(fighting)?.passive) return;
+	for (const state of entity.abilities) {
+		if (!state.autocast || state.cooldown > 0 || state.charges === 0 || state.level < 1) continue;
+		const ability = world.registry.ability(state.id);
+		if (ability.autoAim) {
+			if (notReady(world, entity, ability)) continue;
+			const aim = ability.autoAim(world, entity, state);
+			if (!aim) continue;
+			giveOrder(world, entity, createOrder(world, {
+				type: "cast",
+				ability: ability.id,
+				target: aim.target,
+				point: aim.point
+			}));
+			return;
+		}
+		if (ability.target !== "unit" || !world.cheats.noManaCosts && at(ability.manaCost, state.level) > entity.mana) continue;
+		const reach = castRange(world, entity, ability, state.level) + AUTOCAST_SEARCH;
+		let best;
+		let bestScore = Infinity;
+		for (const other of world.spatial.query(entity.pos.x, entity.pos.z, reach, found)) {
+			if (!validTarget(world, entity, ability, other) || !useful(ability, state.level, other)) continue;
+			if (other !== entity && (edgeDistance(entity, other) > reach || !canSee(world, entity, other))) continue;
+			const score = other.health / other.maxHealth + edgeDistance(entity, other) * .01;
+			if (score < bestScore) {
+				bestScore = score;
+				best = other;
+			}
+		}
+		if (best) {
+			giveOrder(world, entity, createOrder(world, {
+				type: "cast",
+				ability: ability.id,
+				target: best.id
+			}));
+			return;
+		}
+	}
+}
+/** Everything about abilities that happens on its own: regeneration, cooldowns, buffs running out, auras, autocast */
+var abilitySystem = {
+	name: "abilities",
+	phase: "decide",
+	update(world, dt) {
+		updateMissiles(world, dt);
+		updateLingering(world, dt);
+		updateDashes(world, dt);
+		for (const entity of world.units.values()) {
+			if (!entity.alive) continue;
+			const pass = world.cheats.noCooldowns ? Infinity : dt;
+			for (const state of entity.abilities) {
+				if (state.cooldown > 0) state.cooldown = Math.max(state.cooldown - pass, 0);
+				if (state.charges !== void 0) refillUses(world, entity, state, pass);
+				if (state.recast) tickRecast(state, dt);
+			}
+			for (let i = entity.buffs.length - 1; i >= 0; i--) {
+				const buff = entity.buffs[i];
+				const before = buff.elapsed;
+				buff.remaining -= dt;
+				buff.elapsed += dt;
+				const def = world.registry.buff(buff.id);
+				const tick = def.onTick;
+				if (tick && tick.every > 0) {
+					const times = Math.floor(buff.elapsed / tick.every) - Math.floor(before / tick.every);
+					for (let n = 0; n < times && entity.alive; n++) {
+						tick.run?.(world, entity, buff);
+						if (tick.effects) buffEffects(world, entity, buff, tick.effects);
+					}
+					if (!entity.alive) break;
+				}
+				if (buff.remaining <= 0) {
+					entity.dropBuff(i);
+					buffEnded(world, entity, buff);
+					def.onRemove?.(world, entity, buff, true);
+					world.hooks.run("buffEnd", {
+						entity,
+						buff,
+						expired: true
+					});
+					world.events.emit(buffRemoved, {
+						entity,
+						buff: buff.id,
+						expired: true
+					});
+					continue;
+				}
+				if (def.recharge !== void 0 && world.time - entity.hurtAt >= def.recharge) buff.shield = fullShield(world, def, world.get(buff.source) ?? entity, buff.level);
+			}
+			const slots = slotsOf(entity);
+			if (slots) {
+				refillItems(world, entity, dt);
+				expirePurchases(world, entity);
+				for (const instance of slots) {
+					if (instance?.state && instance.state.cooldown > 0) instance.state.cooldown = Math.max(instance.state.cooldown - pass, 0);
+					if (instance?.state?.charges !== void 0) refillUses(world, entity, instance.state, pass, true);
+					if (instance?.state?.recast) tickRecast(instance.state, dt);
+				}
+			}
+			const stocks = entity.get(shopStock);
+			if (stocks) for (const stock of stocks) {
+				const max = world.registry.item(stock.item).stock?.max ?? 0;
+				if (stock.count >= max || !entity.operational) continue;
+				stock.restock -= dt;
+				if (stock.restock <= 0) {
+					stock.count++;
+					stock.restock = world.registry.item(stock.item).stock?.restock ?? 60;
+				}
+			}
+			const stats = statsOf(world, entity);
+			if (stats.health !== entity.maxHealth || stats.mana !== entity.maxMana) refreshVitals(world, entity);
+			if (entity.maxMana > 0 && stats.manaRegen !== 0) entity.mana = Math.min(entity.mana + stats.manaRegen * dt, entity.maxMana);
+			if (stats.healthRegen !== 0 && !(entity.isStructure && entity.has(constructionSite))) entity.health = Math.min(entity.health + stats.healthRegen * dt, entity.maxHealth);
+			const { recovers } = entity.def;
+			if (recovers !== void 0 && entity.health < entity.maxHealth && world.time - entity.hurtAt >= recovers) entity.health = entity.maxHealth;
+			if (entity.health <= 0) {
+				world.kill(entity);
+				continue;
+			}
+			const m = entity.get(moving);
+			if (m && !entity.hidden) {
+				const speed = entity.buffs.length && (isStunned(world, entity) || isRooted(world, entity)) ? 0 : Math.min(world.settings.movement.moveSpeed(world, entity, stats.moveSpeed), m.cap ?? Infinity);
+				if (Math.abs(speed - m.speed) > 1e-6) {
+					m.speed = speed;
+					world.nav.setSpeed(entity.id, speed);
+				}
+			}
+			if (entity.abilities.length === 0 && !entity.has(inventorySlots) || (world.tick + entity.id) % UPKEEP_INTERVAL !== 0) continue;
+			upkeepPassives(world, entity);
+			if (!isStunned(world, entity) && !entity.asleep && !isControlled(world, entity)) autocast(world, entity);
+		}
+	}
+};
+//#endregion
+export { abilitySystem };
+
+//# sourceMappingURL=abilities.js.map

package/dist/systems/abilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abilities.js","names":[],"sources":["../../src/systems/abilities.ts"],"sourcesContent":["import { buffRemoved } from '#engine/engineEvents'\nimport { carriedPassives, inventorySlots, slotsOf } from '#engine/inventory'\nimport { constructionSite } from './construction'\nimport { AURA_LINGER, applyBuff, fullShield, hasBuff, isControlled, isRooted, isStunned } from '#engine/abilities/buffs'\nimport { expirePurchases, refillItems, shopStock } from '#engine/items'\nimport { updateDashes, updateLingering, updateMissiles } from '#engine/abilities/effects'\nimport { buffEffects, buffEnded } from '#engine/abilities/land'\nimport { refillUses } from '#engine/abilities/charges'\nimport { tickRecast } from '#engine/abilities/recast'\nimport { type AbilityDef, at, declaredAt, lowerChain, passiveEffects } from '#engine/defs'\nimport { valueOf } from '#engine/abilities/amounts'\nimport { edgeDistance, type Entity } from '#engine/entity'\nimport { castRange, notReady, validTarget } from '#engine/orders/cast'\nimport { createOrder, giveOrder } from '#engine/orders/queue'\nimport type { System } from '#engine/registry'\nimport { refreshVitals, statsOf } from '#engine/stats'\nimport type { World } from '#engine/world'\nimport { canSee } from './combat'\nimport { hasTag } from '#engine/abilities/chance'\nimport { heroState } from '#engine/hero'\nimport { moving, fighting } from '../entity'\n\n/** Ticks between two rounds of upkeep: auras and autocast do not need to run every tick */\nconst UPKEEP_INTERVAL = 6\n/** How far beyond the reach of an ability a unit looks for something to autocast on */\nconst AUTOCAST_SEARCH = 3\n\nconst found: Entity[] = []\n\n/** Marks the buff a unit's ability keeps up on another (or itself) as kept, not timed: what a plate shows of it */\nfunction keptUp(target: Entity, buff: string, source: Entity): void {\n\tfor (const instance of target.buffs) if (instance.id === buff && instance.source === source.id && !instance.kept) instance.kept = true\n}\n\n/** What one ability does all the time, for one round */\nfunction upkeep(world: World, entity: Entity, ability: AbilityDef, level: number, lasting: boolean): void {\n\tfor (const effect of lowerChain(passiveEffects(ability))) {\n\t\tif (effect.type === 'buff') {\n\t\t\t// renewed rather than left alone, so that it follows the level of the ability. What an item gives goes with the item\n\t\t\tif (effect.buff) {\n\t\t\t\tapplyBuff(world, entity, effect.buff, lasting ? Infinity : AURA_LINGER, entity, level)\n\t\t\t\tif (!lasting) keptUp(entity, effect.buff, entity)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tif (effect.type !== 'aura') {\n\t\t\t// whatever else a game came up with: it is asked every round. `onHit` has nothing to do here\n\t\t\tconst point = { x: entity.pos.x, z: entity.pos.z }\n\t\t\tworld.registry.effect(effect.type)({ world, caster: entity, ability, level, point, interval: UPKEEP_INTERVAL * world.dt }, effect)\n\t\t\tcontinue\n\t\t}\n\t\tconst radius = typeof effect.radius === 'function' ? valueOf({ world, caster: entity, ability, level, point: entity.pos }, effect.radius) : at(effect.radius, level)\n\t\tif (!effect.buff || !radius) continue\n\t\tconst affects = effect.affects ?? (world.registry.buff(effect.buff).harmful ? 'enemies' : 'allies')\n\t\tfor (const other of world.spatial.query(entity.pos.x, entity.pos.z, radius, found)) {\n\t\t\tif (!other.alive || other.hidden || !other.isUnit) continue\n\t\t\tif (other !== entity && edgeDistance(entity, other) > radius) continue\n\t\t\tif (affects === 'enemies' && !world.areEnemies(entity.owner, other.owner)) continue\n\t\t\tif (affects === 'allies' && !world.areAllies(entity.owner, other.owner)) continue\n\t\t\t// who it is for, as any effect says it (`only`, `kinds`, `tags`): an aura for heroes alone keeps off the rest\n\t\t\tif (effect.only === 'heroes' && !other.has(heroState)) continue\n\t\t\tif ((effect.kinds && !effect.kinds.includes(other.def.kind)) || (effect.tags && !hasTag(other, effect.tags))) continue\n\t\t\tapplyBuff(world, other, effect.buff, AURA_LINGER, entity, level)\n\t\t\tkeptUp(other, effect.buff, entity)\n\t\t}\n\t}\n}\n\nfunction upkeepPassives(world: World, entity: Entity): void {\n\tfor (const state of entity.abilities) {\n\t\tif (state.level > 0) upkeep(world, entity, world.registry.ability(state.id), state.level, true)\n\t}\n\tfor (const passive of carriedPassives(world, entity)) upkeep(world, entity, world.registry.ability(passive), 1, false)\n}\n\n/** Whether casting the ability on the target would do it any good */\nfunction useful(ability: AbilityDef, level: number, target: Entity): boolean {\n\tfor (const effect of lowerChain(ability.effects)) {\n\t\tif (effect.type === 'heal' && target.health <= target.maxHealth - Math.min(declaredAt(effect.amount, level), target.maxHealth * 0.1)) return true\n\t\tif (effect.type === 'buff' && effect.buff && !hasBuff(target, effect.buff)) return true\n\t\tif (effect.type === 'damage') return true\n\t}\n\treturn false\n}\n\nfunction autocast(world: World, entity: Entity): void {\n\tif (entity.orders.length > 0 || entity.hidden || entity.get(fighting)?.passive) return\n\tfor (const state of entity.abilities) {\n\t\tif (!state.autocast || state.cooldown > 0 || state.charges === 0 || state.level < 1) continue\n\t\tconst ability = world.registry.ability(state.id)\n\t\t// the game's own way: where to use it now, for any kind of ability\n\t\tif (ability.autoAim) {\n\t\t\tif (notReady(world, entity, ability)) continue\n\t\t\tconst aim = ability.autoAim(world, entity, state)\n\t\t\tif (!aim) continue\n\t\t\tgiveOrder(world, entity, createOrder(world, { type: 'cast', ability: ability.id, target: aim.target, point: aim.point }))\n\t\t\treturn\n\t\t}\n\t\tif (ability.target !== 'unit' || (!world.cheats.noManaCosts && at(ability.manaCost, state.level) > entity.mana)) continue\n\n\t\tconst reach = castRange(world, entity, ability, state.level) + AUTOCAST_SEARCH\n\t\tlet best: Entity | undefined\n\t\tlet bestScore = Infinity\n\t\tfor (const other of world.spatial.query(entity.pos.x, entity.pos.z, reach, found)) {\n\t\t\tif (!validTarget(world, entity, ability, other) || !useful(ability, state.level, other)) continue\n\t\t\tif (other !== entity && (edgeDistance(entity, other) > reach || !canSee(world, entity, other))) continue\n\t\t\t// whoever is worst off first, the closest one among equals\n\t\t\tconst score = other.health / other.maxHealth + edgeDistance(entity, other) * 0.01\n\t\t\tif (score < bestScore) {\n\t\t\t\tbestScore = score\n\t\t\t\tbest = other\n\t\t\t}\n\t\t}\n\t\tif (best) {\n\t\t\tgiveOrder(world, entity, createOrder(world, { type: 'cast', ability: ability.id, target: best.id }))\n\t\t\treturn\n\t\t}\n\t}\n}\n\n/** Everything about abilities that happens on its own: regeneration, cooldowns, buffs running out, auras, autocast */\nexport const abilitySystem: System = {\n\tname: 'abilities',\n\tphase: 'decide',\n\tupdate(world, dt) {\n\t\tupdateMissiles(world, dt)\n\t\tupdateLingering(world, dt)\n\t\tupdateDashes(world, dt)\n\t\tfor (const entity of world.units.values()) {\n\t\t\tif (!entity.alive) continue\n\n\t\t\t// with no cooldowns, the ones that were running when that was switched on are over too\n\t\t\tconst pass = world.cheats.noCooldowns ? Infinity : dt\n\t\t\tfor (const state of entity.abilities) {\n\t\t\t\tif (state.cooldown > 0) state.cooldown = Math.max(state.cooldown - pass, 0)\n\t\t\t\tif (state.charges !== undefined) refillUses(world, entity, state, pass)\n\t\t\t\tif (state.recast) tickRecast(state, dt)\n\t\t\t}\n\n\t\t\tfor (let i = entity.buffs.length - 1; i >= 0; i--) {\n\t\t\t\tconst buff = entity.buffs[i]\n\t\t\t\tconst before = buff.elapsed\n\t\t\t\tbuff.remaining -= dt\n\t\t\t\tbuff.elapsed += dt\n\t\t\t\tconst def = world.registry.buff(buff.id)\n\t\t\t\t// every so often while it lasts: as many times as `every` went by in this tick\n\t\t\t\tconst tick = def.onTick\n\t\t\t\tif (tick && tick.every > 0) {\n\t\t\t\t\t// from the time before this tick: worked out back from after it, rounding could lose one\n\t\t\t\t\tconst times = Math.floor(buff.elapsed / tick.every) - Math.floor(before / tick.every)\n\t\t\t\t\tfor (let n = 0; n < times && entity.alive; n++) {\n\t\t\t\t\t\ttick.run?.(world, entity, buff)\n\t\t\t\t\t\tif (tick.effects) buffEffects(world, entity, buff, tick.effects)\n\t\t\t\t\t}\n\t\t\t\t\tif (!entity.alive) break\n\t\t\t\t}\n\t\t\t\tif (buff.remaining <= 0) {\n\t\t\t\t\tentity.dropBuff(i)\n\t\t\t\t\tbuffEnded(world, entity, buff)\n\t\t\t\t\tdef.onRemove?.(world, entity, buff, true)\n\t\t\t\t\tworld.hooks.run('buffEnd', { entity, buff, expired: true })\n\t\t\t\t\tworld.events.emit(buffRemoved, { entity, buff: buff.id, expired: true })\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\t// a shield that grows back, once its owner has been left alone for long enough\n\t\t\t\tif (def.recharge !== undefined && world.time - entity.hurtAt >= def.recharge) {\n\t\t\t\t\tbuff.shield = fullShield(world, def, world.get(buff.source) ?? entity, buff.level)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// (no empty lists made for what carries nothing and sells nothing: most units, every tick)\n\t\t\tconst slots = slotsOf(entity)\n\t\t\tif (slots) {\n\t\t\t\trefillItems(world, entity, dt)\n\t\t\t\texpirePurchases(world, entity)\n\t\t\t\tfor (const instance of slots) {\n\t\t\t\t\tif (instance?.state && instance.state.cooldown > 0) instance.state.cooldown = Math.max(instance.state.cooldown - pass, 0)\n\t\t\t\t\tif (instance?.state?.charges !== undefined) refillUses(world, entity, instance.state, pass, true)\n\t\t\t\t\tif (instance?.state?.recast) tickRecast(instance.state, dt)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst stocks = entity.get(shopStock)\n\t\t\tif (stocks) {\n\t\t\t\tfor (const stock of stocks) {\n\t\t\t\t\tconst max = world.registry.item(stock.item).stock?.max ?? 0\n\t\t\t\t\tif (stock.count >= max || !entity.operational) continue\n\t\t\t\t\tstock.restock -= dt\n\t\t\t\t\tif (stock.restock <= 0) {\n\t\t\t\t\t\tstock.count++\n\t\t\t\t\t\tstock.restock = world.registry.item(stock.item).stock?.restock ?? 60\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst stats = statsOf(world, entity)\n\t\t\t// what changed the stats may have changed how much health and mana there is room for\n\t\t\tif (stats.health !== entity.maxHealth || stats.mana !== entity.maxMana) refreshVitals(world, entity)\n\t\t\tif (entity.maxMana > 0 && stats.manaRegen !== 0) entity.mana = Math.min(entity.mana + stats.manaRegen * dt, entity.maxMana)\n\t\t\tif (stats.healthRegen !== 0 && !(entity.isStructure && entity.has(constructionSite)))\n\t\t\t\tentity.health = Math.min(entity.health + stats.healthRegen * dt, entity.maxHealth)\n\t\t\t// left alone for long enough, it is whole again\n\t\t\tconst { recovers } = entity.def\n\t\t\tif (recovers !== undefined && entity.health < entity.maxHealth && world.time - entity.hurtAt >= recovers) entity.health = entity.maxHealth\n\t\t\tif (entity.health <= 0) {\n\t\t\t\tworld.kill(entity)\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\t// slowed or hasted units have to be told to the navigation\n\t\t\tconst m = entity.get(moving)\n\t\t\tif (m && !entity.hidden) {\n\t\t\t\tconst speed =\n\t\t\t\t\tentity.buffs.length && (isStunned(world, entity) || isRooted(world, entity))\n\t\t\t\t\t\t? 0\n\t\t\t\t\t\t: Math.min(world.settings.movement.moveSpeed(world, entity, stats.moveSpeed), m.cap ?? Infinity)\n\t\t\t\tif (Math.abs(speed - m.speed) > 1e-6) {\n\t\t\t\t\tm.speed = speed\n\t\t\t\t\tworld.nav.setSpeed(entity.id, speed)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif ((entity.abilities.length === 0 && !entity.has(inventorySlots)) || (world.tick + entity.id) % UPKEEP_INTERVAL !== 0) continue\n\t\t\tupkeepPassives(world, entity)\n\t\t\tif (!isStunned(world, entity) && !entity.asleep && !isControlled(world, entity)) autocast(world, entity)\n\t\t}\n\t}\n}\n"],"mappings":"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"}

package/dist/systems/combat.d.ts

@@ -2,6 +2,8 @@ import { type Entity } from '#engine/entity';
 import { type Vec2 } from '#engine/math';
 import type { System } from '#engine/registry';
 import type { World } from '#engine/world';
+import { STRUCTURE_REACH } from '#engine/engagement';
+export { STRUCTURE_REACH };
 export type EngageResult = 'invalid' | 'attacking' | 'chasing' | 'outOfRange';
 /**
  * Whether an attacker may attack a target: its attack reaches it, it is an enemy, and the `canAttack` hook agrees.
@@ -44,12 +46,44 @@ export declare const acquireTarget: (world: World, entity: Entity, range?: numbe
  * @beta
  */
 export declare function acquireInRange(world: World, entity: Entity, slack?: number): Entity | undefined;
+/**
+ * What the `targetScore` hook makes of a target for an attacker, the engine's own score under it: what a search would
+ * weigh it at, or -Infinity for one a game's hook leaves out. For a rule that hands an attacker a target without
+ * searching (an ally's help), so that the game weighs it as it weighs any
+ */
+export declare function scoreTarget(world: World, entity: Entity, other: Entity): number;
 /**
  * `acquireTarget`, and whether it passed over a target it leaves alone for now (`TargetFound`). What it gives back is
  * the search's own, used again by the next search: read it at once
  */
 export declare function searchTarget(world: World, entity: Entity, range?: number, shunned?: boolean, inRange?: number): Readonly<TargetFound>;
-export declare function cancelSwing(entity: Entity): void;
+/**
+ * Calls off the swing under way, before its blow: said (`swingCancelled`) when there was one, for the screen to cut
+ * the attack to the walk. What has been swung already is not given back: the cooldown runs as it did
+ */
+export declare function cancelSwing(world: World, entity: Entity): void;
+/**
+ * A cleave as it is for one blow: a part of its damage, how far round the target, how wide a cone from the attacker
+ * through it (all round when none)
+ *
+ * @beta
+ */
+export interface CleaveNow {
+    /** The part of the blow's damage each other enemy takes */
+    part: number;
+    /** How far from the target's edge they stand */
+    radius: number;
+    /** How wide the cone from the attacker through the target is, in radians: all round when left out */
+    angle?: number;
+}
+/**
+ * What a blow from up close of the attacker's weapon at that place cleaves (`AttackDef.cleave`, `BuffDef.cleave`): the
+ * attack's own, or a buff's at its level, whichever has the larger part. Nothing for none. The engine's
+ * `RuleSettings.combat.cleave`
+ *
+ * @beta
+ */
+export declare function cleaveOf(world: World, attacker: Entity, _target: Entity, weapon: number): CleaveNow | undefined;
 export type BombardResult = 'attacking' | 'outOfRange';
 /** One tick of attacking a spot on the ground, for attacks that can. Getting into range is up to the caller */
 export declare function bombard(world: World, entity: Entity, point: Vec2, dt: number): BombardResult;