@v12-engine/engine 0.0.0-stage → 0.1.1

package/dist/missionRules-C-bGxm0Q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missionRules-C-bGxm0Q.js","names":[],"sources":["../src/mapObjectives.ts","../src/missionRules.ts"],"sourcesContent":["import type { PlayerId } from './entity'\nimport { defineHook } from './hooks'\nimport type { GameMap } from './map'\nimport type { MapProblem } from './mapFields'\nimport type { Message } from './messages'\nimport type { ObjectiveDef, ObjectiveState } from './objectives'\nimport type { GamePack } from './packs/pack'\nimport type { World } from './world'\n\n/*\n * Objectives as data on the map (campaign plan EQ3): a list kept in the map's data (`GameMap.data.objectives`), which\n * the editor's Objectives panel writes, and which the map objectives pack reads (`mapObjectives`): those given at the\n * start are each player's as the world is made from the map, the rest are given by the rules by id\n * (`giveMapObjective`). What becomes of them, done or failed, is the rules' as for any objective (`world.objectives`)\n */\n\n/**\n * The map objectives pack's id\n *\n * @beta\n */\nexport const MAP_OBJECTIVES = 'core.mapObjectives'\n\n/**\n * The key of the map's data its objectives are kept under (`GameMap.data.objectives`)\n *\n * @beta\n */\nexport const MAP_OBJECTIVES_KEY = 'objectives'\n\n/**\n * An objective a map gives, as it keeps it: an objective (`ObjectiveDef`: its id, its words, whether the mission needs\n * it, more about it) and when it is given\n *\n * @beta\n */\nexport interface MapObjective extends ObjectiveDef {\n\t/**\n\t * When it is given: as the game starts (`start`), to every player a person plays (`mapObjectivePlayers`), or when\n\t * the rules say (`rule`: `giveMapObjective(world, id)`). Anything but `rule` is the start\n\t */\n\tat: 'start' | 'rule'\n}\n\n/** The words of an objective as a file may hold them: a key, or a key with params */\nconst isWords = (text: unknown): boolean =>\n\ttypeof text === 'string'\n\t\t? text.trim() !== ''\n\t\t: typeof text === 'object' && text !== null && typeof (text as Message).key === 'string' && (text as Message).key !== ''\n\n/**\n * The objectives a map gives (`GameMap.data.objectives`), in the order it gives them: none for a map with none. What is\n * kept there and is no objective (no id, no words) is left out, so that a file changed by hand breaks no rule that reads\n * it; the map's checks say so (`mapObjectives`)\n *\n * @beta\n */\nexport function mapObjectivesOf(map: { readonly data: Readonly<Record<string, unknown>> }): MapObjective[] {\n\tconst kept = map.data[MAP_OBJECTIVES_KEY]\n\tif (!Array.isArray(kept)) return []\n\treturn kept\n\t\t.filter(\n\t\t\t(each): each is MapObjective => typeof each === 'object' && each !== null && typeof each.id === 'string' && each.id !== '' && isWords(each.text)\n\t\t)\n\t\t.map((each) => ({\n\t\t\tid: each.id,\n\t\t\ttext: each.text,\n\t\t\t...(each.detail !== undefined && isWords(each.detail) && { detail: each.detail }),\n\t\t\t...(each.required !== undefined && { required: each.required !== false }),\n\t\t\tat: each.at === 'rule' ? 'rule' : 'start'\n\t\t}))\n}\n\n/**\n * Who is given a map's objective when the rules do not say (`giveMapObjective`): the map's players a person plays, not\n * those it says the computer plays or nobody does (`MapPlayer.controller`), in the order of their ids\n *\n * @beta\n */\nexport function mapObjectivePlayers(world: World): PlayerId[] {\n\treturn [...world.players.values()]\n\t\t.filter((player) => !player.neutral && !player.creeps)\n\t\t.filter((player) => {\n\t\t\tconst controller = world.map.player(player.id)?.controller\n\t\t\treturn controller !== 'computer' && controller !== 'nobody'\n\t\t})\n\t\t.map((player) => player.id)\n\t\t.sort((a, b) => a - b)\n}\n\n/**\n * Gives players an objective of the map's, by its id (`MapObjective`): those given by a rule (`at: 'rule'`), when the\n * rules say. To every player a person plays when `players` is left out (`mapObjectivePlayers`); a player who has it\n * already keeps theirs. Its words' params and its progress go with it, as `world.objectives.add`. Throws for an id the\n * map does not have: an id in the code that is not on the map is a mistake\n *\n * @beta\n */\nexport function giveMapObjective(\n\tworld: World,\n\tid: string,\n\toptions: { players?: readonly PlayerId[]; params?: Message['params']; progress?: { value: number; max: number } } = {}\n): ObjectiveState[] {\n\tconst def = mapObjectivesOf(world.map).find((objective) => objective.id === id)\n\tif (!def) throw new Error(`The map${world.map.name ? ` \"${world.map.name}\"` : ''} has no objective \"${id}\"`)\n\tconst { at: _at, ...objective } = def\n\tconst given: ObjectiveState[] = []\n\tfor (const player of options.players ?? mapObjectivePlayers(world)) {\n\t\tif (world.objectives.has(player, id)) continue\n\t\tgiven.push(world.objectives.add(player, objective, { params: options.params, progress: options.progress }))\n\t}\n\treturn given\n}\n\n/**\n * What is wrong with a map's objectives (`GameMap.data.objectives`): one with no id or with another's, one with no\n * words, a list that is not one. Each a click away in the Objectives panel\n *\n * @beta\n */\nexport function checkMapObjectives(map: GameMap): MapProblem[] {\n\tconst kept = map.data[MAP_OBJECTIVES_KEY]\n\tif (kept === undefined) return []\n\tif (!Array.isArray(kept)) return [{ message: 'The map’s objectives are not a list', error: true, rule: 'objectives' }]\n\tconst problems: MapProblem[] = []\n\tconst seen = new Set<string>()\n\tkept.forEach((each: Partial<MapObjective> | null, index) => {\n\t\tconst id = typeof each?.id === 'string' ? each.id : ''\n\t\tconst reveal = { panel: 'objectives', entry: id || String(index) }\n\t\tif (!id) problems.push({ message: `Objective ${index + 1} has no id`, error: true, rule: 'objective-id', reveal })\n\t\telse if (seen.has(id)) problems.push({ message: `Two objectives have the id \"${id}\"`, error: true, rule: 'objective-id', reveal })\n\t\tseen.add(id)\n\t\tif (!isWords(each?.text))\n\t\t\tproblems.push({ message: `The objective \"${id || index + 1}\" has no words`, error: true, rule: 'objective-text', reveal })\n\t})\n\treturn problems\n}\n\n/**\n * Objectives as data on the map (campaign plan EQ3): a map's objectives (`MapObjective`, kept in `GameMap.data.objectives`,\n * written by the editor's Objectives panel) given at the start to every player a person plays, as the world is made\n * from the map; those given by a rule wait for the rules (`giveMapObjective(world, id)`). Done and failed as any\n * objective is (`world.objectives.complete`, `fail`); a game that is won by them has `objectiveVictory` as its\n * `victory`. The map's checks say what is wrong with them (`checkMapObjectives`)\n *\n * @beta\n */\nexport function mapObjectives(): GamePack {\n\tconst atStart = defineHook({\n\t\thook: 'mapStart',\n\t\tid: MAP_OBJECTIVES,\n\t\trun(world) {\n\t\t\tfor (const objective of mapObjectivesOf(world.map)) if (objective.at === 'start') giveMapObjective(world, objective.id)\n\t\t}\n\t})\n\treturn { id: MAP_OBJECTIVES, hooks: [atStart], check: (map) => checkMapObjectives(map) }\n}\n","import type { AiConditionData } from './ai/rules'\nimport { playCinematic } from './cinematics'\nimport { defineComponent } from './components'\nimport type { PlayerId } from './entity'\nimport { gameOver } from './engineEvents'\nimport { defineEvent } from './events'\nimport type { GameMap } from './map'\nimport type { MapProblem } from './mapFields'\nimport { giveMapObjective, mapObjectivePlayers, mapObjectivesOf } from './mapObjectives'\nimport type { Vec2 } from './math'\nimport type { MessageRef } from './messages'\nimport type { GamePack } from './packs/pack'\nimport type { Registry, System } from './registry'\nimport { defeat } from './systems/victory'\nimport { defineTimer } from './timers'\nimport type { PlayerRelation, World } from './world'\n\n/*\n * Mission rules as data (campaign plan MS1): what a mission scripts without code, kept on the map (`GameMap.data.rules`),\n * written in the editor's Rules panel, and run by the mission rules pack (`missionRules` of `@v12-engine/engine/ai`, where the\n * computer players' kit it asks the conditions of lives: `ai/missionRules.ts`). A rule is `when` a\n * condition of the computer players' language (`AiConditionData`, `docs/ai.md`: the hero nears the camp, a region has\n * units in it, an objective is done, a word was told, so many seconds went by) and `do` a list of actions from a closed\n * set: give, complete or fail an objective of the map's, say a line, play a cinematic, spawn a prefab, tell a computer\n * player a word, set what two players are to each other, start a timer, win, lose. No variables and no code by name:\n * what needs code is a pack of the game's, which the rules reach through the words they are told (`tellRules`) and\n * the event each firing is (`ruleFired`).\n *\n * The conditions are asked of a watcher: a brain with no modules of its own, seated at the player the rule is `as`\n * (the first person playing when it says none), which sees the whole map (an observer's session) and reads it as a\n * computer player does (`Brain.view`, `knowledge`), once a second. So `{ units: { of: 'enemy' } }` means that\n * player's enemies, and every form of the table in `docs/ai.md` works as it does for a brain. A rule fires as its\n * condition turns true, once (`once`) or each time, or again every so many seconds while it holds (`every`), as a\n * brain's rules do. What the rules remember (whether each held, when and how often it fired, the words told and not yet\n * heard, the timers started) is in the world's state, and the watchers' memory in the system's: a save mid-mission has\n * it all, and a game loaded from one goes on where it was\n */\n\n/**\n * The mission rules pack's id\n *\n * @beta\n */\nexport const MISSION_RULES = 'core.missionRules'\n\n/**\n * The key of the map's data its rules are kept under (`GameMap.data.rules`)\n *\n * @beta\n */\nexport const MAP_RULES_KEY = 'rules'\n\n/**\n * What a mission rule does, as plain data: one of a closed set of actions. Each takes who it is for (`to`) where that\n * matters: every player a person plays when left out (`mapObjectivePlayers`), as the map's objectives are given\n *\n * @beta\n */\nexport type MissionActionData =\n\t/** An objective of the map's (`MapObjective`), by id: given (`give`, the default), done or failed (with why) */\n\t| { objective: { id: string; do?: 'give' | 'complete' | 'fail'; to?: PlayerId[]; reason?: MessageRef } }\n\t/** A line said (`world.dialog.say`): who speaks (a speaker of the view's), what (a message key, or the words), for how long */\n\t| { say: { speaker: string; text: MessageRef; seconds?: number; to?: PlayerId[] } }\n\t/** A cinematic of the view's played (`playCinematic`), to everyone when `to` is left out */\n\t| { cinematic: { id: string; to?: PlayerId[]; hold?: boolean; skippable?: boolean } }\n\t/**\n\t * A prefab of the game's spawned (`world.spawnPrefab`) at a place: a point or a region of the map by name, a named\n\t * thing of the map, or a point; for a player, or neutral\n\t */\n\t| { spawn: { prefab: string; at: string | Vec2; owner?: PlayerId; facing?: number } }\n\t/** A word told to a computer player (`world.computers.tell`), with what goes with it */\n\t| { tell: { computer: PlayerId; word: string; data?: unknown } }\n\t/** What two players are to each other from now on (`world.sides.setRelation`) */\n\t| { relation: { a: PlayerId; b: PlayerId; how: PlayerRelation } }\n\t/**\n\t * A timer started: so many seconds on, the rules are told its id as a word (a rule `when: { told: id }` fires), and\n\t * with `label` it counts down on the players' screens meanwhile (`world.timers.show`). Started again, it starts over\n\t */\n\t| { timer: { id: string; seconds: number; label?: MessageRef; to?: PlayerId[] } }\n\t/** The game is won by the players' team */\n\t| { win: true | { to?: PlayerId[] } }\n\t/** The players are out of the game (`defeat`) */\n\t| { lose: true | { to?: PlayerId[] } }\n\n/**\n * A rule of a mission, as the map keeps it and the mission rules pack runs it: `when` a condition of the computer\n * players' language holds, `do` its actions. Fires as the condition turns true; `once` the first time only, ever; with\n * `every`, again while it holds, at most so often. Asked `as` a player: whose the units of `of: 'mine'` are, whose\n * objectives `{ objective }` reads; the first player a person plays when left out\n *\n * @beta\n */\nexport interface MissionRule {\n\t/** What the log, the checks and the editor know it by; no two the same */\n\tid: string\n\t/** When it fires: plain data (`docs/ai.md`, \"Conditions\") */\n\twhen: AiConditionData\n\t/** What it does, in order */\n\tdo: MissionActionData[]\n\t/** The first time only, ever */\n\tonce?: boolean\n\t/** Seconds: fired again while its condition holds, at most so often */\n\tevery?: number\n\t/** The player the condition is asked for */\n\tas?: PlayerId\n}\n\n/** What the rules remember of one rule, in the world's state */\ninterface RuleMemory {\n\t/** Whether its condition held at the last check: a rule fires as it turns true */\n\twas?: boolean\n\t/** The tick it last fired at */\n\tfired?: number\n\t/** How many times it fired */\n\tcount: number\n}\n\n/** A word the rules were told and have not heard yet */\ninterface ToldWord {\n\tword: string\n\tdata?: unknown\n\ttick: number\n}\n\n/** What the rules keep in the world: plain data, into a save */\ninterface RulesState {\n\trules: Record<string, RuleMemory>\n\ttold: ToldWord[]\n\t/** The timers the rules started and have not heard yet, by their id in the rules, as the world numbers them */\n\ttimers: Record<string, number>\n}\n\n/**\n * What the mission rules remember: in the world's state, so that a save has it\n *\n * @internal\n */\nexport const missionRulesState = defineComponent<RulesState>('core.missionRules', { default: () => ({ rules: {}, told: [], timers: {} }) })\n\n/**\n * A mission rule fired: its id. For a pack of the game's that does what the rules cannot\n *\n * @beta\n */\nexport const ruleFired = defineEvent<{ rule: string }>('core.ruleFired')\n\n/**\n * What a mission rule is now, for the report and the tests: whether its condition held at the last check, how often it\n * fired and when it last did\n *\n * @beta\n */\nexport interface MissionRuleState {\n\tholds: boolean\n\tcount: number\n\tfired?: number\n}\n\nconst ACTIONS = ['objective', 'say', 'cinematic', 'spawn', 'tell', 'relation', 'timer', 'win', 'lose'] as const\n\n/** The form of an action, by its one key: none for data that is no action */\nconst actionKind = (action: unknown): (typeof ACTIONS)[number] | undefined => {\n\tif (typeof action !== 'object' || action === null) return undefined\n\tconst keys = Object.keys(action)\n\treturn keys.length === 1 && (ACTIONS as readonly string[]).includes(keys[0]) ? (keys[0] as (typeof ACTIONS)[number]) : undefined\n}\n\n/** Whether data is a rule's condition: an object of one form */\nconst isCondition = (when: unknown): when is AiConditionData => typeof when === 'object' && when !== null && Object.keys(when).length > 0\n\n/**\n * The rules a map keeps (`GameMap.data.rules`), in their order: none for a map with none. What is kept there and is no\n * rule (no id, no condition) is left out, so that a file changed by hand breaks no game that reads it; the map's checks\n * say so (`checkMissionRules`). Actions that are of no form the pack knows are left out of a rule the same way\n *\n * @beta\n */\nexport function missionRulesOf(map: { readonly data: Readonly<Record<string, unknown>> }): MissionRule[] {\n\tconst kept = map.data[MAP_RULES_KEY]\n\tif (!Array.isArray(kept)) return []\n\treturn kept\n\t\t.filter(\n\t\t\t(each): each is MissionRule =>\n\t\t\t\ttypeof each === 'object' && each !== null && typeof each.id === 'string' && each.id !== '' && isCondition(each.when)\n\t\t)\n\t\t.map((each) => ({\n\t\t\tid: each.id,\n\t\t\twhen: each.when,\n\t\t\tdo: Array.isArray(each.do) ? each.do.filter((action) => actionKind(action) !== undefined) : [],\n\t\t\t...(each.once !== undefined && { once: each.once === true }),\n\t\t\t...(typeof each.every === 'number' && each.every > 0 && { every: each.every }),\n\t\t\t...(typeof each.as === 'number' && { as: each.as })\n\t\t}))\n}\n\n/**\n * Tells the mission rules a word, as the game's code does for what the rules cannot know on their own (the boss fell,\n * the player chose): a rule `when: { told: word }` fires at the next check, and the word is heard no more after it.\n * What a rule's timer does as it goes off\n *\n * @beta\n */\nexport function tellRules(world: World, word: string, data?: unknown): void {\n\tworld.state(missionRulesState).told.push({ word, ...(data !== undefined && { data }), tick: world.tick })\n}\n\n/**\n * What a mission rule is now (`MissionRuleState`): none for a rule the world has not, or has not checked yet\n *\n * @beta\n */\nexport function missionRuleState(world: World, id: string): MissionRuleState | undefined {\n\tif (!world.states.has(missionRulesState)) return undefined\n\tconst kept = world.state(missionRulesState).rules[id]\n\treturn kept && { holds: !!kept.was, count: kept.count, ...(kept.fired !== undefined && { fired: kept.fired }) }\n}\n\n/** The names of the regions a condition asks about, wherever it is in it */\nfunction regionsNamed(when: unknown, out: string[] = []): string[] {\n\tif (typeof when !== 'object' || when === null) return out\n\tconst condition = when as Record<string, unknown>\n\tif ('region' in condition && typeof (condition.region as { name?: unknown })?.name === 'string')\n\t\tout.push((condition.region as { name: string }).name)\n\tfor (const key of ['all', 'any'] as const)\n\t\tif (Array.isArray(condition[key])) for (const each of condition[key] as unknown[]) regionsNamed(each, out)\n\tif ('not' in condition) regionsNamed(condition.not, out)\n\treturn out\n}\n\n/**\n * What is wrong with a map's rules (`GameMap.data.rules`): one with no id or with another's, one with no condition, an\n * action of no form the pack knows, a condition or an action naming what the map or the game has not (a region, an\n * objective, a prefab, a player). Each a click away in the Rules panel\n *\n * @beta\n */\nexport function checkMissionRules(map: GameMap, registry?: Registry): MapProblem[] {\n\tconst kept = map.data[MAP_RULES_KEY]\n\tif (kept === undefined) return []\n\tif (!Array.isArray(kept)) return [{ message: 'The map’s rules are not a list', error: true, rule: 'rules' }]\n\tconst problems: MapProblem[] = []\n\tconst seen = new Set<string>()\n\tconst regions = new Set(map.regions.map((region) => region.name))\n\tconst objectives = new Set(mapObjectivesOf(map).map((objective) => objective.id))\n\tconst players = new Set(map.players.map((player) => player.id))\n\tkept.forEach((each: Partial<MissionRule> | null, index) => {\n\t\tconst id = typeof each?.id === 'string' ? each.id : ''\n\t\tconst name = id || String(index + 1)\n\t\tconst reveal = { panel: 'rules', entry: id || String(index) }\n\t\tconst problem = (message: string, rule: string, error = true) => problems.push({ message, error, rule, reveal })\n\t\tif (!id) problem(`Rule ${index + 1} has no id`, 'rule-id')\n\t\telse if (seen.has(id)) problem(`Two rules have the id \"${id}\"`, 'rule-id')\n\t\tseen.add(id)\n\t\tif (!isCondition(each?.when)) problem(`The rule \"${name}\" has no condition`, 'rule-when')\n\t\telse\n\t\t\tfor (const region of regionsNamed(each!.when))\n\t\t\t\tif (!regions.has(region)) problem(`The rule \"${name}\" asks about a region \"${region}\" the map has not`, 'rule-name')\n\t\tif (each?.as !== undefined && !players.has(each.as)) problem(`The rule \"${name}\" is asked as a player ${each.as} the map has not`, 'rule-name')\n\t\tconst actions = Array.isArray(each?.do) ? each.do : []\n\t\tif (!actions.length) problem(`The rule \"${name}\" does nothing`, 'rule-action', false)\n\t\tfor (const action of actions as unknown[]) {\n\t\t\tconst kind = actionKind(action)\n\t\t\tif (!kind) {\n\t\t\t\tproblem(`The rule \"${name}\" has an action of no form the rules know (${Object.keys(action ?? {}).join(', ') || 'nothing'})`, 'rule-action')\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst data = (action as Record<string, Record<string, unknown>>)[kind]\n\t\t\tconst named = (player: unknown, what: string) => {\n\t\t\t\tif (typeof player === 'number' && !players.has(player)) problem(`The rule \"${name}\" ${what} a player ${player} the map has not`, 'rule-name')\n\t\t\t}\n\t\t\tif (kind === 'objective' && !objectives.has(String(data?.id ?? '')))\n\t\t\t\tproblem(`The rule \"${name}\" names an objective \"${data?.id ?? ''}\" the map has not`, 'rule-name')\n\t\t\tif (kind === 'spawn' && registry && !registry.prefabs.has(String(data?.prefab ?? '')))\n\t\t\t\tproblem(`The rule \"${name}\" spawns a prefab \"${data?.prefab ?? ''}\" the game has not`, 'rule-name')\n\t\t\tif (kind === 'spawn' && typeof data?.at === 'string' && !placeNamed(map, data.at))\n\t\t\t\tproblem(`The rule \"${name}\" spawns at \"${data.at}\", which the map has not`, 'rule-name')\n\t\t\tif (kind === 'spawn') named(data?.owner, 'spawns for')\n\t\t\tif (kind === 'tell') named(data?.computer, 'tells')\n\t\t\tif (kind === 'relation') {\n\t\t\t\tnamed(data?.a, 'sets')\n\t\t\t\tnamed(data?.b, 'sets')\n\t\t\t}\n\t\t\tif (typeof data === 'object' && data !== null && Array.isArray(data.to)) for (const player of data.to) named(player, 'is for')\n\t\t}\n\t})\n\treturn problems\n}\n\n/** Whether a map has a place of this name: a point, a region, or something placed and named */\nconst placeNamed = (map: GameMap, name: string): boolean =>\n\tmap.points.some((point) => point.name === name) ||\n\tmap.regions.some((region) => region.name === name) ||\n\tmap.objects.some((object) => object.name === name)\n\n/** Where a place is in the world: a point or a region of the map by name, a named thing, or the point given */\nfunction placeOf(world: World, at: string | Vec2): Vec2 | undefined {\n\tif (typeof at !== 'string') return { x: at.x, z: at.z }\n\tconst point = world.map.points.find((each) => each.name === at)\n\tif (point) return { x: point.x, z: point.z }\n\tconst region = world.map.regions.find((each) => each.name === at)\n\tif (region) return { x: region.shape.x, z: region.shape.z }\n\tconst named = world.named(at)\n\treturn named && { x: named.pos.x, z: named.pos.z }\n}\n\n/**\n * The players a rule's actions are for when they say none: the people, else everyone who can win or lose\n *\n * @internal\n */\nexport function rulePlayers(world: World): PlayerId[] {\n\tconst people = mapObjectivePlayers(world)\n\tif (people.length) return people\n\treturn [...world.players.values()]\n\t\t.filter((player) => !player.neutral && !player.creeps)\n\t\t.map((player) => player.id)\n\t\t.sort((a, b) => a - b)\n}\n\n/**\n * The timer of a rule's `timer` action: as it goes off, the rules are told its id, and the screens stop counting it\n *\n * @internal\n */\nexport const ruleTimer = defineTimer<{ word: string; to?: PlayerId[] }>('core.missionRules.timer', (world, { word, to }, timer) => {\n\tconst state = world.state(missionRulesState)\n\tif (state.timers[word] === timer.id) delete state.timers[word]\n\tfor (const player of to ?? []) world.timers.hide(player, timer.id)\n\ttellRules(world, word)\n})\n\n/**\n * Does one action of a rule, now\n *\n * @internal\n */\nexport function doMissionAction(world: World, rule: MissionRule, action: MissionActionData): void {\n\tconst warn = (line: string) => world.log.warn('rules', `the rule \"${rule.id}\" ${line}`)\n\tconst people = rulePlayers(world)\n\tif ('objective' in action) {\n\t\tconst { id, do: what = 'give', to = people, reason } = action.objective\n\t\tif (what === 'give') {\n\t\t\tif (!mapObjectivesOf(world.map).some((objective) => objective.id === id)) return warn(`gives an objective \"${id}\" the map has not`)\n\t\t\tgiveMapObjective(world, id, { players: to })\n\t\t} else\n\t\t\tfor (const player of to)\n\t\t\t\tif (world.objectives.has(player, id)) what === 'complete' ? world.objectives.complete(player, id) : world.objectives.fail(player, id, reason)\n\t} else if ('say' in action) {\n\t\tconst { speaker, text, seconds, to = people } = action.say\n\t\tworld.dialog.say(to, { speaker, text, ...(seconds !== undefined && { seconds }) })\n\t} else if ('cinematic' in action) {\n\t\tconst { id, to, hold, skippable } = action.cinematic\n\t\tplayCinematic(world, id, { to: to ?? 'everyone', hold, skippable })\n\t} else if ('spawn' in action) {\n\t\tconst { prefab, at, owner, facing } = action.spawn\n\t\tif (!world.registry.prefabs.has(prefab)) return warn(`spawns a prefab \"${prefab}\" the game has not`)\n\t\tconst place = placeOf(world, at)\n\t\tif (!place) return warn(`spawns at \"${String(at)}\", which the map has not`)\n\t\tworld.spawnPrefab(prefab, { at: place, owner, facing })\n\t} else if ('tell' in action) {\n\t\tconst { computer, word, data } = action.tell\n\t\tif (!world.computers.tell(computer, word, data)) warn(`tells player ${computer} \"${word}\", and the computer does not play them`)\n\t} else if ('relation' in action) {\n\t\tconst { a, b, how } = action.relation\n\t\tworld.sides.setRelation(a, b, how)\n\t} else if ('timer' in action) {\n\t\tconst { id, seconds, label, to = people } = action.timer\n\t\tconst state = world.state(missionRulesState)\n\t\tif (state.timers[id] !== undefined) world.timers.cancel(state.timers[id])\n\t\tconst shown = label === undefined ? [] : to\n\t\tconst timer = world.timers.after(seconds, ruleTimer, { word: id, ...(shown.length && { to: shown }) })\n\t\tstate.timers[id] = timer\n\t\tfor (const player of shown) world.timers.show(player, timer, { label: label! })\n\t} else if ('win' in action) {\n\t\tconst to = action.win === true ? people : (action.win.to ?? people)\n\t\tif (world.winner !== null || !to.length) return\n\t\tconst team = world.player(to[0]).team\n\t\tworld.winner = team\n\t\tworld.events.emit(gameOver, { winner: team })\n\t} else if ('lose' in action) {\n\t\tconst to = action.lose === true ? people : (action.lose.to ?? people)\n\t\tfor (const player of to) if (!world.player(player).defeated) defeat(world, player)\n\t}\n}\n\n/**\n * What a rule's condition is asked of: a watcher seated as a player, which reads the game as a computer player does\n * (`ai/computer.ts`'s `ruleWatcher`: a brain with no modules of its own, on an observer's session). The engine itself\n * carries none of the computer players' kit, so the pack that runs the rules is the kit's (`missionRules` of\n * `@v12-engine/engine/ai`), and hands this to `missionRulesPack`\n *\n * @internal\n */\nexport interface RulesWatcher {\n\t/** Reads the picture of the game anew */\n\tthink(): void\n\t/** Whether a condition holds for it now */\n\task(condition: AiConditionData): boolean\n\t/** A word told to the rules, for `{ told }` to see */\n\ttell(word: string, data: unknown, tick: number): void\n\t/** The word heard: taken, it is seen no more */\n\ttakeTold(word: string): void\n\t/** What it remembers, for a save, and back */\n\tsave(): unknown\n\trestore(memory: unknown): void\n}\n\n/**\n * The system that runs the rules: once a second, each watcher reads the picture, the words told since the last check\n * are heard, and each rule's condition is asked and its actions done as it turns true. The watchers' memory is the\n * system's to save\n */\nfunction rulesSystem(world: World, own: readonly MissionRule[], watch: (world: World, player: PlayerId) => RulesWatcher): System {\n\t// the map's rules and the code's, read as the first check comes: the system is made before the world has its map\n\tlet read: MissionRule[] | undefined\n\tconst rulesOf = (): MissionRule[] => {\n\t\tif (read) return read\n\t\tread = []\n\t\tconst ids = new Set<string>()\n\t\tfor (const rule of [...missionRulesOf(world.map), ...own]) {\n\t\t\tif (ids.has(rule.id)) {\n\t\t\t\tworld.log.warn('rules', `two rules are called \"${rule.id}\": the second is left out`)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tids.add(rule.id)\n\t\t\tread.push(rule)\n\t\t}\n\t\treturn read\n\t}\n\tconst watchers = new Map<PlayerId, RulesWatcher>()\n\tlet restored: Record<string, unknown> | undefined\n\tconst defaultPlayer = (): PlayerId | undefined => rulePlayers(world)[0]\n\tconst watcher = (player: PlayerId): RulesWatcher | undefined => {\n\t\tlet made = watchers.get(player)\n\t\tif (made) return made\n\t\tif (!world.players.has(player)) return undefined\n\t\tmade = watch(world, player)\n\t\tconst memory = restored?.[player]\n\t\tif (memory !== undefined) made.restore(memory)\n\t\twatchers.set(player, made)\n\t\treturn made\n\t}\n\treturn {\n\t\tname: 'missionRules',\n\t\tphase: 'cleanup',\n\t\tevery: Math.max(1, Math.round(world.tickRate)),\n\t\toffset: 3,\n\t\tupdate() {\n\t\t\tconst rules = rulesOf()\n\t\t\tif (!rules.length) return\n\t\t\tconst state = world.state(missionRulesState)\n\t\t\t// the words told since the last check: heard by every watcher this once\n\t\t\tconst told = state.told.splice(0)\n\t\t\tconst asked = new Set<PlayerId>()\n\t\t\tfor (const rule of rules) {\n\t\t\t\tconst player = rule.as ?? defaultPlayer()\n\t\t\t\tif (player !== undefined) asked.add(player)\n\t\t\t}\n\t\t\tfor (const player of asked) {\n\t\t\t\tconst made = watcher(player)\n\t\t\t\tif (!made) continue\n\t\t\t\tmade.think()\n\t\t\t\tfor (const word of told) made.tell(word.word, word.data, word.tick)\n\t\t\t}\n\t\t\tfor (const rule of rules) {\n\t\t\t\tconst kept = (state.rules[rule.id] ??= { count: 0 })\n\t\t\t\tif (rule.once && kept.count > 0) continue\n\t\t\t\tconst player = rule.as ?? defaultPlayer()\n\t\t\t\tconst made = player === undefined ? undefined : watcher(player)\n\t\t\t\tif (!made) {\n\t\t\t\t\tif (kept.was === undefined)\n\t\t\t\t\t\tworld.log.warn('rules', `the rule \"${rule.id}\" is asked as a player ${player} the world has not: it never fires`)\n\t\t\t\t\tkept.was = false\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tconst holds = made.ask(rule.when)\n\t\t\t\tconst turned = holds && !kept.was\n\t\t\t\tkept.was = holds\n\t\t\t\tif (!holds) continue\n\t\t\t\tconst again = rule.every !== undefined && kept.fired !== undefined && world.tick - kept.fired >= Math.round(rule.every * world.tickRate)\n\t\t\t\tif (!turned && !again) continue\n\t\t\t\tkept.fired = world.tick\n\t\t\t\tkept.count++\n\t\t\t\tworld.log.info('rules', `the rule \"${rule.id}\" fires`)\n\t\t\t\tworld.events.emit(ruleFired, { rule: rule.id })\n\t\t\t\tfor (const action of rule.do) doMissionAction(world, rule, action)\n\t\t\t}\n\t\t\tfor (const made of watchers.values()) for (const word of new Set(told.map((each) => each.word))) made.takeTold(word)\n\t\t},\n\t\tsave: () => ({ watchers: Object.fromEntries([...watchers].map(([player, made]) => [player, made.save()])) }),\n\t\trestore: (_world, data) => {\n\t\t\trestored = (data as { watchers?: Record<string, unknown> } | undefined)?.watchers\n\t\t\tfor (const [player, made] of watchers) if (restored?.[player] !== undefined) made.restore(restored[player])\n\t\t}\n\t}\n}\n\n/**\n * The mission rules pack, given what asks a rule's condition (`RulesWatcher`): what `missionRules` of `@v12-engine/engine/ai`\n * makes, with a watcher of the computer players' kit. The map's rules and `rules` of the code's, run as the game plays\n *\n * @internal\n */\nexport function missionRulesPack(options: { rules?: MissionRule[]; watch: (world: World, player: PlayerId) => RulesWatcher }): GamePack {\n\tconst own = options.rules ?? []\n\treturn {\n\t\tid: MISSION_RULES,\n\t\tcomponents: [missionRulesState],\n\t\tevents: [ruleFired],\n\t\ttimers: [ruleTimer],\n\t\tsystems: [(world) => rulesSystem(world, own, options.watch)],\n\t\tcheck: (map, registry) => checkMissionRules(map, registry),\n\t\t...(own.length && { options: { rules: own.map((rule) => rule.id) } })\n\t}\n}\n"],"mappings":"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"}

package/dist/missionRules.d.ts

@@ -0,0 +1,179 @@
+import type { AiConditionData } from './ai/rules';
+import type { PlayerId } from './entity';
+import type { GameMap } from './map';
+import type { MapProblem } from './mapFields';
+import type { Vec2 } from './math';
+import type { MessageRef } from './messages';
+import type { Registry } from './registry';
+import type { PlayerRelation, World } from './world';
+/**
+ * The mission rules pack's id
+ *
+ * @beta
+ */
+export declare const MISSION_RULES = "core.missionRules";
+/**
+ * The key of the map's data its rules are kept under (`GameMap.data.rules`)
+ *
+ * @beta
+ */
+export declare const MAP_RULES_KEY = "rules";
+/**
+ * What a mission rule does, as plain data: one of a closed set of actions. Each takes who it is for (`to`) where that
+ * matters: every player a person plays when left out (`mapObjectivePlayers`), as the map's objectives are given
+ *
+ * @beta
+ */
+export type MissionActionData = 
+/** An objective of the map's (`MapObjective`), by id: given (`give`, the default), done or failed (with why) */
+{
+    objective: {
+        id: string;
+        do?: 'give' | 'complete' | 'fail';
+        to?: PlayerId[];
+        reason?: MessageRef;
+    };
+}
+/** A line said (`world.dialog.say`): who speaks (a speaker of the view's), what (a message key, or the words), for how long */
+ | {
+    say: {
+        speaker: string;
+        text: MessageRef;
+        seconds?: number;
+        to?: PlayerId[];
+    };
+}
+/** A cinematic of the view's played (`playCinematic`), to everyone when `to` is left out */
+ | {
+    cinematic: {
+        id: string;
+        to?: PlayerId[];
+        hold?: boolean;
+        skippable?: boolean;
+    };
+}
+/**
+ * A prefab of the game's spawned (`world.spawnPrefab`) at a place: a point or a region of the map by name, a named
+ * thing of the map, or a point; for a player, or neutral
+ */
+ | {
+    spawn: {
+        prefab: string;
+        at: string | Vec2;
+        owner?: PlayerId;
+        facing?: number;
+    };
+}
+/** A word told to a computer player (`world.computers.tell`), with what goes with it */
+ | {
+    tell: {
+        computer: PlayerId;
+        word: string;
+        data?: unknown;
+    };
+}
+/** What two players are to each other from now on (`world.sides.setRelation`) */
+ | {
+    relation: {
+        a: PlayerId;
+        b: PlayerId;
+        how: PlayerRelation;
+    };
+}
+/**
+ * A timer started: so many seconds on, the rules are told its id as a word (a rule `when: { told: id }` fires), and
+ * with `label` it counts down on the players' screens meanwhile (`world.timers.show`). Started again, it starts over
+ */
+ | {
+    timer: {
+        id: string;
+        seconds: number;
+        label?: MessageRef;
+        to?: PlayerId[];
+    };
+}
+/** The game is won by the players' team */
+ | {
+    win: true | {
+        to?: PlayerId[];
+    };
+}
+/** The players are out of the game (`defeat`) */
+ | {
+    lose: true | {
+        to?: PlayerId[];
+    };
+};
+/**
+ * A rule of a mission, as the map keeps it and the mission rules pack runs it: `when` a condition of the computer
+ * players' language holds, `do` its actions. Fires as the condition turns true; `once` the first time only, ever; with
+ * `every`, again while it holds, at most so often. Asked `as` a player: whose the units of `of: 'mine'` are, whose
+ * objectives `{ objective }` reads; the first player a person plays when left out
+ *
+ * @beta
+ */
+export interface MissionRule {
+    /** What the log, the checks and the editor know it by; no two the same */
+    id: string;
+    /** When it fires: plain data (`docs/ai.md`, "Conditions") */
+    when: AiConditionData;
+    /** What it does, in order */
+    do: MissionActionData[];
+    /** The first time only, ever */
+    once?: boolean;
+    /** Seconds: fired again while its condition holds, at most so often */
+    every?: number;
+    /** The player the condition is asked for */
+    as?: PlayerId;
+}
+/**
+ * A mission rule fired: its id. For a pack of the game's that does what the rules cannot
+ *
+ * @beta
+ */
+export declare const ruleFired: import("./events").EventKey<{
+    rule: string;
+}>;
+/**
+ * What a mission rule is now, for the report and the tests: whether its condition held at the last check, how often it
+ * fired and when it last did
+ *
+ * @beta
+ */
+export interface MissionRuleState {
+    holds: boolean;
+    count: number;
+    fired?: number;
+}
+/**
+ * The rules a map keeps (`GameMap.data.rules`), in their order: none for a map with none. What is kept there and is no
+ * rule (no id, no condition) is left out, so that a file changed by hand breaks no game that reads it; the map's checks
+ * say so (`checkMissionRules`). Actions that are of no form the pack knows are left out of a rule the same way
+ *
+ * @beta
+ */
+export declare function missionRulesOf(map: {
+    readonly data: Readonly<Record<string, unknown>>;
+}): MissionRule[];
+/**
+ * Tells the mission rules a word, as the game's code does for what the rules cannot know on their own (the boss fell,
+ * the player chose): a rule `when: { told: word }` fires at the next check, and the word is heard no more after it.
+ * What a rule's timer does as it goes off
+ *
+ * @beta
+ */
+export declare function tellRules(world: World, word: string, data?: unknown): void;
+/**
+ * What a mission rule is now (`MissionRuleState`): none for a rule the world has not, or has not checked yet
+ *
+ * @beta
+ */
+export declare function missionRuleState(world: World, id: string): MissionRuleState | undefined;
+/**
+ * What is wrong with a map's rules (`GameMap.data.rules`): one with no id or with another's, one with no condition, an
+ * action of no form the pack knows, a condition or an action naming what the map or the game has not (a region, an
+ * objective, a prefab, a player). Each a click away in the Rules panel
+ *
+ * @beta
+ */
+export declare function checkMissionRules(map: GameMap, registry?: Registry): MapProblem[];

package/dist/mods.d.ts

@@ -0,0 +1,146 @@
+import type { RaceDef } from './races';
+import type { Component } from './components';
+import type { EventKey } from './events';
+import type { EffectKind } from './abilities/effects';
+import type { CommandDef } from './commands';
+import type { AbilityDef, BuffDef, ItemDef, ResourceDef, StatDef, UnitTypeDef, UpgradeDef } from './defs';
+import type { GameModule } from './game';
+import type { AreaDef } from './areas';
+import type { ListenerDef } from './events';
+import type { SequenceDef } from './sequences';
+import type { TimerDef } from './timers';
+import type { HookDef } from './hooks';
+import type { OrderBehavior, SystemDef } from './registry';
+import { type RulesInit } from './rules';
+import type { GamePack } from './packs/pack';
+/**
+ * A mod: changes to a game, made on top of it instead of on a copy of it. A new hero, other numbers, a rule of its
+ * own. `composeGame` applies mods to a game in the order they need each other, and tells about two mods that change
+ * the same thing without one knowing of the other, before anyone plays.
+ *
+ * @beta
+ */
+export interface ModDef {
+    id: string;
+    /** `major.minor.patch`. Mods that need this one say which versions they work with */
+    version: string;
+    name?: string;
+    /**
+     * The game and the mods it is made for, each `id`, `id@1.2.3` (that version only) or `id@^1.2` (that major version,
+     * from 1.2 on). The game counts as one of them, by its id and `GameModule.version`
+     */
+    requires?: string[];
+    /** Makes the changes, through the builder */
+    apply(game: GameBuilder): void;
+}
+/**
+ * Typed help for writing a mod
+ *
+ * @beta
+ */
+export declare const defineMod: (def: ModDef) => ModDef;
+/**
+ * Definitions of one kind, by id: what a mod adds, changes or takes out
+ *
+ * @beta
+ */
+export interface Collection<T> {
+    get(id: string): T | undefined;
+    has(id: string): boolean;
+    /** Throws when there is one of that id already: that is `override` */
+    add(def: T): void;
+    /** Changes one that is there: a new definition, or the fields that are different. Throws when there is none */
+    override(id: string, change: Partial<T> | ((def: T) => T)): void;
+    /** Throws when there is none of that id */
+    remove(id: string): void;
+    all(): readonly T[];
+}
+/**
+ * The game a mod is applied to, as it stands after the mods before it
+ *
+ * @beta
+ */
+export interface GameBuilder {
+    /** What the game is so far: to read, not to change. Changes go through the rest of the builder */
+    readonly current: Readonly<GameModule>;
+    units: Collection<UnitTypeDef>;
+    abilities: Collection<AbilityDef>;
+    buffs: Collection<BuffDef>;
+    items: Collection<ItemDef>;
+    upgrades: Collection<UpgradeDef>;
+    /** The sides players can play (`GameModule.races`) */
+    races: Collection<RaceDef>;
+    stats: Collection<StatDef>;
+    resources: Collection<ResourceDef>;
+    /** Kinds of ability effects, by their type (`defineEffect`) */
+    effects: Collection<EffectKind>;
+    orders: Collection<OrderBehavior>;
+    commands: Collection<CommandDef>;
+    /** The game's hook handlers, by id. `withoutHook` takes out one of the engine's */
+    hooks: Collection<HookDef>;
+    /** How the game reacts to events, by id */
+    listeners: Collection<ListenerDef>;
+    /** The state of its own the game keeps, by id: a mod's own components are added here */
+    components: Collection<Component<any>>;
+    /** The events of its own the game emits, by id */
+    events: Collection<EventKey<any>>;
+    /** The parts of the map the rules watch, by id */
+    areas: Collection<AreaDef>;
+    /** What the game can set to go off later, by id */
+    timers: Collection<TimerDef>;
+    /** The game's scripts of steps, by id */
+    sequences: Collection<SequenceDef>;
+    withoutHook(id: string): void;
+    /** The parts of the rules the game opts into (`GameModule.packs`), by id: `packs.add(withHeroes())` @beta */
+    packs: Collection<GamePack>;
+    /** Takes out a command of the engine's or a pack's, by its type (`GameModule.withoutCommands`) @beta */
+    withoutCommand(type: string): void;
+    /** Takes out an order of the engine's or a pack's, by its type (`GameModule.withoutOrders`) @beta */
+    withoutOrder(type: string): void;
+    /** Adds a system of the mod's own, or one in place of the engine's of the same name */
+    addSystem(system: SystemDef): void;
+    /** Takes out a system: one of the engine's, or one the game gave as an object, by name */
+    withoutSystem(name: string): void;
+    /** Changes rules of the game (`GameRules`): any of them, a group in part (`{ supply: { max: 200 } }`) */
+    rules(changes: RulesInit): void;
+    /** Changes one of the game's settings that are one thing, not a list */
+    set<K extends Setting>(key: K, value: GameModule[K]): void;
+}
+/** The parts of a game a mod can only put something else in the place of */
+type Setting = 'name' | 'currency' | 'upkeep' | 'day' | 'victory' | 'start' | 'report' | 'ai';
+/**
+ * Throws when a requirement is not met, or two mods change the same thing without one requiring the other
+ *
+ * @beta
+ */
+export declare class ModError extends Error {
+}
+/**
+ * A game with mods on it: a new `GameModule`, which `createWorld` takes like any other. Its id names the game and
+ * the mods (`melee+goldRush`), and `mods` lists them with their versions. Mods are applied after the ones they
+ * require, otherwise in the order given. Neither the game nor the mods are changed
+ *
+ * @beta
+ */
+export declare function composeGame(base: GameModule, mods: ModDef[]): GameModule;
+/**
+ * A game made by `composeGame` made again, of its base and its mods as they are now (a base made of mods made again
+ * too): what a game played with mods takes as one of them, or its base, is saved while it runs (hot reload). A game not
+ * made so is itself. Throws as `composeGame` does: mods that no longer go together
+ *
+ * @beta
+ */
+export declare function recompose(game: GameModule): GameModule;
+/**
+ * Whether a game is made of this game or mod: is it, or has it as its base or one of its mods, at any depth
+ *
+ * @beta
+ */
+export declare function isMadeOf(game: GameModule, part: GameModule | ModDef): boolean;
+/**
+ * Whether a version is in a range: `1.2.3` exactly, or `^1.2` for 1.2 and later of major version 1
+ *
+ * @beta
+ */
+export declare function satisfies(have: string, range: string): boolean;
+export {};

package/dist/names.d.ts

@@ -0,0 +1,93 @@
+import type { GameData } from './gameData';
+import type { MapCamera, MapDoodad, MapEnvironment, MapForce, MapItemTable, MapPath, MapPlayer, MapPoint, MapRegion } from './map';
+import { type MapFieldDef, type MapThing } from './mapFields';
+import { Path, type Spot } from './paths';
+/**
+ * Entities by the names they were given: on a map, where the editor names what the rules have to find (`MapObject.name`),
+ * or in code (`SpawnOptions.name`, `world.setName`). The rules ask for "the gate", never for a number or a spot on
+ * the map. Kept in the world, so that a save has them
+ */
+export declare const names: import("./components").Component<Record<string, number>, Record<string, number>>;
+/**
+ * What the map a world was made from says that is not an entity, as it is kept in the world: plain data, for a save
+ *
+ * @beta
+ */
+export interface MapInfo {
+    name: string;
+    data: Record<string, unknown>;
+    points: MapPoint[];
+    paths: MapPath[];
+    /** What the map looks like, for the screens (`GameSession.environment`) */
+    environment?: MapEnvironment;
+    /** Its scenery, for the screens (`GameSession.doodads`) */
+    doodads?: MapDoodad[];
+    /** Its regions, for the screens (`GameSession.regions`): what mist in places lies over by name. The rules know them as areas */
+    regions?: MapRegion[];
+    /** Its views saved under names, for the screens (`GameSession.cameras`) */
+    cameras?: MapCamera[];
+    /** Who plays each player, and the game's own fields of each (with what they are when not set) */
+    players?: MapPlayerInfo[];
+    /** Its teams, named, and what they share */
+    forces?: MapForce[];
+    /** What things placed on it drop when they die (`MapObject.drops`) */
+    itemTables?: MapItemTable[];
+    /** The map's own definitions (`GameMap.definitions`): what a load of the world lays over the game again */
+    definitions?: GameData;
+}
+/**
+ * What the map says of a player beyond what the world has of them: who plays them, and the game's own fields
+ *
+ * @beta
+ */
+export interface MapPlayerInfo {
+    id: number;
+    controller?: MapPlayer['controller'];
+    data: Record<string, unknown>;
+}
+export declare const mapInfo: import("./components").Component<MapInfo, MapInfo>;
+/**
+ * What the map a world was made from says that is not an entity (`World.map`): its name, what the game kept with it,
+ * and its points and paths by name. A game can say which names there are: `world.map.path<RoadPaths>('road')`
+ *
+ * @beta
+ */
+export declare class WorldMap {
+    private readonly info;
+    constructor(info: MapInfo);
+    /** The name of the map. Empty for a world made without one */
+    get name(): string;
+    /** What the game kept with the map (`GameMap.data`): a difficulty, the waves of this level */
+    get data(): Record<string, unknown>;
+    /**
+     * The things of a kind of the game's own that were put on the map (`MapThing`): a tower defense's ground kept clear,
+     * a MOBA's lanes. None for a kind the map has nothing of. With `fields`, each thing's own (`data`) has what was not
+     * set at its default: `world.map.things('td.clearings', clearingFields)`
+     */
+    things(kind: string, fields?: readonly Pick<MapFieldDef, 'id' | 'default'>[]): MapThing[];
+    /** Whether the map has a point or a path of this name */
+    has(name: string): boolean;
+    /** A point of the map. Throws for one it does not have: a name in the code that is not on the map is a mistake */
+    point<Name extends string = string>(name: Name): Spot;
+    /** A path of the map, to ask how long it is, where along it, what is on it. Throws for one it does not have */
+    path<Name extends string = string>(name: Name): Path;
+    /** What the map looks like, for the screens: its water. Nothing for a world made without a map */
+    get environment(): MapEnvironment | undefined;
+    /** The regions of the map, for the screens: what mist in places lies over by name. The rules know them as areas */
+    get regions(): readonly MapRegion[];
+    /** The scenery of the map, for the screens: the rules never see it, but where it blocks, which the terrain has */
+    get doodads(): readonly MapDoodad[];
+    /** What the map says of a player: who plays them (a person, the computer, nobody) and the game's own fields */
+    player(id: number): MapPlayerInfo | undefined;
+    /** An item table of the map, by name: what something placed on it drops when it dies */
+    itemTable(name: string): MapItemTable | undefined;
+    /** The teams of the map, named, and what their players share */
+    get forces(): readonly MapForce[];
+    /** The views of the map saved under names, for the screens */
+    get cameras(): readonly MapCamera[];
+    /** The points of the map, as it has them. None in a world saved before maps had points */
+    get points(): readonly MapPoint[];
+    /** The paths of the map, as it has them */
+    get paths(): readonly MapPath[];
+    private get named();
+}

package/dist/navigation/agentParams.d.ts

@@ -0,0 +1,4 @@
+import type { Entity } from '#engine/entity';
+import type { AgentParams } from './navigation';
+/** What the navigation is told of a unit when it takes it on as an agent: one place for every site that adds one again */
+export declare function agentParamsOf(entity: Entity, speed: number): AgentParams;

package/dist/navigation/air.d.ts

@@ -0,0 +1,89 @@
+import type { Rect, Vec2 } from '#engine/math';
+import type { AgentParams, AgentSave, AgentState, NavDebugGeometry, Navigation } from './navigation';
+/**
+ * Where flyers move. There is nothing in the way up there but other flyers and the edge of the map,
+ * so they go straight to where they are sent and only keep from flying inside one another.
+ */
+export declare class AirNavigation implements Navigation {
+    private readonly width;
+    private readonly depth;
+    readonly version = 0;
+    private readonly flyers;
+    constructor(width: number, depth: number);
+    private inside;
+    addAgent(id: number, position: Vec2, params: AgentParams): void;
+    removeAgent(id: number): void;
+    saveAgent(id: number): AgentSave | undefined;
+    reseat(agents: readonly (readonly [id: number, save: AgentSave])[]): void;
+    restoreAgent(id: number, save: AgentSave): void;
+    settle(): void;
+    hasAgent(id: number): boolean;
+    setDestination(id: number, target: Vec2): boolean;
+    clearDestination(id: number): void;
+    teleport(id: number, position: Vec2): void;
+    setAnchored(id: number, anchored: boolean): void;
+    setGhost(id: number, ghost: boolean): void;
+    setSpeed(id: number, speed: number): void;
+    readAgent(id: number, out: AgentState): boolean;
+    update(dt: number): void;
+    /**
+     * The flyers that push (all but ghosts), by cells twice the widest one's radius across: two that overlap are in the
+     * same cell or next to each other, so each looks at its own cell and the eight about it, not at every flyer
+     */
+    private cellsOf;
+    addObstacle(_key: number, _rect: Rect): boolean;
+    obstacleRoom(): number;
+    removeObstacle(_key: number): void;
+    closestPoint(point: Vec2): Vec2;
+    findPath(from: Vec2, to: Vec2): Vec2[];
+    debugGeometry(): NavDebugGeometry;
+    dispose(): void;
+}
+/**
+ * The ground, the air and the water as one: agents are told apart when they are added and find their own layer from
+ * then on. Everything that is not about an agent, like obstacles and looking for walkable ground, is about the ground.
+ * Boats go on the ground where the map has no water to go on (`water` is left out)
+ */
+export declare class LayeredNavigation implements Navigation {
+    readonly ground: Navigation;
+    readonly air: Navigation;
+    readonly water?: Navigation | undefined;
+    private readonly flying;
+    private readonly naval;
+    constructor(ground: Navigation, air: Navigation, water?: Navigation | undefined);
+    get version(): number;
+    private of;
+    /** The layer of a kind of agent: for finding where one can be put */
+    layer(kind: {
+        flying?: boolean;
+        naval?: boolean;
+    }): Navigation;
+    addAgent(id: number, position: Vec2, params: AgentParams): void;
+    removeAgent(id: number): void;
+    hasAgent(id: number): boolean;
+    setDestination(id: number, target: Vec2): boolean;
+    clearDestination(id: number): void;
+    teleport(id: number, position: Vec2): void;
+    setAnchored(id: number, anchored: boolean): void;
+    setGhost(id: number, ghost: boolean): void;
+    setSpeed(id: number, speed: number): void;
+    readAgent(id: number, out: AgentState): boolean;
+    saveAgent(id: number): AgentSave | undefined;
+    restoreAgent(id: number, save: AgentSave): void;
+    reseat(agents: readonly (readonly [id: number, save: AgentSave])[]): void;
+    settle(version: number): void;
+    /** Slow ground is the ground's: what flies or sails goes at one speed (EN2) */
+    groundChanged(cells: readonly number[]): void;
+    /** The ground's and the water's cut again of the ground as it is now: what flies goes over it all the same */
+    reshape(): boolean;
+    update(dt: number): void;
+    addObstacle(key: number, rect: Rect): boolean;
+    obstacleRoom(): number;
+    holdObstacles(hold: boolean): void;
+    removeObstacle(key: number): void;
+    sameCrowd(a: number, b: number): boolean;
+    closestPoint(point: Vec2, searchRadius?: number): Vec2 | null;
+    findPath(from: Vec2, to: Vec2): Vec2[] | null;
+    debugGeometry(): NavDebugGeometry;
+    dispose(): void;
+}