@v12-engine/engine 0.1.1 → 0.4.0

package/dist/ai/mission.js

@@ -0,0 +1,538 @@
+import { distSq } from "../math.js";
+import { shapeBounds } from "../areas.js";
+import { defineModule } from "./module.js";
+import { consider, curve, defineGoal, goals } from "./goals.js";
+import { evaluate, rules, words } from "./rules.js";
+import { point, where } from "./geometry.js";
+import { squads } from "./squads.js";
+import { defineBrain } from "./define.js";
+import { micro } from "./micro.js";
+//#region src/ai/mission.ts
+/** How far a part reaches round its place, where neither it nor a region says: what holds a camp holds this much round it */
+var REACH = 10;
+/** How much past its reach a part's units are looked for as it first takes them */
+var TAKE_PAST = 8;
+/** How near a spawner a unit has come out of it */
+var SPAWN_REACH = 10;
+/** How far a unit with nowhere to run to runs from the nearest rival */
+var FLEE_AWAY = 20;
+/** A place as an id writes it */
+var nameOf = (place) => typeof place === "string" ? place : `${Math.round(place.x)},${Math.round(place.z)}`;
+/**
+* Where a place is for the player: a point as it is; a name, the entity it names where the player knows of it, else the
+* middle of the region of that name. Nothing for a name it does not know
+*/
+function placeOf(ai, place) {
+	if (typeof place !== "string") return point(place);
+	const named = ai.view.named(place);
+	if (named) return point(named);
+	const region = ai.view.region(place);
+	return region && {
+		x: region.shape.x,
+		z: region.shape.z
+	};
+}
+/** How far a part reaches round its place: what it was given, else a region's size, else `REACH` */
+function reachOf(ai, place, given) {
+	if (given !== void 0) return given;
+	if (typeof place === "string" && !ai.view.named(place)) {
+		const shape = ai.view.region(place)?.shape;
+		if (shape) {
+			const { x0, z0, x1, z1 } = shapeBounds(shape);
+			return Math.max(x1 - x0, z1 - z0) / 2;
+		}
+	}
+	return REACH;
+}
+/** The part's `when`, as a consideration that vetoes it while the condition does not hold */
+var whenOf = (condition) => condition === void 0 ? [] : [consider("its condition holds", (ai) => evaluate(condition, ai) ? 1 : 0, curve.step(1))];
+/** Does an action: a function of the brain, or a word it tells itself (`{ say, data }`) */
+function act(ai, action) {
+	if (typeof action === "function") action(ai);
+	else ai.tell(action.say, action.data, ai.tick);
+}
+/**
+* The units a part's `units` choose of those it may have: the data form read (named, type, role, tag, near, count), or
+* the function asked; its fighters at its place where `fallback` says so
+*/
+function choose(ai, units, available, around, reach) {
+	if (typeof units === "function") return [...units(ai, available)];
+	let set = available.units().alive();
+	if (units.named) {
+		const names = units.named;
+		set = set.where((entity) => entity.name !== void 0 && names.includes(entity.name));
+	} else if (units.type === void 0 && units.role === void 0 && units.tag === void 0) set = set.fighters();
+	if (units.type !== void 0) {
+		const types = Array.isArray(units.type) ? units.type : [units.type];
+		set = set.where((entity) => types.includes(entity.type));
+	}
+	if (units.role !== void 0) set = set.withRole(units.role);
+	if (units.tag !== void 0) set = set.withTag(units.tag);
+	if (units.near !== void 0) {
+		const near = placeOf(ai, units.near);
+		if (!near) return [];
+		set = set.near(near, units.within ?? reach);
+	}
+	const chosen = [...set];
+	if (units.count !== void 0 && around) {
+		chosen.sort((a, b) => distSq(a, around) - distSq(b, around) || a.id - b.id);
+		return chosen.slice(0, Math.max(0, units.count));
+	}
+	return units.count !== void 0 ? chosen.slice(0, Math.max(0, units.count)) : chosen;
+}
+/**
+* A part of a mission: a module (its id the part's) that puts its goal on the brain's picker and keeps its memory. A
+* brain without a `goals()` module (or the melee brain's) never runs the goal: the log says so once
+*/
+function part(id, kind, make) {
+	return defineModule({
+		id,
+		make: (ai) => {
+			const memory = {
+				v: 1,
+				took: false,
+				units: []
+			};
+			const made = make(ai, memory);
+			if (made.goal) ai.goals.add(made.goal);
+			let warned = false;
+			return {
+				id,
+				version: 1,
+				phase: "decide",
+				think: () => {
+					if (made.goal && !warned && !ai.module("goals")) {
+						warned = true;
+						ai.log.warn("ai", `the mission's part "${id}" is a goal, and the brain "${ai.def.id}" has no goals() module to pick it`);
+					}
+					made.think?.();
+				},
+				save: () => structuredClone(memory),
+				restore: (data) => {
+					const kept = data && typeof data === "object" ? data : void 0;
+					for (const key of Object.keys(memory)) delete memory[key];
+					Object.assign(memory, {
+						v: 1,
+						took: false,
+						units: []
+					}, structuredClone(kept ?? {}));
+				},
+				inspect: () => ({
+					part: kind,
+					units: [...memory.units],
+					...made.inspect?.()
+				})
+			};
+		}
+	});
+}
+/**
+* The claim of a part that keeps its own units (`MissionPartMemory.units`): those it took, wherever they are, as it is
+* picked again; the first time (and with `refill`, each time) what its `units` choose
+*/
+function ownUnits(memory, options, fallback, around, reach) {
+	return (ai, available) => {
+		const kept = available.where((entity) => memory.units.includes(entity.id)).items;
+		if (memory.took && !options.refill) return kept;
+		const more = choose(ai, options.units ?? fallback(ai), available, around(ai), reach(ai));
+		return [...kept, ...more.filter((entity) => !memory.units.includes(entity.id))];
+	};
+}
+/**
+* A part's run, as each think begins: what it holds is its own from now on (`memory.units`, the dead let go of), and its
+* own units back in the pool (a word that had them is over) are taken back into its squad. The squad: made where there is
+* none. Those that came into it this think, by id
+*/
+function muster(ai, id, memory, held, options, choosing) {
+	const { mine } = ai.view;
+	memory.took = true;
+	const own = new Set(memory.units.filter((unit) => mine.has(unit)));
+	for (const unit of held) own.add(unit.id);
+	const pool = ai.goals.pool();
+	const back = [...own].filter((unit) => pool.has(unit));
+	if (options.refill && choosing) {
+		for (const entity of choosing()) if (pool.has(entity.id)) back.push(entity.id);
+	}
+	let squad = ai.squads.named(id);
+	const before = new Set(squad?.data.units ?? []);
+	if (!squad || squad.owner !== id) squad = ai.squads.make(id, [...held.ids(), ...back], { owner: id });
+	else squad.add([...[...held.ids()].filter((unit) => !before.has(unit)), ...back], "back at its post");
+	for (const unit of squad.data.units) own.add(unit);
+	memory.units = [...own].filter((unit) => mine.has(unit)).sort((a, b) => a - b);
+	return {
+		squad,
+		came: squad.data.units.filter((unit) => !before.has(unit))
+	};
+}
+/**
+* Its units hold a place: they go there, fight what comes within its reach (`radius`, or the region's size, else 10),
+* and go back once it is gone. Its units: those at the place as it is first picked (within its reach and a little), or
+* what `units` say
+*
+* @beta
+*/
+function holdPosition(place, options = {}) {
+	const id = options.id ?? `mission.hold:${nameOf(place)}`;
+	return part(id, "hold", (_ai, memory) => {
+		const reach = (ai) => reachOf(ai, place, options.radius);
+		const at = (ai) => placeOf(ai, place);
+		const claim = ownUnits(memory, options, (ai) => ({
+			near: place,
+			within: reach(ai) + TAKE_PAST
+		}), at, reach);
+		return {
+			goal: defineGoal({
+				id,
+				weight: options.weight,
+				considerations: [...whenOf(options.when), consider("it knows where the place is", (ai) => at(ai) ? 1 : 0, curve.step(1))],
+				claims: { units: claim },
+				run: (ai, claimed) => {
+					const { squad } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()));
+					if (squad.idle) squad.defend(at(ai), reach(ai));
+				}
+			}),
+			inspect: () => ({ place: typeof place === "string" ? place : point(place) })
+		};
+	});
+}
+/**
+* Its units walk a round of places, one after the other and back to the first, fighting what they meet on the way. Its
+* units: those near the first place as it is first picked, or what `units` say. Places it does not know are passed over
+*
+* @beta
+*/
+function patrol(points, options = {}) {
+	if (!points.length) throw new Error("A patrol needs a place at least");
+	const id = options.id ?? `mission.patrol:${points.map(nameOf).join(">")}`;
+	return part(id, "patrol", (_ai, memory) => {
+		const round = (ai) => points.map((each) => placeOf(ai, each)).filter((each) => !!each);
+		const first = (ai) => round(ai)[0];
+		const claim = ownUnits(memory, options, () => ({
+			near: points[0],
+			within: 18
+		}), first, () => REACH);
+		return {
+			goal: defineGoal({
+				id,
+				weight: options.weight,
+				considerations: [...whenOf(options.when), consider("places it knows", (ai) => round(ai).length, curve.step(1))],
+				claims: { units: claim },
+				run: (ai, claimed) => {
+					const { squad } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()));
+					if (squad.idle) squad.patrol(round(ai));
+				}
+			}),
+			inspect: () => ({ points: points.map((each) => typeof each === "string" ? each : point(each)) })
+		};
+	});
+}
+/**
+* Its units stay by an entity, by its name (`world.named`) or its id: a unit they follow, a building they hold round
+* (within `radius`, 12 when left out), fighting what comes near it. While the entity stands: once it is gone, its units
+* are let go of. Its units: those near it as it is first picked (within 20), or what `units` say
+*
+* @beta
+*/
+function guard(entity, options = {}) {
+	const id = options.id ?? `mission.guard:${entity}`;
+	return part(id, "guard", (_ai, memory) => {
+		const target = (ai) => {
+			const found = typeof entity === "string" ? ai.view.named(entity) : ai.view.byId(entity);
+			return found && found.health > 0 ? found : void 0;
+		};
+		const at = (ai) => {
+			const found = target(ai);
+			return found && point(found);
+		};
+		const radius = options.radius ?? 12;
+		const claim = ownUnits(memory, options, () => ({
+			near: typeof entity === "string" ? entity : void 0,
+			within: 20
+		}), at, () => 20);
+		return {
+			goal: defineGoal({
+				id,
+				weight: options.weight,
+				considerations: [...whenOf(options.when), consider("what it guards stands", (ai) => target(ai) ? 1 : 0, curve.step(1))],
+				claims: { units: (ai, available) => {
+					if (typeof entity === "number" && !options.units && !memory.took) {
+						const found = target(ai);
+						return found ? available.units().alive().fighters().near(found, 20).items : [];
+					}
+					return claim(ai, available);
+				} },
+				run: (ai, claimed) => {
+					const { squad } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()));
+					const guarded = target(ai);
+					const moves = ai.view.def(guarded).kind === "unit" && (ai.view.strength.statsOf(guarded).moveSpeed ?? 0) > 0;
+					if (!squad.idle) return;
+					if (moves) squad.escort(guarded.id);
+					else squad.defend(point(guarded), radius);
+				}
+			}),
+			inspect: () => ({ guards: entity })
+		};
+	});
+}
+/**
+* Its units wait at a place on hold (they hit what walks into reach and move for nothing), and spring once a rival's
+* unit comes within `radius` of it (or once `trigger` holds): they go for the intruders, fighting what they meet. Once
+* that fight is over, `then` (`AmbushThen`). `once`: it springs the first time only. Its units: those at the place as it
+* is first picked, or what `units` say
+*
+* @beta
+*/
+function ambush(place, options = {}) {
+	const id = options.id ?? `mission.ambush:${nameOf(place)}`;
+	const then = options.then ?? "return";
+	return part(id, "ambush", (_ai, memory) => {
+		const reach = (ai) => reachOf(ai, place, options.radius);
+		const at = (ai) => placeOf(ai, place);
+		const claim = ownUnits(memory, options, (ai) => ({
+			near: place,
+			within: reach(ai) + TAKE_PAST
+		}), at, reach);
+		/** The rivals' units in reach of the place: what springs it, and what it goes for */
+		const intruders = (ai, there) => ai.view.enemies.units().alive().near(there, reach(ai));
+		const wait = (squad, there, came) => {
+			if (squad.current?.kind !== "hold" || squad.idle) squad.hold(there);
+			else if (came.length) {
+				squad.order({
+					type: "move",
+					point: there
+				}, came);
+				squad.order({ type: "hold" }, came, true);
+			}
+		};
+		return {
+			goal: defineGoal({
+				id,
+				weight: options.weight,
+				considerations: [...whenOf(options.when), consider("it knows where the place is", (ai) => at(ai) ? 1 : 0, curve.step(1))],
+				claims: { units: claim },
+				run: (ai, claimed) => {
+					const { squad, came } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()));
+					const there = at(ai);
+					if (memory.sprung === void 0) {
+						if (options.once && (memory.times ?? 0) > 0) {
+							if (squad.idle) squad.hold();
+							return;
+						}
+						const coming = intruders(ai, there);
+						if (!(options.trigger !== void 0 ? evaluate(options.trigger, ai) : coming.length > 0)) return wait(squad, there, came);
+						memory.sprung = ai.tick;
+						memory.times = (memory.times ?? 0) + 1;
+						const target = coming.centre() ?? ai.view.enemies.units().alive().nearest(there) ?? there;
+						ai.decide(`${id} springs: ${coming.length} in reach, at ${where(target)}`, { kind: "mission" });
+						squad.attack(point(target));
+						return;
+					}
+					if (!squad.idle) return;
+					memory.sprung = void 0;
+					if (then === "return" && !options.once) {
+						ai.decide(`${id} goes back to wait`, { kind: "mission" });
+						return wait(squad, there, []);
+					}
+					if (then !== "return" && then !== "stay" && !memory.acted) {
+						memory.acted = true;
+						act(ai, then);
+					}
+					squad.hold();
+				}
+			}),
+			inspect: () => ({
+				place: typeof place === "string" ? place : point(place),
+				...memory.sprung !== void 0 && { sprung: memory.sprung },
+				times: memory.times ?? 0
+			})
+		};
+	});
+}
+/** Where a wave goes from a place */
+function targetOf(ai, target, from) {
+	if (typeof target === "function") return target(ai);
+	if (target !== void 0) return placeOf(ai, target);
+	const known = ai.view.enemies.known().buildings().nearest(from) ?? ai.view.enemies.units().alive().nearest(from);
+	if (known) return point(known);
+	const told = ai.options.enemyBases?.[0];
+	return told && point(told);
+}
+/**
+* The units that come out of a spawner (what the mission's own rules spawn there, or what a building there trains),
+* gathered there and sent as a wave: once there are as many as `group` says (a number, or so many of each type or
+* role: `{ footman: 4, caster: 1 }`; 4 when left out), or, with `every`, every so many seconds with what has gathered
+* (at least `minForces` of the group: a share, any when left out). A wave goes for `target` (`MissionTarget`) and, once
+* that is cleared, for the next it knows of. `first`: seconds before the first wave may go (`every`, else none). Nothing
+* is trained or built: a mission with no economy feeds it
+*
+* @beta
+*/
+function waveFrom(source, options = {}) {
+	const id = options.id ?? `mission.wave:${nameOf(source)}`;
+	const group = options.group ?? 4;
+	const size = typeof group === "number" ? group : Object.values(group).reduce((sum, n) => sum + n, 0);
+	return part(id, "wave", (_ai, memory) => {
+		const from = (ai) => placeOf(ai, source);
+		const reach = (ai) => reachOf(ai, source, options.radius ?? SPAWN_REACH);
+		/** Whether a unit is of the group: any fighter for a number, else of a type or role it names */
+		const fits = (ai, entity) => typeof group === "number" ? ai.view.hasRole(entity, "soldier") || ai.view.hasRole(entity, "hero") : Object.keys(group).some((kind) => entity.type === kind || ai.view.hasRole(entity, kind));
+		/** What came out of the spawner and no one holds yet */
+		const come = (ai, available) => {
+			const at = from(ai);
+			if (!at) return [];
+			const held = new Set(ai.squads.of(id).squads.flatMap((squad) => squad.data.units));
+			return available.units().alive().near(at, reach(ai)).where((entity) => !held.has(entity.id) && !ai.goals.holder(entity.id) && fits(ai, entity)).items;
+		};
+		/** Whether the gathered make a wave now: the group whole, or the time come with enough of it */
+		const ready = (ai, gathered) => {
+			if (!gathered.length) return false;
+			const whole = typeof group === "number" ? gathered.length >= group : Object.entries(group).every(([kind, n]) => gathered.filter((entity) => entity.type === kind || ai.view.hasRole(entity, kind)).length >= n);
+			const last = memory.last ?? ai.tick;
+			const wait = (memory.sent ?? 0) === 0 ? options.first ?? options.every ?? 0 : options.every ?? 0;
+			if (!(ai.tick - last >= Math.round(wait * ai.session.tickRate))) return false;
+			if (whole) return true;
+			return options.every !== void 0 && gathered.length >= Math.max(1, Math.ceil(size * (options.minForces ?? 0)));
+		};
+		return {
+			goal: defineGoal({
+				id,
+				weight: options.weight,
+				considerations: [...whenOf(options.when), consider("it knows where the spawner is", (ai) => from(ai) ? 1 : 0, curve.step(1))],
+				claims: { units: (ai, available) => come(ai, available) },
+				run: (ai, claimed) => {
+					memory.last ??= ai.tick;
+					memory.took = true;
+					const at = from(ai);
+					const fresh = come(ai, ai.goals.pool());
+					let gathering = ai.squads.named(id);
+					const waves = ai.squads.of(id).squads.filter((squad) => squad !== gathering);
+					const sent = new Set(waves.flatMap((squad) => squad.data.units));
+					const waiting = [...[...claimed.units.ids()].filter((unit) => !sent.has(unit)), ...fresh.map((entity) => entity.id)];
+					if (waiting.length) {
+						if (!gathering) gathering = claimed.squad(id, waiting).hold();
+						else gathering.add(waiting, "came out");
+					}
+					memory.units = [.../* @__PURE__ */ new Set([...sent, ...gathering?.data.units ?? []])].sort((a, b) => a - b);
+					for (const wave of waves) {
+						if (!wave.idle || !wave.centre()) continue;
+						const next = targetOf(ai, options.target, wave.centre());
+						if (next) wave.attack(next);
+						else wave.hold();
+					}
+					const gathered = gathering?.units().items ?? [];
+					if (!gathering || !ready(ai, gathered)) return;
+					const target = targetOf(ai, options.target, at);
+					if (!target) return;
+					const n = (memory.sent ?? 0) + 1;
+					memory.sent = n;
+					memory.last = ai.tick;
+					claimed.squad(`${id} ${n}`, gathered).attack(target);
+					ai.decide(`${id} sends wave ${n} of ${gathered.length} at ${where(target)}`, { kind: "mission" });
+				}
+			}),
+			inspect: () => ({
+				source: typeof source === "string" ? source : point(source),
+				sent: memory.sent ?? 0,
+				last: memory.last
+			})
+		};
+	});
+}
+/**
+* When the condition holds, its units run: to `to` (a place), else home, else away from the nearest rival; and stand
+* there while it holds. Once it no longer does, they are let go of, and the parts that had them take them back. An
+* urgent goal worth 10: it takes its units from any other. Its units: its fighters, or what `units` say
+*
+* @beta
+*/
+function fleeWhen(condition, options = {}) {
+	const id = options.id ?? "mission.flee";
+	return part(id, "flee", () => {
+		/** Where to run: the place, home, or away from the nearest rival, on the map */
+		const refuge = (ai, squad) => {
+			const to = options.to !== void 0 ? placeOf(ai, options.to) : void 0;
+			if (to) return to;
+			const home = ai.view.home();
+			if (home) return point(home);
+			const middle = squad.centre();
+			const foe = middle && ai.view.enemies.units().alive().nearest(middle);
+			if (!middle || !foe) return void 0;
+			const dx = middle.x - foe.x;
+			const dz = middle.z - foe.z;
+			const length = Math.sqrt(dx * dx + dz * dz) || 1;
+			const { width, depth } = ai.session.terrain;
+			return {
+				x: Math.min(width - 1, Math.max(1, middle.x + dx / length * FLEE_AWAY)),
+				z: Math.min(depth - 1, Math.max(1, middle.z + dz / length * FLEE_AWAY))
+			};
+		};
+		return { goal: defineGoal({
+			id,
+			weight: options.weight ?? 10,
+			urgent: true,
+			considerations: [consider("it is time to run", (ai) => evaluate(condition, ai) ? 1 : 0, curve.step(1)), ...whenOf(options.when)],
+			claims: { units: (ai, available) => choose(ai, options.units ?? {}, available, ai.view.home(), REACH) },
+			commitment: 0,
+			run: (ai, claimed) => {
+				if (!claimed.first) {
+					const squad = ai.squads.named(id);
+					if (squad?.idle) squad.hold();
+					return;
+				}
+				const squad = claimed.squad(id, claimed.units);
+				const to = refuge(ai, squad);
+				ai.decide(`${id}: ${claimed.units.length} run${to ? ` to ${where(to)}` : ""}`, { kind: "mission" });
+				if (to) squad.retreat(to, "told to run");
+				else squad.hold();
+			}
+		}) };
+	});
+}
+/**
+* When the condition holds, the computer gives up: the engine's `surrender` command, as a player's, once. Out of the
+* game as if beaten
+*
+* @beta
+*/
+function surrenderWhen(condition, options = {}) {
+	const id = options.id ?? "mission.surrender";
+	return part(id, "surrender", (ai, memory) => ({
+		think: () => {
+			if (memory.done || !evaluate(condition, ai)) return;
+			memory.done = true;
+			ai.decide(`${id}: gives up`, { kind: "mission" });
+			ai.send({ type: "surrender" });
+		},
+		inspect: () => ({ done: !!memory.done })
+	}));
+}
+/**
+* A computer player for a mission: a brain (`defineBrain`) of what every mission's computer has (its rules, the words
+* every brain may be told, the goals' picker, squads, micro) and the parts it is given (`modules`: `holdPosition`,
+* `patrol`, `guard`, `ambush`, `waveFrom`, `fleeWhen`, `surrenderWhen`, any module of the kit's or of its own). Nothing
+* builds, trains, gathers, scouts or answers raids on its bases unless a module for it is given (`economy()`,
+* `scouting()`, `defence()`). Everything else of `BrainDef` as for any brain (`goals`, `micro`, `without`, `knowledge`)
+*
+* @public
+*/
+function missionBrain(def) {
+	const { modules = [], ...rest } = def;
+	return defineBrain({
+		...rest,
+		modules: [
+			defineModule({
+				id: "rules",
+				make: (ai) => rules(ai.def.rules ?? [])(ai)
+			}),
+			words(),
+			...modules,
+			goals(),
+			squads(),
+			micro()
+		]
+	});
+}
+//#endregion
+export { ambush, fleeWhen, guard, holdPosition, missionBrain, patrol, surrenderWhen, waveFrom };
+
+//# sourceMappingURL=mission.js.map

package/dist/ai/mission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission.js","names":[],"sources":["../../src/ai/mission.ts"],"sourcesContent":["import { shapeBounds } from '#engine/areas'\nimport { distSq, type Vec2 } from '#engine/math'\nimport type { EntityState } from '#engine/session/protocol'\nimport { type Brain, type BrainDef, type BrainExtension } from './brain'\nimport { type AiModule, type AiModuleDef, defineModule } from './module'\nimport { defineBrain } from './define'\nimport { consider, type Consideration, curve, defineGoal, type GoalDef, goals } from './goals'\nimport { micro } from './micro'\nimport type { AiRole } from './roles'\nimport { type AiAction, type AiCondition, evaluate, rules, words } from './rules'\nimport { type Squad, squads } from './squads'\nimport type { UnitSet } from './view'\nimport { point, where } from './geometry'\n\n/*\n * The mission brain (AI plan, D4): a computer player for a mission, made of the few parts a mission needs. Before it, a\n * mission had the whole melee player (which builds, trains, scouts and sends waves on its own clock: rarely what a\n * story wants) or wrote everything itself in a system beside the computer. Now it lists parts:\n *\n *   missionBrain({\n *     id: 'campaign.redHand',\n *     modules: [holdPosition('camp'), guard('camp hall'), patrol(['ford', 'mill'])],\n *     rules: [when.told('raid').do({ say: 'attack', data: { at: 'hall' } })]\n *   })\n *\n * `missionBrain` is `defineBrain` with what every mission's computer has: its rules (`BrainDef.rules`) and the words\n * every brain may be told (B2), the goals' picker (B1), squads (C1) and micro (C2). Nothing builds, trains, gathers,\n * scouts or defends its bases the melee player's way (C4's `defence()` calls whole squads home to a raid, a guard and a\n * patrol with them): a mission says who holds what with its parts, and adds the kit's module for anything more.\n *\n * **The parts.** Each is a module that puts one goal on the picker (a goal holds units, so the parts, the words and a\n * rule's orders never fight over a unit: B1's \"who may move a unit\"), and remembers what it needs in the brain's memory:\n *\n * - `holdPosition(place)`: the units there hold it, fighting what comes within its reach and going back after.\n * - `patrol(points)`: a round of places walked again and again, fighting what is met.\n * - `guard(entity)`: units stay by a unit (they follow it) or a building (they hold round it) and fight what comes.\n * - `ambush(place, { then })`: units wait on hold, and spring once a rival walks into reach; then go back to wait,\n *   stay, or do what `then` says (a word, a function).\n * - `waveFrom(place, { group, every })`: the units that come out of a spawner (what the mission's own rules spawn, or a\n *   building that trains them) are gathered there and sent as a wave once there are enough, or every so often.\n * - `fleeWhen(condition)`: when it holds, the army runs (home, or to a place), and comes back when it no longer does.\n * - `surrenderWhen(condition)`: when it holds, the computer gives up (the engine's `surrender` command).\n *\n * **Its own units.** A part takes its units once, as it is first picked (those at its place, or those its `units`\n * say), and remembers them by id: a word that took them for a while (`attack`) gives them back to it after, and they\n * walk back to their post, wherever the word took them. With `refill`, units that come later and fit are taken too.\n *\n * Every part has a data form (places by name, conditions as data) and a function form (`units` as a function, a target\n * as a function, `then` as a function): a mission's JSON can hold the first.\n */\n\n/**\n * Where a mission's part is: a point, or a name the map or the rules gave an entity (`world.named`) or a region of the\n * map\n *\n * @beta\n */\nexport type MissionPlace = Vec2 | string\n\n/**\n * Which of its units a part takes, as data: those named (`named`), of a type, a role or a tag, near a place (`near`,\n * `within`), at most so many (`count`, the nearest the part's place first). Its fighters (soldiers and heroes) where\n * none of `named`, `type`, `role`, `tag` is given\n *\n * @beta\n */\nexport interface MissionUnitsData {\n\t/** Entities the map or the rules named (`world.named`): those of them that are its own */\n\tnamed?: string[]\n\t/** Of a type, or of any of a list */\n\ttype?: string | string[]\n\t/** Only units of this role; the role is inferred or declared for the unit type (`RoleTable`) */\n\trole?: AiRole\n\t/** Only units of a type with this tag */\n\ttag?: string\n\t/** Near a place */\n\tnear?: MissionPlace\n\t/** How near `near` (the part's reach when left out) */\n\twithin?: number\n\t/** At most so many, the nearest the part's place first */\n\tcount?: number\n}\n\n/**\n * Which of its units a part takes: data (`MissionUnitsData`), or a function choosing from those it may have\n * (`available`: what no goal holds, and what goals it may take from hold)\n *\n * @beta\n */\nexport type MissionUnits = MissionUnitsData | ((ai: Brain, available: UnitSet) => Iterable<EntityState>)\n\n/**\n * What every part of a mission takes\n *\n * @beta\n */\nexport interface MissionPartOptions {\n\t/**\n\t * Its id: the module's, the goal's and the squad's, what the report and the log name it by. `mission.<part>:<place>`\n\t * when left out (`mission.hold:camp`); give one where two parts of a kind share a place\n\t */\n\tid?: string\n\t/** Which of its units it takes, once, as it is first picked: those at its place when left out (its fighters for `fleeWhen`) */\n\tunits?: MissionUnits\n\t/** Whether units that come later and fit `units` are taken too: no when left out (`waveFrom` always takes what comes) */\n\trefill?: boolean\n\t/** Only while this holds: the part lets go of its units while it does not (a condition, as data or a function) */\n\twhen?: AiCondition\n\t/** What it is worth against the brain's other goals: 1 when left out (10 for `fleeWhen`) */\n\tweight?: number\n}\n\n/**\n * What a part remembers between thinks, as a save keeps it: its own units, and what its kind adds (an ambush's spring,\n * a wave's count)\n *\n * @beta\n */\nexport interface MissionPartMemory {\n\t/** The version of the memory's format: 1 so far */\n\tv: 1\n\t/** Whether it took its units yet: they are taken once */\n\ttook: boolean\n\t/** Its own units, by id: what it takes back after a word or a rule had them */\n\tunits: number[]\n\t/** An ambush: the tick it sprang at, while sprung; how many times it sprang; whether its `then` was done */\n\tsprung?: number\n\t/** How many times the ambush sprang */\n\ttimes?: number\n\t/** Whether the ambush's `then` was carried out */\n\tacted?: boolean\n\t/** A wave: how many were sent; the tick the last went at (or the part began at) */\n\tsent?: number\n\t/** The tick the last wave was sent at, or the part began at */\n\tlast?: number\n\t/** `surrenderWhen`: whether it gave up */\n\tdone?: boolean\n}\n\n/**\n * The mission brain's definition: a brain's (`BrainDef`) with the parts given as `modules`, after the ones every mission\n * has. Its `id` is what a save remembers the seat by: list the brain in `Rules.brains`\n *\n * @beta\n */\nexport interface MissionBrainDef extends BrainExtension {\n\t/** The brain's id, which a save remembers the seat by and which `Rules.brains` lists it under */\n\tid: string\n}\n\n/** How far a part reaches round its place, where neither it nor a region says: what holds a camp holds this much round it */\nconst REACH = 10\n/** How much past its reach a part's units are looked for as it first takes them */\nconst TAKE_PAST = 8\n/** How near a spawner a unit has come out of it */\nconst SPAWN_REACH = 10\n/** How far a unit with nowhere to run to runs from the nearest rival */\nconst FLEE_AWAY = 20\n\n/** A place as an id writes it */\nconst nameOf = (place: MissionPlace) => (typeof place === 'string' ? place : `${Math.round(place.x)},${Math.round(place.z)}`)\n\n/**\n * Where a place is for the player: a point as it is; a name, the entity it names where the player knows of it, else the\n * middle of the region of that name. Nothing for a name it does not know\n */\nfunction placeOf(ai: Brain, place: MissionPlace): Vec2 | undefined {\n\tif (typeof place !== 'string') return point(place)\n\tconst named = ai.view.named(place)\n\tif (named) return point(named)\n\tconst region = ai.view.region(place)\n\treturn region && { x: region.shape.x, z: region.shape.z }\n}\n\n/** How far a part reaches round its place: what it was given, else a region's size, else `REACH` */\nfunction reachOf(ai: Brain, place: MissionPlace, given: number | undefined): number {\n\tif (given !== undefined) return given\n\tif (typeof place === 'string' && !ai.view.named(place)) {\n\t\tconst shape = ai.view.region(place)?.shape\n\t\tif (shape) {\n\t\t\tconst { x0, z0, x1, z1 } = shapeBounds(shape)\n\t\t\treturn Math.max(x1 - x0, z1 - z0) / 2\n\t\t}\n\t}\n\treturn REACH\n}\n\n/** The part's `when`, as a consideration that vetoes it while the condition does not hold */\nconst whenOf = (condition: AiCondition | undefined): Consideration[] =>\n\tcondition === undefined ? [] : [consider('its condition holds', (ai) => (evaluate(condition, ai) ? 1 : 0), curve.step(1))]\n\n/** Does an action: a function of the brain, or a word it tells itself (`{ say, data }`) */\nfunction act(ai: Brain, action: AiAction): void {\n\tif (typeof action === 'function') action(ai)\n\telse ai.tell(action.say, action.data, ai.tick)\n}\n\n/**\n * The units a part's `units` choose of those it may have: the data form read (named, type, role, tag, near, count), or\n * the function asked; its fighters at its place where `fallback` says so\n */\nfunction choose(ai: Brain, units: MissionUnits, available: UnitSet, around: Vec2 | undefined, reach: number): EntityState[] {\n\tif (typeof units === 'function') return [...units(ai, available)]\n\tlet set = available.units().alive()\n\tif (units.named) {\n\t\tconst names = units.named\n\t\tset = set.where((entity) => entity.name !== undefined && names.includes(entity.name))\n\t} else if (units.type === undefined && units.role === undefined && units.tag === undefined) set = set.fighters()\n\tif (units.type !== undefined) {\n\t\tconst types = Array.isArray(units.type) ? units.type : [units.type]\n\t\tset = set.where((entity) => types.includes(entity.type))\n\t}\n\tif (units.role !== undefined) set = set.withRole(units.role)\n\tif (units.tag !== undefined) set = set.withTag(units.tag)\n\tif (units.near !== undefined) {\n\t\tconst near = placeOf(ai, units.near)\n\t\tif (!near) return []\n\t\tset = set.near(near, units.within ?? reach)\n\t}\n\tconst chosen = [...set]\n\tif (units.count !== undefined && around) {\n\t\tchosen.sort((a, b) => distSq(a, around) - distSq(b, around) || a.id - b.id)\n\t\treturn chosen.slice(0, Math.max(0, units.count))\n\t}\n\treturn units.count !== undefined ? chosen.slice(0, Math.max(0, units.count)) : chosen\n}\n\n/** What a part is made of, for each brain: its goal, and what of a module it has beside */\ninterface PartMade {\n\tgoal?: GoalDef\n\tthink?(): void\n\tinspect?(): Record<string, unknown>\n}\n\n/**\n * A part of a mission: a module (its id the part's) that puts its goal on the brain's picker and keeps its memory. A\n * brain without a `goals()` module (or the melee brain's) never runs the goal: the log says so once\n */\nfunction part(id: string, kind: string, make: (ai: Brain, memory: MissionPartMemory) => PartMade): AiModuleDef {\n\treturn defineModule({ id, make: (ai: Brain): AiModule => {\n\t\tconst memory: MissionPartMemory = { v: 1, took: false, units: [] }\n\t\tconst made = make(ai, memory)\n\t\tif (made.goal) ai.goals.add(made.goal)\n\t\tlet warned = false\n\t\treturn {\n\t\t\tid,\n\t\t\tversion: 1,\n\t\t\tphase: 'decide',\n\t\t\tthink: () => {\n\t\t\t\tif (made.goal && !warned && !ai.module('goals')) {\n\t\t\t\t\twarned = true\n\t\t\t\t\tai.log.warn('ai', `the mission's part \"${id}\" is a goal, and the brain \"${ai.def.id}\" has no goals() module to pick it`)\n\t\t\t\t}\n\t\t\t\tmade.think?.()\n\t\t\t},\n\t\t\tsave: () => structuredClone(memory),\n\t\t\t// written into the same object: the goal's closures read it\n\t\t\trestore: (data) => {\n\t\t\t\tconst kept = data && typeof data === 'object' ? (data as MissionPartMemory) : undefined\n\t\t\t\tfor (const key of Object.keys(memory)) delete (memory as unknown as Record<string, unknown>)[key]\n\t\t\t\tObject.assign(memory, { v: 1, took: false, units: [] }, structuredClone(kept ?? {}))\n\t\t\t},\n\t\t\tinspect: () => ({ part: kind, units: [...memory.units], ...made.inspect?.() })\n\t\t}\n\t} })\n}\n\n/**\n * The claim of a part that keeps its own units (`MissionPartMemory.units`): those it took, wherever they are, as it is\n * picked again; the first time (and with `refill`, each time) what its `units` choose\n */\nfunction ownUnits(\n\tmemory: MissionPartMemory,\n\toptions: MissionPartOptions,\n\tfallback: (ai: Brain) => MissionUnitsData,\n\taround: (ai: Brain) => Vec2 | undefined,\n\treach: (ai: Brain) => number\n): (ai: Brain, available: UnitSet) => readonly EntityState[] {\n\treturn (ai, available) => {\n\t\tconst kept = available.where((entity) => memory.units.includes(entity.id)).items\n\t\tif (memory.took && !options.refill) return kept\n\t\tconst more = choose(ai, options.units ?? fallback(ai), available, around(ai), reach(ai))\n\t\treturn [...kept, ...more.filter((entity) => !memory.units.includes(entity.id))]\n\t}\n}\n\n/**\n * A part's run, as each think begins: what it holds is its own from now on (`memory.units`, the dead let go of), and its\n * own units back in the pool (a word that had them is over) are taken back into its squad. The squad: made where there is\n * none. Those that came into it this think, by id\n */\nfunction muster(\n\tai: Brain,\n\tid: string,\n\tmemory: MissionPartMemory,\n\theld: UnitSet,\n\toptions: MissionPartOptions,\n\tchoosing?: () => readonly EntityState[]\n): {\n\tsquad: Squad\n\tcame: number[]\n} {\n\tconst { mine } = ai.view\n\tmemory.took = true\n\tconst own = new Set(memory.units.filter((unit) => mine.has(unit)))\n\tfor (const unit of held) own.add(unit.id)\n\t// its own, back from a word or a rule: what nothing holds now is given to it\n\tconst pool = ai.goals.pool()\n\tconst back = [...own].filter((unit) => pool.has(unit))\n\tif (options.refill && choosing) for (const entity of choosing()) if (pool.has(entity.id)) back.push(entity.id)\n\tlet squad = ai.squads.named(id)\n\tconst before = new Set(squad?.data.units ?? [])\n\tif (!squad || squad.owner !== id) squad = ai.squads.make(id, [...held.ids(), ...back], { owner: id })\n\telse squad.add([...[...held.ids()].filter((unit) => !before.has(unit)), ...back], 'back at its post')\n\tfor (const unit of squad.data.units) own.add(unit)\n\tmemory.units = [...own].filter((unit) => mine.has(unit)).sort((a, b) => a - b)\n\treturn { squad, came: squad.data.units.filter((unit) => !before.has(unit)) }\n}\n\n/**\n * Its units hold a place: they go there, fight what comes within its reach (`radius`, or the region's size, else 10),\n * and go back once it is gone. Its units: those at the place as it is first picked (within its reach and a little), or\n * what `units` say\n *\n * @beta\n */\nexport function holdPosition(place: MissionPlace, options: MissionPartOptions & { radius?: number } = {}): AiModuleDef {\n\tconst id = options.id ?? `mission.hold:${nameOf(place)}`\n\treturn part(id, 'hold', (_ai, memory) => {\n\t\tconst reach = (ai: Brain) => reachOf(ai, place, options.radius)\n\t\tconst at = (ai: Brain) => placeOf(ai, place)\n\t\tconst claim = ownUnits(memory, options, (ai) => ({ near: place, within: reach(ai) + TAKE_PAST }), at, reach)\n\t\treturn {\n\t\t\tgoal: defineGoal({\n\t\t\t\tid,\n\t\t\t\tweight: options.weight,\n\t\t\t\tconsiderations: [...whenOf(options.when), consider('it knows where the place is', (ai) => (at(ai) ? 1 : 0), curve.step(1))],\n\t\t\t\tclaims: { units: claim },\n\t\t\t\trun: (ai, claimed) => {\n\t\t\t\t\tconst { squad } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()))\n\t\t\t\t\t// given its task as made, and again once a task of its own is over (a fall back on the odds): never over another\n\t\t\t\t\tif (squad.idle) squad.defend(at(ai)!, reach(ai))\n\t\t\t\t}\n\t\t\t}),\n\t\t\tinspect: () => ({ place: typeof place === 'string' ? place : point(place) })\n\t\t}\n\t})\n}\n\n/**\n * Its units walk a round of places, one after the other and back to the first, fighting what they meet on the way. Its\n * units: those near the first place as it is first picked, or what `units` say. Places it does not know are passed over\n *\n * @beta\n */\nexport function patrol(points: readonly MissionPlace[], options: MissionPartOptions = {}): AiModuleDef {\n\tif (!points.length) throw new Error('A patrol needs a place at least')\n\tconst id = options.id ?? `mission.patrol:${points.map(nameOf).join('>')}`\n\treturn part(id, 'patrol', (_ai, memory) => {\n\t\tconst round = (ai: Brain) => points.map((each) => placeOf(ai, each)).filter((each): each is Vec2 => !!each)\n\t\tconst first = (ai: Brain) => round(ai)[0]\n\t\tconst claim = ownUnits(\n\t\t\tmemory,\n\t\t\toptions,\n\t\t\t() => ({ near: points[0], within: REACH + TAKE_PAST }),\n\t\t\tfirst,\n\t\t\t() => REACH\n\t\t)\n\t\treturn {\n\t\t\tgoal: defineGoal({\n\t\t\t\tid,\n\t\t\t\tweight: options.weight,\n\t\t\t\tconsiderations: [...whenOf(options.when), consider('places it knows', (ai) => round(ai).length, curve.step(1))],\n\t\t\t\tclaims: { units: claim },\n\t\t\t\trun: (ai, claimed) => {\n\t\t\t\t\tconst { squad } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()))\n\t\t\t\t\tif (squad.idle) squad.patrol(round(ai))\n\t\t\t\t}\n\t\t\t}),\n\t\t\tinspect: () => ({ points: points.map((each) => (typeof each === 'string' ? each : point(each))) })\n\t\t}\n\t})\n}\n\n/**\n * Its units stay by an entity, by its name (`world.named`) or its id: a unit they follow, a building they hold round\n * (within `radius`, 12 when left out), fighting what comes near it. While the entity stands: once it is gone, its units\n * are let go of. Its units: those near it as it is first picked (within 20), or what `units` say\n *\n * @beta\n */\nexport function guard(entity: string | number, options: MissionPartOptions & { radius?: number } = {}): AiModuleDef {\n\tconst id = options.id ?? `mission.guard:${entity}`\n\treturn part(id, 'guard', (_ai, memory) => {\n\t\tconst target = (ai: Brain): EntityState | undefined => {\n\t\t\tconst found = typeof entity === 'string' ? ai.view.named(entity) : ai.view.byId(entity)\n\t\t\treturn found && found.health > 0 ? found : undefined\n\t\t}\n\t\tconst at = (ai: Brain) => {\n\t\t\tconst found = target(ai)\n\t\t\treturn found && point(found)\n\t\t}\n\t\tconst radius = options.radius ?? 12\n\t\tconst claim = ownUnits(\n\t\t\tmemory,\n\t\t\toptions,\n\t\t\t() => ({ near: typeof entity === 'string' ? entity : undefined, within: 20 }),\n\t\t\tat,\n\t\t\t() => 20\n\t\t)\n\t\treturn {\n\t\t\tgoal: defineGoal({\n\t\t\t\tid,\n\t\t\t\tweight: options.weight,\n\t\t\t\tconsiderations: [...whenOf(options.when), consider('what it guards stands', (ai) => (target(ai) ? 1 : 0), curve.step(1))],\n\t\t\t\tclaims: {\n\t\t\t\t\tunits: (ai, available) => {\n\t\t\t\t\t\t// by id, with no name to look near: the nearest fighters to it, as data with `near` would\n\t\t\t\t\t\tif (typeof entity === 'number' && !options.units && !memory.took) {\n\t\t\t\t\t\t\tconst found = target(ai)\n\t\t\t\t\t\t\treturn found ? available.units().alive().fighters().near(found, 20).items : []\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn claim(ai, available)\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\trun: (ai, claimed) => {\n\t\t\t\t\tconst { squad } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()))\n\t\t\t\t\tconst guarded = target(ai)!\n\t\t\t\t\tconst moves = ai.view.def(guarded).kind === 'unit' && (ai.view.strength.statsOf(guarded).moveSpeed ?? 0) > 0\n\t\t\t\t\t// a unit it follows; a building it holds round. Given again once a task of its own is over\n\t\t\t\t\tif (!squad.idle) return\n\t\t\t\t\tif (moves) squad.escort(guarded.id)\n\t\t\t\t\telse squad.defend(point(guarded), radius)\n\t\t\t\t}\n\t\t\t}),\n\t\t\tinspect: () => ({ guards: entity })\n\t\t}\n\t})\n}\n\n/**\n * What an ambush does once the fight it sprang is over: `return` to its place and wait again (the default), `stay`\n * where it is, or an action (a word it tells itself, `{ say: 'attack' }`, or a function of the brain), done once\n *\n * @beta\n */\nexport type AmbushThen = 'return' | 'stay' | AiAction\n\n/**\n * Its units wait at a place on hold (they hit what walks into reach and move for nothing), and spring once a rival's\n * unit comes within `radius` of it (or once `trigger` holds): they go for the intruders, fighting what they meet. Once\n * that fight is over, `then` (`AmbushThen`). `once`: it springs the first time only. Its units: those at the place as it\n * is first picked, or what `units` say\n *\n * @beta\n */\nexport function ambush(\n\tplace: MissionPlace,\n\toptions: MissionPartOptions & { radius?: number; trigger?: AiCondition; then?: AmbushThen; once?: boolean } = {}\n): AiModuleDef {\n\tconst id = options.id ?? `mission.ambush:${nameOf(place)}`\n\tconst then = options.then ?? 'return'\n\treturn part(id, 'ambush', (_ai, memory) => {\n\t\tconst reach = (ai: Brain) => reachOf(ai, place, options.radius)\n\t\tconst at = (ai: Brain) => placeOf(ai, place)\n\t\tconst claim = ownUnits(memory, options, (ai) => ({ near: place, within: reach(ai) + TAKE_PAST }), at, reach)\n\t\t/** The rivals' units in reach of the place: what springs it, and what it goes for */\n\t\tconst intruders = (ai: Brain, there: Vec2) => ai.view.enemies.units().alive().near(there, reach(ai))\n\t\tconst wait = (squad: Squad, there: Vec2, came: number[]) => {\n\t\t\tif (squad.current?.kind !== 'hold' || squad.idle) squad.hold(there)\n\t\t\t// its own back from elsewhere: to the place, and on hold there (the hold of the task holds where a unit stands)\n\t\t\telse if (came.length) {\n\t\t\t\tsquad.order({ type: 'move', point: there }, came)\n\t\t\t\tsquad.order({ type: 'hold' }, came, true)\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tgoal: defineGoal({\n\t\t\t\tid,\n\t\t\t\tweight: options.weight,\n\t\t\t\tconsiderations: [...whenOf(options.when), consider('it knows where the place is', (ai) => (at(ai) ? 1 : 0), curve.step(1))],\n\t\t\t\tclaims: { units: claim },\n\t\t\t\trun: (ai, claimed) => {\n\t\t\t\t\tconst { squad, came } = muster(ai, id, memory, claimed.units, options, () => claim(ai, ai.goals.pool()))\n\t\t\t\t\tconst there = at(ai)!\n\t\t\t\t\tif (memory.sprung === undefined) {\n\t\t\t\t\t\tconst done = options.once && (memory.times ?? 0) > 0\n\t\t\t\t\t\tif (done) {\n\t\t\t\t\t\t\tif (squad.idle) squad.hold()\n\t\t\t\t\t\t\treturn\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst coming = intruders(ai, there)\n\t\t\t\t\t\tconst sprung = options.trigger !== undefined ? evaluate(options.trigger, ai) : coming.length > 0\n\t\t\t\t\t\tif (!sprung) return wait(squad, there, came)\n\t\t\t\t\t\tmemory.sprung = ai.tick\n\t\t\t\t\t\tmemory.times = (memory.times ?? 0) + 1\n\t\t\t\t\t\t// for the intruders where it sees them; else (a trigger of its own) the nearest rival it sees, else its place\n\t\t\t\t\t\tconst target = coming.centre() ?? ai.view.enemies.units().alive().nearest(there) ?? there\n\t\t\t\t\t\tai.decide(`${id} springs: ${coming.length} in reach, at ${where(target)}`, { kind: 'mission' })\n\t\t\t\t\t\tsquad.attack(point(target))\n\t\t\t\t\t\treturn\n\t\t\t\t\t}\n\t\t\t\t\t// sprung: the fight goes on while its task does; once over, what then\n\t\t\t\t\tif (!squad.idle) return\n\t\t\t\t\tmemory.sprung = undefined\n\t\t\t\t\tif (then === 'return' && !options.once) {\n\t\t\t\t\t\tai.decide(`${id} goes back to wait`, { kind: 'mission' })\n\t\t\t\t\t\treturn wait(squad, there, [])\n\t\t\t\t\t}\n\t\t\t\t\tif (then !== 'return' && then !== 'stay' && !memory.acted) {\n\t\t\t\t\t\tmemory.acted = true\n\t\t\t\t\t\tact(ai, then)\n\t\t\t\t\t}\n\t\t\t\t\tsquad.hold()\n\t\t\t\t}\n\t\t\t}),\n\t\t\tinspect: () => ({\n\t\t\t\tplace: typeof place === 'string' ? place : point(place),\n\t\t\t\t...(memory.sprung !== undefined && { sprung: memory.sprung }),\n\t\t\t\ttimes: memory.times ?? 0\n\t\t\t})\n\t\t}\n\t})\n}\n\n/**\n * Where a wave goes: a place (a point, or a name), or a function of the brain. The nearest building of a rival's it\n * knows of when left out, else the nearest rival it sees, else the first base the seat was told (`AiOptions.enemyBases`)\n *\n * @beta\n */\nexport type MissionTarget = MissionPlace | ((ai: Brain) => Vec2 | undefined)\n\n/** Where a wave goes from a place */\nfunction targetOf(ai: Brain, target: MissionTarget | undefined, from: Vec2): Vec2 | undefined {\n\tif (typeof target === 'function') return target(ai)\n\tif (target !== undefined) return placeOf(ai, target)\n\tconst known = ai.view.enemies.known().buildings().nearest(from) ?? ai.view.enemies.units().alive().nearest(from)\n\tif (known) return point(known)\n\tconst told = ai.options.enemyBases?.[0]\n\treturn told && point(told)\n}\n\n/**\n * The units that come out of a spawner (what the mission's own rules spawn there, or what a building there trains),\n * gathered there and sent as a wave: once there are as many as `group` says (a number, or so many of each type or\n * role: `{ footman: 4, caster: 1 }`; 4 when left out), or, with `every`, every so many seconds with what has gathered\n * (at least `minForces` of the group: a share, any when left out). A wave goes for `target` (`MissionTarget`) and, once\n * that is cleared, for the next it knows of. `first`: seconds before the first wave may go (`every`, else none). Nothing\n * is trained or built: a mission with no economy feeds it\n *\n * @beta\n */\nexport function waveFrom(\n\tsource: MissionPlace,\n\toptions: Omit<MissionPartOptions, 'units' | 'refill'> & {\n\t\tgroup?: number | Record<string, number>\n\t\tevery?: number\n\t\tminForces?: number\n\t\tfirst?: number\n\t\ttarget?: MissionTarget\n\t\tradius?: number\n\t} = {}\n): AiModuleDef {\n\tconst id = options.id ?? `mission.wave:${nameOf(source)}`\n\tconst group = options.group ?? 4\n\tconst size = typeof group === 'number' ? group : Object.values(group).reduce((sum, n) => sum + n, 0)\n\treturn part(id, 'wave', (_ai, memory) => {\n\t\tconst from = (ai: Brain) => placeOf(ai, source)\n\t\tconst reach = (ai: Brain) => reachOf(ai, source, options.radius ?? SPAWN_REACH)\n\t\t/** Whether a unit is of the group: any fighter for a number, else of a type or role it names */\n\t\tconst fits = (ai: Brain, entity: EntityState) =>\n\t\t\ttypeof group === 'number'\n\t\t\t\t? ai.view.hasRole(entity, 'soldier') || ai.view.hasRole(entity, 'hero')\n\t\t\t\t: Object.keys(group).some((kind) => entity.type === kind || ai.view.hasRole(entity, kind as AiRole))\n\t\t/** What came out of the spawner and no one holds yet */\n\t\tconst come = (ai: Brain, available: UnitSet) => {\n\t\t\tconst at = from(ai)\n\t\t\tif (!at) return []\n\t\t\tconst held = new Set(ai.squads.of(id).squads.flatMap((squad) => squad.data.units))\n\t\t\treturn available\n\t\t\t\t.units()\n\t\t\t\t.alive()\n\t\t\t\t.near(at, reach(ai))\n\t\t\t\t.where((entity) => !held.has(entity.id) && !ai.goals.holder(entity.id) && fits(ai, entity)).items\n\t\t}\n\t\t/** Whether the gathered make a wave now: the group whole, or the time come with enough of it */\n\t\tconst ready = (ai: Brain, gathered: readonly EntityState[]) => {\n\t\t\tif (!gathered.length) return false\n\t\t\tconst whole =\n\t\t\t\ttypeof group === 'number'\n\t\t\t\t\t? gathered.length >= group\n\t\t\t\t\t: Object.entries(group).every(\n\t\t\t\t\t\t\t([kind, n]) => gathered.filter((entity) => entity.type === kind || ai.view.hasRole(entity, kind as AiRole)).length >= n\n\t\t\t\t\t\t)\n\t\t\tconst last = memory.last ?? ai.tick\n\t\t\tconst wait = (memory.sent ?? 0) === 0 ? (options.first ?? options.every ?? 0) : (options.every ?? 0)\n\t\t\tconst time = ai.tick - last >= Math.round(wait * ai.session.tickRate)\n\t\t\tif (!time) return false\n\t\t\tif (whole) return true\n\t\t\treturn options.every !== undefined && gathered.length >= Math.max(1, Math.ceil(size * (options.minForces ?? 0)))\n\t\t}\n\t\treturn {\n\t\t\tgoal: defineGoal({\n\t\t\t\tid,\n\t\t\t\tweight: options.weight,\n\t\t\t\tconsiderations: [...whenOf(options.when), consider('it knows where the spawner is', (ai) => (from(ai) ? 1 : 0), curve.step(1))],\n\t\t\t\tclaims: { units: (ai, available) => come(ai, available) },\n\t\t\t\trun: (ai, claimed) => {\n\t\t\t\t\tmemory.last ??= ai.tick\n\t\t\t\t\tmemory.took = true\n\t\t\t\t\tconst at = from(ai)!\n\t\t\t\t\t// what came out since: into the gathering, on hold where it stands\n\t\t\t\t\tconst fresh = come(ai, ai.goals.pool())\n\t\t\t\t\tlet gathering = ai.squads.named(id)\n\t\t\t\t\tconst waves = ai.squads.of(id).squads.filter((squad) => squad !== gathering)\n\t\t\t\t\tconst sent = new Set(waves.flatMap((squad) => squad.data.units))\n\t\t\t\t\tconst waiting = [...[...claimed.units.ids()].filter((unit) => !sent.has(unit)), ...fresh.map((entity) => entity.id)]\n\t\t\t\t\tif (waiting.length) {\n\t\t\t\t\t\tif (!gathering) gathering = claimed.squad(id, waiting).hold()\n\t\t\t\t\t\telse gathering.add(waiting, 'came out')\n\t\t\t\t\t}\n\t\t\t\t\tmemory.units = [...new Set([...sent, ...(gathering?.data.units ?? [])])].sort((a, b) => a - b)\n\t\t\t\t\t// a wave that cleared what it went for goes for the next; with nothing known, it stands where it is\n\t\t\t\t\tfor (const wave of waves) {\n\t\t\t\t\t\tif (!wave.idle || !wave.centre()) continue\n\t\t\t\t\t\tconst next = targetOf(ai, options.target, wave.centre()!)\n\t\t\t\t\t\tif (next) wave.attack(next)\n\t\t\t\t\t\telse wave.hold()\n\t\t\t\t\t}\n\t\t\t\t\tconst gathered = gathering?.units().items ?? []\n\t\t\t\t\tif (!gathering || !ready(ai, gathered)) return\n\t\t\t\t\tconst target = targetOf(ai, options.target, at)\n\t\t\t\t\tif (!target) return\n\t\t\t\t\tconst n = (memory.sent ?? 0) + 1\n\t\t\t\t\tmemory.sent = n\n\t\t\t\t\tmemory.last = ai.tick\n\t\t\t\t\tclaimed.squad(`${id} ${n}`, gathered).attack(target)\n\t\t\t\t\tai.decide(`${id} sends wave ${n} of ${gathered.length} at ${where(target)}`, { kind: 'mission' })\n\t\t\t\t}\n\t\t\t}),\n\t\t\tinspect: () => ({ source: typeof source === 'string' ? source : point(source), sent: memory.sent ?? 0, last: memory.last })\n\t\t}\n\t})\n}\n\n/**\n * When the condition holds, its units run: to `to` (a place), else home, else away from the nearest rival; and stand\n * there while it holds. Once it no longer does, they are let go of, and the parts that had them take them back. An\n * urgent goal worth 10: it takes its units from any other. Its units: its fighters, or what `units` say\n *\n * @beta\n */\nexport function fleeWhen(condition: AiCondition, options: Omit<MissionPartOptions, 'refill'> & { to?: MissionPlace } = {}): AiModuleDef {\n\tconst id = options.id ?? 'mission.flee'\n\treturn part(id, 'flee', () => {\n\t\t/** Where to run: the place, home, or away from the nearest rival, on the map */\n\t\tconst refuge = (ai: Brain, squad: Squad): Vec2 | undefined => {\n\t\t\tconst to = options.to !== undefined ? placeOf(ai, options.to) : undefined\n\t\t\tif (to) return to\n\t\t\tconst home = ai.view.home()\n\t\t\tif (home) return point(home)\n\t\t\tconst middle = squad.centre()\n\t\t\tconst foe = middle && ai.view.enemies.units().alive().nearest(middle)\n\t\t\tif (!middle || !foe) return undefined\n\t\t\tconst dx = middle.x - foe.x\n\t\t\tconst dz = middle.z - foe.z\n\t\t\tconst length = Math.sqrt(dx * dx + dz * dz) || 1\n\t\t\tconst { width, depth } = ai.session.terrain\n\t\t\treturn {\n\t\t\t\tx: Math.min(width - 1, Math.max(1, middle.x + (dx / length) * FLEE_AWAY)),\n\t\t\t\tz: Math.min(depth - 1, Math.max(1, middle.z + (dz / length) * FLEE_AWAY))\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tgoal: defineGoal({\n\t\t\t\tid,\n\t\t\t\tweight: options.weight ?? 10,\n\t\t\t\turgent: true,\n\t\t\t\tconsiderations: [consider('it is time to run', (ai) => (evaluate(condition, ai) ? 1 : 0), curve.step(1)), ...whenOf(options.when)],\n\t\t\t\tclaims: { units: (ai, available) => choose(ai, options.units ?? {}, available, ai.view.home(), REACH) },\n\t\t\t\tcommitment: 0,\n\t\t\t\trun: (ai, claimed) => {\n\t\t\t\t\tif (!claimed.first) {\n\t\t\t\t\t\t// those that ran and stand there now: on hold\n\t\t\t\t\t\tconst squad = ai.squads.named(id)\n\t\t\t\t\t\tif (squad?.idle) squad.hold()\n\t\t\t\t\t\treturn\n\t\t\t\t\t}\n\t\t\t\t\tconst squad = claimed.squad(id, claimed.units)\n\t\t\t\t\tconst to = refuge(ai, squad)\n\t\t\t\t\tai.decide(`${id}: ${claimed.units.length} run${to ? ` to ${where(to)}` : ''}`, { kind: 'mission' })\n\t\t\t\t\tif (to) squad.retreat(to, 'told to run')\n\t\t\t\t\telse squad.hold()\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n}\n\n/**\n * When the condition holds, the computer gives up: the engine's `surrender` command, as a player's, once. Out of the\n * game as if beaten\n *\n * @beta\n */\nexport function surrenderWhen(condition: AiCondition, options: { id?: string } = {}): AiModuleDef {\n\tconst id = options.id ?? 'mission.surrender'\n\treturn part(id, 'surrender', (ai, memory) => ({\n\t\tthink: () => {\n\t\t\tif (memory.done || !evaluate(condition, ai)) return\n\t\t\tmemory.done = true\n\t\t\tai.decide(`${id}: gives up`, { kind: 'mission' })\n\t\t\tai.send({ type: 'surrender' })\n\t\t},\n\t\tinspect: () => ({ done: !!memory.done })\n\t}))\n}\n\n/**\n * A computer player for a mission: a brain (`defineBrain`) of what every mission's computer has (its rules, the words\n * every brain may be told, the goals' picker, squads, micro) and the parts it is given (`modules`: `holdPosition`,\n * `patrol`, `guard`, `ambush`, `waveFrom`, `fleeWhen`, `surrenderWhen`, any module of the kit's or of its own). Nothing\n * builds, trains, gathers, scouts or answers raids on its bases unless a module for it is given (`economy()`,\n * `scouting()`, `defence()`). Everything else of `BrainDef` as for any brain (`goals`, `micro`, `without`, `knowledge`)\n *\n * @public\n */\nexport function missionBrain(def: MissionBrainDef): BrainDef {\n\tconst { modules = [], ...rest } = def\n\treturn defineBrain({\n\t\t...rest,\n\t\tmodules: [\n\t\t\t// its own rules first, as the melee brain's: what a rule takes is not given orders by the rest\n\t\t\tdefineModule({ id: 'rules', make: (ai: Brain) => (rules(ai.def.rules ?? []) as (ai: Brain) => AiModule)(ai) }),\n\t\t\twords(),\n\t\t\t...modules,\n\t\t\tgoals(),\n\t\t\tsquads(),\n\t\t\tmicro()\n\t\t]\n\t})\n}\n"],"mappings":"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"}

package/dist/ai/missionRules.d.ts

@@ -3,7 +3,7 @@ import type { GamePack } from '#engine/packs/pack';
 /**
  * Mission rules as data (campaign plan MS1): the rules a map keeps (`MissionRule`, under `GameMap.data.rules`, written
  * in the editor's Rules panel) run as the game plays, `rules` of the game's own code beside them. Each `when` a
- * condition of the computer players' language holds (`docs/ai.md`), asked as a player, `do`es its actions
+ * condition of the computer players' language holds (`docs/ai/scripting.md`), asked as a player, `do`es its actions
  * (`MissionActionData`: an objective of the map's given, done or failed, a line said, a cinematic played, a prefab
  * spawned, a computer told, a relation set, a timer started, win, lose). Checked once a second; what the rules
  * remember is in the world's state, so a save mid-mission has it. The code reaches the rules with `tellRules` and hears