@v12-engine/engine 0.1.0 → 0.4.0

package/dist/game.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.js","names":[],"sources":["../src/game.ts"],"sourcesContent":["import type { CellLayerDef } from './cellLayers'\nimport { regionCinematic } from './cinematics'\nimport type { GameFileDef } from './gameFiles'\nimport { toldBuffOff, toldBuffOn } from './abilities/buffs'\nimport { toldCast, toldCastCancelled, toldChannelEnded, toldChannelStarted, toldWindup } from './abilities/castTold'\nimport { toldMana, toldMissileHit } from './abilities/effects'\nimport { toldStrike } from './abilities/land'\nimport { toldCells, toldCellsSeen } from './cellLayers'\nimport { cameraPart, toldCamera } from './cameraOrders'\nimport { toldCinematic, toldCinematicCue } from './cinematics'\nimport { toldCommand } from './commands'\nimport { toldRustle } from './concealment'\nimport { toldGust } from './foliage'\nimport { toldLine, toldLineEnded } from './dialog'\nimport { toldFx, toldFxStopped } from './effects'\nimport { toldBounty } from './features'\nimport { toldRedefined } from './gameData'\nimport { toldLevelUp, toldRevived, toldXp } from './hero'\nimport { itemTier, toldPicked } from './items'\nimport { toldCrit, toldDamage, toldDeath, toldHeal } from './life'\nimport { toldEnvironment } from './map'\nimport { toldMessage } from './messages'\nimport { toldObjective } from './objectives'\nimport { eventsPart, type ReplicatedEvent, type SnapshotField, snapshotField } from './replication'\nimport { debugPart } from './debugCommands'\nimport { hourPart } from './clock'\nimport { outcomePart } from './systems/victory'\nimport { projectilesPart } from './systems/combatTold'\nimport { missilesPart } from './abilities/effects'\nimport { itemsPart } from './items'\nimport { revealsPart } from './systems/fog'\nimport { areasPart } from './abilities/screen'\nimport { scoreLinePart, scorePart } from './score'\nimport { corpsesPart } from './summons'\nimport { toldAttack, toldAttackCancelled, toldImpact, toldMiss, toldShot } from './systems/combatTold'\nimport { toldBuilt, toldConstructionCancelled, toldConstructionStarted, toldWork } from './systems/construction'\nimport { toldChop, toldResource } from './systems/economy'\nimport { toldResearched, toldTrained, toldUpgradeStarted } from './systems/production'\nimport { toldUpgradeCancelled } from './systems/productionQueue'\nimport { toldChat, toldPing } from './talk'\nimport { toldMorphed } from './tech'\nimport type { PrefabDef } from './prefabs'\nimport type { MapGenerator } from './generate'\nimport type { ErrorPolicy } from './errors'\nimport type { Logger, LogLevel } from './log'\nimport type { Component } from './components'\nimport type { EventKey } from './events'\nimport type { EffectType } from './abilities/effects'\nimport type { Targeting } from './targeting'\nimport { coreEffects } from './abilities/effects/core'\nimport { coreFormations, type FormationDef } from './formation'\nimport { type CommandDef, coreCommands } from './commands'\nimport { debugCommands, redefineCommand, toldGround } from './debugCommands'\nimport { foliageDebugCommands } from './foliageDebug'\nimport { drawFromGroup, dropFromTable } from './randomGroups'\nimport { boardOrder, loadOrder, transportSank, transportSystem, unloadOrder } from './transport'\nimport { gateStates, setUpGates } from './gates'\nimport { tuneCommand, type TunableDef } from './tunables'\nimport type { EditableData } from './gameData'\nimport { spawnCamp } from './camps'\nimport { corpseSystem, summonEffects } from './summons'\nimport { dispelEffects } from './abilities/dispel'\nimport { coreHooks } from './features'\nimport type { HookDef } from './hooks'\nimport { checkRaces, type RaceDef, raceHooks, raceResources } from './races'\nimport { spawnStartingBase, type StartingBase } from './start'\nimport {\n\ttype AbilityDef,\n\ttype BuffDef,\n\ttype Cost,\n\ttype DayCycle,\n\ttype ItemDef,\n\tnoStats,\n\ttype ResourceDef,\n\ttype ResourceId,\n\ttype StatDef,\n\ttype Stats,\n\ttype TagDef,\n\ttype UnitTypeDef,\n\ttype UpgradeDef,\n\ttype UpkeepTier\n} from './defs'\nimport type { ChosenDefaults } from './defaultSets'\nimport { RecastNavigation, type RecastNavigationOptions } from './navigation/recast'\nimport { allOrFreed } from './navigation/builds'\nimport { SidePaths, sideKnowledgeSystem } from './navigation/sidePaths'\nimport { SizedNavigation } from './navigation/sized'\nimport type { Navigation } from './navigation/navigation'\nimport {\n\tattackGroundOrder,\n\tattackMoveOrder,\n\tattackOrder,\n\tattackPathOrder,\n\tpatrolPathOrder,\n\tfollowOrder,\n\tfollowPathOrder,\n\tholdOrder,\n\tmoveOrder,\n\tpatrolOrder\n} from './orders/basic'\nimport { buildOrder, constructOrder, repairOrder } from './orders/build'\nimport { castOrder } from './orders/cast'\nimport { dropItemOrder, pickUpOrder } from './orders/items'\nimport { harvestOrder, returnOrder } from './orders/harvest'\nimport type { Entity, PlayerId } from './entity'\nimport type { BrainDef } from './ai/brain'\nimport type { GameAi } from './ai/profiles'\nimport type { GamePack } from './packs/pack'\nimport type { StatField } from './stats'\nimport type { MapProblem } from './mapFields'\nimport { inventorySlots } from './inventory'\nimport { gathering } from './orders/harvest'\nimport { productionQueue } from './systems/productionQueue'\nimport { cargo } from './transport'\nimport { fieldValues, type MapEditorDef, mapCampData, mapFields, mapRegionData, mapPlayerData } from './mapFields'\nimport { MAX_TILES, type TileDef } from './tiles'\nimport { DEFAULT_MAX_PLAYERS, type GameMap, MAP_CREEPS, MAP_NEUTRAL, MAX_MAP_PLAYERS, type MapObjectOrder } from './map'\nimport { mapInfo } from './names'\nimport { type GameData, layData } from './gameData'\nimport type { PlayerInit, Purse } from './player'\nimport { type OrderBehavior, Registry, type System, type SystemDef } from './registry'\nimport { overSettings, resolveSettings, type RuleSettingsInit } from './rules'\nimport { abilitySystem } from './systems/abilities'\nimport { combatSystem } from './systems/combat'\nimport { constructionSystem } from './systems/construction'\nimport { supplySystem } from './systems/economy'\nimport { fogSystem } from './systems/fog'\nimport { lifeSystem } from './systems/life'\nimport { formSystem } from './forms'\nimport { movementSystem } from './systems/movement'\nimport { orderSystem } from './systems/orders'\nimport { productionSystem } from './systems/production'\nimport { lastTeamStanding } from './systems/victory'\nimport type { Terrain } from './terrain'\nimport { restoreWorld, SaveError, savedPlayers, type SaveRules, updateSave, type WorldSave } from './save'\nimport { cloneTerrain, groundOf, MissingGround, startedOn, startingTerrain } from './ground'\nimport { World, type WorldChecks } from './world'\nimport { resolveScore, scoreSystem } from './score'\nimport { type AreaDef, areaSystem } from './areas'\nimport { type SequenceDef, sequenceSystem } from './sequences'\nimport { type TimerDef, timerSystem } from './timers'\nimport type { ListenerDef } from './events'\nimport { giveMapOrders, spawnMapObject } from './mapObjects'\nimport { coreComponents } from './coreComponents'\nimport { hasGroundSpeeds, navigationSpeedOn } from './groundSpeed'\n\nconst coreOrders: OrderBehavior[] = [\n\tmoveOrder,\n\tholdOrder,\n\tattackOrder,\n\tattackMoveOrder,\n\tfollowPathOrder,\n\tattackPathOrder,\n\tpatrolPathOrder,\n\tattackGroundOrder,\n\tpatrolOrder,\n\tfollowOrder,\n\tharvestOrder,\n\treturnOrder,\n\tbuildOrder,\n\tconstructOrder,\n\trepairOrder,\n\tcastOrder,\n\tpickUpOrder,\n\tdropItemOrder,\n\tboardOrder,\n\tloadOrder,\n\tunloadOrder\n]\n\n/**\n * The systems the engine brings along, by phase: decisions first, then movement, then everything that reacts to where\n * units ended up. Within a phase, in this order. A module can do without any of them by name (`Rules.withoutSystems`),\n * or put its own in place of one by giving a system the same name\n *\n * @beta\n */\nexport const coreSystems: readonly System[] = [\n\ttimerSystem,\n\tabilitySystem,\n\torderSystem,\n\tmovementSystem,\n\tcombatSystem,\n\tconstructionSystem,\n\tproductionSystem,\n\tsupplySystem,\n\tareaSystem,\n\tformSystem,\n\tlifeSystem,\n\tfogSystem,\n\tsequenceSystem,\n\ttransportSystem,\n\tcorpseSystem\n]\n\n/**\n * A game module is the data and rules of one kind of game. The engine knows nothing\n * about peasants or town halls, it gets all of that from here.\n *\n * @public\n */\nexport interface Rules {\n\t/** The game's id, which a save and a server know it by */\n\tid: string\n\t/** What the player sees the game called */\n\tname: string\n\t/** `major.minor.patch`, for mods to say which versions of the game they work with. 1.0.0 when left out */\n\tversion?: string\n\t/** The mods on it, with their versions, when it was made with `composeGame` */\n\tmods?: { id: string; version: string; hash?: string }[]\n\t/**\n\t * Players a map of the game may have, besides the neutral and the creeps: 8 when left out, 32 at most\n\t * (`MAX_MAP_PLAYERS`). A map with more is refused, saying so, not cut\n\t */\n\tmaxPlayers?: number\n\t/** The unit types of the game */\n\tunits: UnitTypeDef[]\n\t/**\n\t * The sides players can play, each with its own roster (`UnitTypeDef.race`): none when left out, and with that no\n\t * race anywhere. The first is what a player plays when nobody chose\n\t */\n\traces?: RaceDef[]\n\t/** The upgrades of the game; none when left out */\n\tupgrades?: UpgradeDef[]\n\t/** The abilities of the game; none when left out */\n\tabilities?: AbilityDef[]\n\t/** The buffs of the game; none when left out */\n\tbuffs?: BuffDef[]\n\t/** The items of the game; none when left out */\n\titems?: ItemDef[]\n\t/**\n\t * The tags of its items named and given a look, and which of them a shop filters by (`TagDef`). A tag no\n\t * definition names still works, shown as its word. None when left out\n\t *\n\t * @beta\n\t */\n\ttags?: TagDef[]\n\t/**\n\t * The default sets the game took (`useDefaults`), what it chose of each, and how to choose again (what a\n\t * `data.json`'s `defaults` does). Set by `useDefaults`, never by hand\n\t *\n\t * @beta\n\t */\n\tdefaults?: ChosenDefaults\n\t/** What players have amounts of and pay with, in the order they are shown. None when left out */\n\tresources?: ResourceDef[]\n\t/** The resource prices, bounties, revives and sales are in. The first resource when left out */\n\tcurrency?: ResourceId\n\t/** The tiers of upkeep, by supply used; none when left out */\n\tupkeep?: UpkeepTier[]\n\t/** Stats of the game's own, next to the engine's (`CoreStats`). Units, buffs, items and upgrades change them, and abilities scale with them, like any other */\n\tstats?: StatDef[]\n\t/** Day and night. Always day when left out */\n\tday?: DayCycle\n\t/** The numbers of the game that are not about any one unit, like the supply cap. The engine's for those left out */\n\tsettings?: RuleSettingsInit\n\t/**\n\t * Kinds of effects abilities can have, next to the ones the engine knows (`defineEffect`): one of a type the engine has\n\t * takes its place\n\t */\n\teffects?: EffectType[]\n\t/**\n\t * Ways of aiming an ability of the game's own (`defineTargeting`), next to the engine's (`AimKind`): named by an\n\t * ability's `target`\n\t */\n\ttargetings?: Targeting[]\n\t/** Extra order types, or replacements for the core ones */\n\torders?: OrderBehavior[]\n\t/**\n\t * Formations of its own for units ordered to a point together (`FormationDef`), next to the engine's `rows`,\n\t * `circle`, `square` and `none`, or in place of one of the same id. Which an order takes is the order's to say\n\t * (`OrderInit.formation`), and the rules' where it does not (`RuleSettings.movement.formation`)\n\t */\n\tformations?: FormationDef[]\n\t/** Commands of the game's own, made with `defineCommand`, or replacements for the core ones */\n\tcommands?: CommandDef[]\n\t/** Types of the engine's own commands, or a pack's, the module does without (`coreCommands`, `heroCommands`) @beta */\n\twithoutCommands?: string[]\n\t/** Types of the engine's own orders, or a pack's, the module does without: a unit is then never given one @beta */\n\twithoutOrders?: string[]\n\t/**\n\t * The parts of the rules the game opts into, with what they bring (`GamePack`): `[heroesPack()]` for heroes, camps\n\t * and shops. None when left out. The game's own commands, orders, systems and hooks come after a pack's, and one of\n\t * the same id takes its place\n\t *\n\t * @beta\n\t */\n\tpacks?: GamePack[]\n\t/**\n\t * Systems of the game's own. They run after the core ones unless they give a phase (see `System`); one with the name\n\t * of a core system takes its place, and its phase too unless it gives its own. A function makes a system for each\n\t * world: what keeps state between ticks has to be made that way, or every game made from the module shares it\n\t */\n\tsystems?: SystemDef[]\n\t/** Names of the engine's own systems the module does without (see `coreSystems`) */\n\twithoutSystems?: string[]\n\t/** Handlers of hooks: how the module takes part in damage, deaths, orders. One with the id of a core one takes its place */\n\thooks?: HookDef[]\n\t/** Ids of the engine's own hook handlers the module does without, like `bounty` (see `coreHooks`) */\n\twithoutHooks?: string[]\n\t/** How the game reacts to events, the engine's and its own (see `defineListener`) */\n\tlisteners?: ListenerDef[]\n\t/**\n\t * The state of its own the game keeps (see `defineComponent`): on entities, players and the world. Given here as\n\t * timers and listeners are, so that a world knows who is told which (`replicate`) from its own game, and not from\n\t * whatever else the process has loaded. One used without being listed is an error (`UnlistedError`): no world\n\t * finds it, so a save or a snapshot would lose it\n\t */\n\tcomponents?: Component<any>[]\n\t/** The events of its own the game emits (see `defineEvent`): given here for the same reason */\n\tevents?: EventKey<any>[]\n\t/** Parts of the map the rules watch: who walks in and out (see `AreaDef`) */\n\tareas?: AreaDef[]\n\t/** Groups of things the game spawns as one (see `definePrefab`, `world.spawnPrefab`); a designer's from the editor through `prefabsFrom` */\n\tprefabs?: PrefabDef[]\n\t/** What the game sets to go off later (see `defineTimer`): given here, so that a save finds them by id */\n\ttimers?: TimerDef[]\n\t/** Scripts of steps the game starts, like a mission's (see `defineSequence`): given here, so that a save finds them */\n\tsequences?: SequenceDef[]\n\t/** Files of the game's own data its rules read as they run, and a panel edits (see `defineGameFile`, `registry.file`) */\n\tfiles?: GameFileDef<unknown>[]\n\t/** Decides who is out and who won. The last team with a building, when left out. Null for a game nobody can lose */\n\tvictory?: SystemDef | null\n\t/**\n\t * How its saves outlive its patches (`SaveRules`): the version of what it keeps in a save, the steps that bring an\n\t * older save up to it, and what becomes of a save made with other rules. A game that declares it, even empty, loads\n\t * the saves made before a patch; one that does not refuses every save not made with its very rules, as a test wants\n\t */\n\tsaves?: SaveRules\n\t/**\n\t * Runs once a world is loaded from a save, everything put back: for what a game keeps outside the world, to make\n\t * again from what is in it\n\t */\n\tafterLoad?: (world: World) => void\n\t/**\n\t * Runs as a world takes a new version of the game while it runs (hot reload, `reloadGame`), the new version's: for\n\t * what the game made of the old one (a cache of its definitions, a state worked out of them), to make again. What\n\t * else hears it: `world.events.on(gameReloaded, …)`, and a screen's `GameView.on`\n\t */\n\tonReload?: (world: World) => void\n\t/** What the game does on a server, around its games: who joins and leaves, the start and the end (see `ServerHooks`) */\n\tserver?: ServerHooks\n\t/** What a player starts a map with, for players the map places nothing for: a hall and workers as data, or a function (`StartingBase`) */\n\tstartingBase?: StartingBase\n\t/**\n\t * The brains of its computer players (`defineBrain`), given here as components and timers are, so that a save that\n\t * remembers a seat by its brain's id (`world.computers.seat`) finds the brain again when loaded. The first is what a\n\t * seat that names no brain gets: `meleeBrain` of `@v12-engine/engine/ai` for a game played as melee, or a computer\n\t * player of the game's own (`defineComputer`). None listed: the game has no computer player, and seating one throws\n\t */\n\tbrains?: BrainDef[]\n\t/**\n\t * What it says of its computer players' profiles (`GameAi`, AI plan D1): difficulties and personalities of its own\n\t * beside the engine's, defaults over the engine's, and whether a lobby offers each seat a difficulty and a\n\t * personality (`seatSettingsOf`)\n\t */\n\tai?: GameAi\n\t/**\n\t * What the ground of its maps can be painted with, in order: the first is index 1 of `Terrain.tiles`, 0 being no\n\t * paint (see `TileDef`). What each looks like is the view's (`GameView.ground.tiles`)\n\t */\n\ttiles?: TileDef[]\n\t/**\n\t * Its own layers of cells, for its rules to read and the editor to paint: where the bushes are (see `CellLayerDef`).\n\t * Any layer can be read and set by id whether it is listed or not; listed, the editor offers it\n\t */\n\tcellLayers?: CellLayerDef[]\n\t/** Numbers of its rules to be tuned while it plays (`defineTunable`), read with `world.tunable(id)` */\n\ttunables?: TunableDef[]\n\t/**\n\t * The maps the game ships (S36): a world made from one of them keeps, in its save and in the welcome a server sends,\n\t * only what changed of its ground, and whoever reads it finds the rest here (by its name and the ground it makes).\n\t * Not in the game's hash. A map not among them, or changed since, is kept whole, as before\n\t */\n\tmaps?: readonly GameMap[]\n\t/**\n\t * Its generator of maps (`MapGenerator`, `generateMap`): what the editor's New map from a generator and the page's\n\t * Random map make a map with, its parameters as their sliders. None when left out: the engine's `presetGenerator`\n\t * is there to take, with the game's trees and rocks\n\t */\n\tgenerator?: MapGenerator\n\t/**\n\t * Which fields of its definitions the editor's Data panel may change (S61): `all`, or by kind (`units`,\n\t * `abilities`, `buffs`, `items`, `upgrades`) all of them, some (their paths, `stats.health`, or fields said in full,\n\t * with bounds and a kind), or each definition's own in code. None when left out. What is changed there is kept in\n\t * the game's `data.json`, which the game reads over its code with `layData`\n\t */\n\teditable?: EditableData\n\t/**\n\t * How its worlds find their way: the radius the walkable ground is cut for, how steep it may be, how many units the\n\t * crowd makes room for at first (`maxAgents`), the sizes it is cut for (`radii`: `'auto'` unless said, a navigation for\n\t * each size of ground unit the game has). What a world is made with (`CreateWorldOptions.navigation`) goes over it\n\t */\n\tnavigation?: GameNavigationOptions\n\t/**\n\t * What a route of a ground unit knows of the buildings in its way (determinism plan F2): `all` of them (the default),\n\t * as the ground is; or only those its side has `seen`, so the way it goes in the dark says nothing of what is there.\n\t * With `seen`, each side has a navigation of its own to plan on, of what it knows: a few megabytes a side on a big\n\t * map. Units still walk around every building: they see one before they reach it, and plan again\n\t *\n\t * @beta\n\t */\n\tpaths?: 'all' | 'seen'\n\t/**\n\t * How much its worlds say (`world.log`): the least an entry must matter to be said, everything when left out.\n\t * Where the entries go is whoever runs the game's to say (`world.log.to`, the logger a world is made under)\n\t */\n\tlog?: { level?: LogLevel }\n\t/**\n\t * What becomes of a part of the game that throws (a hook's handler, a listener, a system, a timer, an order, a\n\t * command): `throw` (the error goes on: tests), `end` (the game ends there, the players told), `disable` (the part\n\t * is switched off and the game goes on), or a function that says which for each. When left out: a world throws, and\n\t * a server and a launched game end the game (`world.errorPolicy`)\n\t */\n\tonError?: ErrorPolicy\n\t/** What the game brings to the map editor (see `MapEditorDef`) */\n\teditor?: MapEditorDef\n\t/**\n\t * What the game tells each player about itself, beyond what the engine knows: the wave a tower defense is at,\n\t * a score, a countdown. Plain data that survives being sent; it goes into every snapshot as `report`, where the\n\t * game's view (`GameView.hud.status`) puts it on the screen. Only what that player may know\n\t */\n\treport?: (world: World, player: PlayerId) => Record<string, unknown>\n}\n\n/**\n * A seat at a game on a server: a player who joined, or a computer player\n *\n * @beta\n */\nexport interface ServerSeat {\n\t/** The player the seat is for */\n\tplayer: PlayerId\n\t/** The name shown for who sits there */\n\tname: string\n\t/** Whether a computer player plays the seat */\n\tai: boolean\n\t/** Whether someone is connected to it right now */\n\tconnected: boolean\n\t/** The team it plays for, where the mode says: who it is with and against */\n\tteam?: number\n\t/** Whether who sits there said they are ready, in the lobby: once every player seated is, the game starts */\n\tready?: boolean\n\t/** What is chosen for this seat (`ServerHooks.seatSettings`), by name: none where the game has no such settings */\n\tsettings?: Record<string, string>\n\t/** Settings of the seat the mode fixes (`ModeSeat.fixed`: a race the map gives its player), by name: not the lobby's to change */\n\tfixed?: string[]\n\t/** Who sits there, as they are rated (`ratedId`: a hash of their key, safe to show), and their rating in the mode where the server keeps ratings */\n\trated?: string\n\t/** The rating of who sits there in the mode, where the server keeps ratings */\n\trating?: number\n\t/** A vote to let who sits there go (`kick`), in the lobby: how many voted, and how many it takes */\n\tkick?: { votes: number; needed: number }\n}\n\n/**\n * How a game on a server ended: who won, and each seat's outcome\n *\n * @beta\n */\nexport interface GameResult {\n\t/** The id of the game that was played */\n\tgame: string\n\t/** The id of the mode it was played in */\n\tmode: string\n\t/** The winning team, or null for a game that was stopped */\n\twinner: number | null\n\t/** Seconds of game time */\n\tduration: number\n\t/** What the players were told, for a game that ended on an error and not by its rules (`World.failure`) */\n\tfailed?: string\n\t/** Every seat with how it ended for it */\n\tseats: (ServerSeat & { outcome: 'victory' | 'defeat' | 'none' })[]\n}\n\n/**\n * What a game does on a server (`Rules.server`). Only ever run there: a player's screen has none of it. The\n * lobby's settings come to `onGameStart` as the lobby left them\n *\n * @beta\n */\nexport interface ServerHooks {\n\t/** Settings of the lobby, by name: what can be chosen, and what is chosen until someone does */\n\tsettings?: Record<string, LobbySetting>\n\t/**\n\t * Settings of each seat, by name: a race, a difficulty, a colour. Chosen in the lobby by who sits there, and for a\n\t * seat the computer plays or nobody holds, by any player seated; each seat's (`ServerSeat.settings`) are handed to\n\t * its computer player (`GameMode.ai`) and to the start (`onGameStart`)\n\t */\n\tseatSettings?: Record<string, LobbySetting>\n\t/** Someone took a seat in the lobby, or came back to theirs in a game (`world` then) */\n\tonPlayerJoin?(seat: ServerSeat, world?: World): void\n\t/** Someone left their seat: in the lobby, or in a game (`world` then), where they may come back */\n\tonPlayerLeave?(seat: ServerSeat, world?: World): void\n\t/** The game starts, with the world made and the lobby's settings */\n\tonGameStart?(world: World, seats: readonly ServerSeat[], settings: Record<string, string>): void\n\t/** The game ended: who won, as plain data, before it is kept (`saveResult`) */\n\tonGameEnd?(world: World, result: GameResult): void\n\t/** Keeps a game's result: in a file, a database, a ranking. A server writes it to a file of its own without */\n\tsaveResult?(result: GameResult): void | Promise<void>\n}\n\n/**\n * A setting of a lobby or of a seat (`ServerHooks.settings`, `seatSettings`)\n *\n * @beta\n */\nexport interface LobbySetting {\n\t/** What the setting is called in the lobby */\n\tlabel: string\n\t/** What can be chosen, as it is kept */\n\toptions: string[]\n\t/** What each option is shown as, where it is not the option itself */\n\tlabels?: Record<string, string>\n\t/** What is chosen until someone does */\n\tdefault: string\n\t/** Of a seat: no two seats may hold the same (a colour). One held by another seat is not chosen */\n\tunique?: boolean\n}\n\n/**\n * What a new world is made from: terrain, rules, players, seed and navigation\n *\n * @beta\n */\nexport interface CreateWorldOptions extends WorldChecks {\n\t/** The terrain the world stands on */\n\tterrain: Terrain\n\t/** The game's rules the world runs */\n\trules: Rules\n\t/** The players of the world, in order */\n\tplayers: PlayerInit[]\n\t/** The races one is drawn from for a player given `random` (`PlayerInit.race`): all of the game's when left out */\n\trandomRaces?: readonly string[]\n\t/** Seed of the world's random numbers: the same seed gives the same game; 1 when left out */\n\tseed?: number\n\t/**\n\t * Simulation steps per second: 30 when left out. A save made at another rate is refused (`loadWorld`), so a game\n\t * that changes it starts new games\n\t *\n\t * @beta\n\t */\n\ttickRate?: number\n\t/** Options for how the world's units find their way, over the game's (`Rules.navigation`) */\n\tnavigation?: GameNavigationOptions\n\t/**\n\t * Components the app keeps in the world beside the game's own (`Rules.components`): what is the app's, not\n\t * the game's rules (where the screen is played from, a tool's own; `Component.portable` false). Its game's and the\n\t * engine's when left out: one neither lists is an error (`UnlistedError`)\n\t */\n\tcomponents?: readonly Component<unknown, unknown>[]\n\t/** The logger the world's own is made under (`world.log`): a server's, a page's. The root one when left out */\n\tlog?: Logger\n\t/** What becomes of a part of the game that throws, where the game does not say (`Rules.onError`) */\n\tonError?: ErrorPolicy\n}\n\n/**\n * How the engine's events are told to the players, each written beside what emits it, in the order a seat hears them:\n * two told of one event (a hit and its critical number) are told in this order\n */\nconst coreReplications: readonly ReplicatedEvent[] = [\n\ttoldDeath,\n\ttoldCells,\n\ttoldCellsSeen,\n\ttoldRedefined,\n\ttoldEnvironment,\n\ttoldGround,\n\ttoldCommand,\n\ttoldAttack,\n\ttoldAttackCancelled,\n\ttoldDamage,\n\ttoldHeal,\n\ttoldBuffOn,\n\ttoldBuffOff,\n\ttoldTrained,\n\ttoldConstructionStarted,\n\ttoldBuilt,\n\ttoldConstructionCancelled,\n\ttoldUpgradeStarted,\n\ttoldUpgradeCancelled,\n\ttoldMorphed,\n\ttoldRevived,\n\ttoldPicked,\n\ttoldResearched,\n\ttoldShot,\n\ttoldMissileHit,\n\ttoldWindup,\n\ttoldCastCancelled,\n\ttoldChannelStarted,\n\ttoldChannelEnded,\n\ttoldCast,\n\ttoldStrike,\n\ttoldCrit,\n\ttoldMiss,\n\ttoldImpact,\n\ttoldWork,\n\ttoldChop,\n\ttoldLevelUp,\n\ttoldXp,\n\ttoldMana,\n\ttoldResource,\n\ttoldBounty,\n\ttoldMessage,\n\ttoldObjective,\n\ttoldLine,\n\ttoldLineEnded,\n\ttoldCinematic,\n\ttoldCinematicCue,\n\ttoldCamera,\n\ttoldFx,\n\ttoldFxStopped,\n\ttoldRustle,\n\ttoldGust,\n\ttoldPing,\n\ttoldChat\n]\n\n/** What the game tells each player about itself, with its packs' beside it (`Snapshot.report`, `Rules.report`) */\nconst reportPart = snapshotField('report', ({ world, player }) => world.registry.report?.(world, player))\n\n/** The engine's parts of a player's snapshot, each captured by its feature, in their order (`SnapshotField`) */\nconst coreSnapshotParts: readonly SnapshotField[] = [\n\tdebugPart,\n\thourPart,\n\toutcomePart,\n\tprojectilesPart,\n\tmissilesPart,\n\titemsPart,\n\trevealsPart,\n\tareasPart,\n\tcameraPart,\n\teventsPart,\n\treportPart,\n\tscorePart,\n\tscoreLinePart,\n\tcorpsesPart\n]\n\n/**\n * The engine's parts that give an entity something as it is made, or call it off as it leaves its owner: a worker's\n * load, a building's queue, the slots of what carries, a hold\n */\nconst coreParts: readonly Component<unknown, unknown>[] = [gathering, productionQueue, inventorySlots, cargo] as Component<unknown, unknown>[]\n\n/**\n * A game put together with its packs (`assembleGame`): every list the engine runs, the packs' in it, in one place. A\n * pack's parts come before the game's own, so that one of the game's of the same id or name takes its place; what the\n * game leaves out of the engine's (`withoutCommands`, `withoutOrders`, `withoutHooks`, `withoutSystems`) it leaves out\n * of its packs' too\n *\n * @beta\n */\nexport interface AssembledGame {\n\t/** The game the assembly is made of */\n\treadonly rules: Rules\n\t/** The packs' commands and the game's */\n\treadonly commands: readonly CommandDef[]\n\t/** The packs' orders and the game's */\n\treadonly orders: readonly OrderBehavior[]\n\t/** The packs' systems, as given (made for each world, and left out by name then: `withoutSystems`) */\n\treadonly packSystems: readonly SystemDef[]\n\t/** The hooks of the packs and the game */\n\treadonly hooks: readonly HookDef[]\n\t/** The listeners of the packs and the game */\n\treadonly listeners: readonly ListenerDef[]\n\t/** The packs' kinds of effects (`GamePack.effects`), before the game's own */\n\treadonly effects: readonly EffectType[]\n\t/** The timers of the packs and the game */\n\treadonly timers: readonly TimerDef[]\n\t/** The components of the engine, packs and game */\n\treadonly components: readonly Component<unknown, unknown>[]\n\t/** The events of the packs and the game */\n\treadonly events: readonly EventKey<unknown>[]\n\t/** The fields of stats the packs and the game add */\n\treadonly statFields: readonly StatField[]\n\t/** The stats of the game: its packs' (`GamePack.stats`), then its own (`Rules.stats`) */\n\treadonly stats: readonly StatDef[]\n\t/** The packs' ways of telling the players of the world's events (`GamePack.replications`) */\n\treadonly replications: readonly ReplicatedEvent[]\n\t/** The packs' parts of the players' snapshots (`GamePack.snapshotFields`) */\n\treadonly snapshotFields: readonly SnapshotField[]\n\t/** The game's rules with what each pack lays over them, in order */\n\treadonly settings: RuleSettingsInit\n\t/** The game's report of a player at the end, with each pack's beside it: none where none says */\n\treadonly report: ((world: World, player: PlayerId) => Record<string, unknown>) | null\n\t/** How it is won: the game's own where it says, else the last pack's that says, else the engine's (`lastTeamStanding`) */\n\treadonly victory: SystemDef | null | undefined\n\t/** What the game and its packs find wrong with a map, in the editor */\n\treadonly check: ((map: GameMap, registry: Registry) => MapProblem[]) | undefined\n}\n\n/** Each game's assembly, made once */\nconst assemblies = new WeakMap<Rules, AssembledGame>()\n\n/**\n * A game with its packs put together (`AssembledGame`): what the registry, the systems, the hooks, the listeners and the\n * timers of a world of it are made of. Refuses a pack without one it says it goes with (`GamePack.requires`)\n *\n * @beta\n */\nexport function assembleGame(game: Rules): AssembledGame {\n\tconst known = assemblies.get(game)\n\tif (known) return known\n\tconst packs = game.packs ?? []\n\tfor (const pack of packs)\n\t\tfor (const needed of pack.requires ?? [])\n\t\t\tif (!packs.some((each) => each.id === needed))\n\t\t\t\tthrow new Error(`The pack \"${pack.id}\" goes with the pack \"${needed}\", which \"${game.id}\" does not have`)\n\tconst from = <T>(pick: (pack: GamePack) => readonly T[] | undefined): T[] => packs.flatMap((pack) => pick(pack) ?? [])\n\tconst withoutCommands = new Set(game.withoutCommands ?? [])\n\tconst withoutOrders = new Set(game.withoutOrders ?? [])\n\tconst withoutHooks = new Set(game.withoutHooks ?? [])\n\tlet settings: RuleSettingsInit = game.settings ?? {}\n\tfor (const pack of packs) {\n\t\tif (!pack.settings) continue\n\t\tconst over = pack.settings(resolveSettings(settings))\n\t\tsettings = overSettings(settings, over)\n\t}\n\tconst reports = [game.report, ...packs.map((pack) => pack.report?.bind(pack))].filter((each) => each !== undefined)\n\tconst checks = [game.editor?.check, ...packs.map((pack) => pack.check?.bind(pack))].filter((each) => each !== undefined)\n\tconst victories = packs.filter((pack) => pack.victory !== undefined)\n\tconst assembly: AssembledGame = {\n\t\trules: game,\n\t\tcommands: [...from((pack) => pack.commands).filter((command) => !withoutCommands.has(command.type)), ...(game.commands ?? [])],\n\t\torders: [...from((pack) => pack.orders).filter((order) => !withoutOrders.has(order.type)), ...(game.orders ?? [])],\n\t\tpackSystems: from((pack) => pack.systems),\n\t\thooks: [...from((pack) => pack.hooks).filter((hook) => !withoutHooks.has(hook.id)), ...(game.hooks ?? [])],\n\t\tlisteners: [...from((pack) => pack.listeners), ...(game.listeners ?? [])],\n\t\teffects: [...from((pack) => pack.effects), ...(game.effects ?? [])],\n\t\ttimers: [...from((pack) => pack.timers), ...(game.timers ?? [])],\n\t\tcomponents: [...from((pack) => pack.components), ...(game.components ?? [])],\n\t\tevents: [...from((pack) => pack.events), ...(game.events ?? [])],\n\t\tstatFields: from((pack) => pack.statFields),\n\t\tstats: [...from((pack) => pack.stats), ...(game.stats ?? [])],\n\t\treplications: from((pack) => pack.replications),\n\t\tsnapshotFields: from((pack) => pack.snapshotFields),\n\t\tsettings,\n\t\treport: reports.length ? (world, player) => Object.assign({}, ...reports.map((report) => report!(world, player))) : null,\n\t\tvictory: game.victory !== undefined ? game.victory : victories.at(-1)?.victory,\n\t\tcheck: checks.length ? (map, registry) => checks.flatMap((check) => check!(map, registry)) : undefined\n\t}\n\tassemblies.set(game, assembly)\n\treturn assembly\n}\n\n/**\n * Everything a game module defines, looked up by id: with the engine's own components, and those an app keeps in its\n * worlds (`own`: `CreateWorldOptions.components`)\n *\n * @public\n */\nexport function createRegistry(game: Rules, own: readonly Component<unknown, unknown>[] = []): Registry {\n\tconst registry = new Registry()\n\tregistry.defineCore(coreComponents())\n\tconst assembly = assembleGame(game)\n\tregistry.assembly = assembly\n\tconst withoutOrders = new Set(game.withoutOrders ?? [])\n\tfor (const order of coreOrders) if (!withoutOrders.has(order.type)) registry.orders.define(order)\n\tfor (const order of assembly.orders) registry.orders.define(order)\n\tfor (const formation of coreFormations) registry.formations.define(formation)\n\tfor (const formation of game.formations ?? []) registry.formations.define(formation)\n\tconst withoutCommands = new Set(game.withoutCommands ?? [])\n\tfor (const command of [\n\t\t...(coreCommands as readonly CommandDef[]).filter((command) => !withoutCommands.has(command.type)),\n\t\t...debugCommands,\n\t\t...foliageDebugCommands,\n\t\ttuneCommand,\n\t\tredefineCommand\n\t])\n\t\tregistry.commands.define(command as CommandDef)\n\tfor (const command of assembly.commands) registry.commands.define(command)\n\tfor (const kind of [...coreEffects, ...summonEffects, ...dispelEffects, ...assembly.effects]) registry.effects.define(kind)\n\tfor (const targeting of game.targetings ?? []) registry.targetings.define(targeting)\n\tfor (const buff of game.buffs ?? []) registry.buffs.define(buff)\n\tfor (const ability of game.abilities ?? []) registry.abilities.define(ability)\n\tfor (const item of game.items ?? []) registry.items.define(itemTier(item) === item.tier ? item : { ...item, tier: itemTier(item) })\n\tfor (const tag of game.tags ?? []) registry.tags.define(tag)\n\tfor (const prefab of game.prefabs ?? []) registry.prefabs.define(prefab)\n\tregistry.upkeep = [...(game.upkeep ?? [])].sort((a, b) => a.above - b.above)\n\tregistry.game = game.id\n\tregistry.module = game\n\tregistry.day = game.day ?? null\n\tregistry.settings = resolveSettings(assembly.settings)\n\tregistry.score = resolveScore(registry.settings.score, game)\n\tregistry.report = assembly.report\n\tregistry.resources = [...(game.resources ?? [])]\n\tregistry.currency = game.currency ?? game.resources?.[0]?.id ?? null\n\tregistry.tiles = checkTiles(game.tiles ?? [])\n\tregistry.cellLayers = game.cellLayers ?? []\n\tregistry.tunables = [...(game.tunables ?? [])]\n\tregistry.defineParts([...assembly.components, ...own], assembly.events)\n\t// what each part gives an entity as it is made, and calls off as it leaves its owner: the engine's, then the game's\n\tconst parts = [...coreParts, ...assembly.components]\n\tregistry.spawning = parts.filter((part) => part.onSpawn)\n\tregistry.leaving = parts.filter((part) => part.onLeave)\n\tregistry.passing = parts.filter((part) => part.passable)\n\tdefineStats(registry, assembly.stats)\n\tregistry.statFields = [...assembly.statFields]\n\tregistry.replications = [...coreReplications, ...assembly.replications]\n\tregistry.snapshotFields = [...coreSnapshotParts, ...assembly.snapshotFields]\n\tfor (const race of game.races ?? []) registry.races.define(race)\n\tfor (const file of game.files ?? []) registry.setFile(file, file.read(file.data))\n\tfor (const unit of game.units) registry.units.define(unit)\n\tfor (const upgrade of game.upgrades ?? []) registry.upgrades.define(upgrade)\n\tcheckCosts(game)\n\tcheckRaces(game)\n\tcheckStats(game, new Set(registry.statKeys))\n\tcheckSaves(game)\n\treturn registry\n}\n\n/**\n * Throws when what a game says of its saves cannot be: a version that is no whole number from 1, or a step from a\n * version the game is not past yet, which would never run\n */\nfunction checkSaves(game: Rules): void {\n\tconst { version = 1, migrate } = game.saves ?? {}\n\tif (!Number.isInteger(version) || version < 1)\n\t\tthrow new Error(`The version of the saves of \"${game.id}\" is a whole number from 1, not ${String(version)}`)\n\tif (typeof migrate !== 'object') return\n\tfor (const from of Object.keys(migrate).map(Number)) {\n\t\tif (!Number.isInteger(from) || from < 1 || from >= version) {\n\t\t\tthrow new Error(\n\t\t\t\t`\"${game.id}\" has a step for saves of version ${from}, and its saves are of version ${version}: the steps are from 1 to ${version - 1}, each to the version after it`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** The game's tiles, as they are: throws for one that is there twice, or for too many to keep in a byte */\nfunction checkTiles(tiles: TileDef[]): TileDef[] {\n\tif (tiles.length > MAX_TILES) throw new Error(`A game has at most ${MAX_TILES} tiles, not ${tiles.length}`)\n\tconst seen = new Set<string>()\n\tfor (const tile of tiles) {\n\t\tif (seen.has(tile.id)) throw new Error(`The tile \"${tile.id}\" is there twice`)\n\t\tseen.add(tile.id)\n\t}\n\treturn [...tiles]\n}\n\n/** The game's own stats next to the engine's, and what every unit starts with of them */\nfunction defineStats(registry: Registry, stats: readonly StatDef[]): void {\n\tconst defaults: Record<string, number> = { ...noStats() }\n\tfor (const stat of stats) {\n\t\tif (stat.id in defaults) throw new Error(`The stat \"${stat.id}\" is there twice, or is one of the engine's`)\n\t\tdefaults[stat.id] = stat.default ?? 0\n\t}\n\tregistry.stats = [...stats]\n\tregistry.statKeys = Object.keys(defaults)\n\tregistry.statDefaults = Object.freeze(defaults) as Stats\n}\n\n/**\n * Throws when something changes or scales with a stat the game does not have: most likely a typo, which would\n * otherwise do nothing, or turn a stat into NaN. Stats are any text to the type checker, so this is where it is caught\n */\nfunction checkStats(game: Rules, known: Set<string>): void {\n\tconst check = (what: string, keys: object | undefined, also: string[] = []) => {\n\t\tfor (const key in keys) if (!known.has(key) && !also.includes(key)) throw new Error(`${what} has the stat \"${key}\", which the game does not have`)\n\t}\n\tconst change = (what: string, change: { stats?: object; percent?: object } | undefined) => {\n\t\tcheck(what, change?.stats)\n\t\tcheck(what, change?.percent)\n\t}\n\t// scaling can be anywhere in a tree of effects\n\tconst scaling = (what: string, within: unknown): void => {\n\t\tif (typeof within !== 'object' || within === null) return\n\t\tfor (const [key, value] of Object.entries(within)) {\n\t\t\tif (key === 'scaling' || key === 'shieldScaling') check(what, value as object, ['level', 'bonusAttackDamage'])\n\t\t\telse scaling(what, value)\n\t\t}\n\t}\n\tfor (const unit of game.units) {\n\t\tcheck(`Unit type \"${unit.id}\"`, unit.stats)\n\t\tchange(`The growth of \"${unit.id}\"`, unit.hero?.growth)\n\t\tfor (const [i, attack] of (unit.attacks ?? []).entries())\n\t\t\tfor (const stat of Object.values(attack.stats ?? {}))\n\t\t\t\tif (!known.has(stat)) throw new Error(`Attack ${i + 1} of \"${unit.id}\" reads the stat \"${stat}\", which the game does not have`)\n\t}\n\tfor (const buff of game.buffs ?? []) {\n\t\tchange(`Buff \"${buff.id}\"`, buff)\n\t\tscaling(`Buff \"${buff.id}\"`, buff)\n\t}\n\tfor (const item of game.items ?? []) change(`Item \"${item.id}\"`, item.bonus)\n\tfor (const upgrade of game.upgrades ?? []) for (const effect of upgrade.effects) change(`Upgrade \"${upgrade.id}\"`, effect)\n\tfor (const ability of game.abilities ?? []) scaling(`Ability \"${ability.id}\"`, ability)\n}\n\n/**\n * Throws when something costs a resource the game does not have: a typo, or something that is not a resource at\n * all, like supply. Either would otherwise make it something nobody can ever afford, without a word\n */\nfunction checkCosts(game: Rules): void {\n\tconst known = new Set((game.resources ?? []).map((resource) => resource.id))\n\tif (game.currency !== undefined && !known.has(game.currency)) throw new Error(`The currency \"${game.currency}\" is not a resource of the game`)\n\tconst check = (what: string, cost: Cost | undefined) => {\n\t\tfor (const kind in cost) if (!known.has(kind)) throw new Error(`${what} costs \"${kind}\", which is not a resource of the game`)\n\t}\n\tfor (const unit of game.units) check(`Unit type \"${unit.id}\"`, unit.cost)\n\tfor (const upgrade of game.upgrades ?? []) check(`Upgrade \"${upgrade.id}\"`, upgrade.cost)\n\tfor (const item of game.items ?? []) check(`Item \"${item.id}\"`, item.cost)\n}\n\n/**\n * How a game's worlds find their way (`Rules.navigation`): `RecastNavigationOptions`, with `radii` also `'auto'`\n * (the default) or `false`\n *\n * @beta\n */\nexport type GameNavigationOptions = Omit<RecastNavigationOptions, 'radii'> & {\n\t/**\n\t * The sizes the ground is cut for. `'auto'` (when left out): the ground units' radii in three groups, up to 0.5, up\n\t * to 0.75 and over, a navigation for each group the game has a unit type in (the first cut for 0.5 at least, the\n\t * others for their group's largest radius), so an ogre keeps from walls as far as it needs where a footman still\n\t * fits through a gap. `false`: one navigation cut for `agentRadius` (0.5), as it was. A list: a navigation for\n\t * each size, a unit on the one for the biggest size it is not smaller than. Each size has its own crowd (see\n\t * `SizedNavigation`)\n\t */\n\tradii?: number[] | 'auto' | false\n}\n\n/** Where the groups of ground units' radii end (the last group is over the last edge) */\nconst BUCKET_EDGES = [0.5, 0.75]\n\n/**\n * The sizes the ground units of a game are cut for (`radii: 'auto'`): their radii in groups (up to 0.5, up to 0.75,\n * over), each cut for its largest radius (the first for 0.5 at least), a group only where a unit type falls in it. Each\n * with the radius of the biggest unit it takes, `upTo`. What flies or sails has navigation of its own\n */\nexport function autoNavigationSizes(registry: Registry): { radius: number; upTo: number }[] {\n\tconst largest: number[] = new Array(BUCKET_EDGES.length + 1).fill(0)\n\tfor (const def of registry.units.all()) {\n\t\tif (def.kind !== 'unit' || def.flying || def.naval) continue\n\t\tconst bucket = BUCKET_EDGES.findIndex((edge) => def.radius <= edge)\n\t\tconst i = bucket < 0 ? BUCKET_EDGES.length : bucket\n\t\tlargest[i] = Math.max(largest[i], def.radius)\n\t}\n\tconst sizes: { radius: number; upTo: number }[] = []\n\tlargest.forEach((radius, i) => {\n\t\tif (radius > 0) sizes.push({ radius: i === 0 ? Math.max(radius, 0.5) : radius, upTo: i < BUCKET_EDGES.length ? BUCKET_EDGES[i] : Infinity })\n\t})\n\treturn sizes\n}\n\n/**\n * The ground's navigation: cut for a unit of ordinary size (0.5), for each size the game names (`radii`), or for each\n * group of sizes its unit types are in (`autoSizes`), each unit on the one for its size. Big ones on one cut for 0.5\n * fit through the same gaps and overlap walls a little, which is better than everyone keeping the distance from a wall\n * that the biggest unit in the game needs\n */\nasync function groundNavigationOf(\n\tterrain: Terrain,\n\toptions: RecastNavigationOptions = {},\n\tautoSizes?: { radius: number; upTo: number }[]\n): Promise<Navigation> {\n\tconst named = [...new Set(options.radii ?? [])].sort((a, b) => a - b)\n\tconst wanted: { radius: number; upTo?: number }[] = autoSizes ?? named.map((radius) => ({ radius }))\n\t// ground with nothing to walk on (a sea) is cut once: Recast cannot hold two navigations of an empty ground\n\tif (wanted.length < 2 || !terrain.buildMesh(true).indices.length) {\n\t\treturn RecastNavigation.create(terrain, { agentRadius: wanted[0]?.radius ?? 0.5, ...options, radii: undefined })\n\t}\n\t// built side by side (a worker each, where the builder has them), kept in the order of their sizes\n\tconst navigations = await allOrFreed(wanted.map(({ radius }) => () => RecastNavigation.create(terrain, { ...options, agentRadius: radius, radii: undefined })))\n\treturn new SizedNavigation(wanted.map(({ radius, upTo }, i) => ({ radius, upTo, navigation: navigations[i] })))\n}\n\n\n/**\n * The navigations the sides plan their routes on (`Rules.paths: 'seen'`): one for each team that plays, cut for\n * the game's smallest unit. None where routes know everything\n */\nasync function sidePathsOf(\n\tgame: Rules,\n\tterrain: Terrain,\n\tplayers: readonly { team: number; neutral?: boolean; creeps?: boolean }[],\n\toptions: RecastNavigationOptions\n): Promise<SidePaths | undefined> {\n\tif (game.paths !== 'seen') return undefined\n\tconst teams = [...new Set(players.filter((player) => !player.neutral && !player.creeps).map((player) => player.team))].sort((a, b) => a - b)\n\tconst radius = Math.min(...(options.radii?.length ? options.radii : [options.agentRadius ?? 0.5]))\n\treturn SidePaths.create(terrain, teams, { ...options, agentRadius: radius })\n}\n\n/** Where boats go, on a map with deep water: a navigation of the water at its surface. Nothing on one without */\nasync function waterNavigationOf(terrain: Terrain, options?: RecastNavigationOptions): Promise<RecastNavigation | undefined> {\n\tif (!terrain.hasDeepWater) return undefined\n\t// boats are cut for one size: the smallest the game names\n\treturn RecastNavigation.create(terrain, {\n\t\tagentRadius: 0.5,\n\t\t...options,\n\t\t...(options?.radii?.length && { agentRadius: Math.min(...options.radii) }),\n\t\tsurface: 'water'\n\t})\n}\n\n/**\n * Makes a world from terrain, rules and players; resolves once it is ready to step\n *\n * @public\n */\nexport async function createWorld(options: CreateWorldOptions): Promise<World> {\n\tconst { terrain, rules: game, players, seed } = options\n\tconst registry = createRegistry(game, options.components)\n\n\tconst world = await makeWorld(game, registry, terrain, {\n\t\tplayers: players.map((player) => ({ ...player, resources: startingResources(game, player) })),\n\t\tnavigation: options.navigation,\n\t\trandomRaces: options.randomRaces,\n\t\tseed,\n\t\ttickRate: options.tickRate,\n\t\tlog: options.log,\n\t\tonError: options.onError,\n\t\tchecks: options.checks\n\t})\n\t// what each race starts its players with, once the races are settled (one drawn for those given random)\n\traceResources(world, players)\n\t// what each side knows without seeing, as it is put down from now (`Rules.paths: 'seen'`)\n\tworld.sidePaths?.attach(world)\n\treturn world\n}\n\n/**\n * A world of a game on a terrain, its navigations built (freed again where what follows fails), its parts the game's put\n * together with its packs (`assembleGame`): what a world made new and a world loaded from a save have in common\n */\nasync function makeWorld(\n\tgame: Rules,\n\tregistry: Registry,\n\tterrain: Terrain,\n\toptions: WorldChecks & {\n\t\tplayers: PlayerInit[]\n\t\tnavigation?: GameNavigationOptions\n\t\trandomRaces?: readonly string[]\n\t\tseed?: number\n\t\ttickRate?: number\n\t\tlog?: Logger\n\t\tonError?: ErrorPolicy\n\t}\n): Promise<World> {\n\tconst { radii, ...given } = { ...game.navigation, ...options.navigation }\n\tconst navigationOptions: RecastNavigationOptions = {\n\t\t// slow ground weighed by the ways, where the game has any (EN2)\n\t\t...(hasGroundSpeeds(registry) && { speedAt: (x: number, z: number) => navigationSpeedOn(registry, terrain, x, z) }),\n\t\t...given,\n\t\t...(Array.isArray(radii) && { radii })\n\t}\n\t// the sizes of its ground units, where the game names none and no one size is asked for\n\tconst auto = radii === undefined || radii === 'auto'\n\tconst sizes = auto && given.agentRadius === undefined ? autoNavigationSizes(registry) : undefined\n\t// the ground's, the water's and the sides' built side by side: none waits on another (a worker each, where the\n\t// builder has them)\n\tconst [navigation, waterNavigation, sidePaths] = (await allOrFreed<{ dispose(): void } | undefined>([\n\t\t() => groundNavigationOf(terrain, navigationOptions, sizes),\n\t\t() => waterNavigationOf(terrain, navigationOptions),\n\t\t() => sidePathsOf(game, terrain, options.players, navigationOptions)\n\t])) as [Navigation, RecastNavigation | undefined, SidePaths | undefined]\n\tconst assembly = registry.assembly!\n\treturn freedOnError(navigation, () =>\n\t\tfreedOnError(\n\t\t\twaterNavigation,\n\t\t\t() =>\n\t\t\t\tnew World({\n\t\t\t\t\tterrain,\n\t\t\t\t\tnavigation,\n\t\t\t\t\twaterNavigation,\n\t\t\t\t\tsidePaths,\n\t\t\t\t\tregistry,\n\t\t\t\t\tplayers: options.players,\n\t\t\t\t\trandomRaces: options.randomRaces,\n\t\t\t\t\tseed: options.seed,\n\t\t\t\t\ttickRate: options.tickRate,\n\t\t\t\t\tlog: options.log,\n\t\t\t\t\tlogLevel: game.log?.level,\n\t\t\t\t\tonError: game.onError ?? options.onError,\n\t\t\t\t\tchecks: options.checks,\n\t\t\t\t\tsystems: (world) => systemsOf(world, assembly),\n\t\t\t\t\thooks: hooksOf(assembly),\n\t\t\t\t\tlisteners: listenersOf(assembly),\n\t\t\t\t\tareas: game.areas,\n\t\t\t\t\ttimers: timersOf(assembly),\n\t\t\t\t\tsequences: game.sequences\n\t\t\t\t})\n\t\t)\n\t)\n}\n\n/**\n * Runs what makes something of a navigation already made: the navigation is freed when it fails (WebAssembly memory,\n * which nothing else would free), and the error goes on\n */\nasync function freedOnError<T>(navigation: { dispose(): void } | undefined, make: () => T | Promise<T>): Promise<T> {\n\ttry {\n\t\treturn await make()\n\t} catch (error) {\n\t\tnavigation?.dispose()\n\t\tthrow error\n\t}\n}\n\n/** Runs what is done to a world just made: the world is disposed when it fails, and the error goes on */\nasync function disposedOnError(world: World, run: () => void | Promise<void>): Promise<World> {\n\ttry {\n\t\tawait run()\n\t\treturn world\n\t} catch (error) {\n\t\tworld.dispose()\n\t\tthrow error\n\t}\n}\n\n/**\n * What a player starts with: what they were given, or else what the game starts everyone with (nothing, for the\n * neutral players). Every resource of the game is in it, at 0 at least\n */\nfunction startingResources(game: Rules, player: PlayerInit): Purse {\n\tconst purse: Purse = {}\n\tfor (const resource of game.resources ?? []) {\n\t\tpurse[resource.id] = player.resources ? (player.resources[resource.id] ?? 0) : player.neutral ? 0 : (resource.start ?? 0)\n\t}\n\treturn { ...player.resources, ...purse }\n}\n\n/**\n * The engine's hook handlers without the ones the module does without, then the module's own\n *\n * @beta\n */\nexport interface LoadWorldOptions extends WorldChecks {\n\t/** The game module the save was made with, by id. A save holds no code: rules come from here */\n\trules: Rules\n\t/**\n\t * The map it is loaded on (a scene that opens its map again): its definitions are laid over the game's in place\n\t * of those the save kept (`GameMap.definitions`). The save's own when left out\n\t */\n\tmap?: Pick<GameMap, 'definitions'>\n\t/** Options for how the world's units find their way, over the game's (`Rules.navigation`) */\n\tnavigation?: GameNavigationOptions\n\t/** Components the app keeps in the world beside the game's own, as `CreateWorldOptions.components`: those of the world saved */\n\tcomponents?: readonly Component<unknown, unknown>[]\n\t/**\n\t * Loads a save made with other rules of the game (its code or its mods changed since) whatever the game says of\n\t * those (`Rules.saves.onMismatch`). An older version of its saves is brought up to date all the same\n\t */\n\tanyVersion?: boolean\n\t/** The logger the world's own is made under, as `CreateWorldOptions.log` */\n\tlog?: Logger\n\t/** What becomes of a part of the game that throws, as `CreateWorldOptions.onError` */\n\tonError?: ErrorPolicy\n\t/** The maps a save's ground may be one of (S36): the game's own (`Rules.maps`) when left out */\n\tmaps?: readonly GameMap[]\n}\n\n/**\n * A world from a save (see `saveWorld`), carrying on where it was. A save made before, by an older engine or by the\n * game before a patch, is brought up to date first (`updateSave`), or refused with a `SaveError` that says why.\n * Navigation is built again; units come back with the speed and destination they had, but the way they find around\n * each other is worked out anew, so the game from there on is close to, and not quite, the one that was saved\n *\n * @public\n */\nexport async function loadWorld(saved: WorldSave, options: LoadWorldOptions): Promise<World> {\n\t// the definitions of the map it was made from laid over the game again (RC8): the map's it is loaded on, where the\n\t// caller says one, else those the save kept. Its rules hash has them: a save of other definitions is the game's\n\t// mismatch (`SaveRules.onMismatch`)\n\tconst kept = (saved.state?.[mapInfo.id] as { definitions?: GameData } | undefined)?.definitions\n\tconst definitions = options.map ? options.map.definitions : kept\n\tconst game = definitions ? layData(options.rules, definitions) : options.rules\n\tconst registry = createRegistry(game, options.components)\n\t// as the game reads it now, or refused, before anything is built for it\n\tconst save = updateSave(saved, registry, { anyVersion: options.anyVersion })\n\t// all of the ground, or the map the world was made from and what changed of it (S36): that map is one of the game's\n\tlet ground: ReturnType<typeof groundOf>\n\ttry {\n\t\tground = groundOf(save.terrain, options.maps ?? game.maps, game)\n\t} catch (error) {\n\t\tif (error instanceof MissingGround) throw new SaveError(`Save: ${error.message}`, 'ground')\n\t\tthrow error\n\t}\n\tconst { terrain } = ground\n\tconst world = await makeWorld(game, registry, terrain, {\n\t\tplayers: savedPlayers(save),\n\t\tnavigation: options.navigation,\n\t\ttickRate: save.tickRate,\n\t\tlog: options.log,\n\t\tonError: options.onError,\n\t\tchecks: options.checks\n\t})\n\t// a save that is refused, or a game's afterLoad that throws, leaves nothing behind\n\treturn disposedOnError(world, () => {\n\t\t// what it started as, for its next save\n\t\tworld.ground = ground.base\n\t\trestoreWorld(world, save)\n\t\t// the gates as the save had them: the obstacles of shut ones are not in it\n\t\tif (save.state && gateStates.id in save.state) setUpGates(world)\n\t\t// the computer players the save remembers, seated again with their memory, before the game looks\n\t\tworld.computers.restore()\n\t\tgame.afterLoad?.(world)\n\t})\n}\n\n/** The systems of a world of the game: the core ones and its packs', but those it leaves out, then its own, then who wins */\nfunction systemsOf(world: World, assembly: AssembledGame): System[] {\n\tconst { rules: game } = assembly\n\tconst make = (def: SystemDef) => (typeof def === 'function' ? def(world) : def)\n\tconst without = new Set(game.withoutSystems ?? [])\n\tconst systems = [...coreSystems, ...assembly.packSystems.map(make)].filter((system) => !without.has(system.name))\n\tfor (const def of game.systems ?? []) {\n\t\tconst system = make(def)\n\t\tconst index = systems.findIndex((core) => core.name === system.name)\n\t\tif (index < 0) systems.push(system)\n\t\t// in place of the core one, and in its phase unless it says\n\t\telse\n\t\t\tsystems[index] = system.phase\n\t\t\t\t? system\n\t\t\t\t: { ...system, phase: systems[index].phase, update: system.update?.bind(system), each: system.each?.bind(system) }\n\t}\n\t// what each side learns of the buildings in its way, right after the fog says what it sees\n\tif (game.paths === 'seen') systems.splice(systems.findIndex((system) => system.name === 'fog') + 1, 0, sideKnowledgeSystem)\n\t// the score's gauges and timeline, in a game that counts\n\tif (world.registry.score) systems.push(scoreSystem(world))\n\tif (assembly.victory !== null) systems.push(make(assembly.victory ?? lastTeamStanding))\n\treturn systems\n}\n\nfunction hooksOf(assembly: AssembledGame): HookDef[] {\n\tconst without = new Set(assembly.rules.withoutHooks ?? [])\n\treturn [...coreHooks.filter((hook) => !without.has(hook.id)), ...assembly.hooks, ...raceHooks(assembly.rules)]\n}\n\n/** How the world reacts to events: the engine's, the packs', the game's */\nfunction listenersOf(assembly: AssembledGame): ListenerDef[] {\n\treturn [dropFromTable, transportSank, regionCinematic, ...assembly.listeners]\n}\n\n/** What can be set to go off later: the packs' and the game's */\nfunction timersOf(assembly: AssembledGame): TimerDef[] | undefined {\n\treturn assembly.timers.length ? [...assembly.timers] : undefined\n}\n\n/**\n * What a world made from a map is made from: the map, the rules, and what the lobby chose for the players\n *\n * @beta\n */\nexport interface MapWorldOptions extends WorldChecks {\n\t/** The map the world is made from: its terrain, players and what it places */\n\tmap: GameMap\n\t/** The game's rules the world runs */\n\trules: Rules\n\t/**\n\t * The race each player plays, by player (`Rules.races`): one of the game's, or `random`. Chosen in a lobby, a\n\t * page's own menu. Those left out play what the map fixes for them (`MapPlayer.race`), or the game's first\n\t */\n\traces?: Readonly<Record<PlayerId, string>>\n\t/** The team each player plays for, by player, over the map's (`MapPlayer.team`): chosen in a lobby */\n\tteams?: Readonly<Record<PlayerId, number>>\n\t/** The colour of each player, by player, over the map's (`MapPlayer.color`): chosen in a lobby */\n\tcolors?: Readonly<Record<PlayerId, [number, number, number]>>\n\t/**\n\t * Whether the world has the creeps player. When the map has something for it when left out: a camp, or something\n\t * placed for the creeps. A world without camps that had one anyway would never be won: a team would always be left\n\t */\n\tcreeps?: boolean\n\t/** Seed of the world's random numbers: the same seed gives the same game */\n\tseed?: number\n\t/** Options for how the world's units find their way, over the game's (`Rules.navigation`) */\n\tnavigation?: GameNavigationOptions\n\t/** Components the app keeps in the world beside the game's own, as `CreateWorldOptions.components` */\n\tcomponents?: readonly Component<unknown, unknown>[]\n\t/** The logger the world's own is made under, as `CreateWorldOptions.log` */\n\tlog?: Logger\n\t/** What becomes of a part of the game that throws, as `CreateWorldOptions.onError` */\n\tonError?: ErrorPolicy\n}\n\n/**\n * A world as a map lays it out: its ground, the players it has room for, and everything placed on it.\n * Players with a start location that the map places nothing for get what the game starts everyone with.\n * Throws for a map made for another game (`GameMap.game`).\n *\n * @public\n */\nexport async function createWorldFromMap(options: MapWorldOptions): Promise<World> {\n\tconst { map } = options\n\t// the map's own definitions over the game's data (RC8): a footman of this map alone\n\tconst game = map.definitions ? layData(options.rules, map.definitions) : options.rules\n\tif (map.game !== undefined && map.game !== game.id) throw new Error(`\"${map.name}\" is a map for the game \"${map.game}\", not for \"${game.id}\"`)\n\tconst most = maxPlayersOf(game)\n\tconst seated = map.players.filter((player) => player.id !== MAP_CREEPS && player.id !== MAP_NEUTRAL).length\n\tif (seated > most) throw new Error(`\"${map.name}\" has ${seated} players, and ${game.name} allows ${most} (\\`Rules.maxPlayers\\`)`)\n\tconst creeps = options.creeps ?? (map.camps.length > 0 || map.objects.some((object) => object.owner === MAP_CREEPS))\n\tconst players: PlayerInit[] = [\n\t\t{ id: MAP_NEUTRAL, name: 'Neutral', team: 0, color: [0.8, 0.75, 0.4], neutral: true },\n\t\t...map.players.map((player) => ({\n\t\t\tid: player.id,\n\t\t\tname: player.name,\n\t\t\tteam: options.teams?.[player.id] ?? player.team,\n\t\t\tcolor: options.colors?.[player.id] ?? player.color,\n\t\t\t...(player.resources && { resources: { ...player.resources } }),\n\t\t\t// as the code says, or else as the map fixes it\n\t\t\t...((options.races?.[player.id] ?? player.race) !== undefined && { race: options.races?.[player.id] ?? player.race })\n\t\t})),\n\t\t...(creeps ? [{ id: MAP_CREEPS, name: 'Creeps', team: 1000, color: [0.42, 0.36, 0.3] as [number, number, number], creeps: true }] : [])\n\t]\n\t// painted as the game's tiles go: what is painted with a tile the game does not have is plain ground. The ground\n\t// it starts as is kept with the world: a save of it keeps only what changed, where the game has the map (S36)\n\tconst terrain = startingTerrain(map, game)\n\tconst base = startedOn(map.name, cloneTerrain(terrain))\n\tconst world = await createWorld({\n\t\tterrain,\n\t\trules: game,\n\t\tplayers,\n\t\t// random draws from what the map offers\n\t\t...(map.races?.length && { randomRaces: map.races }),\n\t\tseed: options.seed,\n\t\tnavigation: options.navigation,\n\t\t...(options.components && { components: options.components }),\n\t\tlog: options.log,\n\t\tonError: options.onError,\n\t\tchecks: options.checks\n\t})\n\t// what the map puts in the world, and what the game does with it: a failure leaves nothing behind\n\tworld.ground = base\n\treturn disposedOnError(world, () => {\n\t\t// a copy: the world is its own, and so is its save\n\t\tworld.setState(mapInfo, {\n\t\t\tname: map.name,\n\t\t\t// the map's own fields with what they are when not set, a region, a point or a path by its name\n\t\t\tdata: fieldValues(mapFields(world.registry), structuredClone(map.data), map),\n\t\t\tpoints: structuredClone(map.points),\n\t\t\tpaths: structuredClone(map.paths),\n\t\t\t...(map.environment && { environment: structuredClone(map.environment) }),\n\t\t\t...(map.doodads.length > 0 && { doodads: structuredClone(map.doodads) }),\n\t\t\t...(map.regions.length > 0 && { regions: structuredClone(map.regions) }),\n\t\t\t...(map.cameras.length > 0 && { cameras: structuredClone(map.cameras) }),\n\t\t\tplayers: map.players.map((player) => ({\n\t\t\t\tid: player.id,\n\t\t\t\t...(player.controller && { controller: player.controller }),\n\t\t\t\tdata: mapPlayerData(world.registry, player, map)\n\t\t\t})),\n\t\t\t...(map.forces?.length && { forces: structuredClone(map.forces) }),\n\t\t\t...(map.itemTables?.length && { itemTables: structuredClone(map.itemTables) }),\n\t\t\t...(map.definitions && { definitions: structuredClone(map.definitions) })\n\t\t})\n\t\t// the gates, shut ones in the way\n\t\tsetUpGates(world)\n\t\t// a force that shares control: every player of it may command the others' units\n\t\tfor (const force of map.forces ?? []) {\n\t\t\tif (!force.sharedControl) continue\n\t\t\tconst members = map.players.filter((player) => player.team === force.team)\n\t\t\tfor (const one of members) for (const other of members) if (one !== other) world.sides.shareControl(one.id, other.id)\n\t\t}\n\t\t// the whole map explored from the start, as the map says, else as the game's rules do (`FogSettings.startExplored`)\n\t\tworld.fog.exploreFromStart(map.explored ?? world.settings.fog?.startExplored ?? false)\n\t\t// the time of day the map starts at, and whether it moves\n\t\tif (map.day?.start !== undefined) world.clock.setHour(map.day.start)\n\t\tif (map.day?.still) world.clock.stop()\n\t\t// the regions first: what is placed may be inside one from the start, and the game's hooks may ask\n\t\tfor (const region of map.regions) {\n\t\t\tif (world.areas.has(region.name)) throw new Error(`The region \"${region.name}\" of \"${map.name}\" has the name of an area of the game`)\n\t\t\tconst area = { id: region.name, shape: { ...region.shape } }\n\t\t\tworld.areas.add(area)\n\t\t\tif (world.hooks.has('mapRegion')) world.hooks.run('mapRegion', { area, region, data: mapRegionData(world.registry, region, map) })\n\t\t}\n\t\tconst known = new Set(players.map((player) => player.id))\n\t\tconst placed = new Set<PlayerId>()\n\t\t// what is drawn from a random group is drawn now, once, from the world's own numbers: the same for the same seed\n\t\tconst groups = new Map((map.randomGroups ?? []).map((group) => [group.name, group]))\n\t\tconst drawn = (type: string, random: string | undefined) => {\n\t\t\tconst group = random === undefined ? undefined : groups.get(random)\n\t\t\treturn (group && drawFromGroup(group, world.registry, world.rng)) ?? type\n\t\t}\n\t\t// what stands still goes first, so that units find their way around it\n\t\tconst objects = map.objects\n\t\t\t.map((object) => (object.random ? { ...object, type: drawn(object.type, object.random) } : object))\n\t\t\t.filter((object) => world.registry.units.has(object.type) && known.has(object.owner))\n\t\t// and of that, resources before buildings: what goes up on a resource (`builtOn`) finds it there\n\t\tconst rank = (type: string) => ({ resource: 0, building: 1, unit: 2 })[world.registry.unit(type).kind] ?? 1\n\t\tobjects.sort((a, b) => rank(a.type) - rank(b.type))\n\t\t// every structure's obstacle made into the ground's tiles together, as a load does (RV42): a wooded tile once, not\n\t\t// once a tree. Let go before the first unit, which is put on the ways with every structure in them\n\t\tlet held = true\n\t\tworld.nav.holdObstacles?.(true)\n\t\tconst letGo = () => {\n\t\t\tif (held) world.nav.holdObstacles?.(false)\n\t\t\theld = false\n\t\t}\n\t\t/** Units of the map with orders of their own, given once everything stands (a path's ends, a guard's post) */\n\t\tconst ordered: [Entity, MapObjectOrder[]][] = []\n\t\tfor (const object of objects) {\n\t\t\tif (held && rank(object.type) === 2) letGo()\n\t\t\tconst entity = spawnMapObject(world, object, map)\n\t\t\tif (object.orders?.length) ordered.push([entity, object.orders])\n\t\t\tplaced.add(object.owner)\n\t\t}\n\t\tletGo()\n\t\tfor (const [entity, orders] of ordered) giveMapOrders(world, entity, orders)\n\t\tfor (const camp of map.camps) {\n\t\t\t// a unit of a camp is one of a random group when it says `@group`\n\t\t\tconst units = camp.units\n\t\t\t\t.map((type) => (type.startsWith('@') ? drawn('', type.slice(1)) : type))\n\t\t\t\t.filter((type) => world.registry.units.has(type))\n\t\t\tif (!units.length) continue\n\t\t\tconst made = spawnCamp(world, MAP_CREEPS, camp, units)\n\t\t\tif (camp.name) made.name = camp.name\n\t\t\tif (camp.respawn !== undefined) made.respawn = camp.respawn\n\t\t\tif (world.hooks.has('mapCamp')) world.hooks.run('mapCamp', { camp: made, from: camp, data: mapCampData(world.registry, camp, map) })\n\t\t}\n\t\t// a player's race has a start of its own, in place of the game's\n\t\tconst raceDef = (player: PlayerId) => {\n\t\t\tconst race = world.players.get(player)?.race\n\t\t\treturn race === undefined ? undefined : world.registry.race(race)\n\t\t}\n\t\tfor (const player of map.players) {\n\t\t\tif (player.start && !placed.has(player.id)) spawnStartingBase(world, raceDef(player.id)?.startingBase ?? game.startingBase, player.id, player.start)\n\t\t}\n\t\t// a copy of a race keeps the original's `onStart` unless it says not to (`RaceDef.inherits`)\n\t\tfor (const player of map.players) {\n\t\t\tconst race = raceDef(player.id)\n\t\t\tif (race && race.inherits?.onStart !== false) race.onStart?.(world, player.id)\n\t\t}\n\t\t// what a pack starts of its own from the map: the objectives it gives at the start (`mapObjectives`)\n\t\tif (world.hooks.has('mapStart')) world.hooks.run('mapStart', { map })\n\t})\n}\n\n/**\n * Players a map of the game may have (`Rules.maxPlayers`): 8 when it says nothing, never more than the fog keeps apart\n *\n * @beta\n */\nexport const maxPlayersOf = (game: Rules): number => Math.max(1, Math.min(Math.floor(game.maxPlayers ?? DEFAULT_MAX_PLAYERS), MAX_MAP_PLAYERS))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkJA,IAAM,aAA8B;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;;AASA,IAAa,cAAiC;CAC7C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;AAgXA,IAAM,mBAA+C;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;AAGA,IAAM,aAAa,cAAc,WAAW,EAAE,OAAO,aAAa,MAAM,SAAS,SAAS,OAAO,MAAM,CAAC;;AAGxG,IAAM,oBAA8C;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;AAMA,IAAM,YAAoD;CAAC;CAAW;CAAiB;CAAgB;AAAK;;AAkD5G,IAAM,6BAAa,IAAI,QAA8B;;;;;;;AAQrD,SAAgB,aAAa,MAA4B;CACxD,MAAM,QAAQ,WAAW,IAAI,IAAI;CACjC,IAAI,OAAO,OAAO;CAClB,MAAM,QAAQ,KAAK,SAAS,CAAC;CAC7B,KAAK,MAAM,QAAQ,OAClB,KAAK,MAAM,UAAU,KAAK,YAAY,CAAC,GACtC,IAAI,CAAC,MAAM,MAAM,SAAS,KAAK,OAAO,MAAM,GAC3C,MAAM,IAAI,MAAM,aAAa,KAAK,GAAG,wBAAwB,OAAO,YAAY,KAAK,GAAG,gBAAgB;CAC3G,MAAM,QAAW,SAA4D,MAAM,SAAS,SAAS,KAAK,IAAI,KAAK,CAAC,CAAC;C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"}

package/dist/gameData.d.ts

@@ -1,8 +1,10 @@
-import type { DamageTable } from './rules';
+import { type CallingDef } from './callings';
+import { type DataCellLayer } from './cellLayers';
 import type { AiProfile } from './ai/profiles';
-import { type AbilityDef, type BuffDef, type ItemDef, type ResourceDef, type UnitTypeDef, type UpgradeDef, type UpkeepTier } from './defs';
+import { type DataSetChoice } from './defaultSets';
+import { type AbilityDef, type BuffDef, type ItemDef, type ResourceDef, type TagDef, type UnitTypeDef, type UpgradeDef, type UpkeepTier } from './defs';
 import { type Check } from './fields';
-import type { GameModule } from './game';
+import type { Rules } from './game';
 import type { RaceDef } from './races';
 import type { Registry } from './registry';
 /**
@@ -11,7 +13,11 @@ import type { Registry } from './registry';
  * @beta
  */
 export declare const DATA_KINDS: readonly ['units', 'abilities', 'buffs', 'items', 'upgrades', 'races'];
-/** @beta */
+/**
+ * The kind of definition a game's data is kept for: one of `DATA_KINDS` (`units`, `abilities`, `buffs`, `items`, `upgrades`, `races`)
+ *
+ * @beta
+ */
 export type DataKind = (typeof DATA_KINDS)[number];
 /**
  * What a definition of each kind must have besides its id and its name, as the type says (`UnitTypeDef.radius`...),
@@ -41,11 +47,17 @@ export declare function blankDefinition<K extends DataKind>(kind: K, id: string,
  * @beta
  */
 export interface DataDefs {
+    /** The unit types of the game, each a `UnitTypeDef` */
     units: UnitTypeDef;
+    /** The abilities of the game, each an `AbilityDef` */
     abilities: AbilityDef;
+    /** The buffs of the game, each a `BuffDef` */
     buffs: BuffDef;
+    /** The items of the game, each an `ItemDef` */
     items: ItemDef;
+    /** The upgrades of the game, each an `UpgradeDef` */
     upgrades: UpgradeDef;
+    /** The races of the game, each a `RaceDef` */
     races: RaceDef;
 }
 /**
@@ -79,6 +91,7 @@ export declare const COPY_OF = "copyOf";
  * @beta
  */
 export interface DataValues {
+    /** A field of the definition by name: a value, a list of values, or nested values (a `stats` group, a list of `effects`) */
     [field: string]: DataValue | DataValue[] | DataValues | DataValues[];
 }
 /**
@@ -91,24 +104,66 @@ export type GameData = Partial<Record<DataKind, Record<string, DataValues>>> & {
     removed?: Partial<Record<DataKind, string[]>>;
     /**
      * How the game's computers play each race (campaign plan AR4), by race id: each a whole profile, in the place of the
-     * code's (`GameModule.ai.races`). What the editor's Data panel writes of a race's AI
+     * code's (`Rules.ai.races`). What the editor's Data panel writes of a race's AI
      */
     ai?: {
         races?: Record<string, AiProfile>;
     };
     /** The rules as data (campaign plan RC7), laid over the game's (`DataRules`): what the Data panel's Rules writes */
     rules?: DataRules;
+    /**
+     * What the game takes of the default sets it took in code (`useDefaults`), by set id, over what its code chose: all
+     * of a set, none, only some ids or all but some (`DataSetChoice`): `{ "items": { "except": ["sightWard"] } }`. Laid
+     * first, so the rest of the file changes what it took
+     */
+    defaults?: Record<string, DataSetChoice>;
+    /**
+     * The tags named and given a look (`TagDef`), by tag (items-and-spells plan, phase 9): each over the code's `TagDef`
+     * of that tag, or one of its own. What the Data panel's Tags writes: `{ "lifesteal": { "color": "#c04040", "filter": true } }`
+     */
+    tags?: Record<string, DataTag>;
+    /**
+     * The callings heroes may have (`CallingDef`), by id: each over the game's calling of that id (its name, line, icon,
+     * colour), or one of its own. What the Data panel's Callings writes: `{ "vanguard": { "name": "Bulwark" } }`. A calling
+     * of the default set is left out with `defaults.callings`
+     */
+    callings?: Record<string, DataCalling>;
+    /**
+     * The values of the game's layers of cells (`CellLayerDef.values`), by layer: each over the code's value of the same
+     * number, or one of its own (`DataCellLayer`). What the editor writes of a style of grass made or changed there, its
+     * name and what it is to the rules (`FoliageStyleDef`): in the game's `data.json` for every map, in a map's
+     * definitions (`GameMap.definitions`) for that map alone
+     */
+    cellLayers?: Record<string, DataCellLayer>;
 };
 /**
- * The rules a `data.json` may say (campaign plan RC7), each over the game's: the damage table whole, the supply's and
- * the heroes' numbers, the resources and the upkeep's tiers whole (in place of `GameModule.resources`, `upkeep`)
+ * What a `data.json` says of a tag (`GameData.tags`): a `TagDef` without its id, over the code's of the same tag
+ *
+ * @beta
+ */
+export type DataTag = Omit<TagDef, 'id'>;
+/**
+ * What a `data.json` says of a calling (`GameData.callings`): a `CallingDef` without its id, any of it, over the game's
+ * of the same id. One of its own is named by its id where it says no name
+ *
+ * @beta
+ */
+export type DataCalling = Partial<Omit<CallingDef, 'id'>>;
+/**
+ * Why what a `data.json` says of its tags or callings (`GameData.tags`, `callings`) is not right, where it first is
+ * not: nothing when it is
+ *
+ * @beta
+ */
+export declare function dataEntriesProblem(section: 'tags' | 'callings', said: unknown): string | undefined;
+/**
+ * The rules a `data.json` may say (campaign plan RC7), each over the game's: the supply's and
+ * the heroes' numbers, the resources and the upkeep's tiers whole (in place of `Rules.resources`, `upkeep`)
  *
  * @beta
  */
 export interface DataRules {
-    combat?: {
-        damageTable?: DamageTable;
-    };
+    /** The supply numbers: `max` is the most supply a player can have, `pools` names the extra supply pools by id with their own `max` */
     supply?: {
         max?: number;
         pools?: Record<string, {
@@ -116,12 +171,21 @@ export interface DataRules {
             max: number;
         }>;
     };
+    /**
+     * The hero rules: `maxHeroes` a player may have, `maxHeroLevel` a hero can reach, `xpRange` the distance within which
+     * units share experience, `assistTime` the seconds within which harm or help makes an assist (0 for none), and
+     * `buybackCooldown` the seconds a hero bought back waits to be again
+     */
     heroes?: {
         maxHeroes?: number;
         maxHeroLevel?: number;
         xpRange?: number;
+        assistTime?: number;
+        buybackCooldown?: number;
     };
+    /** The resource kinds of the game whole, in place of `Rules.resources` */
     resources?: ResourceDef[];
+    /** The upkeep tiers whole, in place of `Rules.upkeep` */
     upkeep?: UpkeepTier[];
 }
 /**
@@ -144,9 +208,11 @@ export interface EditableField {
      * What it holds. What the definition has there now, when left out (a number where it has nothing). A `list` is of
      * words, in order: ids of the kind `of` says, when it says. An `id` is one id of the kind `of` says (the hall a race
      * starts with), picked from what the game has of that kind. `rows` is a list of things, each with fields of its own
-     * (`effects.0.amount`), added, taken out and put in another order whole: an ability's effects
+     * (`effects.0.amount`), added, taken out and put in another order whole: an ability's effects. An `either` is a value
+     * of more than one kind: yes or no, one of the words of `options` (`origin.caster`: true, false or `otherwise`), or a
+     * number as well where `orNumber` says (a missile's `pierce`: true, false or how many it goes through)
      */
-    kind?: 'number' | 'integer' | 'text' | 'boolean' | 'choice' | 'list' | 'id' | 'rows';
+    kind?: 'number' | 'integer' | 'text' | 'boolean' | 'choice' | 'either' | 'list' | 'id' | 'rows';
     /** Of a `list` or an `id`: the kind of definition its words are ids of (`abilities` for a unit's abilities) */
     of?: DataKind;
     /**
@@ -154,11 +220,16 @@ export interface EditableField {
      * kept as the one id
      */
     one?: boolean;
+    /** Of a `number` or `integer` field, or the number of an `either`: the least it can be set to in the editor */
     min?: number;
+    /** Of a `number` or `integer` field, or the number of an `either`: the most it can be set to in the editor */
     max?: number;
+    /** Of a `number` field, or the number of an `either`: the size of one step of the editor's input */
     step?: number;
-    /** What a `choice` can be */
+    /** What a `choice` can be; the words an `either` can be besides yes and no */
     options?: readonly string[];
+    /** Of an `either`: it may be a number besides, any (`number`) or a whole one (`integer`). Not a number when left out */
+    orNumber?: 'number' | 'integer';
     /** Of `rows` of effects: the types a row can be, those the game has (`defineEffect`). A row of no type when left out */
     types?: readonly string[];
     /** The heading it is shown under: the first part of its path, when left out (`stats`, `cost`) */
@@ -172,8 +243,11 @@ export interface EditableField {
  * @beta
  */
 export interface DataField extends EditableField {
+    /** The field's path in the definition (`stats.health`, `cost.gold`), as `data.json` nests it */
     name: string;
+    /** How the field is edited, `EditableField.kind` with the guess made when the game did not say */
     kind: NonNullable<EditableField['kind']>;
+    /** The heading the field is shown under in the editor, the first part of its path when `EditableField.group` is not said */
     group: string;
 }
 /**
@@ -185,7 +259,7 @@ export interface DataField extends EditableField {
  */
 export type EditableFields<D = unknown> = 'all' | readonly (string | EditableField)[] | ((def: D) => 'all' | readonly (string | EditableField)[] | null);
 /**
- * What of a game's data the editor can change, by kind (`GameModule.editable`). `all` for every field of every definition
+ * What of a game's data the editor can change, by kind (`Rules.editable`). `all` for every field of every definition
  *
  * @beta
  */
@@ -210,20 +284,20 @@ export declare function nested(path: string, value: FieldValue): DataValues;
  *
  * @beta
  */
-export declare function effectFields(game: Pick<GameModule, 'effects'> | null | undefined, type: string): EditableField[];
+export declare function effectFields(game: (Pick<Rules, 'effects'> & Partial<Pick<Rules, 'packs'>>) | null | undefined, type: string): EditableField[];
 /**
  * The types of effect a game has (`defineEffect`): the engine's and its own, in order of their names
  *
  * @beta
  */
-export declare function effectTypesOf(game: Pick<GameModule, 'effects'> | null | undefined): string[];
+export declare function effectTypesOf(game: (Pick<Rules, 'effects'> & Partial<Pick<Rules, 'packs'>>) | null | undefined): string[];
 /**
- * The fields of a definition the editor may change, as the game says (`GameModule.editable`), each with what it
+ * The fields of a definition the editor may change, as the game says (`Rules.editable`), each with what it
  * holds and the heading it goes under. None for a game that says nothing of that kind
  *
  * @beta
  */
-export declare function editableFields<K extends DataKind>(game: (Pick<GameModule, 'editable'> & Partial<Pick<GameModule, 'effects' | 'stats'>>) | null | undefined, kind: K, def: DataDefs[K]): DataField[];
+export declare function editableFields<K extends DataKind>(game: (Pick<Rules, 'editable'> & Partial<Pick<Rules, 'effects' | 'stats' | 'packs' | 'units'>>) | null | undefined, kind: K, def: DataDefs[K]): DataField[];
 /**
  * A value as a field takes it, or the reason it does not
  *
@@ -241,7 +315,7 @@ export declare function fitValue(field: DataField, value: unknown): {
  *
  * @beta
  */
-export declare function withValues<D>(def: D, values: DataValues): D;
+export declare function layValues<D>(def: D, values: DataValues): D;
 /**
  * Values merged: what `b` says over what `a` says, at any depth. Places said over a list go into it (`{ 0: { amount:
  * 50 } }` over a list of effects); a list said is the list
@@ -257,13 +331,13 @@ export declare function mergeValues(a: DataValues, b: DataValues): DataValues;
  */
 export declare function editableValues(fields: readonly DataField[], values: DataValues, said?: (why: string) => void): DataValues;
 /**
- * The game with what its `data.json` says over what its code says: `export default withData(game, dataFile)`. Only
- * the fields the game lets be changed (`GameModule.editable`) are taken, and of the kind each holds; anything else in
+ * The game with what its `data.json` says over what its code says: `export default layData(game, dataFile)`. Only
+ * the fields the game lets be changed (`Rules.editable`) are taken, and of the kind each holds; anything else in
  * the file is left out, and said in the log. The game given is not changed
  *
  * @beta
  */
-export declare function withData(game: GameModule, file: unknown): GameModule;
+export declare function layData(game: Rules, file: unknown): Rules;
 /**
  * What a world's definitions were changed to while it runs (`world.redefine`), by kind and id: kept with the world
  * and in its save, so that a load has them again