@v12-engine/engine 0.1.0 → 0.4.0

package/dist/burning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"burning.js","names":[],"sources":["../src/burning.ts"],"sourcesContent":["import { defineEffect, effectFilter } from './abilities/effects'\nimport { areaReach, effectArea, inArea } from './abilities/shapes'\nimport { defineComponent } from './components'\nimport type { DamageType, UnitTypeDef } from './defs'\nimport { deposit, edgeDistance, type Entity, type EntityId } from './entity'\nimport { defineEvent } from './events'\nimport { cos, exp, sin } from './exactMath'\nimport { type FoliageFireRules, foliageFireOf } from './foliage'\nimport { type Cancellable, defineHook, defineHookType } from './hooks'\nimport type { MapEnvironment } from './map/look'\nimport { mapInfo } from './names'\nimport type { GamePack } from './packs/pack'\nimport type { System } from './registry'\nimport type { World } from './world'\n\n/*\n * Things that burn, an opt-in pack: trees by default, and any type a game names (a wooden wall, a\n * hut). Apart from the grass's fire (`foliage.ts`): what burns here is an entity, not a cell, and the pack works with\n * no foliage pack at all; where both are on, each may light the other (`FoliageFire.lights`, `lightsFoliage`), as fire\n * passes, not at once: both ways are tried at this pack's turn (its system), each try by a chance of its own, asked of\n * the game, what caught set alight at the end of the turn, and trying nothing before its own next turn. Nothing lights\n * within the call or the event that lit another, so a forest in a meadow burns over seconds, not in one call.\n *\n * What burns carries a component of its own (`onFire`: what kind of burning, from which tick to which, put out when),\n * told to everyone who sees it, which is what its look goes by on the screen; the world keeps the ids of what burns\n * now, in order (`fireList`). A tick looks at those alone: scenery that burns is not woken (`world.wake`), so a forest\n * of thousands of trees costs nothing while nothing burns, and what burns costs what this pack does with it and\n * nothing in every system that looks at every actor. Not a buff: a buff on a tree wakes it, and 2,000 trees woken cost\n * 0.42-0.48 ms a tick before anything of the fire was done (measured).\n */\n\n/**\n * The burning pack's id (`burningPack`), for `hasPack`\n *\n * @beta\n */\nexport const BURNING = 'burning'\n\n/**\n * How a thing burns (`UnitTypeDef.burns`, `BurningOptions`): for how long, what is left of it, whether its wood is kept,\n * and what kind of burning it is. What a type does not say is the pack's, then what each field says it is when left\n * out. Plain data: the editor writes it\n *\n * @beta\n */\nexport interface BurnsDef {\n\t/** Seconds it burns before it is burnt down: 20 when left out */\n\tseconds?: number\n\t/**\n\t * What is left once it has burnt down: `felled` (it comes down, as a tree a blast brings down: the death's reason is\n\t * `felled`), `nothing` (it burns away: the reason is `burnt`), or the id of a unit type put down where it stood (a\n\t * charred stump, a heap of ash: the reason `burnt` too). `felled` when left out\n\t */\n\tleaves?: 'felled' | 'nothing' | (string & {})\n\t/**\n\t * Whether what it leaves keeps its wood: a resource left in its place (`leaves` a type with `resource`) holds what\n\t * it had left of its own. No when left out, and what is left holds what its type says\n\t */\n\twood?: boolean\n\t/**\n\t * What kind of burning it is, for the screen (the look's `burning.how`) and its death (`death.how`): `burnt` when\n\t * left out. Another word for another kind: a blight that withers it, frost that shatters it\n\t */\n\thow?: string\n}\n\n/**\n * How fire passes from a burning thing to what burns about it (`BurningOptions.spread`): how far, how likely, how much\n * the wind decides, how often it tries. It passes to what stands (trees, buildings, a wall): a unit that burns is set\n * alight by a call or an ability alone\n *\n * @beta\n */\nexport interface BurningSpread {\n\t/** How far it reaches, edge to edge, in cells: 1.5 when left out */\n\treach?: number\n\t/** How likely a try is to light one thing within reach in still air, 0 to 1: 0.15 when left out */\n\tchance?: number\n\t/** How much the wind decides which way it goes (`MapEnvironment.wind`), 0 (not at all) and up: 1 when left out */\n\twind?: number\n\t/** Seconds between a burning thing's tries: 1 when left out */\n\tevery?: number\n}\n\n/**\n * What the burning pack is made with (`burningPack`): what burns, how (the defaults of `BurnsDef`, under what a type\n * says), whether fire passes from one thing to the next, what it does to those who stand by, and how much may burn\n *\n * @beta\n */\nexport interface BurningOptions extends BurnsDef {\n\t/**\n\t * What burns, and how, in code: `true` (as its type and the pack say), a `BurnsDef` over those, or `false`. Where it\n\t * says nothing, its type's `burns`; where that says nothing, what can be felled (`fellable`: trees)\n\t */\n\tburns?: (world: World, entity: Entity) => boolean | BurnsDef | undefined\n\t/** Whether a burning thing lights what burns about it (`BurningSpread`): `true` for the defaults. Never when left out */\n\tspread?: BurningSpread | boolean\n\t/**\n\t * Damage a second to units on the ground within `damageReach` of a burning thing, by whoever lit it (the first of\n\t * those about it, in order of their ids): none when left out. Dealt twice a second, each unit on a turn of its own\n\t */\n\tdamage?: number\n\t/** How far its heat hurts, edge to edge, in cells: 1 when left out */\n\tdamageReach?: number\n\t/** The type that damage is dealt as: magic when left out */\n\tdamageType?: DamageType\n\t/** The most things that burn at once: past it, nothing more catches until something has burnt down. 2000 when left out */\n\tmaxBurning?: number\n\t/**\n\t * Whether a burning thing may set alight the grass about it, in a game with the foliage pack too (`foliagePack`):\n\t * the cells under it and one cell round, of every layer of that pack, or of those named. No when left out. It\n\t * passes as fire does, not at once: once a second while it burns, each cell by a chance of its own (0.2 for a style\n\t * of `flammable` 1 in still, dry air, likelier downwind), asked of the game (`foliageIgnite`, `cause: 'burning'`),\n\t * under the most that may burn there (`FoliageFire.maxBurning`). What caught is set alight at the end of this pack's\n\t * turn, and tries nothing before its own next turn. The other way is that pack's to say (`FoliageFire.lights`)\n\t */\n\tlightsFoliage?: boolean | readonly string[]\n}\n\n/**\n * What sets a thing alight: set alight by a call or an ability (`light`), caught from a burning thing about it\n * (`spread`), or from burning grass (`foliage`)\n *\n * @beta\n */\nexport type BurnCause = 'light' | 'spread' | 'foliage'\n\n/**\n * A thing about to catch fire (the `burnStart` hook): `cancel()` keeps it from catching; `chance` is a handler's to\n * change (a wet grove, a building that does not burn while it is being built). Asked once a try\n *\n * @beta\n */\nexport interface BurnStart extends Cancellable {\n\t/** What is about to catch */\n\treadonly entity: Entity\n\t/** How it catches */\n\treadonly cause: BurnCause\n\t/** The burning thing it catches from, for a spread */\n\treadonly from?: Entity\n\t/** The layer of grass of the burning cell it catches from, for one caught from grass (`foliage`) */\n\treadonly layer?: string\n\t/** The burning cell it catches from, by its index in that layer, for one caught from grass (`foliage`) */\n\treadonly cell?: number\n\t/** Who set alight the fire it is of, where someone did */\n\treadonly by?: Entity\n\t/** What kind of burning it is (`BurnsDef.how`) */\n\treadonly how: string\n\t/**\n\t * How likely it is to catch, 0 to 1: 1 for one set alight, the spread's chance in the wind for one caught from a\n\t * burning thing, the grass's for one caught from grass (`FoliageFire.lights`). What a handler leaves it at is held\n\t * to 0 to 1 (more than 1 is sure, less than 0 never)\n\t */\n\tchance: number\n}\n\n/**\n * Asked before a thing catches fire (`BurnStart`): a handler refuses it or changes its chance. Once for every try:\n * of a call, a spread, or grass burning beside it; so a handler does little\n *\n * @beta\n */\nexport const burnStart = /* @__PURE__ */ defineHookType<BurnStart>({ id: 'burning.start' })\n\n/**\n * Something caught fire: how, who lit the fire it is of, what kind of burning it is. What a game's rules and its computer\n * players hear; the screens are told by what burns (`onFire`)\n *\n * @beta\n */\nexport const burnStarted = defineEvent<{ entity: EntityId; cause: BurnCause; how: string; by?: EntityId }>({ id: 'burning.started' })\n\n/**\n * Something burnt down: what kind of burning it was, who lit it, and what it left where it stood (`BurnsDef.leaves`), where\n * it left a thing\n *\n * @beta\n */\nexport const burnt = defineEvent<{ entity: EntityId; how: string; by?: EntityId; left?: EntityId }>({ id: 'burning.burnt' })\n\n/**\n * Something that burnt was put out (`putOut`, an ability): it stands, charred as far as it burnt\n *\n * @beta\n */\nexport const burnPutOut = defineEvent<{ entity: EntityId }>({ id: 'burning.putOut' })\n\n/**\n * What burns, as everyone who sees it is told (`onFire`): the kind of burning, the tick it started and the tick it burns\n * down at; `out`, the tick it was put out at, for one that burns no more (charred as far as it came: `(out - since) /\n * (ends - since)`). A screen draws how far it has burnt from these and its own tick, with nothing sent as it goes\n *\n * @beta\n */\nexport interface FireShown {\n\t/** What kind of burning it is (`BurnsDef.how`) */\n\thow: string\n\t/** The tick it started to burn at: as far back as it had burnt already, for one lit again */\n\tsince: number\n\t/** The tick it burns down at */\n\tends: number\n\t/** The tick it was put out at, for one that burns no more */\n\tout?: number\n}\n\n/**\n * What burns or burnt and was put out, on the thing itself (`FireShown`): told to everyone who sees it as it is (no\n * part of it one player's, so that what a team remembers of a tree is the same for each of them), kept by a save.\n * `snapshotOf(entity.state, onFire)` on a screen; `isBurning` and `burningOf` in the rules\n *\n * @beta\n */\nexport const onFire = /* @__PURE__ */ defineComponent<FireShown>({\n\tid: 'burning',\n\treplicate: 'everyone',\n\tsame: (a, b) => a.how === b.how && a.since === b.since && a.ends === b.ends && a.out === b.out\n})\n\n/**\n * What burns in a world: the ids of the things that burn now, in order, who lit the fire each is of (0 for nobody),\n * and the tick each burns down at: what a tick goes by without looking the thing up, but on its turn\n */\ninterface FireList {\n\tids: number[]\n\tby: number[]\n\tends: number[]\n}\n\n/** What burns in a world (`FireList`), kept by a save */\nconst fireList = /* @__PURE__ */ defineComponent<FireList>({ id: 'burning.list', default: () => ({ ids: [], by: [], ends: [] }) })\n\n/** What `BurnsDef` says, each as it is when left out */\ntype Burns = Required<Omit<BurnsDef, 'leaves'>> & { leaves: string }\n\n/** The air over the map as its environment says (`MapEnvironment.wind`): the wind's way on the ground and strength */\ninterface Air {\n\t/** The environment it was worked out of: another (`world.setEnvironment`) works it out again */\n\tof: MapEnvironment | undefined\n\t/** How strong the wind is, 0 (still) to 1 (a gale) */\n\tstrength: number\n\t/** Downwind on the ground, along x and z */\n\tx: number\n\tz: number\n}\n\n/** How much a gale makes a try downwind likelier (`BurningSpread.wind` 1, the wind's strength 1: e² ≈ 7.4 times), and upwind less */\nconst WIND = 2\n/** How often a burning thing that tries nothing is looked at, to see it still stands, in seconds */\nconst LOOK_EVERY = 1\n/** How often who stands by a burning thing is hurt (`BurningOptions.damage`), in seconds */\nconst SCORCH_EVERY = 0.5\n/**\n * How likely a burning cell of grass is to light a thing that burns on it or beside it at one of its tries (four a\n * second, `FoliageFire.every`, `FoliageFire.lights`): of grass of `fuel` 1, in still air and dry. A tree a front\n * reaches, three or four cells about it burning, catches in a second or two, seldom in the first tick\n */\nconst FROM_GRASS = 0.05\n\n/** Where the pack keeps its rules, on the pack, for the calls made on a world of its game */\nconst RULES = Symbol('burning rules')\n\n/** The burning pack with its rules beside it */\ntype BurningPack = GamePack & { [RULES]?: BurningRules }\n\n/**\n * The pack's rules: its settings, and what a tick and the calls do with a world's `fireList` and `onFire`. One a pack,\n * for every world of its game: what it keeps of a world is scratch, emptied as each call ends\n */\nclass BurningRules {\n\t/** What burns, as the pack was told, before its type is asked */\n\treadonly decides: BurningOptions['burns']\n\t/** The defaults of `BurnsDef` */\n\treadonly base: Burns\n\t/** Whether fire passes from one thing to the next, and how: none for never */\n\treadonly spread: Required<BurningSpread> | undefined\n\t/** Damage a second to who stands by */\n\treadonly damage: number\n\t/** How far that reaches */\n\treadonly damageReach: number\n\t/** The type it is dealt as */\n\treadonly damageType: DamageType\n\t/** The most that burns at once */\n\treadonly maxBurning: number\n\t/** Whether what burns tries the grass about it: the layers named, or every layer of the foliage pack (`true`) */\n\treadonly lightsFoliage: boolean | readonly string[]\n\t/** The system that runs it */\n\treadonly system: System\n\t/** The air as last worked out (`airOf`) */\n\tprivate air: Air | undefined\n\t/** How each type burns where the game decides nothing in code, by its definition: null for one that does not */\n\tprivate readonly typed = new WeakMap<UnitTypeDef, Burns | null>()\n\t/** Scratch of a call: what a search found */\n\tprivate readonly found: Entity[] = []\n\t/** Scratch of a call: what of it may catch, or be hurt, in order of their ids */\n\tprivate readonly near: Entity[] = []\n\t/** Scratch of a tick: what caught in it, how, and who lit the fire it caught from */\n\tprivate readonly fresh: { entity: Entity; by: number; cause: BurnCause }[] = []\n\t/** Scratch of a tick: the cells of grass that caught from what burns in it (`lightsFoliage`), by layer, cell and whose */\n\tprivate readonly grassCaught = { layers: [] as number[], cells: [] as number[], by: [] as number[], keys: new Set<number>() }\n\t/** The link to the grass of each game seen, by its packs: none where neither way is on, or the game has no grass that burns */\n\tprivate readonly links = new WeakMap<readonly GamePack[], GrassLink | null>()\n\t/** Scratch of a tick: who is hurt in it, and by whom */\n\tprivate readonly hurt: { unit: Entity; by: number }[] = []\n\t/** The thing being burnt down right now: its death is given its `how` (the `death` hook) */\n\tending: { entity: Entity; how: string } | undefined\n\n\tconstructor(options: BurningOptions) {\n\t\tthis.decides = options.burns\n\t\tthis.base = {\n\t\t\tseconds: Math.max(0, options.seconds ?? 20),\n\t\t\tleaves: options.leaves ?? 'felled',\n\t\t\twood: options.wood ?? false,\n\t\t\thow: options.how ?? 'burnt'\n\t\t}\n\t\tconst spread = options.spread === true ? {} : options.spread || undefined\n\t\tthis.spread = spread && {\n\t\t\treach: Math.max(0, spread.reach ?? 1.5),\n\t\t\tchance: Math.min(1, Math.max(0, spread.chance ?? 0.15)),\n\t\t\twind: Math.max(0, spread.wind ?? 1),\n\t\t\tevery: Math.max(0, spread.every ?? 1)\n\t\t}\n\t\tthis.damage = Math.max(0, options.damage ?? 0)\n\t\tthis.damageReach = Math.max(0, options.damageReach ?? 1)\n\t\tthis.damageType = options.damageType ?? 'magic'\n\t\tthis.maxBurning = Math.max(0, Math.floor(options.maxBurning ?? 2000))\n\t\tthis.lightsFoliage = options.lightsFoliage ?? false\n\t\tthis.system = {\n\t\t\tname: 'burning',\n\t\t\tphase: 'resolve',\n\t\t\tupdate: (world) => {\n\t\t\t\t// nothing was ever set alight, and no grass burns beside what may catch from it: nothing to look at\n\t\t\t\tconst list = world.states.has(fireList) ? world.state(fireList) : undefined\n\t\t\t\tconst grass = this.linkOf(world)\n\t\t\t\tif (list?.ids.length || (grass?.fromGrass && grass.fire.anyBurning(world))) this.tick(world, list, grass)\n\t\t\t}\n\t\t}\n\t}\n\n\t/** The link to the grass of a world's game (`GrassLink`): none where neither way is on or it has no grass that burns */\n\tlinkOf(world: World): GrassLink | undefined {\n\t\tconst packs = world.registry.assembly?.rules.packs\n\t\tif (!packs) return undefined\n\t\tlet link = this.links.get(packs)\n\t\tif (link === undefined) {\n\t\t\tconst fire = foliageFireOf(world)\n\t\t\tconst lights = this.lightsFoliage\n\t\t\tconst toGrass = !fire\n\t\t\t\t? []\n\t\t\t\t: fire.layers.flatMap((layer, l) => (lights === true || (Array.isArray(lights) && lights.includes(layer)) ? [l] : []))\n\t\t\tlink = fire && (fire.lights || toGrass.length) ? { fire, toGrass, fromGrass: fire.lights } : null\n\t\t\tthis.links.set(packs, link)\n\t\t}\n\t\treturn link ?? undefined\n\t}\n\n\t/** How a thing burns (`Burns`): none for what does not */\n\tburnsOf(world: World, entity: Entity): Burns | undefined {\n\t\tconst decided = this.decides?.(world, entity)\n\t\t// what its type says alone, worked out once a type: asked of every tree a fire tries\n\t\tif (decided === undefined) {\n\t\t\tlet typed = this.typed.get(entity.def)\n\t\t\tif (typed === undefined) this.typed.set(entity.def, (typed = this.burnsBy(entity, undefined) ?? null))\n\t\t\treturn typed ?? undefined\n\t\t}\n\t\treturn this.burnsBy(entity, decided)\n\t}\n\n\t/** How a thing burns, as the game decided in code (`decided`) over its type, over the pack */\n\tprivate burnsBy(entity: Entity, decided: boolean | BurnsDef | undefined): Burns | undefined {\n\t\tconst own = decided ?? entity.def.burns ?? (entity.def.fellable ? true : undefined)\n\t\tif (!own) return undefined\n\t\tconst def = entity.def.burns\n\t\tconst typed = typeof def === 'object' ? def : undefined\n\t\tconst said = typeof own === 'object' ? own : undefined\n\t\treturn {\n\t\t\tseconds: Math.max(0, said?.seconds ?? typed?.seconds ?? this.base.seconds),\n\t\t\tleaves: said?.leaves ?? typed?.leaves ?? this.base.leaves,\n\t\t\twood: said?.wood ?? typed?.wood ?? this.base.wood,\n\t\t\thow: said?.how ?? typed?.how ?? this.base.how\n\t\t}\n\t}\n\n\t/** The air over the map now (`Air`), worked out again as the map's environment changes */\n\tairOf(world: World): Air {\n\t\tconst environment = world.state(mapInfo).environment\n\t\tif (this.air && this.air.of === environment) return this.air\n\t\t// the client's fields (`MapWind`), which the engine does not name: read as the grass's fire reads them\n\t\tconst wind = (environment as { wind?: { around?: number; strength?: number } } | undefined)?.wind\n\t\tconst strength = Math.min(1, Math.max(0, wind?.strength ?? 0))\n\t\tconst turn = (((wind?.around ?? 0) % 360) * Math.PI) / 180\n\t\t// downwind on the ground, as the screens have it: 0 north (towards -z), 90 east (+x)\n\t\treturn (this.air = { of: environment, strength, x: strength ? sin(turn) : 0, z: strength ? -cos(turn) : 0 })\n\t}\n\n\t/** Whether something with a chance happens: by the world's numbers where it is neither sure nor never */\n\thappens(world: World, chance: number): boolean {\n\t\treturn chance >= 1 || (chance > 0 && world.rng.next() < chance)\n\t}\n\n\t/** How many ticks a stretch of seconds is: at least one */\n\tticks(world: World, seconds: number): number {\n\t\treturn Math.max(1, Math.round(seconds / world.dt))\n\t}\n\n\t/**\n\t * Sets a thing alight, as `setAlight` says: asked of the game (`burnStart`) at `chance`, once, rolled where it is not\n\t * sure, under the most that may burn; started (`start`). Whether it caught\n\t */\n\tlight(world: World, entity: Entity, cause: BurnCause, by: number, from: Entity | undefined, chance: number, options: LightOptions = {}): boolean {\n\t\tif (!entity.alive || isBurning(entity)) return false\n\t\tconst burns = this.burnsOf(world, entity)\n\t\tif (!burns) return false\n\t\tif (world.states.has(fireList) && world.state(fireList).ids.length >= this.maxBurning) return false\n\t\tif (world.hooks.has(burnStart)) {\n\t\t\tconst asked = world.hooks.run(burnStart, {\n\t\t\t\tentity,\n\t\t\t\tcause,\n\t\t\t\t...(from ? { from } : {}),\n\t\t\t\t...(by ? { by: world.entities.get(by) } : {}),\n\t\t\t\thow: options.how ?? burns.how,\n\t\t\t\tchance,\n\t\t\t\tcancelled: false\n\t\t\t})\n\t\t\tif (asked.cancelled) return false\n\t\t\tchance = held(asked.chance)\n\t\t}\n\t\tif (!this.happens(world, chance)) return false\n\t\treturn this.start(world, entity, cause, by, options)\n\t}\n\n\t/**\n\t * A thing catches, asked and rolled already (by `light`, or at a try of a spread or of the grass): set burning for\n\t * its time, under the most that may burn, and told (`burnStarted`). Into the list first, then marked (`onFire`):\n\t * what is marked is never outside the list, whatever throws (one listed and not marked is dropped at its next\n\t * turn). Whether it caught\n\t */\n\tstart(world: World, entity: Entity, cause: BurnCause, by: number, options: LightOptions = {}): boolean {\n\t\tif (!entity.alive || isBurning(entity)) return false\n\t\tconst burns = this.burnsOf(world, entity)\n\t\tif (!burns) return false\n\t\tconst list = world.state(fireList)\n\t\tif (list.ids.length >= this.maxBurning) return false\n\t\tconst how = options.how ?? burns.how\n\t\tconst { tick } = world\n\t\tconst length = this.ticks(world, options.seconds ?? burns.seconds)\n\t\t// lit again where it was put out: on from as far as it had burnt\n\t\tconst was = entity.get(onFire)\n\t\tconst done = was?.out !== undefined && was.ends > was.since ? Math.min(1, (was.out - was.since) / (was.ends - was.since)) : 0\n\t\tconst since = tick - Math.round(done * length)\n\t\tconst ends = Math.max(tick + 1, since + length)\n\t\tinsertId(list, entity.id, by, ends)\n\t\tentity.set(onFire, { how, since, ends })\n\t\tworld.events.emit(burnStarted, { entity: entity.id, cause, how, ...(by ? { by } : {}) })\n\t\treturn true\n\t}\n\n\t/** Puts out a thing that burns: it stands, charred as far as it burnt. Whether it burnt */\n\tputOut(world: World, entity: Entity): boolean {\n\t\tconst state = entity.get(onFire)\n\t\tif (!state || state.out !== undefined) return false\n\t\tentity.set(onFire, { ...state, out: world.tick })\n\t\tif (world.states.has(fireList)) removeId(world.state(fireList), entity.id)\n\t\tworld.events.emit(burnPutOut, { entity: entity.id })\n\t\treturn true\n\t}\n\n\t/**\n\t * A tick: what burns out burns down, what tries its neighbours this tick tries them (things, and the grass about it\n\t * once a second where the pack says), burning grass whose turn it is tries what stands beside it\n\t * (`FoliageFire.lights`), who stands by is hurt. What caught is set alight at the end, in order (things by their\n\t * ids, cells by layer and index), and tries nothing this tick: nothing lights within what lit it\n\t */\n\ttick(world: World, list: FireList | undefined, grass: GrassLink | undefined): void {\n\t\tconst { tick } = world\n\t\tconst spread = this.spread\n\t\tconst stride = spread ? this.ticks(world, spread.every) : 1\n\t\tconst look = this.ticks(world, LOOK_EVERY)\n\t\tconst tries = !!spread && spread.chance > 0\n\t\tconst scorch = this.ticks(world, SCORCH_EVERY)\n\t\tconst toGrass = grass?.toGrass.length ? grass : undefined\n\t\tconst fresh = this.fresh\n\t\tconst hurt = this.hurt\n\t\tconst caught = this.grassCaught\n\t\tfresh.length = 0\n\t\thurt.length = 0\n\t\tcaught.layers.length = caught.cells.length = caught.by.length = 0\n\t\tcaught.keys.clear()\n\t\tlet out: { entity: Entity; by: number }[] | undefined\n\t\tif (list?.ids.length) {\n\t\t\tconst { ids, by, ends } = list\n\t\t\tlet kept = 0\n\t\t\tfor (let i = 0; i < ids.length; i++) {\n\t\t\t\tconst id = ids[i]\n\t\t\t\tconst whose = by[i]\n\t\t\t\tconst end = ends[i]\n\t\t\t\t// looked up on its turns alone (to try those about it, and once a second to see it still stands and to try\n\t\t\t\t// the grass about it) and as it burns down: the rest of the ticks it is three numbers\n\t\t\t\tconst trying = tries && turnOf(id, stride) === tick % stride\n\t\t\t\tconst looking = turnOf(id, look) === tick % look\n\t\t\t\tif (end > tick && !trying && !looking) {\n\t\t\t\t\tids[kept] = id\n\t\t\t\t\tby[kept] = whose\n\t\t\t\t\tends[kept++] = end\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tconst entity = world.entities.get(id)\n\t\t\t\tconst state = entity?.get(onFire)\n\t\t\t\t// gone by other means (felled, killed, taken away), or put out: out of the list, as it is\n\t\t\t\tif (!entity || !entity.alive || !state || state.out !== undefined) continue\n\t\t\t\tif (end <= tick) {\n\t\t\t\t\t;(out ??= []).push({ entity, by: whose })\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tids[kept] = id\n\t\t\t\tby[kept] = whose\n\t\t\t\tends[kept++] = end\n\t\t\t\tif (trying && ids.length + fresh.length < this.maxBurning) this.tryAround(world, entity, whose, spread!)\n\t\t\t\tif (toGrass && looking) this.tryGrass(world, entity, whose, toGrass)\n\t\t\t}\n\t\t\tids.length = kept\n\t\t\tby.length = kept\n\t\t\tends.length = kept\n\t\t\t// who stands by what burns, each unit on its own turn\n\t\t\tif (this.damage && ids.length) this.scorch(world, list, scorch)\n\t\t}\n\t\t// the burning grass whose turn it is, at what stands beside it\n\t\tif (grass?.fromGrass) this.fromGrass(world, grass.fire, list?.ids.length ?? 0)\n\t\t// what caught this tick, in order of their ids, each once: set alight now, to try on from their next turn\n\t\tif (fresh.length) {\n\t\t\tfresh.sort((a, b) => a.entity.id - b.entity.id)\n\t\t\tlet last = -1\n\t\t\tfor (const each of fresh) {\n\t\t\t\tif (each.entity.id === last) continue\n\t\t\t\tlast = each.entity.id\n\t\t\t\tthis.start(world, each.entity, each.cause, each.by)\n\t\t\t}\n\t\t\tfresh.length = 0\n\t\t}\n\t\t// the grass that caught from what burns, by layer and cell: lit now, to try on from its next turn\n\t\tif (caught.cells.length) {\n\t\t\tgrass!.fire.lightCaught(world, caught.layers, caught.cells, caught.by)\n\t\t\tcaught.layers.length = caught.cells.length = caught.by.length = 0\n\t\t\tcaught.keys.clear()\n\t\t}\n\t\t// who stood by, hurt once a turn whatever burns about them, in order of their ids\n\t\tif (hurt.length) {\n\t\t\tconst amount = this.damage * scorch * world.dt\n\t\t\thurt.sort((a, b) => a.unit.id - b.unit.id)\n\t\t\tlet last = -1\n\t\t\tfor (const each of hurt) {\n\t\t\t\tconst { unit } = each\n\t\t\t\tif (unit.id === last || !unit.alive) continue\n\t\t\t\tlast = unit.id\n\t\t\t\tworld.damage(unit, amount, each.by ? world.entities.get(each.by) : undefined, { damageType: this.damageType, tags: ['fire'], how: 'burnt' })\n\t\t\t}\n\t\t\thurt.length = 0\n\t\t}\n\t\tif (out) for (const each of out) this.burnDown(world, each.entity, each.by)\n\t}\n\n\t/**\n\t * A burning thing's try at what burns within its reach (`BurningSpread`): each by the spread's chance, likelier\n\t * downwind and less upwind, asked of the game (`burnStart`, once a try) and rolled in order of their ids. Into the\n\t * tick's fresh\n\t */\n\ttryAround(world: World, entity: Entity, by: number, spread: Required<BurningSpread>): void {\n\t\tconst near = this.near\n\t\tnear.length = 0\n\t\tconst { x, z } = entity.pos\n\t\tfor (const other of world.spatial.queryStatic(x, z, spread.reach + entity.def.radius, this.found)) {\n\t\t\tif (other !== entity && other.alive && !other.hidden && !isBurning(other)) near.push(other)\n\t\t}\n\t\tif (!near.length) return\n\t\tnear.sort((a, b) => a.id - b.id)\n\t\tconst air = this.airOf(world)\n\t\tconst hooked = world.hooks.has(burnStart)\n\t\tfor (const other of near) {\n\t\t\tif (edgeDistance(entity, other) > spread.reach) continue\n\t\t\tconst burns = this.burnsOf(world, other)\n\t\t\tif (!burns) continue\n\t\t\tlet chance = spread.chance\n\t\t\tif (air.strength && spread.wind) {\n\t\t\t\tconst dx = other.pos.x - x\n\t\t\t\tconst dz = other.pos.z - z\n\t\t\t\tconst far = Math.sqrt(dx * dx + dz * dz)\n\t\t\t\tif (far > 0) chance *= exp((WIND * spread.wind * air.strength * (dx * air.x + dz * air.z)) / far)\n\t\t\t}\n\t\t\tchance = Math.min(1, chance)\n\t\t\tif (hooked) {\n\t\t\t\tconst asked = world.hooks.run(burnStart, {\n\t\t\t\t\tentity: other,\n\t\t\t\t\tcause: 'spread',\n\t\t\t\t\tfrom: entity,\n\t\t\t\t\t...(by ? { by: world.entities.get(by) } : {}),\n\t\t\t\t\thow: burns.how,\n\t\t\t\t\tchance,\n\t\t\t\t\tcancelled: false\n\t\t\t\t})\n\t\t\t\tif (asked.cancelled) continue\n\t\t\t\tchance = held(asked.chance)\n\t\t\t}\n\t\t\tif (this.happens(world, chance)) this.fresh.push({ entity: other, by, cause: 'spread' })\n\t\t}\n\t\tnear.length = 0\n\t}\n\n\t/**\n\t * A burning thing's try at the grass under it and one cell round (`lightsFoliage`), once a second: each cell of the\n\t * layers it lights that may catch, by the grass's chance (`FoliageFireRules.chanceFrom`: its style, the wet, the\n\t * wind by this pack's `wind`), asked of the game (`foliageIgnite`, `burning`, once a try) and rolled, in order of\n\t * the layers and the cells. Into the tick's grass caught, as many as the grass has room for\n\t */\n\ttryGrass(world: World, entity: Entity, by: number, link: GrassLink): void {\n\t\tconst { fire, toGrass } = link\n\t\tconst caught = this.grassCaught\n\t\tlet room = fire.room(world) - caught.cells.length\n\t\tif (room <= 0) return\n\t\tconst { width, depth } = world.terrain\n\t\tconst size = width * depth\n\t\tconst { x, z, hw, hd } = entity.rect\n\t\tconst weight = this.spread?.wind ?? 1\n\t\tfor (const l of toGrass)\n\t\t\tfor (let cz = Math.max(Math.floor(z - hd) - 1, 0); cz <= Math.min(Math.ceil(z + hd), depth - 1); cz++)\n\t\t\t\tfor (let cx = Math.max(Math.floor(x - hw) - 1, 0); cx <= Math.min(Math.ceil(x + hw), width - 1); cx++) {\n\t\t\t\t\tconst cell = cz * width + cx\n\t\t\t\t\tconst key = l * size + cell\n\t\t\t\t\tif (caught.keys.has(key)) continue\n\t\t\t\t\tconst chance = fire.chanceFrom(world, l, cell, entity.pos.x, entity.pos.z, weight)\n\t\t\t\t\tif (!(chance > 0) || !this.happens(world, fire.ask(world, l, cell, 'burning', undefined, by, chance, entity))) continue\n\t\t\t\t\tcaught.keys.add(key)\n\t\t\t\t\tcaught.layers.push(l)\n\t\t\t\t\tcaught.cells.push(cell)\n\t\t\t\t\tcaught.by.push(by)\n\t\t\t\t\tif (--room <= 0) return\n\t\t\t\t}\n\t}\n\n\t/**\n\t * The burning grass whose turn it is this tick (`FoliageFire.every`), at what burns and stands on its cell or one\n\t * next to it (`FoliageFire.lights`): each by `FROM_GRASS` and the cell's heat, likelier downwind (by the grass's\n\t * `wind`), asked of the game (`burnStart`, `foliage`, once a try) and rolled, cell by cell in order and what stands\n\t * by each in order of their ids. Into the tick's fresh, under the most that may burn\n\t */\n\tfromGrass(world: World, fire: FoliageFireRules, burning: number): void {\n\t\tif (burning + this.fresh.length >= this.maxBurning) return\n\t\tconst { width } = world.terrain\n\t\tconst { grid } = world\n\t\tconst air = this.airOf(world)\n\t\tconst weight = fire.wind\n\t\tconst hooked = world.hooks.has(burnStart)\n\t\tconst near = this.near\n\t\tfire.eachTrying(world, (l, cell, by, heat) => {\n\t\t\tif (burning + this.fresh.length >= this.maxBurning) return\n\t\t\tconst cx = cell % width\n\t\t\tconst cz = (cell - cx) / width\n\t\t\tconst x = cx + 0.5\n\t\t\tconst z = cz + 0.5\n\t\t\tnear.length = 0\n\t\t\t// what stands on the cell or on one next to it: whatever stands (all but what moves) holds the cells of its\n\t\t\t// footprint (`world.grid`), so the nine cells' holders, each once; nothing looked up where none is\n\t\t\tfor (let dz = -1; dz <= 1; dz++)\n\t\t\t\tfor (let dx = -1; dx <= 1; dx++) {\n\t\t\t\t\tconst id = grid.occupantAt(cx + dx, cz + dz)\n\t\t\t\t\tif (id <= 0 || near.some((each) => each.id === id)) continue\n\t\t\t\t\tconst other = world.entities.get(id)\n\t\t\t\t\tif (other && other.alive && !other.hidden && !isBurning(other)) near.push(other)\n\t\t\t\t}\n\t\t\tif (!near.length) return\n\t\t\tnear.sort((a, b) => a.id - b.id)\n\t\t\tfor (const other of near) {\n\t\t\t\tconst burns = this.burnsOf(world, other)\n\t\t\t\tif (!burns) continue\n\t\t\t\tlet chance = FROM_GRASS * heat\n\t\t\t\tif (air.strength && weight) {\n\t\t\t\t\tconst dx = other.pos.x - x\n\t\t\t\t\tconst dz = other.pos.z - z\n\t\t\t\t\tconst far = Math.sqrt(dx * dx + dz * dz)\n\t\t\t\t\tif (far > 0) chance *= exp((WIND * weight * air.strength * (dx * air.x + dz * air.z)) / far)\n\t\t\t\t}\n\t\t\t\tchance = Math.min(1, chance)\n\t\t\t\tif (hooked) {\n\t\t\t\t\tconst asked = world.hooks.run(burnStart, {\n\t\t\t\t\t\tentity: other,\n\t\t\t\t\t\tcause: 'foliage',\n\t\t\t\t\t\tlayer: fire.layers[l],\n\t\t\t\t\t\tcell,\n\t\t\t\t\t\t...(by ? { by: world.entities.get(by) } : {}),\n\t\t\t\t\t\thow: burns.how,\n\t\t\t\t\t\tchance,\n\t\t\t\t\t\tcancelled: false\n\t\t\t\t\t})\n\t\t\t\t\tif (asked.cancelled) continue\n\t\t\t\t\tchance = held(asked.chance)\n\t\t\t\t}\n\t\t\t\tif (this.happens(world, chance)) this.fresh.push({ entity: other, by, cause: 'foliage' })\n\t\t\t}\n\t\t\tnear.length = 0\n\t\t})\n\t}\n\n\t/**\n\t * Who stands by what burns, into the tick's hurt: units on the ground, each on its turn (once in `stride` ticks, by a\n\t * hash of its id), looked at for something burning within `damageReach` of it; hurt once, by whoever lit the first\n\t * of those in order of their ids. Done from the units, of which there are fewer than trees in a forest fire\n\t */\n\tscorch(world: World, list: FireList, stride: number): void {\n\t\tconst turn = world.tick % stride\n\t\tconst reach = this.damageReach\n\t\tfor (const unit of world.units.values()) {\n\t\t\tif (turnOf(unit.id, stride) !== turn) continue\n\t\t\tif (!unit.alive || unit.hidden || unit.flying || unit.def.kind !== 'unit' || unit.def.footprint) continue\n\t\t\tlet first: Entity | undefined\n\t\t\tfor (const thing of world.spatial.queryStatic(unit.pos.x, unit.pos.z, reach + unit.def.radius, this.found)) {\n\t\t\t\tif (thing === unit || !isBurning(thing) || (first && first.id < thing.id) || edgeDistance(thing, unit) > reach) continue\n\t\t\t\tfirst = thing\n\t\t\t}\n\t\t\tif (!first) continue\n\t\t\tconst at = placeOf(list.ids, first.id)\n\t\t\tthis.hurt.push({ unit, by: list.ids[at] === first.id ? list.by[at] : 0 })\n\t\t}\n\t}\n\n\t/**\n\t * A thing burnt down: told (`burnt`), killed as its `leaves` says (`felled`, or `burnt`, its death's `how` the kind of\n\t * burning), and what it leaves put down where it stood, with its wood where it keeps it\n\t */\n\tburnDown(world: World, entity: Entity, whose: number): void {\n\t\tconst state = entity.get(onFire)\n\t\tif (!entity.alive || !state) return\n\t\tconst burns = this.burnsOf(world, entity) ?? this.base\n\t\tconst by = whose ? world.entities.get(whose) : undefined\n\t\tconst at = { x: entity.pos.x, z: entity.pos.z }\n\t\tconst { owner } = entity\n\t\tconst wood = entity.get(deposit)?.amount\n\t\tconst leaves = burns.leaves\n\t\tthis.ending = { entity, how: state.how }\n\t\ttry {\n\t\t\tworld.kill(entity, by, false, leaves === 'felled' ? 'felled' : 'burnt')\n\t\t} finally {\n\t\t\tthis.ending = undefined\n\t\t}\n\t\tlet left: Entity | undefined\n\t\tif (leaves !== 'felled' && leaves !== 'nothing' && world.registry.units.has(leaves)) {\n\t\t\tleft = world.spawn(leaves, owner, at)\n\t\t\tconst holds = left.get(deposit)\n\t\t\tif (burns.wood && holds && wood !== undefined) holds.amount = wood\n\t\t}\n\t\tworld.events.emit(burnt, { entity: entity.id, how: state.how, ...(whose ? { by: whose } : {}), ...(left ? { left: left.id } : {}) })\n\t}\n}\n\n/** What `setAlight` is told besides who lit it: another kind of burning, another time to burn */\ninterface LightOptions {\n\t/** What kind of burning it is (`BurnsDef.how`): its own when left out */\n\thow?: string\n\t/** Seconds it burns: its own when left out */\n\tseconds?: number\n}\n\n/** The link to the grass's fire of a game (`lightsFoliage`, `FoliageFire.lights`), where it has grass that burns */\ninterface GrassLink {\n\t/** The grass's fire */\n\tfire: FoliageFireRules\n\t/** The layers of it, by their index, that what burns lights (`lightsFoliage`): none for none */\n\ttoGrass: number[]\n\t/** Whether burning grass lights what burns beside it (`FoliageFire.lights`) */\n\tfromGrass: boolean\n}\n\n/** A chance a handler of `burnStart` left, held to 0 to 1 */\nconst held = (chance: number): number => Math.min(1, Math.max(0, chance || 0))\n\n/**\n * Which tick of every `stride` a burning thing tries those about it on: of a hash of its id, so that a forest's trees\n * take their turns spread over the ticks\n */\nconst turnOf = (id: number, stride: number): number => (Math.imul(id, 0x9e3779b1) >>> 16) % stride\n\n/** Where an id is, or would go, in a list of ids in order */\nfunction placeOf(ids: readonly number[], id: number): number {\n\tlet low = 0\n\tlet high = ids.length\n\twhile (low < high) {\n\t\tconst middle = (low + high) >> 1\n\t\tif (ids[middle] < id) low = middle + 1\n\t\telse high = middle\n\t}\n\treturn low\n}\n\n/** A thing put into what burns, in order of the ids, once, with who lit it and when it burns down */\nfunction insertId(list: FireList, id: number, by: number, ends: number): void {\n\tconst at = placeOf(list.ids, id)\n\tif (list.ids[at] === id) return\n\tlist.ids.splice(at, 0, id)\n\tlist.by.splice(at, 0, by)\n\tlist.ends.splice(at, 0, ends)\n}\n\n/** A thing taken out of what burns, where it is there */\nfunction removeId(list: FireList, id: number): void {\n\tconst at = placeOf(list.ids, id)\n\tif (list.ids[at] !== id) return\n\tlist.ids.splice(at, 1)\n\tlist.by.splice(at, 1)\n\tlist.ends.splice(at, 1)\n}\n\n/** The pack's rules of a world's game: none where it has no burning pack. `what` names the call that asks, which throws then */\nfunction rulesOf(world: World, what: string): BurningRules {\n\tconst pack = world.registry.assembly?.rules.packs?.find((each) => each.id === BURNING) as BurningPack | undefined\n\tif (!pack) throw new Error(`${what}: the game has no burning pack (burningPack)`)\n\treturn (pack[RULES] ??= new BurningRules(pack.options as BurningOptions))\n}\n\n/** The pack's rules of a world's game, where it has the pack */\nfunction rulesIfAny(world: World): BurningRules | undefined {\n\tconst pack = world.registry.assembly?.rules.packs?.find((each) => each.id === BURNING) as BurningPack | undefined\n\treturn pack && (pack[RULES] ??= new BurningRules(pack.options as BurningOptions))\n}\n\n/**\n * Sets a thing alight: it burns for its time (`BurnsDef.seconds`), then burns down and leaves what it leaves\n * (`BurnsDef.leaves`). `by`: who lit it, whom its damage and its kill are by; `how`: another kind of burning than its\n * own; `seconds`: another time. The game is asked first (`burnStart`). One that burns already, does not burn, or is\n * past the most that may burn at once (`BurningOptions.maxBurning`) does not catch. One put out before goes on from\n * as far as it had burnt. Whether it caught\n *\n * @beta\n */\nexport function setAlight(world: World, entity: Entity, options: { by?: Entity; how?: string; seconds?: number } = {}): boolean {\n\tconst { by, ...rest } = options\n\treturn rulesOf(world, 'setAlight').light(world, entity, 'light', by?.id ?? 0, undefined, 1, rest)\n}\n\n/**\n * Puts out a thing that burns: it stands, charred as far as it burnt, and may be set alight again. Whether it burnt\n *\n * @beta\n */\nexport function putOut(world: World, entity: Entity): boolean {\n\treturn rulesOf(world, 'putOut').putOut(world, entity)\n}\n\n/**\n * Whether a thing burns now: not one put out, nor one burnt down (or killed by other means while it burnt)\n *\n * @beta\n */\nexport function isBurning(entity: Entity): boolean {\n\tif (!entity.alive) return false\n\tconst state = entity.get(onFire)\n\treturn !!state && state.out === undefined\n}\n\n/**\n * What the rules know of a thing that burns, or burnt and was put out (`burningOf`)\n *\n * @beta\n */\nexport interface BurningInfo {\n\t/** Whether it burns now (`isBurning`): false for one put out, or burnt down */\n\tburning: boolean\n\t/** What kind of burning it is (`BurnsDef.how`) */\n\thow: string\n\t/** How far it has burnt, 0 (just caught) to 1 (about to burn down) */\n\tshare: number\n\t/** Seconds it still burns: 0 for one put out, or burnt down */\n\tleft: number\n\t/** Who set alight the fire it is of, where someone did */\n\tby?: EntityId\n}\n\n/**\n * What the rules know of a thing that burns or burnt (`BurningInfo`): none for one that never caught\n *\n * @beta\n */\nexport function burningOf(world: World, entity: Entity): BurningInfo | undefined {\n\tconst state = entity.get(onFire)\n\tif (!state) return undefined\n\tconst now = state.out ?? world.tick\n\tconst length = Math.max(1, state.ends - state.since)\n\tconst burning = isBurning(entity)\n\tconst info: BurningInfo = {\n\t\tburning,\n\t\thow: state.how,\n\t\tshare: Math.min(1, Math.max(0, (now - state.since) / length)),\n\t\tleft: burning ? Math.max(0, state.ends - world.tick) * world.dt : 0\n\t}\n\tconst list = world.states.has(fireList) ? world.state(fireList) : undefined\n\tconst at = list && state.out === undefined ? placeOf(list.ids, entity.id) : -1\n\tif (list && at >= 0 && list.ids[at] === entity.id && list.by[at]) info.by = list.by[at]\n\treturn info\n}\n\n/** What `burningThings` gives where nothing burns */\nconst NONE: readonly EntityId[] = Object.freeze([])\n\n/**\n * The ids of what burns now, in order: for a game's rules and its computer players (one killed by other means, a\n * catapult's blast, is taken out within a second). Not to be kept or changed: the pack's own list\n *\n * @beta\n */\nexport function burningThings(world: World): readonly EntityId[] {\n\trulesOf(world, 'burningThings')\n\treturn world.states.has(fireList) ? world.state(fireList).ids : NONE\n}\n\n/**\n * Whether a thing burns at all in a world's game (`BurningOptions.burns`, `UnitTypeDef.burns`, trees): false in a game\n * without the burning pack\n *\n * @beta\n */\nexport function canBurn(world: World, entity: Entity): boolean {\n\treturn !!rulesIfAny(world)?.burnsOf(world, entity)\n}\n\n/**\n * The `burn` effect (`EffectTypes.burn`): sets alight what burns where it lands, by the caster (`light`), or puts it\n * out (`putOut`). Over its area (`radius`, `shape`), else the unit it was cast on, else what stands where it landed;\n * of those, what its fields of whom say (`affects`, `kinds`, `tags`, `layers`, `ifBuff`, `only`, `where`, `sort`,\n * `limit`: everything that burns, trees and what is the neutral player's among it, when it says none), and what the\n * game lets it reach (`beforeEffect`)\n */\nconst burnEffect = /* @__PURE__ */ defineEffect({\n\ttype: 'burn',\n\trun(context, effect) {\n\t\tconst { world, caster, target, point } = context\n\t\tconst rules = rulesOf(world, 'burn effect')\n\t\tconst area = effectArea(context, effect)\n\t\tlet things: Entity[]\n\t\tif (area) {\n\t\t\tconst reach = areaReach(area)\n\t\t\tthings = world.spatial\n\t\t\t\t.query(area.x, area.z, reach, [])\n\t\t\t\t.filter((thing) => thing.alive && !thing.hidden && inArea(area, thing.pos, thing.def.radius))\n\t\t} else if (target) things = [target]\n\t\telse\n\t\t\tthings = world.spatial.queryStatic(point.x, point.z, 0.5, []).filter((thing) => {\n\t\t\t\tconst { x, z, hw, hd } = thing.rect\n\t\t\t\treturn thing.alive && Math.abs(point.x - x) < hw && Math.abs(point.z - z) < hd\n\t\t\t})\n\t\t// what it acts on at all (what burns, or burns now to be put out), then what its fields of whom say of them\n\t\tconst putting = effect.act === 'putOut'\n\t\tthings = things.filter((thing) => (putting ? isBurning(thing) : !!rules.burnsOf(world, thing)))\n\t\tthings = effectFilter(context, effect, things, 'all').sort((a, b) => a.id - b.id)\n\t\tfor (const thing of things) {\n\t\t\tif (putting) rules.putOut(world, thing)\n\t\t\telse\n\t\t\t\trules.light(world, thing, 'light', caster.id, undefined, 1, {\n\t\t\t\t\t...(effect.how !== undefined ? { how: effect.how } : {}),\n\t\t\t\t\t...(effect.seconds !== undefined ? { seconds: effect.seconds } : {})\n\t\t\t\t})\n\t\t}\n\t},\n\tfields: [\n\t\t{ path: 'act', kind: 'choice', options: ['light', 'putOut'], hint: 'What it does to what burns where it lands: sets it alight, or puts it out' },\n\t\t{ path: 'how', kind: 'text', hint: 'What kind of burning it sets off, for the screen and the death: its own (burnt) when left out' },\n\t\t{ path: 'seconds', kind: 'number', min: 0, hint: 'Seconds what it sets alight burns: its own when left out' }\n\t]\n})\n\n/** A death of a thing burnt down given its kind of burning (`DeathEvent.how`): what its look's `death.how` goes by */\nconst burntDeath = /* @__PURE__ */ defineHook({\n\thook: 'death',\n\tid: 'burning',\n\trun(world, death) {\n\t\tconst ending = rulesIfAny(world)?.ending\n\t\tif (ending && ending.entity === death.entity) death.how = ending.how\n\t}\n})\n\n/**\n * Things that burn (`BurningOptions`): trees by default (what can be felled), any type that says `burns`\n * (`UnitTypeDef.burns`: a wooden wall, a hut), or what the game decides in code. Set alight by `setAlight`, an ability\n * (`{ type: 'burn', act: 'light' }`), the grass's fire (`FoliageFire.lights`) or one another (`spread`), a thing burns\n * for its seconds and burns down: felled, burnt away, or leaving a thing of its own (a charred stump), with or\n * without its wood. Put out with `putOut`. Its look says what plays on it while it burns (`UnitLook.burning`: fire\n * by default, or a game's own effect for its own kind of burning, `how`). Off unless a game turns it on:\n *\n *     export const rules = { ...myGame, packs: [burningPack({ spread: { chance: 0.2 }, damage: 10 })] }\n *\n * What burns is not woken (`world.wake`): a forest costs nothing a tick while nothing in it burns\n *\n * @beta\n */\nexport function burningPack(options: BurningOptions = {}): GamePack {\n\tconst rules = new BurningRules(options)\n\tconst pack: BurningPack = {\n\t\tid: BURNING,\n\t\toptions,\n\t\tsystems: [rules.system],\n\t\thooks: [burntDeath],\n\t\tcomponents: [onFire, fireList],\n\t\tevents: [burnStarted, burnt, burnPutOut],\n\t\teffects: [burnEffect],\n\t\t[RULES]: rules\n\t}\n\treturn pack\n}\n"],"mappings":"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"}

package/dist/bytes.js

@@ -0,0 +1,21 @@
+//#region src/bytes.ts
+/** Bytes as text that survives JSON: base64 */
+function packBytes(bytes) {
+	let text = "";
+	for (let i = 0; i < bytes.length; i += 32768) text += String.fromCharCode(...bytes.subarray(i, i + 32768));
+	return btoa(text);
+}
+/** Bytes back from `packBytes`. Undefined when there are not `length` of them */
+function unpackBytes(text, length) {
+	const binary = atob(text);
+	if (binary.length !== length) return void 0;
+	const bytes = new Uint8Array(length);
+	for (let i = 0; i < length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+/** The bytes of numbers kept in a typed array, as text, see `packBytes` */
+var packArray = (array) => packBytes(new Uint8Array(array.buffer, array.byteOffset, array.byteLength));
+//#endregion
+export { packArray, packBytes, unpackBytes };
+
+//# sourceMappingURL=bytes.js.map

package/dist/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","names":[],"sources":["../src/bytes.ts"],"sourcesContent":["/** Bytes as text that survives JSON: base64 */\nexport function packBytes(bytes: Uint8Array): string {\n\tlet text = ''\n\tfor (let i = 0; i < bytes.length; i += 0x8000) text += String.fromCharCode(...bytes.subarray(i, i + 0x8000))\n\treturn btoa(text)\n}\n\n/** Bytes back from `packBytes`. Undefined when there are not `length` of them */\nexport function unpackBytes(text: string, length: number): Uint8Array | undefined {\n\tconst binary = atob(text)\n\tif (binary.length !== length) return undefined\n\tconst bytes = new Uint8Array(length)\n\tfor (let i = 0; i < length; i++) bytes[i] = binary.charCodeAt(i)\n\treturn bytes\n}\n\n/** The bytes of numbers kept in a typed array, as text, see `packBytes` */\nexport const packArray = (array: Float32Array | Int32Array | Uint8Array) =>\n\tpackBytes(new Uint8Array(array.buffer, array.byteOffset, array.byteLength))\n"],"mappings":";;AACA,SAAgB,UAAU,OAA2B;CACpD,IAAI,OAAO;CACX,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,OAAQ,QAAQ,OAAO,aAAa,GAAG,MAAM,SAAS,GAAG,IAAI,KAAM,CAAC;CAC3G,OAAO,KAAK,IAAI;AACjB;;AAGA,SAAgB,YAAY,MAAc,QAAwC;CACjF,MAAM,SAAS,KAAK,IAAI;CACxB,IAAI,OAAO,WAAW,QAAQ,OAAO,KAAA;CACrC,MAAM,QAAQ,IAAI,WAAW,MAAM;CACnC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,MAAM,KAAK,OAAO,WAAW,CAAC;CAC/D,OAAO;AACR;;AAGA,IAAa,aAAa,UACzB,UAAU,IAAI,WAAW,MAAM,QAAQ,MAAM,YAAY,MAAM,UAAU,CAAC"}

package/dist/callings.d.ts

@@ -0,0 +1,71 @@
+import type { UnitTypeDef } from './defs';
+import type { Rules } from './game';
+import type { Registry } from './registry';
+/**
+ * One calling a hero may have (`HeroDef.callings`): what it is called and what it plays as, with its picture and
+ * colour for the HUD
+ *
+ * @beta
+ */
+export interface CallingDef {
+    /** Its id, what a hero's `callings` and an item's `suits` name it by: `vanguard` */
+    id: string;
+    /** What the player sees it called: Vanguard */
+    name: string;
+    /** What a hero of it does, in a few words, for a tooltip */
+    description?: string;
+    /**
+     * Its picture: an address of an image, or the name of a glyph the HUD draws (`registerGlyph`). The HUD draws the
+     * engine's own callings by their ids; the first letter of the name for one with neither
+     */
+    icon?: string;
+    /** The colour it is shown in, a CSS colour: the HUD's accent when left out */
+    color?: string;
+}
+/**
+ * How strong a hero is in a calling, from 1 (a little of it) to 3 (what it is above all)
+ *
+ * @beta
+ */
+export type CallingStrength = 1 | 2 | 3;
+/**
+ * The callings the engine brings, those of a classic hero arena game under names of its own. What a game with the
+ * heroes pack has when it says none (`HeroSettings.callings`); a game takes them, some of them, changes them or gives
+ * its own: `heroesPack({ callings: [...defaultCallings().filter((each) => each.id !== 'roamer'), myOwn] })`. A new list
+ * each time it is asked, to change as a game likes
+ *
+ * @beta
+ */
+export declare function defaultCallings(): CallingDef[];
+/**
+ * The callings of a game: those of its heroes pack (`heroesPack({ callings })`), what the rules say of heroes
+ * (`RuleSettings.heroes.callings`), or the engine's own (`defaultCallings`). Asked of a registry, the game's settings
+ * as they came out; of rules, what they say
+ *
+ * @beta
+ */
+export declare function callingsOf(game: Registry | Pick<Rules, 'packs' | 'settings'>): readonly CallingDef[];
+/**
+ * A hero's callings, strongest first (in the order its type gives those of one strength), each with its definition:
+ * one the game has no definition of is named by its id. None for a unit type that is no hero or says none
+ *
+ * @beta
+ */
+export declare function heroCallings(game: Registry | Pick<Rules, 'packs' | 'settings'>, def: Pick<UnitTypeDef, 'hero'>): {
+    calling: CallingDef;
+    strength: CallingStrength;
+}[];
+/**
+ * How strong a hero's type is in a calling: 0 for one it does not have
+ *
+ * @beta
+ */
+export declare const callingStrength: (def: Pick<UnitTypeDef, 'hero'>, calling: string) => number;
+/**
+ * The rules with their callings in the place of what they were (`callingsOf`): the heroes pack's, made again with them
+ * (its own options, rules and parts kept), or the rules' heroes settings for a game without the pack. What a
+ * `data.json`'s `callings` (`GameData.callings`) and the Data panel's Callings come to. The rules given are not changed
+ *
+ * @beta
+ */
+export declare function withCallings(rules: Rules, callings: readonly CallingDef[]): Rules;

package/dist/callings.js

@@ -0,0 +1,157 @@
+//#region src/callings.ts
+/**
+* The callings the engine brings, those of a classic hero arena game under names of its own. What a game with the
+* heroes pack has when it says none (`HeroSettings.callings`); a game takes them, some of them, changes them or gives
+* its own: `heroesPack({ callings: [...defaultCallings().filter((each) => each.id !== 'roamer'), myOwn] })`. A new list
+* each time it is asked, to change as a game likes
+*
+* @beta
+*/
+function defaultCallings() {
+	return [
+		{
+			id: "vanguard",
+			name: "Vanguard",
+			description: "Starts fights and takes the hits",
+			icon: "vanguard",
+			color: "#c9a66b"
+		},
+		{
+			id: "keeper",
+			name: "Keeper",
+			description: "Heals, shields and saves allies",
+			icon: "keeper",
+			color: "#8fd694"
+		},
+		{
+			id: "binder",
+			name: "Binder",
+			description: "Stuns, roots and holds enemies down",
+			icon: "binder",
+			color: "#7fb4e6"
+		},
+		{
+			id: "reaver",
+			name: "Reaver",
+			description: "Lasting damage up close, and drains",
+			icon: "reaver",
+			color: "#d9734e"
+		},
+		{
+			id: "stalker",
+			name: "Stalker",
+			description: "Picks off one target and gets out",
+			icon: "stalker",
+			color: "#b07ad9"
+		},
+		{
+			id: "ranger",
+			name: "Ranger",
+			description: "Steady damage from range, stronger late",
+			icon: "ranger",
+			color: "#e6c84e"
+		},
+		{
+			id: "arcanist",
+			name: "Arcanist",
+			description: "Bursts and areas of damage with spells",
+			icon: "arcanist",
+			color: "#6fa0ff"
+		},
+		{
+			id: "roamer",
+			name: "Roamer",
+			description: "Clears camps and moves about the map",
+			icon: "roamer",
+			color: "#6cbf7a"
+		}
+	];
+}
+/**
+* The callings of a game: those of its heroes pack (`heroesPack({ callings })`), what the rules say of heroes
+* (`RuleSettings.heroes.callings`), or the engine's own (`defaultCallings`). Asked of a registry, the game's settings
+* as they came out; of rules, what they say
+*
+* @beta
+*/
+function callingsOf(game) {
+	if ("kinds" in game) return game.settings.heroes.callings;
+	const pack = game.packs?.find((each) => each.id === "core.heroes");
+	const said = (game.settings?.heroes)?.callings;
+	return pack?.options?.callings ?? said ?? pack?.callings ?? defaultCallings();
+}
+/**
+* A hero's callings, strongest first (in the order its type gives those of one strength), each with its definition:
+* one the game has no definition of is named by its id. None for a unit type that is no hero or says none
+*
+* @beta
+*/
+function heroCallings(game, def) {
+	const said = def.hero?.callings;
+	if (!said) return [];
+	const known = callingsOf(game);
+	return Object.entries(said).map(([id, strength]) => ({
+		calling: known.find((each) => each.id === id) ?? {
+			id,
+			name: id
+		},
+		strength: clampStrength(strength)
+	})).sort((a, b) => b.strength - a.strength);
+}
+/** A strength as a calling has it, 1 to 3, whatever a data file said */
+var clampStrength = (strength) => Math.min(Math.max(Math.round(strength), 1), 3);
+/**
+* How strong a hero's type is in a calling: 0 for one it does not have
+*
+* @beta
+*/
+var callingStrength = (def, calling) => def.hero?.callings?.[calling] ?? 0;
+/**
+* The rules with their callings in the place of what they were (`callingsOf`): the heroes pack's, made again with them
+* (its own options, rules and parts kept), or the rules' heroes settings for a game without the pack. What a
+* `data.json`'s `callings` (`GameData.callings`) and the Data panel's Callings come to. The rules given are not changed
+*
+* @beta
+*/
+function withCallings(rules, callings) {
+	const list = [...callings];
+	const packs = rules.packs ?? [];
+	const pack = packs.find((each) => each.id === "core.heroes");
+	if (!pack) return {
+		...rules,
+		settings: {
+			...rules.settings,
+			heroes: {
+				...rules.settings?.heroes,
+				callings: list
+			}
+		}
+	};
+	const own = pack.settings;
+	const remade = {
+		...pack,
+		options: {
+			...pack.options,
+			callings: list
+		},
+		callings: list,
+		settings: (settings) => {
+			const said = own?.call(pack, settings) ?? {};
+			return {
+				...said,
+				heroes: {
+					...said.heroes,
+					callings: list
+				}
+			};
+		}
+	};
+	return {
+		...rules,
+		packs: packs.map((each) => each === pack ? remade : each)
+	};
+}
+//#endregion
+export { callingStrength, callingsOf, defaultCallings, heroCallings, withCallings };
+
+//# sourceMappingURL=callings.js.map

package/dist/callings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callings.js","names":[],"sources":["../src/callings.ts"],"sourcesContent":["import type { UnitTypeDef } from './defs'\nimport type { Rules } from './game'\nimport type { Registry } from './registry'\n\n/*\n * Callings (items-and-spells plan, phase 4): what a hero is good at, as Dota 2 has its roles. A hero is not boxed into\n * one: it has several, each with a strength from 1 to 3 (`HeroDef.callings`: Duskblade is Stalker 3 and Roamer 2).\n * They lock nothing; they guide: the shop's suggestions and filters, the tooltips, a computer player's picks. They are\n * data, so a game renames them, adds to them or replaces them (`heroesPack({ callings })`)\n */\n\n/**\n * One calling a hero may have (`HeroDef.callings`): what it is called and what it plays as, with its picture and\n * colour for the HUD\n *\n * @beta\n */\nexport interface CallingDef {\n\t/** Its id, what a hero's `callings` and an item's `suits` name it by: `vanguard` */\n\tid: string\n\t/** What the player sees it called: Vanguard */\n\tname: string\n\t/** What a hero of it does, in a few words, for a tooltip */\n\tdescription?: string\n\t/**\n\t * Its picture: an address of an image, or the name of a glyph the HUD draws (`registerGlyph`). The HUD draws the\n\t * engine's own callings by their ids; the first letter of the name for one with neither\n\t */\n\ticon?: string\n\t/** The colour it is shown in, a CSS colour: the HUD's accent when left out */\n\tcolor?: string\n}\n\n/**\n * How strong a hero is in a calling, from 1 (a little of it) to 3 (what it is above all)\n *\n * @beta\n */\nexport type CallingStrength = 1 | 2 | 3\n\n/**\n * The callings the engine brings, those of a classic hero arena game under names of its own. What a game with the\n * heroes pack has when it says none (`HeroSettings.callings`); a game takes them, some of them, changes them or gives\n * its own: `heroesPack({ callings: [...defaultCallings().filter((each) => each.id !== 'roamer'), myOwn] })`. A new list\n * each time it is asked, to change as a game likes\n *\n * @beta\n */\nexport function defaultCallings(): CallingDef[] {\n\treturn [\n\t\t{ id: 'vanguard', name: 'Vanguard', description: 'Starts fights and takes the hits', icon: 'vanguard', color: '#c9a66b' },\n\t\t{ id: 'keeper', name: 'Keeper', description: 'Heals, shields and saves allies', icon: 'keeper', color: '#8fd694' },\n\t\t{ id: 'binder', name: 'Binder', description: 'Stuns, roots and holds enemies down', icon: 'binder', color: '#7fb4e6' },\n\t\t{ id: 'reaver', name: 'Reaver', description: 'Lasting damage up close, and drains', icon: 'reaver', color: '#d9734e' },\n\t\t{ id: 'stalker', name: 'Stalker', description: 'Picks off one target and gets out', icon: 'stalker', color: '#b07ad9' },\n\t\t{ id: 'ranger', name: 'Ranger', description: 'Steady damage from range, stronger late', icon: 'ranger', color: '#e6c84e' },\n\t\t{ id: 'arcanist', name: 'Arcanist', description: 'Bursts and areas of damage with spells', icon: 'arcanist', color: '#6fa0ff' },\n\t\t{ id: 'roamer', name: 'Roamer', description: 'Clears camps and moves about the map', icon: 'roamer', color: '#6cbf7a' }\n\t]\n}\n\n/**\n * The callings of a game: those of its heroes pack (`heroesPack({ callings })`), what the rules say of heroes\n * (`RuleSettings.heroes.callings`), or the engine's own (`defaultCallings`). Asked of a registry, the game's settings\n * as they came out; of rules, what they say\n *\n * @beta\n */\nexport function callingsOf(game: Registry | Pick<Rules, 'packs' | 'settings'>): readonly CallingDef[] {\n\tif ('kinds' in game) return game.settings.heroes.callings\n\tconst pack = game.packs?.find((each) => each.id === 'core.heroes') as { callings?: readonly CallingDef[]; options?: { callings?: readonly CallingDef[] } } | undefined\n\tconst said = (game.settings?.heroes as { callings?: readonly CallingDef[] } | undefined)?.callings\n\treturn pack?.options?.callings ?? said ?? pack?.callings ?? defaultCallings()\n}\n\n/**\n * A hero's callings, strongest first (in the order its type gives those of one strength), each with its definition:\n * one the game has no definition of is named by its id. None for a unit type that is no hero or says none\n *\n * @beta\n */\nexport function heroCallings(\n\tgame: Registry | Pick<Rules, 'packs' | 'settings'>,\n\tdef: Pick<UnitTypeDef, 'hero'>\n): { calling: CallingDef; strength: CallingStrength }[] {\n\tconst said = def.hero?.callings\n\tif (!said) return []\n\tconst known = callingsOf(game)\n\treturn Object.entries(said)\n\t\t.map(([id, strength]) => ({ calling: known.find((each) => each.id === id) ?? { id, name: id }, strength: clampStrength(strength) }))\n\t\t.sort((a, b) => b.strength - a.strength)\n}\n\n/** A strength as a calling has it, 1 to 3, whatever a data file said */\nconst clampStrength = (strength: number): CallingStrength => Math.min(Math.max(Math.round(strength), 1), 3) as CallingStrength\n\n/**\n * How strong a hero's type is in a calling: 0 for one it does not have\n *\n * @beta\n */\nexport const callingStrength = (def: Pick<UnitTypeDef, 'hero'>, calling: string): number => def.hero?.callings?.[calling] ?? 0\n\n/**\n * The rules with their callings in the place of what they were (`callingsOf`): the heroes pack's, made again with them\n * (its own options, rules and parts kept), or the rules' heroes settings for a game without the pack. What a\n * `data.json`'s `callings` (`GameData.callings`) and the Data panel's Callings come to. The rules given are not changed\n *\n * @beta\n */\nexport function withCallings(rules: Rules, callings: readonly CallingDef[]): Rules {\n\tconst list = [...callings]\n\tconst packs = rules.packs ?? []\n\tconst pack = packs.find((each) => each.id === 'core.heroes') as\n\t\t| (NonNullable<Rules['packs']>[number] & { options?: Record<string, unknown>; callings?: readonly CallingDef[] })\n\t\t| undefined\n\tif (!pack) return { ...rules, settings: { ...rules.settings, heroes: { ...rules.settings?.heroes, callings: list } } as Rules['settings'] }\n\tconst own = pack.settings\n\tconst remade = {\n\t\t...pack,\n\t\toptions: { ...pack.options, callings: list },\n\t\tcallings: list,\n\t\tsettings: (settings: Parameters<NonNullable<typeof own>>[0]) => {\n\t\t\tconst said = own?.call(pack, settings) ?? {}\n\t\t\treturn { ...said, heroes: { ...said.heroes, callings: list } } as ReturnType<NonNullable<typeof own>>\n\t\t}\n\t}\n\treturn { ...rules, packs: packs.map((each) => (each === pack ? remade : each)) }\n}\n"],"mappings":";;;;;;;;;AAgDA,SAAgB,kBAAgC;CAC/C,OAAO;EACN;GAAE,IAAI;GAAY,MAAM;GAAY,aAAa;GAAoC,MAAM;GAAY,OAAO;EAAU;EACxH;GAAE,IAAI;GAAU,MAAM;GAAU,aAAa;GAAmC,MAAM;GAAU,OAAO;EAAU;EACjH;GAAE,IAAI;GAAU,MAAM;GAAU,aAAa;GAAuC,MAAM;GAAU,OAAO;EAAU;EACrH;GAAE,IAAI;GAAU,MAAM;GAAU,aAAa;GAAuC,MAAM;GAAU,OAAO;EAAU;EACrH;GAAE,IAAI;GAAW,MAAM;GAAW,aAAa;GAAqC,MAAM;GAAW,OAAO;EAAU;EACtH;GAAE,IAAI;GAAU,MAAM;GAAU,aAAa;GAA2C,MAAM;GAAU,OAAO;EAAU;EACzH;GAAE,IAAI;GAAY,MAAM;GAAY,aAAa;GAA0C,MAAM;GAAY,OAAO;EAAU;EAC9H;GAAE,IAAI;GAAU,MAAM;GAAU,aAAa;GAAwC,MAAM;GAAU,OAAO;EAAU;CACvH;AACD;;;;;;;;AASA,SAAgB,WAAW,MAA2E;CACrG,IAAI,WAAW,MAAM,OAAO,KAAK,SAAS,OAAO;CACjD,MAAM,OAAO,KAAK,OAAO,MAAM,SAAS,KAAK,OAAO,aAAa;CACjE,MAAM,QAAQ,KAAK,UAAU,OAAA,EAA6D;CAC1F,OAAO,MAAM,SAAS,YAAY,QAAQ,MAAM,YAAY,gBAAgB;AAC7E;;;;;;;AAQA,SAAgB,aACf,MACA,KACuD;CACvD,MAAM,OAAO,IAAI,MAAM;CACvB,IAAI,CAAC,MAAM,OAAO,CAAC;CACnB,MAAM,QAAQ,WAAW,IAAI;CAC7B,OAAO,OAAO,QAAQ,IAAI,CAAC,CACzB,KAAK,CAAC,IAAI,eAAe;EAAE,SAAS,MAAM,MAAM,SAAS,KAAK,OAAO,EAAE,KAAK;GAAE;GAAI,MAAM;EAAG;EAAG,UAAU,cAAc,QAAQ;CAAE,EAAE,CAAC,CACnI,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACzC;;AAGA,IAAM,iBAAiB,aAAsC,KAAK,IAAI,KAAK,IAAI,KAAK,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC;;;;;;AAO1G,IAAa,mBAAmB,KAAgC,YAA4B,IAAI,MAAM,WAAW,YAAY;;;;;;;;AAS7H,SAAgB,aAAa,OAAc,UAAwC;CAClF,MAAM,OAAO,CAAC,GAAG,QAAQ;CACzB,MAAM,QAAQ,MAAM,SAAS,CAAC;CAC9B,MAAM,OAAO,MAAM,MAAM,SAAS,KAAK,OAAO,aAAa;CAG3D,IAAI,CAAC,MAAM,OAAO;EAAE,GAAG;EAAO,UAAU;GAAE,GAAG,MAAM;GAAU,QAAQ;IAAE,GAAG,MAAM,UAAU;IAAQ,UAAU;GAAK;EAAE;CAAuB;CAC1I,MAAM,MAAM,KAAK;CACjB,MAAM,SAAS;EACd,GAAG;EACH,SAAS;GAAE,GAAG,KAAK;GAAS,UAAU;EAAK;EAC3C,UAAU;EACV,WAAW,aAAqD;GAC/D,MAAM,OAAO,KAAK,KAAK,MAAM,QAAQ,KAAK,CAAC;GAC3C,OAAO;IAAE,GAAG;IAAM,QAAQ;KAAE,GAAG,KAAK;KAAQ,UAAU;IAAK;GAAE;EAC9D;CACD;CACA,OAAO;EAAE,GAAG;EAAO,OAAO,MAAM,KAAK,SAAU,SAAS,OAAO,SAAS,IAAK;CAAE;AAChF"}

package/dist/cameraOrders.d.ts

@@ -0,0 +1,78 @@
+import type { PlayerId } from './entity';
+import type { Step } from './sequences';
+import type { World } from './world';
+/**
+ * The rules move one player's camera, as Warcraft III's triggers do: a pan, a part of the map it stays in, a shake.
+ * The camera is the screen's, so nothing of this changes the game; what the rules say comes at the same moment of the
+ * game on that player's screen alone, and a replay has it, being said by the rules or by a command. What lasts (`lock`,
+ * `bounds`) is kept in the world, so that a save and a player who comes back have it; what is over at once (`pan`,
+ * `shake`) is an event
+ */
+/**
+ * A part of the map, in cells: what a camera looks at, at most
+ *
+ * @beta
+ */
+export interface CameraRect {
+    /** The west edge of the part, in cells */
+    minX: number;
+    /** The north edge of the part, in cells */
+    minZ: number;
+    /** The east edge of the part, in cells */
+    maxX: number;
+    /** The south edge of the part, in cells */
+    maxZ: number;
+}
+/**
+ * What the rules may say of a player's camera (`cameraFor`, the `camera` command). Any of them, together
+ *
+ * @beta
+ */
+export interface CameraOrder {
+    /** Moves the view over to a point, in `seconds` (1 when left out), by an ease of the view's by name (`inOutQuad` when left out) */
+    pan?: {
+        x: number;
+        z: number;
+        seconds?: number;
+        ease?: string;
+    };
+    /** Keeps the view in this part of the map until told otherwise (`RtsCamera.lock`). `null` lets it go (`RtsCamera.free`) */
+    lock?: CameraRect | null;
+    /** Where the player may look from now on, under any `lock` (`RtsCamera.bounds`). `null` goes back to what the game's view says */
+    bounds?: CameraRect | null;
+    /** Shakes the view, about 1 for a big blast. Where it looks when no `x` and `z`, felt less the farther off they are (`RtsCamera.shake`) */
+    shake?: {
+        strength: number;
+        x?: number;
+        z?: number;
+    };
+}
+/**
+ * What the rules said of a player's camera that lasts (`Snapshot.camera`)
+ *
+ * @beta
+ */
+export interface SeatCamera {
+    /** The part the view is kept in until told otherwise */
+    lock?: CameraRect;
+    /** The part the player may look at, under any `lock` */
+    bounds?: CameraRect;
+}
+/**
+ * The rules say something of one player's camera: on their screen alone, the same moment of the game each time.
+ * `cameraFor(world, 1, { pan: { x: 40, z: 60, seconds: 2 }, shake: { strength: 0.5 } })`
+ *
+ * @throws Invalid for an order that is not one (a part of the map with its minimum over its maximum)
+ * @beta
+ */
+export declare function cameraFor(world: World, player: PlayerId, order: CameraOrder): void;
+/**
+ * A step of a sequence that says something of a player's camera (see `cameraFor`): `[wait(4), cameraStep(1, { shake: { strength: 1 } })]`
+ *
+ * @beta
+ */
+export declare const cameraStep: <D = undefined>(player: PlayerId, order: CameraOrder) => Step<D>;
+/** A pan or a shake, to the player it is for */
+export declare const toldCamera: import("./replication").ReplicatedEvent;
+/** What lasts of what the rules said of the camera, to the player it is about; never a computer's, which has no view */
+export declare const cameraPart: import("./replication").SnapshotField<keyof import(".").Snapshot>;

package/dist/cameraOrders.js

@@ -0,0 +1,114 @@
+import { defineComponent } from "./components.js";
+import { cameraOrdered } from "./engineEvents.js";
+import { replicateEvent, snapshotField } from "./replication.js";
+import { Invalid, id, number, object, optional, string } from "./fields.js";
+//#region src/cameraOrders.ts
+var rect = object({
+	minX: number,
+	minZ: number,
+	maxX: number,
+	maxZ: number
+});
+/** A part of the map, or `null` for none, or nothing said */
+var rectOrNone = (value, path) => {
+	if (value === void 0 || value === null) return value;
+	const checked = rect(value, path);
+	if (checked.minX > checked.maxX || checked.minZ > checked.maxZ) throw new Invalid(`${path} is a part of the map with its minimum under its maximum`);
+	return checked;
+};
+var notUnderZero = (value, path) => {
+	const checked = number(value, path);
+	if (checked < 0) throw new Invalid(`${path} is not under 0`);
+	return checked;
+};
+var orderFields = {
+	pan: optional(object({
+		x: number,
+		z: number,
+		seconds: optional(notUnderZero),
+		ease: optional(string)
+	})),
+	lock: rectOrNone,
+	bounds: rectOrNone,
+	shake: optional(object({
+		strength: notUnderZero,
+		x: optional(number),
+		z: optional(number)
+	}))
+};
+/**
+* The fields of the `camera` command: an order (`CameraOrder`), and whose camera it is about, the sender's when left out
+*
+* @internal
+*/
+var cameraCommandFields = {
+	seat: optional(id),
+	...orderFields
+};
+/**
+* What lasts of what the rules said of each player's camera: only there once they said any, so a game that says none is as it was
+*
+* @internal
+*/
+var seatCameras = defineComponent({
+	id: "core.seatCameras",
+	default: () => ({})
+});
+function carryOut(world, player, order) {
+	const { lock, bounds, pan, shake } = order;
+	if (lock !== void 0 || bounds !== void 0) {
+		const all = world.state(seatCameras);
+		const seat = { ...all[player] };
+		if (lock) seat.lock = lock;
+		else if (lock === null) delete seat.lock;
+		if (bounds) seat.bounds = bounds;
+		else if (bounds === null) delete seat.bounds;
+		const next = { ...all };
+		if (seat.lock || seat.bounds) next[player] = seat;
+		else delete next[player];
+		world.setState(seatCameras, next);
+	}
+	if (pan || shake) world.events.emit(cameraOrdered, {
+		player,
+		...pan && { pan },
+		...shake && { shake }
+	});
+}
+/**
+* The rules say something of one player's camera: on their screen alone, the same moment of the game each time.
+* `cameraFor(world, 1, { pan: { x: 40, z: 60, seconds: 2 }, shake: { strength: 0.5 } })`
+*
+* @throws Invalid for an order that is not one (a part of the map with its minimum over its maximum)
+* @beta
+*/
+function cameraFor(world, player, order) {
+	carryOut(world, player, object(orderFields)(order, "camera"));
+}
+/**
+* A step of a sequence that says something of a player's camera (see `cameraFor`): `[wait(4), cameraStep(1, { shake: { strength: 1 } })]`
+*
+* @beta
+*/
+var cameraStep = (player, order) => (world) => cameraFor(world, player, order);
+/**
+* The `camera` command carried out: a seat speaks for its own camera alone, so one that names another's is refused
+*
+* @internal
+*/
+function cameraCommanded(world, player, command) {
+	const { seat = player, ...order } = command;
+	if (seat !== player) world.message(player, "cannotDoThat");
+	else carryOut(world, player, order);
+}
+/** A pan or a shake, to the player it is for */
+var toldCamera = replicateEvent(cameraOrdered, "camera", ({ player, pan, shake }, view) => player === view.player ? {
+	type: "camera",
+	...pan && { pan },
+	...shake && { shake }
+} : void 0);
+/** What lasts of what the rules said of the camera, to the player it is about; never a computer's, which has no view */
+var cameraPart = snapshotField("camera", ({ world, player, forComputer }) => forComputer || !world.states.has(seatCameras) ? void 0 : world.state(seatCameras)[player]);
+//#endregion
+export { cameraCommandFields, cameraCommanded, cameraFor, cameraPart, cameraStep, seatCameras, toldCamera };
+
+//# sourceMappingURL=cameraOrders.js.map

package/dist/cameraOrders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraOrders.js","names":[],"sources":["../src/cameraOrders.ts"],"sourcesContent":["import { cameraOrdered } from '#engine/engineEvents'\nimport { defineComponent } from './components'\nimport type { PlayerId } from './entity'\nimport { type Check, type Checked, Invalid, id, number, object, optional, string } from './fields'\nimport { replicateEvent, snapshotField } from './replication'\nimport type { Step } from './sequences'\nimport type { World } from './world'\n\n/**\n * The rules move one player's camera, as Warcraft III's triggers do: a pan, a part of the map it stays in, a shake.\n * The camera is the screen's, so nothing of this changes the game; what the rules say comes at the same moment of the\n * game on that player's screen alone, and a replay has it, being said by the rules or by a command. What lasts (`lock`,\n * `bounds`) is kept in the world, so that a save and a player who comes back have it; what is over at once (`pan`,\n * `shake`) is an event\n */\n\n/**\n * A part of the map, in cells: what a camera looks at, at most\n *\n * @beta\n */\nexport interface CameraRect {\n\t/** The west edge of the part, in cells */\n\tminX: number\n\t/** The north edge of the part, in cells */\n\tminZ: number\n\t/** The east edge of the part, in cells */\n\tmaxX: number\n\t/** The south edge of the part, in cells */\n\tmaxZ: number\n}\n\n/**\n * What the rules may say of a player's camera (`cameraFor`, the `camera` command). Any of them, together\n *\n * @beta\n */\nexport interface CameraOrder {\n\t/** Moves the view over to a point, in `seconds` (1 when left out), by an ease of the view's by name (`inOutQuad` when left out) */\n\tpan?: { x: number; z: number; seconds?: number; ease?: string }\n\t/** Keeps the view in this part of the map until told otherwise (`RtsCamera.lock`). `null` lets it go (`RtsCamera.free`) */\n\tlock?: CameraRect | null\n\t/** Where the player may look from now on, under any `lock` (`RtsCamera.bounds`). `null` goes back to what the game's view says */\n\tbounds?: CameraRect | null\n\t/** Shakes the view, about 1 for a big blast. Where it looks when no `x` and `z`, felt less the farther off they are (`RtsCamera.shake`) */\n\tshake?: { strength: number; x?: number; z?: number }\n}\n\n/**\n * What the rules said of a player's camera that lasts (`Snapshot.camera`)\n *\n * @beta\n */\nexport interface SeatCamera {\n\t/** The part the view is kept in until told otherwise */\n\tlock?: CameraRect\n\t/** The part the player may look at, under any `lock` */\n\tbounds?: CameraRect\n}\n\nconst rect = object({ minX: number, minZ: number, maxX: number, maxZ: number })\n\n/** A part of the map, or `null` for none, or nothing said */\nconst rectOrNone: Check<CameraRect | null | undefined> = (value, path) => {\n\tif (value === undefined || value === null) return value\n\tconst checked = rect(value, path)\n\tif (checked.minX > checked.maxX || checked.minZ > checked.maxZ) throw new Invalid(`${path} is a part of the map with its minimum under its maximum`)\n\treturn checked\n}\n\nconst notUnderZero: Check<number> = (value, path) => {\n\tconst checked = number(value, path)\n\tif (checked < 0) throw new Invalid(`${path} is not under 0`)\n\treturn checked\n}\n\nconst orderFields = {\n\tpan: optional(object({ x: number, z: number, seconds: optional(notUnderZero), ease: optional(string) })),\n\tlock: rectOrNone,\n\tbounds: rectOrNone,\n\tshake: optional(object({ strength: notUnderZero, x: optional(number), z: optional(number) }))\n}\n\n/**\n * The fields of the `camera` command: an order (`CameraOrder`), and whose camera it is about, the sender's when left out\n *\n * @internal\n */\nexport const cameraCommandFields = { seat: optional(id), ...orderFields }\n\n/**\n * What lasts of what the rules said of each player's camera: only there once they said any, so a game that says none is as it was\n *\n * @internal\n */\nexport const seatCameras = defineComponent<Record<PlayerId, SeatCamera>>({ id: 'core.seatCameras', default: () => ({}) })\n\nfunction carryOut(world: World, player: PlayerId, order: Checked<typeof orderFields>): void {\n\tconst { lock, bounds, pan, shake } = order\n\tif (lock !== undefined || bounds !== undefined) {\n\t\tconst all = world.state(seatCameras)\n\t\tconst seat: SeatCamera = { ...all[player] }\n\t\tif (lock) seat.lock = lock\n\t\telse if (lock === null) delete seat.lock\n\t\tif (bounds) seat.bounds = bounds\n\t\telse if (bounds === null) delete seat.bounds\n\t\tconst next = { ...all }\n\t\tif (seat.lock || seat.bounds) next[player] = seat\n\t\telse delete next[player]\n\t\tworld.setState(seatCameras, next)\n\t}\n\tif (pan || shake) world.events.emit(cameraOrdered, { player, ...(pan && { pan }), ...(shake && { shake }) })\n}\n\n/**\n * The rules say something of one player's camera: on their screen alone, the same moment of the game each time.\n * `cameraFor(world, 1, { pan: { x: 40, z: 60, seconds: 2 }, shake: { strength: 0.5 } })`\n *\n * @throws Invalid for an order that is not one (a part of the map with its minimum over its maximum)\n * @beta\n */\nexport function cameraFor(world: World, player: PlayerId, order: CameraOrder): void {\n\tcarryOut(world, player, object(orderFields)(order, 'camera'))\n}\n\n/**\n * A step of a sequence that says something of a player's camera (see `cameraFor`): `[wait(4), cameraStep(1, { shake: { strength: 1 } })]`\n *\n * @beta\n */\nexport const cameraStep =\n\t<D = undefined>(player: PlayerId, order: CameraOrder): Step<D> =>\n\t(world) =>\n\t\tcameraFor(world, player, order)\n\n/**\n * The `camera` command carried out: a seat speaks for its own camera alone, so one that names another's is refused\n *\n * @internal\n */\nexport function cameraCommanded(world: World, player: PlayerId, command: Checked<typeof cameraCommandFields>): void {\n\tconst { seat = player, ...order } = command\n\tif (seat !== player) world.message(player, 'cannotDoThat')\n\telse carryOut(world, player, order)\n}\n\n/** A pan or a shake, to the player it is for */\nexport const toldCamera = replicateEvent(cameraOrdered, 'camera', ({ player, pan, shake }, view) =>\n\tplayer === view.player ? { type: 'camera', ...(pan && { pan }), ...(shake && { shake }) } : undefined\n)\n\n/** What lasts of what the rules said of the camera, to the player it is about; never a computer's, which has no view */\nexport const cameraPart = snapshotField('camera', ({ world, player, forComputer }) =>\n\tforComputer || !world.states.has(seatCameras) ? undefined : world.state(seatCameras)[player]\n)\n"],"mappings":";;;;;AA4DA,IAAM,OAAO,OAAO;CAAE,MAAM;CAAQ,MAAM;CAAQ,MAAM;CAAQ,MAAM;AAAO,CAAC;;AAG9E,IAAM,cAAoD,OAAO,SAAS;CACzE,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO;CAClD,MAAM,UAAU,KAAK,OAAO,IAAI;CAChC,IAAI,QAAQ,OAAO,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,MAAM,MAAM,IAAI,QAAQ,GAAG,KAAK,yDAAyD;CACnJ,OAAO;AACR;AAEA,IAAM,gBAA+B,OAAO,SAAS;CACpD,MAAM,UAAU,OAAO,OAAO,IAAI;CAClC,IAAI,UAAU,GAAG,MAAM,IAAI,QAAQ,GAAG,KAAK,gBAAgB;CAC3D,OAAO;AACR;AAEA,IAAM,cAAc;CACnB,KAAK,SAAS,OAAO;EAAE,GAAG;EAAQ,GAAG;EAAQ,SAAS,SAAS,YAAY;EAAG,MAAM,SAAS,MAAM;CAAE,CAAC,CAAC;CACvG,MAAM;CACN,QAAQ;CACR,OAAO,SAAS,OAAO;EAAE,UAAU;EAAc,GAAG,SAAS,MAAM;EAAG,GAAG,SAAS,MAAM;CAAE,CAAC,CAAC;AAC7F;;;;;;AAOA,IAAa,sBAAsB;CAAE,MAAM,SAAS,EAAE;CAAG,GAAG;AAAY;;;;;;AAOxE,IAAa,cAAc,gBAA8C;CAAE,IAAI;CAAoB,gBAAgB,CAAC;AAAG,CAAC;AAExH,SAAS,SAAS,OAAc,QAAkB,OAA0C;CAC3F,MAAM,EAAE,MAAM,QAAQ,KAAK,UAAU;CACrC,IAAI,SAAS,KAAA,KAAa,WAAW,KAAA,GAAW;EAC/C,MAAM,MAAM,MAAM,MAAM,WAAW;EACnC,MAAM,OAAmB,EAAE,GAAG,IAAI,QAAQ;EAC1C,IAAI,MAAM,KAAK,OAAO;OACjB,IAAI,SAAS,MAAM,OAAO,KAAK;EACpC,IAAI,QAAQ,KAAK,SAAS;OACrB,IAAI,WAAW,MAAM,OAAO,KAAK;EACtC,MAAM,OAAO,EAAE,GAAG,IAAI;EACtB,IAAI,KAAK,QAAQ,KAAK,QAAQ,KAAK,UAAU;OACxC,OAAO,KAAK;EACjB,MAAM,SAAS,aAAa,IAAI;CACjC;CACA,IAAI,OAAO,OAAO,MAAM,OAAO,KAAK,eAAe;EAAE;EAAQ,GAAI,OAAO,EAAE,IAAI;EAAI,GAAI,SAAS,EAAE,MAAM;CAAG,CAAC;AAC5G;;;;;;;;AASA,SAAgB,UAAU,OAAc,QAAkB,OAA0B;CACnF,SAAS,OAAO,QAAQ,OAAO,WAAW,CAAC,CAAC,OAAO,QAAQ,CAAC;AAC7D;;;;;;AAOA,IAAa,cACI,QAAkB,WACjC,UACA,UAAU,OAAO,QAAQ,KAAK;;;;;;AAOhC,SAAgB,gBAAgB,OAAc,QAAkB,SAAoD;CACnH,MAAM,EAAE,OAAO,QAAQ,GAAG,UAAU;CACpC,IAAI,SAAS,QAAQ,MAAM,QAAQ,QAAQ,cAAc;MACpD,SAAS,OAAO,QAAQ,KAAK;AACnC;;AAGA,IAAa,aAAa,eAAe,eAAe,WAAW,EAAE,QAAQ,KAAK,SAAS,SAC1F,WAAW,KAAK,SAAS;CAAE,MAAM;CAAU,GAAI,OAAO,EAAE,IAAI;CAAI,GAAI,SAAS,EAAE,MAAM;AAAG,IAAI,KAAA,CAC7F;;AAGA,IAAa,aAAa,cAAc,WAAW,EAAE,OAAO,QAAQ,kBACnE,eAAe,CAAC,MAAM,OAAO,IAAI,WAAW,IAAI,KAAA,IAAY,MAAM,MAAM,WAAW,CAAC,CAAC,OACtF"}