@v12-engine/engine 0.1.0 → 0.4.0

package/dist/createGame.js

@@ -0,0 +1,405 @@
+import { defineComponent } from "./components.js";
+import { defineListener } from "./events.js";
+import { defineTimer } from "./timers.js";
+import { defineSequence } from "./sequences.js";
+import { hotRules, onNewGameVersion, replaceIn } from "./hotReload.js";
+//#region src/createGame.ts
+/** What marks a game made by `createGame` */
+var GAME = Symbol.for("@v12-engine/engine/game");
+/**
+* Whether something is a game made by `createGame`, rather than the module underneath (`Rules`)
+*
+* @public
+*/
+function isGame(value) {
+	return !!value && typeof value === "object" && value[GAME] === true;
+}
+/**
+* The module underneath what a host is given: a game's (`toRules()`), or the module itself
+*
+* @beta
+*/
+function rulesOf(game) {
+	return isGame(game) ? game.toRules() : game;
+}
+/**
+* The start of what a host is given, where it says none of its own: a game's (`toStart()`); a module has none
+*
+* @beta
+*/
+function startOf(game) {
+	return isGame(game) ? game.toStart() : void 0;
+}
+/**
+* Runs each in order, each after the one before has settled: at once, as long as none gives a promise (a start that is
+* plain code is over when it returns, as a host that does not wait for it expects)
+*/
+function inOrder(runs) {
+	let next = 0;
+	const go = () => {
+		while (next < runs.length) {
+			const made = runs[next++]();
+			if (made && typeof made.then === "function") return made.then(go);
+		}
+	};
+	return go();
+}
+/** The same name, written otherwise: `Home stead`, `homestead` and `home-stead` are one */
+var sameName = (a, b) => a.toLowerCase().replace(/[^a-z0-9]/g, "") === b.toLowerCase().replace(/[^a-z0-9]/g, "");
+/**
+* Makes a game: one object its units, abilities, systems, hooks and listeners, missions, maps and view are registered
+* on, which every host takes (`Game`). `init` is its id and name, and any field of the module underneath said at once:
+* `createGame(rules)` makes a game of a module written whole
+*
+* @public
+*/
+function createGame(init) {
+	const { contentPacks = [], checkView = "warn", id, name } = init;
+	if (!id) throw new Error("createGame: a game needs an id");
+	const added = /* @__PURE__ */ new Map();
+	/** The settings given by `settings()`, laid over the module's own as the rules are made */
+	let settings = {};
+	const starts = [];
+	const missions = [];
+	let maps = {};
+	let viewGiven;
+	let hasView = false;
+	let viewFetched;
+	let built;
+	let stale = false;
+	/** The name in `maps` of each map read, by its own name (`GameMap.name`) */
+	const keyOfName = /* @__PURE__ */ new Map();
+	/**
+	* The maps given as loaders (`LazyMaps`) that have been fetched: among the game's maps (`Rules.maps`) from then on, so
+	* that a save or a server's welcome of a game on one keeps only what changed of its ground, as of a map given whole
+	*/
+	const fetched = [];
+	/** How many handlers each id made for one has been given, so that each is its own */
+	const counts = /* @__PURE__ */ new Map();
+	const add = (field, def) => {
+		const list = added.get(field) ?? [];
+		list.push(def);
+		added.set(field, list);
+		stale = true;
+		return def;
+	};
+	/** An id made for a handler that was given none: `<under>.<what>.<name>.<n>` */
+	const madeId = (under, what, name) => {
+		const key = `${under}.${what}.${name}`;
+		const n = (counts.get(key) ?? 0) + 1;
+		counts.set(key, n);
+		return n === 1 ? key : `${key}.${n}`;
+	};
+	const hookName = (hook) => typeof hook === "string" ? hook : hook.id;
+	const listen = (under, event, run, options) => add("listeners", defineListener({
+		id: options?.id ? `${under}.${options.id}` : madeId(under, "on", String(event.id)),
+		event,
+		run
+	}));
+	const hook = (under, when, name, run, options) => add("hooks", {
+		hook: name,
+		id: options?.id ? `${under}.${options.id}` : madeId(under, when, hookName(name)),
+		priority: options?.priority ?? (when === "before" ? -1 : 1),
+		run
+	});
+	/**
+	* The module, made of what it was given and what was registered since. What it was given is read as it is now: a
+	* module given whole and taken anew in place while it runs (`hotRules` on it, hot reload) is in the next one made
+	*/
+	const build = () => {
+		const { contentPacks: _packs, checkView: _check, ...given } = init;
+		const rules = {
+			...given,
+			units: [...given.units ?? []]
+		};
+		const into = rules;
+		for (const [field, list] of added) into[field] = [...into[field] ?? [], ...list];
+		if (Object.keys(settings).length) {
+			const merged = { ...given.settings };
+			for (const [key, value] of Object.entries(settings)) {
+				const was = merged[key];
+				merged[key] = was && value && typeof was === "object" && typeof value === "object" && !Array.isArray(value) ? {
+					...was,
+					...value
+				} : value;
+			}
+			rules.settings = merged;
+		}
+		const loaded = [...Object.values(maps).filter((map) => typeof map !== "function"), ...fetched];
+		if (!given.maps && loaded.length) rules.maps = loaded;
+		return rules;
+	};
+	const game = {
+		[GAME]: true,
+		id,
+		name,
+		contentPacks: [...contentPacks],
+		checkView,
+		get hasView() {
+			return hasView;
+		},
+		unit: (def) => add("units", def),
+		ability: (def) => add("abilities", def),
+		buff: (def) => add("buffs", def),
+		item: (def) => add("items", def),
+		upgrade: (def) => add("upgrades", def),
+		race: (def) => add("races", def),
+		resource: (def) => add("resources", def),
+		stat: (def) => add("stats", def),
+		system: (def) => add("systems", def),
+		order: (def) => add("orders", def),
+		component: (component) => add("components", component),
+		command: (def) => add("commands", def),
+		event: (key) => add("events", key),
+		area: (def) => add("areas", def),
+		prefab: (def) => add("prefabs", def),
+		timer: (def) => add("timers", def),
+		sequence: (def) => add("sequences", def),
+		file: (def) => add("files", def),
+		brain: (def) => add("brains", def),
+		tile: (def) => add("tiles", def),
+		effect: (def) => add("effects", def),
+		targeting: (def) => add("targetings", def),
+		formation: (def) => add("formations", def),
+		tunable: (def) => add("tunables", def),
+		cellLayer: (def) => add("cellLayers", def),
+		pack(pack) {
+			add("packs", pack);
+			return game;
+		},
+		settings(more) {
+			const next = { ...settings };
+			for (const [key, value] of Object.entries(more)) {
+				const was = next[key];
+				next[key] = was && value && typeof was === "object" && typeof value === "object" && !Array.isArray(value) ? {
+					...was,
+					...value
+				} : value;
+			}
+			settings = next;
+			stale = true;
+			return game;
+		},
+		on(event, run, options) {
+			listen(id, event, run, options);
+			return game;
+		},
+		before(name, run, options) {
+			hook(id, "before", name, run, options);
+			return game;
+		},
+		after(name, run, options) {
+			hook(id, "after", name, run, options);
+			return game;
+		},
+		onStart(run) {
+			starts.push(run);
+			return game;
+		},
+		mission(missionId, setup) {
+			const prefix = `${id}.${missionId}`;
+			if (missions.some((each) => each.mission.id === prefix)) throw new Error(`createGame: the mission "${missionId}" is given twice`);
+			const idOf = (name) => `${prefix}.${name}`;
+			const own = [];
+			const plays = [];
+			const mission = {
+				id: prefix,
+				idOf,
+				objective: (def) => ({
+					...def,
+					id: idOf(def.id)
+				}),
+				sequence: (def) => add("sequences", defineSequence({
+					...def,
+					id: idOf(def.id)
+				})),
+				timer: (def) => add("timers", defineTimer({
+					...def,
+					id: idOf(def.id)
+				})),
+				component: (def) => add("components", defineComponent({
+					...def,
+					id: idOf(def.id)
+				})),
+				area: (def) => add("areas", {
+					...def,
+					id: idOf(def.id)
+				}),
+				on(event, run, options) {
+					listen(prefix, event, run, options);
+					return mission;
+				},
+				before(name, run, options) {
+					hook(prefix, "before", name, run, options);
+					return mission;
+				},
+				after(name, run, options) {
+					hook(prefix, "after", name, run, options);
+					return mission;
+				},
+				onStart(run) {
+					own.push(run);
+					return mission;
+				},
+				plays(...names) {
+					plays.push(...names);
+					return mission;
+				},
+				start: (world, context = {}) => inOrder(own.map((run) => () => run(world, {
+					fresh: true,
+					...context
+				})))
+			};
+			setup(mission);
+			missions.push({
+				mission,
+				maps: plays
+			});
+			return mission;
+		},
+		maps(more) {
+			const wrapped = {};
+			for (const [key, map] of Object.entries(more)) if (typeof map !== "function") {
+				keyOfName.set(map.name, key);
+				wrapped[key] = map;
+			} else wrapped[key] = () => map().then((read) => {
+				keyOfName.set(read.name, key);
+				if (!fetched.some((other) => other.name === read.name)) {
+					fetched.push(read);
+					if (built && !init.maps) built.maps = [...built.maps ?? [], read];
+				}
+				return read;
+			});
+			maps = {
+				...maps,
+				...wrapped
+			};
+			stale = true;
+			return game;
+		},
+		view(view) {
+			viewGiven = view;
+			hasView = true;
+			viewFetched = void 0;
+			return game;
+		},
+		async check() {
+			const rules = game.toRules();
+			const { checkRules } = await import("./rulesCheck.js");
+			const problems = [...checkRules(rules)];
+			for (const [field, list] of added) {
+				const seen = /* @__PURE__ */ new Set();
+				for (const def of list) {
+					const id = def.id ?? def.type;
+					if (typeof id !== "string") continue;
+					if (seen.has(id)) problems.push({
+						level: "error",
+						where: field,
+						id,
+						message: `${field} has "${id}" twice: the second takes the first's place`
+					});
+					seen.add(id);
+				}
+			}
+			const units = new Set(rules.units.map((unit) => unit.id));
+			for (const name of Object.keys(maps)) {
+				let map;
+				try {
+					map = await game.loadMap(name);
+				} catch (error) {
+					problems.push({
+						level: "error",
+						where: `maps.${name}`,
+						id: name,
+						message: `The map "${name}" could not be read: ${String(error)}`
+					});
+					continue;
+				}
+				if (map.game !== void 0 && map.game !== rules.id) problems.push({
+					level: "warning",
+					where: `maps.${name}`,
+					id: map.game,
+					message: `The map "${name}" says it is of the game "${map.game}", not "${rules.id}"`
+				});
+				const told = /* @__PURE__ */ new Set();
+				for (const object of map.objects) {
+					if (units.has(object.type) || told.has(object.type)) continue;
+					told.add(object.type);
+					problems.push({
+						level: "error",
+						where: `maps.${name}.objects`,
+						id: object.type,
+						message: `The map "${name}" places a "${object.type}", which no unit type of the game is`
+					});
+				}
+			}
+			return problems;
+		},
+		toRules() {
+			if (!built) {
+				built = build();
+				onNewGameVersion((current) => {
+					if (current === init && built) hotRules(void 0, built, build());
+				});
+			} else if (stale) replaceIn(built, build());
+			stale = false;
+			return built;
+		},
+		toView() {
+			if (!hasView) return Promise.reject(/* @__PURE__ */ new Error(`The game "${id}" has no view: give it one with game.view(…)`));
+			if (!viewFetched) {
+				const view = viewGiven;
+				const fetched = typeof view === "function" ? view().then((module) => {
+					const read = module;
+					if (read && typeof read === "object" && read.view && typeof read.view === "object") return read.view;
+					if (read && typeof read === "object" && "default" in read) return read.default;
+					return module;
+				}) : Promise.resolve(view);
+				viewFetched = fetched;
+				fetched.catch(() => {
+					if (viewFetched === fetched) viewFetched = void 0;
+				});
+			}
+			return viewFetched;
+		},
+		toStart() {
+			if (!starts.length && !missions.length) return void 0;
+			return (world, context) => {
+				const { map } = context;
+				const key = map && keyOfName.get(map.name);
+				const played = map ? missions.filter(({ maps: plays }) => plays.some((name) => sameName(name, map.name) || key !== void 0 && sameName(name, key))) : [];
+				return inOrder([...starts.map((run) => () => run(world, context)), ...played.map(({ mission }) => () => mission.start(world, context))]);
+			};
+		},
+		toMaps: () => maps,
+		async loadMap(name) {
+			const names = Object.keys(maps);
+			const asked = name ?? names[0];
+			if (asked === void 0) throw new Error(`The game "${id}" has no maps: give it some with game.maps(…)`);
+			const map = maps[asked];
+			if (!map) throw new Error(`The game "${id}" has no map "${asked}": its maps are ${names.join(", ")}`);
+			return structuredClone(typeof map === "function" ? await map() : map);
+		}
+	};
+	return game;
+}
+/**
+* A game's module's new version, taken while it runs (hot reload), as `hotRules` takes a module's: at the end of the
+* module that makes the game, the call to Vite written out as it is (Vite finds a module that takes its own new
+* versions by it):
+*
+*     if (import.meta.hot) import.meta.hot.accept((module) => hotGame(import.meta.hot, game, module?.game))
+*
+* The rules the hosts were given are made the new version's in place (`hotRules`); the view, a module of its own, takes
+* its own (the client's `hotView`). What does not go loads the page again
+*
+* @public
+*/
+function hotGame(hot, current, next) {
+	if (!isGame(next)) return hot?.invalidate(`${current.id}: its module does not give the game as it did`);
+	hotRules(hot, current.toRules(), next.toRules());
+}
+//#endregion
+export { createGame, hotGame, isGame, rulesOf, startOf };
+
+//# sourceMappingURL=createGame.js.map

package/dist/createGame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGame.js","names":[],"sources":["../src/createGame.ts"],"sourcesContent":["/*\n * One root object a game is made of (E2E plan AP4): `createGame({ id, name })` gives a `Game` that everything of the\n * game is registered on (its units, abilities, systems, hooks, listeners, missions, maps and its view, fetched as it is\n * needed), and that every host takes (`testWorld`, `startServer`, `mapMode`; the client's `launch`, `startApp`,\n * `appScenes`; the editor's `openEditor`). What it makes is the module underneath (`toRules()`), the full API there as\n * before: a host that is given a `Rules` plays that the same.\n */\nimport type { AbilityDef, BuffDef, ItemDef, ResourceDef, StatDef, UnitTypeDef, UpgradeDef } from './defs'\nimport type { AreaDef } from './areas'\nimport type { BrainDef } from './ai/brain'\nimport type { CellLayerDef } from './cellLayers'\nimport type { CommandDef } from './commands'\nimport { type Component, type ComponentOptions, defineComponent } from './components'\nimport type { EffectType } from './abilities/effects'\nimport { defineListener, type EventKey } from './events'\nimport type { FormationDef } from './formation'\nimport type { Rules } from './game'\nimport type { GameFileDef } from './gameFiles'\nimport type { GamePack } from './packs/pack'\nimport type { HookDef, HookHandler, HookKey, HookName } from './hooks'\nimport type { HotContext } from './hotReload'\nimport { hotRules, onNewGameVersion, replaceIn } from './hotReload'\nimport type { GameMap } from './map'\nimport type { ObjectiveDef } from './objectives'\nimport type { PlayerId } from './entity'\nimport type { PrefabDef } from './prefabs'\nimport type { RaceDef } from './races'\nimport type { OrderBehavior, SystemDef } from './registry'\nimport type { RuleSettingsInit } from './rules'\nimport type { RulesProblem } from './rulesCheck'\nimport { defineSequence, type SequenceDef, type Step } from './sequences'\nimport type { Targeting } from './targeting'\nimport type { TileDef } from './tiles'\nimport { defineTimer, type TimerDef, type TimerInfo } from './timers'\nimport type { TunableDef } from './tunables'\nimport type { World } from './world'\n\n/**\n * What a game's start is told (`Game.onStart`): the map its world was made from, the player at the screen (in a page),\n * the lobby's settings (on a server), and whether the world is new (`fresh`) or loaded from a save, which has\n * everything a start gives already. Each host says what it knows; the rest is left out\n *\n * @public\n */\nexport interface GameStartContext {\n\t/** The map the world was made from; none for a world made in code */\n\tmap?: GameMap\n\t/** The player at the screen, in a page */\n\tplayer?: PlayerId\n\t/** What the lobby set, on a server */\n\tsettings?: Record<string, string>\n\t/** Whether the world is new: false for one loaded from a save. True when left out */\n\tfresh?: boolean\n}\n\n/**\n * What a game does once a world is made, before anyone plays (`Game.onStart`, a mission's `onStart`): computer\n * players seated, a mission given, the first wave sent\n *\n * @public\n */\nexport type GameStart = (world: World, context: GameStartContext) => void | Promise<void>\n\n/**\n * A game's maps by name (`Game.maps`): each the map, or what fetches it as it is first asked for (`mapsFrom` of a lazy\n * glob), so that a page carries none of a map it does not open\n *\n * @public\n */\nexport type GameMaps = Readonly<Record<string, GameMap | (() => Promise<GameMap>)>>\n\n/**\n * What a game is made with (`createGame`): its id and name, and any field of the module underneath (`Rules`) said at\n * once: a whole `Rules` is a game too (`createGame(rules)`). What is registered on the game after comes after what is\n * given here\n *\n * @public\n */\nexport interface GameInit extends Partial<Rules> {\n\t/** The game's id, which a save, a map (`GameMap.game`) and a server know it by */\n\tid: string\n\t/** What the player sees the game called */\n\tname: string\n\t/**\n\t * Packs of content to play it with in a page, by URL (`'/packs/gnomes/pack.json'`): fetched as a game of it is got\n\t * ready, before its world is made, and composed in this order (the client's `mergePacks`). A server plays its own\n\t * (`readPacks`). None when left out\n\t */\n\tcontentPacks?: readonly string[]\n\t/**\n\t * What is done, as its view is fetched in a page, about a view that names what the rules do not have (the client's\n\t * `checkGame`): a warning for each when left out, an error with all of them (`'throw'`), or nothing (`false`)\n\t */\n\tcheckView?: 'warn' | 'throw' | false\n}\n\n/**\n * Where a listener or a hook's handler registered on a game or a mission goes by: an id of its own, in the place of the\n * one made for it (`<game>.on.<event>.<n>`, `<game>.<mission>.before.<hook>.<n>`), and a priority for a hook (lower\n * runs first: `before` is -1 and `after` 1 when left out, the engine's own handlers 0)\n *\n * @public\n */\nexport interface HandlerOptions {\n\t/** Its id, under the game's (or the mission's): `'gate'` is `<game>.gate`. Made for it when left out */\n\tid?: string\n\t/** A hook handler's priority: lower runs first. -1 for `before`, 1 for `after` when left out */\n\tpriority?: number\n}\n\n/**\n * What a mission registers its parts with (`Game.mission`): each part's id is made of the game's, the mission's and its\n * own (`'raze'` in the mission `homecoming` of `my-game` is `my-game.homecoming.raze`), and the parts go into the game's\n * rules, so that a save finds them by those ids. Its `onStart` runs where the world's map is one it `plays`, or as it is\n * `start`ed\n *\n * @public\n */\nexport interface Mission {\n\t/** Its id, the game's and its own: `my-game.homecoming` */\n\treadonly id: string\n\t/** The id of a part of it, by its own name: `my-game.homecoming.raze` for `'raze'` */\n\tidOf(name: string): string\n\t/** An objective of the mission (`defineObjective`), its id made of the mission's */\n\tobjective(def: ObjectiveDef): ObjectiveDef\n\t/** A sequence of steps of the mission (`defineSequence`), its id made of the mission's, listed in the rules */\n\tsequence<D = undefined>(def: { id: string; steps: (Step<D> | readonly Step<D>[])[] }): SequenceDef<D>\n\t/** A timer of the mission (`defineTimer`), its id made of the mission's, listed in the rules */\n\ttimer<T = undefined>(def: { id: string; run: (world: World, data: T, timer: TimerInfo) => void }): TimerDef<T>\n\t/** State the mission keeps (`defineComponent`), its id made of the mission's, listed in the rules */\n\tcomponent<T, S = T>(def: { id: string } & ComponentOptions<T, S>): Component<T, S>\n\t/** A part of the map the mission watches (`AreaDef`), its id made of the mission's, listed in the rules */\n\tarea(def: AreaDef): AreaDef\n\t/** How the mission reacts to an event: a listener of the rules (`defineListener`), its id under the mission's */\n\ton<T>(event: EventKey<T>, run: (world: World, payload: T) => void, options?: HandlerOptions): Mission\n\t/** A handler of a hook that runs before the engine's own (priority -1), its id under the mission's */\n\tbefore<K extends HookName>(hook: K, run: HookHandler<K>, options?: HandlerOptions): Mission\n\t/** A handler of a game's own hook (`HookKey`) that runs before the rest, its id under the mission's */\n\tbefore<T>(hook: HookKey<T>, run: (world: World, event: T) => void, options?: HandlerOptions): Mission\n\t/** A handler of a hook that runs after the engine's own (priority 1), its id under the mission's */\n\tafter<K extends HookName>(hook: K, run: HookHandler<K>, options?: HandlerOptions): Mission\n\t/** A handler of a game's own hook (`HookKey`) that runs after the rest, its id under the mission's */\n\tafter<T>(hook: HookKey<T>, run: (world: World, event: T) => void, options?: HandlerOptions): Mission\n\t/** What the mission does as a world of it starts: its objectives given, its sequences started (`fresh` says whether to) */\n\tonStart(run: GameStart): Mission\n\t/** The maps it is played on, by their name (`GameMap.name`) or their name in `Game.maps`: a world made from one starts it */\n\tplays(...maps: string[]): Mission\n\t/** Starts it on a world: its `onStart` in the order given. What a campaign's scene calls, knowing whether the world is new */\n\tstart(world: World, context?: GameStartContext): void | Promise<void>\n}\n\n/**\n * A game: one object everything of it is registered on, which every host takes (`createGame`). Its rules are made\n * from what it holds (`toRules()`, the module underneath that a server, a test and a worker run); its view is fetched as\n * a page first needs it (`view(() => import('./view'))`, `toView()`), so that the rules are read where nothing draws\n * (a server, a test) without the client. Each method that registers a definition gives it back\n *\n *     export const game = createGame({ id: 'td', name: 'Tower defense' })\n *     export const archer = game.unit({ id: 'archer', name: 'Archer', kind: 'unit', stats: { health: 200 } })\n *     game.on(entityDied, (world, { entity }) => { … })\n *     game.onStart((world, { map }) => { … })\n *     game.maps(mapsFrom(import.meta.glob('./maps/*.vgmap.json', { import: 'default' })))\n *     game.view(() => import('./view'))\n *\n * @public\n */\nexport interface Game<V = unknown> {\n\t/** The game's id (`Rules.id`): what a save, a map, a replay and a server call it by */\n\treadonly id: string\n\t/** What the player sees the game called (`Rules.name`) */\n\treadonly name: string\n\t/** Packs of content to play it with in a page, by URL (`GameInit.contentPacks`) */\n\treadonly contentPacks: readonly string[]\n\t/** What a page does about a view that does not fit the rules as it fetches it (`GameInit.checkView`) */\n\treadonly checkView: 'warn' | 'throw' | false\n\t/** Whether a view was given (`view`): a game without one has rules alone, for a server or a test */\n\treadonly hasView: boolean\n\t/** A unit type (`UnitTypeDef`), building or resource alike */\n\tunit<T extends UnitTypeDef>(def: T): T\n\t/** An ability (`AbilityDef`) */\n\tability<T extends AbilityDef>(def: T): T\n\t/** A buff (`BuffDef`) */\n\tbuff<T extends BuffDef>(def: T): T\n\t/** An item (`ItemDef`) */\n\titem<T extends ItemDef>(def: T): T\n\t/** An upgrade (`UpgradeDef`) */\n\tupgrade<T extends UpgradeDef>(def: T): T\n\t/** A side players can play (`RaceDef`) */\n\trace<T extends RaceDef>(def: T): T\n\t/** What players have amounts of and pay with (`ResourceDef`) */\n\tresource<T extends ResourceDef>(def: T): T\n\t/** A stat of the game's own (`StatDef`) */\n\tstat<T extends StatDef>(def: T): T\n\t/** A system of the game's own (`SystemDef`): after the core ones unless it says a phase; one named as a core one takes its place */\n\tsystem<T extends SystemDef>(def: T): T\n\t/** An order type (`OrderBehavior`), or one in the place of a core one of its type */\n\torder<T extends OrderBehavior>(def: T): T\n\t/** State of its own (`defineComponent`), listed so that a world, a save and a snapshot find it */\n\tcomponent<T extends Component<any, any>>(component: T): T\n\t/** A command of its own (`defineCommand`), or one in the place of a core one */\n\tcommand<T extends CommandDef>(def: T): T\n\t/** An event of its own (`defineEvent`), listed so that a world finds it */\n\tevent<T extends EventKey<any>>(key: T): T\n\t/** A part of the map the rules watch (`AreaDef`) */\n\tarea<T extends AreaDef>(def: T): T\n\t/** A group of things spawned as one (`definePrefab`) */\n\tprefab<T extends PrefabDef>(def: T): T\n\t/** Something set to go off later (`defineTimer`) */\n\ttimer<T extends TimerDef<any>>(def: T): T\n\t/** A script of steps (`defineSequence`) */\n\tsequence<T extends SequenceDef<any>>(def: T): T\n\t/** A file of its own data its rules read (`defineGameFile`) */\n\tfile<T extends GameFileDef<any>>(def: T): T\n\t/** A brain of its computer players (`defineBrain`): the first given is what a seat that names none gets */\n\tbrain<T extends BrainDef>(def: T): T\n\t/** What the ground can be painted with (`TileDef`), in order */\n\ttile<T extends TileDef>(def: T): T\n\t/** A type of effect of its own (`defineEffect`), or one in the place of the engine's of its type */\n\teffect<T extends EffectType>(def: T): T\n\t/** A way of aiming of its own (`defineTargeting`) */\n\ttargeting<T extends Targeting>(def: T): T\n\t/** A formation of its own (`FormationDef`) */\n\tformation<T extends FormationDef>(def: T): T\n\t/** A number of its rules to tune while it plays (`defineTunable`) */\n\ttunable<T extends TunableDef>(def: T): T\n\t/** A layer of cells of its own (`CellLayerDef`) */\n\tcellLayer<T extends CellLayerDef>(def: T): T\n\t/** A part of the rules it opts into (`GamePack`: `heroesPack()`), before its own */\n\tpack(pack: GamePack): Game<V>\n\t/** Its numbers that are not about any one unit (`RuleSettingsInit`), laid over what was said before, group by group */\n\tsettings(settings: RuleSettingsInit): Game<V>\n\t/** How the game reacts to an event, the engine's or its own: a listener (`defineListener`), its id made for it */\n\ton<T>(event: EventKey<T>, run: (world: World, payload: T) => void, options?: HandlerOptions): Game<V>\n\t/** A handler of a hook that runs before the engine's own (priority -1): one that may say no (`event.cancel()`) */\n\tbefore<K extends HookName>(hook: K, run: HookHandler<K>, options?: HandlerOptions): Game<V>\n\t/** A handler of a game's own hook (`HookKey`) that runs before the rest */\n\tbefore<T>(hook: HookKey<T>, run: (world: World, event: T) => void, options?: HandlerOptions): Game<V>\n\t/** A handler of a hook that runs after the engine's own (priority 1): one that reads or changes what they made of it */\n\tafter<K extends HookName>(hook: K, run: HookHandler<K>, options?: HandlerOptions): Game<V>\n\t/** A handler of a game's own hook (`HookKey`) that runs after the rest */\n\tafter<T>(hook: HookKey<T>, run: (world: World, event: T) => void, options?: HandlerOptions): Game<V>\n\t/** What the game does once a world is made, before anyone plays; each given runs, in order, before a mission's */\n\tonStart(run: GameStart): Game<V>\n\t/** A mission: its parts registered through `setup` with ids made of the game's and the mission's (`Mission`) */\n\tmission(id: string, setup: (mission: Mission) => void): Mission\n\t/** Its maps by name, laid over those given before; the first is the one a game is on when nothing says which */\n\tmaps(maps: GameMaps): Game<V>\n\t/**\n\t * Its view (how it looks and sounds: the client's `GameView`), or what fetches it as a page first needs it:\n\t * `() => import('./view')` (a module whose `view` or `default` is the view). Given so, nothing of the client is part\n\t * of what imports the game, which a server and a test do\n\t */\n\tview(view: V | (() => Promise<unknown>)): Game<V>\n\t/**\n\t * What does not fit: the rules against themselves (`checkRules`), ids given twice among what was registered (one\n\t * takes the other's place unseen), and each map (fetched where it is lazy) against the rules: a type it places that\n\t * no unit type is, a map of another game. A save or a map naming an id that nothing registered is what this finds\n\t * before it is played\n\t */\n\tcheck(): Promise<RulesProblem[]>\n\t/**\n\t * The module underneath (`Rules`): what the hosts run. The same object each time; what is registered after it was\n\t * made is put into it in place\n\t */\n\ttoRules(): Rules\n\t/** The view, fetched the first time it is asked for. Throws when none was given */\n\ttoView(): Promise<V>\n\t/** Its start: the `onStart`s given, then the mission whose map the world was made from. None when it has neither */\n\ttoStart(): GameStart | undefined\n\t/** Its maps by name, as given (`maps`) */\n\ttoMaps(): GameMaps\n\t/** A map of it by name (the first when left out), fetched where it is lazy, as a copy: a game changes nothing of the next one's */\n\tloadMap(name?: string): Promise<GameMap>\n}\n\n/** What marks a game made by `createGame` */\nconst GAME = Symbol.for('@v12-engine/engine/game')\n\n/**\n * Whether something is a game made by `createGame`, rather than the module underneath (`Rules`)\n *\n * @public\n */\nexport function isGame(value: unknown): value is Game<unknown> {\n\treturn !!value && typeof value === 'object' && (value as Record<symbol, unknown>)[GAME] === true\n}\n\n/**\n * The module underneath what a host is given: a game's (`toRules()`), or the module itself\n *\n * @beta\n */\nexport function rulesOf(game: Game<unknown> | Rules): Rules {\n\treturn isGame(game) ? game.toRules() : game\n}\n\n/**\n * The start of what a host is given, where it says none of its own: a game's (`toStart()`); a module has none\n *\n * @beta\n */\nexport function startOf(game: Game<unknown> | Rules): GameStart | undefined {\n\treturn isGame(game) ? game.toStart() : undefined\n}\n\n/** The fields of a module that are lists a game registers into, by the method that does */\nconst LISTS = {\n\tunit: 'units',\n\tability: 'abilities',\n\tbuff: 'buffs',\n\titem: 'items',\n\tupgrade: 'upgrades',\n\trace: 'races',\n\tresource: 'resources',\n\tstat: 'stats',\n\tsystem: 'systems',\n\torder: 'orders',\n\tcomponent: 'components',\n\tcommand: 'commands',\n\tevent: 'events',\n\tarea: 'areas',\n\tprefab: 'prefabs',\n\ttimer: 'timers',\n\tsequence: 'sequences',\n\tfile: 'files',\n\tbrain: 'brains',\n\ttile: 'tiles',\n\teffect: 'effects',\n\ttargeting: 'targetings',\n\tformation: 'formations',\n\ttunable: 'tunables',\n\tcellLayer: 'cellLayers',\n\tpack: 'packs',\n\thook: 'hooks',\n\tlistener: 'listeners'\n} as const satisfies Record<string, keyof Rules>\n\ntype ListField = (typeof LISTS)[keyof typeof LISTS]\n\n/**\n * Runs each in order, each after the one before has settled: at once, as long as none gives a promise (a start that is\n * plain code is over when it returns, as a host that does not wait for it expects)\n */\nfunction inOrder(runs: readonly (() => void | Promise<void>)[]): void | Promise<void> {\n\tlet next = 0\n\tconst go = (): void | Promise<void> => {\n\t\twhile (next < runs.length) {\n\t\t\tconst made = runs[next++]()\n\t\t\tif (made && typeof (made as Promise<void>).then === 'function') return (made as Promise<void>).then(go)\n\t\t}\n\t}\n\treturn go()\n}\n\n/** The same name, written otherwise: `Home stead`, `homestead` and `home-stead` are one */\nconst sameName = (a: string, b: string) => a.toLowerCase().replace(/[^a-z0-9]/g, '') === b.toLowerCase().replace(/[^a-z0-9]/g, '')\n\n/**\n * Makes a game: one object its units, abilities, systems, hooks and listeners, missions, maps and view are registered\n * on, which every host takes (`Game`). `init` is its id and name, and any field of the module underneath said at once:\n * `createGame(rules)` makes a game of a module written whole\n *\n * @public\n */\nexport function createGame<V = unknown>(init: GameInit): Game<V> {\n\tconst { contentPacks = [], checkView = 'warn', id, name } = init\n\tif (!id) throw new Error('createGame: a game needs an id')\n\tconst added = new Map<ListField, unknown[]>()\n\t/** The settings given by `settings()`, laid over the module's own as the rules are made */\n\tlet settings: Record<string, unknown> = {}\n\tconst starts: GameStart[] = []\n\tconst missions: Array<{ mission: Mission; maps: string[] }> = []\n\tlet maps: Record<string, GameMap | (() => Promise<GameMap>)> = {}\n\tlet viewGiven: V | (() => Promise<unknown>) | undefined\n\tlet hasView = false\n\tlet viewFetched: Promise<V> | undefined\n\tlet built: Rules | undefined\n\tlet stale = false\n\t/** The name in `maps` of each map read, by its own name (`GameMap.name`) */\n\tconst keyOfName = new Map<string, string>()\n\t/**\n\t * The maps given as loaders (`LazyMaps`) that have been fetched: among the game's maps (`Rules.maps`) from then on, so\n\t * that a save or a server's welcome of a game on one keeps only what changed of its ground, as of a map given whole\n\t */\n\tconst fetched: GameMap[] = []\n\t/** How many handlers each id made for one has been given, so that each is its own */\n\tconst counts = new Map<string, number>()\n\n\tconst add = <T>(field: ListField, def: T): T => {\n\t\tconst list = added.get(field) ?? []\n\t\tlist.push(def)\n\t\tadded.set(field, list)\n\t\tstale = true\n\t\treturn def\n\t}\n\t/** An id made for a handler that was given none: `<under>.<what>.<name>.<n>` */\n\tconst madeId = (under: string, what: string, name: string) => {\n\t\tconst key = `${under}.${what}.${name}`\n\t\tconst n = (counts.get(key) ?? 0) + 1\n\t\tcounts.set(key, n)\n\t\treturn n === 1 ? key : `${key}.${n}`\n\t}\n\tconst hookName = (hook: unknown) => (typeof hook === 'string' ? hook : (hook as { id: string }).id)\n\tconst listen = (under: string, event: EventKey<any>, run: (world: World, payload: any) => void, options?: HandlerOptions) =>\n\t\tadd('listeners', defineListener({ id: options?.id ? `${under}.${options.id}` : madeId(under, 'on', String(event.id)), event, run }))\n\tconst hook = (under: string, when: 'before' | 'after', name: unknown, run: (world: World, event: any) => void, options?: HandlerOptions) =>\n\t\tadd<HookDef>('hooks', {\n\t\t\thook: name as HookDef['hook'],\n\t\t\tid: options?.id ? `${under}.${options.id}` : madeId(under, when, hookName(name)),\n\t\t\tpriority: options?.priority ?? (when === 'before' ? -1 : 1),\n\t\t\trun\n\t\t})\n\n\t/**\n\t * The module, made of what it was given and what was registered since. What it was given is read as it is now: a\n\t * module given whole and taken anew in place while it runs (`hotRules` on it, hot reload) is in the next one made\n\t */\n\tconst build = (): Rules => {\n\t\tconst { contentPacks: _packs, checkView: _check, ...given } = init\n\t\tconst rules: Rules = { ...given, units: [...(given.units ?? [])] } as Rules\n\t\tconst into = rules as unknown as Record<string, unknown[] | undefined>\n\t\tfor (const [field, list] of added) into[field] = [...(into[field] ?? []), ...list]\n\t\tif (Object.keys(settings).length) {\n\t\t\tconst merged: Record<string, unknown> = { ...given.settings }\n\t\t\tfor (const [key, value] of Object.entries(settings)) {\n\t\t\t\tconst was = merged[key]\n\t\t\t\tmerged[key] = was && value && typeof was === 'object' && typeof value === 'object' && !Array.isArray(value) ? { ...was, ...value } : value\n\t\t\t}\n\t\t\trules.settings = merged as RuleSettingsInit\n\t\t}\n\t\tconst loaded = [...Object.values(maps).filter((map): map is GameMap => typeof map !== 'function'), ...fetched]\n\t\tif (!given.maps && loaded.length) rules.maps = loaded\n\t\treturn rules\n\t}\n\n\tconst game: Game<V> & { [GAME]: true } = {\n\t\t[GAME]: true,\n\t\tid,\n\t\tname,\n\t\tcontentPacks: [...contentPacks],\n\t\tcheckView,\n\t\tget hasView() {\n\t\t\treturn hasView\n\t\t},\n\t\tunit: (def) => add('units', def),\n\t\tability: (def) => add('abilities', def),\n\t\tbuff: (def) => add('buffs', def),\n\t\titem: (def) => add('items', def),\n\t\tupgrade: (def) => add('upgrades', def),\n\t\trace: (def) => add('races', def),\n\t\tresource: (def) => add('resources', def),\n\t\tstat: (def) => add('stats', def),\n\t\tsystem: (def) => add('systems', def),\n\t\torder: (def) => add('orders', def),\n\t\tcomponent: (component) => add('components', component),\n\t\tcommand: (def) => add('commands', def),\n\t\tevent: (key) => add('events', key),\n\t\tarea: (def) => add('areas', def),\n\t\tprefab: (def) => add('prefabs', def),\n\t\ttimer: (def) => add('timers', def),\n\t\tsequence: (def) => add('sequences', def),\n\t\tfile: (def) => add('files', def),\n\t\tbrain: (def) => add('brains', def),\n\t\ttile: (def) => add('tiles', def),\n\t\teffect: (def) => add('effects', def),\n\t\ttargeting: (def) => add('targetings', def),\n\t\tformation: (def) => add('formations', def),\n\t\ttunable: (def) => add('tunables', def),\n\t\tcellLayer: (def) => add('cellLayers', def),\n\t\tpack(pack) {\n\t\t\tadd('packs', pack)\n\t\t\treturn game\n\t\t},\n\t\tsettings(more) {\n\t\t\tconst next: Record<string, unknown> = { ...settings }\n\t\t\tfor (const [key, value] of Object.entries(more)) {\n\t\t\t\tconst was = next[key]\n\t\t\t\tnext[key] = was && value && typeof was === 'object' && typeof value === 'object' && !Array.isArray(value) ? { ...was, ...value } : value\n\t\t\t}\n\t\t\tsettings = next\n\t\t\tstale = true\n\t\t\treturn game\n\t\t},\n\t\ton(event, run, options) {\n\t\t\tlisten(id, event, run, options)\n\t\t\treturn game\n\t\t},\n\t\tbefore(name: unknown, run: (world: World, event: any) => void, options?: HandlerOptions) {\n\t\t\thook(id, 'before', name, run, options)\n\t\t\treturn game\n\t\t},\n\t\tafter(name: unknown, run: (world: World, event: any) => void, options?: HandlerOptions) {\n\t\t\thook(id, 'after', name, run, options)\n\t\t\treturn game\n\t\t},\n\t\tonStart(run) {\n\t\t\tstarts.push(run)\n\t\t\treturn game\n\t\t},\n\t\tmission(missionId, setup) {\n\t\t\tconst prefix = `${id}.${missionId}`\n\t\t\tif (missions.some((each) => each.mission.id === prefix)) throw new Error(`createGame: the mission \"${missionId}\" is given twice`)\n\t\t\tconst idOf = (name: string) => `${prefix}.${name}`\n\t\t\tconst own: GameStart[] = []\n\t\t\tconst plays: string[] = []\n\t\t\tconst mission: Mission = {\n\t\t\t\tid: prefix,\n\t\t\t\tidOf,\n\t\t\t\tobjective: (def) => ({ ...def, id: idOf(def.id) }),\n\t\t\t\tsequence: (def) => add('sequences', defineSequence({ ...def, id: idOf(def.id) })),\n\t\t\t\ttimer: (def) => add('timers', defineTimer({ ...def, id: idOf(def.id) })),\n\t\t\t\tcomponent: (def) => add('components', defineComponent({ ...def, id: idOf(def.id) })),\n\t\t\t\tarea: (def) => add('areas', { ...def, id: idOf(def.id) }),\n\t\t\t\ton(event, run, options) {\n\t\t\t\t\tlisten(prefix, event, run, options)\n\t\t\t\t\treturn mission\n\t\t\t\t},\n\t\t\t\tbefore(name: unknown, run: (world: World, event: any) => void, options?: HandlerOptions) {\n\t\t\t\t\thook(prefix, 'before', name, run, options)\n\t\t\t\t\treturn mission\n\t\t\t\t},\n\t\t\t\tafter(name: unknown, run: (world: World, event: any) => void, options?: HandlerOptions) {\n\t\t\t\t\thook(prefix, 'after', name, run, options)\n\t\t\t\t\treturn mission\n\t\t\t\t},\n\t\t\t\tonStart(run) {\n\t\t\t\t\town.push(run)\n\t\t\t\t\treturn mission\n\t\t\t\t},\n\t\t\t\tplays(...names) {\n\t\t\t\t\tplays.push(...names)\n\t\t\t\t\treturn mission\n\t\t\t\t},\n\t\t\t\tstart: (world, context = {}) => inOrder(own.map((run) => () => run(world, { fresh: true, ...context })))\n\t\t\t}\n\t\t\tsetup(mission)\n\t\t\tmissions.push({ mission, maps: plays })\n\t\t\treturn mission\n\t\t},\n\t\tmaps(more) {\n\t\t\tconst wrapped: Record<string, GameMap | (() => Promise<GameMap>)> = {}\n\t\t\tfor (const [key, map] of Object.entries(more)) {\n\t\t\t\tif (typeof map !== 'function') {\n\t\t\t\t\tkeyOfName.set(map.name, key)\n\t\t\t\t\twrapped[key] = map\n\t\t\t\t} else\n\t\t\t\t\t// a map fetched is known by its name from then on, for the start to find its mission by\n\t\t\t\t\twrapped[key] = () =>\n\t\t\t\t\t\tmap().then((read) => {\n\t\t\t\t\t\t\tkeyOfName.set(read.name, key)\n\t\t\t\t\t\t\tif (!fetched.some((other) => other.name === read.name)) {\n\t\t\t\t\t\t\t\tfetched.push(read)\n\t\t\t\t\t\t\t\t// the rules made already (what the hosts hold) know it in place, as the next made will\n\t\t\t\t\t\t\t\tif (built && !init.maps) built.maps = [...(built.maps ?? []), read]\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\treturn read\n\t\t\t\t\t\t})\n\t\t\t}\n\t\t\tmaps = { ...maps, ...wrapped }\n\t\t\tstale = true\n\t\t\treturn game\n\t\t},\n\t\tview(view) {\n\t\t\tviewGiven = view\n\t\t\thasView = true\n\t\t\tviewFetched = undefined\n\t\t\treturn game\n\t\t},\n\t\tasync check() {\n\t\t\tconst rules = game.toRules()\n\t\t\t// (the checks fetched as they are asked for: a page that imports the game carries none of them)\n\t\t\tconst { checkRules } = await import('./rulesCheck')\n\t\t\tconst problems: RulesProblem[] = [...checkRules(rules)]\n\t\t\t// what was registered twice: the second takes the first's place, and nothing says so\n\t\t\tfor (const [field, list] of added) {\n\t\t\t\tconst seen = new Set<string>()\n\t\t\t\tfor (const def of list) {\n\t\t\t\t\tconst id = (def as { id?: unknown; type?: unknown }).id ?? (def as { type?: unknown }).type\n\t\t\t\t\tif (typeof id !== 'string') continue\n\t\t\t\t\tif (seen.has(id)) problems.push({ level: 'error', where: field, id, message: `${field} has \"${id}\" twice: the second takes the first's place` })\n\t\t\t\t\tseen.add(id)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst units = new Set(rules.units.map((unit) => unit.id))\n\t\t\tfor (const name of Object.keys(maps)) {\n\t\t\t\tlet map: GameMap\n\t\t\t\ttry {\n\t\t\t\t\tmap = await game.loadMap(name)\n\t\t\t\t} catch (error) {\n\t\t\t\t\tproblems.push({ level: 'error', where: `maps.${name}`, id: name, message: `The map \"${name}\" could not be read: ${String(error)}` })\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tif (map.game !== undefined && map.game !== rules.id)\n\t\t\t\t\tproblems.push({ level: 'warning', where: `maps.${name}`, id: map.game, message: `The map \"${name}\" says it is of the game \"${map.game}\", not \"${rules.id}\"` })\n\t\t\t\tconst told = new Set<string>()\n\t\t\t\tfor (const object of map.objects) {\n\t\t\t\t\tif (units.has(object.type) || told.has(object.type)) continue\n\t\t\t\t\ttold.add(object.type)\n\t\t\t\t\tproblems.push({\n\t\t\t\t\t\tlevel: 'error',\n\t\t\t\t\t\twhere: `maps.${name}.objects`,\n\t\t\t\t\t\tid: object.type,\n\t\t\t\t\t\tmessage: `The map \"${name}\" places a \"${object.type}\", which no unit type of the game is`\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn problems\n\t\t},\n\t\ttoRules() {\n\t\t\tif (!built) {\n\t\t\t\tbuilt = build()\n\t\t\t\t// the module it was given taken anew in place (hot reload, `hotRules`): the rules the hosts hold take it too\n\t\t\t\tonNewGameVersion((current) => {\n\t\t\t\t\tif (current === init && built) hotRules(undefined, built, build())\n\t\t\t\t})\n\t\t\t} else if (stale) replaceIn(built, build())\n\t\t\tstale = false\n\t\t\treturn built\n\t\t},\n\t\ttoView() {\n\t\t\tif (!hasView) return Promise.reject(new Error(`The game \"${id}\" has no view: give it one with game.view(…)`))\n\t\t\tif (!viewFetched) {\n\t\t\t\tconst view = viewGiven\n\t\t\t\tconst fetched =\n\t\t\t\t\ttypeof view === 'function'\n\t\t\t\t\t\t? (view as () => Promise<unknown>)().then((module) => {\n\t\t\t\t\t\t\t\tconst read = module as { view?: unknown; default?: unknown } | null\n\t\t\t\t\t\t\t\tif (read && typeof read === 'object' && read.view && typeof read.view === 'object') return read.view as V\n\t\t\t\t\t\t\t\tif (read && typeof read === 'object' && 'default' in read) return read.default as V\n\t\t\t\t\t\t\t\treturn module as V\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t: Promise.resolve(view as V)\n\t\t\t\tviewFetched = fetched\n\t\t\t\t// a fetch that failed is tried again the next time it is asked for\n\t\t\t\tfetched.catch(() => {\n\t\t\t\t\tif (viewFetched === fetched) viewFetched = undefined\n\t\t\t\t})\n\t\t\t}\n\t\t\treturn viewFetched\n\t\t},\n\t\ttoStart() {\n\t\t\tif (!starts.length && !missions.length) return undefined\n\t\t\treturn (world, context) => {\n\t\t\t\tconst { map } = context\n\t\t\t\tconst key = map && keyOfName.get(map.name)\n\t\t\t\tconst played = map\n\t\t\t\t\t? missions.filter(({ maps: plays }) => plays.some((name) => sameName(name, map.name) || (key !== undefined && sameName(name, key))))\n\t\t\t\t\t: []\n\t\t\t\treturn inOrder([...starts.map((run) => () => run(world, context)), ...played.map(({ mission }) => () => mission.start(world, context))])\n\t\t\t}\n\t\t},\n\t\ttoMaps: () => maps,\n\t\tasync loadMap(name) {\n\t\t\tconst names = Object.keys(maps)\n\t\t\tconst asked = name ?? names[0]\n\t\t\tif (asked === undefined) throw new Error(`The game \"${id}\" has no maps: give it some with game.maps(…)`)\n\t\t\tconst map = maps[asked]\n\t\t\tif (!map) throw new Error(`The game \"${id}\" has no map \"${asked}\": its maps are ${names.join(', ')}`)\n\t\t\treturn structuredClone(typeof map === 'function' ? await map() : map)\n\t\t}\n\t}\n\treturn game\n}\n\n/**\n * A game's module's new version, taken while it runs (hot reload), as `hotRules` takes a module's: at the end of the\n * module that makes the game, the call to Vite written out as it is (Vite finds a module that takes its own new\n * versions by it):\n *\n *     if (import.meta.hot) import.meta.hot.accept((module) => hotGame(import.meta.hot, game, module?.game))\n *\n * The rules the hosts were given are made the new version's in place (`hotRules`); the view, a module of its own, takes\n * its own (the client's `hotView`). What does not go loads the page again\n *\n * @public\n */\nexport function hotGame(hot: HotContext | undefined, current: Game<unknown>, next: unknown): void {\n\tif (!isGame(next)) return hot?.invalidate(`${current.id}: its module does not give the game as it did`)\n\thotRules(hot, current.toRules(), next.toRules())\n}\n"],"mappings":"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"}

package/dist/dashing.d.ts

@@ -1,8 +1,24 @@
 import type { Dash } from './entity';
+/**
+ * What everyone who sees a unit on a rush is told of it (`EntityState.components['core.dashing']`), for the screen to
+ * draw it by (a trail, the look of the effect that sent it: `AbilityLook.effects`)
+ *
+ * @beta
+ */
+export interface DashSight {
+    /** The ability that sent it */
+    ability: string;
+    /** Which effect of it, by its place in the ability (`effectIndex`), where it is one written there */
+    effect?: number;
+    /** Dragged by someone (a pull), rather than rushing by itself */
+    pulled?: boolean;
+    /** Rising on the way: a leap */
+    leap?: boolean;
+}
 /**
  * An entity on a rush (`Dash`): where it goes, how fast, what it does as it lands. Filed (`index`), for what moves
- * those on one
+ * those on one; told to everyone who sees it as a `DashSight`
  *
  * @beta
  */
-export declare const dashing: import("./components").Component<Dash, Dash>;
+export declare const dashing: import("./components").Component<Dash, DashSight>;

package/dist/dashing.js

@@ -0,0 +1,41 @@
+import { defineComponent } from "./components.js";
+import { effectRef, resolveEffect } from "./effectRefs.js";
+//#region src/dashing.ts
+/**
+* An entity on a rush (`Dash`): a charge, a leap, a blink that travels. Made by the effect that starts it, taken off
+* as it lands; kept in a save with its effects as where they are in its ability
+*/
+/**
+* An entity on a rush (`Dash`): where it goes, how fast, what it does as it lands. Filed (`index`), for what moves
+* those on one; told to everyone who sees it as a `DashSight`
+*
+* @beta
+*/
+var dashing = defineComponent({
+	id: "core.dashing",
+	index: true,
+	replicate: "everyone",
+	snapshot: (dash) => ({
+		ability: dash.ability,
+		...dash.effect !== void 0 && { effect: dash.effect },
+		...dash.pulled && { pulled: true },
+		...dash.height && { leap: true }
+	}),
+	same: (a, b) => a.ability === b.ability && a.effect === b.effect && a.pulled === b.pulled && a.leap === b.leap,
+	refs: (saved) => saved.effects && "path" in saved.effects ? { abilities: [saved.ability] } : {},
+	save: (dash, world) => ({
+		...dash,
+		effects: effectRef(world.registry, dash.ability, dash.effects)
+	}),
+	load: (saved, registry) => {
+		const dash = saved;
+		return {
+			...dash,
+			effects: resolveEffect(registry, dash.ability, dash.effects)
+		};
+	}
+});
+//#endregion
+export { dashing };
+
+//# sourceMappingURL=dashing.js.map

package/dist/dashing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashing.js","names":[],"sources":["../src/dashing.ts"],"sourcesContent":["/**\n * An entity on a rush (`Dash`): a charge, a leap, a blink that travels. Made by the effect that starts it, taken off\n * as it lands; kept in a save with its effects as where they are in its ability\n */\nimport { defineComponent } from './components'\nimport { effectRef, type EffectRef, resolveEffect } from './effectRefs'\nimport type { Dash } from './entity'\n\n/**\n * What everyone who sees a unit on a rush is told of it (`EntityState.components['core.dashing']`), for the screen to\n * draw it by (a trail, the look of the effect that sent it: `AbilityLook.effects`)\n *\n * @beta\n */\nexport interface DashSight {\n\t/** The ability that sent it */\n\tability: string\n\t/** Which effect of it, by its place in the ability (`effectIndex`), where it is one written there */\n\teffect?: number\n\t/** Dragged by someone (a pull), rather than rushing by itself */\n\tpulled?: boolean\n\t/** Rising on the way: a leap */\n\tleap?: boolean\n}\n\n/**\n * An entity on a rush (`Dash`): where it goes, how fast, what it does as it lands. Filed (`index`), for what moves\n * those on one; told to everyone who sees it as a `DashSight`\n *\n * @beta\n */\nexport const dashing = defineComponent<Dash, DashSight>({\n\tid: 'core.dashing',\n\tindex: true,\n\treplicate: 'everyone',\n\tsnapshot: (dash) => ({\n\t\tability: dash.ability,\n\t\t...(dash.effect !== undefined && { effect: dash.effect }),\n\t\t...(dash.pulled && { pulled: true }),\n\t\t...(dash.height && { leap: true })\n\t}),\n\tsame: (a, b) => a.ability === b.ability && a.effect === b.effect && a.pulled === b.pulled && a.leap === b.leap,\n\t// an effect kept as where it is in its ability: the ability has to be there\n\trefs: (saved) =>\n\t\t(saved as { effects: EffectRef }).effects && 'path' in (saved as { effects: EffectRef }).effects ? { abilities: [(saved as Dash).ability] } : {},\n\tsave: (dash, world) => ({ ...dash, effects: effectRef(world.registry, dash.ability, dash.effects) }),\n\tload: (saved, registry) => {\n\t\tconst dash = saved as Dash & { effects: EffectRef }\n\t\treturn { ...dash, effects: resolveEffect(registry, dash.ability, dash.effects) }\n\t}\n})\n"],"mappings":";;;;;;;;;;;;;AA+BA,IAAa,UAAU,gBAAiC;CACvD,IAAI;CACJ,OAAO;CACP,WAAW;CACX,WAAW,UAAU;EACpB,SAAS,KAAK;EACd,GAAI,KAAK,WAAW,KAAA,KAAa,EAAE,QAAQ,KAAK,OAAO;EACvD,GAAI,KAAK,UAAU,EAAE,QAAQ,KAAK;EAClC,GAAI,KAAK,UAAU,EAAE,MAAM,KAAK;CACjC;CACA,OAAO,GAAG,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE;CAE1G,OAAO,UACL,MAAiC,WAAW,UAAW,MAAiC,UAAU,EAAE,WAAW,CAAE,MAAe,OAAO,EAAE,IAAI,CAAC;CAChJ,OAAO,MAAM,WAAW;EAAE,GAAG;EAAM,SAAS,UAAU,MAAM,UAAU,KAAK,SAAS,KAAK,OAAO;CAAE;CAClG,OAAO,OAAO,aAAa;EAC1B,MAAM,OAAO;EACb,OAAO;GAAE,GAAG;GAAM,SAAS,cAAc,UAAU,KAAK,SAAS,KAAK,OAAO;EAAE;CAChF;AACD,CAAC"}

package/dist/debug.d.ts

@@ -8,11 +8,19 @@
  * @beta
  */
 export interface DebugChecks {
+    /** Whether `statsOf` is checked against adding the stats up from scratch */
     stats: boolean;
+    /** Whether scenery is checked every tick for having nothing the per-tick systems should see to */
     scenery: boolean;
+    /** Whether `World.index` is checked every tick against the entities */
     index: boolean;
+    /** Whether each snapshot's sight is checked against testing every entity of the world */
     sight: boolean;
+    /** Whether what a snapshot tells of an entity again from last time is checked against describing it anew */
+    snapshots: boolean;
+    /** Whether replicated events are checked to be plain data that could cross a network */
     events: boolean;
+    /** Whether every think of every computer player's brain is checked against the invariants of `ai/checks.ts` */
     ai: boolean;
 }
 /** The process's: what a world that says nothing starts with */

package/dist/debug.js

@@ -1,3 +1,5 @@
-import { C as speedCommand, D as winCommand, E as unplaceCommand, No as setDebugChecks, S as spawnPrefabCommand, _ as researchCommand, a as experienceCommand, b as setOwnerCommand, c as giveItemCommand, d as killCommand, f as loseCommand, g as redefineCommand, h as placeCommand, i as defineDebugCommand, l as groundCommand, m as paintCommand, n as debugCommands, o as exploreCommand, p as mapObjectCommand, s as giveCommand, t as cheatCommand, u as hourCommand, v as revealCommand, w as teleportCommand, x as spawnCommand, y as setLevelCommand } from "./debugCommands-CzjrSm66.js";
-import { a as summarize, i as setInspected, n as inspect, r as listWorld, t as EventLog } from "./inspect-D9dWHmZ0.js";
-export { EventLog, cheatCommand, debugCommands, defineDebugCommand, experienceCommand, exploreCommand, giveCommand, giveItemCommand, groundCommand, hourCommand, inspect, killCommand, listWorld, loseCommand, mapObjectCommand, paintCommand, placeCommand, redefineCommand, researchCommand, revealCommand, setDebugChecks, setInspected, setLevelCommand, setOwnerCommand, spawnCommand, spawnPrefabCommand, speedCommand, summarize, teleportCommand, unplaceCommand, winCommand };
+import { setDebugChecks } from "./debug2.js";
+import { cheatCommand, debugCommands, defineDebugCommand, experienceCommand, exploreCommand, giveCommand, giveItemCommand, groundCommand, hourCommand, killCommand, loseCommand, mapObjectCommand, paintCommand, placeCommand, redefineCommand, researchCommand, revealCommand, setLevelCommand, setOwnerCommand, spawnCommand, spawnPrefabCommand, speedCommand, teleportCommand, unplaceCommand, winCommand } from "./debugCommands.js";
+import { cellStylesCommand, foliageCommand, foliageDebugCommands, windCommand } from "./foliageDebug.js";
+import { EventLog, inspect, listWorld, setInspected, summarize } from "./inspect.js";
+export { EventLog, cellStylesCommand, cheatCommand, debugCommands, defineDebugCommand, experienceCommand, exploreCommand, foliageCommand, foliageDebugCommands, giveCommand, giveItemCommand, groundCommand, hourCommand, inspect, killCommand, listWorld, loseCommand, mapObjectCommand, paintCommand, placeCommand, redefineCommand, researchCommand, revealCommand, setDebugChecks, setInspected, setLevelCommand, setOwnerCommand, spawnCommand, spawnPrefabCommand, speedCommand, summarize, teleportCommand, unplaceCommand, winCommand, windCommand };