@v12-engine/engine 0.1.0 → 0.4.0

package/dist/inspect.d.ts

@@ -8,6 +8,7 @@ import type { World } from './world';
  * @beta
  */
 export interface InspectedSection {
+    /** The heading of the section in the inspector, such as `stats` or a component's name */
     title: string;
     /** What it holds, plain data. Entities in it are written `footman#12`, for the inspector to link to */
     value: unknown;
@@ -34,17 +35,21 @@ export type InspectTarget = {
  * @beta
  */
 export interface Inspection {
+    /** What is inspected: an entity by id, a player by id, or the world itself */
     target: InspectTarget;
     /** What it is called: `Footman #14`, a player's name, `World` */
     title: string;
     /** What else says what it is: type and owner, team */
     about: string;
+    /** The tick of the simulation the inspection was taken at */
     tick: number;
+    /** Whether the inspected entity or player is still there; false once it has been removed or defeated */
     alive: boolean;
     /** Where it is, for an entity */
     at?: Vec2;
     /** What is so of it that is not a number: hidden, asleep, scenery */
     flags: string[];
+    /** The parts of it the inspector lists, in order */
     sections: InspectedSection[];
     /**
      * What the computer that plays a player is thinking, where a brain does (`Brain.report`, with the seat's timing):
@@ -64,16 +69,25 @@ export declare function inspect(world: World, target: InspectTarget): Inspection
  * @beta
  */
 export interface EntityRow {
+    /** The entity's id */
     id: EntityId;
+    /** The id of the entity's unit type */
     type: string;
+    /** The entity's display name */
     name: string;
+    /** The player that owns it */
     owner: PlayerId;
+    /** What kind of thing it is: `unit`, `building` or `resource` */
     kind: string;
-    hp: number;
-    maxHp: number;
+    /** Its health now */
+    health: number;
+    /** Its largest health */
+    maxHealth: number;
     /** Type of what it is doing, null for nothing */
     order: string | null;
+    /** Whether it is scenery, kept out of play and shown as ground dressing */
     scenery: boolean;
+    /** Whether it is hidden from the players */
     hidden: boolean;
 }
 /**
@@ -82,10 +96,15 @@ export interface EntityRow {
  * @beta
  */
 export interface PlayerRow {
+    /** The player's id */
     id: PlayerId;
+    /** The player's name */
     name: string;
+    /** The team the player is on */
     team: number;
+    /** Whether it is a neutral player (creeps and the like), not one of the sides */
     neutral: boolean;
+    /** Whether the player has lost the game */
     defeated: boolean;
 }
 /**
@@ -94,8 +113,11 @@ export interface PlayerRow {
  * @beta
  */
 export interface WorldListing {
+    /** The tick of the simulation the listing was taken at */
     tick: number;
+    /** Every player of the world, as `PlayerRow` */
     players: PlayerRow[];
+    /** Every entity of the world, as `EntityRow`, hidden and scenery ones too */
     entities: EntityRow[];
 }
 /**
@@ -108,6 +130,7 @@ export interface LoggedEvent {
     seq: number;
     /** The tick it happened in */
     tick: number;
+    /** Whether it is an engine `event` or a `hook` */
     kind: 'event' | 'hook';
     /** The engine's name for it, or a game's id */
     name: string;
@@ -163,12 +186,16 @@ export declare class EventLog implements Trace {
     attach(world: World): void;
     /** Stops following it. What was logged stays */
     detach(): void;
+    /** Whether the log is attached to a world, following what happens in it */
     get attached(): boolean;
     /** What was logged, oldest first. The same list, kept up to date: to read, not to keep */
     get entries(): readonly LoggedEvent[];
+    /** Empties the log and the hooks it is counting for the current tick */
     clear(): void;
     private event;
+    /** Notes that the listener with this id ran on the event going out; part of `Trace` */
     listener(id: string): void;
+    /** Notes that the hook ran, with the ids of its handlers and whether it is a game's own; a hook run again in the same tick only adds to its count */
     hook(name: string, handlers: readonly {
         id: string;
     }[], own: boolean, event: unknown): void;

package/dist/{inspect-D9dWHmZ0.js → inspect.js}

@@ -1,4 +1,9 @@
-import { cl as fighting, id as isGameEvent, ll as moving, nl as Entity, pd as statsOf, rl as deposit, ro as dashing, wc as productionOf, zi as harvesterOf } from "./debugCommands-CzjrSm66.js";
+import { statsOf } from "./stats.js";
+import { isGameEvent } from "./events.js";
+import { Entity, deposit, fighting, moving } from "./entity.js";
+import { productionOf } from "./systems/productionQueue.js";
+import { dashing } from "./dashing.js";
+import { harvesterOf } from "./orders/harvest.js";
 //#region src/inspect.ts
 /**
 * What the debug tools see of the rules: everything in the world (`listWorld`), an entity, a player or the world as the
@@ -52,8 +57,8 @@ var PART_COMPONENTS = {
 };
 /** The numbers of an entity of its own, not in a part */
 var OWN_NUMBERS = [
-	"hp",
-	"maxHp",
+	"health",
+	"maxHealth",
 	"mana",
 	"maxMana",
 	"facing",
@@ -102,7 +107,7 @@ function relationsOf(world, entity) {
 	add("rallies to", productionOf(entity)?.rally?.target);
 	for (const buff of entity.buffs) add(`buff ${buff.id} from`, buff.source);
 	let after = 0;
-	for (const other of world.actors.values()) {
+	for (const other of world.units.values()) {
 		if (other === entity || !other.alive) continue;
 		if (other.orders[0]?.init.target === entity.id || other.get(fighting)?.autoTarget === entity.id) {
 			if (++after > 8) break;
@@ -254,7 +259,7 @@ function inspectWorld(world) {
 				hour: world.registry.day ? world.hour : void 0,
 				winner: world.winner,
 				entities: world.entities.size,
-				actors: world.actors.size,
+				actors: world.units.size,
 				projectiles: world.projectiles.length,
 				missiles: world.missiles.length,
 				items: world.items.length
@@ -301,7 +306,7 @@ function holderOf(root, path) {
 	return holder;
 }
 /**
-* Changes a number where `inspect` showed it: of an entity `['hp']`, `['abilities', 0, 'cooldown']`,
+* Changes a number where `inspect` showed it: of an entity `['health']`, `['abilities', 0, 'cooldown']`,
 * `['components', 'td.bounty', 'gold']`; of a player `['resources', 'gold']`, `['upgrades', 'armor']`,
 * `['state', 'td.score', 'kills']`; of the world `['state', 'td.waves', 'wave']`. An entity's health is kept within what
 * it can have, and none left kills it. Whether it was changed: false for what is not a number or a switch (a boolean), or not to be changed
@@ -336,12 +341,12 @@ function setInspected(world, target, path, value) {
 	if (!entity?.alive || !EDITABLE.has(String(path[0]))) return false;
 	const holder = holderOf(entity, path);
 	if (!holder || typeof holder[last] !== typeof value) return false;
-	if (typeof value === "number" && path.length === 1 && last === "hp") {
+	if (typeof value === "number" && path.length === 1 && last === "health") {
 		if (value <= 0) {
 			world.kill(entity);
 			return true;
 		}
-		value = Math.min(value, entity.maxHp);
+		value = Math.min(value, entity.maxHealth);
 	}
 	if (typeof value === "number" && path.length === 1 && last === "mana") value = Math.max(0, Math.min(value, entity.maxMana));
 	holder[last] = value;
@@ -363,8 +368,8 @@ function listWorld(world) {
 			name: entity.def.name,
 			owner: entity.owner,
 			kind: entity.def.kind,
-			hp: Math.ceil(entity.hp),
-			maxHp: Math.ceil(entity.maxHp),
+			health: Math.ceil(entity.health),
+			maxHealth: Math.ceil(entity.maxHealth),
 			order: entity.orders[0]?.type ?? null,
 			scenery: entity.scenery,
 			hidden: entity.hidden
@@ -423,6 +428,7 @@ var EventLog = class {
 		this.world = null;
 		this.current = null;
 	}
+	/** Whether the log is attached to a world, following what happens in it */
 	get attached() {
 		return this.world !== null;
 	}
@@ -430,6 +436,7 @@ var EventLog = class {
 	get entries() {
 		return this.list;
 	}
+	/** Empties the log and the hooks it is counting for the current tick */
 	clear() {
 		this.list.length = 0;
 		this.hooks.clear();
@@ -447,9 +454,11 @@ var EventLog = class {
 			ran: []
 		});
 	}
+	/** Notes that the listener with this id ran on the event going out; part of `Trace` */
 	listener(id) {
 		this.current?.ran.push(id);
 	}
+	/** Notes that the hook ran, with the ids of its handlers and whether it is a game's own; a hook run again in the same tick only adds to its count */
 	hook(name, handlers, own, event) {
 		const { tick } = this.world;
 		if (tick !== this.hooksAt) {
@@ -486,6 +495,6 @@ var EventLog = class {
 	}
 };
 //#endregion
-export { summarize as a, setInspected as i, inspect as n, listWorld as r, EventLog as t };
+export { EventLog, inspect, listWorld, setInspected, summarize };
 
-//# sourceMappingURL=inspect-D9dWHmZ0.js.map
+//# sourceMappingURL=inspect.js.map

package/dist/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","names":[],"sources":["../src/inspect.ts"],"sourcesContent":["import { harvesterOf } from './orders/harvest'\nimport { dashing } from './dashing'\nimport { productionOf } from './systems/productionQueue'\nimport { deposit, Entity, type EntityId, fighting, moving, type PlayerId } from './entity'\nimport { isGameEvent } from './events'\nimport type { AiReport } from './ai/report'\nimport type { Vec2 } from './math'\nimport { statsOf } from './stats'\nimport type { World } from './world'\n\n/**\n * What the debug tools see of the rules: everything in the world (`listWorld`), an entity, a player or the world as the\n * rules have it (`inspect`), a number of it changed (`setInspected`), and the events and hooks of the last seconds\n * (`EventLog`). Everything they give is plain data,\n * so that it can come from a simulation that runs somewhere else, the way the snapshots do\n */\n\n/**\n * A value as plain data, to be shown: entities become `footman#12`, definitions their id, numbers are rounded, and\n * what is deep or long is cut short\n *\n * @internal\n */\nexport function summarize(value: unknown, depth = 0): unknown {\n\tif (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean') return value\n\tif (typeof value === 'number') return Number.isInteger(value) || !Number.isFinite(value) ? value : Math.round(value * 1000) / 1000\n\tif (typeof value === 'function') return undefined\n\tif (typeof value !== 'object') return String(value)\n\tif (value instanceof Entity) return `${value.def.id}#${value.id}`\n\tif (value instanceof Map || value instanceof Set) return `${value.constructor.name}(${value.size})`\n\tif (ArrayBuffer.isView(value)) return `${value.constructor.name}(${(value as unknown as ArrayLike<number>).length})`\n\tif (Array.isArray(value)) {\n\t\tif (depth > 3) return `[${value.length}]`\n\t\tconst items = value.slice(0, 12).map((item) => summarize(item, depth + 1))\n\t\tif (value.length > 12) items.push(`… ${value.length - 12} more`)\n\t\treturn items\n\t}\n\tconst record = value as Record<string, unknown>\n\tconst plain = Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null\n\t// what is inside something else and has an id of its own is said by that id: a definition, a projectile\n\tif (depth > 0 && typeof record.id === 'string' && (!plain || 'name' in record)) return record.id\n\tif (depth > 0 && typeof record.id === 'number' && !plain) return `${value.constructor.name.toLowerCase()} ${record.id}`\n\tif (depth > 3) return '{…}'\n\tconst out: Record<string, unknown> = {}\n\tfor (const key in record) {\n\t\tconst item = summarize(record[key], depth + 1)\n\t\tif (item !== undefined) out[key] = item\n\t}\n\treturn out\n}\n\n/**\n * A part of what is inspected, as the inspector shows it\n *\n * @beta\n */\nexport interface InspectedSection {\n\t/** The heading of the section in the inspector, such as `stats` or a component's name */\n\ttitle: string\n\t/** What it holds, plain data. Entities in it are written `footman#12`, for the inspector to link to */\n\tvalue: unknown\n\t/** Where it is kept, for `setInspected`. Left out for what is worked out, or not to be changed by hand, like stats */\n\tpath?: (string | number)[]\n\t/** State of the game's own (a component), rather than the engine's */\n\town?: boolean\n}\n\n/**\n * What the inspector can look at: an entity, a player, or the world itself\n *\n * @beta\n */\nexport type InspectTarget = { entity: EntityId } | { player: PlayerId } | { world: true }\n\n/**\n * Something as the simulation has it, for the inspector\n *\n * @beta\n */\nexport interface Inspection {\n\t/** What is inspected: an entity by id, a player by id, or the world itself */\n\ttarget: InspectTarget\n\t/** What it is called: `Footman #14`, a player's name, `World` */\n\ttitle: string\n\t/** What else says what it is: type and owner, team */\n\tabout: string\n\t/** The tick of the simulation the inspection was taken at */\n\ttick: number\n\t/** Whether the inspected entity or player is still there; false once it has been removed or defeated */\n\talive: boolean\n\t/** Where it is, for an entity */\n\tat?: Vec2\n\t/** What is so of it that is not a number: hidden, asleep, scenery */\n\tflags: string[]\n\t/** The parts of it the inspector lists, in order */\n\tsections: InspectedSection[]\n\t/**\n\t * What the computer that plays a player is thinking, where a brain does (`Brain.report`, with the seat's timing):\n\t * what the debug panel's AI tab draws. A computer player of another kind is a section (`Computer player`)\n\t */\n\tai?: AiReport\n}\n\n/** The parts of an entity the engine keeps, by field, with what the inspector calls them */\nconst PARTS: [keyof Entity, string][] = [\n\t['orders', 'Orders'],\n\t['abilities', 'Abilities'],\n\t['buffs', 'Buffs']\n]\n\n/** The engine's parts that are components, by id, with what the inspector calls them */\nconst PART_COMPONENTS: Record<string, string> = { [moving.id]: 'Movement', [fighting.id]: 'Combat', [deposit.id]: 'Resource' }\n\n/** The numbers of an entity of its own, not in a part */\nconst OWN_NUMBERS = ['health', 'maxHealth', 'mana', 'maxMana', 'facing', 'expires', 'unseenIn'] as const\n\n/** What `setInspected` may change of an entity: the numbers of its own, the parts and the components. Never where it is, nor its type */\nconst EDITABLE = new Set<string>([...OWN_NUMBERS, ...PARTS.map(([key]) => key), 'components'])\n\n/** The world's own state the inspector shows apart, rather than as a component */\nconst TIMERS_STATE = 'core.timers'\n\n/** Whether a timer's data says something about the entity: a field that names it by id */\nfunction mentions(data: unknown, id: EntityId, depth = 0): boolean {\n\tif (!data || typeof data !== 'object' || depth > 3) return false\n\tfor (const [key, value] of Object.entries(data)) {\n\t\tif (typeof value === 'number' && value === id && /id|entity|unit|target|source|caster|owner/i.test(key)) return true\n\t\tif (typeof value === 'object' && mentions(value, id, depth + 1)) return true\n\t}\n\treturn false\n}\n\n/** An entity by id as the inspector links to it, or nothing when there is none */\nconst named = (world: World, id: EntityId | undefined | null): string | undefined => {\n\tconst entity = id ? world.get(id) : undefined\n\treturn entity && `${entity.def.id}#${entity.id}`\n}\n\n/**\n * The other entities an entity has to do with, by what they are to it: what it is told to go for, fight, gather\n * from, who put a buff on it; and the other way, who is after it. The world has no tree of entities: these are its\n * relations\n */\nfunction relationsOf(world: World, entity: Entity): Record<string, string> {\n\tconst out: Record<string, string> = {}\n\tconst add = (what: string, id: EntityId | undefined | null) => {\n\t\tconst name = named(world, id)\n\t\tif (name && id !== entity.id) out[what] = name\n\t}\n\tentity.orders.forEach((order, index) => add(`orders[${index}] ${order.type}`, order.init.target))\n\tadd('goes to', entity.get(moving)?.goalEntity)\n\tadd('fights', entity.get(fighting)?.autoTarget)\n\tadd('swings at', entity.get(fighting)?.swingTarget)\n\tadd('was hit by', entity.get(fighting)?.lastAttacker)\n\tadd('gathers from', harvesterOf(entity)?.resource)\n\tadd('rallies to', productionOf(entity)?.rally?.target)\n\tfor (const buff of entity.buffs) add(`buff ${buff.id} from`, buff.source)\n\tlet after = 0\n\tfor (const other of world.units.values()) {\n\t\tif (other === entity || !other.alive) continue\n\t\tif (other.orders[0]?.init.target === entity.id || other.get(fighting)?.autoTarget === entity.id) {\n\t\t\tif (++after > 8) break\n\t\t\tadd(`after it ${after}`, other.id)\n\t\t}\n\t}\n\treturn out\n}\n\nfunction inspectEntity(world: World, id: EntityId): Inspection | null {\n\tconst entity = world.get(id)\n\tif (!entity) return null\n\tconst state: Record<string, unknown> = {}\n\tfor (const key of OWN_NUMBERS) if (entity[key] !== null) state[key] = summarize(entity[key])\n\tconst flags: string[] = []\n\tif (entity.hidden) flags.push('hidden')\n\tif (entity.asleep) flags.push('asleep')\n\tif (entity.unseen) flags.push('unseen')\n\tif (entity.scenery) flags.push('scenery')\n\tif (entity.get(dashing)) flags.push('dashing')\n\tif (entity.scale !== 1) flags.push(`scale ${entity.scale}`)\n\tif (entity.look) flags.push(`look ${entity.look}`)\n\tconst sections: InspectedSection[] = [\n\t\t{ title: 'State', value: state, path: [] },\n\t\t{ title: 'Stats', value: summarize({ ...statsOf(world, entity) }) }\n\t]\n\tconst related = relationsOf(world, entity)\n\tif (Object.keys(related).length) sections.push({ title: 'Related', value: related })\n\tfor (const [key, title] of PARTS) {\n\t\tconst value = entity[key]\n\t\tif (value === undefined || value === null || (Array.isArray(value) && !value.length)) continue\n\t\tsections.push({ title, value: summarize(value), path: [key] })\n\t}\n\tfor (const [component, value] of Object.entries(entity.components)) {\n\t\tconst part = PART_COMPONENTS[component]\n\t\tsections.push({ title: part ?? component, value: summarize(value), path: ['components', component], own: !part })\n\t}\n\tconst timers = world.timers.list().filter((timer) => mentions(timer.data, id))\n\tif (timers.length) sections.push({ title: 'Timers', value: summarize(timers) })\n\tconst owner = world.players.get(entity.owner)?.name ?? String(entity.owner)\n\treturn {\n\t\ttarget: { entity: id },\n\t\ttitle: `${entity.def.name} #${id}`,\n\t\tabout: `${entity.def.id}, ${owner}`,\n\t\ttick: world.tick,\n\t\talive: entity.alive,\n\t\tat: { x: entity.pos.x, z: entity.pos.z },\n\t\tflags,\n\t\tsections\n\t}\n}\n\n/** The components kept in a state store, each a section of its own */\nconst componentSections = (values: Record<string, unknown>): InspectedSection[] =>\n\tObject.entries(values)\n\t\t.filter(([id]) => id !== TIMERS_STATE)\n\t\t.map(([id, value]) => ({ title: id, value: summarize(value), path: ['state', id], own: true }))\n\nfunction inspectPlayer(world: World, id: PlayerId): Inspection | null {\n\tconst player = world.players.get(id)\n\tif (!player) return null\n\tconst objectives = world.objectives.of(id)\n\tconst sections: InspectedSection[] = [\n\t\t{ title: 'Resources', value: summarize(player.resources), path: ['resources'] },\n\t\t{\n\t\t\ttitle: 'Player',\n\t\t\tvalue: { team: player.team, supplyUsed: player.supplyUsed, supplyCap: player.supplyCap, entities: world.index.ownedBy(id).size }\n\t\t},\n\t\t{ title: 'Upgrades', value: Object.fromEntries(player.upgrades), path: ['upgrades'] }\n\t]\n\tif (player.researching.size) sections.push({ title: 'Researching', value: [...player.researching] })\n\tif (objectives.length) sections.push({ title: 'Objectives', value: summarize(objectives) })\n\tsections.push(...componentSections(player.states.values))\n\t// the computer that plays it, where one does: what it is thinking, as it says (`ComputerPlayer.inspect`). A brain's\n\t// is its report, with the seat's milliseconds: the AI tab's\n\tconst seat = world.computers.get(id)\n\tconst thinking = seat?.computer.inspect?.()\n\tconst ai = isReport(thinking) ? { ...thinking, timing: seat!.timing() } : undefined\n\tif (thinking !== undefined && !ai) sections.push({ title: 'Computer player', value: summarize(thinking) })\n\tconst flags = [player.neutral && 'neutral', player.creeps && 'creeps', player.defeated && 'defeated'].filter((flag): flag is string => !!flag)\n\treturn {\n\t\ttarget: { player: id },\n\t\ttitle: player.name,\n\t\tabout: `player ${id}, team ${player.team}`,\n\t\ttick: world.tick,\n\t\talive: !player.defeated,\n\t\tflags,\n\t\tsections,\n\t\t...(ai && { ai })\n\t}\n}\n\n/** Whether what a computer player says of itself is a brain's report */\nconst isReport = (value: unknown): value is AiReport =>\n\t!!value &&\n\ttypeof value === 'object' &&\n\t(value as AiReport).v === 1 &&\n\ttypeof (value as AiReport).brain === 'string' &&\n\tArray.isArray((value as AiReport).goals)\n\nfunction inspectWorld(world: World): Inspection {\n\tconst sections: InspectedSection[] = [\n\t\t{\n\t\t\ttitle: 'World',\n\t\t\tvalue: summarize({\n\t\t\t\ttick: world.tick,\n\t\t\t\ttime: world.time,\n\t\t\t\thour: world.registry.day ? world.hour : undefined,\n\t\t\t\twinner: world.winner,\n\t\t\t\tentities: world.entities.size,\n\t\t\t\tactors: world.units.size,\n\t\t\t\tprojectiles: world.projectiles.length,\n\t\t\t\tmissiles: world.missiles.length,\n\t\t\t\titems: world.items.length\n\t\t\t})\n\t\t},\n\t\t...componentSections(world.states.values),\n\t\t{ title: 'Timers', value: summarize(world.timers.list()) },\n\t\t{ title: 'Systems', value: world.systems.map((system) => `${system.name} (${system.phase})`) }\n\t]\n\treturn { target: { world: true }, title: 'World', about: `${world.players.size} players`, tick: world.tick, alive: true, flags: [], sections }\n}\n\n/**\n * Something as the simulation has it right now, or null when there is no such entity or player\n *\n * @beta\n */\nexport function inspect(world: World, target: InspectTarget): Inspection | null {\n\tif ('entity' in target) return inspectEntity(world, target.entity)\n\tif ('player' in target) return inspectPlayer(world, target.player)\n\treturn inspectWorld(world)\n}\n\n/** Walks a path to what holds the last key. Null when it does not lead anywhere */\nfunction holderOf(root: unknown, path: readonly (string | number)[]): Record<string | number, unknown> | null {\n\tlet holder = root as Record<string | number, unknown>\n\tfor (const key of path.slice(0, -1)) {\n\t\tconst next = holder[key]\n\t\tif (!next || typeof next !== 'object') return null\n\t\tholder = next as Record<string | number, unknown>\n\t}\n\treturn holder\n}\n\n/**\n * Changes a number where `inspect` showed it: of an entity `['health']`, `['abilities', 0, 'cooldown']`,\n * `['components', 'td.bounty', 'gold']`; of a player `['resources', 'gold']`, `['upgrades', 'armor']`,\n * `['state', 'td.score', 'kills']`; of the world `['state', 'td.waves', 'wave']`. An entity's health is kept within what\n * it can have, and none left kills it. Whether it was changed: false for what is not a number or a switch (a boolean), or not to be changed\n *\n * @internal\n */\nexport function setInspected(world: World, target: InspectTarget, path: readonly (string | number)[], value: number | boolean): boolean {\n\tif (!path.length || (typeof value === 'number' && !Number.isFinite(value))) return false\n\tconst last = path[path.length - 1]\n\tif ('player' in target) {\n\t\tconst player = world.players.get(target.player)\n\t\tif (!player) return false\n\t\t// upgrades go through the player, which tells whatever is worked out from them\n\t\tif (path[0] === 'upgrades' && path.length === 2) {\n\t\t\tif (typeof value !== 'number') return false\n\t\t\tplayer.setUpgrade(String(last), Math.max(0, Math.round(value)))\n\t\t\treturn true\n\t\t}\n\t\tconst root = path[0] === 'resources' ? player : path[0] === 'state' ? { state: player.states.values } : null\n\t\tconst holder = root && holderOf(root, path)\n\t\tif (!holder || typeof holder[last] !== typeof value) return false\n\t\tholder[last] = value\n\t\treturn true\n\t}\n\tif ('world' in target) {\n\t\tif (path[0] !== 'state' || path[1] === TIMERS_STATE) return false\n\t\tconst holder = holderOf({ state: world.states.values }, path)\n\t\tif (!holder || typeof holder[last] !== typeof value) return false\n\t\tholder[last] = value\n\t\treturn true\n\t}\n\tconst entity = world.get(target.entity)\n\tif (!entity?.alive || !EDITABLE.has(String(path[0]))) return false\n\tconst holder = holderOf(entity, path)\n\tif (!holder || typeof holder[last] !== typeof value) return false\n\tif (typeof value === 'number' && path.length === 1 && last === 'health') {\n\t\tif (value <= 0) {\n\t\t\tworld.kill(entity)\n\t\t\treturn true\n\t\t}\n\t\tvalue = Math.min(value, entity.maxHealth)\n\t}\n\tif (typeof value === 'number' && path.length === 1 && last === 'mana') value = Math.max(0, Math.min(value, entity.maxMana))\n\tholder[last] = value\n\t// levels, buffs and the like go into its stats: they are worked out again\n\tentity.statsCache = null\n\treturn true\n}\n\n/**\n * An entity as the list of all of them shows it\n *\n * @beta\n */\nexport interface EntityRow {\n\t/** The entity's id */\n\tid: EntityId\n\t/** The id of the entity's unit type */\n\ttype: string\n\t/** The entity's display name */\n\tname: string\n\t/** The player that owns it */\n\towner: PlayerId\n\t/** What kind of thing it is: `unit`, `building` or `resource` */\n\tkind: string\n\t/** Its health now */\n\thealth: number\n\t/** Its largest health */\n\tmaxHealth: number\n\t/** Type of what it is doing, null for nothing */\n\torder: string | null\n\t/** Whether it is scenery, kept out of play and shown as ground dressing */\n\tscenery: boolean\n\t/** Whether it is hidden from the players */\n\thidden: boolean\n}\n\n/**\n * A player as the list shows it\n *\n * @beta\n */\nexport interface PlayerRow {\n\t/** The player's id */\n\tid: PlayerId\n\t/** The player's name */\n\tname: string\n\t/** The team the player is on */\n\tteam: number\n\t/** Whether it is a neutral player (creeps and the like), not one of the sides */\n\tneutral: boolean\n\t/** Whether the player has lost the game */\n\tdefeated: boolean\n}\n\n/**\n * Everything in the world, for the list of the debug tools: what is out of sight, hidden or scenery too\n *\n * @beta\n */\nexport interface WorldListing {\n\t/** The tick of the simulation the listing was taken at */\n\ttick: number\n\t/** Every player of the world, as `PlayerRow` */\n\tplayers: PlayerRow[]\n\t/** Every entity of the world, as `EntityRow`, hidden and scenery ones too */\n\tentities: EntityRow[]\n}\n\n/**\n * Every player and entity of the world, in a few numbers each\n *\n * @internal\n */\nexport function listWorld(world: World): WorldListing {\n\tconst entities: EntityRow[] = []\n\tfor (const entity of world.entities.values()) {\n\t\tif (!entity.alive) continue\n\t\tentities.push({\n\t\t\tid: entity.id,\n\t\t\ttype: entity.def.id,\n\t\t\tname: entity.def.name,\n\t\t\towner: entity.owner,\n\t\t\tkind: entity.def.kind,\n\t\t\thealth: Math.ceil(entity.health),\n\t\t\tmaxHealth: Math.ceil(entity.maxHealth),\n\t\t\torder: entity.orders[0]?.type ?? null,\n\t\t\tscenery: entity.scenery,\n\t\t\thidden: entity.hidden\n\t\t})\n\t}\n\tconst players = [...world.players.values()].map(({ id, name, team, neutral, defeated }) => ({ id, name, team, neutral, defeated }))\n\treturn { tick: world.tick, players, entities }\n}\n\n/**\n * Something that happened in the rules, as the event log keeps it\n *\n * @beta\n */\nexport interface LoggedEvent {\n\t/** In the order they were logged, for asking for what came after */\n\tseq: number\n\t/** The tick it happened in */\n\ttick: number\n\t/** Whether it is an engine `event` or a `hook` */\n\tkind: 'event' | 'hook'\n\t/** The engine's name for it, or a game's id */\n\tname: string\n\t/** One of the game's own, rather than the engine's */\n\town: boolean\n\t/** What it said, plain data. For a hook, what the first run of it in the tick was given */\n\tdetail?: unknown\n\t/** The listeners that ran on an event, or the handlers of a hook */\n\tran: string[]\n\t/** How many times a hook ran in the tick */\n\tcount?: number\n}\n\n/**\n * What a world tells whoever follows it of the rules as they run, see `World.trace`\n *\n * @beta\n */\nexport interface Trace {\n\t/** A hook with handlers ran. `own`: a hook of the game's */\n\thook(name: string, handlers: readonly { id: string }[], own: boolean, event: unknown): void\n\t/** A listener of the game is about to run, on the event going out */\n\tlistener(id: string): void\n}\n\n/**\n * The events and hooks of the last seconds of a world, the game's own among them, with the listeners and handlers\n * that ran on them. Hooks run often (every target search asks one), so a hook is one line a tick, with how many times.\n * Following costs a little: it is only on while `attach`ed\n *\n * @beta\n */\nexport class EventLog implements Trace {\n\tprivate readonly list: LoggedEvent[] = []\n\tprivate seq = 0\n\t/** The hooks of the tick going on, by name */\n\tprivate hooks = new Map<string, LoggedEvent>()\n\tprivate hooksAt = -1\n\t/** The event going out, which listeners that run belong to */\n\tprivate current: LoggedEvent | null = null\n\tprivate world: World | null = null\n\tprivate untap: (() => void) | null = null\n\n\tconstructor(\n\t\t/** Seconds of it that are kept */\n\t\treadonly seconds = 10,\n\t\t/** Lines kept at most, however short a time they took */\n\t\treadonly max = 2000\n\t) {}\n\n\t/** Starts following a world */\n\tattach(world: World): void {\n\t\tthis.detach()\n\t\tthis.world = world\n\t\tworld.trace = this\n\t\tthis.untap = world.events.tap((type, payload) => this.event(type, payload))\n\t}\n\n\t/** Stops following it. What was logged stays */\n\tdetach(): void {\n\t\tconst { world } = this\n\t\tif (!world) return\n\t\tif (world.trace === this) world.trace = null\n\t\tthis.untap?.()\n\t\tthis.untap = null\n\t\tthis.world = null\n\t\tthis.current = null\n\t}\n\n\t/** Whether the log is attached to a world, following what happens in it */\n\tget attached(): boolean {\n\t\treturn this.world !== null\n\t}\n\n\t/** What was logged, oldest first. The same list, kept up to date: to read, not to keep */\n\tget entries(): readonly LoggedEvent[] {\n\t\treturn this.list\n\t}\n\n\t/** Empties the log and the hooks it is counting for the current tick */\n\tclear(): void {\n\t\tthis.list.length = 0\n\t\tthis.hooks.clear()\n\t}\n\n\tprivate event(type: PropertyKey, payload: unknown): void {\n\t\tconst world = this.world!\n\t\t// what is held for the end of a tick goes out once the tick is counted\n\t\tconst tick = world.events.releasing ? world.tick - 1 : world.tick\n\t\tconst name = String(type)\n\t\tthis.current = this.add({ tick, kind: 'event', name, own: isGameEvent(name), detail: summarize(payload, 1), ran: [] })\n\t}\n\n\t/** Notes that the listener with this id ran on the event going out; part of `Trace` */\n\tlistener(id: string): void {\n\t\tthis.current?.ran.push(id)\n\t}\n\n\t/** Notes that the hook ran, with the ids of its handlers and whether it is a game's own; a hook run again in the same tick only adds to its count */\n\thook(name: string, handlers: readonly { id: string }[], own: boolean, event: unknown): void {\n\t\tconst { tick } = this.world!\n\t\tif (tick !== this.hooksAt) {\n\t\t\tthis.hooks.clear()\n\t\t\tthis.hooksAt = tick\n\t\t}\n\t\tconst known = this.hooks.get(name)\n\t\tif (known) {\n\t\t\tknown.count!++\n\t\t\treturn\n\t\t}\n\t\tconst entry = this.add({ tick, kind: 'hook', name, own, detail: summarize(event, 1), ran: handlers.map((handler) => handler.id), count: 1 })\n\t\tthis.hooks.set(name, entry)\n\t}\n\n\tprivate add(entry: Omit<LoggedEvent, 'seq'>): LoggedEvent {\n\t\tconst logged = { seq: ++this.seq, ...entry }\n\t\tthis.list.push(logged)\n\t\tconst oldest = logged.tick - this.seconds * this.world!.tickRate\n\t\tlet drop = 0\n\t\twhile (drop < this.list.length && (this.list.length - drop > this.max || this.list[drop].tick < oldest)) drop++\n\t\tif (drop) this.list.splice(0, drop)\n\t\treturn logged\n\t}\n}\n"],"mappings":"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"}

package/dist/inventory.d.ts

@@ -1,5 +1,6 @@
 import type { Entity, ItemInstance } from './entity';
 import type { InventoryInfo } from './session/protocol';
+import type { World } from './world';
 /**
  * The slots of what a unit carries (`UnitTypeDef.inventory`), null for an empty one: set as it is spawned (and as its
  * type changes), for a type with slots. Sent to everyone who sees it as `InventoryInfo`: the items it carries, and to
@@ -14,5 +15,17 @@ export declare const inventorySlots: import("./components").Component<(ItemInsta
  * @beta
  */
 export declare const slotsOf: (entity: Entity) => (ItemInstance | null)[] | undefined;
-/** @beta */
+/**
+ * The index of the first free slot of the entity's inventory, or -1 when it has none or no inventory
+ *
+ * @beta
+ */
 export declare const freeSlot: (entity: Entity) => number;
+/**
+ * The passives of what an entity carries (`ItemDef.passive`), by ability id, in slot order: those of items sharing a
+ * `unique` name once, the first carried (unless the game says otherwise, `ItemSettings.unique`). What the abilities
+ * system keeps up and the triggers go by
+ *
+ * @beta
+ */
+export declare function carriedPassives(world: World, entity: Entity): readonly string[];

package/dist/inventory.js

@@ -0,0 +1,84 @@
+import { defineComponent } from "./components.js";
+//#region src/inventory.ts
+/**
+* What a unit carries (`UnitTypeDef.inventory`): its slots of items, the component the stats, the abilities and the
+* shops read. Here alone, of nothing but components, so that what reads it (the stats, on every hit) loads nothing of
+* the shops (`items.ts`)
+*/
+/**
+* The slots of what a unit carries (`UnitTypeDef.inventory`), null for an empty one: set as it is spawned (and as its
+* type changes), for a type with slots. Sent to everyone who sees it as `InventoryInfo`: the items it carries, and to
+* its owner and their allies the slots, for commands
+*
+* @beta
+*/
+var inventorySlots = defineComponent({
+	id: "core.inventory",
+	refs: (slots) => ({ items: slots.flatMap((carried) => carried ? [carried.item] : []) }),
+	onSpawn: (entity) => {
+		if (entity.def.inventory) entity.set(inventorySlots, Array.from({ length: entity.def.inventory }, () => null));
+	},
+	replicate: "everyone",
+	snapshot(slots, _entity, { ally }) {
+		const items = [];
+		for (const slot of slots) if (slot) items.push(slot.item);
+		if (!ally) return items.length ? { items } : void 0;
+		return {
+			items,
+			slots: slots.map((slot) => slot && {
+				id: slot.id,
+				item: slot.item,
+				charges: slot.charges,
+				cooldown: slot.state?.cooldown ?? 0,
+				...slot.state?.charges !== void 0 && { uses: slot.state.charges }
+			})
+		};
+	},
+	same: (a, b) => a.items.length === b.items.length && a.items.every((item, i) => item === b.items[i]) && a.slots === void 0 === (b.slots === void 0) && (!a.slots || a.slots.length === b.slots.length && a.slots.every((slot, i) => {
+		const other = b.slots[i];
+		return slot === other || !!slot && !!other && slot.id === other.id && slot.item === other.item && slot.charges === other.charges && slot.cooldown === other.cooldown && slot.uses === other.uses;
+	}))
+});
+/**
+* The slots of what a unit carries, null for an empty one: none for a type that carries nothing (`inventorySlots`)
+*
+* @beta
+*/
+var slotsOf = (entity) => entity.get(inventorySlots);
+/**
+* The index of the first free slot of the entity's inventory, or -1 when it has none or no inventory
+*
+* @beta
+*/
+var freeSlot = (entity) => slotsOf(entity)?.findIndex((slot) => slot === null) ?? -1;
+/** What carries no passive carries: one list for all of them */
+var NONE = Object.freeze([]);
+/**
+* The passives of what an entity carries (`ItemDef.passive`), by ability id, in slot order: those of items sharing a
+* `unique` name once, the first carried (unless the game says otherwise, `ItemSettings.unique`). What the abilities
+* system keeps up and the triggers go by
+*
+* @beta
+*/
+function carriedPassives(world, entity) {
+	const slots = slotsOf(entity);
+	if (!slots) return NONE;
+	let out;
+	let seen;
+	const unique = world.settings.items.unique;
+	for (const instance of slots) {
+		if (!instance) continue;
+		const def = world.registry.item(instance.item);
+		if (!def.passive) continue;
+		if (unique && def.unique !== void 0) {
+			if (seen?.has(def.unique)) continue;
+			(seen ??= /* @__PURE__ */ new Set()).add(def.unique);
+		}
+		(out ??= []).push(def.passive);
+	}
+	return out ?? NONE;
+}
+//#endregion
+export { carriedPassives, freeSlot, inventorySlots, slotsOf };
+
+//# sourceMappingURL=inventory.js.map

package/dist/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","names":[],"sources":["../src/inventory.ts"],"sourcesContent":["/**\n * What a unit carries (`UnitTypeDef.inventory`): its slots of items, the component the stats, the abilities and the\n * shops read. Here alone, of nothing but components, so that what reads it (the stats, on every hit) loads nothing of\n * the shops (`items.ts`)\n */\nimport { defineComponent } from './components'\nimport type { Entity, ItemInstance } from './entity'\nimport type { CarriedItem, InventoryInfo } from './session/protocol'\nimport type { World } from './world'\n\n/**\n * The slots of what a unit carries (`UnitTypeDef.inventory`), null for an empty one: set as it is spawned (and as its\n * type changes), for a type with slots. Sent to everyone who sees it as `InventoryInfo`: the items it carries, and to\n * its owner and their allies the slots, for commands\n *\n * @beta\n */\nexport const inventorySlots = defineComponent<(ItemInstance | null)[], InventoryInfo>({ id: 'core.inventory', refs: (slots) => ({ items: (slots as (ItemInstance | null)[]).flatMap((carried) => (carried ? [carried.item] : [])) }),\n\t// its slots, empty, for a type that carries\n\tonSpawn: (entity) => {\n\t\tif (entity.def.inventory)\n\t\t\tentity.set(\n\t\t\t\tinventorySlots,\n\t\t\t\tArray.from({ length: entity.def.inventory }, () => null)\n\t\t\t)\n\t},\n\treplicate: 'everyone',\n\tsnapshot(slots, _entity, { ally }) {\n\t\tconst items: string[] = []\n\t\tfor (const slot of slots) if (slot) items.push(slot.item)\n\t\tif (!ally) return items.length ? { items } : undefined\n\t\treturn {\n\t\t\titems,\n\t\t\tslots: slots.map(\n\t\t\t\t(slot): CarriedItem | null =>\n\t\t\t\t\tslot && {\n\t\t\t\t\t\tid: slot.id,\n\t\t\t\t\t\titem: slot.item,\n\t\t\t\t\t\tcharges: slot.charges,\n\t\t\t\t\t\tcooldown: slot.state?.cooldown ?? 0,\n\t\t\t\t\t\t...(slot.state?.charges !== undefined && { uses: slot.state.charges })\n\t\t\t\t\t}\n\t\t\t)\n\t\t}\n\t},\n\tsame: (a, b) =>\n\t\ta.items.length === b.items.length &&\n\t\ta.items.every((item, i) => item === b.items[i]) &&\n\t\t(a.slots === undefined) === (b.slots === undefined) &&\n\t\t(!a.slots ||\n\t\t\t(a.slots.length === b.slots!.length &&\n\t\t\t\ta.slots.every((slot, i) => {\n\t\t\t\t\tconst other = b.slots![i]\n\t\t\t\t\treturn (\n\t\t\t\t\t\tslot === other ||\n\t\t\t\t\t\t(!!slot &&\n\t\t\t\t\t\t\t!!other &&\n\t\t\t\t\t\t\tslot.id === other.id &&\n\t\t\t\t\t\t\tslot.item === other.item &&\n\t\t\t\t\t\t\tslot.charges === other.charges &&\n\t\t\t\t\t\t\tslot.cooldown === other.cooldown &&\n\t\t\t\t\t\t\tslot.uses === other.uses)\n\t\t\t\t\t)\n\t\t\t\t}))) })\n\n/**\n * The slots of what a unit carries, null for an empty one: none for a type that carries nothing (`inventorySlots`)\n *\n * @beta\n */\nexport const slotsOf = (entity: Entity): (ItemInstance | null)[] | undefined => entity.get(inventorySlots)\n\n/**\n * The index of the first free slot of the entity's inventory, or -1 when it has none or no inventory\n *\n * @beta\n */\nexport const freeSlot = (entity: Entity) => slotsOf(entity)?.findIndex((slot) => slot === null) ?? -1\n\n/** What carries no passive carries: one list for all of them */\nconst NONE: readonly string[] = Object.freeze([])\n\n/**\n * The passives of what an entity carries (`ItemDef.passive`), by ability id, in slot order: those of items sharing a\n * `unique` name once, the first carried (unless the game says otherwise, `ItemSettings.unique`). What the abilities\n * system keeps up and the triggers go by\n *\n * @beta\n */\nexport function carriedPassives(world: World, entity: Entity): readonly string[] {\n\t// asked of every unit on every hit and every upkeep: what carries no passive makes no list\n\tconst slots = slotsOf(entity)\n\tif (!slots) return NONE\n\tlet out: string[] | undefined\n\tlet seen: Set<string> | undefined\n\tconst unique = world.settings.items.unique\n\tfor (const instance of slots) {\n\t\tif (!instance) continue\n\t\tconst def = world.registry.item(instance.item)\n\t\tif (!def.passive) continue\n\t\tif (unique && def.unique !== undefined) {\n\t\t\tif (seen?.has(def.unique)) continue\n\t\t\t;(seen ??= new Set()).add(def.unique)\n\t\t}\n\t\t;(out ??= []).push(def.passive)\n\t}\n\treturn out ?? NONE\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,IAAa,iBAAiB,gBAAwD;CAAE,IAAI;CAAkB,OAAO,WAAW,EAAE,OAAQ,MAAkC,SAAS,YAAa,UAAU,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAE,EAAE;CAEjO,UAAU,WAAW;EACpB,IAAI,OAAO,IAAI,WACd,OAAO,IACN,gBACA,MAAM,KAAK,EAAE,QAAQ,OAAO,IAAI,UAAU,SAAS,IAAI,CACxD;CACF;CACA,WAAW;CACX,SAAS,OAAO,SAAS,EAAE,QAAQ;EAClC,MAAM,QAAkB,CAAC;EACzB,KAAK,MAAM,QAAQ,OAAO,IAAI,MAAM,MAAM,KAAK,KAAK,IAAI;EACxD,IAAI,CAAC,MAAM,OAAO,MAAM,SAAS,EAAE,MAAM,IAAI,KAAA;EAC7C,OAAO;GACN;GACA,OAAO,MAAM,KACX,SACA,QAAQ;IACP,IAAI,KAAK;IACT,MAAM,KAAK;IACX,SAAS,KAAK;IACd,UAAU,KAAK,OAAO,YAAY;IAClC,GAAI,KAAK,OAAO,YAAY,KAAA,KAAa,EAAE,MAAM,KAAK,MAAM,QAAQ;GACrE,CACF;EACD;CACD;CACA,OAAO,GAAG,MACT,EAAE,MAAM,WAAW,EAAE,MAAM,UAC3B,EAAE,MAAM,OAAO,MAAM,MAAM,SAAS,EAAE,MAAM,EAAE,KAC7C,EAAE,UAAU,KAAA,OAAgB,EAAE,UAAU,KAAA,OACxC,CAAC,EAAE,SACF,EAAE,MAAM,WAAW,EAAE,MAAO,UAC5B,EAAE,MAAM,OAAO,MAAM,MAAM;EAC1B,MAAM,QAAQ,EAAE,MAAO;EACvB,OACC,SAAS,SACR,CAAC,CAAC,QACF,CAAC,CAAC,SACF,KAAK,OAAO,MAAM,MAClB,KAAK,SAAS,MAAM,QACpB,KAAK,YAAY,MAAM,WACvB,KAAK,aAAa,MAAM,YACxB,KAAK,SAAS,MAAM;CAEvB,CAAC;AAAI,CAAC;;;;;;AAOV,IAAa,WAAW,WAAwD,OAAO,IAAI,cAAc;;;;;;AAOzG,IAAa,YAAY,WAAmB,QAAQ,MAAM,CAAC,EAAE,WAAW,SAAS,SAAS,IAAI,KAAK;;AAGnG,IAAM,OAA0B,OAAO,OAAO,CAAC,CAAC;;;;;;;;AAShD,SAAgB,gBAAgB,OAAc,QAAmC;CAEhF,MAAM,QAAQ,QAAQ,MAAM;CAC5B,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI;CACJ,IAAI;CACJ,MAAM,SAAS,MAAM,SAAS,MAAM;CACpC,KAAK,MAAM,YAAY,OAAO;EAC7B,IAAI,CAAC,UAAU;EACf,MAAM,MAAM,MAAM,SAAS,KAAK,SAAS,IAAI;EAC7C,IAAI,CAAC,IAAI,SAAS;EAClB,IAAI,UAAU,IAAI,WAAW,KAAA,GAAW;GACvC,IAAI,MAAM,IAAI,IAAI,MAAM,GAAG;GAC1B,CAAC,yBAAS,IAAI,IAAI,EAAA,CAAG,IAAI,IAAI,MAAM;EACrC;EACC,CAAC,QAAQ,CAAC,EAAA,CAAG,KAAK,IAAI,OAAO;CAC/B;CACA,OAAO,OAAO;AACf"}

package/dist/items.d.ts

@@ -1,34 +1,106 @@
+import type { Cost, ItemDef, ItemTier } from './defs';
 import type { Entity, ItemInstance, Placed, StockState } from './entity';
-import type { StockInfo } from './session/protocol';
+import type { PurchaseInfo, StockInfo } from './session/protocol';
 import { type Vec2 } from './math';
 import type { World } from './world';
+import { type Message } from './messages';
+import type { Registry } from './registry';
 /**
  * An item lying on the ground
  *
  * @beta
  */
 export interface GroundItem {
+    /** The item instance's id, kept when it is picked up again */
     id: number;
+    /** The item type's id */
     item: string;
+    /** How many charges the item has left */
     charges: number;
+    /** The item's place on the map's x axis */
     x: number;
+    /** The item's place on the map's z axis */
     z: number;
 }
-/** @beta */
+/**
+ * Makes an instance of an item type with an id of its own, with the charges given or those of the type (0 when it has none)
+ *
+ * @beta
+ */
 export declare function createItem(world: World, item: string, charges?: number): ItemInstance;
 /**
- * Puts an item into the first free slot. False when there is none
+ * The tier of an item, `epic` (the old word) read as `intermediate`: what the registry keeps of it (`ItemTier`)
+ *
+ * @beta
+ */
+export declare function itemTier(def: Pick<ItemDef, 'tier'>): ItemTier | undefined;
+/**
+ * The items of the game with a tag (`ItemDef.tags`), in the game's order: `itemsTagged(registry, 'lifesteal')`
+ *
+ * @beta
+ */
+export declare function itemsTagged(registry: Pick<Registry, 'items'>, tag: string): ItemDef[];
+/**
+ * The most of an item's group one carrier may have (`ItemDef.group`): the item's own limit, the game's of the group
+ * (`ItemSettings.groups`), or 1. No limit for an item of no group
+ *
+ * @beta
+ */
+export declare function groupLimitOf(world: World, def: ItemDef): number;
+/**
+ * Whether the entity has room for an item: a free slot, or a stack of it with room (`ItemDef.stack`)
+ *
+ * @beta
+ */
+export declare function hasRoomFor(world: World, entity: Entity, item: string, charges?: number): boolean;
+/**
+ * Why a carrier may not take an item, or nothing when it may: one more of its group than it may carry (`ItemDef.group`),
+ * or what the game's own rule says (`ItemSettings.mayCarry`). `uses`, the parts buying it uses up, by id: they go out as
+ * it comes in. `handed`: it is handed over, and the words say "they". Asked as an item is bought, picked up or handed
+ * over; room in the inventory is asked apart (`hasRoomFor`)
+ *
+ * @beta
+ */
+export declare function carryRefusal(world: World, carrier: Entity, item: string, uses?: readonly string[], handed?: boolean): Message | undefined;
+/**
+ * Why one who carries these items (by id) may not take one more of an item's group (`ItemDef.group`), or nothing when
+ * it may: the engine's part of `carryRefusal`, which a screen asks too, with the game's registry alone, to say so before
+ * the buy (the shop window). `uses` are the parts buying it uses up: they go out as it comes in, so they are not
+ * counted. The limit is the item's own, the game's of the group (`ItemSettings.groups`), or 1
+ *
+ * @beta
+ */
+export declare function groupRefusal(registry: Pick<Registry, 'items' | 'settings'>, carried: readonly string[], item: string, uses?: readonly string[], handed?: boolean): Message | undefined;
+/**
+ * Puts an item into the inventory: into a stack of it with room (`ItemDef.stack`, its charges added), or the first free
+ * slot. False when there is neither. The engine's rules of what may be carried are asked before (`carryRefusal`)
  *
  * @beta
  */
 export declare function giveItem(world: World, entity: Entity, instance: ItemInstance): boolean;
-/** @beta */
+/**
+ * Takes the item instance with this id out of the entity's inventory and returns it; undefined when it does not carry it
+ *
+ * @beta
+ */
 export declare function takeItem(world: World, entity: Entity, instanceId: number): ItemInstance | undefined;
-/** @beta */
+/**
+ * Finds the item instance with this id in the entity's inventory; undefined when it is not there or no id is given
+ *
+ * @beta
+ */
 export declare function findItem(entity: Entity, instanceId: number | undefined): ItemInstance | undefined;
-/** @beta */
+/**
+ * Puts the item on the ground at the closest walkable point to `at`, tells the game (`itemDropped`) and returns the ground item
+ *
+ * @beta
+ */
 export declare function dropOnGround(world: World, instance: ItemInstance, at: Vec2): GroundItem;
-/** @beta */
+/**
+ * Has the entity pick up the item lying on the ground by its id; returns false when none is there, no slot is free or `beforePickUp` refuses
+ *
+ * @beta
+ */
 export declare function pickUp(world: World, entity: Entity, groundId: number): boolean;
 /**
  * One use of an item that has charges. The last one takes the item with it
@@ -71,6 +143,62 @@ export declare function shopper(world: World, shop: Entity, player: number, item
  * @beta
  */
 export declare function buy(world: World, shop: Entity, item: string, player: number, buyer?: Entity): boolean;
+/**
+ * A purchase that may still be undone (`undoBuy`), kept on the buyer (`purchases`) for `ShopSettings.undo` seconds
+ * while it stands at the shop and has not used the item
+ *
+ * @beta
+ */
+export interface Purchase {
+    /** The purchase's id: the id of the item instance bought (what `undoBuy` names it by) */
+    id: number;
+    /** The item type's id */
+    item: string;
+    /** The shop it was bought at: the buyer has to be there still */
+    shop: number;
+    /** The game's time it was bought at */
+    at: number;
+    /** What was paid, given back whole */
+    paid: Cost;
+    /** The charges the item had as bought, or the stack had with it: fewer, and it was used */
+    charges: number;
+    /** The stack it went into (its instance id), when it was stacked onto one carried rather than put in a slot of its own */
+    into?: number;
+    /** The parts it used up, as they were, to come back */
+    used: ItemInstance[];
+    /** Whether the shop counted it off its stock, to count it back */
+    stocked: boolean;
+}
+/**
+ * The purchases a hero may still undo (`Purchase`, `undoBuy`): kept on the buyer, sent to its player (`PurchaseInfo`:
+ * each with the seconds left to undo it), dropped as they run out, as the hero leaves the shop or as the item is used
+ * (`expirePurchases`, the abilities system's every tick)
+ *
+ * @beta
+ */
+export declare const purchases: import("./components").Component<Purchase[], PurchaseInfo[]>;
+/**
+ * Whether a purchase may still be undone (`undoBuy`): within `ShopSettings.undo` seconds of it, the buyer alive and at
+ * the shop still, the shop standing, the item carried with its charges as bought and its ability not used
+ *
+ * @beta
+ */
+export declare function undoable(world: World, entity: Entity, purchase: Purchase): boolean;
+/**
+ * Why a purchase of the hero's may not be undone, or nothing when it may: nothing to undo (none within the time, the
+ * hero away from the shop, the item used), or no room for the parts to come back
+ *
+ * @beta
+ */
+export declare function undoRefusal(world: World, entity: Entity, purchaseId?: number): Message | undefined;
+/**
+ * Takes a purchase back (`ShopSettings.undo`): the latest the hero may still undo, or the one named by its id. The
+ * item goes (out of its stack, where it went into one), what it cost comes back whole, the parts it used up come back
+ * as they were, and the shop has it back in stock. False, and the player told why, where it cannot (`undoRefusal`)
+ *
+ * @beta
+ */
+export declare function undoBuy(world: World, entity: Entity, purchaseId?: number): boolean;
 /**
  * Whether a shop the player can trade with is close enough to the entity
  *
@@ -88,4 +216,4 @@ export declare function dropLoot(world: World, entity: Entity, killer?: Entity):
 /** An item picked up, to those who see who picked it */
 export declare const toldPicked: import("./replication").ReplicatedEvent;
 /** The items on the ground where the player sees (`Snapshot.items`) */
-export declare const itemsPart: import("./replication").SnapshotPart<keyof import(".").Snapshot>;
+export declare const itemsPart: import("./replication").SnapshotField<keyof import(".").Snapshot>;