@v12-engine/engine 0.1.0 → 0.4.0

package/dist/systems/production.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"production.js","names":[],"sources":["../../src/systems/production.ts"],"sourcesContent":["import { morphStarted, researchFinished, unitTrained } from '#engine/engineEvents'\nimport { gathering } from '#engine/orders/harvest'\nimport type { Entity } from '#engine/entity'\nimport { heroesOf, heroState, reviveCost, reviveHero } from '#engine/hero'\nimport { closestPointOnRect, type Vec2 } from '#engine/math'\nimport { createOrder, giveOrder } from '#engine/orders/queue'\nimport { morph, techOf, unlocked } from '#engine/tech'\nimport { type PlayerFacts, trainRefusal } from '#engine/shared'\nimport { type Cost, supplyPoolsOf, upgradesOf } from '#engine/defs'\nimport type { ProductionKind } from '#engine/hooks'\nimport { shortOf, spend } from '#engine/player'\nimport type { System } from '#engine/registry'\nimport type { World } from '#engine/world'\nimport { engineMessage } from '#engine/messages'\nimport { atan2 } from '#engine/exactMath'\nimport { giveBack, productionOf, productionQueue } from './productionQueue'\nimport { deposit } from '../entity'\nimport { replicateEvent } from '../replication'\n\nfunction hasRoom(world: World, building: Entity): boolean {\n\tif (productionOf(building)!.queue.length < world.settings.production.queue) return true\n\tworld.message(building.owner, engineMessage('queueFull'))\n\treturn false\n}\n\n/**\n * Lets the `beforeProduce` hook have its say about something about to be made, then has the player pay for it.\n * What it ends up costing and how long it takes, or undefined when it is not made (and the player was told why).\n * `producer` is the building it is made in, or the worker putting down a structure\n */\nexport function startProducing(\n\tworld: World,\n\tproducer: Entity,\n\tkind: ProductionKind,\n\tid: string,\n\tcost: Cost | undefined,\n\ttime: number\n): { cost: Cost; time: number } | undefined {\n\tconst player = world.player(producer.owner)\n\tconst event = world.hooks.run('beforeProduce', { player: player.id, producer, kind, id, cost: { ...cost }, time, cancelled: false })\n\tif (event.cancelled) {\n\t\tif (event.reason) world.message(player.id, event.reason)\n\t\treturn undefined\n\t}\n\tconst short = shortOf(player.resources, event.cost)\n\tif (short) {\n\t\tworld.message(player.id, engineMessage('notEnough', { resource: short }))\n\t\treturn undefined\n\t}\n\tspend(world, player.id, event.cost, kind, id)\n\treturn event\n}\n\n/** Queues a unit for training. Returns false (and tells the player why) when that is not possible. */\nexport function enqueueProduction(world: World, building: Entity, unitType: string): boolean {\n\tconst production = productionOf(building)\n\tif (!production || !building.operational || !building.def.trains?.includes(unitType)) return false\n\tconst def = world.registry.unit(unitType)\n\tconst player = world.player(building.owner)\n\tif (!hasRoom(world, building)) return false\n\tif (!unlocked(world, player.id, 'unit', unitType, def.requires)) return false\n\t// the same rule the player's screen goes by (what it requires was asked above, the game's hook with it)\n\tconst refusal = trainRefusal(world.registry, def, playerFacts(world, player.id), { cost: false, tech: false })\n\tif (refusal) {\n\t\tworld.message(player.id, refusal)\n\t\treturn false\n\t}\n\t// what it will take, as the game's rule says of a unit not made yet\n\tconst supply = world.settings.supply.of(world, { def, owner: player.id, queued: true })\n\tconst made = startProducing(world, building, 'unit', unitType, def.cost, def.buildTime ?? 1)\n\tif (!made) return false\n\t// reserve it right away, so several commands in the same tick cannot overshoot the cap\n\tplayer.supplyUsed += supply\n\tconst pools = supplyPoolsOf(def)\n\tfor (const name in pools) if (player.supplies[name]) player.supplies[name].used += pools[name]\n\tproduction.queue.push({ kind: 'unit', id: unitType, paid: made.cost, progress: 0, duration: made.time })\n\treturn true\n}\n\n/**\n * What there is to know about a player for whether they can make something, see `trainRefusal`\n *\n * @beta\n */\nexport function playerFacts(world: World, playerId: number): PlayerFacts {\n\tconst player = world.player(playerId)\n\t// every hero counts: alive, fallen, or in a queue\n\tconst heroes = heroesOf(world, playerId).map((hero) => hero.def.id)\n\tfor (const other of world.index.ownedBy(playerId)) {\n\t\tconst production = productionOf(other)\n\t\tif (!production) continue\n\t\tfor (const item of production.queue) if (item.kind === 'unit' && world.registry.unit(item.id).hero) heroes.push(item.id)\n\t}\n\treturn {\n\t\tresources: player.resources,\n\t\tsupplyUsed: player.supplyUsed,\n\t\tsupplyCap: player.supplyCap,\n\t\t...(Object.keys(player.supplies).length > 0 && { supplies: player.supplies }),\n\t\ttech: techOf(world, playerId),\n\t\theroes,\n\t\t...(player.race !== undefined && { race: player.race })\n\t}\n}\n\n/**\n * Levels of an upgrade a player has, counting the one being researched\n *\n * @beta\n */\nexport function upgradeLevel(world: World, playerId: number, upgrade: string): { level: number; researching: boolean } {\n\tconst player = world.player(playerId)\n\treturn { level: player.upgrades.get(upgrade) ?? 0, researching: player.researching.has(upgrade) }\n}\n\n/** Queues an upgrade. One level at a time, and only in one building at once. */\nexport function enqueueResearch(world: World, building: Entity, upgrade: string): boolean {\n\tconst production = productionOf(building)\n\tif (!production || !building.operational || !building.def.researches?.includes(upgrade)) return false\n\tconst def = world.registry.upgrade(upgrade)\n\tconst player = world.player(building.owner)\n\tconst { level, researching } = upgradeLevel(world, player.id, upgrade)\n\tif (researching) {\n\t\tworld.message(player.id, engineMessage('alreadyResearching'))\n\t\treturn false\n\t}\n\tif (level >= (def.maxLevel ?? 1)) return false\n\tif (!unlocked(world, player.id, 'upgrade', upgrade, def.requires?.[level], level + 1)) return false\n\tif (!hasRoom(world, building)) return false\n\tconst made = startProducing(world, building, 'upgrade', upgrade, def.cost, def.researchTime)\n\tif (!made) return false\n\tplayer.researching.add(upgrade)\n\tproduction.queue.push({ kind: 'upgrade', id: upgrade, paid: made.cost, progress: 0, duration: made.time })\n\treturn true\n}\n\n/** Queues bringing a fallen hero back */\nexport function enqueueRevive(world: World, building: Entity, heroId: number): boolean {\n\tconst production = productionOf(building)\n\tconst hero = world.entities.get(heroId)\n\tif (!production || !building.operational || !building.def.revives) return false\n\tif (!hero?.has(heroState) || hero.alive || hero.owner !== building.owner || hero.reviving) return false\n\tconst { cost, time } = reviveCost(world, hero)\n\tif (!hasRoom(world, building)) return false\n\tconst made = startProducing(world, building, 'revive', String(heroId), cost, time)\n\tif (!made) return false\n\thero.reviving = true\n\tproduction.queue.push({ kind: 'revive', id: String(heroId), paid: made.cost, progress: 0, duration: made.time })\n\treturn true\n}\n\n/**\n * Queues upgrading a building into a type it can become (`UnitTypeDef.upgradesTo`): `into`, one of them, or the first\n * where none is named. One at a time\n */\nexport function enqueueMorph(world: World, building: Entity, into = upgradesOf(building.def)[0]): boolean {\n\tconst production = productionOf(building)\n\tif (!production || !building.operational || into === undefined || !upgradesOf(building.def).includes(into)) return false\n\tif (production.queue.some((item) => item.kind === 'morph')) return false\n\tconst def = world.registry.unit(into)\n\tif (!unlocked(world, building.owner, 'unit', into, def.requires) || !hasRoom(world, building)) return false\n\tconst made = startProducing(world, building, 'morph', into, def.cost, def.buildTime ?? 1)\n\tif (!made) return false\n\tproduction.queue.push({ kind: 'morph', id: into, paid: made.cost, progress: 0, duration: made.time })\n\tworld.events.emit(morphStarted, { entity: building, into, time: made.time })\n\treturn true\n}\n\nexport function cancelProduction(world: World, building: Entity, index: number): boolean {\n\tconst production = productionOf(building)\n\tconst item = production?.queue[index]\n\tif (!production || !item) return false\n\tproduction.queue.splice(index, 1)\n\tgiveBack(world, building, item)\n\treturn true\n}\n\n/** Where what a building produced comes out: on the side of its rally point */\nfunction exitOf(world: World, building: Entity, radius: number): { exit: Vec2; towards: Vec2 } {\n\tconst rally = productionOf(building)!.rally\n\tconst towards = world.get(rally?.target)?.pos ?? rally?.point ?? { x: building.pos.x, z: building.pos.z - 100 }\n\treturn { exit: closestPointOnRect(towards, building.rect, radius + 0.3), towards }\n}\n\nfunction finishUnit(world: World, building: Entity, unitType: string): void {\n\tconst def = world.registry.unit(unitType)\n\tconst rally = productionOf(building)!.rally\n\tconst rallyTarget = world.get(rally?.target)\n\tconst { exit, towards } = exitOf(world, building, def.radius)\n\tconst unit = world.spawn(unitType, building.owner, exit, { facing: atan2(towards.x - exit.x, towards.z - exit.z) })\n\tworld.events.emit(unitTrained, { building, unit })\n\tworld.hooks.run('produced', { producer: building, kind: 'unit', id: unitType, unit })\n\tif (!rally) return\n\n\tif (rallyTarget?.get(deposit) && unit.has(gathering)) giveOrder(world, unit, createOrder(world, { type: 'harvest', target: rallyTarget.id }))\n\telse if (rallyTarget && rallyTarget.isUnit) giveOrder(world, unit, createOrder(world, { type: 'move', target: rallyTarget.id }))\n\telse giveOrder(world, unit, createOrder(world, { type: 'move', point: rally.point }))\n}\n\nfunction finishUpgrade(world: World, building: Entity, upgrade: string): void {\n\tconst player = world.player(building.owner)\n\tconst level = (player.upgrades.get(upgrade) ?? 0) + 1\n\tplayer.setUpgrade(upgrade, level)\n\tplayer.researching.delete(upgrade)\n\t// what it does besides stats, to every unit the player has\n\tconst { apply } = world.registry.upgrade(upgrade)\n\tif (apply) for (const entity of [...world.index.ownedBy(player.id)]) if (entity.alive) apply(world, entity, level)\n\tworld.events.emit(researchFinished, { building, upgrade, level })\n\tworld.hooks.run('produced', { producer: building, kind: 'upgrade', id: upgrade, level })\n\tworld.message(player.id, engineMessage('researchDone', { upgrade }), 'info')\n}\n\nexport const productionSystem: System = {\n\tname: 'production',\n\tphase: 'resolve',\n\t// only what trains, researches or turns into something: not every unit and tree of the map (OB5)\n\tover: productionQueue,\n\teach(world, entity, dt) {\n\t\tconst production = productionOf(entity)\n\t\tif (!production || !entity.operational || entity.scenery) return\n\t\tconst item = production.queue[0]\n\t\tif (!item) return\n\t\titem.progress += dt\n\t\tif (item.progress < item.duration) return\n\t\tproduction.queue.shift()\n\t\tif (item.kind === 'unit') finishUnit(world, entity, item.id)\n\t\telse if (item.kind === 'upgrade') finishUpgrade(world, entity, item.id)\n\t\telse if (item.kind === 'morph') {\n\t\t\tmorph(world, entity, item.id)\n\t\t\tworld.hooks.run('produced', { producer: entity, kind: 'morph', id: item.id, unit: entity })\n\t\t} else {\n\t\t\tconst hero = world.entities.get(Number(item.id))\n\t\t\tif (hero) {\n\t\t\t\treviveHero(world, hero, exitOf(world, entity, hero.def.radius).exit)\n\t\t\t\tworld.hooks.run('produced', { producer: entity, kind: 'revive', id: item.id, unit: hero })\n\t\t\t}\n\t\t}\n\t}\n}\n\n/** A unit made, to those who see it */\nexport const toldTrained = replicateEvent(unitTrained, 'trained', ({ building, unit }, view) =>\n\tview.knows(unit) ? { type: 'trained', id: unit.id, building: view.knows(building) ? building.id : undefined } : undefined\n)\n\n/** Research done: to its side */\nexport const toldResearched = replicateEvent(researchFinished, 'researched', ({ building, upgrade, level }, view) =>\n\tview.isAlly(building.owner) ? { type: 'researched', upgrade, level, building: building.id } : undefined\n)\n\n/** A building starting to become another, to those who see it */\nexport const toldUpgradeStarted = replicateEvent(morphStarted, 'upgradeStarted', ({ entity, into, time }, view) =>\n\tview.knows(entity) ? { type: 'upgradeStarted', id: entity.id, to: into, time } : undefined\n)\n"],"mappings":"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"}

package/dist/systems/productionQueue.js

@@ -0,0 +1,120 @@
+import { upgradesOf } from "../defs.js";
+import { defineComponent, snapshotOf } from "../components.js";
+import { morphCancelled } from "../engineEvents.js";
+import { replicateEvent } from "../replication.js";
+import { sameHundredth } from "./construction.js";
+import { giveBack as giveBack$1 } from "../player.js";
+//#region src/systems/productionQueue.ts
+/**
+* What a building makes (`productionQueue`): its queue and its rally point, and what a player's screen is told of it.
+* The state alone, of nothing but components, so that what reads or sets it (a unit turning into another type, the
+* tech) loads nothing of the production system (`production.ts`)
+*/
+var NOTHING = [];
+var sameItem = (a, b) => a.kind === b.kind && a.id === b.id && sameHundredth(a.progress, b.progress);
+/**
+* What a building makes (`UnitTypeDef.trains`, `researches`, `upgradesTo`, `revives`): its queue, and where what comes
+* out goes. Set as it is spawned (and as its type changes), for a type that makes anything. Its owner and their allies
+* are told the queue and the rally point; everyone who sees it how far it is in turning into another type
+* (`ProductionInfo`)
+*
+* @beta
+*/
+var productionQueue = defineComponent({
+	id: "core.production",
+	refs: (saved) => {
+		const { queue } = saved;
+		return {
+			upgrades: queue.filter((queued) => queued.kind === "upgrade").map((queued) => queued.id),
+			units: queue.filter((queued) => queued.kind !== "upgrade" && queued.kind !== "revive").map((queued) => queued.id)
+		};
+	},
+	onSpawn: (entity) => {
+		const { def } = entity;
+		if (def.kind !== "unit" && (def.trains?.length || def.researches?.length || upgradesOf(def).length)) entity.set(productionQueue, {
+			queue: [],
+			rally: null
+		});
+	},
+	onLeave: (entity, world) => cancelAllProduction(world, entity),
+	replicate: "everyone",
+	snapshot(production, _entity, { world, ally }) {
+		const info = {};
+		const first = production.queue[0];
+		if (first?.kind === "morph") {
+			info.upgrade = first.progress / first.duration;
+			info.upgradeTo = first.id;
+		}
+		if (ally) {
+			if (production.queue.length) info.queue = production.queue.map((item) => ({
+				kind: item.kind,
+				id: item.id,
+				progress: item.progress / item.duration
+			}));
+			const rally = world.get(production.rally?.target)?.pos ?? production.rally?.point;
+			if (rally) info.rally = {
+				x: rally.x,
+				z: rally.z
+			};
+		}
+		return info.upgradeTo !== void 0 || info.queue || info.rally ? info : void 0;
+	},
+	same: (a, b) => a.upgradeTo === b.upgradeTo && (a.upgrade === void 0 ? b.upgrade === void 0 : b.upgrade !== void 0 && sameHundredth(a.upgrade, b.upgrade)) && a.rally?.x === b.rally?.x && a.rally?.z === b.rally?.z && (a.queue?.length ?? 0) === (b.queue?.length ?? 0) && (a.queue ?? []).every((item, i) => sameItem(item, b.queue[i]))
+});
+/**
+* What a building makes, and where it goes: none for a type that makes nothing (`productionQueue`)
+*
+* @beta
+*/
+var productionOf = (entity) => entity.get(productionQueue);
+/**
+* What a building in a snapshot makes, the first being made: empty for one that makes nothing, or another's (a
+* screen's, a computer player's view)
+*
+* @beta
+*/
+var queueOf = (state) => snapshotOf(state, productionQueue)?.queue ?? NOTHING;
+/**
+* The type a building in a snapshot is turning into, and how far, 0..1: undefined for one that is not
+*
+* @beta
+*/
+function upgradeOf(state) {
+	const info = snapshotOf(state, productionQueue);
+	return info?.upgradeTo === void 0 ? void 0 : {
+		to: info.upgradeTo,
+		progress: info.upgrade ?? 0
+	};
+}
+/** What a building had queued, given back: the money paid, a hero no longer coming back, research no longer under way */
+function giveBack(world, building, item) {
+	const player = world.player(building.owner);
+	const { registry } = world;
+	if (item.kind === "revive") {
+		const hero = world.entities.get(Number(item.id));
+		if (hero) hero.reviving = false;
+	} else if (item.kind === "upgrade") player.researching.delete(item.id);
+	else if (item.kind === "morph") world.events.emit(morphCancelled, {
+		entity: building,
+		into: item.id
+	});
+	const paid = item.paid ?? (item.kind === "upgrade" ? registry.upgrade(item.id).cost : registry.unit(item.id).cost);
+	giveBack$1(world, player.id, paid, 1, item.kind, item.id);
+}
+/** Gives back everything a building had queued, for when it is destroyed */
+function cancelAllProduction(world, building) {
+	const production = productionOf(building);
+	if (!production) return;
+	for (const item of production.queue) giveBack(world, building, item);
+	production.queue.length = 0;
+}
+/** A building's becoming another called off, to those who see it */
+var toldUpgradeCancelled = replicateEvent(morphCancelled, "upgradeCancelled", ({ entity, into }, view) => view.knows(entity) ? {
+	type: "upgradeCancelled",
+	id: entity.id,
+	to: into
+} : void 0);
+//#endregion
+export { cancelAllProduction, giveBack, productionOf, productionQueue, queueOf, toldUpgradeCancelled, upgradeOf };
+
+//# sourceMappingURL=productionQueue.js.map

package/dist/systems/productionQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"productionQueue.js","names":[],"sources":["../../src/systems/productionQueue.ts"],"sourcesContent":["/**\n * What a building makes (`productionQueue`): its queue and its rally point, and what a player's screen is told of it.\n * The state alone, of nothing but components, so that what reads or sets it (a unit turning into another type, the\n * tech) loads nothing of the production system (`production.ts`)\n */\nimport { morphCancelled } from '#engine/engineEvents'\nimport { upgradesOf } from '#engine/defs'\nimport { defineComponent, snapshotOf } from '#engine/components'\nimport type { Entity, ProductionItem, ProductionState } from '#engine/entity'\nimport { giveBack as refundTo } from '#engine/player'\nimport type { World } from '#engine/world'\nimport type { EntityState, ProductionInfo, QueueItemState } from '#engine/session/protocol'\nimport { sameHundredth } from './construction'\nimport { replicateEvent } from '../replication'\n\nconst NOTHING: readonly QueueItemState[] = []\n\nconst sameItem = (a: QueueItemState, b: QueueItemState) => a.kind === b.kind && a.id === b.id && sameHundredth(a.progress, b.progress)\n\n/**\n * What a building makes (`UnitTypeDef.trains`, `researches`, `upgradesTo`, `revives`): its queue, and where what comes\n * out goes. Set as it is spawned (and as its type changes), for a type that makes anything. Its owner and their allies\n * are told the queue and the rally point; everyone who sees it how far it is in turning into another type\n * (`ProductionInfo`)\n *\n * @beta\n */\nexport const productionQueue = defineComponent<ProductionState, ProductionInfo>({ id: 'core.production', refs: (saved) => {\n\t\tconst { queue } = saved as ProductionState\n\t\treturn {\n\t\t\tupgrades: queue.filter((queued) => queued.kind === 'upgrade').map((queued) => queued.id),\n\t\t\tunits: queue.filter((queued) => queued.kind !== 'upgrade' && queued.kind !== 'revive').map((queued) => queued.id)\n\t\t}\n\t},\n\t// a queue, empty, for a structure that makes anything\n\tonSpawn: (entity) => {\n\t\tconst { def } = entity\n\t\tif (def.kind !== 'unit' && (def.trains?.length || def.researches?.length || upgradesOf(def).length))\n\t\t\tentity.set(productionQueue, { queue: [], rally: null })\n\t},\n\t// what it was making given back to whose it was, as it falls or is given away\n\tonLeave: (entity, world) => cancelAllProduction(world, entity),\n\treplicate: 'everyone',\n\tsnapshot(production, _entity, { world, ally }) {\n\t\tconst info: ProductionInfo = {}\n\t\t// a building turning into another: how far, for everyone who sees it\n\t\tconst first = production.queue[0]\n\t\tif (first?.kind === 'morph') {\n\t\t\tinfo.upgrade = first.progress / first.duration\n\t\t\tinfo.upgradeTo = first.id\n\t\t}\n\t\tif (ally) {\n\t\t\tif (production.queue.length)\n\t\t\t\tinfo.queue = production.queue.map((item) => ({ kind: item.kind, id: item.id, progress: item.progress / item.duration }))\n\t\t\tconst rally = world.get(production.rally?.target)?.pos ?? production.rally?.point\n\t\t\tif (rally) info.rally = { x: rally.x, z: rally.z }\n\t\t}\n\t\treturn info.upgradeTo !== undefined || info.queue || info.rally ? info : undefined\n\t},\n\t// a delta for every hundredth of what is under way, not every tick\n\tsame: (a, b) =>\n\t\ta.upgradeTo === b.upgradeTo &&\n\t\t(a.upgrade === undefined ? b.upgrade === undefined : b.upgrade !== undefined && sameHundredth(a.upgrade, b.upgrade)) &&\n\t\ta.rally?.x === b.rally?.x &&\n\t\ta.rally?.z === b.rally?.z &&\n\t\t(a.queue?.length ?? 0) === (b.queue?.length ?? 0) &&\n\t\t(a.queue ?? []).every((item, i) => sameItem(item, b.queue![i])) })\n\n/**\n * What a building makes, and where it goes: none for a type that makes nothing (`productionQueue`)\n *\n * @beta\n */\nexport const productionOf = (entity: Entity): ProductionState | undefined => entity.get(productionQueue)\n\n/**\n * What a building in a snapshot makes, the first being made: empty for one that makes nothing, or another's (a\n * screen's, a computer player's view)\n *\n * @beta\n */\nexport const queueOf = (state: EntityState): readonly QueueItemState[] => snapshotOf(state, productionQueue)?.queue ?? NOTHING\n\n/**\n * The type a building in a snapshot is turning into, and how far, 0..1: undefined for one that is not\n *\n * @beta\n */\nexport function upgradeOf(state: EntityState): { to: string; progress: number } | undefined {\n\tconst info = snapshotOf(state, productionQueue)\n\treturn info?.upgradeTo === undefined ? undefined : { to: info.upgradeTo, progress: info.upgrade ?? 0 }\n}\n\n/** What a building had queued, given back: the money paid, a hero no longer coming back, research no longer under way */\nexport function giveBack(world: World, building: Entity, item: ProductionItem): void {\n\tconst player = world.player(building.owner)\n\tconst { registry } = world\n\tif (item.kind === 'revive') {\n\t\tconst hero = world.entities.get(Number(item.id))\n\t\tif (hero) hero.reviving = false\n\t} else if (item.kind === 'upgrade') {\n\t\tplayer.researching.delete(item.id)\n\t} else if (item.kind === 'morph') {\n\t\tworld.events.emit(morphCancelled, { entity: building, into: item.id })\n\t}\n\tconst paid = item.paid ?? (item.kind === 'upgrade' ? registry.upgrade(item.id).cost : registry.unit(item.id).cost)\n\trefundTo(world, player.id, paid, 1, item.kind, item.id)\n}\n\n/** Gives back everything a building had queued, for when it is destroyed */\nexport function cancelAllProduction(world: World, building: Entity): void {\n\tconst production = productionOf(building)\n\tif (!production) return\n\tfor (const item of production.queue) giveBack(world, building, item)\n\tproduction.queue.length = 0\n}\n\n/** A building's becoming another called off, to those who see it */\nexport const toldUpgradeCancelled = replicateEvent(morphCancelled, 'upgradeCancelled', ({ entity, into }, view) =>\n\tview.knows(entity) ? { type: 'upgradeCancelled', id: entity.id, to: into } : undefined\n)\n"],"mappings":"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"}

package/dist/systems/victory.d.ts

@@ -11,4 +11,4 @@ export declare function defeat(world: World, playerId: number): void;
  */
 export declare const lastTeamStanding: System;
 /** Whether the player's team won, lost or plays on (`Snapshot.outcome`): an observer neither wins nor loses */
-export declare const outcomePart: import("..").SnapshotPart<keyof import("..").Snapshot>;
+export declare const outcomePart: import("..").SnapshotField<keyof import("..").Snapshot>;

package/dist/systems/victory.js

@@ -0,0 +1,56 @@
+import { gameOver, playerDefeated } from "../engineEvents.js";
+import { snapshotField } from "../replication.js";
+import { engineMessage } from "../messages.js";
+//#region src/systems/victory.ts
+/** Puts a player out of the game: they are told, and see the whole map from then on */
+function defeat(world, playerId) {
+	const player = world.player(playerId);
+	player.defeated = true;
+	world.fog.setRevealed(player.team, world.sides.teamDefeated(player.team));
+	world.events.emit(playerDefeated, player);
+	world.message(playerId, engineMessage("defeated"), "info");
+}
+/**
+* The rule of a melee game: whoever has no building left is out, and the last team in the game wins.
+* Players only take part once they have had a building, so a world with nothing but a few units
+* in it, like most tests, has no losers. Game modules with other ways to win bring their own system.
+*
+* @beta
+*/
+var lastTeamStanding = {
+	name: "victory",
+	phase: "cleanup",
+	every: 15,
+	update(world) {
+		if (world.winner !== null) return;
+		const buildings = /* @__PURE__ */ new Set();
+		for (const entity of world.units.values()) if (entity.alive && entity.isBuilding) buildings.add(entity.owner);
+		for (const player of world.players.values()) {
+			if (player.neutral || player.creeps || player.defeated) continue;
+			if (buildings.has(player.id)) player.established = true;
+			else if (player.established) defeat(world, player.id);
+		}
+		const teams = /* @__PURE__ */ new Set();
+		const standing = /* @__PURE__ */ new Set();
+		for (const player of world.players.values()) {
+			if (!player.established) continue;
+			teams.add(player.team);
+			if (!player.defeated) standing.add(player.team);
+		}
+		if (teams.size < 2 || standing.size !== 1) return;
+		const [winner] = standing;
+		world.winner = winner;
+		world.events.emit(gameOver, { winner });
+	}
+};
+/** Whether the player's team won, lost or plays on (`Snapshot.outcome`): an observer neither wins nor loses */
+var outcomePart = snapshotField("outcome", (view) => {
+	const { world } = view;
+	if (view.observer) return "playing";
+	const team = view.team;
+	return world.winner === team ? "victory" : world.winner !== null || world.sides.teamDefeated(team) ? "defeat" : "playing";
+}, true);
+//#endregion
+export { defeat, lastTeamStanding, outcomePart };
+
+//# sourceMappingURL=victory.js.map

package/dist/systems/victory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"victory.js","names":[],"sources":["../../src/systems/victory.ts"],"sourcesContent":["import { gameOver, playerDefeated } from '#engine/engineEvents'\nimport type { System } from '#engine/registry'\nimport type { World } from '#engine/world'\nimport { engineMessage } from '#engine/messages'\nimport { snapshotField } from '../replication'\n\n/** Puts a player out of the game: they are told, and see the whole map from then on */\nexport function defeat(world: World, playerId: number): void {\n\tconst player = world.player(playerId)\n\tplayer.defeated = true\n\t// nothing left to hide from someone who is out\n\tworld.fog.setRevealed(player.team, world.sides.teamDefeated(player.team))\n\tworld.events.emit(playerDefeated, player)\n\tworld.message(playerId, engineMessage('defeated'), 'info')\n}\n\n/**\n * The rule of a melee game: whoever has no building left is out, and the last team in the game wins.\n * Players only take part once they have had a building, so a world with nothing but a few units\n * in it, like most tests, has no losers. Game modules with other ways to win bring their own system.\n *\n * @beta\n */\nexport const lastTeamStanding: System = {\n\tname: 'victory',\n\tphase: 'cleanup',\n\t// a look at who is still in the game, twice a second or so\n\tevery: 15,\n\tupdate(world) {\n\t\tif (world.winner !== null) return\n\n\t\tconst buildings = new Set<number>()\n\t\tfor (const entity of world.units.values()) {\n\t\t\tif (entity.alive && entity.isBuilding) buildings.add(entity.owner)\n\t\t}\n\t\tfor (const player of world.players.values()) {\n\t\t\tif (player.neutral || player.creeps || player.defeated) continue\n\t\t\tif (buildings.has(player.id)) player.established = true\n\t\t\telse if (player.established) defeat(world, player.id)\n\t\t}\n\n\t\tconst teams = new Set<number>()\n\t\tconst standing = new Set<number>()\n\t\tfor (const player of world.players.values()) {\n\t\t\tif (!player.established) continue\n\t\t\tteams.add(player.team)\n\t\t\tif (!player.defeated) standing.add(player.team)\n\t\t}\n\t\tif (teams.size < 2 || standing.size !== 1) return\n\t\tconst [winner] = standing\n\t\tworld.winner = winner\n\t\tworld.events.emit(gameOver, { winner })\n\t}\n}\n\n/** Whether the player's team won, lost or plays on (`Snapshot.outcome`): an observer neither wins nor loses */\nexport const outcomePart = snapshotField(\n\t'outcome',\n\t(view) => {\n\t\tconst { world } = view\n\t\tif (view.observer) return 'playing'\n\t\tconst team = view.team\n\t\treturn world.winner === team ? 'victory' : world.winner !== null || world.sides.teamDefeated(team) ? 'defeat' : 'playing'\n\t},\n\ttrue\n)\n"],"mappings":";;;;;AAOA,SAAgB,OAAO,OAAc,UAAwB;CAC5D,MAAM,SAAS,MAAM,OAAO,QAAQ;CACpC,OAAO,WAAW;CAElB,MAAM,IAAI,YAAY,OAAO,MAAM,MAAM,MAAM,aAAa,OAAO,IAAI,CAAC;CACxE,MAAM,OAAO,KAAK,gBAAgB,MAAM;CACxC,MAAM,QAAQ,UAAU,cAAc,UAAU,GAAG,MAAM;AAC1D;;;;;;;;AASA,IAAa,mBAA2B;CACvC,MAAM;CACN,OAAO;CAEP,OAAO;CACP,OAAO,OAAO;EACb,IAAI,MAAM,WAAW,MAAM;EAE3B,MAAM,4BAAY,IAAI,IAAY;EAClC,KAAK,MAAM,UAAU,MAAM,MAAM,OAAO,GACvC,IAAI,OAAO,SAAS,OAAO,YAAY,UAAU,IAAI,OAAO,KAAK;EAElE,KAAK,MAAM,UAAU,MAAM,QAAQ,OAAO,GAAG;GAC5C,IAAI,OAAO,WAAW,OAAO,UAAU,OAAO,UAAU;GACxD,IAAI,UAAU,IAAI,OAAO,EAAE,GAAG,OAAO,cAAc;QAC9C,IAAI,OAAO,aAAa,OAAO,OAAO,OAAO,EAAE;EACrD;EAEA,MAAM,wBAAQ,IAAI,IAAY;EAC9B,MAAM,2BAAW,IAAI,IAAY;EACjC,KAAK,MAAM,UAAU,MAAM,QAAQ,OAAO,GAAG;GAC5C,IAAI,CAAC,OAAO,aAAa;GACzB,MAAM,IAAI,OAAO,IAAI;GACrB,IAAI,CAAC,OAAO,UAAU,SAAS,IAAI,OAAO,IAAI;EAC/C;EACA,IAAI,MAAM,OAAO,KAAK,SAAS,SAAS,GAAG;EAC3C,MAAM,CAAC,UAAU;EACjB,MAAM,SAAS;EACf,MAAM,OAAO,KAAK,UAAU,EAAE,OAAO,CAAC;CACvC;AACD;;AAGA,IAAa,cAAc,cAC1B,YACC,SAAS;CACT,MAAM,EAAE,UAAU;CAClB,IAAI,KAAK,UAAU,OAAO;CAC1B,MAAM,OAAO,KAAK;CAClB,OAAO,MAAM,WAAW,OAAO,YAAY,MAAM,WAAW,QAAQ,MAAM,MAAM,aAAa,IAAI,IAAI,WAAW;AACjH,GACA,IACD"}

package/dist/talk.d.ts

@@ -17,19 +17,19 @@ export declare function allowed(world: World, player: PlayerId, kind: string, li
     within: number;
 }): boolean;
 /**
- * The kinds of ping hero arena games have: a game's are its rules' (`GameRules.talk.pings.kinds`), `look` first
+ * The kinds of ping hero arena games have: a game's are its rules' (`RuleSettings.talk.pings.kinds`), `look` first
  *
  * @beta
  */
 export declare const PING_KINDS: readonly ['look', 'danger', 'assist', 'onMyWay'];
 /**
- * A kind of ping: one of `GameRules.talk.pings.kinds`
+ * A kind of ping: one of `RuleSettings.talk.pings.kinds`
  *
  * @beta
  */
-export type PingKind = string;
+export type PingId = string;
 /**
- * The kinds of ping a game's rules let go (`GameRules.talk.pings.kinds`), as they are now: its list, or what it works
+ * The kinds of ping a game's rules let go (`RuleSettings.talk.pings.kinds`), as they are now: its list, or what it works
  * out from the registry (a file of the game's the editor writes)
  *
  * @beta
@@ -38,7 +38,7 @@ export declare function pingKinds(registry: Registry): readonly string[];
 /**
  * A player marks a spot of the map (`pinged`) for their allies (`to: 'allies'`, when left out) or for everyone
  * (`'all'`): told to them and to who watches, as sessions do. Of a kind the game's rules have
- * (`GameRules.talk.pings.kinds`), as many in a while as they let (`GameRules.talk`), and as the `beforeTalk` hook lets it,
+ * (`RuleSettings.talk.pings.kinds`), as many in a while as they let (`RuleSettings.talk`), and as the `beforeTalk` hook lets it,
  * which may change who hears it
  *
  * @beta
@@ -53,7 +53,7 @@ export declare function ping(world: World, player: PlayerId, point: Vec2, kind?:
 export type ChatAudience = 'allies' | 'all' | 'observers';
 /**
  * A player says a line (`chatted`): to their side, or to everyone, and to who watches either way. Spaces run
- * together, and cut to the game's length (`GameRules.talk`); nothing for an empty line, a message for too many in a
+ * together, and cut to the game's length (`RuleSettings.talk`); nothing for an empty line, a message for too many in a
  * while; and as the `beforeTalk` hook lets it, which may change the words or who hears them
  *
  * @beta

package/dist/talk.js

@@ -0,0 +1,153 @@
+import { defineComponent } from "./components.js";
+import { chatted, pinged } from "./engineEvents.js";
+import { replicateEvent } from "./replication.js";
+import { engineMessage } from "./messages.js";
+//#region src/talk.ts
+/**
+* When each player's last ones of each kind went out (`ping:1`, the world's times): the world's, and saved with it, so
+* that a player who used up the limit is still refused in the game loaded from a save, as in the game that went on
+*/
+var sent = defineComponent({
+	id: "core.talkSent",
+	default: () => ({})
+});
+/**
+* Whether a player may send another of a kind now: and counts it, when they may
+*
+* @beta
+*/
+function allowed(world, player, kind, limit) {
+	const byPlayer = world.state(sent);
+	const key = `${kind}:${player}`;
+	const times = (byPlayer[key] ?? []).filter((time) => world.time - time < limit.within);
+	byPlayer[key] = times;
+	if (times.length >= limit.most) return false;
+	times.push(world.time);
+	return true;
+}
+/**
+* The kinds of ping hero arena games have: a game's are its rules' (`RuleSettings.talk.pings.kinds`), `look` first
+*
+* @beta
+*/
+var PING_KINDS = [
+	"look",
+	"danger",
+	"assist",
+	"onMyWay"
+];
+/**
+* Whether the rules let a player say this (`beforeTalk`): the event as the handlers left it, or nothing when one of
+* them called it off
+*/
+function heard(world, talk) {
+	const event = {
+		...talk,
+		cancelled: false
+	};
+	if (world.hooks.has("beforeTalk")) world.hooks.run("beforeTalk", event);
+	return event.cancelled ? void 0 : event;
+}
+/**
+* The kinds of ping a game's rules let go (`RuleSettings.talk.pings.kinds`), as they are now: its list, or what it works
+* out from the registry (a file of the game's the editor writes)
+*
+* @beta
+*/
+function pingKinds(registry) {
+	const { kinds } = registry.settings.talk.pings;
+	return typeof kinds === "function" ? kinds(registry) : kinds;
+}
+/**
+* A player marks a spot of the map (`pinged`) for their allies (`to: 'allies'`, when left out) or for everyone
+* (`'all'`): told to them and to who watches, as sessions do. Of a kind the game's rules have
+* (`RuleSettings.talk.pings.kinds`), as many in a while as they let (`RuleSettings.talk`), and as the `beforeTalk` hook lets it,
+* which may change who hears it
+*
+* @beta
+*/
+function ping(world, player, point, kind = pingKinds(world.registry)[0] ?? "look", to = "allies", by) {
+	if (!pingKinds(world.registry).includes(kind)) return;
+	if (!isAudience(to)) return;
+	if (!allowed(world, player, "ping", world.settings.talk.pings)) return world.message(player, engineMessage("tooManyPings"));
+	const event = heard(world, {
+		player,
+		kind: "ping",
+		point,
+		pingKind: kind,
+		to
+	});
+	if (!event) return;
+	world.events.emit(pinged, {
+		player,
+		point: {
+			x: point.x,
+			z: point.z
+		},
+		kind,
+		to: event.to ?? to,
+		...watcher(to, by)
+	});
+}
+/** Whether a word is who a line or a ping is for */
+var isAudience = (to) => to === "allies" || to === "all" || to === "observers";
+/** How long the name of who watches may be, as their lines say it */
+var WATCHER_NAME = 24;
+/** The name of who watches, as their line or ping says it: only theirs, to who watches */
+var watcher = (to, by) => to === "observers" && by?.trim() ? { by: by.trim().slice(0, WATCHER_NAME) } : {};
+/**
+* How long a line may be, unless the game's rules say otherwise (`RuleSettings.talk`)
+*
+* @internal
+*/
+var CHAT_LENGTH = 160;
+/**
+* A player says a line (`chatted`): to their side, or to everyone, and to who watches either way. Spaces run
+* together, and cut to the game's length (`RuleSettings.talk`); nothing for an empty line, a message for too many in a
+* while; and as the `beforeTalk` hook lets it, which may change the words or who hears them
+*
+* @beta
+*/
+function chat(world, player, text, to = "allies", by) {
+	if (!isAudience(to)) return;
+	const said = text.replace(/\s+/g, " ").trim().slice(0, world.settings.talk.lines.length);
+	if (!said) return;
+	if (!allowed(world, player, "chat", world.settings.talk.lines)) return world.message(player, engineMessage("tooManyLines"));
+	const event = heard(world, {
+		player,
+		kind: "chat",
+		text: said,
+		to
+	});
+	if (!event?.text) return;
+	world.events.emit(chatted, {
+		player,
+		text: event.text,
+		to: event.to ?? to,
+		...watcher(to, by)
+	});
+}
+/** Whether a screen hears what was said or pinged: everyone what is to all, who watches everything, a side its own; what who watches says, only who watches */
+var hears = (to, player, view) => to === "observers" ? view.observer : to === "all" || view.observer || view.isAlly(player);
+/** A ping: to everyone where it is to all, else to the pinger's side; one who watches pinged, to who watches */
+var toldPing = replicateEvent(pinged, "ping", ({ player, point, kind, to, by }, view) => hears(to, player, view) ? {
+	type: "ping",
+	player,
+	x: point.x,
+	z: point.z,
+	kind,
+	to,
+	...by !== void 0 && { by }
+} : void 0);
+/** A line of chat: to everyone where it is to all, else to the speaker's side; one who watches said it, to who watches */
+var toldChat = replicateEvent(chatted, "chat", ({ player, text, to, by }, view) => hears(to, player, view) ? {
+	type: "chat",
+	player,
+	text,
+	to,
+	...by !== void 0 && { by }
+} : void 0);
+//#endregion
+export { CHAT_LENGTH, PING_KINDS, allowed, chat, ping, pingKinds, sent, toldChat, toldPing };
+
+//# sourceMappingURL=talk.js.map

package/dist/talk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"talk.js","names":["pingedEvent","chattedEvent"],"sources":["../src/talk.ts"],"sourcesContent":["import { chatted as chattedEvent, pinged as pingedEvent } from '#engine/engineEvents'\nimport { defineComponent } from './components'\nimport type { PlayerId } from './entity'\nimport type { Registry } from './registry'\nimport type { Vec2 } from './math'\nimport { engineMessage } from './messages'\nimport type { BeforeTalk } from './hooks'\nimport type { World } from './world'\nimport { replicateEvent } from './replication'\n\n/*\n * What players say to each other, besides the game: pings on the map, and (see `chat`) lines of text. Commands like\n * any other, so that they go over a wire and into a replay; limited in how often, as anyone may send them\n */\n\n/**\n * When each player's last ones of each kind went out (`ping:1`, the world's times): the world's, and saved with it, so\n * that a player who used up the limit is still refused in the game loaded from a save, as in the game that went on\n */\nexport const sent = defineComponent<Record<string, number[]>>({ id: 'core.talkSent', default: () => ({}) })\n\n/**\n * Whether a player may send another of a kind now: and counts it, when they may\n *\n * @beta\n */\nexport function allowed(world: World, player: PlayerId, kind: string, limit: { most: number; within: number }): boolean {\n\tconst byPlayer = world.state(sent)\n\tconst key = `${kind}:${player}`\n\tconst times = (byPlayer[key] ?? []).filter((time) => world.time - time < limit.within)\n\tbyPlayer[key] = times\n\tif (times.length >= limit.most) return false\n\ttimes.push(world.time)\n\treturn true\n}\n\n/**\n * The kinds of ping hero arena games have: a game's are its rules' (`RuleSettings.talk.pings.kinds`), `look` first\n *\n * @beta\n */\nexport const PING_KINDS = ['look', 'danger', 'assist', 'onMyWay'] as const\n/**\n * A kind of ping: one of `RuleSettings.talk.pings.kinds`\n *\n * @beta\n */\nexport type PingId = string\n\n/**\n * Whether the rules let a player say this (`beforeTalk`): the event as the handlers left it, or nothing when one of\n * them called it off\n */\nfunction heard<T extends Omit<BeforeTalk, 'cancelled' | 'cancel'>>(world: World, talk: T): (T & { cancelled: boolean }) | undefined {\n\tconst event = { ...talk, cancelled: false }\n\tif (world.hooks.has('beforeTalk')) world.hooks.run('beforeTalk', event)\n\treturn event.cancelled ? undefined : event\n}\n\n/**\n * The kinds of ping a game's rules let go (`RuleSettings.talk.pings.kinds`), as they are now: its list, or what it works\n * out from the registry (a file of the game's the editor writes)\n *\n * @beta\n */\nexport function pingKinds(registry: Registry): readonly string[] {\n\tconst { kinds } = registry.settings.talk.pings\n\treturn typeof kinds === 'function' ? kinds(registry) : kinds\n}\n\n/**\n * A player marks a spot of the map (`pinged`) for their allies (`to: 'allies'`, when left out) or for everyone\n * (`'all'`): told to them and to who watches, as sessions do. Of a kind the game's rules have\n * (`RuleSettings.talk.pings.kinds`), as many in a while as they let (`RuleSettings.talk`), and as the `beforeTalk` hook lets it,\n * which may change who hears it\n *\n * @beta\n */\nexport function ping(\n\tworld: World,\n\tplayer: PlayerId,\n\tpoint: Vec2,\n\tkind: string = pingKinds(world.registry)[0] ?? 'look',\n\tto: string = 'allies',\n\tby?: string\n): void {\n\tif (!pingKinds(world.registry).includes(kind)) return\n\tif (!isAudience(to)) return\n\tif (!allowed(world, player, 'ping', world.settings.talk.pings)) return world.message(player, engineMessage('tooManyPings'))\n\tconst event = heard(world, { player, kind: 'ping', point, pingKind: kind, to })\n\tif (!event) return\n\tworld.events.emit(pingedEvent, { player, point: { x: point.x, z: point.z }, kind, to: event.to ?? to, ...watcher(to, by) })\n}\n\n/** Whether a word is who a line or a ping is for */\nconst isAudience = (to: string): to is ChatAudience => to === 'allies' || to === 'all' || to === 'observers'\n\n/** How long the name of who watches may be, as their lines say it */\nconst WATCHER_NAME = 24\n\n/** The name of who watches, as their line or ping says it: only theirs, to who watches */\nconst watcher = (to: string, by: string | undefined) => (to === 'observers' && by?.trim() ? { by: by.trim().slice(0, WATCHER_NAME) } : {})\n\n/**\n * How long a line may be, unless the game's rules say otherwise (`RuleSettings.talk`)\n *\n * @internal\n */\nexport const CHAT_LENGTH = 160\n\n/**\n * Who a line of chat or a ping is for: the player's side, everyone in the game, or who watches alone (`observers`:\n * what one who watches says, which no player hears; a host gives every line of theirs this, `SessionHost`)\n *\n * @beta\n */\nexport type ChatAudience = 'allies' | 'all' | 'observers'\n\n/**\n * A player says a line (`chatted`): to their side, or to everyone, and to who watches either way. Spaces run\n * together, and cut to the game's length (`RuleSettings.talk`); nothing for an empty line, a message for too many in a\n * while; and as the `beforeTalk` hook lets it, which may change the words or who hears them\n *\n * @beta\n */\nexport function chat(world: World, player: PlayerId, text: string, to: string = 'allies', by?: string): void {\n\tif (!isAudience(to)) return\n\tconst said = text.replace(/\\s+/g, ' ').trim().slice(0, world.settings.talk.lines.length)\n\tif (!said) return\n\tif (!allowed(world, player, 'chat', world.settings.talk.lines)) return world.message(player, engineMessage('tooManyLines'))\n\tconst event = heard(world, { player, kind: 'chat', text: said, to })\n\tif (!event?.text) return\n\tworld.events.emit(chattedEvent, { player, text: event.text, to: event.to ?? to, ...watcher(to, by) })\n}\n\n/** Whether a screen hears what was said or pinged: everyone what is to all, who watches everything, a side its own; what who watches says, only who watches */\nconst hears = (to: ChatAudience, player: PlayerId, view: { observer: boolean; isAlly(player: PlayerId): boolean }) =>\n\tto === 'observers' ? view.observer : to === 'all' || view.observer || view.isAlly(player)\n\n/** A ping: to everyone where it is to all, else to the pinger's side; one who watches pinged, to who watches */\nexport const toldPing = replicateEvent(pingedEvent, 'ping', ({ player, point, kind, to, by }, view) =>\n\thears(to, player, view) ? { type: 'ping', player, x: point.x, z: point.z, kind, to, ...(by !== undefined && { by }) } : undefined\n)\n\n/** A line of chat: to everyone where it is to all, else to the speaker's side; one who watches said it, to who watches */\nexport const toldChat = replicateEvent(chattedEvent, 'chat', ({ player, text, to, by }, view) =>\n\thears(to, player, view) ? { type: 'chat', player, text, to, ...(by !== undefined && { by }) } : undefined\n)\n"],"mappings":"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"}

package/dist/targeting.d.ts

@@ -0,0 +1,142 @@
+/**
+ * How an ability is aimed (E2E-PLAN AB4): the engine's ways (`AbilityDef.target`: nothing, a unit, a point, a direction,
+ * two points, passive) and a game's own (`defineTargeting`, listed in `Rules.targetings`): how the order checks and
+ * aims it, and what the screen's indicator draws while the player aims it
+ */
+import type { AbilityDef, AimShape } from './defs';
+import type { Entity } from './entity';
+import type { Vec2 } from './math';
+import type { MessageRef } from './messages';
+import type { World } from './world';
+/**
+ * The engine's ways of aiming an ability, what every way of a game's own is like (`Targeting.like`): at once
+ * (`none`), at a unit, at a point (walked into range of), towards a point (from where the caster stands), along two
+ * points (`vector`: where it starts, in range, and the way it goes from there), or not cast at all (`passive`)
+ *
+ * @beta
+ */
+export type AimKind = 'none' | 'unit' | 'point' | 'direction' | 'vector' | 'passive';
+/**
+ * Every `AimKind`, in the order the aims are listed in tools
+ *
+ * @beta
+ */
+export declare const AIM_KINDS: readonly AimKind[];
+/**
+ * How an ability was aimed, as its order carries it: the unit, the point, and for two points (`vector`) where it goes
+ * from the point (`to`)
+ *
+ * @beta
+ */
+export interface CastAim {
+    /** The ability's level */
+    level: number;
+    /** The unit the ability was aimed at, for a unit-aimed ability */
+    target?: Entity;
+    /** The ground point it was aimed at, or the first point of a two-point ability */
+    point?: Vec2;
+    /** For two points: the second, the way it goes from `point` */
+    to?: Vec2;
+}
+/**
+ * Where an ability's effects go, from how it was aimed (`Targeting.aim`): their point, the unit they are for, and what
+ * they go off from when not the caster (`EffectContext.origin`)
+ *
+ * @beta
+ */
+export interface CastAimed {
+    /** Where the effects go, in world coordinates */
+    point?: Vec2;
+    /** The unit the effects are for */
+    target?: Entity;
+    /** What the effects go off from when it is not the caster: an entity or a point */
+    origin?: Entity | Vec2;
+}
+/**
+ * A piece of what an indicator draws (`Targeting.indicator`): a shape (`AimShape`) at a place on the ground, turned
+ * to `heading` (radians, 0 the way of +z) for one that points somewhere (a line, a cone, an arc)
+ *
+ * @beta
+ */
+export type AimPiece = AimShape & {
+    at: Vec2;
+    heading?: number;
+};
+/**
+ * What the screen knows as the player aims (`Targeting.indicator`): the ability and its level, where the caster
+ * stands, where the pointer is on the ground, and for two points the first one, once it is given
+ *
+ * @beta
+ */
+export interface AimView {
+    /** The ability being aimed */
+    ability: AbilityDef;
+    /** The level of the ability being aimed */
+    level: number;
+    /** Where the caster stands, in world coordinates */
+    from: Vec2;
+    /** Where the pointer is on the ground, when it is over the ground */
+    pointer?: Vec2;
+    /** The first point of a two-point ability once it is given */
+    start?: Vec2;
+}
+/**
+ * A way of aiming of a game's own, for `AbilityDef.target` (`defineTargeting`): the engine's way it is like (what the
+ * player gives, what the order walks to), and on top of that what may be aimed at (`check`), where the effects go
+ * from what was aimed (`aim`), and what the screen draws while it is aimed (`indicator`)
+ *
+ * @beta
+ */
+export interface Targeting {
+    /** What `AbilityDef.target` says for it */
+    readonly id: string;
+    /** The engine's way it is like: what the player gives (a unit, a point, two points, nothing) and what the order walks to */
+    readonly like: Exclude<AimKind, 'passive'>;
+    /**
+     * Why it cannot be aimed so, or nothing where it can: asked as the order takes it and again as it goes off (the
+     * player is told the reason). A wall only on open ground, a point only beside an ally
+     */
+    check?(world: World, caster: Entity, ability: AbilityDef, aim: CastAim): MessageRef | undefined;
+    /**
+     * Where the effects go, from how it was aimed: over what the engine makes of it (its `point`, `target`, and for two
+     * points the first as the `origin` and the second as the `point`)
+     */
+    aim?(world: World, caster: Entity, ability: AbilityDef, aim: CastAim): CastAimed | undefined;
+    /**
+     * What the screen draws on the ground while the player aims it, in place of the engine's (`aimOf`): pieces of the
+     * shapes there are, each at a place, turned as it says. Code of the game's own, run on the screen: no world
+     */
+    indicator?(view: AimView): readonly AimPiece[] | undefined;
+}
+/**
+ * A way of aiming of a game's own: `defineTargeting({ id: 'wall', like: 'point', check, indicator })`, listed in
+ * `Rules.targetings` and named by an ability's `target`. Its name is said by declaring it in `AbilityTargetings`
+ * (`declare module '@v12-engine/engine' { interface AbilityTargetings { wall: true } }`), so that an ability's
+ * `target: 'wall'` is typed
+ *
+ * @beta
+ */
+export declare function defineTargeting(def: Targeting): Targeting;
+/**
+ * How an ability is aimed, as the engine's way it is or is like (`AimKind`): its `target` itself for the engine's, the
+ * `like` of a game's own (`Rules.targetings`). `none` for a name nothing defines
+ *
+ * @beta
+ */
+export declare function aimKind(registry: {
+    readonly targetings: {
+        has(id: string): boolean;
+        get(id: string): Targeting;
+    };
+}, ability: AbilityDef): AimKind;
+/**
+ * A game's own way of aiming an ability (`Rules.targetings`), where its `target` names one
+ *
+ * @beta
+ */
+export declare function targetingOf(registry: {
+    readonly targetings: {
+        has(id: string): boolean;
+        get(id: string): Targeting;
+    };
+}, ability: AbilityDef): Targeting | undefined;