@v12-engine/engine 0.1.1 → 0.4.0

package/dist/session/entityState.js

@@ -0,0 +1,415 @@
+import { baseStats } from "../defs.js";
+import { orderSays } from "../orders/facts.js";
+import { changedStats } from "../stats.js";
+import { deposit, fighting, moving } from "../entity.js";
+import { shieldOf } from "../abilities/buffs.js";
+import { dashing } from "../dashing.js";
+import { assertPlainData } from "../debug2.js";
+import { recastsLeft } from "../abilities/recast.js";
+import { declaredRefusal, notReady } from "../orders/cast.js";
+import { illusion } from "../summons.js";
+import { same } from "./delta.js";
+//#region src/session/entityState.ts
+/**
+* What a player is told of an entity (design review E7): what everyone in sight of it is, worked out once a tick for
+* every seat of a host (`commonEntityState`), and on it what is one player's own (`playerEntityState`). A seat
+* (`LocalSession`) puts them in its snapshots.
+*
+* Most of what stands in sight stands as it was told last tick, so what was told is kept (`Entity.told` for
+* everyone's part, the seat's own memory for the player's) and handed back as the very same object while it still
+* says the truth (`commonStillTold`, the own part's checks): the screen and a host's delta tell by the object that
+* nothing changed, and go no further. Each check mirrors its builder field by field; `checkTold` (`debugChecks.snapshots`)
+* catches a field the one tells and the other forgets
+*/
+/** A rule of `RuleSettings.hud` for one unit: its value, or what its function decides */
+var ruleOf = (world, entity, rule) => typeof rule === "function" ? rule(world, entity) : rule;
+/** The seconds left of one buff as told: -1 for one with no end, or kept up by an aura or a passive */
+var buffTimeOf = (buff) => Number.isFinite(buff.remaining) && !buff.kept ? Math.max(buff.remaining, 0) : -1;
+/** The seconds left of a unit's buffs, in their order (`buffTimeOf`) */
+function buffTimesOf(entity) {
+	const times = new Array(entity.buffs.length);
+	for (let i = 0; i < entity.buffs.length; i++) times[i] = buffTimeOf(entity.buffs[i]);
+	return times;
+}
+/** Whether the buff times told are those of the unit's buffs now */
+function sameBuffTimes(entity, times) {
+	if (times.length !== entity.buffs.length) return false;
+	for (let i = 0; i < times.length; i++) if (times[i] !== buffTimeOf(entity.buffs[i])) return false;
+	return true;
+}
+/** Whether a unit is camouflaged (`BuffDef.camouflage`, the vision pack: its enemies see it only from near) */
+function camouflaged(world, entity) {
+	if (!entity.buffs.length) return false;
+	for (const buff of entity.buffs) if (world.registry.buff(buff.id).camouflage !== void 0) return true;
+	return false;
+}
+/**
+* What everyone in sight of an entity is told of it this tick, the same for every seat (`EntityState`): where it is,
+* its health and mana, its stats where they changed, its buffs, what the rules share for the plates over it. `name`
+* is what the map calls it, where it has a name. `commonStillTold` mirrors it: a field told here is checked there
+*
+* @internal
+*/
+function commonEntityState(world, entity, name) {
+	const state = {
+		id: entity.id,
+		type: entity.def.id,
+		owner: entity.owner,
+		x: entity.pos.x,
+		z: entity.pos.z,
+		facing: entity.facing,
+		health: entity.health,
+		stats: changedStats(world, entity),
+		visible: true
+	};
+	const base = baseStats(entity.def, world.registry);
+	if (entity.maxHealth !== base.health) state.maxHealth = entity.maxHealth;
+	if (entity.buffs.length) state.shield = shieldOf(entity) || void 0;
+	const dash = entity.get(dashing);
+	if (dash?.height) state.leap = {
+		from: dash.from,
+		to: {
+			x: dash.x,
+			z: dash.z
+		},
+		height: dash.height
+	};
+	if (entity.maxMana > 0) {
+		state.mana = entity.mana;
+		if (entity.maxMana !== base.mana) state.maxMana = entity.maxMana;
+	}
+	if (entity.buffs.length) state.buffs = entity.buffs.map((buff) => buff.id);
+	for (const buff of entity.buffs) if (buff.stacks) (state.stacks ??= {})[buff.id] = buff.stacks;
+	const { hud } = world.settings;
+	if (hud.shareBuffTimes !== void 0 && entity.buffs.length && ruleOf(world, entity, hud.shareBuffTimes) === true) state.buffTimes = buffTimesOf(entity);
+	if (hud.shareAbilities !== void 0 && entity.abilities.length) {
+		const share = ruleOf(world, entity, hud.shareAbilities);
+		if (share === "icons" || share === "cooldowns") {
+			const abilities = [];
+			for (const { id, level, cooldown } of entity.abilities) if (level >= 1) abilities.push(share === "cooldowns" ? {
+				id,
+				level,
+				cooldown
+			} : {
+				id,
+				level
+			});
+			if (abilities.length) state.abilities = abilities;
+		}
+	}
+	if (entity.get(deposit)) state.resource = entity.get(deposit).amount;
+	if (entity.on !== void 0) state.on = entity.on;
+	if (entity.asleep) state.asleep = true;
+	if (entity.orders.length) state.busy = true;
+	if (entity.scale !== 1) state.scale = entity.scale;
+	if (entity.look) state.look = entity.look;
+	if (entity.likeness) state.likeness = entity.likeness;
+	if (world.sight.isInvisible(entity) || camouflaged(world, entity)) state.unseen = true;
+	if (name !== void 0) state.name = name;
+	if (entity.expires !== null && !entity.has(illusion)) state.lifetime = {
+		left: entity.expires,
+		total: entity.lifetime
+	};
+	return state;
+}
+/**
+* Whether what everyone was told of an entity (`state`, made by `commonEntityState`) is still what it would be told
+* now: each field against where the builder reads it, those that change most often first. A field left out here
+* would leave a screen stale: `checkTold` catches that
+*
+* @internal
+*/
+function commonStillTold(world, entity, state, name) {
+	if (state.x !== entity.pos.x || state.z !== entity.pos.z || state.facing !== entity.facing || state.health !== entity.health) return false;
+	if (state.type !== entity.def.id || state.owner !== entity.owner || state.name !== name) return false;
+	if (state.stats !== changedStats(world, entity)) return false;
+	const base = baseStats(entity.def, world.registry);
+	if (state.maxHealth !== (entity.maxHealth !== base.health ? entity.maxHealth : void 0)) return false;
+	if (entity.maxMana > 0) {
+		if (state.mana !== entity.mana || state.maxMana !== (entity.maxMana !== base.mana ? entity.maxMana : void 0)) return false;
+	} else if (state.mana !== void 0) return false;
+	const { buffs } = entity;
+	if (state.shield !== (buffs.length ? shieldOf(entity) || void 0 : void 0)) return false;
+	const dash = entity.get(dashing);
+	if (dash?.height) {
+		const { leap } = state;
+		if (!leap || leap.from.x !== dash.from.x || leap.from.z !== dash.from.z || leap.to.x !== dash.x || leap.to.z !== dash.z || leap.height !== dash.height) return false;
+	} else if (state.leap) return false;
+	if (buffs.length) {
+		const ids = state.buffs;
+		if (!ids || ids.length !== buffs.length) return false;
+		let stacked = 0;
+		for (let i = 0; i < buffs.length; i++) {
+			const buff = buffs[i];
+			if (ids[i] !== buff.id) return false;
+			if (buff.stacks) {
+				stacked++;
+				if (state.stacks?.[buff.id] !== buff.stacks) return false;
+			}
+		}
+		if (stacked === 0 ? state.stacks !== void 0 : !state.stacks || Object.keys(state.stacks).length > stacked) return false;
+	} else if (state.buffs || state.stacks) return false;
+	const { hud } = world.settings;
+	if (hud.shareBuffTimes !== void 0 && buffs.length && ruleOf(world, entity, hud.shareBuffTimes) === true) {
+		if (!state.buffTimes || !sameBuffTimes(entity, state.buffTimes)) return false;
+	} else if (state.buffTimes) return false;
+	const share = hud.shareAbilities !== void 0 && entity.abilities.length ? ruleOf(world, entity, hud.shareAbilities) : void 0;
+	if (share === "icons" || share === "cooldowns") {
+		const told = state.abilities;
+		let n = 0;
+		for (const { id, level, cooldown } of entity.abilities) {
+			if (level < 1) continue;
+			const ability = told?.[n++];
+			if (!ability || ability.id !== id || ability.level !== level || ability.cooldown !== (share === "cooldowns" ? cooldown : void 0)) return false;
+		}
+		if ((told?.length ?? 0) !== n) return false;
+	} else if (state.abilities) return false;
+	if (state.resource !== entity.get(deposit)?.amount) return false;
+	if (state.on !== entity.on || state.asleep !== (entity.asleep || void 0) || state.busy !== (entity.orders.length ? true : void 0)) return false;
+	if (state.scale !== (entity.scale !== 1 ? entity.scale : void 0) || state.look !== (entity.look || void 0) || state.likeness !== (entity.likeness || void 0)) return false;
+	if (state.unseen !== (world.sight.isInvisible(entity) || camouflaged(world, entity) || void 0)) return false;
+	if (entity.expires !== null && !entity.has(illusion)) {
+		if (!state.lifetime || state.lifetime.left !== entity.expires || state.lifetime.total !== entity.lifetime) return false;
+	} else if (state.lifetime) return false;
+	return true;
+}
+/**
+* Whether an entity has a component replicated to its owner, or shaping itself for each player (`Component.snapshot`)
+*
+* @internal
+*/
+function hasOnePlayersPart(world, entity) {
+	for (const held of entity.heldComponents()) {
+		const component = world.registry.component(held.id);
+		if (component?.replicate === "owner" || component?.replicate && component.snapshot) return true;
+	}
+	return false;
+}
+/** Whether the control of another's unit is shared with the player: its owner lets them command it */
+var commands = (view, entity) => entity.owner !== view.player && !view.observer && view.world.mayCommand(view.player, entity);
+/** Where the orders queued after the first go: a known target's place, or the point given. None for the orders of no place */
+function eachWaypoint(view, entity, each) {
+	for (let i = 1; i < entity.orders.length; i++) {
+		const order = entity.orders[i];
+		const target = view.world.get(order.init.target);
+		const point = target && view.knows(target) ? target.pos : order.init.point;
+		if (point) each(point);
+	}
+}
+/**
+* What its side is told of a unit of theirs (`OwnEntityState`): its orders, where it goes, its abilities for the
+* command card. `ownStillTold` mirrors it
+*/
+function ownEntityState(view, entity) {
+	const { world } = view;
+	const m = entity.get(moving);
+	let waypoints;
+	eachWaypoint(view, entity, (point) => (waypoints ??= []).push({
+		x: point.x,
+		z: point.z
+	}));
+	const own = {
+		...commands(view, entity) && { shared: true },
+		hidden: entity.hidden,
+		order: entity.orders[0]?.type ?? null,
+		build: entity.orders[0]?.type === "build" && !orderSays(world, entity, "building") ? entity.orders[0].init.unitType : void 0,
+		orders: entity.orders.length,
+		passive: entity.get(fighting)?.passive ?? false,
+		fighting: !!entity.get(fighting)?.autoTarget,
+		goal: m?.status === "moving" ? {
+			x: m.navGoal.x,
+			z: m.navGoal.z
+		} : void 0,
+		...waypoints && { waypoints }
+	};
+	if (entity.abilities.length) {
+		const hooked = world.hooks.has("canCast");
+		own.abilities = entity.abilities.map(({ id, level, cooldown, charges, refill, autocast, data, recast }) => {
+			const info = {
+				id,
+				level,
+				cooldown,
+				autocast
+			};
+			if (charges !== void 0) Object.assign(info, {
+				charges,
+				refill
+			});
+			if (recast) info.recast = {
+				left: recast.left,
+				total: recast.total,
+				count: recastsLeft(world.registry.ability(id), recast)
+			};
+			if (data) {
+				if (world.checks.events) assertPlainData(data, `Ability "${id}" of ${entity.def.id}#${entity.id}: its data`);
+				info.data = structuredClone(data);
+			}
+			if (!hooked || level < 1) return info;
+			const ability = world.registry.ability(id);
+			const declared = declaredRefusal(world, entity, ability);
+			const decided = notReady(world, entity, ability);
+			if (declared?.key !== decided?.key) info.decided = decided ?? null;
+			return info;
+		});
+	}
+	return own;
+}
+/** Whether the abilities a side was told of its unit (`ownEntityState`) are still what it would be told */
+function abilitiesStillTold(view, entity, told) {
+	const { world } = view;
+	if (!entity.abilities.length) return told === void 0;
+	if (!told || told.length !== entity.abilities.length) return false;
+	const hooked = world.hooks.has("canCast");
+	for (let i = 0; i < told.length; i++) {
+		const info = told[i];
+		const { id, level, cooldown, charges, refill, autocast, data, recast } = entity.abilities[i];
+		if (info.id !== id || info.level !== level || info.cooldown !== cooldown || info.autocast !== autocast) return false;
+		if (charges !== void 0 ? info.charges !== charges || info.refill !== refill : info.charges !== void 0) return false;
+		if (recast) {
+			const r = info.recast;
+			if (!r || r.left !== recast.left || r.total !== recast.total || r.count !== recastsLeft(world.registry.ability(id), recast)) return false;
+		} else if (info.recast) return false;
+		if (data ? !info.data || !same(info.data, data) : info.data) return false;
+		if (hooked && level >= 1) {
+			const ability = world.registry.ability(id);
+			const declared = declaredRefusal(world, entity, ability);
+			const decided = notReady(world, entity, ability);
+			if (!same(info.decided, declared?.key !== decided?.key ? decided ?? null : void 0)) return false;
+		} else if (info.decided !== void 0) return false;
+	}
+	return true;
+}
+/** Whether what a side was told of its unit (`ownEntityState`) is still what it would be told: each field against where the builder reads it */
+function ownStillTold(view, entity, own) {
+	const { world } = view;
+	const first = entity.orders[0];
+	if (own.orders !== entity.orders.length || own.order !== (first?.type ?? null) || own.hidden !== entity.hidden) return false;
+	if (own.shared !== (commands(view, entity) || void 0)) return false;
+	if (own.build !== (first?.type === "build" && !orderSays(world, entity, "building") ? first.init.unitType : void 0)) return false;
+	const fight = entity.get(fighting);
+	if (own.passive !== (fight?.passive ?? false) || own.fighting !== !!fight?.autoTarget) return false;
+	const m = entity.get(moving);
+	if (m?.status === "moving") {
+		if (!own.goal || own.goal.x !== m.navGoal.x || own.goal.z !== m.navGoal.z) return false;
+	} else if (own.goal) return false;
+	let n = 0;
+	let waypointsHold = true;
+	eachWaypoint(view, entity, (point) => {
+		const way = own.waypoints?.[n++];
+		if (!way || way.x !== point.x || way.z !== point.z) waypointsHold = false;
+	});
+	if (!waypointsHold || (own.waypoints?.length ?? 0) !== n) return false;
+	return abilitiesStillTold(view, entity, own.abilities);
+}
+/**
+* Whether what was told of a structure's components (`state.components`) is what they hold now: what lets a tree's or
+* a mine's description be said again as it is (`LocalSession.see`). Components told to everyone as they are are
+* compared; one shaped for each player (`snapshot`), or told to some alone, has it described anew. True for what holds
+* none told, which is nearly every tree
+*
+* @internal
+*/
+function sharedStillTold(entity, state) {
+	const told = state.components;
+	let count = 0;
+	for (const held of entity.heldComponents()) {
+		if (!held.replicate) continue;
+		if (held.replicate !== "everyone" || held.snapshot) return false;
+		const was = told?.[held.id];
+		if (was === void 0 || !same(was, entity.get(held))) return false;
+		count++;
+	}
+	return !told || Object.keys(told).length === count;
+}
+/** Whether two sets of components' parts are the very same objects under the same ids */
+function sameParts(a, b) {
+	if (a === b) return true;
+	if (!a || !b) return false;
+	for (const id in a) if (a[id] !== b[id]) return false;
+	for (const id in b) if (!(id in a)) return false;
+	return true;
+}
+/**
+* What one player is told of an entity, on what everyone is (`shared`, `commonEntityState`): an illusion's lifetime on
+* its own side, the components replicated to the player and what they make of themselves for them, and its own part
+* (`own`: its orders, where it goes, its abilities) for one of the player's side. `shared` itself where there is
+* nothing more.
+*
+* With what the player was told last (`before`), each part is last time's object where it still says the same, and
+* the whole is last time's where every part is and `shared` is what it was made on: the very objects tell the screen
+* and the delta that nothing changed
+*
+* @internal
+*/
+function playerEntityState(view, entity, shared, before) {
+	const { world, player, observer } = view;
+	const was = before?.state;
+	const ally = view.isAlly(entity.owner);
+	let lifetime;
+	if (entity.expires !== null && entity.has(illusion) && ally) {
+		const kept = was?.lifetime;
+		lifetime = kept && kept.left === entity.expires && kept.total === entity.lifetime ? kept : {
+			left: entity.expires,
+			total: entity.lifetime
+		};
+	}
+	let components;
+	let seen;
+	for (const held of entity.heldComponents()) {
+		const { id } = held;
+		const component = world.registry.component(id);
+		const audience = component?.replicate;
+		if (!audience) continue;
+		if (!(audience === "everyone" || (audience === "allies" ? ally : entity.owner === player))) continue;
+		const value = entity.get(held);
+		const kept = was?.components?.[id];
+		let sent;
+		if (component.snapshot) {
+			sent = component.snapshot(value, entity, seen ??= {
+				world,
+				player: observer ? void 0 : player,
+				own: entity.owner === player,
+				ally,
+				observer,
+				knows: view.knows,
+				isAlly: view.isAlly,
+				sees: view.sees
+			});
+			if (sent !== void 0 && kept !== void 0 && same(kept, sent)) sent = kept;
+		} else sent = kept !== void 0 && same(kept, value) ? kept : structuredClone(value);
+		if (sent !== void 0) (components ??= {})[id] = sent;
+	}
+	let buffTimes;
+	let own;
+	if (ally) {
+		const shareBuffTimes = world.settings.hud.shareBuffTimes;
+		if (shareBuffTimes !== void 0 && entity.buffs.length && !shared.buffTimes && ruleOf(world, entity, shareBuffTimes) === "allies") buffTimes = was?.buffTimes && sameBuffTimes(entity, was.buffTimes) ? was.buffTimes : buffTimesOf(entity);
+		own = was?.own && ownStillTold(view, entity, was.own) ? was.own : ownEntityState(view, entity);
+	}
+	if (!lifetime && !components && !buffTimes && !own) return shared;
+	if (was && was !== shared && before.shared === shared && (lifetime ?? shared.lifetime) === was.lifetime && (buffTimes ?? shared.buffTimes) === was.buffTimes && own === was.own && sameParts(components, was.components)) return was;
+	const state = { ...shared };
+	if (lifetime) state.lifetime = lifetime;
+	if (components) state.components = components;
+	if (buffTimes) state.buffTimes = buffTimes;
+	if (own) state.own = own;
+	return state;
+}
+/**
+* Throws when what a player is told of an entity (`state`, kept from before in whole or in part) is not what
+* describing it anew says: a field one of the builders tells and its check forgets. See `debugChecks.snapshots`
+*
+* @internal
+*/
+function checkTold(view, entity, state, name) {
+	const fresh = playerEntityState(view, entity, commonEntityState(view.world, entity, name));
+	const keys = /* @__PURE__ */ new Set([...Object.keys(fresh), ...Object.keys(state)]);
+	for (const key of keys) {
+		if (same(fresh[key], state[key])) continue;
+		throw new Error(`Stale entity state: ${entity.def.id}#${entity.id} for player ${view.player} says ${key} ${JSON.stringify(state[key])}, should be ${JSON.stringify(fresh[key])}`);
+	}
+}
+//#endregion
+export { checkTold, commonEntityState, commonStillTold, hasOnePlayersPart, playerEntityState, sharedStillTold };
+
+//# sourceMappingURL=entityState.js.map

package/dist/session/entityState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityState.js","names":[],"sources":["../../src/session/entityState.ts"],"sourcesContent":["/**\n * What a player is told of an entity (design review E7): what everyone in sight of it is, worked out once a tick for\n * every seat of a host (`commonEntityState`), and on it what is one player's own (`playerEntityState`). A seat\n * (`LocalSession`) puts them in its snapshots.\n *\n * Most of what stands in sight stands as it was told last tick, so what was told is kept (`Entity.told` for\n * everyone's part, the seat's own memory for the player's) and handed back as the very same object while it still\n * says the truth (`commonStillTold`, the own part's checks): the screen and a host's delta tell by the object that\n * nothing changed, and go no further. Each check mirrors its builder field by field; `checkTold` (`debugChecks.snapshots`)\n * catches a field the one tells and the other forgets\n */\nimport { orderSays } from '#engine/orders/facts'\nimport { dashing } from '#engine/dashing'\nimport { illusion } from '#engine/summons'\nimport type { SnapshotView } from '#engine/components'\nimport type { Entity } from '#engine/entity'\nimport type { Vec2 } from '#engine/math'\nimport { declaredRefusal, notReady } from '#engine/orders/cast'\nimport { shieldOf } from '#engine/abilities/buffs'\nimport { recastsLeft } from '#engine/abilities/recast'\nimport { baseStats } from '#engine/defs'\nimport { assertPlainData } from '#engine/debug'\nimport { changedStats } from '#engine/stats'\nimport type { World } from '#engine/world'\nimport type { HudShareRule } from '#engine/rules'\nimport type { SessionView } from '#engine/replication'\nimport { deposit, fighting, moving } from '#engine/entity'\nimport { same } from './delta'\nimport type { AbilityInfo, EntityState, OwnEntityState, SharedAbility } from './protocol'\n\n/** A rule of `RuleSettings.hud` for one unit: its value, or what its function decides */\nconst ruleOf = <T>(world: World, entity: Entity, rule: HudShareRule<T>): T =>\n\ttypeof rule === 'function' ? (rule as (world: World, entity: Entity) => T)(world, entity) : rule\n\n/** The seconds left of one buff as told: -1 for one with no end, or kept up by an aura or a passive */\nconst buffTimeOf = (buff: Entity['buffs'][number]): number => (Number.isFinite(buff.remaining) && !buff.kept ? Math.max(buff.remaining, 0) : -1)\n\n/** The seconds left of a unit's buffs, in their order (`buffTimeOf`) */\nfunction buffTimesOf(entity: Entity): number[] {\n\tconst times = new Array<number>(entity.buffs.length)\n\tfor (let i = 0; i < entity.buffs.length; i++) times[i] = buffTimeOf(entity.buffs[i])\n\treturn times\n}\n\n/** Whether the buff times told are those of the unit's buffs now */\nfunction sameBuffTimes(entity: Entity, times: number[]): boolean {\n\tif (times.length !== entity.buffs.length) return false\n\tfor (let i = 0; i < times.length; i++) if (times[i] !== buffTimeOf(entity.buffs[i])) return false\n\treturn true\n}\n\n/** Whether a unit is camouflaged (`BuffDef.camouflage`, the vision pack: its enemies see it only from near) */\nfunction camouflaged(world: World, entity: Entity): boolean {\n\tif (!entity.buffs.length) return false\n\tfor (const buff of entity.buffs) if (world.registry.buff(buff.id).camouflage !== undefined) return true\n\treturn false\n}\n\n/**\n * What everyone in sight of an entity is told of it this tick, the same for every seat (`EntityState`): where it is,\n * its health and mana, its stats where they changed, its buffs, what the rules share for the plates over it. `name`\n * is what the map calls it, where it has a name. `commonStillTold` mirrors it: a field told here is checked there\n *\n * @internal\n */\nexport function commonEntityState(world: World, entity: Entity, name: string | undefined): EntityState {\n\tconst state: EntityState = {\n\t\tid: entity.id,\n\t\ttype: entity.def.id,\n\t\towner: entity.owner,\n\t\tx: entity.pos.x,\n\t\tz: entity.pos.z,\n\t\tfacing: entity.facing,\n\t\thealth: entity.health,\n\t\tstats: changedStats(world, entity),\n\t\tvisible: true\n\t}\n\tconst base = baseStats(entity.def, world.registry)\n\tif (entity.maxHealth !== base.health) state.maxHealth = entity.maxHealth\n\tif (entity.buffs.length) state.shield = shieldOf(entity) || undefined\n\tconst dash = entity.get(dashing)\n\tif (dash?.height) state.leap = { from: dash.from, to: { x: dash.x, z: dash.z }, height: dash.height }\n\tif (entity.maxMana > 0) {\n\t\tstate.mana = entity.mana\n\t\tif (entity.maxMana !== base.mana) state.maxMana = entity.maxMana\n\t}\n\tif (entity.buffs.length) state.buffs = entity.buffs.map((buff) => buff.id)\n\tfor (const buff of entity.buffs) if (buff.stacks) (state.stacks ??= {})[buff.id] = buff.stacks\n\t// what the game's rules share besides, for the plates over it (indicators-plan U3)\n\tconst { hud } = world.settings\n\tif (hud.shareBuffTimes !== undefined && entity.buffs.length && ruleOf(world, entity, hud.shareBuffTimes) === true)\n\t\tstate.buffTimes = buffTimesOf(entity)\n\tif (hud.shareAbilities !== undefined && entity.abilities.length) {\n\t\tconst share = ruleOf(world, entity, hud.shareAbilities)\n\t\tif (share === 'icons' || share === 'cooldowns') {\n\t\t\tconst abilities: SharedAbility[] = []\n\t\t\tfor (const { id, level, cooldown } of entity.abilities) {\n\t\t\t\tif (level >= 1) abilities.push(share === 'cooldowns' ? { id, level, cooldown } : { id, level })\n\t\t\t}\n\t\t\tif (abilities.length) state.abilities = abilities\n\t\t}\n\t}\n\tif (entity.get(deposit)) state.resource = entity.get(deposit)!.amount\n\tif (entity.on !== undefined) state.on = entity.on\n\tif (entity.asleep) state.asleep = true\n\tif (entity.orders.length) state.busy = true\n\tif (entity.scale !== 1) state.scale = entity.scale\n\tif (entity.look) state.look = entity.look\n\tif (entity.likeness) state.likeness = entity.likeness\n\t// invisible, or camouflaged\n\tif (world.sight.isInvisible(entity) || camouflaged(world, entity)) state.unseen = true\n\tif (name !== undefined) state.name = name\n\t// how long an illusion lasts would give it away: its side alone is told (`describe`)\n\tif (entity.expires !== null && !entity.has(illusion)) state.lifetime = { left: entity.expires, total: entity.lifetime }\n\treturn state\n}\n\n/**\n * Whether what everyone was told of an entity (`state`, made by `commonEntityState`) is still what it would be told\n * now: each field against where the builder reads it, those that change most often first. A field left out here\n * would leave a screen stale: `checkTold` catches that\n *\n * @internal\n */\nexport function commonStillTold(world: World, entity: Entity, state: EntityState, name: string | undefined): boolean {\n\tif (state.x !== entity.pos.x || state.z !== entity.pos.z || state.facing !== entity.facing || state.health !== entity.health) return false\n\tif (state.type !== entity.def.id || state.owner !== entity.owner || state.name !== name) return false\n\t// the same stats are the same object (`changedStats`)\n\tif (state.stats !== changedStats(world, entity)) return false\n\tconst base = baseStats(entity.def, world.registry)\n\tif (state.maxHealth !== (entity.maxHealth !== base.health ? entity.maxHealth : undefined)) return false\n\tif (entity.maxMana > 0) {\n\t\tif (state.mana !== entity.mana || state.maxMana !== (entity.maxMana !== base.mana ? entity.maxMana : undefined)) return false\n\t} else if (state.mana !== undefined) return false\n\tconst { buffs } = entity\n\tif (state.shield !== (buffs.length ? shieldOf(entity) || undefined : undefined)) return false\n\tconst dash = entity.get(dashing)\n\tif (dash?.height) {\n\t\tconst { leap } = state\n\t\tif (\n\t\t\t!leap ||\n\t\t\tleap.from.x !== dash.from.x ||\n\t\t\tleap.from.z !== dash.from.z ||\n\t\t\tleap.to.x !== dash.x ||\n\t\t\tleap.to.z !== dash.z ||\n\t\t\tleap.height !== dash.height\n\t\t)\n\t\t\treturn false\n\t} else if (state.leap) return false\n\tif (buffs.length) {\n\t\tconst ids = state.buffs\n\t\tif (!ids || ids.length !== buffs.length) return false\n\t\tlet stacked = 0\n\t\tfor (let i = 0; i < buffs.length; i++) {\n\t\t\tconst buff = buffs[i]\n\t\t\tif (ids[i] !== buff.id) return false\n\t\t\tif (buff.stacks) {\n\t\t\t\tstacked++\n\t\t\t\tif (state.stacks?.[buff.id] !== buff.stacks) return false\n\t\t\t}\n\t\t}\n\t\t// a stack count that fell to nothing leaves its key behind: it would be told still\n\t\tif (stacked === 0 ? state.stacks !== undefined : !state.stacks || Object.keys(state.stacks).length > stacked) return false\n\t} else if (state.buffs || state.stacks) return false\n\tconst { hud } = world.settings\n\tif (hud.shareBuffTimes !== undefined && buffs.length && ruleOf(world, entity, hud.shareBuffTimes) === true) {\n\t\tif (!state.buffTimes || !sameBuffTimes(entity, state.buffTimes)) return false\n\t} else if (state.buffTimes) return false\n\tconst share = hud.shareAbilities !== undefined && entity.abilities.length ? ruleOf(world, entity, hud.shareAbilities) : undefined\n\tif (share === 'icons' || share === 'cooldowns') {\n\t\tconst told = state.abilities\n\t\tlet n = 0\n\t\tfor (const { id, level, cooldown } of entity.abilities) {\n\t\t\tif (level < 1) continue\n\t\t\tconst ability = told?.[n++]\n\t\t\tif (!ability || ability.id !== id || ability.level !== level || ability.cooldown !== (share === 'cooldowns' ? cooldown : undefined))\n\t\t\t\treturn false\n\t\t}\n\t\tif ((told?.length ?? 0) !== n) return false\n\t} else if (state.abilities) return false\n\tif (state.resource !== entity.get(deposit)?.amount) return false\n\tif (state.on !== entity.on || state.asleep !== (entity.asleep || undefined) || state.busy !== (entity.orders.length ? true : undefined))\n\t\treturn false\n\tif (\n\t\tstate.scale !== (entity.scale !== 1 ? entity.scale : undefined) ||\n\t\tstate.look !== (entity.look || undefined) ||\n\t\tstate.likeness !== (entity.likeness || undefined)\n\t)\n\t\treturn false\n\tif (state.unseen !== (world.sight.isInvisible(entity) || camouflaged(world, entity) || undefined)) return false\n\tif (entity.expires !== null && !entity.has(illusion)) {\n\t\tif (!state.lifetime || state.lifetime.left !== entity.expires || state.lifetime.total !== entity.lifetime) return false\n\t} else if (state.lifetime) return false\n\treturn true\n}\n\n/**\n * Whether an entity has a component replicated to its owner, or shaping itself for each player (`Component.snapshot`)\n *\n * @internal\n */\nexport function hasOnePlayersPart(world: World, entity: Entity): boolean {\n\tfor (const held of entity.heldComponents()) {\n\t\tconst component = world.registry.component(held.id)\n\t\tif (component?.replicate === 'owner' || (component?.replicate && component.snapshot)) return true\n\t}\n\treturn false\n}\n\n/**\n * What a player was told of an entity last (`playerEntityState`): the whole of it, and what everyone was told that\n * it was made on. A seat keeps one per entity it described\n *\n * @internal\n */\nexport interface Told {\n\tshared: EntityState\n\tstate: EntityState\n}\n\n/** Whether the control of another's unit is shared with the player: its owner lets them command it */\nconst commands = (view: SessionView, entity: Entity): boolean =>\n\tentity.owner !== view.player && !view.observer && view.world.mayCommand(view.player, entity)\n\n/** Where the orders queued after the first go: a known target's place, or the point given. None for the orders of no place */\nfunction eachWaypoint(view: SessionView, entity: Entity, each: (point: Readonly<Vec2>) => void): void {\n\tfor (let i = 1; i < entity.orders.length; i++) {\n\t\tconst order = entity.orders[i]\n\t\tconst target = view.world.get(order.init.target)\n\t\tconst point = target && view.knows(target) ? target.pos : order.init.point\n\t\tif (point) each(point)\n\t}\n}\n\n/**\n * What its side is told of a unit of theirs (`OwnEntityState`): its orders, where it goes, its abilities for the\n * command card. `ownStillTold` mirrors it\n */\nfunction ownEntityState(view: SessionView, entity: Entity): OwnEntityState {\n\tconst { world } = view\n\tconst m = entity.get(moving)\n\t// the places of the orders queued after the first: none made for a unit with nothing queued, most of them (RV87)\n\tlet waypoints: Vec2[] | undefined\n\teachWaypoint(view, entity, (point) => (waypoints ??= []).push({ x: point.x, z: point.z }))\n\tconst own: OwnEntityState = {\n\t\t// another's that this player may command: its owner shares control with them\n\t\t...(commands(view, entity) && { shared: true }),\n\t\thidden: entity.hidden,\n\t\torder: entity.orders[0]?.type ?? null,\n\t\t// on its way to build it: once the site is down, what it builds is there to be counted itself\n\t\tbuild: entity.orders[0]?.type === 'build' && !orderSays(world, entity, 'building') ? entity.orders[0].init.unitType : undefined,\n\t\torders: entity.orders.length,\n\t\tpassive: entity.get(fighting)?.passive ?? false,\n\t\tfighting: !!entity.get(fighting)?.autoTarget,\n\t\tgoal: m?.status === 'moving' ? { x: m.navGoal.x, z: m.navGoal.z } : undefined,\n\t\t...(waypoints && { waypoints })\n\t}\n\tif (entity.abilities.length) {\n\t\tconst hooked = world.hooks.has('canCast')\n\t\town.abilities = entity.abilities.map(({ id, level, cooldown, charges, refill, autocast, data, recast }) => {\n\t\t\tconst info: AbilityInfo = { id, level, cooldown, autocast }\n\t\t\tif (charges !== undefined) Object.assign(info, { charges, refill })\n\t\t\t// its window to be cast again (AB8): what is left of it, and of its recasts\n\t\t\tif (recast) info.recast = { left: recast.left, total: recast.total, count: recastsLeft(world.registry.ability(id), recast) }\n\t\t\tif (data) {\n\t\t\t\tif (world.checks.events) assertPlainData(data, `Ability \"${id}\" of ${entity.def.id}#${entity.id}: its data`)\n\t\t\t\t// a copy: the game changes its own in place, and what was told before is kept to be told only what changed\n\t\t\t\tinfo.data = structuredClone(data)\n\t\t\t}\n\t\t\tif (!hooked || level < 1) return info\n\t\t\t// what the game's hook decides, where the screen could not work it out from what is declared\n\t\t\tconst ability = world.registry.ability(id)\n\t\t\tconst declared = declaredRefusal(world, entity, ability)\n\t\t\tconst decided = notReady(world, entity, ability)\n\t\t\tif (declared?.key !== decided?.key) info.decided = decided ?? null\n\t\t\treturn info\n\t\t})\n\t}\n\treturn own\n}\n\n/** Whether the abilities a side was told of its unit (`ownEntityState`) are still what it would be told */\nfunction abilitiesStillTold(view: SessionView, entity: Entity, told: AbilityInfo[] | undefined): boolean {\n\tconst { world } = view\n\tif (!entity.abilities.length) return told === undefined\n\tif (!told || told.length !== entity.abilities.length) return false\n\tconst hooked = world.hooks.has('canCast')\n\tfor (let i = 0; i < told.length; i++) {\n\t\tconst info = told[i]\n\t\tconst { id, level, cooldown, charges, refill, autocast, data, recast } = entity.abilities[i]\n\t\tif (info.id !== id || info.level !== level || info.cooldown !== cooldown || info.autocast !== autocast) return false\n\t\tif (charges !== undefined ? info.charges !== charges || info.refill !== refill : info.charges !== undefined) return false\n\t\tif (recast) {\n\t\t\tconst r = info.recast\n\t\t\tif (!r || r.left !== recast.left || r.total !== recast.total || r.count !== recastsLeft(world.registry.ability(id), recast)) return false\n\t\t} else if (info.recast) return false\n\t\tif (data ? !info.data || !same(info.data, data) : info.data) return false\n\t\tif (hooked && level >= 1) {\n\t\t\tconst ability = world.registry.ability(id)\n\t\t\tconst declared = declaredRefusal(world, entity, ability)\n\t\t\tconst decided = notReady(world, entity, ability)\n\t\t\tif (!same(info.decided, declared?.key !== decided?.key ? (decided ?? null) : undefined)) return false\n\t\t} else if (info.decided !== undefined) return false\n\t}\n\treturn true\n}\n\n/** Whether what a side was told of its unit (`ownEntityState`) is still what it would be told: each field against where the builder reads it */\nfunction ownStillTold(view: SessionView, entity: Entity, own: OwnEntityState): boolean {\n\tconst { world } = view\n\tconst first = entity.orders[0]\n\tif (own.orders !== entity.orders.length || own.order !== (first?.type ?? null) || own.hidden !== entity.hidden) return false\n\tif (own.shared !== (commands(view, entity) || undefined)) return false\n\tif (own.build !== (first?.type === 'build' && !orderSays(world, entity, 'building') ? first.init.unitType : undefined)) return false\n\tconst fight = entity.get(fighting)\n\tif (own.passive !== (fight?.passive ?? false) || own.fighting !== !!fight?.autoTarget) return false\n\tconst m = entity.get(moving)\n\tif (m?.status === 'moving') {\n\t\tif (!own.goal || own.goal.x !== m.navGoal.x || own.goal.z !== m.navGoal.z) return false\n\t} else if (own.goal) return false\n\tlet n = 0\n\tlet waypointsHold = true\n\teachWaypoint(view, entity, (point) => {\n\t\tconst way = own.waypoints?.[n++]\n\t\tif (!way || way.x !== point.x || way.z !== point.z) waypointsHold = false\n\t})\n\tif (!waypointsHold || (own.waypoints?.length ?? 0) !== n) return false\n\treturn abilitiesStillTold(view, entity, own.abilities)\n}\n\n/**\n * Whether what was told of a structure's components (`state.components`) is what they hold now: what lets a tree's or\n * a mine's description be said again as it is (`LocalSession.see`). Components told to everyone as they are are\n * compared; one shaped for each player (`snapshot`), or told to some alone, has it described anew. True for what holds\n * none told, which is nearly every tree\n *\n * @internal\n */\nexport function sharedStillTold(entity: Entity, state: EntityState): boolean {\n\tconst told = state.components\n\tlet count = 0\n\tfor (const held of entity.heldComponents()) {\n\t\tif (!held.replicate) continue\n\t\tif (held.replicate !== 'everyone' || held.snapshot) return false\n\t\tconst was = told?.[held.id]\n\t\tif (was === undefined || !same(was, entity.get(held))) return false\n\t\tcount++\n\t}\n\treturn !told || Object.keys(told).length === count\n}\n\n/** Whether two sets of components' parts are the very same objects under the same ids */\nfunction sameParts(a: Record<string, unknown> | undefined, b: Record<string, unknown> | undefined): boolean {\n\tif (a === b) return true\n\tif (!a || !b) return false\n\tfor (const id in a) if (a[id] !== b[id]) return false\n\tfor (const id in b) if (!(id in a)) return false\n\treturn true\n}\n\n/**\n * What one player is told of an entity, on what everyone is (`shared`, `commonEntityState`): an illusion's lifetime on\n * its own side, the components replicated to the player and what they make of themselves for them, and its own part\n * (`own`: its orders, where it goes, its abilities) for one of the player's side. `shared` itself where there is\n * nothing more.\n *\n * With what the player was told last (`before`), each part is last time's object where it still says the same, and\n * the whole is last time's where every part is and `shared` is what it was made on: the very objects tell the screen\n * and the delta that nothing changed\n *\n * @internal\n */\nexport function playerEntityState(view: SessionView, entity: Entity, shared: EntityState, before?: Told): EntityState {\n\tconst { world, player, observer } = view\n\tconst was = before?.state\n\tconst ally = view.isAlly(entity.owner)\n\tlet lifetime: EntityState['lifetime']\n\tif (entity.expires !== null && entity.has(illusion) && ally) {\n\t\tconst kept = was?.lifetime\n\t\tlifetime = kept && kept.left === entity.expires && kept.total === entity.lifetime ? kept : { left: entity.expires, total: entity.lifetime }\n\t}\n\tlet components: Record<string, unknown> | undefined\n\tlet seen: SnapshotView | undefined\n\tfor (const held of entity.heldComponents()) {\n\t\tconst { id } = held\n\t\tconst component = world.registry.component(id)\n\t\tconst audience = component?.replicate\n\t\tif (!audience) continue\n\t\tif (!(audience === 'everyone' || (audience === 'allies' ? ally : entity.owner === player))) continue\n\t\t// what the component makes of it for this player, or a copy: what is sent must not change with the world, nor change it\n\t\tconst value = entity.get(held)\n\t\tconst kept = was?.components?.[id]\n\t\tlet sent: unknown\n\t\tif (component!.snapshot) {\n\t\t\tsent = component!.snapshot(\n\t\t\t\tvalue,\n\t\t\t\tentity,\n\t\t\t\t(seen ??= {\n\t\t\t\t\tworld,\n\t\t\t\t\tplayer: observer ? undefined : player,\n\t\t\t\t\town: entity.owner === player,\n\t\t\t\t\tally,\n\t\t\t\t\tobserver: observer,\n\t\t\t\t\tknows: view.knows,\n\t\t\t\t\tisAlly: view.isAlly,\n\t\t\t\t\tsees: view.sees\n\t\t\t\t})\n\t\t\t)\n\t\t\t// what it made is what it made last time: last time's. As data, not as the component's `same` sees it, which is\n\t\t\t// the wire's coarser judgment (a progress to hundredths): a screen in the page is told what a fresh one would be\n\t\t\tif (sent !== undefined && kept !== undefined && same(kept, sent)) sent = kept\n\t\t} else sent = kept !== undefined && same(kept, value) ? kept : structuredClone(value)\n\t\tif (sent !== undefined) (components ??= {})[id] = sent\n\t}\n\tlet buffTimes: number[] | undefined\n\tlet own: OwnEntityState | undefined\n\tif (ally) {\n\t\tconst shareBuffTimes = world.settings.hud.shareBuffTimes\n\t\tif (shareBuffTimes !== undefined && entity.buffs.length && !shared.buffTimes && ruleOf(world, entity, shareBuffTimes) === 'allies')\n\t\t\tbuffTimes = was?.buffTimes && sameBuffTimes(entity, was.buffTimes) ? was.buffTimes : buffTimesOf(entity)\n\t\town = was?.own && ownStillTold(view, entity, was.own) ? was.own : ownEntityState(view, entity)\n\t}\n\tif (!lifetime && !components && !buffTimes && !own) return shared\n\t// (a part not the player's is `shared`'s own, copied: last time's copy has the same)\n\tif (\n\t\twas &&\n\t\twas !== shared &&\n\t\tbefore!.shared === shared &&\n\t\t(lifetime ?? shared.lifetime) === was.lifetime &&\n\t\t(buffTimes ?? shared.buffTimes) === was.buffTimes &&\n\t\town === was.own &&\n\t\tsameParts(components, was.components)\n\t)\n\t\treturn was\n\tconst state: EntityState = { ...shared }\n\tif (lifetime) state.lifetime = lifetime\n\tif (components) state.components = components\n\tif (buffTimes) state.buffTimes = buffTimes\n\tif (own) state.own = own\n\treturn state\n}\n\n/**\n * Throws when what a player is told of an entity (`state`, kept from before in whole or in part) is not what\n * describing it anew says: a field one of the builders tells and its check forgets. See `debugChecks.snapshots`\n *\n * @internal\n */\nexport function checkTold(view: SessionView, entity: Entity, state: EntityState, name: string | undefined): void {\n\tconst fresh = playerEntityState(view, entity, commonEntityState(view.world, entity, name))\n\tconst keys = new Set([...Object.keys(fresh), ...Object.keys(state)]) as Set<keyof EntityState>\n\tfor (const key of keys) {\n\t\tif (same(fresh[key], state[key])) continue\n\t\tthrow new Error(\n\t\t\t`Stale entity state: ${entity.def.id}#${entity.id} for player ${view.player} says ${key} ${JSON.stringify(state[key])}, should be ${JSON.stringify(fresh[key])}`\n\t\t)\n\t}\n}\n"],"mappings":"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"}

package/dist/session/local.d.ts

@@ -1,8 +1,9 @@
 import type { Logger } from '#engine/log';
 import type { MapCamera, MapDoodad, MapEnvironment, MapPath, MapRegion } from '#engine/map';
 import { type Lane } from '#engine/lanes';
-import type { PlayerId } from '#engine/entity';
+import type { EntityId, PlayerId } from '#engine/entity';
 import type { Vec2 } from '#engine/math';
+import { type FormationUnit } from '#engine/formation';
 import type { Registry } from '#engine/registry';
 import type { Terrain } from '#engine/terrain';
 import type { World } from '#engine/world';
@@ -19,19 +20,33 @@ import { SessionView } from '#engine/replication';
  * @beta
  */
 export declare const COMPUTER_EVENTS: ReadonlySet<SessionEvent['type']>;
-/** @beta */
+/**
+ * A `GameSession` over a world in the same process: steps it from real time, takes a player's snapshots of it and sends their commands into it
+ *
+ * @beta
+ */
 export declare class LocalSession implements GameSession {
     /** For tools and tests. Clients have no business here, they go through the session */
     readonly world: World;
+    /** The player whose seat this is, from whose side the snapshots are taken */
     readonly playerId: PlayerId;
+    /** The ground of the world, for the client to draw and ask about */
     readonly terrain: Terrain;
+    /** The map's look (sky, mist, light), when the world was made from a map that has one */
     readonly environment?: MapEnvironment;
+    /** The map's scenery objects, which have no life at runtime */
     readonly doodads: readonly MapDoodad[];
+    /** The map's named regions */
     readonly regions: readonly MapRegion[];
+    /** The map's named camera positions */
     readonly cameras: readonly MapCamera[];
+    /** The map's named paths */
     readonly paths: readonly MapPath[];
+    /** The definitions of the game the world runs: unit types, abilities, orders and the rest */
     readonly registry: Registry;
+    /** Simulation ticks per second of the world */
     readonly tickRate: number;
+    /** How far, 0..1, the time is between the last tick and the next, for the client to blend its drawing by; 1 when paused */
     alpha: number;
     /** What the world says (`World.log`): a session in the page has it, and the client shows it with its own */
     get log(): Logger;
@@ -52,10 +67,12 @@ export declare class LocalSession implements GameSession {
     private readonly namesNow;
     private readonly disposers;
     private pendingCheckpoint?;
+    /** The label and save taken at the last tick that a checkpoint was asked for, for the game to be taken back to */
     checkpoint?: {
         label: Message;
         save: WorldSave;
     };
+    /** The debug tools over this session's world */
     readonly debug: LocalDebug;
     /** Its pace, saves of its world, the debug tools' view, and what a computer player's brain reads (`SessionCan`) */
     readonly can: SessionCan;
@@ -73,7 +90,9 @@ export declare class LocalSession implements GameSession {
     readonly view: SessionView;
     constructor(
     /** For tools and tests. Clients have no business here, they go through the session */
-    world: World, playerId: PlayerId, 
+    world: World, 
+    /** The player whose seat this is, from whose side the snapshots are taken */
+    playerId: PlayerId, 
     /**
      * `debug`: the player may use the debug commands (see `world.debugPlayers`). `ownsWorld`: the world is the
      * session's, and goes with it (`dispose`): for a game played in the page, where the session is all the screen
@@ -103,10 +122,23 @@ export declare class LocalSession implements GameSession {
      * the sessions of a world while a host's round of sending is on (`shareCaptures`), else for this session alone
      */
     private common;
+    /**
+     * What this player was told of each entity last (`Told`), to be told again while it holds (`tell`): with the entity,
+     * gone with it
+     */
+    private readonly told;
     /**
      * What this player is told of an entity: what everyone is (`common`, shared between the seats of a host), and on a
      * copy of it what is this player's to know: an illusion's lifetime on its own side, the components replicated to it
-     * and what they make of themselves for it, and its own part (`own`) for an ally's
+     * and what they make of themselves for it, and its own part (`own`) for an ally's. Last time's objects wherever
+     * nothing changed (`playerEntityState`)
+     */
+    private tell;
+    /** Remembers what the player was told of an entity (`told`) */
+    private keep;
+    /**
+     * What this player is told of an entity (`tell`), once for the seats of a side told the same while a host's round
+     * of sending is on (`Round.sides`): the side's object, which this seat remembers as its own, is this seat's too
      */
     private describe;
     /**
@@ -152,8 +184,9 @@ export declare class LocalSession implements GameSession {
      * described again for them. The side's memory is the first seat's to keep
      */
     private seeAsSide;
-    /** The rest of a snapshot, round its entities: the players, and every feature's part (`SnapshotPart`) */
+    /** The rest of a snapshot, round its entities: the players, and every feature's part (`SnapshotField`) */
     private finish;
+    /** Takes a snapshot of the world as the seat sees it now, without stepping */
     snapshot(): Snapshot;
     /**
      * Moves the game on by `ticks` at the next update, however fast it goes: a step of a paused game (`speed` 0), as
@@ -183,6 +216,7 @@ export declare class LocalSession implements GameSession {
     private ranOn;
     /** A tick of the world, and the checkpoint it marked saved as the world stood at its end, not at the end of the frame */
     private tickOnce;
+    /** Adds `dt` real seconds (scaled by `speed`) and steps the world one tick for each tick's worth; returns a snapshot of how it stands after, or none when nothing happened */
     update(dt: number): Snapshot[];
     /** Sends a command. `seq` is the sender's own number for it, for a host passing on what a remote player numbered */
     send(command: PlayerCommand, seq?: number): number;
@@ -193,6 +227,7 @@ export declare class LocalSession implements GameSession {
      * @beta
      */
     lastSeq: number;
+    /** The seat's team's fog as cells, visible and explored */
     fog(): FogState;
     /** Where the game's money is mined, as the map shows it, seen or not (`GameSession.mines`, `minesFor`) */
     mines(): readonly MineInfo[];
@@ -200,9 +235,15 @@ export declare class LocalSession implements GameSession {
     lanes(): readonly Lane[];
     /** The camps as the player knows them (`GameSession.camps`, `campsFor`): worked out once a tick */
     camps(): readonly CampInfo[];
+    /** Whether the player could place a building of this type at the point now, seen as their team sees the ground */
     canPlace(unitType: string, point: Vec2): boolean;
     /** Which cells of a building's ground are in the way for the player: taken, or not explored by their team (`placementCells`) */
     placeCells(unitType: string, point: Vec2): readonly boolean[] | undefined;
+    /** Where a group would stand sent to a point in a formation, the rules' own pick when none is named (`GameSession.formationPlaces`) */
+    formationPlaces(units: readonly (FormationUnit & {
+        readonly flying?: boolean;
+    })[], point: Vec2, facing?: number, formation?: string): Map<EntityId, Vec2>;
+    /** A path between two points on the ground, or in the air when `flying`; null when there is none */
     findPath(from: Vec2, to: Vec2, flying?: boolean): Vec2[] | null;
     /** What happened since the last snapshot, not yet given in one: a copy, for a computer's save */
     pendingEvents(): SessionEvent[];
@@ -210,5 +251,6 @@ export declare class LocalSession implements GameSession {
     restoreEvents(events: readonly SessionEvent[]): void;
     /** Whether the world goes with the session */
     private readonly ownsWorld;
+    /** Stops the session's listeners and debug tools, and the world too when the session owns it */
     dispose(): void;
 }