@v12-engine/engine 0.1.1 → 0.4.0

package/dist/{missionRules-C-bGxm0Q.js → missionRules.js}

@@ -1,138 +1,10 @@
-import { Nd as defineComponent, Qr as defineHook, Sr as defeat, To as defineTimer, lo as playCinematic, mu as gameOver, td as defineEvent } from "./debugCommands-CzjrSm66.js";
-//#region src/mapObjectives.ts
-/**
-* The map objectives pack's id
-*
-* @beta
-*/
-var MAP_OBJECTIVES = "core.mapObjectives";
-/**
-* The key of the map's data its objectives are kept under (`GameMap.data.objectives`)
-*
-* @beta
-*/
-var MAP_OBJECTIVES_KEY = "objectives";
-/** The words of an objective as a file may hold them: a key, or a key with params */
-var isWords = (text) => typeof text === "string" ? text.trim() !== "" : typeof text === "object" && text !== null && typeof text.key === "string" && text.key !== "";
-/**
-* The objectives a map gives (`GameMap.data.objectives`), in the order it gives them: none for a map with none. What is
-* 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
-* it; the map's checks say so (`mapObjectives`)
-*
-* @beta
-*/
-function mapObjectivesOf(map) {
-	const kept = map.data[MAP_OBJECTIVES_KEY];
-	if (!Array.isArray(kept)) return [];
-	return kept.filter((each) => typeof each === "object" && each !== null && typeof each.id === "string" && each.id !== "" && isWords(each.text)).map((each) => ({
-		id: each.id,
-		text: each.text,
-		...each.detail !== void 0 && isWords(each.detail) && { detail: each.detail },
-		...each.required !== void 0 && { required: each.required !== false },
-		at: each.at === "rule" ? "rule" : "start"
-	}));
-}
-/**
-* Who is given a map's objective when the rules do not say (`giveMapObjective`): the map's players a person plays, not
-* those it says the computer plays or nobody does (`MapPlayer.controller`), in the order of their ids
-*
-* @beta
-*/
-function mapObjectivePlayers(world) {
-	return [...world.players.values()].filter((player) => !player.neutral && !player.creeps).filter((player) => {
-		const controller = world.map.player(player.id)?.controller;
-		return controller !== "computer" && controller !== "nobody";
-	}).map((player) => player.id).sort((a, b) => a - b);
-}
-/**
-* Gives players an objective of the map's, by its id (`MapObjective`): those given by a rule (`at: 'rule'`), when the
-* rules say. To every player a person plays when `players` is left out (`mapObjectivePlayers`); a player who has it
-* already keeps theirs. Its words' params and its progress go with it, as `world.objectives.add`. Throws for an id the
-* map does not have: an id in the code that is not on the map is a mistake
-*
-* @beta
-*/
-function giveMapObjective(world, id, options = {}) {
-	const def = mapObjectivesOf(world.map).find((objective) => objective.id === id);
-	if (!def) throw new Error(`The map${world.map.name ? ` "${world.map.name}"` : ""} has no objective "${id}"`);
-	const { at: _at, ...objective } = def;
-	const given = [];
-	for (const player of options.players ?? mapObjectivePlayers(world)) {
-		if (world.objectives.has(player, id)) continue;
-		given.push(world.objectives.add(player, objective, {
-			params: options.params,
-			progress: options.progress
-		}));
-	}
-	return given;
-}
-/**
-* What is wrong with a map's objectives (`GameMap.data.objectives`): one with no id or with another's, one with no
-* words, a list that is not one. Each a click away in the Objectives panel
-*
-* @beta
-*/
-function checkMapObjectives(map) {
-	const kept = map.data[MAP_OBJECTIVES_KEY];
-	if (kept === void 0) return [];
-	if (!Array.isArray(kept)) return [{
-		message: "The map’s objectives are not a list",
-		error: true,
-		rule: "objectives"
-	}];
-	const problems = [];
-	const seen = /* @__PURE__ */ new Set();
-	kept.forEach((each, index) => {
-		const id = typeof each?.id === "string" ? each.id : "";
-		const reveal = {
-			panel: "objectives",
-			entry: id || String(index)
-		};
-		if (!id) problems.push({
-			message: `Objective ${index + 1} has no id`,
-			error: true,
-			rule: "objective-id",
-			reveal
-		});
-		else if (seen.has(id)) problems.push({
-			message: `Two objectives have the id "${id}"`,
-			error: true,
-			rule: "objective-id",
-			reveal
-		});
-		seen.add(id);
-		if (!isWords(each?.text)) problems.push({
-			message: `The objective "${id || index + 1}" has no words`,
-			error: true,
-			rule: "objective-text",
-			reveal
-		});
-	});
-	return problems;
-}
-/**
-* Objectives as data on the map (campaign plan EQ3): a map's objectives (`MapObjective`, kept in `GameMap.data.objectives`,
-* written by the editor's Objectives panel) given at the start to every player a person plays, as the world is made
-* from the map; those given by a rule wait for the rules (`giveMapObjective(world, id)`). Done and failed as any
-* objective is (`world.objectives.complete`, `fail`); a game that is won by them has `objectiveVictory` as its
-* `victory`. The map's checks say what is wrong with them (`checkMapObjectives`)
-*
-* @beta
-*/
-function mapObjectives() {
-	return {
-		id: MAP_OBJECTIVES,
-		hooks: [defineHook({
-			hook: "mapStart",
-			id: MAP_OBJECTIVES,
-			run(world) {
-				for (const objective of mapObjectivesOf(world.map)) if (objective.at === "start") giveMapObjective(world, objective.id);
-			}
-		})],
-		check: (map) => checkMapObjectives(map)
-	};
-}
-//#endregion
+import { defineComponent } from "./components.js";
+import { defineEngineEvent } from "./events.js";
+import { gameOver } from "./engineEvents.js";
+import { defineTimer } from "./timers.js";
+import { playCinematic } from "./cinematics.js";
+import { defeat } from "./systems/victory.js";
+import { giveMapObjective, mapObjectivePlayers, mapObjectivesOf } from "./mapObjectives.js";
 //#region src/missionRules.ts
 /**
 * The mission rules pack's id
@@ -151,17 +23,20 @@ var MAP_RULES_KEY = "rules";
 *
 * @internal
 */
-var missionRulesState = defineComponent("core.missionRules", { default: () => ({
-	rules: {},
-	told: [],
-	timers: {}
-}) });
+var missionRulesState = defineComponent({
+	id: "core.missionRules",
+	default: () => ({
+		rules: {},
+		told: [],
+		timers: {}
+	})
+});
 /**
 * A mission rule fired: its id. For a pack of the game's that does what the rules cannot
 *
 * @beta
 */
-var ruleFired = defineEvent("core.ruleFired");
+var ruleFired = defineEngineEvent({ id: "core.ruleFired" });
 var ACTIONS = [
 	"objective",
 	"say",
@@ -341,11 +216,14 @@ function rulePlayers(world) {
 *
 * @internal
 */
-var ruleTimer = defineTimer("core.missionRules.timer", (world, { word, to }, timer) => {
-	const state = world.state(missionRulesState);
-	if (state.timers[word] === timer.id) delete state.timers[word];
-	for (const player of to ?? []) world.timers.hide(player, timer.id);
-	tellRules(world, word);
+var ruleTimer = defineTimer({
+	id: "core.missionRules.timer",
+	run: (world, { word, to }, timer) => {
+		const state = world.state(missionRulesState);
+		if (state.timers[word] === timer.id) delete state.timers[word];
+		for (const player of to ?? []) world.timers.hide(player, timer.id);
+		tellRules(world, word);
+	}
 });
 /**
 * Does one action of a rule, now
@@ -362,11 +240,13 @@ function doMissionAction(world, rule, action) {
 			giveMapObjective(world, id, { players: to });
 		} else for (const player of to) if (world.objectives.has(player, id)) what === "complete" ? world.objectives.complete(player, id) : world.objectives.fail(player, id, reason);
 	} else if ("say" in action) {
-		const { speaker, text, seconds, to = people } = action.say;
+		const { speaker, text, seconds, to = people, unit, emotion } = action.say;
 		world.dialog.say(to, {
 			speaker,
 			text,
-			...seconds !== void 0 && { seconds }
+			...seconds !== void 0 && { seconds },
+			...unit && { unit },
+			...emotion && { emotion }
 		});
 	} else if ("cinematic" in action) {
 		const { id, to, hold, skippable } = action.cinematic;
@@ -518,6 +398,6 @@ function missionRulesPack(options) {
 	};
 }
 //#endregion
-export { missionRulesOf as a, tellRules as c, checkMapObjectives as d, giveMapObjective as f, mapObjectivesOf as h, missionRuleState as i, MAP_OBJECTIVES as l, mapObjectives as m, MISSION_RULES as n, missionRulesPack as o, mapObjectivePlayers as p, checkMissionRules as r, ruleFired as s, MAP_RULES_KEY as t, MAP_OBJECTIVES_KEY as u };
+export { MAP_RULES_KEY, MISSION_RULES, checkMissionRules, doMissionAction, missionRuleState, missionRulesOf, missionRulesPack, missionRulesState, ruleFired, rulePlayers, ruleTimer, tellRules };
 
-//# sourceMappingURL=missionRules-C-bGxm0Q.js.map
+//# sourceMappingURL=missionRules.js.map

package/dist/missionRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missionRules.js","names":[],"sources":["../src/missionRules.ts"],"sourcesContent":["import type { AiConditionData } from './ai/rules'\nimport { playCinematic } from './cinematics'\nimport { defineComponent } from './components'\nimport type { PlayerId } from './entity'\nimport { gameOver } from './engineEvents'\nimport { defineEngineEvent } 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/scripting.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/scripting.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/**\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\n\t * long; the unit that says it (by its name on the map: its face talks in the portrait box) and how (`emotion`)\n\t */\n\t| { say: { speaker: string; text: MessageRef; seconds?: number; to?: PlayerId[]; unit?: string; emotion?: string } }\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/scripting.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>({ id: '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 = defineEngineEvent<{ rule: string }>({ id: '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\t/** Whether the rule's condition held at the last check */\n\tholds: boolean\n\t/** How many times the rule has fired */\n\tcount: number\n\t/** The tick the rule last fired at; left out when it has not */\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[] }>({ id: 'core.missionRules.timer', run: (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, unit, emotion } = action.say\n\t\tworld.dialog.say(to, { speaker, text, ...(seconds !== undefined && { seconds }), ...(unit && { unit }), ...(emotion && { emotion }) })\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/mods.d.ts

@@ -1,17 +1,18 @@
 import type { RaceDef } from './races';
 import type { Component } from './components';
 import type { EventKey } from './events';
-import type { EffectKind } from './abilities/effects';
+import type { EffectType } 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 { AbilityDef, BuffDef, ItemDef, ResourceDef, StatDef, TagDef, UnitTypeDef, UpgradeDef } from './defs';
+import type { Rules } from './game';
 import type { AreaDef } from './areas';
+import type { CellLayerDef } from './cellLayers';
 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 RuleSettingsInit } 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
@@ -21,13 +22,15 @@ import type { GamePack } from './packs/pack';
  * @beta
  */
 export interface ModDef {
+    /** The mod's id, shared by every mod: others list it in `requires` */
     id: string;
     /** `major.minor.patch`. Mods that need this one say which versions they work with */
     version: string;
+    /** The mod's name as a list shows it; its id when left out */
     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`
+     * from 1.2 on). The game counts as one of them, by its id and `Rules.version`
      */
     requires?: string[];
     /** Makes the changes, through the builder */
@@ -38,14 +41,15 @@ export interface ModDef {
  *
  * @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> {
+    /** Finds the definition with this id; undefined when there is none */
     get(id: string): T | undefined;
+    /** Whether a definition with this id is there */
     has(id: string): boolean;
     /** Throws when there is one of that id already: that is `override` */
     add(def: T): void;
@@ -53,6 +57,7 @@ export interface Collection<T> {
     override(id: string, change: Partial<T> | ((def: T) => T)): void;
     /** Throws when there is none of that id */
     remove(id: string): void;
+    /** Every definition in the collection, in order */
     all(): readonly T[];
 }
 /**
@@ -62,19 +67,30 @@ export interface Collection<T> {
  */
 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>;
+    readonly current: Readonly<Rules>;
+    /** The unit types of the game so far */
     units: Collection<UnitTypeDef>;
+    /** The abilities of the game so far */
     abilities: Collection<AbilityDef>;
+    /** The buffs of the game so far */
     buffs: Collection<BuffDef>;
+    /** The items of the game so far */
     items: Collection<ItemDef>;
+    /** The tags of items the game names (`Rules.tags`, `TagDef`): what a shop shows of a tag and filters by @beta */
+    tags: Collection<TagDef>;
+    /** The upgrades of the game so far */
     upgrades: Collection<UpgradeDef>;
-    /** The sides players can play (`GameModule.races`) */
+    /** The sides players can play (`Rules.races`) */
     races: Collection<RaceDef>;
+    /** The stats a unit has, by id (`StatDef`) */
     stats: Collection<StatDef>;
+    /** The resources players gather and spend (`Rules.resources`) */
     resources: Collection<ResourceDef>;
     /** Kinds of ability effects, by their type (`defineEffect`) */
-    effects: Collection<EffectKind>;
+    effects: Collection<EffectType>;
+    /** How unit orders are carried out, by type */
     orders: Collection<OrderBehavior>;
+    /** The commands a player can give, by type (`CommandDef`) */
     commands: Collection<CommandDef>;
     /** The game's hook handlers, by id. `withoutHook` takes out one of the engine's */
     hooks: Collection<HookDef>;
@@ -86,28 +102,31 @@ export interface GameBuilder {
     events: Collection<EventKey<any>>;
     /** The parts of the map the rules watch, by id */
     areas: Collection<AreaDef>;
+    /** The layers of cells painted on its maps, by id (`Rules.cellLayers`): a mod's own grass, with `foliagePack` among its packs @beta */
+    cellLayers: Collection<CellLayerDef>;
     /** 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>;
+    /** Takes out one of the engine's hook handlers by id, which `hooks` cannot reach */
     withoutHook(id: string): void;
-    /** The parts of the rules the game opts into (`GameModule.packs`), by id: `packs.add(withHeroes())` @beta */
+    /** The parts of the rules the game opts into (`Rules.packs`), by id: `packs.add(heroesPack())` @beta */
     packs: Collection<GamePack>;
-    /** Takes out a command of the engine's or a pack's, by its type (`GameModule.withoutCommands`) @beta */
+    /** Takes out a command of the engine's or a pack's, by its type (`Rules.withoutCommands`) @beta */
     withoutCommand(type: string): void;
-    /** Takes out an order of the engine's or a pack's, by its type (`GameModule.withoutOrders`) @beta */
+    /** Takes out an order of the engine's or a pack's, by its type (`Rules.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 rules of the game (`RuleSettings`): any of them, a group in part (`{ supply: { max: 200 } }`) */
+    settings(changes: RuleSettingsInit): 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;
+    set<K extends Setting>(key: K, value: Rules[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';
+type Setting = 'name' | 'currency' | 'upkeep' | 'day' | 'victory' | 'startingBase' | 'report' | 'ai';
 /**
  * Throws when a requirement is not met, or two mods change the same thing without one requiring the other
  *
@@ -116,13 +135,13 @@ type Setting = 'name' | 'currency' | 'upkeep' | 'day' | 'victory' | 'start' | 'r
 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
+ * A game with mods on it: a new `Rules`, 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;
+export declare function composeGame(base: Rules, mods: ModDef[]): Rules;
 /**
  * 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
@@ -130,13 +149,13 @@ export declare function composeGame(base: GameModule, mods: ModDef[]): GameModul
  *
  * @beta
  */
-export declare function recompose(game: GameModule): GameModule;
+export declare function recompose(game: Rules): Rules;
 /**
  * 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;
+export declare function isMadeOf(game: Rules, part: Rules | 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
  *