@v12-engine/engine 0.1.1 → 0.4.0

package/dist/ai/squads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"squads.js","names":[],"sources":["../../src/ai/squads.ts"],"sourcesContent":["import type { Layer } from '#engine/defs'\nimport type { OrderInit } from '#engine/registry'\nimport type { AiArea } from './area'\nimport { distSq, type Vec2 } from '#engine/math'\nimport type { EntityState } from '#engine/session/protocol'\nimport { DEFAULT_STANCE, stance, stanceCommand } from '#engine/stances'\nimport { type Brain } from './brain'\nimport { type AiModule, type AiModuleDef, defineModule } from './module'\nimport { UnitSet } from './view'\nimport { ATTACK, CAPTURE, CREEP, DEFEND_TASK, DROP, ESCORT, GATHER, HARASS, HOLD, MOVE, PATROL, RETREAT, SCOUT_TASK, TASKS } from './tasks'\nimport type { TaskCommon, TaskData, TaskDef, TaskDone, TaskOrder, TaskState } from './task'\nimport { capturePointsOf } from './tasks/shared'\nimport { heroOfState } from '#engine/hero'\nimport { pair, plural, point, where } from './geometry'\nimport { ENGAGED, FIGHT_REACH, RESEND } from './reach'\n\n/*\n * Squads and their tasks (AI plan, C1): the unit of command. A goal that holds units (B1) used to send them all one\n * order and hope; two goals could send one unit two ways in a think, and nothing watched an order once it was sent.\n * A **squad** is a named group of the player's units with one **task** (attack there, defend here, gather at the rally\n * and then go): the goal, rule or module that made it says what, once, and the squads module (`squads()`) sees it\n * done, think after think:\n *\n * - **An order is sent once and watched.** A unit told to attack-move every second never arrives: it stops and\n *   starts. A task sends its orders as it begins, then each think looks at how it goes (where the squad is, whether a\n *   unit stands idle short of where it was sent, whether its target is still there) and sends again only what was lost.\n * - **A squad regroups when spread.** Units walk at different speeds: a column of footmen and knights arrives one by\n *   one and is beaten one by one. When too many of its units (`regroupWhen`, four tenths) are further than `spread`\n *   from its middle, on its way and out of a fight, the squad gathers on its middle, then goes on.\n * - **A squad retreats when it is losing.** In a fight away from home, with its odds (`Strength.odds`, A4) under\n *   `retreatAt` (three tenths), it falls back home (the classic Groups Flee): the task becomes `retreat`, done\n *   (`retreated`) once home. Whoever made it decides what next.\n * - **A squad is reinforced** (`reinforce`): what it lost since its task began is made up from the pool (the fighters\n *   nothing holds, idle), the nearest first, sent to join it.\n *\n * **Who may move a unit.** The goals' holds are the one place that says (B1): a unit is held by one goal, rule or\n * module at a time (`ai.goals.holder`), and a squad is made of what its **owner** holds. A squad made in a goal's\n * `run` with `claimed.squad` is the goal's: when the goal stops, its squads go; a unit another goal took leaves the squad\n * that think. A squad made anywhere else (a rule, a module) holds its units itself, until it is disbanded (`take`\n * with `seconds: Infinity`, under `squad:<name>` or the owner it names), taking them from whatever goal had them,\n * which is told (`stop('told')`). A unit is in one squad at a time: a squad made of units of another takes them out\n * of it.\n *\n * Tasks are plain data (`TaskState`: its kind, what it was given, its phase, when it began, its own memory), kept in\n * the brain's memory with the squads, so that a save keeps the army on its way. The kit's tasks (`attack`, `defend`,\n * `hold`, `move`, `escort`, `harass`, `scout`, `gather`, `retreat`, `creep`, `patrol`) send the engine's orders; a game's own is\n * `defineTask` (a capture, a garrison, an order of the game's), run with the same regroup, reinforce and retreat\n * around it unless it says it `handles` them.\n */\n\n/** Seconds a squad waits for its stragglers at most, regrouping, before it goes on with what it has */\nconst REGROUP_FOR = 10\n/** Seconds between two calls for reinforcements */\nconst REINFORCE_EVERY = 5\n/** How far aside of the hottest place on its way a squad that avoids looks for a way round, then half as far again */\nconst DETOUR = 24\n/** Seconds a sighting of their army counts as where it is, for a squad that avoids it */\nconst AVOID_SEEN = 60\n\n/**\n * How a squad behaves around its task (`SquadsOptions`, `ai.squads.make(name, units, options)`): when it regroups,\n * reinforces, retreats. Plain data, kept in a save\n *\n * @beta\n */\nexport interface SquadOptions {\n\t/**\n\t * How far from its middle a unit may be before it counts as strayed: what a regroup brings in. Grows with the squad\n\t * when left out (8, and three times the square root of its size above that: 12 for sixteen units)\n\t */\n\tspread?: number\n\t/** The share of its units strayed (`spread`) at which it stops to regroup, on its way and out of a fight: 0.4. `false` never */\n\tregroupWhen?: number | false\n\t/** Whether it makes up what it lost since its task began from the pool (the idle fighters nothing holds): no when left out */\n\treinforce?: boolean\n\t/**\n\t * Its odds in a fight (`Strength.odds`) under which it falls back home, away from home: 0.3. `false` fights on to the\n\t * last (a mission's guards)\n\t */\n\tretreatAt?: number | false\n\t/** How near home it fights on whatever the odds: there is nowhere to fall back to. 20 when left out */\n\thome?: number\n\t/**\n\t * Whether the micro module (`micro()`, C2) fights for it once it is in a fight: focus fire, kiting, fleeing, siege.\n\t * Yes when left out; `false` for a squad left to its units (a scout, a mission's guards on an order of the game's)\n\t */\n\tmicro?: boolean\n}\n\n/**\n * How a brain's squads behave, where a squad says nothing for itself (`BrainDef.squads`, the seat's `AiOptions.squads`\n * over it); and the tasks of the game's own (`defineTask`) a save of the brain may name\n *\n * @beta\n */\nexport interface SquadsOptions extends SquadOptions {\n\t/** Tasks of the game's own: registered with the brain, so that a squad on one is carried on after a load */\n\ttasks?: TaskDef[]\n}\n\n/**\n * A squad as the brain remembers it: plain data, kept in a save\n *\n * @beta\n */\nexport interface SquadData {\n\t/** Unique among the brain's squads */\n\tname: string\n\t/** Who it belongs to: a goal's id, a rule's or a module's hold (`squad:<name>` for one of its own) */\n\towner: string\n\t/** Its units, by id, in the picture's order */\n\tunits: number[]\n\t/** How it behaves: its own, over the brain's */\n\toptions: SquadOptions\n\t/** What it is doing. None for a squad told nothing yet */\n\ttask?: TaskState\n\t/** How many units its task began with, or was given since: what reinforcements make up */\n\tsize: number\n\t/** The tick it was made at */\n\tmade: number\n\t/** How many times it fell back from a fight it was losing */\n\tretreats: number\n\t/** The last time its units or its task changed, and why, in words */\n\tchanged?: { tick: number; why: string }\n\t/** The tick it may next call for reinforcements */\n\tnextReinforce?: number\n}\n\n/**\n * What the squads remember between thinks, for a save\n *\n * @beta\n */\nexport interface SquadsMemory {\n\t/** The version of the memory's format: 1 so far */\n\tv: 1\n\t/** Each squad's data */\n\tsquads: SquadData[]\n}\n\n/**\n * A squad as the report shows it: who it belongs to, its units and their strength, where it is, its task and how it goes\n *\n * @beta\n */\nexport interface SquadReport {\n\t/** The squad's name, by which it is found (`ai.squads.named`) */\n\tname: string\n\t/** What holds the squad: the module or goal that made it */\n\towner: string\n\t/** The entity ids of its units */\n\tunits: number[]\n\t/** How strong its units are together */\n\tstrength: number\n\t/** Its middle */\n\tat?: [number, number]\n\t/** How many units it has */\n\tsize: number\n\t/** Its task: the kind, the phase it is in, since when, where, and how it ended once done */\n\ttask?: { kind: string; phase: string; since: number; at?: [number, number]; done?: TaskDone }\n\t/** How many times it retreated */\n\tretreats: number\n\t/** The tick its task last changed and why */\n\tchanged?: { tick: number; why: string }\n}\n\n/**\n * A squad of the brain (`ai.squads.make`, `named`, `all`): a handle over its data, with the task methods. A squad's\n * units are as of the think's picture: the dead and those its owner no longer holds are dropped as the squads module\n * looks at it\n *\n * @beta\n */\nexport class Squad {\n\tconstructor(\n\t\t/** The squads it is one of */\n\t\treadonly squads: Squads,\n\t\t/** What it is, as plain data: what a save keeps */\n\t\treadonly data: SquadData\n\t) {}\n\n\t/** Its name: unique among the brain's squads */\n\tget name(): string {\n\t\treturn this.data.name\n\t}\n\n\t/** Who it belongs to: the goal, rule or module that made it */\n\tget owner(): string {\n\t\treturn this.data.owner\n\t}\n\n\t/** What it is doing: none for a squad told nothing yet */\n\tget current(): TaskState | undefined {\n\t\treturn this.data.task\n\t}\n\n\t/** How its task ended: none while it goes on, or while it has none */\n\tget done(): TaskDone | undefined {\n\t\treturn this.data.task?.done\n\t}\n\n\t/** Whether it has nothing to do: no task, or its task is over */\n\tget idle(): boolean {\n\t\treturn !this.data.task || this.data.task.done !== undefined\n\t}\n\n\t/** Whether it is still one of the brain's squads: not once disbanded */\n\tget alive(): boolean {\n\t\treturn this.squads.named(this.data.name) === this\n\t}\n\n\t/** How it behaves: its own options over the brain's */\n\tget options(): SquadOptions {\n\t\treturn this.data.options\n\t}\n\n\t/** Its units, as of the think's picture: those alive and the player's */\n\tunits(): UnitSet {\n\t\tconst { view } = this.squads.ai\n\t\treturn new UnitSet(\n\t\t\tview,\n\t\t\tthis.data.units.map((id) => view.byId(id)).filter((unit): unit is EntityState => !!unit && unit.health > 0)\n\t\t)\n\t}\n\n\t/** How many units it has */\n\tget length(): number {\n\t\treturn this.data.units.length\n\t}\n\n\t/** How strong it is together (`UnitSet.strength`) */\n\tstrength(): number {\n\t\treturn this.units().strength()\n\t}\n\n\t/** Its middle: none with no unit left */\n\tcentre(): Vec2 | undefined {\n\t\treturn this.units().centre()\n\t}\n\n\t/**\n\t * How far from its middle a unit may be before it counts as strayed (`SquadOptions.spread`): grows with the squad\n\t * when not given\n\t */\n\tspread(): number {\n\t\treturn this.data.options.spread ?? Math.max(8, 3 * Math.sqrt(this.data.units.length))\n\t}\n\n\t/** Adds units: what its owner may have (see `Squads.make`), taken out of any other squad */\n\tadd(units: Iterable<EntityState | number>, why = 'given'): this {\n\t\tconst added = this.squads.enlist(this, ids(units))\n\t\tif (added.length) {\n\t\t\tthis.data.size = Math.max(this.data.size, this.data.units.length)\n\t\t\tthis.changed(`${why}: ${plural(added.length)}`)\n\t\t}\n\t\treturn this\n\t}\n\n\t/** Takes units out: they go back to the pool (its owner lets go of them) */\n\tremove(units: Iterable<EntityState | number>, why = 'taken out'): this {\n\t\tconst gone = new Set(ids(units))\n\t\tconst removed = this.data.units.filter((id) => gone.has(id))\n\t\tif (!removed.length) return this\n\t\tthis.data.units = this.data.units.filter((id) => !gone.has(id))\n\t\tthis.squads.ai.goals.drop(this.data.owner, removed)\n\t\tthis.changed(`${why}: ${plural(removed.length)}`)\n\t\treturn this\n\t}\n\n\t/** Disbands it: its units go back to its owner (a goal's), or to the pool (a squad of its own) */\n\tdisband(why = 'disbanded'): void {\n\t\tthis.squads.disband(this, why)\n\t}\n\n\t/** Writes down the last change of its units or task, for the report */\n\tchanged(why: string): void {\n\t\tthis.data.changed = { tick: this.squads.ai.tick, why }\n\t}\n\n\t/**\n\t * Gives it a task: one of the kit's by its word (`attack`), or of the game's (`defineTask`, by its def or its id).\n\t * What it was doing is over. Its first orders go at once; the squads module watches it from then on\n\t */\n\ttask<D extends object, M extends object>(def: TaskDef<D, M>, data: D & TaskCommon): this\n\t/** Gives the squad a task of a game's own, by its definition and data; what it was doing is over and the squad is returned */\n\ttask(kind: string, data?: TaskData): this\n\ttask(kind: string | TaskDef, data: TaskData = {}): this {\n\t\tthis.squads.give(this, kind, data)\n\t\treturn this\n\t}\n\n\t/** Ends its task, saying how: what a task's `think` calls once it is over */\n\tfinish(done: TaskDone): void {\n\t\tconst state = this.data.task\n\t\tif (!state || state.done !== undefined) return\n\t\tstate.done = done\n\t\tstate.doneAt = this.squads.ai.tick\n\t\tstate.phase = 'done'\n\t\tstate.phaseSince = this.squads.ai.tick\n\t}\n\n\t/**\n\t * Goes to fight at a place or a target (an entity, or its id): attack-moves there, fighting what it meets, regroups\n\t * on the way, retreats on the odds. Done `cleared` once there with nothing left to fight, `lost` when the target is\n\t * gone. `avoid: 'army'` goes round where their strength is on the way (the threat map and their army as last seen),\n\t * when there is a way round. `via`: a place to go by on the way (a way of its own: Random Paths). `then`: the task after it\n\t */\n\tattack(target: Vec2 | EntityState | number, options: { avoid?: 'army' | false; via?: Vec2; then?: TaskOrder } = {}): this {\n\t\treturn this.task(ATTACK, { ...targetOf(this.squads.ai, target), ...options })\n\t}\n\n\t/** Attack-moves to a place, as a group of units would on a click: the squad's attack without its regroup */\n\tattackMove(at: Vec2, options: { then?: TaskOrder } = {}): this {\n\t\treturn this.task(ATTACK, { at: point(at), regroup: false, ...options })\n\t}\n\n\t/**\n\t * Holds a place against what comes within `radius` of it (16 when left out): fights what comes, goes back once it is\n\t * gone. Never over by itself: its owner says when\n\t */\n\tdefend(at: Vec2, radius = 16): this {\n\t\treturn this.task(DEFEND_TASK, { at: point(at), radius })\n\t}\n\n\t/** Goes to a place (where it stands when left out) and holds it: stands, fighting only what comes within reach */\n\thold(at?: Vec2): this {\n\t\tconst there = at ?? this.centre()\n\t\treturn this.task(HOLD, there ? { at: point(there) } : {})\n\t}\n\n\t/** Walks to a place, fighting nothing on the way. Done `arrived` */\n\tmove(at: Vec2, options: { then?: TaskOrder } = {}): this {\n\t\treturn this.task(MOVE, { at: point(at), ...options })\n\t}\n\n\t/** Goes with a unit of the player's or an ally's, fighting what comes near it. Done `lost` when it is gone */\n\tescort(target: EntityState | number): this {\n\t\treturn this.task(ESCORT, { target: typeof target === 'number' ? target : target.id })\n\t}\n\n\t/**\n\t * Goes for the workers at a place, round where their army is (`avoid: 'army'` unless told otherwise), the workers\n\t * first once there. Done `cleared`\n\t */\n\tharass(at: Vec2, options: { avoid?: 'army' | false; then?: TaskOrder } = {}): this {\n\t\treturn this.task(HARASS, { at: point(at), avoid: 'army', ...options })\n\t}\n\n\t/** Goes to look at places, one after the other: each is looked at once in sight, or reached as near as the ground lets. Done `arrived` */\n\tscout(points: readonly Vec2[]): this {\n\t\treturn this.task(SCOUT_TASK, { points: points.map(point) })\n\t}\n\n\t/**\n\t * Gathers at a rally point before going on (`then`): until `minForces` of it (a share, 1 when left out) is there,\n\t * or `seconds` have gone by. Done `arrived`, and on to `then`\n\t */\n\tgather(at: Vec2, options: { minForces?: number; seconds?: number; then?: TaskOrder } = {}): this {\n\t\treturn this.task(GATHER, { at: point(at), ...options })\n\t}\n\n\t/** Falls back to a place (home when left out), fighting nothing on the way. Done `retreated` */\n\tretreat(to?: Vec2, why?: string): this {\n\t\tconst home = to ?? this.squads.ai.view.home()\n\t\treturn this.task(RETREAT, { ...(home && { at: point(home) }), ...(why && { why }) })\n\t}\n\n\t/**\n\t * Walks a round of places, one after the other and back to the first, fighting what it meets on the way (an\n\t * attack-move to each): a mission's guards on the road, a watch round the walls. Never over by itself: its owner\n\t * says when\n\t */\n\tpatrol(points: readonly Vec2[]): this {\n\t\treturn this.task(PATROL, { points: points.map(point) })\n\t}\n\n\t/** Takes a camp of creeps: fights there until the camp is cleared. Done `cleared` */\n\tcreep(camp: Vec2): this {\n\t\treturn this.task(CREEP, { at: point(camp) })\n\t}\n\n\t/**\n\t * Carried by transports to a place it cannot walk to, let out on the land nearest it (the `drop` task): done\n\t * `landed`, then what `then` says (an attack where it landed)\n\t */\n\tdrop(at: Vec2, transports: readonly number[], options: { then?: TaskOrder } = {}): this {\n\t\treturn this.task(DROP, { at: point(at), transports: [...transports], ...(options.then && { then: options.then }) })\n\t}\n\n\t/** Sends its units an order (`move`, `hold`, the game's), all or some of them: counted as the task's last */\n\torder(order: OrderInit, units: readonly number[] = this.data.units, queue = false): void {\n\t\tunits = this.living(units)\n\t\tif (!units.length) return\n\t\tthis.squads.ai.send({ type: 'order', entities: [...units], order, ...(queue && { queue: true }) })\n\t\tthis.sent()\n\t}\n\n\t/**\n\t * Puts its units, all or some, in a stance, where the game has stances (`stancesPack`): those not in it already. A\n\t * squad that holds is defensive, one sent to fight aggressive\n\t */\n\tsetStance(id: string, units: readonly number[] = this.data.units): void {\n\t\tif (!this.squads.ai.registry.command('stance')) return\n\t\tconst change: number[] = []\n\t\tfor (const unit of this.units()) {\n\t\t\tif (!units.includes(unit.id)) continue\n\t\t\tconst now = (unit.components?.[stance.id] as string | undefined) ?? DEFAULT_STANCE\n\t\t\tif (now !== id) change.push(unit.id)\n\t\t}\n\t\tif (change.length) this.squads.ai.send(stanceCommand.make({ entities: change, stance: id }))\n\t}\n\n\t/**\n\t * Sends its units to take a capture point of the game's (`capturePack`), by its id: they fight their way in and\n\t * stand in it until it is theirs (`captured`), or it is gone (`lost`)\n\t */\n\tcapture(id: string): this {\n\t\tconst found = capturePointsOf(this.squads.ai).find((each) => each.id === id)\n\t\treturn this.task(CAPTURE, { point: id, ...(found && { at: point({ x: found.x, z: found.z }) }) })\n\t}\n\n\t/** Sends its units, all or some, to fight at a place, or a target there: an attack-move, or an attack */\n\tfight(at: Vec2, units: readonly number[] = this.data.units, target?: number, queue = false): void {\n\t\tunits = this.living(units)\n\t\tif (!units.length) return\n\t\tthis.setStance(DEFAULT_STANCE, units)\n\t\tthis.squads.ai.send({\n\t\t\ttype: 'attack',\n\t\t\tentities: [...units],\n\t\t\tpoint: point(at),\n\t\t\t...(target !== undefined && { target }),\n\t\t\t...(queue && { queue: true })\n\t\t})\n\t\tthis.sent()\n\t}\n\n\t/**\n\t * Of some of its units, those the picture has: a unit that died since the squads were last looked at (a task given by a\n\t * goal before the `squads()` module ran) is no one to order\n\t */\n\tprivate living(units: readonly number[]): readonly number[] {\n\t\tconst { mine } = this.squads.ai.view\n\t\treturn units.every((id) => mine.has(id)) ? units : units.filter((id) => mine.has(id))\n\t}\n\n\t/** Its units that stand with nothing to do: what lost its order, or never had one */\n\tidleUnits(): EntityState[] {\n\t\treturn this.units().filter((unit) => !!unit.own && !unit.own.order && !unit.own.hidden)\n\t}\n\n\t/** Whether its last order was sent long enough ago to send one again (`RESEND` seconds): what keeps a stuck unit from being told every think */\n\tmayResend(): boolean {\n\t\tconst state = this.data.task\n\t\tconst { ai } = this.squads\n\t\treturn !state || state.sent === undefined || ai.tick - state.sent >= RESEND * ai.session.tickRate\n\t}\n\n\tprivate sent(): void {\n\t\tif (this.data.task) this.data.task.sent = this.squads.ai.tick\n\t}\n}\n\n/**\n * Some squads together (`ai.squads.all()`, `idle()`): read as a list, told as one (`ai.squads.all().defend(home)`:\n * each squad is given the task)\n *\n * @beta\n */\nexport class SquadGroup implements Iterable<Squad> {\n\tconstructor(\n\t\t/** The brain they are of */\n\t\treadonly ai: Brain,\n\t\t/** The squads */\n\t\treadonly squads: readonly Squad[]\n\t) {}\n\n\t/** Iterates the squads, so that the set reads as a list */\n\t[Symbol.iterator](): Iterator<Squad> {\n\t\treturn this.squads[Symbol.iterator]()\n\t}\n\n\t/** How many squads */\n\tget length(): number {\n\t\treturn this.squads.length\n\t}\n\n\t/** Their units together, as a set */\n\tunits(): UnitSet {\n\t\tconst { view } = this.ai\n\t\tconst all = this.squads.flatMap((squad) => squad.units().items)\n\t\tall.sort((a, b) => view.indexOf(a) - view.indexOf(b))\n\t\treturn new UnitSet(view, all)\n\t}\n\n\t/** How strong they are together */\n\tstrength(): number {\n\t\treturn this.units().strength()\n\t}\n\n\t/** Each given the same task */\n\ttask<D extends object, M extends object>(def: TaskDef<D, M>, data: D & TaskCommon): this\n\t/** Gives each squad the same task, by its kind and data, and returns the set */\n\ttask(kind: string, data?: TaskData): this\n\ttask(kind: string | TaskDef, data: TaskData = {}): this {\n\t\tfor (const squad of this.squads) squad.squads.give(squad, kind, data)\n\t\treturn this\n\t}\n\n\t/** Tells each squad to attack a point, an entity or an entity id, as `Squad.attack` does, and returns the set */\n\tattack(target: Vec2 | EntityState | number, options: { avoid?: 'army' | false; then?: TaskOrder } = {}): this {\n\t\tfor (const squad of this.squads) squad.attack(target, options)\n\t\treturn this\n\t}\n\n\t/** Tells each squad to defend a place within a radius as `Squad.defend` does; does nothing without a place; returns the set */\n\tdefend(at: Vec2 | undefined, radius?: number): this {\n\t\tif (at) for (const squad of this.squads) squad.defend(at, radius)\n\t\treturn this\n\t}\n\n\t/** Tells each squad to hold at a place, or where it is, as `Squad.hold` does, and returns the set */\n\thold(at?: Vec2): this {\n\t\tfor (const squad of this.squads) squad.hold(at)\n\t\treturn this\n\t}\n\n\t/** Tells each squad to move to a point as `Squad.move` does, and returns the set */\n\tmove(at: Vec2): this {\n\t\tfor (const squad of this.squads) squad.move(at)\n\t\treturn this\n\t}\n\n\t/** Tells each squad to retreat to a point, or home when left out, as `Squad.retreat` does, and returns the set */\n\tretreat(to?: Vec2): this {\n\t\tfor (const squad of this.squads) squad.retreat(to)\n\t\treturn this\n\t}\n\n\t/** Each disbanded */\n\tdisband(why?: string): void {\n\t\tfor (const squad of [...this.squads]) squad.disband(why)\n\t}\n}\n\n/** The ids of units given as entities or ids, each once */\nfunction ids(units: Iterable<EntityState | number>): number[] {\n\tconst result: number[] = []\n\tfor (const unit of units) {\n\t\tconst id = typeof unit === 'number' ? unit : unit.id\n\t\tif (!result.includes(id)) result.push(id)\n\t}\n\treturn result\n}\n\n/** A target as an attack's data: a place, or an entity and where it is */\nfunction targetOf(ai: Brain, target: Vec2 | EntityState | number): { target?: number; at?: Vec2 } {\n\tif (typeof target === 'number') {\n\t\tconst entity = ai.view.byId(target)\n\t\treturn { target, ...(entity && { at: point(entity) }) }\n\t}\n\tif ('id' in target && typeof (target as EntityState).id === 'number') return { target: (target as EntityState).id, at: point(target) }\n\treturn { at: point(target) }\n}\n\n/**\n * A brain's squads (`ai.squads`): made by its goals, rules and modules, watched by the `squads()` module each think\n * (`think`): the dead dropped, what the owner let go of let go of, each task looked at, regroups, retreats and\n * reinforcements seen to. Kept in the brain's memory (`BrainMemory.squads`)\n *\n * @beta\n */\nexport class Squads implements AiArea {\n\t/** Its id among the brain's areas: what its memory and its report are kept under */\n\treadonly id = 'squads'\n\t/** What the log says where a save's memory of it is of a shape it does not read */\n\treadonly afresh = 'the save remembers the computer player’s squads in a shape this brain does not read: they are let go of'\n\n\tprivate list: Squad[] = []\n\tprivate readonly tasks = new Map<string, TaskDef>()\n\tprivate thoughtAt = -1\n\t/** How a squad behaves where it says nothing and the brain's settings say nothing either: the `squads()` module's */\n\tprivate moduleOptions: SquadOptions = {}\n\n\tconstructor(\n\t\t/** The brain they are the squads of */\n\t\treadonly ai: Brain,\n\t\t/** The tasks of the game's own its squads may be on (`AiSettings.squads.tasks`) */\n\t\ttasks: readonly TaskDef[] = []\n\t) {\n\t\tfor (const def of TASKS) this.tasks.set(def.id, def)\n\t\tfor (const def of tasks) this.define(def)\n\t}\n\n\t/** Puts the `squads()` module's options under the brain's settings */\n\tconfigure(options: SquadOptions): void {\n\t\tthis.moduleOptions = options\n\t}\n\n\t/** How a squad behaves where it says nothing: the module's options, the brain's settings over them (`ai.settings.squads`) */\n\tget defaults(): SquadOptions {\n\t\tconst { tasks: _tasks, ...settings } = this.ai.settings.squads ?? {}\n\t\treturn { ...this.moduleOptions, ...settings }\n\t}\n\n\t/** Registers a task of the game's own, so that a squad on it is carried on after a load. Given by `BrainDef.squads.tasks` */\n\tdefine(def: TaskDef): void {\n\t\tconst known = this.tasks.get(def.id)\n\t\tif (known && known !== def && TASKS.includes(known))\n\t\t\tthrow new Error(`\"${def.id}\" is a task of the kit's: a task of the game's needs a name of its own`)\n\t\tthis.tasks.set(def.id, def)\n\t}\n\n\t/** A kind of task by its id: the kit's, or one registered */\n\ttaskDef(id: string): TaskDef | undefined {\n\t\treturn this.tasks.get(id)\n\t}\n\n\t/**\n\t * Makes a squad of units under a name (one of that name already is disbanded first), with how it behaves where it\n\t * is not the brain's way. Whose it is (`owner`): what `options.owner` names (a goal makes its own with\n\t * `claimed.squad`), else its own (`squad:<name>`). A goal's squad is made of what the goal holds, and what\n\t * nothing holds is given to it; a squad of a rule or a module takes its units from whatever holds them (the goal\n\t * told: `stop('told')`) and holds them until it is disbanded. A unit in another squad leaves it\n\t */\n\tmake(name: string, units: Iterable<EntityState | number>, options: SquadOptions & { owner?: string } = {}): Squad {\n\t\tif (!name) throw new Error('A squad needs a name')\n\t\tconst { ai } = this\n\t\tconst { owner: named, ...own } = options\n\t\tconst owner = named ?? `squad:${name}`\n\t\tconst old = this.named(name)\n\t\tif (old) this.disband(old, 'made anew', old.owner !== owner)\n\t\t// the brain's settings (Groups Flee, the odds it falls back at), the squad's own over them\n\t\tconst behaves = { ...this.defaults, ...own }\n\t\tconst squad = new Squad(this, { name, owner, units: [], options: behaves, size: 0, made: ai.tick, retreats: 0 })\n\t\tthis.list.push(squad)\n\t\tthis.enlist(squad, ids(units))\n\t\tsquad.data.size = squad.data.units.length\n\t\tsquad.changed(`made by ${owner === `squad:${name}` ? 'itself' : owner}: ${plural(squad.data.units.length)}`)\n\t\treturn squad\n\t}\n\n\t/**\n\t * Puts units in a squad: those its owner may have (held by it, or given from the pool for a goal; taken for a rule's\n\t * or a module's), out of any other squad. Those put in, by id\n\t */\n\tenlist(squad: Squad, wanted: number[]): number[] {\n\t\tconst { goals, view, session, tick } = this.ai\n\t\tconst owner = squad.data.owner\n\t\tconst units = wanted.filter((id) => view.mine.has(id) && !squad.data.units.includes(id))\n\t\tif (!units.length) return []\n\t\tlet put: number[]\n\t\tif (goals.get(owner)) {\n\t\t\t// a goal's: what it holds, and what nothing holds given to it; what another holds is not its to have\n\t\t\tgoals.give(owner, units)\n\t\t\tput = units.filter((id) => goals.holder(id) === owner)\n\t\t} else {\n\t\t\t// a rule's, a module's, its own: taken from whoever holds them, for as long as the hold it is under lasts\n\t\t\tconst hold = goals.held(owner)\n\t\t\tconst seconds = !hold || hold.kept ? Infinity : Math.max(1, (hold.until - tick) / session.tickRate)\n\t\t\tgoals.take(units, 'told', { id: owner, seconds })\n\t\t\tput = units.filter((id) => goals.held(owner)?.units.includes(id))\n\t\t}\n\t\tif (!put.length) return put\n\t\t// in one squad at a time\n\t\tfor (const other of [...this.list]) {\n\t\t\tif (other === squad || !other.data.units.some((id) => put.includes(id))) continue\n\t\t\tother.data.units = other.data.units.filter((id) => !put.includes(id))\n\t\t\tother.changed(`${plural(put.length)} went to ${squad.name}`)\n\t\t\tif (!other.data.units.length) this.disband(other, `its units went to ${squad.name}`)\n\t\t}\n\t\t// what died since the squads module last looked is dropped as the new come in: the order is the picture's\n\t\tsquad.data.units = squad.data.units.filter((id) => view.mine.has(id))\n\t\tsquad.data.units.push(...put)\n\t\tsquad.data.units.sort((a, b) => view.indexOf(view.byId(a)!) - view.indexOf(view.byId(b)!))\n\t\treturn put\n\t}\n\n\t/** A squad by name: none for one there is not */\n\tnamed(name: string): Squad | undefined {\n\t\treturn this.list.find((squad) => squad.data.name === name)\n\t}\n\n\t/** Every squad, as made */\n\tall(): SquadGroup {\n\t\treturn new SquadGroup(this.ai, this.list)\n\t}\n\n\t/** The squads with nothing to do: told nothing, or their task over */\n\tidle(): SquadGroup {\n\t\treturn new SquadGroup(\n\t\t\tthis.ai,\n\t\t\tthis.list.filter((squad) => squad.idle)\n\t\t)\n\t}\n\n\t/** The squads a goal, rule or module owns */\n\tof(owner: string): SquadGroup {\n\t\treturn new SquadGroup(\n\t\t\tthis.ai,\n\t\t\tthis.list.filter((squad) => squad.data.owner === owner)\n\t\t)\n\t}\n\n\t/** The squad a unit is in, by the unit or its id: none for a unit in none */\n\tsquadOf(unit: EntityState | number): Squad | undefined {\n\t\tconst id = typeof unit === 'number' ? unit : unit.id\n\t\treturn this.list.find((squad) => squad.data.units.includes(id))\n\t}\n\n\t/** The player's units nothing holds (`ai.goals.pool`, buildings left out): what a squad is made of, or reinforced from */\n\tpool(): UnitSet {\n\t\treturn this.ai.goals.pool().units()\n\t}\n\n\t/** Disbands a squad: a squad that held its units itself lets them go back to the pool */\n\tdisband(squad: Squad, why = 'disbanded', letGo = true): void {\n\t\tconst index = this.list.indexOf(squad)\n\t\tif (index < 0) return\n\t\tthis.list.splice(index, 1)\n\t\tconst { goals } = this.ai\n\t\tif (letGo && !goals.get(squad.data.owner) && goals.held(squad.data.owner)) {\n\t\t\t// what it held is let go of; a hold it shares with other squads of its owner keeps theirs\n\t\t\tconst others = new Set(this.list.filter((other) => other.data.owner === squad.data.owner).flatMap((other) => other.data.units))\n\t\t\tgoals.drop(\n\t\t\t\tsquad.data.owner,\n\t\t\t\tsquad.data.units.filter((id) => !others.has(id))\n\t\t\t)\n\t\t}\n\t\tif (squad.data.units.length || why !== 'made anew') this.ai.decide(`squad ${squad.name} disbanded: ${why}`, { kind: 'squad' })\n\t}\n\n\t/**\n\t * Gives a squad a task: what it was doing is over, and the new one's first orders go at once. What it has now is what\n\t * reinforcements make up to from then on (`SquadData.size`), but for a task it goes on to by itself (`going on`: a\n\t * task's `then`, a fall back on the odds), which keeps what the task before was given. The task it is on given\n\t * again changes nothing, its `size` kept: what it lost since is what reinforcements make up\n\t */\n\tgive(squad: Squad, kind: string | TaskDef, data: TaskData, goingOn = false): void {\n\t\tconst { ai } = this\n\t\tconst def = typeof kind === 'string' ? this.tasks.get(kind) : kind\n\t\tif (!def)\n\t\t\tthrow new Error(\n\t\t\t\t`The squad \"${squad.name}\" was given a task \"${String(kind)}\" the brain does not know: list it in its squads' tasks (defineTask)`\n\t\t\t)\n\t\tif (typeof kind !== 'string' && !this.tasks.has(def.id)) this.define(def)\n\t\tconst before = squad.data.task\n\t\t// the task it is on already, given again (a goal's run each think): it goes on as it is, and nothing is sent again\n\t\tif (before && before.done === undefined && before.kind === def.id && sameData(before.data, data)) return\n\t\tconst state: TaskState = { kind: def.id, data: { ...data }, since: ai.tick, phase: 'starting', phaseSince: ai.tick, memory: {} }\n\t\tsquad.data.task = state\n\t\tif (!goingOn) squad.data.size = squad.data.units.length\n\t\tsquad.changed(before && before.done === undefined ? `${before.kind} → ${def.id}` : `on to ${def.id}`)\n\t\tif (squad.data.units.length) def.start(ai, squad, state)\n\t}\n\n\t/**\n\t * Looks at every squad, once a think: its units (the dead, and what its owner let go of, dropped; a squad of a goal\n\t * that stopped disbanded), then its task (retreat on the odds, the task's own look, regroup, reinforcements). What the\n\t * `squads()` module runs; a module may call it sooner\n\t */\n\tthink(): void {\n\t\tconst { ai } = this\n\t\tif (this.thoughtAt !== ai.tick) {\n\t\t\tthis.thoughtAt = ai.tick\n\t\t\tthis.prune()\n\t\t\tthis.advancing = [...this.list]\n\t\t\tthis.cursor = 0\n\t\t} else if (!this.advancing) return\n\t\t// each squad looked at in turn, as many as the tick's budget has room for (F2, `ai.budget`): a think sliced over\n\t\t// ticks goes on from the next squad at the next tick, over the same picture\n\t\tconst squads = this.advancing\n\t\tfor (; this.cursor < squads.length; this.cursor++) {\n\t\t\tconst squad = squads[this.cursor]\n\t\t\tthis.advance(squad)\n\t\t\tif (!ai.budget.spent(squad.data.units.length || 1) && this.cursor + 1 < squads.length) {\n\t\t\t\tthis.cursor++\n\t\t\t\treturn ai.budget.later()\n\t\t\t}\n\t\t}\n\t\tthis.advancing = undefined\n\t}\n\n\t/** The squads still to be looked at this think, where a pass stopped for the tick's budget, and the next of them */\n\tprivate advancing: Squad[] | undefined\n\tprivate cursor = 0\n\n\t/** Every squad's units looked at, as a think begins: the dead and what its owner let go of dropped, a squad with none left disbanded */\n\tprivate prune(): void {\n\t\tconst { ai } = this\n\t\tconst { goals, view } = ai\n\t\tfor (const squad of [...this.list]) {\n\t\t\tconst hold = goals.held(squad.data.owner)\n\t\t\tif (!hold) {\n\t\t\t\tthis.disband(squad, `${squad.data.owner} let go`, false)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\t// what a rule's or a module's hold has that is gone is let go of: with no goals in the brain, nothing else does\n\t\t\tif (!goals.get(squad.data.owner) && hold.units.some((id) => !view.mine.has(id))) hold.units = hold.units.filter((id) => view.mine.has(id))\n\t\t\tconst kept = squad.data.units.filter((id) => hold.units.includes(id) && view.mine.has(id) && view.byId(id)!.health > 0)\n\t\t\tif (kept.length !== squad.data.units.length) squad.data.units = kept\n\t\t\tif (!kept.length) {\n\t\t\t\tsquad.finish('wiped')\n\t\t\t\tthis.disband(squad, 'none of its units left', false)\n\t\t\t}\n\t\t}\n\t}\n\n\t/** One squad's think: retreat on the odds, the task's own look, then on to the next task, regroup, reinforcements */\n\tprivate advance(squad: Squad): void {\n\t\tconst { ai } = this\n\t\tconst state = squad.data.task\n\t\tconst def = state && this.tasks.get(state.kind)\n\t\tconst handles = def?.handles ?? []\n\t\tif (state && def && state.done === undefined) {\n\t\t\tif (!handles.includes('retreat') && this.losing(squad)) return\n\t\t\tconst over = def.done?.(ai, squad, state)\n\t\t\tif (over) squad.finish(over)\n\t\t\telse def.think(ai, squad, state)\n\t\t\tif (state.done === undefined && !handles.includes('regroup') && state.data.regroup !== false) this.regroup(squad, state, def)\n\t\t\tconst then = state.data.then as TaskOrder | undefined\n\t\t\tif (state.done !== undefined && state.done !== 'lost' && state.done !== 'wiped' && then?.kind && this.tasks.has(then.kind)) {\n\t\t\t\tthis.give(squad, then.kind, then.data ?? {}, true)\n\t\t\t}\n\t\t}\n\t\tif (squad.data.options.reinforce && !handles.includes('reinforce')) this.reinforce(squad)\n\t}\n\n\t/**\n\t * Whether a squad in a fight away from home is losing it (its odds under `retreatAt`), and so falls back: its task\n\t * becomes `retreat`, home, and it is said why\n\t */\n\tprivate losing(squad: Squad): boolean {\n\t\tconst { ai } = this\n\t\tconst { view } = ai\n\t\tconst at = squad.data.options.retreatAt ?? 0.3\n\t\tif (at === false || !(at > 0)) return false\n\t\tconst units = squad.units()\n\t\tconst middle = units.centre()\n\t\tconst home = view.home()\n\t\tif (!middle || !home) return false\n\t\tconst safe = squad.data.options.home ?? 20\n\t\tif (distSq(middle, home) < safe * safe) return false\n\t\tconst foes = view.hostile.units().alive().near(middle, FIGHT_REACH)\n\t\tif (!foes.length || !foes.some((foe) => units.some((unit) => distSq(unit, foe) <= ENGAGED * ENGAGED))) return false\n\t\tconst odds = view.strength.odds(units.near(middle, FIGHT_REACH), foes)\n\t\tif (odds >= at) return false\n\t\tconst was = squad.data.task?.kind ?? 'nothing'\n\t\tsquad.data.retreats++\n\t\tthis.give(squad, 'retreat', { at: point(home), why: 'odds' }, true)\n\t\tai.decide(`squad ${squad.name} falls back home with ${plural(units.length)}: ${was} lost (odds ${odds.toFixed(2)} under ${at})`, {\n\t\t\tkind: 'squad'\n\t\t})\n\t\treturn true\n\t}\n\n\t/**\n\t * Regroups a squad that is strung out on its way: too many of its units (`regroupWhen`) further than `spread` from its\n\t * middle, and no fight near. It gathers on its middle and goes on once together, or once it has waited long enough\n\t */\n\tprivate regroup(squad: Squad, state: TaskState, def: TaskDef): void {\n\t\tconst { ai } = this\n\t\tconst units = squad.units()\n\t\tif (units.length < 3) return\n\t\tconst middle = units.centre()!\n\t\tconst spread = squad.spread()\n\t\tif (state.phase === 'regrouping') {\n\t\t\tconst together = units.every((unit) => distSq(unit, middle) <= spread * spread * 0.36)\n\t\t\tif (together || ai.tick - state.phaseSince >= REGROUP_FOR * ai.session.tickRate) {\n\t\t\t\t// on its way again: the task sends what it sends as it begins\n\t\t\t\tdef.start(ai, squad, state)\n\t\t\t\tai.decide(`squad ${squad.name} regrouped${together ? '' : ' as much as it waits for'}: on with ${state.kind}`, { kind: 'squad' })\n\t\t\t}\n\t\t\treturn\n\t\t}\n\t\tif (state.phase !== 'going') return\n\t\tconst when = squad.data.options.regroupWhen ?? 0.4\n\t\tif (when === false) return\n\t\tconst strayed = units.filter((unit) => distSq(unit, middle) > spread * spread).length\n\t\tif (strayed <= units.length * when) return\n\t\tif (ai.view.hostile.alive().near(middle, FIGHT_REACH).length) return\n\t\tstate.phase = 'regrouping'\n\t\tstate.phaseSince = ai.tick\n\t\tsquad.order({ type: 'move', point: point(middle) })\n\t\tai.decide(`squad ${squad.name} regroups at ${where(middle)}: ${strayed} of ${units.length} strung out`, { kind: 'squad' })\n\t}\n\n\t/**\n\t * Makes up what a squad lost since its task began from the pool: the idle fighters nothing holds, the nearest\n\t * first, given to its owner and sent to join it. Never a hero: one crossing the map alone to a fight dies on the\n\t * way, and heroes are sent with a squad, not after it. Not while it falls back, nor more often than every few seconds\n\t */\n\tprivate reinforce(squad: Squad): void {\n\t\tconst { ai } = this\n\t\tconst { data } = squad\n\t\tconst missing = data.size - data.units.length\n\t\tif (missing <= 0 || (data.task?.kind === 'retreat' && data.task.done === undefined)) return\n\t\tif (data.nextReinforce !== undefined && ai.tick < data.nextReinforce) return\n\t\tdata.nextReinforce = ai.tick + REINFORCE_EVERY * ai.session.tickRate\n\t\tconst join = squad.centre() ?? this.whereOf(squad) ?? ai.view.home()\n\t\tif (!join) return\n\t\t// not a hero (sent with a squad, never after it), nor the wounded (one walking alone into the fight it fled dies there)\n\t\tconst { strength } = ai.view\n\t\tconst free = [...this.pool().fighters().idle()]\n\t\t\t.filter((unit) => !heroOfState(unit) && unit.health >= WOUNDED * (unit.maxHealth ?? strength.statsOf(unit).health))\n\t\t\t.sort((a, b) => distSq(a, join) - distSq(b, join) || a.id - b.id)\n\t\tconst chosen = free.slice(0, missing).map((unit) => unit.id)\n\t\tif (!chosen.length) return\n\t\tconst size = data.size\n\t\tsquad.add(chosen, 'reinforced')\n\t\tdata.size = size\n\t\tconst added = chosen.filter((id) => data.units.includes(id))\n\t\tif (!added.length) return\n\t\t// to where it is, fighting what they meet on the way\n\t\tai.send({ type: 'attack', entities: added, point: point(join) })\n\t\tai.decide(`squad ${squad.name} reinforced with ${plural(added.length)}`, { kind: 'squad' })\n\t}\n\n\t/** The place a squad's task is about: none for a task about no place */\n\twhereOf(squad: Squad): Vec2 | undefined {\n\t\tconst state = squad.data.task\n\t\tconst def = state && this.tasks.get(state.kind)\n\t\treturn state && def?.where?.(this.ai, squad, state)\n\t}\n\n\t/**\n\t * The way to a place round where the enemy is strong (`avoid: 'army'`): the waypoint to go by, where the straight way\n\t * crosses their strength (the threat map, with what is remembered of their towers, and their army as last seen) and a\n\t * way round is less hot, tried on either side and then further out, twice at most. A heuristic, not a safe route:\n\t * none where the straight way is cool enough, or where there is no way round (`note` says so)\n\t */\n\troute(from: Vec2, to: Vec2, squad: Squad): { waypoints: Vec2[]; note?: string } {\n\t\tconst { ai } = this\n\t\tconst { view } = ai\n\t\tconst units = squad.units()\n\t\tconst flying = units.length > 0 && units.every((unit) => !!view.def(unit).flying)\n\t\tconst layer: Layer = flying ? 'air' : 'ground'\n\t\tconst seen = ai.def.knowledge === false ? [] : ai.knowledge.enemy.armySeen(AVOID_SEEN)\n\t\tconst danger = (at: Vec2) => {\n\t\t\tlet enemy = view.threat.at(at, { layer, remembered: true }).enemy\n\t\t\tfor (const army of seen) if (distSq(army.at, at) < 12 * 12) enemy += army.strength\n\t\t\treturn enemy\n\t\t}\n\t\t// the hottest place along a way, looked at every few units of it\n\t\tconst hottest = (path: readonly Vec2[]) => {\n\t\t\tlet worst = { at: path[0] ?? from, enemy: 0 }\n\t\t\tfor (let i = 1; i < path.length; i++) {\n\t\t\t\tconst a = path[i - 1]\n\t\t\t\tconst b = path[i]\n\t\t\t\tconst steps = Math.max(1, Math.ceil(Math.sqrt(distSq(a, b)) / 6))\n\t\t\t\tfor (let s = 1; s <= steps; s++) {\n\t\t\t\t\tconst at = { x: a.x + ((b.x - a.x) * s) / steps, z: a.z + ((b.z - a.z) * s) / steps }\n\t\t\t\t\tconst enemy = danger(at)\n\t\t\t\t\tif (enemy > worst.enemy) worst = { at, enemy }\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn worst\n\t\t}\n\t\tconst straight = view.findPath(from, to, flying) ?? [from, to]\n\t\tconst worst = hottest([from, ...straight])\n\t\t// what the squad would rather not walk into: half its own strength\n\t\tconst bearable = Math.max(1e-9, units.strength() * 0.5)\n\t\tif (worst.enemy <= bearable) return { waypoints: [] }\n\t\tconst { width, depth } = view.session.terrain\n\t\tconst dx = to.x - from.x\n\t\tconst dz = to.z - from.z\n\t\tconst length = Math.sqrt(dx * dx + dz * dz) || 1\n\t\tconst aside = { x: -dz / length, z: dx / length }\n\t\tlet best: { at: Vec2; enemy: number } | undefined\n\t\tfor (let attempt = 0; attempt < 2; attempt++) {\n\t\t\tconst far = DETOUR * (1 + attempt / 2)\n\t\t\tfor (const side of [1, -1]) {\n\t\t\t\tconst at = {\n\t\t\t\t\tx: Math.min(width - 1, Math.max(1, worst.at.x + aside.x * far * side)),\n\t\t\t\t\tz: Math.min(depth - 1, Math.max(1, worst.at.z + aside.z * far * side))\n\t\t\t\t}\n\t\t\t\tconst there = view.findPath(from, at, flying)\n\t\t\t\tconst on = there && view.findPath(at, to, flying)\n\t\t\t\tif (!there || !on) continue\n\t\t\t\tconst enemy = Math.max(hottest([from, ...there]).enemy, hottest([at, ...on]).enemy)\n\t\t\t\tif (!best || enemy < best.enemy) best = { at, enemy }\n\t\t\t}\n\t\t\tif (best && best.enemy <= bearable) return { waypoints: [point(best.at)], note: `round ${where(worst.at)} by ${where(best.at)}` }\n\t\t}\n\t\tif (best && best.enemy < worst.enemy)\n\t\t\treturn { waypoints: [point(best.at)], note: `no way round ${where(worst.at)} that is safe: by ${where(best.at)}, the least hot` }\n\t\treturn { waypoints: [], note: `no way round ${where(worst.at)}: straight` }\n\t}\n\n\t/** Every squad as the report shows it */\n\treport(): SquadReport[] {\n\t\treturn this.list.map((squad) => {\n\t\t\tconst { data } = squad\n\t\t\tconst units = squad.units()\n\t\t\tconst middle = units.centre()\n\t\t\tconst state = data.task\n\t\t\tconst at = this.whereOf(squad)\n\t\t\treturn {\n\t\t\t\tname: data.name,\n\t\t\t\towner: data.owner,\n\t\t\t\tunits: [...data.units],\n\t\t\t\tstrength: units.strength(),\n\t\t\t\t...(middle && { at: pair(middle) }),\n\t\t\t\tsize: data.size,\n\t\t\t\t...(state && {\n\t\t\t\t\ttask: {\n\t\t\t\t\t\tkind: state.kind,\n\t\t\t\t\t\tphase: state.phase,\n\t\t\t\t\t\tsince: state.since,\n\t\t\t\t\t\t...(at && { at: pair(at) }),\n\t\t\t\t\t\t...(state.done !== undefined && { done: state.done })\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t\tretreats: data.retreats,\n\t\t\t\t...(data.changed && { changed: { ...data.changed } })\n\t\t\t}\n\t\t})\n\t}\n\n\t/** What the squads are, for a save: copies */\n\t/** Whether it has anything to remember now: one that does not is left out of a save */\n\tremembers(): boolean {\n\t\treturn this.all().length > 0\n\t}\n\n\t/** Gives the squads' data as plain data for a save of the brain */\n\tsave(): SquadsMemory {\n\t\treturn { v: 1, squads: this.list.map((squad) => structuredClone(squad.data)) }\n\t}\n\n\t/** Takes back what `save` gave: whether it was read. A squad on a task the brain does not know is kept, and does nothing */\n\trestore(memory: unknown): boolean {\n\t\tconst given = memory as SquadsMemory | undefined\n\t\tif (!given || typeof given !== 'object' || given.v !== 1 || !Array.isArray(given.squads)) return false\n\t\tthis.list = given.squads\n\t\t\t.filter((data) => data && typeof data.name === 'string' && Array.isArray(data.units))\n\t\t\t.map((data) => new Squad(this, structuredClone(data)))\n\t\tfor (const squad of this.list) {\n\t\t\tconst kind = squad.data.task?.kind\n\t\t\tif (kind && !this.tasks.has(kind))\n\t\t\t\tthis.ai.log.info('ai', `the squad \"${squad.name}\" is on a task \"${kind}\" this brain does not know: it waits`, { squad: squad.name })\n\t\t}\n\t\treturn true\n\t}\n}\n\n/** The share of its health under which a unit is not sent as a reinforcement */\nconst WOUNDED = 0.5\n\n/** Whether two tasks' data say the same: plain data, field by field */\nfunction sameData(a: unknown, b: unknown): boolean {\n\tif (a === b) return true\n\tif (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false\n\tif (Array.isArray(a) !== Array.isArray(b)) return false\n\tconst keys = Object.keys(a).filter((key) => (a as Record<string, unknown>)[key] !== undefined)\n\tconst others = Object.keys(b).filter((key) => (b as Record<string, unknown>)[key] !== undefined)\n\treturn keys.length === others.length && keys.every((key) => sameData((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]))\n}\n\n/**\n * The squads module: looks at every squad of the brain each think (`ai.squads.think`), after the goals, the rules and\n * the words that make them: their units, their tasks, regroups, retreats, reinforcements. With how they behave where the\n * brain's definition and the seat's options say nothing\n *\n * @beta\n */\nexport const squads = (options: SquadsOptions = {}): AiModuleDef =>\n\tdefineModule({ id: 'squads', make: (ai: Brain): AiModule => {\n\t\tfor (const def of options.tasks ?? []) ai.squads.define(def)\n\t\tconst { tasks: _tasks, ...defaults } = options\n\t\tai.squads.configure(defaults)\n\t\treturn {\n\t\t\tid: 'squads',\n\t\t\tphase: 'act',\n\t\t\tafter: ['goals'],\n\t\t\tthink: () => ai.squads.think()\n\t\t}\n\t} })\n\ndeclare module './area' {\n\tinterface AreaMemories {\n\t\tsquads?: SquadsMemory\n\t}\n}\n"],"mappings":"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"}

package/dist/ai/strength.js

@@ -0,0 +1,320 @@
+import { baseStats } from "../defs.js";
+import { heroOfState } from "../hero.js";
+import { attackStat, farthestReach } from "../attacks.js";
+//#region src/ai/strength.ts
+/** How much a hero is worth over its numbers at level 1, and what each level adds: the spells and the items it brings */
+var HERO = 1.1;
+var HERO_LEVEL = .1;
+/** How far reach counts, and how much: a unit that shoots this far deals a quarter more, for the first hits are its */
+var REACH = 10;
+var REACH_WORTH = .25;
+/** The same for speed: it picks its fights and leaves them */
+var SPEED = 8;
+var SPEED_WORTH = .1;
+/** What a declared counter is worth when its weight is left out */
+var COUNTER_WEIGHT = .5;
+/**
+* The kit's formula for how strong a unit is, under a square root so that it adds up over a group (Lanchester):
+*
+* `sqrt(toughness × offence) × hero`, where
+*
+* - `toughness` is the health it has left, more by its armour and magic resist (the middle of the two, since no
+*   opponent is in question: 100 of armour doubles it, as the engine's `mitigation` halves what arrives),
+* - `offence` is its damage a second (`attackDamage × attackSpeed`), up to a quarter more for reach (at 10 of range)
+*   and a tenth for speed (at 8),
+* - `hero` is 1 for a unit, and `1.1 + 0.1 × (level − 1)` for a hero: its spells, and more as they level.
+*
+* 0 for what has no attack: a building that does not shoot, a worker with no weapon. A declared strength
+* (`UnitTypeDef.ai.strength`) is taken in its place by `Strength`, before this is asked
+*
+* @beta
+*/
+var defaultStrength = ({ def, stats, entity, health }) => {
+	if (!def.attacks?.length) return 0;
+	let dps = 0;
+	for (const attack of def.attacks) dps = Math.max(dps, attackStat(stats, attack, "damage") * attackStat(stats, attack, "speed"));
+	if (dps <= 0 || stats.health <= 0) return 0;
+	const resist = Math.max(0, (stats.armor + stats.magicResist) / 2);
+	const toughness = stats.health * health * (1 + resist / 100);
+	const offence = dps * reachFactor(def, stats);
+	let strength = Math.sqrt(toughness * offence);
+	if (def.hero) strength *= HERO + HERO_LEVEL * (((entity && heroOfState(entity)?.level) ?? def.level ?? 1) - 1);
+	return strength;
+};
+/** What reach (of its farthest attack) and speed add to what a unit deals: the first hits, the fights it picks */
+var reachFactor = (def, stats) => (1 + Math.min(farthestReach(def, stats), REACH) / REACH * REACH_WORTH) * (1 + Math.min(stats.moveSpeed, SPEED) / SPEED * SPEED_WORTH);
+var KINDS = [
+	"unit",
+	"building",
+	"resource"
+];
+/** The first of an attacker's attacks that reaches something where it is and of its kind: the engine's `reaches` and `defaultPickAttack`, over profiles */
+function hits(attacker, target) {
+	for (const weapon of attacker.weapons) {
+		if (target.layer === "air" ? !weapon.hitsAir : !weapon.hitsGround) continue;
+		if (!weapon.kinds || weapon.kinds.includes(target.kind)) return weapon;
+	}
+}
+/**
+* How strong things are, to a brain (`AiView.strength`, `Brain.strength`): one unit or type (`of`), a group (`sum`,
+* what `UnitSet.strength()` asks), one force against another (`matchup`, `odds`), and what to train against what was
+* seen (`counterFor`). The formula is the kit's (`defaultStrength`) unless the brain was given one
+* (`AiOptions.strength`, `BrainDef.strength`); a type's declared strength (`UnitTypeDef.ai.strength`) goes before
+* either. What a type's numbers come to is worked out once and kept across thinks; a seen unit's own stats
+* (`EntityState.stats`: its upgrades, items, levels, buffs) are read each time
+*
+* @beta
+*/
+var Strength = class {
+	registry;
+	formula;
+	profiles = /* @__PURE__ */ new Map();
+	plainByType = /* @__PURE__ */ new Map();
+	constructor(registry, formula = defaultStrength) {
+		this.registry = registry;
+		this.formula = formula;
+	}
+	/** @internal The view the questions are asked through: set by the view that holds this, each think */
+	view;
+	/**
+	* How strong a unit is, with the health it has left and its own stats as the snapshot shows them; or a type at full
+	* health with the stats it starts with. 0 for what does not fight. A finite number always
+	*/
+	of(what) {
+		if (typeof what === "string") return this.ofType(this.registry.unit(what));
+		if ("id" in what && typeof what.id === "string") return this.ofType(what);
+		const entity = what;
+		const def = this.registry.unit(entity.type);
+		if (!def.attacks?.length) return 0;
+		const stats = this.statsOf(entity, def);
+		return this.evaluate(def, stats, entity, healthOf(entity, stats));
+	}
+	/** A type at full health: worked out once */
+	ofType(def) {
+		let found = this.plainByType.get(def.id);
+		if (found === void 0) this.plainByType.set(def.id, found = this.evaluate(def, baseStats(def, this.registry), void 0, 1));
+		return found;
+	}
+	/** The formula asked, the declared strength first; whatever comes back made finite */
+	evaluate(def, stats, entity, health) {
+		const declared = def.ai?.strength;
+		const strength = declared !== void 0 ? declared * Math.sqrt(health) : this.formula({
+			def,
+			stats,
+			entity,
+			health,
+			view: this.view
+		});
+		return Number.isFinite(strength) && strength > 0 ? strength : 0;
+	}
+	/** The stats of a seen unit as they stand: its type's, with its own over them (`EntityState.stats`: upgrades, items, levels, buffs) */
+	statsOf(entity, def = this.registry.unit(entity.type)) {
+		const base = baseStats(def, this.registry);
+		return entity.stats ? {
+			...base,
+			...entity.stats
+		} : base;
+	}
+	/** How strong a group is: the strength of each, summed */
+	sum(force) {
+		let total = 0;
+		if (isCounts(force)) {
+			for (const type in force) if (this.registry.units.has(type)) total += this.of(type) * force[type];
+			return total;
+		}
+		for (const entity of force) total += this.of(entity);
+		return total;
+	}
+	/**
+	* One force against another: the strength of each of `a`'s units against `b` (what it cannot hit counts for nothing
+	* of its damage; its damage meets their armour, theirs meets its; what it is declared to counter weighs it up),
+	* summed. `matchup(a, b).strength / matchup(b, a).strength` is how `a` compares; `odds` turns it into a chance
+	*/
+	matchup(a, b) {
+		const mine = this.groups(a);
+		const theirs = this.groups(b);
+		let strength = 0;
+		let plain = 0;
+		let count = 0;
+		for (const group of mine) {
+			count += group.count;
+			plain += group.strength;
+			if (group.strength > 0) strength += group.strength * this.edge(group.profile, theirs);
+		}
+		return {
+			strength,
+			plain,
+			count
+		};
+	}
+	/**
+	* The chance that `a` beats `b` in a fight to the end, 0..1: `A² / (A² + B²)` of the two matchups (Lanchester's
+	* square law: numbers count twice, since each unit both deals and takes). 0.5 for a mirror, and when neither can hit
+	* the other. **An estimate**: it reads stats, layers, armour and declared counters, and knows nothing of spells,
+	* terrain, focus fire, who shoots first or who runs; the plan's E3 checks it against fights played out, and a game
+	* that knows better gives its own formula (`AiOptions.strength`)
+	*/
+	odds(a, b) {
+		const mine = this.matchup(a, b).strength;
+		const theirs = this.matchup(b, a).strength;
+		const total = mine * mine + theirs * theirs;
+		return total > 0 ? mine * mine / total : .5;
+	}
+	/**
+	* What answers a force best among some types: each with its strength against them over its plain strength (1 is as
+	* good as against anyone, 0 cannot hit them, above 1 is the answer), the best first, equals in the order given.
+	* Against nothing, every type scores 1
+	*/
+	counterFor(enemies, candidates) {
+		const theirs = this.groups(enemies);
+		return candidates.map((candidate) => {
+			const def = typeof candidate === "string" ? this.registry.unit(candidate) : candidate;
+			const profile = this.profile(def);
+			return {
+				def,
+				score: this.ofType(def) > 0 ? theirs.length ? this.edge(profile, theirs) : 1 : 0
+			};
+		}).sort((x, y) => y.score - x.score);
+	}
+	/** What a game declares a type good against, as `{ target, weight }` each */
+	countersOf(type) {
+		return this.profile(typeof type === "string" ? this.registry.unit(type) : type).counters;
+	}
+	/**
+	* A profile's strength against a force over its plain strength: what its damage comes to against them (what it can
+	* hit, through their armour) and what theirs comes to against it (through its armour), each as a part of the
+	* plain, under the same square root, times what it is declared to counter. 1 against nothing
+	*/
+	edge(profile, theirs) {
+		if (!theirs.length) return 1;
+		const { settings: rules } = this.registry;
+		let health = 0;
+		let hittable = 0;
+		let countered = 0;
+		let dps = 0;
+		let through = 0;
+		for (const group of theirs) {
+			const other = group.profile;
+			const weight = other.stats.health * group.health;
+			health += weight;
+			const mine = hits(profile, other);
+			if (mine) {
+				hittable += weight * rules.combat.mitigation(mine.damageType, other.stats, profile.stats);
+				for (const counter of profile.counters) if (this.matches(counter.target, other)) countered += weight * counter.weight;
+			}
+			const theirs = hits(other, profile);
+			if (theirs && theirs.dps > 0) {
+				const theirDps = theirs.dps * group.count;
+				dps += theirDps;
+				through += theirDps * rules.combat.mitigation(theirs.damageType, profile.stats, other.stats);
+			}
+		}
+		if (!health) return 1;
+		const plainResist = Math.max(0, (profile.stats.armor + profile.stats.magicResist) / 2);
+		const offence = hittable / health;
+		const toughness = dps > 0 ? 1 / (through / dps) / (1 + plainResist / 100) : 1;
+		return Math.sqrt(offence * toughness) * (1 + countered / health);
+	}
+	/** Whether a declared counter's word is one of a profile's: its type, a role or a tag of it */
+	matches(target, profile) {
+		const { roles } = this.view;
+		return profile.def.id === target || roles.has(profile.def.id, target) || roles.hasTag(profile.def.id, target);
+	}
+	/** What a type comes to for a matchup, kept */
+	profile(def, stats) {
+		const own = stats !== void 0;
+		if (!own) {
+			const found = this.profiles.get(def.id);
+			if (found) return found;
+		}
+		const read = stats ?? baseStats(def, this.registry);
+		const profile = {
+			def,
+			stats: read,
+			layer: def.flying ? "air" : "ground",
+			kind: def.kind,
+			weapons: (def.attacks ?? []).map((attack) => {
+				const { targets } = attack;
+				const kinds = targets?.filter((entry) => KINDS.includes(entry));
+				return {
+					hitsGround: !targets || targets.some((entry) => entry !== "air"),
+					hitsAir: !!targets?.includes("air"),
+					kinds: kinds?.length ? kinds : void 0,
+					damageType: attack.damageType ?? "physical",
+					dps: attackStat(read, attack, "damage") * attackStat(read, attack, "speed")
+				};
+			}),
+			counters: (def.ai?.counters ?? []).map((hint) => typeof hint === "string" ? {
+				target: hint,
+				weight: COUNTER_WEIGHT
+			} : {
+				target: hint.target,
+				weight: hint.weight ?? COUNTER_WEIGHT
+			})
+		};
+		if (!own) this.profiles.set(def.id, profile);
+		return profile;
+	}
+	/** A force as groups: a profile and how many, those with health left and an attack. Units with stats of their own stand apart */
+	groups(force) {
+		const groups = [];
+		if (isCounts(force)) {
+			for (const type in force) {
+				const count = force[type];
+				if (!(count > 0) || !this.registry.units.has(type)) continue;
+				const def = this.registry.unit(type);
+				if (def.attacks?.length) groups.push({
+					profile: this.profile(def),
+					count,
+					health: count,
+					strength: this.ofType(def) * count
+				});
+			}
+			return groups;
+		}
+		const byType = /* @__PURE__ */ new Map();
+		for (const entity of force) {
+			if (entity.health <= 0) continue;
+			const def = this.registry.unit(entity.type);
+			if (!def.attacks?.length) continue;
+			if (entity.stats) {
+				const stats = this.statsOf(entity, def);
+				const health = healthOf(entity, stats);
+				groups.push({
+					profile: this.profile(def, stats),
+					count: 1,
+					health,
+					strength: this.evaluate(def, stats, entity, health)
+				});
+				continue;
+			}
+			let group = byType.get(def.id);
+			if (!group) {
+				byType.set(def.id, group = {
+					profile: this.profile(def),
+					count: 0,
+					health: 0,
+					strength: 0
+				});
+				groups.push(group);
+			}
+			const health = healthOf(entity, group.profile.stats);
+			group.count++;
+			group.health += health;
+			group.strength += this.evaluate(def, group.profile.stats, entity, health);
+		}
+		return groups;
+	}
+};
+/** Whether a force is given as types with counts */
+var isCounts = (force) => !(Symbol.iterator in force);
+/** The health a seen unit has left, as a part of its most: 1 for one at full health or whose most is not known */
+function healthOf(entity, stats) {
+	const most = entity.maxHealth ?? stats.health;
+	if (!(most > 0)) return 1;
+	return Math.max(0, Math.min(1, entity.health / most));
+}
+//#endregion
+export { Strength, defaultStrength };
+
+//# sourceMappingURL=strength.js.map

package/dist/ai/strength.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strength.js","names":[],"sources":["../../src/ai/strength.ts"],"sourcesContent":["import { baseStats, type DamageType, type EntityKind, type Layer, type Stats, type UnitTypeDef } from '#engine/defs'\nimport type { Registry } from '#engine/registry'\nimport type { EntityState } from '#engine/session/protocol'\nimport type { AiView, UnitSet } from './view'\nimport { heroOfState } from '#engine/hero'\nimport { attackStat, farthestReach } from '#engine/attacks'\n\n/*\n * How strong things are, to a computer player (AI plan, A4). A brain asks three questions of a fight: how strong is this\n * unit, how strong is this group, and who would win. The old melee player answered the first two with health alone and\n * the third with three ifs; this file answers them from the definitions, one documented formula a game can replace.\n *\n * The idea, in plain words. A unit's **strength** is how much it can take times how much it deals, under a square root\n * so that the number adds up: two footmen are twice one. That is Lanchester's square law in a form a brain can sum: when\n * two groups of linear strength A and B fight to the end, the odds of A are A² / (A² + B²), and the mirror is 0.5. What\n * a unit can take is its health, more of it where its armour turns damage away (the engine's `mitigation`); what it\n * deals is its damage a second, a little more where it reaches farther and moves faster (it picks fights and leaves\n * them). A hero is worth more than its numbers for the spells it brings, and more as it levels. Nothing here is of\n * one game: the numbers are the engine's stats as the definitions give them, with what the snapshot shows of a seen\n * unit's own (its upgrades, items, levels and buffs are in `EntityState.stats`), scaled by the health it has left.\n *\n * A **matchup** reads the same numbers against an opponent: what a unit cannot hit (footmen under gryphons) counts for\n * nothing of its damage; what its damage meets is the opponent's armour or magic resist, by the engine's own formula;\n * what hits it is the opponent's mix of damage, against its own armour; and what a game declares a type good against\n * (`UnitTypeDef.ai.counters`) weighs it up. `odds(a, b)` turns two matchups into a chance of winning, an **estimate**\n * said so in its doc: it knows nothing of spells, terrain, focus fire or who shoots first (E3 checks it against fights\n * played out; a game that knows better replaces the formula with `AiOptions.strength`, or declares a type's strength\n * with `UnitTypeDef.ai.strength`). `counterFor` ranks what to train against what was seen, by the same arithmetic\n */\n\n/**\n * A force to weigh: a set of entities as the view gives them (`view.enemies.fighters()`), a plain array of them, or\n * types with counts (`{ footman: 6, gryphon: 2 }`), as the knowledge keeps an army it saw (`ArmySighting.types`,\n * `TypeSeen`): those are taken at full health with the stats their type starts with\n *\n * @beta\n */\nexport type Force = UnitSet | readonly EntityState[] | Readonly<Record<string, number>>\n\n/**\n * What a strength formula is given of one unit or type: its definition, its stats as they stand (the type's, with what\n * the snapshot shows of a seen unit's own: upgrades, items, levels, buffs), the entity where there is one (its health,\n * its level) and the view, for the roles and the registry\n *\n * @beta\n */\nexport interface StrengthInput {\n\t/** The unit type */\n\tdef: UnitTypeDef\n\t/** The stats as they stand: the type's, with a seen unit's own over them */\n\tstats: Readonly<Stats>\n\t/** The unit, where one is weighed; none for a type */\n\tentity?: EntityState\n\t/** 0..1: the health it has left, as a part of its most; 1 for a type */\n\thealth: number\n\t/** The picture it is weighed in: for the roles (`view.roles`) and the definitions (`view.registry`) */\n\tview: AiView\n}\n\n/**\n * How strong a unit or a type is, as a number that adds up over a group: the kit's formula (`defaultStrength`), or a\n * game's own in its place (`AiOptions.strength`, `BrainDef.strength`). Given the unit's definition and stats as they\n * stand, the entity where there is one, and the health it has left as a part of its most. Must give a finite number,\n * 0 for what does not fight\n *\n * @beta\n */\nexport type StrengthFormula = (input: StrengthInput) => number\n\n/**\n * What one side of a matchup is worth against the other, with how (`Strength.matchup`): the strength of each of its\n * units against the opponent, summed\n *\n * @beta\n */\nexport interface Matchup {\n\t/** The side's strength against the opponent: 0 where none of it can hit any of them */\n\tstrength: number\n\t/** The side's strength on its own, against no one in particular */\n\tplain: number\n\t/** How many fought: units with health left and an attack */\n\tcount: number\n}\n\n/**\n * How well a type answers a force (`Strength.counterFor`): its strength against them over its plain strength. 1 is as\n * good as it is against anyone, 0 is useless (it cannot hit them), above 1 it is the answer\n *\n * @beta\n */\nexport interface Counter {\n\t/** The type ranked */\n\tdef: UnitTypeDef\n\t/** Its strength against the force over its plain strength */\n\tscore: number\n}\n\n/**\n * What a game declares a type good against (`UnitTypeDef.ai.counters`): a tag (`'air'`), a role (`'siege'`) or a type\n * id, as a word, or with how much it counts (`weight`, 0.5 when left out: a unit whose whole opponent it counters is\n * worth half again)\n *\n * @beta\n */\nexport type CounterHint = string | { target: string; weight?: number }\n\n/** How much a hero is worth over its numbers at level 1, and what each level adds: the spells and the items it brings */\nconst HERO = 1.1\nconst HERO_LEVEL = 0.1\n/** How far reach counts, and how much: a unit that shoots this far deals a quarter more, for the first hits are its */\nconst REACH = 10\nconst REACH_WORTH = 0.25\n/** The same for speed: it picks its fights and leaves them */\nconst SPEED = 8\nconst SPEED_WORTH = 0.1\n/** What a declared counter is worth when its weight is left out */\nconst COUNTER_WEIGHT = 0.5\n\n/**\n * The kit's formula for how strong a unit is, under a square root so that it adds up over a group (Lanchester):\n *\n * `sqrt(toughness × offence) × hero`, where\n *\n * - `toughness` is the health it has left, more by its armour and magic resist (the middle of the two, since no\n *   opponent is in question: 100 of armour doubles it, as the engine's `mitigation` halves what arrives),\n * - `offence` is its damage a second (`attackDamage × attackSpeed`), up to a quarter more for reach (at 10 of range)\n *   and a tenth for speed (at 8),\n * - `hero` is 1 for a unit, and `1.1 + 0.1 × (level − 1)` for a hero: its spells, and more as they level.\n *\n * 0 for what has no attack: a building that does not shoot, a worker with no weapon. A declared strength\n * (`UnitTypeDef.ai.strength`) is taken in its place by `Strength`, before this is asked\n *\n * @beta\n */\nexport const defaultStrength: StrengthFormula = ({ def, stats, entity, health }) => {\n\tif (!def.attacks?.length) return 0\n\t// of its attacks, the one that deals the most\n\tlet dps = 0\n\tfor (const attack of def.attacks) dps = Math.max(dps, attackStat(stats, attack, 'damage') * attackStat(stats, attack, 'speed'))\n\tif (dps <= 0 || stats.health <= 0) return 0\n\tconst resist = Math.max(0, (stats.armor + stats.magicResist) / 2)\n\tconst toughness = stats.health * health * (1 + resist / 100)\n\tconst offence = dps * reachFactor(def, stats)\n\tlet strength = Math.sqrt(toughness * offence)\n\tif (def.hero) strength *= HERO + HERO_LEVEL * (((entity && heroOfState(entity)?.level) ?? def.level ?? 1) - 1)\n\treturn strength\n}\n\n/** What reach (of its farthest attack) and speed add to what a unit deals: the first hits, the fights it picks */\nconst reachFactor = (def: UnitTypeDef, stats: Readonly<Stats>): number =>\n\t(1 + (Math.min(farthestReach(def, stats), REACH) / REACH) * REACH_WORTH) * (1 + (Math.min(stats.moveSpeed, SPEED) / SPEED) * SPEED_WORTH)\n\nconst KINDS: readonly EntityKind[] = ['unit', 'building', 'resource']\n\n/** What of a type a matchup reads, worked out once a type and kept (`Strength`): where it is, what it hits, how */\ninterface Profile {\n\tdef: UnitTypeDef\n\tstats: Readonly<Stats>\n\tlayer: Layer\n\tkind: EntityKind\n\t/** Its attacks, in the order of its type's: none for what does not fight */\n\tweapons: readonly Weapon[]\n\t/** What the game declares it good against, by target word */\n\tcounters: readonly { target: string; weight: number }[]\n}\n\n/** One of a profile's attacks, for a matchup */\ninterface Weapon {\n\t/** Whether it reaches the ground, the air */\n\thitsGround: boolean\n\thitsAir: boolean\n\t/** The kinds it names, where it names any: a worker that hits units and buildings, not trees */\n\tkinds: readonly EntityKind[] | undefined\n\tdamageType: DamageType\n\t/** Damage a second */\n\tdps: number\n}\n\n/** One group of a force: a profile, how many of it, their health left as a part of their most, summed, and their strength */\ninterface Group {\n\tprofile: Profile\n\tcount: number\n\t/** Σ health left, 0..1 each: what the group can take, as a part of `count` */\n\thealth: number\n\t/** Σ strength by the formula: with the health each has left and its own stats */\n\tstrength: number\n}\n\n/** The first of an attacker's attacks that reaches something where it is and of its kind: the engine's `reaches` and `defaultPickAttack`, over profiles */\nfunction hits(attacker: Profile, target: Profile): Weapon | undefined {\n\tfor (const weapon of attacker.weapons) {\n\t\tif (target.layer === 'air' ? !weapon.hitsAir : !weapon.hitsGround) continue\n\t\tif (!weapon.kinds || weapon.kinds.includes(target.kind)) return weapon\n\t}\n\treturn undefined\n}\n\n/**\n * How strong things are, to a brain (`AiView.strength`, `Brain.strength`): one unit or type (`of`), a group (`sum`,\n * what `UnitSet.strength()` asks), one force against another (`matchup`, `odds`), and what to train against what was\n * seen (`counterFor`). The formula is the kit's (`defaultStrength`) unless the brain was given one\n * (`AiOptions.strength`, `BrainDef.strength`); a type's declared strength (`UnitTypeDef.ai.strength`) goes before\n * either. What a type's numbers come to is worked out once and kept across thinks; a seen unit's own stats\n * (`EntityState.stats`: its upgrades, items, levels, buffs) are read each time\n *\n * @beta\n */\nexport class Strength {\n\tprivate readonly profiles = new Map<string, Profile>()\n\tprivate readonly plainByType = new Map<string, number>()\n\n\tconstructor(\n\t\t/** The game's definitions */\n\t\treadonly registry: Registry,\n\t\t/** The formula a unit's strength comes from: the kit's unless the brain was given one */\n\t\treadonly formula: StrengthFormula = defaultStrength\n\t) {}\n\n\t/** @internal The view the questions are asked through: set by the view that holds this, each think */\n\tview!: AiView\n\n\t/**\n\t * How strong a unit is, with the health it has left and its own stats as the snapshot shows them; or a type at full\n\t * health with the stats it starts with. 0 for what does not fight. A finite number always\n\t */\n\tof(what: EntityState | UnitTypeDef | string): number {\n\t\tif (typeof what === 'string') return this.ofType(this.registry.unit(what))\n\t\tif ('id' in what && typeof what.id === 'string') return this.ofType(what as UnitTypeDef)\n\t\tconst entity = what as EntityState\n\t\tconst def = this.registry.unit(entity.type)\n\t\tif (!def.attacks?.length) return 0\n\t\tconst stats = this.statsOf(entity, def)\n\t\treturn this.evaluate(def, stats, entity, healthOf(entity, stats))\n\t}\n\n\t/** A type at full health: worked out once */\n\tprivate ofType(def: UnitTypeDef): number {\n\t\tlet found = this.plainByType.get(def.id)\n\t\tif (found === undefined) this.plainByType.set(def.id, (found = this.evaluate(def, baseStats(def, this.registry), undefined, 1)))\n\t\treturn found\n\t}\n\n\t/** The formula asked, the declared strength first; whatever comes back made finite */\n\tprivate evaluate(def: UnitTypeDef, stats: Readonly<Stats>, entity: EntityState | undefined, health: number): number {\n\t\tconst declared = def.ai?.strength\n\t\tconst strength = declared !== undefined ? declared * Math.sqrt(health) : this.formula({ def, stats, entity, health, view: this.view })\n\t\treturn Number.isFinite(strength) && strength > 0 ? strength : 0\n\t}\n\n\t/** The stats of a seen unit as they stand: its type's, with its own over them (`EntityState.stats`: upgrades, items, levels, buffs) */\n\tstatsOf(entity: EntityState, def = this.registry.unit(entity.type)): Readonly<Stats> {\n\t\tconst base = baseStats(def, this.registry)\n\t\treturn entity.stats ? ({ ...base, ...entity.stats } as Stats) : base\n\t}\n\n\t/** How strong a group is: the strength of each, summed */\n\tsum(force: Force): number {\n\t\tlet total = 0\n\t\tif (isCounts(force)) {\n\t\t\tfor (const type in force) if (this.registry.units.has(type)) total += this.of(type) * force[type]\n\t\t\treturn total\n\t\t}\n\t\tfor (const entity of force) total += this.of(entity)\n\t\treturn total\n\t}\n\n\t/**\n\t * One force against another: the strength of each of `a`'s units against `b` (what it cannot hit counts for nothing\n\t * of its damage; its damage meets their armour, theirs meets its; what it is declared to counter weighs it up),\n\t * summed. `matchup(a, b).strength / matchup(b, a).strength` is how `a` compares; `odds` turns it into a chance\n\t */\n\tmatchup(a: Force, b: Force): Matchup {\n\t\tconst mine = this.groups(a)\n\t\tconst theirs = this.groups(b)\n\t\tlet strength = 0\n\t\tlet plain = 0\n\t\tlet count = 0\n\t\tfor (const group of mine) {\n\t\t\tcount += group.count\n\t\t\tplain += group.strength\n\t\t\tif (group.strength > 0) strength += group.strength * this.edge(group.profile, theirs)\n\t\t}\n\t\treturn { strength, plain, count }\n\t}\n\n\t/**\n\t * The chance that `a` beats `b` in a fight to the end, 0..1: `A² / (A² + B²)` of the two matchups (Lanchester's\n\t * square law: numbers count twice, since each unit both deals and takes). 0.5 for a mirror, and when neither can hit\n\t * the other. **An estimate**: it reads stats, layers, armour and declared counters, and knows nothing of spells,\n\t * terrain, focus fire, who shoots first or who runs; the plan's E3 checks it against fights played out, and a game\n\t * that knows better gives its own formula (`AiOptions.strength`)\n\t */\n\todds(a: Force, b: Force): number {\n\t\tconst mine = this.matchup(a, b).strength\n\t\tconst theirs = this.matchup(b, a).strength\n\t\tconst total = mine * mine + theirs * theirs\n\t\treturn total > 0 ? (mine * mine) / total : 0.5\n\t}\n\n\t/**\n\t * What answers a force best among some types: each with its strength against them over its plain strength (1 is as\n\t * good as against anyone, 0 cannot hit them, above 1 is the answer), the best first, equals in the order given.\n\t * Against nothing, every type scores 1\n\t */\n\tcounterFor(enemies: Force, candidates: readonly (UnitTypeDef | string)[]): Counter[] {\n\t\tconst theirs = this.groups(enemies)\n\t\tconst ranked = candidates.map((candidate) => {\n\t\t\tconst def = typeof candidate === 'string' ? this.registry.unit(candidate) : candidate\n\t\t\tconst profile = this.profile(def)\n\t\t\tconst score = this.ofType(def) > 0 ? (theirs.length ? this.edge(profile, theirs) : 1) : 0\n\t\t\treturn { def, score }\n\t\t})\n\t\treturn ranked.sort((x, y) => y.score - x.score)\n\t}\n\n\t/** What a game declares a type good against, as `{ target, weight }` each */\n\tcountersOf(type: UnitTypeDef | string): readonly { target: string; weight: number }[] {\n\t\treturn this.profile(typeof type === 'string' ? this.registry.unit(type) : type).counters\n\t}\n\n\t/**\n\t * A profile's strength against a force over its plain strength: what its damage comes to against them (what it can\n\t * hit, through their armour) and what theirs comes to against it (through its armour), each as a part of the\n\t * plain, under the same square root, times what it is declared to counter. 1 against nothing\n\t */\n\tprivate edge(profile: Profile, theirs: readonly Group[]): number {\n\t\tif (!theirs.length) return 1\n\t\tconst { settings: rules } = this.registry\n\t\t// what its damage meets: the share of them it can hit, each through their armour, weighted by the health to chew\n\t\tlet health = 0\n\t\tlet hittable = 0\n\t\tlet countered = 0\n\t\t// what hits it: their damage, each through its armour, as a part of all their damage\n\t\tlet dps = 0\n\t\tlet through = 0\n\t\tfor (const group of theirs) {\n\t\t\tconst other = group.profile\n\t\t\tconst weight = other.stats.health * group.health\n\t\t\thealth += weight\n\t\t\tconst mine = hits(profile, other)\n\t\t\tif (mine) {\n\t\t\t\thittable += weight * rules.combat.mitigation(mine.damageType, other.stats, profile.stats)\n\t\t\t\tfor (const counter of profile.counters) if (this.matches(counter.target, other)) countered += weight * counter.weight\n\t\t\t}\n\t\t\tconst theirs = hits(other, profile)\n\t\t\tif (theirs && theirs.dps > 0) {\n\t\t\t\tconst theirDps = theirs.dps * group.count\n\t\t\t\tdps += theirDps\n\t\t\t\tthrough += theirDps * rules.combat.mitigation(theirs.damageType, profile.stats, other.stats)\n\t\t\t}\n\t\t}\n\t\tif (!health) return 1\n\t\t// its damage against them, as a part of the plain (the plain met the middle of armour and magic resist)\n\t\tconst plainResist = Math.max(0, (profile.stats.armor + profile.stats.magicResist) / 2)\n\t\tconst offence = hittable / health\n\t\t// what it can take against them, as a part of the plain: what they get through, against the middle it was read at\n\t\tconst toughness = dps > 0 ? 1 / (through / dps) / (1 + plainResist / 100) : 1\n\t\treturn Math.sqrt(offence * toughness) * (1 + countered / health)\n\t}\n\n\t/** Whether a declared counter's word is one of a profile's: its type, a role or a tag of it */\n\tprivate matches(target: string, profile: Profile): boolean {\n\t\tconst { roles } = this.view\n\t\treturn profile.def.id === target || roles.has(profile.def.id, target) || roles.hasTag(profile.def.id, target)\n\t}\n\n\t/** What a type comes to for a matchup, kept */\n\tprivate profile(def: UnitTypeDef, stats?: Readonly<Stats>): Profile {\n\t\tconst own = stats !== undefined\n\t\tif (!own) {\n\t\t\tconst found = this.profiles.get(def.id)\n\t\t\tif (found) return found\n\t\t}\n\t\tconst read = stats ?? baseStats(def, this.registry)\n\t\tconst profile: Profile = {\n\t\t\tdef,\n\t\t\tstats: read,\n\t\t\tlayer: def.flying ? 'air' : 'ground',\n\t\t\tkind: def.kind,\n\t\t\tweapons: (def.attacks ?? []).map((attack) => {\n\t\t\t\tconst { targets } = attack\n\t\t\t\tconst kinds = targets?.filter((entry): entry is EntityKind => KINDS.includes(entry as EntityKind))\n\t\t\t\treturn {\n\t\t\t\t\thitsGround: !targets || targets.some((entry) => entry !== 'air'),\n\t\t\t\t\thitsAir: !!targets?.includes('air'),\n\t\t\t\t\tkinds: kinds?.length ? kinds : undefined,\n\t\t\t\t\tdamageType: attack.damageType ?? 'physical',\n\t\t\t\t\tdps: attackStat(read, attack, 'damage') * attackStat(read, attack, 'speed')\n\t\t\t\t}\n\t\t\t}),\n\t\t\tcounters: (def.ai?.counters ?? []).map((hint) =>\n\t\t\t\ttypeof hint === 'string' ? { target: hint, weight: COUNTER_WEIGHT } : { target: hint.target, weight: hint.weight ?? COUNTER_WEIGHT }\n\t\t\t)\n\t\t}\n\t\tif (!own) this.profiles.set(def.id, profile)\n\t\treturn profile\n\t}\n\n\t/** A force as groups: a profile and how many, those with health left and an attack. Units with stats of their own stand apart */\n\tprivate groups(force: Force): Group[] {\n\t\tconst groups: Group[] = []\n\t\tif (isCounts(force)) {\n\t\t\tfor (const type in force) {\n\t\t\t\tconst count = force[type]\n\t\t\t\tif (!(count > 0) || !this.registry.units.has(type)) continue\n\t\t\t\tconst def = this.registry.unit(type)\n\t\t\t\tif (def.attacks?.length) groups.push({ profile: this.profile(def), count, health: count, strength: this.ofType(def) * count })\n\t\t\t}\n\t\t\treturn groups\n\t\t}\n\t\tconst byType = new Map<string, Group>()\n\t\tfor (const entity of force) {\n\t\t\tif (entity.health <= 0) continue\n\t\t\tconst def = this.registry.unit(entity.type)\n\t\t\tif (!def.attacks?.length) continue\n\t\t\tif (entity.stats) {\n\t\t\t\tconst stats = this.statsOf(entity, def)\n\t\t\t\tconst health = healthOf(entity, stats)\n\t\t\t\tgroups.push({ profile: this.profile(def, stats), count: 1, health, strength: this.evaluate(def, stats, entity, health) })\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tlet group = byType.get(def.id)\n\t\t\tif (!group) {\n\t\t\t\tbyType.set(def.id, (group = { profile: this.profile(def), count: 0, health: 0, strength: 0 }))\n\t\t\t\tgroups.push(group)\n\t\t\t}\n\t\t\tconst health = healthOf(entity, group.profile.stats)\n\t\t\tgroup.count++\n\t\t\tgroup.health += health\n\t\t\tgroup.strength += this.evaluate(def, group.profile.stats, entity, health)\n\t\t}\n\t\treturn groups\n\t}\n}\n\n/** Whether a force is given as types with counts */\nconst isCounts = (force: Force): force is Readonly<Record<string, number>> => !(Symbol.iterator in force)\n\n/** The health a seen unit has left, as a part of its most: 1 for one at full health or whose most is not known */\nfunction healthOf(entity: EntityState, stats: Readonly<Stats>): number {\n\tconst most = entity.maxHealth ?? stats.health\n\tif (!(most > 0)) return 1\n\treturn Math.max(0, Math.min(1, entity.health / most))\n}\n"],"mappings":"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"}

package/dist/ai/task.d.ts

@@ -20,7 +20,9 @@ export type TaskDone = 'arrived' | 'cleared' | 'lost' | 'retreated' | 'wiped' |
  * @beta
  */
 export interface TaskOrder {
+    /** The kind of task: one of the kit's by its word or the id of a game's (`defineTask`) */
     kind: string;
+    /** What the task is given, beside its kind */
     data?: TaskData;
 }
 /**
@@ -115,4 +117,4 @@ export interface TaskDef<D extends object = TaskData, M extends object = TaskMem
  *
  * @beta
  */
-export declare function defineTask<D extends object = TaskData, M extends object = TaskMemory>(id: string, def: Omit<TaskDef<D, M>, 'id'>): TaskDef<D, M>;
+export declare function defineTask<D extends object = TaskData, M extends object = TaskMemory>(def: TaskDef<D, M>): TaskDef<D, M>;

package/dist/ai/task.js

@@ -0,0 +1,17 @@
+//#region src/ai/task.ts
+/**
+* Defines a task: a kind of thing a squad can be told to do (`squad.task(def, data)`, its data typed by the task), the
+* kit's and a game's own. List a game's in the brain's `settings.squads.tasks`, so that a squad on it goes on after a
+* load
+*
+* @beta
+*/
+function defineTask(def) {
+	if (!def.id) throw new Error("A task needs an id");
+	if (typeof def.start !== "function" || typeof def.think !== "function") throw new Error(`The task "${def.id}" needs a start and a think`);
+	return def;
+}
+//#endregion
+export { defineTask };
+
+//# sourceMappingURL=task.js.map

package/dist/ai/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","names":[],"sources":["../../src/ai/task.ts"],"sourcesContent":["/**\n * A kind of task a squad is on (design review B10): its definition (`TaskDef`, `defineTask`), typed by what it is given\n * (`TaskData`) and what it remembers (`TaskMemory`), and its state as the brain keeps it (`TaskState`). Apart from the\n * squads (`squads.ts`), so that the kit's tasks (`tasks/`) and a game's define theirs without loading the squads\n */\nimport type { Vec2 } from '#engine/math'\nimport type { Brain } from './brain'\nimport type { Squad } from './squads'\n\n/**\n * How a task ended (`TaskState.done`): `arrived` where it was sent, `cleared` with nothing left to fight where it went,\n * `lost` its target (gone from sight: killed, or out of it), `retreated` home after a fight it was losing, `wiped`\n * with none of its units left; or a game's own word\n *\n * @beta\n */\nexport type TaskDone = 'arrived' | 'cleared' | 'lost' | 'retreated' | 'wiped' | (string & {})\n\n/**\n * A task to give next (`then`): its kind (the kit's `attack`, a game's `defineTask` id) and what it is given\n *\n * @beta\n */\nexport interface TaskOrder {\n\t/** The kind of task: one of the kit's by its word or the id of a game's (`defineTask`) */\n\tkind: string\n\t/** What the task is given, beside its kind */\n\tdata?: TaskData\n}\n\n/**\n * What any task may be given beside its own (`TaskState.data`): the task after it (`then`), and `regroup: false` for one\n * not stopped for its stragglers\n *\n * @beta\n */\nexport type TaskCommon = {\n\tthen?: TaskOrder\n\tregroup?: boolean\n}\n\n/**\n * What a task is given, as plain data (`TaskState.data`): each task says its own shape (`defineTask<Data>`)\n *\n * @beta\n */\nexport type TaskData = Record<string, unknown>\n\n/**\n * What a task remembers of its own, as plain data (`TaskState.memory`): each task says its own shape\n * (`defineTask<Data, Memory>`)\n *\n * @beta\n */\nexport type TaskMemory = Record<string, unknown>\n\n/**\n * What a squad is doing, as plain data kept in the brain's memory: the kind of task, what it was given, where it is in\n * it (`phase`: `going`, `regrouping`, `fighting`, `gathering`, `holding`, the task's own words), since when, the last\n * order it sent, and how it ended\n *\n * @beta\n */\nexport interface TaskState<D extends object = TaskData, M extends object = TaskMemory> {\n\t/** The kind of task: the kit's (`attack`) or a game's (`defineTask`) */\n\tkind: string\n\t/** What it was given: a point (`at`), a target, a radius, what to do next (`then`). Plain data, of the task's shape */\n\tdata: D & TaskCommon\n\t/** The tick it began at */\n\tsince: number\n\t/** Where it is in it, in a word */\n\tphase: string\n\t/** The tick its phase began at */\n\tphaseSince: number\n\t/** The tick it last sent an order */\n\tsent?: number\n\t/** How it ended: none while it goes on */\n\tdone?: TaskDone\n\t/** The tick it ended at */\n\tdoneAt?: number\n\t/** What the task remembers of its own, plain data of the task's shape: the point of a scout's round it is at */\n\tmemory: M\n}\n\n/**\n * A kind of task (`defineTask`): what it sends as it begins (`start`), what it looks at each think (`think`), and the\n * place it is about (`where`, for the squads module's regroup and reinforcements and for the report). The squads\n * module runs it with its own regroup, reinforce and retreat around it, but for what it `handles` itself\n *\n * @beta\n */\nexport interface TaskDef<D extends object = TaskData, M extends object = TaskMemory> {\n\t/** Unique among the brain's tasks: what a save names it by. The kit's are words (`attack`); a game's prefixed (`ctf.capture`) */\n\tid: string\n\t/**\n\t * Sends what puts the squad on its way: called as the task is given, and again as the squad goes on after a regroup.\n\t * Sets `state.phase`\n\t */\n\tstart(ai: Brain, squad: Squad, state: TaskState<D, M>): void\n\t/** Each think, after the squads module looked at the squad: watches how it goes, sends what was lost, `squad.finish(done)` when it is over */\n\tthink(ai: Brain, squad: Squad, state: TaskState<D, M>): void\n\t/** Whether it is over, asked each think before `think`: how it ended, or nothing while it goes on */\n\tdone?(ai: Brain, squad: Squad, state: TaskState<D, M>): TaskDone | undefined | false\n\t/** The place it is about: where reinforcements are sent, what the report shows. None for a task about no place */\n\twhere?(ai: Brain, squad: Squad, state: TaskState<D, M>): Vec2 | undefined\n\t/** What the squads module leaves to it: a task that regroups in its own way, or retreats never */\n\thandles?: readonly ('retreat' | 'regroup' | 'reinforce')[]\n\t/**\n\t * Whether it is a standing duty, going on as long as its squad has it (a hero walking a lane with its waves): never\n\t * stuck, whatever its phase, for the `ends` invariant (`checkBrain`). No when left out\n\t */\n\tstanding?: boolean\n\t/**\n\t * Whether a squad on it is in a fight it means to win, which the micro fights for (`ai.area(Micro)`): yes when left\n\t * out. No for a task that goes somewhere, looks, stands, gathers or falls back (the kit's `move`, `scout`, `hold`,\n\t * `gather`, `retreat`, and the micro's own `flee`)\n\t */\n\tfighting?: boolean\n}\n\n/**\n * Defines a task: a kind of thing a squad can be told to do (`squad.task(def, data)`, its data typed by the task), the\n * kit's and a game's own. List a game's in the brain's `settings.squads.tasks`, so that a squad on it goes on after a\n * load\n *\n * @beta\n */\nexport function defineTask<D extends object = TaskData, M extends object = TaskMemory>(def: TaskDef<D, M>): TaskDef<D, M> {\n\tif (!def.id) throw new Error('A task needs an id')\n\tif (typeof def.start !== 'function' || typeof def.think !== 'function') throw new Error(`The task \"${def.id}\" needs a start and a think`)\n\treturn def\n}\n"],"mappings":";;;;;;;;AA+HA,SAAgB,WAAuE,KAAmC;CACzH,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,MAAM,oBAAoB;CACjD,IAAI,OAAO,IAAI,UAAU,cAAc,OAAO,IAAI,UAAU,YAAY,MAAM,IAAI,MAAM,aAAa,IAAI,GAAG,4BAA4B;CACxI,OAAO;AACR"}

package/dist/ai/tasks/attack.js

@@ -0,0 +1,24 @@
+import { defineTask } from "../task.js";
+import { goFight, placeOf, planRoute, watchFight } from "./shared.js";
+//#region src/ai/tasks/attack.ts
+/**
+* The kit's `attack` task (design review B10): attacks a place or a target, by a way round where told: done `cleared` with nothing left to fight there, `lost` with its target gone
+*/
+/**
+* Attacks a place or a target, by a way round where told: done `cleared` with nothing left to fight there, `lost` with its target gone
+*
+* @beta
+*/
+var ATTACK = defineTask({
+	id: "attack",
+	start(ai, squad, state) {
+		planRoute(ai, squad, state);
+		goFight(ai, squad, state);
+	},
+	think: watchFight,
+	where: (ai, _squad, state) => placeOf(ai, state)
+});
+//#endregion
+export { ATTACK };
+
+//# sourceMappingURL=attack.js.map

package/dist/ai/tasks/attack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attack.js","names":[],"sources":["../../../src/ai/tasks/attack.ts"],"sourcesContent":["/**\n * The kit's `attack` task (design review B10): attacks a place or a target, by a way round where told: done `cleared` with nothing left to fight there, `lost` with its target gone\n */\nimport { defineTask } from '../task'\nimport { type FightData, type FightMemory, goFight, placeOf, planRoute, watchFight } from './shared'\n\n/**\n * Attacks a place or a target, by a way round where told: done `cleared` with nothing left to fight there, `lost` with its target gone\n *\n * @beta\n */\nexport const ATTACK = defineTask<FightData, FightMemory>({ id: 'attack', start(ai, squad, state) {\n\t\tplanRoute(ai, squad, state)\n\t\tgoFight(ai, squad, state)\n\t},\n\tthink: watchFight,\n\twhere: (ai, _squad, state) => placeOf(ai, state) })\n"],"mappings":";;;;;;;;;;;AAWA,IAAa,SAAS,WAAmC;CAAE,IAAI;CAAU,MAAM,IAAI,OAAO,OAAO;EAC/F,UAAU,IAAI,OAAO,KAAK;EAC1B,QAAQ,IAAI,OAAO,KAAK;CACzB;CACA,OAAO;CACP,QAAQ,IAAI,QAAQ,UAAU,QAAQ,IAAI,KAAK;AAAE,CAAC"}